노후관로 ai 개발 기능 테스트_V1.0
This commit is contained in:
@@ -0,0 +1,160 @@
|
||||
# 프론트 AI 문서 구조 기준
|
||||
|
||||
## 1. 목적
|
||||
|
||||
이 문서는 `sn` 프론트엔드 작업에서 AI와 개발자가 같은 기준으로 문서를 읽고 작성하기 위한 문서 구조 기준이다.
|
||||
|
||||
프론트 문서는 단순 기록이 아니라, 화면 구현 전에 요구사항, 컴포넌트, API 사용, 상태 흐름, 브라우저 검증 기준을 빠르게 파악하기 위한 작업 입력이다.
|
||||
|
||||
## 2. 적용 범위
|
||||
|
||||
| 구분 | 기준 경로 | 역할 |
|
||||
| --- | --- | --- |
|
||||
| 프론트 앱 기준 | `SN_APP_ROOT/AGENTS.md` | `sn` 작업 규칙과 수정 가능 범위 |
|
||||
| AI 기준문서 | `SN_APP_ROOT/docs/AI코딩하네스/기준문서/` | 앱 작업 정책 |
|
||||
| 작업계획 | `SN_APP_ROOT/docs/AI코딩하네스/작업계획/` | 화면/기능별 작업카드 |
|
||||
| 검증 | `SN_APP_ROOT/docs/AI코딩하네스/검증/` | 브라우저/빌드/네트워크 검증 기준 |
|
||||
| 보고 | `SN_APP_ROOT/docs/AI코딩하네스/보고/` | 작업 결과와 이슈 기록 |
|
||||
| 기능 문서 | `SN_APP_ROOT/docs/{기능명}/` | 화면별 구현 산출물 |
|
||||
| 프론트 공통 문서 | `FE_REPO_ROOT/docs/` | 여러 앱이 공유하는 FE 기준 |
|
||||
|
||||
## 3. 기준문서 구조
|
||||
|
||||
경로:
|
||||
|
||||
```text
|
||||
SN_APP_ROOT/docs/AI코딩하네스/기준문서/
|
||||
```
|
||||
|
||||
현재 기준:
|
||||
|
||||
```text
|
||||
001-프로젝트.md
|
||||
002-화면맵.md
|
||||
003-API사용.md
|
||||
004-컴포넌트정책.md
|
||||
005-상태관리정책.md
|
||||
006-검증정책.md
|
||||
007-멀티에이전트운영.md
|
||||
008-문서구조기준.md
|
||||
009-AI개발작업흐름.md
|
||||
```
|
||||
|
||||
역할:
|
||||
|
||||
- `sn` 앱의 작업 대상과 금지 경로 확인
|
||||
- 화면/라우트 구조 확인
|
||||
- API 호출 방식 확인
|
||||
- 기존 컴포넌트 재사용 기준 확인
|
||||
- 상태관리 기준 확인
|
||||
- 검증 기준 확인
|
||||
- BE/FE 역할 분리 기준 확인
|
||||
|
||||
## 4. 기능 문서 구조
|
||||
|
||||
기능별 문서는 아래 위치에 둔다.
|
||||
|
||||
```text
|
||||
SN_APP_ROOT/docs/{기능명}/
|
||||
```
|
||||
|
||||
권장 구조:
|
||||
|
||||
```text
|
||||
README.md
|
||||
00-범위.md
|
||||
01-기존화면기반-컴포넌트분해.md
|
||||
02-컴포넌트별-작업목록.md
|
||||
03-API응답필드매핑표.md
|
||||
04-화면흐름.md
|
||||
05-검증계획.md
|
||||
06-검증결과.md
|
||||
99-미확인사항.md
|
||||
```
|
||||
|
||||
문서별 역할:
|
||||
|
||||
| 문서 | 역할 |
|
||||
| --- | --- |
|
||||
| `README.md` | 기능 문서 진입점 |
|
||||
| `00-범위.md` | 구현 대상과 제외 범위 |
|
||||
| `01-기존화면기반-컴포넌트분해.md` | 기존 화면/컴포넌트 재사용 후보 |
|
||||
| `02-컴포넌트별-작업목록.md` | 컴포넌트 단위 작업 목록 |
|
||||
| `03-API응답필드매핑표.md` | 화면에서 사용하는 API와 응답 필드 |
|
||||
| `04-화면흐름.md` | 사용자 동작과 화면 상태 흐름 |
|
||||
| `05-검증계획.md` | 브라우저/네트워크/빌드 검증 계획 |
|
||||
| `06-검증결과.md` | 실제 검증 결과 |
|
||||
| `99-미확인사항.md` | BE/FE/API/DB 미확정 이슈 |
|
||||
|
||||
## 5. 프론트 공통 문서와 `sn` 문서 구분
|
||||
|
||||
`SN_APP_ROOT/docs/**`는 `sn` 앱 특정 화면과 기능을 다룬다.
|
||||
|
||||
`FE_REPO_ROOT/docs/**`는 여러 앱이 함께 보는 공통 기준만 다룬다.
|
||||
|
||||
| 상황 | 문서 위치 |
|
||||
| --- | --- |
|
||||
| `sn` 특정 화면 구현 | `SN_APP_ROOT/docs/{기능명}/` |
|
||||
| `sn` API 필드 매핑 | `SN_APP_ROOT/docs/{기능명}/03-API응답필드매핑표.md` |
|
||||
| `sn` 검증 결과 | `SN_APP_ROOT/docs/{기능명}/06-검증결과.md` |
|
||||
| 여러 앱 공통 상태관리 기준 | `FE_REPO_ROOT/docs/구조/` |
|
||||
| 여러 앱 공통 응답 처리 기준 | `FE_REPO_ROOT/docs/응답표준화/` |
|
||||
|
||||
## 6. 백엔드 문서와 연결 기준
|
||||
|
||||
프론트 기능이 백엔드 계약에 의존하면 아래 문서를 함께 본다.
|
||||
|
||||
```text
|
||||
BE_SERVICE_ROOT/docs/AI코딩하네스/작업계획/{작업카드}.md
|
||||
BE_SERVICE_ROOT/docs/AI코딩하네스/DB/{DB문서}.md
|
||||
BE_SERVICE_ROOT/docs/실행명세/**
|
||||
```
|
||||
|
||||
연결 방식:
|
||||
|
||||
| 프론트 문서 | 연결되는 백엔드 문서 |
|
||||
| --- | --- |
|
||||
| API 응답 필드 매핑표 | BE 작업카드, API 정책 |
|
||||
| 화면흐름 | BE API 처리 흐름 |
|
||||
| 미확인사항 | BE 작업계획, DB 문서 |
|
||||
| 검증계획 | QA 카드, BE 테스트/실행명세 |
|
||||
|
||||
## 7. 작성 원칙
|
||||
|
||||
1. 화면 구현 전에 기능 문서를 먼저 확인한다.
|
||||
2. 기존 컴포넌트 재사용 가능성을 먼저 기록한다.
|
||||
3. API 응답 필드는 화면 표시명과 실제 필드명을 함께 적는다.
|
||||
4. 미확정 API/DB 이슈는 `99-미확인사항.md`에 남긴다.
|
||||
5. 검증 결과는 실제 브라우저 동작 기준으로 남긴다.
|
||||
6. 정적 HTML은 참고 자료이고 실제 구현은 `apps/sn` 코드와 기존 컴포넌트 조합으로 한다.
|
||||
7. 공통 패키지 수정이 필요하면 영향 범위를 먼저 정리한다.
|
||||
|
||||
## 8. 적용 예시: 노후관로관리
|
||||
|
||||
노후관로관리 문서는 아래 역할로 사용한다.
|
||||
|
||||
```text
|
||||
SN_APP_ROOT/app/html/06. 노후관로관리_시나리오_v1.0.md
|
||||
→ 화면 요구사항과 사용자 동작 확인
|
||||
|
||||
SN_APP_ROOT/docs/노후관로관리/03-API응답필드매핑표.md
|
||||
→ 목록/상세/위치 이동에 필요한 API 필드 확인
|
||||
|
||||
SN_APP_ROOT/docs/노후관로관리/99-미확인사항.md
|
||||
→ 백엔드 확인 이슈 관리
|
||||
|
||||
BE_SERVICE_ROOT/docs/AI코딩하네스/DB/001-노후관로-레이어설정.md
|
||||
→ 레이어 트리 DB 기준 데이터 반영안 확인
|
||||
```
|
||||
|
||||
## 9. 유지보수 기준
|
||||
|
||||
아래 상황에서는 문서를 갱신한다.
|
||||
|
||||
- 화면 흐름 변경
|
||||
- API endpoint 또는 응답 필드 변경
|
||||
- 컴포넌트 구조 변경
|
||||
- 상태관리 방식 변경
|
||||
- 브라우저 검증 결과 확정
|
||||
- 미확인사항 해결
|
||||
- 백엔드 계약 변경
|
||||
@@ -0,0 +1,244 @@
|
||||
# 프론트 AI 개발 작업 흐름
|
||||
|
||||
## 1. 목적
|
||||
|
||||
이 문서는 `sn` 프론트엔드 기능 개발을 AI와 함께 진행할 때 따르는 표준 작업 흐름이다.
|
||||
|
||||
기능마다 화면과 API는 달라질 수 있지만, 작업 기준 확인, 기존 화면/컴포넌트 확인, API 계약 확인, 최소 구현, 브라우저 검증, 결과 기록의 큰 흐름은 유지한다.
|
||||
|
||||
## 2. 기본 원칙
|
||||
|
||||
1. `AGENTS.md`와 `sn` 기준문서를 먼저 확인한다.
|
||||
2. 기존 화면과 컴포넌트를 먼저 찾는다.
|
||||
3. `apps/sn` 내부 해결을 우선한다.
|
||||
4. 공통 패키지는 `business_components`만 허용 범위에서 수정한다.
|
||||
5. `@common/components`, `@common/network`, `@common/auth` 등 금지 범위는 직접 수정하지 않는다.
|
||||
6. 백엔드 응답을 임의로 가정하지 않고 API 문서와 실제 응답을 확인한다.
|
||||
7. 구현 후 브라우저 동작과 네트워크 응답을 확인한다.
|
||||
|
||||
## 3. 표준 작업 흐름
|
||||
|
||||
```text
|
||||
1. 작업 기준 확인
|
||||
2. 기능 문서 확인
|
||||
3. 기존 화면/컴포넌트 탐색
|
||||
4. API 사용부와 응답 필드 확인
|
||||
5. 상태관리와 화면 흐름 확인
|
||||
6. 구현 방향 결정
|
||||
7. 최소 범위 구현
|
||||
8. 빌드/브라우저/네트워크 검증
|
||||
9. 검증 결과와 남은 리스크 기록
|
||||
```
|
||||
|
||||
## 4. 단계별 기준
|
||||
|
||||
### 4.1 작업 기준 확인
|
||||
|
||||
먼저 아래 문서를 확인한다.
|
||||
|
||||
```text
|
||||
WORKSPACE_ROOT/AGENTS.md
|
||||
SN_APP_ROOT/AGENTS.md
|
||||
BE_SERVICE_ROOT/AGENTS.md
|
||||
```
|
||||
|
||||
확인할 내용:
|
||||
|
||||
- 수정 가능한 경로
|
||||
- `apps/sn` 내부 해결 가능 여부
|
||||
- `business_components` 수정 가능 여부
|
||||
- 공통 패키지 수정 금지 범위
|
||||
- 백엔드 연동 영향 여부
|
||||
|
||||
### 4.2 기능 문서 확인
|
||||
|
||||
확인 대상:
|
||||
|
||||
```text
|
||||
SN_APP_ROOT/docs/{기능명}/00-범위.md
|
||||
SN_APP_ROOT/docs/{기능명}/03-API응답필드매핑표.md
|
||||
SN_APP_ROOT/docs/{기능명}/04-화면흐름.md
|
||||
SN_APP_ROOT/docs/{기능명}/99-미확인사항.md
|
||||
```
|
||||
|
||||
확인할 내용:
|
||||
|
||||
- 화면 목적
|
||||
- 사용자 동작 흐름
|
||||
- 호출 API
|
||||
- 필요한 응답 필드
|
||||
- 미확정 백엔드 계약
|
||||
- 검증해야 할 브라우저 동작
|
||||
|
||||
### 4.3 기존 화면/컴포넌트 탐색
|
||||
|
||||
새 UI를 만들기 전에 기존 구현을 찾는다.
|
||||
|
||||
우선순위:
|
||||
|
||||
```text
|
||||
1. SN_APP_ROOT/app/**
|
||||
2. SN_APP_ROOT/src/**
|
||||
3. BUSINESS_COMPONENTS_ROOT/src/**
|
||||
```
|
||||
|
||||
확인할 내용:
|
||||
|
||||
- 유사 화면
|
||||
- 기존 테이블/모달/검색/상세 패널
|
||||
- 지도 레이어/트리/팝업 패턴
|
||||
- 기존 상태관리 store
|
||||
- 기존 API 유틸
|
||||
|
||||
### 4.4 API 사용부와 응답 필드 확인
|
||||
|
||||
확인할 내용:
|
||||
|
||||
- API 호출 함수
|
||||
- 요청 파라미터
|
||||
- 응답 wrapper 구조
|
||||
- 화면 표시 필드
|
||||
- 코드값 매핑
|
||||
- 오류 처리
|
||||
|
||||
백엔드와 계약이 불명확하면 `99-미확인사항.md`에 기록하고 BE 작업카드와 연결한다.
|
||||
|
||||
### 4.5 상태관리와 화면 흐름 확인
|
||||
|
||||
확인할 내용:
|
||||
|
||||
- local state로 충분한가
|
||||
- 기존 Zustand store를 써야 하는가
|
||||
- URL/query state가 필요한가
|
||||
- 모달/패널/지도 선택 상태가 어떻게 연결되는가
|
||||
- API 재조회 시점은 언제인가
|
||||
|
||||
### 4.6 구현 방향 결정
|
||||
|
||||
가능한 방향:
|
||||
|
||||
```text
|
||||
1. 기존 화면/컴포넌트 조합만으로 구현
|
||||
2. apps/sn 내부 컴포넌트 추가
|
||||
3. business_components 최소 보강
|
||||
4. 백엔드 API 계약 확인 요청
|
||||
5. 백엔드 변경 필요 사항 정리
|
||||
```
|
||||
|
||||
기본 방침:
|
||||
|
||||
```text
|
||||
기존 컴포넌트로 가능하면 재사용한다.
|
||||
apps/sn 내부 해결을 우선한다.
|
||||
공통 패키지 수정은 마지막에 판단한다.
|
||||
백엔드 응답 구조를 프론트에서 임의로 바꾸지 않는다.
|
||||
```
|
||||
|
||||
### 4.7 최소 범위 구현
|
||||
|
||||
구현 원칙:
|
||||
|
||||
- 기존 디자인과 컴포넌트 패턴을 따른다.
|
||||
- 신규 스타일은 최소화한다.
|
||||
- 화면 전체 구조를 불필요하게 바꾸지 않는다.
|
||||
- 텍스트/버튼/테이블이 모바일과 데스크톱에서 넘치지 않게 한다.
|
||||
- 지도 화면은 전체 페이지 스크롤보다 내부 패널 스크롤을 우선한다.
|
||||
- API 변환 로직은 한 곳에 모은다.
|
||||
|
||||
### 4.8 빌드/브라우저/네트워크 검증
|
||||
|
||||
수정 범위에 따라 검증한다.
|
||||
|
||||
`apps/sn`만 수정한 경우:
|
||||
|
||||
```powershell
|
||||
pnpm --filter sn run build
|
||||
pnpm turbo run build --filter=sn
|
||||
```
|
||||
|
||||
`business_components` 수정 시:
|
||||
|
||||
```powershell
|
||||
pnpm --filter @common/business_components run build
|
||||
pnpm --filter sn run build
|
||||
```
|
||||
|
||||
브라우저 검증:
|
||||
|
||||
- 화면 진입
|
||||
- 검색/조회
|
||||
- 모달/패널 열림
|
||||
- 테이블 표시
|
||||
- 지도 레이어 표시
|
||||
- 네트워크 요청/응답
|
||||
- 오류 처리
|
||||
- 스크롤/레이아웃 깨짐 여부
|
||||
|
||||
### 4.9 결과 기록
|
||||
|
||||
작업 후 아래 항목을 기록한다.
|
||||
|
||||
- 작업 목적
|
||||
- 수정 대상 파일
|
||||
- 변경 내용 요약
|
||||
- 영향 범위
|
||||
- 검증 방법
|
||||
- 롤백 방법
|
||||
- 남은 리스크
|
||||
|
||||
기능 문서가 있다면 `06-검증결과.md` 또는 `99-미확인사항.md`를 갱신한다.
|
||||
|
||||
## 5. BE/FE 연동 작업 흐름
|
||||
|
||||
프론트가 백엔드 계약에 의존하는 경우 아래 순서로 진행한다.
|
||||
|
||||
```text
|
||||
1. FE 화면흐름 확인
|
||||
2. FE API 응답 필드 매핑표 확인
|
||||
3. FE 미확인사항 확인
|
||||
4. BE 작업카드/API/DB 문서 확인
|
||||
5. 실제 API 응답 확인
|
||||
6. 프론트 구현
|
||||
7. 브라우저와 네트워크 응답 검증
|
||||
8. 미확인사항 해결 여부 갱신
|
||||
```
|
||||
|
||||
## 6. 적용 예시: 노후관로관리
|
||||
|
||||
노후관로관리 작업에서는 이 흐름을 아래처럼 적용했다.
|
||||
|
||||
```text
|
||||
시나리오 문서 확인
|
||||
→ API 응답 필드 매핑표 확인
|
||||
→ 미확인사항 확인
|
||||
→ 기존 GIS/레이어 트리 패턴 확인
|
||||
→ 기존 /api/v1/fclts 재사용 결정
|
||||
→ 노후관로 가상 노드 fallback 구현
|
||||
→ DB 정식 노드 반영 후 중복 방지
|
||||
→ 목록/지도 강조선/상세 패널 검증
|
||||
```
|
||||
|
||||
프론트 최종 방향:
|
||||
|
||||
```text
|
||||
노후관로 목록: 기존 v1/fclts 재사용
|
||||
노후관로 트리 노드: DB 노드 우선, 없으면 프론트 fallback
|
||||
노후관로 강조선: tb_ms_swage_ppl WFS 조건 레이어 추가
|
||||
상세 패널: 기존 하수관로 상세 패널 재사용
|
||||
```
|
||||
|
||||
## 7. 고정할 큰 틀
|
||||
|
||||
기능이 달라져도 아래 흐름은 유지한다.
|
||||
|
||||
```text
|
||||
문서 확인
|
||||
→ 기존 화면/컴포넌트 확인
|
||||
→ API 계약 확인
|
||||
→ 재사용 가능 여부 판단
|
||||
→ 최소 구현
|
||||
→ 브라우저 검증
|
||||
→ 결과 기록
|
||||
```
|
||||
|
||||
세부 구현은 상황에 맞게 조정하되, 기존 화면 패턴 재사용과 실제 브라우저 검증은 항상 유지한다.
|
||||
@@ -0,0 +1,40 @@
|
||||
# `sn` 앱 문서
|
||||
|
||||
## 목적
|
||||
|
||||
이 디렉터리는 하수관로 운영관리 시스템 `sn` 앱의 화면/기능별 산출물을 관리한다.
|
||||
프론트엔드 공통 기준은 `FE_REPO_ROOT/docs/**`에 두고, `sn` 특정 화면과 기능 상세는 이 디렉터리에 둔다.
|
||||
|
||||
## 작성 범위
|
||||
|
||||
- `sn` 화면별 요구사항 해석
|
||||
- 기존 화면 기반 컴포넌트 분해
|
||||
- 컴포넌트별 작업 목록
|
||||
- API 응답 필드 매핑
|
||||
- 화면 흐름
|
||||
- 검증 계획과 결과
|
||||
- 기능별 미확인사항
|
||||
|
||||
## 작성 금지 범위
|
||||
|
||||
- 다른 앱 전용 기능 상세
|
||||
- 백엔드 내부 구현 상세
|
||||
- 공통 프론트엔드 규칙 전체
|
||||
|
||||
## 기능별 문서 구조
|
||||
|
||||
기능별 문서는 아래 형식을 권장한다.
|
||||
|
||||
```text
|
||||
apps/sn/docs/{기능명}/
|
||||
README.md
|
||||
00-범위.md
|
||||
01-기존화면기반-컴포넌트분해.md
|
||||
02-컴포넌트별-작업목록.md
|
||||
03-API응답필드매핑표.md
|
||||
04-화면흐름.md
|
||||
05-검증계획.md
|
||||
06-검증결과.md
|
||||
99-미확인사항.md
|
||||
```
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
# 노후관로관리 범위
|
||||
|
||||
## 목적
|
||||
|
||||
노후관로관리 및 노후관로분석 화면의 프론트엔드 구현 범위를 정의한다.
|
||||
|
||||
## 포함 범위
|
||||
|
||||
- 노후관로 레이어 체크/표출
|
||||
- 좌측 하단 경과년도 설정 영역
|
||||
- 노후관로 목록 모달
|
||||
- 목록 행 더블클릭과 지도/상세 연동
|
||||
- 관로 상세정보 표시
|
||||
- 하수처리구역 기준 매설년도 분석정보 표시
|
||||
- 보수이력 진입 버튼 또는 링크
|
||||
- 엑셀 다운로드 버튼 연결
|
||||
|
||||
## 제외 범위
|
||||
|
||||
- 백엔드 API 신규 구현
|
||||
- DB 스키마 변경
|
||||
- 백엔드 공통 응답 구조 변경
|
||||
- `sn` 외 다른 앱 화면 변경
|
||||
- `business_components` 외 공통 패키지 직접 수정
|
||||
|
||||
## 기준 문서
|
||||
|
||||
- 기능 요구사항 명세서 v2.0
|
||||
- 시나리오 v2.0
|
||||
- `01-기존화면기반-컴포넌트분해.md`
|
||||
- `02-컴포넌트별-작업목록.md`
|
||||
|
||||
@@ -0,0 +1,158 @@
|
||||
# 노후관로관리 기존 화면 기반 컴포넌트 분해
|
||||
|
||||
## 목적
|
||||
|
||||
노후관로관리 2차 고도화 화면은 신규 디자인을 만들지 않고, 1차 개발 화면의 레이아웃과 컴포넌트 톤을 유지한다.
|
||||
이 문서는 실제 `sn` 화면 코드 기준으로 화면을 어떤 단위로 나누어 개발해야 하는지 정리한다.
|
||||
|
||||
## 기준 화면 구조
|
||||
|
||||
실제 화면은 아래 계층으로 구성된다.
|
||||
|
||||
```text
|
||||
NoFooterLayout
|
||||
Header
|
||||
LNB
|
||||
MapLayout children
|
||||
Gis
|
||||
GisTree
|
||||
GisMapToggle
|
||||
GisToolBar
|
||||
GisZoomLevel
|
||||
ProcSearchBar
|
||||
FeatureClickEventPopup
|
||||
```
|
||||
|
||||
## 실제 참조 파일
|
||||
|
||||
| 구분 | 기준 파일 | 개발 기준 |
|
||||
|---|---|---|
|
||||
| 전체 레이아웃 | `packages/common/components/src/ui/layout/nofooter.tsx` | `Header` + `LNB` + 본문 3단 구조 유지 |
|
||||
| 상단 헤더 | `packages/common/components/src/ui/header/index.tsx` | 흰색 헤더, 로고, 상단 시스템 메뉴, 검색, 사용자 영역 유지 |
|
||||
| 좌측 메뉴 | `packages/common/components/src/ui/lnb/index.tsx` | `하수관망도`, `I/I 분석`, `운영정보` 계층 유지 |
|
||||
| 지도 컴포넌트 | `packages/common/business_components/src/ui/map/Gis.js` | OpenLayers 기반 `Gis` 사용 |
|
||||
| 시설물 트리 | `packages/common/business_components/src/ui/map/GisTree.js` | 폭 250px, 제목 `시설물`, 체크박스 트리 유지 |
|
||||
| 지도 도구 | `packages/common/business_components/src/ui/map/GisToolBar.js` | 기존 우측 도구 버튼 위치/크기 유지 |
|
||||
| 검색 바 | `packages/common/business_components/src/ui/map/searchBar` | 기존 지도 상단 검색 조건 영역 유지 |
|
||||
| 상세 팝업 | `apps/sn/app/html/(map-layout)/map/components/popupComponent/featureClickEventPopup.tsx` | 우측 350px 팝업, 파란 헤더, `VerticalTable` 유지 |
|
||||
| 세로 테이블 | `apps/sn/app/components/ui/verticalTable.tsx` | `bg-blue-100` 라벨셀, 2열 세로 테이블 유지 |
|
||||
| 목록 그리드 | `packages/common/business_components/src/ui/table/index.tsx` | `UiTable` 기반 목록/페이징 유지 |
|
||||
|
||||
## 레이아웃 기준값
|
||||
|
||||
| 영역 | 기준 |
|
||||
|---|---|
|
||||
| Header | 높이 `6rem`, 흰색 배경, 하단 border |
|
||||
| LNB | 폭 `22rem`, 흰색 배경, `하수관망도` active |
|
||||
| GisTree | 폭 `250px`, 지도 내부 좌측 absolute. 상단 레이어 트리와 하단 설정 영역을 같은 패널 안에서 자연스럽게 분리 |
|
||||
| Map body | `calc(100vh - 50px)` 계열, `Gis` 영역 full |
|
||||
| Detail popup | 우측 absolute, 폭 `350px`, 높이 `calc(100vh - 5rem)` |
|
||||
| Detail header | `bg-primary`, 흰색 글자, 닫기 `✕` |
|
||||
| Detail table | `VerticalTable`, 왼쪽 라벨셀 `bg-blue-100`, 오른쪽 값셀 흰색 |
|
||||
|
||||
## 색상 및 폰트 기준
|
||||
|
||||
노후관로관리 추가 UI는 기존 우측 상세정보의 `FeatureClickEventPopup` + `VerticalTable` 색상과 폰트 톤을 따른다.
|
||||
좌측 하단 설정 영역도 별도 신규 색을 쓰지 않고 같은 토큰을 사용한다.
|
||||
|
||||
| 항목 | 기준값 | 사용 위치 |
|
||||
|---|---|---|
|
||||
| 기본 폰트 | `Noto Sans KR`, `Malgun Gothic` fallback | 전체 화면 |
|
||||
| 기본 글자색 | `#111`, `#333`, `#555` | 본문, 트리, 입력 라벨 |
|
||||
| Primary blue | `#258eea` | 우측 상세 헤더, 조회 버튼 등 기존 primary 영역 |
|
||||
| Dark navy | `#152346` | 기존 강조 버튼 또는 별도 강조 영역이 필요한 경우만 사용 |
|
||||
| Download green | `#1fd078` | 목록/엑셀 다운로드 버튼 |
|
||||
| Label cell blue | `#dbeafe` | `VerticalTable` 왼쪽 라벨셀 |
|
||||
| Table border | `#dbe2e6`, `#e5e7eb` | 세로 테이블/목록 테이블 구분선 |
|
||||
| Panel border | `#d1d5db`, `#d7dde3` | 좌측 패널, 설정 영역 외곽 |
|
||||
| Panel background | `#fff` | LNB, GisTree, 설정 영역, 상세 팝업 |
|
||||
| Apply green | `#31a83b` | 좌측 하단 설정 영역의 적용 아이콘 |
|
||||
|
||||
### 좌측 하단 설정 영역 색상 기준
|
||||
|
||||
- 외곽은 `Panel border`를 사용한다.
|
||||
- 헤더는 진한 남색 바를 쓰지 않고, 위 `시설물` 패널처럼 흰 배경의 제목 행을 사용한다.
|
||||
- 입력 라벨, 값, 적용 아이콘 폰트는 기존 `Noto Sans KR` 계열과 동일하게 둔다.
|
||||
- 적용은 텍스트 버튼이 아니라 녹색 원형 체크 아이콘 형태로 표현한다.
|
||||
- 트리 영역과 설정 영역 사이에는 굵은 검정선 대신 `#d1d5db` 계열의 얇은 경계와 여백을 사용한다.
|
||||
- 목적은 강한 분리선이 아니라, 같은 좌측 패널 안에서 서로 다른 기능 영역임을 자연스럽게 구분하는 것이다.
|
||||
|
||||
### 목록 모달 버튼 색상 기준
|
||||
|
||||
- `조회`는 공통 `Button`의 `primary` 톤을 따른다.
|
||||
- `다운로드`는 공통 `Button`의 `green` 톤을 따른다.
|
||||
- 모달 안에서 임의의 남색 버튼이나 흰색 outline 다운로드 버튼을 새로 만들지 않는다.
|
||||
- 정적 HTML 샘플에서도 `조회=#258eea`, `다운로드=#1fd078` 조합으로 표현한다.
|
||||
|
||||
## 화면설계서 번호 기준 영역
|
||||
|
||||
노후관로관리 화면은 화면설계서의 번호 기준대로 영역을 분리해서 봐야 한다.
|
||||
특히 `경과년도(년)` 입력 영역은 지도 위에 뜨는 독립 팝업이 아니라, 좌측 `시설물` 트리 하단에 붙는 별도 설정 영역으로 본다.
|
||||
|
||||
| 번호 | 화면 영역 | 위치 | 기존 컴포넌트 기준 | 동작 |
|
||||
|---|---|---|---|---|
|
||||
| ① | 노후관로 레이어 체크박스 | 좌측 `시설물` 트리 내부, `노후관로` 행 | `GisTree` 노드 | 체크 ON/OFF로 노후관로 레이어 표출 제어 |
|
||||
| ② | 경과년도 설정 영역 | 좌측 `시설물` 트리 하단, 트리 목록 아래 별도 접힘/펼침 박스로 자연스럽게 분리 | `GisTree` 하단 확장 영역 또는 지도 오버레이가 아닌 좌측 설정 블록 | `경과년도(년)` 단일 입력 후 초록 체크 적용 |
|
||||
| ③ | 지도 관로 선택 영역 | 지도 본문 | `Gis`, `GisSelect`, `onFeatureSelect` | 관로 클릭 시 우측 상세 팝업 표출 |
|
||||
| ④ | 노후관로 목록 아이콘 | 좌측 `시설물` 트리 내부, `노후관로` 행 우측 | `GisTree`의 `onLayerIconClick`/`onOpenPopup` | 노후관로 현황 목록 모달 호출 |
|
||||
|
||||
### 좌측 영역 분리 원칙
|
||||
|
||||
```text
|
||||
GisTree (좌측 250px)
|
||||
시설물 제목
|
||||
레이어 트리 영역
|
||||
시설
|
||||
하수관로
|
||||
...
|
||||
노후관로 체크박스 ①
|
||||
노후관로 목록 아이콘 ④
|
||||
(여백)
|
||||
레이어별 설정 영역 ②
|
||||
제목 행: 지반침하정보 또는 대상 레이어명
|
||||
입력 행: 경과년도(년) [30] [초록 체크]
|
||||
```
|
||||
|
||||
이 구조를 따르면 화면설계서의 ①, ②, ④가 모두 좌측 `GisTree` 계열 안에서 구분된다.
|
||||
따라서 노후관로 기준 패널을 지도 중앙이나 지도 좌하단의 독립 카드처럼 띄우지 않는다.
|
||||
또한 트리와 설정 영역 사이를 검정 굵은 선으로 끊지 않고, 실제 화면처럼 여백과 연한 경계선으로 자연스럽게 구분한다.
|
||||
|
||||
### 접힘/펼침 기준
|
||||
|
||||
- 상단 `시설물` 영역과 하단 설정 영역은 각각 접힘/펼침이 가능해야 한다.
|
||||
- 접힘 상태에서는 제목 행만 남기고 내부 행은 숨긴다.
|
||||
- 하단 설정 영역은 사용자가 현재 조정할 수 있는 입력만 보여준다.
|
||||
- 화면설계서 예시처럼 `지반침하정보` 설정이면 `경과년도(년) [30] [초록 체크]`만 표시한다.
|
||||
- 노후관로 기준을 같은 패턴으로 적용할 때도 입력 필드를 과도하게 늘리지 않고, 대상 레이어명과 경과년도 입력만 노출한다.
|
||||
|
||||
## 노후관로관리 추가 시 분해
|
||||
|
||||
| 요구사항 | 기존 컴포넌트 기반 구현 위치 |
|
||||
|---|---|
|
||||
| 노후관로 레이어 ON/OFF | `GisTree` 레이어 노드 추가 또는 기존 하수관로 레이어 스타일 보강 |
|
||||
| 경과년도 조건 | `GisTree` 하단의 접힘/펼침 가능한 레이어별 설정 영역으로 구성. `경과년도(년)` 단일 입력만 노출 |
|
||||
| 목록 아이콘 | `GisTree`의 `노후관로` 행 우측 아이콘으로 배치하고 `onLayerIconClick`/`onOpenPopup` 흐름 활용 |
|
||||
| 목록 팝업 | `UiTable` 기반 모달로 구성 |
|
||||
| 지도-그리드 연동 | 기존 `onFeatureSelect`, `GisApp.Module.layer.showSearchResultsFromGeoJSON` 흐름 활용 |
|
||||
| 상세정보 | `FeatureClickEventPopup` 또는 동일한 `VerticalTable` 구조로 확장 |
|
||||
| 노후관로분석 | 하수처리구역 피처 클릭 시 기존 상세 팝업에 분석정보 섹션 추가 |
|
||||
|
||||
## 금지 방향
|
||||
|
||||
- 별도 전체 화면 레이아웃을 새로 만들지 않는다.
|
||||
- 어두운 헤더/새 사이드바/카드형 상세 패널 등 기존과 다른 디자인을 넣지 않는다.
|
||||
- `경과년도(년)` 설정을 지도 위 플로팅 카드로 분리하지 않는다.
|
||||
- 트리와 설정 영역 사이에 굵은 검정 구분선을 사용하지 않는다.
|
||||
- 좌측 하단 설정 영역에 남색 헤더 바와 남색 텍스트 적용 버튼을 사용하지 않는다.
|
||||
- 하단 설정 영역에 시도/시군구/목록 버튼을 넣지 않는다.
|
||||
- `apps/sn/app/html/**` 정적 샘플을 실제 서비스 코드로 그대로 옮기지 않는다.
|
||||
- 기존 `FeatureClickEventPopup`, `VerticalTable`, `UiTable`, `GisTree`로 가능한 UI를 별도 컴포넌트로 새로 만들지 않는다.
|
||||
|
||||
## 개발 전 확인 순서
|
||||
|
||||
1. 실제 메뉴/라우트가 `NoFooterLayout` 하위에서 열리는지 확인한다.
|
||||
2. 노후관로 레이어가 기존 `SN_NETWORK` 레이어 설정에 포함되는지 확인한다.
|
||||
3. 하수관로 속성명(`instl_ymd`, `fclt_mng_no`, `mqlt_cd`, `usg_cd`)을 실제 API 응답과 맞춘다.
|
||||
4. 상세 패널은 기존 `FeatureClickEventPopup` 확장 가능성을 먼저 검토한다.
|
||||
5. 목록 팝업은 `UiTable`과 기존 검색 모달 패턴으로 구성한다.
|
||||
6. `business_components` 수정이 필요한 경우 타 앱 영향 범위를 먼저 정리한다.
|
||||
@@ -0,0 +1,240 @@
|
||||
# 노후관로관리 컴포넌트별 작업 목록
|
||||
|
||||
## 목적
|
||||
|
||||
이 문서는 노후관로관리 화면을 실제 React 코드로 옮기기 전에, 어떤 기존 컴포넌트를 재사용하고 어떤 컴포넌트만 최소 확장할지 정리한 작업 목록이다.
|
||||
기준은 `01-기존화면기반-컴포넌트분해.md`와 `old-pipe-component-sample/index.html`의 최종 확인 화면이다.
|
||||
|
||||
## 구현 원칙
|
||||
|
||||
- 새 디자인 시스템을 만들지 않는다.
|
||||
- 실제 화면은 `NoFooterLayout > Header/LNB > Gis > GisTree/FeatureClickEventPopup/UiTable` 흐름을 따른다.
|
||||
- 좌측 하단 설정 영역은 지도 위 플로팅 카드가 아니라, `GisTree` 내부 또는 `GisTree`와 붙은 좌측 패널 영역으로 구현한다.
|
||||
- 좌측 하단 설정 영역에는 `경과년도(년)` 단일 입력과 초록 적용 아이콘만 둔다.
|
||||
- 노후관로 현황 목록의 `조회`는 `Button color="primary"`, `다운로드`는 `Button color="green"` 톤을 따른다.
|
||||
- 우측 상세정보는 기존 `FeatureClickEventPopup` + `VerticalTable` 톤을 우선한다.
|
||||
|
||||
## 작업 단위 요약
|
||||
|
||||
| 순서 | 작업 단위 | 주요 파일 | 구분 | 목적 |
|
||||
|---|---|---|---|---|
|
||||
| 1 | 좌측 하단 설정 영역 확장 지점 확보 | `BUSINESS_COMPONENTS_ROOT/src/ui/map/Gis.js`, `GisTree.js` | 최소 공통 확장 후보 | `GisTree` 아래에 설정 패널을 넣을 수 있는 optional slot 확보 |
|
||||
| 2 | 노후관로 설정 패널 정리 | `SN_APP_ROOT/app/(map-layout)/map/components/agedPipe/AgedPipeLayerSettingPanel.tsx` | 구조 변경 | 지도 오버레이/시도/시군구 제거, 경과년도 단일 입력 + 초록 체크로 변경 |
|
||||
| 3 | 노후관로 페이지 상태/이벤트 정리 | `SN_APP_ROOT/app/(map-layout)/map/page.tsx` | 구조 변경 | `Gis`, `GisTree`, 윈도우 팝업, 상세 팝업 연동의 중심 상태 관리 |
|
||||
| 4 | 목록 윈도우 팝업 정리 | `AgedPipePopupPage.tsx`, `/map/aged-pipe-popup` | 스타일/동작 보완 | 기존 `UiTable`, `Button primary/green`, 목록 아이콘 호출 흐름 정리 |
|
||||
| 5 | 상세 패널 기존화 | `AgedPipeDetailPanel.tsx`, `FeatureClickEventPopup.tsx`, `VerticalTable` | 대체/확장 검토 | 별도 slate 카드형 상세를 제거하고 기존 세로 테이블 톤으로 통합 |
|
||||
| 6 | 유틸/필터 정리 | `agedPipeUtils.ts` | 유지/보완 | 경과년도 산정, CQL 필터, 표시값 매핑 유지 |
|
||||
| 7 | 처리구역 분석 확장 | `FeatureClickEventPopup.tsx` 또는 신규 `AgedPipeAreaAnalysisSection.tsx` | 추가 | 하수처리구역 클릭 시 평균/최장/최신 매설년도 섹션 추가 |
|
||||
| 8 | 검증 | 브라우저, build, 네트워크 | 검증 | 화면/지도/목록/상세/다운로드 회귀 확인 |
|
||||
|
||||
## 1. `Gis` / `GisTree` 확장 후보
|
||||
|
||||
### 현재 상태
|
||||
|
||||
- `Gis.js`는 내부에서 `GisTree`를 직접 렌더링한다.
|
||||
- `GisTree.js`는 좌측 250px 패널 전체를 `grow overflow-y-auto` 트리 영역으로 사용한다.
|
||||
- 현재 구조만으로는 트리 하단에 `경과년도(년) [30] [초록 체크]` 설정 박스를 자연스럽게 넣기 어렵다.
|
||||
|
||||
### 적용 결정
|
||||
|
||||
- `sn` 전용 임시 overlay가 아니라 `Gis`/`GisTree`의 optional slot 방식으로 진행한다.
|
||||
- prop 이름은 `layerSettingView`를 사용한다.
|
||||
- prop을 넘기지 않는 기존 사용처는 기존과 동일하게 동작한다.
|
||||
|
||||
### 작업 내용
|
||||
|
||||
- `Gis.js`에 optional prop을 추가한다.
|
||||
- 이름: `layerSettingView`
|
||||
- 기본값은 `undefined`로 두어 기존 앱 영향이 없게 한다.
|
||||
- `GisTree.js`에 optional footer 영역을 렌더링한다.
|
||||
- 상단 `시설물` 트리 영역과 하단 설정 영역을 같은 250px 패널 안에서 분리한다.
|
||||
- 상단/하단 영역 모두 접힘/펼침 가능해야 한다.
|
||||
- 기존 사용처는 prop을 넘기지 않으면 기존과 동일하게 동작해야 한다.
|
||||
|
||||
### 주의사항
|
||||
|
||||
- `business_components` 수정이므로 타 앱 영향 가능성을 반드시 점검한다.
|
||||
- className 변경은 최소화하고, optional footer가 없을 때 기존 DOM 구조/스타일을 최대한 유지한다.
|
||||
- 이 공통 확장이 부담되면 `sn` 전용으로 `Gis` 주변에 좌측 하단 패널을 겹쳐 배치하는 대안을 검토할 수 있으나, 화면설계서처럼 같은 좌측 패널 안에서 보이려면 optional slot 방식이 더 자연스럽다.
|
||||
|
||||
## 2. `AgedPipeFilterPanel.tsx`
|
||||
|
||||
### 현재 상태
|
||||
|
||||
- 지도 위 플로팅 카드 형태다.
|
||||
- `경과년수`, `시도`, `시군구`, `GIS 반영` 버튼을 갖고 있다.
|
||||
- 최종 확인 기준과 다르다.
|
||||
|
||||
### 변경 방향
|
||||
|
||||
- 이름은 유지하거나 `AgedPipeLayerSettingPanel.tsx`로 변경한다.
|
||||
- 화면 구성은 아래처럼 단순화한다.
|
||||
|
||||
```text
|
||||
지반침하정보 또는 노후관로
|
||||
경과년도(년) [30] [초록 체크]
|
||||
```
|
||||
|
||||
### 작업 내용
|
||||
|
||||
- `ctpvCd`, `sggCd` 선택 UI 제거.
|
||||
- `GIS 반영` 텍스트 버튼 제거.
|
||||
- 초록 원형 체크 아이콘 버튼으로 적용 액션 처리.
|
||||
- `title` prop을 받아 `지반침하정보`, `노후관로` 등 대상 레이어명을 표시할 수 있게 한다.
|
||||
- `elapsedYears` 값만 직접 입력받는다.
|
||||
- Enter 입력과 체크 버튼 클릭 모두 `onApply`를 호출한다.
|
||||
|
||||
### props 후보
|
||||
|
||||
```ts
|
||||
type AgedPipeLayerSettingPanelProps = {
|
||||
title: string;
|
||||
elapsedYears: number;
|
||||
onElapsedYearsChange: (value: number) => void;
|
||||
onApply: () => void;
|
||||
defaultCollapsed?: boolean;
|
||||
};
|
||||
```
|
||||
|
||||
## 3. `page.tsx`
|
||||
|
||||
### 현재 상태
|
||||
|
||||
- `AgedPipeFilterPanel`을 `waterDepth` prop으로 넘겨 지도 오버레이처럼 표시한다.
|
||||
- `AgedPipeDetailPanel`을 `detailView`로 사용한다.
|
||||
- `getData`를 사용하지만 import가 보이지 않으므로 실제 빌드 전 확인이 필요하다.
|
||||
- 샘플용 `DESIGN_PREVIEW_FEATURE`, 기본 목록 오픈 상태 등이 남아 있다.
|
||||
|
||||
### 변경 방향
|
||||
|
||||
- `Gis`에 `treeFooterView` 또는 `layerSettingView`를 넘겨 좌측 하단 설정 영역으로 렌더링한다.
|
||||
- `waterDepth` prop은 침수심 애니메이션 목적이므로 노후관로 설정 패널 용도로 쓰지 않는다.
|
||||
- 상세는 `AgedPipeDetailPanel` 단독 사용보다 기존 `FeatureClickEventPopup` 확장 또는 동일 `VerticalTable` 구조를 우선한다.
|
||||
|
||||
### 작업 내용
|
||||
|
||||
- `draftFilters`와 `appliedFilters`는 유지하되, 좌측 하단 패널에서는 `elapsedYears`만 수정한다.
|
||||
- 시도/시군구는 목록 모달 조회조건에만 남긴다.
|
||||
- 노후관로 목록 아이콘 클릭은 `GisTree`의 `onLayerIconClick`/`onOpenPopup` 흐름으로 연결한다.
|
||||
- `handleTreePopup`은 `layerNm` 문자열 대신 실제 노드 정보 또는 `lyrTyNm` 기준으로 판정하는 방향을 검토한다.
|
||||
- `DESIGN_PREVIEW_FEATURE`, 기본 `isListOpen=true`, 기본 `isDetailOpen=true`는 개발 완료 전 제거한다.
|
||||
- `getData` import 누락 여부를 확인하고 실제 API 유틸 경로를 맞춘다.
|
||||
|
||||
## 4. 노후관로 현황 윈도우 팝업
|
||||
|
||||
### 현재 상태
|
||||
|
||||
- 노후관로 현황은 `/map/aged-pipe-popup` Next 라우트를 별도 윈도우 팝업으로 연다.
|
||||
- 기존 `about:blank`에 React/CSS를 주입하던 방식은 dev CSS/chunk 404 위험 때문에 사용하지 않는다.
|
||||
- 팝업 페이지는 자체적으로 목록 API를 조회하고 `UiTable`로 렌더링한다.
|
||||
- 행 선택은 `window.opener.postMessage`로 부모 `/map`에 전달하여 지도 이동/상세 패널 표시를 수행한다.
|
||||
|
||||
### 변경 방향
|
||||
|
||||
- 지도 내부 Dialog/modal이 아니라 브라우저 밖 윈도우 팝업을 기본 동작으로 고정한다.
|
||||
- 테이블은 현재처럼 `UiTable`을 계속 사용한다.
|
||||
- 버튼 색상은 아래 기준으로 고정한다.
|
||||
- 조회: `Button color="primary"`
|
||||
- 다운로드: `Button color="green"`
|
||||
- 팝업 내부 앱 버튼은 `최소화`만 유지한다. 닫기는 브라우저 창 X를 사용한다.
|
||||
|
||||
### 작업 내용
|
||||
|
||||
- 헤더 색상을 기존 primary blue 톤과 맞춘다.
|
||||
- `/map/aged-pipe-popup`는 공통 `NoFooterLayout` 없이 목록 화면만 렌더링한다.
|
||||
- 조회조건은 명세서대로 `경과년도`, `시도`, `시군구` 유지.
|
||||
- 그리드 기본 정렬은 `경과년도 DESC`.
|
||||
- 행 클릭은 부모 `/map`에 row를 전달하고 기존 `showSearchResultsFromGeoJSON` 위치 이동 흐름을 사용한다.
|
||||
- 좌측 `노후관로 설정` 적용 시 열린 팝업에는 `SN_AGED_PIPE_FILTER_SYNC` 메시지를 보내 필터와 목록을 동기화한다.
|
||||
- 팝업 `최소화` 클릭 시 부모 `/map`에 최소화 메시지를 보내고, 부모는 지도 위 최소화 카드를 표시한다.
|
||||
- 최소화 카드의 `열기`는 다시 `/map/aged-pipe-popup` 윈도우 팝업을 실행한다.
|
||||
- 다운로드는 `downloadExcelWithKoreanHeaders` 호출 유지하되, 5만 건 이상 비동기 처리 여부는 백엔드 API 매핑 단계에서 확정한다.
|
||||
|
||||
## 5. 상세 패널
|
||||
|
||||
### 현재 상태
|
||||
|
||||
- `AgedPipeDetailPanel.tsx`는 별도 slate 카드형 UI다.
|
||||
- 실제 화면은 `FeatureClickEventPopup`의 파란 헤더 + `VerticalTable` 구조다.
|
||||
|
||||
### 변경 방향
|
||||
|
||||
- 우선순위 1: `FeatureClickEventPopup`에 노후관로 경과년도 필드만 추가해서 재사용한다.
|
||||
- 우선순위 2: `FeatureClickEventPopup` 재사용이 어렵다면 `AgedPipeDetailPanel`을 `VerticalTable`과 동일한 구조로 다시 만든다.
|
||||
|
||||
### 작업 내용
|
||||
|
||||
- `AGED_PIPE_DETAIL_FIELDS`는 기존 `MsSwagePplCol` 기반을 유지한다.
|
||||
- `경과년도` 계산 필드를 상세 테이블 마지막에 추가한다.
|
||||
- 상세 헤더는 `하수관로 정보 / 관리번호 : {시설관리번호}` 흐름을 따른다.
|
||||
- `침입수분석`, `RDII분석` 버튼은 기존 `FeatureClickEventPopup`의 하수관로 조건부 버튼을 그대로 사용한다.
|
||||
|
||||
## 6. `agedPipeUtils.ts`
|
||||
|
||||
### 유지할 항목
|
||||
|
||||
- `getElapsedYears`
|
||||
- `getCutoffYmd`
|
||||
- `buildAgedPipeCqlFilters`
|
||||
- `matchesAgedPipeFilters`
|
||||
- `toDisplayPipeRow`
|
||||
- 코드 매핑: `MS_SWAGE_PPL_USE_CODES`, `MS_SWAGE_PPL_CODES`
|
||||
|
||||
### 보완할 항목
|
||||
|
||||
- `AgedPipeFilters`는 전체 상태로는 `elapsedYears`, `ctpvCd`, `sggCd`를 유지하되 좌측 하단 설정 패널에서는 `elapsedYears`만 다룬다.
|
||||
- 설치일자 NULL이면 `확인불가` 그룹으로 분류할 수 있는 유틸을 추가한다.
|
||||
- 미래 설치일자 방어 로직을 추가한다.
|
||||
- 엑셀 다운로드용 전체 필드 매핑은 API 매핑 단계에서 확정한다.
|
||||
|
||||
## 7. 노후관로분석 화면
|
||||
|
||||
### 구현 위치 후보
|
||||
|
||||
- 기존 하수처리구역 클릭 상세: `FeatureClickEventPopup`
|
||||
- 처리구역 전용 부가 섹션: 신규 `AgedPipeAreaAnalysisSection.tsx`
|
||||
|
||||
### 작업 내용
|
||||
|
||||
- 하수처리구역 피처 클릭 시 기존 기본정보는 유지한다.
|
||||
- 기본정보 아래에 `하수관로 분석정보` 섹션을 추가한다.
|
||||
- 평균/최장/최신 매설년도는 `VerticalTable` 또는 기존 테이블 톤으로 표시한다.
|
||||
- `보수이력` 링크/버튼은 기존 `Button` 톤을 사용한다.
|
||||
- 처리구역 내 관로 0건이면 명세서 문구를 표시한다.
|
||||
|
||||
## 8. 검증 목록
|
||||
|
||||
| 구분 | 확인 내용 |
|
||||
|---|---|
|
||||
| 화면 | Header/LNB/GisTree/상세 팝업이 기존 화면과 같은 위치와 톤인지 확인 |
|
||||
| 좌측 설정 | `시설물` 영역과 하단 설정 영역이 각각 접힘/펼침 되는지 확인 |
|
||||
| 입력 | 하단 설정 영역은 `경과년도(년)` 단일 입력만 노출되는지 확인 |
|
||||
| 레이어 | 노후관로 체크 ON/OFF 시 지도 스타일만 바뀌고 기존 하수관로 레이어가 사라지지 않는지 확인 |
|
||||
| 목록 | 노후관로 목록 아이콘 클릭 시 `/map/aged-pipe-popup` 윈도우 팝업이 열리는지 확인 |
|
||||
| 버튼 | 목록 윈도우 팝업 `조회=primary`, `다운로드=green`인지 확인 |
|
||||
| 상세 | 지도 관로 클릭 및 팝업 목록 행 클릭 시 기존 상세 팝업 톤으로 표시되는지 확인 |
|
||||
| 다운로드 | 조회 결과 엑셀 다운로드가 동작하는지 확인 |
|
||||
| 빌드 | `pnpm --filter @common/business_components run build`, `pnpm --filter sn run build` |
|
||||
|
||||
## 권장 구현 순서
|
||||
|
||||
1. `AgedPipeFilterPanel`을 단일 입력 설정 패널로 먼저 정리한다.
|
||||
2. `Gis`/`GisTree`에 optional footer slot을 추가할지, `sn` 전용 좌측 패널 조합으로 갈지 결정한다.
|
||||
3. `page.tsx`에서 지도 오버레이 방식(`waterDepth`)을 제거하고 좌측 설정 영역으로 연결한다.
|
||||
4. `/map/aged-pipe-popup` 윈도우 팝업을 기존 버튼/테이블 톤에 맞춘다.
|
||||
5. 상세는 `FeatureClickEventPopup` 재사용 가능성을 먼저 구현 검토한다.
|
||||
6. 노후관로분석의 처리구역 분석 섹션을 추가한다.
|
||||
7. 브라우저에서 화면설계서 기준 ①~④ 동작을 확인한다.
|
||||
|
||||
## 2026-04-23 추가 보완 작업
|
||||
|
||||
| 순서 | 보완 항목 | 주요 파일 | 처리 방향 |
|
||||
|---|---|---|---|
|
||||
| 1 | 상세 기본정보 헤더 경과년도 표시 | `FeatureClickEventPopup.tsx`, `agedPipeUtils.ts` | 하수관로 상세의 `기본정보` 옆에 `경과년도 n년` 배지를 표시한다. |
|
||||
| 2 | 경과년도 인라인 입력 안정화 | `page.tsx`, `AgedPipeLayerSettingPanel.tsx`, `GisTree.js` | 입력 중 컴포넌트 재마운트로 포커스가 끊기지 않도록 inline setting 렌더링을 React node 방식으로 안정화한다. |
|
||||
| 3 | 목록을 윈도우 팝업으로 변경 | `AgedPipePopupPage.tsx`, `/map/aged-pipe-popup` | Dialog modal 또는 지도 내부 fixed popup 대신 별도 Next 라우트를 브라우저 윈도우 팝업으로 표시한다. |
|
||||
| 4 | 오수관/노후관로 색상 분리 | `tb_sn_lyr_stng`, `DB/001-노후관로-레이어설정.md` | 오수관은 주황색, 노후관로 강조선은 빨간색으로 구분한다. |
|
||||
| 5 | sentinel 설치일자 제외 | `agedPipeUtils.ts` | `1900-01-01`, `1999-01-01`로 등록된 설치일자는 조회 CQL과 경과년도 계산에서 제외한다. |
|
||||
| 6 | 노후관로 줌 레벨 기준 명시 | `page.tsx`, `agedPipeUtils.ts` | 노후관로 강조 레이어 표출 기준은 `minViewSize = 14`로 관리한다. |
|
||||
| 7 | 윈도우 팝업 상태 연동 | `page.tsx`, `AgedPipePopupPage.tsx` | 좌측 설정 적용, 목록 행 선택, 최소화 상태를 `postMessage`로 부모 지도와 팝업 사이에 동기화한다. |
|
||||
| 8 | 선택 관로 시각 강조 | `BUSINESS_COMPONENTS_ROOT/src/ui/map/lib/gis.select.js` | 선택된 선 피처에 다중 stroke(soft glow, white halo, violet core, highlight)를 적용한다. |
|
||||
@@ -0,0 +1,73 @@
|
||||
# 노후관로관리 API 응답 필드 매핑표
|
||||
|
||||
## 목적
|
||||
|
||||
노후관로관리 화면에서 사용할 API와 응답 필드를 화면 컴포넌트 기준으로 매핑한다.
|
||||
이 문서는 다음 단계에서 상세 작성한다.
|
||||
|
||||
## API 목록
|
||||
|
||||
| 구분 | Method | Endpoint | 사용 컴포넌트 | 상태 |
|
||||
|---|---|---|---|---|
|
||||
| 레이어 설정 | GET | `/sewerage-service/api/v1/map/lyrStngs/SN_NETWORK` | `Gis`, `GisTree` | 기존 |
|
||||
| 관로 목록 | GET | `v1/fclts?lyrTypeNm=tb_ms_swage_ppl&cqlFiter=...` | `AgedPipePopupPage`, `UiTable` | 기존 재사용, 백엔드 검증 필요 |
|
||||
| 관로 상세 | GET | `v1/fcltppl/{fcltMngNo}/{mngInstCd}` | `FeatureClickEventPopup`, `VerticalTable` | 기존 재사용 |
|
||||
| 엑셀 다운로드 | GET + 프론트 생성 | `v1/fclts?lyrTypeNm=tb_ms_swage_ppl&cqlFiter=...` | `AgedPipePopupPage` | 임시 재사용 |
|
||||
| 위치 이동 | WFS/GeoServer | `tb_ms_swage_ppl.{fid}` | `GisApp.Module.layer.showSearchResultsFromGeoJSON` | `fid` 계약 검증 필요 |
|
||||
| 처리구역 분석 | - | 미확정 | 분석정보 섹션 | 확인 필요 |
|
||||
| 보수이력 | - | 미확정 | 보수이력 버튼/팝업 | 확인 필요 |
|
||||
|
||||
## 조회 조건 매핑
|
||||
|
||||
| 조건 | 화면 기본값 | API 전달 방식 | 비고 |
|
||||
|---|---:|---|---|
|
||||
| 경과년도 | 30 | `instl_ymd <= '{오늘 기준 경과년도 차감일자}'` CQL | 사용자 지시 기준. 요구사항 원문/기존 문서의 20년과 차이가 있어 30년으로 보정 |
|
||||
| 시도 | 전체 | `pbadms_emd_cd LIKE '{ctpvCd}%'` | 시군구가 전체일 때만 적용 |
|
||||
| 시군구 | 전체 | `pbadms_emd_cd LIKE '{sggCd}%'` | 시군구 선택 시 시도 조건보다 우선 |
|
||||
|
||||
### 제외 조건
|
||||
|
||||
설치일자가 실제 null 대신 sentinel 값으로 적재된 데이터는 노후관로 목록/강조선 조회에서 제외한다.
|
||||
|
||||
| 제외 대상 | API 전달 방식 | 비고 |
|
||||
|---|---|---|
|
||||
| 설치일자 없음 | `instl_ymd IS NOT NULL` | CQL 기본 조건 |
|
||||
| `1900-01-01` | `instl_ymd NOT LIKE '19000101%'` | 원본 `19000101 ` 형태 대응 |
|
||||
| `1999-01-01` | `instl_ymd NOT LIKE '19990101%'` | null 대체값으로 등록된 데이터 제외 요청 반영 |
|
||||
|
||||
## 필드 매핑
|
||||
|
||||
| 화면 영역 | 표시명 | 응답 필드 | 변환/코드매핑 | 빈 값 처리 | 비고 |
|
||||
|---|---|---|---|---|---|
|
||||
| 목록 | 시설관리번호 | `fclt_mng_no`, `fcltMngNo` | 문자열 | `-` | |
|
||||
| 목록 | 관리기관코드 | `mng_inst_cd`, `mngInstCd` | 문자열 | `-` | 상세 API path 변수 |
|
||||
| 목록 | GeoServer Feature ID | `fid` | 문자열 | 필수 | 목록 행 클릭 위치 이동 기준 |
|
||||
| 목록 | 설치일자 | `instl_ymd`, `instlYmd` | 날짜 표시 | `확인불가` | 경과년도 산정 기준 |
|
||||
| 목록 | 관경(mm) | `pdmt_vl`, `pdmtVl` | 숫자 | `-` | |
|
||||
| 목록 | 연장(m) | `prlg_vl`, `prlgVl` | 숫자 | `-` | |
|
||||
| 목록 | 용도 | `usg_cd`, `usgCd` | `MS_SWAGE_PPL_USE_CODES` | `-` | |
|
||||
| 목록 | 재질 | `mqlt_cd`, `mqltCd` | `MS_SWAGE_PPL_CODES` | `-` | |
|
||||
| 목록/상세 | 경과년도 | 설치일자 기반 계산 | `현재연도 - 설치연도` | `확인불가` | 백엔드 필드 여부 확인 필요 |
|
||||
|
||||
## 현재 확정
|
||||
|
||||
- 노후관로 목록은 기존 `GET v1/fclts?lyrTypeNm=tb_ms_swage_ppl&cqlFiter=...`를 재사용한다.
|
||||
- `cqlFiter` 오탈자 파라미터를 유지하되, 백엔드는 `cqlFilter`도 호환한다.
|
||||
- 노후관로 전용 신규 API는 만들지 않는다.
|
||||
- 상세 기본정보 헤더에는 설치일자 기반 경과년도를 배지 형태로 함께 표시한다.
|
||||
- 노후관로 현황은 `/map/aged-pipe-popup` 윈도우 팝업에서 자체 조회한다.
|
||||
- 부모 지도와 팝업 간 상태 동기화는 API가 아니라 `postMessage`로 처리한다.
|
||||
- `SN_AGED_PIPE_ROW_SELECT`: 팝업 목록 행 선택 row를 부모 지도에 전달
|
||||
- `SN_AGED_PIPE_FILTER_SYNC`: 부모 좌측 설정의 적용 필터를 열린 팝업에 전달
|
||||
- `SN_AGED_PIPE_POPUP_MINIMIZE`: 팝업 최소화 상태를 부모 지도에 전달
|
||||
|
||||
## 미확인사항
|
||||
|
||||
- 기존 `v1/fclts`로 1차 구현은 가능하나 운영 기준 전용 API가 필요한지 백엔드에서 판단 필요
|
||||
- `cqlFiter` 파라미터명 오탈자 호환 여부 확인 필요
|
||||
- `cqlFiter`를 문자열로 받는 경우 허용 필드와 연산자 제한 필요
|
||||
- 경과년도 계산을 프론트에서 계속 할지, 백엔드 응답 필드로 받을지 확인 필요
|
||||
- `fid`가 GeoServer `FEATUREID`와 항상 일치하는지 확인 필요
|
||||
- `mngInstCd`가 없는 노후관로 행에서 상세 API를 어떻게 처리할지 확인 필요
|
||||
- 엑셀 다운로드는 현재 프론트 유틸로 1만 건까지 생성하며, 5만 건 이상 서버 비동기 파일 API 필요 여부 확인 필요
|
||||
- 처리구역 분석 통계를 프론트 계산으로 할지, 백엔드 API로 받을지
|
||||
@@ -0,0 +1,40 @@
|
||||
# 노후관로관리 화면흐름
|
||||
|
||||
## 목적
|
||||
|
||||
사용자 이벤트와 화면 상태 변화를 정리한다.
|
||||
|
||||
## SN_MN010102 노후관로관리
|
||||
|
||||
| 트리거 | 동작 | 결과 |
|
||||
|---|---|---|
|
||||
| 화면 진입 | `Gis` 초기화, `SN_NETWORK` 레이어 설정 조회 | 지도와 시설물 트리 표시 |
|
||||
| 노후관로 체크 ON | 경과년도 기준에 맞는 관로 스타일 강조 | 지도에 노후관로 표출 |
|
||||
| 좌측 하단 경과년도 적용 | 기준값 갱신, 레이어 스타일 재적용, 열린 윈도우 팝업에 필터 동기화 메시지 전송 | 지도/목록 조건 갱신 |
|
||||
| 노후관로 목록 아이콘 클릭 | `/map/aged-pipe-popup` 윈도우 팝업 오픈 | `UiTable` 목록 표시 |
|
||||
| 목록 조회 | 경과년도/시도/시군구 조건 조회 | 목록 갱신 |
|
||||
| 목록 다운로드 | 조회 결과 다운로드 | 엑셀 또는 파일 응답 |
|
||||
| 목록 행 클릭 | `postMessage`로 부모 지도에 row 전달 | 지도 위치 이동, `FeatureClickEventPopup` 표시 |
|
||||
| 팝업 최소화 | 팝업에서 최소화 메시지 전송 후 창 닫기 | 지도 위 최소화 카드 표시 |
|
||||
| 최소화 카드 열기 | `/map/aged-pipe-popup` 윈도우 팝업 재오픈 | 동일 조건의 목록 표시 |
|
||||
| 지도 관로 클릭 | 피처 선택 | 상세정보 표시 |
|
||||
|
||||
## 2026-04-23 보완 흐름
|
||||
|
||||
| 트리거 | 동작 | 결과 |
|
||||
|---|---|---|
|
||||
| 경과년도 입력 | 로컬 입력 상태만 변경 | 입력 중 포커스 유지 |
|
||||
| 경과년도 적용 버튼 또는 Enter | 적용 조건 확정, CQL 재생성, 열린 팝업 목록 재조회 | 노후관로 강조 레이어와 윈도우 팝업 목록 갱신 |
|
||||
| 목록 팝업 열기 | 실제 Next 라우트 `/map/aged-pipe-popup` 실행 | 브라우저 밖 윈도우 팝업으로 동작 |
|
||||
| 상세 패널 표시 | 설치일자 기반 경과년도 계산 | `기본정보` 옆에 경과년도 배지 표시 |
|
||||
| 노후관로 조회 | sentinel 설치일자 제외 조건 추가 | `1900-01-01`, `1999-01-01` 데이터 제외 |
|
||||
| 노후관로 체크 ON | `minViewSize = 14` 기준 강조 레이어 추가 | 줌 레벨 14 이상에서 일반 노후관로 강조선 확인 |
|
||||
| 선택 관로 표시 | 선 피처 선택 스타일 적용 | 다중 stroke로 보라색 선택선 강조 |
|
||||
|
||||
## SN_MN010103 노후관로분석
|
||||
|
||||
| 트리거 | 동작 | 결과 |
|
||||
|---|---|---|
|
||||
| 화면 진입 | 하수처리구역 레이어 표시 | 분석 대상 구역 확인 |
|
||||
| 처리구역 클릭 | 구역 기본정보 및 관로 분석정보 조회/계산 | 우측 상세 패널 표시 |
|
||||
| 보수이력 클릭 | 보수이력 팝업 또는 화면 호출 | 이력 목록 표시 |
|
||||
@@ -0,0 +1,39 @@
|
||||
# 노후관로관리 검증계획
|
||||
|
||||
## 브라우저 검증
|
||||
|
||||
| 항목 | 확인 내용 | 상태 |
|
||||
|---|---|---|
|
||||
| 기존 레이아웃 | Header/LNB/GisTree/상세 패널 위치가 기존 화면과 같은지 확인 | 대기 |
|
||||
| 좌측 설정 | 하단 경과년도 설정 영역이 좌측 패널 내부에 표시되는지 확인 | 대기 |
|
||||
| 접힘/펼침 | 시설물 영역과 설정 영역이 각각 접히고 펼쳐지는지 확인 | 대기 |
|
||||
| 노후관로 체크 | 체크 ON/OFF 시 레이어 강조가 바뀌는지 확인 | 대기 |
|
||||
| 목록 윈도우 팝업 | 목록 아이콘 클릭 시 `/map/aged-pipe-popup`이 브라우저 밖 윈도우 팝업으로 열리는지 확인 | 대기 |
|
||||
| 버튼 색상 | 조회 primary, 다운로드 green 톤인지 확인 | 대기 |
|
||||
| 상세 연동 | 지도 클릭/팝업 목록 행 클릭 시 상세 패널 표시 | 대기 |
|
||||
| 상세 경과년도 | 하수관로 상세 `기본정보` 옆에 경과년도 배지가 표시되는지 확인 | 대기 |
|
||||
| 경과년도 입력 안정성 | 숫자 연속 입력 중 포커스가 유지되고 적용/Enter 후 조건이 반영되는지 확인 | 대기 |
|
||||
| 설정-팝업 동기화 | 좌측 `노후관로 설정` 적용 시 열린 윈도우 팝업의 경과년도/목록이 같이 갱신되는지 확인 | 대기 |
|
||||
| 팝업 최소화 | 윈도우 팝업의 `최소화` 클릭 시 지도 위 최소화 카드가 표시되고 `열기`로 다시 윈도우 팝업이 열리는지 확인 | 대기 |
|
||||
| 설치일자 제외 | `1900-01-01`, `1999-01-01` 데이터가 목록/강조선 조회에서 제외되는지 확인 | 대기 |
|
||||
| 색상 구분 | 오수관은 주황색, 노후관로 강조선은 빨간색으로 구분되는지 확인 | 대기 |
|
||||
| 줌 레벨 | 줌 레벨 14 이상에서 노후관로 강조선이 표시되는지 확인 | 대기 |
|
||||
| 선택 관로 강조 | 선택된 관로가 soft glow/white halo/violet core 다중 stroke로 지도 위에서 명확히 보이는지 확인 | 대기 |
|
||||
| dev CSS/chunk 404 | 팝업 실행 후 `/_next/static/css/app/layout.css?...` 404 반복 호출이 발생하지 않는지 확인 | 대기 |
|
||||
|
||||
## 빌드 검증
|
||||
|
||||
```powershell
|
||||
pnpm --filter @common/business_components run build
|
||||
pnpm --filter sn run build
|
||||
```
|
||||
|
||||
`business_components`를 수정하지 않는 경우 `sn` 빌드만 우선 수행한다.
|
||||
|
||||
## 네트워크 검증
|
||||
|
||||
- 레이어 설정 조회
|
||||
- 관로 목록 조회
|
||||
- 관로 상세 조회
|
||||
- 다운로드 요청
|
||||
- 처리구역 분석 요청 또는 계산용 데이터 조회
|
||||
@@ -0,0 +1,114 @@
|
||||
# 노후관로관리 검증결과
|
||||
|
||||
## 2026-04-22 구현 후 빌드 검증
|
||||
|
||||
| 구분 | 명령 | 결과 | 비고 |
|
||||
|---|---|---|---|
|
||||
| 공통 비즈니스 컴포넌트 | `pnpm --filter @common/business_components run build` | 성공 | `Gis`, `GisTree` optional 확장 포함 |
|
||||
| sn 앱 | `pnpm --filter sn run build` | 성공 | Next 컴파일/페이지 생성 성공 |
|
||||
|
||||
## 남은 검증
|
||||
|
||||
- 브라우저에서 `/map` 진입 후 실제 `SN_NETWORK` 응답에 `노후관로` 노드가 내려오는지 확인
|
||||
- 노후관로 체크 ON/OFF 시 좌측 하단 설정 컴포넌트 표시/숨김 확인
|
||||
- 노후관로 목록 아이콘 클릭 시 현황 모달 표시 확인
|
||||
- `v1/fclts`의 `cqlFiter` 조건이 경과년도/시도/시군구 조합대로 동작하는지 네트워크 확인
|
||||
- 지도 halo 강조가 기존 하수관로 선 색상을 덮지 않는지 브라우저 확인
|
||||
- 목록 행 더블클릭 시 지도 이동과 `FeatureClickEventPopup` 상세 표시 확인
|
||||
|
||||
## 특이사항
|
||||
|
||||
- `sn` 빌드 마지막 단계에서 Windows symlink 권한으로 standalone trace 복사 경고가 발생했지만, Next 빌드 자체는 성공했다.
|
||||
|
||||
## 2026-04-23 보완 검증
|
||||
|
||||
| 구분 | 확인 내용 | 결과 | 비고 |
|
||||
|---|---|---|---|
|
||||
| 상세 경과년도 | 하수관로 상세 `기본정보` 헤더 옆 경과년도 배지 추가 | 반영 | `FeatureClickEventPopup`에서 `elapsedYears` 계산값 표시 |
|
||||
| 경과년도 입력 안정화 | 좌측 인라인 설정 입력 중 재마운트 방지 | 반영 | `GisTree`가 React node inline view를 렌더링하도록 보완 |
|
||||
| 목록 윈도우 팝업 | 노후관로 현황을 Dialog modal 대신 드래그 가능한 fixed popup으로 표시 | 반영 | `AgedPipeListModal`에서 헤더 pointer drag 처리 |
|
||||
| sentinel 설치일자 제외 | `1900-01-01`, `1999-01-01` 데이터 제외 | 성공 | CQL 조건 API 200, 결과 첫 5건 sentinel 미포함 |
|
||||
| 오수관 색상 | 일반 오수관 색상을 주황색으로 변경 | 성공 | `lyr_sn=6`, `line_colr=rgba(255, 128, 0, 1)` 확인 |
|
||||
| 노후관로 줌 레벨 | 노후관로 강조 레이어 최소 줌 기준 | 확인 | `AGED_PIPE_MIN_ZOOM=14`, `minViewSize=14` |
|
||||
| 공통 컴포넌트 빌드 | `business_components` 빌드 | 성공 | `pnpm --filter @common/business_components run build` |
|
||||
| `sn` 앱 빌드 | `sn` 빌드 | 성공 | Next 컴파일/페이지 생성 성공. standalone symlink 권한 경고 발생 |
|
||||
|
||||
## 2026-04-23 추가 UX 보완 검증
|
||||
|
||||
| 구분 | 확인 내용 | 결과 | 비고 |
|
||||
|---|---|---|---|
|
||||
| 브라우저 밖 팝업 | 노후관로 현황을 열 때 처음부터 별도 창으로 표시 | 반영 | 사용자 클릭 시점에 `/map/aged-pipe-popup` Next 페이지를 `window.open`으로 실행 |
|
||||
| 새 창 렌더링 | 별도 창을 실제 Next 라우트로 분리 | 반영 | `about:blank`에 React/CSS를 주입하던 방식 제거. `/map/aged-pipe-popup`에서 목록 자체 조회/렌더링 |
|
||||
| 팝업 동작 기준 | 노후관로 현황 기본 동작을 별도 윈도우 팝업으로 고정 | 반영 | `새 창`/`지도 안으로` 전환 버튼 제거. 팝업 내부 앱 버튼은 `최소화`만 유지 |
|
||||
| 새 창 CSS 404 방지 | 새 창 CSS 복제 방식 제거 | 반영 | `/_next/static/css/app/layout.css?...` dev 404 반복 호출 방지를 위해 stylesheet 복사/주입 구조 제거 |
|
||||
| 목록 행 선택 연동 | 새 창 목록 행 클릭 시 부모 지도 화면으로 선택 row 전달 | 반영 | `window.opener.postMessage`로 row를 전달하고 부모 `/map`에서 위치 이동/상세 패널 표시 |
|
||||
| 최소화 카드 기준 | 팝업에서 `최소화` 클릭 시 지도 위 최소화 카드 표시 | 반영 | 최소화 카드의 `열기`는 다시 `/map/aged-pipe-popup` 윈도우 팝업을 실행 |
|
||||
| 지도 설정-팝업 필터 동기화 | 좌측 `노후관로 설정` 적용 시 열린 윈도우 팝업 목록도 재조회 | 반영 | 부모 `/map`에서 `SN_AGED_PIPE_FILTER_SYNC` 메시지 전송, 팝업에서 필터/목록 1페이지 갱신 |
|
||||
| 선택 관로 시각 강조 | 선택된 선 피처 스타일 개선 | 반영 | soft violet glow, white halo, violet core, lavender highlight 다중 stroke 적용 |
|
||||
| dev CSS/chunk 404 복구 | dev 서버 중 `next build` 실행으로 `.next` 산출물 혼재 발생 | 조치 | `apps/sn/.next` 삭제 후 dev 서버 재시작 필요. dev 실행 중에는 `next build` 병행 금지 |
|
||||
| 줌 레벨 기준 | 노후관로 강조 레이어 표시 시작 줌 레벨 | 확인 | `AGED_PIPE_MIN_ZOOM=14`, `minViewSize=14` |
|
||||
| 지도 표시 원복 | 추가 안내 배지/범례/강조선 스타일 변경 제거 | 반영 | `lnWdth=4`, `lnColor=rgba(235, 40, 40, 0.82)` 유지 |
|
||||
| 서버 상태 | 백엔드/프론트 포트 확인 | 성공 | `localhost:8883`, `localhost:3002` TCP 연결 성공 |
|
||||
| `/map` 응답 | 프론트 `/map` HTTP 응답 확인 | 성공 | `GET http://localhost:3002/map` 200 OK |
|
||||
| `sn` 앱 빌드 | 변경 후 `sn` 빌드 | 성공 | Next 컴파일/페이지 생성 성공. standalone symlink 권한 경고 발생 |
|
||||
| TypeScript 검사 | `pnpm --filter sn exec tsc --noEmit --pretty false` | 기존 오류 잔존 | 이번 변경 신규 오류는 해소. 기존 `common/index.ts`, `html/(with-base-layout)`, chart implicit any 오류 잔존 |
|
||||
|
||||
### 브라우저 검증 제약
|
||||
|
||||
- 현재 workspace에 Playwright CLI가 설치되어 있지 않아 자동 브라우저 조작 검증은 수행하지 못했다.
|
||||
- 실행 중인 Chrome은 remote debugging port가 열려 있지 않았다.
|
||||
- Headless Chrome 스크린샷은 임시 브라우저 세션 특성상 사용자 로그인/지도 리소스 상태를 재현하지 못해 최종 UI 증적으로 사용하지 않았다.
|
||||
|
||||
### API 검증
|
||||
|
||||
```text
|
||||
GET /sewerage-service/api/v1/fclts
|
||||
?lyrTypeNm=tb_ms_swage_ppl
|
||||
&cqlFiter=instl_ymd IS NOT NULL
|
||||
and instl_ymd NOT LIKE '19000101%'
|
||||
and instl_ymd NOT LIKE '19990101%'
|
||||
and instl_ymd <= '19960423'
|
||||
&page=0
|
||||
&size=5
|
||||
```
|
||||
|
||||
결과:
|
||||
|
||||
```text
|
||||
status=200
|
||||
count=735119
|
||||
첫 5건 설치일자: 19730731, 19830331, 19690630, 19870509, 19841020
|
||||
```
|
||||
|
||||
### DB 검증
|
||||
|
||||
```text
|
||||
lyr_sn=6
|
||||
lyr_nm=오수관
|
||||
line_colr=rgba(255, 128, 0, 1)
|
||||
```
|
||||
|
||||
## 검증 개요
|
||||
|
||||
| 항목 | 내용 |
|
||||
|---|---|
|
||||
| 검증 일자 | 2026-04-22 |
|
||||
| 검증자 | Codex |
|
||||
| 대상 화면 | SN_MN010102, SN_MN010103 |
|
||||
| 실행 URL | 빌드 검증 기준 |
|
||||
| 브라우저 | 미수행 |
|
||||
|
||||
## 검증 결과
|
||||
|
||||
| 항목 | 결과 | 증적 | 비고 |
|
||||
|---|---|---|---|
|
||||
| 공통 비즈니스 컴포넌트 빌드 | 성공 | `pnpm --filter @common/business_components run build` | `startOfMonth` unused 경고는 기존 빌드 경고로 보임 |
|
||||
| `sn` 앱 빌드 | 성공 | `pnpm --filter sn run build` | 종료 코드 0. Windows symlink 권한 경고 발생 |
|
||||
| 타입 검사 | 부분 실패 | `pnpm --filter sn exec tsc --noEmit` | 신규 `layerSettingView` 관련 오류는 해소. 기존 `SwtrmtFclt`, `with-base-layout`, chart implicit any 오류 잔존 |
|
||||
| HTML/코드 공백 검사 | 성공 | `git diff --check` | 관련 수정 파일 기준 |
|
||||
|
||||
## 남은 리스크
|
||||
|
||||
- 브라우저에서 `/map` 실제 화면 조작 검증은 사용자가 최종 확인해야 한다.
|
||||
- `tsc --noEmit`의 기존 타입 오류는 별도 정리가 필요하다.
|
||||
- Next standalone trace 중 symlink 권한 경고가 있어 Windows 개발 환경 권한 확인이 필요하다.
|
||||
@@ -0,0 +1,55 @@
|
||||
# 노후관로관리 백엔드 착수 프롬프트
|
||||
|
||||
아래 프롬프트는 새 스레드에서 백엔드 작업을 시작할 때 그대로 사용한다.
|
||||
|
||||
```text
|
||||
WORKSPACE_ROOT=C:\mindone_project\iipbs-workspace 기준으로 작업해줘.
|
||||
|
||||
프론트 노후관로관리 1차 구현은 마무리했고, 이제 sewerage-service 백엔드 계약 정리와 보강을 시작하려고 한다.
|
||||
|
||||
반드시 먼저 아래 AGENTS.md를 확인해줘.
|
||||
- WORKSPACE_ROOT/AGENTS.md
|
||||
- WORKSPACE_ROOT/IIPBS/sewerage-service/AGENTS.md
|
||||
- WORKSPACE_ROOT/frontend/apps/sn/AGENTS.md
|
||||
|
||||
이번 백엔드 작업의 기준 문서는 아래야.
|
||||
- IIPBS/sewerage-service/docs/AI코딩하네스/작업계획/001-BE-P2-노후관로관리-작업카드.md
|
||||
- frontend/apps/sn/app/html/06. 노후관로관리_시나리오_v1.0.md
|
||||
- frontend/apps/sn/docs/노후관로관리/03-API응답필드매핑표.md
|
||||
- frontend/apps/sn/docs/노후관로관리/99-미확인사항.md
|
||||
|
||||
현재 프론트에서 확정된 동작은 다음과 같아.
|
||||
1. /map 좌측 레이어 트리 최상위 순서는 시설, 침수위험지도(중점관리지역), 도시침수지도(정보제공포털), 노후관로 순서다.
|
||||
2. 노후관로는 기존 하수관로 시설물 레이어와 별도 제어 항목이다.
|
||||
3. 노후관로 체크 시 경과년도/지역 조건에 맞는 하수관로를 지도에 빨간 강조선으로 표출한다.
|
||||
4. 노후관로 항목 바로 아래 인라인 설정으로 경과년도(기본 30년)를 입력한다.
|
||||
5. 노후관로 목록은 GET v1/fclts?lyrTypeNm=tb_ms_swage_ppl&cqlFiter=... 를 현재 재사용한다.
|
||||
6. 목록 행 클릭 시 GeoServer FEATUREID(fid)로 위치 이동하고, GET v1/fcltppl/{fcltMngNo}/{mngInstCd} 상세를 우측 패널에 표시한다.
|
||||
7. 목록 필수 필드는 fid, fcltMngNo/fclt_mng_no, mngInstCd/mng_inst_cd, instlYmd/instl_ymd, pdmtVl/pdmt_vl, prlgVl/prlg_vl, usgCd/usg_cd, mqltCd/mqlt_cd 이다.
|
||||
|
||||
백엔드에서 우선 확인/정리할 것은 다음이야.
|
||||
1. GET /api/v1/fclts 구현 위치와 파라미터 처리 방식 확인
|
||||
2. cqlFiter 파라미터명 오탈자 호환 여부 확인 또는 cqlFilter와의 호환 처리 방안 제안
|
||||
3. CQL 문자열 직접 전달 시 허용 필드/연산자 제한 또는 안전한 검색 DTO로 전환 가능성 검토
|
||||
4. instl_ymd <= cutoff, pbadms_emd_cd LIKE 조건이 tb_ms_swage_ppl 기준으로 정상 동작하는지 확인
|
||||
5. 목록 응답 fid가 GeoServer FEATUREID로 사용 가능한지 확인
|
||||
6. mngInstCd 누락 행이 있을 때 상세 API 처리 방식 확인
|
||||
7. tb_sn_lyr_stng에 정식 노후관로 레이어 설정을 넣는 것이 맞는지 분석
|
||||
8. 필요하면 노후관로 전용 read-only API를 설계하되 기존 프론트/기존 API 계약은 깨지 않게 해줘.
|
||||
|
||||
작업 방식:
|
||||
- 먼저 코드와 문서를 읽고 영향 범위를 정리해줘.
|
||||
- DB 스키마 변경은 기본적으로 하지 말고, 필요한 경우 이유/영향/롤백을 먼저 정리해줘.
|
||||
- 백엔드 변경이 필요하면 최소 범위로 구현해줘.
|
||||
- 가능한 테스트나 API 검증 방법을 함께 제시해줘.
|
||||
|
||||
결과 보고는 아래 형식으로 해줘.
|
||||
- 작업 목적
|
||||
- 수정 대상 파일
|
||||
- 변경 내용 요약
|
||||
- 영향 범위
|
||||
- 테스트 / 검증 방법
|
||||
- 롤백 방법
|
||||
- 남은 리스크
|
||||
```
|
||||
|
||||
@@ -0,0 +1,27 @@
|
||||
# 노후관로관리 미확인사항
|
||||
|
||||
| 일자 | 구분 | 내용 | 확인 필요 대상 | 상태 |
|
||||
|---|---|---|---|---|
|
||||
| 2026-04-22 | BE | `v1/fclts`의 `cqlFiter` 파라미터명 오탈자 호환 여부 | BE | 확인 필요 |
|
||||
| 2026-04-22 | BE | CQL 문자열 직접 전달 방식의 허용 필드/연산자 제한 여부 | BE | 확인 필요 |
|
||||
| 2026-04-22 | BE | 목록 응답 `fid`가 GeoServer `FEATUREID` 위치 이동에 항상 사용 가능한지 | BE/GeoServer | 확인 필요 |
|
||||
| 2026-04-22 | BE | `mngInstCd` 누락 행의 상세 API 처리 방식 | BE | 확인 필요 |
|
||||
| 2026-04-22 | BE | `tb_sn_lyr_stng`에 정식 노후관로 레이어 설정을 추가할지 여부 | BE/DB | 확인 필요 |
|
||||
| 2026-04-22 | BE | 대량 엑셀 다운로드를 프론트 생성으로 유지할지 서버 파일 API로 전환할지 | BE/FE | 확인 필요 |
|
||||
| 2026-04-23 | FE | 상세 패널 기본정보 헤더에 노후관로 경과년도 표시 | FE | 반영 |
|
||||
| 2026-04-23 | FE | 경과년도 입력 중 포커스 끊김/적용 누락 문제 | FE | 반영, 브라우저 검증 필요 |
|
||||
| 2026-04-23 | FE | 노후관로 현황 목록을 모달이 아닌 윈도우형 팝업으로 표시 | FE | 반영, 브라우저 검증 필요 |
|
||||
| 2026-04-23 | DB/FE | 오수관 색상을 주황색으로 변경하고 노후관로 빨간 강조선과 구분 | DB/FE | DB 반영 |
|
||||
| 2026-04-23 | FE | `1900-01-01`, `1999-01-01` sentinel 설치일자 제외 | FE | 반영, API 검증 필요 |
|
||||
| 2026-04-23 | FE | 노후관로 강조 레이어 표출 줌 레벨 기준 | FE | `minViewSize=14` 확인 |
|
||||
| 2026-04-23 | FE | 윈도우 팝업과 지도 좌측 설정의 경과년도 조건 동기화 | FE | 반영, 브라우저 검증 필요 |
|
||||
| 2026-04-23 | FE | 팝업 최소화/복원 기준 | FE | 팝업 `최소화` 클릭 시만 최소화 카드 표시로 반영 |
|
||||
| 2026-04-23 | FE | 선택 관로 보라색 강조선 시각 개선 | FE/공통컴포넌트 | 반영, 브라우저 검증 필요 |
|
||||
|
||||
## 우선 확인 대상
|
||||
|
||||
- 기존 `v1/fclts`의 필터 조건으로 경과년도/지역 조회를 모두 처리할 수 있는지
|
||||
- 경과년도 기준값 저장/로그 API가 필요한지
|
||||
- 처리구역 분석 통계를 프론트 계산으로 할지 백엔드 API로 받을지
|
||||
- 엑셀 다운로드 5만 건 이상 처리 방식
|
||||
- 지반침하정보도 노후관로와 같은 인라인 설정 확장 포인트를 사용하되, 백엔드 API/레이어 설정은 별도 확정 필요
|
||||
@@ -0,0 +1,32 @@
|
||||
# 노후관로관리 문서
|
||||
|
||||
## 목적
|
||||
|
||||
노후관로관리 및 노후관로분석 화면을 `sn` 기존 화면/컴포넌트 기준으로 구현하기 위한 기능별 산출물 묶음이다.
|
||||
|
||||
## 대상 화면
|
||||
|
||||
| 화면 ID | 화면명 | 메뉴 경로 |
|
||||
|---|---|---|
|
||||
| `SN_MN010102` | 노후관로관리 | 하수관망도 > 노후관로관리 |
|
||||
| `SN_MN010103` | 노후관로분석 | 하수관망도 > 노후관로분석 |
|
||||
|
||||
## 문서 순서
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| `00-범위.md` | 기능 범위와 제외 범위 |
|
||||
| `01-기존화면기반-컴포넌트분해.md` | 기존 화면 기준 영역/컴포넌트/색상 분해 |
|
||||
| `02-컴포넌트별-작업목록.md` | 실제 구현 전 작업 단위 목록 |
|
||||
| `03-API응답필드매핑표.md` | API와 화면 표시 필드 매핑 |
|
||||
| `04-화면흐름.md` | 사용자 이벤트와 화면 상태 흐름 |
|
||||
| `05-검증계획.md` | 구현 후 검증 계획 |
|
||||
| `06-검증결과.md` | 검증 수행 결과 |
|
||||
| `99-미확인사항.md` | 남은 질문과 의사결정 대기 항목 |
|
||||
|
||||
## 작성 기준
|
||||
|
||||
- 실제 React 구현은 기존 `NoFooterLayout`, `Gis`, `GisTree`, `FeatureClickEventPopup`, `VerticalTable`, `UiTable` 흐름을 우선한다.
|
||||
- 백엔드 상세 구현은 작성하지 않고, 필요한 API/필드/응답 사용 방식만 매핑한다.
|
||||
- 화면설계서와 다른 독립 디자인을 만들지 않는다.
|
||||
|
||||
Reference in New Issue
Block a user