Booking System (Fixed)

Booking System (Fixed)

site icon
2025.03.11 0
JavaScript预约管理日历集成日程管理
Booking System (Fixed) 是一个基于 Cloudflare Workers 的预约系统,集成了 Google Calendar 和 MCP Servers。该系统解决了原始版本中的多个关键问题,提供了完整的预约流程、实时可用性检查、自动邮件确认、Google Calendar 集成以及 MCP Server 集成等功能。
View on GitHub

Overview

基本能力

产品定位

Booking System (Fixed) 是一个用于管理预约的系统,特别适用于需要与 Google Calendar 集成的服务提供商。

核心功能

  • 多步骤预约流程:直观的逐步预约流程,提升用户体验。
  • 实时可用性检查:检查 Google Calendar 中的冲突。
  • 自动邮件确认:向客户发送预约详情。
  • Google Calendar 集成:创建包含服务详情的日历事件。
  • MCP Server 集成:跟踪预约事件并提供增强的处理能力。
  • 全面的错误处理:向用户提供有意义的反馈。
  • 响应式设计:支持移动和桌面设备。

适用场景

  • 服务提供商的预约管理(如按摩、美容等)。
  • 需要与 Google Calendar 集成的预约系统。
  • 需要实时可用性检查和自动邮件确认的场景。

工具列表

  • Cloudflare Workers:用于部署和运行预约系统。
  • Google Calendar API:用于日历事件的管理和冲突检查。
  • MCP Servers:用于后端处理和增强功能。

常见问题解答

  1. 如何设置 Google Calendar 集成?
  2. 确保服务账户具有适当的权限,并将其添加到 Google Calendar 的共享设置中。

  3. 如何配置邮件通知?

  4. 设置 EMAIL_FROMBUSINESS_NAMEBUSINESS_EMAIL 环境变量。

  5. 如何测试系统?

  6. 使用 npm run dev:local 进行本地测试,或进行端到端测试以验证预约流程。

使用教程

使用依赖

  • Cloudflare Workers 账户
  • 启用了 Calendar API 的 Google Cloud 项目
  • 具有日历访问权限的 Google 服务账户
  • 用于后端处理的 MCP Server

安装教程

  1. 克隆仓库
git clone https://github.com/Konstrex/booking-system-fixed.git
cd booking-system-fixed
  1. 安装依赖
npm install
  1. 配置环境变量

wrangler.toml 文件或使用 Cloudflare 的 secrets 中设置以下环境变量:

  • GOOGLE_CLIENT_EMAIL
  • GOOGLE_PRIVATE_KEY
  • GOOGLE_CALENDAR_ID
  • EMAIL_FROM
  • BUSINESS_NAME
  • BUSINESS_EMAIL
  • MCP_ENABLED
  • MCP_SERVER_URL
  • MCP_API_KEY

  • 使用 Wrangler 设置 secrets

wrangler secret put GOOGLE_PRIVATE_KEY
wrangler secret put GOOGLE_CALENDAR_ID
wrangler secret put MCP_SERVER_URL
wrangler secret put MCP_API_KEY
  1. 部署到 Cloudflare Workers
npm run deploy:prod

调试方式

  1. 本地测试
npm run dev:local
  1. 端到端测试

  2. 选择日期和服务

  3. 检查可用时间段
  4. 输入客户详情
  5. 完成预约
  6. 验证 Google Calendar 中的事件
  7. 确认收到确认邮件

许可证

None