국유인 API 진행중

src/main/java/com/kamco/cd/kamcoback/gukyuin/dto/ChngDetectMastDto.java

@@ -66,13 +66,30 @@ public class ChngDetectMastDto {
   @AllArgsConstructor
   public static class ChnDetectMastReqDto {
 
-    private String cprsYr; // 비교년도 2023
-    private String crtrYr; // 기준년도 2024
-    private String chnDtctSno; // 차수 (1 | 2 | ...)
-    private String chnDtctId; // 탐지아이디. UUID를 기반으로 '-'를 제거하고 대문자/숫자로 구성
-    private String pathNm; // 탐지결과 절대경로명 /kamco_nas/export/{chnDtctId}
-    private String reqEpno; // 사원번호
-    private String reqIp; // 사원아이피
+    @Schema(description = "비교년도", example = "2023")
+    private String cprsYr;
+
+    @Schema(description = "기준년도", example = "2024")
+    private String crtrYr;
+
+    @Schema(description = "차수", example = "1")
+    private String chnDtctSno;
+
+    @Schema(
+        description = "탐지아이디, UUID를 기반으로 '-'를 제거하고 대문자/숫자로 구성",
+        example = "D5F192EC76D34F6592035BE63A84F591")
+    private String chnDtctId;
+
+    @Schema(
+        description = "탐지결과 절대경로명 /kamco_nas/export/{chnDtctId}",
+        example = "/kamco-nfs/dataset/export/D5F192EC76D34F6592035BE63A84F591")
+    private String pathNm;
+
+    @Schema(description = "사원번호", example = "123456")
+    private String reqEpno;
+
+    @Schema(description = "사원아이피", example = "127.0.0.1")
+    private String reqIp;
   }
 
   @Getter
@@ -158,4 +175,29 @@ public class ChngDetectMastDto {
     private List<Basic> result;
     private Boolean success;
   }
+
+  @Schema(name = "RegistResDto", description = "reg 등록 후 리턴 형태")
+  @Getter
+  @Setter
+  @NoArgsConstructor
+  @AllArgsConstructor
+  public static class RegistResDto {
+
+    private Integer code;
+    private String message;
+    private Basic result;
+    private Boolean success;
+  }
+
+  @Schema(name = "LearnKeyDto", description = "learn 엔티티 key 정보")
+  @Getter
+  @Setter
+  @NoArgsConstructor
+  @AllArgsConstructor
+  public static class LearnKeyDto {
+
+    private Long id;
+    private String uid;
+    private String chnDtctMstId;
+  }
 }

src/main/java/com/kamco/cd/kamcoback/gukyuin/dto/GukYuinDto.java

@@ -1,21 +1,13 @@
 package com.kamco.cd.kamcoback.gukyuin.dto;
 
 import com.kamco.cd.kamcoback.common.utils.enums.EnumType;
+import java.util.UUID;
 import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.Setter;
 
 public class GukYuinDto {
 
-  @Getter
-  @Setter
-  public static class GukYuinLinkableRes {
-
-    private boolean linkable;
-    //    private GukYuinLinkFailCode code;
-    private String message;
-  }
-
   /** 실패 코드 enum */
   @Getter
   @AllArgsConstructor
@@ -39,10 +31,33 @@ public class GukYuinDto {
     }
   }
 
+  @Getter
+  @Setter
+  public static class GukYuinLinkableRes {
+
+    private boolean linkable;
+    //    private GukYuinLinkFailCode code;
+    private String message;
+  }
+
   // Repository가 반환할 Fact(조회 결과)
   public record GukYuinLinkFacts(
       boolean existsLearn,
       boolean isPartScope,
       boolean hasRunningInference,
       boolean hasOtherUnfinishedGukYuin) {}
+
+  @Getter
+  @Setter
+  @AllArgsConstructor
+  public static class LearnInfo {
+
+    private Long id;
+    private UUID uuid;
+    private Integer compareYyyy;
+    private Integer targetYyyy;
+    private Integer stage;
+    private String uid;
+    private String applyStatus;
+  }
 }

src/main/java/com/kamco/cd/kamcoback/gukyuin/dto/GukYuinStatus.java

@@ -11,6 +11,7 @@ public enum GukYuinStatus implements EnumType {
   IN_PROGRESS("진행중"),
   GUK_COMPLETED("국유인 매핑 완료"),
   PNU_COMPLETED("PNU 싱크 완료"),
+  PNU_FAILED("PNU 싱크 중 에러"),
   CANCELED("취소");
 
   private final String desc;