# 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)