# YOINO — 要件定義書（再現用フルスペック）

> このドキュメント **1枚だけ** を別の Claude Code セッションに渡せば、公開中のデモと同じ画面・動き・データのアプリが作れることを目的とした仕様書です。
> プロダクト：ソウゾウ合同会社が作った**架空の飲み会アプリ「YOINO（ヨイノ）」のデモ**。運営会社「株式会社ヨイノ（架空）」も架空です。
> 種別：**時間制の飲み会マッチング**。ゲスト（主に男性）が、運営の審査を通ったキャスト（主に女性）を飲食店に呼び、一緒に飲む時間の分だけ料金を払う。**性的なサービスではない**。
> サービス名・会員・キャスト・お店・会社・銀行・金額・運営の担当者名は**すべてデモ用の架空のもの**です。実在の人・店・会社とは関係ありません。

実装者への最初の指示（そのまま使ってよい）：
> このMDだけを唯一の仕様として、記載どおりの画面・機能・データ・金額の計算で実装してください。まず「作成するファイルの一覧」を出してから実装します。色・角丸・書体は §4 の変数（CSS の `--` で始まる値）だけを使い、画面の部品に色の値を直接書かないこと。金額の計算は §10 の1つのファイルだけで行い、画面ごとに計算し直さないこと。実装後は §16 の受け入れ基準を自分で確かめてください。

---

## 1. プロダクト概要

| 項目 | 内容 |
|---|---|
| コンセプト | 「今夜の1杯を、もっと楽しく。」本人確認を通ったキャストを、**料金を先に決めてから**飲み会に呼べる |
| 形 | 1つの画面の中で、**ゲストのスマホアプリ・キャストのスマホアプリ・運営のWeb管理画面**の3つを、同じデータのまま同時に動かす |
| 見せたい流れ | ゲストが条件で呼ぶ → 料金が先に決まる → 支払い（見本のカード） → キャストのアプリにその場で届く → 受けると確定 → 運営の「今夜の手配」に出る → 合流 → 10分ごとの延長 → 終了で精算 → 評価 → 領収書 |
| 決まりごと | 登録・メッセージは無料。料金は会った時間の分だけ。料金はポイント（1P＝1円・税抜＝1.1円・税込）。延長は10分ごと。キャストが決まる前のキャンセルは無料 |
| 安全 | 20歳以上だけが登録できる。ゲストは顔写真つきの身分証、キャストは身分証と面接で、運営が本人確認をする。評価・通報・利用停止がある |
| 非ゴール | 本物の決済・本物の本人確認・SMS やメールの送信・プッシュ通知・位置情報・サーバーとデータベース・ログイン（§14） |
| 見せ場の動き | ①呼ぶ → 近くのキャストが順に光る → 受けたキャストのカードが手前に来る　②バッジが付く瞬間のメダル |
| トーン | 白地＋はっきりした明るい色1つ（ローズ）＋角丸でやわらかく＋大きな数字。夜の写真で雰囲気を出し、画面そのものは明るく清潔に |

デザインの方針：
- **白地に強調色は1つ（ローズ `#e5195b`）だけ**。紫のグラデーション・光る枠・ガラス風（すりガラスの背景）は使わない。
- 写真は**夜の飲み会の雰囲気**（キャスト・お店・乾杯・夜の街）。露出の多い服や性的な表現は使わない。
- 明朝体は使わない。本文は Noto Sans JP、数字とロゴは Outfit。
- 「No.1」「登録者数◯万人」などの根拠のない数字、体験談は画面に出さない。
- 他社のサービス名・ロゴ・アイコンは画面に出さない。

---

## 2. 使う人

| 使う人 | どの画面で | できること |
|---|---|---|
| ゲスト（男性会員） | スマホアプリ（ゲスト） | 会員登録（20歳以上の確認・本人確認書類）・今から会えるキャストを探す・指名して呼ぶ・条件で呼ぶ（料金が先に決まる）・見本のカードでポイントを買う・合流・延長・終了して精算・キャストを評価・領収書の発行・メッセージ・通報・キャンセル・マイページ（ポイント・会員ランク・利用履歴・本人確認） |
| キャスト（女性） | スマホアプリ（キャスト） | 待機のスイッチ・届いた呼び出しを受ける／見送る・合流した・ゲストを評価・出勤できる日時の登録・今月の報酬（棒グラフ）と振込の申請・実績のバッジ・写真の差し替え（運営の審査待ちになる）・メッセージ・通報 |
| 運営 | Web管理画面 | 今夜の手配（対応が要るものの件数）・呼び出しの一覧と手配（キャストの割り当て・運営の判断でのキャンセル）・キャストの審査と写真の承認と利用停止と特別なバッジ・ゲストの本人確認と利用停止と特別なバッジ・決済と振込・通報への対応と低い評価・バッジの条件の変更・操作の記録 |

デモで最初に動かす人（固定）：
- ゲスト：**ケンタさん（`G-0001`・早瀬 健太・34歳・本人確認済み・株式会社ハヤテ企画〈架空〉）**。ポイント残高 7,000P、利用2回で「あと1回でシルバー会員」。
- キャスト：**ミオさん（`K-0001`・28歳・恵比寿・0.8km・スタンダード）**。待機中、合流49回で「あと1回で合流50回のバッジ」。
- 運営：**運営（西村）**（架空の担当者名。操作の記録に出る）。

---

## 3. 技術構成

- **Vite + React 19 + TypeScript**。ルーター（URL で画面を切り替える仕組み）は使わず、画面は状態（`route`）で切り替える。
- CSS は普通の CSS ファイルだけ（Tailwind などは使わない）。アイコンも自前の SVG の線画（外部のアイコン集は使わない）。
- 状態は React の `useState` + Context（外部のライブラリは使わない）。
- サーバーもデータベースも無い。データはすべてブラウザの **localStorage**（ブラウザの中の保存場所）に保存する。
- 画像は `public/img/*.webp`。

`package.json`（依存の目安）：
```json
{
  "type": "module",
  "scripts": { "dev": "vite", "build": "tsc -b && vite build", "preview": "vite preview --port 4173 --strictPort" },
  "dependencies": { "react": "^19.2.8", "react-dom": "^19.2.8" },
  "devDependencies": { "@types/react": "^19.2.18", "@types/react-dom": "^19.2.7", "@vitejs/plugin-react": "^6.1.1", "typescript": "~6.0.2", "vite": "^8.3.6" }
}
```

`index.html`：
```html
<html lang="ja">
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
<meta name="robots" content="noindex, nofollow, noarchive" />
<meta name="description" content="ご提案用デモ（架空データ）。実際のサービスではありません。" />
<meta name="theme-color" content="#E5195B" />
<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+JP:wght@400;500;700;900&family=Outfit:wght@500;600;700;800&display=swap" rel="stylesheet" />
<title>YOINO 飲み会アプリ デモ（ゲスト・キャスト・運営）</title>
```
`public/robots.txt` は `User-agent: * / Disallow: /`（検索エンジンに載せない）。

`src/config.ts`：appTitle「YOINO 飲み会アプリ（ゲスト・キャスト・運営）デモ」・serviceName「YOINO」・operator「株式会社ヨイノ（架空）」・storagePrefix `yoino-1116`（localStorage のキーの頭。`-state-v1`・`-view`・`-session`・`-onboarded`・`-speed`・`-voice`・`-gsearch`）・注記の文（§5.2）。

---

## 4. デザイン仕様

### 4.1 色（`:root` の変数）
```
--ink: #17141a（本文） / --ink-2: #47424d / --muted: #6b6572 / --faint: #a49eab（いちばん薄い）
--line: #ebe7ee（枠線） / --line-2: #f3f0f5 / --bg: #f7f5f8（管理画面の背景） / --surface: #ffffff / --sunk: #f5f2f6（沈んだ面）
--brand: #e5195b（ローズ：主なボタン・選んだ印・数のバッジ） / --brand-ink: #c0124c（ローズの文字）
--brand-soft: #ffe7ef / --brand-tint: #fff4f7（ローズの淡い地） / --brand-bright: #ff3d72（キャストの印の点）
--night: #1c1622（上部の帯）
--crit: #c8372d / --crit-soft: #fdeeec   /* 危険・利用停止 */
--warn: #b25f00 / --warn-soft: #fff4e2   /* 注意・審査待ち */
--ok:   #1d7a4b / --ok-soft:   #e5f5ec   /* 完了・活動中 */
--info: #2a5fb0 / --info-soft: #ebf2fc   /* お知らせ・合流中 */
--proposal: #ff3913 / --proposal-ink: #c22a0b / --proposal-soft: #fff0eb   /* 「ご提案」の札 */
--radius: 14px
```
待機中の点（`.live-dot`）は緑 `#18b26b` に薄い輪。ゲストの印の点は青 `#3b82f6`。

バッジの色（`tone`）：`blue #2b78e4`（本人確認）・`silver #5b86c4`・`gold #d79a10`・`platinum #6c5fd6`・`rose`＝ブランド色・`green #1c9a5c`（遅刻なし）・`amber #e0761b`（高評価）・`ink`＝黒地に白（運営が付ける特別なバッジ）。札（`.bdg-chip`）は各色の淡い地に濃い文字、角は丸く（999px）。

### 4.2 書体
```
--sans:  'Noto Sans JP', 'Hiragino Sans', 'Hiragino Kaku Gothic ProN', 'Yu Gothic', 'Meiryo', sans-serif
--latin: 'Outfit', 'Noto Sans JP', sans-serif      /* 数字・ロゴ・時刻 */
```
- 本文 15.5px／行間 1.7。見出しの改行は `word-break: auto-phrase`（言葉の途中で折り返さない）。
- 金額・残高・時刻・件数は `--latin` で、数字の幅をそろえる（`tnum`）。
- ロゴ「YOINO」は Outfit 800・25px（ようこそ画面は 34px）、右上にローズの小さな丸（8px）を付ける。

### 4.3 形
- アプリのボタン（`.abtn`）：高さ 48px 以上・角は丸く（999px）・太字 15.5px。主なボタン＝ローズ地に白文字＋ローズの淡い影。大きいボタン（`.big`）は横幅いっぱい・高さ 56px・17px。ほかに `ghost`（白地に枠）・`soft`（ローズの淡い地）・`dark`（黒地）・`danger`（赤地）・`sm`（高さ 40px）。押すと 0.97 倍に沈む。使えないときは灰色 `#cfc8d4`。
- 押せる物はすべて 44px 以上（片手で押せる大きさ）。
- キャストの写真カード：縦長 `3 / 4.15`・角 20px・写真の下に黒の半透明のグラデーション（白文字を読ませる）。
- 下から出る板（ボトムシート）：上の角 26px・上に持ち手の線・閉じるボタン・Esc と背景を押すと閉じる。
- 運営の管理画面のボタン（`.btn`）：角 8px・高さ控えめの業務画面の形。

### 4.4 画面の大きさ
- アプリは**スマホの枠（画面 390×844）**の中に出す。1100px 以上の幅では枠は幅 406px・高さ 860px・角 44px・黒い 8px の縁。560〜1099px でも枠を出す。559px 以下は枠なしで画面いっぱい。
- 1100px 以上でだけ「並べて表示」（左にスマホの枠・右に管理画面）ができる。

### 4.5 動き（`motion.css` にまとめ、名前の頭に `yo-` を付ける）

| 対象 | 動き |
|---|---|
| 下から出る板 | 背景がふわっと出る（0.18秒）・板が 40px 下から上がる（0.28秒） |
| ホームのキャストのカード | 1枚ずつ下から現れる（0.42秒・1枚ごとに 45ms ずつ遅らせる・最大8枚分） |
| 見せ場①探し中 | 自分の丸の周りに輪が3つ、2.6秒ごとに広がって消える（0.85秒ずつずらす）。お知らせを送ったキャストの顔が、近い順に 0.55秒ずつ遅れて灰色から色付きになり（`yo-lit`）、輪が打つ。見送ったキャストは灰色のまま |
| 見せ場①確定 | 確定して15秒以内に開くと、受けたキャストのカードが下から拡大しながら手前に来る（0.7秒・人ごとに 120ms ずらす）。続いて時間と場所が出る |
| 届いた呼び出し | カードが下から現れ、印の点の周りに輪が打ち続ける |
| 合流中の合計 | 延長で合計が変わった直後だけ、数字が 1.14 倍に弾んでローズになる（最初の表示では弾まない） |
| 精算できた印 | 丸が拡大し、チェックの線が描かれる |
| 見せ場②バッジ | 白い札が下から弾んで出る・メダルが回りながら拡大（0.9秒）・12本の光の線が外へ散る |
| 運営の手配の表 | 確定・作成から20秒以内の行が、淡いローズから消えていく |

**端末の「動きを減らす」設定（`prefers-reduced-motion: reduce`）**：上の動きをすべて止めて最後の形だけを出す。探し中の輪は 0.45・0.75 倍の大きさで止めて薄く出し、キャストの顔は最初から色付き（見送った人だけ灰色）。バッジの光の線は出さない。

---

## 5. 画面の枠（デモの外側）と切り替え

