659 S4 W4-02 — baseline v1 소비 정렬

# #659 S4 W4-02 — baseline v1 소비 정렬

2026-10-10 PC-A 임시 writer. [설계 정본](s3-design-record.md) §10·§12와 [결합 계획](s4-integration-plan.md)을 구현했다. 출발점은 W4-01 PR3 head `127ed8d01057de8fa4a1a4b6bd100816e1244f26`이며 브랜치는 `story/cocode-659-s4-baseline-v1`, PR base는 `main`이다. PR2/3 또는 기존 후보 브랜치를 머지하지 않았다.

## 변경과 정렬 근거

co-package git ref **21개 / pubspec14개**(workspace의 기존 소비 전체 + standalone gallery)를 `d23a5c42a4b653491545d0744ab349b810e579dc`에서 승인 **`c003ca2c018731436dd4d37f3d4473e7bdf9e187`**로 일괄 바꾸고 두 pub 루트 lock을 공식 pub get으로 갱신했다. active pubspec/lock에 old ref는 0개이며 S-9 검사 `git_deps=25 violations=0`이다. 현재 직접 소비는 co_faker·co_bdd·co_golden·gallery이며 co_demo_world/prefs 적용은 후속 W4-06~07이다.

coordinator의 이번 dispatch 판정에 따라 Serverpod **4.0.4 → 4.0.3**을 `python3 tool/serverpod/profile.py apply stable --version 4.0.3`으로만 변경했다. workspace/server/client/Flutter/auth/cloud/test 및 고정 CLI pubspec18개가 profile 한 출처를 따르고 root/CLI lock의 Serverpod 계열이 4.0.3이다. CLI의 serverpod_tui 0.14.0→0.12.0도 공식 4.0.3 의존 해석 결과다. 전역 CLI·FVM·공용 저장소는 변경하지 않았다. CoUI는 승인 v1 `coui_flutter-v0.158.0`/`coui_core-v0.157.0` 그대로다.

후보 공통 `feb906da8c3177ea7614b5539f32218394b1f358`의 시험 원본만 한 번 재사용했다: multi-server binding SDK 시험 포트를 `GroceryItServer.defaultPort +2/+4`로 계산한다. 그 후보의 generated test tools는 가져오지 않았다. 생성 SDK·Slang·route·BDD·migration history를 수기로 편집하지 않았다.

## 공급 영향 — 실제 소비와 후속 구분

| 항목 | 확인 결과 |
|---|---|
| co_faker | 승인 tree의 0.13.0 소비(기존0.11.1). 11언어 공급 확장 자체가 앱의 11언어 완료는 아님 |
| DisplayProjector API | 두 고정 ref의 `display_projector.dart`·`display_field_set.dart`·`demo_world_config.dart`·`user_edit_overlay.dart` byte 동일. 현재 앱은 기존 GroceryDisplay를 사용; API 이관 없음 |
| locale 해석 | 공급 DemoFakerLocales의 es→es_ES, ar→ar_SA 및 resolution API 추가. 소비 언어는 아직 ko/en이며 나머지는 en 투영; W4-06~07에서 전수 이관/지원표/overlay/첫프레임 검증 |
| 번역·seed·fixture | Slang 원본/생성 diff0. 두 cache ref를 별도 package_config로 주입한 같은 프로브에서 **A seed 동일, ko333/en333 B값 변경0**: 상품명/중량/원산지/수확안내·옵션·분류·계정·주소·메모·후기·권역·등급 |
| SDK 계약 | 공식 4.0.3 module→host 생성 결과 기존 파일과 동일; 공개 업무 요청/응답 시그니처 변화0. 실제 SDK 통합과 localOnly/SDK 같은 시나리오 contract를 아래처럼 검증 |
| BDD·prefs·golden·gallery | 해당 공급 lib tree는 두 ref에서 동일. gallery 별도 pub get 및 lock 갱신 성공. 기존 PNG 변경0; Linux capture/compare는 수행하지 않았으므로 golden 게이트 완료 증거는 아님 |

A seed SHA256는 `96e806d2db2739d3784006ec85bc1d8599840de15bdabd15dd3d2f01cefe45bc`이다. 비교 프로브는 런타임 업무 코드를 대체하지 않고 실제 GroceryWorldSeed/GroceryDisplay를 두 승인 cache ref로 각각 실행했다.

## 로컬 검증

Flutter3.47.6 / Dart3.13.5 / macOS arm64. 무거운 명령은 순차 실행했고 검증 전·중 확인한 디스크 Available은 약63~67GiB(약68~72GB)였고 40GB 미만에서 새 무거운 작업을 시작하지 않았다.

| 명령/범위 | 결과 |
|---|---|
| workspace flutter pub get | 4.0.3/c003 해석 성공 |
| gallery dart pub get | exit0 · 0.997s |
| module7 → host Serverpod generate | 고정CLI4.0.3, exit0; SDK diff0 |
| official create-migration | exit0 · 90.079s |
| Flutter slang/build_runner codegen | exit0 · 36.742s |
| Serverpod 반복 생성 | exit0 · 89.48s |
| Flutter 반복 생성 | exit0 · 8.866s |
| dart analyze --fatal-infos | exit0 · 8.287s |
| TZ=UTC tool/dev/test_all.sh | exit0 · 352.718s |
| 필수 SDK/localOnly contract | exit0 · 13.885s |
| tool/gates/check_all.sh | exit0 · 4.263s |

