Sync: code local unifié

Synchronisation du code source local (fait foi).

Signed-off-by: lions dev Team

src/main/java/dev/lions/unionflow/server/resource/PaiementResource.java

@@ -1,6 +1,8 @@
 package dev.lions.unionflow.server.resource;
 
-import dev.lions.unionflow.server.api.dto.paiement.PaiementDTO;
+import dev.lions.unionflow.server.api.dto.paiement.request.CreatePaiementRequest;
+import dev.lions.unionflow.server.api.dto.paiement.response.PaiementResponse;
+import dev.lions.unionflow.server.api.dto.paiement.response.PaiementSummaryResponse;
 import dev.lions.unionflow.server.service.PaiementService;
 import jakarta.annotation.security.RolesAllowed;
 import jakarta.inject.Inject;
@@ -10,6 +12,7 @@ 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;
 
 /**
@@ -22,61 +25,27 @@ import org.jboss.logging.Logger;
 @Path("/api/paiements")
 @Produces(MediaType.APPLICATION_JSON)
 @Consumes(MediaType.APPLICATION_JSON)
-@RolesAllowed({"ADMIN", "MEMBRE", "USER"})
+@RolesAllowed({ "ADMIN", "MEMBRE", "USER" })
+@Tag(name = "Paiements", description = "Gestion des paiements : création, validation et suivi")
 public class PaiementResource {
 
   private static final Logger LOG = Logger.getLogger(PaiementResource.class);
 
-  @Inject PaiementService paiementService;
+  @Inject
+  PaiementService paiementService;
 
   /**
    * Crée un nouveau paiement
    *
-   * @param paiementDTO DTO du paiement à créer
+   * @param request DTO du paiement à créer
    * @return Paiement créé
    */
   @POST
-  @RolesAllowed({"ADMIN", "MEMBRE"})
-  public Response creerPaiement(@Valid PaiementDTO paiementDTO) {
-    try {
-      PaiementDTO result = paiementService.creerPaiement(paiementDTO);
-      return Response.status(Response.Status.CREATED).entity(result).build();
-    } catch (Exception e) {
-      LOG.errorf(e, "Erreur lors de la création du paiement");
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse("Erreur lors de la création du paiement: " + e.getMessage()))
-          .build();
-    }
-  }
-
-  /**
-   * Met à jour un paiement
-   *
-   * @param id ID du paiement
-   * @param paiementDTO DTO avec les modifications
-   * @return Paiement mis à jour
-   */
-  @PUT
-  @RolesAllowed({"ADMIN", "MEMBRE"})
-  @Path("/{id}")
-  public Response mettreAJourPaiement(@PathParam("id") UUID id, @Valid PaiementDTO paiementDTO) {
-    try {
-      PaiementDTO result = paiementService.mettreAJourPaiement(id, paiementDTO);
-      return Response.ok(result).build();
-    } catch (jakarta.ws.rs.NotFoundException e) {
-      return Response.status(Response.Status.NOT_FOUND)
-          .entity(new ErrorResponse("Paiement non trouvé"))
-          .build();
-    } catch (IllegalStateException e) {
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse(e.getMessage()))
-          .build();
-    } catch (Exception e) {
-      LOG.errorf(e, "Erreur lors de la mise à jour du paiement");
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse("Erreur lors de la mise à jour du paiement: " + e.getMessage()))
-          .build();
-    }
+  @RolesAllowed({ "ADMIN", "MEMBRE" })
+  public Response creerPaiement(@Valid CreatePaiementRequest request) {
+    LOG.infof("POST /api/paiements - Création paiement: %s", request.numeroReference());
+    PaiementResponse result = paiementService.creerPaiement(request);
+    return Response.status(Response.Status.CREATED).entity(result).build();
   }
 
   /**
@@ -86,22 +55,12 @@ public class PaiementResource {
    * @return Paiement validé
    */
   @POST
