gis 편집

apps/sn/docs/작업검증/SFR-012-003-하수관로편집/002-qa-SFR-012-003-하수관로편집-통합검증결과.md

@@ -142,6 +142,308 @@
   - 비하수관로 클릭 시 줌 이동 완전 차단
   - `ADD` 미리보기와 `MOVE`, `VERTEX_EDIT` interaction 회귀 여부
 
+### 2.11 2026-05-22 최종본/이력 DB 저장 통합 검증
+
+- 검증 환경
+  - 화면: `http://localhost:3002/map`
+  - 프론트 프록시 대상: `http://localhost:8883/sewerage-service`
+  - 백엔드: `sewerage-service` local profile, port `8883`
+  - DB: `sm_bs_ms.tb_ms_swage_ppl`, `sm_bs_ms.tb_ms_edit_swage_ppl`
+- 발견 문제
+  - 브라우저에서 `ADD` 저장 요청은 정상 전송됐지만 최초 검증 시 `500 / E999`가 반환됐다.
+  - DB 직접 확인 결과, 최종본 `tb_ms_swage_ppl`의 다음 fid는 `4132694`였지만 이력 테이블에는 이미 `fid=4132694, edit_sn=0` 이력이 존재했다.
+  - 기존 BE 채번이 최종본 `MAX(fid)+1`만 사용해 삭제 이력이 남은 fid를 재사용했고, 이력 테이블 복합키 `tb_ms_edit_swage_ppl_pk(fid, edit_sn)`와 충돌했다.
+- 조치 내용
+  - 신규 fid 채번 기준을 최종본과 이력 테이블을 합친 `MAX(fid::bigint)+1`로 변경했다.
+  - 브라우저 저장 성공 후 원본 레이어 refresh가 호출되도록 기존 저장 성공 처리 흐름을 유지했다.
+  - 신규 관로의 시설관리번호와 관로관리번호가 비어 있거나 `NEW-*` 임시값이면 저장 API를 호출하지 않고 상세 입력창을 열도록 FE 검증을 추가했다.
+- 브라우저/API 검증 결과
+  - `ADD`: 지도에서 신규 관로를 그리고 `저장` 버튼 클릭, 응답 `200`, `editCd=C`, `editSn=0`, 신규 `fid=4132695`
+  - `MOVE`: 같은 브라우저 세션에서 신규 fid 기준 수정 저장, 응답 `200`, `editCd=U`, `editSn=1`
+  - `DELETE`: 같은 브라우저 세션에서 신규 fid 기준 삭제 저장, 응답 `200`, `editCd=D`, `editSn=2`
+  - 번호 미입력 신규 저장: 저장 요청 `0건`, 상태문구 `신규 하수관로 저장 전 시설관리번호와 관로관리번호를 입력해주세요.` 노출 확인
+- DB 검증 결과
+  - 삭제 후 `tb_ms_swage_ppl`의 테스트 fid 최종본 건수: `0`
+  - 삭제 전 검증 시 `tb_ms_edit_swage_ppl`의 테스트 fid 이력: `0:C,1:U,2:D`
+  - 검증 완료 후 테스트 fid `4132695`의 최종본/이력 흔적은 정리했다.
+  - 중간 자동화 중 잘못 선택된 기존 관로 `fid=2280012`는 직전 이력 기준으로 geometry를 원복했고, 테스트로 생성된 `edit_sn=1` 이력은 삭제했다.
+- 정적 검증
+  - BE: `.\gradlew.bat compileJava test --tests iipbs.sewerage.service.map.SwagePplEditServiceTest` 성공
+  - FE: `pnpm --filter sn exec tsc --noEmit --pretty false`는 저장소 기존 오류로 실패했으며, 이번 GIS 편집 변경 파일 관련 신규 오류는 확인되지 않았다.
+- 남은 확인 사항
+  - 자동화 좌표 클릭으로 `MOVE` 대상을 고를 때, 새 관로와 기존 관로가 겹치면 기존 관로가 선택될 수 있다. 실제 QA에서는 신규 관로를 기존 관로와 겹치지 않는 위치에 생성하거나 fid 기반 재선택 보조가 필요하다.
+  - 저장 전 신규 관로의 시설관리번호/관로관리번호 입력 편의성은 별도 화면 검증에서 추가 확인이 필요하다.
+
+### 2.12 2026-05-26 하수관망도 GIS 편집 UI/기능 상세 재검증
+
+#### 2.12.1 검증 목적
+
+- 하수관망도 화면의 `GIS 편집` 기능을 실제 사용자 조작 흐름 기준으로 재검증한다.
+- `추가`, `이동`, `꼭지점편집`, `삭제`, `저장 검증`, `편집 세션` 흐름을 함께 확인한다.
+- 사용자가 제기한 "기능이 이상한 것 같다"는 관찰을 UI/기능/계약/검증 가능성 관점으로 분해한다.
+- OpenLayers, ArcGIS, QGIS의 일반적인 GIS 편집 UX와 비교해 개선 방향을 정리한다.
+
+#### 2.12.2 검증 환경
+
+- 작업 루트: `D:\workspace`
+- 프론트엔드 앱: `D:\workspace\IIPBS-FRONTEND\frontend\apps\sn`
+- 화면 URL: `http://localhost:3002/map`
+- 백엔드 URL: `http://localhost:8883/sewerage-service`
+- 기준 화면: 하수관망도
+- 기준 편집 대상 레이어: `tb_ms_swage_ppl`
+- 기준 브라우저 검증 방식: 로컬 개발 서버에 로그인 후 실제 지도 화면에서 버튼 클릭, 좌표 클릭, 드래그, 더블클릭 수행
+- 병행 QA: `qa` 서브에이전트로 백엔드 테스트, API 검증, 인증 차단 여부 확인
+
+#### 2.12.3 검증 전제와 환경 제약
+
+- `sn` Next 개발 서버가 `3002` 포트에서 이미 실행 중이었다.
+- `AGENTS.md` 기준에 따라 개발 서버가 실행 중인 상태에서는 `next build`, `pnpm --filter sn run build`, `pnpm turbo run build --filter=sn`을 실행하지 않았다.
+- 로컬 브라우저 직접 검증은 개발 로그인 계정으로 진행했다.
+- QA 서브에이전트는 별도 세션에서 `/auth/login` 인증 차단에 걸려 화면 직접 검증을 수행하지 못했다.
+- 따라서 본 섹션의 UI 직접 조작 결과는 메인 브라우저 검증 결과를 기준으로 하고, 서브에이전트 결과는 API/BE/정적 검증 보조 증적으로 사용한다.
+
+#### 2.12.4 브라우저 진입 및 초기 로딩 상태
+
+- `/map` 직접 접근 시 로그인 페이지로 이동하는 것을 확인했다.
+- 개발 로그인 후 하수관망도 화면에 진입했다.
+- 지도, 좌측 시설 트리, 우측 분석 메뉴, 하수관망도 레이어 표시는 확인됐다.
+- `GIS 편집` 버튼 클릭 시 지도 상단 중앙에 편집 툴바가 표시됐다.
+- 툴바 구성은 `추가`, `이동`, `꼭지점편집`, `삭제`, `저장`으로 확인됐다.
+- 편집 진입 직후 `저장` 버튼은 비활성 상태였다.
+- 상태 문구는 `하수관로 편집 도구를 선택한 뒤 지도에서 편집 작업을 진행하세요.`로 표시됐다.
+- 지도 초기 로딩 중 다음 오류가 관찰됐다.
+  - `BIZ_TY_CD 데이터 로드 실패`
+  - `BIZ_SE_CD 데이터 로드 실패`
+  - 레이어 설정 조회 실패, `500 Internal Server Error`
+  - 메뉴 wrapper 계열 `AxiosError`
+- 위 오류는 GIS 편집 단독 결함으로 단정하지 않았지만, 편집 QA 중 화면 신뢰도와 재현성을 낮추는 환경/연동 리스크로 기록한다.
+
+#### 2.12.5 `추가` 검증 결과
+
+| 항목 | 내용 |
+| --- | --- |
+| 재현 절차 | `GIS 편집` 진입 후 `추가` 선택, 지도 위 여러 지점 클릭, 마지막 지점 더블클릭 |
+| 기대 결과 | 신규 하수관로 선형 sketch가 생성되고, 지도 위에서 선택 가능한 preview가 명확히 표시되며, 상세정보 입력 패널과 저장 가능 상태가 연결된다. |
+| 실제 결과 | 신규 변경분 `NEW-1`이 생성되고 `저장` 버튼이 활성화됐다. 우측 상세정보 패널이 열렸고 기본정보 입력 영역이 표시됐다. |
+| 통과 항목 | 도구 활성화, 선형 입력 완료, 신규 변경분 생성, 상세 패널 오픈, 저장 버튼 활성화 |
+| 문제 항목 | 신규 선형이 지도 위에서 충분히 강조되지 않았고, 우측 상세정보 패널이 지도 영역을 크게 가려 생성 위치 확인이 어렵다. |
+| 판정 | 부분 통과 |
+
+- `추가` 도구의 기본 기능은 동작한다.
+- 다만 사용자는 "내가 방금 추가한 관로가 어디에 생겼는지"를 지도에서 즉시 확인하기 어렵다.
+- 신규 객체는 고대비 선형, 라벨, 선택 테두리, 꼭지점 표시 중 최소 하나 이상의 강한 피드백이 필요하다.
+- 상세정보 패널이 우측 지도 영역을 크게 차지하므로 추가 직후 선형 위치와 패널 입력을 동시에 확인하기 어렵다.
+
+#### 2.12.6 `이동` 검증 결과
+
+| 항목 | 내용 |
+| --- | --- |
+| 재현 절차 | 신규 관로 추가 후 `이동` 선택, 신규 관로가 생성된 것으로 예상되는 위치에서 클릭 및 드래그 |
+| 기대 결과 | 이동 대상이 선택되고, 이동용 preview 또는 선택 테두리가 표시되며, 드래그 시 객체 geometry만 이동한다. |
+| 실제 결과 | 이동 도구 안내 문구는 표시됐지만, 대상 선택 상태와 드래그 핸들이 명확하지 않았다. 드래그 시 객체 이동보다 지도 pan처럼 보이는 동작이 관찰됐다. |
+| 통과 항목 | 도구 활성화, 상태 문구 표시 |
+| 문제 항목 | 선택 대상 식별 불명확, 이동 preview 식별 불명확, 드래그 중 지도 이동과 객체 이동이 구분되지 않음 |
+| 판정 | 불안정 |
+
+- `이동`은 GIS 편집에서 사용자가 가장 직관적으로 기대하는 기능 중 하나지만, 현재 화면에서는 "어떤 객체가 선택됐고 무엇을 잡고 움직여야 하는지"가 명확하지 않다.
+- 편집 대상이 선택되면 지도 pan보다 객체 이동 interaction이 우선되어야 한다.
+- 선택 후 이동 가능한 상태에서는 cursor, 선택 테두리, preview 색상, 상태 문구가 함께 바뀌어야 한다.
+
+#### 2.12.7 `꼭지점편집` 검증 결과
+
+| 항목 | 내용 |
+| --- | --- |
+| 재현 절차 | `꼭지점편집` 선택 후 신규 관로 또는 기존 관로로 보이는 위치를 클릭하고 vertex handle 표시 및 드래그 가능 여부 확인 |
+| 기대 결과 | 실꼭지점은 주황색 handle로, 새 점 삽입 후보 midpoint는 흰색 handle로 안정적으로 표시된다. 꼭지점을 드래그하면 선형 geometry가 즉시 갱신된다. |
+| 실제 결과 | 안내 문구는 표시됐지만 실제 주황색 꼭지점과 흰색 midpoint handle을 안정적으로 확인하지 못했다. 꼭지점 선택/드래그 가능 상태도 사용자 관점에서 확정하기 어려웠다. |
+| 통과 항목 | 도구 활성화, 상태 문구 표시 |
+| 문제 항목 | vertex handle 표시 불명확, midpoint 삽입 후보 확인 불가, 드래그 가능 대상 식별 불가 |
+| 판정 | 불량 |
+
+- `꼭지점편집`은 현재 가장 큰 기능 리스크다.
+- 기존 문서에서도 `VERTEX_EDIT`는 QGIS 기준 사용자 경험 재정렬과 실조작 수동 재검증이 필요한 항목으로 남아 있었다.
+- 이번 재검증에서도 사용자가 기대하는 "꼭지점이 보이고 잡아서 움직인다"는 핵심 피드백이 충분하지 않았다.
+- 선형 편집 도구는 실꼭지점, 선택 꼭지점, hover segment, midpoint 삽입 후보를 시각적으로 구분해야 한다.
+
+#### 2.12.8 `삭제` 검증 결과
+
+| 항목 | 내용 |
+| --- | --- |
+| 재현 절차 | `삭제` 선택 후 신규 관로 또는 기존 관로로 보이는 위치 클릭 |
+| 기대 결과 | 삭제 대상이 선택되고, 즉시 최종 삭제하지 않더라도 pending-delete 스타일이 표시되며, 세션 변경목록에 삭제 변경분이 추가된다. |
+| 실제 결과 | 삭제 도구 안내 문구는 표시됐지만, 어떤 객체가 삭제 대상으로 선택됐는지 명확한 지도 피드백을 확인하지 못했다. |
+| 통과 항목 | 도구 활성화, 상태 문구 표시 |
+| 문제 항목 | 삭제 대상 선택 피드백 부족, pending-delete 스타일 확인 어려움, 되돌리기 흐름 노출 부족 |
+| 판정 | 불안정 |
+
+- 삭제는 저장 전 pending 상태가 반드시 명확해야 한다.
+- 현재처럼 선택 피드백이 약하면 사용자는 기존 관로를 잘못 삭제 대상으로 올렸는지 확인하기 어렵다.
+- 삭제 대상은 빨간 점선, 반투명 처리, `삭제 예정` 라벨, 세션 목록 강조가 함께 필요하다.
+
+#### 2.12.9 저장 검증 결과
+
+| 항목 | 내용 |
+| --- | --- |
+| 재현 절차 | 신규 관로 `NEW-1` 생성 후 필수값을 충분히 입력하지 않은 상태에서 `저장` 클릭 |
+| 기대 결과 | 저장 API 호출 전 필수값 누락을 차단하고, 누락 필드와 입력 위치를 정확히 안내한다. |
+| 실제 결과 | 저장 API 호출 전 차단됐고, 상세정보 패널이 열리며 상태 문구가 표시됐다. |
+| 통과 항목 | 신규 관로 필수값 누락 시 저장 API 호출 차단 |
+| 문제 항목 | 상태 문구와 화면 필드명이 일치하지 않음 |
+| 판정 | 부분 통과 |
+
+- 표시 문구: `신규 하수관로 저장 전 시설관리번호와 관로관리번호를 입력해주세요.`
+- 화면 필드명: `시설관리번호`, `기관관리번호`
+- `관로관리번호`와 `기관관리번호`가 서로 다른 의미라면 화면에 두 필드를 모두 분명히 노출해야 한다.
+- 같은 의미라면 필드명과 검증 문구를 통일해야 한다.
+- 이 불일치는 저장 실패 원인을 사용자가 잘못 이해하게 만들 수 있으므로 UI 문구 결함으로 분류한다.
+
+#### 2.12.10 편집 세션 및 팝업 검증 결과
+
+| 항목 | 내용 |
+| --- | --- |
+| 기대 결과 | GIS 편집 진입 시 편집 세션 목록, 마지막 변경 취소, 세션 초기화, 항목 focus가 사용자가 확인 가능한 위치에 표시된다. |
+| 실제 결과 | 메인 지도 툴바는 표시됐지만, 세션 팝업 또는 변경목록이 사용자에게 명확히 노출되는지 확인이 어려웠다. |
+| 판정 | 불안정 |
+
+- 기존 구현 기록상 GIS 편집 세션은 popup 기반으로 전환되어 있다.
+- 실제 사용자는 브라우저 팝업 차단, 포커스 이동, 별도 창 위치 문제로 세션 상태를 놓칠 수 있다.
+- 편집 기능은 저장 전 변경목록 확인이 중요하므로, 팝업이 열리지 않거나 가려져도 메인 화면 안에서 최소 변경 건수와 마지막 변경 요약은 확인 가능해야 한다.
+
+#### 2.12.11 서브에이전트 QA 결과 요약
+
+- 코드 변경 없이 읽기, 브라우저, API, 테스트 중심으로 검증했다.
+- BE `.\gradlew.bat compileJava`: 통과
+- BE `.\gradlew.bat test`: 통과, `BUILD SUCCESSFUL`
+- FE 빌드: 미실행
+  - `sn` 개발 서버가 `3002`에서 실행 중이므로 사용자 확인 없이 빌드하지 않았다.
+- FE `pnpm --filter sn exec tsc --noEmit --pretty false`: 실패
+  - 기존 공통/앱 TypeScript 오류 다수 확인
+  - 이번 GIS 편집 단독 신규 오류로 단정하지 않음
+- 서브에이전트 브라우저 검증: `/auth/login` 인증 차단으로 GIS 화면 직접 검증 불가
+- API 검증:
+  - `GET /sewerage-service/api/v1/map/gisEdit/swagePpl/meta?lyrGrp=SN_NETWORK`: 통과
+  - 편집 대상: `tb_ms_swage_ppl`
+  - 지원 편집: `ADD`, `MOVE`, `VERTEX_EDIT`, `DELETE`
+  - 저장 테이블: `sm_bs_ms.tb_ms_swage_ppl`
+  - 이력 테이블: `sm_bs_ms.tb_ms_edit_swage_ppl`
+  - 빈 변경분 저장 요청: `400 GIS_EDIT_EMPTY_CHANGES` 정상
+  - 비관로 레이어 저장 요청: `400 GIS_EDIT_PIPE_ONLY` 정상
+  - `GET /gisEdit/swagePpl/histories?fid=1`: `200 OK`
+- 서브에이전트 증적:
+  - `D:\workspace\qa-evidence\sfr-012-003-auth-blocker.png`
+  - `D:\workspace\qa-evidence\sfr-012-003-session-popup-direct.png`
+
+#### 2.12.12 외부 GIS 편집 UX 비교
+
+| 비교 대상 | 참고 기준 | 현재 화면과의 차이 |
+| --- | --- | --- |
+| OpenLayers Draw | `Draw` interaction은 sketch 시작, 진행, 완료 이벤트를 별도 interaction으로 관리한다. | 현재 `추가`는 완료 후 신규 sketch의 시각 강조가 약하다. |
+| OpenLayers Modify | `Modify` interaction은 vertex 조작을 명확한 handle 기반으로 제공한다. | 현재 `꼭지점편집`은 실꼭지점과 midpoint handle이 안정적으로 보이지 않는다. |
+| OpenLayers Translate | `Translate` interaction은 선택 feature 이동을 지도 pan과 분리해 처리한다. | 현재 `이동`은 드래그 시 객체 이동과 지도 pan이 사용자에게 구분되지 않는다. |
+| ArcGIS Map Viewer / Web Editor | 편집 대상 선택, vertex 편집, 저장 전 확인 흐름을 사용자에게 명확히 제공한다. | 현재 세션 변경목록과 pending 상태 노출이 약하다. |
+| QGIS Vertex Tool | 실꼭지점, segment, midpoint 삽입 후보를 시각적으로 구분한다. | 현재 `VERTEX_EDIT`는 QGIS 수준의 조작 피드백에 도달하지 못했다. |
+
+참고 링크:
+
+- OpenLayers Draw: https://openlayers.org/en/latest/apidoc/module-ol_interaction_Draw-Draw.html
+- OpenLayers Modify: https://openlayers.org/en/latest/apidoc/module-ol_interaction_Modify-Modify.html
+- OpenLayers Translate: https://openlayers.org/en/latest/apidoc/module-ol_interaction_Translate-Translate.html
+- ArcGIS Online Map Viewer editing: https://doc.arcgis.com/en/arcgis-online/manage-data/edit-features-mv.htm
+- ArcGIS Web Editor vertex editing: https://doc.arcgis.com/en/web-editor/latest/create-and-edit/edit-vertices.htm
+- QGIS geometry editing: https://docs.qgis.org/latest/en/docs/user_manual/working_with_vector/editing_geometry_attributes.html
+
+#### 2.12.13 결함 및 개선 백로그
+
+| 우선순위 | 구분 | 내용 | 개선 방향 |
+| --- | --- | --- | --- |
+| P1 | 기능/UX | `이동`, `꼭지점편집`, `삭제`에서 편집 대상 선택 피드백이 불충분하다. | 선택 feature를 고대비 overlay로 표시하고, 선택/drag 가능 상태를 cursor와 상태 문구로 함께 제공한다. |
+| P1 | 기능 | `꼭지점편집`의 vertex handle과 midpoint handle이 안정적으로 확인되지 않는다. | 실꼭지점, 선택 꼭지점, hover segment, midpoint 삽입 후보를 별도 style로 분리한다. |
+| P1 | 기능 | `이동` 드래그가 지도 pan과 구분되지 않는다. | 선택 feature drag 중 지도 pan을 일시 제한하고, 이동 preview source를 명확히 분리한다. |
+| P1 | 기능/세션 | 세션 변경목록과 pending 상태가 사용자에게 명확하지 않다. | 팝업 실패 fallback 또는 메인 지도 내 축약 세션 패널을 제공한다. |
+| P2 | UI | `추가` 후 신규 선형이 지도에서 충분히 강조되지 않는다. | 신규 객체 label, 선택 테두리, vertex 표시, 자동 focus를 보강한다. |
+| P2 | UI | 상세정보 패널이 지도 확인을 방해한다. | 패널 폭/위치/접힘 상태를 조정하고, 선택 객체 focus와 겹치지 않게 한다. |
+| P2 | 문구 | 저장 검증 문구의 `관로관리번호`와 화면 필드 `기관관리번호`가 불일치한다. | 백엔드 계약 기준으로 필드명을 통일하고 누락 필드를 행 단위로 강조한다. |
+| P2 | 연동 | 지도 초기 로딩 중 코드/레이어 설정 조회 오류가 발생한다. | GIS 편집 결함과 분리해 공통 코드/레이어 설정 API 오류를 먼저 정리한다. |
+| P3 | QA | QA 서브에이전트 세션에서 인증 차단으로 화면 검증이 막힌다. | QA용 로컬 로그인 절차, 테스트 계정, 토큰 주입 절차를 문서화한다. |
+
+#### 2.12.14 종합 판정
+
+- 백엔드 컴파일, 테스트, 기본 GIS 편집 API 계약은 정상 범위로 확인됐다.
+- 프론트엔드 정적 검증은 기존 TypeScript 오류로 실패 상태이며, 이번 검증만으로 GIS 편집 단독 신규 오류라고 단정하지 않는다.
+- 실제 사용자 기준의 GIS 편집 UI는 `추가`만 부분 통과이고, `이동`, `꼭지점편집`, `삭제`는 선택 피드백과 조작 피드백이 부족해 개선 필요로 판정한다.
+- 특히 `VERTEX_EDIT`는 기존 검증 문서에서 이미 진행 중/리스크로 분류된 항목이며, 이번 재검증에서도 동일하게 핵심 개선 대상으로 확인됐다.
+- 다음 개선 순서는 `선택 피드백`, `vertex handle`, `이동 drag와 지도 pan 분리`, `세션 변경목록 노출`, `저장 검증 문구 정리` 순서가 적절하다.
+
+### 2.13 2026-05-26 Playwright 기반 GIS 편집 실조작 재검증
+
+#### 2.13.1 검증 범위와 경로
+
+- 검증 방식: Playwright MCP 브라우저 자동화 기반 실제 화면 조작
+- 로그인 경로: `http://localhost:3002/auth/login`
+- 로그인 계정: `CLEANWATER`
+- 지도 경로: `http://localhost:3002/map`
+- 백엔드 경로: `http://localhost:8883/sewerage-service`
+- 세션 팝업 경로: `http://localhost:3002/popup/gisEditSessionPopup`
+- 테스트 관리번호:
+  - 1차: `QA-PW-20260526-001`, `clientTempId=NEW-1`
+  - 2차: `QA-PW-20260526-002`, `clientTempId=NEW-2`
+- 최종 정리 상태: 저장 API가 두 차례 모두 `500 E999`로 실패해 `fid/editSn`은 발급되지 않았고, DB 삭제 저장은 수행할 대상이 없었다. 미저장 로컬 세션은 `마지막 변경 취소`로 `총 0건`까지 정리했다.
+
+#### 2.13.2 기능별 실조작 결과
+
+| 기능 | 재현 절차 | 기대 결과 | 실제 결과 | 심각도 | 개선 제안 |
+| --- | --- | --- | --- | --- | --- |
+| 로그인/진입 | `/auth/login`에서 `CLEANWATER` 로그인 후 `/map` 진입, `GIS 편집` 클릭 | 지도와 편집 툴바, 세션 팝업이 표시된다. | 로그인 성공, `/map` 진입 성공, `GIS 편집` 클릭 시 툴바와 세션 팝업 탭 표시 확인 | 통과 | QA 계정 기반 재현 절차를 검증 문서에 유지한다. |
+| 추가 | 빈 위치에 선형 클릭-더블클릭, 상세정보에 `QA-PW-20260526-001/002` 입력, `저장` 클릭 | 신규 관로가 저장되고 응답에서 신규 `fid`, `editSn=0`, `editCd=C`가 확인된다. | preview, 상세 패널, 세션 목록, 저장 버튼 활성화는 확인됐으나 저장 API가 2회 모두 `500 E999`로 실패했다. `fid/editSn` 미발급 | P1 | BE는 `E999/ERROR` 대신 원인 코드와 메시지를 반환해야 한다. FE는 저장 실패 시 사용자가 조치 가능한 필드/원인을 표시해야 한다. |
+| 추가 payload | 상세정보의 `시설관리번호`, `기관관리번호`에 테스트 번호 입력 후 세션 payload 확인 | 입력한 관리번호가 저장 payload의 필수 식별 필드에 일관되게 반영된다. | `fclt_mng_no`, `inst_mng_no`에는 값이 들어가지만 `fcltMngNo`, `mngInstCd`는 빈 문자열로 전송됐다. | P1 | 신규 관로 입력값 병합 시 빈 문자열을 유효값으로 우선하지 말고 snake/camel 필드를 동일 값으로 정규화해야 한다. |
+| 이동 | 저장 실패 후 남은 `NEW-2` preview 기준 `이동` 선택, 대상 클릭 후 drag | 대상 관로가 선택되고 지도 pan이 아니라 관로 preview가 이동한다. | 상태문구는 이동 모드로 전환됐지만 대상 선택/drag 후 세션 변경이나 화면상 선택 피드백을 확인하지 못했다. | P2 | 미저장 ADD preview도 선택 가능 여부를 명확히 하거나, 지원하지 않는다면 상태문구로 제한을 안내한다. |
+| 꼭지점편집 | `꼭지점편집` 선택 후 `NEW-2` preview 클릭 및 vertex drag 시도 | 주황색 실꼭지점과 흰색 midpoint가 보이고 vertex/midpoint 조작이 가능하다. | 상태문구는 vertex 안내로 전환됐지만 주황색/흰색 handle과 실제 drag 반영을 확인하지 못했다. | P2 | 선택 성공/실패 피드백, vertex handle 표시 조건, midpoint 삽입 가능 범위를 화면에서 명확히 표시한다. |
+| 삭제 | `삭제` 선택 후 `NEW-2` preview 클릭 | 삭제 예정 스타일, 세션 변경목록, 되돌리기 가능 상태가 표시된다. | 저장된 fid가 없어 최종 삭제 저장은 불가했다. 미저장 preview 클릭 후 삭제 변경 전환은 확인되지 않았고, 세션에는 ADD 1건만 남았다. | P2 | 미저장 ADD 객체 삭제는 세션 목록의 `마지막 변경 취소`와 같은 명시적 UI로 안내하거나 지도 클릭 삭제를 지원한다. |
+| 취소/롤백 | 세션 팝업에서 `마지막 변경 취소` 클릭 | 마지막 변경분이 제거되고 저장할 변경분이 없어야 한다. | `총 0건`, `저장할 편집 변경분이 없습니다.` 확인. 지도 상태문구도 `가장 최근 편집 변경분을 세션에서 제거했습니다.`로 표시 | 통과 | 최종 저장 실패 후 사용자가 쉽게 정리할 수 있도록 이 동작을 메인 툴바에도 노출하는 방안을 검토한다. |
+
+#### 2.13.3 네트워크/API 응답
+
+| 순번 | 요청 | 테스트 관리번호 | 응답 | 기록 |
+| --- | --- | --- | --- | --- |
+| 147 | `POST http://localhost:3002/sewerage-service/api/v1/map/gisEditSessions/save` | `QA-PW-20260526-001` | `500 Internal Server Error`, body `{"message":"ERROR","status":500,"code":"E999"}` | `clientTempId=NEW-1`, `fid/editSn` 미발급 |
+| 149 | `POST http://localhost:3002/sewerage-service/api/v1/map/gisEditSessions/save` | `QA-PW-20260526-002` | `500 Internal Server Error`, body `{"message":"ERROR","status":500,"code":"E999"}` | `clientTempId=NEW-2`, `fid/editSn` 미발급 |
+
+- 2차 저장 요청 주요 payload:
+  - `layerId`: `tb_ms_swage_ppl`
+  - `saveTargetType`: `FINAL`
+  - `view.srs`: `EPSG:5179`
+  - `editType`: `ADD`
+  - `geometry.type`: `LineString`
+  - `coordinates`: `[[1068626.8294507712,1774978.3276935548],[1068741.356641528,1774930.6080307395],[1068855.8838322847,1774978.3276935548]]`
+  - `attributes.fclt_mng_no`: `QA-PW-20260526-002`
+  - `attributes.inst_mng_no`: `QA-PW-20260526-002`
+  - `attributes.fcltMngNo`: 빈 문자열
+  - `attributes.mngInstCd`: 빈 문자열
+
+#### 2.13.4 콘솔 오류
+
+- `GET http://localhost:3002/server/cms-service/api/v1/menu-roles/SN` -> `401 Unauthorized`
+- `POST http://localhost:3002/sewerage-service/api/v1/map/gisEditSessions/save` -> `500 Internal Server Error`
+- `GIS 편집 저장 실패: Error: ERROR`
+- `AxiosError`
+
+#### 2.13.5 화면 캡처
+
+- `D:\workspace\qa-evidence\sfr-012-003-login-map-loaded.png`
+- `D:\workspace\qa-evidence\sfr-012-003-add-before-save.png`
+- `D:\workspace\qa-evidence\sfr-012-003-session-add-failed-payload.png`
+- `D:\workspace\qa-evidence\sfr-012-003-add-retry-before-save.png`
+- `D:\workspace\qa-evidence\sfr-012-003-move-unsaved-no-selection.png`
+- `D:\workspace\qa-evidence\sfr-012-003-vertex-unsaved-no-handles.png`
+- `D:\workspace\qa-evidence\sfr-012-003-session-undo-clean.png`
+
+#### 2.13.6 현재 판정
+
+- `ADD`는 화면 조작, 상세정보 입력, 세션 반영, 저장 버튼 활성화까지는 통과했지만 최종 저장 API가 `500 E999`로 실패해 통합 검증은 실패로 판정한다.
+- `MOVE`, `VERTEX_EDIT`, `DELETE`는 저장된 테스트 fid가 없어 최종본 기준 검증을 수행하지 못했다. 미저장 preview 기준으로는 선택/drag/삭제 피드백이 명확하지 않아 보류 및 UX 결함으로 분류한다.
+- 테스트 관리번호 `QA-PW-20260526-001/002`는 저장 실패로 `fid/editSn`이 생성되지 않았다. 최종본 삭제 저장 정리 대상은 없었고, FE 로컬 세션은 `총 0건`으로 정리했다.
+- `next build`, `pnpm --filter sn run build`, `pnpm turbo run build --filter=sn`은 실행하지 않았다. `sn` dev server가 `3002`에서 실행 중이므로 AGENTS.md 기준에 따라 빌드 검증은 제외했다.
+
 ## 3. 현재 검증 상태
 
 ### 3.1 통과
