Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://mavrodi.org/llms.txt

Use this file to discover all available pages before exploring further.

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 :
ActeurActionRésultat
ParticipantConfirmer le paiement envoyé→ PAID
ParticipantRefuser d’exécuter→ REFUSED
MentorRejeter→ REJECTED
MentorRetirer (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.
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 :
ActeurActionRésultat
DestinataireConfirmer la réception→ RECEIVED
DestinataireSignaler la non-réception→ DISPUTE
AdminConfirmer la réception à la place du participant→ RECEIVED
AdminAnnuler 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) :
ActionRé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

StatutCréateur de l’Ordre (Mentor)Mentor de l’IntentionParticipant (expéditeur)DestinataireAdmin
DRAFTPasser à NEW, Annuler———Toute action
NEW—Accepter/Envoyer, Rejeter——Toute action
ACCEPTED—Rejeter, RetirerConfirmer payé, Refuser—Toute action
PAID———Confirmer reçu, Ouvrir un litigeConfirmer 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 : 
/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 : 
/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.
1

Contactez l'expéditeur

Joignez le participant qui a confirmé le paiement. Demandez une capture d’écran ou un relevé de transaction prouvant le transfert.
2

Vérifiez les coordonnées de paiement

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

Contactez le destinataire

Demandez au destinataire de re-vérifier ses comptes. Les transferts peuvent être retardés par les banques.
4

Escaladez à l'admin

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.