wip: swagger p3

src/main/java/fr/titionfire/ffsaf/rest/data/DeskMember.java

@@ -4,14 +4,20 @@ import fr.titionfire.ffsaf.data.model.MembreModel;
 import io.quarkus.runtime.annotations.RegisterForReflection;
 import lombok.Data;
 import lombok.NoArgsConstructor;
+import org.eclipse.microprofile.openapi.annotations.media.Schema;
 
 @Data
 @NoArgsConstructor
 @RegisterForReflection
+@Schema(name = "BureauMembre")
 public class DeskMember {
+    @Schema(description = "Identifiant du membre", example = "1")
     private Long id;
+    @Schema(description = "Nom du membre", example = "Doe")
     private String lname;
+    @Schema(description = "Prénom du membre", example = "John")
     private String fname;
+    @Schema(description = "Rôle du membre", example = "Président")
     private String role;
 
     public static DeskMember fromModel(MembreModel membreModel) {

src/main/java/fr/titionfire/ffsaf/rest/data/SimpleReqAffiliation.java

@@ -6,6 +6,7 @@ import io.quarkus.runtime.annotations.RegisterForReflection;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
+import org.eclipse.microprofile.openapi.annotations.media.Schema;
 
 import java.util.List;
 
@@ -51,10 +52,15 @@ public class SimpleReqAffiliation {
     @AllArgsConstructor
     @RegisterForReflection
     public static class AffiliationMember {
+        @Schema(description = "Nom du membre", example = "Doe")
         String lname;
+        @Schema(description = "Prénom du membre", example = "John")
         String fname;
+        @Schema(description = "Email du membre", example = "john.doe@test.com")
         String email;
+        @Schema(description = "Numéro de licence du membre", example = "12345")
         int licence;
+        @Schema(description = "Rôle du membre", example = "MEMBRE")
         RoleAsso role;
     }
 }