라벨 이관, 상세정보 API 추가

src/main/java/com/kamco/cd/kamcoback/label/LabelAllocateApiController.java

@@ -4,10 +4,13 @@ import com.kamco.cd.kamcoback.common.enums.RoleType;
 import com.kamco.cd.kamcoback.config.api.ApiResponseDto;
 import com.kamco.cd.kamcoback.label.dto.LabelAllocateDto;
 import com.kamco.cd.kamcoback.label.dto.LabelAllocateDto.InferenceDetail;
+import com.kamco.cd.kamcoback.label.dto.LabelAllocateDto.LabelerDetail;
 import com.kamco.cd.kamcoback.label.dto.WorkerStatsDto.WorkerListResponse;
 import com.kamco.cd.kamcoback.label.service.LabelAllocateService;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.ExampleObject;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
 import io.swagger.v3.oas.annotations.responses.ApiResponses;
@@ -33,100 +36,206 @@ public class LabelAllocateApiController {
 
   @Operation(summary = "배정 가능한 사용자 목록 조회", description = "라벨링 작업 배정을 위한 활성 상태의 사용자 목록을 조회합니다.")
   @ApiResponses(
-      value = {
-        @ApiResponse(responseCode = "200", description = "조회 성공"),
-        @ApiResponse(responseCode = "404", description = "코드를 찾을 수 없음"),
-        @ApiResponse(responseCode = "500", description = "서버 오류")
-      })
+    value = {
+      @ApiResponse(responseCode = "200", description = "조회 성공"),
+      @ApiResponse(responseCode = "404", description = "코드를 찾을 수 없음"),
+      @ApiResponse(responseCode = "500", description = "서버 오류")
+    })
   @GetMapping("/avail-user")
   public ApiResponseDto<List<LabelAllocateDto.UserList>> availUserList(
-      @Parameter(
-              description = "사용자 역할",
-              example = "LABELER",
-              schema = @Schema(allowableValues = {"LABELER", "REVIEWER"}))
-          @RequestParam
-          String role) {
+    @Parameter(
+      description = "사용자 역할",
+      example = "LABELER",
+      schema = @Schema(allowableValues = {"LABELER", "REVIEWER"}))
+    @RequestParam
+    String role) {
     return ApiResponseDto.ok(labelAllocateService.availUserList(role));
   }
 
   @Operation(summary = "작업현황관리(작업자 목록 및 3일치 통계 조회)", description = "학습데이터 제작 현황 조회 API입니다.")
   @ApiResponses(
-      value = {
-        @ApiResponse(responseCode = "200", description = "조회 성공"),
-        @ApiResponse(responseCode = "404", description = "데이터를 찾을 수 없음"),
-        @ApiResponse(responseCode = "500", description = "서버 오류")
-      })
+    value = {
+      @ApiResponse(responseCode = "200", description = "조회 성공"),
+      @ApiResponse(responseCode = "404", description = "데이터를 찾을 수 없음"),
+      @ApiResponse(responseCode = "500", description = "서버 오류")
+    })
   @GetMapping("/admin/workers")
   public ApiResponseDto<WorkerListResponse> getWorkerStatistics(
-      @Parameter(description = "분석 ID (필수)", required = true, example = "3") @RequestParam
-          Long analUid,
-      @Parameter(
-              description = "작업자 유형 (선택) - 미입력 시 LABELER로 조회",
-              example = "LABELER",
-              schema =
-                  @Schema(
-                      allowableValues = {"LABELER", "REVIEWER"},
-                      defaultValue = "LABELER"))
-          @RequestParam(required = false)
-          String type,
-      @Parameter(description = "작업자 이름 검색 (부분 일치)", example = "김라벨") @RequestParam(required = false)
-          String searchName,
-      @Parameter(description = "작업자 사번 검색 (부분 일치)", example = "1234567")
-          @RequestParam(required = false)
-          String searchEmployeeNo,
-      @Parameter(
-              description = "정렬 조건 (선택) - 미입력 시 이름 오름차순",
-              example = "REMAINING_DESC",
-              schema =
-                  @Schema(
-                      allowableValues = {
-                        "REMAINING_DESC",
-                        "REMAINING_ASC",
-                        "NAME_ASC",
-                        "NAME_DESC"
-                      },
-                      defaultValue = "NAME_ASC"))
-          @RequestParam(required = false)
-          String sort) {
+    @Parameter(description = "분석 ID (필수)", required = true, example = "3") @RequestParam
+    Long analUid,
+    @Parameter(
+      description = "작업자 유형 (선택) - 미입력 시 LABELER로 조회",
+      example = "LABELER",
+      schema =
+      @Schema(
+        allowableValues = {"LABELER", "REVIEWER"},
+        defaultValue = "LABELER"))
+    @RequestParam(required = false)
+    String type,
+    @Parameter(description = "작업자 이름 검색 (부분 일치)", example = "김라벨") @RequestParam(required = false)
+    String searchName,
+    @Parameter(description = "작업자 사번 검색 (부분 일치)", example = "1234567")
+    @RequestParam(required = false)
+    String searchEmployeeNo,
+    @Parameter(
+      description = "정렬 조건 (선택) - 미입력 시 이름 오름차순",
+      example = "REMAINING_DESC",
+      schema =
+      @Schema(
+        allowableValues = {
+          "REMAINING_DESC",
+          "REMAINING_ASC",
+          "NAME_ASC",
+          "NAME_DESC"
+        },
+        defaultValue = "NAME_ASC"))
+    @RequestParam(required = false)
+    String sort) {
 
     // type이 null이면 기본값으로 LABELER 설정
     String workerType = (type == null || type.isEmpty()) ? RoleType.LABELER.name() : type;
 
     return ApiResponseDto.ok(
-        labelAllocateService.getWorkerStatistics(
-            analUid, workerType, searchName, searchEmployeeNo, sort));
+      labelAllocateService.getWorkerStatistics(
+        analUid, workerType, searchName, searchEmployeeNo, sort));
   }
 
