659 S4 W4-06 — locale/i18n 필드 투영

# #659 S4 W4-06 — locale/i18n 필드 투영

2026-10-10 PC-A 임시 writer. **PR7 head `c5e90f75f736d64d4bfded65cad1ca548f79b15b`**에서 `story/cocode-659-s4-locale-data`를 만들었다. PR base는 main이며 선행은 PR7다. 세션의 완료 묶음 체크포인트는 W4-06이고 **W4-07은 미시작**이다. 다음 브랜치는 이번 PR head에서 만든다.

## 구현·판정

[docs/locale-data.md](../locale-data.md)에 PRD §8·§10의 전 필드 A/B/C 분류, 실제 시드16컬렉션 필드 목록, 표시 예외, 실제11언어×7필드 지원표와 공급 갭을 기록했다. `GroceryDisplay`의 ko/en 상품·계정·주소 사전을 제거하고 **기능 소유 fieldset→호스트 합성→공급 DisplayProjector**로 이관했다. 상품·주문·슬롯·프로필의 localOnly/remote 매퍼, 모든 시험/Widgetbook 조립이 같은 계약을 쓴다. 목록·상세·장바구니·주문·피킹/대체 이력은 업무 상품 ID의 같은 B 키로 표시한다. 주소 키는 owner:code이며 두 가상 주소를 구분한다.

코드 분류·옵션·권역·등급 라벨은 기능 Slang JSON이다. 14카탈로그×11언어를 구성하고, 선행 revision/login의 추가 키도9언어에 채웠다. 후보의 두 placeholder 불일치(`error_minimum`, `demo_detail`)는 현재 호출 계약에 맞췄다. 동적 금액/시각 형식은 W4-07이다. JSON/키/placeholder/한글 잔존/빈값/순서/형식 패리티 검사와 그 위험11개 unit을 선별해 계약 게이트에 연결했다.

원본 후보 `c4450dc1`의 fieldset·key 계약·fixture composition과 `0ffc7946`의9언어 원본 키를 **선별**했다. 기존 PR·wip·salvage는 변경하지 않았다. bootstrap/login gate·W4-05 역할 시작·미리보기와 revision 처리는 보존했다. 생성 SDK/route/Slang을 후보에서 덮지 않고 공식 generator로 생성했으며 수기 SDK import/migration history 변경0이다. 일반 소스 whitespace check는 exit0이며, 전체 staged check의 exit2는 공식 Slang 출력126파일의 `@override ` trailing space다. 생성물 수기 정리 대신 공식 재생성diff0을 유지했고 이 결과를 별도 JSON에 기록했다. 후보의 A 난수 스트림 변경, 공급 ref 교체, 과거 migration, Pages/CI/폰트/locale addon/전체 AppPresentation은 채택하지 않았다.

실제198키×11언어(2178값)의 공급 측정은 모든7필드를 native로 분류하지만 **상품 이름5/48은 SKU 폴백**이다. 계란3·국거리1·루꼴라1은 공급7종 카탈로그 밖이다. native classifier의 임계값 한계를 지원표 옆에 명시하고 이5개를 native 완료로 계산하지 않았다. 특히 GP-0031을 시금치로 바꾸던 후보 오표기는 채택하지 않았다. 공급 갭은 코디네이터에게 PC-B 요청으로 전달했으며 co-package#70/#71/#78 계열의 승인 공급을 기다린다. 앱 번역 사전으로 보강하지 않았다.

**설계 §1 FR 상태는 24검증/1부분을 유지**한다. 부분은 FR-023의 공개 두 탭 증거다. 이번 변경은 B 이름을 공급 이름으로 교체하고 기존 FR 단언을 업무 ID·실제 투영값에 맞춰 회귀한 것이다. 전체 locale 게이트·전체 앱 완료·verified·13게이트 PASS로 승격하지 않는다.

## 실제 단언과 공급 영향

