02 アーキテクチャ(構成と技術選定)と 05 実現性とリスクは、3つの文書の根拠として間に置いています。エンジニアの方は 02 → 03 → 04 の順に読み、04 の時間に「足りない/多い」をご指摘ください。
| 役割 | 人数の目安 | 見える範囲 | 主な操作 | 端末 |
|---|---|---|---|---|
| システム管理(EXPLACE) | 1〜2 | 全テナント(運用時のみ・記録に残す) | テナント・店舗の追加、取り込み設定、障害対応 | PC |
| 本部 | 数名 | 自社の全加盟店・全店舗 | 全店の予約表、二重予約の一覧、マスタ、CSV | PC |
| 加盟店オーナー | 未決 | 自分の加盟店の店舗だけ | 自店の予約表・マスタ・CSV | PC・スマホ |
| 店長 | 店舗数 | 自店舗だけ | 予約の入力・変更、二重予約の解消、枠閉じタスク、シフト | タブレット・スマホ |
| スタッフ | 20+5 | 自店舗の予約表(閲覧) | 電話・店頭予約の入力(設定で可否) | タブレット・スマホ |
「本部/加盟店オーナー/店長/スタッフ」は要件 v2 の D5。人数は打ち合わせ(2026-11-18)の「スタッフ20名+5名」。店舗数・加盟店数は未確認。
受け入れ条件=「ここまでできればOK」。テストケースの元にします。
| ID | 機能 | 中身 | 受け入れ条件(OK) |
|---|---|---|---|
| F-01 | ネット予約の取り込み | SALON BOARD の予約通知メール(ヘア・キレイ)を店舗ごとの専用アドレスで受け、新規・変更・取消を判別して台帳へ反映。同じメール・同じ予約番号は二重に入れない | 受信から60秒以内に予約表へ表示。第0段で集めた実メール全件で、項目の取り出し正解率 99%以上(未決基準値は V2 の結果で確定)。解析できないメールは「取り込めなかった」一覧に必ず残る |
| F-02 | 電話・店頭予約の入力 | 日時・スタッフ(指名なし可)・メニュー・お客様を入れる画面。メニュー×スタッフの施術時間で終了時刻を自動計算。勤務外・席の不足・重なりは保存させない(本部・店長だけ理由を書いて強行可) | 慣れた人が1分以内に1件入れられる。重なる枠は保存ボタンの前に赤で示す |
| F-03 | 予約表 | 日表示(縦=時刻・横=スタッフ)、週表示。シフト外は灰色。店舗の切り替え(本部・オーナー)。他の端末で変わった予約は自動で反映 | 他端末の変更が5秒以内に反映。1店舗・1日・スタッフ10名・予約60件で2秒以内に表示 |
| F-04 | 二重予約の検知と通知 | 同じスタッフの時間の重なり、席・設備の数の超過、指名なし予約で勤務人数を超える場合を検知。取り込み時は保存したうえで「重なり」として記録し、店長と本部へLINEで通知。解消したら記録 | 重なる予約が取り込まれてから60秒以内に通知が届く。未解消の重なりは一覧に残り、本部が全店分を見られる |
| F-05 | お客様の照合 | 電話番号(正規化)が一致すれば同じ人。電話が無い・一致しないときは氏名(カナ)で候補を出し、人が決める。後から統合・分割できる | 誤って別人を統合しない(自動統合は電話一致のみ)。未決照合率の目標は V3 の結果で決める |
| F-06 | 変更・キャンセル | 変更・取消の履歴(誰が・いつ・前後の値)。無断キャンセルの印と回数。お客様の画面に回数を表示 | 任意の予約で、作成から現在までの変更がすべて辿れる |
| F-07 | 取り込みの見張り | 店舗・媒体ごとに最後に取り込めた時刻を表示。解析の失敗、または営業時間中に一定時間メールが来ないときに本部へ通知 | 解析の失敗は5分以内に通知。無通知の時間のしきい値は店舗ごとに設定できる |
| F-08 | 枠を閉じる確認 | 電話・店頭で入れた予約ごとに「媒体の枠を閉じてください」タスクを出す。店舗が「済」を押す。未済は翌朝まとめて通知 | 未済のタスクが一覧で分かり、本部が全店分を見られる |
| F-09 | 書き出し・バックアップ | 予約・お客様・スタッフ・メニューをCSVで書き出し。毎日のバックアップ。前日の夜に翌日の予約表を控えとして保存(仕組みが止まっても見られる) | バックアップから復元の手順を一度試して成功している(D7) |
| F-10 | ログイン・権限・履歴 | 役割ごとの見える範囲(1-3)。本部・オーナーは2段階認証が必須。主な変更は操作履歴に残る | 加盟店Aのアカウントで加盟店Bのデータがどの経路でも取れないことを自動テストで確認 |
| 区分 | 要件 | 実現の手段(→ 02・03) |
|---|---|---|
| データの分け方 | 会社(テナント)ごとに完全に分ける。加盟店は自店分だけ | 全テーブルに tenant_id。Postgres の行レベルセキュリティ(RLS)で強制 |
| 整合性 | 同時に2台から同じ枠に入れても、片方しか通らない | 店舗×日の単位でロックを取り、判定と保存を1つのトランザクションで |
| 個人情報 | 通信と保存の暗号化、2段階認証、最小権限、原文メールの保存期間 | TLS・保存時暗号化(サービス標準)、TOTP、原文は保存期限つき 未決期間 |
| 可用性 | 営業時間(目安 9〜21時)に止まらない。止まっても当日の予約を見られる | マネージドサービスの冗長性+前夜の控え(F-09) |
| 性能 | F-01・F-03・F-04 の秒数 | リアルタイム配信、キュー処理 |
| 監視 | 取り込み失敗・通知失敗に気づける | F-07+運用者向けの通知 |
| 拡張 | 予約サイト・通知手段・店舗・販売先を、本体を触らずに足せる | 変換部品(パーサー)と通知部品の差し替え、設定で増やせる店舗・テナント |
| 端末 | タブレット(店舗)、スマホ、PC。最新の Safari・Chrome | レスポンシブなWebアプリ(アプリストア不要) |
| 乗り換えの安心 | 全台帳を、いつでも先方自身で書き出せる | F-09 |
① 店舗ごとの専用アドレスで受信 → ② 原文を R2 に保存 → ③ キューから解析 → ④ DB 関数で判定つき登録 → ⑤ 重なりがあれば通知部品が LINE へ。画面は読み取りを Supabase に直接(RLS で絞る)、書き込みは API Worker 経由。
| 層 | 推奨 | 選ぶ理由 | 代わりの案 |
|---|---|---|---|
| メール受信 | Cloudflare Email Routing + Email Workers | 受信したメールをそのままコードで処理できる。追加のメール受信サービスが要らない | SendGrid Inbound Parse/Postmark Inbound(月額が増える) |
| 処理 | Cloudflare Workers + Queues + Cron Triggers | サーバー管理なし。失敗時の再試行とデッドレターがキューの標準機能 | Supabase Edge Functions(キューは自前) |
| API | Hono + Zod(TypeScript) | Workers 向けで軽い。入力の検査を型と共有できる | Next.js の API ルート(Vercel) |
| データベース | Supabase(Postgres・東京リージョン) | 排他制約・トランザクション・RLSが揃う。二重予約と会社ごとの分離をアプリ任せにしない | Neon+Hyperdrive(認証・リアルタイムは別途)/Cloudflare D1(RLS が無く、分離をアプリで守ることになる→非推奨) |
| 認証 | Supabase Auth(メール+パスワード、TOTP の2段階認証) | RLS と同じ仕組みで役割を扱える | Clerk/Auth0(月額が増える) |
| 画面 | React + Vite + TanStack Query + Tailwind CSS(shadcn/ui) | 静的配信(Pages)で済む。タブレットで軽い | Next.js |
| 予約表の描画 | CSS Grid で自作(日×スタッフの格子) | 要件が単純。ライセンス費が要らない | FullCalendar のリソース表示(有料ライセンス 未決) |
| メール解析 | postal-mime(MIME の分解)+ 媒体ごとの変換部品 | Workers 上で動く。本文の取り出しは自前の規則で、版を管理 | LLM での抽出(予備:規則で取れないときだけ。費用と誤りに注意) |
| 通知 | LINE Messaging API(プッシュ) | LINE Notify は 2025-03-31 に終了。店長・本部のグループまたは個人へ送る | メール(予備の経路として実装) |
| CI・配備 | GitHub Actions + Wrangler + Supabase CLI | マイグレーションと配備を同じ手順で | ― |
memberships(利用者×テナント×役割×範囲)から JWT の独自クレームを作り、RLS のポリシーで照合。サーバー側の取り込み処理(service role)は RLS を通らないため、必ず店舗のアドレスから tenant_id・store_id を決める関数だけを通す。すべてのテーブルに tenant_id・created_at・updated_at を持たせる(図では省略)。時刻は timestamptz(UTC で保存・表示は Asia/Tokyo)。
create type res_status as enum ('booked','cancelled','no_show','done'); create type res_source as enum ('hpb_hair','hpb_kirei','phone','walkin','other'); -- 楽天等は値を足すだけ create table reservations ( id uuid primary key default gen_random_uuid(), tenant_id uuid not null references tenants, store_id uuid not null references stores, staff_id uuid references staff, -- 指名なしは null customer_id uuid references customers, menu_id uuid references menus, period tstzrange not null, -- [開始, 終了) status res_status not null default 'booked', source res_source not null, external_id text, -- HPB の予約番号 raw_menu text, raw_staff text, -- メールの原文の語(マスタに当たらない時の保険) forced boolean not null default false, -- 重なりを承知で強行した version int not null default 1, unique (tenant_id, source, external_id) ); create index on reservations using gist (store_id, period); alter table reservations enable row level security; create policy tenant_scope on reservations using ( tenant_id = auth_tenant() and store_id = any(auth_store_ids()) -- 役割から見える店舗 );
status = 'booked' の予約だけ。時間は period && 新しい period(半開区間なので「10:00終了」と「10:00開始」は重ならない)。メニューの準備時間(buffer)を終了側に足して判定。interface BookingParser { source: 'hpb_hair' | 'hpb_kirei' | ... version: string // 書式が変わったら上げる canParse(mail): boolean // 送信元・件名で判定 parse(mail): ParsedBooking // 種類・予約番号・日時・ } // 氏名・電話・担当・メニュー
| メソッド | パス | 用途 | 権限 |
|---|---|---|---|
GET | /stores/:id/board?date= | 予約表(予約・シフト・重なり)。※通常は Supabase から RLS で直接読む | 店舗を見られる人 |
POST | /reservations | 電話・店頭予約の登録(判定つき)。重なれば 409 と重なる予約を返す | 店長・スタッフ(設定) |
PATCH | /reservations/:id | 変更(version で楽観ロック。古ければ 409) | 同上 |
POST | /reservations/:id/cancel・/no-show | 取消・無断キャンセル | 同上 |
POST | /reservations/check | 保存前の判定だけ(入力中に赤で示す用) | 同上 |
POST | /conflicts/:id/resolve | 重なりの解消を記録 | 店長・本部 |
POST | /close-tasks/:id/done | 枠を閉じた | 店長・スタッフ |
GET | /inbound-emails?status=failed | 取り込めなかったメールと原文 | 本部・管理 |
POST | /customers/:id/merge | お客様の統合・分割 | 店長・本部 |
POST | /exports | CSV 書き出し(R2 に作って署名つきURLを返す) | 本部・オーナー |
email() | Email Worker | 受信の入口(HTTP ではない) | ― |
ravie-booking/ ├─ apps/ │ ├─ web/ # React + Vite(Pages) │ ├─ api/ # Hono(Workers) │ └─ ingest/ # Email・Queue・Cron(Workers) ├─ packages/ │ ├─ domain/ # 型・Zod スキーマ・判定の純関数 │ ├─ parsers/ # 媒体ごとの変換部品+実メールの見本 │ └─ notify/ # 通知部品 └─ supabase/ ├─ migrations/ # SQL・RLS・DB関数 └─ tests/ # pgTAP(RLS・判定)
| 環境 | 用途 |
|---|---|
| local | Supabase CLI + wrangler dev |
| staging | 試験用の店舗・ダミーのお客様 |
| production | 試験運用の1店舗から |
| # | 作業 | 中身 | シニア | エンジニア | PM | 計 |
|---|---|---|---|---|---|---|
| 第0段 検証+設計(2週間) | ||||||
| 0-1 | データ構造の設計 | D1 台帳・D2 テナント分離・RLS 方針・ER 図・マイグレーション初版 | 8 | 8 | ||
| 0-2 | アーキテクチャの設計 | D3 取り込み口・D4 通知部品・D5 権限・D6 履歴とバックアップ・技術の最終決定 | 8 | 8 | ||
| 0-3 | 判定ロジックの設計 | 3-2 の規則を決め、境界のテスト表を作る | 2 | 2 | ||
| 0-4 | メール解析の試作(V2・V3) | 受信の仮設定、2週間分のメールの解析試作、項目の取れ具合と照合率の集計 | 10 | 10 | ||
| 0-5 | V4・V5 の集計 | 二重予約の今の件数、媒体別の比率 | 2 | 2 | ||
| 0-6 | 確認と要件の確定 | サインド社への質問(V1)、店舗の設定の依頼、要件の確定、画面の叩き台 | 6 | 6 | ||
| 第0段 小計 | 18 | 12 | 6 | 36 | ||
| 第1段 予約管理(6週間) | ||||||
| 1-1 | 土台 | リポジトリ・CI・環境、認証と2段階認証、権限(RLS)、マスタ(店舗・スタッフ・メニュー・席・シフト) | 14 | 14 | ||
| 1-2 | 予約表 | 日・週の表示、シフト重ね、リアルタイム反映、店舗の切替 | 16 | 16 | ||
| 1-3 | 入力と判定 | 入力画面、DB 関数 upsert_reservation()、保存前の判定、強行の記録 | 14 | 14 | ||
| 1-4 | ホットペッパーの取り込み | Email Worker・Queue・R2、ヘア/キレイのパーサー、新規・変更・取消、別名の辞書 | 14 | 14 | ||
| 1-5 | お客様の照合 | 電話の正規化、カナの候補、統合・分割 | 6 | 6 | ||
| 1-6 | 重なりの記録と LINE 通知 | conflicts・outbox・Notify Worker・重なりの一覧 | 8 | 8 | ||
| 1-7 | 変更・取消・無断キャンセル | 履歴、回数の表示 | 4 | 4 | ||
| 1-8 | 見張り・枠閉じタスク | ingest_health、Cron、失敗の一覧、未済の朝の通知 | 6 | 6 | ||
| 1-9 | 書き出し・バックアップ | CSV、前夜の控え、pg_dump を R2 へ | 4 | 4 | ||
| 1-10 | テスト・試験運用 | パーサー・RLS・判定のテスト、通しの試験、1店舗の試験運用の対応 | 6 | 6 | ||
| 1-11 | 公開・手順書 | 本番の設定、店舗の受信設定の手順、操作の手順書 | 2 | 2 | ||
| 1-12 | レビューと試験運用前の点検 | D7 実装レビュー、個人情報の守り、復元の手順を実際に試す | 6 | 6 | ||
| 1-13 | PM | 定例・確認・試験運用の伴走 | 10 | 10 | ||
| 第1段 小計 | 6 | 94 | 10 | 110 | ||
| 合計 | 24 | 106 | 16 | 146 | ||
最大の棒=36h を100%とした長さ。合計146h。
PM の定例は毎週(図では省略)。W7 から試験運用を始め、W8 末に完成条件を判定。V1(サインド社)の回答が遅れても、第1段はメール方式で進められる。
| サービス | プラン | 月額の目安 | 必要な理由 |
|---|---|---|---|
| Cloudflare Workers | Workers Paid | $5〜 | Queues・Cron・実行時間。Email Routing と Pages は追加費用なしの見込み |
| Cloudflare R2 | 従量 | ほぼ $0 | 原文メール・控え・CSV(小容量) |
| Supabase | Pro | $25〜 | 日次バックアップ・一時停止なし・東京リージョン |
| ドメイン | 受信用サブドメイン | 既存を流用 | MX を Cloudflare に向ける |
| 合計 | 約 $30/月 | 為替で約4,500〜5,000円 未決公式の料金で再確認 | |
| LINE公式アカウント | 先方の契約 | 0〜1.5万円 | 先方負担。店長・本部への通知は月の通数が少ない見込み |
店舗・販売先が増えても、上の構成は当面同じプランで収まる見込み(予約件数が月数万件規模になるまで)。
| 機能 | 判定 | 根拠 | 崩れるとき |
|---|---|---|---|
| F-01 HPB の取り込み | ○ | SALON BOARD の予約お知らせメールの送信先に連携用アドレスを足す方式は、他社が提供中(DOUKI・Promo-UP・LIME 等) | メールに必要な項目が無い → V1(BM 経由)へ |
| F-02 入力と判定 | ◎ | Postgres のトランザクション+範囲型 | ― |
| F-03 予約表 | ◎ | Supabase Realtime で変更を購読 | ― |
| F-04 重なりの通知 | ◎ | LINE Messaging API のプッシュ送信 | アカウントの持ち方が決まらない → メールで先に動かす |
| F-05 照合 | ○ | 電話の一致は確実。氏名だけの照合は人が決める設計 | メールに電話が無い → 照合率が下がる(V3) |
| F-06〜F-10 | ◎ | 標準的な CRUD・Cron・RLS | ― |
| ビューティーメリット連携 | △ | API・CSV の有無が公開情報で確認できない | 出せない → メール方式のまま |
| 媒体の枠を自動で閉じる | ✕ | 公式の手段が公開されていない。画面の自動操作は非公式で、止まる・規約の扱いが不明 | ―(F-08 の人の作業で代える) |
| # | リスク | 手当て(設計に入れるもの) | 工数への影響 |
|---|---|---|---|
| R1 | SALON BOARD のメール書式が予告なく変わり、解析が止まる | パーサーに版を持たせる/解析失敗を5分以内に通知(F-07)/原文を保存して後から取り直せる/見本テストで差分を検知 | 変わるたび 1〜3h の保守(月額の保守に含める範囲か 未決) |
| R2 | 通知メールに必要な項目(電話・担当など)が無い | 第0段の V2 で先に判明させる。不足時は原文の語のまま入れ、人が補う画面 | 方式を変える場合は再見積 |
| R3 | 実装のミスで他テナント・他加盟店の行が見える | RLS を DB で強制/取り込み処理は専用の関数だけ/pgTAP で全役割を自動テスト/シニアの点検(1-12) | 見積に含む |
| R4 | メールのスタッフ名・メニュー名がマスタと合わない | 別名の辞書(S09)。合わないものは「要確認」で予約表に出す | 見積に含む |
| R5 | 電話予約のあと、店舗が媒体の枠を閉じ忘れる(=二重予約の主因が残る) | F-08 のタスクと朝の通知。閉じ忘れが原因の重なりも F-04 で検知 | 見積に含む |
| R6 | 店舗の SALON BOARD に受信用アドレスを登録し忘れる・誤る | 店舗ごとに試しのメールを送る受信確認、最終取込時刻の表示 | 見積に含む |
| R7 | LINE公式アカウントの持ち方が決まらない | 通知部品はメールでも送れる。決まり次第 LINE に切替 | なし |
| 段 | 足すもの | 第1段で用意しておくもの |
|---|---|---|
| 2 通知 | お客様へのリマインド、スタッフの空き時間 | 通知部品(outbox)、customers の LINE ID の列、予約の変更・取消イベント |
| 3 会計 | 売上の登録、freee への出力 | 予約とメニュー・スタッフの紐づけ、テナント単位の台帳 |
| 4 通話 | 通話の文字起こし→スプレッドシート | テナント・権限・通知の部品(台帳は別テーブル) |
| 媒体の追加 | 楽天ビューティ・minimo | BookingParser の差し込み口、res_source の値 |
| 他社への販売 | 新しいテナント | tenants の行の追加と受信用 token の発行だけ |
| # | 確かめること | 決まるもの | 期限の目安 |
|---|---|---|---|
| Q1 | ビューティーメリットからデータを出せるか(API・Webhook・CSV) | 取り込みの方式(V1) | 第0段の中 |
| Q2 | 試験運用の1店舗と、SALON BOARD の通知メールの送信先を足してもらう日 | V2 の開始日=全体の開始日 | 着手日 |
| Q3 | LINE公式アカウントは全店で1つか店舗ごとか/通知はグループか個人か | 通知の宛先の持ち方 | W4 |
| Q4 | 店舗数・加盟店数、加盟店オーナーにアカウントを出すか | 権限の初期データ | W2 |
| Q5 | 今のシフトの管理方法、メニューごとの施術時間の一覧 | マスタの入れ方 | W2 |
| Q6 | 席・設備の数で予約を制限しているか | 判定②を使うか | W2 |
| # | 決めること | 誰が | メモ |
|---|---|---|---|
| I1 | 推奨構成(Cloudflare+Supabase)でよいか | シニアエンジニア | 0-2 で最終決定。代わりは 2-2 |
| I2 | 4-1 の作業ごとの時間の過不足 | エンジニア → 代表 | 合計を動かすなら代表の判断 |
| I4 | メール書式の変更への対応を月額の保守(月2時間)に含めるか | 代表 | R1 |
| I5 | 原文メール(個人情報を含む)の保存期間 | 代表+シニア | 案:90日で自動削除 |
| I6 | 受信用のドメイン(EXPLACE のサブドメインか、製品用の新ドメインか) | 代表 | 他社へ販売するなら製品用が自然 |
Product/NewPro/RAVIE/proposal/requirements/02_要件_第1段_予約管理_v2.md:完成条件・D1〜D7・機能・やらないこと・V1〜V5requirements/01_要件洗い出し_外部予約連携.md:SALON BOARD は公式APIの公開なし・予約通知メールで取り込む方式(DOUKI https://salon-douki.com/2154 、Promo-UP https://support.promo-up.biz/ex/ )、L Message の API、LINE公式アカウントの料金