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