Documentation Zekorapay
ZekoraPay Platform – Reference complète pour développeurs et utilisateurs
🤝 Guide Complet & Multi-Protagonistes des Associations, Tontines & Cotisations Zekorapay
Ce guide présente le fonctionnement complet du module Associations & Tontines pour l'ensemble des protagonistes : le Membre, le Bureau (Président/Trésorier) et la Plateforme Zekorapay.
👥 Table des Protagonistes & Rôles
| Protagoniste | Responsabilités Principales | Actions Protégées par PIN |
|---|---|---|
| 👤 Le Membre | Rechercher un groupe, cotiser aux tours de tontine, régler la ration de séance, voter sur les décisions, participer au chat. | Cotisation de séance, versement tontine, vote de gouvernance. |
| 👑 Le Bureau (Président / Trésorier) | Enregistrer les espèces (cash), valider les distributions, lancer les élections, effectuer les clôtures de séance (settlement). | Dépôt d'espèces, validation de distribution, élection, clôture de séance. |
| 🏛️ Le Système Zekorapay | Clavier anti-keylogger usePin(), chiffrement RSA-OAEP, comptabilité en partie double, audit logs immutables. |
Déchiffrement clé privée RSA, validation authClient.VerifyPin. |
📸 Parcours Utilisateur par Étapes (Captures Réelles Playwright)
1. 👤 Le Membre — Exploration & Adhésion (Étape 1)
L'explorateur permet de filtrer les associations par catégorie (Tontine rotative, Cotisation, Épargne, Secours/Aide) et de consulter les conditions d'adhésion.
2. 👑 Le Bureau — Assistant de Création d'une Tontine (Étapes 2 à 4)
Le créateur du groupe configure l'identité, le type d'activité et les règles financières.
Étape 2 : Identité & Nom de l'Association
3. 👤 Le Membre & 👑 Le Bureau — Tableau de Bord "Mes Associations" (Étape 5)
Vue consolidée de l'ensemble des associations dont l'utilisateur fait partie avec l'indication de son rôle (Président, Trésorier, Secrétaire ou Membre).
4. 📊 Espace de Travail — Onglet Aperçu (Étape 6)
Consulte les soldes généraux de l'association (Digital Bank + Registre Cash) ainsi que la liste des événements et réunions à venir.
5. 👥 👑 Onglet Membres & Attribution des Rôles (Étape 7)
Le Président et le Secrétaire gèrent la liste des membres, génèrent les liens d'invitation uniques et attribuent les rôles de gestion.
6. 💰 👤 Onglet Cotisations & Tours de Tontine Rotative (Étape 8)
Le Membre verse sa cotisation pour le tour courant. Le système enregistre l'historique des tirages et calcule l'ordre de passage.
7. 🏛️ 👑 Onglet Trésorerie & Dépôts d'Espèces (Étape 9)
Le Trésorier enregistre les versements physiques faits en espèces (Cash) et initie les demandes de distribution du fonds de trésorerie.
8. 📅 👤 👑 Onglet Réunions, Rations & Clôture de Séance (Étape 10)
Les membres paient la ration et la cotisation de séance. Le Trésorier ou Président valide la clôture de réunion (settlement) pour redistribuer la collecte.
9. ⚙️ 👑 Onglet Gouvernance, Votes & Élections (Étape 11)
Le Bureau et les Membres votent sur les dépôts d'espèces, les projets d'investissement ou les élections de nouveaux dirigeants.
10. 💬 👤 Onglet Chat de Groupe Sécurisé (Étape 12)
Espace de discussion en temps réel crypté et réservé exclusivement aux membres actifs de l'association.
🔒 Sécurité & Cryptographie de la Saisie du PIN
Chaque protagoniste qui exécute une action financière interagit avec le pavé numérique anti-keylogger :
- Saisie Anti-Keylogger : Clavier virtuel à touches mélangées (
usePin()). - Chiffrement Navigateur : Transformation du PIN en ciphertext RSA-OAEP avec la clé publique du serveur.
- Vérification Microservice : Le microservice
association-servicerelaie le ciphertext versauth-servicequi possède la clé privée.