59 lines
1.6 KiB
Markdown
59 lines
1.6 KiB
Markdown
# POC professeur virtuel (8-12 ans)
|
|
|
|
Ce POC propose :
|
|
- une page web avec avatar animé
|
|
- un chat pédagogique en français
|
|
- une mémoire élève persistée dans PostgreSQL
|
|
- un mini diagnostic adaptatif sur quelques compétences du programme français
|
|
- une API FastAPI branchée sur OpenAI via la Responses API
|
|
- des conteneurs Docker pour le frontend, le backend, PostgreSQL et Redis
|
|
|
|
## Lancer le projet
|
|
|
|
1. Copier le fichier d'environnement :
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
2. Ajouter votre clé OpenAI dans `.env`.
|
|
|
|
3. Lancer :
|
|
|
|
```bash
|
|
docker compose up --build
|
|
```
|
|
|
|
4. Ouvrir :
|
|
- Frontend : http://localhost:3000
|
|
- API : http://localhost:8000/docs
|
|
|
|
## Parcours de démo
|
|
|
|
- Choisir un élève ou en créer un nouveau
|
|
- Cliquer sur "Démarrer la séance"
|
|
- Poser une question ou répondre au quiz
|
|
- Regarder la progression se mettre à jour
|
|
- L'avatar lit les réponses via la synthèse vocale du navigateur
|
|
|
|
## Limites du POC
|
|
|
|
- l'avatar est volontairement simple (SVG/CSS) pour rester 100 % web
|
|
- la voix entrante utilise le navigateur via Web Speech API quand disponible
|
|
- la progression couvre seulement quelques micro-compétences pour la démo
|
|
- pas encore de dashboard parent ni de conformité RGPD/CNIL complète
|
|
|
|
## Architecture
|
|
|
|
- `frontend/` : React + Vite
|
|
- `backend/` : FastAPI + SQLAlchemy + OpenAI SDK
|
|
- `postgres` : mémoire structurée élève
|
|
- `redis` : réservé au cache / file d'événements dans la suite
|
|
|
|
## Extensions conseillées
|
|
|
|
- remplacer l'avatar SVG par un avatar VRM
|
|
- passer en audio temps réel avec Realtime API + WebRTC
|
|
- enrichir le référentiel avec tout le programme national français
|
|
- ajouter un moteur de révision espacée
|