feat: 方案二详细实施计划 - 5 Phase 20周完整拆解

2026-06-27 10:21:15 +00:00
1 parent 2874e8dc90
commit 67c3270aad
@@ -0,0 +1,967 @@
 # 方案二：稳扎稳打 — 详细实施计划
 > **定位**: 核心服务全部自研，基础设施用开源，架构完全自主可控
 > **周期**: 20 周（5 个 Phase，每 Phase 4 周）
 > **开发工具**: MiMo Code（Quest Mode + Agent Mode + AGENTS.md）
 > **技术栈**: Go(核心) + Python(AI) + TypeScript(前端) + PostgreSQL + Redis + Kafka + Milvus
 ---
 ## 总览：5 Phase 里程碑
 ```
 Week  1-4   Phase 1: 基座搭建（Auth + DB + Gateway + 项目骨架）
 Week  5-8   Phase 2: 核心引擎（LLM Router + Billing + Metering）
 Week  9-12  Phase 3: 能力治理（Registry + Skills + Dashboard）
 Week 13-16  Phase 4: 生态扩展（IM Bot + MCP + Agent + ACP）
 Week 17-20  Phase 5: 集成上线（测试 + 部署 + 监控 + 运营）
 ```
 ```
         Phase 1        Phase 2        Phase 3        Phase 4        Phase 5
    ┌──────────────┬──────────────┬──────────────┬──────────────┬──────────────┐
    │ 域基础设施    │ 核心引擎      │ 能力治理      │ 生态扩展      │ 集成上线      │
    │              │              │              │              │              │
    │ ✅ 项目骨架   │ ✅ LLM Router │ ✅ Registry  │ ✅ IM Bot GW │ ✅ 全链路测试 │
    │ ✅ Keycloak  │ ✅ Billing    │ ✅ Skills 市场│ ✅ MCP Hub   │ ✅ K8s 部署   │
    │ ✅ APISIX    │ ✅ Metering   │ ✅ Dashboard │ ✅ LangFlow  │ ✅ 监控告警   │
    │ ✅ DB Schema │ ✅ OpenAPI GW │ ✅ Admin     │ ✅ ACP 协议  │ ✅ 文档上线   │
    └──────────────┴──────────────┴──────────────┴──────────────┴──────────────┘
         ▲               ▲               ▲               ▲               ▼
         └───────────────┴───────────────┴───────────────┴───── 可运行交付 ─┘
 ```
 ---
 ## Phase 1：基座搭建（Week 1-4）
 > **目标**: 项目可运行，基础设施就绪，Auth + Gateway + DB 全部跑通
 > **结束标志**: `docker-compose up` 启动所有服务，可注册用户、登录、通过网关调用 API
 ### 1.1 项目骨架初始化（Day 1-2）
 **MiMo Code Quest Prompt**:
 ```
 初始化 AI PaaS 平台项目骨架。
 项目名: ai-paas-platform
 Monorepo 结构 (pnpm workspace):
 - packages/web (React + TypeScript + Ant Design Pro)
 - packages/admin (React + TypeScript + Ant Design Pro)
 - services/gateway (Go)
 - services/auth (Go)
 - services/billing (Go)
 - services/metering (Go)
 - services/registry (Go)
 - services/llm-router (Go)
 - services/skills (Go)
 - services/im-gateway (Go)
 - infra/keycloak (Docker)
 - infra/postgresql (Docker + migrations)
 - infra/redis (Docker)
 - infra/kafka (Docker)
 - infra/milvus (Docker)
 - infra/apisix (Docker)
 - deploy/docker-compose.yml
 生成:
 1. 根目录 Makefile, docker-compose.yml, .env.example
 2. 各 Go 服务的基础 main.go + health endpoint
 3. 各 React 应用的基础 vite 配置
 4. PostgreSQL migration 初始脚本 (001_init.sql)
 5. .mimocode/AGENTS.md 配置文件
 ```
 **交付物**:
 - [ ] Monorepo 目录结构
 - [ ] docker-compose.yml 一键启动所有基础设施
 - [ ] 各服务 health endpoint 可访问
 - [ ] AGENTS.md 配置完成
 ### 1.2 数据库 Schema 设计（Day 3-5）
 **MiMo Code Quest Prompt**:
 ```
 设计 AI PaaS 平台的 PostgreSQL 数据库 Schema。
 核心表:
 1. tenants (租户) - id, name, plan, credit_balance, status, created_at
 2. users (用户) - id, tenant_id, email, name, role, api_key_hash, status
 3. capabilities (能力) - id, tenant_id, name, type, version, endpoint, protocol, status, pricing_config
 4. capability_versions (能力版本) - id, capability_id, version, endpoint, changelog, status
 5. credit_transactions (Credit 流水) - id, tenant_id, type, amount, balance_after, trace_id, idempotency_key
 6. token_usage (Token 用量) - id, tenant_id, capability_id, model, prompt_tokens, completion_tokens, cost_credits, trace_id (按月分区)
 7. subscriptions (订阅) - id, tenant_id, plan, credits_included, credits_used, period_start, period_end, status
 8. skills (技能) - id, tenant_id, name, description, pricing_model, price_credits, status
 9. skill_purchases (技能购买) - id, user_id, skill_id, amount_credits
 10. im_sessions (IM 会话) - id, tenant_id, platform, user_identifier, bot_id, status
 要求:
 - 所有表启用 RLS (Row Level Security)，策略基于 tenant_id
 - 所有表有 created_at/updated_at
 - token_usage 按月分区
 - 外键关系完整
 - 索引覆盖高频查询
 ```
 **交付物**:
 - [ ] 001_init.sql 完整建表脚本
 - [ ] RLS 策略配置
 - [ ] 种子数据脚本 (开发环境)
 ### 1.3 Keycloak 认证服务（Day 6-10）
 **MiMo Code Quest Prompt**:
 ```
 部署 Keycloak 并实现多租户认证适配器。
 1. Docker 部署 Keycloak 25.x
 2. 配置 Realm: ai-paas
 3. 配置 Clients:
   - web-app (PKCE, React 前端)
   - admin-app (PKCE, 管理后台)
   - api-service (Client Credentials, 服务间调用)
 4. 实现 Go 适配器 (services/auth):
   - JWT 验证中间件
   - API Key 验证 (查 DB)
   - 租户上下文提取 (从 JWT claim 提取 tenant_id)
   - RBAC 角色: owner, admin, developer, user
 5. 实现用户注册/登录 API:
   - POST /api/v1/auth/register (邮箱+密码)
   - POST /api/v1/auth/login (返回 JWT)
   - POST /api/v1/auth/refresh
   - GET  /api/v1/auth/me (当前用户信息)
 6. APISIX 集成: jwt-auth 插件配置
 ```
 **交付物**:
 - [ ] Keycloak Docker 配置
 - [ ] Go auth 中间件 (JWT + API Key)
 - [ ] Auth API (注册/登录/刷新)
 - [ ] APISIX jwt-auth 插件配置
 - [ ] RBAC 角色体系
 ### 1.4 Apache APISIX 网关（Day 11-14）
 **MiMo Code Quest Prompt**:
 ```
 部署 Apache APISIX 3.15+ 并配置核心插件。
 1. Docker 部署 APISIX + etcd
 2. 配置以下插件:
   - jwt-auth: JWT 令牌验证
   - key-auth: API Key 验证
   - limit-count: 按租户限流 (1000/min)
   - limit-req: 请求限速
   - api-breaker: 熔断保护
   - proxy-rewrite: 动态路由
   - prometheus: 指标采集
   - cors: 跨域配置
 3. 初始路由配置:
   - /api/v1/auth/* → auth-service:8081
   - /api/v1/capabilities/* → registry-service:8082
   - /api/v1/llm/* → llm-router:8083
   - /api/v1/billing/* → billing-service:8084
   - /api/v1/skills/* → skills-service:8085
   - /api/v1/admin/* → admin-service:8086
 4. 实现动态路由更新机制 (通过 etcd 监听)
 ```
 **交付物**:
 - [ ] APISIX Docker 配置
 - [ ] 插件配置文件
 - [ ] 初始路由表
 - [ ] 动态路由更新机制
 ---
 ## Phase 2：核心引擎（Week 5-8）
 > **目标**: LLM Router + 计费引擎 + 用量追踪 全部跑通，可以调用 LLM 并计费
 > **结束标志**: 用户通过 API Key 调用 LLM，自动扣费，用量可查
 ### 2.1 LLM Provider Router（Day 15-20）
 **MiMo Code Quest Prompt**:
 ```
 实现 LLM Provider Router 服务 (Go)。
 功能:
 1. 多平台 LLM 对接 (OpenAI 兼容格式):
   - DeepSeek: https://api.deepseek.com/v1
   - 千问: https://dashscope.aliyuncs.com/compatible-mode/v1
   - 豆包: https://ark.cn-beijing.volces.com/api/v3
   - 百度: 适配层封装为 OpenAI 格式
   - 元宝: https://api.yuanbao.tencent.com/v1
   - 智谱: https://open.bigmodel.cn/api/paas/v4
   - 本地 Ollama: http://localhost:11434/v1
 2. 智能路由:
   - 按用户选择路由
   - 按成本自动选择最便宜模型
   - 按延迟自动选择最快模型
   - 故障转移: 主模型不可用时自动切换
 3. API:
   - POST /v1/chat/completions (OpenAI 兼容)
   - GET  /api/v1/models (可用模型列表)
   - GET  /api/v1/providers (提供商状态)
 4. 数据模型:
   - providers: id, name, base_url, api_key_encrypted, models_json, status, priority
   - model_routing_rules: model, provider_id, priority, is_default
 5. 配置:
   - YAML 配置文件 + DB 动态更新
   - API Key 加密存储 (AES-256)
   - 连接池管理
   - 超时配置 (默认 30s)
 ```
 **交付物**:
 - [ ] llm-router Go 服务
 - [ ] 7 个平台适配器
 - [ ] 智能路由逻辑
 - [ ] 故障转移机制
 - [ ] OpenAI 兼容 API
 ### 2.2 Token 计费引擎（Day 21-27）
 **MiMo Code Quest Prompt**:
 ```
 实现 Token 计费引擎 (Go + Redis Lua)。
 核心设计原则:
 - 先扣后服: 先扣减余额，再允许调用
 - 幂等: 通过 idempotency_key 防重复扣费
 - 原子: Redis Lua 脚本保证原子性
 - 可审计: 每笔变动有 trace_id
 Credit 模型:
 - 1 Credit = 1000 tokens (默认)
 - 不同模型有系数: deepseek-chat=1.0, deepseek-reasoner=2.0, gpt-4o=10.0
 Redis Lua 脚本 (metering.lua):
 1. 幂等检查 (billing:idempotency:{tenant}:{key})
 2. 余额检查 (billing:balance:{tenant})
 3. 扣减余额 (DECRBY)
 4. 记录幂等结果 (SET + 24h TTL)
 5. 更新今日统计 (billing:daily:{tenant}:{date})
 Go 服务 (services/billing):
 - POST /api/v1/billing/meter (实时计量，调用 Lua)
 - POST /api/v1/billing/topup (充值)
 - GET  /api/v1/billing/balance (查询余额)
 - GET  /api/v1/billing/transactions (流水查询)
 - POST /api/v1/billing/subscribe (订阅管理)
 - GET  /api/v1/billing/subscription (订阅状态)
 订阅套餐:
 - Free: ¥0/月, 100 Credits, 2 QPS
 - Pro: ¥99/月, 50000 Credits, ¥0.01/Credit 超出, 20 QPS
 - Team: ¥499/月, 300000 Credits, ¥0.008/Credit 超出, 100 QPS
 Redis Key 设计:
 - billing:balance:{tenant_id} → String (毫 Credit)
 - billing:idempotency:{tenant_id}:{key} → Hash
 - billing:daily:{tenant_id}:{YYYY-MM-DD} → Hash
 - billing:subscription:{tenant_id} → Hash
 ```
 **交付物**:
 - [ ] metering.lua 脚本
 - [ ] billing-service Go 服务
 - [ ] 计费 API (6 个接口)
 - [ ] 订阅套餐配置
 - [ ] 单元测试 (Lua + Go)
 ### 2.3 用量追踪 Kafka → PostgreSQL（Day 28-32）
 **MiMo Code Quest Prompt**:
 ```
 实现用量追踪服务 (Go)。
 架构:
 LLM Router → Kafka Topic (usage.events) → Metering Consumer → PostgreSQL
 Kafka Topic:
 - topic: usage.events
 - partition_key: tenant_id
 - retention: 7d
 Consumer (services/metering):
 1. 消费 usage.events
 2. 写入 token_usage 表 (按月分区)
 3. 更新 tenant_balances 表 (从 Redis 同步)
 4. 异常处理: 消费失败重试 3 次后进入死信队列
 API:
 - GET /api/v1/usage/summary?period=daily&date=2026-06-27 (用量汇总)
 - GET /api/v1/usage/detail?start=...&end=... (用量明细)
 - GET /api/v1/usage/by-model (按模型统计)
 - GET /api/v1/usage/by-capability (按能力统计)
 PostgreSQL 表:
 - token_usage (按月分区，不可变)
 - tenant_balances (实时同步)
 - usage_summaries (预聚合，每小时刷新)
 ```
 **交付物**:
 - [ ] Kafka producer (在 LLM Router 中)
 - [ ] metering-service Go 服务
 - [ ] Consumer 逻辑
 - [ ] 用量查询 API
 - [ ] 预聚合定时任务
 ### 2.4 OpenAPI 网关（Day 33-35）
 **MiMo Code Quest Prompt**:
 ```
 实现平台 OpenAPI 网关 (Go)。
 功能:
 1. 对外暴露统一 OpenAI 兼容 API:
   - POST /v1/chat/completions
   - GET  /v1/models
   - POST /v1/embeddings
 2. 内部路由到 LLM Router
 3. 请求拦截链:
   - API Key 验证 → 租户上下文 → 余额检查 → 调用 LLM Router → 计费扣减 → 返回结果
 4. 流式响应支持 (SSE)
 5. 用量上报 (异步发 Kafka)
 API:
 - POST /v1/chat/completions (OpenAI 兼容，对外入口)
 - POST /v1/capabilities/{id}/invoke (能力调用)
 - GET  /v1/capabilities (能力列表)
 ```
 **交付物**:
 - [ ] openapi-gateway Go 服务
 - [ ] OpenAI 兼容 API
 - [ ] 流式 SSE 支持
 - [ ] 请求拦截链
 ---
 ## Phase 3：能力治理（Week 9-12）
 > **目标**: 能力注册中心 + Skills 市场 + 用户 Dashboard + 管理后台
 > **结束标志**: 用户可在 Dashboard 管理能力、购买技能、查看用量
 ### 3.1 Capability Registry（Day 36-42）
 **MiMo Code Quest Prompt**:
 ```
 实现能力注册中心 (Go + gRPC/REST)。
 功能:
 1. 能力 CRUD:
   - POST   /api/v1/capabilities (注册)
   - DELETE /api/v1/capabilities/{id} (注销)
   - GET    /api/v1/capabilities (列表，支持 type/status/tags 过滤)
   - GET    /api/v1/capabilities/{id} (详情)
   - PUT    /api/v1/capabilities/{id} (更新)
   - POST   /api/v1/capabilities/{id}/versions (发布新版本)
 2. 能力类型:
   - agent: AI 智能体
   - mcp: MCP 服务
   - skill: 技能
   - llm: LLM 提供商
   - custom: 自定义 OpenAPI 应用
 3. 元数据:
   - name, type, version, description, tags
   - endpoint (调用地址)
   - protocol (rest/grpc/websocket)
   - pricing_config (计费配置)
   - dependencies (依赖的其他能力)
   - status: active / deprecated / beta
 4. 服务发现:
   - 按类型查询
   - 按标签查询
   - 按状态过滤
 5. gRPC 接口 (服务间调用):
   - RegisterCapability
   - DeregisterCapability
   - GetCapability
   - ListCapabilities
   - HealthCheck
 ```
 **交付物**:
 - [ ] registry-service Go 服务
 - [ ] REST API (6 个接口)
 - [ ] gRPC 接口 (5 个方法)
 - [ ] 能力发现/查询
 - [ ] 版本管理
 ### 3.2 Skills 市场（Day 43-47）
 **MiMo Code Quest Prompt**:
 ```
 实现 Skills 市场服务 (Go)。
 功能:
 1. 技能管理:
   - POST   /api/v1/skills (发布技能)
   - GET    /api/v1/skills (市场列表，支持搜索/分类/排序)
   - GET    /api/v1/skills/{id} (技能详情)
   - PUT    /api/v1/skills/{id} (更新)
   - DELETE /api/v1/skills/{id} (下架)
 2. 技能购买:
   - POST /api/v1/skills/{id}/purchase (购买，扣 Credit)
   - GET  /api/v1/skills/purchased (已购列表)
   - 扣费通过 Billing Engine API
 3. 计费模式:
   - per_call: 每次调用扣费
   - per_token: 按 Token 扣费
   - subscription: 订阅制
   - free: 免费
 4. 分成:
   - 平台抽成 25%
   - 开发者分成 75%
   - 预留 skill_earnings 表
 5. 搜索:
   - PostgreSQL 全文搜索 (中文分词: zhparser)
   - 按分类、标签、评分排序
 ```
 **交付物**:
 - [ ] skills-service Go 服务
 - [ ] 技能 CRUD API
 - [ ] 购买流程 (调用 Billing)
 - [ ] 全文搜索
 - [ ] 分成逻辑 (预留)
 ### 3.3 用户 Dashboard（Day 48-54）
 **MiMo Code Quest Prompt**:
 ```
 实现用户 Dashboard (React + TypeScript + Ant Design Pro)。
 页面:
 1. 首页概览:
   - Credit 余额 + 充值按钮
   - 今日/本月用量图表 (ECharts)
   - 快捷操作 (创建能力、浏览市场)
 2. API Key 管理:
   - 创建/删除 API Key
   - Key 使用统计
 3. 用量详情:
   - 按日/周/月图表
   - 按模型/能力分类统计
   - 导出 CSV
 4. 账单中心:
   - Credit 流水记录
   - 订阅管理 (升级/降级/取消)
   - 充值历史
 5. 我的能力:
   - 已创建的能力列表
   - 已购买的技能
 6. 设置:
   - 个人信息
   - 通知偏好
 技术:
 - React 18 + TypeScript + Ant Design Pro 6
 - ECharts 图表
 - React Query 数据管理
 - React Router 路由
 ```
 **交付物**:
 - [ ] web React 应用
 - [ ] 6 个页面
 - [ ] API 对接
 - [ ] 响应式设计
 ### 3.4 管理后台（Day 55-58）
 **MiMo Code Quest Prompt**:
 ```
 实现管理后台 (React + TypeScript + Ant Design Pro)。
 页面:
 1. 仪表盘:
   - 总用户数、总租户数、总 API 调用量
   - 收入统计
   - 系统状态
 2. 用户管理:
   - 用户列表 (搜索/过滤/分页)
   - 用户详情
   - 封禁/解封
 3. 租户管理:
   - 租户列表
   - 租户详情 (订阅/用量/余额)
   - 调整余额
 4. 能力审核:
   - 待审核能力列表
   - 审核通过/拒绝
 5. 系统配置:
   - LLM 提供商配置
   - 订阅套餐配置
   - 全局限流配置
 6. 监控:
   - API 调用趋势
   - 错误率
   - 响应时间
 ```
 **交付物**:
 - [ ] admin React 应用
 - [ ] 6 个管理页面
 - [ ] RBAC 权限控制
 ---
 ## Phase 4：生态扩展（Week 13-16）
 > **目标**: IM Bot + MCP + Agent + ACP 全部接入
 > **结束标志**: 用户可通过微信/QQ 与 AI 对话，可使用 MCP 工具，可创建 Agent
 ### 4.1 IM Bot 网关（Day 59-65）
 **MiMo Code Quest Prompt**:
 ```
 实现 IM Bot 网关 (Go)。
 功能:
 1. 多平台适配器:
   - 微信 (通过 LangBot/OpenClaw 协议)
   - QQ (通过 go-cqhttp 协议)
   - 钉钉 (通过钉钉开放平台 API)
 2. 统一路由:
   - 消息接收 → 平台识别 → 上下文注入 → 调用 LLM Router → 回复
   - 会话管理 (Redis 存储上下文)
 3. API:
   - POST /api/v1/im/callback/{platform} (平台回调)
   - GET  /api/v1/im/sessions (会话列表)
   - GET  /api/v1/im/sessions/{id}/messages (消息历史)
 4. 配置:
   - 每个平台独立配置 (token, secret, etc.)
   - 每个租户独立的 bot 实例
 5. 消息格式:
   - 文本/图片/文件
   - Markdown 渲染
   - 按钮交互
 ```
 **交付物**:
 - [ ] im-gateway Go 服务
 - [ ] 微信适配器 (集成 LangBot)
 - [ ] QQ 适配器
 - [ ] 钉钉适配器
 - [ ] 会话管理
 ### 4.2 MCP Hub 集成（Day 66-68）
 **MiMo Code Quest Prompt**:
 ```
 集成 mcp-hub 开源服务。
 1. Docker 部署 mcp-hub
 2. 与 Capability Registry 联动:
   - MCP Server 注册时自动在 Registry 创建 capability 记录
   - Registry 中 MCP 类型能力自动同步到 mcp-hub
 3. API 代理:
   - /api/v1/mcp/servers → mcp-hub API
   - /api/v1/mcp/tools → mcp-hub 工具列表
   - /api/v1/mcp/call → mcp-hub 工具调用 (经过计费)
 4. 计费集成:
   - MCP 工具调用经过 Billing Engine 扣费
 ```
 **交付物**:
 - [ ] mcp-hub Docker 配置
 - [ ] Registry 联动逻辑
 - [ ] MCP API 代理
 - [ ] 计费集成
 ### 4.3 LangFlow Agent 集成（Day 69-73）
 **MiMo Code Quest Prompt**:
 ```
 集成 LangFlow 开源服务。
 1. Docker 部署 LangFlow
 2. 与 Capability Registry 联动:
   - LangFlow Flow 发布时自动在 Registry 创建 capability 记录
   - 支持 Flow 版本管理
 3. API 代理:
   - /api/v1/agent/flows → LangFlow Flow 列表
   - /api/v1/agent/flows/{id}/run → 运行 Flow (经过计费)
   - /api/v1/agent/flows/{id}/chat → 流式对话 (SSE)
 4. 计费集成:
   - Agent 调用经过 Billing Engine 扣费
 5. 用户界面:
   - Dashboard 中嵌入 LangFlow 编辑器 (iframe)
   - Flow 管理页面
 ```
 **交付物**:
 - [ ] LangFlow Docker 配置
 - [ ] Registry 联动逻辑
 - [ ] Agent API 代理
 - [ ] 计费集成
 ### 4.4 ACP 协议基础（Day 74-77）
 **MiMo Code Quest Prompt**:
 ```
 实现 ACP (Agent Communication Protocol) 基础。
 1. 协议定义:
   - Agent 间消息格式 (JSON)
   - 消息类型: request, response, notification, error
   - 路由: 基于 agent_id 寻址
 2. 消息总线:
   - 基于 Kafka 的 Agent 消息队列
   - topic: agent.messages.{agent_id}
   - 支持同步/异步通信
 3. API:
   - POST /api/v1/acp/send (发送消息)
   - GET  /api/v1/acp/messages (接收消息)
   - GET  /api/v1/acp/agents (已注册 Agent 列表)
 4. 安全:
   - Agent 间通信需要认证
   - 消息签名验证
 ```
 **交付物**:
 - [ ] ACP 协议定义
 - [ ] 消息总线实现
 - [ ] ACP API
 - [ ] 安全机制
 ---
 ## Phase 5：集成上线（Week 17-20）
 > **目标**: 全链路测试 + 生产部署 + 监控 + 文档
 > **结束标志**: 平台可在生产环境运行，有完整文档
 ### 5.1 全链路测试（Day 78-83）
 **MiMo Code Quest Prompt**:
 ```
 编写 AI PaaS 平台的全链路测试。
 1. 单元测试:
   - 各 Go 服务核心逻辑
   - Redis Lua 脚本测试
   - TypeScript 前端组件测试
 2. 集成测试:
   - Auth → LLM Router → Billing 完整流程
   - Capability 注册 → 调用 → 计费流程
   - Skills 购买 → 使用 → 分成流程
 3. E2E 测试:
   - 用户注册 → 登录 → 创建 API Key → 调用 LLM → 查看用量
   - 管理员登录 → 审核能力 → 查看统计
 4. 压力测试:
   - LLM Router 并发 (100 QPS)
   - Billing Engine 并发 (1000 TPS)
   - API Gateway 压力 (500 RPS)
 5. 测试工具:
   - Go: testing + testify
   - TypeScript: vitest + playwright
   - 压力: k6
 ```
 **交付物**:
 - [ ] 单元测试覆盖率 > 80%
 - [ ] 集成测试套件
 - [ ] E2E 测试脚本
 - [ ] 压力测试报告
 ### 5.2 生产部署（Day 84-88）
 **MiMo Code Quest Prompt**:
 ```
 准备 AI PaaS 平台的生产部署配置。
 1. Docker Compose (单机部署):
   - 所有服务容器化
   - 环境变量配置
   - 健康检查
   - 自动重启
 2. Kubernetes (集群部署):
   - Helm Chart 编写
   - Deployment + Service + Ingress
   - ConfigMap + Secret
   - HPA 自动扩缩容
   - PDB (Pod Disruption Budget)
 3. 数据库:
   - PostgreSQL 备份策略 (pg_dump 每日)
   - Redis 持久化配置
   - Kafka 备份
 4. 域名 + SSL:
   - Nginx Ingress 配置
   - Let's Encrypt 自动证书
 5. 环境区分:
   - dev: docker-compose
   - staging: k8s namespace
   - production: k8s namespace
 ```
 **交付物**:
 - [ ] docker-compose.prod.yml
 - [ ] Helm Chart
 - [ ] 部署脚本
 - [ ] 环境配置模板
 ### 5.3 监控告警（Day 89-91）
 **MiMo Code Quest Prompt**:
 ```
 配置 AI PaaS 平台的监控告警系统。
 1. Prometheus:
   - 各服务 metrics 端点
   - 自定义指标:
     - llm_router_request_total (by provider, model, status)
     - billing_credit_deduction_total (by tenant)
     - api_gateway_request_duration_seconds
   - 采集配置
 2. Grafana:
   - Dashboard 配置:
     - 平台总览 (请求数/错误率/延迟)
     - LLM Router (各提供商状态/延迟)
     - Billing (收入/扣费趋势)
     - 用户活跃度
   - 告警规则
 3. 告警:
   - 错误率 > 5% → 告警
   - 延迟 P99 > 5s → 告警
   - 余额 < 阈值 → 通知用户
   - 服务不可用 → 立即告警
 4. 日志:
   - 结构化日志 (JSON)
   - 日志级别: debug/info/warn/error
   - 集中收集 (Loki 或 ELK)
 ```
 **交付物**:
 - [ ] Prometheus 配置
 - [ ] Grafana Dashboard JSON
 - [ ] 告警规则
 - [ ] 日志配置
 ### 5.4 文档上线（Day 92-95）
 **MiMo Code Quest Prompt**:
 ```
 编写 AI PaaS 平台的完整文档。
 1. API 文档:
   - OpenAPI 3.0 规范 (api-spec.yaml)
   - 每个接口的详细说明
   - 请求/响应示例
   - 错误码列表
 2. 开发者文档:
   - 快速开始指南
   - 认证说明 (JWT + API Key)
   - SDK 使用示例 (Python/Go/TypeScript)
   - MCP Server 接入指南
   - Agent 发布指南
 3. 运维文档:
   - 部署指南
   - 配置说明
   - 故障排查
   - 备份恢复
 4. 架构文档:
   - 系统架构图
   - 数据流图
   - 数据库 ER 图
   - 部署架构图
 5. 用户文档:
   - 注册/登录指南
   - API Key 使用指南
   - 用量查看指南
   - 订阅管理指南
 ```
 **交付物**:
 - [ ] API 文档 (OpenAPI 3.0)
 - [ ] 开发者文档站
 - [ ] 运维文档
 - [ ] 架构文档
 - [ ] 用户文档
 ---
 ## MiMo Code 核心配置 (.mimocode/AGENTS.md)
 ```markdown
 # AI PaaS Platform
 ## 架构
 - Go 后端服务 (API Gateway, LLM Router, Billing, Registry, Metering, Skills, IM Gateway)
 - Python AI 服务 (LangFlow, MCP Hub)
 - TypeScript 前端 (React + Ant Design Pro: web + admin)
 - Infrastructure: PostgreSQL + Redis + Kafka + Milvus + Keycloak + APISIX
 ## 技术栈
 - Go 1.22+ (高服务: 网关, 路由, 计费, 注册中心)
 - Python 3.11+ (AI 服务: LangFlow, MCP)
 - TypeScript 5+ (前端: React 18, Ant Design Pro 6, ECharts)
 - PostgreSQL 16 (主数据库, RLS 多租户隔离)
 - Redis 7 (缓存 + Lua 原子计费)
 - Kafka 3.x (事件总线: 用量上报)
 - Milvus 2.x (向量数据库: RAG)
 - Keycloak 25+ (认证授权)
 - Apache APISIX 3.15+ (API Gateway)
 - Docker + K8s (部署)
 - Prometheus + Grafana (监控)
 ## 开发规范
 - Go: gofmt + golangci-lint, 遵循 Effective Go
 - Python: ruff + black
 - TypeScript: eslint + prettier
 - 所有 API 必须有 OpenAPI 3.0 规范
 - 所有数据库变更必须有 Migration 脚本 (版本号递增)
 - Git: Conventional Commits (feat/fix/docs/chore)
 - 测试: 单元测试覆盖率 > 80%
 ## 核心模块
 - services/auth: Keycloak 适配器 + JWT/API Key 验证
 - services/gateway: APISIX 自研插件
 - services/llm-router: 多平台 LLM 智能路由 + 故障转移
 - services/billing: Token 计费引擎 (Redis Lua 原子操作)
 - services/metering: 用量追踪 (Kafka → PostgreSQL)
 - services/registry: 能力注册中心 (gRPC + REST)
 - services/skills: Skills 市场
 - services/im-gateway: IM Bot 多平台网关
 ## 数据库
 - 所有表启用 RLS，策略基于 tenant_id
 - token_usage 按月分区
 - credit_transactions 不可变 (追加写)
 - 所有金额使用整数 (毫 Credit)，避免浮点
 ## 计费原则
 - 先扣后服: 先扣减余额，再允许调用
 - 幂等: 通过 idempotency_key 防重复扣费
 - 原子: Redis Lua 脚本保证原子性
 - 可审计: 每笔变动有 trace_id + 原因
 ## LLM 对接
 - 统一 OpenAI 兼容格式: POST /v1/chat/completions
 - 百度需要适配层 (非标准 API)
 - 其他平台直接兼容
 - API Key 加密存储 (AES-256)
 ```
 ---
 ## 风险与对策
 | 风险 | 等级 | 影响 | 对策 |
 |------|------|------|------|
 | 开发周期长 | 高 | 20 周投入大 | 分 Phase 交付，每 Phase 结束有可运行成果 |
 | 技术复杂度高 | 中 | 多服务协调 | MiMo Code 辅助生成骨架，降低编码量 |
 | 单人开发 | 中 | 人力瓶颈 | 严格控制范围，Phase 内任务优先级排序 |
 | APISIX 学习曲线 | 低 | 网关配置复杂 | 文档完善，社区活跃，插件机制成熟 |
 | Kafka 运维 | 中 | 消息积压 | 监控 Consumer Lag，自动扩缩容 |
 | 数据一致性 | 中 | 计费准确性 | Redis Lua 原子操作 + 每日对账 |
 | LLM 平台 API 变动 | 低 | 适配器失效 | 抽象 Provider 接口，变动时只改适配器 |
 ---
 ## 每日开发节奏建议
 ```
 09:00-09:15  每日站会 (自检: 昨日完成/今日计划/阻塞)
 09:15-12:00  MiMo Code 核心开发 (Quest Mode / Agent Mode)
 12:00-13:30  午休
 13:30-15:00  MiMo Code 继续开发
 15:00-15:30  Code Review + 测试
 15:30-17:00  MiMo Code 补充测试 + 文档
 17:00-17:30  Git 提交 + 推送 + 更新进度
 ```
 ---
 ## Phase 完成检查清单
 每个 Phase 结束时，必须通过以下检查：
 ### Phase 1 检查
 - [ ] `docker-compose up` 所有服务正常启动
 - [ ] Keycloak 可注册/登录用户
 - [ ] APISIX 可转发请求到后端服务
 - [ ] 数据库 Schema 已创建，RLS 策略生效
 - [ ] 各服务 health endpoint 返回 200
 ### Phase 2 检查
 - [ ] 可通过 API Key 调用 LLM (至少 3 个平台)
 - [ ] 调用后自动扣费，余额正确
 - [ ] 用量数据写入 PostgreSQL
 - [ ] 流式响应 (SSE) 正常工作
 - [ ] 故障转移测试通过 (关闭主模型，自动切换)
 ### Phase 3 检查
 - [ ] 可注册新能力 (Agent/MCP/Skill)
 - [ ] 可在市场购买技能
 - [ ] Dashboard 显示正确的余额和用量
 - [ ] 管理后台可管理用户和租户
 - [ ] 搜索功能正常
 ### Phase 4 检查
 - [ ] IM Bot 可收发消息 (至少 1 个平台)
 - [ ] MCP 工具可调用并计费
 - [ ] LangFlow Flow 可运行并计费
 - [ ] ACP 消息可发送和接收
 ### Phase 5 检查
 - [ ] 单元测试覆盖率 > 80%
 - [ ] 全链路 E2E 测试通过
 - [ ] 压力测试报告 (目标: 500 RPS)
 - [ ] Docker Compose 生产配置可用
 - [ ] Grafana Dashboard 正常显示
 - [ ] API 文档完整 (OpenAPI 3.0)
 - [ ] 开发者文档可访问
 ---
 *文档版本: 1.0 | 更新日期: 2026-06-27 | 基于 5 平台交叉验证共识*