Files
storytime/docs/specs
Vincent Bourdon 16fd4c8c36 docs: cadrage initial Storytime (specs par jalon, roadmap, CLAUDE.md)
Lecteur d'histoires cadenassé pour le coucher (Android/Flutter).
- CLAUDE.md : principes craftsmanship/TDD/clean code/clean archi + decisions techniques
- ROADMAP.md : suivi haut niveau des 7 jalons, a tenir a jour par etape
- docs/specs/ : specs completes decoupees par jalon, etapes en sous-fichiers
- .gitignore Flutter (pubspec.lock versionne, projet applicatif)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 17:03:33 +02:00
..

Specs Storytime

Spécifications du projet, découpées par jalon. Un dossier par jalon ; chaque jalon contient un README.md (objectif, périmètre, Definition of Done) et ses étapes d'implémentation en sous-fichiers numérotés.

Le suivi d'avancement est dans ../../ROADMAP.md (à tenir à jour). Les principes d'ingénierie sont dans ../../CLAUDE.md.

Organisation

Fichier Rôle
00-vision-architecture.md Vision produit, architecture cible, conventions transverses
jalon-N-xxx/README.md Objectif du jalon + critères de fin
jalon-N-xxx/NN-etape.md Une étape d'implémentation (conception + plan TDD + DoD)

Format d'un fichier d'étape

Chaque sous-fichier d'étape suit la même trame :

  1. Objectif — ce que l'étape livre, en une phrase.
  2. Périmètre & hors-périmètre — ce qui est inclus / explicitement exclu (YAGNI).
  3. Dépendances — étapes/jalons préalables.
  4. Conception — couches concernées, interfaces/contrats, modèles.
  5. Plan TDD — la liste des tests à écrire d'abord (Red), dans l'ordre.
  6. Definition of Done — conditions de complétion (tests verts, lint, roadmap à jour).
  7. Risques / notes — pièges connus.

Jalons

  1. Fondations
  2. Verrouillage / épinglage ⚠️ bloquant
  3. Lecture audio
  4. Découverte & gestion des podcasts
  5. Espace enfant
  6. Code parental & espace parent
  7. Limites, avertissements & fin de session