frontend/apps/sn/docs/작업검증/SFR-012-003-하수관로편집/001-qa-SFR-012-003-하수관로편집-통합검증계획.md

SFR-012-003 하수관로편집 통합 검증 계획

1. 문서 목적

• SFR-012-003 하수관로편집의 검증 계획을 기능당 1개 문서로 누적 관리한다.
• 기존 001, 003, 005, 007, 009, 011 계획 문서를 이 문서로 흡수한다.
• 이후 라운드부터는 새 검증 계획 파일을 추가하지 않고 이 문서 내부 헤더로만 구분한다.

2. 검증 기준 요약

• 레이어 선택 전 편집 도구 비활성
• ADD, MOVE, VERTEX_EDIT, DELETE 변경분은 저장 전까지 로컬 세션 유지
• MOVE
  • preview drag 후 geometry 반영
• VERTEX_EDIT
  • vertex marker 표시
  • 양 끝점 이동 가능
  • geometry 반영
• 저장 시 원본 직접 수정 금지

3. 라운드별 검증 계획 요약

3.1 초기/후속 검증

• GIS 편집 버튼 진입/종료, 메뉴 강조 잔류 재확인
• 기본 툴바 노출과 상태 메시지 확인

3.2 세션도구 확장 검증

• 7개 편집 레이어 노출 확인
• 레이어별 도구 활성 규칙 확인
• undo, reset 확인

3.3 실제지도조작 확장 검증

• MOVE, VERTEX_EDIT, DELETE가 실제 지도 조작 구조를 받을 수 있는지 코드/브라우저 기준으로 점검
• 자동 브라우저 drag는 한계가 있어 수동 검증 필요로 기록

3.4 MOVE

• preview drag 구조와 세션 반영 흐름은 상대적으로 안정적
• 유지 기준으로 본다

3.5 VERTEX_EDIT

• 가장 많은 변동이 있었고 현재도 재검증 필요
• 핵심 검증 기준
  • 선택 직후 vertex marker 표시
  • 양 끝점 이동 가능
  • 이동 후 geometry가 실제로 변경

3.6 2026-05-15 세션 유지 / MOVE / VERTEX_EDIT 회귀 검증

• 사용자 피드백 기준으로 아래 항목을 우선 재검증한다.
  • ADD, MOVE, VERTEX_EDIT 후 세션 기록과 지도 preview가 바로 사라지지 않는지
  • 신규 추가 preview가 레이어별로 다른 색상으로 보여 구분 가능한지
  • 편집 세션 기본 패널이 최근 5건 정도 높이만 보이고, 아래 이력은 패널 내부 스크롤로 바로 확인 가능한지
  • MOVE 대상 선택 후 preview drag가 실제로 반응하는지
  • VERTEX_EDIT 대상 선택 후 모든 실꼭지점 marker와 midpoint handle이 드러나는지
  • VERTEX_EDIT 양 끝점 drag가 실제로 반응하는지
  • VERTEX_EDIT midpoint drag 후 새 vertex가 삽입되는지
  • VERTEX_EDIT 드래그 후 geometry 변경이 세션 요약과 preview에 반영되는지
  • 하수처리시설이 point 기준으로 VERTEX_EDIT 비대상으로 처리되는지

3.7 2026-05-15 QGIS 유사 VERTEX_EDIT 재구현 검증

• QGIS 비교 기준으로 아래 항목을 별도 확인한다.
  • 실꼭지점은 항상 보이되, midpoint는 모든 segment에 상시 표시되지 않고 hover segment 기준으로만 나타나는지
  • endpoint와 중간 vertex가 동일한 주황색 handle 규칙으로 이동되는지
  • midpoint drag가 새 vertex 삽입으로 반영되는지
  • feature 선택이 유지된 상태에서 연속 꼭지점 편집이 가능한지
  • MOVE 도구 회귀 없이 preview drag가 기존처럼 유지되는지

3.8 2026-05-15 편집 세션 팝업 전환 및 도구 아이콘 검증

