Merge branch 'iipbs/sn/dev' into iipbs/sn/dev_kic

This commit is contained in:
kiminchan
2026-07-29 13:31:01 +09:00
24 changed files with 827 additions and 147 deletions
@@ -0,0 +1,10 @@
# SFR-011-001 시도별 노후관로현황 FE 검증 기록
## 1. 정적 확인
- 분석도구 메뉴, popup definition, popup registry, popup page 연결을 코드 기준으로 확인했다.
- 동적 연도 컬럼 생성 로직과 CSV 다운로드 호출 경로를 확인했다.
## 2. 실행 확인
- `pnpm --filter sn build`
- 결과: 시간 제한 내 완료되지 않아 최종 성공/실패를 확정하지 못했다.
- 비고: 이 저장소는 기존에도 FE build가 환경 영향으로 지연 또는 `EMFILE` 이슈가 있었으므로 사용자 로컬 실행 확인이 추가로 필요하다.
@@ -0,0 +1,19 @@
# SFR-011-001 시도별 노후관로현황 FE 작업카드
## 1. 작업 목적
- 하수관망도 우측 분석도구에서 `시도별 노후관로현황` 팝업을 열고 기준년도 구간별 시도 집계를 조회한다.
## 2. 구현 범위
- `AnalysisPopupMenu`에 진입 버튼 추가
- `windowPopup` registry에 새 popup key 추가
- 전용 popup page 구현
- 기준년도 시작/종료, 경과년도 기본값 30년, CSV 다운로드 연결
## 3. 구현 기준
- 기존 `노후관로 현황` popup의 레이아웃 톤과 다운로드 UX를 최대한 재사용한다.
- 집계형 표이므로 지도 feature 선택 연동은 넣지 않는다.
- 기준년도 범위는 최대 3년까지만 허용한다.
## 4. 연동 API
- `GET /api/v1/swagePpl/aged-status-by-ctpv`
- `POST /api/v1/swagePpl/aged-status-by-ctpv/exportJobs/download`
@@ -0,0 +1,22 @@
# SFR-011-001 시도별 노후관로현황 FE 통합 구현 기록
## 1. 구현 요약
- 분석도구 메뉴에 `시도별 노후관로현황` 항목을 추가했다.
- 새 popup key `agedPipeStatusByCtpvPopup`와 registry content를 연결했다.
- 전용 popup page에서 기준년도 시작/종료, 경과년도(기본 30년), 조회, CSV 다운로드를 구현했다.
- 응답의 `years + rows.yearStats` 구조를 동적 컬럼 `UiTable` row로 변환하도록 유틸을 추가했다.
## 2. 주요 수정 파일
- `app/(map-layout)/map/components/analysisMenu/AnalysisPopupMenu.tsx`
- `src/features/windowPopup/model/popupDefinitions.ts`
- `src/features/windowPopup/registry.tsx`
- `src/features/windowPopup/ui/AgedPipeStatusByCtpvPopupContent.tsx`
- `app/(map-layout)/map/components/agedPipeStatusByCtpv/AgedPipeStatusByCtpvPopupPage.tsx`
- `app/(map-layout)/map/components/agedPipeStatusByCtpv/agedPipeStatusByCtpvUtils.ts`
- `app/(map-layout)/map/components/agedPipeStatusByCtpv/agedPipeStatusByCtpvExport.ts`
## 3. 화면 동작
- popup 제목은 `시도별 노후관로현황`이다.
- 기준년도 범위는 최대 3년으로 제한한다.
- 경과년도는 기본 `30년`으로 시작하고, 후속에 사용자가 변경 가능한 입력 구조를 미리 반영했다.
- CSV 다운로드는 기존 노후관로 popup과 동일하게 `postBlobData + fileDownload` 흐름을 따른다.
@@ -71,3 +71,15 @@
- popup 라우트의 초기 컴파일 시간이 길어 자동 요청에서 timeout이 발생할 수 있다.
- `침수흔적도` 기준데이터 이름/구조와 FE 판별식이 다를 수 있다.
- 실제 API 필드가 확정되면 상세패널 항목명/정렬이 일부 바뀔 수 있다.
## 7. 2026-07-28 지도 클릭 강우분석 조회 연동
- 반영 파일
- `FE_APP_ROOT/app/(map-layout)/map/components/popupComponent/featureClickEventPopup.tsx`
- `FE_APP_ROOT/app/(map-layout)/map/components/common/table.ts`
- 구현 내용
- 지도에서 `침수흔적도(tb_ms_fldng_wtlv_map)`를 클릭해 우측 상세를 열면, 기존 원본 속성값만 보여주던 구조에 `fid` 기준 강우분석 조회를 추가했다.
- FE는 `GET /api/v1/fldng/hstry/rain-anls/{fid}`를 추가 호출한 뒤 `tb_sn_fldng_wtlv_rain_anls` 응답을 상세 테이블 데이터에 merge한다.
- 침수흔적도 상세 컬럼에 `강우시작일시`, `강우종료일시`, `총강우량(mm)`, `강우강도(mm/hr)`를 추가했다.
- 영향
- 레이어 트리 popup 목록과 별도로, 실제 지도 객체 클릭 상세에서도 강우분석 정보를 동일하게 확인할 수 있다.