Files
frontend/apps/sn/docs/작업계획/SN-인수테스트-팝업자료출처표시/001-fe-SN-팝업자료출처표시-작업결과.md
T

4.2 KiB

SN 인수테스트 팝업 자료 출처 표시 FE 작업 결과

1. 작업 목적

  • 인수테스트(2026-10-16) 고객 요구: "팝업화면 자료의 원천 표시 및 자료 업데이트 주기 표시".
  • 대상 팝업 7개(침수예측, 침수흔적도, 지반침하정보, 통수위험, 침수위험지도, 도시침수지도, 관로분석)의 목록 아래에 자료 출처·분석 주기 문구를 넣는다.
  • 기존 하단 설명이 있는 팝업은 그 설명을 유지하고 글머리표로 문구를 더한다(사용자 지시 2026-10-21).

2. 근거

  • 인수테스트_요구사항_1016.pptx 1쪽(공통 요청), 2~8쪽(화면별 문구). 원본 파일은 사용자 공유 드라이브에 있으며 저장소에는 넣지 않았다.
  • 문구는 슬라이드 내용을 그대로 옮겼다. 줄 끝 쉼표 제거, 출처 : 띄어쓰기 통일, 문장 끝 마침표 정도만 맞췄다.

3. 화면별 반영 내용

슬라이드 팝업 수정 파일 하단 글머리표
2 침수예측현황 src/features/fldng-predc-prst/ui/fldng-predc-prst-popup-content.tsx (기존) 빈도별 위험·경계·주의 기준, (기존) 행 선택 안내, 분석 실행 시기, 분석 방법(확률강우량 출처 map.wamis.go.kr, 도시침수지도 출처 한강홍수통제소)
3 통수위험 app/(map-layout)/map/components/water-risk/water-risk-popup-page.tsx 판정 기준(위험·위험(매핑관로없음)·정상), 지도에 빨간 관로가 안 보일 수 있는 경우, 분석 실행 시기, 분석 방법(SWMM), 최대 침수예상시점·최대침수유량 설명
4 침수발생이력(침수흔적도) app/(map-layout)/map/components/fldng-hstry/fldng-hstry-popup-page.tsx (기존) 행 클릭 안내, 출처 : 행정안전부 재난보험과(2002년~2025년)
5 도시침수지도 목록 app/(map-layout)/map/components/flood-dngr-map/flood-dngr-map-popup-page.tsx 출처 : 한강홍수통제소, 행정구역별 도시침수지도(2025.09)
6 침수위험지도 목록 app/(map-layout)/map/components/sbmrg-dngr-map/sbmrg-dngr-map-popup-page.tsx 출처 : 하수도정비 중점관리지역 20개소 과업 산출물
7 지반침하 목록 app/(map-layout)/map/components/sinkhole/sinkhole-popup-page.tsx 출처 : 지하안전정보시스템 지반침하사고 정보 연계 표출(연계 주기 : 매 시간 연계)
8 관로분석 app/(map-layout)/map/components/pipe-analysis/pipe-analysis-popup-page.tsx 국토교통부로부터 제공받은 GIS 관로정보(2025년)를 기반으로 분석하고 있음
  • 공통 표시 컴포넌트 src/features/window-popup/ui/popup-footer-note.tsx(신규): 침수예측현황 하단 안내와 같은 글꼴(text-xl text-muted-foreground)의 글머리표 목록. 7개 팝업이 같은 모양을 쓴다.
  • 통수위험: 판정 기준 문구를 목록 머리글 오른쪽에서 하단으로 옮겼다(슬라이드 3 "침수예측과 동일한 위치에 표시할것").
  • 침수발생이력: 기존 회색 상자 안내를 공통 글머리표 모양으로 바꿨다(문구 유지).

4. 검증

  • tsc --noEmit(sn 전체) 통과.
  • ESLint: 변경 8개 파일 모두 수정 전과 같은 결과(침수예측현황의 기존 미사용 import createPredictionAnalysisTimeRange 1건 외 0건).
  • git diff --check 통과.
  • 미실행: 로그인이 필요해 실제 팝업 화면 확인 못 함. next build 미실행.

5. 영향·롤백·남은 위험

  • 영향: 7개 팝업의 목록 아래 문구 표시만 바뀐다. API·상태·데이터 변경 없음.
  • 롤백: 위 7개 파일을 되돌리고 popup-footer-note.tsx를 삭제한다.
  • 남은 위험
    • 팝업 높이가 낮으면 하단 문구가 길어(통수위험 5줄) 목록 영역이 그만큼 줄어든다. 화면 확인 후 필요하면 글꼴·간격을 조정한다.
    • 슬라이드 문구 중 "관측강우가 0mm이상으로 강우가 발생시"는 고객 문구 그대로 두었다. 의미상 "0mm 초과"인지 고객 확인이 필요할 수 있다.
    • 슬라이드 4의 "25년까지 데이터가 있는데 자동으로 26년으로 설정되는 문제"(지도 레이어 침수흔적도 연도 기본값)는 이번 범위(하단 문구)가 아니라 수정하지 않았다.