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