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路由
• 错误处理
• 日志记录
• 性能优化

📊 代码统计

数据库表: 15个主要表 API端点: 50+个端点

🚀 快速开始

1. 环境要求

Node.js >= 16.0.0
PostgreSQL >= 13.0
npm >= 7.0.0

2. 安装依赖

npm install

3. 配置数据库

# 创建 .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. 初始化数据库

npx prisma db push
npx prisma db seed  # 可选：创建测试数据

4.1 从旧JSON存储迁移（可选）

如果你曾使用 data/store.json 保存任务/成员，可执行：

npm run migrate:store

4.2 一键本地初始化（推荐）

npm run setup:local

4.3 环境变量检查

npm run check:env

5. 启动服务器

npm start

5.1 启动脚本（双环境）

# 本地开发（读取 .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（可选）

1. Railway 会使用 railway.toml 启动 npm run start:railway
2. 变量模板见 railway.env.example
3. 部署后可用（本地）验证脚本：

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）

不可篡改的工作过程记录

// 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个）

完整Schema: 见 数据库/schema.prisma

🔐 安全机制

1. 认证与授权

• JWT Token认证
• 中间件权限验证
• 角色基于访问控制（RBAC）

2. API安全

• 请求频率限制
• SQL注入防护（Prisma ORM）
• XSS防护

3. 数据安全

• 密码bcrypt加密
• 敏感数据加密存储
• HTTPS传输（生产环境）

🌐 部署方案

开发环境

本地: http://localhost:3000
数据库: PostgreSQL本地实例

生产环境（Railway）

应用: 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

【口号】: 器已成库，势已蓄能，待势而发，筑梦超协！🚀