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

2026-10-09 01:22:07 +09:00
parent 83182e7f3e
commit a906be69a0
11 changed files with 2388 additions and 15 deletions
@@ -6,7 +6,7 @@

 ## 결정

-Unity에서 공유 구·대표 얼굴 배치·숫자·효과·프리팹을 만들고 Blender에서 작은 배경 소품을 제작한다. AI 이미지의 실제 채택은 투명 얼굴 atlas이며 한국어·숫자는 TMP로 표시한다. 원본과 Unity 입력 파일을 분리하고 출처·생성 입력·수정·검수·사용 조건을 보존한다.
+Unity가 대표 얼굴 배치·숫자·효과·프리팹과 상태 연결을 소유하고, Blender에서 구 몸체·대표 친구의 기사 장비·자연 배경을 제작한다. 2026-10-08 KST 사용자 승인 원본 2개·FBX 23개를 정확한 해시로 채택했다. 구 몸체는 반경 0.5를 유지하며 장비는 묶음당 한 벌이다. 기존 얼굴·마스크·빛 리본과 구 ID·위치·수학·저장 경계는 유지한다. AI 이미지의 실제 채택은 투명 얼굴 atlas이며 한국어·숫자는 TMP로 표시한다. 원본과 Unity 입력 파일을 분리하고 출처·생성 입력·수정·검수·사용 조건을 보존한다.

 ## 대안

@@ -15,3 +15,5 @@ Unity 기본 도형만 사용하면 제작 부담은 줄지만 배경 소품 표
 ## 결과

 FBX 방향·피벗·콜라이더와 PNG alpha·구 위의 표정 위치를 각각 검수해야 한다. 생성 이미지에 독점권을 주장하거나 도구가 공개하지 않은 모델 ID를 추측할 수 없다. 얼굴 장식은 별도 머리나 구가 아니며 숫자를 그림에 굳히지 않는다. 테마 소품·배치의 다양성은 학습 정답 조건을 늘리는 근거가 아니다.
+
+2026-10-09 KST 적용은 `SourceAssets/Models/{Heroes,Meadow}/active-adoption.json`과 `artifacts/verification/VisualUpgrade/ModelReview/user-approval.json`의 정확한 원본·FBX·Unity 참조 해시를 따른다. 초기 Unity 기본 구와 13개 Blender 소품은 제작 이력으로 보존한다. 현재 세 테마는 맑은 초원·꽃 언덕·바위 언덕이며 Garden/Cloud/Workshop 식별자를 바꾸지 않는다. import root 회전과 sRGB 재질 변환을 실제 Unity 결과로 검수한다. yaw 210도·pitch −45도·거리 15의 지면 아래 시점에서는 넓어진 지면 뒷면이 보드를 더 많이 가리며 실제 대조는 `artifacts/verification/VisualUpgrade/FinalProduct/EditorCapture/belowground-raycast-comparison.txt`에 있다. 카메라 제한이나 앞쪽 Collider 무시를 이번 미술 채택에 섞지 않고 후속 카메라 UX 결정으로 남겼다.
@@ -1,3 +1,15 @@
 # 미해결 문제

-2026-10-07 통합본의 규칙·화면 연결·저장·AVD 진행 검증 범위에서 재현되는 미해결 결함은 없다. 발견한 입력 검사·저장 관찰·녹음 수명 문제는 수정 후 실제 사례로 확인했다. 실기기 사용성·성능과 iOS는 아직 검사하지 않았으며 관찰된 결함으로 기록하지 않는다.
+2026-10-07 통합본의 당시 규칙·저장·AVD 진행 검증에서는 재현되는 미해결 결함이 없었다. 아래는 2026-10-09 KST 승인 모델 적용에서 확인한 제한이며 과거 결과를 모든 시점의 무결함 보장으로 확대하지 않는다.
+
+## 지면 아래 카메라에서 넓어진 지면이 보드를 가림
+
+재현: 실제 Main의 Stage21 초기 6구를 유지한 상태에서 기존 카메라를 yaw 210도·pitch −45도·거리 15로 이동한다. 기존 무제한 회전은 카메라가 지면 아래로 갈 수 있으며 새 넓은 초원 지면의 뒷면이 원래 작은 Island보다 보드를 더 넓게 가린다. 실제 원본 렌더러/새 지면의 같은 보드·카메라 A/B는 `artifacts/verification/VisualUpgrade/FinalProduct/EditorCapture/belowground-original-island.png`, `belowground-approved-clearing.png`에 있다.
+
+영향: 이 시점에서 일부 구·얼굴·숫자를 확인하기 어렵다. 카메라를 다시 위쪽으로 회전해 탐색할 수 있으나 모든 각도에서의 가독성을 보장하지 않는다. 초기 구를 이동하거나 구 ID·수량·저장을 바꾸지 않았다. 새 지면의 시각적 가림을 원래 지면과 동일하다고 주장하지 않는다.
+
+물리 대조: `belowground-raycast-comparison.txt`의 s21-b01..06 여섯 실제 Raycast는 양쪽 모두 보존된 PlaygroundIsland를 먼저 맞았다. 바닥 hit 거리는 12.24272~13.68166, 구 hit 거리는 13.46607~15.75898이었다. 원래 바닥 Collider를 새 지면 크기로 확대하지 않았고 앞쪽 hit를 우회하지 않는다. 기존 엄격한 55구 탐색·Collider pick·drag 검사는 통과했지만 일부 기록은 음의 pitch이며 모든 사례가 지면 위 시점이라는 뜻은 아니다.
+
+현재 미수정 이유: 이번 적용은 기존 카메라·pick·초기 배치 보존을 우선했으며 pitch 제한·입력 hit 우회·초기 구 이동을 추가하지 않았다. 카메라 회전 범위와 복귀 동작의 변경 여부는 별도 UX 결정으로 남겼다. 후속 결정 뒤 원본/새 지면·모든 구 탐색·직접 조작·저장 복원을 함께 검증한다.
+
+실제 스마트폰·태블릿의 손가락 조작·가독성·성능·발열·배터리, 5~7세 사용 관찰·학습 효과, iOS·스토어 게시의 미검증은 후속 범위이며 재현된 결함으로 계산하지 않는다.
@@ -1,5 +1,17 @@
 # 현재 구현과 검증 범위

