Guide métier

Bienvenue dans le Guide métier de la plateforme Nex. Ce guide s'adresse aux équipes non techniques qui utilisent les outils internes au quotidien : commerciaux, opérations terrain, support client, KAM, conformité.

Il décrit, étape par étape, comment réaliser une procédure dans le dashboard interne (CMMS) ou dans les apps Nex. Il ne contient ni code, ni schéma technique, ni acronyme inutile.

Vous êtes développeur ? La documentation technique se trouve dans les sections Architecture, Flows et Operations.

Par où commencer

Premiers pas

• Se connecter au CMMS
• Changer son mot de passe
• Comprendre les rôles

Marchands

Toutes les procédures pour enregistrer et gérer un marchand (commerçant) sur la plateforme.

➜ Voir la section Marchands

Clients

Procédures liées aux clients particuliers : consultation de fiche, validation KYC, réinitialisation du PIN.

➜ Voir la section Clients

Agents

Procédures réseau de distribution (agents Nex Pro, master-agents).

➜ Voir la section Agents

Transactions

Suivre, consulter et traiter les transactions (cash-in, cash-out, paiements marchands).

➜ Voir la section Transactions

FAQ & Support

Erreurs fréquentes, qui contacter en cas de blocage.

➜ Voir la section FAQ & Support

---

Comment lire ce guide

Pour qui ?

Chaque fiche indique en haut une ligne Pour : ... qui précise les équipes concernées (commercial, ops, support, KAM, conformité). Si votre rôle n'apparaît pas, la procédure ne vous concerne probablement pas directement.

Statut d'une fiche

• stable — procédure en production, suivez les étapes telles qu'écrites.
• beta — fonctionnalité récemment livrée, des ajustements peuvent arriver. Signalez tout écart au support.
• deprecated — procédure obsolète, conservée pour référence historique.
• planned — la procédure existera bientôt, la fiche est un placeholder.

Vocabulaire

Ce guide utilise un vocabulaire métier et évite le jargon technique :

Préférez	À la place de
écran, page	vue, view
bouton	CTA, action
formulaire	form, payload
validation	submit, commit
service, équipe	endpoint, microservice

Noms des applications

• Nex — l'app pour les particuliers.
• Nex Pro — l'app pour les agents du réseau de distribution.
• Nex Business — l'app pour les marchands.
• CMMS — le dashboard interne (que vous utilisez ici).

Les noms historiques "NokiPay" et "NxPay" sont à éviter — la marque publique est Nex.

Captures d'écran

Les captures sont stockées dans apps/docs/usage/_assets/{section}/ selon le nommage {slug-de-la-fiche}-N.png. Une capture manquante est signalée par <!-- TODO screenshot --> dans le texte ; elle sera ajoutée par les équipes métier.

---

Processus de mise à jour

Quand mettre à jour une fiche

• À chaque livraison d'une fonctionnalité qui touche une procédure existante : la fiche concernée doit être relue et mise à jour avant la mise en production.
• Toute nouvelle fonctionnalité côté CMMS, Nex Business, Nex ou Nex Pro doit s'accompagner d'au moins une fiche dans ce guide.
• Relecture trimestrielle : le champ last_review du frontmatter doit être actualisé tous les 90 jours environ.

Comment contribuer

1. Dupliquer _template-procedure.md dans le bon sous-dossier.
2. Renseigner le frontmatter (titre, audience, ticket d'origine, date, statut).
3. Rédiger la procédure en vouvoiement, vocabulaire métier français.
4. Marquer les captures manquantes par <!-- TODO screenshot -->.
5. Ouvrir une pull request avec le label docs:usage.