storytime/docs/specs/jalon-0-fondations/03-socle-transverse.md

0.3 — Socle transverse

Objectif

Fournir les briques transverses réutilisées par toutes les features : gestion d'erreur typée, thème, navigation, et amorce de DI Riverpod.

Périmètre & hors-périmètre

• Inclus : Result/Failure, thème Material 3 (palette douce « coucher »), router, organisation DI.
• Exclus : providers métier (créés par chaque feature).

Dépendances

0.1, 0.2.

Conception

• core/error/ :
  • Failure (classe scellée/sealed) avec sous-types de base : NetworkFailure, NotFoundFailure, UnexpectedFailure. Les features ajouteront les leurs.
  • Result<S> : type sealed Ok<S>(value) / Err(Failure), avec helpers (map, when, fold). (Ou adopter dartz/fpdart Either — choisir et figer dans CLAUDE.md §7.)
• core/theme/ : AppTheme Material 3, couleurs douces, gros composants tactiles (cible enfant), contrastes lisibles le soir.
• core/router/ : router (go_router ou Navigator 2 simple) avec routes nommées : child (défaut), parentGate, parent. Pas encore d'écrans réels.
• core/di/ : conventions d'organisation des providers (un fichier providers.dart par feature, agrégés). ProviderScope racine dans main.dart.

Plan TDD

1. Red : result_test.dart — Ok(1).map((v) => v+1) donne Ok(2) ; Err(f).map(...) reste Err(f) ; fold/when aiguillent correctement. Échoue (type absent).
2. Green : implémenter Result/Failure.
3. Red : theme_test.dart (widget) — un MaterialApp avec AppTheme expose useMaterial3 == true et la couleur primaire attendue.
4. Green : implémenter AppTheme.
5. Refactor : nettoyer, documenter les helpers.

Definition of Done

• Tests result_test.dart et theme_test.dart verts.
• App démarre avec le thème appliqué et le router en place (route child placeholder).
• tool/check.sh passe.
• Étape 0.3 cochée dans ROADMAP.md ; choix Result maison vs fpdart consigné dans CLAUDE.md §7.

Risques / notes

• Ne pas sur-concevoir le Result : juste ce que les use cases consommeront. Étoffer au besoin réel.