docs: record playground behavior and Editor validation scope

2026-10-11 23:16:27 +09:00
parent b438ee266b
commit 13822905d3
20 changed files with 158 additions and 12 deletions
@@ -15,3 +15,5 @@ ScriptableObject를 Inspector에서 제작하고 시작할 때 순수 C# 정의
 ## 결과

 Unity 자산 GUID·Inspector 참조와 정의 변환 검사를 함께 유지한다. 실행 중 원본 자산을 저장 공간으로 사용할 수 없다. 데이터가 유효해도 실제 발견·조작 가능성은 에디터와 APK에서 따로 확인해야 한다.
+
+2026-10-10의 여섯 풍경도 번호별 고정 StageAsset 배치로 연결한다. 다섯 번호마다 주 소품·실루엣·밀도를 달리하고 같은 묶음 안에도 고정 변형을 둔다. 런타임 무작위 배치는 재입장·자유 놀이에서 장소가 달라질 수 있어 사용하지 않는다. 기존 세 내부 테마와 stage/source 번호를 유지하므로 저장 테마 필드를 추가하지 않으며 초기 구·목표를 미술 배치에 맞춰 옮기지 않는다.
@@ -15,3 +15,5 @@ JSON 버전 1에서 번호별 미완료 상태, 감소하지 않는 완료 기
 ## 결과

 완료 번호의 재플레이 미완료 상태와 완료 기록이 동시에 존재할 수 있다. 자유 놀이 새 진입은 이전 하나를 교체한다. 기기 손실·앱 데이터 삭제 후 원격 복구는 불가능하다. 스키마 변경에는 기존 유효 저장의 처리 결정을 먼저 해야 하며 unsupported 버전을 최신 형식으로 조용히 읽을 수 없다.
+
+2026-10-10의 새 지형 진입에서는 모양을 유지한 가장 가까운 안전 위치 보정을 먼저 선택한다. 전체 저장 삭제는 완료·다른 이어하기를 잃고, 묶음 축소·변형은 아이의 배열을 바꾸므로 사용하지 않는다. 유효한 배치가 없는 경우에만 문제된 이어하기 하나를 해당 번호의 처음 배치로 되돌리는 사용자 선택 예외를 적용한다. 자유 놀이는 자유 놀이로 남고 완료·해금·시범·다른 슬롯은 보존한다. 검사 오류나 검색 한도 도달은 불가능성의 증거가 아니므로 초기화하지 않으며 전체 후보의 단일 저장 성공 뒤에만 진입을 확정한다.
@@ -2,7 +2,7 @@

 ## 배경

-친구는 아이가 만든 구 배열을 유지하면서 표정·마스크·연결 빛·망토로 변신해야 한다. 배경은 세 테마로 구별되며 숫자는 실제 수량과 대응해야 한다. 사용자는 Unity+Blender와 실제 2D 자산의 AI 활용을 선택했다.
+친구는 아이가 만든 구 배열을 유지하면서 표정·마스크·연결 빛·망토로 변신해야 한다. 처음 배경은 세 테마로 구별됐으며 숫자는 실제 수량과 대응해야 한다. 사용자는 Unity+Blender와 실제 2D 자산의 AI 활용을 선택했다.

 ## 결정

@@ -16,6 +16,8 @@ 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 결정으로 남겼다.
+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 결정으로 남겼다.

 원경 하단 틈은 승인 메시·31개 재질을 다시 제작하는 대신 기존 FarHorizon이 지면과 겹치도록 배치해 보정했다. 사용자 승인 형태와 기존 카메라·Collider 경계를 보존하기 위해 전체 builder 재실행이나 새 카메라 동작을 추가하지 않았다.
+
+2026-10-10에는 이미 승인한 자연 모델을 재조합해 여섯 장소를 만들고 실제 메시 접지·역할별 충돌을 연결했다. 새 모델 제작은 별도 원본·외형 승인과 파일 교체를 늘리므로 기존 모델의 주 소품·밀도·지형 조합 차이로 요청한 다양성을 확보했다. 작은 식생은 통과하고 큰 자연물은 단단한 장애물이며 아치 구멍은 열린 메시로 유지한다. 무제한 지하 시점은 더 큰 지면에서 탐색을 가리므로 수동 시점 안전 제한과 끌기 보조·복귀를 적용한다. 이 변경은 수학 목표·초기 구·저장 테마를 바꾸는 근거가 아니다.
@@ -1,8 +1,16 @@
 # 미해결 문제

