659 S3 설계 기록 — 새벽들녘 / ecommerce_grocery
# #659 S3 설계 기록 — 새벽들녘 / ecommerce_grocery
> 작성: 2026-10-10, PC-A(M3 Max) 임시 writer. 검토 대상 소스는 `main` **`9b7e1c31361bbe9506f0e32c101df073ddd7702d`**다. PC-C는 §12를 이어받는다. 이 PR은 이 문서만 추가하며 기능·공급 ref·기존 브랜치·migration을 변경하지 않는다. 머지는 코디네이터 승인 후다.
정본은 [PRD #659 전체 본문](https://github.com/coco-de/cocode/issues/659), 계약 커밋 `62edf3c5863c98f85ba2a6027d376ea412452255`의 [execution-contract](https://github.com/coco-de/cocode/blob/62edf3c5863c98f85ba2a6027d376ea412452255/docs/projects/637/execution-contract.md), [phases](https://github.com/coco-de/cocode/blob/62edf3c5863c98f85ba2a6027d376ea412452255/docs/projects/637/phases.md), [baseline v1](https://github.com/coco-de/cocode/blob/62edf3c5863c98f85ba2a6027d376ea412452255/docs/projects/637/baseline-manifest.md), [prd-dependencies](https://github.com/coco-de/cocode/blob/62edf3c5863c98f85ba2a6027d376ea412452255/docs/projects/637/prd-dependencies.md), [change-requests](https://github.com/coco-de/cocode/blob/62edf3c5863c98f85ba2a6027d376ea412452255/docs/projects/637/change-requests.md), [증거 형식](https://github.com/coco-de/cocode/blob/62edf3c5863c98f85ba2a6027d376ea412452255/docs/demo-evidence/README.md)이다. private 원문은 인증된 `gh` 읽기로 확보했다. 다른 POC의 S3 문서는 구성만 읽고 이 앱의 소스·실행으로 채웠다.
기존 [풀스택 배치 기록](../fullstack-feature-layout.md)은 소유권·조립 이력의 상세 자료다. 그 문서의 과거 수치나 체크 표시를 현재 완료 증거로 승계하지 않는다. `feature-verification`의 단언·실행 분리, `flutter-app-baseline`의 feature 소유·실행 앱 Patrol 분리 기준을 적용했다.
| 판정 항목 | 실측 결과 |
|---|---|
| FR | **25개 / 구현+검증 24 / 부분 1 / 구현만 0 / 없음 0**(W4-05 로컬 회귀). 부분은 FR-023의 공개 두 탭 증거; [W4-05 보고](s4-w4-05-fr.md) · [W4-06 투영 회귀](s4-w4-06-locale-data.md) |
| FR 수준 AC | 50개. 아래 표에 AC1·AC2를 각각 판정. 전체 앱 완료 판정과 구분 |
| 실제 업무 화면 | app 15 + console 6, Page↔use-case 누락 0(셸·상태 화면 예외는 §4) |
| 현재 소스의 CI | 같은 main SHA의 CI·Golden(compare)·Pages 성공, §6·7에 잡과 링크 명시 |
| plan | exit 0, FR25 매핑 / 결정론 covered17 / semantic review-pending8 / orphan0 / NFR13 보고 / capability 합성1·hand-author15 |
| cleanbase quick | **S3b 성공**: exit0·74.841s·16단계 exit0·**1683파일**·digest `c09ea15ab7e9c18d2f146f02c92e376f7365f63b9dd66ae4468992e00288f607`. 이전 디스크 BLOCKED 보고 보존 (§9) |
| 공개 표면 | 2026-10-10 HTTP 읽기: `/`·`app/`·`console/`·`golden/` 200, `widgetbook/`·`docs/` 404. 기존 `app-widgetbook/`는 200 |
| 전체 완료 | 선언하지 않음. 11개 언어·Patrol·full cleanbase·6표면·bundle verified·Mobbin 재실측·사이드카가 남음 |
## 1. FR/AC 전수 대조
표의 축약 경로는 다음과 같이 실제 경로로 확장한다. `P(d,r)=feature/<d>/<r>/lib/src/presentation/page`, `T(d,r)=feature/<d>/<r>/test/src`, `G(d,r)=feature/<d>/<r>/test/golden`, `WB(d,r)=feature/<d>/<r>/widgetbook`. `a=app`, `c=console`, `GP=grocery_product`, `DS=delivery_slot`, `GO=grocery_order`, `SUB=delivery_subscription`, `RV=grocery_review`, `SH=shopper`, `AL=grocery_alert`. 예: `P(GP,a)/grocery_cart_page.dart`는 `feature/grocery_product/app/lib/src/presentation/page/grocery_cart_page.dart`다. 소유 bundle은 `feature/<d>/bundle.json`이다.
`구현+검증`은 해당 동작의 단언과 실행 근거가 있다는 뜻이다. S3는 당시 main CI, W4-05 보강은 [로컬 회귀 보고](s4-w4-05-fr.md)가 근거다. 조직 Actions 예산으로 새 head CI는 실행하지 못했으며, 같은 main SHA의 13게이트 PASS를 뜻하지 않는다. 코드만 있는 AC는 `구현만`; 일부 요구·증거가 빠진 FR은 보수적으로 `부분`이다. TODO·빈 대체 화면·단언 없는 테스트는 `없음`으로 센다. 해당 FR을 대신하는 그런 스텁은 발견하지 않았다. 일반 테스트에서 skip된 골든은 검증 수에 넣지 않았다.
| FR / 소유 | 코드 | AC1 판정·근거 | AC2 판정·근거 | 테스트 경로 | FR 상태 |
|---|---|---|---|---|---|
| 001 진입·역할·초기화 / app_router·console_router·grocery_host | `feature/app_router/app/lib/src/shell/grocery_app_shell.dart`; `package/grocery_host/lib/src/` | 구현+검증(로컬 W4-05): 첫 「구매자 오하늘로 시작」→홈·배너, 역할 선택 새 세션 복원; server login과 분리 | 구현+검증: 생성 0042 삭제 및 장바구니3줄 복원, namespace 격리 | `app/app/test/app_test.dart`, `package/grocery_host/test/src/grocery_entry_test.dart`, `T(app_router,a)/grocery_app_shell_test.dart`, `bdd/grocery_demo_tour.feature`; `package/grocery_host/test/src/grocery_tour_test.dart`; `package/grocery_world/test/src/grocery_world_test.dart` | 구현+검증 |
| 002 홈 / GP | `P(GP,a)/grocery_home_page.dart` | 구현+검증: seed48·제철6 + 7레일·딸기 카드 단언 | 구현+검증(로컬 W4-05): 홈 empty의 EmptyState·카테고리 CTA→실제 분류 route·data 단언 | `T(app_router,a)/grocery_app_shell_test.dart`, `T(GP,a)/presentation/grocery_product_pages_test.dart`; `package/grocery_world/test/src/grocery_world_seed_test.dart`; `WB(GP,a)/lib/src/grocery_home_page_use_case.dart` | 구현+검증 |
| 003 2단 탐색 / GP | `P(GP,a)/produce_browse_page.dart` | 구현+검증: 과일 → 딸기·베리/감귤/사과·배 3타일 | 구현+검증(로컬 W4-05): 정확히822dp·과일 선택 후 3타일의 x좌표가 루트 오른쪽, 가용 폭 안·overflow0 단언 | `T(GP,a)/presentation/grocery_product_pages_test.dart`, `T(GP,a)/bdd/grocery_browse.feature`; `G(GP,a)/grocery_product_golden_test.dart` | 구현+검증 |
| 004 그리드·품절 / GP | `P(GP,a)/grocery_catalog_page.dart`, `grocery_product_detail_page.dart` | 구현+검증: 채소10개·딸기 제외 | 구현+검증: 루꼴라 품절·상세 CTA null | `T(GP,a)/bdd/grocery_browse.feature`; `presentation/grocery_product_pages_test.dart` | 구현+검증 |
| 005 상세 / GP | `P(GP,a)/grocery_product_detail_page.dart`; `feature/grocery_product/app/lib/src/domain/entity/grocery_product.dart` | 구현+검증: 딸기12900·18%·냉장 | 구현+검증(로컬 W4-05): 정가=판매가 및 정가<판매가에서 정가·할인 key 없음, 판매가·면책 유지 단언 | `T(GP,a)/presentation/grocery_product_pages_test.dart`; `G(GP,a)/grocery_product_golden_test.dart` | 구현+검증 |
| 006 옵션·담기 / GP | `P(GP,a)/grocery_product_options_page.dart`; `feature/grocery_product/app/lib/src/data/local/grocery_product_local_repository.dart` | 구현+검증: 600g·2개=57800, 재고상한2·합산 | 구현+검증: 필수 미선택 disabled·배지 | `T(GP,a)/bdd/grocery_cart.feature`; `domain/option_selection_test.dart`; `data/grocery_product_local_repository_test.dart`; `presentation/grocery_product_pages_test.dart` | 구현+검증 |
| 007 장바구니 / GP | `P(GP,a)/grocery_cart_page.dart`; `feature/grocery_product/app/lib/src/domain/` | 구현+검증: 35180·3000·4820 + 온도3종 | 구현+검증(로컬 W4-05): 합계39999/40000/40001에서 배송비·무료배송 배지·남은1원 실제 UI 단언 | `T(GP,a)/bdd/grocery_cart.feature`; `domain/cart_pricing_test.dart`; `presentation/grocery_product_pages_test.dart` | 구현+검증 |
| 008 최소금액 / GP | `P(GP,a)/grocery_cart_page.dart` | 구현+검증: 9900이면5100 안내·disabled | 구현+검증: 정확히15000이면 canProceed=true(순수 규칙), CTA는 같은 값 사용 | `T(GP,a)/domain/cart_pricing_test.dart`; `presentation/grocery_product_pages_test.dart` | 구현+검증 |
| 009 슬롯 / DS | `P(DS,a)/delivery_slot_calendar_page.dart`; `feature/delivery_slot/app/lib/src/data/local/` | 구현+검증: 1/16새벽 잔여3·오늘23:00·enabled | 구현+검증: 저녁 잔여0·마감·disabled, cutoff 경계 unit | `T(DS,a)/presentation/delivery_slot_calendar_page_test.dart`; `data/delivery_slot_local_repository_test.dart`; `bdd/delivery_slot.feature` | 구현+검증 |
| 010 주문·모의결제 / GO | `P(GO,a)/grocery_order_create_page.dart`, `grocery_order_board_page.dart`; `feature/grocery_order/app/lib/src/data/local/` | 구현+검증: 0042·pending_payment·모의결제 버튼 | 구현+검증: paid·슬롯3→2·재고차감 | `T(GO,a)/presentation/grocery_order_pages_test.dart`; `data/grocery_order_local_repository_test.dart`; `package/grocery_host/test/src/grocery_tour_test.dart` | 구현+검증 |
| 011 취소 / GO | `P(GO,a)/grocery_order_board_page.dart` | 구현+검증: 확인→cancelled·환불(모의) 이벤트 | 구현+검증: picking 취소 버튼 없음·안내 | `T(GO,a)/presentation/grocery_order_pages_test.dart`; `data/grocery_order_local_repository_test.dart`; `bdd/grocery_order_cancel.feature` | 구현+검증 |
| 012 추적 / GO | `P(GO,a)/grocery_order_tracking_page.dart` | 구현+검증: 시금치200→300·정책·대체 이벤트/배지 분기 | 구현+검증(로컬 W4-05): 실제 주문의 이벤트만0건으로 만든 fixture에서 summary+state-data 유지, EmptyState가 summary 아래인 좌표 단언 | `T(app_router,a)/bdd/grocery_demo_tour.feature`; `T(GO,a)/presentation/grocery_order_pages_test.dart`; `WB(GO,a)/lib/src/grocery_order_tracking_page_use_case.dart` | 구현+검증 |
| 013 정기배송 / SUB | `P(SUB,a)/delivery_subscription_settings_page.dart` | 구현+검증: 1/20→1/27 skip | 구현+검증: 재진입 유지, 활성/요일/주기 저장 | `T(SUB,a)/presentation/delivery_subscription_settings_page_test.dart`; `data/delivery_subscription_local_repository_test.dart`; `bdd/delivery_subscription_settings.feature` | 구현+검증 |
| 014 후기 / RV | `P(RV,a)/grocery_review_list_page.dart`, `grocery_review_create_page.dart` | 구현+검증: 0점 오류, 범위1~5 | 구현+검증: 새 후기 맨 위, delivered·줄당1건 | `T(RV,a)/presentation/grocery_review_pages_test.dart`; `data/grocery_review_local_repository_test.dart`; `bdd/grocery_review.feature` | 구현+검증 |
| 015 내정보 / SH | `P(SH,a)/shopper_profile_page.dart` | 구현+검증: 들녘그린·적립금·쿠폰2·주문수 | 구현+검증: 정기배송 이동 계약 → A11 | `T(SH,a)/presentation/shopper_profile_page_test.dart`; `T(app_router,a)/grocery_app_shell_test.dart`; `T(SH,a)/bdd/shopper_profile.feature` | 구현+검증 |
| 016 알림 / AL | `P(AL,a)/grocery_alert_inbox_page.dart` | 구현+검증: 콘솔 출고→오늘·미읽음 | 구현+검증: 읽음·종배지 감소, 타인거부 | `T(AL,a)/presentation/grocery_alert_inbox_page_test.dart`; `data/grocery_alert_local_repository_test.dart`; `bdd/grocery_alert_inbox.feature` | 구현+검증 |
| 017 콘솔보드 / GO | `P(GO,c)/fulfillment_order_board_page.dart` | 구현+검증: picking 전이·0042 피킹4줄 | 구현+검증: 피커 pack/dispatch 안 보임, 서버도 scope 검사 | `T(GO,c)/presentation/console_grocery_order_pages_test.dart`; `bdd/picking_substitution.feature`; `package/grocery_host/test/src/grocery_tour_test.dart` | 구현+검증 |
| 018 피킹 / GO | `P(GO,c)/pick_line_checklist_page.dart` | 구현+검증: 대체→substituted·event·전줄종결후pack | 구현+검증: refund 정책 대체 disabled·환불 enabled | `T(GO,c)/bdd/picking_substitution.feature`; `presentation/console_grocery_order_pages_test.dart`; `T(GO,a)/data/grocery_order_local_repository_test.dart` | 구현+검증 |
| 019 재고표 / GP | `P(GP,c)/grocery_stock_table_page.dart` | 구현+검증: 0→12·앱품절해제 | 구현+검증: 재고 오름차순·페이지·MD만 수정 | `T(GP,c)/presentation/grocery_stock_table_page_test.dart`, `grocery_stock_table_cubit_test.dart`; `T(GP,a)/data/grocery_stock_local_repository_test.dart` | 구현+검증 |
| 020 슬롯표 / DS | `P(DS,c)/delivery_slot_table_page.dart` | 구현+검증: close→앱disabled | 구현+검증: reopen→capacity−holds, scope | `T(DS,c)/presentation/delivery_slot_table_page_test.dart`, `delivery_slot_table_cubit_test.dart`; `T(DS,a)/data/delivery_slot_admin_local_repository_test.dart` | 구현+검증 |
| 021 출고집계 / GO | `P(GO,c)/dispatch_summary_page.dart` | 구현+검증: paid4·picking3·packed2·출고3, cutoff 지연 집계 | 구현+검증: paid 타일→C01 해당탭 | `T(GO,c)/presentation/console_grocery_order_pages_test.dart`; `bdd/dispatch_summary.feature`; `T(GO,a)/data/grocery_order_local_repository_test.dart` | 구현+검증 |
| 022 품목 / GO | `P(GO,c)/order_invoice_page.dart` | 구현+검증: 대체상품·원래상품·차액0 | 구현+검증: 0품목 EmptyState | `T(GO,c)/presentation/console_grocery_order_pages_test.dart`; `bdd/picking_substitution.feature` | 구현+검증 |
| 023 연동·격리 / grocery_world·grocery_host | `package/grocery_world/lib/src/store/browser_world_store.dart`; `package/grocery_world/lib/src/world/grocery_world.dart` | **부분(공개 증거)**: W4-05 실제 로컬 app/console 두 탭의 0042 출고→trusted focus 단독 반영·route 보존·업무/외부요청0 검증. 공개 두 탭 증거는 W4-11에서 남음 | 구현+검증: 다른 demo-ecommerce-b2b 키를 reset이 보존 | `package/grocery_world/test/src/grocery_world_test.dart`; `T(app_router,a)/bdd/grocery_demo_tour.feature`; `tool/pages/smoke/fr-focus.mjs`(로컬 실제 두 탭), `tool/pages/smoke/smoke.mjs`(공개 투어 검증 남음) | 부분 |
| 024 4상태·미리보기 / 모든 UI bundle | 각 `presentation/cubit/`, `presentation/widget/*state_view.dart`; `package/grocery_host/lib/src/` | 구현+검증: A06 loading/Skeleton·empty | 구현+검증(로컬 W4-05): app15+console6의 4상태·retry·업무/route 보존, WB21×4 knob·retry 전수 단언. Linux 상태별 골든은 W4-08 별도 | `app/app_widgetbook/test/widgetbook_use_case_render_test.dart`, `feature/console_router/console/test/console_router_test.dart`, `T(app_router,a)/grocery_app_shell_test.dart`; `bdd/screen_states.feature`; 각 WB의 `lib/src/*use_case.dart`; `app/app_widgetbook/test/widgetbook_use_case_render_test.dart` | 구현+검증 |
| 025 서버없음 / core·실행app·console | `package/core/lib/src/runtime/`; `app/app/lib/bootstrap.dart`; `app/console/lib/bootstrap.dart` | 구현+검증: remote 설정없음 명시 오류, silent fallback 없음 | 구현+검증: localOnly 배너 | `package/core/test/src/runtime/demo_only_guard_test.dart`; `T(GO,a)/presentation/grocery_order_pages_test.dart`; `T(app_router,a)/bdd/screen_states.feature` | 구현+검증 |
S3의 FR 표는 업무 구현 진척표이며 13게이트 수기 PASS 대장이 아니다. §5 투어는 실제 **9단계**(§3의 8단계 표현보다 우선)로 검증해야 한다. 현재 co_bdd 투어는 콘솔 저장소를 같은 위젯 세계에 적용한다. W4-05에서 첫 역할 진입과 실제 app↔console 두 빌드의 0042 출고/focus는 로컬 검증했다. 공개 전체9단계·9번 슬롯 마감/초기화는 S4 실행 앱 여정에서 이어 붙인다.
PRD §16 공통 AC와 §17 DoD도 다음과 같이 연결한다.
| AC / 요구 | 현재 판정 및 남은 근거 |
|---|---|
| AC-01·02·04·06 체험 | 부분: 첫 역할 선택은 W4-05 로컬 검증; 업무 투어·namespace reset·배너·scope 검증 있음. 공개 두 탭9단계·포커스 증거 남음 |
| AC-03 경계4종 | 구현+검증: 최소금액·재고상한·cutoff/정원·필수옵션 local+SDK. capability는 모의 결제만 |
| AC-05 21×4 | W4-05 로컬 Page21×4·retry와 WB21×4 knob·retry 검증. 상태별 Linux 골든은 W4-08 미완 |
| AC-07·08·09 recipe/catalog/demo | BLOCKED: catalog commerce/verified=true는 legacy stamp. bundle 공급 profile·full cleanbase 불충분 (§9·11) |
| AC-10 Jev7건 / AC-11 ADE | 미검증: 이 앱 소스에 Jev/ADE 회귀 없음; #638 F-4·#640 소유자가 실행 증거 제출 |
| AC-12 co_bdd+Patrol | W4-09: 기존 feature16편 보존 + 실행 앱4원본/8widget·12Patrol 시나리오 작성·공식 생성. widget8 로컬 성공; 승인 device 실행은 **BLOCKED**([보고](s4-w4-09-journeys.md)) |
| AC-13 golden | ko/en·기기3·테마2·배율2 compare 성공. L-5 추가 언어/4상태는 미완 |
| AC-14 scale/DCM | main analyze 성공. 정확한 testScaleInvariant 대상4화면·4조합의 현재 main 증거 없음; locale 후보 하네스는 미채택. DCM 별도 실행 증거 없음 |
| AC-15 Mobbin | 기존 링크2/화면·옵션3장 문서 있음; 현재 MCP 재실측 불가, C02/C04 불완전 원형 (§11) |
| AC-16 6표면 | **W4-11 local wiring/build/smoke 성공, 공개 미배포**: canonical widgetbook/docs 추가·로컬6표면200/render/reload8검사 성공. 공개main404/전체여정은 승인공급·머지열차 뒤 재검증 |
| AC-17 갤러리 | 앱 사이드카 없음. #639 demo_card는 「준비 중」 유지, 공개 게이트 후만 「체험 가능」 |
NFR도 plan의 통과 표시에 포함되지 않는다. NFR-001/010은 current main Pages smoke/자격증명 스캔 성공을 참고하되 6표면·전체 투어·기본아이콘 네트워크를 다시 검증한다. NFR-002/012는 seed/world unit, 008/013은 대비/다크/면책 단언이 있다. NFR-003 캐시 없는 첫 data 3초·지연이미지 실측, 004 semantic 레이블/48dp×scaling 전수, 005 scaleInvariant4조합, 006/007 정확한 가용 폭·폰/와이드 정보 비교, 009 11언어/포매터(L 블록이 ko/en 기본 요구를 확장), 011 콘솔 주소/연락처 마스킹은 §12에 남긴다. 의존 버전·자동범프·S1~17 체크리스트는 기존 게이트와 baseline 차이를 그대로 이어받아 최종 같은 SHA에서 확인하며, 문서만으로 DoD를 체크하지 않는다.
## 2. 도메인 · 역할 · FSM · 불변식
`feature/<d>/app/lib/src/domain/entity/`는 UI의 투영 view, `feature/<d>/server/lib/src/model/*.spy.yaml`은 A 업무 모델 원본, `feature/<d>/client/lib/src/protocol/`은 생성 SDK다. 서버는 이름/주소/상품명 B를 저장하는 PRD 모형을 그대로 복제하지 않고 code/owner/관계로 저장한다. 엔티티·endpoint·서비스 소유권은 다음과 같다.
| §8 엔티티 / bundle | 실제 UI 모델 / 서버 원본(파일 stem) | endpoint → 서비스 (`server/lib/src/endpoint`, `service`) |
|---|---|---|
| grocery_product / GP | `grocery_product.dart` / `grocery_product.spy.yaml` | `grocery_catalog_endpoint.dart` → `grocery_catalog_service.dart`; `grocery_stock_endpoint.dart` → `grocery_stock_service.dart` |
| produce_category / GP | `produce_category.dart` / `produce_category.spy.yaml` | grocery_catalog → grocery_catalog_service |
| product_option / GP | `product_option.dart` / `product_option.spy.yaml` | grocery_catalog → grocery_catalog_service |
| cart_line / GP | `cart_line.dart` / `cart_line.spy.yaml`(owner·product/option codes·unit/qty) | `grocery_cart_endpoint.dart` → `grocery_cart_service.dart` |
| delivery_slot / DS | `delivery_slot.dart` / `delivery_slot.spy.yaml` + `slot_hold.spy.yaml` | `delivery_slot_endpoint.dart`·`delivery_slot_admin_endpoint.dart` → `delivery_slot_service.dart` / `delivery_slot_supply.dart` |
| grocery_order / GO | `grocery_order.dart`·`order_line.dart` / `grocery_order.spy.yaml`·`grocery_order_line.spy.yaml`·`grocery_order_request.spy.yaml` | `grocery_order_endpoint.dart` → `grocery_checkout_service.dart` |
| order_event / GO | `order_event.dart` / `grocery_order_event.spy.yaml`(kind/status/product refs, 표시 문장은 UI 투영) | grocery_order → checkout / `order_event_writer.dart` |
| pick_line / GO | `pick_line.dart` / `pick_line.spy.yaml`(PickStatus·substituteCode·contactConfirmed) | `grocery_fulfillment_endpoint.dart` → `grocery_fulfillment_service.dart` |
| delivery_subscription / SUB | `delivery_subscription.dart` / `delivery_subscription.spy.yaml` | `delivery_subscription_endpoint.dart` → `delivery_subscription_service.dart` |
| grocery_review / RV | `grocery_review.dart` / `grocery_review.spy.yaml`(seed bodyKey 또는 C 본문) | `grocery_review_endpoint.dart` → `grocery_review_service.dart` |
| shopper / SH | `shopper_profile.dart` / `shopper_profile.spy.yaml`(name/grade/address codes) | `shopper_endpoint.dart` → `shopper_service.dart` |
| grocery_alert / AL | `grocery_alert.dart` / `grocery_alert.spy.yaml` + `grocery_alert_sequence.spy.yaml`(kind/order/product refs) | `grocery_alert_endpoint.dart` → `grocery_alert_service.dart` |
컬렉션 별 쓰기 소유자가 하나다. `commerce_products/cart`는 GP의 product/cart, `grocery_orders/pick_lines`는 GO의 order/order_line/pick/event, `grocery_slots/slot_holds`는 DS의 slot/hold로 대응한다. PRD workflow_runtime 스케치는 현재 recipe에 콘솔 운영 구현을 자동 생성하는 선언이 아니다. 동일 테이블을 workflow 모듈에 중복 작성하지 않는다. [`host-integration.json`과 포트 맵](../fullstack-feature-layout.md#5-교차-기능-업무--호출자-소유-계약)을 통해 호출자가 포트를 소유하고 호스트가 같은 Session/Transaction을 전달한다.
역할(현재 `package/grocery_world/lib/src/seed/grocery_demo_accounts.dart`·seed의 scopes): 구매자 `shopper-ohaneul`=checkout/cancel/review/subscription, 매니저 `manager-muntaeo`=orders/pick/pack/dispatch/slots, 피커 `picker-hangyeol`=orders/pick, MD `md-seoyun`=catalog. 앱 구매자는 고정, 콘솔 역할만 셸에서 선택한다. 서버 원본은 `AuthenticationInfo.userIdentifier`와 `scope.name`을 쓰며 각 기능 `service/*actor.dart`가 검사한다. 실제 이메일/JWT→업무 계정 매핑은 login 후보 범위다(§8).
| FSM | 실제 전이·검사 위치 | 불변식·제약 |
|---|---|---|
| 주문 | pending_payment→paid/cancelled; paid→picking/cancelled; picking→packed; packed→out_for_delivery; out_for_delivery→delivered. app `order_status.dart`, server `rule/order_state_machine.dart`·`rule/grocery_order_scopes.dart`; checkout/fulfillment 서비스 | 본인 pay/cancel만, 직원 scope 재검사, picking→packed 전줄 종결, 종료 상태 추가 전이 거부 |
| 피킹 결과 | pending→picked/substituted/refunded. app `pick_status.dart`, server 규칙·fulfillment | substitute는 allow_similar 또는 contact_first+연락완료, refund 정책 대체 금지, 차액0인 후보만 허용. 종결 후 수정 거부 |
| 슬롯 | open/closed + cutoff + capacity−holds; DS 서비스 | 마감은 보존된 holds를 지우지 않고 가용수0, 해제시 capacity−holds. 결제 점유 orderCode 유일·행 lock |
| 정기배송 | active/paused·skipNext·주기1/2/4·요일 | 자동 주문/결제 없음. skip은 PRD대로 1/20→1/27(1주만 이동), inactive면 skip 해제 |
| 위험 / 실제 위치 | 현재 증거 | S4 남은 것 |
|---|---|---|
| 권한·타인 격리 | 모든 기능 local repository + server actor/service의 owner predicate; SDK checkout/catalog/review/subscription/fulfillment 테스트 | login/JWT 매핑 결합 뒤 같은 거부 단언 재실행 |
| revision | `grocery_stock_service.dart`·product model revision, `grocery_stock_local_repository_test.dart` stale 수정 거부. 세계 global revision은 변경 신호용 | 주문/피킹/카트/슬롯/프로필/정기배송의 클라이언트 기대 revision은 main에 없음. revision 후보의 공식 migration과 결합 검증 필요 |
| 멱등 | GO owner+requestKey 주문, DS orderCode 유일 hold, GP product+정규화 옵션 합산, RV lineCode 유일/ON CONFLICT, AL read no-op | 동일 키 동시 요청·재시도 유지; 동일 입력 재실행과 의도된 수량 합산 구분 |
| 돈 | `cart_pricing.dart`·server `rule/order_pricing.dart` 정수 원, 15000/40000/3000, 서버가 cart 원장으로 합계 계산, refund 해당 줄 금액 | 투영/언어 변경은 돈·통화 KRW·차액0 규칙을 바꾸지 않음. 실결제/정산은 capability 밖 |
| 재고·정원·원자성 | GP supply 재고 lock/차감, DS supply slot FOR UPDATE, GO transaction 안에 hold+stock+paid+event; dispatch+event+alert도 같은 transaction | SDK integrity에서 재고0/마감/알림실패 rollback·정원3 동시5요청·취소/피킹 경합 단언 |
| 취소 잔여 | `grocery_checkout_sdk_test.dart`가 paid 취소 후 seat 유지 단언 | PRD §8·§19 R3의 pack 경계 유지. release 요구가 생기면 공급 변경 요청, 임의 수정 금지 |
| 읽기·공유 세계 | `grocery_world.dart`·`browser_world_store.dart`: Web Locks, latest snapshot, focus/storage/visibility; no-op/read 신호0·throw rollback unit | 실제 두 탭의 업무 흐름·초기화 격리를 실행 앱 여정으로 증명 |
## 3. 데이터 A/B/C — L-1 초안
공통 A: 모든 entity id/code·owner·FK·seed·순서·status enum·scope·revision·요청키·금액·수량·재고·capacity/holds·업무시각. B는 번역된 표시 투영이며 A 원장을 덮어쓰지 않는다. C는 사용자가 바꾼 입력/선택 결과로 B보다 우선한다. 같은 필드의 seed 값(B)과 직접 입력(C)은 출처를 보존한다.
| §8 표시 필드 전체 / 엔티티 | A 업무·고정 자산 | B 언어별 표시 | C 사용자 입력 / 우선순위 |
|---|---|---|---|
| grocery_product | price/listPrice·stock·isSeasonal·rating·createdAt; category/storageType 코드; imageUrl의 번들 asset key | name·summary·originRegion·weightLabel; category/storageType 라벨; harvestNote(§10 추가 표시)·이미지 alt | MD 재고 입력은 A 행동 결과; 상품명 편집은 현재 범위 밖 |
| produce_category | parentId·sortOrder·imageUrl key·category code | name·이미지 alt | 없음 |
| product_option | price·required·multiSelect·productCode·group/label code | name·optionGroup 표시(중량/손질/포장), required UI 문구 | 선택 optionCode 집합·quantity는 A 행동 결과 |
| cart_line | unitPrice·quantity·addedAt·storageType·imageUrl key·product/option refs | productName·optionSummary·온도대 라벨(제품/옵션의 같은 키로 투영) | 수량/삭제/옵션 선택은 A 행동 결과 |
| delivery_slot | startsAt·endsAt·remaining·capacity·cutoffAt·slotKind·zone code | label·zoneName·종류 표시. 날짜/마감 문구는 동일 A 시간의 locale 형식 | 선택 slotCode는 A 행동 결과 |
| grocery_order | orderNo·totalAmount·deliveryFee·deliverAt·orderedAt·status·substitutionPolicy code·addressCode | itemSummary(줄 이름으로 파생)·seed recipient/address·slotLabel·seed doorNote | 사용자 doorNote·직접 recipient/address 입력은 C. 시드 주소 선택은 code A + 표시 B |
| order_event | occurredAt·eventKind·status·product/substitute/order refs | title·description(상태/대체/환불/안내를 code 기반 생성, 수량은 A) | 사용자가 남긴 메모가 포함되면 그 부분 C 그대로 |
| pick_line | quantity·orderCode·picked/결과status·product/substitute refs·binLocation 물리 위치 코드 | productName·substituteName·위치 설명 라벨 | 피킹 결과/연락확인/대체 선택은 A 행동 결과 |
| delivery_subscription | isActive·skipNext·cycleWeeks·preferredWeekday·preferredSlotKind 코드·nextDeliveryAt | itemSummary·요일/시간 종류 표시·날짜 형식 | 토글/주기/요일 선택은 A 행동 결과 |
| grocery_review | rating·createdAt·imageUrl asset/photo key·lineCode | seed title·body·freshnessNote·photo alt | 새 title/body/freshnessNote C, rating/photo 선택은 사용자 결과 A, B가 덮어쓰지 않음 |
| shopper | point·couponCount·orderCount·avatarUrl key·defaultAddressCode·grade code | nickname·gradeName·defaultAddress 표시·avatar alt | 사용자가 바꾼 nickname/address 문구는 C(현재 주소 code 선택만 구현) |
| grocery_alert | category code·isRead·createdAt·kind/order/product refs | title·body·category 표시·날짜 section(동일 A 날짜) | 읽음은 A 행동 결과 |
§10 추가 표시도 빠뜨리지 않는다: produceName/produceCategory/originRegion/weightLabel/harvestNote/deliveryZone/slotLabel/substitutionNote/pickerName/seed doorNote는 B, storageType는 A 코드+B 라벨, binLocation은 A 물리 코드+B 안내. 가상 계정4명의 이름은 B이고 식별자·역할·권한은 A다. commerce 주문번호/SKU/쿠폰코드는 A, 상품 이미지 번들 key는 A, 연락처 mobilePhone/postalCode는 안정적인 업무 값(A)으로 마스킹/서식만 locale에 맞춘다. address1/address2의 화면용 가상 주소는 B이며 실제 업무의 국가/권역/addressCode는 A다.
시드 분포는 `package/grocery_world/test/src/grocery_world_seed_test.dart`가 단언한다: 상품48(냉장22/냉동12/상온14, seasonal6, stock0=3), category21, option54/필수그룹18, cart3/22280, slot24/cutoff2/정원0=3, order18(1/4/3/2/3/4/1), event72, pick31, subscription1, review30, shopper1, alert12/미읽음4. seed436·clock `2026-01-15T00:00:00Z`·KRW·Asia/Seoul을 유지한다. GP-0007/0019/0020/0031·고정cart3·DS-0116-DAWN-A/0116-EVE-A/0117-DAWN-A·다음0042는 A fixture로 보존한다.
**투영 계획:** `co_demo_world`의 `DisplayProjector`/`DisplayFieldSet`에 `entity/id/field`를 준다. 예: `grocery_product/GP-0007/name`, `grocery_product/GP-0007/harvestNote`, `produce_category/10/name`, `product_option/OP-1-1/name`, `shopper/shopper-ohaneul/nickname`, `shopper/shopper-ohaneul/address.home`, `order_event/<eventCode>/description`, `grocery_review/<reviewCode>/body`. cart/order/pick의 productName은 새 faker 추출을 하지 않고 **동일 product id/name 투영**을 참조한다. 옵션 그룹/권역/seed 메모도 안정적인 id를 사용하며 목록 위치를 키로 쓰지 않는다. 업무 난수와 표시 난수를 분리, 언어별 memo, `UserEditOverlay` C 우선, 빠른 변경은 `DemoLocaleSwitcher` 마지막 요청만 적용한다.
현재 `package/grocery_world/lib/src/display/grocery_display.dart`는 ko/en만, ja/fr/ar 등을 en으로 바꾸며 이름·분류·페르소나 사전을 직접 둔다. `address()`는 **한국 주소 문자열을 언어와 무관하게 고정**하고 꼬리표만 바꾼다. 이는 L-2의 11개 언어 native/주소 투영 완료가 아니다. S4에서 기능별 표시 field set과 얇은 어댑터로 이전하고 사전 증설은 하지 않는다. 언어고정 예외는 SKU/ID·물리 위치·표준중량의 수치/단위·가상 브랜드 고유명·사용자 원문(C)·예약 asset key이며 법정 문서 예외는 이 앱에 없다. 가상 배송지 전체 한국어 고정은 승인 예외로 취급하지 않는다.
L-1 초안은 이 파일에만 있다. S4가 `docs/locale-data.md`로 분리해 11언어×실제 소비 필드 출력(native/fallback/unsupported), upstream 이슈, A/C 불변, ko 복귀, stale async 폐기, 읽기 신호0, 목록/상세 동일 명칭을 싣는다. baseline v1의 co-package#71/#78/#95가 CLOSED/MERGED인 사실은 소비 앱의 투영 지원표를 대신하지 않는다.
## 4. 화면 · shape · Page↔Widgetbook
아래 Page는 모두 `P(d,r)/<stem>.dart`, 대응 전시는 `WB(d,r)/lib/src/<stem>_use_case.dart`다. 생성 등록 fragment `entry.directories.g.dart`와 `app/app_widgetbook/lib/src/widgetbook_registry.dart`가 수집한다. 현재 카탈로그의 등록/렌더는 §6의 같은 SHA 잡으로 확인했다.
| 화면 | PRD shape | d / r | Page stem (= use-case stem) |
|---|---|---|---|
| A01 홈 | feed | GP / a | grocery_home_page |
| A02 분류 | split_browse | GP / a | produce_browse_page |
| A03 상품 | gallery | GP / a | grocery_catalog_page |
| A04 상세 | hero_detail | GP / a | grocery_product_detail_page |
| A05 옵션 | **v3 option_sheet · hand-author** | GP / a | grocery_product_options_page |
| A06 cart | line_items | GP / a | grocery_cart_page |
| A07 시간 | calendar_slot | DS / a | delivery_slot_calendar_page |
| A08 주문서 | form | GO / a | grocery_order_create_page |
| A09 주문 | status_board | GO / a | grocery_order_board_page |
| A10 추적 | timeline | GO / a | grocery_order_tracking_page |
| A11 정기배송 | settings | SUB / a | delivery_subscription_settings_page |
| A12 후기 | list | RV / a | grocery_review_list_page |
| A13 후기쓰기 | form | RV / a | grocery_review_create_page |
| A14 내정보 | profile | SH / a | shopper_profile_page |
| A15 알림 | inbox | AL / a | grocery_alert_inbox_page |
| C01 보드 | status_board | GO / c | fulfillment_order_board_page |
| C02 피킹 | checklist | GO / c | pick_line_checklist_page |
| C03 재고 | data_table | GP / c | grocery_stock_table_page |
| C04 슬롯 | data_table | DS / c | delivery_slot_table_page |
| C05 출고 | dashboard · hand-author 집계 | GO / c | dispatch_summary_page |
| C06 품목 | line_items | GO / c | **order_invoice_page**(PRD order_line_invoice와 이름 차이) |
업무 Page↔use-case 누락 **0/21**. 추가 `GroceryAlertBell`과 `package/resources/widgetbook/lib/src/brand_tokens_use_case.dart`까지 전시 파일23개다. 공개 보조 Page의 예외: `AppStatusPage`, `AppErrorPage`, `ConsoleStatusPage`는 개별 WB use-case 없음(커널 연결/없는 라우트 진단이며 PRD 업무21개 밖). `BrandTokensPage`는 브랜드 use-case로 대응한다. app_router/console_router의 셸 배너·내비·역할·미리보기는 독립 카탈로그/상태별 골든이 없어 S4에서 따로 검증한다.
업무 화면21개는 authored 이식 구현이며 recipe15개 생성 완료 비율과 동일하지 않다. 옵션 시트는 현재 전체 Page로 구현되어 “시트” 상호작용 원형과 차이를 확인해야 한다. v3 brick·추론·카탈로그·시드회귀·Mobbin3장이 함께 공급되기 전 hand-author를 유지한다. 슬롯→form 초기값과 포트 글루, console6, shared world/host는 recipe 외 소유 코드다. `generation-lock.json`의 `features: []`는 이 구현의 recipe 재생성을 증명하지 못한다.
반응형의 current source: Browse는 항상 2단, 상품/장바구니는 LayoutBuilder 가용 폭 사용, console stock/slot은390 목록행 widget 단언 있다. 822dp·wide 정보량·4대상 scaleInvariant의 정확한 AC 검증은 §12에서 추가한다.
## 5. 브랜드 — F-9
정본 [docs/brand.md](../brand.md), 구현 [AppTheme](../../package/resources/lib/src/theme/app_theme.dart), 전시 `package/resources/widgetbook/lib/src/brand_tokens_page.dart`, 회귀 `package/resources/test/src/brand_contrast_test.dart`다.
| 토큰 축 | 현재 구현 / 남은 것 |
|---|---|
| 색 | CoreBrand→PrimitiveColors.generate: primary148°/.46/.32, secondary42°/.46/.36, tertiary196°/.42/.35, 상태색·neutral148°. light/dark highContrast 의미 매핑 |
| 타이포 | 번들 Pretendard·CoreTypography 역할. 11언어 보조 글꼴은 W4-07 번들 도입; W4-10 glyph/실제WB 검증 |
| 모양·선 | CoreRadius16 카드/8 버튼, CoreStrokeWidth1 outlineVariant. input radius8은 승인 공급 기본 소비값(W4-10에서 실제값 교정) |
| 간격·밀도 | CoreSpace8/12/16/24, 버튼48dp/minWidth48, 콘텐츠 높이 |
| 효과 | CoreShadow.none, flat card, 의미 focus/disabled 기본값 소비 |
| 모션 | CoreDuration.fast150ms·CoreReducedMotion.resolve로 reduced0ms(W4-10). navigation motion·CoreEasing은 공급 기본값 소비 |
| 아이콘 | Lucide 부분집합 `package/resources/lib/icons/lucide.json`·부트스트랩/골든 등록. CoUI 미등록 기본 아이콘 HTTP 위험은 #5149 |
raw 색 읽기 전용 검사(2026-10-10): `rg -n '\bColor\(0x|\bColors\.|\bColor\.from(ARGB|RGBO)' feature package app backend -g '*.dart'`에 해당하는 **비생성 production lib 코드 0줄**. generated/protocol, 테스트/도구는 브랜드 화면 검사 범위 밖이다. `CoreColors.surface` 같은 토큰·`PrimitiveColors.generate`를 raw Colors로 오인하지 않았다.
WCAG 표는 기존 brand.md에 light/dark 각24 의미 쌍, 48/48 AA다. 회귀는 각 테마 check24개·failures0을 단언하고 같은 main CI tests에 포함됐다. 대표 비율 onSurface/surface 20.59/17.36, outline/surface 7.90/12.00. 카드 장식 outlineVariant·비활성은 표의 예외다. ko/en 라이트/다크 golden compare와 브랜드 WB 렌더도 성공한 잡에서 분리 확인했다. 이 설계 PR에서 새 capture나 대비 수치를 만들지 않았다. RTL·보조 글꼴·긴 문구 언어 도입 후 대비/배율/아이콘 외부요청0과 골든을 재확인한다.
## 6. 5종 검증 인벤토리
현재 main 실행 근거는 [CI 37869819261](https://github.com/coco-de/demo-ecommerce-grocery/actions/runs/37869819261), [Golden 37869819286](https://github.com/coco-de/demo-ecommerce-grocery/actions/runs/37869819286), [Pages 37869819232](https://github.com/coco-de/demo-ecommerce-grocery/actions/runs/37869819232)다. 조회한 jobs 모두 대상 main SHA이며 CI `검증 (tests-1)`·`(tests-2)`·`(tests-modules)`·`(tests-server)`·`(bdd)`·`(widgetbook)`·`(generated)`·`(analyze)`와 `번들 모듈 → 호스트 코드 생성` 성공. analyze 로그는 No issues found. 이번에는 코드/생성물을 변경하지 않으므로 같은 테스트를 로컬에서 반복하지 않았다. 로컬 `python3 tool/feature_modules.py check`는 exit0, bundle9개다.
아래 숫자는 파일/등록 인벤토리이며 시험 통과 수로 둔갑시키지 않는다. unit/widget의 상세 경로는 §1이며 서버 순수 rule 테스트는 `feature/<d>/server/test/unit/`다.
| feature / 역할 | unit | widget | golden capture / compare | Widgetbook 작성·등록·렌더 | co_bdd widget / 실행 앱 Patrol |
|---|---|---|---|---|---|
| GP app·console | app 규칙2·repo2 test파일, console cubit1, server rule1(7 tests) | app Page1·console Page1 | app suite1/144 PNG + console suite1/48 PNG; ko/en data 중심. Linux compare 성공 | Page7, 별도 knob 전환 시험0; 중앙 기본 렌더 있음 | browse/cart/console_stock 3편 + 생성 widget 실행 / Patrol 없음 |
| DS app·console | local2·console cubit1·server rule1(6) | app1·console1 | 24+48 PNG, suite각1; compare 성공 | Page2, 별도 knob 시험0; 중앙 렌더 | delivery_slot/console_slot 2편 / 없음 |
| GO app·console | local1·remote1·server rules1(10), host tour·contract | app1·console1 | 72+144 PNG, suite각1; compare 성공 | Page7, 별도 knob 시험0; 중앙 렌더 | checkout/cancel/picking_substitution/dispatch_summary 4편 / 없음 |
| SUB app | local1·schedule1·server rule1(4) | Page1 | 24 PNG·suite1; compare 성공 | Page1·scenario test1(4상태)·중앙 렌더 | settings 1편 / 없음 |
| RV app | local1·rules1·server rule1(3) | Page1 | 48 PNG·suite1; compare 성공 | Page2·scenario test1·중앙 렌더 | review 1편 / 없음 |
| SH app | local1, 순수 server unit **0**(SDK가 서비스 검증) | Page1 | 24 PNG·suite1; compare 성공 | Page1·scenario test1·중앙 렌더 | profile 1편 / 없음 |
| AL app | local1, 순수 server unit **0**(SDK가 서비스 검증) | Page1 | 24 PNG·suite1; compare 성공 | Page1+bell·scenario test1·중앙 렌더 | inbox 1편 / 없음 |
| app_router·console_router | route/guard·core runtime, world/host unit | shell/route/상태·console role/nav | app status24 PNG·suite1, console shell/status golden **0** | 셸/진단 전시 **0**, 업무 중앙 sink는 있음 | tour/screen_states/app_status 3편 / **실행 app/app·app/console 설정·여정0** |
| resources 공용UI | theme/contrast | brand_tokens_page test | 별도 brand golden0, 업무 theme 소비 비교 | brand tokens1·test1·중앙 렌더 | 브랜드 독립 BDD0, 앱 여정에서 검증 예정 |
golden 전체: suite11개, 커밋 PNG **624**(업무600+커널status24), `골든 (compare)` 로그 “11개 패키지” 성공. 같은 Golden run은 compare 뒤 gallery용 capture를 별도 수행하며 [Pages의 사이트 빌드](https://github.com/coco-de/demo-ecommerce-grocery/actions/runs/37869819232)는 gallery capture→build→업로드를 수행한다. capture는 compare 판정을 대체하지 않는다. 대부분 data 시나리오이며 21개 모두 loading/empty/error 골든을 갖춘 상태가 아니다. 11언어/RTL/긴 문구 데이터 variants도 없다.
S3 main 검토 당시 BDD: feature-local `.feature` **16편**(앱 상태 app_status 포함, 위 표 합계) + 생성 `*.widget_test.dart`16개다. 라이브러리 `build.yaml`은 모두 `defaultTarget: widget-only`, `sharedSteps: true`. 실행 `app/app`, `app/console`에는 co_bdd build.yaml/integration_test 여정이 없다. 그러므로 당시에는 **러너 부재와 별개로 Patrol 여정 작성·생성도 없음**이었다. W4-09에서 실행 앱4원본·widget8/Patrol12를 공식 생성하고 widget8을 로컬 실행했으며([보고](s4-w4-09-journeys.md)), 승인device 실행은 BLOCKED다. 현 Widgetbook 중앙 `widgetbook_use_case_render_test.dart`는 등록 경로 각각을1440×1024에서 올려 `takeException()==null`, ToastLayer 존재를 단언한다; 21×4 knob 전환 단언은 아니다. locale 후보의 scale/font 하네스를 도입해도 나머지20개 Page의 검증 완료로 계산하지 않는다.
## 7. backend — FB-3 및 FB 전체
실제 경로는 `backend/demo_ecommerce_grocery_client/lib/src/protocol/client.dart`의 생성 `client.modules.<d>.<endpoint>` → `backend/demo_ecommerce_grocery_server/lib/src/generated/endpoints.dart`/serverpod 모듈 dispatcher → `feature/<d>/server/lib/src/endpoint/*` → `service/*` → 기능 소유 테이블이다. 호스트 `backend/demo_ecommerce_grocery_server/lib/src/grocery/bind_grocery_host.dart`가 caller-owned ports7종과 clock을 각 Serverpod 인스턴스에 묶는다. module→host 역참조 대신 Expando 바인딩·Session/Transaction을 전달한다. localOnly API와 SDK API는 같은 UI Repository 계약을 따른다.
| 호스트 시험 (`backend/demo_ecommerce_grocery_server/test/integration/grocery/`) | test 호출 수 | 실제 단언 |
|---|---:|---|
| grocery_catalog_sdk_test.dart | 6 | catalog A48/category21·MD scope·stock revision·slot close/reopen·profile·alert read |
| grocery_checkout_sdk_test.dart | 15 | cart merge·권한·소유자·필수옵션·재고·최소금액·마감·requestKey 재시도/동시·hold+stock·pay/cancel·불법전이 |
| grocery_fulfillment_sdk_test.dart | 5 | 직원 역할·chain·전줄종결·refund 정확액·정책/contact·대체 stock·불법전이 |
| grocery_integrity_sdk_test.dart | 7 | 중간 실패 rollback3종, 마지막정원3·stock0 경합, cancel/pick 경합, stale stock |
| grocery_review_sdk_test.dart | 7 | 본인·delivered·별점/메모/사진·줄당1건·동시5요청 |
| grocery_subscription_sdk_test.dart | 9 | 본인/scope·주기/요일/active/skip·타인업데이트·동시변경 잃음방지 |
| grocery_binding_sdk_test.dart | 2 | 미바인딩 fail-closed·세 서버 인스턴스별 다른 clock/binding 격리 |
| grocery_schema_snapshot_test.dart | 2 | package별 baseline1개·빈 DB migration 적용 결과=model snapshot |
**SDK/스키마53 tests**(기존 배치 문서의54와 다름). 위 CI backend 잡 로그 +53 성공. 이어 `package/grocery_host/test/contract/grocery_contract_test.dart`의 localOnly/server **2 runtime tests** +2 성공(같은 시나리오 표64단계), 실패 코드·전체 엔티티 동등성 검증이다. server 순수 unit30개(7+6+10+4+3)는 tests-modules에서 별도 성공. SH/AL의 순수규칙 unit은 없으므로 7기능 모두 server unit 파일이 있다고 쓰지 않는다.
격리 근거: `test/integration/support/grocery_it_server.dart`의 `EphemeralTestDatabase.create`로 `grocery_it_<스키마FNV지문>_<pid>` DB만 만들고 stop에서 그 DB만 drop, reseed는 해당 이름 확인 뒤 feature-owned tables만 transaction으로 TRUNCATE한다. 일반/운영 DB reset 없음. main 기본 API port25911은 fixed이며 후보 공통커밋 `feb906d`가 포트를 파생한다. S4 병렬 격리 시 그 개선을 중복 없이 채택한다.
인증 한계: 현재 SDK 시험 인증은 테스트 경계 `demo:<account>`를 시드 신원/scope로 해석한다. dispatcher/service/DB를 mock하지 않지만 실제 IdP 로그인→JWT→업무 계정 증거는 아니다. login 브랜치의 신원 매핑·실제 이메일 SDK 시험을 S4에서 재검증한다. 공개 Pages는 localOnly와 업무 네트워크0을 유지한다.
| FB | 판정 |
|---|---|
| FB-1 구조·소유권 | bundle9·업무server7·client7, UI/골든/WB 기능 소유 확인. core/world에 업무 서비스 중복 없음 |
| FB-2 조립·의존 | main modules/generated CI 성공, 로컬 check9 성공. recipe→현재21화면 재생성은 별도 미증명 |
| FB-3 업무backend | 현 범위 SDK/DB55(53+2)·rule30 실행 근거 있음. 추가 revision/login은 후보이고 미승계 |
| FB-4 동등·공개 | 2runtime 계약 성공. 11언어·첫프레임·투어 두 탭·6표면은 미완 |
| FB-5 재현·증거 | 부분: S3b 고정 공급 quick 생성/module-check 성공(§9). full·재생성diff0·6표면·공급profile 미검증, 현재 앱 lock features빈값·legacy stamp·migration 후보 기존 DB 검증은 남음 |
## 8. 재사용 판정 — 판정만
2026-10-10 원격 branch API와 로컬 refs가 아래 SHA와 일치했다. 열린 PR **0**, 기존 PR1만 MERGED. `git rev-list --left-right --count main...<ref>`의 (main만/후보만), diff paths, `git merge-tree <base> <a> <b>` 텍스트 판정을 읽었다. 실제 merge/cherry-pick/delete/rebase는 하지 않았다. 후보 head Actions 조회는 Golden skipped뿐이며 검증 성공 증거로 삼지 않는다.
| 대상 / SHA | main과 차이 | 판정 / 이유 / S4 채택 범위 |
|---|---|---|
| main `9b7e1c31` | 현재 기준 | **채택**: 같은 SHA CI/compare/backend/Pages 성공, 21화면·업무 유지. L/6표면/Patrol/full cleanbase 부족은 별도 |
| PR1 / story/cocode-659-bundle `5c1b7362` | (1/0), tree diff0 | **채택(이미 main 포함)**. 새로 merge하지 않음 |
| wip/659-backend `77f69dac` | (11/0), ancestor | **채택(이미 포함)**. 과거 버전으로 되돌리면 golden/검증/후기 보강 등 main 후속을 잃음 |
| story/cocode-659-locale-verification `c4450dc1` | (0/13), 538 paths | **부분 채택**: AppPresentation/pre-boot/DisplayProjector/6표면/금액날짜/11언어/보조폰트/공개 하네스 후보. shopper 첫 적용만으로 전수검증 아님; 기존 co-package pin·key/fallback·C보존·fonts·golden 재검증 |
| wip/659-i18n `0ffc7946` | (0/15), 511 paths | **부분 채택**: locale과 기존 번역13개 작업 대부분 중복, 후보 간 (locale만1/i18n만3), i18n은 locale 후속을 merge한 상태. c445의 공개 하네스 후속과 e2c8의9언어 키 보강만 결합 검토. 두 브랜치를 통째로 중복 채택하지 않음 |
| wip/659-login `2e821d1e` | (0/5), 103 paths | **부분 채택**: 실제 email/JWT→GroceryAccount→me·caller ports·앱/콘솔 gate 후보. bootstrap/i18n/문서와 locale 공유11paths; 공개localOnly 회귀 필수 |
| wip/659-revision `59074dfb` | (0/7), 227 paths | **부분 채택**: 주문/피킹/cart/slot/shopper/subscription expectedRevision·충돌UI/시험 후보. **baseline migration 교체는 채택 불가**; 기존 이력 보존 + 공식 새 migration 생성·신규/기존 DB 검증으로 다시 구현 |
| salvage/cocode-659-grocery-local-snapshot `e778dae4` | (45/1), 3196 paths | **폐기(구현 출발점으로)**: 과거 구조·검증삭제/대규모 교체, 현재 bundle closure와 다름. 보존 브랜치 삭제하지 않음; 필요 시 과거 화면/여정 참고만 |
충돌 사전 판정: locale↔i18n 텍스트 conflict0; locale↔login changed-in-both8파일/conflict 구간2; locale↔revision47파일/2구간; login↔revision10파일/3구간. 이는 위 base/head 조합의 **텍스트** 판정만이며 build/migration 의미 충돌0을 보증하지 않는다. 주요 겹침은 bootstrap·번역 원본/생성물·row mapper·presentation text·contract·grocery_it_server다. login/revision의 host migration registry도 충돌한다. `feb906d`는 후보 모두 공유하므로 한 번만 적용한다. 생성 SDK/Slang/route 파일은 원본 결합 뒤 공식 generator로 재생성하고 hand-edit하지 않는다.
## 9. 레시피 · cob plan · cleanbase
**설계 채택안은 baseline v1의 `ecommerce_grocery` recipe7개 feature + app_router**다. recipe가 생성하는 app15 화면은 유지하되 option_sheet·console6·세계/호스트·form초기값·실업무 FSM/권한/거래는 authored 차이로 명시한다. upstream 개별 recipe 작성자는 PC-C이며 공유 registry/family/verified writer는 PC-A다. 이 PR에서 recipe나 verified를 수정하지 않는다.
고정 도구 `$HOME/orca/toolchains/637/pub-cache/bin/cob`, `PUB_CACHE=$HOME/orca/toolchains/637/pub-cache`, resolved cob **`55ce5e14b590bb172ba6580cdb79d4b2bfee7601`**, 0.6.0 확인. 전역 cob는 건드리지 않았다. `plan --help`는 `--prd`와 `--proposals`가 필요하다. PRD만 준 첫 진단은 exit64 “--proposals 가 필요합니다”. 올바른 실행은 아래이며 PRD 본문 전체를 입력했다.
```sh
PUB_CACHE="$HOME/orca/toolchains/637/pub-cache" \
"$HOME/orca/toolchains/637/pub-cache/bin/cob" plan \
--prd /tmp/s3-659-prd.md --proposals /tmp/s3-659-proposals.yaml --no-reuse
```
exit0: FR25 전체 매핑, **covered17 / review-pending8(FR006·017~023) / orphan0**, NFR13 보고 전용. capability16개 중 **합성1**(`fulfillment_order_board` 이름 정규화가 crud로 분류), **hand-author15**. semantic capability의 합성 분류가 그 FR을 결정론 covered로 승격하지 않는다. proposals는 이 설계자가 source/recipe 경계를 보고 저작한 매핑이며 구현 자동 분석이나 공급 profile 증명이 아니다. 재현 입력은 부록A에 그대로 있다.
`catalog --recipes --json --family commerce`는 ecommerce_grocery / commerce / verified=true, features7 / pages15 / status_machines1 / mock_repositories7을 반환했다. 고정 recipe의 stamp는 **2026-10-03·cob0.4.0·bricks `09451cace686c994ac48b9ce6539a313ae293d8b`**이며 legacy_only다. shape portfolio에 option_sheet는 없고 list2가 있다. bundle backend/21화면/v3 지원의 보증으로 쓰지 않는다. `cob verify`는 project-dir 검증이며 recipe 이름만 검증하는 명령이 아니다; S3에서 full verify는 미실행이다.
cleanbase 스크립트는 [cocode PR1142](https://github.com/coco-de/cocode/pull/1142) head **`f97734cbd762dbaa48afbfe6dc6d7977ef2700b0`**의 원본을 `~/orca/toolchains/637/xhost/scripts/demo_cleanbase_repro.py`로 받았다(공용 저장소 checkout 수정 없음). S3b(2026-10-10)에서 원본 byte 일치와 SHA256 `ca8468f55844ad01d9ca80e898f15667065981ab6fb092265fd9215946d90764`, 전용 캐시 cob resolved-ref를 다시 확인한 뒤 아래 명령을 **이번 dispatch에서 1회** 실행했다. 사용자 승인으로 PC-A 디스크를 정리한 후 실행한 후속 검증이며 floor나 공급 ref를 변경하지 않았다.
```sh
python3 "$HOME/orca/toolchains/637/xhost/scripts/demo_cleanbase_repro.py" \
--recipe ecommerce_grocery --checks quick \
--out "$HOME/orca/toolchains/637/xhost/s3-659-cleanbase-quick.json"
```
| 실행 필드 | S3b 실제 결과 |
|---|---|
| recipe / inputs | ecommerce_grocery, cob `55ce5e14b590bb172ba6580cdb79d4b2bfee7601`, bricks `fd4edb1e746757dff672f359832dd3bae9470fe2`, coui_flutter-v0.158.0, Serverpod4.0.3, checks quick, project_config S2-A1 embedded |
| 호스트 / 디스크 | Apple M3 Max·arm64·macOS27.0.1; df Available66GiB; initial_free_bytes **71702032384**(71.70GB), 단계 종료 시 최소 **70719889408**(70.72GB), 40GB 미만 진입 없음 |
| 결과 | **status succeeded / exit0 / 74.841s**; module_check exit0 |
| 정규화 다이제스트 | **`c09ea15ab7e9c18d2f146f02c92e376f7365f63b9dd66ae4468992e00288f607`** |
| 파일 수 / 측정 지점 | **1683** / `assembled, before checks` |
| 알고리즘 | `sha256-of-sorted-path-content-sha256-json-v1`: 정렬한 상대 경로·content SHA256 목록의 JSON을 SHA256. generation-lock.json의 최상위 written_at만 제외 |
| project config SHA256 | `8fd1c0dbb14132c21328dc57d9659c47b51930c7b6e1b95ed719e00fee65de9f` |
| 보고서 / 로그 | `~/orca/toolchains/637/xhost/s3-659-cleanbase-quick.json`, 단계 로그 `~/orca/toolchains/637/xhost/s3-659-cleanbase-quick-logs/`; 보고서 SHA256 `dff507b18b9e14087497b784cebad900b4f011447de57b1c0f30a0816c289e93` |
| 정리 | `workdir_removed: true`, 임시 생성 트리 정리 확인; 데모 워크트리에 생성하지 않음 |
단계별 결과는 아래와 같다. 같은 스크립트 실행의 단계 로그와 증분 보고서에서 읽었고, 시간 합은 추출/다이제스트/정리 등 명령 밖 시간이 제외되므로 전체74.841s와 다르다.
| 단계 | exit | 소요 시간(s) |
|---|---:|---:|
| flutter-version | 0 | 0.254 |
| cob-version | 0 | 0.553 |
| clone-bricks | 0 | 2.707 |
| resolve-bricks | 0 | 0.013 |
| archive-bricks | 0 | 12.606 |
| demo-spec | 0 | 0.633 |
| effective | 0 | 0.554 |
| scaffold | 0 | 8.024 |
| compose-grocery_product | 0 | 26.348 |
| compose-delivery_slot | 0 | 2.146 |
| compose-grocery_order | 0 | 3.103 |
| compose-delivery_subscription | 0 | 1.885 |
| compose-grocery_review | 0 | 2.504 |
| compose-shopper | 0 | 2.213 |
| compose-grocery_alert | 0 | 2.205 |
| module-check | 0 | 0.084 |
7개 기능 manifest 순서는 grocery_product → delivery_slot → grocery_order → delivery_subscription → grocery_review → shopper → grocery_alert다. baseline v1의 고정 scaffold + bundle compose + module-check **quick 범위가 통과**했다. 실제 앱 authored21화면·업무 구현이 이 임시 생성물과 같다는 주장이나 13게이트 PASS/새 verified 승격은 하지 않는다.
**이전 BLOCKED 보고 보존:** 최초 S3 호출은 initial_free_bytes44180041728(44.18GB)에서 스크립트45GB 조건으로 exit1/0.001s, steps=[]·digest/file_count 미생성이었다. 실행 전에 그 JSON을 **`~/orca/toolchains/637/xhost/s3-659-cleanbase-quick-blocked.json`**으로 옮겨 보존했고, 성공 보고서는 원래 경로에 새로 썼다. 이전 coordinator 회신 `msg_32949ae14687`에 따른 재시도 금지 기록은 이력이고, 이번 S3b는 사용자 승인 디스크 정리 이후 별도 dispatch(`task_26d59f23bda0` / `ctx_85f9e70ff3c0`)로 허가된 1회 실행이다. 디스크 사전조건 blocker와 PC-C 첫 quick/digest 작업은 **해소·완료**했다.
기본 project_config가 exchange_remittance용 이름을 포함하므로 이번 digest는 **ecommerce_grocery recipe + S2-A1 embedded scaffold 입력**의 값이다. 재현 비교 시 동일 embedded 입력과 위 config hash를 유지하거나 ecommerce_grocery 명시 project JSON을 별도로 고정하고 새 hash를 기록한다. 서로 다른 project config의 digest를 비교하지 않는다. quick은 compose/module-check까지만이며 pub get/codegen/analyze/test/재생성diff0/6표면을 증명하지 않는다. **full 검증·소비 ref 상향·bundle 공급 profile/verified는 후속 S4/S5**이고 이번 실행에서 수행하지 않았다.
## 10. baseline v1 upgrade 계획 — 실행하지 않음
| 공급 | 현재 소스 | 승인 v1 / S4 처리와 영향 |
|---|---|---|
| co-package | `d23a5c42a4b653491545d0744ab349b810e579dc` | **`c003ca2c018731436dd4d37f3d4473e7bdf9e187`**로 모든 workspace·gallery git 의존 한 PR에서 일괄(S-9). co_faker0.13 / world0.2 / prefs1.0.1 / bdd0.2 / golden0.3 / gallery0.2.2. DisplayProjector API·11언어 도메인/주소/페르소나 지원·seed 결과·기능 fixture·SDK계약·Linux golden 변화 확인 |
| CoUI | flutter0.158.0/core0.157.0 | 이미 v1 동일 `6b7f7b80`, 상향 불필요. Lucide 얇은 번들 우회 유지, upstream#5149 해결은 승인 ref 후만 채택 |
| cob/bricks/kernel | lock bricksbd8571753/kernel7e1a9c19, cob 이력1f278675 | 재현 도구는 cob55ce5e14/bricksfd4edb1e/kernelbe421e0b. 앱을 새 scaffold로 덮지 않고 shared contract/tool 차이를 선별한다. console/SDK/baseline 이력 보존 |
| Serverpod | `tool/serverpod/serverpod.yaml` **4.0.4** | v1 정본4.0.3과 다름. 임의 downgrade하지 않음; PC-A baseline 소유자에게 판정 요청 후 profile.py·고정CLI로 일관 변경/코드젠/DB 회귀. 현4.0.4 CI를 v1 4.0.3 결과로 기록하지 않음 |
| Flutter |3.47.6 / Dart3.13 계열 | 동일 버전 유지, 전역 serverpod/cob/FVM 설정 변경 없음 |
공급 ref 일괄 상향 → 입력 원본/앱·콘솔 공통 presentation 상태 → projection/C overlay → 11언어 Slang parity/보조 폰트 → unit/widget/WB → Linux capture·compare 순으로 한다. baseline v1은 11언어 데이터 공급을 포함하나 소비 투영을 자동 완성하지 않는다. 업무 A fixture의 가격/재고/관계가 바뀌면 골든 갱신 전에 원인을 해결한다.
## 11. blocker · issue · next
이슈 상태는 2026-10-10 인증 읽기로 확인했다. CLOSED/MERGED 공급 이슈는 해결된 공급의 **소비·검증 선행**으로 표시한다. 공통 코드는 [change-requests 절차](https://github.com/coco-de/cocode/blob/62edf3c5863c98f85ba2a6027d376ea412452255/docs/projects/637/change-requests.md)에 따라 symptom/repro/actual/expected/영향#659/게이트를 해당 소유 이슈에 연결하고 coordinator가 writer를 배정한다. 이 worker가 공용 코드를 고치거나 baseline을 올리지 않는다.
| blocker / 게이트 | issue / 소유 | next |
|---|---|---|
| cleanbase 디스크 사전조건 / **해소(S3b)** | [cocode#1141](https://github.com/coco-de/cocode/issues/1141), [PR1142](https://github.com/coco-de/cocode/pull/1142) / PC-A 실행 | 사용자 승인 디스크 정리 후71.70GB에서 quick1회·digest/1683파일 기록 완료. 이전 BLOCKED JSON 보존; next: PC-C full/diff0·소비 앱 회귀, quick 반복 불필요 |
| bundle exact-input profile·verified / recipe·generation·FB5 | [co-bricks#830](https://github.com/coco-de/co-bricks/issues/830), [#831](https://github.com/coco-de/co-bricks/issues/831) **OPEN**, [#764](https://github.com/coco-de/co-bricks/issues/764) OPEN / PC-A 생성 공급 | 공급 prove/compare·E2E·console 경계 후 승인 ref. legacy stamp 수기 승격 금지 |
| v3 option_sheet 공급 없음 / F3·AC15 | [cocode#638](https://github.com/coco-de/cocode/issues/638) F-3, [bricks#394](https://github.com/coco-de/bricks/pull/394)(v2, MERGED) / PC-A generator·PC-C CoUI | v3 brick/추론/catalog/seed회귀/Mobbin3장 공급. 그 전 authored 표시 유지 |
| 11언어 소비투영·C우선·첫프레임·RTL / locale L1~6 | [co-package#70](https://github.com/coco-de/co-package/issues/70), [#71](https://github.com/coco-de/co-package/issues/71), [#78](https://github.com/coco-de/co-package/issues/78) CLOSED; [#95](https://github.com/coco-de/co-package/pull/95) MERGED / 공급PC-B·소비PC-C | v1 c003 일괄 소비·실제11×필드지원표·iframe ko→en→ja→ar→ko·ar/dark첫프레임·마지막언어 검증. 추가 분야 결함만 PC-B upstream 요청 |
| CoUI 미등록 기본아이콘 외부요청 / smoke·F9 | [coui#5149](https://github.com/coco-de/coui/issues/5149) **OPEN** / PC-C CoUI | 현재 subset 우회와 네트워크0 회귀, 기본아이콘도 점검. 우회만으로 upstream PASS 아님 |
| Patrol 승인 runner/device 및 웹 선택 공급 결함 / patrol | [cocode#659](https://github.com/coco-de/cocode/issues/659) AC12, [#638](https://github.com/coco-de/cocode/issues/638) / 앱PC-C·runner PC-A | W4-09 both8/patrol-only4 작성·생성·widget8 로컬 검증. 승인 runner/device와 coui#5361/#5268 소비 뒤 실제 device/run 기록 |
| `/widgetbook/`·`/docs/`404 / surfaces | [cocode#659](https://github.com/coco-de/cocode/issues/659) AC16·S10 / 앱PC-C | locale 후보의 surface wiring 선별·catalog6/credentialscan/배포후HTTP+공개브라우저스모크. alias app-widgetbook는 canonical WB 대체 아님 |
| Mobbin 현재 MCP 미노출 / AC15 | [cocode#659](https://github.com/coco-de/cocode/issues/659) §13, [기존 링크 문서](../mobbin-references.md) / PC-C | **BLOCKED** 현재 직접 preview 재검토 불가. 접근 가능한 세션에서 21화면2장·option3장 검토. C02 picking+정책은 서로 다른 흐름, C04는 운영 capacity 원형 아님 |
| 현재 generation-lock features빈값·생성/호스트 배선 차이 / FB5 | [co-bricks#860](https://github.com/coco-de/co-bricks/issues/860) OPEN, [#831](https://github.com/coco-de/co-bricks/issues/831) / PC-A | 정확한 input/ref/output·diff0·owned21화면 차이를 공급 증거로 제출. 오래된 template 결함 목록은 재현 전에 새 결함으로 단정하지 않음 |
| revision 후보 migration 이력 교체 / FB3·FB5 | [cocode#659](https://github.com/coco-de/cocode/issues/659) / PC-C 앱 | 변경 원본·UI 충돌처리만 참고, 새 공식 migration·기존fixture DB upgrade·fresh DB 두 경로 검증 |
| Serverpod4.0.4↔v1 4.0.3 / baseline | [cocode#1138](https://github.com/coco-de/cocode/issues/1138) / PC-A baseline | 승인 판정 후 버전 일관화, 이 문서 작업에서 변경 없음 |
| 예산 제한으로 PR CI job 미시작(발생 시) / 검증 인프라 | [cocode#637](https://github.com/coco-de/cocode/issues/637) / coordinator | 문서 PR run의 annotation만 기록, 코드 문제로 분류/재실행/워크플로 수정하지 않음 |
## 12. S4 작업 분해 — PC-C 인계
PC-A는 이번 문서 PR 작성·CI 확인까지만 임시 writer이고 승인 없는 merge는 하지 않는다. **S4 writer는 PC-C**(복귀 예정 2026-10-11 05:00 KST)다. 사용자 「A·B 주력」 지시로 2026-10-10 이 dispatch의 W4-06~07은 PC-A 임시 writer이며 이후 남은 작업 배정은 coordinator가 한다. 크기 S≈반나절/1~2SP, M≈1일/3~5SP, L≈2일+/8SP. 아래 추정은 현재 코드 재사용 기준이며 PRD 기존34SP와 더해 이중 집계하지 않는다. 공급/runner/예산 대기 시간은 SP 밖이다.
2026-10-10 추가 dispatch `task_c164862e11d0` / `ctx_a6026b6f8565`의 **W4-08 임시 writer도 PC-A**다. [전수 로컬 검증 보고](s4-w4-08-verification.md)에 6792capture·정확한scale16·WB11언어×2테마·회귀/DB 보존과 공급 재진단을 기록한다. Linux compare/CI 예산·DCM 라이선스·승인 공급 소비 전 W4-07은 BLOCKED이며 완료로 세지 않는다. 후속 W4-09~13 배정은 coordinator가 한다.
2026-10-10 dispatch `task_8a2d463d986c` / `ctx_30777e7a9609`의 **W4-09~11 임시 writer는 PC-A**다. W4-09는 [실행 앱 여정 보고](s4-w4-09-journeys.md)와 [runner 계약](../testing/host-journeys.md)에 실제 두 셸9단계·권한·경계·namespace격리·locale의 작성/생성/widget 실행을 분리 기록한다. Patrol과 공개 두 탭/두 데모는 승인 runner·공급/예산 선행 전 BLOCKED이며 FR24검증/1부분은 유지한다.
2026-10-10 dispatch `task_c312801640a5` / `ctx_38cf6431d1fb`의 **W4-10~11 임시 writer는 PC-A**다. W4-10의 실제7축·reduced0ms·glyph·48dp·AA48·raw0·번들/로컬 요청0을 [브랜드 보고](s4-w4-10-brand.md)에 기록한다. Mobbin42+3 재실측과 C02/C04 원형은 접근 전 BLOCKED이며 현재SHA CI/compare/공개배포는 coordinator 머지열차다. W4-11의 canonical6표면·643테스트·capture6792·브라우저 부분 성공과 공급BLOCKED는 [6표면 보고](s4-w4-11-surfaces.md)에 분리 기록하며 남은 순서는 W4-12→W4-13이다.
| 순서 | 작업 / 완료 증거 | 크기 | 선행 | 소유 및 공급 이슈 |
|---|---|---|---|---|
| W4-01 | **cleanbase quick 1회·다이제스트/1683파일 기록 완료(S3b PC-A, §9)**. 남은 작업: main9b7 기반 새 구현 브랜치·후보SHA 재확인·결합계획, 공통 feb906d1회·기존baseline 보존. quick 반복 불필요 | S / 1(남은 결합계획) | 이 문서 검토 | quick PC-A 완료·앱 PC-C, PC-A merge승인, cocode#1141 |
| W4-02 | co-package d23→c003 전 멤버/gallery일괄·S9, Serverpod baseline 차이 승인 후 profile 처리. pub get·module/host codegen·재생성diff0 | M / 3 | 01·baseline판정 | PC-C 소비, PC-A baseline, co-package#95·cocode#1138 |
| W4-03 | **revision 부분 재사용**: 주문/피킹/cart/slot/SH/SUB 기대rev·충돌후최신UI, 원본으로 새 official migration. fresh+기존fixtureDB·동시성/멱등·contract | M / 5 | 01·02 | PC-C, #659 FB3/FB5(과거baseline교체 채택금지) |
| W4-04 | **login 부분 재사용**: JWT→업무 계정/caller ports·me·restore/logout/error, scope/타인거부, 공개localOnly 배너 유지. SDK IdP+앱gate검증 | M / 5 | 03; locale bootstrap 충돌계획 | PC-C, #659 FB3/FB4 |
| W4-05 | FR-001 첫 역할 진입, 002 emptyCTA, 003822dp, 005무할인숨김, 00740000UI, 0120이벤트summary, 023두탭focus, 024전21×4 상태 보강. 주투어9단계·업무 경계 유지 | M / 5 | 03·04 | PC-C, #659 FR/AC |
| W4-06 | **PC-A 임시 writer 구현·로컬 검증 체크포인트([보고](s4-w4-06-locale-data.md)); 공급 카탈로그5SKU 예외**. locale/i18n 후보 선별: L-1 docs/locale-data.md 전필드·예외, L-2 기능소유 fieldset/DisplayProjector·실제11×필드지원표, 사전제거·같은id목록/상세 | L / 8 | 02·05 | PC-C 소비, 부족분PC-B(co-package#70/#71/#78) |
| W4-07 | **PC-A 임시 writer 구현·로컬 검증 체크포인트([보고](s4-w4-07-locale-presentation.md)); 실제 browser는 coui#5361/#5348 공급 BLOCKED**. L-3/4/6: 공유 AppPresentation·prefs/EmbedSync·Switcher·UserEditOverlay·ar/dark preboot·RTL. route/selected/cart/order/미저장입력/filter/page/panel보존·A/C불변·staleasync·읽기신호0 | L / 8 | 06 | PC-C, 공급PC-B·커널PC-A, #659 L3~6 |
| W4-08 | 5종 전수: 실제 위험unit/widget, Page↔WB상태 전환, golden4상태·ko/en/zh-Hans/ja/ar/긴문구·fonts·light/dark, 정확한4화면 scaleInvariant4조합, analyze/DCM 증거. Linux capture와compare 별도 | L / 8 | 05·07 | PC-C, 공용CoUI#5149; generator 결함은 co-bricks#860 |
| W4-09 | **PC-A 임시 writer 작성·생성/widget8 로컬 성공**([보고](s4-w4-09-journeys.md)). 실행app/app·app/console both8/patrol-only4: 9단계/권한/경계/두namespace reset/locale. device·실제 공개 두데모는 BLOCKED | M / 3 | 05·07 | 이번dispatch PC-A, 이후 PC-C 작성·PC-A runner배정, #659 AC12/#638 |
| W4-10 | **PC-A 임시 writer 로컬 구현·검증 체크포인트([보고](s4-w4-10-brand.md)); Mobbin 재실측 BLOCKED**. F9 실제7축·reduced0ms·11언어fonts·AA48·48dp·WB·raw0·로컬6probe 외부아이콘0. Mobbin21×2/옵션3·C02/C04 원형은 접근 전 BLOCKED | M / 3 | 07·Mobbin접근 | 이번dispatch PC-A, 이후 PC-C. CoUI#5149·#638 F3/F9 |
| W4-11 | **PC-A 임시 writer canonical6 로컬 체크포인트([보고](s4-w4-11-surfaces.md))**. WB/docs·catalog/credential2겹·localOnly0요청, 새창ar/dark·reload8검사·두탭focus·local colddata1666ms·C01mask 성공. route21 중11성공/10선택오류·iframe locale는 승인coui BLOCKED | M / 3 | 07·08·09 | 이번dispatch PC-A 앱, 이후 PC-C. 커널공급PC-A·#659 AC16 |
| W4-12 | S3b §9의 quick digest/count와 고정입력을 확인한 뒤 full(pub/codegen/analyze/test/재생성diff0/6표면), recipe15↔authored21 차이·FB5·스키마폐포 명시. bundle profile/verified는 공급통과 후 | M / 3 | 02·08·11·디스크·공급profile | PC-C 실행·개별recipe, PC-A 공급co-bricks#830/#831·sharedregistry/Jev7·#640 ADE |
| W4-13 | 같은 최종SHA의FR/5종/L/FB/브랜드·Mobbin·실측 기록 PR, PC-A 검토로 S5검증·게시/사이드카 인계. demo_card14키·screenshot1440×900·status_rule 확인 | S / 1 | 01~12 근거, BLOCKED 명시 | PC-C 증거 제출, PC-A sidecar/판정·#639. worker가 수기13게이트PASS/갤러리체험가능 선언 금지 |
총 재추정 **56SP**(공통 공급 작업/대기 제외), 먼저 01~05 업무/서버 원본을 결합하고 06~08 locale/검증으로 넓힌다. 이후 09~13의 실제 앱·공개·재현 증거를 분리 제출한다. S4는 구현+검증까지이며 S5 게시·13게이트/verified·S6 승인은 별도다. cleanbase/Mobbin/runner가 막혀도 독립 작성·단위검증은 진행하고 그 게이트는 BLOCKED로 남긴다.
§14 capability 경계는 그대로 유지한다: PG/실환불→모의전이, 배송기사API→콘솔이력, 주소검색→시드2주소, push→알림함기록, billing/scheduling→정기설정만, 쿠폰/적립→지표만, WMS/다창고→단일재고, media_upload→번들사진. 회원가입/본인인증/입점정산/기사앱/특수식품표시/실시간채팅/검색엔진을 S4에 추가하지 않는다.
## 부록 A. plan proposals 재현 입력
```yaml
schema_version: 1
generated_by: agent-skill
model_id: gpt-6
capabilities:
- {id: app_router, brick: app_router, match: exact, confidence: 0.9, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-001, FR-024, FR-025]}
- {id: grocery_product, brick: grocery_product, match: exact, confidence: 0.9, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-002, FR-003, FR-004, FR-005, FR-007, FR-008]}
- {id: delivery_slot, brick: delivery_slot, match: exact, confidence: 0.9, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-009]}
- {id: grocery_order, brick: grocery_order, match: exact, confidence: 0.9, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-010, FR-011, FR-012]}
- {id: delivery_subscription, brick: delivery_subscription, match: exact, confidence: 0.9, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-013]}
- {id: grocery_review, brick: grocery_review, match: exact, confidence: 0.9, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-014]}
- {id: shopper, brick: shopper, match: exact, confidence: 0.9, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-015]}
- {id: grocery_alert, brick: grocery_alert, match: exact, confidence: 0.9, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-016]}
- {id: grocery_product_options, match: semantic, confidence: 0.5, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-006]}
- {id: fulfillment_order_board, match: semantic, confidence: 0.5, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-017]}
- {id: pick_line_checklist, match: semantic, confidence: 0.5, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-018]}
- {id: grocery_stock_table, match: semantic, confidence: 0.5, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-019]}
- {id: delivery_slot_table, match: semantic, confidence: 0.5, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-020]}
- {id: dispatch_summary, match: semantic, confidence: 0.5, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-021]}
- {id: order_invoice, match: semantic, confidence: 0.5, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-022]}
- {id: grocery_world_shared_store, match: semantic, confidence: 0.5, rationale: "S3 source and recipe mapping; implementation evidence is separate", covers: [FR-023]}
```
## 부록 B. 이 문서의 검증
S3 작업: GitHub PRD/고정 계약/recipe/branch/Actions 읽기, source/단언 대조, raw 색 검사, `feature_modules.py check` exit0(9), plan exit0, S3 cleanbase preflight exit1(보존)·S3b quick exit0/1683파일/16단계, 공개 HTTP4/6. 이 파일만 변경했는지 `git diff --check`·경로/FR25·AC50·Page/use-case21·계획SP 산술·참조 경로 검사를 하고 문서 PR CI 결과는 PR checks/코디네이터 보고에 남긴다. 기능/기존 후보/공급/공용 저장소는 수정하지 않았다.