### 5.1 上部の帯（`.demobar`・黒 `--night`）
- 左：赤い「デモ」の札＋`CONFIG.appTitle`。
- 中：表示の切り替え（タブ）「アプリ」「並べて表示」「運営の管理画面」（狭い画面では「アプリ」「管理画面」。「並べて表示」は 1100px 以上だけ）。選んだものは localStorage に覚える。最初は「並べて表示」（狭い画面では「アプリ」）。
- 右：「デモシナリオ」（再生の印つき）・「使い方」（5枚の案内）・「初期化」（確認の窓「デモのデータを初期化しますか？／このデモで行った操作はすべて消え、最初のサンプルデータに戻ります。」→「初期化する」で最初のデータに戻し、トースト「デモのデータを初期化しました」）。

### 5.2 注記の帯（`.demonote`・淡い黄色）
「サービス名・会員・キャスト・店名・金額はすべて架空のデモです。実際のサービスではなく、決済も行いません（入力内容はこの端末の中だけに保存されます）。」（狭い画面では「すべて架空のデモです。決済はせず、入力はこの端末の中だけに保存します。」）と、右に凡例「［ご提案］＝ 仕様書にはない、追加のご提案」。「ご提案」の札（`.proposal-tag`）は、本番で何が要るかを書いた所に付ける（赤い点線の枠・淡い地・小さな光の印）。
保存に失敗したときは、その下に赤い帯で「この端末に保存できませんでした。画面を閉じると操作内容は消えます」を出す（黙って捨てない）。

### 5.3 アプリの切り替え（`.role-switch`）
スマホの枠の上に、丸い2つのボタン「● ゲスト（男性）」（青い点）「● キャスト（女性）」（ローズの点）。選んだ方は黒地に白文字。キャストに**届いている呼び出し**があり、いまゲストを見ているときは、キャストのボタンにローズの数のバッジを出す。どちらを見ているか（session）は `{ role, guest, cast }` を JSON で localStorage に覚える。最初は `{ role:'guest', guest:'G-0001', cast:'K-0001' }`。

### 5.4 トースト（操作の結果）
画面の右上（上から104px）に黒地・白文字で出す。普通は3.2秒、注意・危険は6秒で消える。

### 5.5 アプリの下のメニュー（ボトムナビ）
- ゲスト：「さがす」（虫めがね）・「呼ぶ」（グラスの線画）・「メッセージ」（未読の会話の数）・「マイページ」。
- キャスト：「呼び出し」（鈴・届いている数）・「出勤」（カレンダー）・「メッセージ」（未読の数）・「マイページ」。
- 選んだ項目はローズの文字＋アイコンの後ろに淡いローズの丸い地。数はローズの丸（白の縁）。
- キャストの詳細・メッセージの会話・領収書・呼び出しの進み（ゲスト）／会話・呼び出しの進み・写真の差し替え（キャスト）は、下のメニューを出さない全画面。

### 5.6 運営の管理画面の骨組み
左に白地のメニュー（幅190px）：ロゴ「YOINO」＋「運営の管理画面」、項目「今夜の手配（探し中の件数・赤）」「呼び出し」「キャスト（審査待ち＋写真の承認待ちの件数）」「ゲスト（本人確認の件数）」「決済・支払い（振込の申請の件数）」「通報・評価（未対応の件数・赤）」「バッジの設定」「操作の記録」、下に「運営（西村）」。選んだ項目は淡いローズの地＋左端にローズの縦線。
上の帯：現在地（家のアイコン ＞ 画面名）、右に全体の検索ボタン「キャスト・ゲスト・呼び出しを検索 ⌘K」と札「架空のデータ」。

全体の検索（⌘K／Ctrl+K）：「名前・ID・エリア・お店で検索」・種類の札（すべて／キャスト／ゲスト／呼び出し）・種類ごとに6件まで・一致した文字に印・↑↓・Enter・Esc。空のときは「検索履歴」と「最近開いた項目」（各5件）。全角半角と大文字小文字はそろえて探す。変換中の Enter は無視。

---

## 6. 画面一覧

| 番号 | 画面 | 使う人 | 内容 |
|---|---|---|---|
| G-01 | ようこそ | ゲスト（未ログイン） | 乾杯の写真・3つの約束・登録／デモのゲストで見る |
| G-02 | 会員登録（6段） | ゲスト | 連絡先 → 確認コード → 生年月日（20歳以上）→ ニックネーム → 本人確認書類 → 確認 → 完了 |
| G-03 | さがす（ホーム） | ゲスト | 今から会えるキャストの2列の写真カード・絞り込み・進行中の呼び出しの帯 |
| G-04 | キャストの詳細 | ゲスト | 大きな写真・ひとこと・本人確認・数・バッジ・評価・通報・指名して呼ぶ |
| G-05 | 呼ぶ | ゲスト | 条件 → プランごとの事前確定料金 → 確認と支払い |
| G-06 | 呼び出しの進み | ゲスト | 探し中（見せ場①）→ 確定 → 合流中・延長 → 精算・評価／キャンセル |
| G-07 | 領収書 | ゲスト | 宛名・但し書き → 見本 → 印刷で PDF |
| G-08 | メッセージ | 共通 | 確定した相手とだけのやりとり・定型文 |
| G-09〜12 | マイページ・ポイントを買う・利用履歴・本人確認 | ゲスト | 残高・会員ランク・パック・履歴・書類の提出 |
| C-01 | 呼び出し（ホーム） | キャスト | 待機のスイッチ・届いた呼び出し・予定・今月の報酬 |
| C-02 | 呼び出しの進み | キャスト | 確定・合流中・評価・キャンセル |
| C-03 | 出勤できる日時 | キャスト | 7日×9時間の◎×の格子 |
| C-04 | マイページ | キャスト | 報酬の棒グラフ・振込の申請・実績のバッジ・評価・写真 |
| C-05 | 写真を差し替える | キャスト | 提出すると審査待ち |
| 共通 | バッジが付いた | 両方 | 見せ場② |
| A-01 | 今夜の手配 | 運営 | 対応が要るもの6つ・動いている呼び出し・売上 |
| A-02 | 呼び出し | 運営 | 一覧 → 詳細（手配・料金と配分・経過・キャンセル） |
| A-03 | キャスト | 運営 | 一覧 → 詳細（審査・写真の承認・特別なバッジ・報酬・出勤・利用停止） |
| A-04 | ゲスト | 運営 | 一覧 → 詳細（本人確認・特別なバッジ・利用履歴・利用停止） |
| A-05 | 決済・支払い | 運営 | 今月の4つの数・振込の申請・手数料の推移 |
| A-06 | 通報・評価 | 運営 | 対応の記録・低い評価 |
| A-07 | バッジの設定 | 運営 | 条件の変更（付く人・外れる人を先に出す） |
| A-08 | 操作の記録 | 運営 | 直せない・消せない記録 |

---

## 7. 画面ごとの仕様 — ゲストのアプリ

### 7.0 共通
- 上の帯（`TopBar`）：左に丸い「戻る」、中央に題、右は空き。高さ 58px・下に細い線・スクロールしても上に残る。写真の上では透明（`clear`）。
- 写真は `/img/{名前}.webp`。読めないときは名前の頭文字の丸を代わりに出す（`Photo`）。
- 画面を切り替えたら、いちばん上に戻す。
- ゲストを選んでいない（`session.guest` が null）ときは G-01／G-02 だけを出す。

### 7.1 G-01 ようこそ
- 上に高さ300px の乾杯の写真（`place-toast`）、下端を白へぼかす。
- ロゴ（大）→ 見出し「今夜の1杯を、もっと楽しく。」（29px・900）→「本人確認を通ったキャストと、料金を先に決めて飲み会へ。登録とメッセージは無料です。」
- 3つの約束（淡い灰色の角丸の行・ローズのアイコン）：「全員が本人確認済み・20歳以上」「料金は呼ぶ前に確定。延長は10分ごと」「条件を選ぶと、呼ぶ前に料金と確定の目安が出ます」。
- 「電話番号かメールで登録する」（主・大）→ G-02。「デモ：登録済みのゲスト（ケンタさん）で見る」（ghost・大）→ `G-0001` でホームへ。

### 7.2 G-02 会員登録
- 1画面に1つの質問。上の帯の題は「会員登録（n/6）」、その下に進み具合の細い棒。「戻る」で1つ前（最初の段ではようこそへ）。下に「次へ」（大）。「次へ」は未入力でも押せて、押したときに確かめる。
- エラーは画面の上に「入力を確かめてください」と文（押すと該当の欄へ）、欄の下にも同じ文。入れた値は消さない。
- 段ごと：

| 段 | 見出し | 内容と確かめること（エラーの文） |
|---|---|---|
| 1 連絡先 | 電話番号かメールアドレスを入れてください | 「電話番号／メール」の切り替え。補足「確認コードを送ります。ほかの人には表示しません」。電話は空白・ハイフン・括弧を除いて `0` から始まる10〜11桁（「電話番号は、0から始まる10桁か11桁の数字で入れてください（ハイフンはあってもなくても大丈夫です）」）。メールは「メールアドレスは「name@example.jp」の形で入れてください」 |
| 2 確認コード | 届いた6桁の確認コードを入れてください | 「デモ」の点線の囲み「本番ではSMS（メール）で届きます。デモの確認コードは **482915** です。」＋「コードを入れる」。数字6桁・`autocomplete="one-time-code"`。違えば「確認コードが違います。届いた6桁の数字を入れてください」 |
| 3 生年月日 | 生年月日を入れてください | 「20歳以上の方だけが使えます。生年月日はほかの人には表示しません。」年（4桁）・月・日の数字の欄。形が違えば「生年月日を、年（4桁）・月・日の数字で入れてください」。**20歳未満は「20歳未満の方は登録できません」で先へ進めない** |
| 4 ニックネーム | キャストに表示するニックネームを決めてください | 12文字まで。補足「本名でなくて大丈夫です。あとで変えられます」。空なら「ニックネームを入れてください（キャストに表示されます）」 |
| 5 本人確認書類 | 本人確認の書類を選んでください | 「顔写真つきの身分証で、20歳以上と本人であることを運営が確かめます。」運転免許証／マイナンバーカード／パスポート。選ぶと「デモ：見本の画像を使う」→ 見本の札「〇〇（見本）／氏名 ヨイノ タロウ」。画像が無いと「書類の写真を選んでください。…」。「あとで提出する（キャストを呼ぶ前までに）」で書類なしのまま確認へ。書類を選ぶまで「次へ」は出さない |
| 6 確認 | 内容を確かめて登録してください | 連絡先・生年月日（年齢つき）・ニックネーム・書類（無ければ「未入力（あとで提出）」）。各行に「変更」（その段へ戻る）。「登録すると、利用規約とプライバシーポリシーに同意したことになります（デモのため本文はありません）。」ボタン「この内容で登録する」 |

- 完了：描かれるチェック・「登録が終わりました」・「会員番号 G-xxxx」。「このあとのこと」：①書類ありなら「運営が〇〇を確認します（目安30分・20時〜翌2時は15分）」、なしなら「マイページの「本人確認」から書類を出してください」②確認が終わるとバッジが付き、キャストを呼べる ③それまでも今から会えるキャストを見られる。注記「登録の控えをSMS（メール）でお送りしました。お問い合わせはマイページの「ヘルプ」から。」（デモでは送らない。マイページにヘルプの項目は無い）。「キャストを見る」でホームへ。
- 登録すると新しいゲストができる（名前は「ニックネーム（登録したばかり）」・本人確認は書類ありなら「審査待ち」、なしなら「未提出」）。操作の記録に「会員登録（20歳以上を確認）」と「本人確認の書類を提出（〇〇）」。

### 7.3 G-03 さがす（ホーム）
上から：
1. ロゴと、右に丸い札「🌐 東京の全エリア ⌄」（選ぶと「〇〇 周辺」）→ 板「エリアを選ぶ」（全エリア＋8エリアの格子・待機中の人数）。
2. 丸い検索の帯（白・影）：ローズの虫めがね＋「**条件で呼ぶ**／エリア・人数・時間を選ぶと、料金が先に決まります」→ G-05。
3. 進行中の呼び出しの帯（探し中・確定・合流中で開始が6時間以内）：淡いローズ・打つ点・「キャストが決まりました」＋「今日 21:00・恵比寿・1人」→ G-06。
4. 得意なシーンの札（横スクロール）「すべて／会食・接待／二次会／ワイン／日本酒／英語OK／聞き上手」。選んだ札は黒地。
5. 「今から会えるキャスト」と「● 待機中 N人」。隠れた人がいれば「絞り込みで N人を隠しています　すべて解除」。
6. **2列の写真カード**：左上「0.8km・恵比寿」（黒の半透明の札）・右上に本人確認の青い丸のチェック・下に名前（17px・800）と年齢・「● 待機中・★4.9」・ひとことの吹き出し（2行まで）。→ G-04。0人なら「条件に合うキャストは、いま待機していません。」＋「条件で呼んで、近くのキャストに知らせる」。
7. 下の注記「本人確認済みのゲストだけがキャストを呼べます。」（まだなら「本人確認が終わると、キャストを呼べます。」）＋「登録・メッセージは無料、料金は会った時間の分だけです。」

並びは §10.6 の「待機中」の人だけ、選んだエリアの人を先に、あとは距離の近い順。