+2026-10-09 KST. 한국어·Android·가로 화면·오프라인 체험판의 기존 30개 스테이지와 성공 후 자유 놀이를 유지하며 승인 모델을 적용했다. 아래 2026-10-07 제품 승인·검사 결과는 이전 외형의 이력이며 새 제품 전체의 사용자 승인으로 확대하지 않는다.
+
+청록색 구 몸체와 대표 친구의 투구·무딘 검·둥근 방패 한 벌, 정원 1..10의 맑은 초원·구름 11..20의 꽃 언덕·별 작업실 21..30의 바위 언덕을 연결했다. 원본 2개·새 FBX 23개와 Unity 재질 31개는 `SourceAssets/Models/{Heroes,Meadow}/active-adoption.json`에 해시로 연결한다. 기존 13 FBX·원본·후보 provenance는 보존한다. 기존 Garden/Cloud/Workshop 식별자, 30개 비시각 정의·구 ID/초기 위치/총량·GUID·44개 승인 음성·6표정·UI·폰트·Mixer·Core·저장은 유지한다.
+
+현재 제품 소스 `83182e7f3e86926bf130817d401a331829401fac`의 최종 실행은 `artifacts/verification/VisualUpgrade/FinalProduct/completion.json`과 `documentation-final-evidence-audit.json`에 연결한다. EditMode 103/103·PlayMode 52/52·Android 226/226, 하위 Fresh30 151·FinalBoundary 37·RapidBoundary 39·ContentBoundary 69개가 각각 종료 0이며 하위 수를 독립 제품 기능 수로 합산하지 않는다. 네 단계 실제 종료 0을 확인했다. 현재 APK SHA-256은 `BEE8E80E03C4205EDEBF616A18940D58654E9115FDC91EE0A80F47DEA91559EA`다. 스마트폰·태블릿 Editor 비율 화면과 실제 AVD 결과를 구분한다.
+
+기존 무제한 카메라의 yaw 210도·pitch −45도·거리 15에서는 넓어진 지면 뒷면이 보드를 더 많이 가린다. 실제 대조는 `artifacts/verification/VisualUpgrade/FinalProduct/EditorCapture/belowground-raycast-comparison.txt`에 있다. 엄격한 실제 구 탐색·Collider pick/drag·숫자 가독성 검사를 유지했지만 모든 시점 가독성을 보장하지 않는다. 기존 카메라·pick·초기 배치 보존을 우선했으며 카메라 범위·복귀 동작은 별도 UX 결정으로 남겼다.
+
+실제 Android 스마트폰·태블릿의 손가락 조작·가독성·성능·발열·배터리, 5~7세 사용 관찰·학습 효과, iOS·스토어 배포는 후속 범위다. SFX/BGM은 사용자의 첫 버전 제외 결정대로다.
+
+## 이전 제품 승인 이력 (2026-10-07)
+
 2026-10-07. 한국어·Android·가로 화면·오프라인 체험판을 구현했다. 수 세기 10개와 합체·분리·혼합 20개, 순차 해금·재플레이·도움·시범·성공 후 자유 놀이가 연결됐다. 자유 놀이는 공급·묶음 반납·빈 보드와 10개 한도를 지원한다. 미완료 퍼즐별 저장과 최근 자유 놀이 하나, 손상 파일 복구를 구현했다.

 독립 최종 검토에서 완료를 막는 문제와 남은 개선 지적이 없음을 확인했고, 사용자가 2026-10-07 최종 결과와 개발 문서를 승인했다.
@@ -23,4 +35,4 @@ Unity 자석 구·얼굴/마스크·연결 빛·망토, Blender 소품 13개,
 3. iPhone·iPad는 Mac/Xcode와 실제 기기를 확보한 뒤 별도 빌드·조작·저장 검증을 수행한다. 스토어 배포·서명·AAB 준비도 후속 범위다.
 4. 생활 장치·소풍 열차 등 영웅 미션과 곱셈·나눗셈 확장은 검토 아이디어다. 정해진 장치 배치나 새 성공 조건을 현재 퍼즐에 이미 구현한 것으로 취급하지 않는다.

-효과음·배경음악 추가는 후속 요청과 사용자 파일 선정으로 진행한다. 추가 언어, 계정·동기화, 여러 작품 보관함, 넓은 탐험 월드, 광고·결제는 현재 구현 범위가 아니며 도입 여부부터 별도로 결정한다. 현재 승인 범위의 실행을 막는 미해결 문제는 없다.
+효과음·배경음악 추가는 후속 요청과 사용자 파일 선정으로 진행한다. 추가 언어, 계정·동기화, 여러 작품 보관함, 넓은 탐험 월드, 광고·결제는 현재 구현 범위가 아니며 도입 여부부터 별도로 결정한다. 당시 승인 범위의 실행을 막는 미해결 문제는 없었다. 새 적용의 시점 제한은 위 현재 기록을 따른다.