wip: swagger p2

2024-07-19 19:29:30 +02:00
parent 957fcfff8b
commit fa54a58394
9 changed files with 501 additions and 224 deletions
--- a/src/main/java/fr/titionfire/ffsaf/rest/MembreEndpoints.java
+++ b/src/main/java/fr/titionfire/ffsaf/rest/MembreEndpoints.java
@@ -0,0 +1,115 @@
+package fr.titionfire.ffsaf.rest;
+
+import fr.titionfire.ffsaf.data.model.MembreModel;
+import fr.titionfire.ffsaf.domain.service.MembreService;
+import fr.titionfire.ffsaf.rest.data.MeData;
+import fr.titionfire.ffsaf.rest.data.SimpleMembre;
+import fr.titionfire.ffsaf.rest.exception.DForbiddenException;
+import fr.titionfire.ffsaf.utils.GroupeUtils;
+import fr.titionfire.ffsaf.utils.Utils;
+import io.quarkus.oidc.IdToken;
+import io.quarkus.security.Authenticated;
+import io.quarkus.security.identity.SecurityIdentity;
+import io.smallrye.mutiny.Uni;
+import io.smallrye.mutiny.unchecked.Unchecked;
+import jakarta.annotation.security.RolesAllowed;
+import jakarta.inject.Inject;
+import jakarta.ws.rs.*;
+import jakarta.ws.rs.core.MediaType;
+import jakarta.ws.rs.core.Response;
+import org.eclipse.microprofile.config.inject.ConfigProperty;
+import org.eclipse.microprofile.jwt.JsonWebToken;
+import org.eclipse.microprofile.openapi.annotations.Operation;
+import org.eclipse.microprofile.openapi.annotations.parameters.Parameter;
+import org.eclipse.microprofile.openapi.annotations.responses.APIResponse;
+import org.eclipse.microprofile.openapi.annotations.responses.APIResponses;
+import org.eclipse.microprofile.openapi.annotations.tags.Tag;
+
+import java.net.URISyntaxException;
+import java.util.function.Consumer;
+
+@Tag(name = "Membre", description = "Gestion des membres")
+@Authenticated
+@Path("api/member")
+public class MembreEndpoints {
+
+    @Inject
+    MembreService membreService;
+
+    @ConfigProperty(name = "upload_dir")
+    String media;
+
+    @Inject
+    @IdToken
+    JsonWebToken idToken;
+
+    @Inject
+    SecurityIdentity securityIdentity;
+
+    Consumer<MembreModel> checkPerm = Unchecked.consumer(membreModel -> {
+        if (!securityIdentity.getRoles().contains("federation_admin") && !GroupeUtils.isInClubGroup(
+                membreModel.getClub().getId(), idToken))
+            throw new DForbiddenException();
+    });
+
+    @GET
+    @Path("{id}")
+    @RolesAllowed({"federation_admin", "club_president", "club_secretaire", "club_respo_intra"})
+    @Produces(MediaType.APPLICATION_JSON)
+    @Operation(summary = "Renvoie les détails d'un membre en fonction de son identifiant", description = "Renvoie les " +
+            "détails d'un membre en fonction de son identifiant")
+    @APIResponses(value = {
+            @APIResponse(responseCode = "200", description = "Les détails du membre"),
+            @APIResponse(responseCode = "403", description = "Accès refusé"),
+            @APIResponse(responseCode = "404", description = "Le membre n'existe pas"),
+            @APIResponse(responseCode = "500", description = "Erreur interne du serveur")
+    })
+    public Uni<SimpleMembre> getById(
+            @Parameter(description = "Identifiant de membre") @PathParam("id") long id) {
+        return membreService.getById(id).onItem().invoke(checkPerm).map(SimpleMembre::fromModel);
+    }
+
+    @GET
+    @Path("/find/licence")
+    @RolesAllowed({"federation_admin", "club_president", "club_secretaire", "club_respo_intra"})
+    @Operation(summary = "Renvoie les détails d'un membre en fonction de son numéro de licence", description = "Renvoie " +
+            "les détails d'un membre en fonction de son numéro de licence")
+    @APIResponses(value = {
+            @APIResponse(responseCode = "200", description = "Les détails du membre"),
+            @APIResponse(responseCode = "403", description = "Accès refusé"),
+            @APIResponse(responseCode = "404", description = "Le membre n'existe pas"),
+            @APIResponse(responseCode = "500", description = "Erreur interne du serveur")
+    })
+    @Produces(MediaType.APPLICATION_JSON)
+    public Uni<SimpleMembre> getByLicence(@QueryParam("id") long id) {
+        return membreService.getByLicence(id).onItem().invoke(checkPerm).map(SimpleMembre::fromModel);
+    }
+
+    @GET
+    @Path("me")
+    @Authenticated
+    @Produces(MediaType.APPLICATION_JSON)
+    @Operation(summary = "Renvoie les informations du membre connecté", description = "Renvoie les informations du " +
+            "membre connecté, y compris le club et les licences")
+    @APIResponses(value = {
+            @APIResponse(responseCode = "200", description = "Les informations du membre connecté"),
+            @APIResponse(responseCode = "500", description = "Erreur interne du serveur")
+    })
+    public Uni<MeData> getMe() {
+        return membreService.getMembre(idToken.getSubject());
+    }
+
+    @GET
+    @Path("{id}/photo")
+    @RolesAllowed({"federation_admin", "club_president", "club_secretaire", "club_respo_intra"})
+    @Operation(summary = "Renvoie la photo d'un membre", description = "Renvoie la photo d'un membre en fonction de son identifiant")
+    @APIResponses(value = {
+            @APIResponse(responseCode = "200", description = "La photo du membre"),
+            @APIResponse(responseCode = "403", description = "Accès refusé"),
+            @APIResponse(responseCode = "404", description = "Le membre n'existe pas ou n'a pas de photo"),
+            @APIResponse(responseCode = "500", description = "Erreur interne du serveur")
+    })
+    public Uni<Response> getPhoto(@PathParam("id") long id) throws URISyntaxException {
+        return Utils.getMediaFile(id, media, "ppMembre", membreService.getById(id).onItem().invoke(checkPerm));
+    }
+}