sn: 노후 하수관로 정비사업
This commit is contained in:
@@ -0,0 +1,20 @@
|
||||
# SN-노후하수관로정비사업 FE 통합검증계획
|
||||
|
||||
## 자동 검증
|
||||
|
||||
- `pnpm --filter sn run build`
|
||||
- 신규 세 경로의 Next 산출물 생성 확인
|
||||
- 변경 파일 `git diff --check`
|
||||
|
||||
## 브라우저 검증
|
||||
|
||||
1. 목록 전체 23개 열과 가로 스크롤 확인
|
||||
2. 검색·페이지 이동 확인
|
||||
3. 제공 원본 xlsx 업로드 후 517건 표시 확인
|
||||
4. 엑셀다운로드 후 두 시트 및 재업로드 확인
|
||||
5. 등록 저장, 행 클릭 수정, 수정 화면 삭제 확인
|
||||
6. 목록에 삭제 버튼이 없고 수정 하단 버튼 순서가 `목록`, `저장`, `삭제`인지 확인
|
||||
|
||||
## 선행조건
|
||||
|
||||
로그인 세션, 메뉴 권한, sewerage-service, 생성된 `tb_sn_obslt_swage_ppl_biz`가 필요하다.
|
||||
@@ -0,0 +1,10 @@
|
||||
# SN-노후하수관로정비사업 FE 통합검증결과
|
||||
|
||||
## 2026-08-03
|
||||
|
||||
- 신규 TS/TSX 파일 대상 ESLint를 실행했고 오류·경고 없이 통과했다.
|
||||
- 선행 빌드에서 목록·등록·수정 세 경로의 `page.js` 산출을 확인했다.
|
||||
- 독립 `tsc`는 저장소에 설치된 TypeScript가 `ignoreDeprecations: 6.0`을 지원하지 않아 환경 오류로 종료했다.
|
||||
- 최종 전체 빌드는 신규 화면이 아닌 공통 `file-uploader`, `slider`, `switch`, `table`, `tabs` CSS 처리 중 Windows `EMFILE: too many open files`로 실패했다.
|
||||
- 로그인·실 API 브라우저 검증은 실행환경 미기동으로 보류한다.
|
||||
- 지역 검색 유지보수 후 `pnpm exec eslint apps/sn/src/features/obsltPpl/ui/ObsltPplListPage.tsx`를 실행해 오류·경고 없이 통과했다.
|
||||
@@ -0,0 +1,28 @@
|
||||
# SN-노후하수관로정비사업 FE 작업카드
|
||||
|
||||
## 목표
|
||||
|
||||
`/oper/obsltPplBiz`에 원본 Excel 전체 항목 목록과 검색·등록·업로드·엑셀다운로드 기능을 제공하고 등록·수정 화면을 분리한다.
|
||||
|
||||
## 구현 계약
|
||||
|
||||
- 목록은 23개 컬럼을 모두 노출하고 `overflow-x-auto`로 가로 스크롤한다.
|
||||
- 목록 행 클릭은 `/oper/obsltPplBiz/register/{id}`로 이동한다.
|
||||
- 목록에는 삭제 버튼을 두지 않는다.
|
||||
- 등록 화면 하단은 `목록`, `저장`; 수정 화면은 `목록`, `저장`, `삭제` 순서다.
|
||||
- 조사관리의 multipart 흐름만 재사용하고 조사 결과 전용 validate/commit·첨부서비스 코드는 공유하지 않는다.
|
||||
- `apps/cs/banner/register`의 표형 폼과 별도 등록/수정 경로를 시각 참고한다.
|
||||
- 목록 검색의 시도·시군구는 SN 앱 공통 `useStore`의 지역 목록을 사용하는 연계 `SelectBox`로 제공하고, 시도 변경 시 시군구를 초기화한다.
|
||||
|
||||
## API 및 관측 포인트
|
||||
|
||||
- 목록 로딩·오류·업로드 결과 건수는 화면에서 문구로 관측 가능해야 한다.
|
||||
- 업로드 input은 `.xlsx`만 받는다.
|
||||
- 다운로드 버튼명은 `엑셀다운로드`로 고정한다.
|
||||
- 브라우저 검증 URL: `/oper/obsltPplBiz`, `/oper/obsltPplBiz/register`, `/oper/obsltPplBiz/register/{id}`
|
||||
|
||||
## 제외
|
||||
|
||||
- 기존 `/oper/oldPp` 변경
|
||||
- `apps/cs` 또는 공통 컴포넌트 변경
|
||||
- 메뉴/권한 운영 데이터 변경
|
||||
@@ -0,0 +1,28 @@
|
||||
# SN-노후하수관로정비사업 FE 통합구현기록
|
||||
|
||||
## 입력 근거
|
||||
|
||||
사용자 작업지시 Excel, 공통 통합설계, `/oper/oldPp`, 조사관리 업로드, `apps/cs/banner/register`를 확인했다.
|
||||
|
||||
## 2026-08-03 구현
|
||||
|
||||
- `src/features/obsltPpl`에 API, 타입, 목록, 표형 등록·수정 화면을 추가했다.
|
||||
- `app/(with-base-layout)/oper/obsltPplBiz`에 목록·등록·동적 수정 경로를 추가했다.
|
||||
- 목록에서 Excel 전체 항목과 사업구분·시군구코드를 표시하고 직접 구성 Table을 가로 스크롤 영역에 배치했다.
|
||||
- 목록 액션을 `조회`, `등록`, `업로드`, `엑셀다운로드`로 구성하고 삭제는 수정 화면으로 이동했다.
|
||||
- 업로드 성공 시 전체·정밀조사·정비사업 저장 건수를 표시하고 목록을 재조회한다.
|
||||
- 기존 공통 또는 타 앱 소스는 변경하지 않았다.
|
||||
|
||||
## BE 공유 계약
|
||||
|
||||
기준 API는 `/api/v1/obsltPplBiz`이며 목록은 Spring Page, 업로드는 multipart `file`, 다운로드는 XLSX Blob이다.
|
||||
|
||||
## 남은 리스크
|
||||
|
||||
로그인·메뉴 권한이 구성된 통합환경 브라우저 검증이 필요하다.
|
||||
|
||||
## 2026-08-03 지역 검색 유지보수
|
||||
|
||||
- 목록의 시도·시군 입력을 공통 `SelectBox`로 교체했다.
|
||||
- SN 앱 공통 Zustand store의 `ctpv`, `sgg`, `fetchCtpv`, `fetchSgg`를 사용하고 선택 시 기존 검색 API 계약에 맞는 한글명을 설정한다.
|
||||
- 선택한 시도의 코드 앞 두 자리를 기준으로 시군구 후보를 제한하고 시도 변경 시 기존 시군구 선택을 초기화한다.
|
||||
Reference in New Issue
Block a user