storytime/docs/specs/jalon-1-verrouillage/02-service-verrouillage.md

1.2 — Service de verrouillage (domaine + use cases)

Objectif

Encapsuler l'épinglage derrière une interface de domaine propre et des use cases testables, indépendants de l'implémentation (plugin ou natif).

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

• Inclus : interface LockingRepository, use cases, impl. data branchée sur le résultat de 1.1, providers Riverpod.
• Exclus : UI enfant (jalon 4) ; c'est elle qui appellera ces use cases.

Dépendances

1.1 (faisabilité prouvée).

Conception

• Domain (features/locking/domain/) :
  • LockState (value object / enum) : unlocked, locked, unsupported.
  • LockingRepository (interface) :
    • Future<Result<Unit>> startLock()
    • Future<Result<Unit>> stopLock()
    • Stream<LockState> watchState()
    • Future<LockState> currentState()
  • LockingFailure (sous-type de Failure) : LockUnsupportedFailure, LockDeniedFailure.
• Application (features/locking/application/) :
  • StartLockUseCase, StopLockUseCase, WatchLockStateUseCase.
  • StopLockUseCase n'autorise pas la sortie système ; il ne fait que demander l'arrêt de l'épinglage (la confirmation reste au système). À documenter.
• Data (features/locking/data/) :
  • KioskModeLockingRepository (impl. via plugin) ou NativeChannelLockingRepository (impl. 1.3), selon décision de 1.1.
• DI : provider lockingRepositoryProvider (override en test).

Plan TDD

1. Red : start_lock_use_case_test.dart — avec un LockingRepository mocké renvoyant Ok, le use case renvoie Ok ; en Err(LockDenied), propage l'échec. Échoue (types absents).
2. Green : créer interface + use case.
3. Red : watch_lock_state_use_case_test.dart — le stream relaie les états émis par le repo mocké.
4. Green : implémenter.
5. Red : kiosk_mode_locking_repository_test.dart — avec un wrapper mockable autour du plugin, startLock mappe succès→Ok et exception→LockingFailure.
6. Green : implémenter l'impl. data avec mapping d'erreurs.
7. Refactor.

Definition of Done

• Tous les tests ci-dessus verts ; aucune dépendance au plugin dans domain//application/.
• tool/check.sh passe.
• Étape 1.2 cochée dans ROADMAP.md.

Risques / notes

• Garder l'API du repository minimale : start/stop/observe. Pas de fioritures.