---
title: Entity Forge 제품 개발 · 빌드 시 DOTS 변환
date: 2026-11-01T07:52:54.732Z
version: v1.0.0
status: 작업 중
state: progress
project: turnroom
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: GameObject 개발, 빌드 변환, 비교 측정 기반 예상 개선율과 Templete 제품 적용을 구현합니다.
format: tracefolio-v2
priority: normal
manual_id: entity-forge-product
round: 1
manual_state: active
payload: ../assets/submissions/2026-11-01-manual-20261101075254732-v1.0.0.json
---

## 목표와 완료 기준

GameObject로 이동·회전·스폰·수명을 작성하고 빌드 결과에서 ECS/DOTS로 실행하는 독립 제품을 만듭니다.

완료 기준: 빌드 전용 변환·지원 제외·실제 플레이어 실행·비교 측정과 예상 표시·Templete UI·Affinity 로고·샘플 10개·9개 언어 가이드·실제 화면·패키지 설치·공개 보고서 검증을 완료합니다.

최초 1회차 · 순차 진행 · 전체 7개 · 이번 실행 T01, T02, T03, T04, T05, T06, T07

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 제품 구조와 변환 계약 | 기존 Templete와 Unity·Entities 의존성 확인; 지원 범위와 제외 조건 정의 | 원본 씬 보존 및 지원 범위 확인 | 실제 소스·공식 패키지 메타데이터 대조 | 진행 |
| T02 | GameObject 기능과 DOTS 런타임 | 이동·회전·스폰·수명과 Burst Job 처리·인스턴스 렌더링 구현 | 일반/변환 실행의 기능 대응 | 실제 Unity 컴파일·상태 및 수명 테스트 | 대기 |
| T03 | 빌드 변환과 참조 보존 | 빌드 씬 복사본만 변환; 제외 이유와 빌드 실패 처리 | 원본 해시 불변·지원 대상만 변환 | 일반/DOTS 플레이어 빌드·실행 및 잘못된 입력 검사 | 대기 |
| T04 | 성능 비교와 예상 개선율 | 플레이어 프레임 수집·동일 조건 비교·근거 무효화 | 빌드 시 근거 있는 예상 또는 산정 불가 표시 | 실제 비교 실행·불일치/음수/잘못된 표본 거부 | 대기 |
| T05 | Templete 제품 UI와 로고 | 공통 창·Inspector·헬프박스·테마; Affinity 벡터 로고 원본 제작 | 공통 디자인 및 실제 로고 표시 | 실제 Unity 화면·라이트/다크·Affinity 재열기 출력 대조 | 대기 |
| T06 | 샘플과 다국어 문서 | 기능·조합 샘플 10개, 9개 언어 가이드·실제 화면 | 설치부터 확장·문제 해결까지 문서화 | 샘플 실행·스크린샷 해시·문서 링크 확인 | 대기 |
| T07 | 제품 패키지와 최종 QA·공개 보고 | 개발 파일 제외 패키지 생성·새 프로젝트 설치·보고서 게시 | 설치·동작·보고서 외부 접근 성공 | 원본과 빌드 대조·회귀 QA·공개 URL 본문 확인 | 대기 |

## QA 반복 기록

아직 실행한 QA가 없습니다. 준비된 절차를 통과 결과로 표시하지 않습니다.

## 남은 작업과 다음 반복

전체 작업 진행 중. Affinity 로컬 MCP 연결 ECONNREFUSED로 로고 복구 필요.

최초 회차입니다. 실패·미검증·남은 작업은 다음 회차에서1~5개로 줄여 이어갑니다.

## 작업 시간

- 제안 시간: 2~4시간
- 실제로 완료된 시간: 2026-11-01 16:47:01 Asia/Seoul 시작. 진행 중.
- XERJ: 사용 — Xerj.ps1 Search CreateDocumentChrome 실행; 현재 소스로 대조. 최초 접근 오류 후 로컬 연결 검색 성공.