qihuaiflow/docs/PRD.md

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