RAVIE 予約管理 第0段+第1段 / 開発仕様書(ドラフト v0.1)/ 社内・エンジニア共有用
株式会社EXPLACE / 2026-11-20 / 未決=まだ確かめていないこと(推測で埋めずに残しています)/ 金額(単価・見積額)は載せていません。実装の中身と規模を確かめるための資料です
DEVELOPMENT SPEC / DRAFT

ホットペッパー・電話・店頭の予約を1つの予約表に集め、
二重予約をその場で止める・知らせる仕組みを、約2か月で作る

対象:RAVIE様 予約管理(提案書 v6 のプラン1/2 共通の範囲)/ もとにした資料:提案書 v6(2026-11-19)・要件 v2・見積メモ v5・外部予約連携の調査(2026-11-17)
実装の作業(第0段+第1段)
19項目
うち規模 L が6つ(04 参照)
期間
8週
検証+設計2週/開発・試験運用6週
機能要件
10本
F-01〜F-10(受け入れ条件つき)
サーバー代の見込み
約5千円/月
未決公式の料金で再確認
完成条件(1文)
1店舗で2週間、ホットペッパー・電話・店頭の予約が1つの予約表に集まり、二重予約が起きそうなときに店長と本部へLINE通知が届く。
これを満たしたら手を止めて報告する。第2段(リマインド)以降は別の見積・別のタスク。

技術的な実現性の結論

◎ 標準技術で確実に作れる
予約表・入力と判定・二重予約の検知・LINE通知・権限・履歴・CSV。
Postgres の排他制御+行レベルの権限で担保できる
○ 作れる。検証で形が決まる
ホットペッパーの予約通知メールの取り込み・お客様の照合。
他社が同じ方式で提供中。項目と表記ゆれを第0段で実測
✕ 今回は作らない
予約サイトの枠を自動で閉じる。
公式の手段が公開されていない。店舗への「枠を閉じて」タスクで代える

この1ページに入っている3つの文書

02 アーキテクチャ(構成と技術選定)と 05 実現性とリスクは、3つの文書の根拠として間に置いています。エンジニアの方は 02 → 03 → 04 の順に読み、04 の内訳に「抜けている作業」「規模が大きすぎる/小さすぎる」をご指摘ください。

01
要件定義書
REQUIREMENTS

作るのは「予約を読む・集める・重なりを知らせる」まで。枠を閉じるのは人

1-1. 背景と目的

今の困りごと
  • ネット予約(ホットペッパー)と電話・店頭予約が別々の場所にあり、二重予約が起きる
  • 一元管理ツール(ビューティーメリット)を使っているが、本部から全店の状況を同じ表で見られない
  • スタッフ20名(+5名)への連絡・確認が人手
今回の目的
  • 全経路の予約を1つの予約表に集める
  • 重なりを入力時に止め、取り込み時に即通知する
  • 第2〜4段(通知・会計・通話)と他サロンへの販売が作り直しなしで乗る台帳を先に作る

1-2. 範囲(やる/やらない)

図1 第1段の範囲。緑=今回つくる/灰=既存のまま使う/赤=作らない
外の仕組み(既存) ホットペッパーSALON BOARD(ヘア・キレイ) 楽天・minimo 等 ビューティーメリット媒体の枠の同期は継続 電話・店頭のお客様 今回つくる:RAVIE 予約台帳 F-01 メール取り込み新規・変更・取消 F-02 電話・店頭の入力入れてよい枠かを判定 F-03 予約表(1つの台帳)店舗別・スタッフ別・シフト重ね/本部と店舗が同じ表 F-04 二重予約検知+通知 F-05 照合同じお客様 F-06 変更・取消履歴・無断 F-07 見張り F-08 枠閉じタスク F-09 CSV・控えF-10 権限・履歴 LINE通知店長・本部Messaging API ✕ 枠を自動で閉じる公式手段なし→人が閉じる(F-08) 通知メール 今回なし
やる
  • ホットペッパー(ヘア・キレイ)の予約通知メールの取り込み(新規・変更・取消)
  • 電話・店頭予約の入力と、入れてよい枠かの判定
  • 予約表、二重予約の検知とLINE通知、お客様の照合、変更・取消・無断キャンセルの記録
  • 取り込みの見張り、「媒体の枠を閉じて」タスク、CSV書き出し・毎日のバックアップ
  • 本部→加盟店→店舗の権限と、他社に販売しても混ざらないデータの分け方(設計)
