하이퍼파라미터 기능 추가

2026-02-03 14:31:53 +09:00
parent e2757d3ca0
commit 3a8d6e3ef0
18 changed files with 946 additions and 688 deletions
--- a/src/main/java/com/kamco/cd/training/hyperparam/HyperParamApiController.java
+++ b/src/main/java/com/kamco/cd/training/hyperparam/HyperParamApiController.java
@@ -0,0 +1,141 @@
+package com.kamco.cd.training.hyperparam;
+
+import com.kamco.cd.training.config.api.ApiResponseDto;
+import com.kamco.cd.training.hyperparam.dto.HyperParamDto;
+import com.kamco.cd.training.hyperparam.dto.HyperParamDto.List;
+import com.kamco.cd.training.hyperparam.service.HyperParamService;
+import com.kamco.cd.training.model.dto.ModelMngDto;
+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.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import java.time.LocalDate;
+import java.util.UUID;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@Tag(name = "하이퍼파라미터 관리", description = "하이퍼파라미터 관리 API")
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/hyper-param")
+public class HyperParamApiController {
+
+  private final HyperParamService hyperParamService;
+
+  @Operation(summary = "하이퍼파라미터 등록", description = "파라미터를 신규 저장")
+  @ApiResponses(
+      value = {
+        @ApiResponse(
+            responseCode = "200",
+            description = "등록 성공",
+            content =
+                @Content(
+                    mediaType = "application/json",
+                    schema = @Schema(implementation = String.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청", content = @Content),
+        @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+      })
+  @PostMapping
+  public ApiResponseDto<String> createHyperParam(
+      @Valid @RequestBody HyperParamDto.HyperParamCreateReq createReq) {
+    String newVersion = hyperParamService.createHyperParam(createReq);
+    return ApiResponseDto.ok(newVersion);
+  }
+
+  @Operation(summary = "하이퍼파라미터 수정", description = "파라미터를 수정")
+  @ApiResponses(
+      value = {
+        @ApiResponse(
+            responseCode = "200",
+            description = "등록 성공",
+            content =
+                @Content(
+                    mediaType = "application/json",
+                    schema = @Schema(implementation = String.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청", content = @Content),
+        @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+      })
+  @PutMapping("/{uuid}")
+  public ApiResponseDto<String> updateHyperParam(
+      @PathVariable UUID uuid, @Valid @RequestBody HyperParamDto.HyperParamCreateReq createReq) {
+    return ApiResponseDto.ok(hyperParamService.updateHyperParam(uuid, createReq));
+  }
+
+  @Operation(summary = "하이퍼파라미터 목록 조회", description = "하이퍼파라미터 목록 조회")
+  @ApiResponses(
+      value = {
+        @ApiResponse(
+            responseCode = "200",
+            description = "조회 성공",
+            content =
+                @Content(
+                    mediaType = "application/json",
+                    schema = @Schema(implementation = ModelMngDto.HyperParamInfo.class))),
+        @ApiResponse(responseCode = "404", description = "하이퍼파라미터를 찾을 수 없음", content = @Content),
+        @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+      })
+  @GetMapping("/list")
+  public ApiResponseDto<Page<List>> getHyperParam(
+      @Parameter(description = "구분") @RequestParam(required = false) String type,
+      @Parameter(description = "시작일") @RequestParam(required = false) LocalDate startDate,
+      @Parameter(description = "종료일") @RequestParam(required = false) LocalDate endDate,
+      @Parameter(description = "버전명") @RequestParam(required = false) String hyperVer,
+      @Parameter(
+              description = "정렬",
+              example = "createdDttm desc",
+              schema =
+                  @Schema(
+                      allowableValues = {
+                        "createdDttm,desc",
+                        "lastUsedDttm,desc",
+                        "totalUseCnt,desc"
+                      }))
+          @RequestParam(required = false)
+          String sort,
+      @Parameter(description = "페이지 번호 (0부터 시작)", example = "0") @RequestParam(defaultValue = "0")
+          int page,
+      @Parameter(description = "페이지 크기", example = "20") @RequestParam(defaultValue = "20")
+          int size) {
+    HyperParamDto.SearchReq searchReq = new HyperParamDto.SearchReq();
+    searchReq.setType(type);
+    searchReq.setStartDate(startDate);
+    searchReq.setEndDate(endDate);
+    searchReq.setHyperVer(hyperVer);
+    searchReq.setSort(sort);
+    searchReq.setPage(page);
+    searchReq.setSize(size);
+    Page<List> list = hyperParamService.getHyperParamList(searchReq);
+
+    return ApiResponseDto.ok(list);
+  }
+
+  @Operation(summary = "하이퍼파라미터 삭제", description = "하이퍼파라미터 삭제")
+  @ApiResponses(
+      value = {
+        @ApiResponse(responseCode = "200", description = "삭제 성공", content = @Content),
+        @ApiResponse(responseCode = "400", description = "H1은 삭제 불가", content = @Content),
+        @ApiResponse(responseCode = "404", description = "하이퍼파라미터를 찾을 수 없음", content = @Content),
+        @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+      })
+  @DeleteMapping("/{uuid}")
+  public ApiResponseDto<Void> deleteHyperParam(
+      @Parameter(description = "하이퍼파라미터 uuid", example = "7966dd64-004a-4596-89ef-001664bc4de2")
+          @PathVariable
+          UUID uuid) {
+    hyperParamService.deleteHyperParam(uuid);
+    return ApiResponseDto.ok(null);
+  }
+}