### 7.4 G-04 キャストの詳細
- 画面幅いっぱいの写真（`4 / 4.7`）に透明の上の帯。写真の下端に重なる白い札「今日のひとこと／「〇〇」」。
- 名前＋「28歳」・青い札「✓ 本人確認済み」。状態「● 待機中・恵比寿・0.8km」（ほか「今日は待機していません」「合流中」「今夜の予定が決まっています」で点は灰色）。
- 3つの数「★4.9／評価 N件」「N回／合流」「スタンダード／9,000P／時間」。「バッジ」（大きい札）・「得意なシーン」・「自己紹介」・「ゲストからの評価」（星・平均・件数・よく選ばれた良かった点4つ・「だれが・何と書いたかは出しません。よくなかった点は運営だけが読みます。」）・「このキャストを運営に通報する」。
- 下に固定：「11,000P〜／1時間・指名料こみ」と「ミオさんを指名して呼ぶ」。待機中でなければボタンは使えず「今日は待機していません」／「今夜は予定が決まっています」。

### 7.5 G-05 呼ぶ（条件で呼ぶ／指名して呼ぶ）
題「条件で呼ぶ」（指名なら「ミオさんを指名して呼ぶ」）。
1. **上の面**：夜の街の写真（地図の代わり）・中央に自分の印・待機中のキャストの顔5人（決まった位置）・札「● 恵比寿で待機中 N人・近くのエリアにも届きます」。
2. **条件の札**（押すと板で選ぶ。板の下に「選ぶと、プランごとの料金がすぐ変わります。」）：
   - エリア：8エリア（最初は恵比寿）。指名のときは代わりに相手の顔と「ミオさんを指名／恵比寿・0.8km・スタンダード」。
   - いつから：**夜（17時〜翌5時）**は「今すぐ／30分後／1時間後／2時間後」（今から選んだ分＋20分後を、5分単位に切り上げた時刻）。**昼**は「今夜19時／20時／21時／22時」（昼から飲む予定は作らない）。最初は「今すぐ」（昼は「今夜20時」）。
   - 時間：1時間／1時間30分／2時間／3時間（最初は2時間）。キャスト（条件のときだけ）：1〜4人（最初は1人）。
3. **プランを選ぶ**（指名なら「料金（先に決まります）」で区分のプランだけ）：「今日 21:00から2時間。この料金で確定し、あとから上がりません」。行＝そのプランで呼べる人の顔3つ・プラン名と人数の印・スタンダードに「おすすめ」（条件のときだけ）・「確定の目安 約N分」（指名なら「指名料 2,000P こみ」）・右に確定料金「18,000P」と「¥19,800（税込）」。選んだ行は黒の太枠（2.5px）と影、下に説明の文。
4. **下に固定**：「P ポイントで支払う／残高 7,000P・不足 11,000P はカードで購入」（押すとポイントを買う）・大きなボタン「スタンダードで呼ぶ（18,000P）」→ 確認の板。

**確認の板「この料金で呼びますか」**：
- 「あなたの側の人数」−／＋（1〜10人・最初は2人）。「お店の名前・場所」（任意・「決まっていなければ空のままで大丈夫です。確定後にメッセージで伝えられます」）。
- 内容：エリア（指名なら「ミオさん（恵比寿）」）・日時「11月18日(水) 21:00〜（2時間）」・人数「キャスト 1人・あなたの側 2人」・お店（空なら「未定（メッセージで決める）」）。
- 内訳：「スタンダード 9,000P×2時間×1人　18,000P」・指名料・**「確定料金（仮押さえ）18,000P」**・「延長は10分ごとに +1,500P」。
- 支払い：「ポイント残高 7,000P」。足りなければ「不足分をカードで購入 11,000P（¥12,100）」と**見本のカード**（§7.10）、足りていれば「確定後の残高」。
- 決まり3つ：「✓ キャストが決まる前のキャンセルは無料です」「⚠ 決まったあとのキャンセルは確定料金の50%、合流の時刻を過ぎたら100%がかかります」「ⓘ 終わったら、確定料金と延長の分だけを精算します」。
- 同意のチェック「料金とキャンセルの決まりを確かめました（同意して呼ぶ）」。
- ボタン：不足があれば「¥12,100を支払って呼ぶ」、なければ「この料金で呼ぶ」。
- 確かめること：本人確認が済んでいない →「本人確認が終わっていないため、まだ呼べません。マイページの「本人確認」から書類を提出してください」。同意なし →「料金とキャンセルの決まりを確かめて、「同意して呼ぶ」にチェックを入れてください」。
- 押すと：§12 の `createCall`（不足分の購入 → 確定料金の仮押さえ → 近くのキャストへお知らせ）。不足があればトースト「不足分 11,000P（¥12,100）をカードで購入しました（見本）」。G-06 へ。

### 7.6 G-06 呼び出しの進み
上の帯の題は状態の言葉（キャストを探しています／キャストが決まりました／合流中／終了しました／キャンセルしました）。戻るはホーム。

**探し中（見せ場①）**
- 円の面（幅 300px まで・淡いローズの段）に、中央の黒い丸（自分）・広がる輪3つ・お知らせを送ったキャストの顔（7人まで・円の周りの決まった位置）。
- 見出し「近くのキャストN人にお知らせしました」、文「受けたキャストが決まると、すぐにお知らせします。確定の目安は約N分です（0:12 経過）。」（指名なら「指名したキャストの返事を待っています」）。
- 小さな札：「スタンダード・1人・2時間　18,000P」「今日 21:00〜・恵比寿・確定料金を仮押さえしています」。
- 操作中のキャスト（ミオ）にも届いているとき、「デモ」の点線の囲み：「キャストのアプリに、いま呼び出しが届いています。受けると、この画面が「確定」に変わります。」＋黒いボタン「キャストのアプリで受ける」（キャストのアプリへ切り替える）＋「ほかのキャストが受けたことにする」。
- 操作中のキャストに届いていないとき（別のエリア・別の人の指名など）は、**7秒後に、お知らせを送ったほかのキャストが受けたことにする**（デモの動き）。
- 「キャンセルする（キャストが決まる前なので無料）」。

**確定**
- 受けたキャストのカード（写真・名前と年齢・「★4.9・合流49回」・バッジ3つまで。確定から15秒以内は手前に来る動き）・時間「今日 21:00」「2時間（23:00 まで）」・場所「お店・恵比寿・あなたの側 2人」。
- 「メッセージ」と「合流した」（→ 合流中・トースト「合流しました。楽しい時間を」）。「キャンセルする（9,000P かかります）」（その時点のキャンセル料）。

**合流中**
- 淡いローズの札にキャストの顔・「ミオさんと合流中・お店」。**丸い時計**（190px・ローズの輪が予定の時間に対して進む）に「経過」「1:05:32」「23:00 まで」。時間は**合流した時刻から**測り、終わりの予定に延長分を足す。
- 「いまの合計 21,000P」「確定料金 18,000P＋延長 20分 3,000P」（延長で数字が弾む）。「＋ 10分延長する（+1,500P）」（soft・大）・「メッセージ」・「終了して精算する」・「困ったことがあったら運営に通報する」。
- 精算の板「終了して精算しますか」：確定料金・延長 N回・合計・税込。「仮押さえした 18,000P に、延長の分を足して精算します。」「仮押さえ＋ポイント残高」。延長で足りなければ「延長の分が足りないので、カードで購入 3,000P（¥3,300）」と見本のカード、ボタン「¥3,300を支払って精算する」。足りれば「21,000P で精算する」。

**終了（精算・評価）**
- 描かれるチェック・「精算しました」・日時。内訳：確定料金・延長・「お支払い（ポイント）21,000P」・「税込 ¥23,100・残高 0P」。
- 「今日のキャストを評価する」（「評価はキャストの実績とバッジに反映されます。低い評価は運営も確認します。」）：キャストごとに顔・名前・星5つ・良かった点の札（RATING_TAGS_CAST・複数）。星2以下が1つでもあれば「よくなかった点」（任意・運営だけが読みます）。全員に星が無いと「星を押して、全員を評価してください」。送ると「評価を送りました」の行に変わる。
- 「領収書を発行する」（発行済みなら「領収書を見る」）→ G-07。

**キャンセル**
- 板「呼び出しのキャンセル」：決まりの文（§10.3）・確定料金・キャンセル料・戻るポイント。「◯◯P を払ってキャンセル」（無料なら「キャンセルする（料金なし）」）・「キャンセルしない」。理由は「ゲストの都合」。
- キャンセル後：「キャンセルしました」と「キャンセル料 9,000P をいただきました。」（無料なら「料金はかかっていません。仮押さえしたポイントは戻りました。」）＋「もう一度呼ぶ」。

### 7.7 G-07 領収書
- 宛名（最初は会社名、無ければ「氏名 様」。空なら「宛名を入力してください」）・但し書き（最初は「サービス利用料として」）・「この内容で発行する」（発行済みなら「発行し直す」）。注記「領収書は利用ごとに発行します（ポイントの購入では発行しないので、二重に計上されません）。」［ご提案］。
- 紙の見本：「領収書」「No. R-5001」（`R-`＋呼び出しの番号の数字）・宛名・**金額（税込）**・「但し サービス利用料として」・「10%対象 ¥21,000（消費税 ¥2,100）」・ご利用日・「ポイント 21,000P（1P＝1.1円・税込）」・発行日・「株式会社ヨイノ（架空）」「登録番号 T0000000000000（見本）」・丸い判子「YOINO」。
- 「PDFで保存（印刷の画面が開きます）」＝`window.print()`。戻るは利用履歴。

### 7.8 G-08 メッセージ（ゲスト・キャスト共通）
- 一覧：「メッセージ」「キャストが決まった相手とだけ、やりとりできます。」新しい順に、顔・名前と呼び出しの日時・最後の文（未読は太字）・相対時刻（たった今／N分前／N時間前／昨日／N日前）・未読の数。空なら「メッセージはまだありません。呼び出しが確定すると、ここに相手が出ます。」
- 会話：上の帯に相手の顔と名前、下に「🕐 今日 21:00・お店」。運営の文は中央の灰色、自分は右のローズの吹き出し、相手は左の灰色、下に時刻。開くと既読にして最下部へ。
- 定型文（押すとそのまま送る）：ゲスト＝会う前「お店の前に着いたら教えてください／少し遅れます／今日はよろしくお願いします」・終わったあと「今日はありがとうございました／また呼ばせてください」。キャスト＝会う前「いま向かっています／お店の前に着きました／少し遅れます」・終わったあと「今日はありがとうございました／またぜひ呼んでください」。
- 入力欄「メッセージを入力」（Enter で送る）と丸い送るボタン。**自動の返事は無い**（もう一方のアプリに切り替えて返す）。

### 7.9 通報の板（ゲスト・キャスト共通）
「〇〇さんの通報」「運営だけが読みます。相手には、だれが通報したかは伝わりません。」理由：キャストへ「遅刻／無断キャンセル／プロフィールと違う／アプリの外での連絡を求められた／その他」、ゲストへ「飲酒の強要／アプリの外での連絡を求められた／暴言・威圧／体に触れられた／その他」。「起きたこと」（任意）。理由が無いと「理由を1つ選んでください」。送るとトースト「通報を受け付けました。運営が確認します」。

### 7.10 見本のカード（決済の見本）
濃い色の角丸の札「🔒 カードで支払う（見本）」・「カード番号（テスト用の番号）4242 4242 4242 4242」・「有効期限 12 / 29」・「セキュリティコード 123」（読み取り専用で最初から入っている）。注記「デモのため、見本の値が入っています。実際には課金しません。本番は決済代行（Stripe など）の画面でカードを受け付け、カード番号はこのサービスに残しません。」

### 7.11 G-09〜G-12 マイページまわり（ゲスト）
- **マイページ**：顔・「ケンタさん」・バッジ（無ければ「会員ランク：レギュラー」）。**ポイントの札**（ローズ地・白文字）「ポイント残高」・白いボタン「ポイントを買う」・大きな数字（46px）「7,000 P」・「仮押さえ中 18,000P・1P＝1.1円（税込）」。**会員ランクの札**：いまのランク・次までの棒と「**シルバー**まで あと1回の利用、または 7,000P の利用」（いちばん上なら「いちばん上のランクです」）・「2回／利用」「23,000P／利用金額」「★（平均）／キャストからの評価」。メニュー「利用履歴・領収書／最近：11月12日(木) 恵比寿」「本人確認／確認済み（運転免許証）」。「ログアウト（会員登録の画面を見る）」。
- **ポイントを買う**：「いまの残高」・4つのパック（5,000P ¥5,500／10,000P ¥11,000／30,000P ¥33,000／50,000P ¥55,000・最初は10,000P）・見本のカード・「¥11,000 を支払って購入」（トースト「10,000P を購入しました（見本の決済）」）・注記「本番は決済代行（Stripe など）でカード・Apple Pay を受け付けます。」［ご提案］・「ポイントの出入り」直近8件。
- **利用履歴・領収書**：新しい順に、顔2つ（未定は「？」）・「11月12日(木) 恵比寿」・「ミオ・終了・精算済み」・金額と「領収書あり／領収書を発行」。終了は G-07、ほかは G-06 へ。
- **本人確認**：状態の札（確認済み「本人確認は終わっています」／審査待ち「運営が書類を確認しています」／差し戻し「撮り直しをお願いしています」＋理由／未提出「まだ提出していません」）。未提出・差し戻しなら「見本の画像で書類を提出する」→ 審査待ち。注記「本番は本人確認の専門サービス（eKYC）で、顔と書類の照合を自動で行い、運営は結果を見て承認します。」［ご提案］。

