659 S4 W4-05 — FR 보강

# #659 S4 W4-05 — FR 보강

2026-10-10 PC-A 임시 writer. [설계 §12](s3-design-record.md)의 순서대로 **PR6 head `aa8fd1e7db72225499046b37117294f9042f611e`**에서 `story/cocode-659-s4-fr`을 만들었다. PR base는 `main`, 선행은 PR6다. 기존 PR2~6·wip·salvage·공용 저장소는 변경/머지하지 않았다. 이번 긴 세션은 W4-05까지 제출하며 **다음 구현은 이번 PR head에서 W4-06→07 순서**다.

## FR 상태 변화와 구현

[설계 §1](s3-design-record.md)의 FR25는 **구현+검증17·부분8 → 구현+검증24·부분1**이다. 새 근거는 아래 로컬 실행이며 새 head의 CI/같은 main SHA 13게이트 PASS가 아니다. FR-023의 공개 두 탭 증거는 부분으로 유지한다.

| FR | 보강과 실제 단언 |
|---|---|
| 001 | localOnly 최초 진입에서 「구매자 오하늘로 시작」을 누르면 홈·데모 배너를 연다. 시작 버튼은 독립 의미 노드다. 역할 선택은 `demo-ecommerce-grocery/entry/<actorId>`에 저장하고 새 세션에서 복원한다. 업무 원장·revision 불변, 다른 데모 키 보존을 단언했다. console의 기존 3역할 전환과 server login gate는 유지 |
| 002 | 홈 empty의 EmptyState·「카테고리 보기」를 누르면 실제 browse route로 이동하고 미리보기 해제 뒤 분류 data를 보이는 통합 단언 |
| 003 | 물리/가용 폭822dp·DPR1에서 과일 선택 후 딸기·베리/감귤/사과·배의 x좌표가 루트 오른쪽이고 폭 안에 있으며 overflow0 |
| 005 | 실제 상세 fixture에서 정가=12900 및 정가12000<판매가12900인 두 경우 정가·할인 key 없음, 판매가·식품 면책 유지 |
| 007 | 실제 cart fixture의 합계39999/40000/40001 UI: 39999는 배송비3000·남은1원, 40000 이상은 배송비0·무료배송 배지·남은 금액 안내 없음 |
| 012 | 실제 주문의 이벤트만0건으로 만든 fixture: state-data와 주문 요약 유지, EmptyState의 y좌표가 요약 아래. 주문 자체 empty 미리보기와 구분 |
| 023 | 실제 localOnly app/console 두 빌드·한 브라우저 두 탭에서 0042 생성→모의결제→피킹→포장→출고. 앱 탭에서 storage/세계 visibility 갱신 경로만 시험으로 차단해 출고 전 스냅샷을 유지한 뒤 **trusted native focus만으로 배송중0042 표시**·route 유지·다른 데모 probe 보존·업무/외부 요청0을 단언. 공개 증거는 남음 |
| 024 | 실제 앱15+콘솔6 각각 data→loading→empty→error→retry→data, 업무 스냅샷/revision·앱 route 보존. 중앙 Widgetbook의 정확히21 업무 Page에서 4상태 knob와 retry를 전수 단언. 상태별 Linux 골든은 W4-08 |

주요 단언은 `app/app/test/app_test.dart`, `feature/app_router/app/test/src/grocery_app_shell_test.dart`, `feature/console_router/console/test/console_router_test.dart`, `feature/grocery_product/app/test/src/presentation/grocery_product_pages_test.dart`, `feature/grocery_order/app/test/src/presentation/grocery_order_pages_test.dart`, `package/grocery_host/test/src/grocery_entry_test.dart`, `app/app_widgetbook/test/widgetbook_use_case_render_test.dart`에 있다.

Widgetbook의 일부 상세/폼 empty가 notFound 오류로 보이고 오류의 retry가 같은 오류 응답을 반복하던 배선을 수정했다. 전시 저장소는 데모 소유 `GroceryScenarioPreview`를 공급하고 각 기능 조립이 `GroceryPreviewSource`를 받는다. 앱의 localOnly 세션과 같은 BLoC 상태 분기를 쓰며 retry는 실제 data로 돌아간다. 업무 저장소/원격 저장소에 시험 미리보기를 등록하지 않는다. shopper의 별도 조립도 같은 factory로 결합했다.

첫 진입은 bootstrap의 localOnly 세계 등록에서만 요구한다. 기존 서버 gate·JWT·업무 신원·누락 설정 명시 오류와 [W4-04 bootstrap 소유 계획](s4-w4-04-bootstrap-plan.md)은 유지한다. 세계 초기화는 entry 키도 지우므로 현재 체험은 계속할 수 있지만 새 방문에서는 다시 역할을 고른다. 언어/prefs/EmbedSync/preboot 결합은 W4-06~07이다.