• 편집 세션 고정 패널이 더 이상 지도 위에 남지 않는지
• GIS 편집 진입 시 GIS 편집 세션 window popup이 열리는지
• 팝업에서 변경 목록, 마지막 변경 취소, 세션 초기화, 항목 focus가 메인 지도와 동기화되는지
• 세션 안내 문구 영역이 제거됐는지
• 추가, 이동, 꼭지점편집, 삭제 버튼에 lucide-react 아이콘이 표시되는지

3.9 2026-05-21 관로 기본정보 세션 편집 검증

• 편집 대상 레이어가 하수관로일 때만 편집 상세정보창이 열리는지
• MOVE, VERTEX_EDIT, ADD change 선택 후 상세정보창 상단 기본정보 테이블에서 7개 필드가 직접 수정 가능한지
• 신규 추가일 때 경과년도, 설치일자 확인불가 같은 조회 전용 표식이 노출되지 않는지
• 상세정보창 저장이 즉시 DB 저장이 아니라 basicInfo 세션 저장으로만 처리되는지
• 입력 중 스크롤이 상단으로 점프하지 않고 현재 편집 위치를 유지하는지
• GIS 편집 세션 목록에 기본정보 세션저장 표식이 나타나는지
• 최종 저장 payload에 featureRef, basicInfo, beforeGeometry, afterGeometry가 함께 들어가는지
• DELETE change나 관로 외 레이어에서는 상세정보 세션 편집창이 열리지 않는지
• 편집 세션 모드에서는 보수 및 갱신, 청소 및 준설, 점검 및 진단 섹션이 숨겨지는지
• MOVE, VERTEX_EDIT 중 비하수관로 클릭 시 선택/줌 이동 없이 차단되고 상태문구만 바뀌는지
• MOVE, VERTEX_EDIT에서 하수관로 선택 즉시 편집 상세정보창이 열리는지

3.10 2026-06-26 MOVE 도구 on/off 유지보수 검증 계획

• 구현 후 아래 순서로 검증한다.
  1. GIS편집을 켜고 이동 버튼을 한 번 클릭한다.
  2. 하수관로 A를 선택하고 drag 이동을 완료한다.
  3. 이동 완료 후 툴바의 이동 버튼 active 상태가 유지되는지 확인한다.
  4. 이동 버튼을 다시 누르지 않은 상태에서 하수관로 B를 선택해 이동 interaction이 다시 준비되는지 확인한다.
  5. 하수관로 B 이동 완료 후에도 이동 active 상태가 유지되는지 확인한다.
  6. 이동 버튼을 다시 클릭하면 active 상태가 꺼지고, 이후 지도 클릭이 이동 변경분을 만들지 않는지 확인한다.
• 회귀 확인
  • 추가, 꼭지점편집, 삭제 버튼은 기존처럼 하나만 active여야 한다.
  • 스냅핑 on/off는 이동 active 유지와 별개로 유지되어야 한다.
  • 닫기, 저장, 세션 초기화, 마지막 변경 취소 후 이동 도구와 interaction이 남지 않아야 한다.
• 검증 분류
  • 툴바 active 상태와 상태 메시지는 자동 관측 가능하다.
  • 실제 canvas drag와 관로별 연속 이동 체감은 수동 브라우저 검증을 기본으로 한다.

4. 현재 검증 범위

4.1 진행 중

• ADD geometry family별 직접 캡처
• VERTEX_EDIT의 QGIS 기준 사용자 경험 재정렬

4.2 이후 범위

• 실제 저장 API 연결 이후 통합 저장 검증
• 원본 보호와 편집본 참조 갱신 검증

5. 현재 테스트 메모

• dev 서버가 켜져 있으면 next build는 수행하지 않는다.
• next lint는 환경 이슈로 안정적인 회귀 수단이 되지 못하고 있다.
• 지도 캔버스 기반 drag/vertex 테스트는 수동 브라우저 검증이 핵심이다.

5-1. 브라우저 검증 선행조건

• /map 진입 가능한 로그인 상태 또는 로컬 임시 로그인 경로가 준비되어 있어야 한다.
• FE dev 서버와 관련 BE API가 모두 응답해야 한다.
• 편집 대상 레이어와 샘플 객체를 재현 가능한 테스트 데이터로 확보해야 한다.
• 인증 또는 외부 연동 문제로 진입이 막히면 기능 결함이 아니라 인증 차단 또는 환경 차단으로 분류한다.
• 로컬 인증 우회 필요 시 COMMON_DOCS_ROOT/작업내용/공통-로그인/001-de-공통-로그인-로컬임시로그인-검토계획.md를 참조한다.

