
Booking System (Fixed)

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:用于后端处理和增强功能。
常见问题解答
- 如何设置 Google Calendar 集成?
-
确保服务账户具有适当的权限,并将其添加到 Google Calendar 的共享设置中。
-
如何配置邮件通知?
-
设置
EMAIL_FROM
、BUSINESS_NAME
和BUSINESS_EMAIL
环境变量。 -
如何测试系统?
- 使用
npm run dev:local
进行本地测试,或进行端到端测试以验证预约流程。
使用教程
使用依赖
- Cloudflare Workers 账户
- 启用了 Calendar API 的 Google Cloud 项目
- 具有日历访问权限的 Google 服务账户
- 用于后端处理的 MCP Server
安装教程
- 克隆仓库
git clone https://github.com/Konstrex/booking-system-fixed.git
cd booking-system-fixed
- 安装依赖
npm install
- 配置环境变量
在 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
- 部署到 Cloudflare Workers
npm run deploy:prod
调试方式
- 本地测试
npm run dev:local
-
端到端测试
-
选择日期和服务
- 检查可用时间段
- 输入客户详情
- 完成预约
- 验证 Google Calendar 中的事件
- 确认收到确认邮件
许可证
None