> ## 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.

# Exemples d'usage

> Exemples concrets d'utilisation de ColisMove MCP par les différents membres de l'équipe.

Vous n'avez aucune commande à apprendre. Posez simplement vos questions en langage naturel — votre assistant IA s'occupe du reste.

## Pour les développeurs mobile (Flutter)

<AccordionGroup>
  <Accordion title="Trouver le bon endpoint API">
    **Vous demandez :**

    > Je dois implémenter l'écran de création de réservation. Quel endpoint appeler et quel est le format de la requête ?

    **MCP renvoie :** la spec complète de `POST /v1/api/bookings` avec le corps de requête, les champs requis, les en-têtes et le format de réponse.
  </Accordion>

  <Accordion title="Comprendre l'authentification">
    **Vous demandez :**

    > Comment fonctionne le flux d'authentification ? Login, refresh de token et logout.

    **MCP renvoie :** les endpoints d'auth complets (`/auth/login`, `/auth/refresh-token`, `/auth/logout`) avec la gestion des JWT, le format des tokens et le comportement d'expiration.
  </Accordion>

  <Accordion title="Gérer les erreurs">
    **Vous demandez :**

    > Quels codes d'erreur l'endpoint de paiement peut-il renvoyer ?

    **MCP renvoie :** le schéma `ErrorResponse` avec toutes les valeurs possibles d'`errorCode` (`PAYMENT_ERROR`, `INSUFFICIENT_FUNDS`, `STRIPE_CONNECT_NOT_CONFIGURED`, etc.) et leurs codes HTTP.
  </Accordion>

  <Accordion title="Implémenter le cycle de vie d'une réservation">
    **Vous demandez :**

    > Quels sont tous les statuts d'une réservation et comment fonctionnent les transitions ?

    **MCP renvoie :** la machine à états complète : `EN_ATTENTE_PAIEMENT → RESERVATION_PAYEE → EN_ATTENTE → ACCEPTEE → EN_COURS_DE_LIVRAISON → LIVREE` avec les états d'erreur et les chemins d'annulation.
  </Accordion>

  <Accordion title="Scan de QR code">
    **Vous demandez :**

    > Comment fonctionnent les QR codes de dépôt et de livraison ?

    **MCP renvoie :** les endpoints de génération, de validation et de consommation des QR codes avec le flux complet de dépôt/livraison.
  </Accordion>
</AccordionGroup>

## Pour les développeurs web (Backend)

<AccordionGroup>
  <Accordion title="Comprendre l'architecture">
    **Vous demandez :**

    > Explique l'architecture hexagonale et la structure des modules.

    **MCP renvoie :** un découpage complet des bounded contexts (compte, annonces, reservation, finances, etc.), du pattern port/adapter et de la communication inter-modules via Domain Events.
  </Accordion>

  <Accordion title="Ajouter un nouvel endpoint">
    **Vous demandez :**

    > Je dois ajouter un nouvel endpoint au module reservation. Quelle est la convention ?

    **MCP renvoie :** la structure en couches hexagonale — controller dans `infrastructure/controller/`, interface use case dans `domain/port/in/`, service dans `application/service/`, avec les conventions de nommage et des exemples.
  </Accordion>

  <Accordion title="Schéma de base de données">
    **Vous demandez :**

    > Quelle est la structure des tables reservation et transaction ?

    **MCP renvoie :** les schémas des tables, les relations, les colonnes clés et leur correspondance avec les entités du domaine.
  </Accordion>

  <Accordion title="Intégration Stripe">
    **Vous demandez :**

    > Comment fonctionne le flux de paiement Stripe Connect ? Commission plateforme, escrow, transferts ?

    **MCP renvoie :** le flux de paiement complet — 15 % de commission plateforme, capture immédiate avec transfert différé, Connected Accounts pour les transporteurs et gestion des webhooks.
  </Accordion>
</AccordionGroup>

## Pour les équipes marketing & contenu

