d90ef2cfe1
All checks were successful
Publish ParaWiki / build-and-deploy (push) Successful in 29s
12개 주제 병렬 조사 기반 결정 통합: UI(Leptos+wgpu), IFC(ifc-lite-core), CI/CD(Gitea+GH 미러), USD(Codeless schema), Alignment 단계 도입, WASM plugin 3단계, Feature 카탈로그, FEM(MIDAS), LOD 300, 리본 12탭, 선택/필터, 설정 3계층 모델. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
293 lines
15 KiB
Markdown
293 lines
15 KiB
Markdown
---
|
||
id: ADR-003
|
||
title: cimery 후속 아키텍처 결정 — UI·IFC·CI/CD·USD·Alignment·Plugin·Feature 카탈로그·FEM·LOD·UX
|
||
status: accepted
|
||
date: 2026-04-14
|
||
related-wiki:
|
||
- "[[특징 형상 기반 모델링 FBM]]"
|
||
- "[[증분형 갱신 알고리즘 LPG]]"
|
||
- "[[선형 GIS 기반 좌표계]]"
|
||
- "[[PCE 파라메트릭 변경 엔진]]"
|
||
- "[[Revit 조립 단위 분류]]"
|
||
related-adr:
|
||
- "[[ADR-001-tech-stack]]"
|
||
- "[[ADR-002-feature-dsl]]"
|
||
principles: [비패밀리, 증분, 선형-GIS]
|
||
---
|
||
|
||
# ADR-003 — cimery 후속 아키텍처 결정 (12개 주제)
|
||
|
||
## 결정 요약표
|
||
|
||
| # | 주제 | 결정 |
|
||
|---|---|---|
|
||
| A1 | UI 프레임워크 | **Leptos** (UI) + `<canvas>` 위 **wgpu** (3D 뷰포트) |
|
||
| A2 | IFC 라이브러리 | **이원 전략** — 런타임 `ifc-lite-core`, 검증 `IfcOpenShell` |
|
||
| A3 | 빌드·배포 파이프라인 | **하이브리드 B** — Gitea 메인 CI, GitHub Actions 미러로 Win/macOS 빌드·서명. 중기 Cloudflare R2/Worker |
|
||
| A4 | USD 스키마 매핑 | **Codeless USD Applied API Schema** (`CimeryBridgeAPI` 등) + IFC alias 이중 태깅 |
|
||
| A5 | LandXML·IFC Alignment import | **단계 도입** — MVP 자체 포맷만 / v1.1 LandXML 자체 파서 / v2 IFC 4.3 |
|
||
| A6 | WASM plugin 승격 | **3단계** — MVP 내부 모듈 / v2 **Extism** / v3 **Component Model (WIT)** |
|
||
| B7+B8 | Feature 카탈로그 + 파라미터 | Must 6 (거더·슬래브·교각·교대·받침·선형) / Should 3 / Won't 철근·사장·현수 |
|
||
| B9 | FEM 연동 | **하이브리드 단계** — MVP MIDAS Civil NX API export / v2 IFC SAV 2.0 / v3 간이 빔·프레임 내장 |
|
||
| B10 | LOD·렌더 | **BIM LOD 300 고정** + graphics LOD = discrete 2단 + 동적 tessellation. v2 meshlet. |
|
||
| C11 | 리본·패널 레이아웃 | **12탭 구성** (Home·Alignment·Structure·Feature·Site&GIS·Annotate·Analyze·Construction·Insert·View·Manage·Modify) + contextual 탭 |
|
||
| C12 | 선택·필터 | Category = **Feature kind**. cimery 고유: 선형 스테이션 선택·규칙 선택·영향권 하이라이트 |
|
||
| C13 | 사용자 설정 | **VS Code 3계층 모델** (Default→User→Project→Project.local) JSON. 좌표계·tolerance는 Project 잠금 |
|
||
|
||
---
|
||
|
||
## A1. UI 프레임워크 — Leptos + wgpu
|
||
|
||
**결정:** UI 셸은 **Leptos**, 3D 뷰포트는 `<canvas>` 위 **wgpu** 직접 렌더.
|
||
|
||
**근거**
|
||
- Tauri v2는 본질상 WebView 기반 → Leptos 하나로 PWA·Tauri 양쪽 커버. 자산·패키징 단일화.
|
||
- Revit식 복잡 UI(리본·도킹·트리·속성창·IME·접근성)는 HTML/CSS 생태계 재사용이 현실적. egui의 immediate mode는 커스텀 위젯 비용 누적.
|
||
- Leptos의 **fine-grained reactivity**는 [[증분형 갱신 알고리즘 LPG]]의 부분 전파 모델과 정합.
|
||
- egui(이미 wgpu 통합 강점)도 고려했으나 **다국어·리본·속성창 밀도·Tauri/PWA 공유** 면에서 열세.
|
||
|
||
**기각:** Yew(VDOM 오버헤드·둔화), Dioxus(후보지만 Leptos 우위), egui(위 이유).
|
||
|
||
---
|
||
|
||
## A2. IFC 라이브러리 — 이원 전략
|
||
|
||
**결정:**
|
||
- **런타임(Rust+WASM):** `ifc-lite-core` (louistrue) — IFC4X3 스키마 876 엔티티, IFC5/IFCX 알파, WASM 일급 타깃.
|
||
- **검증·참조 구현(개발 파이프라인 전용):** `IfcOpenShell`.
|
||
|
||
**근거**
|
||
- `ifc_rs`는 알파·정체, Alignment/Bridge 미지원.
|
||
- IfcOpenShell LGPL은 WASM 배포에 까다로워 런타임 의존 비권장.
|
||
- 어댑터 레이어로 감싸 단일 유지보수자 리스크 격리 — 향후 교체 가능.
|
||
|
||
---
|
||
|
||
## A3. 빌드·배포 파이프라인 — 하이브리드 B
|
||
|
||
**결정:**
|
||
- **단기(MVP~v1):** Gitea Actions가 main CI(소스·PR·웹 배포), **GitHub Actions 미러**가 Windows/macOS Tauri 빌드·서명·릴리스 담당. 자동업데이트는 GitHub Releases 호스팅 `latest.json`.
|
||
- **중기:** Cloudflare **R2 + Worker**로 아티팩트·업데이터 엔드포인트를 자체 인프라로 회수.
|
||
|
||
**구성 요소**
|
||
- **Tauri v2 updater:** Ed25519 키쌍, `.sig` + `latest.json`, 개인키는 CI 시크릿.
|
||
- **Windows 서명:** **Azure Trusted Signing** 우선 (EV 하드웨어 토큰 불필요).
|
||
- **macOS 서명:** Apple Developer ID + notarization.
|
||
- **채널:** `nightly` / `beta` / `stable` = Git 태그 prefix + 별도 `latest-{channel}.json`.
|
||
- **웹(PWA):** 기존 Cloudflare Pages 확장 — `cimery-web.pages.dev`.
|
||
|
||
**기각:** Pure Gitea(macOS 러너·matrix 제약 부담), CrabNebula Cloud(벤더 락인, MVP 불필요).
|
||
|
||
---
|
||
|
||
## A4. USD 스키마 매핑 — Codeless Applied API Schema
|
||
|
||
**결정:** cimery 고유 개념을 **codeless USD applied API schema**로 정의하고, IR → USD evaluator가 Prim 단위 증분 export.
|
||
|
||
**핵심 매핑 (초안)**
|
||
|
||
| cimery Feature | USD Prim | Applied API |
|
||
|---|---|---|
|
||
| Alignment | `UsdGeomBasisCurves` | `CimeryAlignmentAPI` (stations·designSpeed·cantRef) |
|
||
| Bridge | `Xform` (`kind=assembly`) | `CimeryBridgeAPI` |
|
||
| Girder | `Xform` + child `Mesh` | `CimeryGirderAPI` (sectionType·spanLength·materialGrade) |
|
||
| Pier / Abutment | `Xform` + `Mesh` | `CimeryPierAPI` / `CimeryAbutmentAPI` |
|
||
| Bearing | `Xform` + `Mesh`, v2 `UsdPhysicsJoint` | `CimeryBearingAPI` |
|
||
| Deck Slab | `Mesh` | `CimeryDeckAPI` |
|
||
| Material | `UsdShade.Material` + MDL + UsdPreviewSurface | — |
|
||
| Coord / GIS | Root `Xform` | `CimeryGeoRefAPI` (EPSG·origin·rotation) |
|
||
|
||
**규칙**
|
||
- **이중 태깅:** 같은 Prim에 `CimeryGirderAPI` + `IfcGirder` 커스텀 속성 동시 적용 → AOUSD·IFC5 공식 스키마 등장 시 1-shot alias/migration.
|
||
- **Alignment 3층 보존:** 평면·종단·편경사를 sibling prims(`/Align/Horizontal`·`/Vertical`·`/Cant`)로 분리 `over`.
|
||
- **Assembly + Payload:** Bridge = `assembly`, Girder = `component`. 대형 모델은 payload로 lazy load.
|
||
- **파라메트릭 종속은 USD에 내보내지 않음** — derived geometry만. 규칙은 DSL IR에 유지 (ADR-002 재확인).
|
||
|
||
---
|
||
|
||
## A5. LandXML · IFC 4.3 Alignment import — 단계 도입
|
||
|
||
**결정:**
|
||
- **MVP (v0.1):** import 미구현. **자체 JSON 포맷만** 공식 입력 (ADR-002 R).
|
||
- **v1.1:** **LandXML 자체 파서** (`quick-xml` 기반). 범위: `<Alignment><CoordGeom>` 수평 + `<Profile>` 종단. 스파이럴은 polyline tessellation 수용.
|
||
- **v2:** **IFC 4.3 Alignment** — `ifc-lite-core`(A2) 활용, 부족 시 fork. 수평·종단·캔트만 매핑.
|
||
|
||
**근거**
|
||
- 거더교 본질은 **내부 파라미터 복잡도**(ADR-002 배경) — 선형 입력 품질이 MVP 차별점 아님.
|
||
- IFC 4.3 Alignment 실무 라운드트립 2026년 아직 미성숙(Civil 3D·OpenRoads 모두 부분 지원).
|
||
- LandXML이 실무 교환 빈도·자체 구현 부담에서 우위.
|
||
|
||
---
|
||
|
||
## A6. WASM plugin 승격 — 3단계 경로
|
||
|
||
**결정:**
|
||
1. **MVP~v1:** 내부 Rust 모듈. WASM 승격 보류. IR/DSL 안정화 선행.
|
||
2. **v2:** **Extism** 얇은 래퍼 (`cimery-plugin` crate). Feature trait → Extism host 함수 매핑. `#[param(...)]` 메타를 WIT 유사 스키마로 export. Tauri + PWA 듀얼 (`webxtism`).
|
||
3. **v3:** **Component Model + WIT** 마이그레이션. `GeomKernel`·`Feature` 인터페이스 표준화. ABI 레이어만 교체.
|
||
|
||
**승격 게이팅 기준 (셋 다 충족 전엔 내부 모듈 유지)**
|
||
- (a) 써드파티/사내 별도 팀이 Feature 공급 실수요 발생
|
||
- (b) 핵심 Feature 10개 이상 안정화
|
||
- (c) salsa query 경계와 plugin 경계 일치
|
||
|
||
---
|
||
|
||
## B7+B8. Feature 카탈로그 + 파라미터 구조
|
||
|
||
### MoSCoW 우선순위
|
||
|
||
| 우선순위 | Feature |
|
||
|---|---|
|
||
| **Must (MVP v1)** | Girder · Deck Slab · Pier · Abutment · Bearing · **Alignment**(입력) |
|
||
| **Should (v1.1)** | Cross Beam / Diaphragm · Expansion Joint · Parapet / Barrier |
|
||
| **Could (v2)** | Pile Cap / Foundation · Approach Slab · Drainage · Sign Mount |
|
||
| **Won't (v3+)** | **Rebar / Tendon** · Cable-stay · Suspension · Arch · Truss · Moveable |
|
||
|
||
### Must Feature 파라미터 (발췌)
|
||
|
||
**Girder:** `alignment_ref`, `station_start/end`, `offset_from_alignment`, `section_type` (PSC_I·PSC_U·Steel_Box·Steel_Plate_I), `section` (composite: height·flange·web·haunch 등), `camber`, `material`, `count_per_span`, `spacing`.
|
||
|
||
**Deck Slab:** `alignment_ref`, `station_start/end`, `width_left/right`, `thickness`, `haunch_depth`, `cross_slope`, `overhang_left/right`.
|
||
|
||
**Pier:** `station`, `skew_angle`, `type` (Wall·Single_Column·Multi_Column·Hammerhead·Portal), `column_count/spacing`, `column_section`, `height`, `cap_beam` (composite), `foundation_level`.
|
||
|
||
**Abutment:** `station`, `skew_angle`, `type` (Reverse_T·Counterfort·Wall·Semi_Integral·Integral), `parapet_wall`, `breast_wall`, `wing_wall_left/right`, `footing`, `bearing_seat_level`.
|
||
|
||
**Bearing:** `station`, `girder_ref`, `support_ref`, `type` (Elastomeric·Pot·Spherical·Rocker·Fixed·Expansion_Uni/Bi), `capacity_vertical/horizontal`, `plan_dimension_x/y`, `total_height`, `anchor_bolt`, `installation_level`.
|
||
|
||
단위: 구조물 `Mm`, 선형 `M` (ADR-002 C).
|
||
|
||
---
|
||
|
||
## B9. FEM 연동 — 하이브리드 단계
|
||
|
||
**결정:**
|
||
- **MVP (v1):** **MIDAS Civil NX API** 한방향 export. 국내 설계자 즉시 채택 가능. cimery = 모델링, MIDAS = 해석의 역할 분담.
|
||
- **v2:** **IFC 4.3 Structural Analysis View 2.0** export 병행. Robot·SOFiSTiK·Dlubal 커버. `AnalysisExport` trait 추상화.
|
||
- **v3+:** **간이 빔·프레임 내장 solver** (`fenris` + `diffsol`). 실시간 피드백(자중 처짐 등)용. 본격 해석은 외부 위임 유지.
|
||
|
||
**근거**
|
||
- [[PCE 파라메트릭 변경 엔진|PCE]] 교훈: 변환 지점이 많을수록 파라메트릭 논리가 죽음. 내장이 이상적이나 MVP 리스크 과대.
|
||
- Rust FEM 생태계(2026-04)는 연구/2D 수준, 교량 실무용 성숙도 부족.
|
||
- MIDAS는 Python/Grasshopper 연동 사례 풍부, HTTP/FFI로 호출 가능.
|
||
|
||
---
|
||
|
||
## B10. LOD · 렌더 전략
|
||
|
||
**결정:**
|
||
- **BIM LOD:** **MVP = LOD 300 고정** (설계자 인도·수량 산출 가능). LOD 350/400은 v2, 철근은 v2+.
|
||
- **Graphics LOD:** **discrete 2단 (근·원) + 동적 tessellation (편집 Feature만 고해상도)** 하이브리드.
|
||
- **컬링·인스턴싱:** Frustum culling + per-Feature instancing(동일 세그먼트 거더). `UsdGeomBasisCurves`가 아닌 인스턴스는 LRS station 기반 인스턴스 버퍼.
|
||
- **클리핑:** WebGPU `clip-distances` 기반 단면(section) — 교량 종단 단면 필수 UX.
|
||
- **메모리:** Memory64(Chrome) 전제로 웹 4GB+ 확보. 원본 B-rep은 데스크톱만 상주, 웹은 tessellated mesh + Feature 메타만.
|
||
- **v2:** meshlet (Nanite-like) 파이프라인. 교량 군·도심 회랑 단위.
|
||
|
||
**기각:** MVP에서 meshlet 전면 도입 (`nanite-webgpu` 가능성 입증되나 `atomic<u64>` 미지원·SW raster 복잡도로 MVP 부담).
|
||
|
||
---
|
||
|
||
## C11. 리본·패널 레이아웃
|
||
|
||
### 기본 워크스페이스
|
||
```
|
||
┌── QAT + 앱 메뉴 + Info Center ────────────────────┐
|
||
├── Ribbon (탭 + 패널) ────────────────────────────┤
|
||
├Properties (좌상) ─┬── Drawing Area ──┬─(도구)────┤
|
||
├Project Browser │ ViewCube(우상) │ │
|
||
├─(좌하) │ Nav Bar │ │
|
||
└── View Control Bar + Status Bar ────────────────┘
|
||
```
|
||
|
||
### 리본 탭 12개
|
||
|
||
| 순서 | 탭 | 용도 |
|
||
|---|---|---|
|
||
| 1 | **Home** | Select · Create · Modify 시작 허브 |
|
||
| 2 | **Alignment** | 선형·프로파일·측점·단면 |
|
||
| 3 | **Structure** | Girder · Pier · Abutment · Deck · Bearing |
|
||
| 4 | **Feature** | FBM 피처 라이브러리 · Place · DSL Editor |
|
||
| 5 | **Site & GIS** | 지형 · CRS · GIS import · Geo-reference |
|
||
| 6 | **Annotate** | 치수 · 태그 · 텍스트 · 심볼 |
|
||
| 7 | **Analyze** | 수량 · 간섭 · 리포트 |
|
||
| 8 | **Construction** | 단계 · 공정 · 4D · Shop Drawing · (Rebar v2) |
|
||
| 9 | **Insert** | IFC/LandXML link · CAD import · Point cloud |
|
||
| 10 | **View** | 2D/3D 뷰 · Sheet · Visibility |
|
||
| 11 | **Manage** | Project Info · Units · Standards · Shared Params |
|
||
| 12 | **Modify** | (contextual; 항상 맨 오른쪽) Clipboard · Geometry · Modify |
|
||
|
||
**contextual 탭:** Civil 3D식. 거더 선택 → "Modify | Girder" 탭이 Modify 오른쪽에 자동 활성화.
|
||
|
||
**단축키 관습 유지:** Esc·VG·WT·ZE·SD 등 2글자 키인, 탭 더블클릭 → 리본 최소화.
|
||
|
||
---
|
||
|
||
## C12. 선택 · 필터 개념
|
||
|
||
### Revit ↔ cimery 대응
|
||
|
||
| Revit | cimery | 비고 |
|
||
|---|---|---|
|
||
| Element | **Feature instance** (IR 노드) | 규칙 결과물 |
|
||
| Category | **Feature kind** (Rust 타입) | `#[param]` 메타에서 자동 추출 |
|
||
| Type(패밀리 타입) | **Feature template** (struct + 파라미터 세트) | CSV 라운드트립 단위 |
|
||
| Tab 호버 순환 | composite 트리 상하 순환 (2단 결정적) | 그래프 금지 → 모호성 0 |
|
||
| Selection Filter (수동) | **Named selection set** (JSON) | Git diff 가능 |
|
||
| Rule-based Filter | **Parameter predicate** (`flange_thickness > 180mm`) | 타입 안전 질의 |
|
||
| View Filter | **View preset** (filter + 오버라이드, TOML) | AI·diff 친화 |
|
||
| Temporary Hide / Isolate | 동일 UX | 세션 한정 |
|
||
|
||
### cimery 고유 확장
|
||
1. **선형 기반 선택** — "스테이션 120–180 m 구간의 모든 Girder".
|
||
2. **규칙 선택** — 생성 규칙 자체를 selector로 재사용.
|
||
3. **영향권 하이라이트** — salsa 의존성 그래프로 "이 파라미터 변경 시 무효화될 Feature" 시각화.
|
||
4. **Tab 범위 명시** — 2단 계층이므로 `instance ↔ composite parent` 2상태 토글.
|
||
|
||
---
|
||
|
||
## C13. 사용자 설정 — VS Code 3계층 모델
|
||
|
||
### 저장 레이아웃
|
||
```
|
||
~/.cimery/settings.json # User (전역, 장비별)
|
||
~/.cimery/keybindings.json # 키맵 분리
|
||
<project>/.cimery/settings.json # Project (Git 커밋)
|
||
<project>/.cimery/settings.local.json # 개인 override, .gitignore
|
||
```
|
||
**병합 순서:** Default ← User ← Project ← Project.local.
|
||
|
||
### 허용/제한 범주
|
||
|
||
| 범주 | 스코프 | 허용도 |
|
||
|---|---|---|
|
||
| 키맵 | User | 완전 허용 (Revit 기본값 + override) |
|
||
| 휠 방향·감도 | User | 허용 (반전 토글 + 계수 0.25–4.0) |
|
||
| 테마·언어·폰트·UI 스케일 | User | 허용 |
|
||
| 최근 파일·창 레이아웃 | User (state) | 자동 저장 |
|
||
| **표시 단위** | Project 기본 + User override | 설계 일관성 |
|
||
| 좌표계·선형 CRS·LRS | **Project 전용 (잠금)** | 데이터 무결성 |
|
||
| tolerance · snap | **Project 전용 (잠금)** | 재현성·솔버 결과 |
|
||
| 자동저장 주기 | User | 허용 |
|
||
| 텔레메트리 · 업데이트 채널 | User (global only) | 워크스페이스 override 금지 |
|
||
|
||
### 안전장치
|
||
- UI에 Project 전용 항목 잠금 표시.
|
||
- 키맵 충돌 검출기 (Revit 기본값 덮어쓸 때 경고).
|
||
- `"$schema"` · `"version"` 필드 초기부터 포함(마이그레이션 대비).
|
||
|
||
---
|
||
|
||
## 후속 결정 필요
|
||
- [ ] 첫 Feature 엔드-투-엔드 프로토타입 (Girder · DSL → IR → 기하 → USD)
|
||
- [ ] Revit 조작 관습 표 `raw/tools/revit/` 수집
|
||
- [ ] IFC 5 + USD 전환 자료 `raw/standards/` 수집 (ADR-002에서 이미 예정)
|
||
- [ ] MIDAS Civil NX API 접근 권한·개발 키
|
||
- [ ] WASM plugin 승격 게이팅 기준 달성 시점 감시
|
||
|
||
## 검토 시점
|
||
- 첫 Girder 엔드-투-엔드 동작 시 ADR 전체 재검토.
|
||
- AOUSD AECO 스펙 발표(2026~27 예상) 시 A4 재검토.
|
||
- Component Model 브라우저 성숙(~2027-2028) 시 A6 v3 승격.
|
||
- IFC 4.3 Alignment 실무 라운드트립 성숙 시 A5 조기 도입.
|