---

## 8. 画面ごとの仕様 — キャストのアプリ

### 8.1 C-01 呼び出し（ホーム）
1. 顔・あいさつ（5〜11時「おはようございます」・11〜17時「こんにちは」・ほか「こんばんは」）・「ミオさん」・薄いロゴ。
2. **待機のスイッチ**（横幅いっぱい・`role="switch"`）：ON は淡いローズの地にローズの縁・つまみが右へ動き緑、「待機中：今から呼ばれてOK／恵比寿の近くのゲストに、あなたが表示されています」（合流中・確定済みなら「合流中（23:00まで）」など＋「予定が終わるまで、ゲストの一覧には出ません」）。OFF は「待機していません／押すと、今から会えるキャストに表示されます」。
3. 「届いている呼び出し」：**呼び出しのカード**（ローズの縁）＝打つ点・「近くのゲストからの呼び出し」（指名なら「あなたへの指名」）・「6分前」／ゲストの顔・「ケンタさん」・本人確認済みと会員ランクの札（無ければ「レギュラー」）・「利用2回・キャストからの評価 ★（平均）」／いつ・時間・場所・人数／**「あなたの報酬の目安」¥10,800**（34px）「スタンダード・延長すると10分ごとに増えます」／「見送る」「受ける」。受けるとトースト「受けました。呼び出しが確定しました」で C-02 へ。無いときは「いまは届いていません。届くとここに出て、通知でもお知らせします。」（待機していなければ「待機を始めると、近くのゲストからの呼び出しが届きます。」）。
4. 「これからの予定」：確定・合流中を早い順に、時刻と「今日／明日／翌」・「ケンタさん・お店」・「確定・合流待ち・2時間・報酬の目安 ¥10,800」。無ければ「確定した予定はまだありません。」
5. 「今月の報酬 ¥xx」の帯（→ マイページ）。活動中でないキャストには「このキャストは「（状態）」のため、呼び出しは届きません。」

### 8.2 C-02 呼び出しの進み（キャスト）
- 確定・合流中：ゲストのカード（顔・「ケンタさん」・利用回数と評価・会員ランクと本人確認の札）・時間・場所（「ゲストの側 2人」）。合流中は「経過 1:05」「延長 N回・報酬の見込み ¥xx」。「メッセージ」・確定なら「合流した」。「終了と精算は、ゲストのアプリで行います。終わると、報酬がすぐ今月の分に入ります。」・通報。
- 終わった：「おつかれさまでした」「報酬 **¥12,600** が今月の分に入りました」。「ケンタさんを評価する」（「ゲストには見えません。低い評価が続くゲストは、運営が利用を止めます。」）星5つ・良かった点（RATING_TAGS_GUEST）。星が無いとトースト「星を押して評価してください」。「今月の報酬を見る」。
- キャンセル：「ゲストの都合でキャンセルになりました」「キャンセル料から ¥xx が報酬に入ります。」（無料なら「キャストが決まる前のキャンセルです。」）。

### 8.3 C-03 出勤できる日時
- 「出勤できる日時」「◎を押すと、その時間に呼び出しが届きます。ゲストの指名の画面にも出ます。」週の切り替え「＜ 今週」「11月18日(水)〜11月24日(火)」「次の週 ＞」（今日からの2週分）。
- **格子**（横スクロール）：列＝7日（日曜は赤・土曜は青）、行＝17:00〜翌1:00 の9行（`17〜25`）。マスは「◎」（ローズ・淡いローズの地）と「×」（薄い灰色）、押すと切り替わる。凡例「◎：出勤できる　×：出勤しない　この週 N時間（2週間で N時間）」。
- 下に固定：「保存済み」／「まだ保存していません」と「出勤できる日時を保存する」。

### 8.4 C-04 マイページ（キャスト）
1. 顔・名前・バッジ。
2. **報酬の札**：「11月の報酬」・大きな数字（42px）・**6か月の棒グラフ**（太い角丸の棒・選んだ月だけ濃いローズ・押すとその月）・「申請できる額」「振込の申請中」・「振込を申請する」・振込の履歴3件（「振込済み」か「運営が確認しています」）。
3. **振込の申請の板**：「申請する額（円）」（最初は申請できる額）・「¥5,000 から申請できます」・「振込の手数料 −¥250」・「振り込まれる額」・「振込先 ヨイノ銀行 恵比寿支店 普通 ****1037」（架空）。¥5,000 未満は「¥5,000 以上で申請してください」、多すぎると「申請できる額（¥xx）より多く申請できません」。申請するとトースト「振込を申請しました。運営が確認して、3営業日以内に振り込みます」。注記「本番は決済代行の送金（Stripe Connect など）か、銀行の振込データの書き出しで支払います。」［ご提案］。
4. **実績のバッジ**（合流10回・50回・100回・高評価・遅刻なし）：付いていれば「獲得済み・ゲストのアプリに出ています」、まだなら条件の文と「（いま 49回）」と進みの棒。
5. **ゲストからの評価**「★4.92（N件）」・良かった点・「だれが評価したか・よくなかった点の内容は出しません。…」。
6. **プロフィールの写真**：差し替え中なら「差し替えの写真を運営が確認しています（N時間前に提出）。承認まではいまの写真が出ます。」・「写真を差し替える」→ C-05。

### 8.5 C-05 写真を差し替える
「顔がはっきり写った、最近の写真を選んでください。運営が確認してから、プロフィールの写真が入れ替わります（目安1時間）。」枠「正面」（押すと見本の写真 `cast-XXb`）・「横顔（任意）」「全身（任意）」（飾り）。鍵の注記「運営が確認したあと、YOINO のゲストのアプリのプロフィールにだけ出します。ほかのサイトや広告には使いません。」正面が無いと「「正面」を押して、写真を選んでください」。提出すると審査待ちになり、**承認まではゲストに見える写真は変わらない**。

### 8.6 バッジが付いた（見せ場②・共通）
見ているアプリの人に「まだ見ていない付いたバッジ」があれば、暗い幕と白い札：メダル（112px の丸にバッジの印 64px）・12本の光の線・「NEW BADGE」・題（ランクは「シルバー会員になりました」、ほかは「「合流50回」のバッジが付きました」）・文（ランク「利用の回数か金額が条件に届きました。キャストのアプリにも、あなたのランクが表示されます。」／本人確認「運営が本人確認の書類を確かめました。相手のアプリにも表示されます。」／ほか「ゲストのアプリの、あなたのカードと詳しいプロフィールに表示されます。」）・「閉じる」で全部「見た」にする。

---

## 9. 画面ごとの仕様 — 運営の管理画面

### 9.0 共通の作法
- 一覧は表。行を押すと**右から出る詳細**（幅 600〜640px・管理画面の枠の中にだけ出る）。
- 状態のタブには件数。絞り込みで隠れている件数があれば「ⓘ 絞り込みで N件が非表示です　すべて解除」。
- 取り消せない操作（キャンセル・利用停止・差し戻し・振込済み・バッジの条件）は確認の窓を出し、理由が要るものは「理由」（必須・空なら「理由を入力してください」）。
- 運営の操作はすべて「運営（西村）」として操作の記録に残る。
- 状態の札（`Pill`）の色：探し中＝注意（橙）・確定＝ブランド・合流中＝お知らせ（青）・終了＝完了（緑）・キャンセル＝灰。

### 9.1 A-01 今夜の手配（ホーム）
- 題「今夜の手配」・「2026年11月18日（水）・いま動いている呼び出しと、対応が要るもの」・右に「● 自動で更新（デモでは操作のたび）」。
- **対応が要るもの6つ**（3列のカード・左に大きな数・押すとその一覧へ。0件は灰色で「対応が要るものはありません」）：

| 項目 | 補足の文 | 色 | 行き先 |
|---|---|---|---|
| キャスト探し中 | 5分以上たったものがあれば「N件が5分以上決まっていません」、無ければ「近くのキャストにお知らせ中」 | 5分以上があれば赤、無ければ橙 | 呼び出し（探し中） |
| 未対応の通報 | 内容を確かめて対応を記録 | 赤 | 通報・評価 |
| キャストの審査 | 新しく登録したキャスト | 橙 | キャスト（審査待ち） |
| 写真の承認 | 差し替えの写真 | 橙 | キャスト（写真の承認待ち） |
| ゲストの本人確認 | 書類の確認待ち | 橙 | ゲスト（本人確認） |
| 振込の申請 | キャストへの支払い | 青 | 決済・支払い |

- **いま動いている呼び出し N件**（探し中を古い順 → 合流中 → 確定を開始の早い順）：列「状態・開始」（探し中は「N分経過・N人に通知」、5分以上は赤）・「ゲスト」（顔・ニックネーム・ID・ランク）・「キャスト」（無ければ「未定」）・「エリア・お店」・「金額」・「次の操作」（探し中は主のボタン「手配する」、ほかは「詳細を見る」）。
- 3つの数：今日の売上（税抜）・今月の売上（税抜）（それぞれ運営の手数料）・「待機中のキャスト N人／活動中 N人のうち（合流中 N人・今夜確定済み N人）」。待機中の数はゲストの「待機中 N人」と同じ計算。
- 「直近14日の売上（税抜）」の棒グラフ（万円・「終了した呼び出しの合計＋キャンセル料」）。

### 9.2 A-02 呼び出し
- タブ：動いている／探し中（赤）／確定／合流中／終了／キャンセル／すべて。検索「ID・ゲスト・キャスト・お店で検索」・エリア。表：ID（指名／条件で呼ぶ）・状態・日時と長さ・ゲスト・キャスト・エリア・お店・金額（と「精算済み」「確定料金＋延長20分」など）。先頭60件まで（「N件（先頭の60件を表示）」）。
- **詳細**：
  - 探し中なら注意の囲み「キャスト探し中（N分経過）／N人にお知らせし、N人が見送りました。決まらないときは、運営が待機中のキャストを割り当てられます。」・「割り当てるキャスト」（待機中8人まで・プレミアムはプレミアムの人だけ・「ミオ（恵比寿・0.8km・★4.9）」の形）・「割り当てて確定する」→ 運営の手配として確定、トースト「キャストを割り当てました。ゲストに確定をお知らせしました」。
  - 属性：ゲスト・キャスト（押すとそれぞれの詳細）・日時（合流が予定とずれていれば「予定の開始 21:00・合流 21:03」）・人数・「N人に通知・見送り N人」。
  - 「料金と配分」：確定料金（プラン 単価×時間×人数＋指名料）・延長・キャンセル料・**売上（税抜・1P＝1円）**・キャストの報酬（60%・N人）・**運営の手数料**。「ゲストの支払いは税込 ¥xx。料金は呼んだ時点で確定し、料金表を変えてもこの呼び出しの金額は変わりません。」
  - 「経過」の縦の線：呼んだ（料金を確定・仮押さえ）→ キャストが受けて確定（または運営が手配して確定）→ 合流した → 終了して精算（またはキャンセル（ゲスト／運営））。時刻か「まだ」。
  - 評価（「ゲスト → ミオ：★5 時間どおり」・★2以下は赤）・発行済みの領収書。
  - 探し中・確定なら「運営の判断でキャンセルする」→ 窓「運営の判断でキャンセルします。ゲストにキャンセル料はかからず、仮押さえした N P は戻ります。元に戻せません。」＋理由（必須）。

### 9.3 A-03 キャスト
- 「審査・写真の承認・出勤・報酬・バッジ。キャストのアプリと同じデータです」。タブ：すべて／審査待ち（差し戻し中も含む）／写真の承認待ち／活動中／休止・停止。検索「名前・ID・ひとことで検索」・エリア。
- 表：キャスト（顔・名前（年齢）・ID）・エリアといまの状態・区分・バッジ（印だけ）・合流・評価（小数2桁）・今月の報酬・状態（写真の承認待ちなら橙の文）。
- **詳細**：
  - 審査待ち／差し戻し中：「登録の審査」に写真・提出した書類「運転免許証（見本）」・面接「オンライン面接 済み」・ひとこと・得意なシーン。「差し戻す」（理由必須・「本人のアプリに理由をお知らせします。直して出し直せます。」）・「承認する」→ 活動中＋本人確認済み、トースト「〇〇さんを承認しました。本人確認済みのバッジが付きました」。
  - 写真の差し替え：いまの写真 → 差し替えの写真を並べ、「差し戻す」（理由必須）・「承認して入れ替える」（トースト「写真を承認しました。ゲストのアプリの写真が入れ替わりました」）。
  - 3つの数：合流・評価・遅刻なしの連続（遅刻があれば「この期間の遅刻 N回」と橙）。
  - 「バッジ」と**特別なバッジのスイッチ**（運営のおすすめ・接待に強い）。ON でトースト「「〇〇」を付けました。ゲストのアプリにすぐ出ます」。
  - 「今月と過去5か月の報酬」の小さな棒・報酬の合計・振込済み・申請中・振込先・「出勤できる日時（7日間）」（「11/18（水）19:00〜翌1:00」か「—」）・最近の呼び出し5件。
  - 「利用を停止する」（窓「停止すると、呼び出しが届かなくなり、ゲストのアプリからも消えます。理由は操作の記録に残ります。」・待機も切る）／停止中は理由と「利用停止を解除する」。

