Manuel FIELD_AGENT — Agent terrain mobile

L'agent terrain travaille en tournée, hors agence. Son outil principal est l'app Flutter sur smartphone.

Connexion

  1. Ouvrir l'app Kairos MFI
  2. Sélectionner le mode Agent terrain sur l'écran de login
  3. Saisir :
    • Identifiant institution (ex. demo)
    • Email professionnel
    • Mot de passe
  4. Si rôle != FIELD_AGENT ou DIRECTOR, l'accès est refusé

À la 1re connexion, autoriser les notifications push (sinon vous ne recevrez pas les alertes de validation).

Chercher / consulter un membre

  • Onglet Membres → champ recherche en haut (nom, numéro, téléphone)
  • Tap sur un membre → fiche détail :
    • Profil (nom, n° membre, téléphone, KYC)
    • Comptes ACTIVE avec soldes
    • Crédits ACTIVE avec reste dû
    • 3 boutons d'action (voir ci-dessous)

Créer un nouveau membre

Cas typique : vous arrivez dans un village, une personne veut adhérer.

  1. Onglet Membres → bouton flottant « Nouveau membre »
  2. Renseigner au minimum :
    • Prénom, Nom *
    • Téléphone (E.164 recommandé, ex. +22870752585)
    • Agence d'attache * (auto-sélectionnée s'il n'y en a qu'une)
  3. Optionnel mais recommandé : date de naissance, sexe, n° pièce d'identité, profession, adresse
  4. « Créer le membre »
  5. Le membre est créé en statut PENDING avec KYC DRAFT. Vous arrivez directement sur sa fiche.
  6. Le dossier KYC sera complété et validé ensuite par un DIRECTOR ou CREDIT_MANAGER depuis le back-office web (upload pièce d'identité, preuves d'adresse, etc.).

Encaisser un dépôt en tournée

Cas typique : un membre vous remet 5 000 XOF en cash pour son compte épargne.

  1. Ouvrir la fiche du membre
  2. Si aucun compte ACTIVE n'est listé : impossible, demander à un DIRECTOR / TELLER d'ouvrir un compte d'abord
  3. Bouton « Encaisser dépôt »
  4. Choisir le compte cible (dropdown)
  5. Montant (ex. 5000)
  6. Notes (optionnel mais recommandé en tournée) : ex. « Tournée village Tové »
  7. « Encaisser »
  8. Confirmation à l'écran + SMS de confirmation au membre (KingSMS)
    • push notification sur son téléphone s'il a installé l'app
  9. La transaction apparaît immédiatement dans son historique

⚠️ Vous restez responsable du cash collecté. À votre retour en agence, vous le déposez chez le caissier qui valide la remise.

Décaisser un crédit en tournée

Quand un crédit a déjà été approuvé par un DIRECTOR ou CREDIT_MANAGER, vous pouvez livrer le cash au membre directement chez lui plutôt que de le faire venir en agence.

⚠️ Séparation des pouvoirs : vous ne pouvez décaisser que des prêts déjà APPROVED. Vous ne pouvez ni approuver ni modifier le montant.

  1. Ouvrez la fiche du membre
  2. Si un prêt APPROVED est en attente, vous voyez un bandeau jaune « Crédits à décaisser » avec la référence et le montant
  3. Bouton « Décaisser crédit »
  4. Le sheet de confirmation affiche :
    • Le crédit (dropdown si plusieurs APPROVED en attente)
    • Le montant à remettre en espèces (non modifiable — c'est le montant approuvé)
  5. Renseignez des notes : lieu de remise, témoin présent, contexte (recommandé pour traçabilité)
  6. « Confirmer le décaissement »
  7. Le système :
    • Génère l'échéancier complet du crédit
    • Passe le prêt au statut ACTIVE
    • Génère les écritures comptables OHADA (caisse ↓ / créances ↑)
    • Envoie un SMS de confirmation au membre avec la 1re échéance
    • Envoie une notif push au membre s'il a installé l'app

Remettez le cash au membre immédiatement après la confirmation. La 1re échéance s'affiche automatiquement dans l'app du membre.

À votre retour en agence, l'opération est tracée dans votre journal (carte « Ma journée », ligne Décaissements).

Enregistrer un remboursement de crédit en tournée

  1. Ouvrir la fiche du membre
  2. Section « Crédits en cours » doit lister au moins un crédit ACTIVE
  3. Bouton « Remboursement crédit »
  4. Choisir le crédit (dropdown) → le reste dû s'affiche
  5. Montant (peut être inférieur au reste dû — sera imputé sur la prochaine échéance, partiellement si besoin)
  6. Notes optionnelles
  7. « Enregistrer le remboursement »
  8. Confirmation + SMS + push au membre

Si le remboursement solde toutes les échéances restantes, le crédit passe automatiquement en statut CLOSED.

Réinitialiser le mot de passe du portail membre

Si un membre a perdu son accès et n'a pas de téléphone enregistré pour le SMS OTP self-service :

  1. Sur sa fiche → bouton « Reset portail »
  2. Confirmer
  3. Un mot de passe temporaire de 10 caractères s'affiche
  4. « Copier » ou notez-le sur papier
  5. Le transmettre au membre. Il devra le changer à sa prochaine connexion (onglet Profil → Changer mon mot de passe).

Ma journée

Onglet Profil → carte « Ma journée » :

  • Nombre d'opérations effectuées aujourd'hui
  • Total dépôts collectés
  • Total remboursements collectés
  • Total décaissements (cash sorti vers les membres)
  • Total collecté combiné

Mis à jour automatiquement à chaque opération (pull-to-refresh disponible).

Sécurité et bonnes pratiques

  • Verrouillage écran obligatoire sur le téléphone
  • Se déconnecter systématiquement à la fin de la journée (Profil → Se déconnecter) — désactive le token push côté serveur
  • Ne pas prêter le téléphone une fois loggé
  • En cas de perte du téléphone, prévenir un DIRECTOR pour désactivation immédiate du compte