feat(versement): nouveau module Versement (paiements rattachés à des objets)
- Entités : Versement, VersementObjet (lien polymorphique vers cotisation/adhesion/etc.) - VersementRepository : requêtes par membre, org, période - VersementResource : endpoints REST /api/versements - VersementService : logique métier (validation, rattachement objets) - Migration V27 : ajout numeroTelephone sur versements
This commit is contained in:
dahoud
171
src/main/java/dev/lions/unionflow/server/entity/Versement.java
Normal file
171
src/main/java/dev/lions/unionflow/server/entity/Versement.java
Normal file
@@ -0,0 +1,171 @@
|
||||
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.concurrent.atomic.AtomicLong;
|
||||
import lombok.*;
|
||||
|
||||
/**
|
||||
* Versement — acte de régler une cotisation ou de déposer des fonds.
|
||||
*
|
||||
* <p>Un versement peut être effectué :
|
||||
* <ul>
|
||||
* <li>Via <b>Wave Mobile Money</b> : deep link natif, app Wave sur le même téléphone</li>
|
||||
* <li>Manuellement : espèces, virement, chèque → statut EN_ATTENTE_VALIDATION</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>Table DB : {@code paiements} (nom hérité, conservé pour compatibilité Flyway).
|
||||
*
|
||||
* @author UnionFlow Team
|
||||
* @version 4.0
|
||||
* @since 2026-04-13
|
||||
*/
|
||||
@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 Versement extends BaseEntity {
|
||||
|
||||
private static final AtomicLong REFERENCE_COUNTER =
|
||||
new AtomicLong(System.currentTimeMillis() % 1_000_000_000_000L);
|
||||
|
||||
// ── Identité ──────────────────────────────────────────────────────────────
|
||||
|
||||
/** Référence unique (ex: VRS-2026-XXXXXXXXXXXX) */
|
||||
@NotBlank
|
||||
@Column(name = "numero_reference", unique = true, nullable = false, length = 50)
|
||||
private String numeroReference;
|
||||
|
||||
// ── Montant ───────────────────────────────────────────────────────────────
|
||||
|
||||
@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;
|
||||
|
||||
@NotBlank
|
||||
@Pattern(regexp = "^[A-Z]{3}$", message = "Code devise ISO à 3 lettres requis")
|
||||
@Column(name = "code_devise", nullable = false, length = 3)
|
||||
private String codeDevise;
|
||||
|
||||
// ── Méthode & Statut ──────────────────────────────────────────────────────
|
||||
|
||||
/** WAVE | ESPECES | VIREMENT | CHEQUE | AUTRE */
|
||||
@NotNull
|
||||
@Column(name = "methode_paiement", nullable = false, length = 50)
|
||||
private String methodePaiement;
|
||||
|
||||
/** EN_ATTENTE | EN_COURS | CONFIRME | ECHEC | EN_ATTENTE_VALIDATION | ANNULE */
|
||||
@NotNull
|
||||
@Builder.Default
|
||||
@Column(name = "statut_paiement", nullable = false, length = 30)
|
||||
private String statutPaiement = "EN_ATTENTE";
|
||||
|
||||
// ── Dates ─────────────────────────────────────────────────────────────────
|
||||
|
||||
@Column(name = "date_paiement")
|
||||
private LocalDateTime datePaiement;
|
||||
|
||||
@Column(name = "date_validation")
|
||||
private LocalDateTime dateValidation;
|
||||
|
||||
// ── Validation ────────────────────────────────────────────────────────────
|
||||
|
||||
@Column(name = "validateur", length = 255)
|
||||
private String validateur;
|
||||
|
||||
// ── Traçabilité ───────────────────────────────────────────────────────────
|
||||
|
||||
/** ID transaction Wave (TCN...) ou référence chèque / bordereau */
|
||||
@Column(name = "reference_externe", length = 500)
|
||||
private String referenceExterne;
|
||||
|
||||
@Column(name = "url_preuve", length = 1000)
|
||||
private String urlPreuve;
|
||||
|
||||
@Column(name = "commentaire", length = 1000)
|
||||
private String commentaire;
|
||||
|
||||
@Column(name = "ip_address", length = 45)
|
||||
private String ipAddress;
|
||||
|
||||
@Column(name = "user_agent", length = 500)
|
||||
private String userAgent;
|
||||
|
||||
// ── Téléphone Wave ────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Numéro de téléphone Wave utilisé pour ce versement.
|
||||
* Pré-rempli depuis le profil du membre (même téléphone qu'UnionFlow),
|
||||
* modifiable à l'étape "Récapitulatif" avant de tapper "Payer".
|
||||
*/
|
||||
@Column(name = "numero_telephone", length = 20)
|
||||
private String numeroTelephone;
|
||||
|
||||
// ── Relations ─────────────────────────────────────────────────────────────
|
||||
|
||||
@NotNull
|
||||
@ManyToOne(fetch = FetchType.LAZY)
|
||||
@JoinColumn(name = "membre_id", nullable = false)
|
||||
private Membre membre;
|
||||
|
||||
@JsonIgnore
|
||||
@OneToMany(mappedBy = "versement", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
|
||||
@Builder.Default
|
||||
private List<VersementObjet> versementsObjets = new ArrayList<>();
|
||||
|
||||
@ManyToOne(fetch = FetchType.LAZY)
|
||||
@JoinColumn(name = "transaction_wave_id")
|
||||
private TransactionWave transactionWave;
|
||||
|
||||
// ── Méthodes métier ───────────────────────────────────────────────────────
|
||||
|
||||
/** Génère une référence unique : VRS-YYYY-XXXXXXXXXXXX */
|
||||
public static String genererNumeroReference() {
|
||||
return "VRS-"
|
||||
+ LocalDateTime.now().getYear()
|
||||
+ "-"
|
||||
+ String.format("%012d", REFERENCE_COUNTER.incrementAndGet() % 1_000_000_000_000L);
|
||||
}
|
||||
|
||||
/** Vrai si le versement est confirmé (Wave) ou validé (manuel) */
|
||||
public boolean isConfirme() {
|
||||
return "CONFIRME".equals(statutPaiement) || "VALIDE".equals(statutPaiement);
|
||||
}
|
||||
|
||||
/** Vrai si le versement peut encore être modifié ou annulé */
|
||||
public boolean peutEtreModifie() {
|
||||
return !"CONFIRME".equals(statutPaiement)
|
||||
&& !"VALIDE".equals(statutPaiement)
|
||||
&& !"ANNULE".equals(statutPaiement);
|
||||
}
|
||||
|
||||
@PrePersist
|
||||
protected void onCreate() {
|
||||
super.onCreate();
|
||||
if (numeroReference == null || numeroReference.isBlank()) {
|
||||
numeroReference = genererNumeroReference();
|
||||
}
|
||||
if (statutPaiement == null) {
|
||||
statutPaiement = "EN_ATTENTE";
|
||||
}
|
||||
if (datePaiement == null) {
|
||||
datePaiement = LocalDateTime.now();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,82 @@
|
||||
package dev.lions.unionflow.server.entity;
|
||||
|
||||
import jakarta.persistence.*;
|
||||
import jakarta.validation.constraints.*;
|
||||
import java.math.BigDecimal;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.UUID;
|
||||
import lombok.*;
|
||||
|
||||
/**
|
||||
* Liaison polymorphique entre un versement et son objet cible.
|
||||
*
|
||||
* <p>Remplace les 4 tables dupliquées (paiements_cotisations, paiements_adhesions,
|
||||
* paiements_evenements, paiements_aides) par une table unique utilisant le pattern
|
||||
* {@code (typeObjetCible, objetCibleId)}.
|
||||
*
|
||||
* <p>Table DB : {@code paiements_objets} (nom hérité, conservé pour compatibilité Flyway).
|
||||
*
|
||||
* @author UnionFlow Team
|
||||
* @version 4.0
|
||||
* @since 2026-04-13
|
||||
*/
|
||||
@Entity
|
||||
@Table(name = "paiements_objets", indexes = {
|
||||
@Index(name = "idx_po_paiement", columnList = "paiement_id"),
|
||||
@Index(name = "idx_po_objet", columnList = "type_objet_cible, objet_cible_id"),
|
||||
@Index(name = "idx_po_type", columnList = "type_objet_cible")
|
||||
}, uniqueConstraints = {
|
||||
@UniqueConstraint(name = "uk_paiement_objet", columnNames = {
|
||||
"paiement_id", "type_objet_cible", "objet_cible_id"
|
||||
})
|
||||
})
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
@Builder
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
public class VersementObjet extends BaseEntity {
|
||||
|
||||
/** Versement parent. */
|
||||
@NotNull
|
||||
@ManyToOne(fetch = FetchType.LAZY)
|
||||
@JoinColumn(name = "paiement_id", nullable = false)
|
||||
private Versement versement;
|
||||
|
||||
/**
|
||||
* Type de l'objet cible (domaine {@code OBJET_PAIEMENT}).
|
||||
* Valeurs : COTISATION | ADHESION | EVENEMENT | AIDE.
|
||||
*/
|
||||
@NotBlank
|
||||
@Size(max = 50)
|
||||
@Column(name = "type_objet_cible", nullable = false, length = 50)
|
||||
private String typeObjetCible;
|
||||
|
||||
/** UUID de l'objet cible (cotisation, adhésion, inscription, aide). */
|
||||
@NotNull
|
||||
@Column(name = "objet_cible_id", nullable = false)
|
||||
private UUID objetCibleId;
|
||||
|
||||
/** Montant affecté à cet objet cible. */
|
||||
@NotNull
|
||||
@DecimalMin(value = "0.0", message = "Le montant doit être positif")
|
||||
@Digits(integer = 12, fraction = 2)
|
||||
@Column(name = "montant_applique", nullable = false, precision = 14, scale = 2)
|
||||
private BigDecimal montantApplique;
|
||||
|
||||
@Column(name = "date_application")
|
||||
private LocalDateTime dateApplication;
|
||||
|
||||
@Size(max = 500)
|
||||
@Column(name = "commentaire", length = 500)
|
||||
private String commentaire;
|
||||
|
||||
@Override
|
||||
@PrePersist
|
||||
protected void onCreate() {
|
||||
super.onCreate();
|
||||
if (dateApplication == null) {
|
||||
dateApplication = LocalDateTime.now();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,79 @@
|
||||
package dev.lions.unionflow.server.repository;
|
||||
|
||||
import dev.lions.unionflow.server.api.enums.paiement.MethodePaiement;
|
||||
import dev.lions.unionflow.server.api.enums.paiement.StatutPaiement;
|
||||
import dev.lions.unionflow.server.entity.Versement;
|
||||
import io.quarkus.hibernate.orm.panache.PanacheRepositoryBase;
|
||||
import io.quarkus.panache.common.Sort;
|
||||
import jakarta.enterprise.context.ApplicationScoped;
|
||||
import java.math.BigDecimal;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.List;
|
||||
import java.util.Optional;
|
||||
import java.util.UUID;
|
||||
|
||||
/**
|
||||
* Repository pour l'entité {@link Versement}.
|
||||
*
|
||||
* @author UnionFlow Team
|
||||
* @version 4.0
|
||||
* @since 2026-04-13
|
||||
*/
|
||||
@ApplicationScoped
|
||||
public class VersementRepository implements PanacheRepositoryBase<Versement, UUID> {
|
||||
|
||||
/** Trouve un versement actif par UUID. */
|
||||
public Optional<Versement> findVersementById(UUID id) {
|
||||
return find("id = ?1 AND actif = true", id).firstResultOptional();
|
||||
}
|
||||
|
||||
/** Trouve un versement par son numéro de référence. */
|
||||
public Optional<Versement> findByNumeroReference(String numeroReference) {
|
||||
return find("numeroReference", numeroReference).firstResultOptional();
|
||||
}
|
||||
|
||||
/** Liste tous les versements actifs d'un membre, les plus récents d'abord. */
|
||||
public List<Versement> findByMembreId(UUID membreId) {
|
||||
return find(
|
||||
"membre.id = ?1 AND actif = true",
|
||||
Sort.by("datePaiement", Sort.Direction.Descending),
|
||||
membreId
|
||||
).list();
|
||||
}
|
||||
|
||||
/** Liste les versements par statut. */
|
||||
public List<Versement> findByStatut(StatutPaiement statut) {
|
||||
return find(
|
||||
"statutPaiement = ?1 AND actif = true",
|
||||
Sort.by("datePaiement", Sort.Direction.Descending),
|
||||
statut.name()
|
||||
).list();
|
||||
}
|
||||
|
||||
/** Liste les versements par méthode. */
|
||||
public List<Versement> findByMethode(MethodePaiement methode) {
|
||||
return find(
|
||||
"methodePaiement = ?1 AND actif = true",
|
||||
Sort.by("datePaiement", Sort.Direction.Descending),
|
||||
methode.name()
|
||||
).list();
|
||||
}
|
||||
|
||||
/** Liste les versements confirmés dans une période donnée. */
|
||||
public List<Versement> findConfirmesParPeriode(LocalDateTime dateDebut, LocalDateTime dateFin) {
|
||||
return find(
|
||||
"statutPaiement IN ('CONFIRME', 'VALIDE') "
|
||||
+ "AND dateValidation >= ?1 AND dateValidation <= ?2 AND actif = true",
|
||||
Sort.by("dateValidation", Sort.Direction.Descending),
|
||||
dateDebut,
|
||||
dateFin
|
||||
).list();
|
||||
}
|
||||
|
||||
/** Calcule le montant total des versements confirmés dans une période. */
|
||||
public BigDecimal calculerMontantTotalConfirmes(LocalDateTime dateDebut, LocalDateTime dateFin) {
|
||||
return findConfirmesParPeriode(dateDebut, dateFin).stream()
|
||||
.map(Versement::getMontant)
|
||||
.reduce(BigDecimal.ZERO, BigDecimal::add);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,170 @@
|
||||
package dev.lions.unionflow.server.resource;
|
||||
|
||||
import dev.lions.unionflow.server.api.dto.versement.request.DeclarerVersementManuelRequest;
|
||||
import dev.lions.unionflow.server.api.dto.versement.request.InitierDepotEpargneRequest;
|
||||
import dev.lions.unionflow.server.api.dto.versement.request.InitierVersementWaveRequest;
|
||||
import dev.lions.unionflow.server.api.dto.versement.response.VersementGatewayResponse;
|
||||
import dev.lions.unionflow.server.api.dto.versement.response.VersementResponse;
|
||||
import dev.lions.unionflow.server.api.dto.versement.response.VersementStatutResponse;
|
||||
import dev.lions.unionflow.server.api.dto.versement.response.VersementSummaryResponse;
|
||||
import dev.lions.unionflow.server.service.VersementService;
|
||||
import jakarta.annotation.security.RolesAllowed;
|
||||
import jakarta.inject.Inject;
|
||||
import jakarta.validation.Valid;
|
||||
import jakarta.ws.rs.*;
|
||||
import jakarta.ws.rs.core.MediaType;
|
||||
import jakarta.ws.rs.core.Response;
|
||||
import java.util.List;
|
||||
import java.util.UUID;
|
||||
import org.eclipse.microprofile.openapi.annotations.tags.Tag;
|
||||
import org.jboss.logging.Logger;
|
||||
|
||||
/**
|
||||
* Resource REST pour la gestion des versements.
|
||||
*
|
||||
* <p>Endpoints principaux :
|
||||
* <ul>
|
||||
* <li>{@code POST /api/versements/initier-wave} — démarre le flux Wave deep link</li>
|
||||
* <li>{@code GET /api/versements/statut/{intentionId}} — retour deep link / polling</li>
|
||||
* <li>{@code POST /api/versements/declarer-manuel} — déclaration espèces/virement/chèque</li>
|
||||
* <li>{@code GET /api/versements/mes-versements} — historique du membre connecté</li>
|
||||
* </ul>
|
||||
*
|
||||
* @author UnionFlow Team
|
||||
* @version 4.0
|
||||
* @since 2026-04-13
|
||||
*/
|
||||
@Path("/api/versements")
|
||||
@Produces(MediaType.APPLICATION_JSON)
|
||||
@Consumes(MediaType.APPLICATION_JSON)
|
||||
@RolesAllowed({"ADMIN", "ADMIN_ORGANISATION", "MEMBRE", "USER"})
|
||||
@Tag(name = "Versements", description = "Versements de cotisations — Wave et manuel")
|
||||
public class VersementResource {
|
||||
|
||||
private static final Logger LOG = Logger.getLogger(VersementResource.class);
|
||||
|
||||
@Inject
|
||||
VersementService versementService;
|
||||
|
||||
// ── Lecture ───────────────────────────────────────────────────────────────
|
||||
|
||||
@GET
|
||||
@Path("/{id}")
|
||||
public Response trouverParId(@PathParam("id") UUID id) {
|
||||
LOG.infof("GET /api/versements/%s", id);
|
||||
VersementResponse result = versementService.trouverParId(id);
|
||||
return Response.ok(result).build();
|
||||
}
|
||||
|
||||
@GET
|
||||
@Path("/reference/{numeroReference}")
|
||||
public Response trouverParNumeroReference(
|
||||
@PathParam("numeroReference") String numeroReference) {
|
||||
LOG.infof("GET /api/versements/reference/%s", numeroReference);
|
||||
VersementResponse result = versementService.trouverParNumeroReference(numeroReference);
|
||||
return Response.ok(result).build();
|
||||
}
|
||||
|
||||
@GET
|
||||
@Path("/membre/{membreId}")
|
||||
public Response listerParMembre(@PathParam("membreId") UUID membreId) {
|
||||
LOG.infof("GET /api/versements/membre/%s", membreId);
|
||||
List<VersementSummaryResponse> result = versementService.listerParMembre(membreId);
|
||||
return Response.ok(result).build();
|
||||
}
|
||||
|
||||
@GET
|
||||
@Path("/mes-versements")
|
||||
@RolesAllowed({"MEMBRE", "ADMIN", "ADMIN_ORGANISATION"})
|
||||
public Response getMesVersements(
|
||||
@QueryParam("limit") @DefaultValue("20") int limit) {
|
||||
LOG.infof("GET /api/versements/mes-versements?limit=%d", limit);
|
||||
List<VersementSummaryResponse> result = versementService.getMesVersements(limit);
|
||||
return Response.ok(result).build();
|
||||
}
|
||||
|
||||
// ── Validation / Annulation ───────────────────────────────────────────────
|
||||
|
||||
@POST
|
||||
@Path("/{id}/valider")
|
||||
@RolesAllowed({"ADMIN", "ADMIN_ORGANISATION"})
|
||||
public Response validerVersement(@PathParam("id") UUID id) {
|
||||
LOG.infof("POST /api/versements/%s/valider", id);
|
||||
VersementResponse result = versementService.validerVersement(id);
|
||||
return Response.ok(result).build();
|
||||
}
|
||||
|
||||
@POST
|
||||
@Path("/{id}/annuler")
|
||||
@RolesAllowed({"ADMIN", "ADMIN_ORGANISATION", "MEMBRE"})
|
||||
public Response annulerVersement(@PathParam("id") UUID id) {
|
||||
LOG.infof("POST /api/versements/%s/annuler", id);
|
||||
VersementResponse result = versementService.annulerVersement(id);
|
||||
return Response.ok(result).build();
|
||||
}
|
||||
|
||||
// ── Flux Wave ─────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Initie un versement Wave.
|
||||
*
|
||||
* <p>Le mobile appelle cet endpoint puis ouvre le {@code waveLaunchUrl} retourné
|
||||
* avec {@code url_launcher}. Wave s'ouvre avec le montant et le numéro pré-remplis.
|
||||
* Après confirmation, Wave redirige vers
|
||||
* {@code unionflow://payment?result=success&ref={clientReference}}.
|
||||
*/
|
||||
@POST
|
||||
@Path("/initier-wave")
|
||||
@RolesAllowed({"MEMBRE", "MEMBRE_ACTIF", "ADMIN", "ADMIN_ORGANISATION", "USER"})
|
||||
public Response initierVersementWave(@Valid InitierVersementWaveRequest request) {
|
||||
LOG.infof("POST /api/versements/initier-wave — cotisation: %s", request.cotisationId());
|
||||
VersementGatewayResponse result = versementService.initierVersementWave(request);
|
||||
return Response.status(Response.Status.CREATED).entity(result).build();
|
||||
}
|
||||
|
||||
/**
|
||||
* Retour deep link / polling du statut d'un versement Wave.
|
||||
*
|
||||
* <p>Appelé par le mobile au retour du deep link
|
||||
* {@code unionflow://payment?result=success&ref={intentionId}}
|
||||
* pour confirmer que le paiement est bien enregistré côté UnionFlow.
|
||||
* Également utilisé par le web en polling toutes les 3 secondes.
|
||||
*/
|
||||
@GET
|
||||
@Path("/statut/{intentionId}")
|
||||
@RolesAllowed({"MEMBRE", "MEMBRE_ACTIF", "ADMIN", "ADMIN_ORGANISATION", "USER"})
|
||||
public Response getStatutVersement(@PathParam("intentionId") UUID intentionId) {
|
||||
LOG.infof("GET /api/versements/statut/%s", intentionId);
|
||||
VersementStatutResponse result = versementService.verifierStatutVersement(intentionId);
|
||||
return Response.ok(result).build();
|
||||
}
|
||||
|
||||
// ── Flux manuel ───────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Déclare un versement manuel (espèces, virement, chèque).
|
||||
* Le versement est créé avec le statut EN_ATTENTE_VALIDATION.
|
||||
* Le trésorier devra le valider via la page admin.
|
||||
*/
|
||||
@POST
|
||||
@Path("/declarer-manuel")
|
||||
@RolesAllowed({"MEMBRE", "ADMIN", "ADMIN_ORGANISATION"})
|
||||
public Response declarerVersementManuel(@Valid DeclarerVersementManuelRequest request) {
|
||||
LOG.infof("POST /api/versements/declarer-manuel — cotisation: %s, méthode: %s",
|
||||
request.cotisationId(), request.methodePaiement());
|
||||
VersementResponse result = versementService.declarerVersementManuel(request);
|
||||
return Response.status(Response.Status.CREATED).entity(result).build();
|
||||
}
|
||||
|
||||
// ── Dépôt épargne ─────────────────────────────────────────────────────────
|
||||
|
||||
@POST
|
||||
@Path("/initier-depot-epargne")
|
||||
@RolesAllowed({"MEMBRE", "MEMBRE_ACTIF", "ADMIN", "ADMIN_ORGANISATION", "USER"})
|
||||
public Response initierDepotEpargne(@Valid InitierDepotEpargneRequest request) {
|
||||
LOG.infof("POST /api/versements/initier-depot-epargne — compte: %s, montant: %s",
|
||||
request.compteId(), request.montant());
|
||||
VersementGatewayResponse result = versementService.initierDepotEpargneEnLigne(request);
|
||||
return Response.status(Response.Status.CREATED).entity(result).build();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,558 @@
|
||||
package dev.lions.unionflow.server.service;
|
||||
|
||||
import dev.lions.unionflow.server.api.dto.notification.request.CreateNotificationRequest;
|
||||
import dev.lions.unionflow.server.api.dto.versement.request.DeclarerVersementManuelRequest;
|
||||
import dev.lions.unionflow.server.api.dto.versement.request.InitierDepotEpargneRequest;
|
||||
import dev.lions.unionflow.server.api.dto.versement.request.InitierVersementWaveRequest;
|
||||
import dev.lions.unionflow.server.api.dto.versement.response.VersementGatewayResponse;
|
||||
import dev.lions.unionflow.server.api.dto.versement.response.VersementResponse;
|
||||
import dev.lions.unionflow.server.api.dto.versement.response.VersementStatutResponse;
|
||||
import dev.lions.unionflow.server.api.dto.versement.response.VersementSummaryResponse;
|
||||
import dev.lions.unionflow.server.api.enums.paiement.StatutIntentionPaiement;
|
||||
import dev.lions.unionflow.server.api.enums.paiement.TypeObjetIntentionPaiement;
|
||||
import dev.lions.unionflow.server.entity.Cotisation;
|
||||
import dev.lions.unionflow.server.entity.IntentionPaiement;
|
||||
import dev.lions.unionflow.server.entity.Membre;
|
||||
import dev.lions.unionflow.server.entity.Versement;
|
||||
import dev.lions.unionflow.server.entity.mutuelle.epargne.CompteEpargne;
|
||||
import dev.lions.unionflow.server.repository.IntentionPaiementRepository;
|
||||
import dev.lions.unionflow.server.repository.MembreOrganisationRepository;
|
||||
import dev.lions.unionflow.server.repository.MembreRepository;
|
||||
import dev.lions.unionflow.server.repository.TypeReferenceRepository;
|
||||
import dev.lions.unionflow.server.repository.VersementRepository;
|
||||
import dev.lions.unionflow.server.repository.mutuelle.epargne.CompteEpargneRepository;
|
||||
import dev.lions.unionflow.server.service.WaveCheckoutService.WaveCheckoutException;
|
||||
import dev.lions.unionflow.server.service.WaveCheckoutService.WaveCheckoutSessionResponse;
|
||||
import jakarta.enterprise.context.ApplicationScoped;
|
||||
import jakarta.inject.Inject;
|
||||
import jakarta.transaction.Transactional;
|
||||
import jakarta.ws.rs.NotFoundException;
|
||||
import java.math.BigDecimal;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.List;
|
||||
import java.util.UUID;
|
||||
import java.util.stream.Collectors;
|
||||
import org.jboss.logging.Logger;
|
||||
|
||||
/**
|
||||
* Service métier pour la gestion des versements.
|
||||
*
|
||||
* <p>Un versement est l'acte de régler une cotisation. Deux flux sont supportés :
|
||||
* <ol>
|
||||
* <li><b>Wave</b> : deep link natif, app Wave sur le même téléphone, retour via
|
||||
* {@code unionflow://payment?result=success&ref={intentionId}}</li>
|
||||
* <li><b>Manuel</b> : déclaration espèces/virement/chèque → validation trésorier</li>
|
||||
* </ol>
|
||||
*
|
||||
* @author UnionFlow Team
|
||||
* @version 4.0
|
||||
* @since 2026-04-13
|
||||
*/
|
||||
@ApplicationScoped
|
||||
public class VersementService {
|
||||
|
||||
private static final Logger LOG = Logger.getLogger(VersementService.class);
|
||||
|
||||
@Inject VersementRepository versementRepository;
|
||||
@Inject MembreRepository membreRepository;
|
||||
@Inject KeycloakService keycloakService;
|
||||
@Inject TypeReferenceRepository typeReferenceRepository;
|
||||
@Inject IntentionPaiementRepository intentionPaiementRepository;
|
||||
@Inject WaveCheckoutService waveCheckoutService;
|
||||
@Inject CompteEpargneRepository compteEpargneRepository;
|
||||
@Inject MembreOrganisationRepository membreOrganisationRepository;
|
||||
@Inject NotificationService notificationService;
|
||||
@Inject io.quarkus.security.identity.SecurityIdentity securityIdentity;
|
||||
|
||||
// ── Lecture ───────────────────────────────────────────────────────────────
|
||||
|
||||
public VersementResponse trouverParId(UUID id) {
|
||||
return versementRepository.findVersementById(id)
|
||||
.map(this::convertToResponse)
|
||||
.orElseThrow(() -> new NotFoundException("Versement non trouvé : " + id));
|
||||
}
|
||||
|
||||
public VersementResponse trouverParNumeroReference(String numeroReference) {
|
||||
return versementRepository.findByNumeroReference(numeroReference)
|
||||
.map(this::convertToResponse)
|
||||
.orElseThrow(() -> new NotFoundException("Versement non trouvé : " + numeroReference));
|
||||
}
|
||||
|
||||
public List<VersementSummaryResponse> listerParMembre(UUID membreId) {
|
||||
return versementRepository.findByMembreId(membreId).stream()
|
||||
.map(this::convertToSummaryResponse)
|
||||
.collect(Collectors.toList());
|
||||
}
|
||||
|
||||
public BigDecimal calculerMontantTotalConfirmes(LocalDateTime dateDebut, LocalDateTime dateFin) {
|
||||
return versementRepository.calculerMontantTotalConfirmes(dateDebut, dateFin);
|
||||
}
|
||||
|
||||
/**
|
||||
* Historique des versements du membre connecté (auto-détection).
|
||||
* Retourne uniquement les versements confirmés/validés.
|
||||
*/
|
||||
public List<VersementSummaryResponse> getMesVersements(int limit) {
|
||||
Membre membreConnecte = getMembreConnecte();
|
||||
LOG.infof("Historique versements pour %s, limit=%d",
|
||||
membreConnecte.getNumeroMembre(), limit);
|
||||
|
||||
List<Versement> versements = versementRepository.getEntityManager()
|
||||
.createQuery(
|
||||
"SELECT v FROM Versement v "
|
||||
+ "WHERE v.membre.id = :membreId "
|
||||
+ "AND v.statutPaiement IN ('CONFIRME', 'VALIDE') "
|
||||
+ "ORDER BY v.datePaiement DESC",
|
||||
Versement.class)
|
||||
.setParameter("membreId", membreConnecte.getId())
|
||||
.setMaxResults(limit)
|
||||
.getResultList();
|
||||
|
||||
return versements.stream()
|
||||
.map(this::convertToSummaryResponse)
|
||||
.collect(Collectors.toList());
|
||||
}
|
||||
|
||||
// ── Validation / Annulation ───────────────────────────────────────────────
|
||||
|
||||
@Transactional
|
||||
public VersementResponse validerVersement(UUID id) {
|
||||
Versement versement = versementRepository.findVersementById(id)
|
||||
.orElseThrow(() -> new NotFoundException("Versement non trouvé : " + id));
|
||||
|
||||
if (versement.isConfirme()) {
|
||||
return convertToResponse(versement);
|
||||
}
|
||||
|
||||
versement.setStatutPaiement("CONFIRME");
|
||||
versement.setDateValidation(LocalDateTime.now());
|
||||
versement.setValidateur(keycloakService.getCurrentUserEmail());
|
||||
versement.setModifiePar(keycloakService.getCurrentUserEmail());
|
||||
versementRepository.persist(versement);
|
||||
|
||||
LOG.infof("Versement validé : %s", id);
|
||||
return convertToResponse(versement);
|
||||
}
|
||||
|
||||
@Transactional
|
||||
public VersementResponse annulerVersement(UUID id) {
|
||||
Versement versement = versementRepository.findVersementById(id)
|
||||
.orElseThrow(() -> new NotFoundException("Versement non trouvé : " + id));
|
||||
|
||||
if (!versement.peutEtreModifie()) {
|
||||
throw new IllegalStateException("Le versement ne peut plus être annulé (statut finalisé)");
|
||||
}
|
||||
|
||||
versement.setStatutPaiement("ANNULE");
|
||||
versement.setModifiePar(keycloakService.getCurrentUserEmail());
|
||||
versementRepository.persist(versement);
|
||||
|
||||
LOG.infof("Versement annulé : %s", id);
|
||||
return convertToResponse(versement);
|
||||
}
|
||||
|
||||
// ── Flux Wave ─────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Initie un versement Wave.
|
||||
*
|
||||
* <ol>
|
||||
* <li>Crée une {@link IntentionPaiement} (hub Wave interne)</li>
|
||||
* <li>Appelle l'API Wave Checkout → obtient {@code waveLaunchUrl}</li>
|
||||
* <li>Retourne {@link VersementGatewayResponse} avec {@code waveLaunchUrl}
|
||||
* pour que {@code url_launcher} ouvre Wave directement</li>
|
||||
* </ol>
|
||||
*/
|
||||
@Transactional
|
||||
public VersementGatewayResponse initierVersementWave(InitierVersementWaveRequest request) {
|
||||
Membre membreConnecte = getMembreConnecte();
|
||||
LOG.infof("Initiation versement Wave — membre %s, cotisation %s",
|
||||
membreConnecte.getNumeroMembre(), request.cotisationId());
|
||||
|
||||
Cotisation cotisation = versementRepository.getEntityManager()
|
||||
.find(Cotisation.class, request.cotisationId());
|
||||
if (cotisation == null) {
|
||||
throw new NotFoundException("Cotisation non trouvée : " + request.cotisationId());
|
||||
}
|
||||
if (!cotisation.getMembre().getId().equals(membreConnecte.getId())) {
|
||||
throw new IllegalArgumentException("Cette cotisation n'appartient pas au membre connecté");
|
||||
}
|
||||
|
||||
String base = waveCheckoutService.getRedirectBaseUrl().replaceAll("/+$", "");
|
||||
|
||||
// 1. Créer l'intention (détail interne Wave — non exposé dans l'API publique)
|
||||
IntentionPaiement intention = IntentionPaiement.builder()
|
||||
.utilisateur(membreConnecte)
|
||||
.organisation(cotisation.getOrganisation())
|
||||
.montantTotal(cotisation.getMontantDu())
|
||||
.codeDevise(cotisation.getCodeDevise() != null ? cotisation.getCodeDevise() : "XOF")
|
||||
.typeObjet(TypeObjetIntentionPaiement.COTISATION)
|
||||
.statut(StatutIntentionPaiement.INITIEE)
|
||||
.objetsCibles("[{\"type\":\"COTISATION\",\"id\":\"" + cotisation.getId()
|
||||
+ "\",\"montant\":" + cotisation.getMontantDu() + "}]")
|
||||
.build();
|
||||
intentionPaiementRepository.persist(intention);
|
||||
|
||||
// 2. URL success → deep link si mobile, page HTML si web
|
||||
boolean isMobile = request.numeroTelephone() != null && !request.numeroTelephone().isBlank();
|
||||
String successUrl = base + (isMobile
|
||||
? "/api/wave-redirect/success?ref=" + intention.getId()
|
||||
: "/api/wave-redirect/web-success?ref=" + intention.getId());
|
||||
String errorUrl = base + "/api/wave-redirect/error?ref=" + intention.getId();
|
||||
String amountStr = cotisation.getMontantDu()
|
||||
.setScale(0, java.math.RoundingMode.HALF_UP).toString();
|
||||
String restrictMobile = toE164(request.numeroTelephone());
|
||||
|
||||
// 3. Appel Wave Checkout API
|
||||
WaveCheckoutSessionResponse session;
|
||||
try {
|
||||
session = waveCheckoutService.createSession(
|
||||
amountStr, "XOF", successUrl, errorUrl,
|
||||
intention.getId().toString(), restrictMobile);
|
||||
} catch (WaveCheckoutException e) {
|
||||
LOG.errorf(e, "Wave Checkout API error : %s", e.getMessage());
|
||||
intention.setStatut(StatutIntentionPaiement.ECHOUEE);
|
||||
intentionPaiementRepository.persist(intention);
|
||||
throw new jakarta.ws.rs.BadRequestException("Wave : " + e.getMessage());
|
||||
}
|
||||
|
||||
intention.setWaveCheckoutSessionId(session.id);
|
||||
intention.setWaveLaunchUrl(session.waveLaunchUrl);
|
||||
intention.setStatut(StatutIntentionPaiement.EN_COURS);
|
||||
intentionPaiementRepository.persist(intention);
|
||||
|
||||
cotisation.setIntentionPaiement(intention);
|
||||
versementRepository.getEntityManager().merge(cotisation);
|
||||
|
||||
// 4. Créer le versement en EN_ATTENTE
|
||||
Versement versement = new Versement();
|
||||
versement.setNumeroReference("VRS-WAVE-" + intention.getId().toString().substring(0, 8).toUpperCase());
|
||||
versement.setMontant(cotisation.getMontantDu());
|
||||
versement.setCodeDevise("XOF");
|
||||
versement.setMethodePaiement("WAVE");
|
||||
versement.setStatutPaiement("EN_ATTENTE");
|
||||
versement.setMembre(membreConnecte);
|
||||
versement.setReferenceExterne(session.id);
|
||||
versement.setNumeroTelephone(request.numeroTelephone());
|
||||
versement.setCommentaire("Versement Wave — session " + session.id);
|
||||
versement.setCreePar(membreConnecte.getEmail());
|
||||
versementRepository.persist(versement);
|
||||
|
||||
LOG.infof("Versement Wave initié : intention=%s, session=%s, waveLaunchUrl=%s",
|
||||
intention.getId(), session.id, session.waveLaunchUrl);
|
||||
|
||||
return VersementGatewayResponse.builder()
|
||||
.versementId(versement.getId())
|
||||
.waveLaunchUrl(session.waveLaunchUrl)
|
||||
.waveCheckoutSessionId(session.id)
|
||||
.clientReference(intention.getId().toString())
|
||||
.montant(cotisation.getMontantDu())
|
||||
.statut("EN_ATTENTE")
|
||||
.referenceCotisation(cotisation.getNumeroReference())
|
||||
.message("Ouvrez Wave pour confirmer le versement, puis vous serez renvoyé dans UnionFlow.")
|
||||
.build();
|
||||
}
|
||||
|
||||
// ── Flux dépôt épargne ────────────────────────────────────────────────────
|
||||
|
||||
@Transactional
|
||||
public VersementGatewayResponse initierDepotEpargneEnLigne(InitierDepotEpargneRequest request) {
|
||||
Membre membreConnecte = getMembreConnecte();
|
||||
CompteEpargne compte = compteEpargneRepository.findByIdOptional(request.compteId())
|
||||
.orElseThrow(() -> new NotFoundException("Compte épargne non trouvé : " + request.compteId()));
|
||||
if (!compte.getMembre().getId().equals(membreConnecte.getId())) {
|
||||
throw new IllegalArgumentException("Ce compte épargne n'appartient pas au membre connecté");
|
||||
}
|
||||
|
||||
String base = waveCheckoutService.getRedirectBaseUrl().replaceAll("/+$", "");
|
||||
BigDecimal montant = request.montant().setScale(0, java.math.RoundingMode.HALF_UP);
|
||||
String objetsCibles = "[{\"type\":\"DEPOT_EPARGNE\",\"compteId\":\""
|
||||
+ request.compteId() + "\",\"montant\":" + montant + "}]";
|
||||
|
||||
IntentionPaiement intention = IntentionPaiement.builder()
|
||||
.utilisateur(membreConnecte)
|
||||
.organisation(compte.getOrganisation())
|
||||
.montantTotal(montant)
|
||||
.codeDevise("XOF")
|
||||
.typeObjet(TypeObjetIntentionPaiement.DEPOT_EPARGNE)
|
||||
.statut(StatutIntentionPaiement.INITIEE)
|
||||
.objetsCibles(objetsCibles)
|
||||
.build();
|
||||
intentionPaiementRepository.persist(intention);
|
||||
|
||||
String successUrl = base + "/api/wave-redirect/success?ref=" + intention.getId();
|
||||
String errorUrl = base + "/api/wave-redirect/error?ref=" + intention.getId();
|
||||
|
||||
WaveCheckoutSessionResponse session;
|
||||
try {
|
||||
session = waveCheckoutService.createSession(
|
||||
montant.toString(), "XOF", successUrl, errorUrl,
|
||||
intention.getId().toString(), toE164(request.numeroTelephone()));
|
||||
} catch (WaveCheckoutException e) {
|
||||
LOG.errorf(e, "Wave Checkout (dépôt épargne) : %s", e.getMessage());
|
||||
intention.setStatut(StatutIntentionPaiement.ECHOUEE);
|
||||
intentionPaiementRepository.persist(intention);
|
||||
throw new jakarta.ws.rs.BadRequestException("Wave : " + e.getMessage());
|
||||
}
|
||||
|
||||
intention.setWaveCheckoutSessionId(session.id);
|
||||
intention.setWaveLaunchUrl(session.waveLaunchUrl);
|
||||
intention.setStatut(StatutIntentionPaiement.EN_COURS);
|
||||
intentionPaiementRepository.persist(intention);
|
||||
|
||||
LOG.infof("Dépôt épargne Wave initié : intention=%s, compte=%s",
|
||||
intention.getId(), request.compteId());
|
||||
|
||||
return VersementGatewayResponse.builder()
|
||||
.versementId(intention.getId())
|
||||
.waveLaunchUrl(session.waveLaunchUrl)
|
||||
.waveCheckoutSessionId(session.id)
|
||||
.clientReference(intention.getId().toString())
|
||||
.montant(montant)
|
||||
.statut("EN_ATTENTE")
|
||||
.message("Ouvrez Wave pour confirmer le dépôt, puis vous serez renvoyé dans UnionFlow.")
|
||||
.build();
|
||||
}
|
||||
|
||||
// ── Polling statut ────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Vérifie le statut d'une intention Wave.
|
||||
* Utilisé par le deep link de retour (mobile) et le polling web.
|
||||
*/
|
||||
@Transactional
|
||||
public VersementStatutResponse verifierStatutVersement(UUID intentionId) {
|
||||
IntentionPaiement intention = intentionPaiementRepository.findById(intentionId);
|
||||
if (intention == null) {
|
||||
throw new NotFoundException("Intention non trouvée : " + intentionId);
|
||||
}
|
||||
|
||||
if (intention.isCompletee()) {
|
||||
return buildStatutResponse(intention, "Versement confirmé !");
|
||||
}
|
||||
if (StatutIntentionPaiement.EXPIREE.equals(intention.getStatut())
|
||||
|| StatutIntentionPaiement.ECHOUEE.equals(intention.getStatut())) {
|
||||
return buildStatutResponse(intention,
|
||||
"Versement " + intention.getStatut().name().toLowerCase());
|
||||
}
|
||||
if (intention.isExpiree()) {
|
||||
intention.setStatut(StatutIntentionPaiement.EXPIREE);
|
||||
intentionPaiementRepository.persist(intention);
|
||||
return buildStatutResponse(intention, "Session expirée, veuillez recommencer");
|
||||
}
|
||||
|
||||
if (intention.getWaveCheckoutSessionId() != null) {
|
||||
try {
|
||||
WaveCheckoutService.WaveSessionStatusResponse waveStatus =
|
||||
waveCheckoutService.getSession(intention.getWaveCheckoutSessionId());
|
||||
if (waveStatus.isSucceeded()) {
|
||||
confirmerVersementWave(intention, waveStatus.transactionId);
|
||||
return buildStatutResponse(intention, "Versement confirmé !");
|
||||
} else if (waveStatus.isExpired()) {
|
||||
intention.setStatut(StatutIntentionPaiement.EXPIREE);
|
||||
intentionPaiementRepository.persist(intention);
|
||||
return buildStatutResponse(intention, "Session Wave expirée");
|
||||
}
|
||||
} catch (WaveCheckoutService.WaveCheckoutException e) {
|
||||
LOG.warnf(e, "Impossible de vérifier la session Wave %s — retry au prochain appel",
|
||||
intention.getWaveCheckoutSessionId());
|
||||
}
|
||||
}
|
||||
|
||||
return buildStatutResponse(intention, "En attente de confirmation Wave...");
|
||||
}
|
||||
|
||||
// ── Flux manuel ───────────────────────────────────────────────────────────
|
||||
|
||||
@Transactional
|
||||
public VersementResponse declarerVersementManuel(DeclarerVersementManuelRequest request) {
|
||||
Membre membreConnecte = getMembreConnecte();
|
||||
LOG.infof("Déclaration versement manuel — membre %s, cotisation %s, méthode %s",
|
||||
membreConnecte.getNumeroMembre(), request.cotisationId(), request.methodePaiement());
|
||||
|
||||
Cotisation cotisation = versementRepository.getEntityManager()
|
||||
.createQuery("SELECT c FROM Cotisation c WHERE c.id = :id", Cotisation.class)
|
||||
.setParameter("id", request.cotisationId())
|
||||
.getResultList().stream().findFirst()
|
||||
.orElseThrow(() -> new NotFoundException("Cotisation non trouvée : " + request.cotisationId()));
|
||||
|
||||
if (!cotisation.getMembre().getId().equals(membreConnecte.getId())) {
|
||||
throw new IllegalArgumentException("Cette cotisation n'appartient pas au membre connecté");
|
||||
}
|
||||
|
||||
Versement versement = new Versement();
|
||||
versement.setNumeroReference("VRS-MAN-" + UUID.randomUUID().toString().substring(0, 8).toUpperCase());
|
||||
versement.setMontant(cotisation.getMontantDu());
|
||||
versement.setCodeDevise("XOF");
|
||||
versement.setMethodePaiement(request.methodePaiement());
|
||||
versement.setStatutPaiement("EN_ATTENTE_VALIDATION");
|
||||
versement.setMembre(membreConnecte);
|
||||
versement.setReferenceExterne(request.reference());
|
||||
versement.setCommentaire(request.commentaire());
|
||||
versement.setDatePaiement(LocalDateTime.now());
|
||||
versement.setCreePar(membreConnecte.getEmail());
|
||||
versementRepository.persist(versement);
|
||||
|
||||
// Notifier le trésorier
|
||||
membreOrganisationRepository.findFirstByMembreId(membreConnecte.getId())
|
||||
.ifPresent(mo -> {
|
||||
CreateNotificationRequest notif = CreateNotificationRequest.builder()
|
||||
.typeNotification("VALIDATION_VERSEMENT_REQUIS")
|
||||
.priorite("HAUTE")
|
||||
.sujet("Validation versement manuel requis")
|
||||
.corps("Le membre " + membreConnecte.getNumeroMembre()
|
||||
+ " a déclaré un versement manuel de " + versement.getMontant()
|
||||
+ " XOF (réf: " + versement.getNumeroReference() + ") à valider.")
|
||||
.organisationId(mo.getOrganisation().getId())
|
||||
.build();
|
||||
notificationService.creerNotification(notif);
|
||||
});
|
||||
|
||||
LOG.infof("Versement manuel déclaré : %s (EN_ATTENTE_VALIDATION)", versement.getNumeroReference());
|
||||
return convertToResponse(versement);
|
||||
}
|
||||
|
||||
// ── Réconciliation Wave (appelé par WaveRedirectResource) ─────────────────
|
||||
|
||||
/**
|
||||
* Marque l'intention COMPLETEE et met à jour les cotisations cibles.
|
||||
* Idempotent : si déjà complétée, retourne sans effet.
|
||||
*/
|
||||
@Transactional
|
||||
public void confirmerVersementWave(IntentionPaiement intention, String waveTransactionId) {
|
||||
if (intention.isCompletee()) return;
|
||||
|
||||
intention.setStatut(StatutIntentionPaiement.COMPLETEE);
|
||||
intention.setDateCompletion(LocalDateTime.now());
|
||||
if (waveTransactionId != null) {
|
||||
intention.setWaveTransactionId(waveTransactionId);
|
||||
}
|
||||
intentionPaiementRepository.persist(intention);
|
||||
|
||||
String objetsCibles = intention.getObjetsCibles();
|
||||
if (objetsCibles == null || objetsCibles.isBlank()) return;
|
||||
|
||||
try {
|
||||
com.fasterxml.jackson.databind.JsonNode arr =
|
||||
new com.fasterxml.jackson.databind.ObjectMapper().readTree(objetsCibles);
|
||||
if (!arr.isArray()) return;
|
||||
|
||||
for (com.fasterxml.jackson.databind.JsonNode node : arr) {
|
||||
if (!"COTISATION".equals(node.path("type").asText())) continue;
|
||||
|
||||
UUID cotisationId = UUID.fromString(node.get("id").asText());
|
||||
BigDecimal montant = node.has("montant")
|
||||
? new BigDecimal(node.get("montant").asText())
|
||||
: intention.getMontantTotal();
|
||||
|
||||
Cotisation cotisation = versementRepository.getEntityManager()
|
||||
.find(Cotisation.class, cotisationId);
|
||||
if (cotisation == null) continue;
|
||||
|
||||
cotisation.setMontantPaye(montant);
|
||||
cotisation.setStatut("PAYEE");
|
||||
cotisation.setDatePaiement(LocalDateTime.now());
|
||||
versementRepository.getEntityManager().merge(cotisation);
|
||||
LOG.infof("Cotisation %s marquée PAYEE — Wave txn %s",
|
||||
cotisationId, waveTransactionId);
|
||||
}
|
||||
} catch (Exception e) {
|
||||
LOG.errorf(e, "Erreur réconciliation cotisations pour intention %s", intention.getId());
|
||||
}
|
||||
}
|
||||
|
||||
// ── Méthodes privées ──────────────────────────────────────────────────────
|
||||
|
||||
private Membre getMembreConnecte() {
|
||||
String email = securityIdentity.getPrincipal().getName();
|
||||
return membreRepository.findByEmail(email)
|
||||
.orElseThrow(() -> new NotFoundException(
|
||||
"Membre non trouvé pour l'email : " + email));
|
||||
}
|
||||
|
||||
private VersementResponse convertToResponse(Versement v) {
|
||||
VersementResponse r = new VersementResponse();
|
||||
r.setId(v.getId());
|
||||
r.setNumeroReference(v.getNumeroReference());
|
||||
r.setMontant(v.getMontant());
|
||||
r.setCodeDevise(v.getCodeDevise());
|
||||
r.setMethodePaiement(v.getMethodePaiement());
|
||||
r.setStatutPaiement(v.getStatutPaiement());
|
||||
r.setDatePaiement(v.getDatePaiement());
|
||||
r.setDateValidation(v.getDateValidation());
|
||||
r.setValidateur(v.getValidateur());
|
||||
r.setReferenceExterne(v.getReferenceExterne());
|
||||
r.setUrlPreuve(v.getUrlPreuve());
|
||||
r.setCommentaire(v.getCommentaire());
|
||||
r.setNumeroTelephone(v.getNumeroTelephone());
|
||||
if (v.getMembre() != null) {
|
||||
r.setMembreId(v.getMembre().getId());
|
||||
}
|
||||
if (v.getTransactionWave() != null) {
|
||||
r.setTransactionWaveId(v.getTransactionWave().getId());
|
||||
}
|
||||
r.setDateCreation(v.getDateCreation());
|
||||
r.setDateModification(v.getDateModification());
|
||||
r.setActif(v.getActif());
|
||||
enrichirLibelles(v, r);
|
||||
return r;
|
||||
}
|
||||
|
||||
private VersementSummaryResponse convertToSummaryResponse(Versement v) {
|
||||
if (v == null) return null;
|
||||
return new VersementSummaryResponse(
|
||||
v.getId(),
|
||||
v.getNumeroReference(),
|
||||
v.getMontant(),
|
||||
v.getCodeDevise(),
|
||||
resolveLibelle("METHODE_PAIEMENT", v.getMethodePaiement()),
|
||||
v.getStatutPaiement(),
|
||||
resolveLibelle("STATUT_PAIEMENT", v.getStatutPaiement()),
|
||||
resolveSeverity("STATUT_PAIEMENT", v.getStatutPaiement()),
|
||||
v.getDatePaiement());
|
||||
}
|
||||
|
||||
private void enrichirLibelles(Versement v, VersementResponse r) {
|
||||
r.setMethodePaiementLibelle(resolveLibelle("METHODE_PAIEMENT", v.getMethodePaiement()));
|
||||
r.setStatutPaiementLibelle(resolveLibelle("STATUT_PAIEMENT", v.getStatutPaiement()));
|
||||
r.setStatutPaiementSeverity(resolveSeverity("STATUT_PAIEMENT", v.getStatutPaiement()));
|
||||
}
|
||||
|
||||
private String resolveLibelle(String domaine, String code) {
|
||||
if (code == null) return null;
|
||||
return typeReferenceRepository.findByDomaineAndCode(domaine, code)
|
||||
.map(dev.lions.unionflow.server.entity.TypeReference::getLibelle)
|
||||
.orElse(code);
|
||||
}
|
||||
|
||||
private String resolveSeverity(String domaine, String code) {
|
||||
if (code == null) return null;
|
||||
return typeReferenceRepository.findByDomaineAndCode(domaine, code)
|
||||
.map(dev.lions.unionflow.server.entity.TypeReference::getSeverity)
|
||||
.orElse("info");
|
||||
}
|
||||
|
||||
private VersementStatutResponse buildStatutResponse(IntentionPaiement intention, String message) {
|
||||
return VersementStatutResponse.builder()
|
||||
.intentionId(intention.getId())
|
||||
.statut(intention.getStatut().name())
|
||||
.confirme(intention.isCompletee())
|
||||
.waveLaunchUrl(intention.getWaveLaunchUrl())
|
||||
.waveCheckoutSessionId(intention.getWaveCheckoutSessionId())
|
||||
.waveTransactionId(intention.getWaveTransactionId())
|
||||
.montant(intention.getMontantTotal())
|
||||
.message(message)
|
||||
.build();
|
||||
}
|
||||
|
||||
/** Format E.164 pour Wave : 771234567 → +221771234567 */
|
||||
static String toE164(String numeroTelephone) {
|
||||
if (numeroTelephone == null || numeroTelephone.isBlank()) return null;
|
||||
String digits = numeroTelephone.replaceAll("\\D", "");
|
||||
if (digits.length() == 9 && (digits.startsWith("7") || digits.startsWith("0"))) {
|
||||
return "+221" + (digits.startsWith("0") ? digits.substring(1) : digits);
|
||||
}
|
||||
if (digits.length() >= 9 && digits.startsWith("221")) return "+" + digits;
|
||||
return numeroTelephone.startsWith("+") ? numeroTelephone : "+" + digits;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
-- V27 : Ajoute la colonne numero_telephone dans la table paiements (versements)
|
||||
--
|
||||
-- Contexte : La refonte conceptuelle remplace "Paiement" par "Versement".
|
||||
-- L'application Wave est installée sur le même téléphone qu'UnionFlow ;
|
||||
-- le numéro de téléphone du membre est envoyé automatiquement depuis son profil
|
||||
-- afin de pré-remplir le formulaire Wave (deep link natif).
|
||||
-- Ce champ mémorise le numéro utilisé lors du versement Wave.
|
||||
|
||||
ALTER TABLE paiements
|
||||
ADD COLUMN IF NOT EXISTS numero_telephone VARCHAR(20);
|
||||
Reference in New Issue
Block a user