조사상세 본단위구간 모드 및 결함별 엑셀 다운로드 구현
This commit is contained in:
@@ -180,3 +180,22 @@
|
||||
|
||||
- 브라우저 수동 검증은 로그인된 `SN` 세션과 `/oper/exmn/register?sample=Y` 진입이 선행조건이다.
|
||||
- 개발 서버가 실행 중이면 별도 프로덕션 빌드를 실행하지 않고 정적 검사와 사용자 화면 확인을 우선한다.
|
||||
|
||||
## 14. 관로 본단위구간과 결함별 상세 팝업 회귀 계획
|
||||
|
||||
| 검증 항목 | 방법 | 기대 결과 |
|
||||
|---|---|---|
|
||||
| 관로 전체 상세보기 | `PPL`, `defectType=ALL` 진입 | 처리분구·관리번호와 `관로`·`본단위구간` 전환 표시 |
|
||||
| 맨홀 상세보기 | `MNHL` 상세보기 진입 | 관로 전용 모드 전환 미표시 |
|
||||
| 본단위구간 초기값 | 관리번호 없이 `본단위구간` 전환 | 선택 처리분구의 전체 관리번호 단위구간 표시 |
|
||||
| 관리번호 검색 | 일부 관리번호 입력 후 조회 | 부분 일치 관로번호의 단위구간만 표시 |
|
||||
| 단위구간 표 구조 | 한 관로의 여러 상세행 확인 | 관로·단위구간 공통 셀 병합과 14개 열 유지 |
|
||||
| 구조적 링크 | 구조적결함 건수 클릭 | 조회 조건 없이 구조적결함 집계표 즉시 표시 |
|
||||
| 운영적 링크 | 운영적결함 건수 클릭 | 조회 조건 없이 운영적결함 집계표 즉시 표시 |
|
||||
| 결함별 요약 행 | 집계표 제목 행 확인 | 합계 정보와 다운로드 버튼이 오른쪽에 함께 표시 |
|
||||
| 전체 상세보기 회귀 | 상단 상세보기 버튼 진입 | 기존 조회 조건·모드·전체 이상항목 표 유지 |
|
||||
| 엑셀 다운로드 | 전체·분류별·본단위구간 각각 다운로드 | 현재 표시 행·열, 소계·합계와 병합 구조 반영 |
|
||||
| 정적 검사 | 변경 저장소에서 `git diff --check` | 공백 오류 없음 |
|
||||
|
||||
- 실제 다운로드 파일은 Excel에서 열어 헤더, 병합 범위, 소계·합계와 한글 파일명을 대조한다.
|
||||
- 실제 API 연결 후에는 샘플과 동일한 조건으로 JSONB 코드·점수·단위구간 매핑을 재검증한다.
|
||||
|
||||
@@ -206,3 +206,21 @@
|
||||
## 14. 흡수한 기존 문서
|
||||
|
||||
- 없음
|
||||
|
||||
## 15. 관로 본단위구간과 결함별 상세 팝업 검증 결과
|
||||
|
||||
### 15.1 확인 결과
|
||||
|
||||
- 관로 전체 상세보기에서 `관로`·`본단위구간` 전환 UI가 표시되고, 맨홀 상세보기에서는 표시되지 않는 분기를 소스로 확인했다.
|
||||
- 본단위구간 초기 진입 시 3개 샘플 관로의 33개 상세 레코드를 표시하고 관리번호 입력 시 부분 일치로 거르는 동작을 확인했다.
|
||||
- 구조적·운영적 결함 건수 링크 팝업에서 조회 조건 영역이 제거되고 제목, 조회 건수, 합계 정보와 다운로드가 한 행에 표시되는 화면을 사용자가 확인해 완료 판정했다.
|
||||
- `defectType=ALL`과 `defectType=STRUCTURAL` 팝업 경로가 로컬 개발 서버에서 각각 HTTP 200으로 응답하는 것을 확인했다.
|
||||
- 다운로드 구현이 현재 정렬·필터 결과와 표시 열을 전달하고 전체·분류별 표의 소계·합계 및 본단위구간 14개 열을 생성하는 것을 소스로 확인했다.
|
||||
- 변경 파일에 대한 `git diff --check`를 통과했다.
|
||||
|
||||
### 15.2 미수행·후속 검증
|
||||
|
||||
- 생성된 실제 `.xlsx` 파일을 Excel에서 열어 병합 범위와 소계·합계 값을 대조하는 검증은 아직 수행하지 않았다.
|
||||
- 로컬 TypeScript compiler는 기존 샌드박스 `EPERM` 이력에 따라 별도 실행하지 않았다.
|
||||
- 실제 서버 JSONB 데이터 연결과 코드·점수·단위구간 매핑 검증은 백엔드 연동 단계의 후속 항목이다.
|
||||
- 지도보기는 보류 범위로 이번 검증 대상에 포함하지 않았다.
|
||||
|
||||
@@ -206,3 +206,21 @@
|
||||
- 수정 대상은 `src/features/exmn/**`와 `src/features/windowPopup/**` 안으로 제한한다.
|
||||
- 백엔드 API·DTO·DB는 수정하지 않는다.
|
||||
- 완료 게이트는 관로·맨홀 각각 `ALL|STRUCTURAL|OPERATIONAL` 화면, 코드 헤더, 필터 결과와 소계·합계가 일치하는 것이다.
|
||||
|
||||
## 17. 관로 본단위구간과 결함별 상세 팝업 보완 범위
|
||||
|
||||
| 작업 단위 | 확정 내용 |
|
||||
|---|---|
|
||||
| 관로 전체 상세보기 | `관로`·`본단위구간` 소형 슬라이드형 모드 전환 |
|
||||
| 본단위구간 초기 조회 | 관리번호가 없으면 선택 처리분구의 전체 관리번호 표시 |
|
||||
| 본단위구간 검색 | 관리번호 입력 후 부분 일치 조회 |
|
||||
| 본단위구간 표 | 엑셀 `본단위등급표` 기준 14개 열과 단위구간 병합 표시 |
|
||||
| 맨홀 상세보기 | 관로 전용 모드 선택 미표시 |
|
||||
| 결함별 상세보기 | 조회 조건·모드 영역 제거 후 선택 분류 결과 즉시 표시 |
|
||||
| 결함별 요약 행 | 제목·조회 건수와 연장/주행 합계·다운로드를 한 행에 배치 |
|
||||
| 엑셀 다운로드 | 현재 화면의 표시 행·열, 소계·합계 및 병합 구조 반영 |
|
||||
|
||||
- 수정 범위는 `src/features/exmn/model/**`와 `src/features/exmn/ui/**`로 제한한다.
|
||||
- 공통 비즈니스 컴포넌트, API, DTO, DB는 변경하지 않는다.
|
||||
- 프론트 완료 게이트는 전체 상세보기 회귀, 본단위구간 전체/검색 조회, 구조·운영 결함별 간소화 화면과 현재 화면 기준 엑셀 생성이다.
|
||||
- 실제 API·JSONB 매핑과 다운로드 파일의 업무 데이터 대조는 백엔드 연동 단계에서 수행한다.
|
||||
|
||||
@@ -353,3 +353,38 @@
|
||||
- `src/features/windowPopup/model/popupDefinitions.ts`
|
||||
- `src/features/windowPopup/ui/ExmnSurveyDetailPopupContent.tsx`
|
||||
- 백엔드 코드·API·DTO·DB는 변경하지 않았다. 후속 API는 `jobType`, 처리분구 식별자, `defectType`과 JSONB 코드별 건수 계약을 사용해야 한다.
|
||||
|
||||
## 13. 2026-07-27 관로 본단위구간과 결함별 상세 팝업 구현
|
||||
|
||||
### 13.1 관로 전체 상세보기 모드
|
||||
|
||||
- 관로조사 전체 상세보기에서 `관로`와 `본단위구간`을 전환하는 소형 슬라이드형 선택 UI를 추가했다.
|
||||
- `본단위구간`은 관로번호, 단위구간, 단위길이, 결함위치, 결함 종류·코드·등급·발생위치·침입수가점·연속결함, 구조·운영 점수, 조사중단사유, 비고를 표시한다.
|
||||
- 관로번호와 단위구간 공통 정보는 `rowSpan`으로 병합해 엑셀 `본단위등급표`와 같은 읽기 흐름을 구성했다.
|
||||
- 관리번호가 비어 있으면 선택한 처리분구의 전체 관리번호를 표시하고, 입력 후 조회하면 부분 일치하는 관로번호만 표시한다.
|
||||
- 맨홀조사에는 관로 전용 모드 UI가 나타나지 않도록 분기했다.
|
||||
- 샘플 데이터는 3개 관로에 각 2개 단위구간, 총 33개 상세 레코드를 구성해 초기 전체 조회와 관리번호 검색을 확인할 수 있게 했다.
|
||||
|
||||
### 13.2 구조적·운영적 결함별 팝업 간소화
|
||||
|
||||
- `defectType=STRUCTURAL|OPERATIONAL`로 진입하면 처리분구·관리번호, 모드, 조회 버튼과 상단 다운로드 영역을 숨기도록 변경했다.
|
||||
- 선택한 처리분구·조사 유형·결함 분류가 적용된 집계표를 팝업 진입 즉시 표시한다.
|
||||
- 집계표 제목 행 오른쪽으로 연장거리 합계, 주행거리 합계와 녹색 다운로드 버튼을 이동했다.
|
||||
- `defectType=ALL`은 기존 조회 조건과 관로 모드를 유지해 상단 상세보기 회귀를 방지했다.
|
||||
|
||||
### 13.3 엑셀 생성
|
||||
|
||||
- 기존 공통 `downloadExcelWithKoreanHeaders`를 사용해 현재 화면의 정렬·필터 결과와 표시 열을 다운로드하도록 구현했다.
|
||||
- 관로·맨홀의 전체·구조·운영 표에는 현재 표시 열을 기준으로 소계·합계 행을 추가한다.
|
||||
- 본단위구간 표는 화면과 동일한 14개 열로 생성한다.
|
||||
- 소계·합계 고정 영역과 이상항목 대·중·소 묶음에 화면 구조에 맞는 셀 병합을 적용했다.
|
||||
- 열 수가 `Z`를 넘는 다단 표도 처리하도록 마지막 열 주소를 동적으로 계산한다.
|
||||
|
||||
### 13.4 수정 파일과 연동 경계
|
||||
|
||||
- `src/features/exmn/model/exmn-detail-table.ts`
|
||||
- `src/features/exmn/model/exmn-sample-data.ts`
|
||||
- `src/features/exmn/ui/ExmnSurveyDetailPopupPage.tsx`
|
||||
- `src/features/exmn/ui/ExmnPplUnitDetailTable.tsx`
|
||||
- 백엔드 코드·API·DTO·DB와 공통 비즈니스 컴포넌트는 변경하지 않았다.
|
||||
- 후속 실제 연동에서는 기존 `PPL_UNIT_V1`, `MNHL_COUNT_V1` JSONB 값을 현재 화면 모델과 코드 기준으로 매핑한다.
|
||||
|
||||
Reference in New Issue
Block a user