659 S4 W4-03 — revision 부분 재사용
# #659 S4 W4-03 — revision 부분 재사용
2026-10-10 PC-A 임시 writer. [설계 정본](s3-design-record.md) §8·§12 및 [결합 계획](s4-integration-plan.md)을 따라 PR4 head `1b4927e8cb402621a5ea10b129ab311fb6617dc4`에서 `story/cocode-659-s4-revision`을 만들었다. PR base는 `main`, 선행은 PR4다. 기존 후보·PR2/3/4를 머지하거나 수정하지 않았다.
## 구현과 재사용 경계
revision 후보의 공통 `feb906d` 이후 여섯 커밋(`ca44b351`·`1bb0d231`·`9bf8be45`·`909414a2`·`5da65c6e`·`59074dfb`)에서 **원본 130파일**을 선별 적용했다. 모델 YAML·endpoint/service·local/remote repository·entity/use-case·cubit/page·번역 JSON·단언이 있는 테스트만 가져왔다. 후보의 생성 SDK·Slang·test tools 및 baseline 삭제/교체는 제외했다. 공통 포트 변경은 W4-02의 적용을 유지했다.
| 쓰기 | 비교하는 기대 revision / 결과 |
|---|---|
| 구매자 결제·취소 / 콘솔 주문 전이 | 잠근 주문 행과 비교. 상태가 바뀌면 +1, 최신 판의 같은 상태 재시도는 쓰기 없음 |
| 피킹 결과 | 주문 잠금으로 불변식을 지키면서 **피킹 줄 판**을 비교. 독립 줄의 거짓 충돌을 피한다. 결과 기록은 줄 +1, 환불은 금액이 바뀌므로 주문도 +1 |
| cart 수량·삭제 | 상품→줄 순서로 잠근 뒤 줄 판 비교. 합산/수량 변경 +1, 최신 판의 같은 수량은 쓰기 없음 |
| slot 마감·해제 | 슬롯 행 판 비교. 마감 변경 +1, holds 보존, 같은 값은 쓰기 없음 |
| SH 기본 배송지 | 본인 프로필 판 비교. 기본 배송지 변경 +1, 같은 값은 쓰기 없음 |
| SUB 설정 | 본인 설정 판 비교. 실제 설정 변경 +1, 같은 결과는 쓰기 없음 |
낡은 판은 `conflict`로 거절한다. 화면은 기대 판을 요청에 담고 충돌 뒤 다시 읽는다. 구매자/콘솔 주문 보드는 해당 주문의 최신 상태 탭으로 이동하고, 피킹·cart·slot·SH·SUB도 최신 데이터를 보이며 충돌 문구를 표시한다. 콘솔 주문 취소 경합과 피커의 선행 환불 경합에 **실제 위젯 단언 2개**를 추가했다. 다른 탭의 선행 쓰기를 받아들이되 실패한 초안은 저장하지 않는 `GroceryWorld.transact` 동작과, 판이 없는 기존 브라우저 행을 1로 해석하는 호환도 시험했다.
## W4-02 skip 625개 전수 분류
W4-02 원본 실행 로그의 모든 `Skip:`를 파일/시나리오별로 집계했다. **625 = 골든 624 + SDK contract 1**, 다른 DB/플랫폼/임의 skip은 0개다. skip은 성공 또는 완료로 세지 않는다.
| 패키지 / test 파일 | 시나리오 그룹 | skip |
|---|---:|---:|
| app_router/app · `golden/kernel_status_golden_test.dart` | 2 | 24 |
| grocery_product/app · `golden/grocery_product_golden_test.dart` | 6 | 144 |
| grocery_product/console · `golden/console_grocery_product_golden_test.dart` | 2 | 48 |
| delivery_slot/app · `golden/delivery_slot_golden_test.dart` | 1 | 24 |
| delivery_slot/console · `golden/console_delivery_slot_golden_test.dart` | 2 | 48 |
| grocery_order/app · `golden/grocery_order_golden_test.dart` | 3 | 72 |
| grocery_order/console · `golden/console_grocery_order_golden_test.dart` | 6 | 144 |
| delivery_subscription/app · `golden/delivery_subscription_golden_test.dart` | 1 | 24 |
| grocery_review/app · `golden/grocery_review_golden_test.dart` | 2 | 48 |
| shopper/app · `golden/shopper_golden_test.dart` | 1 | 24 |
| grocery_alert/app · `golden/grocery_alert_golden_test.dart` | 1 | 24 |
| package/grocery_host · `contract/grocery_contract_test.dart` | 1 | 1 |
골든은 **11파일·27그룹·624변형**이다. 실제 skip 조건은 `CO_GOLDEN_MODE` 미설정이며 OS 검사 자체가 아니다. 커널 2그룹은 ko×3기기×2테마×2배율=12변형씩, 업무 25그룹은 ko/en×3기기×2테마×2배율=24변형씩이다. 기준 생성/compare는 저장소 계약상 Linux에서 수행하며, 이번 macOS 일반 시험은 그 게이트 증거가 아니다. Actions 예산 / cocode#637 및 W4-08 Linux capture·compare가 next다.
비골든 1개는 `GROCERY_CONTRACT_URL`이 없는 일반 시험에서 실제 계약 서버가 필요해 조건부 skip된다. 이번에는 격리 DB의 계약 서버를 직접 띄우고 `GROCERY_CONTRACT_REQUIRED=1`로 **2개 top-level 테스트 / 83단계씩 / skip0 / 실패0**을 실행했다. 설정 누락은 실패하며 조용한 mock 폴백은 없다. 근거 없는 비골든 skip은 남지 않았다. 일반 workspace 집계의 조건부 1개와 별도 필수 실행을 구분한다.
## 공식 migration과 DB 두 경로
고정 CLI **Serverpod 4.0.3**의 `tool/feature_modules generate` → `tool/feature_modules create-migration -- --tag revision`을 실행했다. 과거 baseline 정의 **40파일 hash diff0**, 기존 registry 8개는 **6개 append·2개 byte 동일**이며 모든 이전 내용이 prefix로 보존된다. 새 migration은 5개 기능 module+host, **6디렉터리·30파일**이다.
| 소유 | 추가 migration |
|---|---|
| delivery_slot | `20261010025315808-revision` |
| delivery_subscription | `20261010025327424-revision` |
| grocery_order | `20261010025350571-revision` |
| grocery_product | `20261010025402490-revision` |
| shopper | `20261010025425814-revision` |
| host | `20261010025437500-revision` |
업무 DDL은 `delivery_slot`·`delivery_subscription`·`grocery_order`·`pick_line`·`cart_line`·`shopper_profile`의 `revision bigint NOT NULL DEFAULT 1` 추가뿐이다. 기존 테이블/행 삭제·baseline 교체가 없다. GP 상품의 기존 revision은 유지한다.
**Fresh DB:** 새 격리 Postgres에 공식 전체 migration을 적용해 생성 SDK→호스트 dispatcher→기능 service→DB 테스트 **65개 / skip0 / 실패0**을 실행했다. 원래 baseline 이름과 registry 순서 보존, 실제 information_schema 컬럼↔생성 protocol 표 정의 비교, 동시 결제/취소/피킹/재고/cart/slot/SH/SUB 경합과 rollback·멱등 단언을 포함한다.
**기존 fixture upgrade:** 변경 전 **4.0.3 + PR4 모델**로 격리 DB를 만들고 seed와 SDK 주문 생성/모의결제를 저장했다. 변경 후 같은 DB를 `--apply-migrations`로 부팅해 **18업무 테이블·429행의 기존 모든 컬럼값 동일**, 추가 revision 기본값1, seed의 기존 업무 값/순서 동일(새 revision 키=1만 허용), ko/en 상품명 투영 동일을 단언했다. 성공 후 이 실행이 만든 fixture DB만 정리했다.
첫 fresh 시험은 하네스 `_fingerprint`의 단일 migration 디렉터리 가정 때문에 setup/teardown 16건이 실패했다. 이를 공식 registry의 **최신 definition.sql** 지문으로 바꾸고 전체 host 시험을 다시 실행해 65개가 통과했다. 스키마 시험도 baseline 단일 디렉터리 조건을 원래 baseline+정렬된 append 이력 조건으로 바꿨다. 실패 로그와 수정 후 로그를 모두 보존한다.
## 로컬 검증과 공급 영향
Flutter3.47.6 / Dart3.13.5 / macOS arm64. 무거운 작업은 순차 실행했고 디스크 여유는 약63GiB로 40GB 이상이었다. Serverpod profile/CLI/pubspec/lock은 **4.0.3 고정**, co-package **c003ca2c**, CoUI **v0.158.0**이며 이 묶음의 공급 ref 변경은 0개다.
| 검증 | 결과 |
|---|---|
| workspace flutter pub get | exit0 · 1.830s |
| module7→host Serverpod generate | exit0 · 129.187s |
| 공식 revision migration 생성 | exit0 · 93.908s |
| Flutter Slang/build_runner codegen | exit0 · 17.762s |
| 기존 fixture 준비→upgrade | exit0 · 8.706s / 8.431s |
| dart analyze --fatal-infos | exit0; 하네스 수정 후 최종 재검사도 수행 |
| 계약 게이트 check_all.sh | exit0 · 4.764s |
| TZ=UTC 전체 workspace 시험 | 34패키지, 초기 host setup 실패 후 해당 host 전체 재검증; 최종 합산 **500성공 / 625skip / 0실패** |
| host 전체 재검증 | exit0 · 14.647s · 65성공 / skip0 / 실패0 |
| 필수 SDK/localOnly contract | exit0 · 13.697s · 2성공 / skip0 / 실패0, 같은 83단계 전수 |
| Serverpod→Flutter 반복 생성 | exit0 · 90.553s / 16.772s · **248생성물 hash diff0** |
최종 500 집계는 전체 실행 중 정상 완료된 33패키지 결과에 수정 후 host 65개 결과를 결합했다. 초기 전체 명령 exit1을 exit0으로 바꾸어 보고하지 않는다. 콘솔의 추가 위젯 2개를 포함해 해당 패키지는 15성공이다.
번역 변화는 GO·GP·DS·SH·SUB의 **ko/en conflict 키 10개**와 공식 Slang 생성 결과다. DisplayProjector 이관/지원 locale 확장은 없고 co_faker 상품 표시 투영은 유지한다. seed/fixture 변화는 위 revision A 필드 추가뿐이며 돈·수량·FK·owner·순서·사용자 C 입력은 보존한다. 골든 PNG 변화0; Linux compare는 미실행이다. W4-02의 c003 영향표를 승계하며 새 공급 상향 효과를 선언하지 않는다.
PC-A 원본 패치·skip 분류 JSON·fixture 비교·migration/생성물 해시·명령 exit/시간·실패/재검증 로그는 `/Users/dongwoo/orca/toolchains/637/xhost/s4-659-w4-03/`에 보존하고 `artifact-sha256.json`으로 해시를 기록한다. 생성 SDK import·migration history·Slang·BDD/test tools 수기 편집은 0이다.
## FR 상태와 남은 BLOCKED
설계 §1 대비 **FR 상태 변화0: 구현+검증17·부분8**. 이번 묶음은 local 검증으로 FB3/FB5 revision 결합 빈틈을 보강했으며 같은 main SHA의 13게이트 완료/verified/앱 전체 완료를 선언하지 않는다. 공개 Pages localOnly·업무 네트워크0 배선과 서버 설정 누락의 명시 오류 정책을 유지한다. §14의 PG/실환불·배송기사API·주소검색·push·billing/scheduling·쿠폰/적립·WMS·media_upload capability 경계는 그대로다.
| 남은 BLOCKED / issue | next |
|---|---|
| 조직 Actions 예산 / cocode#637 | 로컬 검증까지 제출. 예산 복구 뒤 coordinator가 PR2→3→4→이번 PR 머지 열차 및 같은 main SHA 게이트 실행. 조사/재실행/workflow 수정 없음 |
| Linux golden compare / cocode#659 S-14, W4-08 | 624 skip을 완료로 세지 않고 Linux capture와 compare 증거를 별도 제출 |
| bundle profile/verified / co-bricks#830/#831/#764, generation-lock/#860 | 소유자 승인 공급 뒤 full cleanbase·반복 생성; legacy stamp 수기 승격 금지 |
| v3 option_sheet / cocode#638 F3 · 아이콘 / coui#5149 | 승인 baseline 해결 ref 공급 후 소비. 진행 중 coui#5354 임의 소비 없음 |
| Patrol / cocode#659 AC12 · Mobbin / AC15 · canonical 6표면 / AC16 | W4-09~12 작성/실행/실측/공개 검증, 접근 또는 runner 부재는 BLOCKED 유지 |
다음 묶음은 이 PR head의 **W4-04 login**이다. JWT→업무 계정/caller ports·me·restore/logout/error와 실제 IdP SDK/앱 gate를 검증하고 revision 이력을 보존한다. bootstrap은 login gate와 locale preboot/presentation의 소유를 분리하는 결합 계획부터 세우고 W4-06~07 locale 후보를 통째로 가져오지 않는다. 이후 W4-05 FR 보강→W4-06~13 순서를 유지한다.