# 02-session-menu-permission:登录态、菜单树与菜单级权限任务计划 > 对应 Spec:`docs/specs/02-session-menu-permission.md`。本文件是“登录态、菜单树与菜单级权限”的独立执行计划,任务必须按编号串行完成。 ## 模块范围 - 当前实现基线:`AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission`。 - 目标实现边界:`src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO。 - 默认验证命令:`cd admin-frontend-vue; npm test`;Java 契约任务使用 `cd backend-java; mvn test -Dtest=<测试类>`。 - 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。 ## 模块依赖 - 本模块任务范围:21-40。 - 前置依赖:任务 20;跨模块依赖必须以总计划中的完成状态为准。 - 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。 ## 统一测试与准出规则 每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。 ## 任务 21:定义 AdminUser 和 AdminMenuNode 类型契约 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:20 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 AdminUser 和 AdminMenuNode 类型契约”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_021_define_adminuser___adminmenunode_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_021_define_adminuser___adminmenunode_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_021_define_adminuser___adminmenunode_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_021_define_adminuser___adminmenunode_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_021_define_adminuser___adminmenunode_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_021_define_adminuser___adminmenunode_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_021_define_adminuser___adminmenunode_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_021_define_adminuser___adminmenunode_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-21.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 22:定义 API 响应解包和错误归一化规则 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:21 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 API 响应解包和错误归一化规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_022_define_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_022_define_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_022_define_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_022_define_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_022_define_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_022_define_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_022_define_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_022_define_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-22.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 23:实现当前用户请求适配 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:22 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现当前用户请求适配”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_023_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_023_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_023_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_023_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_023_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_023_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_023_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_023_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-23.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 24:实现菜单树请求适配 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:23 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现菜单树请求适配”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_024_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_024_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_024_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_024_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_024_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_024_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_024_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_024_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-24.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 25:实现 Cookie/Session 请求配置 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:24 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现 Cookie/Session 请求配置”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_025_implement_cookie_session_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_025_implement_cookie_session_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_025_implement_cookie_session_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_025_implement_cookie_session_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_025_implement_cookie_session_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_025_implement_cookie_session_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_025_implement_cookie_session_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_025_implement_cookie_session_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-25.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 26:实现 401 登录跳转行为 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:25 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现 401 登录跳转行为”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_026_implement_401_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_026_implement_401_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_026_implement_401_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_026_implement_401_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_026_implement_401_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_026_implement_401_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_026_implement_401_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_026_implement_401_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-26.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 27:实现 Pinia admin-session store 初始状态 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:26 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现 Pinia admin-session store 初始状态”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_027_implement_pinia_admin_session_store_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_027_implement_pinia_admin_session_store_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_027_implement_pinia_admin_session_store_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_027_implement_pinia_admin_session_store_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_027_implement_pinia_admin_session_store_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_027_implement_pinia_admin_session_store_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_027_implement_pinia_admin_session_store_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_027_implement_pinia_admin_session_store_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-27.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 28:实现当前用户初始化动作 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:27 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现当前用户初始化动作”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_028_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_028_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_028_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_028_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_028_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_028_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_028_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_028_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-28.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 29:实现菜单树初始化动作 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:28 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现菜单树初始化动作”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_029_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_029_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_029_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_029_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_029_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_029_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_029_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_029_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-29.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 30:实现初始化失败和重试状态 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:29 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现初始化失败和重试状态”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_030_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_030_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_030_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_030_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_030_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_030_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_030_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_030_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-30.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 31:实现超级管理员菜单判定 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:30 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现超级管理员菜单判定”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_031_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_031_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_031_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_031_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_031_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_031_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_031_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_031_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-31.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 32:实现普通用户菜单 key 查找 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:31 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现普通用户菜单 key 查找”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_032_implement_key_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_032_implement_key_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_032_implement_key_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_032_implement_key_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_032_implement_key_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_032_implement_key_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_032_implement_key_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_032_implement_key_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-32.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 33:实现路由菜单权限守卫 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:32 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现路由菜单权限守卫”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_033_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_033_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_033_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_033_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_033_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_033_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_033_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_033_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-33.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 34:实现无权限路由回退 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:33 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现无权限路由回退”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_034_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_034_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_034_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_034_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_034_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_034_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_034_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_034_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-34.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 35:实现无菜单用户状态 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:34 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现无菜单用户状态”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_035_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_035_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_035_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_035_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_035_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_035_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_035_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_035_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-35.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 36:实现退出登录和状态清理 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:35 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现退出登录和状态清理”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_036_implement_cleanup_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_036_implement_cleanup_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_036_implement_cleanup_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_036_implement_cleanup_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_036_implement_cleanup_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_036_implement_cleanup_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_036_implement_cleanup_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_036_implement_cleanup_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-36.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 37:实现菜单树父子关系校验 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:36 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现菜单树父子关系校验”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_037_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_037_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_037_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_037_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_037_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_037_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_037_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_037_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-37.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 38:实现菜单排序和空 route 处理 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:37 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现菜单排序和空 route 处理”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_038_implement__route_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_038_implement__route_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_038_implement__route_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_038_implement__route_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_038_implement__route_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_038_implement__route_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_038_implement__route_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_038_implement__route_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-38.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 39:验证后端树形响应兼容边界 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:38 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 对“验证后端树形响应兼容边界”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 与 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 的契约。 ### 测试用例(必须先写,确认 RED) 1. `test_task_039_verify_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_039_verify_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_039_verify_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_039_verify_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_039_verify_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_039_verify_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_039_verify_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_039_verify_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-39.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 40:完成真实登录态与权限路由 smoke 验收 **所属模块**:登录态、菜单树与菜单级权限 **依赖**:39 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 完成“完成真实登录态与权限路由 smoke 验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。 ### 测试用例(必须先写,确认 RED) 1. `test_task_040_completereal__smoke_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_040_completereal__smoke_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_040_completereal__smoke_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_040_completereal__smoke_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_040_completereal__smoke_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_040_completereal__smoke_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_040_completereal__smoke_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_040_completereal__smoke_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 在 `admin-frontend-vue` 执行 `npm test -- tests/task-40.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 模块完成条件 - 任务 21-40 全部按 TDD 流程完成并有对应 commit。 - 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。 - 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。