🔒Paiement 100 % sécurisé 🕐Support 24/7 🌍FedaPay & Stripe — Mobile Money & cartes

ADMIN_PLATFORM

Guide de l'administrateur plateforme (RMS)

L'admin RMS supervise l'ensemble de la plateforme : il onboarde et valide les gestionnaires, gère les forfaits, lit les KPIs consolidés multi-tenant, facture les gestionnaires et surveille la sécurité. C'est le seul rôle habilité à faire des lectures inter-tenant, et uniquement sur des données agrégées.

🔑Accès

Connectez-vous à l'espace Admin avec votre compte Keycloak portant le rôle ADMIN_PLATFORM (realm sikaflow, connexion PKCE via le client sikaflow-web).

Onboarder et valider un gestionnaire

Un gestionnaire est un tenant (client B2B payant). Son cycle de vie suit un statut : trial → active → suspended / terminated, avec un statut KYC parallèle : pending → verified / rejected.

trial→ active→ suspended→ terminated
  1. Réception de la demandeLe gestionnaire s'inscrit : société, contact, email, téléphone, pays, devise par défaut. Un compte Keycloak est créé et le tenant démarre en trial, KYC pending.
  2. Contrôle KYCVérifiez l'identité de la société et du contact (documents fournis). Marquez le KYC verified ou rejected.
  3. Attribution du forfaitAffectez un forfait (starter, pro ou business) qui fixe les limites et la commission.
  4. ActivationPassez le statut à active. Le gestionnaire peut alors créer des groupes et inviter des participants.
⚠️KYC obligatoire

N'activez jamais un gestionnaire dont le KYC n'est pas verified : il encaisse de l'argent de tiers. Un KYC rejected doit rester bloqué en trial ou être résilié.

Forfaits & limites

Les forfaits vivent dans la partition PLATFORM et sont gérés par l'admin. Chaque forfait définit un prix mensuel (XOF et EUR) et des plafonds (groupes, participants). La part de commission conservée par Sikaflow est fixe : 25 % de la commission du tontinier, identique sur tous les forfaits — le forfait ne fait varier que les plafonds et le support (modèle Option B, 2026-09-24).

Attribut Rôle
monthlyPriceXOF / monthlyPriceEURAbonnement SaaS mensuel selon la devise du gestionnaire.
maxGroupsNombre maximal de groupes actifs simultanés.
maxParticipantsNombre maximal de participants tous groupes confondus.
commissionPctCommission prélevée à la source sur chaque cotisation encaissée (ex. 0.02 = 2 %).
features[]Options incluses (ex. multi-devises, exports, animations communautaires).

Trois paliers de référence : starter pro business. Changer le forfait d'un gestionnaire met à jour ses limites et sa commission dès la facture du mois suivant.

Tableau de bord consolidé (KPIs)

Le tableau de bord Admin agrège l'activité de tous les tenants — sans jamais exposer le détail des données d'un gestionnaire. Les indicateurs proviennent de la partition PLATFORM et d'agrégats GSI, jamais de lectures brutes par tenant.

🏢 Gestionnaires

Total, actifs, en essai, suspendus ; répartition par forfait et par pays.

👥 Groupes & participants

Groupes actifs, participants, taux d'occupation par rapport aux limites des forfaits.

💸 Volume de flux

Cotisations encaissées (FedaPay / Stripe / hors-ligne), décaissements, par devise.

📈 Revenus RMS

Abonnements SaaS + commissions prélevées, MRR, impayés.

Facturer les gestionnaires

Chaque mois, le module de facturation génère une facture INVOICE#<yyyy-mm> par gestionnaire, composée de deux lignes : l'abonnement SaaS (selon le palier) et le relevé de commissions (somme des commissions prélevées à la source sur les cotisations du mois).

draft→ issued→ paid/ overdue
  1. Revue des brouillonsEn début de mois, chaque facture est en draft : vérifiez abonnement + commissions.
  2. ÉmissionPassez la facture en issued ; le PDF (pdfUrl) devient disponible pour le gestionnaire.
  3. Suivi des règlementsMarquez paid à réception ; relancez les overdue.
💡Commission au fil de l'eau

La commission est prélevée à la source au moment où une cotisation passe paid (champ commissionWithheld par cotisation). La facture ne fait qu'agréger — chaque franc est traçable.

Supervision de la sécurité

Sikaflow journalise chaque action sensible dans un log d'audit (AUDIT#<timestamp>) avec l'acteur, son rôle, l'IP et la cible. Les logs Keycloak et applicatifs sont exportables vers le SIEM Wazuh existant de RMS.

🔒Isolation multi-tenant

La règle d'or : un gestionnaire ne voit jamais les données d'un autre. Chaque enregistrement est partitionné par TENANT#<managerId> et un test de non-régression vérifie qu'une lecture inter-tenant est impossible. Les secrets (clés FedaPay/Stripe) vivent dans AWS Secrets Manager / SSM, jamais dans le code.

Suspendre ou résilier un compte

En cas d'impayé, de fraude avérée ou à la demande du client, l'admin peut faire évoluer le statut du tenant.

Action Effet
suspended Accès gestionnaire et paiements gelés ; les données sont conservées. Réversible : repasser en active réactive le compte.
terminated Résiliation définitive après clôture des groupes en cours et règlement des décaissements dus. Facturation finale émise.
⚠️Avant de résilier

Assurez-vous qu'aucun tour n'est ouvert avec un fonds non décaissé : les participants ont cotisé et attendent leur bénéficiaire. Clôturez proprement les groupes et libérez les décaissements dus avant de passer en terminated.