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

## 목표와 완료 기준

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

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

후속 2회차 · 순차 진행 · 전체 7개 · 이번 실행 T05, T06, T07

## 순차 작업 메뉴얼

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

## QA 반복 기록

### Q01 · step · 2026-11-01T09:26:28.661Z

Templete 1.5.0 API와 Unity 6000.0.83f1·Entities 1.3.15 및 지원 범위를 실제 소스·공식 패키지에서 대조했습니다.

- T01 r1 · pass: Templete 1.5.0 API와 Unity 6000.0.83f1·Entities 1.3.15 및 지원 범위를 실제 소스·공식 패키지에서 대조했습니다. · 근거: 현재 소스 및 공식 Entities 1.3.15 메타데이터
### Q02 · step · 2026-11-01T09:26:28.661Z

실제 Unity에서 이동·네이티브 회전 대조·일괄/시간제 스폰·수명 및 안전 검사와 10개 샘플의 원본 보존 검사가 통과했습니다.

- T02 r1 · pass: 실제 Unity에서 이동·네이티브 회전 대조·일괄/시간제 스폰·수명 및 안전 검사와 10개 샘플의 원본 보존 검사가 통과했습니다. · 근거: Unity 실제 실행 로그의 FORGE PASS 및 플레이어 빌드·실행 기록
### Q03 · step · 2026-11-01T09:26:28.661Z

일반/변환 Windows 플레이어 빌드 성공. 씬 캐시 문제를 재현하고 CleanBuildCache 및 잘못된 빌드 차단으로 보호했으며 실제 개체 수로 변환을 확인했습니다.

- T03 r1 · pass: 일반/변환 Windows 플레이어 빌드 성공. 씬 캐시 문제를 재현하고 CleanBuildCache 및 잘못된 빌드 차단으로 보호했으며 실제 개체 수로 변환을 확인했습니다. · 근거: Unity 실제 실행 로그의 FORGE PASS 및 플레이어 빌드·실행 기록
### Q04 · step · 2026-11-01T09:26:28.661Z

정상 렌더링 플레이어에서 각 600프레임과 10,000개 개체를 비교하고 원시 평균·동일 입력·현재 지문 대조와 예상 에셋 저장이 통과했습니다.

- T04 r1 · pass: 정상 렌더링 플레이어에서 각 600프레임과 10,000개 개체를 비교하고 원시 평균·동일 입력·현재 지문 대조와 예상 에셋 저장이 통과했습니다. · 근거: 실제 비교 JSON·런타임 개체 수·paired-estimate valid=True 및 보존 로그
### Q05 · step · 2026-11-01T09:26:28.661Z

사용자 데스크톱 사용으로 실제 UI 검증 보류

- T05 r2 · blocked: 로고 PNG 및 실제 Affinity 저장·닫기·재열기 출력 동일성 검증 완료. UXML/USS·Inspector 이벤트 8개·정적 컴파일 완료. 사용자 화면 사용 금지로 실제 UI·이벤트 호출 검증 보류. · 근거: 명시적 화면 조작 금지. ScreenshotManifest는 pending과 빈 캡처 목록을 유지합니다.
### Q06 · regression · 2026-11-01T12:24:56.516Z

설치본 최신 UI·실제 입력·문서와 패키지 회귀 통과

- T05 r4 · pass: 편집 가능한 테마·8개 이벤트·물리 선택 입력·씬 무효화·실제 4화면·기존 Affinity 원본 · 근거: clean-install/core.json; Functional/verification.json; estimate-ui.json; reopened-estimate.json; estimated-build.json; native-input-final.json; ScreenshotManifest.json; installed-package-readback.json
- T06 r1 · pass: 10개 설치 샘플·9개 언어 가이드·171개 로컬 링크·현재 캡처 해시 · 근거: clean-install/core.json; Functional/verification.json; estimate-ui.json; reopened-estimate.json; estimated-build.json; native-input-final.json; ScreenshotManifest.json; installed-package-readback.json
### Q07 · final · 2026-11-01T12:29:39.725Z

원래 전체 7개 작업의 현재 버전 최종 QA 통과 및 공개 배포 확인

