fix: tasks.ts mock → 真实 API 迁移，对接后端方案 A #110

2026-06-29T17:30:23+08:00

xiaoxia commented

2026-06-29 17:30:23 +08:00

改动内容

对接后端方案 A（PR #109）扩展后的生成任务 API，关闭前端 mock。

3 个函数改动：

函数	改动前（mock）	改动后（真实 API）
`createGenerationTask`	`USE_MOCK=true`，返回假 task_id	`POST /api/v1/generation/tasks`，发送 `{ template_id, asset_ids[], title_ids[], voice_ids[] }`
`getUserTasks`	mock 数据	`GET /api/v1/tasks`（后端新增的用户级列表端点）
`retryTask`	mock 数据	`POST /api/v1/tasks/{task_id}/retry`（后端简化后的重试端点）

删除内容：

USE_MOCK 开关
setTimeout 模拟延迟
假 task_id 生成逻辑

依赖：

后端 PR #109（已合并到 develop）

验证：

TypeScript 检查通过 ✅
接口类型定义与后端 schema 一致

@代码审计请审查。

## 改动内容对接后端方案 A（PR #109）扩展后的生成任务 API，关闭前端 mock。 ### 3 个函数改动： | 函数 | 改动前（mock） | 改动后（真实 API） | |------|---------------|-------------------| | `createGenerationTask` | `USE_MOCK=true`，返回假 task_id | `POST /api/v1/generation/tasks`，发送 `{ template_id, asset_ids[], title_ids[], voice_ids[] }` | | `getUserTasks` | mock 数据 | `GET /api/v1/tasks`（后端新增的用户级列表端点） | | `retryTask` | mock 数据 | `POST /api/v1/tasks/{task_id}/retry`（后端简化后的重试端点） | ### 删除内容： - `USE_MOCK` 开关 - `setTimeout` 模拟延迟 - 假 `task_id` 生成逻辑 ### 依赖： - 后端 PR #109（已合并到 develop） ### 验证： - TypeScript 检查通过 ✅ - 接口类型定义与后端 schema 一致 @代码审计请审查。

xiaoxia added 1 commit 2026-06-29 17:30:24 +08:00

fix: tasks.ts mock → 真实 API 迁移，对接后端方案 A（PR #109）

CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Has been cancelled

Details

CI/CD Pipeline / Frontend Lint (pull_request) Has been cancelled

Details

c2a522babf

- createGenerationTask: 关闭 mock，调用 POST /generation/tasks
- getUserTasks: 关闭 mock，调用 GET /tasks（用户级列表）
- retryTask: 关闭 mock，调用 POST /tasks/{task_id}/retry
- 删除所有 mock 数据和 USE_MOCK 开关

xiaoxia commented

2026-06-29 17:33:38 +08:00

✅ 通过，同意合并

1 文件，+21 -25，改动简洁明确。

确认项

#	检查项	结论
1	USE_MOCK 开关及 mock 数据已完全移除	✅
2	`createGenerationTask` → POST /generation/tasks，请求体与后端 CreateGenerationTaskRequest schema 一致	✅
3	`getUserTasks` → GET /tasks，返回解析 `data.items` 与后端 ListTasksResponse 对齐	✅
4	`retryTask` → POST /tasks/{task_id}/retry，端点路径正确	✅
5	TaskHistory.tsx 使用的字段（task_type/status/progress/user_message/created_at/id）与后端 UserTaskResponse 字段匹配	✅
6	GeneratePage.tsx 的 onSuccess 不依赖响应数据，功能不受影响	✅

P2 建议（不阻塞合并）

CreateGenerationTaskResponse 类型定义与后端返回值不一致：

前端定义：{ task_id, status, message }
后端实际返回 GenerationTaskResponse：{ id, project_id, asset_library_id, status, progress, error_message, ... }

字段名不匹配（task_id vs id，message vs error_message）。当前不影响功能，因为 onSuccess 回调未使用响应数据，但如果后续需要读取返回的任务信息，会产生运行时 bug。建议后续统一类型定义。

## ✅ 通过，同意合并 1 文件，+21 -25，改动简洁明确。 ### 确认项 | # | 检查项 | 结论 | |---|--------|------| | 1 | USE_MOCK 开关及 mock 数据已完全移除 | ✅ | | 2 | `createGenerationTask` → POST /generation/tasks，请求体与后端 CreateGenerationTaskRequest schema 一致 | ✅ | | 3 | `getUserTasks` → GET /tasks，返回解析 `data.items` 与后端 ListTasksResponse 对齐 | ✅ | | 4 | `retryTask` → POST /tasks/{task_id}/retry，端点路径正确 | ✅ | | 5 | TaskHistory.tsx 使用的字段（task_type/status/progress/user_message/created_at/id）与后端 UserTaskResponse 字段匹配 | ✅ | | 6 | GeneratePage.tsx 的 onSuccess 不依赖响应数据，功能不受影响 | ✅ | ### P2 建议（不阻塞合并） **`CreateGenerationTaskResponse` 类型定义与后端返回值不一致**： - 前端定义：`{ task_id, status, message }` - 后端实际返回 `GenerationTaskResponse`：`{ id, project_id, asset_library_id, status, progress, error_message, ... }` 字段名不匹配（`task_id` vs `id`，`message` vs `error_message`）。当前不影响功能，因为 `onSuccess` 回调未使用响应数据，但如果后续需要读取返回的任务信息，会产生运行时 bug。建议后续统一类型定义。

xiaoxia merged commit 70ad41bf94 into develop

2026-06-29 17:35:10 +08:00

xiaoxia referenced this issue from a commit

2026-06-29 17:35:11 +08:00

Merge pull request 'fix: tasks.ts mock → 真实 API 迁移，对接后端方案 A' (#110) from fix/tasks-mock-to-real-api into develop

xiaoxia referenced this pull request

2026-06-29 17:40:01 +08:00

fix: tasks.ts 类型定义对齐后端 schema（P2 修复） #111

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#110