跨角色协作流程合规性检查报告
检查时间: 2026-02-03
检查范围: 所有角色之间的协作流程
参考文档: MBE_BUSINESS_LOGIC_AND_WORKFLOW.md - 跨角色协作流程
📋 跨角色协作概述
MBE系统中存在以下主要跨角色协作流程：
- 开发者-管理员协作 - 注册审核、专家审核、结算审核
- 用户-开发者-系统协作 - 专家咨询、收益分成
- 运营员-管理员协作 - 数据上报、问题升级
- 企业-用户协作 - 子账号管理、Token分配
✅ 协作流程1: 开发者-管理员协作
流程图
开发者 管理员
│ │
│──1. 提交注册申请────────────>│
│ │──2. 审核申请
│ │
│<──3. 审核结果（通过/拒绝）───│
│ │
│ (如果通过) │
│ │ │
│ │──4. 创建知识库────────>│
│ │ │
│ │──5. 创建专家──────────>│
│ │ │
│ │──6. 发布到市场────────>│
│ │ │
│ │ │──7. 审核专家内容
│ │ │
│ │<──8. 审核结果──────────│
│ │ │
│ │ (如果通过) │
│ │ │──9. 上架市场
│ │ │
│ │<──10. 上架通知─────────│
│ │ │
│ │──11. 用户使用产生收益──│
│ │ │
│ │──12. 申请结算──────────>│
│ │ │
│ │ │──13. 审核结算
│ │ │
│ │<──14. 结算到账─────────│
实现状态
| 协作节点 |
状态 |
代码位置 |
说明 |
| 开发者注册申请 |
✅ |
src/api/portal.py |
portal_register_submit() |
| 管理员审核申请 |
✅ |
src/api/admin/api_clients_api.py |
approve_client() / reject_client() |
| 通知开发者审核结果 |
✅ |
src/api/admin/api_clients_api.py |
_notify_developer_account() |
| 专家发布审核 |
✅ |
src/api/admin/expert_review.py |
expert_review_page() |
| 专家上架市场 |
✅ |
src/api/admin/market.py |
toggle_market_expert() |
| 收益结算申请 |
✅ |
src/api/portal.py |
portal_request_settlement() |
| 结算审核 |
✅ |
src/api/admin/billing_api.py |
结算审批API |
审核节点详情
| 审核类型 |
触发条件 |
审核人 |
审核内容 |
API端点 |
| 开发者审核 |
开发者注册 |
管理员 |
公司信息、资质 |
POST /admin/api/api-clients/{id}/approve |
| 专家审核 |
发布到市场 |
管理员 |
内容合规、质量 |
POST /admin/api/market/experts/{id}/approve |
| 结算审核 |
申请结算 |
管理员 |
收益数据、合规 |
POST /admin/api/billing/settlements/{id}/approve |
完成度: ✅ 100%
✅ 协作流程2: 用户-开发者-系统协作
流程图
用户 系统 开发者
│ │ │
│──1. 发起咨询────────>│ │
│ │ │
│ │──2. 匹配专家────────>│
│ │ │
│ │<──3. 专家响应────────│
│ │ │
│ │──4. MBE行为分析 │
│ │ │
│<──5. 获得建议────────│ │
│ │ │
│──6. 用户反馈────────>│ │
│ │ │
│ │──7. 记录使用数据────>│
│ │ │
│──8. Token消耗────────│ │
│ │ │
│ │──9. 收益统计─────────>│
│ │ │
│ │──10. 开发者收益入账──│
实现状态
| 协作节点 |
状态 |
代码位置 |
说明 |
| 用户发起咨询 |
✅ |
src/api/chat.py |
chat_with_expert() |
| 专家匹配路由 |
✅ |
src/knowledge/expert_router.py |
route_query() |
| MBE行为分析 |
✅ |
src/mcp/server.py |
五步分析流程 |
| 用户反馈收集 |
✅ |
src/api/feedback.py |
反馈API |
| Token消耗计费 |
✅ |
src/users/token_billing.py |
record_usage() |
| 开发者收益统计 |
✅ |
src/market/billing.py |
record_developer_revenue() |
收益分成流程
用户消费 Token ──► 平台记录 ──► 计算分成 ──► 开发者收益入账
│
└── 分成比例: 开发者70% / 平台30%
完成度: ✅ 100%
✅ 协作流程3: 运营员-管理员协作
流程图
运营员 管理员
│ │
│──1. 监控数据────────────────│
│ │
│──2. 发现异常────────────────│
│ │
│──3. 生成报表────────────────│
│ │
│──4. 上报问题───────────────>│
│ │
│ │──5. 分析处理
│ │
│<──6. 处理结果───────────────│
│ │
│──7. 跟踪反馈────────────────│
实现状态
| 协作节点 |
状态 |
代码位置 |
说明 |
| 数据监控 |
✅ |
src/api/admin/dashboard.py |
仪表板数据 |
| 报表生成 |
✅ |
src/api/admin/reports.py |
报表生成API |
| 问题上报 |
⚠️ |
- |
暂无工单系统 |
| 处理跟踪 |
⚠️ |
- |
暂无工单系统 |
权限分离
| 操作 |
运营员 |
管理员 |
| 查看数据 |
✅ |
✅ |
| 生成报表 |
✅ |
✅ |
| 审核内容 |
❌ |
✅ |
| 修改配置 |
❌ |
✅ |
| 管理用户 |
❌ |
✅ |
完成度: ⚠️ 80% (缺少工单系统)
✅ 协作流程4: 企业-子账号协作
流程图
企业用户 子账号
│ │
│──1. 创建子账号────────────>│
│ │
│──2. 分配Token额度─────────>│
│ │
│──3. 设置权限──────────────>│
│ │
│ │──4. 使用专家服务
│ │
│<──5. 使用数据汇总──────────│
│ │
│──6. 调整额度──────────────>│
实现状态
| 协作节点 |
状态 |
代码位置 |
说明 |
| 创建子账号 |
✅ |
src/users/router.py |
create_sub_account() |
| 分配Token额度 |
✅ |
src/users/router.py |
allocate_sub_account_tokens() |
| 设置权限 |
✅ |
src/users/router.py |
update_sub_account_quota() |
| 使用数据汇总 |
✅ |
src/users/router.py |
企业成本分析页 |
完成度: ✅ 100%
📊 协作流程汇总
完成度矩阵
| 协作流程 |
参与角色 |
完成度 |
说明 |
| 开发者-管理员 |
开发者 ↔ 管理员 |
100% ✅ |
审核流程完整 |
| 用户-开发者-系统 |
用户 ↔ 系统 ↔ 开发者 |
100% ✅ |
咨询和收益流程完整 |
| 运营员-管理员 |
运营员 ↔ 管理员 |
80% ⚠️ |
缺少工单系统 |
| 企业-子账号 |
企业 ↔ 子账号 |
100% ✅ |
Token管理完整 |
核心协作API
| 协作场景 |
API端点 |
方法 |
| 开发者申请审核 |
/admin/api/api-clients/{id}/approve |
POST |
| 开发者申请拒绝 |
/admin/api/api-clients/{id}/reject |
POST |
| 专家审核通过 |
/admin/api/market/experts/{id}/approve |
POST |
| 专家审核拒绝 |
/admin/api/market/experts/{id}/reject |
POST |
| 结算审批 |
/admin/api/billing/settlements/{id}/approve |
POST |
| 创建子账号 |
/api/v1/users/enterprise/sub-accounts |
POST |
| 分配Token |
/api/v1/users/enterprise/sub-accounts/{id}/allocate |
POST |
🔔 通知机制
已实现的通知
| 触发事件 |
通知对象 |
通知方式 |
状态 |
| 开发者审核通过 |
开发者 |
数据库通知 |
✅ |
| 开发者审核拒绝 |
开发者 |
数据库通知 |
✅ |
| 专家审核结果 |
开发者 |
数据库通知 |
✅ |
| 结算完成 |
开发者 |
数据库通知 |
✅ |
| Token额度变更 |
子账号 |
数据库通知 |
⚠️ |
待完善的通知
| 触发事件 |
建议通知方式 |
优先级 |
| 邮件通知 |
SMTP发送 |
中 |
| 实时推送 |
WebSocket |
低 |
| 短信通知 |
SMS网关 |
低 |
📈 状态流转图
开发者账户状态
┌──────────────────────────────────────────┐
│ │
▼ │
┌─────────┐ │
│ pending │ ────审核拒绝────► ┌──────────┐ │
│(待审核) │ │ rejected │ │
└────┬────┘ │ (已拒绝) │ │
│ └──────────┘ │
│ │
审核通过 │
│ │
▼ │
┌──────────┐ │
│ approved │ ────激活────► ┌─────────┐ │
│(已批准) │ │ active │──────────┘
└──────────┘ │ (活跃) │ (违规)
└────┬────┘
│
违规封禁
│
▼
┌───────────┐
│ suspended │
│ (已封禁) │
└───────────┘
专家状态
┌──────────┐ ┌──────────┐ ┌───────────┐
│ creating │ ───► │ active │ ───► │ training │
│ (创建中) │ │ (活跃) │ │ (训练中) │
└──────────┘ └────┬─────┘ └─────┬─────┘
│ │
▼ │
┌─────────┐ │
│ pending │ ◄────────────┘
│(待审核) │
└────┬────┘
│
┌──────────┼──────────┐
│ │ │
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│published │ │ rejected │ │ modify │
│(已发布) │ │(已拒绝) │ │(待修改) │
└──────────┘ └──────────┘ └──────────┘
🎯 总结
总体评估
| 评估项 |
状态 |
完成度 |
| 开发者-管理员协作 |
✅ 完整 |
100% |
| 用户-开发者-系统协作 |
✅ 完整 |
100% |
| 运营员-管理员协作 |
⚠️ 基本完整 |
80% |
| 企业-子账号协作 |
✅ 完整 |
100% |
| 总体完成度 |
95% |
⚠️ 良好 |
核心亮点
- 完整的审核流程 - 开发者/专家/结算三级审核
- 收益分成自动化 - 用户消费自动分成给开发者
- 子账号管理 - 企业用户可管理子账号Token
- 通知机制 - 审核结果自动通知
待改进项
| 改进项 |
优先级 |
说明 |
| 工单系统 |
中 |
运营员问题上报和跟踪 |
| 邮件通知 |
中 |
关键事件邮件提醒 |
| 实时推送 |
低 |
WebSocket通知 |
最后更新: 2026-02-03
检查人: AI Assistant
版本: 1.0