storytime/docs/specs/jalon-6-limites/01-domaine-limites.md

6.1 — Domaine des limites

Objectif

Modéliser les limites de coucher (minuterie + nombre d'histoires) et la logique qui décide quand avertir et quand arrêter, indépendamment de l'UI.

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

• Inclus : configuration des limites, compteurs, calcul des seuils d'avertissement et d'arrêt, reset quotidien, persistance des réglages + compteurs.
• Exclus : affichage des avertissements (6.2), écran de fin (6.3).

Dépendances

2.x (événements de lecture : histoire démarrée, position/temps), Jalon 0.

Conception

• Domain (features/limits/domain/) :
  • LimitSettings (value object) : timerEnabled, timerDuration?, storyCountEnabled, maxStories?.
  • SessionCounters : elapsed (Duration), storiesPlayed (int), day (date du compteur, pour le reset).
  • LimitStatus (résultat de décision) : ok, warnTimeSoon, warnLastStory, reached.
  • LimitEvaluator (service de domaine pur) : LimitStatus evaluate(LimitSettings, SessionCounters) — applique les seuils (ex. avertissement minuterie à T-5 min ; « dernière histoire » quand storiesPlayed == maxStories - 1).
  • LimitsRepository (interface) : get/saveSettings, get/saveCounters, reset si le jour a changé.
• Application :
  • GetLimitSettingsUseCase, SaveLimitSettingsUseCase.
  • RegisterStoryStartedUseCase (incrémente le compteur + reset si nouveau jour).
  • TickElapsedUseCase / EvaluateLimitsUseCase (renvoie LimitStatus).
• Data : PrefsLimitsRepository via shared_preferences (réglages + compteurs + date du jour). Reset : si la date stockée ≠ aujourd'hui, compteurs remis à zéro à la lecture.

Plan TDD

1. Red : limit_evaluator_test.dart — table de cas : minuterie désactivée → toujours ok jusqu'au compteur d'histoires ; T-5 min → warnTimeSoon ; temps atteint → reached ; storiesPlayed == max-1 → warnLastStory ; == max → reached. Les deux limites combinées : la plus restrictive gagne.
2. Green : implémenter LimitEvaluator (logique pure).
3. Red : register_story_started_use_case_test.dart — incrémente ; si nouveau jour, repart de 0.
4. Green : implémenter.
5. Red : prefs_limits_repository_test.dart — sauvegarde/relecture des réglages et compteurs ; reset au changement de date (date injectée, pas DateTime.now() direct → horloge injectable).
6. Green : implémenter le repo + horloge injectable.
7. Refactor.

Definition of Done

• Tests évaluateur (table de cas) + use cases + repo verts.
• Logique de décision sans dépendance Flutter.
• tool/check.sh passe ; étape 6.1 cochée dans ROADMAP.md.

Risques / notes

• Injecter une Clock (interface) pour tester le reset quotidien sans dépendre de l'heure réelle.
• Le seuil d'avertissement minuterie (5 min) est une constante nommée, ajustable.