Booking System Fixed

🚀 予約システム（修正版）

このリポジトリには、Andriana Delchevaの予約システムの修正版が含まれており、以前の実装に存在するいくつかの重要な問題を解決しています。このシステムはCloudflare Workers上で動作するように設計されており、GoogleカレンダーとMCPサーバーと統合されています。

🚀 クイックスタート

この予約システムは、Cloudflare Workers上で動作し、GoogleカレンダーとMCPサーバーと統合されています。以下の手順でシステムを起動できます。

✨ 主な機能

解決された問題

この実装では、以下の元システムに存在する問題が解決されています。

1. 予約の完了 - ユーザーは現在、日付を選択して予約を完了することができます。
2. 確認メール - 予約が成功すると、確認メールが送信されます。
3. Googleカレンダー統合 - 予約は現在、Googleカレンダーにイベントとして作成されます。
4. 可用性チェックの実装 - システムは予約を確定する前に、利用可能な時間帯をチェックします。
5. MCPサーバー統合の実装 - バックエンド処理ではMCPサーバーを使用して機能を強化しています。

その他の機能

• 多段階予約フロー：ユーザーは複数のステップを通じて予約を完了することができ、各ステップで情報の正確性を確認するための検証が行われます。
• 単一APIリクエスト：最終的な予約リクエストは1回のAPI呼び出しで完了し、プロセスを簡素化し、効率を向上させています。
• 包括的なエラー処理：検証エラー、ネットワークエラー、サーバーエラーのログ記録を含み、MCP統合を通じて処理され、ユーザーに分かりやすいエラーメッセージが提供されます。

📦 インストール

依存関係のインストール

npm install

アプリケーションの起動

npm start

💻 使用例

基本的な使用法

可用性の確認

POST /api/available

リクエストボディ：

{
  "date": "2025-03-15",
  "duration": 60
}

レスポンス：

{
  "success": true,
  "availableTimeslots": [
    { "startTime": "09:00", "endTime": "10:00" },
    { "startTime": "10:00", "endTime": "11:00" },
    /* ... */
  ]
}

予約の作成

POST /api/book

リクエストボディ：

{
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+1234567890",
  "date": "2025-03-15",
  "time": "10:00",
  "services": [
    {
      "name": "按摩",
      "duration": 60,
      "price": 80
    }
  ],
  "notes": "备注信息",
  "同意条款": true
}

レスポンス：

{
  "success": true,
  "message": "预约已成功创建",
  "bookingId": "BK-JOHNDO-123456",
  "eventId": "日历事件ID"
}

📚 ドキュメント

🔄 継続的な改善

将来的な改善点としては、以下の項目が考えられます。

• 予約管理用のダッシュボードの追加
• 予約のキャンセル/再スケジュール機能の実装
• 支払いシステムの統合
• 顧客アカウントシステムの作成