### 9.4 A-04 ゲスト
- 「本人確認・利用・会員ランク・利用停止。キャストとは別の一覧・別の項目で管理します」。タブ：すべて／本人確認（審査待ち・差し戻し・未提出）／利用停止。検索「氏名・ニックネーム・ID・連絡先で検索」・ランク（レギュラー〜プラチナ）。
- 表：ゲスト（顔・氏名・ニックネーム・ID・年齢）・会員ランク・本人確認・利用・利用金額・キャストからの評価・最後の利用・状態（利用中／利用停止）。先頭60人まで。
- **詳細**：
  - 本人確認：未提出なら「まだ書類が出ていません。出るまでは、キャストを呼べません。」。出ていれば見本の札「運転免許証（見本の画像）／氏名 〇〇／生年月日から N歳（20歳以上）」・「差し戻す」（「撮り直しをお願いします。理由はゲストのアプリにお知らせします。」）・「承認する」（トースト「本人確認を承認しました。ゲストのアプリにバッジが付きました」）・注記「本番は eKYC（本人確認の専門サービス）の照合結果を見て承認します。」［ご提案］。
  - 3つの数：利用・利用金額・ポイント残高。属性：会員ランク・本人確認・連絡先・キャストからの評価・通報された回数。特別なバッジのスイッチ（法人の会食）。利用履歴6件。
  - 「利用を停止する」（「停止すると、キャストを呼べなくなります。残りのポイントの返金は別に手続きします。理由は操作の記録に残ります。」）／停止中は「利用停止を解除する」。

### 9.5 A-05 決済・支払い
- 今月の4つの数：ポイントの購入（税込・「N件のカード決済（見本）」）・売上（税抜・「利用したポイント＋キャンセル料」）・キャストの報酬（「売上の60%」）・運営の手数料（「売上 − 報酬（40%）」）。
- 囲み「お金の流れ（デモの決まり）」：「ゲストはポイントを税込の円で買い（1P＝1.1円）、使った分が売上（1P＝1円・税抜）になります。キャストの報酬は売上の60%、残りが運営の手数料です。本番のカード決済は決済代行（Stripe など）、キャストへの支払いは送金の仕組みか銀行の振込データで行います。」［ご提案］
- 「振込の申請 N件」：キャスト・申請日時・申請額・振込額（−¥250）・振込先・「振込済みにする」→ 窓「〇〇さんに ¥xx（申請 ¥xx・手数料 ¥250）を振り込んだことを記録します。キャストのアプリに「振込済み」と出ます。」。
- 「運営の手数料（月ごと）」6か月の棒グラフと「最近のポイントの購入」8件。

### 9.6 A-06 通報・評価
- タブ：未対応（赤）／対応済み。左に一覧（理由・通報された人・相対時刻・ゲストから／キャストから）、右に選んだ通報：通報した人・通報された人（押すと詳細）・「同じ人への通報 N件（この件を含む）」・呼び出し・内容の引用。
- 未対応なら対応のラジオ「問題なし／注意を送る／利用停止」と「確かめたことと対応の記録」（必須）・「対応を記録する」。足りなければ「対応を1つ選んでください」「確かめたことと対応の記録を入力してください」。**「利用停止」を選ぶと相手をその場で利用停止**（理由「通報（〇〇）の確認により利用停止」）。対応済みは記録の日時と文。
- 下に「低い評価（★2以下）」の新しい8件（「評価は相手には見えません。続く人は利用停止を検討します」）。

### 9.7 A-07 バッジの設定
- 「条件を満たすと、その場で付きます。ゲストとキャストのカード・詳しいプロフィールに出ます」。2列「ゲストのバッジ（本人確認・会員ランク）」「キャストのバッジ（本人確認・実績）」。1枚ずつ：札・種類・持っている人数・説明。
- 条件のあるもの：「利用回数 [3] 回以上　または　利用金額 [30000] P以上」の数字の欄と「条件を保存する」（変えていれば主のボタン）。無いものは「本人確認の書類を運営が確かめたとき」「運営が付ける」。
- 保存 → 窓：新しい条件の文・**「N人 新しく付く」「N人 外れる」**（いまのデータで先に数える）・「保存すると全員を付け直し、新しく付いた人のアプリには「バッジが付きました」と出ます。」・「保存して付け直す」。0以下は「条件は0より大きい数字で入れてください」。

### 9.8 A-08 操作の記録
「だれが・いつ・何を・どう変えたか。画面からは直せず、消せません」。検索「人・対象・操作で検索」。新しい順80件：日時・だれが・対象・操作（理由）・変更（「活動中 → 利用停止」）。

---

## 10. お金とバッジの計算（`src/lib.ts`・**ここ以外で計算しない**）

### 10.1 料金
```ts
TAX = 0.1;  yenOf = (points) => Math.round(points * 1.1)   // 1P＝1円（税抜）＝1.1円（税込）
EXT_MIN = 10                // 延長の単位（分）
NOMINATION_FEE = 2000       // 指名料（1人・1回）
CAST_SHARE = 0.6            // キャストの報酬＝売上の60%。残り40%が運営の手数料
PAYOUT_FEE = 250; PAYOUT_MIN = 5000   // 振込の手数料（円）と申請できる最低額
PLANS = {
  casual:   { name:'カジュアル',   ratePerHour: 6000,  desc:'立ち飲み・二次会・カラオケに。気軽な1杯から', scene:'二次会・立ち飲み' },
  standard: { name:'スタンダード', ratePerHour: 9000,  desc:'会食・飲み会に。ふだんの飲み会の標準のプラン', scene:'飲み会・会食' },
  premium:  { name:'プレミアム',   ratePerHour: 15000, desc:'接待・大切な会食に。審査で上位のキャストだけ', scene:'接待・会食' },
}
planOfCast(c) = c.class === 'premium' ? 'premium' : 'standard'   // 指名したときのプラン

quote(plan, minutes, people, nominate) {
  nominationFee = nominate ? 2000 * people : 0
  q = Math.round(ratePerHour * minutes / 60) * people + nominationFee
  return { plan, ratePerHour, minutes, people, nominationFee, quote: q, extUnits: 0, extPoints: 0, total: q }
}
extUnitPoints(p) = Math.round(p.ratePerHour * 10 / 60) * p.people       // 延長1回（全員分）
withExtension(p, units) = { ...p, extUnits: units, extPoints: extUnitPoints(p) * units, total: p.quote + extPoints }
PACKS = [5000, 10000, 30000, 50000] → { points, yen: yenOf(points) }
shortfall(need, have) = need <= have ? 0 : Math.ceil((need - have) / 1000) * 1000   // 足りない分を1,000P単位で切り上げ
```
**送った料金は、そのときの値を呼び出しに控える**（料金表を変えても、送った呼び出しの金額は変わらない）。

例（2時間・1人）：カジュアル 12,000P（¥13,200）／スタンダード 18,000P（¥19,800）／プレミアム 30,000P（¥33,000）。延長1回はそれぞれ 1,000P／1,500P／2,500P。2人にすると料金は2倍。

### 10.2 確定の目安
```ts
etaMin(s, plan, area) {
  n = 待機中のキャストのうち、そのエリアの人（プレミアムはプレミアムの人だけ）の数
  return Math.max(8, 26 - n * 3 + (plan === 'premium' ? 6 : 0))   // 分
}
```
プランを選ぶ画面と探し中の画面で同じ値を使う（呼んだときに `etaMin` を呼び出しに控える）。指名のときは出さない。

### 10.3 キャンセル料
```ts
cancelFeeOf(call, now) {
  探し中             → { fee: 0,                      rule: 'キャストが決まる前なので、キャンセル料はかかりません' }
  開始の時刻を過ぎた → { fee: quote,                  rule: '合流の時刻を過ぎているため、確定料金の100%がかかります' }
  それ以外（確定）   → { fee: Math.round(quote * .5), rule: 'キャストが決まったあとなので、確定料金の50%がかかります' }
}
```
運営の判断でのキャンセルは、いつでも 0。

### 10.4 報酬・売上・領収書
```ts
castRewardOf(c) {           // キャスト1人分（円）
  base = 終了 ? c.price.total : キャンセルでキャンセル料あり・キャストあり ? c.cancelFee : 0
  return base ? Math.floor(base / c.castIds.length * 0.6) : 0
}
revenueOf(c) { sales = 終了 ? total : キャンセル ? (cancelFee ?? 0) : 0;  reward = castRewardOf(c) * 人数;  fee = sales - reward }
receiptOf(c) { points = 終了 ? total : (cancelFee ?? 0);  total = yenOf(points);  sub = points;  tax = total - sub }
rewardEstimate(c) = Math.floor(c.price.quote / c.price.people * 0.6)    // 届いた呼び出しの「報酬の目安」
合流中の「報酬の見込み」 = Math.floor(c.price.total / c.price.people * 0.6)
castMonthly(s, castId, n=6)  // 直近 n か月の月ごとの報酬（終わった時刻の月。今月が最後）
castWallet(s, castId) = { earned: 報酬の合計, paid: 振込済み, requested: 申請中, available: earned - paid - requested }
```
例：スタンダード2時間1人＝報酬の目安 ¥10,800。延長2回で合計21,000P なら報酬 ¥12,600、運営の手数料 ¥8,400。

### 10.5 残高・仮押さえ・いまの金額
```ts
balanceOf(s, guestId) = そのゲストのポイントの出入り（ledger）の合計
heldOf(s, guestId)    = 探し中・確定・合流中の呼び出しの確定料金の合計（仮押さえ中）
amountOf(c)：終了＝total「精算済み」／合流中＝total「確定料金」か「確定料金＋延長N分」／キャンセル＝cancelFee「キャンセル料」／ほか＝quote「確定料金」
callWindow(c)：start＝合流した時刻（まだなら予定の開始）、end＝start＋（時間＋延長×10分）
```
ゲストの画面・キャストの画面・運営の画面の金額は、すべてこれらから出す（同じ呼び出しの金額が画面ごとにずれないように）。

### 10.6 キャストのいまの状態
```ts
castNow(s, k)：活動中でない → 'inactive'（—）
  合流中の呼び出しがある → 'meeting'「合流中（23:00まで）」
  今夜（翌朝5時まで）に確定した呼び出しがある → 'booked'「確定済み（21:00〜）」
  待機のスイッチが ON → 'standby'「待機中」／OFF → 'away'「待機していない」
nearbyCasts(s, area?) = castNow が 'standby' の人を、area の人を先に・距離の近い順
```
「今夜」は朝5時より前なら前の日の夜の続き。夜の営業の時間帯＝17時〜翌5時（`isEvening`）。日時の表示（`whenLabel`）は「今日 21:00」「明日 20:30」「昨日」、夜中（翌5時まで）は「翌 0:30」、それより先は「11月20日(金) 21:00」。

### 10.7 バッジ
- 実績の数：ゲスト＝利用回数・利用金額（終了した呼び出しから）・キャストからの評価。キャスト＝合流回数（初期の回数＋終了した数）・評価の平均と件数・遅刻なしで続けた回数（古い順に数え、遅刻で0に戻す）。
- 条件 `{ metric, gte, metric2?, gte2?, join: 'or'|'and' }`。文にすると「利用回数が3回以上、または利用金額が30,000P以上」（`ruleText`）。
- 付くバッジ＝本人確認＋運営が付けたもの＋条件を満たした会員ランク・実績。**データを変えるたびに全員を付け直し**、新しく付いたものを award に残す（初期データでは残さない）。
- カードでは同じ group（会員ランク・合流の回数）は一番上だけ。会員ランクが無ければ「レギュラー」。次のランクの進み＝回数と金額の進みの大きい方（最大1）。

| id | 対象 | 種類 | 名前 | 説明 | 色 | 条件 |
|---|---|---|---|---|---|---|
| g-verified | ゲスト | 本人確認 | 本人確認済み | 顔写真つきの身分証を運営が確かめました | blue | 本人確認が確認済み |
| g-silver | ゲスト | 会員ランク | シルバー | 会員ランク。キャストのアプリにも出ます | silver | 利用3回 または 30,000P |
| g-gold | ゲスト | 会員ランク | ゴールド | 会員ランク。指名の優先と延長の確認なし | gold | 利用10回 または 150,000P |
| g-platinum | ゲスト | 会員ランク | プラチナ | 会員ランク。専任の窓口がつきます | platinum | 利用30回 または 500,000P |
| g-vip | ゲスト | 運営が付ける | 法人の会食 | 運営が確認した法人の会食のご利用 | ink | — |
| c-verified | キャスト | 本人確認 | 本人確認済み | 公的な身分証と面接で運営が確かめました | blue | 審査で承認 |
| c-meets10 | キャスト | 実績 | 合流10回 | 合流した回数の実績 | rose | 合流10回 |
| c-meets50 | キャスト | 実績 | 合流50回 | 合流した回数の実績 | rose | 合流50回 |
| c-meets100 | キャスト | 実績 | 合流100回 | 合流した回数の実績 | gold | 合流100回 |
| c-toprated | キャスト | 実績 | 高評価 | ゲストからの評価が高いキャスト | amber | 平均4.8以上 かつ 20件以上 |
| c-ontime | キャスト | 実績 | 遅刻なし | 遅刻せずに続けて合流した実績 | green | 遅刻なし20回連続 |
| c-recommend | キャスト | 運営が付ける | 運営のおすすめ | 運営が面談で選んだキャスト | ink | — |
| c-host | キャスト | 運営が付ける | 接待に強い | 接待・会食の評価が特に高いキャスト | ink | — |

