데모 크롬은 로그인 화면으로 (cocode#1259)

# 데모 크롬은 로그인 화면으로 (cocode#1259)

> **사용자 결정 2026-10-14 — 데모 크롬은 로그인 화면으로(cocode#1259).** 앱이 실제 앱처럼 보이도록 상단 안내 띠 ·
> [데모 도구] 시트를 없애고, 데모 관련 선택은 localOnly 로그인(진입) 화면에서만 한다. 공용 위젯은 커널
> `DemoLoginPanel`(kernel#48 — `package/core/lib/src/demo/panel/`, 바이트 동일 복사)이다.

## 무엇이 어디로 갔나

| 요소 | 전(#22 1차 · main) | 후 |
|---|---|---|
| 체험용 데모 안내(S-13) — 「체험용 데모 · 서버 없이 이 브라우저에만 저장 · 기준시각」 | 앱 · 콘솔 상단 띠(상시) | 로그인 화면 `DemoLoginPanel.notice` 1회 |
| 제외 기능 요약(실제 결제 · 환불 · 배송기사 연동 · 알림 발송 없음) | 없음 | 로그인 화면 안내 문단(`demo-excluded`) + 동작 화면의 기존 문맥 안내(아래) |
| 데모 계정(역할) 선택 | 앱: 진입 카드 「구매자 ○○로 시작」 · 콘솔: 띠 시트의 역할 칩 | 로그인 화면 「데모 계정」 — 「이름 · 역할」 버튼 = 로그인(`demo-account-<id>`) |
| 계정 전환 | 콘솔 시트의 역할 칩 | 헤더 계정 메뉴 「로그아웃」 → 로그인 화면(세션 키만 지움 · 업무 데이터 유지) |
| 데이터 초기화(확인) | 띠 시트 | 로그인 화면 「데이터 초기화」(destructive + `DemoConfirm`) |
| 언어 · 테마(S-18) | 없음(URL · 포털만) | 로그인 화면 「언어 · 테마」 + 헤더 계정 메뉴 「설정」 대화상자 — 같은 `AppPresentation` 하나(URL · 포털 이어받기 유지) |
| 상태 미리보기(FR-024) | 띠 시트 | 앱 UI 에서 제거 — 세션 훅(`HostGrocerySession.usePreview`)은 유지하고 위젯 · BDD 시험 · 골든이 쓴다 |
| 기준시각(데모 시계) | 띠 문구 | 로그인 안내 1줄에만 — 앱 화면에는 없다(`AppClock` 결정성은 그대로) |
| 앱 헤더 | 띠 + 브랜드 · 알림 종 | 브랜드 · 알림 종 · 계정 메뉴(이름 ▾ — 역할 · 설정 · 로그아웃) |
| 콘솔 헤더 | 띠(역할 칩) | 브랜드 · 계정 메뉴(같은 위젯) |
| 직접 진입(딥링크) | 진입 카드 뒤 경로 유지 | 같다 — 세션이 없으면 로그인 화면, 로그인 뒤 같은 경로(`?role=` 딥링크는 이 앱에 없다) |

세션 키는 셸마다 하나다: 앱 `demo-ecommerce-grocery/entry/app` · 콘솔 `…/entry/console`(값 = 계정 id). 초기화는
네임스페이스 전체를 시드로 되돌리므로 세션 키도 함께 지워지고(로그인 화면에 머문다) 다른 데모 네임스페이스는 그대로다.

### 제외 capability 의 문맥 안내(가짜 구현으로 covered 처리하지 않음)

상시 띠 대신 동작 화면에 이미 있는 짧은 안내를 쓴다 — 결제 「결제(모의)」 · 환불 「환불(모의)」 · 정기배송
「자동 주문 · 정기결제는 하지 않아요」 · 알림함 「이 데모의 알림은 모두 가상 안내예요」 · 출고는 콘솔 이력만.
§14 capability 경계(PG/실환불 · 기사 API · 주소검색 · push · billing/scheduling · 쿠폰/적립 · WMS · media_upload)는 그대로다.

## PRD 정정 후보(PRD 스냅샷은 손대지 않는다 — `tool/fr/prd_snapshot.json`)

| AC | 지금 문구 | 정정 후보 | 묶인 시험(coverage.json) |
|---|---|---|---|
| FR-001 AC1 | …홈 피드가 열리고 **배너에** "서버 없이 이 브라우저에만 저장"이 보인다 | 로그인 화면 안내에 "…저장"이 보이고, 구매자 오하늘을 고르면 홈 피드가 열린다 | 셸 시험 「FR-001 AC1 — 첫 방문 로그인 화면에…」 · BDD 「localOnly 빌드는 로그인 화면에 체험용 데모 안내를 보인다」 |
| FR-001 AC2 | 「초기화」 확인 | 로그인 화면의 「데이터 초기화」 확인(로그아웃 → 초기화 → 다시 로그인) | 셸 시험 「로그인 화면의 데이터 초기화는…」 · BDD 「로그인 화면의 데이터 초기화로 주문 0042 가 사라진다」 |
| FR-024 AC1 · AC2 · FR-002 AC2 | 「상태 미리보기 loading/error/empty」 | 상태 미리보기는 앱 UI 밖(Widgetbook · 골든 · 시험 훅) — 화면의 4상태와 「다시 시도」 계약은 그대로 | 셸 · 콘솔 시험의 세션 훅 단언, BDD `the screen state preview is` |
| FR-025 AC2 | **배너에** "체험용 데모" | 로그인 화면 안내에 "체험용 데모" | BDD 위와 같음 · 콘솔 시험 「첫 방문은 로그인 화면…」 |

## 시험

- 앱 화면에 데모 크롬이 없음을 단언: 셸 시험 `_expectNoDemoChrome` · BDD/Patrol step `the app should show no demo chrome`
  · 공개 locale 스모크(로그인한 앱 · 콘솔 접근성 트리에 「체험용 데모 · 데이터 초기화 · 상태 미리보기 · 데모 도구」 0).
- 로그아웃 · 설정: 셸 시험(로그아웃은 세션만 지움 · 설정 대화상자) · app locale 시험(설정의 언어 · 테마가 같은 presentation 에
  요청) · 콘솔 시험(로그아웃 → 다른 계정 = 계정 전환, scope 재판정).
- Patrol: 시나리오 수 그대로(app 8 · console 5) — `I open the demo tools` → `I sign out to the demo login screen`.
- 골든: `package/grocery_host/test/golden` 로그인 화면(앱 · 콘솔) 144장 신규 — 기준은 셀프호스트 러너가 `[update-goldens]` 로
  만들었다(b7d81b6 · 앱 폰트 적용). 기존 기능 골든은 셸을 그리지 않아 바뀐 기준 0. 분류는 `s4-1259-golden-classification.csv`.