<AccordionGroup>
  <Accordion title="Comprendre l'audience cible">
    **Vous demandez :**

    > Qui sont nos utilisateurs cibles et quelles sont leurs motivations ?

    **MCP renvoie :** 5 segments prioritaires (diaspora P1, voyageurs P1, étudiants P2, commerçants P2, occasionnels P3) avec 5 personas détaillés incluant motivations, freins et canaux préférés.
  </Accordion>

  <Accordion title="Positionnement concurrentiel">
    **Vous demandez :**

    > Comment nous positionnons-nous face à Cocolis, PiggyBee et aux réseaux GP informels ?

    **MCP renvoie :** le paysage concurrentiel complet avec 5 concurrents directs, leurs taux de commission, forces/faiblesses, et la matrice de différenciation de ColisMove (corridor France↔Afrique, escrow Stripe, KYC, etc.).
  </Accordion>

  <Accordion title="Idées de campagne">
    **Vous demandez :**

    > J'ai besoin d'idées de campagne pour la diaspora pendant les fêtes.

    **MCP renvoie :** 10 concepts de campagne prêts à l'emploi avec segments cibles, ton, budgets estimés et canaux — dont « Le Colis de Maman », « Noël au Pays » et « Le GP c'est fini ».
  </Accordion>

  <Accordion title="Arguments de vente par segment">
    **Vous demandez :**

    > Donne-moi les meilleurs arguments pour les utilisateurs diaspora.

    **MCP renvoie :** le top 10 des arguments classés avec messages clés — sécurité, transparence des prix, suivi, simplicité douanière, etc.
  </Accordion>

  <Accordion title="Saisonnalité et périodes de pointe">
    **Vous demandez :**

    > Quelles sont les périodes de pointe d'envois pour le corridor France-Afrique ?

    **MCP renvoie :** 8 pics internationaux + 4 pics nationaux avec corridors impactés et implications marketing (Ramadan, Noël, Rentrée, etc.).
  </Accordion>

  <Accordion title="Glossaire métier (FR/EN)">
    **Vous demandez :**

    > Quel est le terme correct pour « GP » dans notre langue plateforme ?

    **MCP renvoie :** 35+ termes bilingues répartis sur 7 catégories (acteurs, objets, cycle de vie, finance, confiance, logistique, plateforme) avec leurs définitions.
  </Accordion>

  <Accordion title="Réglementation et conformité">
    **Vous demandez :**

    > Quel cadre légal s'applique à notre service en France et en Afrique ?

    **MCP renvoie :** la loi française sur le transport (Article L3232-1), les règlements UE (DSA, RGPD, DSP2), les règles CEMAC/UEMOA, les objets interdits et le modèle d'assurance.
  </Accordion>

  <Accordion title="Préparer du contenu FAQ">
    **Vous demandez :**

    > Que se passe-t-il si une livraison échoue ou s'il y a un litige ?

    **MCP renvoie :** 20 Q\&R couvrant les sujets stratégiques, marketing, opérationnels et commerciaux, dont la résolution de litiges et les politiques de remboursement.
  </Accordion>
</AccordionGroup>

## Pour les designers & le travail de marque

<AccordionGroup>
  <Accordion title="Brand guidelines">
    **Vous demandez :**

    > Quelle est la personnalité de marque et le ton de voix de ColisMove ?

    **MCP renvoie :** l'identité de marque avec 5 traits de personnalité, le registre de communication par contexte (landing page, app, support, juridique) et les guidelines « dit » vs « ne dit pas ».
  </Accordion>

  <Accordion title="Palette de couleurs">
    **Vous demandez :**

    > Quelles sont les couleurs exactes de la marque en hex et OKLCH ?

    **MCP renvoie :** la palette complète mode clair/sombre avec 17+ tokens — orange primaire (#E85A2A), noir secondaire, accents, fonds, bordures, couleurs de sidebar en hex et OKLCH.
  </Accordion>

  <Accordion title="Catalogue de composants">
    **Vous demandez :**

    > Quels composants UI sont disponibles pour les formulaires ?

    **MCP renvoie :** 63 composants répartis sur 6 catégories (base, formulaire, navigation, feedback, data, métier) avec variantes, tailles et guidelines d'usage.
  </Accordion>

  <Accordion title="Style visuel et effets">
    **Vous demandez :**

    > Quels effets visuels et animations utilise ColisMove ?

    **MCP renvoie :** la philosophie des coins arrondis, les ombres, le glassmorphism, les effets de glow, le texte en gradient, les micro-interactions par composant et l'approche responsive.
  </Accordion>

  <Accordion title="Typographie">
    **Vous demandez :**

    > Quelles polices utilise ColisMove et quelle est l'échelle typographique ?

    **MCP renvoie :** Inter (corps de texte), Geist Sans (titres), Geist Mono (code) avec les plages de graisses et les guidelines d'usage.
  </Accordion>
</AccordionGroup>

## Pour les nouvelles recrues

<AccordionGroup>
  <Accordion title="Questions d'onboarding">
    **Vous demandez :**

    > Je viens d'arriver dans l'équipe. Donne-moi un aperçu de la plateforme ColisMove — stack, architecture et fonctionnalités principales.

    **MCP renvoie :** le contexte projet complet — Java 21 + Spring Boot, architecture hexagonale, PostgreSQL, Stripe Connect, 12 bounded contexts et les flux métier centraux.
  </Accordion>

  <Accordion title="Comprendre les rôles et permissions">
    **Vous demandez :**

    > Quels rôles utilisateur existent et que peut faire chaque rôle ?

    **MCP renvoie :** `ROLE_CLIENT` (utilisateur de base), `ROLE_VERIFIED_USER` (KYC validé, peut créer des annonces), `ROLE_ADMIN`, `ROLE_SUPERADMIN` avec leurs permissions respectives.
  </Accordion>
</AccordionGroup>

## Conseils pour de meilleurs résultats

<CardGroup cols={2}>
  <Card title="Soyez précis" icon="bullseye">
    « Comment fonctionne l'annulation d'une réservation ? » donne de meilleurs résultats que « Parle-moi des réservations ».
  </Card>

  <Card title="Mentionnez le contexte" icon="layer-group">
    « Je construis l'écran de paiement Flutter » aide l'IA à adapter sa réponse à vos besoins.
  </Card>

  <Card title="Posez des questions de suivi" icon="arrows-spin">
    Commencez large, puis zoomez : « Quels endpoints existent pour les paiements ? » → « Montre-moi le format de la requête de création d'un Checkout. »
  </Card>

  <Card title="Posez vos questions dans n'importe quelle langue" icon="globe">
    Le MCP fonctionne en français comme en anglais. Demandez dans la langue qui vous convient.
  </Card>
</CardGroup>