From f5b1873ee5f37f3072e588dc1c0583e45b0987cd Mon Sep 17 00:00:00 2001 From: caoxiaozhu Date: Fri, 10 Jul 2026 17:01:12 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=BE=E8=AE=A1=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E4=BB=BB=E5=8A=A1=20mock=20=E6=95=B0=E6=8D=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...026-07-10-dataset-task-mock-data-design.md | 58 +++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 docs/superpowers/specs/2026-07-10-dataset-task-mock-data-design.md diff --git a/docs/superpowers/specs/2026-07-10-dataset-task-mock-data-design.md b/docs/superpowers/specs/2026-07-10-dataset-task-mock-data-design.md new file mode 100644 index 0000000..17fb413 --- /dev/null +++ b/docs/superpowers/specs/2026-07-10-dataset-task-mock-data-design.md @@ -0,0 +1,58 @@ +# 数据集管理“数据任务”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 数据通过针对性回归检查。