통수능/준설관리

This commit is contained in:
2026-08-05 16:05:07 +09:00
parent 0f8b6cd6d0
commit 493acc9ebd
48 changed files with 2698 additions and 2123 deletions
@@ -1,4 +1,131 @@
# SFR-010-012 준설관리 FE 선행 검증결과
# SFR-010-012 준설관리 FE 누적 검증결과
## 0.6 2026-08-05 사진 위치 보정 이전 오류 제거 회귀검증
| 항목 | 결과 | 확인 내용 |
| --- | --- | --- |
| 테스트 사진 EXIF | 통과 | 바탕화면 `KakaoTalk_20260731_133751629.jpg`, 촬영일시 `2026-06-20T15:47:45`, GPS 약 `126.2024635, 36.8887116` 확인 |
| 사진 원위치 API | 통과 | 원본 EXIF 위치는 `PIPE_NOT_FOUND` 응답 확인 |
| 사용자 이동 위치 API | 통과 | `126.2827913451679, 36.87256459006985`는 최근접 관로를 찾고 `PIPE_ASSET_NOT_MAPPED` 응답 확인 |
| 적용 전 상태 표시 | 통과 | 새 지도 위치를 찍으면 사진 원위치의 `50m 이내 관로 없음` 오류를 숨기고 `이 위치로 관로 다시 찾기` 안내 표시 |
| 적용 후 재조회 | 통과 | 버튼 적용 후 편집 상태를 종료하고 실제 새 좌표 응답인 자산 매핑 누락 메시지로 전환 |
| 취소 회귀 | 통과 | 새 임시 좌표를 취소하면 직전 확정 위치와 관로 결과 유지 |
| 상태 메시지 초기화 | 통과 | 위치 편집 시작·좌표 변경·적용 시 이전 저장 오류 문구 제거 |
| 백엔드 대상 테스트 | 통과 | `DredgingServiceTest`, `DredgingNearestPipeRepositoryTest` Gradle 대상 테스트 성공 |
| TypeScript 검사 | 변경 파일 통과/전체 기존 오류 | TypeScript 5.9.3과 `--ignoreDeprecations 5.0` 기준 준설 오류 0건, 준설 외 기존 오류 34건 |
| 전체 Next build | 미수행 | 사용자 소유 3002 개발 서버 보호 기준에 따라 생략 |
이번 문제는 최근접 관로 계산 오류가 아니라 적용 전 임시 위치와 직전 확정 위치의 오류 메시지를 동시에 보여준 프론트 상태 표시 문제였다. 새 위치 적용 후에는 해당 좌표로 서버를 다시 조회하며, 대상 관로의 SN 자산 매핑이 없으면 임의 매핑하지 않고 `PIPE_ASSET_NOT_MAPPED`를 표시한다.
## 0.5 2026-08-04 최근접 관로 표시·자산 매핑 오류 회귀검증
| 항목 | 결과 | 확인 내용 |
| --- | --- | --- |
| 사용자 선택 위치 재현 | 통과 | 수동 위치 `126.2827913451679, 36.87256459006985`를 동일하게 적용해 `PIPE_ASSET_NOT_MAPPED` 응답 재현 |
| MS 최근접 관로 | 통과 | FID `2413388`, 관리기관 `4620000`, 시설관리번호 `4401598401`, 거리 `0.941m`로 관로 자체는 정상 탐색 |
| SN 기준 데이터 대조 | 확인 필요 | `tb_sn_swage_ppl` 대상 관로 0건, `tb_sn_swage_ppl_ast_mtchn` 자산 매핑 0건으로 필수 `ast_id` 확정 불가 |
| 실패 사유 화면 표시 | 통과 | 프론트가 `PIPE_NOT_FOUND`, `PIPE_ASSET_NOT_MAPPED`, `PIPE_ASSET_AMBIGUOUS`를 구분하고 자산 매핑 누락 안내를 인라인 표시 |
| 저장 검증 메시지 | 통과 | 매핑이 없는 그룹 저장 시 일반 `자동 매핑 완료` 문구 대신 해당 그룹의 실제 매핑 실패 사유 사용 |
| 정상 매핑 API 회귀 | 통과 | 좌표 `129.0463665928, 35.4406778683`에서 관로 `2400429`, 거리 `0.000m`, HIGH 응답 유지 |
| 목록·통계 API 회귀 | 통과 | 현재일 `2026-08-04` 기준 목록 및 `MUNICIPALITY`, `DIAMETER`, `ELAPSED_YEAR` HTTP 200, 현재 데이터 0건 |
| 백엔드 대상 테스트 | 통과 | `DredgingServiceTest` 7건, `DredgingNearestPipeRepositoryTest` 1건, 총 8건 성공 |
| TypeScript 검사 | 변경 파일 통과/전체 기존 오류 | TypeScript 5.9.3으로 전체 검사했으며 준설 변경 파일 오류는 0건. 지도관리·조사관리 등 기존 오류 34건은 별도 범위 |
| 전체 Next build | 미수행 | 사용자 소유 3002 개발 서버 보호 기준에 따라 생략 |
파란 선은 현재 지도 범위의 주변 관로이며, 주황색 자동 연결 관로는 최근접 관로에 단일 자산 ID까지 확정된 경우에만 표시한다. 이번 위치는 관로까지 0.941m로 가깝지만 SN 자산 기준 데이터가 없으므로 임의 `ast_id`를 생성하지 않고 등록을 차단하는 것이 DB 설계 계약과 일치한다.
## 0.4 2026-08-04 미완료 보완 및 회귀검증
| 항목 | 결과 | 확인 내용 |
| --- | --- | --- |
| 원본 요구사항 재확인 | 통과 | 화면설계서 51~55쪽 `SN_MN040201~0203`, 요구사항정의서 84~85행 `SFR-010-012/013` 직접 확인 |
| 최근접 관로 실 API | 통과 | EXIF 기준 좌표 `129.0463665928, 35.4406778683`에서 FID `3538280`, 관로 `2400429`, 거리 `0.000m`, HIGH 응답 |
| 관로 WFS 식별자 연계 | 통과 | 같은 FID의 WFS feature ID가 `tb_ms_swage_ppl.3538280`, 시설관리번호가 `2400429`임을 실 GeoServer로 확인하여 자동 연결 관로 강조 조건과 일치 |
| 프록시/서버 오류 표시 | 통과 | JSON이 아닌 500 응답의 `Unexpected token` 원문 대신 `최근접 관로를 조회하지 못했습니다...` 사용자 문구로 변환 |
| 주변 관로 표시 | 통과 | 수동 위치 선택 후 지도 줌 17, `주변 관로 128건` 및 `154건` 표시를 실제 화면에서 확인 |
| 개발 DB 등록 | 통과 | 수동 등록 1건 생성(jobSn `81`), 상세·목록 조회 후 논리 삭제 및 잔여 0건 확인 |
| 멱등 등록 | 통과 | 같은 `clientRequestId` 재호출 시 등록 0건·기등록 1건 반환 |
| 통계 API 회귀 | 통과 | `MUNICIPALITY`, `DIAMETER`, `ELAPSED_YEAR` 모두 응답 1행 확인 |
| 목록 화면 회귀 | 통과 | 지자체별·관경별·경과년도별 제목/컬럼 전환, 최종 목록 0건, 콘솔 error/warn 0건 |
| 백엔드 대상 테스트 | 통과 | `DredgingServiceTest`, `DredgingNearestPipeRepositoryTest` 8건 통과 |
| 정적 검사 | 부분 확인 | 변경 파일 `git diff --check` 통과. 전체 `tsc --noEmit`은 60초 초과로 종료하고 해당 프로세스 트리를 정리 |
| 전체 Next build | 미수행 | 사용자 소유 3002 개발 서버 보호 기준에 따라 생략 |
추가 증적: `COMMON_DOCS_ROOT/작업내용/SFR-010-012-준설관리/검증/014-준설관리-회귀검증-경과년도별.png`
Chrome 확장의 파일 URL 접근 권한이 꺼져 있어 이번 회귀에서 EXIF 사진을 다시 선택해 주황색 관로를 화면 캡처하지는 못했다. 다만 이전 실제 EXIF·최근접 관로·공통 첨부·DB 저장 검증과 이번 WFS feature ID 대조로 데이터 연계 조건을 재확인했다.
## 0.3 2026-08-04 준설 지도 관로 표시 검증
| 항목 | 결과 | 확인 내용 |
| --- | --- | --- |
| 원본 요구사항 재확인 | 통과 | 화면설계서 51~52쪽 `SN_MN040201`, 요구사항정의서 84~85행 `SFR-010-012/013` 직접 확인 |
| 기존 관망도 계약 재사용 | 통과 | `/geoserver/hasudo/ows`의 `hasudo:tb_ms_swage_ppl` WFS가 EPSG:5179 `MultiLineString`을 반환함을 확인 |
| 상세 축척 제한 | 통과 | 줌 13 미만에서는 관로 조회를 시작하지 않고, BBOX·`MAXFEATURES=2000`으로 조회 범위를 제한 |
| 주변 관로 실표시 | 통과 | 수동 위치 선택 후 브라우저 상태 `주변 관로 169건 표시`, 파란 관로 선형 렌더링 확인 |
| 위치 마커 중첩 | 통과 | 파란 관로 선형 위에 선택 위치 마커가 별도 레이어로 표시됨을 확인 |
| 자동 연결 관로 스타일 | 정적 통과 | 최근접 관로 FID와 WFS feature ID를 정규화해 일치 관로에 주황색 굵은 스타일 적용 |
| 자동 연결 관로 실행 | 백엔드 차단 | `선택 위치 적용` 시 현재 `nearestPipes`가 HTTP 500 문자열을 반환해 `Unexpected token 'I', "Internal S"...` 오류로 종료되어 주황색 강조 실행은 확인하지 못함 |
| 전체 TypeScript | 기존 오류로 실패 | 최초 전체 검사에서 변경 파일 형변환 1건을 확인·수정했으며, 나머지는 기존 지도관리·조사관리 오류. 제한 재검사는 로컬 부하로 90초 초과 |
| 전체 Next build | 미수행 | 사용자 소유 3002 개발 서버 보호 기준에 따라 생략 |
증적: `COMMON_DOCS_ROOT/작업내용/SFR-010-012-준설관리/검증/013-준설등록-주변관로-표시.png`
## 0.2 2026-08-04 풀사이즈·통합 지도 UI 검증
| 항목 | 결과 | 확인 내용 |
| --- | --- | --- |
| 원본 요구사항 재확인 | 통과 | 화면설계서 50~55쪽 `SN_MN040201~0203`, 요구사항정의서 84~85행 `SFR-010-012/013` 직접 확인 |
| 호출별 팝업 크기 | 통과 | `openWindowPopup(key, params, { width, height })` 선택 옵션과 준설 호출의 `screen.availWidth/availHeight` 전달 확인 |
| 정보영역 통합 | 통과 | 사진·준설일자·위치·자동 연결 관로가 하나의 등록 카드 안에 렌더링 |
| 지도 레이어 제거 | 통과 | 등록창에 추가 `UiModal` 없이 하단 공통 `Gis` 상시 렌더링 |
| 상단 밀도 축소 | 통과 | 안내·탭·빈 상태·요약 카드 간격 축소, 사진 목록 최대 `180px` |
| 지도 확대 | 통과 | 지정 높이 `540px`, 브라우저 실측 상태바 포함 약 `566px` |
| 버튼 통일 | 통과 | 주요 등록 버튼 높이 25px, primary/secondary/danger 규칙 적용 |
| 위치 편집 전환 | 통과 | `위치등록` 클릭 시 `취소`·비활성 `선택 위치 적용` 표시 및 지도 클릭 안내 전환 |
| 취소 회귀 | 통과 | 취소 후 `위치등록` 복원, 미지정 상태와 기존 위치 유지 문구 확인 |
| 개발 서버 컴파일 | 통과 | 사용자 실행 중인 `localhost:3002`에서 변경 경로가 Build/Runtime Error 없이 렌더링 |
| 전체 TypeScript | 기존 오류로 실패 | 변경 파일 오류는 출력되지 않았고, 지도관리·조사관리 등 기존 범위 오류가 남아 있음 |
| ESLint | 환경 보류 | 설치된 의존성에서 `eslint-plugin-react-hooks`를 해석하지 못함 |
| 전체 Next build | 미수행 | 사용자 소유 3002 개발 서버 보호 기준에 따라 생략 |
증적: `COMMON_DOCS_ROOT/작업내용/SFR-010-012-준설관리/검증/012-준설등록-풀사이즈-통합지도.png`
## 0.1 2026-08-04 백엔드·DB 실연동 검증
| 항목 | 결과 | 확인 내용 |
| --- | --- | --- |
| 실 API 목록 | 통과 | `/oper/dredging` 총 0건 → 등록 후 총 1건 → 정리 후 0건 |
| EXIF 자동 등록 | 통과 | 촬영일 `2026-08-03`, GPS, 관로 `2400429`, 거리 0.00m, HIGH |
| 공통 TUS 업로드 | 통과 | 실제 공통 첨부 코드와 36자 파일 ID를 DB에 저장 |
| 등록 후 재조회 | 통과 | 사진건수 1, 준설일자·등록일자 목록 반영 |
| 관경별 통계 | 통과 | 경상남도 0.043km, 450 이하 0.043km |
| 경과년도별 통계 | 통과 | 경상남도 0.043km, 10년 미만 0.043km |
| 목록 지도보기 | 통과 | 선택 행 위치·관로를 레이어 dialog로 표시 |
| 브라우저 콘솔 | 통과 | error/warn 0건 |
| 최신 Next 개발 컴파일 | 통과 | 목록과 등록 팝업에 Build/Runtime Error 없음 |
| XLSX 다운로드 이벤트 | 미확인 | 클릭 시 콘솔 오류는 없었으나 자동화 이벤트 포착 시간 초과 |
추가 증적: `007`~`011` PNG를 `COMMON_DOCS_ROOT/작업내용/SFR-010-012-준설관리/검증/`에 저장하였다.
## 0. 2026-07-31 조사관리 UI 정렬 변경 검증
| 항목 | 결과 | 근거 |
| --- | --- | --- |
| 원본 요구사항 선확인 | 통과 | 화면설계서 50~55쪽 `SN_MN040201~0203`, 요구사항정의서 84~85행 `SFR-010-012/013` 확인 |
| 조사관리 검색영역 규칙 반영 | 정적 통과 | 단일 가로 검색행, 동일 라벨·입력 높이·우측 파란 버튼군 적용 |
| 중복 화면 제목 제거 | 정적 통과 | 화면 내부 `하수관로 준설` 제목 제거 |
| 등록 WindowPopup 전환 | 정적 통과 | `dredgingRegister` 정의·레지스트리·팝업 페이지·완료 메시지 연결 |
| 등록창 지도 레이어 분리 | 정적 통과 | 등록 WindowPopup의 상시 지도 제거, `지도보기` 조회 레이어와 `위치등록/수정` 선택 레이어 분리 |
| 위치 적용 상태 분리 | 정적 통과 | 지도 클릭 위치는 임시 상태로 유지하고 `선택 위치 적용` 이후에만 최근접 관로 조회 |
| 변경 파일 제한 타입 검사 | 통과 | 변경 대상 파일 오류 0건 |
| 전체 TypeScript 검사 | 기존 오류로 실패 | 변경 대상 오류 0건, 그 외 기존 오류 34건 |
| ESLint | 환경 보류 | 설치된 의존성에서 `eslint-plugin-react-hooks`를 해석하지 못해 실행 불가 |
| 팝업 경로 응답 | 통과 | `/popup/dredgingRegister?sourcePath=%2Foper%2Fdredging` HTTP 200, 빌드 오류 문자열 없음 |
| 최신 브라우저 화면·팝업 재검증 | 차단 | Codex 인앱 브라우저가 `localhost:3002` 접근을 URL 보안 정책으로 거부 |
| 전체 Next build | 미수행 | 포트 3002 개발 서버 실행 중 보호 기준에 따라 생략 |
최신 UI 변경은 코드, 타입 검사와 실행 중인 개발 서버의 경로 응답으로 확인했으나 지도 레이어의 실제 크기·포커스·지도 클릭·취소·적용 흐름은 브라우저 재검증이 필요하다. 기존 2026-07-30 기능 흐름 검증 결과는 아래에 보존한다.
## 1. 검증 환경
@@ -45,6 +172,11 @@
## 5. 후속 검증
- 조사관리와 준설관리의 검색영역 높이·입력 정렬·버튼 위치를 같은 해상도에서 비교한다.
- 등록 버튼 클릭 시 별도 WindowPopup이 열리고 부모 화면에는 모달 오버레이가 생기지 않는지 확인한다.
- 등록 WindowPopup 하단 지도가 상시 표시되고 `위치등록/수정` 중에만 클릭 편집되는지 확인한다.
- 본문 지도 편집 취소 시 기존 위치가 유지되고 적용 시에만 최근접 관로가 갱신되는지 확인한다.
- 팝업 저장 완료 메시지 후 부모 목록 건수와 신규 행이 갱신되는지 확인한다.
- 백엔드 구현 후 공통 첨부 TUS 응답과 준설 등록 트랜잭션을 실제로 확인한다.
- 실제 MS 관로 geometry로 거리·스냅 좌표·동률 처리·탐색 반경을 검증한다.
- 서버 원본 EXIF 재분석 결과와 브라우저 분석 결과 불일치 케이스를 검증한다.
@@ -61,3 +61,122 @@
- 실제 파일 선택, 업로드 버튼 클릭, 행 선택 상호작용은 브라우저 수동 확인이 한 번 더 필요하다.
- 저장소 기존 타입 오류 때문에 이번 기능만 분리한 정적 통과 여부를 보장하기 어렵다.
- 시설구분 목록은 아직 실제 시설물 레이어 조회 결과와 자동 동기화되지 않는다.
## 5. 2026-07-31 가평군 GPKG 다운로드 오류 회귀 검증
### 5.1 요구사항 추적
- 요구사항정의서: `SFR-012-002 하수관로자료 업로드/다운로드`
- 화면설계서: 슬라이드 33, 화면 ID `SN_MN010302`
- 검증 범위: 관리기관 `가평군(4160000)` 최신 다운로드 및 이력 선택 다운로드
### 5.2 오류 원인
- Chrome 콘솔에서 최신 다운로드 요청이 간헐적으로 `TypeError: Failed to fetch`로 종료된 기록을 확인했다.
- 동일한 관리기관 요청을 다시 실행하면 정상 GPKG가 생성됐고 파일 내부 데이터도 정상이었다.
- 따라서 가평군 데이터 생성 실패가 아니라 브라우저와 Next 프록시 사이의 일시적 전송 단절을 재시도 없이 사용자 오류로 처리한 것이 직접 원인이었다.
### 5.3 수정 내용
- 현재 및 이력 다운로드의 멱등 GET 요청에 한해 네트워크 단절 시 500ms 후 1회 재시도한다.
- HTTP 4xx/5xx와 업무 검증 오류는 재시도하지 않고 기존 오류 처리로 전달한다.
- Chrome이 다운로드 클릭을 인계할 시간을 확보하도록 Blob object URL을 1초 뒤 해제한다.
### 5.4 실제 브라우저 검증 결과
- 관리기관 선택: `가평군`
- 업로드 이력 조회: 9건 표출
- 최신 다운로드: 성공 메시지 및 파일 생성 확인
- 첫 번째 업로드 이력 선택 다운로드: 성공 메시지 및 파일 생성 확인
- 검증 종료 시 Chrome `error`, `warn` 로그: 0건
### 5.5 생성 GPKG 검증 결과
- 파일명: `하수관로_가평군_20260731 (1).gpkg`, `하수관로_가평군_20260731 (2).gpkg`
- 파일 크기: 각 11,169,792 bytes
- SQLite `PRAGMA integrity_check`: `ok`
- 레이어: `tb_ms_swage_ppl`
- 피처 수: 16,670건
- 좌표계: EPSG:5179
- FID: `fid INTEGER PRIMARY KEY`, `fid_1` 없음
- 공간 인덱스: `rtree_tb_ms_swage_ppl_geom` 존재
### 5.6 정적 검증 참고
- `git diff --check`: 통과
- 실행 중인 Next 개발 서버에서 수정 화면 컴파일 및 실제 브라우저 동작: 통과
- Prettier: 저장소에 실행 파일이 없어 미수행
- TypeScript 단독 검사: 기존 `tsconfig.json`의 `ignoreDeprecations` 값과 로컬 실행 설정 오류로 시작되지 못함
## 6. 2026-08-04 업로드 오류 수정 및 전체 회귀 검증
### 6.1 요구사항 추적
- 요구사항정의서: `SFR-012-002 하수관로자료 업로드/다운로드`, `SFR-012-003 하수관로 편집`
- 화면설계서: 화면 ID `SN_MN010302`(GIS 관리), `SN_MN010301`(GIS 편집)
- 검증 시나리오: `최신 다운로드 → GeoPackage 신규·수정·삭제 → 브라우저 업로드 → 이력·미리보기·오류·재다운로드 확인`
### 6.2 재현 및 원인
- 동일한 11,169,792 byte GeoPackage를 백엔드에 직접 업로드하면 약 9.6초에 `HTTP 200`으로 완료됐다.
- 기존 `/sewerage-service/**` middleware rewrite 경로에서는 multipart 본문 전달이 60초 이상 지연됐고, 재현 요청 1건은 120.576초 후 `HTTP 500 / E999 / ERROR`로 종료됐다.
- 실패 요청은 업로드 이력과 GIS 데이터가 모두 롤백됐다.
- 원인은 대용량 multipart 본문이 일반 middleware rewrite의 요청 복제·프록시 경로를 통과한 데 있었다.
### 6.3 수정 내용
- `app/api/gis-upload/route.ts`에 Node runtime 기반 GIS 업로드 전용 스트리밍 프록시를 추가했다.
- multipart 본문을 메모리에 다시 적재하지 않고 `ReadableStream`으로 백엔드에 전달한다.
- middleware와 동일하게 로그인 쿠키 값을 인증 헤더로 전달하고, hop-by-hop 헤더와 `content-length`, `Expect`는 제거한다.
- `postMutiPart`가 `/`로 시작하는 앱 내부 경로를 `resolveApiUrl`로 처리하게 하고 GIS 관리 popup만 `/api/gis-upload`를 사용하도록 전환했다.
- 백엔드 연결 실패 시 `GIS_UPLOAD_PROXY_FAILED`와 사용자용 502 메시지를 반환한다.
### 6.4 전용 경로 검증
- 기존 middleware 경로 재현: `HTTP 500`, 120.576초, `E999 / ERROR`
- 전용 스트리밍 경로 무변경 파일: `HTTP 200`, 15.591초, 변경 0건
- 실행 중인 Next 개발 서버의 HMR 상태에서 실제 브라우저 업로드: 성공
### 6.5 신규·수정·삭제 회귀 결과
- 관리기관: `가평군(4160000)`
- 기준 피처 수: 16,670건
- 삭제: `fid=1891743`, 최종본에서 미존재 확인
- 수정: `fid=1891744`, `fclt_mng_no=QA_BROWSER_UPDATE_20260804` 확인
- 신규: `fid=4132722`, 최종본 1건 존재 확인
- 업로드 ID: `GUP-20260804165133-057BE473`
- 업로드 상태: `COMPLETED`
- 신규/수정/삭제/변경/오류: `1 / 1 / 1 / 3 / 0`
- 미리보기: 변경 관로 표출, `삭제 미표시 1건` 확인
- 오류 확인: `표시할 오류가 없습니다.` 확인
- 선택 이력 다운로드: 성공 메시지와 `HTTP 200` 확인
- 현재본/선택 이력본: 각각 16,670건, SQLite `integrity_check=ok`, 대상 FID 반영 일치
### 6.6 회귀 테스트 데이터 복원
- 회귀 검증 완료 후 테스트 직전 기준본을 동일한 전용 스트리밍 경로로 다시 업로드했다.
- 복원 업로드 ID: `GUP-20260804170432-06A6347B`, 상태 `COMPLETED`, 신규/수정/삭제/오류 `1 / 1 / 1 / 0`
- 복원 후 현재본은 16,670건, 스키마 일치, SQLite `integrity_check=ok`이며 자동 생성 FID를 제외한 업무 데이터 전체가 기준본과 일치한다.
- 테스트 신규 `fid=4132722`는 제거됐고 `fid=1891744` 수정값은 정확히 복원됐다.
- 삭제 후 재생성된 원본 업무 피처는 DB 자동 채번 정책에 따라 `fid=1891743` 대신 `fid=4132723`으로 복원됐다. 업무 속성·도형은 기준본과 동일하다.
### 6.7 정적 검증 및 제한
- 신규 route 파일 Prettier 검사: 통과
- 브라우저 console error: 0건
- 미리보기에서 오류 화면으로 전환할 때 숨겨진 OpenLayers 컨테이너 크기 0 경고 1건이 있으나 기능 실패는 없었다.
- ESLint는 기존 `eslint.config.mjs:15` 설정 예외로 실행되지 않았다.
- 기본 TypeScript 검사는 기존 `tsconfig.json`의 `ignoreDeprecations=6.0` 값 때문에 시작되지 않았고, `--ignoreDeprecations 5.0`으로 재실행하면 기존 파일 오류가 남았다. 이번 수정 파일에서 신규 타입 오류는 출력되지 않았다.
- 사용자가 실행한 Next 개발 서버를 보호하기 위해 `next build`는 수행하지 않았다.
### 6.8 증빙
- 공통 증빙 폴더: `COMMON_DOCS_ROOT/작업내용/SFR-012-002-하수관망도 업로드/검증/20260804/`
- 완료 화면: `17-regression-upload-completed.png`
- 미리보기: `19-regression-preview.png`
- 오류 0건: `20-regression-no-validation-errors.png`
- API 이력: `18-regression-history.json`
- 데이터 대조: `23-regression-data-verification.txt`
- 복원 응답: `28-regression-rollback-completed.json`
- 복원 후 현재본·이력: `29-current-after-rollback.gpkg`, `30-history-after-rollback.json`
- 복원 데이터 대조: `32-regression-rollback-semantic-verification.txt`
@@ -8,7 +8,7 @@
- 작성일: 2026-05-18
- 담당 역할: FE
- 관련 역할: DE, BE, QA
- 담당 범위: `apps/sn` 지도 화면에서 통수위험 진입, 결과 조회 popup, 지도보기, 설정 현황, staged 유출관로 선택, 저장 payload 준비까지
- 담당 범위: `apps/sn` 지도 화면에서 통수위험 진입과 현재 위험/과거 이력 결과 조회 popup UI까지
- 근거 문서
- `COMMON_DOCS_ROOT/작업계획/SFR-011-007-통수위험분석/001-de-SFR-011-007-통수위험분석-설계.md`
- `COMMON_DOCS_ROOT/작업내용/SFR-011-007-통수위험분석/001-fe-SFR-011-007-통수위험분석-통합공유기록.md`
@@ -27,9 +27,9 @@
## 2. 작업 목적
- 기존 하수관망도 지도 화면에 `통수위험` 기능을 추가해 사용자가 결과 조회, 지도보기, 설정 현황 조회, 유출관로 설정 편집을 한 흐름 안에서 수행할 수 있게 한다.
- 프론트는 백엔드 연결 전 단계에서 popup UI, 동적 관로 컬럼, mock 지도 강조, staged 설정 목록, 저장 payload preview까지 먼저 구현한다.
- 실제 산정 로직, geometry 데이터, 다운로드 파일, 저장 API는 BE 범위로 분리하고 FE는 그 계약을 맞출 준비 상태까지 수행한다.
- 기존 하수관망도 지도 화면에 `통수위험` 기능을 추가해 사용자가 현재 위험과 과거 이력 결과를 한 popup에서 조회할 수 있게 한다.
- 프론트는 백엔드 연결 전 단계에서 결과 조회 popup UI와 mock 결과 데이터를 먼저 구현한다.
- 실제 통수량 산정 로직과 조회 API는 후속 BE/FE 공동 범위로 분리한다.
## 2-1. 최근 진행 갱신
@@ -173,3 +173,38 @@
- staged 설정 목록과 저장 payload preview가 준비된다.
- FE-only 프로토타입 기준 구현이 완료되고, BE 연동 및 실제 통합 검증 후속 범위가 문서로 정리된다.
- 지도 상세정보 카드 위치 규칙은 현재 프로토타입 기준 동작으로 마감하고, 운영 기준 확정은 후속 검증으로 넘긴다.
## 13. 2026-07-31 UI 범위 정정
이 절은 사용자 최신 지시에 따라 위의 과거 설정 기능 관련 기술을 대체한다.
### 원본 추적 근거
- 화면설계서: `REQUIREMENTS_ROOT/화면설계서.pptx` 19쪽
- 화면 ID: `SN_MN010201`
- 요구사항 ID: `SFR-011-007`
- 화면명: `통수위험분석결과 조회`
- 요구사항정의서: `REQUIREMENTS_ROOT/요구사항정의서.xlsx`
- 시트: `3. (기능)요구사항정의 및 추적표`
- 행: 93
- 요구사항 ID/명: `SFR-011-007` / `통수량 산정`
### 최신 결정
- 화면설계서 19쪽에는 `설정` 버튼이 있으나, 사용자 명시 지시에 따라 설정 버튼·설정 화면·설정 편집 흐름을 결과 popup에서 제거한다.
- popup은 `현재 위험`과 `과거 이력` 결과 조회만 제공한다.
- 검색조건은 다른 지도 popup과 같은 회색 검색 패널, 동일한 라벨/필드 정렬, 단일 `조회` 주 버튼 구조로 통일한다.
- 부모 지도 검색 컨트롤과 popup 검색 컨트롤은 모두 `Noto Sans KR`, `12.5px`, 높이 `35px`를 사용한다.
- 실제 API와 산정 기능은 이번 범위에 포함하지 않고 후속 BE/FE 공동 구현으로 남긴다.
### 검증 결과
- `http://localhost:3002/popup/flowRiskPopup`
- 설정 버튼 부재, 현재 위험/과거 이력 탭 전환, 위험상태 조회 20건 → 10건 필터링을 브라우저에서 확인했다.
- 부모 지도 `.selectbox_trigger`와 popup 날짜·선택·조회 컨트롤의 계산 스타일이 모두 `Noto Sans KR`, `12.5px`, `35px`로 일치함을 확인했다.
- 로컬 인증 API가 응답하지 않아 개발 검증용 인증 우회를 일시 적용했으며, 검증 직후 원상복구했다.
### 후속 확인 필요
- 요구사항정의서 93행은 합리식 `Q=CIA`와 Manning 공식을 요구하지만, 화면설계서 20쪽은 SWMM5 연계를 제시한다. 실제 산정 기능 설계 전에 적용 기준을 확정해야 한다.
- 2026-08-04 실제 API 연동 시 `map/page.tsx`, 세션 타입, popup 메시지 타입에 남아 있던 설정 편집·staged 관로 호환 코드도 제거해 결과 조회와 지도보기 계약만 유지했다. 상세 구현·검증은 `002-fe-SFR-011-007-통수위험분석-실API연동및검증.md`를 따른다.
@@ -0,0 +1,43 @@
# SFR-011-007 통수위험분석 FE 실 API 연동 및 검증
## 1. 목적
- 기존 FE mock 결과를 `/api/v1/waterRisk/**` 실제 응답으로 교체한다.
- 부모 지도와 popup의 기존 `sn` 글꼴·조회조건 디자인을 유지한다.
- 사용자 결정에 따라 설정 버튼·설정 화면·설정 API는 제공하지 않는다.
## 2. 구현 내용
- `WaterRiskPopupPage.tsx`
- 현재 위험/과거 이력 탭, 날짜·시도·시군구·중점관리지역·위험상태 조회
- 서버 페이지네이션, 로딩·오류·빈 결과 처리
- 현재누적강우량 원천이 없으면 `-` 표기
- 현재 탭은 예측강우량, 과거 탭은 최대강우강도 컬럼 사용
- 결과 행 선택 시 mapView 조회 후 부모창에 결과와 geometry 전달
- `waterRiskClient.ts`
- 중점관리지역, 결과 목록, mapView 실제 API 호출
- `waterRiskTypes.ts`
- 실제 API 계약, nullable 강우 필드, `RATIONAL_MANNING`, 관로별 위험상태 정의
- `map/page.tsx`
- EPSG:5179 MultiPolygon/MultiLineString 강조
- 선택 지역 fit/정보 카드 표시
- 유출유량·통수량 단위를 `㎥/s`로 통일
## 3. 검증 결과
- URL: `http://localhost:3002/popup/flowRiskPopup`
- 실제 API로 위험/정상 행, 현재/과거 탭, 위험상태 필터, 시도→시군구→중점관리지역 cascade 확인
- 결과 행 클릭 후 mapView 요청 성공과 부모 지도 강조 메시지 확인
- popup 콘솔 오류 없음
- 화면 증적: `COMMON_DOCS_ROOT/작업내용/SFR-011-007-통수위험분석/검증/001-통수위험-현재위험-실API.png`
- 앱 TypeScript 전체 검사는 통수위험 변경 파일 오류가 없었으나, 기존 타 기능의 타입 오류 때문에 전체 명령은 실패했다.
- 실행: `apps/sn/node_modules/.bin/tsc.CMD -p apps/sn/tsconfig.json --noEmit --pretty false --incremental false --ignoreDeprecations 5.0`
- 잔여 오류: `fldngHstry`, GIS 관리, `exmn`, 메뉴 alias, `map/page.tsx`의 기존 `storageNm` 등 이번 범위 밖 baseline
- 사용자 소유 Next 개발 서버는 중단하거나 빌드하지 않았다.
## 4. 영향·롤백·잔여 위험
- 영향: `components/waterRisk/**`, 부모 지도에서 통수위험 결과 메시지와 geometry 표시 부분
- 롤백: `waterRiskClient.ts`를 제거하고 popup의 실제 조회/부모 메시지 변경 및 `map/page.tsx` 통수위험 mapView 처리를 되돌린다.
- 자동화 도구가 새 창 popup을 부모 탭과 동시에 제어하는 데 제한이 있어, popup의 실제 mapView 요청과 부모 메시지 처리 코드를 각각 확인했다. 최종 사용자 회귀 시 부모 지도에서 popup을 열고 한 행을 선택하는 시나리오를 한 번 더 수행할 수 있다.
- 현재누적강우량은 백엔드 원천 미확보로 `-`이며, 예측강우 격자 overlay는 이번 합리식 결과 범위에 포함하지 않는다.
@@ -1,21 +1,90 @@
# SFR-010-012 준설관리 프론트엔드 구현기록
## 0.6 2026-08-05 사진 위치 보정 시 이전 관로 오류 제거
- 사진 EXIF 원위치에서 발생한 `PIPE_NOT_FOUND` 결과가 지도에서 새 위치를 선택한 뒤에도 남아 새 좌표의 조회 결과처럼 보이던 상태 표시 오류를 수정하였다.
- 확정 위치와 다른 지도 임시 좌표를 `hasUnappliedLocationDraft`로 구분하고, 적용 전에는 이전 관로·오류를 숨긴 뒤 `이 위치로 관로 다시 찾기` 안내만 표시한다.
- 위치 편집 시작, 지도 좌표 변경, 선택 위치 적용 시 이전 저장 상태 메시지를 비워 서로 다른 좌표의 결과가 섞이지 않게 하였다.
- 위치 확정과 최근접 관로 API 호출은 기존과 같이 사용자가 `이 위치로 관로 다시 찾기`를 눌렀을 때만 수행하며, 취소 시 기존 확정 위치와 매핑 결과를 유지한다.
- 테스트 사진 `KakaoTalk_20260731_133751629.jpg`의 EXIF 원위치는 `PIPE_NOT_FOUND`, 사용자가 이동한 위치는 `PIPE_ASSET_NOT_MAPPED`로 응답해 새 좌표가 실제 API에 전달됨을 확인하였다.
## 0.5 2026-08-04 자동 매핑 실패 사유 표시 보완
- 최근접 관로 API가 `selected: null`과 함께 반환하는 `failureCode`, `failureMessage`를 버리지 않고 화면 오류로 전달한다.
- `PIPE_NOT_FOUND`는 위치 재확인, `PIPE_ASSET_NOT_MAPPED`와 `PIPE_ASSET_AMBIGUOUS`는 관로 자산 매핑 데이터 확인이 필요하다는 안내로 구분한다.
- 저장 시 `최근접 관로 자동 매핑을 완료해주세요`만 반복하지 않고, 이미 확인된 그룹별 실제 실패 사유를 경고창에 표시한다.
- 사용자 선택 위치의 관로 FID `2413388`은 0.941m 거리로 탐색됐지만 SN 관로 원장과 자산 매핑이 모두 0건임을 개발 DB에서 확인했다. 필수 `ast_id`를 임의 생성하지 않고 등록을 차단한다.
## 0.4 2026-08-04 미완료 보완
- 최근접 관로 API 또는 프록시가 JSON이 아닌 오류 본문을 반환해도 공통 JSON 파서의 `Unexpected token` 문구를 화면에 노출하지 않고 준설관리용 재시도 안내로 변환한다.
- 개발 DB의 최근접 관로 FID `3538280`과 GeoServer WFS feature ID `tb_ms_swage_ppl.3538280`을 대조해 자동 연결 관로 주황색 강조의 식별자 정규화 계약을 확인했다.
- 실제 API로 수동 등록·멱등 재등록·상세·목록·3개 통계·삭제를 순차 회귀검증하고 생성한 jobSn `81`을 정리했다.
- 실제 화면에서 주변 관로 최대 154건 표시와 지자체별·관경별·경과년도별 화면 전환을 재검증했다.
## 0.3 2026-08-04 준설 지도 관로 선형 표시
- 준설 등록 하단 지도에 기존 관망도와 같은 GeoServer `tb_ms_swage_ppl` WFS 관로 선형을 추가했다.
- 현재 지도 범위의 관로만 BBOX로 조회하며, 대량 전국 조회를 막기 위해 줌 13 이상에서 최대 2,000건만 불러온다.
- 일반 주변 관로는 파란색, `POST /api/v1/dredging/nearestPipes`로 자동 연결된 관로는 FID를 대조해 주황색·굵은 선으로 강조한다.
- 위치 마커는 관로보다 높은 레이어에 유지해 준설 위치와 관로 관계를 동시에 확인할 수 있다.
- 로딩 중·오류·표시 건수를 지도 안내 영역에 표시한다.
- 공통 `Gis`와 공통 지도 패키지는 수정하지 않고 준설 전용 `DredgingLocationMap`이 추가한 WFS/마커 레이어와 이벤트만 정리한다.
- 브라우저 수동 위치 선택에서 실제 `MultiLineString` 관로 169건 표시를 확인했다.
## 0.2 2026-08-04 풀사이즈 등록 팝업·본문 통합 지도
- `openWindowPopup()`에 호출별 `width`, `height` 선택 옵션을 추가했다. URL 쿼리가 아니라 `window.open` feature로 반영한다.
- 준설 등록 호출은 `window.screen.availWidth`, `window.screen.availHeight`를 전달하고 공통 안전 여백 안에서 최대 크기로 연다.
- 사진·준설일자와 위치·자동 연결 관로를 하나의 등록 카드로 합쳤다.
- 등록창 위 지도 레이어를 제거하고 공통 `Gis` 지도를 본문 하단에 상시 표시한다.
- 평상시 지도는 조회 전용이고 `위치등록/위치 수정` 중에만 클릭 선택을 활성화한다. `취소`는 임시 위치를 버리고 `선택 위치 적용`만 최근접 관로 조회를 실행한다.
- 상단 안내·탭·사진 빈 상태·요약 카드의 패딩과 간격을 축소하고 사진 목록 최대 높이를 `180px`로 제한했다.
- 지도 높이는 `420px`에서 `540px`로 확대했다.
- 저장·관로추가·등록방식·위치·취소·삭제 버튼은 동일한 `sm` 높이와 primary/secondary/danger 규칙으로 통일했다.
## 0. 2026-08-04 실제 연동 보완
- 목록 초기값을 로컬 모의 데이터가 아닌 `GET /api/v1/dredging/records` 응답으로 전환하였다.
- 등록 완료 메시지 수신 후 부모 목록을 서버에서 다시 조회하도록 변경하였다.
- `NEXT_PUBLIC_DREDGING_BACKEND_ENABLED`는 명시적으로 `false`인 경우만 선행 모드로 동작한다.
- 실제 EXIF 사진으로 공통 TUS 업로드, 최근접 관로, 준설 등록, DB 목록 반영을 확인하였다.
- 공통 첨부는 실제 36자 ID를 발급하므로 백엔드/DB V80 호환 보정과 함께 검증하였다.
- DB 저장 실패 재시도 시 이미 성공한 사진 업로드 참조를 `photo.key`별로 재사용하여 같은 파일을 다시 업로드하지 않도록 보완하였다.
- 지자체 목록, 관경별·경과년도별 집계, 목록 지도보기 레이어를 실제 API 데이터로 확인하였다.
## 1. 구현 결과
- 신규 직접 진입 경로: `/oper/dredging`
- 기본 모드: `NEXT_PUBLIC_DREDGING_BACKEND_ENABLED`가 `true`가 아니면 FE 선행 모의 모드
- 기존 지도 메인, 공통 API 모듈, 공통 컴포넌트는 수정하지 않았다.
- 등록 진입: 공통 WindowPopup 키 `dredgingRegister`
- 기본 모드: 실제 백엔드 연동이며, `NEXT_PUBLIC_DREDGING_BACKEND_ENABLED=false`를 명시한 경우만 FE 선행 모의 모드
- 조사관리 화면의 검색영역 밀도, 입력 높이, 라벨 크기, 우측 버튼군을 준설관리에도 동일하게 적용했다.
- 화면 안의 중복 제목 `하수관로 준설`을 제거하고 공통 페이지 제목 `준설관리`만 사용한다.
- 기존 지도 메인, 공통 API 모듈과 타 앱은 수정하지 않았다.
### 1.1 원본 요구사항 근거
- `COMMON_DOCS_ROOT/기준문서/화면설계서.pptx` 슬라이드 50~55
- `SN_MN040201`: 준설 결과 업로드·위치 등록
- `SN_MN040202`: 지자체별 준설 현황
- `SN_MN040203`: 관경별·경과년도별 준설 현황
- `COMMON_DOCS_ROOT/기준문서/요구사항정의서.xlsx`
- 시트 `3. (기능)요구사항정의 및 추적표` 84행 `SFR-010-012`
- 같은 시트 85행 `SFR-010-013`
- 준설결과 등록 본체는 다른 업무화면과 동일한 WindowPopup으로 구성하고, 사용자의 최신 지시에 따라 풀사이즈 팝업 하단에 지도를 통합했다.
## 2. 구현 파일
| 파일 | 책임 |
| --- | --- |
| `page.tsx` | 지자체별·관경별·경과년도별 조회, 검색, 엑셀 다운로드, 등록/지도보기 진입 |
| `_components/DredgingRegisterModal.tsx` | 관로 그룹, 사진/수동 등록, 검증, 첨부 업로드 및 저장 순서 |
| `_components/DredgingLocationMap.tsx` | 공통 `Gis`에 로컬 위치 마커와 지도 클릭 interaction 연결 |
| `_components/DredgingRegisterModal.tsx` | 관로 그룹, 사진/수동 등록, 검증, 첨부 업로드 및 저장 순서와 팝업 표시 모드 |
| `_components/DredgingRegisterPopupPage.tsx` | 등록 완료 메시지 전송과 팝업 창 닫기 |
| `_components/DredgingLocationMap.tsx` | 공통 `Gis`에 주변 관로 WFS, 자동 연결 관로 강조, 위치 마커와 지도 클릭 interaction 연결 |
| `_lib/exif.ts` | JPEG APP1/TIFF EXIF 촬영일·GPS 분석 |
| `_lib/client.ts` | 최근접 관로, 공통 TUS 첨부 업로드, 준설 등록 API 어댑터와 FE 모의 응답 |
| `_lib/client.ts` | 최근접 관로, 공통 TUS 첨부 업로드, 준설 등록 API 어댑터, API 오류 정규화와 FE 모의 응답 |
| `_lib/types.ts` | 화면 draft, 사진 메타정보, 관로 매핑, 저장 payload 타입 |
| `src/features/windowPopup/**` | `dredgingRegister` 정의·레지스트리·완료 메시지 계약 |
## 3. 주요 처리
@@ -31,11 +100,13 @@
### 3.2 수동 등록
1. `지도 수동 등록`을 선택한다.
1. `사진 없이 직접 등록`을 선택한다.
2. 준설일자를 입력한다.
3. 공통 지도 클릭 또는 `위도, 경도` 입력으로 위치를 지정한다.
4. 좌표 변경 즉시 최근접 관로와 거리·신뢰도를 갱신한다.
5. 관로 매핑이 완료된 건만 저장 payload로 만든다.
3. 등록창 하단의 `위치등록`을 눌러 같은 화면의 지도를 편집 상태로 전환한다.
4. 사용자는 좌표값을 직접 입력하지 않고 지도에서 위치를 클릭한다.
5. `선택 위치 적용`을 눌렀을 때만 선택 위치를 확정하고 최근접 관로와 거리·신뢰도를 갱신한다.
6. 편집을 취소하면 적용하지 않은 위치는 폐기하고 기존 위치를 유지한다.
7. 관로 매핑이 완료된 건만 저장 payload로 만든다.
### 3.3 FE 선행 모드
@@ -44,6 +115,31 @@
- 사용자 화면에는 개발단계, 선행 구현, 모의 매핑 안내 문구를 노출하지 않는다.
- 등록 결과는 현재 탭의 목록 상태에만 반영한다.
### 3.4 조사관리 UI 정렬 및 WindowPopup
1. 검색조건을 조사관리와 같은 단일 가로 flex 행으로 배치한다.
2. 라벨은 `text-xl`, 입력 높이는 `3.2rem`, 선택상자는 흰색 `rounded-lg` 규칙을 사용한다.
3. 조회·다운로드·등록·지도보기 버튼을 조사관리와 같은 파란색 액션 버튼으로 통일하고 장식 아이콘을 제거한다.
4. 등록 버튼은 `/popup/dredgingRegister` 창에 화면 가용 크기를 호출 옵션으로 전달해 풀사이즈에 가깝게 연다.
5. 저장 성공 시 팝업이 같은 출처의 `sn:popup:dredgingRegistered` 메시지를 부모 화면에 전달한다.
6. 부모 화면은 메시지의 등록 그룹을 기존 목록 상태에 반영하고 첫 페이지로 이동한다.
### 3.5 본문 통합 지도
1. 준설결과 등록 WindowPopup의 사진·준설정보와 위치·관로 확인을 하나의 카드로 구성한다.
2. 공통 `Gis` 지도는 위치·관로 요약 바로 아래에 상시 표시한다.
3. 확정 위치가 있으면 `위치 수정`, 위치가 없으면 `위치등록`을 제공한다.
4. 위치 편집 중 지도 클릭 위치는 임시 상태로 유지하고 `선택 위치 적용` 이후에만 등록 데이터와 최근접 관로 조회에 반영한다.
5. 목록 화면의 `지도보기`는 기존 `UiModal` 레이어 팝업 방식을 유지한다.
### 3.6 관로 선형 표시
1. 위치가 없을 때는 전국 관로를 조회하지 않고 위치 등록 안내만 표시한다.
2. 위치가 등록되거나 지도에서 임시 위치를 선택해 줌 17로 이동하면 현재 화면 BBOX의 `tb_ms_swage_ppl` WFS를 조회한다.
3. WFS의 `LineString/MultiLineString`은 파란색 관로 선형으로 표시한다.
4. 최근접 관로 응답의 숫자 FID와 WFS feature ID(`tb_ms_swage_ppl.{fid}`)를 정규화해 같은 관로를 주황색으로 강조한다.
5. 위치 마커는 관로 위에 표시하고, 관로 layer는 클릭 대상에서 제외해 위치 선택 흐름을 방해하지 않게 한다.
## 4. 연동 전환
- 환경변수: `NEXT_PUBLIC_DREDGING_BACKEND_ENABLED=true`
@@ -55,5 +151,8 @@
## 5. 롤백
- `apps/sn/app/(with-base-layout)/oper/dredging/**`를 제거한다.
- `page.tsx`의 호출별 가용 화면 크기 옵션을 제거하면 팝업 정의의 기본 크기로 되돌릴 수 있다.
- `DredgingRegisterModal.tsx`의 본문 하단 `DredgingLocationMap`을 제거하면 통합 지도 구성을 롤백할 수 있다.
- `DredgingRegisterModal.tsx`의 `presentation="popup"` 분기와 `DredgingRegisterPopupPage.tsx`를 제거한다.
- `src/features/windowPopup`의 `dredgingRegister` 정의·레지스트리·메시지 타입을 제거한다.
- 신규 전용 경로이므로 기존 지도·운영정보 화면의 코드 롤백은 필요하지 않다.
@@ -114,3 +114,34 @@
- 실제 upload history 스키마가 설계 초안과 달라질 수 있다.
- 현재 업로드/다운로드는 요청 미리보기와 mock 목록 갱신만 수행하므로, 실제 파일 바이너리 흐름은 백엔드 구현 후 재검증이 필요하다.
- 시설구분 목록은 현재 `UPLOAD_FACILITY_TYPES` mock 상수에 고정돼 있어 실제 좌측 `시설물 레이어`와 다를 수 있다.
## 7. 2026-07-31 가평군 다운로드 안정화
### 7.1 작업 배경
- 실제 FE-BE 연동이 완료된 GIS 관리 화면에서 가평군 최신 GPKG 다운로드가 간헐적으로 실패했다.
- Chrome 콘솔의 실패 기록은 HTTP 업무 오류가 아닌 `TypeError: Failed to fetch`였다.
- 같은 요청의 다음 실행은 정상 파일을 반환해 대용량 응답 전송 구간의 일시적 연결 단절로 판단했다.
### 7.2 구현 내용
- `GisManagementPopupPage.tsx`에 GIS 다운로드 전용 호출 함수를 추가했다.
- 네트워크 단절로 식별되는 `TypeError`만 500ms 후 한 번 재시도한다.
- 현재 다운로드와 업로드 이력 선택 다운로드가 같은 안정화 로직을 사용한다.
- HTTP 오류와 서버 업무 오류는 재시도 대상에서 제외한다.
- Blob object URL은 다운로드 클릭 직후가 아닌 1초 뒤 해제한다.
### 7.3 영향 범위
- 변경 파일: `apps/sn/app/(map-layout)/map/components/gisManagement/GisManagementPopupPage.tsx`
- 변경 API 계약: 없음
- 백엔드 및 DB 변경: 없음
- 다른 다운로드 화면과 공통 API 유틸리티 영향: 없음
### 7.4 검증 요약
- 가평군 최신 GPKG 다운로드 성공
- 가평군 업로드 이력 선택 다운로드 성공
- 두 파일 모두 16,670건, EPSG:5179, SQLite 무결성 `ok`
- `fid INTEGER PRIMARY KEY` 단일 컬럼과 공간 인덱스 확인
- 최종 브라우저 콘솔 오류 및 경고 없음