5.0 KiB
5.0 KiB
SFR-010-010 지반침하정보 통합 검증 계획
1. 문서 목적
SFR-010-010 지반침하정보의 검증 계획을 기능당 1개 문서로 누적 관리한다.- 이번 턴은 설계 단계이므로 구현 전 검증 시나리오와 차단 조건을 먼저 기록한다.
- 승인 후 구현이 시작되면 이 문서에 라운드별 검증 계획을 계속 추가한다.
2. 검증 기준 요약
- 레이어 트리에서
지반침하정보체크/해제가 동작해야 한다. - 목록 아이콘 클릭 시 지반침하 목록 팝업이 열려야 한다.
- 목록 조회조건 검증이 동작해야 한다.
- 날짜 누락 차단
2016-01-01이전 날짜 차단
- 목록 행 클릭 또는 지도 포인트 클릭 시 우측 상세 패널이 열려야 한다.
- 반경 적용 시 지도 원과 반경 내 관로 목록이 함께 갱신돼야 한다.
- 좌표 없음/좌표 변환 실패/반경 내 관로 없음 케이스가 서로 다른 안내로 분기돼야 한다.
- 관리자만 동기화 버튼과 관련 운영 정보를 볼 수 있어야 한다.
3. 라운드별 검증 계획
3.1 설계 단계 사전 계획
- FE 화면 구조 검증
- 레이어 트리 행 구성
- 반경 패널 위치
- 목록 팝업 열림 방식
- 우측 상세 패널 레이아웃
- BE 계약 검증
- geometry/list/detail/nearby/sync/download endpoint 일치 여부
- 원천 부재 필드 nullable 처리 여부
- 관리자 권한 분리 여부
- DB 영향 검증
- IL 원천 조회
- 반경 내 관로 조회 대상
- 좌표 캐시 영속화 필요 여부
3.2 구현 후 예정 검증
- 지반침하 레이어 체크/해제 시 지도 포인트 표출 여부
- 목록 팝업 조회 / 결과 없음 / 다운로드 검증
- 목록 행 클릭 후 지도 중심 이동과 상세 패널 오픈
- 지도 포인트 클릭 후 상세 패널 오픈
- 반경 값 변경 후 재조회
- 좌표 없는 사고건 상세 표시
- 관리자 동기화 성공/실패 검증
3.3 2026-06-26 레이어 연도범위 설정 전환 검증 계획
- 레이어 트리 검증
지반침하정보루트만 표시되고2026년,전체자식 노드가 표시되지 않는지 확인한다.- 루트 체크/해제만으로 지도 포인트 레이어가 on/off 되는지 확인한다.
- 선택 레이어 설정 검증
지반침하정보체크 시 하단선택 레이어 설정에 반경 입력과 함께시작년도,종료년도가 표시되는지 확인한다.- 현재 연도 2026 기준 최초값이
2025,2026인지 확인한다. - 적용 시
/api/v1/sinkholes요청에startYmd=20250101,endYmd=20261231이 포함되는지 확인한다. - 시작년도가 종료년도보다 큰 경우, 2016년 이전 입력, 4자리 미만 입력을 차단하는지 확인한다.
- 기존 기능 회귀 검증
- 반경 입력/적용, 우측 상세 패널, 반경 내 관로 조회가 기존처럼 동작하는지 확인한다.
- 목록 팝업 오픈 시 설정패널 연도 범위가 초기 조회조건으로 전달되는지 확인한다.
- 팝업 조회 후 지도 동기화와 팝업 닫힘 후 복귀 기준이 문서화된 정책과 일치하는지 확인한다.
- DB 기준정보 검증
tb_sn_lyr_stng에서지반침하정보루트는 유지되고2026년,전체자식 행이 삭제 또는 비활성화됐는지 확인한다.
4. 브라우저 검증 선행조건
/map진입 가능한 로그인 상태- FE dev 서버와 BE API 동시 기동
- IL 원천 데이터와 관로 데이터 접근 가능
- 관리자/일반 사용자 계정 각각 1개 이상
5. 차단 사유 분류 기준
기능 결함- 화면 상태 전이 또는 API 응답 처리 오류
인증 차단- 로그인/권한 부족
환경 차단- 서버 미기동, 프록시, 네트워크 문제
데이터 차단- 원천 데이터 또는 샘플 사고건 부족
계약 미확정- 원천 부재 필드 처리, 캐시 정책, 팝업 방식 미확정
6. 현재 보류 메모
- 이번 턴은 설계 단계이므로 실제 브라우저/API 실행 검증은 수행하지 않는다.
- 구현 승인 전에는 이 문서의 시나리오와 설계 문서의 계약 일치 여부만 점검 대상으로 둔다.
3.4 2026-06-26 레이어 연도범위 설정 전환 구현 검증 계획
- 지반침하정보 레이어 트리에
2026년,전체자식 노드가 표시되지 않고 루트 레이어만 on/off 되는지 확인한다. - 선택 레이어 설정 패널에 시작년도/종료년도 입력이 표시되고 기본값이 현재년도 기준 최근 1년인지 확인한다.
- 연도 범위 적용 후 지도 조회 요청의
startYmd/endYmd가 시작년도0101, 종료년도1231로 변환되는지 확인한다. - 목록 팝업을 열었을 때 현재 지도 연도 범위가 초기 조회조건으로 전달되는지 확인한다.
- 잘못된 연도 입력(4자리 미만, 시작년도 > 종료년도, 2016년 이전, 현재년도 초과)이 차단되는지 확인한다.