--- title: SceneControlManager·UIManager 구현과 씬 예제 검증 date: 2026-11-01T06:58:08.562Z version: v1.0.1 status: 작업 중 state: progress project: sampleprojectforunity type: 작업 메뉴얼 report_kind: manual category: 순차 작업 · 반복 QA summary: Addressables 씬 전환, UI 수명 관리, 두 테스트 씬과 로딩·화면·팝업 예제를 구현하고 실제 플레이어로 검증합니다. format: tracefolio-v2 priority: normal manual_id: scene-ui-implementation-20261101 round: 1 manual_state: active payload: ../assets/submissions/2026-11-01-manual-scene-ui-implementation-20261101-20261101065808562-v1.0.1.json --- ## 목표와 완료 기준 요청한 런타임 시스템과 씬 내 예제를 구현·적용·검증한다. 완료 기준: 컴파일, Addressables 콘텐츠 빌드, 플레이어 빌드, 왕복 전환·중복 요청·팝업·해제·실패 복귀 검증, 실제 실행 캡처, 공개 보고서 확인 최초 1회차 · 순차 진행 · 전체 4개 · 이번 실행 T01, T02, T03, T04 ## 순차 작업 메뉴얼 | 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 | | --- | --- | --- | --- | --- | --- | | T01 | 런타임 시스템 구현 | 프로젝트 작성 규칙에 맞춰 씬·UI 카탈로그와 관리자를 구현한다. | 핸들 소유권·전환 직렬화·UI 수명·실패 복구 구현 | Unity 컴파일 및 소스 책임·해제 경로 검토 | 완료 | | T02 | 씬과 UI 예제 생성 | Bootstrap·테스트 씬 2개와 UI 프리팹·Addressables 그룹을 생성한다. | 씬 안의 버튼으로 전환·팝업·실패 복귀 시연 | 에셋 참조·콘텐츠 빌드·플레이어 빌드 | 완료 | | T03 | 실제 실행 QA | 사용자 허용 후 창을 표시하고 전체 실행 시나리오와 렌더 완료 뒤 실제 화면을 검증한다. | 구체적인 실행 결과·실제 화면 확보 | EventSystem 클릭·Escape·실패 복구·개수 검사와 비검정 캡처 및 상태 표시·가독성을 실제 실행에서 대조한다. | 완료 | | T04 | 문서와 공개 보고 | 사용 예제·실행 방법·검증 근거를 문서화하고 아카이브에 게시한다. | 문서 검증과 공개 보고서·첨부 확인 | 문서 빌드·링크 검사·배포·HTTP 본문 검증 | 진행 | ## 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 ## 남은 작업과 다음 반복 중앙 보고서 푸시·공개 배포·개별 본문과 첨부 접근 확인 이전 회차: [메뉴얼 열기](../../../projects/sampleprojectforunity/reports/2026-11-01-manual-20261101063225468-v1.0.0.html) ## 작업 시간 - 제안 시간: 25~45분 - 실제로 완료된 시간: 시작 2026-11-01 15:30:16 KST. 최종 게임 실행 QA 완료 2026-11-01 15:55:20 KST(25분 4초). 보고서 작성 시점 2026-11-01 15:57:32 KST까지 1637초. 공개 배포 확인은 후속 메뉴얼과 최종 채팅에 기록합니다. - XERJ: 미사용 — 제공된 XERJ 도구와 검색 스크립트 없음. rg 대체.