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

2.7 KiB
Raw Permalink Blame History

数据集管理“数据任务”Mock 数据设计

目标

让数据集管理页的“数据任务”页签展示可用于界面演示的任务产出数据, 同时保持“本地上传”页签、数据集预览和下载入口的现有行为。

现状

  • 数据集列表统一从 mockDatasets 获取。
  • “本地上传”页签当前展示全部数据集。
  • “数据任务”页签固定返回空数组,因此始终为空。
  • 数据集详情、预览和下载均基于同一套 Mock 数据接口。

方案比较

  1. 为数据集增加来源字段并统一过滤(采用)。单一数据源,页签语义清晰, 新增的任务数据可继续复用详情、预览和下载接口。
  2. 在列表页内单独维护任务数据。改动较少,但会形成第二份数据源,详情接口 无法自然找到这些记录。
  3. 从数据处理任务动态生成数据集。数据关联更强,但需要重构任务 Mock 数据, 超出本次只增加演示数据的范围。

数据设计

  • DatasetItem 中增加可选来源字段 source,取值为 uploadtask
  • 现有 6 条 Mock 数据明确标记为 upload
  • 新增 4 条来源为 task 的 Mock 数据,覆盖训练集、评测集等类型,包含名称、 存储位置、大小、条数、描述和创建时间。
  • 新记录使用不重复的 ID并保留现有 Mock 适配器的统一查询路径。

页面行为

  • “本地上传”仅展示 source !== 'task' 的数据,兼容后端暂未返回来源字段的情况。
  • “数据任务”仅展示 source === 'task' 的数据。
  • 搜索、分页、预览、下载和删除按钮保持现有行为。
  • 切换页签后,公共列表组件会在数据变化时回到第一页并清空选中状态。

异常与边界

  • 未携带 source 的真实接口数据默认归入“本地上传”,避免升级期间数据消失。
  • 任务数据 ID 不与现有数据冲突,详情查询仍能返回对应记录。
  • 本次不新增依赖,不修改后端接口,不实现真实的数据任务关联。

验证

  • 先添加一个能验证来源字段和页签过滤规则的回归检查,再实现变更。
  • 运行项目类型检查与生产构建;若存在仓库原有错误,需确认本次改动文件没有 引入新的错误。
  • 启动页面后检查两个页签:本地上传显示 6 条,数据任务显示 4 条,任务数据可被 搜索且表格字段完整。

验收标准

  1. “数据任务”页签展示 4 条假数据。
  2. “本地上传”页签不混入任务生成的数据。
  3. 两个页签的搜索、分页和操作列正常显示。
  4. 新增类型定义与 Mock 数据通过针对性回归检查。