KODI

Application web progressive (PWA) française de préparation au code de la route, mobile-first, destinée à être installable sur iPhone, Android et ordinateur.

Statut (27/10/2026) : édition personnelle gratuite (D-032). Pour un seul utilisateur, sans paiement : voir docs/EDITION_PERSONNELLE.md. 136 questions réelles rédigées à partir de pages officielles, aucune relue ; entraînement par thème et examens blancs sur l’appareil. Pas prêt pour une publication ouverte au public : docs/LAUNCH_AUDIT.md.

Documentation

Document	Contenu
docs/SPECIFICATION.md	Ce que KODI doit faire, contraintes de contenu et de qualité
docs/ROADMAP.md	Phases, livrables et critères de validation
docs/DECISIONS.md	Journal des décisions techniques et questions ouvertes
docs/CONTENU.md	Écrire, importer et valider les contenus pédagogiques
docs/SCENES.md	Scènes de simulation 3D : fonctionnement, éléments provisoires, performances
docs/EDITION_PERSONNELLE.md	Mettre KODI en ligne gratuitement et l’installer sur iPhone
docs/PAIEMENTS.md	Archivé : ancien freemium Stripe, retiré (D-032)
docs/LAUNCH_AUDIT.md	Audit de lancement : état réel, corrections, mise en production
AGENTS.md	Règles pour les agents IA qui travaillent sur le dépôt

Pile technique

• Next.js 16.4 (App Router, Cache Components) · React 19

• TypeScript 5 en mode strict renforcé

• Tailwind CSS 4

• ESLint 9 (eslint-config-next)

• Vitest + Testing Library (tests unitaires et composants)

• Playwright (tests de bout en bout, Chromium) + axe-core (audit WCAG)

• Supabase (Auth, PostgreSQL, RLS, Realtime) — migrations dans supabase/

• Three.js 0.186 et React Three Fiber 9.8 (scènes 3D)

• SDK officiel Anthropic (prêt, non activé : D-029)

PWA : manifeste, icônes, service worker et hors ligne des pages déjà consultées (D-031), à vérifier sur iPhone.

Commandes

Prérequis : Node.js 22 ou plus récent.

npm ci                 # installe les dépendances (versions verrouillées)
npm run dev            # serveur de développement sur http://localhost:3000
npm run lint           # ESLint, zéro avertissement toléré
npm run typecheck      # génère les types de routes puis tsc --noEmit
npm test               # tests unitaires et composants (Vitest)
npm run build          # build de production
npm run test:e2e       # tests navigateur (nécessite un build préalable)
npm run test:db        # tests de sécurité de la base (PostgreSQL requis)
npm run content:build  # valide content/ et régénère catalogue + supabase/seed/content.sql
npm run relecture      # régénère docs/RELECTURE.md
npm run check          # lint + typecheck + tests + build

Pour les tests de bout en bout hors environnement cloud Claude Code, installer d’abord le navigateur : npx playwright install chromium. Dans l’environnement cloud, Chromium est déjà présent :

PLAYWRIGHT_CHROMIUM_PATH=/opt/pw-browsers/chromium npm run test:e2e

Intégration continue

Le workflow .github/workflows/ci.yml exécute lint, typecheck, tests, build et tests de bout en bout à chaque push et pull request. Le dépôt étant public, GitHub Actions est gratuit sur les runners standards. Les résultats sont consultables depuis l’onglet Actions du dépôt, y compris depuis un iPhone.

Structure

src/
  app/
    (tabs)/      écrans avec navigation à onglets : / (Accueil), apprendre,
                 simuler, entrainement, progression, profil, revisions…
    (focus)/     parcours sans onglets : connexion, inscription, bienvenue
  components/
    ui/          design system (boutons, cartes, champs, alertes…)
  content/       catalogue généré, sources, phases du projet, démonstration
  lib/           logique pure et testée (moteur pédagogique, contenus, quiz,
                 statistiques, validation, stockage local, thème)
content/         univers, compétences, leçons et questions (JSON, statuts)
e2e/             tests Playwright (écrans, parcours, accessibilité)
docs/            spécification, feuille de route, décisions