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
@@ -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 更新。