Documentation Technique — Racines App

English version

Documentation technique à destination des développeurs et équipes DevOps.

Table des matières

N°	Fichier	Contenu
00	Vue d'ensemble de l'architecture	Diagramme, stack, flux de données
01	Installation et développement local	Setup complet en local
02	Variables d'environnement	Référence exhaustive de toutes les variables
03	Base de données — schéma et requêtes	Tables, relations, requêtes utiles
04	API REST — référence complète	Tous les endpoints avec exemples
05	Audio et stockage MinIO	Upload, CDN, FFmpeg, cache
06	PWA et Service Worker	Stratégies de cache, IndexedDB, offline
07	Authentification	PBKDF2, JWT, sessions admin et speaker
08	Déploiement	Docker, Ansible, CI/CD, Traefik
09	CI/CD GitLab	Pipeline, Registry, secrets, rollback
10	Module Révision QCM	Architecture, logique, types TypeScript
11	Statistiques et tracking	Événements, agrégations, queue offline
12	Sécurité	CSP, headers HTTP, validation, honeypot
13	Charte du projet et décisions d'architecture	Règles non négociables, conventions

Fichier	Contenu	Rapport avec la nouvelle doc
API REST	API REST v1	Absorbé et mis à jour dans `04-api-reference.md`
Déploiement	Déploiement Docker + Traefik	Absorbé dans `08-deploiement.md`
Migration historique	Migration Supabase → PostgreSQL	Historique — conservé tel quel
PWA & Service Worker	Architecture SW (détaillée)	Synthétisé dans `06-pwa-service-worker.md`
Module Quiz QCM	Spec module QCM	Absorbé dans `10-quiz-revision.md`
Distracteurs QCM	Amélioration distracteurs	Absorbé dans `10-quiz-revision.md`

Couche	Technologie	Version
Framework	Next.js (App Router)	16.x
UI	React + TypeScript + Tailwind CSS	19.x / 5.x / 4.x
Base de données	PostgreSQL	15.x
Stockage audio	MinIO (S3-compatible)	Latest
Traitement audio	FFmpeg (fluent-ffmpeg)	Latest
Authentification	PBKDF2 + JWT (jose)	— / 4.x
PWA	Service Worker + IndexedDB	v3
Reverse proxy	Traefik	v2
Déploiement	Docker + Ansible + GitLab CI	—

Version : 2.0.0 — Mise à jour : 2026-05