Aislo/docs/raw/verification/2026-07-28_verify_B04_B05_Drainage_Watershed.md

검증 보고서: B04 2D 지도 성능 개선 및 B05 배수유역도 구축

• 검증 일시: 2026-07-28
• 검증자: 코드 검증자 (Verifier / QA)
• 대상 기능:
  1. B04 하단 2D 지도 렌더링 성능 최적화 및 UX 개선
  2. B05 선행 개선(패널 오버레이, 그래프 검정 버그, 구조물 측점 겹침)
  3. B05 하단 2단 우측 사이드 패널 및 2D 지도 오버레이
  4. B05 배수유역 산정 백엔드 엔진(측구 흐름 모델, 능선 분수령, 계획선 clip)
• 관련 주요 파일:
  • file:///D:/02_Software_Prog/%EC%9E%84%EB%8F%84%EC%84%A4%EA%B3%84%20%EB%B0%8F%20%EA%B2%AC%EC%A0%81%EC%9E%90%EB%8F%99%ED%99%94%20%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%A8%20%EA%B0%9C%EB%B0%9C/B04_wf1_Surface/B04_wf1_Surface_UI_MapRender.ts (423줄)
  • file:///D:/02_Software_Prog/%EC%9E%84%EB%8F%84%EC%84%A4%EA%B3%84%20%EB%B0%8F%20%EA%B2%AC%EC%A0%81%EC%9E%90%EB%8F%99%ED%99%94%20%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%A8%20%EA%B0%9C%EB%B0%9C/B04_wf1_Surface/B04_wf1_Surface_UI_MapViewer.ts (438줄)
  • file:///D:/02_Software_Prog/%EC%9E%84%EB%8F%84%EC%84%A4%EA%B3%84%20%EB%B0%8F%20%EA%B2%AC%EC%A0%81%EC%9E%90%EB%8F%99%ED%99%94%20%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%A8%20%EA%B0%9C%EB%B0%9C/B05_wf2_Route/B05_wf2_Route_UI_Drainage_Panel.ts (437줄)
  • file:///D:/02_Software_Prog/%EC%9E%84%EB%8F%84%EC%84%A4%EA%B3%84%20%EB%B0%8F%20%EA%B2%AC%EC%A0%81%EC%9E%90%EB%8F%99%ED%99%94%20%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%A8%20%EA%B0%9C%EB%B0%9C/B05_wf2_Route/B05_wf2_Route_Engine_Drainage.py (약 250줄)
  • file:///D:/02_Software_Prog/%EC%9E%84%EB%8F%84%EC%84%A4%EA%B3%84%20%EB%B0%8F%20%EA%B2%AC%EC%A0%81%EC%9E%90%EB%8F%99%ED%99%94%20%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%A8%20%EA%B0%9C%EB%B0%9C/B05_wf2_Route/B05_wf2_Route_Engine_Drainage_Watershed.py (545줄)
  • file:///D:/02_Software_Prog/%EC%9E%84%EB%8F%84%EC%84%A4%EA%B3%84%20%EB%B0%8F%20%EA%B2%AC%EC%A0%81%EC%9E%90%EB%8F%99%ED%99%94%20%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%A8%20%EA%B0%9C%EB%B0%9C/B05_wf2_Route/B05_wf2_Route_Router_Drainage.py (약 200줄)

---

1. 검증 결과 요약

구분	계획 요구사항	코드 구현 상태	검증 결과
700줄 제약	모든 단일 소스 파일 700줄 이내	MapRender(423줄), MapViewer(438줄), Drainage_Panel(437줄), Drainage_Watershed(545줄) 등	PASS
B04 렌더링 최적화	정규화 좌표 사전 투영, rAF, 뷰포트 컬링, LOD, 커서 줌	MapRender.ts 및 MapViewer.ts 내 구현 완료	PASS
B05 A단계 (선행 개선)	오버레이 전환, CSS import 버그 수정, 셀 겹침 가리기	Profile_Panel.ts, Style.css 수정 적용 확인	PASS
B05 B단계 (2단 패널)	하단 종단 패널 우측 도킹, 2D 지도, 노선 오버레이	Drainage_Panel.ts 구현 및 B04 MapRender 재사용	PASS
B05 C/C'/C''단계 (엔진)	DEM 보간, 측구 흐름 모델, 능선 분수령, 계획선 clip	Drainage_Watershed.py 및 Drainage.py 구현	PASS

---

2. 세부 검증 내역

1. B04 2D 지도 최적화:

   • B04_wf1_Surface_UI_MapRender.ts (423줄)에 사전 투영(Float64Array), affine 계수 변환, Douglas-Peucker LOD(0.75px), 뷰포트 컬링 함수 구성.
   • B04_wf1_Surface_UI_MapViewer.ts (438줄)에서 requestAnimationFrame 스로틀링, 캔버스 재할당 조건화, 마우스 커서 중심 Zoom 보정, 중간 버튼 automatic scroll 차단 처리 적용 확인.

2. B05 A단계 (선행 개선 및 UI 버그 수정):

   • b05-route-profile 오버레이 position: absolute; bottom: 0; height: 60dvh 적용으로 3D 뷰포트 영역 보존.
   • B05_wf2_Route_UI_Profile_Panel.ts에 B06_wf3_ProfileCross_UI_Style_Cross.css import를 추가하여 SVG 검정 배경 버그 해결.
   • 구조물 측점 셀 하이라이트 시 hideCoveredCells 및 is-covered/is-floating 클래스를 적용하여 셀 겹침 가림 문제 처리.

3. B05 B단계 (2단 사이드 패널 & 2D 지도):

   • B05_wf2_Route_UI_Drainage_Panel.ts (437줄)를 하단 패널 내부 우측 2단 패널로 도킹.
   • B04 MapRender를 100% 재사용하여 도엽 등고선/하천중심선/표고점 3개 레이어 렌더링.
   • prepareMetricPolyline을 통해 사업지 미터 좌표 노선 선형을 정규화 좌표계로 정합 오버레이.

4. B05 C, C', C''단계 (배수유역 산정 백엔드 엔진):

   • B05_wf2_Route_Engine_Drainage.py: 노선×세류 교차 탐색, 300m 간격 보충, 절토부 선택 알고리즘 준수.
   • B05_wf2_Route_Engine_Drainage_Watershed.py (545줄):
     • scipy griddata를 통한 10m 해상도 DEM 보간.
     • Whitebox fill_depressions 함몰 보정 및 D8 흐름 분석.
     • 측구 흐름 모델(종단 고개 기준 도로 셀 배정 및 사면 D8 하강 연결).
     • 계획선 경계 clip (_clip_to_plan_line)을 통한 유역 하측 경계 정확 정합.
     • 유역 제원(면적, 표고차, 유하거리) 정밀 산출 및 관경 수식 골격(estimate_pipe_diameter_mm) 배치.

---

3. 종합 의견

계획서(PLAN.md)에 명시된 B04 최적화 및 B05 배수유역도 구축(A, B, C, C', C''단계) 전체 항목이 기술 지침(700줄 이하, Surgical edit, 원본 무가공)을 철저히 준수하며 완벽하게 소스코드에 구현되었음을 확인하였습니다.