5-2. 브라우저 자동검증 관측 포인트

구분	관측 포인트	기대 결과	검증 방식
공통	GIS편집 버튼	편집 모드 진입 시 강조, 종료 시 해제	자동
공통	편집 툴바	편집 모드에서만 노출	자동
공통	레이어 선택	미선택 시 도구 비활성, 선택 시 활성	자동
세션	변경 목록	조작 후 항목 누적	자동
세션	undo, reset	상태 복구 또는 초기화	자동
ADD	상태 메시지/신규 항목	geometry family별 신규 추가 반영	자동 중심
MOVE	preview label, 목록 요약	drag 후 geometry 변경 반영	자동+수동
VERTEX_EDIT	vertex marker 또는 modify handle	선택 직후 노출, 이동 후 geometry 변경	수동 중심
DELETE	임시 삭제 스타일	저장 전까지 유지	자동+수동
SAVE	payload/응답 처리	성공 또는 실패 메시지와 세션 상태 반영	자동

5-3. 차단 사유 분류 기준

• 기능 결함: 기대한 상태 전이 또는 응답 처리가 깨짐
• 인증 차단: 로그인, 토큰, 권한 문제로 진입 또는 호출이 막힘
• 환경 차단: 서버 미기동, 프록시/네트워크 문제
• 데이터 차단: 레이어 메타, 샘플 객체, 테스트 BBOX 부족
• 자동화 한계: canvas drag, vertex 조작을 도구가 안정적으로 재현하지 못함

6. 다음 검증 순서

1. ADD
   • 점형 클릭 추가
   • 선형 연속 클릭 추가
   • 면형 폐합 추가
   • 편집 모드 종료 후에도 세션/preview 유지 확인
2. MOVE
   • preview drag 회귀 없는지 확인
   • drag 종료 후 요약/geometry 반영 확인
3. VERTEX_EDIT
   • 실꼭지점 marker 표시
   • hover segment midpoint 표시
   • 양 끝점 이동
   • 중간 vertex 이동
   • 드래그 후 geometry/요약 반영 확인
4. DELETE
   • 임시 삭제 스타일 유지

7. 흡수한 기존 문서

• 001-qa-SFR-012-003-하수관로편집-검증계획.md
• 003-qa-SFR-012-003-하수관로편집-후속검증계획.md
• 005-qa-SFR-012-003-하수관로편집-세션도구확장검증계획.md
• 007-qa-SFR-012-003-하수관로편집-실제지도조작검증계획.md
• 009-qa-SFR-012-003-하수관로편집-MOVE실드래그검증계획.md
• 011-qa-SFR-012-003-하수관로편집-VERTEX_EDIT실조작검증계획.md

8. 2026-07-15 편집 세션 인라인 전환 검증 계획

1. 정적 구조
   • GIS 편집 진입 시 팝업 자동 호출이 제거되었는지 확인한다.
   • 인라인 세션이 시설물 관리 오른쪽, 검색바와 같은 상단 기준으로 배치되는지 확인한다.
   • 편집 도구바가 top: 84px로 이동했는지 확인한다.
2. 세션 크기와 스크롤
   • 변경분 0건에서 패널이 빈 상태 내용 높이만 차지하는지 확인한다.
   • 변경분 증가 시 패널이 최대 높이까지 늘어나는지 확인한다.
   • 최대 높이 이후 변경 목록에 세로 스크롤이 생기고 시설물 접기 토글을 가리지 않는지 확인한다.
3. 팝업 호환
   • 인라인 팝업 버튼으로만 기존 팝업이 열리는지 확인한다.
   • 팝업 정의의 460 x 640 크기와 기존 위치/메시지 계약이 유지되는지 확인한다.
4. 회귀
   • 인라인/팝업에서 변경분 선택, 취소, 되돌리기, 초기화가 동일 편집 상태에 반영되는지 확인한다.
   • 타입 검사와 git diff --check를 수행하고 선행 오류와 신규 오류를 구분한다.

