--- title: SceneControlManager·UIManager 구현과 씬 예제 검증 date: 2026-11-01T08:59:44.054Z version: v1.0.10 status: 작업 중 state: progress project: sampleprojectforunity type: 작업 메뉴얼 report_kind: manual category: 순차 작업 · 반복 QA summary: Bootstrap 씬을 제거하고 Addressable 공통 초기화 프리팹으로 전환하여 A/B 직접 Play와 중복 방지를 검증합니다. format: tracefolio-v2 priority: normal manual_id: scene-ui-implementation-20261101 round: 4 manual_state: active payload: ../assets/submissions/2026-11-01-manual-scene-ui-implementation-20261101-20261101085944054-v1.0.10.json --- ## 목표와 완료 기준 요청한 런타임 시스템과 씬 내 예제를 구현·적용·검증한다. 완료 기준: 컴파일, Addressables 콘텐츠 빌드, 플레이어 빌드, 왕복 전환·중복 요청·팝업·해제·실패 복귀 검증, 실제 실행 캡처, 공개 보고서 확인 후속 4회차 · 순차 진행 · 전체 13개 · 이번 실행 T11, T12, T13 ## 순차 작업 메뉴얼 | 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 | | --- | --- | --- | --- | --- | --- | | T01 | 런타임 시스템 구현 | 프로젝트 작성 규칙에 맞춰 씬·UI 카탈로그와 관리자를 구현한다. | 핸들 소유권·전환 직렬화·UI 수명·실패 복구 구현 | Unity 컴파일 및 소스 책임·해제 경로 검토 | 완료 | | T02 | 씬과 UI 예제 생성 | Bootstrap·테스트 씬 2개와 UI 프리팹·Addressables 그룹을 생성한다. | 씬 안의 버튼으로 전환·팝업·실패 복귀 시연 | 에셋 참조·콘텐츠 빌드·플레이어 빌드 | 완료 | | T03 | 실제 실행 QA | 사용자 허용 후 창을 표시하고 전체 실행 시나리오와 렌더 완료 뒤 실제 화면을 검증한다. | 구체적인 실행 결과·실제 화면 확보 | EventSystem 클릭·Escape·실패 복구·개수 검사와 비검정 캡처 및 상태 표시·가독성을 실제 실행에서 대조한다. | 완료 | | T04 | 문서와 공개 보고 | 사용 예제·실행 방법·검증 근거를 문서화하고 아카이브에 게시한다. | 문서 검증과 공개 보고서·첨부 확인 | 문서 빌드·링크 검사·배포·HTTP 본문 검증 | 완료 | | T05 | 기존 프로젝트 폴더로 통합 | Scenes·Datas·Prefabs/UI·Material과 Management·UI·SampleScene으로 에셋·메타를 함께 이동하고 생성기·설정·문서를 고친다. | GUID·직렬화 참조 보존, 독립 Examples 트리 제거, 기존 게임 파일 보존 | 이동 전후 GUID 대조, 이전 경로 잔존 검색, 설정·문서 검사 | 완료 | | T06 | 통합 배치의 실제 실행 회귀 | 이동된 에셋에서 콘텐츠·플레이어를 빌드하고 실제 창에서 57개 QA와 화면을 확인한다. | 이동된 경로의 번들·실행 성공과 실제 화면 확보 | 실제 빌드·실행 결과와 원본 대조·캡처 검사 | 완료 | | T07 | 후속 결과와 선호 반영 | 문서·보고서·완료 메뉴얼을 게시하고 기존 구조 우선 선호의 중복 여부를 검토해 지침에 반영한다. | 공개 결과·첨부 확인 및 지침 처리 기록 | 공개 배포·본문·첨부, 지침 차이·동기화 확인 | 완료 | | T08 | 공통 초기화 프리팹으로 전환 | 공통 루트를 Addressable 프리팹으로 옮기고 양쪽 씬 진입점과 네이티브 초기 씬 등록·정리를 구현하며 Bootstrap 씬을 제거한다. 씬 저장 전 카탈로그를 저장하고 씬을 연 뒤 에셋을 재조회한다. | 각 씬 직접 Play, 현재 씬 재로드 없음, 공통 매니저 한 번 생성 | 실제 Unity 컴파일·에셋 생성·참조와 Bootstrap 제거 대조 | 완료 | | T09 | A/B 직접 Play와 중복 회귀 | Editor에서 A와 B를 각각 직접 Play하고 실제 번들 플레이어도 실행하여 매니저 수·동일 객체·누적 생성 횟수를 비교한다. | 두 직접 Play 성공·반복 후 루트/매니저/EventSystem 단일·실제 화면 확보 | Editor 세션별 결과와 sceneLoaded 및 반복 전환 스냅샷·플레이어 렌더 대조 Editor QA는 독립 키보드와 Game View 입력 전달 설정을 사용한다. 플레이어는 실제 런타임 입력 경로를 별도 검사한다. | 완료 | | T10 | 문서·공개 보고·정리 | 새 실행 방식 문서와 결과·메뉴얼을 게시하고 임시 프로젝트를 정리한다. | 공개 보고서와 실제 첨부 확인·임시 검증 파일 정리 | 문서 검사·배포·개별 본문/첨부 해시 확인 | 완료 | | T11 | 실제 씬 흐름과 편집 가능한 UI 적용 | 기존 Playground를 보존하면서 Splash와 정면 캐릭터 Stage를 만들고 UI 프리팹과 버튼 이벤트를 직렬화한다. 이전 UI 생성 도구와 예제 전용 에셋을 정리한다. | Splash 자동 진입 → Playground ↔ CharacterStage, 편집 가능한 UI, 초기화 공통 프리팹 재사용 | 씬·프리팹·참조·기존 변경 대조와 Unity 컴파일·콘텐츠/플레이어 빌드 | 진행 | | T12 | 실제 전환·정면 캐릭터·중복 실행 QA | Splash 시작과 Playground/CharacterStage 직접 Play, 버튼 전환·팝업·실패 복귀·반복 전환을 검증하고 실제 화면을 캡처한다. | 실제 전환·정면 표시와 매니저/EventSystem 단일성·기존 플레이 제어 유지 | 에디터 및 그래픽 플레이어 실제 실행, 입력·씬 소유권·UI 오브젝트·화면 대조 | 대기 | | T13 | 문서·공개 결과·임시 파일 정리 | 새 실행 구조를 문서에 반영하고 실패·수정 이력을 보존한 공개 보고서와 완료 메뉴얼을 게시하고 검증 복사본을 정리한다. | 문서검사·개별 공개 보고서·실제 화면 확인·임시 도구 제거 | 문서 빌드/링크·공개 배포/본문/첨부 검증 | 대기 | ## QA 반복 기록 ### Q01 · step · 2026-11-01T06:35:05Z 원본 배치 실행 제한 확인 - T01 r1 · blocked: 원본 Unity 에디터가 프로젝트 잠금을 소유하여 새 배치 실행 종료 · 근거: Unity 로그 HandleProjectAlreadyOpenInAnotherInstance; 기존 프로세스를 종료하지 않고 복사본으로 진행 ### Q02 · step · 2026-11-01T06:47:54Z 첫 컴파일 및 콘텐츠·플레이어 빌드 통과 - T01 r1 · pass: 런타임 소스 Unity 컴파일 성공 · 근거: 첫 실제 Unity 플레이어 빌드 성공 로그 - T02 r1 · pass: 예제 콘텐츠·Windows 플레이어 빌드 성공 · 근거: 첫 플레이어 빌드 155815979 bytes ### Q03 · step · 2026-11-01T06:48:30Z 첫 캡처 QA 실패 보존 - T03 r1 · fail: 기능 48개 통과했으나 배치 캡처 5개가 동일한 검은 이미지 · 근거: 프로젝트 docs/verification/scene-ui/run-1/results.json 및 visual-check.json ### Q04 · step · 2026-11-01T06:50:31Z 숨김 그래픽 캡처 QA 실패 보존 - T03 r1 · fail: 기능 52개 통과했으나 숨김 캡처가 검은 이미지 · 근거: 프로젝트 docs/verification/scene-ui/run-2/results.json 및 visual-check.json ### Q05 · step · 2026-11-01T06:53:40Z 창 표시·프레임 끝 캡처로 복구 - T03 r1 · pass: 57개 통과·실제 화면 확인, 상태 표시 한 프레임 지연은 다음 수정에서 보강 · 근거: 프로젝트 docs/verification/scene-ui/run-3/results.json 및 visual-check.json ### Q06 · regression · 2026-11-01T06:55:27Z T03 r2 최종 회귀와 실제 화면 대조 - T03 r2 · pass: 57개 통과·오류 0개, 상태 표시까지 올바른 5개 화면 검토 · 근거: ../assets/scene-ui-20261101/results.json; visual-check.json ### Q07 · regression · 2026-11-01T06:58:08.298Z 최종 변경 뒤 소스·에셋 대조 근거 검토 - T01 r1 · pass: 최종 소스 16개 해시 일치와 최종 Unity 컴파일 성공 확인 · 근거: source-comparison.json; 최종 빌드 성공 155820007 bytes - T02 r1 · pass: 최종 생성 에셋·메타 24개 해시 일치, 실제 플레이어 빌드·실행 확인 · 근거: assets-comparison.json; run-4/results.json ### Q08 · step · 2026-11-01T07:00:50.140Z 공개 보고서 및 실제 첨부 대조 - T04 r1 · pass: Actions 배포 성공·개별 보고서 HTTP 200·이미지 5개 해시 일치·57개 QA JSON 확인 · 근거: ../assets/scene-ui-20261101/publication-check.json; Actions run 41282943235 ### Q09 · final · 2026-11-01T07:00:50.141Z 요청 전체 범위의 현재 버전 최종 QA - T01 r1 · pass: 현재 최종 소스 Unity 컴파일 및 소유권·정리 경로 검토 완료 · 근거: 최종 Unity 빌드·source-comparison.json·assets-comparison.json - T02 r1 · pass: Addressables 콘텐츠·Windows 빌드 성공, 소스 16개·에셋 24개 대조 일치 · 근거: 최종 Unity 빌드·source-comparison.json·assets-comparison.json - T03 r2 · pass: 최종 실행 57개 통과·오류 0개, 실제 5개 화면 검사 완료 · 근거: 최종 57개 결과·5개 실제 화면·visual-check.json - T04 r1 · pass: 문서 검사와 중앙 아카이브 배포 성공. 개별 보고서 HTTP 200·본문·공개 이미지 5개 해시·57개 QA JSON 확인. · 근거: 공개 보고서·publication-check.json ### Q10 · step · 2026-11-01T07:15:08Z 첫 문서 갱신 오류 보존 - T05 r1 · fail: 문서 파일 열기 UNKNOWN 오류로 빌드 중단·페이지 빌드 시각 불일치 검사 실패. 원인은 미확인. · 근거: 문서 build.mjs 및 validate.mjs 실행 결과. 기존 파일 속성 확인 후 전체 재실행. ### Q11 · step · 2026-11-01T07:17:01Z 이동과 참조·문서 재검증 통과 - T05 r1 · pass: 파일 31개 GUID 보존, 카탈로그 참조 7개 정상, 기존 Playground·HUD·manifest·Prefabs 그룹 보존, 현재 소스·설정의 이전 경로 없음, 문서 검사 통과 · 근거: 프로젝트 docs/verification/scene-ui/layout/guid-check.json, references.json, unchanged.json; 문서 27개·908 링크 검사 통과 ### Q12 · regression · 2026-11-01T07:22:20.392Z 이동 후 실제 실행과 파일 대조 - T06 r1 · pass: 이동된 에셋 그대로 빌드 성공, 원본 32개 파일 해시 일치, 실제 QA 57개·오류 0개·화면 5장 통과 · 근거: ../assets/scene-ui-layout-20261101/results.json; build-comparison.json; visual-check.json ### Q13 · step · 2026-11-01T07:27:11.357Z 후속 보고서·지침 공개 확인 - T07 r1 · pass: 기존 구조 우선 규칙 1개 추가·Sync 푸시·3개 파일 해시 일치, 공개 후속 보고서 HTTP 200·이미지 5개 해시 일치 · 근거: ../assets/scene-ui-layout-20261101/publication-check.json; instructions.json; Actions 41284710020 ### Q14 · final · 2026-11-01T07:27:11.358Z 원래 전체 작업과 후속 통합 작업의 현재 버전 최종 QA - T01 r1 · pass: 현재 최종 소스 Unity 컴파일 및 소유권·정리 경로 검토 완료 · 근거: 기존 QA 및 이동 후 57개 실제 회귀 검사 - T02 r1 · pass: Addressables 콘텐츠·Windows 빌드 성공, 소스 16개·에셋 24개 대조 일치 · 근거: 기존 QA 및 이동 후 57개 실제 회귀 검사 - T03 r2 · pass: 최종 실행 57개 통과·오류 0개, 실제 5개 화면 검사 완료 · 근거: 기존 QA 및 이동 후 57개 실제 회귀 검사 - T04 r1 · pass: 문서 검사와 중앙 아카이브 배포 성공. 개별 보고서 HTTP 200·본문·공개 이미지 5개 해시·57개 QA JSON 확인. · 근거: 기존 QA 및 이동 후 57개 실제 회귀 검사 - T05 r1 · pass: 파일 31개 GUID 보존, 카탈로그 참조 7개 정상, 기존 Playground·HUD·manifest·Prefabs 그룹 보존, 현재 소스·설정의 이전 경로 없음, 문서 검사 통과 · 근거: 31개 GUID·7개 참조·기존 파일 보존 - T06 r1 · pass: 이동된 에셋 그대로 빌드 성공, 원본 32개 파일 해시 일치, 실제 QA 57개·오류 0개·화면 5장 통과 · 근거: 이동 후 실제 57개 QA·화면 5장·32개 파일 대조 - T07 r1 · pass: 기존 구조 우선 규칙 1개 추가·Sync 푸시·3개 파일 해시 일치, 공개 후속 보고서 HTTP 200·이미지 5개 해시 일치 · 근거: 공개 publication-check.json·지침 해시 ### Q15 · step · 2026-11-01T08:33:21+00:00 씬 저장 중 카탈로그 객체가 해제되어 SetDirty MissingReferenceException 발생 - T08 r1 · fail: 씬 저장 중 카탈로그 객체가 해제되어 SetDirty MissingReferenceException 발생 · 근거: ../assets/scene-ui-prefab-20261101/build-1-failure.json ### Q16 · step · 2026-11-01T08:40:36+00:00 A/B 각 59개 통과 뒤 Escape 검사 시간 초과. 매니저 개수·동일 객체·생성 횟수는 정상 - T09 r1 · fail: A/B 각 59개 통과 뒤 Escape 검사 시간 초과. 매니저 개수·동일 객체·생성 횟수는 정상 · 근거: 로컬 editor-run-2 결과 두 개 및 aggregate ### Q17 · step · 2026-11-01T08:44:05+00:00 포커스 제한 설정 후 A 63개 통과, B Escape 시간 초과. 독립 검사 키보드로 장치 상태 분리 후 재검사 - T09 r2 · fail: 포커스 제한 설정 후 A 63개 통과, B Escape 시간 초과. 독립 검사 키보드로 장치 상태 분리 후 재검사 · 근거: 로컬 editor-run-3 결과 및 aggregate ### Q18 · step · 2026-11-01T08:45:16.999Z 프리팹·양쪽 진입점 적용, Bootstrap 제거·42개 파일 대조·기존 오브젝트 66개씩 보존 - T08 r2 · pass: 프리팹·양쪽 진입점 적용, Bootstrap 제거·42개 파일 대조·기존 오브젝트 66개씩 보존 · 근거: ../assets/scene-ui-prefab-20261101/source-check.json; scene-preservation.json ### Q19 · step · 2026-11-01T08:45:38.7129204Z 최종 A/B 직접 Play와 플레이어 전체 회귀 - T09 r3 · pass: Editor A/B 각63개·Play 종료 오류0, 실제 플레이어68개·오류0. 각 경로의 sceneLoaded·6회 반복 후 루트/매니저1·생성1·동일 객체, EventSystem/AudioListener 단일 및 실제 화면5장 확인 · 근거: ../assets/scene-ui-prefab-20261101/editor-results.json; editor-ExampleA.json; editor-ExampleB.json; player-results.json; visual-check.json ### Q20 · step · 2026-11-01T08:48:38.397Z 문서·정리·실제 공개 결과 확인 - T10 r1 · pass: 문서27페이지·908링크 통과·스냅샷변경0. 검증 복사본 제거, Pages 41290304919 성공, 개별 보고서와 첨부14개 HTTP200·이미지5개 해시 일치 · 근거: ../assets/scene-ui-prefab-20261101/publication-check.json; cleanup.json; GitHub Actions 41290304919 ### Q21 · final · 2026-11-01T08:48:38.398Z 기존 전체 작업과 프리팹 전환 후속의 현재 버전 최종 QA - T01 r1 · pass: 기존 QA 근거 유지. 최종 소스 컴파일·A/B 각63개·플레이어68개·화면5장·소스대조 및 공개 본문 재검증으로 현재 영향 범위 확인 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T02 r1 · pass: 기존 QA 근거 유지. 최종 소스 컴파일·A/B 각63개·플레이어68개·화면5장·소스대조 및 공개 본문 재검증으로 현재 영향 범위 확인 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T03 r2 · pass: 기존 QA 근거 유지. 최종 소스 컴파일·A/B 각63개·플레이어68개·화면5장·소스대조 및 공개 본문 재검증으로 현재 영향 범위 확인 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T04 r1 · pass: 기존 QA 근거 유지. 최종 소스 컴파일·A/B 각63개·플레이어68개·화면5장·소스대조 및 공개 본문 재검증으로 현재 영향 범위 확인 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T05 r1 · pass: 기존 QA 근거 유지. 최종 소스 컴파일·A/B 각63개·플레이어68개·화면5장·소스대조 및 공개 본문 재검증으로 현재 영향 범위 확인 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T06 r1 · pass: 기존 QA 근거 유지. 최종 소스 컴파일·A/B 각63개·플레이어68개·화면5장·소스대조 및 공개 본문 재검증으로 현재 영향 범위 확인 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T07 r1 · pass: 기존 QA 근거 유지. 최종 소스 컴파일·A/B 각63개·플레이어68개·화면5장·소스대조 및 공개 본문 재검증으로 현재 영향 범위 확인 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T08 r2 · pass: 프리팹·양쪽 진입점 적용, Bootstrap 제거·42개 파일 대조·기존 오브젝트 66개씩 보존 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T09 r3 · pass: Editor A/B 각63개·Play 종료 오류0, 실제 플레이어68개·오류0. 각 경로의 sceneLoaded·6회 반복 후 루트/매니저1·생성1·동일 객체, EventSystem/AudioListener 단일 및 실제 화면5장 확인 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 - T10 r1 · pass: 문서27페이지·908링크 통과·스냅샷변경0. 검증 복사본 제거, Pages 41290304919 성공, 개별 보고서와 첨부14개 HTTP200·이미지5개 해시 일치 · 근거: ../assets/scene-ui-prefab-20261101/final-summary.json; source-check.json; publication-check.json 및 이전 QA 이력 ## 남은 작업과 다음 반복 T11~T13 구현·적용·전체 실행 QA·공개 확인 이전 회차: [메뉴얼 열기](../../../projects/sampleprojectforunity/reports/2026-11-01-manual-scene-ui-implementation-20261101-20261101084843698-v1.0.9.html) ## 작업 시간 - 제안 시간: 25~40분 - 실제로 완료된 시간: 2026-11-01 17:57:36 KST 시작 - XERJ: 미사용 — 현재 도구 목록에 XERJ 없음. rg로 현재 소스·에셋·참조 검색