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.Documentation Index
Fetch the complete documentation index at: https://docs.colismove.com/llms.txt
Use this file to discover all available pages before exploring further.
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)
Navigation par thème
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 :- Ce document (source canonique BMAD)
- Cette page docs (référence publique)
- L’outil MCP
get_business_scenarios(contexte agents IA)