# 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