やらない
  • 予約サイトの枠を自動で閉じる・書き込む(非公式の自動操作も含む)
  • 楽天ビューティ・minimo 等の取り込み(追加は変換部品を1つ足す小さな作業・別見積)
  • お客様へのリマインド、スタッフの空き時間通知(第2段)
  • 売上・会計・freee(第3段)、通話の文字起こし(第4段)
  • お客様が自分で予約する画面(自社予約・LINEマイページ)

1-3. 使う人と権限

役割人数の目安見える範囲主な操作端末
システム管理(EXPLACE)1〜2全テナント(運用時のみ・記録に残す)テナント・店舗の追加、取り込み設定、障害対応PC
本部数名自社の全加盟店・全店舗全店の予約表、二重予約の一覧、マスタ、CSVPC
加盟店オーナー未決自分の加盟店の店舗だけ自店の予約表・マスタ・CSVPC・スマホ
店長店舗数自店舗だけ予約の入力・変更、二重予約の解消、枠閉じタスク、シフトタブレット・スマホ
スタッフ20+5自店舗の予約表(閲覧)電話・店頭予約の入力(設定で可否)タブレット・スマホ

「本部/加盟店オーナー/店長/スタッフ」は要件 v2 の D5。人数は打ち合わせ(2026-11-18)の「スタッフ20名+5名」。店舗数・加盟店数は未確認。

1-4. 業務の流れ(第1段のあと)

図2 予約が入ってから、重なりが解消されるまで。紫=仕組みが自動で行う/白=人が行う
ネット予約 電話・店頭 お客様がHPBで予約SALON BOARD が通知 メールを受けて解析数十秒以内 店舗が入力画面で入力1分以内 枠の判定重なれば保存させない 予約表に入るお客様を照合 重なりを検知LINEで店長・本部へ 店長が解消お客様に連絡・担当変更 枠閉じタスクを出す電話・店頭のときだけ 店舗が媒体の枠を閉じるBM か SALON BOARD で 閉じたら「済」を押す → 未済が残れば翌朝通知

1-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のデータがどの経路でも取れないことを自動テストで確認

1-6. 非機能要件

