ai-paas-comparison/docs/07-前后台功能框架.md

AI PaaS 商业平台 — 前后台功能框架

版本: 1.0 | 日期: 2026-06-27 定位: 让任何 AI 使用者都能像用水电一样使用 AI 能力

---

功能全景图

┌─────────────────────────────────────────────────────────────────────┐
│                        QihuAI 平台                                  │
├────────────────────────────┬────────────────────────────────────────┤
│     前台（用户端）          │        后台（管理端）                   │
│     12 个功能板块           │        9 个功能板块                    │
├────────────────────────────┼────────────────────────────────────────┤
│ ① 首页/营销落地页          │ ① 管理仪表盘                          │
│ ② 用户认证中心             │ ② 用户管理                            │
│ ③ 工作台 Dashboard        │ ③ LLM 管理中心 ⭐                     │
│ ④ 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}            ← 用户详情

---

③ LLM 管理中心 ⭐

作用: 平台核心——管理所有 LLM 模型渠道、API Key、定价、健康状态。这是 PaaS 平台的"水电煤"调度中心。

模块	说明
渠道管理	接入的 LLM 提供商列表（DeepSeek/千问/豆包/智谱/元宝/百度/Ollama）
API Key 管理	每个渠道的 API Key 配置（加密存储，支持多 Key 轮询）
模型管理	各渠道下的模型列表（启用/禁用/配置参数）
定价管理	每个模型的计费系数（输入Token价格/输出Token价格）
路由策略	智能路由规则（用户选择/成本优先/延迟优先/负载均衡）
故障转移	主渠道不可用时自动切换备用渠道
健康监控	各渠道实时可用性/延迟/错误率
用量统计	按渠道/模型/时间的调用量和 Token 消耗
配额管理	各渠道的每日/每月调用上限
成本分析	各渠道实际成本 vs 用户付费，利润分析

渠道配置结构:

渠道 (Provider)
├── DeepSeek
│   ├── API Key 1 (主)     → 状态: 正常, 延迟: 230ms
│   ├── API Key 2 (备)     → 状态: 正常, 延迟: 280ms
│   ├── 模型: deepseek-chat     → 定价: 1.0x, 启用
│   ├── 模型: deepseek-reasoner → 定价: 2.0x, 启用
│   └── 配额: 100万Token/天
├── 千问 (Qianwen)
│   ├── API Key 1           → 状态: 正常
│   ├── 模型: qwen-turbo        → 定价: 0.8x, 启用
│   ├── 模型: qwen-plus         → 定价: 1.5x, 启用
│   └── 配额: 50万Token/天
├── 豆包 (Doubao)
│   ├── API Key 1           → 状态: 正常
│   ├── 模型: doubao-pro        → 定价: 1.2x, 启用
│   └── 配额: 80万Token/天
├── 智谱 (Zhipu)
├── 元宝 (Yuanbao)
├── 百度文心 (Wenxin)
└── Ollama (本地)
    ├── 地址: http://localhost:11434
    ├── 模型: qwen2.5:7b        → 定价: 0.1x, 启用
    └── 配额: 无限制

路由策略配置:

默认路由: 用户手动选择模型
成本优先: 自动选择当前最便宜的可用模型
延迟优先: 自动选择响应最快的模型
负载均衡: 在同级别模型间轮询
故障转移: 主模型失败 → 自动切换备用模型

健康检查机制:

定时探活: 每 5 分钟发送测试请求
延迟监控: 记录每次调用的响应时间
错误率统计: 滑动窗口计算错误率
自动摘除: 错误率 > 50% 自动摘除，恢复后自动加回
告警通知: 渠道不可用时通知管理员

页面结构:

/admin/llm                         ← LLM 管理中心
/admin/llm/providers               ← 渠道管理
/admin/llm/providers/{id}          ← 渠道详情/配置
/admin/llm/api-keys                ← API Key 管理
/admin/llm/models                  ← 模型管理
/admin/llm/pricing                 ← 定价管理
/admin/llm/routing                 ← 路由策略
/admin/llm/health                  ← 健康监控
/admin/llm/usage                   ← 用量统计
/admin/llm/cost                    ← 成本分析

