Initial commit

README.md

@@ -0,0 +1,58 @@
+# 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