Initial commit: unionflow-mobile-apps

Application Flutter complète (sans build artifacts).

Signed-off-by: lions dev Team

docs/AUDIT_METIER_COMPLET.md

@@ -0,0 +1,221 @@
+# 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