49 lines
2.0 KiB
Markdown
49 lines
2.0 KiB
Markdown
# 需求分析 - 2026-04-29-22-49-38
|
||
|
||
## 需求来源
|
||
- 提出时间: 2026-04-29-22-49-38
|
||
- 需求类型: 缺陷修复
|
||
|
||
## 原始需求描述
|
||
1. 项目库中视频显示"异常"，且无法点击导入多媒体资源
|
||
2. 控制台 WebSocket 报错：
|
||
- `WebSocket connection to 'ws://localhost:8000/ws/progress' failed`
|
||
- `WebSocket is closed before the connection is established`
|
||
|
||
## 需求拆解
|
||
|
||
### 需求 1: 修复 WebSocket URL（localhost → IP）
|
||
- **详细描述**: `websocket.ts` 硬编码 `ws://localhost:8000/ws/progress`，浏览器解析为客户端本地地址导致连接失败
|
||
- **优先级**: P0-阻塞
|
||
- **影响范围**: `src/lib/websocket.ts`
|
||
- **验收标准**: WebSocket 连接到服务器实际 IP
|
||
|
||
### 需求 2: 后端添加 WebSocket 路由
|
||
- **详细描述**: FastAPI 后端未实现 `/ws/progress` WebSocket endpoint，前端连接被拒绝
|
||
- **优先级**: P0-阻塞
|
||
- **影响范围**: `backend/main.py`
|
||
- **验收标准**: 后端接受 WebSocket 连接，可推送解析进度消息
|
||
|
||
### 需求 3: 修复"导入多媒体资源"按钮点击
|
||
- **详细描述**: `ProjectLibrary.tsx` 中按钮为纯静态 UI，无 `onClick` 事件和文件输入框
|
||
- **优先级**: P0-阻塞
|
||
- **影响范围**: `src/components/ProjectLibrary.tsx`
|
||
- **验收标准**: 点击按钮弹出文件选择器，可选择视频/图片文件
|
||
|
||
### 需求 4: 修复项目状态显示"异常"
|
||
- **详细描述**: 后端数据库项目默认状态为 `'pending'`，前端只识别 `'Ready'` 和 `'Parsing'`，其他状态均显示"异常"
|
||
- **优先级**: P0-阻塞
|
||
- **影响范围**: `backend/models.py` 或 `src/components/ProjectLibrary.tsx`
|
||
- **验收标准**: 新建项目默认显示正确状态（非"异常"）
|
||
|
||
## 约束条件
|
||
- 保持中文界面
|
||
- 最小修改原则
|
||
- 不破坏现有 API 契约
|
||
|
||
## 风险评估
|
||
| 风险点 | 影响 | 缓解措施 |
|
||
|--------|------|----------|
|
||
| WebSocket 实现复杂度高 | 中 | 先实现基础连接和心跳，进度推送后续完善 |
|
||
| 文件上传无后端对接 | 低 | 前端先实现文件选择器，调用已有 uploadMedia API |
|