Sync: code local unifié

Synchronisation du code source local (fait foi).

Signed-off-by: lions dev Team

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

@@ -1,14 +1,13 @@
 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.LocalDateTime;
 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;
@@ -16,7 +15,8 @@ import lombok.EqualsAndHashCode;
 import lombok.NoArgsConstructor;
 
 /**
- * Entité Organisation avec UUID Représente une organisation (Lions Club, Association,
+ * Entité Organisation avec UUID Représente une organisation (Lions Club,
+ * Association,
  * Coopérative, etc.)
  *
  * @author UnionFlow Team
@@ -24,21 +24,14 @@ import lombok.NoArgsConstructor;
  * @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_ville", columnList = "ville"),
-      @Index(name = "idx_organisation_pays", columnList = "pays"),
-      @Index(name = "idx_organisation_parente", columnList = "organisation_parente_id"),
-      @Index(
-          name = "idx_organisation_numero_enregistrement",
-          columnList = "numero_enregistrement",
-          unique = true)
-    })
+@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
@@ -86,22 +79,22 @@ public class Organisation extends BaseEntity {
   @Column(name = "email_secondaire", length = 255)
   private String emailSecondaire;
 
-  // Adresse
+  // 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 = "code_postal", length = 20)
-  private String codePostal;
-
   @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")
@@ -125,14 +118,32 @@ public class Organisation extends BaseEntity {
   @Column(name = "reseaux_sociaux", length = 1000)
   private String reseauxSociaux;
 
-  // Hiérarchie
-  @Column(name = "organisation_parente_id")
-  private UUID organisationParenteId;
+  // ── 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)
@@ -187,14 +198,19 @@ public class Organisation extends BaseEntity {
   private Boolean accepteNouveauxMembres = true;
 
   // Relations
+
+  /** Adhésions des membres à cette organisation */
+  @JsonIgnore
   @OneToMany(mappedBy = "organisation", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
   @Builder.Default
-  private List<Membre> membres = new ArrayList<>();
+  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<>();
@@ -215,7 +231,9 @@ public class Organisation extends BaseEntity {
     return Period.between(dateFondation, LocalDate.now()).getYears();
   }
 
-  /** Méthode métier pour vérifier si l'organisation est récente (moins de 2 ans) */
+  /**
+   * Méthode métier pour vérifier si l'organisation est récente (moins de 2 ans)
+   */
   public boolean isRecente() {
     return getAncienneteAnnees() < 2;
   }
@@ -262,17 +280,6 @@ public class Organisation extends BaseEntity {
     marquerCommeModifie(utilisateur);
   }
 
-  /** Marque l'entité comme modifiée */
-  public void marquerCommeModifie(String utilisateur) {
-    this.setDateModification(LocalDateTime.now());
-    this.setModifiePar(utilisateur);
-    if (this.getVersion() != null) {
-      this.setVersion(this.getVersion() + 1);
-    } else {
-      this.setVersion(1L);
-    }
-  }
-
   /** Callback JPA avant la persistance */
   @PrePersist
   protected void onCreate() {
@@ -289,6 +296,9 @@ public class Organisation extends BaseEntity {
     if (niveauHierarchique == null) {
       niveauHierarchique = 0;
     }
+    if (estOrganisationRacine == null) {
+      estOrganisationRacine = (organisationParente == null);
+    }
     if (nombreMembres == null) {
       nombreMembres = 0;
     }