b404fd2572
`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」, 代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红), 跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
767 lines
60 KiB
Markdown
767 lines
60 KiB
Markdown
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|