diff --git a/docs/07-前后台功能框架.md b/docs/07-前后台功能框架.md new file mode 100644 index 0000000..04c1ff3 --- /dev/null +++ b/docs/07-前后台功能框架.md @@ -0,0 +1,669 @@ +# AI PaaS 商业平台 — 前后台功能框架 + +> 版本: 1.0 | 日期: 2026-06-27 +> 定位: 让任何 AI 使用者都能像用水电一样使用 AI 能力 + +--- + +## 功能全景图 + +``` +┌─────────────────────────────────────────────────────────────────────┐ +│ QihuAI 平台 │ +├────────────────────────────┬────────────────────────────────────────┤ +│ 前台（用户端） │ 后台（管理端） │ +│ 12 个功能板块 │ 8 个功能板块 │ +├────────────────────────────┼────────────────────────────────────────┤ +│ ① 首页/营销落地页 │ ① 管理仪表盘 │ +│ ② 用户认证中心 │ ② 用户管理 │ +│ ③ 工作台 Dashboard │ ③ 能力审核中心 │ +│ ④ LLM 对话实验室 │ ④ 财务管理中心 │ +│ ⑤ 模型广场 │ ⑤ 技能市场管理 │ +│ ⑥ 技能市场 │ ⑥ 系统运维监控 │ +│ ⑦ Agent 工坊 │ ⑦ 内容运营管理 │ +│ ⑧ MCP 工具中心 │ ⑧ 平台配置中心 │ +│ ⑨ API 开发者控制台 │ │ +│ ⑩ 账务中心 │ │ +│ ⑪ 开发者中心 │ │ +│ ⑫ 个人设置 │ │ +└────────────────────────────┴────────────────────────────────────────┘ +``` + +--- + +## 一、前台功能板块（用户端） + +### ① 首页 / 营销落地页 + +**作用**: 平台第一印象，转化访客为注册用户。 + +| 模块 | 说明 | +|------|------| +| Hero Banner | 一句话定位 + CTA 注册按钮 | +| 核心卖点 | 3-4 个核心价值点（注册即用/按量付费/模型丰富/能力市场） | +| 模型展示 | 支持的 LLM 列表 + 价格对比 | +| 使用场景 | 典型用户场景（开发者/创作者/企业） | +| 定价方案 | 订阅套餐对比表（Free/开发者/专业/旗舰） | +| 开发者生态 | 技能市场精选 + 开发者收入故事 | +| 数据看板 | 平台实时数据（注册用户/调用次数/技能数量） | +| 文档入口 | 快速开始/API 文档/SDK 下载 | + +**页面结构**: +``` +/ ← 首页 +/pricing ← 定价页 +/docs ← 文档中心 +/docs/quickstart ← 快速开始 +/docs/api ← API 参考 +/docs/sdk ← SDK 下载 +``` + +--- + +### ② 用户认证中心 + +**作用**: 注册、登录、实名认证，用户身份管理。 + +| 功能 | 说明 | +|------|------| +| 手机号注册 | 手机号 + 短信验证码（短信宝） | +| 邮箱注册 | 邮箱 + 密码（备用） | +| 微信扫码登录 | Casdoor SSO 对接微信 | +| 手机号登录 | 手机号 + 短信验证码 | +| 邮箱登录 | 邮箱 + 密码 | +| 忘记密码 | 邮箱重置密码 | +| 实名认证 | 姓名 + 身份证号 → 阿里云实名认证 API | +| 图形验证码 | 防短信轰炸，发送验证码前必须验证 | + +**用户状态机**: +``` +注册 → 未认证用户 + → 实名认证通过 → 认证用户 + → 订阅月费 → 订阅用户 + → 欠费 → 保留已发布能力，限制新创建 +``` + +**页面结构**: +``` +/auth/register ← 注册 +/auth/login ← 登录 +/auth/forgot-password ← 忘记密码 +/auth/verify ← 实名认证 +``` + +--- + +### ③ 工作台 Dashboard + +**作用**: 用户登录后的主界面，一眼掌握全局。 + +| 模块 | 说明 | +|------|------| +| 快速开始 | 引导新用户完成首次调用（3步：注册→获取API Key→调用） | +| 余额概览 | Credit 余额 + 订阅状态 + 本月用量 | +| 用量趋势 | 近7天/30天 Token 用量折线图 | +| 最近调用 | 最近10条 LLM 调用记录（模型/Token/费用） | +| 快捷入口 | 对话实验室 / 技能市场 / API 文档 | +| 通知中心 | 系统公告 / 订阅到期提醒 / 费用预警 | +| 开发者卡片 | 发布的技能数 / 总收入 / 待提现（订阅用户） | + +**页面结构**: +``` +/dashboard ← 工作台首页 +/dashboard/usage ← 用量详情 +/dashboard/billing ← 账务概览 +/dashboard/notifications ← 通知中心 +``` + +--- + +### ④ LLM 对话实验室 + +**作用**: 在线体验和测试各种 LLM 模型，是平台核心功能。 + +| 功能 | 说明 | +|------|------| +| 多模型切换 | 下拉选择模型（DeepSeek/千问/豆包/智谱/元宝/百度） | +| 对话界面 | 类 ChatGPT 的对话 UI | +| 流式输出 | SSE 实时流式响应 | +| 系统提示词 | 设置 System Prompt | +| 参数调节 | 温度 / Top-P / 最大 Token / 停止词 | +| 对话管理 | 新建/历史对话列表/删除对话 | +| 导出对话 | 导出为 Markdown / JSON | +| 对话分享 | 生成分享链接（可选） | +| 用量显示 | 每次对话显示 Token 消耗和费用 | +| 模型对比 | 同一问题多模型同时回答，对比效果 | + +**页面结构**: +``` +/playground ← 对话实验室 +/playground/new ← 新建对话 +/playground/history ← 历史对话 +/playground/compare ← 模型对比 +``` + +--- + +### ⑤ 模型广场 + +**作用**: 展示所有可用模型，帮助用户选择合适的模型。 + +| 功能 | 说明 | +|------|------| +| 模型列表 | 所有可用模型卡片展示 | +| 分类筛选 | 按提供商/能力/价格筛选 | +| 模型详情 | 能力介绍 / 上下文长度 / 价格 / 评分 | +| 能力雷达图 | 推理/写作/代码/多语言/创意 五维评分 | +| 价格对比 | 各模型价格对比表 | +| 快速试用 | 点击直接跳转对话实验室 | +| 模型评测 | 用户评分和评价 | + +**模型分类**: +``` +按提供商: DeepSeek / 千问 / 豆包 / 智谱 / 元宝 / 百度 / Ollama(本地) +按能力: 通用对话 / 代码生成 / 长文本 / 多模态 / 推理增强 +按价格: 免费 / 经济 / 标准 / 高端 +``` + +**页面结构**: +``` +/models ← 模型广场 +/models/{id} ← 模型详情 +``` + +--- + +### ⑥ 技能市场 + +**作用**: AI 技能交易平台，用户可浏览、购买、使用开发者发布的技能。 + +| 功能 | 说明 | +|------|------| +| 技能浏览 | 卡片列表，支持搜索/分类/排序 | +| 技能详情 | 描述 / 使用方法 / 价格 / 评分 / 使用量 | +| 一键调用 | 购买后直接在平台内使用 | +| 购买流程 | 确认 → 扣费 → 授权 → 使用 | +| 评价系统 | 1-5 星评分 + 文字评价 | +| 收藏夹 | 收藏感兴趣的技能 | +| 分类体系 | 办公效率 / 内容创作 / 数据分析 / 开发工具 / 生活服务 | + +**计费模式**: +``` +按次调用: 每次使用扣 X Credit +按Token: 按 Token 用量计费 +订阅制: 包月使用 +免费: 完全免费 +``` + +**页面结构**: +``` +/skills ← 技能市场 +/skills/{id} ← 技能详情 +/skills/purchased ← 已购技能 +/skills/category/{cat} ← 分类浏览 +``` + +--- + +### ⑦ Agent 工坊 + +**作用**: 可视化创建和管理 AI Agent，是 PaaS 平台的核心能力。 + +| 功能 | 说明 | +|------|------| +| Agent 列表 | 我创建的 / 我使用的 / 公开的 | +| 可视化编排 | 拖拽式工作流编辑器（基于 LangFlow） | +| 预置模板 | 常用 Agent 模板（客服/翻译/摘要/代码助手） | +| 工具绑定 | 绑定 MCP 工具 / API 接口 / 自定义函数 | +| 模型配置 | 为 Agent 选择底层 LLM 模型 | +| 测试调试 | 在线测试 Agent 效果 | +| 发布上线 | 发布到市场或私有使用 | +| API 导出 | 生成独立的 API 端点 | +| 版本管理 | 多版本管理，支持回滚 | + +**Agent 类型**: +``` +对话型 Agent: 多轮对话，上下文记忆 +工作流 Agent: 多步骤任务编排 +工具型 Agent: 调用外部工具完成任务 +混合型 Agent: 对话 + 工具 + 工作流 +``` + +**页面结构**: +``` +/agents ← Agent 工坊 +/agents/new ← 创建 Agent +/agents/{id} ← Agent 详情/编辑 +/agents/{id}/test ← 测试调试 +/agents/templates ← 模板库 +``` + +--- + +### ⑧ MCP 工具中心 + +**作用**: 管理和使用 Model Context Protocol 工具，扩展 AI 能力边界。 + +| 功能 | 说明 | +|------|------| +| 工具列表 | 已安装的 MCP Server 列表 | +| 工具市场 | 浏览和安装社区 MCP Server | +| 工具详情 | 功能说明 / 参数定义 / 使用示例 | +| 安装管理 | 一键安装/卸载/更新 | +| 权限管理 | 控制哪些 Agent 可以使用哪些工具 | +| 调用日志 | 工具调用记录和审计 | + +**预置 MCP Server**: +``` +文件系统: 读写本地文件 +网页抓取: 抓取网页内容 +代码执行: 安全沙箱执行代码 +数据库: SQL 查询 +搜索引擎: 联网搜索 +图像生成: AI 绘图 +``` + +**页面结构**: +``` +/mcp ← MCP 工具中心 +/mcp/marketplace ← 工具市场 +/mcp/installed ← 已安装工具 +/mcp/{id} ← 工具详情 +``` + +--- + +### ⑨ API 开发者控制台 + +**作用**: 程序化接入平台，开发者的核心工作台。 + +| 功能 | 说明 | +|------|------| +| API Key 管理 | 创建/查看/删除 API Key | +| API 文档 | OpenAI 兼容格式的完整 API 文档 | +| 代码示例 | Python/cURL/Node.js/Go 调用示例 | +| 调试工具 | 在线 API 调试器（类似 Postman） | +| 调用统计 | 按时间/模型/接口的调用统计 | +| Webhook 配置 | 调用完成通知 | +| SDK 下载 | 官方 SDK（Python/Node.js） | + +**API 接口**: +``` +POST /v1/chat/completions ← Chat Completion (OpenAI 兼容) +GET /v1/models ← 可用模型列表 +POST /v1/embeddings ← 文本嵌入 +GET /v1/usage ← 用量查询 +``` + +**页面结构**: +``` +/developer ← 开发者控制台 +/developer/api-keys ← API Key 管理 +/developer/docs ← API 文档 +/developer/playground ← 在线调试 +/developer/statistics ← 调用统计 +/developer/sdk ← SDK 下载 +``` + +--- + +### ⑩ 账务中心 + +**作用**: 订阅管理、充值、账单、交易记录。 + +| 功能 | 说明 | +|------|------| +| 订阅管理 | 当前套餐 / 升级降级 / 取消订阅 | +| 充值中心 | Token 包购买（¥10/¥50/¥100） | +| 余额概览 | 当前余额 / 本月已用 / 本月包含 | +| 交易流水 | 完整交易记录（按时间/类型筛选） | +| 发票管理 | 申请发票（电子发票） | +| 支付方式 | 支付宝 / 微信支付 | +| 费用预警 | 余额不足提醒 / 用量预警 | + +**订阅套餐**: +``` +免费: ¥0/月 50次/天 LLM调用 +开发者: ¥29/月 50万Token/月 + 创建/发布3个能力 +专业版: ¥99/月 200万Token/月 + 创建/发布10个能力 +旗舰版: ¥299/月 1000万Token/月 + 无限制 +``` + +**页面结构**: +``` +/billing ← 账务中心 +/billing/subscription ← 订阅管理 +/billing/topup ← 充值 +/billing/transactions ← 交易流水 +/billing/invoice ← 发票 +``` + +--- + +### ⑪ 开发者中心 + +**作用**: 能力/技能的创建、发布、管理、变现。 + +| 功能 | 说明 | +|------|------| +| 开发者仪表盘 | 发布数 / 使用量 / 收入概览 | +| 能力创建 | 填写名称/描述/类型/端点/定价 | +| 能力管理 | 编辑/下架/版本管理/审核状态 | +| 技能发布 | 发布到技能市场 | +| 技能管理 | 定价/描述/文档/版本 | +| 收益统计 | 按天/周/月的收入趋势 | +| 提现管理 | 申请提现 / 提现记录 | +| 开发者文档 | 如何发布能力/技能的指南 | + +**发布流程**: +``` +创建能力 → 填写信息 → 提交审核 +→ 管理员审核（1-3工作日） +→ 审核通过 → 上架市场 +→ 用户购买/使用 → 获得分成 +``` + +**页面结构**: +``` +/developer-center ← 开发者中心 +/developer-center/dashboard ← 开发者仪表盘 +/developer-center/capabilities/create ← 创建能力 +/developer-center/capabilities ← 能力管理 +/developer-center/skills/create ← 发布技能 +/developer-center/skills ← 技能管理 +/developer-center/revenue ← 收益统计 +/developer-center/payout ← 提现管理 +``` + +--- + +### ⑫ 个人设置 + +**作用**: 用户个人信息、安全、偏好管理。 + +| 功能 | 说明 | +|------|------| +| 个人信息 | 头像 / 昵称 / 手机号 / 邮箱 | +| 安全设置 | 修改密码 / 绑定手机 / 绑定邮箱 | +| 实名认证 | 查看认证状态 / 重新认证 | +| 偏好设置 | 默认模型 / 界面语言 / 主题 | +| 通知设置 | 邮件通知 / 短信通知 / 站内通知 | +| 数据管理 | 导出数据 / 注销账号 | + +**页面结构**: +``` +/settings ← 个人设置 +/settings/profile ← 个人信息 +/settings/security ← 安全设置 +/settings/verify ← 实名认证 +/settings/preferences ← 偏好设置 +/settings/notifications ← 通知设置 +``` + +--- + +## 二、后台功能板块（管理端） + +### ① 管理仪表盘 + +**作用**: 平台运营全局概览，管理员第一入口。 + +| 指标 | 说明 | +|------|------| +| 用户数据 | 今日新增 / 总用户 / 活跃用户 / 订阅用户 | +| 调用数据 | 今日调用次数 / 总 Token / 调用趋势图 | +| 财务数据 | 今日收入 / 本月收入 / 总收入 / 待提现 | +| 能力数据 | 总能力数 / 待审核 / 已上架 / 技能总数 | +| 系统状态 | API 响应时间 / 错误率 / 各服务健康状态 | +| 实时动态 | 最新注册 / 最新调用 / 最新交易 / 异常告警 | + +**页面结构**: +``` +/admin ← 管理仪表盘 +/admin/realtime ← 实时监控 +``` + +--- + +### ② 用户管理 + +**作用**: 管理所有注册用户。 + +| 功能 | 说明 | +|------|------| +| 用户列表 | 分页/搜索/筛选（状态/认证/订阅） | +| 用户详情 | 个人信息 / 认证状态 / 订阅信息 / 用量 / 交易 | +| 状态管理 | 封禁/解封/删除 | +| 角色管理 | 普通用户/开发者/管理员 | +| 实名审核 | 查看实名认证记录 | +| 用户画像 | 使用行为分析 / 活跃度评分 | + +**页面结构**: +``` +/admin/users ← 用户列表 +/admin/users/{id} ← 用户详情 +``` + +--- + +### ③ 能力审核中心 + +**作用**: 审核开发者发布的能力和技能，确保平台内容质量。 + +| 功能 | 说明 | +|------|------| +| 审核列表 | 待审核的能力/技能列表 | +| 审核详情 | 查看能力信息 / 测试调用 / 安全检查 | +| 审批操作 | 通过/拒绝/要求修改 | +| 审核记录 | 历史审核记录和备注 | +| 审核标准 | 平台审核标准和规范文档 | +| 举报处理 | 用户举报的内容处理 | + +**审核流程**: +``` +开发者提交 → 自动初审（格式/安全） +→ 人工审核（功能/内容/合规） +→ 通过 → 上架 / 拒绝 → 通知开发者 +``` + +**页面结构**: +``` +/admin/review ← 审核中心 +/admin/review/pending ← 待审核列表 +/admin/review/{id} ← 审核详情 +/admin/review/history ← 审核历史 +``` + +--- + +### ④ 财务管理中心 + +**作用**: 平台财务全局管理。 + +| 功能 | 说明 | +|------|------| +| 收入概览 | 日/周/月收入趋势 / 收入构成 | +| 订阅统计 | 各套餐订阅人数 / 续费率 / 流失率 | +| 交易流水 | 全平台交易记录（可导出） | +| 提现审核 | 开发者提现申请审核 | +| 分成管理 | 平台/开发者分成比例配置 | +| 财务报表 | 月度/年度财务报表生成 | +| 对账管理 | 支付渠道对账 / 异常交易处理 | + +**页面结构**: +``` +/admin/finance ← 财务管理 +/admin/finance/overview ← 收入概览 +/admin/finance/transactions ← 交易流水 +/admin/finance/payouts ← 提现审核 +/admin/finance/reports ← 财务报表 +``` + +--- + +### ⑤ 技能市场管理 + +**作用**: 管理技能市场的运营。 + +| 功能 | 说明 | +|------|------| +| 市场概览 | 技能数量 / 交易量 / 热门技能 | +| 分类管理 | 创建/编辑/删除技能分类 | +| 推荐管理 | 首页推荐 / 精选技能配置 | +| 评价管理 | 查看/删除违规评价 | +| 举报处理 | 技能举报处理 | +| 数据分析 | 技能使用趋势 / 热门搜索 / 转化率 | + +**页面结构**: +``` +/admin/skills ← 技能市场管理 +/admin/skills/overview ← 市场概览 +/admin/skills/categories ← 分类管理 +/admin/skills/featured ← 推荐管理 +/admin/skills/reviews ← 评价管理 +``` + +--- + +### ⑥ 系统运维监控 + +**作用**: 系统健康监控和运维管理。 + +| 功能 | 说明 | +|------|------| +| 服务状态 | 各微服务健康状态（API Gateway/Billing/Registry...） | +| 性能监控 | 响应时间 / QPS / 错误率 / CPU/内存 | +| 日志管理 | 结构化日志查询 / 错误日志追踪 | +| 告警配置 | 阈值告警 / 通知渠道（邮件/短信/钉钉） | +| 数据库监控 | 连接数 / 慢查询 / 存储空间 | +| Redis 监控 | 内存 / 连接数 / 命中率 | +| Kafka 监控 | 消费延迟 / 消息积压 | +| 安全审计 | 登录日志 / 敏感操作日志 | + +**页面结构**: +``` +/admin/system ← 系统运维 +/admin/system/services ← 服务状态 +/admin/system/performance ← 性能监控 +/admin/system/logs ← 日志管理 +/admin/system/alerts ← 告警配置 +/admin/system/security ← 安全审计 +``` + +--- + +### ⑦ 内容运营管理 + +**作用**: 平台内容和运营活动管理。 + +| 功能 | 说明 | +|------|------| +| 公告管理 | 发布/编辑/删除系统公告 | +| Banner 管理 | 首页轮播图配置 | +| 文档管理 | 帮助文档/FAQ 编辑 | +| 活动管理 | 促销活动/优惠券配置 | +| 模型管理 | 新增/下架/配置 LLM 模型 | +| 邮件模板 | 注册/通知/账单邮件模板 | + +**页面结构**: +``` +/admin/content ← 内容运营 +/admin/content/announcements ← 公告管理 +/admin/content/banners ← Banner 管理 +/admin/content/documents ← 文档管理 +/admin/content/models ← 模型管理 +``` + +--- + +### ⑧ 平台配置中心 + +**作用**: 全局系统配置管理。 + +| 功能 | 说明 | +|------|------| +| 基础配置 | 平台名称/Logo/描述/联系信息 | +| 订阅配置 | 套餐价格/额度/分成比例 | +| 短信配置 | 短信宝 API Key/签名/模板 | +| 支付配置 | 支付宝/微信支付 API 配置 | +| LLM 配置 | 各模型 API Key/渠道管理 | +| 安全配置 | 限流规则/IP 白名单/黑名单 | +| 邮件配置 | SMTP 服务器配置 | +| 存储配置 | 文件存储（OSS/本地） | + +**页面结构**: +``` +/admin/config ← 平台配置 +/admin/config/general ← 基础配置 +/admin/config/subscription ← 订阅配置 +/admin/config/sms ← 短信配置 +/admin/config/payment ← 支付配置 +/admin/config/llm ← LLM 配置 +/admin/config/security ← 安全配置 +``` + +--- + +## 三、功能板块关系图 + +### 前台用户旅程 + +``` +访客 → 首页(①) → 注册(②) → 工作台(③) + → 对话实验室(④) 使用LLM + → 模型广场(⑤) 发现模型 + → 技能市场(⑥) 购买技能 + → Agent工坊(⑦) 创建Agent + → MCP中心(⑧) 安装工具 + → API控制台(⑨) 程序化接入 + → 账务中心(⑩) 充值订阅 + → 开发者中心(⑪) 发布能力 + → 个人设置(⑫) 管理账户 +``` + +### 后台管理闭环 + +``` +管理员 → 仪表盘(①) 全局概览 + → 用户管理(②) 管理用户 + → 能力审核(③) 审核内容 + → 财务管理(④) 管理资金 + → 技能市场(⑤) 运营市场 + → 系统监控(⑥) 保障稳定 + → 内容运营(⑦) 运营推广 + → 平台配置(⑧) 系统配置 +``` + +### 数据流关系 + +``` +用户调用LLM → 用量上报Kafka → 计费扣费 → 交易记录 +开发者发布能力 → 审核通过 → 上架市场 → 用户购买 → 分成结算 +用户订阅 → 权限开放 → 创建/发布能力 → 欠费保护 → 已发布能力保持在线 +``` + +--- + +## 四、PaaS 平台必备能力清单 + +| 能力 | 说明 | 对应功能 | +|------|------|---------| +| **多模型接入** | 统一接口调用多家 LLM | ④⑤⑨ | +| **API 兼容** | OpenAI 兼容格式 | ⑨ | +| **按量计费** | Token 级别精确计费 | ⑩ | +| **订阅制** | 月费套餐 | ⑩ | +| **能力注册** | 标准化能力注册/发现 | ⑪ | +| **技能市场** | 生态交易平台 | ⑥ | +| **Agent 编排** | 可视化工作流 | ⑦ | +| **MCP 集成** | 工具扩展协议 | ⑧ | +| **开发者生态** | SDK/文档/示例 | ⑨ | +| **开放 API** | 独立应用接入 | ⑨ | +| **多租户隔离** | 用户数据隔离 | 全局 | +| **审计日志** | 操作可追溯 | ⑥⑫ | +| **SLA 保障** | 高可用/故障转移 | ⑥ | +| **安全合规** | 实名认证/数据加密 | ② | +| **运维监控** | 全链路监控 | ⑥ | + +--- + +*文档结束*