62ddf3aea6
8개 크레이트 구현, cargo test 32개 전부 통과: - core: Mm/M 단위 newtype, UnitExt 리터럴, FeatureError - ir: GirderIR + 전 단면 파라미터(PSC-I/U/SteelBox/PlateI) serde JSON - dsl: Girder builder + 검증 (경간 범위·count·spacing) - kernel: GeomKernel trait + StubKernel (box mesh, AABB) - incremental: dirty-tracking IncrementalDb (salsa 업그레이드 경로 주석) - evaluator: 상태 없는 IR→kernel 브리지 - usd: USDA 1.0 텍스트 익스포트 (CimeryBridgeAPI·GirderAPI schema) - viewer: wgpu 22 + winit 0.30 컬러 삼각형 (Sprint 1 proof-of-concept) Sprint 2 다음 단계: - opencascade-rs로 StubKernel 교체 (실제 PSC-I sweep) - viewer에서 Girder Mesh 렌더 + 카메라 orbit Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.2 KiB
2.2 KiB
cimery/CLAUDE.md
cimery 코드베이스 개발 지침. 최상위 CLAUDE.md + Output/guides/cimery-dev-guide.md의 상세판.
크레이트 구조
crates/
├── core/ 단위 타입(Mm·M), 에러, 도메인 열거형 ← 모두 의존
├── ir/ IR 구조체 + serde JSON 직렬화 ← dsl·kernel·usd 의존
├── dsl/ Girder 등 Feature 빌더 + 검증 ← ir 의존
├── kernel/ GeomKernel trait + StubKernel ← ir 의존
├── incremental/ 증분 계산 DB (dirty tracking → salsa) ← kernel·ir 의존
├── evaluator/ IR → kernel 연결 레이어 ← incremental·kernel 의존
├── viewer/ wgpu 뷰어 (독립, 선택적 kernel 의존) ← kernel 의존
└── usd/ USD 텍스트 익스포트 ← ir 의존
의존 방향: core → ir → { dsl, kernel, usd } → incremental → evaluator
개발 규칙
- 단위 강제: 구조물
Mm(f64), 선형M(f64).UnitExttrait로 리터럴 지원. - 암묵 변환 금지:
From<Mm> for M존재하나 반드시 명시적으로 호출. - 결정론: 같은 IR JSON → 같은 기하. 연산 순서 고정.
- 테스트 4층: IR 스냅샷 (insta) · 기하 불변량 · 두 커널 cross-check · proptest.
- StubKernel: 실제 OCCT 전 기하 검증용. 박스 형태 반환. Sprint 1 전용.
- cargo check 우선: 먼저 컴파일되게 만들고, 최적화는 나중에.
빌드
# 전체 체크
cargo check --workspace
# 전체 테스트
cargo test --workspace
# 특정 크레이트
cargo test -p cimery-core
다음 스프린트 업그레이드 경로
incremental: manual dirty tracking → salsa (크레이트가 안정화되면)kernel: StubKernel → opencascade-rs (데스크톱) / OpenCascade.js (웹)viewer: 삼각형 렌더 → Girder Mesh 렌더 → 전체 씬dsl: 순수 builder →macro_rules!설탕 → proc-macro#[param]
참조 ADR
- ADR-001: 기술 스택 (Rust + Tauri/PWA, OCCT, wgpu)
- ADR-002: Feature DSL 아키텍처 (builder, IR, salsa, evaluator, 테스트 4층)
- ADR-003: 후속 결정 (Feature 카탈로그, LOD, UX)