9. 2026-07-15 사용자 화면 피드백 2차 검증 계획

1. 검색바 비가림
   • 인라인 세션 표시 전후 검색바의 시도·시군구·시설물·조회 컨트롤이 모두 노출되는지 확인한다.
   • 팝업 뷰 전환 시 검색바가 원래 중앙 위치로 돌아오는지 확인한다.
2. 도구바 종속 배치
   • GIS 편집 도구바가 인라인 세션 카드 바로 아래에서 같은 왼쪽 기준으로 시작하는지 확인한다.
   • 세션 변경분 증가 시 도구바가 카드 아래로 내려가고 카드 목록이 최대 높이부터 스크롤되는지 확인한다.
3. 인라인/팝업 상호 배타 전환
   • 인라인 팝업 클릭 직후 화면 인라인 세션이 사라지는지 확인한다.
   • 팝업의 화면에서 보기 클릭 시 팝업이 닫히고 인라인 세션이 같은 변경 상태로 복원되는지 확인한다.
   • 팝업 창의 닫기 버튼을 직접 눌러도 300ms 이내 인라인 세션이 복원되는지 확인한다.
4. 회귀
   • 취소·뒤로가기·초기화·변경분 포커스가 전환 전후 동일 상태를 사용하는지 확인한다.
   • 다른 Gis 사용 화면에서 검색바 기본 중앙 배치가 유지되는지 확인한다.

10. 2026-07-15 표시 영역 기준 최종 검증 계획

1. 검색바 고정
   • 편집 모드 진입, 변경분 추가, 팝업 전환 전후 검색바 좌표가 바뀌지 않는지 확인한다.
2. 상단 축약 세션
   • 변경분 0건에서 편집 세션이 검색바와 유사한 높이로 보이는지 확인한다.
   • 첫 변경분부터 작업 버튼과 목록이 나타나며 아래 방향으로 커지는지 확인한다.
   • 최대 높이 이후 목록에만 세로 스크롤이 생기는지 확인한다.
3. 하단 도구바
   • GIS 편집 도구바가 지도 하단 중앙 표시 영역에 고정되는지 확인한다.
   • 세션 확장과 팝업 전환에도 도구바 좌표가 유지되는지 확인한다.
4. 팝업 왕복
   • 팝업 열기 시 인라인 숨김, 화면에서 보기와 직접 닫기 시 인라인 복원을 재확인한다.

11. 2026-07-15 GIS 편집 토글 종료 회귀 검증

1. 변경분이 있는 상태에서 분석도구 GIS 편집을 두 번째 클릭한다.
2. 하단 GIS 편집 바와 인라인 편집 세션이 함께 사라지는지 확인한다.
3. 팝업 뷰 상태에서 GIS 편집을 끄면 팝업도 닫히는지 확인한다.
4. GIS 편집을 다시 켜면 기존 변경분이 인라인 세션에 복원되는지 확인한다.

12. 2026-09-16 ADD preview 유지 회귀 검증 계획

• 정적 검증
  • 통수위험 영역 레이어 초기화가 SN_GIS_EDIT_PREVIEW를 제거하지 않는지 확인한다.
  • GIS 편집 preview ref/source와 실제 map layer collection의 일치 여부를 확인한다.
• 브라우저 검증
  • 신규 관로 추가 완료 직후 흰색 외곽선, 진한 본선, 신규 추가 라벨이 보이는지 확인한다.
  • 편집 세션에서 NEW-*를 선택했을 때 동일 선형이 강조되는지 확인한다.
  • 통수위험 선택 상태 생성·변경·해제 전후에 신규 preview가 유지되는지 확인한다.
  • 우측 상세정보 패널 개폐와 입력 중에도 preview가 유지되는지 확인한다.
  • 저장 성공 후에는 preview가 제거되고 응답 fid의 최종본 레이어가 refresh되는지 확인한다.
• 회귀 범위
  • MOVE, VERTEX_EDIT, DELETE preview
  • 통수위험 영역·관로·맨홀 overlay
  • GIS 편집 종료와 세션 초기화
  • 기존 하수관로 WMS/WFS 레이어