区分要件実現の手段(→ 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
02
ARCHITECTURE

受信と処理は Cloudflare、台帳と権限は Postgres(Supabase)に寄せる

推奨構成の理由(3つ)
①メールを受けて処理する口が標準で揃う ②二重予約と会社ごとの分離をデータベースの機能で守れる ③月々のサーバー代が小さい(弊社負担のため)

2-1. 全体構成

図3 全体構成。紫=Cloudflare/青=Supabase(Postgres)/橙=外部サービス
SALON BOARD予約お知らせメール送信先に専用アドレス追加 利用者本部・オーナー(PC)店長・スタッフ(タブレット・スマホ)ブラウザ Cloudflare Email Routing+ Email Worker(受信) R2原文メール・控え・CSV Queuesingest / notify(再試行) Parser Worker解析→照合→登録 API Worker(Hono / TypeScript)予約の登録・変更(判定つき)/CSV/管理操作 Notify Worker通知部品(LINE/メール) Cron Triggers見張り・前夜の控え・未済 Pages(Web画面:React + Vite)予約表・入力・一覧・マスタ/Access で管理画面を保護 Supabase(東京) Postgres台帳・RLS・排他制約判定は DB 関数で Authログイン・TOTP Realtime予約表の自動反映 日次バックアップ LINEMessagingAPI GitHubActionsCI・pg_dump ① ② ③ ④ 読取・購読(RLS) ⑤ 通知

① 店舗ごとの専用アドレスで受信 → ② 原文を R2 に保存 → ③ キューから解析 → ④ DB 関数で判定つき登録 → ⑤ 重なりがあれば通知部品が LINE へ。画面は読み取りを Supabase に直接(RLS で絞る)、書き込みは API Worker 経由。

2-2. 技術選定(推奨と代わり)

層推奨選ぶ理由代わりの案
メール受信Cloudflare Email Routing + Email Workers受信したメールをそのままコードで処理できる。追加のメール受信サービスが要らないSendGrid Inbound Parse/Postmark Inbound(月額が増える)
処理Cloudflare Workers + Queues + Cron Triggersサーバー管理なし。失敗時の再試行とデッドレターがキューの標準機能Supabase Edge Functions(キューは自前)
APIHono + 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マイグレーションと配備を同じ手順で―

2-3. 会社ごと・加盟店ごとのデータの分け方(D2)

図4 1つのデータベースを、行ごとの鍵で分ける(共有スキーマ+RLS)
1つの Postgres(全テーブルに tenant_id。RLS が「自分の tenant_id の行」しか返さない) テナント:RAVIE(tenant_id = t1) 本部:全加盟店・全店舗が見える 加盟店 A店舗 1・店舗 2🔒 A の店舗だけ見える 加盟店 B店舗 3🔒 B の店舗だけ見える 販売先サロンB(t2)自社の店舗・お客様🔒 t1 は見えない 販売先サロンC(t3)自社の店舗・お客様🔒 他社は見えない
なぜ「共有スキーマ+RLS」か
テナントを足すのが設定(行の追加)だけで済み、マイグレーションも1回で全社に効く。会社ごとに DB を分ける方式より運用が軽い。分離は DB が強制するので、API のバグで他社の行が漏れにくい。
守り方
ログイン時に memberships(利用者×テナント×役割×範囲)から JWT の独自クレームを作り、RLS のポリシーで照合。サーバー側の取り込み処理(service role)は RLS を通らないため、必ず店舗のアドレスから tenant_id・store_id を決める関数だけを通す。
03
開発仕様書
SPECIFICATION

台帳は「テナント → 店舗 → 予約」の1本の木。判定は DB の中で1回だけ行う

3-1. データモデル(D1)

図5 主要テーブルの関係。緑=第1段で作る/点線=第2段以降で足す場所(今は空けておくだけ)
tenants会社(販売先ごと)id, name, plan franchisees加盟店tenant_id, name stores店舗franchisee_id, hoursingest_token(受信用) memberships利用者×役割×範囲user_id, role, scope_id staffスタッフstore_id, name, line_to shifts勤務staff_id, tstzrange resources席・設備store_id, kind, capacity menusメニューduration, buffer+staff_menu_durations reservations store_id, staff_id(null可)customer_id, menu_idperiod tstzrangestatus, sourceexternal_id(予約番号)version(楽観ロック) customersお客様(テナント単位)phone_e164, name_kanano_show_count, merged_into reservation_events変更の履歴actor, kind, before, after reservation_resources予約×席・設備reservation_id, resource_id inbound_emails受信メールr2_key, status, parser_ver conflicts重なりa_id, b_id, kind, resolved close_tasks枠を閉じるタスクreservation_id, done_at notification_outbox送る通知(共通部品)channel, to, template ingest_healthstore, source, last_ok_at audit_log全テーブル共通 sales第3段 reminders第2段 calls第4段

すべてのテーブルに 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())   -- 役割から見える店舗
);

3-2. 二重予約の判定(F-02・F-04 の核)

図6 判定の流れ。入力(電話・店頭)は止める/取り込み(ネット)は入れてから知らせる
予約の登録要求入力 or 取り込み 店舗×日でロックpg_advisory_xact_lock 3つの重なりを数える① 同じスタッフの時間② 席・設備の数の超過③ 指名なし>勤務人数 重なり? なし → 保存履歴に1行 入力 → 保存しない重なる予約を返す本部・店長は理由つき強行可 取り込み → 保存+記録conflicts に1行outbox → LINE 通知 いいえはいはい すべて DB 関数 upsert_reservation() の中、1トランザクション 取り込みを止めないのは、媒体側ではすでに予約が成立しているため(消すと見落とす)
判定に使うもの
対象は status = 'booked' の予約だけ。時間は period && 新しい period(半開区間なので「10:00終了」と「10:00開始」は重ならない)。メニューの準備時間(buffer)を終了側に足して判定。
決めておくこと 未決
・指名なしのネット予約の担当を自動で割り当てるか(今回は割り当てず「指名なし」の列に置く案)
・席・設備の数を判定に使うか(店舗の設定で切れるようにする案)
・準備時間をメニュー単位か店舗単位か

3-3. ネット予約の取り込み(F-01・D3)

