feat: accumulated work — PI-SPI, KYC, RLS, mutuelle parts, comptabilité PDF + startup fixes

## PI-SPI BCEAO (P0.3 — deadline 30/06/2026) - package payment/pispi/ complet : PispiAuth (OAuth2), PispiClient (HTTP brut), PispiIso20022Mapper (pacs.008/002), PispiSignatureVerifier (HMAC-SHA256), PispiWebhookResource (/api/pispi/webhook), DTOs ISO 20022 - PaymentOrchestrator + PaymentProviderRegistry pour l'orchestration multi-provider - Mode mock automatique si credentials absents (dev) ## KYC AML - entity/KycDossier, KycResource, KycAmlService + tests - Migration V38 (create_kyc_dossier_table) ## RLS (PostgreSQL Row-Level Security) — isolation multi-tenant - RlsConnectionInitializer, RlsContextInterceptor, @RlsEnabled annotation - Migration V39 (PostgreSQL RLS Tenant Isolation) + V42 (app DB roles) - Tests unitaires RlsConnectionInitializerTest, RlsContextInterceptorTest - Tests d'intégration RlsCrossTenantIsolationTest (@QuarkusTest + IntegrationTestProfile) ## Mutuelle — Parts sociales - entity/mutuelle/parts/ComptePartsSociales, TransactionPartsSociales - Service, resource, mapper, repository + tests - InteretsEpargneService + ReleveComptePdfService ## Comptabilité PDF - ComptabilitePdfService (OpenPDF), ComptabilitePdfResource - Tests ComptabilitePdfServiceTest, ComptabilitePdfResourceTest ## Migrations Flyway (SYSCOHADA + Keycloak Orgs) - V36 SYSCOHADA Plan Comptable Complet : seeds comptes standards UEMOA, trigger init_plan_comptable_organisation, alignement schéma V1 → entités - V37 keycloak_org_id sur organisations (P0.2 migration KC 26) - V40 provider_defaut sur FormuleAbonnement - V41 fcm_token sur utilisateurs (FCM notifications push) ## Fixes startup (SmallRye Config 3.20 + schéma) - 8× @ConfigProperty(defaultValue = "") → Optional<String> (firebase, pispi.*, mtnmomo, orange) — empty default rejetés par SmallRye 3.20 - application.properties : mappings secrets env var sous %prod. uniquement - V36 : drop colonne obsolète 'numero' de V1 quand Hibernate a créé 'numero_compte' - V36 : remplacement UNIQUE global sur journaux_comptables.code par composite (organisation_id, code) pour autoriser plusieurs orgs avec code 'ACH'/'VTE'/etc - V39 : escape placeholder ${VAR} → <VAR> dans lignes commentées (Flyway parser évalue les placeholders même dans les commentaires) - V41 : table 'membres' → 'utilisateurs' (nom correct selon entité Membre) - JournalComptable entity : @UniqueConstraint composite au lieu de unique=true - MembreResource : example @Schema JSON valide (['...'] → []) - IntegrationTestProfile : auto-détection Docker via `docker info`, fallback vers PostgreSQL local sans DevServices ## Dev config - application-dev.properties : quarkus.devservices.enabled=false + quarkus.kafka.devservices.enabled=false (pas besoin de Docker pour dev) - quarkus.flyway.placeholder-replacement=false - Secrets dev (wave.*, firebase, pispi) en mode mock automatique ## Phase 8 tests (complète) - 170 fichiers modifiés/ajoutés, 23425+ insertions - Tests RBAC (@QuarkusTest) pour MembreResource lifecycle - Tests OrganisationContextFilter multi-org - Tests SouscriptionQuotaOptionC, KycAmlService, EmailTemplate, etc. Résultat : Backend démarre en 64s sur port 8085 avec 36 features installées. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-21 12:40:55 +00:00
parent 9a53ce4077
commit 31330d95e9
170 changed files with 23425 additions and 873 deletions
--- a/CONSOLIDATION_MIGRATIONS_FINALE.md
+++ b/CONSOLIDATION_MIGRATIONS_FINALE.md
@@ -1,280 +0,0 @@
-# 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)