---
title: 공통 헬프박스 구현과 세 제품 적용
date: 2026-10-31T17:08:13.976Z
version: v1.0.1
status: 작업 중
state: progress
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: active
payload: ../assets/submissions/2026-10-31-manual-shared-helpbox-20261101-20261031170813976-v1.0.1.json
---

## 목표와 완료 기준

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

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

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

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 공통 구현과 세 제품 적용 | UI Toolkit·IMGUI 공통 박스와 테마 연동을 구현하고 기존 사용처 전환 | 내용·심각도 유지, 중복 구현 제거 | 전후 사용처 대조와 실제 Unity 컴파일러로 변경 어셈블리 컴파일 | 완료 |
| T02 | 실제 UI 검증과 다국어 문서 | 실제 Unity 화면에서 양 테마·긴 문구·심각도를 확인하고 관련 9개 언어 문서·이미지를 갱신 | 실제 캡처와 소스 버전 근거, 문서 검사 통과 | 줄바꿈·정렬·범위와 해시 확인, 문서 빌드·검사 | 진행 |
| 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; 기존 메시지·심각도 직접 대조

## 남은 작업과 다음 반복

실제 UI·캡처·브라우저 시각 검증 미실행. DataTable 문서 검사는 캡처 소스 불일치와 기존 recapture pending으로 실패. PixelCamera 문서 해시 검사는 기존 09-ThroughWalls.unity 불일치로 실패. Pixora 문서 구조 검사는 통과. 이전 이미지·해시는 보존.

이전 회차: [메뉴얼 열기](../../../projects/turnroom/reports/2026-10-31-manual-20261031170429423-v1.0.0.html)

## 작업 시간

- 제안 시간: 15~30분
- 실제로 완료된 시간: 시작 2026-11-01 02:03:41 Asia/Seoul. 구현·최종 정적 컴파일 02:07:43; 화면 검증은 미완료.
- XERJ: 실패 — 노드 미실행과 데이터 디렉터리 잠금 오류 확인, rg와 현재 소스 대조