Initial commit: unionflow-mobile-apps
Application Flutter complète (sans build artifacts). Signed-off-by: lions dev Team
This commit is contained in:
dahoud
240
docs/README.md
Normal file
240
docs/README.md
Normal file
@@ -0,0 +1,240 @@
|
||||
# Documentation UnionFlow Mobile Apps
|
||||
|
||||
Documentation complète de l'application mobile Flutter.
|
||||
|
||||
---
|
||||
|
||||
## 📚 Guides de Test
|
||||
|
||||
### [TESTS_INTEGRATION_FINANCE_WORKFLOW.md](./TESTS_INTEGRATION_FINANCE_WORKFLOW.md)
|
||||
|
||||
**Description:** Guide unique pour tester l'intégration mobile-backend Finance Workflow
|
||||
|
||||
**Contenu:**
|
||||
- Utilisateurs Keycloak réels à utiliser (pas besoin de créer de nouveaux comptes)
|
||||
- Scénario de test complet (15 minutes)
|
||||
- Workflow approbations (membre → admin)
|
||||
- Gestion budgets
|
||||
- Checklist de validation
|
||||
- Troubleshooting
|
||||
|
||||
**Utilisation:**
|
||||
```bash
|
||||
# 1. Vérifier prérequis
|
||||
cd ../scripts
|
||||
.\start-integration-tests.ps1
|
||||
|
||||
# 2. Lancer app mobile
|
||||
cd ..
|
||||
flutter run --dart-define=ENV=dev
|
||||
|
||||
# 3. Suivre le guide TESTS_INTEGRATION_FINANCE_WORKFLOW.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Architecture & Design
|
||||
|
||||
### [CONTRIBUTIONS_CLEAN_ARCHITECTURE.md](./CONTRIBUTIONS_CLEAN_ARCHITECTURE.md)
|
||||
|
||||
**Description:** Refactoring Clean Architecture de la feature Contributions
|
||||
|
||||
**Contenu:**
|
||||
- Structure domain complète (interface + 8 use cases)
|
||||
- Refactoring du BLoC pour utiliser les use cases
|
||||
- Architecture conforme aux principes SOLID
|
||||
- Guide de résolution des conflits de noms
|
||||
|
||||
**Statut:** ✅ Complété - 100% conforme Clean Architecture
|
||||
|
||||
### [EVENTS_CLEAN_ARCHITECTURE.md](./EVENTS_CLEAN_ARCHITECTURE.md)
|
||||
|
||||
**Description:** Refactoring Clean Architecture de la feature Events
|
||||
|
||||
**Contenu:**
|
||||
- Structure domain complète (interface + 10 use cases)
|
||||
- Refactoring du BLoC pour utiliser les use cases
|
||||
- Documentation des endpoints backend manquants (feedback, mes-inscriptions)
|
||||
- Gestion des conflits de noms avec alias d'import
|
||||
|
||||
**Statut:** ✅ Complété - 100% conforme Clean Architecture (2 endpoints backend à ajouter)
|
||||
|
||||
### [MEMBERS_CLEAN_ARCHITECTURE.md](./MEMBERS_CLEAN_ARCHITECTURE.md)
|
||||
|
||||
**Description:** Refactoring Clean Architecture de la feature Members
|
||||
|
||||
**Contenu:**
|
||||
- Structure domain complète (interface + 8 use cases)
|
||||
- Refactoring du BLoC pour utiliser les use cases
|
||||
- Gestion de recherche avancée et export membres
|
||||
- Résolution de conflits de noms avec alias d'import
|
||||
|
||||
**Statut:** ✅ Complété - 100% conforme Clean Architecture (Phase P1 81% complétée)
|
||||
|
||||
### [PROFILE_CLEAN_ARCHITECTURE.md](./PROFILE_CLEAN_ARCHITECTURE.md)
|
||||
|
||||
**Description:** Refactoring Clean Architecture de la feature Profile
|
||||
|
||||
**Contenu:**
|
||||
- Structure domain complète (interface + 6 use cases)
|
||||
- Implémentations concrètes (proxy Keycloak, soft delete, fallback local)
|
||||
- Changement mot de passe, préférences, suppression compte
|
||||
- Aucun TODO - Toutes fonctionnalités implémentées
|
||||
|
||||
**Statut:** ✅ Complété - 100% conforme Clean Architecture (**Phase P1 100% COMPLÉTÉE**)
|
||||
|
||||
### [ORGANIZATIONS_CLEAN_ARCHITECTURE.md](./ORGANIZATIONS_CLEAN_ARCHITECTURE.md)
|
||||
|
||||
**Description:** Refactoring Clean Architecture de la feature Organizations
|
||||
|
||||
**Contenu:**
|
||||
- Structure domain complète (interface + 7 use cases)
|
||||
- Refactoring du BLoC et Service (helpers uniquement)
|
||||
- 2 nouveaux endpoints backend (membres, configuration)
|
||||
- Résolution de conflits de noms avec alias d'import
|
||||
|
||||
**Statut:** ✅ Complété - 100% conforme Clean Architecture (**Phase P2: 1/3 complétée**)
|
||||
|
||||
### [REPORTS_CLEAN_ARCHITECTURE.md](./REPORTS_CLEAN_ARCHITECTURE.md)
|
||||
|
||||
**Description:** Refactoring Clean Architecture de la feature Reports
|
||||
|
||||
**Contenu:**
|
||||
- Structure domain complète (interface + 6 use cases)
|
||||
- Refactoring du BLoC pour utiliser les use cases
|
||||
- 4 nouveaux endpoints backend (available, export PDF/Excel, scheduled)
|
||||
- Méthodes concrètes pour analytics et reporting
|
||||
|
||||
**Statut:** ✅ Complété - 100% conforme Clean Architecture (**Phase P2: 2/3 complétée**)
|
||||
|
||||
### [SETTINGS_CLEAN_ARCHITECTURE.md](./SETTINGS_CLEAN_ARCHITECTURE.md)
|
||||
|
||||
**Description:** Refactoring Clean Architecture de la feature Settings
|
||||
|
||||
**Contenu:**
|
||||
- Structure domain complète (interface + 5 use cases)
|
||||
- Refactoring du BLoC pour utiliser les use cases
|
||||
- Implémentation resetConfig avec 3 niveaux de fallback
|
||||
- Gestion cache et configuration système
|
||||
|
||||
**Statut:** ✅ Complété - 100% conforme Clean Architecture (**🎉 Phase P2 100% COMPLÉTÉE**)
|
||||
|
||||
### [USE_CASES_MANQUANTS.md](./USE_CASES_MANQUANTS.md)
|
||||
|
||||
**Description:** Audit et plan d'implémentation des use cases manquants
|
||||
|
||||
**Contenu:**
|
||||
- État des 10 features (10/10 conformes Clean Architecture - 100%)
|
||||
- Spécification détaillée de 50 use cases à implémenter
|
||||
- Plan d'implémentation en 2 phases (P1/P2)
|
||||
- **🎉 Progression: 100% (50/50 use cases implémentés)**
|
||||
- **🎊 Phase P1 100% COMPLÉTÉE (32/32 use cases P1)**
|
||||
- **🎊 Phase P2 100% COMPLÉTÉE (18/18 use cases P2)**
|
||||
- **🏆 OBJECTIF FINAL ATTEINT - 64 use cases total**
|
||||
|
||||
### [AUDIT_INJECTION_DEPENDANCES.md](./AUDIT_INJECTION_DEPENDANCES.md)
|
||||
|
||||
**Description:** Audit complet de l'injection de dépendances (GetIt + Injectable)
|
||||
|
||||
**Contenu:**
|
||||
- 51 services enregistrés (27 @injectable + 24 @lazySingleton)
|
||||
- Pattern DRY centralisé (un seul fichier injection.dart)
|
||||
- Guide d'ajout de nouveaux services
|
||||
- Statut: ✅ Conforme
|
||||
|
||||
### [UNIONFLOW_DESIGN_V2.md](./UNIONFLOW_DESIGN_V2.md) *(si existe)*
|
||||
|
||||
**Description:** Architecture du design system et composants UI
|
||||
|
||||
**Contenu:**
|
||||
- Design tokens
|
||||
- Composants réutilisables
|
||||
- Thème et styles
|
||||
- Patterns UI
|
||||
|
||||
---
|
||||
|
||||
## 📖 Documentation Complémentaire
|
||||
|
||||
### Documentation Backend
|
||||
|
||||
La documentation backend se trouve dans `unionflow/` (racine):
|
||||
|
||||
- **FINANCE_WORKFLOW_BACKEND_COMPLETE.md** - Architecture backend Finance Workflow
|
||||
- **FINANCE_WORKFLOW_TEST_CHECKLIST.md** - Checklist tests P0 backend
|
||||
- **FINANCE_WORKFLOW_TEST_REPORT.md** - Rapport tests endpoints REST
|
||||
|
||||
### Scripts Utilitaires
|
||||
|
||||
Les scripts PowerShell se trouvent dans `../scripts/`:
|
||||
|
||||
- `start-integration-tests.ps1` - Vérifier prérequis
|
||||
- `check-keycloak-state.ps1` - État Keycloak
|
||||
- `list-user-roles.ps1` - Rôles utilisateurs
|
||||
|
||||
Voir [scripts/README.md](../scripts/README.md) pour plus de détails.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Démarrage Rapide
|
||||
|
||||
### Tests d'Intégration Mobile-Backend
|
||||
|
||||
```bash
|
||||
# 1. Backend
|
||||
cd ../../unionflow-server-impl-quarkus
|
||||
mvn compile quarkus:dev -D"quarkus.http.port=8085"
|
||||
|
||||
# 2. Vérifier services (autre terminal)
|
||||
cd ../unionflow-mobile-apps/scripts
|
||||
.\start-integration-tests.ps1
|
||||
|
||||
# 3. App mobile (autre terminal)
|
||||
cd ..
|
||||
flutter run --dart-define=ENV=dev
|
||||
|
||||
# 4. Suivre le guide
|
||||
# docs/TESTS_INTEGRATION_FINANCE_WORKFLOW.md
|
||||
```
|
||||
|
||||
### Développement Normal
|
||||
|
||||
```bash
|
||||
# Mode dev (backend local)
|
||||
flutter run --dart-define=ENV=dev
|
||||
|
||||
# Mode staging
|
||||
flutter run --dart-define=ENV=staging
|
||||
|
||||
# Mode production
|
||||
flutter run --dart-define=ENV=prod
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Liens Utiles
|
||||
|
||||
- **Keycloak Admin:** http://localhost:8180/admin/master/console (admin/admin)
|
||||
- **Backend API:** http://localhost:8085
|
||||
- **Backend Health:** http://localhost:8085/q/health
|
||||
- **Backend OpenAPI:** http://localhost:8085/q/openapi
|
||||
|
||||
---
|
||||
|
||||
## 📝 Convention de Nommage
|
||||
|
||||
### Documentation
|
||||
- `{FEATURE}_{DESCRIPTION}.md` - Ex: `TESTS_INTEGRATION_FINANCE_WORKFLOW.md`
|
||||
- Tout en MAJUSCULES avec underscores
|
||||
- Placée dans `docs/`
|
||||
|
||||
### Scripts
|
||||
- `{action}-{description}.ps1` - Ex: `start-integration-tests.ps1`
|
||||
- Tout en minuscules avec tirets
|
||||
- Placés dans `scripts/`
|
||||
|
||||
---
|
||||
|
||||
**Organisation maintenue selon le principe DRY (Don't Repeat Yourself)**
|
||||
|
||||
**Dernière mise à jour:** 2026-03-14
|
||||
Reference in New Issue
Block a user