# 08-java-menu-and-flyway:Java 菜单树与 Flyway 权限迁移任务计划 > 对应 Spec:`docs/specs/08-java-menu-and-flyway.md`。本文件是“Java 菜单树与 Flyway 权限迁移”的独立执行计划,任务必须按编号串行完成。 ## 模块范围 - 当前实现基线:`PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer`。 - 目标实现边界:Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移。 - 默认验证命令:`cd backend-java; mvn test`、`mvn -DskipTests compile`;数据库任务使用真实测试库/迁移集成测试。 - 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。 ## 模块依赖 - 本模块任务范围:141-160。 - 前置依赖:任务 140;跨模块依赖必须以总计划中的完成状态为准。 - 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。 ## 统一测试与准出规则 每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。 ## 任务 141:冻结 Java 菜单树响应 DTO **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:140 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 把 Java 菜单树响应 DTO 固化为可测试契约:定义合法输入、默认值、边界、错误语义和兼容约束;契约必须能被 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 直接消费,并明确禁止的旧行为。 ### 测试用例(必须先写,确认 RED) 1. `test_task_141_freeze_java__dto_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_141_freeze_java__dto_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_141_freeze_java__dto_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_141_freeze_java__dto_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_141_freeze_java__dto_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_141_freeze_java__dto_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_141_freeze_java__dto_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_141_freeze_java__dto_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task141Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 142:定义 menu_type=admin 过滤规则 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:141 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 menu_type=admin 过滤规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_142_define_menu_typeadmin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_142_define_menu_typeadmin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_142_define_menu_typeadmin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_142_define_menu_typeadmin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_142_define_menu_typeadmin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_142_define_menu_typeadmin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_142_define_menu_typeadmin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_142_define_menu_typeadmin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task142Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 143:实现有效菜单节点索引 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:142 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现有效菜单节点索引”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_143_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_143_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_143_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_143_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_143_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_143_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_143_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_143_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task143Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 144:实现 parent_id 树组装 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:143 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现 parent_id 树组装”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_144_implement_parent_id_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_144_implement_parent_id_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_144_implement_parent_id_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_144_implement_parent_id_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_144_implement_parent_id_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_144_implement_parent_id_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_144_implement_parent_id_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_144_implement_parent_id_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task144Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 145:实现菜单 sort_order 排序 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:144 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现菜单 sort_order 排序”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_145_implement_sort_order_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_145_implement_sort_order_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_145_implement_sort_order_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_145_implement_sort_order_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_145_implement_sort_order_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_145_implement_sort_order_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_145_implement_sort_order_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_145_implement_sort_order_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task145Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 146:实现空父节点和脏数据处理 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:145 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现空父节点和脏数据处理”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_146_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_146_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_146_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_146_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_146_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_146_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_146_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_146_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task146Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 147:实现分组节点 route 处理 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:146 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现分组节点 route 处理”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_147_implement_route_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_147_implement_route_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_147_implement_route_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_147_implement_route_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_147_implement_route_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_147_implement_route_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_147_implement_route_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_147_implement_route_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task147Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 148:实现页面节点 route 输出 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:147 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现页面节点 route 输出”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_148_implement_route_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_148_implement_route_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_148_implement_route_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_148_implement_route_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_148_implement_route_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_148_implement_route_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_148_implement_route_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_148_implement_route_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task148Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 149:实现 column_key 到 key 映射 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:148 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现 column_key 到 key 映射”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_149_implement_column_key__key_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_149_implement_column_key__key_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_149_implement_column_key__key_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_149_implement_column_key__key_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_149_implement_column_key__key_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_149_implement_column_key__key_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_149_implement_column_key__key_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_149_implement_column_key__key_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task149Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 150:实现当前用户菜单树控制器响应 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:149 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现当前用户菜单树控制器响应”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_150_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_150_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_150_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_150_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_150_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_150_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_150_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_150_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task150Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 151:覆盖超级管理员菜单树 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:150 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“覆盖超级管理员菜单树”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_151_feature_point_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_151_feature_point_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_151_feature_point_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_151_feature_point_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_151_feature_point_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_151_feature_point_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_151_feature_point_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_151_feature_point_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task151Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 152:覆盖普通管理员菜单树 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:151 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“覆盖普通管理员菜单树”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_152_feature_point_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_152_feature_point_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_152_feature_point_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_152_feature_point_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_152_feature_point_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_152_feature_point_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_152_feature_point_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_152_feature_point_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task152Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 153:覆盖无权限用户菜单树 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:152 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“覆盖无权限用户菜单树”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_153_feature_point_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_153_feature_point_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_153_feature_point_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_153_feature_point_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_153_feature_point_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_153_feature_point_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_153_feature_point_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_153_feature_point_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task153Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 154:定义 route_path Flyway 迁移矩阵 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:153 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 route_path Flyway 迁移矩阵”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_154_define_route_path_flyway_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_154_define_route_path_flyway_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_154_define_route_path_flyway_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_154_define_route_path_flyway_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_154_define_route_path_flyway_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_154_define_route_path_flyway_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_154_define_route_path_flyway_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_154_define_route_path_flyway_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task154Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 155:实现后台账号菜单 route 迁移 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:154 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现后台账号菜单 route 迁移”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_155_implement_route_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_155_implement_route_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_155_implement_route_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_155_implement_route_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_155_implement_route_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_155_implement_route_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_155_implement_route_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_155_implement_route_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task155Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 156:实现 ASIN 和店铺菜单 route 迁移 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:155 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现 ASIN 和店铺菜单 route 迁移”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_156_implement_asin___route_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_156_implement_asin___route_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_156_implement_asin___route_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_156_implement_asin___route_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_156_implement_asin___route_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_156_implement_asin___route_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_156_implement_asin___route_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_156_implement_asin___route_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task156Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 157:实现任务和记录菜单 route 迁移 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:156 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现任务和记录菜单 route 迁移”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_157_implement__route_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_157_implement__route_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_157_implement__route_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_157_implement__route_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_157_implement__route_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_157_implement__route_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_157_implement__route_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_157_implement__route_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task157Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 158:验证 column_key 和授权关系不变 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:157 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 对“验证 column_key 和授权关系不变”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 与 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 的契约。 ### 测试用例(必须先写,确认 RED) 1. `test_task_158_verify_column_key_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_158_verify_column_key_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_158_verify_column_key_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_158_verify_column_key_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_158_verify_column_key_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_158_verify_column_key_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_158_verify_column_key_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_158_verify_column_key_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task158Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 159:验证 Flyway 唯一约束和幂等性 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:158 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 对“验证 Flyway 唯一约束和幂等性”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 与 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 的契约。 ### 测试用例(必须先写,确认 RED) 1. `test_task_159_verify_flyway_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_159_verify_flyway_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_159_verify_flyway_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_159_verify_flyway_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_159_verify_flyway_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_159_verify_flyway_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_159_verify_flyway_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_159_verify_flyway_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task159Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 160:完成 Java 菜单树真实接口验收 **所属模块**:Java 菜单树与 Flyway 权限迁移 **依赖**:159 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 完成“完成 Java 菜单树真实接口验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。 ### 测试用例(必须先写,确认 RED) 1. `test_task_160_complete_java_real_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_160_complete_java_real_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_160_complete_java_real_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_160_complete_java_real_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_160_complete_java_real_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_160_complete_java_real_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_160_complete_java_real_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_160_complete_java_real_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `backend-java` 执行 `mvn -q -Dtest=Task160Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 模块完成条件 - 任务 141-160 全部按 TDD 流程完成并有对应 commit。 - 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。 - 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。