+=====================================================================+
|                                                                     |
|  결론: Three.js + That Open Engine + CesiumJS 를 권장한다            |
|                                                                     |
|  근거:                                                               |
|  1. Unity WebGL은 Task/Thread 전면 리팩터링 필요 → 1인월 불가능       |
|  2. IFC 파일을 Unity WebGL에서 직접 로딩 불가 (C++ 라이브러리 미동작) |
|  3. Three.js는 브라우저 네이티브, IFC 클라이언트 직접 파싱 가능       |
|  4. Autodesk APS(Forge) 뷰어도 Three.js 기반으로 구축됨              |
|  5. 일본 철도(JR 동일본/중앙) 실제 사례가 CesiumJS+3D Tiles 기반    |
|  6. AI 코딩 어시스턴트 활용 시 웹 개발 러닝커브 거의 없음            |
|  7. 신규 채용 시 JS 개발자 풀이 압도적으로 넓음                      |
|                                                                     |
+=====================================================================+

+------------------------------------------------------------------+
|                        개발팀 역량 맵                              |
+------------------------------------------------------------------+
|                                                                    |
|  [Unity PC]  ████████████████████████████████  매우 높음 (3인 모두) |
|  [그래픽스]  ████████████████████████████████  매우 높음 (3인 모두) |
|  [Web 개발]  ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░  낮음 (1인 약간)     |
|  [React/TS]  ████░░░░░░░░░░░░░░░░░░░░░░░░░░  약간 (1인)          |
|  [Claude AI] ████████████████████████████████  매우 높음           |
|                                                                    |
+------------------------------------------------------------------+

번들 크기 비교 (Brotli 압축 후)

Three.js (core)     : ██ 160KB
Three.js (BIM app)  : ████████████ 1.5MB
Unity (Built-in RP) : ████████████████████████████ 3.4MB
Unity (URP)         : ████████████████████████████████████████████████████ 6.3MB
Unity (BIM project) : ████████████████████████████████████████████████████████████████████████ 30MB+

              0     2     4     6     8    10    15    20    25    30 MB

기존 PC BIM 프로젝트 코드 분석

[IFC 파싱 모듈]
  └── Task.Run()으로 백그라운드 파싱  ─────── ❌ WebGL 불가
  └── Thread로 메시 생성              ─────── ❌ WebGL 불가

[네트워크 모듈]
  └── System.Net.Sockets              ─────── ❌ 완전 불가
  └── TCP/UDP 직접 소켓               ─────── ❌ 완전 불가

[파일 I/O 모듈]
  └── System.IO.File                  ─────── ❌ 로컬 파일 접근 불가
  └── FileStream                      ─────── ❌ 완전 불가

[렌더링 모듈]
  └── HDRP 사용 중이라면              ─────── ❌ URP로 전면 교체 필요
  └── URP 사용 중이라면               ─────── ✅ 호환

[비동기 처리]
  └── UniTask만 사용                  ─────── ✅ 동작
  └── Task + UniTask 혼용             ─────── ⚠️ Task 부분만 실패
  └── Task.Run() 내부의 UniTask       ─────── ❌ 전체 실패

100km x 100km 철도 BIM 데이터 구조 (예상)

Level 0: 전체 철도 노선 (100km 축척)
  ├── 지형 메시 + 항공사진 텍스처
  ├── 노선 중심선 (polyline)
  └── 역사 위치 마커 (point)

Level 1: 구간별 (10km 단위)
  ├── 트랙 상세 (레일, 침목)
  ├── 가공전차선 (전기설비)
  └── 신호기 위치

Level 2: 역사 단위 (1km 반경)
  ├── 건축 BIM (구조체, 마감)
  ├── 기계설비 (덕트, 배관)
  └── 전기설비 (케이블트레이, 분전반)

Level 3: 룸/구역 단위 (100m 반경)
  ├── 개별 장비 상세 모델
  ├── 부재별 속성 데이터
  └── 유지보수 정보

예상 데이터 크기:
  - 전체 IFC: 수 GB ~ 수십 GB
  - 최적화 후 웹용: 수백 MB ~ 수 GB
  - 한 번에 브라우저 렌더링 가능: ~500MB (최적화 시)

Unity WebGL에서의 대형 BIM 로딩 파이프라인

[1단계: 서버 전처리 (필수)]
  IFC → IfcConvert/IfcOpenShell → glTF 2.0 + JSON 메타데이터
  └── LOD 0 (원본), LOD 1 (50%), LOD 2 (25%), LOD 3 (바운딩박스)
  └── 구역별 AssetBundle 분리
  └── LZ4 압축 (LZMA는 WebGL 미지원!)

