---
title: 웹 초기 전송 경량화와 실제 로딩 검증
date: 2026-10-30T13:12:41.984Z
version: v1.0.2
status: 완료
state: complete
project: last37n
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: 웹 배포를 기준으로 기존 용량을 측정하고 압축 릴리스 빌드·올바른 HTTP 헤더·실제 실행을 검증합니다.
format: tracefolio-v2
priority: normal
manual_id: web-initial-payload
round: 1
manual_state: complete
payload: ../assets/submissions/2026-10-30-manual-web-initial-payload-20261030131241984-v1.0.2.json
---

## 목표와 완료 기준

웹 실행의 초기 전송 비용을 줄이고 실제 브라우저가 정상 실행되는지 확인합니다. 사용자 화면은 제어하지 않습니다.

완료 기준: 기준 파일 용량 보존, 압축 릴리스 빌드의 실제 전송량 감소, 올바른 gzip/wasm 헤더, 실제 WebGL 기동·수색·아이템·NPC UI 회귀 및 실제 화면 보고서 게시를 확인합니다. 저사양/모바일 FPS 보장을 측정 없이 주장하지 않습니다.

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

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 현재 웹 비용 측정 | 개발 빌드 파일과 렌더링/전송 구조를 확인합니다. | 원본 크기·빌드 설정과 미측정 항목이 기록됩니다. | 실제 파일 바이트와 현재 소스를 대조합니다. | 완료 |
| T02 | 압축 릴리스와 네이티브 해제 헤더 | 별도 출력 폴더에 gzip 릴리스를 만들고 wasm MIME/압축 헤더를 구성합니다. 고DPI 기본 렌더링 배율도 제한합니다. | 기존 플레이 환경을 보존한 채 압축 파일이 정상 전달됩니다. | 실제 응답 헤더·압축/해제 길이와 브라우저 엔진 오류를 검사합니다. | 완료 |
| T03 | 실제 회귀와 로컬 반영·보고 | 실제 헤드리스 브라우저 기능과 화면을 검증하고 성공한 빌드를 로컬 웹에 반영합니다. | 정상 실행과 실제 용량 감소를 확인하고 한계·시간·스크린샷을 보고합니다. | 실제 WebGL 입력·거래·치료·HTTP 헤더·배포 보고서와 링크를 검증합니다. | 완료 |

## QA 반복 기록

### Q01 · step · 2026-10-30T13:08:03.385Z

기준 측정과 gzip 릴리스·실제 기능 검증

- T01 r1 · pass: 기존4파일50,532,559bytes, Development/압축Disabled를 확인했습니다. 실제 DPR2/1440x900 CSS에서 canvas2880x1800과 전송량50,532,559bytes를 측정했습니다. · 근거: docs/qa/web-performance/baseline.json; baseline-browser.json
- T02 r1 · pass: 별도 gzip 릴리스10,398,823bytes로79.42% 감소. 실제 wasm gzip·application/wasm 헤더, DPR2에서 canvas1440x900을 확인했습니다. 수색 후 식수4→3, 실제 구매/판매·치료와 엔진 오류0을 통과했습니다.12MiB 초기 전송 예산 검사도 통과했습니다. · 근거: docs/qa/web-performance/optimized-browser.json; tools/check-web-budget.mjs
### Q02 · final · 2026-10-30T13:12:41.567Z

경량 빌드 로컬 반영·실제 기능·예산·외부 보고서 검증

- T01 r1 · pass: 실제 기준50,532,559bytes·고DPI canvas2880x1800과 원본을 보존했습니다. 지도 청크517,572bytes는 별도이며 빌드 합계와 구분했습니다. · 근거: docs/qa/web-performance/baseline-browser.json; deployment.json
- T02 r1 · pass: 실제 gzip 릴리스10,398,823bytes·wasm MIME/압축 헤더·canvas1440x900을 확인했습니다.12MiB 초과 원본 거부와 최적화 빌드 통과를 실제 실행했습니다. · 근거: optimized-browser.json; budget-check.json
- T03 r1 · pass: 수색·식수4→3·배낭·구매/판매·체력100 치료, 엔진 오류0. localhost8788 반영 뒤 실제 재기동 통과. 사용자 GUI 제어 없음. 보고서 Actions41060992801 success/외부 HTML·실제 이미지200,386게시물/13720링크/필터와 데스크톱·모바일 레이아웃 통과. · 근거: optimized-browser.json; promoted-browser.json; deployment.json; docs/qa/progress-report-layout-web.json

## 남은 작업과 다음 반복

이 메뉴얼 범위 작업 없음. 저사양/모바일/다수 캐릭터 FPS·메모리·도시 배칭/LOD는 별도 측정 항목으로 유지합니다.

이전 회차: [메뉴얼 열기](../../../projects/last37n/reports/2026-10-30-manual-web-initial-payload-20261030130803799-v1.0.1.html)

## 작업 시간

- 제안 시간: 10~20분. 시작2026-10-30 21:53:56 KST.
- 실제로 완료된 시간: 최종 QA 통과 2026-10-30 22:12:41 KST, 시작 후 18분. 메뉴얼 게시의 최종 전달 시각은 별도 기록합니다.
- XERJ: 미사용 — XERJ 및 Chrome DevTools MCP 미제공. rg·Unity CLI·실제 헤드리스 브라우저로 진행합니다.
