From 6a80aac30b92bff564a72f1442c5e018ca01563d Mon Sep 17 00:00:00 2001
From: minsung <minsung.kim.hanmaceng@gmail.com>
Date: Thu, 16 Apr 2026 08:43:41 +0900
Subject: [PATCH] =?UTF-8?q?cimery-ifc=20README=20+=20usd=20=ED=85=8C?=
 =?UTF-8?q?=EC=8A=A4=ED=8A=B8=20unused=20import=20=EC=A0=95=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## crates/ifc/README.md 신설
- Phase 1~3c 현황표 (Sprint 33~37) + 미구현 로드맵
- 사용 예: 직접 구성 / viewer scene_params_to_ifc 변환
- IFC 뷰어 호환성 (BlenderBIM/Solibri/Navisworks/IfcOpenShell)
- GUID 설명, snapshot 테스트 가이드

## crates/usd/src/lib.rs
cargo fix 로 unused imports 자동 정리 (test 모듈).

cargo check --workspace --all-targets --features occt: 0 경고.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 cimery/crates/ifc/README.md  | 100 +++++++++++++++++++++++++++++++++++
 cimery/crates/usd/src/lib.rs |   6 +--
 2 files changed, 103 insertions(+), 3 deletions(-)
 create mode 100644 cimery/crates/ifc/README.md

diff --git a/cimery/crates/ifc/README.md b/cimery/crates/ifc/README.md
new file mode 100644
index 0000000..9598a27
--- /dev/null
+++ b/cimery/crates/ifc/README.md
@@ -0,0 +1,100 @@
+# cimery-ifc
+
+교량 IR → IFC4X3 Add2 STEP Part21 익스포터.
+
+## 기능 현황 (Sprint 33~37)
+
+| Phase | 내용 | Sprint |
+|-------|------|--------|
+| 1 | STEP Part21 writer + 핵심 계층(Project/Site/Bridge) + 거더·데크·피어·교대·받침 사각 profile | 33 |
+| 2 | PSC-I 실제 14점 단면(IfcArbitraryClosedProfileDef) + Skew 회전 + 헌치 + 방호벽(IfcRailing) | 34 |
+| 3a | Pset_BeamCommon (Reference·Span·LoadBearing·IsExternal) | 35 |
+| 3b | IfcAlignment (직선 horizontal + 평지 vertical 세그먼트) | 36 |
+| 3c (camber) | `camber > 0` 시 거더 10 세그먼트 분할 포물선 근사 | 37 |
+
+### 미구현 로드맵 (Phase 4+)
+- IfcLinearPlacement — 요소를 IfcAlignment 에 anchor
+- Pset_BearingCommon · Pset_SlabCommon
+- IfcElementAssembly 로 Pier(column+cap+footing) 그룹화
+- IfcPile (IFC4X3 신규, 현재 기초는 IfcFooting 통합)
+- 변단면 거더 IFC 반영 (현재 뷰어만)
+
+## 사용 예
+
+```rust
+use cimery_ifc::{BridgeExportParams, IfcSectionKind, export_bridge};
+
+let params = BridgeExportParams {
+    name:           "MyBridge".into(),
+    span_m:         40.0,
+    span_count:     3,
+    girder_count:   5,
+    girder_spacing: 2_500.0,
+    girder_height:  1_800.0,
+    slab_thickness: 220.0,
+    bearing_height: 60.0,
+    section_kind:   IfcSectionKind::PscI,
+    skew_deg:       15.0,
+    haunch_depth:   80.0,
+    show_parapets:  true,
+    show_joints:    true,
+    camber_mid_mm:  50.0,
+};
+
+let ifc_text = export_bridge(&params);
+std::fs::write("bridge.ifc", ifc_text).unwrap();
+```
+
+또는 viewer `SceneParams` 에서 자동 변환:
+
+```rust
+use cimery_viewer::project_file::scene_params_to_ifc;
+let ifc_params = scene_params_to_ifc(&scene_params, "MyBridge");
+let ifc_text = cimery_ifc::export_bridge(&ifc_params);
+```
+
+## IFC 뷰어 호환성
+
+IFC4X3_ADD2 스키마 준수. 다음 뷰어에서 열 수 있음:
+- **BlenderBIM** (bonsai.bim) — IFC4X3 전면 지원, 권장
+- **Solibri Office/Anywhere** — IFC4/IFC4X3 지원
+- **Navisworks 2025+** — IFC4X3 임포트 지원
+- **IfcOpenShell 기반 CLI 검증**: `ifcopenshell-tester bridge.ifc`
+- **bSI IFC4X3 validator (웹)** — 스키마 검증용
+
+제한:
+- `IfcBridge`·`IfcAlignment` 는 IFC4X3 전용 → IFC2X3 전용 도구(Revit 일부 버전)에서 미표시.
+- 거더가 camber > 0 일 때 10 개 세그먼트로 분할 — 뷰어에서 "수많은 빔" 으로 표시 (정상).
+
+## IfcGloballyUniqueId (GUID)
+
+UUIDv4 128비트를 buildingSMART base64 22자 (`0-9A-Za-z_$`) 로 인코딩.
+매 실행마다 새 GUID 생성 → **결정적 비교 시 snapshot 테스트는 `mask_guids()` 로 정규화** 필수.
+
+## 테스트
+
+```bash
+cargo test -p cimery-ifc            # 20 단위 + 8 snapshot
+INSTA_UPDATE=always cargo test ...  # snapshot baseline 갱신
+```
+
+## 크레이트 구조
+
+```
+src/
+├── lib.rs            공개 API (export_bridge, BridgeExportParams, IfcSectionKind)
+├── writer.rs         STEP Part21 writer — IfcWriter, Ref, lit/real/real3/ref_list
+├── guid.rs           IfcGUID 생성 (UUIDv4 → base64-22)
+└── bridge_export.rs  Bridge 계층 + 엔티티 생성 로직
+
+tests/
+├── snapshot_tests.rs 결정적 회귀 테스트 (GUID 마스킹)
+└── snapshots/        insta baseline .snap 파일
+```
+
+## 참조
+
+- buildingSMART IFC4X3 Add2: https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/
+- STEP Part21: ISO 10303-21:2016
+- ParaWiki 교각 파라미터 매핑: `wiki/교각 파라미터 카탈로그.md`
+- ADR-004: Sprint 25~39 아키텍처 결정 (D10~D13 IFC)
diff --git a/cimery/crates/usd/src/lib.rs b/cimery/crates/usd/src/lib.rs
index 47ce053..6e499a3 100644
--- a/cimery/crates/usd/src/lib.rs
+++ b/cimery/crates/usd/src/lib.rs
@@ -288,10 +288,10 @@ impl BridgeExporter {
 #[cfg(test)]
 mod tests {
     use super::*;
-    use cimery_core::{AbutmentType, BearingType, MaterialGrade, PierType, ColumnShape, SectionType};
+    use cimery_core::{MaterialGrade, SectionType};
     use cimery_ir::{
-        AbutmentIR, BearingIR, CapBeamIR, FeatureId, GirderIR,
-        PscISectionParams, SectionParams, WingWallIR,
+        FeatureId, GirderIR,
+        PscISectionParams, SectionParams,
     };
     use cimery_kernel::{PureRustKernel, StubKernel};