unionflow-mobile-apps/docs/AUDIT_METIER_COMPLET.md

Audit Métier Complet - UnionFlow Mobile

Date: 2026-03-13 Objectif: Mapper toutes les fonctionnalités attendues selon les rôles et permissions

📊 Matrice Rôles vs Features

8 Rôles Utilisateurs

Rôle	Niveau	Description	Features Principales
SuperAdmin	100	Accès complet système	Toutes features + admin système
OrgAdmin	80	Gestion organisation	Dashboard, membres, finances, événements, solidarité, rapports
Moderator	60	Modération	Dashboard, modération membres/contenu, événements
Consultant	58	Consultation	Dashboard analytics, rapports, membres (lecture)
HRManager	52	RH	Membres (gestion), dashboard, événements
ActiveMember	40	Participation active	Dashboard, profil, événements, solidarité, finances perso
SimpleMember	20	Accès basique	Dashboard basique, profil, finances perso
Visitor	0	Public	Événements publics uniquement

🎯 Features Existantes vs Attendues

✅ Features Complètes (21 modules)

1. authentication - Authentification Keycloak OAuth2/OIDC
2. dashboard - Dashboards morphiques par rôle
3. members - Gestion des membres avec permissions
4. organizations - CRUD organisations
5. events - Gestion événements
6. solidarity - Demandes d'aide/solidarité
7. contributions - Cotisations/contributions
8. epargne - Épargne mutuelle
9. adhesions - Modération adhésions
10. reports - Rapports organisation
11. notifications - Notifications in-app
12. profile - Profil utilisateur
13. admin - Gestion utilisateurs (SuperAdmin)
14. backup - Backup/restore (SuperAdmin)
15. logs - Logs système (SuperAdmin)
16. settings - Paramètres système
17. about - À propos
18. help - Aide & support
19. explore - Exploration (à vérifier)
20. feed - Fil d'actualité (à vérifier)

⚠️ Features à Vérifier

1. Communication/Messagerie (CRITIQUE)

Permissions attendues:

• COMM_SEND_ALL (OrgAdmin, SuperAdmin)
• COMM_SEND_MEMBERS (Moderator)
• COMM_BROADCAST (OrgAdmin)
• COMM_TEMPLATES (OrgAdmin)
• COMM_MODERATE (Moderator)

État actuel:

• ✅ notifications existe (notifications passives)
• ❌ MANQUE: Module messagerie active (envoi messages, broadcast, templates)
• ❌ MANQUE: Chat/messaging entre membres
• ❌ MANQUE: Notifications push configurables

Action requise: Créer feature communication ou messaging

2. Modération Complète

Permissions attendues:

• MODERATION_CONTENT (Moderator)
• MODERATION_USERS (Moderator, HRManager)
• MODERATION_REPORTS (Moderator)

État actuel:

• ✅ adhesions (modération adhésions membres)
• ❌ MANQUE: Modération de contenu (posts, commentaires)
• ❌ MANQUE: Signalements/reports
• ❌ MANQUE: Actions de modération (warn, suspend, ban)

Action requise: Compléter feature moderation

3. Finances Complètes

Permissions attendues:

• Toutes les permissions FINANCES_* (view, manage, approve, reports, budget, audit)

État actuel:

• ✅ contributions (cotisations)
• ✅ epargne (épargne mutuelle)
• ❌ MANQUE: Gestion budget
• ❌ MANQUE: Approbation transactions (workflow)
• ❌ MANQUE: Audit financier complet
• ❌ MANQUE: Export/import comptable

Action requise: Enrichir contributions et epargne

4. Rapports Avancés

Permissions attendues:

• REPORTS_SCHEDULE (programmation rapports automatiques)
• REPORTS_EXPORT (export multi-formats)

État actuel:

• ✅ reports existe
• ❌ À VÉRIFIER: Export PDF/Excel/CSV
• ❌ À VÉRIFIER: Rapports programmés
• ❌ À VÉRIFIER: Personnalisation rapports

Action requise: Audit approfondi du module reports

5. Explore & Feed (Non documentés)

État actuel:

