RAVIE 予約管理(第0〜1段)|実装依頼(エンジニア向け)

美容室FC本部(RAVIE)向け。ネット・電話・店頭の予約を1つの予約表に集め、二重予約をLINEで知らせる仕組み。他サロンへ販売できる土台で作る。
DRAFT v0.1 / 2026-11-20(2026-11-18 打ち合わせ・提案書 v6 を反映) / 対象:RAVIE 本部・加盟店・店舗

0完了条件

1店舗で2週間、ホットペッパー・電話・店頭の予約が1つの予約表に集まり、二重予約が起きそうなときに店長と本部へLINE通知が届く。
▶ 目的・打ち合わせでの先方の言葉
  • 目的:ダブルブッキングを最優先で止める。効果を早く出し、売上につなげる
  • 「一度に全部つなぐと、直しが大きくなる」→ 大枠だけ先に作り、現場で使った結果を見て足す(段階で進める)
  • 管理の仕組みを他サロン・FCオーナーへ販売したい → 1つの仕組みで複数の会社を扱える形で作る
  • スタッフ20名(+5名)。今は一元管理ツール「ビューティーメリット」と配信ツール「L Message」を使用

1決まったこと 2026-11-18 打ち合わせ

以下は確定として実装してよい。
進め方
段階で進める第1段=予約管理だけ。ブログ・口コミの自動化は後回し
最初の取り込み
ホットペッパーのみヘア・キレイ(SALON BOARD の予約お知らせメール)
設計の土台
シニアが先に設計台帳・会社ごとの分け方・取り込み口・通知部品
通知
LINE Messaging APILINE Notify は終了済みのため使わない
試験運用
1店舗 → 全店二重予約の件数を前後で比べる

2提案からの変更点

初期の提案(2026-11-18 原稿)との差分。
項目
提案時
今回
設計の担当
開発者がそのまま実装
→
第0段にシニアエンジニアの設計(D1〜D7)を置く
取り込む予約サイト
4サイト(ホットペッパー・楽天ビューティ・minimo ほか)
→
ホットペッパーのみ。他は検証で予約の割合を見て追加
ビューティーメリット
検証で連携の可否を先に確認
→
第1段は頼らない作り。LINE連携は第2段でサインド社の回答を見て決める

3全体の流れ

取り込み・照合・判定・通知は自動。電話予約の入力と、予約サイトの枠を閉じるのは人。
お客様/店舗
予約が入る
ホットペッパー・電話・店頭
システム
取り込み
予約お知らせメールを解析。電話・店頭は入力画面
システム
照合・判定
同じお客様の判定、時間・担当・席の重なり
システム
LINE通知
重なったら店長と本部へ即通知
店長
枠を閉じる
電話予約の分を予約サイト側で閉じ、確認を付ける
できあがり
1つの予約表
二重予約が起きない

4設計の土台(第0段・シニアエンジニア) 新規

データ構造は後から直すと全部に響く。第2〜4段(通知・会計・通話の文字起こし)と他社への販売は、すべてこの台帳の上に乗る。
#設計すること守る条件(受け入れ条件)
D1台帳のデータ構造:本部 → 加盟店 → 店舗 → スタッフ・席/お客様・予約・メニュー(施術時間)第2段(通知)・第3段(売上)・第4段(通話記録)を、台帳を作り直さず足せる
D2会社・加盟店ごとのデータの分け方(マルチテナント)加盟店は自店分だけ見える。他社に販売してもデータが混ざらない
D3予約の取り込み口を1つに予約サイトごとの違いは変換部品で吸収。サイトを足すとき本体を触らない
D4通知の共通部品二重予約の通知(第1段)とリマインド(第2段)が同じ部品。LINE・メールを差し替えられる
D5権限:本部/加盟店オーナー/店長/スタッフ画面ごとに見える範囲が決まっている
D6履歴・バックアップ・書き出し誰が・いつ・何を変えたか残る。毎日バックアップ。全台帳をCSVで出せる
D7実装のレビューと、試験運用前の点検個人情報の暗号化・2段階認証。復元手順を実際に試す
▶ どのデータを、どの段が使うか
データ第1段 予約第2段 通知第3段 会計第4段 通話他社へ販売
お客様●●●―●
予約●●●―●
スタッフ・シフト●●●●●
メニュー・施術時間●●●―●
本部・加盟店・店舗●●●●●
売上――●―●
通話の記録・求職者―――●―

緑=第1段で作る台帳。売上・通話の記録は、あとから足せる場所を最初に空けておく。

5第1段の機能

