138 lines
2.5 KiB
Markdown
138 lines
2.5 KiB
Markdown
# 专项 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. 前端路由或状态管理问题
|
||
|
||
**应对策略**：
|
||
- 发现问题立即记录
|
||
- 优先修复阻断性问题
|
||
- 非阻断问题记录到后续专项
|
||
|
||
---
|
||
|
||
**状态**：准备开始执行
|
||
**下一步**：环境准备与启动
|