初始提交: Qihu-AIFlow v2.0.1 完整项目
- 前端 React+TypeScript (源码+构建产物) - 后端 Python FastAPI - 数据库迁移 001-015 - Docker部署配置 - 微信ClawBot API频道绑定 - 项目文档 README.md
This commit is contained in:
commit
78ff261b5a
199 files changed
+69126
No files matched your search
+548
@@ -0,0 +1,548 @@
|
||||
# AI智能自动化PaaS平台 - 产品需求文档(PRD)
|
||||
|
||||
---
|
||||
|
||||
## 1. 概述(Summary)
|
||||
|
||||
本文档为AI智能自动化PaaS平台(SaaS+PaaS混合架构)的完整产品需求文档。平台面向个人用户与小微企业,提供一站式AI自动化SOP能力,用户无需编码即可落地全流程AI自动化业务。平台商业模式为会员订阅+单点增值付费双营收体系,前台对标QwenPaw交互体验,后台提供完整的运营管理与商业化配置能力。
|
||||
|
||||
---
|
||||
|
||||
## 2. 联系人(Contacts)
|
||||
|
||||
| 姓名 | 角色 | 备注 |
|
||||
|------|------|------|
|
||||
| 项目负责人 | Team Lead | 项目整体规划与协调决策 |
|
||||
| 产品经理 | Product Manager | PRD撰写、需求分析与产品设计 |
|
||||
| UI设计师 | UI Designer | 前台+后台UI视觉与交互设计 |
|
||||
| 开发工程师 | Developer | 全栈系统架构设计与代码实现 |
|
||||
| 测试工程师 | QA Engineer | 功能测试、安全测试、自动化测试 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 背景(Background)
|
||||
|
||||
### 3.1 业务背景
|
||||
|
||||
当前AI工具市场存在以下痛点:
|
||||
- 个人用户难以将AI能力直接转化为实际商业价值
|
||||
- 缺乏面向非技术用户的AI自动化工作流搭建工具
|
||||
- 市面AI平台缺乏完整的商业化闭环(会员+增值+交易市场)
|
||||
- 小微企业在财务、人事、运营、电商、自媒体等方面急需可落地的标准化AI SOP
|
||||
|
||||
### 3.2 时机分析
|
||||
|
||||
- 大模型能力日趋成熟,API调用成本持续下降,为PaaS化封装创造可行条件
|
||||
- 个人副业经济与小企业数字化转型需求爆发,目标用户群体广泛
|
||||
- 竞品QwenPaw已验证AI聊天+频道的交互模式,但缺乏完整的商业化生态
|
||||
|
||||
### 3.3 技术依托
|
||||
|
||||
- 深度复用开源项目BuildingAI的成熟底层架构与能力模块
|
||||
- 关系型数据库(MySQL)+ 向量数据库(RAGFlow)双库部署
|
||||
- 基于Codpard平台全链路AI开发能力进行云端协作
|
||||
|
||||
---
|
||||
|
||||
## 4. 目标与关键成果(Objective & Key Results)
|
||||
|
||||
### 4.1 产品目标
|
||||
|
||||
打造一套**私有化部署、面向个人及小微企业的AI自动化SOP一站式PaaS平台**,提供从AI对话、知识管理、技能市场到Token计费、会员订阅的完整闭环体验。
|
||||
|
||||
### 4.2 关键成果(OKR)
|
||||
|
||||
| 编号 | 关键结果 | 衡量标准 |
|
||||
|------|----------|----------|
|
||||
| KR1 | 前台完成8大功能板块上线 | 所有功能可正常访问,交互对齐QwenPaw |
|
||||
| KR2 | 后台完成7大管理模块上线 | 管理员可完整配置运营、计费、风控 |
|
||||
| KR3 | 会员订阅+增值付费双营收体系可用 | 微信支付/支付宝全链路调通 |
|
||||
| KR4 | 用户数据物理隔离 | 跨用户聊天、知识库、RAG数据零泄露 |
|
||||
| KR5 | 全系统操作日志不可删除、完整可追踪 | 日志查询与导出功能可用 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 市场细分(Market Segments)
|
||||
|
||||
### 5.1 目标用户群体
|
||||
|
||||
| 用户类型 | 核心诉求 | 典型场景 |
|
||||
|----------|----------|----------|
|
||||
| **职场个人用户** | 提升工作效率 | 文档处理、数据分析、邮件撰写、PPT生成 |
|
||||
| **副业创收个人** | AI自动化创收 | 自媒体运营、电商店铺管理、内容创作 |
|
||||
| **小微企业商家** | 业务增长赋能 | 财务自动化、人事管理、客户服务SOP |
|
||||
| **全权AI托管需求者** | 业务流程外包 | 全业务AI托管、自动化报表、智能客服 |
|
||||
|
||||
### 5.2 用户约束
|
||||
|
||||
- 无编程基础,需要零代码操作体验
|
||||
- 对AI能力有需求但不愿直接对接大模型API
|
||||
- 对价格敏感,需要灵活付费(月付/季付/年付/单次购买)
|
||||
- 数据安全意识日益增强,需保障私密性
|
||||
|
||||
---
|
||||
|
||||
## 6. 价值主张(Value Propositions)
|
||||
|
||||
### 6.1 客户需求满足
|
||||
|
||||
| 客户需求 | 平台方案 |
|
||||
|----------|----------|
|
||||
| 快速落地AI自动化 | 预置标准化SOP模板,一键部署AI工作流 |
|
||||
| 自建知识库 | 独立RAGFlow向量空间,文档一键切片向量化 |
|
||||
| 交易变现 | 应用市场支持用户上架自研应用并自主定价 |
|
||||
| 费用透明可控 | Token驾驶舱实时展示消耗、自动预警、一键充值 |
|
||||
| 数据安全可控 | 用户间完全物理隔离,逻辑层+数据库双层隔离 |
|
||||
|
||||
### 6.2 差异化竞争优势
|
||||
|
||||
- **对标QwenPaw但商业化更完整**:在聊天+频道基础上,增加Token驾驶舱、应用市场、付费中心
|
||||
- **双营收体系**:会员订阅+单点增值付费可叠加,用户灵活选择
|
||||
- **用户数据物理隔离**:RAG向量空间每个用户独立空间,杜绝交叉访问
|
||||
- **开放的应用市场**:用户可自主发布并售卖Skills/Agent/MCP应用
|
||||
- **完整后台运营**:管理员可自主管理模型、定价、会员、风控全线
|
||||
|
||||
---
|
||||
|
||||
## 7. 解决方案(Solution)
|
||||
|
||||
### 7.1 用户流程图(User Flow)
|
||||
|
||||
#### 前台用户主流程
|
||||
|
||||
```
|
||||
用户注册/登录
|
||||
├── AI聊天(选模型→对话→挂载知识库/Agent/技能)
|
||||
├── 频道(创建频道→配置Agent/知识库→邀请协作)
|
||||
├── 知识库(上传文档→切片向量化→目录管理→挂载至对话/频道)
|
||||
├── 应用市场(浏览→查看详情→购买/安装→使用)
|
||||
├── Token驾驶舱(查看总览→排名→明细→导出→充值)
|
||||
├── 付费中心(选择会员→支付→查看订单/优惠券)
|
||||
├── 个人中心(安全设置→API密钥→订单/会员/已购管理)
|
||||
└── 消息通知(公告/提醒/续费/订单通知)
|
||||
```
|
||||
|
||||
#### 后台管理主流程
|
||||
|
||||
```
|
||||
管理员登录后台
|
||||
├── 大模型库管理(接入模型→配置API密钥→设置计费单价→开关状态)
|
||||
├── 网站基础设置(LOGO/名称/公告/备案号→邮件/短信配置)
|
||||
├── 支付渠道配置(微信支付→支付宝→订单对账/退款)
|
||||
├── 增值服务管理(上架/编辑/下架→定制服务→订单管理)
|
||||
├── 会员订阅体系(创建等级→配置价格→配置权益→自动降级)
|
||||
├── 应用市场审核(审核应用→管理优惠券→官方应用上下架)
|
||||
└── 日志与风控(操作日志→调用日志→付费日志→封禁/限流)
|
||||
```
|
||||
|
||||
### 7.2 核心功能详细说明
|
||||
|
||||
---
|
||||
|
||||
#### 模块一:AI聊天板块
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **多模型切换** | 支持在对话中切换平台接入的所有大模型,模型列表由后台动态配置 |
|
||||
| **多轮上下文对话** | 支持连续多轮对话,保持完整上下文;支持单轮对话独立提问 |
|
||||
| **对话记录保存** | 所有对话自动保存至云端,数据仅归属当前用户,其他用户完全不可见 |
|
||||
| **对话管理** | 支持对话重命名、对话删除、对话归档、上下文一键清空 |
|
||||
| **增强对话** | 支持对话时挂载个人知识库、挂载第三方Agent(含已购应用)、挂载技能工具 |
|
||||
| **对话列表** | 左侧对话历史列表,支持搜索、筛选 |
|
||||
|
||||
#### 模块二:频道板块
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **自建频道** | 用户可创建专属AI协作频道,频道内绑定固定Agent、固定技能、专属知识库 |
|
||||
| **多人协作** | 频道支持多人协作对话,用户可自主邀请好友进入,平台不公开频道 |
|
||||
| **数据隔离** | 频道内所有会话、配置数据独立隔离,不同频道数据完全互不互通 |
|
||||
| **频道管理** | 支持频道命名、成员管理、配置修改、解散频道 |
|
||||
|
||||
#### 模块三:个人知识库 & 知识图谱板块(RAGFlow)
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **独立向量空间** | 每位注册用户分配完全独立的RAGFlow向量空间,物理隔离 |
|
||||
| **文档上传与切片** | 支持上传文档(PDF/Word/Excel/PPT/TXT)、网页URL、本地文件,一键切片向量化 |
|
||||
| **知识图谱构建** | 自动构建私有化个人知识图谱,支持语义检索与问答溯源 |
|
||||
| **目录管理** | 支持知识库拆分目录层级管理,方便分类组织 |
|
||||
| **权限控制** | 知识库默认仅自己可见 |
|
||||
| **知识库挂载** | 支持将知识库挂载至AI对话、频道、Agent中,增强回答准确性 |
|
||||
| **问答溯源** | 知识库问答时展示引用原文与来源文档路径 |
|
||||
|
||||
#### 模块四:应用市场板块
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **三大分类** | Skills工具、智能Agent、MCP协议应用,固定三类不可变更 |
|
||||
| **应用来源** | ①平台官方免费上架应用;②普通用户自主上传自研应用,可商业化售卖 |
|
||||
| **发布配置** | 发布者设置固定单次购买价格;选择是否参与平台统一优惠券满减活动 |
|
||||
| **应用权限** | 购买后仅本人账号可用,不可转租、不可共享 |
|
||||
| **会员权益** | 会员用户可免费使用标注为"会员专属"的应用 |
|
||||
| **评分系统** | 用户可对已购应用进行评分评价 |
|
||||
| **应用详情** | 详情介绍页:应用说明、使用教程、评分展示、价格信息 |
|
||||
| **一键安装** | 购买后一键安装到个人应用列表 |
|
||||
| **已购管理** | 个人中心查看、管理所有已购应用 |
|
||||
|
||||
#### 模块五:Token消耗驾驶舱(数据可视化面板)
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **核心总览** | 累计总消耗Token、当前使用中的应用数量(实时统计) |
|
||||
| **消耗排名** | 个人账号消耗量第一的大模型、消耗量TOP3应用清单 |
|
||||
| **明细账单** | 完整Token消耗明细表,按时间/模型/应用分类展示每一笔调用消耗与扣费金额 |
|
||||
| **余额预警** | Token余额不足时自动弹窗提醒,提示一键充值 |
|
||||
| **数据导出** | 支持Token消耗明细导出(CSV/Excel格式) |
|
||||
|
||||
#### 模块六:订阅付费中心
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **会员周期性订阅** | 按月订阅、按季度订阅、按年度订阅三档时长,不同等级匹配不同权益 |
|
||||
| **会员权益** | 免费模型额度、免费应用使用权限、专属模型使用权 |
|
||||
| **单独增值服务** | 不依赖会员,用户可单独按需购买一次性增值服务 |
|
||||
| **支付方式** | 支持微信支付、支付宝支付 |
|
||||
| **订单管理** | 所有订单全程可查,支持开具电子凭证 |
|
||||
| **优惠券** | 支持平台发放优惠券,用户下单时可使用 |
|
||||
|
||||
#### 模块七:个人中心
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **账号安全** | 密码修改、绑定手机/邮箱、登录日志查看 |
|
||||
| **我的订单** | 查看全部订单(会员订单+增值服务订单),按状态筛选 |
|
||||
| **我的会员** | 查看当前会员等级、到期时间、自动续费开关 |
|
||||
| **我的优惠券** | 查看可用优惠券、已用优惠券、过期优惠券 |
|
||||
| **我的已购应用** | 查看和管理所有已购Skills/Agent/MCP应用 |
|
||||
| **API密钥管理** | 生成/管理个人API密钥,支持第三方程序对接平台模型能力 |
|
||||
|
||||
#### 模块八:消息通知中心
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **平台公告** | 接收管理员发布的全平台公告 |
|
||||
| **会员提醒** | 会员到期提醒、续费成功通知 |
|
||||
| **余额提醒** | Token余量不足提醒 |
|
||||
| **应用通知** | 已购应用更新通知 |
|
||||
| **订单通知** | 支付成功/失败/退款结果通知 |
|
||||
|
||||
---
|
||||
|
||||
#### 后台模块一:大模型库管理
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **模型接入** | 统一接入管理各类大模型供应商,支持添加/编辑/删除模型接口 |
|
||||
| **API配置** | 填写模型API密钥、接口地址、超时参数 |
|
||||
| **状态管控** | 单独管控每款模型状态:开启免费调用 / 开启付费调用 |
|
||||
| **计费配置** | 统一按照"元/百万Token"单位设置扣费单价,输入即实时生效 |
|
||||
| **全局统计** | 查看全平台所有用户全局模型调用统计数据 |
|
||||
|
||||
#### 后台模块二:网站基础信息设置
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **品牌配置** | 网站前台LOGO、网站名称、首页公告、备案号、客服联系方式 |
|
||||
| **邮件配置** | 邮件服务器配置(SMTP),用于发送会员到期通知、验证码、账单邮件 |
|
||||
| **短信配置** | 对接第三方短信接口,用于手机号验证码、异常登录短信告警 |
|
||||
|
||||
#### 后台模块三:支付渠道配置
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **微信支付** | 商户号、密钥、证书完整配置 |
|
||||
| **支付宝支付** | 应用ID、支付密钥、接口配置 |
|
||||
| **订单管理** | 统一订单回调管理、支付订单对账、退款后台操作功能 |
|
||||
|
||||
#### 后台模块四:增值服务管理
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **虚拟增值服务** | 上架、编辑、下架各类一次性AI虚拟增值服务 |
|
||||
| **定制服务** | 后台上架Skills、Agent、MCP三类定制开发服务,用户可付费下单定制 |
|
||||
| **订单管理** | 增值服务订单管理、售后处理、订单状态修改 |
|
||||
|
||||
#### 后台模块五:会员订阅体系管理
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **会员等级管理** | 自定义新增/编辑/删除多级会员等级,配置月/季/年三档订阅价格 |
|
||||
| **权益配置** | 配置各等级会员可免费使用的应用市场Skills/Agent/MCP清单 |
|
||||
| **免费额度配置** | 设置不同等级会员每日免费Token额度、免费专属大模型 |
|
||||
| **自动化规则** | 会员到期自动降级、自动续费开关配置 |
|
||||
|
||||
#### 后台模块六:应用市场审核管理
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **应用审核** | 审核普通用户上传的Skills/Agent/MCP应用,审核通过后上架,违规应用强制下架 |
|
||||
| **优惠券管理** | 平台优惠券活动创建、编辑、发放,管控用户付费应用是否参与满减活动 |
|
||||
| **官方应用管理** | 平台官方应用上下架管理 |
|
||||
|
||||
#### 后台模块七:全平台日志与用户风控管理
|
||||
|
||||
| 功能点 | 详细描述 |
|
||||
|--------|----------|
|
||||
| **操作日志** | 全平台用户操作日志查询与导出(不可手动删除) |
|
||||
| **调用日志** | 模型调用日志查询与导出(不可手动删除) |
|
||||
| **付费日志** | 付费订单日志查询与导出(不可手动删除) |
|
||||
| **风控管理** | 用户账号封禁/解封、API调用限流、异常调用风控拦截 |
|
||||
|
||||
---
|
||||
|
||||
### 7.3 数据库设计概要
|
||||
|
||||
#### 7.3.1 关系型数据库(MySQL 8)
|
||||
|
||||
**用户与权限相关表:**
|
||||
|
||||
| 表名 | 说明 | 核心字段 |
|
||||
|------|------|----------|
|
||||
| `users` | 用户表 | id, username, email, phone, password_hash, avatar, role(普通用户/管理员), status(正常/封禁), created_at, updated_at |
|
||||
| `login_logs` | 登录日志表 | id, user_id, ip, user_agent, login_at |
|
||||
| `api_keys` | API密钥表 | id, user_id, api_key, secret, status, created_at, expired_at |
|
||||
|
||||
**AI聊天与频道相关表:**
|
||||
|
||||
| 表名 | 说明 | 核心字段 |
|
||||
|------|------|----------|
|
||||
| `conversations` | 对话会话表 | id, user_id, title, model_id, status(活跃/归档), created_at, updated_at |
|
||||
| `messages` | 对话消息表 | id, conversation_id, role(用户/助手/系统), content, token_used, model_id, knowledge_ids, agent_ids, created_at |
|
||||
| `channels` | 频道表 | id, owner_id, name, description, default_agent_id, knowledge_base_id, status, created_at |
|
||||
| `channel_members` | 频道成员表 | id, channel_id, user_id, role(创建者/成员), joined_at |
|
||||
| `channel_messages` | 频道消息表 | id, channel_id, user_id, role, content, token_used, created_at |
|
||||
|
||||
**知识库相关表:**
|
||||
|
||||
| 表名 | 说明 | 核心字段 |
|
||||
|------|------|----------|
|
||||
| `knowledge_bases` | 知识库表 | id, user_id, name, description, directory_path, created_at, updated_at |
|
||||
| `knowledge_documents` | 知识文档表 | id, knowledge_base_id, filename, file_type, file_size, status(处理中/已完成/失败), chunk_count, created_at |
|
||||
| `knowledge_directories` | 知识目录表 | id, user_id, parent_id, name, created_at |
|
||||
|
||||
**应用市场相关表:**
|
||||
|
||||
| 表名 | 说明 | 核心字段 |
|
||||
|------|------|----------|
|
||||
| `market_apps` | 应用市场表 | id, name, type(Skills/Agent/MCP), source(官方/用户自研), publisher_id, description, price, is_member_free, join_promotion(是否参与优惠券), status(审核中/已上架/已下架), rating_avg, created_at |
|
||||
| `app_purchases` | 应用购买表 | id, user_id, app_id, price, payment_id, created_at |
|
||||
| `app_reviews` | 应用评价表 | id, user_id, app_id, rating, content, created_at |
|
||||
| `app_installations` | 应用安装表 | id, user_id, app_id, installed_at |
|
||||
|
||||
**付费与订单相关表:**
|
||||
|
||||
| 表名 | 说明 | 核心字段 |
|
||||
|------|------|----------|
|
||||
| `membership_plans` | 会员等级表 | id, name, level, duration_type(月/季/年), price, daily_free_tokens, created_at |
|
||||
| `membership_subscriptions` | 用户订阅表 | id, user_id, plan_id, start_at, end_at, auto_renew, status(生效中/已过期/已降级), created_at |
|
||||
| `orders` | 订单表 | id, user_id, order_type(会员/增值服务), amount, payment_method(微信/支付宝), status(待支付/已支付/已退款), payment_id, created_at |
|
||||
| `coupons` | 优惠券表 | id, code, type, value, min_amount, valid_from, valid_to, status, created_at |
|
||||
| `user_coupons` | 用户优惠券表 | id, user_id, coupon_id, status(未使用/已使用/已过期) |
|
||||
| `value_added_services` | 增值服务表 | id, name, description, price, type, status(上架/下架), created_at |
|
||||
| `custom_service_orders` | 定制服务订单 | id, user_id, service_type(Skills/Agent/MCP), description, status, price, created_at |
|
||||
|
||||
**Token与计费相关表:**
|
||||
|
||||
| 表名 | 说明 | 核心字段 |
|
||||
|------|------|----------|
|
||||
| `model_providers` | 模型供应商表 | id, name, api_base_url, created_at |
|
||||
| `models` | 大模型表 | id, provider_id, name, api_key, endpoint, timeout, status(免费/付费), price_per_million_tokens, is_enabled, created_at |
|
||||
| `token_usage_logs` | Token消耗日志 | id, user_id, model_id, app_id, conversation_id, prompt_tokens, completion_tokens, total_tokens, cost, created_at |
|
||||
| `token_balances` | Token余额表 | id, user_id, total_consumed, balance, updated_at |
|
||||
|
||||
**通知与日志相关表:**
|
||||
|
||||
| 表名 | 说明 | 核心字段 |
|
||||
|------|------|----------|
|
||||
| `notifications` | 通知表 | id, user_id, type(公告/提醒/续费/订单), title, content, is_read, created_at |
|
||||
| `operation_logs` | 操作日志表 | id, user_id, action, target, detail, ip, created_at |
|
||||
| `audit_logs` | 审计日志表 | id, admin_id, action, target_type, target_id, detail, created_at |
|
||||
|
||||
**系统配置相关表:**
|
||||
|
||||
| 表名 | 说明 | 核心字段 |
|
||||
|------|------|----------|
|
||||
| `site_settings` | 网站设置表 | id, key, value, updated_at |
|
||||
| `email_configs` | 邮箱配置表 | id, smtp_host, smtp_port, username, password, from_address, created_at |
|
||||
| `sms_configs` | 短信配置表 | id, provider, api_key, api_secret, sign_name, created_at |
|
||||
| `payment_configs` | 支付配置表 | id, type(微信/支付宝), app_id, merchant_id, api_key, cert_path, status, created_at |
|
||||
|
||||
**预留扩展字段表:**
|
||||
|
||||
| 表名 | 说明 |
|
||||
|------|------|
|
||||
| `teams` | 团队表(预留:AI团队协作空间) |
|
||||
| `referrals` | 分销推广表(预留:用户推广返佣) |
|
||||
| `open_api_clients` | API开放平台表(预留:对外售卖模型调用接口) |
|
||||
|
||||
#### 7.3.2 向量数据库(RAGFlow)
|
||||
|
||||
| 集合/空间 | 说明 | 隔离方式 |
|
||||
|-----------|------|----------|
|
||||
| `user_{user_id}_vectors` | 每个用户独立向量空间 | 按用户ID物理隔离,独立集合 |
|
||||
| 向量文档 | 文档切片后的embedding向量 | 关联knowledge_documents.id |
|
||||
| 元数据 | 文档来源、切片序号、目录路径 | 用于检索溯源 |
|
||||
|
||||
---
|
||||
|
||||
### 7.4 技术方案概要
|
||||
|
||||
#### 7.4.1 技术栈
|
||||
|
||||
| 层级 | 技术选型 |
|
||||
|------|----------|
|
||||
| **前端** | TypeScript + React + Vite, HashRouter路由 |
|
||||
| **后端** | Python 3(FastAPI)或 Golang |
|
||||
| **关系型数据库** | MySQL 8(已配置:localhost:3306) |
|
||||
| **向量数据库** | RAGFlow(独立部署,每位用户独立向量空间) |
|
||||
| **缓存** | Redis(已配置:localhost:6379) |
|
||||
| **支付** | 微信支付 + 支付宝支付(后端配置) |
|
||||
|
||||
#### 7.4.2 架构原则
|
||||
|
||||
- **双库部署**:关系型数据库存储业务数据,向量数据库存储知识图谱数据
|
||||
- **用户数据隔离**:逻辑层+数据库层双层隔离,所有查询必须带user_id过滤
|
||||
- **后端端口**:18080端口,接口路径以`/app`为前缀
|
||||
- **前端部署**:构建产物输出至`/data/share/project/frontend/dist`
|
||||
- **权限体系**:前台用户与后台管理员完全隔离,管理员无法访问用户私密数据
|
||||
- **日志不可删除**:所有操作日志、调用日志、付费日志数据库级别禁止DELETE操作
|
||||
|
||||
---
|
||||
|
||||
### 7.5 关键假设与约束
|
||||
|
||||
| 编号 | 假设/约束 | 风险等级 |
|
||||
|------|-----------|----------|
|
||||
| A1 | BuildingAI开源框架底层可直接复用,减少50%以上开发重复工作 | 中 |
|
||||
| A2 | RAGFlow支持按用户创建独立向量空间 | 低 |
|
||||
| A3 | 微信支付/支付宝支付可顺利完成商户号申请与配置 | 低 |
|
||||
| A4 | 大模型API供应商接口稳定可用 | 中 |
|
||||
| A5 | 目标用户对QwenPaw交互模式有基础认知 | 低 |
|
||||
| C1 | 必须遵循Nginx代理配置,前端端口8080,后端端口18080 | 强约束 |
|
||||
| C2 | 所有文件必须放在`/data/share/project`目录下 | 强约束 |
|
||||
| C3 | 用户数据强制物理隔离为最高优先级要求 | 强约束 |
|
||||
|
||||
---
|
||||
|
||||
## 8. 版本规划
|
||||
|
||||
### 8.1 当前版本交付范围
|
||||
|
||||
本次一次性交付全部功能,不做分阶段开发:
|
||||
|
||||
| 交付物 | 内容说明 |
|
||||
|--------|----------|
|
||||
| **前台8大板块** | AI聊天、频道、知识库、应用市场、Token驾驶舱、付费中心、个人中心、消息通知 |
|
||||
| **后台7大模块** | 大模型库管理、网站设置、支付配置、增值服务、会员体系、应用审核、日志风控 |
|
||||
| **完整数据库** | 关系型数据库全套建表语句 + 向量数据库部署文档 |
|
||||
| **前后端源码** | 完整可编译/可运行的前后端源代码 |
|
||||
| **部署方案** | 云端一键部署 + Docker Compose本地私有化部署 |
|
||||
|
||||
### 8.2 后续迭代预留
|
||||
|
||||
| 预留模块 | 当前处理方式 |
|
||||
|----------|--------------|
|
||||
| AI团队协作空间 | 数据库预留表结构,前端页面占位 |
|
||||
| 平台分销推广体系 | 数据库预留表结构,前端页面占位 |
|
||||
| API开放平台 | 数据库预留表结构,前端页面占位 |
|
||||
|
||||
---
|
||||
|
||||
## 附录:功能需求清单
|
||||
|
||||
### 前台功能清单(共8大板块,51个功能点)
|
||||
|
||||
| 序号 | 板块 | 功能点 |
|
||||
|------|------|--------|
|
||||
| 1 | AI聊天 | 多模型切换 |
|
||||
| 2 | AI聊天 | 多轮上下文连续对话 |
|
||||
| 3 | AI聊天 | 对话记录云端保存 |
|
||||
| 4 | AI聊天 | 对话重命名 |
|
||||
| 5 | AI聊天 | 对话删除 |
|
||||
| 6 | AI聊天 | 对话归档 |
|
||||
| 7 | AI聊天 | 上下文清空 |
|
||||
| 8 | AI聊天 | 挂载个人知识库 |
|
||||
| 9 | AI聊天 | 挂载第三方Agent |
|
||||
| 10 | AI聊天 | 挂载技能工具 |
|
||||
| 11 | 频道 | 自建频道 |
|
||||
| 12 | 频道 | 频道绑定固定Agent |
|
||||
| 13 | 频道 | 频道绑定固定技能 |
|
||||
| 14 | 频道 | 频道绑定专属知识库 |
|
||||
| 15 | 频道 | 邀请好友协作 |
|
||||
| 16 | 频道 | 频道会话数据隔离 |
|
||||
| 17 | 知识库 | 独立RAGFlow向量空间 |
|
||||
| 18 | 知识库 | 上传文档/表格/网页/本地文件 |
|
||||
| 19 | 知识库 | 一键切片向量化 |
|
||||
| 20 | 知识库 | 知识图谱构建 |
|
||||
| 21 | 知识库 | 目录管理 |
|
||||
| 22 | 知识库 | 权限设置(仅自己可见) |
|
||||
| 23 | 知识库 | 挂载至对话/频道/Agent |
|
||||
| 24 | 知识库 | 问答溯源与原文查看 |
|
||||
| 25 | 应用市场 | Skills/Agent/MCP三大分类 |
|
||||
| 26 | 应用市场 | 官方应用上架 |
|
||||
| 27 | 应用市场 | 用户自主上传自研应用 |
|
||||
| 28 | 应用市场 | 发布者自定义单次购买价格 |
|
||||
| 29 | 应用市场 | 选择是否参与优惠券满减 |
|
||||
| 30 | 应用市场 | 购买后仅本人可用 |
|
||||
| 31 | 应用市场 | 会员免费使用专属应用 |
|
||||
| 32 | 应用市场 | 应用评分评价 |
|
||||
| 33 | 应用市场 | 应用详情介绍 |
|
||||
| 34 | 应用市场 | 应用使用教程 |
|
||||
| 35 | 应用市场 | 一键安装 |
|
||||
| 36 | 应用市场 | 已购应用管理 |
|
||||
| 37 | Token驾驶舱 | 累计总消耗Token |
|
||||
| 38 | Token驾驶舱 | 当日使用中应用数量 |
|
||||
| 39 | Token驾驶舱 | 消耗量第一的大模型 |
|
||||
| 40 | Token驾驶舱 | 消耗量TOP3应用 |
|
||||
| 41 | Token驾驶舱 | Token消耗明细表 |
|
||||
| 42 | Token驾驶舱 | 余额预警弹窗 |
|
||||
| 43 | Token驾驶舱 | 一键充值 |
|
||||
| 44 | Token驾驶舱 | 数据导出 |
|
||||
| 45 | 付费中心 | 会员月/季/年订阅 |
|
||||
| 46 | 付费中心 | 单独增值服务购买 |
|
||||
| 47 | 付费中心 | 微信支付/支付宝支付 |
|
||||
| 48 | 付费中心 | 订单查询 |
|
||||
| 49 | 付费中心 | 电子凭证开具 |
|
||||
| 50 | 个人中心 | 账号安全/密码/登录日志 |
|
||||
| 51 | 个人中心 | 订单/会员/优惠券/已购/API密钥管理 |
|
||||
| 52 | 消息通知 | 公告/到期/余额/更新/订单通知 |
|
||||
|
||||
### 后台功能清单(共7大模块,31个功能点)
|
||||
|
||||
| 序号 | 模块 | 功能点 |
|
||||
|------|------|--------|
|
||||
| 1 | 大模型库管理 | 添加/编辑/删除模型供应商 |
|
||||
| 2 | 大模型库管理 | 配置API密钥/超时参数 |
|
||||
| 3 | 大模型库管理 | 开启免费/付费状态开关 |
|
||||
| 4 | 大模型库管理 | 自定义Token计费单价 |
|
||||
| 5 | 大模型库管理 | 全局调用统计 |
|
||||
| 6 | 网站基础设置 | LOGO/名称/公告/备案号配置 |
|
||||
| 7 | 网站基础设置 | 邮件服务器配置 |
|
||||
| 8 | 网站基础设置 | 短信接口配置 |
|
||||
| 9 | 支付渠道配置 | 微信支付配置 |
|
||||
| 10 | 支付渠道配置 | 支付宝支付配置 |
|
||||
| 11 | 支付渠道配置 | 订单对账与退款 |
|
||||
| 12 | 增值服务管理 | 虚拟增值服务上架/编辑/下架 |
|
||||
| 13 | 增值服务管理 | Skills/Agent/MCP定制服务 |
|
||||
| 14 | 增值服务管理 | 订单管理与售后 |
|
||||
| 15 | 会员订阅体系 | 多级会员等级管理 |
|
||||
| 16 | 会员订阅体系 | 月/季/年订阅价格配置 |
|
||||
| 17 | 会员订阅体系 | 会员免费应用清单配置 |
|
||||
| 18 | 会员订阅体系 | 免费Token额度配置 |
|
||||
| 19 | 会员订阅体系 | 自动降级/自动续费配置 |
|
||||
| 20 | 应用市场审核 | 应用审核与违规下架 |
|
||||
| 21 | 应用市场审核 | 优惠券活动管理 |
|
||||
| 22 | 应用市场审核 | 官方应用上下架 |
|
||||
| 23 | 日志与风控 | 全平台操作日志查询导出 |
|
||||
| 24 | 日志与风控 | 模型调用日志查询导出 |
|
||||
| 25 | 日志与风控 | 付费订单日志查询导出 |
|
||||
| 26 | 日志与风控 | 用户账号封禁/解封 |
|
||||
| 27 | 日志与风控 | API调用限流 |
|
||||
| 28 | 日志与风控 | 异常调用风控拦截 |
|
||||
|
||||
---
|
||||
|
||||
> **文档状态**:已定稿
|
||||
> **创建日期**:2026-05-26
|
||||
> **文档版本**:v1.0
|
||||
Reference in new issue
Block a user