[2단계: Addressables 기반 로딩]
  └── 원격 서버에서 AssetBundle 다운로드
  └── IndexedDB 브라우저 캐싱
  └── 카메라 거리 기반 LOD 전환

[3단계: 메모리 관리]
  └── 4GB 한계 내 운용
  └── 비가시 구역 적극 언로드
  └── NativeArray<T>로 GC 부담 감소
  └── GC는 프레임당 1회만 → 루프 내 임시할당 최소화

Unity                                    Three.js
┌──────────────────────────┐            ┌──────────────────────────┐
│  [Scene View]  [Game]    │            │  [VS Code]               │
│  ┌──────────┐ ┌────────┐│            │  ┌──────────────────────┐│
│  │ 드래그앤  │ │ 실시간 ││            │  │ 코드 에디터          ││
│  │ 드롭으로  │ │ 프리뷰 ││            │  │ + AI 코드 생성       ││
│  │ 배치/회전 │ │        ││            │  │                      ││
│  └──────────┘ └────────┘│            │  └──────────────────────┘│
│  [Hierarchy] [Inspector] │            │  [브라우저 DevTools]     │
│  ┌────────┐  ┌─────────┐│            │  ┌──────────────────────┐│
│  │ 씬 트리 │  │ 컴포넌트││            │  │ Console + 3D 인스펙터││
│  │ + 선택  │  │ 속성    ││            │  │ + Spector.js         ││
│  └────────┘  └─────────┘│            │  └──────────────────────┘│
│                          │            │                          │
│  장점: 시각적 편집       │            │  장점: Hot Reload,       │
│  단점: WebGL 빌드 느림   │            │  AI가 에디터 역할 대체   │
└──────────────────────────┘            └──────────────────────────┘

시나리오: "IFC 파일을 로딩하고 클리핑 플레인으로 단면을 보고 싶다"

[Unity WebGL 경로]
  1. IFC를 glTF로 변환하는 서버 파이프라인 구축 (3일)
  2. Unity에서 glTF 로더 설정 (1일)
  3. 클리핑 셰이더 구현 (1일)
  4. WebGL 빌드 + 디버깅 (2일)
  총: ~7일

[Three.js + Claude Code 경로]
  1. Claude Code에게 "That Open Engine으로 IFC 뷰어 만들어줘" (30분)
  2. 자동 생성된 코드에 파일 드래그앤드롭 추가 (1시간)
  3. Clipper 컴포넌트 활성화 (10분 - 이미 내장)
  4. Vercel 배포 (10분)
  총: ~2시간

Week 1: 기반 구축
├── Day 1-2: Vite + Three.js + TypeScript 프로젝트 설정
│            That Open Engine 통합
│            (Claude Code 활용: ~2시간)
├── Day 3:   IFC 파일 클라이언트 로딩 구현
├── Day 4:   OrbitControls, 줌, 팬 카메라 컨트롤
└── Day 5:   기본 조명, 그림자, 환경맵

Week 2: BIM 기능
├── Day 6-7: 오브젝트 피킹 + IFC 속성 패널 (HTML/CSS)
├── Day 8:   클리핑 플레인 (단면 절단)
├── Day 9:   모델 트리 네비게이션 (IFC Spatial Structure)
└── Day 10:  기본 치수 측정 도구

Week 3: 인프라 특화
├── Day 11-12: CesiumJS 또는 평면 지형 위에 모델 배치
│              100km 스케일 테스트
├── Day 13:    멀티 모델 로딩 (지형 + 역사 + 트랙)
├── Day 14:    LOD + Frustum Culling 최적화
└── Day 15:    Origin Shifting (대형 좌표 처리)

Week 4: 마무리
├── Day 16-17: React UI 프레임워크 통합
│              (모델 리스트, 검색, 필터)
├── Day 18:    성능 최적화 (Instancing, Batching)
├── Day 19:    Vercel/Netlify 배포 + 데모 준비
└── Day 20:    문서화 + 데모 시연

예상 완성도: 70~80% (PoC로서 충분)

Week 1: 기반 구축 + 변환 파이프라인
├── Day 1-2: Unity 6 프로젝트 생성, WebGL 빌드 타겟 설정
│            첫 번째 WebGL 빌드 테스트
├── Day 3-5: ❗ IFC → glTF 변환 파이프라인 구축 (서버 사이드)
│            IfcConvert 설치, 배치 변환 스크립트
│            메타데이터 추출 (JSON)
│            ← 이것만으로 1주일 소요 가능

