`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」, 代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红), 跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
59 KiB
05-shop-center:店铺中心任务计划
对应 Spec:
docs/specs/05-shop-center.md。本文件是“店铺中心”的独立执行计划,任务必须按编号串行完成。
模块范围
- 当前实现基线:
panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage及 JavaShopKeyController/ShopManageController。 - 目标实现边界:
src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter。 - 默认验证命令:
cd admin-frontend-vue; npm test、npm run build;店铺 CRUD 增加真实 Java 请求。 - 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
模块依赖
- 本模块任务范围:81-100。
- 前置依赖:任务 80;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
任务 81:定义店铺和店铺密钥 DTO
所属模块:店铺中心
依赖:80
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
为“定义店铺和店铺密钥 DTO”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 范围内,不能用无类型大对象掩盖边界。
测试用例(必须先写,确认 RED)
test_task_081_define__dto_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_081_define__dto_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_081_define__dto_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_081_define__dto_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_081_define__dto_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_081_define__dto_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_081_define__dto_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_081_define__dto_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-81.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 82:实现店铺密钥列表加载
所属模块:店铺中心
依赖:81
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺密钥列表加载”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_082_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_082_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_082_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_082_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_082_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_082_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_082_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_082_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-82.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 83:实现店铺密钥筛选和分页
所属模块:店铺中心
依赖:82
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺密钥筛选和分页”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_083_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_083_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_083_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_083_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_083_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_083_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_083_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_083_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-83.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 84:实现新增店铺密钥表单
所属模块:店铺中心
依赖:83
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现新增店铺密钥表单”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_084_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_084_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_084_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_084_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_084_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_084_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_084_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_084_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-84.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 85:实现编辑店铺密钥表单
所属模块:店铺中心
依赖:84
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现编辑店铺密钥表单”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_085_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_085_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_085_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_085_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_085_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_085_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_085_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_085_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-85.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 86:实现密钥敏感字段掩码
所属模块:店铺中心
依赖:85
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现密钥敏感字段掩码”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_086_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_086_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_086_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_086_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_086_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_086_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_086_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_086_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-86.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 87:实现密钥删除确认和刷新
所属模块:店铺中心
依赖:86
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现密钥删除确认和刷新”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_087_implementremoveconfirm_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_087_implementremoveconfirm_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_087_implementremoveconfirm_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_087_implementremoveconfirm_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_087_implementremoveconfirm_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_087_implementremoveconfirm_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_087_implementremoveconfirm_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_087_implementremoveconfirm_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-87.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 88:实现店铺列表加载
所属模块:店铺中心
依赖:87
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺列表加载”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_088_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_088_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_088_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_088_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_088_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_088_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_088_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_088_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-88.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 89:实现店铺筛选和分页
所属模块:店铺中心
依赖:88
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺筛选和分页”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_089_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_089_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_089_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_089_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_089_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_089_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_089_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_089_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-89.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 90:实现店铺分组选项加载
所属模块:店铺中心
依赖:89
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺分组选项加载”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_090_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_090_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_090_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_090_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_090_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_090_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_090_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_090_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-90.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 91:实现新增店铺表单
所属模块:店铺中心
依赖:90
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现新增店铺表单”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_091_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_091_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_091_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_091_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_091_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_091_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_091_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_091_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-91.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 92:实现编辑店铺表单
所属模块:店铺中心
依赖:91
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现编辑店铺表单”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_092_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_092_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_092_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_092_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_092_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_092_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_092_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_092_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-92.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 93:实现店铺凭证字段分离
所属模块:店铺中心
依赖:92
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺凭证字段分离”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_093_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_093_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_093_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_093_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_093_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_093_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_093_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_093_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-93.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 94:实现店铺凭证明文短时展示
所属模块:店铺中心
依赖:93
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺凭证明文短时展示”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_094_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_094_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_094_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_094_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_094_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_094_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_094_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_094_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-94.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 95:实现店铺删除确认
所属模块:店铺中心
依赖:94
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺删除确认”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_095_implementremoveconfirm_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_095_implementremoveconfirm_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_095_implementremoveconfirm_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_095_implementremoveconfirm_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_095_implementremoveconfirm_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_095_implementremoveconfirm_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_095_implementremoveconfirm_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_095_implementremoveconfirm_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-95.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 96:实现店铺账号字段校验
所属模块:店铺中心
依赖:95
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺账号字段校验”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_096_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_096_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_096_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_096_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_096_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_096_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_096_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_096_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-96.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 97:实现店铺数据空状态和错误状态
所属模块:店铺中心
依赖:96
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺数据空状态和错误状态”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_097_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_097_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_097_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_097_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_097_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_097_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_097_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_097_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-97.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 98:实现店铺中心通用筛选栏
所属模块:店铺中心
依赖:97
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺中心通用筛选栏”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_098_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_098_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_098_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_098_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_098_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_098_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_098_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_098_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-98.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 99:实现店铺中心响应式表格
所属模块:店铺中心
依赖:98
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
实现“实现店铺中心响应式表格”:以 src/pages/shop/、敏感字段组件、店铺分组选择器和类型化 API adapter 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 panel-shop-keys、panel-shop-manage、admin.js:loadShopKeys/loadShopManage 及 Java ShopKeyController/ShopManageController 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
测试用例(必须先写,确认 RED)
test_task_099_implement_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_099_implement_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_099_implement_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_099_implement_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_099_implement_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_099_implement_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_099_implement_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_099_implement_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-99.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
任务 100:完成店铺中心真实 API 验收
所属模块:店铺中心
依赖:99
预估耗时:8-15 分钟(写测试 + 实现 + 自测)
功能点要求
完成“完成店铺中心真实 API 验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
测试用例(必须先写,确认 RED)
test_task_100_completereal_api_normal_primary_path— 正常主路径:使用最小有效输入,验证功能输出符合目标契约。test_task_100_completereal_api_normal_variant_input— 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。test_task_100_completereal_api_normal_repeated_operation_is_idempotent— 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。test_task_100_completereal_api_boundary_empty_input— 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。test_task_100_completereal_api_boundary_single_item— 边界单元素:单条记录/单节点/单次请求的结果和排序正确。test_task_100_completereal_api_boundary_limit_or_missing_field— 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。test_task_100_completereal_api_invalid_input_rejected— 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。test_task_100_completereal_api_dependency_failure_returns_actionable_message— 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
TDD 流程
- 先写以上全部测试,运行对应命令确认 RED(目标行为尚未实现时应失败);若测试一开始通过,先检查测试是否真正断言了目标行为。
- 实现本任务功能,重新运行同一测试集确认 GREEN(全部通过)。
- 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
验证方法
在 admin-frontend-vue 执行 npm test -- tests/task-100.test.ts、npm run build;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。店铺凭证和 CRUD 任务必须使用 mock 加真实集成测试;真实凭证只使用脱敏测试数据。
准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
模块完成条件
- 任务 81-100 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。