feat: 前端优化

This commit is contained in:
2025-12-21 22:24:16 +08:00
parent d3a8ea1964
commit b80de78d7c
36 changed files with 3721 additions and 1205 deletions

View File

@@ -0,0 +1,344 @@
## ADDED Requirements
### Requirement: 数字人任务列表显示
数字人任务管理系统 SHALL 提供任务列表页面,用于查看和管理所有数字人生成任务。
页面规范:
- 路径:`/system/task-management/digital-human-task`
- 布局:使用任务中心的左右分栏布局
- 功能:显示、筛选、搜索、操作数字人任务
#### Scenario: 显示数字人任务列表
- **WHEN** 用户访问 `/system/task-management/digital-human-task`
- **THEN** 显示数字人任务列表页面
- **AND** 左侧导航中「数字人视频任务」项高亮
- **AND** 右侧显示任务列表表格
### Requirement: 任务列表表格列定义
数字人任务列表 SHALL 显示以下列信息:
列定义:
- ID任务唯一标识
- 任务名称:用户设定的任务名称
- 视频文件:原始视频文件信息
- 文案内容:输入的文本内容(支持截断显示)
- 音色:使用的音色配置
- 状态任务当前状态pending/running/success/failed
- 进度任务完成百分比0-100
- 创建时间:任务创建的时间
- 操作:可执行的操作按钮
#### Scenario: 显示任务列表数据
- **WHEN** 任务列表加载完成
- **THEN** 表格显示所有任务的基本信息
- **AND** 文案内容列使用 ellipsis 截断过长文本
- **AND** 状态列使用彩色标签显示
- **AND** 进度列显示进度条和百分比
### Requirement: 任务状态管理
数字人任务 SHALL 支持以下状态:
状态定义:
- `pending`:等待处理
- `running`:处理中
- `success`:已完成
- `failed`:失败
- `canceled`:已取消
#### Scenario: 显示任务状态
- **WHEN** 渲染任务列表中的状态列
- **THEN** 根据任务状态显示对应颜色的标签
- **AND** 状态标签文本为中文描述
- **AND** 状态颜色映射:
- pending灰色
- running蓝色带动画效果
- success绿色
- failed红色
- canceled橙色
### Requirement: 任务操作功能
数字人任务列表 SHALL 支持以下操作:
操作定义:
- 预览:查看生成结果视频
- 下载:下载生成的视频文件
- 删除:删除任务记录
- 取消:取消正在运行的任务
- 重试:重新执行失败的任务
#### Scenario: 显示操作按钮
- **WHEN** 渲染任务列表中的操作列
- **THEN** 根据状态显示对应的任务操作按钮
- **AND** 按钮显示规则:
- 所有任务:预览、删除
- pending/running 任务:取消
- success 任务:下载
- failed 任务:重试
#### Scenario: 执行预览操作
- **WHEN** 用户点击「预览」按钮
- **THEN** 弹出视频预览窗口
- **AND** 窗口显示生成的结果视频
- **AND** 提供关闭按钮
#### Scenario: 执行下载操作
- **WHEN** 用户点击「下载」按钮
- **THEN** 开始下载生成的视频文件
- **AND** 文件名为「数字人视频_{任务ID}_{时间戳}.mp4」
#### Scenario: 执行删除操作
- **WHEN** 用户点击「删除」按钮
- **THEN** 弹出确认对话框
- **AND** 用户确认后删除任务
- **AND** 删除后刷新列表
#### Scenario: 执行取消操作
- **WHEN** 用户点击「取消」按钮
- **THEN** 调用取消 API
- **AND** 任务状态变更为 canceled
- **AND** 停止状态轮询
#### Scenario: 执行重试操作
- **WHEN** 用户点击「重试」按钮
- **THEN** 调用重试 API
- **AND** 任务状态变更为 pending
- **AND** 重新开始状态轮询
### Requirement: 筛选和搜索功能
数字人任务列表 SHALL 支持以下筛选条件:
筛选条件:
- 任务状态:下拉选择(全部/待处理/处理中/已完成/失败)
- 任务名称:文本搜索(支持模糊匹配)
- 创建时间:日期范围选择
#### Scenario: 按状态筛选
- **WHEN** 用户选择任务状态下拉框
- **THEN** 列表自动刷新,只显示对应状态的任务
- **AND** 选择「全部状态」时显示所有任务
#### Scenario: 按名称搜索
- **WHEN** 用户在搜索框输入关键词
- **AND** 按下回车键或点击搜索按钮
- **THEN** 列表自动刷新,只显示名称包含关键词的任务
- **AND** 搜索支持模糊匹配
#### Scenario: 按时间范围筛选
- **WHEN** 用户选择日期范围
- **THEN** 列表自动刷新,只显示创建时间在范围内的任务
- **AND** 日期格式为「YYYY-MM-DD」
### Requirement: 分页功能
数字人任务列表 SHALL 支持分页显示。
分页规范:
- 每页条数:支持 10/20/50/100 条选项
- 页码跳转:支持输入页码直接跳转
- 显示信息:显示「共 X 条记录,第 Y/Z 页」
#### Scenario: 分页导航
- **WHEN** 任务数量超过每页显示条数
- **THEN** 表格底部显示分页组件
- **AND** 用户可以切换页码
- **AND** 用户可以切换每页条数
### Requirement: 自动状态轮询
数字人任务列表 SHALL 自动轮询正在运行的任务状态。
轮询规范:
- 轮询间隔5 秒
- 轮询范围:只轮询 status 为 pending 或 running 的任务
- 页面隐藏:暂停轮询
- 组件销毁:停止轮询
#### Scenario: 自动轮询任务状态
- **WHEN** 页面显示且有待处理/处理中的任务
- **THEN** 每 5 秒发起一次 API 请求
- **AND** 获取任务最新状态
- **AND** 更新页面显示
#### Scenario: 页面隐藏时暂停轮询
- **WHEN** 用户切换到其他页面或最小化浏览器
- **THEN** 暂停状态轮询
- **AND** 页面重新可见时恢复轮询
#### Scenario: 任务完成时停止轮询
- **WHEN** 轮询发现任务状态变为 success/failed/canceled
- **THEN** 从轮询列表中移除该任务
- **AND** 当所有任务都完成时,停止轮询
### Requirement: API 集成
数字人任务列表 SHALL 集成以下 API
API 端点:
- `getDigitalHumanTaskPage`:分页获取任务列表
- `getDigitalHumanTask`:获取任务详情
- `cancelTask`:取消任务
- `retryTask`:重试任务
- `deleteTask`:删除任务
#### Scenario: 加载任务列表
- **WHEN** 页面初始加载或筛选条件变化
- **THEN** 调用 `getDigitalHumanTaskPage(params)`
- **AND** 解析返回数据并更新表格显示
#### Scenario: 获取任务详情
- **WHEN** 用户点击预览按钮
- **THEN** 调用 `getDigitalHumanTask(taskId)`
- **AND** 根据返回数据显示预览内容
#### Scenario: 取消任务
- **WHEN** 用户点击取消按钮
- **THEN** 调用 `cancelTask(taskId)`
- **AND** 更新任务状态为 canceled
- **AND** 停止该任务的轮询
#### Scenario: 重试任务
- **WHEN** 用户点击重试按钮
- **THEN** 调用 `retryTask(taskId)`
- **AND** 更新任务状态为 pending
- **AND** 重新开始轮询
#### Scenario: 删除任务
- **WHEN** 用户确认删除任务
- **THEN** 调用 `deleteTask(taskId)`
- **AND** 从列表中移除该任务
- **AND** 停止该任务的轮询
### Requirement: 数据模型映射
数字人任务列表 SHALL 使用以下数据模型:
数据模型(基于 `TikDigitalHumanTaskDO`
```typescript
interface DigitalHumanTask {
id: number // 任务ID
taskName: string // 任务名称
videoFileId: number // 视频文件ID
videoUrl: string // 视频文件URL
inputText: string // 输入文本
voiceId: string // 音色ID
speechRate: number // 语速
emotion?: string // 情感(可选)
instruction?: string // 指令(可选)
status: string // 任务状态
progress: number // 进度百分比
currentStep?: string // 当前步骤(可选)
resultVideoUrl?: string // 结果视频URL可选
errorMessage?: string // 错误信息(可选)
createTime: string // 创建时间
finishTime?: string // 完成时间(可选)
}
```
#### Scenario: 映射 API 数据
- **WHEN** API 返回任务数据
- **THEN** 将数据映射为本地数据模型
- **AND** 处理可选字段的空值情况
- **AND** 格式化时间字段
### Requirement: 错误处理
数字人任务列表 SHALL 提供完善的错误处理机制。
错误处理规范:
- API 调用失败:显示错误提示和重试按钮
- 网络异常:显示网络异常提示
- 操作失败:显示具体错误信息
- 空数据状态:显示「暂无数据」提示
#### Scenario: API 调用失败
- **WHEN** 获取任务列表时 API 返回错误
- **THEN** 显示错误提示信息
- **AND** 提供「重试」按钮
- **AND** 用户点击重试后重新发起请求
#### Scenario: 网络异常
- **WHEN** 网络连接中断
- **THEN** 显示网络异常提示
- **AND** 自动检测网络恢复
- **AND** 网络恢复后提示用户刷新页面
#### Scenario: 操作失败
- **WHEN** 执行任务操作时失败
- **THEN** 显示具体错误信息
- **AND** 提供重试选项
- **AND** 不关闭对话框(如果适用)
#### Scenario: 空数据状态
- **WHEN** 任务列表为空
- **THEN** 显示「暂无数字人任务」提示
- **AND** 提供「去创建」按钮(如适用)
### Requirement: 加载状态显示
数字人任务列表 SHALL 显示适当的加载状态。
加载状态规范:
- 初始加载:显示骨架屏或加载动画
- 数据刷新:显示表格 loading 状态
- 操作进行:显示按钮 loading 状态
#### Scenario: 初始加载状态
- **WHEN** 页面首次加载
- **THEN** 显示骨架屏或加载动画
- **AND** 加载完成后显示实际内容
#### Scenario: 数据刷新状态
- **WHEN** 筛选条件变化或分页切换
- **THEN** 表格显示 loading 状态
- **AND** 加载完成后更新表格数据
#### Scenario: 操作进行状态
- **WHEN** 用户执行操作(取消、重试、删除)
- **THEN** 对应的按钮显示 loading 状态
- **AND** 操作完成后恢复正常状态
### Requirement: 响应式适配
数字人任务列表 SHALL 支持响应式设计。
适配规范:
- 桌面端:显示所有列
- 平板端:隐藏部分次要列
- 移动端:使用卡片布局或横向滚动
#### Scenario: 平板端适配
- **WHEN** 在平板设备上访问任务列表
- **THEN** 隐藏「视频文件」和「音色」列
- **AND** 保留核心列ID、任务名称、状态、进度、操作
#### Scenario: 移动端适配
- **WHEN** 在手机设备上访问任务列表
- **THEN** 使用卡片布局显示任务信息
- **AND** 每个卡片包含任务的核心信息和操作按钮
- **OR** 表格使用横向滚动显示所有列
### Requirement: 性能优化
数字人任务列表 SHALL 实施性能优化措施。
优化措施:
- 搜索防抖:搜索输入 300ms 后执行
- 虚拟滚动:数据量 > 1000 条时启用
- 内存管理:及时清理定时器和事件监听器
- 图片懒加载:视频缩略图懒加载
#### Scenario: 搜索防抖
- **WHEN** 用户在搜索框输入内容
- **THEN** 等待 300ms 无输入后执行搜索
- **AND** 避免频繁的 API 调用
#### Scenario: 虚拟滚动
- **WHEN** 任务列表数据量超过 1000 条
- **THEN** 启用虚拟滚动功能
- **AND** 只渲染可见区域的行
- **AND** 提升大数据量时的渲染性能

View File

@@ -0,0 +1,115 @@
## MODIFIED Requirements
### Requirement: 任务列表页面路径
混剪任务管理系统 SHALL 将混剪任务列表页面路径从 `/material/mix-task` 变更为 `/system/task-management/mix-task`
#### Scenario: 访问混剪任务列表
- **WHEN** 用户访问 `/system/task-management/mix-task`
- **THEN** 显示混剪任务列表页面
- **AND** 左侧导航中「混剪视频任务」项高亮
### Requirement: 页面布局结构调整
混剪任务列表页面 SHALL 使用任务中心的子页面布局,不再包含独立的顶部标题栏。
#### Scenario: 显示混剪任务列表
- **WHEN** 用户在任务中心访问混剪任务列表
- **THEN** 页面不显示独立的标题栏
- **AND** 页面内容适配任务中心的右侧内容区域
### Requirement: 组件导入路径优化
混剪任务列表页面 SHALL 使用 `@/` 别名路径导入组件和 API。
#### Scenario: 导入通用组件
- **WHEN** 混剪任务列表需要使用通用组件
- **THEN** 使用 `@/views/task-management/components/ComponentName.vue` 导入
- **AND** 不再使用 `../../` 等相对路径
### Requirement: 筛选栏组件化
混剪任务列表 SHALL 将筛选栏抽取为独立组件 `TaskFilterBar.vue`
#### Scenario: 使用筛选栏组件
- **WHEN** 渲染混剪任务列表页面
- **THEN** 使用 `<TaskFilterBar />` 组件显示筛选条件
- **AND** 组件支持 v-model 双向绑定
### Requirement: 状态标签组件化
混剪任务列表 SHALL 将状态显示抽取为独立组件 `TaskStatusTag.vue`
#### Scenario: 显示任务状态
- **WHEN** 渲染任务列表中的状态列
- **THEN** 使用 `<TaskStatusTag :status="task.status" />` 组件
- **AND** 组件根据状态值显示不同颜色的标签
### Requirement: 操作按钮组件化
混剪任务列表 SHALL 将操作按钮抽取为独立组件 `TaskActionButtons.vue`
#### Scenario: 显示任务操作按钮
- **WHEN** 渲染任务列表中的操作列
- **THEN** 使用 `<TaskActionButtons :task="task" />` 组件
- **AND** 组件根据任务状态显示不同的操作按钮
### Requirement: Composable 逻辑复用
混剪任务列表 SHALL 使用 Composable 抽取通用逻辑。
#### Scenario: 使用 useTaskList
- **WHEN** 混剪任务列表需要加载数据
- **THEN** 调用 `useTaskList(fetchApi)`
- **AND** 使用返回的数据和方法渲染页面
### Requirement: API 调用保持不变
混剪任务列表 SHALL 继续使用 `MixTaskService` 调用后端 API。
#### Scenario: 获取混剪任务列表
- **WHEN** 页面需要加载任务列表
- **THEN** 调用 `MixTaskService.getTaskPage(params)`
### Requirement: 功能完整性保持
混剪任务列表 SHALL 保持所有现有功能。
#### Scenario: 所有功能正常工作
- **WHEN** 用户使用混剪任务列表
- **THEN** 筛选、搜索、分页、操作功能正常
- **AND** 状态轮询机制正常
- **AND** 错误处理机制正常
### Requirement: 路由元信息配置
混剪任务列表页面 SHALL 通过路由 meta 信息设置页面标题。
#### Scenario: 设置页面标题
- **WHEN** 用户访问混剪任务列表页面
- **THEN** 浏览器标题栏显示「混剪任务」
### Requirement: 性能优化实施
混剪任务列表 SHALL 实施性能优化措施。
#### Scenario: 性能优化实施
- **WHEN** 任务列表渲染大量数据
- **THEN** 使用防抖处理搜索输入
- **AND** 页面隐藏时暂停轮询
### Requirement: 向后兼容支持
混剪任务列表 SHALL 提供向后兼容方案。
#### Scenario: 兼容旧路径
- **WHEN** 用户访问旧路径 `/material/mix-task`
- **THEN** 系统重定向到 `/system/task-management/mix-task`
### Requirement: 测试覆盖实施
混剪任务列表 SHALL 实施完整的测试覆盖。
#### Scenario: 编写测试用例
- **WHEN** 混剪任务列表页面重构完成
- **THEN** 编写组件渲染测试、API调用测试、用户交互测试

View File

@@ -0,0 +1,179 @@
## ADDED Requirements
### Requirement: 任务中心布局
任务管理系统 SHALL 提供统一的左右分栏布局,用于管理不同类型的任务。
布局规范:
- 左侧导航区域:宽度固定为 240px显示任务类型切换菜单
- 右侧内容区域:自适应宽度,显示对应的任务列表页面
- 左侧导航 SHALL 支持以下任务类型:
- 混剪视频任务
- 数字人视频任务
#### Scenario: 显示任务中心布局
- **WHEN** 用户访问 `/system/task-management` 路径
- **THEN** 页面显示左右分栏布局
- **AND** 左侧显示任务类型导航菜单
- **AND** 右侧显示默认的任务列表(混剪视频任务)
#### Scenario: 切换任务类型
- **WHEN** 用户点击左侧导航中的「数字人视频任务」
- **THEN** 右侧内容区域切换到数字人任务列表页面
- **AND** 左侧导航中「数字人视频任务」项高亮显示
### Requirement: 路由配置
任务中心 SHALL 使用 Vue Router 的子路由机制,实现不同任务类型页面的切换。
路由规范:
- 根路径:`/system/task-management`
- 子路径:
- `/system/task-management/mix-task` - 混剪任务列表
- `/system/task-management/digital-human-task` - 数字人任务列表
- 默认重定向:访问 `/system/task-management` 时自动跳转到 `/system/task-management/mix-task`
#### Scenario: 默认路由跳转
- **WHEN** 用户访问 `/system/task-management`
- **THEN** 系统自动重定向到 `/system/task-management/mix-task`
- **AND** 显示混剪任务列表页面
#### Scenario: 直接访问子路径
- **WHEN** 用户直接访问 `/system/task-management/digital-human-task`
- **THEN** 显示数字人任务列表页面
- **AND** 左侧导航中「数字人视频任务」项高亮
### Requirement: 导航高亮
左侧导航 SHALL 高亮显示当前激活的任务类型。
高亮规范:
- 当前激活的导航项 SHALL 使用主色调背景色(`var(--color-primary)`
- 非激活项 SHALL 使用默认背景色
- 鼠标悬停时 SHALL 显示悬停效果
#### Scenario: 高亮当前任务类型
- **WHEN** 用户在混剪任务列表页面
- **THEN** 左侧导航中「混剪视频任务」项高亮显示
- **AND** 「数字人视频任务」项保持默认状态
### Requirement: 响应式适配
任务中心布局 SHALL 支持响应式设计,在不同屏幕尺寸下正常显示。
适配规范:
- 桌面端≥1200px左侧 240px右侧自适应
- 平板端768px-1199px保持左右分栏适当缩小左侧宽度
- 移动端(<768px左侧导航可折叠或隐藏右侧全屏显示
#### Scenario: 平板端显示
- **WHEN** 用户在平板设备上访问任务中心
- **THEN** 左侧导航宽度调整为 200px
- **AND** 右侧内容区域相应调整宽度
#### Scenario: 移动端显示
- **WHEN** 用户在手机设备上访问任务中心
- **THEN** 左侧导航默认隐藏
- **AND** 显示汉堡菜单按钮,点击后弹出导航菜单
- **OR** 左侧导航固定在底部,作为标签栏显示
### Requirement: 过渡动画
任务类型切换时 SHALL 使用平滑的过渡动画。
动画规范:
- 使用 Vue Transition 组件实现
- 动画时长200-300ms
- 动画类型淡入淡出fade或滑动slide
#### Scenario: 页面切换动画
- **WHEN** 用户从混剪任务切换到数字人任务
- **THEN** 右侧内容区域使用平滑过渡动画
- **AND** 动画时长约 250ms
- **AND** 动画效果为淡入淡出
### Requirement: 组件化设计
任务中心 SHALL 采用组件化设计,提高代码复用性和可维护性。
组件规范:
- Layout 组件:`TaskLayout.vue` - 布局容器
- 通用组件:
- `TaskFilterBar.vue` - 筛选栏
- `TaskStatusTag.vue` - 状态标签
- `TaskActionButtons.vue` - 操作按钮
- Composable
- `useTaskList.js` - 列表通用逻辑
- `useTaskOperations.js` - 操作通用逻辑
- `useTaskPolling.js` - 轮询通用逻辑
#### Scenario: 使用通用组件
- **WHEN** 开发混剪任务列表页面
- **THEN** 使用 `TaskFilterBar` 组件实现筛选功能
- **AND** 使用 `TaskStatusTag` 组件显示任务状态
- **AND** 使用 `TaskActionButtons` 组件实现操作按钮
- **AND** 使用 `useTaskList` Composable 处理列表逻辑
### Requirement: 状态管理
任务中心 SHALL 使用组合式 APIComposition API进行状态管理避免全局状态污染。
状态管理规范:
- 每个任务列表页面独立管理自己的状态
- 使用 `ref``reactive` 管理响应式数据
- 组件销毁时清理所有副作用(定时器、事件监听器等)
#### Scenario: 独立状态管理
- **WHEN** 用户在混剪任务列表页面进行操作
- **THEN** 操作只影响混剪任务列表的状态
- **AND** 不影响数字人任务列表的状态
#### Scenario: 清理副作用
- **WHEN** 用户离开任务中心页面
- **THEN** 所有定时器 SHALL 被清理
- **AND** 所有事件监听器 SHALL 被移除
- **AND** 避免内存泄漏
### Requirement: 错误处理
任务中心 SHALL 提供完善的错误处理机制,提升用户体验。
错误处理规范:
- API 调用失败时显示错误提示
- 网络异常时显示重试按钮
- 操作失败时显示具体错误信息
- 加载状态使用骨架屏或加载动画
#### Scenario: API 调用失败
- **WHEN** 获取任务列表时 API 返回错误
- **THEN** 显示错误提示信息
- **AND** 提供「重试」按钮
- **AND** 用户点击重试后重新发起请求
#### Scenario: 网络异常
- **WHEN** 网络连接中断
- **THEN** 显示网络异常提示
- **AND** 自动检测网络恢复
- **AND** 网络恢复后提示用户刷新页面
### Requirement: 无障碍访问
任务中心 SHALL 遵循 Web 无障碍访问标准,支持键盘导航和屏幕阅读器。
无障碍规范:
- 所有交互元素支持键盘访问Tab 键导航)
- 提供适当的 ARIA 标签
- 颜色对比度符合 WCAG 2.1 AA 标准
- 焦点状态清晰可见
#### Scenario: 键盘导航
- **WHEN** 用户使用 Tab 键浏览任务中心页面
- **THEN** 焦点 SHALL 按逻辑顺序移动
- **AND** 所有交互元素都可以通过键盘访问
- **AND** 焦点状态清晰可见
#### Scenario: 屏幕阅读器支持
- **WHEN** 用户使用屏幕阅读器访问任务中心
- **THEN** 页面结构 SHALL 被正确朗读
- **AND** 任务状态 SHALL 有适当的 ARIA 标签
- **AND** 操作按钮 SHALL 有描述性的文本