`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」, 代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红), 跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
60 KiB
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)
test_task_021_define_adminuser___adminmenunode_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_021_define_adminuser___adminmenunode_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_021_define_adminuser___adminmenunode_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_021_define_adminuser___adminmenunode_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_021_define_adminuser___adminmenunode_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_021_define_adminuser___adminmenunode_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_021_define_adminuser___adminmenunode_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_021_define_adminuser___adminmenunode_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_022_define_api_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_022_define_api_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_022_define_api_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_022_define_api_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_022_define_api_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_022_define_api_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_022_define_api_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_022_define_api_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_023_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_023_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_023_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_023_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_023_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_023_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_023_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_023_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_024_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_024_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_024_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_024_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_024_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_024_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_024_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_024_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_025_implement_cookie_session_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_025_implement_cookie_session_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_025_implement_cookie_session_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_025_implement_cookie_session_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_025_implement_cookie_session_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_025_implement_cookie_session_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_025_implement_cookie_session_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_025_implement_cookie_session_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_026_implement_401_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_026_implement_401_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_026_implement_401_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_026_implement_401_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_026_implement_401_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_026_implement_401_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_026_implement_401_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_026_implement_401_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_027_implement_pinia_admin_session_store_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_027_implement_pinia_admin_session_store_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_027_implement_pinia_admin_session_store_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_027_implement_pinia_admin_session_store_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_027_implement_pinia_admin_session_store_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_027_implement_pinia_admin_session_store_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_027_implement_pinia_admin_session_store_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_027_implement_pinia_admin_session_store_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_028_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_028_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_028_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_028_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_028_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_028_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_028_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_028_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_029_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_029_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_029_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_029_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_029_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_029_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_029_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_029_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_030_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_030_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_030_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_030_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_030_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_030_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_030_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_030_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_031_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_031_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_031_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_031_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_031_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_031_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_031_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_031_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_032_implement_key_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_032_implement_key_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_032_implement_key_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_032_implement_key_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_032_implement_key_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_032_implement_key_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_032_implement_key_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_032_implement_key_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_033_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_033_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_033_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_033_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_033_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_033_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_033_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_033_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_034_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_034_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_034_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_034_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_034_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_034_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_034_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_034_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_035_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_035_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_035_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_035_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_035_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_035_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_035_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_035_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_036_implement_cleanup_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_036_implement_cleanup_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_036_implement_cleanup_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_036_implement_cleanup_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_036_implement_cleanup_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_036_implement_cleanup_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_036_implement_cleanup_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_036_implement_cleanup_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_037_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_037_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_037_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_037_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_037_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_037_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_037_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_037_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_038_implement__route_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_038_implement__route_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_038_implement__route_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_038_implement__route_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_038_implement__route_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_038_implement__route_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_038_implement__route_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_038_implement__route_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_039_verify_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_039_verify_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_039_verify_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_039_verify_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_039_verify_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_039_verify_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_039_verify_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_039_verify_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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)
test_task_040_completereal__smoke_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_040_completereal__smoke_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_040_completereal__smoke_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_040_completereal__smoke_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_040_completereal__smoke_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_040_completereal__smoke_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_040_completereal__smoke_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_040_completereal__smoke_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。