すべて公式の機能か自社の計算だけで作る。予約サイトやビューティーメリットの対応を待たない。
機能中身作り方受け入れ条件
ネット予約の取り込みホットペッパー(ヘア・キレイ)の新規・変更・取消を自動で予約表へSALON BOARD「予約お知らせメール」の送り先に専用アドレスを1つ足し、受信メールを解析試験店の2週間分で、新規・変更・取消が漏れなく予約表に入る
電話・店頭予約の入力1分で入る画面勤務時間・施術時間・席の数で、入れてよい枠かを判定合わない枠は入れられない
予約表店舗別・スタッフ別。シフトと重ねる。本部と店舗が同じ表を見る自社の画面本部・店舗で同じ内容が見える
二重予約の検知と通知全経路を照合し、重なったら店長と本部へ即通知時間・担当・席の重なりを判定 → LINE Messaging API重なりを作ると、店長と本部にLINEが届く
お客様の照合電話・お名前で同じ人を判定表記ゆれを吸収。曖昧なときだけ候補表示照合率を検証(V3)で測れる
変更・キャンセル履歴、無断キャンセルの回数自社の台帳1件の予約の変更履歴をたどれる
取り込みの見張り最後に取り込んだ時刻を表示。止まったら通知受信の間隔を監視受信が止まると通知が出る
枠を閉じる確認電話予約の分は「予約サイトの枠を閉じて」を店舗に出す確認済みの印を付ける未確認の予約が一覧で分かる
書き出し・バックアップCSV、毎日のバックアップ自社予約・お客様をCSVで出せる。復元を1回試している
メールの書式が変わると解析が止まる → 取り込みの見張りで気づけるようにし、解析部分は変換部品(D3)に閉じる。

6第1段でやらないこと

やらないこと理由・扱い
予約サイトの枠を自動で閉じる公式の手段が公開されていない。今のビューティーメリットに任せ、電話予約には「枠を閉じて」の確認を出す
ビューティーメリットとのデータ連携開発元(サインド社)に出せる手段を確認中。第1段は頼らない
お客様へのリマインド・スタッフの空き時間通知第2段
売上・会計(第3段)、通話の文字起こし(第4段)第1段の結果を見て中身と順番を決め直す
ホットペッパー以外の予約サイト検証で予約の割合を見て、変換部品を足す形で追加

7検証(第0段・2週間)で確かめること

「作れるか」ではなく、RAVIE の予約メールの書き方に合わせて読み取りを調整する期間。
#確かめること方法決まるもの
V1ビューティーメリットからデータを出せるかサインド社へ質問票第2段以降の連携のしかた
V2ホットペッパーの通知メールで必要な項目が取れるか(日時・担当・メニュー・氏名・電話・予約番号・変更/取消の区別)1店舗のメールを2週間転送してもらい解析取り込みの作り方
V3同じお客様を照合できる割合V2 のデータで照合率を測る照合の作り方
V4二重予約の今の月件数店長へのヒアリング+V2 のデータ効果の基準
V5予約サイト別の予約の割合1か月分の実績次に足すサイト

8作る順番

各段で止めて先方に見せられる単位で切る。
STEP 1
設計+検証D1〜D7 の設計書。試験店のメール転送を受けて解析(V2〜V5)
台帳の形と取り込みの方式が決まればOK
STEP 2
台帳と取り込み台帳・権限・ホットペッパーの変換部品・取り込みの見張り
試験店の予約が自動で台帳に入ればOK
STEP 3
画面と通知予約表・電話/店頭入力・二重予約のLINE通知・枠を閉じる確認・CSV
重なりを作るとLINEが届けばOK
STEP 4
試験運用1店舗で2週間。点検(D7)・復元テスト・手順書
完了条件(0章)を満たせばOK → 全店へ
期間の目安:検証+設計 2週間 / 開発・試験運用 6週間(約2か月)。

9まだ決まっていないこと

エンジニアは推測で埋めず、設定値か手入力で逃がしておく。
未決 ①
LINE公式アカウントの持ち方全店で1つか店舗ごとか(先方回答待ち)。通知先は設定で切り替えられるようにする
未決 ②
試験運用の1店舗先方が選ぶ。決まり次第、予約お知らせメールの転送を設定してもらう
未決 ③
ビューティーメリットの出口API・Webhook・CSV・通知メールのどれが使えるか(サインド社の回答待ち)
未決 ④
使う技術・置き場所言語・DB・ホスティングはシニアエンジニアが設計(STEP 1)で提案し、決定後に共有
未決 ⑤
予約メールの項目担当・メニューがメールに載るかは V2 で確認。載らない項目は手入力で補う
未決 ⑥
着手日別途連絡
未決 ⑦
判定ルールの詳細「重なり」の定義(同じスタッフの時間重複のみか、席数超過も含むか)・同じお客様と判定する条件・無断キャンセルの定義・取り込みが「止まった」とみなす時間
未決 ⑧
通知と画面の中身LINE通知の文面・宛先・届くまでの許容時間/電話・店頭入力の項目/権限(D5)の画面×役割の対応
※ 用語:SALON BOARD=ホットペッパービューティーの店舗用管理画面。ビューティーメリット=RAVIE が今使う予約の一元管理ツール(開発元:サインド社)。L Message=今使う LINE 配信ツール。
※ 根拠:打ち合わせ(2026-11-18)、提案書 v6(エンジニア共有用 https://ravie-proposal-eng.pages.dev)。予約お知らせメールでの取り込み・書き込みの公式APIが無いこと:DOUKI・Promo-UP・サロンズソリューション・LIME の公開情報(2026-11-17〜19 取得)。LINE Notify の終了(2025-03-31):LINEヤフーの案内。