incremental_scene.rs — Sprint 8 scaffold 문서 갱신

역사 설명 + "현재 미사용" 명시:
- Sprint 8 PoC, Sprint 15 에서 IncrementalDb 5종 확장.
- Sprint 15+ 이후 lib.rs::rebuild_mesh() 가 IncrementalDb 직접 사용.
- 본 파일은 레퍼런스 예시로만 보존 (외부 참조 없음).

내부 TODO 주석 제거 (Sprint 9 는 이미 완료).

코드베이스 전체 TODO/FIXME 0건.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
minsung
2026-04-16 08:47:14 +09:00
parent 7e9b1a4f34
commit 8bcf65402c

View File

@@ -1,10 +1,14 @@
//! IncrementalBridge — Sprint 8 architectural scaffold. //! IncrementalBridge — Sprint 8 architectural scaffold (**현재 미사용**).
//! //!
//! Shows how IncrementalDb slots into the viewer pipeline. //! # 역사
//! Girder meshes are cached and only recomputed when the girder IR changes. //! - Sprint 8: IncrementalDb 파이프라인 연결 PoC.
//! Other features (DeckSlab, Bearing, Abutment) are rebuilt each frame for now. //! - Sprint 15: IncrementalDb 를 5종 Feature 로 확장.
//! - Sprint 15+: `lib.rs::rebuild_mesh()` 가 `IncrementalDb` 를 직접 사용 →
//! 본 스캐폴드는 레퍼런스 구현으로만 유지. 외부 참조 없음.
//! //!
//! Sprint 9: extend IncrementalDb with DeckSlab/Bearing/Abutment. //! # 제거 가능성
//! 향후 순수 `IncrementalDb` 기반 뷰어가 완전 안정화되면 본 파일 제거 가능.
//! 현재는 IncrementalDb 사용 패턴의 예시 코드로 보존.
use std::sync::Arc; use std::sync::Arc;
use cimery_core::{MaterialGrade, SectionType}; use cimery_core::{MaterialGrade, SectionType};
@@ -83,14 +87,12 @@ impl<K: GeomKernel + Clone + 'static> IncrementalBridge<K> {
} }
} }
// ── Build remaining scene (deck, bearing, abutment) ────────────────── // ── Build remaining scene (deck, bearing, abutment, pier, etc.) ─────
// Uses kernel directly; Sprint 9 will bring these into IncrementalDb too. // Sprint 15 이후 IncrementalDb 가 5종 Feature 전부 처리하지만, 본 scaffold 는
// build_bridge_scene 호출로 간단히 전체 씬을 반환. lib.rs 의 rebuild_mesh() 가
// 실제 뷰어의 증분 처리 경로. 본 함수는 레퍼런스 예시로만 유지.
let full = build_bridge_scene(self.kernel_arc.as_ref(), params)?; let full = build_bridge_scene(self.kernel_arc.as_ref(), params)?;
let _ = girder_meshes; // 계산은 해두되 full 이 이미 포함
// For Sprint 8 proof-of-concept: merge DB-sourced girders with the
// full scene. This replaces the girders already inside `full`.
// TODO Sprint 9: build_bridge_scene won't generate girders separately.
let _ = girder_meshes; // girders already included in full scene for now
Ok(full) Ok(full)
} }