クリニック導入ガイド（reserve-optimizer）
目的: reserve-optimizer をクリニックに導入する際の、開発者（fukukei23）の作業とクリニック側の作業を明確に分ける。 想定読者: クリニック経営者・導入担当者・私自身（構築時のチェックリスト）
役割分担の全体像
| 作業領域 | 開発者（私） | クリニック側 |
| LINE/Stripe/GAS の申請・認証 | ✅ 代行 | 必要情報の提供 |
| システムの構築・セットアップ | ✅ 全部 | - |
| 初期カスタマイズ | ✅ 代行 | ヒアリング回答 |
| スタッフ教育 | ✅ 初回のみ | 出席 |
| 日常運用（スプレッドシート更新等） | - | ✅ 全部 |
| 障害対応・調査 | ✅ | 連絡・情報提供 |
| 機能追加・改善 | ✅ 見積もり後 | 依頼・承認 |
| 顧客サポート | - | ✅ 一義対応 |
核心:
- 構築・技術対応はすべて私が代行
- クリニック側は「情報授受」「日常運用」「顧客サポート」を担当
- クリニック側にコードを書く作業・複雑な設定作業は発生しない
私（開発者）が行う作業
1. 初回構築（初期セットアップ代行）
| 作業 | 内容 | 工数目安 |
| GAS プロジェクト構築 | clasp で 17ファイル一括デプロイ | 30分 |
| Cloudflare Worker デプロイ | wrangler で自動デプロイ | 15分 |
| Google Sheets 構築 | 3シート（reservations/waitlist/weekly_summary）作成・ヘッダー設定 | 30分 |
| LINE 公式アカウント申請代行 | アカウント申請書類作成・認証サポート | 1-2日（公式審査待ち含む） |
| Messaging API 設定 | Webhook URL 登録・チャネル作成 | 30分 |
| Stripe アカウント設定代行 | Checkout ページ設定・Webhook URL 登録 | 1時間 |
| Script Properties 設定 | 11項目の API キーをセキュアに登録 | 15分 |
| Web App デプロイ・動作確認 | GAS を Web App として公開 | 30分 |
| E2E テスト | 予約 → 決済 → 完了通知の全フロー確認 | 1時間 |
2. 初期カスタマイズ（クリニック固有）
| 作業 | 内容 |
| 営業時間・定休日設定 | スクリプトプロパティに反映（土日診療・祝日営業対応等） |
| 施術メニュー定義 | スプレッドシートに反映（初診30分・再診60分等の時間設定） |
| スタッフ情報登録 | 管理者・スタッフの LINE User ID 登録 |
| リッチメニュー作成 | オプション（追加料金あり・画像デザインから対応） |
| リマインダー文言 | テンプレートをクリニック名・URL等に差し替え |
| 多言語対応 | 必要言語のみ有効化（標準は日英・追加は都度対応） |
3. 動作確認・運用開始
| 作業 | 内容 |
| E2E テスト実施 | 予約→決済→リマインダー→キャンセル→変更の全フロー |
| 動作確認レポート提出 | スプレッドシートのスクリーンショット付き報告書 |
| スタッフ向け操作説明会 | 30分〜1時間（対面 or Zoom） |
| 管理ダッシュボードの使い方説明 | Google Sheets の見方・更新方法を実演 |
| 障害対応フロー共有 | 緊急連絡先・一次対応・エスカレーション先の決定 |
4. 保守・運用
| 作業 | 頻度 | 内容 |
| 障害発生時の調査・修正 | 都度（緊急度による） | ログ確認・原因特定・パッチ適用 |
| 機能追加・改善 | 都度（別途見積もり） | スプリント単位での開発 |
| セキュリティアップデート | 月1確認 | LINE/Stripe/Cloudflare/GAS の仕様変更チェック |
| 月次レポート提出 | 月1 | 予約数推移・KPI（無断キャンセル率等） |
| 定例 MTG | 月1（30分） | 状況確認・改善提案 |
クリニック側で行う作業
1. 環境準備（初回のみ・合計 1-2日）
| 作業 | 内容 | 所要時間 |
| LINE 公式アカウントの作成 | クリニック名で取得・認証手続き | 1-2日（公式審査待ち含む） |
| Stripe アカウント作成 | クレジットカード・銀行口座登録 | 30分 |
| Google アカウント準備 | GAS 実行用（既存アカウントでOK） | 10分 |
| 管理者用 LINE アカウント | 管理者・スタッフがスマホでログイン | 5分 |
2. 初期情報の提供（私が代行するためのインプット）
| 提供物 | 用途 |
| クリニック情報 | 名称・住所・電話・診療時間 |
| 施術メニュー | 名称・所要時間・料金 |
| 営業時間・定休日カレンダー | 臨時休業・年末年始情報 |
| 管理者・スタッフ情報 | LINE User ID の取得・提供 |
| 銀行口座情報 | Stripe 入金先 |
3. 日常運用
| 作業 | 頻度 | 詳細 |
| スプレッドシート更新 | 都度 | 予約完了・キャンセル時に状態を反映 |
| 臨時休業・臨時営業の設定 | 都度 | 私に依頼 or スクリプトプロパティを直接編集 |
| 顧客問い合わせ対応 | 都度 | LINE トークでの返信（必要に応じて） |
| 月次売上確認 | 月1 | Stripe Dashboard で売上・手数料確認 |
4. 緊急時の連絡
| 状況 | 連絡先 |
| システム障害発生時 | 私に LINE/メール で即連絡 |
| 設定変更依頼 | 営業時間変更・施術メニュー追加等 |
| セキュリティインシデント | 即連絡（なりすまし等） |
❌ クリニック側に発生しない作業
以下の作業は私（開発者）が全部代行するため、クリニック側では発生しません：
- ❌ コードを書く作業
- ❌ サーバ設定・API キーの取得
- ❌ スプレッドシートの初期構築
- ❌ LINE Messaging API の技術設定
- ❌ Stripe の技術設定
- ❌ Cloudflare Worker のデプロイ
- ❌ 障害の調査・修正作業
クリニック側の作業は「日常のスプレッドシート更新」「顧客サポート」「緊急時の連絡」が中心で、技術的な作業は発生しません。
導入フロー（時系列）
Phase 1: ヒアリング（1-2日）
[クリニック]
- 営業形態・予約方法・課題ヒアリング
- 予算確認・契約締結
- LINE / Stripe / GAS 用アカウント情報の授受
Phase 2: 構築（3-5営業日）
[開発者・私]
1. GAS / Worker / Sheets の環境構築
2. LINE / Stripe の設定代行
3. 初期カスタマイズ適用（営業時間・施術メニュー）
4. 動作テスト（予約・決済・キャンセル・変更フロー）
Phase 3: 運用開始準備（1営業日）
[両方]
1. スタッフ向け操作説明会（私が実施）
2. 管理ダッシュボードの使い方説明
3. 障害対応フロー・エスカレーション先の決定
4. 緊急連絡先の共有
Phase 4: 運用開始（初月）
[両方]
Day 1: 運用開始
Week 1: 毎日動作確認（LINE/メールで報告）
Week 2: 運用フォローアップ MTG
Week 4: 月次レポート提出 + MTG
Phase 5: 安定運用（2ヶ月目以降）
[両方]
- 月次定例 MTG（30分）
- 機能改善提案（私が四半期ごと）
- 障害時のみ随時対応
よくある質問（Q&A）
Q. ランニングコストは？
| 項目 | 費用 | 発生条件 |
| GAS / Sheets / LINE メッセージ送受信 | 0円 | 標準的な予約数（月数百件）の場合 |
| Stripe 決済手数料 | 売上の 3.6% 程度 | 決済1件あたり |
| LINE 公式アカウント | 0〜数千円 | フリープラン200通/月超過時 |
| Google Workspace | 0円 | 一般アカウント利用時 |
基本は月額 0円で運用可能。決済手数料と LINE メッセージ超過時のみ課金。
Q. 障害時はどうなりますか？
- 私の対応時間: 平日 9:00-18:00（時間外は翌営業日対応）
- 緊急度による:
- 予約不能（全停止）: 平日日中で 2時間以内対応
- 一部機能停止: 翌営業日対応
- 軽微な表示崩れ: 月次メンテナンスで対応
- 24時間緊急対応オプション: 別途見積もり
Q. カスタマイズの費用は？
- 初期構築費: 構築内容により要見積もり（基本パッケージ + 追加オプション）
- 運用開始後の追加カスタマイズ: 工数ベースで別途見積もり（時給 or 案件単価）
- 小さな文言修正・営業時間変更: 月次保守契約に含まれる範囲（無料）
Q. 他のLINE予約システムへの移行はできますか？
- データは Google Sheets に保存されているため、エクスポートは容易
- 新システムへのデータ移行は 2-4 週間かかる想定
- スプレッドシート形式の CSV エクスポートは標準対応
Q. セキュリティは大丈夫ですか？
- LINE / Stripe の Webhook で HMAC-SHA256 署名検証 を実施（なりすまし防止）
- API キーは GAS Script Properties で暗号化保存（平文なし）
- Cloudflare Worker 経由でLINE/Stripe 双方を中継（二重防御）
- 月次セキュリティアップデートで最新仕様に対応
Q. スタッフに LINE 操作が苦手でも大丈夫ですか？
- スタッフ向け説明会を実施（30分〜1時間）
- 主要操作は 3つのみ（予約確認・キャンセル・変更）
- スプレッドシートは関数で自動集計されるため、関数知識不要
Q. 土日・祝日も営業している場合は？
- 初期構築時に 営業日カレンダーを設定（私が行います）
- 祝日は個別指定 or 「年末年始等の特定期間のみ休」に設定可能
Q. 複数店舗ある場合は？
- 1店舗 ＝ 1デプロイ（同じソースを別 LINE アカウント・別 Sheets で運用）
- 複数店舗横断ダッシュボードは標準では非対応（別途開発）
関連ドキュメント
docs/setup-guide.md — 技術セットアップ手順（私の作業チェックリスト）README.md — システム概要docs/runbooks/ — 障害対応手順
作成日: 2026-07-13 作成者: fukukei23 対象リポジトリ: fukukei23/reserve-optimizer 対象バージョン: v1.0.0