Files
YG_FT/docs/superpowers/specs/2026-07-10-dataset-task-mock-data-design.md
2026-07-27 09:12:47 +08:00

59 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 数据集管理“数据任务”Mock 数据设计
## 目标
让数据集管理页的“数据任务”页签展示可用于界面演示的任务产出数据,
同时保持“本地上传”页签、数据集预览和下载入口的现有行为。
## 现状
- 数据集列表统一从 `mockDatasets` 获取。
- “本地上传”页签当前展示全部数据集。
- “数据任务”页签固定返回空数组,因此始终为空。
- 数据集详情、预览和下载均基于同一套 Mock 数据接口。
## 方案比较
1. 为数据集增加来源字段并统一过滤(采用)。单一数据源,页签语义清晰,
新增的任务数据可继续复用详情、预览和下载接口。
2. 在列表页内单独维护任务数据。改动较少,但会形成第二份数据源,详情接口
无法自然找到这些记录。
3. 从数据处理任务动态生成数据集。数据关联更强,但需要重构任务 Mock 数据,
超出本次只增加演示数据的范围。
## 数据设计
-`DatasetItem` 中增加可选来源字段 `source`,取值为 `upload``task`
- 现有 6 条 Mock 数据明确标记为 `upload`
- 新增 4 条来源为 `task` 的 Mock 数据,覆盖训练集、评测集等类型,包含名称、
存储位置、大小、条数、描述和创建时间。
- 新记录使用不重复的 ID并保留现有 Mock 适配器的统一查询路径。
## 页面行为
- “本地上传”仅展示 `source !== 'task'` 的数据,兼容后端暂未返回来源字段的情况。
- “数据任务”仅展示 `source === 'task'` 的数据。
- 搜索、分页、预览、下载和删除按钮保持现有行为。
- 切换页签后,公共列表组件会在数据变化时回到第一页并清空选中状态。
## 异常与边界
- 未携带 `source` 的真实接口数据默认归入“本地上传”,避免升级期间数据消失。
- 任务数据 ID 不与现有数据冲突,详情查询仍能返回对应记录。
- 本次不新增依赖,不修改后端接口,不实现真实的数据任务关联。
## 验证
- 先添加一个能验证来源字段和页签过滤规则的回归检查,再实现变更。
- 运行项目类型检查与生产构建;若存在仓库原有错误,需确认本次改动文件没有
引入新的错误。
- 启动页面后检查两个页签:本地上传显示 6 条,数据任务显示 4 条,任务数据可被
搜索且表格字段完整。
## 验收标准
1. “数据任务”页签展示 4 条假数据。
2. “本地上传”页签不混入任务生成的数据。
3. 两个页签的搜索、分页和操作列正常显示。
4. 新增类型定义与 Mock 数据通过针对性回归检查。