raai-apprendre
Plateforme pédagogique nationale pour les établissements agricoles français —
MFR, CFA, lycées agricoles, CFPPA, BTSA, licences professionnelles — conçue pour
s'ouvrir aux autres filières techniques.
État : socle posé, quinze écrans, rien de déployé. Le dossier de conception
est validé (docs/). Le schéma, le cloisonnement et l'import
des référentiels sont testés ; les écrans fonctionnent contre une vraie base,
pas une maquette. Aucun établissement ne l'a encore ouvert.
Démarrer
npm install
cp .env.example .env.local # puis remplir
npm run verifier # types + lint + architecture + tests
npm run bd:locale # PGlite + migrations + jeu de démonstration
npm run dev
Ni Docker ni PostgreSQL à installer : PGlite embarque PostgreSQL. Un
environnement qui demande une mise en place préalable est un environnement où
l'on ne lance pas l'application « juste pour vérifier ».
PGlite ne sert qu'une connexion à la fois : arrêter npm run dev avant de
lancer les tests d'intégration.
Ce qui existe
| Élément | État |
|---|
| Dossier de conception, 15 documents | Validé |
| Schéma Prisma (39 tables, 3 schémas) | Écrit, validé |
| Migrations SQL : RLS, fonctions, déclencheurs | Écrites, appliquées en test |
| Tests de permissions (3 familles, 35 tests) | Verts, falsification vérifiée |
| Outil d'import des référentiels DGER | Fonctionnel sur PDF réel, 6 tests |
| Écrans élève, enseignant, administration (15) | Fonctionnels sur base réelle |
| Facturation, migration depuis RAAI-Formation | À faire |
| Relecture du référentiel par un enseignant | À faire — et rien ne la remplace |
Structure
docs/ dossier de conception — fait autorité
prisma/
schema.prisma schéma du socle
migrations/ SQL versionné : tables, puis RLS
src/
domaines/<module>/ domaine · application · ports · infrastructure
app/ App Router — présentation uniquement
noyau/ bus d'événements, résultat, erreurs
test/permissions/ les 3 familles bloquantes
outils/import-referentiel/ extraction des référentiels ChloroFil
Décisions structurantes
- Deux arbres, un point de rencontre. L'organisationnel appartient aux
établissements, le référentiel est national ; ils ne se touchent que sur
acquis_competence.
- Identité hybride. Élèves mineurs sans compte Auth (identifiant + code),
adultes sur Supabase Auth, choix par établissement.
- Le cloisonnement vit en base. RLS forcée partout, testée à chaque commit.
- L'IA propose, un humain décide. Aucune décision automatisée à effet
juridique sur un élève.
Détail et justifications dans docs/.
Licence
Propriétaire — RAAI.
