fix(sprint-17): security hardening + migration SQL fixes

Security:
- DashboardWebSocketEndpoint: add @Authenticated (was publicly accessible)
- MembreResource: add @RolesAllowed on 4 endpoints (rechercher, lister, stats, export)
- Membre: CascadeType.ALL → PERSIST+MERGE (prevent cascade delete historique)
- Membre: getNomComplet() null-safe

Bug fixes:
- DeviseConversionService: BUG-01 division-by-zero → TauxIntrouvableException
- AlerteLcbFtService/Resource: RBAC fixes
- OrganisationResource: minor fix

Migrations:
- V39: fix column name utilisateur_id → membre_id in RLS policy (kyc_dossier)
- V46: CREATE TABLE types_aide (was ALTER on non-existent table → was failing)
- V49: multi-devise schema corrections

.gitea/workflows/ci.yml

@@ -0,0 +1,76 @@
+# ============================================================================
+# Template — .gitea/workflows/ci.yml
+# Drop this file into each app repo (adjust LIONS_JAVA_VERSION +
+# LIONS_APP_NAME + optional --deploy-repo-url). It runs inside the
+# registry.lions.dev/lionsdev/lionsctl-ci:latest image, so lionsctl,
+# kubectl, helm, docker CLI, JDK 17+21 and Maven are all pre-installed.
+#
+# Required Gitea repo secrets:
+#   LIONS_REGISTRY_USERNAME   (typically "lionsregistry")
+#   LIONS_REGISTRY_PASSWORD
+#   LIONS_GIT_USERNAME        (typically "lionsdev")
+#   LIONS_GIT_ACCESS_TOKEN    (Gitea PAT with write:repository, write:package)
+#   LIONS_GIT_PASSWORD        (Gitea password for same user — Helm mode)
+#   SMTP_HOST SMTP_PORT SMTP_USERNAME SMTP_PASSWORD SMTP_FROM
+# ============================================================================
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch: {}
+
+env:
+  # Adjust per repo:
+  #   - unionflow-server-impl-quarkus      -> 21
+  #   - all others                         -> 17
+  LIONS_JAVA_VERSION: "21"
+  LIONS_CLUSTER: "k1"
+
+jobs:
+  pipeline:
+    runs-on: ubuntu-latest
+    container:
+      image: registry.lions.dev/lionsdev/lionsctl-ci:latest
+      credentials:
+        username: ${{ secrets.LIONS_REGISTRY_USERNAME }}
+        password: ${{ secrets.LIONS_REGISTRY_PASSWORD }}
+      # Mount the host docker socket so `docker build/push` inside the
+      # container hits the runner's daemon (DinD-free).
+      volumes:
+        - /var/run/docker.sock:/var/run/docker.sock
+
+    steps:
+      - name: Show tooling
+        run: |
+          lionsctl --version || true
+          docker --version
+          kubectl version --client=true
+          helm version --short
+          mvn --version | head -n2
+
+      - name: Pipeline deploy
+        env:
+          LIONS_REGISTRY_USERNAME: ${{ secrets.LIONS_REGISTRY_USERNAME }}
+          LIONS_REGISTRY_PASSWORD: ${{ secrets.LIONS_REGISTRY_PASSWORD }}
+          LIONS_GIT_USERNAME:      ${{ secrets.LIONS_GIT_USERNAME }}
+          LIONS_GIT_ACCESS_TOKEN:  ${{ secrets.LIONS_GIT_ACCESS_TOKEN }}
+          LIONS_GIT_PASSWORD:      ${{ secrets.LIONS_GIT_PASSWORD }}
+          SMTP_HOST:               ${{ secrets.SMTP_HOST }}
+          SMTP_PORT:               ${{ secrets.SMTP_PORT }}
+          SMTP_USERNAME:           ${{ secrets.SMTP_USERNAME }}
+          SMTP_PASSWORD:           ${{ secrets.SMTP_PASSWORD }}
+          SMTP_FROM:               ${{ secrets.SMTP_FROM }}
+        # No actions/checkout — lionsctl clones internally using git_access_token.
+        run: |
+          # For btpxpress-backend add:  --deploy-repo-url https://git.lions.dev/lionsdev/btpxpress-server-k1
+          # For btpxpress-frontend add: --deploy-repo-url https://git.lions.dev/lionsdev/btpxpress-client-k1
+          lionsctl pipeline \
+            -u ${{ gitea.server_url }}/${{ gitea.repository }} \
+            -b ${{ gitea.ref_name }} \
+            -j ${{ env.LIONS_JAVA_VERSION }} \
+            -e production \
+            -c ${{ env.LIONS_CLUSTER }} \
+            -p prod \
+            --deploy-repo-url https://git.lions.dev/lionsdev/unionflow-server-impl-quarkus-k1 \
+            -m admin@lions.dev

Dockerfile

@@ -0,0 +1,22 @@
+# Dockerfile for unionflow-server-impl-quarkus
+# Used by lionsctl pipeline. Expects `mvn clean package -Pprod` to have produced target/quarkus-app/ (fast-jar).
+FROM registry.access.redhat.com/ubi8/openjdk-21:1.21
+
+ENV LANGUAGE='en_US:en'
+
+COPY --chown=1001:1001 target/quarkus-app/lib/      /deployments/lib/
+COPY --chown=1001:1001 target/quarkus-app/*.jar     /deployments/
+COPY --chown=1001:1001 target/quarkus-app/app/      /deployments/app/
+COPY --chown=1001:1001 target/quarkus-app/quarkus/  /deployments/quarkus/
+
+USER 1001
+
+EXPOSE 8080
+
+ENV JAVA_OPTS="-Dquarkus.http.host=0.0.0.0 -Djava.util.logging.manager=org.jboss.logmanager.LogManager"
+ENV JAVA_APP_JAR="/deployments/quarkus-run.jar"
+
+HEALTHCHECK --interval=30s --timeout=3s --start-period=30s --retries=3 \
+  CMD curl -f http://localhost:8080/q/health/live || exit 1
+
+ENTRYPOINT [ "java", "-jar", "/deployments/quarkus-run.jar" ]

README.md

@@ -1,7 +1,7 @@
 # UnionFlow Backend - API REST Quarkus
 
 ![Java](https://img.shields.io/badge/Java-17-blue)
-![Quarkus](https://img.shields.io/badge/Quarkus-3.15.1-red)
+![Quarkus](https://img.shields.io/badge/Quarkus-3.27.3_LTS-red)
 ![PostgreSQL](https://img.shields.io/badge/PostgreSQL-15-blue)
 ![Kafka](https://img.shields.io/badge/Kafka-Enabled-orange)
 ![License](https://img.shields.io/badge/License-Proprietary-red)
@@ -64,7 +64,7 @@ Tous les repositories étendent `PanacheRepositoryBase<Entity, UUID>` pour :
 | Composant | Version | Usage |
 |-----------|---------|-------|
 | **Java** | 17 (LTS) | Langage |
-| **Quarkus** | 3.15.1 | Framework application |
+| **Quarkus** | 3.27.3 LTS | Framework application |
 | **Hibernate ORM (Panache)** | 6.4+ | Persistence |
 | **PostgreSQL** | 15 | Base de données |
 | **Flyway** | 9.22+ | Migrations DB |
@@ -482,7 +482,7 @@ src/test/java/
 lionsctl pipeline \
   -u https://git.lions.dev/lionsdev/unionflow-server-impl-quarkus \
   -b main \
-  -j 17 \
+  -j 21 \
   -e production \
   -c k1 \
   -p prod
@@ -490,12 +490,19 @@ lionsctl pipeline \
 # Étapes :
 # 1. Clone repo Git
 # 2. mvn clean package -Pprod
-# 3. docker build + push registry.lions.dev
-# 4. kubectl apply -f k8s/
-# 5. Health check
-# 6. Email notification
+# 3. docker build -f Dockerfile (racine, fast-jar, ubi8/openjdk-21:1.21, UID 1001)
+# 4. push registry.lions.dev
+# 5. kubectl apply (Deployment + Service + Ingress)
+# 6. Health check
+# 7. Email notification
 ```
 
+**Pré-requis infrastructure** avant pipeline (migration Helm → lionsctl pipeline) :
+- Secret K8s `unionflow-server-impl-quarkus-db-secret` (clés `QUARKUS_DATASOURCE_USERNAME` + `QUARKUS_DATASOURCE_PASSWORD`)
+- DB PostgreSQL `unionflow` (override `QUARKUS_DATASOURCE_JDBC_URL` sur le deployment car lionsctl nomme la DB comme l'app)
+- Deployment Helm existant supprimé au préalable (selector immutable)
+- Service selector à repatcher après pipeline (retirer les labels `app.kubernetes.io/*`)
+
 ### Fichiers Kubernetes
 
 **Localisation** : `src/main/kubernetes/`

docker-compose.kc26.yml

@@ -0,0 +1,73 @@
+version: '3.8'
+
+# Compose alternatif Keycloak 26.6.1 avec feature Organizations native (GA depuis 26.0).
+# Usage : docker compose -f docker-compose.kc26.yml up -d
+# But : valider la migration KC23 → KC26 + Organizations en local, sans toucher au compose dev.
+#
+# Une fois la migration validée, basculer ce contenu en production et supprimer la stack KC23.
+#
+# Réf : ARCH_KEYCLOAK_26.md
+
+services:
+  postgres-keycloak:
+    image: postgres:15-alpine
+    container_name: kc26-postgres
+    environment:
+      POSTGRES_DB: keycloak
+      POSTGRES_USER: keycloak
+      POSTGRES_PASSWORD: keycloak
+      POSTGRES_INITDB_ARGS: "--encoding=UTF-8 --lc-collate=C --lc-ctype=C"
+    volumes:
+      - kc26_postgres_data:/var/lib/postgresql/data
+    networks:
+      - kc26-net
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U keycloak -d keycloak"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    restart: unless-stopped
+
+  keycloak:
+    image: quay.io/keycloak/keycloak:26.6.1
+    container_name: kc26-server
+    command:
+      - start-dev
+      - --features=organization
+      - --http-port=8180
+      - --import-realm
+    environment:
+      KC_BOOTSTRAP_ADMIN_USERNAME: admin
+      KC_BOOTSTRAP_ADMIN_PASSWORD: admin
+      KC_DB: postgres
+      KC_DB_URL: jdbc:postgresql://postgres-keycloak:5432/keycloak
+      KC_DB_USERNAME: keycloak
+      KC_DB_PASSWORD: keycloak
+      KC_HEALTH_ENABLED: "true"
+      KC_METRICS_ENABLED: "true"
+      KC_HOSTNAME_STRICT: "false"
+      KC_HTTP_ENABLED: "true"
+    ports:
+      - "8180:8180"
+    volumes:
+      - ./src/main/resources/keycloak/realms:/opt/keycloak/data/import:ro
+    depends_on:
+      postgres-keycloak:
+        condition: service_healthy
+    networks:
+      - kc26-net
+    healthcheck:
+      test: ["CMD-SHELL", "exec 3<>/dev/tcp/127.0.0.1/8180 && echo -e 'GET /health/ready HTTP/1.1\\r\\nHost: localhost\\r\\nConnection: close\\r\\n\\r\\n' >&3 && cat <&3 | grep -q 'UP'"]
+      interval: 15s
+      timeout: 5s
+      retries: 8
+      start_period: 60s
+    restart: unless-stopped
+
+volumes:
+  kc26_postgres_data:
+    driver: local
+
+networks:
+  kc26-net:
+    driver: bridge

pom.xml

@@ -4,30 +4,30 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <parent>
-        <groupId>dev.lions.unionflow</groupId>
-        <artifactId>unionflow-parent</artifactId>
-        <version>1.0.5</version>
-        <relativePath>../unionflow-server-api/parent-pom.xml</relativePath>
-    </parent>
-
+    <groupId>dev.lions.unionflow</groupId>
     <artifactId>unionflow-server-impl-quarkus</artifactId>
+    <version>1.0.7</version>
     <packaging>jar</packaging>
 
     <name>UnionFlow Server Implementation (Quarkus)</name>
     <description>Implémentation Quarkus du serveur UnionFlow</description>
 
     <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <maven.compiler.release>21</maven.compiler.release>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        
-        <quarkus.platform.version>3.15.1</quarkus.platform.version>
+
+        <quarkus.platform.version>3.27.3</quarkus.platform.version>
         <quarkus.platform.group-id>io.quarkus.platform</quarkus.platform.group-id>
         <quarkus.platform.artifact-id>quarkus-bom</quarkus.platform.artifact-id>
+        <lombok.version>1.18.38</lombok.version>
+        <!-- Overrides BOM : Docker Desktop 29.x compat -->
+        <testcontainers.version>1.21.4</testcontainers.version>
+        <docker-java.version>3.4.2</docker-java.version>
 
         <!-- Jacoco -->
-        <jacoco.version>0.8.11</jacoco.version>
+        <jacoco.version>0.8.12</jacoco.version>
     </properties>
 
     <dependencyManagement>
@@ -39,6 +39,20 @@
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
+            <dependency>
+                <groupId>org.testcontainers</groupId>
+                <artifactId>testcontainers-bom</artifactId>
+                <version>${testcontainers.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+            <!-- Lombok : pas dans Quarkus BOM -->
+            <dependency>
+                <groupId>org.projectlombok</groupId>
+                <artifactId>lombok</artifactId>
+                <version>${lombok.version}</version>
+                <scope>provided</scope>
+            </dependency>
         </dependencies>
     </dependencyManagement>
 
@@ -47,14 +61,14 @@
         <dependency>
             <groupId>dev.lions.unionflow</groupId>
             <artifactId>unionflow-server-api</artifactId>
-            <version>1.0.5</version>
+            <version>1.0.10</version>
         </dependency>
 
         <!-- Lions User Manager API (pour DTOs et client Keycloak) -->
         <dependency>
             <groupId>dev.lions.user.manager</groupId>
             <artifactId>lions-user-manager-server-api</artifactId>
-            <version>1.0.0</version>
+            <version>1.1.0</version>
         </dependency>
 
         <!-- Quarkus Core -->
@@ -122,11 +136,6 @@
             <groupId>io.quarkus</groupId>
             <artifactId>quarkus-messaging-kafka</artifactId>
         </dependency>
-        <dependency>
-            <groupId>io.quarkus</groupId>
-            <artifactId>quarkus-smallrye-reactive-messaging-kafka</artifactId>
-        </dependency>
-
         <dependency>
             <groupId>io.quarkus</groupId>
             <artifactId>quarkus-mailer</artifactId>
@@ -141,6 +150,10 @@
             <groupId>io.quarkus</groupId>
             <artifactId>quarkus-smallrye-health</artifactId>
         </dependency>
+        <dependency>
+            <groupId>io.quarkus</groupId>
+            <artifactId>quarkus-micrometer-registry-prometheus</artifactId>
+        </dependency>
         <dependency>
             <groupId>io.quarkus</groupId>
             <artifactId>quarkus-cache</artifactId>
@@ -215,6 +228,20 @@
             <version>1.3.30</version>
         </dependency>
 
+        <!-- Firebase Admin SDK — notifications push FCM (P2.2) -->
+        <dependency>
+            <groupId>com.google.firebase</groupId>
+            <artifactId>firebase-admin</artifactId>
+            <version>9.3.0</version>
+            <exclusions>
+                <!-- Éviter les conflits avec Netty/Vert.x de Quarkus -->
+                <exclusion>
+                    <groupId>io.netty</groupId>
+                    <artifactId>*</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
         <!-- Tests -->
         <dependency>
             <groupId>io.quarkus</groupId>
@@ -269,6 +296,7 @@
             <artifactId>smallrye-reactive-messaging-in-memory</artifactId>
             <scope>test</scope>
         </dependency>
+
     </dependencies>
 
     <repositories>
@@ -306,7 +334,10 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.13.0</version>
                 <configuration>
+                    <!-- Quarkus Qute @CheckedTemplate exige les noms de paramètres en bytecode -->
+                    <parameters>true</parameters>
                     <annotationProcessorPaths>
                         <path>
                             <groupId>org.mapstruct</groupId>

src/main/java/de/lions/unionflow/server/auth/AuthCallbackResource.java

@@ -1,138 +1,138 @@
-package de.lions.unionflow.server.auth;
-
-import jakarta.annotation.security.PermitAll;
-import jakarta.ws.rs.GET;
-import jakarta.ws.rs.Path;
-import jakarta.ws.rs.QueryParam;
-import jakarta.ws.rs.core.Response;
-import org.jboss.logging.Logger;
-
-/**
- * Resource temporaire pour gérer les callbacks d'authentification OAuth2/OIDC depuis l'application
- * mobile.
- */
-@Path("/auth")
-@PermitAll
-public class AuthCallbackResource {
-
-  private static final Logger log = Logger.getLogger(AuthCallbackResource.class);
-
-  /**
-   * Endpoint de callback pour l'authentification OAuth2/OIDC. Redirige vers l'application mobile
-   * avec les paramètres reçus.
-   */
-  @GET
-  @Path("/callback")
-  public Response handleCallback(
-      @QueryParam("code") String code,
-      @QueryParam("state") String state,
-      @QueryParam("session_state") String sessionState,
-      @QueryParam("error") String error,
-      @QueryParam("error_description") String errorDescription) {
-
-    try {
-      // Log des paramètres reçus pour debug
-      log.infof("=== CALLBACK DEBUG === Code: %s, State: %s, Session State: %s, Error: %s, Error Description: %s",
-          code, state, sessionState, error, errorDescription);
-
-      // URL de redirection simple vers l'application mobile
-      String redirectUrl = "dev.lions.unionflow-mobile://callback";
-
-      // Si nous avons un code d'autorisation, c'est un succès
-      if (code != null && !code.isEmpty()) {
-        redirectUrl += "?code=" + code;
-        if (state != null && !state.isEmpty()) {
-          redirectUrl += "&state=" + state;
-        }
-      } else if (error != null) {
-        redirectUrl += "?error=" + error;
-        if (errorDescription != null) {
-          redirectUrl += "&error_description=" + errorDescription;
-        }
-      }
-
-      // Page HTML simple qui redirige automatiquement vers l'app mobile
-      String html =
-          """
-<!DOCTYPE html>
-<html>
-<head>
-    <title>Redirection vers UnionFlow</title>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <style>
-        body {
-            font-family: Arial, sans-serif;
-            text-align: center;
-            padding: 50px;
-            background: linear-gradient(135deg, #667eea 0%%, #764ba2 100%%);
-            color: white;
-        }
-        .container {
-            max-width: 400px;
-            margin: 0 auto;
-            background: rgba(255,255,255,0.1);
-            padding: 30px;
-            border-radius: 10px;
-        }
-        .spinner {
-            border: 4px solid rgba(255,255,255,0.3);
-            border-top: 4px solid white;
-            border-radius: 50%%;
-            width: 40px;
-            height: 40px;
-            animation: spin 1s linear infinite;
-            margin: 20px auto;
-        }
-        @keyframes spin { 0%% { transform: rotate(0deg); } 100%% { transform: rotate(360deg); } }
-        a { color: #ffeb3b; text-decoration: none; }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <h2>🔐 Authentification réussie</h2>
-        <div class="spinner"></div>
-        <p>Redirection vers l'application UnionFlow...</p>
-        <p><small>Si la redirection ne fonctionne pas automatiquement,
-        <a href="%s">cliquez ici</a></small></p>
-    </div>
-    <script>
-        // Tentative de redirection automatique
-        setTimeout(function() {
-            window.location.href = '%s';
-        }, 2000);
-
-        // Fallback: ouvrir l'app mobile si possible
-        setTimeout(function() {
-            try {
-                window.open('%s', '_self');
-            } catch(e) {
-                console.log('Redirection manuelle nécessaire');
-            }
-        }, 3000);
-    </script>
-</body>
-</html>
-"""
-              .formatted(redirectUrl, redirectUrl, redirectUrl);
-
-      return Response.ok(html).type("text/html").build();
-
-    } catch (Exception e) {
-      // En cas d'erreur, retourner une page d'erreur simple
-      String errorHtml =
-          """
-          <!DOCTYPE html>
-          <html>
-          <head><title>Erreur d'authentification</title></head>
-          <body style="font-family: Arial; text-align: center; padding: 50px;">
-              <h2>❌ Erreur d'authentification</h2>
-              <p>Une erreur s'est produite lors de la redirection.</p>
-              <p>Veuillez fermer cette page et réessayer.</p>
-          </body>
-          </html>
-          """;
-      return Response.status(500).entity(errorHtml).type("text/html").build();
-    }
-  }
-}
+package de.lions.unionflow.server.auth;
+
+import jakarta.annotation.security.PermitAll;
+import jakarta.ws.rs.GET;
+import jakarta.ws.rs.Path;
+import jakarta.ws.rs.QueryParam;
+import jakarta.ws.rs.core.Response;
+import org.jboss.logging.Logger;
+
+/**
+ * Resource temporaire pour gérer les callbacks d'authentification OAuth2/OIDC depuis l'application
+ * mobile.
+ */
+@Path("/auth")
+@PermitAll
+public class AuthCallbackResource {
+
+  private static final Logger log = Logger.getLogger(AuthCallbackResource.class);
+
+  /**
+   * Endpoint de callback pour l'authentification OAuth2/OIDC. Redirige vers l'application mobile
+   * avec les paramètres reçus.
+   */
+  @GET
+  @Path("/callback")
+  public Response handleCallback(
+      @QueryParam("code") String code,
+      @QueryParam("state") String state,
+      @QueryParam("session_state") String sessionState,
+      @QueryParam("error") String error,
+      @QueryParam("error_description") String errorDescription) {
+
+    try {
+      // Log des paramètres reçus pour debug
+      log.infof("=== CALLBACK DEBUG === Code: %s, State: %s, Session State: %s, Error: %s, Error Description: %s",
+          code, state, sessionState, error, errorDescription);
+
+      // URL de redirection simple vers l'application mobile
+      String redirectUrl = "dev.lions.unionflow-mobile://callback";
+
+      // Si nous avons un code d'autorisation, c'est un succès
+      if (code != null && !code.isEmpty()) {
+        redirectUrl += "?code=" + code;
+        if (state != null && !state.isEmpty()) {
+          redirectUrl += "&state=" + state;
+        }
+      } else if (error != null) {
+        redirectUrl += "?error=" + error;
+        if (errorDescription != null) {
+          redirectUrl += "&error_description=" + errorDescription;
+        }
+      }
+
+      // Page HTML simple qui redirige automatiquement vers l'app mobile
+      String html =
+          """
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Redirection vers UnionFlow</title>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            text-align: center;
+            padding: 50px;
+            background: linear-gradient(135deg, #667eea 0%%, #764ba2 100%%);
+            color: white;
+        }
+        .container {
+            max-width: 400px;
+            margin: 0 auto;
+            background: rgba(255,255,255,0.1);
+            padding: 30px;
+            border-radius: 10px;
+        }
+        .spinner {
+            border: 4px solid rgba(255,255,255,0.3);
+            border-top: 4px solid white;
+            border-radius: 50%%;
+            width: 40px;
+            height: 40px;
+            animation: spin 1s linear infinite;
+            margin: 20px auto;
+        }
+        @keyframes spin { 0%% { transform: rotate(0deg); } 100%% { transform: rotate(360deg); } }
+        a { color: #ffeb3b; text-decoration: none; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h2>🔐 Authentification réussie</h2>
+        <div class="spinner"></div>
+        <p>Redirection vers l'application UnionFlow...</p>
+        <p><small>Si la redirection ne fonctionne pas automatiquement,
+        <a href="%s">cliquez ici</a></small></p>
+    </div>
+    <script>
+        // Tentative de redirection automatique
+        setTimeout(function() {
+            window.location.href = '%s';
+        }, 2000);
+
+        // Fallback: ouvrir l'app mobile si possible
+        setTimeout(function() {
+            try {
+                window.open('%s', '_self');
+            } catch(e) {
+                console.log('Redirection manuelle nécessaire');
+            }
+        }, 3000);
+    </script>
+</body>
+</html>
+"""
+              .formatted(redirectUrl, redirectUrl, redirectUrl);
+
+      return Response.ok(html).type("text/html").build();
+
+    } catch (Exception e) {
+      // En cas d'erreur, retourner une page d'erreur simple
+      String errorHtml =
+          """
+          <!DOCTYPE html>
+          <html>
+          <head><title>Erreur d'authentification</title></head>
+          <body style="font-family: Arial; text-align: center; padding: 50px;">
+              <h2>❌ Erreur d'authentification</h2>
+              <p>Une erreur s'est produite lors de la redirection.</p>
+              <p>Veuillez fermer cette page et réessayer.</p>
+          </body>
+          </html>
+          """;
+      return Response.status(500).entity(errorHtml).type("text/html").build();
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/UnionFlowServerApplication.java

@@ -1,250 +1,250 @@
-package dev.lions.unionflow.server;
-
-import io.quarkus.runtime.Quarkus;
-import io.quarkus.runtime.QuarkusApplication;
-import io.quarkus.runtime.annotations.QuarkusMain;
-import jakarta.enterprise.context.ApplicationScoped;
-import org.eclipse.microprofile.config.inject.ConfigProperty;
-import org.jboss.logging.Logger;
-
-/**
- * Point d'entrée principal du serveur UnionFlow.
- *
- * <p><b>UnionFlow</b> est une plateforme de gestion associative multi-tenant
- * destinée aux organisations de solidarité (associations, mutuelles, coopératives,
- * tontines, ONG) en Afrique de l'Ouest.
- *
- * <h2>Architecture</h2>
- * <ul>
- * <li><b>Backend</b> : Quarkus 3.15.1, Java 17, Hibernate Panache</li>
- * <li><b>Base de données</b> : PostgreSQL 15 avec Flyway</li>
- * <li><b>Authentification</b> : Keycloak 23 (OIDC/OAuth2)</li>
- * <li><b>API</b> : REST (JAX-RS) + WebSocket (temps réel)</li>
- * <li><b>Paiements</b> : Wave Money CI (Mobile Money)</li>
- * </ul>
- *
- * <h2>Modules fonctionnels</h2>
- * <ul>
- * <li><b>Organisations</b> — Hiérarchie multi-niveau, types paramétrables,
- * modules activables par organisation</li>
- * <li><b>Membres</b> — Adhésion, profils, rôles/permissions RBAC,
- * synchronisation bidirectionnelle avec Keycloak</li>
- * <li><b>Cotisations &amp; Paiements</b> — Campagnes récurrentes,
- * ventilation polymorphique, intégration Wave Money</li>
- * <li><b>Événements</b> — Création, inscriptions, gestion des présences,
- * géolocalisation</li>
- * <li><b>Solidarité</b> — Demandes d'aide, propositions, matching intelligent,
- * workflow de validation multi-étapes</li>
- * <li><b>Mutuelles</b> — Épargne, crédit, tontines, suivi des tours</li>
- * <li><b>Comptabilité</b> — Plan comptable SYSCOHADA, journaux,
- * écritures automatiques, balance, grand livre</li>
- * <li><b>Documents</b> — Gestion polymorphique de pièces jointes
- * (stockage local + métadonnées)</li>
- * <li><b>Notifications</b> — Templates multicanaux (email, SMS, push),
- * préférences utilisateur, historique persistant</li>
- * <li><b>Analytics &amp; Dashboard</b> — KPIs temps réel via WebSocket,
- * métriques d'activité, tendances, rapports PDF</li>
- * <li><b>Administration</b> — Audit trail complet, tickets support,
- * suggestions utilisateurs, favoris</li>
- * <li><b>SaaS Multi-tenant</b> — Formules d'abonnement flexibles,
- * souscriptions par organisation, facturation</li>
- * <li><b>Configuration dynamique</b> — Table {@code configurations},
- * pas de hardcoding, paramétrage par organisation</li>
- * <li><b>Données de référence</b> — Table {@code types_reference}
- * entièrement CRUD-able (évite les enums Java)</li>
- * </ul>
- *
- * <h2>Inventaire technique</h2>
- * <ul>
- * <li><b>60 entités JPA</b> — {@code BaseEntity} + {@code AuditEntityListener}
- * pour audit automatique</li>
- * <li><b>46 services CDI</b> — Logique métier transactionnelle</li>
- * <li><b>37 endpoints REST</b> — API JAX-RS avec validation Bean Validation</li>
- * <li><b>49 repositories</b> — Hibernate Panache pour accès données</li>
- * <li><b>Migrations Flyway</b> — V1.0 --> V3.0 (schéma complet 60 tables)</li>
- * <li><b>Tests</b> — 1127 tests unitaires et d'intégration Quarkus</li>
- * <li><b>Couverture</b> — JaCoCo 40% minimum (cible 60%)</li>
- * </ul>
- *
- * <h2>Patterns et Best Practices</h2>
- * <ul>
- * <li><b>Clean Architecture</b> — Séparation API/Impl/Entity</li>
- * <li><b>DTO Pattern</b> — Request/Response distincts (142 DTOs dans server-api)</li>
- * <li><b>Repository Pattern</b> — Abstraction accès données</li>
- * <li><b>Service Layer</b> — Transactionnel, validation métier</li>
- * <li><b>Audit automatique</b> — EntityListener JPA pour traçabilité complète</li>
- * <li><b>Soft Delete</b> — Champ {@code actif} sur toutes les entités</li>
- * <li><b>Optimistic Locking</b> — Champ {@code version} pour concurrence</li>
- * <li><b>Configuration externalisée</b> — MicroProfile Config, pas de hardcoding</li>
- * </ul>
- *
- * <h2>Sécurité</h2>
- * <ul>
- * <li>OIDC avec Keycloak (realm: unionflow)</li>
- * <li>JWT signature côté backend (HMAC-SHA256)</li>
- * <li>RBAC avec rôles: SUPER_ADMIN, ADMIN_ORGANISATION, MEMBRE</li>
- * <li>Permissions granulaires par module</li>
- * <li>CORS configuré pour client web</li>
- * <li>HTTPS obligatoire en production</li>
- * </ul>
- *
- * @author UnionFlow Team
- * @version 3.0.0
- * @since 2025-01-29
- */
-@QuarkusMain
-@ApplicationScoped
-public class UnionFlowServerApplication implements QuarkusApplication {
-
-    private static final Logger LOG = Logger.getLogger(UnionFlowServerApplication.class);
-
-    /** Port HTTP configuré (défaut: 8080). */
-    @ConfigProperty(name = "quarkus.http.port", defaultValue = "8080")
-    int httpPort;
-
-    /** Host HTTP configuré (défaut: 0.0.0.0). */
-    @ConfigProperty(name = "quarkus.http.host", defaultValue = "0.0.0.0")
-    String httpHost;
-
-    /** Nom de l'application. */
-    @ConfigProperty(name = "quarkus.application.name", defaultValue = "unionflow-server")
-    String applicationName;
-
-    /** Version de l'application. */
-    @ConfigProperty(name = "quarkus.application.version", defaultValue = "3.0.0")
-    String applicationVersion;
-
-    /** Profil actif (dev, test, prod). */
-    @ConfigProperty(name = "quarkus.profile")
-    String activeProfile;
-
-    /** Version de Quarkus. */
-    @ConfigProperty(name = "quarkus.platform.version", defaultValue = "3.15.1")
-    String quarkusVersion;
-
-    /**
-     * Point d'entrée JVM.
-     *
-     * <p>Lance l'application Quarkus en mode bloquant.
-     * En mode natif, cette méthode démarre instantanément (&lt; 50ms).
-     *
-     * @param args Arguments de ligne de commande (non utilisés)
-     */
-    public static void main(String... args) {
-        Quarkus.run(UnionFlowServerApplication.class, args);
-    }
-
-    /**
-     * Méthode de démarrage de l'application.
-     *
-     * <p>Affiche les informations de démarrage (URLs, configuration)
-     * puis attend le signal d'arrêt (SIGTERM, SIGINT).
-     *
-     * @param args Arguments passés depuis main()
-     * @return Code de sortie (0 = succès)
-     * @throws Exception Si erreur fatale au démarrage
-     */
-    @Override
-    public int run(String... args) throws Exception {
-        logStartupBanner();
-        logConfiguration();
-        logEndpoints();
-        logArchitecture();
-
-        LOG.info("UnionFlow Server prêt à recevoir des requêtes");
-        LOG.info("Appuyez sur Ctrl+C pour arrêter");
-
-        // Attend le signal d'arrêt (bloquant)
-        Quarkus.waitForExit();
-
-        LOG.info("UnionFlow Server arrêté proprement");
-        return 0;
-    }
-
-    /**
-     * Affiche la bannière ASCII de démarrage.
-     */
-    private void logStartupBanner() {
-        LOG.info("----------------------------------------------------------");
-        LOG.info("-                                                        -");
-        LOG.info("-      UNIONFLOW SERVER v" + applicationVersion + "                            ");
-        LOG.info("-   Plateforme de Gestion Associative Multi-Tenant       -");
-        LOG.info("-                                                        -");
-        LOG.info("----------------------------------------------------------");
-    }
-
-    /**
-     * Affiche la configuration active.
-     */
-    private void logConfiguration() {
-        LOG.infof("Profil      : %s", activeProfile);
-        LOG.infof("Application : %s v%s", applicationName, applicationVersion);
-        LOG.infof("Java        : %s", System.getProperty("java.version"));
-        LOG.infof("Quarkus     : %s", quarkusVersion);
-    }
-
-    /**
-     * Affiche les URLs des endpoints principaux.
-     */
-    private void logEndpoints() {
-        String baseUrl = buildBaseUrl();
-
-        LOG.info("--------------------------------------------------------------");
-        LOG.info("📡 Endpoints disponibles:");
-        LOG.infof("   - API REST     --> %s/api", baseUrl);
-        LOG.infof("   - Swagger UI   --> %s/q/swagger-ui", baseUrl);
-        LOG.infof("   - Health Check --> %s/q/health", baseUrl);
-        LOG.infof("   - Metrics      --> %s/q/metrics", baseUrl);
-        LOG.infof("   - OpenAPI      --> %s/q/openapi", baseUrl);
-
-        if ("dev".equals(activeProfile)) {
-            LOG.infof("   - Dev UI       --> %s/q/dev", baseUrl);
-            LOG.infof("   - H2 Console   --> %s/q/dev/io.quarkus.quarkus-datasource/datasources", baseUrl);
-        }
-
-        LOG.info("--------------------------------------------------------------");
-    }
-
-    /**
-     * Affiche l'inventaire de l'architecture.
-     */
-    private void logArchitecture() {
-        LOG.info("    Architecture:");
-        LOG.info("   - 60 Entités JPA");
-        LOG.info("   - 46 Services CDI");
-        LOG.info("   - 37 Endpoints REST");
-        LOG.info("   - 49 Repositories Panache");
-        LOG.info("   - 142 DTOs (Request/Response)");
-        LOG.info("   - 1127 Tests automatisés");
-        LOG.info("--------------------------------------------------------------");
-    }
-
-    /**
-     * Retourne la valeur de la variable d'environnement UNIONFLOW_DOMAIN.
-     * Méthode protégée pour permettre la substitution en tests.
-     *
-     * @return valeur de UNIONFLOW_DOMAIN, ou null si non définie
-     */
-    protected String getUnionflowDomain() {
-        return System.getenv("UNIONFLOW_DOMAIN");
-    }
-
-    /**
-     * Construit l'URL de base de l'application.
-     *
-     * @return URL complète (ex: http://localhost:8080)
-     */
-    String buildBaseUrl() {
-        // En production, utiliser le nom de domaine configuré
-        if ("prod".equals(activeProfile)) {
-            String domain = getUnionflowDomain();
-            if (domain != null && !domain.isEmpty()) {
-                return "https://" + domain;
-            }
-        }
-
-        // En dev/test, utiliser localhost
-        String host = "0.0.0.0".equals(httpHost) ? "localhost" : httpHost;
-        return String.format("http://%s:%d", host, httpPort);
-    }
-}
+package dev.lions.unionflow.server;
+
+import io.quarkus.runtime.Quarkus;
+import io.quarkus.runtime.QuarkusApplication;
+import io.quarkus.runtime.annotations.QuarkusMain;
+import jakarta.enterprise.context.ApplicationScoped;
+import org.eclipse.microprofile.config.inject.ConfigProperty;
+import org.jboss.logging.Logger;
+
+/**
+ * Point d'entrée principal du serveur UnionFlow.
+ *
+ * <p><b>UnionFlow</b> est une plateforme de gestion associative multi-tenant
+ * destinée aux organisations de solidarité (associations, mutuelles, coopératives,
+ * tontines, ONG) en Afrique de l'Ouest.
+ *
+ * <h2>Architecture</h2>
+ * <ul>
+ * <li><b>Backend</b> : Quarkus 3.15.1, Java 17, Hibernate Panache</li>
+ * <li><b>Base de données</b> : PostgreSQL 15 avec Flyway</li>
+ * <li><b>Authentification</b> : Keycloak 23 (OIDC/OAuth2)</li>
+ * <li><b>API</b> : REST (JAX-RS) + WebSocket (temps réel)</li>
+ * <li><b>Paiements</b> : Wave Money CI (Mobile Money)</li>
+ * </ul>
+ *
+ * <h2>Modules fonctionnels</h2>
+ * <ul>
+ * <li><b>Organisations</b> — Hiérarchie multi-niveau, types paramétrables,
+ * modules activables par organisation</li>
+ * <li><b>Membres</b> — Adhésion, profils, rôles/permissions RBAC,
+ * synchronisation bidirectionnelle avec Keycloak</li>
+ * <li><b>Cotisations &amp; Paiements</b> — Campagnes récurrentes,
+ * ventilation polymorphique, intégration Wave Money</li>
+ * <li><b>Événements</b> — Création, inscriptions, gestion des présences,
+ * géolocalisation</li>
+ * <li><b>Solidarité</b> — Demandes d'aide, propositions, matching intelligent,
+ * workflow de validation multi-étapes</li>
+ * <li><b>Mutuelles</b> — Épargne, crédit, tontines, suivi des tours</li>
+ * <li><b>Comptabilité</b> — Plan comptable SYSCOHADA, journaux,
+ * écritures automatiques, balance, grand livre</li>
+ * <li><b>Documents</b> — Gestion polymorphique de pièces jointes
+ * (stockage local + métadonnées)</li>
+ * <li><b>Notifications</b> — Templates multicanaux (email, SMS, push),
+ * préférences utilisateur, historique persistant</li>
+ * <li><b>Analytics &amp; Dashboard</b> — KPIs temps réel via WebSocket,
+ * métriques d'activité, tendances, rapports PDF</li>
+ * <li><b>Administration</b> — Audit trail complet, tickets support,
+ * suggestions utilisateurs, favoris</li>
+ * <li><b>SaaS Multi-tenant</b> — Formules d'abonnement flexibles,
+ * souscriptions par organisation, facturation</li>
+ * <li><b>Configuration dynamique</b> — Table {@code configurations},
+ * pas de hardcoding, paramétrage par organisation</li>
+ * <li><b>Données de référence</b> — Table {@code types_reference}
+ * entièrement CRUD-able (évite les enums Java)</li>
+ * </ul>
+ *
+ * <h2>Inventaire technique</h2>
+ * <ul>
+ * <li><b>60 entités JPA</b> — {@code BaseEntity} + {@code AuditEntityListener}
+ * pour audit automatique</li>
+ * <li><b>46 services CDI</b> — Logique métier transactionnelle</li>
+ * <li><b>37 endpoints REST</b> — API JAX-RS avec validation Bean Validation</li>
+ * <li><b>49 repositories</b> — Hibernate Panache pour accès données</li>
+ * <li><b>Migrations Flyway</b> — V1.0 --> V3.0 (schéma complet 60 tables)</li>
+ * <li><b>Tests</b> — 1127 tests unitaires et d'intégration Quarkus</li>
+ * <li><b>Couverture</b> — JaCoCo 40% minimum (cible 60%)</li>
+ * </ul>
+ *
+ * <h2>Patterns et Best Practices</h2>
+ * <ul>
+ * <li><b>Clean Architecture</b> — Séparation API/Impl/Entity</li>
+ * <li><b>DTO Pattern</b> — Request/Response distincts (142 DTOs dans server-api)</li>
+ * <li><b>Repository Pattern</b> — Abstraction accès données</li>
+ * <li><b>Service Layer</b> — Transactionnel, validation métier</li>
+ * <li><b>Audit automatique</b> — EntityListener JPA pour traçabilité complète</li>
+ * <li><b>Soft Delete</b> — Champ {@code actif} sur toutes les entités</li>
+ * <li><b>Optimistic Locking</b> — Champ {@code version} pour concurrence</li>
+ * <li><b>Configuration externalisée</b> — MicroProfile Config, pas de hardcoding</li>
+ * </ul>
+ *
+ * <h2>Sécurité</h2>
+ * <ul>
+ * <li>OIDC avec Keycloak (realm: unionflow)</li>
+ * <li>JWT signature côté backend (HMAC-SHA256)</li>
+ * <li>RBAC avec rôles: SUPER_ADMIN, ADMIN_ORGANISATION, MEMBRE</li>
+ * <li>Permissions granulaires par module</li>
+ * <li>CORS configuré pour client web</li>
+ * <li>HTTPS obligatoire en production</li>
+ * </ul>
+ *
+ * @author UnionFlow Team
+ * @version 3.0.0
+ * @since 2025-01-29
+ */
+@QuarkusMain
+@ApplicationScoped
+public class UnionFlowServerApplication implements QuarkusApplication {
+
+    private static final Logger LOG = Logger.getLogger(UnionFlowServerApplication.class);
+
+    /** Port HTTP configuré (défaut: 8080). */
+    @ConfigProperty(name = "quarkus.http.port", defaultValue = "8080")
+    int httpPort;
+
+    /** Host HTTP configuré (défaut: 0.0.0.0). */
+    @ConfigProperty(name = "quarkus.http.host", defaultValue = "0.0.0.0")
+    String httpHost;
+
+    /** Nom de l'application. */
+    @ConfigProperty(name = "quarkus.application.name", defaultValue = "unionflow-server")
+    String applicationName;
+
+    /** Version de l'application. */
+    @ConfigProperty(name = "quarkus.application.version", defaultValue = "3.0.0")
+    String applicationVersion;
+
+    /** Profil actif (dev, test, prod). */
+    @ConfigProperty(name = "quarkus.profile")
+    String activeProfile;
+
+    /** Version de Quarkus. */
+    @ConfigProperty(name = "quarkus.platform.version", defaultValue = "3.15.1")
+    String quarkusVersion;
+
+    /**
+     * Point d'entrée JVM.
+     *
+     * <p>Lance l'application Quarkus en mode bloquant.
+     * En mode natif, cette méthode démarre instantanément (&lt; 50ms).
+     *
+     * @param args Arguments de ligne de commande (non utilisés)
+     */
+    public static void main(String... args) {
+        Quarkus.run(UnionFlowServerApplication.class, args);
+    }
+
+    /**
+     * Méthode de démarrage de l'application.
+     *
+     * <p>Affiche les informations de démarrage (URLs, configuration)
+     * puis attend le signal d'arrêt (SIGTERM, SIGINT).
+     *
+     * @param args Arguments passés depuis main()
+     * @return Code de sortie (0 = succès)
+     * @throws Exception Si erreur fatale au démarrage
+     */
+    @Override
+    public int run(String... args) throws Exception {
+        logStartupBanner();
+        logConfiguration();
+        logEndpoints();
+        logArchitecture();
+
+        LOG.info("UnionFlow Server prêt à recevoir des requêtes");
+        LOG.info("Appuyez sur Ctrl+C pour arrêter");
+
+        // Attend le signal d'arrêt (bloquant)
+        Quarkus.waitForExit();
+
+        LOG.info("UnionFlow Server arrêté proprement");
+        return 0;
+    }
+
+    /**
+     * Affiche la bannière ASCII de démarrage.
+     */
+    private void logStartupBanner() {
+        LOG.info("----------------------------------------------------------");
+        LOG.info("-                                                        -");
+        LOG.info("-      UNIONFLOW SERVER v" + applicationVersion + "                            ");
+        LOG.info("-   Plateforme de Gestion Associative Multi-Tenant       -");
+        LOG.info("-                                                        -");
+        LOG.info("----------------------------------------------------------");
+    }
+
+    /**
+     * Affiche la configuration active.
+     */
+    private void logConfiguration() {
+        LOG.infof("Profil      : %s", activeProfile);
+        LOG.infof("Application : %s v%s", applicationName, applicationVersion);
+        LOG.infof("Java        : %s", System.getProperty("java.version"));
+        LOG.infof("Quarkus     : %s", quarkusVersion);
+    }
+
+    /**
+     * Affiche les URLs des endpoints principaux.
+     */
+    private void logEndpoints() {
+        String baseUrl = buildBaseUrl();
+
+        LOG.info("--------------------------------------------------------------");
+        LOG.info("📡 Endpoints disponibles:");
+        LOG.infof("   - API REST     --> %s/api", baseUrl);
+        LOG.infof("   - Swagger UI   --> %s/q/swagger-ui", baseUrl);
+        LOG.infof("   - Health Check --> %s/q/health", baseUrl);
+        LOG.infof("   - Metrics      --> %s/q/metrics", baseUrl);
+        LOG.infof("   - OpenAPI      --> %s/q/openapi", baseUrl);
+
+        if ("dev".equals(activeProfile)) {
+            LOG.infof("   - Dev UI       --> %s/q/dev", baseUrl);
+            LOG.infof("   - H2 Console   --> %s/q/dev/io.quarkus.quarkus-datasource/datasources", baseUrl);
+        }
+
+        LOG.info("--------------------------------------------------------------");
+    }
+
+    /**
+     * Affiche l'inventaire de l'architecture.
+     */
+    private void logArchitecture() {
+        LOG.info("    Architecture:");
+        LOG.info("   - 60 Entités JPA");
+        LOG.info("   - 46 Services CDI");
+        LOG.info("   - 37 Endpoints REST");
+        LOG.info("   - 49 Repositories Panache");
+        LOG.info("   - 142 DTOs (Request/Response)");
+        LOG.info("   - 1127 Tests automatisés");
+        LOG.info("--------------------------------------------------------------");
+    }
+
+    /**
+     * Retourne la valeur de la variable d'environnement UNIONFLOW_DOMAIN.
+     * Méthode protégée pour permettre la substitution en tests.
+     *
+     * @return valeur de UNIONFLOW_DOMAIN, ou null si non définie
+     */
+    protected String getUnionflowDomain() {
+        return System.getenv("UNIONFLOW_DOMAIN");
+    }
+
+    /**
+     * Construit l'URL de base de l'application.
+     *
+     * @return URL complète (ex: http://localhost:8080)
+     */
+    String buildBaseUrl() {
+        // En production, utiliser le nom de domaine configuré
+        if ("prod".equals(activeProfile)) {
+            String domain = getUnionflowDomain();
+            if (domain != null && !domain.isEmpty()) {
+                return "https://" + domain;
+            }
+        }
+
+        // En dev/test, utiliser localhost
+        String host = "0.0.0.0".equals(httpHost) ? "localhost" : httpHost;
+        return String.format("http://%s:%d", host, httpPort);
+    }
+}

src/main/java/dev/lions/unionflow/server/client/AdminServiceTokenHeadersFactory.java

@@ -1,48 +1,48 @@
-package dev.lions.unionflow.server.client;
-
-import io.quarkus.oidc.client.NamedOidcClient;
-import io.quarkus.oidc.client.OidcClient;
-import io.quarkus.oidc.client.Tokens;
-import jakarta.enterprise.context.ApplicationScoped;
-import jakarta.inject.Inject;
-import jakarta.ws.rs.core.MultivaluedHashMap;
-import jakarta.ws.rs.core.MultivaluedMap;
-import org.eclipse.microprofile.rest.client.ext.ClientHeadersFactory;
-import org.jboss.logging.Logger;
-
-/**
- * Injecte le token du service account "admin-service" (client credentials grant)
- * dans tous les appels faits via {@link AdminUserServiceClient} et {@link AdminRoleServiceClient}.
- *
- * <p>Utilise directement l'API {@link OidcClient} pour récupérer/rafraîchir le token.
- * Cette approche explicite évite toute ambiguïté avec {@code @OidcClientFilter} quand
- * plusieurs interfaces REST partagent le même configKey.
- */
-@ApplicationScoped
-public class AdminServiceTokenHeadersFactory implements ClientHeadersFactory {
-
-    private static final Logger LOG = Logger.getLogger(AdminServiceTokenHeadersFactory.class);
-
-    @Inject
-    @NamedOidcClient("admin-service")
-    OidcClient adminOidcClient;
-
-    @Override
-    public MultivaluedMap<String, String> update(
-            MultivaluedMap<String, String> incomingHeaders,
-            MultivaluedMap<String, String> clientOutgoingHeaders) {
-
-        MultivaluedMap<String, String> result = new MultivaluedHashMap<>();
-        try {
-            Tokens tokens = adminOidcClient.getTokens().await().indefinitely();
-            result.add("Authorization", "Bearer " + tokens.getAccessToken());
-            LOG.debugf("Token service account injecté pour admin-service (longueur: %d)",
-                    tokens.getAccessToken().length());
-        } catch (Exception e) {
-            LOG.errorf("Impossible d'obtenir le token service account 'admin-service': %s", e.getMessage());
-            throw new jakarta.ws.rs.ServiceUnavailableException(
-                    "Service d'authentification interne indisponible: " + e.getMessage());
-        }
-        return result;
-    }
-}
+package dev.lions.unionflow.server.client;
+
+import io.quarkus.oidc.client.NamedOidcClient;
+import io.quarkus.oidc.client.OidcClient;
+import io.quarkus.oidc.client.Tokens;
+import jakarta.enterprise.context.ApplicationScoped;
+import jakarta.inject.Inject;
+import jakarta.ws.rs.core.MultivaluedHashMap;
+import jakarta.ws.rs.core.MultivaluedMap;
+import org.eclipse.microprofile.rest.client.ext.ClientHeadersFactory;
+import org.jboss.logging.Logger;
+
+/**
+ * Injecte le token du service account "admin-service" (client credentials grant)
+ * dans tous les appels faits via {@link AdminUserServiceClient} et {@link AdminRoleServiceClient}.
+ *
+ * <p>Utilise directement l'API {@link OidcClient} pour récupérer/rafraîchir le token.
+ * Cette approche explicite évite toute ambiguïté avec {@code @OidcClientFilter} quand
+ * plusieurs interfaces REST partagent le même configKey.
+ */
+@ApplicationScoped
+public class AdminServiceTokenHeadersFactory implements ClientHeadersFactory {
+
+    private static final Logger LOG = Logger.getLogger(AdminServiceTokenHeadersFactory.class);
+
+    @Inject
+    @NamedOidcClient("admin-service")
+    OidcClient adminOidcClient;
+
+    @Override
+    public MultivaluedMap<String, String> update(
+            MultivaluedMap<String, String> incomingHeaders,
+            MultivaluedMap<String, String> clientOutgoingHeaders) {
+
+        MultivaluedMap<String, String> result = new MultivaluedHashMap<>();
+        try {
+            Tokens tokens = adminOidcClient.getTokens().await().indefinitely();
+            result.add("Authorization", "Bearer " + tokens.getAccessToken());
+            LOG.debugf("Token service account injecté pour admin-service (longueur: %d)",
+                    tokens.getAccessToken().length());
+        } catch (Exception e) {
+            LOG.errorf("Impossible d'obtenir le token service account 'admin-service': %s", e.getMessage());
+            throw new jakarta.ws.rs.ServiceUnavailableException(
+                    "Service d'authentification interne indisponible: " + e.getMessage());
+        }
+        return result;
+    }
+}

src/main/java/dev/lions/unionflow/server/client/JwtPropagationFilter.java

@@ -1,71 +1,77 @@
-package dev.lions.unionflow.server.client;
-
-import io.quarkus.oidc.runtime.OidcJwtCallerPrincipal;
-import io.quarkus.security.identity.SecurityIdentity;
-import jakarta.inject.Inject;
-import jakarta.ws.rs.client.ClientRequestContext;
-import jakarta.ws.rs.client.ClientRequestFilter;
-import jakarta.ws.rs.core.HttpHeaders;
-import jakarta.ws.rs.ext.Provider;
-import org.eclipse.microprofile.jwt.JsonWebToken;
-import org.jboss.logging.Logger;
-
-import java.io.IOException;
-
-/**
- * Filtre REST Client qui propage le token JWT de la requête entrante.
- *
- * <p>NE PAS annoter avec {@code @Provider} — cela l'enregistrerait GLOBALEMENT
- * sur tous les REST clients, y compris AdminUserServiceClient/AdminRoleServiceClient
- * qui utilisent AdminServiceTokenHeadersFactory (service account). Le filtre global
- * écraserait le token de service account avec le JWT utilisateur → 401 sur LUM.
- *
- * <p>La propagation JWT est assurée par {@link OidcTokenPropagationHeadersFactory}
- * sur les clients qui en ont besoin ({@code @RegisterClientHeaders}).
- */
-public class JwtPropagationFilter implements ClientRequestFilter {
-
-    private static final Logger LOG = Logger.getLogger(JwtPropagationFilter.class);
-
-    @Inject
-    SecurityIdentity securityIdentity;
-
-    @Override
-    public void filter(ClientRequestContext requestContext) throws IOException {
-        if (securityIdentity != null && !securityIdentity.isAnonymous()) {
-            // Récupérer le token JWT depuis le principal
-            if (securityIdentity.getPrincipal() instanceof OidcJwtCallerPrincipal) {
-                OidcJwtCallerPrincipal principal = (OidcJwtCallerPrincipal) securityIdentity.getPrincipal();
-                String token = principal.getRawToken();
-
-                if (token != null && !token.isBlank()) {
-                    requestContext.getHeaders().putSingle(
-                        HttpHeaders.AUTHORIZATION,
-                        "Bearer " + token
-                    );
-                    LOG.debugf("Token JWT propagé vers %s", requestContext.getUri());
-                } else {
-                    LOG.warnf("Token JWT vide pour %s", requestContext.getUri());
-                }
-            } else if (securityIdentity.getPrincipal() instanceof JsonWebToken) {
-                JsonWebToken jwt = (JsonWebToken) securityIdentity.getPrincipal();
-                String token = jwt.getRawToken();
-
-                if (token != null && !token.isBlank()) {
-                    requestContext.getHeaders().putSingle(
-                        HttpHeaders.AUTHORIZATION,
-                        "Bearer " + token
-                    );
-                    LOG.debugf("Token JWT propagé vers %s", requestContext.getUri());
-                }
-            } else {
-                LOG.warnf("Principal n'est pas un JWT pour %s (type: %s)",
-                    requestContext.getUri(),
-                    securityIdentity.getPrincipal().getClass().getName());
-            }
-        } else {
-            LOG.warnf("Pas de SecurityIdentity ou utilisateur anonyme pour %s",
-                requestContext.getUri());
-        }
-    }
-}
+package dev.lions.unionflow.server.client;
+
+import io.quarkus.oidc.runtime.OidcJwtCallerPrincipal;
+import io.quarkus.security.identity.SecurityIdentity;
+import jakarta.enterprise.context.ApplicationScoped;
+import jakarta.inject.Inject;
+import jakarta.ws.rs.client.ClientRequestContext;
+import jakarta.ws.rs.client.ClientRequestFilter;
+import jakarta.ws.rs.core.HttpHeaders;
+import org.eclipse.microprofile.jwt.JsonWebToken;
+import org.jboss.logging.Logger;
+
+import java.io.IOException;
+
+/**
+ * Filtre REST Client qui propage le token JWT de la requête entrante.
+ *
+ * <p>NE PAS annoter avec {@code @Provider} — cela l'enregistrerait GLOBALEMENT
+ * sur tous les REST clients, y compris AdminUserServiceClient/AdminRoleServiceClient
+ * qui utilisent AdminServiceTokenHeadersFactory (service account). Le filtre global
+ * écraserait le token de service account avec le JWT utilisateur → 401 sur LUM.
+ *
+ * <p>{@code @ApplicationScoped} est requis pour la découverte CDI (tests {@code @QuarkusTest}
+ * qui {@code @Inject} le filter). Cela ne provoque PAS d'enregistrement automatique JAX-RS
+ * — l'opt-in se fait via {@code @RegisterProvider(JwtPropagationFilter.class)} sur les
+ * REST clients qui le souhaitent.
+ *
+ * <p>La propagation JWT par défaut est assurée par {@link OidcTokenPropagationHeadersFactory}
+ * sur les clients qui en ont besoin ({@code @RegisterClientHeaders}).
+ */
+@ApplicationScoped
+public class JwtPropagationFilter implements ClientRequestFilter {
+
+    private static final Logger LOG = Logger.getLogger(JwtPropagationFilter.class);
+
+    @Inject
+    SecurityIdentity securityIdentity;
+
+    @Override
+    public void filter(ClientRequestContext requestContext) throws IOException {
+        if (securityIdentity != null && !securityIdentity.isAnonymous()) {
+            // Récupérer le token JWT depuis le principal
+            if (securityIdentity.getPrincipal() instanceof OidcJwtCallerPrincipal) {
+                OidcJwtCallerPrincipal principal = (OidcJwtCallerPrincipal) securityIdentity.getPrincipal();
+                String token = principal.getRawToken();
+
+                if (token != null && !token.isBlank()) {
+                    requestContext.getHeaders().putSingle(
+                        HttpHeaders.AUTHORIZATION,
+                        "Bearer " + token
+                    );
+                    LOG.debugf("Token JWT propagé vers %s", requestContext.getUri());
+                } else {
+                    LOG.warnf("Token JWT vide pour %s", requestContext.getUri());
+                }
+            } else if (securityIdentity.getPrincipal() instanceof JsonWebToken) {
+                JsonWebToken jwt = (JsonWebToken) securityIdentity.getPrincipal();
+                String token = jwt.getRawToken();
+
+                if (token != null && !token.isBlank()) {
+                    requestContext.getHeaders().putSingle(
+                        HttpHeaders.AUTHORIZATION,
+                        "Bearer " + token
+                    );
+                    LOG.debugf("Token JWT propagé vers %s", requestContext.getUri());
+                }
+            } else {
+                LOG.warnf("Principal n'est pas un JWT pour %s (type: %s)",
+                    requestContext.getUri(),
+                    securityIdentity.getPrincipal().getClass().getName());
+            }
+        } else {
+            LOG.warnf("Pas de SecurityIdentity ou utilisateur anonyme pour %s",
+                requestContext.getUri());
+        }
+    }
+}

src/main/java/dev/lions/unionflow/server/client/OidcTokenPropagationHeadersFactory.java

@@ -1,72 +1,72 @@
-package dev.lions.unionflow.server.client;
-
-import io.quarkus.oidc.runtime.OidcJwtCallerPrincipal;
-import io.quarkus.security.identity.SecurityIdentity;
-import jakarta.enterprise.context.ApplicationScoped;
-import jakarta.enterprise.inject.Instance;
-import jakarta.inject.Inject;
-import jakarta.ws.rs.core.MultivaluedHashMap;
-import jakarta.ws.rs.core.MultivaluedMap;
-import org.eclipse.microprofile.rest.client.ext.ClientHeadersFactory;
-import org.jboss.logging.Logger;
-
-/**
- * Factory pour propager automatiquement le token JWT OIDC
- * vers les appels REST Client (compatible Quarkus REST).
- *
- * Stratégie : copier le header Authorization de la requête entrante
- * ou récupérer le token depuis SecurityIdentity si disponible.
- */
-@ApplicationScoped
-public class OidcTokenPropagationHeadersFactory implements ClientHeadersFactory {
-
-    private static final Logger LOG = Logger.getLogger(OidcTokenPropagationHeadersFactory.class);
-
-    @Inject
-    Instance<SecurityIdentity> securityIdentity;
-
-    @Override
-    public MultivaluedMap<String, String> update(
-            MultivaluedMap<String, String> incomingHeaders,
-            MultivaluedMap<String, String> clientOutgoingHeaders) {
-
-        MultivaluedMap<String, String> result = new MultivaluedHashMap<>();
-
-        // STRATÉGIE 1 : Copier directement le header Authorization de la requête entrante
-        if (incomingHeaders != null && incomingHeaders.containsKey("Authorization")) {
-            String authHeader = incomingHeaders.getFirst("Authorization");
-            if (authHeader != null && !authHeader.isBlank()) {
-                result.add("Authorization", authHeader);
-                LOG.infof("✅ Token JWT propagé depuis incomingHeaders (longueur: %d)", authHeader.length());
-                return result;
-            }
-        }
-
-        // STRATÉGIE 2 : Récupérer depuis SecurityIdentity
-        // En contexte CDI, securityIdentity.isResolvable() est toujours true.
-        SecurityIdentity identity = securityIdentity.get();
-
-        if (identity != null && !identity.isAnonymous()) {
-            if (identity.getPrincipal() instanceof OidcJwtCallerPrincipal) {
-                OidcJwtCallerPrincipal principal = (OidcJwtCallerPrincipal) identity.getPrincipal();
-                String token = principal.getRawToken();
-
-                if (token != null && !token.isBlank()) {
-                    result.add("Authorization", "Bearer " + token);
-                    LOG.infof("✅ Token JWT propagé depuis SecurityIdentity (longueur: %d)", token.length());
-                    return result;
-                } else {
-                    LOG.warnf("⚠️ Token JWT vide dans SecurityIdentity");
-                }
-            } else {
-                LOG.warnf("⚠️ Principal n'est pas un OidcJwtCallerPrincipal (type: %s)",
-                    identity.getPrincipal() != null ? identity.getPrincipal().getClass().getName() : "null");
-            }
-        } else {
-            LOG.warnf("⚠️ SecurityIdentity null ou utilisateur anonyme");
-        }
-
-        LOG.errorf("❌ Impossible de propager le token JWT - aucune stratégie n'a fonctionné");
-        return result;
-    }
-}
+package dev.lions.unionflow.server.client;
+
+import io.quarkus.oidc.runtime.OidcJwtCallerPrincipal;
+import io.quarkus.security.identity.SecurityIdentity;
+import jakarta.enterprise.context.ApplicationScoped;
+import jakarta.enterprise.inject.Instance;
+import jakarta.inject.Inject;
+import jakarta.ws.rs.core.MultivaluedHashMap;
+import jakarta.ws.rs.core.MultivaluedMap;
+import org.eclipse.microprofile.rest.client.ext.ClientHeadersFactory;
+import org.jboss.logging.Logger;
+
+/**
+ * Factory pour propager automatiquement le token JWT OIDC
+ * vers les appels REST Client (compatible Quarkus REST).
+ *
+ * Stratégie : copier le header Authorization de la requête entrante
+ * ou récupérer le token depuis SecurityIdentity si disponible.
+ */
+@ApplicationScoped
+public class OidcTokenPropagationHeadersFactory implements ClientHeadersFactory {
+
+    private static final Logger LOG = Logger.getLogger(OidcTokenPropagationHeadersFactory.class);
+
+    @Inject
+    Instance<SecurityIdentity> securityIdentity;
+
+    @Override
+    public MultivaluedMap<String, String> update(
+            MultivaluedMap<String, String> incomingHeaders,
+            MultivaluedMap<String, String> clientOutgoingHeaders) {
+
+        MultivaluedMap<String, String> result = new MultivaluedHashMap<>();
+
+        // STRATÉGIE 1 : Copier directement le header Authorization de la requête entrante
+        if (incomingHeaders != null && incomingHeaders.containsKey("Authorization")) {
+            String authHeader = incomingHeaders.getFirst("Authorization");
+            if (authHeader != null && !authHeader.isBlank()) {
+                result.add("Authorization", authHeader);
+                LOG.infof("✅ Token JWT propagé depuis incomingHeaders (longueur: %d)", authHeader.length());
+                return result;
+            }
+        }
+
+        // STRATÉGIE 2 : Récupérer depuis SecurityIdentity
+        // En contexte CDI, securityIdentity.isResolvable() est toujours true.
+        SecurityIdentity identity = securityIdentity.get();
+
+        if (identity != null && !identity.isAnonymous()) {
+            if (identity.getPrincipal() instanceof OidcJwtCallerPrincipal) {
+                OidcJwtCallerPrincipal principal = (OidcJwtCallerPrincipal) identity.getPrincipal();
+                String token = principal.getRawToken();
+
+                if (token != null && !token.isBlank()) {
+                    result.add("Authorization", "Bearer " + token);
+                    LOG.infof("✅ Token JWT propagé depuis SecurityIdentity (longueur: %d)", token.length());
+                    return result;
+                } else {
+                    LOG.warnf("⚠️ Token JWT vide dans SecurityIdentity");
+                }
+            } else {
+                LOG.warnf("⚠️ Principal n'est pas un OidcJwtCallerPrincipal (type: %s)",
+                    identity.getPrincipal() != null ? identity.getPrincipal().getClass().getName() : "null");
+            }
+        } else {
+            LOG.warnf("⚠️ SecurityIdentity null ou utilisateur anonyme");
+        }
+
+        LOG.errorf("❌ Impossible de propager le token JWT - aucune stratégie n'a fonctionné");
+        return result;
+    }
+}

src/main/java/dev/lions/unionflow/server/client/RoleServiceClient.java

@@ -1,57 +1,57 @@
-package dev.lions.unionflow.server.client;
-
-import dev.lions.user.manager.dto.role.RoleDTO;
-import jakarta.ws.rs.*;
-import jakarta.ws.rs.core.MediaType;
-import org.eclipse.microprofile.rest.client.annotation.RegisterClientHeaders;
-import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;
-
-import java.util.List;
-
-/**
- * REST Client pour l'API rôles de lions-user-manager (Keycloak).
- * Même base URL que UserServiceClient (configKey = lions-user-manager-api).
- */
-@Path("/api/roles")
-@RegisterRestClient(configKey = "lions-user-manager-api")
-@RegisterClientHeaders(OidcTokenPropagationHeadersFactory.class)
-@Produces(MediaType.APPLICATION_JSON)
-@Consumes(MediaType.APPLICATION_JSON)
-public interface RoleServiceClient {
-
-    @GET
-    @Path("/realm")
-    List<RoleDTO> getRealmRoles(@QueryParam("realm") String realmName);
-
-    @GET
-    @Path("/user/realm/{userId}")
-    List<RoleDTO> getUserRealmRoles(
-        @PathParam("userId") String userId,
-        @QueryParam("realm") String realmName
-    );
-
-    @POST
-    @Path("/assign/realm/{userId}")
-    void assignRealmRoles(
-        @PathParam("userId") String userId,
-        @QueryParam("realm") String realmName,
-        RoleNamesRequest request
-    );
-
-    @POST
-    @Path("/revoke/realm/{userId}")
-    void revokeRealmRoles(
-        @PathParam("userId") String userId,
-        @QueryParam("realm") String realmName,
-        RoleNamesRequest request
-    );
-
-    /** Corps de requête pour assign/revoke (compatible lions-user-manager). */
-    class RoleNamesRequest {
-        public List<String> roleNames;
-        public RoleNamesRequest() {}
-        public RoleNamesRequest(List<String> roleNames) { this.roleNames = roleNames; }
-        public List<String> getRoleNames() { return roleNames; }
-        public void setRoleNames(List<String> roleNames) { this.roleNames = roleNames; }
-    }
-}
+package dev.lions.unionflow.server.client;
+
+import dev.lions.user.manager.dto.role.RoleDTO;
+import jakarta.ws.rs.*;
+import jakarta.ws.rs.core.MediaType;
+import org.eclipse.microprofile.rest.client.annotation.RegisterClientHeaders;
+import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;
+
+import java.util.List;
+
+/**
+ * REST Client pour l'API rôles de lions-user-manager (Keycloak).
+ * Même base URL que UserServiceClient (configKey = lions-user-manager-api).
+ */
+@Path("/api/roles")
+@RegisterRestClient(configKey = "lions-user-manager-api")
+@RegisterClientHeaders(OidcTokenPropagationHeadersFactory.class)
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+public interface RoleServiceClient {
+
+    @GET
+    @Path("/realm")
+    List<RoleDTO> getRealmRoles(@QueryParam("realm") String realmName);
+
+    @GET
+    @Path("/user/realm/{userId}")
+    List<RoleDTO> getUserRealmRoles(
+        @PathParam("userId") String userId,
+        @QueryParam("realm") String realmName
+    );
+
+    @POST
+    @Path("/assign/realm/{userId}")
+    void assignRealmRoles(
+        @PathParam("userId") String userId,
+        @QueryParam("realm") String realmName,
+        RoleNamesRequest request
+    );
+
+    @POST
+    @Path("/revoke/realm/{userId}")
+    void revokeRealmRoles(
+        @PathParam("userId") String userId,
+        @QueryParam("realm") String realmName,
+        RoleNamesRequest request
+    );
+
+    /** Corps de requête pour assign/revoke (compatible lions-user-manager). */
+    class RoleNamesRequest {
+        public List<String> roleNames;
+        public RoleNamesRequest() {}
+        public RoleNamesRequest(List<String> roleNames) { this.roleNames = roleNames; }
+        public List<String> getRoleNames() { return roleNames; }
+        public void setRoleNames(List<String> roleNames) { this.roleNames = roleNames; }
+    }
+}

src/main/java/dev/lions/unionflow/server/client/UserServiceClient.java

@@ -1,77 +1,77 @@
-package dev.lions.unionflow.server.client;
-
-import dev.lions.user.manager.dto.user.UserDTO;
-import dev.lions.user.manager.dto.user.UserSearchCriteriaDTO;
-import dev.lions.user.manager.dto.user.UserSearchResultDTO;
-import jakarta.ws.rs.*;
-import jakarta.ws.rs.core.MediaType;
-import org.eclipse.microprofile.rest.client.annotation.RegisterClientHeaders;
-import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;
-
-/**
- * REST Client pour le service de gestion des utilisateurs Keycloak
- * via lions-user-manager API
- *
- * Configuration dans application.properties:
- * quarkus.rest-client.lions-user-manager-api.url=http://localhost:8081
- */
-@Path("/api/users")
-@RegisterRestClient(configKey = "lions-user-manager-api")
-@RegisterClientHeaders(OidcTokenPropagationHeadersFactory.class)
-@Produces(MediaType.APPLICATION_JSON)
-@Consumes(MediaType.APPLICATION_JSON)
-public interface UserServiceClient {
-
-    /**
-     * Rechercher des utilisateurs selon des critères
-     */
-    @POST
-    @Path("/search")
-    UserSearchResultDTO searchUsers(UserSearchCriteriaDTO criteria);
-
-    /**
-     * Récupérer un utilisateur par ID
-     */
-    @GET
-    @Path("/{userId}")
-    UserDTO getUserById(
-            @PathParam("userId") String userId,
-            @QueryParam("realm") String realmName);
-
-    /**
-     * Créer un nouvel utilisateur
-     */
-    @POST
-    UserDTO createUser(
-            UserDTO user,
-            @QueryParam("realm") String realmName);
-
-    /**
-     * Mettre à jour un utilisateur
-     */
-    @PUT
-    @Path("/{userId}")
-    UserDTO updateUser(
-            @PathParam("userId") String userId,
-            UserDTO user,
-            @QueryParam("realm") String realmName);
-
-    /**
-     * Supprimer un utilisateur
-     */
-    @DELETE
-    @Path("/{userId}")
-    void deleteUser(
-            @PathParam("userId") String userId,
-            @QueryParam("realm") String realmName);
-
-    /**
-     * Envoyer un email de vérification
-     */
-    @POST
-    @Path("/{userId}/send-verification-email")
-    void sendVerificationEmail(
-            @PathParam("userId") String userId,
-            @QueryParam("realm") String realmName);
-
-}
+package dev.lions.unionflow.server.client;
+
+import dev.lions.user.manager.dto.user.UserDTO;
+import dev.lions.user.manager.dto.user.UserSearchCriteriaDTO;
+import dev.lions.user.manager.dto.user.UserSearchResultDTO;
+import jakarta.ws.rs.*;
+import jakarta.ws.rs.core.MediaType;
+import org.eclipse.microprofile.rest.client.annotation.RegisterClientHeaders;
+import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;
+
+/**
+ * REST Client pour le service de gestion des utilisateurs Keycloak
+ * via lions-user-manager API
+ *
+ * Configuration dans application.properties:
+ * quarkus.rest-client.lions-user-manager-api.url=http://localhost:8081
+ */
+@Path("/api/users")
+@RegisterRestClient(configKey = "lions-user-manager-api")
+@RegisterClientHeaders(OidcTokenPropagationHeadersFactory.class)
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+public interface UserServiceClient {
+
+    /**
+     * Rechercher des utilisateurs selon des critères
+     */
+    @POST
+    @Path("/search")
+    UserSearchResultDTO searchUsers(UserSearchCriteriaDTO criteria);
+
+    /**
+     * Récupérer un utilisateur par ID
+     */
+    @GET
+    @Path("/{userId}")
+    UserDTO getUserById(
+            @PathParam("userId") String userId,
+            @QueryParam("realm") String realmName);
+
+    /**
+     * Créer un nouvel utilisateur
+     */
+    @POST
+    UserDTO createUser(
+            UserDTO user,
+            @QueryParam("realm") String realmName);
+
+    /**
+     * Mettre à jour un utilisateur
+     */
+    @PUT
+    @Path("/{userId}")
+    UserDTO updateUser(
+            @PathParam("userId") String userId,
+            UserDTO user,
+            @QueryParam("realm") String realmName);
+
+    /**
+     * Supprimer un utilisateur
+     */
+    @DELETE
+    @Path("/{userId}")
+    void deleteUser(
+            @PathParam("userId") String userId,
+            @QueryParam("realm") String realmName);
+
+    /**
+     * Envoyer un email de vérification
+     */
+    @POST
+    @Path("/{userId}/send-verification-email")
+    void sendVerificationEmail(
+            @PathParam("userId") String userId,
+            @QueryParam("realm") String realmName);
+
+}

src/main/java/dev/lions/unionflow/server/dto/EvenementMobileDTO.java

@@ -1,143 +1,143 @@
-package dev.lions.unionflow.server.dto;
-
-import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
-import dev.lions.unionflow.server.entity.Evenement;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-import java.util.UUID;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-
-/**
- * DTO pour l'API mobile - Mapping des champs de l'entité Evenement vers le
- * format attendu par
- * l'application mobile Flutter
- *
- * @author UnionFlow Team
- * @version 2.0
- * @since 2025-01-16
- */
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@JsonIgnoreProperties(ignoreUnknown = true)
-public class EvenementMobileDTO {
-
-  private UUID id;
-  private String titre;
-  private String description;
-  private LocalDateTime dateDebut;
-  private LocalDateTime dateFin;
-  private String lieu;
-  private String adresse;
-  private String ville;
-  private String codePostal;
-
-  // Mapping: typeEvenement -> type
-  private String type;
-
-  // Mapping: statut -> statut (OK)
-  private String statut;
-
-  // Mapping: capaciteMax -> maxParticipants
-  private Integer maxParticipants;
-
-  // Nombre de participants actuels (calculé depuis les inscriptions)
-  private Integer participantsActuels;
-
-  // IDs et noms pour les relations
-  private UUID organisateurId;
-  private String organisateurNom;
-  private UUID organisationId;
-  private String organisationNom;
-
-  // Priorité (à ajouter dans l'entité si nécessaire)
-  private String priorite;
-
-  // Mapping: visiblePublic -> estPublic
-  private Boolean estPublic;
-
-  // Mapping: inscriptionRequise -> inscriptionRequise (OK)
-  private Boolean inscriptionRequise;
-
-  // Mapping: prix -> cout
-  private BigDecimal cout;
-
-  // Devise
-  private String devise;
-
-  // Tags (à implémenter si nécessaire)
-  private String[] tags;
-
-  // URLs
-  private String imageUrl;
-  private String documentUrl;
-
-  // Notes
-  private String notes;
-
-  // Dates de création/modification
-  private LocalDateTime dateCreation;
-  private LocalDateTime dateModification;
-
-  // Actif
-  private Boolean actif;
-
-  /**
-   * Convertit une entité Evenement en DTO mobile
-   *
-   * @param evenement L'entité à convertir
-   * @return Le DTO mobile
-   */
-  public static EvenementMobileDTO fromEntity(Evenement evenement) {
-    if (evenement == null) {
-      return null;
-    }
-
-    return EvenementMobileDTO.builder()
-        .id(evenement.getId()) // Utilise getId() depuis BaseEntity
-        .titre(evenement.getTitre())
-        .description(evenement.getDescription())
-        .dateDebut(evenement.getDateDebut())
-        .dateFin(evenement.getDateFin())
-        .lieu(evenement.getLieu())
-        .adresse(evenement.getAdresse())
-        .ville(null) // Pas de champ ville dans l'entité
-        .codePostal(null) // Pas de champ codePostal dans l'entité
-        // Mapping des enums
-        .type(evenement.getTypeEvenement() != null ? evenement.getTypeEvenement() : null)
-        .statut(evenement.getStatut() != null ? evenement.getStatut() : "PLANIFIE")
-        // Mapping des champs renommés
-        .maxParticipants(evenement.getCapaciteMax())
-        .participantsActuels(evenement.getNombreInscrits())
-        // Relations (gestion sécurisée des lazy loading)
-        .organisateurId(evenement.getOrganisateur() != null ? evenement.getOrganisateur().getId() : null)
-        .organisateurNom(evenement.getOrganisateur() != null ? evenement.getOrganisateur().getNomComplet() : null)
-        .organisationId(evenement.getOrganisation() != null ? evenement.getOrganisation().getId() : null)
-        .organisationNom(evenement.getOrganisation() != null ? evenement.getOrganisation().getNom() : null)
-        // Priorité (valeur par défaut)
-        .priorite("MOYENNE")
-        // Mapping booléens
-        .estPublic(evenement.getVisiblePublic())
-        .inscriptionRequise(evenement.getInscriptionRequise())
-        // Mapping prix -> cout
-        .cout(evenement.getPrix())
-        .devise("XOF")
-        // Tags vides pour l'instant
-        .tags(new String[] {})
-        // URLs (à implémenter si nécessaire)
-        .imageUrl(null)
-        .documentUrl(null)
-        // Notes
-        .notes(evenement.getInstructionsParticulieres())
-        // Dates
-        .dateCreation(evenement.getDateCreation())
-        .dateModification(evenement.getDateModification())
-        // Actif
-        .actif(evenement.getActif())
-        .build();
-  }
-}
+package dev.lions.unionflow.server.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import dev.lions.unionflow.server.entity.Evenement;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * DTO pour l'API mobile - Mapping des champs de l'entité Evenement vers le
+ * format attendu par
+ * l'application mobile Flutter
+ *
+ * @author UnionFlow Team
+ * @version 2.0
+ * @since 2025-01-16
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class EvenementMobileDTO {
+
+  private UUID id;
+  private String titre;
+  private String description;
+  private LocalDateTime dateDebut;
+  private LocalDateTime dateFin;
+  private String lieu;
+  private String adresse;
+  private String ville;
+  private String codePostal;
+
+  // Mapping: typeEvenement -> type
+  private String type;
+
+  // Mapping: statut -> statut (OK)
+  private String statut;
+
+  // Mapping: capaciteMax -> maxParticipants
+  private Integer maxParticipants;
+
+  // Nombre de participants actuels (calculé depuis les inscriptions)
+  private Integer participantsActuels;
+
+  // IDs et noms pour les relations
+  private UUID organisateurId;
+  private String organisateurNom;
+  private UUID organisationId;
+  private String organisationNom;
+
+  // Priorité (à ajouter dans l'entité si nécessaire)
+  private String priorite;
+
+  // Mapping: visiblePublic -> estPublic
+  private Boolean estPublic;
+
+  // Mapping: inscriptionRequise -> inscriptionRequise (OK)
+  private Boolean inscriptionRequise;
+
+  // Mapping: prix -> cout
+  private BigDecimal cout;
+
+  // Devise
+  private String devise;
+
+  // Tags (à implémenter si nécessaire)
+  private String[] tags;
+
+  // URLs
+  private String imageUrl;
+  private String documentUrl;
+
+  // Notes
+  private String notes;
+
+  // Dates de création/modification
+  private LocalDateTime dateCreation;
+  private LocalDateTime dateModification;
+
+  // Actif
+  private Boolean actif;
+
+  /**
+   * Convertit une entité Evenement en DTO mobile
+   *
+   * @param evenement L'entité à convertir
+   * @return Le DTO mobile
+   */
+  public static EvenementMobileDTO fromEntity(Evenement evenement) {
+    if (evenement == null) {
+      return null;
+    }
+
+    return EvenementMobileDTO.builder()
+        .id(evenement.getId()) // Utilise getId() depuis BaseEntity
+        .titre(evenement.getTitre())
+        .description(evenement.getDescription())
+        .dateDebut(evenement.getDateDebut())
+        .dateFin(evenement.getDateFin())
+        .lieu(evenement.getLieu())
+        .adresse(evenement.getAdresse())
+        .ville(null) // Pas de champ ville dans l'entité
+        .codePostal(null) // Pas de champ codePostal dans l'entité
+        // Mapping des enums
+        .type(evenement.getTypeEvenement() != null ? evenement.getTypeEvenement() : null)
+        .statut(evenement.getStatut() != null ? evenement.getStatut() : "PLANIFIE")
+        // Mapping des champs renommés
+        .maxParticipants(evenement.getCapaciteMax())
+        .participantsActuels(evenement.getNombreInscrits())
+        // Relations (gestion sécurisée des lazy loading)
+        .organisateurId(evenement.getOrganisateur() != null ? evenement.getOrganisateur().getId() : null)
+        .organisateurNom(evenement.getOrganisateur() != null ? evenement.getOrganisateur().getNomComplet() : null)
+        .organisationId(evenement.getOrganisation() != null ? evenement.getOrganisation().getId() : null)
+        .organisationNom(evenement.getOrganisation() != null ? evenement.getOrganisation().getNom() : null)
+        // Priorité (valeur par défaut)
+        .priorite("MOYENNE")
+        // Mapping booléens
+        .estPublic(evenement.getVisiblePublic())
+        .inscriptionRequise(evenement.getInscriptionRequise())
+        // Mapping prix -> cout
+        .cout(evenement.getPrix())
+        .devise("XOF")
+        // Tags vides pour l'instant
+        .tags(new String[] {})
+        // URLs (à implémenter si nécessaire)
+        .imageUrl(null)
+        .documentUrl(null)
+        // Notes
+        .notes(evenement.getInstructionsParticulieres())
+        // Dates
+        .dateCreation(evenement.getDateCreation())
+        .dateModification(evenement.getDateModification())
+        // Actif
+        .actif(evenement.getActif())
+        .build();
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Adresse.java

@@ -1,150 +1,150 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Adresse pour la gestion des adresses des organisations, membres et
- * événements
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(name = "adresses", indexes = {
-    @Index(name = "idx_adresse_ville", columnList = "ville"),
-    @Index(name = "idx_adresse_pays", columnList = "pays"),
-    @Index(name = "idx_adresse_type", columnList = "type_adresse"),
-    @Index(name = "idx_adresse_organisation", columnList = "organisation_id"),
-    @Index(name = "idx_adresse_membre", columnList = "membre_id"),
-    @Index(name = "idx_adresse_evenement", columnList = "evenement_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Adresse extends BaseEntity {
-
-  /** Type d'adresse (code depuis types_reference) */
-  @Column(name = "type_adresse", nullable = false, length = 50)
-  private String typeAdresse;
-
-  /** Adresse complète */
-  @Column(name = "adresse", length = 500)
-  private String adresse;
-
-  /** Complément d'adresse */
-  @Column(name = "complement_adresse", length = 200)
-  private String complementAdresse;
-
-  /** Code postal */
-  @Column(name = "code_postal", length = 20)
-  private String codePostal;
-
-  /** Ville */
-  @Column(name = "ville", length = 100)
-  private String ville;
-
-  /** Région */
-  @Column(name = "region", length = 100)
-  private String region;
-
-  /** Pays */
-  @Column(name = "pays", length = 100)
-  private String pays;
-
-  /** Coordonnées géographiques - Latitude */
-  @DecimalMin(value = "-90.0", message = "La latitude doit être comprise entre -90 et 90")
-  @DecimalMax(value = "90.0", message = "La latitude doit être comprise entre -90 et 90")
-  @Digits(integer = 3, fraction = 6)
-  @Column(name = "latitude", precision = 9, scale = 6)
-  private BigDecimal latitude;
-
-  /** Coordonnées géographiques - Longitude */
-  @DecimalMin(value = "-180.0", message = "La longitude doit être comprise entre -180 et 180")
-  @DecimalMax(value = "180.0", message = "La longitude doit être comprise entre -180 et 180")
-  @Digits(integer = 3, fraction = 6)
-  @Column(name = "longitude", precision = 9, scale = 6)
-  private BigDecimal longitude;
-
-  /** Adresse principale (une seule par entité) */
-  @Builder.Default
-  @Column(name = "principale", nullable = false)
-  private Boolean principale = false;
-
-  /** Libellé personnalisé */
-  @Column(name = "libelle", length = 100)
-  private String libelle;
-
-  /** Notes et commentaires */
-  @Column(name = "notes", length = 500)
-  private String notes;
-
-  // Relations
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id")
-  private Organisation organisation;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "membre_id")
-  private Membre membre;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "evenement_id")
-  private Evenement evenement;
-
-  /** Méthode métier pour obtenir l'adresse complète formatée */
-  public String getAdresseComplete() {
-    StringBuilder sb = new StringBuilder();
-    if (adresse != null && !adresse.isEmpty()) {
-      sb.append(adresse);
-    }
-    if (complementAdresse != null && !complementAdresse.isEmpty()) {
-      if (sb.length() > 0)
-        sb.append(", ");
-      sb.append(complementAdresse);
-    }
-    if (codePostal != null && !codePostal.isEmpty()) {
-      if (sb.length() > 0)
-        sb.append(", ");
-      sb.append(codePostal);
-    }
-    if (ville != null && !ville.isEmpty()) {
-      if (sb.length() > 0)
-        sb.append(" ");
-      sb.append(ville);
-    }
-    if (region != null && !region.isEmpty()) {
-      if (sb.length() > 0)
-        sb.append(", ");
-      sb.append(region);
-    }
-    if (pays != null && !pays.isEmpty()) {
-      if (sb.length() > 0)
-        sb.append(", ");
-      sb.append(pays);
-    }
-    return sb.toString();
-  }
-
-  /** Méthode métier pour vérifier si l'adresse a des coordonnées GPS */
-  public boolean hasCoordinates() {
-    return latitude != null && longitude != null;
-  }
-
-  /** Callback JPA avant la persistance */
-  protected void onCreate() {
-    super.onCreate(); // Appelle le onCreate de BaseEntity
-    if (principale == null) {
-      principale = false;
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Adresse pour la gestion des adresses des organisations, membres et
+ * événements
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(name = "adresses", indexes = {
+    @Index(name = "idx_adresse_ville", columnList = "ville"),
+    @Index(name = "idx_adresse_pays", columnList = "pays"),
+    @Index(name = "idx_adresse_type", columnList = "type_adresse"),
+    @Index(name = "idx_adresse_organisation", columnList = "organisation_id"),
+    @Index(name = "idx_adresse_membre", columnList = "membre_id"),
+    @Index(name = "idx_adresse_evenement", columnList = "evenement_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Adresse extends BaseEntity {
+
+  /** Type d'adresse (code depuis types_reference) */
+  @Column(name = "type_adresse", nullable = false, length = 50)
+  private String typeAdresse;
+
+  /** Adresse complète */
+  @Column(name = "adresse", length = 500)
+  private String adresse;
+
+  /** Complément d'adresse */
+  @Column(name = "complement_adresse", length = 200)
+  private String complementAdresse;
+
+  /** Code postal */
+  @Column(name = "code_postal", length = 20)
+  private String codePostal;
+
+  /** Ville */
+  @Column(name = "ville", length = 100)
+  private String ville;
+
+  /** Région */
+  @Column(name = "region", length = 100)
+  private String region;
+
+  /** Pays */
+  @Column(name = "pays", length = 100)
+  private String pays;
+
+  /** Coordonnées géographiques - Latitude */
+  @DecimalMin(value = "-90.0", message = "La latitude doit être comprise entre -90 et 90")
+  @DecimalMax(value = "90.0", message = "La latitude doit être comprise entre -90 et 90")
+  @Digits(integer = 3, fraction = 6)
+  @Column(name = "latitude", precision = 9, scale = 6)
+  private BigDecimal latitude;
+
+  /** Coordonnées géographiques - Longitude */
+  @DecimalMin(value = "-180.0", message = "La longitude doit être comprise entre -180 et 180")
+  @DecimalMax(value = "180.0", message = "La longitude doit être comprise entre -180 et 180")
+  @Digits(integer = 3, fraction = 6)
+  @Column(name = "longitude", precision = 9, scale = 6)
+  private BigDecimal longitude;
+
+  /** Adresse principale (une seule par entité) */
+  @Builder.Default
+  @Column(name = "principale", nullable = false)
+  private Boolean principale = false;
+
+  /** Libellé personnalisé */
+  @Column(name = "libelle", length = 100)
+  private String libelle;
+
+  /** Notes et commentaires */
+  @Column(name = "notes", length = 500)
+  private String notes;
+
+  // Relations
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_id")
+  private Membre membre;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "evenement_id")
+  private Evenement evenement;
+
+  /** Méthode métier pour obtenir l'adresse complète formatée */
+  public String getAdresseComplete() {
+    StringBuilder sb = new StringBuilder();
+    if (adresse != null && !adresse.isEmpty()) {
+      sb.append(adresse);
+    }
+    if (complementAdresse != null && !complementAdresse.isEmpty()) {
+      if (sb.length() > 0)
+        sb.append(", ");
+      sb.append(complementAdresse);
+    }
+    if (codePostal != null && !codePostal.isEmpty()) {
+      if (sb.length() > 0)
+        sb.append(", ");
+      sb.append(codePostal);
+    }
+    if (ville != null && !ville.isEmpty()) {
+      if (sb.length() > 0)
+        sb.append(" ");
+      sb.append(ville);
+    }
+    if (region != null && !region.isEmpty()) {
+      if (sb.length() > 0)
+        sb.append(", ");
+      sb.append(region);
+    }
+    if (pays != null && !pays.isEmpty()) {
+      if (sb.length() > 0)
+        sb.append(", ");
+      sb.append(pays);
+    }
+    return sb.toString();
+  }
+
+  /** Méthode métier pour vérifier si l'adresse a des coordonnées GPS */
+  public boolean hasCoordinates() {
+    return latitude != null && longitude != null;
+  }
+
+  /** Callback JPA avant la persistance */
+  protected void onCreate() {
+    super.onCreate(); // Appelle le onCreate de BaseEntity
+    if (principale == null) {
+      principale = false;
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/AlertConfiguration.java

@@ -1,113 +1,113 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import lombok.Getter;
-import lombok.Setter;
-
-/**
- * Entité singleton pour la configuration des alertes système.
- * Une seule ligne en base de données.
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-15
- */
-@Entity
-@Table(name = "alert_configuration")
-@Getter
-@Setter
-public class AlertConfiguration extends BaseEntity {
-
-    /**
-     * Alerte CPU activée
-     */
-    @Column(name = "cpu_high_alert_enabled", nullable = false)
-    private Boolean cpuHighAlertEnabled = true;
-
-    /**
-     * Seuil CPU en pourcentage (0-100)
-     */
-    @Column(name = "cpu_threshold_percent", nullable = false)
-    private Integer cpuThresholdPercent = 80;
-
-    /**
-     * Durée en minutes avant déclenchement alerte CPU
-     */
-    @Column(name = "cpu_duration_minutes", nullable = false)
-    private Integer cpuDurationMinutes = 5;
-
-    /**
-     * Alerte mémoire faible activée
-     */
-    @Column(name = "memory_low_alert_enabled", nullable = false)
-    private Boolean memoryLowAlertEnabled = true;
-
-    /**
-     * Seuil mémoire en pourcentage (0-100)
-     */
-    @Column(name = "memory_threshold_percent", nullable = false)
-    private Integer memoryThresholdPercent = 85;
-
-    /**
-     * Alerte erreur critique activée
-     */
-    @Column(name = "critical_error_alert_enabled", nullable = false)
-    private Boolean criticalErrorAlertEnabled = true;
-
-    /**
-     * Alerte erreur activée
-     */
-    @Column(name = "error_alert_enabled", nullable = false)
-    private Boolean errorAlertEnabled = true;
-
-    /**
-     * Alerte échec de connexion activée
-     */
-    @Column(name = "connection_failure_alert_enabled", nullable = false)
-    private Boolean connectionFailureAlertEnabled = true;
-
-    /**
-     * Seuil d'échecs de connexion
-     */
-    @Column(name = "connection_failure_threshold", nullable = false)
-    private Integer connectionFailureThreshold = 100;
-
-    /**
-     * Fenêtre temporelle en minutes pour les échecs de connexion
-     */
-    @Column(name = "connection_failure_window_minutes", nullable = false)
-    private Integer connectionFailureWindowMinutes = 5;
-
-    /**
-     * Notifications par email activées
-     */
-    @Column(name = "email_notifications_enabled", nullable = false)
-    private Boolean emailNotificationsEnabled = true;
-
-    /**
-     * Notifications push activées
-     */
-    @Column(name = "push_notifications_enabled", nullable = false)
-    private Boolean pushNotificationsEnabled = false;
-
-    /**
-     * Notifications SMS activées
-     */
-    @Column(name = "sms_notifications_enabled", nullable = false)
-    private Boolean smsNotificationsEnabled = false;
-
-    /**
-     * Liste des emails destinataires des alertes (séparés par virgule)
-     */
-    @Column(name = "alert_email_recipients", length = 1000)
-    private String alertEmailRecipients = "admin@unionflow.test";
-
-    /**
-     * S'assurer qu'il n'y a qu'une seule configuration
-     */
-    @PrePersist
-    @PreUpdate
-    protected void ensureSingleton() {
-        // La logique singleton sera gérée par le repository
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Entité singleton pour la configuration des alertes système.
+ * Une seule ligne en base de données.
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-15
+ */
+@Entity
+@Table(name = "alert_configuration")
+@Getter
+@Setter
+public class AlertConfiguration extends BaseEntity {
+
+    /**
+     * Alerte CPU activée
+     */
+    @Column(name = "cpu_high_alert_enabled", nullable = false)
+    private Boolean cpuHighAlertEnabled = true;
+
+    /**
+     * Seuil CPU en pourcentage (0-100)
+     */
+    @Column(name = "cpu_threshold_percent", nullable = false)
+    private Integer cpuThresholdPercent = 80;
+
+    /**
+     * Durée en minutes avant déclenchement alerte CPU
+     */
+    @Column(name = "cpu_duration_minutes", nullable = false)
+    private Integer cpuDurationMinutes = 5;
+
+    /**
+     * Alerte mémoire faible activée
+     */
+    @Column(name = "memory_low_alert_enabled", nullable = false)
+    private Boolean memoryLowAlertEnabled = true;
+
+    /**
+     * Seuil mémoire en pourcentage (0-100)
+     */
+    @Column(name = "memory_threshold_percent", nullable = false)
+    private Integer memoryThresholdPercent = 85;
+
+    /**
+     * Alerte erreur critique activée
+     */
+    @Column(name = "critical_error_alert_enabled", nullable = false)
+    private Boolean criticalErrorAlertEnabled = true;
+
+    /**
+     * Alerte erreur activée
+     */
+    @Column(name = "error_alert_enabled", nullable = false)
+    private Boolean errorAlertEnabled = true;
+
+    /**
+     * Alerte échec de connexion activée
+     */
+    @Column(name = "connection_failure_alert_enabled", nullable = false)
+    private Boolean connectionFailureAlertEnabled = true;
+
+    /**
+     * Seuil d'échecs de connexion
+     */
+    @Column(name = "connection_failure_threshold", nullable = false)
+    private Integer connectionFailureThreshold = 100;
+
+    /**
+     * Fenêtre temporelle en minutes pour les échecs de connexion
+     */
+    @Column(name = "connection_failure_window_minutes", nullable = false)
+    private Integer connectionFailureWindowMinutes = 5;
+
+    /**
+     * Notifications par email activées
+     */
+    @Column(name = "email_notifications_enabled", nullable = false)
+    private Boolean emailNotificationsEnabled = true;
+
+    /**
+     * Notifications push activées
+     */
+    @Column(name = "push_notifications_enabled", nullable = false)
+    private Boolean pushNotificationsEnabled = false;
+
+    /**
+     * Notifications SMS activées
+     */
+    @Column(name = "sms_notifications_enabled", nullable = false)
+    private Boolean smsNotificationsEnabled = false;
+
+    /**
+     * Liste des emails destinataires des alertes (séparés par virgule)
+     */
+    @Column(name = "alert_email_recipients", length = 1000)
+    private String alertEmailRecipients = "admin@unionflow.test";
+
+    /**
+     * S'assurer qu'il n'y a qu'une seule configuration
+     */
+    @PrePersist
+    @PreUpdate
+    protected void ensureSingleton() {
+        // La logique singleton sera gérée par le repository
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/AlerteLcbFt.java

@@ -1,124 +1,124 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-import java.util.UUID;
-
-/**
- * Entité représentant une alerte LCB-FT (Lutte Contre le Blanchiment et Financement du Terrorisme).
- * Les alertes sont générées automatiquement lors de transactions dépassant les seuils configurés.
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-15
- */
-@Entity
-@Table(name = "alertes_lcb_ft", indexes = {
-    @Index(name = "idx_alerte_lcb_ft_organisation", columnList = "organisation_id"),
-    @Index(name = "idx_alerte_lcb_ft_type", columnList = "type_alerte"),
-    @Index(name = "idx_alerte_lcb_ft_date", columnList = "date_alerte"),
-    @Index(name = "idx_alerte_lcb_ft_traitee", columnList = "traitee")
-})
-@Getter
-@Setter
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-public class AlerteLcbFt extends BaseEntity {
-
-    /**
-     * Organisation concernée par l'alerte
-     */
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    /**
-     * Membre concerné par l'alerte
-     */
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "membre_id")
-    private Membre membre;
-
-    /**
-     * Type d'alerte : SEUIL_DEPASSE, JUSTIFICATION_MANQUANTE, etc.
-     */
-    @Column(name = "type_alerte", nullable = false, length = 50)
-    private String typeAlerte;
-
-    /**
-     * Date et heure de génération de l'alerte
-     */
-    @Column(name = "date_alerte", nullable = false)
-    private LocalDateTime dateAlerte;
-
-    /**
-     * Description de l'alerte
-     */
-    @Column(name = "description", length = 500)
-    private String description;
-
-    /**
-     * Détails supplémentaires (JSON ou texte)
-     */
-    @Column(name = "details", columnDefinition = "TEXT")
-    private String details;
-
-    /**
-     * Montant de la transaction ayant généré l'alerte
-     */
-    @Column(name = "montant", precision = 15, scale = 2)
-    private BigDecimal montant;
-
-    /**
-     * Seuil qui a été dépassé
-     */
-    @Column(name = "seuil", precision = 15, scale = 2)
-    private BigDecimal seuil;
-
-    /**
-     * Type d'opération : DEPOT, RETRAIT, TRANSFERT, etc.
-     */
-    @Column(name = "type_operation", length = 50)
-    private String typeOperation;
-
-    /**
-     * Référence de la transaction concernée (UUID)
-     */
-    @Column(name = "transaction_ref", length = 100)
-    private String transactionRef;
-
-    /**
-     * Niveau de gravité : INFO, WARNING, CRITICAL
-     */
-    @Column(name = "severite", nullable = false, length = 20)
-    private String severite;
-
-    /**
-     * Indique si l'alerte a été traitée
-     */
-    @Builder.Default
-    @Column(name = "traitee", nullable = false)
-    private Boolean traitee = false;
-
-    /**
-     * Date de traitement de l'alerte
-     */
-    @Column(name = "date_traitement")
-    private LocalDateTime dateTraitement;
-
-    /**
-     * Utilisateur ayant traité l'alerte
-     */
-    @Column(name = "traite_par")
-    private UUID traitePar;
-
-    /**
-     * Commentaire sur le traitement
-     */
-    @Column(name = "commentaire_traitement", columnDefinition = "TEXT")
-    private String commentaireTraitement;
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+/**
+ * Entité représentant une alerte LCB-FT (Lutte Contre le Blanchiment et Financement du Terrorisme).
+ * Les alertes sont générées automatiquement lors de transactions dépassant les seuils configurés.
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-15
+ */
+@Entity
+@Table(name = "alertes_lcb_ft", indexes = {
+    @Index(name = "idx_alerte_lcb_ft_organisation", columnList = "organisation_id"),
+    @Index(name = "idx_alerte_lcb_ft_type", columnList = "type_alerte"),
+    @Index(name = "idx_alerte_lcb_ft_date", columnList = "date_alerte"),
+    @Index(name = "idx_alerte_lcb_ft_traitee", columnList = "traitee")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AlerteLcbFt extends BaseEntity {
+
+    /**
+     * Organisation concernée par l'alerte
+     */
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    /**
+     * Membre concerné par l'alerte
+     */
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "membre_id")
+    private Membre membre;
+
+    /**
+     * Type d'alerte : SEUIL_DEPASSE, JUSTIFICATION_MANQUANTE, etc.
+     */
+    @Column(name = "type_alerte", nullable = false, length = 50)
+    private String typeAlerte;
+
+    /**
+     * Date et heure de génération de l'alerte
+     */
+    @Column(name = "date_alerte", nullable = false)
+    private LocalDateTime dateAlerte;
+
+    /**
+     * Description de l'alerte
+     */
+    @Column(name = "description", length = 500)
+    private String description;
+
+    /**
+     * Détails supplémentaires (JSON ou texte)
+     */
+    @Column(name = "details", columnDefinition = "TEXT")
+    private String details;
+
+    /**
+     * Montant de la transaction ayant généré l'alerte
+     */
+    @Column(name = "montant", precision = 15, scale = 2)
+    private BigDecimal montant;
+
+    /**
+     * Seuil qui a été dépassé
+     */
+    @Column(name = "seuil", precision = 15, scale = 2)
+    private BigDecimal seuil;
+
+    /**
+     * Type d'opération : DEPOT, RETRAIT, TRANSFERT, etc.
+     */
+    @Column(name = "type_operation", length = 50)
+    private String typeOperation;
+
+    /**
+     * Référence de la transaction concernée (UUID)
+     */
+    @Column(name = "transaction_ref", length = 100)
+    private String transactionRef;
+
+    /**
+     * Niveau de gravité : INFO, WARNING, CRITICAL
+     */
+    @Column(name = "severite", nullable = false, length = 20)
+    private String severite;
+
+    /**
+     * Indique si l'alerte a été traitée
+     */
+    @Builder.Default
+    @Column(name = "traitee", nullable = false)
+    private Boolean traitee = false;
+
+    /**
+     * Date de traitement de l'alerte
+     */
+    @Column(name = "date_traitement")
+    private LocalDateTime dateTraitement;
+
+    /**
+     * Utilisateur ayant traité l'alerte
+     */
+    @Column(name = "traite_par")
+    private UUID traitePar;
+
+    /**
+     * Commentaire sur le traitement
+     */
+    @Column(name = "commentaire_traitement", columnDefinition = "TEXT")
+    private String commentaireTraitement;
+}

src/main/java/dev/lions/unionflow/server/entity/ApproverAction.java

@@ -1,94 +1,94 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.time.LocalDateTime;
-import java.util.UUID;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Action d'Approbateur
- *
- * Représente l'action (approve/reject) d'un approbateur sur une demande d'approbation.
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-13
- */
-@Entity
-@Table(name = "approver_actions", indexes = {
-    @Index(name = "idx_approver_action_approval", columnList = "approval_id"),
-    @Index(name = "idx_approver_action_approver", columnList = "approver_id"),
-    @Index(name = "idx_approver_action_decision", columnList = "decision"),
-    @Index(name = "idx_approver_action_decided_at", columnList = "decided_at")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ApproverAction extends BaseEntity {
-
-    /** Approbation parente */
-    @NotNull
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "approval_id", nullable = false)
-    private TransactionApproval approval;
-
-    /** ID de l'approbateur (membre) */
-    @NotNull
-    @Column(name = "approver_id", nullable = false)
-    private UUID approverId;
-
-    /** Nom complet de l'approbateur (cache) */
-    @NotBlank
-    @Column(name = "approver_name", nullable = false, length = 200)
-    private String approverName;
-
-    /** Rôle de l'approbateur au moment de l'action */
-    @NotBlank
-    @Column(name = "approver_role", nullable = false, length = 50)
-    private String approverRole;
-
-    /** Décision (PENDING, APPROVED, REJECTED) */
-    @NotBlank
-    @Pattern(regexp = "^(PENDING|APPROVED|REJECTED)$")
-    @Builder.Default
-    @Column(name = "decision", nullable = false, length = 10)
-    private String decision = "PENDING";
-
-    /** Commentaire optionnel */
-    @Size(max = 1000)
-    @Column(name = "comment", length = 1000)
-    private String comment;
-
-    /** Date de la décision */
-    @Column(name = "decided_at")
-    private LocalDateTime decidedAt;
-
-    @PrePersist
-    protected void onCreate() {
-        super.onCreate();
-        if (decision == null) {
-            decision = "PENDING";
-        }
-    }
-
-    /** Méthode métier pour approuver avec commentaire */
-    public void approve(String comment) {
-        this.decision = "APPROVED";
-        this.comment = comment;
-        this.decidedAt = LocalDateTime.now();
-    }
-
-    /** Méthode métier pour rejeter avec raison */
-    public void reject(String reason) {
-        this.decision = "REJECTED";
-        this.comment = reason;
-        this.decidedAt = LocalDateTime.now();
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Action d'Approbateur
+ *
+ * Représente l'action (approve/reject) d'un approbateur sur une demande d'approbation.
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-13
+ */
+@Entity
+@Table(name = "approver_actions", indexes = {
+    @Index(name = "idx_approver_action_approval", columnList = "approval_id"),
+    @Index(name = "idx_approver_action_approver", columnList = "approver_id"),
+    @Index(name = "idx_approver_action_decision", columnList = "decision"),
+    @Index(name = "idx_approver_action_decided_at", columnList = "decided_at")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ApproverAction extends BaseEntity {
+
+    /** Approbation parente */
+    @NotNull
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "approval_id", nullable = false)
+    private TransactionApproval approval;
+
+    /** ID de l'approbateur (membre) */
+    @NotNull
+    @Column(name = "approver_id", nullable = false)
+    private UUID approverId;
+
+    /** Nom complet de l'approbateur (cache) */
+    @NotBlank
+    @Column(name = "approver_name", nullable = false, length = 200)
+    private String approverName;
+
+    /** Rôle de l'approbateur au moment de l'action */
+    @NotBlank
+    @Column(name = "approver_role", nullable = false, length = 50)
+    private String approverRole;
+
+    /** Décision (PENDING, APPROVED, REJECTED) */
+    @NotBlank
+    @Pattern(regexp = "^(PENDING|APPROVED|REJECTED)$")
+    @Builder.Default
+    @Column(name = "decision", nullable = false, length = 10)
+    private String decision = "PENDING";
+
+    /** Commentaire optionnel */
+    @Size(max = 1000)
+    @Column(name = "comment", length = 1000)
+    private String comment;
+
+    /** Date de la décision */
+    @Column(name = "decided_at")
+    private LocalDateTime decidedAt;
+
+    @PrePersist
+    protected void onCreate() {
+        super.onCreate();
+        if (decision == null) {
+            decision = "PENDING";
+        }
+    }
+
+    /** Méthode métier pour approuver avec commentaire */
+    public void approve(String comment) {
+        this.decision = "APPROVED";
+        this.comment = comment;
+        this.decidedAt = LocalDateTime.now();
+    }
+
+    /** Méthode métier pour rejeter avec raison */
+    public void reject(String reason) {
+        this.decision = "REJECTED";
+        this.comment = reason;
+        this.decidedAt = LocalDateTime.now();
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/AuditLog.java

@@ -1,99 +1,99 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.audit.PorteeAudit;
-import jakarta.persistence.*;
-import java.time.LocalDateTime;
-import lombok.Getter;
-import lombok.Setter;
-
-/**
- * Entité pour les logs d'audit
- * Enregistre toutes les actions importantes du système
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2025-01-17
- */
-@Entity
-@Table(name = "audit_logs", indexes = {
-    @Index(name = "idx_audit_date_heure", columnList = "date_heure"),
-    @Index(name = "idx_audit_utilisateur", columnList = "utilisateur"),
-    @Index(name = "idx_audit_module", columnList = "module"),
-    @Index(name = "idx_audit_type_action", columnList = "type_action"),
-    @Index(name = "idx_audit_severite", columnList = "severite")
-})
-@Getter
-@Setter
-public class AuditLog extends BaseEntity {
-    
-    @Column(name = "type_action", nullable = false, length = 50)
-    private String typeAction;
-    
-    @Column(name = "severite", nullable = false, length = 20)
-    private String severite;
-    
-    @Column(name = "utilisateur", length = 255)
-    private String utilisateur;
-    
-    @Column(name = "role", length = 50)
-    private String role;
-    
-    @Column(name = "module", length = 50)
-    private String module;
-    
-    @Column(name = "description", length = 500)
-    private String description;
-    
-    @Column(name = "details", columnDefinition = "TEXT")
-    private String details;
-    
-    @Column(name = "ip_address", length = 45)
-    private String ipAddress;
-    
-    @Column(name = "user_agent", length = 500)
-    private String userAgent;
-    
-    @Column(name = "session_id", length = 255)
-    private String sessionId;
-    
-    @Column(name = "date_heure", nullable = false)
-    private LocalDateTime dateHeure;
-    
-    @Column(name = "donnees_avant", columnDefinition = "TEXT")
-    private String donneesAvant;
-    
-    @Column(name = "donnees_apres", columnDefinition = "TEXT")
-    private String donneesApres;
-    
-    @Column(name = "entite_id", length = 255)
-    private String entiteId;
-    
-    @Column(name = "entite_type", length = 100)
-    private String entiteType;
-
-    /**
-     * Organisation concernée par cet événement d'audit.
-     * NULL pour les événements de portée PLATEFORME.
-     */
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id")
-    private Organisation organisation;
-
-    /**
-     * Portée de visibilité :
-     * ORGANISATION = visible par le manager de l'organisation
-     * PLATEFORME = visible uniquement par le Super Admin UnionFlow
-     */
-    @Enumerated(EnumType.STRING)
-    @Column(name = "portee", nullable = false, length = 15)
-    private PorteeAudit portee = PorteeAudit.PLATEFORME;
-
-    @PrePersist
-    protected void onCreate() {
-        super.onCreate();
-        if (dateHeure == null) {
-            dateHeure = LocalDateTime.now();
-        }
-    }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.audit.PorteeAudit;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Entité pour les logs d'audit
+ * Enregistre toutes les actions importantes du système
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2025-01-17
+ */
+@Entity
+@Table(name = "audit_logs", indexes = {
+    @Index(name = "idx_audit_date_heure", columnList = "date_heure"),
+    @Index(name = "idx_audit_utilisateur", columnList = "utilisateur"),
+    @Index(name = "idx_audit_module", columnList = "module"),
+    @Index(name = "idx_audit_type_action", columnList = "type_action"),
+    @Index(name = "idx_audit_severite", columnList = "severite")
+})
+@Getter
+@Setter
+public class AuditLog extends BaseEntity {
+    
+    @Column(name = "type_action", nullable = false, length = 50)
+    private String typeAction;
+    
+    @Column(name = "severite", nullable = false, length = 20)
+    private String severite;
+    
+    @Column(name = "utilisateur", length = 255)
+    private String utilisateur;
+    
+    @Column(name = "role", length = 50)
+    private String role;
+    
+    @Column(name = "module", length = 50)
+    private String module;
+    
+    @Column(name = "description", length = 500)
+    private String description;
+    
+    @Column(name = "details", columnDefinition = "TEXT")
+    private String details;
+    
+    @Column(name = "ip_address", length = 45)
+    private String ipAddress;
+    
+    @Column(name = "user_agent", length = 500)
+    private String userAgent;
+    
+    @Column(name = "session_id", length = 255)
+    private String sessionId;
+    
+    @Column(name = "date_heure", nullable = false)
+    private LocalDateTime dateHeure;
+    
+    @Column(name = "donnees_avant", columnDefinition = "TEXT")
+    private String donneesAvant;
+    
+    @Column(name = "donnees_apres", columnDefinition = "TEXT")
+    private String donneesApres;
+    
+    @Column(name = "entite_id", length = 255)
+    private String entiteId;
+    
+    @Column(name = "entite_type", length = 100)
+    private String entiteType;
+
+    /**
+     * Organisation concernée par cet événement d'audit.
+     * NULL pour les événements de portée PLATEFORME.
+     */
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id")
+    private Organisation organisation;
+
+    /**
+     * Portée de visibilité :
+     * ORGANISATION = visible par le manager de l'organisation
+     * PLATEFORME = visible uniquement par le Super Admin UnionFlow
+     */
+    @Enumerated(EnumType.STRING)
+    @Column(name = "portee", nullable = false, length = 15)
+    private PorteeAudit portee = PorteeAudit.PLATEFORME;
+
+    @PrePersist
+    protected void onCreate() {
+        super.onCreate();
+        if (dateHeure == null) {
+            dateHeure = LocalDateTime.now();
+        }
+    }
+}
+

src/main/java/dev/lions/unionflow/server/entity/AuditTrailOperation.java

@@ -0,0 +1,104 @@
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.hibernate.annotations.JdbcTypeCode;
+import org.hibernate.type.SqlTypes;
+
+/**
+ * Entrée d'audit trail enrichi (SYSCOHADA + AUDSCGIE OHADA).
+ *
+ * <p>Trace les opérations financières, le lifecycle membres, les changements de configuration,
+ * avec le contexte multi-org (rôle actif + organisation active) + vérifications de séparation des
+ * pouvoirs (SoD).
+ *
+ * <p>Cette entité ne dérive PAS de {@link BaseEntity} car elle représente un enregistrement
+ * immuable d'historique : ses propres champs d'audit ({@code operationAt}, {@code userId}) sont
+ * la donnée à tracer.
+ *
+ * @since 2026-04-25 — exigences SYSCOHADA + Instruction BCEAO 003-03-2025 (audit KYC)
+ */
+@Entity
+@Table(name = "audit_trail_operations")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AuditTrailOperation {
+
+  @Id
+  @GeneratedValue(strategy = GenerationType.UUID)
+  @Column(name = "id", updatable = false, nullable = false)
+  private UUID id;
+
+  // Acteur
+  @NotNull
+  @Column(name = "user_id", nullable = false)
+  private UUID userId;
+
+  @Column(name = "user_email", length = 255)
+  private String userEmail;
+
+  @Column(name = "role_actif", length = 50)
+  private String roleActif;
+
+  @Column(name = "organisation_active_id")
+  private UUID organisationActiveId;
+
+  // Action
+  @NotBlank
+  @Column(name = "action_type", nullable = false, length = 50)
+  private String actionType;
+
+  @NotBlank
+  @Column(name = "entity_type", nullable = false, length = 100)
+  private String entityType;
+
+  @Column(name = "entity_id")
+  private UUID entityId;
+
+  @Column(name = "description", length = 500)
+  private String description;
+
+  // Contexte
+  @Column(name = "ip_address", length = 45)
+  private String ipAddress;
+
+  @Column(name = "user_agent", length = 500)
+  private String userAgent;
+
+  @Column(name = "request_id")
+  private UUID requestId;
+
+  // Données (JSONB)
+  @JdbcTypeCode(SqlTypes.JSON)
+  @Column(name = "payload_avant", columnDefinition = "jsonb")
+  private String payloadAvant;
+
+  @JdbcTypeCode(SqlTypes.JSON)
+  @Column(name = "payload_apres", columnDefinition = "jsonb")
+  private String payloadApres;
+
+  @JdbcTypeCode(SqlTypes.JSON)
+  @Column(name = "metadata", columnDefinition = "jsonb")
+  private String metadata;
+
+  // SoD
+  @Column(name = "sod_check_passed")
+  private Boolean sodCheckPassed;
+
+  @Column(name = "sod_violations", length = 500)
+  private String sodViolations;
+
+  @NotNull
+  @Column(name = "operation_at", nullable = false)
+  @Builder.Default
+  private LocalDateTime operationAt = LocalDateTime.now();
+}

src/main/java/dev/lions/unionflow/server/entity/AyantDroit.java

@@ -1,95 +1,95 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.ayantdroit.LienParente;
-import dev.lions.unionflow.server.api.enums.ayantdroit.StatutAyantDroit;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.time.LocalDate;
-import java.math.BigDecimal;
-import lombok.*;
-
-/**
- * Ayant droit d'un membre dans une mutuelle de santé.
- *
- * <p>
- * Permet la gestion des bénéficiaires (conjoint, enfants, parents) pour
- * les conventions avec les centres de santé partenaires et les plafonds
- * annuels.
- *
- * <p>
- * Table : {@code ayants_droit}
- */
-@Entity
-@Table(name = "ayants_droit", indexes = {
-    @Index(name = "idx_ad_membre_org", columnList = "membre_organisation_id"),
-    @Index(name = "idx_ad_couverture", columnList = "date_debut_couverture, date_fin_couverture")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class AyantDroit extends BaseEntity {
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "membre_organisation_id", nullable = false)
-  private MembreOrganisation membreOrganisation;
-
-  @NotBlank
-  @Column(name = "prenom", nullable = false, length = 100)
-  private String prenom;
-
-  @NotBlank
-  @Column(name = "nom", nullable = false, length = 100)
-  private String nom;
-
-  @Column(name = "date_naissance")
-  private LocalDate dateNaissance;
-
-  @Enumerated(EnumType.STRING)
-  @NotNull
-  @Column(name = "lien_parente", nullable = false, length = 20)
-  private LienParente lienParente;
-
-  /** Numéro attribué pour les conventions santé avec les centres partenaires */
-  @Column(name = "numero_beneficiaire", length = 50)
-  private String numeroBeneficiaire;
-
-  @Column(name = "date_debut_couverture")
-  private LocalDate dateDebutCouverture;
-
-  /** NULL = couverture ouverte */
-  @Column(name = "date_fin_couverture")
-  private LocalDate dateFinCouverture;
-
-  @Column(name = "sexe", length = 20)
-  private String sexe;
-
-  @Column(name = "piece_identite", length = 100)
-  private String pieceIdentite;
-
-  @Column(name = "pourcentage_couverture", precision = 5, scale = 2)
-  private BigDecimal pourcentageCouvertureSante;
-
-  @NotNull
-  @Enumerated(EnumType.STRING)
-  @Column(name = "statut", nullable = false, length = 50)
-  @Builder.Default
-  private StatutAyantDroit statut = StatutAyantDroit.EN_ATTENTE;
-
-  // ── Méthodes métier ────────────────────────────────────────────────────────
-
-  public boolean isCouvertAujourdhui() {
-    LocalDate today = LocalDate.now();
-    if (dateDebutCouverture != null && today.isBefore(dateDebutCouverture))
-      return false;
-    if (dateFinCouverture != null && today.isAfter(dateFinCouverture))
-      return false;
-    return Boolean.TRUE.equals(getActif());
-  }
-
-  public String getNomComplet() {
-    return prenom + " " + nom;
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.ayantdroit.LienParente;
+import dev.lions.unionflow.server.api.enums.ayantdroit.StatutAyantDroit;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.time.LocalDate;
+import java.math.BigDecimal;
+import lombok.*;
+
+/**
+ * Ayant droit d'un membre dans une mutuelle de santé.
+ *
+ * <p>
+ * Permet la gestion des bénéficiaires (conjoint, enfants, parents) pour
+ * les conventions avec les centres de santé partenaires et les plafonds
+ * annuels.
+ *
+ * <p>
+ * Table : {@code ayants_droit}
+ */
+@Entity
+@Table(name = "ayants_droit", indexes = {
+    @Index(name = "idx_ad_membre_org", columnList = "membre_organisation_id"),
+    @Index(name = "idx_ad_couverture", columnList = "date_debut_couverture, date_fin_couverture")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class AyantDroit extends BaseEntity {
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_organisation_id", nullable = false)
+  private MembreOrganisation membreOrganisation;
+
+  @NotBlank
+  @Column(name = "prenom", nullable = false, length = 100)
+  private String prenom;
+
+  @NotBlank
+  @Column(name = "nom", nullable = false, length = 100)
+  private String nom;
+
+  @Column(name = "date_naissance")
+  private LocalDate dateNaissance;
+
+  @Enumerated(EnumType.STRING)
+  @NotNull
+  @Column(name = "lien_parente", nullable = false, length = 20)
+  private LienParente lienParente;
+
+  /** Numéro attribué pour les conventions santé avec les centres partenaires */
+  @Column(name = "numero_beneficiaire", length = 50)
+  private String numeroBeneficiaire;
+
+  @Column(name = "date_debut_couverture")
+  private LocalDate dateDebutCouverture;
+
+  /** NULL = couverture ouverte */
+  @Column(name = "date_fin_couverture")
+  private LocalDate dateFinCouverture;
+
+  @Column(name = "sexe", length = 20)
+  private String sexe;
+
+  @Column(name = "piece_identite", length = 100)
+  private String pieceIdentite;
+
+  @Column(name = "pourcentage_couverture", precision = 5, scale = 2)
+  private BigDecimal pourcentageCouvertureSante;
+
+  @NotNull
+  @Enumerated(EnumType.STRING)
+  @Column(name = "statut", nullable = false, length = 50)
+  @Builder.Default
+  private StatutAyantDroit statut = StatutAyantDroit.EN_ATTENTE;
+
+  // ── Méthodes métier ────────────────────────────────────────────────────────
+
+  public boolean isCouvertAujourdhui() {
+    LocalDate today = LocalDate.now();
+    if (dateDebutCouverture != null && today.isBefore(dateDebutCouverture))
+      return false;
+    if (dateFinCouverture != null && today.isAfter(dateFinCouverture))
+      return false;
+    return Boolean.TRUE.equals(getActif());
+  }
+
+  public String getNomComplet() {
+    return prenom + " " + nom;
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/BaseEntity.java

@@ -1,101 +1,101 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.entity.listener.AuditEntityListener;
-import io.quarkus.hibernate.orm.panache.PanacheEntityBase;
-import jakarta.persistence.Column;
-import jakarta.persistence.EntityListeners;
-import jakarta.persistence.GeneratedValue;
-import jakarta.persistence.GenerationType;
-import jakarta.persistence.Id;
-import jakarta.persistence.MappedSuperclass;
-import jakarta.persistence.PrePersist;
-import jakarta.persistence.PreUpdate;
-import jakarta.persistence.Version;
-import java.time.LocalDateTime;
-import java.util.UUID;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-
-/**
- * Classe de base pour toutes les entités UnionFlow.
- *
- * <p>
- * Étend PanacheEntityBase pour bénéficier du pattern Active Record et résoudre
- * les warnings Hibernate.
- * Fournit les champs communs d'audit et le versioning optimistic.
- *
- * @author UnionFlow Team
- * @version 4.0
- */
-@MappedSuperclass
-@EntityListeners(AuditEntityListener.class)
-@Data
-@EqualsAndHashCode(callSuper = false)
-public abstract class BaseEntity extends PanacheEntityBase {
-
-    /** Identifiant unique auto-généré. */
-    @Id
-    @GeneratedValue(strategy = GenerationType.UUID)
-    @Column(name = "id", updatable = false, nullable = false)
-    private UUID id;
-
-    /**
-     * Date de création.
-     */
-    @Column(name = "date_creation", nullable = false, updatable = false)
-    private LocalDateTime dateCreation;
-
-    /**
-     * Date de dernière modification.
-     */
-    @Column(name = "date_modification")
-    private LocalDateTime dateModification;
-
-    /**
-     * Email de l'utilisateur ayant créé l'entité.
-     */
-    @Column(name = "cree_par", length = 255)
-    private String creePar;
-
-    /**
-     * Email du dernier utilisateur ayant modifié l'entité.
-     */
-    @Column(name = "modifie_par", length = 255)
-    private String modifiePar;
-
-    /** Version pour l'optimistic locking JPA. */
-    @Version
-    @Column(name = "version")
-    private Long version;
-
-    /**
-     * État actif/inactif pour le soft-delete.
-     */
-    @Column(name = "actif", nullable = false)
-    private Boolean actif;
-
-    @PrePersist
-    protected void onCreate() {
-        if (this.dateCreation == null) {
-            this.dateCreation = LocalDateTime.now();
-        }
-        if (this.actif == null) {
-            this.actif = true;
-        }
-    }
-
-    @PreUpdate
-    protected void onUpdate() {
-        this.dateModification = LocalDateTime.now();
-    }
-
-    /**
-     * Marque l'entité comme modifiée par un utilisateur donné.
-     *
-     * @param utilisateur email de l'utilisateur
-     */
-    public void marquerCommeModifie(String utilisateur) {
-        this.dateModification = LocalDateTime.now();
-        this.modifiePar = utilisateur;
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.entity.listener.AuditEntityListener;
+import io.quarkus.hibernate.orm.panache.PanacheEntityBase;
+import jakarta.persistence.Column;
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.MappedSuperclass;
+import jakarta.persistence.PrePersist;
+import jakarta.persistence.PreUpdate;
+import jakarta.persistence.Version;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Classe de base pour toutes les entités UnionFlow.
+ *
+ * <p>
+ * Étend PanacheEntityBase pour bénéficier du pattern Active Record et résoudre
+ * les warnings Hibernate.
+ * Fournit les champs communs d'audit et le versioning optimistic.
+ *
+ * @author UnionFlow Team
+ * @version 4.0
+ */
+@MappedSuperclass
+@EntityListeners(AuditEntityListener.class)
+@Data
+@EqualsAndHashCode(callSuper = false)
+public abstract class BaseEntity extends PanacheEntityBase {
+
+    /** Identifiant unique auto-généré. */
+    @Id
+    @GeneratedValue(strategy = GenerationType.UUID)
+    @Column(name = "id", updatable = false, nullable = false)
+    private UUID id;
+
+    /**
+     * Date de création.
+     */
+    @Column(name = "date_creation", nullable = false, updatable = false)
+    private LocalDateTime dateCreation;
+
+    /**
+     * Date de dernière modification.
+     */
+    @Column(name = "date_modification")
+    private LocalDateTime dateModification;
+
+    /**
+     * Email de l'utilisateur ayant créé l'entité.
+     */
+    @Column(name = "cree_par", length = 255)
+    private String creePar;
+
+    /**
+     * Email du dernier utilisateur ayant modifié l'entité.
+     */
+    @Column(name = "modifie_par", length = 255)
+    private String modifiePar;
+
+    /** Version pour l'optimistic locking JPA. */
+    @Version
+    @Column(name = "version")
+    private Long version;
+
+    /**
+     * État actif/inactif pour le soft-delete.
+     */
+    @Column(name = "actif", nullable = false)
+    private Boolean actif;
+
+    @PrePersist
+    protected void onCreate() {
+        if (this.dateCreation == null) {
+            this.dateCreation = LocalDateTime.now();
+        }
+        if (this.actif == null) {
+            this.actif = true;
+        }
+    }
+
+    @PreUpdate
+    protected void onUpdate() {
+        this.dateModification = LocalDateTime.now();
+    }
+
+    /**
+     * Marque l'entité comme modifiée par un utilisateur donné.
+     *
+     * @param utilisateur email de l'utilisateur
+     */
+    public void marquerCommeModifie(String utilisateur) {
+        this.dateModification = LocalDateTime.now();
+        this.modifiePar = utilisateur;
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/BeneficiaireEffectif.java

@@ -0,0 +1,168 @@
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.membre.TypePieceIdentite;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Bénéficiaire effectif (UBO — Ultimate Beneficial Owner) lié à un dossier KYC.
+ *
+ * <p>Implémente l'obligation introduite par l'<strong>Instruction BCEAO 003-03-2025 du 18 mars
+ * 2025</strong> : identification, vérification et connaissance du client par les institutions
+ * financières — vérification systématique des bénéficiaires effectifs obligatoire (approche par
+ * les risques).
+ *
+ * <p>Un bénéficiaire effectif est, selon la directive UEMOA et le GAFI/FATF, toute personne
+ * physique qui :
+ *
+ * <ul>
+ *   <li>détient au moins <strong>25 %</strong> du capital ou des droits de vote d'une personne
+ *       morale ;
+ *   <li>OU exerce un contrôle effectif (de fait ou de droit) sur la gestion de l'entité ;
+ *   <li>OU est bénéficiaire ultime d'une opération suspecte structurée.
+ * </ul>
+ *
+ * <p>Ces enregistrements doivent être conservés <strong>10 ans</strong> après la clôture de la
+ * relation d'affaires (directive 02/2015/CM/UEMOA).
+ *
+ * @since 2026-04-25 — Instruction BCEAO 003-03-2025 (KYC + UBO)
+ */
+@Entity
+@Table(
+    name = "beneficiaires_effectifs",
+    indexes = {
+      @Index(name = "idx_ubo_kyc_dossier", columnList = "kyc_dossier_id"),
+      @Index(name = "idx_ubo_organisation_cible", columnList = "organisation_cible_id"),
+      @Index(name = "idx_ubo_pays", columnList = "pays_residence")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class BeneficiaireEffectif extends BaseEntity {
+
+  /** Dossier KYC auquel ce bénéficiaire effectif est rattaché. */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "kyc_dossier_id", nullable = false)
+  private KycDossier kycDossier;
+
+  /**
+   * Organisation cible dont cette personne est bénéficiaire effectif (utile en cas de KYC client
+   * personne morale — la chaîne de contrôle UBO peut traverser plusieurs entités).
+   */
+  @Column(name = "organisation_cible_id")
+  private UUID organisationCibleId;
+
+  /** Lien vers le membre UnionFlow correspondant si applicable (UBO interne au système). */
+  @Column(name = "membre_id")
+  private UUID membreId;
+
+  // Identité
+
+  @NotBlank
+  @Column(name = "nom", nullable = false, length = 100)
+  private String nom;
+
+  @NotBlank
+  @Column(name = "prenoms", nullable = false, length = 200)
+  private String prenoms;
+
+  @NotNull
+  @Column(name = "date_naissance", nullable = false)
+  private LocalDate dateNaissance;
+
+  @Column(name = "lieu_naissance", length = 200)
+  private String lieuNaissance;
+
+  @NotBlank
+  @Column(name = "nationalite", nullable = false, length = 3)
+  private String nationalite; // ISO 3166-1 alpha-3
+
+  @Column(name = "pays_residence", length = 3)
+  private String paysResidence;
+
+  // Pièce d'identité
+
+  @Enumerated(EnumType.STRING)
+  @Column(name = "type_piece_identite", length = 30)
+  private TypePieceIdentite typePieceIdentite;
+
+  @Column(name = "numero_piece_identite", length = 50)
+  private String numeroPieceIdentite;
+
+  @Column(name = "date_expiration_piece")
+  private LocalDate dateExpirationPiece;
+
+  // Contrôle
+
+  /**
+   * Pourcentage de détention en capital (0-100). Si {@code >= 25} → UBO direct selon GAFI.
+   * Peut être null si le contrôle est exercé autrement (mandat, accord d'actionnaires).
+   */
+  @DecimalMin("0.00")
+  @DecimalMax("100.00")
+  @Column(name = "pourcentage_capital", precision = 5, scale = 2)
+  private BigDecimal pourcentageCapital;
+
+  /** Pourcentage des droits de vote (0-100). */
+  @DecimalMin("0.00")
+  @DecimalMax("100.00")
+  @Column(name = "pourcentage_droits_vote", precision = 5, scale = 2)
+  private BigDecimal pourcentageDroitsVote;
+
+  /**
+   * Nature du contrôle exercé : DETENTION_CAPITAL, DROITS_VOTE, CONTROLE_DE_FAIT,
+   * BENEFICIAIRE_ULTIME, MANDAT_REPRESENTATION.
+   */
+  @NotBlank
+  @Column(name = "nature_controle", nullable = false, length = 50)
+  private String natureControle;
+
+  // Politique d'exposition (PEP)
+
+  @Column(name = "est_pep", nullable = false)
+  @Builder.Default
+  private boolean estPep = false;
+
+  @Column(name = "pep_categorie", length = 100)
+  private String pepCategorie;
+
+  @Column(name = "pep_pays", length = 3)
+  private String pepPays;
+
+  @Column(name = "pep_fonction", length = 200)
+  private String pepFonction;
+
+  // Sanctions / vigilance
+
+  @Column(name = "presence_listes_sanctions", nullable = false)
+  @Builder.Default
+  private boolean presenceListesSanctions = false;
+
+  @Column(name = "details_listes_sanctions", length = 1000)
+  private String detailsListesSanctions;
+
+  // Vérification
+
+  @Column(name = "verifie_par_id")
+  private UUID verifieParId;
+
+  @Column(name = "date_verification")
+  private java.time.LocalDateTime dateVerification;
+
+  @Column(name = "source_verification", length = 200)
+  private String sourceVerification;
+
+  @Column(name = "notes", length = 2000)
+  private String notes;
+}

src/main/java/dev/lions/unionflow/server/entity/Budget.java

@@ -1,218 +1,218 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.UUID;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Budget
- *
- * Représente un budget prévisionnel (mensuel/trimestriel/annuel) avec suivi de réalisation.
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-13
- */
-@Entity
-@Table(name = "budgets", indexes = {
-    @Index(name = "idx_budget_organisation", columnList = "organisation_id"),
-    @Index(name = "idx_budget_status", columnList = "status"),
-    @Index(name = "idx_budget_period", columnList = "period"),
-    @Index(name = "idx_budget_year_month", columnList = "year, month"),
-    @Index(name = "idx_budget_created_by", columnList = "created_by_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Budget extends BaseEntity {
-
-    /** Nom du budget */
-    @NotBlank
-    @Size(max = 200)
-    @Column(name = "name", nullable = false, length = 200)
-    private String name;
-
-    /** Description optionnelle */
-    @Size(max = 1000)
-    @Column(name = "description", length = 1000)
-    private String description;
-
-    /** Organisation concernée */
-    @NotNull
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    /** Période (MONTHLY, QUARTERLY, SEMIANNUAL, ANNUAL) */
-    @NotBlank
-    @Pattern(regexp = "^(MONTHLY|QUARTERLY|SEMIANNUAL|ANNUAL)$")
-    @Column(name = "period", nullable = false, length = 20)
-    private String period;
-
-    /** Année du budget */
-    @NotNull
-    @Min(value = 2020, message = "L'année doit être >= 2020")
-    @Max(value = 2100, message = "L'année doit être <= 2100")
-    @Column(name = "year", nullable = false)
-    private Integer year;
-
-    /** Mois (1-12) pour budget mensuel, null sinon */
-    @Min(value = 1)
-    @Max(value = 12)
-    @Column(name = "month")
-    private Integer month;
-
-    /** Statut (DRAFT, ACTIVE, CLOSED, CANCELLED) */
-    @NotBlank
-    @Pattern(regexp = "^(DRAFT|ACTIVE|CLOSED|CANCELLED)$")
-    @Builder.Default
-    @Column(name = "status", nullable = false, length = 20)
-    private String status = "DRAFT";
-
-    /** Lignes budgétaires */
-    @OneToMany(mappedBy = "budget", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
-    @Builder.Default
-    private List<BudgetLine> lines = new ArrayList<>();
-
-    /** Total prévu (somme des montants prévus des lignes) */
-    @NotNull
-    @DecimalMin(value = "0.0")
-    @Digits(integer = 14, fraction = 2)
-    @Builder.Default
-    @Column(name = "total_planned", nullable = false, precision = 16, scale = 2)
-    private BigDecimal totalPlanned = BigDecimal.ZERO;
-
-    /** Total réalisé (somme des montants réalisés des lignes) */
-    @DecimalMin(value = "0.0")
-    @Digits(integer = 14, fraction = 2)
-    @Builder.Default
-    @Column(name = "total_realized", nullable = false, precision = 16, scale = 2)
-    private BigDecimal totalRealized = BigDecimal.ZERO;
-
-    /** Code devise ISO 3 lettres */
-    @NotBlank
-    @Pattern(regexp = "^[A-Z]{3}$")
-    @Builder.Default
-    @Column(name = "currency", nullable = false, length = 3)
-    private String currency = "XOF";
-
-    /** ID du créateur du budget */
-    @NotNull
-    @Column(name = "created_by_id", nullable = false)
-    private UUID createdById;
-
-    /** Date de création */
-    @NotNull
-    @Column(name = "created_at_budget", nullable = false)
-    private LocalDateTime createdAtBudget;
-
-    /** Date d'approbation */
-    @Column(name = "approved_at")
-    private LocalDateTime approvedAt;
-
-    /** ID de l'approbateur */
-    @Column(name = "approved_by_id")
-    private UUID approvedById;
-
-    /** Date de début de la période budgétaire */
-    @NotNull
-    @Column(name = "start_date", nullable = false)
-    private LocalDate startDate;
-
-    /** Date de fin de la période budgétaire */
-    @NotNull
-    @Column(name = "end_date", nullable = false)
-    private LocalDate endDate;
-
-    /** Métadonnées additionnelles (JSON) */
-    @Column(name = "metadata", columnDefinition = "TEXT")
-    private String metadata;
-
-    @PrePersist
-    protected void onCreate() {
-        super.onCreate();
-        if (createdAtBudget == null) {
-            createdAtBudget = LocalDateTime.now();
-        }
-        if (currency == null) {
-            currency = "XOF";
-        }
-        if (status == null) {
-            status = "DRAFT";
-        }
-        if (totalPlanned == null) {
-            totalPlanned = BigDecimal.ZERO;
-        }
-        if (totalRealized == null) {
-            totalRealized = BigDecimal.ZERO;
-        }
-    }
-
-    /** Méthode métier pour ajouter une ligne budgétaire */
-    public void addLine(BudgetLine line) {
-        lines.add(line);
-        line.setBudget(this);
-        recalculateTotals();
-    }
-
-    /** Méthode métier pour supprimer une ligne budgétaire */
-    public void removeLine(BudgetLine line) {
-        lines.remove(line);
-        line.setBudget(null);
-        recalculateTotals();
-    }
-
-    /** Méthode métier pour recalculer les totaux */
-    public void recalculateTotals() {
-        this.totalPlanned = lines.stream()
-            .map(BudgetLine::getAmountPlanned)
-            .reduce(BigDecimal.ZERO, BigDecimal::add);
-
-        this.totalRealized = lines.stream()
-            .map(BudgetLine::getAmountRealized)
-            .reduce(BigDecimal.ZERO, BigDecimal::add);
-    }
-
-    /** Méthode métier pour calculer le taux de réalisation (%) */
-    public double getRealizationRate() {
-        if (totalPlanned.compareTo(BigDecimal.ZERO) == 0) {
-            return 0.0;
-        }
-        return totalRealized.divide(totalPlanned, 4, java.math.RoundingMode.HALF_UP)
-            .multiply(new BigDecimal("100"))
-            .doubleValue();
-    }
-
-    /** Méthode métier pour calculer l'écart (réalisé - prévu) */
-    public BigDecimal getVariance() {
-        return totalRealized.subtract(totalPlanned);
-    }
-
-    /** Méthode métier pour vérifier si le budget est dépassé */
-    public boolean isOverBudget() {
-        return totalRealized.compareTo(totalPlanned) > 0;
-    }
-
-    /** Méthode métier pour vérifier si le budget est actif */
-    public boolean isActive() {
-        return "ACTIVE".equals(status);
-    }
-
-    /** Méthode métier pour vérifier si la période est en cours */
-    public boolean isCurrentPeriod() {
-        LocalDate now = LocalDate.now();
-        return !now.isBefore(startDate) && !now.isAfter(endDate);
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Budget
+ *
+ * Représente un budget prévisionnel (mensuel/trimestriel/annuel) avec suivi de réalisation.
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-13
+ */
+@Entity
+@Table(name = "budgets", indexes = {
+    @Index(name = "idx_budget_organisation", columnList = "organisation_id"),
+    @Index(name = "idx_budget_status", columnList = "status"),
+    @Index(name = "idx_budget_period", columnList = "period"),
+    @Index(name = "idx_budget_year_month", columnList = "year, month"),
+    @Index(name = "idx_budget_created_by", columnList = "created_by_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Budget extends BaseEntity {
+
+    /** Nom du budget */
+    @NotBlank
+    @Size(max = 200)
+    @Column(name = "name", nullable = false, length = 200)
+    private String name;
+
+    /** Description optionnelle */
+    @Size(max = 1000)
+    @Column(name = "description", length = 1000)
+    private String description;
+
+    /** Organisation concernée */
+    @NotNull
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    /** Période (MONTHLY, QUARTERLY, SEMIANNUAL, ANNUAL) */
+    @NotBlank
+    @Pattern(regexp = "^(MONTHLY|QUARTERLY|SEMIANNUAL|ANNUAL)$")
+    @Column(name = "period", nullable = false, length = 20)
+    private String period;
+
+    /** Année du budget */
+    @NotNull
+    @Min(value = 2020, message = "L'année doit être >= 2020")
+    @Max(value = 2100, message = "L'année doit être <= 2100")
+    @Column(name = "year", nullable = false)
+    private Integer year;
+
+    /** Mois (1-12) pour budget mensuel, null sinon */
+    @Min(value = 1)
+    @Max(value = 12)
+    @Column(name = "month")
+    private Integer month;
+
+    /** Statut (DRAFT, ACTIVE, CLOSED, CANCELLED) */
+    @NotBlank
+    @Pattern(regexp = "^(DRAFT|ACTIVE|CLOSED|CANCELLED)$")
+    @Builder.Default
+    @Column(name = "status", nullable = false, length = 20)
+    private String status = "DRAFT";
+
+    /** Lignes budgétaires */
+    @OneToMany(mappedBy = "budget", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
+    @Builder.Default
+    private List<BudgetLine> lines = new ArrayList<>();
+
+    /** Total prévu (somme des montants prévus des lignes) */
+    @NotNull
+    @DecimalMin(value = "0.0")
+    @Digits(integer = 14, fraction = 2)
+    @Builder.Default
+    @Column(name = "total_planned", nullable = false, precision = 16, scale = 2)
+    private BigDecimal totalPlanned = BigDecimal.ZERO;
+
+    /** Total réalisé (somme des montants réalisés des lignes) */
+    @DecimalMin(value = "0.0")
+    @Digits(integer = 14, fraction = 2)
+    @Builder.Default
+    @Column(name = "total_realized", nullable = false, precision = 16, scale = 2)
+    private BigDecimal totalRealized = BigDecimal.ZERO;
+
+    /** Code devise ISO 3 lettres */
+    @NotBlank
+    @Pattern(regexp = "^[A-Z]{3}$")
+    @Builder.Default
+    @Column(name = "currency", nullable = false, length = 3)
+    private String currency = "XOF";
+
+    /** ID du créateur du budget */
+    @NotNull
+    @Column(name = "created_by_id", nullable = false)
+    private UUID createdById;
+
+    /** Date de création */
+    @NotNull
+    @Column(name = "created_at_budget", nullable = false)
+    private LocalDateTime createdAtBudget;
+
+    /** Date d'approbation */
+    @Column(name = "approved_at")
+    private LocalDateTime approvedAt;
+
+    /** ID de l'approbateur */
+    @Column(name = "approved_by_id")
+    private UUID approvedById;
+
+    /** Date de début de la période budgétaire */
+    @NotNull
+    @Column(name = "start_date", nullable = false)
+    private LocalDate startDate;
+
+    /** Date de fin de la période budgétaire */
+    @NotNull
+    @Column(name = "end_date", nullable = false)
+    private LocalDate endDate;
+
+    /** Métadonnées additionnelles (JSON) */
+    @Column(name = "metadata", columnDefinition = "TEXT")
+    private String metadata;
+
+    @PrePersist
+    protected void onCreate() {
+        super.onCreate();
+        if (createdAtBudget == null) {
+            createdAtBudget = LocalDateTime.now();
+        }
+        if (currency == null) {
+            currency = "XOF";
+        }
+        if (status == null) {
+            status = "DRAFT";
+        }
+        if (totalPlanned == null) {
+            totalPlanned = BigDecimal.ZERO;
+        }
+        if (totalRealized == null) {
+            totalRealized = BigDecimal.ZERO;
+        }
+    }
+
+    /** Méthode métier pour ajouter une ligne budgétaire */
+    public void addLine(BudgetLine line) {
+        lines.add(line);
+        line.setBudget(this);
+        recalculateTotals();
+    }
+
+    /** Méthode métier pour supprimer une ligne budgétaire */
+    public void removeLine(BudgetLine line) {
+        lines.remove(line);
+        line.setBudget(null);
+        recalculateTotals();
+    }
+
+    /** Méthode métier pour recalculer les totaux */
+    public void recalculateTotals() {
+        this.totalPlanned = lines.stream()
+            .map(BudgetLine::getAmountPlanned)
+            .reduce(BigDecimal.ZERO, BigDecimal::add);
+
+        this.totalRealized = lines.stream()
+            .map(BudgetLine::getAmountRealized)
+            .reduce(BigDecimal.ZERO, BigDecimal::add);
+    }
+
+    /** Méthode métier pour calculer le taux de réalisation (%) */
+    public double getRealizationRate() {
+        if (totalPlanned.compareTo(BigDecimal.ZERO) == 0) {
+            return 0.0;
+        }
+        return totalRealized.divide(totalPlanned, 4, java.math.RoundingMode.HALF_UP)
+            .multiply(new BigDecimal("100"))
+            .doubleValue();
+    }
+
+    /** Méthode métier pour calculer l'écart (réalisé - prévu) */
+    public BigDecimal getVariance() {
+        return totalRealized.subtract(totalPlanned);
+    }
+
+    /** Méthode métier pour vérifier si le budget est dépassé */
+    public boolean isOverBudget() {
+        return totalRealized.compareTo(totalPlanned) > 0;
+    }
+
+    /** Méthode métier pour vérifier si le budget est actif */
+    public boolean isActive() {
+        return "ACTIVE".equals(status);
+    }
+
+    /** Méthode métier pour vérifier si la période est en cours */
+    public boolean isCurrentPeriod() {
+        LocalDate now = LocalDate.now();
+        return !now.isBefore(startDate) && !now.isAfter(endDate);
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/BudgetLine.java

@@ -1,102 +1,102 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Ligne Budgétaire
- *
- * Représente une ligne dans un budget (catégorie de dépense/recette).
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-13
- */
-@Entity
-@Table(name = "budget_lines", indexes = {
-    @Index(name = "idx_budget_line_budget", columnList = "budget_id"),
-    @Index(name = "idx_budget_line_category", columnList = "category")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class BudgetLine extends BaseEntity {
-
-    /** Budget parent */
-    @NotNull
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "budget_id", nullable = false)
-    private Budget budget;
-
-    /** Catégorie (CONTRIBUTIONS, SAVINGS, SOLIDARITY, EVENTS, OPERATIONAL, INVESTMENTS, OTHER) */
-    @NotBlank
-    @Pattern(regexp = "^(CONTRIBUTIONS|SAVINGS|SOLIDARITY|EVENTS|OPERATIONAL|INVESTMENTS|OTHER)$")
-    @Column(name = "category", nullable = false, length = 20)
-    private String category;
-
-    /** Nom de la ligne */
-    @NotBlank
-    @Size(max = 200)
-    @Column(name = "name", nullable = false, length = 200)
-    private String name;
-
-    /** Description optionnelle */
-    @Size(max = 500)
-    @Column(name = "description", length = 500)
-    private String description;
-
-    /** Montant prévu */
-    @NotNull
-    @DecimalMin(value = "0.0")
-    @Digits(integer = 14, fraction = 2)
-    @Column(name = "amount_planned", nullable = false, precision = 16, scale = 2)
-    private BigDecimal amountPlanned;
-
-    /** Montant réalisé */
-    @DecimalMin(value = "0.0")
-    @Digits(integer = 14, fraction = 2)
-    @Builder.Default
-    @Column(name = "amount_realized", nullable = false, precision = 16, scale = 2)
-    private BigDecimal amountRealized = BigDecimal.ZERO;
-
-    /** Notes additionnelles */
-    @Size(max = 1000)
-    @Column(name = "notes", length = 1000)
-    private String notes;
-
-    @PrePersist
-    protected void onCreate() {
-        super.onCreate();
-        if (amountRealized == null) {
-            amountRealized = BigDecimal.ZERO;
-        }
-    }
-
-    /** Méthode métier pour calculer le taux de réalisation (%) */
-    public double getRealizationRate() {
-        if (amountPlanned.compareTo(BigDecimal.ZERO) == 0) {
-            return 0.0;
-        }
-        return amountRealized.divide(amountPlanned, 4, java.math.RoundingMode.HALF_UP)
-            .multiply(new BigDecimal("100"))
-            .doubleValue();
-    }
-
-    /** Méthode métier pour calculer l'écart */
-    public BigDecimal getVariance() {
-        return amountRealized.subtract(amountPlanned);
-    }
-
-    /** Méthode métier pour vérifier si la ligne est dépassée */
-    public boolean isOverBudget() {
-        return amountRealized.compareTo(amountPlanned) > 0;
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Ligne Budgétaire
+ *
+ * Représente une ligne dans un budget (catégorie de dépense/recette).
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-13
+ */
+@Entity
+@Table(name = "budget_lines", indexes = {
+    @Index(name = "idx_budget_line_budget", columnList = "budget_id"),
+    @Index(name = "idx_budget_line_category", columnList = "category")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class BudgetLine extends BaseEntity {
+
+    /** Budget parent */
+    @NotNull
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "budget_id", nullable = false)
+    private Budget budget;
+
+    /** Catégorie (CONTRIBUTIONS, SAVINGS, SOLIDARITY, EVENTS, OPERATIONAL, INVESTMENTS, OTHER) */
+    @NotBlank
+    @Pattern(regexp = "^(CONTRIBUTIONS|SAVINGS|SOLIDARITY|EVENTS|OPERATIONAL|INVESTMENTS|OTHER)$")
+    @Column(name = "category", nullable = false, length = 20)
+    private String category;
+
+    /** Nom de la ligne */
+    @NotBlank
+    @Size(max = 200)
+    @Column(name = "name", nullable = false, length = 200)
+    private String name;
+
+    /** Description optionnelle */
+    @Size(max = 500)
+    @Column(name = "description", length = 500)
+    private String description;
+
+    /** Montant prévu */
+    @NotNull
+    @DecimalMin(value = "0.0")
+    @Digits(integer = 14, fraction = 2)
+    @Column(name = "amount_planned", nullable = false, precision = 16, scale = 2)
+    private BigDecimal amountPlanned;
+
+    /** Montant réalisé */
+    @DecimalMin(value = "0.0")
+    @Digits(integer = 14, fraction = 2)
+    @Builder.Default
+    @Column(name = "amount_realized", nullable = false, precision = 16, scale = 2)
+    private BigDecimal amountRealized = BigDecimal.ZERO;
+
+    /** Notes additionnelles */
+    @Size(max = 1000)
+    @Column(name = "notes", length = 1000)
+    private String notes;
+
+    @PrePersist
+    protected void onCreate() {
+        super.onCreate();
+        if (amountRealized == null) {
+            amountRealized = BigDecimal.ZERO;
+        }
+    }
+
+    /** Méthode métier pour calculer le taux de réalisation (%) */
+    public double getRealizationRate() {
+        if (amountPlanned.compareTo(BigDecimal.ZERO) == 0) {
+            return 0.0;
+        }
+        return amountRealized.divide(amountPlanned, 4, java.math.RoundingMode.HALF_UP)
+            .multiply(new BigDecimal("100"))
+            .doubleValue();
+    }
+
+    /** Méthode métier pour calculer l'écart */
+    public BigDecimal getVariance() {
+        return amountRealized.subtract(amountPlanned);
+    }
+
+    /** Méthode métier pour vérifier si la ligne est dépassée */
+    public boolean isOverBudget() {
+        return amountRealized.compareTo(amountPlanned) > 0;
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/CompteComptable.java

@@ -1,122 +1,127 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.comptabilite.TypeCompteComptable;
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité CompteComptable pour le plan comptable
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "comptes_comptables",
-    indexes = {
-      @Index(name = "idx_compte_numero", columnList = "numero_compte", unique = true),
-      @Index(name = "idx_compte_type", columnList = "type_compte"),
-      @Index(name = "idx_compte_classe", columnList = "classe_comptable")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class CompteComptable extends BaseEntity {
-
-  /** Numéro de compte unique (ex: 411000, 512000) */
-  @NotBlank
-  @Column(name = "numero_compte", unique = true, nullable = false, length = 10)
-  private String numeroCompte;
-
-  /** Libellé du compte */
-  @NotBlank
-  @Column(name = "libelle", nullable = false, length = 200)
-  private String libelle;
-
-  /** Type de compte */
-  @NotNull
-  @Enumerated(EnumType.STRING)
-  @Column(name = "type_compte", nullable = false, length = 30)
-  private TypeCompteComptable typeCompte;
-
-  /** Classe comptable (1-7) */
-  @NotNull
-  @Min(value = 1, message = "La classe comptable doit être entre 1 et 7")
-  @Max(value = 7, message = "La classe comptable doit être entre 1 et 7")
-  @Column(name = "classe_comptable", nullable = false)
-  private Integer classeComptable;
-
-  /** Solde initial */
-  @Builder.Default
-  @DecimalMin(value = "0.0", message = "Le solde initial doit être positif ou nul")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "solde_initial", precision = 14, scale = 2)
-  private BigDecimal soldeInitial = BigDecimal.ZERO;
-
-  /** Solde actuel (calculé) */
-  @Builder.Default
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "solde_actuel", precision = 14, scale = 2)
-  private BigDecimal soldeActuel = BigDecimal.ZERO;
-
-  /** Compte collectif (regroupe plusieurs sous-comptes) */
-  @Builder.Default
-  @Column(name = "compte_collectif", nullable = false)
-  private Boolean compteCollectif = false;
-
-  /** Compte analytique */
-  @Builder.Default
-  @Column(name = "compte_analytique", nullable = false)
-  private Boolean compteAnalytique = false;
-
-  /** Description du compte */
-  @Column(name = "description", length = 500)
-  private String description;
-
-  /** Lignes d'écriture associées */
-  @JsonIgnore
-  @OneToMany(mappedBy = "compteComptable", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<LigneEcriture> lignesEcriture = new ArrayList<>();
-
-  /** Méthode métier pour obtenir le numéro formaté */
-  public String getNumeroFormate() {
-    return String.format("%-10s", numeroCompte);
-  }
-
-  /** Méthode métier pour vérifier si c'est un compte de trésorerie */
-  public boolean isTresorerie() {
-    return TypeCompteComptable.TRESORERIE.equals(typeCompte);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (soldeInitial == null) {
-      soldeInitial = BigDecimal.ZERO;
-    }
-    if (soldeActuel == null) {
-      soldeActuel = soldeInitial;
-    }
-    if (compteCollectif == null) {
-      compteCollectif = false;
-    }
-    if (compteAnalytique == null) {
-      compteAnalytique = false;
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.comptabilite.TypeCompteComptable;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité CompteComptable pour le plan comptable
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "comptes_comptables",
+    indexes = {
+      @Index(name = "idx_compte_numero", columnList = "numero_compte", unique = true),
+      @Index(name = "idx_compte_type", columnList = "type_compte"),
+      @Index(name = "idx_compte_classe", columnList = "classe_comptable")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class CompteComptable extends BaseEntity {
+
+  /** Numéro de compte unique (ex: 411000, 512000) */
+  @NotBlank
+  @Column(name = "numero_compte", unique = true, nullable = false, length = 10)
+  private String numeroCompte;
+
+  /** Libellé du compte */
+  @NotBlank
+  @Column(name = "libelle", nullable = false, length = 200)
+  private String libelle;
+
+  /** Type de compte */
+  @NotNull
+  @Enumerated(EnumType.STRING)
+  @Column(name = "type_compte", nullable = false, length = 30)
+  private TypeCompteComptable typeCompte;
+
+  /** Classe comptable (1-7) */
+  @NotNull
+  @Min(value = 1, message = "La classe comptable doit être entre 1 et 9")
+  @Max(value = 9, message = "La classe comptable doit être entre 1 et 9")
+  @Column(name = "classe_comptable", nullable = false)
+  private Integer classeComptable;
+
+  /** Solde initial */
+  @Builder.Default
+  @DecimalMin(value = "0.0", message = "Le solde initial doit être positif ou nul")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "solde_initial", precision = 14, scale = 2)
+  private BigDecimal soldeInitial = BigDecimal.ZERO;
+
+  /** Solde actuel (calculé) */
+  @Builder.Default
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "solde_actuel", precision = 14, scale = 2)
+  private BigDecimal soldeActuel = BigDecimal.ZERO;
+
+  /** Compte collectif (regroupe plusieurs sous-comptes) */
+  @Builder.Default
+  @Column(name = "compte_collectif", nullable = false)
+  private Boolean compteCollectif = false;
+
+  /** Compte analytique */
+  @Builder.Default
+  @Column(name = "compte_analytique", nullable = false)
+  private Boolean compteAnalytique = false;
+
+  /** Description du compte */
+  @Column(name = "description", length = 500)
+  private String description;
+
+  /** Organisation propriétaire (null = compte standard global) */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  /** Lignes d'écriture associées */
+  @JsonIgnore
+  @OneToMany(mappedBy = "compteComptable", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<LigneEcriture> lignesEcriture = new ArrayList<>();
+
+  /** Méthode métier pour obtenir le numéro formaté */
+  public String getNumeroFormate() {
+    return String.format("%-10s", numeroCompte);
+  }
+
+  /** Méthode métier pour vérifier si c'est un compte de trésorerie */
+  public boolean isTresorerie() {
+    return TypeCompteComptable.TRESORERIE.equals(typeCompte);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (soldeInitial == null) {
+      soldeInitial = BigDecimal.ZERO;
+    }
+    if (soldeActuel == null) {
+      soldeActuel = soldeInitial;
+    }
+    if (compteCollectif == null) {
+      compteCollectif = false;
+    }
+    if (compteAnalytique == null) {
+      compteAnalytique = false;
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/CompteWave.java

@@ -1,105 +1,105 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.wave.StatutCompteWave;
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.Pattern;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité CompteWave pour la gestion des comptes Wave Mobile Money
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(name = "comptes_wave", indexes = {
-    @Index(name = "idx_compte_wave_telephone", columnList = "numero_telephone", unique = true),
-    @Index(name = "idx_compte_wave_statut", columnList = "statut_compte"),
-    @Index(name = "idx_compte_wave_organisation", columnList = "organisation_id"),
-    @Index(name = "idx_compte_wave_membre", columnList = "membre_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class CompteWave extends BaseEntity {
-
-  /** Numéro de téléphone Wave (format +225XXXXXXXX) */
-  @NotBlank
-  @Pattern(regexp = "^\\+225[0-9]{8}$", message = "Le numéro de téléphone Wave doit être au format +225XXXXXXXX")
-  @Column(name = "numero_telephone", unique = true, nullable = false, length = 13)
-  private String numeroTelephone;
-
-  /** Statut du compte */
-  @Enumerated(EnumType.STRING)
-  @Builder.Default
-  @Column(name = "statut_compte", nullable = false, length = 30)
-  private StatutCompteWave statutCompte = StatutCompteWave.NON_VERIFIE;
-
-  /** Identifiant Wave API (encrypté) */
-  @Column(name = "wave_account_id", length = 255)
-  private String waveAccountId;
-
-  /** Clé API Wave (encryptée) */
-  @Column(name = "wave_api_key", length = 500)
-  private String waveApiKey;
-
-  /** Environnement (SANDBOX ou PRODUCTION) */
-  @Column(name = "environnement", length = 20)
-  private String environnement;
-
-  /** Date de dernière vérification */
-  @Column(name = "date_derniere_verification")
-  private java.time.LocalDateTime dateDerniereVerification;
-
-  /** Commentaires */
-  @Column(name = "commentaire", length = 500)
-  private String commentaire;
-
-  // Relations
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id")
-  private Organisation organisation;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "membre_id")
-  private Membre membre;
-
-  @JsonIgnore
-
-  @OneToMany(mappedBy = "compteWave", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<TransactionWave> transactions = new ArrayList<>();
-
-  /** Méthode métier pour vérifier si le compte est vérifié */
-  public boolean isVerifie() {
-    return StatutCompteWave.VERIFIE.equals(statutCompte);
-  }
-
-  /** Méthode métier pour vérifier si le compte peut être utilisé */
-  public boolean peutEtreUtilise() {
-    return StatutCompteWave.VERIFIE.equals(statutCompte);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statutCompte == null) {
-      statutCompte = StatutCompteWave.NON_VERIFIE;
-    }
-    if (environnement == null || environnement.isEmpty()) {
-      environnement = "SANDBOX";
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.wave.StatutCompteWave;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité CompteWave pour la gestion des comptes Wave Mobile Money
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(name = "comptes_wave", indexes = {
+    @Index(name = "idx_compte_wave_telephone", columnList = "numero_telephone", unique = true),
+    @Index(name = "idx_compte_wave_statut", columnList = "statut_compte"),
+    @Index(name = "idx_compte_wave_organisation", columnList = "organisation_id"),
+    @Index(name = "idx_compte_wave_membre", columnList = "membre_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class CompteWave extends BaseEntity {
+
+  /** Numéro de téléphone Wave (format +225XXXXXXXX) */
+  @NotBlank
+  @Pattern(regexp = "^\\+225[0-9]{8}$", message = "Le numéro de téléphone Wave doit être au format +225XXXXXXXX")
+  @Column(name = "numero_telephone", unique = true, nullable = false, length = 13)
+  private String numeroTelephone;
+
+  /** Statut du compte */
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "statut_compte", nullable = false, length = 30)
+  private StatutCompteWave statutCompte = StatutCompteWave.NON_VERIFIE;
+
+  /** Identifiant Wave API (encrypté) */
+  @Column(name = "wave_account_id", length = 255)
+  private String waveAccountId;
+
+  /** Clé API Wave (encryptée) */
+  @Column(name = "wave_api_key", length = 500)
+  private String waveApiKey;
+
+  /** Environnement (SANDBOX ou PRODUCTION) */
+  @Column(name = "environnement", length = 20)
+  private String environnement;
+
+  /** Date de dernière vérification */
+  @Column(name = "date_derniere_verification")
+  private java.time.LocalDateTime dateDerniereVerification;
+
+  /** Commentaires */
+  @Column(name = "commentaire", length = 500)
+  private String commentaire;
+
+  // Relations
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_id")
+  private Membre membre;
+
+  @JsonIgnore
+
+  @OneToMany(mappedBy = "compteWave", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<TransactionWave> transactions = new ArrayList<>();
+
+  /** Méthode métier pour vérifier si le compte est vérifié */
+  public boolean isVerifie() {
+    return StatutCompteWave.VERIFIE.equals(statutCompte);
+  }
+
+  /** Méthode métier pour vérifier si le compte peut être utilisé */
+  public boolean peutEtreUtilise() {
+    return StatutCompteWave.VERIFIE.equals(statutCompte);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statutCompte == null) {
+      statutCompte = StatutCompteWave.NON_VERIFIE;
+    }
+    if (environnement == null || environnement.isEmpty()) {
+      environnement = "SANDBOX";
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Configuration.java

@@ -1,53 +1,53 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Configuration pour la gestion de la configuration système
- * 
- * @author UnionFlow Team
- * @version 1.0
- */
-@Entity
-@Table(name = "configurations")
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Configuration extends BaseEntity {
-
-    @NotBlank
-    @Column(name = "cle", nullable = false, unique = true, length = 255)
-    private String cle;
-
-    @Column(name = "valeur", columnDefinition = "TEXT")
-    private String valeur;
-
-    @Column(name = "type", length = 50)
-    private String type; // STRING, NUMBER, BOOLEAN, JSON, DATE
-
-    @Column(name = "categorie", length = 50)
-    private String categorie; // SYSTEME, SECURITE, NOTIFICATION, INTEGRATION, APPEARANCE
-
-    @Column(name = "description", length = 1000)
-    private String description;
-
-    @Column(name = "modifiable")
-    @Builder.Default
-    private Boolean modifiable = true;
-
-    @Column(name = "visible")
-    @Builder.Default
-    private Boolean visible = true;
-
-    @Column(name = "metadonnees", columnDefinition = "TEXT")
-    private String metadonnees; // JSON string pour stocker les métadonnées
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Configuration pour la gestion de la configuration système
+ * 
+ * @author UnionFlow Team
+ * @version 1.0
+ */
+@Entity
+@Table(name = "configurations")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Configuration extends BaseEntity {
+
+    @NotBlank
+    @Column(name = "cle", nullable = false, unique = true, length = 255)
+    private String cle;
+
+    @Column(name = "valeur", columnDefinition = "TEXT")
+    private String valeur;
+
+    @Column(name = "type", length = 50)
+    private String type; // STRING, NUMBER, BOOLEAN, JSON, DATE
+
+    @Column(name = "categorie", length = 50)
+    private String categorie; // SYSTEME, SECURITE, NOTIFICATION, INTEGRATION, APPEARANCE
+
+    @Column(name = "description", length = 1000)
+    private String description;
+
+    @Column(name = "modifiable")
+    @Builder.Default
+    private Boolean modifiable = true;
+
+    @Column(name = "visible")
+    @Builder.Default
+    private Boolean visible = true;
+
+    @Column(name = "metadonnees", columnDefinition = "TEXT")
+    private String metadonnees; // JSON string pour stocker les métadonnées
+}
+

src/main/java/dev/lions/unionflow/server/entity/ConfigurationWave.java

@@ -1,69 +1,69 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité ConfigurationWave pour la configuration de l'intégration Wave
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "configurations_wave",
-    indexes = {
-      @Index(name = "idx_config_wave_cle", columnList = "cle", unique = true)
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ConfigurationWave extends BaseEntity {
-
-  /** Clé de configuration */
-  @NotBlank
-  @Column(name = "cle", unique = true, nullable = false, length = 100)
-  private String cle;
-
-  /** Valeur de configuration (peut être encryptée) */
-  @Column(name = "valeur", columnDefinition = "TEXT")
-  private String valeur;
-
-  /** Description de la configuration */
-  @Column(name = "description", length = 500)
-  private String description;
-
-  /** Type de valeur (STRING, NUMBER, BOOLEAN, JSON, ENCRYPTED) */
-  @Column(name = "type_valeur", length = 20)
-  private String typeValeur;
-
-  /** Environnement (SANDBOX, PRODUCTION, COMMON) */
-  @Column(name = "environnement", length = 20)
-  private String environnement;
-
-  /** Méthode métier pour vérifier si la valeur est encryptée */
-  public boolean isEncryptee() {
-    return "ENCRYPTED".equals(typeValeur);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (typeValeur == null || typeValeur.isEmpty()) {
-      typeValeur = "STRING";
-    }
-    if (environnement == null || environnement.isEmpty()) {
-      environnement = "COMMON";
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité ConfigurationWave pour la configuration de l'intégration Wave
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "configurations_wave",
+    indexes = {
+      @Index(name = "idx_config_wave_cle", columnList = "cle", unique = true)
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ConfigurationWave extends BaseEntity {
+
+  /** Clé de configuration */
+  @NotBlank
+  @Column(name = "cle", unique = true, nullable = false, length = 100)
+  private String cle;
+
+  /** Valeur de configuration (peut être encryptée) */
+  @Column(name = "valeur", columnDefinition = "TEXT")
+  private String valeur;
+
+  /** Description de la configuration */
+  @Column(name = "description", length = 500)
+  private String description;
+
+  /** Type de valeur (STRING, NUMBER, BOOLEAN, JSON, ENCRYPTED) */
+  @Column(name = "type_valeur", length = 20)
+  private String typeValeur;
+
+  /** Environnement (SANDBOX, PRODUCTION, COMMON) */
+  @Column(name = "environnement", length = 20)
+  private String environnement;
+
+  /** Méthode métier pour vérifier si la valeur est encryptée */
+  public boolean isEncryptee() {
+    return "ENCRYPTED".equals(typeValeur);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (typeValeur == null || typeValeur.isEmpty()) {
+      typeValeur = "STRING";
+    }
+    if (environnement == null || environnement.isEmpty()) {
+      environnement = "COMMON";
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/Cotisation.java

@@ -1,194 +1,194 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-import java.util.UUID;
-import java.util.concurrent.atomic.AtomicLong;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Cotisation avec UUID Représente une cotisation d'un membre à son
- * organisation
- *
- * @author UnionFlow Team
- * @version 2.0
- * @since 2025-01-16
- */
-@Entity
-@Table(name = "cotisations", indexes = {
-    @Index(name = "idx_cotisation_membre", columnList = "membre_id"),
-    @Index(name = "idx_cotisation_reference", columnList = "numero_reference", unique = true),
-    @Index(name = "idx_cotisation_statut", columnList = "statut"),
-    @Index(name = "idx_cotisation_echeance", columnList = "date_echeance"),
-    @Index(name = "idx_cotisation_type", columnList = "type_cotisation"),
-    @Index(name = "idx_cotisation_annee_mois", columnList = "annee, mois")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Cotisation extends BaseEntity {
-
-  @NotBlank
-  @Column(name = "numero_reference", unique = true, nullable = false, length = 50)
-  private String numeroReference;
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "membre_id", nullable = false)
-  private Membre membre;
-
-  /** Organisation pour laquelle la cotisation est due */
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id", nullable = false)
-  private Organisation organisation;
-
-  /** Intention de paiement Wave associée (null si cotisation en attente) */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "intention_paiement_id")
-  private IntentionPaiement intentionPaiement;
-
-  @NotBlank
-  @Column(name = "type_cotisation", nullable = false, length = 50)
-  private String typeCotisation;
-
-  @NotBlank
-  @Column(name = "libelle", nullable = false, length = 100)
-  private String libelle;
-
-  @NotNull
-  @DecimalMin(value = "0.0", message = "Le montant dû doit être positif")
-  @Digits(integer = 10, fraction = 2)
-  @Column(name = "montant_du", nullable = false, precision = 12, scale = 2)
-  private BigDecimal montantDu;
-
-  @Builder.Default
-  @DecimalMin(value = "0.0", message = "Le montant payé doit être positif")
-  @Digits(integer = 10, fraction = 2)
-  @Column(name = "montant_paye", nullable = false, precision = 12, scale = 2)
-  private BigDecimal montantPaye = BigDecimal.ZERO;
-
-  @NotBlank
-  @Pattern(regexp = "^[A-Z]{3}$", message = "Le code devise doit être un code ISO à 3 lettres")
-  @Column(name = "code_devise", nullable = false, length = 3)
-  private String codeDevise;
-
-  @NotBlank
-  @Pattern(regexp = "^(EN_ATTENTE|PAYEE|EN_RETARD|PARTIELLEMENT_PAYEE|ANNULEE)$")
-  @Column(name = "statut", nullable = false, length = 30)
-  private String statut;
-
-  @NotNull
-  @Column(name = "date_echeance", nullable = false)
-  private LocalDate dateEcheance;
-
-  @Column(name = "date_paiement")
-  private LocalDateTime datePaiement;
-
-  @Size(max = 500)
-  @Column(name = "description", length = 500)
-  private String description;
-
-  @Size(max = 20)
-  @Column(name = "periode", length = 20)
-  private String periode;
-
-  @NotNull
-  @Min(value = 2020, message = "L'année doit être supérieure à 2020")
-  @Max(value = 2100, message = "L'année doit être inférieure à 2100")
-  @Column(name = "annee", nullable = false)
-  private Integer annee;
-
-  @Min(value = 1, message = "Le mois doit être entre 1 et 12")
-  @Max(value = 12, message = "Le mois doit être entre 1 et 12")
-  @Column(name = "mois")
-  private Integer mois;
-
-  @Size(max = 1000)
-  @Column(name = "observations", length = 1000)
-  private String observations;
-
-  @Builder.Default
-  @Column(name = "recurrente", nullable = false)
-  private Boolean recurrente = false;
-
-  @Builder.Default
-  @Min(value = 0, message = "Le nombre de rappels doit être positif")
-  @Column(name = "nombre_rappels", nullable = false)
-  private Integer nombreRappels = 0;
-
-  @Column(name = "date_dernier_rappel")
-  private LocalDateTime dateDernierRappel;
-
-  @Column(name = "valide_par_id")
-  private UUID valideParId;
-
-  @Size(max = 100)
-  @Column(name = "nom_validateur", length = 100)
-  private String nomValidateur;
-
-  @Column(name = "date_validation")
-  private LocalDateTime dateValidation;
-
-  /** Méthode métier pour calculer le montant restant à payer */
-  public BigDecimal getMontantRestant() {
-    if (montantDu == null || montantPaye == null) {
-      return BigDecimal.ZERO;
-    }
-    return montantDu.subtract(montantPaye);
-  }
-
-  /** Méthode métier pour vérifier si la cotisation est entièrement payée */
-  public boolean isEntierementPayee() {
-    return getMontantRestant().compareTo(BigDecimal.ZERO) <= 0;
-  }
-
-  /** Méthode métier pour vérifier si la cotisation est en retard */
-  public boolean isEnRetard() {
-    return dateEcheance != null && dateEcheance.isBefore(LocalDate.now()) && !isEntierementPayee();
-  }
-
-  private static final AtomicLong REFERENCE_COUNTER =
-      new AtomicLong(System.currentTimeMillis() % 100000000L);
-
-  /** Méthode métier pour générer un numéro de référence unique */
-  public static String genererNumeroReference() {
-    return "COT-"
-        + LocalDate.now().getYear()
-        + "-"
-        + String.format("%08d", REFERENCE_COUNTER.incrementAndGet() % 100000000L);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate(); // Appelle le onCreate de BaseEntity
-    if (numeroReference == null || numeroReference.isEmpty()) {
-      numeroReference = genererNumeroReference();
-    }
-    if (codeDevise == null) {
-      codeDevise = "XOF";
-    }
-    if (statut == null) {
-      statut = "EN_ATTENTE";
-    }
-    if (montantPaye == null) {
-      montantPaye = BigDecimal.ZERO;
-    }
-    if (nombreRappels == null) {
-      nombreRappels = 0;
-    }
-    if (recurrente == null) {
-      recurrente = false;
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import java.util.concurrent.atomic.AtomicLong;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Cotisation avec UUID Représente une cotisation d'un membre à son
+ * organisation
+ *
+ * @author UnionFlow Team
+ * @version 2.0
+ * @since 2025-01-16
+ */
+@Entity
+@Table(name = "cotisations", indexes = {
+    @Index(name = "idx_cotisation_membre", columnList = "membre_id"),
+    @Index(name = "idx_cotisation_reference", columnList = "numero_reference", unique = true),
+    @Index(name = "idx_cotisation_statut", columnList = "statut"),
+    @Index(name = "idx_cotisation_echeance", columnList = "date_echeance"),
+    @Index(name = "idx_cotisation_type", columnList = "type_cotisation"),
+    @Index(name = "idx_cotisation_annee_mois", columnList = "annee, mois")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Cotisation extends BaseEntity {
+
+  @NotBlank
+  @Column(name = "numero_reference", unique = true, nullable = false, length = 50)
+  private String numeroReference;
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_id", nullable = false)
+  private Membre membre;
+
+  /** Organisation pour laquelle la cotisation est due */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id", nullable = false)
+  private Organisation organisation;
+
+  /** Intention de paiement Wave associée (null si cotisation en attente) */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "intention_paiement_id")
+  private IntentionPaiement intentionPaiement;
+
+  @NotBlank
+  @Column(name = "type_cotisation", nullable = false, length = 50)
+  private String typeCotisation;
+
+  @NotBlank
+  @Column(name = "libelle", nullable = false, length = 100)
+  private String libelle;
+
+  @NotNull
+  @DecimalMin(value = "0.0", message = "Le montant dû doit être positif")
+  @Digits(integer = 10, fraction = 2)
+  @Column(name = "montant_du", nullable = false, precision = 12, scale = 2)
+  private BigDecimal montantDu;
+
+  @Builder.Default
+  @DecimalMin(value = "0.0", message = "Le montant payé doit être positif")
+  @Digits(integer = 10, fraction = 2)
+  @Column(name = "montant_paye", nullable = false, precision = 12, scale = 2)
+  private BigDecimal montantPaye = BigDecimal.ZERO;
+
+  @NotBlank
+  @Pattern(regexp = "^[A-Z]{3}$", message = "Le code devise doit être un code ISO à 3 lettres")
+  @Column(name = "code_devise", nullable = false, length = 3)
+  private String codeDevise;
+
+  @NotBlank
+  @Pattern(regexp = "^(EN_ATTENTE|PAYEE|EN_RETARD|PARTIELLEMENT_PAYEE|ANNULEE)$")
+  @Column(name = "statut", nullable = false, length = 30)
+  private String statut;
+
+  @NotNull
+  @Column(name = "date_echeance", nullable = false)
+  private LocalDate dateEcheance;
+
+  @Column(name = "date_paiement")
+  private LocalDateTime datePaiement;
+
+  @Size(max = 500)
+  @Column(name = "description", length = 500)
+  private String description;
+
+  @Size(max = 20)
+  @Column(name = "periode", length = 20)
+  private String periode;
+
+  @NotNull
+  @Min(value = 2020, message = "L'année doit être supérieure à 2020")
+  @Max(value = 2100, message = "L'année doit être inférieure à 2100")
+  @Column(name = "annee", nullable = false)
+  private Integer annee;
+
+  @Min(value = 1, message = "Le mois doit être entre 1 et 12")
+  @Max(value = 12, message = "Le mois doit être entre 1 et 12")
+  @Column(name = "mois")
+  private Integer mois;
+
+  @Size(max = 1000)
+  @Column(name = "observations", length = 1000)
+  private String observations;
+
+  @Builder.Default
+  @Column(name = "recurrente", nullable = false)
+  private Boolean recurrente = false;
+
+  @Builder.Default
+  @Min(value = 0, message = "Le nombre de rappels doit être positif")
+  @Column(name = "nombre_rappels", nullable = false)
+  private Integer nombreRappels = 0;
+
+  @Column(name = "date_dernier_rappel")
+  private LocalDateTime dateDernierRappel;
+
+  @Column(name = "valide_par_id")
+  private UUID valideParId;
+
+  @Size(max = 100)
+  @Column(name = "nom_validateur", length = 100)
+  private String nomValidateur;
+
+  @Column(name = "date_validation")
+  private LocalDateTime dateValidation;
+
+  /** Méthode métier pour calculer le montant restant à payer */
+  public BigDecimal getMontantRestant() {
+    if (montantDu == null || montantPaye == null) {
+      return BigDecimal.ZERO;
+    }
+    return montantDu.subtract(montantPaye);
+  }
+
+  /** Méthode métier pour vérifier si la cotisation est entièrement payée */
+  public boolean isEntierementPayee() {
+    return getMontantRestant().compareTo(BigDecimal.ZERO) <= 0;
+  }
+
+  /** Méthode métier pour vérifier si la cotisation est en retard */
+  public boolean isEnRetard() {
+    return dateEcheance != null && dateEcheance.isBefore(LocalDate.now()) && !isEntierementPayee();
+  }
+
+  private static final AtomicLong REFERENCE_COUNTER =
+      new AtomicLong(System.currentTimeMillis() % 100000000L);
+
+  /** Méthode métier pour générer un numéro de référence unique */
+  public static String genererNumeroReference() {
+    return "COT-"
+        + LocalDate.now().getYear()
+        + "-"
+        + String.format("%08d", REFERENCE_COUNTER.incrementAndGet() % 100000000L);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate(); // Appelle le onCreate de BaseEntity
+    if (numeroReference == null || numeroReference.isEmpty()) {
+      numeroReference = genererNumeroReference();
+    }
+    if (codeDevise == null) {
+      codeDevise = "XOF";
+    }
+    if (statut == null) {
+      statut = "EN_ATTENTE";
+    }
+    if (montantPaye == null) {
+      montantPaye = BigDecimal.ZERO;
+    }
+    if (nombreRappels == null) {
+      nombreRappels = 0;
+    }
+    if (recurrente == null) {
+      recurrente = false;
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/DemandeAdhesion.java

@@ -1,132 +1,132 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-import java.util.concurrent.atomic.AtomicLong;
-import lombok.*;
-
-/**
- * Demande d'adhésion d'un utilisateur à une organisation.
- *
- * <p>Flux :
- * <ol>
- *   <li>L'utilisateur crée son compte et choisit une organisation</li>
- *   <li>Une {@code DemandeAdhesion} est créée (statut EN_ATTENTE)</li>
- *   <li>Si frais d'adhésion : une {@link IntentionPaiement} est créée et liée</li>
- *   <li>Le manager valide → {@link MembreOrganisation} créé, quota souscription décrémenté</li>
- * </ol>
- *
- * <p>Remplace l'ancienne entité {@code Adhesion}.
- * Table : {@code demandes_adhesion}
- */
-@Entity
-@Table(
-    name = "demandes_adhesion",
-    indexes = {
-      @Index(name = "idx_da_utilisateur",  columnList = "utilisateur_id"),
-      @Index(name = "idx_da_organisation", columnList = "organisation_id"),
-      @Index(name = "idx_da_statut",       columnList = "statut"),
-      @Index(name = "idx_da_date",         columnList = "date_demande")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class DemandeAdhesion extends BaseEntity {
-
-  @NotBlank
-  @Column(name = "numero_reference", unique = true, nullable = false, length = 50)
-  private String numeroReference;
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "utilisateur_id", nullable = false)
-  private Membre utilisateur;
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id", nullable = false)
-  private Organisation organisation;
-
-  @NotBlank
-  @Pattern(regexp = "^(EN_ATTENTE|APPROUVEE|REJETEE|ANNULEE)$")
-  @Builder.Default
-  @Column(name = "statut", nullable = false, length = 20)
-  private String statut = "EN_ATTENTE";
-
-  @Builder.Default
-  @DecimalMin("0.00")
-  @Digits(integer = 10, fraction = 2)
-  @Column(name = "frais_adhesion", nullable = false, precision = 12, scale = 2)
-  private BigDecimal fraisAdhesion = BigDecimal.ZERO;
-
-  @Builder.Default
-  @DecimalMin("0.00")
-  @Digits(integer = 10, fraction = 2)
-  @Column(name = "montant_paye", nullable = false, precision = 12, scale = 2)
-  private BigDecimal montantPaye = BigDecimal.ZERO;
-
-  @Builder.Default
-  @Pattern(regexp = "^[A-Z]{3}$")
-  @Column(name = "code_devise", nullable = false, length = 3)
-  private String codeDevise = "XOF";
-
-  /** Intention de paiement Wave liée aux frais d'adhésion */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "intention_paiement_id")
-  private IntentionPaiement intentionPaiement;
-
-  @Builder.Default
-  @Column(name = "date_demande", nullable = false)
-  private LocalDateTime dateDemande = LocalDateTime.now();
-
-  @Column(name = "date_traitement")
-  private LocalDateTime dateTraitement;
-
-  /** Manager/Admin qui a approuvé ou rejeté */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "traite_par_id")
-  private Membre traitePar;
-
-  @Column(name = "motif_rejet", length = 1000)
-  private String motifRejet;
-
-  @Column(name = "observations", length = 1000)
-  private String observations;
-
-  // ── Méthodes métier ────────────────────────────────────────────────────────
-
-  public boolean isEnAttente() { return "EN_ATTENTE".equals(statut); }
-  public boolean isApprouvee() { return "APPROUVEE".equals(statut); }
-  public boolean isRejetee()   { return "REJETEE".equals(statut); }
-
-  public boolean isPayeeIntegralement() {
-    return fraisAdhesion != null
-        && montantPaye != null
-        && montantPaye.compareTo(fraisAdhesion) >= 0;
-  }
-
-  private static final AtomicLong REFERENCE_COUNTER =
-      new AtomicLong(System.currentTimeMillis() % 100000000L);
-
-  public static String genererNumeroReference() {
-    return "ADH-" + java.time.LocalDate.now().getYear()
-        + "-" + String.format("%08d", REFERENCE_COUNTER.incrementAndGet() % 100000000L);
-  }
-
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (dateDemande == null) dateDemande = LocalDateTime.now();
-    if (statut == null)      statut      = "EN_ATTENTE";
-    if (codeDevise == null)  codeDevise  = "XOF";
-    if (fraisAdhesion == null) fraisAdhesion = BigDecimal.ZERO;
-    if (montantPaye == null)   montantPaye   = BigDecimal.ZERO;
-    if (numeroReference == null || numeroReference.isEmpty()) {
-      numeroReference = genererNumeroReference();
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.concurrent.atomic.AtomicLong;
+import lombok.*;
+
+/**
+ * Demande d'adhésion d'un utilisateur à une organisation.
+ *
+ * <p>Flux :
+ * <ol>
+ *   <li>L'utilisateur crée son compte et choisit une organisation</li>
+ *   <li>Une {@code DemandeAdhesion} est créée (statut EN_ATTENTE)</li>
+ *   <li>Si frais d'adhésion : une {@link IntentionPaiement} est créée et liée</li>
+ *   <li>Le manager valide → {@link MembreOrganisation} créé, quota souscription décrémenté</li>
+ * </ol>
+ *
+ * <p>Remplace l'ancienne entité {@code Adhesion}.
+ * Table : {@code demandes_adhesion}
+ */
+@Entity
+@Table(
+    name = "demandes_adhesion",
+    indexes = {
+      @Index(name = "idx_da_utilisateur",  columnList = "utilisateur_id"),
+      @Index(name = "idx_da_organisation", columnList = "organisation_id"),
+      @Index(name = "idx_da_statut",       columnList = "statut"),
+      @Index(name = "idx_da_date",         columnList = "date_demande")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class DemandeAdhesion extends BaseEntity {
+
+  @NotBlank
+  @Column(name = "numero_reference", unique = true, nullable = false, length = 50)
+  private String numeroReference;
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "utilisateur_id", nullable = false)
+  private Membre utilisateur;
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id", nullable = false)
+  private Organisation organisation;
+
+  @NotBlank
+  @Pattern(regexp = "^(EN_ATTENTE|APPROUVEE|REJETEE|ANNULEE)$")
+  @Builder.Default
+  @Column(name = "statut", nullable = false, length = 20)
+  private String statut = "EN_ATTENTE";
+
+  @Builder.Default
+  @DecimalMin("0.00")
+  @Digits(integer = 10, fraction = 2)
+  @Column(name = "frais_adhesion", nullable = false, precision = 12, scale = 2)
+  private BigDecimal fraisAdhesion = BigDecimal.ZERO;
+
+  @Builder.Default
+  @DecimalMin("0.00")
+  @Digits(integer = 10, fraction = 2)
+  @Column(name = "montant_paye", nullable = false, precision = 12, scale = 2)
+  private BigDecimal montantPaye = BigDecimal.ZERO;
+
+  @Builder.Default
+  @Pattern(regexp = "^[A-Z]{3}$")
+  @Column(name = "code_devise", nullable = false, length = 3)
+  private String codeDevise = "XOF";
+
+  /** Intention de paiement Wave liée aux frais d'adhésion */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "intention_paiement_id")
+  private IntentionPaiement intentionPaiement;
+
+  @Builder.Default
+  @Column(name = "date_demande", nullable = false)
+  private LocalDateTime dateDemande = LocalDateTime.now();
+
+  @Column(name = "date_traitement")
+  private LocalDateTime dateTraitement;
+
+  /** Manager/Admin qui a approuvé ou rejeté */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "traite_par_id")
+  private Membre traitePar;
+
+  @Column(name = "motif_rejet", length = 1000)
+  private String motifRejet;
+
+  @Column(name = "observations", length = 1000)
+  private String observations;
+
+  // ── Méthodes métier ────────────────────────────────────────────────────────
+
+  public boolean isEnAttente() { return "EN_ATTENTE".equals(statut); }
+  public boolean isApprouvee() { return "APPROUVEE".equals(statut); }
+  public boolean isRejetee()   { return "REJETEE".equals(statut); }
+
+  public boolean isPayeeIntegralement() {
+    return fraisAdhesion != null
+        && montantPaye != null
+        && montantPaye.compareTo(fraisAdhesion) >= 0;
+  }
+
+  private static final AtomicLong REFERENCE_COUNTER =
+      new AtomicLong(System.currentTimeMillis() % 100000000L);
+
+  public static String genererNumeroReference() {
+    return "ADH-" + java.time.LocalDate.now().getYear()
+        + "-" + String.format("%08d", REFERENCE_COUNTER.incrementAndGet() % 100000000L);
+  }
+
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (dateDemande == null) dateDemande = LocalDateTime.now();
+    if (statut == null)      statut      = "EN_ATTENTE";
+    if (codeDevise == null)  codeDevise  = "XOF";
+    if (fraisAdhesion == null) fraisAdhesion = BigDecimal.ZERO;
+    if (montantPaye == null)   montantPaye   = BigDecimal.ZERO;
+    if (numeroReference == null || numeroReference.isEmpty()) {
+      numeroReference = genererNumeroReference();
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/DemandeAide.java

@@ -1,130 +1,177 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.solidarite.StatutAide;
-import dev.lions.unionflow.server.api.enums.solidarite.TypeAide;
-import jakarta.persistence.*;
-import java.math.BigDecimal;
-import java.math.RoundingMode;
-import java.time.LocalDateTime;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/** Entité représentant une demande d'aide dans le système de solidarité */
-@Entity
-@Table(name = "demandes_aide")
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class DemandeAide extends BaseEntity {
-
-  @Column(name = "titre", nullable = false, length = 200)
-  private String titre;
-
-  @Column(name = "description", nullable = false, columnDefinition = "TEXT")
-  private String description;
-
-  @Enumerated(EnumType.STRING)
-  @Column(name = "type_aide", nullable = false)
-  private TypeAide typeAide;
-
-  @Enumerated(EnumType.STRING)
-  @Column(name = "statut", nullable = false)
-  private StatutAide statut;
-
-  @Column(name = "montant_demande", precision = 10, scale = 2)
-  private BigDecimal montantDemande;
-
-  @Column(name = "montant_approuve", precision = 10, scale = 2)
-  private BigDecimal montantApprouve;
-
-  @Column(name = "date_demande", nullable = false)
-  private LocalDateTime dateDemande;
-
-  @Column(name = "date_evaluation")
-  private LocalDateTime dateEvaluation;
-
-  @Column(name = "date_versement")
-  private LocalDateTime dateVersement;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "demandeur_id", nullable = false)
-  private Membre demandeur;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "evaluateur_id")
-  private Membre evaluateur;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id", nullable = false)
-  private Organisation organisation;
-
-  @Column(name = "justification", columnDefinition = "TEXT")
-  private String justification;
-
-  @Column(name = "commentaire_evaluation", columnDefinition = "TEXT")
-  private String commentaireEvaluation;
-
-  @Column(name = "urgence", nullable = false)
-  @Builder.Default
-  private Boolean urgence = false;
-
-  @Column(name = "documents_fournis")
-  private String documentsFournis;
-
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate(); // Appelle le onCreate de BaseEntity
-    if (dateDemande == null) {
-      dateDemande = LocalDateTime.now();
-    }
-    if (statut == null) {
-      statut = StatutAide.EN_ATTENTE;
-    }
-    if (urgence == null) {
-      urgence = false;
-    }
-  }
-
-  @PreUpdate
-  protected void onUpdate() {
-    // Méthode appelée avant mise à jour
-  }
-
-  /** Vérifie si la demande est en attente */
-  public boolean isEnAttente() {
-    return StatutAide.EN_ATTENTE.equals(statut);
-  }
-
-  /** Vérifie si la demande est approuvée */
-  public boolean isApprouvee() {
-    return StatutAide.APPROUVEE.equals(statut);
-  }
-
-  /** Vérifie si la demande est rejetée */
-  public boolean isRejetee() {
-    return StatutAide.REJETEE.equals(statut);
-  }
-
-  /** Vérifie si la demande est urgente */
-  public boolean isUrgente() {
-    return Boolean.TRUE.equals(urgence);
-  }
-
-  /** Calcule le pourcentage d'approbation par rapport au montant demandé */
-  public BigDecimal getPourcentageApprobation() {
-    if (montantDemande == null || montantDemande.compareTo(BigDecimal.ZERO) == 0) {
-      return BigDecimal.ZERO;
-    }
-    if (montantApprouve == null) {
-      return BigDecimal.ZERO;
-    }
-    return montantApprouve
-        .divide(montantDemande, 4, RoundingMode.HALF_UP)
-        .multiply(BigDecimal.valueOf(100));
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.solidarite.StatutAide;
+import dev.lions.unionflow.server.api.enums.solidarite.TypeAide;
+import jakarta.persistence.*;
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDateTime;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/** Entité représentant une demande d'aide dans le système de solidarité */
+@Entity
+@Table(name = "demandes_aide")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class DemandeAide extends BaseEntity {
+
+  @Column(name = "titre", nullable = false, length = 200)
+  private String titre;
+
+  @Column(name = "description", nullable = false, columnDefinition = "TEXT")
+  private String description;
+
+  @Enumerated(EnumType.STRING)
+  @Column(name = "type_aide", nullable = false)
+  private TypeAide typeAide;
+
+  @Enumerated(EnumType.STRING)
+  @Column(name = "statut", nullable = false)
+  private StatutAide statut;
+
+  @Column(name = "montant_demande", precision = 10, scale = 2)
+  private BigDecimal montantDemande;
+
+  @Column(name = "montant_approuve", precision = 10, scale = 2)
+  private BigDecimal montantApprouve;
+
+  @Column(name = "date_demande", nullable = false)
+  private LocalDateTime dateDemande;
+
+  @Column(name = "date_evaluation")
+  private LocalDateTime dateEvaluation;
+
+  @Column(name = "date_versement")
+  private LocalDateTime dateVersement;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "demandeur_id", nullable = false)
+  private Membre demandeur;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "evaluateur_id")
+  private Membre evaluateur;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id", nullable = false)
+  private Organisation organisation;
+
+  @Column(name = "justification", columnDefinition = "TEXT")
+  private String justification;
+
+  @Column(name = "commentaire_evaluation", columnDefinition = "TEXT")
+  private String commentaireEvaluation;
+
+  @Column(name = "urgence", nullable = false)
+  @Builder.Default
+  private Boolean urgence = false;
+
+  @Column(name = "documents_fournis")
+  private String documentsFournis;
+
+  // ========================================================
+  // Workflow v2 (P1-NEW-3, 2026-04-25) — DEPOSE → ENQUETE → AVIS_COMITE → DECISION_CA → PAYE → CLOTURE
+  // ========================================================
+
+  /** Étape actuelle dans le workflow v2 (DEPOSE par défaut). */
+  @Column(name = "etape", length = 30)
+  @Builder.Default
+  private String etape = "DEPOSE";
+
+  /** Animateur de zone responsable de l'enquête sociale (étape ENQUETE). */
+  @Column(name = "animateur_zone_id")
+  private java.util.UUID animateurZoneId;
+
+  /** Rapport rédigé par l'animateur après visite (étape ENQUETE). */
+  @Column(name = "rapport_enquete_sociale", columnDefinition = "TEXT")
+  private String rapportEnqueteSociale;
+
+  @Column(name = "date_enquete")
+  private LocalDateTime dateEnquete;
+
+  /** Géolocalisation GPS de l'enquête (preuve de visite terrain). */
+  @Column(name = "gps_enquete_lat", precision = 10, scale = 7)
+  private java.math.BigDecimal gpsEnqueteLat;
+
+  @Column(name = "gps_enquete_lon", precision = 10, scale = 7)
+  private java.math.BigDecimal gpsEnqueteLon;
+
+  /** Avis du comité social ou commission solidarité (étape AVIS_COMITE). */
+  @Column(name = "avis_comite_social", columnDefinition = "TEXT")
+  private String avisComiteSocial;
+
+  @Column(name = "date_avis_comite")
+  private LocalDateTime dateAvisComite;
+
+  /** Lien vers le PV CA dans lequel la décision a été votée (étape DECISION_CA). */
+  @Column(name = "decision_ca_id")
+  private java.util.UUID decisionCaId;
+
+  @Column(name = "date_decision_ca")
+  private LocalDateTime dateDecisionCa;
+
+  @Column(name = "date_paie")
+  private LocalDateTime datePaie;
+
+  @Column(name = "reference_paiement", length = 100)
+  private String referencePaiement;
+
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate(); // Appelle le onCreate de BaseEntity
+    if (dateDemande == null) {
+      dateDemande = LocalDateTime.now();
+    }
+    if (statut == null) {
+      statut = StatutAide.EN_ATTENTE;
+    }
+    if (urgence == null) {
+      urgence = false;
+    }
+  }
+
+  @PreUpdate
+  protected void onUpdate() {
+    // Méthode appelée avant mise à jour
+  }
+
+  /** Vérifie si la demande est en attente */
+  public boolean isEnAttente() {
+    return StatutAide.EN_ATTENTE.equals(statut);
+  }
+
+  /** Vérifie si la demande est approuvée */
+  public boolean isApprouvee() {
+    return StatutAide.APPROUVEE.equals(statut);
+  }
+
+  /** Vérifie si la demande est rejetée */
+  public boolean isRejetee() {
+    return StatutAide.REJETEE.equals(statut);
+  }
+
+  /** Vérifie si la demande est urgente */
+  public boolean isUrgente() {
+    return Boolean.TRUE.equals(urgence);
+  }
+
+  /** Calcule le pourcentage d'approbation par rapport au montant demandé */
+  public BigDecimal getPourcentageApprobation() {
+    if (montantDemande == null || montantDemande.compareTo(BigDecimal.ZERO) == 0) {
+      return BigDecimal.ZERO;
+    }
+    if (montantApprouve == null) {
+      return BigDecimal.ZERO;
+    }
+    return montantApprouve
+        .divide(montantDemande, 4, RoundingMode.HALF_UP)
+        .multiply(BigDecimal.valueOf(100));
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Devise.java

@@ -0,0 +1,58 @@
+package dev.lions.unionflow.server.entity;
+
+import java.util.Set;
+
+/**
+ * Devises supportées par UnionFlow.
+ *
+ * <p>UnionFlow vise prioritairement la zone UEMOA (XOF/XAF) mais s'ouvre à la diaspora
+ * (EUR/USD/GBP/CAD). Le {@link ZoneDevise} permet de discriminer pour les règles
+ * AML (transferts internationaux, due diligence renforcée).
+ *
+ * @since 2026-04-25 (P2-NEW-7)
+ */
+public enum Devise {
+
+  // Zone UEMOA / CEMAC
+  XOF("Franc CFA Ouest", ZoneDevise.UEMOA),
+  XAF("Franc CFA Centrale", ZoneDevise.CEMAC),
+
+  // Diaspora — Europe / Amérique
+  EUR("Euro", ZoneDevise.EUROPE),
+  USD("Dollar US", ZoneDevise.AMERIQUE),
+  GBP("Livre Sterling", ZoneDevise.EUROPE),
+  CAD("Dollar Canadien", ZoneDevise.AMERIQUE),
+  CHF("Franc Suisse", ZoneDevise.EUROPE),
+
+  // CEDEAO non-UEMOA (pour intégrations futures)
+  GHS("Cédi Ghanéen", ZoneDevise.CEDEAO),
+  NGN("Naira Nigérian", ZoneDevise.CEDEAO),
+
+  // Maghreb
+  MAD("Dirham Marocain", ZoneDevise.MAGHREB);
+
+  private final String libelle;
+  private final ZoneDevise zone;
+
+  Devise(String libelle, ZoneDevise zone) {
+    this.libelle = libelle;
+    this.zone = zone;
+  }
+
+  public String libelle() { return libelle; }
+  public ZoneDevise zone() { return zone; }
+
+  /** Devise de référence UnionFlow / BCEAO. */
+  public static Devise reference() { return XOF; }
+
+  /** Devises pour lesquelles un transfert depuis/vers UEMOA déclenche AML renforcé. */
+  public static final Set<Devise> DEVISES_INTERNATIONALES = Set.of(EUR, USD, GBP, CAD, CHF);
+
+  public boolean estInternationale() {
+    return DEVISES_INTERNATIONALES.contains(this);
+  }
+
+  public enum ZoneDevise {
+    UEMOA, CEMAC, CEDEAO, EUROPE, AMERIQUE, MAGHREB
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Document.java

@@ -1,130 +1,130 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.document.TypeDocument;
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Document pour la gestion documentaire sécurisée
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "documents",
-    indexes = {
-      @Index(name = "idx_document_nom_fichier", columnList = "nom_fichier"),
-      @Index(name = "idx_document_type", columnList = "type_document"),
-      @Index(name = "idx_document_hash_md5", columnList = "hash_md5"),
-      @Index(name = "idx_document_hash_sha256", columnList = "hash_sha256")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Document extends BaseEntity {
-
-  /** Nom du fichier original */
-  @NotBlank
-  @Column(name = "nom_fichier", nullable = false, length = 255)
-  private String nomFichier;
-
-  /** Nom original du fichier (tel que téléchargé) */
-  @Column(name = "nom_original", length = 255)
-  private String nomOriginal;
-
-  /** Chemin de stockage */
-  @NotBlank
-  @Column(name = "chemin_stockage", nullable = false, length = 1000)
-  private String cheminStockage;
-
-  /** Type MIME */
-  @Column(name = "type_mime", length = 100)
-  private String typeMime;
-
-  /** Taille du fichier en octets */
-  @NotNull
-  @Min(value = 0, message = "La taille doit être positive")
-  @Column(name = "taille_octets", nullable = false)
-  private Long tailleOctets;
-
-  /** Type de document */
-  @Enumerated(EnumType.STRING)
-  @Column(name = "type_document", length = 50)
-  private TypeDocument typeDocument;
-
-  /** Hash MD5 pour vérification d'intégrité */
-  @Column(name = "hash_md5", length = 32)
-  private String hashMd5;
-
-  /** Hash SHA256 pour vérification d'intégrité */
-  @Column(name = "hash_sha256", length = 64)
-  private String hashSha256;
-
-  /** Description du document */
-  @Column(name = "description", length = 1000)
-  private String description;
-
-  /** Nombre de téléchargements */
-  @Builder.Default
-  @Column(name = "nombre_telechargements", nullable = false)
-  private Integer nombreTelechargements = 0;
-
-  /** Date de dernier téléchargement */
-  @Column(name = "date_dernier_telechargement")
-  private java.time.LocalDateTime dateDernierTelechargement;
-
-  /** Pièces jointes associées */
-  @JsonIgnore
-  @OneToMany(mappedBy = "document", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<PieceJointe> piecesJointes = new ArrayList<>();
-
-  /** Méthode métier pour vérifier l'intégrité avec MD5 */
-  public boolean verifierIntegriteMd5(String hashAttendu) {
-    return hashMd5 != null && hashMd5.equalsIgnoreCase(hashAttendu);
-  }
-
-  /** Méthode métier pour vérifier l'intégrité avec SHA256 */
-  public boolean verifierIntegriteSha256(String hashAttendu) {
-    return hashSha256 != null && hashSha256.equalsIgnoreCase(hashAttendu);
-  }
-
-  /** Méthode métier pour obtenir la taille formatée */
-  public String getTailleFormatee() {
-    if (tailleOctets == null) {
-      return "0 B";
-    }
-    if (tailleOctets < 1024) {
-      return tailleOctets + " B";
-    } else if (tailleOctets < 1024 * 1024) {
-      return String.format("%.2f KB", tailleOctets / 1024.0);
-    } else {
-      return String.format("%.2f MB", tailleOctets / (1024.0 * 1024.0));
-    }
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (nombreTelechargements == null) {
-      nombreTelechargements = 0;
-    }
-    if (typeDocument == null) {
-      typeDocument = TypeDocument.AUTRE;
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.document.TypeDocument;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Document pour la gestion documentaire sécurisée
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "documents",
+    indexes = {
+      @Index(name = "idx_document_nom_fichier", columnList = "nom_fichier"),
+      @Index(name = "idx_document_type", columnList = "type_document"),
+      @Index(name = "idx_document_hash_md5", columnList = "hash_md5"),
+      @Index(name = "idx_document_hash_sha256", columnList = "hash_sha256")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Document extends BaseEntity {
+
+  /** Nom du fichier original */
+  @NotBlank
+  @Column(name = "nom_fichier", nullable = false, length = 255)
+  private String nomFichier;
+
+  /** Nom original du fichier (tel que téléchargé) */
+  @Column(name = "nom_original", length = 255)
+  private String nomOriginal;
+
+  /** Chemin de stockage */
+  @NotBlank
+  @Column(name = "chemin_stockage", nullable = false, length = 1000)
+  private String cheminStockage;
+
+  /** Type MIME */
+  @Column(name = "type_mime", length = 100)
+  private String typeMime;
+
+  /** Taille du fichier en octets */
+  @NotNull
+  @Min(value = 0, message = "La taille doit être positive")
+  @Column(name = "taille_octets", nullable = false)
+  private Long tailleOctets;
+
+  /** Type de document */
+  @Enumerated(EnumType.STRING)
+  @Column(name = "type_document", length = 50)
+  private TypeDocument typeDocument;
+
+  /** Hash MD5 pour vérification d'intégrité */
+  @Column(name = "hash_md5", length = 32)
+  private String hashMd5;
+
+  /** Hash SHA256 pour vérification d'intégrité */
+  @Column(name = "hash_sha256", length = 64)
+  private String hashSha256;
+
+  /** Description du document */
+  @Column(name = "description", length = 1000)
+  private String description;
+
+  /** Nombre de téléchargements */
+  @Builder.Default
+  @Column(name = "nombre_telechargements", nullable = false)
+  private Integer nombreTelechargements = 0;
+
+  /** Date de dernier téléchargement */
+  @Column(name = "date_dernier_telechargement")
+  private java.time.LocalDateTime dateDernierTelechargement;
+
+  /** Pièces jointes associées */
+  @JsonIgnore
+  @OneToMany(mappedBy = "document", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<PieceJointe> piecesJointes = new ArrayList<>();
+
+  /** Méthode métier pour vérifier l'intégrité avec MD5 */
+  public boolean verifierIntegriteMd5(String hashAttendu) {
+    return hashMd5 != null && hashMd5.equalsIgnoreCase(hashAttendu);
+  }
+
+  /** Méthode métier pour vérifier l'intégrité avec SHA256 */
+  public boolean verifierIntegriteSha256(String hashAttendu) {
+    return hashSha256 != null && hashSha256.equalsIgnoreCase(hashAttendu);
+  }
+
+  /** Méthode métier pour obtenir la taille formatée */
+  public String getTailleFormatee() {
+    if (tailleOctets == null) {
+      return "0 B";
+    }
+    if (tailleOctets < 1024) {
+      return tailleOctets + " B";
+    } else if (tailleOctets < 1024 * 1024) {
+      return String.format("%.2f KB", tailleOctets / 1024.0);
+    } else {
+      return String.format("%.2f MB", tailleOctets / (1024.0 * 1024.0));
+    }
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (nombreTelechargements == null) {
+      nombreTelechargements = 0;
+    }
+    if (typeDocument == null) {
+      typeDocument = TypeDocument.AUTRE;
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/DonRecu.java

@@ -0,0 +1,86 @@
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Don reçu (numéraire, nature, bénévolat, legs) — comptabilisé selon SYCEBNL :
+ *
+ * <ul>
+ *   <li>NUMERAIRE → Crédit 755 (Dons et libéralités)
+ *   <li>NATURE → valorisation obligatoire au prix marché, idem 755
+ *   <li>BENEVOLAT → valorisation possible en notes annexes
+ *   <li>LEGS → Crédit 756 ou poste dédié selon nature
+ *   <li>FONDS_DEDIE → Crédit 19 (Fonds dédiés non utilisés, à reverser si finalité non remplie)
+ * </ul>
+ *
+ * @since 2026-04-25 (P1-NEW-13)
+ */
+@Entity
+@Table(name = "dons_recus", indexes = {
+    @Index(name = "idx_don_org", columnList = "organisation_id"),
+    @Index(name = "idx_don_donateur", columnList = "donateur_id"),
+    @Index(name = "idx_don_date", columnList = "date_don")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class DonRecu extends BaseEntity {
+
+  @NotNull
+  @Column(name = "organisation_id", nullable = false)
+  private UUID organisationId;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "donateur_id")
+  private Donateur donateur;
+
+  @NotBlank
+  @Column(name = "type_don", nullable = false, length = 20)
+  private String typeDon; // NUMERAIRE, NATURE, BENEVOLAT, LEGS
+
+  @Column(name = "montant_xof", precision = 15, scale = 2)
+  private BigDecimal montantXof;
+
+  @Column(name = "valorisation_xof", precision = 15, scale = 2)
+  private BigDecimal valorisationXof;
+
+  @Column(name = "description", columnDefinition = "TEXT")
+  private String description;
+
+  @NotNull
+  @Column(name = "date_don", nullable = false)
+  private LocalDate dateDon;
+
+  @NotBlank
+  @Column(name = "affectation", nullable = false, length = 50)
+  @Builder.Default
+  private String affectation = "LIBRE"; // LIBRE, FONDS_DEDIE, PROJET_SPECIFIQUE
+
+  @Column(name = "fonds_dedie_id")
+  private UUID fondsDedieId;
+
+  @Column(name = "projet_id")
+  private UUID projetId;
+
+  @Column(name = "recu_emis", nullable = false)
+  @Builder.Default
+  private boolean recuEmis = false;
+
+  @Column(name = "numero_recu", length = 50)
+  private String numeroRecu;
+
+  @Column(name = "date_emission_recu")
+  private LocalDate dateEmissionRecu;
+}

src/main/java/dev/lions/unionflow/server/entity/Donateur.java

@@ -0,0 +1,53 @@
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Donateur — registre obligatoire pour les entités relevant de SYCEBNL (associations, ONG,
+ * mutuelles sociales).
+ *
+ * @since 2026-04-25 (P1-NEW-13)
+ */
+@Entity
+@Table(name = "donateurs", indexes = {
+    @Index(name = "idx_donateur_org", columnList = "organisation_id"),
+    @Index(name = "idx_donateur_type", columnList = "type_donateur")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Donateur extends BaseEntity {
+
+  @NotNull
+  @Column(name = "organisation_id", nullable = false)
+  private UUID organisationId;
+
+  @NotBlank
+  @Column(name = "type_donateur", nullable = false, length = 20)
+  private String typeDonateur; // PERSONNE_PHYSIQUE, PERSONNE_MORALE, ANONYME
+
+  @Column(name = "nom_prenoms", length = 255)
+  private String nomPrenoms;
+
+  @Column(name = "raison_sociale", length = 255)
+  private String raisonSociale;
+
+  @Column(name = "pays", length = 3)
+  private String pays;
+
+  @Column(name = "email", length = 255)
+  private String email;
+
+  @Column(name = "telephone", length = 20)
+  private String telephone;
+}

src/main/java/dev/lions/unionflow/server/entity/EcritureComptable.java

@@ -1,174 +1,174 @@
-package dev.lions.unionflow.server.entity;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité EcritureComptable pour les écritures comptables
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "ecritures_comptables",
-    indexes = {
-      @Index(name = "idx_ecriture_numero_piece", columnList = "numero_piece", unique = true),
-      @Index(name = "idx_ecriture_date", columnList = "date_ecriture"),
-      @Index(name = "idx_ecriture_journal", columnList = "journal_id"),
-      @Index(name = "idx_ecriture_organisation", columnList = "organisation_id"),
-      @Index(name = "idx_ecriture_paiement", columnList = "paiement_id")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class EcritureComptable extends BaseEntity {
-
-  /** Numéro de pièce unique */
-  @NotBlank
-  @Column(name = "numero_piece", unique = true, nullable = false, length = 50)
-  private String numeroPiece;
-
-  /** Date de l'écriture */
-  @NotNull
-  @Column(name = "date_ecriture", nullable = false)
-  private LocalDate dateEcriture;
-
-  /** Libellé de l'écriture */
-  @NotBlank
-  @Column(name = "libelle", nullable = false, length = 500)
-  private String libelle;
-
-  /** Référence externe */
-  @Column(name = "reference", length = 100)
-  private String reference;
-
-  /** Lettrage (pour rapprochement) */
-  @Column(name = "lettrage", length = 20)
-  private String lettrage;
-
-  /** Pointage (pour rapprochement bancaire) */
-  @Builder.Default
-  @Column(name = "pointe", nullable = false)
-  private Boolean pointe = false;
-
-  /** Montant total débit (somme des lignes) */
-  @Builder.Default
-  @DecimalMin(value = "0.0")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "montant_debit", precision = 14, scale = 2)
-  private BigDecimal montantDebit = BigDecimal.ZERO;
-
-  /** Montant total crédit (somme des lignes) */
-  @Builder.Default
-  @DecimalMin(value = "0.0")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "montant_credit", precision = 14, scale = 2)
-  private BigDecimal montantCredit = BigDecimal.ZERO;
-
-  /** Commentaires */
-  @Column(name = "commentaire", length = 1000)
-  private String commentaire;
-
-  // Relations
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "journal_id", nullable = false)
-  private JournalComptable journal;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id")
-  private Organisation organisation;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "paiement_id")
-  private Paiement paiement;
-
-  /** Lignes d'écriture */
-  @JsonIgnore
-  @OneToMany(mappedBy = "ecriture", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<LigneEcriture> lignes = new ArrayList<>();
-
-  /** Méthode métier pour vérifier l'équilibre (Débit = Crédit) */
-  public boolean isEquilibree() {
-    if (montantDebit == null || montantCredit == null) {
-      return false;
-    }
-    return montantDebit.compareTo(montantCredit) == 0;
-  }
-
-  /** Méthode métier pour calculer les totaux à partir des lignes */
-  public void calculerTotaux() {
-    if (lignes == null || lignes.isEmpty()) {
-      montantDebit = BigDecimal.ZERO;
-      montantCredit = BigDecimal.ZERO;
-      return;
-    }
-
-    montantDebit =
-        lignes.stream()
-            .map(LigneEcriture::getMontantDebit)
-            .filter(amount -> amount != null)
-            .reduce(BigDecimal.ZERO, BigDecimal::add);
-
-    montantCredit =
-        lignes.stream()
-            .map(LigneEcriture::getMontantCredit)
-            .filter(amount -> amount != null)
-            .reduce(BigDecimal.ZERO, BigDecimal::add);
-  }
-
-  /** Méthode métier pour générer un numéro de pièce unique */
-  public static String genererNumeroPiece(String prefixe, LocalDate date) {
-    return String.format(
-        "%s-%04d%02d%02d-%012d",
-        prefixe, date.getYear(), date.getMonthValue(), date.getDayOfMonth(),
-        System.currentTimeMillis() % 1000000000000L);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (numeroPiece == null || numeroPiece.isEmpty()) {
-      numeroPiece = genererNumeroPiece("ECR", dateEcriture != null ? dateEcriture : LocalDate.now());
-    }
-    if (dateEcriture == null) {
-      dateEcriture = LocalDate.now();
-    }
-    if (montantDebit == null) {
-      montantDebit = BigDecimal.ZERO;
-    }
-    if (montantCredit == null) {
-      montantCredit = BigDecimal.ZERO;
-    }
-    if (pointe == null) {
-      pointe = false;
-    }
-    // Calculer les totaux si les lignes sont déjà présentes
-    if (lignes != null && !lignes.isEmpty()) {
-      calculerTotaux();
-    }
-  }
-
-  /** Callback JPA avant la mise à jour */
-  @PreUpdate
-  protected void onUpdate() {
-    calculerTotaux();
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité EcritureComptable pour les écritures comptables
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "ecritures_comptables",
+    indexes = {
+      @Index(name = "idx_ecriture_numero_piece", columnList = "numero_piece", unique = true),
+      @Index(name = "idx_ecriture_date", columnList = "date_ecriture"),
+      @Index(name = "idx_ecriture_journal", columnList = "journal_id"),
+      @Index(name = "idx_ecriture_organisation", columnList = "organisation_id"),
+      @Index(name = "idx_ecriture_paiement", columnList = "paiement_id")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class EcritureComptable extends BaseEntity {
+
+  /** Numéro de pièce unique */
+  @NotBlank
+  @Column(name = "numero_piece", unique = true, nullable = false, length = 50)
+  private String numeroPiece;
+
+  /** Date de l'écriture */
+  @NotNull
+  @Column(name = "date_ecriture", nullable = false)
+  private LocalDate dateEcriture;
+
+  /** Libellé de l'écriture */
+  @NotBlank
+  @Column(name = "libelle", nullable = false, length = 500)
+  private String libelle;
+
+  /** Référence externe */
+  @Column(name = "reference", length = 100)
+  private String reference;
+
+  /** Lettrage (pour rapprochement) */
+  @Column(name = "lettrage", length = 20)
+  private String lettrage;
+
+  /** Pointage (pour rapprochement bancaire) */
+  @Builder.Default
+  @Column(name = "pointe", nullable = false)
+  private Boolean pointe = false;
+
+  /** Montant total débit (somme des lignes) */
+  @Builder.Default
+  @DecimalMin(value = "0.0")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "montant_debit", precision = 14, scale = 2)
+  private BigDecimal montantDebit = BigDecimal.ZERO;
+
+  /** Montant total crédit (somme des lignes) */
+  @Builder.Default
+  @DecimalMin(value = "0.0")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "montant_credit", precision = 14, scale = 2)
+  private BigDecimal montantCredit = BigDecimal.ZERO;
+
+  /** Commentaires */
+  @Column(name = "commentaire", length = 1000)
+  private String commentaire;
+
+  // Relations
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "journal_id", nullable = false)
+  private JournalComptable journal;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "paiement_id")
+  private Paiement paiement;
+
+  /** Lignes d'écriture */
+  @JsonIgnore
+  @OneToMany(mappedBy = "ecriture", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<LigneEcriture> lignes = new ArrayList<>();
+
+  /** Méthode métier pour vérifier l'équilibre (Débit = Crédit) */
+  public boolean isEquilibree() {
+    if (montantDebit == null || montantCredit == null) {
+      return false;
+    }
+    return montantDebit.compareTo(montantCredit) == 0;
+  }
+
+  /** Méthode métier pour calculer les totaux à partir des lignes */
+  public void calculerTotaux() {
+    if (lignes == null || lignes.isEmpty()) {
+      montantDebit = BigDecimal.ZERO;
+      montantCredit = BigDecimal.ZERO;
+      return;
+    }
+
+    montantDebit =
+        lignes.stream()
+            .map(LigneEcriture::getMontantDebit)
+            .filter(amount -> amount != null)
+            .reduce(BigDecimal.ZERO, BigDecimal::add);
+
+    montantCredit =
+        lignes.stream()
+            .map(LigneEcriture::getMontantCredit)
+            .filter(amount -> amount != null)
+            .reduce(BigDecimal.ZERO, BigDecimal::add);
+  }
+
+  /** Méthode métier pour générer un numéro de pièce unique */
+  public static String genererNumeroPiece(String prefixe, LocalDate date) {
+    return String.format(
+        "%s-%04d%02d%02d-%012d",
+        prefixe, date.getYear(), date.getMonthValue(), date.getDayOfMonth(),
+        System.currentTimeMillis() % 1000000000000L);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (numeroPiece == null || numeroPiece.isEmpty()) {
+      numeroPiece = genererNumeroPiece("ECR", dateEcriture != null ? dateEcriture : LocalDate.now());
+    }
+    if (dateEcriture == null) {
+      dateEcriture = LocalDate.now();
+    }
+    if (montantDebit == null) {
+      montantDebit = BigDecimal.ZERO;
+    }
+    if (montantCredit == null) {
+      montantCredit = BigDecimal.ZERO;
+    }
+    if (pointe == null) {
+      pointe = false;
+    }
+    // Calculer les totaux si les lignes sont déjà présentes
+    if (lignes != null && !lignes.isEmpty()) {
+      calculerTotaux();
+    }
+  }
+
+  /** Callback JPA avant la mise à jour */
+  @PreUpdate
+  protected void onUpdate() {
+    calculerTotaux();
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/Evenement.java

@@ -1,259 +1,259 @@
-package dev.lions.unionflow.server.entity;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.UUID;
-import lombok.*;
-
-/**
- * Entité Événement pour la gestion des événements de l'union
- *
- * @author UnionFlow Team
- * @version 2.0
- * @since 2025-01-16
- */
-@Entity
-@Table(name = "evenements", indexes = {
-    @Index(name = "idx_evenement_date_debut", columnList = "date_debut"),
-    @Index(name = "idx_evenement_statut", columnList = "statut"),
-    @Index(name = "idx_evenement_type", columnList = "type_evenement"),
-    @Index(name = "idx_evenement_organisation", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Evenement extends BaseEntity {
-
-  @NotBlank
-  @Size(min = 3, max = 200)
-  @Column(name = "titre", nullable = false, length = 200)
-  private String titre;
-
-  @Size(max = 2000)
-  @Column(name = "description", length = 2000)
-  private String description;
-
-  @NotNull
-  @Column(name = "date_debut", nullable = false)
-  private LocalDateTime dateDebut;
-
-  @Column(name = "date_fin")
-  private LocalDateTime dateFin;
-
-  @Size(max = 500)
-  @Column(name = "lieu", length = 500)
-  private String lieu;
-
-  @Size(max = 1000)
-  @Column(name = "adresse", length = 1000)
-  private String adresse;
-
-  @Column(name = "type_evenement", length = 50)
-  private String typeEvenement;
-
-  @Builder.Default
-  @Column(name = "statut", nullable = false, length = 30)
-  private String statut = "PLANIFIE";
-
-  @Min(0)
-  @Column(name = "capacite_max")
-  private Integer capaciteMax;
-
-  @DecimalMin("0.00")
-  @Digits(integer = 8, fraction = 2)
-  @Column(name = "prix", precision = 10, scale = 2)
-  private BigDecimal prix;
-
-  @Builder.Default
-  @Column(name = "inscription_requise", nullable = false)
-  private Boolean inscriptionRequise = false;
-
-  @Column(name = "date_limite_inscription")
-  private LocalDateTime dateLimiteInscription;
-
-  @Size(max = 1000)
-  @Column(name = "instructions_particulieres", length = 1000)
-  private String instructionsParticulieres;
-
-  @Size(max = 500)
-  @Column(name = "contact_organisateur", length = 500)
-  private String contactOrganisateur;
-
-  @Size(max = 2000)
-  @Column(name = "materiel_requis", length = 2000)
-  private String materielRequis;
-
-  @Builder.Default
-  @Column(name = "visible_public", nullable = false)
-  private Boolean visiblePublic = true;
-
-  // Relations
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id")
-  private Organisation organisation;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisateur_id")
-  private Membre organisateur;
-
-  @JsonIgnore
-  @OneToMany(mappedBy = "evenement", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<InscriptionEvenement> inscriptions = new ArrayList<>();
-
-  @JsonIgnore
-  @OneToMany(mappedBy = "evenement", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<Adresse> adresses = new ArrayList<>();
-
-  /** Types d'événements */
-  public enum TypeEvenement {
-    ASSEMBLEE_GENERALE("Assemblée Générale"),
-    REUNION("Réunion"),
-    FORMATION("Formation"),
-    CONFERENCE("Conférence"),
-    ATELIER("Atelier"),
-    SEMINAIRE("Séminaire"),
-    EVENEMENT_SOCIAL("Événement Social"),
-    MANIFESTATION("Manifestation"),
-    CELEBRATION("Célébration"),
-    AUTRE("Autre");
-
-    private final String libelle;
-
-    TypeEvenement(String libelle) {
-      this.libelle = libelle;
-    }
-
-    public String getLibelle() {
-      return libelle;
-    }
-  }
-
-  /** Statuts d'événement */
-  public enum StatutEvenement {
-    PLANIFIE("Planifié"),
-    CONFIRME("Confirmé"),
-    EN_COURS("En cours"),
-    TERMINE("Terminé"),
-    ANNULE("Annulé"),
-    REPORTE("Reporté");
-
-    private final String libelle;
-
-    StatutEvenement(String libelle) {
-      this.libelle = libelle;
-    }
-
-    public String getLibelle() {
-      return libelle;
-    }
-  }
-
-  // Méthodes métier
-
-  /** Vérifie si l'événement est ouvert aux inscriptions */
-  @JsonIgnore
-  public boolean isOuvertAuxInscriptions() {
-    if (!inscriptionRequise || !getActif()) {
-      return false;
-    }
-
-    LocalDateTime maintenant = LocalDateTime.now();
-
-    // Vérifier si la date limite d'inscription n'est pas dépassée
-    if (dateLimiteInscription != null && maintenant.isAfter(dateLimiteInscription)) {
-      return false;
-    }
-
-    // Vérifier si l'événement n'a pas déjà commencé
-    if (maintenant.isAfter(dateDebut)) {
-      return false;
-    }
-
-    // Vérifier la capacité
-    if (capaciteMax != null && getNombreInscrits() >= capaciteMax) {
-      return false;
-    }
-
-    return "PLANIFIE".equals(statut) || "CONFIRME".equals(statut);
-  }
-
-  /** Obtient le nombre d'inscrits à l'événement */
-  @JsonIgnore
-  public int getNombreInscrits() {
-    return inscriptions != null
-        ? (int) inscriptions.stream()
-            .filter(
-                inscription -> InscriptionEvenement.StatutInscription.CONFIRMEE.name().equals(inscription.getStatut()))
-            .count()
-        : 0;
-  }
-
-  /** Vérifie si l'événement est complet */
-  @JsonIgnore
-  public boolean isComplet() {
-    return capaciteMax != null && getNombreInscrits() >= capaciteMax;
-  }
-
-  /** Vérifie si l'événement est en cours */
-  public boolean isEnCours() {
-    LocalDateTime maintenant = LocalDateTime.now();
-    return maintenant.isAfter(dateDebut) && (dateFin == null || maintenant.isBefore(dateFin));
-  }
-
-  /** Vérifie si l'événement est terminé */
-  public boolean isTermine() {
-    if ("TERMINE".equals(statut)) {
-      return true;
-    }
-
-    LocalDateTime maintenant = LocalDateTime.now();
-    return dateFin != null && maintenant.isAfter(dateFin);
-  }
-
-  /** Calcule la durée de l'événement en heures */
-  public Long getDureeEnHeures() {
-    if (dateFin == null) {
-      return null;
-    }
-
-    return java.time.Duration.between(dateDebut, dateFin).toHours();
-  }
-
-  /** Obtient le nombre de places restantes */
-  @JsonIgnore
-  public Integer getPlacesRestantes() {
-    if (capaciteMax == null) {
-      return null; // Capacité illimitée
-    }
-
-    return Math.max(0, capaciteMax - getNombreInscrits());
-  }
-
-  /** Vérifie si un membre est inscrit à l'événement */
-  public boolean isMemberInscrit(UUID membreId) {
-    return inscriptions != null
-        && inscriptions.stream()
-            .anyMatch(
-                inscription -> inscription.getMembre().getId().equals(membreId)
-                    && InscriptionEvenement.StatutInscription.CONFIRMEE.name().equals(inscription.getStatut()));
-  }
-
-  /** Obtient le taux de remplissage en pourcentage */
-  @JsonIgnore
-  public Double getTauxRemplissage() {
-    if (capaciteMax == null || capaciteMax == 0) {
-      return null;
-    }
-
-    return (double) getNombreInscrits() / capaciteMax * 100;
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+import lombok.*;
+
+/**
+ * Entité Événement pour la gestion des événements de l'union
+ *
+ * @author UnionFlow Team
+ * @version 2.0
+ * @since 2025-01-16
+ */
+@Entity
+@Table(name = "evenements", indexes = {
+    @Index(name = "idx_evenement_date_debut", columnList = "date_debut"),
+    @Index(name = "idx_evenement_statut", columnList = "statut"),
+    @Index(name = "idx_evenement_type", columnList = "type_evenement"),
+    @Index(name = "idx_evenement_organisation", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Evenement extends BaseEntity {
+
+  @NotBlank
+  @Size(min = 3, max = 200)
+  @Column(name = "titre", nullable = false, length = 200)
+  private String titre;
+
+  @Size(max = 2000)
+  @Column(name = "description", length = 2000)
+  private String description;
+
+  @NotNull
+  @Column(name = "date_debut", nullable = false)
+  private LocalDateTime dateDebut;
+
+  @Column(name = "date_fin")
+  private LocalDateTime dateFin;
+
+  @Size(max = 500)
+  @Column(name = "lieu", length = 500)
+  private String lieu;
+
+  @Size(max = 1000)
+  @Column(name = "adresse", length = 1000)
+  private String adresse;
+
+  @Column(name = "type_evenement", length = 50)
+  private String typeEvenement;
+
+  @Builder.Default
+  @Column(name = "statut", nullable = false, length = 30)
+  private String statut = "PLANIFIE";
+
+  @Min(0)
+  @Column(name = "capacite_max")
+  private Integer capaciteMax;
+
+  @DecimalMin("0.00")
+  @Digits(integer = 8, fraction = 2)
+  @Column(name = "prix", precision = 10, scale = 2)
+  private BigDecimal prix;
+
+  @Builder.Default
+  @Column(name = "inscription_requise", nullable = false)
+  private Boolean inscriptionRequise = false;
+
+  @Column(name = "date_limite_inscription")
+  private LocalDateTime dateLimiteInscription;
+
+  @Size(max = 1000)
+  @Column(name = "instructions_particulieres", length = 1000)
+  private String instructionsParticulieres;
+
+  @Size(max = 500)
+  @Column(name = "contact_organisateur", length = 500)
+  private String contactOrganisateur;
+
+  @Size(max = 2000)
+  @Column(name = "materiel_requis", length = 2000)
+  private String materielRequis;
+
+  @Builder.Default
+  @Column(name = "visible_public", nullable = false)
+  private Boolean visiblePublic = true;
+
+  // Relations
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisateur_id")
+  private Membre organisateur;
+
+  @JsonIgnore
+  @OneToMany(mappedBy = "evenement", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<InscriptionEvenement> inscriptions = new ArrayList<>();
+
+  @JsonIgnore
+  @OneToMany(mappedBy = "evenement", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<Adresse> adresses = new ArrayList<>();
+
+  /** Types d'événements */
+  public enum TypeEvenement {
+    ASSEMBLEE_GENERALE("Assemblée Générale"),
+    REUNION("Réunion"),
+    FORMATION("Formation"),
+    CONFERENCE("Conférence"),
+    ATELIER("Atelier"),
+    SEMINAIRE("Séminaire"),
+    EVENEMENT_SOCIAL("Événement Social"),
+    MANIFESTATION("Manifestation"),
+    CELEBRATION("Célébration"),
+    AUTRE("Autre");
+
+    private final String libelle;
+
+    TypeEvenement(String libelle) {
+      this.libelle = libelle;
+    }
+
+    public String getLibelle() {
+      return libelle;
+    }
+  }
+
+  /** Statuts d'événement */
+  public enum StatutEvenement {
+    PLANIFIE("Planifié"),
+    CONFIRME("Confirmé"),
+    EN_COURS("En cours"),
+    TERMINE("Terminé"),
+    ANNULE("Annulé"),
+    REPORTE("Reporté");
+
+    private final String libelle;
+
+    StatutEvenement(String libelle) {
+      this.libelle = libelle;
+    }
+
+    public String getLibelle() {
+      return libelle;
+    }
+  }
+
+  // Méthodes métier
+
+  /** Vérifie si l'événement est ouvert aux inscriptions */
+  @JsonIgnore
+  public boolean isOuvertAuxInscriptions() {
+    if (!inscriptionRequise || !getActif()) {
+      return false;
+    }
+
+    LocalDateTime maintenant = LocalDateTime.now();
+
+    // Vérifier si la date limite d'inscription n'est pas dépassée
+    if (dateLimiteInscription != null && maintenant.isAfter(dateLimiteInscription)) {
+      return false;
+    }
+
+    // Vérifier si l'événement n'a pas déjà commencé
+    if (maintenant.isAfter(dateDebut)) {
+      return false;
+    }
+
+    // Vérifier la capacité
+    if (capaciteMax != null && getNombreInscrits() >= capaciteMax) {
+      return false;
+    }
+
+    return "PLANIFIE".equals(statut) || "CONFIRME".equals(statut);
+  }
+
+  /** Obtient le nombre d'inscrits à l'événement */
+  @JsonIgnore
+  public int getNombreInscrits() {
+    return inscriptions != null
+        ? (int) inscriptions.stream()
+            .filter(
+                inscription -> InscriptionEvenement.StatutInscription.CONFIRMEE.name().equals(inscription.getStatut()))
+            .count()
+        : 0;
+  }
+
+  /** Vérifie si l'événement est complet */
+  @JsonIgnore
+  public boolean isComplet() {
+    return capaciteMax != null && getNombreInscrits() >= capaciteMax;
+  }
+
+  /** Vérifie si l'événement est en cours */
+  public boolean isEnCours() {
+    LocalDateTime maintenant = LocalDateTime.now();
+    return maintenant.isAfter(dateDebut) && (dateFin == null || maintenant.isBefore(dateFin));
+  }
+
+  /** Vérifie si l'événement est terminé */
+  public boolean isTermine() {
+    if ("TERMINE".equals(statut)) {
+      return true;
+    }
+
+    LocalDateTime maintenant = LocalDateTime.now();
+    return dateFin != null && maintenant.isAfter(dateFin);
+  }
+
+  /** Calcule la durée de l'événement en heures */
+  public Long getDureeEnHeures() {
+    if (dateFin == null) {
+      return null;
+    }
+
+    return java.time.Duration.between(dateDebut, dateFin).toHours();
+  }
+
+  /** Obtient le nombre de places restantes */
+  @JsonIgnore
+  public Integer getPlacesRestantes() {
+    if (capaciteMax == null) {
+      return null; // Capacité illimitée
+    }
+
+    return Math.max(0, capaciteMax - getNombreInscrits());
+  }
+
+  /** Vérifie si un membre est inscrit à l'événement */
+  public boolean isMemberInscrit(UUID membreId) {
+    return inscriptions != null
+        && inscriptions.stream()
+            .anyMatch(
+                inscription -> inscription.getMembre().getId().equals(membreId)
+                    && InscriptionEvenement.StatutInscription.CONFIRMEE.name().equals(inscription.getStatut()));
+  }
+
+  /** Obtient le taux de remplissage en pourcentage */
+  @JsonIgnore
+  public Double getTauxRemplissage() {
+    if (capaciteMax == null || capaciteMax == 0) {
+      return null;
+    }
+
+    return (double) getNombreInscrits() / capaciteMax * 100;
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Favori.java

@@ -1,79 +1,79 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-import java.time.LocalDateTime;
-import java.util.UUID;
-
-/**
- * Entité Favori pour la gestion des favoris utilisateur
- * 
- * @author UnionFlow Team
- * @version 1.0
- */
-@Entity
-@Table(
-    name = "favoris",
-    indexes = {
-        @Index(name = "idx_favori_utilisateur", columnList = "utilisateur_id"),
-        @Index(name = "idx_favori_type", columnList = "type_favori"),
-        @Index(name = "idx_favori_categorie", columnList = "categorie")
-    }
-)
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Favori extends BaseEntity {
-
-    @NotNull
-    @Column(name = "utilisateur_id", nullable = false)
-    private UUID utilisateurId;
-
-    @NotBlank
-    @Column(name = "type_favori", nullable = false, length = 50)
-    private String typeFavori; // PAGE, DOCUMENT, CONTACT, RACCOURCI
-
-    @NotBlank
-    @Column(name = "titre", nullable = false, length = 255)
-    private String titre;
-
-    @Column(name = "description", length = 1000)
-    private String description;
-
-    @Column(name = "url", length = 1000)
-    private String url;
-
-    @Column(name = "icon", length = 100)
-    private String icon;
-
-    @Column(name = "couleur", length = 50)
-    private String couleur;
-
-    @Column(name = "categorie", length = 100)
-    private String categorie;
-
-    @Column(name = "ordre")
-    @Builder.Default
-    private Integer ordre = 0;
-
-    @Column(name = "nb_visites")
-    @Builder.Default
-    private Integer nbVisites = 0;
-
-    @Column(name = "derniere_visite")
-    private LocalDateTime derniereVisite;
-
-    @Column(name = "est_plus_utilise")
-    @Builder.Default
-    private Boolean estPlusUtilise = false;
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+/**
+ * Entité Favori pour la gestion des favoris utilisateur
+ * 
+ * @author UnionFlow Team
+ * @version 1.0
+ */
+@Entity
+@Table(
+    name = "favoris",
+    indexes = {
+        @Index(name = "idx_favori_utilisateur", columnList = "utilisateur_id"),
+        @Index(name = "idx_favori_type", columnList = "type_favori"),
+        @Index(name = "idx_favori_categorie", columnList = "categorie")
+    }
+)
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Favori extends BaseEntity {
+
+    @NotNull
+    @Column(name = "utilisateur_id", nullable = false)
+    private UUID utilisateurId;
+
+    @NotBlank
+    @Column(name = "type_favori", nullable = false, length = 50)
+    private String typeFavori; // PAGE, DOCUMENT, CONTACT, RACCOURCI
+
+    @NotBlank
+    @Column(name = "titre", nullable = false, length = 255)
+    private String titre;
+
+    @Column(name = "description", length = 1000)
+    private String description;
+
+    @Column(name = "url", length = 1000)
+    private String url;
+
+    @Column(name = "icon", length = 100)
+    private String icon;
+
+    @Column(name = "couleur", length = 50)
+    private String couleur;
+
+    @Column(name = "categorie", length = 100)
+    private String categorie;
+
+    @Column(name = "ordre")
+    @Builder.Default
+    private Integer ordre = 0;
+
+    @Column(name = "nb_visites")
+    @Builder.Default
+    private Integer nbVisites = 0;
+
+    @Column(name = "derniere_visite")
+    private LocalDateTime derniereVisite;
+
+    @Column(name = "est_plus_utilise")
+    @Builder.Default
+    private Boolean estPlusUtilise = false;
+}
+

src/main/java/dev/lions/unionflow/server/entity/FeedbackEvenement.java

@@ -1,117 +1,117 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.Max;
-import jakarta.validation.constraints.Min;
-import jakarta.validation.constraints.NotNull;
-import java.time.LocalDateTime;
-import lombok.*;
-
-/**
- * Entité FeedbackEvenement représentant l'évaluation d'un membre sur un événement
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-16
- */
-@Entity
-@Table(
-    name = "feedbacks_evenement",
-    indexes = {
-      @Index(name = "idx_feedback_membre", columnList = "membre_id"),
-      @Index(name = "idx_feedback_evenement", columnList = "evenement_id"),
-      @Index(name = "idx_feedback_date", columnList = "date_feedback")
-    },
-    uniqueConstraints = {
-      @UniqueConstraint(
-          name = "uk_feedback_membre_evenement",
-          columnNames = {"membre_id", "evenement_id"})
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class FeedbackEvenement extends BaseEntity {
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "membre_id", nullable = false)
-  private Membre membre;
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "evenement_id", nullable = false)
-  private Evenement evenement;
-
-  @NotNull
-  @Min(1)
-  @Max(5)
-  @Column(name = "note", nullable = false)
-  private Integer note;
-
-  @Column(name = "commentaire", length = 1000)
-  private String commentaire;
-
-  @Builder.Default
-  @Column(name = "date_feedback", nullable = false)
-  private LocalDateTime dateFeedback = LocalDateTime.now();
-
-  @Column(name = "moderation_statut", length = 20)
-  @Builder.Default
-  private String moderationStatut = ModerationStatut.PUBLIE.name();
-
-  @Column(name = "raison_moderation", length = 500)
-  private String raisonModeration;
-
-  /** Énumération des statuts de modération */
-  public enum ModerationStatut {
-    PUBLIE, // Visible publiquement
-    EN_ATTENTE, // En attente de modération
-    REJETE // Rejeté par modération
-  }
-
-  // Méthodes utilitaires
-
-  /** Vérifie si le feedback est publié */
-  public boolean isPublie() {
-    return ModerationStatut.PUBLIE.name().equals(this.moderationStatut);
-  }
-
-  /** Marque le feedback comme en attente de modération */
-  public void mettreEnAttente(String raison) {
-    this.moderationStatut = ModerationStatut.EN_ATTENTE.name();
-    this.raisonModeration = raison;
-    setDateModification(LocalDateTime.now());
-  }
-
-  /** Publie le feedback */
-  public void publier() {
-    this.moderationStatut = ModerationStatut.PUBLIE.name();
-    this.raisonModeration = null;
-    setDateModification(LocalDateTime.now());
-  }
-
-  /** Rejette le feedback */
-  public void rejeter(String raison) {
-    this.moderationStatut = ModerationStatut.REJETE.name();
-    this.raisonModeration = raison;
-    setDateModification(LocalDateTime.now());
-  }
-
-  @PreUpdate
-  public void preUpdate() {
-    super.onUpdate();
-  }
-
-  @Override
-  public String toString() {
-    return String.format(
-        "FeedbackEvenement{id=%s, membre=%s, evenement=%s, note=%d, dateFeedback=%s}",
-        getId(),
-        membre != null ? membre.getEmail() : "null",
-        evenement != null ? evenement.getTitre() : "null",
-        note,
-        dateFeedback);
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+import lombok.*;
+
+/**
+ * Entité FeedbackEvenement représentant l'évaluation d'un membre sur un événement
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-16
+ */
+@Entity
+@Table(
+    name = "feedbacks_evenement",
+    indexes = {
+      @Index(name = "idx_feedback_membre", columnList = "membre_id"),
+      @Index(name = "idx_feedback_evenement", columnList = "evenement_id"),
+      @Index(name = "idx_feedback_date", columnList = "date_feedback")
+    },
+    uniqueConstraints = {
+      @UniqueConstraint(
+          name = "uk_feedback_membre_evenement",
+          columnNames = {"membre_id", "evenement_id"})
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class FeedbackEvenement extends BaseEntity {
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_id", nullable = false)
+  private Membre membre;
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "evenement_id", nullable = false)
+  private Evenement evenement;
+
+  @NotNull
+  @Min(1)
+  @Max(5)
+  @Column(name = "note", nullable = false)
+  private Integer note;
+
+  @Column(name = "commentaire", length = 1000)
+  private String commentaire;
+
+  @Builder.Default
+  @Column(name = "date_feedback", nullable = false)
+  private LocalDateTime dateFeedback = LocalDateTime.now();
+
+  @Column(name = "moderation_statut", length = 20)
+  @Builder.Default
+  private String moderationStatut = ModerationStatut.PUBLIE.name();
+
+  @Column(name = "raison_moderation", length = 500)
+  private String raisonModeration;
+
+  /** Énumération des statuts de modération */
+  public enum ModerationStatut {
+    PUBLIE, // Visible publiquement
+    EN_ATTENTE, // En attente de modération
+    REJETE // Rejeté par modération
+  }
+
+  // Méthodes utilitaires
+
+  /** Vérifie si le feedback est publié */
+  public boolean isPublie() {
+    return ModerationStatut.PUBLIE.name().equals(this.moderationStatut);
+  }
+
+  /** Marque le feedback comme en attente de modération */
+  public void mettreEnAttente(String raison) {
+    this.moderationStatut = ModerationStatut.EN_ATTENTE.name();
+    this.raisonModeration = raison;
+    setDateModification(LocalDateTime.now());
+  }
+
+  /** Publie le feedback */
+  public void publier() {
+    this.moderationStatut = ModerationStatut.PUBLIE.name();
+    this.raisonModeration = null;
+    setDateModification(LocalDateTime.now());
+  }
+
+  /** Rejette le feedback */
+  public void rejeter(String raison) {
+    this.moderationStatut = ModerationStatut.REJETE.name();
+    this.raisonModeration = raison;
+    setDateModification(LocalDateTime.now());
+  }
+
+  @PreUpdate
+  public void preUpdate() {
+    super.onUpdate();
+  }
+
+  @Override
+  public String toString() {
+    return String.format(
+        "FeedbackEvenement{id=%s, membre=%s, evenement=%s, note=%d, dateFeedback=%s}",
+        getId(),
+        membre != null ? membre.getEmail() : "null",
+        evenement != null ? evenement.getTitre() : "null",
+        note,
+        dateFeedback);
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/FormationLbcFt.java

@@ -0,0 +1,75 @@
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Session de formation LBC/FT (lutte contre le blanchiment de capitaux et le financement du
+ * terrorisme).
+ *
+ * <p>Obligation annuelle posée par l'<strong>Instruction BCEAO 001-03-2025 du 18 mars 2025</strong>
+ * pour le compliance officer + les dirigeants + les membres exposés (trésorier, secrétaire,
+ * commissaires aux comptes).
+ *
+ * @since 2026-04-25 (P1-NEW-12)
+ */
+@Entity
+@Table(name = "formations_lbcft", indexes = {
+    @Index(name = "idx_formation_org_annee", columnList = "organisation_id,annee_reference"),
+    @Index(name = "idx_formation_date", columnList = "date_session")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class FormationLbcFt extends BaseEntity {
+
+  @NotNull
+  @Column(name = "organisation_id", nullable = false)
+  private UUID organisationId;
+
+  @NotBlank
+  @Column(name = "titre", nullable = false, length = 255)
+  private String titre;
+
+  @NotBlank
+  @Column(name = "type_formation", nullable = false, length = 30)
+  @Builder.Default
+  private String typeFormation = "STANDARD"; // STANDARD, AVANCE, COMPLIANCE_OFFICER, DIRIGEANT
+
+  @Column(name = "contenu", columnDefinition = "TEXT")
+  private String contenu;
+
+  @Column(name = "intervenant", length = 255)
+  private String intervenant;
+
+  @Column(name = "duree_heures", precision = 4, scale = 1, nullable = false)
+  @Builder.Default
+  private BigDecimal dureeHeures = new BigDecimal("4.0");
+
+  @NotNull
+  @Column(name = "date_session", nullable = false)
+  private LocalDateTime dateSession;
+
+  @Column(name = "lieu", length = 255)
+  private String lieu;
+
+  @NotNull
+  @Column(name = "annee_reference", nullable = false)
+  private Integer anneeReference;
+
+  @NotBlank
+  @Column(name = "statut", nullable = false, length = 20)
+  @Builder.Default
+  private String statut = "PLANIFIEE"; // PLANIFIEE, EN_COURS, TERMINEE, ANNULEE
+}

src/main/java/dev/lions/unionflow/server/entity/FormuleAbonnement.java

@@ -1,120 +1,124 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.abonnement.PlageMembres;
-import dev.lions.unionflow.server.api.enums.abonnement.TypeFormule;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import lombok.*;
-
-/**
- * Catalogue des forfaits SaaS UnionFlow.
- *
- * <p>Starter (≤50) → Standard (≤200) → Premium (≤500) → Crystal (illimité)
- * Fourchette tarifaire : 5 000 à 10 000 XOF/mois. Stockage max : 1 Go.
- *
- * <p>Table : {@code formules_abonnement}
- */
-@Entity
-@Table(
-    name = "formules_abonnement",
-    indexes = {
-      @Index(name = "idx_formule_code_plage", columnList = "code, plage", unique = true),
-      @Index(name = "idx_formule_code",       columnList = "code"),
-      @Index(name = "idx_formule_plage",      columnList = "plage"),
-      @Index(name = "idx_formule_actif",      columnList = "actif")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class FormuleAbonnement extends BaseEntity {
-
-  @Enumerated(EnumType.STRING)
-  @NotNull
-  @Column(name = "code", nullable = false, length = 20)
-  private TypeFormule code;
-
-  /**
-   * Plage de taille d'organisation à laquelle cette formule s'applique.
-   * Combinée avec le code de formule, forme une clé unique dans le catalogue.
-   */
-  @Enumerated(EnumType.STRING)
-  @NotNull
-  @Column(name = "plage", nullable = false, length = 20)
-  private PlageMembres plage;
-
-  @NotBlank
-  @Column(name = "libelle", nullable = false, length = 100)
-  private String libelle;
-
-  @Column(name = "description", columnDefinition = "TEXT")
-  private String description;
-
-  /** Nombre maximum de membres. NULL = illimité (Crystal) */
-  @Column(name = "max_membres")
-  private Integer maxMembres;
-
-  /** Stockage maximum en Mo — 1 024 Mo (1 Go) par défaut */
-  @Builder.Default
-  @Column(name = "max_stockage_mo", nullable = false)
-  private Integer maxStockageMo = 1024;
-
-  @NotNull
-  @DecimalMin("0.00")
-  @Digits(integer = 8, fraction = 2)
-  @Column(name = "prix_mensuel", nullable = false, precision = 10, scale = 2)
-  private BigDecimal prixMensuel;
-
-  @NotNull
-  @DecimalMin("0.00")
-  @Digits(integer = 8, fraction = 2)
-  @Column(name = "prix_annuel", nullable = false, precision = 10, scale = 2)
-  private BigDecimal prixAnnuel;
-
-  @Builder.Default
-  @Column(name = "ordre_affichage", nullable = false)
-  private Integer ordreAffichage = 0;
-
-  // ── Champs Option C (ajoutés en V19) ──────────────────────────────────────
-
-  /** Nom commercial du plan (MICRO, DECOUVERTE, ESSENTIEL, AVANCE, PROFESSIONNEL, ENTERPRISE) */
-  @Column(name = "plan_commercial", length = 30)
-  private String planCommercial;
-
-  /** Niveau de reporting disponible (BASIQUE, STANDARD, AVANCE) */
-  @Column(name = "niveau_reporting", length = 20)
-  private String niveauReporting;
-
-  /** Accès à l'API REST (false pour les plans de base) */
-  @Builder.Default
-  @Column(name = "api_access", nullable = false)
-  private Boolean apiAccess = false;
-
-  /** Accès au module de fédération multi-org (ENTERPRISE uniquement) */
-  @Builder.Default
-  @Column(name = "federation_access", nullable = false)
-  private Boolean federationAccess = false;
-
-  /** Support prioritaire inclus */
-  @Builder.Default
-  @Column(name = "support_prioritaire", nullable = false)
-  private Boolean supportPrioritaire = false;
-
-  /** SLA garanti (ex: "99.0%", "99.9%") */
-  @Column(name = "sla_garanti", length = 10)
-  private String slaGaranti;
-
-  /** Nombre maximum d'administrateurs. NULL = illimité */
-  @Column(name = "max_admins")
-  private Integer maxAdmins;
-
-  public boolean isIllimitee() {
-    return maxMembres == null;
-  }
-
-  public boolean accepteNouveauMembre(int quotaActuel) {
-    return isIllimitee() || quotaActuel < maxMembres;
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.abonnement.PlageMembres;
+import dev.lions.unionflow.server.api.enums.abonnement.TypeFormule;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import lombok.*;
+
+/**
+ * Catalogue des forfaits SaaS UnionFlow.
+ *
+ * <p>Starter (≤50) → Standard (≤200) → Premium (≤500) → Crystal (illimité)
+ * Fourchette tarifaire : 5 000 à 10 000 XOF/mois. Stockage max : 1 Go.
+ *
+ * <p>Table : {@code formules_abonnement}
+ */
+@Entity
+@Table(
+    name = "formules_abonnement",
+    indexes = {
+      @Index(name = "idx_formule_code_plage", columnList = "code, plage", unique = true),
+      @Index(name = "idx_formule_code",       columnList = "code"),
+      @Index(name = "idx_formule_plage",      columnList = "plage"),
+      @Index(name = "idx_formule_actif",      columnList = "actif")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class FormuleAbonnement extends BaseEntity {
+
+  @Enumerated(EnumType.STRING)
+  @NotNull
+  @Column(name = "code", nullable = false, length = 20)
+  private TypeFormule code;
+
+  /**
+   * Plage de taille d'organisation à laquelle cette formule s'applique.
+   * Combinée avec le code de formule, forme une clé unique dans le catalogue.
+   */
+  @Enumerated(EnumType.STRING)
+  @NotNull
+  @Column(name = "plage", nullable = false, length = 20)
+  private PlageMembres plage;
+
+  @NotBlank
+  @Column(name = "libelle", nullable = false, length = 100)
+  private String libelle;
+
+  @Column(name = "description", columnDefinition = "TEXT")
+  private String description;
+
+  /** Nombre maximum de membres. NULL = illimité (Crystal) */
+  @Column(name = "max_membres")
+  private Integer maxMembres;
+
+  /** Stockage maximum en Mo — 1 024 Mo (1 Go) par défaut */
+  @Builder.Default
+  @Column(name = "max_stockage_mo", nullable = false)
+  private Integer maxStockageMo = 1024;
+
+  @NotNull
+  @DecimalMin("0.00")
+  @Digits(integer = 8, fraction = 2)
+  @Column(name = "prix_mensuel", nullable = false, precision = 10, scale = 2)
+  private BigDecimal prixMensuel;
+
+  @NotNull
+  @DecimalMin("0.00")
+  @Digits(integer = 8, fraction = 2)
+  @Column(name = "prix_annuel", nullable = false, precision = 10, scale = 2)
+  private BigDecimal prixAnnuel;
+
+  @Builder.Default
+  @Column(name = "ordre_affichage", nullable = false)
+  private Integer ordreAffichage = 0;
+
+  // ── Champs Option C (ajoutés en V19) ──────────────────────────────────────
+
+  /** Nom commercial du plan (MICRO, DECOUVERTE, ESSENTIEL, AVANCE, PROFESSIONNEL, ENTERPRISE) */
+  @Column(name = "plan_commercial", length = 30)
+  private String planCommercial;
+
+  /** Niveau de reporting disponible (BASIQUE, STANDARD, AVANCE) */
+  @Column(name = "niveau_reporting", length = 20)
+  private String niveauReporting;
+
+  /** Accès à l'API REST (false pour les plans de base) */
+  @Builder.Default
+  @Column(name = "api_access", nullable = false)
+  private Boolean apiAccess = false;
+
+  /** Accès au module de fédération multi-org (ENTERPRISE uniquement) */
+  @Builder.Default
+  @Column(name = "federation_access", nullable = false)
+  private Boolean federationAccess = false;
+
+  /** Support prioritaire inclus */
+  @Builder.Default
+  @Column(name = "support_prioritaire", nullable = false)
+  private Boolean supportPrioritaire = false;
+
+  /** SLA garanti (ex: "99.0%", "99.9%") */
+  @Column(name = "sla_garanti", length = 10)
+  private String slaGaranti;
+
+  /** Nombre maximum d'administrateurs. NULL = illimité */
+  @Column(name = "max_admins")
+  private Integer maxAdmins;
+
+  /** Code du provider de paiement par défaut (WAVE, ORANGE_MONEY, MTN_MOMO, PISPI). NULL = global. */
+  @Column(name = "provider_defaut", length = 20)
+  private String providerDefaut;
+
+  public boolean isIllimitee() {
+    return maxMembres == null;
+  }
+
+  public boolean accepteNouveauMembre(int quotaActuel) {
+    return isIllimitee() || quotaActuel < maxMembres;
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/InscriptionEvenement.java

@@ -1,143 +1,143 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import java.time.LocalDateTime;
-import lombok.*;
-
-/**
- * Entité InscriptionEvenement représentant l'inscription d'un membre à un
- * événement
- *
- * @author UnionFlow Team
- * @version 2.0
- * @since 2025-01-16
- */
-@Entity
-@Table(name = "inscriptions_evenement", indexes = {
-    @Index(name = "idx_inscription_membre", columnList = "membre_id"),
-    @Index(name = "idx_inscription_evenement", columnList = "evenement_id"),
-    @Index(name = "idx_inscription_date", columnList = "date_inscription")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class InscriptionEvenement extends BaseEntity {
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "membre_id", nullable = false)
-  private Membre membre;
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "evenement_id", nullable = false)
-  private Evenement evenement;
-
-  @Builder.Default
-  @Column(name = "date_inscription", nullable = false)
-  private LocalDateTime dateInscription = LocalDateTime.now();
-
-  @Column(name = "statut", length = 20)
-  @Builder.Default
-  private String statut = StatutInscription.CONFIRMEE.name();
-
-  @Column(name = "commentaire", length = 500)
-  private String commentaire;
-
-  /** Énumération des statuts d'inscription (pour constantes) */
-  public enum StatutInscription {
-    CONFIRMEE,
-    EN_ATTENTE,
-    ANNULEE,
-    REFUSEE;
-  }
-
-  // Méthodes utilitaires
-
-  /**
-   * Vérifie si l'inscription est confirmée
-   *
-   * @return true si l'inscription est confirmée
-   */
-  public boolean isConfirmee() {
-    return StatutInscription.CONFIRMEE.name().equals(this.statut);
-  }
-
-  /**
-   * Vérifie si l'inscription est en attente
-   *
-   * @return true si l'inscription est en attente
-   */
-  public boolean isEnAttente() {
-    return StatutInscription.EN_ATTENTE.name().equals(this.statut);
-  }
-
-  /**
-   * Vérifie si l'inscription est annulée
-   *
-   * @return true si l'inscription est annulée
-   */
-  public boolean isAnnulee() {
-    return StatutInscription.ANNULEE.name().equals(this.statut);
-  }
-
-  /** Confirme l'inscription */
-  public void confirmer() {
-    this.statut = StatutInscription.CONFIRMEE.name();
-    setDateModification(LocalDateTime.now());
-  }
-
-  /**
-   * Annule l'inscription
-   *
-   * @param commentaire le commentaire d'annulation
-   */
-  public void annuler(String commentaire) {
-    this.statut = StatutInscription.ANNULEE.name();
-    this.commentaire = commentaire;
-    setDateModification(LocalDateTime.now());
-  }
-
-  /**
-   * Met l'inscription en attente
-   *
-   * @param commentaire le commentaire de mise en attente
-   */
-  public void mettreEnAttente(String commentaire) {
-    this.statut = StatutInscription.EN_ATTENTE.name();
-    this.commentaire = commentaire;
-    setDateModification(LocalDateTime.now());
-  }
-
-  /**
-   * Refuser l'inscription
-   *
-   * @param commentaire le commentaire de refus
-   */
-  public void refuser(String commentaire) {
-    this.statut = StatutInscription.REFUSEE.name();
-    this.commentaire = commentaire;
-    setDateModification(LocalDateTime.now());
-  }
-
-  // Callbacks JPA
-
-  @PreUpdate
-  public void preUpdate() {
-    super.onUpdate();
-  }
-
-  @Override
-  public String toString() {
-    return String.format(
-        "InscriptionEvenement{id=%s, membre=%s, evenement=%s, statut=%s, dateInscription=%s}",
-        getId(),
-        membre != null ? membre.getEmail() : "null",
-        evenement != null ? evenement.getTitre() : "null",
-        statut,
-        dateInscription);
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+import lombok.*;
+
+/**
+ * Entité InscriptionEvenement représentant l'inscription d'un membre à un
+ * événement
+ *
+ * @author UnionFlow Team
+ * @version 2.0
+ * @since 2025-01-16
+ */
+@Entity
+@Table(name = "inscriptions_evenement", indexes = {
+    @Index(name = "idx_inscription_membre", columnList = "membre_id"),
+    @Index(name = "idx_inscription_evenement", columnList = "evenement_id"),
+    @Index(name = "idx_inscription_date", columnList = "date_inscription")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class InscriptionEvenement extends BaseEntity {
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_id", nullable = false)
+  private Membre membre;
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "evenement_id", nullable = false)
+  private Evenement evenement;
+
+  @Builder.Default
+  @Column(name = "date_inscription", nullable = false)
+  private LocalDateTime dateInscription = LocalDateTime.now();
+
+  @Column(name = "statut", length = 20)
+  @Builder.Default
+  private String statut = StatutInscription.CONFIRMEE.name();
+
+  @Column(name = "commentaire", length = 500)
+  private String commentaire;
+
+  /** Énumération des statuts d'inscription (pour constantes) */
+  public enum StatutInscription {
+    CONFIRMEE,
+    EN_ATTENTE,
+    ANNULEE,
+    REFUSEE;
+  }
+
+  // Méthodes utilitaires
+
+  /**
+   * Vérifie si l'inscription est confirmée
+   *
+   * @return true si l'inscription est confirmée
+   */
+  public boolean isConfirmee() {
+    return StatutInscription.CONFIRMEE.name().equals(this.statut);
+  }
+
+  /**
+   * Vérifie si l'inscription est en attente
+   *
+   * @return true si l'inscription est en attente
+   */
+  public boolean isEnAttente() {
+    return StatutInscription.EN_ATTENTE.name().equals(this.statut);
+  }
+
+  /**
+   * Vérifie si l'inscription est annulée
+   *
+   * @return true si l'inscription est annulée
+   */
+  public boolean isAnnulee() {
+    return StatutInscription.ANNULEE.name().equals(this.statut);
+  }
+
+  /** Confirme l'inscription */
+  public void confirmer() {
+    this.statut = StatutInscription.CONFIRMEE.name();
+    setDateModification(LocalDateTime.now());
+  }
+
+  /**
+   * Annule l'inscription
+   *
+   * @param commentaire le commentaire d'annulation
+   */
+  public void annuler(String commentaire) {
+    this.statut = StatutInscription.ANNULEE.name();
+    this.commentaire = commentaire;
+    setDateModification(LocalDateTime.now());
+  }
+
+  /**
+   * Met l'inscription en attente
+   *
+   * @param commentaire le commentaire de mise en attente
+   */
+  public void mettreEnAttente(String commentaire) {
+    this.statut = StatutInscription.EN_ATTENTE.name();
+    this.commentaire = commentaire;
+    setDateModification(LocalDateTime.now());
+  }
+
+  /**
+   * Refuser l'inscription
+   *
+   * @param commentaire le commentaire de refus
+   */
+  public void refuser(String commentaire) {
+    this.statut = StatutInscription.REFUSEE.name();
+    this.commentaire = commentaire;
+    setDateModification(LocalDateTime.now());
+  }
+
+  // Callbacks JPA
+
+  @PreUpdate
+  public void preUpdate() {
+    super.onUpdate();
+  }
+
+  @Override
+  public String toString() {
+    return String.format(
+        "InscriptionEvenement{id=%s, membre=%s, evenement=%s, statut=%s, dateInscription=%s}",
+        getId(),
+        membre != null ? membre.getEmail() : "null",
+        evenement != null ? evenement.getTitre() : "null",
+        statut,
+        dateInscription);
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/IntentionPaiement.java

@@ -1,122 +1,122 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.paiement.StatutIntentionPaiement;
-import dev.lions.unionflow.server.api.enums.paiement.TypeObjetIntentionPaiement;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-import lombok.*;
-
-/**
- * Hub centralisé pour tout paiement Wave initié depuis UnionFlow.
- *
- * <p>Flux :
- * <ol>
- *   <li>UnionFlow crée une {@code IntentionPaiement} avec les objets cibles (cotisations, etc.)</li>
- *   <li>UnionFlow appelle l'API Wave → récupère {@code waveCheckoutSessionId}</li>
- *   <li>Le membre confirme dans l'app Wave</li>
- *   <li>Wave envoie un webhook → UnionFlow réconcilie via {@code waveCheckoutSessionId}</li>
- *   <li>UnionFlow valide automatiquement les objets listés dans {@code objetsCibles}</li>
- * </ol>
- *
- * <p>Table : {@code intentions_paiement}
- */
-@Entity
-@Table(
-    name = "intentions_paiement",
-    indexes = {
-      @Index(name = "idx_intention_utilisateur",   columnList = "utilisateur_id"),
-      @Index(name = "idx_intention_statut",        columnList = "statut"),
-      @Index(name = "idx_intention_wave_session",  columnList = "wave_checkout_session_id", unique = true),
-      @Index(name = "idx_intention_expiration",    columnList = "date_expiration")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class IntentionPaiement extends BaseEntity {
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "utilisateur_id", nullable = false)
-  private Membre utilisateur;
-
-  /** NULL pour les abonnements UnionFlow SA (payés par l'organisation directement) */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id")
-  private Organisation organisation;
-
-  @NotNull
-  @DecimalMin("0.01")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "montant_total", nullable = false, precision = 14, scale = 2)
-  private BigDecimal montantTotal;
-
-  @NotBlank
-  @Pattern(regexp = "^[A-Z]{3}$")
-  @Builder.Default
-  @Column(name = "code_devise", nullable = false, length = 3)
-  private String codeDevise = "XOF";
-
-  @Enumerated(EnumType.STRING)
-  @NotNull
-  @Column(name = "type_objet", nullable = false, length = 30)
-  private TypeObjetIntentionPaiement typeObjet;
-
-  @Enumerated(EnumType.STRING)
-  @Builder.Default
-  @Column(name = "statut", nullable = false, length = 20)
-  private StatutIntentionPaiement statut = StatutIntentionPaiement.INITIEE;
-
-  /** ID de session Wave — clé de réconciliation sur webhook */
-  @Column(name = "wave_checkout_session_id", unique = true, length = 255)
-  private String waveCheckoutSessionId;
-
-  /** URL de paiement Wave à rediriger l'utilisateur */
-  @Column(name = "wave_launch_url", length = 1000)
-  private String waveLaunchUrl;
-
-  /** ID transaction Wave reçu via webhook */
-  @Column(name = "wave_transaction_id", length = 100)
-  private String waveTransactionId;
-
-  /**
-   * JSON : liste des objets couverts par ce paiement.
-   * Exemple : [{\"type\":\"COTISATION\",\"id\":\"uuid\",\"montant\":5000}, ...]
-   */
-  @Column(name = "objets_cibles", columnDefinition = "TEXT")
-  private String objetsCibles;
-
-  @Column(name = "date_expiration")
-  private LocalDateTime dateExpiration;
-
-  @Column(name = "date_completion")
-  private LocalDateTime dateCompletion;
-
-  // ── Méthodes métier ────────────────────────────────────────────────────────
-
-  public boolean isActive() {
-    return StatutIntentionPaiement.INITIEE.equals(statut)
-        || StatutIntentionPaiement.EN_COURS.equals(statut);
-  }
-
-  public boolean isExpiree() {
-    return dateExpiration != null && LocalDateTime.now().isAfter(dateExpiration);
-  }
-
-  public boolean isCompletee() {
-    return StatutIntentionPaiement.COMPLETEE.equals(statut);
-  }
-
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statut == null)    statut    = StatutIntentionPaiement.INITIEE;
-    if (codeDevise == null) codeDevise = "XOF";
-    if (dateExpiration == null) {
-      dateExpiration = LocalDateTime.now().plusMinutes(30);
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.paiement.StatutIntentionPaiement;
+import dev.lions.unionflow.server.api.enums.paiement.TypeObjetIntentionPaiement;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import lombok.*;
+
+/**
+ * Hub centralisé pour tout paiement Wave initié depuis UnionFlow.
+ *
+ * <p>Flux :
+ * <ol>
+ *   <li>UnionFlow crée une {@code IntentionPaiement} avec les objets cibles (cotisations, etc.)</li>
+ *   <li>UnionFlow appelle l'API Wave → récupère {@code waveCheckoutSessionId}</li>
+ *   <li>Le membre confirme dans l'app Wave</li>
+ *   <li>Wave envoie un webhook → UnionFlow réconcilie via {@code waveCheckoutSessionId}</li>
+ *   <li>UnionFlow valide automatiquement les objets listés dans {@code objetsCibles}</li>
+ * </ol>
+ *
+ * <p>Table : {@code intentions_paiement}
+ */
+@Entity
+@Table(
+    name = "intentions_paiement",
+    indexes = {
+      @Index(name = "idx_intention_utilisateur",   columnList = "utilisateur_id"),
+      @Index(name = "idx_intention_statut",        columnList = "statut"),
+      @Index(name = "idx_intention_wave_session",  columnList = "wave_checkout_session_id", unique = true),
+      @Index(name = "idx_intention_expiration",    columnList = "date_expiration")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class IntentionPaiement extends BaseEntity {
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "utilisateur_id", nullable = false)
+  private Membre utilisateur;
+
+  /** NULL pour les abonnements UnionFlow SA (payés par l'organisation directement) */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  @NotNull
+  @DecimalMin("0.01")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "montant_total", nullable = false, precision = 14, scale = 2)
+  private BigDecimal montantTotal;
+
+  @NotBlank
+  @Pattern(regexp = "^[A-Z]{3}$")
+  @Builder.Default
+  @Column(name = "code_devise", nullable = false, length = 3)
+  private String codeDevise = "XOF";
+
+  @Enumerated(EnumType.STRING)
+  @NotNull
+  @Column(name = "type_objet", nullable = false, length = 30)
+  private TypeObjetIntentionPaiement typeObjet;
+
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "statut", nullable = false, length = 20)
+  private StatutIntentionPaiement statut = StatutIntentionPaiement.INITIEE;
+
+  /** ID de session Wave — clé de réconciliation sur webhook */
+  @Column(name = "wave_checkout_session_id", unique = true, length = 255)
+  private String waveCheckoutSessionId;
+
+  /** URL de paiement Wave à rediriger l'utilisateur */
+  @Column(name = "wave_launch_url", length = 1000)
+  private String waveLaunchUrl;
+
+  /** ID transaction Wave reçu via webhook */
+  @Column(name = "wave_transaction_id", length = 100)
+  private String waveTransactionId;
+
+  /**
+   * JSON : liste des objets couverts par ce paiement.
+   * Exemple : [{\"type\":\"COTISATION\",\"id\":\"uuid\",\"montant\":5000}, ...]
+   */
+  @Column(name = "objets_cibles", columnDefinition = "TEXT")
+  private String objetsCibles;
+
+  @Column(name = "date_expiration")
+  private LocalDateTime dateExpiration;
+
+  @Column(name = "date_completion")
+  private LocalDateTime dateCompletion;
+
+  // ── Méthodes métier ────────────────────────────────────────────────────────
+
+  public boolean isActive() {
+    return StatutIntentionPaiement.INITIEE.equals(statut)
+        || StatutIntentionPaiement.EN_COURS.equals(statut);
+  }
+
+  public boolean isExpiree() {
+    return dateExpiration != null && LocalDateTime.now().isAfter(dateExpiration);
+  }
+
+  public boolean isCompletee() {
+    return StatutIntentionPaiement.COMPLETEE.equals(statut);
+  }
+
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statut == null)    statut    = StatutIntentionPaiement.INITIEE;
+    if (codeDevise == null) codeDevise = "XOF";
+    if (dateExpiration == null) {
+      dateExpiration = LocalDateTime.now().plusMinutes(30);
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/JournalComptable.java

@@ -1,100 +1,108 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.comptabilite.TypeJournalComptable;
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import java.time.LocalDate;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité JournalComptable pour la gestion des journaux
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "journaux_comptables",
-    indexes = {
-      @Index(name = "idx_journal_code", columnList = "code", unique = true),
-      @Index(name = "idx_journal_type", columnList = "type_journal"),
-      @Index(name = "idx_journal_periode", columnList = "date_debut, date_fin")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class JournalComptable extends BaseEntity {
-
-  /** Code unique du journal */
-  @NotBlank
-  @Column(name = "code", unique = true, nullable = false, length = 10)
-  private String code;
-
-  /** Libellé du journal */
-  @NotBlank
-  @Column(name = "libelle", nullable = false, length = 100)
-  private String libelle;
-
-  /** Type de journal */
-  @NotNull
-  @Enumerated(EnumType.STRING)
-  @Column(name = "type_journal", nullable = false, length = 30)
-  private TypeJournalComptable typeJournal;
-
-  /** Date de début de la période */
-  @Column(name = "date_debut")
-  private LocalDate dateDebut;
-
-  /** Date de fin de la période */
-  @Column(name = "date_fin")
-  private LocalDate dateFin;
-
-  /** Statut du journal (OUVERT, FERME, ARCHIVE) */
-  @Builder.Default
-  @Column(name = "statut", length = 20)
-  private String statut = "OUVERT";
-
-  /** Description */
-  @Column(name = "description", length = 500)
-  private String description;
-
-  /** Écritures comptables associées */
-  @JsonIgnore
-  @OneToMany(mappedBy = "journal", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<EcritureComptable> ecritures = new ArrayList<>();
-
-  /** Méthode métier pour vérifier si le journal est ouvert */
-  public boolean isOuvert() {
-    return "OUVERT".equals(statut);
-  }
-
-  /** Méthode métier pour vérifier si une date est dans la période */
-  public boolean estDansPeriode(LocalDate date) {
-    if (dateDebut == null || dateFin == null) {
-      return true; // Période illimitée
-    }
-    return !date.isBefore(dateDebut) && !date.isAfter(dateFin);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statut == null || statut.isEmpty()) {
-      statut = "OUVERT";
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.comptabilite.TypeJournalComptable;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité JournalComptable pour la gestion des journaux
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "journaux_comptables",
+    uniqueConstraints = {
+      @UniqueConstraint(name = "uk_journaux_org_code", columnNames = {"organisation_id", "code"})
+    },
+    indexes = {
+      @Index(name = "idx_journal_code", columnList = "code"),
+      @Index(name = "idx_journal_type", columnList = "type_journal"),
+      @Index(name = "idx_journal_periode", columnList = "date_debut, date_fin")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class JournalComptable extends BaseEntity {
+
+  /** Code du journal (unique par organisation). */
+  @NotBlank
+  @Column(name = "code", nullable = false, length = 10)
+  private String code;
+
+  /** Libellé du journal */
+  @NotBlank
+  @Column(name = "libelle", nullable = false, length = 100)
+  private String libelle;
+
+  /** Type de journal */
+  @NotNull
+  @Enumerated(EnumType.STRING)
+  @Column(name = "type_journal", nullable = false, length = 30)
+  private TypeJournalComptable typeJournal;
+
+  /** Date de début de la période */
+  @Column(name = "date_debut")
+  private LocalDate dateDebut;
+
+  /** Date de fin de la période */
+  @Column(name = "date_fin")
+  private LocalDate dateFin;
+
+  /** Statut du journal (OUVERT, FERME, ARCHIVE) */
+  @Builder.Default
+  @Column(name = "statut", length = 20)
+  private String statut = "OUVERT";
+
+  /** Description */
+  @Column(name = "description", length = 500)
+  private String description;
+
+  /** Organisation propriétaire */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  /** Écritures comptables associées */
+  @JsonIgnore
+  @OneToMany(mappedBy = "journal", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<EcritureComptable> ecritures = new ArrayList<>();
+
+  /** Méthode métier pour vérifier si le journal est ouvert */
+  public boolean isOuvert() {
+    return "OUVERT".equals(statut);
+  }
+
+  /** Méthode métier pour vérifier si une date est dans la période */
+  public boolean estDansPeriode(LocalDate date) {
+    if (dateDebut == null || dateFin == null) {
+      return true; // Période illimitée
+    }
+    return !date.isBefore(dateDebut) && !date.isAfter(dateFin);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statut == null || statut.isEmpty()) {
+      statut = "OUVERT";
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/KycDossier.java

@@ -0,0 +1,135 @@
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.membre.NiveauRisqueKyc;
+import dev.lions.unionflow.server.api.enums.membre.StatutKyc;
+import dev.lions.unionflow.server.api.enums.membre.TypePieceIdentite;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import lombok.*;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+/**
+ * Dossier KYC/AML d'un membre — conformité GIABA/BCEAO LCB-FT.
+ *
+ * <p>Rétention 10 ans requise par le GIABA. La colonne {@code anneeReference}
+ * sert à l'archivage logique par année (partitionnement futur PostgreSQL).
+ *
+ * <p>Un seul dossier actif ({@code actif=true}) par membre à la fois.
+ * Les dossiers expirés ou archivés ont {@code actif=false}.
+ */
+@Entity
+@Table(
+    name = "kyc_dossier",
+    indexes = {
+        @Index(name = "idx_kyc_membre_id",     columnList = "membre_id"),
+        @Index(name = "idx_kyc_statut",        columnList = "statut"),
+        @Index(name = "idx_kyc_niveau_risque", columnList = "niveau_risque"),
+        @Index(name = "idx_kyc_annee",         columnList = "annee_reference")
+    }
+)
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class KycDossier extends BaseEntity {
+
+    @NotNull
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "membre_id", nullable = false)
+    private Membre membre;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_piece", nullable = false, length = 30)
+    private TypePieceIdentite typePiece;
+
+    @NotBlank
+    @Size(max = 50)
+    @Column(name = "numero_piece", nullable = false, length = 50)
+    private String numeroPiece;
+
+    @Column(name = "date_expiration_piece")
+    private LocalDate dateExpirationPiece;
+
+    @Size(max = 500)
+    @Column(name = "piece_identite_recto_file_id", length = 500)
+    private String pieceIdentiteRectoFileId;
+
+    @Size(max = 500)
+    @Column(name = "piece_identite_verso_file_id", length = 500)
+    private String pieceIdentiteVersoFileId;
+
+    @Size(max = 500)
+    @Column(name = "justif_domicile_file_id", length = 500)
+    private String justifDomicileFileId;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 20)
+    @Builder.Default
+    private StatutKyc statut = StatutKyc.NON_VERIFIE;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "niveau_risque", nullable = false, length = 20)
+    @Builder.Default
+    private NiveauRisqueKyc niveauRisque = NiveauRisqueKyc.FAIBLE;
+
+    @Min(0) @Max(100)
+    @Column(name = "score_risque", nullable = false)
+    @Builder.Default
+    private int scoreRisque = 0;
+
+    @Builder.Default
+    @Column(name = "est_pep", nullable = false)
+    private boolean estPep = false;
+
+    @Size(max = 5)
+    @Column(name = "nationalite", length = 5)
+    private String nationalite;
+
+    @Column(name = "date_verification")
+    private LocalDateTime dateVerification;
+
+    @Column(name = "validateur_id")
+    private UUID validateurId;
+
+    @Size(max = 1000)
+    @Column(name = "notes_validateur", length = 1000)
+    private String notesValidateur;
+
+    @Column(name = "annee_reference", nullable = false)
+    @Builder.Default
+    private int anneeReference = java.time.LocalDate.now().getYear();
+
+    /** Pays d'origine des fonds (ISO-3) — anti-blanchiment transferts internationaux. */
+    @Size(max = 3)
+    @Column(name = "pays_origine_fonds", length = 3)
+    private String paysOrigineFonds;
+
+    /** URL/chemin justificatif domicile étranger (facture EDF/British Gas/etc.) pour non-résidents. */
+    @Size(max = 500)
+    @Column(name = "justificatif_residence_etrangere", length = 500)
+    private String justificatifResidenceEtrangere;
+
+    /**
+     * Niveau de due diligence (Instr. BCEAO 001-03-2025) :
+     * <ul>
+     *   <li>SIMPLIFIE — risque faible, opérations limitées</li>
+     *   <li>STANDARD — défaut</li>
+     *   <li>RENFORCE — non-résidents, PEP, FATF grey-list</li>
+     * </ul>
+     */
+    @Size(max = 20)
+    @Column(name = "niveau_due_diligence", nullable = false, length = 20)
+    @Builder.Default
+    private String niveauDueDiligence = "STANDARD";
+
+    public boolean isPieceExpiree() {
+        return dateExpirationPiece != null && dateExpirationPiece.isBefore(LocalDate.now());
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/LigneEcriture.java

@@ -1,100 +1,100 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité LigneEcriture pour les lignes d'une écriture comptable
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "lignes_ecriture",
-    indexes = {
-      @Index(name = "idx_ligne_ecriture_ecriture", columnList = "ecriture_id"),
-      @Index(name = "idx_ligne_ecriture_compte", columnList = "compte_comptable_id")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class LigneEcriture extends BaseEntity {
-
-  /** Numéro de ligne */
-  @NotNull
-  @Min(value = 1, message = "Le numéro de ligne doit être positif")
-  @Column(name = "numero_ligne", nullable = false)
-  private Integer numeroLigne;
-
-  /** Montant débit */
-  @DecimalMin(value = "0.0", message = "Le montant débit doit être positif ou nul")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "montant_debit", precision = 14, scale = 2)
-  private BigDecimal montantDebit;
-
-  /** Montant crédit */
-  @DecimalMin(value = "0.0", message = "Le montant crédit doit être positif ou nul")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "montant_credit", precision = 14, scale = 2)
-  private BigDecimal montantCredit;
-
-  /** Libellé de la ligne */
-  @Column(name = "libelle", length = 500)
-  private String libelle;
-
-  /** Référence */
-  @Column(name = "reference", length = 100)
-  private String reference;
-
-  // Relations
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "ecriture_id", nullable = false)
-  private EcritureComptable ecriture;
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "compte_comptable_id", nullable = false)
-  private CompteComptable compteComptable;
-
-  /** Méthode métier pour vérifier que la ligne a soit un débit soit un crédit (pas les deux) */
-  public boolean isValide() {
-    boolean aDebit = montantDebit != null && montantDebit.compareTo(BigDecimal.ZERO) > 0;
-    boolean aCredit = montantCredit != null && montantCredit.compareTo(BigDecimal.ZERO) > 0;
-    return aDebit != aCredit; // XOR : soit débit, soit crédit, pas les deux
-  }
-
-  /** Méthode métier pour obtenir le montant (débit ou crédit) */
-  public BigDecimal getMontant() {
-    if (montantDebit != null && montantDebit.compareTo(BigDecimal.ZERO) > 0) {
-      return montantDebit;
-    }
-    if (montantCredit != null && montantCredit.compareTo(BigDecimal.ZERO) > 0) {
-      return montantCredit;
-    }
-    return BigDecimal.ZERO;
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (montantDebit == null) {
-      montantDebit = BigDecimal.ZERO;
-    }
-    if (montantCredit == null) {
-      montantCredit = BigDecimal.ZERO;
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité LigneEcriture pour les lignes d'une écriture comptable
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "lignes_ecriture",
+    indexes = {
+      @Index(name = "idx_ligne_ecriture_ecriture", columnList = "ecriture_id"),
+      @Index(name = "idx_ligne_ecriture_compte", columnList = "compte_comptable_id")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class LigneEcriture extends BaseEntity {
+
+  /** Numéro de ligne */
+  @NotNull
+  @Min(value = 1, message = "Le numéro de ligne doit être positif")
+  @Column(name = "numero_ligne", nullable = false)
+  private Integer numeroLigne;
+
+  /** Montant débit */
+  @DecimalMin(value = "0.0", message = "Le montant débit doit être positif ou nul")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "montant_debit", precision = 14, scale = 2)
+  private BigDecimal montantDebit;
+
+  /** Montant crédit */
+  @DecimalMin(value = "0.0", message = "Le montant crédit doit être positif ou nul")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "montant_credit", precision = 14, scale = 2)
+  private BigDecimal montantCredit;
+
+  /** Libellé de la ligne */
+  @Column(name = "libelle", length = 500)
+  private String libelle;
+
+  /** Référence */
+  @Column(name = "reference", length = 100)
+  private String reference;
+
+  // Relations
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "ecriture_id", nullable = false)
+  private EcritureComptable ecriture;
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "compte_comptable_id", nullable = false)
+  private CompteComptable compteComptable;
+
+  /** Méthode métier pour vérifier que la ligne a soit un débit soit un crédit (pas les deux) */
+  public boolean isValide() {
+    boolean aDebit = montantDebit != null && montantDebit.compareTo(BigDecimal.ZERO) > 0;
+    boolean aCredit = montantCredit != null && montantCredit.compareTo(BigDecimal.ZERO) > 0;
+    return aDebit != aCredit; // XOR : soit débit, soit crédit, pas les deux
+  }
+
+  /** Méthode métier pour obtenir le montant (débit ou crédit) */
+  public BigDecimal getMontant() {
+    if (montantDebit != null && montantDebit.compareTo(BigDecimal.ZERO) > 0) {
+      return montantDebit;
+    }
+    if (montantCredit != null && montantCredit.compareTo(BigDecimal.ZERO) > 0) {
+      return montantCredit;
+    }
+    return BigDecimal.ZERO;
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (montantDebit == null) {
+      montantDebit = BigDecimal.ZERO;
+    }
+    if (montantCredit == null) {
+      montantCredit = BigDecimal.ZERO;
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/Membre.java

@@ -1,169 +1,215 @@
-package dev.lions.unionflow.server.entity;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.time.LocalDate;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.UUID;
-import lombok.*;
-
-/**
- * Identité globale unique d'un utilisateur UnionFlow.
- *
- * <p>
- * Un utilisateur possède un seul compte sur toute la plateforme.
- * Ses adhésions aux organisations sont gérées dans {@link MembreOrganisation}.
- *
- * <p>
- * Table : {@code utilisateurs}
- */
-@Entity
-@Table(name = "utilisateurs", indexes = {
-    @Index(name = "idx_utilisateur_email", columnList = "email", unique = true),
-    @Index(name = "idx_utilisateur_numero", columnList = "numero_membre", unique = true),
-    @Index(name = "idx_utilisateur_keycloak", columnList = "keycloak_id", unique = true),
-    @Index(name = "idx_utilisateur_actif", columnList = "actif"),
-    @Index(name = "idx_utilisateur_statut", columnList = "statut_compte")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Membre extends BaseEntity {
-
-  /** Identifiant Keycloak (UUID du compte OIDC) */
-  @Column(name = "keycloak_id", unique = true)
-  private UUID keycloakId;
-
-  /** Numéro de membre — unique globalement sur toute la plateforme */
-  @NotBlank
-  @Column(name = "numero_membre", unique = true, nullable = false, length = 20)
-  private String numeroMembre;
-
-  @NotBlank
-  @Column(name = "prenom", nullable = false, length = 100)
-  private String prenom;
-
-  @NotBlank
-  @Column(name = "nom", nullable = false, length = 100)
-  private String nom;
-
-  @Email
-  @NotBlank
-  @Column(name = "email", unique = true, nullable = false, length = 255)
-  private String email;
-
-  @Column(name = "telephone", length = 20)
-  private String telephone;
-
-  @Pattern(regexp = "^\\+[1-9][0-9]{6,14}$", message = "Le numéro Wave doit être au format international E.164 (ex: +22507XXXXXXXX)")
-  @Column(name = "telephone_wave", length = 20)
-  private String telephoneWave;
-
-  @NotNull
-  @Column(name = "date_naissance", nullable = false)
-  private LocalDate dateNaissance;
-
-  @Column(name = "profession", length = 100)
-  private String profession;
-
-  @Column(name = "photo_url", length = 500)
-  private String photoUrl;
-
-  @Builder.Default
-  @Column(name = "statut_compte", nullable = false, length = 30)
-  private String statutCompte = "EN_ATTENTE_VALIDATION";
-
-  /** Vrai si le membre n'a jamais changé son mot de passe généré par l'admin. */
-  @Builder.Default
-  @Column(name = "premiere_connexion", nullable = false)
-  private Boolean premiereConnexion = true;
-
-  /**
-   * Statut matrimonial (domaine
-   * {@code STATUT_MATRIMONIAL} dans
-   * {@code types_reference}).
-   */
-  @Column(name = "statut_matrimonial", length = 50)
-  private String statutMatrimonial;
-
-  /** Nationalité. */
-  @Column(name = "nationalite", length = 100)
-  private String nationalite;
-
-  /**
-   * Type de pièce d'identité (domaine
-   * {@code TYPE_IDENTITE} dans
-   * {@code types_reference}).
-   */
-  @Column(name = "type_identite", length = 50)
-  private String typeIdentite;
-
-  /** Numéro de la pièce d'identité. */
-  @Column(name = "numero_identite", length = 100)
-  private String numeroIdentite;
-
-  /** Notes / biographie libre du membre. */
-  @Column(name = "notes", length = 1000)
-  private String notes;
-
-  /** Niveau de vigilance KYC LCB-FT (SIMPLIFIE, RENFORCE). */
-  @Column(name = "niveau_vigilance_kyc", length = 20)
-  private String niveauVigilanceKyc;
-
-  /** Statut de vérification d'identité (NON_VERIFIE, EN_COURS, VERIFIE, REFUSE). */
-  @Column(name = "statut_kyc", length = 20)
-  private String statutKyc;
-
-  /** Date de dernière vérification d'identité. */
-  @Column(name = "date_verification_identite")
-  private LocalDate dateVerificationIdentite;
-
-  // ── Relations ────────────────────────────────────────────────────────────
-
-  /** Adhésions à des organisations */
-  @JsonIgnore
-  @OneToMany(mappedBy = "membre", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<MembreOrganisation> membresOrganisations = new ArrayList<>();
-
-  @JsonIgnore
-  @OneToMany(mappedBy = "membre", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<Adresse> adresses = new ArrayList<>();
-
-  @JsonIgnore
-  @OneToMany(mappedBy = "membre", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<CompteWave> comptesWave = new ArrayList<>();
-
-  @JsonIgnore
-  @OneToMany(mappedBy = "membre", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<Paiement> paiements = new ArrayList<>();
-
-  // ── Méthodes métier ───────────────────────────────────────────────────────
-
-  public String getNomComplet() {
-    return prenom + " " + nom;
-  }
-
-  public boolean isMajeur() {
-    return dateNaissance != null && dateNaissance.isBefore(LocalDate.now().minusYears(18));
-  }
-
-  public int getAge() {
-    return dateNaissance != null ? LocalDate.now().getYear() - dateNaissance.getYear() : 0;
-  }
-
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statutCompte == null) {
-      statutCompte = "EN_ATTENTE_VALIDATION";
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+import lombok.*;
+
+/**
+ * Identité globale unique d'un utilisateur UnionFlow.
+ *
+ * <p>
+ * Un utilisateur possède un seul compte sur toute la plateforme.
+ * Ses adhésions aux organisations sont gérées dans {@link MembreOrganisation}.
+ *
+ * <p>
+ * Table : {@code utilisateurs}
+ */
+@Entity
+@Table(name = "utilisateurs", indexes = {
+    @Index(name = "idx_utilisateur_email", columnList = "email", unique = true),
+    @Index(name = "idx_utilisateur_numero", columnList = "numero_membre", unique = true),
+    @Index(name = "idx_utilisateur_keycloak", columnList = "keycloak_id", unique = true),
+    @Index(name = "idx_utilisateur_actif", columnList = "actif"),
+    @Index(name = "idx_utilisateur_statut", columnList = "statut_compte")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Membre extends BaseEntity {
+
+  /** Identifiant Keycloak (UUID du compte OIDC) */
+  @Column(name = "keycloak_id", unique = true)
+  private UUID keycloakId;
+
+  /** Numéro de membre — unique globalement sur toute la plateforme */
+  @NotBlank
+  @Column(name = "numero_membre", unique = true, nullable = false, length = 20)
+  private String numeroMembre;
+
+  @NotBlank
+  @Column(name = "prenom", nullable = false, length = 100)
+  private String prenom;
+
+  @NotBlank
+  @Column(name = "nom", nullable = false, length = 100)
+  private String nom;
+
+  @Email
+  @NotBlank
+  @Column(name = "email", unique = true, nullable = false, length = 255)
+  private String email;
+
+  @Column(name = "telephone", length = 20)
+  private String telephone;
+
+  /** Token FCM pour les notifications push Firebase. NULL si l'app mobile n'est pas installée ou si le membre a refusé les notifications. */
+  @Column(name = "fcm_token", length = 500)
+  private String fcmToken;
+
+  /**
+   * Numéro CMU (Couverture Maladie Universelle) Côte d'Ivoire — auto-déclaré par le membre.
+   *
+   * <p>Obligatoire pour les organisations de type {@code MUTUELLE_SANTE} (Loi 2014-131
+   * exige enrôlement CMU comme préalable à toute mutuelle complémentaire). Format CNAM :
+   * 11 caractères alphanumériques. La vérification de la validité se fait manuellement
+   * (admin) faute d'API publique CNAM disponible au 2026-04-25.
+   *
+   * @since 2026-04-25 — passage CMU à cotisation obligatoire 1er jan 2026
+   */
+  @Pattern(regexp = "^[A-Z0-9]{11}$|^$", message = "Le numéro CMU doit faire 11 caractères alphanumériques majuscules")
+  @Column(name = "numero_cmu", length = 11)
+  private String numeroCMU;
+
+  /**
+   * Pays de résidence (ISO-3, ex: FRA, USA, CAN). Différent de {@code nationalite} :
+   * un Ivoirien (CIV) résidant en France a paysResidence=FRA. NULL ou CIV = résident UEMOA.
+   *
+   * @since 2026-04-25 (P2-NEW-7)
+   */
+  @Pattern(regexp = "^[A-Z]{3}$|^$", message = "Pays résidence doit être un code ISO-3")
+  @Column(name = "pays_residence", length = 3)
+  private String paysResidence;
+
+  /** Numéro de passeport pour non-résidents (CNI insuffisante hors UEMOA). */
+  @Column(name = "numero_passeport", length = 50)
+  private String numeroPasseport;
+
+  /** NIF/SSN/SIN — reporting fiscal accord bilatéral CI ↔ pays résidence. */
+  @Column(name = "numero_fiscal_etranger", length = 50)
+  private String numeroFiscalEtranger;
+
+  /** TRUE si le membre est diaspora (résidence ≠ UEMOA). */
+  @Builder.Default
+  @Column(name = "est_diaspora", nullable = false)
+  private Boolean estDiaspora = false;
+
+  /** Devise préférée pour affichages et notifications (XOF par défaut). */
+  @Builder.Default
+  @Column(name = "devise_preferee", nullable = false, length = 3)
+  private String devisePreferee = "XOF";
+
+  @Pattern(regexp = "^\\+[1-9][0-9]{6,14}$", message = "Le numéro Wave doit être au format international E.164 (ex: +22507XXXXXXXX)")
+  @Column(name = "telephone_wave", length = 20)
+  private String telephoneWave;
+
+  @NotNull
+  @Column(name = "date_naissance", nullable = false)
+  private LocalDate dateNaissance;
+
+  @Column(name = "profession", length = 100)
+  private String profession;
+
+  @Column(name = "photo_url", length = 500)
+  private String photoUrl;
+
+  @Builder.Default
+  @Column(name = "statut_compte", nullable = false, length = 30)
+  private String statutCompte = "EN_ATTENTE_VALIDATION";
+
+  /** Vrai si le membre n'a jamais changé son mot de passe généré par l'admin. */
+  @Builder.Default
+  @Column(name = "premiere_connexion", nullable = false)
+  private Boolean premiereConnexion = true;
+
+  /**
+   * Statut matrimonial (domaine
+   * {@code STATUT_MATRIMONIAL} dans
+   * {@code types_reference}).
+   */
+  @Column(name = "statut_matrimonial", length = 50)
+  private String statutMatrimonial;
+
+  /** Nationalité. */
+  @Column(name = "nationalite", length = 100)
+  private String nationalite;
+
+  /**
+   * Type de pièce d'identité (domaine
+   * {@code TYPE_IDENTITE} dans
+   * {@code types_reference}).
+   */
+  @Column(name = "type_identite", length = 50)
+  private String typeIdentite;
+
+  /** Numéro de la pièce d'identité. */
+  @Column(name = "numero_identite", length = 100)
+  private String numeroIdentite;
+
+  /** Notes / biographie libre du membre. */
+  @Column(name = "notes", length = 1000)
+  private String notes;
+
+  /** Niveau de vigilance KYC LCB-FT (SIMPLIFIE, RENFORCE). */
+  @Column(name = "niveau_vigilance_kyc", length = 20)
+  private String niveauVigilanceKyc;
+
+  /** Statut de vérification d'identité (NON_VERIFIE, EN_COURS, VERIFIE, REFUSE). */
+  @Column(name = "statut_kyc", length = 20)
+  private String statutKyc;
+
+  /** Date de dernière vérification d'identité. */
+  @Column(name = "date_verification_identite")
+  private LocalDate dateVerificationIdentite;
+
+  // ── Relations ────────────────────────────────────────────────────────────
+
+  /** Adhésions à des organisations — CascadeType.REMOVE exclu intentionnellement pour conserver l'historique */
+  @JsonIgnore
+  @OneToMany(mappedBy = "membre", cascade = {CascadeType.PERSIST, CascadeType.MERGE}, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<MembreOrganisation> membresOrganisations = new ArrayList<>();
+
+  @JsonIgnore
+  @OneToMany(mappedBy = "membre", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<Adresse> adresses = new ArrayList<>();
+
+  @JsonIgnore
+  @OneToMany(mappedBy = "membre", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<CompteWave> comptesWave = new ArrayList<>();
+
+  @JsonIgnore
+  @OneToMany(mappedBy = "membre", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<Paiement> paiements = new ArrayList<>();
+
+  // ── Méthodes métier ───────────────────────────────────────────────────────
+
+  public String getNomComplet() {
+    return (prenom != null ? prenom : "") + " " + (nom != null ? nom : "");
+  }
+
+  public boolean isMajeur() {
+    return dateNaissance != null && dateNaissance.isBefore(LocalDate.now().minusYears(18));
+  }
+
+  public int getAge() {
+    return dateNaissance != null ? LocalDate.now().getYear() - dateNaissance.getYear() : 0;
+  }
+
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statutCompte == null) {
+      statutCompte = "EN_ATTENTE_VALIDATION";
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/MembreOrganisation.java

@@ -1,141 +1,141 @@
-package dev.lions.unionflow.server.entity;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import dev.lions.unionflow.server.api.enums.membre.StatutMembre;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.UUID;
-import lombok.*;
-
-/**
- * Lien entre un utilisateur et une organisation.
- *
- * <p>Un utilisateur peut adhérer à plusieurs organisations simultanément.
- * Chaque adhésion a son propre statut, date et unité d'affectation.
- *
- * <p>Table : {@code membres_organisations}
- */
-@Entity
-@Table(
-    name = "membres_organisations",
-    indexes = {
-      @Index(name = "idx_mo_utilisateur",  columnList = "utilisateur_id"),
-      @Index(name = "idx_mo_organisation", columnList = "organisation_id"),
-      @Index(name = "idx_mo_statut",       columnList = "statut_membre"),
-      @Index(name = "idx_mo_unite",        columnList = "unite_id")
-    },
-    uniqueConstraints = {
-      @UniqueConstraint(
-          name = "uk_mo_utilisateur_organisation",
-          columnNames = {"utilisateur_id", "organisation_id"})
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class MembreOrganisation extends BaseEntity {
-
-  /** L'utilisateur (identité globale) */
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "utilisateur_id", nullable = false)
-  private Membre membre;
-
-  /** L'organisation racine à laquelle appartient ce membre */
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id", nullable = false)
-  private Organisation organisation;
-
-  /**
-   * Unité d'affectation (agence/bureau).
-   * NULL = affecté au siège.
-   */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "unite_id")
-  private Organisation unite;
-
-  @Enumerated(EnumType.STRING)
-  @Builder.Default
-  @Column(name = "statut_membre", nullable = false, length = 30)
-  private StatutMembre statutMembre = StatutMembre.EN_ATTENTE_VALIDATION;
-
-  @Column(name = "date_adhesion")
-  private LocalDate dateAdhesion;
-
-  @Column(name = "date_changement_statut")
-  private LocalDate dateChangementStatut;
-
-  @Column(name = "motif_statut", length = 500)
-  private String motifStatut;
-
-  /** Utilisateur qui a approuvé ou traité ce changement de statut */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "approuve_par_id")
-  private Membre approuvePar;
-
-  // ── Champs d'invitation (StatutMembre.INVITE) ──────────────────────────────
-
-  /** Date à laquelle l'invitation a été envoyée. */
-  @Column(name = "date_invitation")
-  private LocalDateTime dateInvitation;
-
-  /** Date d'expiration de l'invitation (null = pas d'expiration). */
-  @Column(name = "date_expiration_invitation")
-  private LocalDateTime dateExpirationInvitation;
-
-  /** Token opaque utilisé dans le lien d'invitation envoyé par email. */
-  @Column(name = "token_invitation", length = 64)
-  private String tokenInvitation;
-
-  /** ID de l'administrateur qui a envoyé l'invitation. */
-  @Column(name = "invite_par")
-  private UUID invitePar;
-
-  /** Motif d'archivage (pour StatutMembre.ARCHIVE). */
-  @Column(name = "motif_archivage", length = 500)
-  private String motifArchivage;
-
-  // ── Rôle fonctionnel dans l'organisation ─────────────────────────────────
-
-  /** Rôle de ce membre dans l'organisation (ex: PRESIDENT, TRESORIER...). */
-  @Column(name = "role_org", length = 50)
-  private String roleOrg;
-
-  // ── Relations ─────────────────────────────────────────────────────────────
-
-  /** Rôles de ce membre dans cette organisation */
-  @JsonIgnore
-  @OneToMany(mappedBy = "membreOrganisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<MembreRole> roles = new ArrayList<>();
-
-  /** Ayants droit (mutuelles de santé uniquement) */
-  @JsonIgnore
-  @OneToMany(mappedBy = "membreOrganisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<AyantDroit> ayantsDroit = new ArrayList<>();
-
-  // ── Méthodes métier ────────────────────────────────────────────────────────
-
-  public boolean isActif() {
-    return StatutMembre.ACTIF.equals(statutMembre) && Boolean.TRUE.equals(getActif());
-  }
-
-  public boolean peutDemanderAide() {
-    return StatutMembre.ACTIF.equals(statutMembre);
-  }
-
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statutMembre == null) {
-      statutMembre = StatutMembre.EN_ATTENTE_VALIDATION;
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import dev.lions.unionflow.server.api.enums.membre.StatutMembre;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+import lombok.*;
+
+/**
+ * Lien entre un utilisateur et une organisation.
+ *
+ * <p>Un utilisateur peut adhérer à plusieurs organisations simultanément.
+ * Chaque adhésion a son propre statut, date et unité d'affectation.
+ *
+ * <p>Table : {@code membres_organisations}
+ */
+@Entity
+@Table(
+    name = "membres_organisations",
+    indexes = {
+      @Index(name = "idx_mo_utilisateur",  columnList = "utilisateur_id"),
+      @Index(name = "idx_mo_organisation", columnList = "organisation_id"),
+      @Index(name = "idx_mo_statut",       columnList = "statut_membre"),
+      @Index(name = "idx_mo_unite",        columnList = "unite_id")
+    },
+    uniqueConstraints = {
+      @UniqueConstraint(
+          name = "uk_mo_utilisateur_organisation",
+          columnNames = {"utilisateur_id", "organisation_id"})
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class MembreOrganisation extends BaseEntity {
+
+  /** L'utilisateur (identité globale) */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "utilisateur_id", nullable = false)
+  private Membre membre;
+
+  /** L'organisation racine à laquelle appartient ce membre */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id", nullable = false)
+  private Organisation organisation;
+
+  /**
+   * Unité d'affectation (agence/bureau).
+   * NULL = affecté au siège.
+   */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "unite_id")
+  private Organisation unite;
+
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "statut_membre", nullable = false, length = 30)
+  private StatutMembre statutMembre = StatutMembre.EN_ATTENTE_VALIDATION;
+
+  @Column(name = "date_adhesion")
+  private LocalDate dateAdhesion;
+
+  @Column(name = "date_changement_statut")
+  private LocalDate dateChangementStatut;
+
+  @Column(name = "motif_statut", length = 500)
+  private String motifStatut;
+
+  /** Utilisateur qui a approuvé ou traité ce changement de statut */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "approuve_par_id")
+  private Membre approuvePar;
+
+  // ── Champs d'invitation (StatutMembre.INVITE) ──────────────────────────────
+
+  /** Date à laquelle l'invitation a été envoyée. */
+  @Column(name = "date_invitation")
+  private LocalDateTime dateInvitation;
+
+  /** Date d'expiration de l'invitation (null = pas d'expiration). */
+  @Column(name = "date_expiration_invitation")
+  private LocalDateTime dateExpirationInvitation;
+
+  /** Token opaque utilisé dans le lien d'invitation envoyé par email. */
+  @Column(name = "token_invitation", length = 64)
+  private String tokenInvitation;
+
+  /** ID de l'administrateur qui a envoyé l'invitation. */
+  @Column(name = "invite_par")
+  private UUID invitePar;
+
+  /** Motif d'archivage (pour StatutMembre.ARCHIVE). */
+  @Column(name = "motif_archivage", length = 500)
+  private String motifArchivage;
+
+  // ── Rôle fonctionnel dans l'organisation ─────────────────────────────────
+
+  /** Rôle de ce membre dans l'organisation (ex: PRESIDENT, TRESORIER...). */
+  @Column(name = "role_org", length = 50)
+  private String roleOrg;
+
+  // ── Relations ─────────────────────────────────────────────────────────────
+
+  /** Rôles de ce membre dans cette organisation */
+  @JsonIgnore
+  @OneToMany(mappedBy = "membreOrganisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<MembreRole> roles = new ArrayList<>();
+
+  /** Ayants droit (mutuelles de santé uniquement) */
+  @JsonIgnore
+  @OneToMany(mappedBy = "membreOrganisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<AyantDroit> ayantsDroit = new ArrayList<>();
+
+  // ── Méthodes métier ────────────────────────────────────────────────────────
+
+  public boolean isActif() {
+    return StatutMembre.ACTIF.equals(statutMembre) && Boolean.TRUE.equals(getActif());
+  }
+
+  public boolean peutDemanderAide() {
+    return StatutMembre.ACTIF.equals(statutMembre);
+  }
+
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statutMembre == null) {
+      statutMembre = StatutMembre.EN_ATTENTE_VALIDATION;
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/MembreRole.java

@@ -1,94 +1,94 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import java.time.LocalDate;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Table de liaison entre Membre et Role
- * Permet à un membre d'avoir plusieurs rôles avec dates de début/fin
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "membres_roles",
-    indexes = {
-      @Index(name = "idx_mr_membre_org",   columnList = "membre_organisation_id"),
-      @Index(name = "idx_mr_organisation", columnList = "organisation_id"),
-      @Index(name = "idx_mr_role",         columnList = "role_id"),
-      @Index(name = "idx_mr_actif",        columnList = "actif")
-    },
-    uniqueConstraints = {
-      @UniqueConstraint(
-          name = "uk_mr_membre_org_role",
-          columnNames = {"membre_organisation_id", "role_id"})
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class MembreRole extends BaseEntity {
-
-  /** Lien membership (utilisateur dans le contexte de son organisation) */
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "membre_organisation_id", nullable = false)
-  private MembreOrganisation membreOrganisation;
-
-  /** Organisation dans laquelle ce rôle est actif (dénormalisé pour les requêtes) */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id")
-  private Organisation organisation;
-
-  /** Rôle */
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "role_id", nullable = false)
-  private Role role;
-
-  /** Date de début d'attribution */
-  @Column(name = "date_debut")
-  private LocalDate dateDebut;
-
-  /** Date de fin d'attribution (null = permanent) */
-  @Column(name = "date_fin")
-  private LocalDate dateFin;
-
-  /** Commentaire sur l'attribution */
-  @Column(name = "commentaire", length = 500)
-  private String commentaire;
-
-  /** Méthode métier pour vérifier si l'attribution est active */
-  public boolean isActif() {
-    if (!Boolean.TRUE.equals(getActif())) {
-      return false;
-    }
-    LocalDate aujourdhui = LocalDate.now();
-    if (dateDebut != null && aujourdhui.isBefore(dateDebut)) {
-      return false;
-    }
-    if (dateFin != null && aujourdhui.isAfter(dateFin)) {
-      return false;
-    }
-    return true;
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (dateDebut == null) {
-      dateDebut = LocalDate.now();
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDate;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Table de liaison entre Membre et Role
+ * Permet à un membre d'avoir plusieurs rôles avec dates de début/fin
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "membres_roles",
+    indexes = {
+      @Index(name = "idx_mr_membre_org",   columnList = "membre_organisation_id"),
+      @Index(name = "idx_mr_organisation", columnList = "organisation_id"),
+      @Index(name = "idx_mr_role",         columnList = "role_id"),
+      @Index(name = "idx_mr_actif",        columnList = "actif")
+    },
+    uniqueConstraints = {
+      @UniqueConstraint(
+          name = "uk_mr_membre_org_role",
+          columnNames = {"membre_organisation_id", "role_id"})
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class MembreRole extends BaseEntity {
+
+  /** Lien membership (utilisateur dans le contexte de son organisation) */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_organisation_id", nullable = false)
+  private MembreOrganisation membreOrganisation;
+
+  /** Organisation dans laquelle ce rôle est actif (dénormalisé pour les requêtes) */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  /** Rôle */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "role_id", nullable = false)
+  private Role role;
+
+  /** Date de début d'attribution */
+  @Column(name = "date_debut")
+  private LocalDate dateDebut;
+
+  /** Date de fin d'attribution (null = permanent) */
+  @Column(name = "date_fin")
+  private LocalDate dateFin;
+
+  /** Commentaire sur l'attribution */
+  @Column(name = "commentaire", length = 500)
+  private String commentaire;
+
+  /** Méthode métier pour vérifier si l'attribution est active */
+  public boolean isActif() {
+    if (!Boolean.TRUE.equals(getActif())) {
+      return false;
+    }
+    LocalDate aujourdhui = LocalDate.now();
+    if (dateDebut != null && aujourdhui.isBefore(dateDebut)) {
+      return false;
+    }
+    if (dateFin != null && aujourdhui.isAfter(dateFin)) {
+      return false;
+    }
+    return true;
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (dateDebut == null) {
+      dateDebut = LocalDate.now();
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/MembreSuivi.java

@@ -1,38 +1,38 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.util.UUID;
-
-/**
- * Lien « suivi » entre deux membres : le membre connecté (follower) suit un autre membre (suivi).
- * Utilisé pour la fonctionnalité Réseau / Suivre dans l’app mobile.
- */
-@Entity
-@Table(
-    name = "membre_suivi",
-    uniqueConstraints = @UniqueConstraint(columnNames = { "follower_utilisateur_id", "suivi_utilisateur_id" }),
-    indexes = {
-        @Index(name = "idx_membre_suivi_follower", columnList = "follower_utilisateur_id"),
-        @Index(name = "idx_membre_suivi_suivi", columnList = "suivi_utilisateur_id")
-    }
-)
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class MembreSuivi extends BaseEntity {
-
-    /** Utilisateur qui suit (membre connecté). */
-    @NotNull
-    @Column(name = "follower_utilisateur_id", nullable = false)
-    private UUID followerUtilisateurId;
-
-    /** Utilisateur suivi (membre cible). */
-    @NotNull
-    @Column(name = "suivi_utilisateur_id", nullable = false)
-    private UUID suiviUtilisateurId;
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.util.UUID;
+
+/**
+ * Lien « suivi » entre deux membres : le membre connecté (follower) suit un autre membre (suivi).
+ * Utilisé pour la fonctionnalité Réseau / Suivre dans l’app mobile.
+ */
+@Entity
+@Table(
+    name = "membre_suivi",
+    uniqueConstraints = @UniqueConstraint(columnNames = { "follower_utilisateur_id", "suivi_utilisateur_id" }),
+    indexes = {
+        @Index(name = "idx_membre_suivi_follower", columnList = "follower_utilisateur_id"),
+        @Index(name = "idx_membre_suivi_suivi", columnList = "suivi_utilisateur_id")
+    }
+)
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class MembreSuivi extends BaseEntity {
+
+    /** Utilisateur qui suit (membre connecté). */
+    @NotNull
+    @Column(name = "follower_utilisateur_id", nullable = false)
+    private UUID followerUtilisateurId;
+
+    /** Utilisateur suivi (membre cible). */
+    @NotNull
+    @Column(name = "suivi_utilisateur_id", nullable = false)
+    private UUID suiviUtilisateurId;
+}

src/main/java/dev/lions/unionflow/server/entity/ModuleDisponible.java

@@ -1,56 +1,56 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import lombok.*;
-
-/**
- * Catalogue des modules métier activables par type d'organisation.
- *
- * <p>Géré uniquement par le Super Admin UnionFlow.
- * Les organisations ne peuvent pas créer de nouveaux modules.
- *
- * <p>Table : {@code modules_disponibles}
- */
-@Entity
-@Table(
-    name = "modules_disponibles",
-    indexes = {
-      @Index(name = "idx_module_code",  columnList = "code", unique = true),
-      @Index(name = "idx_module_actif", columnList = "actif")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ModuleDisponible extends BaseEntity {
-
-  @NotBlank
-  @Column(name = "code", unique = true, nullable = false, length = 50)
-  private String code;
-
-  @NotBlank
-  @Column(name = "libelle", nullable = false, length = 150)
-  private String libelle;
-
-  @Column(name = "description", columnDefinition = "TEXT")
-  private String description;
-
-  /**
-   * JSON array des types d'organisations compatibles.
-   * Exemple : ["MUTUELLE_SANTE","ONG"] ou ["ALL"] pour tous.
-   */
-  @Column(name = "types_org_compatibles", columnDefinition = "TEXT")
-  private String typesOrgCompatibles;
-
-  @Builder.Default
-  @Column(name = "ordre_affichage", nullable = false)
-  private Integer ordreAffichage = 0;
-
-  public boolean estCompatibleAvec(String typeOrganisation) {
-    if (typesOrgCompatibles == null) return false;
-    return typesOrgCompatibles.contains("ALL")
-        || typesOrgCompatibles.contains(typeOrganisation);
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import lombok.*;
+
+/**
+ * Catalogue des modules métier activables par type d'organisation.
+ *
+ * <p>Géré uniquement par le Super Admin UnionFlow.
+ * Les organisations ne peuvent pas créer de nouveaux modules.
+ *
+ * <p>Table : {@code modules_disponibles}
+ */
+@Entity
+@Table(
+    name = "modules_disponibles",
+    indexes = {
+      @Index(name = "idx_module_code",  columnList = "code", unique = true),
+      @Index(name = "idx_module_actif", columnList = "actif")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ModuleDisponible extends BaseEntity {
+
+  @NotBlank
+  @Column(name = "code", unique = true, nullable = false, length = 50)
+  private String code;
+
+  @NotBlank
+  @Column(name = "libelle", nullable = false, length = 150)
+  private String libelle;
+
+  @Column(name = "description", columnDefinition = "TEXT")
+  private String description;
+
+  /**
+   * JSON array des types d'organisations compatibles.
+   * Exemple : ["MUTUELLE_SANTE","ONG"] ou ["ALL"] pour tous.
+   */
+  @Column(name = "types_org_compatibles", columnDefinition = "TEXT")
+  private String typesOrgCompatibles;
+
+  @Builder.Default
+  @Column(name = "ordre_affichage", nullable = false)
+  private Integer ordreAffichage = 0;
+
+  public boolean estCompatibleAvec(String typeOrganisation) {
+    if (typesOrgCompatibles == null) return false;
+    return typesOrgCompatibles.contains("ALL")
+        || typesOrgCompatibles.contains(typeOrganisation);
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/ModuleOrganisationActif.java

@@ -1,64 +1,64 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.time.LocalDateTime;
-import lombok.*;
-
-/**
- * Module activé pour une organisation donnée.
- *
- * <p>
- * Les modules sont activés automatiquement selon le type d'organisation
- * lors de la première souscription, et peuvent être désactivés par le manager.
- *
- * <p>
- * Table : {@code modules_organisation_actifs}
- */
-@Entity
-@Table(name = "modules_organisation_actifs", indexes = {
-    @Index(name = "idx_moa_organisation", columnList = "organisation_id"),
-    @Index(name = "idx_moa_module", columnList = "module_code")
-}, uniqueConstraints = {
-    @UniqueConstraint(name = "uk_moa_org_module", columnNames = { "organisation_id", "module_code" })
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ModuleOrganisationActif extends BaseEntity {
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id", nullable = false)
-  private Organisation organisation;
-
-  @NotBlank
-  @Column(name = "module_code", nullable = false, length = 50)
-  private String moduleCode;
-
-  /**
-   * Référence vers le catalogue des modules.
-   * Assure l'intégrité référentielle avec
-   * {@code modules_disponibles}.
-   */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "module_disponible_id")
-  private ModuleDisponible moduleDisponible;
-
-  @Builder.Default
-  @Column(name = "date_activation", nullable = false)
-  private LocalDateTime dateActivation = LocalDateTime.now();
-
-  /**
-   * Configuration JSON spécifique au module pour cette organisation.
-   * Exemple pour CREDIT_EPARGNE : {"taux_interet_max": 18, "duree_max_mois": 24}
-   */
-  @Column(name = "parametres", columnDefinition = "TEXT")
-  private String parametres;
-
-  public boolean isActif() {
-    return Boolean.TRUE.equals(getActif());
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.time.LocalDateTime;
+import lombok.*;
+
+/**
+ * Module activé pour une organisation donnée.
+ *
+ * <p>
+ * Les modules sont activés automatiquement selon le type d'organisation
+ * lors de la première souscription, et peuvent être désactivés par le manager.
+ *
+ * <p>
+ * Table : {@code modules_organisation_actifs}
+ */
+@Entity
+@Table(name = "modules_organisation_actifs", indexes = {
+    @Index(name = "idx_moa_organisation", columnList = "organisation_id"),
+    @Index(name = "idx_moa_module", columnList = "module_code")
+}, uniqueConstraints = {
+    @UniqueConstraint(name = "uk_moa_org_module", columnNames = { "organisation_id", "module_code" })
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ModuleOrganisationActif extends BaseEntity {
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id", nullable = false)
+  private Organisation organisation;
+
+  @NotBlank
+  @Column(name = "module_code", nullable = false, length = 50)
+  private String moduleCode;
+
+  /**
+   * Référence vers le catalogue des modules.
+   * Assure l'intégrité référentielle avec
+   * {@code modules_disponibles}.
+   */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "module_disponible_id")
+  private ModuleDisponible moduleDisponible;
+
+  @Builder.Default
+  @Column(name = "date_activation", nullable = false)
+  private LocalDateTime dateActivation = LocalDateTime.now();
+
+  /**
+   * Configuration JSON spécifique au module pour cette organisation.
+   * Exemple pour CREDIT_EPARGNE : {"taux_interet_max": 18, "duree_max_mois": 24}
+   */
+  @Column(name = "parametres", columnDefinition = "TEXT")
+  private String parametres;
+
+  public boolean isActif() {
+    return Boolean.TRUE.equals(getActif());
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Notification.java

@@ -1,123 +1,123 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import java.time.LocalDateTime;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Notification pour la gestion des notifications
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(name = "notifications", indexes = {
-    @Index(name = "idx_notification_type", columnList = "type_notification"),
-    @Index(name = "idx_notification_statut", columnList = "statut"),
-    @Index(name = "idx_notification_priorite", columnList = "priorite"),
-    @Index(name = "idx_notification_membre", columnList = "membre_id"),
-    @Index(name = "idx_notification_organisation", columnList = "organisation_id"),
-    @Index(name = "idx_notification_date_envoi", columnList = "date_envoi")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Notification extends BaseEntity {
-
-  /** Type de notification */
-  @NotNull
-  @Column(name = "type_notification", nullable = false, length = 30)
-  private String typeNotification;
-
-  /** Priorité */
-  @Builder.Default
-  @Column(name = "priorite", length = 20)
-  private String priorite = "NORMALE";
-
-  /** Statut */
-  @Builder.Default
-  @Column(name = "statut", length = 30)
-  private String statut = "EN_ATTENTE";
-
-  /** Sujet */
-  @Column(name = "sujet", length = 500)
-  private String sujet;
-
-  /** Corps du message */
-  @Column(name = "corps", columnDefinition = "TEXT")
-  private String corps;
-
-  /** Date d'envoi prévue */
-  @Column(name = "date_envoi_prevue")
-  private LocalDateTime dateEnvoiPrevue;
-
-  /** Date d'envoi réelle */
-  @Column(name = "date_envoi")
-  private LocalDateTime dateEnvoi;
-
-  /** Date de lecture */
-  @Column(name = "date_lecture")
-  private LocalDateTime dateLecture;
-
-  /** Nombre de tentatives d'envoi */
-  @Builder.Default
-  @Column(name = "nombre_tentatives", nullable = false)
-  private Integer nombreTentatives = 0;
-
-  /** Message d'erreur (si échec) */
-  @Column(name = "message_erreur", length = 1000)
-  private String messageErreur;
-
-  /** Données additionnelles (JSON) */
-  @Column(name = "donnees_additionnelles", columnDefinition = "TEXT")
-  private String donneesAdditionnelles;
-
-  // Relations
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "membre_id")
-  private Membre membre;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id")
-  private Organisation organisation;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "template_id")
-  private TemplateNotification template;
-
-  /** Méthode métier pour vérifier si la notification est envoyée */
-  public boolean isEnvoyee() {
-    return statut != null && dev.lions.unionflow.server.api.enums.notification.StatutNotification.ENVOYEE.name().equals(statut);
-  }
-
-  /** Méthode métier pour vérifier si la notification est lue */
-  public boolean isLue() {
-    return statut != null && dev.lions.unionflow.server.api.enums.notification.StatutNotification.LUE.name().equals(statut);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (priorite == null) {
-      priorite = "NORMALE";
-    }
-    if (statut == null) {
-      statut = "EN_ATTENTE";
-    }
-    if (nombreTentatives == null) {
-      nombreTentatives = 0;
-    }
-    if (dateEnvoiPrevue == null) {
-      dateEnvoiPrevue = LocalDateTime.now();
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Notification pour la gestion des notifications
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(name = "notifications", indexes = {
+    @Index(name = "idx_notification_type", columnList = "type_notification"),
+    @Index(name = "idx_notification_statut", columnList = "statut"),
+    @Index(name = "idx_notification_priorite", columnList = "priorite"),
+    @Index(name = "idx_notification_membre", columnList = "membre_id"),
+    @Index(name = "idx_notification_organisation", columnList = "organisation_id"),
+    @Index(name = "idx_notification_date_envoi", columnList = "date_envoi")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Notification extends BaseEntity {
+
+  /** Type de notification */
+  @NotNull
+  @Column(name = "type_notification", nullable = false, length = 30)
+  private String typeNotification;
+
+  /** Priorité */
+  @Builder.Default
+  @Column(name = "priorite", length = 20)
+  private String priorite = "NORMALE";
+
+  /** Statut */
+  @Builder.Default
+  @Column(name = "statut", length = 30)
+  private String statut = "EN_ATTENTE";
+
+  /** Sujet */
+  @Column(name = "sujet", length = 500)
+  private String sujet;
+
+  /** Corps du message */
+  @Column(name = "corps", columnDefinition = "TEXT")
+  private String corps;
+
+  /** Date d'envoi prévue */
+  @Column(name = "date_envoi_prevue")
+  private LocalDateTime dateEnvoiPrevue;
+
+  /** Date d'envoi réelle */
+  @Column(name = "date_envoi")
+  private LocalDateTime dateEnvoi;
+
+  /** Date de lecture */
+  @Column(name = "date_lecture")
+  private LocalDateTime dateLecture;
+
+  /** Nombre de tentatives d'envoi */
+  @Builder.Default
+  @Column(name = "nombre_tentatives", nullable = false)
+  private Integer nombreTentatives = 0;
+
+  /** Message d'erreur (si échec) */
+  @Column(name = "message_erreur", length = 1000)
+  private String messageErreur;
+
+  /** Données additionnelles (JSON) */
+  @Column(name = "donnees_additionnelles", columnDefinition = "TEXT")
+  private String donneesAdditionnelles;
+
+  // Relations
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_id")
+  private Membre membre;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "template_id")
+  private TemplateNotification template;
+
+  /** Méthode métier pour vérifier si la notification est envoyée */
+  public boolean isEnvoyee() {
+    return statut != null && dev.lions.unionflow.server.api.enums.notification.StatutNotification.ENVOYEE.name().equals(statut);
+  }
+
+  /** Méthode métier pour vérifier si la notification est lue */
+  public boolean isLue() {
+    return statut != null && dev.lions.unionflow.server.api.enums.notification.StatutNotification.LUE.name().equals(statut);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (priorite == null) {
+      priorite = "NORMALE";
+    }
+    if (statut == null) {
+      statut = "EN_ATTENTE";
+    }
+    if (nombreTentatives == null) {
+      nombreTentatives = 0;
+    }
+    if (dateEnvoiPrevue == null) {
+      dateEnvoiPrevue = LocalDateTime.now();
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Organisation.java

@@ -1,326 +1,355 @@
-package dev.lions.unionflow.server.entity;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.Period;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Organisation avec UUID Représente une organisation (Lions Club,
- * Association,
- * Coopérative, etc.)
- *
- * @author UnionFlow Team
- * @version 2.0
- * @since 2025-01-16
- */
-@Entity
-@Table(name = "organisations", indexes = {
-    @Index(name = "idx_organisation_nom", columnList = "nom"),
-    @Index(name = "idx_organisation_email", columnList = "email", unique = true),
-    @Index(name = "idx_organisation_statut", columnList = "statut"),
-    @Index(name = "idx_organisation_type", columnList = "type_organisation"),
-    @Index(name = "idx_organisation_parente", columnList = "organisation_parente_id"),
-    @Index(name = "idx_organisation_numero_enregistrement", columnList = "numero_enregistrement", unique = true)
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Organisation extends BaseEntity {
-
-  @NotBlank
-  @Column(name = "nom", nullable = false, length = 200)
-  private String nom;
-
-  @Column(name = "nom_court", length = 50)
-  private String nomCourt;
-
-  @NotBlank
-  @Column(name = "type_organisation", nullable = false, length = 50)
-  private String typeOrganisation;
-
-  @NotBlank
-  @Column(name = "statut", nullable = false, length = 50)
-  private String statut;
-
-  @Column(name = "description", length = 2000)
-  private String description;
-
-  @Column(name = "date_fondation")
-  private LocalDate dateFondation;
-
-  @Column(name = "numero_enregistrement", unique = true, length = 100)
-  private String numeroEnregistrement;
-
-  // Informations de contact
-  @Email
-  @NotBlank
-  @Column(name = "email", unique = true, nullable = false, length = 255)
-  private String email;
-
-  @Column(name = "telephone", length = 20)
-  private String telephone;
-
-  @Column(name = "telephone_secondaire", length = 20)
-  private String telephoneSecondaire;
-
-  @Email
-  @Column(name = "email_secondaire", length = 255)
-  private String emailSecondaire;
-
-  // Adresse principale (champs dénormalisés pour performance)
-  @Column(name = "adresse", length = 500)
-  private String adresse;
-
-  @Column(name = "ville", length = 100)
-  private String ville;
-
-  @Column(name = "region", length = 100)
-  private String region;
-
-  @Column(name = "pays", length = 100)
-  private String pays;
-
-  @Column(name = "code_postal", length = 20)
-  private String codePostal;
-
-  // Coordonnées géographiques
-  @DecimalMin(value = "-90.0", message = "La latitude doit être comprise entre -90 et 90")
-  @DecimalMax(value = "90.0", message = "La latitude doit être comprise entre -90 et 90")
-  @Digits(integer = 3, fraction = 6)
-  @Column(name = "latitude", precision = 9, scale = 6)
-  private BigDecimal latitude;
-
-  @DecimalMin(value = "-180.0", message = "La longitude doit être comprise entre -180 et 180")
-  @DecimalMax(value = "180.0", message = "La longitude doit être comprise entre -180 et 180")
-  @Digits(integer = 3, fraction = 6)
-  @Column(name = "longitude", precision = 9, scale = 6)
-  private BigDecimal longitude;
-
-  // Web et réseaux sociaux
-  @Column(name = "site_web", length = 500)
-  private String siteWeb;
-
-  @Column(name = "logo", length = 500)
-  private String logo;
-
-  @Column(name = "reseaux_sociaux", length = 1000)
-  private String reseauxSociaux;
-
-  // ── Hiérarchie ──────────────────────────────────────────────────────────────
-
-  /** Organisation parente — FK propre (null = organisation racine) */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_parente_id")
-  private Organisation organisationParente;
-
-  @Builder.Default
-  @Column(name = "niveau_hierarchique", nullable = false)
-  private Integer niveauHierarchique = 0;
-
-  /**
-   * TRUE si c'est l'organisation racine qui porte la souscription SaaS
-   * pour toute sa hiérarchie.
-   */
-  @Builder.Default
-  @Column(name = "est_organisation_racine", nullable = false)
-  private Boolean estOrganisationRacine = true;
-
-  /**
-   * Chemin hiérarchique complet — ex: /uuid-racine/uuid-intermediate/uuid-feuille
-   * Permet des requêtes récursives optimisées sans CTE.
-   */
-  @Column(name = "chemin_hierarchique", length = 2000)
-  private String cheminHierarchique;
-
-  // Statistiques
-  @Builder.Default
-  @Column(name = "nombre_membres", nullable = false)
-  private Integer nombreMembres = 0;
-
-  @Builder.Default
-  @Column(name = "nombre_administrateurs", nullable = false)
-  private Integer nombreAdministrateurs = 0;
-
-  // Finances
-  @DecimalMin(value = "0.0", message = "Le budget annuel doit être positif")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "budget_annuel", precision = 14, scale = 2)
-  private BigDecimal budgetAnnuel;
-
-  @Builder.Default
-  @Column(name = "devise", length = 3)
-  private String devise = "XOF";
-
-  @Builder.Default
-  @Column(name = "cotisation_obligatoire", nullable = false)
-  private Boolean cotisationObligatoire = false;
-
-  @DecimalMin(value = "0.0", message = "Le montant de cotisation doit être positif")
-  @Digits(integer = 10, fraction = 2)
-  @Column(name = "montant_cotisation_annuelle", precision = 12, scale = 2)
-  private BigDecimal montantCotisationAnnuelle;
-
-  // Informations complémentaires
-  @Column(name = "objectifs", length = 2000)
-  private String objectifs;
-
-  @Column(name = "activites_principales", length = 2000)
-  private String activitesPrincipales;
-
-  @Column(name = "certifications", length = 500)
-  private String certifications;
-
-  @Column(name = "partenaires", length = 1000)
-  private String partenaires;
-
-  @Column(name = "notes", length = 1000)
-  private String notes;
-
-  // Paramètres
-  @Builder.Default
-  @Column(name = "organisation_publique", nullable = false)
-  private Boolean organisationPublique = true;
-
-  @Builder.Default
-  @Column(name = "accepte_nouveaux_membres", nullable = false)
-  private Boolean accepteNouveauxMembres = true;
-
-  /** Catégorie du type d'organisation (ASSOCIATIF, FINANCIER_SOLIDAIRE, RELIGIEUX, PROFESSIONNEL, RESEAU_FEDERATION) */
-  @Column(name = "categorie_type", length = 50)
-  private String categorieType;
-
-  /** Modules activés pour cette organisation (liste CSV, ex: "MEMBRES,COTISATIONS,TONTINE") */
-  @Column(name = "modules_actifs", length = 1000)
-  private String modulesActifs;
-
-  // Relations
-
-  /** Adhésions des membres à cette organisation */
-  @JsonIgnore
-  @OneToMany(mappedBy = "organisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<MembreOrganisation> membresOrganisations = new ArrayList<>();
-
-  @JsonIgnore
-  @OneToMany(mappedBy = "organisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<Adresse> adresses = new ArrayList<>();
-
-  @JsonIgnore
-  @OneToMany(mappedBy = "organisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<CompteWave> comptesWave = new ArrayList<>();
-
-  /** Méthode métier pour obtenir le nom complet avec sigle */
-  public String getNomComplet() {
-    if (nomCourt != null && !nomCourt.isEmpty()) {
-      return nom + " (" + nomCourt + ")";
-    }
-    return nom;
-  }
-
-  /** Méthode métier pour calculer l'ancienneté en années */
-  public int getAncienneteAnnees() {
-    if (dateFondation == null) {
-      return 0;
-    }
-    return Period.between(dateFondation, LocalDate.now()).getYears();
-  }
-
-  /**
-   * Méthode métier pour vérifier si l'organisation est récente (moins de 2 ans)
-   */
-  public boolean isRecente() {
-    return getAncienneteAnnees() < 2;
-  }
-
-  /** Méthode métier pour vérifier si l'organisation est active */
-  public boolean isActive() {
-    return "ACTIVE".equals(statut) && Boolean.TRUE.equals(getActif());
-  }
-
-  /** Méthode métier pour ajouter un membre */
-  public void ajouterMembre() {
-    if (nombreMembres == null) {
-      nombreMembres = 0;
-    }
-    nombreMembres++;
-  }
-
-  /** Méthode métier pour retirer un membre */
-  public void retirerMembre() {
-    if (nombreMembres != null && nombreMembres > 0) {
-      nombreMembres--;
-    }
-  }
-
-  /** Méthode métier pour activer l'organisation */
-  public void activer(String utilisateur) {
-    this.statut = "ACTIVE";
-    this.setActif(true);
-    marquerCommeModifie(utilisateur);
-  }
-
-  /** Méthode métier pour suspendre l'organisation */
-  public void suspendre(String utilisateur) {
-    this.statut = "SUSPENDUE";
-    this.accepteNouveauxMembres = false;
-    marquerCommeModifie(utilisateur);
-  }
-
-  /** Méthode métier pour dissoudre l'organisation */
-  public void dissoudre(String utilisateur) {
-    this.statut = "DISSOUTE";
-    this.setActif(false);
-    this.accepteNouveauxMembres = false;
-    marquerCommeModifie(utilisateur);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate(); // Appelle le onCreate de BaseEntity
-    if (statut == null) {
-      statut = "ACTIVE";
-    }
-    if (typeOrganisation == null) {
-      typeOrganisation = "ASSOCIATION";
-    }
-    if (devise == null) {
-      devise = "XOF";
-    }
-    if (niveauHierarchique == null) {
-      niveauHierarchique = 0;
-    }
-    if (estOrganisationRacine == null) {
-      estOrganisationRacine = (organisationParente == null);
-    }
-    if (nombreMembres == null) {
-      nombreMembres = 0;
-    }
-    if (nombreAdministrateurs == null) {
-      nombreAdministrateurs = 0;
-    }
-    if (organisationPublique == null) {
-      organisationPublique = true;
-    }
-    if (accepteNouveauxMembres == null) {
-      accepteNouveauxMembres = true;
-    }
-    if (cotisationObligatoire == null) {
-      cotisationObligatoire = false;
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.Period;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Organisation avec UUID Représente une organisation (Lions Club,
+ * Association,
+ * Coopérative, etc.)
+ *
+ * @author UnionFlow Team
+ * @version 2.0
+ * @since 2025-01-16
+ */
+@Entity
+@Table(name = "organisations", indexes = {
+    @Index(name = "idx_organisation_nom", columnList = "nom"),
+    @Index(name = "idx_organisation_email", columnList = "email", unique = true),
+    @Index(name = "idx_organisation_statut", columnList = "statut"),
+    @Index(name = "idx_organisation_type", columnList = "type_organisation"),
+    @Index(name = "idx_organisation_parente", columnList = "organisation_parente_id"),
+    @Index(name = "idx_organisation_numero_enregistrement", columnList = "numero_enregistrement", unique = true)
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Organisation extends BaseEntity {
+
+  @NotBlank
+  @Column(name = "nom", nullable = false, length = 200)
+  private String nom;
+
+  @Column(name = "nom_court", length = 50)
+  private String nomCourt;
+
+  @NotBlank
+  @Column(name = "type_organisation", nullable = false, length = 50)
+  private String typeOrganisation;
+
+  @NotBlank
+  @Column(name = "statut", nullable = false, length = 50)
+  private String statut;
+
+  @Column(name = "description", length = 2000)
+  private String description;
+
+  @Column(name = "date_fondation")
+  private LocalDate dateFondation;
+
+  @Column(name = "numero_enregistrement", unique = true, length = 100)
+  private String numeroEnregistrement;
+
+  // Informations de contact
+  @Email
+  @NotBlank
+  @Column(name = "email", unique = true, nullable = false, length = 255)
+  private String email;
+
+  @Column(name = "telephone", length = 20)
+  private String telephone;
+
+  @Column(name = "telephone_secondaire", length = 20)
+  private String telephoneSecondaire;
+
+  @Email
+  @Column(name = "email_secondaire", length = 255)
+  private String emailSecondaire;
+
+  // Adresse principale (champs dénormalisés pour performance)
+  @Column(name = "adresse", length = 500)
+  private String adresse;
+
+  @Column(name = "ville", length = 100)
+  private String ville;
+
+  @Column(name = "region", length = 100)
+  private String region;
+
+  @Column(name = "pays", length = 100)
+  private String pays;
+
+  @Column(name = "code_postal", length = 20)
+  private String codePostal;
+
+  // Coordonnées géographiques
+  @DecimalMin(value = "-90.0", message = "La latitude doit être comprise entre -90 et 90")
+  @DecimalMax(value = "90.0", message = "La latitude doit être comprise entre -90 et 90")
+  @Digits(integer = 3, fraction = 6)
+  @Column(name = "latitude", precision = 9, scale = 6)
+  private BigDecimal latitude;
+
+  @DecimalMin(value = "-180.0", message = "La longitude doit être comprise entre -180 et 180")
+  @DecimalMax(value = "180.0", message = "La longitude doit être comprise entre -180 et 180")
+  @Digits(integer = 3, fraction = 6)
+  @Column(name = "longitude", precision = 9, scale = 6)
+  private BigDecimal longitude;
+
+  // Web et réseaux sociaux
+  @Column(name = "site_web", length = 500)
+  private String siteWeb;
+
+  @Column(name = "logo", length = 500)
+  private String logo;
+
+  @Column(name = "reseaux_sociaux", length = 1000)
+  private String reseauxSociaux;
+
+  // ── Hiérarchie ──────────────────────────────────────────────────────────────
+
+  /** Organisation parente — FK propre (null = organisation racine) */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_parente_id")
+  private Organisation organisationParente;
+
+  @Builder.Default
+  @Column(name = "niveau_hierarchique", nullable = false)
+  private Integer niveauHierarchique = 0;
+
+  /**
+   * TRUE si c'est l'organisation racine qui porte la souscription SaaS
+   * pour toute sa hiérarchie.
+   */
+  @Builder.Default
+  @Column(name = "est_organisation_racine", nullable = false)
+  private Boolean estOrganisationRacine = true;
+
+  /**
+   * Chemin hiérarchique complet — ex: /uuid-racine/uuid-intermediate/uuid-feuille
+   * Permet des requêtes récursives optimisées sans CTE.
+   */
+  @Column(name = "chemin_hierarchique", length = 2000)
+  private String cheminHierarchique;
+
+  // Statistiques
+  @Builder.Default
+  @Column(name = "nombre_membres", nullable = false)
+  private Integer nombreMembres = 0;
+
+  @Builder.Default
+  @Column(name = "nombre_administrateurs", nullable = false)
+  private Integer nombreAdministrateurs = 0;
+
+  // Finances
+  @DecimalMin(value = "0.0", message = "Le budget annuel doit être positif")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "budget_annuel", precision = 14, scale = 2)
+  private BigDecimal budgetAnnuel;
+
+  @Builder.Default
+  @Column(name = "devise", length = 3)
+  private String devise = "XOF";
+
+  @Builder.Default
+  @Column(name = "cotisation_obligatoire", nullable = false)
+  private Boolean cotisationObligatoire = false;
+
+  @DecimalMin(value = "0.0", message = "Le montant de cotisation doit être positif")
+  @Digits(integer = 10, fraction = 2)
+  @Column(name = "montant_cotisation_annuelle", precision = 12, scale = 2)
+  private BigDecimal montantCotisationAnnuelle;
+
+  // Informations complémentaires
+  @Column(name = "objectifs", length = 2000)
+  private String objectifs;
+
+  @Column(name = "activites_principales", length = 2000)
+  private String activitesPrincipales;
+
+  @Column(name = "certifications", length = 500)
+  private String certifications;
+
+  @Column(name = "partenaires", length = 1000)
+  private String partenaires;
+
+  @Column(name = "notes", length = 1000)
+  private String notes;
+
+  // Paramètres
+  @Builder.Default
+  @Column(name = "organisation_publique", nullable = false)
+  private Boolean organisationPublique = true;
+
+  @Builder.Default
+  @Column(name = "accepte_nouveaux_membres", nullable = false)
+  private Boolean accepteNouveauxMembres = true;
+
+  /** Catégorie du type d'organisation (ASSOCIATIF, FINANCIER_SOLIDAIRE, RELIGIEUX, PROFESSIONNEL, RESEAU_FEDERATION) */
+  @Column(name = "categorie_type", length = 50)
+  private String categorieType;
+
+  /** ID de l'Organization Keycloak 26 correspondante — null si pas encore migrée. */
+  @Column(name = "keycloak_org_id")
+  private UUID keycloakOrgId;
+
+  /** Modules activés pour cette organisation (liste CSV, ex: "MEMBRES,COTISATIONS,TONTINE") */
+  @Column(name = "modules_actifs", length = 1000)
+  private String modulesActifs;
+
+  /**
+   * Référentiel comptable applicable à cette organisation.
+   *
+   * <p>Détermine quel plan comptable est appliqué et quels états financiers sont générés
+   * (bilan, compte de résultat, annexes). Mappage par défaut depuis {@code typeOrganisation}
+   * via {@link ReferentielComptable#defaultFor(String)} ; l'admin peut overrider manuellement.
+   *
+   * @since 2026-04-25 — découverte SYCEBNL (11ᵉ Acte uniforme OHADA en vigueur 1er jan 2024)
+   */
+  @Enumerated(EnumType.STRING)
+  @Column(name = "referentiel_comptable", nullable = false, length = 20)
+  @Builder.Default
+  private ReferentielComptable referentielComptable = ReferentielComptable.SYSCOHADA;
+
+  /**
+   * UUID du membre désigné comme Compliance Officer de l'organisation (rôle obligatoire selon
+   * Instruction BCEAO 001-03-2025). Doit être rattaché à la direction générale, distinct du
+   * trésorier (séparation des pouvoirs).
+   *
+   * @since 2026-04-25 — Instruction BCEAO 001-03-2025 (LBC/FT)
+   */
+  @Column(name = "compliance_officer_id")
+  private UUID complianceOfficerId;
+
+  // Relations
+
+  /** Adhésions des membres à cette organisation */
+  @JsonIgnore
+  @OneToMany(mappedBy = "organisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<MembreOrganisation> membresOrganisations = new ArrayList<>();
+
+  @JsonIgnore
+  @OneToMany(mappedBy = "organisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<Adresse> adresses = new ArrayList<>();
+
+  @JsonIgnore
+  @OneToMany(mappedBy = "organisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<CompteWave> comptesWave = new ArrayList<>();
+
+  /** Méthode métier pour obtenir le nom complet avec sigle */
+  public String getNomComplet() {
+    if (nomCourt != null && !nomCourt.isEmpty()) {
+      return nom + " (" + nomCourt + ")";
+    }
+    return nom;
+  }
+
+  /** Méthode métier pour calculer l'ancienneté en années */
+  public int getAncienneteAnnees() {
+    if (dateFondation == null) {
+      return 0;
+    }
+    return Period.between(dateFondation, LocalDate.now()).getYears();
+  }
+
+  /**
+   * Méthode métier pour vérifier si l'organisation est récente (moins de 2 ans)
+   */
+  public boolean isRecente() {
+    return getAncienneteAnnees() < 2;
+  }
+
+  /** Méthode métier pour vérifier si l'organisation est active */
+  public boolean isActive() {
+    return "ACTIVE".equals(statut) && Boolean.TRUE.equals(getActif());
+  }
+
+  /** Méthode métier pour ajouter un membre */
+  public void ajouterMembre() {
+    if (nombreMembres == null) {
+      nombreMembres = 0;
+    }
+    nombreMembres++;
+  }
+
+  /** Méthode métier pour retirer un membre */
+  public void retirerMembre() {
+    if (nombreMembres != null && nombreMembres > 0) {
+      nombreMembres--;
+    }
+  }
+
+  /** Méthode métier pour activer l'organisation */
+  public void activer(String utilisateur) {
+    this.statut = "ACTIVE";
+    this.setActif(true);
+    marquerCommeModifie(utilisateur);
+  }
+
+  /** Méthode métier pour suspendre l'organisation */
+  public void suspendre(String utilisateur) {
+    this.statut = "SUSPENDUE";
+    this.accepteNouveauxMembres = false;
+    marquerCommeModifie(utilisateur);
+  }
+
+  /** Méthode métier pour dissoudre l'organisation */
+  public void dissoudre(String utilisateur) {
+    this.statut = "DISSOUTE";
+    this.setActif(false);
+    this.accepteNouveauxMembres = false;
+    marquerCommeModifie(utilisateur);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate(); // Appelle le onCreate de BaseEntity
+    if (statut == null) {
+      statut = "ACTIVE";
+    }
+    if (typeOrganisation == null) {
+      typeOrganisation = "ASSOCIATION";
+    }
+    if (devise == null) {
+      devise = "XOF";
+    }
+    if (niveauHierarchique == null) {
+      niveauHierarchique = 0;
+    }
+    if (estOrganisationRacine == null) {
+      estOrganisationRacine = (organisationParente == null);
+    }
+    if (nombreMembres == null) {
+      nombreMembres = 0;
+    }
+    if (nombreAdministrateurs == null) {
+      nombreAdministrateurs = 0;
+    }
+    if (organisationPublique == null) {
+      organisationPublique = true;
+    }
+    if (accepteNouveauxMembres == null) {
+      accepteNouveauxMembres = true;
+    }
+    if (cotisationObligatoire == null) {
+      cotisationObligatoire = false;
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/ParametresCotisationOrganisation.java

@@ -1,94 +1,94 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import lombok.*;
-
-/**
- * Paramètres de cotisation configurés par le manager de chaque organisation.
- *
- * <p>
- * Le manager peut définir :
- * <ul>
- * <li>Le montant mensuel et annuel fixé pour tous les membres</li>
- * <li>La date de départ du calcul des impayés (configurable)</li>
- * <li>Le délai en jours avant passage automatique en statut INACTIF</li>
- * </ul>
- *
- * <p>
- * Table : {@code parametres_cotisation_organisation}
- */
-@Entity
-@Table(name = "parametres_cotisation_organisation", indexes = {
-    @Index(name = "idx_param_cot_org", columnList = "organisation_id", unique = true)
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ParametresCotisationOrganisation extends BaseEntity {
-
-  @NotNull
-  @OneToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id", nullable = false, unique = true)
-  private Organisation organisation;
-
-  @Builder.Default
-  @DecimalMin("0.00")
-  @Digits(integer = 10, fraction = 2)
-  @Column(name = "montant_cotisation_mensuelle", precision = 12, scale = 2)
-  private BigDecimal montantCotisationMensuelle = BigDecimal.ZERO;
-
-  @Builder.Default
-  @DecimalMin("0.00")
-  @Digits(integer = 10, fraction = 2)
-  @Column(name = "montant_cotisation_annuelle", precision = 12, scale = 2)
-  private BigDecimal montantCotisationAnnuelle = BigDecimal.ZERO;
-
-  @Column(name = "devise", nullable = false, length = 3)
-  private String devise;
-
-  /**
-   * Date de référence pour le calcul des membres «à jour».
-   * Toutes les échéances depuis cette date doivent être payées.
-   * Configurable par le manager.
-   */
-  @Column(name = "date_debut_calcul_ajour")
-  private LocalDate dateDebutCalculAjour;
-
-  /**
-   * Nombre de jours de retard avant passage automatique du statut membre →
-   * INACTIF.
-   * Défaut : 30 jours.
-   */
-  @Builder.Default
-  @Min(1)
-  @Column(name = "delai_retard_avant_inactif_jours", nullable = false)
-  private Integer delaiRetardAvantInactifJours = 30;
-
-  @Builder.Default
-  @Column(name = "cotisation_obligatoire", nullable = false)
-  private Boolean cotisationObligatoire = true;
-
-  /**
-   * Active la génération automatique mensuelle des cotisations pour cette organisation.
-   * Quand {@code true}, un job planifié crée automatiquement une cotisation par membre actif
-   * le 1er de chaque mois, en utilisant les barèmes par rôle ou le montant par défaut.
-   */
-  @Builder.Default
-  @Column(name = "generation_automatique_activee", nullable = false)
-  private Boolean generationAutomatiqueActivee = false;
-
-  // ── Méthodes métier ────────────────────────────────────────────────────────
-
-  /**
-   * Vérifie si la date de référence pour les impayés est définie.
-   * Sans cette date, aucun calcul d'ancienneté des impayés n'est possible.
-   */
-  public boolean isCalculAjourActive() {
-    return dateDebutCalculAjour != null;
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import lombok.*;
+
+/**
+ * Paramètres de cotisation configurés par le manager de chaque organisation.
+ *
+ * <p>
+ * Le manager peut définir :
+ * <ul>
+ * <li>Le montant mensuel et annuel fixé pour tous les membres</li>
+ * <li>La date de départ du calcul des impayés (configurable)</li>
+ * <li>Le délai en jours avant passage automatique en statut INACTIF</li>
+ * </ul>
+ *
+ * <p>
+ * Table : {@code parametres_cotisation_organisation}
+ */
+@Entity
+@Table(name = "parametres_cotisation_organisation", indexes = {
+    @Index(name = "idx_param_cot_org", columnList = "organisation_id", unique = true)
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ParametresCotisationOrganisation extends BaseEntity {
+
+  @NotNull
+  @OneToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id", nullable = false, unique = true)
+  private Organisation organisation;
+
+  @Builder.Default
+  @DecimalMin("0.00")
+  @Digits(integer = 10, fraction = 2)
+  @Column(name = "montant_cotisation_mensuelle", precision = 12, scale = 2)
+  private BigDecimal montantCotisationMensuelle = BigDecimal.ZERO;
+
+  @Builder.Default
+  @DecimalMin("0.00")
+  @Digits(integer = 10, fraction = 2)
+  @Column(name = "montant_cotisation_annuelle", precision = 12, scale = 2)
+  private BigDecimal montantCotisationAnnuelle = BigDecimal.ZERO;
+
+  @Column(name = "devise", nullable = false, length = 3)
+  private String devise;
+
+  /**
+   * Date de référence pour le calcul des membres «à jour».
+   * Toutes les échéances depuis cette date doivent être payées.
+   * Configurable par le manager.
+   */
+  @Column(name = "date_debut_calcul_ajour")
+  private LocalDate dateDebutCalculAjour;
+
+  /**
+   * Nombre de jours de retard avant passage automatique du statut membre →
+   * INACTIF.
+   * Défaut : 30 jours.
+   */
+  @Builder.Default
+  @Min(1)
+  @Column(name = "delai_retard_avant_inactif_jours", nullable = false)
+  private Integer delaiRetardAvantInactifJours = 30;
+
+  @Builder.Default
+  @Column(name = "cotisation_obligatoire", nullable = false)
+  private Boolean cotisationObligatoire = true;
+
+  /**
+   * Active la génération automatique mensuelle des cotisations pour cette organisation.
+   * Quand {@code true}, un job planifié crée automatiquement une cotisation par membre actif
+   * le 1er de chaque mois, en utilisant les barèmes par rôle ou le montant par défaut.
+   */
+  @Builder.Default
+  @Column(name = "generation_automatique_activee", nullable = false)
+  private Boolean generationAutomatiqueActivee = false;
+
+  // ── Méthodes métier ────────────────────────────────────────────────────────
+
+  /**
+   * Vérifie si la date de référence pour les impayés est définie.
+   * Sans cette date, aucun calcul d'ancienneté des impayés n'est possible.
+   */
+  public boolean isCalculAjourActive() {
+    return dateDebutCalculAjour != null;
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/ParametresLcbFt.java

@@ -1,36 +1,36 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.util.UUID;
-
-/**
- * Paramètres LCB-FT par organisation ou globaux (organisationId null).
- * Seuils au-dessus desquels l'origine des fonds est obligatoire / validation manuelle.
- */
-@Entity
-@Table(name = "parametres_lcb_ft", indexes = {
-    @Index(name = "idx_param_lcb_ft_org", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ParametresLcbFt extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id")
-    private Organisation organisation;
-
-    @Column(name = "code_devise", nullable = false, length = 3)
-    private String codeDevise;
-
-    @Column(name = "montant_seuil_justification", nullable = false, precision = 18, scale = 4)
-    private BigDecimal montantSeuilJustification;
-
-    @Column(name = "montant_seuil_validation_manuelle", precision = 18, scale = 4)
-    private BigDecimal montantSeuilValidationManuelle;
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.UUID;
+
+/**
+ * Paramètres LCB-FT par organisation ou globaux (organisationId null).
+ * Seuils au-dessus desquels l'origine des fonds est obligatoire / validation manuelle.
+ */
+@Entity
+@Table(name = "parametres_lcb_ft", indexes = {
+    @Index(name = "idx_param_lcb_ft_org", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ParametresLcbFt extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id")
+    private Organisation organisation;
+
+    @Column(name = "code_devise", nullable = false, length = 3)
+    private String codeDevise;
+
+    @Column(name = "montant_seuil_justification", nullable = false, precision = 18, scale = 4)
+    private BigDecimal montantSeuilJustification;
+
+    @Column(name = "montant_seuil_validation_manuelle", precision = 18, scale = 4)
+    private BigDecimal montantSeuilValidationManuelle;
+}

src/main/java/dev/lions/unionflow/server/entity/ParticipationFormationLbcFt.java

@@ -0,0 +1,56 @@
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Participation d'un membre à une session de formation LBC/FT.
+ *
+ * @since 2026-04-25 (P1-NEW-12)
+ */
+@Entity
+@Table(name = "participations_formation_lbcft",
+    uniqueConstraints = @UniqueConstraint(columnNames = {"formation_id", "membre_id"}),
+    indexes = {
+        @Index(name = "idx_participation_membre", columnList = "membre_id"),
+        @Index(name = "idx_participation_statut", columnList = "statut_participation")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ParticipationFormationLbcFt extends BaseEntity {
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "formation_id", nullable = false)
+  private FormationLbcFt formation;
+
+  @NotNull
+  @Column(name = "membre_id", nullable = false)
+  private UUID membreId;
+
+  @NotBlank
+  @Column(name = "statut_participation", nullable = false, length = 20)
+  @Builder.Default
+  private String statutParticipation = "INSCRIT"; // INSCRIT, PRESENT, ABSENT, CERTIFIE
+
+  @Column(name = "date_certification")
+  private LocalDateTime dateCertification;
+
+  @Column(name = "numero_certificat", length = 100)
+  private String numeroCertificat;
+
+  @Column(name = "score_quiz", precision = 5, scale = 2)
+  private BigDecimal scoreQuiz;
+}

src/main/java/dev/lions/unionflow/server/entity/Permission.java

@@ -1,92 +1,92 @@
-package dev.lions.unionflow.server.entity;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Permission pour la gestion des permissions granulaires
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "permissions",
-    indexes = {
-      @Index(name = "idx_permission_code", columnList = "code", unique = true),
-      @Index(name = "idx_permission_module", columnList = "module"),
-      @Index(name = "idx_permission_ressource", columnList = "ressource")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Permission extends BaseEntity {
-
-  /** Code unique de la permission (format: MODULE > RESSOURCE > ACTION) */
-  @NotBlank
-  @Column(name = "code", unique = true, nullable = false, length = 100)
-  private String code;
-
-  /** Module (ex: ORGANISATION, MEMBRE, COTISATION) */
-  @NotBlank
-  @Column(name = "module", nullable = false, length = 50)
-  private String module;
-
-  /** Ressource (ex: MEMBRE, COTISATION, ADHESION) */
-  @NotBlank
-  @Column(name = "ressource", nullable = false, length = 50)
-  private String ressource;
-
-  /** Action (ex: CREATE, READ, UPDATE, DELETE, VALIDATE) */
-  @NotBlank
-  @Column(name = "action", nullable = false, length = 50)
-  private String action;
-
-  /** Libellé de la permission */
-  @Column(name = "libelle", length = 200)
-  private String libelle;
-
-  /** Description de la permission */
-  @Column(name = "description", length = 500)
-  private String description;
-
-  /** Rôles associés */
-  @JsonIgnore
-  @OneToMany(mappedBy = "permission", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<RolePermission> roles = new ArrayList<>();
-
-  /** Méthode métier pour générer le code à partir des composants */
-  public static String genererCode(String module, String ressource, String action) {
-    return String.format("%s > %s > %s", module.toUpperCase(), ressource.toUpperCase(), action.toUpperCase());
-  }
-
-  /** Méthode métier pour vérifier si le code est valide */
-  public boolean isCodeValide() {
-    return code != null && code.contains(" > ") && code.split(" > ").length == 3;
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    // Générer le code si non fourni
-    if (code == null || code.isEmpty()) {
-      if (module != null && ressource != null && action != null) {
-        code = genererCode(module, ressource, action);
-      }
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Permission pour la gestion des permissions granulaires
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "permissions",
+    indexes = {
+      @Index(name = "idx_permission_code", columnList = "code", unique = true),
+      @Index(name = "idx_permission_module", columnList = "module"),
+      @Index(name = "idx_permission_ressource", columnList = "ressource")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Permission extends BaseEntity {
+
+  /** Code unique de la permission (format: MODULE > RESSOURCE > ACTION) */
+  @NotBlank
+  @Column(name = "code", unique = true, nullable = false, length = 100)
+  private String code;
+
+  /** Module (ex: ORGANISATION, MEMBRE, COTISATION) */
+  @NotBlank
+  @Column(name = "module", nullable = false, length = 50)
+  private String module;
+
+  /** Ressource (ex: MEMBRE, COTISATION, ADHESION) */
+  @NotBlank
+  @Column(name = "ressource", nullable = false, length = 50)
+  private String ressource;
+
+  /** Action (ex: CREATE, READ, UPDATE, DELETE, VALIDATE) */
+  @NotBlank
+  @Column(name = "action", nullable = false, length = 50)
+  private String action;
+
+  /** Libellé de la permission */
+  @Column(name = "libelle", length = 200)
+  private String libelle;
+
+  /** Description de la permission */
+  @Column(name = "description", length = 500)
+  private String description;
+
+  /** Rôles associés */
+  @JsonIgnore
+  @OneToMany(mappedBy = "permission", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<RolePermission> roles = new ArrayList<>();
+
+  /** Méthode métier pour générer le code à partir des composants */
+  public static String genererCode(String module, String ressource, String action) {
+    return String.format("%s > %s > %s", module.toUpperCase(), ressource.toUpperCase(), action.toUpperCase());
+  }
+
+  /** Méthode métier pour vérifier si le code est valide */
+  public boolean isCodeValide() {
+    return code != null && code.contains(" > ") && code.split(" > ").length == 3;
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    // Générer le code si non fourni
+    if (code == null || code.isEmpty()) {
+      if (module != null && ressource != null && action != null) {
+        code = genererCode(module, ressource, action);
+      }
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/PieceJointe.java

@@ -1,122 +1,122 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.Column;
-import jakarta.persistence.Entity;
-import jakarta.persistence.FetchType;
-import jakarta.persistence.Index;
-import jakarta.persistence.JoinColumn;
-import jakarta.persistence.ManyToOne;
-import jakarta.persistence.PrePersist;
-import jakarta.persistence.Table;
-import jakarta.validation.constraints.Min;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import jakarta.validation.constraints.Size;
-import java.util.UUID;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Association polymorphique entre un document et
- * une entité métier quelconque.
- *
- * <p>
- * Remplace les 6 FK nullables mutuellement
- * exclusives (membre, organisation, cotisation,
- * adhesion, demandeAide, transactionWave) par un
- * couple {@code (type_entite_rattachee,
- * entite_rattachee_id)}.
- *
- * <p>
- * Les types autorisés sont définis dans le
- * domaine {@code ENTITE_RATTACHEE} de la table
- * {@code types_reference} (ex: MEMBRE,
- * ORGANISATION, COTISATION, ADHESION, AIDE,
- * TRANSACTION_WAVE).
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2026-02-21
- */
-@Entity
-@Table(name = "pieces_jointes", indexes = {
-    @Index(name = "idx_pj_document", columnList = "document_id"),
-    @Index(name = "idx_pj_entite", columnList = "type_entite_rattachee,"
-        + " entite_rattachee_id"),
-    @Index(name = "idx_pj_type_entite", columnList = "type_entite_rattachee")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class PieceJointe extends BaseEntity {
-
-  /** Ordre d'affichage. */
-  @NotNull
-  @Min(value = 1, message = "L'ordre doit être positif")
-  @Column(name = "ordre", nullable = false)
-  private Integer ordre;
-
-  /** Libellé de la pièce jointe. */
-  @Size(max = 200)
-  @Column(name = "libelle", length = 200)
-  private String libelle;
-
-  /** Commentaire. */
-  @Size(max = 500)
-  @Column(name = "commentaire", length = 500)
-  private String commentaire;
-
-  /** Document associé (obligatoire). */
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "document_id", nullable = false)
-  private Document document;
-
-  /**
-   * Type de l'entité rattachée (code du domaine
-   * {@code ENTITE_RATTACHEE} dans
-   * {@code types_reference}).
-   *
-   * <p>
-   * Valeurs attendues : {@code MEMBRE},
-   * {@code ORGANISATION}, {@code COTISATION},
-   * {@code ADHESION}, {@code AIDE},
-   * {@code TRANSACTION_WAVE}.
-   */
-  @NotBlank
-  @Size(max = 50)
-  @Column(name = "type_entite_rattachee", nullable = false, length = 50)
-  private String typeEntiteRattachee;
-
-  /**
-   * UUID de l'entité rattachée (membre,
-   * organisation, cotisation, etc.).
-   */
-  @NotNull
-  @Column(name = "entite_rattachee_id", nullable = false)
-  private UUID entiteRattacheeId;
-
-  /**
-   * Callback JPA avant la persistance.
-   *
-   * <p>
-   * Initialise {@code ordre} à 1 si non
-   * renseigné. Normalise le type en majuscules.
-   */
-  @Override
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (ordre == null) {
-      ordre = 1;
-    }
-    if (typeEntiteRattachee != null) {
-      typeEntiteRattachee = typeEntiteRattachee.toUpperCase();
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.Index;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.PrePersist;
+import jakarta.persistence.Table;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Association polymorphique entre un document et
+ * une entité métier quelconque.
+ *
+ * <p>
+ * Remplace les 6 FK nullables mutuellement
+ * exclusives (membre, organisation, cotisation,
+ * adhesion, demandeAide, transactionWave) par un
+ * couple {@code (type_entite_rattachee,
+ * entite_rattachee_id)}.
+ *
+ * <p>
+ * Les types autorisés sont définis dans le
+ * domaine {@code ENTITE_RATTACHEE} de la table
+ * {@code types_reference} (ex: MEMBRE,
+ * ORGANISATION, COTISATION, ADHESION, AIDE,
+ * TRANSACTION_WAVE).
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2026-02-21
+ */
+@Entity
+@Table(name = "pieces_jointes", indexes = {
+    @Index(name = "idx_pj_document", columnList = "document_id"),
+    @Index(name = "idx_pj_entite", columnList = "type_entite_rattachee,"
+        + " entite_rattachee_id"),
+    @Index(name = "idx_pj_type_entite", columnList = "type_entite_rattachee")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class PieceJointe extends BaseEntity {
+
+  /** Ordre d'affichage. */
+  @NotNull
+  @Min(value = 1, message = "L'ordre doit être positif")
+  @Column(name = "ordre", nullable = false)
+  private Integer ordre;
+
+  /** Libellé de la pièce jointe. */
+  @Size(max = 200)
+  @Column(name = "libelle", length = 200)
+  private String libelle;
+
+  /** Commentaire. */
+  @Size(max = 500)
+  @Column(name = "commentaire", length = 500)
+  private String commentaire;
+
+  /** Document associé (obligatoire). */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "document_id", nullable = false)
+  private Document document;
+
+  /**
+   * Type de l'entité rattachée (code du domaine
+   * {@code ENTITE_RATTACHEE} dans
+   * {@code types_reference}).
+   *
+   * <p>
+   * Valeurs attendues : {@code MEMBRE},
+   * {@code ORGANISATION}, {@code COTISATION},
+   * {@code ADHESION}, {@code AIDE},
+   * {@code TRANSACTION_WAVE}.
+   */
+  @NotBlank
+  @Size(max = 50)
+  @Column(name = "type_entite_rattachee", nullable = false, length = 50)
+  private String typeEntiteRattachee;
+
+  /**
+   * UUID de l'entité rattachée (membre,
+   * organisation, cotisation, etc.).
+   */
+  @NotNull
+  @Column(name = "entite_rattachee_id", nullable = false)
+  private UUID entiteRattacheeId;
+
+  /**
+   * Callback JPA avant la persistance.
+   *
+   * <p>
+   * Initialise {@code ordre} à 1 si non
+   * renseigné. Normalise le type en majuscules.
+   */
+  @Override
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (ordre == null) {
+      ordre = 1;
+    }
+    if (typeEntiteRattachee != null) {
+      typeEntiteRattachee = typeEntiteRattachee.toUpperCase();
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/ProcesVerbal.java

@@ -0,0 +1,144 @@
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.hibernate.annotations.JdbcTypeCode;
+import org.hibernate.type.SqlTypes;
+
+/**
+ * Procès-verbal d'AG ou de CA conforme OHADA AUDSCGIE.
+ *
+ * <p>Structure obligatoire selon l'Acte Uniforme OHADA Sociétés Coopératives (15 décembre 2010,
+ * applicable depuis 15 mai 2011) + AUDSCGIE révisé 30 janvier 2014 :
+ *
+ * <ul>
+ *   <li>Date, lieu, heures d'ouverture et clôture
+ *   <li>Quorum calculé (selon convoqués / présents / représentés)
+ *   <li>Ordre du jour structuré
+ *   <li>Résolutions votées avec décompte (pour / contre / abstentions / adoptée)
+ *   <li>Signatures président + secrétaire
+ *   <li>Archivage immuable au siège (hash SHA-256 pour intégrité)
+ * </ul>
+ *
+ * @since 2026-04-25 (P1-NEW-2)
+ */
+@Entity
+@Table(name = "proces_verbaux")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ProcesVerbal extends BaseEntity {
+
+  @NotNull
+  @Column(name = "organisation_id", nullable = false)
+  private UUID organisationId;
+
+  @NotBlank
+  @Column(name = "type_seance", nullable = false, length = 20)
+  private String typeSeance; // AG_CONSTITUTIVE, AG_ORDINAIRE, AG_EXTRAORDINAIRE, CA, BUREAU
+
+  @NotBlank
+  @Column(name = "titre", nullable = false, length = 255)
+  private String titre;
+
+  @Column(name = "numero_seance", length = 50)
+  private String numeroSeance;
+
+  // Convocation
+  @NotNull
+  @Column(name = "date_convocation", nullable = false)
+  private LocalDateTime dateConvocation;
+
+  @Column(name = "mode_convocation", length = 50)
+  private String modeConvocation;
+
+  // Tenue
+  @NotNull
+  @Column(name = "date_seance", nullable = false)
+  private LocalDateTime dateSeance;
+
+  @Column(name = "lieu", length = 255)
+  private String lieu;
+
+  @Column(name = "heure_ouverture")
+  private LocalTime heureOuverture;
+
+  @Column(name = "heure_cloture")
+  private LocalTime heureCloture;
+
+  // Quorum
+  @Column(name = "nombre_convoques", nullable = false)
+  @Builder.Default
+  private int nombreConvoques = 0;
+
+  @Column(name = "nombre_presents", nullable = false)
+  @Builder.Default
+  private int nombrePresents = 0;
+
+  @Column(name = "nombre_representes", nullable = false)
+  @Builder.Default
+  private int nombreRepresentes = 0;
+
+  @Column(name = "quorum_atteint", nullable = false)
+  @Builder.Default
+  private boolean quorumAtteint = false;
+
+  @Column(name = "quorum_requis_pct", precision = 5, scale = 2)
+  private BigDecimal quorumRequisPct;
+
+  @Column(name = "quorum_calcule_pct", precision = 5, scale = 2)
+  private BigDecimal quorumCalculePct;
+
+  // Présidence
+  @Column(name = "president_seance_id")
+  private UUID presidentSeanceId;
+
+  @Column(name = "secretaire_seance_id")
+  private UUID secretaireSeanceId;
+
+  @JdbcTypeCode(SqlTypes.JSON)
+  @Column(name = "scrutateurs_ids", columnDefinition = "jsonb")
+  private String scrutateursIds; // JSON array of UUIDs
+
+  // Contenu
+  @JdbcTypeCode(SqlTypes.JSON)
+  @Column(name = "ordre_du_jour", columnDefinition = "jsonb", nullable = false)
+  private String ordreDuJour; // JSON: [{numero, intitule, type}]
+
+  @JdbcTypeCode(SqlTypes.JSON)
+  @Column(name = "resolutions", columnDefinition = "jsonb", nullable = false)
+  private String resolutions; // JSON: [{numero, intitule, votesPour, votesContre, votesAbstention, adoptee}]
+
+  @Column(name = "deliberations", columnDefinition = "TEXT")
+  private String deliberations;
+
+  // Signature & archivage
+  @NotBlank
+  @Column(name = "statut", nullable = false, length = 30)
+  @Builder.Default
+  private String statut = "BROUILLON"; // BROUILLON, ADOPTE, SIGNE, ARCHIVE
+
+  @Column(name = "hash_sha256", length = 64)
+  private String hashSha256;
+
+  @Column(name = "date_signature")
+  private LocalDateTime dateSignature;
+
+  @Column(name = "signature_president", length = 500)
+  private String signaturePresident;
+
+  @Column(name = "signature_secretaire", length = 500)
+  private String signatureSecretaire;
+}

src/main/java/dev/lions/unionflow/server/entity/RapportTrimestrielControleurInterne.java

@@ -0,0 +1,97 @@
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.Index;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.hibernate.annotations.JdbcTypeCode;
+import org.hibernate.type.SqlTypes;
+
+/**
+ * Rapport trimestriel agrégé généré par/pour le Contrôleur Interne d'une organisation.
+ *
+ * <p>Source documentaire pour :
+ * <ul>
+ *   <li>Présentation lors des AG (rapport moral / financier / technique)</li>
+ *   <li>Inspections BCEAO Instruction 001-03-2025 (LBC/FT)</li>
+ *   <li>Audits ARTCI Décision 2025-1312 (DPO / sécurité données)</li>
+ * </ul>
+ *
+ * <p>Cycle de vie : {@code DRAFT} → {@code SIGNE} (hash SHA-256 calculé) → {@code ARCHIVE}.
+ *
+ * @since 2026-04-25 (P2-NEW-3)
+ */
+@Entity
+@Table(name = "rapports_trimestriels_controleur_interne",
+    uniqueConstraints = @UniqueConstraint(
+        name = "uq_rapport_trim_org_annee_trim",
+        columnNames = {"organisation_id", "annee", "trimestre"}),
+    indexes = {
+        @Index(name = "idx_rapport_trim_org", columnList = "organisation_id"),
+        @Index(name = "idx_rapport_trim_annee_trim", columnList = "annee,trimestre"),
+        @Index(name = "idx_rapport_trim_statut", columnList = "statut")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class RapportTrimestrielControleurInterne extends BaseEntity {
+
+  @Column(name = "organisation_id", nullable = false)
+  private UUID organisationId;
+
+  @Min(2024)
+  @Max(2099)
+  @Column(name = "annee", nullable = false)
+  private Integer annee;
+
+  @Min(1)
+  @Max(4)
+  @Column(name = "trimestre", nullable = false)
+  private Integer trimestre;
+
+  @Column(name = "date_generation", nullable = false)
+  private LocalDateTime dateGeneration;
+
+  @Builder.Default
+  @Column(name = "statut", nullable = false, length = 20)
+  private String statut = "DRAFT";
+
+  @Builder.Default
+  @Min(0)
+  @Max(100)
+  @Column(name = "score_conformite", nullable = false)
+  private Integer scoreConformite = 0;
+
+  /** Snapshot agrégé en JSON (compliance score, DOS count, KYC %, etc.). */
+  @JdbcTypeCode(SqlTypes.JSON)
+  @Column(name = "contenu_jsonb", columnDefinition = "jsonb")
+  private JsonNode contenuJsonb;
+
+  /** PDF généré par OpenPDF. Null avant génération. */
+  @Column(name = "pdf_bytes")
+  private byte[] pdfBytes;
+
+  /** UUID du membre Contrôleur Interne signataire. */
+  @Column(name = "signataire_id")
+  private UUID signataireId;
+
+  @Column(name = "date_signature")
+  private LocalDateTime dateSignature;
+
+  /** Hash SHA-256 du contenu_jsonb calculé à la signature — immuable ensuite. */
+  @Column(name = "hash_sha256", length = 64)
+  private String hashSha256;
+}

src/main/java/dev/lions/unionflow/server/entity/ReferentielComptable.java

@@ -0,0 +1,68 @@
+package dev.lions.unionflow.server.entity;
+
+/**
+ * Référentiel comptable applicable à une {@link Organisation}.
+ *
+ * <p>OHADA dispose désormais de plusieurs référentiels selon la nature de l'entité :
+ *
+ * <ul>
+ *   <li>{@link #SYSCOHADA} — Système Comptable OHADA révisé (1er jan 2018) pour entités
+ *       commerciales/coopératives à but lucratif.
+ *   <li>{@link #SYCEBNL} — Système Comptable OHADA des Entités à But Non Lucratif (11ᵉ Acte
+ *       uniforme, entré en vigueur <strong>1er jan 2024</strong>) pour mutuelles sociales,
+ *       associations, ONG, fondations, syndicats, projets de développement.
+ *   <li>{@link #PCSFD_UMOA} — Plan Comptable des Systèmes Financiers Décentralisés UMOA pour SFD
+ *       soumis Commission Bancaire UMOA (article 44, encours ≥ 2 milliards FCFA = catégorie III).
+ * </ul>
+ *
+ * <p>Le mapping par défaut depuis {@code Organisation.typeOrganisation} se trouve dans
+ * {@link #defaultFor(String)}. L'admin peut overrider manuellement (cas hybrides).
+ *
+ * <p>Voir : {@code unionflow/docs/COMPLIANCE_OHADA_SYCEBNL.md} et {@code
+ * unionflow/docs/COMPLIANCE_OHADA_SYSCOHADA.md}.
+ *
+ * @since 2026-04-25
+ */
+public enum ReferentielComptable {
+  /** Système Comptable OHADA révisé (entités commerciales / coopératives lucratives). */
+  SYSCOHADA,
+
+  /**
+   * Système Comptable OHADA des Entités à But Non Lucratif (mutuelles sociales, associations,
+   * ONG, fondations, Lions Clubs, syndicats). Acte uniforme entré en vigueur 1er janvier 2024.
+   */
+  SYCEBNL,
+
+  /**
+   * Plan Comptable des Systèmes Financiers Décentralisés UMOA. Pour SFD article 44 (encours ≥ 2
+   * Md FCFA = catégorie III, commissaire aux comptes obligatoire agréé OHADA, sélection soumise
+   * approbation Commission Bancaire UMOA).
+   */
+  PCSFD_UMOA;
+
+  /**
+   * Retourne le référentiel par défaut suggéré pour un {@code typeOrganisation}. L'admin peut
+   * overrider manuellement à la création/édition d'une organisation.
+   *
+   * @param typeOrganisation valeur de {@link Organisation#getTypeOrganisation()}
+   * @return référentiel par défaut, jamais null (fallback {@link #SYSCOHADA})
+   */
+  public static ReferentielComptable defaultFor(String typeOrganisation) {
+    if (typeOrganisation == null) {
+      return SYSCOHADA;
+    }
+    return switch (typeOrganisation.toUpperCase()) {
+      case "MUTUELLE_SANTE",
+              "ASSOCIATION",
+              "LIONS_CLUB",
+              "ONG",
+              "FONDATION",
+              "SYNDICAT",
+              "ORDRE_PROFESSIONNEL",
+              "PROJET_DEVELOPPEMENT" ->
+          SYCEBNL;
+      case "SFD_TIER_1", "SFD_CATEGORIE_III" -> PCSFD_UMOA;
+      default -> SYSCOHADA;
+    };
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Role.java

@@ -1,98 +1,98 @@
-package dev.lions.unionflow.server.entity;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Role pour la gestion des rôles dans le système
- *
- * @author UnionFlow Team
- * @version 3.1
- * @since 2025-01-29
- */
-@Entity
-@Table(name = "roles", indexes = {
-    @Index(name = "idx_role_code", columnList = "code", unique = true),
-    @Index(name = "idx_role_actif", columnList = "actif"),
-    @Index(name = "idx_role_niveau", columnList = "niveau_hierarchique")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Role extends BaseEntity {
-
-  /** Code unique du rôle */
-  @NotBlank
-  @Column(name = "code", unique = true, nullable = false, length = 50)
-  private String code;
-
-  /** Libellé du rôle */
-  @NotBlank
-  @Column(name = "libelle", nullable = false, length = 100)
-  private String libelle;
-
-  /** Description du rôle */
-  @Column(name = "description", length = 500)
-  private String description;
-
-  /** Niveau hiérarchique (plus bas = plus prioritaire) */
-  @NotNull
-  @Builder.Default
-  @Column(name = "niveau_hierarchique", nullable = false)
-  private Integer niveauHierarchique = 100;
-
-  /** Type de rôle (SYSTEME, ORGANISATION, PERSONNALISE) */
-  @Column(name = "type_role", nullable = false, length = 50)
-  private String typeRole;
-
-  /** Catégorie du rôle (PLATEFORME, FONCTIONNEL, METIER) */
-  @Column(name = "categorie", length = 30)
-  @Builder.Default
-  private String categorie = "FONCTIONNEL";
-
-  /** Organisation propriétaire (null pour rôles système) */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id")
-  private Organisation organisation;
-
-  /** Permissions associées */
-  @JsonIgnore
-  @OneToMany(mappedBy = "role", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<RolePermission> permissions = new ArrayList<>();
-
-  /** Énumération des constantes de types de rôle */
-  public enum TypeRole {
-    SYSTEME,
-    ORGANISATION,
-    PERSONNALISE;
-  }
-
-  /** Méthode métier pour vérifier si c'est un rôle système */
-  public boolean isRoleSysteme() {
-    return TypeRole.SYSTEME.name().equals(typeRole);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (typeRole == null) {
-      typeRole = TypeRole.PERSONNALISE.name();
-    }
-    if (niveauHierarchique == null) {
-      niveauHierarchique = 100;
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Role pour la gestion des rôles dans le système
+ *
+ * @author UnionFlow Team
+ * @version 3.1
+ * @since 2025-01-29
+ */
+@Entity
+@Table(name = "roles", indexes = {
+    @Index(name = "idx_role_code", columnList = "code", unique = true),
+    @Index(name = "idx_role_actif", columnList = "actif"),
+    @Index(name = "idx_role_niveau", columnList = "niveau_hierarchique")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Role extends BaseEntity {
+
+  /** Code unique du rôle */
+  @NotBlank
+  @Column(name = "code", unique = true, nullable = false, length = 50)
+  private String code;
+
+  /** Libellé du rôle */
+  @NotBlank
+  @Column(name = "libelle", nullable = false, length = 100)
+  private String libelle;
+
+  /** Description du rôle */
+  @Column(name = "description", length = 500)
+  private String description;
+
+  /** Niveau hiérarchique (plus bas = plus prioritaire) */
+  @NotNull
+  @Builder.Default
+  @Column(name = "niveau_hierarchique", nullable = false)
+  private Integer niveauHierarchique = 100;
+
+  /** Type de rôle (SYSTEME, ORGANISATION, PERSONNALISE) */
+  @Column(name = "type_role", nullable = false, length = 50)
+  private String typeRole;
+
+  /** Catégorie du rôle (PLATEFORME, FONCTIONNEL, METIER) */
+  @Column(name = "categorie", length = 30)
+  @Builder.Default
+  private String categorie = "FONCTIONNEL";
+
+  /** Organisation propriétaire (null pour rôles système) */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id")
+  private Organisation organisation;
+
+  /** Permissions associées */
+  @JsonIgnore
+  @OneToMany(mappedBy = "role", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<RolePermission> permissions = new ArrayList<>();
+
+  /** Énumération des constantes de types de rôle */
+  public enum TypeRole {
+    SYSTEME,
+    ORGANISATION,
+    PERSONNALISE;
+  }
+
+  /** Méthode métier pour vérifier si c'est un rôle système */
+  public boolean isRoleSysteme() {
+    return TypeRole.SYSTEME.name().equals(typeRole);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (typeRole == null) {
+      typeRole = TypeRole.PERSONNALISE.name();
+    }
+    if (niveauHierarchique == null) {
+      niveauHierarchique = 100;
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/RoleDelegation.java

@@ -0,0 +1,77 @@
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Délégation temporaire d'un rôle.
+ *
+ * <p>Cas d'usage : trésorier en congé délègue son rôle au trésorier adjoint pour 2 semaines.
+ *
+ * <p>Le {@code PermissionChecker} consulte cette table pour calculer le rôle effectif :
+ * <strong>roles directs ∪ roles délégués actifs</strong> (statut=ACTIVE et dateFin > now).
+ *
+ * @since 2026-04-25 (P1-NEW-5)
+ */
+@Entity
+@Table(name = "role_delegations", indexes = {
+    @Index(name = "idx_delegation_org", columnList = "organisation_id"),
+    @Index(name = "idx_delegation_delegataire", columnList = "delegataire_user_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class RoleDelegation extends BaseEntity {
+
+  @NotNull
+  @Column(name = "organisation_id", nullable = false)
+  private UUID organisationId;
+
+  @NotNull
+  @Column(name = "delegant_user_id", nullable = false)
+  private UUID delegantUserId;
+
+  @NotNull
+  @Column(name = "delegataire_user_id", nullable = false)
+  private UUID delegataireUserId;
+
+  @NotBlank
+  @Column(name = "role_delegue", nullable = false, length = 50)
+  private String roleDelegue;
+
+  @NotNull
+  @Column(name = "date_debut", nullable = false)
+  private LocalDateTime dateDebut;
+
+  @NotNull
+  @Column(name = "date_fin", nullable = false)
+  private LocalDateTime dateFin;
+
+  @Column(name = "motif", length = 500)
+  private String motif;
+
+  @NotBlank
+  @Column(name = "statut", nullable = false, length = 20)
+  @Builder.Default
+  private String statut = "ACTIVE"; // ACTIVE, EXPIREE, REVOQUEE
+
+  @Column(name = "date_revocation")
+  private LocalDateTime dateRevocation;
+
+  /** Vrai si la délégation est active à l'instant donné. */
+  public boolean isActiveAt(LocalDateTime instant) {
+    return "ACTIVE".equals(statut)
+        && dateDebut != null && !dateDebut.isAfter(instant)
+        && dateFin != null && dateFin.isAfter(instant);
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/RolePermission.java

@@ -1,54 +1,54 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Table de liaison entre Role et Permission
- * Permet à un rôle d'avoir plusieurs permissions
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "roles_permissions",
-    indexes = {
-      @Index(name = "idx_role_permission_role", columnList = "role_id"),
-      @Index(name = "idx_role_permission_permission", columnList = "permission_id")
-    },
-    uniqueConstraints = {
-      @UniqueConstraint(
-          name = "uk_role_permission",
-          columnNames = {"role_id", "permission_id"})
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class RolePermission extends BaseEntity {
-
-  /** Rôle */
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "role_id", nullable = false)
-  private Role role;
-
-  /** Permission */
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "permission_id", nullable = false)
-  private Permission permission;
-
-  /** Commentaire sur l'association */
-  @Column(name = "commentaire", length = 500)
-  private String commentaire;
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Table de liaison entre Role et Permission
+ * Permet à un rôle d'avoir plusieurs permissions
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "roles_permissions",
+    indexes = {
+      @Index(name = "idx_role_permission_role", columnList = "role_id"),
+      @Index(name = "idx_role_permission_permission", columnList = "permission_id")
+    },
+    uniqueConstraints = {
+      @UniqueConstraint(
+          name = "uk_role_permission",
+          columnNames = {"role_id", "permission_id"})
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class RolePermission extends BaseEntity {
+
+  /** Rôle */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "role_id", nullable = false)
+  private Role role;
+
+  /** Permission */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "permission_id", nullable = false)
+  private Permission permission;
+
+  /** Commentaire sur l'association */
+  @Column(name = "commentaire", length = 500)
+  private String commentaire;
+}
+

src/main/java/dev/lions/unionflow/server/entity/SouscriptionOrganisation.java

@@ -1,171 +1,171 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.abonnement.PlageMembres;
-import dev.lions.unionflow.server.api.enums.abonnement.StatutSouscription;
-import dev.lions.unionflow.server.api.enums.abonnement.StatutValidationSouscription;
-import dev.lions.unionflow.server.api.enums.abonnement.TypePeriodeAbonnement;
-import dev.lions.unionflow.server.api.enums.abonnement.TypeOrganisationFacturation;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.util.UUID;
-import lombok.*;
-
-/**
- * Abonnement actif d'une organisation racine à un forfait UnionFlow.
- *
- * <p>Règle clé : quand {@code quotaUtilise >= quotaMax}, toute nouvelle
- * validation d'adhésion est bloquée avec un message explicite.
- * Le manager peut upgrader son forfait à tout moment.
- *
- * <p>Table : {@code souscriptions_organisation}
- */
-@Entity
-@Table(
-    name = "souscriptions_organisation",
-    indexes = {
-      @Index(name = "idx_souscription_org",    columnList = "organisation_id", unique = true),
-      @Index(name = "idx_souscription_statut", columnList = "statut"),
-      @Index(name = "idx_souscription_fin",    columnList = "date_fin")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class SouscriptionOrganisation extends BaseEntity {
-
-  /** Organisation racine abonnée (une seule souscription active par org) */
-  @NotNull
-  @OneToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id", nullable = false, unique = true)
-  private Organisation organisation;
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "formule_id", nullable = false)
-  private FormuleAbonnement formule;
-
-  @Enumerated(EnumType.STRING)
-  @Builder.Default
-  @Column(name = "type_periode", nullable = false, length = 10)
-  private TypePeriodeAbonnement typePeriode = TypePeriodeAbonnement.MENSUEL;
-
-  @NotNull
-  @Column(name = "date_debut", nullable = false)
-  private LocalDate dateDebut;
-
-  @NotNull
-  @Column(name = "date_fin", nullable = false)
-  private LocalDate dateFin;
-
-  /** Snapshot du quota max au moment de la souscription */
-  @Column(name = "quota_max")
-  private Integer quotaMax;
-
-  /** Compteur incrémenté à chaque adhésion validée */
-  @Builder.Default
-  @Min(0)
-  @Column(name = "quota_utilise", nullable = false)
-  private Integer quotaUtilise = 0;
-
-  @Enumerated(EnumType.STRING)
-  @Builder.Default
-  @Column(name = "statut", nullable = false, length = 30)
-  private StatutSouscription statut = StatutSouscription.ACTIVE;
-
-  @Column(name = "reference_paiement_wave", length = 100)
-  private String referencePaiementWave;
-
-  @Column(name = "wave_session_id", length = 255)
-  private String waveSessionId;
-
-  @Column(name = "wave_checkout_url", length = 1024)
-  private String waveCheckoutUrl;
-
-  @Column(name = "date_dernier_paiement")
-  private LocalDate dateDernierPaiement;
-
-  @Column(name = "date_prochain_paiement")
-  private LocalDate dateProchainePaiement;
-
-  // ── Champs workflow de validation (onboarding) ────────────────────────────
-
-  /** Plage de membres choisie lors de la souscription. */
-  @Enumerated(EnumType.STRING)
-  @Column(name = "plage", length = 20)
-  private PlageMembres plage;
-
-  /** Type d'organisation déclaré, utilisé pour le coefficient tarifaire. */
-  @Enumerated(EnumType.STRING)
-  @Column(name = "type_organisation", length = 30)
-  private TypeOrganisationFacturation typeOrganisationSouscription;
-
-  /** Coefficient multiplicateur effectivement appliqué (org × période). */
-  @Column(name = "coefficient_applique", precision = 4, scale = 2)
-  private BigDecimal coefficientApplique;
-
-  /** État du workflow de validation SuperAdmin. */
-  @Enumerated(EnumType.STRING)
-  @Builder.Default
-  @Column(name = "statut_validation", nullable = false, length = 40)
-  private StatutValidationSouscription statutValidation = StatutValidationSouscription.EN_ATTENTE_PAIEMENT;
-
-  /** Montant total facturé pour la période choisie (en XOF). */
-  @Column(name = "montant_total", precision = 12, scale = 2)
-  private BigDecimal montantTotal;
-
-  /** Date à laquelle le SuperAdmin a approuvé ou rejeté la souscription. */
-  @Column(name = "date_validation")
-  private LocalDate dateValidation;
-
-  /** UUID du SuperAdmin ayant validé ou rejeté. */
-  @Column(name = "validated_by_id")
-  private UUID validatedById;
-
-  /** Motif de rejet renseigné par le SuperAdmin. */
-  @Column(name = "commentaire_rejet", length = 500)
-  private String commentaireRejet;
-
-  /** Mot de passe temporaire généré à l'activation du compte. */
-  @Column(name = "mot_de_passe_temporaire", length = 100)
-  private String motDePasseTemporaire;
-
-  // ── Méthodes métier ────────────────────────────────────────────────────────
-
-  public boolean isActive() {
-    return StatutSouscription.ACTIVE.equals(statut)
-        && LocalDate.now().isBefore(dateFin.plusDays(1));
-  }
-
-  public boolean isQuotaDepasse() {
-    return quotaMax != null && quotaUtilise >= quotaMax;
-  }
-
-  public int getPlacesRestantes() {
-    if (quotaMax == null) return Integer.MAX_VALUE;
-    return Math.max(0, quotaMax - quotaUtilise);
-  }
-
-  /** Incrémente le quota lors de la validation d'une adhésion */
-  public void incrementerQuota() {
-    if (quotaUtilise == null) quotaUtilise = 0;
-    quotaUtilise++;
-  }
-
-  /** Décrémente le quota lors de la radiation d'un membre */
-  public void decrementerQuota() {
-    if (quotaUtilise != null && quotaUtilise > 0) quotaUtilise--;
-  }
-
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statut == null)            statut            = StatutSouscription.ACTIVE;
-    if (typePeriode == null)       typePeriode       = TypePeriodeAbonnement.MENSUEL;
-    if (quotaUtilise == null)      quotaUtilise      = 0;
-    if (statutValidation == null)  statutValidation  = StatutValidationSouscription.EN_ATTENTE_PAIEMENT;
-    if (formule != null && quotaMax == null) quotaMax = formule.getMaxMembres();
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.abonnement.PlageMembres;
+import dev.lions.unionflow.server.api.enums.abonnement.StatutSouscription;
+import dev.lions.unionflow.server.api.enums.abonnement.StatutValidationSouscription;
+import dev.lions.unionflow.server.api.enums.abonnement.TypePeriodeAbonnement;
+import dev.lions.unionflow.server.api.enums.abonnement.TypeOrganisationFacturation;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.UUID;
+import lombok.*;
+
+/**
+ * Abonnement actif d'une organisation racine à un forfait UnionFlow.
+ *
+ * <p>Règle clé : quand {@code quotaUtilise >= quotaMax}, toute nouvelle
+ * validation d'adhésion est bloquée avec un message explicite.
+ * Le manager peut upgrader son forfait à tout moment.
+ *
+ * <p>Table : {@code souscriptions_organisation}
+ */
+@Entity
+@Table(
+    name = "souscriptions_organisation",
+    indexes = {
+      @Index(name = "idx_souscription_org",    columnList = "organisation_id", unique = true),
+      @Index(name = "idx_souscription_statut", columnList = "statut"),
+      @Index(name = "idx_souscription_fin",    columnList = "date_fin")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class SouscriptionOrganisation extends BaseEntity {
+
+  /** Organisation racine abonnée (une seule souscription active par org) */
+  @NotNull
+  @OneToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id", nullable = false, unique = true)
+  private Organisation organisation;
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "formule_id", nullable = false)
+  private FormuleAbonnement formule;
+
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "type_periode", nullable = false, length = 10)
+  private TypePeriodeAbonnement typePeriode = TypePeriodeAbonnement.MENSUEL;
+
+  @NotNull
+  @Column(name = "date_debut", nullable = false)
+  private LocalDate dateDebut;
+
+  @NotNull
+  @Column(name = "date_fin", nullable = false)
+  private LocalDate dateFin;
+
+  /** Snapshot du quota max au moment de la souscription */
+  @Column(name = "quota_max")
+  private Integer quotaMax;
+
+  /** Compteur incrémenté à chaque adhésion validée */
+  @Builder.Default
+  @Min(0)
+  @Column(name = "quota_utilise", nullable = false)
+  private Integer quotaUtilise = 0;
+
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "statut", nullable = false, length = 30)
+  private StatutSouscription statut = StatutSouscription.ACTIVE;
+
+  @Column(name = "reference_paiement_wave", length = 100)
+  private String referencePaiementWave;
+
+  @Column(name = "wave_session_id", length = 255)
+  private String waveSessionId;
+
+  @Column(name = "wave_checkout_url", length = 1024)
+  private String waveCheckoutUrl;
+
+  @Column(name = "date_dernier_paiement")
+  private LocalDate dateDernierPaiement;
+
+  @Column(name = "date_prochain_paiement")
+  private LocalDate dateProchainePaiement;
+
+  // ── Champs workflow de validation (onboarding) ────────────────────────────
+
+  /** Plage de membres choisie lors de la souscription. */
+  @Enumerated(EnumType.STRING)
+  @Column(name = "plage", length = 20)
+  private PlageMembres plage;
+
+  /** Type d'organisation déclaré, utilisé pour le coefficient tarifaire. */
+  @Enumerated(EnumType.STRING)
+  @Column(name = "type_organisation", length = 30)
+  private TypeOrganisationFacturation typeOrganisationSouscription;
+
+  /** Coefficient multiplicateur effectivement appliqué (org × période). */
+  @Column(name = "coefficient_applique", precision = 4, scale = 2)
+  private BigDecimal coefficientApplique;
+
+  /** État du workflow de validation SuperAdmin. */
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "statut_validation", nullable = false, length = 40)
+  private StatutValidationSouscription statutValidation = StatutValidationSouscription.EN_ATTENTE_PAIEMENT;
+
+  /** Montant total facturé pour la période choisie (en XOF). */
+  @Column(name = "montant_total", precision = 12, scale = 2)
+  private BigDecimal montantTotal;
+
+  /** Date à laquelle le SuperAdmin a approuvé ou rejeté la souscription. */
+  @Column(name = "date_validation")
+  private LocalDate dateValidation;
+
+  /** UUID du SuperAdmin ayant validé ou rejeté. */
+  @Column(name = "validated_by_id")
+  private UUID validatedById;
+
+  /** Motif de rejet renseigné par le SuperAdmin. */
+  @Column(name = "commentaire_rejet", length = 500)
+  private String commentaireRejet;
+
+  /** Mot de passe temporaire généré à l'activation du compte. */
+  @Column(name = "mot_de_passe_temporaire", length = 100)
+  private String motDePasseTemporaire;
+
+  // ── Méthodes métier ────────────────────────────────────────────────────────
+
+  public boolean isActive() {
+    return StatutSouscription.ACTIVE.equals(statut)
+        && LocalDate.now().isBefore(dateFin.plusDays(1));
+  }
+
+  public boolean isQuotaDepasse() {
+    return quotaMax != null && quotaUtilise >= quotaMax;
+  }
+
+  public int getPlacesRestantes() {
+    if (quotaMax == null) return Integer.MAX_VALUE;
+    return Math.max(0, quotaMax - quotaUtilise);
+  }
+
+  /** Incrémente le quota lors de la validation d'une adhésion */
+  public void incrementerQuota() {
+    if (quotaUtilise == null) quotaUtilise = 0;
+    quotaUtilise++;
+  }
+
+  /** Décrémente le quota lors de la radiation d'un membre */
+  public void decrementerQuota() {
+    if (quotaUtilise != null && quotaUtilise > 0) quotaUtilise--;
+  }
+
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statut == null)            statut            = StatutSouscription.ACTIVE;
+    if (typePeriode == null)       typePeriode       = TypePeriodeAbonnement.MENSUEL;
+    if (quotaUtilise == null)      quotaUtilise      = 0;
+    if (statutValidation == null)  statutValidation  = StatutValidationSouscription.EN_ATTENTE_PAIEMENT;
+    if (formule != null && quotaMax == null) quotaMax = formule.getMaxMembres();
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/Suggestion.java

@@ -1,91 +1,91 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-import java.time.LocalDateTime;
-import java.util.UUID;
-
-/**
- * Entité Suggestion pour la gestion des suggestions utilisateur
- * 
- * @author UnionFlow Team
- * @version 1.0
- */
-@Entity
-@Table(
-    name = "suggestions",
-    indexes = {
-        @Index(name = "idx_suggestion_utilisateur", columnList = "utilisateur_id"),
-        @Index(name = "idx_suggestion_statut", columnList = "statut"),
-        @Index(name = "idx_suggestion_categorie", columnList = "categorie")
-    }
-)
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Suggestion extends BaseEntity {
-
-    @NotNull
-    @Column(name = "utilisateur_id", nullable = false)
-    private UUID utilisateurId;
-
-    @Column(name = "utilisateur_nom", length = 255)
-    private String utilisateurNom;
-
-    @NotBlank
-    @Column(name = "titre", nullable = false, length = 255)
-    private String titre;
-
-    @Column(name = "description", columnDefinition = "TEXT")
-    private String description;
-
-    @Column(name = "justification", columnDefinition = "TEXT")
-    private String justification;
-
-    @Column(name = "categorie", length = 50)
-    private String categorie; // UI, FEATURE, PERFORMANCE, SECURITE, INTEGRATION, MOBILE, REPORTING
-
-    @Column(name = "priorite_estimee", length = 50)
-    private String prioriteEstimee; // BASSE, MOYENNE, HAUTE, CRITIQUE
-
-    @Column(name = "statut", length = 50)
-    @Builder.Default
-    private String statut = "NOUVELLE"; // NOUVELLE, EVALUATION, APPROUVEE, DEVELOPPEMENT, IMPLEMENTEE, REJETEE
-
-    @Column(name = "nb_votes")
-    @Builder.Default
-    private Integer nbVotes = 0;
-
-    @Column(name = "nb_commentaires")
-    @Builder.Default
-    private Integer nbCommentaires = 0;
-
-    @Column(name = "nb_vues")
-    @Builder.Default
-    private Integer nbVues = 0;
-
-    @Column(name = "date_soumission")
-    private LocalDateTime dateSoumission;
-
-    @Column(name = "date_evaluation")
-    private LocalDateTime dateEvaluation;
-
-    @Column(name = "date_implementation")
-    private LocalDateTime dateImplementation;
-
-    @Column(name = "version_ciblee", length = 50)
-    private String versionCiblee;
-
-    @Column(name = "mise_a_jour", columnDefinition = "TEXT")
-    private String miseAJour;
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+/**
+ * Entité Suggestion pour la gestion des suggestions utilisateur
+ * 
+ * @author UnionFlow Team
+ * @version 1.0
+ */
+@Entity
+@Table(
+    name = "suggestions",
+    indexes = {
+        @Index(name = "idx_suggestion_utilisateur", columnList = "utilisateur_id"),
+        @Index(name = "idx_suggestion_statut", columnList = "statut"),
+        @Index(name = "idx_suggestion_categorie", columnList = "categorie")
+    }
+)
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Suggestion extends BaseEntity {
+
+    @NotNull
+    @Column(name = "utilisateur_id", nullable = false)
+    private UUID utilisateurId;
+
+    @Column(name = "utilisateur_nom", length = 255)
+    private String utilisateurNom;
+
+    @NotBlank
+    @Column(name = "titre", nullable = false, length = 255)
+    private String titre;
+
+    @Column(name = "description", columnDefinition = "TEXT")
+    private String description;
+
+    @Column(name = "justification", columnDefinition = "TEXT")
+    private String justification;
+
+    @Column(name = "categorie", length = 50)
+    private String categorie; // UI, FEATURE, PERFORMANCE, SECURITE, INTEGRATION, MOBILE, REPORTING
+
+    @Column(name = "priorite_estimee", length = 50)
+    private String prioriteEstimee; // BASSE, MOYENNE, HAUTE, CRITIQUE
+
+    @Column(name = "statut", length = 50)
+    @Builder.Default
+    private String statut = "NOUVELLE"; // NOUVELLE, EVALUATION, APPROUVEE, DEVELOPPEMENT, IMPLEMENTEE, REJETEE
+
+    @Column(name = "nb_votes")
+    @Builder.Default
+    private Integer nbVotes = 0;
+
+    @Column(name = "nb_commentaires")
+    @Builder.Default
+    private Integer nbCommentaires = 0;
+
+    @Column(name = "nb_vues")
+    @Builder.Default
+    private Integer nbVues = 0;
+
+    @Column(name = "date_soumission")
+    private LocalDateTime dateSoumission;
+
+    @Column(name = "date_evaluation")
+    private LocalDateTime dateEvaluation;
+
+    @Column(name = "date_implementation")
+    private LocalDateTime dateImplementation;
+
+    @Column(name = "version_ciblee", length = 50)
+    private String versionCiblee;
+
+    @Column(name = "mise_a_jour", columnDefinition = "TEXT")
+    private String miseAJour;
+}
+

src/main/java/dev/lions/unionflow/server/entity/SuggestionVote.java

@@ -1,66 +1,66 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-import java.time.LocalDateTime;
-import java.util.UUID;
-
-/**
- * Entité SuggestionVote pour gérer les votes sur les suggestions
- * 
- * <p>Permet d'éviter qu'un utilisateur vote plusieurs fois pour la même suggestion.
- * La contrainte d'unicité (suggestion_id, utilisateur_id) est gérée au niveau de la base de données.
- * 
- * @author UnionFlow Team
- * @version 1.0
- */
-@Entity
-@Table(
-    name = "suggestion_votes",
-    uniqueConstraints = {
-        @UniqueConstraint(
-            name = "uk_suggestion_vote",
-            columnNames = {"suggestion_id", "utilisateur_id"}
-        )
-    },
-    indexes = {
-        @Index(name = "idx_vote_suggestion", columnList = "suggestion_id"),
-        @Index(name = "idx_vote_utilisateur", columnList = "utilisateur_id")
-    }
-)
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class SuggestionVote extends BaseEntity {
-
-    @NotNull
-    @Column(name = "suggestion_id", nullable = false)
-    private UUID suggestionId;
-
-    @NotNull
-    @Column(name = "utilisateur_id", nullable = false)
-    private UUID utilisateurId;
-
-    @Column(name = "date_vote", nullable = false)
-    @Builder.Default
-    private LocalDateTime dateVote = LocalDateTime.now();
-
-    @PrePersist
-    protected void onPrePersist() {
-        if (dateVote == null) {
-            dateVote = LocalDateTime.now();
-        }
-        if (getDateCreation() == null) {
-            setDateCreation(LocalDateTime.now());
-        }
-    }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+/**
+ * Entité SuggestionVote pour gérer les votes sur les suggestions
+ * 
+ * <p>Permet d'éviter qu'un utilisateur vote plusieurs fois pour la même suggestion.
+ * La contrainte d'unicité (suggestion_id, utilisateur_id) est gérée au niveau de la base de données.
+ * 
+ * @author UnionFlow Team
+ * @version 1.0
+ */
+@Entity
+@Table(
+    name = "suggestion_votes",
+    uniqueConstraints = {
+        @UniqueConstraint(
+            name = "uk_suggestion_vote",
+            columnNames = {"suggestion_id", "utilisateur_id"}
+        )
+    },
+    indexes = {
+        @Index(name = "idx_vote_suggestion", columnList = "suggestion_id"),
+        @Index(name = "idx_vote_utilisateur", columnList = "utilisateur_id")
+    }
+)
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class SuggestionVote extends BaseEntity {
+
+    @NotNull
+    @Column(name = "suggestion_id", nullable = false)
+    private UUID suggestionId;
+
+    @NotNull
+    @Column(name = "utilisateur_id", nullable = false)
+    private UUID utilisateurId;
+
+    @Column(name = "date_vote", nullable = false)
+    @Builder.Default
+    private LocalDateTime dateVote = LocalDateTime.now();
+
+    @PrePersist
+    protected void onPrePersist() {
+        if (dateVote == null) {
+            dateVote = LocalDateTime.now();
+        }
+        if (getDateCreation() == null) {
+            setDateCreation(LocalDateTime.now());
+        }
+    }
+}
+

src/main/java/dev/lions/unionflow/server/entity/SystemAlert.java

@@ -1,119 +1,119 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import lombok.Getter;
-import lombok.Setter;
-
-import java.time.LocalDateTime;
-
-/**
- * Entité pour les alertes système.
- * Enregistre les alertes de seuils dépassés, erreurs critiques, etc.
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-15
- */
-@Entity
-@Table(name = "system_alerts", indexes = {
-    @Index(name = "idx_system_alert_timestamp", columnList = "timestamp"),
-    @Index(name = "idx_system_alert_level", columnList = "level"),
-    @Index(name = "idx_system_alert_acknowledged", columnList = "acknowledged"),
-    @Index(name = "idx_system_alert_source", columnList = "source")
-})
-@Getter
-@Setter
-public class SystemAlert extends BaseEntity {
-
-    /**
-     * Niveau de l'alerte (CRITICAL, ERROR, WARNING, INFO)
-     */
-    @Column(name = "level", nullable = false, length = 20)
-    private String level;
-
-    /**
-     * Titre court de l'alerte
-     */
-    @Column(name = "title", nullable = false, length = 255)
-    private String title;
-
-    /**
-     * Message détaillé de l'alerte
-     */
-    @Column(name = "message", nullable = false, length = 1000)
-    private String message;
-
-    /**
-     * Date/heure de création de l'alerte
-     */
-    @Column(name = "timestamp", nullable = false)
-    private LocalDateTime timestamp;
-
-    /**
-     * Alerte acquittée ou non
-     */
-    @Column(name = "acknowledged", nullable = false)
-    private Boolean acknowledged = false;
-
-    /**
-     * Email de l'utilisateur ayant acquitté l'alerte
-     */
-    @Column(name = "acknowledged_by", length = 255)
-    private String acknowledgedBy;
-
-    /**
-     * Date/heure d'acquittement
-     */
-    @Column(name = "acknowledged_at")
-    private LocalDateTime acknowledgedAt;
-
-    /**
-     * Source de l'alerte (CPU, MEMORY, DISK, DATABASE, etc.)
-     */
-    @Column(name = "source", length = 100)
-    private String source;
-
-    /**
-     * Type d'alerte (THRESHOLD, INFO, ERROR, etc.)
-     */
-    @Column(name = "alert_type", length = 50)
-    private String alertType;
-
-    /**
-     * Valeur actuelle ayant déclenché l'alerte
-     */
-    @Column(name = "current_value")
-    private Double currentValue;
-
-    /**
-     * Valeur seuil dépassée
-     */
-    @Column(name = "threshold_value")
-    private Double thresholdValue;
-
-    /**
-     * Unité de mesure (%, MB, GB, ms, etc.)
-     */
-    @Column(name = "unit", length = 20)
-    private String unit;
-
-    /**
-     * Actions recommandées pour résoudre l'alerte
-     */
-    @Column(name = "recommended_actions", columnDefinition = "TEXT")
-    private String recommendedActions;
-
-    /**
-     * Initialisation automatique du timestamp
-     */
-    @PrePersist
-    protected void onCreate() {
-        super.onCreate();
-        if (timestamp == null) {
-            timestamp = LocalDateTime.now();
-        }
-        if (acknowledged == null) {
-            acknowledged = false;
-        }
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import lombok.Getter;
+import lombok.Setter;
+
+import java.time.LocalDateTime;
+
+/**
+ * Entité pour les alertes système.
+ * Enregistre les alertes de seuils dépassés, erreurs critiques, etc.
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-15
+ */
+@Entity
+@Table(name = "system_alerts", indexes = {
+    @Index(name = "idx_system_alert_timestamp", columnList = "timestamp"),
+    @Index(name = "idx_system_alert_level", columnList = "level"),
+    @Index(name = "idx_system_alert_acknowledged", columnList = "acknowledged"),
+    @Index(name = "idx_system_alert_source", columnList = "source")
+})
+@Getter
+@Setter
+public class SystemAlert extends BaseEntity {
+
+    /**
+     * Niveau de l'alerte (CRITICAL, ERROR, WARNING, INFO)
+     */
+    @Column(name = "level", nullable = false, length = 20)
+    private String level;
+
+    /**
+     * Titre court de l'alerte
+     */
+    @Column(name = "title", nullable = false, length = 255)
+    private String title;
+
+    /**
+     * Message détaillé de l'alerte
+     */
+    @Column(name = "message", nullable = false, length = 1000)
+    private String message;
+
+    /**
+     * Date/heure de création de l'alerte
+     */
+    @Column(name = "timestamp", nullable = false)
+    private LocalDateTime timestamp;
+
+    /**
+     * Alerte acquittée ou non
+     */
+    @Column(name = "acknowledged", nullable = false)
+    private Boolean acknowledged = false;
+
+    /**
+     * Email de l'utilisateur ayant acquitté l'alerte
+     */
+    @Column(name = "acknowledged_by", length = 255)
+    private String acknowledgedBy;
+
+    /**
+     * Date/heure d'acquittement
+     */
+    @Column(name = "acknowledged_at")
+    private LocalDateTime acknowledgedAt;
+
+    /**
+     * Source de l'alerte (CPU, MEMORY, DISK, DATABASE, etc.)
+     */
+    @Column(name = "source", length = 100)
+    private String source;
+
+    /**
+     * Type d'alerte (THRESHOLD, INFO, ERROR, etc.)
+     */
+    @Column(name = "alert_type", length = 50)
+    private String alertType;
+
+    /**
+     * Valeur actuelle ayant déclenché l'alerte
+     */
+    @Column(name = "current_value")
+    private Double currentValue;
+
+    /**
+     * Valeur seuil dépassée
+     */
+    @Column(name = "threshold_value")
+    private Double thresholdValue;
+
+    /**
+     * Unité de mesure (%, MB, GB, ms, etc.)
+     */
+    @Column(name = "unit", length = 20)
+    private String unit;
+
+    /**
+     * Actions recommandées pour résoudre l'alerte
+     */
+    @Column(name = "recommended_actions", columnDefinition = "TEXT")
+    private String recommendedActions;
+
+    /**
+     * Initialisation automatique du timestamp
+     */
+    @PrePersist
+    protected void onCreate() {
+        super.onCreate();
+        if (timestamp == null) {
+            timestamp = LocalDateTime.now();
+        }
+        if (acknowledged == null) {
+            acknowledged = false;
+        }
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/SystemLog.java

@@ -1,98 +1,98 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import lombok.Getter;
-import lombok.Setter;
-
-import java.time.LocalDateTime;
-
-/**
- * Entité pour les logs techniques du système.
- * Enregistre les erreurs, warnings, et événements système.
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-15
- */
-@Entity
-@Table(name = "system_logs", indexes = {
-    @Index(name = "idx_system_log_timestamp", columnList = "timestamp"),
-    @Index(name = "idx_system_log_level", columnList = "level"),
-    @Index(name = "idx_system_log_source", columnList = "source"),
-    @Index(name = "idx_system_log_user_id", columnList = "user_id")
-})
-@Getter
-@Setter
-public class SystemLog extends BaseEntity {
-
-    /**
-     * Niveau du log (CRITICAL, ERROR, WARNING, INFO, DEBUG)
-     */
-    @Column(name = "level", nullable = false, length = 20)
-    private String level;
-
-    /**
-     * Source du log (Database, API, Auth, System, Cache, etc.)
-     */
-    @Column(name = "source", nullable = false, length = 100)
-    private String source;
-
-    /**
-     * Message principal du log
-     */
-    @Column(name = "message", nullable = false, length = 1000)
-    private String message;
-
-    /**
-     * Détails supplémentaires (stacktrace, contexte, etc.)
-     */
-    @Column(name = "details", columnDefinition = "TEXT")
-    private String details;
-
-    /**
-     * Date/heure du log
-     */
-    @Column(name = "timestamp", nullable = false)
-    private LocalDateTime timestamp;
-
-    /**
-     * Identifiant de l'utilisateur concerné (optionnel)
-     */
-    @Column(name = "user_id", length = 255)
-    private String userId;
-
-    /**
-     * Adresse IP de la requête (optionnel)
-     */
-    @Column(name = "ip_address", length = 45)
-    private String ipAddress;
-
-    /**
-     * Identifiant de session (optionnel)
-     */
-    @Column(name = "session_id", length = 255)
-    private String sessionId;
-
-    /**
-     * Endpoint HTTP concerné (optionnel)
-     */
-    @Column(name = "endpoint", length = 500)
-    private String endpoint;
-
-    /**
-     * Code de statut HTTP (optionnel)
-     */
-    @Column(name = "http_status_code")
-    private Integer httpStatusCode;
-
-    /**
-     * Initialisation automatique du timestamp
-     */
-    @PrePersist
-    protected void onCreate() {
-        super.onCreate(); // Appel du @PrePersist de BaseEntity (dateCreation, actif)
-        if (timestamp == null) {
-            timestamp = LocalDateTime.now();
-        }
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import lombok.Getter;
+import lombok.Setter;
+
+import java.time.LocalDateTime;
+
+/**
+ * Entité pour les logs techniques du système.
+ * Enregistre les erreurs, warnings, et événements système.
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-15
+ */
+@Entity
+@Table(name = "system_logs", indexes = {
+    @Index(name = "idx_system_log_timestamp", columnList = "timestamp"),
+    @Index(name = "idx_system_log_level", columnList = "level"),
+    @Index(name = "idx_system_log_source", columnList = "source"),
+    @Index(name = "idx_system_log_user_id", columnList = "user_id")
+})
+@Getter
+@Setter
+public class SystemLog extends BaseEntity {
+
+    /**
+     * Niveau du log (CRITICAL, ERROR, WARNING, INFO, DEBUG)
+     */
+    @Column(name = "level", nullable = false, length = 20)
+    private String level;
+
+    /**
+     * Source du log (Database, API, Auth, System, Cache, etc.)
+     */
+    @Column(name = "source", nullable = false, length = 100)
+    private String source;
+
+    /**
+     * Message principal du log
+     */
+    @Column(name = "message", nullable = false, length = 1000)
+    private String message;
+
+    /**
+     * Détails supplémentaires (stacktrace, contexte, etc.)
+     */
+    @Column(name = "details", columnDefinition = "TEXT")
+    private String details;
+
+    /**
+     * Date/heure du log
+     */
+    @Column(name = "timestamp", nullable = false)
+    private LocalDateTime timestamp;
+
+    /**
+     * Identifiant de l'utilisateur concerné (optionnel)
+     */
+    @Column(name = "user_id", length = 255)
+    private String userId;
+
+    /**
+     * Adresse IP de la requête (optionnel)
+     */
+    @Column(name = "ip_address", length = 45)
+    private String ipAddress;
+
+    /**
+     * Identifiant de session (optionnel)
+     */
+    @Column(name = "session_id", length = 255)
+    private String sessionId;
+
+    /**
+     * Endpoint HTTP concerné (optionnel)
+     */
+    @Column(name = "endpoint", length = 500)
+    private String endpoint;
+
+    /**
+     * Code de statut HTTP (optionnel)
+     */
+    @Column(name = "http_status_code")
+    private Integer httpStatusCode;
+
+    /**
+     * Initialisation automatique du timestamp
+     */
+    @PrePersist
+    protected void onCreate() {
+        super.onCreate(); // Appel du @PrePersist de BaseEntity (dateCreation, actif)
+        if (timestamp == null) {
+            timestamp = LocalDateTime.now();
+        }
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/TauxChange.java

@@ -0,0 +1,62 @@
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.Index;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import jakarta.validation.constraints.DecimalMin;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Taux de change quotidien entre deux {@link Devise}s.
+ *
+ * <p>Source : BCEAO (officiel UEMOA), ECB, Fixer.io ou import manuel. Conservation
+ * historique pour audit et conversions rétroactives.
+ *
+ * @since 2026-04-25 (P2-NEW-7)
+ */
+@Entity
+@Table(name = "taux_change",
+    uniqueConstraints = @UniqueConstraint(
+        name = "uq_taux_change_paire_date",
+        columnNames = {"devise_source", "devise_cible", "date_validite"}),
+    indexes = {
+        @Index(name = "idx_taux_change_paire", columnList = "devise_source,devise_cible"),
+        @Index(name = "idx_taux_change_date_validite", columnList = "date_validite")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class TauxChange extends BaseEntity {
+
+  @Enumerated(EnumType.STRING)
+  @Column(name = "devise_source", nullable = false, length = 3)
+  private Devise deviseSource;
+
+  @Enumerated(EnumType.STRING)
+  @Column(name = "devise_cible", nullable = false, length = 3)
+  private Devise deviseCible;
+
+  /** 1 unité de {@code deviseSource} = {@code taux} unités de {@code deviseCible}. */
+  @DecimalMin(value = "0.00000001", inclusive = false)
+  @Column(name = "taux", nullable = false, precision = 18, scale = 8)
+  private BigDecimal taux;
+
+  @Column(name = "date_validite", nullable = false)
+  private LocalDate dateValidite;
+
+  @Builder.Default
+  @Column(name = "source", nullable = false, length = 50)
+  private String source = "BCEAO";
+}

src/main/java/dev/lions/unionflow/server/entity/TemplateNotification.java

@@ -1,83 +1,83 @@
-package dev.lions.unionflow.server.entity;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité TemplateNotification pour les templates de notifications réutilisables
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "templates_notifications",
-    indexes = {
-      @Index(name = "idx_template_code", columnList = "code", unique = true),
-      @Index(name = "idx_template_actif", columnList = "actif")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class TemplateNotification extends BaseEntity {
-
-  /** Code unique du template */
-  @NotBlank
-  @Column(name = "code", unique = true, nullable = false, length = 100)
-  private String code;
-
-  /** Sujet du template */
-  @Column(name = "sujet", length = 500)
-  private String sujet;
-
-  /** Corps du template (texte) */
-  @Column(name = "corps_texte", columnDefinition = "TEXT")
-  private String corpsTexte;
-
-  /** Corps du template (HTML) */
-  @Column(name = "corps_html", columnDefinition = "TEXT")
-  private String corpsHtml;
-
-  /** Variables disponibles (JSON) */
-  @Column(name = "variables_disponibles", columnDefinition = "TEXT")
-  private String variablesDisponibles;
-
-  /** Canaux supportés (JSON array) */
-  @Column(name = "canaux_supportes", length = 500)
-  private String canauxSupportes;
-
-  /** Langue du template */
-  @Column(name = "langue", length = 10)
-  private String langue;
-
-  /** Description */
-  @Column(name = "description", length = 1000)
-  private String description;
-
-  /** Notifications utilisant ce template */
-  @JsonIgnore
-  @OneToMany(mappedBy = "template", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<Notification> notifications = new ArrayList<>();
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (langue == null || langue.isEmpty()) {
-      langue = "fr";
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité TemplateNotification pour les templates de notifications réutilisables
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "templates_notifications",
+    indexes = {
+      @Index(name = "idx_template_code", columnList = "code", unique = true),
+      @Index(name = "idx_template_actif", columnList = "actif")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class TemplateNotification extends BaseEntity {
+
+  /** Code unique du template */
+  @NotBlank
+  @Column(name = "code", unique = true, nullable = false, length = 100)
+  private String code;
+
+  /** Sujet du template */
+  @Column(name = "sujet", length = 500)
+  private String sujet;
+
+  /** Corps du template (texte) */
+  @Column(name = "corps_texte", columnDefinition = "TEXT")
+  private String corpsTexte;
+
+  /** Corps du template (HTML) */
+  @Column(name = "corps_html", columnDefinition = "TEXT")
+  private String corpsHtml;
+
+  /** Variables disponibles (JSON) */
+  @Column(name = "variables_disponibles", columnDefinition = "TEXT")
+  private String variablesDisponibles;
+
+  /** Canaux supportés (JSON array) */
+  @Column(name = "canaux_supportes", length = 500)
+  private String canauxSupportes;
+
+  /** Langue du template */
+  @Column(name = "langue", length = 10)
+  private String langue;
+
+  /** Description */
+  @Column(name = "description", length = 1000)
+  private String description;
+
+  /** Notifications utilisant ce template */
+  @JsonIgnore
+  @OneToMany(mappedBy = "template", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<Notification> notifications = new ArrayList<>();
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (langue == null || langue.isEmpty()) {
+      langue = "fr";
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/Ticket.java

@@ -1,92 +1,92 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-import java.time.LocalDateTime;
-import java.util.UUID;
-
-/**
- * Entité Ticket pour la gestion des tickets support
- * 
- * @author UnionFlow Team
- * @version 1.0
- */
-@Entity
-@Table(
-    name = "tickets",
-    indexes = {
-        @Index(name = "idx_ticket_utilisateur", columnList = "utilisateur_id"),
-        @Index(name = "idx_ticket_statut", columnList = "statut"),
-        @Index(name = "idx_ticket_categorie", columnList = "categorie"),
-        @Index(name = "idx_ticket_numero", columnList = "numero_ticket", unique = true)
-    }
-)
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Ticket extends BaseEntity {
-
-    @NotBlank
-    @Column(name = "numero_ticket", nullable = false, unique = true, length = 50)
-    private String numeroTicket;
-
-    @NotNull
-    @Column(name = "utilisateur_id", nullable = false)
-    private UUID utilisateurId;
-
-    @NotBlank
-    @Column(name = "sujet", nullable = false, length = 255)
-    private String sujet;
-
-    @Column(name = "description", columnDefinition = "TEXT")
-    private String description;
-
-    @Column(name = "categorie", length = 50)
-    private String categorie; // TECHNIQUE, FONCTIONNALITE, UTILISATION, COMPTE, AUTRE
-
-    @Column(name = "priorite", length = 50)
-    private String priorite; // BASSE, NORMALE, HAUTE, URGENTE
-
-    @Column(name = "statut", length = 50)
-    @Builder.Default
-    private String statut = "OUVERT"; // OUVERT, EN_COURS, EN_ATTENTE, RESOLU, FERME
-
-    @Column(name = "agent_id")
-    private UUID agentId;
-
-    @Column(name = "agent_nom", length = 255)
-    private String agentNom;
-
-    @Column(name = "date_derniere_reponse")
-    private LocalDateTime dateDerniereReponse;
-
-    @Column(name = "date_resolution")
-    private LocalDateTime dateResolution;
-
-    @Column(name = "date_fermeture")
-    private LocalDateTime dateFermeture;
-
-    @Column(name = "nb_messages")
-    @Builder.Default
-    private Integer nbMessages = 0;
-
-    @Column(name = "nb_fichiers")
-    @Builder.Default
-    private Integer nbFichiers = 0;
-
-    @Column(name = "note_satisfaction")
-    private Integer noteSatisfaction;
-
-    @Column(name = "resolution", columnDefinition = "TEXT")
-    private String resolution;
-}
-
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+/**
+ * Entité Ticket pour la gestion des tickets support
+ * 
+ * @author UnionFlow Team
+ * @version 1.0
+ */
+@Entity
+@Table(
+    name = "tickets",
+    indexes = {
+        @Index(name = "idx_ticket_utilisateur", columnList = "utilisateur_id"),
+        @Index(name = "idx_ticket_statut", columnList = "statut"),
+        @Index(name = "idx_ticket_categorie", columnList = "categorie"),
+        @Index(name = "idx_ticket_numero", columnList = "numero_ticket", unique = true)
+    }
+)
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Ticket extends BaseEntity {
+
+    @NotBlank
+    @Column(name = "numero_ticket", nullable = false, unique = true, length = 50)
+    private String numeroTicket;
+
+    @NotNull
+    @Column(name = "utilisateur_id", nullable = false)
+    private UUID utilisateurId;
+
+    @NotBlank
+    @Column(name = "sujet", nullable = false, length = 255)
+    private String sujet;
+
+    @Column(name = "description", columnDefinition = "TEXT")
+    private String description;
+
+    @Column(name = "categorie", length = 50)
+    private String categorie; // TECHNIQUE, FONCTIONNALITE, UTILISATION, COMPTE, AUTRE
+
+    @Column(name = "priorite", length = 50)
+    private String priorite; // BASSE, NORMALE, HAUTE, URGENTE
+
+    @Column(name = "statut", length = 50)
+    @Builder.Default
+    private String statut = "OUVERT"; // OUVERT, EN_COURS, EN_ATTENTE, RESOLU, FERME
+
+    @Column(name = "agent_id")
+    private UUID agentId;
+
+    @Column(name = "agent_nom", length = 255)
+    private String agentNom;
+
+    @Column(name = "date_derniere_reponse")
+    private LocalDateTime dateDerniereReponse;
+
+    @Column(name = "date_resolution")
+    private LocalDateTime dateResolution;
+
+    @Column(name = "date_fermeture")
+    private LocalDateTime dateFermeture;
+
+    @Column(name = "nb_messages")
+    @Builder.Default
+    private Integer nbMessages = 0;
+
+    @Column(name = "nb_fichiers")
+    @Builder.Default
+    private Integer nbFichiers = 0;
+
+    @Column(name = "note_satisfaction")
+    private Integer noteSatisfaction;
+
+    @Column(name = "resolution", columnDefinition = "TEXT")
+    private String resolution;
+}
+

src/main/java/dev/lions/unionflow/server/entity/TransactionApproval.java

@@ -1,183 +1,183 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.UUID;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité Approbation de Transaction
- *
- * Représente une approbation dans le workflow financier multi-niveaux.
- * Chaque transaction financière au-dessus d'un certain seuil nécessite une ou plusieurs approbations.
- *
- * @author UnionFlow Team
- * @version 1.0
- * @since 2026-03-13
- */
-@Entity
-@Table(name = "transaction_approvals", indexes = {
-    @Index(name = "idx_approval_transaction", columnList = "transaction_id"),
-    @Index(name = "idx_approval_status", columnList = "status"),
-    @Index(name = "idx_approval_requester", columnList = "requester_id"),
-    @Index(name = "idx_approval_organisation", columnList = "organisation_id"),
-    @Index(name = "idx_approval_created", columnList = "created_at"),
-    @Index(name = "idx_approval_level", columnList = "required_level")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class TransactionApproval extends BaseEntity {
-
-    /** ID de la transaction financière à approuver */
-    @NotNull
-    @Column(name = "transaction_id", nullable = false)
-    private UUID transactionId;
-
-    /** Type de transaction (CONTRIBUTION, DEPOSIT, WITHDRAWAL, TRANSFER, SOLIDARITY, EVENT, OTHER) */
-    @NotBlank
-    @Pattern(regexp = "^(CONTRIBUTION|DEPOSIT|WITHDRAWAL|TRANSFER|SOLIDARITY|EVENT|OTHER)$")
-    @Column(name = "transaction_type", nullable = false, length = 20)
-    private String transactionType;
-
-    /** Montant de la transaction */
-    @NotNull
-    @DecimalMin(value = "0.0", message = "Le montant doit être positif")
-    @Digits(integer = 12, fraction = 2)
-    @Column(name = "amount", nullable = false, precision = 14, scale = 2)
-    private BigDecimal amount;
-
-    /** Code devise ISO 3 lettres */
-    @NotBlank
-    @Pattern(regexp = "^[A-Z]{3}$")
-    @Builder.Default
-    @Column(name = "currency", nullable = false, length = 3)
-    private String currency = "XOF";
-
-    /** ID du membre demandeur */
-    @NotNull
-    @Column(name = "requester_id", nullable = false)
-    private UUID requesterId;
-
-    /** Nom complet du demandeur (cache pour performance) */
-    @NotBlank
-    @Column(name = "requester_name", nullable = false, length = 200)
-    private String requesterName;
-
-    /** Organisation concernée (peut être null pour transactions globales) */
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id")
-    private Organisation organisation;
-
-    /** Niveau d'approbation requis (NONE, LEVEL1, LEVEL2, LEVEL3) */
-    @NotBlank
-    @Pattern(regexp = "^(NONE|LEVEL1|LEVEL2|LEVEL3)$")
-    @Column(name = "required_level", nullable = false, length = 10)
-    private String requiredLevel;
-
-    /** Statut de l'approbation (PENDING, APPROVED, VALIDATED, REJECTED, EXPIRED, CANCELLED) */
-    @NotBlank
-    @Pattern(regexp = "^(PENDING|APPROVED|VALIDATED|REJECTED|EXPIRED|CANCELLED)$")
-    @Builder.Default
-    @Column(name = "status", nullable = false, length = 20)
-    private String status = "PENDING";
-
-    /** Liste des actions d'approbateurs */
-    @OneToMany(mappedBy = "approval", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
-    @Builder.Default
-    private List<ApproverAction> approvers = new ArrayList<>();
-
-    /** Raison du rejet (si status = REJECTED) */
-    @Size(max = 1000)
-    @Column(name = "rejection_reason", length = 1000)
-    private String rejectionReason;
-
-    /** Date de création de la demande d'approbation */
-    @NotNull
-    @Column(name = "created_at", nullable = false)
-    private LocalDateTime createdAt;
-
-    /** Date d'expiration (timeout) */
-    @Column(name = "expires_at")
-    private LocalDateTime expiresAt;
-
-    /** Date de completion (approbation finale ou rejet) */
-    @Column(name = "completed_at")
-    private LocalDateTime completedAt;
-
-    /** Métadonnées additionnelles (JSON) */
-    @Column(name = "metadata", columnDefinition = "TEXT")
-    private String metadata;
-
-    @PrePersist
-    protected void onCreate() {
-        super.onCreate();
-        if (createdAt == null) {
-            createdAt = LocalDateTime.now();
-        }
-        if (currency == null) {
-            currency = "XOF";
-        }
-        if (status == null) {
-            status = "PENDING";
-        }
-        // Expiration par défaut: 7 jours
-        if (expiresAt == null) {
-            expiresAt = createdAt.plusDays(7);
-        }
-    }
-
-    /** Méthode métier pour ajouter une action d'approbateur */
-    public void addApproverAction(ApproverAction action) {
-        approvers.add(action);
-        action.setApproval(this);
-    }
-
-    /** Méthode métier pour compter les approbations */
-    public long countApprovals() {
-        return approvers.stream()
-            .filter(a -> "APPROVED".equals(a.getDecision()))
-            .count();
-    }
-
-    /** Méthode métier pour obtenir le nombre d'approbations requises */
-    public int getRequiredApprovals() {
-        return switch (requiredLevel) {
-            case "NONE" -> 0;
-            case "LEVEL1" -> 1;
-            case "LEVEL2" -> 2;
-            case "LEVEL3" -> 3;
-            default -> 0;
-        };
-    }
-
-    /** Méthode métier pour vérifier si toutes les approbations sont reçues */
-    public boolean hasAllApprovals() {
-        return countApprovals() >= getRequiredApprovals();
-    }
-
-    /** Méthode métier pour vérifier si l'approbation est expirée */
-    public boolean isExpired() {
-        return expiresAt != null && LocalDateTime.now().isAfter(expiresAt);
-    }
-
-    /** Méthode métier pour vérifier si l'approbation est en attente */
-    public boolean isPending() {
-        return "PENDING".equals(status);
-    }
-
-    /** Méthode métier pour vérifier si l'approbation est complétée */
-    public boolean isCompleted() {
-        return "VALIDATED".equals(status) || "REJECTED".equals(status) || "CANCELLED".equals(status);
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité Approbation de Transaction
+ *
+ * Représente une approbation dans le workflow financier multi-niveaux.
+ * Chaque transaction financière au-dessus d'un certain seuil nécessite une ou plusieurs approbations.
+ *
+ * @author UnionFlow Team
+ * @version 1.0
+ * @since 2026-03-13
+ */
+@Entity
+@Table(name = "transaction_approvals", indexes = {
+    @Index(name = "idx_approval_transaction", columnList = "transaction_id"),
+    @Index(name = "idx_approval_status", columnList = "status"),
+    @Index(name = "idx_approval_requester", columnList = "requester_id"),
+    @Index(name = "idx_approval_organisation", columnList = "organisation_id"),
+    @Index(name = "idx_approval_created", columnList = "created_at"),
+    @Index(name = "idx_approval_level", columnList = "required_level")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class TransactionApproval extends BaseEntity {
+
+    /** ID de la transaction financière à approuver */
+    @NotNull
+    @Column(name = "transaction_id", nullable = false)
+    private UUID transactionId;
+
+    /** Type de transaction (CONTRIBUTION, DEPOSIT, WITHDRAWAL, TRANSFER, SOLIDARITY, EVENT, OTHER) */
+    @NotBlank
+    @Pattern(regexp = "^(CONTRIBUTION|DEPOSIT|WITHDRAWAL|TRANSFER|SOLIDARITY|EVENT|OTHER)$")
+    @Column(name = "transaction_type", nullable = false, length = 20)
+    private String transactionType;
+
+    /** Montant de la transaction */
+    @NotNull
+    @DecimalMin(value = "0.0", message = "Le montant doit être positif")
+    @Digits(integer = 12, fraction = 2)
+    @Column(name = "amount", nullable = false, precision = 14, scale = 2)
+    private BigDecimal amount;
+
+    /** Code devise ISO 3 lettres */
+    @NotBlank
+    @Pattern(regexp = "^[A-Z]{3}$")
+    @Builder.Default
+    @Column(name = "currency", nullable = false, length = 3)
+    private String currency = "XOF";
+
+    /** ID du membre demandeur */
+    @NotNull
+    @Column(name = "requester_id", nullable = false)
+    private UUID requesterId;
+
+    /** Nom complet du demandeur (cache pour performance) */
+    @NotBlank
+    @Column(name = "requester_name", nullable = false, length = 200)
+    private String requesterName;
+
+    /** Organisation concernée (peut être null pour transactions globales) */
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id")
+    private Organisation organisation;
+
+    /** Niveau d'approbation requis (NONE, LEVEL1, LEVEL2, LEVEL3) */
+    @NotBlank
+    @Pattern(regexp = "^(NONE|LEVEL1|LEVEL2|LEVEL3)$")
+    @Column(name = "required_level", nullable = false, length = 10)
+    private String requiredLevel;
+
+    /** Statut de l'approbation (PENDING, APPROVED, VALIDATED, REJECTED, EXPIRED, CANCELLED) */
+    @NotBlank
+    @Pattern(regexp = "^(PENDING|APPROVED|VALIDATED|REJECTED|EXPIRED|CANCELLED)$")
+    @Builder.Default
+    @Column(name = "status", nullable = false, length = 20)
+    private String status = "PENDING";
+
+    /** Liste des actions d'approbateurs */
+    @OneToMany(mappedBy = "approval", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
+    @Builder.Default
+    private List<ApproverAction> approvers = new ArrayList<>();
+
+    /** Raison du rejet (si status = REJECTED) */
+    @Size(max = 1000)
+    @Column(name = "rejection_reason", length = 1000)
+    private String rejectionReason;
+
+    /** Date de création de la demande d'approbation */
+    @NotNull
+    @Column(name = "created_at", nullable = false)
+    private LocalDateTime createdAt;
+
+    /** Date d'expiration (timeout) */
+    @Column(name = "expires_at")
+    private LocalDateTime expiresAt;
+
+    /** Date de completion (approbation finale ou rejet) */
+    @Column(name = "completed_at")
+    private LocalDateTime completedAt;
+
+    /** Métadonnées additionnelles (JSON) */
+    @Column(name = "metadata", columnDefinition = "TEXT")
+    private String metadata;
+
+    @PrePersist
+    protected void onCreate() {
+        super.onCreate();
+        if (createdAt == null) {
+            createdAt = LocalDateTime.now();
+        }
+        if (currency == null) {
+            currency = "XOF";
+        }
+        if (status == null) {
+            status = "PENDING";
+        }
+        // Expiration par défaut: 7 jours
+        if (expiresAt == null) {
+            expiresAt = createdAt.plusDays(7);
+        }
+    }
+
+    /** Méthode métier pour ajouter une action d'approbateur */
+    public void addApproverAction(ApproverAction action) {
+        approvers.add(action);
+        action.setApproval(this);
+    }
+
+    /** Méthode métier pour compter les approbations */
+    public long countApprovals() {
+        return approvers.stream()
+            .filter(a -> "APPROVED".equals(a.getDecision()))
+            .count();
+    }
+
+    /** Méthode métier pour obtenir le nombre d'approbations requises */
+    public int getRequiredApprovals() {
+        return switch (requiredLevel) {
+            case "NONE" -> 0;
+            case "LEVEL1" -> 1;
+            case "LEVEL2" -> 2;
+            case "LEVEL3" -> 3;
+            default -> 0;
+        };
+    }
+
+    /** Méthode métier pour vérifier si toutes les approbations sont reçues */
+    public boolean hasAllApprovals() {
+        return countApprovals() >= getRequiredApprovals();
+    }
+
+    /** Méthode métier pour vérifier si l'approbation est expirée */
+    public boolean isExpired() {
+        return expiresAt != null && LocalDateTime.now().isAfter(expiresAt);
+    }
+
+    /** Méthode métier pour vérifier si l'approbation est en attente */
+    public boolean isPending() {
+        return "PENDING".equals(status);
+    }
+
+    /** Méthode métier pour vérifier si l'approbation est complétée */
+    public boolean isCompleted() {
+        return "VALIDATED".equals(status) || "REJECTED".equals(status) || "CANCELLED".equals(status);
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/TransactionWave.java

@@ -1,164 +1,164 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.wave.StatutTransactionWave;
-import dev.lions.unionflow.server.api.enums.wave.TypeTransactionWave;
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-import java.util.ArrayList;
-import java.util.List;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité TransactionWave pour le suivi des transactions Wave Mobile Money
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(
-    name = "transactions_wave",
-    indexes = {
-      @Index(name = "idx_transaction_wave_id", columnList = "wave_transaction_id", unique = true),
-      @Index(name = "idx_transaction_wave_request_id", columnList = "wave_request_id"),
-      @Index(name = "idx_transaction_wave_reference", columnList = "wave_reference"),
-      @Index(name = "idx_transaction_wave_statut", columnList = "statut_transaction"),
-      @Index(name = "idx_transaction_wave_compte", columnList = "compte_wave_id")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class TransactionWave extends BaseEntity {
-
-  /** Identifiant Wave de la transaction (unique) */
-  @NotBlank
-  @Column(name = "wave_transaction_id", unique = true, nullable = false, length = 100)
-  private String waveTransactionId;
-
-  /** Identifiant de requête Wave */
-  @Column(name = "wave_request_id", length = 100)
-  private String waveRequestId;
-
-  /** Référence Wave */
-  @Column(name = "wave_reference", length = 100)
-  private String waveReference;
-
-  /** Type de transaction */
-  @NotNull
-  @Enumerated(EnumType.STRING)
-  @Column(name = "type_transaction", nullable = false, length = 50)
-  private TypeTransactionWave typeTransaction;
-
-  /** Statut de la transaction */
-  @NotNull
-  @Enumerated(EnumType.STRING)
-  @Builder.Default
-  @Column(name = "statut_transaction", nullable = false, length = 30)
-  private StatutTransactionWave statutTransaction = StatutTransactionWave.INITIALISE;
-
-  /** Montant de la transaction */
-  @NotNull
-  @DecimalMin(value = "0.0", message = "Le montant doit être positif")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "montant", nullable = false, precision = 14, scale = 2)
-  private BigDecimal montant;
-
-  /** Frais de transaction */
-  @DecimalMin(value = "0.0")
-  @Digits(integer = 10, fraction = 2)
-  @Column(name = "frais", precision = 12, scale = 2)
-  private BigDecimal frais;
-
-  /** Montant net (montant - frais) */
-  @DecimalMin(value = "0.0")
-  @Digits(integer = 12, fraction = 2)
-  @Column(name = "montant_net", precision = 14, scale = 2)
-  private BigDecimal montantNet;
-
-  /** Code devise */
-  @NotBlank
-  @Pattern(regexp = "^[A-Z]{3}$")
-  @Column(name = "code_devise", nullable = false, length = 3)
-  private String codeDevise;
-
-  /** Numéro téléphone payeur */
-  @Column(name = "telephone_payeur", length = 13)
-  private String telephonePayeur;
-
-  /** Numéro téléphone bénéficiaire */
-  @Column(name = "telephone_beneficiaire", length = 13)
-  private String telephoneBeneficiaire;
-
-  /** Métadonnées JSON (réponse complète de Wave API) */
-  @Column(name = "metadonnees", columnDefinition = "TEXT")
-  private String metadonnees;
-
-  /** Réponse complète de Wave API (JSON) */
-  @Column(name = "reponse_wave_api", columnDefinition = "TEXT")
-  private String reponseWaveApi;
-
-  /** Nombre de tentatives */
-  @Builder.Default
-  @Column(name = "nombre_tentatives", nullable = false)
-  private Integer nombreTentatives = 0;
-
-  /** Date de dernière tentative */
-  @Column(name = "date_derniere_tentative")
-  private LocalDateTime dateDerniereTentative;
-
-  /** Message d'erreur (si échec) */
-  @Column(name = "message_erreur", length = 1000)
-  private String messageErreur;
-
-  // Relations
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "compte_wave_id", nullable = false)
-  private CompteWave compteWave;
-
-  @JsonIgnore
-
-  @OneToMany(mappedBy = "transactionWave", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
-  @Builder.Default
-  private List<WebhookWave> webhooks = new ArrayList<>();
-
-  /** Méthode métier pour vérifier si la transaction est réussie */
-  public boolean isReussie() {
-    return StatutTransactionWave.REUSSIE.equals(statutTransaction);
-  }
-
-  /** Méthode métier pour vérifier si la transaction peut être retentée */
-  public boolean peutEtreRetentee() {
-    return (statutTransaction == StatutTransactionWave.ECHOUE
-            || statutTransaction == StatutTransactionWave.EXPIRED)
-        && (nombreTentatives == null || nombreTentatives < 5);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statutTransaction == null) {
-      statutTransaction = StatutTransactionWave.INITIALISE;
-    }
-    if (codeDevise == null || codeDevise.isEmpty()) {
-      codeDevise = "XOF";
-    }
-    if (nombreTentatives == null) {
-      nombreTentatives = 0;
-    }
-    if (montantNet == null && montant != null && frais != null) {
-      montantNet = montant.subtract(frais);
-    }
-  }
-}
-
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.wave.StatutTransactionWave;
+import dev.lions.unionflow.server.api.enums.wave.TypeTransactionWave;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité TransactionWave pour le suivi des transactions Wave Mobile Money
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "transactions_wave",
+    indexes = {
+      @Index(name = "idx_transaction_wave_id", columnList = "wave_transaction_id", unique = true),
+      @Index(name = "idx_transaction_wave_request_id", columnList = "wave_request_id"),
+      @Index(name = "idx_transaction_wave_reference", columnList = "wave_reference"),
+      @Index(name = "idx_transaction_wave_statut", columnList = "statut_transaction"),
+      @Index(name = "idx_transaction_wave_compte", columnList = "compte_wave_id")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class TransactionWave extends BaseEntity {
+
+  /** Identifiant Wave de la transaction (unique) */
+  @NotBlank
+  @Column(name = "wave_transaction_id", unique = true, nullable = false, length = 100)
+  private String waveTransactionId;
+
+  /** Identifiant de requête Wave */
+  @Column(name = "wave_request_id", length = 100)
+  private String waveRequestId;
+
+  /** Référence Wave */
+  @Column(name = "wave_reference", length = 100)
+  private String waveReference;
+
+  /** Type de transaction */
+  @NotNull
+  @Enumerated(EnumType.STRING)
+  @Column(name = "type_transaction", nullable = false, length = 50)
+  private TypeTransactionWave typeTransaction;
+
+  /** Statut de la transaction */
+  @NotNull
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "statut_transaction", nullable = false, length = 30)
+  private StatutTransactionWave statutTransaction = StatutTransactionWave.INITIALISE;
+
+  /** Montant de la transaction */
+  @NotNull
+  @DecimalMin(value = "0.0", message = "Le montant doit être positif")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "montant", nullable = false, precision = 14, scale = 2)
+  private BigDecimal montant;
+
+  /** Frais de transaction */
+  @DecimalMin(value = "0.0")
+  @Digits(integer = 10, fraction = 2)
+  @Column(name = "frais", precision = 12, scale = 2)
+  private BigDecimal frais;
+
+  /** Montant net (montant - frais) */
+  @DecimalMin(value = "0.0")
+  @Digits(integer = 12, fraction = 2)
+  @Column(name = "montant_net", precision = 14, scale = 2)
+  private BigDecimal montantNet;
+
+  /** Code devise */
+  @NotBlank
+  @Pattern(regexp = "^[A-Z]{3}$")
+  @Column(name = "code_devise", nullable = false, length = 3)
+  private String codeDevise;
+
+  /** Numéro téléphone payeur */
+  @Column(name = "telephone_payeur", length = 13)
+  private String telephonePayeur;
+
+  /** Numéro téléphone bénéficiaire */
+  @Column(name = "telephone_beneficiaire", length = 13)
+  private String telephoneBeneficiaire;
+
+  /** Métadonnées JSON (réponse complète de Wave API) */
+  @Column(name = "metadonnees", columnDefinition = "TEXT")
+  private String metadonnees;
+
+  /** Réponse complète de Wave API (JSON) */
+  @Column(name = "reponse_wave_api", columnDefinition = "TEXT")
+  private String reponseWaveApi;
+
+  /** Nombre de tentatives */
+  @Builder.Default
+  @Column(name = "nombre_tentatives", nullable = false)
+  private Integer nombreTentatives = 0;
+
+  /** Date de dernière tentative */
+  @Column(name = "date_derniere_tentative")
+  private LocalDateTime dateDerniereTentative;
+
+  /** Message d'erreur (si échec) */
+  @Column(name = "message_erreur", length = 1000)
+  private String messageErreur;
+
+  // Relations
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "compte_wave_id", nullable = false)
+  private CompteWave compteWave;
+
+  @JsonIgnore
+
+  @OneToMany(mappedBy = "transactionWave", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<WebhookWave> webhooks = new ArrayList<>();
+
+  /** Méthode métier pour vérifier si la transaction est réussie */
+  public boolean isReussie() {
+    return StatutTransactionWave.REUSSIE.equals(statutTransaction);
+  }
+
+  /** Méthode métier pour vérifier si la transaction peut être retentée */
+  public boolean peutEtreRetentee() {
+    return (statutTransaction == StatutTransactionWave.ECHOUE
+            || statutTransaction == StatutTransactionWave.EXPIRED)
+        && (nombreTentatives == null || nombreTentatives < 5);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statutTransaction == null) {
+      statutTransaction = StatutTransactionWave.INITIALISE;
+    }
+    if (codeDevise == null || codeDevise.isEmpty()) {
+      codeDevise = "XOF";
+    }
+    if (nombreTentatives == null) {
+      nombreTentatives = 0;
+    }
+    if (montantNet == null && montant != null && frais != null) {
+      montantNet = montant.subtract(frais);
+    }
+  }
+}
+

src/main/java/dev/lions/unionflow/server/entity/TypeReference.java

@@ -1,206 +1,206 @@
-package dev.lions.unionflow.server.entity;
-
-import jakarta.persistence.Column;
-import jakarta.persistence.Entity;
-import jakarta.persistence.FetchType;
-import jakarta.persistence.Index;
-import jakarta.persistence.JoinColumn;
-import jakarta.persistence.ManyToOne;
-import jakarta.persistence.PrePersist;
-import jakarta.persistence.Table;
-import jakarta.persistence.UniqueConstraint;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.Size;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Donnée de référence paramétrable via le client.
- *
- * <p>
- * Remplace toutes les enums Java et valeurs hardcodées
- * par une table unique CRUD-able depuis l'interface
- * d'administration. Chaque ligne appartient à un
- * {@code domaine} (ex: STATUT_ORGANISATION, DEVISE)
- * et porte un {@code code} unique dans ce domaine.
- *
- * <p>
- * Le champ {@code organisation} permet une
- * personnalisation par organisation. Lorsqu'il est
- * {@code null}, la valeur est globale à la plateforme.
- *
- * <p>
- * Table : {@code types_reference}
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2026-02-21
- */
-@Entity
-@Table(name = "types_reference", indexes = {
-        @Index(name = "idx_typeref_domaine", columnList = "domaine"),
-        @Index(name = "idx_typeref_domaine_actif", columnList = "domaine, actif, ordre_affichage"),
-        @Index(name = "idx_typeref_org", columnList = "organisation_id")
-}, uniqueConstraints = {
-        @UniqueConstraint(name = "uk_typeref_domaine_code_org", columnNames = {
-                "domaine", "code", "organisation_id"
-        })
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class TypeReference extends BaseEntity {
-
-    /**
-     * Domaine fonctionnel de cette valeur de référence.
-     *
-     * <p>
-     * Exemples : {@code STATUT_ORGANISATION},
-     * {@code TYPE_ORGANISATION}, {@code DEVISE}.
-     */
-    @NotBlank
-    @Size(max = 50)
-    @Column(name = "domaine", nullable = false, length = 50)
-    private String domaine;
-
-    /**
-     * Code technique unique au sein du domaine.
-     *
-     * <p>
-     * Exemples : {@code ACTIVE}, {@code XOF},
-     * {@code ASSOCIATION}.
-     */
-    @NotBlank
-    @Size(max = 50)
-    @Column(name = "code", nullable = false, length = 50)
-    private String code;
-
-    /**
-     * Libellé affiché dans l'interface utilisateur.
-     *
-     * <p>
-     * Exemple : {@code "Franc CFA (UEMOA)"}.
-     */
-    @NotBlank
-    @Size(max = 200)
-    @Column(name = "libelle", nullable = false, length = 200)
-    private String libelle;
-
-    /** Description longue optionnelle. */
-    @Size(max = 1000)
-    @Column(name = "description", length = 1000)
-    private String description;
-
-    /**
-     * Classe d'icône pour le rendu UI.
-     *
-     * <p>
-     * Exemple : {@code "pi-check-circle"}.
-     */
-    @Size(max = 100)
-    @Column(name = "icone", length = 100)
-    private String icone;
-
-    /**
-     * Code couleur hexadécimal pour le rendu UI.
-     *
-     * <p>
-     * Exemple : {@code "#22C55E"}.
-     */
-    @Size(max = 50)
-    @Column(name = "couleur", length = 50)
-    private String couleur;
-
-    /**
-     * Niveau de sévérité pour les badges PrimeFaces.
-     *
-     * <p>
-     * Valeurs typiques : {@code success},
-     * {@code warning}, {@code danger}, {@code info}.
-     */
-    @Size(max = 20)
-    @Column(name = "severity", length = 20)
-    private String severity;
-
-    /**
-     * Ordre d'affichage dans les listes déroulantes.
-     *
-     * <p>
-     * Les valeurs avec un ordre inférieur
-     * apparaissent en premier.
-     */
-    @Builder.Default
-    @Column(name = "ordre_affichage", nullable = false)
-    private Integer ordreAffichage = 0;
-
-    /**
-     * Indique si cette valeur est la valeur par défaut
-     * pour son domaine. Une seule valeur par défaut
-     * est autorisée par domaine et organisation.
-     */
-    @Builder.Default
-    @Column(name = "est_defaut", nullable = false)
-    private Boolean estDefaut = false;
-
-    /**
-     * Indique si cette valeur est protégée par le
-     * système. Les valeurs système ne peuvent être
-     * ni supprimées ni désactivées par un
-     * administrateur.
-     */
-    @Builder.Default
-    @Column(name = "est_systeme", nullable = false)
-    private Boolean estSysteme = false;
-
-    /**
-     * Catégorie fonctionnelle (ex: ASSOCIATIF, FINANCIER_SOLIDAIRE, RELIGIEUX…).
-     * Utilisée pour les types d'organisation (domaine TYPE_ORGANISATION).
-     */
-    @Size(max = 50)
-    @Column(name = "categorie", length = 50)
-    private String categorie;
-
-    /**
-     * Liste CSV des modules activés pour ce type d'organisation.
-     * Exemple : "MEMBRES,COTISATIONS,TONTINE,FINANCE"
-     * Utilisée pour initialiser {@code Organisation.modulesActifs} à la création.
-     */
-    @Column(name = "modules_requis", columnDefinition = "TEXT")
-    private String modulesRequis;
-
-    /**
-     * Organisation propriétaire de cette valeur.
-     *
-     * <p>
-     * Lorsque {@code null}, la valeur est globale
-     * à la plateforme et visible par toutes les
-     * organisations.
-     */
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id")
-    private Organisation organisation;
-
-    /**
-     * Callback JPA exécuté avant la persistance.
-     *
-     * <p>
-     * Normalise le code et le domaine en
-     * majuscules pour garantir la cohérence.
-     */
-    @Override
-    @PrePersist
-    protected void onCreate() {
-        super.onCreate();
-        if (domaine != null) {
-            domaine = domaine.toUpperCase();
-        }
-        if (code != null) {
-            code = code.toUpperCase();
-        }
-    }
-}
+package dev.lions.unionflow.server.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.Index;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.PrePersist;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Donnée de référence paramétrable via le client.
+ *
+ * <p>
+ * Remplace toutes les enums Java et valeurs hardcodées
+ * par une table unique CRUD-able depuis l'interface
+ * d'administration. Chaque ligne appartient à un
+ * {@code domaine} (ex: STATUT_ORGANISATION, DEVISE)
+ * et porte un {@code code} unique dans ce domaine.
+ *
+ * <p>
+ * Le champ {@code organisation} permet une
+ * personnalisation par organisation. Lorsqu'il est
+ * {@code null}, la valeur est globale à la plateforme.
+ *
+ * <p>
+ * Table : {@code types_reference}
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2026-02-21
+ */
+@Entity
+@Table(name = "types_reference", indexes = {
+        @Index(name = "idx_typeref_domaine", columnList = "domaine"),
+        @Index(name = "idx_typeref_domaine_actif", columnList = "domaine, actif, ordre_affichage"),
+        @Index(name = "idx_typeref_org", columnList = "organisation_id")
+}, uniqueConstraints = {
+        @UniqueConstraint(name = "uk_typeref_domaine_code_org", columnNames = {
+                "domaine", "code", "organisation_id"
+        })
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class TypeReference extends BaseEntity {
+
+    /**
+     * Domaine fonctionnel de cette valeur de référence.
+     *
+     * <p>
+     * Exemples : {@code STATUT_ORGANISATION},
+     * {@code TYPE_ORGANISATION}, {@code DEVISE}.
+     */
+    @NotBlank
+    @Size(max = 50)
+    @Column(name = "domaine", nullable = false, length = 50)
+    private String domaine;
+
+    /**
+     * Code technique unique au sein du domaine.
+     *
+     * <p>
+     * Exemples : {@code ACTIVE}, {@code XOF},
+     * {@code ASSOCIATION}.
+     */
+    @NotBlank
+    @Size(max = 50)
+    @Column(name = "code", nullable = false, length = 50)
+    private String code;
+
+    /**
+     * Libellé affiché dans l'interface utilisateur.
+     *
+     * <p>
+     * Exemple : {@code "Franc CFA (UEMOA)"}.
+     */
+    @NotBlank
+    @Size(max = 200)
+    @Column(name = "libelle", nullable = false, length = 200)
+    private String libelle;
+
+    /** Description longue optionnelle. */
+    @Size(max = 1000)
+    @Column(name = "description", length = 1000)
+    private String description;
+
+    /**
+     * Classe d'icône pour le rendu UI.
+     *
+     * <p>
+     * Exemple : {@code "pi-check-circle"}.
+     */
+    @Size(max = 100)
+    @Column(name = "icone", length = 100)
+    private String icone;
+
+    /**
+     * Code couleur hexadécimal pour le rendu UI.
+     *
+     * <p>
+     * Exemple : {@code "#22C55E"}.
+     */
+    @Size(max = 50)
+    @Column(name = "couleur", length = 50)
+    private String couleur;
+
+    /**
+     * Niveau de sévérité pour les badges PrimeFaces.
+     *
+     * <p>
+     * Valeurs typiques : {@code success},
+     * {@code warning}, {@code danger}, {@code info}.
+     */
+    @Size(max = 20)
+    @Column(name = "severity", length = 20)
+    private String severity;
+
+    /**
+     * Ordre d'affichage dans les listes déroulantes.
+     *
+     * <p>
+     * Les valeurs avec un ordre inférieur
+     * apparaissent en premier.
+     */
+    @Builder.Default
+    @Column(name = "ordre_affichage", nullable = false)
+    private Integer ordreAffichage = 0;
+
+    /**
+     * Indique si cette valeur est la valeur par défaut
+     * pour son domaine. Une seule valeur par défaut
+     * est autorisée par domaine et organisation.
+     */
+    @Builder.Default
+    @Column(name = "est_defaut", nullable = false)
+    private Boolean estDefaut = false;
+
+    /**
+     * Indique si cette valeur est protégée par le
+     * système. Les valeurs système ne peuvent être
+     * ni supprimées ni désactivées par un
+     * administrateur.
+     */
+    @Builder.Default
+    @Column(name = "est_systeme", nullable = false)
+    private Boolean estSysteme = false;
+
+    /**
+     * Catégorie fonctionnelle (ex: ASSOCIATIF, FINANCIER_SOLIDAIRE, RELIGIEUX…).
+     * Utilisée pour les types d'organisation (domaine TYPE_ORGANISATION).
+     */
+    @Size(max = 50)
+    @Column(name = "categorie", length = 50)
+    private String categorie;
+
+    /**
+     * Liste CSV des modules activés pour ce type d'organisation.
+     * Exemple : "MEMBRES,COTISATIONS,TONTINE,FINANCE"
+     * Utilisée pour initialiser {@code Organisation.modulesActifs} à la création.
+     */
+    @Column(name = "modules_requis", columnDefinition = "TEXT")
+    private String modulesRequis;
+
+    /**
+     * Organisation propriétaire de cette valeur.
+     *
+     * <p>
+     * Lorsque {@code null}, la valeur est globale
+     * à la plateforme et visible par toutes les
+     * organisations.
+     */
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id")
+    private Organisation organisation;
+
+    /**
+     * Callback JPA exécuté avant la persistance.
+     *
+     * <p>
+     * Normalise le code et le domaine en
+     * majuscules pour garantir la cohérence.
+     */
+    @Override
+    @PrePersist
+    protected void onCreate() {
+        super.onCreate();
+        if (domaine != null) {
+            domaine = domaine.toUpperCase();
+        }
+        if (code != null) {
+            code = code.toUpperCase();
+        }
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/ValidationEtapeDemande.java

@@ -1,91 +1,91 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.solidarite.StatutValidationEtape;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import java.time.LocalDateTime;
-import lombok.*;
-
-/**
- * Historique des validations pour une demande d'aide.
- *
- * <p>Chaque ligne représente l'état d'une étape du workflow pour une demande.
- * La délégation de véto (valideur absent) est tracée avec motif — conformité BCEAO/OHADA.
- *
- * <p>Table : {@code validation_etapes_demande}
- */
-@Entity
-@Table(
-    name = "validation_etapes_demande",
-    indexes = {
-      @Index(name = "idx_ved_demande",  columnList = "demande_aide_id"),
-      @Index(name = "idx_ved_valideur", columnList = "valideur_id"),
-      @Index(name = "idx_ved_statut",   columnList = "statut")
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ValidationEtapeDemande extends BaseEntity {
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "demande_aide_id", nullable = false)
-  private DemandeAide demandeAide;
-
-  @NotNull
-  @Min(1) @Max(3)
-  @Column(name = "etape_numero", nullable = false)
-  private Integer etapeNumero;
-
-  /** Valideur assigné à cette étape */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "valideur_id")
-  private Membre valideur;
-
-  @Enumerated(EnumType.STRING)
-  @Builder.Default
-  @Column(name = "statut", nullable = false, length = 20)
-  private StatutValidationEtape statut = StatutValidationEtape.EN_ATTENTE;
-
-  @Column(name = "date_validation")
-  private LocalDateTime dateValidation;
-
-  @Column(name = "commentaire", length = 1000)
-  private String commentaire;
-
-  /**
-   * Valideur supérieur qui a désactivé le véto de {@code valideur}.
-   * Renseigné uniquement en cas de délégation.
-   */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "delegue_par_id")
-  private Membre deleguePar;
-
-  /**
-   * Motif et trace de la délégation — obligatoire si {@code deleguePar} est renseigné.
-   * Conservé 10 ans — exigence BCEAO/OHADA/Fiscalité ivoirienne.
-   */
-  @Column(name = "trace_delegation", columnDefinition = "TEXT")
-  private String traceDelegation;
-
-  // ── Méthodes métier ────────────────────────────────────────────────────────
-
-  public boolean estEnAttente() {
-    return StatutValidationEtape.EN_ATTENTE.equals(statut);
-  }
-
-  public boolean estFinalisee() {
-    return StatutValidationEtape.APPROUVEE.equals(statut)
-        || StatutValidationEtape.REJETEE.equals(statut)
-        || StatutValidationEtape.DELEGUEE.equals(statut)
-        || StatutValidationEtape.EXPIREE.equals(statut);
-  }
-
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statut == null) statut = StatutValidationEtape.EN_ATTENTE;
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.solidarite.StatutValidationEtape;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import java.time.LocalDateTime;
+import lombok.*;
+
+/**
+ * Historique des validations pour une demande d'aide.
+ *
+ * <p>Chaque ligne représente l'état d'une étape du workflow pour une demande.
+ * La délégation de véto (valideur absent) est tracée avec motif — conformité BCEAO/OHADA.
+ *
+ * <p>Table : {@code validation_etapes_demande}
+ */
+@Entity
+@Table(
+    name = "validation_etapes_demande",
+    indexes = {
+      @Index(name = "idx_ved_demande",  columnList = "demande_aide_id"),
+      @Index(name = "idx_ved_valideur", columnList = "valideur_id"),
+      @Index(name = "idx_ved_statut",   columnList = "statut")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ValidationEtapeDemande extends BaseEntity {
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "demande_aide_id", nullable = false)
+  private DemandeAide demandeAide;
+
+  @NotNull
+  @Min(1) @Max(3)
+  @Column(name = "etape_numero", nullable = false)
+  private Integer etapeNumero;
+
+  /** Valideur assigné à cette étape */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "valideur_id")
+  private Membre valideur;
+
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "statut", nullable = false, length = 20)
+  private StatutValidationEtape statut = StatutValidationEtape.EN_ATTENTE;
+
+  @Column(name = "date_validation")
+  private LocalDateTime dateValidation;
+
+  @Column(name = "commentaire", length = 1000)
+  private String commentaire;
+
+  /**
+   * Valideur supérieur qui a désactivé le véto de {@code valideur}.
+   * Renseigné uniquement en cas de délégation.
+   */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "delegue_par_id")
+  private Membre deleguePar;
+
+  /**
+   * Motif et trace de la délégation — obligatoire si {@code deleguePar} est renseigné.
+   * Conservé 10 ans — exigence BCEAO/OHADA/Fiscalité ivoirienne.
+   */
+  @Column(name = "trace_delegation", columnDefinition = "TEXT")
+  private String traceDelegation;
+
+  // ── Méthodes métier ────────────────────────────────────────────────────────
+
+  public boolean estEnAttente() {
+    return StatutValidationEtape.EN_ATTENTE.equals(statut);
+  }
+
+  public boolean estFinalisee() {
+    return StatutValidationEtape.APPROUVEE.equals(statut)
+        || StatutValidationEtape.REJETEE.equals(statut)
+        || StatutValidationEtape.DELEGUEE.equals(statut)
+        || StatutValidationEtape.EXPIREE.equals(statut);
+  }
+
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statut == null) statut = StatutValidationEtape.EN_ATTENTE;
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/WebhookWave.java

@@ -1,114 +1,114 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.wave.StatutWebhook;
-import dev.lions.unionflow.server.api.enums.wave.TypeEvenementWebhook;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import java.time.LocalDateTime;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * Entité WebhookWave pour le traitement des événements Wave
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2025-01-29
- */
-@Entity
-@Table(name = "webhooks_wave", indexes = {
-    @Index(name = "idx_webhook_wave_event_id", columnList = "wave_event_id", unique = true),
-    @Index(name = "idx_webhook_wave_statut", columnList = "statut_traitement"),
-    @Index(name = "idx_webhook_wave_type", columnList = "type_evenement"),
-    @Index(name = "idx_webhook_wave_transaction", columnList = "transaction_wave_id"),
-    @Index(name = "idx_webhook_wave_paiement", columnList = "paiement_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class WebhookWave extends BaseEntity {
-
-  /** Identifiant unique de l'événement Wave */
-  @NotBlank
-  @Column(name = "wave_event_id", unique = true, nullable = false, length = 100)
-  private String waveEventId;
-
-  /** Type d'événement */
-  @Column(name = "type_evenement", length = 50)
-  private String typeEvenement;
-
-  /** Statut de traitement */
-  @Builder.Default
-  @Column(name = "statut_traitement", nullable = false, length = 30)
-  private String statutTraitement = StatutWebhook.EN_ATTENTE.name();
-
-  /** Payload JSON reçu */
-  @Column(name = "payload", columnDefinition = "TEXT")
-  private String payload;
-
-  /** Signature de validation */
-  @Column(name = "signature", length = 500)
-  private String signature;
-
-  /** Date de réception */
-  @Column(name = "date_reception")
-  private LocalDateTime dateReception;
-
-  /** Date de traitement */
-  @Column(name = "date_traitement")
-  private LocalDateTime dateTraitement;
-
-  /** Nombre de tentatives de traitement */
-  @Builder.Default
-  @Column(name = "nombre_tentatives", nullable = false)
-  private Integer nombreTentatives = 0;
-
-  /** Message d'erreur (si échec) */
-  @Column(name = "message_erreur", length = 1000)
-  private String messageErreur;
-
-  /** Commentaires */
-  @Column(name = "commentaire", length = 500)
-  private String commentaire;
-
-  // Relations
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "transaction_wave_id")
-  private TransactionWave transactionWave;
-
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "paiement_id")
-  private Versement versement;
-
-  /** Méthode métier pour vérifier si le webhook est traité */
-  public boolean isTraite() {
-    return StatutWebhook.TRAITE.name().equals(statutTraitement);
-  }
-
-  /** Méthode métier pour vérifier si le webhook peut être retenté */
-  public boolean peutEtreRetente() {
-    return (StatutWebhook.ECHOUE.name().equals(statutTraitement)
-        || StatutWebhook.EN_ATTENTE.name().equals(statutTraitement))
-        && (nombreTentatives == null || nombreTentatives < 5);
-  }
-
-  /** Callback JPA avant la persistance */
-  @PrePersist
-  protected void onCreate() {
-    super.onCreate();
-    if (statutTraitement == null) {
-      statutTraitement = StatutWebhook.EN_ATTENTE.name();
-    }
-    if (dateReception == null) {
-      dateReception = LocalDateTime.now();
-    }
-    if (nombreTentatives == null) {
-      nombreTentatives = 0;
-    }
-  }
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.wave.StatutWebhook;
+import dev.lions.unionflow.server.api.enums.wave.TypeEvenementWebhook;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import java.time.LocalDateTime;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Entité WebhookWave pour le traitement des événements Wave
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(name = "webhooks_wave", indexes = {
+    @Index(name = "idx_webhook_wave_event_id", columnList = "wave_event_id", unique = true),
+    @Index(name = "idx_webhook_wave_statut", columnList = "statut_traitement"),
+    @Index(name = "idx_webhook_wave_type", columnList = "type_evenement"),
+    @Index(name = "idx_webhook_wave_transaction", columnList = "transaction_wave_id"),
+    @Index(name = "idx_webhook_wave_paiement", columnList = "paiement_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class WebhookWave extends BaseEntity {
+
+  /** Identifiant unique de l'événement Wave */
+  @NotBlank
+  @Column(name = "wave_event_id", unique = true, nullable = false, length = 100)
+  private String waveEventId;
+
+  /** Type d'événement */
+  @Column(name = "type_evenement", length = 50)
+  private String typeEvenement;
+
+  /** Statut de traitement */
+  @Builder.Default
+  @Column(name = "statut_traitement", nullable = false, length = 30)
+  private String statutTraitement = StatutWebhook.EN_ATTENTE.name();
+
+  /** Payload JSON reçu */
+  @Column(name = "payload", columnDefinition = "TEXT")
+  private String payload;
+
+  /** Signature de validation */
+  @Column(name = "signature", length = 500)
+  private String signature;
+
+  /** Date de réception */
+  @Column(name = "date_reception")
+  private LocalDateTime dateReception;
+
+  /** Date de traitement */
+  @Column(name = "date_traitement")
+  private LocalDateTime dateTraitement;
+
+  /** Nombre de tentatives de traitement */
+  @Builder.Default
+  @Column(name = "nombre_tentatives", nullable = false)
+  private Integer nombreTentatives = 0;
+
+  /** Message d'erreur (si échec) */
+  @Column(name = "message_erreur", length = 1000)
+  private String messageErreur;
+
+  /** Commentaires */
+  @Column(name = "commentaire", length = 500)
+  private String commentaire;
+
+  // Relations
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "transaction_wave_id")
+  private TransactionWave transactionWave;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "paiement_id")
+  private Versement versement;
+
+  /** Méthode métier pour vérifier si le webhook est traité */
+  public boolean isTraite() {
+    return StatutWebhook.TRAITE.name().equals(statutTraitement);
+  }
+
+  /** Méthode métier pour vérifier si le webhook peut être retenté */
+  public boolean peutEtreRetente() {
+    return (StatutWebhook.ECHOUE.name().equals(statutTraitement)
+        || StatutWebhook.EN_ATTENTE.name().equals(statutTraitement))
+        && (nombreTentatives == null || nombreTentatives < 5);
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (statutTraitement == null) {
+      statutTraitement = StatutWebhook.EN_ATTENTE.name();
+    }
+    if (dateReception == null) {
+      dateReception = LocalDateTime.now();
+    }
+    if (nombreTentatives == null) {
+      nombreTentatives = 0;
+    }
+  }
+}

src/main/java/dev/lions/unionflow/server/entity/WorkflowValidationConfig.java

@@ -1,66 +1,66 @@
-package dev.lions.unionflow.server.entity;
-
-import dev.lions.unionflow.server.api.enums.solidarite.TypeWorkflow;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.*;
-import lombok.*;
-
-/**
- * Configuration du workflow de validation pour une organisation.
- *
- * <p>Maximum 3 étapes ordonnées. Chaque étape requiert un rôle spécifique.
- * Exemple Mutuelle Y : Secrétaire (étape 1) → Trésorier (étape 2) → Président (étape 3).
- *
- * <p>Table : {@code workflow_validation_config}
- */
-@Entity
-@Table(
-    name = "workflow_validation_config",
-    indexes = {
-      @Index(name = "idx_wf_organisation", columnList = "organisation_id"),
-      @Index(name = "idx_wf_type",         columnList = "type_workflow")
-    },
-    uniqueConstraints = {
-      @UniqueConstraint(
-          name = "uk_wf_org_type_etape",
-          columnNames = {"organisation_id", "type_workflow", "etape_numero"})
-    })
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class WorkflowValidationConfig extends BaseEntity {
-
-  @NotNull
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "organisation_id", nullable = false)
-  private Organisation organisation;
-
-  @Enumerated(EnumType.STRING)
-  @NotNull
-  @Builder.Default
-  @Column(name = "type_workflow", nullable = false, length = 30)
-  private TypeWorkflow typeWorkflow = TypeWorkflow.DEMANDE_AIDE;
-
-  /** Numéro d'ordre de l'étape (1, 2 ou 3) */
-  @NotNull
-  @Min(1) @Max(3)
-  @Column(name = "etape_numero", nullable = false)
-  private Integer etapeNumero;
-
-  /** Rôle nécessaire pour valider cette étape */
-  @ManyToOne(fetch = FetchType.LAZY)
-  @JoinColumn(name = "role_requis_id")
-  private Role roleRequis;
-
-  @NotBlank
-  @Column(name = "libelle_etape", nullable = false, length = 200)
-  private String libelleEtape;
-
-  /** Délai maximum en heures avant expiration automatique (SLA) */
-  @Builder.Default
-  @Min(1)
-  @Column(name = "delai_max_heures", nullable = false)
-  private Integer delaiMaxHeures = 72;
-}
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.solidarite.TypeWorkflow;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import lombok.*;
+
+/**
+ * Configuration du workflow de validation pour une organisation.
+ *
+ * <p>Maximum 3 étapes ordonnées. Chaque étape requiert un rôle spécifique.
+ * Exemple Mutuelle Y : Secrétaire (étape 1) → Trésorier (étape 2) → Président (étape 3).
+ *
+ * <p>Table : {@code workflow_validation_config}
+ */
+@Entity
+@Table(
+    name = "workflow_validation_config",
+    indexes = {
+      @Index(name = "idx_wf_organisation", columnList = "organisation_id"),
+      @Index(name = "idx_wf_type",         columnList = "type_workflow")
+    },
+    uniqueConstraints = {
+      @UniqueConstraint(
+          name = "uk_wf_org_type_etape",
+          columnNames = {"organisation_id", "type_workflow", "etape_numero"})
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class WorkflowValidationConfig extends BaseEntity {
+
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "organisation_id", nullable = false)
+  private Organisation organisation;
+
+  @Enumerated(EnumType.STRING)
+  @NotNull
+  @Builder.Default
+  @Column(name = "type_workflow", nullable = false, length = 30)
+  private TypeWorkflow typeWorkflow = TypeWorkflow.DEMANDE_AIDE;
+
+  /** Numéro d'ordre de l'étape (1, 2 ou 3) */
+  @NotNull
+  @Min(1) @Max(3)
+  @Column(name = "etape_numero", nullable = false)
+  private Integer etapeNumero;
+
+  /** Rôle nécessaire pour valider cette étape */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "role_requis_id")
+  private Role roleRequis;
+
+  @NotBlank
+  @Column(name = "libelle_etape", nullable = false, length = 200)
+  private String libelleEtape;
+
+  /** Délai maximum en heures avant expiration automatique (SLA) */
+  @Builder.Default
+  @Min(1)
+  @Column(name = "delai_max_heures", nullable = false)
+  private Integer delaiMaxHeures = 72;
+}

src/main/java/dev/lions/unionflow/server/entity/agricole/CampagneAgricole.java

@@ -1,50 +1,50 @@
-package dev.lions.unionflow.server.entity.agricole;
-
-import dev.lions.unionflow.server.api.enums.agricole.StatutCampagneAgricole;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Organisation;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-
-@Entity
-@Table(name = "campagnes_agricoles", indexes = {
-        @Index(name = "idx_agricole_organisation", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class CampagneAgricole extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    @NotBlank
-    @Column(name = "designation", nullable = false, length = 200)
-    private String designation;
-
-    @Column(name = "type_culture", length = 100)
-    private String typeCulturePrincipale;
-
-    @Column(name = "surface_estimee_ha", precision = 19, scale = 4)
-    private BigDecimal surfaceTotaleEstimeeHectares;
-
-    @Column(name = "volume_prev_tonnes", precision = 19, scale = 4)
-    private BigDecimal volumePrevisionnelTonnes;
-
-    @Column(name = "volume_reel_tonnes", precision = 19, scale = 4)
-    private BigDecimal volumeReelTonnes;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 50)
-    @Builder.Default
-    private StatutCampagneAgricole statut = StatutCampagneAgricole.PREPARATION;
-}
+package dev.lions.unionflow.server.entity.agricole;
+
+import dev.lions.unionflow.server.api.enums.agricole.StatutCampagneAgricole;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Organisation;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+
+@Entity
+@Table(name = "campagnes_agricoles", indexes = {
+        @Index(name = "idx_agricole_organisation", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class CampagneAgricole extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @NotBlank
+    @Column(name = "designation", nullable = false, length = 200)
+    private String designation;
+
+    @Column(name = "type_culture", length = 100)
+    private String typeCulturePrincipale;
+
+    @Column(name = "surface_estimee_ha", precision = 19, scale = 4)
+    private BigDecimal surfaceTotaleEstimeeHectares;
+
+    @Column(name = "volume_prev_tonnes", precision = 19, scale = 4)
+    private BigDecimal volumePrevisionnelTonnes;
+
+    @Column(name = "volume_reel_tonnes", precision = 19, scale = 4)
+    private BigDecimal volumeReelTonnes;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 50)
+    @Builder.Default
+    private StatutCampagneAgricole statut = StatutCampagneAgricole.PREPARATION;
+}

src/main/java/dev/lions/unionflow/server/entity/collectefonds/CampagneCollecte.java

@@ -1,71 +1,71 @@
-package dev.lions.unionflow.server.entity.collectefonds;
-
-import dev.lions.unionflow.server.api.enums.collectefonds.StatutCampagneCollecte;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Organisation;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-@Entity
-@Table(name = "campagnes_collecte", indexes = {
-        @Index(name = "idx_collecte_organisation", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class CampagneCollecte extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    @NotBlank
-    @Column(name = "titre", nullable = false, length = 200)
-    private String titre;
-
-    @Column(name = "courte_description", length = 500)
-    private String courteDescription;
-
-    @Column(name = "html_description_complete", columnDefinition = "TEXT")
-    private String htmlDescriptionComplete;
-
-    @Column(name = "image_banniere_url", length = 500)
-    private String imageBanniereUrl;
-
-    @Column(name = "objectif_financier", precision = 19, scale = 4)
-    private BigDecimal objectifFinancier;
-
-    @Column(name = "montant_collecte_actuel", precision = 19, scale = 4)
-    @Builder.Default
-    private BigDecimal montantCollecteActuel = BigDecimal.ZERO;
-
-    @Column(name = "nombre_donateurs")
-    @Builder.Default
-    private Integer nombreDonateurs = 0;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 50)
-    @Builder.Default
-    private StatutCampagneCollecte statut = StatutCampagneCollecte.BROUILLON;
-
-    @NotNull
-    @Column(name = "date_ouverture", nullable = false)
-    @Builder.Default
-    private LocalDateTime dateOuverture = LocalDateTime.now();
-
-    @Column(name = "date_cloture_prevue")
-    private LocalDateTime dateCloturePrevue;
-
-    @Column(name = "est_publique", nullable = false)
-    @Builder.Default
-    private Boolean estPublique = true;
-}
+package dev.lions.unionflow.server.entity.collectefonds;
+
+import dev.lions.unionflow.server.api.enums.collectefonds.StatutCampagneCollecte;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Organisation;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "campagnes_collecte", indexes = {
+        @Index(name = "idx_collecte_organisation", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class CampagneCollecte extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @NotBlank
+    @Column(name = "titre", nullable = false, length = 200)
+    private String titre;
+
+    @Column(name = "courte_description", length = 500)
+    private String courteDescription;
+
+    @Column(name = "html_description_complete", columnDefinition = "TEXT")
+    private String htmlDescriptionComplete;
+
+    @Column(name = "image_banniere_url", length = 500)
+    private String imageBanniereUrl;
+
+    @Column(name = "objectif_financier", precision = 19, scale = 4)
+    private BigDecimal objectifFinancier;
+
+    @Column(name = "montant_collecte_actuel", precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal montantCollecteActuel = BigDecimal.ZERO;
+
+    @Column(name = "nombre_donateurs")
+    @Builder.Default
+    private Integer nombreDonateurs = 0;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 50)
+    @Builder.Default
+    private StatutCampagneCollecte statut = StatutCampagneCollecte.BROUILLON;
+
+    @NotNull
+    @Column(name = "date_ouverture", nullable = false)
+    @Builder.Default
+    private LocalDateTime dateOuverture = LocalDateTime.now();
+
+    @Column(name = "date_cloture_prevue")
+    private LocalDateTime dateCloturePrevue;
+
+    @Column(name = "est_publique", nullable = false)
+    @Builder.Default
+    private Boolean estPublique = true;
+}

src/main/java/dev/lions/unionflow/server/entity/collectefonds/ContributionCollecte.java

@@ -1,59 +1,59 @@
-package dev.lions.unionflow.server.entity.collectefonds;
-
-import dev.lions.unionflow.server.api.enums.wave.StatutTransactionWave;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Membre;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-@Entity
-@Table(name = "contributions_collecte", indexes = {
-        @Index(name = "idx_contribution_campagne", columnList = "campagne_id"),
-        @Index(name = "idx_contribution_membre", columnList = "membre_donateur_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ContributionCollecte extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "campagne_id", nullable = false)
-    private CampagneCollecte campagne;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "membre_donateur_id")
-    private Membre membreDonateur;
-
-    @Column(name = "alias_donateur", length = 150)
-    private String aliasDonateur;
-
-    @Column(name = "est_anonyme", nullable = false)
-    @Builder.Default
-    private Boolean estAnonyme = false;
-
-    @NotNull
-    @Column(name = "montant_soutien", nullable = false, precision = 19, scale = 4)
-    private BigDecimal montantSoutien;
-
-    @Column(name = "message_soutien", length = 500)
-    private String messageSoutien;
-
-    @NotNull
-    @Column(name = "date_contribution", nullable = false)
-    @Builder.Default
-    private LocalDateTime dateContribution = LocalDateTime.now();
-
-    @Column(name = "transaction_paiement_id", length = 100)
-    private String transactionPaiementId;
-
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut_paiement", length = 50)
-    private StatutTransactionWave statutPaiement;
-}
+package dev.lions.unionflow.server.entity.collectefonds;
+
+import dev.lions.unionflow.server.api.enums.wave.StatutTransactionWave;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Membre;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "contributions_collecte", indexes = {
+        @Index(name = "idx_contribution_campagne", columnList = "campagne_id"),
+        @Index(name = "idx_contribution_membre", columnList = "membre_donateur_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ContributionCollecte extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "campagne_id", nullable = false)
+    private CampagneCollecte campagne;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "membre_donateur_id")
+    private Membre membreDonateur;
+
+    @Column(name = "alias_donateur", length = 150)
+    private String aliasDonateur;
+
+    @Column(name = "est_anonyme", nullable = false)
+    @Builder.Default
+    private Boolean estAnonyme = false;
+
+    @NotNull
+    @Column(name = "montant_soutien", nullable = false, precision = 19, scale = 4)
+    private BigDecimal montantSoutien;
+
+    @Column(name = "message_soutien", length = 500)
+    private String messageSoutien;
+
+    @NotNull
+    @Column(name = "date_contribution", nullable = false)
+    @Builder.Default
+    private LocalDateTime dateContribution = LocalDateTime.now();
+
+    @Column(name = "transaction_paiement_id", length = 100)
+    private String transactionPaiementId;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut_paiement", length = 50)
+    private StatutTransactionWave statutPaiement;
+}

src/main/java/dev/lions/unionflow/server/entity/culte/DonReligieux.java

@@ -1,51 +1,51 @@
-package dev.lions.unionflow.server.entity.culte;
-
-import dev.lions.unionflow.server.api.enums.culte.TypeDonReligieux;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Membre;
-import dev.lions.unionflow.server.entity.Organisation;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-@Entity
-@Table(name = "dons_religieux", indexes = {
-        @Index(name = "idx_don_c_organisation", columnList = "institution_id"),
-        @Index(name = "idx_don_c_fidele", columnList = "fidele_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class DonReligieux extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "institution_id", nullable = false)
-    private Organisation institution;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "fidele_id")
-    private Membre fidele;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "type_don", nullable = false, length = 50)
-    private TypeDonReligieux typeDon;
-
-    @NotNull
-    @Column(name = "montant", nullable = false, precision = 19, scale = 4)
-    private BigDecimal montant;
-
-    @NotNull
-    @Column(name = "date_encaissement", nullable = false)
-    @Builder.Default
-    private LocalDateTime dateEncaissement = LocalDateTime.now();
-
-    @Column(name = "periode_nature", length = 150)
-    private String periodeOuNatureAssociee;
-}
+package dev.lions.unionflow.server.entity.culte;
+
+import dev.lions.unionflow.server.api.enums.culte.TypeDonReligieux;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Membre;
+import dev.lions.unionflow.server.entity.Organisation;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "dons_religieux", indexes = {
+        @Index(name = "idx_don_c_organisation", columnList = "institution_id"),
+        @Index(name = "idx_don_c_fidele", columnList = "fidele_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class DonReligieux extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "institution_id", nullable = false)
+    private Organisation institution;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "fidele_id")
+    private Membre fidele;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_don", nullable = false, length = 50)
+    private TypeDonReligieux typeDon;
+
+    @NotNull
+    @Column(name = "montant", nullable = false, precision = 19, scale = 4)
+    private BigDecimal montant;
+
+    @NotNull
+    @Column(name = "date_encaissement", nullable = false)
+    @Builder.Default
+    private LocalDateTime dateEncaissement = LocalDateTime.now();
+
+    @Column(name = "periode_nature", length = 150)
+    private String periodeOuNatureAssociee;
+}

src/main/java/dev/lions/unionflow/server/entity/gouvernance/EchelonOrganigramme.java

@@ -1,43 +1,43 @@
-package dev.lions.unionflow.server.entity.gouvernance;
-
-import dev.lions.unionflow.server.api.enums.gouvernance.NiveauEchelon;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Organisation;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-@Entity
-@Table(name = "echelons_organigramme", indexes = {
-        @Index(name = "idx_echelon_org", columnList = "organisation_id"),
-        @Index(name = "idx_echelon_parent", columnList = "echelon_parent_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class EchelonOrganigramme extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "echelon_parent_id")
-    private Organisation echelonParent;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "niveau_echelon", nullable = false, length = 50)
-    private NiveauEchelon niveau;
-
-    @NotBlank
-    @Column(name = "designation", nullable = false, length = 200)
-    private String designation;
-
-    @Column(name = "zone_delegation", length = 200)
-    private String zoneGeographiqueOuDelegation;
-}
+package dev.lions.unionflow.server.entity.gouvernance;
+
+import dev.lions.unionflow.server.api.enums.gouvernance.NiveauEchelon;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Organisation;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+@Entity
+@Table(name = "echelons_organigramme", indexes = {
+        @Index(name = "idx_echelon_org", columnList = "organisation_id"),
+        @Index(name = "idx_echelon_parent", columnList = "echelon_parent_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class EchelonOrganigramme extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "echelon_parent_id")
+    private Organisation echelonParent;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "niveau_echelon", nullable = false, length = 50)
+    private NiveauEchelon niveau;
+
+    @NotBlank
+    @Column(name = "designation", nullable = false, length = 200)
+    private String designation;
+
+    @Column(name = "zone_delegation", length = 200)
+    private String zoneGeographiqueOuDelegation;
+}

src/main/java/dev/lions/unionflow/server/entity/listener/AuditEntityListener.java

@@ -1,106 +1,106 @@
-package dev.lions.unionflow.server.entity.listener;
-
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.service.KeycloakService;
-import io.quarkus.arc.Arc;
-import jakarta.persistence.PrePersist;
-import jakarta.persistence.PreUpdate;
-import org.jboss.logging.Logger;
-
-/**
- * Listener JPA pour l'alimentation automatique
- * des champs d'audit.
- *
- * <p>
- * Renseigne automatiquement {@code creePar} lors
- * de la création et {@code modifiePar} lors de la
- * mise à jour, en récupérant l'email de
- * l'utilisateur authentifié via
- * {@link KeycloakService}.
- *
- * <p>
- * Ce listener est référencé via
- * {@code @EntityListeners} sur {@link BaseEntity},
- * garantissant que <strong>toutes</strong> les
- * entités héritent automatiquement de ce
- * comportement (WOU strict).
- *
- * @author UnionFlow Team
- * @version 3.0
- * @since 2026-02-21
- */
-public class AuditEntityListener {
-
-    /**
-     * Utilisateur par défaut pour les opérations
-     * système sans contexte de sécurité.
-     */
-    private static final String UTILISATEUR_SYSTEME = "system";
-
-    private static final Logger LOG = Logger.getLogger(AuditEntityListener.class);
-
-    /**
-     * Callback exécuté avant la persistance.
-     *
-     * <p>
-     * Renseigne {@code creePar} avec l'email
-     * de l'utilisateur authentifié, ou
-     * {@code "system"} si aucun contexte de
-     * sécurité n'est disponible.
-     *
-     * @param entity l'entité en cours de création
-     */
-    @PrePersist
-    public void avantCreation(BaseEntity entity) {
-        if (entity.getCreePar() == null
-                || entity.getCreePar().isBlank()) {
-            entity.setCreePar(
-                    obtenirUtilisateurCourant());
-        }
-    }
-
-    /**
-     * Callback exécuté avant la mise à jour.
-     *
-     * <p>
-     * Renseigne {@code modifiePar} avec l'email
-     * de l'utilisateur authentifié.
-     *
-     * @param entity l'entité en cours de modification
-     */
-    @PreUpdate
-    public void avantModification(BaseEntity entity) {
-        entity.setModifiePar(
-                obtenirUtilisateurCourant());
-    }
-
-    /**
-     * Obtient l'email de l'utilisateur courant.
-     *
-     * <p>
-     * Utilise {@link Arc#container()} pour
-     * résoudre le {@link KeycloakService} depuis
-     * le conteneur CDI de Quarkus.
-     *
-     * @return l'email ou {@code "system"} en fallback
-     */
-    private String obtenirUtilisateurCourant() {
-        try {
-            KeycloakService keycloakService = Arc.container()
-                    .instance(KeycloakService.class)
-                    .get();
-            if (keycloakService != null
-                    && keycloakService.isAuthenticated()) {
-                String email = keycloakService.getCurrentUserEmail();
-                if (email != null && !email.isBlank()) {
-                    return email;
-                }
-            }
-        } catch (Exception e) {
-            LOG.debugf(
-                    "Contexte de sécurité indisponible: %s",
-                    e.getMessage());
-        }
-        return UTILISATEUR_SYSTEME;
-    }
-}
+package dev.lions.unionflow.server.entity.listener;
+
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.service.KeycloakService;
+import io.quarkus.arc.Arc;
+import jakarta.persistence.PrePersist;
+import jakarta.persistence.PreUpdate;
+import org.jboss.logging.Logger;
+
+/**
+ * Listener JPA pour l'alimentation automatique
+ * des champs d'audit.
+ *
+ * <p>
+ * Renseigne automatiquement {@code creePar} lors
+ * de la création et {@code modifiePar} lors de la
+ * mise à jour, en récupérant l'email de
+ * l'utilisateur authentifié via
+ * {@link KeycloakService}.
+ *
+ * <p>
+ * Ce listener est référencé via
+ * {@code @EntityListeners} sur {@link BaseEntity},
+ * garantissant que <strong>toutes</strong> les
+ * entités héritent automatiquement de ce
+ * comportement (WOU strict).
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2026-02-21
+ */
+public class AuditEntityListener {
+
+    /**
+     * Utilisateur par défaut pour les opérations
+     * système sans contexte de sécurité.
+     */
+    private static final String UTILISATEUR_SYSTEME = "system";
+
+    private static final Logger LOG = Logger.getLogger(AuditEntityListener.class);
+
+    /**
+     * Callback exécuté avant la persistance.
+     *
+     * <p>
+     * Renseigne {@code creePar} avec l'email
+     * de l'utilisateur authentifié, ou
+     * {@code "system"} si aucun contexte de
+     * sécurité n'est disponible.
+     *
+     * @param entity l'entité en cours de création
+     */
+    @PrePersist
+    public void avantCreation(BaseEntity entity) {
+        if (entity.getCreePar() == null
+                || entity.getCreePar().isBlank()) {
+            entity.setCreePar(
+                    obtenirUtilisateurCourant());
+        }
+    }
+
+    /**
+     * Callback exécuté avant la mise à jour.
+     *
+     * <p>
+     * Renseigne {@code modifiePar} avec l'email
+     * de l'utilisateur authentifié.
+     *
+     * @param entity l'entité en cours de modification
+     */
+    @PreUpdate
+    public void avantModification(BaseEntity entity) {
+        entity.setModifiePar(
+                obtenirUtilisateurCourant());
+    }
+
+    /**
+     * Obtient l'email de l'utilisateur courant.
+     *
+     * <p>
+     * Utilise {@link Arc#container()} pour
+     * résoudre le {@link KeycloakService} depuis
+     * le conteneur CDI de Quarkus.
+     *
+     * @return l'email ou {@code "system"} en fallback
+     */
+    private String obtenirUtilisateurCourant() {
+        try {
+            KeycloakService keycloakService = Arc.container()
+                    .instance(KeycloakService.class)
+                    .get();
+            if (keycloakService != null
+                    && keycloakService.isAuthenticated()) {
+                String email = keycloakService.getCurrentUserEmail();
+                if (email != null && !email.isBlank()) {
+                    return email;
+                }
+            }
+        } catch (Exception e) {
+            LOG.debugf(
+                    "Contexte de sécurité indisponible: %s",
+                    e.getMessage());
+        }
+        return UTILISATEUR_SYSTEME;
+    }
+}

src/main/java/dev/lions/unionflow/server/entity/mutuelle/ParametresFinanciersMutuelle.java

@@ -0,0 +1,68 @@
+package dev.lions.unionflow.server.entity.mutuelle;
+
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Organisation;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "parametres_financiers_mutuelle", indexes = {
+        @Index(name = "idx_pfm_org", columnList = "organisation_id", unique = true)
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ParametresFinanciersMutuelle extends BaseEntity {
+
+    @OneToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false, unique = true)
+    private Organisation organisation;
+
+    /** Valeur nominale par défaut d'une part sociale */
+    @NotNull
+    @Column(name = "valeur_nominale_par_defaut", nullable = false, precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal valeurNominaleParDefaut = new BigDecimal("5000");
+
+    /** Taux d'intérêt annuel sur l'épargne, ex: 0.03 = 3% */
+    @NotNull
+    @Column(name = "taux_interet_annuel_epargne", nullable = false, precision = 6, scale = 4)
+    @Builder.Default
+    private BigDecimal tauxInteretAnnuelEpargne = new BigDecimal("0.03");
+
+    /** Taux de dividende annuel sur les parts sociales, ex: 0.05 = 5% */
+    @NotNull
+    @Column(name = "taux_dividende_parts_annuel", nullable = false, precision = 6, scale = 4)
+    @Builder.Default
+    private BigDecimal tauxDividendePartsAnnuel = new BigDecimal("0.05");
+
+    /** MENSUEL | TRIMESTRIEL | ANNUEL */
+    @NotNull
+    @Column(name = "periodicite_calcul", nullable = false, length = 20)
+    @Builder.Default
+    private String periodiciteCalcul = "MENSUEL";
+
+    /** Solde minimum en dessous duquel les intérêts ne s'appliquent pas */
+    @Column(name = "seuil_min_epargne_interets", precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal seuilMinEpargneInterets = BigDecimal.ZERO;
+
+    /** Date du prochain calcul planifié */
+    @Column(name = "prochaine_calcul_interets")
+    private LocalDate prochaineCalculInterets;
+
+    /** Date du dernier calcul effectué */
+    @Column(name = "dernier_calcul_interets")
+    private LocalDate dernierCalculInterets;
+
+    /** Nombre de comptes traités lors du dernier calcul */
+    @Column(name = "dernier_nb_comptes_traites")
+    @Builder.Default
+    private Integer dernierNbComptesTraites = 0;
+}

src/main/java/dev/lions/unionflow/server/entity/mutuelle/credit/DemandeCredit.java

@@ -1,97 +1,97 @@
-package dev.lions.unionflow.server.entity.mutuelle.credit;
-
-import dev.lions.unionflow.server.api.enums.mutuelle.credit.StatutDemandeCredit;
-import dev.lions.unionflow.server.api.enums.mutuelle.credit.TypeCredit;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Membre;
-import dev.lions.unionflow.server.entity.mutuelle.epargne.CompteEpargne;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.util.ArrayList;
-import java.util.List;
-
-@Entity
-@Table(name = "demandes_credit", indexes = {
-        @Index(name = "idx_credit_membre", columnList = "membre_id"),
-        @Index(name = "idx_credit_numero", columnList = "numero_dossier", unique = true)
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class DemandeCredit extends BaseEntity {
-
-    @Column(name = "numero_dossier", unique = true, nullable = false, length = 50)
-    private String numeroDossier;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "membre_id", nullable = false)
-    private Membre membre;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "type_credit", nullable = false, length = 50)
-    private TypeCredit typeCredit;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "compte_lie_id")
-    private CompteEpargne compteLie;
-
-    @NotNull
-    @Column(name = "montant_demande", nullable = false, precision = 19, scale = 4)
-    private BigDecimal montantDemande;
-
-    @NotNull
-    @Column(name = "duree_mois_demande", nullable = false)
-    private Integer dureeMoisDemande;
-
-    @Column(name = "justification_detaillee", columnDefinition = "TEXT")
-    private String justificationDetaillee;
-
-    @Column(name = "montant_approuve", precision = 19, scale = 4)
-    private BigDecimal montantApprouve;
-
-    @Column(name = "duree_mois_approuvee")
-    private Integer dureeMoisApprouvee;
-
-    @Column(name = "taux_interet_annuel", precision = 5, scale = 2)
-    private BigDecimal tauxInteretAnnuel;
-
-    @Column(name = "cout_total_credit", precision = 19, scale = 4)
-    private BigDecimal coutTotalCredit;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 50)
-    @Builder.Default
-    private StatutDemandeCredit statut = StatutDemandeCredit.SOUMISE;
-
-    @Column(name = "notes_comite", columnDefinition = "TEXT")
-    private String notesComite;
-
-    @NotNull
-    @Column(name = "date_soumission", nullable = false)
-    @Builder.Default
-    private LocalDate dateSoumission = LocalDate.now();
-
-    @Column(name = "date_validation")
-    private LocalDate dateValidation;
-
-    @Column(name = "date_premier_echeance")
-    private LocalDate datePremierEcheance;
-
-    @OneToMany(mappedBy = "demandeCredit", cascade = CascadeType.ALL, orphanRemoval = true)
-    @Builder.Default
-    private List<GarantieDemande> garanties = new ArrayList<>();
-
-    @OneToMany(mappedBy = "demandeCredit", cascade = CascadeType.ALL, orphanRemoval = true)
-    @OrderBy("ordre ASC")
-    @Builder.Default
-    private List<EcheanceCredit> echeancier = new ArrayList<>();
-}
+package dev.lions.unionflow.server.entity.mutuelle.credit;
+
+import dev.lions.unionflow.server.api.enums.mutuelle.credit.StatutDemandeCredit;
+import dev.lions.unionflow.server.api.enums.mutuelle.credit.TypeCredit;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Membre;
+import dev.lions.unionflow.server.entity.mutuelle.epargne.CompteEpargne;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name = "demandes_credit", indexes = {
+        @Index(name = "idx_credit_membre", columnList = "membre_id"),
+        @Index(name = "idx_credit_numero", columnList = "numero_dossier", unique = true)
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class DemandeCredit extends BaseEntity {
+
+    @Column(name = "numero_dossier", unique = true, nullable = false, length = 50)
+    private String numeroDossier;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "membre_id", nullable = false)
+    private Membre membre;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_credit", nullable = false, length = 50)
+    private TypeCredit typeCredit;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "compte_lie_id")
+    private CompteEpargne compteLie;
+
+    @NotNull
+    @Column(name = "montant_demande", nullable = false, precision = 19, scale = 4)
+    private BigDecimal montantDemande;
+
+    @NotNull
+    @Column(name = "duree_mois_demande", nullable = false)
+    private Integer dureeMoisDemande;
+
+    @Column(name = "justification_detaillee", columnDefinition = "TEXT")
+    private String justificationDetaillee;
+
+    @Column(name = "montant_approuve", precision = 19, scale = 4)
+    private BigDecimal montantApprouve;
+
+    @Column(name = "duree_mois_approuvee")
+    private Integer dureeMoisApprouvee;
+
+    @Column(name = "taux_interet_annuel", precision = 5, scale = 2)
+    private BigDecimal tauxInteretAnnuel;
+
+    @Column(name = "cout_total_credit", precision = 19, scale = 4)
+    private BigDecimal coutTotalCredit;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 50)
+    @Builder.Default
+    private StatutDemandeCredit statut = StatutDemandeCredit.SOUMISE;
+
+    @Column(name = "notes_comite", columnDefinition = "TEXT")
+    private String notesComite;
+
+    @NotNull
+    @Column(name = "date_soumission", nullable = false)
+    @Builder.Default
+    private LocalDate dateSoumission = LocalDate.now();
+
+    @Column(name = "date_validation")
+    private LocalDate dateValidation;
+
+    @Column(name = "date_premier_echeance")
+    private LocalDate datePremierEcheance;
+
+    @OneToMany(mappedBy = "demandeCredit", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
+    private List<GarantieDemande> garanties = new ArrayList<>();
+
+    @OneToMany(mappedBy = "demandeCredit", cascade = CascadeType.ALL, orphanRemoval = true)
+    @OrderBy("ordre ASC")
+    @Builder.Default
+    private List<EcheanceCredit> echeancier = new ArrayList<>();
+}

src/main/java/dev/lions/unionflow/server/entity/mutuelle/credit/EcheanceCredit.java

@@ -1,69 +1,69 @@
-package dev.lions.unionflow.server.entity.mutuelle.credit;
-
-import dev.lions.unionflow.server.api.enums.mutuelle.credit.StatutEcheanceCredit;
-import dev.lions.unionflow.server.entity.BaseEntity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-
-@Entity
-@Table(name = "echeances_credit", indexes = {
-        @Index(name = "idx_echeance_demande", columnList = "demande_credit_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-@ToString(exclude = "demandeCredit")
-public class EcheanceCredit extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "demande_credit_id", nullable = false)
-    private DemandeCredit demandeCredit;
-
-    @NotNull
-    @Column(name = "ordre", nullable = false)
-    private Integer ordre;
-
-    @NotNull
-    @Column(name = "date_echeance_prevue", nullable = false)
-    private LocalDate dateEcheancePrevue;
-
-    @Column(name = "date_paiement_effectif")
-    private LocalDate datePaiementEffectif;
-
-    @NotNull
-    @Column(name = "capital_amorti", nullable = false, precision = 19, scale = 4)
-    private BigDecimal capitalAmorti;
-
-    @NotNull
-    @Column(name = "interets_periode", nullable = false, precision = 19, scale = 4)
-    private BigDecimal interetsDeLaPeriode;
-
-    @NotNull
-    @Column(name = "montant_total_exigible", nullable = false, precision = 19, scale = 4)
-    private BigDecimal montantTotalExigible;
-
-    @NotNull
-    @Column(name = "capital_restant_du", nullable = false, precision = 19, scale = 4)
-    private BigDecimal capitalRestantDu;
-
-    @Column(name = "penalites_retard", precision = 19, scale = 4)
-    @Builder.Default
-    private BigDecimal penalitesRetard = BigDecimal.ZERO;
-
-    @Column(name = "montant_regle", precision = 19, scale = 4)
-    @Builder.Default
-    private BigDecimal montantRegle = BigDecimal.ZERO;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 50)
-    @Builder.Default
-    private StatutEcheanceCredit statut = StatutEcheanceCredit.A_VENIR;
-}
+package dev.lions.unionflow.server.entity.mutuelle.credit;
+
+import dev.lions.unionflow.server.api.enums.mutuelle.credit.StatutEcheanceCredit;
+import dev.lions.unionflow.server.entity.BaseEntity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "echeances_credit", indexes = {
+        @Index(name = "idx_echeance_demande", columnList = "demande_credit_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+@ToString(exclude = "demandeCredit")
+public class EcheanceCredit extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "demande_credit_id", nullable = false)
+    private DemandeCredit demandeCredit;
+
+    @NotNull
+    @Column(name = "ordre", nullable = false)
+    private Integer ordre;
+
+    @NotNull
+    @Column(name = "date_echeance_prevue", nullable = false)
+    private LocalDate dateEcheancePrevue;
+
+    @Column(name = "date_paiement_effectif")
+    private LocalDate datePaiementEffectif;
+
+    @NotNull
+    @Column(name = "capital_amorti", nullable = false, precision = 19, scale = 4)
+    private BigDecimal capitalAmorti;
+
+    @NotNull
+    @Column(name = "interets_periode", nullable = false, precision = 19, scale = 4)
+    private BigDecimal interetsDeLaPeriode;
+
+    @NotNull
+    @Column(name = "montant_total_exigible", nullable = false, precision = 19, scale = 4)
+    private BigDecimal montantTotalExigible;
+
+    @NotNull
+    @Column(name = "capital_restant_du", nullable = false, precision = 19, scale = 4)
+    private BigDecimal capitalRestantDu;
+
+    @Column(name = "penalites_retard", precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal penalitesRetard = BigDecimal.ZERO;
+
+    @Column(name = "montant_regle", precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal montantRegle = BigDecimal.ZERO;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 50)
+    @Builder.Default
+    private StatutEcheanceCredit statut = StatutEcheanceCredit.A_VENIR;
+}

src/main/java/dev/lions/unionflow/server/entity/mutuelle/credit/GarantieDemande.java

@@ -1,39 +1,39 @@
-package dev.lions.unionflow.server.entity.mutuelle.credit;
-
-import dev.lions.unionflow.server.api.enums.mutuelle.credit.TypeGarantie;
-import dev.lions.unionflow.server.entity.BaseEntity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-
-@Entity
-@Table(name = "garanties_demande")
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-@ToString(exclude = "demandeCredit")
-public class GarantieDemande extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "demande_credit_id", nullable = false)
-    private DemandeCredit demandeCredit;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "type_garantie", nullable = false, length = 50)
-    private TypeGarantie typeGarantie;
-
-    @Column(name = "valeur_estimee", precision = 19, scale = 4)
-    private BigDecimal valeurEstimee;
-
-    @Column(name = "reference_description", length = 500)
-    private String referenceOuDescription;
-
-    @Column(name = "document_preuve_id", length = 36)
-    private String documentPreuveId;
-}
+package dev.lions.unionflow.server.entity.mutuelle.credit;
+
+import dev.lions.unionflow.server.api.enums.mutuelle.credit.TypeGarantie;
+import dev.lions.unionflow.server.entity.BaseEntity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+
+@Entity
+@Table(name = "garanties_demande")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+@ToString(exclude = "demandeCredit")
+public class GarantieDemande extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "demande_credit_id", nullable = false)
+    private DemandeCredit demandeCredit;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_garantie", nullable = false, length = 50)
+    private TypeGarantie typeGarantie;
+
+    @Column(name = "valeur_estimee", precision = 19, scale = 4)
+    private BigDecimal valeurEstimee;
+
+    @Column(name = "reference_description", length = 500)
+    private String referenceOuDescription;
+
+    @Column(name = "document_preuve_id", length = 36)
+    private String documentPreuveId;
+}

src/main/java/dev/lions/unionflow/server/entity/mutuelle/epargne/CompteEpargne.java

@@ -1,73 +1,73 @@
-package dev.lions.unionflow.server.entity.mutuelle.epargne;
-
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Membre;
-import dev.lions.unionflow.server.entity.Organisation;
-import dev.lions.unionflow.server.api.enums.mutuelle.epargne.StatutCompteEpargne;
-import dev.lions.unionflow.server.api.enums.mutuelle.epargne.TypeCompteEpargne;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-
-@Entity
-@Table(name = "comptes_epargne", indexes = {
-        @Index(name = "idx_compte_epargne_numero", columnList = "numero_compte", unique = true),
-        @Index(name = "idx_compte_epargne_membre", columnList = "membre_id"),
-        @Index(name = "idx_compte_epargne_orga", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class CompteEpargne extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "membre_id", nullable = false)
-    private Membre membre;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    @NotBlank
-    @Column(name = "numero_compte", unique = true, nullable = false, length = 50)
-    private String numeroCompte;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "type_compte", nullable = false, length = 50)
-    private TypeCompteEpargne typeCompte;
-
-    @NotNull
-    @Column(name = "solde_actuel", nullable = false, precision = 19, scale = 4)
-    @Builder.Default
-    private BigDecimal soldeActuel = BigDecimal.ZERO;
-
-    @NotNull
-    @Column(name = "solde_bloque", nullable = false, precision = 19, scale = 4)
-    @Builder.Default
-    private BigDecimal soldeBloque = BigDecimal.ZERO;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 30)
-    @Builder.Default
-    private StatutCompteEpargne statut = StatutCompteEpargne.ACTIF;
-
-    @NotNull
-    @Column(name = "date_ouverture", nullable = false)
-    @Builder.Default
-    private LocalDate dateOuverture = LocalDate.now();
-
-    @Column(name = "date_derniere_transaction")
-    private LocalDate dateDerniereTransaction;
-
-    @Column(name = "description", length = 500)
-    private String description;
-}
+package dev.lions.unionflow.server.entity.mutuelle.epargne;
+
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Membre;
+import dev.lions.unionflow.server.entity.Organisation;
+import dev.lions.unionflow.server.api.enums.mutuelle.epargne.StatutCompteEpargne;
+import dev.lions.unionflow.server.api.enums.mutuelle.epargne.TypeCompteEpargne;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "comptes_epargne", indexes = {
+        @Index(name = "idx_compte_epargne_numero", columnList = "numero_compte", unique = true),
+        @Index(name = "idx_compte_epargne_membre", columnList = "membre_id"),
+        @Index(name = "idx_compte_epargne_orga", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class CompteEpargne extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "membre_id", nullable = false)
+    private Membre membre;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @NotBlank
+    @Column(name = "numero_compte", unique = true, nullable = false, length = 50)
+    private String numeroCompte;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_compte", nullable = false, length = 50)
+    private TypeCompteEpargne typeCompte;
+
+    @NotNull
+    @Column(name = "solde_actuel", nullable = false, precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal soldeActuel = BigDecimal.ZERO;
+
+    @NotNull
+    @Column(name = "solde_bloque", nullable = false, precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal soldeBloque = BigDecimal.ZERO;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 30)
+    @Builder.Default
+    private StatutCompteEpargne statut = StatutCompteEpargne.ACTIF;
+
+    @NotNull
+    @Column(name = "date_ouverture", nullable = false)
+    @Builder.Default
+    private LocalDate dateOuverture = LocalDate.now();
+
+    @Column(name = "date_derniere_transaction")
+    private LocalDate dateDerniereTransaction;
+
+    @Column(name = "description", length = 500)
+    private String description;
+}

src/main/java/dev/lions/unionflow/server/entity/mutuelle/epargne/TransactionEpargne.java

@@ -1,70 +1,70 @@
-package dev.lions.unionflow.server.entity.mutuelle.epargne;
-
-import dev.lions.unionflow.server.api.enums.mutuelle.epargne.TypeTransactionEpargne;
-import dev.lions.unionflow.server.api.enums.wave.StatutTransactionWave;
-import dev.lions.unionflow.server.entity.BaseEntity;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-@Entity
-@Table(name = "transactions_epargne", indexes = {
-        @Index(name = "idx_tx_epargne_compte", columnList = "compte_id"),
-        @Index(name = "idx_tx_epargne_reference", columnList = "reference_externe")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class TransactionEpargne extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "compte_id", nullable = false)
-    private CompteEpargne compte;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "type_transaction", nullable = false, length = 50)
-    private TypeTransactionEpargne type;
-
-    @NotNull
-    @Column(name = "montant", nullable = false, precision = 19, scale = 4)
-    private BigDecimal montant;
-
-    @Column(name = "solde_avant", precision = 19, scale = 4)
-    private BigDecimal soldeAvant;
-
-    @Column(name = "solde_apres", precision = 19, scale = 4)
-    private BigDecimal soldeApres;
-
-    @Column(name = "motif", length = 500)
-    private String motif;
-
-    @NotNull
-    @Column(name = "date_transaction", nullable = false)
-    @Builder.Default
-    private LocalDateTime dateTransaction = LocalDateTime.now();
-
-    @Column(name = "operateur_id", length = 36)
-    private String operateurId;
-
-    @Column(name = "reference_externe", length = 100)
-    private String referenceExterne;
-
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut_execution", length = 50)
-    private StatutTransactionWave statutExecution;
-
-    /** Origine des fonds (LCB-FT) — obligatoire au-dessus du seuil configuré */
-    @Column(name = "origine_fonds", length = 200)
-    private String origineFonds;
-
-    /** Pièce justificative (document) pour opérations au-dessus du seuil LCB-FT */
-    @Column(name = "piece_justificative_id")
-    private java.util.UUID pieceJustificativeId;
-}
+package dev.lions.unionflow.server.entity.mutuelle.epargne;
+
+import dev.lions.unionflow.server.api.enums.mutuelle.epargne.TypeTransactionEpargne;
+import dev.lions.unionflow.server.api.enums.wave.StatutTransactionWave;
+import dev.lions.unionflow.server.entity.BaseEntity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "transactions_epargne", indexes = {
+        @Index(name = "idx_tx_epargne_compte", columnList = "compte_id"),
+        @Index(name = "idx_tx_epargne_reference", columnList = "reference_externe")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class TransactionEpargne extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "compte_id", nullable = false)
+    private CompteEpargne compte;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_transaction", nullable = false, length = 50)
+    private TypeTransactionEpargne type;
+
+    @NotNull
+    @Column(name = "montant", nullable = false, precision = 19, scale = 4)
+    private BigDecimal montant;
+
+    @Column(name = "solde_avant", precision = 19, scale = 4)
+    private BigDecimal soldeAvant;
+
+    @Column(name = "solde_apres", precision = 19, scale = 4)
+    private BigDecimal soldeApres;
+
+    @Column(name = "motif", length = 500)
+    private String motif;
+
+    @NotNull
+    @Column(name = "date_transaction", nullable = false)
+    @Builder.Default
+    private LocalDateTime dateTransaction = LocalDateTime.now();
+
+    @Column(name = "operateur_id", length = 36)
+    private String operateurId;
+
+    @Column(name = "reference_externe", length = 100)
+    private String referenceExterne;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut_execution", length = 50)
+    private StatutTransactionWave statutExecution;
+
+    /** Origine des fonds (LCB-FT) — obligatoire au-dessus du seuil configuré */
+    @Column(name = "origine_fonds", length = 200)
+    private String origineFonds;
+
+    /** Pièce justificative (document) pour opérations au-dessus du seuil LCB-FT */
+    @Column(name = "piece_justificative_id")
+    private java.util.UUID pieceJustificativeId;
+}

src/main/java/dev/lions/unionflow/server/entity/mutuelle/parts/ComptePartsSociales.java

@@ -0,0 +1,78 @@
+package dev.lions.unionflow.server.entity.mutuelle.parts;
+
+import dev.lions.unionflow.server.api.enums.mutuelle.parts.StatutComptePartsSociales;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Membre;
+import dev.lions.unionflow.server.entity.Organisation;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "comptes_parts_sociales", indexes = {
+        @Index(name = "idx_cps_numero", columnList = "numero_compte", unique = true),
+        @Index(name = "idx_cps_membre", columnList = "membre_id"),
+        @Index(name = "idx_cps_org", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ComptePartsSociales extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "membre_id", nullable = false)
+    private Membre membre;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @NotBlank
+    @Column(name = "numero_compte", unique = true, nullable = false, length = 50)
+    private String numeroCompte;
+
+    @NotNull
+    @Min(0)
+    @Column(name = "nombre_parts", nullable = false)
+    @Builder.Default
+    private Integer nombreParts = 0;
+
+    @NotNull
+    @Column(name = "valeur_nominale", nullable = false, precision = 19, scale = 4)
+    private BigDecimal valeurNominale;
+
+    /** nombreParts × valeurNominale — mis à jour à chaque transaction */
+    @NotNull
+    @Column(name = "montant_total", nullable = false, precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal montantTotal = BigDecimal.ZERO;
+
+    @NotNull
+    @Column(name = "total_dividendes_recus", nullable = false, precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal totalDividendesRecus = BigDecimal.ZERO;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 30)
+    @Builder.Default
+    private StatutComptePartsSociales statut = StatutComptePartsSociales.ACTIF;
+
+    @NotNull
+    @Column(name = "date_ouverture", nullable = false)
+    @Builder.Default
+    private LocalDate dateOuverture = LocalDate.now();
+
+    @Column(name = "date_derniere_operation")
+    private LocalDate dateDerniereOperation;
+
+    @Column(name = "notes", length = 500)
+    private String notes;
+}

src/main/java/dev/lions/unionflow/server/entity/mutuelle/parts/TransactionPartsSociales.java

@@ -0,0 +1,61 @@
+package dev.lions.unionflow.server.entity.mutuelle.parts;
+
+import dev.lions.unionflow.server.api.enums.mutuelle.parts.TypeTransactionPartsSociales;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "transactions_parts_sociales", indexes = {
+        @Index(name = "idx_tps_compte", columnList = "compte_id"),
+        @Index(name = "idx_tps_date", columnList = "date_transaction")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class TransactionPartsSociales extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "compte_id", nullable = false)
+    private ComptePartsSociales compte;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_transaction", nullable = false, length = 50)
+    private TypeTransactionPartsSociales typeTransaction;
+
+    @NotNull
+    @Min(1)
+    @Column(name = "nombre_parts", nullable = false)
+    private Integer nombreParts;
+
+    @NotNull
+    @Column(name = "montant", nullable = false, precision = 19, scale = 4)
+    private BigDecimal montant;
+
+    @Column(name = "solde_parts_avant", nullable = false)
+    @Builder.Default
+    private Integer soldePartsAvant = 0;
+
+    @Column(name = "solde_parts_apres", nullable = false)
+    @Builder.Default
+    private Integer soldePartsApres = 0;
+
+    @Column(name = "motif", length = 500)
+    private String motif;
+
+    @Column(name = "reference_externe", length = 100)
+    private String referenceExterne;
+
+    @NotNull
+    @Column(name = "date_transaction", nullable = false)
+    @Builder.Default
+    private LocalDateTime dateTransaction = LocalDateTime.now();
+}

src/main/java/dev/lions/unionflow/server/entity/ong/ProjetOng.java

@@ -1,58 +1,58 @@
-package dev.lions.unionflow.server.entity.ong;
-
-import dev.lions.unionflow.server.api.enums.ong.StatutProjetOng;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Organisation;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-
-@Entity
-@Table(name = "projets_ong", indexes = {
-        @Index(name = "idx_projet_ong_organisation", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class ProjetOng extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    @NotBlank
-    @Column(name = "nom_projet", nullable = false, length = 200)
-    private String nomProjet;
-
-    @Column(name = "description", columnDefinition = "TEXT")
-    private String descriptionMandat;
-
-    @Column(name = "zone_geographique", length = 200)
-    private String zoneGeographiqueIntervention;
-
-    @Column(name = "budget_previsionnel", precision = 19, scale = 4)
-    private BigDecimal budgetPrevisionnel;
-
-    @Column(name = "depenses_reelles", precision = 19, scale = 4)
-    @Builder.Default
-    private BigDecimal depensesReelles = BigDecimal.ZERO;
-
-    @Column(name = "date_lancement")
-    private LocalDate dateLancement;
-
-    @Column(name = "date_fin_estimee")
-    private LocalDate dateFinEstimee;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 50)
-    @Builder.Default
-    private StatutProjetOng statut = StatutProjetOng.EN_ETUDE;
-}
+package dev.lions.unionflow.server.entity.ong;
+
+import dev.lions.unionflow.server.api.enums.ong.StatutProjetOng;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Organisation;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "projets_ong", indexes = {
+        @Index(name = "idx_projet_ong_organisation", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class ProjetOng extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @NotBlank
+    @Column(name = "nom_projet", nullable = false, length = 200)
+    private String nomProjet;
+
+    @Column(name = "description", columnDefinition = "TEXT")
+    private String descriptionMandat;
+
+    @Column(name = "zone_geographique", length = 200)
+    private String zoneGeographiqueIntervention;
+
+    @Column(name = "budget_previsionnel", precision = 19, scale = 4)
+    private BigDecimal budgetPrevisionnel;
+
+    @Column(name = "depenses_reelles", precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal depensesReelles = BigDecimal.ZERO;
+
+    @Column(name = "date_lancement")
+    private LocalDate dateLancement;
+
+    @Column(name = "date_fin_estimee")
+    private LocalDate dateFinEstimee;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 50)
+    @Builder.Default
+    private StatutProjetOng statut = StatutProjetOng.EN_ETUDE;
+}

src/main/java/dev/lions/unionflow/server/entity/registre/AgrementProfessionnel.java

@@ -1,54 +1,54 @@
-package dev.lions.unionflow.server.entity.registre;
-
-import dev.lions.unionflow.server.api.enums.registre.StatutAgrement;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Membre;
-import dev.lions.unionflow.server.entity.Organisation;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.time.LocalDate;
-
-@Entity
-@Table(name = "agrements_professionnels", indexes = {
-        @Index(name = "idx_agrement_membre", columnList = "membre_id"),
-        @Index(name = "idx_agrement_orga", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class AgrementProfessionnel extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "membre_id", nullable = false)
-    private Membre membre;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    @Column(name = "secteur_ordre", length = 150)
-    private String secteurOuOrdre;
-
-    @Column(name = "numero_licence", length = 100)
-    private String numeroLicenceOuRegistre;
-
-    @Column(name = "categorie_classement", length = 100)
-    private String categorieClassement;
-
-    @Column(name = "date_delivrance")
-    private LocalDate dateDelivrance;
-
-    @Column(name = "date_expiration")
-    private LocalDate dateExpiration;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 50)
-    @Builder.Default
-    private StatutAgrement statut = StatutAgrement.PROVISOIRE;
-}
+package dev.lions.unionflow.server.entity.registre;
+
+import dev.lions.unionflow.server.api.enums.registre.StatutAgrement;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Membre;
+import dev.lions.unionflow.server.entity.Organisation;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "agrements_professionnels", indexes = {
+        @Index(name = "idx_agrement_membre", columnList = "membre_id"),
+        @Index(name = "idx_agrement_orga", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class AgrementProfessionnel extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "membre_id", nullable = false)
+    private Membre membre;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @Column(name = "secteur_ordre", length = 150)
+    private String secteurOuOrdre;
+
+    @Column(name = "numero_licence", length = 100)
+    private String numeroLicenceOuRegistre;
+
+    @Column(name = "categorie_classement", length = 100)
+    private String categorieClassement;
+
+    @Column(name = "date_delivrance")
+    private LocalDate dateDelivrance;
+
+    @Column(name = "date_expiration")
+    private LocalDate dateExpiration;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 50)
+    @Builder.Default
+    private StatutAgrement statut = StatutAgrement.PROVISOIRE;
+}

src/main/java/dev/lions/unionflow/server/entity/tontine/Tontine.java

@@ -1,73 +1,73 @@
-package dev.lions.unionflow.server.entity.tontine;
-
-import dev.lions.unionflow.server.api.enums.tontine.FrequenceTour;
-import dev.lions.unionflow.server.api.enums.tontine.StatutTontine;
-import dev.lions.unionflow.server.api.enums.tontine.TypeTontine;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Organisation;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.util.ArrayList;
-import java.util.List;
-
-@Entity
-@Table(name = "tontines", indexes = {
-        @Index(name = "idx_tontine_organisation", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class Tontine extends BaseEntity {
-
-    @NotBlank
-    @Column(name = "nom", nullable = false, length = 150)
-    private String nom;
-
-    @Column(name = "description", columnDefinition = "TEXT")
-    private String description;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "type_tontine", nullable = false, length = 50)
-    private TypeTontine typeTontine;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "frequence", nullable = false, length = 50)
-    private FrequenceTour frequence;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 50)
-    @Builder.Default
-    private StatutTontine statut = StatutTontine.PLANIFIEE;
-
-    @Column(name = "date_debut_effective")
-    private LocalDate dateDebutEffective;
-
-    @Column(name = "date_fin_prevue")
-    private LocalDate dateFinPrevue;
-
-    @Column(name = "montant_mise_tour", precision = 19, scale = 4)
-    private BigDecimal montantMiseParTour;
-
-    @Column(name = "limite_participants")
-    private Integer limiteParticipants;
-
-    @OneToMany(mappedBy = "tontine", cascade = CascadeType.ALL, orphanRemoval = true)
-    @OrderBy("ordreTour ASC")
-    @Builder.Default
-    private List<TourTontine> calendrierTours = new ArrayList<>();
-}
+package dev.lions.unionflow.server.entity.tontine;
+
+import dev.lions.unionflow.server.api.enums.tontine.FrequenceTour;
+import dev.lions.unionflow.server.api.enums.tontine.StatutTontine;
+import dev.lions.unionflow.server.api.enums.tontine.TypeTontine;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Organisation;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name = "tontines", indexes = {
+        @Index(name = "idx_tontine_organisation", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Tontine extends BaseEntity {
+
+    @NotBlank
+    @Column(name = "nom", nullable = false, length = 150)
+    private String nom;
+
+    @Column(name = "description", columnDefinition = "TEXT")
+    private String description;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_tontine", nullable = false, length = 50)
+    private TypeTontine typeTontine;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "frequence", nullable = false, length = 50)
+    private FrequenceTour frequence;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 50)
+    @Builder.Default
+    private StatutTontine statut = StatutTontine.PLANIFIEE;
+
+    @Column(name = "date_debut_effective")
+    private LocalDate dateDebutEffective;
+
+    @Column(name = "date_fin_prevue")
+    private LocalDate dateFinPrevue;
+
+    @Column(name = "montant_mise_tour", precision = 19, scale = 4)
+    private BigDecimal montantMiseParTour;
+
+    @Column(name = "limite_participants")
+    private Integer limiteParticipants;
+
+    @OneToMany(mappedBy = "tontine", cascade = CascadeType.ALL, orphanRemoval = true)
+    @OrderBy("ordreTour ASC")
+    @Builder.Default
+    private List<TourTontine> calendrierTours = new ArrayList<>();
+}

src/main/java/dev/lions/unionflow/server/entity/tontine/TourTontine.java

@@ -1,56 +1,56 @@
-package dev.lions.unionflow.server.entity.tontine;
-
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Membre;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-
-@Entity
-@Table(name = "tours_tontine", indexes = {
-        @Index(name = "idx_tour_tontine", columnList = "tontine_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-@ToString(exclude = { "tontine", "membreBeneficiaire" })
-public class TourTontine extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "tontine_id", nullable = false)
-    private Tontine tontine;
-
-    @NotNull
-    @Column(name = "ordre_tour", nullable = false)
-    private Integer ordreTour;
-
-    @NotNull
-    @Column(name = "date_ouverture_cotisations", nullable = false)
-    private LocalDate dateOuvertureCotisations;
-
-    @Column(name = "date_tirage_remise")
-    private LocalDate dateTirageOuRemise;
-
-    @NotNull
-    @Column(name = "montant_cible", nullable = false, precision = 19, scale = 4)
-    @Builder.Default
-    private BigDecimal montantCible = BigDecimal.ZERO;
-
-    @NotNull
-    @Column(name = "cagnotte_collectee", nullable = false, precision = 19, scale = 4)
-    @Builder.Default
-    private BigDecimal cagnotteCollectee = BigDecimal.ZERO;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "membre_beneficiaire_id")
-    private Membre membreBeneficiaire;
-
-    @Column(name = "statut_interne", length = 30)
-    private String statutInterne;
-}
+package dev.lions.unionflow.server.entity.tontine;
+
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Membre;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "tours_tontine", indexes = {
+        @Index(name = "idx_tour_tontine", columnList = "tontine_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+@ToString(exclude = { "tontine", "membreBeneficiaire" })
+public class TourTontine extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "tontine_id", nullable = false)
+    private Tontine tontine;
+
+    @NotNull
+    @Column(name = "ordre_tour", nullable = false)
+    private Integer ordreTour;
+
+    @NotNull
+    @Column(name = "date_ouverture_cotisations", nullable = false)
+    private LocalDate dateOuvertureCotisations;
+
+    @Column(name = "date_tirage_remise")
+    private LocalDate dateTirageOuRemise;
+
+    @NotNull
+    @Column(name = "montant_cible", nullable = false, precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal montantCible = BigDecimal.ZERO;
+
+    @NotNull
+    @Column(name = "cagnotte_collectee", nullable = false, precision = 19, scale = 4)
+    @Builder.Default
+    private BigDecimal cagnotteCollectee = BigDecimal.ZERO;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "membre_beneficiaire_id")
+    private Membre membreBeneficiaire;
+
+    @Column(name = "statut_interne", length = 30)
+    private String statutInterne;
+}

src/main/java/dev/lions/unionflow/server/entity/vote/CampagneVote.java

@@ -1,84 +1,84 @@
-package dev.lions.unionflow.server.entity.vote;
-
-import dev.lions.unionflow.server.api.enums.vote.ModeScrutin;
-import dev.lions.unionflow.server.api.enums.vote.StatutVote;
-import dev.lions.unionflow.server.api.enums.vote.TypeVote;
-import dev.lions.unionflow.server.entity.BaseEntity;
-import dev.lions.unionflow.server.entity.Organisation;
-
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.*;
-
-import java.time.LocalDateTime;
-import java.util.ArrayList;
-import java.util.List;
-
-@Entity
-@Table(name = "campagnes_vote", indexes = {
-        @Index(name = "idx_vote_orga", columnList = "organisation_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-public class CampagneVote extends BaseEntity {
-
-    @NotBlank
-    @Column(name = "titre", nullable = false, length = 200)
-    private String titre;
-
-    @Column(name = "description", columnDefinition = "TEXT")
-    private String descriptionOuResolution;
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "organisation_id", nullable = false)
-    private Organisation organisation;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "type_vote", nullable = false, length = 50)
-    private TypeVote typeVote;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "mode_scrutin", nullable = false, length = 50)
-    private ModeScrutin modeScrutin;
-
-    @NotNull
-    @Enumerated(EnumType.STRING)
-    @Column(name = "statut", nullable = false, length = 50)
-    @Builder.Default
-    private StatutVote statut = StatutVote.BROUILLON;
-
-    @NotNull
-    @Column(name = "date_ouverture", nullable = false)
-    private LocalDateTime dateOuverture;
-
-    @NotNull
-    @Column(name = "date_fermeture", nullable = false)
-    private LocalDateTime dateFermeture;
-
-    @Column(name = "restreindre_membres_ajour", nullable = false)
-    @Builder.Default
-    private Boolean restreindreMembresAJour = true;
-
-    @Column(name = "autoriser_vote_blanc", nullable = false)
-    @Builder.Default
-    private Boolean autoriserVoteBlanc = true;
-
-    @Column(name = "total_electeurs")
-    private Integer totalElecteursInscrits;
-
-    @Column(name = "total_votants")
-    private Integer totalVotantsEffectifs;
-
-    @Column(name = "total_blancs_nuls")
-    private Integer totalVotesBlancsOuNuls;
-
-    @OneToMany(mappedBy = "campagneVote", cascade = CascadeType.ALL, orphanRemoval = true)
-    @Builder.Default
-    private List<Candidat> candidats = new ArrayList<>();
-}
+package dev.lions.unionflow.server.entity.vote;
+
+import dev.lions.unionflow.server.api.enums.vote.ModeScrutin;
+import dev.lions.unionflow.server.api.enums.vote.StatutVote;
+import dev.lions.unionflow.server.api.enums.vote.TypeVote;
+import dev.lions.unionflow.server.entity.BaseEntity;
+import dev.lions.unionflow.server.entity.Organisation;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name = "campagnes_vote", indexes = {
+        @Index(name = "idx_vote_orga", columnList = "organisation_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class CampagneVote extends BaseEntity {
+
+    @NotBlank
+    @Column(name = "titre", nullable = false, length = 200)
+    private String titre;
+
+    @Column(name = "description", columnDefinition = "TEXT")
+    private String descriptionOuResolution;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "organisation_id", nullable = false)
+    private Organisation organisation;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "type_vote", nullable = false, length = 50)
+    private TypeVote typeVote;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "mode_scrutin", nullable = false, length = 50)
+    private ModeScrutin modeScrutin;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "statut", nullable = false, length = 50)
+    @Builder.Default
+    private StatutVote statut = StatutVote.BROUILLON;
+
+    @NotNull
+    @Column(name = "date_ouverture", nullable = false)
+    private LocalDateTime dateOuverture;
+
+    @NotNull
+    @Column(name = "date_fermeture", nullable = false)
+    private LocalDateTime dateFermeture;
+
+    @Column(name = "restreindre_membres_ajour", nullable = false)
+    @Builder.Default
+    private Boolean restreindreMembresAJour = true;
+
+    @Column(name = "autoriser_vote_blanc", nullable = false)
+    @Builder.Default
+    private Boolean autoriserVoteBlanc = true;
+
+    @Column(name = "total_electeurs")
+    private Integer totalElecteursInscrits;
+
+    @Column(name = "total_votants")
+    private Integer totalVotantsEffectifs;
+
+    @Column(name = "total_blancs_nuls")
+    private Integer totalVotesBlancsOuNuls;
+
+    @OneToMany(mappedBy = "campagneVote", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
+    private List<Candidat> candidats = new ArrayList<>();
+}

src/main/java/dev/lions/unionflow/server/entity/vote/Candidat.java

@@ -1,45 +1,45 @@
-package dev.lions.unionflow.server.entity.vote;
-
-import dev.lions.unionflow.server.entity.BaseEntity;
-import jakarta.persistence.*;
-import jakarta.validation.constraints.NotBlank;
-import lombok.*;
-import java.math.BigDecimal;
-
-@Entity
-@Table(name = "candidats", indexes = {
-        @Index(name = "idx_candidat_campagne", columnList = "campagne_vote_id")
-})
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-@EqualsAndHashCode(callSuper = true)
-@ToString(exclude = "campagneVote")
-public class Candidat extends BaseEntity {
-
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "campagne_vote_id", nullable = false)
-    private CampagneVote campagneVote;
-
-    @NotBlank
-    @Column(name = "nom_candidature", nullable = false, length = 150)
-    private String nomCandidatureOuChoix;
-
-    @Column(name = "membre_associe_id", length = 36)
-    private String membreIdAssocie;
-
-    @Column(name = "profession_foi", columnDefinition = "TEXT")
-    private String professionDeFoi;
-
-    @Column(name = "photo_url", length = 500)
-    private String photoUrl;
-
-    @Column(name = "nombre_voix")
-    @Builder.Default
-    private Integer nombreDeVoix = 0;
-
-    @Column(name = "pourcentage", precision = 5, scale = 2)
-    @Builder.Default
-    private BigDecimal pourcentageObtenu = BigDecimal.ZERO;
-}
+package dev.lions.unionflow.server.entity.vote;
+
+import dev.lions.unionflow.server.entity.BaseEntity;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotBlank;
+import lombok.*;
+import java.math.BigDecimal;
+
+@Entity
+@Table(name = "candidats", indexes = {
+        @Index(name = "idx_candidat_campagne", columnList = "campagne_vote_id")
+})
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+@ToString(exclude = "campagneVote")
+public class Candidat extends BaseEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "campagne_vote_id", nullable = false)
+    private CampagneVote campagneVote;
+
+    @NotBlank
+    @Column(name = "nom_candidature", nullable = false, length = 150)
+    private String nomCandidatureOuChoix;
+
+    @Column(name = "membre_associe_id", length = 36)
+    private String membreIdAssocie;
+
+    @Column(name = "profession_foi", columnDefinition = "TEXT")
+    private String professionDeFoi;
+
+    @Column(name = "photo_url", length = 500)
+    private String photoUrl;
+
+    @Column(name = "nombre_voix")
+    @Builder.Default
+    private Integer nombreDeVoix = 0;
+
+    @Column(name = "pourcentage", precision = 5, scale = 2)
+    @Builder.Default
+    private BigDecimal pourcentageObtenu = BigDecimal.ZERO;
+}

src/main/java/dev/lions/unionflow/server/exception/GlobalExceptionMapper.java

@@ -98,7 +98,9 @@ public class GlobalExceptionMapper implements ExceptionMapper<Throwable> {
         return exception instanceof NotFoundException
                 || exception instanceof ForbiddenException
                 || exception instanceof NotAuthorizedException
-                || exception instanceof NotAllowedException;
+                || exception instanceof NotAllowedException
+                || exception instanceof IllegalArgumentException
+                || exception instanceof IllegalStateException;
     }
 
     private int determineStatusCode(Throwable exception) {