package incheon.ags.dss.under.web.dto;

import java.time.LocalDateTime;

import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Getter;
import lombok.Setter;

/**
 * 지반침하(싱크홀) 공공데이터 Open API 요청 DTO
 * (국토교통부 API 스펙: sagoDateFrom, sagoDateTo, pageNo, numOfRows)
 */
@Getter
@Setter
@Schema(description = "지반침하 Open API 목록 조회 요청 파라미터")
public class UrbUdgdSnkgOpenApiReqDTO {
    @Schema(description = "조회 시작일 (YYYYMMDD)", example = "20180101", requiredMode = Schema.RequiredMode.REQUIRED)
    private String sagoDateFrom; 

    @Schema(description = "조회 종료일 (YYYYMMDD)", example = "20191231", requiredMode = Schema.RequiredMode.REQUIRED)
    private String sagoDateTo;

    @Schema(description = "페이지 번호", example = "1", defaultValue = "1")
    private int pageNo = 1;

    @Schema(description = "한 페이지당 결과 수", example = "10", defaultValue = "10")
    private int numOfRows = 10;
    
    // 상세 조회용 (목록 조회시에는 사용 안 하므로 hidden 처리 가능, 필요 시 사용)
    @Schema(description = "사고번호 (상세 조회 시 사용)", example = "20190001", hidden = true)
    private String sagoNo;
    
    @Schema(description = "대상지 구역 번호 (입력 시 해당 시군구로 자동 필터링)", example = "60")
    private Integer zoneNo;  // [ADD] 대상지 번호 추가
}