Files
xiaoxia-saas/docs/saas-mvp-scope.md
T
Xiaoxia AI b5a62ee9a3 feat: initial SaaS scaffold
- 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
2026-06-15 15:17:40 +08:00

3.5 KiB

SaaS 一期 MVP 范围清单

本文档定义新 SaaS 项目的第一阶段最小可用版本(MVP)范围。

目标不是把桌面版全部能力一口气搬完,而是先做出一条 真实可用、能闭环、能上线、能继续扩展 的主链路。


1. MVP 目标

一期 MVP 必须实现:

  • 用户能登录进入系统
  • 用户能创建项目
  • 用户能上传素材
  • 系统能完成素材分类
  • 用户能发起生成任务
  • 用户能看到任务进度
  • 用户能拿到生成结果

一句话:

从“进入系统”到“拿到成片”这条主链必须完整跑通。


2. 一期必须做的能力

2.1 账号与工作空间

必须做:

  • 登录
  • 基础用户系统
  • 默认工作空间

一期先简化:

  • 单用户 / 单工作空间也可以
  • 但数据模型必须保留未来扩展到团队/多租户的空间

2.2 项目管理

必须做:

  • 创建项目
  • 项目列表
  • 项目详情页 / 工作台入口

不必一开始就做:

  • 项目归档
  • 项目模板
  • 复杂项目权限

2.3 素材管理

必须做:

  • 上传视频/图片素材
  • 上传配音素材
  • 查看素材列表
  • 查看配音列表
  • 基础素材库概念

必须具备的质量底线:

  • 基础去重/错误校验
  • 基础状态可见
  • 明确的归属(项目 / 工作空间)

2.4 素材分类与诊断

必须做:

  • 触发素材分类任务
  • 返回分类结果
  • 能看到素材准备度 / 诊断摘要

一期可以简化:

  • 先做基础分类与基础诊断
  • 高级风险评分和复杂建议后续再增强

2.5 生成任务

必须做:

  • 提交单次生成任务
  • 提交批量生成任务
  • 后台异步执行
  • 查询任务状态
  • 查询任务进度

必须保留的关键规则:

  • 单项失败不能拖垮整批
  • 长任务不能阻塞主请求
  • 任务必须有状态、日志和失败原因

2.6 成片结果

必须做:

  • 结果列表
  • 结果详情 / 基础信息
  • 下载成片

一期可以不做:

  • 一键发布外部平台
  • 高级审核流
  • 结果版本对比

3. 一期建议做,但不是强阻塞

这些能力建议尽量做,但如果影响整体交付,可以延后到 1.1 或 1.2:

  • 素材筛选与搜索
  • 配音试听
  • 更丰富的诊断报告
  • 任务失败后的手动重试
  • 结果包下载
  • 更细的操作日志

4. 一期明确不做的内容

以下内容不应阻塞 MVP 启动:

  • 支付 / 套餐系统
  • 模板市场
  • 复杂 RBAC 权限体系
  • 多层级审批流
  • 自动发布到外部平台
  • 超复杂的数据看板
  • 高级团队协作机制
  • 面向外部客户的多租户计费能力

这些都是未来功能,不属于 MVP 起步必要条件。


5. MVP 验收标准

一期 MVP 完成的标准不是“页面很多”,而是以下闭环成立:

  1. 用户登录进入工作空间
  2. 创建项目
  3. 上传视频/图片/配音素材
  4. 触发素材分类
  5. 提交单次或批量生成
  6. 系统后台执行任务
  7. 前端可见任务状态和进度
  8. 用户能查看并下载结果

如果这 8 步稳定成立,MVP 就合格。


6. MVP 技术验收标准

除了功能闭环,还必须满足工程验收:

  • 代码结构符合目标架构
  • 前后端分层清晰
  • 核心接口有文档
  • 核心任务链有自动化测试
  • CI 可跑通
  • 有基础日志和错误追踪
  • 有最小可用部署方案

7. 当前建议结论

一期 MVP 只抓核心价值:

  • 项目
  • 素材
  • 分类
  • 生成
  • 结果

先把主链路做实,再逐步叠加:

  • 团队协作
  • 高级权限
  • 发布能力
  • 运营能力
  • 商业化能力