- 77개 언어×필드 보고, 전체198키×11언어 값, 미지원5SKU, 한글 잔존0을 실제 공급 출력으로 검증했다.
- 48상품×11언어의 목록/상세 엔티티 전체값(금액·revision·표시 포함) 동일, 전체 A 컬렉션 스냅샷/revision 불변, ko 복귀 결정성, 세계 읽기 알림0을 단언했다. 표시 getter는 기존 projector/memo를 유지한다.
- 중복 fieldset과 미등록 fieldKey는 명시 StateError다. 기존 주문 note/후기 body의 C 우선 매퍼를 유지했고 **UserEditOverlay·미저장 입력 실시간 전수 보존은 W4-07**이다.
- **co-package 상향0**: baseline `c003ca2c`에서 co_demo_world/co_demo_prefs 소비만 추가했다. Serverpod profile·CLI·의존4.0.3, CoUI v0.158.0/core v0.157.0을 유지했다. Serverpod/SDK/schema/migration 소스 diff0이다.
- 번역:14기능/호스트/공용 카탈로그의9추가언어126 JSON·126 공식 Slang 언어파일, ko/en의 코드 라벨 추가와 호스트/login/revision 키 결합. B 투영: 상품명/산지/수확/사람명/주소/시드 메모/후기 모두 변경된다. A 업무 시드의 기존 stream/값은 W4-05 fixture와 동일하다.
- 골든 PNG 변경0. 표시 변경 영향을 받는 suite는 GP app/console, DS app/console, GO app/console, SUB, RV, SH, AL이다. 이10suite의600업무 PNG는 W4-08 Linux에서 재캡처·compare하며, core status24 PNG도 함께 회귀한다. 624skip은 완료가 아니다.

## 로컬 검증

Flutter3.47.6/Dart3.13.5/macOS arm64. 무거운 전체시험·DB는 순차 실행했고 디스크는 약63GiB로40GB 아래 새 작업 진입이 없었다. 실행별 종료코드·시간은 `s4-659-w4-06/validation-runs.jsonl`에 기록했다.

| 검증 | 실제 결과 |
|---|---|
| workspace flutter pub get | exit0 · 1.979s |
| 공식 module7→host generate | exit0 · 94.784s |
| 공식 Flutter Slang/build_runner 재생성 | exit0 · 29.010s |
| dart analyze --fatal-infos | exit0 · 7.384s |
| 계약 게이트(14×11 strict parity 포함) | exit0 · 4.544s |
| 패리티 위험 unit11 | exit0 · 0.093s |
| 11×7 B/48×11 목록·상세·A불변·읽기0 (2tests) | exit0 · 3.851s |
| shopper 수정 후 패키지 재검증18/24skip | exit0 · 4.311s |
| 기존 fixture prepare (W4-05 A시드 대조) | exit0 · 9.499s |
| 기존 fixture 공식 migration 재적용/no-op | exit0 · 8.743s |
| 필수 SDK/localOnly 계약 서버2tests | exit0 · 14.943s |
| 생성 manifest | **377파일·hash diff0**, generated-repeat-result.json |
| TZ=UTC 전체 workspace + 해당 실패 패키지 보정 | 34패키지 **578성공·625skip·0잔여실패**; 아래 실제 실행/보정 구분 |
| fresh DB | 전체 실행 안 실제 호스트 SDK/IdP/JWT **74성공·skip0** |
| 중앙 Widgetbook | **47성공·skip0**, 기존21 Page×4 knob/retry 회귀 포함 |
| 기존 fixture | **18테이블·429행 모든 값/revision·기존 A시드 보존**, 전용 DB만 정리 |

전체 workspace의 마지막 실행은 **577성공·625skip·1실패/exit1**이었다. 남은 shopper의 옛 가상 주소 접미사 단언을 집/회사 코드별 실제 주소로 고쳐 **shopper18성공·24skip/exit0**으로 재검증했다. 이를 합산한34패키지 결과가 **578성공·625skip·0잔여실패**다. 전체 명령 자체가 exit0이었다고 보고하지 않는다. 최초 전체 실행의 기존 고정 상품명/페르소나 단언 실패, placeholder 컴파일 실패, 조립/패리티 수정과 주소 기대값 수정은 로그에 보존했다.

**625skip = Linux 골든624 + 일반 contract 서버URL 미설정1**, 새 skip0이다. 필수 실제 SDK/localOnly 계약 서버의 별도 실행은 이 일반 skip과 구분해서 표에 기록한다. DB 두 번째 경로는 **schema 변화 없는 기존 fixture 재적용/no-op 회귀**이며 새 migration upgrade 증거가 아니다. 만들어 보존한 전용 fixture DB만 정리했다.

공개/browser/Patrol·두 탭·iframe·ar/dark 첫 프레임은 이번 묶음에서 실행하지 않았다. `fr-focus.mjs`의 시작 버튼 locator는 고정 이름 대신 실제 가상 이름을 허용하도록 수정했지만 이 하네스의 W4-05 성공을 새 head의 브라우저 증거로 승계하지 않는다.

