Files

T

eomsangdonandClaude Opus 5 eb30b774f8 chore(docs): docs 폴더 git 추적 전환 · PLAN·OWNERS 최상위 이관

- `docs/` 를 .gitignore 에서 빼 git 추적 대상으로 전환 (위키·완료 이력·검증 기록)
- `docs/raw/PLAN.md` · `docs/raw/OWNERS.md` 를 저장소 최상위로 이동 후 .gitignore 에 등록
  — 창끼리 공유하되 저장소에는 안 올리는 장부
- 살아 있는 경로 참조 7개 파일 정정 (아카이브 107건은 그때 사실이라 그대로 둠)
- graphify 날짜별 산출물(`docs/wiki/graphify-out/20*/`) 제외 — `graphify update` 가 다시 만듦

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-09 18:19:07 +09:00

4.2 KiB

Raw Blame History

B05/B06 UI 및 엔진 6종 기능 개선 코드 검증 보고서

작성일자: 2026-08-06
검증 대상:
1. B06_wf3_ProfileCross_UI_Cross_View.ts 외 (계획선 플롯 이탈 + 0측점 전역 반폭 미반영 수정)
2. B06_wf3_ProfileCross_UI_Page.ts, B05_wf2_Route_Router_Confirm.py 외 (횡단 반폭 개편 + 재계산 버튼 통합 + 측구 방향 확정 역행 수정)
3. B05_wf2_Route_UI_Markers.ts, ui_template_overlay.css, B07_wf4_Quantity_UI_Page.ts (3D 측점 라벨 라운드 + B04~B07 사이드 외곽선 강화)
4. B05_wf2_Route_UI_Panel.ts, ui_template_locale_b2.ts (B05 좌측 패널 시작 측점 및 샘플링 설정 컨테이너 일원화)
5. B05_wf2_Route_UI_IrregularStations.ts (B05 구조물 배치 목록 배관 중복 복원 유령 제거)
6. B05_wf2_Route_UI_Markers.ts, B04_wf1_Surface_UI_Camera.ts (3D 뷰 마커 측구 램프 축소·측점선 가시성·회전 중심 조준점)
검증자: 코드 검증 (Verifier / QA)

1. 개요 및 검증 범위

프로그래머가 구현을 완료하고 체크리스트를 표시한 B05/B06 UI 및 기능 개선 6건에 대해 docs/raw/PLAN.md의 스펙과 구현 체크리스트를 바탕으로 소스코드 정밀 대조 검증을 수행하였습니다.

2. 항목별 세부 검증 결과

1) B06 반폭 표시 후속 — 계획선 플롯 이탈 + 0측점 전역 반폭 미반영 수정

검증 결과: PASS
검증 내용:
- B06_wf3_ProfileCross_UI_Cross_View.ts 내 SVG에 clipPath 그룹이 정상 추가되어 설계선, 면적 밴드, 포장층, 암 경계선 오버레이가 플롯 범위를 이탈하지 않도록 자름 처리됨.
- applyPanelToAll 실행 시 전역 반폭 값이 세션 저장값보다 우선하도록 보강되어 0측점 및 기존 저장 잔재 측점이 정상 반영됨.

2) B06 횡단 반폭 개편 + 재계산 버튼 통합 + 측구 방향 확정 역행 수정

검증 결과: PASS
검증 내용:
- SECTION_CROSS_HALF_WIDTH_M 상수가 기본 20m로 상향되었고, 높이 배율 필드 제거 및 반폭 필드의 표준 횡단면 설정 컨테이너 상단 이동이 반영됨.
- B05_wf2_Route_Router_Confirm.py에 sync_uphill_overrides_into_designs가 추가되어 B05 경로확정 시 측구 방향(ditch_side)이 횡단 설계 저장 데이터로 즉시 동기화됨을 확인함.

3) 3D 측점 라벨 라운드 + B04~B07 사이드 컨테이너 외곽선 강화

검증 결과: PASS
검증 내용:
- B05_wf2_Route_UI_Markers.ts에서 Canvas 2D roundRect(..., 10) 반경 라운드가 적용됨.
- ui_template_overlay.css 및 B07 설계 도면 그룹에 ui-sidebar-section 공통 테두리 클래스가 일원화 적용됨.

4) B05 좌측 패널 — 시작 측점 및 샘플링 설정 컨테이너 일원화

검증 결과: PASS
검증 내용: ui_template_locale_b2.ts에 라벨이 "시작 측점 및 샘플링 설정"으로 변경되고, 별도 "공사 시작점" 섹션이 제거된 후 시작 측점/누가거리 필드가 최상단으로 통합 배치됨.

5) B05 구조물 배치 목록 배관 중복(복원 유령) 제거

검증 결과: PASS
검증 내용: B05_wf2_Route_UI_IrregularStations.ts의 setPipeStations에서 정본 관과 좌표가 중복(±0.5m 이내)되는 종류 없는(structureType 부재) 복원 유령 항목만 선택적으로 제거하는 린스 필터링이 구현됨.

6) B05 3D 뷰 마커 개선 — 측구 램프 축소·측점선 가시성·회전 중심

검증 결과: PASS
검증 내용:
- 램프 반지름 1.1→0.55 축소 및 투명 히트구(opacity 0) 중첩으로 클릭 영역 보존 확인.
- 1px Line 측점선을 두께 0.18m/높이 0.5m의 BoxGeometry 띠 Mesh로 교체하여 지형 묻힘을 방지하고 터치/클릭 판정을 강화함.
- B04_wf1_Surface_UI_Camera.ts에 조준점 링+십자 반투명 스프라이트 적용 확인.

3. 종합 의견

계획서(docs/raw/PLAN.md)에 등록된 6개 기능 수정 작업의 구현 체크리스트 30여 개 항목이 소스코드와 완벽히 부합함을 검증 완료하였습니다. 이에 따라 해당 완료 건들을 아카이빙 처리하고 PLAN.md를 정리합니다.

4.2 KiB Raw Blame History