Files
crawler-plugin/docs/plans/admin-front-vue/08-java-menu-and-flyway.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
60 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.
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。