실행 앱 여정 — W4-09

# 실행 앱 여정 — W4-09

실행 앱이 기능 사이 여정을 소유한다. `app/app`·`app/console`의
`integration_test/features/*.feature`가 원본이고, 각 `build.yaml`이 승인된
co_bdd `5b479112`로 widget와 Patrol 테스트를 생성한다(co_bdd 가 포맷된 코드를 낸다 — co-package#101; 생성 Patrol 시험은 `setUpAll` 에서 `HarnessFonts.settle` 로 시험 이름 라벨 글꼴을 확정한다 — co-package#104). 생성물은 손으로 고치거나
따로 포맷하지 않는다. 기존 feature-local widget-only 16편을 이동하거나 삭제하지 않는다.

| 원본 / 실행 범위 | widget | Patrol 생성 |
|---|---:|---:|
| app `host_journeys.feature` — 9단계 투어·checkout locale·두 namespace reset·ar/dark 시작·최소주문/품절 | 5 | 5 |
| console `host_journeys.feature` — 피커 pack/dispatch 거부·3역할 stock/slot scope·stock locale | 3 | 3 |
| app `installed_bootstrap.feature` — 실제 bootstrap·플랫폼 저장소 초기화 | 0 | 2 |
| console `installed_bootstrap.feature` — 실제 bootstrap·플랫폼 저장소 초기화 | 0 | 2 |

`both` 여정은 실제 App·ConsoleApp과 생산 기능 저장소/호출자 포트를 같은 메모리
원장에 조립한다. 앱→콘솔→앱의 mount는 **프로세스 안 셸 통합**이다. 브라우저 두 탭,
focus/visibility, iframe, 새 창, 페이지 reload를 검증했다고 계산하지 않는다.
`demo-ecommerce-b2b/`는 저장소 격리를 검사하는 다른 namespace fixture이며 다른 데모
전체 앱을 실행한 증거가 아니다. 공개 두 데모 여정은 W4-11에 남는다.

`patrol-only`는 실제 생산 bootstrap과 그 bootstrap이 선택한 플랫폼 WorldStore를
사용한다. 드라이버가 Patrol이 아니거나 localOnly·demo-only 빌드 정의가 없으면 즉시
실패한다. 초기화 시험의 외부 namespace sentinel은 이전 값을 보존해 원복하며 다른
데모의 실제 world key를 수정하지 않는다. VM/네이티브의 생산 저장소는 메모리이고 웹은
브라우저 저장소다. 이를 네이티브 영속 저장 기능으로 표시하지 않는다.

```sh
flutter pub get
tool/feature_modules flutter-codegen
# test/의 수기 runner는 생성된 widget main만 가져온다.
(cd app/app && flutter test --no-pub test/src/bdd/host_journeys.widget_test.dart)
(cd app/console && flutter test --no-pub test/src/bdd/host_journeys.widget_test.dart)
TEST_SUITE=bdd tool/dev/test_all.sh
```

생성 Patrol은 test/ 밖에 두므로 일반 widget 실행이 device 실행을 발견하거나 skip하지
않는다. `integration_test/host_journeys_test.dart`는 생성 Patrol main들만 조립한다.
`dart_test.yaml`은 태그를 선언할 뿐 skip·exclude 설정을 추가하지 않는다.

baseline v1.1(coui v0.159.0 — 웹 선택 결함 [coui#5361](https://github.com/coco-de/coui/issues/5361)·
[#5268](https://github.com/coco-de/coui/issues/5268) 수정) 뒤 PC-C 로컬 chrome 에서 아래 명령으로 실제 실행했다
(2026-10-11, 기본 선택 켬): app **8/8**(8m40s) · console **5/5**(3m34s). app 에는 언어 · 테마 · 모션 ·
탐색 뒤 텍스트 선택(@selection)이 있다. 첫 app 실행은 6/8 이었다 — 1280폭 rail 셸에서 공유 「scroll
until」(첫 Scrollable)이 레일을 밀었고, 대상의 조상 스크롤만 움직이는 `I bring the {…} widget into view`
로 고쳤다(VM 1280×720 재현 · coui NavigationBar 무변경). CI 에서는 `ci.yml` 의 `Patrol (chrome)` 잡이 같은
명령을 headless · `--web-locale ko-KR` 로 돌고 `tool/ci/check_patrol_count.py` 가 `.feature` 시나리오 수(app 8 ·
console 5)와 Playwright 통과 수를 맞춰 본다 — 증거 대장 patrol 게이트는 그 잡이다(device chrome).

**앞 트리 해제 확인(#16 — 열림)**: Patrol 웹은 시험마다 새 페이지를 열지만 그 페이지에서 요청되지 않은 앞
시험들도 시험 전 · 뒤 `runApp` 을 거친다. 실행 앱 바인딩(Live)은 그 루트 부착을 Timer 로 미루고 warm-up 프레임을
따로 돈다. 가끔 시험이 시작되기 전에 루트 View 가 이미 망가져(자식 없음 · 글자 0) 셸을 붙이면 같은 GlobalKey
(`_DeprecatedRawViewKey`)로 RawView 가 다시 붙어 실패한다 — `AppJourney` 를 쓰지 않는 installed bootstrap 시험도
같은 예외로 실패하므로 하네스 밖(바인딩 · 웹 엔진) 원인으로 본다. 하네스(`AppJourney`·`ConsoleJourney`)는 시험
시작에 바인딩의 빈 트리(`Test starting...` · `Test finished.`)가 붙고 남은 프레임이 없을 때까지 프레임 단위로
확인하고(아니면 루트 상태를 적어 즉시 실패), 시험 끝에는 빈 트리를 직접 붙여 셸이 내려간 것을 단언한 뒤에 라우터 ·
등록 · presentation 을 해제한다. 재현율(baseline v2 후보 1 · PC-C 로컬 headless, 시험 = 새 페이지):

| 하네스 | `@selection` 단독 | 전체 묶음(8 시험) |
|---|---|---|
| 수정 전 | 2/20 실패 | 5회 중 2회 실패(@first-frame · @selection) |
| 시작 빈 트리 확인 + 끝 해제 | 0/20 | 5회 중 1회(@boundary — 확인 단계가 망가진 루트를 잡음) |
| 위 + 두 빈 트리 · 진단(채택) | — | 5회 중 2회(@selection 진단 `root=[root] texts=[]` · installed bootstrap GlobalKey) |
| 루트를 빈 ViewCollection 으로 내렸다 다시 붙임 | 20/20 실패 | 40/40 실패(웹 엔진 semantics 노드 맵 불일치) — 버림 |

재현율은 0 이 아니다 — 재시도 · skip 으로 감추지 않고 #16 을 열어 둔다. 앱 코드 · 단언 · 시나리오 수는 그대로다.

설치된 PC-A CLI의 `patrol test --help`(patrol_cli 4.8.0, lock의 patrol 4.10.0)로
옵션을 확인했다. 승인된 격리 브라우저에서는 각 호스트 디렉터리에서 다음을 실행한다.

```sh
patrol test --device chrome --target integration_test/host_journeys_test.dart \
  --dart-define=COB_RUNTIME_MODE=localOnly --dart-define=COB_DEMO_ONLY=true \
  --dart-define=FLAVOR=development --dart-define=WEB_URL_STRATEGY=hash \
  --web-workers=1
```

네이티브 app runner는 coordinator가 지정한 device와 네이티브 Patrol 배선을 먼저
확인한다. console에는 web 플랫폼만 있으며 이 묶음에서 가짜 native 프로젝트를
추가하지 않았다. 기본 텍스트 선택 영역을 끄거나 Flutter 예외를 억제하는 옵션은 없다.

투어는 첫 역할→홈 카드/상세→필수 중량/담기→장바구니 4줄/35,180원→슬롯 경계→
0042 주문/모의결제/잔여3→2→콘솔 4줄 피킹/시금치200→300/포장/출고→앱6이벤트/알림→
1/17 슬롯 마감/앱 비활성/초기화/전체 시드 복원을 단언한다. 테스트 실행 시간은
공개 사용자의 3분 완료율이나 cold 첫 data 3초 실측을 대신하지 않는다.

PG·실환불, 기사 API, 주소검색, push, billing/scheduling, 쿠폰/적립, WMS,
media_upload capability는 이번 여정으로 covered가 되지 않는다.