재현 원본·2178값 JSON·지원표·시드 필드 목록·workspace/DB·377파일 manifest·실패 로그는 `/Users/dongwoo/orca/toolchains/637/xhost/s4-659-w4-06/`에 있다. `artifact-sha256.json`이 로컬 증거 해시를 기록한다. S5 sidecar는 코디네이터의 cocode 증거 대장에만 제출하며 여기서 수기 PASS를 만들지 않는다.

## W4-07에서 재조사한 실패 원인

전체 실행의 실패명은 shopper `다른 탭이 먼저 바꿨으면 충돌 문구와 최신 기본 배송지를 보인다(낙관적 동시성)`이다. `659-workspace-tests-final.log`는 첫 home 주소 `대전 판교로 4778`에 삭제된 `(가상 배송지)` 접미사를 기대한 149행 단언 실패다. 후속 `659-shopper-final.log`와 `659-shopper-verified.log`는 회사로 선택한 뒤 171행에서 집(`대전 판교로 4778`)을 기대해 실제 회사(`인천 판교로 363`)와 달랐다. 현재 PR8 head는 home/work 각각의 업무 코드를 투영해 기대하고, 후속 `659-shopper-pass.log`는 18성공/24골든skip/exit0다. 따라서 같은 소스의 무근거 재실행 성공으로 실패를 지운 것이 아니라 주소 표시 계약 변경 뒤 기대값 두 지점을 바로잡은 이력이다.

W4-07 착수 전 동일 PR8 head를 TZ=UTC에서 seed1·42로 순서를 섞어 각각 패키지18성공/24skip/exit0(6.017s·4.350s) 재검증했다. 재현 조건은 옛 주소 접미사/선택 뒤 home 기대값이며 로그에 clock timeout·race 증거는 없다. 이 두 실행만으로 모든 flaky가 없다고 일반화하지 않으며, 최종 W4-07 전체 회귀에서 다시 판정한다. 원본 로그와 변경 후 순서 검증은 `s4-659-w4-06/`와 `s4-659-w4-07/`에 보존한다. 공급 미지원 5SKU 요청은 [co-package#96](https://github.com/coco-de/co-package/issues/96)이며 PR8 브랜치 자체는 변경하지 않았다.

## 남은 BLOCKED·다음 순서

| blocker / issue | next |
|---|---|
| 조직 Actions 예산 / cocode#637 | 재실행·workflow 변경·머지 없음. 예산 복구 후 coordinator가 PR2→3→4→5→6→7→이번 PR 머지 열차 |
| 공급 카탈로그5SKU / co-package#70/#71/#78 계열, PC-B 요청 | 공급 소유자의 명시 보강/ref 승인 후 소비. 공용 저장소 writer 변경0 |
| L3/4/6 / cocode#659 | **W4-07 미시작**: 이번 head에서 새 브랜치. AppPresentation/prefs/DemoEmbedSync/DemoLocaleSwitcher/UserEditOverlay를 W4-04 bootstrap 계획 앞단에 결합. route/선택/cart/order/미저장 입력/filter/page/panel·A/C·stale async·읽기0, ko→en→ja→ar→ko 실제 두탭/iframe·마지막 언어, ar/dark 첫 프레임·RTL 검증 |
| CoUI 영어 chrome / coui#5084 | 언어 고정 예외 유지, 앱 우회 delegate0. 예산으로 미머지 coui#5354 소비 금지 |
| L5·골든/폰트/scale / cocode#659 AC13/14 | W4-08 Linux 언어/상태 variants·capture/compare·정확한4화면4조합·DCM. 현재 기본 번들 폰트의11언어 화면 보증도 남음 |
| runner·공개6표면·브라우저 / cocode#659 AC12/16·FR023 | W4-09 실제 Patrol 및 W4-11 공개표면/주소마스킹·외부/업무0요청. 로컬 투영/DB 시험이 공개locale/smoke를 대신하지 않음 |
| bundle verified/full cleanbase/Mobbin / co-bricks#830/#831/#764/#860·coui#5149 | 공급 승인/접근 확보 후 W4-10~13. legacy stamp 수기 승격0 |

§14 capability 경계는 그대로다: PG/실환불은 모의전이, 기사 API는 콘솔 이력, 주소검색은 시드2주소, push는 알림함, billing/scheduling은 정기설정, 쿠폰/적립은 지표, WMS는 단일재고, media_upload는 번들 사진이다.