## 실제 두 탭 focus와 실행 조건

하네스는 `tool/pages/smoke/fr-focus.mjs`다. 앱과 콘솔을 각각 release/localOnly/hash URL/동봉 CanvasKit으로 빌드하고 정적 fixture 서버에서 열었다. 시드 A를 직접 고쳐 출고시키지 않고 **실제 UI와 기능 저장소/호스트 포트**로 주문을 생성·모의결제·피킹·포장·출고했다. 저장 스냅샷은 각 실제 전이를 확인하는 읽기 단언으로만 쓴다. 출고 코드는 `out_for_delivery`다. 원래 9단계 주 투어·최소금액/재고/슬롯/옵션 경계의 회귀는 workspace 시험에 유지했으며 이 하네스를 공개9단계 전체 여정 완료로 계산하지 않는다.

Playwright1.63.0은 기본 CDP 세션에서 focus emulation을 켜므로 새 CDP 세션의 override만으로 실제 탭 focus를 측정할 수 없었다. 설치된 공식 API의 `connectOverCDP(..., {noDefaults:true})`·독립 임시 Chromium profile·default context를 사용했고 GUI **Chromium153.0.8010.12**에서 trusted focus를 확인했다. [Chromium focus emulation 프로토콜](https://chromedevtools.github.io/devtools-protocol/tot/Emulation/#method-setFocusEmulationEnabled)과 설치된 Playwright `types/types.d.ts`의 noDefaults 설명을 대조했다. synthetic focus dispatch나 수동 world.refresh는 없다. 시험 profile과 실행 브라우저는 종료 후 정리했다.

최종 `fr-focus-pass.json`: focus 체크1성공, route 보존, trusted focus, 업무0/외부0. **콘솔 오류0/전체 smoke PASS는 선언하지 않는다:** app/console만 담은 로컬 fixture의 자동 루트 `/favicon.ico` 요청은404·console resource 오류1이었다. 이 한 경로를 별도 기록했고 다른 자산/브라우저 오류는 시험을 실패시킨다. 실제 공개6표면·루트 정적 자산은 W4-11에서 검증한다. 이 관찰만으로 공개 배포의 favicon 결함을 단정하지 않는다.

```sh
node tool/pages/smoke/fr-focus.mjs \
  --root /Users/dongwoo/orca/toolchains/637/xhost/s4-659-w4-05/web \
  --out /Users/dongwoo/orca/toolchains/637/xhost/s4-659-w4-05/fr-focus-pass.json \
  --headed true
```

## 로컬 검증·DB·공급 영향

Flutter3.47.6 / Dart3.13.5 / macOS arm64. 무거운 작업은 순차 실행했다. 실행 전 디스크 Available은 약63GiB이며 40GB 미만 진입은 없었다. Serverpod profile·고정 CLI·모든 의존은 **4.0.3**, co-package는 **c003ca2c**, CoUI는 **v0.158.0**이다. [W4-02 정렬](s4-w4-02-baseline-v1.md) 이후 공급 상향0이다.

| 검증 | 결과 |
|---|---|
| workspace flutter pub get | exit0·2.342s |
| 고정 Serverpod module7→host generate | exit0·121.388s |
| 공식 Flutter Slang/build_runner codegen | exit0·29.462s |
| 반복 생성 manifest | **251파일 hash diff0** |
| dart analyze --fatal-infos | exit0·최종7.656s |
| 계약 check_all.sh | exit0·최종4.467s |
| TZ=UTC workspace | 34패키지·**577성공·625skip·0실패**. 최초 전체168.211s의 앱 이름 표기1실패를 수정해 해당 앱10개7.131s로 재검증했고, 최종 의미 노드 단언 후 앱10개4.603s도 통과 |
| 중앙 Widgetbook | 47성공·skip0: 업무 Page21개 등록, 21×4 knob·21 retry 및 기존 use-case 렌더 등 |
| fresh DB | workspace 안 호스트74성공·skip0. 실제 IdP/JWT/SDK·권한·revision·동시성·원자성·교차 기능 포함 |
| 기존 fixture prepare→official migration 재적용 | exit0·8.755s/8.507s. **18업무 테이블·429행 모든 값/revision, seed와 ko/en 투영 동일**, 실행이 만든 격리 DB만 정리 |
| localOnly 웹 app/console build | exit0·최종 app25.640s, console26.628s |
| 실제 두 탭 trusted focus | exit0·4.695s·체크1성공. 위 루트 favicon404 별도, 공개 smoke 아님 |

이번에는 **새 schema/migration이 없다**. PR6 대비 서버·SDK·migration 원본 diff0이며 DB의 두 번째 경로는 기존 schema의 재적용/no-op 회귀다. W4-04의 revision→login 실제 upgrade 증거와 구분한다. 생성 SDK import·migration history 수기 수정0이다.

**625skip = Linux 전용 골든624 + 서버 URL 없는 일반 contract1**로 W4-03/04 분류와 동일하다. 새로운 skip0이며 성공/완료 수에 포함하지 않는다. 이번 묶음에서 별도 필수 SDK/localOnly contract 서버를 다시 실행하지 않았고 W4-04의 같은 시험 성공을 이번 head의 새 실행으로 승계하지 않는다.

co-package 상향/투영 변경0, 골든 PNG 변경0이다. 번역 변화는 grocery_host **ko/en 시작 버튼1키씩**과 공식 Slang 출력이다. 첫 역할 화면/구매자 배너와 WB error/empty 표시가 변경되었으며 Linux 캡처·compare는 남았다. 11언어·DisplayProjector·목록/상세 같은 id·C overlay·첫 ar/dark·RTL 검증으로 승격하지 않는다. CoUI의 ko 이외 달력/요일/Pagination 영어 chrome는 공급 갭 [coui#5084](https://github.com/coco-de/coui/issues/5084)의 언어 고정 예외이며 앱 우회 delegate는 추가하지 않았다. 예산으로 미머지인 coui#5354나 새 공급 ref는 소비하지 않았다.

명령/시간·실패와 수정·577/625 집계·251파일 manifest·기존 fixture 비교·실제 두 탭 JSON/캡처는 `/Users/dongwoo/orca/toolchains/637/xhost/s4-659-w4-05/`에 있고 `artifact-sha256.json`으로 해시를 기록한다. 브라우저 초기 실패는 역할 의미 노드 병합, 중첩 버튼 locator/페이지 전환 대기, 시험 status 코드, Playwright focus emulation, 루트 favicon 분류로 구분해 보존했다. 마지막 focus 성공만 완료 근거로 쓴다.

## 남은 BLOCKED와 다음 묶음

| blocker / issue | next |
|---|---|
| 조직 Actions 예산 / cocode#637 | CI job 조사·재실행·workflow 수정 없음. 예산 복구 후 coordinator의 PR2→3→4→5→6→이번 PR 머지 열차 |
| locale 소비 전수 / co-package#70/#71/#78·#95, cocode#659 L1~6 | **이번 PR head에서 W4-06 브랜치**: 후보 c4450dc1/0ffc7946 선별, docs/locale-data.md 전필드/예외, 기능소유 fieldset/DisplayProjector·실제11×필드표·사전 제거·같은 id. 부족분은 PC-B 공급 이슈로 요청. 이어 W4-07 AppPresentation/prefs/EmbedSync/C overlay/preboot/RTL |
| Linux 골든·scale·폰트 / cocode#659 AC13/14 | W4-08 상태/언어/capture/compare·정확한4화면4조합·DCM. 624skip은 완료 아님 |
| 실제 Patrol·공개9단계·두 탭 / cocode#659 AC12·FR023 | W4-09 실제 runner/device와 W4-11 공개 빌드 증거. 로컬 focus 성공이 게시 증거를 대신하지 않음 |
| 공개6표면·루트 자산·전체 smoke / cocode#659 AC16 | W4-11 wiring/credentialscan/직접 접근/reload/오류0·0업무요청. 로컬 fixture favicon 관찰은 공개에서 재확인 |
| Mobbin·아이콘·v3 option_sheet / cocode#659 AC15, coui#5149, cocode#638 F3 | 접근 가능한 세션/승인 공급 ref 후 W4-10·후속 소비. 공급 저장소 수정0 |
| bundle exact profile/verified·full cleanbase / co-bricks#830/#831/#764/#860 | 공급 승인 후 W4-12 full·diff0, W4-13 같은 최종 SHA 증거/사이드카 제출. legacy stamp 수기 승격 없음 |

§14 capability 경계는 유지한다: PG/실환불은 모의전이, 배송기사 API는 콘솔 이력, 주소검색은 시드2주소, push는 알림함 기록, billing/scheduling은 정기설정, 쿠폰/적립은 지표, WMS는 단일재고, media_upload는 번들 사진이다. 실제 외부 capability·verified·전체 앱 완료·갤러리 체험 가능을 선언하지 않는다.