KOYOMI — 要件定義書 兼 Claude Code 実装指示書
版数 1.1(初版 1.0 の実装・顧客確認を反映した改訂版)/ 作成日 2026-09-23 / 発行 ソウゾウ合同会社 用途 爆速アプリ開発ギャラリー掲載デモ、および実案件の標準仕様。予約体験のデザインを商品価値とする予約システム 公開中の実装 https://koyomi.souzohnic.workers.dev (本書 v1.1 はこの実装と同じものを作るための指示書である)
このドキュメントの使い方(Claude Code へ)
これ1枚が、規約・仕様・タスク・データ・画像の指示のすべて。リポジトリ直下に CLAUDE.md として置き、毎回読み込むこと。
- 実装は「12. 実装タスク」の順に進める。フェーズを飛ばさない。
- 各タスクの括弧内は要件ID。着手前に該当章を読むこと。
- 仕様がここに書かれていない場合は、推測で実装せず質問する。
- スコープ外(3章 Won't have)は、思いついても実装しない。
- 「デモだから」を理由に品質を落とす判断はしない。本書は本番仕様である。
- この領域だけの特別ルール:8章は他のどの章よりも優先される。 機能を実装するとき、8章の指定(タイポグラフィ・余白・モーション・状態)を満たさない実装は未完成として扱う。「動くが8章を満たしていない」は受入不可。
- v1.1 で追加したルール:14章「実装の要点と落とし穴」を、コードを書く前に必ず読むこと。 初版の実装で実際に起きた不具合と、その正しい作り方をまとめてある。
- 見た目の正解は 8.1 の「参考画像の書き起こし」と、付録A〜C の実データ・実文言・画像指示である。 店名・メニュー名・説明文・金額・文言・画像のプロンプトは、付録の値をそのまま使う(言い換えない)。
- 作ったら必ず見る。 画面を作るたびに、ヘッドレス Chrome で 390px(スマホ)と 1440px(PC)を撮影し、8章・付録と見比べてから次へ進む(12章 0-8)。
姉妹プロジェクトとの関係 AKIMA(汎用予約)/ KAMIWAZA(美容室予約)に続く、予約系の3本目。この3本は目的が違う。 AKIMA=予約エンジンの実装力を示す(丸ゴシック・青みの白・時間を面積で)/ KAMIWAZA=並行施術という業種固有の難所を解く(細ゴシック300・写真主導)/ KOYOMI=予約体験そのものを商品にする。ブランドごとに装いを変えながら、可読性と静けさを一切崩さない(明朝B1 × 角ゴシック・生成り × テナント色・面が滑るモーション)。 予約の「機能」は AKIMA から継承し、本書は「体験」と「本番品質」に全体重を乗せる。 空き枠エンジンの規約は AKIMA 4章と同一(本書2章で再掲)。
v1.0 → v1.1 の改訂の概要
初版を実装し、顧客(ギャラリー運営者)に確認してもらった結果、次の点を改めた。本書の該当箇所はすべて改訂後の内容に書き換えてある。
| # | 項目 | v1.0 | v1.1(本書) | 理由 |
|---|---|---|---|---|
| 1 | 見た目の基準 | 8章の文章のみ | 参考画像(高級予約アプリ「AURA RESERVE」のUIキット風の7画面+管理画面)を忠実に再現。画像の書き起こしを 8.1 に収録 | 「添付画像のようなデザインを忠実に」という指示 |
| 2 | 主要CTAの色 | --brand-500 塗り |
ブランド色の深い段 --brand-cta(明度0.30) 塗り+白文字。選択中の日付も同じ深い塗り |
参考画像の深緑のボタンに合わせる |
| 3 | 完了画面 | 生成りの地・560px の予約票 | 全面を深い地 --brand-deep で塗る(参考画像の6枚目) |
同上 |
| 4 | 入力欄 | 下線のみ | 白い面+細い枠(参考画像の5枚目) | 同上 |
| 5 | ステップ見出し | 左寄せ+左の縦罫 | 中央寄せ(左の縦罫は残す) | 同上 |
| 6 | 日付・時間の面 | 写真を撒かない | 面の下に写真+店の一言の帯を置く(参考画像の3・4枚目) | 同上 |
| 7 | 文字の大きさ・太さ | 本文16px・ウェイト400 | 本文17px・ウェイト500、補助14.5px、ラベル13.5px、見出し明朝600/ゴシック700、補助文字色を濃く | 「文字が小さく細く読みづらい」という指摘 |
| 8 | 写真 | 写真なしメニューを意図的に作る | 全メニュー・全席・全スタッフに写真を入れる(欠けゼロ)。画像は付録Cの指示どおりに用意する | 「画像が入っていない部分が多い」という指摘 |
| 9 | スタートページ | 「暦 KOYOMI」のブランド表現 | 「予約サイト(体験デモ)」。店名ではなく 業種名(飲食店/スパ・マッサージ/美容クリニック) で案内し、使い方を3ステップで示す | 「初めて触る人に分かりにくい」という指摘 |
| 10 | デモ切替バー | 店名で切替 | 業種名で切替(飲食店/スパ・マッサージ/美容クリニック。スマホは短縮名) | 同上 |
| 11 | メニューの提供時間帯 | なし | Menu.periodLabels(例:['昼'])を追加。昼のお献立は昼の枠にしか出ない |
昼の料理が夜に予約できてしまう |
| 12 | ホスティング | Vercel | Cloudflare Workers(OpenNext) | 運用中の他デモと同じ基盤 |
| 13 | ライブラリ | RHF+Zod・Recharts・@react-pdf | 使わない(自前の検証関数・CSSの棒グラフ・window.print()) |
初期JSを軽くするため。9章 |
| 14 | --ink-low |
#8F8A82 |
#67625B(--ink-mid も #4A4540 に濃く) |
仕様値は 3.5:1 で AA 未達、かつ読みづらい |
目次
- プロジェクト概要
- アーキテクチャ方針
- スコープ定義
- ロールとデモ切替
- 画面一覧とユーザーフロー
- 機能要件
- データ設計
- デザイン要件 ← 本書の中核。参考画像の書き起こしを含む
- 技術要件・ディレクトリ構成
- 非機能要件・法令
- 費用設計
- 実装タスク
- 受入基準
- 実装の要点と落とし穴 ← v1.1 で追加
1. プロジェクト概要
背景と目的
予約ページは、お客様が店に触れる最初の場所である。ほとんどの業種で、来店より先に予約がある。
そして現実の予約ページの多くは、こうなっている。
- 店のサイトは美しいのに、「予約する」を押した瞬間に別の会社の画面に飛ばされる
- 空いているかどうかが分からず、日付を何度もめくらされる
- いくらかかるか、何分かかるか、確定するまで分からない
- 確認メールが素っ気なく、本当に予約できたのか不安になる
予約体験の質は、そのまま店の第一印象になる。 高単価のサービスほど、この落差は致命的になる。
この領域には、最初に共有すべき事実が3つある。
事実①:予約は「機能」ではなく「接客」の一部である
予約ページで起きていることは、来店時の受付と同じだ。「いらっしゃいませ」「ご希望のお日にちは」「こちらの席でよろしいですか」「お待ちしております」——これを画面が代行している。
だから予約ページには、店の接客と同じ品位が要る。 素っ気ないフォームは、素っ気ない受付と同じ。
事実②:予約の不安は、4つの問いに集約される
| お客様の問い | 答えが遅れると |
|---|---|
| 空いている? | 日付を何度もめくって疲れ、離脱する |
| いくら?何分? | 確定直前に金額が出て、驚いて戻る |
| 本当に取れた? | 確認が薄いと、電話で聞き直す(店の手間も増える) |
| 変更・キャンセルできる? | 規定が見つからず、予約自体をためらう |
優れた予約ページは、この4つに「聞かれる前に」答える。 KOYOMI の画面設計は、すべてこの4つの問いに対応している(8章)。
事実③:予約ページは「店のもの」でなければならない
既製の予約サービスは便利だが、店のブランドを表現できない。 汎用のUIに店名を入れただけの画面は、お客様に「別のところに連れて行かれた」感覚を与える。
KOYOMI は、店ごとに装いを変える。 色・写真・言葉づかい・余白の広さを店に合わせながら、可読性・操作性・静けさは一切変えない(8章 テナントテーマ)。
KOYOMI はこの3つの事実を前提に設計する。
| 目的 | 内容 |
|---|---|
| デザイン力の証明 | 予約体験がブランド体験になることを、実物で示す。テナント切替で装いが変わり、品位は変わらない |
| 本番品質の証明 | 空き枠エンジン・仮押さえ・決済UI・通知・多店舗・ウィジェット埋め込みまで、実案件にそのまま使える仕様 |
| 期待値の正常化 | 予約システムの価値は「枠を取る機能」ではなく「不安なく予約できる体験」にあることを示す |
| 費用判断の材料 | 既製サービスとの差分が「ブランド体験」にあることを、費用の観点で説明する |
プロダクト定義
| 項目 | 内容 |
|---|---|
| プロダクト名 | KOYOMI(暦)※仮称 |
| 一言定義 | 店の装いで、不安なく予約できる。予約体験を商品価値にする予約システム |
| 想定業態 | 体験の質が価値になる店舗型サービス:レストラン(コース・個室)、スパ・エステ、自由診療クリニック、体験教室・ワークショップ、写真スタジオ、貸切スペース、ギャラリー |
| 提供形態 | レスポンシブWebアプリ(PWA)。デモはフロントエンド完結。本番は同一UI層のまま、リポジトリ層をAPI接続に差し替える |
| 主戦場 | 予約はスマホ(夜間・移動中)。管理はPC/タブレット(店頭) |
| 想定利用者 | ギャラリーの来訪者・商談先。予約する側と受ける側の両方を体験できる |
プロダクトコンセプト
「予約は、来店の最初の一歩。」
KOYOMI は、画面を店の入口として設計する。空いている日が一目で分かり、いくらで何分かが選んだ瞬間に見え、確定の前に規定が読め、確定の後に静かな余韻がある。急がせず、迷わせず、不安にさせない。 そしてその装いは、店ごとに違う。
デモとしての成功条件
- 触った瞬間に「上質」と分かる — 余白・書体・モーションの品位が、既製の予約サービスと明確に違う
- テナントを切り替えると装いが変わる — 和食店・スパ・クリニックで、色も写真も言葉も変わる。しかし操作は同じ
- 4つの問いに聞かれる前に答えている — 空き・金額・時間・規定が、必要な瞬間に見えている
- 仮押さえと競合が動く — 枠を選ぶと確保され、時間切れで解放される
- 管理側も同じ品位 — 店頭のタイムラインが、お客様側と同じトークンで作られている
- ウィジェットとして店のサイトに埋め込める — 予約ボタン1つで、店のサイトの中で完結する
- リセットできる — 誰が触った後でも初期状態に戻せる
2. アーキテクチャ方針
基本方針
デモはバックエンドとデータベースを持たない。本番は同一UI層のまま、リポジトリ層をAPI接続に差し替える。
| 領域 | デモ | 本番(差し替え箇所) |
|---|---|---|
| ホスティング | Cloudflare Workers(OpenNext) | 同一(14.8) |
| データ永続化 | シードデータ + ブラウザ内ストア | PostgreSQL(lib/repo/ の実装を差し替え) |
| 認証 | ロール切替 | 会員認証(メール/LINE)+ 管理者認証 |
| 空き枠計算 | ブラウザ内で本物 | サーバー側で同一ロジックを実行(lib/availability/ は純粋関数なので移植可能) |
| 仮押さえ | ブラウザ内タイマー | サーバー側の有効期限付きロック |
| ダブルブッキング防止 | シミュレーション | DB の一意制約 + トランザクション(本書 10章) |
| 決済 | UIと完了画面まで | 決済代行(トークン方式) |
| 通知 | 送信内容のプレビュー | メール/LINE/SMS の実送信 |
| テナントテーマ | ブラウザ内で本物 | 同一(設定はDBに保存) |
| ウィジェット埋め込み | 本物(iframe + postMessage) | 同一 |
本書は本番仕様として書く。 デモで省略する箇所は「デモでは〜」と明示する。
空き枠エンジンの原則(AKIMA と同一。再掲)
空き枠 = 営業時間 ∩ スタッフ/リソースの稼働時間
− 既存予約 − 仮押さえ − 休憩 − 前後バッファ
− 定休日・臨時休業 − 受付期限 − 予約可能期間
かつ メニューの所要時間が丸ごと収まること
かつ 必要リソース(席・部屋・設備・担当)が同時に空いていること
| ID | 規約 |
|---|---|
| AVL-01 | 空き枠を判定するコードを lib/availability/ の外に書かないこと |
| AVL-02 | lib/availability/ は純粋関数のみ。現在時刻は引数で受け取る |
| AVL-03 | 入口は getAvailability(input) の1関数に統一する |
| AVL-04 | 「なぜこの枠が埋まっているのか」の理由を返すこと(予約済み/稼働外/定休日/受付期限/リソースなし/バッファ/仮押さえ中) |
| AVL-05 | 予約確定の直前に必ず再検証すること(本番ではサーバー側で再実行) |
| AVL-06 | 空き枠の「密度」を返すこと(その日の残り枠数 ÷ 総枠数)。カレンダーの空き具合表示に使う(8章) |
AVL-06 が本書固有。 「空いているか」を日付をめくる前に答えるため(1章 事実②)。
テナントテーマの原則(本書固有の中核)
1つのコードベースで、店ごとに装いを変える。 ただし変えてよいものと、変えてはいけないものを厳密に分ける。
| 変えてよい(テナントが設定) | 変えてはいけない(システムが保証) |
|---|---|
| ブランド色(1色) | コントラスト比(自動補正) |
| 写真(ヒーロー・メニュー) | タイポグラフィのサイズ・行間・字間 |
| 書体の系統(明朝系/ゴシック系) | 余白のスケール |
| 言葉づかい(敬語の温度・呼称) | ステップの順序・操作 |
| 角丸の強さ(3段階) | モーションの長さ・イージング |
| 余白の広さ(3段階) | 状態表示(空き・仮押さえ・確定)の意味づけ |
| ロゴ・店名・営業情報 | アクセシビリティ要件 |
| ID | 規約 |
|---|---|
| THM-01 | テナントテーマを lib/theme/ で解決し、CSS変数として注入すること。 コンポーネントにテナント分岐を書かない |
| THM-02 | ブランド色から派生色(濃淡・背景・罫線)を自動生成すること。 テナントが指定するのは1色だけ |
| THM-03 | 派生色のすべてで、テキストのコントラスト比 4.5:1(本文は 7:1)を自動で保証すること。 保証できない場合は補正し、管理画面で「補正しました」と表示する |
| THM-04 | 書体は「明朝系」「ゴシック系」の2系統から選ぶ。 任意フォントの持ち込みは不可(可読性の保証のため) |
| THM-05 | 余白・角丸は3段階のプリセットから選ぶ。 数値の直指定は不可 |
| THM-06 | テーマの変更がプレビューで即座に確認でき、お客様側にも即座に反映されること |
| THM-07 | ウィジェット埋め込み時も、同じテーマが適用されること |
仮押さえ(Hold)の原則
| ID | 規約 |
|---|---|
| HLD-01 | 枠を選択した時点で仮押さえを作成し、既定10分の有効期限を設定する(決済入力を考慮し、AKIMA の5分より長い) |
| HLD-02 | 仮押さえ中の枠を、他のお客様の空き枠から除外する |
| HLD-03 | 残り時間を表示するが、急かさないこと(8章。カウントダウンを大きく出さない) |
| HLD-04 | 期限切れ時は枠を解放し、入力内容は保持し、別の枠を選び直せば再利用できる |
| HLD-05 | 確定直前に再検証し、埋まっていた場合は「他のお客様が先に予約されました」を、責めない文言で表示する |
ウィジェット埋め込みの原則(本番機能)
店のサイトに「予約する」ボタンを置き、店のサイトの中で予約が完結する。
| ID | 規約 |
|---|---|
| WGT-01 | <script> 1行で設置できること。ボタン/インライン/フローティングの3形態 |
| WGT-02 | iframe で描画し、親サイトのCSSに影響されない・影響しないこと |
| WGT-03 | テナントテーマが適用されること(THM-07) |
| WGT-04 | 親サイトとの通信は postMessage のみ。高さの自動調整・完了通知・閉じる |
| WGT-05 | 親サイトのURLを予約の流入元として記録すること |
| WGT-06 | iframe 内で位置情報・カメラを要求しないこと |
| WGT-07 | 初期表示は軽量(JS 60KB以下)とし、親サイトの Core Web Vitals を悪化させないこと |
差し替え可能性の担保
[ コンポーネント ]
↓ 呼ぶのはこの層だけ
[ lib/repo/*.ts ] ← 全メソッド async。本番ではここをAPI接続に差し替える
↓
[ lib/availability/ ] ← 空き枠(純粋関数。本番ではサーバーへ移植)
[ lib/theme/ ] ← テナントテーマの解決(純粋関数)
[ lib/hold/ ] ← 仮押さえ
[ lib/pricing/ ] ← 金額計算(純粋関数)
[ lib/store/*.ts ] ← Zustand + persist
↓
[ lib/seed/*.ts ] ← 初期データ(3テナント)
永続化の範囲(デモ)
| 対象 | 挙動 |
|---|---|
| シードデータ(3テナント・メニュー・リソース・スタッフ・既存予約) | 初期投入。管理画面から編集可能 |
| 予約・仮押さえ・キャンセル・キャンセル待ち | localStorage に保存 |
| テナントテーマの設定 | localStorage に保存。変更が即座に反映される |
| 会員情報(デモ用) | localStorage のみ。どこにも送信しない |
| リセット | 「デモをリセット」で localStorage をクリア |
| 複数タブ | 別のタブで保存された変更を storage イベントで取り込む(お客様のタブと店側のタブを並べても上書きしない。14.3) |
| 初期データ | 保存がないときだけ遅延読み込みして生成(14.3)。データの版 DATA_VERSION を上げると作り直す |
擬似ディレイ は 150〜400ms。ただし空き枠の再計算・ステップ遷移・テーマ切替は擬似ディレイを入れず、100ms以下とする。
3. スコープ定義
予約する(お客様)
| ID | 機能 | 概要 | 優先度 |
|---|---|---|---|
| F-C01 | 店舗ページ | ヒーロー写真、店の紹介、メニュー、アクセス、営業情報。予約導線が常に見える | Must |
| F-C02 | メニュー選択 | カテゴリ、写真、所要時間、金額、説明。複数選択可。合計が即座に見える | Must |
| F-C03 | オプション選択 | メニューに紐づく追加オプション(延長・アップグレード・追加人数)。金額連動 | Must |
| F-C04 | 人数選択 | 人数によって金額・利用可能リソースが変わる(席・部屋の定員) | Must |
| F-C05 | 担当・リソース選択 | 指名あり/なし。席・部屋の指定(任意) | Must |
| F-C06 | 日付選択 | 月カレンダー。空き具合が日付ごとに見える(AVL-06) | Must |
| F-C07 | 時間選択 | 時間帯のリスト。残り枠、金額(時間帯で変わる場合)、所要時間の帯 | Must |
| F-C08 | 仮押さえ | 枠選択で確保。残り時間の表示(HLD) | Must |
| F-C09 | お客様情報 | 氏名・電話・メール・要望。会員は自動入力。ゲスト予約可 | Must |
| F-C10 | 事前決済/デポジット | カード入力UI、金額内訳、キャンセル規定の同意(決済処理は本番) | Must |
| F-C11 | 確認 | 全内容を「予約票」として表示。規定を読んでから確定 | Must |
| F-C12 | 完了 | 予約番号、カレンダー追加、地図、次に何が起きるか | Must |
| F-C13 | 予約の確認・変更・キャンセル | 予約番号 + 電話番号、または会員ログイン。規定に応じた案内 | Must |
| F-C14 | キャンセル待ち | 満席の日時に登録。空いたら通知 | Must |
| F-C15 | 会員登録・ログイン | メール/LINE(本番)。予約履歴、お気に入り、情報の自動入力 | Must |
| F-C16 | 予約履歴・再予約 | 過去の予約から同じ内容で再予約 | Should |
| F-C17 | 多言語(日本語/英語) | お客様側のみ。インバウンド需要への対応 | Should |
| F-C18 | ギフト・代理予約 | 他の人のために予約(宛名・メッセージ) | Could |
受ける(店舗スタッフ・店長)
| ID | 機能 | 概要 | 優先度 |
|---|---|---|---|
| F-S01 | 本日の予約(デイシート) | 時間順の一覧。来店・着席・完了のステータス操作。店頭でタブレットで使う | Must |
| F-S02 | タイムライン | 横=リソース/縦=時間。予約ブロック。ドラッグで移動 | Must |
| F-S03 | 予約の手動作成 | 電話・来店の代理入力。制約の無視(店長のみ) | Must |
| F-S04 | 予約詳細・編集 | 内容変更、ステータス、メモ、変更履歴 | Must |
| F-S05 | ブロック枠 | 予約を受けない時間帯(ドラッグで作成) | Must |
| F-S06 | 来店受付 | 到着 → 案内 → 完了。所要時間の実績 | Must |
| F-S07 | 顧客カルテ | 来店履歴、好み・アレルギー・注意事項、メモ | Must |
| F-S08 | キャンセル待ちの処理 | 空きが出たら順に案内(通知プレビュー) | Must |
| F-S09 | 予約一覧・検索 | 期間・ステータス・顧客名・メニューで絞り込み | Must |
整える(管理者)
| ID | 機能 | 概要 | 優先度 |
|---|---|---|---|
| F-A01 | テナントテーマ設定 | ブランド色・写真・書体系統・余白・角丸・言葉づかい。プレビュー付き(THM) | Must |
| F-A02 | 店舗情報 | 店名、住所、電話、営業時間、定休日、臨時休業、写真、SNS | Must |
| F-A03 | メニュー・オプション管理 | 所要時間、前後バッファ、金額、人数連動、必要リソース、写真 | Must |
| F-A04 | リソース管理 | 席・部屋・設備。定員、同時利用数、写真 | Must |
| F-A05 | スタッフ・シフト管理 | 稼働時間、休憩、対応メニュー、指名料 | Must |
| F-A06 | 予約ルール | 受付期限、予約可能期間、刻み幅、仮押さえ時間、1組の上限人数 | Must |
| F-A07 | キャンセル規定 | 何日前まで無料、以降の料率、無断キャンセルの扱い | Must |
| F-A08 | 決済設定 | 事前決済/デポジット/当日払い。メニュー別に設定 | Must |
| F-A09 | 通知設定 | 確認・リマインド・変更・キャンセル・キャンセル待ち。文面のデザインと差し込み変数(8章) | Must |
| F-A10 | ウィジェット設定 | 設置コード、形態(ボタン/インライン/フローティング)、プレビュー | Must |
| F-A11 | 特別営業日 | 祝日・イベント日の営業時間・メニュー・金額 | Should |
| F-A12 | 定員制クラス | 開催日時固定、定員、繰り返し | Should |
| F-A13 | 予約分析 | 稼働率、時間帯別、メニュー別、キャンセル率、流入元、離脱ステップ | Must |
| F-A14 | 多店舗管理 | 店舗ごとの設定・テーマ・予約。本部での横断表示 | Should |
| F-A15 | 操作ログ | 誰がいつ何を変更したか | Must |
共通・基盤
| ID | 機能 | 概要 | 優先度 |
|---|---|---|---|
| F-X01 | ロール切替 | お客様/スタッフ/管理者 をワンクリック切替 | Must |
| F-X02 | テナント切替 | 「飲食店/スパ・マッサージ/美容クリニック」の業種名で3テナントを切替(店名は例として添える)。装いが変わる | Must |
| F-X03 | ウィジェット埋め込み | <script> 1行。iframe + postMessage(WGT) |
Must |
| F-X04 | 競合シミュレーション | 仮押さえ中に他者の予約を発生させる(デモのみ) | Must |
| F-X05 | デモである旨の明示 | 全画面。確認・完了画面では強調 | Must |
| F-X06 | 記事・ギャラリーへの導線 | 元ページへのリンク、問い合わせ | Must |
| F-X07 | デモリセット | localStorage をクリア | Must |
| F-X08 | PWA | ホーム画面追加 | Should |
対象外(Won't have)
| 項目 | 理由 |
|---|---|
| データベース・バックエンドAPI(デモ) | 2章の方針。本番では実装する |
| サーバー側の排他制御(デモ) | 本番の DB 制約で解く(10章)。デモはシミュレーション |
| 実際の課金処理(デモ) | 本番は決済代行のトークン方式 |
| 実際のメール・LINE・SMS送信(デモ) | 本番は送信基盤を接続 |
| Google予約(Reserve with Google)・グルメサイト連携 | 別要件。API仕様が外部依存 |
| POS・レジ・会計連携 | 会計はステータスまで |
| 順番待ち(整理券) | 時間指定予約に限定 |
| 在庫・仕入れ | 対象外 |
| 口コミ・レビュー | 対象外(プラットフォームの領域) |
| 宿泊(複数泊・チェックイン/アウト) | 日帰りのサービスに限定。宿泊は別プロダクト |
| 配送・テイクアウト | 対象外 |
スコープリスク: 「うちの業種ではこうで」が最も出る領域。特に飲食(コース×席×人数)とスパ(施術×部屋×担当)は制約の組み方が違う。 本書は「メニュー × リソース × 担当 × 人数」の一般モデルで両方を吸収する設計にしている(7章)。業種固有のルールが一般モデルに載らない場合は、要件定義段階で洗い出す。
4. ロールとデモ切替
ロール定義
| ロールID | 名称 | 見えるデータ | 特徴的な権限 |
|---|---|---|---|
customer |
お客様 | 自分の予約のみ(ゲストは予約番号照会) | 予約・変更・キャンセル・キャンセル待ち |
staff |
店舗スタッフ | 自店舗の当日〜今後の予約、顧客カルテ | デイシート操作、来店受付、手動予約(制約内)、カルテ記入 |
manager |
店長 | 自店舗のすべて | 上記 + 制約無視の手動予約、ブロック枠、シフト、キャンセル待ち処理 |
admin |
管理者(本部) | 全店舗 | 上記 + テーマ・店舗情報・メニュー・ルール・決済・通知・ウィジェット・分析・多店舗 |
テナント(デモ用の3店舗)
同じシステムが、店によって別の顔になることを見せる。
| テナント | 業種(画面での呼び名) | ブランド色 | 書体系統 | 余白 | 角丸 | 言葉づかい |
|---|---|---|---|---|---|---|
| 懐石 いちょう | 和食(コース・個室)/飲食店 | 朱 #B5433A |
明朝系 | 広い | 弱い | 丁寧・静か(「お待ち申し上げております」) |
| SPA & THERAPY hana | スパ・エステ/スパ・マッサージ | 苔 #5B6B4F |
ゴシック系 | 広い | 中 | 柔らかい(「ゆっくりお過ごしください」) |
| 青葉クリニック 美容外来 | 自由診療クリニック/美容クリニック | 藍 #2F4A6D |
ゴシック系 | 標準 | 弱い | 明確・簡潔(「ご来院ください」) |
3テナントで、同じ操作・同じ構造・同じ品位。装いだけが違う。 これが THM の実証になる。各テナントの全データは付録A。
データスコープの要点
| ID | 要件 |
|---|---|
| SCP-01 | データスコープを lib/repo/_scope.ts に集約すること |
| SCP-02 | コンポーネント側で role === 'staff' のような分岐を書かないこと |
| SCP-03 | お客様は、他のお客様の予約・氏名を一切取得できないこと |
| SCP-04 | スタッフは、他店舗の予約・顧客を取得できないこと |
| SCP-05 | 顧客カルテの「注意事項」(アレルギー等)は、スタッフ以上のみが閲覧できること |
| SCP-06 | テナントテーマの設定は管理者のみ変更でき、変更は操作ログに残ること |
ロールを跨ぐ体験(必ず動くようにする)
- お客様として予約する → スタッフに切替 → デイシートとタイムラインにその予約が現れている
- 管理者がテナントのブランド色を変える → お客様に切替 → 予約ページの装いが変わっている。しかし文字は同じ読みやすさ(THM-03)
- 管理者が余白を「広い」→「標準」に変える → 同じページの密度が変わる。操作は変わらない
- 管理者がメニューの所要時間を変える → お客様に切替 → 選べる時間枠が変わっている
- お客様が仮押さえ中に競合発生 → 「他のお客様が先に」の案内。入力内容は保持される(HLD-04, HLD-05)
- お客様が満席の日にキャンセル待ち登録 → 店長がキャンセルを処理 → キャンセル待ちに通知(プレビュー)が出る
- 管理者がキャンセル規定を変更 → お客様に切替 → 確認画面の規定文が変わっている
- ウィジェットを店のサイト(模擬)に埋め込む → 店のサイトの中で予約が完結し、完了が親サイトに通知される(WGT-04)
2・3・8 が、このデモの核心。 事実③(予約ページは店のもの)が体験として成立する瞬間。
デモ切替バー(F-X01, F-X02)
画面上部に常時表示する固定バー(高さ 44px)。ウィジェットモードでは非表示。 1440px 以上ではロール以降の項目を横並び、それ未満は「…」のメニューにまとめる。
- 左端に「予約サイト」(スタートページへ)
- 業種の切替(飲食店/スパ・マッサージ/美容クリニック。スマホは 飲食店/スパ/クリニック)——ここが最も目立つ位置。色の点(ブランド色)を添え、ツールチップに「飲食店の予約サイト(例:懐石 いちょう)」
- ロール切替(4ロール)
- お客様ロール時:ゲスト/会員 の切替
- デモ内の現在日時
- 「デモをリセット」(確認ダイアログ付き)
- 元ページへ戻るリンク
- 「これはデモです。実際の予約・連絡は発生しません」の明示
デザイン上の扱い: プロダクト本体がテナント色で装われるため、切替バーはテナントの影響を受けない固定の墨色とする。予約フロー中(ステップ2以降)は自動的に薄くなり、マウスを近づけると戻る(没入を壊さない)。
5. 画面一覧とユーザーフロー
全36画面+スタートページ・個人情報ページ・404。画面IDはディレクトリ構成と 1:1 で対応させる。
共通(v1.1 で明記)
| 画面ID | 画面名 | パス | 主要要素 |
|---|---|---|---|
| SC-000 | スタートページ | / |
「予約サイト」の見出しと説明、使い方の3ステップ、業種で選ぶ3枚のカード、お店側の画面への入口(8.5) |
| SC-900 | 個人情報・写真のクレジット | /privacy |
デモの個人情報の扱い、全画像の出典(#credits) |
| SC-901 | 見つからないページ | 404 | 素の404にせず、3つのお店と入口への案内 |
予約する(お客様)
| 画面ID | 画面名 | パス | 主要要素 |
|---|---|---|---|
| SC-001 | 店舗ページ | /[tenant] |
ヒーロー、紹介、メニュー、アクセス、営業情報、固定の予約ボタン |
| SC-010 | メニュー選択 | /[tenant]/book |
カテゴリ、写真、所要時間、金額。サマリーが即座に更新 |
| SC-011 | オプション・人数 | /[tenant]/book/options |
追加オプション、人数ステッパー。金額連動 |
| SC-012 | 担当・席の選択 | /[tenant]/book/resource |
指名なし/あり。席・部屋の指定(任意) |
| SC-013 | 日付選択 | /[tenant]/book/date |
月カレンダー + 空き具合。最短の空きへ |
| SC-014 | 時間選択 | /[tenant]/book/time |
時間帯リスト、残り枠、所要時間の帯 |
| SC-015 | 仮押さえ中・お客様情報 | /[tenant]/book/details |
残り時間(控えめ)、氏名・連絡先・要望。会員は自動入力 |
| SC-016 | お支払い | /[tenant]/book/payment |
内訳、カード入力UI、規定への同意 |
| SC-017 | 確認(予約票) | /[tenant]/book/confirm |
全内容を予約票の体裁で。規定の再掲。確定ボタン |
| SC-018 | 完了 | /[tenant]/book/complete/[code] |
予約番号、カレンダー追加、地図、次に起きること、通知プレビュー |
| SC-019 | 競合・期限切れ | モーダル | 責めない案内、別の枠へ |
| SC-020 | 予約照会 | /[tenant]/reservations/lookup |
予約番号 + 電話番号 |
| SC-021 | 予約詳細 | /[tenant]/reservations/[code] |
予約票、変更・キャンセル、地図、カレンダー |
| SC-022 | 予約の変更 | /[tenant]/reservations/[code]/change |
再度の日時選択。差額の表示 |
| SC-023 | キャンセル | /[tenant]/reservations/[code]/cancel |
規定に応じた料率、理由、取り消し不可の明示 |
| SC-024 | キャンセル待ち登録 | モーダル | 希望日時、通知方法 |
| SC-030 | 会員登録・ログイン | /[tenant]/account |
メール/LINE(本番) |
| SC-031 | 予約履歴 | /[tenant]/account/history |
過去・今後の予約、再予約 |
| SC-032 | 会員情報 | /[tenant]/account/profile |
氏名・連絡先・通知設定 |
| SC-090 | ウィジェット | /widget/[tenant] |
iframe 内。予約フロー全体(WGT) |
| SC-091 | ウィジェット設置の模擬サイト | /demo/host-site/[tenant] |
店のサイト風ページ。ボタン/インライン/フローティングの3形態 |
受ける(スタッフ・店長)
| 画面ID | 画面名 | パス | 主要要素 |
|---|---|---|---|
| SC-100 | デイシート | /manage |
本日の予約を時間順。来店・案内・完了。タブレット最適化 |
| SC-101 | タイムライン | /manage/timeline |
横=リソース/縦=時間。ドラッグ移動。ブロック枠 |
| SC-102 | 予約詳細・編集 | /manage/reservations/[id] |
内容、ステータス、メモ、カルテへの導線、変更履歴 |
| SC-103 | 予約の手動作成 | /manage/reservations/new |
代理入力。制約無視(店長) |
| SC-104 | 予約一覧 | /manage/reservations |
絞り込み、検索、CSV |
| SC-110 | 顧客カルテ | /manage/customers/[id] |
来店履歴、好み、注意事項(最上部・畳めない)、メモ |
| SC-111 | 顧客一覧 | /manage/customers |
検索、来店回数、最終来店 |
| SC-120 | キャンセル待ち | /manage/waitlist |
一覧、空き発生時の案内 |
整える(管理者)
| 画面ID | 画面名 | パス | 主要要素 |
|---|---|---|---|
| SC-200 | ダッシュボード | /admin |
本日・今週の予約、稼働率、キャンセル、キャンセル待ち |
| SC-210 | テナントテーマ | /admin/theme |
ブランド色・写真・書体・余白・角丸・言葉づかい。リアルタイムプレビュー |
| SC-211 | 店舗情報 | /admin/store |
店名、住所、営業時間、定休日、臨時休業、写真、SNS |
| SC-220 | メニュー管理 | /admin/menus |
CRUD、所要時間、バッファ、金額、人数連動、必要リソース |
| SC-221 | オプション管理 | /admin/options |
メニュー紐付け、金額 |
| SC-222 | リソース管理 | /admin/resources |
席・部屋・設備。定員、同時利用数 |
| SC-223 | スタッフ・シフト | /admin/staff |
稼働時間、休憩、対応メニュー、指名料 |
| SC-230 | 予約ルール | /admin/rules |
受付期限、予約可能期間、刻み幅、仮押さえ時間、上限人数 |
| SC-231 | キャンセル規定 | /admin/cancel-policy |
段階的な料率、無断キャンセル |
| SC-232 | 決済設定 | /admin/payment |
事前決済/デポジット/当日払い、メニュー別 |
| SC-233 | 通知設定 | /admin/notifications |
文面のデザイン、差し込み変数、送信タイミング、プレビュー |
| SC-234 | ウィジェット設定 | /admin/widget |
設置コード、形態、プレビュー |
| SC-235 | 特別営業日 | /admin/special-days |
営業時間・メニュー・金額の上書き |
| SC-236 | 定員制クラス | /admin/classes |
開催日時、定員、繰り返し |
| SC-240 | 予約分析 | /admin/analytics |
稼働率、時間帯別、メニュー別、キャンセル率、流入元、離脱ステップ |
| SC-250 | 多店舗 | /admin/stores |
店舗一覧、横断表示 |
| SC-251 | 操作ログ | /admin/logs |
変更履歴 |
主要フロー
フローA:お客様が不安なく予約する(最重要)
店のサイト(模擬)で「予約する」を押す
↓ ★ 店のサイトの中で予約フローが開く(ウィジェット)。別サイトに飛ばされない
SC-010 メニュー選択
┌────────────────────────────────────────────────────────┐
│ 懐石 いちょう │
│ │
│ お献立をお選びください │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ [写真] │ │ [写真] │ │ [写真] │ │
│ │ 昼のお献立 │ │ 夜のお献立 │ │ 特別会席 │ │
│ │ 90分 │ │ 150分 │ │ 180分 │ │
│ │ ¥8,800 │ │ ¥16,500 │ │ ¥27,500 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ ──────────────────────────────────────────────────── │
│ 夜のお献立 ・ 150分 ¥16,500 │ ← サマリー(常時)
│ [ 次へ →] │
└────────────────────────────────────────────────────────┘
↓ ★ 選んだ瞬間に「何分・いくら」が下に出る(事実② の2つ目に即答)
SC-011 人数 ── 2名 → ★ 金額が ¥33,000 に。個室の選択肢が出る
↓
SC-013 日付選択
┌────────────────────────────────────────────────────────┐
│ ‹ 2026年 10月 › │
│ │
│ 月 火 水 木 金 土 日 │
│ 1 2 3 4 │
│ ● ● ◐ ○ │
│ 5 6 7 8 9 10 11 │
│ — ● ● ● ◐ ○ ○ │
│ ... │
│ │
│ ● 空きあり ◐ 残りわずか ○ 満席 — 定休日 │
│ │
│ 最短のご案内:10月2日(金)18:00〜 │
└────────────────────────────────────────────────────────┘
↓ ★ 日付をめくる前に、空き具合が見える(事実② の1つ目に即答)
SC-014 時間選択
17:30 ○ 空きあり 個室 あと2室
18:00 ○ 空きあり 個室 あと1室
18:30 ◐ 残りわずか カウンターのみ
19:00 — 満席 [キャンセル待ち]
↓ ★ 各時間に残り枠と、所要150分の帯が視覚化される
18:00 を選ぶ
↓ ★ 仮押さえ(10分)。残り時間は控えめに表示され、急かさない
SC-015 お客様情報 ── 会員なら自動入力。ゲストでも3項目だけ
↓
SC-016 お支払い ── 内訳 ¥33,000 / デポジット ¥6,600 / 当日 ¥26,400
★ キャンセル規定がここで読める(事実② の4つ目に、確定前に即答)
↓
SC-017 確認(予約票)
★ 「予約票」の体裁。店名・日時・お献立・人数・席・金額・規定
★ 明朝で組まれ、紙の予約票のような静けさ
↓
確定
↓
SC-018 完了
┌────────────────────────────────────────────────────────┐
│ │
│ ご予約を承りました │
│ │
│ 10月2日(金)18:00 │
│ 夜のお献立 ・ 2名様 ・ 個室 │
│ │
│ 予約番号 KY-26100-0412 │
│ │
│ ┌───────────────────────────────────────────────┐ │
│ │ この後の流れ │ │
│ │ ・確認メールをお送りしました │ │
│ │ ・前日 18:00 にリマインドをお送りします │ │
│ │ ・当日はご予約時間の5分前までにお越しください │ │
│ └───────────────────────────────────────────────┘ │
│ │
│ [ カレンダーに追加 ] [ 地図を見る ] │
│ │
│ お待ち申し上げております。 │
└────────────────────────────────────────────────────────┘
★ 「本当に取れた?」(事実② の3つ目)に、次に起きることまで含めて即答
↓
★ ここで伝わること:
「4つの不安に、聞かれる前に答えている。だから迷わず、急がず、確定できる」
フローB:テナントで装いが変わる(事実③の実証)
【管理者】SC-210 テナントテーマ
┌────────────────────────────────────────────────────────┐
│ ブランド色 [■ #B5433A] ← 1色だけ指定 │
│ │
│ 自動生成された派生色: │
│ 濃 ■ 標準 ■ 淡 ■ 背景 ■ 罫線 ■ │
│ ✓ すべての組み合わせでコントラスト比を確認しました │
│ │
│ 書体 ( ● 明朝系 ○ ゴシック系 ) │
│ 余白 ( ○ 標準 ● 広い ○ とても広い ) │
│ 角丸 ( ● 弱い ○ 中 ○ 強い ) │
│ │
│ 言葉づかい │
│ 完了時の一言 [ お待ち申し上げております。 ] │
│ お客様の呼称 [ 様 ] │
│ │
│ ┌── プレビュー(リアルタイム)────────────────────┐ │
│ │ [予約ページの縮小表示が即座に変わる] │ │
│ └─────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────┘
↓
ブランド色を朱 → 苔(#5B6B4F)に変更
↓ ★ プレビューの装いが即座に変わる。文字の読みやすさは変わらない(THM-03)
↓
書体を明朝系 → ゴシック系に変更
↓ ★ 見出しの雰囲気が変わる。サイズ・行間は変わらない(THM-04)
↓
【お客様】SC-010
★ 装いが変わった予約ページ。操作は完全に同じ
↓
デモ切替バーで「SPA & THERAPY hana」に切替
↓ ★ 苔色・ゴシック・柔らかい言葉づかい。同じ構造、別の店
↓
「青葉クリニック」に切替
↓ ★ 藍・ゴシック・標準の余白・簡潔な言葉づかい
↓
★ ここで伝わること:
「同じシステムが、店ごとに別の顔になる。しかし読みやすさと操作は一切変わらない」
フローC:店頭で受ける(管理側も同じ品位)
【スタッフ】SC-100 デイシート(タブレット)
┌────────────────────────────────────────────────────────┐
│ 10月2日(金) 予約 14組 / 32名 │
│ │
│ 17:30 田中 様 2名 昼のお献立→夜 個室A [ 来店 ] │
│ 18:00 佐藤 様 2名 夜のお献立 個室B [ 来店 ] │
│ ★ 注意事項あり(甲殻類アレルギー) │
│ 18:00 山本 様 4名 特別会席 座敷 [ 来店 ] │
│ 18:30 ... │
└────────────────────────────────────────────────────────┘
↓ ★ 注意事項が行に出る。見落とせない
佐藤様が到着 → [ 来店 ] を押す
↓ ★ ステータスが「ご案内済」に。着席時刻が記録される
SC-110 顧客カルテ
★ 最上部に注意事項(甲殻類アレルギー)。畳めない
★ 来店履歴:3回目。前回の好み「日本酒は辛口」
↓
【店長】SC-101 タイムライン
★ 横=個室A / 個室B / 座敷 / カウンター、縦=時間
★ 予約ブロックはテナント色の薄い塗り。所要時間が高さ
↓
19:00 の満席にキャンセルが入る
↓
SC-120 キャンセル待ち ── ★ 2組が登録中。1組目に案内(通知プレビュー)
↓
★ ここで伝わること:
「お客様側の品位が、店頭の画面でも保たれている。別のシステムに見えない」
6. 機能要件
6.1 予約フロー(お客様側)
| ID | 要件 | 優先 |
|---|---|---|
| FR-101 | 予約フローを「メニュー → オプション・人数 → 担当・席 → 日付 → 時間 → 情報 → 支払い → 確認 → 完了」の順で構成すること。 テナント設定で不要なステップ(担当・席、支払い)を省略できること | P1 |
| FR-102 | ステップの進行状況を常時表示すること。戻れるステップはクリックで戻れること | P1 |
| FR-103 | 選択内容のサマリー(メニュー・人数・日時・金額)を、全ステップで常時表示すること(8章。PCは右固定、スマホは下部シート) | P1 |
| FR-104 | メニューを複数選択でき、合計所要時間と合計金額が選択の瞬間に更新されること | P1 |
| FR-105 | オプションを選択でき、金額に反映されること。必須オプション・排他オプションを設定できること | P1 |
| FR-106 | 人数によって金額が変わること(人数単価/固定/段階)。人数によって選べるリソース(席・部屋)が変わること | P1 |
| FR-107 | 担当を「指名なし/指名あり」から選べること。指名料が金額に反映されること | P1 |
| FR-108 | 席・部屋を任意で指定でき、指定しない場合は店側で割り当てること | P1 |
| FR-109 | 日付選択で、各日の空き具合(空きあり/残りわずか/満席/定休日)を表示すること(AVL-06) | P1 |
| FR-110 | 「最短のご案内」を日付選択の上部に常時表示し、タップで移動できること | P1 |
| FR-111 | 時間選択で、各時間帯の残り枠・利用可能リソース・所要時間の帯を表示すること | P1 |
| FR-112 | 時間帯によって金額が変わる場合、時間選択に金額を表示すること | P2 |
| FR-113 | 満席の時間帯にキャンセル待ちを登録できること | P1 |
| FR-114 | 枠選択で仮押さえ(既定10分)を作成すること(HLD-01, HLD-02) | P1 |
| FR-115 | 仮押さえの残り時間を控えめに表示すること。カウントダウンを大きく出さないこと(HLD-03) | P1 |
| FR-116 | 期限切れ時、入力内容を保持し、別の枠を選び直せば再利用できること(HLD-04) | P1 |
| FR-117 | お客様情報(氏名・電話・メール・要望)を入力できること。会員は自動入力。ゲスト予約も可能なこと | P1 |
| FR-118 | 確定直前に空き枠を再検証し、埋まっていた場合は責めない文言で案内すること(HLD-05) | P1 |
| FR-119 | ステップ遷移が100ms以下で、擬似ディレイを入れないこと | P1 |
| FR-120 | 入力途中でページを離脱しようとした場合、確認ダイアログを表示すること | P2 |
| FR-121 | お客様側を日本語/英語で表示できること(テナント設定で有効化) | P2 |
6.2 決済・規定
| ID | 要件 | 優先 |
|---|---|---|
| FR-201 | 決済方式を「事前決済(全額)/デポジット(一部)/当日払い」から、メニュー別に設定できること | P1 |
| FR-202 | 金額の内訳(メニュー・オプション・指名料・人数・デポジット・当日残額)を明示すること | P1 |
| FR-203 | カード情報の入力UIを実装し、デモでは課金処理を行わないこと(本番は決済代行のトークン方式) | P1 |
| FR-204 | キャンセル規定を、支払い画面と確認画面の両方で表示し、同意を求めること | P1 |
| FR-205 | キャンセル規定を段階的に設定できること(例:3日前まで無料/前日50%/当日100%) | P1 |
| FR-206 | キャンセル時、規定に応じた料率と金額を明示し、取り消し不可であることを伝えること | P1 |
| FR-207 | 変更時、差額(増額・減額)を明示すること | P2 |
| FR-208 | 無断キャンセルの扱い(デポジット没収・次回予約の制限)を設定できること | P2 |
6.3 完了・通知・予約管理(お客様側)
| ID | 要件 | 優先 |
|---|---|---|
| FR-301 | 完了画面に、予約番号・日時・内容・「この後の流れ」(確認メール、リマインド時刻、当日の案内)を表示すること | P1 |
| FR-302 | 完了画面からカレンダー(ics)追加・地図表示ができること | P1 |
| FR-303 | テナント設定の「完了時の一言」を表示すること(「お待ち申し上げております」) | P1 |
| FR-304 | 通知(確認・リマインド・変更・キャンセル・キャンセル待ち)の送信内容をプレビュー表示すること。デモでは送信しないこと | P1 |
| FR-305 | 通知メールのデザインがテナントテーマを反映すること(8章 通知デザイン) | P1 |
| FR-306 | 予約番号 + 電話番号(下4桁)で予約を照会できること | P1 |
| FR-307 | 予約の変更・キャンセルができ、受付期限を過ぎた場合は電話連絡を案内すること | P1 |
| FR-308 | 会員は予約履歴を確認でき、同じ内容で再予約できること | P2 |
| FR-309 | キャンセル待ちに登録でき、空きが出たら通知(プレビュー)されること | P1 |
6.4 空き枠エンジン
| ID | 要件 | 優先 |
|---|---|---|
| FR-401 | 空き枠の判定を lib/availability/ に完全に閉じ込めること(AVL-01) |
P1 |
| FR-402 | 純粋関数として実装し、現在時刻を引数で受け取ること(AVL-02) | P1 |
| FR-403 | 営業時間/定休日・臨時休業/特別営業日/担当の稼働時間/休憩/既存予約/仮押さえ/ブロック枠/前後バッファ/必要リソースの同時空き/人数と定員/受付期限/予約可能期間 をすべて考慮すること | P1 |
| FR-404 | 「なぜ埋まっているか」の理由を返すこと(AVL-04)。管理画面で確認できること | P1 |
| FR-405 | 各日の空き密度を返すこと(AVL-06) | P1 |
| FR-406 | 刻み幅(15分/30分/60分)を設定できること | P1 |
| FR-407 | 空き枠の再計算が 100ms以下で完了すること(60日分・リソース8・担当6・刻み15分) | P1 |
| FR-408 | 定員制クラスの残席を、定員 − 確定人数 − 仮押さえ人数 で算出すること | P2 |
| FR-409 | 確定直前に再検証すること(AVL-05) | P1 |
6.5 テナントテーマ(本書固有の中核)
| ID | 要件 | 優先 |
|---|---|---|
| FR-501 | テナントがブランド色を1色指定でき、派生色(濃・標準・淡・背景・罫線・状態色)が自動生成されること(THM-02) | P1 |
| FR-502 | 派生色のすべてで、テキストのコントラスト比 4.5:1(本文 7:1)を自動保証すること。保証できない場合は補正し、「補正しました」と表示すること(THM-03) | P1 |
| FR-503 | 書体系統を「明朝系/ゴシック系」から選べること(THM-04)。サイズ・行間・字間は変わらないこと | P1 |
| FR-504 | 余白を「標準/広い/とても広い」、角丸を「弱い/中/強い」から選べること(THM-05) | P1 |
| FR-505 | 言葉づかいを設定できること:完了時の一言、お客様の呼称(様/さん)、ボタンの文言(「予約する」「ご予約」「お申し込み」)、敬語の温度 | P1 |
| FR-506 | ヒーロー写真・メニュー写真・ロゴを設定できること。写真がない場合の代替(色面)が美しいこと(8章) | P1 |
| FR-507 | テーマの変更がプレビューに即座に反映され、保存後にお客様側にも即座に反映されること(THM-06) | P1 |
| FR-508 | ウィジェットにも同じテーマが適用されること(THM-07) | P1 |
| FR-509 | テーマの変更を操作ログに記録すること(SCP-06) | P1 |
| FR-510 | テーマのプリセット(3業種)を用意し、そこから開始できること | P1 |
| FR-511 | ダークモード(お客様側)を、テナントが「有効/無効/端末に従う」で設定できること。 有効時も THM-03 を保証すること | P2 |
6.6 店頭運用(スタッフ・店長)
| ID | 要件 | 優先 |
|---|---|---|
| FR-601 | デイシートで本日の予約を時間順に表示し、来店・案内・完了のステータスを1タップで更新できること | P1 |
| FR-602 | デイシートの行に、顧客の注意事項(アレルギー等)を表示すること。見落とせない位置に(SCP-05) | P1 |
| FR-603 | デイシートをタブレットで操作しやすいこと(タップ領域56px以上) | P1 |
| FR-604 | タイムラインを横=リソース/縦=時間で表示し、予約ブロックの高さを所要時間に比例させること | P1 |
| FR-605 | 予約ブロックをドラッグで移動でき、移動先が予約不可なら弾き、理由を表示すること。キーボードでも操作できること | P1 |
| FR-606 | タイムライン上でドラッグしてブロック枠を作成できること | P1 |
| FR-607 | 予約の手動作成ができ、店長は制約を無視して作成できること。無視した予約に印を付けること | P1 |
| FR-608 | 来店受付で着席時刻・完了時刻を記録し、所要時間の実績を残すこと | P1 |
| FR-609 | 顧客カルテに、来店履歴・好み・注意事項・メモを記録できること。注意事項は最上部に固定し、畳めないこと | P1 |
| FR-610 | キャンセル待ちを一覧で確認し、空きが出た際に順に案内できること(通知プレビュー) | P1 |
| FR-611 | 予約一覧を期間・ステータス・顧客名・メニューで絞り込め、CSV出力できること | P1 |
| FR-612 | 予約の変更履歴(誰がいつ何を変えたか)を保持すること | P1 |
6.7 設定・分析(管理者)
| ID | 要件 | 優先 |
|---|---|---|
| FR-701 | 店舗情報(店名、住所、電話、営業時間、定休日、臨時休業、写真、SNS)を設定できること | P1 |
| FR-702 | メニューに、カテゴリ・写真・説明・所要時間・前後バッファ・金額(人数連動)・必要リソース・対応担当・決済方式 を設定できること | P1 |
| FR-703 | オプションを作成し、メニューに紐付けられること。必須・排他を設定できること | P1 |
| FR-704 | リソース(席・部屋・設備)を登録し、定員・同時利用数・写真を設定できること | P1 |
| FR-705 | 担当のシフト・休憩・対応メニュー・指名料を管理できること | P1 |
| FR-706 | 予約ルール(受付期限・予約可能期間・刻み幅・仮押さえ時間・1組の上限人数)を設定できること | P1 |
| FR-707 | 特別営業日を設定し、営業時間・メニュー・金額を上書きできること | P2 |
| FR-708 | 定員制クラスを作成し、繰り返し開催を設定できること | P2 |
| FR-709 | 通知の文面をデザインテンプレートから編集でき、差し込み変数({{お客様名}} {{日時}} {{メニュー}} {{予約番号}} {{店名}})を使えること |
P1 |
| FR-710 | 通知の送信タイミング(確認即時/リマインド前日 N時/当日 N時間前)を設定できること | P1 |
| FR-711 | ウィジェットの設置コードを生成し、形態(ボタン/インライン/フローティング)を選べ、プレビューできること | P1 |
| FR-712 | 予約分析:稼働率(リソース別・時間帯別)、メニュー別件数・売上、キャンセル率・無断キャンセル率、流入元(ウィジェット親URL)を表示すること | P1 |
| FR-713 | 予約フローの離脱ステップを分析できること(どのステップで離脱が多いか) | P1 |
| FR-714 | 多店舗を登録し、本部で横断表示できること。店舗ごとにテーマ・設定を持てること | P2 |
| FR-715 | 設定変更・テーマ変更・予約の手動操作を操作ログに記録すること | P1 |
6.8 ウィジェット・デモ基盤
| ID | 要件 | 優先 |
|---|---|---|
| FR-801 | <script> 1行でウィジェットを設置できること(WGT-01) |
P1 |
| FR-802 | ボタン/インライン/フローティングの3形態に対応すること | P1 |
| FR-803 | iframe で描画し、親サイトのCSSと相互に影響しないこと(WGT-02) | P1 |
| FR-804 | 高さの自動調整・完了通知・閉じる を postMessage で行うこと(WGT-04) |
P1 |
| FR-805 | 親サイトのURLを流入元として記録すること(WGT-05) | P1 |
| FR-806 | ウィジェットの初期JSが60KB以下であること(WGT-07) | P1 |
| FR-807 | 模擬の店舗サイト(SC-091)に3形態を設置し、体験できること | P1 |
| FR-808 | 4ロール・3テナントをワンクリックで切り替えられること | P1 |
| FR-809 | データスコープを lib/repo/_scope.ts に集約すること(SCP-01〜05) |
P1 |
| FR-810 | 「デモをリセット」で localStorage をクリアすること | P1 |
| FR-811 | 予約・テーマ設定がリロード後も保持されること | P1 |
| FR-812 | 予約フロー中はデモ切替バーが薄くなり、マウス接近で戻ること(4章) | P1 |
| FR-813 | 「これはデモです」を全画面で明示し、確認・完了画面では強調すること。店舗名・電話番号はすべて架空とすること | P1 |
| FR-814 | 競合シミュレーション(確率発生 + 任意発生ボタン)を提供すること | P1 |
| FR-815 | ロール権限外の画面では案内画面から切り替えられること。素の404を出さないこと | P1 |
7. データ設計
型定義(lib/types/)
// ---- テナント(店舗)----
type Tenant = {
id: string
slug: string // URL用
name: string // ★ 架空
industry: 'restaurant' | 'spa' | 'clinic' | 'studio' | 'space' | 'other'
locale: { primary: 'ja'; secondary?: 'en' }
info: StoreInfo
theme: TenantTheme // ★ 8章
rules: BookingRules
cancelPolicy: CancelPolicy
payment: PaymentSettings
notifications: NotificationSettings
widget: WidgetSettings
flowSteps: ('menu' | 'options' | 'resource' | 'date' | 'time' | 'details' | 'payment' | 'confirm')[] // FR-101
isActive: boolean
}
type StoreInfo = {
address: string // 架空
phone: string // 0X-0000-0000 形式
email: string
businessHours: { weekday: number; openMin: number; closeMin: number }[]
closedWeekdays: number[]
specialClosures: string[]
specialDays: SpecialDay[] // FR-707
accessNote: string
mapUrl: string
sns: { kind: string; url: string }[]
photos: { kind: 'hero' | 'gallery'; url: string; alt: string }[]
}
// ---- ★★★ テナントテーマ(8章の中核)★★★ ----
type TenantTheme = {
brandColor: string // ★ テナントが指定する唯一の色
typeface: 'mincho' | 'gothic' // THM-04
spacing: 'standard' | 'wide' | 'extra' // THM-05
radius: 'soft' | 'medium' | 'round'
darkMode: 'off' | 'on' | 'system' // FR-511
logoUrl?: string
wording: {
honorific: '様' | 'さん'
bookVerb: string // 「予約する」「ご予約」「お申し込み」
completionMessage: string // 「お待ち申し上げております。」
tone: 'formal' | 'warm' | 'plain' // 敬語の温度。定型文の出し分けに使う
}
// ★ 算出値(保存しない):派生色は lib/theme/ で生成
}
type ResolvedTheme = { // lib/theme/resolve() の出力。CSS変数として注入
brand: { 900: string; 700: string; 500: string; 300: string; 100: string; 50: string }
onBrand: string // brand.500 の上に置くテキスト色
surface: { base: string; raised: string; sunken: string }
ink: { high: string; mid: string; low: string }
line: { strong: string; soft: string }
state: { open: string; few: string; full: string; held: string }
cta: string; onCta: string // v1.1:主要CTAの塗り(深い段)と文字
deep: string; onDeep: string // v1.1:完了画面・管理サイドバーの地と文字
contrastFixed: boolean // ★ THM-03 で補正が入ったか
contrastReport: { pair: string; ratio: number; ok: boolean }[]
}
// ---- メニュー・オプション・リソース・担当 ----
type MenuCategory = { id: string; name: string; sortOrder: number }
type Menu = {
id: string
tenantId: string
categoryId: string
name: string
description: string
photoUrl?: string
durationMin: number
bufferBeforeMin: number
bufferAfterMin: number
pricing: Pricing // ★ 人数連動(FR-106)
requiredResourceKinds: ResourceKind[]
staffIds: string[] // 対応担当(空なら誰でも)
requiresStaff: boolean
optionIds: string[]
payment: 'prepaid' | 'deposit' | 'onsite' // FR-201
depositAmount?: number
timeBandPricing?: { fromMin: number; toMin: number; delta: number }[] // FR-112
periodLabels?: string[] // v1.1:提供する営業時間帯(例:['昼'])。未指定なら全時間帯
minParty: number
maxParty: number
isActive: boolean
sortOrder: number
}
type Pricing =
| { kind: 'per_person'; unit: number }
| { kind: 'flat'; amount: number }
| { kind: 'tiered'; tiers: { upTo: number; amount: number }[] }
type MenuOption = {
id: string
tenantId: string
name: string
description: string
price: number
pricing: 'per_person' | 'flat'
isRequired: boolean
exclusiveGroup?: string // 同グループ内は排他(FR-105)
durationDeltaMin: number // 延長オプション
}
type ResourceKind = 'seat' | 'room' | 'equipment'
type Resource = {
id: string
tenantId: string
kind: ResourceKind
name: string // 「個室A」「カウンター」「ルーム1」
capacityMin: number // ★ 人数との対応(FR-106)
capacityMax: number
concurrent: number // 同時利用数
photoUrl?: string
isSelectable: boolean // お客様が指定できるか(FR-108)
sortOrder: number
}
type Staff = {
id: string
tenantId: string
name: string // 架空
role: 'staff' | 'manager'
photoUrl?: string
bio: string
menuIds: string[]
nominationFee: number
color: string // タイムライン用
isActive: boolean
}
type Shift = { id: string; staffId: string; date: string; startMin: number; endMin: number; breaks: { startMin: number; endMin: number }[] }
// ---- ルール・規定・決済・通知 ----
type BookingRules = {
slotStepMin: 15 | 30 | 60
leadTimeMin: number // 受付期限
windowDays: number // 予約可能期間
holdMinutes: number // 既定10(HLD-01)
maxPartySize: number
allowGuest: boolean
changeDeadlineDaysBefore: number
}
type CancelPolicy = {
tiers: { daysBefore: number; rate: number }[] // [{3,0},{1,0.5},{0,1}]
noShow: { forfeitDeposit: boolean; restrictNextBooking: boolean; note: string }
policyText: string // 表示用の全文
}
type PaymentSettings = { provider: 'none' | 'stripe' | 'square'; currency: 'JPY'; showBreakdown: boolean }
type NotificationSettings = {
channels: ('email' | 'line' | 'sms')[]
templates: Record<'confirm' | 'reminder' | 'change' | 'cancel' | 'waitlist', NotificationTemplate>
reminder: { daysBefore: number; atMin: number }[]
}
type NotificationTemplate = {
subject: string
body: string // 差し込み変数を含む
design: 'letter' | 'card' | 'plain' // ★ 8章 通知デザイン
}
type WidgetSettings = {
mode: 'button' | 'inline' | 'floating'
buttonLabel: string
position?: 'bottom-right' | 'bottom-left'
allowedOrigins: string[] // 本番:設置を許可するドメイン
}
type SpecialDay = { date: string; label: string; openMin?: number; closeMin?: number; menuIds?: string[]; priceDelta?: number }
// ---- 予約 ----
type ReservationStatus = 'confirmed' | 'arrived' | 'seated' | 'completed' | 'cancelled' | 'no_show'
type Reservation = {
id: string
code: string // 予約番号(KY-XXXXX-XXXX)
tenantId: string
type: 'appointment' | 'class'
// --- 内容 ---
menuIds: string[]
optionIds: string[]
partySize: number
staffId?: string // 指名
assignedStaffId?: string
resourceIds: string[] // 割り当てられた席・部屋
classSessionId?: string
// --- 時間 ---
startAt: string
endAt: string
durationMin: number
// --- 顧客 ---
customerId?: string
customer: CustomerInfo
locale: 'ja' | 'en'
// --- 金額(★ 算出値だが確定時点の値を保存)---
amounts: {
menu: number; options: number; nomination: number
subtotal: number; deposit: number; onsite: number; total: number
}
paymentStatus: 'unpaid' | 'deposit_paid' | 'paid' | 'refunded'
// --- 状態 ---
status: ReservationStatus
arrivedAt?: string; seatedAt?: string; completedAt?: string
cancelledAt?: string; cancelReason?: string; cancelFeeRate?: number; cancelFee?: number
// --- 出所 ---
source: { kind: 'web' | 'widget' | 'staff' | 'phone'; referrerUrl?: string } // FR-805
isForced: boolean // 制約無視(FR-607)
note: string
history: { at: string; by: string; field: string; before: string; after: string }[]
createdAt: string
}
type CustomerInfo = { name: string; nameKana: string; phone: string; email: string; request: string }
// ---- 仮押さえ ----
type Hold = {
id: string
tenantId: string
staffId?: string
resourceIds: string[]
partySize: number
startAt: string
endAt: string
expiresAt: string // ★ HLD-01
draft: Partial<Reservation> // ★ 期限切れ後も入力を再利用(HLD-04)
createdAt: string
}
type BlockedSlot = { id: string; tenantId: string; resourceId?: string; staffId?: string; startAt: string; endAt: string; reason: string }
type ClassSession = { id: string; tenantId: string; name: string; staffId: string; startAt: string; durationMin: number; capacity: number; price: number; resourceIds: string[] }
type Waitlist = {
id: string
tenantId: string
desiredDate: string
desiredRange: { fromMin: number; toMin: number }
menuIds: string[]
partySize: number
customer: CustomerInfo
notifyVia: 'email' | 'line' | 'sms'
status: 'waiting' | 'notified' | 'converted' | 'expired'
createdAt: string
}
// ---- 顧客・カルテ ----
type Customer = {
id: string
tenantId: string
name: string; nameKana: string; phone: string; email: string
isMember: boolean
visitCount: number
noShowCount: number
lastVisitAt?: string
// ★ カルテ(SCP-05)
cautions: string[] // アレルギー・注意事項。最上部に固定(FR-609)
preferences: string[] // 好み
notes: { at: string; by: string; body: string }[]
createdAt: string
}
// ---- 空き枠(lib/availability/ の契約)----
type AvailabilityInput = {
tenant: Tenant
menus: Menu[]; options: MenuOption[]; resources: Resource[]
staff: Staff[]; shifts: Shift[]
reservations: Reservation[]; holds: Hold[]; blocked: BlockedSlot[]
selection: { menuIds: string[]; optionIds: string[]; partySize: number; staffId?: string; resourceId?: string }
fromDate: string; toDate: string
now: string // ★ AVL-02
}
type AvailabilityResult = {
days: DayAvailability[]
earliestAt?: string // ★ 最短のご案内(FR-110)
}
type DayAvailability = {
date: string
isClosed: boolean
density: 'open' | 'few' | 'full' | 'closed' // ★ AVL-06
openRatio: number
slots: Slot[]
}
type Slot = {
startAt: string
endAt: string
state: 'open' | 'few' | 'full' | 'held' | 'closed' | 'past_deadline'
remaining: number
availableResources: { id: string; name: string }[]
candidateStaffIds: string[]
priceDelta?: number // FR-112
reason?: 'reserved' | 'held' | 'off_shift' | 'break' | 'closed' | 'blocked' | 'no_resource' | 'capacity' | 'buffer' | 'lead_time' | 'out_of_window'
}
// ---- 分析(算出値)----
type FunnelStats = { step: string; entered: number; exited: number; dropRate: number } // FR-713
type OccupancyStats = { resourceId: string; date: string; bookedMin: number; openMin: number; rate: number }
// ---- 監査 ----
type AuditLog = {
id: string; tenantId: string; actorId: string
action: 'update_theme' | 'update_menu' | 'update_rules' | 'update_policy' | 'force_booking'
| 'move_reservation' | 'cancel_reservation' | 'update_notification' | 'export_csv'
targetType: string; targetId: string
changes: { field: string; before: unknown; after: unknown }[]
createdAt: string
}
テーマ解決の実装(7章の中核)
v1.1:段の明度・彩度・上限・検査するペアは 8.2 の表が正。 resolveTheme(theme, 'light'|'dark') は brand 6段・onBrand・cta/onCta・deep/onDeep・surface・ink・line・state・contrastFixed・contrastReport(pair・ratio・min・ok・fixed)を返す純粋関数。themeVars() はこれと余白・角丸・見出し書体のプリセットを CSS 変数の辞書にし、themeCss() は darkMode(off/on/system)に応じた CSS 文字列を返す。
v1.1 で追加・変更した型:Tenant.nameLatin / tagline / quote / intro / tags、StoreInfo.nearestStation、businessHours[].label(昼・夜など)、Resource.description、Staff.title、Amounts.timeBand(時間帯・特別営業日の差額)、Hold.byOther、DayAvailability.outOfWindow、Waitlist.notifiedAt、FunnelEvent { tenantId; sessionId; step; at }、AuditLog.actorLabel、監査アクションに update_store / update_resource / update_staff / update_payment / update_widget / create_reservation / update_reservation / update_customer / create_block / notify_waitlist を追加。
シードデータ(lib/seed/)
| ファイル | 内容 | 件数 |
|---|---|---|
tenants.ts |
3テナント(懐石 いちょう/SPA & THERAPY hana/青葉クリニック)。テーマ・言葉づかい・写真をすべて設定済み | 3件 |
menus.ts options.ts |
メニュー(業種ごとに世界観のある名前と説明)、オプション | メニュー24 / オプション18 |
resources.ts |
席・部屋・設備(個室A/B、座敷、カウンター、ルーム1〜3、診察室1〜2) | 14件 |
staff.ts shifts.ts |
担当(架空)、シフト(今後60日) | 12名 |
reservations.ts |
予約(直近3日は7〜8割埋まり、土日夕方は満席、平日昼は空き。生成規則は 14.7) | 約850件 |
holds.ts blocked.ts |
仮押さえ(数件)、ブロック枠 | — |
waitlist.ts |
キャンセル待ち(満席日に登録済み) | 8件 |
customers.ts |
顧客(注意事項ありを数名、来店回数を分散) | 180名 |
classSessions.ts |
定員制クラス(スパのヨガ、クリニックの説明会) | 20件 |
photos/ |
権利処理済みの写真(ヒーロー・メニュー・リソース)。docs/assets-license.md に記録 |
— |
シード作成のルール(品質を左右する)
- 店名・住所・電話・担当名はすべて架空。 電話は
03-0000-0000形式 - メニュー名と説明文を、業種の世界観で書き分ける。 懐石は季節と器の言葉、スパは身体と時間の言葉、クリニックは明確な施術名。「メニューA」を1つも残さない
- 画像は付録Cのとおり。全メニュー・全席・全スタッフに画像を入れる(v1.1)。 取得元・ライセンス・生成プロンプトを
docs/assets-license.mdに全件記録。写真がない場合の代替表示(色面+名称)の実装は残す - 店・メニュー・オプション・席・スタッフ・規定・通知文面は付録Aの値をそのまま使う
- 3テナントで、余白・角丸・書体・言葉づかいが明確に違うこと(4章の表どおり)
- 予約の密度に濃淡をつける。 今日から3日は7〜8割、土日夕方は満席、平日昼は空き。カレンダーの空き具合表示が意味を持つこと
- 「残りわずか」の枠を各テナントに数個作る
- 注意事項(アレルギー等)のある顧客を数名作る(デイシートとカルテの実演用)
- キャンセル待ちが登録された満席枠を各テナントに1つ用意する
- 各テナントの3ペルソナ(会員・ゲスト・再来)を用意する
- 日付は現在日時からの相対で生成する
ストアとリポジトリ
lib/
├── types/ seed/
├── availability/ # ★ 空き枠。純粋関数(AKIMA と同構造)
│ ├── engine.ts rules.ts shift.ts buffer.ts resource.ts capacity.ts density.ts reason.ts
├── theme/ # ★ テナントテーマ。純粋関数
│ ├── resolve.ts # 7章のコード参照
│ ├── contrast.ts # WCAG コントラスト比
│ ├── color.ts # OKLCH 変換
│ ├── presets.ts # 3業種のプリセット(FR-510)
│ └── inject.ts # CSS変数への注入
├── pricing/ # 金額計算。純粋関数(人数連動・オプション・指名料・時間帯)
├── hold/ # 仮押さえ・競合シミュレーション
├── time/ # 分単位ユーティリティ
├── ics/ wording/ # ics生成/言葉づかいの出し分け(FR-505)
├── widget/ # postMessage プロトコル
├── i18n/ # ja / en 辞書(FR-121)
├── calc/ # 稼働率・離脱ステップ・キャンセル率
├── store/ { session, tenant, data, hold, ui }
└── repo/ # ★ コンポーネントが触るのはここだけ
├── _delay.ts _scope.ts
├── availability.ts reservations.ts holds.ts waitlist.ts
├── tenants.ts theme.ts menus.ts options.ts resources.ts staff.ts
├── customers.ts notifications.ts widget.ts analytics.ts logs.ts
規約(厳守)
- 全メソッドを
asyncで定義。戻り値は{ ok: true; data: T } | { ok: false; error: string } - コンポーネントから Zustand ストアを直接参照しない
- 空き判定を
lib/availability/の外に書かない(AVL-01) - テナント分岐をコンポーネントに書かない。 テーマは CSS 変数、言葉づかいは
lib/wording/から取る(THM-01) - 金額計算を
lib/pricing/に集約する。 コンポーネントで足し算しない lib/availability/lib/theme/lib/pricing/lib/time/は純粋関数のみ。new Date()を内部で呼ばない- スコープ適用(
_scope.ts)を全メソッドが必ず通す - 空き枠の再計算・ステップ遷移・テーマ切替に擬似ディレイを入れない
8. デザイン要件
本章は本書の中核であり、全章の中で最も厚い。 1章のとおり、予約ページは店の第一印象である。本章の指定は装飾ではなくプロダクトの商品価値そのものとして扱うこと。「動くが8章を満たしていない」は未完成である。 v1.1:見た目の正解は「参考画像の書き起こし(8.1)」である。 8章の数値と 8.1 が食い違って見える場合は、8.1 の見た目を優先し、数値は本章に書いた v1.1 の値を使う。
8.0 デザイン原則(6つ)
すべての判断は、この6原則に照らして行う。迷ったら原則に戻る。
| # | 原則 | 意味 | 反する例 |
|---|---|---|---|
| 1 | 急がせない | 予約は買い物ではなく、来店の約束。カウントダウン・点滅・「残り○席!」で煽らない | 大きな赤い残り時間、「今すぐ」「お早めに」 |
| 2 | 聞かれる前に答える | 空き・金額・時間・規定を、必要になる瞬間より前に見せる | 確認画面で初めて出る金額 |
| 3 | 一度に一つ | 1画面で決めることは1つ。選択肢は絞り、余白で呼吸させる | 日付と時間とメニューが同じ画面に並ぶ |
| 4 | 店の装いで | 色・写真・言葉は店のもの。システムの都合を見せない | 汎用の青いボタン、「送信」という文言 |
| 5 | 品位は変えない | 装いが変わっても、読みやすさ・操作・静けさは不変 | テナント色で本文が読めなくなる |
| 6 | 読みやすさが先(v1.1) | 世界観のための細さ・小ささ・薄さより、読めることを優先する。細い書体・小さい文字・薄いグレーを使わない | 12px の説明文、ウェイト300、#999 の補助文字 |
8.1 アートディレクションと参考画像の書き起こし
「暦をめくるように、静かに」 ── 面が滑らかに入れ替わり、決めたことが下に積み重なり、最後に一枚の予約票になる。
- 面(ステップ)が主役。 ページ遷移ではなく、面が横に滑る。決めたことはサマリーに残る
- 紙の質感。 生成りの地、罫線の細さ、明朝の見出し。印刷物の落ち着き
- 写真は大きく、質を揃える。 灯りを落とした温かい写真(懐石)/明るい木とリネン(スパ)/白く清潔な空間(クリニック)。全メニュー・全席・全スタッフに写真を入れる(8.9)
- 色はブランド色1色。 それ以外は無彩色と、空き状態の3色だけ
- モーションは「所作」。 装飾ではなく、状態の変化を静かに伝える
参考画像の書き起こし(v1.1 で追加・この見た目を忠実に再現する)
参考画像は、高級予約アプリのUIキット(ブランド名「AURA RESERVE」)である。画像ファイルは docs/design-reference.png(初版と同じ画像。手元になくても、本節の書き起こしだけで再現できるように書いてある)。生成り(#F5F1EA 前後)の地、深い緑(#1F2B25 前後)の塗りボタン、細身の欧文セリフ/明朝の見出し、灯りの落ちた写真、角丸の白いカード、細い罫線で構成される。スマホ6画面と、PCの管理画面1枚がある。KOYOMI では、深い緑をテナントのブランド色の深い段(--brand-cta)に置き換え、欧文セリフを Shippori Mincho B1(ゴシック系テナントは Zen Kaku Gothic New)に置き換えて再現する。
| # | 参考画像の画面 | 見えている要素 | KOYOMI での対応 |
|---|---|---|---|
| 1 | ホーム | 上部中央にロゴ(大きな字間の広いセリフ+小さな欧文)、右に検索アイコン。全幅の写真ヒーローに大文字セリフの見出しと一行の説明、その下に白い角丸の検索バー。写真の下に丸い枠のアイコン4つ(レストラン・ホテル・スパ・体験)と小さなラベル。「Featured for You」と「See All」、大きな写真カード(ハートのアイコン)、店名と評価。下部にタブバー | 店舗ページ(SC-001):中央ロゴ(店名+欧文)、左に予約確認アイコン・右に会員アイコン。ヒーローに店のキャッチと下部スクリム、白い角丸の「最短のご案内」バー(検索バーの位置)。丸い枠のアイコン4つ(メニュー/営業時間/アクセス/予約の確認)。評価・ハート・タブバーは作らない(口コミはスコープ外、予約ボタンの下部固定を優先) |
| 2 | 店の詳細 | 全幅の写真、戻る・ハート・共有。写真の小窓の横並び。店名+評価、グレーの小さな説明、タグのチップ3つ、斜体セリフの引用文、本文、アイコン付きの2行(本日の営業・所在地)、全幅の深い緑のボタン「Select a Date」 | 店舗ページの中段:写真の小窓(ギャラリー)、店名・最寄り、タグのチップ、店の一言を見出し書体の引用で、紹介文、本日の営業・所在地の情報カード、予約ボタン(スマホは下部固定の深い塗り) |
| 3 | 日付選択 | 戻る矢印、中央の見出し「Select a Date」+小さな副題、月ヘッダー(‹ May 2025 ›)、曜日行、日付、選択日は深い緑の塗り、下に**「Today / Tomorrow / This Weekend」の枠線チップ**、最下部に写真+引用文(Good food brings people together.)+短い線 | SC-013:中央見出し+副題、最短のご案内、カレンダー(選択日は --brand-cta の塗り・角丸は --radius-md)、「今日/明日/今週末」の枠線チップ、凡例、面の下に写真+店の一言の帯(PhotoQuote) |
| 4 | 時間選択 | 中央見出し「Select a Time」+日付、「Lunch」「Dinner」の小見出し、時間のボタン、選択は深い緑、凡例(Available / Limited / Unavailable の点)、最下部に写真+引用文 | SC-014:中央見出し+日付、「昼」「夜」(または午前・午後)の小見出し、凡例、写真+店の一言の帯。時間は仕様どおり縦の行(所要時間の帯のため)。行の見た目は白い面・細い罫線 |
| 5 | 入力 | 中央見出し「Your Details」+説明、白い面+細い枠の入力欄(氏名・メール・電話)、人数の −/+ 丸ボタン、要望のテキストエリアと 0/200 の文字数、全幅の深い緑のボタン、その下に小さな一言「You won't be charged yet.」 | SC-015:白い面+細い枠の入力欄、要望欄に文字数、CTA の下に「まだ予約は確定していません」 |
| 6 | 完了 | 全面が深い緑。上部中央にロゴ、細い円の中のチェック、大きなセリフ「Reservation Confirmed!」、副題、白いカード(左に写真の小窓、右に店名と所在地、下にアイコン付きの行:日付・時刻・人数・特別な要望)、白い塗りボタン「Add to Calendar」、白い枠線ボタン「View My Reservations」、最下部に字間の広い大文字の標語 | SC-018:全面 --brand-deep、店名ロゴ、円+チェックの描画、「ご予約を承りました」、白い予約カード(写真の小窓・店名・最寄り・日付・時刻・人数・メニュー・席)、予約番号とコピー、「この後の流れ」の半透明の箱、白い塗りの「カレンダーに追加」、白い枠線の「地図を見る」「予約を確認する」、最下部に店の一言と欧文・電話番号 |
| 7 | 管理画面(PC) | 深い緑の左サイドバー(上部中央にロゴ、アイコン付きのメニュー、選択中は少し明るい面)、生成りのメイン、セリフの見出し「Reservations」+小さな副題、右上に深い緑の「+ New Reservation」、日付・店舗・状態の枠付きの絞り込み、白いパネルの表(時刻・名前・人数・店舗・状態バッジ・操作 ⋯)、右に**「Today's Overview」のパネル**(大きな数字4つ:総予約・確定・保留・キャンセル、下に細い棒グラフ) | SC-200:--brand-deep のサイドバー、見出し「予約」+副題、「+ 新規予約」、日付・席・状態の絞り込み、予約の表(状態は色付きバッジ)、右に「本日の概要」(予約・ご来店中・これから・キャンセルの数字+時間帯別の人数の細い棒) |
姉妹プロジェクトとの差別化(重要) AKIMA=丸ゴシック・青みの白・時間を面積で/ KAMIWAZA=欧文セリフ+細ゴシック300・温かいニュートラル・写真主導/ HIREBASE=明朝700・書類的余白。 KOYOMI=明朝B1(テナントにより角ゴシック)・生成り・ブランド色1色(深い段で塗る)・面が滑る。 3つの予約系を並べたとき、KOYOMI だけが「テナントで装いが変わる」ことが一目で分かること。
8.2 カラーシステム
固定トークン(テナントが変えられない)
:root {
/* 地:生成り */
--surface-base: #F8F6F2;
--surface-raised: #FFFFFF;
--surface-sunken: #F0EDE7;
/* 墨:純黒にしない(v1.1:mid・low を濃くした) */
--ink-high: #1E1B18; /* 本文・見出し */
--ink-mid: #4A4540; /* 補助(説明文・ラベル) */
--ink-low: #67625B; /* 非活性・未選択(4.5:1 以上を保証) */
--line-strong: color-mix(in oklch, var(--ink-high) 18%, var(--surface-base));
--line-soft: color-mix(in oklch, var(--ink-high) 8%, var(--surface-base));
/* 空きの状態:ブランド色に依存しない */
--state-few: #B08A3E; /* 残りわずか(印・枠) */
--state-few-text: #8A6A2A; /* 残りわずか(文字。#B08A3E は文字だと 3.1:1 で読めないため別に持つ) */
--state-full: var(--ink-low);
/* 注意(店頭のカルテ・アレルギー)。お客様側では使わない */
--caution: #A6473B;
--caution-bg: #F7ECE9;
}
ダークモードの固定トークン:地 #161513 / #1E1C19 / #111009、墨 #EDE9E2 / #C4BEB5 / #9A948B、残りわずか(文字)#D9B46A。
テナントトークン(lib/theme/resolve() が生成し、CSS変数として注入)
ブランド色(1色)を OKLCH に変換し、色相を保ったまま明度 L を段階化する。彩度は元の彩度 C に倍率を掛け、深い段には上限を設ける(鮮やかな赤が血のような色にならないように)。
| トークン | 用途 | ライト(L/C倍率/C上限) | ダーク(L/C倍率/C上限) |
|---|---|---|---|
--brand-900 |
最も濃い段 | 0.22 / 0.85 / 0.05 | 0.92 / 0.3 / – |
--brand-700 |
ブランド色の文字(リンク) | 0.38 / 1.0 / 0.10 | 0.80 / 0.7 / – |
--brand-500 |
印・選択枠・フォーカス・飾り罫 | 0.52 / 1.0 / – | 0.72 / 0.85 / – |
--brand-300 |
所要時間の帯・グラフの淡い棒 | 0.72 / 0.7 / – | 0.50 / 0.8 / – |
--brand-100 |
タイムラインの予約ブロック | 0.92 / 0.35 / – | 0.28 / 0.45 / – |
--brand-50 |
選択中の背景・写真なしの色面 | 0.97 / 0.15 / – | 0.22 / 0.3 / – |
--brand-cta |
主要CTA・選択中の日付・トグルの塗り(v1.1) | 0.30 / 0.9 / 0.06 | 0.82 / 0.6 / 0.08 |
--on-cta |
CTA の上の文字 | #FFFFFF |
地の色 #161513 |
--brand-deep |
完了画面の全面・管理サイドバー(v1.1) | 0.27 / 0.7 / 0.045 | 0.24 / 0.6 / 0.04 |
--on-deep |
深い地の上の文字 | #F3EFE7 |
#F3EFE7 |
--on-brand |
brand-500 の上の文字 | 白で 4.5:1 を満たせば白、でなければ --ink-high |
同 |
--state-open |
空き(●)の印 | brand-500(面に対し 3:1 を保証) | 同 |
--state-held |
他のお客様が選択中 | brand-500 と ink-mid を OKLab で 1:1 に混ぜた色 | 同 |
3プリセットで生成される実際の値(ライト):
| プリセット | 入力 | 900 | cta | deep | 700 | 500 | 300 | 100 | 50 |
|---|---|---|---|---|---|---|---|---|---|
| 朱(飲食) | #B5433A |
#2E100D |
#47211D |
#3A1D1A |
#6E2923 |
#AF3D35 |
#DF8B80 |
#FFDBD6 |
#FFF2F0 |
| 苔(スパ) | #5B6B4F |
#131E0A |
#26321C |
#202A19 |
#39482D |
#5F6F53 |
#9DA994 |
#E0E7DC |
#F3F6F1 |
| 藍(クリニック) | #2F4A6D |
#091B31 |
#182E4B |
#17273C |
#294366 |
#4E6B90 |
#91A7C3 |
#DAE6F5 |
#F1F6FC |
コントラストの自動検査と補正(THM-03):次のペアを検査し、足りなければ 文字側の明度を地から遠ざける方向へ 0.01 ずつ動かして基準を満たすまで補正する(CTA は CTA の塗り側を動かす)。結果を contrastReport(ペア名・比率・基準・OK・補正したか)として返し、管理画面に一覧表示する。補正が1件でもあれば「明度を補正しました(N か所)」を表示する。
| ペア | 基準 |
|---|---|
| 本文 / 地、本文 / 面 | 7:1 |
| 補助文 / 地、ラベル / 地 | 4.5:1 |
| CTA文字 / CTA | 4.5:1 |
| ブランド上の文字 / ブランド500 | 4.5:1 |
| ブランド文字(リンク)/ 地 | 4.5:1 |
| 本文 / ブランド淡(100)、本文 / 選択背景(50) | 7:1 |
| 空きの印 / 面 | 3:1(非テキスト。形と文字も併記する) |
| 深い地の文字 / 深い地 | 7:1 |
| 残りわずか(文字)/ 面 | 4.5:1 |
単体テスト:#B5433A #5B6B4F #2F4A6D #FFEB3B #00FFFF #FF00FF #111111 #F5F5F5 #FF6F00 #7C4DFF #8BC34A #E91E63 の12色 × ライト/ダークで、全ペアが基準を満たすこと。
余白・角丸のプリセット(THM-05)
- 余白:
--space-unitを standard 8px / wide 10px / extra 12px。--sp-1〜16は unit × 0.5/1/1.5/2/2.5/3/4/6/8 - 角丸
--radius-sm/md/lg:soft 2/4/8px / medium 4/8/14px / round 8/14/24px
配色ルール
| ID | ルール |
|---|---|
| CLR-01 | お客様側で色を持つのは「ブランド色の段」「空きの状態3色」「リンク」だけ。 それ以外は無彩色 |
| CLR-02 | ブランド色の使用箇所を限定する: 主要CTA・選択中の日付(--brand-cta の塗り)、選択状態の枠(brand-500)、進捗、空き(open)の印、見出しの飾り罫、完了画面の全面(--brand-deep。v1.1 で許可)。それ以外の背景に大面積で塗らない |
| CLR-03 | 本文は常に --ink-high。ブランド色で本文を書かない |
| CLR-04 | 満席を赤にしない。 赤(--caution)は店頭の注意事項にだけ使う |
| CLR-05 | すべてのブランド色に対して、コントラスト比を自動検査・補正する(THM-03)。検査結果を管理画面に表示する |
| CLR-06 | 写真の上にテキストを置く場合、必ず下部にグラデーションのスクリムを敷く(linear-gradient(to top, rgba(30,27,24,.72), transparent 60%)) |
| CLR-07 | ダークモード時も、地を純黒にしない(#161513)。ブランド色は明度を上げて再解決する |
プリセット(3業種)
| プリセット | ブランド色 | 書体 | 余白 | 角丸 | 敬語の温度 | 想定 |
|---|---|---|---|---|---|---|
| 朱(しゅ) | #B5433A |
明朝系 | 広い | 弱い | formal | 和食・料亭・呉服 |
| 苔(こけ) | #5B6B4F |
ゴシック系 | 広い | 中 | warm | スパ・エステ・茶室・自然体験 |
| 藍(あい) | #2F4A6D |
ゴシック系 | 標準 | 弱い | plain | クリニック・スタジオ・士業 |
8.3 タイポグラフィ(v1.1 で大きく・太く・濃く改訂)
書体系統(THM-04)
| 系統 | 見出し | 本文・UI | 数値 |
|---|---|---|---|
| 明朝系 | Shippori Mincho B1 600 | Zen Kaku Gothic New 500(強調・ボタンは 700) | DM Mono 500 |
| ゴシック系 | Zen Kaku Gothic New 700 | Zen Kaku Gothic New 500(強調・ボタンは 700) | DM Mono 500 |
next/font/googleで読み込む:Shippori Mincho B1(500, 600)/Zen Kaku Gothic New(400, 500, 700)/DM Mono(400, 500)。和文2書体はpreload: false(字形が多いため)、display: swap、フォールバックに Hiragino / Yu を指定- 本文の既定ウェイトは 500(
body { font-weight: 500 })。Zen Kaku Gothic New の 400 は画面で細く見えるため使わない - 見出しの太さは CSS 変数
--heading-weight(明朝 600/ゴシック 700)でテーマから注入する。.font-heading { font-family: var(--font-heading); font-weight: var(--heading-weight); line-height: var(--heading-leading); letter-spacing: var(--heading-tracking) }(行間 明朝1.4/ゴシック1.35、字間 明朝0.04em/ゴシック0.02em) - 見出しだけが系統で変わる。本文・UI・数値は共通。
タイプスケール(v1.1)
:root {
--fs-display: clamp(30px, 2.2vw + 22px, 42px); /* 店のキャッチ・完了メッセージ */
--fs-title: clamp(24px, 1.2vw + 19px, 30px); /* ステップの見出し */
--fs-lead: 19px; /* メニュー名・リード */
--fs-body: 17px; /* 本文 */
--fs-ui: 16px; /* ボタン・入力・行の主文 */
--fs-meta: 14.5px; /* 補助の説明 */
--fs-label: 13.5px; /* ラベル(字間 .04em) */
--fs-time: 19px; /* 時間枠の時刻(Mono) */
--fs-price: 22px; /* 金額(Mono) */
--fs-code: 15px; /* 予約番号(Mono・字間 .06em) */
}
| 項目 | 指定 |
|---|---|
| 最小の文字サイズ | お客様側・管理側とも 12px 未満を使わない。 説明文は 14.5px 以上。欧文の飾り(t-eyebrow)だけ 12px・字間 .2em・大文字 |
| 本文の行間 | 1.85(英語表示は 1.6) |
| 字間 | 本文 0.02em/ラベル 0.04em(v1.0 の 0.08em は細く見えるため詰めた)/予約番号 0.06em |
| 1行の最大文字数 | max-width: 40em(17px で 1行 約37〜39文字) |
| 両端揃え | 使わない |
| 禁則 | line-break: strict |
| 数値 | font-variant-numeric: tabular-nums(.font-num) |
| 金額 | ¥16,500(記号は半角、3桁区切り) |
| 時刻 | 18:00(ゼロ埋めなしの時) |
| 管理側 | 本文 15px・行間 1.6、表のセル 14.5px・行高 40px、表の見出し 13px |
見出しの装飾
ステップの見出し(--fs-title)は中央寄せで、文字の左にブランド色の短い縦罫(2px × 1em、brand-500)を置く。飾り罫以外の装飾(下線・背景)は使わない。見出しの下に --fs-meta の副題を1行。
8.4 スペーシングとレイアウト
| 項目 | 定義 |
|---|---|
| 予約フロー(PC ≥768px) | 最大幅 1040px の中に 2カラム:左 面(最大 640px・白い面・角丸 lg・罫線 soft・内側余白 --sp-8)/右 サマリー(320px・sticky) |
| 予約フロー(スマホ) | 1カラム。面は地の上に直接置く(白い面で囲まない)。サマリーは下部の固定シート(畳んだ1行+引き上げハンドル+CTA。セーフエリア考慮)。本文の下余白 180px |
| 予約フローの上部 | 高さ 56px(PC 64px)の3分割:左「‹ 戻る」(最初の面では「‹ お店のページ」)/中央に店名(見出し書体 15〜17px)+欧文(店名に欧文が含まれる場合は出さない)/右「English」。その下にステップインジケータ |
| 店舗ページ | ヘッダー(sticky・高さ 64/72px・半透明の地+ぼかし)、ヒーロー全幅(56vh・最小 380px・最大 640px)、本文は最大 1080px |
| 確認・完了 | 予約票は最大 560px。完了画面は全面 --brand-deep、内容は最大 560px 中央 |
| 主要CTA | 高さ 56px、スマホは幅いっぱい・画面下部に固定、PC は最小 240px |
| 高さ | 100dvh(100vh を使わない)。デモ切替バーの高さ --demo-bar-h: 44px を body の上余白に取る(ウィジェットでは 0) |
| 影 | 原則使わない。例外:スマホのサマリーシート、写真カード、モーダル、ドラッグ中のブロック |
| 管理画面 | 左サイドバー 240px(--brand-deep・sticky)+メイン。スマホは上部バー(52px)+ドロワー |
| デイシート | 行高 72px、ステータスボタン 56px |
| タイムライン | 1時間 = 64px、リソース列幅 200px |
8.5 コンポーネント仕様(お客様側)
スタートページ(/・v1.1 で追加・デモの入口)
- 地
#F4F1EB。見出しは 「予約サイト」(明朝 34/44px)、上に小さく「体験デモ」、下に「お店のホームページから、お客様がネットで予約する画面の見本です。業種を選んで、実際に予約をしてみてください。入力した内容はこの画面の中だけに保存され、本当の予約や連絡は発生しません。」 - 使い方の3ステップ(番号の黒丸付きカード3枚):①業種を選ぶ ②お客様として予約する ③お店側の画面を見る(上のバーの「お客様」を「スタッフ」に切り替えると、入った予約が見られます)
- 「業種を選んで予約してみる」:3枚のカード(写真 16:10 → 業種名 19px → 業態の説明 → 「例:〇〇(架空のお店)」→「このお店で予約してみる →」)
- 飲食店の予約サイト/和食・コース料理のお店(個室・カウンター)/例:懐石 いちょう
- スパ・マッサージの予約サイト/エステ・リラクゼーション(担当者を指名)/例:SPA & THERAPY hana
- 美容クリニックの予約サイト/自由診療の外来(医師・施術を選ぶ)/例:青葉クリニック 美容外来
- 「お店側の画面も見られます」:「お店のホームページに予約ボタンを付けた例」「今日の予約を確認する画面」「お店の設定・管理画面」(各1行の説明付き)
- 最下部に破線枠の「これはデモです…」
店舗ページ(SC-001)
| コンポーネント | 仕様 |
|---|---|
| ヘッダー | 3分割:左 予約確認アイコン(スマホ)/「メニュー・営業案内・アクセス」(PC)、中央に店名(見出し書体 22/26px・字間 .12em)+欧文(12px・字間 .2em)、右 会員アイコン・「予約の確認」・予約ボタン(PC) |
| ヒーロー | 写真全幅、下部スクリム。左下に欧文(eyebrow)→ 店のキャッチ(h1・--fs-display) → タグを「/」区切り → 白い角丸の「最短のご案内」バー(カレンダーアイコン、1行目ラベル「最短のご案内(メニュー名・〇名様)」、2行目「9月24日(木) 11:30〜」、右に →。押すとそのメニューと日付で予約フローへ) |
| 丸いアイコンの入口 | 48px の白い丸(罫線 soft)にアイコン、下にラベル:メニュー名詞(お献立/メニュー/施術)・営業時間・アクセス・予約の確認。4列 |
| 写真の小窓 | ギャラリー写真+メニュー写真から最大6枚、横スクロール(108×76/PC 152×104) |
| 店について | 左:店名(h2)・最寄り・タグのチップ・店の一言を見出し書体の引用(「」付き)・紹介文/右(PC):情報カード(本日の営業・所在地+予約ボタン) |
| メニュー | 見出し(縦罫付き)+右に「予約する ›」。カテゴリごとに 2列(PC)/1列、写真 4:3(影 card)→ 名称(見出し書体)・説明2行 / 右に金額(Mono)と「1名・90分」。カードを押すとそのメニューを選んだ状態で予約フローへ(/book?menu=ID) |
| 営業情報・アクセス | 白い帯の中に2列:曜日ごとの営業時間の表(定休日は ink-low)、臨時休業・特別営業の注記/住所・最寄り・案内文・地図リンク・電話 |
| フッター | 店名・メール・デモ明示の破線枠・「予約サイトの体験デモ(ソウゾウ合同会社)・写真のクレジット」 |
| 予約ボタン(固定) | スマホ:下部固定 56px(半透明の地+ぼかしの上)。PC:ヘッダー右。文言はテナント設定(「ご予約」等) |
予約フロー共通
| コンポーネント | 仕様 |
|---|---|
| ステップインジケータ | 5段:お献立(メニュー/施術)・人数とお席・日時・ご連絡先・ご確認(文言は付録B)。スマホ:5本の細い線(到達済みは brand-500)+「3 / 5 日時」。PC:番号付きの横並び、現在は ink-high+下に 2px のブランド線、到達済みは ink-mid でクリックして戻れる |
| 面 | PC は白い面(角丸 lg・罫線 soft・影なし)。スマホは地の上 |
| ステップ見出し | 中央寄せ・縦罫付き(8.3) |
| サマリー(PC 右固定) | 上に写真の小窓 64px(ヒーロー写真)+「ご予約内容」+店名/アイコン付きの行が積まれる:メニュー(名称を縦に)・人数・オプション・日時(「9月30日(水) 17:30〜20:00」)・席(未指定は「おまかせ」)・担当(指名なしは「どなたでも」)/未決定は ink-low で「未選択」/下に所要時間と合計(--fs-price Mono・カウント変化)、「うち事前のお支払い ¥6,600」/主要CTA/CTA の直上に不足項目「あと1項目:ご来店日」、CTA の下に添え書き |
| サマリー(スマホ下部シート) | 畳み:「夜のお献立 ・ 2名様 ・ ¥33,000」+上向き矢印。押すと PC と同じ内容が開く(grid-template-rows のアニメーション 280ms)。その下に不足項目・CTA・添え書き |
| 主要CTA | 高さ 56px、--brand-cta 塗り、--on-cta の文字(700)、角丸 md、字間 .06em。押下で 2% 縮む(80ms)。無効は不透明度 45% |
| 副CTA | 枠線(line-strong)のみ、高さ 48px |
| 写真+店の一言の帯(v1.1) | 日付・時間の面の最下部。写真(日付はギャラリー、時間はヒーロー)16:10(PC 16:7)、スマホは左右いっぱい、スクリムの上に店の一言(見出し書体・白・2行)と短い白線 |
メニュー選択(SC-010)
| コンポーネント | 仕様 |
|---|---|
| カテゴリ切替 | 「すべて」+カテゴリの下線タブ(選択中は ink-high+下に 2px のブランド線) |
| メニューカード | 白い面・角丸 lg・内側 8px。写真 4:3(角丸 lg)→ 名称(見出し書体 --fs-lead)→ 説明2行 → 「90分 ・ ¥8,800 / 1名」(Mono)。選択で 2px の brand-500 の輪郭+右上に深い塗りの丸いチェック。未選択の写真は彩度 −10%。2列(スマホ 1列)。複数選択可 |
| 下の注記 | 「複数のメニューを組み合わせることもできます。所要時間と金額は右(スマホでは下)に表示されます。」 |
オプション・人数(SC-011)
| コンポーネント | 仕様 |
|---|---|
| 人数ステッパー | 中央に大きな数字(--fs-display Mono)と「名様」、左右に 56px の丸ボタン(−/+)。上限・下限で薄くなる。人数1〜1 のメニューはステッパーを出さず「人数:1名様(このメニューは1名様でのご案内です)」 |
| 席の即時表示 | ステッパーの下に「このご人数でご案内できるお席:個室「楓」・個室「萩」・カウンター」 |
| オプション行 | 白い面の中の行:名称(+「必須」の枠ラベル・「+15分」)/説明/右に「+¥6,600」「1名」/スイッチ(排他グループはラジオ)。必須は自動で付き、外せない |
担当・席の選択(SC-012)
- 「担当」:最上部に「どなたでも」カード(丸の中にきらめきアイコン)、続いて担当カード(丸い写真 64px・肩書・名前(見出し書体)・紹介2行・右に「指名料 +¥2,200」)。指名すると「指名料 ¥2,200 が合計に加わります。」
- 「お席」:最上部に「おまかせ」カード、下に席カードの2列(写真 4:3・名称・「2〜4名様・説明」)。人数に合わない席は不透明度 45% と理由(「4名様からのご案内です」)
- 選べる担当が1人以下、かつ指定できる席が1つ以下なら、このステップ自体を飛ばす
日付選択(SC-013)
| コンポーネント | 仕様 |
|---|---|
| 最短のご案内 | 白い面の1行カード:カレンダーアイコン、1行目ラベル「最短のご案内」・2行目「9月25日(金) 20:00〜」(折り返し可、切らない)、右に「この日時を選ぶ」リンク(押すとその日付の時間選択へ) |
| 月ヘッダー | 44px の ‹ ›、中央に「2026年 9月」(見出し書体)。月送りは横スライド 240ms |
| 日付セル | 44×48(PC 48×52)。月曜始まり、土日も ink(赤青にしない)。数字(Mono --fs-ui)の下に 6px の印:●空きあり(state-open)/◐残りわずか(state-few の半円)/○満席(輪郭)/定休日は「—」。今日は数字の下に 1px の短い線。選択はセル全体を --brand-cta で塗る(角丸 --radius-md。円にしない)。過去・範囲外は ink-low で押せない |
| クイック選択 | カレンダーの下に「今日/明日/今週末」の枠線チップ(定休日・範囲外は薄く) |
| 凡例 | 「● 空きあり ◐ 残りわずか ○ 満席 — 定休日」 |
| 写真+店の一言の帯 | 8.5 共通 |
時間選択(SC-014)
| コンポーネント | 仕様 |
|---|---|
| 見出し | 「お時間をお選びください」+副題に「2026年9月29日(火)」 |
| グループ | 営業時間帯のラベル(昼/夜、午前/午後)。ラベルがない店は 午前(〜12時)/午後(〜17時)/夕方 に分ける。小見出しは sticky |
| 時間枠の行 | 縦に並べる。行高 64px、下罫線 soft。左端に細い罫(line-soft)。時刻(Mono --fs-time)/「○ 空きあり ・ あと3枠(カウンター・個室「萩」)」/右に › または時間帯の差額「−¥4,400」。残り枠の数より多い席名は出さない。few は「◐ 残りわずか ・ 残り1枠」を state-few-text で。full は全体 ink-low+右に「キャンセル待ち」リンク。held は「他のお客様が選択中」 |
| 選択と所要時間の帯 | 選んだ行は背景 brand-50+左端 4px の brand-500。選んだ行から所要時間分(行数 = 所要分 ÷ 刻み)、左端に 3px の brand-300 の帯が下へ伸びる(280ms)。帯の終わりに「〜20:30」(Mono・brand-700・地色の背景・z-index 上) |
| 満席の日 | 線画イラスト+「この日は満席でございます。最短のご案内は 10月3日(土) 17:30 です」+「10月3日(土)の空きを見る」 |
| 選択時 | 押した瞬間に仮押さえを作る(二重押し防止。14章)。CTA の下に「17:30 を10分間 確保しています」 |
仮押さえ・お客様情報(SC-015)
| コンポーネント | 仕様 |
|---|---|
| お取り置きの表示 | 面の上部、sunken の地の角丸の1行:「18:00 のお席を 10分間 お取り置きしております」+右に「残り 9:57」(Mono・ink-mid)。残り2分で state-few-text に色だけ変わる(400ms)。脈動・点滅しない |
| 入力欄(v1.1) | 白い面・1px の line-strong の枠・角丸 sm・高さ 48px。フォーカスで枠が brand-500(内側 1px の影)。ラベルは上(--fs-label)。エラーは枠を state-few+下に ink-high の文 |
| 項目 | お名前(必須)・フリガナ(任意・カタカナ)を PC は2列、お電話番号(必須・Mono)、メールアドレス(必須)、ご要望(任意・textarea・右上に 0/200・例「アレルギー、記念日など」) |
| 初期値(DEMO-04) | ゲストは「予約 花子/ヨヤク ハナコ/090-0000-0000/hanako@koyomi.example」。会員は会員情報を入れ、各欄の下に「会員情報から入力しました」 |
| 添え書き | 盾のアイコン+「これはデモです。入力内容はこのブラウザの中だけに保存され、外部には一切送信されません。本番では、予約の確認とご連絡のためだけに使います(個人情報の取り扱い)。」/CTA の下に「まだ予約は確定していません」 |
お支払い(SC-016)
- 内訳の表(白い面):メニュー名(人数)/オプション/指名料/時間帯の割引・特別営業日の差額/合計(
--fs-price)/事前のお支払い(デポジット)または事前決済(全額)/当日のお支払い - 事前のお支払いがある場合:「カード情報」見出し、sunken の注記「これはデモです。カード番号はどこにも送信・保存されず、請求も行われません。本番では決済代行のトークン方式で処理し…」、カード番号(4桁区切りで自動整形)・有効期限(MM/YY)・セキュリティコード・名義(大文字化)、「デモ用のカード番号を入力する」リンク(4242 4242 4242 4242 / 12/29 / 123 / HANAKO YOYAKU)
- 事前のお支払いがない場合:「お支払いは当日、店頭で承ります。」
- キャンセル規定:見出し(見出し書体)→ 規定の本文 → 段階の表(「3日前まで 無料」「2日前〜前日 50%(¥16,500)」「当日 100%(¥33,000)」)→ 無断キャンセルの扱い → 直下に同意チェック「上記のキャンセル規定を確認し、同意します」→ 事業者情報と LAW-06 の注記
- CTA「予約内容の確認へ」。不足は「あと5項目:カード番号、有効期限、セキュリティコード、名義、キャンセル規定への同意」
確認(予約票・SC-017)
- お取り置きの表示 → 中央見出し → 予約票:最大 560px、白い面、上下に line-strong の罫線、上部中央に欧文・店名(見出し書体
--fs-title)・短い罫。行は「ラベル(6.5em・ink-mid)/値/変更リンク」の3列で、日時(「2026年9月30日(水)17:30〜20:00(150分)」)・メニュー・人数・オプション・お席・担当・合計(内訳の1行付き)・お名前・ご連絡先・ご要望 - その下にキャンセル規定(要約の表)+「規定の全文を読む」、破線枠の「これはデモです。実際の予約・連絡は発生しません」
- CTA「この内容で予約する」(テナント設定の文言)。CTA の下にもデモの添え書き
完了(SC-018・v1.1 で全面を深い地に)
8.1 の6番を再現する。全面 --brand-deep・文字 --on-deep、内容最大 560px:右上に × → 店名ロゴ(見出し書体 22px・字間 .14em)+欧文 → 64px の細い円+チェック(stroke の描画 320ms) → 「ご予約を承りました」(--fs-display・下から 12px 上がりながら 480ms でフェードイン) → 副題 → 破線枠のデモ明示(「この予約はあなたのブラウザ内にのみ存在します」を含む)→ 白い予約カード(写真の小窓 96×80・店名・最寄り/アイコン行:日付・時刻・人数・メニュー・席と担当/予約番号 Mono とコピーボタン)→ 半透明の箱「この後の流れ」(確認メールを送った(デモでは送信していません)/前日 18:00 にリマインド/当日の案内)+「お送りする確認メールを見る」(MailPreview のモーダル)→ 白い塗りの「カレンダーに追加」(ics をダウンロード) → 白い枠線の「地図を見る」「予約を確認する」 → 店の一言(見出し書体)→ 欧文と電話番号(eyebrow・不透明度 50%)
競合・期限切れ(SC-019)
モーダル(最大 480px、中央、フェード+8px 上昇、背景の暗幕、フォーカストラップ):見出し「申し訳ございません」/本文「このお時間は、他のお客様が先にご予約されました。」+「ご入力いただいた内容は、そのまま保存されています。」/CTA「別の時間を選ぶ」(仮押さえを解放し、時間選択へ戻る)。期限切れは見出し「お時間が過ぎました」と expiredBody の文言。
通知(メール)のデザイン(FR-305)
| テンプレート | 仕様 |
|---|---|
| letter(手紙) | 件名・差出人の行 → 店名(見出し書体・中央)→ 本文(行間 2.1、予約番号の行は Mono)→「この後の流れ」の箱 → 「予約内容を確認する/変更・キャンセル」リンク → 右下に署名(店名)。明朝系テナントの既定 |
| card(予約票) | 上部に 6px のブランド色の帯 → 店名 → 本文の冒頭3行 → 2列の表(日時・メニュー・人数・予約番号)→「この後の流れ」→ リンク。ゴシック系テナントの既定 |
| plain(簡潔) | 本文テキストのみ+「この後の流れ」+リンク |
共通:幅 560px、本文 17px、差し込み変数({{お客様名}} {{日時}} {{メニュー}} {{予約番号}} {{店名}})。文面は付録A。
8.6 コンポーネント仕様(店頭・管理側)
同じトークン、高い密度。 お客様側と別のシステムに見えてはいけない。
| コンポーネント | 仕様 |
|---|---|
| シェル | 左サイドバー 240px・--brand-deep:上部中央に店名(見出し書体 19px)+欧文、「管理者(デモ)」の丸い枠ラベル。「受ける」「整える」のグループ見出し(12px・字間 .24em)、項目はアイコン+文字(高さ 40px)、選択中は白 12% の面。最下部に「お客様の予約ページ ↗」。ロールで見える項目を絞る |
| ページ見出し | 見出し書体 26px+副題、右に操作ボタン |
| デイシート(SC-100) | 日付の ‹ ›、「すべて/これから/ご来店中/完了」の切替。行:時刻(Mono 18px)と終了時刻、氏名+敬称+人数、状態バッジ、「サイト経由」、PC は メニューと席・担当、右に 56px の次の操作ボタン(来店 → ご案内 → 完了)。注意事項は行の下に caution の左帯 3px+caution-bg+警告アイコン。ご要望も行の下に |
| 状態バッジ | ご予約(brand-50 地・brand-700 文字)/ご来店(琥珀)/ご案内済(brand-100)/完了(sunken)/キャンセル(打ち消し線)/無断キャンセル(枠のみ) |
| タイムライン(SC-101) | 8.4 の寸法。予約ブロックは brand-100 塗り+左端 2px brand-500、時刻・氏名・人数・メニュー、注意事項は右上の caution の点。片付けの時間は斜線(line-strong の 135° ストライプ)。ブロック枠は sunken+破線。同時利用のある席(カウンター等)は列の中でレーンに分けて並べる。ドラッグ中は 3度傾いて影、移動先を破線の影で示し、不可なら state-few の枠と理由 |
| カルテの注意事項 | 最上部に sticky、2px の caution の枠+caution-bg、見出し「注意事項(アレルギー・体調など)」、チップで表示し追加・削除できる。畳めない |
| ダッシュボード(SC-200) | 8.1 の7番を再現 |
| テーマ設定(SC-210) | 左:プリセット3枚/ブランド色(色見本・カラーコード・試せる10色)/**自動で作られた派生色の見本7つ(濃・深(ボタン)・標準・中間・淡・背景・罫線)**と検査結果の一文/書体・余白・角丸・ダークモード/言葉づかい/ヒーロー写真の選択/コントラスト検査の表(ライト・ダーク)。右(sticky):スマホ枠(300px・角丸の黒い縁)またはブラウザ枠の縮小プレビュー、ダークモードで見るチェック。プレビューは保存前のテーマを、そのプレビュー要素の中だけに CSS 変数で注入する(14章) |
| ウィジェット設定 | 3形態のプレビュー、設置コード(コピー)、模擬サイトで開く |
| 分析 | 数字のパネル5つ、離脱ステップのファネル(横棒・「いちばん離脱が多いのは…」の一文)、席別の稼働率・時間帯別・メニュー別・流入元(CSS の横棒) |
8.7 状態の設計
すべてのコンポーネントに、以下の状態を定義する。 未定義の状態を作らない。
| 状態 | 設計 |
|---|---|
| 読み込み中 | スケルトン(sunken のシマー、形状はコンテンツと一致)。空き枠の再計算にはスケルトンを出さない |
| 空 | 線画イラスト(brand-500 の 1.5px の線。空きなし/予約なし/検索結果なし の3種)+一文+次の行動 |
| エラー | 原因+対処。赤を使わず、ink-high の文+state-few の下線/枠 |
| 無効 | 不透明度 45%、カーソル default。理由を添える |
| 選択 | brand-500 の枠 2px、または背景 brand-50、またはセルの --brand-cta 塗り |
| フォーカス | 2px brand-500 のアウトライン、オフセット 2px、外側に 4px の面の色の影(写真の上でも見える) |
| 押下 | 2% 縮小(80ms) |
| 成功 | チェックの描画(stroke 320ms)。トーストは使わない |
| オフライン | 上部に1行「オフラインです。接続が戻ると続きから進めます」。警告色にしない |
8.8 モーション
イージング:--ease-out: cubic-bezier(0.16,1,0.3,1)/--ease-in-out: cubic-bezier(0.65,0,0.35,1)/--ease-gentle: cubic-bezier(0.25,0.1,0.25,1)。duration も CSS 変数(--dur-*)で持ち、直書きしない。
| 対象 | duration | easing | 内容 |
|---|---|---|---|
| 面の入れ替え | 320ms | in-out | 現在の面が左へ 24px 滑って消え、次の面が右から 24px 滑って現れる(同時・同じ場所に重ねる)。戻るときは逆 |
| サマリーへの積み上げ | 240ms | out | 下から 8px 上がってフェードイン |
| 合計金額の変化 | 320ms | ease-out cubic | 数値のカウント |
| 月送り | 240ms | in-out | 新しい月が横に 100% から滑り込む |
| 時間枠の選択 | 160ms | out | 背景と左帯 0→4px |
| 所要時間の帯 | 280ms | out | scaleY 0.2→1(上端基準) |
| 完了メッセージ | 480ms | out | 12px 上がりながらフェードイン(最長のモーション) |
| モーダル | 240ms | out | フェード+8px 上昇 |
| サマリーシート | 280ms | in-out | 開閉 |
| テーマ切替(プレビュー) | 400ms | gentle | 色のクロスフェード |
| デモ切替バーの薄れ | 400ms | gentle | 予約フローのステップ2以降で不透明度 0.3、ホバー・フォーカスで 1 |
禁止:バウンス・点滅・脈動・パララックス、完了メッセージ以外で 300ms を超えるモーション。prefers-reduced-motion では面の滑り・月送りをフェードに、帯・完了メッセージ・チェックを即時に。
8.9 写真・イラスト(v1.1 で改訂)
| ID | 要件 |
|---|---|
| IMG-01 | 写真・画像は権利が明確なものだけ。 付録Cの一覧(生成画像はプロンプト、写真素材は作者・ライセンス・取得元)を docs/assets-license.md と /privacy#credits に全件記録する |
| IMG-02 | 全メニュー・全席・全スタッフ・3店のヒーローとギャラリーに画像を入れる。欠けゼロ。 画像がない枠を残さない(v1.0 の「写真なしメニューを意図的に作る」は廃止。写真がない場合の代替表示(brand-50 の色面+名称)の実装は残す) |
| IMG-03 | 画像の質を揃える。 店ごとの系統(付録C の仕上げ指示)に合わない画像・内容が違う画像(例:アロマに蝋燭だけ、鮨懐石に刺身、クリニックに病院のロビー)・文字やロゴの入った画像・人物の顔が主題の素材写真は使わない。作ったら必ず一覧にして目で確認し、合わないものは作り直す |
| IMG-04 | 画像の用意の順序:①付録C の生成画像は、付録C のプロンプトと仕上げ指示で Cloudflare Workers AI @cf/leonardo/lucid-origin を使って生成する(14章 14.9)②写真素材は付録C の取得元から取得し、同じサイズに加工する |
| IMG-05 | サイズ:ヒーロー 1920px 幅、ギャラリー 1600px 幅、メニュー・席 1200×900(4:3)、スタッフ 480×480。JPEG 品質 80、1枚 400KB 以下 |
| IMG-06 | 写真の上の文字には必ずスクリム(CLR-06) |
| IMG-07 | 空状態のイラストは brand-500 の 1.5px の線画の3種のみ |
| IMG-08 | アイコンは lucide-react(stroke 1.5)。塗りアイコンを使わない |
| IMG-09 | 画像は next/image、店舗ページのヒーローは priority。Cloudflare では画像最適化を切り(unoptimized)、加工済みの JPEG をそのまま配信する |
| IMG-10 | 未選択のメニュー写真は彩度 −10%(選択で戻す) |
| IMG-11 | 生成した人物は実在しない人物であることを、クレジットに明記する。 生成画像の制服・服に意味のない文字が入りやすいので、スタッフの写真は「plain fabric, no text」を付け、文字が入ったものは作り直す |
8.10 インタラクション要件
| ID | 要件 |
|---|---|
| IX-01 | ステップ遷移が 100ms 以下で開始し、320ms で完了すること |
| IX-02 | 空き枠の再計算(日付・人数・メニュー変更)が 100ms 以下で反映されること |
| IX-03 | サマリーが、選択の瞬間に更新されること |
| IX-04 | 日付・時間枠・メニューカードはキーボードで操作できること(日付は矢印で1日/1週、時間は ↑↓、Enter・Space で選択) |
| IX-05 | 日付は role="grid"、時間枠は role="listbox"/option |
| IX-06 | 主要CTAは、スマホで画面下部に固定され、常に押せること |
| IX-07 | 入力の検証は、欄を離れたときに行うこと |
| IX-08 | 不足項目は CTA の直上に「あと2項目:お名前、お電話番号」(英語は「Still needed: …」)。押してからエラーを出さない |
| IX-09 | 仮押さえの残り時間を、1分ごとに aria-live="polite" で通知すること |
| IX-10 | ブラウザの戻る・進むで、前後のステップに戻れること(面の向きも合わせる) |
| IX-11 | 仮押さえ中にページを離れようとしたら確認すること(beforeunload) |
| IX-12 | タイムラインのドラッグにキーボード代替(Enter で移動モード → 矢印 → Enter で確定/Esc で取り消し)を用意すること |
| IX-13 | テーマ設定の変更が、プレビューに 100ms 以下で反映されること |
| IX-14 | ウィジェットの高さが、内容に応じて親サイト側で自動調整されること |
| IX-15 | 時間枠の連打で、自分の仮押さえを「他のお客様」と誤認しないこと(14章) |
8.11 アクセシビリティ(WCAG 2.1 AA、本文は AAA)
v1.0 の A11Y-01〜16 をすべて維持する。加えて:本文 17px・補助 14.5px・最小 12px(8.3)、補助文字色は ink-mid #4A4540(地に対し 8:1 以上)。
8.12 ライティング規約
言葉も店の接客。 テナントの「敬語の温度」で出し分ける。全文言は付録B の表のとおり(言い換えない)。
| 原則 | 例 |
|---|---|
| 急かさない | ○「10分間お取り置きしています」/×「残り9:58!お早めに」 |
| 満席を否定形で終わらせない | ○「この日は満席です。最短のご案内は10月3日(土)17:30です」 |
| 競合を謝り、責めない | ○「申し訳ございません。この時間は他のお客様が先にご予約されました」 |
| 規定は先に、具体的に | ○「前日以降のキャンセルは、料金の50%(¥16,500)を頂戴します」 |
| 次に起きることを書く | ○「前日18:00にリマインドをお送りします」 |
| 不足は押す前に | ○「あと2項目:お名前、お電話番号」 |
| システム語を使わない | ○「この内容で予約する」/×「送信」「Submit」 |
| 初めての人に分かる言葉(v1.1) | デモの案内は業種名で。「テナント」「ロール」「ウィジェット」などの用語を、お客様に見える画面の説明文に出さない(デモ切替バーの操作ラベルは除く) |
8.13 デザインの受入チェック(実装後に必ず行う)
v1.0 の DES-01〜15 に加えて:
| ID | チェック項目 |
|---|---|
| DES-16 | 参考画像(8.1)の7画面と並べて、構成・配色・余白の印象が一致するか(店舗ページ・詳細・日付・時間・入力・完了・管理) |
| DES-17 | 12px 未満の文字・ウェイト400以下の本文・薄いグレーの説明文が残っていないか |
| DES-18 | 画像の欠けがゼロか。内容が合わない画像・文字入りの画像がないか(全画像を一覧にして確認) |
| DES-19 | スタートページだけで、初めての人が「何をすればいいか」分かるか |
9. 技術要件・ディレクトリ構成
技術スタック(固定・勝手に変更しない)
| レイヤ | 技術 | 備考 |
|---|---|---|
| フレームワーク | Next.js 15(App Router)/React 19/TypeScript strict | create-next-app@15 --ts --tailwind --app --eslint --no-src-dir --import-alias "@/*" |
| スタイリング | Tailwind CSS v4 + CSS Variables | テーマは CSS 変数で注入(THM-01)。独自クラスは @layer components に置く(14.2) |
| UIコンポーネント | 自前(shadcn/ui は入れない) | 部品数が少なく、見た目を画像に合わせ込むため |
| 状態管理 | Zustand 5 + persist(localStorage) | 3ストア:data / session / flow(7章) |
| 色計算 | 自前(OKLCH・WCAG コントラスト) | culori 等を入れない |
| 空き枠計算 | 自前(lib/availability/) |
|
| カレンダー・時間枠 | 自前 | 既製カレンダーを使わない |
| D&D | @dnd-kit/core | タイムラインのみ。キーボード代替は自前 |
| フォーム | 自前の検証関数(lib/validate.ts) |
v1.1:RHF + Zod は使わない(初期JSを軽くするため。項目数が少ない) |
| グラフ | CSS の棒 | v1.1:Recharts は使わない |
| 予約票の印刷 | window.print() |
v1.1:@react-pdf は使わない |
| 画像 | next/image |
Cloudflare では unoptimized(14.8) |
| ウィジェット | 自前(iframe + postMessage)+ローダー public/widget.js(依存ゼロ IIFE・5KB 以下) |
|
| i18n | 自前の辞書(lib/i18n/)+ lib/wording/ の en |
|
| ics | 自前 | |
| 日付 | 自前(lib/time/。JST 固定の ISO 文字列 YYYY-MM-DDTHH:mm:ss+09:00) |
v1.1:date-fns は使わない |
| フォント | Shippori Mincho B1(500/600)/Zen Kaku Gothic New(400/500/700)/DM Mono(400/500)を next/font/google |
8.3 |
| アイコン | lucide-react(strokeWidth 1.5) | |
| テスト | Vitest(純粋関数・スコープ)+ ヘッドレス Chrome の CDP で撮影・操作(12章 0-8) | Playwright・axe は Phase 5 で追加してよい |
| ホスティング | Cloudflare Workers(@opennextjs/cloudflare) | v1.1:Vercel から変更。14.8 |
| 画像生成 | Cloudflare Workers AI @cf/leonardo/lucid-origin(一時 Worker 経由) |
14.9 |
上記以外のライブラリを入れる前に必ず提案し、承認を得ること。
ディレクトリ構成(実装済みの構成)
/
├── CLAUDE.md # 本書
├── next.config.ts # distDir の切替・画像・/widget の frame-ancestors
├── open-next.config.ts # defineCloudflareConfig()
├── wrangler.jsonc # name: koyomi, main: .open-next/worker.js, assets
├── vitest.config.mts
├── app/
│ ├── layout.tsx # フォント、ThemeBoot(head)、Providers、ThemeSync、DemoBar、OfflineNotice
│ ├── globals.css # トークン・組版・独自クラス(@layer components)・キーフレーム
│ ├── page.tsx # スタートページ(予約サイト・業種で案内)
│ ├── not-found.tsx / manifest.ts / privacy/page.tsx(個人情報・写真のクレジット)
│ ├── [tenant]/
│ │ ├── layout.tsx # generateStaticParams(3店)・存在しない店は notFound
│ │ ├── page.tsx # SC-001(サーバーでシードを渡し、クライアントで最新に置換)
│ │ ├── book/layout.tsx # ★ BookingFlow を持ち続ける(complete のときだけ children)
│ │ ├── book/page.tsx, book/[step]/page.tsx # return null(面はレイアウトが描く)
│ │ ├── book/complete/[code]/page.tsx # SC-018
│ │ ├── reservations/lookup, reservations/[code]{,/change,/cancel}
│ │ └── account{,/history,/profile}
│ ├── widget/[tenant]/{layout,page,[step]/page,complete/[code]/page}.tsx # SC-090
│ ├── demo/host-site/[tenant]/page.tsx # SC-091
│ ├── manage/{layout,page}.tsx, manage/{timeline,reservations,reservations/[id],reservations/new,customers,customers/[id],waitlist}
│ ├── admin/{layout,page}.tsx, admin/{theme,store,menus,options,resources,staff,rules,cancel-policy,payment,notifications,widget,special-days,classes,analytics,stores,logs}
│ └── dev/{layout,theme,typography,components} # 本番では notFound
├── components/
│ ├── layout/ ThemeBoot, ThemeSync, Providers, OfflineNotice
│ ├── demo/ DemoBar(業種切替・ロール・会員/ゲスト・現在日時・リセット), DemoBand
│ ├── store/ StorePage
│ ├── flow/ BookingFlow, FlowContext, CtaContext, StepFrame, StepHeading, StepIndicator, FlowHeader,
│ │ Summary, SummarySheet, PrimaryCta, PhotoQuote, FlowSkeleton, useCountUp, steps/*Step.tsx(8つ)
│ ├── calendar/ DatePicker, MonthHeader, Legend(+DensityMark), EarliestNotice
│ ├── slots/ SlotList(所要時間の帯を含む)
│ ├── menu/ MenuCard(+MenuPhoto), OptionRow, PartyStepper
│ ├── resource/ StaffCard(+Avatar), ResourceCard
│ ├── ticket/ ReservationTicket, Breakdown, PolicyTable, Completion
│ ├── hold/ HoldNotice(+useHoldRemaining), ConflictModal
│ ├── waitlist/ WaitlistModal
│ ├── notify/ MailPreview
│ ├── account/ CustomerHeader, useReservation, Loading
│ ├── console/ ConsoleShell(+RoleGate, NAV), ui(PageHeader, Panel, StatusBadge, Select, Metric, SaveButton, LegalNote, FieldRow, Segmented)
│ ├── manage/ DaySheetRow, Timeline, KarteCautions
│ ├── admin/ ThemePreview, ContrastReport, Funnel, settings/{common,MenuEditor,ClosureEditor}
│ ├── widget/ WidgetBridge, HostSite, WidgetSetup
│ └── ui/ Modal, Field, EmptyState
├── lib/
│ ├── types/index.ts # 7章
│ ├── theme/ color.ts(OKLCH), contrast.ts, resolve.ts, inject.ts(themeVars/themeCss), presets.ts
│ ├── availability/ engine.ts(getAvailability/verifySlot/assignFor/periodServes), rules.ts, resource.ts, shift.ts, buffer.ts, capacity.ts, density.ts, reason.ts
│ ├── pricing/ computeAmounts, menuPrice, optionPrice, timeBandDelta, cancelFee, tierLabel
│ ├── time/ JST の ISO 文字列ユーティリティ・表示整形(fmtDate/fmtTime/fmtYen…)
│ ├── wording/ 言葉づかい(付録B), fillTemplate, MAIL_VARS
│ ├── i18n/ ics/ widget/ calc/ validate.ts
│ ├── seed/ tenants.ts, catalog.ts, people.ts, generate.ts, index.ts(buildSeed), version.ts(DATA_VERSION), photos.ts, photo-credits.json
│ ├── store/ data.ts, session.ts, flow.ts
│ └── repo/ _core.ts, _scope.ts, hooks.ts(useQuery/useSession/useDraft/useCapabilities…),
│ tenants, theme, menus, options, resources, staff, availability, holds, reservations,
│ waitlist, customers, notifications, analytics, logs, dashboard, blocks, classes, stores
├── public/photos/{ichou,hana,aoba,staff}/*.jpg, public/widget.js, public/icon.svg
├── scripts/widget.src.js # widget.js の読みやすい原本
├── docs/assets-license.md, docs/design-reference.png(参考画像)
└── tests/*.test.ts # theme / availability / pricing / wording / scope
コーディング規約
- TypeScript strict。
any禁止 - コンポーネントから Zustand ストアを直接参照しない。必ず
lib/repo/(hooks を含む)経由 - テナント分岐(
tenant.industry === 'restaurant'等)をコンポーネントに書かない。 テーマは CSS 変数、文言はlib/wording/、構成はtenant.flowSteps - ロール分岐(
role === 'staff')をコンポーネントに書かない。useCapabilities()のcanManage / canForce / canAdmin …を使う - 色・余白・角丸・モーションを直書きしない。 CSS 変数(Tailwind v4 の
p-(--sp-4)・text-(length:--fs-meta)・duration-(--dur-face)記法) - 空き判定を
lib/availability/の外に、金額計算をlib/pricing/の外に書かない(コンポーネントで金額を足し算しない。合計が要るなら repo が返す) lib/availabilitylib/themelib/pricinglib/timeは純粋関数。new Date()を内部で呼ばない(現在時刻は repo 層のnow()から引数で渡す)- ステップ遷移でフロー全体を再マウントしない。 面の入れ替えは同一ツリー内のアニメーション
- コミットは1タスクごと。メッセージに要件IDを含める
10. 非機能要件・法令
性能要件
| ID | 要件 | 目標値 |
|---|---|---|
| NFR-01 | ステップ遷移の開始 | 100ms以下(アニメーション 320ms) |
| NFR-02 | 空き枠の再計算(60日・リソース8・担当6・刻み15分) | 100ms以下 |
| NFR-03 | テーマの解決と注入 | 50ms以下 |
| NFR-04 | サマリーの更新 | 即時(次フレーム) |
| NFR-05 | LCP(店舗ページ・モバイル4G) | 2.0秒以下 |
| NFR-06 | LCP(予約フロー) | 1.5秒以下 |
| NFR-07 | INP | 150ms以下 |
| NFR-08 | CLS | 0.03以下(写真・カレンダーの高さを最初から確保) |
| NFR-09 | 予約フローのJSバンドル(gzip後) | 160KB以下(v1.1:Next.js 15 の土台が約103KB のため 140KB から見直し。実測 158KB)。初期データの生成コードとメニュー以外のステップは遅延読み込み |
| NFR-10 | ウィジェットのローダー | 5KB以下(実測 4.5KB・gzip 2KB)/iframe 内初期JS:Next.js 構成では約160KB(60KB が必須なら iframe 内を別実装にする。13章 44) |
| NFR-11 | 管理画面の初期JSバンドル | 250KB以下 |
| NFR-12 | 面の入れ替え・月送り・帯の伸長 | 60fps維持 |
| NFR-13 | Lighthouse(予約フロー) | Performance 95 / Accessibility 100 / Best Practices 100 |
| NFR-14 | 対応環境 | iOS Safari 16以降、Android Chrome 最新、PC Chrome / Edge / Safari / Firefox 最新2 |
| NFR-15 | フォント読み込みで本文がちらつかないこと(display: swap + size-adjust) |
|
| NFR-16 | テーマ切替でちらつかないこと(初期HTMLで注入) | |
| NFR-17 | 仮押さえのカウントダウンが、タブを離れて戻っても正確であること | |
| NFR-18 | localStorage 上限接近時に警告し、古い予約から圧縮すること |
セキュリティ・プライバシー
| ID | 要件 |
|---|---|
| SEC-01 | 入力された氏名・電話・メールを一切外部に送信しないこと(デモ)。 本番は暗号化通信 + 保存時暗号化 |
| SEC-02 | この事実を、入力画面・確認画面・デモ切替バーで明示すること |
| SEC-03 | GA4 に個人情報を送らないこと。送るのはステップ到達・離脱・テナント種別などのメタ情報のみ |
| SEC-04 | ユーザー入力(要望・メモ・カルテ)をサニタイズすること |
| SEC-05 | ウィジェットの postMessage は origin を検証すること。 本番は allowedOrigins で設置ドメインを制限 |
| SEC-06 | カード情報を自社で保持しないこと。 本番は決済代行のトークン方式(PCI DSS) |
| SEC-07 | 写真のライセンスを docs/assets-license.md に記録すること(IMG-01) |
| SEC-08 | 顧客カルテの注意事項は、スタッフ以上のみに返すこと(SCP-05)。テストで保証 |
デモ固有の誤解防止
| ID | 要件 |
|---|---|
| DEMO-01 | 全画面に「これはデモです。実際の予約・連絡は発生しません」を明示。確認・完了画面では強調 |
| DEMO-02 | 店名・住所・電話・担当名はすべて架空。電話は 03-0000-0000 形式 |
| DEMO-03 | 予約完了時にメール・SMS・LINE を送らない。プレビューのみ |
| DEMO-04 | 入力欄にダミー値を初期入力する(読者が本物を入れる動機をなくす) |
| DEMO-05 | 完了画面に「この予約はあなたのブラウザ内にのみ存在します」と明記 |
法令(本番)
| ID | 要件 |
|---|---|
| LAW-01 | 特定商取引法:事前決済・キャンセル料を取る場合、事業者情報・キャンセル規定・支払方法を予約前に明示すること。KOYOMI が支払い画面と確認画面の両方で規定を表示するのはこのため(FR-204) |
| LAW-02 | 個人情報保護法:予約者情報の利用目的を明示し、プライバシーポリシーへのリンクを予約フローに置くこと |
| LAW-03 | 資金決済法:デポジットの性質(前受金か前払式支払手段か)を確認すること。回数券・ギフト券を扱う場合は別途検討 |
| LAW-04 | 景品表示法:時間帯割引・キャンペーン表示の根拠を明示すること |
| LAW-05 | 予約記録・キャンセル記録・決済記録を、変更履歴付きで保持すること |
| LAW-06 | デモ内に「本デモは予約体験の実装例です。決済・キャンセル料の取り扱いは、実運用の際に専門家への確認を推奨します」の注記を、決済設定画面とキャンセル規定画面に常設すること |
実案件への転用時の注意(商談で聞かれた際に説明できるよう記録)
① ダブルブッキング対策は必ずサーバー側で。 DB の一意制約(
resource_id + start_atの排他制約)とトランザクションで防ぐ。本デモのlib/availability/は純粋関数なのでサーバーへ移植できるが、確定の排他はDBの責務② 仮押さえはサーバー側の有効期限付きロックにする。 ブラウザのタイマーだけでは、タブを閉じられたときに枠が戻らない
③ 決済はトークン方式。 カード番号を自社サーバーに通さない。デポジットの返金フローも決済代行の仕様に従う
④ 通知の送信基盤。 メールは送信専用サービス、LINE は公式アカウント(Messaging API)、SMS は従量課金。リマインドの送信数 = 予約数 × 通数 で費用が決まる(11章)
⑤ テナントの写真は、テナント自身が権利を持つものを使わせる。 利用規約で明記
⑥ タイムゾーン。 国内のみなら Asia/Tokyo 固定でよいが、インバウンド対応で海外からの予約を受ける場合、表示側のタイムゾーン変換が必要になる
11. 費用設計
本書は本番仕様なので、費用の章は「デモの費用」ではなく「実案件の費用構造」として書く。
予約システムの費用:既製サービスと自作の差は「体験」にある
予約には月額数千円の既製サービスがある。だから自作の理由は、機能ではなく体験になる。
| 既製サービス | KOYOMI(自作) | |
|---|---|---|
| 予約を取る機能 | ある | ある |
| 空き枠・仮押さえ・規定 | ある | ある |
| 店の装い | 店名とロゴを入れるだけ | 色・書体・余白・言葉づかいまで店のもの |
| 店のサイトの中で完結 | 別サイトに遷移することが多い | ウィジェットで店のサイト内で完結 |
| 通知の品位 | 定型文 | 店の接客としてデザインされたメール |
| 手数料 | 月額 or 件数課金 | 開発費 + 運用費 |
単価が高く、体験が価値になる業態ほど、この差が売上に効く。 逆に、低単価・高回転の業態では既製サービスで十分。
自作が正当化されるケース
| ケース | 内容 |
|---|---|
| ① 予約体験がブランドの一部 | 高単価のレストラン、スパ、自由診療、写真スタジオ。「予約ページが安っぽい」が客離れになる |
| ② 店のサイトの中で完結させたい | 既製サービスの外部遷移が離脱を生んでいる |
| ③ 複数の制約が絡む | 席×人数×担当×コース(飲食)、部屋×施術×担当(スパ)。既製の設定範囲を超える |
| ④ 多店舗でブランドを統一しつつ、店ごとに装いを変えたい | テナントテーマ(THM)の価値 |
| ⑤ 既存の顧客管理・カルテと繋ぎたい | 予約と来店履歴・好みを一体化 |
| ⑥ 件数課金・送客手数料が重い | リピート予約にも手数料がかかり続けている |
逆に、①〜⑥のどれにも当てはまらないなら、既製サービスを使うべき。
3層のコスト構造
| 層 | 内容 | 特徴 |
|---|---|---|
| ① 初期開発費 | 設計・実装・テスト | 制約の複雑さ(③)とデザインの作り込みで変わる |
| ② デザイン・写真 | テーマ設定、写真撮影、文言の調整 | 予約体験を商品にするなら、ここを削ってはいけない |
| ③ 固定運用費 | ホスティング、ドメイン、DB、監視、画像配信 | 小さい |
| ④ 変動運用費 | 通知(SMS・LINE)、決済手数料 | 予約件数に比例 |
| ⑤ 保守費 | 機能追加、テナント追加、法令対応 |
通知コストの計算式
年間通知数 = 年間予約件数 × 1予約あたりの通数(確認 + リマインド + 変更/キャンセル)
例:年間 6,000件 × 3通 = 18,000通/年
メール:ほぼ無料 / LINE:従量(友だち追加が前提) / SMS:1通ごと課金
高単価業態はリマインドの価値が高い(無断キャンセル1件の損失が大きい)。 SMS の費用より無断キャンセルの損失が大きいなら、SMS を使う判断になる。
損益分岐の考え方
既製サービスの年間コスト = 月額×12 + 件数課金×年間件数 + 決済手数料
回収年数 = (開発費 + デザイン費)÷(既製サービス年間コスト − 自作の年間運用費 − 保守費)
ただし①②のケースでは、この式は主役ではない。 比較対象は「既製サービスの費用」ではなく**「予約体験の差が生む売上差」**になる。
体験差の価値 = (予約完了率の改善 × 流入数 × 客単価)+(無断キャンセル率の改善 × 予約数 × 客単価)
KOYOMI が離脱ステップ分析(FR-713)を持つのは、この「予約完了率」を測るため。 既製サービスからの移行前後で比較できる。
Webで足りるか、ネイティブが必要か
予約は、Webで完結する典型。 来店頻度が月1回以下の業態で、専用アプリをインストールしてもらうのは難しい。LINE公式アカウント + Web予約が費用対効果で優る。
実測して示す
| ID | 要件 |
|---|---|
| COST-01 | デモ公開後、月次で「起動数・予約完了数・テナント切替数・離脱ステップ」を記録すること |
| COST-02 | tenant_switched の発生率と、切替後の予約完了率を記録すること(装いの違いを試した人が、予約を完走したか) |
| COST-03 | 記録した実測値をギャラリー・記事に掲載し、確認日を明記すること |
| COST-04 | 既製サービス・通知・決済の単価は変動するため、この文書に金額を書き込まない。 掲載時に公式ページを確認し、確認日を明記すること |
12. 実装タスク
この順に進める。フェーズを飛ばさない。 完了時は [x] に更新する。各フェーズの最後に、必ず 0-8 の手順で画面を撮影し、8章・付録と見比べる。
Phase 0 — 基盤・テーマ・組版・データ
0-1. 初期化
-
npx create-next-app@15 koyomi --ts --tailwind --app --eslint --no-src-dir --import-alias "@/*" --use-npm -
npm i zustand lucide-react @dnd-kit/core/npm i -D vitest @types/node@latest @opennextjs/cloudflare esbuild wrangler - 9章のディレクトリを作る。
CLAUDE.mdに本書を置く。vitest.config.mts(@→ リポジトリ直下のエイリアス)
0-2. テーマ(lib/theme/)
-
color.ts:sRGB⇔OKLCH、色域外は彩度を二分探索で落とす、adjust(base,{l,c,max})、setLightness、OKLab でのmix -
contrast.ts:WCAG 相対輝度とコントラスト比 -
resolve.ts:8.2 の表どおりの段・CTA・deep・検査と補正・contrastReport -
inject.ts:themeVars()(--sp-1〜16の具体値も含める。14.4)とthemeCss()(darkMode off/on/system) -
presets.ts:朱・苔・藍(8.2) - テスト:12色 × ライト/ダークで全ペア OK
0-3. 組版とトークン(app/globals.css)
- 8.2〜8.4 の CSS 変数、8.8 のイージングと
--dur-* - 独自クラス(
.font-heading .font-num .prose-body .t-label .t-meta .t-eyebrow .btn-primary .btn-secondary .link .field .field-label .skeleton .anim-*、スイッチ・ラジオ・チェック)を@layer componentsに、surface-cardは@utilityに(14.2) - フォントを
next/font/googleで。本文ウェイト 500(8.3) -
/dev/theme(3プリセット×3余白×3角丸×明朝/ゴシック×ライト/ダーク)・/dev/typography(規定文の1行の文字数を Range で実測)・/dev/components
0-4. 純粋ロジック
-
lib/time:JST 固定。toIso(date,min)(24時超は翌日へ)、minOf、absMin、addDays、weekdayOf、diffDays、isoFromEpoch(ms)(秒まで持つ)、epochFromIso、表示整形 -
lib/availability:14.6 のアルゴリズム。periodServes(昼・夜の提供時間帯) -
lib/pricing:人数単価/1組/段階、オプション(1名/1組)、指名料、時間帯差額、特別営業日の差額、決済方式(最も前払い寄りに揃える)とデポジット、キャンセル料と段階の表記(「3日前まで」「2日前〜前日」「当日」) -
lib/wording:付録B の全文言。fillTemplate - テスト:人数で席が変わる/所要時間で枠が変わる/定休日と密度/理由(blocked・lead_time)/仮押さえだけの枠は held/確定直前の再検証/60日分 100ms 以下/金額(夜のお献立2名 = ¥33,000・事前 ¥6,600・当日 ¥26,400、お祝い膳の段階、指名料、20:00 以降の割引)/キャンセル料/文言の出し分け
0-5. 型とシード
-
lib/types:7章(v1.1 の追加:Tenant.nameLatin/tagline/quote/intro/tags、StoreInfo.nearestStation、businessHours[].label、Menu.periodLabels、Resource.description、Staff.title、Amounts.timeBand、Hold.byOther、DayAvailability.outOfWindow、Waitlist.notifiedAt、FunnelEvent、AuditLog.actorLabel) -
lib/seed:付録A の内容をそのまま入れる(店・メニュー・オプション・席・スタッフ・規定・通知文面)。顧客・予約・シフト・仮押さえ・ブロック・キャンセル待ち・クラス・離脱の集計は 14.7 の生成規則で、現在日時からの相対で作る - 写真:付録C のとおり用意し、
lib/seed/photo-credits.jsonに全件登録。photo(path)は登録済みのパスだけ返す
0-6. ストアとリポジトリ
-
lib/store:data(skipHydration、version: DATA_VERSION、migrate: () => ({data:null}))、session、flow(テナントごとの下書き) - 初期データは 保存がないときだけ
import('@/lib/seed')で遅延読み込み(14.3) -
lib/repo/_scope.tsを最初に(SCP-01〜05)。全メソッド async・Result 型・run()で例外を Result に -
lib/repo/hooks.ts:hydrateStores(3ストアの rehydrate → seedIfNeeded → ready、storageイベントで他タブの変更を取り込む)、useReady、useQuery(ストアの変更で再実行・直前のデータを保持)、useSession、useDraft、useCapabilities、resetDemo、resetDraftSelection - スコープのテスト
0-7. デモ基盤
-
ThemeBoot:head の中で style 要素をスクリプトで作り、URL の店(/ichou・/widget/ichou・/demo/host-site/ichou)またはセッションの店のテーマ CSS を描画前に入れる。管理者が変えたテーマはlocalStorage['koyomi:theme-css:<slug>']を優先。/widgetではhtml[data-embed](14.1) -
ThemeSync:ストアのテーマを CSS にして style 要素とキャッシュに書く。URL の店をセッションに反映(ready 後に。14.5) -
DemoBar:固定の墨色 44px。左「予約サイト」、中央に業種の切替(飲食店/スパ・マッサージ/美容クリニック。スマホは 飲食店/スパ/クリニック)、右(1440px 以上)にロール・ゲスト/会員・現在日時・デモをリセット(確認モーダル)・ギャラリーへ戻る、それ未満は「…」のメニュー。予約フローのステップ2以降は不透明度 0.3(ホバー・フォーカスで戻る) -
DemoBand、LAW-06 の注記、スタートページ(8.5)
0-8. 画面の確認手順(全フェーズ共通・必須)
- 専用プロファイルでヘッドレス Chrome を起動し PID を控える(他の Chrome を名前で kill しない):
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless=new --remote-debugging-port=9333 --user-data-dir=<作業用> --hide-scrollbars about:blank & - Node の
WebSocketで CDP に接続し、自分専用のタブ(PUT /json/new)を使う。Emulation.setDeviceMetricsOverride(390×844・mobile・dpr2 / 1440×900)で幅を固定する(--window-sizeは使わない) -
Runtime.evaluateでクリック・入力して操作し、Page.captureScreenshotで撮る。撮る前にPage.bringToFront(裏のタブはアニメーションが止まり、古い見た目が写る) -
Runtime.exceptionThrownと console の error を拾い、出たら直す - 撮った画像を目で見て、8.1 の参考画像の書き起こし・8.5 と見比べる
Phase 1 — 予約フロー(最重要)
1-1. 面とサマリー
-
app/[tenant]/book/layout.tsxがBookingFlowを持ち、page.tsxと[step]/page.tsxは null(14.1) - ステップの切替は
window.history.pushState(戻る・進むはusePathnameの変化から向きを判定) -
StepFrame:古い面と新しい面を grid の同じセルに重ね、320ms で入れ替え。新しい面の h2(data-step-heading・tabIndex=-1)へフォーカス - 前提が欠けた URL に直接来たら、最初の未完了のステップへ
replaceState -
FlowContext(選択・金額・所要時間・文言・ステップ一覧・移動)、CtaContext(各ステップが CTA の文言・無効・不足・添え書き・押下を登録) -
Summary(PC)/SummarySheet(スマホ)/PrimaryCta/StepIndicator/FlowHeader - 初回表示後の空き時間に、ほかのステップの部品を先読み(
next/dynamic+requestIdleCallback)。最初の面(メニュー)は直接読み込む -
?menu=ID&at=ISO(店舗ページ・最短のご案内から)と?ref=(ウィジェット)の入口
1-2〜1-4. 各ステップ
- 8.5 の各ステップをそのとおりに作る。担当・席のステップは、選べる担当が1人以下かつ指定できる席が1つ以下なら飛ばす
- 時間枠を押した瞬間に
createHold(連打防止と直前の仮押さえの引き継ぎ。14.5) - 仮押さえの残り時間(1秒ごと・タブ復帰で再計算・1分ごとに読み上げ)、期限切れ・競合のモーダル
- 確定:
confirmBooking(確定直前の再検証・EXPIRED/CONFLICT)→ 完了画面へrouter.push。下書きの片付けは完了画面で行う(14.5) - 完了画面(8.5)、ics、確認メールのプレビュー
1-5. 店舗ページ・予約管理・会員
- SC-001(8.5)。サーバーではシードの店を props で渡して描き(ヒーローは priority)、クライアントで最新に置き換える
- SC-020〜024、SC-030〜032、
/privacy、not-found - 英語表示(FlowHeader の「English」)
Phase 1 完了チェック
- 3店すべて、スマホ・PC で予約が完了画面まで通る(0-8 で操作して撮る)
- 1画面ずつ 8.1・8.5 と見比べた
Phase 2 — テーマとウィジェット
- SC-210(8.6)。プレビューは保存前のテーマをプレビュー要素の中だけに注入し、400ms で色をクロスフェード
-
public/widget.js(ボタン/インライン/フローティング、Esc で閉じる、スクロール固定、送信元の検証、koyomi:completeイベント)、/widget/[tenant](WidgetBridge:?parent=のオリジンにだけ送る、ResizeObserver で高さ)、模擬店舗サイト(業種ごとに別デザイン・3形態の切替・完了通知のログ)、SC-234
Phase 3 — 店頭運用
- デイシート・タイムライン(dnd-kit・キーボード代替・ブロック枠の作成)・予約詳細(来店受付・メモ・変更履歴・通知プレビュー・印刷)・手動作成(店長は制約無視・印)・顧客一覧・カルテ(注意事項は最上部に固定)・キャンセル待ち(空きの検知・案内・通知プレビュー)・予約一覧(絞り込み・CSV)
Phase 4 — 設定・分析
- SC-200(8.1 の7番)・SC-211〜236・SC-240・SC-250・SC-251。各ページを
RoleGate(staff / manager / admin)で包む
Phase 5 — 仕上げと公開
- 8.13 の DES-01〜19 を実施(撮影して見比べる)
- 全画面を開いてエラーがないことを確認(0-8 のスクリプトで全ルートを巡回)
- 本番ビルドで初期 JS を実測(
Page.loadEventFiredまでに読んだ Script の転送量) - Cloudflare へ公開(14.8)し、公開 URL で予約を完了まで通す
13. 受入基準
デザイン
- 3店で装いが明確に違い、操作・構造・読みやすさが完全に同じであること(DES-01)
- 任意のブランド色(12色で検証)で、本文7:1・UI 4.5:1 が自動で保証され、補正時は管理画面に表示されること
- 本文が 17px・ウェイト500・行間1.85 で組まれ、12px 未満の文字がないこと(v1.1)
- 見出しの書体系統を切り替えても、サイズ・行間が変わらないこと
- お客様側で、ブランド色の段・空き状態3色・リンク以外の色が使われていないこと
- ブランド色が、CTA・選択・印・飾り罫・完了画面の全面・管理サイドバー以外に大面積で塗られていないこと
- 満席が赤で表示されていないこと。土日が赤青で塗られていないこと
- 面の入れ替えが 320ms・指定イージングで滑り、決めた項目がサマリーに積まれること
- バウンス・点滅・脈動・パララックスが一切使われていないこと
- 仮押さえの残り時間が控えめに表示され、脈動・点滅しないこと
- 全メニュー・全席・全スタッフ・3店のヒーローに、内容の合った画像が入っていること(欠けゼロ)(v1.1)
- 完了画面が深い地で、メッセージが 480ms で静かに現れること
- 通知メールのプレビューが3テンプレートで、テナントテーマを反映していること
- デイシートとタイムラインが、お客様側と同じトークンで作られていること
- ウィジェットを模擬サイトに置いて、店のサイトの一部に見えること
- ダークモードで地が純黒でなく、ブランド色が再解決されていること
- 英語表示で組版が崩れないこと
- 8.7 の全状態が全コンポーネントで定義されていること
- 参考画像(8.1)の7画面と並べて、構成・配色・余白の印象が一致すること(v1.1)
- スタートページが「予約サイト」と業種名で案内され、使い方が3ステップで分かること(v1.1)
体験(4つの問いへの回答)
- 日付をめくる前に、各日の空き具合が見えること
- メニューを選んだ瞬間に、所要時間と金額がサマリーに出ること
- 時間枠を選ぶと、所要時間の帯が伸び、何時まで拘束されるかが見えること
- 確定前に、支払い画面と確認画面の両方でキャンセル規定が読めること
- 完了画面に「この後の流れ」が表示されること
- 「最短のご案内」が日付選択の上部と店舗ページのヒーローに常時表示されること
- 不足項目が、押す前に CTA の直上に示されること
- 競合・期限切れの案内が責めない文言で、入力内容が保持されること
機能
- 空き判定が
lib/availability/の外に存在せず、純粋関数であること。60日分の再計算が 100ms 以下 - 人数・メニュー・担当・席・オプションの変更が、空き枠と金額に即座に反映されること
- 金額計算が
lib/pricing/に集約され、付録A の料金で正しいこと - 仮押さえ(10分)が動作し、期限切れで解放され、確定直前に再検証されること。時間枠の連打で誤って競合にならないこと
- キャンセル待ちが登録でき、空き発生時に通知(プレビュー)されること
- テーマの変更がプレビューに 100ms 以下で反映され、保存後にお客様側にも即時反映されること
- ウィジェットが
<script>1行で設置でき、高さ自動調整・完了通知が postMessage で動くこと。オリジンが検証されること - デイシートでステータスが1タップで更新され、注意事項が行に表示されること
- 顧客カルテの注意事項が最上部に固定され、畳めず、スタッフ以上のみに返ること
- タイムラインのドラッグで移動でき、不可の場合は理由が出ること。キーボードでも操作できること
- 通知の3テンプレートが差し込み変数で編集でき、送信タイミングを設定できること
- 離脱ステップ分析がファネルで表示されること
- 昼の提供時間帯のメニューが夜の枠に出ないこと(v1.1)
- お客様のタブと店側のタブを並べて操作しても、互いのデータを上書きしないこと(v1.1)
基盤
- お客様が他人の予約を取得できず、スタッフが他店舗を取得できないこと
- 初期 JS(gzip 後の転送量、読み込み完了まで):予約フロー 160KB 以下、ウィジェットのローダー 5KB 以下。 ※ v1.0 の「予約フロー 140KB・ウィジェット iframe 内 60KB」は、Next.js 15 + React 19 の土台だけで約103KB あるため、この構成では達成できない(v1.1 実測:予約フロー 158KB、iframe 内 159KB)。60KB を必須とする場合は、iframe の中だけを Next.js を使わない軽量な実装に分ける判断が要る(要相談)
- CLS 0.03 以下。フォント・テーマのちらつき(別の店の色が一瞬見える)がないこと
- 全画面に空の状態がなく、メニュー名・説明にダミーがないこと
- 画像の権利記録が
docs/assets-license.mdと/privacy#creditsに全件あること - 個人情報が外部に一切送信されていないこと
- 「これはデモです」が全画面に明示され、店名・電話がすべて架空であること
- 4章「ロールを跨ぐ体験」の8パターンがすべて動作すること
- 単体テスト(theme / availability / pricing / wording / scope)がすべて通ること
- 公開 URL で、3店の予約が完了まで通ること
14. 実装の要点と落とし穴(v1.1 で追加・コードを書く前に必ず読む)
初版の実装で実際に起きた問題と、その正しい作り方。ここに書いた方法で作れば、同じ不具合を踏まない。
14.1 予約フローのルーティング(面を再マウントしない)
app/[tenant]/book/layout.tsx(クライアント)が<BookingFlow slug />を描き続ける。book/page.tsxとbook/[step]/page.tsxはreturn null。パスに/book/complete/を含むときだけchildrenを描く- ステップの URL は
/ichou/book(メニュー)・/ichou/book/options・resource・date・time・details・payment・confirm。ウィジェットは/widget/ichou・/widget/ichou/<step>(クエリを引き継ぐ) - ステップの移動は
window.history.pushState(Next 15 はusePathnameと同期する。サーバーへの往復がないので 100ms 以内に切り替わる)。現在のステップはusePathname()から決める - 完了画面への移動だけは
router.push - 面の入れ替え:
StepFrameが「層」の配列を持ち、ステップのキーが変わったら古い層をexit、新しい層をenterとして grid の同じセル([grid-area:1/1])に重ねて同時にアニメーションし、340ms 後に古い層を消す。退場中の層はinert+aria-hidden
14.2 CSS の優先順位(Tailwind v4)
- 独自クラスは必ず
@layer components { ... }の中に書く。 レイヤーの外に書くと Tailwind のユーティリティ(hiddenなど)より強くなり、「スマホで隠したはずの予約ボタンが縦に潰れて出る」不具合になる md:surface-cardのように変種を付けたいクラスは@utility surface-card { ... }で定義する@keyframesはレイヤーの外に置く- 管理側の密度(
.console)も@layer componentsの中へ
14.3 保存・ハイドレーション・複数タブ
- 3ストアとも
persistのskipHydration: true。ProvidersのuseEffectでhydrateStores()を1回だけ呼び、3つのrehydrate()の後に 保存がなければawait import('@/lib/seed')で初期データを作る(初期データの生成コードは約26KB あるため、静的に読み込まない)。終わったらreadyを立てる useReady()が false の間はスケルトンを出す(SSR とクライアントの最初の描画を一致させる)DATA_VERSION(lib/seed/version.ts)を上げると保存済みデータを捨てて作り直す。persist のmigrate: () => ({ data: null })を必ず書く(書かないとブラウザに警告が出る)。画像やシードを変えたら版を上げるwindow.addEventListener('storage', …)でkoyomi:data / koyomi:session / koyomi:flowの変更を受けたら、そのストアをrehydrate()する。 これがないと、お客様のタブと店側のタブを並べたときに、互いの保存を上書きして仮押さえが消える(「お時間が過ぎました」が誤って出る)- 保存の失敗(プライベートブラウズ等)に備え、localStorage が使えなければメモリに退避する
14.4 テーマの注入(ちらつきとハイドレーションずれを防ぐ)
ThemeBootはサーバーで3店分のテーマ CSS を作って埋め込み、<head>のインラインスクリプトで<style id="koyomi-theme">要素をdocument.createElementで作って描画前に CSS を入れる。<style>を JSX で書いてスクリプトで中身を書き換えると、ハイドレーションのずれ(Hydration failed)になる- 店の決め方:URL の1段目が店の slug ならその店、
/widget/<slug>・/demo/host-site/<slug>も同様、それ以外はセッションの店 - 管理者がテーマを保存したら、
ThemeSyncが新しい CSS を style 要素に書き、localStorage['koyomi:theme-css:<slug>']に残す(次回の初期表示で使う) - テーマ設定のプレビューは、保存前のテーマを
style={themeVars(...)}でプレビュー要素に直接入れる。 このとき--sp-*は:rootで計算済みの値が継承されるため、--space-unitだけ入れても余白が変わらない。themeVars()は--sp-1〜16の具体値(px)も返すこと
14.5 実際に起きた不具合と対策
| 症状 | 原因 | 対策 |
|---|---|---|
| 予約フローで画面遷移(完了画面への移動・他ページへのリンク)が効かない | ステップの到達を記録する trackStep が毎回ストアを書き換え → 書き換えでデータ再取得 → 配列の参照が変わり effect が再実行 → また書き換え…の無限ループ(1秒に約200回の再描画)で、Next のナビゲーションが完了しない |
記録済みならストアに触れない(mutate の前に確認)。effect の依存は配列ではなく steps.join() のような文字列にする |
| 時間を素早く2回押すと「他のお客様が先に」 | 2回目の仮押さえが、1回目の自分の仮押さえを他人のものとして判定していた | 押下中フラグで連打を無視し、直前の仮押さえ ID を ref で持って createHold(…, previousHoldId) に渡す(直前の分は無視して判定し、成功時に置き換える) |
| 確定後、完了画面ではなくメニュー選択に戻る | 確定ボタンで下書きを空にした瞬間、「前提が欠けたら最初のステップへ replaceState」が走り、router.push と競合 |
下書きの片付けは完了画面を開いてから(resetDraftSelection) |
| 懐石のページなのに、デモ切替バーが前回の「スパ」のまま | URL の店をセッションに反映する effect が、保存の復元前に1回だけ走っていた | ready と session.tenantSlug も依存に入れ、復元後に反映する |
| 「最短のご案内」がスマホで途中で切れる | truncate |
ラベルと日時を2行に分け、切らない |
| 1280px でデモ切替バーの項目が重なる | 切替の表示幅 | 1440px 以上でだけ横並び、それ未満は「…」メニュー |
| 撮影すると古い見た目のまま | ヘッドレスの裏タブはアニメーション・トランジションが進まない/ブラウザに前回のページが残る | 撮影前に Page.bringToFront、検証ごとに新しいプロファイル |
| 本番用ビルド後に開発サーバーが壊れる | opennextjs-cloudflare build が .next を上書き |
ビルド前に開発サーバーを止める。手元の本番確認は NEXT_DIST_DIR=.next-build で別フォルダに |
14.6 空き枠エンジンの手順(getAvailability)
入力:店・メニュー・オプション・席・担当・シフト・予約・仮押さえ・ブロック・選択(メニュー・オプション・人数・指名・席指定)・期間・現在時刻。
- 選んだメニューとオプションから 所要時間 = メニューの分の合計 + オプションの追加分、前後の準備時間 = メニューの最大値
- 占有の索引:キャンセル以外の予約を「本体 [開始, 終了) と、準備込み [開始−前, 終了+後)」として席別・担当別に登録。有効期限内の仮押さえ(自分の仮押さえ ID は除く)、ブロック枠(席指定・担当指定・店全体)も登録
- 担当の候補:メニューが担当を要するとき、そのメニューすべてに対応する担当(メニューの担当指定があればその中)。指名があればその人だけ
- 席の要求:必要な種別のうち
seatとroomは「着席先1つ(どちらでもよい)」、equipmentは別に「設備1つ」。候補は人数が定員に合う席(小さい順)。席指定があればそれだけ - 日ごとに:臨時休業・定休日・特別営業日でそのメニューが出ない日 →
closed。予約可能期間の外 →outOfWindow - 営業時間帯ごと(
periodServes:メニューのperiodLabelsに含まれる時間帯だけ)に、開始時刻を刻み幅で進め、開始 + 所要時間 ≤ 閉店の枠を作る - 各枠:受付期限より前 →
past_deadline。人数がメニューの範囲外 →full(capacity)。店全体のブロックに重なる →full(blocked) - 担当:シフト内・休憩外・予約と重ならない人を候補に(本体の時間で判定)
- 席:候補の席ごとに、準備込みの窓と重なる占有を数え、
空き = 同時利用数 − 重なり。重なりの理由の優先は ブロック > 予約(本体の重なり)> 準備時間 > 仮押さえ 残り = min(担当の候補数, 各要求の空きの合計)。0 → 仮押さえだけで埋まっていればheld、それ以外はfull(理由を1つ選ぶ:closed > out_of_window > lead_time > blocked > reserved > held > buffer > capacity > no_resource > break > off_shift)、1 →few、2以上 →open- 日の密度:受付期限切れを除く枠のうち open/few の割合。0 →
full、0.3 以下 →few、それ以上 →open - 最初に見つかった open/few の枠を
earliestAtとして返す verifySlot:確定直前に同じ条件でその日だけ再計算し、その枠が open/few かを返す。assignFor:空いている席のうち指定席または最初のもの(着席先と設備を1つずつ)と、指名または最初の担当を割り当てる
14.7 データの生成規則(lib/seed/generate.ts・people.ts)
- 期間:今日の10日前〜45日後(シフトは31日前〜62日後)
- シフト:営業日の開店〜閉店。スパのスタッフ(店長以外)は
(曜日 + 順番) % 6 === 0の日を休み、奇数番は開店1時間後から・偶数番は閉店1時間前まで、休憩は 13:00 から 30分ずつずらして1時間。クリニックの桐生医師は土曜休み - 予約の詰め方:席ごとに同時利用数ぶんのレーンを作り、各営業時間帯の頭から「その時間帯に出るメニュー」をランダムに選び、次の確率で置く(置かなければ 1〜3 刻み進める)。人数は
max(メニュー最小, 席の最小)〜min(メニュー最大, 席の最大)の乱数、担当は空いている候補から、設備は重ならなければ確保。置いたら終了 + 片付けから、刻みに揃えて(40%で1刻み空けて)次へ。ヨガスタジオには置かない- 過去:0.28/今日〜2日後:懐石 0.5・他 0.72/金土日の最後の時間帯(14日以内):懐石の金曜 0.7・クリニック 0.85・それ以外 1(満席)/平日の最初の時間帯(2つ以上ある店):0.1/それ以外:
max(0.05, 0.22 − 日数×0.005) - 状態:過去は 6% キャンセル・3% 無断・残り完了。今日の開始済みは「ご案内済」。未来は 4% キャンセル・残り「ご予約」
- 流入元:45% ウィジェット(
https://<slug>.example/)、35% 予約ページ、20% 電話 - 予約番号:
KY-<YYMM><店の番号 1/2/3>-<4桁> - 乱数は xorshift(シード=店IDの長さ×7919 + 日付の数値 % 997)。1回の生成で合計 約850件
- 過去:0.28/今日〜2日後:懐石 0.5・他 0.72/金土日の最後の時間帯(14日以内):懐石の金曜 0.7・クリニック 0.85・それ以外 1(満席)/平日の最初の時間帯(2つ以上ある店):0.1/それ以外:
- 顧客:店ごとに60名。姓30・名24の一覧(佐藤・鈴木…/美咲・陽菜…)から組み合わせ、電話
090-0000-XXXX、メールguestN@<slug>.example、会員55%、来店回数は乱数の2乗×12- 注意事項(先頭の数名):懐石「甲殻類アレルギー(えび・かに)」「そばアレルギー(重度)」「妊娠中のため生ものは控える」「牛肉が苦手」「足が不自由。テーブル席をご案内」/スパ「妊娠中(16週)。うつ伏せ不可・一部の精油を使用しない」「ナッツアレルギー(スイートアーモンドオイル不可)」「高血圧の治療中。ホットストーンは医師の許可が必要」「腰椎ヘルニアの既往」/クリニック「ラテックスアレルギー」「リドカイン(麻酔)で気分不良の既往」「抗凝固薬を服用中」「ケロイド体質」
- 好み:懐石「日本酒は辛口」「窓側のお席を希望」「記念日は花束を用意」「食べる速度がゆっくり」「炊き込みご飯を折詰で持ち帰る」/スパ「圧は強め」「会話は少なめを希望」「ラベンダーの香りが好き」「室温は高め」「担当は早瀬さんを希望」/クリニック「女性医師を希望」「説明は詳しく」「仕事の都合で夕方希望」「前回は赤みが3日続いた」
- 3ペルソナ:11番目を会員(懐石 白川 千尋/スパ 水野 葵/クリニック 森田 結衣、電話 090-0000-0000、
member@<slug>.example)、12番目を常連(来店14回)、13番目をゲスト - 今日の「ご予約」状態の予約のうち先頭2件を、注意事項のある顧客に差し替える(デイシートとカルテの実演用)
- 特別営業日・臨時休業:懐石は19日後に「秋の特別営業(松茸のお献立)」17:00–22:30・1名 +¥2,200、26日後が臨時休業。スパ15日後・クリニック12日後が臨時休業
- 他のお客様の仮押さえ:各店の同時利用1の席に、4日後の最後の時間帯の開店+60分から90分、期限は生成から9分後
- ブロック枠:6日後の最初の時間帯。懐石「畳の張り替え」・スパ「ベッドのメンテナンス」(最初の席)、クリニックは店全体「院内研修」
- キャンセル待ち:次の土曜の最後の時間帯に、懐石3・スパ3・クリニック2件(写真付きの部屋のメニュー、顧客21〜23番、2件目は LINE 通知)
- 定員制クラス:スパ「朝のヨガ」10:00・クリニック「初めての方の肌治療説明会」18:00 を、2日後から3日おきに10回(定員8)
- 離脱の集計(分析用):店ごとのセッション数 380/440/500 に、到達率 [メニュー 1, オプション .86, 担当・席 .80, 日付 .74, 時間 .62, 情報 .55, 支払い .47, 確認 .44, 完了 .41] を掛けたもの(クリニックの支払い −0.07、スパの情報 −0.05)。実際のセッションの到達は最大1500件まで追記
14.8 Cloudflare への公開
npm i -D @opennextjs/cloudflare esbuild wrangleropen-next.config.ts:export default defineCloudflareConfig()wrangler.jsonc:{ "name": "koyomi", "main": ".open-next/worker.js", "compatibility_date": "2026-09-01", "compatibility_flags": ["nodejs_compat","global_fetch_strictly_public"], "assets": { "directory": ".open-next/assets", "binding": "ASSETS" }, "observability": { "enabled": true } }next.config.ts:distDir: process.env.NEXT_DIST_DIR || '.next'、images.unoptimized: process.env.CF_BUILD === '1'、/widget/:path*にContent-Security-Policy: frame-ancestors *- 公開:
CF_BUILD=1 npx opennextjs-cloudflare build && npx opennextjs-cloudflare deploy(開発サーバーを止めてから) .gitignoreに.open-next.wrangler.next-build
14.9 画像の生成手順(付録C)
- Workers AI の API トークン権限がなくても、AI バインディング付きの一時 Worker を立てれば生成できる:
wrangler.jsoncに"ai": { "binding": "AI" }、fetchでx-keyヘッダーを秘密の値と照合し、env.AI.run('@cf/leonardo/lucid-origin', { prompt, width, height })の結果(base64 のimage)を JPEG で返す。秘密の値はwrangler secret put KEY - 付録C の各行について「プロンプト本文 + 系統の仕上げ指示」を送り、指定サイズで生成(並列4・失敗は2回まで再試行)
- 全画像を店ごとに一覧(コンタクトシート)にして目で確認し、内容が違う・不自然・文字入りのものはプロンプトを具体的にして作り直す
sipsで 8.9 IMG-05 のサイズ・品質に縮小しpublic/photos/へ。photo-credits.jsonとdocs/assets-license.mdに登録- 終わったら一時 Worker を削除する(
wrangler delete --name <名前> --force)
- 比較の結果、
@cf/black-forest-labs/flux-1-schnell(1024px 上限・質が一段落ちる)ではなくlucid-origin(1600×1200 以上・落ち着いた質感)を使う
14.10 ウィジェットの通信(WGT-04, SEC-05)
- メッセージは
{ ns: 'koyomi-widget', type: 'resize' | 'complete' | 'close' | 'ready', ... } - iframe 側は
?parent=<親のオリジン>を受け取り、正しいオリジンの形のときだけ、そのオリジンにだけpostMessageする。ResizeObserver でdocument.documentElement.scrollHeightを送る - 親(
widget.js)は、送信元がウィジェットのオリジンかつ自分の iframe のcontentWindowのときだけ受け取る。completeでwindow.dispatchEvent(new CustomEvent('koyomi:complete', { detail })) - 設置コード:
<script src="<origin>/widget.js" data-koyomi="<slug>" data-mode="button|inline|floating" data-label="予約する" data-position="bottom-right" async></script>(data-positionはフローティングのときだけ)
判断に迷ったときのルール
- 仕様がこの文書にない場合は、実装せずに質問する。 推測で作らない
- 8章は装飾ではなく商品価値。 組版・余白・モーション・状態の指定を満たさない実装は未完成。これがこのプロジェクトで最も重要なルール
- 急がせない。 カウントダウンを大きくしない、点滅・脈動させない、「今すぐ」と書かない
- 聞かれる前に答える。 空き・金額・時間・規定を、必要になる瞬間より前に見せる
- 店の装いで。 色・写真・言葉はテナントのもの。ただし品位(可読性・操作・静けさ)は変えない
- ブランド色を撒かない。 CTA・選択・進捗・飾り罫だけ。背景に大面積で塗らない
- 本文を純黒・純白にしない。ブランド色で本文を書かない
- 満席を赤にしない。土日を赤青で塗らない。 お客様側に赤を持ち込まない
- 色・余白・角丸・モーションを直書きしない。 すべて変数
- テナント分岐をコンポーネントに書かない。 テーマは変数、文言は
lib/wording/ - 空き判定・金額計算を、それぞれの
lib/の外に書かない - 既製のカレンダー・色計算・UIキットを入れない。 自前実装であることが品質の根拠
- 面の入れ替えで再マウントしない。 滑らかさはここで決まる
- 写真がなくても美しく。 代替の色面を手抜きしない
- 通知も接客。 メールのデザインを後回しにしない
- メニュー名・説明にダミーを残さない。 予約のデモは世界観がそのまま説得力になる
- スコープ外(3章 Won't have)は実装しない。特に宿泊・口コミ・グルメサイト連携は範囲外
- 「デモだから」を理由に品質を落とす判断はしない。本書は本番仕様である
- AKIMA・KAMIWAZA のトークン・コンポーネントをコピーしない。 KOYOMI だけが「テナントで装いが変わる」
- (v1.1)参考画像(8.1)を忠実に。 迷ったら 8.1 の7画面の見た目に合わせる
- (v1.1)読みやすさが先。 12px 未満・ウェイト400以下の本文・薄いグレーの説明文を使わない
- (v1.1)画像の欠けを残さない。 付録C のとおり用意し、一覧で目視確認する
- (v1.1)初めての人に分かる言葉で。 デモの案内は業種名で
- (v1.1)作ったら撮って見る。 390px と 1440px で撮影し、8章・付録と見比べてから次へ(12章 0-8)
- (v1.1)14章の落とし穴を踏まない。 特に @layer components・style 要素のスクリプト生成・storage イベント・trackStep の無限ループ・連打の仮押さえ
付録A 店舗・メニュー・スタッフの全データ
この値をそのまま lib/seed/tenants.ts・catalog.ts に入れる。 住所・電話・人物はすべて架空。スパ・クリニックの確認メール以外の通知文面(reminder / change / cancel / waitlist)も、店の言葉づかいに合わせて同じ調子で書く(変更・キャンセル・キャンセル待ちは3店共通の文面でよい)。
懐石 いちょう(slug: ichou / id: t-ichou)
| 項目 | 値 |
|---|---|
| 業種 | restaurant |
| 欧文ロゴ | KAISEKI ICHOU |
| キャッチ(ヒーロー) | 季節を、一椀に。 |
| 店の一言(写真の上) | 器に季節を映し、 静かなひとときをお運びします。 |
| 紹介文 | 銀杏並木の坂の途中、昭和の町家を改めた小さな懐石料理店です。旬の素材を、器と盛り付けで季節ごとに装い、お昼は三組、夜は五組だけをお迎えしています。個室と離れ、白木のカウンターをご用意しております。 |
| タグ | 懐石料理、個室あり、季節のお献立 |
| 住所 | 東京都港区白金台 0-0-0(架空の住所) |
| 最寄り | 白金台駅 2番出口より徒歩6分 |
| 電話 | 03-0000-1101 |
| メール | info@ichou.example |
| 営業時間 | 昼 11:30–14:30 / 夜 17:30–22:30(火水木金土日) |
| 定休日 | 月曜 |
| アクセス案内 | 坂の途中、銀杏の木の下の格子戸が入口です。お車でお越しの際は近隣のパーキングをご利用ください。 |
| 写真 | hero: /photos/ichou/hero.jpg(alt: 懐石 いちょうの店内。灯りの落ちた座敷と、季節のしつらえ) gallery: /photos/ichou/gallery1.jpg(alt: 坪庭に面した個室の眺め) |
| テーマ | ブランド色 #B5433A/書体 mincho/余白 wide/角丸 soft/ダーク off |
| 言葉づかい | 温度 formal/呼称「様」/予約ボタン「ご予約」/完了の一言「お待ち申し上げております。」 |
| 予約ルール | 刻み 30分/受付期限 180分前/予約可能期間 60日/仮押さえ 10分/1組上限 10名/変更期限 1日前 |
| キャンセル規定(段階) | 3日前以上→0%、1日前以上→50%、0日前以上→100% |
| キャンセル規定(本文) | 仕入れと仕込みはご予約の人数に合わせて前日から始めております。そのため、ご来店日の2日前以降のお取り消し・人数の変更には、下記のとおりキャンセル料を頂戴いたします。お日にちの変更は、3日前までであれば承ります。 |
| 無断キャンセル | ご連絡なくお越しにならなかった場合は、お献立代の全額を頂戴いたします。 |
| ウィジェット | button/「ご予約」 |
| 通知デザイン | letter |
確認メールの文面(confirm)
件名:【{{店名}}】ご予約を承りました
{{お客様名}}
このたびは{{店名}}にご予約をいただき、誠にありがとうございます。
下記の内容にて、ご予約を承りました。
ご来店日時 {{日時}}
お献立 {{メニュー}}
予約番号 {{予約番号}}
当日は、心を込めておもてなしいたします。
お待ち申し上げております。
メニュー
| id | カテゴリ | 名称 | 説明 | 分 | 片付け | 料金 | 決済 | 人数 | 提供時間帯 | 必要リソース | 担当 | 写真 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| m-ichou-lunch | お昼 | 昼のお献立 | 先付・お椀・お造り・焼物・土鍋ご飯・甘味の六品。季節の器で、お昼の短い時間にも懐石の流れをお楽しみいただけます。 | 90 | 30 | ¥8,800/1名 | 当日 | 1〜8 | 昼 | room+seat | 不要 | /photos/ichou/menu-m1.jpg |
| m-ichou-tenshin | お昼 | 花点心 | 十二の小鉢を一つの箱に。旬の炊き合わせと焼物、ご飯とお吸い物で、軽やかなお昼を。 | 75 | 30 | ¥5,500/1名 | 当日 | 1〜6 | 昼 | room+seat | 不要 | /photos/ichou/menu-tenshin.jpg |
| m-ichou-dinner | 夜 | 夜のお献立 | 八寸から始まる九品の懐石。その日に届いた魚と野菜で、料理長が献立を組み立てます。 | 150 | 30 | ¥16,500/1名 | デポジット ¥3300/名 | 1〜8 | 夜 | room+seat | 不要 | /photos/ichou/menu-m2.jpg |
| m-ichou-hassun | 夜 | 季節の八寸と酒肴 | カウンター限定。料理長の手元を眺めながら、八寸と酒肴を日本酒とともに。おひとりさまも歓迎いたします。 | 120 | 15 | ¥12,100/1名 | デポジット ¥2200/名 | 1〜2 | 夜 | seat | 不要 | /photos/ichou/menu-m4.jpg |
| m-ichou-sushi | 夜 | 鮨懐石 | 前半は懐石、後半は握りを十貫。遅めのお時間(20:00〜)は、お一人さま ¥2,200 お安くご案内しております。 | 150 | 30 | ¥22,000/1名(20:00〜 -2200/名) | デポジット ¥4400/名 | 1〜6 | 夜 | room+seat | 不要 | /photos/ichou/menu-sushi.jpg |
| m-ichou-shojin | 夜 | 精進のお献立 | 動物性の食材と出汁を使わない、野菜と穀物だけの七品。胡麻豆腐は毎朝、店で練り上げます。 | 120 | 30 | ¥11,000/1名 | デポジット ¥2200/名 | 1〜8 | 夜 | room+seat | 不要 | /photos/ichou/menu-m6.jpg |
| m-ichou-kaiseki | 慶事・特別 | 特別会席 | 十一品の会席。お祝いやおもてなしの席に。器は季節ごとに蔵から選び、献立を和紙に認めてお渡しします。 | 180 | 30 | ¥27,500/1名 | 事前全額 | 2〜10 | 夜 | room | 不要 | /photos/ichou/menu-m3.jpg |
| m-ichou-iwai | 慶事・特別 | お祝い膳 | お食い初め・長寿のお祝い・顔合わせに。お部屋ごとお貸し切りの一組さまの料金です(4名さままで/8名さままで)。 | 150 | 30 | 〜4名 ¥88,000/〜8名 ¥154,000 | 事前全額 | 2〜8 | 昼・夜 | room | 不要 | /photos/ichou/menu-iwai.jpg |
オプション
| id | 名称 | 説明 | 料金 | 単位 | 必須 | 排他グループ | 追加分 |
|---|---|---|---|---|---|---|---|
| o-ichou-pair-sake | 季節の日本酒ペアリング | お献立に合わせた五種の地酒を、少しずつ。 | ¥6,600 | 1名 | pairing | ||
| o-ichou-pair-na | お茶とノンアルコールのペアリング | 水出しの煎茶、ほうじ茶、季節の果実の炭酸など四種。 | ¥4,400 | 1名 | pairing | ||
| o-ichou-tai | お祝いの一品(鯛の姿焼き) | お祝いの席に。塩焼きの鯛を一尾、お席でお取り分けします。 | ¥5,500 | 1組 | |||
| o-ichou-flower | 記念日の小さな花束 | お帰りの際に、季節の枝ものを和紙で包んでお渡しします。 | ¥3,300 | 1組 | |||
| o-ichou-rice | 土鍋ご飯のおかわり(折詰) | 炊き込みご飯を、お持ち帰り用の折詰にいたします。 | ¥1,650 | 1名 | |||
| o-ichou-kids | お子さま膳 | 小学生までのお子さまに、同じ素材でやさしい味つけの膳を。 | ¥4,400 | 1組 |
メニューとオプションの紐付け:m-ichou-lunch → [o-ichou-pair-sake, o-ichou-pair-na, o-ichou-rice, o-ichou-flower]/m-ichou-tenshin → [o-ichou-pair-na, o-ichou-flower]/m-ichou-dinner → [o-ichou-pair-sake, o-ichou-pair-na, o-ichou-tai, o-ichou-rice, o-ichou-flower, o-ichou-kids]/m-ichou-hassun → [o-ichou-pair-sake, o-ichou-pair-na]/m-ichou-sushi → [o-ichou-pair-sake, o-ichou-pair-na, o-ichou-flower]/m-ichou-shojin → [o-ichou-pair-sake, o-ichou-pair-na, o-ichou-flower]/m-ichou-kaiseki → [o-ichou-pair-sake, o-ichou-pair-na, o-ichou-tai, o-ichou-flower, o-ichou-kids]/m-ichou-iwai → [o-ichou-tai, o-ichou-flower, o-ichou-kids]
席・部屋・設備
| id | 種別 | 名称 | 説明 | 定員 | 同時利用 | お客様が指定 | 写真 |
|---|---|---|---|---|---|---|---|
| r-ichou-kaede | room | 個室「楓」 | 坪庭に面した掘りごたつの個室 | 2〜4 | 1 | 可 | /photos/ichou/res-r-private.jpg |
| r-ichou-hagi | room | 個室「萩」 | テーブル席の個室。足元が楽なお席です | 2〜4 | 1 | 可 | /photos/ichou/res-hagi.jpg |
| r-ichou-hanare | room | 離れ「桂」 | 中庭を渡った先の、独立した離れ | 4〜8 | 1 | 可 | /photos/ichou/res-r-zashiki.jpg |
| r-ichou-zashiki | room | 座敷「銀杏の間」 | 床の間のある十畳の座敷。お祝いの席に | 4〜10 | 1 | 可 | /photos/ichou/res-zashiki.jpg |
| r-ichou-counter | seat | カウンター | 白木の一枚板。料理長の手元が見えるお席 | 1〜2 | 4 | 可 | /photos/ichou/res-counter.jpg |
スタッフ
| id | 名前 | 肩書 | 権限 | 紹介 | 対応メニュー | 指名料 | 写真 |
|---|---|---|---|---|---|---|---|
| s-ichou-isurugi | 石動 誠一 | 料理長 | manager | 京都の料亭で十五年。器選びから献立を考えます。 | — | — | /photos/staff/isurugi.jpg |
| s-ichou-mashiba | 真柴 ゆり | 女将 | manager | お席のご案内とお飲み物を担当しております。 | — | — | /photos/staff/mashiba.jpg |
| s-ichou-miyauchi | 宮内 蒼 | 板前 | staff | カウンターで、お造りと焼物を担当しています。 | — | — | /photos/staff/miyauchi.jpg |
SPA & THERAPY hana(slug: hana / id: t-hana)
| 項目 | 値 |
|---|---|
| 業種 | spa |
| 欧文ロゴ | SPA & THERAPY |
| キャッチ(ヒーロー) | 身体を、ほどく時間。 |
| 店の一言(写真の上) | 深く息をして、 何もしない時間を。 |
| 紹介文 | 代々木の森にほど近い、四室だけの小さなスパです。セラピストがその日の身体の声を聞き、香りと手の温度で、ゆっくりとほどいていきます。施術の前後には、ハーブティーと静かな休息の時間をご用意しています。 |
| タグ | アロマトリートメント、完全個室、ペアルーム |
| 住所 | 東京都渋谷区代々木 0-0-0(架空の住所) |
| 最寄り | 代々木八幡駅より徒歩4分 |
| 電話 | 03-0000-2202 |
| メール | hello@hana-spa.example |
| 営業時間 | 10:00–21:00(日月火木金土) |
| 定休日 | 水曜 |
| アクセス案内 | 公園通りから一本入った、白いタイルの建物の2階です。エレベーターがございます。 |
| 写真 | hero: /photos/hana/hero.jpg(alt: やわらかな光の入るトリートメントルーム) gallery: /photos/hana/gallery1.jpg(alt: 施術後に過ごすリラクゼーションスペース) |
| テーマ | ブランド色 #5B6B4F/書体 gothic/余白 wide/角丸 medium/ダーク off |
| 言葉づかい | 温度 warm/呼称「様」/予約ボタン「予約する」/完了の一言「ゆっくりお過ごしください。」 |
| 予約ルール | 刻み 30分/受付期限 120分前/予約可能期間 60日/仮押さえ 10分/1組上限 4名/変更期限 1日前 |
| キャンセル規定(段階) | 2日前以上→0%、1日前以上→30%、0日前以上→50% |
| キャンセル規定(本文) | セラピストとお部屋は、おひとりのために時間を確保しています。やむを得ずキャンセルされる場合は、なるべく早めにご連絡ください。前日以降のキャンセルには、下記の料金をいただきます。体調不良の際は、どうぞご無理なさらずご相談ください。 |
| 無断キャンセル | ご連絡なくお越しにならなかった場合は、施術料金の全額を頂戴します。 |
| ウィジェット | floating/「予約する」 |
| 通知デザイン | card |
確認メールの文面(confirm)
件名:【{{店名}}】ご予約ありがとうございます
{{お客様名}}
ご予約ありがとうございます。
以下の内容でお待ちしております。
日時 {{日時}}
メニュー {{メニュー}}
予約番号 {{予約番号}}
当日は10分ほど前にお越しいただくと、ゆっくりとお茶を召し上がっていただけます。
メニュー
| id | カテゴリ | 名称 | 説明 | 分 | 片付け | 料金 | 決済 | 人数 | 提供時間帯 | 必要リソース | 担当 | 写真 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| m-hana-aroma60 | ボディ | アロマ オイルトリートメント 60分 | その日の体調に合わせて、三種の精油からブレンドを選びます。背中と脚を中心に、呼吸が深くなる速さで。 | 60 | 15 | ¥13,200/1名 | デポジット ¥3000/名 | 1〜1 | 全 | room | 要 | /photos/hana/menu-aroma60.jpg |
| m-hana-aroma90 | ボディ | アロマ オイルトリートメント 90分 | 全身をゆっくりと。首と肩、頭まで手が届くので、施術のあとは眠るように身体が軽くなります。 | 90 | 15 | ¥18,700/1名 | デポジット ¥3000/名 | 1〜1 | 全 | room | 要 | /photos/hana/menu-aroma90.jpg |
| m-hana-stone | ボディ | ホットストーン セラピー | 温めた玄武岩を背中に置き、奥に溜まったこわばりを熱でゆるめます。冷えやすい方、眠りが浅い方に。 | 90 | 20 | ¥22,000/1名 | 事前全額 | 1〜1 | 全 | room | 要 | /photos/hana/menu-m2.jpg |
| m-hana-facial | フェイシャル・ヘッド | hana フェイシャル | 肌をととのえるクレンジングと、顔まわりのリンパケア。仕上げのパックの間は、デコルテと手をほぐします。 | 75 | 15 | ¥16,500/1名 | デポジット ¥3000/名 | 1〜1 | 全 | room | 要 | /photos/hana/menu-facial.jpg |
| m-hana-head | フェイシャル・ヘッド | ドライヘッドスパ | 服のまま、オイルを使わずに頭と首をほぐします。お仕事の合間や、お買い物の前にも。 | 45 | 10 | ¥8,800/1名 | 当日 | 1〜1 | 全 | room | 要 | /photos/hana/menu-head.jpg |
| m-hana-reflex | フェイシャル・ヘッド | リフレクソロジー | 足湯のあと、足裏とふくらはぎをゆっくりと。立ち仕事の多い方、むくみが気になる日に。 | 45 | 10 | ¥7,700/1名 | 当日 | 1〜1 | 全 | room | 要 | /photos/hana/menu-reflex.jpg |
| m-hana-pair | ペア・クラス | ペアトリートメント 90分 | おふたりで、同じお部屋で。セラピスト二名が同時に施術します。記念日や、ご家族の贈り物に。 | 90 | 20 | ¥19,800/1名 | 事前全額 | 2〜2 | 全 | room | 不要 | /photos/hana/menu-pair.jpg |
| m-hana-yoga | ペア・クラス | 朝のヨガ(少人数クラス) | 定員八名の、呼吸を中心にしたやさしいヨガ。初めての方も、身体のかたい方も大丈夫です。マットはお貸しします。 | 60 | 0 | ¥3,300/1名 | 当日 | 1〜4 | 全 | seat | 不要 | /photos/hana/menu-yoga.jpg |
オプション
| id | 名称 | 説明 | 料金 | 単位 | 必須 | 排他グループ | 追加分 |
|---|---|---|---|---|---|---|---|
| o-hana-ext15 | 15分の延長 | 気になる部分を、もう少しだけ。 | ¥3,300 | 1名 | ext | 15 | |
| o-hana-ext30 | 30分の延長 | 全身を、さらにゆっくりと。 | ¥6,600 | 1名 | ext | 30 | |
| o-hana-hand | ハンドトリートメント | 指先から肘まで、温かいオイルで。 | ¥2,200 | 1名 | 15 | ||
| o-hana-foot | 炭酸泉の足湯 | 施術の前に、足元から身体を温めます。 | ¥1,100 | 1名 | 10 | ||
| o-hana-home | ホームケアのオイル(30ml) | 施術で使ったブレンドを、小さな瓶に詰めてお持ち帰りいただけます。 | ¥3,850 | 1組 | |||
| o-hana-tea | ハーブティーのお土産 | カモミールとレモングラスのブレンドを、一週間分。 | ¥1,320 | 1組 |
メニューとオプションの紐付け:m-hana-aroma60 → [o-hana-ext15, o-hana-ext30, o-hana-hand, o-hana-foot, o-hana-home]/m-hana-aroma90 → [o-hana-ext15, o-hana-ext30, o-hana-hand, o-hana-foot, o-hana-home, o-hana-tea]/m-hana-stone → [o-hana-ext30, o-hana-foot, o-hana-tea]/m-hana-facial → [o-hana-ext15, o-hana-hand, o-hana-home]/m-hana-head → [o-hana-ext15, o-hana-hand]/m-hana-reflex → [o-hana-ext15, o-hana-foot]/m-hana-pair → [o-hana-ext30, o-hana-tea, o-hana-home]/m-hana-yoga → [o-hana-tea]
席・部屋・設備
| id | 種別 | 名称 | 説明 | 定員 | 同時利用 | お客様が指定 | 写真 |
|---|---|---|---|---|---|---|---|
| r-hana-1 | room | ルーム1「萌」 | 窓から木々が見える、明るいお部屋 | 1〜1 | 1 | 可 | /photos/hana/res-room1.jpg |
| r-hana-2 | room | ルーム2「凪」 | 照明を落とした、静かなお部屋 | 1〜1 | 1 | 可 | /photos/hana/res-room2.jpg |
| r-hana-3 | room | ルーム3「澄」 | シャワーブース付きのお部屋 | 1〜1 | 1 | 可 | /photos/hana/res-room3.jpg |
| r-hana-pair | room | ペアルーム「結」 | ベッドが二台並ぶ、おふたりのためのお部屋 | 2〜2 | 1 | 可 | /photos/hana/res-r-room2.jpg |
| r-hana-studio | seat | ヨガスタジオ | 板張りの、八名までのスタジオ | 1〜4 | 8 | 不可 | /photos/hana/res-studio.jpg |
スタッフ
| id | 名前 | 肩書 | 権限 | 紹介 | 対応メニュー | 指名料 | 写真 |
|---|---|---|---|---|---|---|---|
| s-hana-hayase | 早瀬 美月 | 店長・セラピスト | manager | 深い圧が得意です。肩と背中のこりを、時間をかけてほどきます。 | m-hana-aroma60, m-hana-aroma90, m-hana-stone, m-hana-facial, m-hana-head, m-hana-reflex | ¥2,200 | /photos/staff/hayase.jpg |
| s-hana-yuzuki | 柚木 杏奈 | セラピスト | staff | フェイシャルとヘッドスパを中心に。やわらかい手技が好評です。 | m-hana-aroma60, m-hana-aroma90, m-hana-facial, m-hana-head | ¥1,100 | /photos/staff/yuzuki.jpg |
| s-hana-fukami | 深見 さくら | セラピスト | staff | ホットストーンの資格を持っています。冷えにお悩みの方へ。 | m-hana-aroma60, m-hana-aroma90, m-hana-stone, m-hana-reflex | ¥1,100 | /photos/staff/fukami.jpg |
| s-hana-hatori | 羽鳥 玲 | セラピスト | staff | 香りの調合を担当。その日の気分に合うブレンドをご提案します。 | m-hana-aroma60, m-hana-aroma90, m-hana-facial, m-hana-reflex | ¥1,100 | /photos/staff/hatori.jpg |
| s-hana-onodera | 小野寺 湊 | セラピスト | staff | スポーツのあとの疲れや、脚のむくみのケアが得意です。 | m-hana-aroma60, m-hana-aroma90, m-hana-stone, m-hana-head, m-hana-reflex | ¥1,100 | /photos/staff/onodera.jpg |
青葉クリニック 美容外来(slug: aoba / id: t-aoba)
| 項目 | 値 |
|---|---|
| 業種 | clinic |
| 欧文ロゴ | AOBA CLINIC |
| キャッチ(ヒーロー) | 肌のことを、正確に。 |
| 店の一言(写真の上) | 診断から、ていねいに。 納得してから、はじめます。 |
| 紹介文 | 皮膚科専門医が、診察とカウンセリングから担当する自由診療の外来です。施術の前に、肌の状態・期待できる効果・ダウンタイム・費用を必ずご説明し、納得いただいてから始めます。初めての方は「初診カウンセリング」からご予約ください。 |
| タグ | 皮膚科専門医、自由診療、女性医師在籍 |
| 住所 | 東京都目黒区青葉台 0-0-0(架空の住所) |
| 最寄り | 中目黒駅 正面改札より徒歩5分 |
| 電話 | 03-0000-3303 |
| メール | contact@aoba-clinic.example |
| 営業時間 | 午前 10:00–13:00 / 午後 14:30–19:00(月火水金土) |
| 定休日 | 日曜、木曜 |
| アクセス案内 | 目黒川沿いのビル3階です。1階のカフェ横のエントランスからお入りください。 |
| 写真 | hero: /photos/aoba/hero.jpg(alt: 明るい待合室と受付) gallery: /photos/aoba/gallery1.jpg(alt: 診察室) |
| テーマ | ブランド色 #2F4A6D/書体 gothic/余白 standard/角丸 soft/ダーク off |
| 言葉づかい | 温度 plain/呼称「様」/予約ボタン「予約する」/完了の一言「ご来院をお待ちしています。」 |
| 予約ルール | 刻み 15分/受付期限 60分前/予約可能期間 60日/仮押さえ 10分/1組上限 2名/変更期限 1日前 |
| キャンセル規定(段階) | 1日前以上→0%、0日前以上→50% |
| キャンセル規定(本文) | 予約の変更・キャンセルは、前日までにこの画面またはお電話でお手続きください。当日のキャンセルには、施術料金の50%を頂戴します。体調の変化(発熱・日焼け・妊娠の可能性など)がある場合は、施術ができないことがありますので、事前にご相談ください。 |
| 無断キャンセル | ご連絡のない無断キャンセルが2回続いた場合、以降のWeb予約をお受けできないことがあります。 |
| ウィジェット | inline/「予約する」 |
| 通知デザイン | card |
確認メールの文面(confirm)
件名:【{{店名}}】予約完了のお知らせ
{{お客様名}}
以下の内容で予約が完了しました。
日時 {{日時}}
施術 {{メニュー}}
予約番号 {{予約番号}}
当日は保険証または本人確認書類をお持ちください。
メニュー
| id | カテゴリ | 名称 | 説明 | 分 | 片付け | 料金 | 決済 | 人数 | 提供時間帯 | 必要リソース | 担当 | 写真 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| m-aoba-first | 診察・カウンセリング | 初診カウンセリング | 医師が肌の状態を診察し、治療の選択肢・期待できる効果・ダウンタイム・費用をご説明します。当日の施術はありません。 | 30 | 0 | ¥3,300/1組 | 当日 | 1〜2 | 全 | room | 指定担当のみ | /photos/aoba/menu-first.jpg |
| m-aoba-revisit | 診察・カウンセリング | 再診・経過の確認 | 治療後の経過を確認し、次回の治療計画を医師と相談します。 | 15 | 0 | ¥1,100/1組 | 当日 | 1〜1 | 全 | room | 指定担当のみ | /photos/aoba/menu-revisit.jpg |
| m-aoba-pico | 肌の治療 | ピコトーニング(シミ・肝斑) | 弱い出力のレーザーを顔全体に均一に照射し、肝斑とくすみを少しずつ薄くします。2〜4週間ごとに5回程度が目安です。 | 30 | 10 | ¥16,500/1組 | 当日 | 1〜1 | 全 | room+equipment | 指定担当のみ | /photos/aoba/menu-pico.jpg |
| m-aoba-derma | 肌の治療 | ダーマペン(ニキビ跡・毛穴) | 極細の針で肌に小さな穴を開け、肌自身の回復力でニキビ跡と毛穴を整えます。赤みは2〜3日で落ち着きます。 | 60 | 15 | ¥27,500/1組 | 事前全額 | 1〜1 | 全 | room | 指定担当のみ | /photos/aoba/menu-derma.jpg |
| m-aoba-hydra | ケア・脱毛 | ハイドラフェイシャル | 水流で毛穴の汚れを吸引しながら、美容液を浸透させます。施術直後からメイクができ、ダウンタイムはありません。 | 60 | 15 | ¥19,800/1組 | デポジット ¥5000 | 1〜1 | 全 | room | 要 | /photos/aoba/menu-hydra.jpg |
| m-aoba-peel | ケア・脱毛 | ケミカルピーリング | 古い角質をやさしく取り除き、ニキビとくすみを防ぎます。2週間ごとの継続がおすすめです。 | 30 | 10 | ¥8,800/1組 | 当日 | 1〜1 | 全 | room | 要 | /photos/aoba/menu-peel.jpg |
| m-aoba-ion | ケア・脱毛 | ビタミンC イオン導入 | 微弱な電流で、高濃度のビタミンCを肌の奥まで届けます。ピーリングとの組み合わせもおすすめです。 | 30 | 5 | ¥6,600/1組 | 当日 | 1〜1 | 全 | room | 要 | /photos/aoba/menu-ion.jpg |
| m-aoba-hair | ケア・脱毛 | 医療脱毛(顔) | 医療用レーザーで、額・頬・鼻下・あごの産毛を処理します。1〜2か月ごとに5〜8回が目安です。 | 30 | 10 | ¥12,100/1組 | 当日 | 1〜1 | 全 | room+equipment | 要 | /photos/aoba/menu-hair.jpg |
オプション
| id | 名称 | 説明 | 料金 | 単位 | 必須 | 排他グループ | 追加分 |
|---|---|---|---|---|---|---|---|
| o-aoba-exam | 施術前の医師診察 | 施術の当日に、医師が肌の状態を確認します。この施術では必ず行います。 | ¥1,100 | 1組 | 必須 | ||
| o-aoba-numb | 麻酔クリーム | 痛みが心配な方に。施術の前に20分ほど塗布します。 | ¥2,200 | 1組 | 15 | ||
| o-aoba-calm | 鎮静パック | 施術後の赤みとほてりを、冷却パックで落ち着かせます。 | ¥1,650 | 1組 | 10 | ||
| o-aoba-scan | 肌画像診断 | 専用カメラで、シミ・毛穴・赤みを数値で記録します。経過の比較に使います。 | ¥3,300 | 1組 | 15 | ||
| o-aoba-home | ホームケア美容液(3週間分) | 施術後の肌に合わせた美容液をお渡しします。 | ¥5,500 | 1組 | |||
| o-aoba-uv | 日焼け止め(医療機関専売品) | 治療中の肌にも使える、低刺激の日焼け止めです。 | ¥2,750 | 1組 |
メニューとオプションの紐付け:m-aoba-first → [o-aoba-scan]/m-aoba-revisit → []/m-aoba-pico → [o-aoba-exam, o-aoba-numb, o-aoba-calm, o-aoba-uv]/m-aoba-derma → [o-aoba-exam, o-aoba-numb, o-aoba-calm, o-aoba-home]/m-aoba-hydra → [o-aoba-calm, o-aoba-home, o-aoba-uv]/m-aoba-peel → [o-aoba-calm, o-aoba-uv]/m-aoba-ion → [o-aoba-calm]/m-aoba-hair → [o-aoba-numb, o-aoba-calm]
席・部屋・設備
| id | 種別 | 名称 | 説明 | 定員 | 同時利用 | お客様が指定 | 写真 |
|---|---|---|---|---|---|---|---|
| r-aoba-exam1 | room | 診察室1 | 1〜2 | 1 | 不可 | /photos/aoba/res-exam1.jpg | |
| r-aoba-exam2 | room | 診察室2 | 1〜2 | 1 | 不可 | /photos/aoba/res-r-exam.jpg | |
| r-aoba-treat | room | 処置室 | 1〜1 | 1 | 不可 | /photos/aoba/res-treat.jpg | |
| r-aoba-laser | equipment | レーザー機器 | ピコレーザー・脱毛レーザー共用 | 1〜1 | 1 | 不可 | /photos/aoba/res-laser.jpg |
スタッフ
| id | 名前 | 肩書 | 権限 | 紹介 | 対応メニュー | 指名料 | 写真 |
|---|---|---|---|---|---|---|---|
| s-aoba-takatsuki | 高槻 遥 | 院長・皮膚科専門医 | manager | 日本皮膚科学会認定の専門医。肝斑とニキビ跡の治療を専門にしています。 | m-aoba-first, m-aoba-revisit, m-aoba-pico, m-aoba-derma, m-aoba-hair | ¥2,200 | /photos/staff/takatsuki.jpg |
| s-aoba-kiryu | 桐生 周 | 医師 | staff | 形成外科出身。治療の選択肢を、図を使って丁寧にご説明します。 | m-aoba-first, m-aoba-revisit, m-aoba-pico, m-aoba-derma, m-aoba-hair | ¥1,100 | /photos/staff/kiryu.jpg |
| s-aoba-miura | 三浦 菜々 | 看護師 | staff | ハイドラフェイシャルとピーリングを担当しています。 | m-aoba-hydra, m-aoba-peel, m-aoba-ion, m-aoba-hair | — | /photos/staff/miura.jpg |
| s-aoba-horie | 堀江 理沙 | 看護師 | staff | 肌のお悩みを、日々のスキンケアの面からもご相談ください。 | m-aoba-hydra, m-aoba-peel, m-aoba-ion | — | /photos/staff/horie.jpg |
付録B 画面の文言(言葉づかい)の全文
lib/wording/ の辞書。関数の項目は例の値を入れた結果を示す(holdLine は 18:00・10分、fullDay は「10月3日(土)17:30」、guests は2名)。steps はステップインジケータの5段。
| キー | formal(飲食・懐石) | warm(スパ) | plain(クリニック) | en |
|---|---|---|---|---|
| menuNoun | お献立 | メニュー | 施術 | Menu |
| bookVerb | ご予約 | 予約する | 予約する | Reserve |
| menuHeading | お献立をお選びください | メニューを選んでください | 施術を選択してください | Choose your menu |
| menuSub | 季節ごとに、器と献立を改めております | その日の気分で、ゆっくり選んでください | 初めての方は「初診カウンセリング」からご予約ください | Take your time |
| optionsHeading | 人数とお飲み物 | オプション | オプション | Guests & options |
| optionsSub | ご人数によって、ご案内できるお席が変わります | 延長やお持ち帰りを、必要なぶんだけ | 必要なものだけを選択してください | Available seating depends on your party size |
| partyLabel | ご人数 | 人数 | 人数 | Party size |
| resourceHeading | お席のご希望 | 担当とお部屋 | 担当医・担当者 | Your preference |
| resourceSub | ご指定がなければ、当店にてご用意いたします | 指名がなければ、空いているセラピストがご案内します | 指名がなければ、空いている担当者が対応します | If you have no preference, we will arrange it for you |
| staffAny | どなたでも | どなたでも | 指名なし | No preference |
| staffAnySub | 当店にてご案内いたします | お店でご案内します | 空いている担当者が対応します | We will arrange it for you |
| seatAny | おまかせ | おまかせ | 指定なし | No preference |
| seatAnySub | ご人数に合うお席をご用意いたします | 空いているお部屋をご用意します | 空いている部屋を使用します | We will prepare a suitable seat |
| dateHeading | ご来店日をお選びください | 日にちを選んでください | 来院日を選択してください | Select a date |
| dateSub | 印で、お席の空き具合をご覧いただけます | 印で、空き具合がわかります | 印で、予約の空き状況がわかります | The marks show availability for each day |
| timeHeading | お時間をお選びください | 時間を選んでください | 時間を選択してください | Select a time |
| timeSub | 10月3日(土)17:30 | 10月3日(土)17:30 | 10月3日(土)17:30 | 10月3日(土)17:30 |
| holdLine | 18:00 のお席を 10分間 お取り置きしております | 18:00 の枠を 10分間 確保しています | 18:00 の枠を 10分間 確保しています | We are holding 18:00 for you for 10 minutes |
| detailsHeading | お客様のご連絡先 | ご連絡先 | 連絡先 | Your details |
| detailsSub | ご予約の確認とご連絡にのみ使わせていただきます | ご予約の確認とご連絡にだけ使います | 予約の確認と連絡にのみ使用します | Used only to confirm and contact you about this reservation |
| paymentHeading | お支払いとお取り消しについて | お支払いとキャンセルについて | 支払いとキャンセル規定 | Payment & cancellation |
| paymentSub | ご確定の前に、お取り消しの規定をご確認ください | 予約の前に、キャンセルの規定をご確認ください | 予約の前に、キャンセル規定を確認してください | Please review the cancellation policy before confirming |
| confirmHeading | ご予約内容のご確認 | ご予約内容の確認 | 予約内容の確認 | Review your reservation |
| confirmSub | お間違いがなければ、ご確定ください | よろしければ、予約を確定してください | 内容を確認して、予約を確定してください | If everything looks right, please confirm |
| confirmCta | この内容で予約する | この内容で予約する | この内容で予約する | Confirm reservation |
| completeTitle | ご予約を承りました | ご予約ありがとうございます | 予約が完了しました | Reservation confirmed |
| completeSub | 当日お目にかかれますことを、楽しみにしております | お会いできるのを楽しみにしています | 当日は保険証または本人確認書類をお持ちください | We look forward to welcoming you |
| nextCta | 次へ | 次へ | 次へ | Continue |
| conflictTitle | 申し訳ございません | 申し訳ございません | 申し訳ございません | We are sorry |
| conflictBody | このお時間は、他のお客様が先にご予約されました。 | この時間は、他のお客様が先にご予約されました。 | この時間は、他の方が先に予約されました。 | Another guest has just reserved this time. |
| expiredBody | お取り置きのお時間が過ぎました。もう一度お時間をお選びください。ご入力の内容は保存されております。 | 確保していた時間が過ぎました。もう一度、時間を選んでください。ご入力の内容は保存されています。 | 確保していた時間が過ぎました。もう一度、時間を選択してください。入力内容は保存されています。 | Your hold has expired. Please choose a time again — your details have been kept. |
| fullDay | この日は満席でございます。最短のご案内は 10月3日(土)17:30 です | この日は満席です。最短の空きは 10月3日(土)17:30 です | この日は予約がいっぱいです。最短の空きは 10月3日(土)17:30 です | This day is fully booked. The earliest opening is 10月3日(土)17:30 |
| steps | お献立/人数・お席/日時/ご連絡先/ご確認 | メニュー/オプション・担当/日時/ご連絡先/確認 | 施術/担当/日時/連絡先/確認 | Menu/Guests/Date & time/Details/Review |
| seatNoun | お席 | お部屋 | 部屋 | Seat |
| arriveNote | 当日は、ご予約のお時間の5分前までにお越しくださいませ | 当日は10分ほど前にお越しいただくと、ゆっくりお茶を召し上がっていただけます | 当日は予約時間の10分前までに受付をお済ませください | Please arrive a few minutes before your reservation |
| guests | 2名様 | 2名様 | 2名 | 2 guests |
その他の定型文(lib/i18n):戻る/ご予約内容/未選択/合計/所要時間/日時/人数/お席/担当/オプション/空きあり/残りわずか/満席/定休日/他のお客様が選択中/最短のご案内/この日時を選ぶ/キャンセル待ち/今日/明日/今週末/これはデモです。実際の予約・連絡は発生しません/予約番号/コピー/この後の流れ/English(英語版は Back / Your reservation / Not selected / Total / Duration / Date & time / Guests / Seat / Staff / Options / Available / Limited / Full / Closed / Being booked / Earliest available / Choose this / Waitlist / Today / Tomorrow / This weekend …)。
付録C 画像の一覧と生成指示
全56枚。 生成画像41枚(プロンプト=本文+系統の仕上げ指示)と、写真素材15枚(Openverse の CC BY / CC BY-SA)。写真素材が手に入らない・質が合わない場合は、同じ枠を同じ系統の仕上げ指示で生成してよい(その場合も一覧で確認する)。サイズと加工は 8.9。
共通の仕上げ指示(プロンプトの末尾に必ず付ける)
| 系統 | 末尾に付ける文 |
|---|---|
| ichou | Editorial photograph for a refined Japanese kaiseki restaurant. Dim warm light, dark lacquer, aged wood, washi paper, shallow depth of field, quiet luxury, realistic, natural colors, no text, no logos, no watermark. |
| hana | Editorial photograph for a serene boutique day spa in Tokyo. Natural light oak, white linen, soft warm daylight, a few green plants, calm and airy, realistic, no text, no logos, no watermark. |
| aoba | Editorial photograph for a modern Japanese aesthetic dermatology clinic. Bright and clean, white walls and pale wood, soft daylight, calm and trustworthy, realistic, no blood, no needles visible close-up, no text, no logos, no watermark. |
| portrait | Professional editorial portrait photograph, chest-up, looking gently at camera with a calm warm expression, natural soft window light, softly blurred neutral warm background, realistic skin, no text, no logos. |
生成した画像(Cloudflare Workers AI @cf/leonardo/lucid-origin)
| 公開パス | 生成サイズ | 系統 | プロンプト(本文) |
|---|---|---|---|
| /photos/ichou/menu-iwai.jpg | 1600×1200 | ichou | A celebratory Japanese feast: a whole salt-grilled sea bream (tai) on a red lacquer tray with gold accents, surrounded by small kaiseki dishes, red and white rice, seasonal flowers, set for a family celebration. |
| /photos/ichou/menu-sushi.jpg | 1600×1200 | ichou | Sushi kaiseki: ten pieces of nigiri sushi neatly arranged on a hinoki wooden board at a sushi counter, with a small bowl of clear soup and pickled ginger. |
| /photos/ichou/menu-tenshin.jpg | 1600×1200 | ichou | A hana-tenshin lunch: a black lacquered square box divided into nine small compartments with simmered seasonal vegetables, grilled fish, sashimi, rolled omelet and rice, on a dark wooden table by a window. |
| /photos/ichou/res-hagi.jpg | 1600×1200 | ichou | A small private dining room with a dark wooden table and four chairs, shoji screens glowing softly, a single branch of bush clover in a vase, table set for kaiseki. |
| /photos/ichou/res-zashiki.jpg | 1600×1200 | ichou | A ten-tatami Japanese banquet room (zashiki) with a tokonoma alcove, hanging scroll and ikebana, a long low lacquer table set for a celebration, shoji doors open to a small garden. |
| /photos/ichou/res-counter.jpg | 1600×1200 | ichou | A traditional Japanese kappo counter: a single long light hinoki wood counter with eight simple wooden stools on the guest side, facing an open chef's workspace with knives and ceramic dishes on shelves, no people, warm pendant spotlights, evening. |
| /photos/hana/menu-aroma60.jpg | 1600×1200 | hana | Aromatherapy oil massage: a therapist's hands gliding over a client's upper back with warm oil, the client lying face down under a white linen towel, face not visible, amber essential oil bottles nearby. |
| /photos/hana/menu-aroma90.jpg | 1600×1200 | hana | Close-up of a therapist pouring golden massage oil from an amber glass bottle into her palm beside a treatment bed with folded white towels and a sprig of eucalyptus. |
| /photos/hana/menu-facial.jpg | 1600×1200 | hana | A facial treatment: a relaxed woman lying with eyes closed, head wrapped in a white towel, a therapist's hands gently massaging her cheeks, soft light, serene. |
| /photos/hana/menu-head.jpg | 1600×1200 | hana | Dry head spa: a clothed client reclining in a treatment chair with eyes closed while a therapist massages the scalp with both hands, calm dim warm room. |
| /photos/hana/menu-reflex.jpg | 1600×1200 | hana | Foot reflexology: feet resting on a white towel after a warm foot bath in a wooden basin, a therapist's thumbs pressing the sole, eucalyptus leaves nearby. |
| /photos/hana/menu-pair.jpg | 1600×1200 | hana | A couples treatment suite with two massage beds side by side, white linen, rolled towels, candles and a small bowl of flowers, warm late-afternoon light. |
| /photos/hana/menu-yoga.jpg | 1600×1200 | hana | A small morning yoga class of four women on mats in a light wooden studio, gentle seated breathing pose, soft sunlight through large windows, plants. |
| /photos/hana/res-room1.jpg | 1600×1200 | hana | A bright single treatment room with a massage bed covered in white linen, a large window with trees outside, light oak walls and a small plant. |
| /photos/hana/res-room2.jpg | 1600×1200 | hana | A quiet dim single treatment room with a massage bed, low warm indirect lighting, dark wood and linen, very calm. |
| /photos/hana/res-room3.jpg | 1600×1200 | hana | A single treatment room with a massage bed and a frosted glass shower booth in the corner, light stone and oak, clean and bright. |
| /photos/hana/res-studio.jpg | 1600×1200 | hana | An empty small yoga studio with a pale wooden floor, eight rolled mats along the wall, large windows with morning light and green plants. |
| /photos/aoba/hero.jpg | 1920×1088 | aoba | The reception and waiting lounge of a small modern aesthetic clinic: a pale wood reception counter, soft lounge chairs, large windows with a green tree outside, calm and bright. |
| /photos/aoba/menu-first.jpg | 1600×1200 | aoba | A skin consultation at a small round white table: a female doctor in a white coat, seen from the side, shows a skin analysis image on a tablet to a woman patient sitting across from her, both visible, reassuring conversation. |
| /photos/aoba/menu-revisit.jpg | 1600×1200 | aoba | A doctor in a white coat gently checking a patient's cheek skin with a small handheld magnifying dermatoscope, bright examination room. |
| /photos/aoba/menu-pico.jpg | 1600×1200 | aoba | Laser toning facial treatment: a patient lying on a treatment bed wearing protective eye goggles while a gloved practitioner holds a slim laser handpiece near her cheek, clean clinical room. |
| /photos/aoba/menu-derma.jpg | 1600×1200 | aoba | A skin renewal treatment with a small microneedling pen held by gloved hands near a patient's cheek, patient lying calmly, clean and gentle, no blood. |
| /photos/aoba/menu-hydra.jpg | 1600×1200 | aoba | A hydro facial treatment: a practitioner in gloves using a small vacuum hydrating wand on a relaxed patient's face, device with clear serum bottles nearby. |
| /photos/aoba/menu-peel.jpg | 1600×1200 | aoba | A chemical peel: a gloved practitioner applying a clear solution to a patient's forehead with a soft fan brush, patient's eyes closed, clean white towels. |
| /photos/aoba/menu-ion.jpg | 1600×1200 | aoba | Vitamin C ion treatment: a gloved practitioner gently glides a slim white handheld beauty device with a small round metal head across a relaxed patient's cheek, three amber serum vials on a white tray beside. |
| /photos/aoba/menu-hair.jpg | 1600×1200 | aoba | Facial laser hair removal: a patient wearing protective goggles, a gloved practitioner holding a laser hair removal handpiece at the jawline, clean clinic. |
| /photos/aoba/res-exam1.jpg | 1600×1200 | aoba | A small consultation room with a white desk, two chairs, a computer monitor and a skin analysis camera, pale wood accents, soft daylight. |
| /photos/aoba/res-treat.jpg | 1600×1200 | aoba | A clinic treatment room with an adjustable white treatment bed, a medical aesthetic laser device on a cart, white cabinets, very clean and bright. |
| /photos/aoba/res-laser.jpg | 1600×1200 | aoba | A modern white medical aesthetic laser machine with an articulated arm and handpiece in a clean treatment room. |
| /photos/staff/isurugi.jpg | 1024×1024 | portrait | A Japanese head chef in his early fifties wearing a white chef's coat, short grey hair, standing in a traditional kaiseki kitchen with wooden shelves blurred behind. |
| /photos/staff/mashiba.jpg | 1024×1024 | portrait | A Japanese restaurant proprietress (okami) in her fifties wearing an elegant muted green kimono, hair neatly tied up, in a softly lit tatami room. |
| /photos/staff/miyauchi.jpg | 1024×1024 | portrait | A Japanese cook in his early thirties wearing a traditional plain white kappogi smock with a simple collar and a plain white headband, arms relaxed, in a softly lit wooden kitchen. Completely plain fabric. |
| /photos/staff/hayase.jpg | 1024×1024 | portrait | A Japanese spa manager and therapist in her early forties wearing a sage green linen tunic uniform, shoulder-length hair tied back, in a bright spa. |
| /photos/staff/yuzuki.jpg | 1024×1024 | portrait | A Japanese female spa therapist in her early thirties wearing a sage green linen tunic uniform, bob haircut, gentle smile, bright spa background. |
| /photos/staff/fukami.jpg | 1024×1024 | portrait | A Japanese female spa therapist in her late twenties wearing a sage green linen tunic uniform, long hair in a low bun, bright spa background. |
| /photos/staff/hatori.jpg | 1024×1024 | portrait | A Japanese female aromatherapist in her mid thirties wearing a sage green linen tunic uniform, short hair, calm expression, shelves with small amber bottles blurred behind. |
| /photos/staff/onodera.jpg | 1024×1024 | portrait | A Japanese male spa therapist in his early thirties wearing a sage green linen tunic uniform, short black hair, friendly, bright spa background. |
| /photos/staff/takatsuki.jpg | 1024×1024 | portrait | A Japanese female dermatologist in her mid forties wearing a simple navy knit top under a plain white cardigan-style coat, shoulder-length hair, confident and kind, bright clinic background. Completely plain fabric. |
| /photos/staff/kiryu.jpg | 1024×1024 | portrait | A Japanese male doctor in his early forties wearing a white coat and light blue shirt, short neat hair, thin glasses, bright clinic background. |
| /photos/staff/miura.jpg | 1024×1024 | portrait | A Japanese female nurse in her early thirties wearing navy medical scrubs, hair tied back, warm smile, bright clinic background. |
| /photos/staff/horie.jpg | 1024×1024 | portrait | A Japanese female nurse in her late twenties wearing navy medical scrubs, short bob hair, gentle expression, bright clinic background. |
写真素材(Openverse・CC ライセンス。作者表示が必要)
| 公開パス | タイトル | 作者 | ライセンス | 取得元 |
|---|---|---|---|---|
| /photos/ichou/hero.jpg | Former Miura Residence the tsuboniwa seen from the zashiki through the engawa Fukuoka 20241114 | Hirho | CC BY-SA 4.0 | https://commons.wikimedia.org/w/index.php?curid=155516198 |
| /photos/ichou/gallery1.jpg | Shumokukan washitsu 1 ac (5) | Asturio Cantabrio | CC BY-SA 4.0 | https://commons.wikimedia.org/w/index.php?curid=141174147 |
| /photos/ichou/menu-m1.jpg | Jisaku Kaiseki Ryori 01 | Chris 73 | CC BY-SA 3.0 | https://commons.wikimedia.org/w/index.php?curid=1087715 |
| /photos/ichou/menu-m2.jpg | Kaiseki Hyoki, Kyoto 懐石 瓢樹 | Jun Seita | CC BY 2.0 | https://www.flickr.com/photos/90454079@N00/6952230469 |
| /photos/ichou/menu-m3.jpg | Sashimi plate, Spanish mackerel, Kawahagi, Japanese sake | City Foodsters | CC BY 2.0 | https://www.flickr.com/photos/89060048@N03/14154905302 |
| /photos/ichou/menu-m4.jpg | Zuwai Crab marinated in vinegar, Red Caviar, Kimiyaki Beef, Baigai Amani, Yumepirika Rice and Hatta, Yuzu flavored Sushi | City Foodsters | CC BY 2.0 | https://www.flickr.com/photos/89060048@N03/11652423454 |
| /photos/ichou/menu-m6.jpg | Fukuchiin shojin ryori appetizer | Jpatokal | CC BY-SA 4.0 | https://commons.wikimedia.org/w/index.php?curid=123674223 |
| /photos/ichou/res-r-private.jpg | Former Ryotei Kikusui ac (6) | Asturio Cantabrio | CC BY-SA 4.0 | https://commons.wikimedia.org/w/index.php?curid=156461384 |
| /photos/ichou/res-r-zashiki.jpg | Former Toki House 1F washitsu ac (1) | Asturio Cantabrio | CC BY-SA 4.0 | https://commons.wikimedia.org/w/index.php?curid=144536426 |
| /photos/hana/hero.jpg | Day Spa Interior Photography | satheeshsankaran.com | CC BY-SA 2.0 | https://www.flickr.com/photos/96149081@N03/53526139040 |
| /photos/hana/gallery1.jpg | Day Spa Interior Photography | satheeshsankaran.com | CC BY-SA 2.0 | https://www.flickr.com/photos/96149081@N03/53525879438 |
| /photos/hana/menu-m2.jpg | Indoor Spa - The Cliff Bay | PortoBay Trade | CC BY 2.0 | https://www.flickr.com/photos/24001499@N03/3254755265 |
| /photos/hana/res-r-room2.jpg | Spa Room | Dennis Wong | CC BY 2.0 | https://www.flickr.com/photos/97247234@N00/3818488264 |
| /photos/aoba/gallery1.jpg | Modern medical office interior design | Shixart1985 | CC BY 2.0 | https://commons.wikimedia.org/w/index.php?curid=186238608 |
| /photos/aoba/res-r-exam.jpg | Modern clinic interior design | Shixart1985 | CC BY 2.0 | https://commons.wikimedia.org/w/index.php?curid=186238601 |

