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>
This commit is contained in:
Vincent Bourdon
2026-06-19 17:03:33 +02:00
commit 16fd4c8c36
32 changed files with 1360 additions and 0 deletions
+38
View File
@@ -0,0 +1,38 @@
# 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`](../../ROADMAP.md) (à tenir à jour).
Les principes d'ingénierie sont dans [`../../CLAUDE.md`](../../CLAUDE.md).
## Organisation
| Fichier | Rôle |
|---------|------|
| [`00-vision-architecture.md`](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
0. [Fondations](jalon-0-fondations/)
1. [Verrouillage / épinglage](jalon-1-verrouillage/) ⚠️ bloquant
2. [Lecture audio](jalon-2-lecture-audio/)
3. [Découverte & gestion des podcasts](jalon-3-podcasts/)
4. [Espace enfant](jalon-4-espace-enfant/)
5. [Code parental & espace parent](jalon-5-code-parental/)
6. [Limites, avertissements & fin de session](jalon-6-limites/)