xiaoxia-saas/docs/专项E-前端真实联调验收深化-规划.md

专项 E：前端真实联调验收深化 - 规划文档

专项负责人：小虾 🦐
创建时间：2026-06-19 10:37 GMT+8
状态：🔄 进行中

---

一、专项目标

从"可构建"提升到"完整用户路径稳定可用"。

验证 Phase 7 核心视频剪辑主链路的端到端可用性。

---

二、验收范围

核心用户路径（Phase 7 主链）

用户注册/登录
  ↓
创建工作空间
  ↓
创建项目
  ↓
上传素材
  ↓
查看素材列表
  ↓
发起分类
  ↓
创建生成任务
  ↓
查看生成进度
  ↓
查看生成结果
  ↓
下载成片

---

三、验收方式

方式 1：手工验收（优先）

• 启动完整环境（API + Worker + Web）
• 按用户路径逐步操作
• 记录每一步的实际行为
• 发现问题立即记录

方式 2：自动化测试

• E2E 测试脚本
• 仅在手工验收通过后补充

---

四、执行计划

Step 1：环境准备

• 确认本地开发环境完整
• 启动后端 API
• 启动 Celery worker
• 启动前端 dev server
• 确认数据库/Redis/MinIO 可用

Step 2：逐步验收

• 用户注册/登录
• 创建工作空间
• 创建项目
• 上传素材
• 查看素材列表
• 发起分类
• 创建生成任务
• 查看生成进度
• 查看生成结果
• 下载成片

Step 3：问题修复

• 记录所有发现的问题
• 按优先级修复
• 重新验收修复的部分

Step 4：验收报告

• 生成验收报告
• 标注通过/失败的环节
• 记录待修复问题

---

五、验收标准

必须通过

• ✅ 用户能完整走通主链路
• ✅ 每一步操作有正确的反馈
• ✅ 没有阻断性错误
• ✅ 生成的视频能正常下载

可以有的已知限制

• ⚠️ 生成逻辑是 mock（专项 D 会改进）
• ⚠️ 界面细节优化（非阻断）

---

六、预期结果

成功标准

• 主链路端到端可用
• 用户能拿到"生成的视频"（即使是 mock）
• 前后端 API 联调正常

失败标准

• 任何一步无法继续
• API 报错无法恢复
• 前端崩溃

---

七、风险评估

可能遇到的问题：

1. 环境配置缺失（数据库/Redis/MinIO）
2. API 跨域问题
3. 认证 token 失效
4. Worker 没有正确处理任务
5. 前端路由或状态管理问题

应对策略：

• 发现问题立即记录
• 优先修复阻断性问题
• 非阻断问题记录到后续专项

---

状态：准备开始执行
下一步：环境准备与启动