frontend/apps/sn/docs/작업계획/SFR-011-001-시도별 노후관로현황/001-fe-SFR-011-001-시도별 노후관로현황-작업카드.md

SFR-011-001 시도별 노후관로현황 FE 작업카드

2026-09-11 API 계약 현행화: 아래 호출 경로는 lowerCamelCase 단일 계약으로 갱신했다. 기존 alias는 사용하지 않는다. 경로 단일화 변경기록을 기준으로 한다.

유지보수 반영 (2026-09-04)

• 목록의 연도별 결과 컬럼을 연도 그룹 헤더로 묶어 표시한다.
• 엑셀 다운로드는 조회 결과를 프론트엔드에서 XLSX로 생성하며, 목록과 동일한 연도 그룹 헤더와 하위 컬럼을 사용한다.

1. 작업 목적

• 하수관망도 우측 분석도구에서 시도별 노후관로현황 팝업을 열고 기준년도 구간별 시도 집계를 조회한다.

2. 구현 범위

• AnalysisPopupMenu에 진입 버튼 추가
• windowPopup registry에 새 popup key 추가
• 전용 popup page 구현
• 기준년도 시작/종료, 경과년도 기본값 30년, FE XLSX 다운로드 연결

3. 구현 기준

• 기존 노후관로 현황 popup의 레이아웃 톤과 다운로드 UX를 최대한 재사용한다.
• 집계형 표이므로 지도 feature 선택 연동은 넣지 않는다.
• 기준년도 범위는 최대 3년까지만 허용한다.

4. 연동 API

• GET /api/v1/swagePpl/agedStatusByCtpv
• 별도 백엔드 Excel API를 호출하지 않고 조회 응답으로 FE에서 XLSX 생성