@things-factory/figure-ui 10.1.75 → 10.1.77

package/docs/v3-product-cutover.md

@@ -1,25 +0,0 @@
-# V3 제품 현황
-
-형식은 V3(`figure-v3-asset-1`) 하나다. V1·V2 형식은 2026-09-26 코드와 명세에서 제거했다.
-
-## 제품 코드
-
-- `client/modeller/v3-product-session.ts`: 모델 ID·로드·저장 경계를 V3 workspace에 연결한다. 다른 모델의 지연 응답을 버리며 로드 실패 시 이전 형상을 노출하지 않는다. UI/AI는 같은 리비전과 undo/redo를 사용한다. AI 편집은 요청 당시 context/revision을 필수로 받는다.
-- `client/modeller/v3-canvas.ts`: things-scene 편집 모드의 판 위에 평가된 V3 형상을 부품마다 `figure-v3-part` 컴포넌트로 세운다. 새 문맥에서 렌더링이 실패하면 이전 모델을 지운다.
-- `client/modeller/v3-editor.ts`: 부품 목록 · 캔버스 · 오른쪽 탭(속성 · 능력 · 움직임 · 판정 · 환경 · 이력). 실행 취소/다시 실행과 저장 연결.
-- `client/graphql/v3-store.ts`: 정본을 그대로 `saveFigureV3`로 보낸다.
-- figure-service의 `saveFigureV3`: 도메인 권한 검사, V3 검증, 정확한 이전 정본을 조건으로 하는 atomic UPDATE, 생성 요청 ID를 이용한 재시도. SQLite에서 지원하지 않는 행 잠금은 사용하지 않는다. 재지 않은 성능 점수/삼각형 수는 null로 둔다. 실제 운영 DB 저장 테스트는 아직 하지 않았다.
-- `client/pages/figure-v3-modeller-page.ts`: 위 요소를 묶는 페이지. `route.ts`의 `figure-modeller`와 `figure-v3-modeller`가 이 페이지를 연다.
-
-## 남은 항목
-
-1. operato-figure의 AI-dock과 figure-service 도구/제안 생성기를 V3 정본 및 승인된 트랜잭션 계약으로 연결한다. 페이지 이벤트만 추가한 것은 AI 통합 완료가 아니다.
-2. 발행 게이트, 썸네일, 카탈로그/배치 소비처가 V3 평가 결과를 사용하는지 확인한다.
-
-## 검증
-
-- figure-ui `npm test`: 251개 통과(2026-09-26).
-- SQLite in-memory 테스트: 테넌트 경계·이전 정본 비교·오래된 편집 거절. 실제 TypeORM 리졸버/제품 DB end-to-end 검증을 대체하지 않는다.
-- 브라우저 검사(`npm run test:browser`): 기즈모 끌기 · 자세 슬라이더를 실제 마우스로 조작한다.
-
-배포는 사용자가 담당한다.

package/test/v3-renderer.test.ts

@@ -1,24 +0,0 @@
-import {test} from 'node:test'
-import assert from 'node:assert/strict'
-import * as THREE from 'three'
-import {replaceV3Meshes} from '../client/modeller/v3-renderer.ts'
-import type {V3RenderPart} from '../client/modeller/v3-renderer.ts'
-const box=(id:string):V3RenderPart=>({id,shape:{provider:'box',dimensions:{width:100,height:200,depth:300}},pose:{r:[[1,0,0],[0,1,0],[0,0,1]],t:[0,100,0]},material:{token:'primary'}})
-test('V3 renderer replaces rather than accumulates; empty scene disposes old resources',()=>{
- const group=new THREE.Group();replaceV3Meshes(group,[box('a'),box('b')],{primary:'#123456'})
- assert.equal(group.children.length,2);let disposed=0
- const first=group.children[0] as THREE.Mesh;first.geometry.addEventListener('dispose',()=>disposed++)
- replaceV3Meshes(group,[box('c')],{primary:'#123456'});assert.equal(group.children.length,1);assert.equal(group.children[0].name,'c');assert.equal(disposed,1)
- replaceV3Meshes(group,[],{});assert.equal(group.children.length,0)
-})
-test('V3 renderer preserves scene on unsupported geometry and resolves pose/material',()=>{
- const group=new THREE.Group();replaceV3Meshes(group,[box('a')],{primary:'#123456'})
- const old=group.children[0],bounds=new THREE.Box3().setFromObject(group)
- assert.equal(bounds.min.y,0);assert.equal(bounds.max.y,200)
- assert.throws(()=>replaceV3Meshes(group,[box('b'),{...box('c'),shape:{provider:'unknown',dimensions:{}}}],{primary:'#123456'}),/Unsupported/)
- assert.equal(group.children[0],old)
- const p=box('glow');p.material={token:'primary',preset:'metal',transparent:true,emissive:{token:'primary',intensity:2,on:true}}
- replaceV3Meshes(group,[p],{primary:'#123456'})
- const material=(group.children[0] as THREE.Mesh).material as THREE.MeshStandardMaterial
- assert.equal(material.metalness,0.8);assert.equal(material.transparent,true);assert.equal(material.emissiveIntensity,2)
-})