docs: 승인 모델 채택과 최종 검증 기록

This commit is contained in:
NINI
2026-10-09 01:22:07 +09:00
parent 83182e7f3e
commit a906be69a0
11 changed files with 2388 additions and 15 deletions
+5 -1
View File
@@ -46,7 +46,11 @@ AndroidSmoke 전에 `Medium_Phone_API_37.0` AVD를 Android Studio Device Manager
## 새 자산 제작
모델을 바꿀 때만 Blender `5.2.2 LTS`에서 `tools/models/build_playgrounds.py`를 실행한다. 저장소 루트에서 Blender의 `--background --python tools/models/build_playgrounds.py`를 사용하면 `.blend`와 13개 FBX를 재작성한다. 자동 생성 전에 기존 소품 변경을 보존하고 실제 내보내기 diff·방향·바닥 피벗·콜라이더를 확인한다.
기존 `tools/models/build_playgrounds.py`는 과거 소품 원본과 13 FBX를 재작성하는 도구다. 현재 자연 테마를 실행하거나 검증하기 위해 재실행하지 않는다. 새 모델 제작 도구는 Blender `5.2.2 LTS`의 `tools/models/build_hero.py`와 `tools/models/build_meadow.py`이며 승인된 원본·FBX는 재생성 없이 사용한다. 새 후보를 만들 때만 별도 제작·검수 회차를 준비하고 기존 승인 바이트를 보존한다.
모델 채택은 원본 2개·FBX 23개의 사용자 승인 SHA와 실제 Unity 방향·재질·대표 장비·선택 경계를 확인한 뒤 수행한다. 대상이 제한된 `VisualUpgradeAssets.Apply`는 `MAGNETISM_VISUAL_APPROVAL`의 승인 JSON과 `MAGNETISM_VISUAL_EVIDENCE`의 별도 증거 경로를 요구하는 채택용 Editor API다. 정상 프로젝트 열기나 검사 전 준비 명령이 아니다. 후보 provenance의 과거 상태를 고쳐 승인으로 만들지 않고 별도 active-adoption에 원본·입력·도구·Unity 참조·검수 해시를 연결한다.
재검증 전에는 이전 Final의 로그·화면·PCM·APK 대응 기록을 해시 목록과 함께 고정 사본으로 보존한다. 같은 경로에 남은 과거 파일을 이번 결과로 세지 않는다. 현재 실행의 소스·UTC·설치 APK SHA가 맞는 phase/child 결과만 채택한다. 이번 이전 증거는 `artifacts/verification/VisualUpgrade/PreviousFinal/manifest.json`, 새 실행 연결은 `VisualUpgrade/FinalProduct/completion.json`에 있다.
음성 제작은 conda `qwen3-tts`의 CUDA 환경과 고정 1.7B CustomVoice/Sohee를 사용한다. 이미 승인된 44개는 그대로 사용한다. 새 대본이 필요할 때만 선택 ID를 별도로 생성한다.