# 공장 허용 오차 구현 계획

근거: [설계](../specs/2026-11-01-factory-tolerance-design.md). 기존 기초 구현 방식으로 현재 작업 브랜치에서 수정하고 다른 변경/사용자 파일은 유지한다.

- [x] ±0/1/2/3 양방향·혼합 크기·6/12 목표·빈 통·마감/넘침 대기와 여러 통 최저 별을 실패 테스트로 확인한다.
- [x] 순수Session 판정과Run 별 집계를 수정한다. 완료 전0별과 실패 통 이후 진행을 유지한다.
- [x] HUD/결과·한영CSV 안내를 연결하고 기존 실패fixture와E2E를 새 규칙에 맞춘다.
- [x] 관련 단위·번역/strict TypeScript/Vite·모바일/데스크톱 기능/저장과debug 계약을 검사한다.
- [x] sol/medium 최종 독립 리뷰와필요한 재검증 뒤PROGRESS에 결과/한계를 기록한다.

## 검증 결과

- 신규35개 테스트의 최초 결과는21실패/14통과로 기존 규칙을 재현했고, 구현 후35개 모두 통과했다.
- 관련 공장/번역7파일117개 통과. 첫 관련6파일 실행은 샌드박스 임시SSR 파일ENOENT로 테스트 시작 전에 실패했고, 호스트7파일 재실행은 모두 통과했다.
- 번역CSV 생성·strict TypeScript·Vite 빌드 통과. 별도 `.playwright-mcp/fill-tolerance/dist` 출력으로 기존dist와 미리보기를 보존했다. 기존 번들 크기 경고만 남았다.
- Chromium 모바일390×844 공장31개·데스크톱1280×800 공장31개·debug API 양 해상도2개, 총64개 통과. ±0/1/2/3 양방향 판정·1/2/3별 저장/완료·Retry·205판 앞 통 오차를 마지막 정확 통이 덮지 않음·실패 통 뒤 진행·넘침/품질 교체·숨김·한국어 안내/1별 저장을 확인했다. 전체 모바일 회귀·전체 단위·네이티브 검사는 이번 국소 변경에서 실행하지 않았다.
- `gpt-6.1-sol` / `medium` 최종 독립 코드 리뷰 Critical/Important/Minor 각0건. 이번 변경은 현재 작업 브랜치의 로컬 수정이며 커밋·main 병합·푸시는 하지 않았다.
- 기초 구현 방식의 기능 검증까지만 완료했다. 문구 줄바꿈·배치·실제 손으로 하는 난이도는 사용자 담당/미완료다. 캡처/로그·임시 설정은 `.playwright-mcp/fill-tolerance/`와 `.playwright-mcp/jelly-fill/tolerance-*.log`에 보존한다.

## 사용자 후속 요청: 로컬 커밋·최신main 병합·푸시

- 위의 미커밋/미병합 기록은 최초 기초 구현 당시 상태다. 사용자 후속 요청으로 변경을 로컬 커밋하고 원격main `5120daa`의 힐링 절단음 E2E/진행 기록도 보존해 통합한다. 같은 통합본의 전체 단위/문서·필수 모바일 검사와 독립 리뷰 뒤 일반 푸시한다. 사용자 untracked 이미지/output과 보존stash는 유지한다.
- 구현 로컬 커밋은 `410e3f7`, 최신main `5120daa` 통합 커밋은 `f00ee71`이다. 이 통합본에서 전체235파일3,464단위(207.7초)·번역/strict TypeScript/Vite·DocsSite5검사/OS별2제외·정적11페이지 검사가 통과했다.
- 필수 전체 모바일 프로젝트는837항목 중780통과/57사전제외/실패0(1,792.6초)이다. 기존 GPU·오디오 인자/3worker/제외 기준을 유지하고 검사 전용 출력/preview를 사용했다. 이번 실행은 최종 JSON 집계와 정상 종료까지 확인했으며 재실행이 필요한 테스트 실패는 없었다. 기록은 `.playwright-mcp/fill-tolerance/main-mobile.{log,json}`이다.
- 푸시 직전 원격main이 문서 전용 `9d8de23`으로 앞섰다. 최신 DocsSite7파일을 `20ce3ea`로 추가 통합하고PROGRESS 동일 위치 추가 충돌은 두 항목을 모두 보존해 해결했다. 게임/단위/E2E/패키지/Playwright 코드는 `f00ee71`과 차이가0이라 통과한 게임 검증 결과를 재사용했다. 문서는 새 통합본에서5검사/OS별2제외·생성기 타입/Astro·정적12페이지 검사로 재확인했다.
- 전체19파일의 최종 독립 리뷰와 후속 문서 통합 재리뷰(`gpt-6.1-sol` / `medium`)에서 수정 필요 결함은각0건이다. 검증 기록만 후속 커밋하고 깨끗한 기존main 작업 공간에 통합해 일반 푸시한다. 게임/기획서 배포는 GitHub Actions 자동 배포 경로를 사용하며 수동 배포로 우회하지 않는다. 사용자 외관/실제 손 난이도·네이티브 검수의 미완료 상태는 유지한다.