（会員ランクの説明にある「指名の優先」「専任の窓口」などは、説明の文だけで、デモでは動きを作っていない）

バッジの印（SVG）の形は種類で変える：本人確認＝ぎざぎざの丸にチェック・会員ランク＝星・実績＝トロフィー・運営が付ける＝丸に星。

### 10.8 評価のまとめ（相手に出すもの）
ゲストからキャストへの評価は、**だれが・何と書いたかは出さない**。出すのは平均と件数と、よく選ばれた良かった点（多い順に4つ）だけ。星2以下のコメントは運営だけが見る。キャストからゲストへの評価はゲストには見えない。

---

## 11. データ（`src/types.ts`）

```ts
type Area = '渋谷'|'恵比寿'|'六本木'|'銀座'|'新宿'|'池袋'|'品川'|'新橋'
type PlanId = 'casual'|'standard'|'premium'
interface Rating { stars: number; tags: string[]; comment?: string; at: string }
interface Cast {
  id; name; age; area: Area; photo /* 'cast-01' */; comment /* 今日のひとこと */; intro /* 自己紹介 */; scenes: string[]
  class: 'standard'|'premium'
  status: 'active'|'screening'|'returned'|'resting'|'suspended'   // 活動中／審査待ち／差し戻し中／休止中／利用停止
  statusNote?; online: boolean /* 待機のスイッチ */; distanceKm; joinedAt; verified: boolean
  meetsBase; ratingBase: { sum; count }; onTimeBase    // デモの期間より前の実績
  specialBadges: string[]; badges: string[]            // 運営が付けたもの／いま付いているもの
  pendingPhoto?: { src; at } | null                    // 差し替えの写真（審査待ち）
  shifts: { day: 'YYYY-MM-DD'; hours: number[] /* 17〜25 */ }[]
  bank; lastActiveAt
}
interface Guest {
  id; name; nick; age; photo?; contact: { kind: 'tel'|'mail'; value }; birth?
  verify: 'none'|'pending'|'verified'|'returned'; verifyDoc?; verifyNote?
  joinedAt; status: 'active'|'suspended'; statusNote?
  usesBase; spendBase; ratingBase; specialBadges; badges; company?
}
interface Price { plan; ratePerHour; minutes; people; nominationFee; quote; extUnits; extPoints; total }
interface Call {
  id /* 'Y-3001' */; guestId; kind: 'request'|'nominate'; area; place; startAt; createdAt; guestCount
  status: 'searching'|'confirmed'|'meeting'|'done'|'canceled'
  castIds: string[]; offered: string[] /* お知らせを送った順 */; declined: string[]; price: Price
  confirmedAt?; metAt?; endedAt?; canceledAt?; cancelBy?: 'guest'|'ops'; cancelFee?; cancelReason?
  assignedBy?: 'cast'|'ops'; ratingsByGuest: Record<castId, Rating>; ratingsByCast: Record<castId, Rating>
  late: string[]; receipt?: { no; to; note; issuedAt }; etaMin?
}
interface Ledger { id; guestId; at; kind: 'purchase'|'hold'|'release'|'use'|'cancelFee'; points /* 増えれば正・減れば負 */; yen?; callId?; note }
interface Msg { from: 'guest'|'cast'|'system'; text; at }
interface Thread { id; callId; guestId; castId; msgs: Msg[]; readGuest: number; readCast: number /* 読んだ件数 */ }
interface Report { id; at; from: Party; target: Party; callId?; reason; detail; status: 'open'|'done'; action?: '問題なし'|'注意を送る'|'利用停止'; note?; doneAt? }
interface Payout { id; castId; amount; fee; at; status: 'requested'|'paid'; paidAt? }
interface BadgeDef { id; target: 'guest'|'cast'; kind: 'verified'|'rank'|'achievement'|'special'; group?; name; desc; tone; rule?; order }
interface Award { id; at; who: Party; badgeId; seen: boolean }
interface AuditEntry { id /* 'AL-00001' */; at; actor; target; action; before?; after?; reason?; result: '成功'|'進行停止'|'受付' }
interface Notice { id; at; channel: 'プッシュ通知'|'メール'|'SMS'|'画面'; to; title; body; partyId?; read? }
interface DemoState { seq; seededOn; casts; guests; calls; ledger; threads; reports; payouts; badgeDefs; awards; audit; notices }
```
状態の表示名：呼び出し＝キャスト探し中（ゲストには「キャストを探しています」）・確定・合流待ち（「キャストが決まりました」）・合流中・終了・精算済み（「終了しました」）・キャンセル（「キャンセルしました」）。キャスト＝活動中・審査待ち・差し戻し中・休止中・利用停止。本人確認＝未提出・審査待ち・確認済み・差し戻し。

選べる言葉：
```
SCENE_TAGS（得意なシーン）= 会食・接待 / 二次会 / カラオケ / ワイン / 日本酒 / 焼肉 / 立ち飲み / 英語OK / 聞き上手 / 盛り上げ役 / ゴルフの話 / 野球の話 / お酒は少なめ / 大人数OK
RATING_TAGS_CAST（ゲスト→キャスト）= 時間どおり / 話しやすい / 場が盛り上がった / 気づかいがうれしい / また呼びたい
RATING_TAGS_GUEST（キャスト→ゲスト）= マナーがよい / 時間どおり / 楽しい席だった / また会いたい
```

### 11.1 初期データ（`src/seed.ts`・すべて架空）
- **日付は「開いた日」基準**で作り、**未来の時刻の履歴は作らない**。乱数は決まった並び（`rng(1116)`・下の関数）を使い、毎回同じデータにする。
```ts
function rng(seed) { let a = seed >>> 0; return () => { a = (a + 0x6d2b79f5) >>> 0; let t = a;
  t = Math.imul(t ^ (t >>> 15), t | 1); t ^= t + Math.imul(t ^ (t >>> 7), t | 61); return ((t ^ (t >>> 14)) >>> 0) / 4294967296 } }
```

**キャスト40人（`K-0001`〜`K-0040`）**
```
NAMES = ミオ アヤカ リナ ユイ サキ ハルカ ナナミ エリ カナ マイ ユウカ レイナ アオイ チヒロ ミサキ ノゾミ サヤ ヒナ リコ モエ
        アカリ ユキ マリエ シオリ ナツキ カオリ ミズキ アユミ ルミ トモカ メイ ユリ サナ ホノカ アンナ ミク レナ イズミ ヒカル スズ
AGES  = 28 31 27 33 29 30 26 34 28 32 27 30 29 31 26 33 28 30 27 32 29 31 26 34 28 30 27 33 29 31 26 32 28 30 27 33 29 31 26 34
AREAS = 恵比寿 渋谷 新橋 銀座 六本木 恵比寿 渋谷 銀座 六本木 新宿 池袋 六本木 新橋 銀座 渋谷 銀座 新宿 恵比寿 品川 新橋
        六本木 恵比寿 渋谷 銀座 六本木 新橋 新宿 品川 恵比寿 渋谷 池袋 銀座 恵比寿 六本木 新宿 品川 新橋 渋谷 池袋 銀座
```
今日のひとこと（`COMMENTS`・上から K-0001 の順。40人すべて違う文）：
```
恵比寿にいます。21時から空いてます。ワインの話をしましょう／渋谷で仕事が終わりました。二次会からでも大丈夫です／新橋の焼き鳥が好き。気軽な1杯からどうぞ／
銀座で会食の後半からご一緒できます／六本木なら30分で行けます。英語の席も大丈夫です／今夜は恵比寿で日本酒の気分です／カラオケの二次会、盛り上げます／
銀座のバーで静かに飲むのも好きです／六本木で20時から。初めての方も歓迎です／新宿で仕事帰り。ビールで乾杯しましょう／池袋の立ち飲みならすぐ行けます／
六本木のラウンジ近くにいます。接待の席も慣れています／新橋の居酒屋で、会社の飲み会の盛り上げ役に／銀座で21時以降なら空いています／
渋谷で友だちの集まりの二次会からでも／銀座・有楽町あたりで会食のお手伝いができます／新宿三丁目にいます。日本酒が好きです／恵比寿で焼肉の気分です／
品川の駅の近くにいます。出張のあとの1杯にどうぞ／新橋で22時まで空いています／六本木でワインを1杯からどうぞ／恵比寿で聞き上手と言われます／
渋谷で大人数の飲み会も大丈夫です／銀座で落ち着いた会食の席が得意です／六本木のジャズバーの近くにいます／新橋で野球の話ならおまかせください／
新宿で20時から。お酒は少なめでも楽しめます／品川のホテルのラウンジ近くにいます／恵比寿のビストロでゆっくり飲みたい気分です／渋谷で21時から空いてます／
池袋で焼き鳥とハイボールの気分／銀座で接待の二次会までご一緒します／恵比寿で今夜は空いています。初めてでも話しやすいと言われます／
六本木でゴルフの話をしながら飲みましょう／新宿で今夜は早めの時間から／品川・高輪あたりで会食のお席に／新橋で立ち飲みから一緒に／
渋谷で英語の席も大丈夫です／池袋で初めての方も歓迎です／銀座で大切な会食のお席に
```
- 自己紹介＝「{趣味}が好きです。{エリア}を中心に、{得意なシーンの1つ目}の席によく呼ばれます。{人柄}。」趣味12通り（ワインの勉強・日本酒の酒蔵めぐり・ゴルフ・プロ野球の観戦・映画・旅行・カフェめぐり・料理・ヨガ・サウナ・読書・ドライブ）、人柄10通り（初めての方とも自然に話せます・聞き役も盛り上げ役もできます・時間どおりに伺うのが自慢です など）。
- 得意なシーン＝SCENE_TAGS の [i%14]・[(i*3+5)%14]・[(i*7+2)%14]（重なりは除く）。
- 状態：38〜40番＝審査待ち（登録1〜3日前・合流0回・本人確認まだ）・36番＝休止中（「本人の希望で12月まで休止」）・35番＝利用停止（「無断キャンセルの通報（対応済み）により利用停止」）・ほか活動中。
- プレミアム：4・8・12・14・16・24・28・32番。運営のおすすめ：1・12番。接待に強い：プレミアムのうち8の倍数（8・16・24・32番）。
- 待機（online）：活動中の人の約62%（1番のミオは必ず待機中）。距離 0.4〜6.0km（ミオは 0.8km。写真の雰囲気が近い人が並ばないよう 4番0.6・12番1.1・20番2.9・21番3.6・30番5.9・32番6.2 に固定）。
- 出勤：活動中の人は今日から14日のうち約55%の日に、18〜20時から3〜6時間（翌1時まで）。ミオは14日すべて。
- 合流回数の初期値 8〜119（ミオは「履歴の分と足して49」にそろえる）。評価の件数は合流の70〜90%、平均 4.30〜4.95（ミオは 4.92）。遅刻なしの連続は合流の回数を超えない（19番は0）。
- 振込先＝「ヨイノ銀行 {エリア}支店 普通 ****{(1000+番号×37) の下4桁}」（架空）。
- 写真の差し替え（審査待ち）：12番（レイナ）＝`cast-12b`（95分前）・21番（アカリ）＝`cast-21b`（260分前）。

**ゲスト120人（`G-0001`〜`G-0120`）**
- 氏名＝姓 SURN[i%24]＋名 GIVEN[(i+⌊i/24⌋×5)%30]、ニックネーム＝名のカタカナ。
```
SURN  = 早瀬 高村 桐生 日向 藤咲 真壁 白石 浅倉 柏木 久遠 如月 朝比奈 青柳 黒川 芹沢 宮園 柚木 千早 御影 水城 橘 葛西 氷室 神楽
GIVEN = 健太ケンタ 大輔ダイスケ 拓也タクヤ 翔ショウ 直樹ナオキ 亮リョウ 悠斗ユウト 誠マコト 和也カズヤ 健一ケンイチ 剛ツヨシ 隆之タカユキ 航ワタル 慎吾シンゴ 陽介ヨウスケ
        俊介シュンスケ 雅人マサト 裕太ユウタ 浩二コウジ 達也タツヤ 康平コウヘイ 駿シュン 竜也タツヤ 賢治ケンジ 修オサム 光太郎コウタロウ 圭ケイ 博之ヒロユキ 匠タクミ 大和ヤマト
COMPANIES = 株式会社ハヤテ企画 / 株式会社ミナモ商事 / 合同会社ツバサ設計 / 株式会社カエデ物産 / 株式会社シラサギ広告   （すべて架空）
```
- 年齢 27〜56（1番は34）。写真は1〜6番だけ（`guest-01`〜`06`）、ほかは頭文字の丸。
- 連絡先：3の倍数はメール `guest{n}@example.jp`、ほかは電話 `090-0000-{(1000+n×13)の下4桁}`。
- 本人確認：118・119番＝審査待ち・120番＝未提出・117番＝差し戻し（「書類の文字が読み取れないため、撮り直しをお願いしました」）・ほか確認済み（運転免許証）。117〜120番は登録2〜3日前、1番は30日前。
- 利用停止：110番（「通報（暴言）の確認により利用停止」）・115番（「利用規約に反する勧誘のため利用停止」）。
- 法人の会食のバッジ：3・7番。会社：1番＝株式会社ハヤテ企画、9の倍数＝COMPANIES[(n/9)%5]。
- **利用回数・利用金額・評価は、初期値を0にして呼び出しの履歴だけから数える**（料金表で出ない額を作らない）。

