# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。 - 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。