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

56 KiB
Raw Blame History

11-flask-removal-cutover:Flask 管理能力移除与入口切换任务计划

对应 Spec:docs/specs/11-flask-removal-cutover.md。本文件是“Flask 管理能力移除与入口切换”的独立执行计划,任务必须按编号串行完成。

模块范围

  • 当前实现基线:backend/blueprints/main.py、admin_api.py、version.py、旧 admin 模板/脚本和 Java static 副本。
  • 目标实现边界:Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口。
  • 默认验证命令:rg 依赖扫描、cd backend-java; mvn test、真实 Java/Nginx curl;Python 其他插件 API 需单独回归。
  • 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。

模块依赖

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

统一测试与准出规则

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

任务 201:盘点 Flask 管理页面和 API 流量

所属模块:Flask 管理能力移除与入口切换
依赖:200
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“盘点 Flask 管理页面和 API 流量”:以 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 backend/blueprints/main.py、admin_api.py、version.py、旧 admin 模板/脚本和 Java static 副本 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 202:盘点 Flask 版本接口调用方

所属模块:Flask 管理能力移除与入口切换
依赖:201
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“盘点 Flask 版本接口调用方”:以 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 backend/blueprints/main.py、admin_api.py、version.py、旧 admin 模板/脚本和 Java static 副本 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 203:冻结 Flask 删除清单

所属模块:Flask 管理能力移除与入口切换
依赖:202
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

把 Flask 删除清单 固化为可测试契约:定义合法输入、默认值、边界、错误语义和兼容约束;契约必须能被 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 直接消费,并明确禁止的旧行为。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 204:确认 Java 管理 API 覆盖矩阵

所属模块:Flask 管理能力移除与入口切换
依赖:203
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

检查 backend/blueprints/main.py、admin_api.py、version.py、旧 admin 模板/脚本和 Java static 副本 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口,不得修改无关模块。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 205:确认 Vue 页面覆盖矩阵

所属模块:Flask 管理能力移除与入口切换
依赖:204
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

检查 backend/blueprints/main.py、admin_api.py、version.py、旧 admin 模板/脚本和 Java static 副本 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口,不得修改无关模块。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 206:完成旧后台权限快照

所属模块:Flask 管理能力移除与入口切换
依赖:205
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

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

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 207:完成旧后台 API 响应快照

所属模块:Flask 管理能力移除与入口切换
依赖:206
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

完成“完成旧后台 API 响应快照”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 208:完成 Java 菜单树回归

所属模块:Flask 管理能力移除与入口切换
依赖:207
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

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

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 209:完成 Java 公开版本回归

所属模块:Flask 管理能力移除与入口切换
依赖:208
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

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

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 210:完成 Nginx /admin-vue 回归

所属模块:Flask 管理能力移除与入口切换
依赖:209
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

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

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 211:切换 /admin 到 /admin-vue

所属模块:Flask 管理能力移除与入口切换
依赖:210
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“切换 /admin 到 /admin-vue”:以 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 backend/blueprints/main.py、admin_api.py、version.py、旧 admin 模板/脚本和 Java static 副本 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 212:验证旧 admin 页面无生产流量

所属模块:Flask 管理能力移除与入口切换
依赖:211
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

对“验证旧 admin 页面无生产流量”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 backend/blueprints/main.py、admin_api.py、version.py、旧 admin 模板/脚本和 Java static 副本 与 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 的契约。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 213:停止 Flask 管理路由注册

所属模块:Flask 管理能力移除与入口切换
依赖:212
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

实现“停止 Flask 管理路由注册”:以 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 backend/blueprints/main.py、admin_api.py、version.py、旧 admin 模板/脚本和 Java static 副本 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 214:删除 Flask admin blueprint

所属模块:Flask 管理能力移除与入口切换
依赖:213
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

删除“ Flask admin blueprint”前先完成引用扫描和替代实现验证;删除后编译、测试和真实请求必须仍通过,且不能误删客户端更新接口或其他非后台 Flask API。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 215:删除 Flask 管理页面模板

所属模块:Flask 管理能力移除与入口切换
依赖:214
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

删除“ Flask 管理页面模板”前先完成引用扫描和替代实现验证;删除后编译、测试和真实请求必须仍通过,且不能误删客户端更新接口或其他非后台 Flask API。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 216:删除旧 admin.js 和 interactions.js

所属模块:Flask 管理能力移除与入口切换
依赖:215
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

删除“旧 admin.js 和 interactions.js”前先完成引用扫描和替代实现验证;删除后编译、测试和真实请求必须仍通过,且不能误删客户端更新接口或其他非后台 Flask API。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 217:删除 Java static 旧后台副本

所属模块:Flask 管理能力移除与入口切换
依赖:216
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

删除“ Java static 旧后台副本”前先完成引用扫描和替代实现验证;删除后编译、测试和真实请求必须仍通过,且不能误删客户端更新接口或其他非后台 Flask API。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 218:清理旧菜单扁平响应逻辑

所属模块:Flask 管理能力移除与入口切换
依赖:217
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

清理“旧菜单扁平响应逻辑”的残余引用、配置和文档,并用搜索、构建和真实请求证明目标链路只剩 Java + Vue + Nginx;对外兼容接口除外。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 219:清理部署和文档旧入口引用

所属模块:Flask 管理能力移除与入口切换
依赖:218
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

清理“部署和文档旧入口引用”的残余引用、配置和文档,并用搜索、构建和真实请求证明目标链路只剩 Java + Vue + Nginx;对外兼容接口除外。

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

任务 220:完成 Flask 管理移除后真实 HTTP 验收

所属模块:Flask 管理能力移除与入口切换
依赖:219
预估耗时:8-15 分钟(写测试 + 实现 + 自测)

功能点要求

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

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

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

TDD 流程

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

验证方法

执行 rg 引用扫描、Java mvn test 和目标服务真实 curl;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。

准出标准

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

模块完成条件

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