@@ -150,34 +452,47 @@
 - 레이어별 도구 활성 규칙
 - 세션 `undo`, `reset`
 - `MOVE`의 기본 preview drag
+- 하수관로 `ADD/MOVE/DELETE` 최종본/이력 DB 저장
 
 ### 3.2 진행 중
 
 - `ADD` geometry family별 직접 캡처
+- 2026-05-26 Playwright 재검증 기준 `ADD` 최종 저장 API `500 E999` 원인 분석 및 재검증
 - `VERTEX_EDIT`의 QGIS 기준 사용자 경험 재정렬
 - `MOVE`, `VERTEX_EDIT` 실조작 수동 재검증
+- 2026-05-26 재검증에서 확인된 `이동`, `꼭지점편집`, `삭제` 선택 피드백/조작 피드백 개선
 
 ### 3.3 보류
 
-- 실제 저장 API 연결 이후 통합 저장 검증
-- 원본 보호와 편집본 참조 갱신 검증
+- 저장 성공 후 GeoServer/GWC 캐시 무효화 운영 방식 검증
+- `ADD` 저장 실패로 인한 신규 fid 기반 `MOVE/VERTEX_EDIT/DELETE/삭제 저장 정리` 재검증
+- QA 서브에이전트 또는 독립 검증자가 사용할 수 있는 로컬 로그인/인증 절차 문서화
 
 ## 4. 보류/리스크
 