図7 1通のメールが予約表に入るまで。失敗はどこでも「止めずに残す」
受信{token}@in.〈ドメイン〉Email Worker 店舗を特定token→store_id送信元を検査 原文を保存R2+inbound_emailsMessage-ID で重複排除 解析媒体の変換部品新規/変更/取消 マスタに当てるスタッフ名・メニュー名別名の辞書 upsert_reservation()照合(F-05)→ 判定(3-2)予約番号で冪等 ← ここから Queue(失敗は自動で再試行)→ 失敗したとき 知らない送信元 → 捨てずに隔離/解析できない → status=failed で「取り込めなかった」一覧へ+本部通知/マスタに無い名前 → 原文の語のまま入れて「要確認」印 新規予約番号が無ければ作る(あれば何もしない) 変更予約番号で探して上書き。履歴に前後を残す 取消status=cancelled。新規より先に届いたら印だけ残す
変換部品(パーサー)の形
interface BookingParser {
  source: 'hpb_hair' | 'hpb_kirei' | ...
  version: string            // 書式が変わったら上げる
  canParse(mail): boolean     // 送信元・件名で判定
  parse(mail): ParsedBooking  // 種類・予約番号・日時・
}                             // 氏名・電話・担当・メニュー
楽天・minimo を足すときは、この部品を1つ足すだけ(本体は触らない)。追加は規模 S の作業で済む。
第0段で確かめること(V2)未決
  • 通知メールに、予約番号・日時・担当・メニュー・氏名・電話・変更/取消の区別がすべて載っているか
  • ヘア版とキレイ版で書式が違うか
  • 氏名がカナか漢字か、電話番号が全桁か(照合 V3 に直結)
  • 変更メールに「変更前」も載るか
足りない項目があれば、方式を「ビューティーメリット経由(V1)」へ寄せる判断をする。

3-4. 通知の共通部品(D4)

図8 送る側は「何を・誰に」だけを書く。経路(LINE/メール)は部品が選ぶ
二重予約(第1段) 取り込み失敗・未済 リマインド(第2段) notification_outboxtemplate・宛先の役割・payload予約と同じトランザクションで書く Notify Worker宛先を解決・送信失敗は指数で再試行 LINE(グループ/個人) メール(予備)
未決LINE公式アカウントは全店で1つか、店舗ごとか。店長・本部への通知は「店舗ごとのLINEグループにボットを招待して送る」案が手軽。グループの ID を店舗の設定に持つ。アカウントの持ち方で、宛先の持ち方と月の通数(料金)が変わる。

3-5. API(主なもの)

メソッドパス用途権限
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/exportsCSV 書き出し(R2 に作って署名つきURLを返す)本部・オーナー
email()Email Worker受信の入口(HTTP ではない)―

3-6. 画面一覧

S01 ログイン
2段階認証(本部・オーナー必須)
S02 予約表
日/週、スタッフ列、シフト外は灰色、重なりは赤枠。タブレット横向きが主
S03 予約の入力・編集
お客様を電話番号で検索 → メニュー → 枠。入力中に判定
S04 予約の詳細・履歴
変更の前後、取り込み元のメール原文へのリンク
S05 重なりの一覧
未解消を上に。本部は全店分
S06 枠を閉じるタスク
未済の一覧と「済」ボタン
S07 取り込みの状況
店舗×媒体の最終取込時刻、失敗メール
S08 お客様
検索・統合候補・無断キャンセル回数
S09 マスタ
店舗・スタッフ・シフト・メニュー(施術時間)・席・別名の辞書・通知先
S10 書き出し
台帳を選んで CSV
未決シフトの入れ方:第1段は「本部・店長がマスタ画面で入れる(週単位のコピーあり)」の最小にする案。今のシフトの管理方法(紙・スプレッドシート・他ツール)を確認し、取り込みが要るなら追加。

3-7. リポジトリ・環境・テスト

リポジトリ(モノレポ・pnpm)
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・判定)
環境とテスト
環境用途
localSupabase CLI + wrangler dev
staging試験用の店舗・ダミーのお客様
production試験運用の1店舗から
  • パーサー:第0段の実メール(個人情報は伏せる)を見本にした差分テスト。全件通過を CI の条件に
  • RLS:役割×テナントの組み合わせで「見えてはいけない行」が0件(pgTAP)
  • 判定:境界(ちょうど接する・準備時間・指名なし)と同時登録の競合
  • 通しの試験:Playwright で入力→予約表→通知
04
内訳書
BREAKDOWN

実装の山は「土台・予約表・入力と判定・取り込み」の4つ。設計は最初の2週間に寄せる