-  @Operation(summary = "라벨링 작업 배정", description = "라벨러 및 검수자에게 작업을 배정합니다.")
+  @Operation(summary = "작업 배정", description = "작업 배정")
   @ApiResponses(
-      value = {
-        @ApiResponse(responseCode = "200", description = "배정 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터"),
-        @ApiResponse(responseCode = "500", description = "서버 오류")
-      })
+    value = {
+      @ApiResponse(
+        responseCode = "201",
+        description = "등록 성공",
+        content =
+        @Content(
+          mediaType = "application/json",
+          schema = @Schema(implementation = Long.class),
+          examples = {@ExampleObject(
+            name = "라벨러 할당 예시",
+            description = "라벨러 할당 예시",
+            value =
+              """
+                {
+                   "autoType": "AUTO",
+                   "stage": 4,
+                   "labelers": [
+                     {
+                       "userId": "123456",
+                       "demand": 1000
+                     },
+                     {
+                       "userId": "010222297501",
+                       "demand": 400
+                     },
+                     {
+                       "userId": "01022223333",
+                       "demand": 440
+                     }
+                   ],
+                   "inspectors": [
+                     {
+                       "inspectorUid": "K20251216001",
+                       "userCount": 1000
+                     },
+                     {
+                           "inspectorUid": "01022225555",
+                           "userCount": 340
+                         },
+                     {
+                       "inspectorUid": "K20251212001",
+                       "userCount": 500
+                     }
+
+                   ]
+                 }
+                """)}
+        )),
+      @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+      @ApiResponse(responseCode = "404", description = "코드를 찾을 수 없음", content = @Content),
+      @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+    })
   @PostMapping("/allocate")
   public ApiResponseDto<Void> labelAllocate(@RequestBody LabelAllocateDto.AllocateDto dto) {
     labelAllocateService.allocateAsc(
-        dto.getAutoType(),
-        dto.getStage(),
-        dto.getLabelers(),
-        dto.getInspectors(),
-        dto.getAnalUid());
+      dto.getAutoType(),
+      dto.getStage(),
+      dto.getLabelers(),
+      dto.getInspectors(),
+      dto.getAnalUid());
 
     return ApiResponseDto.ok(null);
   }
 
   @Operation(summary = "추론 상세 조회", description = "분석 ID에 해당하는 추론 상세 정보를 조회합니다.")
   @ApiResponses(
-      value = {
-        @ApiResponse(responseCode = "200", description = "조회 성공"),
-        @ApiResponse(responseCode = "404", description = "데이터를 찾을 수 없음"),
-        @ApiResponse(responseCode = "500", description = "서버 오류")
-      })
-  @GetMapping
+    value = {
+      @ApiResponse(responseCode = "200", description = "조회 성공"),
+      @ApiResponse(responseCode = "404", description = "데이터를 찾을 수 없음"),
+      @ApiResponse(responseCode = "500", description = "서버 오류")
+    })
+  @GetMapping("/stage-detail")
   public ApiResponseDto<InferenceDetail> findInferenceDetail(
-      @Parameter(description = "분석 ID", required = true, example = "3") @RequestParam
-          Long analUid) {
+    @Parameter(description = "분석 ID", required = true, example = "3") @RequestParam
+    Long analUid) {
     return ApiResponseDto.ok(labelAllocateService.findInferenceDetail(analUid));
   }
+
+  @Operation(summary = "작업이관 > 라벨러 상세 정보", description = "작업이관 > 라벨러 상세 정보")
+  @GetMapping("/labeler-detail")
+  public ApiResponseDto<LabelerDetail> findLabelerDetail(@RequestParam(defaultValue = "01022223333") String userId, @RequestParam(defaultValue = "3") Long analUid) {
+    return ApiResponseDto.ok(labelAllocateService.findLabelerDetail(userId, analUid));
+  }
+
+  @Operation(summary = "작업 이관", description = "작업 이관")
+  @ApiResponses(
+    value = {
+      @ApiResponse(
+        responseCode = "201",
+        description = "등록 성공",
+        content =
+        @Content(
+          mediaType = "application/json",
+          schema = @Schema(implementation = Long.class),
+          examples = {@ExampleObject(
+            name = "라벨러 할당 예시",
+            description = "라벨러 할당 예시",
+            value =
+              """
+                {
+                   "autoType": "AUTO",
+                   "stage": 4,
+                   "labelers": [
+                     {
+                       "userId": "123456",
+                       "demand": 10
+                     },
+                     {
+                       "userId": "010222297501",
+                       "demand": 5
+                     }
+                   ]
+                 }
+                """)}
+        )),
+      @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+      @ApiResponse(responseCode = "404", description = "코드를 찾을 수 없음", content = @Content),
+      @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+    })
+  @PostMapping("/allocate-move")
+  public ApiResponseDto<Void> labelAllocateMove(
+    @io.swagger.v3.oas.annotations.parameters.RequestBody(
+      description = "라벨링 이관",
+      required = true,
+      content =
+      @Content(
+        mediaType = "application/json",
+        schema = @Schema(implementation = LabelAllocateDto.AllocateMoveDto.class)))
+    @RequestBody
+    LabelAllocateDto.AllocateMoveDto dto) {
+
+    labelAllocateService.allocateMove(
+      dto.getAutoType(), dto.getStage(), dto.getLabelers());
+
+    return ApiResponseDto.ok(null);
+  }
 }