Files
frontend/apps/sn/docs/작업계획/SFR-011-008-침수예측/002-maintenance-SFR-011-008-침수예측현황-확률강우량-작업계획.md
T

3.5 KiB

SFR-011-008 침수예측현황 확률강우량 FE 유지보수 작업계획

작업 목적

침수예측현황의 선택 시군구가 어떤 확률강우량 기준으로 위험도가 산정되는지 확인할 수 있도록 목록 열과 기준표 팝업을 추가한다.

승인 상태

  • maintenance 작업계획
  • 2026-10-02 사용자 승인, 코드 구현 진행

구현 계획

  • FldngPredcPrstPopupContent의 침수위험도 오른쪽에 확률강우량 액션을 추가한다.
  • 기준표 팝업 컴포넌트 파일은 표준용어를 사용한 PrbbtRnflDialog.tsx로 둔다.
  • 목록의 확률강우량은 predc_rain_hr 기준 N시간 형식의 클릭 가능한 지속시간으로 표시한다. 기존 predictionHour(predc_hr)와 구분한다.
  • 선택 행의 sggCd로 BE 확률강우량 조회 API를 호출한다.
  • API 경로는 사용자 지정 GET /api/v1/fldng/predc/prst/prbbt-rnfl을 사용한다.
  • 팝업 표는 재현기간을 행, 1시간, 2시간, 3시간 형식의 지속시간을 열로 표시한다.
  • 팝업 하단에 확률관측소코드·관측소명·면적비율(%) 비율표를 표시한다.
  • 팝업 맨 아래에 시간은 강우가 지속된 시간입니다 안내를 표시한다.
  • 지속시간 헤더는 기존 팝업 표 헤더 스타일을 유지한다.
  • 선택 행의 대표 지속시간과 초과빈도년도가 교차하는 확률강우량 기준값 한 셀만 강조 색상으로 표시한다. 표 헤더는 기존 스타일을 유지한다.
  • 팝업 표가 표시되면 선택한 지속시간 열이 보이도록 표 내부 가로 스크롤을 자동으로 맞춘다.
  • 선택 행의 초과빈도년도에 해당하는 재현기간 행은 년도와 강수량 글씨를 굵게 표시한다.
  • 강수량은 mm 단위로 표시하고 로딩·빈 결과·오류 상태를 제공한다.
  • 기존 행 클릭의 도시침수지도 이동과 별도 액션으로 동작시킨다.
  • 현황 목록의 분석시각·강우시작시각은 분까지 말줄임 없이 표시하며, 좁은 팝업에서는 표의 가로 스크롤을 사용한다.

검증 계획

  • 제주·서울 등 서로 다른 시군구 기준표 조회
  • 1~72시간 행과 빈도년도 열 표시
  • API 오류·빈 결과 표시
  • 기존 지도 이동 회귀
  • pnpm --filter sn run build

구현 결과 (2026-10-02)

  • 현황 목록에 확률강우량 열을 추가하고 대표 지속시간 predcRainHr를 N시간 링크로 표시한다.
  • 링크 클릭은 행 선택 지도 이동을 실행하지 않으며, 시군구별 기준표 팝업을 연다.
  • 팝업은 재현기간 행×지속시간 열의 확률강우량, 하단 관측소 면적비율과 API 합계를 표시한다.
  • 선택 지속시간·초과빈도년도의 교차값 한 셀만 색으로 강조하고 헤더는 기존 스타일을 유지한다.
  • 팝업 표의 선택 지속시간 열은 로딩 완료 후 표 내부 가로 스크롤 영역 중앙에 자동으로 나타난다.
  • 선택 초과빈도년도의 재현기간 행은 년도와 강수량을 굵게 표시한다.
  • 현황 목록은 자동 표 레이아웃을 유지하고 widthPercent 합계를 100%로 맞춘다. 분석시각·강우시작시각은 각각 13%를 적용해 분까지 표시하며, 최소 표 너비 112rem과 가로 스크롤을 유지한다.
  • pnpm --filter sn run typecheck, git diff --check가 통과했다. 빌드 중 3002 포트 개발 서버가 확인되어 에이전트가 시작한 빌드만 중단했으며, 빌드 완료와 실화면 검증은 미확인이다.