未決規模は作業どうしを比べるための相対の目安で、工数の確定ではありません。実装する方の見立てで「抜けている作業」「規模が大きすぎる/小さすぎる」をご指摘ください。

4-1. 規模の物差し

S小
部品1つ、または既存の仕組みの設定。テストは単体だけで足りる。
例:CSV の書き出し、無断キャンセルの記録
M中
部品が数個+画面1つ程度。判断する規則が少しある。
例:お客様の照合、重なりの通知、取り込みの見張り
L大
複数の画面・DB 関数・テストにまたがる。ここが崩れると全体が遅れる。
例:予約表、入力と判定、メール取り込み

不確実さ:低=作り方が決まっている/中=細部は実物を見て決める/高=第0段の検証の結果で作り方が変わる。

4-2. 作業ごとの実装の中身(WBS)

#作業実装するもの(具体)担当規模不確実さ
第0段 検証+設計(2週間)
0-1データ構造の設計ER 図(3-1)の確定/テナント・加盟店・店舗の階層と memberships の持ち方/RLS の方針と auth_tenant()・auth_store_ids() の設計/第2〜4段で足すテーブルの置き場所/マイグレーションの初版シニアL中
0-2アーキテクチャの設計構成(2-1)と技術選定(2-2)の最終決定/取り込み口と BookingParser の型/通知部品(outbox)の型/権限と画面の対応表/履歴とバックアップ・復元の方式シニアL中
0-3判定の規則を決める3-2 の3つの重なりの規則(境界・準備時間・指名なし)を確定し、境界のテスト表を作るシニアS低
0-4メール解析の試作(V2・V3)受信の仮設定(Email Routing → Worker → R2)/2週間分の実メールを集める/ヘア・キレイの書式の違いを調べる/項目の取り出しの試作と正解率の集計/電話・氏名での照合率の集計/個人情報を伏せたテスト見本を作るエンジニアM高
0-5今の状況の集計(V4・V5)二重予約の今の件数、媒体別の予約の比率(店長への聞き取り+0-4 のデータ)エンジニアS低
0-6確認と要件の確定サインド社への質問(V1)/店舗への受信設定の依頼/Q1〜Q6 の回収/要件の確定と画面の叩き台PMS中
第1段 予約管理(6週間)
1-1土台モノレポ(3-7)・CI・3つの環境/Supabase Auth のログインと TOTP の2段階認証/memberships から JWT のクレームを作る処理/全テーブルの RLS ポリシー/マスタの CRUD と画面(店舗・スタッフ・メニューと施術時間・席・シフト・別名の辞書・通知先)エンジニアL低
1-2予約表日表示(時刻×スタッフの格子を CSS Grid で自作)・週表示/シフト外の灰色・重なりの赤枠・「指名なし」の列/Supabase Realtime で他端末の変更を反映/店舗の切替/タブレット横向きの操作エンジニアL中
1-3入力と判定DB 関数 upsert_reservation()(ロック・3つの判定・保存・履歴を1トランザクションで)/保存前の判定 API(/reservations/check)/入力画面(電話番号でお客様検索 → メニュー → 枠、終了時刻の自動計算)/強行(理由つき)の記録/version による楽観ロックエンジニアL低
1-4ホットペッパーの取り込みEmail Worker(token→店舗、送信元の検査、R2 保存、Message-ID の重複排除)/Queue と再試行・デッドレター/ヘア・キレイのパーサー(新規・変更・取消)/予約番号での冪等な反映と、順番が逆に届いたときの扱い/スタッフ名・メニュー名を別名の辞書で当てる処理エンジニアL高
1-5お客様の照合電話番号の正規化(E.164)と一致での自動判定/カナの表記ゆれでの候補表示/統合・分割の操作と画面エンジニアM中
1-6重なりの記録と LINE 通知conflicts の記録/notification_outbox と Notify Worker(宛先の解決・LINE プッシュ・メールの予備・再試行)/通知の文面/重なりの一覧画面と「解消」の記録エンジニアM中
1-7変更・取消・無断キャンセル取消・無断キャンセルの操作/reservation_events の履歴表示/お客様ごとの無断キャンセル回数エンジニアS低
1-8見張り・枠閉じタスクingest_health の更新/Cron で解析失敗・無通知のしきい値を確認して通知/取り込めなかったメールの一覧と原文表示/電話・店頭予約から close_tasks を作る処理と「済」の画面/未済の朝の通知エンジニアM低
1-9書き出し・バックアップ台帳ごとの CSV 書き出し(R2+署名つきURL)/前夜に翌日の予約表の控えを保存/GitHub Actions で pg_dump を R2 へエンジニアS低
1-10テスト・試験運用パーサーの見本テスト/RLS の pgTAP(全役割×テナント)/判定の境界と同時登録のテスト/Playwright での通しの試験/1店舗の試験運用中の不具合対応エンジニアM中
1-11公開・手順書本番の設定(ドメイン・MX・秘密情報)/店舗が SALON BOARD に受信用アドレスを足す手順/操作の手順書エンジニアS低
1-12レビューと試験運用前の点検実装のレビュー(D7)/個人情報の守り(暗号化・2段階認証・権限)の点検/バックアップからの復元を実際に試すシニアM低
1-13進行週1の定例・確認・試験運用の伴走PMM低