Week 2: BIM 기능 (변환 파이프라인 완성 전제)
├── Day 6-7: glTF 로더 + 카메라 컨트롤
├── Day 8:   오브젝트 선택 (변환 시 메타데이터 손실 위험)
├── Day 9:   단면 절단 셰이더
└── Day 10:  ❗ WebGL 빌드 디버깅 (Runtime silent failures)

Week 3: 인프라 특화
├── Day 11-12: 지형 메시 임포트 + 카메라 플라이스루
├── Day 13:    멀티 모델 로딩 (Addressables 설정)
├── Day 14:    ❗ WebGL 빌드 크기 최적화 (>100MB 위험)
└── Day 15:    ❗ 메모리 이슈 디버깅 (4GB 한계)

Week 4: 최적화 + 배포
├── Day 16-17: Threading 코드 리팩터링 (만약 기존 코드 사용 시)
├── Day 18:    크로스 브라우저 테스트
├── Day 19:    웹 서버 설정 (WASM MIME 타입)
└── Day 20:    ❗ 모바일 호환성 이슈 대응

예상 완성도: 40~50% (PoC로서 부족할 수 있음)
❗ 표시: 예상치 못한 이슈로 일정 지연 가능성이 높은 작업

기존 코드 재사용 가능성 분석

[재사용 가능한 코드]
  └── 순수 데이터 모델 (POCO 클래스)          ~20%
  └── 수학/유틸리티 함수                       ~10%
  └── UniTask 기반 비동기 코드 (조건부)        ~10%

[리팩터링 필요한 코드]
  └── Task/Thread 사용 비동기 코드             ~20%
  └── 네트워킹 모듈                            ~10%
  └── 파일 I/O 모듈                            ~10%

[완전 재작성 필요한 코드]
  └── IFC 파싱/로딩 모듈                       ~15%
  └── HDRP 의존 렌더링 코드 (해당 시)          ~??%
  └── 네이티브 플러그인 의존 코드               ~5%

결론: 최적의 경우에도 ~40%만 재사용 가능
      HDRP 사용 시 재사용률 더욱 감소

+=====================================================================+
|                                                                     |
|  권고 아키텍처: 철도 BIM 웹 뷰어 PoC                                |
|                                                                     |
|  ┌─────────────────────────────────────────────────────────────┐    |
|  │                    웹 브라우저                                │    |
|  │                                                              │    |
|  │  ┌──────────────┐  ┌───────────────────────────────────┐    │    |
|  │  │  UI Layer    │  │  3D Rendering Layer                │    │    |
|  │  │  (React +    │  │                                    │    │    |
|  │  │   Tailwind)  │  │  CesiumJS        Three.js          │    │    |
|  │  │              │  │  (지형 + 100km   (BIM 상세모델      │    │    |
|  │  │  - 모델 트리 │  │   스케일 컨텍스트) at 건물 스케일)  │    │    |
|  │  │  - 속성 패널 │  │                                    │    │    |
|  │  │  - 검색      │  │  ← 3D Tiles 스트리밍 →             │    │    |
|  │  │  - 측정 도구 │  │                                    │    │    |
|  │  └──────────────┘  └───────────────────────────────────┘    │    |
|  │                                                              │    |
|  │  ┌──────────────────────────────────────────────────────┐   │    |
|  │  │  Data Layer                                           │   │    |
|  │  │  - IFC Files → That Open Engine (WASM 파싱)           │   │    |
|  │  │  - Terrain → Cesium World Terrain (3D Tiles)          │   │    |
|  │  │  - Track → glTF (사전 변환)                            │   │    |
|  │  └──────────────────────────────────────────────────────┘   │    |
|  └─────────────────────────────────────────────────────────────┘    |
|                                                                     |
|  이 아키텍처는 TRANCITY(일본 JR 철도), WSB Engineering(미국)과      |
|  동일한 패턴이다.                                                    |
|                                                                     |
+=====================================================================+

[Unity PC 프로젝트]              [Three.js 웹 뷰어]
  │                                │
  │ 풀 기능 BIM 편집              │ 읽기 전용 뷰어
  │ 고성능 로컬 렌더링            │ 경량 웹 렌더링
  │ 대용량 모델 직접 처리         │ 스트리밍 기반
  │ 전문가용 (개발팀, 설계팀)     │ 범용 (현장, 고객, 관리자)
  │                                │
  └─── 서버를 통해 ────────────────┘
       데이터 공유
       (IFC → glTF/3D Tiles 변환)