**呼び出しの履歴200件（すべて過去）＋今夜の呼び出し**
- 固定：ケンタ（G-0001）の2件＝18日前 20:30 恵比寿 スタンダード 90分 1人 延長1回（K-0006）／6日前 21:00 恵比寿 カジュアル 60分 1人 延長2回（ミオ）。→ 合計 15,000P＋8,000P＝23,000P、利用2回。
- ミオの12件：恵比寿・19〜21時・カジュアルかスタンダード・偶数番目は指名。
- 残りを176日に均して散らす：開始18〜22時・プランはカジュアル1：スタンダード3：プレミアム1・時間60〜240分・約68%が1人（ほか2〜3人・同じエリアの人）・延長は約35%が0回、ほか1〜12回・約8%が無料キャンセル（「人数が変わったため」）・約6%が確定後のキャンセル（50%・「会食の予定が変わったため」）・約30%が指名（1人のときだけ）。
- 終了したもの：約4%は15分遅刻。運営の手配は約6%。ゲストからの評価は約86%（遅刻は★2〜3・ほか★5が中心。★4以上は良かった点を1つ、★2以下はコメント「連絡なしで遅れてきた」「会話が少なかった」）。キャストからの評価は約70%（約6%が★2「飲み方が強引だった」）。約35%に領収書。
- お店（エリアごとに3つ・すべて架空）：
```
渋谷：ダイニング「灯」／バル・ソラリス／炭火やきとり こまち
恵比寿：ワインバー「ルーチェ」／ビストロ・ポム／日本酒バー「澪」
六本木：ラウンジ「ノクターン」／ジャズバー「ブルーノート坂」／グリル・アルバ
銀座：バー「白樺」／割烹 すずなり／レストラン「月白」
新宿：大衆酒場 ひなた／日本酒の店 しずく／クラフトビール ホップス
池袋：立ち飲み まるいち／焼き鳥 とりよし／ダイニング「彩」
品川：ホテルラウンジ「汐」／鉄板焼 たかなわ／バル・ミナト
新橋：居酒屋 ちょうちん横丁／やきとん 新八／立ち飲み バンブー
```
- **今夜の予定（開いた時刻に関係なく夜の時間帯に置く）**：G-0008 19:30 銀座 プレミアム 120分（K-0004）／G-0005 20:00 渋谷 スタンダード 120分（K-0007）／G-0022 20:30 新橋 スタンダード 90分（K-0003・K-0020）／G-0041 23:00 池袋 カジュアル 120分（K-0011）／G-0019 翌0:30 新宿 スタンダード 90分（K-0017）。開いた時刻にもう終わっている分は終了の履歴に、いま時間の中なら合流中、まだ前なら確定にする。
- 探し中2件（深夜は作らない）：G-0014 六本木 スタンダード 120分 2人（6分前に作成）／G-0031 新宿 カジュアル 90分 1人（3分前）。夜なら35分後・50分後、昼なら今夜21:00・21:30 の開始。お知らせ＝そのエリアの待機中の4人まで、うち1人は見送り。
- ミオの次の予定：G-0003（法人の会食のバッジ）・**翌日の20:30**・恵比寿・スタンダード120分・確定。メッセージに未読1件。
- 番号は `Y-3001` から順に。並びは作成の新しい順。

**ポイントの出入り**：呼び出しを古い順にたどり、足りなくなる直前（作成の12分前）に、足りる一番小さいパックを購入（ケンタは30,000P）。終了＝利用（精算）、確定後のキャンセル＝キャンセル料、動いている呼び出し＝仮押さえ。2〜40番の約40%は、1〜20日前に余分のパックを1つ購入。→ ケンタの残高は **7,000P**。

**メッセージ**：確定・合流中と、14日以内に終わった呼び出しに1つずつ。運営の文 → キャスト「{ニックネーム}さん、はじめまして。{名前}です。{お店}ですね、{時刻}に伺います。」→ ゲスト「よろしくお願いします。N人で飲んでいます。」など3通り → キャスト「お店の前に着いたら連絡しますね。」など3通り。終わったものには終了の6分後にゲストのお礼（「今日はありがとうございました。楽しかったです。」など3通り）、半分には14分後にキャスト「こちらこそありがとうございました。またぜひ。」。未来の時刻の文は入れない。

**通報5件**：
| id | 通報した人 → された人 | 理由 | 内容 | 状態 |
|---|---|---|---|---|
| RP-0006 | 遅刻があった直近の呼び出しのゲスト → そのキャスト | 遅刻 | 約束の時刻から15分遅れて、連絡もありませんでした。 | 未対応 |
| RP-0005 | K-0007 → G-0044 | アプリの外での連絡を求められた | 合流のあと、個人の連絡先を何度も聞かれました。 | 未対応（9時間前） |
| RP-0004 | K-0013 → G-0068 | 飲酒の強要 | お酒は少なめにしたいと伝えたのに、何度も一気に飲むように言われました。 | 未対応（昨日 23:40） |
| RP-0003 | G-0015 → K-0035 | 無断キャンセル | 確定したあと、連絡なく来ませんでした。 | 対応済み・利用停止「同じ内容の通報が3件目。本人に確認のうえ利用停止。」 |
| RP-0002 | K-0022 → G-0110 | 暴言 | 席で大きな声で怒鳴られました。 | 対応済み・利用停止「同席のキャスト2人にも確認。利用停止とし、残りのポイントは返金の手続き。」 |

**振込**：先月までの報酬の85%（1,000円単位・¥5,000以上）を振込済みに。K-0004・K-0010・K-0016 は残りの90%を申請中に。
**操作の記録**：G-0110・K-0035 の利用停止・登録と書類の受付（システム）・G-0117 の差し戻し・K-0021／K-0012 の写真の申請。**その人の登録より前の記録は作らない**。
**お知らせ**：ケンタさんへ1件（昨日・既読）「今週の金曜は、早めの時間が呼びやすいです」。
最後に全員のバッジを、付いた瞬間を記録せずに付ける。

### 11.2 画像（`public/img/`・WebP）
| ファイル | 枚数 | 使う所 |
|---|---|---|
| `cast-01`〜`cast-40` | 40 | キャストの写真（縦長） |
| `cast-01b`〜`cast-40b` | 40 | 写真の差し替えの見本（同じ写真の別の切り抜き） |
| `guest-01`〜`guest-06` | 6 | ゲストの顔（G-0001〜0006） |
| `place-toast` | 1 | ようこそ画面（乾杯） |
| `place-street` | 1 | 呼ぶ画面の上の面（夜の街） |
| `place-bar` `place-izakaya` `place-lounge` `place-private` | 4 | お店の雰囲気の素材（デモの画面ではまだ使っていない。無くてよい） |

写真は画像生成で作る。決まり：**架空の日本人の大人（20代後半〜30代）・実在の人に似せない・自然な私服か仕事帰りの服・露出の多い服や性的な表現は禁止・文字やロゴを入れない**。キャストの40人は同じ光と色の調子でそろえる（顔ははっきり写してよい）。写真が無くても頭文字の丸で画面は成り立つ。

---

## 12. 状態の持ち方と操作（`src/store.tsx`・`src/actions.ts`）

### 12.1 保存
- 状態はまるごと localStorage の `yoino-1116-state-v1` に、変わるたびに保存する。保存に失敗したら画面に出す（§5.2）。
- 開いたとき、形が壊れていれば初期データに戻す（空のまま表示しない）。
- **日がたってから開いたら、データの日付を同じ日数だけ先へ送る**（`seededOn` と今日の差。生年月日 `birth` は送らない）。「◯日前」の表示がずれないように。
- 変更は必ず `mutate(fn, audit[], notices[])` を通す：状態を複製 → `fn` で変える → **全員のバッジを付け直す（新しく付いたら award を足す）** → 操作の記録とお知らせを足す。途中で失敗したら変えずに戻し、画面に出す。
- 番号は `newId(prefix)`（`seq` を1つ進めて4桁）。

### 12.2 操作（`useActions`）
- `buyPoints`：購入を ledger に（記録「ポイントを購入（10,000P・¥11,000）」）。
- `createCall(input, s)`：番号 `Y-xxxx`・`quote` で料金・お知らせ先を決め、不足があれば「不足分の購入（カード）」→「仮押さえ（確定料金）」（マイナス）→ 探し中の呼び出し。条件で呼ぶときは `etaMin` を控える。お店が空なら「未定（メッセージで決める）」。記録「条件で呼ぶ（スタンダード・1人・確定料金 18,000P を仮押さえ）」、お知らせ先へプッシュ通知「呼び出しが届きました」。
- お知らせ先（`offerList`）：指名＝その人だけ。条件＝エリアの人を先にした待機中の人（プレミアムはプレミアムの人だけ）6人まで。**操作中のキャストが待機中なら2番目に必ず入れる**（デモで受けられるように）。
- `accept(call, cast, by)`：探し中のときだけ。その人を加え、人数に足りなければお知らせ先の残り（見送りを除く）で埋める。そろったら確定・ゲストへ「キャストが決まりました」・キャストごとに会話を作る。記録「呼び出しを受けた」（運営なら「キャストを割り当て」）。
- `decline`（見送り）・`met`（確定 → 合流中・合流の時刻）・`extend`（合流中だけ延長＋1）。
- `finish(call, s)`：合流中だけ。仮押さえを戻す → 延長で足りなければ「延長分の不足を購入（カード）」→「利用（確定料金 18,000P＋延長 3,000P）」。記録「終了して精算（合計 21,000P）」、キャストへ「報酬が確定しました」。
- `cancel(call, by, reason, s)`：探し中・確定だけ。仮押さえを戻し、キャンセル料（運営なら0）を引く。
- `rateCasts`・`rateGuest`・`issueReceipt`（番号は最初のまま）・`sendMsg`（送った側を既読に）・`readThread`・`report`・`setOnline`・`saveShifts`・`submitPhoto`・`requestPayout`（手数料250円）・`markAwardsSeen`・`signup`（§7.2）。メッセージ・既読・「バッジを見た」以外は、どれも操作の記録を残す。

運営の画面の操作（承認・差し戻し・利用停止と解除・写真の承認・特別なバッジ・振込済み・通報の対応・バッジの条件）は画面の中で `mutate` を直接呼び、変える前と後・理由を記録に残す。

### 12.3 アプリの行き先（route）
```ts
GRoute = home | cast{id} | call{castId?} | live{id} | msgs | chat{id} | me | points | history | receipt{id} | verify | welcome | signup
CRoute = home | live{id} | shift | msgs | chat{id} | me | photo
```
運営の画面とデモの案内から、アプリの行き先を指定できるようにする（管理画面だけを表示中なら並べて表示か、アプリに切り替える）。

---

## 13. デモの案内（`src/guide/`）

### 13.1 使い方（5枚）
暗い幕の上で対象を光らせて説明する：ようこそ「飲み会アプリ YOINO のデモへようこそ」→ STEP 1 表示の切り替え「見たい画面に切り替えられます」→ STEP 2 アプリの切り替え「ゲストとキャストのアプリを切り替え」→ STEP 3 対応が要るもの「運営は「今夜の手配」から」→ STEP 4「流れを、案内に沿って体験」（「デモシナリオを見る」）。

### 13.2 デモシナリオ（右から出る板）
初めて開いた人には最初にこの板を出す。「このデモでできること」「▶ 全部を通して見る（約12分）」と4つのカード（題・説明・関わる人の並び・約3分・「自分で操作」「自動で再生」・体験済みの印）：

| # | 題 | 主な段 |
|---|---|---|
| 1 | ゲストが条件で呼ぶ → 料金が先に決まる → キャストが受けて確定 | 条件を選ぶ → プランごとの料金 → 確認と支払い → 不足分をカードで → 近くのキャストに順に届く → キャストのアプリに届く → 「受ける」で確定 → 運営の今夜の手配に出る → ゲストのアプリも確定 |
| 2 | 合流 → 延長 → 終了で精算 → 評価 → 領収書 | （準備：ケンタとミオの確定した呼び出し `Y-4100`・恵比寿・ワインバー「ルーチェ」・スタンダード120分を作る）合流した → 延長 → 精算 → シルバー会員に → 評価 → 領収書の発行と見本 → ミオに合流50回のバッジ → 報酬が今月の分に |
| 3 | ゲストとキャストで、マイページがまるで違う | ゲストのポイント・ランク・履歴 → キャストのバッジ → キャストの報酬と振込 → 出勤の格子 → 写真の差し替え → 運営に「写真の承認」 |
| 4 | 運営：キャストの審査・手配・支払い・バッジの設定 | 対応が要るもの → キャストの審査 → 承認 → 決まらない呼び出しを手配 → 振込済み → シルバーの条件を「利用2回」に（付く人・外れる人を確かめて保存） |

