Files
crawler-plugin/docs/plans/admin-front-vue/04-asin-data-center.md
T
huangzd1997 b404fd2572 docs(仓库): 规划文档改为入库,落盘品牌库/去重库每公司一套二期方案
`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」,
代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红),
跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
2026-10-04 13:51:16 +08:00

61 KiB
Raw Blame History

04-asin-data-center:ASIN 数据中心任务计划

对应 Spec:docs/specs/04-asin-data-center.md。本文件是“ASIN 数据中心”的独立执行计划,任务必须按编号串行完成。

模块范围

  • 当前实现基线:panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader。
  • 目标实现边界:src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型。
  • 默认验证命令:cd admin-frontend-vue; npm test、npm run build;导入导出任务增加真实 Java API 验证。
  • 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。

模块依赖

  • 本模块任务范围:61-80。
  • 前置依赖:任务 60;跨模块依赖必须以总计划中的完成状态为准。
  • 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。

统一测试与准出规则

每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。

任务 61:定义 ASIN 中心共享分页和筛选类型

所属模块:ASIN 数据中心
依赖:60
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

为“定义 ASIN 中心共享分页和筛选类型”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 范围内,不能用无类型大对象掩盖边界。

测试用例(必须先写,确认 RED)

  1. test_task_061_define_asin_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_061_define_asin_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_061_define_asin_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_061_define_asin_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_061_define_asin_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_061_define_asin_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_061_define_asin_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_061_define_asin_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-61.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 62:实现去重汇总列表查询

所属模块:ASIN 数据中心
依赖:61
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现去重汇总列表查询”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_062_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_062_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_062_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_062_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_062_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_062_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_062_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_062_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-62.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 63:实现去重汇总日期和国家筛选

所属模块:ASIN 数据中心
依赖:62
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现去重汇总日期和国家筛选”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_063_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_063_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_063_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_063_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_063_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_063_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_063_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_063_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-63.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 64:实现去重汇总导出等待状态

所属模块:ASIN 数据中心
依赖:63
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现去重汇总导出等待状态”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_064_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_064_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_064_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_064_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_064_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_064_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_064_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_064_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-64.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 65:实现去重汇总导入任务创建

所属模块:ASIN 数据中心
依赖:64
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现去重汇总导入任务创建”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_065_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_065_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_065_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_065_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_065_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_065_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_065_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_065_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-65.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 66:实现去重汇总导入轮询和终态

所属模块:ASIN 数据中心
依赖:65
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现去重汇总导入轮询和终态”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_066_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_066_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_066_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_066_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_066_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_066_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_066_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_066_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-66.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 67:实现去重汇总删除导入流程

所属模块:ASIN 数据中心
依赖:66
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现去重汇总删除导入流程”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_067_implementremove_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_067_implementremove_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_067_implementremove_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_067_implementremove_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_067_implementremove_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_067_implementremove_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_067_implementremove_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_067_implementremove_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-67.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 68:实现品牌数据库列表查询

所属模块:ASIN 数据中心
依赖:67
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现品牌数据库列表查询”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_068_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_068_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_068_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_068_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_068_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_068_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_068_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_068_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-68.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 69:实现品牌数据库新增/编辑表单

所属模块:ASIN 数据中心
依赖:68
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现品牌数据库新增/编辑表单”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_069_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_069_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_069_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_069_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_069_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_069_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_069_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_069_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-69.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 70:实现品牌数据库删除确认

所属模块:ASIN 数据中心
依赖:69
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现品牌数据库删除确认”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_070_implementremoveconfirm_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_070_implementremoveconfirm_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_070_implementremoveconfirm_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_070_implementremoveconfirm_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_070_implementremoveconfirm_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_070_implementremoveconfirm_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_070_implementremoveconfirm_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_070_implementremoveconfirm_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-70.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 71:实现查询 ASIN 列表和筛选

所属模块:ASIN 数据中心
依赖:70
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现查询 ASIN 列表和筛选”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_071_implement_asin_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_071_implement_asin_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_071_implement_asin_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_071_implement_asin_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_071_implement_asin_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_071_implement_asin_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_071_implement_asin_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_071_implement_asin_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-71.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 72:实现查询 ASIN 导入与轮询

所属模块:ASIN 数据中心
依赖:71
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现查询 ASIN 导入与轮询”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_072_implement_asin_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_072_implement_asin_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_072_implement_asin_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_072_implement_asin_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_072_implement_asin_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_072_implement_asin_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_072_implement_asin_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_072_implement_asin_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-72.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 73:实现查询 ASIN 删除导入

所属模块:ASIN 数据中心
依赖:72
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现查询 ASIN 删除导入”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_073_implement_asin_remove_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_073_implement_asin_remove_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_073_implement_asin_remove_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_073_implement_asin_remove_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_073_implement_asin_remove_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_073_implement_asin_remove_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_073_implement_asin_remove_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_073_implement_asin_remove_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-73.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 74:实现查询 ASIN 详情抽屉

所属模块:ASIN 数据中心
依赖:73
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现查询 ASIN 详情抽屉”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_074_implement_asin_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_074_implement_asin_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_074_implement_asin_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_074_implement_asin_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_074_implement_asin_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_074_implement_asin_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_074_implement_asin_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_074_implement_asin_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-74.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 75:实现最低价 ASIN 列表和筛选

所属模块:ASIN 数据中心
依赖:74
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现最低价 ASIN 列表和筛选”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_075_implement_asin_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_075_implement_asin_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_075_implement_asin_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_075_implement_asin_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_075_implement_asin_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_075_implement_asin_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_075_implement_asin_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_075_implement_asin_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-75.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 76:实现最低价 ASIN 导入与删除导入

所属模块:ASIN 数据中心
依赖:75
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现最低价 ASIN 导入与删除导入”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_076_implement_asin__remove_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_076_implement_asin__remove_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_076_implement_asin__remove_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_076_implement_asin__remove_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_076_implement_asin__remove_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_076_implement_asin__remove_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_076_implement_asin__remove_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_076_implement_asin__remove_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-76.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 77:实现最低价 ASIN 详情编辑抽屉

所属模块:ASIN 数据中心
依赖:76
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现最低价 ASIN 详情编辑抽屉”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_077_implement_asin_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_077_implement_asin_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_077_implement_asin_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_077_implement_asin_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_077_implement_asin_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_077_implement_asin_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_077_implement_asin_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_077_implement_asin_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-77.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 78:实现商品类目树加载和搜索

所属模块:ASIN 数据中心
依赖:77
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现商品类目树加载和搜索”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_078_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_078_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_078_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_078_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_078_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_078_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_078_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_078_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-78.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 79:实现商品类目新增/编辑/导出

所属模块:ASIN 数据中心
依赖:78
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“实现商品类目新增/编辑/导出”:以 src/pages/asin/ 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-dedupe-total-data、panel-invalid-asin-data、panel-query-asin、panel-skip-price-asin、panel-product-categories 及对应旧 admin.js loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

测试用例(必须先写,确认 RED)

  1. test_task_079_implement_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_079_implement_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_079_implement_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_079_implement_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_079_implement_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_079_implement_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_079_implement_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_079_implement_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-79.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

任务 80:完成 ASIN 数据中心真实流程验收

所属模块:ASIN 数据中心
依赖:79
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

完成“完成 ASIN 数据中心真实流程验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。

测试用例(必须先写,确认 RED)

  1. test_task_080_complete_asin_real_normal_primary_path — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
  2. test_task_080_complete_asin_real_normal_variant_input — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
  3. test_task_080_complete_asin_real_normal_repeated_operation_is_idempotent — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
  4. test_task_080_complete_asin_real_boundary_empty_input — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
  5. test_task_080_complete_asin_real_boundary_single_item — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
  6. test_task_080_complete_asin_real_boundary_limit_or_missing_field — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
  7. test_task_080_complete_asin_real_invalid_input_rejected — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
  8. test_task_080_complete_asin_real_dependency_failure_returns_actionable_message — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。

TDD 流程

  1. 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
  2. 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
  3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。

验证方法

在 admin-frontend-vue 执行 npm test -- tests/task-80.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。

准出标准

  • 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
  • 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
  • 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。

模块完成条件

  • 任务 61-80 全部按 TDD 流程完成并有对应 commit。
  • 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
  • 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。