-  @RolesAllowed({"ADMIN", "MEMBRE"})
+  @RolesAllowed({ "ADMIN", "MEMBRE" })
   @Path("/{id}/valider")
   public Response validerPaiement(@PathParam("id") UUID id) {
-    try {
-      PaiementDTO result = paiementService.validerPaiement(id);
-      return Response.ok(result).build();
-    } catch (jakarta.ws.rs.NotFoundException e) {
-      return Response.status(Response.Status.NOT_FOUND)
-          .entity(new ErrorResponse("Paiement non trouvé"))
-          .build();
-    } catch (Exception e) {
-      LOG.errorf(e, "Erreur lors de la validation du paiement");
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse("Erreur lors de la validation du paiement: " + e.getMessage()))
-          .build();
-    }
+    LOG.infof("POST /api/paiements/%s/valider", id);
+    PaiementResponse result = paiementService.validerPaiement(id);
+    return Response.ok(result).build();
   }
 
   /**
@@ -111,26 +70,12 @@ public class PaiementResource {
    * @return Paiement annulé
    */
   @POST
-  @RolesAllowed({"ADMIN", "MEMBRE"})
+  @RolesAllowed({ "ADMIN", "MEMBRE" })
   @Path("/{id}/annuler")
   public Response annulerPaiement(@PathParam("id") UUID id) {
-    try {
-      PaiementDTO result = paiementService.annulerPaiement(id);
-      return Response.ok(result).build();
-    } catch (jakarta.ws.rs.NotFoundException e) {
-      return Response.status(Response.Status.NOT_FOUND)
-          .entity(new ErrorResponse("Paiement non trouvé"))
-          .build();
-    } catch (IllegalStateException e) {
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse(e.getMessage()))
-          .build();
-    } catch (Exception e) {
-      LOG.errorf(e, "Erreur lors de l'annulation du paiement");
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse("Erreur lors de l'annulation du paiement: " + e.getMessage()))
-          .build();
-    }
+    LOG.infof("POST /api/paiements/%s/annuler", id);
+    PaiementResponse result = paiementService.annulerPaiement(id);
+    return Response.ok(result).build();
   }
 
   /**
@@ -142,19 +87,9 @@ public class PaiementResource {
   @GET
   @Path("/{id}")
   public Response trouverParId(@PathParam("id") UUID id) {
-    try {
-      PaiementDTO result = paiementService.trouverParId(id);
-      return Response.ok(result).build();
-    } catch (jakarta.ws.rs.NotFoundException e) {
-      return Response.status(Response.Status.NOT_FOUND)
-          .entity(new ErrorResponse("Paiement non trouvé"))
-          .build();
-    } catch (Exception e) {
-      LOG.errorf(e, "Erreur lors de la recherche du paiement");
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse("Erreur lors de la recherche du paiement: " + e.getMessage()))
-          .build();
-    }
+    LOG.infof("GET /api/paiements/%s", id);
+    PaiementResponse result = paiementService.trouverParId(id);
+    return Response.ok(result).build();
   }
 
   /**
@@ -166,19 +101,9 @@ public class PaiementResource {
   @GET
   @Path("/reference/{numeroReference}")
   public Response trouverParNumeroReference(@PathParam("numeroReference") String numeroReference) {
-    try {
-      PaiementDTO result = paiementService.trouverParNumeroReference(numeroReference);
-      return Response.ok(result).build();
-    } catch (jakarta.ws.rs.NotFoundException e) {
-      return Response.status(Response.Status.NOT_FOUND)
-          .entity(new ErrorResponse("Paiement non trouvé"))
-          .build();
-    } catch (Exception e) {
-      LOG.errorf(e, "Erreur lors de la recherche du paiement");
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse("Erreur lors de la recherche du paiement: " + e.getMessage()))
-          .build();
-    }
+    LOG.infof("GET /api/paiements/reference/%s", numeroReference);
+    PaiementResponse result = paiementService.trouverParNumeroReference(numeroReference);
+    return Response.ok(result).build();
   }
 
   /**
@@ -190,24 +115,76 @@ public class PaiementResource {
   @GET
   @Path("/membre/{membreId}")
   public Response listerParMembre(@PathParam("membreId") UUID membreId) {
-    try {
-      List<PaiementDTO> result = paiementService.listerParMembre(membreId);
-      return Response.ok(result).build();
-    } catch (Exception e) {
-      LOG.errorf(e, "Erreur lors de la liste des paiements");
-      return Response.status(Response.Status.BAD_REQUEST)
-          .entity(new ErrorResponse("Erreur lors de la liste des paiements: " + e.getMessage()))
-          .build();
-    }
+    LOG.infof("GET /api/paiements/membre/%s", membreId);
+    List<PaiementSummaryResponse> result = paiementService.listerParMembre(membreId);
+    return Response.ok(result).build();
   }
 
-  /** Classe interne pour les réponses d'erreur */
-  public static class ErrorResponse {
-    public String error;
+  /**
+   * Liste l'historique des paiements du membre connecté (auto-détection).
+   * Utilisé par la page personnelle "Payer mes Cotisations".
+   *
+   * @param limit Nombre maximum de paiements à retourner (défaut : 5)
+   * @return Liste des derniers paiements
+   */
+  @GET
+  @Path("/mes-paiements/historique")
+  @RolesAllowed({ "MEMBRE", "ADMIN" })
+  public Response getMonHistoriquePaiements(
+      @QueryParam("limit") @DefaultValue("5") int limit) {
+    LOG.infof("GET /api/paiements/mes-paiements/historique?limit=%d", limit);
+    List<PaiementSummaryResponse> result = paiementService.getMonHistoriquePaiements(limit);
+    return Response.ok(result).build();
+  }
 
-    public ErrorResponse(String error) {
-      this.error = error;
-    }
+  /**
+   * Initie un paiement en ligne via un gateway (Wave, Orange Money, Free Money, Carte).
+   * Retourne l'URL de redirection vers le gateway.
+   *
+   * @param request Données du paiement en ligne
+   * @return URL de redirection + transaction ID
+   */
+  @POST
+  @Path("/initier-paiement-en-ligne")
+  @RolesAllowed({ "MEMBRE", "MEMBRE_ACTIF", "ADMIN", "USER" })
+  public Response initierPaiementEnLigne(@Valid dev.lions.unionflow.server.api.dto.paiement.request.InitierPaiementEnLigneRequest request) {
+    LOG.infof("POST /api/paiements/initier-paiement-en-ligne - cotisation: %s, méthode: %s",
+        request.cotisationId(), request.methodePaiement());
+    dev.lions.unionflow.server.api.dto.paiement.response.PaiementGatewayResponse result =
+        paiementService.initierPaiementEnLigne(request);
+    return Response.status(Response.Status.CREATED).entity(result).build();
+  }
+
+  /**
+   * Initie un dépôt sur compte épargne via Wave (même flux que cotisations).
+   * Retourne wave_launch_url pour ouvrir l'app Wave puis retour deep link.
+   */
+  @POST
+  @Path("/initier-depot-epargne-en-ligne")
+  @RolesAllowed({ "MEMBRE", "MEMBRE_ACTIF", "ADMIN", "USER" })
+  public Response initierDepotEpargneEnLigne(@Valid dev.lions.unionflow.server.api.dto.paiement.request.InitierDepotEpargneRequest request) {
+    LOG.infof("POST /api/paiements/initier-depot-epargne-en-ligne - compte: %s, montant: %s",
+        request.compteId(), request.montant());
+    dev.lions.unionflow.server.api.dto.paiement.response.PaiementGatewayResponse result =
+        paiementService.initierDepotEpargneEnLigne(request);
+    return Response.status(Response.Status.CREATED).entity(result).build();
+  }
+
+  /**
+   * Déclare un paiement manuel (espèces, virement, chèque).
+   * Le paiement est créé avec le statut EN_ATTENTE_VALIDATION.
+   * Le trésorier devra le valider via une page admin.
+   *
+   * @param request Données du paiement manuel
+   * @return Paiement créé (statut EN_ATTENTE_VALIDATION)
+   */
+  @POST
+  @Path("/declarer-paiement-manuel")
+  @RolesAllowed({ "MEMBRE", "ADMIN" })
+  public Response declarerPaiementManuel(@Valid dev.lions.unionflow.server.api.dto.paiement.request.DeclarerPaiementManuelRequest request) {
+    LOG.infof("POST /api/paiements/declarer-paiement-manuel - cotisation: %s, méthode: %s",
+        request.cotisationId(), request.methodePaiement());
+    PaiementResponse result = paiementService.declarerPaiementManuel(request);
+    return Response.status(Response.Status.CREATED).entity(result).build();
   }
 }
-