659 표시 데이터 계약 — W4-06

# #659 표시 데이터 계약 — W4-06

2026-10-10 PC-A 임시 writer. [설계 §8·§12](design/s3-design-record.md), [bootstrap 선행 계획](design/s4-w4-04-bootstrap-plan.md), PRD §8·§10·L1~6에 따른다. 공급은 baseline v2 최종 **co-package `5b479112` / CoUI v0.159.2(`1b3838db`) / Serverpod 4.0.3**이다(2026-10-12 PC-C 상향 — 후보 1 `a66629f6` · v0.159.1 위에 co_faker #103 · co_bdd #104 HarnessFonts · CoUI #5372 아이콘 글꼴 제외; 2026-10-11 후보 1 — v1.1 의 5 SKU 이름 · CoUI chrome 11개 언어 위에 Pagination 축소 · 웹 선택 게이트 · Geist 굵기 지연).

## A / B / C와 표시 예외

**A 업무**는 언어와 무관한 ID·관계·수량·순서·권한·revision·금액·재고·시각·사용자 행동 결과다. **B 표시**는 같은 entity/id/field의 언어별 가상 데이터다. **C 입력**은 사용자가 쓴 원문이며 B보다 우선한다. 코드의 라벨·고정 안내·상태별 문장은 기능 소유 Slang JSON으로 표시한다. 이 문구는 생성 목데이터 사전과 구분하며 표에서 `UI`로 명시한다. 언어는 한국 업무 국가·KRW·Asia/Seoul을 바꾸지 않는다.

PRD §8의 전 필드를 아래에 분류한다. 공통 `id/code/owner/외래키/seed/isSeed/revision`은 A다. recipe와 authored 모델의 이름 차이·실제 없는 필드는 기능을 구현했다고 계산하지 않는다.

| PRD 엔티티 | A 업무 / A에서 계산 | B 표시 / 실제 출처 | C / UI / 실제 차이 |
|---|---|---|---|
| grocery_product | price, listPrice, category, storageType, stock, isSeasonal, rating, createdAt; 할인율; 중량·개수와 종류 코드 | name→`product.name`; originRegion→`product.origin`; summary/수확 안내→`product.harvest` | weightLabel은 A 크기+개수 UI; imageUrl은 번들 `ProduceArt`의 코드별 그림으로 대체. 별도 summary 저장 없음 |
| produce_category | parentId, sortOrder; id/category | 임의 생성 이름 없음 | name은 고정 분류 코드의 기능 UI 라벨(루트7·하위14); imageUrl은 그림/아이콘 대체. 표시 이름으로 관계를 연결하지 않음 |
| product_option | productCode, optionGroup, price, required, multiSelect; label=base/up/gift 코드 | 임의 생성 이름 없음 | name은 A 크기 또는 선물 포장 UI. 사용자가 고른 optionCodes는 A 행동 결과, 선택 중 값은 C |
| cart_line | unitPrice, quantity, storageType, addedAt, product/option 관계 | productName은 같은 `product/<id>/name` | optionSummary는 A optionCodes의 UI 라벨 조합. imageUrl은 번들 그림. 편집 중 수량은 C, 확정 수량은 A |
| delivery_slot | startsAt, endsAt, remaining, capacity, slotKind, cutoffAt, zone 코드, closed | 임의 생성 label 없음 | label·zoneName은 A kind/zone/시각의 기능 UI+날짜 형식. 슬롯 선택 중 값은 C, 예약은 A |
| grocery_order | orderNo, totalAmount, deliveryFee, deliverAt, substitutionPolicy, orderedAt, status; slot/address 코드 | recipient→`account.name`; address→`address.line`; itemSummary→같은 상품 B+품목 수 UI; doorNote 시드→`orderNote.text` | slotLabel은 슬롯 A의 UI. 입력 doorNote는 C(`note`)이며 null일 때만 B(`noteKey`). 빈 사용자 문자열도 입력으로 남는다. 별도 recipient 자유입력 없음 |
| order_event | occurredAt, eventKind, status/fromStatus, 관계, refundAmount, mockRefund, contactConfirmed, policy | 상품 이름이 필요한 description은 동일 상품 B | title/description은 실제 이력 A+기능 UI 템플릿. 알림 문장만으로 업무 전이를 만들지 않음 |
| pick_line | quantity, binLocation, orderCode, picked/status, product/substitute 관계, unit, storage | productName/substituteName은 동일 상품 B | binLocation은 언어 고정 물류 코드(A). 연락 확인·대체 선택 초안은 C, 확정 결과는 A |
| delivery_subscription | isActive, skipNext, cycleWeeks, preferredWeekday, preferredSlotKind, nextDeliveryAt | 상품을 참조하는 itemSummary는 동일 상품 B | 실제 설정 화면의 안내는 UI. 시드 itemSummary 저장 없음. 설정 중 입력은 C, 저장된 설정·revision은 A |
| grocery_review | rating, createdAt, order/line/product 관계, photo 키 | body/시드 freshnessNote→`reviewBody.text`; 상품 title→동일 상품 B | 입력 body/freshnessNote는 C(`body`)이며 null일 때만 B(`bodyKey`). 별도 title/freshnessNote 저장 없음. imageUrl은 번들 사진 미리보기로 대체 |
| shopper | point, couponCount, orderCount, grade 코드, addresses/defaultAddress 코드 | nickname→`account.name`; defaultAddress 표시→`address.line` | gradeName은 UI 라벨; avatarUrl 대신 이니셜 아바타. 현재 수정 API는 기본 배송지 선택이며 nickname 자유입력은 없음 |
| grocery_alert | category, isRead, createdAt, kind, order/product 관계 | 관련 인물·상품은 같은 B 키 | title/body는 실제 kind/관계의 기능 UI 템플릿. push 네트워크·연락처·주소검색 구현 없음 |

PRD §10의 고정 fixture는 **업무 ID·금액·재고·분류·크기·옵션·슬롯·0042 시퀀스**를 보존한다. 기존 ko/en 고정 상품명·페르소나명은 공급의 언어별 가상 이름으로 교체했다. `shopper-ohaneul` 등 업무 계정 ID는 그대로이며 사람이 보이는 이름은 B다. `GP-0031`의 종류는 루꼴라로 유지하며 후보의 시금치 이름 오표기를 채택하지 않았다.

시드의 `noteKey/bodyKey`는 B를 찾는 안정 키(A)이고 `note/body`만 C다. seed/isSeed는 원문 종류를 정하는 A flag다. 사용자가 만든 주문·후기·알림·이력의 업무 관계와 시각도 A로 남는다. 세션의 route·선택·filter·page·panel·미저장 입력은 화면 상태(C)이며 공유 언어 전환 보존 검증은 W4-07이다.

법정 문서를 표시하는 기능은 현재 없다. 언어 고정 예외는 **SKU/물류 bin/ISO 코드/업무 ID/단위 기호/번들 이미지**다. 한국 면책·모의전이 문구는 기능 UI 번역을 따른다. PG·실환불·기사 API·주소검색·push·billing/scheduling·쿠폰/적립·WMS·media_upload를 실제 capability로 승격하지 않는다.

## B 필드 소유권과 투영

| 필드 | 소유 / 공급 생성기 | 실제 전체 샘플 |
|---|---|---|
| account.name | 호스트 계정 계약(`GroceryAccountDisplayFields`, 세계 패키지에서 공개) / `person.fullName` | 고정 업무 계정4 |
| product.name | grocery_product / 공급 `catalog.item(grocery:true)`의 이름+A 크기; 동일 종류·크기의 순번 산지로 구분 | 상품48 |
| product.origin | grocery_product / `grocery.originRegion` | 상품48 |
| product.harvest | grocery_product / `grocery.harvestNote` | 상품48 |
| address.line | shopper / `address.streetAddress`+`address.city` | 구매자2주소, owner:code 키 |
| orderNote.text | grocery_order / `grocery.doorNote` | 시드 주문18 |
| reviewBody.text | grocery_review / `grocery.harvestNote`(생성 신선도 안내) | 시드 후기30 |

`GroceryHostDisplay`가 기능별 fieldset을 합치며 중복 fieldKey는 StateError다. `GroceryDisplay`는 `DisplayProjector`의 읽기 창이고 앱/콘솔/원격 저장소가 같은 키를 쓴다. feature는 호스트를 import하지 않는다. 시험·Widgetbook은 필요한 실제 기능 생성기를 조립하고 운영 저장소와 같은 매퍼를 쓴다.

기존 A faker(seed436·clock2026-01-15T00:00Z·ko·기존 derive 경로)는 그대로다. 후보가 제안한 A businessFaker 스트림 교체는 이미 저장된 값을 바꾸므로 채택하지 않았다. B는 같은 고정 config의 별도 `displaySeed`와 entity/id/field stream에서 생성한다. getter는 표시 memo만 채우고 업무 저장·재시드·알림을 하지 않는다. 같은 DisplayProjector를 유지한 채 locale만 바꿔 이전 언어 memo도 보존한다.

## 실제 11언어 × 필드 지원표

실측 명령은 `package/grocery_host`에서 다음과 같다. 아래 표는 `DemoLocaleSupport.evaluate`의 **실제 198키×11언어 출력**이며 `locale-support.json`에 모든 값·77개 보고·스크립트/영어 동일 비율·시드 필드 목록을 보관했다.

```sh
GROCERY_LOCALE_EVIDENCE=/absolute/path/locale-support.json \
  flutter test --no-pub test/src/grocery_locale_projection_test.dart --reporter expanded
```

a66629f6 의 classifier 는 11개 언어가 같은 값(언어 중립)인 키를 `gaps` 로 보고하고 그 필드를 `partialFallback` 으로 내린다(co-package#96). 시험은 gap 0 · `product.name` 11언어 native 를 고정한다 — 예전 「5/48 SKU 폴백」 예외는 닫혔다.

| field | ko | en | zh-Hans | ja | de | fr | es | pt | it | ru | ar |
|---|---|---|---|---|---|---|---|---|---|---|---|
| `account.name` | native | native | native | native | native | native | native | native | native | native | native |
| `product.name` | native | native | native | native | native | native | native | native | native | native | native |
| `product.origin` | native | native | native | native | native | native | native | native | native | native | native |
| `product.harvest` | native | native | native | native | native | native | native | native | native | native | native |
| `address.line` | native | native | native | native | native | native | native | native | native | native | native |
| `orderNote.text` | native | native | native | native | native | native | native | native | native | native | native |
| `reviewBody.text` | native | native | native | native | native | native | native | native | native | native | native |

아랍어의 이름/주소/grocery 역할도 a66629f6 실제 출력은 native다. `product.name`은 48/48 공급 이름이다 — 회전 카탈로그 밖 **계란 GP-0004/0011/0018·한우 국거리 GP-0008·루꼴라 GP-0031**은 공급의 별도 종류 표(`CoFakerCatalog.groceryKindName` · `groceryPackLabel`, [co-package#96](https://github.com/coco-de/co-package/issues/96))에서 읽는다(예: ko `계란 10구` · en `Eggs 10-pack` · ar `بيض عبوة من 10`). 데모 사전으로 메우지 않았고 7종 회전 위치는 바뀌지 않아 나머지 43개 이름은 그대로다.

공급 locale 데이터가 native인 것과 최종 화면 전체가 번역·형식·RTL을 보장하는 것은 다르다. CoUI 달력 월·요일·Pagination 등 chrome 은 v0.159.0 에서 11개 언어로 나온다([coui#5354](https://github.com/coco-de/coui/pull/5354) — 예전 [coui#5084](https://github.com/coco-de/coui/issues/5084) 언어 고정 예외는 닫혔다). 앱 우회 delegate 는 여전히 두지 않는다.

## 시드 필드 전수 목록

아래는 동일 실측 실행이 `GroceryWorldSeed.build()`에서 모은 실제 저장 필드다. `orders.note`, `reviews.body`는 C(null일 때 B), 나머지는 A이며 표시 원문을 저장하지 않는다. 빈 `requests`는 실행 때 id(=requestKey)/order를 기록하는 A 멱등 원장이다. snapshot version/now/sequences도 A다. 모델의 추가·nullable 필드는 기능 원장/SDK 계약과 위 PRD 표를 함께 따른다.

| 컬렉션 | 실제 저장 필드 |
|---|---|
| accounts | `id`, `role`, `scopes` |
| products | `category`, `createdAt`, `id`, `listPrice`, `price`, `rating`, `revision`, `seasonal`, `seed`, `stock`, `storage` |
| categories | `category`, `id`, `parent`, `sort` |
| options | `group`, `id`, `label`, `multi`, `price`, `product`, `required` |
| cart | `addedAt`, `id`, `options`, `owner`, `product`, `quantity`, `revision`, `storage`, `unit` |
| slots | `capacity`, `closed`, `cutoff`, `day`, `ends`, `id`, `kind`, `revision`, `starts`, `zone` |
| holds | `id`, `order`, `owner`, `seed`, `slot` |
| orders | `address`, `at`, `fee`, `id`, `note`, `noteKey`, `owner`, `policy`, `revision`, `seed`, `slot`, `status`, `total` |
| order_lines | `id`, `options`, `order`, `product`, `quantity`, `refunded`, `storage`, `unit` |
| events | `at`, `contactConfirmed`, `fromProduct`, `fromStatus`, `id`, `kind`, `mockRefund`, `order`, `owner`, `policy`, `refundAmount`, `seed`, `status`, `toProduct` |
| picks | `bin`, `id`, `order`, `product`, `quantity`, `revision`, `status`, `storage`, `substitute`, `unit` |
| requests | 시드0행 — 실행 시 멱등 A |
| subscriptions | `active`, `cycle`, `id`, `kind`, `next`, `owner`, `revision`, `skip`, `weekday` |
| reviews | `at`, `body`, `bodyKey`, `id`, `line`, `order`, `owner`, `photo`, `product`, `rating`, `seed` |
| shoppers | `addresses`, `coupons`, `grade`, `id`, `points`, `revision` |
| alerts | `at`, `category`, `id`, `kind`, `owner`, `read`, `seed` |

W4-06 단언은 11언어 B 측정, 48×11 목록/상세 동일 ID·값, 전체 A 컬렉션·revision 불변, 언어 복귀 결정성, 읽기 세계 신호0, 중복 소유·미등록 필드 명시 실패다. 번역은 14개 Slang 카탈로그×11언어의 키·placeholder·한글 잔존·빈값·순서·형식 패리티로 검증한다. **L3/6 preboot·공유 prefs/iframe·stale async·C overlay, L5 Linux 골든/실제 앱 Patrol/공개 브라우저는 다음 묶음**이다.