Configure Maven repository for unionflow-server-api dependency

2025-12-10 01:08:17 +00:00
commit 4a0c5f9d33
320 changed files with 33373 additions and 0 deletions
--- a/src/main/java/dev/lions/unionflow/server/entity/Paiement.java
+++ b/src/main/java/dev/lions/unionflow/server/entity/Paiement.java
@@ -0,0 +1,169 @@
+package dev.lions.unionflow.server.entity;
+
+import dev.lions.unionflow.server.api.enums.paiement.MethodePaiement;
+import dev.lions.unionflow.server.api.enums.paiement.StatutPaiement;
+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é Paiement centralisée pour tous les types de paiements
+ * Réutilisable pour cotisations, adhésions, événements, aides
+ *
+ * @author UnionFlow Team
+ * @version 3.0
+ * @since 2025-01-29
+ */
+@Entity
+@Table(
+    name = "paiements",
+    indexes = {
+      @Index(name = "idx_paiement_numero_reference", columnList = "numero_reference", unique = true),
+      @Index(name = "idx_paiement_membre", columnList = "membre_id"),
+      @Index(name = "idx_paiement_statut", columnList = "statut_paiement"),
+      @Index(name = "idx_paiement_methode", columnList = "methode_paiement"),
+      @Index(name = "idx_paiement_date", columnList = "date_paiement")
+    })
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@EqualsAndHashCode(callSuper = true)
+public class Paiement extends BaseEntity {
+
+  /** Numéro de référence unique */
+  @NotBlank
+  @Column(name = "numero_reference", unique = true, nullable = false, length = 50)
+  private String numeroReference;
+
+  /** Montant du paiement */
+  @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;
+
+  /** Code devise (ISO 3 lettres) */
+  @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;
+
+  /** Méthode de paiement */
+  @NotNull
+  @Enumerated(EnumType.STRING)
+  @Column(name = "methode_paiement", nullable = false, length = 50)
+  private MethodePaiement methodePaiement;
+
+  /** Statut du paiement */
+  @NotNull
+  @Enumerated(EnumType.STRING)
+  @Builder.Default
+  @Column(name = "statut_paiement", nullable = false, length = 30)
+  private StatutPaiement statutPaiement = StatutPaiement.EN_ATTENTE;
+
+  /** Date de paiement */
+  @Column(name = "date_paiement")
+  private LocalDateTime datePaiement;
+
+  /** Date de validation */
+  @Column(name = "date_validation")
+  private LocalDateTime dateValidation;
+
+  /** Validateur (email de l'administrateur) */
+  @Column(name = "validateur", length = 255)
+  private String validateur;
+
+  /** Référence externe (numéro transaction, URL preuve, etc.) */
+  @Column(name = "reference_externe", length = 500)
+  private String referenceExterne;
+
+  /** URL de preuve de paiement */
+  @Column(name = "url_preuve", length = 1000)
+  private String urlPreuve;
+
+  /** Commentaires et notes */
+  @Column(name = "commentaire", length = 1000)
+  private String commentaire;
+
+  /** Adresse IP de l'initiateur */
+  @Column(name = "ip_address", length = 45)
+  private String ipAddress;
+
+  /** User-Agent de l'initiateur */
+  @Column(name = "user_agent", length = 500)
+  private String userAgent;
+
+  /** Membre payeur */
+  @NotNull
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "membre_id", nullable = false)
+  private Membre membre;
+
+  /** Relations avec les tables de liaison */
+  @OneToMany(mappedBy = "paiement", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<PaiementCotisation> paiementsCotisation = new ArrayList<>();
+
+  @OneToMany(mappedBy = "paiement", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<PaiementAdhesion> paiementsAdhesion = new ArrayList<>();
+
+  @OneToMany(mappedBy = "paiement", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<PaiementEvenement> paiementsEvenement = new ArrayList<>();
+
+  @OneToMany(mappedBy = "paiement", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
+  @Builder.Default
+  private List<PaiementAide> paiementsAide = new ArrayList<>();
+
+  /** Relation avec TransactionWave (optionnelle) */
+  @ManyToOne(fetch = FetchType.LAZY)
+  @JoinColumn(name = "transaction_wave_id")
+  private TransactionWave transactionWave;
+
+  /** Méthode métier pour générer un numéro de référence unique */
+  public static String genererNumeroReference() {
+    return "PAY-"
+        + LocalDateTime.now().getYear()
+        + "-"
+        + String.format("%012d", System.currentTimeMillis() % 1000000000000L);
+  }
+
+  /** Méthode métier pour vérifier si le paiement est validé */
+  public boolean isValide() {
+    return StatutPaiement.VALIDE.equals(statutPaiement);
+  }
+
+  /** Méthode métier pour vérifier si le paiement peut être modifié */
+  public boolean peutEtreModifie() {
+    return !statutPaiement.isFinalise();
+  }
+
+  /** Callback JPA avant la persistance */
+  @PrePersist
+  protected void onCreate() {
+    super.onCreate();
+    if (numeroReference == null || numeroReference.isEmpty()) {
+      numeroReference = genererNumeroReference();
+    }
+    if (codeDevise == null || codeDevise.isEmpty()) {
+      codeDevise = "XOF";
+    }
+    if (statutPaiement == null) {
+      statutPaiement = StatutPaiement.EN_ATTENTE;
+    }
+    if (datePaiement == null) {
+      datePaiement = LocalDateTime.now();
+    }
+  }
+}
+