Revise Mieux -- Documentation¶
Revise Mieux est un SaaS educatif qui transforme des photos de cahier en assistant de revision personnalise pour collegiens (11-15 ans). A partir d'un upload de cours manuscrit, le produit genere une carte de lecon structuree, des entrainements adaptatifs bases sur la repetition espacee, et des controles blancs. Les parents sont integres via un reporting base sur des preuves de maitrise reelles (boucle HITL).
Stack technique¶
| Composant | Technologie |
|---|---|
| Backend API | Go 1.23 + Gin |
| Base de donnees | PostgreSQL 16 (pgx/v5, SQL brut) |
| Mobile | React Native + Expo 55 + Expo Router |
| LLM | Gemini Flash (defaut), Anthropic Claude Sonnet, Mistral |
| OCR | Gemini Flash VLM |
| Cache | Redis 7 (go-redis/v9) |
| Storage | S3 / MinIO (dev) |
| IDs | UUIDv7 (google/uuid) |
Etat du Lot 0¶
Le Lot 0 couvre 53 criteres d'acceptation (33 P1 + 20 P2) pour un usage local pere-fils sur 4 chapitres pilotes.
| Phase | Description | Statut |
|---|---|---|
| Phase 0 | Specifications et schema SQL | Terminee |
| Phase 1 | Fondations backend Go (DDD, auth, infra) | Terminee |
| Phase 2 | Moteur Mastery (Z1) -- machine a etats | Terminee |
| Phase 3 | Pipeline J0 (upload, OCR, structuration LLM) | Terminee |
| Phase 4 | Sessions et questions (composition, lazy gen) | Terminee |
| Phase 5 | Validation HITL (boucle qualite parent) | Terminee |
| Phase 6 | Onboarding (cold start, chapitre demo) | Terminee |
| Phase 7 | Mobile React Native + Expo | En cours |
Progression : 52/53 ACs implementees (backend complet, mobile en finalisation).
Sections de la documentation¶
Demarrage et developpement¶
- Guide de demarrage rapide -- prerequis, installation, configuration, lancement
- Guide de contribution -- workflow TDD, conventions Go, checklist PR
Architecture¶
- Vue d'ensemble architecture -- bounded contexts, hexagonal, packages Go
- Decision table merge OCR/IDP
- Pipeline OCR/IDP incremental
Specifications produit¶
- PRD complet -- personas, pipeline, architecture, modele de donnees, algorithmes
- Perimetre MVP (Lot 0) -- classification des 171 ACs
- Suivi Lot 0 -- progression detaillee par phase et matrice AC
Criteres d'acceptation¶
- Z1 -- Mastery -- machine a etats, transitions, espacement
- Z2 -- Pipeline J0 -- upload, OCR, structuration
- Z3 -- Validation HITL -- boucle qualite parent/admin
- Z4 -- Sessions -- composition, questions, feedback
- Z5 -- Gestion items -- identite, archivage, CRUD
- Z6 -- Planification -- calendrier, exams, sessions
- Z7 -- Carte lecon -- affichage, notions, visuels
- Z8 -- Onboarding -- cold start, chapitre demo
LLM et benchmarks¶
- Strategie LLM -- choix de modeles, providers
- Benchmark LLM -- resultats comparatifs IDP/OCR
Design¶
- Design system -- principes, couleurs, typographie, composants
UX¶
- Parcours utilisateurs
- Personas
- Inventaire ecrans
- Modele d'etats
- Flux utilisateur complet
- Cas limites
- Decisions ouvertes
Deploiement¶
- Guide de deploiement -- Docker Compose, variables d'environnement, health check