open-school/MEMORY.md

Memoire Projet

Contexte

Ce projet est un POC de professeur virtuel pour enfants, avec:

• frontend React + Vite
• backend FastAPI
• PostgreSQL pour les donnees eleve
• Redis present dans la stack
• integration OpenAI pour reponses texte et transcription audio

Points Importants

• Le frontend appelle l'API via le prefixe /api.
• Le backend expose une route POST /transcribe pour la transcription audio.
• La route /transcribe utilise UploadFile, donc python-multipart est requis dans le backend.
• Le vrai docker-compose.yml de production n'est pas dans ce repo. Il est situe un niveau au-dessus sur le serveur.
• La conf nginx reelle route:
  • /api/ vers tutor-backend:8000
  • / vers tutor-frontend:3000

Dictée Vocale

• L'ancien bouton de dictee marchait en mode manuel avec MediaRecorder.start() puis stop().
• Le mode actuel est un mode mains libres:
  • activation via un clic utilisateur
  • enregistrement automatique
  • detection du silence
  • transcription automatique
  • envoi automatique du message
• Firefox s'est montre capricieux avec la mesure temps reel via AnalyserNode.
• La solution retenue s'appuie sur un traitement plus direct du flux audio pour determiner le niveau sonore.
• L'ecoute se rearme automatiquement apres:
  • la transcription/envoi du message eleve
  • la fin de lecture vocale du professeur

Voix du Professeur

• Le frontend charge les voix du navigateur via speechSynthesis.getVoices().
• Une liste de voix est proposee dans l'interface.
• Les voix francaises sont priorisees dans le tri.

Points de Vigilance

• Les erreurs WebSocket Vite/HMR sur wss://prof.open-squared.tech/... sont du bruit de dev tant que le frontend tourne via Vite derriere nginx.
• Ces erreurs ne sont pas la cause principale si /api/* renvoie des 502 ou si le micro se comporte mal.
• En cas de 502 sur /api/*, verifier d'abord docker logs tutor-backend.

Fichiers Touchés Pendant Cette Session

• frontend/src/App.jsx
• frontend/vite.config.js
• backend/app/main.py
• backend/app/services.py
• backend/requirements.txt