---

④ 能力审核中心

作用: 审核开发者发布的能力和技能，确保平台内容质量。

功能	说明
审核列表	待审核的能力/技能列表
审核详情	查看能力信息 / 测试调用 / 安全检查
审批操作	通过/拒绝/要求修改
审核记录	历史审核记录和备注
审核标准	平台审核标准和规范文档
举报处理	用户举报的内容处理

审核流程:

开发者提交 → 自动初审（格式/安全）
→ 人工审核（功能/内容/合规）
→ 通过 → 上架 / 拒绝 → 通知开发者

页面结构:

/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 编辑
活动管理	促销活动/优惠券配置
邮件模板	注册/通知/账单邮件模板

页面结构:

/admin/content               ← 内容运营
/admin/content/announcements ← 公告管理
/admin/content/banners       ← Banner 管理
/admin/content/documents     ← 文档管理

---

⑨ 平台配置中心

作用: 全局系统配置管理。

功能	说明
基础配置	平台名称/Logo/描述/联系信息
订阅配置	套餐价格/额度/分成比例
短信配置	短信宝 API Key/签名/模板
支付配置	支付宝/微信支付 API 配置
安全配置	限流规则/IP 白名单/黑名单
邮件配置	SMTP 服务器配置
存储配置	文件存储（OSS/本地）

页面结构:

/admin/config                ← 平台配置
/admin/config/general        ← 基础配置
/admin/config/subscription   ← 订阅配置
/admin/config/sms            ← 短信配置
/admin/config/payment        ← 支付配置
/admin/config/security       ← 安全配置

---

三、功能板块关系图

前台用户旅程

访客 → 首页(①) → 注册(②) → 工作台(③)
  → 对话实验室(④) 使用LLM
  → 模型广场(⑤) 发现模型
  → 技能市场(⑥) 购买技能
  → Agent工坊(⑦) 创建Agent
  → MCP中心(⑧) 安装工具
  → API控制台(⑨) 程序化接入
  → 账务中心(⑩) 充值订阅
  → 开发者中心(⑪) 发布能力
  → 个人设置(⑫) 管理账户

后台管理闭环

管理员 → 仪表盘(①) 全局概览
  → 用户管理(②) 管理用户
  → LLM管理(③) ⭐ 核心：渠道/模型/定价/健康
  → 能力审核(④) 审核内容
  → 财务管理(⑤) 管理资金
  → 技能市场(⑥) 运营市场
  → 系统监控(⑦) 保障稳定
  → 内容运营(⑧) 运营推广
  → 平台配置(⑨) 系统配置

数据流关系

用户调用LLM → NEW API路由 → 选择渠道/模型 → LLM推理返回
  → 用量上报Kafka → 计费扣费 → 交易记录

LLM管理中心: 配置渠道/Key/定价 → 同步到NEW API → 健康监控反馈

开发者发布能力 → 审核通过 → 上架市场 → 用户购买 → 分成结算
用户订阅 → 权限开放 → 创建/发布能力 → 欠费保护 → 已发布能力保持在线

---

四、PaaS 平台必备能力清单

能力	说明	对应功能
LLM 管理 ⭐	渠道/模型/Key/定价/路由/健康	后台③
多模型接入	统一接口调用多家 LLM	前台前台④⑤⑨
API 兼容	OpenAI 兼容格式	前台⑨
按量计费	Token 级别精确计费	前台⑩
订阅制	月费套餐	前台⑩
能力注册	标准化能力注册/发现	前台⑪
技能市场	生态交易平台	前台⑥
Agent 编排	可视化工作流	前台⑦
MCP 集成	工具扩展协议	前台⑧
开发者生态	SDK/文档/示例	前台⑨
开放 API	独立应用接入	前台⑨
用户数据隔离	用户数据安全	全局
审计日志	操作可追溯	前台⑫/后台⑦
SLA 保障	高可用/故障转移	后台③⑦
安全合规	实名认证/数据加密	前台②
运维监控	全链路监控	后台⑦

---

文档结束