# 专项 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. 前端路由或状态管理问题

**应对策略**：
- 发现问题立即记录
- 优先修复阻断性问题
- 非阻断问题记录到后续专项

---

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