Files
crawler-plugin/docs/plans/admin-front-vue/01-admin-shell-routing.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.
# 01-admin-shell-routing:后台壳层与路由任务计划
> 对应 Spec:`docs/specs/01-admin-shell-routing.md`。本文件是“后台壳层与路由”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构。
- 目标实现边界:`AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token。
- 默认验证命令:`cd admin-frontend-vue; npm test`、`npm run build`,涉及浏览器时增加 Playwright smoke。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:1-20。
- 前置依赖:无;这是现有重构工程的现状确认任务,不重新初始化客户端工程。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 1:确认独立后台工程依赖、构建、测试和工作区边界
**所属模块**:后台壳层与路由
**依赖**:无
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
检查 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token,不得修改无关模块。
### 测试用例(必须先写,确认 RED)
1. `test_task_001_project_baseline_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_001_project_baseline_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_001_project_baseline_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_001_project_baseline_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_001_project_baseline_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_001_project_baseline_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_001_project_baseline_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_001_project_baseline_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-1.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 2:冻结 /admin-vue/ base 与 History 路由约定
**所属模块**:后台壳层与路由
**依赖**:1
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
把 /admin-vue/ base 与 History 路由约定 固化为可测试契约:定义合法输入、默认值、边界、错误语义和兼容约束;契约必须能被 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 直接消费,并明确禁止的旧行为。
### 测试用例(必须先写,确认 RED)
1. `test_task_002_history_base_contract_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_002_history_base_contract_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_002_history_base_contract_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_002_history_base_contract_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_002_history_base_contract_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_002_history_base_contract_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_002_history_base_contract_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_002_history_base_contract_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-2.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 3:定义 AdminLayout 页面容器职责
**所属模块**:后台壳层与路由
**依赖**:2
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 AdminLayout 页面容器职责”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_003_layout_contract_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_003_layout_contract_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_003_layout_contract_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_003_layout_contract_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_003_layout_contract_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_003_layout_contract_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_003_layout_contract_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_003_layout_contract_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-3.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 4:定义深色侧边栏与浅色内容区设计 token
**所属模块**:后台壳层与路由
**依赖**:3
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义深色侧边栏与浅色内容区设计 token”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_004_theme_tokens_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_004_theme_tokens_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_004_theme_tokens_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_004_theme_tokens_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_004_theme_tokens_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_004_theme_tokens_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_004_theme_tokens_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_004_theme_tokens_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-4.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 5:定义顶部栏用户信息和页面标题模型
**所属模块**:后台壳层与路由
**依赖**:4
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义顶部栏用户信息和页面标题模型”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_005_topbar_title_model_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_005_topbar_title_model_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_005_topbar_title_model_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_005_topbar_title_model_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_005_topbar_title_model_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_005_topbar_title_model_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_005_topbar_title_model_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_005_topbar_title_model_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-5.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 6:定义后端菜单树到侧边栏节点的映射规则
**所属模块**:后台壳层与路由
**依赖**:5
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义后端菜单树到侧边栏节点的映射规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_006_menu_sidebar_mapping_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_006_menu_sidebar_mapping_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_006_menu_sidebar_mapping_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_006_menu_sidebar_mapping_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_006_menu_sidebar_mapping_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_006_menu_sidebar_mapping_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_006_menu_sidebar_mapping_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_006_menu_sidebar_mapping_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-6.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 7:实现根路由到首个可见页面的跳转规则
**所属模块**:后台壳层与路由
**依赖**:6
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现根路由到首个可见页面的跳转规则”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_007_first_route_redirect_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_007_first_route_redirect_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_007_first_route_redirect_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_007_first_route_redirect_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_007_first_route_redirect_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_007_first_route_redirect_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_007_first_route_redirect_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_007_first_route_redirect_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-7.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 8:实现业务域路由注册表
**所属模块**:后台壳层与路由
**依赖**:7
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现业务域路由注册表”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_008_domain_route_registry_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_008_domain_route_registry_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_008_domain_route_registry_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_008_domain_route_registry_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_008_domain_route_registry_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_008_domain_route_registry_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_008_domain_route_registry_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_008_domain_route_registry_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-8.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 9:实现路由 meta 菜单 key 约定
**所属模块**:后台壳层与路由
**依赖**:8
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现路由 meta 菜单 key 约定”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_009_route_menu_key_meta_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_009_route_menu_key_meta_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_009_route_menu_key_meta_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_009_route_menu_key_meta_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_009_route_menu_key_meta_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_009_route_menu_key_meta_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_009_route_menu_key_meta_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_009_route_menu_key_meta_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-9.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 10:实现页面级异步组件加载边界
**所属模块**:后台壳层与路由
**依赖**:9
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现页面级异步组件加载边界”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_010_lazy_page_boundary_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_010_lazy_page_boundary_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_010_lazy_page_boundary_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_010_lazy_page_boundary_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_010_lazy_page_boundary_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_010_lazy_page_boundary_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_010_lazy_page_boundary_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_010_lazy_page_boundary_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-10.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 11:实现无菜单权限空状态
**所属模块**:后台壳层与路由
**依赖**:10
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现无菜单权限空状态”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_011_empty_menu_state_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_011_empty_menu_state_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_011_empty_menu_state_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_011_empty_menu_state_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_011_empty_menu_state_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_011_empty_menu_state_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_011_empty_menu_state_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_011_empty_menu_state_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-11.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 12:实现路由级错误页面
**所属模块**:后台壳层与路由
**依赖**:11
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现路由级错误页面”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_012_route_error_page_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_012_route_error_page_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_012_route_error_page_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_012_route_error_page_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_012_route_error_page_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_012_route_error_page_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_012_route_error_page_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_012_route_error_page_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-12.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 13:实现全局请求错误提示容器
**所属模块**:后台壳层与路由
**依赖**:12
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现全局请求错误提示容器”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_013_global_error_notice_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_013_global_error_notice_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_013_global_error_notice_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_013_global_error_notice_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_013_global_error_notice_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_013_global_error_notice_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_013_global_error_notice_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_013_global_error_notice_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-13.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 14:实现侧边栏折叠和窄屏布局行为
**所属模块**:后台壳层与路由
**依赖**:13
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现侧边栏折叠和窄屏布局行为”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_014_sidebar_responsive_behavior_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_014_sidebar_responsive_behavior_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_014_sidebar_responsive_behavior_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_014_sidebar_responsive_behavior_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_014_sidebar_responsive_behavior_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_014_sidebar_responsive_behavior_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_014_sidebar_responsive_behavior_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_014_sidebar_responsive_behavior_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-14.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 15:实现页面标题与面包屑规则
**所属模块**:后台壳层与路由
**依赖**:14
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现页面标题与面包屑规则”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_015_page_title_breadcrumb_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_015_page_title_breadcrumb_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_015_page_title_breadcrumb_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_015_page_title_breadcrumb_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_015_page_title_breadcrumb_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_015_page_title_breadcrumb_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_015_page_title_breadcrumb_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_015_page_title_breadcrumb_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-15.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 16:实现退出登录入口的壳层交互
**所属模块**:后台壳层与路由
**依赖**:15
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现退出登录入口的壳层交互”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_016_shell_logout_interaction_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_016_shell_logout_interaction_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_016_shell_logout_interaction_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_016_shell_logout_interaction_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_016_shell_logout_interaction_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_016_shell_logout_interaction_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_016_shell_logout_interaction_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_016_shell_logout_interaction_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-16.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 17:实现桌面端壳层响应式验收
**所属模块**:后台壳层与路由
**依赖**:16
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现桌面端壳层响应式验收”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_017_desktop_shell_responsive_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_017_desktop_shell_responsive_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_017_desktop_shell_responsive_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_017_desktop_shell_responsive_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_017_desktop_shell_responsive_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_017_desktop_shell_responsive_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_017_desktop_shell_responsive_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_017_desktop_shell_responsive_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-17.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 18:实现壳层键盘焦点和可访问性语义
**所属模块**:后台壳层与路由
**依赖**:17
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现壳层键盘焦点和可访问性语义”:以 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_018_shell_accessibility_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_018_shell_accessibility_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_018_shell_accessibility_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_018_shell_accessibility_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_018_shell_accessibility_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_018_shell_accessibility_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_018_shell_accessibility_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_018_shell_accessibility_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-18.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 19:验证首批页面从壳层正确挂载
**所属模块**:后台壳层与路由
**依赖**:18
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证首批页面从壳层正确挂载”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `admin-frontend-vue/src/layout/`、`src/router/`、`src/styles/`,以及旧 `backend/web_source/admin.html` 的布局结构 与 `AdminLayout.vue`、异步页面路由、`RouteMeta`、Admin 主题 token 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_019_first_batch_mount_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_019_first_batch_mount_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_019_first_batch_mount_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_019_first_batch_mount_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_019_first_batch_mount_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_019_first_batch_mount_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_019_first_batch_mount_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_019_first_batch_mount_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-19.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 20:完成壳层真实浏览器 smoke 验收
**所属模块**:后台壳层与路由
**依赖**:19
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成壳层真实浏览器 smoke 验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_020_shell_browser_smoke_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_020_shell_browser_smoke_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_020_shell_browser_smoke_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_020_shell_browser_smoke_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_020_shell_browser_smoke_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_020_shell_browser_smoke_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_020_shell_browser_smoke_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_020_shell_browser_smoke_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-20.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。路由和浏览器任务必须补充真实页面访问;纯类型/设计 token 任务用组件测试和构建验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 1-20 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。