Supercoordination MCP Server

# 超协体 MVP 1.0 完整代码库 **版本**: V1.0 **发布时间**: 2026-02-03 **开发状态**: 🎉 完整上线 --- ## 📋 项目概述 超协体是一个**AI原生的项目制协作网络**，通过PWP（个人工作空间协议）和AI智能推荐，实现高效的跨组织协作。 ### 核心定位 **在小程序和SaaS之间的AI原生协作平台** - 🎯 **轻量级** - 无需下载，Web即用 - 🤖 **AI原生** - 全流程AI增强 - 🔗 **跨组织** - 突破单一团队边界 - 📊 **项目制** - 灵活的项目制管理 ### 三大核心价值 1. **AI守门人** - 自动筛选优质协作者 2. **知识晶体** - 沉淀可复用的工作方法 3. **短邮系统** - 高效的决策通信工具 --- ## 🏗️ 系统架构 ### 技术栈 ``` 前端: HTML5 + CSS3 + Vanilla JavaScript 后端: Node.js + Express.js 数据库: PostgreSQL + Prisma ORM 实时通信: WebSocket AI集成: Claude API (Anthropic) 部署: Railway.app ``` ### 核心模块（10个） ``` 01. 用户系统 - 注册、登录、认证、权限 02. 项目管理 - 创建、编辑、成员管理 03. 任务管理 - 任务分配、状态跟踪 04. 成员管理 - 成员信息、PWP画像 05. 知识晶体 - 方案沉淀、评分、引用 06. 短邮系统 - PWP决策通信 07. 管理后台 - AI守门人、审核机制 08. WebSocket - 实时协作、在线状态 09. AI智能推荐 - 任务推荐、成员匹配 10. 核心服务器 - 统一API、路由管理 ``` > 说明：原始快照仍保留在 `核心系统/` 目录下（仅供参考），实际运行以 `src/` 与 `public/` 为准。 --- ## 📂 代码库结构（工程化版本） ``` 超协体MVP1.0代码库/ │ ├── package.json ├── .env.example ├── README.md │ ├── src/ │ ├── server.js # Express主服务器 │ └── modules/ # 后端模块 │ ├── auth/ │ ├── projects/ │ ├── aiGatekeeper/ │ ├── websocket/ │ ├── solutions/ │ └── pwp/ │ ├── public/ # 前端静态页面与资源 │ ├── *.html │ ├── css/ │ └── js/ │ ├── prisma/ │ └── schema.prisma │ ├── data/ │ └── store.json │ └── docs/ # 产品/部署/使用/开发文档 ├── 产品文档/ ├── 使用指南/ ├── 部署文档/ └── 开发记录/ ``` --- ## 🎯 核心功能清单 ### 1. 用户系统 ✅ - JWT认证 - 注册/登录 - PWP五行画像 - 积分系统 ### 2. 项目管理 ✅ - 项目创建/编辑 - 成员管理 - 权限控制 - AI智能推荐成员 ### 3. 任务管理 ✅ - 任务分配 - 状态跟踪 - AI智能推荐任务 - 任务看板 ### 4. 成员管理 ✅ - 成员信息 - PWP画像展示 - AI推荐搭档 - 在线状态 ### 5. 知识晶体 ✅ - 方案沉淀 - 评分系统 - 引用计数 - 排行榜 ### 6. 短邮系统 ✅ - PWP决策通信 - 双端同步（移动+桌面） - AI智能建议 - 决策链可视化 ### 7. 管理后台 ✅ - AI守门人 - 用户审核 - 权限管理 - 数据统计 ### 8. WebSocket ✅ - 实时消息 - 在线状态 - 协作提示 ### 9. AI智能推荐 ✅ - 任务推荐 - 成员推荐 - 搭档推荐 - 决策建议 ### 10. 核心服务器 ✅ - 统一API路由 - 错误处理 - 日志记录 - 性能优化 --- ## 📊 代码统计 | 模块 | 前端页面 | 后端服务 | 代码量（估算） | |------|---------|---------|---------------| | 用户系统 | 3个 | 1个 | ~15KB | | 项目管理 | 3个 | 1个 | ~90KB | | 任务管理 | 1个 | - | ~20KB | | 成员管理 | 2个 | - | ~60KB | | 知识晶体 | 4个 | 1个 | ~120KB | | 短邮系统 | 2个 | 2个 | ~80KB | | 管理后台 | 1个 | 1个 | ~40KB | | WebSocket | - | 1个 | ~7KB | | AI推荐 | 2个 | - | ~75KB | | 核心服务器 | - | 1个 | ~112KB | | **总计** | **18个页面** | **8个服务** | **~619KB** | **数据库表**: 15个主要表 **API端点**: 50+个端点 --- ## 🚀 快速开始 ### 1. 环境要求 ```bash Node.js >= 16.0.0 PostgreSQL >= 13.0 npm >= 7.0.0 ``` ### 2. 安装依赖 ```bash npm install ``` ### 3. 配置数据库 ```bash # 创建 .env 文件 DATABASE_URL="postgresql://user:password@localhost:5432/supercoordination" JWT_SECRET="your-secret-key" ANTHROPIC_API_KEY="your-claude-api-key" ``` > 如果使用 Railway：`postgres.railway.internal` 仅用于 Railway 内网运行；本地开发需使用 Public 连接串（host 通常为 `containers-*.railway.app`）。 ### 4. 初始化数据库 ```bash npx prisma db push npx prisma db seed # 可选：创建测试数据 ``` ### 4.1 从旧JSON存储迁移（可选） 如果你曾使用 `data/store.json` 保存任务/成员，可执行： ```bash npm run migrate:store ``` ### 4.2 一键本地初始化（推荐） ```bash npm run setup:local ``` ### 4.3 环境变量检查 ```bash npm run check:env ``` ### 5. 启动服务器 ```bash npm start ``` ### 5.1 启动脚本（双环境） ```bash # 本地开发（读取 .env） bash scripts/start-local.sh # 本地模拟生产 bash scripts/start-prod.sh ``` ### 6. 访问应用 ``` 主页: http://localhost:3000 登录: http://localhost:3000/login.html 仪表盘: http://localhost:3000/dashboard.html 短邮系统: http://localhost:3000/shortmail-login.html 管理后台: http://localhost:3000/admin.html ``` --- ## 🚄 Railway 部署（快速） 1. 在 Railway 新建项目并连接仓库 2. 添加 PostgreSQL 插件 3. 在服务 Variables 中配置： - `DATABASE_URL`（Railway 会自动注入） - `JWT_SECRET` - `ANTHROPIC_API_KEY`（可选） 4. Railway 会使用 `railway.toml` 启动 `npm run start:railway` 5. 变量模板见 `railway.env.example` 6. 部署后可用（本地）验证脚本： ```bash HEALTHCHECK_URL="https://your-app.up.railway.app/health" npm run check:deploy ``` --- ## 📱 PWA 支持 已内置 PWA（manifest + service worker）： - `public/manifest.json` - `public/sw.js` - `public/js/pwa.js` 访问站点后即可“添加到主屏幕”。 --- ## 🎓 学习路径 ### 新手入门（1小时） 1. 阅读 `产品文档/超协体产品介绍.md` 2. 阅读 `产品文档/功能清单-v2.0-AI增强版.md` 3. 阅读 `部署文档/快速启动指南.md` 4. 启动本地环境 5. 浏览各个页面 ### 开发者上手（3小时） 1. 阅读 `数据库/schema.prisma` 理解数据模型 2. 阅读 `核心系统/10_核心服务器/server.js` 理解路由 3. 选择一个模块深入研究源代码 4. 尝试修改和扩展功能 ### 架构理解（1天） 1. 研究所有核心模块源代码 2. 理解PWP协议的实现 3. 理解AI集成方式 4. 理解WebSocket实时通信 5. 阅读完整的开发记录 --- ## 🔑 核心技术亮点 ### 1. PWP协议（Personal Workspace Protocol） **不可篡改的工作过程记录** ```javascript // PWPRecord数据模型 { id: UUID, userId: String, projectId: String, eventType: String, // decision_requested, decision_made等 eventData: JSON, // 完整的事件数据 status: String, // active, responded, archived occurredAt: DateTime } ``` ### 2. AI守门人机制 **双层权限 + AI自动审核** ``` 注册 → AI评估PWP画像 → ├─ 通过 → 自动批准 └─ 不确定 → 管理员审核 ``` ### 3. 知识晶体系统 **方案沉淀与复用** ``` 创建方案 → 团队使用 → 评分反馈 → 排行榜 → 跨项目复用 ``` ### 4. 短邮决策通信 **AI增强的决策流** ``` 决策请求 → AI生成建议 → 快速响应/手动响应 → 决策链记录 ``` --- ## 🏆 项目里程碑 ### Phase 1: 核心基础（2026-01） - ✅ 用户系统 - ✅ 项目管理 - ✅ 数据库迁移（JSON → PostgreSQL） ### Phase 2: AI增强（2026-01） - ✅ AI智能推荐引擎 - ✅ AI守门人 - ✅ AI虚拟成员 ### Phase 3: 协作强化（2026-01-02） - ✅ WebSocket实时协作 - ✅ 知识晶体系统 - ✅ 管理后台 ### Phase 4: 决策通信（2026-02） - ✅ 短邮系统（移动+桌面） - ✅ PWP决策记录 - ✅ 决策链可视化 ### Phase 5: 完善优化（2026-02） - ✅ UI优化 - ✅ 文档完善 - ✅ 代码库归档 --- ## 📈 数据库设计 ### 核心数据表（15个） | 表名 | 说明 | 关键字段 | |------|------|---------| | **User** | 用户表 | email, pwpProfile, points | | **Project** | 项目表 | name, description, creatorId | | **ProjectMember** | 项目成员 | projectId, userId, role | | **Task** | 任务表 | title, status, assigneeId | | **Solution** | 知识晶体 | title, content, score | | **PWPRecord** | PWP记录 | eventType, eventData, status | | **Message** | 消息表 | content, senderId, receiverId | | **Notification** | 通知表 | type, content, userId | | **AIMember** | AI成员 | name, role, capabilities | | **SolutionReference** | 晶体引用 | solutionId, taskId | | **SolutionRating** | 晶体评分 | solutionId, rating | | **Invitation** | 邀请表 | email, status, aiScore | | **CollaborationRequest** | 协作请求 | fromUserId, toUserId | | **TaskRecommendation** | 任务推荐 | userId, taskId, score | | **PartnerRecommendation** | 搭档推荐 | userId, partnerId | **完整Schema**: 见 `数据库/schema.prisma` --- ## 🔐 安全机制 ### 1. 认证与授权 - JWT Token认证 - 中间件权限验证 - 角色基于访问控制（RBAC） ### 2. API安全 - 请求频率限制 - SQL注入防护（Prisma ORM） - XSS防护 ### 3. 数据安全 - 密码bcrypt加密 - 敏感数据加密存储 - HTTPS传输（生产环境） --- ## 🌐 部署方案 ### 开发环境 ```bash 本地: http://localhost:3000 数据库: PostgreSQL本地实例 ``` ### 生产环境（Railway） ```bash 应用: https://supercoordination.railway.app 数据库: Railway PostgreSQL CDN: Cloudflare（可选） ``` **详细部署步骤**: 见 `部署文档/RAILWAY_SETUP.md` --- ## 🧪 测试状态 ### 已测试模块 - ✅ 用户系统（注册/登录/认证） - ✅ 项目管理（CRUD操作） - ✅ 任务管理（分配/状态） - ✅ 知识晶体（评分/引用） - ✅ 短邮系统（API + 双端） - ✅ AI守门人（审核流程） - ✅ WebSocket（实时通信） ### 待完善测试 - ⏳ 完整的端到端测试 - ⏳ 压力测试 - ⏳ 安全测试 --- ## 🐛 已知问题 ### P0（严重） 无 ### P1（重要） 无 ### P2（轻微） - 长文本显示优化 - 移动端响应式适配 - 部分边界情况处理 --- ## 🔄 版本历史 ### V1.0（2026-02-03） - 🎉 10个核心模块全部完成 - 📱 短邮系统双端上线 - 📚 完整文档体系 - 🏗️ 代码库归档 ### V0.9（2026-02-01） - 知识晶体系统上线 - AI守门人完善 - 管理后台完成 ### V0.8（2026-01-31） - WebSocket实时协作 - AI推荐引擎 - 数据库优化 ### V0.7（2026-01） - 基础功能完成 - PostgreSQL迁移 - PWP画像系统 --- ## 🤝 贡献指南 ### 开发规范 - 遵循既有代码风格 - 提交前测试功能 - 编写清晰的注释 - 更新相关文档 ### Git提交规范 ``` feat: 新功能 fix: Bug修复 docs: 文档更新 refactor: 代码重构 test: 测试相关 chore: 构建/工具 ``` --- ## 📞 技术支持 ### 文档位置 - **代码库**: `~/Desktop/超协体MVP1.0代码库/` - **文档目录**: `./docs/` ### 关键联系人 - **技术架构**: Claude Sonnet 4.5 - **产品方向**: 指挥官（personalworkplacce） - **项目场景**: 良渚青年公社 --- ## 🎯 下一步计划 ### 短期（Q1 2026） - 移动端PWA应用 - 完整的自动化测试 - 性能优化 - 用户反馈收集 ### 中期（Q2-Q3 2026） - 开放API平台 - 第三方集成 - 企业版功能 - 国际化支持 ### 长期（Q4 2026+） - 超协体生态 - AIGC Studio集成 - Auto-Business Club - 全球化扩展 --- ## 💎 五行能量标注 **代码库五行属性**: - 🏔️ **土（资产）**: 40% - 完整代码库沉淀 - 🌳 **木（生产）**: 30% - 系统实现与功能 - 🔥 **火（叙事）**: 20% - 文档与展示 - ⚙️ **金（法则）**: 7% - 架构与规范 - 🌊 **水（商业）**: 3% - 商业验证 **主权定位**: 🏔️土 + 🌳木双核驱动（资产沉淀 + 生产能力） --- ## ✅ 完成标志 **超协体MVP 1.0开发完成度**: 🎉 **100%** - ✅ 10个核心模块 - ✅ 18个前端页面 - ✅ 8个后端服务 - ✅ 15个数据库表 - ✅ 50+个API端点 - ✅ 完整文档体系 - ✅ 代码库归档 **系统状态**: 🟢 **生产就绪** --- **开发团队**: Claude Sonnet 4.5 + 指挥官 **开发周期**: 2026年1月-2月 **代码库版本**: V1.0 **最后更新**: 2026-02-03 --- **【口号】**: 器已成库，势已蓄能，待势而发，筑梦超协！🚀