error-list api upgarde and sync api change to stable

src/main/java/com/kamco/cd/kamcoback/mapsheet/MapSheetMngApiController.java

@@ -71,9 +71,40 @@ public class MapSheetMngApiController {
   /**
    * 오류데이터 목록 조회
    *
-   * @param searchReq
-   * @return
+   * <p>도엽파일 동기화 시 발생한 오류 데이터를 조회합니다.
+   *
+   * <p>오류 타입:
+   *
+   * <ul>
+   *   <li>NOFILE - 파일없음
+   *   <li>NOTPAIR - 페어없음 (tif/tfw 중 하나만 존재)
+   *   <li>DUPLICATE - 중복 (동일한 파일이 여러개 존재)
+   *   <li>SIZEERROR - size 0 (파일 크기가 0)
+   *   <li>TYPEERROR - 형식오류 (tfw 검증 실패 또는 GeoTIFF 검증 실패)
+   * </ul>
+   *
+   * <p>sync_check_strt_dttm과 sync_check_end_dttm은 동일한 값으로 설정됩니다.
+   *
+   * @param searchReq 검색 조건 (년도, 검색어, syncStateFilter 등)
+   * @return 오류 데이터 목록
    */
+  @Operation(
+      summary = "오류데이터 목록 조회",
+      description =
+          "도엽파일 동기화 시 발생한 오류 데이터를 조회합니다. "
+              + "오류 타입: NOFILE(파일없음), NOTPAIR(페어없음), DUPLICATE(중복), SIZEERROR(size 0), TYPEERROR(형식오류)")
+  @ApiResponses(
+      value = {
+        @ApiResponse(
+            responseCode = "200",
+            description = "조회 성공",
+            content =
+                @Content(
+                    mediaType = "application/json",
+                    schema = @Schema(implementation = MapSheetMngDto.ErrorDataDto.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+      })
   @PostMapping("/error-list")
   public ApiResponseDto<Page<MapSheetMngDto.ErrorDataDto>> findMapSheetErrorList(
       @RequestBody @Valid MapSheetMngDto.ErrorSearchReq searchReq) {

src/main/java/com/kamco/cd/kamcoback/mapsheet/dto/MapSheetMngDto.java

@@ -128,6 +128,11 @@ public class MapSheetMngDto {
     @Schema(description = "년도", example = "2025")
     private Integer mngYyyy;
 
+    @Schema(
+        description = "동기화 상태 필터 (NOFILE, NOTPAIR, DUPLICATE, SIZEERROR, TYPEERROR)",
+        example = "NOFILE")
+    private String syncStateFilter;
+
     public Pageable toPageable() {
       if (sort != null && !sort.isEmpty()) {
         String[] sortParams = sort.split(",");
@@ -153,6 +158,18 @@ public class MapSheetMngDto {
     private Integer mapCodeSrc;
     private String createdDttm;
     private DataState dataState;
+
+    @Schema(description = "동기화 상태 (NOFILE, NOTPAIR, DUPLICATE, SIZEERROR, TYPEERROR)")
+    private String syncState;
+
+    @Schema(description = "동기화 체크 상태")
+    private String syncCheckState;
+
+    @Schema(description = "동기화 체크 시작 시간")
+    private java.time.LocalDateTime syncCheckStrtDttm;
+
+    @Schema(description = "동기화 체크 종료 시간")
+    private java.time.LocalDateTime syncCheckEndDttm;
   }
 
   @Schema(name = "DmlReturn", description = "영상관리 DML 수행 후 리턴")
@@ -224,4 +241,27 @@ public class MapSheetMngDto {
       return desc;
     }
   }
+
+  @Getter
+  @AllArgsConstructor
+  public enum SyncErrorState implements EnumType {
+    NOFILE("파일없음"),
+    NOTPAIR("페어없음"),
+    DUPLICATE("중복"),
+    SIZEERROR("size 0"),
+    TYPEERROR("형식오류"),
+    DONE("정상");
+
+    private final String desc;
+
+    @Override
+    public String getId() {
+      return name();
+    }
+
+    @Override
+    public String getText() {
+      return desc;
+    }
+  }
 }