--- title: SceneControlManager·UIManager 구현과 씬 예제 검증 date: 2026-11-01T07:22:21.273Z version: v1.0.5 status: 작업 중 state: progress project: sampleprojectforunity type: 작업 메뉴얼 report_kind: manual category: 순차 작업 · 반복 QA summary: 기존 Scenes·AddressablesResources·Management·UI·SampleScene 구조로 통합하고 GUID·번들·실행을 재검증합니다. format: tracefolio-v2 priority: normal manual_id: scene-ui-implementation-20261101 round: 2 manual_state: active payload: ../assets/submissions/2026-11-01-manual-scene-ui-implementation-20261101-20261101072221273-v1.0.5.json --- ## 목표와 완료 기준 요청한 런타임 시스템과 씬 내 예제를 구현·적용·검증한다. 완료 기준: 컴파일, Addressables 콘텐츠 빌드, 플레이어 빌드, 왕복 전환·중복 요청·팝업·해제·실패 복귀 검증, 실제 실행 캡처, 공개 보고서 확인 후속 2회차 · 순차 진행 · 전체 7개 · 이번 실행 T05, T06, T07 ## 순차 작업 메뉴얼 | 순서 | 작업 | 실행 절차 | 완료 기준 | 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 | 후속 결과와 선호 반영 | 문서·보고서·완료 메뉴얼을 게시하고 기존 구조 우선 선호의 중복 여부를 검토해 지침에 반영한다. | 공개 결과·첨부 확인 및 지침 처리 기록 | 공개 배포·본문·첨부, 지침 차이·동기화 확인 | 진행 | ## 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 ## 남은 작업과 다음 반복 보고서·첨부 공개 배포 확인과 완료 메뉴얼 게시 이전 회차: [메뉴얼 열기](../../../projects/sampleprojectforunity/reports/2026-11-01-manual-scene-ui-implementation-20261101-20261101071739397-v1.0.4.html) ## 작업 시간 - 제안 시간: 후속 폴더 통합 10~20분 - 실제로 완료된 시간: 후속 시작 2026-11-01 16:10:07 KST. 이동 후 실행 QA 완료 16:20:58 KST(10분 51초). 보고서 기록 2026-11-01 16:22:20 KST. 공개 배포 확인은 완료 메뉴얼과 최종 채팅에 기록합니다. - XERJ: 미사용 — XERJ 도구 미제공. rg로 현재 경로와 참조를 검색.