fix(audit): PorteeAudit.GLOBAL → PLATEFORME + archiver docs obsolètes
- AuditService.logMembreDesactive : PorteeAudit.GLOBAL n'existe pas dans l'enum, remplacé par PLATEFORME (même sémantique — audit admin plateforme) - docs/archive/ : archivé AUDIT_MIGRATIONS_PRECISE, CONSOLIDATION_MIGRATIONS_FINALE, NETTOYAGE_MIGRATIONS_RAPPORT, TESTS_CONNUS_EN_ECHEC, JACOCO_TESTS_MANQUANTS - docs/FLYWAY_MIGRATIONS_GUIDE.md : consolidé depuis AUDIT_MIGRATIONS.md
This commit is contained in:
dahoud
280
docs/archive/CONSOLIDATION_MIGRATIONS_FINALE.md
Normal file
280
docs/archive/CONSOLIDATION_MIGRATIONS_FINALE.md
Normal file
@@ -0,0 +1,280 @@
|
||||
# Rapport de Consolidation Finale des Migrations Flyway
|
||||
|
||||
**Date**: 2026-03-16
|
||||
**Auteur**: Lions Dev
|
||||
**Projet**: UnionFlow - Backend Quarkus
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Objectif Atteint
|
||||
|
||||
Consolidation complète de **10 migrations** (V1-V10) en **UNE seule migration V1** avec tous les noms de tables corrects dès le départ.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Travaux Effectués
|
||||
|
||||
### 1. Consolidation des Migrations
|
||||
|
||||
**Avant**:
|
||||
- V1 à V10 (10 fichiers SQL)
|
||||
- V1 contenait des duplications (3× `organisations`, 2× `membres`)
|
||||
- Total: 3153 lignes dans V1 + 9 autres fichiers
|
||||
|
||||
**Après**:
|
||||
- **V1 unique**: `V1__UnionFlow_Complete_Schema.sql` (1322 lignes)
|
||||
- **69 tables** avec noms corrects correspondant aux entités JPA
|
||||
- **0 duplication**
|
||||
- **0 fichier de seed data** (selon demande utilisateur)
|
||||
|
||||
### 2. Nommage Correct des Tables
|
||||
|
||||
**Problème initial**: V1 créait des tables au **pluriel** alors que les entités JPA utilisent `@Table(name="...")` au **singulier**.
|
||||
|
||||
**Solution**: Nouvelle V1 crée directement les tables avec les bons noms:
|
||||
- ✅ `utilisateurs` (pas `membres`)
|
||||
- ✅ `configuration` (pas `configurations`)
|
||||
- ✅ `ticket` (pas `tickets`)
|
||||
- ✅ `suggestion` (pas `suggestions`)
|
||||
- ✅ `permission` (pas `permissions`)
|
||||
- ... et 64 autres tables
|
||||
|
||||
### 3. Tests Unitaires Corrigés
|
||||
|
||||
**Problème**: `GlobalExceptionMapperTest.java` avait 17 erreurs de compilation.
|
||||
|
||||
**Cause**: Les tests appelaient des méthodes inexistantes (`mapRuntimeException`, `mapBadRequestException`, `mapJsonException`).
|
||||
|
||||
**Solution**: Tous les tests corrigés pour utiliser `toResponse(Throwable)` - la vraie méthode publique.
|
||||
|
||||
**Résultat**: ✅ **BUILD SUCCESS** - 227 fichiers de test compilés sans erreur.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Résultats
|
||||
|
||||
### Flyway
|
||||
|
||||
```
|
||||
✅ Flyway clean: réussi
|
||||
✅ Migration V1: appliquée avec succès
|
||||
✅ Temps d'exécution: 1.13s
|
||||
✅ Nombre de tables créées: 70 (69 + flyway_schema_history)
|
||||
```
|
||||
|
||||
### Backend
|
||||
|
||||
```
|
||||
✅ Démarrage: réussi
|
||||
✅ Port: 8085
|
||||
✅ Swagger UI: accessible
|
||||
✅ Features: 22 extensions Quarkus chargées
|
||||
```
|
||||
|
||||
### Tests
|
||||
|
||||
```
|
||||
✅ Compilation tests: réussie
|
||||
✅ Erreurs: 0 (avant: 17)
|
||||
✅ Fichiers compilés: 227
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Problème Découvert - Hibernate Validation
|
||||
|
||||
**Erreur détectée**: Hibernate schema validation échoue pour **toutes les tables**.
|
||||
|
||||
**Symptôme**:
|
||||
```
|
||||
Schema-validation: missing column [cree_par] in table [adresses]
|
||||
Schema-validation: missing column [modifie_par] in table [adresses]
|
||||
Schema-validation: missing column [date_creation] in table [adresses]
|
||||
Schema-validation: missing column [date_modification] in table [adresses]
|
||||
Schema-validation: missing column [version] in table [adresses]
|
||||
Schema-validation: missing column [actif] in table [adresses]
|
||||
```
|
||||
|
||||
**Cause**: Les migrations SQL n'incluent PAS les colonnes `BaseEntity` dans les tables:
|
||||
- `cree_par VARCHAR(255)`
|
||||
- `modifie_par VARCHAR(255)`
|
||||
- `date_creation TIMESTAMP NOT NULL DEFAULT NOW()`
|
||||
- `date_modification TIMESTAMP`
|
||||
- `version INTEGER NOT NULL DEFAULT 0`
|
||||
- `actif BOOLEAN NOT NULL DEFAULT true`
|
||||
|
||||
**Impact**:
|
||||
- ❌ Backend démarre mais Hibernate validation échoue
|
||||
- ❌ Toutes les entités JPA qui étendent `BaseEntity` auront des erreurs d'insertion/update
|
||||
- ⚠️ Production-blocking si `hibernate-orm.database.generation=validate` (mode prod)
|
||||
|
||||
**Solution Requise**: Corriger V1 pour ajouter les 6 colonnes BaseEntity dans toutes les 69 tables.
|
||||
|
||||
---
|
||||
|
||||
## 📁 Fichiers Modifiés/Créés
|
||||
|
||||
### Créés
|
||||
- ✅ `V1__UnionFlow_Complete_Schema.sql` (1322 lignes, consolidé final)
|
||||
- ✅ `CONSOLIDATION_MIGRATIONS_FINALE.md` (ce rapport)
|
||||
- ✅ `backup-migrations-20260316/` (sauvegarde V1-V10 originaux)
|
||||
|
||||
### Modifiés
|
||||
- ✅ `GlobalExceptionMapperTest.java` (17 tests corrigés)
|
||||
|
||||
### Supprimés
|
||||
- ✅ `V2__Entity_Schema_Alignment.sql`
|
||||
- ✅ `V3__Seed_Comptes_Epargne_Test.sql`
|
||||
- ✅ `V4__Add_DEPOT_EPARGNE_To_Intention_Type_Check.sql`
|
||||
- ✅ `V5__Create_Membre_Suivi.sql`
|
||||
- ✅ `V6__Create_Finance_Workflow_Tables.sql`
|
||||
- ✅ `V7__Monitoring_System.sql`
|
||||
- ✅ `V8__Fix_Monitoring_Columns.sql`
|
||||
- ✅ `V9__Create_Alertes_LCB_FT.sql`
|
||||
- ✅ `V10__Fix_All_Table_Names.sql`
|
||||
|
||||
---
|
||||
|
||||
## 📋 Liste Complète des 69 Tables Créées
|
||||
|
||||
### Core (11 tables)
|
||||
- utilisateurs, organisations, roles, permission, membre_role, membre_organisation
|
||||
- adresses, ayants_droit, types_reference
|
||||
- modules_organisation_actifs, module_disponible
|
||||
|
||||
### Finance (5 tables)
|
||||
- cotisations, paiements, intention_paiement, paiements_objets
|
||||
- parametres_cotisation_organisation
|
||||
|
||||
### Mutuelle (5 tables)
|
||||
- comptes_epargne, transactions_epargne
|
||||
- demandes_credit, echeances_credit, garanties_demande
|
||||
|
||||
### Événements & Solidarité (3 tables)
|
||||
- evenements, inscriptions_evenement
|
||||
- demandes_aide
|
||||
|
||||
### Support (4 tables)
|
||||
- ticket, suggestion, suggestion_vote, favori
|
||||
|
||||
### Notifications (2 tables)
|
||||
- notifications, template_notification
|
||||
|
||||
### Documents (2 tables)
|
||||
- document, pieces_jointes
|
||||
|
||||
### Workflows Finance (5 tables)
|
||||
- transaction_approvals, approver_actions
|
||||
- budgets, budget_lines, workflow_validation_config
|
||||
|
||||
### Monitoring (4 tables)
|
||||
- system_logs, system_alerts, alert_configuration, audit_logs
|
||||
|
||||
### Spécialisés (11 tables)
|
||||
- tontines, tours_tontine
|
||||
- campagnes_vote, candidats
|
||||
- campagnes_collecte, contributions_collecte
|
||||
- campagnes_agricoles, projets_ong, dons_religieux
|
||||
- echelons_organigramme, agrements_professionnels
|
||||
|
||||
### LCB-FT (2 tables)
|
||||
- parametres_lcb_ft, alertes_lcb_ft
|
||||
|
||||
### Adhésion (3 tables)
|
||||
- demande_adhesion, formule_abonnement, souscription_organisation
|
||||
|
||||
### Autre (3 tables)
|
||||
- membre_suivi, validation_etape_demande
|
||||
- comptes_wave, transaction_wave, webhooks_wave
|
||||
|
||||
### Comptabilité (4 tables)
|
||||
- compte_comptable, journal_comptable, ecriture_comptable, ligne_ecriture
|
||||
|
||||
### Configuration (2 tables)
|
||||
- configuration, configuration_wave
|
||||
|
||||
**Total: 69 tables métier + 1 flyway_schema_history = 70 tables**
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Prochaines Étapes (URGENT)
|
||||
|
||||
### P0 - Production Blocker
|
||||
|
||||
1. **Corriger V1 pour ajouter les colonnes BaseEntity**
|
||||
```sql
|
||||
-- Dans chaque CREATE TABLE, ajouter:
|
||||
cree_par VARCHAR(255),
|
||||
modifie_par VARCHAR(255),
|
||||
date_creation TIMESTAMP NOT NULL DEFAULT NOW(),
|
||||
date_modification TIMESTAMP,
|
||||
version INTEGER NOT NULL DEFAULT 0,
|
||||
actif BOOLEAN NOT NULL DEFAULT true
|
||||
```
|
||||
|
||||
2. **Retester Flyway clean + migrate**
|
||||
```bash
|
||||
mvn clean compile quarkus:dev -D"quarkus.http.port=8085" -D"quarkus.flyway.clean-at-start=true"
|
||||
```
|
||||
|
||||
3. **Vérifier Hibernate validation réussit**
|
||||
- Vérifier les logs: aucune erreur "Schema-validation: missing column"
|
||||
- Vérifier: "Hibernate ORM ... successfully validated"
|
||||
|
||||
### P1 - Qualité
|
||||
|
||||
4. **Exécuter les tests**
|
||||
```bash
|
||||
mvn test
|
||||
```
|
||||
|
||||
5. **Mettre à jour MEMORY.md**
|
||||
- Section "Flyway Migrations — Consolidation Finale (2026-03-16)"
|
||||
- Documenter: V1 unique, 69 tables, colonnes BaseEntity ajoutées
|
||||
|
||||
---
|
||||
|
||||
## ✨ Résumé
|
||||
|
||||
| Métrique | Avant | Après |
|
||||
|----------|-------|-------|
|
||||
| Migrations | V1-V10 (10 fichiers) | V1 unique |
|
||||
| Lignes V1 | 3153 | 1322 |
|
||||
| Duplications | 5 CREATE TABLE | 0 |
|
||||
| Tables mal nommées | 24 | 0 |
|
||||
| Seed data | Oui (V3) | Non (supprimé) |
|
||||
| Tests en erreur | 17 | 0 |
|
||||
| Backend démarre? | ❌ Non (V9 échouait) | ✅ Oui |
|
||||
| Hibernate validation? | N/A | ❌ Échoue (colonnes manquantes) |
|
||||
|
||||
---
|
||||
|
||||
## 📝 Notes Techniques
|
||||
|
||||
### Credentials PostgreSQL
|
||||
- **Host**: localhost:5432
|
||||
- **Database**: unionflow
|
||||
- **Username**: skyfile
|
||||
- **Password**: skyfile
|
||||
|
||||
### Commandes Utiles
|
||||
|
||||
```bash
|
||||
# Démarrer backend avec Flyway clean
|
||||
mvn compile quarkus:dev -D"quarkus.http.port=8085" -D"quarkus.flyway.clean-at-start=true"
|
||||
|
||||
# Compiler tests uniquement
|
||||
mvn test-compile
|
||||
|
||||
# Exécuter tests
|
||||
mvn test
|
||||
|
||||
# Vérifier logs Flyway
|
||||
grep -i "flyway\|migration" logs/output.txt
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Créé par**: Lions Dev
|
||||
**Date**: 2026-03-16
|
||||
**Durée totale**: ~3h (analyse + consolidation + correction tests)
|
||||
Reference in New Issue
Block a user