Scénarios métier ColisMove

Cette section liste les 24 scénarios métier de référence validés en planning. Ils servent de checklist d’intégration backend ↔ frontend ↔ Stripe ↔ KYC et sont la source unique de vérité pour les tests E2E. Chaque scénario lié à un commit ou une epic est implémenté et couvert par tests d’intégration.

Machine à états d’une réservation

Le cycle de vie complet d’une réservation suit cette machine à états (10 états, 12 transitions) :

Effets de bord clés

Transition	Effets
`→ ACCEPTEE`	QR code dépôt généré + push au sender
`→ EN_COURS_DE_LIVRAISON`	Compteur photos validé (gates `confirmerDepot`)
`→ LIVREE`	Stripe transfer carrier, wallet crédité, push + email
`→ ANNULEE` (pré-dépôt)	Stripe refund full, push sender
`→ LITIGE`	Hold Stripe, notification superadmin

Happy Path Sc 1 — Yaoundé→Paris

Diagramme de séquence du parcours nominal (réservation, paiement, dépôt, transit, livraison, paiement carrier) :

Vue d’ensemble des 24 scénarios

#	Scénario	État	Référence
1	Happy Path Yaoundé→Paris (carte CM)	OK	Tests E2E `BookingFullJourneyIT`
2	Happy Path inverse Paris→Yaoundé	OK	idem Sc 1 (sens inverse)
3	Annulation pré-dépôt par expéditeur	Closed	commit `087b4f2`
4	Refus transporteur	Closed	commit `3572e91`
5	Annulation post-dépôt → forcée vers litige	Closed	commit `087b4f2`
6	Litige colis perdu (REFUND_FULL)	OK	module `colismove-litiges`
7	Litige contenu contesté (REFUND_PARTIAL/REJECTED)	OK	module `colismove-litiges`
8	Pays non supporté côté transporteur	Closed	commit `a783274`
9	Carte refusée 3DS DSP2	Closed	commit `d6ccab9`
10	Cumul LCB-FT silencieux → Stripe Identity	Pivot Flynanga	drop Didit, compteur déclenché
11	Webhook perdu / reconciliation cron	Closed	commit `d0de512`
12	Réservation multi-colis (8 kg partagé)	Closed	commit `2023944`
13	Agence B2B publie annonce groupée	OK	module `colismove-agency` (74 fichiers)
14	Anti-contournement chat (regex filtre)	OK	service Firebase Firestore
15	Prix par catégorie	Closed	Epic 4 (stories 4.1 → 4.11)
16	Reverse_transfer LIVREE → litige tardif	OK	module `colismove-litiges`
17	Destinataire absent à la livraison	Closed	commit `f1c9bf7`
18	Annonce expirée sans réservation	OK	`AnnonceExpirationScheduler` (02:30) + `ExpiredAnnouncementHandler` (03:00)
19	Wallet transporteur (Stripe Express direct)	Closed	commit `4e873f4`
20	Compte transporteur Stripe fermé	Closed	commit `2216fd0`
21	Photo AVANT_DEPOT manquante	OK	module `colismove-packsentry` (gates)
22	Photo DEPOT manquante au scan QR	OK	gates QR `confirmerDepot`
23	GPS désactivé / refusé	Closed	commit `3697fe8` (`GpsStatus`)
24	Échec upload S3 / watermark	OK partiel	`S3PhotoStorageAdapter` MAX_ATTEMPTS=3, dead-letter ; Micrometer counter optionnel

Légende des états

OK — implémenté et couvert par tests d’intégration en continu
Closed — implémenté via un commit dédié référencé
Pivot — décision archi explicite (voir ADR)

Pour le détail technique avec diagrammes, navigation par catégorie :

Happy paths

Sc 1, 2 — Parcours nominaux Yaoundé↔Paris

Annulations & refus

Sc 3, 4, 5, 17 — Annulations, refus, destinataire absent

Litiges

Sc 6, 7, 16 — Colis perdu, contenu contesté, litige tardif

Paiements & KYC

Sc 8, 9, 10, 11, 19, 20 — Stripe, 3DS, KYC, wallet

Multi-colis & pricing

Sc 12, 13, 14, 15 — Multi-colis, agence, chat, prix catégorie

Preuves photos & GPS

Sc 18, 21, 22, 23, 24 — Annonces, photos, GPS, S3

Source canonique

Le document complet est maintenu dans le repo backend :

_bmad-output/planning-artifacts/scenarios-2026-05-01.md

Toute évolution d’un scénario doit être reflétée dans :

Ce document (source canonique BMAD)
Cette page docs (référence publique)
L’outil MCP get_business_scenarios (contexte agents IA)

Guides