> ## Documentation Index
> Fetch the complete documentation index at: https://mavrodi.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Cycle de vie d'un Ordre : statuts, actions et votre rôle
> Comprenez chaque statut d'Ordre de DRAFT à RECEIVED, qui peut agir à chaque étape, et comment gérer les litiges et la création manuelle d'Ordres.
Un Ordre est l'unité de transaction centrale dans InviteBot. Il relie l'Intention d'un participant (son offre de donner) à la Demande d'aide d'un autre (sa demande de réception), et indique à l'expéditeur de transférer un montant précis au destinataire. En tant que Mentor, vous intervenez aux points de décision critiques : vous examinez les nouveaux Ordres avant qu'ils n'arrivent à votre participant, vous pouvez rejeter ceux qui posent problème et vous supervisez la résolution en cas de souci.
Le système crée la plupart des Ordres automatiquement via des tâches planifiées qui rapprochent les Intentions et Demandes d'aide compatibles. Vous pouvez aussi en créer manuellement si nécessaire. Dans les deux cas, le même cycle de vie s'applique.
## Vue d'ensemble du cycle de vie
Les Ordres traversent une séquence définie de statuts. Chaque statut a des acteurs précis qui peuvent agir, et les actions déclenchent les transitions.
```
DRAFT → NEW → ACCEPTED → PAID → RECEIVED
↘ DISPUTE → RECEIVED
↘ CANCELED
↓ ↓
REJECTED REFUSED
DRAFT → CANCELED
```
## Statuts d'un Ordre
### DRAFT
L'Ordre a été créé mais n'est pas encore activé. Cela arrive quand un Mentor crée un Ordre manuellement avec `/order_add`.
**Qui peut agir :** Le Mentor qui a créé l'Ordre.
**Actions disponibles :**
* Passer à NEW (active l'Ordre et l'envoie dans la file d'examen)
* Annuler (→ CANCELED, met fin à l'Ordre)
À ce stade, l'Ordre n'est pas visible pour le participant. Utilisez cette étape pour vérifier les détails avant d'activer.
***
### NEW
L'Ordre est actif et attend que le Mentor du détenteur de l'Intention l'examine et l'envoie à son participant.
**Qui peut agir :** Le Mentor du détenteur de l'Intention.
**Actions disponibles :**
* Accepter et envoyer au participant (→ ACCEPTED)
* Rejeter (→ REJECTED)
C'est le point de décision le plus important du cycle. Vous vérifiez que l'Ordre est approprié pour votre participant avant de l'engager dans un transfert.
***
### ACCEPTED
L'Ordre a été envoyé au participant (l'expéditeur). Le participant voit maintenant les coordonnées de paiement du destinataire et doit effectuer le transfert.
**Qui peut agir :** Le participant (expéditeur) ; le Mentor.
**Actions disponibles :**
| Acteur | Action | Résultat |
| ----------- | ---------------------------- | ---------- |
| Participant | Confirmer le paiement envoyé | → PAID |
| Participant | Refuser d'exécuter | → REFUSED |
| Mentor | Rejeter | → REJECTED |
| Mentor | Retirer (rappel) | → REFUSED |
Les coordonnées de paiement que voit le participant dépendent du fait que la Demande d'aide est une demande système et que le participant est vérifié ou non. Les participants non vérifiés voient des coordonnées de paiement spéciales pour leur premier transfert. Une fois vérifiés, ils voient les coordonnées standards ou système adaptées au type de demande.
***
### PAID
Le participant a confirmé qu'il a envoyé le transfert. Le destinataire doit maintenant confirmer qu'il l'a reçu.
**Qui peut agir :** Le destinataire ; les administrateurs.
**Actions disponibles :**
| Acteur | Action | Résultat |
| ------------ | ------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| Destinataire | Confirmer la réception | → RECEIVED |
| Destinataire | Signaler la non-réception | → DISPUTE |
| Admin | Confirmer la réception à la place du participant | → RECEIVED |
| Admin | Annuler l'Ordre | → REFUSED (annule aussi l'Intention liée et les autres Ordres ouverts sur cette Intention) |
***
### RECEIVED
Le destinataire a confirmé que les fonds sont arrivés. C'est un statut terminal réussi.
**Qui peut agir :** Aucune action supplémentaire requise.
**Ce qui se passe :** Les soldes sont mis à jour sur les Intentions et Demandes d'aide liées, les notifications sont envoyées à toutes les parties, et les éventuelles récompenses MAVRO sont traitées.
***
### REFUSED
Le participant a refusé d'exécuter l'Ordre, ou le Mentor l'a rappelé. C'est un statut terminal.
**Raisons fréquentes :**
* Le participant ne peut pas exécuter le transfert à temps
* Problèmes techniques avec le moyen de paiement
* Coordonnées de paiement incorrectes
* Circonstances personnelles
**Ce qui se passe :** Le système cherche un participant de remplacement pour la même Demande d'aide. Le montant de l'Ordre retourne dans le pool de matching.
***
### REJECTED
Le Mentor a rejeté l'Ordre. C'est un statut terminal.
**Raisons fréquentes :**
* Le participant a des fonds insuffisants
* Le participant refuse de transférer
* L'Intention est déjà entièrement confirmée
* Le participant est injoignable ou a bloqué le bot
* L'aide n'a pas encore été reçue (en attente de réceptions antérieures)
***
### CANCELED
L'Ordre a été annulé. Cela arrive généralement depuis le statut DRAFT, ou via l'intervention d'un administrateur sur un Ordre actif.
***
### DISPUTE
Le destinataire a signalé qu'il n'a pas reçu le transfert, alors que l'expéditeur a confirmé l'avoir envoyé. Ce statut requiert une enquête.
**Qui peut agir :** Administrateurs ; les Mentors peuvent aider à rassembler des preuves.
**Actions disponibles (admin uniquement) :**
| Action | Résultat |
| ------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Confirmer la réception à la place du destinataire | → RECEIVED |
| Annuler l'Ordre | → REFUSED (annule aussi l'Intention liée et les Ordres ouverts sur cette Intention) |
***
## Matrice statuts et actions
| Statut | Créateur de l'Ordre (Mentor) | Mentor de l'Intention | Participant (expéditeur) | Destinataire | Admin |
| -------- | ---------------------------- | ------------------------- | ------------------------ | -------------------------------- | ----------------------- |
| DRAFT | Passer à NEW, Annuler | — | — | — | Toute action |
| NEW | — | Accepter/Envoyer, Rejeter | — | — | Toute action |
| ACCEPTED | — | Rejeter, Retirer | Confirmer payé, Refuser | — | Toute action |
| PAID | — | — | — | Confirmer reçu, Ouvrir un litige | Confirmer reçu, Annuler |
| DISPUTE | — | — | — | — | Confirmer reçu, Annuler |
| RECEIVED | — | — | — | — | Toute action |
| REFUSED | — | — | — | — | Toute action |
| REJECTED | — | — | — | — | Toute action |
| CANCELED | — | — | — | — | Toute action |
## Créer un Ordre manuellement
Si vous devez créer un Ordre en dehors du processus de matching automatique — par exemple, pour relier une Intention précise à une Demande d'aide précise — utilisez la commande `/order_add` :
```text theme={null}
/order_add_A123_G456_1000
```
Où :
* `A123` est l'identifiant de la Demande d'aide (Ask)
* `G456` est l'identifiant de l'Intention
* `1000` est le montant
L'Ordre est créé au statut DRAFT. Examinez-le, puis activez-le en le faisant passer à NEW.
Les Ordres manuels contournent la logique de matching automatique. Vérifiez que la Demande d'aide et l'Intention sont compatibles (même devise, montants appropriés) avant d'activer. Des Ordres manuels erronés sèment la confusion chez les deux participants.
Vous pouvez consulter les Ordres créés par ou impliquant le système avec :
```text theme={null}
/system_orders
```
## Gérer les litiges
Quand un Ordre passe au statut DISPUTE, votre rôle est de rassembler les preuves et d'escalader à un administrateur.
Joignez le participant qui a confirmé le paiement. Demandez une capture d'écran ou un relevé de transaction prouvant le transfert.
Vérifiez que l'expéditeur a bien utilisé le bon numéro de carte, téléphone ou adresse de portefeuille. Les erreurs ici sont fréquentes.
Demandez au destinataire de re-vérifier ses comptes. Les transferts peuvent être retardés par les banques.
Si les preuves sont claires ou si la situation ne peut être résolue à votre niveau, utilisez `/admin` pour joindre un administrateur. Partagez l'ID de l'Ordre et toutes les captures d'écran collectées.
Vous ne pouvez pas résoudre un DISPUTE vous-même — seuls les administrateurs peuvent décider en dernière instance de le marquer comme RECEIVED ou de l'annuler. Votre rôle est d'enquêter et de présenter les faits.
## Création automatique d'Ordres
Le système rapproche automatiquement les Intentions ouvertes et les Demandes d'aide en attente et crée des Ordres de façon régulière. Cela se produit sans intervention manuelle quand :
* Une Intention active valide existe dans le pool de matching
* Une Demande d'aide que vous avez approuvée est en attente
* Les montants et devises sont compatibles
Quand un Ordre automatique impliquant un membre de votre structure est créé, vous recevez une notification et l'Ordre arrive dans votre file d'examen au statut NEW.