• ✅ Modules existent dans le code
• ❌ Aucune permission correspondante dans PermissionMatrix
• ❌ Cas d'usage non documentés

Action requise: Documenter ou supprimer si hors scope

🔍 Gaps Fonctionnels Critiques

P0 - Bloquants Production

1. ❌ Communication/Messaging

   • Broadcast aux membres
   • Templates notifications
   • Chat/messaging inter-membres
   • Impact: OrgAdmin ne peut pas communiquer efficacement

2. ❌ Workflow Approbations Finances

   • Validation multi-niveaux transactions
   • Limite montants selon rôles
   • Audit trail complet
   • Impact: Risque financier, non-conformité

3. ❌ Gestion KYC/AML (Anti-blanchiment - cf spec 001)

   • Vérification identité membres
   • Suivi transactions suspectes
   • Niveaux de vigilance
   • Impact: Conformité légale mutuelles

4. ❌ Système de Modération Complet

   • Signalements
   • Actions modération
   • Impact: Qualité communauté

P1 - Importantes mais non-bloquantes

5. ❌ Rapports Programmés & Export Avancé

   • Scheduling automatique
   • Multi-formats (PDF, Excel, CSV)
   • Templates personnalisés

6. ❌ Gestion Budget

   • Création budgets prévisionnels
   • Suivi réalisé vs prévisionnel
   • Alertes dépassements

7. ❌ Intégrations Paiement Mobile

   • Wave, Orange Money, MTN Money, etc.
   • Webhooks confirmations
   • Réconciliation automatique

P2 - Nice to Have

8. ❌ Statistiques & Analytics Avancées

   • Dashboards personnalisables
   • Graphiques interactifs
   • Exports données

9. ❌ Multilingue (i18n)

   • Français, Anglais minimum
   • Sélection langue profil

10. ❌ Mode Offline Robuste

    • Synchronisation intelligente
    • Résolution conflits
    • Cache stratégique

📋 Matrice Complète Features x Rôles

Feature	Visitor	Simple	Active	HR	Consultant	Moderator	OrgAdmin	SuperAdmin
Dashboard	❌	✅ Basic	✅ Full	✅ Full	✅ Analytics	✅ Full	✅ Full	✅ Admin
Members View	❌	Own	Own	All	All	All	All	All
Members Edit	❌	Own	Own	Basic	❌	Approve	All	All
Organizations	❌	❌	❌	❌	View	❌	Manage	All
Events View	Public	Public	All	All	All	All	All	All
Events Manage	❌	❌	Create Own	❌	❌	Moderate	All	All
Solidarity View	❌	Own	All	❌	❌	❌	All	All
Solidarity Manage	❌	❌	Create	❌	❌	❌	Approve	All
Finances View	❌	Own	Own	❌	All	❌	All	All
Finances Manage	❌	❌	❌	❌	❌	❌	Manage	All
Communication	❌	❌	❌	❌	❌	Members	All	All
Reports	❌	❌	❌	❌	Generate	❌	Generate	All
Admin/System	❌	❌	❌	❌	❌	❌	❌	✅
Moderation	❌	❌	❌	Users	❌	All	❌	All

🎯 Prochaines Actions

Immédiat (Cette Session)

1. ✅ Compléter Tâche #1: Erreurs compilation → FAIT
2. 🔄 Tâche #2 en cours: Audit DI → EN COURS
3. ⏭️ Créer feature Communication/Messaging (P0)
4. ⏭️ Compléter Modération (P0)
5. ⏭️ Enrichir Finances avec workflows (P0)

Validation Métier Requise

• ❓ Explore & Feed: Garder ou supprimer ?
• ❓ Communication: Priorité broadcast ou chat individuel d'abord ?
• ❓ KYC/AML: Spec 001 - déjà en cours ?

📝 Notes

• Tous les modules existants utilisent Clean Architecture + BLoC
• DI configuré avec GetIt + Injectable
• Navigation via go_router
• Design system UnionFlow avec tokens

---

Conclusion: L'app a une base solide (21 features) mais 4 gaps P0 critiques avant production :

1. Communication/Messaging
2. Workflow Finances
3. KYC/AML
4. Modération complète