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

58 KiB
Raw Blame History

12-testing-acceptance:测试、回归与最终验收任务计划

对应 Spec:docs/specs/12-testing-acceptance.md。本文件是“测试、回归与最终验收”的独立执行计划,任务必须按编号串行完成。

模块范围

  • 当前实现基线:所有前置模块的测试、构建、部署和真实 HTTP 产物。
  • 目标实现边界:独立后台前端测试门禁、Java 契约门禁、Nginx/Playwright smoke、最终 check_progress。
  • 默认验证命令:npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py。
  • 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。

模块依赖

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

统一测试与准出规则

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

任务 221:建立独立后台前端测试命令

所属模块:测试、回归与最终验收
依赖:220
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立独立后台前端测试命令”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 222:建立后台前端类型检查门禁

所属模块:测试、回归与最终验收
依赖:221
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立后台前端类型检查门禁”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 223:建立后台前端构建门禁

所属模块:测试、回归与最终验收
依赖:222
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立后台前端构建门禁”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 224:真实启动 Java 后端并验证健康检查

所属模块:测试、回归与最终验收
依赖:223
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

使用真实运行环境执行“真实启动 Java 后端并验证健康检查”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 225:真实访问 /admin 与 /admin-vue 页面入口

所属模块:测试、回归与最终验收
依赖:224
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

使用真实运行环境执行“真实访问 /admin 与 /admin-vue 页面入口”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 226:真实执行首批菜单加载与用户查询交互

所属模块:测试、回归与最终验收
依赖:225
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

使用真实运行环境执行“真实执行首批菜单加载与用户查询交互”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 227:建立菜单树转换和权限守卫测试夹具

所属模块:测试、回归与最终验收
依赖:226
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立菜单树转换和权限守卫测试夹具”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 228:建立 Session 初始化、401 和退出登录测试夹具

所属模块:测试、回归与最终验收
依赖:227
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立 Session 初始化、401 和退出登录测试夹具”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 229:建立账号权限页面 API 与表单回归测试

所属模块:测试、回归与最终验收
依赖:228
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立账号权限页面 API 与表单回归测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 230:建立 ASIN 数据中心 API 与导入导出回归测试

所属模块:测试、回归与最终验收
依赖:229
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立 ASIN 数据中心 API 与导入导出回归测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 231:建立店铺中心 API 与敏感字段回归测试

所属模块:测试、回归与最终验收
依赖:230
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立店铺中心 API 与敏感字段回归测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 232:建立任务中心、下载和重复检查回归测试

所属模块:测试、回归与最终验收
依赖:231
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立任务中心、下载和重复检查回归测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 233:真实验证 /api/version 与 /api/version/latest

所属模块:测试、回归与最终验收
依赖:232
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

使用真实运行环境执行“真实验证 /api/version 与 /api/version/latest”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 234:建立 Flyway 菜单迁移集成测试

所属模块:测试、回归与最终验收
依赖:233
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立 Flyway 菜单迁移集成测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 235:真实验证 Nginx History fallback、assets 和 404

所属模块:测试、回归与最终验收
依赖:234
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

使用真实运行环境执行“真实验证 Nginx History fallback、assets 和 404”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 236:建立 Playwright 核心交互、错误重试和响应式验收

所属模块:测试、回归与最终验收
依赖:235
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

建立“建立 Playwright 核心交互、错误重试和响应式验收”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 npm test、npm run build、mvn test、nginx -t、curl、Playwright 和 python check_progress.py 中运行,并能证明真实行为而非静态文本存在。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 237:运行全量测试并记录覆盖率门禁

所属模块:测试、回归与最终验收
依赖:236
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

执行“运行全量测试并记录覆盖率门禁”,必须运行完整的类型、测试、格式和真实依赖检查;失败时记录具体失败项并修复后再通过,不得只运行单个 happy path。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 238:运行 lint、format 和接口一致性检查

所属模块:测试、回归与最终验收
依赖:237
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

执行“运行 lint、format 和接口一致性检查”,必须运行完整的类型、测试、格式和真实依赖检查;失败时记录具体失败项并修复后再通过,不得只运行单个 happy path。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 239:验证每个任务均有对应 git commit 和 progress 状态

所属模块:测试、回归与最终验收
依赖:238
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

对“验证每个任务均有对应 git commit 和 progress 状态”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 所有前置模块的测试、构建、部署和真实 HTTP 产物 与 独立后台前端测试门禁、Java 契约门禁、Nginx/Playwright smoke、最终 check_progress 的契约。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

任务 240:执行最终发布验收并确认 check_progress 返回 all tasks done

所属模块:测试、回归与最终验收
依赖:239
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“执行最终发布验收并确认 check_progress 返回 all tasks done”:以 独立后台前端测试门禁、Java 契约门禁、Nginx/Playwright smoke、最终 check_progress 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 所有前置模块的测试、构建、部署和真实 HTTP 产物 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

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

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

TDD 流程

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

验证方法

执行 npm test、npm run build、mvn test、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。

准出标准

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

模块完成条件

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