README.md 업데이트

This commit is contained in:
2026-07-29 10:17:53 +09:00
parent 8ae7c45e9a
commit 41a94cc181
+13 -3
View File
@@ -12,8 +12,8 @@ Three.js 기반 npm workspace입니다.
| 항목 | 내용 |
|---|---|
| 기준일 | 2026-07-29 |
| 기준 commit | `3279ac099ec30bb52363710c73fbd4fe174b707b` |
| 기준 tree | 위 commit과 2026-07-29 작업 tree의 미커밋 변경 포함 |
| 기준 commit | `cadbd5fb60d300dbb3fdc891fdbbabfbcd5b9109` |
| 기준 tree | 위 commit 이후 이 README 변경 포함 |
| 대상 | `cyhan/dwg-dxf-viewer-sample` |
| 참조 | 형제 저장소 `hmwebviewer/README.md`의 분석 구조와 3D asset provenance |
| 검토 범위 | workspace 구조, 2D/3D 기능, source·test·build 설정, 입력 경계, npm dependency, WASM·font·decoder·fixture license |
@@ -141,7 +141,7 @@ single-thread `web-ifc.wasm`만 사용합니다.
| GLB | 지원 | 지원 | Draco/KTX2 지원. 손실 압축 허용오차와 원본 대비 fidelity 기준 없음 |
| GLTF | 지원 | 제한적 | 로컬 `.bin`·texture sidecar를 함께 해석하는 file-set session 없음 |
| OBJ | 지원 | 지원 | URL 경로의 MTL 자동 load 없음. 로컬만 MTL·texture sidecar 지원 |
| OBJ > 300 MiB | 지원 | 지원 | streaming path는 smooth normal과 MTL `Kd` color만 사용하고 texture·hard edge fidelity를 포기 |
| OBJ > 300 MiB | 제한적 | 지원 | URL에는 size 기반 streaming 분기가 없음. 로컬 streaming path는 smooth normal과 MTL `Kd` color만 사용하고 texture·hard edge fidelity를 포기 |
| FBX | 지원 | 지원 | 축·단위·animation·외부 texture 보존 계약 없음 |
| DAE | 지원 | 제한적 | 로컬 외부 texture sidecar 미지원 |
| IFC | 지원 | 지원 | geometry와 color만 Three.js object로 변환. property/semantic API와 원점 이동 기록 미보존 |
@@ -373,6 +373,15 @@ npm run test:e2e
npm run verify
```
2026-07-29 실제 검증 결과:
- workspace typecheck 통과
- Vitest 5개 file, 6개 test 통과
- 2D·3D production build 통과
- Playwright 16개 E2E 통과, 29.3초
- build 실패는 없지만 2D main bundle, Three.js, web-ifc와 decoder JS에
500 kB 초과 chunk 경고가 있음
현재 test가 확인하는 범위:
- 2D public package interface의 DXF parse
@@ -384,6 +393,7 @@ npm run verify
- 3D GLB, Draco GLB, OBJ, FBX, DAE, IFC, PLY sample render
- 2D/3D canvas dispose와 반복 page transition
- production subpath의 Draco·IFC decoder request
- 2D DWG/DXF와 3D GLB/PLY evidence screenshot
이 검증은 sample이 화면에 나타나고 runtime error가 없다는 smoke/contract 수준입니다.
engineering 정확도와 외부 배포 compliance를 승인하는 test는 아닙니다.