+- 2026-05-26 Playwright 재검증에서 신규 관로 저장 API가 `500 E999`로 실패해 최종본 기준 편집 시나리오가 차단됐다.
+- 신규 관로 상세정보 저장 payload에서 `fclt_mng_no`/`inst_mng_no`는 입력값이 들어가지만 `fcltMngNo`/`mngInstCd`는 빈 문자열로 남아 필수 식별자 정합성 리스크가 있다.
 - dev 서버가 켜져 있으면 `next build`를 함께 돌리기 어렵다.
 - `next lint`는 환경 이슈로 안정적인 회귀 수단이 되지 못하고 있다.
 - 지도 캔버스 기반 drag/vertex 테스트는 수동 브라우저 검증 의존도가 높다.
 - `VERTEX_EDIT`는 하수관로 `LineString`/`MultiLineString` 처리와 vertex marker UX를 다시 고정해야 한다.
 - 현재 저장소의 기존 TypeScript 오류 때문에 변경분만 분리한 정적 통과 여부를 보장하기 어렵다.
+- 기존 관로와 겹친 위치에서 자동 클릭 기반 `MOVE/DELETE` 검증을 수행하면 의도하지 않은 기존 관로가 선택될 수 있다.
+- `GIS 편집 세션`이 popup에 의존하면 팝업 차단, 포커스 이동, 별도 창 위치 문제로 사용자가 변경목록을 놓칠 수 있다.
+- 저장 검증 메시지와 화면 필드명이 불일치하면 신규 관로 저장 실패 원인을 사용자가 잘못 이해할 수 있다.
+- 지도 초기 로딩 오류가 남아 있으면 GIS 편집 결함과 공통 지도/코드/레이어 설정 오류를 분리하기 어렵다.
 
 ## 4-1. 관측 증적 요약
 
 - 자동으로 확인된 항목
+  - `CLEANWATER` 계정 로그인 후 `/map` 진입
   - `GIS편집` 모드 진입/종료
+  - 신규 관로 `ADD` preview 생성, 상세정보 입력, 세션 목록 반영
   - 레이어별 도구 활성 규칙
   - 세션 `undo`, `reset`
   - `MOVE`의 기본 preview drag 준비 구조
 - 수동 또는 후속 확인이 필요한 항목
+  - `ADD` 저장 API `500 E999` 원인 확인
   - 실제 canvas drag 정확도
   - `VERTEX_EDIT`의 vertex marker 노출과 꼭지점 직접 이동
   - 저장 API 연결 후 응답 처리와 원본 보호
@@ -197,6 +512,7 @@
 - `환경 차단`
   - dev 서버 실행 중 build 병행이 어렵고, lint도 안정적 회귀 수단이 아니다.
 - `기능 결함 또는 미완료`
+  - `ADD` 최종 저장이 `500 E999`로 실패해 신규 fid 기반 후속 검증이 차단된다.
   - `VERTEX_EDIT`는 아직 요구사항 기준으로 다시 고정이 필요하다.
 
 ## 5. 흡수한 기존 문서