4-3. 規模のマップ

図9 作業ごとの規模(棒の長さ=S/M/L)。赤い印=不確実さが高い
シニア(設計・点検)エンジニアPM
データ構造の設計
L
アーキテクチャ設計
L
判定の規則
S
メール解析の試作 ●
M
土台
L
予約表
L
入力と判定
L
HPB の取り込み ●
L
お客様の照合
M
重なりと LINE 通知
M
見張り・枠閉じ
M
テスト・試験運用
M
変更・取消/CSV/公開
S
点検・復元の試し
M
確認・進行
M

L が6つ(設計2・土台・予約表・入力と判定・取り込み)。このうち取り込みだけが、第0段の検証(メールに何が載っているか)で作り方が変わる。

4-4. 日程(8週間)

図10 週ごとの作業。紫=シニア/緑=エンジニア/青=PM/黄=先方の作業・待ち
W1W2W3W4W5W6W7W8 第0段第1段 店舗のメール転送・V1 回答待ち 設計(0-1〜0-3) 解析の試作・V2〜V5 要件の確定(PM) 土台・マスタ 予約表・入力と判定 取り込み・照合 通知・見張り・CSV 点検・復元の試し 1店舗の試験運用(2週間)完成条件を確かめる

PM の定例は毎週(図では省略)。W7 から試験運用を始め、W8 末に完成条件を判定。V1(サインド社)の回答が遅れても、第1段はメール方式で進められる。

4-5. 月々のサーバー代の見込み(弊社負担)

サービスプラン月額の目安必要な理由
Cloudflare WorkersWorkers Paid$5〜Queues・Cron・実行時間。Email Routing と Pages は追加費用なしの見込み
Cloudflare R2従量ほぼ $0原文メール・控え・CSV(小容量)
SupabasePro$25〜日次バックアップ・一時停止なし・東京リージョン
ドメイン受信用サブドメイン既存を流用MX を Cloudflare に向ける
合計約 $30/月為替で約4,500〜5,000円 未決公式の料金で再確認
LINE公式アカウント先方の契約0〜1.5万円先方負担。店長・本部への通知は月の通数が少ない見込み

店舗・販売先が増えても、上の構成は当面同じプランで収まる見込み(予約件数が月数万件規模になるまで)。

05
FEASIBILITY & RISK

技術の壁はない。外の仕組み(メールの書式・LINE の持ち方)が最大の不確実さ

5-1. 機能ごとの実現性

◎ 標準技術で確実○ 作れる・検証で形が決まる△ 外の回答次第✕ 今回は作らない
機能判定根拠崩れるとき
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 の人の作業で代える)

5-2. リスクと手当て

図11 起きやすさ × 影響。右上ほど先に手を打つ
起きやすさ → 影響 → R1 メールの書式変更 R2 項目の不足 R3 他社の行が見える R4 スタッフ名の表記ゆれ R5 枠の閉じ忘れ R6 店舗の受信設定ミス R7 LINE の持ち方未定
#リスク手当て(設計に入れるもの)実装への影響
R1SALON BOARD のメール書式が予告なく変わり、解析が止まるパーサーに版を持たせる/解析失敗を5分以内に通知(F-07)/原文を保存して後から取り直せる/見本テストで差分を検知変わるたびにパーサーの小さな修正(規模 S。月額の保守に含める範囲か 未決)
R2通知メールに必要な項目(電話・担当など)が無い第0段の V2 で先に判明させる。不足時は原文の語のまま入れ、人が補う画面方式を変える場合は再見積
R3実装のミスで他テナント・他加盟店の行が見えるRLS を DB で強制/取り込み処理は専用の関数だけ/pgTAP で全役割を自動テスト/シニアの点検(1-12)今回の範囲に含む
R4メールのスタッフ名・メニュー名がマスタと合わない別名の辞書(S09)。合わないものは「要確認」で予約表に出す今回の範囲に含む
R5電話予約のあと、店舗が媒体の枠を閉じ忘れる(=二重予約の主因が残る)F-08 のタスクと朝の通知。閉じ忘れが原因の重なりも F-04 で検知今回の範囲に含む
R6店舗の SALON BOARD に受信用アドレスを登録し忘れる・誤る店舗ごとに試しのメールを送る受信確認、最終取込時刻の表示今回の範囲に含む
R7LINE公式アカウントの持ち方が決まらない通知部品はメールでも送れる。決まり次第 LINE に切替なし

