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

767 lines
58 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。