日历可用性系统
状态: 🟢 规格已完成|🎯 已准备好部署服务器
一 自主调度助手 通过监控电子邮件、检测可用性请求、自动检查日历以及在没有用户干预的情况下发送响应，消除了手动日历协调。
______________________________________________________________________
📋 项目概述
核心价值观：零接触日程安排自动化-您再也不用手动检查日历或写日程安排电子邮件了。
运作原理:
- 电子邮件到达：“你下周什么时候有空？”
- 系统检测调度请求（NLP+置信度评分）
- 系统会自动检查您的日历
- 系统使用可用插槽生成自然语言响应
- 系统自动发送回复（无需手动批准）
- 您收到通知：“自动回复\[发件人\]，有空”
主要特点:
- 自主电子邮件响应 -零人工干预（带安全护栏）
- 基于信任的自动化 -只有当≥85%的置信度时才会自动发送
- 多日历智能 -聚合所有日历的可用性
- 对话状态跟踪 -处理多轮调度线程
- 完全透明 -100%审计跟踪，具有用户覆盖功能
- VIP控制 -发件人特定处理白名单/黑名单
______________________________________________________________________
🏗️ 建筑
技术栈:
- 后端：Node.js+TypeScript+Express
- 数据库：PostgreSQL 15+
- API：RESTful+GraphQL
- 集成：MCP（谷歌日历、Gmail）
- 网络爬取：剧作家
- 认证：OAuth2+JWT
关键模式:
- 电子邮件优先架构 -Gmail MCP编排，日历提供数据
- 规范驱动开发 -规范作为事实来源（而非文件）
- 宪政 -10条不可改变的原则（包括第十条：自主经营）
- 基于信心的决策 -多因素评分（意图、解析、发送者、上下文）
- 事件驱动 -基于Webhook的电子邮件监控（实时，非轮询）
______________________________________________________________________
📂 项目结构
calendar-availability-system/
├── .specify/ # Specification documents (source of truth)
│ ├── constitution.md # Architectural principles
│ ├── spec.md # Technical specification
│ ├── api-spec.md # OpenAPI 3.0 specification
│ ├── db-schema.md # Database schema
│ ├── phases.md # Implementation phases
│ ├── integrations.md # MCP integration patterns
│ └── security.md # Security model
├── .claude/ # Claude Code configuration
│ ├── skills/ # Project-specific skills
│ ├── agents/ # Development agents
│ └── commands/ # Slash commands
├── docs/ # Documentation
│ ├── DEPLOYMENT.md # Server deployment guide
│ ├── guides/ # User guides
│ │ └── QUICK-START.md # Fast reference guide
│ └── internal/ # Internal documentation
│ ├── HANDOFF.md # Developer onboarding
│ └── PROJECT-SUMMARY.md # Executive summary
├── src/ # Source code (to be implemented)
├── tests/ # Test suites
├── logs/ # Operational logs
└── README.md # This file______________________________________________________________________
🚀 入门指南
先决条件
- Node.js 18+和npm/pnpm
- PostgreSQL 15+
- 使用日历和Gmail API访问的谷歌云项目
- MCP服务器：
@modelcontextprotocol/server-google-calendar,@modelcontextprotocol/server-gmail
开发设置
# Clone the repository
git clone
cd calendar-availability-system
# Install dependencies (once implemented)
npm install
# Set up environment variables
cp .env.example .env
# Edit .env with your credentials
# Initialize database
npm run db:init
# Run development server
npm run dev______________________________________________________________________
📖 规格
所有规格均位于 .specify/ 并作为 真理的来源 发展：
- 宪法 -请先阅读本文以了解架构原则
- 技术规格 -包含用户故事的完整系统设计
- API规范 -OpenAPI 3.0文档
- 数据库模式 -完整的数据模型
- 实施阶段 -16周路线图
- 集成模式 -MCP集成指南
- 安全模型 -身份验证、加密、合规性
______________________________________________________________________
🎯 实施阶段
第一阶段：自主电子邮件助理（第1-4周）⭐
目标：在4周内实现零接触调度自动化（不是16周！）
- ✅ 规范已完成（多代理已细化）
- ⏳ Gmail MCP电子邮件监控（实时webhooks）
- ⏳ NLP意图检测（Claude/GPT-4集成）
- ⏳ 信心评分引擎（4因素评分）
- ⏳ 对话状态机（多回合处理）
- ⏳ 谷歌日历可用性计算
- ⏳ 自动发送电子邮件（无需手动批准）
- ⏳ VIP白名单/黑名单+审计跟踪
- ⏳ 断路器和速率限制
可交付成果：具有安全机制的自主工作助理
第二阶段：多日历智能（第5-8周）
- ⏳ 偏好从行为中学习
- ⏳ 多日历支持（聚合可用性）
- ⏳ 智能冲突解决
- ⏳ 置信度模型改进
第3阶段：外部日历集成（第9-12周）
- ⏳ 使用Playwright进行网页抓取
- ⏳ 外部日历身份验证
- ⏳ 多源聚合
第4阶段：高级优化（第13-16周）
- ⏳ 群组调度智能
- ⏳ 模式识别和分析
- ⏳ 性能优化
价值实现时间：自主操作 4周 （第一阶段），不是16周
看 相位.md 用于逐日细分。
______________________________________________________________________
🔧 发展资料
Claude代码支持
此项目包括自定义Claude代码配置 .claude/:
技能 （6个可用）：
fastapi-development-API模式nodejs-development-Node.js专业知识expressjs-development-Express框架postgresql-数据库设计api-gateway-patterns-API架构oauth2-authentication-身份验证模式
代理 （4个可用）：
api-architect-API设计和架构spec-driven-development-expert-规范细化test-engineer-测试套件创建deployment-orchestrator-部署自动化
命令 （3个可用）：
/constitution-审查架构原则/current-检查实施状态- `/ctx7
` -查找库文档
MCP服务器
此项目所需的MCP服务器：
@modelcontextprotocol/server-google-calendar-日历操作@modelcontextprotocol/server-gmail-电子邮件操作@modelcontextprotocol/server-playwright-网络抓取（可选）
______________________________________________________________________
🧪 测试策略
看 .specify/spec.md 对于全面的测试要求：
- 单元测试：所有业务逻辑（覆盖率>80%）
- 集成测试：API端点、MCP集成
- E2E测试：关键用户流
- 性能测试：对1000+并发用户进行负载测试
- 安全测试：OWASP十大合规性
______________________________________________________________________
🔐 安全
安全性是从基础中内置的：
- 认证：OAuth2（谷歌），具有MFA的本地身份验证
- 授权：RBAC+ABAC模型
- 加密：AES-256处于静止状态，TLS 1.3处于传输状态
- 合规：GDPR、CCPA就绪
- 审计：完整的审计跟踪
看 security.md 了解详情。
______________________________________________________________________
📊 成功指标
第一阶段目标:
- 日历同步延迟：\<2秒
- API响应时间：＜200ms（p95）
- 正常运行时间：99.9%
第四阶段目标:
- 支持1M+用户
- 1000多万次活动/天
- 100K+并发连接
______________________________________________________________________
🤝 贡献
该项目如下 宪法规范驱动的发展:
- 所有更改都从规格开始 -更新
.specify/文件优先 - 规范是真理的源泉 -代码实现规范，反之亦然
- 遵守宪法 -所有决策均符合9项原则
- 测试驱动 -在实施之前根据规范编写测试
______________________________________________________________________
📝 许可证
\[待定\]
______________________________________________________________________
🙏 致谢
- 建于 克劳德代码 开发环境
- 使用规范驱动的开发专家代理生成的规范
- 建筑遵循宪法框架原则
______________________________________________________________________
当前状态: ✅ 规格已完成，可用于服务器部署
仓库: https://github.com/manutej/calendar-availability-system
下一步：关注 docs/DEPLOYMENT.md 对于服务器设置，然后开始第1阶段的实施
多智能体分析：通过顺序思维+MERCURIO+MARS综合完善的规范（见 .specify/TRANSFORMATION-SUMMARY.md)
有关完整的切换详细信息，请参阅：
docs/DEPLOYMENT.md-服务器部署指南docs/internal/HANDOFF.md-开发人员入职培训（18 KB）docs/guides/QUICK-START.md-快速参考指南.specify/TRANSFORMATION-SUMMARY.md-完整分析（20K字）