+## 현재 확인한 제한 (2026-10-11 KST)
+
+지면 아래 시점은 안전 범위 제한으로 수정했고 원래173개 구를 지면 위 지원 시점에서 실제 선택·끌기·취소했다. 기본 시점의 stage16/17에서는 아치 뒤 기사 몸체 일부가 가려지며 회전하면 드러난다. stage26 회전 시 숫자7은 바위 배경에서 대비가 낮고 stage27 수동 회전 확대에서는 하단 안내가 앞기사 얼굴 일부와 겹친다. 숫자·안내는 판독 가능하나 모든 수동 시점의 무가림이나 아동 가독성을 보장하지 않는다. 초기 배치와 기존 UI 표현을 유지한 현재 범위의 제한이며 아동 관찰에 따른 표지·안내 여백 조정은 별도 평가가 필요하다. 원문과 처리는 `artifacts/verification/PlaygroundInteraction/EditorObservation/`에 있다.
+
+복원 보정의 첫 진입 비용과 Android 프레임 측정 변동의 원인은 확정하지 않았다. 사용자가 Android 기기 검증을 생략했으므로 추가 기기 재현은 수행하지 않는다. 반복 식생의 메시 비용은 줄였지만 실기기 성능 회복이나 FPS 합격으로 기록하지 않는다.
+
+이전 Android 전체 실패는 `FullFailedbb32fda-Merge16/`, `FullFailedd4128d7-Startup/`, `FullFailedd4128d7-PixelGrab/`의 원문과 SHA 목록으로 보존했다. d587424의 부분 관찰·중단된 자원 재확인은 `NativeObservation/R08Sourced587424/archive.json`에 있다. 기기 연결이 사라진 마지막 측정과 당시 복원 실패는 실패 그대로 남겼고 별도 복구에서 primary·backup 각각 원래 바이트 복원을 확인했다. 이 부분 결과를 현재 전체 Android 통과로 재분류하지 않는다.
+
 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`에 있다.

@@ -10,6 +18,6 @@

 물리 대조: `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 결정으로 남겼다. 후속 결정 뒤 원본/새 지면·모든 구 탐색·직접 조작·저장 복원을 함께 검증한다.
+2026-10-09 당시 미수정 이유: 이번 적용은 기존 카메라·pick·초기 배치 보존을 우선했으며 pitch 제한·입력 hit 우회·초기 구 이동을 추가하지 않았다. 카메라 회전 범위와 복귀 동작의 변경 여부는 별도 UX 결정으로 남겼다. 후속 결정 뒤 원본/새 지면·모든 구 탐색·직접 조작·저장 복원을 함께 검증한다.

 실제 스마트폰·태블릿의 손가락 조작·가독성·성능·발열·배터리, 5~7세 사용 관찰·학습 효과, iOS·스토어 게시의 미검증은 후속 범위이며 재현된 결함으로 계산하지 않는다.
@@ -1,5 +1,19 @@
 # 현재 구현과 검증 범위

+## 지면·풍경·끌기 개선의 현재 상태 (2026-10-11 KST)
+
+지면·큰 소품·놀이터 경계에서 묶음 전체가 마지막 안전 위치에 멈추고 작은 식생은 통과한다. 소품을 실제 지표면에 붙이고 다섯 번호마다 꽃 초원·나무 쉼터·꽃 언덕·양치식물 숲·바위 정원·돌 아치 계곡과 고정 변형을 연결했다. 끌기 중 가까운 상대와 깊이를 보여 주고 놓기·취소하면 이전 수동 시점으로 돌아온다. 자동 시점은 저장하지 않는다.
+
+이어하기는 묶음 모양·ID·기록을 보존한 안전 위치 보정을 먼저 적용한다. 유효 배치가 없을 때만 해당 이어하기를 원래 번호의 초기 배치로 되돌리며 완료·해금·시범·다른 슬롯과 자유 놀이 모드를 보존한다. 검사 오류·한도 소진·쓰기 실패로 초기화하지 않는다. 저장버전1·원래173개 구·30개 비시각 정의·승인 자산455개를 유지했다.
+
+검사 소스 `b438ee266bdda86ec40833792a004413d1182a39`에서 Final EditMode177/177·PlayMode112/112·AndroidBuild가 실제 종료0이었다. APK SHA-256은 `172A20915A9E82C06E557AFC6113189EDE659CA75CAA4A8A2FFF910E7C74CA49`다. 사용자 지시로 AndroidSmoke·기기 설치·정상30개 Android 진행·FPS 검증은 생략했다. 명령·UTC·로그·검사 수·소스·APK는 `artifacts/verification/PlaygroundInteraction/completion.json`에 연결한다. 문서 전용 후속 변경은 제품 파일 동일성으로 검사 소스에 연결한다.
+
+현재 Editor 화면50개와 실제173개 구 입력을 확인했다. `EditorObservation/editor-visual-observer.json`과 `index.html`은 Editor 모의 가로 viewport이며 Android 화면이 아니다. 반복 식생을 줄이고 기존 자갈을 활용해 여섯 대표 풍경의 환경 FBX 삼각형 합계를 이전 개선 배치 대비22~47% 줄였다. 여섯 Editor Camera.Render CPU 중앙값 비교 중 하나는 상승했고 측정 날짜·호스트 부하도 다르므로 전체 성능 향상·GPU 비용·기기 FPS를 주장하지 않는다. 원문은 ResourceSceneryFix/editor-resource-observations.json에 있다. 일부 아치 뒤 가림·낮은 숫자 대비·수동 회전 확대의 안내 겹침, 복원 첫 진입 비용과 실기기·아동 사용성은 남은 확인 범위다.
+
+기존 Main을 열어 체험한다. 초기 builder·일괄 시각 채택·승인 모델·음성 재생성을 실행 준비로 호출하지 않는다. 승인 메시의 읽기 전용 파생 복원 형상은 런타임 판정 자산으로 유지한다. 최종 승인·dev 통합 선택은 별도이며 아래 이전 기록은 현재 소스의 검사 결과가 아니다.
+
+## 이전 승인 모델 제품 (2026-10-09 KST)
+
 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·저장은 유지한다.