Aislo/docs/raw/plans/2026-08-06_plan_B05_B06_feature_updates.md

B05/B06 UI 및 엔진 6종 기능 개선 완료 이력 (2026-08-06)

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

배경: 사용자 보고(2026-08-06, 반폭 개편 d93bd6e 직후 화면 확인).

1. 반폭으로 지면은 잘리는데 계획선(설계선)이 플롯 밖으로 뚫고 나감 — 표시 자름이 지면 샘플 필터(crossPlotMetrics)만 거치고, 설계선·절성토 면적 밴드· 포장층·암 경계선 오버레이는 원래 좌표 그대로 그려서 생긴 문제.
2. 0측점이 전역 반폭을 안 따름 — 어제 개별 반폭 테스트 잔재가 design.display_half_width_m 로 영구 저장돼 있었고, 개별값이 전역보다 우선하는 구조라 [전체 측점 반영]을 눌러도 해당 측점은 고정.

구현 체크리스트:

• 1. 횡단 카드 SVG에 플롯 영역 clipPath 추가, 설계선·면적 밴드·포장층·암 경계선 오버레이를 clip 그룹 안에 그림 (B06_wf3_ProfileCross_UI_Cross_View.ts)
• 2. 오버레이 함수 시그니처 SVGSVGElement→SVGElement (clip <g> 수용, _UI_Cross_Design.ts·_UI_Cross_Areas.ts)
• 3. [전체 측점 반영] 시 개별 반폭 초기화 — 세션에 전역값을 전 측점에 명시해 저장된 개별값(display_half_width_m)보다 우선, 확정 시 저장값도 전역으로 덮임 (B06_wf3_ProfileCross_UI_Page.ts applyPanelToAll)
• 4. tsc --noEmit·prettier 통과
• 5. 실제 앱 검증 완료
• 6. 커밋 + push

---

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

배경: 사용자 지시 3건(2026-08-06). 반폭 기준 20m 적용, 높이 배율 제거, 재계산 버튼 삭제 및 전체 측점 반영으로 기능 통합, 측구 방향 확정 동기화 보강.

구현 체크리스트:

• A1. config: SECTION_CROSS_HALF_WIDTH_M 기본 15→20
• A2. B06 높이 배율 필드 제거, 렌더 배율 1 고정
• A3. 반폭 필드를 표준 횡단면 설정 컨테이너 [전체 측점 반영] 위로 이동
• A4. 재계산 버튼 삭제. [전체 측점 반영] 확장 및 regenerate에 grade_options 재구성 추가
• A5. 횡단 카드 개별 반폭 ◀/▶/↺(±1m·전역 복귀)
• A6. 횡단 카드 방위각 표기 제거
• A7. 확정·임시저장 시 개별 반폭 저장(design.display_half_width_m) 및 이월 처리
• B1. B05 경로확정 uphill 병합 시 저장 설계 재계산·저장(sync_uphill_overrides_into_designs)
• C1. tsc --noEmit·ruff format·prettier 통과
• C2. 실제 앱 검증 완료
• C3. 커밋 + push

---

3. 3D 측점 라벨 라운드 + B04~B07 사이드 컨테이너 외곽선 강화 (2026-08-06)

구현 체크리스트:

• 1. 3D 라벨 배경 fillRect → roundRect(반경 10) (B05_wf2_Route_UI_Markers.ts)
• 2. 외곽선 혼합비 강화 45%→25% 경계색(보조색 75%) + 공통 클래스가 테두리 두께·형태까지 소유 (ui_template_overlay.css)
• 3. B07 설계 도면 그룹에 ui-sidebar-section 적용 + 라운드·패딩
• 4. tsc --noEmit 통과 + prettier
• 5. 실제 앱 확인 완료
• 6. B04~B06 로컬 border 제거로 일원화

---

4. B05 좌측 패널 — 공사 시작점·측점 샘플링 컨테이너 일원화 (2026-08-06)

구현 체크리스트:

• 1. 로케일 라벨 변경 "측점 및 샘플링 설정" → "시작 측점 및 샘플링 설정" (ui_template_locale_b2.ts)
• 2. 시작 측점·누가거리 행을 sectionOptions 최상단으로 prepend, "공사 시작점" 섹션 제거 (B05_wf2_Route_UI_Panel.ts)
• 3. tsc --noEmit 통과 + prettier 변경 없음
• 4. 실제 앱 확인 완료

---

5. B05 구조물 배치 목록 배관 중복(복원 유령) 제거 (2026-08-06)

구현 체크리스트:

• 1. setPipeStations 복원 유령 제거(±0.5m·structureType 없음 조건) (B05_wf2_Route_UI_IrregularStations.ts)
• 2. tsc --noEmit 통과 + prettier 변경 없음
• 3. 실제 앱 확인 완료
• 4. 커밋 + push

---

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

구현 체크리스트:

• 1. 램프 절반(1.1→0.55, 띄움 0.6→0.3) + 투명 히트 구(1.1, opacity 0) (Markers.ts)
• 2. 측점선 Line → 납작 띠 BoxGeometry(길이×0.18×0.5, 띄움 0.8) + selectStation Mesh 대응 (Markers.ts)
• 3. 회전 중심 링+십자 조준점 스프라이트 (B04_..._UI_Camera.ts)
• 4. tsc --noEmit 통과 + prettier
• 5. 실제 앱 구동 확인 완료