workspace 기존시험 집계: **34패키지 / 466성공 / 625skip / 0실패**. skip은 성공 수에 포함하지 않았다. 일반 시험 중 골든 skip은 Linux compare를 대신하지 않으며, SDK contract의 필수 서버 실행은 별도로 **2개 top-level 테스트 성공 / skip0 / 실패0**이며 같은 **66계약 단계**를 두 저장소에 전수 실행했다.

## DB 두 경로와 이력

**Fresh DB:** official migration으로 빈 격리 Postgres를 초기화해 host SDK 시험을 실행했다. `grocery_schema_snapshot_test.dart`의 baseline/registry 확인과 실제 `information_schema.columns` ↔ 생성 protocol 표 정의 비교 단언 둘 다 실행·통과했다. checkout·권한·무결성·재고·피킹·정기배송·후기·binding 시험을 포함한다.

**기존 fixture DB:** 변경 전4.0.4 환경에서 official baseline으로 만든 격리 DB에 GroceryDemoSeed를 넣고 실제 생성 SDK로 `SB-20260115-0042` 생성/모의결제(25280)를 실행했다. **18업무 테이블429행**을 저장한 뒤 변경 후4.0.3 서버를 **동일 DB**에 `--apply-migrations`로 부팅했다. `Latest database migration already applied`, 18테이블의 모든 row JSON과 A seed/ko/en 상품 표시가 동일함을 단언했다. 준비 실행은 4.0.4 provenance이며 검증 실행은 4.0.3으로 따로 기록했다. 비교 뒤 이 실행이 만든 fixture DB만 정리했다.

기존 migration/registry **48파일 SHA256 모두 동일**. official `tool/serverpod/cli.sh create-migration`은 module7+host8대상 모두 `No changes detected`(exit0)였으므로 append할 schema 변경이 없었다. 새 version/baseline으로 바꾸거나 이전 이력을 삭제하지 않았다. 반복 생성 **248파일 hash diff0**(Slang/SDK/route/BDD/test tools; ignored envied 제외).

## 증거와 후속

PC-A 원본 프로브·fixture snapshot·row 비교 결과·migration 해시·표시/반복생성 결과·명령 exit/시간·시험 집계는 `/Users/dongwoo/orca/toolchains/637/xhost/s4-659-w4-02/`에 보존하고 `artifact-sha256.json`으로 해시를 기록했다. secret/password/envied 산출물은 보고서에 넣지 않는다. 이 보고서는 local 검증이며 기본 브랜치 같은 SHA의 13게이트 PASS 또는 사이드카를 대신하지 않는다.

설계 §1 대비 **FR 상태 변화0: 구현+검증17·부분8**. 기존 FR50AC 현황에서 공급 정렬만 완료했고 새 FR 완료를 선언하지 않았다. baseline 버전 차이/cocode#1138 판정과 실제 정렬은 해소됐으며 이후 W4-03은 이 PR head에서 새 스택으로 진행한다: revision 원본 선별→공식 새 migration append→fresh/기존fixture DB→동시성·멱등·contract→충돌 뒤 최신 UI. 그다음 W4-04 login, W4-05 FR 보강, W4-06~13 locale/검증/표면/증거 순서다.

| 남은 BLOCKED / issue | next |
|---|---|
| 조직 Actions 예산 / cocode#637 | PR3 annotation `The job was not started because an Actions budget is preventing further use` 확인. 재실행·workflow 변경 없음; 예산 복구 뒤 coordinator 머지 열차와 같은 main SHA 검증 |
| bundle profile/verified / co-bricks#830/#831/#764, generation-lock/#860 | 소유자 공급 증거 후 승인 ref 소비·full cleanbase/diff0. legacy stamp 수기 승격 금지 |
| v3 option_sheet / cocode#638 F3 | generator/CoUI 소유자 공급 후 소비 |
| 기본아이콘 / coui#5149 | 승인 해결 ref 후 네트워크0 회귀; 현재 subset 우회는 upstream 완료 아님 |
| Patrol runner / cocode#659 AC12 | W4-09 앱 여정 작성·생성 뒤 승인 runner/device 실행 |
| Mobbin 접근 / cocode#659 AC15 | 접근 가능한 세션에서 실제21화면·옵션 참조 재실측 |
| canonical 공개6표면 / cocode#659 AC16 | W4-11 배선·HTTP·public smoke, W4-12 full 재현 |

§14 PG/실환불·배송기사API·주소검색·push·billing/scheduling·쿠폰/적립·WMS·media_upload capability 경계는 변경하지 않았다. 공개 Pages localOnly와 원격 설정 누락의 명시 오류 정책도 유지한다. 공급 상향이나 로컬 성공만으로 앱 전체/locale/verified/갤러리 체험 가능을 선언하지 않는다.