docs(仓库): 规划文档改为入库,落盘品牌库/去重库每公司一套二期方案

`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」,
代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红),
跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
This commit is contained in:
2026-10-04 13:51:16 +08:00
parent f95932747e
commit 49c3fc1491
34 changed files with 15059 additions and 3 deletions
+3 -3
View File
@@ -112,10 +112,10 @@ OPS_REDIS_MYSQL_OPTIMIZATION_NOTES.md
*ts.%
.omc
# ===== 本地规划文档(不入库)=====
docs/plans/
# ===== 规划文档 =====
# docs/plans/ 与 backend-java/docs/plans/ 已从「本地不入库」改为入库(2026-10-04 用户拍定):
# 实施计划要跨会话留存,被 gitignore 的文件在干净 worktree 出包时不存在,护栏用例也读不到。
docs/*plan*.md
backend-java/docs/plans/
backend-java/docs/*plan*.md
backend-java/docs/specs/
backend-java/docs/*audit*.md
+233
View File
@@ -0,0 +1,233 @@
# 00-plan-overview.md — 全部任务总表
> 来源:`backend-java/docs/specs/00-overview.md` 与 01-13 号 spec(2026-08-31)
> 任务粒度:每个功能点 8-15 分钟(写测试 ≥8 用例 → RED → 实现 → GREEN)
> 执行纪律:单线程串行,禁止并行 agent 写代码;每任务独立 commit
## 任务总表
| N | 功能点 | 模块 | 依赖 |
|---|---|---|---|
| 1 | API_ENDPOINTS 路径常量表(17 页面模块路径分组) | 01 适配层 | 无 |
| 2 | buildJavaUrl() 统一 URL 构造(前缀+endpoint+query) | 01 适配层 | 1 |
| 3 | callJava() 统一响应解包(success/message/data + 非包装直通) | 01 适配层 | 2 |
| 4 | extractErrorMessage 导出并覆盖 error/message/msg 三字段 | 01 适配层 | 3 |
| 5 | normalizeStatus() 大小写归一(未知值透传) | 01 适配层 | 3 |
| 6 | isTerminalStatus() 终态判定(SUCCESS/FAILED/CANCELLED 可配置) | 01 适配层 | 5 |
| 7 | buildDownloadUrl() 统一下载 URL(user_id 附加规则) | 01 适配层 | 2 |
| 8 | callJava 透传 AbortController(signal 取消) | 01 适配层 | 3 |
| 9 | 进度类请求默认 10s 超时配置 | 01 适配层 | 3 |
| 10 | types/task.ts 共享类型(TaskStatus/FilePhase/PageResult) | 01 适配层 | 无 |
| 11 | 拆分 dedupe 模块 API(函数移动+行为不变测试) | 01 适配层 | 1,3 |
| 12 | 拆分 split 模块 API | 01 适配层 | 1,3 |
| 13 | 拆分 convert 模块 API | 01 适配层 | 1,3 |
| 14 | 拆分 publish 模块 API | 01 适配层 | 1,3 |
| 15 | 拆分 similar-asin 模块 API | 01 适配层 | 1,3 |
| 16 | 拆分 appearance-patent 模块 API | 01 适配层 | 1,3 |
| 17 | 拆分 delete-brand 模块 API | 01 适配层 | 1,3 |
| 18 | 拆分 price-track 模块 API | 01 适配层 | 1,3 |
| 19 | 拆分 shop-match/product-risk 模块 API | 01 适配层 | 1,3 |
| 20 | 拆分 shop-data-crawl/query-asin 模块 API | 01 适配层 | 1,3 |
| 21 | 拆分 withdraw/patrol-delete 模块 API | 01 适配层 | 1,3 |
| 22 | 拆分 collect-data 模块 API | 01 适配层 | 1,3 |
| 23 | 拆分 image-video/brand/permission/digital-human 模块 API | 01 适配层 | 1,3 |
| 24 | java-modules.ts 改 re-export 聚合(旧 import 零改动) | 01 适配层 | 11-23 |
| 25 | ResultFilePhase 新字段兼容默认值(可选字段兜底) | 01 适配层 | 10 |
| 26 | 模块 API 快照契约测试基建(mock adapter 断言 URL/method/query) | 01 适配层 | 3 |
| 27 | api-field-compat 注册高频响应 schema(task/result 核心字段) | 01 适配层 | 26 |
| 28 | 死代码清理(拆分后未引用导出,grep 确认后删) | 01 适配层 | 24 |
| 29 | 退避配置项(MaxMs/Factor 常量 + 默认值) | 02 轮询 | 无 |
| 30 | getTaskPollBackoffMs 递增序列(500→1000→…→10000) | 02 轮询 | 29 |
| 31 | 连续失败计数(成功/收到响应归零) | 02 轮询 | 30 |
| 32 | 退避封顶(maxMs 后不再增长) | 02 轮询 | 30,31 |
| 33 | 网络错误走退避且不触发终态 | 02 轮询 | 31 |
| 34 | HTTP 4xx/5xx 与网络错误分类(记 onError) | 02 轮询 | 31 |
| 35 | 未知状态不判终态测试固化(PENDING/SYNCING/空串) | 02 轮询 | 无 |
| 36 | 终态任务仅一次 onTerminal(coordinator 语义) | 02 轮询 | 无 |
| 37 | onTerminal 抛错后任务已移除语义测试(页面可重新 add) | 02 轮询 | 无 |
| 38 | 同一轮多任务终态分别回调测试 | 02 轮询 | 无 |
| 39 | in-flight 合并(timer 不叠加)测试补强 | 02 轮询 | 无 |
| 40 | 页面隐藏降频(30s)与可见恢复(立即刷新)测试 | 02 轮询 | 无 |
| 41 | storage 恢复(无效 id 过滤/空清理)测试 | 02 轮询 | 无 |
| 42 | 退避恢复测试(失败→退避→成功→正常间隔) | 02 轮询 | 31,32 |
| 43 | progressCache TTL 惰性清理边界测试 | 02 轮询 | 无 |
| 44 | fetchProgress 轻量端点切换能力(getModuleProgressLight 接入) | 02 轮询 | 26 |
| 45 | 轮询与历史刷新分离测试 | 02 轮询 | 无 |
| 46 | 双页面同 key 互踩行为记录测试(只读断言现状) | 02 轮询 | 无 |
| 47 | 轮询 baseline 统计(请求量/响应体大小)测试补强 | 02 轮询 | 无 |
| 48 | 轮询全量回归(20 个既有测试保持绿) | 02 轮询 | 29-47 |
| 49 | multipart 直通断言补测(content-type 大小写变体) | 03 过滤器 | 无 |
| 50 | JSON/PUT/DELETE 包装与阈值钳制补测 | 03 过滤器 | 无 |
| 51 | 日志不读 body 行为测试(过滤器通过后 body 仍可读) | 03 过滤器 | 无 |
| 52 | 阈值生效集成测试(>1MB 请求不整包缓存) | 03 过滤器 | 无 |
| 53 | yml 默认值 1MB 与 env 覆盖测试 | 03 过滤器 | 无 |
| 54 | TaskOwnerForwardService 转发 multipart 安全测试(inputStream 路径) | 03 过滤器 | 无 |
| 55 | 转发后 body 完整性测试(转发请求体与原请求一致) | 03 过滤器 | 54 |
| 56 | plan §6 文档现状修正核对 | 03 过滤器 | 无 |
| 57 | ResultFileJobHandler 接口定义(moduleType/process/cleanup/onFailure/offload/ownerScoped) | 04 注册表 | 无 |
| 58 | 注册表容器(List 收集 + moduleType 唯一性校验) | 04 注册表 | 57 |
| 59 | 启动校验(缺注册/双注册 fail-fast) | 04 注册表 | 58 |
| 60 | SHOP_MATCH Handler(委托+payload.deleteLatest) | 04 注册表 | 57-59 |
| 61 | PRICE_TRACK Handler | 04 注册表 | 57-59 |
| 62 | PRODUCT_RISK_RESOLVE Handler | 04 注册表 | 57-59 |
| 63 | PUBLISH Handler(ownerScoped) | 04 注册表 | 57-59 |
| 64 | QUERY_ASIN Handler | 04 注册表 | 57-59 |
| 65 | SHOP_DATA_CRAWL Handler(cleanup+onFailure) | 04 注册表 | 57-59 |
| 66 | WITHDRAW Handler(tryFinalizeTask 时机保持) | 04 注册表 | 57-59 |
| 67 | PATROL_DELETE Handler | 04 注册表 | 57-59 |
| 68 | APPEARANCE_PATENT Handler(异步返回+offload+ownerScoped) | 04 注册表 | 57-59 |
| 69 | SIMILAR_ASIN Handler(异步+offload+ownerScoped+onFailure) | 04 注册表 | 57-59 |
| 70 | DELETE_BRAND Handler | 04 注册表 | 57-59 |
| 71 | BRAND Handler(resolveResultObjectKey 特例) | 04 注册表 | 57-59 |
| 72 | COLLECT_DATA Handler | 04 注册表 | 57-59 |
| 73 | Worker dispatch() 改注册表查找 | 04 注册表 | 60-72 |
| 74 | cleanupAfterSuccess 改 handler.cleanup + 公共 payload 清理 | 04 注册表 | 60-72 |
| 75 | notifyRetryExhausted 改 handler.onFailure | 04 注册表 | 60-72 |
| 76 | coze offload 判定改 handler.supportsAsyncOffload | 04 注册表 | 60-72 |
| 77 | owner-scoped 判定改 handler.isOwnerScoped | 04 注册表 | 60-72 |
| 78 | 模块映射快照测试(13 moduleType → Handler → 原方法) | 04 注册表 | 73 |
| 79 | 行为等价对比测试(Job 状态迁移序列一致) | 04 注册表 | 73-77 |
| 80 | 孤儿失败路径不回归(markFailedPermanent) | 04 注册表 | 73 |
| 81 | 卡死扫描/重试耗尽路径测试 | 04 注册表 | 73 |
| 82 | 特殊规则回归(WITHDRAW finalize、coze 等待 defer) | 04 注册表 | 78-81 |
| 83 | SimilarAsinExcelParser 行解析器(POI 读行→中间行对象) | 05 拆分 | 无 |
| 84 | 行解析边界(空行/超长/畸形 ASIN/BOM/混合编码) | 05 拆分 | 83 |
| 85 | 字段归一化器(trim/大小写/ASIN 格式统一) | 05 拆分 | 无 |
| 86 | 分组转换器(中间对象→TaskItem/FileItem) | 05 拆分 | 83,85 |
| 87 | 纯校验器(必填/格式/去重) | 05 拆分 | 85 |
| 88 | Sheet 构造器(workbook 构建辅助) | 05 拆分 | 无 |
| 89 | SimilarAsinService.parse 门面改委托(签名不变) | 05 拆分 | 83-88 |
| 90 | 抽取前后快照对比测试(夹具 Excel 同断言) | 05 拆分 | 89 |
| 91 | SimilarAsin 历史查询组装抽取(VO 拼装) | 05 拆分 | 无 |
| 92 | SimilarAsin 全量回归(mvn test 相关类) | 05 拆分 | 89-91 |
| 93 | AppearancePatent 行解析/归一化抽取 | 05 拆分 | 83,85 |
| 94 | AppearancePatent Sheet 构造抽取 | 05 拆分 | 88 |
| 95 | AppearancePatent 门面改委托(签名不变) | 05 拆分 | 93,94 |
| 96 | AppearancePatent 快照对比测试 | 05 拆分 | 95 |
| 97 | AppearancePatent 历史查询组装抽取 | 05 拆分 | 无 |
| 98 | AppearancePatent 全量回归 | 05 拆分 | 95-97 |
| 99 | ShopDataCrawl 行解析抽取 | 05 拆分 | 83,85 |
| 100 | ShopDataCrawl Sheet 构造抽取 | 05 拆分 | 88 |
| 101 | ShopDataCrawl 门面改委托(签名不变) | 05 拆分 | 99,100 |
| 102 | ShopDataCrawl 快照对比测试 | 05 拆分 | 101 |
| 103 | ShopDataCrawl 历史查询组装抽取 | 05 拆分 | 无 |
| 104 | ShopDataCrawl 全量回归 | 05 拆分 | 101-103 |
| 105 | similarasin 历史列表 IN 查询批量加载 | 06 批量加载 | 无 |
| 106 | appearancepatent 历史列表批量加载 | 06 批量加载 | 105 |
| 107 | 结果列表关联 Job 批量加载(findAssembleJobs 覆盖审计) | 06 批量加载 | 无 |
| 108 | dashboard 聚合查询(COUNT/GROUP BY 一次出) | 06 批量加载 | 无 |
| 109 | progress/light 轻量接口(similarasin 首个) | 06 批量加载 | 无 |
| 110 | progress/light 字段白名单(不含明细) | 06 批量加载 | 109 |
| 111 | progress/light 空/超长 taskIds 行为 | 06 批量加载 | 109 |
| 112 | progress/light 终态任务返回终态状态 | 06 批量加载 | 109 |
| 113 | 其余模块 progress/light 接入(批量) | 06 批量加载 | 109-112 |
| 114 | 批量加载等价快照测试(改造前后字段一致) | 06 批量加载 | 105-108 |
| 115 | 高频查询 EXPLAIN 索引审计(产出迁移清单) | 06 批量加载 | 无 |
| 116 | 索引迁移 V{N+1}(EXPLAIN 验证后追加) | 06 批量加载 | 115 |
| 117 | progress/light user_id 权限过滤 | 06 批量加载 | 109 |
| 118 | 前端 getModuleProgressLight 适配(调用轻量端点) | 06 批量加载 | 109,44 |
| 119 | dashboard/history/progress 前端分离调用测试 | 06 批量加载 | 无 |
| 120 | 大页数据(500 任务)性能回归 | 06 批量加载 | 105-108 |
| 121 | N+1 扫描(逐条 selectById 循环审计) | 06 批量加载 | 无 |
| 122 | 扫描确认的 N+1 批量化修复 | 06 批量加载 | 121 |
| 123 | 06 全量回归 | 06 批量加载 | 105-122 |
| 124 | @Transactional 方法审计清单(每模块) | 07 事务 | 无 |
| 125 | similarasin 纯计算移出事务 | 07 事务 | 124 |
| 126 | similarasin DTO 组装移出写事务 | 07 事务 | 124 |
| 127 | similarasin 临时文件清理挂 afterCommit | 07 事务 | 124 |
| 128 | appearancepatent 事务收缩 | 07 事务 | 124 |
| 129 | shopdatacrawl 事务收缩 | 07 事务 | 124 |
| 130 | publish 事务收缩 | 07 事务 | 124 |
| 131 | collectdata 事务收缩 | 07 事务 | 124 |
| 132 | /result 成功确认时机不变测试(200+success 在落库后) | 07 事务 | 125-131 |
| 133 | 回滚语义不变测试(落库失败回滚) | 07 事务 | 125-131 |
| 134 | done=true 封口时机不变测试 | 07 事务 | 125-131 |
| 135 | 任务状态成功时机不变测试 | 07 事务 | 125-131 |
| 136 | 事务外清理异常不阻断(日志+指标) | 07 事务 | 127 |
| 137 | 重复提交幂等测试(同 submissionId) | 07 事务 | 132-135 |
| 138 | 事务时长性能对比基准 | 07 事务 | 125-131 |
| 139 | 07 全量回归 | 07 事务 | 132-138 |
| 140 | 13 模块 file 字段契约快照测试(齐全+旧字段仍在) | 08 结果阶段 | 无 |
| 141 | similarasin file 进度合成逻辑单测(Coze/Python/snapshot 三路径) | 08 结果阶段 | 无 |
| 142 | fileReady/fileStatus 语义测试(无 job 时 SUCCESS 兜底) | 08 结果阶段 | 140 |
| 143 | publish 文件级 file 状态测试 | 08 结果阶段 | 140 |
| 144 | 前端 live progress 合并测试补强(history 缺失保留) | 08 结果阶段 | 无 |
| 145 | 前端可下载判定测试(fileReady/fileStatus 终态) | 08 结果阶段 | 无 |
| 146 | collectdata 自洽行为测试(success+downloadUrl 判定) | 08 结果阶段 | 140 |
| 147 | downloadUrl 永不过期验证(generateFreshDownloadUrl 公开直链) | 08 结果阶段 | 无 |
| 148 | 临时目录配置盘点(Transient/Storage Properties 现状) | 09 临时文件 | 无 |
| 149 | 创建/访问时间记录审计与补缺 | 09 临时文件 | 148 |
| 150 | 引用检查(清理前查 task_file_job/file_result) | 09 临时文件 | 148 |
| 151 | 路径安全校验(规范化 + startsWith 根目录) | 09 临时文件 | 148 |
| 152 | 清理失败吞异常记指标(不阻断主流程) | 09 临时文件 | 150,151 |
| 153 | fileKey 兜底查找(进程重启后) | 09 临时文件 | 148 |
| 154 | 磁盘容量告警(仅日志/指标输出) | 09 临时文件 | 152 |
| 155 | 孤立文件巡检报表(只读) | 09 临时文件 | 150 |
| 156 | 孤立 Job 巡检报表(只读) | 09 临时文件 | 无 |
| 157 | 任务存在结果缺失巡检 | 09 临时文件 | 无 |
| 158 | 结果存在文件缺失巡检 | 09 临时文件 | 无 |
| 159 | 已完成任务活跃 Job 巡检 | 09 临时文件 | 无 |
| 160 | 超保留期仍被引用巡检 | 09 临时文件 | 150 |
| 161 | 巡检任务开关(默认 disabled) | 09 临时文件 | 155-160 |
| 162 | 路径穿越测试(../ 输入被拒) | 09 临时文件 | 151 |
| 163 | 引用中文件不清测试 | 09 临时文件 | 150 |
| 164 | 清理失败不阻断测试 | 09 临时文件 | 152 |
| 165 | 巡检只读测试(运行零删除) | 09 临时文件 | 155-161 |
| 166 | 各客户端契约表盘点(超时/重试/幂等现状) | 10 HTTP 客户端 | 无 |
| 167 | aiimage.http-client.* 配置命名空间 | 10 HTTP 客户端 | 166 |
| 168 | Coze 客户端超时/重试配置接入 | 10 HTTP 客户端 | 167 |
| 169 | 品牌检查客户端配置接入 | 10 HTTP 客户端 | 167 |
| 170 | 紫鸟客户端配置接入 | 10 HTTP 客户端 | 167 |
| 171 | 图片下载客户端配置接入 | 10 HTTP 客户端 | 167 |
| 172 | 幂等重试守卫(非幂等不自动重试) | 10 HTTP 客户端 | 167 |
| 173 | 超时生效测试(mock 慢端点) | 10 HTTP 客户端 | 168-171 |
| 174 | 连接复用测试(连续请求复用底层连接) | 10 HTTP 客户端 | 168-171 |
| 175 | Python 回调超时不变确认(只读测试) | 10 HTTP 客户端 | 无 |
| 176 | 重试计数与日志字段 | 10 HTTP 客户端 | 172 |
| 177 | 10 全量回归 | 10 HTTP 客户端 | 168-176 |
| 178 | 日志字段规范落地(taskId/moduleType/stage 统一) | 11 可观测性 | 无 |
| 179 | 禁止记录清单审计(Token/Cookie/body 不落日志) | 11 可观测性 | 178 |
| 180 | Worker 日志字段对齐(04 改造后) | 11 可观测性 | 73 |
| 181 | task.created/running 指标埋点 | 11 可观测性 | 无 |
| 182 | task.success/failed/cancelled 指标埋点 | 11 可观测性 | 181 |
| 183 | task.duration 指标埋点 | 11 可观测性 | 182 |
| 184 | task.heartbeat.age 指标埋点 | 11 可观测性 | 无 |
| 185 | file-job.* 指标埋点(pending/running/success/failed/duration/retry) | 11 可观测性 | 73 |
| 186 | 上传耗时/大小指标埋点 | 11 可观测性 | 无 |
| 187 | 临时磁盘指标埋点 | 11 可观测性 | 154 |
| 188 | 指标标签规范(moduleType/instanceId) | 11 可观测性 | 181-187 |
| 189 | 指标命名一致性测试(名称/标签断言) | 11 可观测性 | 188 |
| 190 | 日志脱敏测试(敏感字段不落日志) | 11 可观测性 | 179 |
| 191 | 双实例指标区分回归(instanceId 标签) | 11 可观测性 | 188-190 |
| 192 | 迁移规范模板(目的/影响/锁表/验证/回滚/窗口) | 12 Flyway | 无 |
| 193 | 历史迁移盘点(V87+ 现状核对,只追加不改) | 12 Flyway | 无 |
| 194 | orphan Job 巡检 SQL | 12 Flyway | 无 |
| 195 | orphan payload 巡检 SQL | 12 Flyway | 无 |
| 196 | 任务存在结果缺失巡检 SQL | 12 Flyway | 无 |
| 197 | 结果存在文件缺失巡检 SQL | 12 Flyway | 无 |
| 198 | 已完成任务活跃 Job 巡检 SQL | 12 Flyway | 无 |
| 199 | 超保留期引用巡检 SQL | 12 Flyway | 无 |
| 200 | 巡检报表任务落地(默认关闭) | 12 Flyway | 194-199 |
| 201 | 迁移演练(副本库 migrate + 验证 SQL) | 12 Flyway | 192 |
| 202 | Python-contract 夹具准备(录制真实请求脱敏) | 13 契约 | 无 |
| 203 | /result 幂等契约测试(同 submissionId 重复) | 13 契约 | 202 |
| 204 | /items 分页语义契约测试 | 13 契约 | 202 |
| 205 | parsed-payload 契约测试 | 13 契约 | 202 |
| 206 | heartbeat 旧字段契约测试 | 13 契约 | 202 |
| 207 | done=true 最后一批契约测试 | 13 契约 | 203 |
| 208 | JavaApiResponse 包装契约测试(前端) | 13 契约 | 无 |
| 209 | 字段兼容 schema 覆盖(user_id/task_ids/taskId/resultId/fileKey) | 13 契约 | 208 |
| 210 | ArchUnit 依赖方向规则(Controller→Service→Mapper) | 13 契约 | 无 |
| 211 | ArchUnit Controller 不访问 Mapper 规则 | 13 契约 | 210 |
| 212 | ArchUnit task 模块不依赖业务模块(SPI 检查) | 13 契约 | 210 |
| 213 | 前端共享层导出白名单(页面禁止直连 http) | 13 契约 | 无 |
| 214 | progress/batch 轻量响应契约 | 13 契约 | 109 |
| 215 | 下载 URL 格式契约(downloadUrl 公开直链) | 13 契约 | 147 |
| 216 | CI 接入测试阶段(.gitea workflow 追加) | 13 契约 | 210-215 |
| 217 | 快照对比工具(Service 拆分前后响应一致) | 13 契约 | 90 |
| 218 | 结果文件格式契约(文件名/Sheet/列/ZIP 结构) | 13 契约 | 无 |
| 219 | 13 全量契约回归 | 13 契约 | 202-218 |
**总任务数:219**
(原 222 规划在写入时合并了 3 个冗余项:40→41 合并降频测试、46→47 合并 baseline、112→113 合并终态返回,编号已重排为连续 1-219,与上表严格一致。)
@@ -0,0 +1,429 @@
# 01-plan — frontend-vue Java API 适配层
> 对应 `docs/specs/01-frontend-api-adapter.md`。技术栈:TypeScript + Vue3 + Vitest(`frontend-vue/`)。
> 测试命令:`cd crawler-plugin/frontend-vue && npx vitest run <file>`;类型检查:`npx vue-tsc --noEmit`。
## 任务 1:API_ENDPOINTS 路径常量表
**所属模块**:01 适配层 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
新建 `src/shared/api/endpoints.ts`,导出按模块分组的路径常量表 `API_ENDPOINTS`(17 个页面模块:split/dedupe/convert/publish/query-asin/similar-asin/appearance-patent/delete-brand/price-track/shop-match/product-risk/shop-data-crawl/withdraw/patrol-delete/collect-data/image-video/brand/permission/digital-human)。每个模块含 parse/activate/progress/history/result/download 等端点常量。路径值与现 java-modules.ts 内联 URL 完全一致(不含 /newApi/api 前缀,前缀由 buildJavaUrl 加)。
### 测试用例(≥8,先写 RED)
1. test_endpoints_all_modules_present — 17 模块键齐全
2. test_endpoint_path_format — 每个端点以 /api/ 开头
3. test_no_newapi_prefix_in_endpoint — 不含 /newApi/api 前缀
4. test_progress_batch_paths_match_controllers — progress 端点与 Java controller 路径一致(快照)
5. test_download_paths_match — download 端点模式
6. test_endpoints_frozen_snapshot — 常量表 JSON 快照(防漂移)
7. test_endpoint_values_no_trailing_slash — 无尾斜杠
8. test_endpoint_keys_convention — 键名 snake_case 或小驼峰一致性
### TDD 流程
1. 写上述全部测试 → `npx vitest run src/shared/api/__tests__/endpoints.test.ts` 确认 RED(文件不存在)
2. 实现 endpoints.ts → 确认 GREEN
3. `npx vue-tsc --noEmit` 通过
### 验证方法
`npx vitest run`(新建测试全绿)+ `npx vue-tsc --noEmit`。
## 任务 2:buildJavaUrl() 统一 URL 构造
**所属模块**:01 适配层 **依赖**:1 **预估**:8-15 分钟
### 功能点要求
`buildJavaUrl(module, endpoint, query?)`:`/newApi` + `/api` 前缀 + endpoint + 可选 query 序列化;对空 query 不追加 `?`。与现有 `JAVA_API_PREFIX` 常量保持一致。
### 测试用例(≥8)
1. test_build_url_prefixed — 输出以 /newApi/api 开头
2. test_build_url_with_query — query 参数正确编码
3. test_build_url_no_query — 无 query 不加 ?
4. test_build_url_query_encoding — 特殊字符编码(空格/中文/&)
5. test_build_url_empty_query_object — 空对象不加 query
6. test_build_url_trailing_slash_endpoint — endpoint 尾斜杠规范化
7. test_build_url_undefined_query — undefined 安全
8. test_build_url_join_no_duplicate_slash — 前缀与端点之间无重复斜杠
### TDD 流程 / 验证方法
同上:先 RED,实现 GREEN,`vue-tsc` 通过。
## 任务 3:callJava() 统一响应解包
**所属模块**:01 适配层 **依赖**:2 **预估**:8-15 分钟
### 功能点要求
`callJava<T>(config): Promise<T>`:发起请求;响应 data 为 `JavaApiResponse<T>`(success/message/data)时解包返回 data;为 `LegacyApiSuccess`(success/msg/data)时兼容解包;非包装结构直通;success=false 抛错(message 优先);不改变 http.ts 现有导出。
### 测试用例(≥8)
1. test_call_java_success_unwraps — JavaApiResponse 解包出 data
2. test_call_java_legacy_msg_unwraps — LegacyApiSuccess(msg)解包
3. test_call_java_success_false_throws — success=false 抛错
4. test_call_java_message_precedence — message 优先于 msg 于 error
5. test_call_java_non_wrapped_passthrough — 非包装对象直通
6. test_call_java_null_data — success 且 data=null 返回 null
7. test_call_java_network_error — 网络错误抛出 Error
8. test_call_java_http_error_status — HTTP 错误状态提取 message
### TDD 流程 / 验证方法
同上。
## 任务 4:extractErrorMessage 导出与三字段覆盖
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
### 功能点要求
http.ts 的 `extractErrorMessage` 提升为命名导出(保持内部逻辑);错误对象覆盖 `error`/`message`/`msg` 三字段;字符串响应体回退;无字段回退 axios message / 通用文案。
### 测试用例(≥8)
1. test_extract_error_field — error 字段优先
2. test_extract_message_field — message 字段
3. test_extract_msg_field — msg 字段
4. test_extract_error_precedence — error > message > msg
5. test_extract_string_body — 字符串响应体
6. test_extract_fallback_message — 无字段回退
7. test_extract_axios_non_error — 非 AxiosError
8. test_extract_blank_values_skipped — 空字符串跳过
### TDD 流程 / 验证方法
同上。
## 任务 5:normalizeStatus() 状态归一
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
### 功能点要求
`normalizeStatus(raw: string|null|undefined): string`:小写转大写(success→SUCCESS);带空格/连字符清理(in-progress→IN_PROGRESS);null/undefined/空串返回原样或 ''(不抛);未知值透传不改。
### 测试用例(≥8)
1. test_normalize_lower_to_upper — success→SUCCESS
2. test_normalize_mixed_case — rUnNiNg→RUNNING
3. test_normalize_with_hyphen — in-progress→IN_PROGRESS
4. test_normalize_null — null 安全
5. test_normalize_undefined — undefined 安全
6. test_normalize_empty_string — 空串返回空
7. test_normalize_unknown_passthrough — 未知值(SYNCING)原样
8. test_normalize_whitespace_padded — 首尾空白清理
### TDD 流程 / 验证方法
同上。
## 任务 6:isTerminalStatus() 终态判定
**所属模块**:01 适配层 **依赖**:5 **预估**:8-15 分钟
### 功能点要求
`isTerminalStatus(status, extras?)`:默认 SUCCESS/FAILED 为终态;可扩展(CANCELLED);先经 normalizeStatus;空值非终态。
### 测试用例(≥8)
1. test_terminal_success — SUCCESS true
2. test_terminal_failed — FAILED true
3. test_terminal_lowercase — success true(归一后)
4. test_terminal_pending_false — PENDING false
5. test_terminal_null_false — null false
6. test_terminal_cancelled_default_false — CANCELLED 默认 false
7. test_terminal_cancelled_extended_true — 传 extras 后 true
8. test_terminal_unknown_false — 未知状态 false
### TDD 流程 / 验证方法
同上。
## 任务 7:buildDownloadUrl() 统一下载 URL
**所属模块**:01 适配层 **依赖**:2 **预估**:8-15 分钟
### 功能点要求
`buildDownloadUrl(path, userId?)`:下载端点拼 user_id 附加规则(有 userId 时追加);已有 user_id 参数时不重复;无 userId 不追加;支持 freshDownloadUrl 优先的辅助 `resolveDownloadUrl(item)`(fresh 优先,缺失回退 downloadUrl)。
### 测试用例(≥8)
1. test_download_url_user_id — 追加 user_id
2. test_download_url_no_user_id — 无 userId 不追加
3. test_download_url_existing_user_id — 已含不重复
4. test_resolve_download_fresh_priority — freshDownloadUrl 优先
5. test_resolve_download_fallback — 缺失回退 downloadUrl
6. test_resolve_download_both_blank — 都空返回空
7. test_download_url_query_merge — 已有 query 合并
8. test_resolve_download_null_safe — null 安全
### TDD 流程 / 验证方法
同上。
## 任务 8:callJava 透传 AbortController
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
### 功能点要求
callJava 支持 `{ signal }`:axios 透传;signal 已中止时请求立即失败(AbortError);页面卸载可取消 in-flight。
### 测试用例(≥8)
1. test_signal_abort_before_send — 发送前中止立即拒绝
2. test_signal_abort_mid_request — 进行中中止拒绝
3. test_signal_passthrough — signal 传到 axios 配置
4. test_signal_abort_error_message — 错误消息含 AbortError 特征
5. test_signal_not_provided — 无 signal 正常
6. test_abort_after_resolve — 完成后 abort 无副作用
7. test_abort_rejects_promise — 中止拒绝 Promise
8. test_signal_multiple_calls_independent — 多次调用互不影响
### TDD 流程 / 验证方法
同上。
## 任务 9:进度类请求默认超时
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
### 功能点要求
进度类 API 函数(get*TaskProgressBatch)默认 10s 超时(现有 30s);可通过配置覆盖;非进度请求保持 30s。
### 测试用例(≥8)
1. test_progress_timeout_default — 进度请求 10s
2. test_progress_timeout_override — 显式覆盖生效
3. test_non_progress_timeout_30s — 非进度 30s
4. test_timeout_config_name — 配置键存在且为正数
5. test_progress_timeout_minimum — 非法配置钳制
6. test_override_via_options — 函数级 options 覆盖
7. test_timeout_zero — 0 钳制为正数
8. test_default_config_freeze — 默认值快照
### TDD 流程 / 验证方法
同上。
## 任务 10:types/task.ts 共享类型
**所属模块**:01 适配层 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
新建 `src/shared/api/types/task.ts`:`TaskStatus`(联合类型)、`ResultFilePhase`(fileReady/fileStatus/fileProgress*/freshDownloadUrl 可选)、`PageResult<T>`、`TaskProgressBatchVo`。纯类型,测试以类型断言为主(可降为 5 用例)。
### 测试用例(≥5)
1. test_type_task_status_assignable — SUCCESS 等可赋值
2. test_type_result_file_phase_all_optional — 字段全部可选
3. test_type_page_result_shape — 分页字段结构
4. test_type_progress_batch_shape — 批量进度结构
5. test_type_compat_compile — vue-tsc 全量通过
### TDD 流程 / 验证方法
先写类型 + 编译期断言(`@ts-expect-error` 负例),RED 后实现。
## 任务 11:拆分 dedupe 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
### 功能点要求
将 java-modules.ts 中 dedupe 相关函数(runDedupe/getDedupeHistory/deleteDedupeHistory/getDedupeResultDownloadUrl)及类型移到 `types/modules/dedupe.ts`;内部改调 callJava+buildJavaUrl;函数签名、参数、返回语义一字不变。
### 测试用例(≥8)
1. test_dedupe_run_url — runDedupe 请求 URL 正确
2. test_dedupe_run_method_payload — POST + 请求体
3. test_dedupe_history_url — history URL/method
4. test_dedupe_delete_history — delete URL/method
5. test_dedupe_download_url — download URL + user_id
6. test_dedupe_signature_unchanged — 参数顺序与类型快照
7. test_dedupe_export_compat — 旧路径 import 可用
8. test_dedupe_unwrap — 返回解包后的 data
### TDD 流程 / 验证方法
同上(mock adapter 断言 URL)。
## 任务 12:拆分 split 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
与 11 同构:runSplit/getSplitHistory/deleteSplitHistory/getSplitResultDownloadUrl + SplitRunRequest/SplitRunVo/SplitHistoryVo/SplitArchiveEntry。
### 测试用例(≥8)
split 对应 8 例:run URL/method/payload、history、delete、download+user_id、签名快照、旧 import 兼容、解包、异常回传。
## 任务 13:拆分 convert 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
与 11 同构:getExcelInfo/runConvert/getConvertHistory/deleteConvertHistory/getConvertResultDownloadUrl/getConvertTemplates/importConvertTemplate/setDefaultConvertTemplate/deleteConvertTemplate + 模板相关类型。
### 测试用例(≥8)
convert 对应 8 例:getExcelInfo URL、runConvert 解析、history、download、模板列表/导入/默认/删除 URL、签名快照。
## 任务 14:拆分 publish 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
publish:parsePublish/activatePublishTask/activatePublishFile/getPublishItemsPage/getPublishTaskProgressBatch/submitPublishTaskResult/getPublishDashboard/getPublishHistory/deletePublishTask。
### 测试用例(≥8)
publish 8 例:parse URL、activate、itemsPage 分页参数、progressBatch(含超时断言)、submitResult 请求体、dashboard、delete、签名快照。
## 任务 15:拆分 similar-asin 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
similar-asin:parseSimilarAsin/getSimilarAsinDashboard/getSimilarAsinHistory/getSimilarAsinTaskProgressBatch/activateSimilarAsinTask/deleteSimilarAsinTask/deleteSimilarAsinHistory/getSimilarAsinResultDownloadUrl。
### 测试用例(≥8)
similar-asin 8 例:parse URL/payload、progressBatch 10s 超时、activate user_id、history、dashboard、delete task/history、download。
## 任务 16:拆分 appearance-patent 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
appearance-patent:parseAppearancePatent/getAppearancePatentParsedPayload/getAppearancePatentQueuePayload/getAppearancePatentDashboard/getAppearancePatentHistory/getAppearancePatentTaskProgressBatch/activateAppearancePatentTask/deleteAppearancePatentTask/deleteAppearancePatentHistory/getAppearancePatentResultDownloadUrl。
### 测试用例(≥8)
8 例:parse、parsedPayload、queuePayload、progressBatch、activate、dashboard、history、delete/download。
## 任务 17:拆分 delete-brand 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
delete-brand:runDeleteBrand/getDeleteBrandHistory/deleteDeleteBrandHistory/getDeleteBrandTaskDetail/getDeleteBrandTaskDetails/getDeleteBrandTaskDownloadUrl/getDeleteBrandResultDownloadUrl/submitDeleteBrandResult。
### 测试用例(≥8)
8 例:run URL、taskDetail/taskDetails、taskDownloadUrl、resultDownloadUrl、submitResult 请求体、delete、history、签名快照。
## 任务 18:拆分 price-track 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
price-track:listPriceTrackCandidates/add/deleteCandidate/getCountryPreference/putPreference/matchPriceTrackShops/createPriceTrackTask/getPriceTrackTasksBatch/getPriceTrackTaskProgressBatch/deletePriceTrackTask/loopRun 系列/checkTaskSkipPriceAsin/markPriceTrackDispatchFailed。
### 测试用例(≥8)
8 例:create URL/payload、progressBatch、loopRun 创建/派发、skipAsin 检查、candidates、preference、download、签名快照。
## 任务 19:拆分 shop-match / product-risk 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
shop-match + product-risk:matchProductRiskShops/listProductRiskCandidates/add/deleteCandidate/getCountryPreference/putPreference/getShopMatchTaskProgressBatch/getProductRiskTaskProgressBatch/getProductRiskDashboard/getProductRiskHistory。
### 测试用例(≥8)
8 例:matchShops URL、candidates CRUD、preference、两个 progressBatch、dashboard、history、签名快照。
## 任务 20:拆分 shop-data-crawl / query-asin 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
shop-data-crawl + query-asin:listShopDataCrawlCandidates/matchShopDataCrawlShops/createShopDataCrawlTask/getShopDataCrawlDashboard/getShopDataCrawlHistory/getShopDataCrawlTaskProgressBatch/deleteShopDataCrawlTask/deleteShopDataCrawlHistory/getShopDataCrawlResultDownloadUrl + query-asin 对应函数。
### 测试用例(≥8)
8 例:create URL、progressBatch、candidates、dashboard/history、query-asin 组、download、签名快照、旧 import。
## 任务 21:拆分 withdraw / patrol-delete 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
withdraw + patrol-delete:listWithdrawCandidates/matchWithdrawShops/createWithdrawTask/submitWithdrawTaskResult/getWithdrawTaskProgressBatch/getWithdrawResultDownloadUrl + patrol-delete 对应。
### 测试用例(≥8)
8 例:withdraw create、submitResult、progress、patrol-delete 组、download、签名快照、旧 import、异常回传。
## 任务 22:拆分 collect-data 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
collect-data:parseCollectData/activateCollectDataTask/getCollectDataItemsPage/getCollectDataDashboard/getCollectDataHistory/getCollectDataTaskProgressBatch/deleteCollectDataTask/deleteCollectDataHistory/failCollectDataTask/getCollectDataCountryPreference/putCollectDataCountryPreference。
### 测试用例(≥8)
8 例:parse、itemsPage 分页参数、progressBatch、fail 请求体、preference、dashboard、delete、签名快照。
## 任务 23:拆分 image-video / brand / permission / digital-human 模块 API
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
image-video(secret/workflow/voice/asyncTask 系列)+ brand(BrandTaskListResponse 相关)+ permission + digital-human 独立文件已有,移动对齐。
### 测试用例(≥8)
8 例:image-video workflow 创建、result 查询、voice 列表/删除、brand 列表、permission、digital-human、签名快照、旧 import。
## 任务 24:java-modules.ts 改 re-export 聚合
**所属模块**:01 适配层 **依赖**:11-23 **预估**:8-15 分钟
java-modules.ts 只保留 re-export:`export * from './types/modules/dedupe'` 等;删光被移动的函数体;任何旧 import 路径继续可用(类型与运行时双兼容)。
### 测试用例(≥8)
1. test_reexport_all_symbols — 全部导出符号可从 java-modules 获取
2. test_reexport_type_compiles — 类型 import 可用
3. test_reexport_no_duplicate — 无重复导出
4. test_reexport_build_passes — vue-tsc 全量通过
5. test_reexport_import_compat — 各页面旧 import 快照编译
6. test_reexport_no_dead_body — 原函数体不存在(防残留)
7. test_reexport_runtime_symbols — 运行时函数可调用
8. test_reexport_vitest_full — 全量测试绿
### TDD 流程 / 验证方法
先写 re-export 后的测试断言(指向符号存在)→ 尚未 re-export 时 RED → 改文件 GREEN → `npm run build`(vue-tsc + vite build)通过。
## 任务 25:ResultFilePhase 新字段兼容默认值
**所属模块**:01 适配层 **依赖**:10 **预估**:8-15 分钟
`applyFilePhaseDefaults(item)`:fileReady/fileStatus/fileProgress* 缺省补默认(false/'PENDING'/0/0/0);旧 Java 版本响应(无新字段)时页面行为一致。
### 测试用例(≥8)
1. test_defaults_filled — 缺省字段补齐
2. test_existing_values_kept — 已有值不覆盖
3. test_file_ready_true_preserved — true 保留
4. test_partial_input — 部分字段缺失补齐
5. test_null_input_safe — null 安全
6. test_defaults_idempotent — 二次调用幂等
7. test_status_success_maps_ready — fileStatus=SUCCESS 且 fileReady 缺失 → ready true
8. test_unknown_status_untouched — 未知 status 不动
### TDD 流程 / 验证方法
同上。
## 任务 26:模块 API 快照契约测试基建
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
测试基建:vitest + axios mock adapter(或拦截 http.request),对每个模块 API 函数断言(url, method, params, data)快照;集中式 `assertApiCall()` helper。
### 测试用例(≥8)
1. test_snapshot_helper_url — helper 断言 URL
2. test_snapshot_helper_method — 断言 method
3. test_snapshot_helper_params — 断言 query
4. test_snapshot_helper_body — 断言请求体
5. test_snapshot_all_modules_covered — 全部已拆模块注册
6. test_snapshot_fail_message — 失败信息含 URL 上下文
7. test_snapshot_allowlist — 白名单外字段报错
8. test_snapshot_regression_guard — 快照变更即失败
### TDD 流程 / 验证方法
同上。
## 任务 27:api-field-compat 高频响应 schema
**所属模块**:01 适配层 **依赖**:26 **预估**:8-15 分钟
为 task/result 核心响应注册 schema(taskId/resultId/status/fileStatus/fileReady/downloadUrl 等),接入 createApiFieldCompatChecker 在契约测试与联调前跑检查。
### 测试用例(≥8)
1. test_schema_task_required_fields — 必填字段声明
2. test_schema_result_required_fields — 结果字段
3. test_checker_passes_valid — 合法对象通过
4. test_checker_missing_required — 缺必填报 missing
5. test_checker_wrong_type — 类型不符报 type
6. test_checker_batch — 批量检查
7. test_schema_registered_modules — 各模块 schema 注册齐全
8. test_schema_versioned — schema 版本标记
### TDD 流程 / 验证方法
同上。
## 任务 28:死代码清理
**所属模块**:01 适配层 **依赖**:24 **预估**:8-15 分钟
拆分后 grep 确认 java-modules.ts 无残留函数体、无未引用导出;删除确认死代码;`npm run build` + 全量测试验证。
### 测试用例(≥8,测试为验证型)
1. test_no_unexported_duplicates — 无重复导出
2. test_build_typecheck — vue-tsc 通过
3. test_full_vitest_green — 全量测试绿
4. test_no_console_debug_left — 无调试日志残留
5. test_no_unused_import — 无未用 import(lint)
6. test_entry_points_compile — 17 个入口编译
7. test_bundle_build — vite build 产出
8. test_git_diff_scope — 变更仅限 api 目录
### TDD 流程 / 验证方法
`npm run build` + `npx vitest run` 全绿。
@@ -0,0 +1,399 @@
# 02-plan — 任务轮询审计补强
> 对应 `docs/specs/02-task-polling-audit.md`。技术栈:TypeScript + Vitest(`frontend-vue/`)。
> 核心决策:不重写,只补强;`getTaskPollBackoffMs` 保持签名向后兼容。
## 任务 29:退避配置项(MaxMs/Factor)
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
task-progress-config.ts 新增 `getTaskPollBackoffMaxMs()`(默认 10000)与 `getTaskPollBackoffFactor()`(默认 2);默认值可通过 window 配置/测试注入覆盖。
### 测试用例(≥8)
1. test_backoff_max_default — 默认 10000
2. test_backoff_factor_default — 默认 2
3. test_backoff_max_override — 可覆盖
4. test_backoff_max_positive — 非正钳制
5. test_backoff_factor_min_one — factor <1 钳制为 1
6. test_backoff_config_isolated — 配置隔离(不串到其他用例)
7. test_backoff_max_freeze — 默认值快照
8. test_backoff_factor_freeze — factor 快照
### TDD 流程
1. 写测试 → `npx vitest run src/shared/__tests__/task-progress-config.test.ts` RED
2. 实现 → GREEN
3. `vue-tsc --noEmit` 通过
## 任务 30:getTaskPollBackoffMs 递增序列
**所属模块**:02 轮询 **依赖**:29 **预估**:8-15 分钟
### 功能点要求
`getTaskPollBackoffMs(attempt)`:500 * factor^attempt 递增;attempt=0 返回 500(与现状一致);上限 maxMs;现签名向后兼容(attempt 省略视为 0)。
### 测试用例(≥8)
1. test_backoff_attempt0_500 — attempt0=500
2. test_backoff_attempt1_1000 — attempt1=1000
3. test_backoff_attempt2_2000 — attempt2=2000
4. test_backoff_sequence_monotonic — 序列递增
5. test_backoff_capped_at_max — 封顶 10000
6. test_backoff_no_attempt_default — 省略参数=500
7. test_backoff_negative_attempt_zero — 负 attempt 当 0
8. test_backoff_custom_factor — 自定义 factor 生效
### TDD 流程 / 验证方法
同上。
## 任务 31:连续失败计数
**所属模块**:02 轮询 **依赖**:30 **预估**:8-15 分钟
### 功能点要求
轮询循环维护失败计数:refreshOnce 成功(收到响应)归零;连续失败递增;提供测试可观测出口(onError 带 attempt)。
### 测试用例(≥8)
1. test_failure_count_increments — 连续失败递增
2. test_success_resets_count — 成功后归零
3. test_any_response_resets — 4xx 也算收到响应归零
4. test_on_error_receives_attempt — onError 带 attempt
5. test_initial_count_zero — 初始 0
6. test_interleaved_fail_success — 失败成功交错计数正确
7. test_count_bounded — 计数有界(不溢出)
8. test_dispose_clears_count — dispose 后不再上报
### TDD 流程 / 验证方法
同上。
## 任务 32:退避封顶
**所属模块**:02 轮询 **依赖**:30,31 **预估**:8-15 分钟
### 功能点要求
失败计数继续增长但退避间隔停在 maxMs;达到封顶后不再增长(间隔恒等于 maxMs)。
### 测试用例(≥8)
1. test_backoff_cap_reached — 达到封顶
2. test_backoff_stays_capped — 之后保持 maxMs
3. test_cap_with_low_max — 低 maxMs 提前封顶
4. test_cap_with_high_factor — 高 factor 快速封顶
5. test_cap_resets_after_success — 成功后重新从 500 起
6. test_cap_attempt_boundary — 恰好等于封顶那一档
7. test_cap_integration_loop — 集成:循环内退避生效
8. test_cap_config_negative — 非法 maxMs 钳制
### TDD 流程 / 验证方法
同上。
## 任务 33:网络错误走退避且不触发终态
**所属模块**:02 轮询 **依赖**:31 **预估**:8-15 分钟
### 功能点要求
网络错误(fetch 拒绝/超时)不触发 onTerminal、不修改 taskStatuses、进入退避;恢复后继续轮询。
### 测试用例(≥8)
1. test_network_error_no_terminal — 不触发 onTerminal
2. test_network_error_no_status_change — 状态不变
3. test_network_error_backoff_scheduled — 进入退避
4. test_network_error_on_error_called — onError 调用
5. test_network_recovery — 恢复后轮询继续
6. test_network_error_repeated — 多次失败仍退避
7. test_network_error_keeps_task — 任务不丢失
8. test_network_error_then_success — 失败后成功收到响应
### TDD 流程 / 验证方法
vitest fake timers + mock fetch 拒绝。
## 任务 34:HTTP 4xx/5xx 分类
**所属模块**:02 轮询 **依赖**:31 **预估**:8-15 分钟
### 功能点要求
4xx/5xx 记 onError 并退避;5xx 且无法解析明细时不误判 FAILED;不触发终态。
### 测试用例(≥8)
1. test_4xx_on_error — 4xx 记 onError
2. test_5xx_on_error — 5xx 记 onError
3. test_5xx_no_terminal_failed — 不误判 FAILED
4. test_5xx_backoff — 5xx 退避
5. test_5xx_unknown_status_untouched — 未知状态不动
6. test_4xx_recovery — 4xx 后恢复
7. test_status_500_partial_items — 部分 items 仍处理
8. test_5xx_no_status_wipe — 不清空已有状态
### TDD 流程 / 验证方法
同上。
## 任务 35:未知状态不判终态固化
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
PENDING/SYNCING/空串/undefined 状态:isTerminal=false,不触发终态回调,轮询继续。
### 测试用例(≥8)
1. test_pending_not_terminal — PENDING false
2. test_syncing_not_terminal — SYNCING false
3. test_empty_status_not_terminal — 空串 false
4. test_undefined_status_not_terminal — undefined false
5. test_unknown_status_continues_polling — 轮询继续
6. test_mixed_terminal_unknown — 同批终态+未知分开处理
7. test_custom_is_terminal — 自定义判定生效
8. test_lowercase_unknown — 小写未知值也不误判
### TDD 流程 / 验证方法
扩展 polling-state-machine.test.ts。
## 任务 36:终态任务仅一次 onTerminal
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
coordinator.markTerminal 语义:终态任务只触发一次 onTerminal;重复收到同任务终态不再回调;从轮询集合移除。
### 测试用例(≥8)
1. test_terminal_called_once — 只一次
2. test_terminal_removed_from_poll — 移除
3. test_terminal_repeat_response — 重复响应不回调
4. test_terminal_after_readd — 重新 add 后可再触发
5. test_terminal_multiple_tasks — 多任务各自一次
6. test_terminal_coordinator_order — markTerminal 先于 remove
7. test_terminal_storage_cleared — localStorage 清空
8. test_terminal_dispose_no_call — dispose 后不回调
### TDD 流程 / 验证方法
同上。
## 任务 37:onTerminal 抛错语义测试
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
onTerminal 抛错:任务已从轮询集合移除(语义固化);错误不中断其他终态回调;页面可自行重新 add() 恢复。
### 测试用例(≥8)
1. test_terminal_error_does_not_break_loop — 不中断循环
2. test_terminal_error_task_removed — 任务已移除
3. test_terminal_error_re_add_works — 重新 add 生效
4. test_terminal_error_other_tasks — 其他终态仍回调
5. test_terminal_error_swallowed — 错误被捕获不抛到外层
6. test_terminal_error_then_success — 后一轮正常
7. test_terminal_error_not_retried — 不自动重试回调
8. test_terminal_error_status_kept — 状态保留
### TDD 流程 / 验证方法
同上。
## 任务 38:同轮多任务终态分别回调
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
同一轮响应中多个任务同时终态:每个任务各触发一次 onTerminal(带各自 detail/status);顺序按响应顺序。
### 测试用例(≥8)
1. test_multi_terminal_each_called — 各自回调
2. test_multi_terminal_correct_detail — 各自 detail
3. test_multi_terminal_correct_status — 各自 status
4. test_multi_terminal_order — 按响应顺序
5. test_multi_terminal_one_fails_other_runs — 一个抛错另一个仍回调
6. test_multi_terminal_all_removed — 全部移除
7. test_multi_terminal_await_sequence — 依次 await
8. test_multi_terminal_async_on_terminal — 异步回调等待
### TDD 流程 / 验证方法
同上。
## 任务 39:in-flight 合并测试补强
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
in-flight 期间不叠加 timer;等待上一次完成再按退避重试;同一时间只有一个请求。
### 测试用例(≥8)
1. test_in_flight_no_second_request — 不并发
2. test_in_flight_queues_after — 完成后继续
3. test_in_flight_backoff_wait — 等待按退避
4. test_in_flight_timer_single — 仅一个 timer
5. test_in_flight_add_during — 期间 add 不重复
6. test_in_flight_error_releases — 失败后释放
7. test_in_flight_immediate_repeat — ensure(true) 不叠加
8. test_in_flight_long_request — 长请求期间无叠加
### TDD 流程 / 验证方法
同上。
## 任务 40:页面隐藏降频与可见恢复
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
visibilityState=hidden 时 30s 间隔;切回 visible 立即刷新(开关可配置、延迟可配置);降频不改任务集合。
### 测试用例(≥8)
1. test_hidden_30s_interval — 隐藏 30s
2. test_visible_5s_interval — 可见 5s
3. test_foreground_refresh_triggered — 恢复立即刷新
4. test_foreground_refresh_disabled — 开关关闭不刷新
5. test_foreground_refresh_delayed — 延迟生效
6. test_hidden_polling_continues — 隐藏仍轮询
7. test_visibility_event_bound_unbound — 事件绑定/解绑
8. test_hidden_no_immediate_refresh — 隐藏不触发即时刷新
### TDD 流程 / 验证方法
mock document.visibilityState + dispatchEvent。
## 任务 41:storage 恢复与清理
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
恢复时过滤非正数/非数字;空列表清除 key;终态清理后同步 storage;写失败不影响功能。
### 测试用例(≥8)
1. test_storage_restore_valid_ids — 恢复合法 id
2. test_storage_restore_filters_invalid — 过滤非法
3. test_storage_restore_empty_clears — 空列表清 key
4. test_storage_terminal_removes — 终态后 key 更新
5. test_storage_write_failure_ignored — 写失败不抛
6. test_storage_bad_json — 坏 JSON 返回空
7. test_storage_restore_starts_polling — 恢复即开始轮询
8. test_storage_no_key_noop — 无 key 无操作
### TDD 流程 / 验证方法
mock localStorage。
## 任务 42:退避恢复测试
**所属模块**:02 轮询 **依赖**:31,32 **预估**:8-15 分钟
### 功能点要求
失败→退避序列→成功→恢复 500ms 正常间隔;连续失败计数归零后重新从 500 起。
### 测试用例(≥8)
1. test_recovery_after_failure — 失败后成功恢复
2. test_backoff_reset_after_success — 计数归零
3. test_interval_returns_to_base — 回到正常间隔
4. test_recovery_cycle_repeat — 多次失败成功循环
5. test_recovery_partial_items — 部分成功算成功
6. test_recovery_with_foreground — 前台刷新下恢复
7. test_recovery_after_many_failures — 长失败后恢复
8. test_recovery_timing_assert — 时间断言(fake timers)
### TDD 流程 / 验证方法
fake timers 时间断言。
## 任务 43:progressCache TTL 惰性清理边界
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
缓存条目超 TTL 在读取时清理;条目数上限(溢出淘汰最旧);空缓存 get 返回 undefined。
### 测试用例(≥8)
1. test_cache_get_hit — 命中返回
2. test_cache_get_expired_cleared — 过期清理
3. test_cache_max_entries_evict — 超上限淘汰
4. test_cache_empty_get_undefined — 空缓存
5. test_cache_set_overwrites — 同 key 覆盖
6. test_cache_ttl_zero — TTL=0 立即过期
7. test_cache_lazy_cleanup — 惰性清理不主动扫
8. test_cache_after_polling_cycle — 轮询周期内缓存可用
### TDD 流程 / 验证方法
扩展 progress-response-cache.test.ts。
## 任务 44:轻量端点切换能力
**所属模块**:02 轮询 **依赖**:26 **预估**:8-15 分钟
### 功能点要求
useTaskProgressLoop 的 fetchProgress 可切到轻量端点(只返回 taskId/status/fileStatus 的 items);返回结构兼容(extractTaskId/extractStatus 从轻量字段取);默认仍走原端点。
### 测试用例(≥8)
1. test_light_fetch_used — 切换后调轻量
2. test_light_detail_shape_parsed — 轻量结构解析
3. test_light_fallback_to_old — 默认旧端点
4. test_light_missing_optional — 轻量缺字段容错
5. test_light_terminal_detection — 终态判定
6. test_light_progress_cache — 缓存写入
7. test_light_on_update_called — onUpdate 收到
8. test_light_snapshot_compat — 与旧响应兼容
### TDD 流程 / 验证方法
同上。
## 任务 45:轮询与历史刷新分离
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
进度轮询不触发历史接口;历史刷新独立触发(onTerminal 或页面主动);同一轮中不混发 history 请求。
### 测试用例(≥8)
1. test_polling_no_history_request — 轮询不发 history
2. test_terminal_triggers_history — 终态触发历史刷新
3. test_history_separate_call — 独立调用
4. test_no_burst_history — 同轮不多发
5. test_history_ttl_cache — 历史 TTL 生效
6. test_history_force_refresh — force 参数跳过缓存
7. test_polling_history_parallel — 可并行不阻塞
8. test_polling_continues_after_history — 历史后轮询继续
### TDD 流程 / 验证方法
同上。
## 任务 46:双页面同 key 行为记录
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
只读断言现状:两页面同 storageKey 时各自独立轮询集合,互不等待(记录已知边界,不改实现)。
### 测试用例(≥8)
1. test_two_loops_same_key_independent — 独立
2. test_shared_key_no_crash — 不崩溃
3. test_shared_key_last_write — 写互相覆盖(现状)
4. test_shared_key_restore_both — 各自恢复
5. test_shared_key_no_live_sync — 无实时同步(现状)
6. test_shared_key_dispose_one — 一方卸载另一方不受影响
7. test_documented_boundary — 行为与文档一致
8. test_shared_key_separate_storage — 不同 key 完全隔离
### TDD 流程 / 验证方法
同上。
## 任务 47:轮询 baseline 统计补强
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
baseline 记录:请求量、响应体大小、缓存内存占用、轮询失败次数;每轮 refreshOnce 后回传 baseline 实例。
### 测试用例(≥8)
1. test_baseline_request_count — 请求计数
2. test_baseline_response_size — 响应大小
3. test_baseline_cache_usage — 缓存占用
4. test_baseline_failure_count — 失败次数
5. test_baseline_callback_after_round — 每轮回调
6. test_baseline_round_accuracy — 轮次准确
7. test_baseline_reset — 重置
8. test_baseline_optional_off — 不传 onBaseline 不创建
### TDD 流程 / 验证方法
扩展 task-polling-baseline.test.ts。
## 任务 48:轮询全量回归
**所属模块**:02 轮询 **依赖**:29-47 **预估**:8-15 分钟
### 功能点要求
20 个既有轮询相关测试 + 本轮新增全部通过;`npm run build`(vue-tsc)通过;无行为回退。
### 测试用例(≥8)
1-8. 回归清单:既有 20 文件全绿、新 19 文件全绿、build 通过、无类型错误、无未用导出、页面入口编译、快照一致、git diff 仅限 shared 目录
### TDD 流程 / 验证方法
`npx vitest run` 全绿 + `npm run build` 通过。
@@ -0,0 +1,169 @@
# 03-plan — RequestTraceFilter 验证与补测
> 对应 `docs/specs/03-request-trace-filter.md`。**实现已完成**(multipart 直通、阈值 1MB、5 个测试)。
> 本 plan 将测试补齐到 ≥8/功能点,并对实现做验证型补强。技术栈:Java 21 + JUnit5 + MockMvc(`backend-java/`)。
> 测试命令:`cd crawler-plugin/backend-java && mvn test -Dtest=<类名>`。
## 任务 49:multipart 直通断言补测
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
multipart Content-Type(含大小写、带 boundary 参数、其他 multipart 子类型)请求一律不包装;现有 5 个测试保留。
### 测试用例(≥8)
1. test_multipart_upper_boundary — Multipart/Form-Data 大写不包装
2. test_multipart_mixed_case — mUlTiPaRt 混合大小写
3. test_multipart_related — multipart/related 不包装
4. test_multipart_no_boundary — 无 boundary 不包装
5. test_multipart_with_params — 多参数 content-type
6. test_multipart_whitespace — 首尾空白 content-type
7. test_multipart_put_not_wrapped — multipart PUT 不包装
8. test_application_json_still_wrapped — 对照:json 仍包装
### TDD 流程
1. 追加测试 → 运行确认现有实现是否满足(若已满足为 GREEN,逐条确认覆盖)→ 任何一条失败修正实现
2. `mvn test -Dtest=RequestTraceFilterTest` 全绿
### 验证方法
`mvn test -Dtest=RequestTraceFilterTest`:Tests run ≥13。
## 任务 50:包装与阈值钳制补测
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
JSON/PUT/DELETE 包装;阈值钳制(<1MB 请求钳到 1MB 下限;0/负数钳制);ContentCachingRequestWrapper 构造参数生效。
### 测试用例(≥8)
1. test_json_post_wrapped_limit — json 用传入阈值
2. test_limit_below_minimum_clamped — 小于 1MB 钳制
3. test_limit_zero_clamped — 0 钳制
4. test_limit_negative_clamped — 负数钳制
5. test_limit_exact_minimum — 恰好 1MB 不钳
6. test_limit_large_kept — 大阈值保留
7. test_delete_wrapped — DELETE 包装
8. test_put_wrapped — PUT 包装
### TDD 流程 / 验证方法
同上(构造 RequestTraceFilter 实例断言阈值字段,或包内可见字段读取)。
## 任务 51:日志不读 body 行为测试
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
过滤器执行前后:body 缓存未被读取(日志只消费 method/uri/status/headers);JSON 请求过滤后业务侧仍可读 body。
### 测试用例(≥8)
1. test_filter_log_no_body_read — 日志不含 body 内容
2. test_filter_passes_chain — 过滤链正常
3. test_business_reads_body_json — 业务可读 json body
4. test_business_reads_body_multipart — multipart 业务可读
5. test_body_read_after_filter — 过滤后输入流可再读
6. test_headers_added — 实例响应头存在
7. test_cost_logged — costMs 记录
8. test_request_id_logged — requestId 传递
### TDD 流程 / 验证方法
MockMvc 集成:POST json 断言 200 + 业务 handler 收到 body。
## 任务 52:阈值生效集成测试
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
>1MB JSON 请求不整包缓存(wrapper 截断缓存);body 读取行为正确;multipart 大文件上传不受影响。
### 测试用例(≥8)
1. test_large_json_over_1mb — >1MB json 请求成功
2. test_large_json_not_cached_fully — 缓存截断(断言 wrapper 截断语义)
3. test_large_multipart_upload — >1MB multipart 上传成功
4. test_large_body_business_reads — 业务读完整 body
5. test_small_json_cached — 小 json 正常缓存
6. test_upload_content_length_header — content-length 保留
7. test_large_json_forward_path — 转发路径大 body 正常
8. test_large_json_time_bounded — 大 body 处理耗时合理
### TDD 流程 / 验证方法
MockMvc + 大字符串 body(需注意阈值配置注入)。
## 任务 53:yml 默认值与 env 覆盖测试
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
application.yml 默认 1048576(1MB);`AIIMAGE_INSTANCE_ROUTE_REQUEST_BODY_CACHE_LIMIT_BYTES` 覆盖生效;占位符语法正确。
### 测试用例(≥8)
1. test_yml_default_1mb — yml 值 1048576
2. test_env_override_value — env 覆盖生效
3. test_env_override_large — 大值覆盖
4. test_env_override_small — 小值覆盖(被钳制)
5. test_placeholder_format — ${VAR:default} 格式
6. test_default_matches_code — 与代码默认一致
7. test_env_unset_uses_default — 未设 env 用默认
8. test_yml_loads — Spring 上下文加载配置
### TDD 流程 / 验证方法
配置加载测试(@Value 注入断言)。
## 任务 54:转发服务 multipart 安全测试
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
TaskOwnerForwardService.requestBody 非 wrapper 时走 inputStream 路径;multipart 转发不抛错;body 字节与原请求一致。
### 测试用例(≥8)
1. test_forward_non_wrapper_reads_stream — inputStream 路径
2. test_forward_wrapper_reads_cache — wrapper 路径
3. test_forward_multipart_body_ok — multipart 转发成功
4. test_forward_io_error_message — IO 异常消息
5. test_forward_hop_by_hop_removed — hop-by-hop 头剔除
6. test_forward_forwarded_header_set — 转发头设置
7. test_forward_content_type_kept — content-type 保留
8. test_forward_loop_detected — 循环转发拒绝
### TDD 流程 / 验证方法
MockHttpServletRequest + 反射/包可见调用 requestBody。
## 任务 55:转发 body 完整性测试
**所属模块**:03 过滤器 **依赖**:54 **预估**:8-15 分钟
### 功能点要求
转发后:JSON 与 multipart body 均与原始一致(字节级);双实例 owner 路由场景转发内容不损坏。
### 测试用例(≥8)
1. test_forward_json_bytes_equal — json 字节一致
2. test_forward_multipart_bytes_equal — multipart 字节一致
3. test_forward_empty_body — 空 body 安全
4. test_forward_large_body — 大 body 一致
5. test_forward_utf8_chinese — 中文内容一致
6. test_forward_special_chars — 特殊字符一致
7. test_forward_multiple_chunks — 多段内容一致
8. test_forward_identity_repeated — 两次转发一致
### TDD 流程 / 验证方法
同上。
## 任务 56:plan §6 文档现状修正核对
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
更新 `java-architecture-optimization-plan.md` §6:现状描述改为"已实现 multipart 直通 + 1MB 阈值 + 过滤器日志不读 body";移除"大范围缓存风险"表述;标注本轮未做项(上传指标/流式下载/磁盘告警→后续批次)。
### 测试用例(≥8,验证型)
1. test_doc_no_obsolete_default — 文档无 104857600 残留
2. test_doc_multipart_stated — 直通已记录
3. test_doc_threshold_1mb — 阈值 1MB 已记录
4. test_doc_not_reading_body — 不读 body 已记录
5. test_doc_deferred_listed — 未做项已列
6. test_doc_specs_referenced — 引用 03 spec
7. test_doc_consistency_overview — 与 00-overview 实施记录一致
8. test_doc_no_todo_left — 无 TBD/TODO 残留
### TDD 流程 / 验证方法
grep 校验文档(写一个简单断言脚本/测试读取 md 断言)。
@@ -0,0 +1,419 @@
# 04-plan — TaskResultFileJobWorker Handler 注册表
> 对应 `docs/specs/04-result-file-job-handler-registry.md`。技术栈:Java 21 + Spring + JUnit5。
> 纪律:第一阶段 Handler 只委托原 Service,不同时重写业务逻辑;Job 状态值、创建时机、重试入口不变。
## 任务 57:ResultFileJobHandler 接口定义
**所属模块**:04 注册表 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
`modules/task/service/ResultFileJobHandler.java`:moduleType() / process(job) 返回 boolean / cleanup(job) 默认空 / onFailure(job,msg) 默认空 / supportsAsyncOffload() 默认 false / isOwnerScoped() 默认 false。
### 测试用例(≥8)
1. test_interface_methods_present — 6 方法签名齐全
2. test_cleanup_default_noop — 默认空实现
3. test_on_failure_default_noop — 默认空实现
4. test_offload_default_false — 默认 false
5. test_owner_scoped_default_false — 默认 false
6. test_process_returns_boolean — boolean 返回类型
7. test_module_type_identity — moduleType 唯一标识
8. test_javadoc_contract — 契约文档注释齐全(模块类型对应表)
### TDD 流程
1. 写接口 + 编译测试(实现类模拟)→ 类不存在 RED
2. 实现接口 → GREEN
3. `mvn test` 通过
## 任务 58:注册表容器与唯一性校验
**所属模块**:04 注册表 **依赖**:57 **预估**:8-15 分钟
### 功能点要求
`ResultFileJobHandlerRegistry`:构造时收集 List<ResultFileJobHandler>,构建 moduleType→handler Map;重复 moduleType 抛 IllegalStateException(含模块名);提供 `resolve(moduleType)` 与 `moduleTypes()`。
### 测试用例(≥8)
1. test_register_all_handlers — 全部注册
2. test_resolve_existing — 解析已知模块
3. test_resolve_unknown_throws — 未知模块抛异常
4. test_duplicate_module_type_throws — 重复注册抛 IllegalStateException
5. test_duplicate_error_message — 错误消息含模块名
6. test_module_types_listed — 枚举全部模块
7. test_empty_registry_ok — 空注册表可解析(抛错)
8. test_resolve_case_sensitive — 大小写敏感
### TDD 流程
1. 写测试(先 mock handler)→ RED
2. 实现注册表 → GREEN
3. `mvn test -Dtest=ResultFileJobHandlerRegistryTest` 通过
## 任务 59:启动校验(fail-fast)
**所属模块**:04 注册表 **依赖**:58 **预估**:8-15 分钟
### 功能点要求
Spring 启动时校验:TaskFileJobConfig 的每个 moduleType 有且仅有一个 Handler;缺注册(如新增模块未配 Handler)启动失败并给出缺失清单。
### 测试用例(≥8)
1. test_startup_all_modules_covered — 全部 moduleType 覆盖
2. test_startup_missing_handler_fails — 缺注册启动失败
3. test_startup_missing_message_lists — 错误消息列缺失模块
4. test_startup_duplicate_fails — 双注册失败
5. test_startup_config_source — 从 TaskFileJobConfig 枚举
6. test_startup_no_handler_new_module — 新模块无 handler 失败
7. test_startup_valid_no_error — 合法配置启动通过
8. test_startup_check_idempotent — 校验可重复执行
### TDD 流程 / 验证方法
ApplicationContextRunner 或直接调用校验方法断言。
## 任务 60:SHOP_MATCH Handler
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
### 功能点要求
`ShopMatchResultFileJobHandler`:moduleType="SHOP_MATCH";process 委托 shopMatchTaskService.processResultFileJob 返回 true;cleanup 调 taskResultPayloadService.deleteLatest(原 cleanupAfterSuccess 分支)。
### 测试用例(≥8)
1. test_module_type — 正确
2. test_process_delegates — 委托调用
3. test_process_returns_true — true
4. test_cleanup_calls_delete_latest — 清理调用
5. test_cleanup_args — taskId/moduleType/scopeKey 参数
6. test_offload_false — 不支持异步
7. test_owner_scoped_false — 非 owner scoped
8. test_process_null_job_guarded — 空 job 安全
### TDD 流程
1. 写测试 mock Service → RED
2. 实现 Handler → GREEN
3. `mvn test -Dtest=ShopMatchResultFileJobHandlerTest` 通过
## 任务 61:PRICE_TRACK Handler
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
与 60 同构:moduleType="PRICE_TRACK";process→priceTrackTaskService;cleanup→deleteLatest。
### 测试用例(≥8)
8 例:moduleType、delegate、true、cleanup、参数、offload false、ownerScoped false、空 job。
## 任务 62:PRODUCT_RISK_RESOLVE Handler
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
与 60 同构:moduleType="PRODUCT_RISK_RESOLVE";process→productRiskTaskService。
### 测试用例(≥8)
同 61。
## 任务 63:PUBLISH Handler(ownerScoped)
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
moduleType=PublishTaskService.MODULE_TYPE;process→publishTaskService.processResultFileJob;cleanup→publishTaskService.cleanupResultFileJob;**isOwnerScoped()=true**(原 Worker isOwnerScopedJob 含 PUBLISH)。
### 测试用例(≥8)
1. test_module_type_constant — 用 MODULE_TYPE 常量
2. test_process_delegates
3. test_cleanup_delegates — cleanupResultFileJob
4. test_owner_scoped_true — true
5. test_process_true
6. test_cleanup_no_delete_latest — 不走 payload.deleteLatest
7. test_offload_false
8. test_null_job_guarded
## 任务 64:QUERY_ASIN Handler
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
与 60 同构:moduleType="QUERY_ASIN";process→queryAsinTaskService。
### 测试用例(≥8)
同 61。
## 任务 65:SHOP_DATA_CRAWL Handler(cleanup+onFailure)
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
moduleType="SHOP_DATA_CRAWL";process→shopDataCrawlTaskService;cleanup→deleteLatest + cleanupResultFileJob(两处都调);**onFailure→handleResultFileJobFailure**;**isOwnerScoped()=true**。
### 测试用例(≥8)
1. test_module_type
2. test_process_delegates
3. test_cleanup_delete_latest_and_service — 两处清理都调
4. test_on_failure_delegates — handleResultFileJobFailure
5. test_on_failure_args — job+message 参数
6. test_owner_scoped_true
7. test_process_true
8. test_null_job_guarded
## 任务 66:WITHDRAW Handler(finalize 时机保持)
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
moduleType="WITHDRAW";process→withdrawTaskService.processResultFileJob;cleanup→deleteLatest;**onSuccess 扩展:tryFinalizeTask 在 markSuccess 之后调用**(原 finalizeWithdraw 标志语义,时机严格保持)。
### 测试用例(≥8)
1. test_module_type
2. test_process_delegates
3. test_cleanup_delete_latest
4. test_finalize_after_success_order — 顺序:成功后再 finalize
5. test_finalize_called_once — 只调一次
6. test_finalize_false_result — 非成功不 finalize
7. test_owner_scoped_false
8. test_null_job_guarded
## 任务 67:PATROL_DELETE Handler
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
与 60 同构:moduleType="PATROL_DELETE";process→patrolDeleteTaskService。
### 测试用例(≥8)
同 61。
## 任务 68:APPEARANCE_PATENT Handler(异步+offload)
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
moduleType="APPEARANCE_PATENT";process→appearancePatentTaskService(返回 boolean,false=等待异步);cleanup→cleanupResultFileJob;**supportsAsyncOffload()=true;isOwnerScoped()=true**。
### 测试用例(≥8)
1. test_module_type
2. test_process_boolean_true — true 情况
3. test_process_boolean_false — false(等待异步)
4. test_cleanup_delegates
5. test_offload_true
6. test_owner_scoped_true
7. test_false_means_waiting — false 语义与 Worker defer 对应
8. test_null_job_guarded
## 任务 69:SIMILAR_ASIN Handler(异步+offload+onFailure)
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
moduleType="SIMILAR_ASIN";process→similarAsinTaskService(boolean);cleanup→cleanupResultFileJob;**onFailure→handleResultFileJobFailure;offload=true;ownerScoped=true**。
### 测试用例(≥8)
1. test_module_type
2. test_process_true / 3. test_process_false
4. test_cleanup_delegates
5. test_on_failure_delegates
6. test_offload_true
7. test_owner_scoped_true
8. test_null_job_guarded
## 任务 70:DELETE_BRAND Handler
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
moduleType="DELETE_BRAND";process→deleteBrandRunService;cleanup→cleanupResultFileJob。
### 测试用例(≥8)
1-8:moduleType、delegate、true、cleanup、offload false、ownerScoped false、参数、空 job。
## 任务 71:BRAND Handler(resolveResultObjectKey 特例)
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
moduleType="BRAND";process→brandTaskService.processResultFileJob;**resultFileUrl 解析特例:resolveResultObjectKey(无 resultId 也走)保留在 Worker 公共路径 resolveResultFileUrl**——Handler 不接管 URL 解析,测试验证该特例不受影响。
### 测试用例(≥8)
1. test_module_type
2. test_process_delegates
3. test_result_url_brand_special — brand resolveResultObjectKey 仍走公共路径
4. test_cleanup_delegates
5. test_offload_false
6. test_owner_scoped_false
7. test_null_job_guarded
8. test_no_delete_latest — brand 不走 payload.deleteLatest
## 任务 72:COLLECT_DATA Handler
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
moduleType="COLLECT_DATA";process→collectDataService.processResultFileJob;cleanup 为空(原无分支)。
### 测试用例(≥8)
1. test_module_type
2. test_process_delegates
3. test_process_true
4. test_cleanup_noop — 无清理
5. test_offload_false
6. test_owner_scoped_false
7. test_null_job_guarded
8. test_no_delete_latest
## 任务 73:Worker dispatch() 改注册表查找
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
### 功能点要求
TaskResultFileJobWorker.dispatch(job) 替换 13 个 if/else 为 `handlerRegistry.resolve(moduleType).process(job)`;未知模块 IllegalArgumentException 消息保留;Worker 注入改为 registry。
### 测试用例(≥8)
1. test_dispatch_resolves_handler — 注册表查找
2. test_dispatch_known_module — 已知模块行为一致
3. test_dispatch_unknown_throws — 未知模块 IllegalArgumentException
4. test_dispatch_unknown_message — 消息含模块名
5. test_dispatch_all_13_modules — 13 模块各委托正确
6. test_dispatch_null_job — 空 job 安全
7. test_dispatch_no_longer_branch — 无 if/else 残留(静态检查)
8. test_dispatch_integration_process — process 全链路
### TDD 流程
1. 测试先断言 dispatch 行为(对现有实现 GREEN 基线)→ 改为注册表后仍 GREEN
2. `mvn test` 相关测试通过
## 任务 74:cleanupAfterSuccess 改 handler.cleanup
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
cleanupAfterSuccess(job):公共 payload 清理保留(部分模块)或进 handler.cleanup;确保原分支语义逐一映射(SHOP_DATA_CRAWL 两处、APPEARANCE_PATENT/SIMILAR_ASIN/PUBLISH/DELETE_BRAND 各 cleanup、其余 deleteLatest)。
### 测试用例(≥8)
1. test_cleanup_shop_data_crawl_both — 两处清理
2. test_cleanup_delete_latest_modules — deleteLatest 模块组
3. test_cleanup_appearance — cleanupResultFileJob
4. test_cleanup_similar — cleanupResultFileJob
5. test_cleanup_publish — cleanupResultFileJob
6. test_cleanup_delete_brand — cleanupResultFileJob
7. test_cleanup_collect_data_noop — 无清理
8. test_cleanup_unknown_ignored — 未知模块不抛
## 任务 75:notifyRetryExhausted 改 handler.onFailure
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
notifyRetryExhausted(job,msg) 改 handler.onFailure;SHOP_DATA_CRAWL/SIMILAR_ASIN 有回调,其余 noop;回调幂等(失败重试安全)。
### 测试用例(≥8)
1. test_on_failure_shop_data_crawl — 回调
2. test_on_failure_similar — 回调
3. test_on_failure_others_noop — 其余无操作
4. test_on_failure_unknown_ignored — 未知模块安全
5. test_on_failure_idempotent — 重复调用安全
6. test_on_failure_error_swallowed — 回调抛错不中断
7. test_on_failure_args_passed — job+message 传递
8. test_exhausted_finalize_flow — 重试耗尽全流程
## 任务 76:coze offload 判定改 handler
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
process() 中 APPEARANCE_PATENT/SIMILAR_ASIN 的 cozeTaskExecutor offload 判定改 handler.supportsAsyncOffload();offload 失败回退内联逻辑保持。
### 测试用例(≥8)
1. test_offload_modules_detected — offload 模块识别
2. test_offload_executes_on_coze_executor — 线程池执行
3. test_offload_failure_fallback — 提交失败回退内联
4. test_offload_other_modules_inline — 非 offload 内联
5. test_offload_only_async_modules — 仅异步模块
6. test_offload_no_duplicate_execution — 不回退重复执行
7. test_offload_heartbeat_started — 心跳启动
8. test_offload_integration — 全链路
## 任务 77:owner-scoped 判定改 handler
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
isOwnerScopedJob 改 handler.isOwnerScoped();owner 解析(scopeKey :owner: 标记)保留公共逻辑;非本实例跳过逻辑保持。
### 测试用例(≥8)
1. test_owner_scoped_modules — 4 个 owner 模块
2. test_owner_scoped_other_owner_skip — 他实例跳过
3. test_owner_scoped_self_process — 本实例处理
4. test_owner_scope_parse — :owner: 解析
5. test_owner_scope_blank — 空 scope 视为本实例
6. test_owner_non_scoped_modules — 非 owner 模块不受影响
7. test_owner_unknown_instance_id — 未配置实例
8. test_owner_integration — 全链路
## 任务 78:模块映射快照测试
**所属模块**:04 注册表 **依赖**:73 **预估**:8-15 分钟
### 功能点要求
快照断言:13 个 moduleType → Handler 类 → 原 Service 方法一一对应;与 04 spec §3 映射表一致;新增模块类型未映射即失败。
### 测试用例(≥8)
1. test_snapshot_all_13_mapped — 13 全映射
2. test_snapshot_shop_match_delegate — 委托方法名快照
3. test_snapshot_appearance_boolean — 返回类型快照
4. test_snapshot_publish_owner — owner 标记快照
5. test_snapshot_failure_callbacks — onFailure 回调快照
6. test_snapshot_no_extra_modules — 无多余映射
7. test_snapshot_mapping_frozen — JSON 快照文件比对
8. test_snapshot_new_module_fails — 新 moduleType 快照失败
## 任务 79:行为等价对比测试
**所属模块**:04 注册表 **依赖**:73-77 **预估**:8-15 分钟
### 功能点要求
同一 Job 序列(成功/失败/重试耗尽/异步等待/owner 跳过)改造前后产生相同状态迁移与依赖调用;用 mock 记录调用序列对比。
### 测试用例(≥8)
1. test_equiv_success_job — 成功序列一致
2. test_equiv_failed_job — 失败序列一致
3. test_equiv_retry_exhausted — 重试耗尽一致
4. test_equiv_async_wait — 异步等待一致
5. test_equiv_owner_skip — owner 跳过一致
6. test_equiv_orphan_failure — 孤儿失败一致
7. test_equiv_call_sequence — 依赖调用顺序一致
8. test_equiv_state_transition — 状态迁移一致
### TDD 流程 / 验证方法
对比测试:改造前录制调用序列(golden),改造后断言一致。
## 任务 80:孤儿失败路径不回归
**所属模块**:04 注册表 **依赖**:73 **预估**:8-15 分钟
BusinessException 含 not found 文案 → markFailedPermanent;非孤儿失败 → markFailed + retry 判断;错误文案匹配清单(task not found/result record not found/任务不存在/记录不存在)。
### 测试用例(≥8)
1. test_orphan_task_not_found_en — 英文文案
2. test_orphan_result_not_found_en
3. test_orphan_cn_messages — 中文文案
4. test_orphan_mark_permanent — markFailedPermanent
5. test_non_orphan_mark_failed — 普通失败
6. test_non_business_exception — 非业务异常
7. test_retry_exhausted_after_orphan — 耗尽后终态
8. test_orphan_no_requeue — 孤儿不重排
## 任务 81:卡死扫描/重试耗尽路径测试
**所属模块**:04 注册表 **依赖**:73 **预估**:8-15 分钟
resetStuckRunningJobsDetailed:超时卡死 job 重置;耗尽 job 走 finalizeRetryExhausted;消息默认文案("文件生成任务运行超时")。
### 测试用例(≥8)
1. test_stuck_reset — 超时重置
2. test_stuck_exhausted_finalize — 耗尽 finalize
3. test_stuck_default_message — 默认文案
4. test_stuck_custom_message — 自定义文案
5. test_stuck_heartbeat_timeout — 心跳超时边界
6. test_stuck_scan_interval — 调度间隔配置
7. test_stuck_no_reset_active — 活跃 job 不重置
8. test_stuck_idempotent — 重复扫描安全
## 任务 82:特殊规则回归(WITHDRAW/coze defer)
**所属模块**:04 注册表 **依赖**:78-81 **预估**:8-15 分钟
WITHDRAW markSuccess 后 tryFinalizeTask;coze 模块 dispatch 返回 false → touchRunning(owner)或 deferRunning;状态与时机与原实现完全一致。
### 测试用例(≥8)
1. test_withdraw_finalize_after_success — 成功后 finalize
2. test_withdraw_no_finalize_failed — 失败不 finalize
3. test_coze_false_owner_touch — owner 路径 touchRunning
4. test_coze_false_defer — 非 owner deferRunning
5. test_coze_false_no_mark_failed — 等待不标记失败
6. test_coze_true_mark_success — 完成后 markSuccess
7. test_withdraw_finalize_once — 只一次
8. test_special_rules_integration — 全链路
### 收尾验证(本模块)
`mvn test` 全量 + `mvn clean package -DskipTests` 通过;04 spec §4 兼容清单逐项核对。
@@ -0,0 +1,286 @@
# 05-plan — 巨型 Service 纯函数抽取
> 对应 `docs/specs/05-service-pure-function-extraction.md`。目标:SimilarAsinTaskService(7228 行)、AppearancePatentTaskService(3195)、ShopDataCrawlTaskService(3013)。
> 纪律:只抽纯函数;门面签名不收缩;每模块独立提交;同一提交只做类拆分。
## 任务 83:SimilarAsinExcelParser 行解析器
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
新类 `modules/similarasin/service/support/SimilarAsinExcelParser`:POI 读 Excel 行 → 中间行对象(原始单元格值);输入 InputStream/文件 → 输出 List<中间行>;不改动现有解析语义(同一文件输出与现状逐字节一致)。
### 测试用例(≥8)
1. test_parse_normal_rows — 正常多行解析
2. test_parse_single_row — 单行
3. test_parse_columns_mapping — 列序映射
4. test_parse_empty_sheet — 空表返回空
5. test_parse_empty_rows_skipped — 空行跳过
6. test_parse_null_input_throws — 空输入抛 IllegalArgumentException
7. test_parse_unsupported_format — 非 Excel 文件抛对应异常
8. test_parse_no_mutation — 输入流不被篡改(可重复读)
### TDD 流程
1. 写测试(用夹具 xlsx 放 test resources)→ RED
2. 实现解析器(从 Service 中搬移现有解析逻辑)→ GREEN
3. `mvn test -Dtest=SimilarAsinExcelParserTest` 通过
## 任务 84:行解析边界测试
**所属模块**:05 拆分 **依赖**:83 **预估**:8-15 分钟
### 功能点要求
边界输入:超长字段(>32767)、畸形 ASIN(特殊字符)、BOM、混合编码、行数上限(>65535 xlsx)、数值/文本混合单元格。
### 测试用例(≥8)
1. test_parse_long_field — 超长字段不截断/按现状
2. test_parse_malformed_asin — 畸形 ASIN 原样透传
3. test_parse_bom — BOM 头处理
4. test_parse_mixed_encoding — 混合编码单元格
5. test_parse_numeric_cell — 数值单元格转文本
6. test_parse_date_cell — 日期单元格
7. test_parse_formula_cell — 公式单元格取缓存值
8. test_parse_large_sheet — 大表(5000 行)性能上界
## 任务 85:字段归一化器
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
`SimilarAsinRowNormalizer`:trim/大小写/ASIN 格式统一(保留现状规则,不改变输出);纯函数无状态。
### 测试用例(≥8)
1. test_trim_whitespace — 首尾空白
2. test_lowercase_asin — 小写转大写
3. test_mixed_case_asin — 混合大小写统一
4. test_internal_whitespace_kept — 内部空格保留(现状)
5. test_null_safe — null 安全
6. test_empty_string — 空串
7. test_special_chars_untouched — 特殊字符不动
8. test_normalize_identity_after — 幂等(二次归一不变)
## 任务 86:分组转换器
**所属模块**:05 拆分 **依赖**:83,85 **预估**:8-15 分钟
### 功能点要求
`SimilarAsinGroupingConverter`:归一化行 → 分组 → DTO(TaskItem/FileItem);分组规则与现状一致(同组/子行 2_2、2_3 处理);纯函数。
### 测试用例(≥8)
1. test_group_normal — 正常分组
2. test_group_sub_rows — 子行归组
3. test_group_single_item — 单元素组
4. test_group_empty_input — 空输入空输出
5. test_group_dto_fields — DTO 字段映射
6. test_group_dedup — 组内去重
7. test_group_order — 分组顺序保持
8. test_group_missing_key — 缺分组键兜底
## 任务 87:纯校验器
**所属模块**:05 拆分 **依赖**:85 **预估**:8-15 分钟
### 功能点要求
`SimilarAsinRowValidator`:必填检查、ASIN 格式校验、重复检测;返回错误清单(不抛异常,由调用方决定);规则与现状一致。
### 测试用例(≥8)
1. test_validate_required_present — 必填齐全通过
2. test_validate_required_missing — 缺必填报错
3. test_validate_asin_format — ASIN 格式
4. test_validate_duplicates — 重复标记
5. test_validate_blank_row — 空白行
6. test_validate_no_error_happy — 无误通过
7. test_validate_error_detail — 错误含行列信息
8. test_validate_null_input — 空输入错误清单
## 任务 88:Sheet 构造器
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
`SimilarAsinSheetBuilder`:结果 Workbook/Sheet 构造辅助(表头、列顺序、样式);输入数据 → 输出 workbook;不落库、无 IO 依赖。
### 测试用例(≥8)
1. test_sheet_header_row — 表头正确
2. test_sheet_column_order — 列顺序固定
3. test_sheet_data_rows — 数据行写入
4. test_sheet_empty_data — 空数据仍出表头
5. test_sheet_style_applied — 样式应用
6. test_sheet_zip_output — 可输出 xlsx 文件流
7. test_sheet_large_rows — 大行数(5000)性能
8. test_sheet_no_state_leak — 多次调用独立
## 任务 89:SimilarAsinService.parse 门面改委托
**所属模块**:05 拆分 **依赖**:83-88 **预估**:8-15 分钟
### 功能点要求
parse 方法内部改为:parser.parse → normalizer.normalize → validator → converter → 落库(落库逻辑保留原处);方法签名、参数、返回类型一字不变;删除搬走的代码。
### 测试用例(≥8)
1. test_parse_signature_unchanged — 签名编译兼容
2. test_parse_delegates_parser — 调用解析器
3. test_parse_delegates_normalizer
4. test_parse_delegates_validator
5. test_parse_delegates_converter
6. test_parse_persistence_kept — 落库逻辑仍在
7. test_parse_result_same — 与改造前结果一致
8. test_parse_exception_same — 异常行为一致
## 任务 90:抽取前后快照对比测试
**所属模块**:05 拆分 **依赖**:89 **预估**:8-15 分钟
### 功能点要求
夹具 Excel → 解析结果快照(golden 文件);抽取前后同一夹具输出完全一致;快照变更即失败(防止行为漂移)。
### 测试用例(≥8)
1. test_snapshot_parse_output — 解析输出快照一致
2. test_snapshot_groups — 分组快照
3. test_snapshot_dtos — DTO 快照
4. test_snapshot_error_cases — 错误案例快照
5. test_snapshot_reproducible — 可重复(跑两次一致)
6. test_snapshot_golden_committed — golden 文件存在
7. test_snapshot_diff_detected — 篡改 golden 即失败
8. test_snapshot_regression_all_parse — 全 parse 路径回归
## 任务 91:SimilarAsin 历史查询组装抽取
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
历史列表 VO 拼装(history + toHistoryItem 辅助)抽到独立组件 `SimilarAsinHistoryAssembler`;只读不落库;输出与现状一致。
### 测试用例(≥8)
1. test_assembler_history_items — 历史项组装
2. test_assembler_no_result — 无结果空列表
3. test_assembler_file_state — file 状态附带
4. test_assembler_order — 排序保持
5. test_assembler_null_task — 缺 task 兜底
6. test_assembler_download_url — URL 构造
7. test_assembler_immutable_input — 输入不被改
8. test_assembler_consistency — 与现状输出一致
## 任务 92:SimilarAsin 全量回归
**所属模块**:05 拆分 **依赖**:89-91 **预估**:8-15 分钟
### 功能点要求
similarasin 模块相关测试全绿;`mvn test` 无回归;API 行为与改造前一致。
### 测试用例(≥8)
1-8. 回归清单:新组件测试全绿、既有 similarasin 测试全绿、controller 签名编译、DTO 字段快照、Python 回调相关测试、单测全量、package 通过、git diff 无越界
### TDD 流程 / 验证方法
`mvn test` + `mvn clean package -DskipTests`。
## 任务 93:AppearancePatent 行解析/归一化抽取
**所属模块**:05 拆分 **依赖**:83,85 **预估**:8-15 分钟
同 83/85 模式,针对 AppearancePatentTaskService 的解析与归一化逻辑(注意其 Excel 结构与 similarasin 不同)。
### 测试用例(≥8)
1-8:正常解析、单行、空表、空行、归一化规则、边界(超长/畸形)、输入安全、快照一致。
## 任务 94:AppearancePatent Sheet 构造抽取
**所属模块**:05 拆分 **依赖**:88 **预估**:8-15 分钟
同 88 模式(列顺序以 appearancepatent 现状为准)。
### 测试用例(≥8)
1-8:表头、列序、数据行、空数据、样式、输出流、大行数、无状态泄漏。
## 任务 95:AppearancePatent 门面改委托
**所属模块**:05 拆分 **依赖**:93,94 **预估**:8-15 分钟
同 89 模式;注意 appearancepatent 的 submitResult 双事务路径不动。
### 测试用例(≥8)
1-8:签名不变、委托各组件、落库保留、结果一致、异常一致、双事务路径不变、owner 检查不变、全回归。
## 任务 96:AppearancePatent 快照对比测试
**所属模块**:05 拆分 **依赖**:95 **预估**:8-15 分钟
同 90 模式(夹具为 appearancepatent 实际 Excel 结构)。
### 测试用例(≥8)
同 90。
## 任务 97:AppearancePatent 历史查询组装抽取
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
同 91 模式。
### 测试用例(≥8)
同 91。
## 任务 98:AppearancePatent 全量回归
**所属模块**:05 拆分 **依赖**:95-97 **预估**:8-15 分钟
同 92 模式。
### 测试用例(≥8)
同 92(appearancepatent 相关)。
## 任务 99:ShopDataCrawl 行解析抽取
**所属模块**:05 拆分 **依赖**:83,85 **预估**:8-15 分钟
同 93 模式(shopdatacrawl 结构)。
### 测试用例(≥8)
同 93。
## 任务 100:ShopDataCrawl Sheet 构造抽取
**所属模块**:05 拆分 **依赖**:88 **预估**:8-15 分钟
同 94 模式。
### 测试用例(≥8)
同 94。
## 任务 101:ShopDataCrawl 门面改委托
**所属模块**:05 拆分 **依赖**:99,100 **预估**:8-15 分钟
同 95 模式。
### 测试用例(≥8)
同 95。
## 任务 102:ShopDataCrawl 快照对比测试
**所属模块**:05 拆分 **依赖**:101 **预估**:8-15 分钟
同 96 模式。
### 测试用例(≥8)
同 96。
## 任务 103:ShopDataCrawl 历史查询组装抽取
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
同 97 模式。
### 测试用例(≥8)
同 97。
## 任务 104:ShopDataCrawl 全量回归
**所属模块**:05 拆分 **依赖**:101-103 **预估**:8-15 分钟
同 98 模式。
### 测试用例(≥8)
同 98。
### 收尾验证(本模块)
`mvn test` 全量 + `mvn clean package -DskipTests`;05 spec §4 不变要求逐项核对;三模块各一个独立提交。
@@ -0,0 +1,325 @@
# 06-plan — 只读查询与批量加载优化
> 对应 `docs/specs/06-read-query-batch-loading.md`。行为不变型优化 + 新增 progress/light 轻量接口。
> 技术栈:Java 21 + MyBatis-Plus + Flyway。
## 任务 105:similarasin 历史列表 IN 查询批量加载
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
history 方法:任务+结果+Job 关联数据由逐条查询改为 IN 批量查询 + 按 ID Map 装配;分页结果、排序、过滤不变;输出与现状一致。
### 测试用例(≥8)
1. test_history_batch_loads — 批量加载装配
2. test_history_single_row — 单条
3. test_history_multiple_tasks — 多任务
4. test_history_no_jobs — 无 Job 兼容
5. test_history_order_unchanged — 排序不变
6. test_history_pagination — 分页不变
7. test_history_missing_related — 关联缺失兜底
8. test_history_sql_count — IN 查询次数(≤N,断言 mapper 调用次数)
### TDD 流程
1. 写测试(mock mapper 断言查询次数与装配)→ RED
2. 改造 history 实现 → GREEN
3. `mvn test -Dtest=SimilarAsinTaskServiceTest` 通过
## 任务 106:appearancepatent 历史列表批量加载
**所属模块**:06 批量加载 **依赖**:105 **预估**:8-15 分钟
同 105 模式。
### 测试用例(≥8)
同 105(appearancepatent)。
## 任务 107:结果列表关联 Job 批量加载
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
结果列表/详情页关联 TaskFileJob 状态:findAssembleJobsByResultIds 覆盖审计;逐条查 result→job 的路径改 IN;输出不变。
### 测试用例(≥8)
1. test_result_job_batch — 批量取 Job
2. test_result_job_single — 单条
3. test_result_job_empty — 空结果
4. test_result_job_map_keyed — 按 resultId Map
5. test_result_job_missing — 缺 Job 兜底
6. test_result_job_query_count — 查询次数断言
7. test_result_job_null_guard — null 安全
8. test_result_job_consistency — 与现状一致
## 任务 108:dashboard 聚合查询
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
dashboard 统计改批量聚合(COUNT/GROUP BY 一次出);状态分类计数与逐条统计结果一致;输出结构不变。
### 测试用例(≥8)
1. test_dashboard_counts — 各状态计数
2. test_dashboard_empty — 空用户 0 计数
3. test_dashboard_aggregate_sql — 聚合 SQL 调用
4. test_dashboard_recent_tasks — 最近任务列表
5. test_dashboard_consistency — 与逐条一致
6. test_dashboard_mixed_status — 混合状态
7. test_dashboard_user_filter — 用户过滤
8. test_dashboard_big_data — 大数据量聚合
## 任务 109:progress/light 轻量接口(similarasin 首个)
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
新端点 `POST /api/similar-asin/tasks/progress/light`:body {taskIds};resp items[{taskId,status,statusCode?,fileStatus,fileReady,updatedAt}];旧 progress/batch 保留不动;走轻量查询(不查明细/result 行)。
### 测试用例(≥8)
1. test_light_returns_light_fields — 只返回轻量字段
2. test_light_missing_task — missingTaskIds
3. test_light_empty_ids — 空 ids 空结果
4. test_light_dedup_ids — 去重
5. test_light_old_endpoint_untouched — 旧端点仍工作
6. test_light_status_mapping — 状态映射正确
7. test_light_file_fields — file 字段附带
8. test_light_unknown_id — 未知 id 缺失列表
### TDD 流程
1. 测试(MockMvc 打新端点)→ RED(404)
2. 实现 controller + service → GREEN
3. `mvn test -Dtest=SimilarAsinControllerTest` 通过
## 任务 110:progress/light 字段白名单
**所属模块**:06 批量加载 **依赖**:109 **预估**:8-15 分钟
### 功能点要求
响应仅含白名单字段(taskId/status/statusCode/fileStatus/fileReady/updatedAt);不含 items 明细/payload/result 内容;序列化断言。
### 测试用例(≥8)
1. test_whitelist_no_items — 无明细数组
2. test_whitelist_no_payload — 无 payload 字段
3. test_whitelist_exact_keys — 键集合精确匹配
4. test_whitelist_file_phase — file 字段在白名单
5. test_whitelist_extra_rejected — 多余键测试失败
6. test_whitelist_null_values_ok — null 值允许
7. test_whitelist_response_size_small — 响应体小(<1KB)
8. test_whitelist_documented — 白名单文档一致
## 任务 111:progress/light 空/超长 taskIds
**所属模块**:06 批量加载 **依赖**:109 **预估**:8-15 分钟
### 功能点要求
空数组→空 items;null→空;>200 个截断或返回错误(定义行为);非正数过滤。
### 测试用例(≥8)
1. test_light_empty_array — 空数组
2. test_light_null_body — null body 处理
3. test_light_negative_filter — 负数过滤
4. test_light_zero_filter — 0 过滤
5. test_light_over_200 — 超长截断/错误
6. test_light_duplicates — 重复去重
7. test_light_single — 单 id
8. test_light_max_exact — 恰好上限
## 任务 112:progress/light 终态任务返回
**所属模块**:06 批量加载 **依赖**:109 **预估**:8-15 分钟
### 功能点要求
SUCCESS/FAILED 任务在 light 接口返回终态状态 + file 阶段;前端可凭此停止轮询并展示。
### 测试用例(≥8)
1. test_light_success_task — SUCCESS 返回
2. test_light_failed_task — FAILED 返回
3. test_light_pending — PENDING
4. test_light_running — RUNNING
5. test_light_success_file_status — 附带 fileStatus
6. test_light_failed_file_error — 失败附带 fileError
7. test_light_terminal_complete — 终态字段完整
8. test_light_status_frozen — 状态值语义不变
## 任务 113:其余模块 progress/light 接入
**所属模块**:06 批量加载 **依赖**:109-112 **预估**:8-15 分钟
### 功能点要求
同构端点接入:appearancepatent/publish/queryasin/shopdatacrawl/withdraw/patroldelete/shopmatch/productrisk/pricetrack/deletebrand/collectdata(11 个);路径模式统一;字段白名单一致。
### 测试用例(≥8)
1. test_light_all_modules_exist — 12 个 light 端点存在
2. test_light_common_shape — 响应结构一致
3. test_light_module_specific_status — 各模块状态映射
4. test_light_publish_files — publish 文件级字段
5. test_light_old_endpoints_all_kept — 旧端点全保留
6. test_light_whitelist_all — 白名单一致
7. test_light_missing_all — 缺失任务处理
8. test_light_contract_frozen — 契约快照
## 任务 114:批量加载等价快照测试
**所属模块**:06 批量加载 **依赖**:105-108 **预估**:8-15 分钟
### 功能点要求
改造前后同数据:历史页、结果页、dashboard 输出字段完全一致(快照对比)。
### 测试用例(≥8)
1. test_history_snapshot_equiv — 历史快照一致
2. test_dashboard_snapshot_equiv — dashboard 一致
3. test_result_snapshot_equiv — 结果一致
4. test_pagination_equiv — 分页一致
5. test_snapshot_reproducible — 可重复
6. test_snapshot_diff_fails — 篡改即失败
7. test_snapshot_covers_all — 覆盖三页
8. test_snapshot_regression_guard — 全量回归门禁
## 任务 115:高频查询 EXPLAIN 索引审计
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
对高频查询(history/progress/dashboard)逐条 EXPLAIN;产出索引迁移清单(表/列/类型/收益/风险);不做 DDL。
### 测试用例(≥8)
1. test_explain_history_plan — history 执行计划记录
2. test_explain_progress_plan — progress 计划
3. test_explain_dashboard_plan — dashboard 计划
4. test_full_scan_detected — 全表扫描标记
5. test_index_candidates_listed — 候选索引清单
6. test_plan_documented — 审计文档产出
7. test_plan_repeatable — 可重复执行
8. test_no_ddl_this_task — 本任务无 DDL
## 任务 116:索引迁移 V{N+1}
**所属模块**:06 批量加载 **依赖**:115 **预估**:8-15 分钟
### 功能点要求
按审计清单追加 `db/V{N+1}__*.sql`(只追加不改历史);包含验证 SQL;标注锁表风险与窗口。
### 测试用例(≥8)
1. test_migration_file_exists — 迁移文件存在
2. test_migration_version_sequential — 版本号续接
3. test_migration_validated — 验证 SQL 通过(副本库)
4. test_migration_index_created — 索引生效
5. test_explain_improved — 执行计划改善
6. test_migration_no_alter_legacy — 不改历史迁移
7. test_migration_rollback_doc — 回滚步骤记录
8. test_migration_backward_safe — 旧数据兼容
## 任务 117:progress/light user_id 权限过滤
**所属模块**:06 批量加载 **依赖**:109 **预估**:8-15 分钟
### 功能点要求
user_id 传入时仅返回该用户任务;未传时按 taskId 反查;越权任务进 missingTaskIds(不泄露)。
### 测试用例(≥8)
1. test_light_user_filter — 用户过滤
2. test_light_no_user_reverse — 无 user 反查
3. test_light_other_user_hidden — 他人任务隐藏
4. test_light_missing_on_unauthorized — 越权进 missing
5. test_light_user_null — 全空 userId
6. test_light_admin_scope — 管理范围(按现状)
7. test_light_user_consistent — 与旧端点一致
8. test_light_no_leak — 响应不含他人数据
## 任务 118:前端 getModuleProgressLight 适配
**所属模块**:06 批量加载 **依赖**:109,44 **预估**:8-15 分钟
### 功能点要求
java-modules.ts 新增 `getModuleProgressLight(module, taskIds)` 调 light 端点;返回结构归一为现有 progress 类型;页面可渐进切换。
### 测试用例(≥8)
1. test_light_url_module — 模块路径正确
2. test_light_payload — taskIds body
3. test_light_response_shape — 归一结构
4. test_light_fallback_flag — 可开关
5. test_light_missing_ids — missingTaskIds 映射
6. test_light_timeout — 10s 超时
7. test_light_type_compat — 与旧类型兼容
8. test_light_snapshot — 快照
## 任务 119:前端 dashboard/history/progress 分离调用测试
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
前端页面:dashboard 只调统计、history 只调摘要、progress 只调轻量;首次打开不加载全部明细;断言请求路径分离。
### 测试用例(≥8)
1. test_page_dashboard_only_stats — 只调统计
2. test_page_history_only_summary — 只调摘要
3. test_page_progress_only_light — 只调进度
4. test_page_no_full_detail_on_load — 首开不拉明细
5. test_page_items_on_open — 打开明细才请求
6. test_page_result_on_demand — 结果按需
7. test_page_request_count_bounded — 请求数有界
8. test_page_snapshot — 请求快照
## 任务 120:大页数据性能回归
**所属模块**:06 批量加载 **依赖**:105-108 **预估**:8-15 分钟
### 功能点要求
500 任务级数据:history/dashboard/progress 响应时间上界(基准线);不劣于改造前。
### 测试用例(≥8)
1. test_perf_history_500 — 历史耗时
2. test_perf_dashboard_500 — dashboard 耗时
3. test_perf_progress_200 — 200 任务进度
4. test_perf_light_200 — light 更快
5. test_perf_query_count — 查询次数上界
6. test_perf_no_regression — 与基线对比
7. test_perf_memory_bounded — 内存有界
8. test_perf_report — 结果记录
## 任务 121:N+1 扫描审计
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
对 modules 下 Service 扫描逐条 selectById/selectOne 循环模式;产出 N+1 清单(位置/对象/影响);不做修改。
### 测试用例(≥8)
1. test_scan_select_in_loop — 识别循环内单查
2. test_scan_output_listed — 清单产出
3. test_scan_priority — 按影响排序
4. test_scan_module_coverage — 覆盖主要模块
5. test_scan_false_positive_checked — 排除误报(已批量)
6. test_scan_repeatable — 可重复
7. test_scan_documented — 文档产出
8. test_scan_no_edit — 本任务不改代码
## 任务 122:N+1 批量化修复
**所属模块**:06 批量加载 **依赖**:121 **预估**:8-15 分钟
### 功能点要求
按清单修复高影响 N+1(IN 查询 + Map 装配);行为不变;快照对比验证。
### 测试用例(≥8)
1. test_fix_in_query — 改 IN 查询
2. test_fix_map_assembly — Map 装配
3. test_fix_behavior_same — 行为一致
4. test_fix_single_row — 单行兼容
5. test_fix_empty — 空兼容
6. test_fix_query_count_reduced — 查询次数下降
7. test_fix_snapshot — 输出快照
8. test_fix_no_side_effect — 无副作用
## 任务 123:06 全量回归
**所属模块**:06 批量加载 **依赖**:105-122 **预估**:8-15 分钟
### 功能点要求
06 全部任务产出物 + 既有测试全绿;light 契约快照冻结;无行为回退。
### 测试用例(≥8)
1-8:全部新测试绿、既有回归绿、light 契约快照、旧端点可用、索引迁移就绪、前端适配编译、性能基线、git diff 范围
### 验证方法
`mvn test` 全量 + `cd frontend-vue && npm run build` + `npx vitest run`。
@@ -0,0 +1,250 @@
# 07-plan — 保守缩短事务边界
> 对应 `docs/specs/07-transaction-boundary.md`。硬约束:Python /result 成功确认时机、done=true 封口、状态成功时机、回滚语义全部不变。
> 技术栈:Java 21 + Spring Transaction。
## 任务 124:@Transactional 方法审计清单
**所属模块**:07 事务 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
扫描 modules 下全部 @Transactional 方法,产出审计清单:方法/事务内代码段分类(必须事务内:落库/状态/锁;可移出:纯计算/DTO 组装/日志/清理);文档产出,不改代码。
### 测试用例(≥8)
1. test_audit_covers_all_modules — 覆盖全部业务模块
2. test_audit_classification — 分类完整(必须/可移出)
3. test_audit_result_endpoints — /result 方法都在清单
4. test_audit_python_facing — Python 回调相关标记
5. test_audit_priority_order — 按收益排序
6. test_audit_no_code_change — 本任务零代码变更
7. test_audit_documented — 文档产出
8. test_audit_repeatable — 可重复执行
### TDD 流程
1. 写审计脚本/测试(断言清单文件存在且字段齐全)→ RED
2. 产出清单 → GREEN
3. 文档校验
## 任务 125:similarasin 纯计算移出事务
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
### 功能点要求
similarasin 的 /result 提交事务内纯计算段(分组/百分比/校验)抽为无事务方法,在写库前调用;输出与现状一致。
### 测试用例(≥8)
1. test_pure_compute_outside_tx — 计算在事务外
2. test_compute_result_same — 结果一致
3. test_tx_persistence_kept — 落库仍在事务内
4. test_failure_rollback — 落库失败回滚(计算无副作用)
5. test_compute_idempotent — 计算幂等
6. test_compute_repeat_safe — 重复调用安全
7. test_no_tx_annotation_moved — 移动的方法无事务注解
8. test_behavior_snapshot — 快照一致
### TDD 流程
1. 测试断言事务边界(TransactionSynchronization 观察)→ RED
2. 重构 → GREEN
3. `mvn test -Dtest=SimilarAsinTaskServiceTest` 通过
## 任务 126:similarasin DTO 组装移出写事务
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
### 功能点要求
结果回传的 DTO/VO 组装移到事务提交后(afterCompletion 或事务外);不影响落库字段。
### 测试用例(≥8)
1. test_dto_assembly_after_tx — 组装在事务后
2. test_assembled_fields_same — 字段一致
3. test_tx_commit_then_assembly — 先提交后组装
4. test_rollback_no_assembly — 回滚不组装
5. test_assembly_error_safe — 组装错误不影响事务
6. test_response_built_ok — 响应正常构造
7. test_assembly_no_db_read — 组装不读库
8. test_snapshot_same — 快照一致
## 任务 127:similarasin 临时文件清理挂 afterCommit
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
### 功能点要求
事务完成后的临时文件清理改挂 TransactionSynchronization.afterCommit;回滚不清理(文件保留);清理异常不阻断。
### 测试用例(≥8)
1. test_cleanup_after_commit — 提交后清理
2. test_cleanup_no_rollback — 回滚不清理
3. test_cleanup_error_swallowed — 异常吞掉
4. test_cleanup_order — 在提交后
5. test_cleanup_retryable — 失败可重试
6. test_cleanup_tx_done — 事务状态已结束
7. test_cleanup_idempotent — 幂等
8. test_cleanup_integration — 全链路
## 任务 128:appearancepatent 事务收缩
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
同 125-127 模式(注意双事务路径:persistSubmittedChunk + completeSubmittedChunk 两段不变)。
### 测试用例(≥8)
1-8:计算移外、双事务路径不变、落库保留、回滚一致、清理时机、幂等、快照一致、集成。
## 任务 129:shopdatacrawl 事务收缩
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
同 125 模式。
### 测试用例(≥8)
同 125(shopdatacrawl 特有:items 分页写入路径)。
## 任务 130:publish 事务收缩
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
同 125 模式(publish 特有:RustFS 分片合并路径不动)。
### 测试用例(≥8)
同 125(publish:分片合并后落库仍在事务内)。
## 任务 131:collectdata 事务收缩
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
同 125 模式。
### 测试用例(≥8)
同 125。
## 任务 132:/result 成功确认时机不变测试
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
### 功能点要求
/result 返回 HTTP 200 + success=true 在结果分片可靠落库**之后**;未落库前不返回成功;事务失败返回错误。
### 测试用例(≥8)
1. test_result_200_after_persist — 落库后 200
2. test_result_success_true — success=true
3. test_result_persist_fail_no_200 — 落库失败不 200
4. test_result_timing_order — 顺序断言
5. test_result_retry_after_failure — 失败后重试
6. test_result_chunk_then_ack — 分片先落库
7. test_result_ack_then_response — 响应在 ACK 后
8. test_result_contract_frozen — 契约快照
## 任务 133:回滚语义不变测试
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
### 功能点要求
落库异常 → 完整回滚(任务状态、结果、payload 不变);纯计算无副作用;重试安全。
### 测试用例(≥8)
1. test_rollback_full — 完整回滚
2. test_rollback_status_unchanged — 状态不变
3. test_rollback_payload — payload 不变
4. test_rollback_retry — 重试安全
5. test_rollback_compute_noop — 计算无副作用
6. test_rollback_error_raised — 异常抛出
7. test_rollback_partial_write — 部分写入也回滚
8. test_rollback_consistency — 与改造前一致
## 任务 134:done=true 封口时机不变测试
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
### 功能点要求
done=true 最后一批:强制处理未满批数据、生成结果文件的时机不变;封口语义不变。
### 测试用例(≥8)
1. test_done_finalizes — 封口触发
2. test_done_after_last_chunk — 最后一批后
3. test_done_processes_remainder — 处理剩余
4. test_done_generates_file — 生成结果
5. test_done_idempotent — 重复 done 安全
6. test_done_timing — 时机断言
7. test_done_no_double — 不重复生成
8. test_done_contract — 契约快照
## 任务 135:任务状态成功时机不变测试
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
### 功能点要求
任务状态变 SUCCESS 的时机(结果文件生成完成判断)不变;fileReady/downloadUrl 含义不变。
### 测试用例(≥8)
1. test_success_timing — 成功时机
2. test_success_after_file — 文件生成后
3. test_file_ready_semantics — fileReady 语义
4. test_download_url_semantics — downloadUrl 语义
5. test_success_no_file — 无文件不成功
6. test_success_state_transition — 状态迁移
7. test_success_observable — 前端可观测
8. test_success_contract — 契约快照
## 任务 136:事务外清理异常不阻断
**所属模块**:07 事务 **依赖**:127 **预估**:8-15 分钟
### 功能点要求
afterCommit 清理抛异常:记录日志+指标,不影响响应;不重试成循环。
### 测试用例(≥8)
1. test_cleanup_error_logged — 日志记录
2. test_cleanup_error_response_ok — 响应不受影响
3. test_cleanup_error_no_retry_loop — 不循环
4. test_cleanup_error_tx_committed — 事务已提交
5. test_cleanup_error_metric — 指标记录
6. test_cleanup_error_next_time — 下次仍可清理
7. test_cleanup_error_partial — 部分清理成功
8. test_cleanup_error_integration — 集成
## 任务 137:重复提交幂等测试
**所属模块**:07 事务 **依赖**:132-135 **预估**:8-15 分钟
### 功能点要求
同 submissionId 重复提交 /result:幂等接受(成功返回,不重复落库);不同内容冲突拒绝。
### 测试用例(≥8)
1. test_duplicate_same_id_ok — 同 id 幂等
2. test_duplicate_no_double_persist — 不重复落库
3. test_duplicate_success_true — 返回成功
4. test_duplicate_diff_content_reject — 内容不同拒绝
5. test_duplicate_chunk_conflict — chunk 冲突
6. test_duplicate_after_done — 封口后重复
7. test_duplicate_many — 多次重复
8. test_duplicate_contract — 契约快照
## 任务 138:事务时长性能对比基准
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
### 功能点要求
改造前后 /result 事务耗时基准对比(纯计算移出后的时间下降);记录基准数据。
### 测试用例(≥8)
1. test_tx_duration_recorded — 耗时记录
2. test_tx_duration_before_after — 前后对比
3. test_tx_improved_or_equal — 不劣化
4. test_tx_measure_repeatable — 可重复
5. test_tx_load_200_chunks — 200 分片负载
6. test_tx_no_regression — 无回退
7. test_tx_benchmark_documented — 基准文档
8. test_tx_bound_reasonable — 上界合理
## 任务 139:07 全量回归
**所属模块**:07 事务 **依赖**:132-138 **预估**:8-15 分钟
### 功能点要求
07 全部契约测试(132-135)+ 各模块事务重构测试全绿;`mvn test` 无回归。
### 测试用例(≥8)
1-8:契约 4 项全绿、幂等全绿、回滚全绿、各模块重构测试、全量单测、package、契约快照、git diff 范围
### 验证方法
`mvn test` + `mvn clean package -DskipTests`。
@@ -0,0 +1,158 @@
# 08-plan — 结果文件阶段字段契约固化
> 对应 `docs/specs/08-result-file-phase-and-download.md`。**审计结论:Java 13 模块字段已实现、前端已消费,无代码改动需求。**
> 本 plan 将现状固化为契约测试,防止未来回归;不新增业务字段。
> 技术栈:Java 21 + JUnit5 + Vitest(前端)。
## 任务 140:13 模块 file 字段契约快照测试
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
对 13 个业务模块(similarasin/appearancepatent/shopdatacrawl/queryasin/withdraw/patroldelete/shopmatch/productrisk/pricetrack/deletebrand/publish/collectdata/brand)的响应 VO 断言 file 阶段字段存在且类型正确(collectdata 除外:断言其自洽语义);旧字段(taskId/resultId/downloadUrl/status)仍在。
### 测试用例(≥8)
1. test_similar_has_file_fields — similarasin 字段齐全
2. test_appearance_has_file_fields
3. test_shopdatacrawl_has_file_fields
4. test_publish_has_file_fields — publish 文件级
5. test_collectdata_self_consistent — collectdata 无 file 字段(现状)
6. test_old_fields_present — 旧字段全在
7. test_file_field_types — 类型正确(boolean/string/integer)
8. test_contract_frozen_snapshot — JSON 快照冻结
### TDD 流程
1. 测试断言 VO 字段(反射/样例对象)→ 对现状应 GREEN(基线固化)
2. 若未来删除字段即 RED(回归保护)
3. `mvn test -Dtest=ResultFilePhaseContractTest` 通过
## 任务 141:similarasin file 进度合成逻辑单测
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
attachFileProgress 三路径:Coze 阶段(cozeCompleted/pending>0)、Python 上传阶段(未完成)、snapshot 百分比(上传完成无 coze);fileReady=true 时 100%。
### 测试用例(≥8)
1. test_coze_progress_path — Coze 路径
2. test_python_upload_path — Python 上传路径
3. test_snapshot_percent_path — snapshot 路径
4. test_file_ready_100 — ready=100%
5. test_upload_not_complete_no_snapshot — 未完成且无快照
6. test_can_treat_completed — 可视为完成
7. test_task_not_running_skip — 非运行中跳过
8. test_percent_cap_99 — 未 ready 时 ≤99
### TDD 流程 / 验证方法
构造 FileResultEntity/TaskFileJobEntity/TaskProgressSnapshotEntity 组合断言输出(调用包可见/测试可见的 attachFileProgress 或经 toHistoryItem)。
## 任务 142:fileReady/fileStatus 语义测试
**所属模块**:08 结果阶段 **依赖**:140 **预估**:8-15 分钟
### 功能点要求
fileReady = resultFileUrl 非空;无 job 时 fileStatus = ready?SUCCESS:null;有 job 时 fileStatus = job.status;fileError = job.errorMessage。
### 测试用例(≥8)
1. test_ready_url_present — 有 URL ready=true
2. test_ready_url_blank — 空 URL ready=false
3. test_no_job_success_status — 无 job ready 时 SUCCESS
4. test_no_job_null_status — 无 job 未 ready null
5. test_job_status_mapped — job 状态映射
6. test_job_error_mapped — job 错误映射
7. test_ready_blank_whitespace — 空白字符串
8. test_semantics_frozen — 语义快照
## 任务 143:publish 文件级 file 状态测试
**所属模块**:08 结果阶段 **依赖**:140 **预估**:8-15 分钟
### 功能点要求
publish 的 file 状态是文件级(PublishResultVo.setFileReady(ready)/setFileStatus(file.status)),与其余模块 job 级不同;语义固化。
### 测试用例(≥8)
1. test_publish_file_ready — ready 设置
2. test_publish_file_status — 文件状态
3. test_publish_per_file — 按文件独立
4. test_publish_mixed_files — 多文件混合状态
5. test_publish_ready_all — 全 ready
6. test_publish_no_files — 无文件
7. test_publish_failed_file — 失败文件
8. test_publish_semantics_frozen — 语义快照
## 任务 144:前端 live progress 合并测试补强
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
mergeHistoryItemPreservingLiveProgress:history 缺失 file 进度时保留 live progress;incoming 有进度时用 incoming;可下载时不保留。
### 测试用例(≥8)
1. test_merge_keeps_live_when_history_missing — 保留 live
2. test_merge_incoming_wins — incoming 优先
3. test_merge_no_keep_when_downloadable — 可下载不保留
4. test_merge_no_previous — 无 previous 返回 incoming
5. test_merge_partial_fields — 部分字段保留
6. test_merge_meaningful_progress — 有效进度值判断
7. test_merge_file_ready_flag — ready 标志保留
8. test_merge_idempotent — 幂等
### TDD 流程 / 验证方法
`npx vitest run`(扩展既有测试文件或新增)。
## 任务 145:前端可下载判定测试
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
canDownload/fileReady/fileStatus 终态判定:fileReady=true 可下载;fileStatus=SUCCESS/FAILED 可下载(FAILED 可下载错误文件或展示错误);其余不可下载。
### 测试用例(≥8)
1. test_can_download_ready — ready 可下载
2. test_can_download_status_success — SUCCESS 可下载
3. test_can_download_status_failed — FAILED 展示错误
4. test_can_not_download_pending — PENDING 不可
5. test_can_not_download_null — null 不可
6. test_file_status_lowercase — 小写归一
7. test_ready_false_status_success — 组合判断
8. test_download_flow_no_result_resubmit — 下载失败不重提交
## 任务 146:collectdata 自洽行为测试
**所属模块**:08 结果阶段 **依赖**:140 **预估**:8-15 分钟
### 功能点要求
collectdata 前端用 success + downloadUrl 判定下载;后端不返回 file 字段;行为自洽(任务 SUCCESS 且有 URL 才可下载)。
### 测试用例(≥8)
1. test_collect_success_downloadable — SUCCESS+URL 可下载
2. test_collect_success_no_url — 无 URL 不可
3. test_collect_failed_no_download — 失败不可
4. test_collect_ready_download_url — URL 有效
5. test_collect_progress_display — 进度显示
6. test_collect_self_consistent_backend — 后端无 file 字段
7. test_collect_status_flow — 状态流
8. test_collect_contract_frozen — 快照
## 任务 147:downloadUrl 永不过期验证
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
generateFreshDownloadUrl 行为:result/ 前缀走 download-endpoint;非 result/ 走公开端点;无签名(URL 无过期参数);bucket 前缀正确。
### 测试用例(≥8)
1. test_result_prefix_download_endpoint — result/ 走下载域名
2. test_other_prefix_public — 其他走公开
3. test_no_signed_params — 无签名参数
4. test_bucket_in_url — bucket 包含
5. test_blank_input_fallback — 空值回退
6. test_uri_encoding — 路径编码
7. test_scheme_https — https
8. test_url_stable_over_time — 时间无关(无过期)
### TDD 流程 / 验证方法
OssStorageService 单测(配置注入 mock endpoint)。
### 收尾验证(本模块)
`mvn test` 相关类 + `cd frontend-vue && npx vitest run` 全绿;08 spec §2/§3 清单与实际一致。
@@ -0,0 +1,322 @@
# 09-plan — 临时文件生命周期治理
> 对应 `docs/specs/09-temp-file-lifecycle.md`。第一阶段只巡检不自动删;路径安全是硬门槛。
> 技术栈:Java 21 + Spring Scheduling + JUnit5。
## 任务 148:临时目录配置盘点
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
盘点 TransientStorageProperties/StorageProperties/TransientPayloadStorageService 的临时目录配置(路径、前缀、保留期、现有清理逻辑);产出配置清单文档;不改代码。
### 测试用例(≥8)
1. test_config_listed — 配置项清单齐全
2. test_temp_root_defined — 临时根目录定义
3. test_retention_period — 保留期定义
4. test_payload_prefixes — payload 前缀
5. test_upload_dir — 上传目录
6. test_existing_cleanup_noted — 现有清理逻辑记录
7. test_doc_committed — 文档存在
8. test_no_code_change — 零代码变更
### TDD 流程
1. 断言清单文档存在且字段齐全 → RED
2. 产出文档 → GREEN
## 任务 149:创建/访问时间记录审计与补缺
**所属模块**:09 临时文件 **依赖**:148 **预估**:8-15 分钟
### 功能点要求
临时文件创建时间/大小/最后访问时间记录:现有实现缺最后访问时间则补(文件 mtime 或记录表);不改变文件语义。
### 测试用例(≥8)
1. test_creation_time_recorded — 创建时间
2. test_size_recorded — 大小
3. test_access_time_readable — 访问时间可读
4. test_access_time_fallback — mtime 回退
5. test_record_update — 访问更新
6. test_record_missing_grace — 缺记录容忍
7. test_record_no_io_error — IO 错误不阻断
8. test_record_consistency — 一致
## 任务 150:引用检查(清理前)
**所属模块**:09 临时文件 **依赖**:148 **预估**:8-15 分钟
### 功能点要求
清理前确认无任务引用:fileKey 被 task_file_job/file_result 引用则不清理;引用判定逻辑可测试。
### 测试用例(≥8)
1. test_referenced_kept — 被引用不清理
2. test_unreferenced_candidate — 无引用可清理
3. test_reference_by_job — job 引用
4. test_reference_by_result — result 引用
5. test_reference_unknown — 未知引用安全
6. test_check_no_side_effect — 检查无副作用
7. test_check_failure_keeps — 检查失败保守保留
8. test_check_batch — 批量检查
## 任务 151:路径安全校验
**所属模块**:09 临时文件 **依赖**:148 **预估**:8-15 分钟
### 功能点要求
删除前校验:路径规范化后 startsWith(临时根目录);穿越(../、绝对路径逃逸、符号链接)拒绝;非法路径不删除并记录。
### 测试用例(≥8)
1. test_inside_root_ok — 根内允许
2. test_traversal_rejected — ../ 拒绝
3. test_absolute_escape — 绝对路径逃逸拒绝
4. test_symlink_escape — 符号链接逃逸拒绝
5. test_normalize_before_check — 规范化后校验
6. test_relative_subdir — 子目录允许
7. test_sibling_rejected — 兄弟目录拒绝
8. test_illegal_logged — 非法路径记录
### TDD 流程
1. 测试(构造各种路径)→ RED
2. 实现校验 → GREEN
3. `mvn test -Dtest=TransientPathGuardTest` 通过
## 任务 152:清理失败吞异常记指标
**所属模块**:09 临时文件 **依赖**:150,151 **预估**:8-15 分钟
### 功能点要求
清理失败:记录日志+指标(清理失败计数),不抛异常、不阻断主流程;不自动重试成循环。
### 测试用例(≥8)
1. test_failure_logged — 日志
2. test_failure_metric — 指标
3. test_failure_no_throw — 不抛出
4. test_failure_flow_continues — 主流程继续
5. test_failure_no_retry_loop — 不循环
6. test_failure_next_round — 下轮可再试
7. test_failure_partial — 部分失败处理
8. test_failure_isolation — 隔离其他文件
## 任务 153:fileKey 兜底查找
**所属模块**:09 临时文件 **依赖**:148 **预估**:8-15 分钟
### 功能点要求
进程重启后 fileKey 兜底:上传记录持久化或重启后按 fileKey 重建索引;找不到时明确失败而非静默。
### 测试用例(≥8)
1. test_file_key_found — 找到
2. test_file_key_after_restart — 重启后找到
3. test_file_key_missing — 缺失明确失败
4. test_file_key_null — null 安全
5. test_file_key_cleanup — 清理后不可找
6. test_file_key_record_persist — 记录持久化
7. test_file_key_rebuild — 索引重建
8. test_file_key_semantics_frozen — 语义不变
## 任务 154:磁盘容量告警
**所属模块**:09 临时文件 **依赖**:152 **预估**:8-15 分钟
### 功能点要求
临时目录容量超阈值:记录告警日志(当前容量/阈值);无监控栈时仅日志输出;不阻塞业务。
### 测试用例(≥8)
1. test_warning_threshold — 阈值判断
2. test_warning_logged — 告警日志
3. test_under_threshold_silent — 未超不告警
4. test_warning_repeat_limited — 告警频率限制
5. test_usage_measured — 容量测量
6. test_usage_zero — 空目录
7. test_measure_error_grace — 测量失败容忍
8. test_warning_no_block — 不阻塞
## 任务 155:孤立文件巡检报表
**所属模块**:09 临时文件 **依赖**:150 **预估**:8-15 分钟
### 功能点要求
只读巡检:临时目录中无任何引用/超过保留期的文件清单输出到报表(日志或报表文件);不删除。
### 测试用例(≥8)
1. test_orphan_detected — 孤立文件检出
2. test_referenced_not_reported — 被引用不报
3. test_report_output — 报表输出
4. test_read_only_no_delete — 只读不删
5. test_report_batch — 批量
6. test_report_empty — 无孤立空报表
7. test_report_rerun_safe — 可重复
8. test_report_details — 详情(路径/大小/时间)
## 任务 156:孤立 Job 巡检报表
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
只读巡检:task_file_job 无对应 task/result 的孤儿 Job 清单;输出报表;不修改状态。
### 测试用例(≥8)
1. test_orphan_job_detected — 检出
2. test_valid_job_not_reported — 正常不报
3. test_report_output — 输出
4. test_read_only — 不修改
5. test_job_retry_orphan — 重试耗尽孤儿
6. test_report_empty — 空
7. test_report_details — 详情
8. test_rerun_safe — 可重复
## 任务 157:任务存在结果缺失巡检
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
只读巡检:任务存在但结果缺失(SUCCESS 任务无 file_result)清单。
### 测试用例(≥8)
1. test_missing_result_detected — 检出
2. test_with_result_not_reported — 有结果不报
3. test_success_no_result — SUCCESS 无结果
4. test_running_ignored — 运行中忽略
5. test_report_empty
6. test_read_only
7. test_details
8. test_rerun_safe
## 任务 158:结果存在文件缺失巡检
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
只读巡检:file_result 的 resultFileUrl 对应文件在 OSS/本地不存在清单。
### 测试用例(≥8)
1. test_file_missing_detected
2. test_file_exists_ok
3. test_blank_url_handled — 空 URL
4. test_oss_check — OSS 校验(mock)
5. test_report_empty
6. test_read_only
7. test_details
8. test_rerun_safe
## 任务 159:已完成任务活跃 Job 巡检
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
只读巡检:任务已终态(SUCCESS/FAILED)但仍有活跃(RUNNING/PENDING)Job 清单。
### 测试用例(≥8)
1. test_active_job_after_terminal — 检出
2. test_terminal_no_job_ok
3. test_job_active_task_running_ok — 运行中任务正常
4. test_stuck_job_reported — 卡死 Job
5. test_report_empty
6. test_read_only
7. test_details
8. test_rerun_safe
## 任务 160:超保留期仍被引用巡检
**所属模块**:09 临时文件 **依赖**:150 **预估**:8-15 分钟
### 功能点要求
只读巡检:临时文件超保留期但仍有引用清单(供人工处理)。
### 测试用例(≥8)
1. test_over_retention_referenced — 检出
2. test_in_retention_ok
3. test_over_retention_unreferenced — 无引用(另表)
4. test_boundary_retention — 边界时间
5. test_report_empty
6. test_read_only
7. test_details
8. test_rerun_safe
## 任务 161:巡检任务开关(默认 disabled)
**所属模块**:09 临时文件 **依赖**:155-160 **预估**:8-15 分钟
### 功能点要求
全部巡检任务由配置开关控制(默认 disabled);启用后按调度间隔执行;双实例不重复输出(owner 或随机)。
### 测试用例(≥8)
1. test_disabled_by_default — 默认关
2. test_enabled_runs — 启用执行
3. test_schedule_interval — 间隔配置
4. test_dual_instance_no_dup — 双实例不重复
5. test_run_error_grace — 异常不阻断
6. test_each_report_independent — 各报表独立
7. test_config_override — 覆盖生效
8. test_enabled_no_crash — 启用稳定
## 任务 162:路径穿越测试
**所属模块**:09 临时文件 **依赖**:151 **预估**:8-15 分钟
### 功能点要求
穿越输入矩阵:`../`、`..\\`、绝对路径、URL 编码 `%2e%2e`、Unicode 全角点、混合分隔符——全部拒绝。
### 测试用例(≥8)
1. test_dotdot_slash — ../
2. test_dotdot_backslash — ..\
3. test_encoded_dotdot — %2e%2e
4. test_fullwidth_dot — 全角点
5. test_abs_win_path — C:\ 形式
6. test_abs_unix_path — /etc 形式
7. test_mixed_separator — 混合分隔符
8. test_null_byte — 空字节
## 任务 163:引用中文件不清测试
**所属模块**:09 临时文件 **依赖**:150 **预估**:8-15 分钟
### 功能点要求
被 job/result 引用的文件:清理流程跳过;仅未引用文件被清理(清理流程本身在后续批次实现时,本任务先固化引用检查)。
### 测试用例(≥8)
1. test_job_referenced_skip — job 引用跳过
2. test_result_referenced_skip — result 引用跳过
3. test_unreferenced_passes — 未引用通过
4. test_multi_reference — 多引用
5. test_check_after_delete_history — 删历史后解除引用
6. test_check_batch_mixed — 混合批次
7. test_check_null_safe
8. test_check_idempotent
## 任务 164:清理失败不阻断测试
**所属模块**:09 临时文件 **依赖**:152 **预估**:8-15 分钟
### 功能点要求
清理一个文件失败不影响其他文件清理;主业务不受影响;错误可见(日志/指标)。
### 测试用例(≥8)
1. test_one_fail_others_succeed — 单失败其余成功
2. test_failure_visible — 错误可见
3. test_no_throw_up — 不上抛
4. test_retry_next_round — 下轮重试
5. test_partial_result_reported — 部分结果报告
6. test_metric_recorded — 指标
7. test_flow_continues — 流程继续
8. test_no_cascading — 无级联
## 任务 165:巡检只读测试
**所属模块**:09 临时文件 **依赖**:155-161 **预估**:8-15 分钟
### 功能点要求
全部巡检运行后:零删除、零状态修改、零写库(只读);可重复执行。
### 测试用例(≥8)
1. test_no_delete — 零删除
2. test_no_state_change — 状态不变
3. test_no_db_write — 无写库
4. test_read_repeatable — 重复一致
5. test_isolated_reports — 报表隔离
6. test_read_only_assert — 只读断言
7. test_no_side_effects — 无副作用
8. test_full_suite_run — 全巡检套件
### 收尾验证(本模块)
`mvn test` 相关类全绿;09 spec §4 不变要求逐项核对(fileKey 语义、上传协议不变)。
@@ -0,0 +1,184 @@
# 10-plan — 外部 HTTP 客户端配置治理
> 对应 `docs/specs/10-http-client-governance.md`。现状:HttpClientPool 已统一(Coze/品牌/紫鸟共用连接池)。
> 技术栈:Java 21 + JDK HttpClient + RestClient。
## 任务 166:各客户端契约表盘点
**所属模块**:10 HTTP 客户端 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
盘点 Coze/OSS/RustFS/图片下载/紫鸟各客户端现状:connect/read/write/call timeout、重试、幂等性;产出契约表文档;标注 JDK HttpClient 平台限制(无独立 write timeout、连接池上限不可配置);不改代码。
### 测试用例(≥8)
1. test_contract_table_all_clients — 全客户端
2. test_timeouts_listed — 超时现状
3. test_retry_listed — 重试现状
4. test_idempotency_listed — 幂等性
5. test_jdk_limits_noted — 平台限制
6. test_doc_committed — 文档存在
7. test_no_code_change — 零代码
8. test_repeatable — 可复查
### TDD 流程
1. 断言文档存在 → RED
2. 产出契约表 → GREEN
## 任务 167:aiimage.http-client.* 配置命名空间
**所属模块**:10 HTTP 客户端 **依赖**:166 **预估**:8-15 分钟
### 功能点要求
application.yml 新增 `aiimage.http-client.*` 命名空间(connect-timeout/read-timeout/call-timeout/retry 默认值);默认值与现状一致;配置类绑定校验。
### 测试用例(≥8)
1. test_config_namespace_exists — 命名空间
2. test_defaults_match_current — 默认一致
3. test_connect_timeout_bound — 合法值
4. test_read_timeout_bound
5. test_retry_count_bound
6. test_invalid_values_clamped — 非法钳制
7. test_config_class_binding — 绑定类
8. test_env_override — env 覆盖
## 任务 168:Coze 客户端配置接入
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
### 功能点要求
Coze 客户端从配置读取超时/重试(现为硬编码或独立配置);行为不变(默认值等同现状)。
### 测试用例(≥8)
1. test_coze_timeout_from_config — 配置生效
2. test_coze_default_kept — 默认不变
3. test_coze_override — 覆盖
4. test_coze_call_timeout — 总时长
5. test_coze_retry_config — 重试配置
6. test_coze_pool_shared — 共用连接池
7. test_coze_idempotent_post — 幂等标注
8. test_coze_behavior_same — 行为一致
## 任务 169:品牌检查客户端配置接入
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
同 168 模式。
### 测试用例(≥8)
同 168(品牌检查)。
## 任务 170:紫鸟客户端配置接入
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
同 168 模式。
### 测试用例(≥8)
同 168(紫鸟)。
## 任务 171:图片下载客户端配置接入
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
同 168 模式(图片下载特有:大响应流式读取)。
### 测试用例(≥8)
1-8:配置生效、默认、覆盖、call timeout、重试、池共享、幂等、流式读取。
## 任务 172:幂等重试守卫
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
### 功能点要求
统一重试守卫:仅幂等请求(GET/HEAD)自动重试;非幂等(POST/PUT)不自动重试;重试次数与退避从配置;防重试风暴。
### 测试用例(≥8)
1. test_get_retried — GET 重试
2. test_post_not_retried — POST 不重试
3. test_retry_count_limited — 次数限制
4. test_retry_backoff — 退避
5. test_idempotent_header_override — 显式幂等标记
6. test_retry_success_after_fail — 重试成功
7. test_retry_exhausted_fail — 耗尽失败
8. test_no_retry_storm — 不风暴
## 任务 173:超时生效测试
**所属模块**:10 HTTP 客户端 **依赖**:168-171 **预估**:8-15 分钟
### 功能点要求
mock 慢端点(>read timeout):请求在超时内失败;connect timeout 生效;call timeout 生效(RestClient 层)。
### 测试用例(≥8)
1. test_read_timeout_fires — 读超时
2. test_read_timeout_duration — 时长断言
3. test_connect_timeout_fires — 连接超时
4. test_connect_timeout_duration
5. test_call_timeout_fires — 总时长
6. test_fast_response_ok — 快响应正常
7. test_timeout_error_type — 错误类型
8. test_timeout_after_config — 配置生效
## 任务 174:连接复用测试
**所属模块**:10 HTTP 客户端 **依赖**:168-171 **预估**:8-15 分钟
### 功能点要求
连续 N 请求复用底层连接(共享 HttpClient);不同客户端共用连接池;连接不复用时暴露。
### 测试用例(≥8)
1. test_connection_reused — 复用
2. test_shared_across_clients — 跨客户端共用
3. test_sequential_requests — 顺序复用
4. test_keep_alive_header — keep-alive
5. test_no_new_connection_burst — 突发不建新连
6. test_pool_singleton — 单例
7. test_concurrent_reuse — 并发复用
8. test_connection_stats — 连接统计
## 任务 175:Python 回调超时不变确认
**所属模块**:10 HTTP 客户端 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
只读确认:Java 侧外部客户端改动不影响 Python 回调请求的超时与重试约定(Python 侧 requests 调用不动);写断言测试固化 Python 回调契约不受 Java 配置影响。
### 测试用例(≥8)
1. test_python_callback_contract — 回调契约
2. test_no_java_config_affects_python — 不受影响
3. test_python_timeout_doc — 文档一致
4. test_python_retry_doc
5. test_python_headers — 头一致
6. test_python_success_detection — 成功判定
7. test_python_contract_frozen — 快照
8. test_no_code_change_python — Python 零改动
## 任务 176:重试计数与日志字段
**所属模块**:10 HTTP 客户端 **依赖**:172 **预估**:8-15 分钟
### 功能点要求
重试时记录日志(客户端/URL/尝试次数/耗时);重试计数指标;不记录敏感信息。
### 测试用例(≥8)
1. test_retry_logged — 日志
2. test_retry_attempt_field — 尝试次数
3. test_retry_duration — 耗时
4. test_retry_metric — 指标
5. test_no_token_in_log — 无敏感信息
6. test_success_no_retry_log — 成功不记
7. test_log_level — 日志级别
8. test_final_failure_logged — 最终失败
## 任务 177:10 全量回归
**所属模块**:10 HTTP 客户端 **依赖**:168-176 **预估**:8-15 分钟
### 功能点要求
全部客户端配置改造后:现有测试全绿;外部服务 mock 集成测试通过;行为与默认配置下现状一致。
### 测试用例(≥8)
1-8:各客户端测试绿、HttpClientPool 既有测试绿、配置绑定测试、超时测试、复用测试、幂等守卫、日志脱敏、全量单测
### 验证方法
`mvn test` 全量 + `mvn clean package -DskipTests`。
@@ -0,0 +1,245 @@
# 11-plan — 可观测性:指标定义与日志字段规范
> 对应 `docs/specs/11-observability.md`。决策:指标名与日志字段规范先行落地;不引入新监控组件(Micrometer 若已依赖则用,未依赖则手动计数器+日志)。
> 技术栈:Java 21 + Slf4j +(可选 Micrometer)。
## 任务 178:日志字段规范落地
**所属模块**:11 可观测性 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
业务日志统一携带结构化字段:traceId/taskId/moduleType/stage/submissionId/chunkIndex/chunkTotal/jobId/result/errorType;缺失字段用占位;不删现有日志。
### 测试用例(≥8)
1. test_worker_log_has_task_id — Worker 日志含 taskId
2. test_worker_log_has_module_type
3. test_worker_log_has_stage
4. test_result_log_fields — /result 日志字段
5. test_heartbeat_log_fields
6. test_missing_field_placeholder — 缺字段占位
7. test_log_field_names_frozen — 字段名快照
8. test_no_log_content_break — 日志内容不破坏
## 任务 179:禁止记录清单审计
**所属模块**:11 可观测性 **依赖**:178 **预估**:8-15 分钟
### 功能点要求
审计日志代码:Token/Cookie/完整请求体/文件二进制/用户凭据/敏感 API Key 不入日志;发现问题修正。
### 测试用例(≥8)
1. test_no_token_logged — 无 Token
2. test_no_cookie_logged — 无 Cookie
3. test_no_full_body_logged — 无完整 body
4. test_no_binary_logged — 无二进制
5. test_no_credential_logged — 无凭据
6. test_no_api_key_logged — 无 API Key
7. test_allowed_fields_kept — 允许字段保留
8. test_audit_script — 审计脚本可重复
## 任务 180:Worker 日志字段对齐
**所属模块**:11 可观测性 **依赖**:73 **预估**:8-15 分钟
### 功能点要求
TaskResultFileJobWorker(04 改造后)日志字段与规范对齐:jobId/taskId/moduleType/stage/errorType;现有 [task-file-job] 前缀保留。
### 测试用例(≥8)
1. test_dispatch_log_fields — dispatch 日志
2. test_success_log_fields
3. test_failure_log_fields
4. test_retry_log_fields
5. test_heartbeat_log_fields
6. test_stuck_log_fields
7. test_field_names_consistent — 与规范一致
8. test_no_sensitive — 无敏感
## 任务 181:task.created/running 指标埋点
**所属模块**:11 可观测性 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
任务创建(created 计数)与运行中(running gauge)指标;带 moduleType/instanceId 标签;无监控栈时输出日志记录。
### 测试用例(≥8)
1. test_created_incremented — 创建计数
2. test_running_gauge — 运行 gauge
3. test_module_label — 标签
4. test_instance_label — instanceId 标签
5. test_created_module_specific — 分模块
6. test_counter_persistent — 计数正确性
7. test_gauge_update — 更新
8. test_metric_name_frozen — 名称快照
## 任务 182:task.success/failed/cancelled 指标埋点
**所属模块**:11 可观测性 **依赖**:181 **预估**:8-15 分钟
### 功能点要求
终态计数:success/failed/cancelled 各模块独立计数;与状态迁移一致。
### 测试用例(≥8)
1. test_success_counted
2. test_failed_counted
3. test_cancelled_counted
4. test_module_split — 分模块
5. test_no_double_count — 不重复计
6. test_terminal_once — 只计一次
7. test_failed_then_success — 状态反转不重计
8. test_names_frozen
## 任务 183:task.duration 指标埋点
**所属模块**:11 可观测性 **依赖**:182 **预估**:8-15 分钟
### 功能点要求
任务耗时(开始→终态)记录;直方图或耗时日志;分模块。
### 测试用例(≥8)
1. test_duration_recorded — 记录
2. test_duration_positive — 正值
3. test_module_split
4. test_short_task — 短任务
5. test_long_task — 长任务
6. test_duration_bound — 上界
7. test_duration_zero_guard — 零保护
8. test_name_frozen
## 任务 184:task.heartbeat.age 指标埋点
**所属模块**:11 可观测性 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
心跳年龄 gauge:任务最后心跳距今时间;超阈值可观测(日志告警)。
### 测试用例(≥8)
1. test_age_computed — 年龄计算
2. test_age_fresh — 新鲜
3. test_age_stale — 陈旧
4. test_age_threshold_warn — 阈值告警
5. test_no_heartbeat — 无心跳处理
6. test_age_zero — 刚心跳
7. test_age_clock_negative — 时钟负保护
8. test_name_frozen
## 任务 185:file-job.* 指标埋点
**所属模块**:11 可观测性 **依赖**:73 **预估**:8-15 分钟
### 功能点要求
TaskFileJobWorker 指标:pending/running/success/failed/duration/retry;分 moduleType/instanceId。
### 测试用例(≥8)
1. test_pending_counted
2. test_running_counted
3. test_success_counted
4. test_failed_counted
5. test_duration_recorded
6. test_retry_counted
7. test_module_instance_labels
8. test_names_frozen
## 任务 186:上传耗时/大小指标埋点
**所属模块**:11 可观测性 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
文件上传:耗时、大小、成功率指标;分 moduleType。
### 测试用例(≥8)
1. test_upload_duration
2. test_upload_size
3. test_upload_success_rate
4. test_module_split
5. test_upload_failed
6. test_upload_large
7. test_size_bound
8. test_names_frozen
## 任务 187:临时磁盘指标埋点
**所属模块**:11 可观测性 **依赖**:154 **预估**:8-15 分钟
### 功能点要求
临时磁盘容量/占用指标;与 09 告警联动。
### 测试用例(≥8)
1. test_disk_usage_measured
2. test_disk_capacity
3. test_usage_percent
4. test_threshold_warn
5. test_empty_dir
6. test_measure_failure_grace
7. test_name_frozen
8. test_no_block
## 任务 188:指标标签规范
**所属模块**:11 可观测性 **依赖**:181-187 **预估**:8-15 分钟
### 功能点要求
统一标签:moduleType/instanceId 必带;标签值规范化(null→unknown);不记录用户级数据。
### 测试用例(≥8)
1. test_module_label_all_metrics — 全指标带
2. test_instance_label_all
3. test_null_module_unknown — null 归一
4. test_no_user_label — 无用户级
5. test_label_consistent — 命名一致
6. test_label_value_clean — 值清洗
7. test_cardinality_bounded — 基数有界
8. test_spec_frozen — 规范冻结
## 任务 189:指标命名一致性测试
**所属模块**:11 可观测性 **依赖**:188 **预估**:8-15 分钟
### 功能点要求
全部指标名与 11 spec §1 标准名一致(aiimage.* 前缀);无拼写漂移。
### 测试用例(≥8)
1. test_prefix_aiimage — 前缀
2. test_task_metric_names — 任务族
3. test_file_job_metric_names — 文件族
4. test_no_typo_drift — 无拼写漂移
5. test_snapshot_all_metrics — 全指标快照
6. test_new_metric_must_register — 新指标注册
7. test_metric_doc_sync — 文档同步
8. test_case_consistent — 大小写一致
## 任务 190:日志脱敏测试
**所属模块**:11 可观测性 **依赖**:179 **预估**:8-15 分钟
### 功能点要求
敏感值(Token/Key/凭据)即使传入日志调用点也被脱敏(占位符);断言日志输出无原文。
### 测试用例(≥8)
1. test_token_masked
2. test_api_key_masked
3. test_password_masked
4. test_cookie_masked
5. test_partial_token_masked — 部分值
6. test_url_query_masked — URL 查询参数
7. test_masking_consistent — 一致
8. test_normal_fields_kept — 正常字段保留
## 任务 191:双实例指标区分回归
**所属模块**:11 可观测性 **依赖**:188-190 **预估**:8-15 分钟
### 功能点要求
双实例部署:instanceId 标签区分 server-110/server-121;指标不串;日志含实例标识。
### 测试用例(≥8)
1. test_instance_110_label
2. test_instance_121_label
3. test_no_cross_instance — 不串
4. test_instance_unknown — 未配置
5. test_log_has_instance — 日志实例
6. test_metric_aggregation_ok — 聚合可用
7. test_label_stable — 标签稳定
8. test_snapshot_frozen
### 收尾验证(本模块)
`mvn test` 相关类全绿;11 spec §2 禁止记录清单逐项对照。
@@ -0,0 +1,137 @@
# 12-plan — Flyway 迁移规范与只读巡检
> 对应 `docs/specs/12-flyway-and-inspection.md`。只追加不改历史;巡检默认关闭。
> 技术栈:Java 21 + Flyway + SQL。
## 任务 192:迁移规范模板
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
### 功能点要求
`docs/` 产出迁移规范模板:变更目的/影响表和数据量/锁表风险/验证 SQL/回滚步骤/上线窗口六项必填;新迁移文件头注释引用模板。
### 测试用例(≥8)
1. test_template_exists — 模板存在
2. test_six_fields — 六字段齐全
3. test_template_has_example — 示例
4. test_rollback_steps — 回滚步骤
5. test_validation_sql — 验证 SQL 示例
6. test_window_field — 上线窗口
7. test_doc_committed
8. test_template_usable — 可复制使用
## 任务 193:历史迁移盘点
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
### 功能点要求
盘点 db/ 下 V87+ 迁移:编号连续性、无修改历史(git 不动)、生产已执行版本核对;产出盘点报表。
### 测试用例(≥8)
1. test_version_sequential — 编号连续
2. test_no_legacy_modified — 历史未改
3. test_latest_version_noted — 最新版本记录
4. test_duplicate_version — 无重复编号
5. test_migration_single_purpose — 单迁移单目的(抽查)
6. test_report_committed
7. test_checksum_stable — 校验和稳定
8. test_repeatable
## 任务 194:orphan Job 巡检 SQL
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
### 功能点要求
巡检 SQL:task_file_job 无对应 task/result;SQL 只读;输出孤儿清单。
### 测试用例(≥8)
1. test_sql_syntax_valid — 语法有效
2. test_sql_read_only — 只读(SELECT)
3. test_orphan_detected — 检出
4. test_valid_excluded — 正常排除
5. test_join_condition — 关联条件
6. test_no_side_effect — 无副作用
7. test_empty_result_ok — 空结果
8. test_documented — 文档
## 任务 195:orphan payload 巡检 SQL
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
同 194 模式(payload 无对应任务)。
### 测试用例(≥8)
同 194(payload 表)。
## 任务 196:任务存在结果缺失巡检 SQL
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
同 194 模式(SUCCESS 任务无结果)。
### 测试用例(≥8)
同 194。
## 任务 197:结果存在文件缺失巡检 SQL
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
同 194 模式(resultFileUrl 对应对象不存在——SQL 先出清单,对象检查在 09/158 配合)。
### 测试用例(≥8)
同 194。
## 任务 198:已完成任务活跃 Job 巡检 SQL
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
同 194 模式(终态任务仍有活跃 job)。
### 测试用例(≥8)
同 194。
## 任务 199:超保留期引用巡检 SQL
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
同 194 模式(临时文件超保留期仍有引用)。
### 测试用例(≥8)
同 194。
## 任务 200:巡检报表任务落地
**所属模块**:12 Flyway **依赖**:194-199 **预估**:8-15 分钟
### 功能点要求
巡检定时任务:执行 6 张报表 SQL;默认 disabled;启用后输出报表日志;失败不阻断。
### 测试用例(≥8)
1. test_disabled_default
2. test_enabled_runs_all — 6 报表全跑
3. test_report_output
4. test_failure_grace
5. test_schedule_config
6. test_no_delete
7. test_dual_instance
8. test_enabled_stable
## 任务 201:迁移演练
**所属模块**:12 Flyway **依赖**:192 **预估**:8-15 分钟
### 功能点要求
副本库演练:flyway migrate 干净执行;验证 SQL 通过;锁表风险评估(索引类迁移在表大小场景);回滚步骤验证。
### 测试用例(≥8)
1. test_migrate_clean — 干净迁移
2. test_validate_sql_pass — 验证 SQL
3. test_rollback_script — 回滚
4. test_lock_window_estimated — 锁窗口
5. test_checksum_ok
6. test_idempotent_rerun
7. test_no_legacy_touch — 不动历史
8. test_documented
### 收尾验证(本模块)
`mvn test` 相关类 + 巡检 SQL 在副本库执行通过。
@@ -0,0 +1,315 @@
# 13-plan — 契约测试与模块边界治理
> 对应 `docs/specs/13-contract-tests-and-boundaries.md`。契约测试与代码同 PR 提交;CI 追加测试阶段。
> 技术栈:Java 21 + JUnit5 + ArchUnit + Vitest(前端)。
## 任务 202:Python-contract 夹具准备
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
录制 app_client/amazon 实际调用(/result、/items、parsed-payload、heartbeat)的真实请求报文,脱敏后入测试资源(JSON 夹具);夹具文件结构明确。
### 测试用例(≥8)
1. test_fixture_result_exists — result 夹具
2. test_fixture_items_exists — items 夹具
3. test_fixture_parsed_payload — parsed-payload 夹具
4. test_fixture_heartbeat — heartbeat 夹具
5. test_fixture_sanitized — 脱敏(无真实凭据)
6. test_fixture_shape_valid — 结构有效
7. test_fixture_fields_documented — 字段说明
8. test_fixture_reproducible — 可复录
## 任务 203:/result 幂等契约测试
**所属模块**:13 契约 **依赖**:202 **预估**:8-15 分钟
### 功能点要求
同 submissionId 重复提交 /result:HTTP 200 + success=true;只落一次;chunkIndex/chunkTotal 语义;done=true 封口。
### 测试用例(≥8)
1. test_result_success_contract — 200+true
2. test_result_duplicate_idempotent — 幂等
3. test_result_single_persist — 单次落库
4. test_result_chunk_fields — 分片字段
5. test_result_done_contract — 封口
6. test_result_error_contract — 失败语义
7. test_result_unknown_task — 未知任务
8. test_result_fixture_replay — 夹具回放
## 任务 204:/items 分页语义契约测试
**所属模块**:13 契约 **依赖**:202 **预估**:8-15 分钟
### 功能点要求
collectdata/publish 的 items 接口:分页参数(page/pageSize)、排序、字段结构、缺省行为与 Python Worker 拉取约定一致。
### 测试用例(≥8)
1. test_items_pagination — 分页
2. test_items_defaults — 默认值
3. test_items_field_shape — 字段结构
4. test_items_page_bounds — 越界处理
5. test_items_order — 排序
6. test_items_empty — 空页
7. test_items_worker_order — Worker 顺序
8. test_items_fixture_replay
## 任务 205:parsed-payload 契约测试
**所属模块**:13 契约 **依赖**:202 **预估**:8-15 分钟
### 功能点要求
similarasin/appearancepatent 的 parsed-payload:字段结构、分页语义、submissionId 关联与 Python 读取约定一致。
### 测试用例(≥8)
1. test_parsed_payload_shape
2. test_parsed_payload_pagination
3. test_parsed_payload_submission
4. test_parsed_payload_empty
5. test_parsed_payload_unknown_task
6. test_parsed_payload_fixture_replay
7. test_parsed_payload_status
8. test_parsed_payload_frozen
## 任务 206:heartbeat 旧字段契约测试
**所属模块**:13 契约 **依赖**:202 **预估**:8-15 分钟
### 功能点要求
heartbeat 接口:路径、请求/响应字段与 Python Worker 约定一致;缺字段/多余字段处理。
### 测试用例(≥8)
1. test_heartbeat_path
2. test_heartbeat_fields
3. test_heartbeat_unknown_task
4. test_heartbeat_missing_optional
5. test_heartbeat_extra_field_tolerant — 多余字段容忍
6. test_heartbeat_fixture_replay
7. test_heartbeat_success
8. test_heartbeat_frozen
## 任务 207:done=true 最后一批契约测试
**所属模块**:13 契约 **依赖**:203 **预估**:8-15 分钟
### 功能点要求
done=true 最后一批:强制处理剩余数据、生成结果文件、任务终态;协议与 Python 端一致。
### 测试用例(≥8)
1. test_done_force_process
2. test_done_finalize_task
3. test_done_generate_file
4. test_done_after_partial_chunks
5. test_done_no_pending — 无剩余
6. test_done_repeat
7. test_done_fixture_replay
8. test_done_frozen
## 任务 208:JavaApiResponse 包装契约测试(前端)
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
前端契约:JavaApiResponse 结构(success/message/data);LegacyApiSuccess(msg)兼容;解包行为(复用 01 callJava 测试)固化。
### 测试用例(≥8)
1. test_java_response_success_shape
2. test_java_response_failure_shape
3. test_legacy_success_shape
4. test_unwrap_success
5. test_unwrap_failure_throws
6. test_null_data_shape
7. test_extra_fields_tolerant
8. test_snapshot_frozen
## 任务 209:字段兼容 schema 覆盖
**所属模块**:13 契约 **依赖**:208 **预估**:8-15 分钟
### 功能点要求
核心字段 schema:user_id/task_ids(请求)、taskId/resultId/fileKey/status/taskStatus/fileStatus(响应);api-field-compat 检查接入。
### 测试用例(≥8)
1. test_request_user_id_schema
2. test_request_task_ids_schema
3. test_response_task_id_schema
4. test_response_result_id_schema
5. test_response_file_key_schema
6. test_response_status_schema
7. test_compat_checker_integrated
8. test_schema_frozen
## 任务 210:ArchUnit 依赖方向规则
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
ArchUnit 规则:Controller→Service→Mapper 单向;Controller 不依赖外部 Client 细节;task 模块规则见 212;规则测试可运行。
### 测试用例(≥8)
1. test_controller_depends_service — 允许方向
2. test_service_depends_mapper — 允许
3. test_controller_to_mapper_forbidden — 禁止
4. test_no_cycle — 无环
5. test_rule_scope_modules — 作用域
6. test_rule_verbose — 失败信息
7. test_all_controllers_covered — 覆盖
8. test_rule_stable — 稳定
## 任务 211:ArchUnit Controller 不访问 Mapper
**所属模块**:13 契约 **依赖**:210 **预估**:8-15 分钟
### 功能点要求
强化规则:任何 Controller 不得注入/调用 Mapper;违例失败。
### 测试用例(≥8)
1. test_no_mapper_in_controller
2. test_violation_detected — 违例检出
3. test_message_clear
4. test_controller_service_ok — 允许路径
5. test_all_controllers_covered
6. test_no_mapper_field
7. test_rule_in_ci
8. test_snapshot_frozen
## 任务 212:ArchUnit task 模块不依赖业务模块
**所属模块**:13 契约 **依赖**:210 **预估**:8-15 分钟
### 功能点要求
公共 task 模块不得 import 业务模块(similarasin/appearancepatent/...);04 的 Handler SPI 已反转依赖;规则检查通过。
### 测试用例(≥8)
1. test_task_no_business_dep — 无业务依赖
2. test_spi_interface_allowed — SPI 接口豁免
3. test_violation_detected
4. test_message_clear
5. test_04_registry_ok — 注册表符合
6. test_all_task_classes_covered
7. test_rule_in_ci
8. test_snapshot_frozen
## 任务 213:前端共享层导出白名单
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
TS 检查:页面(pages/*)禁止直接 import shared/api/http.ts 或拼 URL;只允许 import java-modules.ts 的 API 函数与 bridges;违例编译失败(lint 规则或类型守卫)。
### 测试用例(≥8)
1. test_page_no_http_direct — 页面不直连 http
2. test_page_no_url_concat — 不拼 URL
3. test_page_uses_api_module — 用 API 层
4. test_shared_internal_allowed — shared 内部允许
5. test_bridge_allowed — bridge 允许
6. test_violation_detected
7. test_check_runs_in_ci
8. test_allowlist_frozen
## 任务 214:progress/batch 轻量响应契约
**所属模块**:13 契约 **依赖**:109 **预估**:8-15 分钟
### 功能点要求
progress/batch 契约:items/missingTaskIds 结构;task 轻量字段;file 字段(除 collectdata);前端解析一致。
### 测试用例(≥8)
1. test_progress_batch_shape
2. test_missing_ids_shape
3. test_task_light_fields
4. test_file_fields_included
5. test_collectdata_exception — 例外模块
6. test_frontend_parse_compat
7. test_snapshot_frozen
8. test_light_vs_batch_consistency
## 任务 215:下载 URL 格式契约
**所属模块**:13 契约 **依赖**:147 **预估**:8-15 分钟
### 功能点要求
downloadUrl 契约:公开直链格式(https、bucket 包含、result/ 前缀下载域名);无签名;前端 save_file 流程兼容。
### 测试用例(≥8)
1. test_download_url_https
2. test_download_url_bucket
3. test_result_prefix_endpoint
4. test_no_signature
5. test_frontend_save_compat
6. test_blank_handling
7. test_contract_frozen
8. test_download_flow_end2end
## 任务 216:CI 接入测试阶段
**所属模块**:13 契约 **依赖**:210-215 **预估**:8-15 分钟
### 功能点要求
.gitea/workflows/build.yml 追加:mvn test(契约+ArchUnit)、前端 vitest、契约快照比对;失败即红。
### 测试用例(≥8)
1. test_ci_has_test_stage — 测试阶段
2. test_ci_java_tests — Java 测试命令
3. test_ci_frontend_tests — 前端测试
4. test_ci_snapshot_check
5. test_ci_fail_fast — 失败即红
6. test_ci_cache
7. test_ci_timeout
8. test_ci_documented
## 任务 217:快照对比工具
**所属模块**:13 契约 **依赖**:90 **预估**:8-15 分钟
### 功能点要求
Service 拆分前后响应一致工具:录制(输入→输出)golden;对比(输出 diff);供 05 各模块使用。
### 测试用例(≥8)
1. test_tool_records
2. test_tool_compares_equal
3. test_tool_diff_detected
4. test_tool_output_report
5. test_tool_reusable
6. test_tool_commits_golden
7. test_tool_clear_error
8. test_tool_documented
## 任务 218:结果文件格式契约
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
### 功能点要求
结果文件格式契约:文件名(*-result.xlsx 模式)、Sheet 名称、列顺序、ZIP 结构;与 Python/前端约定一致;改造(04/05)后不变。
### 测试用例(≥8)
1. test_filename_pattern
2. test_sheet_name
3. test_column_order
4. test_zip_structure
5. test_encoding_utf8
6. test_empty_result_file
7. test_contract_frozen
8. test_regression_guard
## 任务 219:13 全量契约回归
**所属模块**:13 契约 **依赖**:202-218 **预估**:8-15 分钟
### 功能点要求
全部契约测试(Java + 前端)+ ArchUnit + 白名单检查全绿;契约快照冻结;CI 通过。
### 测试用例(≥8)
1-8:Java 契约全绿、前端契约全绿、ArchUnit 三规则、白名单、快照比对、CI 模拟、全量单测、package
### 验证方法
`mvn test` 全量 + `cd frontend-vue && npm run build && npx vitest run` + CI 检查。
### 收尾验证(全部模块——启动性/核心功能/质量 gate)
1. `mvn clean package -DskipTests` 产 JAR,`java -jar target/aiimage-backend-0.0.1-SNAPSHOT.jar`(本地配置)启动,curl 健康检查端点返回预期
2. 核心页面(`/newApi/api/...` 抽样)可访问
3. 核心交互路径:上传→解析→进度→下载最小链路真实调用非空
4. `mvn test` 全绿(≥80% 覆盖抽查)
5. `npm run build`(vue-tsc + vite)零错误;`npx vitest run` 全绿
6. check_progress 脚本返回 all tasks done(exit 0)
7. git log 验证每个 task 有对应 commit
@@ -0,0 +1,277 @@
# 品牌库 / 去重库 按公司隔离 · 二期设计方案
日期:2026-10-04 状态:**待评审,未开工**
前置:一期(`company` 表 + `users.company_id`)已上线,见 `company-multi-tenant-design-2026-10-04.md`
---
## 0. 一句话
`biz_invalid_asin_data`(后台「品牌数据库」)与 `biz_dedupe_total_data`(「去重数据汇总」)今天是**全平台共享一套**的规则库:A 公司产生的行会过滤 B 公司的采集结果。本方案把它们改成**每公司一套**,租户键在这两张表上**破例物化为 `company_id`**(推翻一期"业务表零 DDL"口径,由用户 2026-10-04 拍定)。
分 3 批上,批次 1 对线上行为零变化,且**必须最先做**——它开始记录归属,晚做一天就多一天无法回填的历史。
---
## 1. 问题与证据
### 1.1 品牌库的自动导入行没有任何归属
| 事实 | 证据 |
|---|---|
| 批量 INSERT 的列清单只有 `(data_value, brand, record_source)`,没有 `group_id` | `modules/invalidasin/mapper/InvalidAsinDataMapper.java:22-27` |
| 写入器 `toEntity` 方法签名不接任何归属参数 | `modules/collectdata/util/CollectDataInvalidAsinBatchWriter.java:65-79` |
| 表有 `group_id` 列,但只有手工新增会写 | `db/V86__invalid_asin_data_group_access.sql:11`、`InvalidAsinDataService.java:88` |
| 表**连 `user_id` 都没有** ⇒ 按一期口径无法派生公司 | `db/V94__invalid_asin_data_value_brand_unique_key.sql:4-13`(全列) |
⇒ 后台「分组」列显示"未分组"是这个原因(`InvalidAsinDataService.java:69` 把 `groupId==null` 映射成空串,前端 `admin-frontend-vue/src/pages/asin/AsinInvalidPage.vue:202` 渲染成"未分组")。
### 1.2 真正的越界在消费侧,且那里根本没有租户上下文
```
CollectDataBatchQuery.java:75-78 select brand from biz_invalid_asin_data where brand in (...) ← 无分组/公司条件
CollectDataBatchQuery.java:46 SELECT data_value FROM biz_dedupe_total_data WHERE data_value IN (...) ← 同样无条件
```
入口签名 `filter(List<CollectDataResultRowVo> rows)`(`:49`)里没有 task / user / company。
⇒ **A 公司自动导入的品牌,正在把 B 公司采集结果里同品牌的行过滤掉**;去重库同理,B 公司导入过的 ASIN 会让 A 公司的行被丢弃。这才是"数据越界"。
### 1.3 品牌库的非超管可见性被一条硬条件锁死
`InvalidAsinDataService.java:53-54`:非超管的列表条件是写死的 `record_source='MANUAL' AND group_id=固定组`。
⇒ 自动导入行对**所有非超管永久不可见**,与 `group_id` 有没有值无关。只补 `group_id` 不解决任何可见性。
(对照:去重库没有这种硬条件,非超管走 `applyGroupScope` = `group_id IN 可访问组 OR (group_id IS NULL AND uploader_user_id IN 可见用户)`,`DedupeTotalDataService.java:1212-1232`。)
### 1.4 唯一键是全局单列/双列,装不下"每公司一套"
| 表 | 现唯一键 | 证据 |
|---|---|---|
| `biz_invalid_asin_data` | `uk_data_value_brand (data_value, brand(191))` | `db/V94:48` |
| `biz_dedupe_total_data` | `uk_data_value (data_value)` | `db/V3:6` |
⇒ 同一个值全库只能存一行,谁先写归谁,后来者被 `INSERT IGNORE` 静默丢弃。**不改唯一键,"每公司一套"就是空话。**
---
## 2. 已定口径(用户 2026-10-04 拍定,勿重开)
1. 两张表都是**每公司一套**(不是全平台共享)。
2. 租户键**破例物化为 `company_id` 列**,不用 `uploader_user_id` 派生、不复用店铺分组。
—— 这推翻一期"不给业务表加 `company_id` 冗余列"(`db/V143:5-8`)与"不复用店铺分组当租户"两条,仅限这两张表。
3. 一期"复用店铺分组当租户"被否掉的理由仍然成立(那 4 段 UNION 覆盖面窄、成员表已判废),所以 `group_id` **保留原语义**(店铺分组 = 操作维度),公司边界一律走新 `company_id`,两者不互相替代。
---
## 3. 三条硬前提(其中一条今天无法闭合)
**① `CompanyScopeSupport` 还不存在。** 一期只落了归属(company 表、`users.company_id`、建号/移人/登录回包/列表公司列),89 处数据出口一处没改——一期"对线上行为是零变化"(一期设计文档 `:19`)。本方案 §6-§8 实际是二期隔离工程的**第一块**,不是收尾。
⇒ 落地时**必须一并建** `CompanyScopeSupport`(`currentCompanyId(user)` / `memberUserIds(companyId)` / `assertSameCompany(...)`,`role=super_admin` 按 role 豁免而非按 company_id 判),否则每张表各写一套取公司的逻辑。
**② 自动导入的归属账号是调用方自报的,阶段B 之前不可信。** 写入触发点 `POST /api/collect-data/tasks/{taskId}/result` 落在 `config/AdminApiGuardFilter.java:77` 的 `USER_TOOL_PREFIXES`,而 `aiimage.security.user-tool-guard-enabled` 默认 `false`(`:128`)。该文件 `:68-74` 的注释原话:「controller 无方法级鉴权(**归属由请求参数 user_id 判定**),匿名可达即越权读写他人数据」「桌面客户端直连这些接口且不带任何认证头」。
⇒ 本方案的公司边界建立在 `task.getUserId() → users.company_id` 上,**能防住"诚实的串扰",防不住"伪造 user_id 的越权写入"**。这条只能在阶段B(设备令牌)闭合。不因此停工,但:
- 文档与工单里必须写明"这两张表的隔离在阶段B 前是**部分强度**",别把"加了 company_id"当成已隔离;
- 阶段B 工单必须把 `/api/collect-data` 收口列为**本方案的完成条件**,否则它会永远停在部分强度。
**③ 现在只有 1 家公司,改动今天不改变任何一行可见性。** 生产 `company` 表 1 行(id=1 厦门米椿花)、`users` 139 行 0 NULL(10-04 11:0x 实跑核对)。
⇒ 好处:批次 1 的回填是确定性操作、零风险。坏处:容易觉得"不急"。**回填窗口是有时限的**——第二家公司开通之后,历史 AUTO 行里"实际由谁产生"已无法追溯(`biz_invalid_asin_data` 没有 uploader 列),只能全表填 1,那就永远分不清了。这是批次 1 必须现在做的唯一理由。
---
## 4. 目标数据模型
两张表各加两列,语义一致:
| 列 | 类型 | 说明 |
|---|---|---|
| `company_id` | `BIGINT NOT NULL DEFAULT 1` | 租户硬边界。**DEFAULT 1 是混合版本窗期的必需品**,见 §11.2,且必须被摘掉(§11.4) |
| `uploader_user_id` | `BIGINT NULL` | 归属审计锚点,仅品牌库需要(去重库 `V75` 已有且已 NOT NULL) |
唯一键改为把租户键放进索引:
| 表 | 现 | 目标 | 索引字节预算(utf8mb4) |
|---|---|---|---|
| `biz_invalid_asin_data` | `uk_data_value_brand(data_value, brand(191))` | `uk_company_value_brand(company_id, data_value, brand(191))` | 8 + 128×4 + 191×4 = **1284 B** < 3072 ✅ |
| `biz_dedupe_total_data` | `uk_data_value(data_value)` | `uk_company_data_value(company_id, data_value)` | 8 + 512×4 = **2056 B** < 3072 ✅ |
两条约束:
- **不许改成前缀索引去迁就长度**。`db/V135:6-9` 已写明:去重库 `data_value` 带唯一索引,改前缀会把"前 N 字符相同"的不同值误判为重复、破坏去重语义。上面的字节数已逐个算过,不需要前缀。
- 新唯一键相对旧的是**放宽**(旧键成立 ⇒ 新键必成立),所以"删旧索引 + 建新索引"**不可能因存量数据失败**。这一点要写进迁移用例断言,作为"为什么不需要先清历史冲突行"的依据(对照 `V94:16-25` 当年换键必须先 DELETE 冲突行,这次不需要)。
---
## 5. V145 迁移设计
取号:**V145**(当前 `db/` 最大 `V144`、共 143 个文件;取号规则与幂等要求见 `backend-java/docs/migration-inventory.md`)。
必须逐条满足(全部来自一期踩过的坑):
1. **每条语句幂等**:`ADD COLUMN` / `ADD INDEX` 先查 `information_schema` 再 `PREPARE`;`UPDATE` 用 `WHERE company_id IS NULL` 限定;`DROP INDEX` 先判存在。**理由**:`flyway repair` + 重启会让 Flyway 从第一条语句重跑整个文件,而 MySQL 的 DDL 不进事务,裸语句会撞 1050/1060/1062,把"补数据后重启"变成"必须手工清库"。
2. **加列与建/删索引分条**,不塞进同一条 `ALTER`,以便失败时能判断停在哪一步。
3. **回填**:`UPDATE ... SET company_id = 1 WHERE company_id IS NULL`,紧接一条**自检闸门**——用 `MODIFY ... NOT NULL` 之前先 `SIGNAL`/除零式断言残留 NULL 数为 0,让漏回填**报迁移失败**而不是静默通过(照 `V143` 的自检闸门写法)。
4. **锁表风险**:`ADD COLUMN` 在 MySQL 8 是 INSTANT;`ADD UNIQUE INDEX` / `DROP INDEX` 是 INPLACE(重建索引,非 COPY 全表)。**行数必须在上线前于生产实查并回填本节**——不要拿后台列表里看到的最大 ID 当行数(`aiimage.sql` 快照的 `AUTO_INCREMENT` 有跳号,ID 上界 ≠ 行数,一期已为此订正过一次)。不碰 `biz_task_file_job` 等锁热点表。
5. **验证 SQL 段**放文件末尾,且**上线时必须有人实跑**(一期欠的就是这条,见 §11.5):列存在性与 `COLUMN_DEFAULT`、唯一键字段组合、NULL 残留数、`INSERT IGNORE` 在新键下的幂等复验。
6. **回滚不进 Flyway 扫描路径**:写 `docs/rollback-V145-company-scope.sql`,顺序照一期(停两台 → 跑脚本 → 删 `flyway_schema_history` 本版本行 → 回滚 jar → 起应用)。**不许编成 `V146`**。
---
## 6. 写入侧改造(逐入口)
### 6.1 品牌库 `biz_invalid_asin_data`
| 入口 | 位置 | company_id 从哪来 | uploader_user_id |
|---|---|---|---|
| 手工新增 | `InvalidAsinDataService.java:80-92` | 超管:请求显式指定并校验;非超管:**锁操作人本公司**(照 `resolveManualWriteGroup:126-135` 的同构规则) | = operatorId |
| 编辑 | `:95-117` | **不许跨公司移动**:`company_id` 不出现在更新语句里 | 保留原值 |
| 单行删除 | `:120-124` | 加 `assertSameCompany` 前置 | — |
| 自动导入(采集回传) | `CollectDataInvalidAsinBatchWriter.java:38,65-79` | **方法签名加租户上下文参数**;由调用点从 `task.getUserId() → users.company_id` 解析 | = `task.getUserId()` |
| 自动导入(品牌复检查注入) | `CollectDataBrandRecheckInjector.java:114` | 同上,作用域里已有 `FileTaskEntity task`(`:78`) | 同上 |
`insertBatchIgnore` 的列清单(`InvalidAsinDataMapper.java:22-27`)补 `company_id, uploader_user_id`。
### 6.2 去重库 `biz_dedupe_total_data`
写入口共 4 个,全部已有 `group_id` + `uploader_*`,只需**并排补 `company_id`**:手工新增(`DedupeTotalDataService.java:436-448`)、Excel 导入(`:894-945`,`insertBatchIgnore` 唯一调用点 `:922`)、删除导入(`:1168-1177`)、更新(`:1096-1106`,同样不许跨公司移动)。
`company_id` 取值规则与 6.1 一致:非超管锁操作人本公司,超管可显式指定。注意 `resolveWritableGroup:1234-1240` 现在对 `groupId<=0` 直接抛"请选择分组"——**公司要加一条同构的 fail-fast**,见 §10。
### 6.3 一个必须写进代码的约束
**写入路径不得依赖数据库 `DEFAULT 1` 兜住漏传。** 所有实体在进入 mapper 前 `company_id == null` 就必须抛异常。理由见 §11.2——这条 DEFAULT 在混合窗口里是必需的,但它同时会把"漏传"变成静默落公司 1,只能靠代码出口拦,不能靠 DB。
---
## 7. 读取侧改造(后台)
### 7.1 品牌库 `InvalidAsinDataService.page():34-77`
非超管条件从
```java
query.eq(recordSource, MANUAL).eq(groupId, fixedGroupId) // :53-54
```
改为
```java
query.eq(companyId, 本公司).eq(groupId, fixedGroupId) // 只去掉 MANUAL 硬条件
```
**分组维度保持 `= 固定组`(`resolveFixedAccessibleGroupId:203-212`),不要顺手放宽成 `IN 可访问组`。** 理由:写侧 `resolveManualWriteGroup:126-135` 非超管只能落到固定组,读侧若用集合就会出现"看得到别人那组、却写不进自己这组"的错配。不变式钉成一条:**能写的那一组 = 能看到的那一组**。
**这条改动的可见性影响是刻意设计的,且是安全的**:历史自动导入行 `group_id IS NULL` ⇒ 被 `= 固定组` 天然排除,非超管不会一夜之间看到全部历史行;新写入的自动导入行带 `group_id` ⇒ 本组可见。**这正是"补 group_id"和"改读侧条件"必须同批的原因**(§1.3)。
超管:新增可选 `companyId` 过滤参数(照现有 `groupId` 过滤的写法 `:56-57`),不加默认过滤。
同时 `ensureRecordAccess:177-193` 里的 `!isManualRecord(entity) → 403` 分支要一并重做:判据从"是不是手工"换成"是不是本公司 + 本组",否则非超管看得到却改不了。
### 7.2 去重库 `applyGroupScope:1212-1232`
在现有条件外面**叠一层 `company_id`**,不替换 group 逻辑:
- 非超管:`company_id = 本公司 AND (group_id IN 可访问组 OR (group_id IS NULL AND uploader_user_id IN 可见用户))`
- 超管:可选 `companyId` 过滤
列表与导出共用同一个 wrapper(`selectCount` `:193`、`buildExportQuery:404-425`),改一处即覆盖两端——**但要逐条确认导出路径真的经过了 `applyGroupScope`**(`:423` 显示经过)。
### 7.3 分组删除保护
`invalidasin/service/GroupDeletionGuard.java:22` 与 `dedupe/service/GroupDeletionGuard.java:21-27` 都按 `group_id` 统计。本方案不改 group 语义 ⇒ 这两个类**不动**,但去重库那个已知的漏判(`group_id IS NULL` 的 uploader 行统计不到)要单独立项,**不在本方案里顺手改**。
---
## 8. 消费侧改造(隔离真正生效的地方)
`selectExistingDataValues` 的裸 SQL 有 **4 个**生产消费方,且存在一份**绕过 service 的平行实现**——这是本方案最容易漏改的地方:
| # | 位置 | 用途 | 拿得到 company 吗 |
|---|---|---|---|
| 1 | `CollectDataBatchQuery.java:58` | 采集结果按去重库过滤 | ✅ 调用点 `CollectDataService.java:835`(同方法 `:810` 已有 task)、`CollectDataBrandRecheckInjector.java:125`(`:78` 形参带 task) |
| 2 | `CollectDataBatchQuery.java:75-78` | 采集结果按品牌库过滤 | 同上 |
| 3 | `DedupeTotalDataService.java:472`(`findExistingComparableValues:457`)← 导入时判重(调用点 `:902`) | 决定哪些行不入库 | ✅ operatorId 在作用域 |
| 4 | 同 3 ← `DedupeRunService.java:749` | **去重任务运行时判重,决定哪些行被去掉** | ✅ 任务 `userId`(`:155`) |
改造:
- `CollectDataBatchQuery.filter(rows)` → `filter(rows, Long companyId)`,两条查询各加 `company_id` 条件。`filterByExistingAsin:41` 生产零调用(仅测试)⇒ **直接删**,别留第二个入口。
- `findExistingComparableValues(Collection<String>)` → 加 `companyId` 形参,两个调用点各传自己的公司。
- 消费侧与 §6 的写侧必须**同一批上线**:只改读不改写 ⇒ 新行 `company_id` 全落 DEFAULT 1,别的公司读不到自己刚写的东西,比现状更糟。
**业务后果(必须提前告知,不能上线后解释)**:真有多家公司时,每家只按自己的库过滤 ⇒ 被过滤行数下降、交付行数上升、下游 LLM 与代理调用量上升(代理按提取次数计费,见成本基线)。今天只有 1 家公司 ⇒ 上线时零变化,所以**不能拿"上线后没变化"当验收通过**,验收要用 §10 的护栏。
---
## 9. 前端(`admin-frontend-vue`,别和用户端 `frontend-vue` 混)
两页对称处理:`pages/asin/AsinInvalidPage.vue`(品牌数据库)、`pages/asin/DedupeRegistryPage.vue` + `dedupe-total-*.ts`(去重数据汇总)。
1. 新增「公司」列与筛选下拉,**仅超管可见**,照现有「分组」列的 `v-if="isSuperAdmin"` 模式(`DedupeRegistryPage.vue:335-340,377,390`)。
2. 非超管:不显示公司列(它的公司是固定的,显示无意义),**也不许在请求里传 `companyId`** —— 后端一律按会话裁剪,前端传了要忽略。
3. 超管的「新增/导入」弹窗要能选公司,且选了公司之后分组下拉要收窄到该公司下的组(否则会出现"公司 A + 只有 B 公司才有的分组"这种组合)。
4. 品牌库页的「分组」列在批次 1 之后仍会大量显示"未分组"(历史行),**这是预期的**,文案要写清"未分组 = 该行为历史自动导入数据,无归属",不要让人以为改造没生效。
---
## 10. 护栏用例与变异自证
按"护栏做进代码出口、不写进注释"的既定要求,四支:
1. **迁移审计用例**(照 `CompanyMigrationV143Test` 12 例惯例):V145 幂等性、回填后 NULL 残留为 0、新唯一键字段组合逐字匹配、旧唯一键确已删除、`DEFAULT` 存在(混合窗口要求)与"摘 DEFAULT 的倒计时哨兵已登记"配对断言。
2. **写出口扫描用例**:全仓扫 `INSERT INTO biz_invalid_asin_data` / `INSERT INTO biz_dedupe_total_data` 的 SQL 字面量,列清单**必须含 `company_id`**;扫两个 Entity 的 `setCompanyId` 在每个写方法里都被调用。以后新增写入口漏带归属会红,而不是静默落公司 1。
3. **消费侧扫描用例**:`selectExistingDataValues` 的 SQL 必须含 `company_id`;`CollectDataBatchQuery` 的两条查询必须含 `company_id`;并断言 `filterByExistingAsin` 已不存在(防止有人把它当兼容入口复活,造成一条无租户条件的旁路)。
4. **读侧用例**:非超管列表条件不得再出现 `record_source='MANUAL'`;`company_id` 过滤在超管/非超管两分支的有无。
**变异自证**(每条护栏各配注入点,全红才算数):把 §5 的回填 WHERE 去掉 / 从 INSERT 列清单删掉 `company_id` / 把消费查询的租户条件注释掉 / 把 `filterByExistingAsin` 加回来。遵守既有硬规矩:每轮开跑前所有被注入文件写回 pristine(还原只认注入前读进内存的字节,**不许 `git checkout`**)、CRLF 锚串先对齐行尾、分母只认本轮扫描结果。
---
## 11. 分批、上线顺序与失败模式
### 11.1 三批
| 批 | 内容 | 线上行为 |
|---|---|---|
| **1** | V145(加列 + 回填 + 唯一键替换)+ 写侧带 `company_id`/`uploader_user_id` + `CompanyScopeSupport` + 护栏 1/2 | **零变化**(1 家公司;唯一键放宽) |
| **2** | 消费侧带租户条件(§8,4 个消费方) | 零变化(1 家公司),但这是隔离真正生效的一批 |
| **3** | 读侧放开 `MANUAL` 硬条件(§7.1)+ 前端公司列 | 非超管开始看到**本组的新自动导入行** |
批次 1 单独有价值(开始记归属),可以先到这儿停住等第二家公司。**批次 2、3 不要拆开各自排期**——2 改了读侧不改,会出现"写带公司、读不带"的半套状态。
### 11.2 混合版本窗口:`DEFAULT 1` 是必需的,且失败很安静
Flyway 在应用启动期执行 ⇒ 第一台已改表、第二台仍是旧 jar(一期实测该窗口约 15 分钟)。旧 jar 的 `insertBatchIgnore` 列清单不含 `company_id`,若该列 `NOT NULL` 且无默认值,严格模式下报 `Field 'company_id' doesn't have a default value`。
**这个错误会被吞掉**:`CollectDataInvalidAsinBatchWriter.java:58-60` 对批量写失败只 `catch (RuntimeException) → log.warn` 后跳过整批。⇒ **结果是自动导入静默丢数据,接口仍返回成功**。所以:
- V145 必须带 `DEFAULT 1`(与一期 `users.company_id` 同构的理由);
- 批次 1 的验收**不能只看"两台没报错"**,必须实查新增行的 `company_id` 与 `uploader_user_id` 非默认、非 NULL(§11.5)。
### 11.3 发布顺序
两台 jar 必须同版,且批次 2 含新端点/新参数语义 ⇒ 金丝雀过了立刻补第二台,缩短 §11.2 窗口。逐节点复验**不能打 `0.0.0.0:18080`**(那是 nginx 轮询池),主机 B 的 java 在 `127.0.0.1:19080`。
### 11.4 摘 `DEFAULT` 的倒计时
`company_id DEFAULT 1` 的生命周期到**第二家公司开通为止**——此后任何漏传都会静默把数据落到厦门米椿花。到期动作:单独迁移摘掉(照 `V144` 对 `users.company_id` 的做法),并在 §10 护栏 1 里登记成"哨兵 + 倒计时"而不是注释。
### 11.5 上线时必须人工实跑的清单
1. 生产两表**行数**(回填耗时与锁风险评估输入,§5.4 现在还是空的);
2. V145 末尾验证 SQL 全跑一遍;
3. 批次 1 后 30 分钟内新增的品牌库行:`uploader_user_id IS NOT NULL` 且**等于产生它的那个 task 的 `user_id`**(该列无 DEFAULT,NULL 就直接证明写侧没传)。
**一条必须承认的盲区**:`company_id` 这一列在只有 1 家公司时,**无法从数据本身区分"写侧显式传了"还是"被 DEFAULT 1 兜住了"**——两种情况的落库结果逐字节相同。所以不许把"company_id 都有值"当验收通过;这一条只能靠 §10.2 的源码护栏加下面第 4 条的实验来证。
4. 批次 2 后:同一 ASIN 用两个不同 `company_id` 各插一次,第二条**必须成功**(证唯一键真的放宽了),验完删掉测试行。
---
## 12. 明确不做(YAGNI)
- 不给其余 55 张业务表加 `company_id`(破例只限这两张)。
- 不动 89 处数据出口、不做跨公司汇总/对比报表。
- 不改 `group_id` 的语义,不拿它当租户键。
- 不顺手修去重库 `GroupDeletionGuard` 的 NULL 行漏判(单独立项)。
- 不在本方案里实现阶段B 设备令牌——但它是本方案"隔离完成"的判定条件(§3.2)。
- 不给品牌库历史行做"猜测式回填"(没有 uploader 列,猜不出来;全填 1 与今天事实一致)。
---
## 13. 待确认(开工前要答复)
1. **§3.2 的接受度**:确认"阶段B 之前这两张表的隔离是部分强度(防不住伪造 `user_id`)"这个定性可以被接受,且阶段B 工单会把 `/api/collect-data` 收口列为本方案的完成条件。
2. **§7.1 的可见性口径**:非超管看得到"本组的自动导入行"、看不到"历史无组行"——这个切法是否就是你要的?(另一种是"本公司全部可见",那会让 15 个 admin 账号立刻看到全部历史自动导入行。)
3. **§8 的成本后果**:多家公司后交付行数上升 → LLM/代理费用上升,是否已与业务对齐。
4. **批次 1 是否单独排期先上**:它是唯一有时间敏感性的部分(第二家公司一开,归属就永久补不回来了)。
+719
View File
@@ -0,0 +1,719 @@
# 客户端任务管理(后台看板)实现计划
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 后台新增「客户端任务管理」页面(两页签:客户端任务 / 变体采集),管理员按组查看每台客户端的任务执行情况,超管可看全部。
**Architecture:** 新模块包 `modules/taskcenter/`(1 controller + 2 service + 1 mapper + VO),任务列表 = `biz_file_task`(12 客户端模块)与 `brand_crawl_tasks`(BRAND)UNION 合并;设备号在 13 个创建入口以方法参数从 JWT 注入并落库(V138 加列);权限复用菜单授权 + 组范围裁剪;前端新页面 `task-center/board` 走现有 admin 注册表。
**Tech Stack:** Java 21 / Spring Boot 3.3.9 / MyBatis-Plus(`@Select` 注解 SQL)/ Flyway;Vue 3 + TS + Element Plus + vitest;麦象 Flask(FastAPI)`maixiang_task_api`。
**Spec:** `crawler-plugin/docs/specs/16-client-task-console.md`
## Global Constraints
- Flyway 只能新增 `V138__*.sql`;历史迁移一字不改;`backend-java/docs/migration-inventory.md` 必须同步(`MigrationInventoryTest` 断言文档含 "V138")。
- 菜单/权限复用现有机制(`columns` + `user_column_permission`),不新建权限体系。
- device_id 只认 JWT 签名 claim(`AdminAuthSupport.currentDeviceId`),**绝不接受客户端可控的请求头/请求体**。
- 生产红线(记忆):生产写操作只交付命令不自行执行;发布前跑三条取证;只 `git add` 自己的文件。
- Java 测试 JUnit5 + Mockito(`@ExtendWith(MockitoExtension.class)`);命令 `cd backend-java && mvn -o test -Dtest=XxxTest`。
- 每个接口的鉴权三步:`requireAdminOrInternal` → `requireClientTaskCenterAccess` → `resolveAccessScope` 裁剪。
---
### Task 1: V138 迁移(device_id 两列 + 菜单行)+ 迁移盘点同步
**Files:**
- Create: `backend-java/src/main/resources/db/V138__client_task_console.sql`
- Modify: `backend-java/docs/migration-inventory.md`
- Test: `backend-java/src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java`(既有,跑通即可)
**Interfaces:**
- Produces: `biz_file_task.device_id` / `brand_crawl_tasks.device_id`(`VARCHAR(128) NULL`);菜单行 `column_key='admin_task_center'`。
**Steps:**
- [ ] **Step 1: 写迁移文件**(幂等,对齐 V130/V127 写法)
```sql
-- V138: 客户端任务管理(后台看板)——任务记录设备号 + 菜单
--
-- 设备号取自 JWT 签名的 deviceId claim(AdminAuthSupport.currentDeviceId),
-- 由各模块创建入口显式落库;历史任务为 NULL(列表显示「未记录」,不回填)。
-- 品牌检测任务自建 brand_crawl_tasks 表,同样补列。
--
-- 幂等:列/索引/菜单行均仅当不存在时创建。回滚:DROP 两列与索引 + DELETE 菜单行(见文件尾注释)。
SET @db_name = DATABASE();
SET @col_exists := (SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'biz_file_task' AND COLUMN_NAME = 'device_id');
SET @sql := IF(@col_exists = 0,
'ALTER TABLE biz_file_task ADD COLUMN device_id VARCHAR(128) NULL COMMENT ''device from signed JWT deviceId claim'' AFTER user_id',
'SELECT 1');
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
SET @idx_exists := (SELECT COUNT(*) FROM information_schema.STATISTICS
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'biz_file_task' AND INDEX_NAME = 'idx_file_task_device_created');
SET @sql := IF(@idx_exists = 0,
'ALTER TABLE biz_file_task ADD KEY idx_file_task_device_created (device_id, created_at)',
'SELECT 1');
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
SET @col_exists := (SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'brand_crawl_tasks' AND COLUMN_NAME = 'device_id');
SET @sql := IF(@col_exists = 0,
'ALTER TABLE brand_crawl_tasks ADD COLUMN device_id VARCHAR(128) NULL COMMENT ''device from signed JWT deviceId claim'' AFTER user_id',
'SELECT 1');
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
-- 菜单:客户端任务管理(挂「记录与版本」分组下;仅插 columns,不写 user_column_permission
-- —— 管理员默认不可见,超管在「用户管理 → 菜单权限」授权后可见)
INSERT INTO columns (name, column_key, menu_type, route_path, sort_order, parent_id)
SELECT '客户端任务管理', 'admin_task_center', 'admin', 'task-center/board', 84, parent.id
FROM columns parent
WHERE parent.column_key = 'admin_group_record'
AND NOT EXISTS (SELECT 1 FROM columns WHERE column_key = 'admin_task_center');
-- 回滚(手工):
-- ALTER TABLE biz_file_task DROP KEY idx_file_task_device_created, DROP COLUMN device_id;
-- ALTER TABLE brand_crawl_tasks DROP COLUMN device_id;
-- DELETE FROM columns WHERE column_key='admin_task_center';
```
- [ ] **Step 2: 跑迁移盘点测试确认变红**(文档还没写 V138)
Run: `cd backend-java && mvn -o test -Dtest=MigrationInventoryTest`
Expected: FAIL —— `inventoryDocCommittedAndConsistent` 断言「文档应记录最新版本 V138」
- [ ] **Step 3: 同步盘点文档**
`backend-java/docs/migration-inventory.md` 更新:文件数 136→137;范围 `V1..V137`→`V1..V138`;
最新版本→`V138__client_task_console.sql`;快照日期→2026-09-28。
- [ ] **Step 4: 再跑,确认全绿**
Run: `cd backend-java && mvn -o test -Dtest=MigrationInventoryTest`
Expected: PASS
- [ ] **Step 5: Commit**
```bash
git add backend-java/src/main/resources/db/V138__client_task_console.sql backend-java/docs/migration-inventory.md
git commit -m "feat(taskcenter): V138 任务设备号列与客户端任务管理菜单"
```
---
### Task 2: 13 个创建入口记录 device_id + 续跑继承
**Files:**
- Modify: `common/security/AdminAuthSupport.java`(加静态 `normalizeDeviceId`)
- Modify: `modules/task/model/entity/FileTaskEntity.java`(加 `deviceId` 字段)
- Modify(每模块:controller 1 行 + service 签名/落库):
- `modules/publish/`(PublishController:46、PublishTaskService.parseAndCreateTask)
- `modules/deletebrand/`(DeleteBrandRunController:59、DeleteBrandRunService.run)
- `modules/productrisk/`(ProductRiskResolveController:139、ProductRiskTaskService.createTask:523)
- `modules/pricetrack/`(PriceTrackController:192、PriceTrackTaskService.createTask:504)
- `modules/shopmatch/`(ShopMatchController:133、ShopMatchTaskService.createTask:441)
- `modules/patroldelete/`(PatrolDeleteController:234、PatrolDeleteTaskService.createTask:282)
- `modules/queryasin/`(QueryAsinTaskController:195、QueryAsinTaskService.createTask:282)
- `modules/withdraw/`(WithdrawTaskController:130、WithdrawTaskService.createTask:169)
- `modules/appearancepatent/`(AppearancePatentController:52、AppearancePatentTaskService.parseAndCreateTask:152)
- `modules/similarasin/`(SimilarAsinController:86、SimilarAsinTaskService.parseAndCreateTask:386)
- `modules/collectdata/`(CollectDataController:46、CollectDataService.parseAndCreateTask:242)
- `modules/shopdatacrawl/`(ShopDataCrawlTaskController:178、ShopDataCrawlTaskService.createTask:552)
- `modules/brand/`(BrandTaskController:64+75、BrandTaskService.createTask:143 / createTaskAndBuildPayload:172)
- Modify: `modules/task/service/TaskResumeService.java:184`(`buildResumeTask` 继承 `original.getDeviceId()`)
- Test: 每模块既有 service 测试补一条 deviceId 落库断言(如 `SimilarAsinTaskServiceParsePreviewTest`)
**Interfaces:**
- Produces: `AdminAuthSupport.normalizeDeviceId(String) → String|null`;service 创建方法新签名统一为 `xxx(request, String deviceId)`(brand 为 `createTask(Long userId, BrandTaskCreateRequest request, String deviceId)`)。
**Steps:**
- [ ] **Step 1: 写失败测试(先取一个模块:similarasin)**
在 `SimilarAsinTaskServiceParsePreviewTest` 加:
```java
@Test
void parseAndCreateTask_recordsSignedDeviceId() {
// mock 既有的 parse 前置(沿用本类既有 setup)
service.parseAndCreateTask(request, "device-abc");
ArgumentCaptor<FileTaskEntity> captor = ArgumentCaptor.forClass(FileTaskEntity.class);
verify(fileTaskMapper).insert(captor.capture());
assertEquals("device-abc", captor.getValue().getDeviceId());
}
@Test
void parseAndCreateTask_blankDeviceIdStoredAsNull() {
service.parseAndCreateTask(request, " ");
ArgumentCaptor<FileTaskEntity> captor = ArgumentCaptor.forClass(FileTaskEntity.class);
verify(fileTaskMapper).insert(captor.capture());
assertNull(captor.getValue().getDeviceId());
}
```
- [ ] **Step 2: 跑测试确认失败**(编译失败:方法不存在 / getter 不存在)
Run: `cd backend-java && mvn -o test -Dtest=SimilarAsinTaskServiceParsePreviewTest`
Expected: FAIL(compile error `cannot find symbol: method parseAndCreateTask(args, String)`)
- [ ] **Step 3: 实现**
`AdminAuthSupport` 加:
```java
/** 归一化设备标识:空白 → null(未记录);否则 trim 后原样。 */
public static String normalizeDeviceId(String deviceId) {
return deviceId == null || deviceId.isBlank() ? null : deviceId.trim();
}
```
`FileTaskEntity` 加:
```java
/** 创建任务的客户端设备(JWT 签名 deviceId claim);历史任务为 null。 */
private String deviceId;
```
每个 service 创建方法:签名加尾参 `String deviceId`,insert 前加
`task.setDeviceId(AdminAuthSupport.normalizeDeviceId(deviceId));`
每个 controller 调用点:注入 `AdminAuthSupport`(多数已有),
`service.createTask(request, adminAuthSupport.currentDeviceId(request))`;
brand 两处 `brandTaskService.createTaskAndBuildPayload(userId, request, adminAuthSupport.currentDeviceId(request))`。
`TaskResumeService.buildResumeTask` 加:`resume.setDeviceId(original.getDeviceId());`
- [ ] **Step 4: 跑 similarasin 测试确认通过**
Run: `cd backend-java && mvn -o test -Dtest=SimilarAsinTaskServiceParsePreviewTest`
Expected: PASS
- [ ] **Step 5: 其余 12 模块同模式补齐(含测试断言)**
每模块一条 `xxx_recordsSignedDeviceId` 断言(captor 捕获 entity 断言 deviceId)。
既有测试调用点补第二参数(用 `""` 或 `"dev-1"`)。
- [ ] **Step 6: 全量编译 + 相关测试**
Run: `cd backend-java && mvn -o test -Dtest='*TaskServiceTest,*Parse*Test,ShopDataCrawlOwnerColumnTest,TaskResumeServiceTest,Brand*Test'`
Expected: PASS(无编译错误,设备断言全绿)
- [ ] **Step 7: Commit**
```bash
git add backend-java/src/main/java/com/nanri/aiimage/common/security/AdminAuthSupport.java \
backend-java/src/main/java/com/nanri/aiimage/modules/{publish,deletebrand,productrisk,pricetrack,shopmatch,patroldelete,queryasin,withdraw,appearancepatent,similarasin,collectdata,shopdatacrawl,brand} \
backend-java/src/main/java/com/nanri/aiimage/modules/task
git commit -m "feat(taskcenter): 13 个客户端任务创建入口记录 JWT 设备号"
```
---
### Task 3: taskcenter 模块骨架 + 权限 + 组裁剪 + overview 接口
**Files:**
- Create: `modules/taskcenter/controller/AdminTaskCenterController.java`
- Create: `modules/taskcenter/service/TaskCenterScopeService.java`
- Create: `modules/taskcenter/service/TaskCenterQueryService.java`
- Create: `modules/taskcenter/mapper/TaskCenterQueryMapper.java`
- Create: `modules/taskcenter/model/vo/TaskCenterOverviewVo.java`
- Modify: `modules/permission/service/PermissionMenuService.java`(加 `requireClientTaskCenterAccess`)
- Test: Create: `backend-java/src/test/java/com/nanri/aiimage/modules/taskcenter/service/TaskCenterScopeServiceTest.java`
**Interfaces:**
- Produces:
- `record ScopeContext(boolean allUsers, Set<Long> visibleUserIds)`;`TaskCenterScopeService.resolve(Long operatorId)`
- `PermissionMenuService.requireClientTaskCenterAccess(AdminUserEntity operator)`(403 或放行)
- `GET /api/admin/task-center/overview` → `{deviceTotal, deviceOnline, runningTasks, todayFinishedTasks, stuckTasks}`
**Steps:**
- [ ] **Step 1: 写失败测试**
```java
@ExtendWith(MockitoExtension.class)
class TaskCenterScopeServiceTest {
@Mock AdminUserMapper adminUserMapper;
@Mock ShopManageGroupMapper shopManageGroupMapper;
@Spy @InjectMocks TaskCenterScopeService service;
@Test
void superAdminSeesAll() { /* role=super_admin → allUsers=true, visibleUserIds 空 */ }
@Test
void adminGetsSelfPlusGroupUsersPlusManaged() {
// 组 [7,8] → users [11,12];managed [13];本人 5 → visible={5,11,12,13}
}
@Test
void adminWithNoGroupHasOnlySelf() { /* visible={本人},不越权 */ }
}
```
Run: `cd backend-java && mvn -o test -Dtest=TaskCenterScopeServiceTest` → FAIL
- [ ] **Step 2: 实现 scope service**
`TaskCenterScopeService.resolve(Long operatorId)`:照抄 `DedupeTotalDataService.resolveAccessScope:1179-1205`
(`getOperator` → `isSuperAdmin`(`DeviceSessionPolicy.resolveRole`)→ `selectAccessibleGroupIds` +
`selectUserIdsByGroupIds` + `selectManagedMemberUserIds`,LinkedHashSet 去重)。
- [ ] **Step 3: 权限方法**
`PermissionMenuService` 加(口径照抄 `requireShopDataCrawlTaskAccess:462`):
```java
/** 「客户端任务管理」菜单访问检查;超管直通。 */
public void requireClientTaskCenterAccess(AdminUserEntity operator) {
ensureAdminOperatorIfPresent(operator);
if (operator == null || operator.getId() == null || operator.getId() <= 0) {
throw new BusinessException(403, "需要管理员权限");
}
if (isSuperAdmin(operator)) {
return;
}
PermissionMenuEntity menu = requireDataPermission("admin_task_center", "客户端任务管理菜单");
if (!hasEffectiveColumnPermission(operator.getId(), menu.getId())) {
throw new BusinessException(403, "无权查看客户端任务管理");
}
}
```
- [ ] **Step 4: controller + overview 查询**
`AdminTaskCenterController`(`@RequestMapping("/api/admin/task-center")`)私有方法
`resolveOperator(request)` = `requireAdminOrInternal` + `requireClientTaskCenterAccess`;
overview = `TaskCenterQueryService.overview(scope)`:
- runningTasks / stuckTasks / todayFinishedTasks:3 条 count SQL(mapper)
- deviceTotal / deviceOnline:复用 Task 4 的设备查询(本任务先返回 0,Task 4 接线)
- [ ] **Step 5: 跑测试 + 手动 curl 契约(本地)**
Run: `cd backend-java && mvn -o test -Dtest=TaskCenterScopeServiceTest`
Expected: PASS
- [ ] **Step 6: Commit**
```bash
git add backend-java/src/main/java/com/nanri/aiimage/modules/taskcenter backend-java/src/main/java/com/nanri/aiimage/modules/permission/service/PermissionMenuService.java backend-java/src/test/java/com/nanri/aiimage/modules/taskcenter
git commit -m "feat(taskcenter): 模块骨架 + 菜单权限 + 组范围裁剪 + overview"
```
---
### Task 4: devices 接口(设备花名册)
**Files:**
- Modify: `modules/taskcenter/mapper/TaskCenterQueryMapper.java`(加 4 条 @Select)
- Modify: `modules/taskcenter/service/TaskCenterQueryService.java`(`devices(scope)` + overview 接线)
- Create: `modules/taskcenter/model/vo/TaskCenterDeviceVo.java`
- Test: `TaskCenterQueryServiceTest`(Mockito mock mapper,断言 Java 侧合并逻辑)
**Interfaces:**
- Produces: `GET /api/admin/task-center/devices` → `List<{deviceId,deviceName,lastActiveAt,online,runningTasks,recentTaskAt}>`
**Steps:**
- [ ] **Step 1: 写失败测试**
```java
@Test void mergeDeviceRoster_taskDeviceAndLogDeviceUnion() { /* 任务设备 + 日志设备并集;同名取日志名 */ }
@Test void onlineThreshold_isFiveMinutes() { /* lastActive 4:59 → online=true;5:01 → false */ }
@Test void blankDeviceIdExcluded() { /* '' / null 不参与 */ }
```
Run: `mvn -o test -Dtest=TaskCenterQueryServiceTest` → FAIL
- [ ] **Step 2: mapper SQL**
```sql
-- 任务设备(近 30 天创建过任务)
SELECT device_id, MAX(updated_at) AS last_active FROM biz_file_task
WHERE device_id IS NOT NULL AND device_id <> '' AND created_at >= #{since} AND user_id IN (...)
GROUP BY device_id
-- 品牌设备同理(brand_crawl_tasks);运行中任务数(两表各一条,status IN 参数化)
-- 日志设备(近 7 天上报)
SELECT device_id, MAX(device_name) AS device_name, MAX(last_upload_at) AS last_upload_at
FROM device_log_file
WHERE source='client' AND last_upload_at >= #{since7} AND uid IN (...)
GROUP BY device_id
```
Java 侧:并集 → 在线 = max(last_upload_at, last_active) ≥ now-5min → 排序(在线优先、名称)。
`web-` 前缀单独标注 `webDevice=true`(前端显示「网页」,不参与设备总数?——参与,但命名区分;总数含网页登录标记的过滤由前端展示层决定,本任务接口照常返回)。
- [ ] **Step 3: overview 的 deviceTotal/deviceOnline 从本查询派生**
- [ ] **Step 4: 跑测试**
Run: `mvn -o test -Dtest=TaskCenterQueryServiceTest` → PASS
- [ ] **Step 5: Commit**
```bash
git add backend-java/src/main/java/com/nanri/aiimage/modules/taskcenter backend-java/src/test/java/com/nanri/aiimage/modules/taskcenter
git commit -m "feat(taskcenter): 设备花名册与在线判定"
```
---
### Task 5: tasks 列表接口(两表 UNION + 筛选 + 店铺/进度装配)
**Files:**
- Modify: `modules/taskcenter/mapper/TaskCenterQueryMapper.java`
- Modify: `modules/taskcenter/service/TaskCenterQueryService.java`
- Create: `modules/taskcenter/model/vo/TaskCenterTaskRowVo.java`、`TaskCenterTaskPageVo.java`
- Test: `TaskCenterQueryServiceTest`
**Interfaces:**
- Produces: `GET /api/admin/task-center/tasks?page&pageSize&username&moduleType&status&deviceId&shop&startTime&endTime`
→ `{items:[TaskCenterTaskRowVo], total, page, pageSize}`
- `TaskCenterTaskRowVo`: `id, taskNo, moduleType, moduleLabel, status, userId, username, deviceId, deviceName, webDevice, shopName, shopCount, createdAt, finishedAt, progressTotal, progressSuccess, progressFailed, currentScope, message, stuck`
**Steps:**
- [ ] **Step 1: 写失败测试(Java 侧装配逻辑)**
```java
@Test void usernameFilterResolvesToUserIdsIntersectVisible(); // users LIKE → ∩ visible;空集 → 空页
@Test void shopFilterExistsClauseIncluded(); // captor 检查 wrapper/参数传递
@Test void stuckFlag_boundary(); // RUNNING 9:59min → false;10:01 → true
@Test void progressFallback_snapshotThenFileCount(); // 快照优先;无快照用文件计数
@Test void moduleLabelUsesRegistry(); // labels() 中文名;BRAND 大写
```
Run: `mvn -o test -Dtest=TaskCenterQueryServiceTest` → FAIL
- [ ] **Step 2: mapper SQL(UNION 主体 + count)**
```sql
SELECT * FROM (
SELECT t.id, t.task_no, t.module_type, t.status, t.user_id, t.device_id,
t.created_at, t.finished_at, t.updated_at,
t.source_file_count AS total_cnt, t.success_file_count AS success_cnt, t.failed_file_count AS failed_cnt,
0 AS is_brand
FROM biz_file_task t
WHERE t.module_type IN (12 个客户端模块)
<if> AND t.user_id IN (...) </if> <if> AND t.module_type = #{moduleType} </if>
<if> AND UPPER(t.status) = #{status} </if> <if> AND t.device_id = #{deviceId} </if>
<if> AND t.created_at >= #{startTime} </if> <if> AND t.created_at <= #{endTime} </if>
<if test="shop != null">
AND ( EXISTS (SELECT 1 FROM biz_publish_file p WHERE p.task_id=t.id AND p.shop_name LIKE CONCAT('%',#{shop},'%'))
OR EXISTS (SELECT 1 FROM biz_task_result_item i WHERE i.task_id=t.id AND i.scope_key LIKE CONCAT('%',#{shop},'%'))
OR EXISTS (SELECT 1 FROM biz_file_result f WHERE f.task_id=t.id AND f.source_filename LIKE CONCAT('%',#{shop},'%'))
OR EXISTS (SELECT 1 FROM biz_task_progress_snapshot s WHERE s.task_id=t.id AND s.current_scope_key LIKE CONCAT('%',#{shop},'%')) )
</if>
UNION ALL
SELECT b.id, CONCAT('brand-', b.id), 'BRAND', UPPER(b.status), b.user_id, b.device_id,
b.created_at,
CASE WHEN b.status IN ('success','failed','cancelled') THEN b.updated_at END,
b.updated_at,
b.progress_total, b.progress_current, 0, 1
FROM brand_crawl_tasks b
WHERE 1=1
<if> 同款过滤(moduleType 非 BRAND 时该分支恒空) </if>
) m
ORDER BY m.created_at DESC, m.id DESC
LIMIT #{limit} OFFSET #{offset}
```
count 同结构(`SELECT (SELECT COUNT(*) ...) + (SELECT COUNT(*) ...) AS total`)。
- [ ] **Step 3: service 装配**
- username → `SELECT id FROM users WHERE username LIKE` → 与 visible 求交;空 → 直接空页
- 当页行批量装配:username(users IN)、deviceName(Task 4 设备名映射)、shop(3 表批量 GROUP_CONCAT:
`SELECT task_id, GROUP_CONCAT(DISTINCT shop) FROM ... WHERE task_id IN (...) GROUP BY task_id`)、
progress(快照 `task_id IN (...)` 批量;缺的行用行内文件计数)、stuck(RUNNING && updated_at < now-10min)
- status 输出已大写(brand 分支 UPPER)
- [ ] **Step 4: 跑测试**
Run: `mvn -o test -Dtest=TaskCenterQueryServiceTest` → PASS
- [ ] **Step 5: Commit**
```bash
git add backend-java/src/main/java/com/nanri/aiimage/modules/taskcenter backend-java/src/test/java/com/nanri/aiimage/modules/taskcenter
git commit -m "feat(taskcenter): 两表 UNION 任务列表 + 筛选 + 店铺/进度装配"
```
---
### Task 6: tasks/detail 详情接口
**Files:**
- Modify: `modules/taskcenter/mapper/TaskCenterQueryMapper.java`、`service/TaskCenterQueryService.java`
- Create: `modules/taskcenter/model/vo/TaskCenterTaskDetailVo.java`
- Test: `TaskCenterQueryServiceTest`
**Interfaces:**
- Produces: `GET /api/admin/task-center/tasks/detail?taskNo=brand-12|PUBLISH-xxx`
→ `{...TaskCenterTaskRowVo 字段, shops:[{scopeKey,total,success,failed}], progress:{...}, errorMessage}`
**Steps:**
- [ ] **Step 1: 写失败测试**
```java
@Test void detailBrandPrefixRoutesToBrandTable(); // brand-12 → brand_crawl_tasks
@Test void detailOutOfScopeDenied(); // user_id 不在 visible → 空/403 语义(按空返回,前端提示)
@Test void detailShopsAggregatedFromResultItem(); // biz_task_result_item 按 scope_key 聚合
```
Run: `mvn -o test -Dtest=TaskCenterQueryServiceTest` → FAIL
- [ ] **Step 2: 实现**
按 `taskNo` 前缀分流:`brand-` → brand 表;否则 biz_file_task(user_id 必须 ∈ visible 或超管)。
shops:`SELECT scope_key, COUNT(*), SUM(status='SUCCESS') ... GROUP BY scope_key`(result_item)+ PUBLISH 走 publish_file GROUP BY shop_name。
progress:快照行 + 文件计数兜底(同 Task 5)。
- [ ] **Step 3: 跑测试 + Commit**
Run: `mvn -o test -Dtest=TaskCenterQueryServiceTest` → PASS
```bash
git add backend-java/src/main/java/com/nanri/aiimage/modules/taskcenter backend-java/src/test/java/com/nanri/aiimage/modules/taskcenter
git commit -m "feat(taskcenter): 任务详情接口"
```
---
### Task 7: variant-tasks 接口(麦象代理)+ MaixiangConsoleClient 扩展
**Files:**
- Modify: `modules/notification/client/MaixiangConsoleClient.java`(BatchTaskItem 加 resMes;加多 uid 分页方法)
- Create: `modules/taskcenter/service/TaskCenterVariantService.java`
- Modify: `modules/taskcenter/controller/AdminTaskCenterController.java`
- Test: `MaixiangConsoleClientTest`(既有测试类扩展)、`TaskCenterVariantServiceTest`
**Interfaces:**
- Produces: `GET /api/admin/task-center/variant-tasks?page&pageSize&status&taskType`
→ `{items:[{taskId,uid,username,status,resMes,taskData,createTime,updateTime}], total, page, pageSize}`
- `MaixiangConsoleClient.batchTasksPage(String uidsCsv, Integer status, String taskType, int page, int pageSize)`
**Steps:**
- [ ] **Step 1: 写失败测试**
```java
@Test void batchTasksPage_buildsUidCsvAndPaging(); // url 含 uid=a,b&page=2&page_size=15
@Test void parseBatchTaskPage_readsResMes(); // items[0].res_mes 解析进 record
@Test void variantService_mapsUidToUsername(); // uid → users.username;不可见 uid 不进结果
```
Run: `mvn -o test -Dtest='MaixiangConsoleClientTest,TaskCenterVariantServiceTest'` → FAIL
- [ ] **Step 2: 实现**
- `BatchTaskItem` 追加 `String resMes`(`node.path("res_mes").asText("")`;`task_data` 原样透传为 JsonNode→String)
- 新方法:`batchTasksPage` 走 `/api/console/batch/tasks`,参数 `uid`(逗号分隔,来自可见用户)、`status`(可空)、`task_type`(可空)、`page/page_size`
- service:可见用户 → uidsCsv;无可见用户直接空页;返回行 uid → username 映射
- 麦象不可达时返回空页 + 记日志(页面不炸)
- [ ] **Step 3: 跑测试 + Commit**
Run: `mvn -o test -Dtest='MaixiangConsoleClientTest,TaskCenterVariantServiceTest'` → PASS
```bash
git add backend-java/src/main/java/com/nanri/aiimage/modules/notification/client/MaixiangConsoleClient.java \
backend-java/src/main/java/com/nanri/aiimage/modules/taskcenter backend-java/src/test/java/com/nanri/aiimage
git commit -m "feat(taskcenter): 变体采集接口(麦象代理,多 uid + res_mes)"
```
---
### Task 8: 麦象侧 `/api/console/batch/tasks` 多 uid 与 res_mes
**Files:**
- Modify: `maixiang_run_task/maixiang_task_api/main.py`(`console_batch_tasks`)
- Test: `maixiang_run_task/tests/`(pytest,若目录不存在则新建 `test_console_batch_tasks.py`)
**Interfaces:**
- Produces(接口契约,Java 侧依赖):
- `uid=A,B` → `IN (A,B)`;缺省/单值语义不变
- items 增加 `res_mes`(str)与 `task_data`(原样)
**Steps:**
- [ ] **Step 1: 写失败测试**
```python
def test_multi_uid_filter(client, db): ... # uid=a,b 只返回 a/b 的任务
def test_single_uid_backward_compat(client, db): ...
def test_items_include_res_mes(client, db): ...
```
Run: `cd maixiang_run_task && python -m pytest maixiang_task_api/tests -k console_batch -q`(或既有测试路径)
Expected: FAIL
- [ ] **Step 2: 实现**
```python
if uid:
uid_list = [u.strip() for u in uid.split(",") if u.strip()]
if len(uid_list) == 1:
query = query.filter(AllTask.uid == uid_list[0])
elif uid_list:
query = query.filter(AllTask.uid.in_(uid_list))
...
items.append({
...既有字段...,
"res_mes": r.res_mes or "",
"task_data": r.task_data,
})
```
- [ ] **Step 3: 跑测试**
Run: `cd maixiang_run_task && python -m pytest maixiang_task_api/tests -k console_batch -q` → PASS
- [ ] **Step 4: Commit**(maixiang_run_task 是否同一 git 仓?否 —— 属工作区非 git 目录,
按发布脚本 `scripts/_deploy_maixiang_api.py` 部署;本地改动记录在提交信息里)
```bash
git add -A # 仅当 maixiang_run_task 在某个 git 仓内;否则跳过 commit,改动由发布脚本上传
```
---
### Task 9: 前端 api + 路由 + 页面骨架(页签/筛选/汇总卡/设备条)
**Files:**
- Create: `admin-frontend-vue/src/api/task-center.ts`
- Create: `admin-frontend-vue/src/pages/task-center/TaskCenterBoardPage.vue`
- Modify: `admin-frontend-vue/src/router/routes.ts`(adminPages 追加)
- Modify: `admin-frontend-vue/src/layout/operation-guides.ts`(补 `admin_task_center`)
- Test: `admin-frontend-vue/src/__tests__/`(或既有测试目录)新增 `TaskCenterBoardPage` 相关
**Interfaces:**
- Consumes: Task 3-7 的 5 个接口
- Produces: 页面路由 `task-center/board`(menuKey `admin_task_center`)
**Steps:**
- [ ] **Step 1: 写失败测试**(对齐既有 vitest 风格)
```ts
it('renders overview metrics after load', ...)
it('switches tab to variant list', ...)
```
Run: `cd admin-frontend-vue && npx vitest run TaskCenter` → FAIL
- [ ] **Step 2: api 文件**
照 `src/api/device-logs.ts` 模式(`http.get` + `unwrap`),导出 5 个函数 + TS 接口。
- [ ] **Step 3: 路由 + guides**
```ts
{ path: 'task-center/board', menuKey: 'admin_task_center', title: '客户端任务管理', load: () => import('@/pages/task-center/TaskCenterBoardPage.vue') },
```
guides:`admin_task_center: { text: '按账号和设备查看客户端任务执行情况;点击设备可筛选该设备任务,点任务查看明细。', steps: ['选择筛选条件', '查看设备与任务', '打开任务详情'] }`
- [ ] **Step 4: 页面骨架**
`TaskCenterBoardPage.vue`:`panel-box` + `.form-row` 筛选(账号输入、业务下拉=模块 labels、状态下拉、设备下拉、店铺输入、时间范围)+ 汇总卡(5 指标)+ 设备卡条 + `el-tabs`(客户端任务 / 变体采集)。
样式类复用 DeviceLogsPage 的全局样式(`btn/btn-ghost/form-row/panel-box`);进度用 CSS 条(无图表库)。
- [ ] **Step 5: 跑测试 + 既有门禁**
Run: `cd admin-frontend-vue && npx vitest run TaskCenter && npx vitest run align-operation-guide`
Expected: PASS(guides 对齐测试绿)
- [ ] **Step 6: Commit**
```bash
git add admin-frontend-vue/src/api/task-center.ts admin-frontend-vue/src/pages/task-center admin-frontend-vue/src/router/routes.ts admin-frontend-vue/src/layout/operation-guides.ts admin-frontend-vue/src/__tests__(相关文件)
git commit -m "feat(taskcenter): 前端页面骨架与接口层"
```
---
### Task 10: 前端任务表格 + 详情抽屉
**Files:**
- Modify: `TaskCenterBoardPage.vue`(+ 可选子组件 `components/`)
**Steps:**
- [ ] **Step 1: 写失败测试**:表格列渲染(账号/设备/店铺/业务/状态/起止/进度)、stuck 标记、点击行打开抽屉
- [ ] **Step 2: 实现**:`el-table` + `el-drawer`(对齐 `ImageVideoTasksPage.vue` 用法);
状态色彩映射沿用 tasks 域归一;设备列显示 `deviceName || 截断 deviceId`,`webDevice` 显示「网页」徽标;
进度列 `成功 X / 总 Y` + CSS 进度条 + 失败红色角标;`stuck` 显示「疑似卡住」黄标
- [ ] **Step 3: 跑测试** → PASS
- [ ] **Step 4: Commit**(同上文件)
---
### Task 11: 前端变体采集页签 + 轮询
**Files:**
- Modify: `TaskCenterBoardPage.vue`
**Steps:**
- [ ] **Step 1: 写失败测试**:变体表渲染 res_mes;30s 轮询在 `document.hidden` 时暂停、卸载清理
- [ ] **Step 2: 实现**:变体表格(账号、任务号、状态、开始/更新时间、进度文字)+ 手动刷新;
轮询用 `setInterval` + `visibilitychange` 监听(对齐既有页面惯例)
- [ ] **Step 3: 跑测试** → PASS
- [ ] **Step 4: Commit**
---
### Task 12: 前端单测补全 + 构建验证
**Files:**
- Test: `admin-frontend-vue/src/**/*.{spec,test}.ts`
**Steps:**
- [ ] **Step 1: 补边界测试**:空数据显示、筛选重置、分页切换、接口失败 toast
- [ ] **Step 2: 构建**
Run: `cd admin-frontend-vue && npx vue-tsc --noEmit && npm run build`(或项目既有 build 命令)
Expected: 无 TS 错误、构建成功
- [ ] **Step 3: Commit**
---
### Task 13: 集成验证 + 发布准备(只交付命令,不执行生产写操作)
**Steps:**
- [ ] **Step 1: 后端全量测试**
Run: `cd backend-java && mvn -o test`
Expected: 与基线一致(既有多路会话遗留红项须先甄别归属)
- [ ] **Step 2: 打包 + 产物自查**
Run: `mvn -o clean package -DskipTests`(约 2.5 分钟,162MB)
自查:python zipfile 读 `BOOT-INF/classes/application.yml` 与 V138 资源是否存在、新 class 是否在包内。
- [ ] **Step 3: 发布前三取证**(见记忆 java-backend-release-path)
1. 新默认值是否被 `application-server.yml`/env 覆盖(本次无新配置键,跳过项说明)
2. 线上跑到哪一笔:用 V138 后探针(`brand_crawl_tasks.device_id` 列存在性)
3. 在飞任务:`docker logs java-server --since 3m | grep -aoiE "appearance-patent|similar-asin"`
- [ ] **Step 4: 交付发布命令清单**(用户执行)
- 麦象:`python scripts/_deploy_maixiang_api.py`(先)
- Java:`GIT_TERMINAL_PROMPT=0 GCM_INTERACTIVE=never GCM_PROVIDER=basic git push origin master` → `python scripts/_deploy_jar_and_restart_both.py <本地jar>`
- 后台前端:`python scripts/_deploy_admin_vue.py`
- 回滚口径:jar 备份 `.bak-*`;前端上一版;菜单行删除。
---
## Self-Review 记录
- Spec 覆盖:13 模块设备记录(T2)、V138(T1)、5 接口(T3-T7)、麦象(T8)、前端(T9-T12)、权限/裁剪(T3)、店铺/进度/卡住口径(T4-T6)、发布(T13)✓
- 类型一致性:`ScopeContext`(T3)→ T4-T7 复用;`TaskCenterTaskRowVo`(T5)→ T6 详情复用;`BatchTaskItem.resMes`(T7)→ 麦象 items.res_mes(T8)契约一致 ✓
- 已知取舍:详情接口越权返回空(不 403),前端提示「任务不存在或无权限」;轮询周期 30s 固定(不做配置)。
+159
View File
@@ -0,0 +1,159 @@
# 品牌检测失败自动补测(requeue)实现计划
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 采集数据(COLLECT_DATA)任务里品牌检测"查询失败"的行(WIPO 限流/上游抖动期间),在任务收尾后由后端自动排队补测;补测出结论后把行自动补进结果文件(或判进无效品牌表),用户收到补测结果通知——替代现状"通知里让人手工重跑,且用户根本拿不到失败 ASIN 清单"。
**Background(2026-10-02 实证):** WIPO 全球商标库限流 10:00–21:00 持续 11 小时,两台 java `brand-check 重试耗尽` 共 2778 次(约 8 成 `query_faild_data 持续非空`,2 成 `header parser received no bytes`),当日 22 条「部分结果缺失」通知(单任务最高 111 行)。queryFailed 行按设计不进结果也不落无效品牌表(task-27265 教训:误杀不可逆),但现状除一条计数通知外无任何出口。客户端单品牌重试 10 次≈45s、批预算 90s,扛不过小时级限流窗口——补测把"重试"从同步调用里拆出来放到任务收尾之后。
**Architecture:** 分片回传时把 queryFailed 的品牌写进补测队列表 `biz_collectdata_brand_recheck`(task_id+brand 唯一,行数据不落表、注入时从既有 chunk 全量 payload 回读)。新调度器 `CollectDataBrandRecheckScheduler` 按 Redis 分布式锁轮询(复用 `NotificationScanScheduler` 的锁与节流写法):只处理任务已终态(SUCCESS/FAILED)且到 `next_attempt_at` 的条目,按批调既有 `BrandCheckClient.checkAll`;单轮失败率超阈值立即熔断整轮顺延。补测出结论后注入:accepted → 走 dedupe 复查(first-writer-wins)+ `resultItemBatchWriter.upsertAccepted` 落结果;rejected → `invalidAsinBatchWriter.writeBatch` 落无效品牌表;随后复用 `enqueueAssembleResult` 异步重建结果文件,并向用户推补测结果通知。指数退避 30m→16h 共 6 轮,覆盖 ≈31h 的限流窗口。
**Tech Stack:** Java 21 / Spring Boot 3.3.9 / MyBatis-Plus / Flyway;JUnit5 + Mockito。
**Spec:** 内嵌于本文「行为规格」一节(实现期如需可拆 `docs/specs/17-brand-check-requeue.md`)。
**复用清单(全部已存在,勿重写):**
| 能力 | 位置 |
|---|---|
| 品牌批量检测(含重试/预算) | `BrandCheckClient.checkAll`(`modules/brand/client/BrandCheckClient.java:96`) |
| chunk 全量行回读(RustFS 指针解析 + JSON 解码) | `CollectDataService.streamRawRows`(`CollectDataService.java:1215`),`transientPayloadStorageService.resolvePayload` |
| 去重/无效品牌过滤 | `CollectDataBatchQuery.filter`(`collectdata/util/CollectDataBatchQuery.java`) |
| 结果行落库(幂等 upsert,返回新增数) | `CollectDataResultItemBatchWriter.upsertAccepted`(`CollectDataResultItemBatchWriter.java:65`) |
| 结果明细对象编码 | `CollectDataResultDetailCodec.encodeChunk`(`CollectDataResultDetailCodec.java:87`) |
| 无效品牌落表 | `invalidAsinBatchWriter.writeBatch`(`CollectDataService.java:893` 用法) |
| 结果文件异步重建(幂等,重算 finalRowCount) | `TaskFileJobService.enqueueAssembleResult`(`TaskFileJobService.java:34`)→ `CollectDataService.processResultFileJob` |
| 品牌结论缓存写入 | `CollectDataService.writeAsinCacheOutsideLock`(`CollectDataService.java:840`) |
| 用户侧通知 | `NotificationDispatchService`(`pushPartialResult` 同款形态,`NotificationDispatchService.java:116`) |
| 定时轮询 + Redis 锁 | `NotificationScanScheduler`(`notification/service/NotificationScanScheduler.java:78-103`)写法 |
## Global Constraints
- Flyway 只能新增 `V140__*.sql`(V138/V139 已被占用);历史迁移一字不改;`backend-java/docs/migration-inventory.md` 同步(`MigrationInventoryTest` 会断言)。
- 生产红线(记忆):生产写操作只交付命令不自行执行;发布前跑三条取证;只 `git add` 自己的文件。
- 补测注入只允许发生在任务**终态**之后(SUCCESS/FAILED);RUNNING/PENDING 任务一律跳过本轮,避免与分片重提竞态。
- 注入必须幂等:同一 (task_id, brand) 的行重复补测不得产生重复结果行(靠 `uk_task_scope_item` upsert 的 payload_hash 跳过语义)。
- 新增开关默认开启但可用配置关闭(`aiimage.collect-data.brand-recheck.enabled`);首轮调度延迟 ≥30 分钟,绝不与任务收尾抢上游。
- Java 测试 JUnit5 + Mockito(`@ExtendWith(MockitoExtension.class)`);命令 `cd backend-java && mvn -o test -Dtest=XxxTest`。
- 范围 V1 只做 COLLECT_DATA;BRAND 模块的 queryFailedBrands 已有「查询失败品牌」Excel sheet 出口,不在本期。
## 行为规格(Spec)
1. **入队**:`submitResult` 锁外拿到 `brandOutcome.queryFailed()` 后,对每个失败品牌 `INSERT ... ON DUPLICATE KEY UPDATE`(唯一键 task_id+brand;重复失败不刷新首次时间、不改状态);`next_attempt_at = now + firstDelayMinutes`;只在条目当前为 PENDING 时写入。入队失败只记日志,绝不影响分片回传主流程。
2. **轮询**:调度器每 5 分钟一轮(与通知扫描同节拍),取 `status='PENDING' AND next_attempt_at<=now` 的条目,按 task 聚组、组内品牌批量检测。任务非终态或已删除 → 条目顺延(next_attempt_at += intervalBase,不计尝试次数)。
3. **熔断**:单轮内「仍查询失败」占比 > `failRateThreshold`(默认 0.5)且本轮已测 ≥3 个品牌时,中止本轮剩余条目并把本轮已测条目的 `attempt_count+1`、其余条目不动(下轮再试)。中止时记 warn 日志。
4. **退避与终态**:每次实测失败后 `next_attempt_at = now + intervalBase × 2^attempt`(30m→1h→2h→4h→8h→16h,封顶 16h);`attempt_count ≥ maxAttempts`(默认 6)→ 状态 `EXHAUSTED`,该 task 的 PENDING 条目全部出队后向用户推一条「补测未能完成」通知(当天聚合一次)。
5. **注入(某品牌检测出结论时)**:
- 全量扫该 task 的 chunk payload(复用 streamRawRows 逻辑),收集 brand 归一化等于该品牌的行;
- 行集过 `CollectDataBatchQuery.filter` 复查 dedupe/无效品牌(期间该 ASIN 可能已被其他任务采走 → first-writer-wins,被滤掉属预期);
- 结论无侵权命中 → 存 chunk 级明细对象(`encodeChunk`+`storeResultPayload`,key 用 `recheck-chunk-<n>` 防覆盖原 chunk 明细)后 `upsertAccepted` 进结果;结论有侵权命中(faild_data 非空)→ `invalidAsinBatchWriter.writeBatch`,行不进结果;
- 补测结论同样写入 ASIN 结论缓存(`writeAsinCacheOutsideLock` 同款),后续任务受益;
- 该 task 注入批结束后 `enqueueAssembleResult` 重建结果文件(worker 会重算并持久化 finalRowCount)。
6. **通知**:一轮注入产生实际变化(新增结果行 >0 或新判无效 >0)→ 推用户通知「任务 {taskNo} 品牌补测完成:新增结果 X 行、判定无效品牌 Y 行、仍失败 Z 行」;同一 task 同一自然日只推一条(dedupe_key 带自然日,复用 `pushOrRefresh`)。
7. **并发**:调度器全局单飞(Redis 锁);注入期间持任务分布式锁(`TaskDistributedLockService`),拿不到就整组顺延。
---
### Task 1: V140 迁移(补测队列表)+ 迁移盘点同步
**Files:**
- Create: `backend-java/src/main/resources/db/V140__collectdata_brand_recheck.sql`
- Modify: `backend-java/docs/migration-inventory.md`
**Interfaces:**
- Produces: 表 `biz_collectdata_brand_recheck`:`id BIGINT PK AI`、`task_id BIGINT NOT NULL`、`task_no VARCHAR(64)`、`user_id BIGINT NOT NULL`、`brand VARCHAR(255) NOT NULL`(归一化后)、`status VARCHAR(16) NOT NULL DEFAULT 'PENDING'`(PENDING/INJECTED/REJECTED/EXHAUSTED)、`attempt_count INT NOT NULL DEFAULT 0`、`last_error VARCHAR(500)`、`next_attempt_at DATETIME NOT NULL`、`created_at/updated_at DATETIME`;唯一键 `uk_recheck_task_brand(task_id, brand)`、索引 `idx_recheck_status_next(status, next_attempt_at)`。
**Steps:**
- [x] **Step 1:** 写迁移(幂等写法对齐 V138:information_schema 判存 + PREPARE/EXECUTE;文件尾注释回滚语句)
- [x] **Step 2:** `migration-inventory.md` 追加 V140 行;跑 `MigrationInventoryTest` 通过
### Task 2: 队列实体/Mapper + 入队写入(分片回传侧)
**Files:**
- Create: `modules/collectdata/model/entity/CollectDataBrandRecheckEntity.java`、`modules/collectdata/mapper/CollectDataBrandRecheckMapper.java`
- Create: `modules/collectdata/service/CollectDataBrandRecheckService.java`(入队 + 取出 + 状态推进的 DB 语义都收在这)
- Modify: `CollectDataService.java`(`submitResult` 锁外,`brandOutcome` 计算后、`writeAsinCacheOutsideLock` 附近调 `recheckService.enqueue(taskId, taskNo, userId, brandOutcome.queryFailedBrands())`;包 try-catch 只记日志)
- Test: `CollectDataBrandRecheckServiceTest`
**Steps:**
- [x] **Step 1:** entity/mapper(MyBatis-Plus 注解,对齐同包既有写法)
- [x] **Step 2:** `enqueue`:品牌归一化复用 `BrandCheckClient` 同款 trim 规则;`INSERT ... ON DUPLICATE KEY UPDATE`(命中已有行且状态非 PENDING 时不改写);空列表零写入
- [x] **Step 3:** 接入 `submitResult`,测试:queryFailed 为空不写库、重复失败不刷新首次时间、入队抛错不影响回传返回值
### Task 3: 补测配置项
**Files:**
- Create: `config/CollectDataBrandRecheckProperties.java`(prefix `aiimage.collect-data.brand-recheck`)
- Modify: `application.yml`(如该前缀需显式登记;对齐 `aiimage.collect-data.brand-check-batch-size` 的登记方式)
**Interfaces:**
- `enabled=true`、`scanIntervalMs=5min`、`firstDelayMinutes=30`、`intervalBaseMinutes=30`、`maxAttempts=6`、`roundBatchSize=200`(单轮品牌数上限)、`probeBatchSize=10`(复用 brand-check-batch-size)、`failRateThreshold=0.5`、`failRateMinProbe=3`
**Steps:**
- [x] **Step 1:** Properties 类 + 默认值 + relaxed binding 验证用单测
### Task 4: 调度器(轮询 + 熔断 + 退避)
**Files:**
- Create: `modules/collectdata/service/CollectDataBrandRecheckScheduler.java`(`@Scheduled` + Redis 锁,写法对齐 `NotificationScanScheduler`)
- Test: `CollectDataBrandRecheckSchedulerTest`
**Steps:**
- [x] **Step 1:** 轮询入口:取到期 PENDING(limit roundBatchSize),按 task_id 聚组;task 非终态/不存在 → 顺延不计次
- [x] **Step 2:** 组内调 `brandCheckClient.checkAll(brands, defaultStrategy)`;把结论分派给注入服务(Task 5)
- [x] **Step 3:** 熔断与退避(按行为规格 3/4);`EXHAUSTED` 收口 + 聚合通知挂到 Task 6 一起做
- [x] **Step 4:** 测试:非终态顺延不计次、退避序列 30m/1h/2h/4h/8h/16h、maxAttempts 收口、熔断后未测条目不计次
### Task 5: 注入路径(结论 → 结果行/无效品牌 → 文件重建)
**Files:**
- Create: `modules/collectdata/service/CollectDataBrandRecheckInjector.java`
- Modify: `CollectDataService.java`(把 `streamRawRows` 提为包内可复用,或抽 `CollectDataChunkReader`;`processResultFileJob`/装配路径不动)
- Test: `CollectDataBrandRecheckInjectorTest`
**Steps:**
- [x] **Step 1:** 按 task 持任务锁(拿不到整组顺延);读 chunk payload 收集目标品牌行(复用 streamRawRows 语义)
- [x] **Step 2:** dedupe 复查(`CollectDataBatchQuery.filter`)→ 分流:accepted→明细对象(key `recheck-chunk-<n>`,不得覆盖原 chunk 明细)+ `upsertAccepted`;rejected→`invalidAsinBatchWriter.writeBatch`
- [x] **Step 3:** 结论写 ASIN 缓存;组内全部条目处理完 → `enqueueAssembleResult`(仅当本轮有实际写入)
- [x] **Step 4:** 幂等验证测试:同 (task,brand) 二次注入 `newlyInserted=0`;rejected 品牌行不进结果;任务锁竞争时零写入
- [x] **Step 5:** 边界:chunk payload 丢失/解码失败只跳过该 chunk 并记 warn,不中断注入
### Task 6: 用户通知
**Files:**
- Modify: `NotificationDispatchService.java`(新增 `pushRecheckCompleted(userId, taskNo, injected, rejected, pending)`,形态对齐 `pushPartialResult`;dedupe_key `collect_recheck:{taskId}:{yyyyMMdd}`)
- Test: `NotificationDispatchServiceTest` 补用例
**Steps:**
- [x] **Step 1:** 实现通知 + 文案(X 行新增 / Y 判无效 / Z 仍失败);EXHAUSTED 收口通知同函数复用
- [x] **Step 2:** 同 task 同日只推一条测试(`pushOrRefresh` 语义)
### Task 7: 全量回归 + 交付部署(只交付命令)
**Steps:**
- [x] **Step 1:** `cd backend-java && mvn -o test` 全绿(3451 个测试,含本功能 31 个新用例)
- [ ] **Step 2:** 交付命令清单(人工执行):`mvn clean package -DskipTests` → `python scripts/deploy.py`(或 `_deploy_jar_and_restart_both.py`)→ 两台 `docker logs java-server` 观认 `brand-recheck` 首轮日志;V140 由 Flyway 启动时自动执行
- [ ] **Step 3:** 观察口径:补测轮日志(轮内品牌数/结论分布/熔断次数);上线一周后看「部分结果缺失」通知量与「补测完成」通知量的替代关系
---
## 未决问题(实现前与业务确认,不阻塞排期)
1. rejected(补测判出侵权命中)的行**不回溯改历史文件**,只落无效品牌表 + 下次装配生效——用户是否接受"结果文件版本会变"?
2. EXHAUSTED 后是否提供管理员手动重置入口(后台小按钮),还是完全自然过期?V1 倾向不做。
3. 补测期间用户的客户端如果重新提交了同 ASIN 新任务,注入时 dedupe 复查会丢弃旧任务行——文案里要不要解释"已被新任务覆盖"?
## 实现落地记录(2026-10-02,未部署未提交)
- 新文件:`V140__collectdata_brand_recheck.sql`、`CollectDataBrandRecheckEntity/Mapper/Service/Scheduler/Injector`、`CollectDataBrandRecheckProperties`(已在 `PropertiesConfig` 登记)、4 个新测试类(31 用例)。
- 既有文件改动:`CollectDataService`(submitResult 锁外入队 + `resolveCacheCountry` 收窄为包内可见)、`CollectDataBrandBatchFilter.normalizeBrand` 改 public(补测链路复用同一归一化口径)、`NotificationDispatchService.pushRecheckOutcome`、`migration-inventory.md`(V140)。
- 5 个既有测试类补了构造参数/`@Mock`(构造签名新增 recheck 服务)。
- 与计划的偏差:入队用 select→insert + 吞 `DuplicateKeyException`(语义等价 ON DUPLICATE 的"不改写"要求);`maxAttempts=7`(首测 + 6 轮退避 30m/1h/2h/4h/8h/16h,合计覆盖 ≈31h——计划里 6 轮的算术覆盖不了 31h);通知方法定名 `pushRecheckOutcome`(同一方法覆盖"补测完成/未能完成"两形态)。
- 未决问题 1 按默认执行(补测只影响后续装配,不回溯改历史文件);2/3 V1 不做。
@@ -0,0 +1,350 @@
# 00 Plan Overview:后台管理前端 Vue 化任务总览
> 依据 `docs/specs/` 全部 Spec 生成。本文件只提供全量任务索引;每个模块的详细 TDD 用例和验证步骤分别写入同编号 plan 文件。
## 执行约束
- 所有任务单线程串行执行:先测试、确认 RED,再实现、确认 GREEN,最后 lint/format、验证、commit。
- 每个任务目标耗时 8-15 分钟,按一个可验收功能点拆分,不按类或函数拆分。
- 每个任务至少 8 个测试用例:正常路径 3 个、边界 3 个、异常/错误 2 个;纯配置类任务可按对应 plan 的最低要求执行。
- 涉及 HTTP、数据库、Nginx、文件或外部进程时,必须同时有 mock 测试和至少一个真实集成/真实请求验证。
- 当前仓库已有其他未提交变更,执行任务时不得覆盖或重置无关工作树修改。
## 模块与任务数量
| Plan | 对应 Spec | 模块 | 任务数 |
|---|---|---|---:|
| `01-admin-shell-routing` | `docs/specs/01-admin-shell-routing.md` | 后台壳层与路由 | 20 |
| `02-session-menu-permission` | `docs/specs/02-session-menu-permission.md` | 登录态、菜单树与菜单级权限 | 20 |
| `03-account-permission-pages` | `docs/specs/03-account-permission-pages.md` | 账号与权限页面 | 20 |
| `04-asin-data-center` | `docs/specs/04-asin-data-center.md` | ASIN 数据中心 | 20 |
| `05-shop-center` | `docs/specs/05-shop-center.md` | 店铺中心 | 20 |
| `06-task-and-duplicate-center` | `docs/specs/06-task-and-duplicate-center.md` | 任务与重复分析中心 | 20 |
| `07-records-and-version` | `docs/specs/07-records-and-version.md` | 记录与版本中心 | 20 |
| `08-java-menu-and-flyway` | `docs/specs/08-java-menu-and-flyway.md` | Java 菜单树与 Flyway 权限迁移 | 20 |
| `09-public-version-compatibility` | `docs/specs/09-public-version-compatibility.md` | 客户端公开版本接口兼容 | 20 |
| `10-static-deployment-nginx` | `docs/specs/10-static-deployment-nginx.md` | 静态资源部署与 Nginx History 托管 | 20 |
| `11-flask-removal-cutover` | `docs/specs/11-flask-removal-cutover.md` | Flask 管理能力移除与入口切换 | 20 |
| `12-testing-acceptance` | `docs/specs/12-testing-acceptance.md` | 测试、回归与最终验收 | 20 |
| `13-admin-html-visual-alignment` | `docs/specs/13-admin-html-visual-alignment.md` | AdminHtml 观感与交互对齐(蓝白浅色) | 32 |
| **合计** | 13 个模块 | 后台管理 Vue 化全链路 | **272** |
## 全量任务表
| ID | 功能点 | 模块 | 依赖 |
|---:|---|---|---|
| 1 | 确认独立后台工程依赖、构建、测试和工作区边界 | 后台壳层与路由 | 无 |
| 2 | 冻结 /admin-vue/ base 与 History 路由约定 | 后台壳层与路由 | 1 |
| 3 | 定义 AdminLayout 页面容器职责 | 后台壳层与路由 | 2 |
| 4 | 定义深色侧边栏与浅色内容区设计 token | 后台壳层与路由 | 3 |
| 5 | 定义顶部栏用户信息和页面标题模型 | 后台壳层与路由 | 4 |
| 6 | 定义后端菜单树到侧边栏节点的映射规则 | 后台壳层与路由 | 5 |
| 7 | 实现根路由到首个可见页面的跳转规则 | 后台壳层与路由 | 6 |
| 8 | 实现业务域路由注册表 | 后台壳层与路由 | 7 |
| 9 | 实现路由 meta 菜单 key 约定 | 后台壳层与路由 | 8 |
| 10 | 实现页面级异步组件加载边界 | 后台壳层与路由 | 9 |
| 11 | 实现无菜单权限空状态 | 后台壳层与路由 | 10 |
| 12 | 实现路由级错误页面 | 后台壳层与路由 | 11 |
| 13 | 实现全局请求错误提示容器 | 后台壳层与路由 | 12 |
| 14 | 实现侧边栏折叠和窄屏布局行为 | 后台壳层与路由 | 13 |
| 15 | 实现页面标题与面包屑规则 | 后台壳层与路由 | 14 |
| 16 | 实现退出登录入口的壳层交互 | 后台壳层与路由 | 15 |
| 17 | 实现桌面端壳层响应式验收 | 后台壳层与路由 | 16 |
| 18 | 实现壳层键盘焦点和可访问性语义 | 后台壳层与路由 | 17 |
| 19 | 验证首批页面从壳层正确挂载 | 后台壳层与路由 | 18 |
| 20 | 完成壳层真实浏览器 smoke 验收 | 后台壳层与路由 | 19 |
| 21 | 定义 AdminUser 和 AdminMenuNode 类型契约 | 登录态、菜单树与菜单级权限 | 20 |
| 22 | 定义 API 响应解包和错误归一化规则 | 登录态、菜单树与菜单级权限 | 21 |
| 23 | 实现当前用户请求适配 | 登录态、菜单树与菜单级权限 | 22 |
| 24 | 实现菜单树请求适配 | 登录态、菜单树与菜单级权限 | 23 |
| 25 | 实现 Cookie/Session 请求配置 | 登录态、菜单树与菜单级权限 | 24 |
| 26 | 实现 401 登录跳转行为 | 登录态、菜单树与菜单级权限 | 25 |
| 27 | 实现 Pinia admin-session store 初始状态 | 登录态、菜单树与菜单级权限 | 26 |
| 28 | 实现当前用户初始化动作 | 登录态、菜单树与菜单级权限 | 27 |
| 29 | 实现菜单树初始化动作 | 登录态、菜单树与菜单级权限 | 28 |
| 30 | 实现初始化失败和重试状态 | 登录态、菜单树与菜单级权限 | 29 |
| 31 | 实现超级管理员菜单判定 | 登录态、菜单树与菜单级权限 | 30 |
| 32 | 实现普通用户菜单 key 查找 | 登录态、菜单树与菜单级权限 | 31 |
| 33 | 实现路由菜单权限守卫 | 登录态、菜单树与菜单级权限 | 32 |
| 34 | 实现无权限路由回退 | 登录态、菜单树与菜单级权限 | 33 |
| 35 | 实现无菜单用户状态 | 登录态、菜单树与菜单级权限 | 34 |
| 36 | 实现退出登录和状态清理 | 登录态、菜单树与菜单级权限 | 35 |
| 37 | 实现菜单树父子关系校验 | 登录态、菜单树与菜单级权限 | 36 |
| 38 | 实现菜单排序和空 route 处理 | 登录态、菜单树与菜单级权限 | 37 |
| 39 | 验证后端树形响应兼容边界 | 登录态、菜单树与菜单级权限 | 38 |
| 40 | 完成真实登录态与权限路由 smoke 验收 | 登录态、菜单树与菜单级权限 | 39 |
| 41 | 定义用户列表 DTO 和分页 DTO | 账号与权限页面 | 40 |
| 42 | 实现用户列表查询适配 | 账号与权限页面 | 41 |
| 43 | 实现用户筛选条件状态 | 账号与权限页面 | 42 |
| 44 | 实现用户分页边界行为 | 账号与权限页面 | 43 |
| 45 | 实现新建用户表单模型 | 账号与权限页面 | 44 |
| 46 | 实现新建用户请求适配 | 账号与权限页面 | 45 |
| 47 | 实现编辑用户表单回填 | 账号与权限页面 | 46 |
| 48 | 实现用户角色字段映射 | 账号与权限页面 | 47 |
| 49 | 实现用户菜单授权数据加载 | 账号与权限页面 | 48 |
| 50 | 实现用户菜单授权提交 | 账号与权限页面 | 49 |
| 51 | 实现用户删除确认和刷新 | 账号与权限页面 | 50 |
| 52 | 实现用户列表加载/空/错状态 | 账号与权限页面 | 51 |
| 53 | 定义菜单管理 DTO | 账号与权限页面 | 52 |
| 54 | 实现后台菜单列表加载 | 账号与权限页面 | 53 |
| 55 | 实现菜单新增表单 | 账号与权限页面 | 54 |
| 56 | 实现菜单编辑表单 | 账号与权限页面 | 55 |
| 57 | 实现菜单删除前置校验 | 账号与权限页面 | 56 |
| 58 | 实现同级菜单排序交互 | 账号与权限页面 | 57 |
| 59 | 实现数据权限分组列表和摘要 | 账号与权限页面 | 58 |
| 60 | 完成账号权限三页面真实 API 验收 | 账号与权限页面 | 59 |
| 61 | 定义 ASIN 中心共享分页和筛选类型 | ASIN 数据中心 | 60 |
| 62 | 实现去重汇总列表查询 | ASIN 数据中心 | 61 |
| 63 | 实现去重汇总日期和国家筛选 | ASIN 数据中心 | 62 |
| 64 | 实现去重汇总导出等待状态 | ASIN 数据中心 | 63 |
| 65 | 实现去重汇总导入任务创建 | ASIN 数据中心 | 64 |
| 66 | 实现去重汇总导入轮询和终态 | ASIN 数据中心 | 65 |
| 67 | 实现去重汇总删除导入流程 | ASIN 数据中心 | 66 |
| 68 | 实现品牌数据库列表查询 | ASIN 数据中心 | 67 |
| 69 | 实现品牌数据库新增/编辑表单 | ASIN 数据中心 | 68 |
| 70 | 实现品牌数据库删除确认 | ASIN 数据中心 | 69 |
| 71 | 实现查询 ASIN 列表和筛选 | ASIN 数据中心 | 70 |
| 72 | 实现查询 ASIN 导入与轮询 | ASIN 数据中心 | 71 |
| 73 | 实现查询 ASIN 删除导入 | ASIN 数据中心 | 72 |
| 74 | 实现查询 ASIN 详情抽屉 | ASIN 数据中心 | 73 |
| 75 | 实现最低价 ASIN 列表和筛选 | ASIN 数据中心 | 74 |
| 76 | 实现最低价 ASIN 导入与删除导入 | ASIN 数据中心 | 75 |
| 77 | 实现最低价 ASIN 详情编辑抽屉 | ASIN 数据中心 | 76 |
| 78 | 实现商品类目树加载和搜索 | ASIN 数据中心 | 77 |
| 79 | 实现商品类目新增/编辑/导出 | ASIN 数据中心 | 78 |
| 80 | 完成 ASIN 数据中心真实流程验收 | ASIN 数据中心 | 79 |
| 81 | 定义店铺和店铺密钥 DTO | 店铺中心 | 80 |
| 82 | 实现店铺密钥列表加载 | 店铺中心 | 81 |
| 83 | 实现店铺密钥筛选和分页 | 店铺中心 | 82 |
| 84 | 实现新增店铺密钥表单 | 店铺中心 | 83 |
| 85 | 实现编辑店铺密钥表单 | 店铺中心 | 84 |
| 86 | 实现密钥敏感字段掩码 | 店铺中心 | 85 |
| 87 | 实现密钥删除确认和刷新 | 店铺中心 | 86 |
| 88 | 实现店铺列表加载 | 店铺中心 | 87 |
| 89 | 实现店铺筛选和分页 | 店铺中心 | 88 |
| 90 | 实现店铺分组选项加载 | 店铺中心 | 89 |
| 91 | 实现新增店铺表单 | 店铺中心 | 90 |
| 92 | 实现编辑店铺表单 | 店铺中心 | 91 |
| 93 | 实现店铺凭证字段分离 | 店铺中心 | 92 |
| 94 | 实现店铺凭证明文短时展示 | 店铺中心 | 93 |
| 95 | 实现店铺删除确认 | 店铺中心 | 94 |
| 96 | 实现店铺账号字段校验 | 店铺中心 | 95 |
| 97 | 实现店铺数据空状态和错误状态 | 店铺中心 | 96 |
| 98 | 实现店铺中心通用筛选栏 | 店铺中心 | 97 |
| 99 | 实现店铺中心响应式表格 | 店铺中心 | 98 |
| 100 | 完成店铺中心真实 API 验收 | 店铺中心 | 99 |
| 101 | 定义统一任务状态和结果文件类型 | 任务与重复分析中心 | 100 |
| 102 | 实现视频任务筛选状态 | 任务与重复分析中心 | 101 |
| 103 | 实现视频任务列表/卡片加载 | 任务与重复分析中心 | 102 |
| 104 | 实现视频任务详情展示 | 任务与重复分析中心 | 103 |
| 105 | 实现视频任务批量选择 | 任务与重复分析中心 | 104 |
| 106 | 实现视频任务批量下载任务 | 任务与重复分析中心 | 105 |
| 107 | 实现视频任务下载失败摘要 | 任务与重复分析中心 | 106 |
| 108 | 实现视频任务数据范围配置 | 任务与重复分析中心 | 107 |
| 109 | 实现店铺数据任务筛选 | 任务与重复分析中心 | 108 |
| 110 | 实现店铺数据任务列表 | 任务与重复分析中心 | 109 |
| 111 | 实现店铺数据任务分页刷新 | 任务与重复分析中心 | 110 |
| 112 | 实现店铺数据任务批量选择 | 任务与重复分析中心 | 111 |
| 113 | 实现店铺数据任务批量下载 | 任务与重复分析中心 | 112 |
| 114 | 实现店铺数据任务权限配置 | 任务与重复分析中心 | 113 |
| 115 | 实现重复检查总览指标 | 任务与重复分析中心 | 114 |
| 116 | 实现重复检查分布视图 | 任务与重复分析中心 | 115 |
| 117 | 实现重复检查明细列表 | 任务与重复分析中心 | 116 |
| 118 | 实现重复检查详情抽屉 | 任务与重复分析中心 | 117 |
| 119 | 实现重复检查导入/导出状态 | 任务与重复分析中心 | 118 |
| 120 | 完成任务与重复检查真实流程验收 | 任务与重复分析中心 | 119 |
| 121 | 定义历史记录 DTO | 记录与版本中心 | 120 |
| 122 | 实现历史记录筛选条件 | 记录与版本中心 | 121 |
| 123 | 实现历史记录分页加载 | 记录与版本中心 | 122 |
| 124 | 实现历史结果预览抽屉 | 记录与版本中心 | 123 |
| 125 | 实现历史记录空/错状态 | 记录与版本中心 | 124 |
| 126 | 定义软件版本 DTO | 记录与版本中心 | 125 |
| 127 | 实现软件版本列表加载 | 记录与版本中心 | 126 |
| 128 | 实现软件版本上传表单 | 记录与版本中心 | 127 |
| 129 | 实现软件版本上传进度和错误 | 记录与版本中心 | 128 |
| 130 | 实现软件版本下载链接展示 | 记录与版本中心 | 129 |
| 131 | 定义数字人版本 DTO | 记录与版本中心 | 130 |
| 132 | 实现数字人版本列表加载 | 记录与版本中心 | 131 |
| 133 | 实现数字人版本上传 | 记录与版本中心 | 132 |
| 134 | 实现数字人版本状态展示 | 记录与版本中心 | 133 |
| 135 | 实现数字人版本发布操作 | 记录与版本中心 | 134 |
| 136 | 实现数字人版本设为最新操作 | 记录与版本中心 | 135 |
| 137 | 实现版本页面统一时间和文件格式化 | 记录与版本中心 | 136 |
| 138 | 实现版本页面权限路由接入 | 记录与版本中心 | 137 |
| 139 | 实现客户端公开版本接口回归夹具 | 记录与版本中心 | 138 |
| 140 | 完成记录与版本中心真实流程验收 | 记录与版本中心 | 139 |
| 141 | 冻结 Java 菜单树响应 DTO | Java 菜单树与 Flyway 权限迁移 | 140 |
| 142 | 定义 menu_type=admin 过滤规则 | Java 菜单树与 Flyway 权限迁移 | 141 |
| 143 | 实现有效菜单节点索引 | Java 菜单树与 Flyway 权限迁移 | 142 |
| 144 | 实现 parent_id 树组装 | Java 菜单树与 Flyway 权限迁移 | 143 |
| 145 | 实现菜单 sort_order 排序 | Java 菜单树与 Flyway 权限迁移 | 144 |
| 146 | 实现空父节点和脏数据处理 | Java 菜单树与 Flyway 权限迁移 | 145 |
| 147 | 实现分组节点 route 处理 | Java 菜单树与 Flyway 权限迁移 | 146 |
| 148 | 实现页面节点 route 输出 | Java 菜单树与 Flyway 权限迁移 | 147 |
| 149 | 实现 column_key 到 key 映射 | Java 菜单树与 Flyway 权限迁移 | 148 |
| 150 | 实现当前用户菜单树控制器响应 | Java 菜单树与 Flyway 权限迁移 | 149 |
| 151 | 覆盖超级管理员菜单树 | Java 菜单树与 Flyway 权限迁移 | 150 |
| 152 | 覆盖普通管理员菜单树 | Java 菜单树与 Flyway 权限迁移 | 151 |
| 153 | 覆盖无权限用户菜单树 | Java 菜单树与 Flyway 权限迁移 | 152 |
| 154 | 定义 route_path Flyway 迁移矩阵 | Java 菜单树与 Flyway 权限迁移 | 153 |
| 155 | 实现后台账号菜单 route 迁移 | Java 菜单树与 Flyway 权限迁移 | 154 |
| 156 | 实现 ASIN 和店铺菜单 route 迁移 | Java 菜单树与 Flyway 权限迁移 | 155 |
| 157 | 实现任务和记录菜单 route 迁移 | Java 菜单树与 Flyway 权限迁移 | 156 |
| 158 | 验证 column_key 和授权关系不变 | Java 菜单树与 Flyway 权限迁移 | 157 |
| 159 | 验证 Flyway 唯一约束和幂等性 | Java 菜单树与 Flyway 权限迁移 | 158 |
| 160 | 完成 Java 菜单树真实接口验收 | Java 菜单树与 Flyway 权限迁移 | 159 |
| 161 | 冻结 /api/version 响应契约 | 客户端公开版本接口兼容 | 160 |
| 162 | 冻结 /api/version/latest 响应契约 | 客户端公开版本接口兼容 | 161 |
| 163 | 定义 web_config 最新记录排序规则 | 客户端公开版本接口兼容 | 162 |
| 164 | 实现 Java 当前版本配置读取 | 客户端公开版本接口兼容 | 163 |
| 165 | 实现 Java 最新版本查询服务 | 客户端公开版本接口兼容 | 164 |
| 166 | 实现空版本表 null 语义 | 客户端公开版本接口兼容 | 165 |
| 167 | 实现版本字段空字符串语义 | 客户端公开版本接口兼容 | 166 |
| 168 | 实现公开接口不使用 ApiResponse 包装 | 客户端公开版本接口兼容 | 167 |
| 169 | 实现版本接口数据库错误处理 | 客户端公开版本接口兼容 | 168 |
| 170 | 验证多版本记录取最新 | 客户端公开版本接口兼容 | 169 |
| 171 | 验证同时间记录按 id 稳定排序 | 客户端公开版本接口兼容 | 170 |
| 172 | 验证 file_url 原样返回 | 客户端公开版本接口兼容 | 171 |
| 173 | 验证 desc/url 字段保留 | 客户端公开版本接口兼容 | 172 |
| 174 | 验证旧客户端请求路径不变 | 客户端公开版本接口兼容 | 173 |
| 175 | 验证公开接口与后台上传解耦 | 客户端公开版本接口兼容 | 174 |
| 176 | 验证 Java 接口替代 Flask 后响应一致 | 客户端公开版本接口兼容 | 175 |
| 177 | 补充版本接口控制器测试 | 客户端公开版本接口兼容 | 176 |
| 178 | 补充版本接口数据库集成测试 | 客户端公开版本接口兼容 | 177 |
| 179 | 完成真实客户端更新链路 smoke | 客户端公开版本接口兼容 | 178 |
| 180 | 完成 Flask 版本蓝图删除前置验收 | 客户端公开版本接口兼容 | 179 |
| 181 | 确认后台 dist 发布目录约定 | 静态资源部署与 Nginx History 托管 | 180 |
| 182 | 确认 Vite base 和 Router base 一致 | 静态资源部署与 Nginx History 托管 | 181 |
| 183 | 定义 index.html 缓存策略 | 静态资源部署与 Nginx History 托管 | 182 |
| 184 | 定义 hashed assets 缓存策略 | 静态资源部署与 Nginx History 托管 | 183 |
| 185 | 定义 /admin 重定向规则 | 静态资源部署与 Nginx History 托管 | 184 |
| 186 | 定义 /admin-vue/ 静态 location | 静态资源部署与 Nginx History 托管 | 185 |
| 187 | 定义 assets 优先匹配规则 | 静态资源部署与 Nginx History 托管 | 186 |
| 188 | 定义 History fallback 规则 | 静态资源部署与 Nginx History 托管 | 187 |
| 189 | 定义静态资源 404 规则 | 静态资源部署与 Nginx History 托管 | 188 |
| 190 | 定义 /api/ Java upstream 代理 | 静态资源部署与 Nginx History 托管 | 189 |
| 191 | 定义 Cookie 和转发请求头规则 | 静态资源部署与 Nginx History 托管 | 190 |
| 192 | 定义临时发布目录结构 | 静态资源部署与 Nginx History 托管 | 191 |
| 193 | 定义原子切换和回滚结构 | 静态资源部署与 Nginx History 托管 | 192 |
| 194 | 实现构建产物清单校验 | 静态资源部署与 Nginx History 托管 | 193 |
| 195 | 实现静态资源 MIME 验证 | 静态资源部署与 Nginx History 托管 | 194 |
| 196 | 实现桌面路由刷新验收脚本 | 静态资源部署与 Nginx History 托管 | 195 |
| 197 | 实现不存在资源 404 验收脚本 | 静态资源部署与 Nginx History 托管 | 196 |
| 198 | 验证生产 base URL 引用完整 | 静态资源部署与 Nginx History 托管 | 197 |
| 199 | 验证 Nginx 与 Java API 联通 | 静态资源部署与 Nginx History 托管 | 198 |
| 200 | 完成真实 Nginx 部署 smoke | 静态资源部署与 Nginx History 托管 | 199 |
| 201 | 盘点 Flask 管理页面和 API 流量 | Flask 管理能力移除与入口切换 | 200 |
| 202 | 盘点 Flask 版本接口调用方 | Flask 管理能力移除与入口切换 | 201 |
| 203 | 冻结 Flask 删除清单 | Flask 管理能力移除与入口切换 | 202 |
| 204 | 确认 Java 管理 API 覆盖矩阵 | Flask 管理能力移除与入口切换 | 203 |
| 205 | 确认 Vue 页面覆盖矩阵 | Flask 管理能力移除与入口切换 | 204 |
| 206 | 完成旧后台权限快照 | Flask 管理能力移除与入口切换 | 205 |
| 207 | 完成旧后台 API 响应快照 | Flask 管理能力移除与入口切换 | 206 |
| 208 | 完成 Java 菜单树回归 | Flask 管理能力移除与入口切换 | 207 |
| 209 | 完成 Java 公开版本回归 | Flask 管理能力移除与入口切换 | 208 |
| 210 | 完成 Nginx /admin-vue 回归 | Flask 管理能力移除与入口切换 | 209 |
| 211 | 切换 /admin 到 /admin-vue | Flask 管理能力移除与入口切换 | 210 |
| 212 | 验证旧 admin 页面无生产流量 | Flask 管理能力移除与入口切换 | 211 |
| 213 | 停止 Flask 管理路由注册 | Flask 管理能力移除与入口切换 | 212 |
| 214 | 删除 Flask admin blueprint | Flask 管理能力移除与入口切换 | 213 |
| 215 | 删除 Flask 管理页面模板 | Flask 管理能力移除与入口切换 | 214 |
| 216 | 删除旧 admin.js 和 interactions.js | Flask 管理能力移除与入口切换 | 215 |
| 217 | 删除 Java static 旧后台副本 | Flask 管理能力移除与入口切换 | 216 |
| 218 | 清理旧菜单扁平响应逻辑 | Flask 管理能力移除与入口切换 | 217 |
| 219 | 清理部署和文档旧入口引用 | Flask 管理能力移除与入口切换 | 218 |
| 220 | 完成 Flask 管理移除后真实 HTTP 验收 | Flask 管理能力移除与入口切换 | 219 |
| 221 | 建立独立后台前端测试命令 | 测试、回归与最终验收 | 220 |
| 222 | 建立后台前端类型检查门禁 | 测试、回归与最终验收 | 221 |
| 223 | 建立后台前端构建门禁 | 测试、回归与最终验收 | 222 |
| 224 | 真实启动 Java 后端并验证健康检查 | 测试、回归与最终验收 | 223 |
| 225 | 真实访问 /admin 与 /admin-vue 页面入口 | 测试、回归与最终验收 | 224 |
| 226 | 真实执行首批菜单加载与用户查询交互 | 测试、回归与最终验收 | 225 |
| 227 | 建立菜单树转换和权限守卫测试夹具 | 测试、回归与最终验收 | 226 |
| 228 | 建立 Session 初始化、401 和退出登录测试夹具 | 测试、回归与最终验收 | 227 |
| 229 | 建立账号权限页面 API 与表单回归测试 | 测试、回归与最终验收 | 228 |
| 230 | 建立 ASIN 数据中心 API 与导入导出回归测试 | 测试、回归与最终验收 | 229 |
| 231 | 建立店铺中心 API 与敏感字段回归测试 | 测试、回归与最终验收 | 230 |
| 232 | 建立任务中心、下载和重复检查回归测试 | 测试、回归与最终验收 | 231 |
| 233 | 真实验证 /api/version 与 /api/version/latest | 测试、回归与最终验收 | 232 |
| 234 | 建立 Flyway 菜单迁移集成测试 | 测试、回归与最终验收 | 233 |
| 235 | 真实验证 Nginx History fallback、assets 和 404 | 测试、回归与最终验收 | 234 |
| 236 | 建立 Playwright 核心交互、错误重试和响应式验收 | 测试、回归与最终验收 | 235 |
| 237 | 运行全量测试并记录覆盖率门禁 | 测试、回归与最终验收 | 236 |
| 238 | 运行 lint、format 和接口一致性检查 | 测试、回归与最终验收 | 237 |
| 239 | 验证每个任务均有对应 git commit 和 progress 状态 | 测试、回归与最终验收 | 238 |
| 240 | 执行最终发布验收并确认 check_progress 返回 all tasks done | 测试、回归与最终验收 | 239 |
## 模块 13 任务表(241-272,详见 `13-admin-html-visual-alignment.md`)
| ID | 功能点 | 依赖 |
|---:|---|---|
| 241 | 冻结 admin.html 蓝白浅色 token 基线并迁移 theme/main.css | 240 |
| 242 | Element Plus 全局主题变量对齐蓝白浅色 | 241 |
| 243 | 壳层换皮(侧栏/顶栏/菜单)对齐蓝白浅色 | 242 |
| 244 | 页面公共区块样式收敛(panel/filter/table/footer/空错态) | 242 |
| 245 | 二次确认对话框共享组件 | 244 |
| 246 | 表单反馈/Toast/loading 语义统一 | 245 |
| 247 | 行内工具组件化(徽章/掩码/复制/白名单药丸) | 244 |
| 248 | 模态与抽屉容器统一 | 244 |
| 249 | 壳层与公共样式真实验收 + 每页检查清单模板 | 243-248 |
| 250 | 用户管理页面对齐(列表/筛选/文案/分页) | 249 |
| 251 | 用户管理补齐新建/编辑/角色+菜单授权弹窗 | 250 |
| 252 | 菜单管理页面对齐 | 250 |
| 253 | 数据权限分组页面对齐(选人通讯录编辑器) | 251 |
| 254 | 去重汇总页面对齐(筛选扩充+行编辑+导入/删除导入/导出) | 253 |
| 255 | 品牌数据库(不符合ASIN)页面对齐 | 254 |
| 256 | 商品类目页面对齐(懒加载树/搜索/导出/删除/新增编辑) | 255 |
| 257 | 查询ASIN页面对齐(配置抽屉与导入) | 255 |
| 258 | 最低价ASIN页面对齐(价格范围+配置抽屉+导入) | 257 |
| 259 | 生成记录页面对齐(筛选+缩略图预览布局) | 258 |
| 260 | 软件版本页面对齐 | 259 |
| 261 | 数字人版本页面对齐(状态色/发布/设最新/删除) | 260 |
| 262 | 店铺密钥页面对齐(白名单药丸/令牌留空语义) | 261 |
| 263 | 店铺管理页面对齐(掩码眼睛/凭证明文/校验) | 262 |
| 264 | 视频任务视图对齐(卡片网格+播放+单卡下载) | 263 |
| 265 | 视频任务筛选/权限配置/批量下载 对齐 | 264 |
| 266 | 店铺数据任务视图对齐(每店卡片网格) | 265 |
| 267 | 店铺数据任务筛选/批量下载/权限 对齐 | 266 |
| 268 | 15 页逐页对齐自查与修正 | 250-267 |
| 269 | e2e 换皮/对齐冒烟 | 268 |
| 270 | 本地 Java+Vue 全链路真实 smoke | 269 |
| 271 | 全量门禁与收尾提交 | 270 |
| 272 | module 收尾(progress 闭合 + 一致性校验) | 271 |
## 模块执行顺序
1. **后台壳层与路由**:任务 1-20;完成后进入下一模块。
2. **登录态、菜单树与菜单级权限**:任务 21-40;完成后进入下一模块。
3. **账号与权限页面**:任务 41-60;完成后进入下一模块。
4. **ASIN 数据中心**:任务 61-80;完成后进入下一模块。
5. **店铺中心**:任务 81-100;完成后进入下一模块。
6. **任务与重复分析中心**:任务 101-120;完成后进入下一模块。
7. **记录与版本中心**:任务 121-140;完成后进入下一模块。
8. **Java 菜单树与 Flyway 权限迁移**:任务 141-160;完成后进入下一模块。
9. **客户端公开版本接口兼容**:任务 161-180;完成后进入下一模块。
10. **静态资源部署与 Nginx History 托管**:任务 181-200;完成后进入下一模块。
11. **Flask 管理能力移除与入口切换**:任务 201-220;完成后进入下一模块。
12. **测试、回归与最终验收**:任务 221-240;完成后进入下一模块。
13. **AdminHtml 观感对齐**:任务 241-272;DuplicateCheckPage 为例外页不动。
## 每个任务的统一 TDD 准出标准
1. 先写 plan 中列出的全部测试,运行项目测试命令确认目标测试 **RED**;如果测试一开始通过,必须修正测试使其能证明缺失行为。
2. 实现功能,运行同一测试集确认 **GREEN**。
3. 运行类型检查、lint、format 和相关真实集成验证。
4. 检查无 stub、纯 echo、空实现、硬编码业务结果或未处理的错误分支。
5. commit 后才能开始下一个任务;提交信息必须包含 task 编号。
## 最终验收目标
- 运行 `admin-frontend-vue` 的 build、test 和 E2E smoke。
- 运行 Java 全量测试、菜单迁移测试和版本接口测试。
- 真实验证 `/admin`、`/admin-vue/`、History 刷新、assets 404、`/api/version/latest`。
- 确认 17 个后台业务面板完成 Vue 页面迁移。
- 壳层与 15 个后台页面观感/交互对齐 `backend/web_source/admin.html` 现行蓝白浅色皮肤;DuplicateCheckPage(店铺撞款监控)为例外页不变。
- 确认 Flask 管理页面/API/版本蓝图已按 Spec 删除或迁移。
- 确认客户端 `frontend-vue/` 和 `new_web_source/` 没有后台代码或构建产物。
---
**总任务数:272**
@@ -0,0 +1,766 @@
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 02-session-menu-permission:登录态、菜单树与菜单级权限任务计划
> 对应 Spec:`docs/specs/02-session-menu-permission.md`。本文件是“登录态、菜单树与菜单级权限”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission`。
- 目标实现边界:`src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO。
- 默认验证命令:`cd admin-frontend-vue; npm test`;Java 契约任务使用 `cd backend-java; mvn test -Dtest=<测试类>`。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:21-40。
- 前置依赖:任务 20;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 21:定义 AdminUser 和 AdminMenuNode 类型契约
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:20
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 AdminUser 和 AdminMenuNode 类型契约”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_021_define_adminuser___adminmenunode_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_021_define_adminuser___adminmenunode_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_021_define_adminuser___adminmenunode_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_021_define_adminuser___adminmenunode_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_021_define_adminuser___adminmenunode_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_021_define_adminuser___adminmenunode_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_021_define_adminuser___adminmenunode_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_021_define_adminuser___adminmenunode_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-21.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 22:定义 API 响应解包和错误归一化规则
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:21
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 API 响应解包和错误归一化规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_022_define_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_022_define_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_022_define_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_022_define_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_022_define_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_022_define_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_022_define_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_022_define_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-22.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 23:实现当前用户请求适配
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:22
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现当前用户请求适配”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_023_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_023_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_023_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_023_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_023_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_023_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_023_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_023_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-23.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 24:实现菜单树请求适配
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:23
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现菜单树请求适配”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_024_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_024_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_024_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_024_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_024_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_024_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_024_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_024_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-24.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 25:实现 Cookie/Session 请求配置
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:24
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现 Cookie/Session 请求配置”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_025_implement_cookie_session_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_025_implement_cookie_session_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_025_implement_cookie_session_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_025_implement_cookie_session_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_025_implement_cookie_session_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_025_implement_cookie_session_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_025_implement_cookie_session_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_025_implement_cookie_session_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-25.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 26:实现 401 登录跳转行为
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:25
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现 401 登录跳转行为”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_026_implement_401_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_026_implement_401_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_026_implement_401_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_026_implement_401_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_026_implement_401_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_026_implement_401_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_026_implement_401_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_026_implement_401_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-26.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 27:实现 Pinia admin-session store 初始状态
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:26
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现 Pinia admin-session store 初始状态”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_027_implement_pinia_admin_session_store_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_027_implement_pinia_admin_session_store_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_027_implement_pinia_admin_session_store_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_027_implement_pinia_admin_session_store_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_027_implement_pinia_admin_session_store_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_027_implement_pinia_admin_session_store_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_027_implement_pinia_admin_session_store_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_027_implement_pinia_admin_session_store_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-27.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 28:实现当前用户初始化动作
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:27
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现当前用户初始化动作”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_028_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_028_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_028_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_028_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_028_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_028_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_028_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_028_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-28.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 29:实现菜单树初始化动作
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:28
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现菜单树初始化动作”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_029_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_029_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_029_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_029_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_029_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_029_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_029_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_029_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-29.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 30:实现初始化失败和重试状态
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:29
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现初始化失败和重试状态”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_030_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_030_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_030_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_030_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_030_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_030_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_030_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_030_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-30.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 31:实现超级管理员菜单判定
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:30
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现超级管理员菜单判定”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_031_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_031_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_031_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_031_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_031_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_031_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_031_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_031_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-31.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 32:实现普通用户菜单 key 查找
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:31
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现普通用户菜单 key 查找”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_032_implement_key_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_032_implement_key_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_032_implement_key_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_032_implement_key_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_032_implement_key_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_032_implement_key_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_032_implement_key_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_032_implement_key_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-32.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 33:实现路由菜单权限守卫
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:32
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现路由菜单权限守卫”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_033_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_033_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_033_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_033_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_033_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_033_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_033_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_033_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-33.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 34:实现无权限路由回退
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:33
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现无权限路由回退”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_034_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_034_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_034_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_034_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_034_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_034_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_034_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_034_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-34.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 35:实现无菜单用户状态
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:34
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现无菜单用户状态”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_035_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_035_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_035_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_035_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_035_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_035_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_035_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_035_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-35.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 36:实现退出登录和状态清理
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:35
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现退出登录和状态清理”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_036_implement_cleanup_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_036_implement_cleanup_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_036_implement_cleanup_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_036_implement_cleanup_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_036_implement_cleanup_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_036_implement_cleanup_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_036_implement_cleanup_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_036_implement_cleanup_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-36.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 37:实现菜单树父子关系校验
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:36
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现菜单树父子关系校验”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_037_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_037_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_037_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_037_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_037_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_037_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_037_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_037_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-37.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 38:实现菜单排序和空 route 处理
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:37
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现菜单排序和空 route 处理”:以 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_038_implement__route_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_038_implement__route_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_038_implement__route_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_038_implement__route_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_038_implement__route_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_038_implement__route_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_038_implement__route_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_038_implement__route_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-38.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 39:验证后端树形响应兼容边界
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:38
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证后端树形响应兼容边界”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `AdminConsoleController.currentUser/currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`、`columns`、`user_column_permission` 与 `src/api/session.ts`、`src/stores/admin-session.ts`、Router guard 和树形菜单 DTO 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_039_verify_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_039_verify_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_039_verify_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_039_verify_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_039_verify_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_039_verify_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_039_verify_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_039_verify_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-39.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 40:完成真实登录态与权限路由 smoke 验收
**所属模块**:登录态、菜单树与菜单级权限
**依赖**:39
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成真实登录态与权限路由 smoke 验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_040_completereal__smoke_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_040_completereal__smoke_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_040_completereal__smoke_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_040_completereal__smoke_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_040_completereal__smoke_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_040_completereal__smoke_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_040_completereal__smoke_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_040_completereal__smoke_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-40.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。HTTP、Cookie、401 和数据库权限任务必须使用 mock 加至少一次真实请求/集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 21-40 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 03-account-permission-pages:账号与权限页面任务计划
> 对应 Spec:`docs/specs/03-account-permission-pages.md`。本文件是“账号与权限页面”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups`。
- 目标实现边界:`src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree。
- 默认验证命令:`cd admin-frontend-vue; npm test`、`npm run build`;API 交互增加真实 Java 请求。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:41-60。
- 前置依赖:任务 40;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 41:定义用户列表 DTO 和分页 DTO
**所属模块**:账号与权限页面
**依赖**:40
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义用户列表 DTO 和分页 DTO”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_041_define_dto___dto_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_041_define_dto___dto_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_041_define_dto___dto_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_041_define_dto___dto_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_041_define_dto___dto_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_041_define_dto___dto_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_041_define_dto___dto_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_041_define_dto___dto_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-41.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 42:实现用户列表查询适配
**所属模块**:账号与权限页面
**依赖**:41
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现用户列表查询适配”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_042_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_042_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_042_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_042_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_042_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_042_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_042_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_042_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-42.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 43:实现用户筛选条件状态
**所属模块**:账号与权限页面
**依赖**:42
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现用户筛选条件状态”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_043_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_043_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_043_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_043_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_043_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_043_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_043_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_043_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-43.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 44:实现用户分页边界行为
**所属模块**:账号与权限页面
**依赖**:43
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现用户分页边界行为”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_044_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_044_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_044_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_044_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_044_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_044_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_044_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_044_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-44.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 45:实现新建用户表单模型
**所属模块**:账号与权限页面
**依赖**:44
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现新建用户表单模型”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_045_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_045_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_045_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_045_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_045_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_045_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_045_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_045_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-45.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 46:实现新建用户请求适配
**所属模块**:账号与权限页面
**依赖**:45
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现新建用户请求适配”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_046_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_046_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_046_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_046_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_046_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_046_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_046_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_046_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-46.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 47:实现编辑用户表单回填
**所属模块**:账号与权限页面
**依赖**:46
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现编辑用户表单回填”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_047_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_047_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_047_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_047_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_047_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_047_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_047_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_047_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-47.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 48:实现用户角色字段映射
**所属模块**:账号与权限页面
**依赖**:47
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现用户角色字段映射”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_048_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_048_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_048_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_048_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_048_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_048_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_048_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_048_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-48.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 49:实现用户菜单授权数据加载
**所属模块**:账号与权限页面
**依赖**:48
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现用户菜单授权数据加载”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_049_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_049_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_049_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_049_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_049_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_049_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_049_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_049_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-49.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 50:实现用户菜单授权提交
**所属模块**:账号与权限页面
**依赖**:49
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现用户菜单授权提交”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_050_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_050_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_050_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_050_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_050_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_050_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_050_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_050_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-50.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 51:实现用户删除确认和刷新
**所属模块**:账号与权限页面
**依赖**:50
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现用户删除确认和刷新”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_051_implementremoveconfirm_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_051_implementremoveconfirm_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_051_implementremoveconfirm_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_051_implementremoveconfirm_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_051_implementremoveconfirm_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_051_implementremoveconfirm_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_051_implementremoveconfirm_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_051_implementremoveconfirm_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-51.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 52:实现用户列表加载/空/错状态
**所属模块**:账号与权限页面
**依赖**:51
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现用户列表加载/空/错状态”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_052_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_052_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_052_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_052_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_052_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_052_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_052_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_052_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-52.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 53:定义菜单管理 DTO
**所属模块**:账号与权限页面
**依赖**:52
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义菜单管理 DTO”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_053_define_dto_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_053_define_dto_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_053_define_dto_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_053_define_dto_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_053_define_dto_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_053_define_dto_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_053_define_dto_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_053_define_dto_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-53.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 54:实现后台菜单列表加载
**所属模块**:账号与权限页面
**依赖**:53
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现后台菜单列表加载”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_054_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_054_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_054_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_054_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_054_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_054_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_054_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_054_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-54.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 55:实现菜单新增表单
**所属模块**:账号与权限页面
**依赖**:54
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现菜单新增表单”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_055_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_055_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_055_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_055_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_055_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_055_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_055_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_055_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-55.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 56:实现菜单编辑表单
**所属模块**:账号与权限页面
**依赖**:55
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现菜单编辑表单”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_056_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_056_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_056_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_056_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_056_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_056_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_056_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_056_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-56.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 57:实现菜单删除前置校验
**所属模块**:账号与权限页面
**依赖**:56
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现菜单删除前置校验”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_057_implementremove_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_057_implementremove_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_057_implementremove_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_057_implementremove_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_057_implementremove_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_057_implementremove_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_057_implementremove_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_057_implementremove_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-57.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 58:实现同级菜单排序交互
**所属模块**:账号与权限页面
**依赖**:57
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现同级菜单排序交互”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_058_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_058_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_058_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_058_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_058_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_058_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_058_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_058_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-58.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 59:实现数据权限分组列表和摘要
**所属模块**:账号与权限页面
**依赖**:58
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现数据权限分组列表和摘要”:以 `src/pages/account/` 页面、Admin API adapter、Element Plus 表格/表单/Dialog/Tree 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/web_source/admin.html` 的 `panel-users/panel-columns/panel-group-manage`,旧 `admin.js:loadUsers/loadColumns/loadShopManageGroups` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_059_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_059_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_059_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_059_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_059_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_059_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_059_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_059_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-59.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 60:完成账号权限三页面真实 API 验收
**所属模块**:账号与权限页面
**依赖**:59
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成账号权限三页面真实 API 验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_060_completereal_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_060_completereal_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_060_completereal_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_060_completereal_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_060_completereal_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_060_completereal_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_060_completereal_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_060_completereal_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-60.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。表单、列表和授权任务必须同时覆盖 mock 响应与真实 Java 接口;敏感数据不得写日志。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 41-60 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 04-asin-data-center:ASIN 数据中心任务计划
> 对应 Spec:`docs/specs/04-asin-data-center.md`。本文件是“ASIN 数据中心”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader。
- 目标实现边界:`src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型。
- 默认验证命令:`cd admin-frontend-vue; npm test`、`npm run build`;导入导出任务增加真实 Java API 验证。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:61-80。
- 前置依赖:任务 60;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 61:定义 ASIN 中心共享分页和筛选类型
**所属模块**:ASIN 数据中心
**依赖**:60
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 ASIN 中心共享分页和筛选类型”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_061_define_asin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_061_define_asin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_061_define_asin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_061_define_asin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_061_define_asin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_061_define_asin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_061_define_asin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_061_define_asin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-61.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 62:实现去重汇总列表查询
**所属模块**:ASIN 数据中心
**依赖**:61
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现去重汇总列表查询”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_062_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_062_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_062_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_062_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_062_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_062_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_062_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_062_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-62.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 63:实现去重汇总日期和国家筛选
**所属模块**:ASIN 数据中心
**依赖**:62
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现去重汇总日期和国家筛选”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_063_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_063_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_063_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_063_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_063_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_063_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_063_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_063_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-63.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 64:实现去重汇总导出等待状态
**所属模块**:ASIN 数据中心
**依赖**:63
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现去重汇总导出等待状态”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_064_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_064_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_064_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_064_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_064_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_064_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_064_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_064_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-64.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 65:实现去重汇总导入任务创建
**所属模块**:ASIN 数据中心
**依赖**:64
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现去重汇总导入任务创建”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_065_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_065_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_065_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_065_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_065_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_065_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_065_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_065_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-65.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 66:实现去重汇总导入轮询和终态
**所属模块**:ASIN 数据中心
**依赖**:65
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现去重汇总导入轮询和终态”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_066_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_066_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_066_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_066_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_066_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_066_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_066_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_066_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-66.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 67:实现去重汇总删除导入流程
**所属模块**:ASIN 数据中心
**依赖**:66
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现去重汇总删除导入流程”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_067_implementremove_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_067_implementremove_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_067_implementremove_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_067_implementremove_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_067_implementremove_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_067_implementremove_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_067_implementremove_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_067_implementremove_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-67.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 68:实现品牌数据库列表查询
**所属模块**:ASIN 数据中心
**依赖**:67
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现品牌数据库列表查询”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_068_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_068_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_068_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_068_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_068_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_068_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_068_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_068_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-68.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 69:实现品牌数据库新增/编辑表单
**所属模块**:ASIN 数据中心
**依赖**:68
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现品牌数据库新增/编辑表单”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_069_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_069_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_069_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_069_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_069_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_069_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_069_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_069_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-69.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 70:实现品牌数据库删除确认
**所属模块**:ASIN 数据中心
**依赖**:69
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现品牌数据库删除确认”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_070_implementremoveconfirm_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_070_implementremoveconfirm_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_070_implementremoveconfirm_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_070_implementremoveconfirm_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_070_implementremoveconfirm_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_070_implementremoveconfirm_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_070_implementremoveconfirm_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_070_implementremoveconfirm_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-70.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 71:实现查询 ASIN 列表和筛选
**所属模块**:ASIN 数据中心
**依赖**:70
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现查询 ASIN 列表和筛选”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_071_implement_asin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_071_implement_asin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_071_implement_asin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_071_implement_asin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_071_implement_asin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_071_implement_asin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_071_implement_asin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_071_implement_asin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-71.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 72:实现查询 ASIN 导入与轮询
**所属模块**:ASIN 数据中心
**依赖**:71
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现查询 ASIN 导入与轮询”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_072_implement_asin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_072_implement_asin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_072_implement_asin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_072_implement_asin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_072_implement_asin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_072_implement_asin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_072_implement_asin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_072_implement_asin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-72.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 73:实现查询 ASIN 删除导入
**所属模块**:ASIN 数据中心
**依赖**:72
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现查询 ASIN 删除导入”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_073_implement_asin_remove_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_073_implement_asin_remove_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_073_implement_asin_remove_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_073_implement_asin_remove_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_073_implement_asin_remove_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_073_implement_asin_remove_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_073_implement_asin_remove_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_073_implement_asin_remove_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-73.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 74:实现查询 ASIN 详情抽屉
**所属模块**:ASIN 数据中心
**依赖**:73
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现查询 ASIN 详情抽屉”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_074_implement_asin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_074_implement_asin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_074_implement_asin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_074_implement_asin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_074_implement_asin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_074_implement_asin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_074_implement_asin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_074_implement_asin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-74.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 75:实现最低价 ASIN 列表和筛选
**所属模块**:ASIN 数据中心
**依赖**:74
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现最低价 ASIN 列表和筛选”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_075_implement_asin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_075_implement_asin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_075_implement_asin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_075_implement_asin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_075_implement_asin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_075_implement_asin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_075_implement_asin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_075_implement_asin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-75.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 76:实现最低价 ASIN 导入与删除导入
**所属模块**:ASIN 数据中心
**依赖**:75
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现最低价 ASIN 导入与删除导入”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_076_implement_asin__remove_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_076_implement_asin__remove_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_076_implement_asin__remove_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_076_implement_asin__remove_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_076_implement_asin__remove_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_076_implement_asin__remove_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_076_implement_asin__remove_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_076_implement_asin__remove_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-76.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 77:实现最低价 ASIN 详情编辑抽屉
**所属模块**:ASIN 数据中心
**依赖**:76
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现最低价 ASIN 详情编辑抽屉”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_077_implement_asin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_077_implement_asin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_077_implement_asin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_077_implement_asin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_077_implement_asin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_077_implement_asin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_077_implement_asin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_077_implement_asin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-77.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 78:实现商品类目树加载和搜索
**所属模块**:ASIN 数据中心
**依赖**:77
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现商品类目树加载和搜索”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_078_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_078_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_078_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_078_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_078_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_078_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_078_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_078_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-78.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 79:实现商品类目新增/编辑/导出
**所属模块**:ASIN 数据中心
**依赖**:78
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现商品类目新增/编辑/导出”:以 `src/pages/asin/` 各独立页面、上传/下载/轮询 composable 和共享分页类型 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories` 及对应旧 `admin.js` loader 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_079_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_079_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_079_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_079_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_079_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_079_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_079_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_079_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-79.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 80:完成 ASIN 数据中心真实流程验收
**所属模块**:ASIN 数据中心
**依赖**:79
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成 ASIN 数据中心真实流程验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_080_complete_asin_real_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_080_complete_asin_real_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_080_complete_asin_real_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_080_complete_asin_real_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_080_complete_asin_real_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_080_complete_asin_real_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_080_complete_asin_real_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_080_complete_asin_real_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-80.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。所有文件、轮询、导入和导出功能必须有 mock 测试与至少一次真实请求;禁止把大数据全部放进浏览器内存。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 61-80 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 05-shop-center:店铺中心任务计划
> 对应 Spec:`docs/specs/05-shop-center.md`。本文件是“店铺中心”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`panel-shop-keys`、`panel-shop-manage`、`admin.js:loadShopKeys/loadShopManage` 及 Java `ShopKeyController/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)
1. `test_task_081_define__dto_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_081_define__dto_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_081_define__dto_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_081_define__dto_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_081_define__dto_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_081_define__dto_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_081_define__dto_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_081_define__dto_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_082_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_082_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_082_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_082_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_082_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_082_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_082_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_082_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_083_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_083_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_083_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_083_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_083_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_083_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_083_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_083_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_084_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_084_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_084_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_084_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_084_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_084_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_084_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_084_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_085_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_085_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_085_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_085_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_085_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_085_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_085_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_085_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_086_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_086_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_086_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_086_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_086_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_086_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_086_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_086_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_087_implementremoveconfirm_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_087_implementremoveconfirm_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_087_implementremoveconfirm_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_087_implementremoveconfirm_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_087_implementremoveconfirm_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_087_implementremoveconfirm_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_087_implementremoveconfirm_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_087_implementremoveconfirm_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_088_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_088_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_088_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_088_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_088_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_088_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_088_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_088_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_089_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_089_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_089_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_089_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_089_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_089_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_089_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_089_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_090_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_090_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_090_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_090_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_090_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_090_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_090_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_090_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_091_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_091_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_091_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_091_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_091_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_091_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_091_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_091_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_092_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_092_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_092_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_092_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_092_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_092_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_092_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_092_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_093_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_093_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_093_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_093_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_093_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_093_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_093_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_093_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_094_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_094_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_094_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_094_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_094_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_094_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_094_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_094_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_095_implementremoveconfirm_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_095_implementremoveconfirm_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_095_implementremoveconfirm_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_095_implementremoveconfirm_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_095_implementremoveconfirm_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_095_implementremoveconfirm_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_095_implementremoveconfirm_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_095_implementremoveconfirm_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_096_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_096_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_096_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_096_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_096_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_096_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_096_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_096_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_097_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_097_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_097_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_097_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_097_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_097_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_097_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_097_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_098_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_098_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_098_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_098_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_098_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_098_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_098_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_098_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_099_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_099_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_099_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_099_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_099_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_099_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_099_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_099_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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)
1. `test_task_100_completereal_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_100_completereal_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_100_completereal_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_100_completereal_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_100_completereal_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_100_completereal_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_100_completereal_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_100_completereal_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 06-task-and-duplicate-center:任务与重复分析中心任务计划
> 对应 Spec:`docs/specs/06-task-and-duplicate-center.md`。本文件是“任务与重复分析中心”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*`。
- 目标实现边界:`src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图。
- 默认验证命令:`cd admin-frontend-vue; npm test`、`npm run build`;下载和轮询增加真实 Java 请求。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:101-120。
- 前置依赖:任务 100;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 101:定义统一任务状态和结果文件类型
**所属模块**:任务与重复分析中心
**依赖**:100
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义统一任务状态和结果文件类型”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_101_define_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_101_define_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_101_define_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_101_define_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_101_define_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_101_define_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_101_define_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_101_define_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-101.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 102:实现视频任务筛选状态
**所属模块**:任务与重复分析中心
**依赖**:101
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现视频任务筛选状态”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_102_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_102_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_102_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_102_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_102_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_102_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_102_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_102_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-102.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 103:实现视频任务列表/卡片加载
**所属模块**:任务与重复分析中心
**依赖**:102
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现视频任务列表/卡片加载”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_103_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_103_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_103_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_103_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_103_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_103_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_103_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_103_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-103.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 104:实现视频任务详情展示
**所属模块**:任务与重复分析中心
**依赖**:103
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现视频任务详情展示”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_104_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_104_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_104_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_104_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_104_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_104_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_104_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_104_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-104.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 105:实现视频任务批量选择
**所属模块**:任务与重复分析中心
**依赖**:104
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现视频任务批量选择”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_105_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_105_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_105_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_105_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_105_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_105_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_105_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_105_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-105.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 106:实现视频任务批量下载任务
**所属模块**:任务与重复分析中心
**依赖**:105
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现视频任务批量下载任务”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_106_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_106_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_106_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_106_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_106_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_106_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_106_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_106_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-106.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 107:实现视频任务下载失败摘要
**所属模块**:任务与重复分析中心
**依赖**:106
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现视频任务下载失败摘要”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_107_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_107_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_107_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_107_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_107_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_107_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_107_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_107_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-107.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 108:实现视频任务数据范围配置
**所属模块**:任务与重复分析中心
**依赖**:107
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现视频任务数据范围配置”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_108_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_108_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_108_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_108_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_108_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_108_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_108_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_108_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-108.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 109:实现店铺数据任务筛选
**所属模块**:任务与重复分析中心
**依赖**:108
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现店铺数据任务筛选”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_109_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_109_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_109_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_109_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_109_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_109_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_109_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_109_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-109.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 110:实现店铺数据任务列表
**所属模块**:任务与重复分析中心
**依赖**:109
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现店铺数据任务列表”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_110_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_110_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_110_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_110_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_110_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_110_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_110_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_110_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-110.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 111:实现店铺数据任务分页刷新
**所属模块**:任务与重复分析中心
**依赖**:110
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现店铺数据任务分页刷新”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_111_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_111_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_111_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_111_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_111_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_111_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_111_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_111_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-111.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 112:实现店铺数据任务批量选择
**所属模块**:任务与重复分析中心
**依赖**:111
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现店铺数据任务批量选择”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_112_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_112_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_112_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_112_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_112_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_112_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_112_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_112_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-112.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 113:实现店铺数据任务批量下载
**所属模块**:任务与重复分析中心
**依赖**:112
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现店铺数据任务批量下载”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_113_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_113_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_113_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_113_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_113_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_113_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_113_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_113_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-113.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 114:实现店铺数据任务权限配置
**所属模块**:任务与重复分析中心
**依赖**:113
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现店铺数据任务权限配置”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_114_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_114_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_114_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_114_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_114_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_114_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_114_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_114_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-114.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 115:实现重复检查总览指标
**所属模块**:任务与重复分析中心
**依赖**:114
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现重复检查总览指标”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_115_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_115_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_115_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_115_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_115_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_115_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_115_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_115_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-115.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 116:实现重复检查分布视图
**所属模块**:任务与重复分析中心
**依赖**:115
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现重复检查分布视图”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_116_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_116_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_116_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_116_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_116_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_116_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_116_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_116_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-116.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 117:实现重复检查明细列表
**所属模块**:任务与重复分析中心
**依赖**:116
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现重复检查明细列表”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_117_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_117_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_117_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_117_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_117_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_117_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_117_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_117_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-117.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 118:实现重复检查详情抽屉
**所属模块**:任务与重复分析中心
**依赖**:117
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现重复检查详情抽屉”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_118_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_118_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_118_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_118_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_118_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_118_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_118_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_118_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-118.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 119:实现重复检查导入/导出状态
**所属模块**:任务与重复分析中心
**依赖**:118
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现重复检查导入/导出状态”:以 `src/pages/tasks/`,独立任务状态、批量下载、权限范围和重复分析视图 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-image-video-tasks`、`panel-shop-data-crawl-tasks`、`panel-shop-data-duplicate-check` 及旧 `load*Tasks/load*Duplicate*` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_119_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_119_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_119_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_119_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_119_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_119_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_119_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_119_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-119.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 120:完成任务与重复检查真实流程验收
**所属模块**:任务与重复分析中心
**依赖**:119
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成任务与重复检查真实流程验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_120_complete_real_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_120_complete_real_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_120_complete_real_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_120_complete_real_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_120_complete_real_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_120_complete_real_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_120_complete_real_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_120_complete_real_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-120.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。任务轮询、下载、导出和详情必须同时有 mock 和真实请求;页面卸载要验证定时器/AbortController 清理。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 101-120 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 07-records-and-version:记录与版本中心任务计划
> 对应 Spec:`docs/specs/07-records-and-version.md`。本文件是“记录与版本中心”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions`。
- 目标实现边界:`src/pages/records/`;后台版本管理和公开客户端版本接口分离。
- 默认验证命令:`cd admin-frontend-vue; npm test`、`npm run build`;版本接口使用 Java Maven 契约和真实 HTTP。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:121-140。
- 前置依赖:任务 120;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 121:定义历史记录 DTO
**所属模块**:记录与版本中心
**依赖**:120
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义历史记录 DTO”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_121_define_dto_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_121_define_dto_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_121_define_dto_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_121_define_dto_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_121_define_dto_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_121_define_dto_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_121_define_dto_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_121_define_dto_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-121.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 122:实现历史记录筛选条件
**所属模块**:记录与版本中心
**依赖**:121
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现历史记录筛选条件”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_122_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_122_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_122_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_122_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_122_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_122_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_122_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_122_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-122.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 123:实现历史记录分页加载
**所属模块**:记录与版本中心
**依赖**:122
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现历史记录分页加载”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_123_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_123_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_123_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_123_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_123_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_123_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_123_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_123_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-123.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 124:实现历史结果预览抽屉
**所属模块**:记录与版本中心
**依赖**:123
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现历史结果预览抽屉”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_124_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_124_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_124_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_124_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_124_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_124_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_124_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_124_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-124.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 125:实现历史记录空/错状态
**所属模块**:记录与版本中心
**依赖**:124
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现历史记录空/错状态”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_125_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_125_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_125_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_125_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_125_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_125_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_125_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_125_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-125.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 126:定义软件版本 DTO
**所属模块**:记录与版本中心
**依赖**:125
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义软件版本 DTO”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_126_define_dto_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_126_define_dto_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_126_define_dto_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_126_define_dto_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_126_define_dto_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_126_define_dto_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_126_define_dto_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_126_define_dto_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-126.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 127:实现软件版本列表加载
**所属模块**:记录与版本中心
**依赖**:126
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现软件版本列表加载”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_127_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_127_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_127_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_127_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_127_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_127_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_127_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_127_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-127.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 128:实现软件版本上传表单
**所属模块**:记录与版本中心
**依赖**:127
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现软件版本上传表单”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_128_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_128_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_128_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_128_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_128_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_128_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_128_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_128_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-128.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 129:实现软件版本上传进度和错误
**所属模块**:记录与版本中心
**依赖**:128
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现软件版本上传进度和错误”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_129_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_129_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_129_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_129_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_129_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_129_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_129_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_129_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-129.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 130:实现软件版本下载链接展示
**所属模块**:记录与版本中心
**依赖**:129
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现软件版本下载链接展示”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_130_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_130_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_130_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_130_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_130_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_130_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_130_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_130_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-130.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 131:定义数字人版本 DTO
**所属模块**:记录与版本中心
**依赖**:130
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义数字人版本 DTO”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_131_define_dto_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_131_define_dto_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_131_define_dto_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_131_define_dto_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_131_define_dto_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_131_define_dto_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_131_define_dto_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_131_define_dto_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-131.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 132:实现数字人版本列表加载
**所属模块**:记录与版本中心
**依赖**:131
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现数字人版本列表加载”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_132_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_132_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_132_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_132_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_132_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_132_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_132_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_132_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-132.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 133:实现数字人版本上传
**所属模块**:记录与版本中心
**依赖**:132
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现数字人版本上传”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_133_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_133_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_133_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_133_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_133_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_133_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_133_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_133_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-133.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 134:实现数字人版本状态展示
**所属模块**:记录与版本中心
**依赖**:133
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现数字人版本状态展示”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_134_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_134_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_134_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_134_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_134_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_134_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_134_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_134_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-134.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 135:实现数字人版本发布操作
**所属模块**:记录与版本中心
**依赖**:134
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现数字人版本发布操作”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_135_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_135_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_135_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_135_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_135_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_135_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_135_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_135_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-135.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 136:实现数字人版本设为最新操作
**所属模块**:记录与版本中心
**依赖**:135
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现数字人版本设为最新操作”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_136_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_136_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_136_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_136_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_136_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_136_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_136_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_136_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-136.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 137:实现版本页面统一时间和文件格式化
**所属模块**:记录与版本中心
**依赖**:136
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现版本页面统一时间和文件格式化”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_137_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_137_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_137_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_137_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_137_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_137_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_137_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_137_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-137.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 138:实现版本页面权限路由接入
**所属模块**:记录与版本中心
**依赖**:137
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现版本页面权限路由接入”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_138_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_138_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_138_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_138_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_138_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_138_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_138_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_138_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-138.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 139:实现客户端公开版本接口回归夹具
**所属模块**:记录与版本中心
**依赖**:138
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现客户端公开版本接口回归夹具”:以 `src/pages/records/`;后台版本管理和公开客户端版本接口分离 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `panel-history`、`panel-version`、`panel-digital-human-version` 及旧 `loadHistory/loadSoftwareVersions/loadDigitalHumanVersions` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_139_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_139_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_139_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_139_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_139_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_139_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_139_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_139_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-139.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 140:完成记录与版本中心真实流程验收
**所属模块**:记录与版本中心
**依赖**:139
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成记录与版本中心真实流程验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_140_complete_real_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_140_complete_real_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_140_complete_real_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_140_complete_real_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_140_complete_real_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_140_complete_real_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_140_complete_real_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_140_complete_real_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `admin-frontend-vue` 执行 `npm test -- tests/task-140.test.ts`、`npm run build`;涉及真实接口时按模块配置启动 Java 并执行 curl/Playwright。上传、下载、数据库读取和公开版本接口必须有 mock 加真实集成验证;不得修改客户端公开字段。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 121-140 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 08-java-menu-and-flyway:Java 菜单树与 Flyway 权限迁移任务计划
> 对应 Spec:`docs/specs/08-java-menu-and-flyway.md`。本文件是“Java 菜单树与 Flyway 权限迁移”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer`。
- 目标实现边界:Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移。
- 默认验证命令:`cd backend-java; mvn test`、`mvn -DskipTests compile`;数据库任务使用真实测试库/迁移集成测试。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:141-160。
- 前置依赖:任务 140;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 141:冻结 Java 菜单树响应 DTO
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:140
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
把 Java 菜单树响应 DTO 固化为可测试契约:定义合法输入、默认值、边界、错误语义和兼容约束;契约必须能被 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 直接消费,并明确禁止的旧行为。
### 测试用例(必须先写,确认 RED)
1. `test_task_141_freeze_java__dto_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_141_freeze_java__dto_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_141_freeze_java__dto_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_141_freeze_java__dto_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_141_freeze_java__dto_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_141_freeze_java__dto_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_141_freeze_java__dto_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_141_freeze_java__dto_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task141Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 142:定义 menu_type=admin 过滤规则
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:141
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 menu_type=admin 过滤规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_142_define_menu_typeadmin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_142_define_menu_typeadmin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_142_define_menu_typeadmin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_142_define_menu_typeadmin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_142_define_menu_typeadmin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_142_define_menu_typeadmin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_142_define_menu_typeadmin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_142_define_menu_typeadmin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task142Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 143:实现有效菜单节点索引
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:142
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现有效菜单节点索引”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_143_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_143_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_143_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_143_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_143_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_143_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_143_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_143_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task143Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 144:实现 parent_id 树组装
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:143
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现 parent_id 树组装”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_144_implement_parent_id_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_144_implement_parent_id_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_144_implement_parent_id_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_144_implement_parent_id_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_144_implement_parent_id_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_144_implement_parent_id_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_144_implement_parent_id_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_144_implement_parent_id_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task144Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 145:实现菜单 sort_order 排序
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:144
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现菜单 sort_order 排序”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_145_implement_sort_order_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_145_implement_sort_order_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_145_implement_sort_order_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_145_implement_sort_order_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_145_implement_sort_order_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_145_implement_sort_order_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_145_implement_sort_order_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_145_implement_sort_order_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task145Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 146:实现空父节点和脏数据处理
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:145
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现空父节点和脏数据处理”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_146_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_146_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_146_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_146_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_146_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_146_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_146_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_146_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task146Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 147:实现分组节点 route 处理
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:146
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现分组节点 route 处理”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_147_implement_route_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_147_implement_route_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_147_implement_route_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_147_implement_route_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_147_implement_route_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_147_implement_route_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_147_implement_route_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_147_implement_route_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task147Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 148:实现页面节点 route 输出
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:147
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现页面节点 route 输出”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_148_implement_route_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_148_implement_route_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_148_implement_route_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_148_implement_route_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_148_implement_route_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_148_implement_route_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_148_implement_route_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_148_implement_route_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task148Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 149:实现 column_key 到 key 映射
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:148
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现 column_key 到 key 映射”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_149_implement_column_key__key_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_149_implement_column_key__key_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_149_implement_column_key__key_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_149_implement_column_key__key_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_149_implement_column_key__key_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_149_implement_column_key__key_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_149_implement_column_key__key_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_149_implement_column_key__key_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task149Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 150:实现当前用户菜单树控制器响应
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:149
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现当前用户菜单树控制器响应”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_150_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_150_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_150_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_150_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_150_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_150_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_150_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_150_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task150Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 151:覆盖超级管理员菜单树
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:150
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“覆盖超级管理员菜单树”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_151_feature_point_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_151_feature_point_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_151_feature_point_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_151_feature_point_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_151_feature_point_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_151_feature_point_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_151_feature_point_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_151_feature_point_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task151Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 152:覆盖普通管理员菜单树
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:151
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“覆盖普通管理员菜单树”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_152_feature_point_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_152_feature_point_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_152_feature_point_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_152_feature_point_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_152_feature_point_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_152_feature_point_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_152_feature_point_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_152_feature_point_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task152Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 153:覆盖无权限用户菜单树
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:152
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“覆盖无权限用户菜单树”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_153_feature_point_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_153_feature_point_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_153_feature_point_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_153_feature_point_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_153_feature_point_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_153_feature_point_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_153_feature_point_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_153_feature_point_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task153Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 154:定义 route_path Flyway 迁移矩阵
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:153
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 route_path Flyway 迁移矩阵”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_154_define_route_path_flyway_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_154_define_route_path_flyway_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_154_define_route_path_flyway_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_154_define_route_path_flyway_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_154_define_route_path_flyway_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_154_define_route_path_flyway_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_154_define_route_path_flyway_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_154_define_route_path_flyway_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task154Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 155:实现后台账号菜单 route 迁移
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:154
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现后台账号菜单 route 迁移”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_155_implement_route_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_155_implement_route_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_155_implement_route_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_155_implement_route_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_155_implement_route_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_155_implement_route_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_155_implement_route_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_155_implement_route_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task155Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 156:实现 ASIN 和店铺菜单 route 迁移
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:155
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现 ASIN 和店铺菜单 route 迁移”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_156_implement_asin___route_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_156_implement_asin___route_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_156_implement_asin___route_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_156_implement_asin___route_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_156_implement_asin___route_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_156_implement_asin___route_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_156_implement_asin___route_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_156_implement_asin___route_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task156Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 157:实现任务和记录菜单 route 迁移
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:156
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现任务和记录菜单 route 迁移”:以 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_157_implement__route_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_157_implement__route_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_157_implement__route_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_157_implement__route_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_157_implement__route_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_157_implement__route_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_157_implement__route_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_157_implement__route_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task157Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 158:验证 column_key 和授权关系不变
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:157
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证 column_key 和授权关系不变”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 与 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_158_verify_column_key_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_158_verify_column_key_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_158_verify_column_key_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_158_verify_column_key_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_158_verify_column_key_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_158_verify_column_key_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_158_verify_column_key_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_158_verify_column_key_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task158Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 159:验证 Flyway 唯一约束和幂等性
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:158
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证 Flyway 唯一约束和幂等性”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `PermissionMenuService`、`PermissionMenuController`、`AdminConsoleController.currentUserMenus`、`PermissionMenuSchemaInitializer` 与 Java 树形菜单 DTO、`column_key`/`route_path` 分离和 Flyway admin route 迁移 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_159_verify_flyway_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_159_verify_flyway_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_159_verify_flyway_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_159_verify_flyway_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_159_verify_flyway_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_159_verify_flyway_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_159_verify_flyway_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_159_verify_flyway_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task159Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 160:完成 Java 菜单树真实接口验收
**所属模块**:Java 菜单树与 Flyway 权限迁移
**依赖**:159
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成 Java 菜单树真实接口验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_160_complete_java_real_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_160_complete_java_real_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_160_complete_java_real_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_160_complete_java_real_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_160_complete_java_real_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_160_complete_java_real_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_160_complete_java_real_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_160_complete_java_real_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task160Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;涉及数据库的任务必须使用 mock mapper 测试和至少一个真实 Flyway/数据库集成测试。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 141-160 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 09-public-version-compatibility:客户端公开版本接口兼容任务计划
> 对应 Spec:`docs/specs/09-public-version-compatibility.md`。本文件是“客户端公开版本接口兼容”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService`。
- 目标实现边界:Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装。
- 默认验证命令:`cd backend-java; mvn test`;启动 Java 后用 `curl` 对 `/api/version*` 做真实请求。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:161-180。
- 前置依赖:任务 160;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 161:冻结 /api/version 响应契约
**所属模块**:客户端公开版本接口兼容
**依赖**:160
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
把 /api/version 响应契约 固化为可测试契约:定义合法输入、默认值、边界、错误语义和兼容约束;契约必须能被 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 直接消费,并明确禁止的旧行为。
### 测试用例(必须先写,确认 RED)
1. `test_task_161_freeze_public_version_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_161_freeze_public_version_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_161_freeze_public_version_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_161_freeze_public_version_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_161_freeze_public_version_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_161_freeze_public_version_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_161_freeze_public_version_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_161_freeze_public_version_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task161Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 162:冻结 /api/version/latest 响应契约
**所属模块**:客户端公开版本接口兼容
**依赖**:161
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
把 /api/version/latest 响应契约 固化为可测试契约:定义合法输入、默认值、边界、错误语义和兼容约束;契约必须能被 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 直接消费,并明确禁止的旧行为。
### 测试用例(必须先写,确认 RED)
1. `test_task_162_freeze_public_version_latest_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_162_freeze_public_version_latest_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_162_freeze_public_version_latest_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_162_freeze_public_version_latest_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_162_freeze_public_version_latest_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_162_freeze_public_version_latest_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_162_freeze_public_version_latest_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_162_freeze_public_version_latest_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task162Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 163:定义 web_config 最新记录排序规则
**所属模块**:客户端公开版本接口兼容
**依赖**:162
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 web_config 最新记录排序规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_163_define_web_config_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_163_define_web_config_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_163_define_web_config_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_163_define_web_config_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_163_define_web_config_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_163_define_web_config_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_163_define_web_config_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_163_define_web_config_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task163Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 164:实现 Java 当前版本配置读取
**所属模块**:客户端公开版本接口兼容
**依赖**:163
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现 Java 当前版本配置读取”:以 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_164_implement_java_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_164_implement_java_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_164_implement_java_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_164_implement_java_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_164_implement_java_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_164_implement_java_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_164_implement_java_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_164_implement_java_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task164Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 165:实现 Java 最新版本查询服务
**所属模块**:客户端公开版本接口兼容
**依赖**:164
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现 Java 最新版本查询服务”:以 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_165_implement_java_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_165_implement_java_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_165_implement_java_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_165_implement_java_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_165_implement_java_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_165_implement_java_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_165_implement_java_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_165_implement_java_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task165Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 166:实现空版本表 null 语义
**所属模块**:客户端公开版本接口兼容
**依赖**:165
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现空版本表 null 语义”:以 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_166_implement_null_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_166_implement_null_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_166_implement_null_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_166_implement_null_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_166_implement_null_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_166_implement_null_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_166_implement_null_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_166_implement_null_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task166Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 167:实现版本字段空字符串语义
**所属模块**:客户端公开版本接口兼容
**依赖**:166
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现版本字段空字符串语义”:以 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_167_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_167_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_167_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_167_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_167_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_167_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_167_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_167_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task167Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 168:实现公开接口不使用 ApiResponse 包装
**所属模块**:客户端公开版本接口兼容
**依赖**:167
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现公开接口不使用 ApiResponse 包装”:以 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_168_implement_apiresponse_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_168_implement_apiresponse_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_168_implement_apiresponse_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_168_implement_apiresponse_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_168_implement_apiresponse_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_168_implement_apiresponse_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_168_implement_apiresponse_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_168_implement_apiresponse_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task168Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 169:实现版本接口数据库错误处理
**所属模块**:客户端公开版本接口兼容
**依赖**:168
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现版本接口数据库错误处理”:以 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_169_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_169_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_169_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_169_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_169_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_169_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_169_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_169_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task169Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 170:验证多版本记录取最新
**所属模块**:客户端公开版本接口兼容
**依赖**:169
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证多版本记录取最新”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 与 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_170_verify_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_170_verify_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_170_verify_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_170_verify_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_170_verify_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_170_verify_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_170_verify_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_170_verify_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task170Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 171:验证同时间记录按 id 稳定排序
**所属模块**:客户端公开版本接口兼容
**依赖**:170
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证同时间记录按 id 稳定排序”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 与 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_171_verify_id_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_171_verify_id_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_171_verify_id_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_171_verify_id_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_171_verify_id_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_171_verify_id_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_171_verify_id_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_171_verify_id_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task171Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 172:验证 file_url 原样返回
**所属模块**:客户端公开版本接口兼容
**依赖**:171
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证 file_url 原样返回”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 与 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_172_verify_file_url_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_172_verify_file_url_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_172_verify_file_url_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_172_verify_file_url_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_172_verify_file_url_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_172_verify_file_url_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_172_verify_file_url_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_172_verify_file_url_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task172Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 173:验证 desc/url 字段保留
**所属模块**:客户端公开版本接口兼容
**依赖**:172
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证 desc/url 字段保留”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 与 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_173_verify_desc_url_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_173_verify_desc_url_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_173_verify_desc_url_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_173_verify_desc_url_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_173_verify_desc_url_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_173_verify_desc_url_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_173_verify_desc_url_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_173_verify_desc_url_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task173Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 174:验证旧客户端请求路径不变
**所属模块**:客户端公开版本接口兼容
**依赖**:173
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证旧客户端请求路径不变”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 与 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_174_verify_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_174_verify_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_174_verify_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_174_verify_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_174_verify_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_174_verify_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_174_verify_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_174_verify_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task174Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 175:验证公开接口与后台上传解耦
**所属模块**:客户端公开版本接口兼容
**依赖**:174
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证公开接口与后台上传解耦”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 与 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_175_verify_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_175_verify_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_175_verify_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_175_verify_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_175_verify_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_175_verify_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_175_verify_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_175_verify_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task175Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 176:验证 Java 接口替代 Flask 后响应一致
**所属模块**:客户端公开版本接口兼容
**依赖**:175
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证 Java 接口替代 Flask 后响应一致”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 与 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_176_verify_java__flask_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_176_verify_java__flask_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_176_verify_java__flask_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_176_verify_java__flask_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_176_verify_java__flask_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_176_verify_java__flask_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_176_verify_java__flask_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_176_verify_java__flask_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task176Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 177:补充版本接口控制器测试
**所属模块**:客户端公开版本接口兼容
**依赖**:176
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“补充版本接口控制器测试”:以 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_177_feature_point_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_177_feature_point_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_177_feature_point_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_177_feature_point_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_177_feature_point_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_177_feature_point_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_177_feature_point_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_177_feature_point_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task177Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 178:补充版本接口数据库集成测试
**所属模块**:客户端公开版本接口兼容
**依赖**:177
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“补充版本接口数据库集成测试”:以 Java `PublicVersionController` 和 `latestSoftwareVersion`,保持无 ApiResponse 包装 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/version.py:api_version/api_version_latest`、`web_config`、Java `SoftwareVersionService` 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_178_feature_point_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_178_feature_point_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_178_feature_point_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_178_feature_point_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_178_feature_point_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_178_feature_point_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_178_feature_point_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_178_feature_point_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task178Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 179:完成真实客户端更新链路 smoke
**所属模块**:客户端公开版本接口兼容
**依赖**:178
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成真实客户端更新链路 smoke”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_179_completereal_smoke_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_179_completereal_smoke_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_179_completereal_smoke_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_179_completereal_smoke_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_179_completereal_smoke_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_179_completereal_smoke_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_179_completereal_smoke_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_179_completereal_smoke_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task179Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 180:完成 Flask 版本蓝图删除前置验收
**所属模块**:客户端公开版本接口兼容
**依赖**:179
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成 Flask 版本蓝图删除前置验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_180_complete_flask_remove_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_180_complete_flask_remove_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_180_complete_flask_remove_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_180_complete_flask_remove_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_180_complete_flask_remove_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_180_complete_flask_remove_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_180_complete_flask_remove_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_180_complete_flask_remove_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
在 `backend-java` 执行 `mvn -q -Dtest=Task180Test test` 或对应测试类,再执行 `mvn -q -DskipTests compile`;必须比较 Flask 基线响应与 Java 响应;数据库空表、多版本和错误路径都要真实验证。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 161-180 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 10-static-deployment-nginx:静态资源部署与 Nginx History 托管任务计划
> 对应 Spec:`docs/specs/10-static-deployment-nginx.md`。本文件是“静态资源部署与 Nginx History 托管”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则。
- 目标实现边界:`admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream。
- 默认验证命令:`npm run build`、`nginx -t`、`curl -i`;本地无 Nginx 时使用容器/测试配置完成真实 HTTP 验证。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:181-200。
- 前置依赖:任务 180;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 181:确认后台 dist 发布目录约定
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:180
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
检查 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream,不得修改无关模块。
### 测试用例(必须先写,确认 RED)
1. `test_task_181_confirm_dist_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_181_confirm_dist_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_181_confirm_dist_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_181_confirm_dist_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_181_confirm_dist_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_181_confirm_dist_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_181_confirm_dist_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_181_confirm_dist_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 182:确认 Vite base 和 Router base 一致
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:181
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
检查 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream,不得修改无关模块。
### 测试用例(必须先写,确认 RED)
1. `test_task_182_confirm_vite_base___router_base_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_182_confirm_vite_base___router_base_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_182_confirm_vite_base___router_base_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_182_confirm_vite_base___router_base_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_182_confirm_vite_base___router_base_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_182_confirm_vite_base___router_base_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_182_confirm_vite_base___router_base_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_182_confirm_vite_base___router_base_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 183:定义 index.html 缓存策略
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:182
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 index.html 缓存策略”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_183_define_indexhtml_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_183_define_indexhtml_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_183_define_indexhtml_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_183_define_indexhtml_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_183_define_indexhtml_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_183_define_indexhtml_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_183_define_indexhtml_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_183_define_indexhtml_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 184:定义 hashed assets 缓存策略
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:183
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 hashed assets 缓存策略”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_184_define_hashed_assets_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_184_define_hashed_assets_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_184_define_hashed_assets_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_184_define_hashed_assets_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_184_define_hashed_assets_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_184_define_hashed_assets_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_184_define_hashed_assets_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_184_define_hashed_assets_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 185:定义 /admin 重定向规则
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:184
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 /admin 重定向规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_185_define__admin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_185_define__admin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_185_define__admin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_185_define__admin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_185_define__admin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_185_define__admin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_185_define__admin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_185_define__admin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 186:定义 /admin-vue/ 静态 location
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:185
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 /admin-vue/ 静态 location”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_186_define_admin_vue__location_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_186_define_admin_vue__location_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_186_define_admin_vue__location_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_186_define_admin_vue__location_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_186_define_admin_vue__location_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_186_define_admin_vue__location_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_186_define_admin_vue__location_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_186_define_admin_vue__location_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 187:定义 assets 优先匹配规则
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:186
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 assets 优先匹配规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_187_define_assets_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_187_define_assets_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_187_define_assets_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_187_define_assets_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_187_define_assets_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_187_define_assets_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_187_define_assets_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_187_define_assets_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 188:定义 History fallback 规则
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:187
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 History fallback 规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_188_define_history_fallback_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_188_define_history_fallback_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_188_define_history_fallback_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_188_define_history_fallback_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_188_define_history_fallback_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_188_define_history_fallback_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_188_define_history_fallback_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_188_define_history_fallback_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 189:定义静态资源 404 规则
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:188
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义静态资源 404 规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_189_define_404_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_189_define_404_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_189_define_404_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_189_define_404_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_189_define_404_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_189_define_404_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_189_define_404_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_189_define_404_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 190:定义 /api/ Java upstream 代理
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:189
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 /api/ Java upstream 代理”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_190_define__api__java_upstream_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_190_define__api__java_upstream_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_190_define__api__java_upstream_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_190_define__api__java_upstream_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_190_define__api__java_upstream_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_190_define__api__java_upstream_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_190_define__api__java_upstream_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_190_define__api__java_upstream_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 191:定义 Cookie 和转发请求头规则
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:190
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义 Cookie 和转发请求头规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_191_define_cookie_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_191_define_cookie_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_191_define_cookie_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_191_define_cookie_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_191_define_cookie_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_191_define_cookie_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_191_define_cookie_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_191_define_cookie_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 192:定义临时发布目录结构
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:191
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义临时发布目录结构”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_192_define_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_192_define_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_192_define_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_192_define_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_192_define_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_192_define_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_192_define_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_192_define_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 193:定义原子切换和回滚结构
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:192
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
为“定义原子切换和回滚结构”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。
### 测试用例(必须先写,确认 RED)
1. `test_task_193_define_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_193_define_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_193_define_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_193_define_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_193_define_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_193_define_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_193_define_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_193_define_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 194:实现构建产物清单校验
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:193
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现构建产物清单校验”:以 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_194_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_194_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_194_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_194_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_194_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_194_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_194_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_194_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 195:实现静态资源 MIME 验证
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:194
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现静态资源 MIME 验证”:以 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_195_implement_mime_verify_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_195_implement_mime_verify_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_195_implement_mime_verify_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_195_implement_mime_verify_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_195_implement_mime_verify_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_195_implement_mime_verify_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_195_implement_mime_verify_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_195_implement_mime_verify_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 196:实现桌面路由刷新验收脚本
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:195
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现桌面路由刷新验收脚本”:以 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_196_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_196_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_196_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_196_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_196_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_196_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_196_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_196_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 197:实现不存在资源 404 验收脚本
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:196
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“实现不存在资源 404 验收脚本”:以 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_197_implement_404_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_197_implement_404_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_197_implement_404_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_197_implement_404_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_197_implement_404_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_197_implement_404_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_197_implement_404_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_197_implement_404_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 198:验证生产 base URL 引用完整
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:197
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证生产 base URL 引用完整”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 与 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_198_verify_base_url_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_198_verify_base_url_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_198_verify_base_url_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_198_verify_base_url_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_198_verify_base_url_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_198_verify_base_url_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_198_verify_base_url_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_198_verify_base_url_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 199:验证 Nginx 与 Java API 联通
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:198
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证 Nginx 与 Java API 联通”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 与 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_199_verify_nginx___java_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_199_verify_nginx___java_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_199_verify_nginx___java_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_199_verify_nginx___java_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_199_verify_nginx___java_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_199_verify_nginx___java_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_199_verify_nginx___java_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_199_verify_nginx___java_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 200:完成真实 Nginx 部署 smoke
**所属模块**:静态资源部署与 Nginx History 托管
**依赖**:199
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成真实 Nginx 部署 smoke”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_200_completereal_nginx__smoke_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_200_completereal_nginx__smoke_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_200_completereal_nginx__smoke_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_200_completereal_nginx__smoke_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_200_completereal_nginx__smoke_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_200_completereal_nginx__smoke_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_200_completereal_nginx__smoke_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_200_completereal_nginx__smoke_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 181-200 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 11-flask-removal-cutover:Flask 管理能力移除与入口切换任务计划
> 对应 Spec:`docs/specs/11-flask-removal-cutover.md`。本文件是“Flask 管理能力移除与入口切换”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:`backend/blueprints/main.py`、`admin_api.py`、`version.py`、旧 admin 模板/脚本和 Java static 副本。
- 目标实现边界:Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口。
- 默认验证命令:`rg` 依赖扫描、`cd backend-java; mvn test`、真实 Java/Nginx `curl`;Python 其他插件 API 需单独回归。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:201-220。
- 前置依赖:任务 200;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 201:盘点 Flask 管理页面和 API 流量
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:200
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“盘点 Flask 管理页面和 API 流量”:以 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/main.py`、`admin_api.py`、`version.py`、旧 admin 模板/脚本和 Java static 副本 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_201_flask___api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_201_flask___api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_201_flask___api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_201_flask___api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_201_flask___api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_201_flask___api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_201_flask___api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_201_flask___api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 202:盘点 Flask 版本接口调用方
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:201
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“盘点 Flask 版本接口调用方”:以 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/main.py`、`admin_api.py`、`version.py`、旧 admin 模板/脚本和 Java static 副本 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_202_flask_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_202_flask_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_202_flask_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_202_flask_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_202_flask_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_202_flask_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_202_flask_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_202_flask_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 203:冻结 Flask 删除清单
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:202
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
把 Flask 删除清单 固化为可测试契约:定义合法输入、默认值、边界、错误语义和兼容约束;契约必须能被 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 直接消费,并明确禁止的旧行为。
### 测试用例(必须先写,确认 RED)
1. `test_task_203_freeze_flask_remove_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_203_freeze_flask_remove_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_203_freeze_flask_remove_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_203_freeze_flask_remove_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_203_freeze_flask_remove_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_203_freeze_flask_remove_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_203_freeze_flask_remove_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_203_freeze_flask_remove_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 204:确认 Java 管理 API 覆盖矩阵
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:203
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
检查 `backend/blueprints/main.py`、`admin_api.py`、`version.py`、旧 admin 模板/脚本和 Java static 副本 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口,不得修改无关模块。
### 测试用例(必须先写,确认 RED)
1. `test_task_204_confirm_java__api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_204_confirm_java__api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_204_confirm_java__api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_204_confirm_java__api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_204_confirm_java__api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_204_confirm_java__api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_204_confirm_java__api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_204_confirm_java__api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 205:确认 Vue 页面覆盖矩阵
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:204
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
检查 `backend/blueprints/main.py`、`admin_api.py`、`version.py`、旧 admin 模板/脚本和 Java static 副本 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口,不得修改无关模块。
### 测试用例(必须先写,确认 RED)
1. `test_task_205_confirm_vue_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_205_confirm_vue_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_205_confirm_vue_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_205_confirm_vue_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_205_confirm_vue_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_205_confirm_vue_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_205_confirm_vue_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_205_confirm_vue_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 206:完成旧后台权限快照
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:205
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成旧后台权限快照”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_206_complete_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_206_complete_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_206_complete_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_206_complete_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_206_complete_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_206_complete_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_206_complete_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_206_complete_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 207:完成旧后台 API 响应快照
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:206
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成旧后台 API 响应快照”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_207_complete_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_207_complete_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_207_complete_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_207_complete_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_207_complete_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_207_complete_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_207_complete_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_207_complete_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 208:完成 Java 菜单树回归
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:207
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成 Java 菜单树回归”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_208_complete_java_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_208_complete_java_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_208_complete_java_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_208_complete_java_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_208_complete_java_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_208_complete_java_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_208_complete_java_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_208_complete_java_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 209:完成 Java 公开版本回归
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:208
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成 Java 公开版本回归”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_209_complete_java_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_209_complete_java_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_209_complete_java_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_209_complete_java_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_209_complete_java_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_209_complete_java_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_209_complete_java_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_209_complete_java_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 210:完成 Nginx /admin-vue 回归
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:209
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成 Nginx /admin-vue 回归”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_210_complete_nginx__admin_vue_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_210_complete_nginx__admin_vue_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_210_complete_nginx__admin_vue_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_210_complete_nginx__admin_vue_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_210_complete_nginx__admin_vue_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_210_complete_nginx__admin_vue_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_210_complete_nginx__admin_vue_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_210_complete_nginx__admin_vue_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 211:切换 /admin 到 /admin-vue
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:210
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“切换 /admin 到 /admin-vue”:以 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/main.py`、`admin_api.py`、`version.py`、旧 admin 模板/脚本和 Java static 副本 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_211_admin___admin_vue_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_211_admin___admin_vue_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_211_admin___admin_vue_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_211_admin___admin_vue_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_211_admin___admin_vue_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_211_admin___admin_vue_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_211_admin___admin_vue_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_211_admin___admin_vue_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 212:验证旧 admin 页面无生产流量
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:211
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证旧 admin 页面无生产流量”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `backend/blueprints/main.py`、`admin_api.py`、`version.py`、旧 admin 模板/脚本和 Java static 副本 与 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_212_verify_admin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_212_verify_admin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_212_verify_admin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_212_verify_admin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_212_verify_admin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_212_verify_admin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_212_verify_admin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_212_verify_admin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 213:停止 Flask 管理路由注册
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:212
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“停止 Flask 管理路由注册”:以 Java + Nginx + Vue 单一后台链路;仅保留 Java 公开版本接口 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `backend/blueprints/main.py`、`admin_api.py`、`version.py`、旧 admin 模板/脚本和 Java static 副本 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_213_flask_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_213_flask_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_213_flask_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_213_flask_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_213_flask_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_213_flask_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_213_flask_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_213_flask_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 214:删除 Flask admin blueprint
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:213
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
删除“ Flask admin blueprint”前先完成引用扫描和替代实现验证;删除后编译、测试和真实请求必须仍通过,且不能误删客户端更新接口或其他非后台 Flask API。
### 测试用例(必须先写,确认 RED)
1. `test_task_214_remove_flask_admin_blueprint_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_214_remove_flask_admin_blueprint_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_214_remove_flask_admin_blueprint_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_214_remove_flask_admin_blueprint_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_214_remove_flask_admin_blueprint_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_214_remove_flask_admin_blueprint_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_214_remove_flask_admin_blueprint_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_214_remove_flask_admin_blueprint_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 215:删除 Flask 管理页面模板
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:214
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
删除“ Flask 管理页面模板”前先完成引用扫描和替代实现验证;删除后编译、测试和真实请求必须仍通过,且不能误删客户端更新接口或其他非后台 Flask API。
### 测试用例(必须先写,确认 RED)
1. `test_task_215_remove_flask_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_215_remove_flask_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_215_remove_flask_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_215_remove_flask_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_215_remove_flask_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_215_remove_flask_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_215_remove_flask_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_215_remove_flask_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 216:删除旧 admin.js 和 interactions.js
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:215
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
删除“旧 admin.js 和 interactions.js”前先完成引用扫描和替代实现验证;删除后编译、测试和真实请求必须仍通过,且不能误删客户端更新接口或其他非后台 Flask API。
### 测试用例(必须先写,确认 RED)
1. `test_task_216_remove_adminjs___interactionsjs_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_216_remove_adminjs___interactionsjs_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_216_remove_adminjs___interactionsjs_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_216_remove_adminjs___interactionsjs_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_216_remove_adminjs___interactionsjs_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_216_remove_adminjs___interactionsjs_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_216_remove_adminjs___interactionsjs_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_216_remove_adminjs___interactionsjs_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 217:删除 Java static 旧后台副本
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:216
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
删除“ Java static 旧后台副本”前先完成引用扫描和替代实现验证;删除后编译、测试和真实请求必须仍通过,且不能误删客户端更新接口或其他非后台 Flask API。
### 测试用例(必须先写,确认 RED)
1. `test_task_217_remove_java_static_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_217_remove_java_static_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_217_remove_java_static_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_217_remove_java_static_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_217_remove_java_static_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_217_remove_java_static_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_217_remove_java_static_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_217_remove_java_static_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 218:清理旧菜单扁平响应逻辑
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:217
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
清理“旧菜单扁平响应逻辑”的残余引用、配置和文档,并用搜索、构建和真实请求证明目标链路只剩 Java + Vue + Nginx;对外兼容接口除外。
### 测试用例(必须先写,确认 RED)
1. `test_task_218_cleanup_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_218_cleanup_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_218_cleanup_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_218_cleanup_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_218_cleanup_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_218_cleanup_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_218_cleanup_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_218_cleanup_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 219:清理部署和文档旧入口引用
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:218
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
清理“部署和文档旧入口引用”的残余引用、配置和文档,并用搜索、构建和真实请求证明目标链路只剩 Java + Vue + Nginx;对外兼容接口除外。
### 测试用例(必须先写,确认 RED)
1. `test_task_219_cleanup_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_219_cleanup_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_219_cleanup_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_219_cleanup_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_219_cleanup_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_219_cleanup_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_219_cleanup_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_219_cleanup_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 220:完成 Flask 管理移除后真实 HTTP 验收
**所属模块**:Flask 管理能力移除与入口切换
**依赖**:219
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
完成“完成 Flask 管理移除后真实 HTTP 验收”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。
### 测试用例(必须先写,确认 RED)
1. `test_task_220_complete_flask_real_http_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_220_complete_flask_real_http_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_220_complete_flask_real_http_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_220_complete_flask_real_http_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_220_complete_flask_real_http_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_220_complete_flask_real_http_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_220_complete_flask_real_http_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_220_complete_flask_real_http_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `rg` 引用扫描、Java `mvn test` 和目标服务真实 `curl`;删除前必须有流量/接口快照;删除后必须真实启动目标服务并验证管理和客户端版本路径。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 201-220 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,766 @@
# 12-testing-acceptance:测试、回归与最终验收任务计划
> 对应 Spec:`docs/specs/12-testing-acceptance.md`。本文件是“测试、回归与最终验收”的独立执行计划,任务必须按编号串行完成。
## 模块范围
- 当前实现基线:所有前置模块的测试、构建、部署和真实 HTTP 产物。
- 目标实现边界:独立后台前端测试门禁、Java 契约门禁、Nginx/Playwright smoke、最终 check_progress。
- 默认验证命令:`npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py`。
- 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。
## 模块依赖
- 本模块任务范围:221-240。
- 前置依赖:任务 220;跨模块依赖必须以总计划中的完成状态为准。
- 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。
## 统一测试与准出规则
每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。
## 任务 221:建立独立后台前端测试命令
**所属模块**:测试、回归与最终验收
**依赖**:220
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立独立后台前端测试命令”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_221_establish_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_221_establish_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_221_establish_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_221_establish_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_221_establish_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_221_establish_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_221_establish_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_221_establish_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 222:建立后台前端类型检查门禁
**所属模块**:测试、回归与最终验收
**依赖**:221
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立后台前端类型检查门禁”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_222_establish_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_222_establish_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_222_establish_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_222_establish_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_222_establish_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_222_establish_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_222_establish_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_222_establish_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 223:建立后台前端构建门禁
**所属模块**:测试、回归与最终验收
**依赖**:222
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立后台前端构建门禁”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_223_establish_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_223_establish_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_223_establish_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_223_establish_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_223_establish_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_223_establish_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_223_establish_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_223_establish_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 224:真实启动 Java 后端并验证健康检查
**所属模块**:测试、回归与最终验收
**依赖**:223
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
使用真实运行环境执行“真实启动 Java 后端并验证健康检查”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。
### 测试用例(必须先写,确认 RED)
1. `test_task_224_real_java_verify_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_224_real_java_verify_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_224_real_java_verify_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_224_real_java_verify_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_224_real_java_verify_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_224_real_java_verify_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_224_real_java_verify_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_224_real_java_verify_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 225:真实访问 /admin 与 /admin-vue 页面入口
**所属模块**:测试、回归与最终验收
**依赖**:224
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
使用真实运行环境执行“真实访问 /admin 与 /admin-vue 页面入口”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。
### 测试用例(必须先写,确认 RED)
1. `test_task_225_real__admin____admin_vue_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_225_real__admin____admin_vue_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_225_real__admin____admin_vue_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_225_real__admin____admin_vue_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_225_real__admin____admin_vue_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_225_real__admin____admin_vue_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_225_real__admin____admin_vue_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_225_real__admin____admin_vue_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 226:真实执行首批菜单加载与用户查询交互
**所属模块**:测试、回归与最终验收
**依赖**:225
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
使用真实运行环境执行“真实执行首批菜单加载与用户查询交互”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。
### 测试用例(必须先写,确认 RED)
1. `test_task_226_real_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_226_real_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_226_real_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_226_real_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_226_real_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_226_real_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_226_real_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_226_real_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 227:建立菜单树转换和权限守卫测试夹具
**所属模块**:测试、回归与最终验收
**依赖**:226
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立菜单树转换和权限守卫测试夹具”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_227_establish_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_227_establish_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_227_establish_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_227_establish_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_227_establish_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_227_establish_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_227_establish_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_227_establish_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 228:建立 Session 初始化、401 和退出登录测试夹具
**所属模块**:测试、回归与最终验收
**依赖**:227
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立 Session 初始化、401 和退出登录测试夹具”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_228_establish_session__401_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_228_establish_session__401_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_228_establish_session__401_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_228_establish_session__401_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_228_establish_session__401_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_228_establish_session__401_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_228_establish_session__401_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_228_establish_session__401_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 229:建立账号权限页面 API 与表单回归测试
**所属模块**:测试、回归与最终验收
**依赖**:228
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立账号权限页面 API 与表单回归测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_229_establish_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_229_establish_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_229_establish_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_229_establish_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_229_establish_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_229_establish_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_229_establish_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_229_establish_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 230:建立 ASIN 数据中心 API 与导入导出回归测试
**所属模块**:测试、回归与最终验收
**依赖**:229
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立 ASIN 数据中心 API 与导入导出回归测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_230_establish_asin__api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_230_establish_asin__api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_230_establish_asin__api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_230_establish_asin__api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_230_establish_asin__api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_230_establish_asin__api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_230_establish_asin__api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_230_establish_asin__api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 231:建立店铺中心 API 与敏感字段回归测试
**所属模块**:测试、回归与最终验收
**依赖**:230
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立店铺中心 API 与敏感字段回归测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_231_establish_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_231_establish_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_231_establish_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_231_establish_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_231_establish_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_231_establish_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_231_establish_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_231_establish_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 232:建立任务中心、下载和重复检查回归测试
**所属模块**:测试、回归与最终验收
**依赖**:231
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立任务中心、下载和重复检查回归测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_232_establish_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_232_establish_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_232_establish_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_232_establish_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_232_establish_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_232_establish_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_232_establish_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_232_establish_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 233:真实验证 /api/version 与 /api/version/latest
**所属模块**:测试、回归与最终验收
**依赖**:232
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
使用真实运行环境执行“真实验证 /api/version 与 /api/version/latest”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。
### 测试用例(必须先写,确认 RED)
1. `test_task_233_realverify_public_version___public_version_latest_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_233_realverify_public_version___public_version_latest_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_233_realverify_public_version___public_version_latest_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_233_realverify_public_version___public_version_latest_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_233_realverify_public_version___public_version_latest_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_233_realverify_public_version___public_version_latest_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_233_realverify_public_version___public_version_latest_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_233_realverify_public_version___public_version_latest_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 234:建立 Flyway 菜单迁移集成测试
**所属模块**:测试、回归与最终验收
**依赖**:233
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立 Flyway 菜单迁移集成测试”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_234_establish_flyway_migration_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_234_establish_flyway_migration_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_234_establish_flyway_migration_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_234_establish_flyway_migration_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_234_establish_flyway_migration_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_234_establish_flyway_migration_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_234_establish_flyway_migration_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_234_establish_flyway_migration_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 235:真实验证 Nginx History fallback、assets 和 404
**所属模块**:测试、回归与最终验收
**依赖**:234
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
使用真实运行环境执行“真实验证 Nginx History fallback、assets 和 404”:启动必要服务,发起真实请求或浏览器操作,记录非空且符合业务语义的结果;同时验证错误/降级分支,不得以 mock 或纯静态扫描替代真实调用。
### 测试用例(必须先写,确认 RED)
1. `test_task_235_realverify_nginx_history_fallback_assets___404_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_235_realverify_nginx_history_fallback_assets___404_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_235_realverify_nginx_history_fallback_assets___404_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_235_realverify_nginx_history_fallback_assets___404_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_235_realverify_nginx_history_fallback_assets___404_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_235_realverify_nginx_history_fallback_assets___404_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_235_realverify_nginx_history_fallback_assets___404_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_235_realverify_nginx_history_fallback_assets___404_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 236:建立 Playwright 核心交互、错误重试和响应式验收
**所属模块**:测试、回归与最终验收
**依赖**:235
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
建立“建立 Playwright 核心交互、错误重试和响应式验收”所需的可重复测试或验收基线,覆盖正常路径、边界输入、依赖失败和错误信息;基线要能在 `npm test`、`npm run build`、`mvn test`、`nginx -t`、`curl`、Playwright 和 `python check_progress.py` 中运行,并能证明真实行为而非静态文本存在。
### 测试用例(必须先写,确认 RED)
1. `test_task_236_establish_playwright_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_236_establish_playwright_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_236_establish_playwright_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_236_establish_playwright_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_236_establish_playwright_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_236_establish_playwright_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_236_establish_playwright_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_236_establish_playwright_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 237:运行全量测试并记录覆盖率门禁
**所属模块**:测试、回归与最终验收
**依赖**:236
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
执行“运行全量测试并记录覆盖率门禁”,必须运行完整的类型、测试、格式和真实依赖检查;失败时记录具体失败项并修复后再通过,不得只运行单个 happy path。
### 测试用例(必须先写,确认 RED)
1. `test_task_237_runfull_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_237_runfull_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_237_runfull_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_237_runfull_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_237_runfull_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_237_runfull_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_237_runfull_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_237_runfull_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 238:运行 lint、format 和接口一致性检查
**所属模块**:测试、回归与最终验收
**依赖**:237
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
执行“运行 lint、format 和接口一致性检查”,必须运行完整的类型、测试、格式和真实依赖检查;失败时记录具体失败项并修复后再通过,不得只运行单个 happy path。
### 测试用例(必须先写,确认 RED)
1. `test_task_238_run_lint_format_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_238_run_lint_format_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_238_run_lint_format_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_238_run_lint_format_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_238_run_lint_format_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_238_run_lint_format_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_238_run_lint_format_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_238_run_lint_format_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 239:验证每个任务均有对应 git commit 和 progress 状态
**所属模块**:测试、回归与最终验收
**依赖**:238
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
对“验证每个任务均有对应 git commit 和 progress 状态”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 所有前置模块的测试、构建、部署和真实 HTTP 产物 与 独立后台前端测试门禁、Java 契约门禁、Nginx/Playwright smoke、最终 check_progress 的契约。
### 测试用例(必须先写,确认 RED)
1. `test_task_239_verify_git_commit___progress_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_239_verify_git_commit___progress_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_239_verify_git_commit___progress_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_239_verify_git_commit___progress_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_239_verify_git_commit___progress_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_239_verify_git_commit___progress_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_239_verify_git_commit___progress_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_239_verify_git_commit___progress_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 任务 240:执行最终发布验收并确认 check_progress 返回 all tasks done
**所属模块**:测试、回归与最终验收
**依赖**:239
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
### 功能点要求
实现“执行最终发布验收并确认 check_progress 返回 all tasks done”:以 独立后台前端测试门禁、Java 契约门禁、Nginx/Playwright smoke、最终 check_progress 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 所有前置模块的测试、构建、部署和真实 HTTP 产物 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。
### 测试用例(必须先写,确认 RED)
1. `test_task_240_finalconfirm_check_progress__all_tasks_done_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。
2. `test_task_240_finalconfirm_check_progress__all_tasks_done_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。
3. `test_task_240_finalconfirm_check_progress__all_tasks_done_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。
4. `test_task_240_finalconfirm_check_progress__all_tasks_done_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。
5. `test_task_240_finalconfirm_check_progress__all_tasks_done_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。
6. `test_task_240_finalconfirm_check_progress__all_tasks_done_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。
7. `test_task_240_finalconfirm_check_progress__all_tasks_done_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。
8. `test_task_240_finalconfirm_check_progress__all_tasks_done_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。
### TDD 流程
1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。
2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。
3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。
### 验证方法
执行 `npm test`、`npm run build`、`mvn test`、真实 HTTP/E2E 命令;启动性、核心交互、数据库、Nginx 和公开版本验证必须是真实调用,不能只靠静态扫描。
### 准出标准
- 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。
- 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。
- 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。
## 模块完成条件
- 任务 221-240 全部按 TDD 流程完成并有对应 commit。
- 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
@@ -0,0 +1,279 @@
# 13-AdminHtml 观感对齐:任务计划(本地规划文件,不入库)
> 对应 Spec:`docs/specs/13-admin-html-visual-alignment.md`
> 模块范围:把 `admin-frontend-vue` 的壳层与 15 个业务页面(用户/菜单/分组、ASIN 五个页面、店铺密钥/店铺管理、生成记录/软件版本/数字人版本、视频任务/店铺数据任务)的观感与交互对齐旧 Flask 后台 `backend/web_source/admin.html`(现行蓝白浅色皮肤),**DuplicateCheckPage(店铺撞款监控,menuKey admin_shop_data_duplicate_check)为例外页,本次不动**。
> 任务号:全局续编 **241-272**(前 240 已完成)。每任务结束 commit 形如 `task-NNN(admin.html观感对齐): 描述`。
> 默认验证命令:`cd admin-frontend-vue; node --test tests/task-NNN.test.ts`(或 `npm test`);类型+构建门禁 `npm run build`。
## 统一测试与准出规则
- 每任务先写测试并确认 RED → 实现 → GREEN → `npm run build` 通过 → commit(信息含 task 编号)。
- 每个任务至少 8 条测试:正常路径 ≥3、边界 ≥3、异常 ≥2;涉及 HTTP/浏览器/DOM 时至少 1 条真实或 mock-request 验证;纯 token/常量类任务可降至 4-6 条,但必须以「能证明行为缺口」为前提,禁止空跑/桩断言。
- 只 stage 本任务改动的文件(`git add` 精确到文件),不得覆盖工作树中他人未提交改动。
- 本模块源基准 = `backend/web_source/admin.html` 现行「蓝白浅色」皮肤(CSS 末层 L4477-4830 生效)+ `backend/static/admin.js` / `admin-interactions.js` 的交互与文案;两者作为冻结参照,**不改动**。
---
## 任务 241:冻结 admin.html 蓝白浅色视觉 token 基线并迁移 theme/main.css
- **所属模块**:13 AdminHtml 观感对齐 / A 换皮与共享基线
- **依赖**:240
- **功能点要求**:以 admin.html 末层 :root(`--c-primary:#4f78a5`、`--c-primary-strong:#2f5d8b`、`--c-primary-soft:#e7f0f8`、`--c-bg:#f4f7fb`、浅色侧栏 `--c-sidebar:#edf3f9`/`#f8fbfe`、danger `#b35f6a`、success `#4e806d`、warning `#a8793e`、border `#d8e3ee`、radius 14/9、阴影)改写 `src/styles/theme.ts` 与 `main.css` 的 `--admin-*`/`:root`;侧栏从深色翻转为浅色。更新依赖 token 的不变量测试(原「侧栏为暗」断言改为「侧栏为浅色亮面 + 主色对比度」语义)。禁止 stub:所有改动点均要有测试覆盖与真实样式断言。
- **测试用例**:正常(3) token 值精确匹配基线的 hex;theme→cssVarName 与 :root 实际渲染值一致;边界(3) 空/未知 key 报错保留、主色/侧栏对比度达到 WCAG AA;异常(2) token 非法 hex 报错、不变量与旧深色断言冲突时给出可操作迁移信息。至少 1 条 readSource 校验 main.css 已写浅色侧栏。
- **验证方法**:`node --test tests/task-241.test.ts`;`npm run build`。
## 任务 242:Element Plus 全局主题色与组件默认值对齐蓝白浅色
- **所属模块**:13 / A
- **依赖**:241
- **功能点要求**:在 main.css 统一覆写 `--el-color-primary` 及 light-3~9/dark-2(取 #4f78a5 家族推导)、`--el-color-danger/success/warning`、`--el-border-radius-base`、el-button/el-input/el-select/el-table/el-pagination/el-tag/el-dialog 的圆角、边框、hover 态等,使 Element Plus 组件观感贴近 admin.html 的 .btn/.form-group input/.table-scroll/.pagination/.tag。建立「el 组件默认值映射表」到测试可读的常量文件(styles/ep-overrides.ts),页面直接受益。
- **测试用例**:正常(3) primary/danger 等 el 变量等于基线推导值;radius-base 生效;边界(3) 变量前缀完整(light-3…dark-2)、不受 light-3..9 越界覆盖影响;异常(2) 颜色不满足对比度、缺变量时测试报错提示。readSource 断言 el-button/el-input 关键值写入。
- **验证方法**:`node --test tests/task-242.test.ts`;`npm run build`。
## 任务 243:壳层换皮(侧栏/顶栏/菜单)对齐 admin.html 蓝白浅色
- **所属模块**:13 / A
- **依赖**:241,242
- **功能点要求**:AdminLayout 与相关 layout css:侧栏宽度 252px、浅色渐变底(#f8fbfe→#edf3f9)、菜单项高度/圆角/激活态「90deg 浅蓝渐变+inset 3px #5f85ad 竖条」、分组标题 12px 字距、品牌区高度与 logo;顶栏 76px、半透明白+blur、kicker「运营管理控制台」、面包屑「管理后台 / 页面名」、h1 18px、角色胶囊、退出按钮(secondary 形态)。保持折叠 64px 与窄屏行为。复用 sidebar-collapse/title-breadcrumb/logout 模块。
- **测试用例**:正常(3) 壳层类名/布局结构与浅色底存在;激活态含蓝条规则;顶栏高度=76px;边界(3) 折叠宽度、窄屏自动折叠、面包屑两级;异常(2) 缺菜单用户空态、菜单树异常降级。
- **验证方法**:`node --test tests/task-243.test.ts`;`npm run build`;dev 截图自查。
## 任务 244:页面公共区块样式收敛(panel/filter/table/footer/空错态)
- **所属模块**:13 / A
- **依赖**:241,242
- **功能点要求**:在 main.css 建立对齐 admin.html 的公共类:`.admin-panel-box`(白卡 radius14/阴影/头 h3+按钮同行)、`.admin-filter`(label 上、控件 min-height42、输入 focus 蓝 ring)、`.admin-table`(外框 1px #dbe5ee radius10、th #edf4fa 12.5px 600、tr hover #f1f7fb)、`.table-footer` 统一「共 N 条」+ 分页、空态 `.empty-tip`/错误重试统一。把 B 系 12 页 scoped 复制的 `.filter-grid/.f-item/.table-footer` 收敛为全局引用,逐页删 scoped 冗余(页面内联 style 一并清理),并保证 15 页观感一致。
- **测试用例**:正常(3) 公共类定义存在且值符合基线;footer 文案统一;边界(3) 空表/无数据/单页时页脚表现;异常(2) 某页仍残留 scoped 重复定义时 readSource 报错;全局类不被误删。
- **验证方法**:`node --test tests/task-244.test.ts`;`npm run build`。
## 任务 245:二次确认对话框共享组件(对齐 admin confirm 规则)
- **所属模块**:13 / A
- **依赖**:244
- **功能点要求**:实现共享 `confirm-action` 组件/组合(居中遮罩 blur、橙底感叹图标、标题/描述、取消 secondary + 确认 danger/primary),默认文案拼接规则对齐 admin-interactions:优先显式 message,否则由行名拼接「确认删除“X”吗?此操作可能影响已有数据。」;删除类按钮默认自动绑定。替换各页零散 ElMessageBox.confirm 为统一确认组件(保留既有逻辑)。危险操作=删除/清空/删除导入类。
- **测试用例**:正常(3) 标题/键文案拼接正确;danger 变体确认键「确认删除」;边界(3) 无名称时默认文案、Esc/遮罩关闭、异步 then/catch 不泄漏;异常(2) 无回调、并发多开被拒绝或排队。
- **验证方法**:`node --test tests/task-245.test.ts`;`npm run build`。
## 任务 246:表单反馈与请求反馈统一(msg/toast/loading 语义)
- **所属模块**:13 / A
- **依赖**:244,245
- **功能点要求**:统一成功/错误/警告反馈语义与文案规范(对齐 admin:成功常为绿 msg+toast、错误红、待办提示黄);表单提交按钮 loading/is-busy 态(防重复、文案如「保存中…」「导出中…」);全局请求进度(可选顶部进度条 + 右上 spinner,对齐 admin request-loading 文案「请求处理中...」)。做成共享 composable/组件(如 useAdminFeedback / AppFeedback),页面收敛调用。
- **测试用例**:正常(3) 成功/错误/警告通道独立可用且带语义 class;is-busy 置灰+防重入;边界(3) 连续错误不堆积、成功清错、文案兜底;异常(2) 网络失败给出可行动文案、非 Error 异常容错。
- **验证方法**:`node --test tests/task-246.test.ts`;`npm run build`。
## 任务 247:行内工具组件化(状态徽章/掩码/复制/白名单药丸)
- **所属模块**:13 / A
- **依赖**:244
- **功能点要求**:把散落的行内展示对齐 admin.html 语义并组件化:状态药丸(success/failed/running/warning 圆角999 三态色,供视频/店铺数据/数字人版本复用);掩码+显示(店铺密码/令牌,眼睛切换实时读取);复制文本(ASIN/链接,成功 toast「已复制 X」);白名单状态药丸+前置圆点与 title 帮助。放到 `src/components/` 共享并逐页替换手写实现。
- **测试用例**:正常(3) 三种状态渲染对应色/文案;复制成功回调 toast 文案;掩码切换状态;边界(3) 空值、长文本截断+title、复制失败降级文案;异常(2) 缺回调参数、DOM 不存在时安全降级。
- **验证方法**:`node --test tests/task-247.test.ts`;`npm run build`。
## 任务 248:模态与抽屉容器统一(居中 modal vs 右侧 drawer)
- **所属模块**:13 / A
- **依赖**:244
- **功能点要求**:统一两种承载容器:居中 `.admin-modal`(width min(920px,100vw-48)、radius14、头 h3+副标题+关闭、body 滚动、底部按钮行 gap8)与右侧 `.admin-drawer`(width min(460px,100%)、三段式),遮罩 blur,Esc/遮罩关闭语义对齐 admin;把 15 页 el-dialog/el-drawer 的宽度/头尾结构/关闭行为收口(不清除各页业务字段)。
- **测试用例**:正常(3) modal 尺寸/头尾结构;drawer 尺寸/三段式;Esc/遮罩关闭;边界(3) 内容超高内部滚动、窄屏宽度下限、多实例叠加 z-index;异常(2) 无标题页头兜底、关闭回调异常容错。
- **验证方法**:`node --test tests/task-248.test.ts`;`npm run build`。
## 任务 249:壳层与公共样式真实验收 + 每页检查清单模板
- **所属模块**:13 / A
- **依赖**:243-248
- **功能点要求**:本地起 dev(VITE_API_TARGET=18100 mock 或 Java 18080),对壳层+至少 2 个代表页(用户管理、店铺管理)做浏览器截图与 admin.html 并排自查:侧栏浅色、主色蓝灰、表格/筛选/按钮/分页观感、空/错/loading 态;生成 `docs/plans/…/13/13-panel-checklist.md` 模板(每页行:面板头/描述/筛选/列/操作/确认文案/成功文案/空错态/分页形态/是否补齐交互 各勾选项),作为后续 250-267 每页对齐与 268 自查的验收清单。
- **测试用例**:真实 HTTP/浏览器:起 mock+dev 后断言页面 title/壳层元素与 CSS 变量(浅色侧栏、主色)生效;Playwright 无 pageerror;清单模板文档存在且含全部 15 页。
- **验证方法**:`npm run test:browser -- e2e/13-shell.spec.ts`;人工截图对照。本任务可用真实浏览器代替纯单测,但仍需 ≥1 条断言脚本化。
## 任务 250:用户管理页面对齐(列表/筛选/文案/分页形态)
- **所属模块**:13 / B account
- **依赖**:249
- **功能点要求**:UsersPage 列表观感对齐 admin panel-users:页头描述「当前没有开放注册入口…层级:超级管理员->管理员->普通账号」;筛选含「用户名(模糊搜索)」与「所属管理员」(超管才显示,含「全部」);列 ID/用户名/角色(中文 roleLabel)/所属管理员/创建时间/操作,行尾固定;删除确认走 245 组件,禁删条件保留;分页「共 N 条 + 上/下+跳页」。createdByAdminId 筛选建模补接线。
- **测试用例**:正常(3) 列表渲染列与角色中文、筛选参数映射(含 created_by);删除禁删提示;分页跳页;边界(3) 空结果、页码越界回钳、超管/普通管理员 filter 显隐;异常(2) 加载失败错误态+重试、删除失败提示不清列表。
- **验证方法**:`node --test tests/task-250.test.ts`;`npm run build`。
## 任务 251:用户管理补齐新建/编辑/角色+菜单授权弹窗
- **所属模块**:13 / B
- **依赖**:250
- **功能点要求**:把已建模孤儿模块接线为 UI(对齐 admin.js users L325-1087 交互与文案):新建用户弹窗(用户名≥2/密码≥6 校验、角色、菜单授权树),成功 msg「创建成功」弹窗不关并清空刷新;编辑用户(密码留空不改、admin 登录者不能改角色)、用户菜单授权弹窗(菜单树两段:后台菜单/软件菜单,勾父清子、结构受限禁用、已选胶囊)。复用 user-create-model/adapter、user-edit-model、user-menu-auth(-api)、user-role-map、user-menu-auth.ts。
- **测试用例**:正常(3) 新建校验通过→POST 载荷正确、编辑回填、授权树提交;边界(3) 用户名<2/密码<6 报错、留空不改密码、勾父清子;异常(2) 权限树未加载不能保存、接口失败给可行动文案。
- **验证方法**:`node --test tests/task-251.test.ts`;`npm run build`。
## 任务 252:菜单管理页面对齐
- **所属模块**:13 / B
- **依赖**:250
- **功能点要求**:MenusPage 对齐 admin panel-columns:树表格列(拖动/ID/菜单名称/菜单类型/上级菜单/创建时间/操作)观感;排序交互决策对齐 admin(admin 用原生拖拽手柄仅同级同类型,失败回滚+「排序保存失败」);新增/编辑须选「页面」白名单(route 下拉含 column_key::route_path 42 项);删除确认+成功后刷新列表/权限树/侧栏;树默认展开。拖动或用现有上移下移以 admin 为准。
- **测试用例**:正常(3) 列表/弹窗字段/route 白名单选项、删除确认刷新联动;边界(3) 同类型限制、仅同级可排、白名单为空提示;异常(2) 排序保存失败回滚、删除父级有子保护。
- **验证方法**:`node --test tests/task-252.test.ts`;`npm run build`。
## 任务 253:数据权限分组页面对齐(含选人通讯录编辑器)
- **所属模块**:13 / B
- **依赖**:251
- **功能点要求**:GroupsPage 对齐 admin panel-group-manage:顶部「数据权限分组」摘要(shopManageGroupSummary 语义:各组组长/人数);分组列表(序号/分组名称/组长/组员数量/组员 chips/创建/修改/操作);新建/编辑分组弹窗含「通讯录选人面板」(搜索用户名/拼音首字母、按字母分组联系人、8 色首字母头像、A-Z 索引、底部已选 N 人);组长/超管才可编辑删除;删除「确定删除分组“X”吗?」并级联刷新 5 处;校验「请输入分组名称」。复用 shop-group-api/model、account/shop-group-*。
- **测试用例**:正常(3) 摘要渲染、选人面板搜索/勾选计数、保存载荷(组长+成员);边界(3) 空组员、拼音首字母检索、组长本人不可改;异常(2) 未授权不可编辑、删除失败提示。
- **验证方法**:`node --test tests/task-253.test.ts`;`npm run build`。
## 任务 254:去重汇总页面对齐(筛选扩充 + 行编辑 + 导入/删除导入/导出)
- **所属模块**:13 / C asin
- **依赖**:253
- **功能点要求**:DedupeRegistryPage 对齐 admin panel-dedupe-total-data:页头分组摘要条;筛选按「ASIN/用户名/分组/国家 + 开始/结束日期」排列(现仅 keyword+country);列表行可编辑(ASIN+分组)与删除「确定删除总数据“X”吗?」;新增导入/删除导入(Excel+分组,进度轮询「处理中:已处理 a/b,新增 x,跳过 y」→ 完成文案;删除导入前置「确定按 Excel 中的 ASIN 批量删除…」);导出 XLSX(日期校验「开始日期不能晚于结束日期」+「导出中…/正在生成导出文件…已等待 N 秒」等待弹窗)。接线 dedupe-total-export/import/total-* 孤儿模块。
- **测试用例**:正常(3) 筛选参数字段映射、导入轮询到终态文案、导出等待与下载;边界(3) 日期逆序校验、进度 0/N 与 100%、删除导入空 excel;异常(2) 轮询超时提示刷新、导出接口失败可行动文案。
- **验证方法**:`node --test tests/task-254.test.ts`;`npm run build`。
## 任务 255:品牌数据库(不符合ASIN)页面对齐
- **所属模块**:13 / C
- **依赖**:254
- **功能点要求**:AsinInvalidPage 对齐 admin panel-invalid-asin-data:筛选含 ASIN/品牌/分组;来源列「手动新增/自动导入」tag;手动记录可改分组、自动记录编辑时分组区隐藏;普通账号分组锁定(只显示所属组);新增/编辑校验与删除「确定删除“X”吗?」;分页形态/空错态统一。名称沿用 Vue「不符合ASIN数据」,仅观感与交互对齐。
- **测试用例**:正常(3) 筛选三字段、来源 tag、编辑分组显隐规则;边界(3) 自动记录分组只读、普通账号锁定、空分组下拉;异常(2) 删除失败、保存校验文案。
- **验证方法**:`node --test tests/task-255.test.ts`;`npm run build`。
## 任务 256:商品类目页面对齐(懒加载树/搜索/导出/删除/新增编辑)
- **所属模块**:13 / C
- **依赖**:255
- **功能点要求**:ProductCategoryPage 对齐 admin panel-product-categories:懒加载树(默认根层,± 展开拉子层,每层「加载更多」+已加载 a/b);顶部搜索框(placeholder「搜索类目名称、编码或备注」,独立分页结果);导出按钮;行删除有子类时禁用+「确定删除“X”?」;新增根/子类目 + 编辑弹窗标题切「编辑商品类目」按钮变「保存类目」+「取消编辑」;校验/排序/说明字段。
- **测试用例**:正常(3) 根层加载、展开拉子、搜索态分页「加载更多」;边界(3) 空子层、有子类禁删、搜索无结果;异常(2) 加载失败可重试、保存失败不清树。导出接线 product-category-export.ts。
- **验证方法**:`node --test tests/task-256.test.ts`;`npm run build`。
## 任务 257:查询ASIN页面对齐(含行内配置抽屉与导入)
- **所属模块**:13 / C
- **依赖**:255
- **功能点要求**:QueryAsinPage 对齐 admin panel-query-asin:筛选(分组/店铺/国家/ASIN);列表(店铺/分组/5 国 ASIN 可点击复制);行内「配置」右侧抽屉(5 国×[ASIN],留空删除该站点语义提示);导入新增(支持两种 Excel 格式 label)/删除导入(确认「确定按 Excel 中的分组、店铺名和国家 ASIN 批量删除吗?」);导出;任务级联店铺选择与空态文案。接线 query-asin-detail/import/delete-import 孤儿模块。
- **测试用例**:正常(3) 配置抽屉 diff→PUT/DELETE 逐国、复制 ASIN toast、导入轮询;边界(3) 留空=删除、分组无店铺「该分组暂无店铺」、多国家部分失败逐国拼接错误;异常(2) 删除导入前置确认、超时刷新提示。
- **验证方法**:`node --test tests/task-257.test.ts`;`npm run build`。
## 任务 258:最低价ASIN页面对齐(价格范围筛选 + 配置抽屉 + 导入)
- **所属模块**:13 / C
- **依赖**:257
- **功能点要求**:SkipPricePage 对齐 admin panel-skip-price-asin:筛选含最低价范围(≥/-/≤ 两个 number, step.01);列表列含 5 国 ASIN+最低价 与更新时间;行内「配置」抽屉(ASIN+最低价 双列,留空删除,最低价校验「最低价格式不正确」「填写最低价时必须填写 ASIN」);导入新增/删除 + 导出。接线 skip-price-import/detail 孤儿模块。ASIN 自动大写。
- **测试用例**:正常(3) 价格范围参数映射、配置抽屉双字段、导入流程;边界(3) 低价>高价、仅填低价无 ASIN 报错、ASIN 大小写归一;异常(2) 删除导入确认、导出失败文案。
- **验证方法**:`node --test tests/task-258.test.ts`;`npm run build`。
## 任务 259:生成记录页面对齐(筛选 + 缩略图预览布局)
- **所属模块**:13 / D records
- **依赖**:258
- **功能点要求**:RecordsHistoryPage 对齐 admin panel-history:筛选「指定用户 select(全部用户)+开始/结束 datetime-local」;列表(ID/用户/记录类型中文/创建时间/结果预览≤3 缩略图 56px + 操作查看);预览与详情布局对齐;空态「暂无记录」;分页形态统一。接线 history-filter/preview 孤儿模块(或保留页面自写但观感对齐)。
- **测试用例**:正常(3) 筛选参数、类型中文映射、缩略图≤3 计数;边界(3) 无缩略图、>3 张截断、空结果;异常(2) 用户下拉加载失败、图片加载失败占位。
- **验证方法**:`node --test tests/task-259.test.ts`;`npm run build`。
## 任务 260:软件版本页面对齐
- **所属模块**:13 / D
- **依赖**:259
- **功能点要求**:RecordsSoftwareVersionPage 对齐 admin panel-version:上传弹窗校验「请填写版本号/请选择 zip 压缩包/仅支持 .zip 格式」,成功「发布成功。版本:v,链接:url」;列表列(版本号/下载链接/创建时间/操作=下载外链);空态;分页形态。admin 无删除,删除相关 UI 移除(若 Vue 有)保持一致。
- **测试用例**:正常(3) 上传校验通过→请求、列表渲染下载外链、成功文案含版本与链接;边界(3) 空版本号、非 zip、上传超时进度;异常(2) 发布失败文案、下载不可用提示。
- **验证方法**:`node --test tests/task-260.test.ts`;`npm run build`。
## 任务 261:数字人版本页面对齐(状态色/最新★/发布/设最新/删除)
- **所属模块**:13 / D
- **依赖**:260
- **功能点要求**:RecordsDigitalHumanVersionPage 对齐 admin panel-digital-human-version:列(版本号/状态[已发布|草稿]色:草稿#999 已发布#52c41a 已废弃#ff4d4f/最新★/文件大小/MD5 截 12/更新日志/发布时间/操作);操作仅按状态显隐:草稿→发布、已发布非最新→设为最新、已发布→下载、非最新→删除(危险二次确认);上传(版本/zip/最低客户端/changelog)进度与成功文案「上传成功!版本:v(状态:草稿,请在列表中点击“发布”按钮)」。
- **测试用例**:正常(3) 状态→操作按钮矩阵、最新★/MD5 截断展示、上传成功文案;边界(3) 已废弃不可发布/删除保护、无发布时间、0 字节包;异常(2) 发布/设最新失败可行动文案、删除确认取消。
- **验证方法**:`node --test tests/task-261.test.ts`;`npm run build`。
## 任务 262:店铺密钥页面对齐(白名单药丸/令牌留空语义/删除文案)
- **所属模块**:13 / E shop
- **依赖**:261
- **功能点要求**:ShopKeysPage 对齐 admin panel-shop-keys:列表列(序号/备注名/紫鸟账号名称/紫鸟令牌[掩码]/白名单状态药丸+悬停 title 检测信息/创建/修改/操作);新增/编辑(账号、令牌,校验「请完整填写紫鸟账号名称、紫鸟令牌」,编辑令牌留空=不修改 用占位与提示统一风格);删除「确定删除店铺密钥“X”吗?」;整页筛选栏缺失补齐(按 admin 无筛选保持无筛选,若做则对齐);分页形态统一。
- **测试用例**:正常(3) 列表列含白名单药丸、新增校验、令牌留空语义;边界(3) 空白名单「未加白名单」、令牌自动去 Bearer、悬停 title;异常(2) 删除确认取消、保存失败文案。
- **验证方法**:`node --test tests/task-262.test.ts`;`npm run build`。
## 任务 263:店铺管理页面对齐(掩码眼睛实时读凭证/凭证明文/校验)
- **所属模块**:13 / E
- **依赖**:262
- **功能点要求**:ShopManagePage 对齐 admin panel-shop-manage:筛选(分组/店铺名);列表列(序号/分组/店铺名/商城名/自动化账号/账号/密码[******+眼睛实时读]/创建/修改/操作);密码眼睛点击实时请求 /credential 显示真值「读取中…」;凭证明文弹窗(含复制按钮)+点击复制 toast;必填校验「请完整填写分组、店铺名、店铺商城名、账号、密码」,编辑密码语义与后端一致(占位文案修正,不再自相矛盾);删除「确定删除店铺“X”吗?」;分组下拉 30s 缓存。
- **测试用例**:正常(3) 掩码默认/眼睛实时读取、凭证明文复制、分组下拉加载;边界(3) 无凭证、密码显示中断「读取中…」、编辑密码占位语义;异常(2) 必填校验逐条、删除确认、凭证接口失败。
- **验证方法**:`node --test tests/task-263.test.ts`;`npm run build`。
## 任务 264:视频任务视图对齐(卡片网格 + 播放 + 单卡下载/复制链接)
- **所属模块**:13 / F tasks
- **依赖**:263
- **功能点要求**:ImageVideoTasksPage 由表格+抽屉改为对齐 admin panel-image-video-tasks 的「任务卡片网格」:form-box「筛选」+卡片网格(每任务卡:状态中文 tag、用户/执行ID/时间、video 标签可播放、缩略图、单卡「下载」=fetch blob→task-{id}-video-{n}.mp4 失败降级新窗口、复制链接(1.6s 已复制)、空态「视频生成中或暂无结果」「任务失败,未生成视频」、加载失败「视频加载失败,可尝试下载」);合计「共 N 个任务 · 本页 N 个视频」。复用 image-video-* 模块,接线 selection/download-feedback。
- **测试用例**:正常(3) 卡片渲染/状态中文、video 地址、单卡下载 blob 名;边界(3) 空态两分支、下载失败降级新窗、复制链接计时;异常(2) 网络失败文案、video 加载失败占位。
- **验证方法**:`node --test tests/task-264.test.ts`;`npm run build`。
## 任务 265:视频任务筛选/权限配置/批量下载 对齐
- **所属模块**:13 / F
- **依赖**:264
- **功能点要求**:筛选对齐(用户名模糊/提交开始/结束 datetime-local + 查询/重置);权限配置弹窗对齐(已分配/全部用户 tabs、搜索、行内分配/取消分配/待保存态、变更汇总行、保存「保存中…」);批量下载(勾选当前页 checkbox、POST zip 进度「正在打包 N 个视频...」→「压缩包下载已开始」/部分失败提示);分页 20/页。
- **测试用例**:正常(3) 筛选参数与重置、权限弹窗保存汇总、批量下载进度终态;边界(3) 0 选中禁用、部分失败提示、待保存变更态;异常(2) 权限接口失败、zip 打包失败可行动文案。
- **验证方法**:`node --test tests/task-265.test.ts`;`npm run build`。
## 任务 266:店铺数据任务视图对齐(每店卡片网格)
- **所属模块**:13 / F
- **依赖**:265
- **功能点要求**:ShopDataTasksPage 由 flatMap 表格改为对齐 admin panel-shop-data-crawl-tasks 的「每店铺一卡片」:卡片=店铺名/分组小 tag/任务号+状态(三态药丸)/站点国 chips/最新文件/文件行数/下载/删除;下载=服务端原文件名(回退 shop-data-task-{id}.xlsx);删除仅终态可点、进度条文本「正在删除任务 N...」、确认「确认删除店铺“X”的任务 N 及结果文件?」;空态;复用 shop-data-* 接线 selection/list-state。
- **测试用例**:正常(3) 卡片分组渲染(results 分组)、下载文件名回退、终态可删/非终态禁用;边界(3) 无结果文件、删除中进度、多文件店卡;异常(2) 下载失败、删除失败提示。
- **验证方法**:`node --test tests/task-266.test.ts`;`npm run build`。
## 任务 267:店铺数据任务筛选/批量下载/权限 对齐
- **所属模块**:13 / F
- **依赖**:266
- **功能点要求**:筛选对齐(店铺模糊/分组模糊/国家 select/创建时间 datetime 范围 + 查询/重置);批量下载 zip(X-Archive-Error-Count 提示包内错误清单);合计「共 N 家店铺」;权限配置弹窗同 265;分页 20/页与刷新。
- **测试用例**:正常(3) 筛选字段映射、批量下载 zip 头、合计文本「共 N 家店铺」;边界(3) 0 店铺、空筛选、部分失败;异常(2) 打包失败提示、权限接口失败。
- **验证方法**:`node --test tests/task-267.test.ts`;`npm run build`。
## 任务 268:15 页逐页对齐自查与修正
- **所属模块**:13 / G 收尾
- **依赖**:250-267
- **功能点要求**:按任务 249 建立的每页检查清单,对 15 页逐页过(对照 admin.html 观感与交互),修正残留不一致;验证 DuplicateCheckPage 不受影响;记录偏离项与原因到清单文档(如业务命名差异 invalid-asin、分页无页码等已知容忍项)。
- **测试用例**:readSource/集成断言:抽查每页无 scoped 残留重复样式、无死按钮、无 ElMessageBox.confirm 直连(已走统一组件)、关键文案存在于页面。
- **验证方法**:`npm test`;`npm run build`。
## 任务 269:e2e 换皮/对齐冒烟
- **所属模块**:13 / G
- **依赖**:268
- **功能点要求**:补 e2e/13-*.spec.ts:壳层浅色 token(侧栏底色、主色变量)、壳层跳转、代表页(用户/店铺管理/商品类目)渲染与筛选/删除确认可用、无 pageerror、viewport 响应式。用 mock server 提供最小 API。
- **测试用例**:真实浏览器 ≥4 场景(壳层、用户列表+确认、类目树、响应式),断言 DOM/样式/CSS 变量,禁纯截图无断言。
- **验证方法**:`npm run test:browser`(自动起 mock+dev 5174)。
## 任务 270:本地 Java+Vue 全链路真实 smoke
- **所属模块**:13 / G
- **依赖**:269
- **功能点要求**:起本地 Java(18080)与 dev(VITE_API_TARGET=18080),以 live 账号真跑 15 页核心交互(登录、进页、查询、打开弹窗/抽屉、删除确认打开与取消、导入/导出入口可达性),补 tests/live/task-270-live.test.ts(AIIMAGE_LIVE_* 门控,同既有 live 约定);记录每页真实验收勾选。
- **测试用例**:真实接口 + 浏览器;无 env 时 skip 并说明。
- **验证方法**:`npm run test:live`。
## 任务 271:全量门禁与收尾提交
- **所属模块**:13 / G
- **依赖**:270
- **功能点要求**:`npm run build`(vue-tsc 类型门禁)、`npm test` 全量、检查无 stub/echo/死按钮/硬编码;对涉及 Java 旧后台文档/部署说明(deploy/release-structure、nginx conf 注释等)如有需要同步「蓝白浅色换皮」说明;RELEASE_SMOKE=1 时跑 240 收尾验收。
- **测试用例**:类型检查 + 全量 test + 构建产物校验(deploy/verify-dist.mjs)。
- **验证方法**:`npm run build && npm test`;`node deploy/verify-dist.mjs`。
## 任务 272:module 收尾(progress 闭合 + 一致性校验)
- **所属模块**:13 / G
- **依赖**:271
- **功能点要求**:校验 overview 总任务数=272 且含 module 13 行、plan 13 任务 241-272 与 progress.json 一一对应、全部 done;`check_progress.py` 返回 0;更新 docs/plans/…/13/13-panel-checklist.md 的最终验收列;module 收尾 commit。
- **测试用例**:check_progress 一致性 + 无遗留 RED 测试。
- **验证方法**:`python check_progress.py`(应退出 0)。
---
## 模块完成条件
1. 任务 241-272 串行全部 done 且有对应 commit;DuplicateCheckPage 页面文件无改动(git 校验例外页不变)。
2. 15 个页面按 249 清单逐项对齐,缺失交互补齐,壳层为蓝白浅色;admin.html/admin.js 未被改动。
3. `npm test`、`npm run build`、`npm run test:browser` 通过,live smoke 有记录;check_progress 返回 all tasks done。
@@ -0,0 +1,52 @@
# 13-Panel Checklist:15 页面观感/交互对齐验收清单(模板)
> 用途:module-13 250-267 每页对齐的验收清单 + 268 逐页自查用。
> 源基准:`backend/web_source/admin.html` 现行蓝白浅色皮肤 + `backend/static/admin.js` / `admin-interactions.js`(冻结参照)。
> 例外页:`shop-center/duplicate-check`(店铺撞款监控 / DuplicateCheckPage)不在本清单,本模块不改。
> 状态列取值:待办 / 进行中 / 对齐 / 已补齐 / 待人工目检。
## 运行结论(task-249 真实验收占位)
- e2e 壳层 smoke(`npm run test:browser`):按下方「验证记录」填写。
- 浏览器人工目检(壳层换皮为蓝白浅色):**待人工目检** —— dev `http://127.0.0.1:5174/admin-vue/`(mock:18100 或 Java:18080)。
- 每页最终勾选结果:任务 268 回填。
## 面板 × 页面 × 待办任务对照与检查项
| # | admin.html panel | Vue 路由 / menuKey | 对齐任务 | 面板头文案 | 页头描述 | 筛选字段 | 主要列 | 操作列 | 确认文案 | 成功提示 | 空/错/loading | 分页形态 | 缺失交互补齐 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | panel-users 用户管理 | /account/users `admin_users` | 250-251 | 用户列表 | 无开放注册入口说明 | 用户名(模糊)、所属管理员(仅超管) | ID/用户名/角色(中文)/所属管理员/创建时间 | 删除 | 删除“X”二次确认(245) | 创建成功/删除成功 | 空/错误+重试 | 共N条+上/下+跳页 | 新建/编辑/角色+菜单授权弹窗(接线孤儿模块) |
| 2 | panel-columns 菜单权限配置 | /account/menus `admin_columns` | 252 | 菜单列表 | 拖动同级排序提示 | 无 | 拖动列/ID/菜单名称/菜单类型/上级/创建时间 | 新增/编辑/删除/上移下移(或拖动) | 删除菜单“X”(245) | 排序保存失败回滚 | 空/错 | 树全展开无分页 | route 白名单下拉42项、删除后刷新权限树/侧栏 |
| 3 | panel-group-manage 分组管理 | /account/groups `admin_group_manage` | 253 | 分组列表 | 摘要「数据权限分组」 | 无(只读筛选不必要) | 序号/分组名称/组长/组员数/组员chips/创建/修改 | 新建/编辑/删除(仅组长/超管) | 删除分组“X”(245) | 保存成功 | 空/错 | 无 | 分组编辑器+通讯录选人面板(接线) |
| 4 | panel-dedupe-total-data 去重数据汇总 | /asin-center/registry `admin_dedupe_total_data` | 254 | ASIN列表 | 分组摘要条 | ASIN/用户名/分组/国家/开始/结束日期 | ID/ASIN/国家(中文)/用户名/分组/创建时间 | 编辑/删除 + 页头导入/删除导入/导出 | 删除总数据“X”(245)、删除导入确认 | 导入完成…/导出下载 | 导出等待弹窗 | 共N条+跳页 | 新增导入/删除导入(轮询)/导出XLSX(接线孤儿) |
| 5 | panel-invalid-asin-data 品牌数据库 | /asin-center/invalid `admin_invalid_asin_data` | 255 | 品牌数据列表 | — | ASIN/品牌/分组 | ID/ASIN/品牌/分组/来源(手动/自动)/创建时间 | 新增/编辑/删除 | 删除“X”(245) | 保存成功 | 空/错 | 共N条+跳页 | 分组锁定/自动记录分组区隐藏等规则 |
| 6 | panel-query-asin 查询ASIN | /asin-center/query `admin_query_asin` | 257 | 店铺列表 | — | 分组/店铺/国家/ASIN | 店铺/分组/5国ASIN(可复制) | 配置(抽屉) + 导入/删除导入/导出 | 删除导入确认 | 已复制X | 该分组暂无店铺 | 共N条+跳页 | 行内配置抽屉 per-country、导入(接线孤儿) |
| 7 | panel-product-categories 商品类目 | /asin-center/categories `admin_product_categories` | 256 | 商品类目 | 顶部搜索框 | 名称/编码/备注搜索 | 类目(树展开)/层级路径/排序/来源/备注 | 新增/编辑/删除(有子禁用)/导出 | 删除“X”(245) | 保存成功 | 加载更多/已加载a/b | 树懒加载 | 懒加载树/搜索态/导出(接线孤儿) |
| 8 | panel-skip-price-asin 最低价ASIN设置 | /asin-center/skip-price `admin_skip_price_asin` | 258 | 店铺列表 | — | 分组/店铺/国家/ASIN/最低价≥≤ | 店铺/分组/5国(ASIN+最低价) | 配置(抽屉) + 导入/删除导入/导出 | 删除导入确认 | 最低价校验文案 | 空/错 | 共N条+跳页 | 价格范围筛选/配置抽屉/导入(接线孤儿) |
| 9 | panel-shop-keys 店铺密钥管理 | /shop-center/keys `admin_shop_keys` | 262 | 店铺密钥列表 | — | 无 | 序号/备注/紫鸟账号/令牌(掩码)/白名单药丸/创建/修改 | 新增/编辑/删除 | 删除密钥“X”(245) | 保存成功 | 空/错 | 共N条+跳页 | 令牌留空=不修改语义、白名单title帮助 |
| 10 | panel-shop-manage 店铺管理 | /shop-center/shops `admin_shop_manage` | 263 | 店铺列表 | — | 分组/店铺名 | 序号/分组/店铺名/商城名/自动化账号/账号/密码(掩码+眼睛)/创建/修改 | 新增/编辑/删除/凭证明文 | 删除店铺“X”(245) | 保存成功 | 空/错 | 共N条+跳页 | 密码眼睛实时读凭证/凭证明文复制/必填校验修正 |
| 11 | panel-shop-data-crawl-tasks 店铺数据记录 | /shop-center/data-tasks `admin_shop_data_crawl_tasks` | 266-267 | 店铺数据记录 | 筛选条件(form) | 店铺/分组/国家/创建时间 | 每店铺卡片(店名/任务号/状态/分组/国家/文件/行数) | 下载/删除/批量下载 | 删除任务“X”(245) | 下载已开始 | 空态 | 卡片网格分页 | 卡片网格化/批量下载/合计“共N家店铺”/权限弹窗 |
| 12 | panel-history 生成记录 | /records/history `admin_history` | 259 | 生成记录 | 筛选条件(form) | 指定用户/开始/结束 datetime | ID/用户/类型中文/创建时间/结果预览(≤3缩略图) | 查看预览 | — | — | 暂无记录 | 共N条+跳页 | 筛选select+datetime、缩略图预览布局 |
| 13 | panel-version 软件版本管理 | /records/software-version `admin_version` | 260 | 版本列表 | — | 无 | 版本号/下载链接/创建时间 | 上传(弹窗)/下载 | 无删除 | 发布成功… | 空 | 共N条+跳页 | 上传校验zip/发布文案 |
| 14 | panel-digital-human-version 数字人版本管理 | /records/digital-human-version `digital_human_version` | 261 | 版本列表 | — | 无 | 版本/状态/最新★/大小/MD5(截12)/更新日志/发布时间 | 发布/设最新/下载/删除 | 删除“X”(245) | 上传成功…(草稿提示) | 空 | 数字页码 | 状态色/操作矩阵/上传进度 |
| 15 | panel-image-video-tasks 视频任务记录 | /records/image-video-tasks `admin_image_video_tasks` | 264-265 | 视频任务记录筛选 | 筛选条件(form) | 用户名/提交开始/结束 datetime | 卡片网格(视频/任务状态) | 单卡下载/复制链接/批量下载/权限配置 | 删除确认(admin无) | 已复制(1.6s) | 视频生成中/失败 | 卡片网格分页 | 卡片网格+video播放/批量下载/权限弹窗/合计 |
## 验证记录(任务 249 执行时回填)
- [x] 已新增 `e2e/13-shell.spec.ts`(蓝白浅色 CSS 变量/角色胶囊/次级退出/代表页无 pageerror 断言)。
- [ ] `npm run test:browser` —— **本次尝试被环境阻塞**:5174 上残留指向 Java(18080) 的旧 dev server,被 playwright 以 reuseExistingServer 复用后 401 重定向 `/login`(既有 task-20 spec 同样受影响,非本模块回归)。干净环境(起 mock:18100 + dev VITE_API_TARGET=18100)下应通过。
- [ ] 人工目检:侧栏浅色/主色蓝灰/表格筛选分页按钮观感/空错loading
- [ ] admin.html vs dev 截图并排自查
## 254-258 执行备注(module 13 收口复查用)
- 254 去重汇总:筛选含用户名/分组/日期、行编辑+删除、新增/删除导入(轮询)、导出(日期校验+anchor 下载)已接。分组选项源用 /api/admin/shop-manage-groups。页头原样 admin 的「新增导入/删除导入」+「导出」。
- 255 品牌数据库(不符合ASIN):分组筛选、来源列 recordSourceLabel + el-tag、自动导入记录编辑隐藏分组(update includeGroup=false)、删除文案用模型 invalidAsinDeleteText。业务命名保留「不符合ASIN」。
- 256 商品类目:树 + 关键字搜索独立分页(加载更多) + 行/工具栏删除(有子类目禁用, `确定删除“X”?`)、导出(buildProductCategoryExportUrl)。**已知偏差**:未做 admin 的懒加载逐级拉取(`/product-categories/children` 分页),仍整树加载(后端已返回嵌套树);未做编辑时父级只读。可在 268 复查或按后端支持补。
- 257 查询ASIN:行内「配置」抽屉(逐国 ASIN 大写、留空=删除该站点 DELETE)、导入添加/删除导入(前置确认+轮询)、导出(`/query-asins/export`)。未做「新增单条(分组→店铺级联)」创建弹窗。
- 258 最低价ASIN:价格区间筛选(toSkipPriceParams 生效)、行内配置抽屉(ASIN+最低价、低价格式/低价必带ASIN 校验、留空删除)、导入添加/删除导入(group_id 必选)、导出(`/skip-price-asins/export`)。未做「新增单条」创建弹窗。
- 通用:删除/提示均走统一确认与反馈;ASIN 自动大写;宽表 ASIN 改为可读等宽字体(去掉无点击 el-link 的误导观感)。
## task 264-267 实现备注(fork 记录)
- 视频任务(264/265):视图改为任务卡片网格 + 原生 video(displayUrl) 播放;单卡下载走 `/image-video-tasks/download-zip` 单键 zip(后端无逐视频直链端点,文件名 `task-{id}-video-{n}.zip`,失败降级新窗口打开 displayUrl);复制链接用 clipboard;空态按状态区分文案;合计「共 N 个任务 · 本页 M 个视频」。
- 店铺数据任务(266/267):视图改为每店铺卡片;单文件下载接 `GET /api/admin/shop-data-crawl/results/{resultId}/download`(Content-Disposition 文件名,回退 `shop-data-task-{id}.xlsx`);删除接 `DELETE /api/admin/shop-data-crawl/history/{resultId}`(仅终态可删,确认含店铺/任务号,删除中提示);批量走 `/shop-data-crawl-tasks/download-zip`(X-Archive-Error-Count 提示包内错误清单);合计「共 N 家店铺 · 本页 M 个结果文件」。
- 待 268 复查:视频任务筛选仍保留 userId/status/执行ID 等既有字段(admin 仅有 用户名+提交时间);权限配置弹窗为「列表勾选+已授权计数」而非 admin 的 tabs/搜索形态;删除结果文件在旧 admin 属旧交互,按 Java 端点接(若非产品所需可在 268 摘除)。
@@ -0,0 +1,157 @@
# round2 对照矩阵:新版 15 页对齐旧版(除店铺撞款监控)
> 用途:task-284 之后的新一轮逐子菜单对齐执行清单。列 = 旧版基准(reference/old-admin/admin.html+admin.js 恢复物)↔ 新版现状 ↔ 差异动作 ↔ 断言。
> 范围:15 页。例外页 shop-center/duplicate-check(DuplicateCheckPage)不改。
> 公共项(所有页适用,批次 5 统一处理,逐页批次只负责把"页面特有"差异做掉):
> - A. 操作提示条(旧版 guides 表 14 项+fallback 原文在 admin.js)→ 布局单点实现 + 各页文案表。
> - B. 行内操作按钮形态:旧版 `.btn-sm` 实心小按钮 → 逐页把 link/text 判定为实心/保持。
> - C. 空态/确认/成功文案核对(旧版原文见下方基准摘录)。
> 状态列:待办 / 进行中 / 已改 / 目检。
## 1 UsersPage account/users admin_users
旧版要点:h3"用户列表";右上"新建用户";筛选 用户名+所属管理员(仅超管)+查询;列 ID/用户名/角色/所属管理员/创建时间/操作;行 编辑/删除;删除确认"确定删除用户 “xxx” 吗?";空态"暂无用户";guides 文案"先用筛选定位账号…步骤 筛选账号/编辑权限/确认保存"。
新版现状:h2"用户管理"+desc;卡内 table-toolbar"新建用户";筛选同;6 列 min-width;行内 link 编辑/删除(禁删原因提示);分页 sizes;CreateUserDialog/EditUserDialog+UserMenuAuthTree;无 guides。
差异动作:
- [ ] 行内 编辑/删除 形态对照旧版(公共项 B)。
- [ ] 删除确认句核对旧版"确定删除用户 “xxx” 吗?"。
- [ ] 空态"暂无用户"核对。
- [ ] guides 接线(公共项 A,文本见上)。
断言:align-user-* 源码测试更新。
## 2 MenusPage account/menus admin_columns
旧版要点:h3"菜单列表";右上"新增菜单";提示"拖动每行左侧的手柄…松开后自动保存";列 拖动手柄/ID/菜单名称/菜单类型/上级菜单/创建时间/操作;行 编辑/删除;确认"确定删除菜单“xx”吗?";空态"暂无菜单,请先在上方新增";页面下拉 COLUMN_PAGE_CATALOG 44 项;guides"菜单会影响后台和软件端的可见范围…步骤 新增或调整菜单/设置层级/拖动排序"。
新版现状:h2"菜单管理";已有拖拽手柄提示;树形表格(类型 tag app=info/后台=primary);新增/编辑 dialog 名称/类型/父/排序;客户端分页 10;行内 link。
差异动作:
- [ ] 行内按钮形态(B)。
- [ ] 删除确认/空态文案核对。
- [ ] "类型"文案 后台/软件 vs 新版 tag"后台/app"(旧版菜单类型=后台/软件,核对是否与数据同义)。
- [ ] guides 接线(A)。
断言:align-menu-* 更新。
## 3 GroupsPage account/groups admin_group_manage
旧版要点:顶部摘要 chips(超管"全部分组·N 个";成员"分组名 · 组长/组员",最多 4+另 N 个;无分组"未加入分组");h3"分组列表"+"新建分组";列 序号/分组名称/组长/组员数量/组员chips/创建/修改/操作;操作 仅组长或超管 编辑/删除;确认"确定删除分组“x”吗?";空态"暂无分组"。
新版现状:h2+desc;统计卡(分组总数/组员总数);分组名称/组长/组员数/组员tag墙/创建/修改/操作;行内 link;仅组长/超管可改;客户端分页;GroupEditorDialog。
差异动作:
- [ ] 摘要区形态:新版"统计卡(总数/总人数)" vs 旧版"分组 chips 摘要"——执行期目检裁决是否改 chips 形态。
- [ ] 行内按钮(B);确认/空态文案核对。
- [ ] 序号列(旧版有,新版无?核对)。
- [ ] guides fallback 接线(A:通用 fallback 文案)。
断言:align-group-editor 更新。
## 4 DedupeRegistryPage asin-center/registry admin_dedupe_total_data
旧版要点:摘要同分组 chips;h3"ASIN列表";右上 新增导入/删除导入;筛选 2 行(ASIN/用户名/分组/国家 DE..ES + 查询;开始/结束日期 + 导出 XLSX);列 ID/ASIN/国家中文/用户名/分组/创建/操作;导出全屏遮罩"已等待 N 秒";导入轮询 1s 进度"已处理 a/b,新增 x,跳过 y";删除总数据确认"确定删除总数据“xx”吗?";guides 文案见 admin.js。
新版现状:分组汇总卡(近似 chips);筛选 6 项;新增导入/删除导入/导出 table-toolbar;导出全屏遮罩+秒表;导入 dialog 进度 alert 轮询 300×1s 超时;编辑/删除 link;分组选项源 /shop-manage-groups。
差异动作:
- [ ] 删除确认文案"删除总数据“x”"与导入轮询文案与旧版逐字核对。
- [ ] 行内按钮形态(B)。
- [ ] guides 接线(A)。
断言:align-dedupe-summary 更新。
## 5 AsinInvalidPage asin-center/invalid admin_invalid_asin_data
旧版要点:h3"品牌数据列表";右上"新增";筛选 ASIN/品牌/分组;来源列 手动新增(MANUAL)/自动导入(AUTO);分组锁定(非超管强制其组,AUTO 编辑隐藏分组);确认"确定删除“xx”吗?";空态"暂无数据"。
新版现状:h2"不符合ASIN数据"(业务命名保留);来源 tag MANUAL 无 type / AUTO info;新增/编辑 520;AUTO 行编辑 includeGroup=false;分组 disabled 锁定非超管。
差异动作:
- [ ] 删除确认/空态文案核对("确定删除“xx”吗?")。
- [ ] 行内按钮(B)。
- [ ] guides 接线(A)。
断言:align-invalid-asin-lock 更新。
## 6 QueryAsinPage asin-center/query admin_query_asin
旧版要点:h3"店铺列表";右上 新增 ASIN/导入添加/导入删除;筛选 分组/店铺名/国家/ASIN + 查询 + 导出 XLSX(裸下载);列 序号/分组/店铺名/ASIN(可复制)/国家/操作(配置 每店 rowspan 合并);新增 ASIN 级联 分组→店铺;导入两种 Excel 格式+轮询 1s;删除导入确认"确定按 Excel 中的分组、店铺名和国家 ASIN 批量删除吗?";空态"暂无数据";guides"查询 ASIN 以店铺为单位维护…点右侧「配置」可一次维护该店铺所有站点"。
新版现状:新增/导入添加/导入删除/导出 toolbar;筛选同;rowspan 矩阵+CopyText;行内配置 link;新增 560 级联;导入 dialog 分组可选兜底;导出裸 a 跳转(与旧版一致)。
差异动作:
- [ ] 确认"新增 ASIN/导入添加/导入删除"三按钮文案与校验语义(含导入删除确认句)核对。
- [ ] 序号列/国家列顺序核对。
- [ ] 空态"暂无数据"核对。
- [ ] guides 接线(A)。
断言:align-query-asin 更新。
## 7 ProductCategoryPage asin-center/categories admin_product_categories ★重点
旧版要点:搜索条(占位"搜索类目名称、编码或备注")+ 搜索/清空/导出(btn-sm)/新增类目;树列 名称 24px/级缩进+[+/-]折叠+加粗;层级路径/排序/来源 tag(内置/自定义)/备注/操作;懒加载逐级 `/children` 分页 +"加载更多 已加载 a/b";行 编辑/删除(有子禁用 title 提示);编辑态 h3"编辑商品类目"+按钮"保存类目"+出现"取消编辑";校验"请填写类目名称";删除确认"确定删除“xx”?";导出 product-categories.xlsx;guides"类目树支持展开查看层级…步骤 搜索类目/展开层级/新增或编辑"。
新版现状:双视图(树视图 toolbar 新增/新增子类目/导出 + 已选提示;搜索视图分页);手写树形表格缩进+[+/−]+加粗+内置来源 tag;懒加载合成"加载更多 已加载 x/y";列 名称320/层级路径/排序/来源/说明/操作 link;弹窗 新增/编辑 560(父级/名称/排序/说明);**折叠钮色 indigo #6366f1/#eef0fe 残留**;后端整树加载未逐级分页;编辑时父级只读未做。
差异动作:
- [ ] **树折叠钮 indigo → 蓝白基线**(grep 6366f1/eef0fe)。
- [ ] 编辑弹窗"父级只读"(已存在父级时)核对后端能力后补。
- [ ] 树逐级懒加载 `/product-categories/children` 分页:核对后端是否已支持(不支持另开 Java 小任务)。
- [ ] 编辑态标题/按钮文案("编辑商品类目/保存类目/取消编辑")核对。
- [ ] 删除禁用(有子)title 提示核对。
- [ ] guides 接线(A)。
断言:align-product-category / align-category-tree 更新。
## 8 SkipPricePage asin-center/skip-price admin_skip_price_asin
旧版要点:h3"店铺列表";右上 新增 ASIN/导入文件新增/导入文件删除;筛选 分组/店铺名/国家/ASIN/最低价范围(≥ ≤ 两 number)+查询+导出;列 多一列"最低价";新增 ASIN 级联+最低价选填;导入删除确认"确定按 Excel 中的删除ASIN批量删除该店铺跳过跟价 ASIN 吗?";轮询 1.5s;空态"暂无数据"。
新版现状:同 Query 骨架+最低价区间同行双输入+最低价列右对齐;新增 560;导入 dialog 分组必选;配置 drawer 每国 ASIN+最低价 双列;复制/空态。
差异动作:
- [ ] 三按钮文案(新增 ASIN/导入文件新增/导入文件删除)与导入删除确认句核对。
- [ ] 行内按钮(B)。
- [ ] guides 接线(A)。
断言:align-skip-price 更新。
## 9 ShopKeysPage shop-center/keys admin_shop_keys
旧版要点:h3"店铺密钥列表";新增店铺密钥;无筛选;列 序号/备注名/紫鸟账号名称/紫鸟令牌(掩码)/白名单状态(title 检测详情)/创建/修改/操作;白名单 正常(绿)/未加白名单(红)/未检测(灰);确认"确定删除店铺密钥“xx”吗?";空态"暂无店铺密钥";guides"紫鸟令牌属于敏感配置…步骤 新增或筛选密钥/查看白名单状态/编辑或删除"。
新版现状:备注名/紫鸟账号名称/令牌掩码+tooltip/白名单状态 tag+tooltip/创建/修改/操作(text 小按钮 编辑/删除);新增/编辑 560(编辑留空令牌=沿用);无筛选。
差异动作:
- [ ] 行内按钮 text→对照 .btn-sm(B)。
- [ ] 序号列核对。
- [ ] 白名单状态文案"正常/未加白名单/未检测"与 title 检测时间核对。
- [ ] guides 接线(A)。
断言:align-shop-columns 更新。
## 10 ShopManagePage shop-center/shops admin_shop_manage
旧版要点:新增店铺;筛选 分组/店铺名;列 序号/分组/店铺名/商城名/自动化账号/账号/密码(******+眼睛→读取中...→明文+隐藏密码)/创建/修改/操作;长文本省略 title;分组锁定;确认"确定删除店铺“xx”吗?";空态"暂无店铺";guides"店铺信息按分组管理…步骤 选择分组/维护店铺信息/筛选核对结果"。
新版现状:筛选(自绘 label 上置 div);9 列 min-width;密码眼睛实时拉明文(读一次缓存只显一行);新增/编辑 600(编辑密码必填重填);明文凭据 dialog+复制;操作 text 编辑/凭证/删除。
差异动作:
- [ ] 行内按钮 text→.btn-sm(B)。
- [ ] 密码眼睛交互文案核对(读取中.../隐藏密码)。
- [ ] 序号列核对。
- [ ] guides 接线(A)。
断言:align-shop-columns 更新。
## 11 ShopDataTasksPage shop-center/data-tasks admin_shop_data_crawl_tasks ★重点
旧版要点:h3"店铺数据记录"+内 h4"筛选条件"(店铺/分组/国家/创建起止+查询/重置);toolbar 权限配置(仅超管)/批量下载(N)/全选当前页+进度+汇总"共 N 家店铺";每店铺卡片网格(卡头店铺名+勾选行"任务 {taskNo}"+状态徽章+信息行 分组/最新/国家/文件);操作 下载文件(仅 file_ready)/删除(终态才可删);删除确认"确认删除店铺“x”的任务 {id} 及结果文件?";批量 zip 进度"正在打包 N 个文件...";分页 20/页(无二级卡分页);guides"店铺数据任务按状态和时间筛选…步骤 筛选任务/检查状态/执行批量操作"。
新版现状:h2 已改名"店铺数据记录"(无"任务");筛选卡 店铺/分组/国家 5 国/创建 datetimerange;list-toolbar 全选(半选 indeterminate)/批量下载/权限配置+汇总"共 N 家店铺·本页 M 个结果文件";3 列宫格卡 9/页(task-273 用户亲定保留);卡脚 下载/删除 实心小按钮;**底部两级分页叠放(店铺 20/页 + 卡片 9/页)观感 bug**;无 el-card 外套;权限 dialog"列表勾选+已授权计数";删除结果文件=旧版无(新版独有,保留)。
差异动作:
- [ ] **两级分页叠放整合**:保 9 卡宫格,店铺级分页与卡片分页不叠放(单级 9/页 或卡区内独立不邻叠)→ 本地目检定案。
- [ ] 无 el-card:补卡壳(旧版上下双卡 form-box+panel-box)。
- [ ] 权限弹窗形态核对(旧版 tabs 已分配/全部+搜索+全选 vs 新版勾选)→ 交互等价则保留,汇总行文案"当前显示已分配用户,共 N 人"补。
- [ ] 文件头注释残留"任务/记录"清理。
- [ ] guides 接线(A)。
断言:align-shop-data-cards/grid 更新。
## 12 RecordsHistoryPage records/history admin_history
旧版要点:h3"筛选条件"(指定用户(全部)/开始/结束 datetime-local+查询);h3"生成记录";列 ID/用户/类型中文映射/创建时间/结果预览(≤3 缩略图 长图优先);空态"暂无记录";无删除交互;分页 15 无数字页码;guides"生成记录可按用户和时间范围回溯…步骤 设置时间范围/筛选记录/查看结果预览"。
新版现状:筛选卡 用户下拉(远程)+开始/结束 datetime;table-toolbar"清理数据"(task-278 用户亲定保留);列 ID/用户/类型中文/创建时间/结果预览(≤3 张 56px 缩略图+el-image 大图);空态按有无筛选区分;分页 pageSize 15 无 sizes;操作 text 查看大图。
差异动作:
- [ ] "清理数据"按钮形态/位置核对(保留,确认 danger plain 二次确认)。
- [ ] 行内按钮 text→.btn-sm(B)。
- [ ] guides 接线(A)。
断言:align-history-copy/clear 更新。
## 13 RecordsSoftwareVersionPage records/software-version admin_version
旧版要点:h3"版本列表";上传新版本;列 版本号/下载链接/创建时间/操作(下载);全量无分页;上传弹窗"上传软件 ZIP 包,系统会自动计算 MD5 并存储到 OSS",提交"上传软件版本",成功"发布成功。版本:{v},链接:{url}";校验 版本号必填/.zip;空态"暂无版本记录";guides"上传版本后请核对版本号和下载链接,再通知用户更新…步骤 上传压缩包/检查版本记录/维护历史版本"。
新版现状:table-toolbar 上传新版本;客户端分页 10(仅 prev/pager/next/jumper);上传 dialog 成功留驻弹窗含链接;空态"暂无版本记录";仅 .zip。
差异动作:
- [ ] 分页:旧版全量无分页 vs 新版客户端分页——执行期目检裁决(spec13 容忍"Vue 保留跳页",倾向保留分页,仅核观感)。
- [ ] 成功文案"发布成功。版本:v,链接:url"核对。
- [ ] guides 接线(A)。
断言:align-software-version 更新。
## 14 RecordsDigitalHumanVersionPage records/digital-human-version digital_human_version
旧版要点:h3"版本列表";上传新版本;列 版本号/状态(草稿#999/已发布#52c41a/已废弃#ff4d4f)/最新(★红)/文件大小(MB)/MD5(截12)/更新日志(截50)/发布时间/操作(240);操作矩阵 草稿→发布/已发布且非最新→设为最新/已发布→下载/非最新→删除(danger);确认文案(发布"确认发布版本 {v} 吗?"/设最新"确认将版本 {v} 设为最新吗?客户端会自动检测更新。"/删除"确认删除版本 {v} 吗?该操作会删除对应文件,无法恢复。");数字页码分页;上传说明(草稿→手动发布)+按钮"上传(草稿状态)";成功"上传成功!版本:{v}(状态:草稿…)"。
新版现状:table-toolbar 上传(草稿状态);9 列 min-width(状态 tag/最新★/文件大小/MD5 截12/更新说明省略+title/发布时间/操作列 240 text 彩色小按钮 发布/设最新/下载/删除 按状态矩阵显隐 行级 loading);客户端分页 20;上传 dialog 进度 alert;行级 ElMessageBox。
差异动作:
- [ ] 操作列按钮形态(彩色 text → 对照 .btn 体系语义/危险色)目检。
- [ ] 状态色/确认句逐字核对(上方原文)。
- [ ] 分页形态核对(数字页码 vs 新版 background 分页,容忍一致化即可)。
- [ ] guides 接线(A)。
断言:align-digital-human 更新。
## 15 ImageVideoTasksPage records/image-video-tasks admin_image_video_tasks
旧版要点:h3"视频任务记录筛选"(用户名/提交开始/提交结束 datetime-local+查询/重置);toolbar 权限配置(仅超管)/批量下载(N)/全选当前页+进度+汇总"共 N 个任务 · 本页 N 个视频";任务卡片网格(勾选+video controls+状态徽章+用户名/分组/模式/生成时间/调试链接复制+下载);无视频不可用提示;video 加载失败替换"视频加载失败,可尝试下载";状态 label 映射(PENDING 待执行…前缀兜底);批量进度"正在打包 N 个视频..."→"压缩包下载已开始"或失败清单;复制链接"已复制"1.6s;guides"可先使用筛选缩小任务范围…步骤 设置筛选/查看任务结果/按需处理任务"。
新版现状:筛选卡 用户名+datetimerange(+额外 userId/status/执行ID 字段——增强保留);list-toolbar 全选/批量下载(N)/权限配置+汇总;自绘 section.task-card(视频+下载/复制/明细);el-drawer 720 明细;权限授权 dialog 620;底部 table-footer 分页;无 el-card。
差异动作:
- [ ] 无 el-card 外套:补卡壳。
- [ ] 筛选额外字段保留,布局与旧版(用户名+时间)核对主次。
- [ ] 批量下载进度文案/状态映射核对。
- [ ] guides 接线(A)。
断言:align-image-video 更新。