Xiaoxia AI
b5a62ee9a3
- domain: User, Workspace, Project, AssetLibrary, Asset, IngestJob - ports: repository interfaces - application: use cases - adapters: in-memory - API: FastAPI 5 routes - worker: Celery ingest_asset - tests: 4 passing
4.6 KiB
4.6 KiB
SaaS 核心流程清单（第一版）
本文档定义新 SaaS 系统的一期核心业务流程。目的不是画所有细节，而是先明确系统必须跑通哪些主链路。
1. 流程设计原则
核心流程必须满足：
- 覆盖现有桌面版的主要功能价值
- 适合 SaaS 架构而不是桌面软件思维
- 支持异步任务、多人协作、后续扩展
- 允许阶段性交付，不要求一开始全量上线
2. 一期核心主流程
建议一期至少跑通 6 条主流程：
- 登录与进入工作空间
- 创建项目
- 上传并管理素材
- 素材分类与诊断
- 发起生成 / 批量生成
- 查看结果与下载
3. 流程一：登录与进入工作空间
目标
让用户能够进入自己的工作环境。
基本步骤
- 用户登录
- 进入默认工作空间
- 查看项目列表
- 选择已有项目或创建新项目
一期建议
- 可以先简化为单用户单工作空间
- 但模型上要保留工作空间概念
4. 流程二：创建项目
目标
为一轮视频生成工作建立上下文容器。
基本步骤
- 用户点击创建项目
- 输入项目名称
- 系统创建项目
- 跳转到项目工作台
项目工作台未来应承载
- 素材库
- 配音库
- 策略
- 任务
- 结果
- 诊断
5. 流程三：上传并管理素材
目标
把桌面版“本地素材库”的能力转化成 SaaS 中的项目级素材管理。
子流程
5.1 上传视频/图片素材
- 选择项目
- 上传文件
- 系统保存到素材库
- 返回素材列表
5.2 上传配音素材
- 选择项目或配音库
- 上传配音文件
- 系统去重/校验
- 返回配音列表
5.3 管理素材库
包括：
- 新建素材库
- 删除素材库
- 查看素材详情
- 过滤、搜索、统计
一期建议
- 先做项目级素材上传和列表
- 库管理可以保留轻量版
6. 流程四：素材分类与诊断
目标
复用现有桌面版已经验证过的价值：
- 自动分类素材
- 给出素材准备度
- 找出缺口和风险
基本步骤
- 用户触发分类/诊断
- 系统创建异步任务
- worker 执行分类与诊断
- 用户看到进度
- 分类结果回写素材
- 诊断结果展示到项目界面
关键要求
- 长任务异步执行
- 坏文件不能拖垮整批
- 分类和诊断结果必须可追踪
7. 流程五：发起生成 / 批量生成
目标
这是核心价值流程，必须作为系统最重要主链路设计。
5.1 单次生成流程
- 用户选择项目
- 选择/配置生成策略
- 选择素材库与配音库
- 提交生成请求
- 系统创建生成任务
- worker 执行生成
- 返回进度和日志
- 产出成片结果
5.2 批量生成流程
- 用户配置批量规则
- 提交批量任务
- 系统拆分候选
- 每个候选独立执行
- 单候选失败不拖垮全批次
- 汇总成功/失败/跳过结果
关键要求
- 任务必须异步
- 状态必须可跟踪
- 单项失败隔离
- 支持取消 / 停止 / 重试（后续逐步补）
8. 流程六：查看结果与下载
目标
让用户消费系统产出的最终价值。
基本步骤
- 用户打开项目结果页
- 查看成片列表
- 预览结果
- 下载单个成片或结果包
后续可扩展
- 一键发布
- 结果同步
- 团队复核
- 版本对比
9. 配套支撑流程
除了主流程，还需要这些支撑流程：
9.1 任务状态查看
- 查看执行中任务
- 查看失败原因
- 查看进度
9.2 日志与诊断
- 查看任务日志
- 查看错误摘要
- 查看系统健康状态
9.3 Worker 管理
- 节点在线状态
- 任务分配情况
- 队列积压情况
9.4 审计与操作记录
- 谁上传了什么
- 谁删除了什么
- 谁发起了任务
- 失败发生在什么时候
10. 一期暂缓流程
这些不是现在最先必须做的：
- 支付 / 套餐
- 模板市场
- 多层级复杂权限
- 外部平台自动发布
- 高级协同审批流
这些后面可以做，但不应该阻塞 SaaS 第一版启动。
11. 一期主线 MVP 建议
建议先确保以下闭环跑通：
- 登录
- 创建项目
- 上传素材
- 素材分类
- 发起生成
- 查看进度
- 下载结果
如果这条链能稳定跑通，SaaS 第一版就已经有真实价值。
12. 当前阶段结论
当前最重要的是：
- 不要试图一口气把所有桌面能力都搬完
- 先抓住真正的主链路
- 先让 SaaS 的关键业务闭环成立
下一步应继续：
- 根据核心对象和核心流程，开始做技术栈选型