下に「音声で説明する（声は端末によって変わります）」「始める前にデモを初期状態に戻す」「ガイドをもう一度見る」。

### 13.3 案内の札（コーチ）
- 「自動で再生」：説明を読み終える時間（1文字110ms＋1.5秒・3〜10秒）待ってから、押す所に印を出して押し、文字は1文字ずつ打つように入れる。「自分で操作」：光った所を本人が押すと次へ。
- 速さ「ゆっくり／ふつう／はやい」（待ち時間×1.5／1／0.35）・一時停止・音声のON/OFF。音声はブラウザの読み上げ（`speechSynthesis`）で、日本語の声が無ければ文字だけで進む。
- 札はアプリの段では右、運営の段では左。終わりにまとめの文を出す。

---

## 14. デモでは本物につないでいない所（ソースのとおり）

| 所 | デモでの作り | 本番では |
|---|---|---|
| カード決済（ポイントの購入・不足分・延長の不足） | 画面だけ。見本のカード番号が最初から入っていて、押すとポイントが増えるだけで課金しない | 決済代行（Stripe など）の画面でカード・Apple Pay を受け付け、カード番号はサービスに残さない |
| キャストへの振込 | 申請と「振込済みにする」の記録だけ。お金は動かない | 決済代行の送金（Stripe Connect など）か、銀行の振込データの書き出し |
| 本人確認（ゲスト・キャスト） | 見本の画像を選ぶだけ。運営が画面で承認すると確認済みになる。キャストの書類・面接は表示の文だけ | 本人確認の専門サービス（eKYC）で顔と書類を照合し、運営は結果を見て承認 |
| 20歳以上の確認 | 入れた生年月日から年齢を計算して、20歳未満は登録させない | 本人確認の書類の生年月日で確かめる |
| 確認コード（SMS・メール） | 送らない。画面にデモのコード 482915 を出す。完了の画面の「控えをお送りしました」も送っていない | SMS・メールの送信の仕組み |
| プッシュ通知・お知らせ | データ（`notices`）に記録するだけで、送らない。アプリにお知らせの一覧も出さない | プッシュ通知の仕組み |
| 位置情報・距離 | 距離は初期データの固定の値。呼ぶ画面の上は地図ではなく夜の街の写真 | 端末の位置情報と地図 |
| 合流の記録 | 「合流した」を押すだけ | 位置情報か、双方の確認で記録 |
| ほかのキャストが受ける | 操作中のキャストに届いていないと、7秒後にほかのキャストが受けたことにする。「ほかのキャストが受けたことにする」のボタンもある | 本物のキャストが受ける |
| ログイン | 無い。上の切り替えで、決まったゲストとキャストになる。ログアウトはゲストを外すだけ | 会員ごとのログイン |
| データ | ブラウザの中（localStorage）だけ。サーバー・データベースは無い。ほかの端末とは共有しない | サーバーとデータベース |
| 領収書の PDF | ブラウザの印刷の画面 | PDF を作る仕組み |
| 利用規約・プライバシーポリシー | 本文は無い（その旨を画面に書く） | 本文を用意する |
| 写真の提出 | 見本の写真（`cast-XXb`）が入るだけ。横顔・全身の枠は飾り | 端末の写真を選んで送る |

---

## 15. ディレクトリ構成とビルド

```
public/img/ §11.2 の画像・robots.txt（Disallow: /）
src/ main.tsx（index.css → kit.css → app.css → motion.css の順に読む）・App.tsx（デモの枠）・config.ts・types.ts・lib.ts（§10）・seed.ts・store.tsx・actions.ts・ui.tsx（アイコン・札・入力欄・確認の窓）
src/customer/ Customer.tsx（切り替え・§8.6）・parts.tsx（写真・バッジ・星・下から出る板・上の帯・下のメニュー・見本のカード）・Guest.tsx・Live.tsx（探し中・確定）・Chat.tsx・Signup.tsx・Cast.tsx
src/admin/ Admin.tsx・nav.ts（対応が要るもの）・kit.tsx（右から出る詳細・数の札・棒グラフ）・GlobalSearch.tsx
src/guide/ scenarios.ts・Guide.tsx・pace.ts・voice.ts・dom.ts（§13）
```

```
npm install
npm run dev       # 開発
npm run build     # dist/ を作る
npm run preview   # dist をローカルで配信
```
静的なサイトなので、Cloudflare・Vercel・Netlify などに「ビルド `npm run build`／出力 `dist`」で載せられる。1ページだけの作りなので、見つからないURLは index.html を返す設定にする。検索エンジンに載せないよう、`X-Robots-Tag: noindex, nofollow, noarchive` も付ける。

---

## 16. 受け入れ基準（実装後に自分で確かめる）

**初期データ**
- [ ] キャスト40人・ゲスト120人・終わった呼び出し200件。同じ名前・同じひとことが無い。終了した金額は60通り以上で、すべて「1時間の料金×時間×人数＋指名料＋延長」どおり。
- [ ] 履歴・メッセージに未来の時刻が無い。残高がマイナスのゲストがいない。評価の件数は合流の回数以下。操作の記録はその人の登録より後だけ。
- [ ] 今夜の呼び出しの開始は夜の時間帯だけ。ミオの確定した予定の時刻は出勤の格子でも◎。

**呼ぶ → 確定 → 精算（ケンタ・恵比寿・2時間・1人）**
- [ ] ゲストの「待機中 N人」・カードの数・運営の「待機中のキャスト」が同じ。合流中のキャストはホームに出ない。
- [ ] プランの料金が 12,000P／18,000P／30,000P、2人で 36,000P。残高7,000P なので「不足分をカードで購入 11,000P（¥12,100）」と見本のカード。同意なしはエラー。
- [ ] 呼ぶと残高0P・仮押さえ18,000P・探し中の動き。キャストの切り替えに「1」、運営の今夜の手配に探し中。
- [ ] キャストのカードに本人確認の札と「報酬の目安 ¥10,800」。受けると確定し、会話ができ、運営の表が「確定・合流待ち」、ゲストの画面でカードが手前に来る。
- [ ] 延長2回で「いまの合計 21,000P」、運営の表も同じ。運営のキャストの一覧でミオは「合流中」。精算の板は「¥3,300を支払って精算する」。
- [ ] 精算で利用3回目 → シルバー会員のメダル。星なしの評価はエラー。領収書の宛名の最初は「株式会社ハヤテ企画」、税込 ¥23,100・消費税 ¥2,100。
- [ ] ミオに「合流50回」のメダル。今月の報酬に ¥12,600 が入る。今月の「売上＝キャストの報酬＋運営の手数料」。

**キャンセル・登録・本人確認**
- [ ] キャンセル料は探し中0・確定後50%・開始後100%で、仮押さえが戻る。
- [ ] 違う確認コード・20歳未満はエラー。確認の画面の「変更」でその段へ戻れる。完了で会員番号。
- [ ] 本人確認が済んでいないゲストは呼べない。運営が承認するとそのゲストにメダルが出る。

**運営・キャスト**
- [ ] 審査の承認で本人確認済みのバッジ。写真は承認まで元のまま。「接待に強い」を付けるとゲストのアプリにすぐ出る。
- [ ] 探し中にキャストを割り当てて確定できる。振込済みにすると申請中が減る。
- [ ] 通報で「利用停止」を選ぶと相手がその場で停止。シルバーの条件を「利用2回」にすると、保存の前に付く人・外れる人の数が出る。
- [ ] 運営の操作がすべて操作の記録に残る。
- [ ] 待機を切るとホームから消える。出勤の格子は「まだ保存していません」→「保存済み」。写真は正面なしで提出できない。振込は ¥5,000 未満・多すぎる額がエラー。

**全体**
- [ ] 送ったメッセージがもう一方のアプリにも出る。「動きを減らす」設定で動きが止まる。
- [ ] 10日後に開くとデータの日付も10日先へ。昼に開くと「いつから」が「今夜19時〜22時」。「初期化」で最初に戻る。
- [ ] 375・768・1024・1280・1440px で、はみ出しや横のスクロールが無い。押せる物は44px 以上。
- [ ] 部品に色の値を直接書いていない。金額の計算が lib.ts の外に無い。`npm run build` が通る。

---

## 17. 実装順序
1. 雛形（Vite＋React＋TypeScript）を作り、`config.ts`・`types.ts`・`index.css` の色と書体（§3・§4）を入れてビルドを通す
2. `lib.ts`（§10 の料金・キャンセル料・報酬・残高・バッジ・キャストのいまの状態）と `seed.ts`（§11.1）を作り、初期データの数と金額が料金表どおりかを確かめる
3. `store.tsx`（保存・日付を送る・mutate でバッジの付け直し）と `actions.ts`（§12）、共通の部品（`ui.tsx`・`customer/parts.tsx`）を作る
4. デモの枠（上部の帯・注記・アプリの切り替え・スマホの枠・並べて表示・トースト・初期化）と、ゲストのようこそ・会員登録（§5・§7.1・§7.2）を作る
5. ゲストのホーム・キャストの詳細・呼ぶ（料金が先に決まる）・探し中・確定・合流・延長・精算・評価・領収書（§7.3〜§7.7・見せ場①）を作る
6. キャストのアプリ（呼び出し・進み・出勤の格子・マイページの報酬と振込・実績のバッジ・写真の差し替え）とメッセージ・通報・バッジが付いた瞬間（§7.8・§7.9・§8・見せ場②）を作る
7. 運営の管理画面（今夜の手配・呼び出し・キャスト・ゲスト・決済・通報・バッジの設定・操作の記録・全体の検索）を作る（§9・§5.6）
8. デモの案内（使い方・デモシナリオ4本・自動で再生・音声）を作る（§13）
9. 動き（§4.5）と「動きを減らす」設定、画面幅ごとの崩れの点検をして、§16 の受け入れ基準を順に確かめる

---

### 付記：作るときの勘所
- **金額は1か所で計算する**。料金表・延長・ポイント換算・キャストの報酬・運営の手数料を lib.ts にだけ置き、ゲスト・キャスト・運営の3つの画面で同じ呼び出しの金額が必ず一致するようにする。
- **料金は呼んだ時点で控える**。あとから料金表やバッジの条件を変えても、送った呼び出しの金額は変わらない。
- **バッジは「データが変わるたびに付け直す」**。個別の操作の中で付け外ししない。付いた瞬間だけを award に残し、そのとき見ているアプリに出す。
- 強い色（ローズ）は、主なボタン・選んだ印・数のバッジ・ポイントの札にだけ使い、ほかは白と灰色で静かにする。写真の上の白文字には必ず暗いグラデーションを敷く。
- 「今夜」「夜の時間帯」を守る。昼に開いても昼から飲む予定を作らず、「今夜の◯時」として予約させる。
- 評価は相手に「だれが・何と書いたか」を出さない。低い評価と通報は運営だけが読む。
- 架空であることを画面の上の注記で必ず伝え、作り手の会社名はアプリの中に出さない。


---

## 付録　本番運用に向けて（ソウゾウ合同会社より）

> **この章は実装の対象ではありません。Claude Code は、この章の内容を実装しないでください。** 要件定義書を読んでいる方へのご案内です。

この要件定義書は、画面と動きを確かめるための**デモ**として書かれています。社内やお客さまに実際に使ってもらうには、次の4つが別に必要です。

| 項目 | デモでは | 本番では |
|---|---|---|
| データの保存 | データはその端末のブラウザの中にしか残りません。ほかの端末やほかの人とは共有されず、消えることもあります。 | サーバーのデータベースに保存し、バックアップと復元ができるようにします。 |
| セキュリティ | ログインがなく、誰でもすべての画面とデータを見られます。 | ログイン、権限（誰が何を見られるか）、通信とデータの暗号化、不正なアクセスへの対策を入れます。 |
| ガバナンス（運用ルール） | 決めていません。 | 誰がいつ何をしたかの記録、個人情報の扱い（プライバシーポリシー・同意）、アカウントの発行と削除、障害のときの連絡体制を決めます。 |
| 公開・デプロイ | 手元で動かすか、デモとして公開するだけです。 | 独自ドメイン、本番とテストの環境分け、更新の手順、監視と障害対応、月々の費用の管理を整えます。 |

本番運用をお考えの方は、ぜひ一度ご相談ください。最適なプランのご紹介と、進め方をお伝えします。

- 日程を選んで相談する（代表 西澤）：https://vszh6zudz50.jp.larksuite.com/scheduler/e7fecdad1a756dbe
- 公式LINE：https://lin.ee/UNwvWjp
- お問い合わせフォーム：https://service.souzoh-official.com/contact/
