CLAP-175 Docs: Swagger 내용 작성

Author: starboxxxx

src/main/java/clap/server/adapter/inbound/web/admin/ManagementLabelController.java

@@ -7,6 +7,8 @@
 import clap.server.application.port.inbound.admin.UpdateLabelUsecase;
 import clap.server.common.annotation.architecture.WebAdapter;
 import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.enums.ParameterIn;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import org.springframework.security.access.annotation.Secured;
@@ -32,6 +34,7 @@ public void addLabel(@AuthenticationPrincipal SecurityUserDetails userInfo,
     }
 
     @Operation(summary = "구분(label) 수정 API")
+    @Parameter(name = "labelId", description = "구분(label) 고유 ID", required = true, in = ParameterIn.PATH)
     @PatchMapping("/{labelId}")
     @Secured({"ROLE_ADMIN"})
     public void updateLabel(@AuthenticationPrincipal SecurityUserDetails userInfo,
@@ -42,6 +45,7 @@ public void updateLabel(@AuthenticationPrincipal SecurityUserDetails userInfo,
     }
 
     @Operation(summary = "구분(label) 삭제 API")
+    @Parameter(name = "labelId", description = "구분(label) 고유 ID", required = true, in = ParameterIn.PATH)
     @DeleteMapping("/{labelId}")
     @Secured({"ROLE_ADMIN"})
     public void deleteLabel(@AuthenticationPrincipal SecurityUserDetails userInfo,

src/main/java/clap/server/adapter/inbound/web/dto/label/AddAndEditLabelRequest.java

@@ -1,9 +1,13 @@
 package clap.server.adapter.inbound.web.dto.label;
 
+import clap.server.adapter.outbound.persistense.entity.member.constant.MemberRole;
 import clap.server.adapter.outbound.persistense.entity.task.constant.LabelColor;
+import io.swagger.v3.oas.annotations.media.Schema;
 
 public record AddAndEditLabelRequest(
 
+        @Schema(description = "구분(label) 이름")
         String labelName,
+        @Schema(description = "구분(label) 색상")
         LabelColor labelColor
 ) {}

src/main/java/clap/server/adapter/inbound/web/dto/label/FindLabelListResponse.java

@@ -1,10 +1,14 @@
 package clap.server.adapter.inbound.web.dto.label;
 
 import clap.server.adapter.outbound.persistense.entity.task.constant.LabelColor;
+import io.swagger.v3.oas.annotations.media.Schema;
 
 public record FindLabelListResponse(
+        @Schema(description = "구분(label) 고유 ID")
         Long labelId,
+        @Schema(description = "구분(label) 이름")
         String labelName,
+        @Schema(description = "구분(label) 색상")
         LabelColor labelColor
 ) {
 }