---
title: 공통 헬프박스 구현과 세 제품 적용
date: 2026-10-31T17:23:25.959Z
version: v1.0.2
status: QA 중
state: verification
project: turnroom
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: 공통 UI Toolkit·IMGUI 헬프박스를 구현하고 세 제품 적용·컴파일·화면·문서를 검증합니다.
format: tracefolio-v2
priority: normal
manual_id: shared-helpbox-20261101
round: 1
manual_state: qa
payload: ../assets/submissions/2026-10-31-manual-shared-helpbox-20261101-20261031172325959-v1.0.2.json
---

## 목표와 완료 기준

첨부된 안내 박스를 공통 템플릿으로 제공하고 저장소의 세 제품 헬프박스 사용처에 적용

완료 기준: 세 제품의 기존 메시지와 심각도를 유지하고 공통 컴포넌트로 전환, 컴파일, 실제 라이트·다크·줄바꿈 확인, 9개 언어 문서와 캡처 갱신 및 공개 보고

최초 1회차 · 순차 진행 · 전체 3개 · 이번 실행 T01, T02

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 공통 구현과 세 제품 적용 | UI Toolkit·IMGUI 공통 박스와 테마 연동을 구현하고 기존 사용처 전환 | 내용·심각도 유지, 중복 구현 제거 | 전후 사용처 대조와 실제 Unity 컴파일러로 변경 어셈블리 컴파일 | 완료 |
| T02 | 실제 UI 검증과 다국어 문서 | 실제 Unity 화면에서 양 테마·긴 문구·심각도를 확인하고 관련 9개 언어 문서·이미지를 갱신 | 실제 캡처와 소스 버전 근거, 문서 검사 통과 | 줄바꿈·정렬·범위와 해시 확인, 문서 빌드·검사 | QA 대기 |
| T03 | 회귀 검사와 공개 보고 | 영향 범위 회귀와 아카이브 게시·접근 확인 | 실제 결과와 미확인을 구분한 공개 보고 | 전체 최종 QA와 배포·본문 접근 확인 | 대기 |

## QA 반복 기록

### Q01 · step · 2026-11-01T02:08:03.2649698+09:00

공통·세 제품·갤러리의 실제 Unity 컴파일러 정적 컴파일

- T01 r1 · pass: TurnRoom.Editor, TurnRoom.PixelCamera.Editor, Pixora.Editor, DesignDataTable.Editor, TurnRoom.Templete.Development.Editor 모두 exitCode 0 · 근거: Tools/Verification/CompileSharedHelpBox.py 및 Docs/Testing/2026-11-01/shared-helpbox/static/result.json; 기존 메시지·심각도 직접 대조
### Q02 · step · 2026-11-01T02:23:20.8312049+09:00

수정 후 현재 소스·실제 UI와 정적 컴파일 근거 재검토

- T01 r2 · pass: 5개 어셈블리 exitCode 0, 실제 양 테마·240/440px·4개 심각도와 줄바꿈 확인, 4개 실제 레이아웃 JSON 통과 · 근거: static/result.json, loaded-build.json, layout-*.json, LightWide/DarkWide/LightNarrow/DarkNarrow.jpg; 첫 IMGUI 잘림은 실제 화면 확인 후 수정
### Q03 · step · 2026-11-01T02:23:20.8359817+09:00

새 헬프박스 문서 범위 검사

- T02 r1 · pass: 새 네이티브 캡처 7개와 27개 언어판의 이미지 링크·현재 소스 해시 일치 · 근거: Tools/Verification/VerifySharedHelpBoxDocs.py, HelpBoxDocsQA.json, PublishedScreenshots.json; Pixora 문서 구조 검사 통과
### Q04 · regression · 2026-11-01T02:23:20.8360262+09:00

기존 전체 문서 회귀 검사의 남은 실패 보존

- T02 r1 · fail: DataTable 전체 문서 검사 319개 기존 캡처 소스 불일치/대기, PixelCamera 기존 09-ThroughWalls.unity 캡처 소스 해시 불일치. 새 HelpBox 이미지 오류는 0개. · 근거: LocalizedDocs-final.json, LocalizedDocs-final.log, PixelCameraDocs-final.log. 과거 이미지·소스 해시를 바꾸지 않음

## 남은 작업과 다음 반복

헬프박스 구현·제품 적용·현재 해당 UI와 새 문서 범위는 검증 완료. 다른 기능의 기존 전체 문서 캡처 불일치/대기와 PixelCamera 샘플 씬 해시 불일치는 보존되어 전체 가이드 QA 미통과입니다. 공개 보고서 게시·접근 확인을 이어갑니다.

이전 회차: [메뉴얼 열기](../../../projects/turnroom/reports/2026-10-31-manual-shared-helpbox-20261101-20261031170813976-v1.0.1.html)

## 작업 시간

- 제안 시간: 15~30분
- 실제로 완료된 시간: 시작 2026-11-01 02:03:41 Asia/Seoul. 구현·해당 UI·새 문서 검사 확인 02:22:42, 약 19분 1초. 기존 전체 가이드 검증 미통과로 전체 완료 시각 미기록.
- XERJ: 실패 — 노드 미실행과 데이터 디렉터리 잠금 오류 확인, rg와 현재 소스 대조