- T01 r1 · pass: 계약·지원 제외와 Templete 의존성 대조 · 근거: clean-install/core.json (42); Functional/verification.json (26); final-measurement.json (600 samples each, 70.7799%); reopened-estimate.json; estimated-build.json; build-estimate-line.txt; native-input-final.json; current ScreenshotManifest.json; installed-package-readback.json; public-verification.json — https://mdj0126.github.io/codex-config/projects/entityforge/reports/2026-11-01-result-20261101122527634-v1.0.0.html
- T02 r1 · pass: 설치본 10개 샘플 실행·실제 기능 플레이어 26개 대조 · 근거: clean-install/core.json (42); Functional/verification.json (26); final-measurement.json (600 samples each, 70.7799%); reopened-estimate.json; estimated-build.json; build-estimate-line.txt; native-input-final.json; current ScreenshotManifest.json; installed-package-readback.json; public-verification.json — https://mdj0126.github.io/codex-config/projects/entityforge/reports/2026-11-01-result-20261101122527634-v1.0.0.html
- T03 r1 · pass: 원본 씬 보존·실제 GO/DOTS 개체 수·잘못된 캐시 빌드 차단 · 근거: clean-install/core.json (42); Functional/verification.json (26); final-measurement.json (600 samples each, 70.7799%); reopened-estimate.json; estimated-build.json; build-estimate-line.txt; native-input-final.json; current ScreenshotManifest.json; installed-package-readback.json; public-verification.json — https://mdj0126.github.io/codex-config/projects/entityforge/reports/2026-11-01-result-20261101122527634-v1.0.0.html
- T04 r1 · pass: 각 600개 정상 렌더링 프레임·현재 근거 UI·재시작 및 근거 사용 빌드 · 근거: clean-install/core.json (42); Functional/verification.json (26); final-measurement.json (600 samples each, 70.7799%); reopened-estimate.json; estimated-build.json; build-estimate-line.txt; native-input-final.json; current ScreenshotManifest.json; installed-package-readback.json; public-verification.json — https://mdj0126.github.io/codex-config/projects/entityforge/reports/2026-11-01-result-20261101122527634-v1.0.0.html
- T05 r4 · pass: 편집 가능한 테마·8개 이벤트·물리 선택 입력·씬 무효화·실제 4화면·기존 Affinity 원본 · 근거: clean-install/core.json (42); Functional/verification.json (26); final-measurement.json (600 samples each, 70.7799%); reopened-estimate.json; estimated-build.json; build-estimate-line.txt; native-input-final.json; current ScreenshotManifest.json; installed-package-readback.json; public-verification.json — https://mdj0126.github.io/codex-config/projects/entityforge/reports/2026-11-01-result-20261101122527634-v1.0.0.html
- T06 r1 · pass: 10개 설치 샘플·9개 언어 가이드·171개 로컬 링크·현재 캡처 해시 · 근거: clean-install/core.json (42); Functional/verification.json (26); final-measurement.json (600 samples each, 70.7799%); reopened-estimate.json; estimated-build.json; build-estimate-line.txt; native-input-final.json; current ScreenshotManifest.json; installed-package-readback.json; public-verification.json — https://mdj0126.github.io/codex-config/projects/entityforge/reports/2026-11-01-result-20261101122527634-v1.0.0.html
- T07 r1 · pass: 네이티브 패키지 325파일·설치본 650개 대조, Pages 803f65e 배포 성공 및 개별 본문/실행 화면/첨부 HTTP 200 확인 · 근거: clean-install/core.json (42); Functional/verification.json (26); final-measurement.json (600 samples each, 70.7799%); reopened-estimate.json; estimated-build.json; build-estimate-line.txt; native-input-final.json; current ScreenshotManifest.json; installed-package-readback.json; public-verification.json — https://mdj0126.github.io/codex-config/projects/entityforge/reports/2026-11-01-result-20261101122527634-v1.0.0.html

## 남은 작업과 다음 반복

요청한 지원 범위 내 남은 작업 없음. Windows/Unity 6000.0.83f1/Built-in 외 조합과 번역 UI 배치 전체는 미검증. 교훈은 Architecture.md에 통합했으며 전역 규칙은 중복 추가하지 않았습니다.

이전 회차: [메뉴얼 열기](../../../projects/turnroom/reports/2026-11-01-manual-entity-forge-product-20261101122504590-v1.0.3.html)

## 작업 시간

- 제안 시간: 최초 2~4시간; 이번 새 설치·최종 QA 재개 40~70분
- 실제로 완료된 시간: 전체 필수 구현·검증 및 결과 보고서 공개 확인: 2026-11-01 21:29:39 Asia/Seoul. 시작 20:31:03부터 실제 3517초. 최종 메뉴얼 게시 확인은 마지막 전달 시각에 구분합니다.
- XERJ: 실패 — 현재 노드 미실행, 기존 잠금 오류로 rg 및 현재 소스 대조 사용