5-3. 第2段以降が「足すだけ」になる場所

段足すもの第1段で用意しておくもの
2 通知お客様へのリマインド、スタッフの空き時間通知部品(outbox)、customers の LINE ID の列、予約の変更・取消イベント
3 会計売上の登録、freee への出力予約とメニュー・スタッフの紐づけ、テナント単位の台帳
4 通話通話の文字起こし→スプレッドシートテナント・権限・通知の部品(台帳は別テーブル)
媒体の追加楽天ビューティ・minimoBookingParser の差し込み口、res_source の値
他社への販売新しいテナントtenants の行の追加と受信用 token の発行だけ
06
OPEN ITEMS

着手前に決めること・確かめること

6-1. 先方に確かめること

#確かめること決まるもの期限の目安
Q1ビューティーメリットからデータを出せるか(API・Webhook・CSV)取り込みの方式(V1)第0段の中
Q2試験運用の1店舗と、SALON BOARD の通知メールの送信先を足してもらう日V2 の開始日=全体の開始日着手日
Q3LINE公式アカウントは全店で1つか店舗ごとか/通知はグループか個人か通知の宛先の持ち方W4
Q4店舗数・加盟店数、加盟店オーナーにアカウントを出すか権限の初期データW2
Q5今のシフトの管理方法、メニューごとの施術時間の一覧マスタの入れ方W2
Q6席・設備の数で予約を制限しているか判定②を使うかW2

6-2. 社内(代表・エンジニア)で決めること

#決めること誰がメモ
I1推奨構成(Cloudflare+Supabase)でよいかシニアエンジニア0-2 で最終決定。代わりは 2-2
I24-2 の抜けている作業・規模の過不足エンジニア → 代表範囲を動かすなら代表の判断
I4メール書式の変更への対応を月額の保守の範囲に含めるか代表R1
I5原文メール(個人情報を含む)の保存期間代表+シニア案:90日で自動削除
I6受信用のドメイン(EXPLACE のサブドメインか、製品用の新ドメインか)代表他社へ販売するなら製品用が自然
出典・もとにしたもの
  • 提案書 v6(2026-11-19)https://explace-ravie-proposal.pages.dev/ / 原稿 Product/NewPro/RAVIE/proposal/
  • 要件 v2(2026-11-18)requirements/02_要件_第1段_予約管理_v2.md:完成条件・D1〜D7・機能・やらないこと・V1〜V5
  • 外部予約連携の調査(2026-11-17)requirements/01_要件洗い出し_外部予約連携.md:SALON BOARD は公式APIの公開なし・予約通知メールで取り込む方式(DOUKI https://salon-douki.com/2154 、Promo-UP https://support.promo-up.biz/ex/ )、L Message の API、LINE公式アカウントの料金
  • LINE Notify の終了(2025-03-31)と Messaging API への移行:提案書 v6 の出典(2026-11-19 取得)
  • 技術の仕様(Cloudflare Email Workers・Queues・Cron Triggers、Supabase の RLS・Auth の TOTP・Realtime、Postgres の範囲型と advisory lock、LINE Messaging API):各公式ドキュメント。料金(4-4)は 2026-11-20 時点で公式未確認の目安。発注・設定前に公式で確認する
  • 作業ごとの規模(4-2):EXPLACE の見立て(相対の目安。工数の確定ではない)
株式会社EXPLACE / RAVIE 予約管理 開発仕様書 ドラフト v0.1(2026-11-20)/ 社内・エンジニア共有用(金額は載せていない)