清设计痕迹(卖源码): 删 84 项跟踪文档/spec/plan/prompt+5 支纯文档用例+4 支没人接进闸门的审计工具,9 支混合用例只摘读 docs 的那几段
V143–V152 的迁移契约用例逐支过:87 例 0 红(mvn -o test 实跑)。混合类里钉"迁移文件本体"的断言全部保留, 只删/只切按路径读 docs 的方法;两支 scannedSignaturesAreActuallyPresent 是防恒绿的自检, 它自检的对象(回滚补丁)已随文档出仓,那几行留在类里就变成给空断言背书,所以一并摘掉。 删除面 241 个唯一副本的归档在 D:\archive\design-scrub-2026-10-11\,逐个 sha256 回读。
This commit is contained in:
@@ -1,68 +0,0 @@
|
||||
# Multi-Server Start Commands
|
||||
|
||||
Use the same packaged jar on both servers. Do not switch code comments before packaging.
|
||||
|
||||
Requirements:
|
||||
- Build once: `mvn clean package -DskipTests`
|
||||
- Use profile: `server`
|
||||
- Put JVM options before `-jar`
|
||||
- Pass `AIIMAGE_INSTANCE_ID` and Redis address from the startup command
|
||||
- Result file job MQ is expected to stay enabled in packaged `server` deployments
|
||||
- Use `https://oss.aishufu.top` for the MinIO SDK and public object URLs; `https://minio.aishufu.top` is the management console only
|
||||
|
||||
1Panel server 121:
|
||||
|
||||
Environment variables:
|
||||
|
||||
```env
|
||||
SPRING_PROFILES_ACTIVE=server
|
||||
AIIMAGE_INSTANCE_ID=server-121
|
||||
AIIMAGE_REDIS_HOST=192.168.0.172
|
||||
AIIMAGE_REDIS_PORT=16379
|
||||
AIIMAGE_REDIS_PASSWORD=B6COTcY094TYe545
|
||||
AIIMAGE_REDIS_DATABASE=0
|
||||
AIIMAGE_SERVER_PORT=18080
|
||||
AIIMAGE_STORAGE_LOCAL_TEMP_DIR=/app/data/tmp
|
||||
AIIMAGE_OSS_ENDPOINT=https://oss.aishufu.top
|
||||
AIIMAGE_OSS_PUBLIC_ENDPOINT=https://oss.aishufu.top
|
||||
AIIMAGE_RESULT_FILE_JOB_MQ_ENABLED=true
|
||||
AIIMAGE_ROCKETMQ_NAME_SERVER=121.196.149.225:9876
|
||||
AIIMAGE_TRANSIENT_STORAGE_ENDPOINT=http://121.196.149.225:9000
|
||||
AIIMAGE_SIMILAR_ASIN_IMAGE_DOWNLOAD_POOL_SIZE=2
|
||||
```
|
||||
|
||||
Recommended startup command:
|
||||
|
||||
```bash
|
||||
java -Xmx2048M -Xms2048M -jar /app/aiimage-backend-0.0.1-SNAPSHOT.jar
|
||||
```
|
||||
|
||||
Baota server 111:
|
||||
|
||||
```bash
|
||||
/www/server/java/jdk-21.0.2/bin/java -Xmx1024M -Xms256M -jar /app/java/aiimage-backend-0.0.1-SNAPSHOT.jar --spring.profiles.active=server --aiimage.instance-id=server-111 --spring.data.redis.host=47.111.163.154 --spring.data.redis.port=16379 --spring.data.redis.password=B6COTcY094TYe545 --server.port=18080 --aiimage.storage.local-temp-dir=/app/data/tmp --aiimage.oss.endpoint=https://oss.aishufu.top --aiimage.oss.public-endpoint=https://oss.aishufu.top
|
||||
```
|
||||
|
||||
Optional Baota server 121 command:
|
||||
|
||||
```bash
|
||||
/www/server/java/jdk-21.0.2/bin/java -Xmx1024M -Xms256M -jar /app/java/aiimage-backend-0.0.1-SNAPSHOT.jar --spring.profiles.active=server --aiimage.instance-id=server-121 --spring.data.redis.host=192.168.0.172 --spring.data.redis.port=16379 --spring.data.redis.password=B6COTcY094TYe545 --server.port=18080 --aiimage.storage.local-temp-dir=/app/data/tmp --aiimage.oss.endpoint=https://oss.aishufu.top --aiimage.oss.public-endpoint=https://oss.aishufu.top
|
||||
```
|
||||
|
||||
Successful startup should show a line similar to:
|
||||
|
||||
```text
|
||||
[instance] resolved instanceId=server-121 source=configured
|
||||
```
|
||||
|
||||
or:
|
||||
|
||||
```text
|
||||
[instance] resolved instanceId=server-111 source=configured
|
||||
```
|
||||
|
||||
If the instanceId in the log does not match the startup command, the actual process was not started with the expected command.
|
||||
|
||||
For the 4-core production host, set the Java container CPU limit to 2.5 cores in 1Panel
|
||||
(container resources / CPU limit). Keep `AIIMAGE_SIMILAR_ASIN_IMAGE_DOWNLOAD_POOL_SIZE=2`.
|
||||
The application also clamps this pool to half of the JVM-visible processors as a second guard.
|
||||
@@ -1,36 +0,0 @@
|
||||
# Flyway 迁移演练 runbook(task-201)
|
||||
|
||||
> 目的:在**副本库**上验证新增迁移可干净执行、验证 SQL 通过、可回滚、可幂等重跑,且全程不动历史迁移。
|
||||
> 本文档为演练步骤与检查清单;on-DB 执行需运维在有副本库的机器按步骤进行(本地/CI 无库时不执行 migrate)。
|
||||
|
||||
## 前置
|
||||
|
||||
- 副本库:与生产同版本(MySQL 8.4),已执行到当前最大版本 V108(与生产一致)。
|
||||
- 拿到待演练的新迁移:`src/main/resources/db/V{N+1}__*.sql`,头注释引用 `docs/flyway-migration-template.md`(task-192)六项必填齐全。
|
||||
|
||||
## 演练步骤
|
||||
|
||||
1. **基线核对**:`flyway -url=<副本> info` 确认版本、描述、checksum 与生产一致;`git log` 确认历史 V1..V108 未被改动。
|
||||
2. **validate**:`flyway validate` —— 校验历史迁移 checksum,任何历史文件被改动会立刻失败(违规红线)。
|
||||
3. **干净迁移**:把待演练迁移放入后 `flyway migrate`;记录成功版本、耗时。
|
||||
4. **验证 SQL**:执行迁移头注释第 4 项的验证 SQL(行数/索引/SHOW INDEX),确认结果符合预期。
|
||||
5. **回滚验证**:按头注释第 5 项回滚脚本回滚新迁移(若无回滚脚本,验证迁移可幂等重跑替代)。
|
||||
6. **幂等重跑**:回滚后再 `flyway migrate` 一次,确认可重复、无残留副作用。
|
||||
7. **锁窗口评估**:索引类迁移记录执行耗时与是否 ONLINE,结合表数据量估算生产锁窗口。
|
||||
8. **收尾**:记录结论到本清单;生产窗口按 template 第 6 项执行。
|
||||
|
||||
## 离线静态检查(本仓库 JUnit 已覆盖)
|
||||
|
||||
- 迁移文件整数版本 1..N 连续、无重复(`MigrationInventoryTest`,task-193)。
|
||||
- 迁移校验和可复算稳定(同一文件两次读 SHA-256 一致,`MigrationInventoryTest`)。
|
||||
- 新迁移命名合规、模板六字段可引用(`FlywayMigrationTemplateDocTest`,task-192)。
|
||||
|
||||
## 完成检查
|
||||
|
||||
- [ ] 副本库 `flyway migrate` 干净执行(版本升至目标)
|
||||
- [ ] 验证 SQL 通过
|
||||
- [ ] 回滚验证通过 / 幂等重跑通过
|
||||
- [ ] 锁窗口已按表量估算并记录
|
||||
- [ ] 历史迁移未被改动(`flyway validate` 通过)
|
||||
|
||||
> 注:CI/本地无数据库环境时,本 runbook 的第 3-7 步需在带副本库的机器执行;仓库内以静态检查 + 本清单兜底。
|
||||
@@ -1,53 +0,0 @@
|
||||
# Flyway 迁移规范模板(task-192)
|
||||
|
||||
> 新增数据库迁移一律在本仓库 `src/main/resources/db/` 追加 `V{N+1}__*.sql`(版本号在现有最大版本之上加 1),
|
||||
> 每个迁移文件头必须引用本模板并补齐六项必填。**只追加,绝不修改已部署的历史迁移**(会破坏 Flyway 校验和)。
|
||||
|
||||
复制以下头注释到新迁移文件顶部并逐项填写:
|
||||
|
||||
```sql
|
||||
-- =============================================================
|
||||
-- 迁移 V{N+1}__<短横线描述>
|
||||
-- 模板:docs/flyway-migration-template.md(task-192)
|
||||
--
|
||||
-- 1. 变更目的:<一句话说明要解决什么问题 / 为何变更>
|
||||
-- 2. 影响表与数据量:<表名:预计行数 / 全表或增量;例如 biz_file_result ~50w 全表>
|
||||
-- 3. 锁表风险:<是否 ONLINE / 是否加锁 / 大表索引类需 ALGORITHM=INPLACE 评估;风险高则拆批或窗口执行>
|
||||
-- 4. 验证 SQL:<迁移后用于核对的行数 / 抽样语句,见下方示例>
|
||||
-- 5. 回滚步骤:<V{N}__<desc>.sql 或补丁脚本路径;无回滚写明原因>
|
||||
-- 6. 上线窗口:<建议窗口,例如 业务低峰 02:00-06:00;双节点滚动>
|
||||
-- =============================================================
|
||||
|
||||
-- 迁移语句(DDL/DML)…
|
||||
|
||||
-- 可选验证(与头注释第 4 项对应)
|
||||
-- SELECT COUNT(*) FROM <table>;
|
||||
```
|
||||
|
||||
## 六项必填说明
|
||||
|
||||
| # | 字段 | 要求 | 反例 |
|
||||
|---|------|------|------|
|
||||
| 1 | 变更目的 | 一句话,写清"为什么" | 留空 / 只写表名 |
|
||||
| 2 | 影响表与数据量 | 每张被改表名 + 预计行数量级 | "涉及多表" 不含表名 |
|
||||
| 3 | 锁表风险 | 指出 DDL 是否 INPLACE/排他、大表评估 | "无风险" 不说明依据 |
|
||||
| 4 | 验证 SQL | 迁移后可跑的核对语句 | 缺失 |
|
||||
| 5 | 回滚步骤 | 回滚脚本路径或明确不可回滚原因 | 缺失 |
|
||||
| 6 | 上线窗口 | 建议时段 + 是否滚动 | 缺失 |
|
||||
|
||||
## 示例验证 SQL(供第 4 项复制)
|
||||
|
||||
```sql
|
||||
-- 迁移后行数与迁移前基线对比
|
||||
SELECT COUNT(*) FROM biz_file_result;
|
||||
-- 新索引是否生效(用于索引类迁移)
|
||||
SHOW INDEX FROM biz_file_result WHERE Key_name = 'idx_task_module';
|
||||
-- 抽样数据
|
||||
SELECT id, task_id, status, updated_at FROM biz_file_task ORDER BY id DESC LIMIT 5;
|
||||
```
|
||||
|
||||
## 使用约束
|
||||
|
||||
- 版本号在 `src/main/resources/db/` 最大现有版本上加 1(当前 ≥ V109),不抢号、不重复。
|
||||
- 不修改、不删除任何已执行过的历史迁移文件。
|
||||
- 上线走双节点滚动 + 生产库先 `flyway validate`,失败即停。
|
||||
@@ -1,62 +0,0 @@
|
||||
# Flyway 迁移盘点(task-193)
|
||||
|
||||
> 生成方式:`src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java`(只读审计,可重复)。
|
||||
> 快照日期:2026-10-01;2026-10-03 随 V142 追加时同步过概览数字与取号起点;2026-10-04 随 V143 同步;2026-10-04 随 V144 同步;2026-10-04 15:1x 随 V145 同步;2026-10-05 随 V146 同步;2026-10-05 23:0x 随 V147 同步;2026-10-06 随 V148 同步(并把 V145/V146/V147 从"待发版"挪进"已应用");2026-10-06 随 V149 同步(菜单树按公司一套;V148 仍未上线,故 V149 与它同批);2026-10-06 随 V150/V151 同步,并删掉未上线的 V148(该号就此退役,见下);2026-10-07 随 V152 同步(并把 V149/V150/V151 从"待发版"挪进"已应用"——10-06 17:32 只读实查,success 全 1);2026-10-08 随 V153 同步(分组名收窄到同公司唯一;表侧只 13 行,写侧代码与本版必须同批)。
|
||||
|
||||
## 概览
|
||||
|
||||
- 版本化迁移文件数:**154**(`src/main/resources/db/V*.sql`,其中整数版本 153 个 + 小版本 V25_1)
|
||||
- 整数版本范围:**V1..V156**,其中 V132/V133/V148 为已退役空号(见下),其余连续
|
||||
- 历史遗留小版本:**V25_1__shop_manage_group_bind_user.sql**(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留)
|
||||
- 最新版本:**V156__dedupe_total_data_pioneer_backfill.sql**(上一版 **V155__users_disabled_at.sql**,再上一版 **V154__biz_dedupe_total_data_company_id_drop_default.sql**,其前 **V153__shop_manage_group_company_id.sql**,再往前 **V152__columns_shop_key_company_id_drop_default.sql**——概览往下推时旧文件名一个不许挤掉,`CompanyDefaultDropV152Test.inventoryDocTracksV152` 就是钉这件事的)
|
||||
- 待下一次 jar 发版执行:**V154、V155**(V152、V153 已于 10-09 09:50 随 jar `69d2ebb0` 双台同版应用——启动日志实查 "Current version of schema `aiimage`: 153 / Schema `aiimage` is up to date. No migration necessary.";V149/V150/V151 已于 10-06 17:32 应用。V153 给分组表加 `company_id` 并把分组名从"全平台唯一"收窄成"同公司唯一",**写侧代码必须同批**,两个方向单独发都不行——见 V153 头注释第 6 段;V154 只摘一列的默认值,前提逐条取证见下面的 V154 条目;V155 只给 `users` 加一列可空 `disabled_at`,140 行全取 NULL、对旧 jar 零行为差异,但它必须与读这列的代码同版——只发迁移则停用无人执行,只发 jar 则启动期读列即 1054)
|
||||
- 已应用:V142(10-03 18:23)、V143(10-04 10:48)、**V144(10-04 13:22)**、`V145__brand_dedupe_company_scope.sql`(10-05 13:01)、`V146__users_expires_at_admin_expiry.sql`(10-05 13:01)、**`V147__product_category_company_scope.sql`(10-06 11:03)**、`V149__permission_menu_company_tree.sql` / `V150__shop_key_company_scope.sql` / `V151__rule_tables_shared_across_companies.sql`(三条均为 10-06 17:32)
|
||||
- 末段 `flyway_schema_history` 为 2026-10-07 主机A 只读实查(`success` 全 1,最大整数版本 151),不是从 jar 版本推的
|
||||
- 重复版本:无
|
||||
- 迁移命名:全部符合 `V<整数>(_<子版本>)?__<描述>.sql`,无空格
|
||||
|
||||
## 生产已执行核对
|
||||
|
||||
生产 `flyway_schema_history` 末段:V125..V131 之后直接是 **V134__publish_item_free_text_columns**、**V135__dedupe_total_data_wide_columns**(两条 `installed_on` 均为 2026-09-25 20:46:16),库内没有 132/133 记录。
|
||||
|
||||
## 空号的来历(V132/V133/V148)
|
||||
|
||||
本地曾存在 `V132__web_config_add_is_latest.sql`、`V133__hide_redundant_indexes_invisible.sql`,与另一分支已在生产落库的 V134/V135 冲突。因 Flyway 未开启 `out-of-order`,把任何迁移编到 132/133 会在启动期报 "resolved migration not applied";因此这两条改为 **V136/V137**,132/133 永久退役,不可回填。
|
||||
|
||||
`V148__product_category_builtin_owned_by_company.sql`(把 18 行内置类目的归属从共享哨兵 0 改成厦门米椿花 1)从未上线,2026-10-06 控制方点名「商品类目做成共享的,不区分」⇒ 它的口径被 V151 整体推翻,文件连同 `ProductCategoryMigrationV148Test`、`docs/rollback-V148-product-category-builtin-shared.sql` 一起删除。它与 132/133 的区别要写清:**把新迁移编号写回 148 在 Flyway 语义上是可行的**(生产最大值仍是 147,不存在 out-of-order),这里禁它是共树并发的护栏——148 与 149/150 是同一工作区里另一路会话此刻正在引用的号,被删的 `V148` 文件可能被再次写出,而同号两个文件会让 Flyway 启动期报 "Found more than one migration with version 148" ⇒ 两台 java 同时起不来。宁可让 `integerVersionsSequentialFromOne` 的红字出现在测试里,也不把撞号留到运行期发现。因此这三个号都在 `MigrationInventoryTest.RETIRED_HOLES` 里登记。
|
||||
|
||||
后续新增迁移从 **V157** 起取号(V156 已被 `dedupe_total_data_pioneer_backfill` 占用:把组 33/uid=1188「先锋」名下账号已删的 1452 行 `company_id` 从兜底 1 回填到 3,配套读侧按行 company_id 收窄的 JAR 同批上线,回滚见 `docs/rollback-V156-dedupe-pioneer-backfill.sql`;V155 已被 `users_disabled_at` 占用:给 users 加一列可空停用时刻,回滚见 `docs/rollback-V155-users-disabled-at.sql`;V154 已被 `biz_dedupe_total_data_company_id_drop_default` 占用:只摘一列的默认值,回滚见 `docs/rollback-V154-dedupe-company-id-drop-default.sql`。只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,`integerVersionsSequentialFromOne` 会红;也不要回填上面那三个洞)。原先挂在 V149 名下的"摘 DEFAULT"待办,`columns` 那条已与 `biz_shop_key` 合并成 **V152** 发出(V150 头注释第 6 段要求"合并成一版发出";发布前的只读取证:`columns` 154 行按公司 52/51/51、`biz_shop_key` 16 行全 company_id=1 且无 NULL,两列 COLUMN_DEFAULT 都是 1)。摘 DEFAULT 这一族到此摘完,最后一条是 **V154**:
|
||||
|
||||
- `ALTER TABLE biz_dedupe_total_data ALTER COLUMN company_id DROP DEFAULT;` —— 已作为 **V154** 发出。V152 当年把它留在门外的前提是"先修写侧、上线并验证真实导入之后才谈摘",2026-10-09 只读探针(运维仓 `scripts/_probe_dedupe_default.py`,主机A,零写入)逐条对上:哨兵四张表里只剩这张仍带 DEFAULT 1(users / biz_shop_key / columns 的 COLUMN_DEFAULT 均为空);归属分布 company_id=1 共 546,344 行、=3 共 8,125 行,**没有 0 也没有 NULL**;孤儿归属 0 行;写侧显式落值那版上线后真实导入 29,555 行(2026-10-07 09:48:38 → 2026-10-08 23:57:51)。⚠ 本表批量导入走 `INSERT IGNORE`:在生产 sql_mode(实查含 STRICT_TRANS_TABLES)下省略该列不会撞 1364,而是被降级成 warning 并落成隐式默认 **0**——0 不属于任何公司,行插得进去但对所有公司隐形,比"静默归第 1 家"更难发现。⇒ **顺序必须是先上带 Java 闸门的 jar,再让本迁移随同一版生效**;闸门=`DedupeTotalDataService.requireCompanyAttribution`(接在 create 与 insertImportBatch 两条写通道上),用例 `DedupeTotalDataWriteAttributionTest` 4 例,其中接线钉按行首语句数调用点==2(避开 javadoc 同名提及那个坑)。
|
||||
|
||||
**`biz_product_category.company_id` 的 DEFAULT 由"待摘"改成"必须保留"**(这一条与 V151 同批生效):V151 之后新 jar 的 INSERT 列清单不含 `company_id`,而该列是 `NOT NULL`,全靠 `DEFAULT 1` 满足——此时执行 `DROP DEFAULT` 会让每一次新建类目报 1364。`biz_invalid_asin_data.company_id` 同理(品牌库那条写入失败还会被 `CollectDataInvalidAsinBatchWriter` 吞成 `log.warn` ⇒ 接口返回成功而黑名单静默少一批)。所以这两张表已从 `CompanyDefaultGuard.WATCHED_TABLES` 与探针 SQL 的 IN 列表里同时摘掉(清单与 SQL 由 `CompanyDefaultGuardTest` 双向钉同源),否则哨兵会在每次启动时对着一列"没人读、摘了会炸"的默认值喊 `COMPANY_DEFAULT_STILL_PRESENT`,而巡检把那条签名计进 ALERTS。
|
||||
它们真正消失的时点是下一版(两台同版之后):
|
||||
|
||||
- `ALTER TABLE biz_invalid_asin_data DROP COLUMN company_id;`
|
||||
- `ALTER TABLE biz_product_category DROP COLUMN company_id;`
|
||||
|
||||
摘除 DEFAULT 的动作在这两条里"顺带完成"(列没了,默认值随之消失),**仍然禁写成 `MODIFY COLUMN ... NOT NULL`**(重建表会按当时的列默认值物化历史行)。`biz_shop_key` 已在 **V152** 摘掉 DEFAULT,`biz_dedupe_total_data` 已在 **V154** 摘掉——两张的哨兵清单都原样保留:哪天默认值被 dump 重建或手滑装回,启动期还能再喊出来。
|
||||
|
||||
原先挂在待办里的"V137 冗余索引 DROP"迁移计划取 V139,该号已被 `V139__asin_result_cache.sql` 占用,顺延到 V140;V140 已被品牌补测队列表 `V140__collectdata_brand_recheck.sql` 落用。
|
||||
|
||||
## 已应用迁移的存量校验和(2026-10-04 与 2026-10-07 从生产 `flyway_schema_history` 只读实查)
|
||||
|
||||
| 版本 | 文件 | 校验和 | installed_on |
|
||||
|---|---|---|---|
|
||||
| 142 | `V142__web_config_sha256.sql` | `1152261840` | 2026-10-03 18:23:22 |
|
||||
| 143 | `V143__company_and_users_company_id.sql` | `1539570901` | 2026-10-04 10:48:54 |
|
||||
| 144 | `V144__users_company_id_drop_default.sql` | `1833593804` | 2026-10-04 13:22:00 |
|
||||
| 149 | `V149__permission_menu_company_tree.sql` | `593432281` | 2026-10-06 17:32:29 |
|
||||
| 150 | `V150__shop_key_company_scope.sql` | `2113095084` | 2026-10-06 17:32:29 |
|
||||
| 151 | `V151__rule_tables_shared_across_companies.sql` | `613473408` | 2026-10-06 17:32:30 |
|
||||
|
||||
上表各行的字节就此封死。校验和算法是 Flyway 的 CRC32 逐 `BufferedReader.readLine()` 的 UTF-8 字节累加(**行尾不入 CRC**,所以 CRLF 工作树与 LF 工作树算出同一个值);142/143/144 三个值被 `CompanyMigrationV144Test#appliedMigrationBytesAreFrozenAgainstProdChecksum` 用工作树字节复算比对,149/150/151 被 `CompanyDefaultDropV152Test#appliedV149V150V151BytesAreFrozenAgainstProdChecksum` 复算比对(10-07 本机复算三值全中)。
|
||||
|
||||
真事:10-04 上午有人(我)把"摘掉 `users.company_id` 的 DEFAULT"直接改成原地编辑 V143,取证才发现 V143 已在 10:48 落库——那样发出去的 jar 会让下次启动 Flyway 校验失败、**两台 java 都起不来**。口径变更因此写成 V144 前向修复,并把"已应用不许原地改"从注释升级成上面那条用例。
|
||||
|
||||
## 约束
|
||||
|
||||
- 审计测试断言:整数版本从 1 到当前最大值连续(`RETIRED_HOLES = {132, 133}` 内的号段除外)、无重复文件名、命名正则合规、历史文件校验和可复算稳定。
|
||||
- 修改任何已部署历史迁移会破坏 Flyway checksum,属违规;由本盘点测试 + code review 把关(git 层是否改动由 CI/review 校验)。
|
||||
- **回滚不得写成版本化迁移。** 本目录是 Flyway 扫描路径,任何 `V*.sql` 都会在应用下次启动时自动执行;把回滚编成 `V{N+1}__rollback_*.sql` 等于让"决定回滚"这件事在没有人工执行的情况下自己发生。回滚一律是本目录之外的人工补丁脚本(首例:`docs/rollback-V143-company.sql`),并要按"停应用 → 跑脚本 → 删 `flyway_schema_history` 对应版本行 → 回滚 jar"的顺序做,漏掉删历史那步会让将来重装时 Flyway 判定"已应用"而跳过重建。
|
||||
- **迁移必须可重跑。** MySQL 的 DDL 不进事务:迁移中途失败时前面的语句已经落库,而 `flyway repair` + 重启会让 Flyway 从第一条语句重跑整个文件。所以建表用 `IF NOT EXISTS`、插种子行用 `INSERT IGNORE` 或 `WHERE NOT EXISTS`、`ADD COLUMN/INDEX` 先查 `information_schema` 再 `PREPARE`(首例:V142 的条件 DDL、V143 全文件)。写成裸 `CREATE TABLE` / 裸 `INSERT ... VALUES` 的迁移,恢复路径本身会撞 1050/1060/1062,把"补数据后重启"变成"必须手工清库"。
|
||||
@@ -1,71 +0,0 @@
|
||||
# 公司 tab(批次 0-1)变异自证台账 — 2026-10-05
|
||||
|
||||
对应计划 `docs/plans/19-company-tab.md` Task 13 Step 1 / Step 1b。口径与一期、二期相同:**一条护栏只有在它的注入点真的变红时,才算钉住了**;没做过注入的"代码里写了 if"不构成证据。
|
||||
|
||||
## 执行环境与判据
|
||||
|
||||
| 项 | 值 |
|
||||
|---|---|
|
||||
| 后端 | `D:/tmp-wt-t13`(detached @ `99687f46`,`backend-java`)· Maven 3.9.16 + JDK 21 · 每轮先 `rmtree target/surefire-reports`,分母只取本轮 XML |
|
||||
| 前端 | 主树 `admin-frontend-vue` · `node --test`(**不是 vitest**)· 5 支文件 33 例为分母:`company-tab-wiring` 8 / `align-operation-guide` 10 / `company-user-create` 7 / `company-user-list` 4 / `company-tab-model` 4 |
|
||||
| 杀没杀的判据 | Java:本轮 XML `Tests run` 与 `Failures ≥ 1` **且** mvn rc=1;FE:`ℹ fail N`(U+2139 那三行)且 rc=1。摘要一律锚 `failed`/`fail` 这个词,不取"第一个数字" |
|
||||
| 还原 | 每轮开跑前把被注入文件写回**注入前读进内存的字节**;**全程没有用 `git checkout` / `restore` / `stash` / `clean` 做还原**(这个仓库同时有另一路会话在提交)。FE 轮末 `FINAL-RESTORE OK all touched files byte-identical`,后端两轮末 `FINAL-RESTORE OK all 7 files byte-identical` |
|
||||
| 锚点 | 每个注入锚串命中数必须恰好 1,否则本轮作废(`anchor hit exactly 1, injected` 逐轮打);CRLF 文件按 `\r\n` 对齐行尾 |
|
||||
| 对照 | FE `FR0` + `FRZ`;Java `R0` / `R06` / `R0Z` —— 全部 `rc=0` 无红,且 `R0` 是**改完用例之后又重跑过一次**的 |
|
||||
|
||||
## 表 1 · 前端 11 支(全 KILLED)
|
||||
|
||||
| 轮次 | 注入 | 红在哪 |
|
||||
|---|---|---|
|
||||
| FG-1a | 从 `COMPANY_SCOPED_PAGES` 删一行(`admin_device_logs`) | 2 条红(正向那支 + 缺口清单分母那支) |
|
||||
| FG-1b | 从 `src/api/user-secrets.ts` 删掉 `company_id = companyId` 那一行 | `company-tab-wiring` 正向 |
|
||||
| FG-7-3 | 往 `CompanyTabs.vue` 加回 `<span class="company-tab-hint">当前公司:…</span>`(未批的界面暴露回流) | `align-operation-guide` 反向那半 |
|
||||
| FG-7-4 | 从 8 支引导文案里删掉"超级管理员可用页面上方的公司 tab 切换公司"(`admin_user_secrets`) | `align-operation-guide` 分母那半 |
|
||||
| F1b-4a / 4b | `fetchTaskCenterOverview` / `fetchTaskCenterShopOptions` 的 `http.get(url, { params: query })` 退回 `http.get(url)` | 本轮新写的守卫「发送口的第二实参」(逐 URL 报 `匹配到 0 处(要求恰好 1)`) |
|
||||
| F1b-6a | 删掉 `DeviceLogsPage` 里 `watch(() => companyTab.activeId, …)` | `company-tab-wiring` 页面 reach 那半 |
|
||||
| F1b-6b | `companyTab.requestCompanyId` 换成 `companyTab.activeId` | 同上 |
|
||||
| F1b-6c | 直接删掉 getter 调用(`companyId: null`) | 同上 |
|
||||
| FG-7-5 | 往 `UsersPage.vue` 加回「所属公司」列头(SUPPL 反向钉) | `company-user-list` |
|
||||
| FG-7-6 | 建号的 `companyId` 闸门不再要求 `company_super_admin` 角色 | `company-user-create` |
|
||||
|
||||
## 表 2 · 后端 15 支(BG3-a 首轮 SURVIVED,修好后复跑 KILLED ⇒ 15/15)
|
||||
|
||||
| 轮次 | 注入 | 结果 · 红在哪 |
|
||||
|---|---|---|
|
||||
| BG2-1 | `AdminDeviceLogController.files` 整个不调 scope 出口(`memberUids = null`) | KILLED · `CompanyIdParamGoesThroughReadScopeTest` + `DeviceLogServiceTest` |
|
||||
| BG2-2 | `ShopManageController.page` 的绑定改成驼峰 `@RequestParam Long companyId`(静默失效那一形) | KILLED · G2 + `ShopManageServiceTest` |
|
||||
| B1b-1 | 绑定与 `readScope(` 都留着,**实参改成 `null`** | KILLED · G2 **断言 D**(这条正是断言 D 存在的理由) |
|
||||
| BG3-a | 非超管"传别家 ⇒ 空集"那一支整个删掉(忽略参数、按本公司重算) | 首轮 **SURVIVED** → 见下节 → 复跑 **KILLED** · `DataReadScopeTest.adminPassingForeignCompanyGetsEmptyNot403` |
|
||||
| BG3-b | 同一分支改成"不筛"(真正的越权逃逸读法) | KILLED · 同上那条用例 |
|
||||
| BG4-1/2/3 | 三个出口里逐个注释掉 `SUPER_ADMIN_ONLY_KEYS` | KILLED ×3 · `PermissionCompanyMenuHiddenTest` |
|
||||
| BG5 | `listVisible` 退回"非超管也可以" | KILLED · `CompanyReadPathMenuGateTest` |
|
||||
| BG6 | `MEMBER_WARN_THRESHOLD` 改成 `Integer.MAX_VALUE` | KILLED · `CompanyScopeSupportTest` 哨兵用例(该轮 selector 只点这一支,`tests=1` 是设计,不是漏跑) |
|
||||
| BG7-1 | 给写入口 `ShopManageController.create` 加一个 `company_id` 参数 | KILLED · G2 + `ShopManageServiceTest.writeEntryPointsCarryNoCompanyId` |
|
||||
| BG7-2 | 给 `AdminDeviceLogController.content` 加 `dataReadScope`(钉"刻意不配写侧") | KILLED · `DeviceLogServiceTest.singleFileEndpointsStayUnscoped` |
|
||||
| B1b-2a/2b | `ShopManageGroupService.list` 的 `and(w -> …or(x -> …))` 改成平铺 | KILLED ×2 · `ShopManageGroupServiceTest.groupListWrapsTheOrBeforeNarrowing` |
|
||||
| B1b-3 | 删掉 `page` 签名里的 `@RequestParam(name = "company_id")`,**留着** `@Operation` 那句文案 | KILLED · G2 取样自检 + `ShopManageServiceTest` |
|
||||
|
||||
## 1b ⑤:`grep -c "@Test"` 与本轮 surefire `Tests run` 逐类对平
|
||||
|
||||
`R0` 那一轮(无注入)实测:`CompanyIdParamGoesThroughReadScopeTest 2/2`、`DataReadScopeTest 7/7`、`PermissionCompanyMenuHiddenTest 7/7`、`CompanyReadPathMenuGateTest 3/3`、`ShopManageServiceTest 9/9`、`ShopManageGroupServiceTest 3/3`、`TaskCenterScopeServiceTest 13/13`、`DeviceLogServiceTest 19/19` ⇒ 合计 **63 = 本轮分母**,逐类相等。`CompanyScopeSupportTest` 不在 `CLASSES` 里(BG6 单独按方法点跑,`tests=1`),它的 11 支全量由后端全量门禁覆盖。这一条之所以要单列:**删掉一支用例的 `@Test`、留着方法体和 `@DisplayName`,没有任何尺子会红**——"全绿"和"那支根本没跑"同形。
|
||||
|
||||
## 作废的一轮(照实留,不当证据)
|
||||
|
||||
`t13-back-all.txt`:**15 支全部 VOIDED**,每轮读数都是 `tests=None failures=None`=解析没抓到本轮 XML 的计数。那一轮的两处控制(`R0` / `R06` / `R0Z`)却是 `GREEN` 并打印 `SURVIVED rounds: none` —— 这正是 memory「字符串断言必须排他」里"解析断言抓不到就恒绿"的形状:读不到数不等于杀掉了,也不等于没杀掉。处理方式是**整轮判 VOIDED 并重跑**(`t13-back-run2.txt`),而不是报成"0 红"。重跑轮 `VOIDED rounds: none`。
|
||||
|
||||
## BG3-a 为什么活下来,以及怎么修的
|
||||
|
||||
不是"注入没被执行到"(锚点命中恰好 1,同分支的 BG3-b 会红),而是**用例自己给了错误理由**:`DataReadScopeTest.adminPassingForeignCompanyGetsEmptyNot403` 只桩了 `companyScope.requireCompanyId(any()) → 2L`,从没桩过 `memberUserIds(2L)`,而 Mockito 对返回 `List` 的未桩方法**默认交空表**。于是"删掉 foreign 分支、按本公司重算"这条注入交出的也是空集,`assertThat(scope.userIds()).isEmpty()` 照绿——它验的其实不是"别家被折成空集",而是"什么桩都没加"。
|
||||
|
||||
修法(一处,两个桩):本公司两列都桩成**非空**——`memberUserIds(2L) → [21, 22]`、`resolveVisibleUserIds(5L) → [21, 99]`(形状照同文件 `adminIsAlwaysPinnedToOwnCompany` 已有的桩)。这样"空集"只能由 foreign 分支产生。
|
||||
|
||||
复跑证据(`t13-back-run3-bg3a.txt`,只重跑 `R0` / `BG3-a` / `BG3-b` 三轮):`R0` 先绿(`tests=63 rc=0`,`DataReadScopeTest=7/0/0`,加桩没把别的用例带红)⇒ `BG3-a` **KILLED**(`rc=1`,红点逐字 `DataReadScopeTest.adminPassingForeignCompanyGetsEmptyNot403`)⇒ `BG3-b` 仍 **KILLED**(同一条用例)。该轮末 `SURVIVED rounds: none`、`VOIDED rounds: none`、`FINAL-RESTORE OK all 7 files byte-identical`。
|
||||
|
||||
## 这一份台账没证明的东西
|
||||
|
||||
- **另一路的第二道门不在此列**。批次 2/3 正在把 `DataReadScope.readCompanyId(operator, companyId)` 变成第二个被认可的正门,并给 G2 加了 276 行的扩展样本(去重库/品牌库/查询ASIN/最低价ASIN/商品类目)。那些改动此刻**未提交**,本台账的后端证据全部跑在 `99687f46` 的 G2 上——第二道门的变异由那一路自己做。
|
||||
- 后端全量**在 BG3-a 用例修复之后重跑过**:`mvn -B test` @ `D:/tmp-wt-t13c`(detached `09aab729` + 本支修复后的 `DataReadScopeTest`)⇒ **3760 例 / 0 失败 / 0 错误 / 7 skipped / BUILD SUCCESS**(`rc=0`,9:16 min)。分母独立复算:本轮 `target/surefire-reports/TEST-*.xml` 共 **450** 个文件,逐个抓 `tests/failures/errors/skipped` 求和 = 3760/0/0/7,与 Maven 摘要逐数相符(两个读数来自两条通道,不是同一次解析)。修复前那版基线也是 3760/0(`gate_full_backend.log`)⇒ 加桩没改变例数(`DataReadScopeTest` 仍 7 支,本轮 XML 里就是 7)。**这一轮的第一次尝试是 BUILD FAILURE**,红的 20 条全是 `ExplainIndexAuditDocTest` / `ArchitecturePlanSection6DocTest` / `IndexMigrationV101Test` 的 `NoSuchFileException`——那三支读的是 **gitignore 的** `backend-java/docs/explain-index-audit.md`、`java-architecture-optimization-plan.md`、`docs/specs/*`,新出包 worktree 里没有;补件后单跑那三支 27/27 绿,才跑的全量。⇒ **"worktree 全量红"要先问是不是缺件,别当成回归**(`git check-ignore -v` 一查就分明)。
|
||||
- 前端已重跑:`admin-frontend-vue` **1739/1739/0**、`vue-tsc` rc=0;`frontend-vue` 710 例里唯一红是 `dead-code-cleanup.test.ts::test_bundle_build`,它断的是 `.gitignore` 的出包目录,worktree 里必红、主树 ✔。
|
||||
- `admin-frontend-vue/tests/live/*` 是真 E2E,没有 `AIIMAGE_LLM_*` 凭据会整批 skip ⇒ **从没跑过**。
|
||||
- 计划 Step 3 那八条人工实跑(非超管回归、越权实验、八页 tab 有效性、建号 vs 店铺归属口径、按 id 凭据闸门、麦象日志、保存权限、三眼看文案)**一条都没执行**——它们验的是生产长什么样,`mvn test` 与变异都盖不到。
|
||||
- 界面逐页视觉验证欠着(真人浏览器回读)。
|
||||
@@ -1,126 +0,0 @@
|
||||
# 巡店删除 Python 提交接口
|
||||
|
||||
本文档给 Python 端同学说明 `patrol-delete` 的结果回传方式。前端不会再提供“手动归档”按钮,任务收尾、XLSX 组装、OSS 上传与历史清理均由服务端自动完成。
|
||||
|
||||
## 1. 提交入口
|
||||
|
||||
- 方法:`POST`
|
||||
- 路径:`/api/patrol-delete/tasks/{taskId}/result`
|
||||
- Content-Type:`application/json`
|
||||
|
||||
示例:
|
||||
|
||||
```http
|
||||
POST /api/patrol-delete/tasks/123/result
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"shops": [
|
||||
{
|
||||
"shopName": "示例店铺",
|
||||
"submissionId": "patrol-delete:123:示例店铺:1711111111111",
|
||||
"chunkIndex": 1,
|
||||
"chunkTotal": 3,
|
||||
"shopDone": false,
|
||||
"countrySections": [
|
||||
{
|
||||
"country": "德国",
|
||||
"rows": [
|
||||
{
|
||||
"status": "正常",
|
||||
"quantity": "12",
|
||||
"deleteQuantity": "3",
|
||||
"processStatus": "处理中"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"cartRatios": [
|
||||
{
|
||||
"country": "德国",
|
||||
"ratio": "25%"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 2. 字段说明
|
||||
|
||||
- `shops`: 本次提交的店铺结果分片列表,至少 1 条。
|
||||
- `shopName`: 店铺名。服务端会按店铺名归并分片。
|
||||
- `submissionId`: 建议每个店铺任务周期内保持同一个 submissionId,方便排查日志。
|
||||
- `chunkIndex`: 当前分片序号,建议从 1 开始。
|
||||
- `chunkTotal`: 当前店铺总分片数。
|
||||
- `shopDone`: 当前店铺是否已全部提交完成。最后一片必须传 `true`。
|
||||
- `error`: 当前店铺执行失败时传错误信息。传了 `error` 后该店铺会直接记为失败并结束。
|
||||
- `countrySections`: 店铺各国家的状态数据。
|
||||
- `cartRatios`: 店铺各国家的购物车比例数据。
|
||||
|
||||
## 3. 分片合并规则
|
||||
|
||||
- 服务端按 `taskId + shopName` 聚合缓存。
|
||||
- 同一国家的 `countrySections[].rows` 会按提交顺序追加合并。
|
||||
- `cartRatios` 按国家覆盖,后到数据覆盖先到数据。
|
||||
- 当 `shopDone=true` 时,该店铺会被标记为完成。
|
||||
- 如果中途提交了 `error`,该店铺会被标记为失败,不再等待后续分片。
|
||||
|
||||
## 4. Excel 组装规则
|
||||
|
||||
最终结果文件使用 `xlsx/日常删除格式.xlsx` 对应的数据结构:
|
||||
|
||||
- 第 1 列:`店铺名`
|
||||
- 接着是 5 个国家块,每个国家 4 列:
|
||||
- 国家状态
|
||||
- 数量
|
||||
- 删除数量
|
||||
- 删除结果
|
||||
- 最后是 5 组购物车比例列:
|
||||
- 国家
|
||||
- 购物车比例
|
||||
|
||||
每个店铺输出规则:
|
||||
|
||||
- 一个店铺占用的行数 = 5 个国家中数据行数的最大值
|
||||
- 每个店铺处理完成后会额外空一行
|
||||
- 然后再写下一个店铺
|
||||
|
||||
任务整体完成后:
|
||||
|
||||
1. 服务端汇总所有已完成店铺的数据
|
||||
2. 组装成 XLSX
|
||||
3. 上传 OSS
|
||||
4. 前端历史任务中出现下载按钮,用户可直接下载
|
||||
|
||||
## 5. 自动收尾与超时补偿
|
||||
|
||||
前端不会手动触发归档,服务端自动处理:
|
||||
|
||||
- Python 正常把所有店铺都提交完成后,服务端立即尝试收尾。
|
||||
- 如果最后一次提交后未来得及触发收尾,定时补偿任务会再次尝试 finalize。
|
||||
- 如果某店铺已有部分有效数据,但 Python 异常退出,补偿任务会尽量把已有数据收尾成成功店铺。
|
||||
- 如果某店铺完全没有完整结果且已超时,服务端会将该店铺标记为失败。
|
||||
|
||||
当前超时配置来自后端配置项:
|
||||
|
||||
- `aiimage.delete-brand-progress.patrol-delete-stale-timeout-minutes`
|
||||
- Python should call `POST /api/tasks/{taskId}/heartbeat` every minute; timeout now uses only the normal stale-timeout setting.
|
||||
|
||||
## 6. 历史清理
|
||||
|
||||
服务端会定时清理历史数据,但会跳过仍在执行中的任务。
|
||||
|
||||
- `RUNNING` 任务不会被历史清理删除
|
||||
- 只有已完成或已失败的历史记录会进入清理范围
|
||||
- 临时目录缓存与结果目录也会定期清理
|
||||
|
||||
## 7. Python 端建议
|
||||
|
||||
- 一个店铺处理结束的最后一片一定要传 `shopDone=true`
|
||||
- 如果店铺失败,请直接回传 `error`
|
||||
- 大店铺建议按国家或按分页做分片,避免一次提交过大
|
||||
- 如果同一店铺会多次回传,`shopName` 必须保持一致
|
||||
- 如果最后一片提交成功,Python 端无需再调用额外“归档”接口
|
||||
@@ -1,233 +0,0 @@
|
||||
# 00-plan-overview.md — 全部任务总表
|
||||
|
||||
> 来源:`backend-java/docs/specs/00-overview.md` 与 01-13 号 spec(2026-08-31)
|
||||
> 任务粒度:每个功能点 8-15 分钟(写测试 ≥8 用例 → RED → 实现 → GREEN)
|
||||
> 执行纪律:单线程串行,禁止并行 agent 写代码;每任务独立 commit
|
||||
|
||||
## 任务总表
|
||||
|
||||
| N | 功能点 | 模块 | 依赖 |
|
||||
|---|---|---|---|
|
||||
| 1 | API_ENDPOINTS 路径常量表(17 页面模块路径分组) | 01 适配层 | 无 |
|
||||
| 2 | buildJavaUrl() 统一 URL 构造(前缀+endpoint+query) | 01 适配层 | 1 |
|
||||
| 3 | callJava() 统一响应解包(success/message/data + 非包装直通) | 01 适配层 | 2 |
|
||||
| 4 | extractErrorMessage 导出并覆盖 error/message/msg 三字段 | 01 适配层 | 3 |
|
||||
| 5 | normalizeStatus() 大小写归一(未知值透传) | 01 适配层 | 3 |
|
||||
| 6 | isTerminalStatus() 终态判定(SUCCESS/FAILED/CANCELLED 可配置) | 01 适配层 | 5 |
|
||||
| 7 | buildDownloadUrl() 统一下载 URL(user_id 附加规则) | 01 适配层 | 2 |
|
||||
| 8 | callJava 透传 AbortController(signal 取消) | 01 适配层 | 3 |
|
||||
| 9 | 进度类请求默认 10s 超时配置 | 01 适配层 | 3 |
|
||||
| 10 | types/task.ts 共享类型(TaskStatus/FilePhase/PageResult) | 01 适配层 | 无 |
|
||||
| 11 | 拆分 dedupe 模块 API(函数移动+行为不变测试) | 01 适配层 | 1,3 |
|
||||
| 12 | 拆分 split 模块 API | 01 适配层 | 1,3 |
|
||||
| 13 | 拆分 convert 模块 API | 01 适配层 | 1,3 |
|
||||
| 14 | 拆分 publish 模块 API | 01 适配层 | 1,3 |
|
||||
| 15 | 拆分 similar-asin 模块 API | 01 适配层 | 1,3 |
|
||||
| 16 | 拆分 appearance-patent 模块 API | 01 适配层 | 1,3 |
|
||||
| 17 | 拆分 delete-brand 模块 API | 01 适配层 | 1,3 |
|
||||
| 18 | 拆分 price-track 模块 API | 01 适配层 | 1,3 |
|
||||
| 19 | 拆分 shop-match/product-risk 模块 API | 01 适配层 | 1,3 |
|
||||
| 20 | 拆分 shop-data-crawl/query-asin 模块 API | 01 适配层 | 1,3 |
|
||||
| 21 | 拆分 withdraw/patrol-delete 模块 API | 01 适配层 | 1,3 |
|
||||
| 22 | 拆分 collect-data 模块 API | 01 适配层 | 1,3 |
|
||||
| 23 | 拆分 image-video/brand/permission/digital-human 模块 API | 01 适配层 | 1,3 |
|
||||
| 24 | java-modules.ts 改 re-export 聚合(旧 import 零改动) | 01 适配层 | 11-23 |
|
||||
| 25 | ResultFilePhase 新字段兼容默认值(可选字段兜底) | 01 适配层 | 10 |
|
||||
| 26 | 模块 API 快照契约测试基建(mock adapter 断言 URL/method/query) | 01 适配层 | 3 |
|
||||
| 27 | api-field-compat 注册高频响应 schema(task/result 核心字段) | 01 适配层 | 26 |
|
||||
| 28 | 死代码清理(拆分后未引用导出,grep 确认后删) | 01 适配层 | 24 |
|
||||
| 29 | 退避配置项(MaxMs/Factor 常量 + 默认值) | 02 轮询 | 无 |
|
||||
| 30 | getTaskPollBackoffMs 递增序列(500→1000→…→10000) | 02 轮询 | 29 |
|
||||
| 31 | 连续失败计数(成功/收到响应归零) | 02 轮询 | 30 |
|
||||
| 32 | 退避封顶(maxMs 后不再增长) | 02 轮询 | 30,31 |
|
||||
| 33 | 网络错误走退避且不触发终态 | 02 轮询 | 31 |
|
||||
| 34 | HTTP 4xx/5xx 与网络错误分类(记 onError) | 02 轮询 | 31 |
|
||||
| 35 | 未知状态不判终态测试固化(PENDING/SYNCING/空串) | 02 轮询 | 无 |
|
||||
| 36 | 终态任务仅一次 onTerminal(coordinator 语义) | 02 轮询 | 无 |
|
||||
| 37 | onTerminal 抛错后任务已移除语义测试(页面可重新 add) | 02 轮询 | 无 |
|
||||
| 38 | 同一轮多任务终态分别回调测试 | 02 轮询 | 无 |
|
||||
| 39 | in-flight 合并(timer 不叠加)测试补强 | 02 轮询 | 无 |
|
||||
| 40 | 页面隐藏降频(30s)与可见恢复(立即刷新)测试 | 02 轮询 | 无 |
|
||||
| 41 | storage 恢复(无效 id 过滤/空清理)测试 | 02 轮询 | 无 |
|
||||
| 42 | 退避恢复测试(失败→退避→成功→正常间隔) | 02 轮询 | 31,32 |
|
||||
| 43 | progressCache TTL 惰性清理边界测试 | 02 轮询 | 无 |
|
||||
| 44 | fetchProgress 轻量端点切换能力(getModuleProgressLight 接入) | 02 轮询 | 26 |
|
||||
| 45 | 轮询与历史刷新分离测试 | 02 轮询 | 无 |
|
||||
| 46 | 双页面同 key 互踩行为记录测试(只读断言现状) | 02 轮询 | 无 |
|
||||
| 47 | 轮询 baseline 统计(请求量/响应体大小)测试补强 | 02 轮询 | 无 |
|
||||
| 48 | 轮询全量回归(20 个既有测试保持绿) | 02 轮询 | 29-47 |
|
||||
| 49 | multipart 直通断言补测(content-type 大小写变体) | 03 过滤器 | 无 |
|
||||
| 50 | JSON/PUT/DELETE 包装与阈值钳制补测 | 03 过滤器 | 无 |
|
||||
| 51 | 日志不读 body 行为测试(过滤器通过后 body 仍可读) | 03 过滤器 | 无 |
|
||||
| 52 | 阈值生效集成测试(>1MB 请求不整包缓存) | 03 过滤器 | 无 |
|
||||
| 53 | yml 默认值 1MB 与 env 覆盖测试 | 03 过滤器 | 无 |
|
||||
| 54 | TaskOwnerForwardService 转发 multipart 安全测试(inputStream 路径) | 03 过滤器 | 无 |
|
||||
| 55 | 转发后 body 完整性测试(转发请求体与原请求一致) | 03 过滤器 | 54 |
|
||||
| 56 | plan §6 文档现状修正核对 | 03 过滤器 | 无 |
|
||||
| 57 | ResultFileJobHandler 接口定义(moduleType/process/cleanup/onFailure/offload/ownerScoped) | 04 注册表 | 无 |
|
||||
| 58 | 注册表容器(List 收集 + moduleType 唯一性校验) | 04 注册表 | 57 |
|
||||
| 59 | 启动校验(缺注册/双注册 fail-fast) | 04 注册表 | 58 |
|
||||
| 60 | SHOP_MATCH Handler(委托+payload.deleteLatest) | 04 注册表 | 57-59 |
|
||||
| 61 | PRICE_TRACK Handler | 04 注册表 | 57-59 |
|
||||
| 62 | PRODUCT_RISK_RESOLVE Handler | 04 注册表 | 57-59 |
|
||||
| 63 | PUBLISH Handler(ownerScoped) | 04 注册表 | 57-59 |
|
||||
| 64 | QUERY_ASIN Handler | 04 注册表 | 57-59 |
|
||||
| 65 | SHOP_DATA_CRAWL Handler(cleanup+onFailure) | 04 注册表 | 57-59 |
|
||||
| 66 | WITHDRAW Handler(tryFinalizeTask 时机保持) | 04 注册表 | 57-59 |
|
||||
| 67 | PATROL_DELETE Handler | 04 注册表 | 57-59 |
|
||||
| 68 | APPEARANCE_PATENT Handler(异步返回+offload+ownerScoped) | 04 注册表 | 57-59 |
|
||||
| 69 | SIMILAR_ASIN Handler(异步+offload+ownerScoped+onFailure) | 04 注册表 | 57-59 |
|
||||
| 70 | DELETE_BRAND Handler | 04 注册表 | 57-59 |
|
||||
| 71 | BRAND Handler(resolveResultObjectKey 特例) | 04 注册表 | 57-59 |
|
||||
| 72 | COLLECT_DATA Handler | 04 注册表 | 57-59 |
|
||||
| 73 | Worker dispatch() 改注册表查找 | 04 注册表 | 60-72 |
|
||||
| 74 | cleanupAfterSuccess 改 handler.cleanup + 公共 payload 清理 | 04 注册表 | 60-72 |
|
||||
| 75 | notifyRetryExhausted 改 handler.onFailure | 04 注册表 | 60-72 |
|
||||
| 76 | coze offload 判定改 handler.supportsAsyncOffload | 04 注册表 | 60-72 |
|
||||
| 77 | owner-scoped 判定改 handler.isOwnerScoped | 04 注册表 | 60-72 |
|
||||
| 78 | 模块映射快照测试(13 moduleType → Handler → 原方法) | 04 注册表 | 73 |
|
||||
| 79 | 行为等价对比测试(Job 状态迁移序列一致) | 04 注册表 | 73-77 |
|
||||
| 80 | 孤儿失败路径不回归(markFailedPermanent) | 04 注册表 | 73 |
|
||||
| 81 | 卡死扫描/重试耗尽路径测试 | 04 注册表 | 73 |
|
||||
| 82 | 特殊规则回归(WITHDRAW finalize、coze 等待 defer) | 04 注册表 | 78-81 |
|
||||
| 83 | SimilarAsinExcelParser 行解析器(POI 读行→中间行对象) | 05 拆分 | 无 |
|
||||
| 84 | 行解析边界(空行/超长/畸形 ASIN/BOM/混合编码) | 05 拆分 | 83 |
|
||||
| 85 | 字段归一化器(trim/大小写/ASIN 格式统一) | 05 拆分 | 无 |
|
||||
| 86 | 分组转换器(中间对象→TaskItem/FileItem) | 05 拆分 | 83,85 |
|
||||
| 87 | 纯校验器(必填/格式/去重) | 05 拆分 | 85 |
|
||||
| 88 | Sheet 构造器(workbook 构建辅助) | 05 拆分 | 无 |
|
||||
| 89 | SimilarAsinService.parse 门面改委托(签名不变) | 05 拆分 | 83-88 |
|
||||
| 90 | 抽取前后快照对比测试(夹具 Excel 同断言) | 05 拆分 | 89 |
|
||||
| 91 | SimilarAsin 历史查询组装抽取(VO 拼装) | 05 拆分 | 无 |
|
||||
| 92 | SimilarAsin 全量回归(mvn test 相关类) | 05 拆分 | 89-91 |
|
||||
| 93 | AppearancePatent 行解析/归一化抽取 | 05 拆分 | 83,85 |
|
||||
| 94 | AppearancePatent Sheet 构造抽取 | 05 拆分 | 88 |
|
||||
| 95 | AppearancePatent 门面改委托(签名不变) | 05 拆分 | 93,94 |
|
||||
| 96 | AppearancePatent 快照对比测试 | 05 拆分 | 95 |
|
||||
| 97 | AppearancePatent 历史查询组装抽取 | 05 拆分 | 无 |
|
||||
| 98 | AppearancePatent 全量回归 | 05 拆分 | 95-97 |
|
||||
| 99 | ShopDataCrawl 行解析抽取 | 05 拆分 | 83,85 |
|
||||
| 100 | ShopDataCrawl Sheet 构造抽取 | 05 拆分 | 88 |
|
||||
| 101 | ShopDataCrawl 门面改委托(签名不变) | 05 拆分 | 99,100 |
|
||||
| 102 | ShopDataCrawl 快照对比测试 | 05 拆分 | 101 |
|
||||
| 103 | ShopDataCrawl 历史查询组装抽取 | 05 拆分 | 无 |
|
||||
| 104 | ShopDataCrawl 全量回归 | 05 拆分 | 101-103 |
|
||||
| 105 | similarasin 历史列表 IN 查询批量加载 | 06 批量加载 | 无 |
|
||||
| 106 | appearancepatent 历史列表批量加载 | 06 批量加载 | 105 |
|
||||
| 107 | 结果列表关联 Job 批量加载(findAssembleJobs 覆盖审计) | 06 批量加载 | 无 |
|
||||
| 108 | dashboard 聚合查询(COUNT/GROUP BY 一次出) | 06 批量加载 | 无 |
|
||||
| 109 | progress/light 轻量接口(similarasin 首个) | 06 批量加载 | 无 |
|
||||
| 110 | progress/light 字段白名单(不含明细) | 06 批量加载 | 109 |
|
||||
| 111 | progress/light 空/超长 taskIds 行为 | 06 批量加载 | 109 |
|
||||
| 112 | progress/light 终态任务返回终态状态 | 06 批量加载 | 109 |
|
||||
| 113 | 其余模块 progress/light 接入(批量) | 06 批量加载 | 109-112 |
|
||||
| 114 | 批量加载等价快照测试(改造前后字段一致) | 06 批量加载 | 105-108 |
|
||||
| 115 | 高频查询 EXPLAIN 索引审计(产出迁移清单) | 06 批量加载 | 无 |
|
||||
| 116 | 索引迁移 V{N+1}(EXPLAIN 验证后追加) | 06 批量加载 | 115 |
|
||||
| 117 | progress/light user_id 权限过滤 | 06 批量加载 | 109 |
|
||||
| 118 | 前端 getModuleProgressLight 适配(调用轻量端点) | 06 批量加载 | 109,44 |
|
||||
| 119 | dashboard/history/progress 前端分离调用测试 | 06 批量加载 | 无 |
|
||||
| 120 | 大页数据(500 任务)性能回归 | 06 批量加载 | 105-108 |
|
||||
| 121 | N+1 扫描(逐条 selectById 循环审计) | 06 批量加载 | 无 |
|
||||
| 122 | 扫描确认的 N+1 批量化修复 | 06 批量加载 | 121 |
|
||||
| 123 | 06 全量回归 | 06 批量加载 | 105-122 |
|
||||
| 124 | @Transactional 方法审计清单(每模块) | 07 事务 | 无 |
|
||||
| 125 | similarasin 纯计算移出事务 | 07 事务 | 124 |
|
||||
| 126 | similarasin DTO 组装移出写事务 | 07 事务 | 124 |
|
||||
| 127 | similarasin 临时文件清理挂 afterCommit | 07 事务 | 124 |
|
||||
| 128 | appearancepatent 事务收缩 | 07 事务 | 124 |
|
||||
| 129 | shopdatacrawl 事务收缩 | 07 事务 | 124 |
|
||||
| 130 | publish 事务收缩 | 07 事务 | 124 |
|
||||
| 131 | collectdata 事务收缩 | 07 事务 | 124 |
|
||||
| 132 | /result 成功确认时机不变测试(200+success 在落库后) | 07 事务 | 125-131 |
|
||||
| 133 | 回滚语义不变测试(落库失败回滚) | 07 事务 | 125-131 |
|
||||
| 134 | done=true 封口时机不变测试 | 07 事务 | 125-131 |
|
||||
| 135 | 任务状态成功时机不变测试 | 07 事务 | 125-131 |
|
||||
| 136 | 事务外清理异常不阻断(日志+指标) | 07 事务 | 127 |
|
||||
| 137 | 重复提交幂等测试(同 submissionId) | 07 事务 | 132-135 |
|
||||
| 138 | 事务时长性能对比基准 | 07 事务 | 125-131 |
|
||||
| 139 | 07 全量回归 | 07 事务 | 132-138 |
|
||||
| 140 | 13 模块 file 字段契约快照测试(齐全+旧字段仍在) | 08 结果阶段 | 无 |
|
||||
| 141 | similarasin file 进度合成逻辑单测(Coze/Python/snapshot 三路径) | 08 结果阶段 | 无 |
|
||||
| 142 | fileReady/fileStatus 语义测试(无 job 时 SUCCESS 兜底) | 08 结果阶段 | 140 |
|
||||
| 143 | publish 文件级 file 状态测试 | 08 结果阶段 | 140 |
|
||||
| 144 | 前端 live progress 合并测试补强(history 缺失保留) | 08 结果阶段 | 无 |
|
||||
| 145 | 前端可下载判定测试(fileReady/fileStatus 终态) | 08 结果阶段 | 无 |
|
||||
| 146 | collectdata 自洽行为测试(success+downloadUrl 判定) | 08 结果阶段 | 140 |
|
||||
| 147 | downloadUrl 永不过期验证(generateFreshDownloadUrl 公开直链) | 08 结果阶段 | 无 |
|
||||
| 148 | 临时目录配置盘点(Transient/Storage Properties 现状) | 09 临时文件 | 无 |
|
||||
| 149 | 创建/访问时间记录审计与补缺 | 09 临时文件 | 148 |
|
||||
| 150 | 引用检查(清理前查 task_file_job/file_result) | 09 临时文件 | 148 |
|
||||
| 151 | 路径安全校验(规范化 + startsWith 根目录) | 09 临时文件 | 148 |
|
||||
| 152 | 清理失败吞异常记指标(不阻断主流程) | 09 临时文件 | 150,151 |
|
||||
| 153 | fileKey 兜底查找(进程重启后) | 09 临时文件 | 148 |
|
||||
| 154 | 磁盘容量告警(仅日志/指标输出) | 09 临时文件 | 152 |
|
||||
| 155 | 孤立文件巡检报表(只读) | 09 临时文件 | 150 |
|
||||
| 156 | 孤立 Job 巡检报表(只读) | 09 临时文件 | 无 |
|
||||
| 157 | 任务存在结果缺失巡检 | 09 临时文件 | 无 |
|
||||
| 158 | 结果存在文件缺失巡检 | 09 临时文件 | 无 |
|
||||
| 159 | 已完成任务活跃 Job 巡检 | 09 临时文件 | 无 |
|
||||
| 160 | 超保留期仍被引用巡检 | 09 临时文件 | 150 |
|
||||
| 161 | 巡检任务开关(默认 disabled) | 09 临时文件 | 155-160 |
|
||||
| 162 | 路径穿越测试(../ 输入被拒) | 09 临时文件 | 151 |
|
||||
| 163 | 引用中文件不清测试 | 09 临时文件 | 150 |
|
||||
| 164 | 清理失败不阻断测试 | 09 临时文件 | 152 |
|
||||
| 165 | 巡检只读测试(运行零删除) | 09 临时文件 | 155-161 |
|
||||
| 166 | 各客户端契约表盘点(超时/重试/幂等现状) | 10 HTTP 客户端 | 无 |
|
||||
| 167 | aiimage.http-client.* 配置命名空间 | 10 HTTP 客户端 | 166 |
|
||||
| 168 | Coze 客户端超时/重试配置接入 | 10 HTTP 客户端 | 167 |
|
||||
| 169 | 品牌检查客户端配置接入 | 10 HTTP 客户端 | 167 |
|
||||
| 170 | 紫鸟客户端配置接入 | 10 HTTP 客户端 | 167 |
|
||||
| 171 | 图片下载客户端配置接入 | 10 HTTP 客户端 | 167 |
|
||||
| 172 | 幂等重试守卫(非幂等不自动重试) | 10 HTTP 客户端 | 167 |
|
||||
| 173 | 超时生效测试(mock 慢端点) | 10 HTTP 客户端 | 168-171 |
|
||||
| 174 | 连接复用测试(连续请求复用底层连接) | 10 HTTP 客户端 | 168-171 |
|
||||
| 175 | Python 回调超时不变确认(只读测试) | 10 HTTP 客户端 | 无 |
|
||||
| 176 | 重试计数与日志字段 | 10 HTTP 客户端 | 172 |
|
||||
| 177 | 10 全量回归 | 10 HTTP 客户端 | 168-176 |
|
||||
| 178 | 日志字段规范落地(taskId/moduleType/stage 统一) | 11 可观测性 | 无 |
|
||||
| 179 | 禁止记录清单审计(Token/Cookie/body 不落日志) | 11 可观测性 | 178 |
|
||||
| 180 | Worker 日志字段对齐(04 改造后) | 11 可观测性 | 73 |
|
||||
| 181 | task.created/running 指标埋点 | 11 可观测性 | 无 |
|
||||
| 182 | task.success/failed/cancelled 指标埋点 | 11 可观测性 | 181 |
|
||||
| 183 | task.duration 指标埋点 | 11 可观测性 | 182 |
|
||||
| 184 | task.heartbeat.age 指标埋点 | 11 可观测性 | 无 |
|
||||
| 185 | file-job.* 指标埋点(pending/running/success/failed/duration/retry) | 11 可观测性 | 73 |
|
||||
| 186 | 上传耗时/大小指标埋点 | 11 可观测性 | 无 |
|
||||
| 187 | 临时磁盘指标埋点 | 11 可观测性 | 154 |
|
||||
| 188 | 指标标签规范(moduleType/instanceId) | 11 可观测性 | 181-187 |
|
||||
| 189 | 指标命名一致性测试(名称/标签断言) | 11 可观测性 | 188 |
|
||||
| 190 | 日志脱敏测试(敏感字段不落日志) | 11 可观测性 | 179 |
|
||||
| 191 | 双实例指标区分回归(instanceId 标签) | 11 可观测性 | 188-190 |
|
||||
| 192 | 迁移规范模板(目的/影响/锁表/验证/回滚/窗口) | 12 Flyway | 无 |
|
||||
| 193 | 历史迁移盘点(V87+ 现状核对,只追加不改) | 12 Flyway | 无 |
|
||||
| 194 | orphan Job 巡检 SQL | 12 Flyway | 无 |
|
||||
| 195 | orphan payload 巡检 SQL | 12 Flyway | 无 |
|
||||
| 196 | 任务存在结果缺失巡检 SQL | 12 Flyway | 无 |
|
||||
| 197 | 结果存在文件缺失巡检 SQL | 12 Flyway | 无 |
|
||||
| 198 | 已完成任务活跃 Job 巡检 SQL | 12 Flyway | 无 |
|
||||
| 199 | 超保留期引用巡检 SQL | 12 Flyway | 无 |
|
||||
| 200 | 巡检报表任务落地(默认关闭) | 12 Flyway | 194-199 |
|
||||
| 201 | 迁移演练(副本库 migrate + 验证 SQL) | 12 Flyway | 192 |
|
||||
| 202 | Python-contract 夹具准备(录制真实请求脱敏) | 13 契约 | 无 |
|
||||
| 203 | /result 幂等契约测试(同 submissionId 重复) | 13 契约 | 202 |
|
||||
| 204 | /items 分页语义契约测试 | 13 契约 | 202 |
|
||||
| 205 | parsed-payload 契约测试 | 13 契约 | 202 |
|
||||
| 206 | heartbeat 旧字段契约测试 | 13 契约 | 202 |
|
||||
| 207 | done=true 最后一批契约测试 | 13 契约 | 203 |
|
||||
| 208 | JavaApiResponse 包装契约测试(前端) | 13 契约 | 无 |
|
||||
| 209 | 字段兼容 schema 覆盖(user_id/task_ids/taskId/resultId/fileKey) | 13 契约 | 208 |
|
||||
| 210 | ArchUnit 依赖方向规则(Controller→Service→Mapper) | 13 契约 | 无 |
|
||||
| 211 | ArchUnit Controller 不访问 Mapper 规则 | 13 契约 | 210 |
|
||||
| 212 | ArchUnit task 模块不依赖业务模块(SPI 检查) | 13 契约 | 210 |
|
||||
| 213 | 前端共享层导出白名单(页面禁止直连 http) | 13 契约 | 无 |
|
||||
| 214 | progress/batch 轻量响应契约 | 13 契约 | 109 |
|
||||
| 215 | 下载 URL 格式契约(downloadUrl 公开直链) | 13 契约 | 147 |
|
||||
| 216 | CI 接入测试阶段(.gitea workflow 追加) | 13 契约 | 210-215 |
|
||||
| 217 | 快照对比工具(Service 拆分前后响应一致) | 13 契约 | 90 |
|
||||
| 218 | 结果文件格式契约(文件名/Sheet/列/ZIP 结构) | 13 契约 | 无 |
|
||||
| 219 | 13 全量契约回归 | 13 契约 | 202-218 |
|
||||
|
||||
**总任务数:219**
|
||||
|
||||
(原 222 规划在写入时合并了 3 个冗余项:40→41 合并降频测试、46→47 合并 baseline、112→113 合并终态返回,编号已重排为连续 1-219,与上表严格一致。)
|
||||
@@ -1,429 +0,0 @@
|
||||
# 01-plan — frontend-vue Java API 适配层
|
||||
|
||||
> 对应 `docs/specs/01-frontend-api-adapter.md`。技术栈:TypeScript + Vue3 + Vitest(`frontend-vue/`)。
|
||||
> 测试命令:`cd crawler-plugin/frontend-vue && npx vitest run <file>`;类型检查:`npx vue-tsc --noEmit`。
|
||||
|
||||
## 任务 1:API_ENDPOINTS 路径常量表
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
新建 `src/shared/api/endpoints.ts`,导出按模块分组的路径常量表 `API_ENDPOINTS`(17 个页面模块:split/dedupe/convert/publish/query-asin/similar-asin/appearance-patent/delete-brand/price-track/shop-match/product-risk/shop-data-crawl/withdraw/patrol-delete/collect-data/image-video/brand/permission/digital-human)。每个模块含 parse/activate/progress/history/result/download 等端点常量。路径值与现 java-modules.ts 内联 URL 完全一致(不含 /newApi/api 前缀,前缀由 buildJavaUrl 加)。
|
||||
|
||||
### 测试用例(≥8,先写 RED)
|
||||
1. test_endpoints_all_modules_present — 17 模块键齐全
|
||||
2. test_endpoint_path_format — 每个端点以 /api/ 开头
|
||||
3. test_no_newapi_prefix_in_endpoint — 不含 /newApi/api 前缀
|
||||
4. test_progress_batch_paths_match_controllers — progress 端点与 Java controller 路径一致(快照)
|
||||
5. test_download_paths_match — download 端点模式
|
||||
6. test_endpoints_frozen_snapshot — 常量表 JSON 快照(防漂移)
|
||||
7. test_endpoint_values_no_trailing_slash — 无尾斜杠
|
||||
8. test_endpoint_keys_convention — 键名 snake_case 或小驼峰一致性
|
||||
|
||||
### TDD 流程
|
||||
1. 写上述全部测试 → `npx vitest run src/shared/api/__tests__/endpoints.test.ts` 确认 RED(文件不存在)
|
||||
2. 实现 endpoints.ts → 确认 GREEN
|
||||
3. `npx vue-tsc --noEmit` 通过
|
||||
|
||||
### 验证方法
|
||||
`npx vitest run`(新建测试全绿)+ `npx vue-tsc --noEmit`。
|
||||
|
||||
## 任务 2:buildJavaUrl() 统一 URL 构造
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`buildJavaUrl(module, endpoint, query?)`:`/newApi` + `/api` 前缀 + endpoint + 可选 query 序列化;对空 query 不追加 `?`。与现有 `JAVA_API_PREFIX` 常量保持一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_build_url_prefixed — 输出以 /newApi/api 开头
|
||||
2. test_build_url_with_query — query 参数正确编码
|
||||
3. test_build_url_no_query — 无 query 不加 ?
|
||||
4. test_build_url_query_encoding — 特殊字符编码(空格/中文/&)
|
||||
5. test_build_url_empty_query_object — 空对象不加 query
|
||||
6. test_build_url_trailing_slash_endpoint — endpoint 尾斜杠规范化
|
||||
7. test_build_url_undefined_query — undefined 安全
|
||||
8. test_build_url_join_no_duplicate_slash — 前缀与端点之间无重复斜杠
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上:先 RED,实现 GREEN,`vue-tsc` 通过。
|
||||
|
||||
## 任务 3:callJava() 统一响应解包
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:2 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`callJava<T>(config): Promise<T>`:发起请求;响应 data 为 `JavaApiResponse<T>`(success/message/data)时解包返回 data;为 `LegacyApiSuccess`(success/msg/data)时兼容解包;非包装结构直通;success=false 抛错(message 优先);不改变 http.ts 现有导出。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_call_java_success_unwraps — JavaApiResponse 解包出 data
|
||||
2. test_call_java_legacy_msg_unwraps — LegacyApiSuccess(msg)解包
|
||||
3. test_call_java_success_false_throws — success=false 抛错
|
||||
4. test_call_java_message_precedence — message 优先于 msg 于 error
|
||||
5. test_call_java_non_wrapped_passthrough — 非包装对象直通
|
||||
6. test_call_java_null_data — success 且 data=null 返回 null
|
||||
7. test_call_java_network_error — 网络错误抛出 Error
|
||||
8. test_call_java_http_error_status — HTTP 错误状态提取 message
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 4:extractErrorMessage 导出与三字段覆盖
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
http.ts 的 `extractErrorMessage` 提升为命名导出(保持内部逻辑);错误对象覆盖 `error`/`message`/`msg` 三字段;字符串响应体回退;无字段回退 axios message / 通用文案。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_extract_error_field — error 字段优先
|
||||
2. test_extract_message_field — message 字段
|
||||
3. test_extract_msg_field — msg 字段
|
||||
4. test_extract_error_precedence — error > message > msg
|
||||
5. test_extract_string_body — 字符串响应体
|
||||
6. test_extract_fallback_message — 无字段回退
|
||||
7. test_extract_axios_non_error — 非 AxiosError
|
||||
8. test_extract_blank_values_skipped — 空字符串跳过
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 5:normalizeStatus() 状态归一
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`normalizeStatus(raw: string|null|undefined): string`:小写转大写(success→SUCCESS);带空格/连字符清理(in-progress→IN_PROGRESS);null/undefined/空串返回原样或 ''(不抛);未知值透传不改。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_normalize_lower_to_upper — success→SUCCESS
|
||||
2. test_normalize_mixed_case — rUnNiNg→RUNNING
|
||||
3. test_normalize_with_hyphen — in-progress→IN_PROGRESS
|
||||
4. test_normalize_null — null 安全
|
||||
5. test_normalize_undefined — undefined 安全
|
||||
6. test_normalize_empty_string — 空串返回空
|
||||
7. test_normalize_unknown_passthrough — 未知值(SYNCING)原样
|
||||
8. test_normalize_whitespace_padded — 首尾空白清理
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 6:isTerminalStatus() 终态判定
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:5 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`isTerminalStatus(status, extras?)`:默认 SUCCESS/FAILED 为终态;可扩展(CANCELLED);先经 normalizeStatus;空值非终态。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_terminal_success — SUCCESS true
|
||||
2. test_terminal_failed — FAILED true
|
||||
3. test_terminal_lowercase — success true(归一后)
|
||||
4. test_terminal_pending_false — PENDING false
|
||||
5. test_terminal_null_false — null false
|
||||
6. test_terminal_cancelled_default_false — CANCELLED 默认 false
|
||||
7. test_terminal_cancelled_extended_true — 传 extras 后 true
|
||||
8. test_terminal_unknown_false — 未知状态 false
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 7:buildDownloadUrl() 统一下载 URL
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:2 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`buildDownloadUrl(path, userId?)`:下载端点拼 user_id 附加规则(有 userId 时追加);已有 user_id 参数时不重复;无 userId 不追加;支持 freshDownloadUrl 优先的辅助 `resolveDownloadUrl(item)`(fresh 优先,缺失回退 downloadUrl)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_download_url_user_id — 追加 user_id
|
||||
2. test_download_url_no_user_id — 无 userId 不追加
|
||||
3. test_download_url_existing_user_id — 已含不重复
|
||||
4. test_resolve_download_fresh_priority — freshDownloadUrl 优先
|
||||
5. test_resolve_download_fallback — 缺失回退 downloadUrl
|
||||
6. test_resolve_download_both_blank — 都空返回空
|
||||
7. test_download_url_query_merge — 已有 query 合并
|
||||
8. test_resolve_download_null_safe — null 安全
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 8:callJava 透传 AbortController
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
callJava 支持 `{ signal }`:axios 透传;signal 已中止时请求立即失败(AbortError);页面卸载可取消 in-flight。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_signal_abort_before_send — 发送前中止立即拒绝
|
||||
2. test_signal_abort_mid_request — 进行中中止拒绝
|
||||
3. test_signal_passthrough — signal 传到 axios 配置
|
||||
4. test_signal_abort_error_message — 错误消息含 AbortError 特征
|
||||
5. test_signal_not_provided — 无 signal 正常
|
||||
6. test_abort_after_resolve — 完成后 abort 无副作用
|
||||
7. test_abort_rejects_promise — 中止拒绝 Promise
|
||||
8. test_signal_multiple_calls_independent — 多次调用互不影响
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 9:进度类请求默认超时
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
进度类 API 函数(get*TaskProgressBatch)默认 10s 超时(现有 30s);可通过配置覆盖;非进度请求保持 30s。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_progress_timeout_default — 进度请求 10s
|
||||
2. test_progress_timeout_override — 显式覆盖生效
|
||||
3. test_non_progress_timeout_30s — 非进度 30s
|
||||
4. test_timeout_config_name — 配置键存在且为正数
|
||||
5. test_progress_timeout_minimum — 非法配置钳制
|
||||
6. test_override_via_options — 函数级 options 覆盖
|
||||
7. test_timeout_zero — 0 钳制为正数
|
||||
8. test_default_config_freeze — 默认值快照
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 10:types/task.ts 共享类型
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
新建 `src/shared/api/types/task.ts`:`TaskStatus`(联合类型)、`ResultFilePhase`(fileReady/fileStatus/fileProgress*/freshDownloadUrl 可选)、`PageResult<T>`、`TaskProgressBatchVo`。纯类型,测试以类型断言为主(可降为 5 用例)。
|
||||
|
||||
### 测试用例(≥5)
|
||||
1. test_type_task_status_assignable — SUCCESS 等可赋值
|
||||
2. test_type_result_file_phase_all_optional — 字段全部可选
|
||||
3. test_type_page_result_shape — 分页字段结构
|
||||
4. test_type_progress_batch_shape — 批量进度结构
|
||||
5. test_type_compat_compile — vue-tsc 全量通过
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
先写类型 + 编译期断言(`@ts-expect-error` 负例),RED 后实现。
|
||||
|
||||
## 任务 11:拆分 dedupe 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
将 java-modules.ts 中 dedupe 相关函数(runDedupe/getDedupeHistory/deleteDedupeHistory/getDedupeResultDownloadUrl)及类型移到 `types/modules/dedupe.ts`;内部改调 callJava+buildJavaUrl;函数签名、参数、返回语义一字不变。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_dedupe_run_url — runDedupe 请求 URL 正确
|
||||
2. test_dedupe_run_method_payload — POST + 请求体
|
||||
3. test_dedupe_history_url — history URL/method
|
||||
4. test_dedupe_delete_history — delete URL/method
|
||||
5. test_dedupe_download_url — download URL + user_id
|
||||
6. test_dedupe_signature_unchanged — 参数顺序与类型快照
|
||||
7. test_dedupe_export_compat — 旧路径 import 可用
|
||||
8. test_dedupe_unwrap — 返回解包后的 data
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上(mock adapter 断言 URL)。
|
||||
|
||||
## 任务 12:拆分 split 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
与 11 同构:runSplit/getSplitHistory/deleteSplitHistory/getSplitResultDownloadUrl + SplitRunRequest/SplitRunVo/SplitHistoryVo/SplitArchiveEntry。
|
||||
|
||||
### 测试用例(≥8)
|
||||
split 对应 8 例:run URL/method/payload、history、delete、download+user_id、签名快照、旧 import 兼容、解包、异常回传。
|
||||
|
||||
## 任务 13:拆分 convert 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
与 11 同构:getExcelInfo/runConvert/getConvertHistory/deleteConvertHistory/getConvertResultDownloadUrl/getConvertTemplates/importConvertTemplate/setDefaultConvertTemplate/deleteConvertTemplate + 模板相关类型。
|
||||
|
||||
### 测试用例(≥8)
|
||||
convert 对应 8 例:getExcelInfo URL、runConvert 解析、history、download、模板列表/导入/默认/删除 URL、签名快照。
|
||||
|
||||
## 任务 14:拆分 publish 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
publish:parsePublish/activatePublishTask/activatePublishFile/getPublishItemsPage/getPublishTaskProgressBatch/submitPublishTaskResult/getPublishDashboard/getPublishHistory/deletePublishTask。
|
||||
|
||||
### 测试用例(≥8)
|
||||
publish 8 例:parse URL、activate、itemsPage 分页参数、progressBatch(含超时断言)、submitResult 请求体、dashboard、delete、签名快照。
|
||||
|
||||
## 任务 15:拆分 similar-asin 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
similar-asin:parseSimilarAsin/getSimilarAsinDashboard/getSimilarAsinHistory/getSimilarAsinTaskProgressBatch/activateSimilarAsinTask/deleteSimilarAsinTask/deleteSimilarAsinHistory/getSimilarAsinResultDownloadUrl。
|
||||
|
||||
### 测试用例(≥8)
|
||||
similar-asin 8 例:parse URL/payload、progressBatch 10s 超时、activate user_id、history、dashboard、delete task/history、download。
|
||||
|
||||
## 任务 16:拆分 appearance-patent 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
appearance-patent:parseAppearancePatent/getAppearancePatentParsedPayload/getAppearancePatentQueuePayload/getAppearancePatentDashboard/getAppearancePatentHistory/getAppearancePatentTaskProgressBatch/activateAppearancePatentTask/deleteAppearancePatentTask/deleteAppearancePatentHistory/getAppearancePatentResultDownloadUrl。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:parse、parsedPayload、queuePayload、progressBatch、activate、dashboard、history、delete/download。
|
||||
|
||||
## 任务 17:拆分 delete-brand 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
delete-brand:runDeleteBrand/getDeleteBrandHistory/deleteDeleteBrandHistory/getDeleteBrandTaskDetail/getDeleteBrandTaskDetails/getDeleteBrandTaskDownloadUrl/getDeleteBrandResultDownloadUrl/submitDeleteBrandResult。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:run URL、taskDetail/taskDetails、taskDownloadUrl、resultDownloadUrl、submitResult 请求体、delete、history、签名快照。
|
||||
|
||||
## 任务 18:拆分 price-track 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
price-track:listPriceTrackCandidates/add/deleteCandidate/getCountryPreference/putPreference/matchPriceTrackShops/createPriceTrackTask/getPriceTrackTasksBatch/getPriceTrackTaskProgressBatch/deletePriceTrackTask/loopRun 系列/checkTaskSkipPriceAsin/markPriceTrackDispatchFailed。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:create URL/payload、progressBatch、loopRun 创建/派发、skipAsin 检查、candidates、preference、download、签名快照。
|
||||
|
||||
## 任务 19:拆分 shop-match / product-risk 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
shop-match + product-risk:matchProductRiskShops/listProductRiskCandidates/add/deleteCandidate/getCountryPreference/putPreference/getShopMatchTaskProgressBatch/getProductRiskTaskProgressBatch/getProductRiskDashboard/getProductRiskHistory。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:matchShops URL、candidates CRUD、preference、两个 progressBatch、dashboard、history、签名快照。
|
||||
|
||||
## 任务 20:拆分 shop-data-crawl / query-asin 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
shop-data-crawl + query-asin:listShopDataCrawlCandidates/matchShopDataCrawlShops/createShopDataCrawlTask/getShopDataCrawlDashboard/getShopDataCrawlHistory/getShopDataCrawlTaskProgressBatch/deleteShopDataCrawlTask/deleteShopDataCrawlHistory/getShopDataCrawlResultDownloadUrl + query-asin 对应函数。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:create URL、progressBatch、candidates、dashboard/history、query-asin 组、download、签名快照、旧 import。
|
||||
|
||||
## 任务 21:拆分 withdraw / patrol-delete 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
withdraw + patrol-delete:listWithdrawCandidates/matchWithdrawShops/createWithdrawTask/submitWithdrawTaskResult/getWithdrawTaskProgressBatch/getWithdrawResultDownloadUrl + patrol-delete 对应。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:withdraw create、submitResult、progress、patrol-delete 组、download、签名快照、旧 import、异常回传。
|
||||
|
||||
## 任务 22:拆分 collect-data 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
collect-data:parseCollectData/activateCollectDataTask/getCollectDataItemsPage/getCollectDataDashboard/getCollectDataHistory/getCollectDataTaskProgressBatch/deleteCollectDataTask/deleteCollectDataHistory/failCollectDataTask/getCollectDataCountryPreference/putCollectDataCountryPreference。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:parse、itemsPage 分页参数、progressBatch、fail 请求体、preference、dashboard、delete、签名快照。
|
||||
|
||||
## 任务 23:拆分 image-video / brand / permission / digital-human 模块 API
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:1,3 **预估**:8-15 分钟
|
||||
|
||||
image-video(secret/workflow/voice/asyncTask 系列)+ brand(BrandTaskListResponse 相关)+ permission + digital-human 独立文件已有,移动对齐。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:image-video workflow 创建、result 查询、voice 列表/删除、brand 列表、permission、digital-human、签名快照、旧 import。
|
||||
|
||||
## 任务 24:java-modules.ts 改 re-export 聚合
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:11-23 **预估**:8-15 分钟
|
||||
|
||||
java-modules.ts 只保留 re-export:`export * from './types/modules/dedupe'` 等;删光被移动的函数体;任何旧 import 路径继续可用(类型与运行时双兼容)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_reexport_all_symbols — 全部导出符号可从 java-modules 获取
|
||||
2. test_reexport_type_compiles — 类型 import 可用
|
||||
3. test_reexport_no_duplicate — 无重复导出
|
||||
4. test_reexport_build_passes — vue-tsc 全量通过
|
||||
5. test_reexport_import_compat — 各页面旧 import 快照编译
|
||||
6. test_reexport_no_dead_body — 原函数体不存在(防残留)
|
||||
7. test_reexport_runtime_symbols — 运行时函数可调用
|
||||
8. test_reexport_vitest_full — 全量测试绿
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
先写 re-export 后的测试断言(指向符号存在)→ 尚未 re-export 时 RED → 改文件 GREEN → `npm run build`(vue-tsc + vite build)通过。
|
||||
|
||||
## 任务 25:ResultFilePhase 新字段兼容默认值
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:10 **预估**:8-15 分钟
|
||||
|
||||
`applyFilePhaseDefaults(item)`:fileReady/fileStatus/fileProgress* 缺省补默认(false/'PENDING'/0/0/0);旧 Java 版本响应(无新字段)时页面行为一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_defaults_filled — 缺省字段补齐
|
||||
2. test_existing_values_kept — 已有值不覆盖
|
||||
3. test_file_ready_true_preserved — true 保留
|
||||
4. test_partial_input — 部分字段缺失补齐
|
||||
5. test_null_input_safe — null 安全
|
||||
6. test_defaults_idempotent — 二次调用幂等
|
||||
7. test_status_success_maps_ready — fileStatus=SUCCESS 且 fileReady 缺失 → ready true
|
||||
8. test_unknown_status_untouched — 未知 status 不动
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 26:模块 API 快照契约测试基建
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:3 **预估**:8-15 分钟
|
||||
|
||||
测试基建:vitest + axios mock adapter(或拦截 http.request),对每个模块 API 函数断言(url, method, params, data)快照;集中式 `assertApiCall()` helper。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_snapshot_helper_url — helper 断言 URL
|
||||
2. test_snapshot_helper_method — 断言 method
|
||||
3. test_snapshot_helper_params — 断言 query
|
||||
4. test_snapshot_helper_body — 断言请求体
|
||||
5. test_snapshot_all_modules_covered — 全部已拆模块注册
|
||||
6. test_snapshot_fail_message — 失败信息含 URL 上下文
|
||||
7. test_snapshot_allowlist — 白名单外字段报错
|
||||
8. test_snapshot_regression_guard — 快照变更即失败
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 27:api-field-compat 高频响应 schema
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:26 **预估**:8-15 分钟
|
||||
|
||||
为 task/result 核心响应注册 schema(taskId/resultId/status/fileStatus/fileReady/downloadUrl 等),接入 createApiFieldCompatChecker 在契约测试与联调前跑检查。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_schema_task_required_fields — 必填字段声明
|
||||
2. test_schema_result_required_fields — 结果字段
|
||||
3. test_checker_passes_valid — 合法对象通过
|
||||
4. test_checker_missing_required — 缺必填报 missing
|
||||
5. test_checker_wrong_type — 类型不符报 type
|
||||
6. test_checker_batch — 批量检查
|
||||
7. test_schema_registered_modules — 各模块 schema 注册齐全
|
||||
8. test_schema_versioned — schema 版本标记
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 28:死代码清理
|
||||
|
||||
**所属模块**:01 适配层 **依赖**:24 **预估**:8-15 分钟
|
||||
|
||||
拆分后 grep 确认 java-modules.ts 无残留函数体、无未引用导出;删除确认死代码;`npm run build` + 全量测试验证。
|
||||
|
||||
### 测试用例(≥8,测试为验证型)
|
||||
1. test_no_unexported_duplicates — 无重复导出
|
||||
2. test_build_typecheck — vue-tsc 通过
|
||||
3. test_full_vitest_green — 全量测试绿
|
||||
4. test_no_console_debug_left — 无调试日志残留
|
||||
5. test_no_unused_import — 无未用 import(lint)
|
||||
6. test_entry_points_compile — 17 个入口编译
|
||||
7. test_bundle_build — vite build 产出
|
||||
8. test_git_diff_scope — 变更仅限 api 目录
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
`npm run build` + `npx vitest run` 全绿。
|
||||
@@ -1,399 +0,0 @@
|
||||
# 02-plan — 任务轮询审计补强
|
||||
|
||||
> 对应 `docs/specs/02-task-polling-audit.md`。技术栈:TypeScript + Vitest(`frontend-vue/`)。
|
||||
> 核心决策:不重写,只补强;`getTaskPollBackoffMs` 保持签名向后兼容。
|
||||
|
||||
## 任务 29:退避配置项(MaxMs/Factor)
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
task-progress-config.ts 新增 `getTaskPollBackoffMaxMs()`(默认 10000)与 `getTaskPollBackoffFactor()`(默认 2);默认值可通过 window 配置/测试注入覆盖。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_backoff_max_default — 默认 10000
|
||||
2. test_backoff_factor_default — 默认 2
|
||||
3. test_backoff_max_override — 可覆盖
|
||||
4. test_backoff_max_positive — 非正钳制
|
||||
5. test_backoff_factor_min_one — factor <1 钳制为 1
|
||||
6. test_backoff_config_isolated — 配置隔离(不串到其他用例)
|
||||
7. test_backoff_max_freeze — 默认值快照
|
||||
8. test_backoff_factor_freeze — factor 快照
|
||||
|
||||
### TDD 流程
|
||||
1. 写测试 → `npx vitest run src/shared/__tests__/task-progress-config.test.ts` RED
|
||||
2. 实现 → GREEN
|
||||
3. `vue-tsc --noEmit` 通过
|
||||
|
||||
## 任务 30:getTaskPollBackoffMs 递增序列
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:29 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`getTaskPollBackoffMs(attempt)`:500 * factor^attempt 递增;attempt=0 返回 500(与现状一致);上限 maxMs;现签名向后兼容(attempt 省略视为 0)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_backoff_attempt0_500 — attempt0=500
|
||||
2. test_backoff_attempt1_1000 — attempt1=1000
|
||||
3. test_backoff_attempt2_2000 — attempt2=2000
|
||||
4. test_backoff_sequence_monotonic — 序列递增
|
||||
5. test_backoff_capped_at_max — 封顶 10000
|
||||
6. test_backoff_no_attempt_default — 省略参数=500
|
||||
7. test_backoff_negative_attempt_zero — 负 attempt 当 0
|
||||
8. test_backoff_custom_factor — 自定义 factor 生效
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 31:连续失败计数
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:30 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
轮询循环维护失败计数:refreshOnce 成功(收到响应)归零;连续失败递增;提供测试可观测出口(onError 带 attempt)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_failure_count_increments — 连续失败递增
|
||||
2. test_success_resets_count — 成功后归零
|
||||
3. test_any_response_resets — 4xx 也算收到响应归零
|
||||
4. test_on_error_receives_attempt — onError 带 attempt
|
||||
5. test_initial_count_zero — 初始 0
|
||||
6. test_interleaved_fail_success — 失败成功交错计数正确
|
||||
7. test_count_bounded — 计数有界(不溢出)
|
||||
8. test_dispose_clears_count — dispose 后不再上报
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 32:退避封顶
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:30,31 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
失败计数继续增长但退避间隔停在 maxMs;达到封顶后不再增长(间隔恒等于 maxMs)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_backoff_cap_reached — 达到封顶
|
||||
2. test_backoff_stays_capped — 之后保持 maxMs
|
||||
3. test_cap_with_low_max — 低 maxMs 提前封顶
|
||||
4. test_cap_with_high_factor — 高 factor 快速封顶
|
||||
5. test_cap_resets_after_success — 成功后重新从 500 起
|
||||
6. test_cap_attempt_boundary — 恰好等于封顶那一档
|
||||
7. test_cap_integration_loop — 集成:循环内退避生效
|
||||
8. test_cap_config_negative — 非法 maxMs 钳制
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 33:网络错误走退避且不触发终态
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:31 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
网络错误(fetch 拒绝/超时)不触发 onTerminal、不修改 taskStatuses、进入退避;恢复后继续轮询。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_network_error_no_terminal — 不触发 onTerminal
|
||||
2. test_network_error_no_status_change — 状态不变
|
||||
3. test_network_error_backoff_scheduled — 进入退避
|
||||
4. test_network_error_on_error_called — onError 调用
|
||||
5. test_network_recovery — 恢复后轮询继续
|
||||
6. test_network_error_repeated — 多次失败仍退避
|
||||
7. test_network_error_keeps_task — 任务不丢失
|
||||
8. test_network_error_then_success — 失败后成功收到响应
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
vitest fake timers + mock fetch 拒绝。
|
||||
|
||||
## 任务 34:HTTP 4xx/5xx 分类
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:31 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
4xx/5xx 记 onError 并退避;5xx 且无法解析明细时不误判 FAILED;不触发终态。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_4xx_on_error — 4xx 记 onError
|
||||
2. test_5xx_on_error — 5xx 记 onError
|
||||
3. test_5xx_no_terminal_failed — 不误判 FAILED
|
||||
4. test_5xx_backoff — 5xx 退避
|
||||
5. test_5xx_unknown_status_untouched — 未知状态不动
|
||||
6. test_4xx_recovery — 4xx 后恢复
|
||||
7. test_status_500_partial_items — 部分 items 仍处理
|
||||
8. test_5xx_no_status_wipe — 不清空已有状态
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 35:未知状态不判终态固化
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
PENDING/SYNCING/空串/undefined 状态:isTerminal=false,不触发终态回调,轮询继续。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_pending_not_terminal — PENDING false
|
||||
2. test_syncing_not_terminal — SYNCING false
|
||||
3. test_empty_status_not_terminal — 空串 false
|
||||
4. test_undefined_status_not_terminal — undefined false
|
||||
5. test_unknown_status_continues_polling — 轮询继续
|
||||
6. test_mixed_terminal_unknown — 同批终态+未知分开处理
|
||||
7. test_custom_is_terminal — 自定义判定生效
|
||||
8. test_lowercase_unknown — 小写未知值也不误判
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
扩展 polling-state-machine.test.ts。
|
||||
|
||||
## 任务 36:终态任务仅一次 onTerminal
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
coordinator.markTerminal 语义:终态任务只触发一次 onTerminal;重复收到同任务终态不再回调;从轮询集合移除。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_terminal_called_once — 只一次
|
||||
2. test_terminal_removed_from_poll — 移除
|
||||
3. test_terminal_repeat_response — 重复响应不回调
|
||||
4. test_terminal_after_readd — 重新 add 后可再触发
|
||||
5. test_terminal_multiple_tasks — 多任务各自一次
|
||||
6. test_terminal_coordinator_order — markTerminal 先于 remove
|
||||
7. test_terminal_storage_cleared — localStorage 清空
|
||||
8. test_terminal_dispose_no_call — dispose 后不回调
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 37:onTerminal 抛错语义测试
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
onTerminal 抛错:任务已从轮询集合移除(语义固化);错误不中断其他终态回调;页面可自行重新 add() 恢复。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_terminal_error_does_not_break_loop — 不中断循环
|
||||
2. test_terminal_error_task_removed — 任务已移除
|
||||
3. test_terminal_error_re_add_works — 重新 add 生效
|
||||
4. test_terminal_error_other_tasks — 其他终态仍回调
|
||||
5. test_terminal_error_swallowed — 错误被捕获不抛到外层
|
||||
6. test_terminal_error_then_success — 后一轮正常
|
||||
7. test_terminal_error_not_retried — 不自动重试回调
|
||||
8. test_terminal_error_status_kept — 状态保留
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 38:同轮多任务终态分别回调
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
同一轮响应中多个任务同时终态:每个任务各触发一次 onTerminal(带各自 detail/status);顺序按响应顺序。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_multi_terminal_each_called — 各自回调
|
||||
2. test_multi_terminal_correct_detail — 各自 detail
|
||||
3. test_multi_terminal_correct_status — 各自 status
|
||||
4. test_multi_terminal_order — 按响应顺序
|
||||
5. test_multi_terminal_one_fails_other_runs — 一个抛错另一个仍回调
|
||||
6. test_multi_terminal_all_removed — 全部移除
|
||||
7. test_multi_terminal_await_sequence — 依次 await
|
||||
8. test_multi_terminal_async_on_terminal — 异步回调等待
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 39:in-flight 合并测试补强
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
in-flight 期间不叠加 timer;等待上一次完成再按退避重试;同一时间只有一个请求。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_in_flight_no_second_request — 不并发
|
||||
2. test_in_flight_queues_after — 完成后继续
|
||||
3. test_in_flight_backoff_wait — 等待按退避
|
||||
4. test_in_flight_timer_single — 仅一个 timer
|
||||
5. test_in_flight_add_during — 期间 add 不重复
|
||||
6. test_in_flight_error_releases — 失败后释放
|
||||
7. test_in_flight_immediate_repeat — ensure(true) 不叠加
|
||||
8. test_in_flight_long_request — 长请求期间无叠加
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 40:页面隐藏降频与可见恢复
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
visibilityState=hidden 时 30s 间隔;切回 visible 立即刷新(开关可配置、延迟可配置);降频不改任务集合。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_hidden_30s_interval — 隐藏 30s
|
||||
2. test_visible_5s_interval — 可见 5s
|
||||
3. test_foreground_refresh_triggered — 恢复立即刷新
|
||||
4. test_foreground_refresh_disabled — 开关关闭不刷新
|
||||
5. test_foreground_refresh_delayed — 延迟生效
|
||||
6. test_hidden_polling_continues — 隐藏仍轮询
|
||||
7. test_visibility_event_bound_unbound — 事件绑定/解绑
|
||||
8. test_hidden_no_immediate_refresh — 隐藏不触发即时刷新
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
mock document.visibilityState + dispatchEvent。
|
||||
|
||||
## 任务 41:storage 恢复与清理
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
恢复时过滤非正数/非数字;空列表清除 key;终态清理后同步 storage;写失败不影响功能。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_storage_restore_valid_ids — 恢复合法 id
|
||||
2. test_storage_restore_filters_invalid — 过滤非法
|
||||
3. test_storage_restore_empty_clears — 空列表清 key
|
||||
4. test_storage_terminal_removes — 终态后 key 更新
|
||||
5. test_storage_write_failure_ignored — 写失败不抛
|
||||
6. test_storage_bad_json — 坏 JSON 返回空
|
||||
7. test_storage_restore_starts_polling — 恢复即开始轮询
|
||||
8. test_storage_no_key_noop — 无 key 无操作
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
mock localStorage。
|
||||
|
||||
## 任务 42:退避恢复测试
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:31,32 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
失败→退避序列→成功→恢复 500ms 正常间隔;连续失败计数归零后重新从 500 起。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_recovery_after_failure — 失败后成功恢复
|
||||
2. test_backoff_reset_after_success — 计数归零
|
||||
3. test_interval_returns_to_base — 回到正常间隔
|
||||
4. test_recovery_cycle_repeat — 多次失败成功循环
|
||||
5. test_recovery_partial_items — 部分成功算成功
|
||||
6. test_recovery_with_foreground — 前台刷新下恢复
|
||||
7. test_recovery_after_many_failures — 长失败后恢复
|
||||
8. test_recovery_timing_assert — 时间断言(fake timers)
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
fake timers 时间断言。
|
||||
|
||||
## 任务 43:progressCache TTL 惰性清理边界
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
缓存条目超 TTL 在读取时清理;条目数上限(溢出淘汰最旧);空缓存 get 返回 undefined。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_cache_get_hit — 命中返回
|
||||
2. test_cache_get_expired_cleared — 过期清理
|
||||
3. test_cache_max_entries_evict — 超上限淘汰
|
||||
4. test_cache_empty_get_undefined — 空缓存
|
||||
5. test_cache_set_overwrites — 同 key 覆盖
|
||||
6. test_cache_ttl_zero — TTL=0 立即过期
|
||||
7. test_cache_lazy_cleanup — 惰性清理不主动扫
|
||||
8. test_cache_after_polling_cycle — 轮询周期内缓存可用
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
扩展 progress-response-cache.test.ts。
|
||||
|
||||
## 任务 44:轻量端点切换能力
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:26 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
useTaskProgressLoop 的 fetchProgress 可切到轻量端点(只返回 taskId/status/fileStatus 的 items);返回结构兼容(extractTaskId/extractStatus 从轻量字段取);默认仍走原端点。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_light_fetch_used — 切换后调轻量
|
||||
2. test_light_detail_shape_parsed — 轻量结构解析
|
||||
3. test_light_fallback_to_old — 默认旧端点
|
||||
4. test_light_missing_optional — 轻量缺字段容错
|
||||
5. test_light_terminal_detection — 终态判定
|
||||
6. test_light_progress_cache — 缓存写入
|
||||
7. test_light_on_update_called — onUpdate 收到
|
||||
8. test_light_snapshot_compat — 与旧响应兼容
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 45:轮询与历史刷新分离
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
进度轮询不触发历史接口;历史刷新独立触发(onTerminal 或页面主动);同一轮中不混发 history 请求。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_polling_no_history_request — 轮询不发 history
|
||||
2. test_terminal_triggers_history — 终态触发历史刷新
|
||||
3. test_history_separate_call — 独立调用
|
||||
4. test_no_burst_history — 同轮不多发
|
||||
5. test_history_ttl_cache — 历史 TTL 生效
|
||||
6. test_history_force_refresh — force 参数跳过缓存
|
||||
7. test_polling_history_parallel — 可并行不阻塞
|
||||
8. test_polling_continues_after_history — 历史后轮询继续
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 46:双页面同 key 行为记录
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
只读断言现状:两页面同 storageKey 时各自独立轮询集合,互不等待(记录已知边界,不改实现)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_two_loops_same_key_independent — 独立
|
||||
2. test_shared_key_no_crash — 不崩溃
|
||||
3. test_shared_key_last_write — 写互相覆盖(现状)
|
||||
4. test_shared_key_restore_both — 各自恢复
|
||||
5. test_shared_key_no_live_sync — 无实时同步(现状)
|
||||
6. test_shared_key_dispose_one — 一方卸载另一方不受影响
|
||||
7. test_documented_boundary — 行为与文档一致
|
||||
8. test_shared_key_separate_storage — 不同 key 完全隔离
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 47:轮询 baseline 统计补强
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
baseline 记录:请求量、响应体大小、缓存内存占用、轮询失败次数;每轮 refreshOnce 后回传 baseline 实例。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_baseline_request_count — 请求计数
|
||||
2. test_baseline_response_size — 响应大小
|
||||
3. test_baseline_cache_usage — 缓存占用
|
||||
4. test_baseline_failure_count — 失败次数
|
||||
5. test_baseline_callback_after_round — 每轮回调
|
||||
6. test_baseline_round_accuracy — 轮次准确
|
||||
7. test_baseline_reset — 重置
|
||||
8. test_baseline_optional_off — 不传 onBaseline 不创建
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
扩展 task-polling-baseline.test.ts。
|
||||
|
||||
## 任务 48:轮询全量回归
|
||||
|
||||
**所属模块**:02 轮询 **依赖**:29-47 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
20 个既有轮询相关测试 + 本轮新增全部通过;`npm run build`(vue-tsc)通过;无行为回退。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8. 回归清单:既有 20 文件全绿、新 19 文件全绿、build 通过、无类型错误、无未用导出、页面入口编译、快照一致、git diff 仅限 shared 目录
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
`npx vitest run` 全绿 + `npm run build` 通过。
|
||||
@@ -1,169 +0,0 @@
|
||||
# 03-plan — RequestTraceFilter 验证与补测
|
||||
|
||||
> 对应 `docs/specs/03-request-trace-filter.md`。**实现已完成**(multipart 直通、阈值 1MB、5 个测试)。
|
||||
> 本 plan 将测试补齐到 ≥8/功能点,并对实现做验证型补强。技术栈:Java 21 + JUnit5 + MockMvc(`backend-java/`)。
|
||||
> 测试命令:`cd crawler-plugin/backend-java && mvn test -Dtest=<类名>`。
|
||||
|
||||
## 任务 49:multipart 直通断言补测
|
||||
|
||||
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
multipart Content-Type(含大小写、带 boundary 参数、其他 multipart 子类型)请求一律不包装;现有 5 个测试保留。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_multipart_upper_boundary — Multipart/Form-Data 大写不包装
|
||||
2. test_multipart_mixed_case — mUlTiPaRt 混合大小写
|
||||
3. test_multipart_related — multipart/related 不包装
|
||||
4. test_multipart_no_boundary — 无 boundary 不包装
|
||||
5. test_multipart_with_params — 多参数 content-type
|
||||
6. test_multipart_whitespace — 首尾空白 content-type
|
||||
7. test_multipart_put_not_wrapped — multipart PUT 不包装
|
||||
8. test_application_json_still_wrapped — 对照:json 仍包装
|
||||
|
||||
### TDD 流程
|
||||
1. 追加测试 → 运行确认现有实现是否满足(若已满足为 GREEN,逐条确认覆盖)→ 任何一条失败修正实现
|
||||
2. `mvn test -Dtest=RequestTraceFilterTest` 全绿
|
||||
|
||||
### 验证方法
|
||||
`mvn test -Dtest=RequestTraceFilterTest`:Tests run ≥13。
|
||||
|
||||
## 任务 50:包装与阈值钳制补测
|
||||
|
||||
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
JSON/PUT/DELETE 包装;阈值钳制(<1MB 请求钳到 1MB 下限;0/负数钳制);ContentCachingRequestWrapper 构造参数生效。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_json_post_wrapped_limit — json 用传入阈值
|
||||
2. test_limit_below_minimum_clamped — 小于 1MB 钳制
|
||||
3. test_limit_zero_clamped — 0 钳制
|
||||
4. test_limit_negative_clamped — 负数钳制
|
||||
5. test_limit_exact_minimum — 恰好 1MB 不钳
|
||||
6. test_limit_large_kept — 大阈值保留
|
||||
7. test_delete_wrapped — DELETE 包装
|
||||
8. test_put_wrapped — PUT 包装
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上(构造 RequestTraceFilter 实例断言阈值字段,或包内可见字段读取)。
|
||||
|
||||
## 任务 51:日志不读 body 行为测试
|
||||
|
||||
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
过滤器执行前后:body 缓存未被读取(日志只消费 method/uri/status/headers);JSON 请求过滤后业务侧仍可读 body。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_filter_log_no_body_read — 日志不含 body 内容
|
||||
2. test_filter_passes_chain — 过滤链正常
|
||||
3. test_business_reads_body_json — 业务可读 json body
|
||||
4. test_business_reads_body_multipart — multipart 业务可读
|
||||
5. test_body_read_after_filter — 过滤后输入流可再读
|
||||
6. test_headers_added — 实例响应头存在
|
||||
7. test_cost_logged — costMs 记录
|
||||
8. test_request_id_logged — requestId 传递
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
MockMvc 集成:POST json 断言 200 + 业务 handler 收到 body。
|
||||
|
||||
## 任务 52:阈值生效集成测试
|
||||
|
||||
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
>1MB JSON 请求不整包缓存(wrapper 截断缓存);body 读取行为正确;multipart 大文件上传不受影响。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_large_json_over_1mb — >1MB json 请求成功
|
||||
2. test_large_json_not_cached_fully — 缓存截断(断言 wrapper 截断语义)
|
||||
3. test_large_multipart_upload — >1MB multipart 上传成功
|
||||
4. test_large_body_business_reads — 业务读完整 body
|
||||
5. test_small_json_cached — 小 json 正常缓存
|
||||
6. test_upload_content_length_header — content-length 保留
|
||||
7. test_large_json_forward_path — 转发路径大 body 正常
|
||||
8. test_large_json_time_bounded — 大 body 处理耗时合理
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
MockMvc + 大字符串 body(需注意阈值配置注入)。
|
||||
|
||||
## 任务 53:yml 默认值与 env 覆盖测试
|
||||
|
||||
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
application.yml 默认 1048576(1MB);`AIIMAGE_INSTANCE_ROUTE_REQUEST_BODY_CACHE_LIMIT_BYTES` 覆盖生效;占位符语法正确。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_yml_default_1mb — yml 值 1048576
|
||||
2. test_env_override_value — env 覆盖生效
|
||||
3. test_env_override_large — 大值覆盖
|
||||
4. test_env_override_small — 小值覆盖(被钳制)
|
||||
5. test_placeholder_format — ${VAR:default} 格式
|
||||
6. test_default_matches_code — 与代码默认一致
|
||||
7. test_env_unset_uses_default — 未设 env 用默认
|
||||
8. test_yml_loads — Spring 上下文加载配置
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
配置加载测试(@Value 注入断言)。
|
||||
|
||||
## 任务 54:转发服务 multipart 安全测试
|
||||
|
||||
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
TaskOwnerForwardService.requestBody 非 wrapper 时走 inputStream 路径;multipart 转发不抛错;body 字节与原请求一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_forward_non_wrapper_reads_stream — inputStream 路径
|
||||
2. test_forward_wrapper_reads_cache — wrapper 路径
|
||||
3. test_forward_multipart_body_ok — multipart 转发成功
|
||||
4. test_forward_io_error_message — IO 异常消息
|
||||
5. test_forward_hop_by_hop_removed — hop-by-hop 头剔除
|
||||
6. test_forward_forwarded_header_set — 转发头设置
|
||||
7. test_forward_content_type_kept — content-type 保留
|
||||
8. test_forward_loop_detected — 循环转发拒绝
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
MockHttpServletRequest + 反射/包可见调用 requestBody。
|
||||
|
||||
## 任务 55:转发 body 完整性测试
|
||||
|
||||
**所属模块**:03 过滤器 **依赖**:54 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
转发后:JSON 与 multipart body 均与原始一致(字节级);双实例 owner 路由场景转发内容不损坏。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_forward_json_bytes_equal — json 字节一致
|
||||
2. test_forward_multipart_bytes_equal — multipart 字节一致
|
||||
3. test_forward_empty_body — 空 body 安全
|
||||
4. test_forward_large_body — 大 body 一致
|
||||
5. test_forward_utf8_chinese — 中文内容一致
|
||||
6. test_forward_special_chars — 特殊字符一致
|
||||
7. test_forward_multiple_chunks — 多段内容一致
|
||||
8. test_forward_identity_repeated — 两次转发一致
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
同上。
|
||||
|
||||
## 任务 56:plan §6 文档现状修正核对
|
||||
|
||||
**所属模块**:03 过滤器 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
更新 `java-architecture-optimization-plan.md` §6:现状描述改为"已实现 multipart 直通 + 1MB 阈值 + 过滤器日志不读 body";移除"大范围缓存风险"表述;标注本轮未做项(上传指标/流式下载/磁盘告警→后续批次)。
|
||||
|
||||
### 测试用例(≥8,验证型)
|
||||
1. test_doc_no_obsolete_default — 文档无 104857600 残留
|
||||
2. test_doc_multipart_stated — 直通已记录
|
||||
3. test_doc_threshold_1mb — 阈值 1MB 已记录
|
||||
4. test_doc_not_reading_body — 不读 body 已记录
|
||||
5. test_doc_deferred_listed — 未做项已列
|
||||
6. test_doc_specs_referenced — 引用 03 spec
|
||||
7. test_doc_consistency_overview — 与 00-overview 实施记录一致
|
||||
8. test_doc_no_todo_left — 无 TBD/TODO 残留
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
grep 校验文档(写一个简单断言脚本/测试读取 md 断言)。
|
||||
@@ -1,419 +0,0 @@
|
||||
# 04-plan — TaskResultFileJobWorker Handler 注册表
|
||||
|
||||
> 对应 `docs/specs/04-result-file-job-handler-registry.md`。技术栈:Java 21 + Spring + JUnit5。
|
||||
> 纪律:第一阶段 Handler 只委托原 Service,不同时重写业务逻辑;Job 状态值、创建时机、重试入口不变。
|
||||
|
||||
## 任务 57:ResultFileJobHandler 接口定义
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`modules/task/service/ResultFileJobHandler.java`:moduleType() / process(job) 返回 boolean / cleanup(job) 默认空 / onFailure(job,msg) 默认空 / supportsAsyncOffload() 默认 false / isOwnerScoped() 默认 false。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_interface_methods_present — 6 方法签名齐全
|
||||
2. test_cleanup_default_noop — 默认空实现
|
||||
3. test_on_failure_default_noop — 默认空实现
|
||||
4. test_offload_default_false — 默认 false
|
||||
5. test_owner_scoped_default_false — 默认 false
|
||||
6. test_process_returns_boolean — boolean 返回类型
|
||||
7. test_module_type_identity — moduleType 唯一标识
|
||||
8. test_javadoc_contract — 契约文档注释齐全(模块类型对应表)
|
||||
|
||||
### TDD 流程
|
||||
1. 写接口 + 编译测试(实现类模拟)→ 类不存在 RED
|
||||
2. 实现接口 → GREEN
|
||||
3. `mvn test` 通过
|
||||
|
||||
## 任务 58:注册表容器与唯一性校验
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`ResultFileJobHandlerRegistry`:构造时收集 List<ResultFileJobHandler>,构建 moduleType→handler Map;重复 moduleType 抛 IllegalStateException(含模块名);提供 `resolve(moduleType)` 与 `moduleTypes()`。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_register_all_handlers — 全部注册
|
||||
2. test_resolve_existing — 解析已知模块
|
||||
3. test_resolve_unknown_throws — 未知模块抛异常
|
||||
4. test_duplicate_module_type_throws — 重复注册抛 IllegalStateException
|
||||
5. test_duplicate_error_message — 错误消息含模块名
|
||||
6. test_module_types_listed — 枚举全部模块
|
||||
7. test_empty_registry_ok — 空注册表可解析(抛错)
|
||||
8. test_resolve_case_sensitive — 大小写敏感
|
||||
|
||||
### TDD 流程
|
||||
1. 写测试(先 mock handler)→ RED
|
||||
2. 实现注册表 → GREEN
|
||||
3. `mvn test -Dtest=ResultFileJobHandlerRegistryTest` 通过
|
||||
|
||||
## 任务 59:启动校验(fail-fast)
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:58 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
Spring 启动时校验:TaskFileJobConfig 的每个 moduleType 有且仅有一个 Handler;缺注册(如新增模块未配 Handler)启动失败并给出缺失清单。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_startup_all_modules_covered — 全部 moduleType 覆盖
|
||||
2. test_startup_missing_handler_fails — 缺注册启动失败
|
||||
3. test_startup_missing_message_lists — 错误消息列缺失模块
|
||||
4. test_startup_duplicate_fails — 双注册失败
|
||||
5. test_startup_config_source — 从 TaskFileJobConfig 枚举
|
||||
6. test_startup_no_handler_new_module — 新模块无 handler 失败
|
||||
7. test_startup_valid_no_error — 合法配置启动通过
|
||||
8. test_startup_check_idempotent — 校验可重复执行
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
ApplicationContextRunner 或直接调用校验方法断言。
|
||||
|
||||
## 任务 60:SHOP_MATCH Handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`ShopMatchResultFileJobHandler`:moduleType="SHOP_MATCH";process 委托 shopMatchTaskService.processResultFileJob 返回 true;cleanup 调 taskResultPayloadService.deleteLatest(原 cleanupAfterSuccess 分支)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_type — 正确
|
||||
2. test_process_delegates — 委托调用
|
||||
3. test_process_returns_true — true
|
||||
4. test_cleanup_calls_delete_latest — 清理调用
|
||||
5. test_cleanup_args — taskId/moduleType/scopeKey 参数
|
||||
6. test_offload_false — 不支持异步
|
||||
7. test_owner_scoped_false — 非 owner scoped
|
||||
8. test_process_null_job_guarded — 空 job 安全
|
||||
|
||||
### TDD 流程
|
||||
1. 写测试 mock Service → RED
|
||||
2. 实现 Handler → GREEN
|
||||
3. `mvn test -Dtest=ShopMatchResultFileJobHandlerTest` 通过
|
||||
|
||||
## 任务 61:PRICE_TRACK Handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
与 60 同构:moduleType="PRICE_TRACK";process→priceTrackTaskService;cleanup→deleteLatest。
|
||||
|
||||
### 测试用例(≥8)
|
||||
8 例:moduleType、delegate、true、cleanup、参数、offload false、ownerScoped false、空 job。
|
||||
|
||||
## 任务 62:PRODUCT_RISK_RESOLVE Handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
与 60 同构:moduleType="PRODUCT_RISK_RESOLVE";process→productRiskTaskService。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 61。
|
||||
|
||||
## 任务 63:PUBLISH Handler(ownerScoped)
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
moduleType=PublishTaskService.MODULE_TYPE;process→publishTaskService.processResultFileJob;cleanup→publishTaskService.cleanupResultFileJob;**isOwnerScoped()=true**(原 Worker isOwnerScopedJob 含 PUBLISH)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_type_constant — 用 MODULE_TYPE 常量
|
||||
2. test_process_delegates
|
||||
3. test_cleanup_delegates — cleanupResultFileJob
|
||||
4. test_owner_scoped_true — true
|
||||
5. test_process_true
|
||||
6. test_cleanup_no_delete_latest — 不走 payload.deleteLatest
|
||||
7. test_offload_false
|
||||
8. test_null_job_guarded
|
||||
|
||||
## 任务 64:QUERY_ASIN Handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
与 60 同构:moduleType="QUERY_ASIN";process→queryAsinTaskService。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 61。
|
||||
|
||||
## 任务 65:SHOP_DATA_CRAWL Handler(cleanup+onFailure)
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
moduleType="SHOP_DATA_CRAWL";process→shopDataCrawlTaskService;cleanup→deleteLatest + cleanupResultFileJob(两处都调);**onFailure→handleResultFileJobFailure**;**isOwnerScoped()=true**。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_type
|
||||
2. test_process_delegates
|
||||
3. test_cleanup_delete_latest_and_service — 两处清理都调
|
||||
4. test_on_failure_delegates — handleResultFileJobFailure
|
||||
5. test_on_failure_args — job+message 参数
|
||||
6. test_owner_scoped_true
|
||||
7. test_process_true
|
||||
8. test_null_job_guarded
|
||||
|
||||
## 任务 66:WITHDRAW Handler(finalize 时机保持)
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
moduleType="WITHDRAW";process→withdrawTaskService.processResultFileJob;cleanup→deleteLatest;**onSuccess 扩展:tryFinalizeTask 在 markSuccess 之后调用**(原 finalizeWithdraw 标志语义,时机严格保持)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_type
|
||||
2. test_process_delegates
|
||||
3. test_cleanup_delete_latest
|
||||
4. test_finalize_after_success_order — 顺序:成功后再 finalize
|
||||
5. test_finalize_called_once — 只调一次
|
||||
6. test_finalize_false_result — 非成功不 finalize
|
||||
7. test_owner_scoped_false
|
||||
8. test_null_job_guarded
|
||||
|
||||
## 任务 67:PATROL_DELETE Handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
与 60 同构:moduleType="PATROL_DELETE";process→patrolDeleteTaskService。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 61。
|
||||
|
||||
## 任务 68:APPEARANCE_PATENT Handler(异步+offload)
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
moduleType="APPEARANCE_PATENT";process→appearancePatentTaskService(返回 boolean,false=等待异步);cleanup→cleanupResultFileJob;**supportsAsyncOffload()=true;isOwnerScoped()=true**。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_type
|
||||
2. test_process_boolean_true — true 情况
|
||||
3. test_process_boolean_false — false(等待异步)
|
||||
4. test_cleanup_delegates
|
||||
5. test_offload_true
|
||||
6. test_owner_scoped_true
|
||||
7. test_false_means_waiting — false 语义与 Worker defer 对应
|
||||
8. test_null_job_guarded
|
||||
|
||||
## 任务 69:SIMILAR_ASIN Handler(异步+offload+onFailure)
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
moduleType="SIMILAR_ASIN";process→similarAsinTaskService(boolean);cleanup→cleanupResultFileJob;**onFailure→handleResultFileJobFailure;offload=true;ownerScoped=true**。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_type
|
||||
2. test_process_true / 3. test_process_false
|
||||
4. test_cleanup_delegates
|
||||
5. test_on_failure_delegates
|
||||
6. test_offload_true
|
||||
7. test_owner_scoped_true
|
||||
8. test_null_job_guarded
|
||||
|
||||
## 任务 70:DELETE_BRAND Handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
moduleType="DELETE_BRAND";process→deleteBrandRunService;cleanup→cleanupResultFileJob。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:moduleType、delegate、true、cleanup、offload false、ownerScoped false、参数、空 job。
|
||||
|
||||
## 任务 71:BRAND Handler(resolveResultObjectKey 特例)
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
moduleType="BRAND";process→brandTaskService.processResultFileJob;**resultFileUrl 解析特例:resolveResultObjectKey(无 resultId 也走)保留在 Worker 公共路径 resolveResultFileUrl**——Handler 不接管 URL 解析,测试验证该特例不受影响。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_type
|
||||
2. test_process_delegates
|
||||
3. test_result_url_brand_special — brand resolveResultObjectKey 仍走公共路径
|
||||
4. test_cleanup_delegates
|
||||
5. test_offload_false
|
||||
6. test_owner_scoped_false
|
||||
7. test_null_job_guarded
|
||||
8. test_no_delete_latest — brand 不走 payload.deleteLatest
|
||||
|
||||
## 任务 72:COLLECT_DATA Handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:57-59 **预估**:8-15 分钟
|
||||
|
||||
moduleType="COLLECT_DATA";process→collectDataService.processResultFileJob;cleanup 为空(原无分支)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_type
|
||||
2. test_process_delegates
|
||||
3. test_process_true
|
||||
4. test_cleanup_noop — 无清理
|
||||
5. test_offload_false
|
||||
6. test_owner_scoped_false
|
||||
7. test_null_job_guarded
|
||||
8. test_no_delete_latest
|
||||
|
||||
## 任务 73:Worker dispatch() 改注册表查找
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
TaskResultFileJobWorker.dispatch(job) 替换 13 个 if/else 为 `handlerRegistry.resolve(moduleType).process(job)`;未知模块 IllegalArgumentException 消息保留;Worker 注入改为 registry。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_dispatch_resolves_handler — 注册表查找
|
||||
2. test_dispatch_known_module — 已知模块行为一致
|
||||
3. test_dispatch_unknown_throws — 未知模块 IllegalArgumentException
|
||||
4. test_dispatch_unknown_message — 消息含模块名
|
||||
5. test_dispatch_all_13_modules — 13 模块各委托正确
|
||||
6. test_dispatch_null_job — 空 job 安全
|
||||
7. test_dispatch_no_longer_branch — 无 if/else 残留(静态检查)
|
||||
8. test_dispatch_integration_process — process 全链路
|
||||
|
||||
### TDD 流程
|
||||
1. 测试先断言 dispatch 行为(对现有实现 GREEN 基线)→ 改为注册表后仍 GREEN
|
||||
2. `mvn test` 相关测试通过
|
||||
|
||||
## 任务 74:cleanupAfterSuccess 改 handler.cleanup
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
|
||||
|
||||
cleanupAfterSuccess(job):公共 payload 清理保留(部分模块)或进 handler.cleanup;确保原分支语义逐一映射(SHOP_DATA_CRAWL 两处、APPEARANCE_PATENT/SIMILAR_ASIN/PUBLISH/DELETE_BRAND 各 cleanup、其余 deleteLatest)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_cleanup_shop_data_crawl_both — 两处清理
|
||||
2. test_cleanup_delete_latest_modules — deleteLatest 模块组
|
||||
3. test_cleanup_appearance — cleanupResultFileJob
|
||||
4. test_cleanup_similar — cleanupResultFileJob
|
||||
5. test_cleanup_publish — cleanupResultFileJob
|
||||
6. test_cleanup_delete_brand — cleanupResultFileJob
|
||||
7. test_cleanup_collect_data_noop — 无清理
|
||||
8. test_cleanup_unknown_ignored — 未知模块不抛
|
||||
|
||||
## 任务 75:notifyRetryExhausted 改 handler.onFailure
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
|
||||
|
||||
notifyRetryExhausted(job,msg) 改 handler.onFailure;SHOP_DATA_CRAWL/SIMILAR_ASIN 有回调,其余 noop;回调幂等(失败重试安全)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_on_failure_shop_data_crawl — 回调
|
||||
2. test_on_failure_similar — 回调
|
||||
3. test_on_failure_others_noop — 其余无操作
|
||||
4. test_on_failure_unknown_ignored — 未知模块安全
|
||||
5. test_on_failure_idempotent — 重复调用安全
|
||||
6. test_on_failure_error_swallowed — 回调抛错不中断
|
||||
7. test_on_failure_args_passed — job+message 传递
|
||||
8. test_exhausted_finalize_flow — 重试耗尽全流程
|
||||
|
||||
## 任务 76:coze offload 判定改 handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
|
||||
|
||||
process() 中 APPEARANCE_PATENT/SIMILAR_ASIN 的 cozeTaskExecutor offload 判定改 handler.supportsAsyncOffload();offload 失败回退内联逻辑保持。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_offload_modules_detected — offload 模块识别
|
||||
2. test_offload_executes_on_coze_executor — 线程池执行
|
||||
3. test_offload_failure_fallback — 提交失败回退内联
|
||||
4. test_offload_other_modules_inline — 非 offload 内联
|
||||
5. test_offload_only_async_modules — 仅异步模块
|
||||
6. test_offload_no_duplicate_execution — 不回退重复执行
|
||||
7. test_offload_heartbeat_started — 心跳启动
|
||||
8. test_offload_integration — 全链路
|
||||
|
||||
## 任务 77:owner-scoped 判定改 handler
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:60-72 **预估**:8-15 分钟
|
||||
|
||||
isOwnerScopedJob 改 handler.isOwnerScoped();owner 解析(scopeKey :owner: 标记)保留公共逻辑;非本实例跳过逻辑保持。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_owner_scoped_modules — 4 个 owner 模块
|
||||
2. test_owner_scoped_other_owner_skip — 他实例跳过
|
||||
3. test_owner_scoped_self_process — 本实例处理
|
||||
4. test_owner_scope_parse — :owner: 解析
|
||||
5. test_owner_scope_blank — 空 scope 视为本实例
|
||||
6. test_owner_non_scoped_modules — 非 owner 模块不受影响
|
||||
7. test_owner_unknown_instance_id — 未配置实例
|
||||
8. test_owner_integration — 全链路
|
||||
|
||||
## 任务 78:模块映射快照测试
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:73 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
快照断言:13 个 moduleType → Handler 类 → 原 Service 方法一一对应;与 04 spec §3 映射表一致;新增模块类型未映射即失败。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_snapshot_all_13_mapped — 13 全映射
|
||||
2. test_snapshot_shop_match_delegate — 委托方法名快照
|
||||
3. test_snapshot_appearance_boolean — 返回类型快照
|
||||
4. test_snapshot_publish_owner — owner 标记快照
|
||||
5. test_snapshot_failure_callbacks — onFailure 回调快照
|
||||
6. test_snapshot_no_extra_modules — 无多余映射
|
||||
7. test_snapshot_mapping_frozen — JSON 快照文件比对
|
||||
8. test_snapshot_new_module_fails — 新 moduleType 快照失败
|
||||
|
||||
## 任务 79:行为等价对比测试
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:73-77 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
同一 Job 序列(成功/失败/重试耗尽/异步等待/owner 跳过)改造前后产生相同状态迁移与依赖调用;用 mock 记录调用序列对比。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_equiv_success_job — 成功序列一致
|
||||
2. test_equiv_failed_job — 失败序列一致
|
||||
3. test_equiv_retry_exhausted — 重试耗尽一致
|
||||
4. test_equiv_async_wait — 异步等待一致
|
||||
5. test_equiv_owner_skip — owner 跳过一致
|
||||
6. test_equiv_orphan_failure — 孤儿失败一致
|
||||
7. test_equiv_call_sequence — 依赖调用顺序一致
|
||||
8. test_equiv_state_transition — 状态迁移一致
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
对比测试:改造前录制调用序列(golden),改造后断言一致。
|
||||
|
||||
## 任务 80:孤儿失败路径不回归
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:73 **预估**:8-15 分钟
|
||||
|
||||
BusinessException 含 not found 文案 → markFailedPermanent;非孤儿失败 → markFailed + retry 判断;错误文案匹配清单(task not found/result record not found/任务不存在/记录不存在)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_orphan_task_not_found_en — 英文文案
|
||||
2. test_orphan_result_not_found_en
|
||||
3. test_orphan_cn_messages — 中文文案
|
||||
4. test_orphan_mark_permanent — markFailedPermanent
|
||||
5. test_non_orphan_mark_failed — 普通失败
|
||||
6. test_non_business_exception — 非业务异常
|
||||
7. test_retry_exhausted_after_orphan — 耗尽后终态
|
||||
8. test_orphan_no_requeue — 孤儿不重排
|
||||
|
||||
## 任务 81:卡死扫描/重试耗尽路径测试
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:73 **预估**:8-15 分钟
|
||||
|
||||
resetStuckRunningJobsDetailed:超时卡死 job 重置;耗尽 job 走 finalizeRetryExhausted;消息默认文案("文件生成任务运行超时")。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_stuck_reset — 超时重置
|
||||
2. test_stuck_exhausted_finalize — 耗尽 finalize
|
||||
3. test_stuck_default_message — 默认文案
|
||||
4. test_stuck_custom_message — 自定义文案
|
||||
5. test_stuck_heartbeat_timeout — 心跳超时边界
|
||||
6. test_stuck_scan_interval — 调度间隔配置
|
||||
7. test_stuck_no_reset_active — 活跃 job 不重置
|
||||
8. test_stuck_idempotent — 重复扫描安全
|
||||
|
||||
## 任务 82:特殊规则回归(WITHDRAW/coze defer)
|
||||
|
||||
**所属模块**:04 注册表 **依赖**:78-81 **预估**:8-15 分钟
|
||||
|
||||
WITHDRAW markSuccess 后 tryFinalizeTask;coze 模块 dispatch 返回 false → touchRunning(owner)或 deferRunning;状态与时机与原实现完全一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_withdraw_finalize_after_success — 成功后 finalize
|
||||
2. test_withdraw_no_finalize_failed — 失败不 finalize
|
||||
3. test_coze_false_owner_touch — owner 路径 touchRunning
|
||||
4. test_coze_false_defer — 非 owner deferRunning
|
||||
5. test_coze_false_no_mark_failed — 等待不标记失败
|
||||
6. test_coze_true_mark_success — 完成后 markSuccess
|
||||
7. test_withdraw_finalize_once — 只一次
|
||||
8. test_special_rules_integration — 全链路
|
||||
|
||||
### 收尾验证(本模块)
|
||||
`mvn test` 全量 + `mvn clean package -DskipTests` 通过;04 spec §4 兼容清单逐项核对。
|
||||
@@ -1,286 +0,0 @@
|
||||
# 05-plan — 巨型 Service 纯函数抽取
|
||||
|
||||
> 对应 `docs/specs/05-service-pure-function-extraction.md`。目标:SimilarAsinTaskService(7228 行)、AppearancePatentTaskService(3195)、ShopDataCrawlTaskService(3013)。
|
||||
> 纪律:只抽纯函数;门面签名不收缩;每模块独立提交;同一提交只做类拆分。
|
||||
|
||||
## 任务 83:SimilarAsinExcelParser 行解析器
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
新类 `modules/similarasin/service/support/SimilarAsinExcelParser`:POI 读 Excel 行 → 中间行对象(原始单元格值);输入 InputStream/文件 → 输出 List<中间行>;不改动现有解析语义(同一文件输出与现状逐字节一致)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_parse_normal_rows — 正常多行解析
|
||||
2. test_parse_single_row — 单行
|
||||
3. test_parse_columns_mapping — 列序映射
|
||||
4. test_parse_empty_sheet — 空表返回空
|
||||
5. test_parse_empty_rows_skipped — 空行跳过
|
||||
6. test_parse_null_input_throws — 空输入抛 IllegalArgumentException
|
||||
7. test_parse_unsupported_format — 非 Excel 文件抛对应异常
|
||||
8. test_parse_no_mutation — 输入流不被篡改(可重复读)
|
||||
|
||||
### TDD 流程
|
||||
1. 写测试(用夹具 xlsx 放 test resources)→ RED
|
||||
2. 实现解析器(从 Service 中搬移现有解析逻辑)→ GREEN
|
||||
3. `mvn test -Dtest=SimilarAsinExcelParserTest` 通过
|
||||
|
||||
## 任务 84:行解析边界测试
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:83 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
边界输入:超长字段(>32767)、畸形 ASIN(特殊字符)、BOM、混合编码、行数上限(>65535 xlsx)、数值/文本混合单元格。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_parse_long_field — 超长字段不截断/按现状
|
||||
2. test_parse_malformed_asin — 畸形 ASIN 原样透传
|
||||
3. test_parse_bom — BOM 头处理
|
||||
4. test_parse_mixed_encoding — 混合编码单元格
|
||||
5. test_parse_numeric_cell — 数值单元格转文本
|
||||
6. test_parse_date_cell — 日期单元格
|
||||
7. test_parse_formula_cell — 公式单元格取缓存值
|
||||
8. test_parse_large_sheet — 大表(5000 行)性能上界
|
||||
|
||||
## 任务 85:字段归一化器
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`SimilarAsinRowNormalizer`:trim/大小写/ASIN 格式统一(保留现状规则,不改变输出);纯函数无状态。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_trim_whitespace — 首尾空白
|
||||
2. test_lowercase_asin — 小写转大写
|
||||
3. test_mixed_case_asin — 混合大小写统一
|
||||
4. test_internal_whitespace_kept — 内部空格保留(现状)
|
||||
5. test_null_safe — null 安全
|
||||
6. test_empty_string — 空串
|
||||
7. test_special_chars_untouched — 特殊字符不动
|
||||
8. test_normalize_identity_after — 幂等(二次归一不变)
|
||||
|
||||
## 任务 86:分组转换器
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:83,85 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`SimilarAsinGroupingConverter`:归一化行 → 分组 → DTO(TaskItem/FileItem);分组规则与现状一致(同组/子行 2_2、2_3 处理);纯函数。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_group_normal — 正常分组
|
||||
2. test_group_sub_rows — 子行归组
|
||||
3. test_group_single_item — 单元素组
|
||||
4. test_group_empty_input — 空输入空输出
|
||||
5. test_group_dto_fields — DTO 字段映射
|
||||
6. test_group_dedup — 组内去重
|
||||
7. test_group_order — 分组顺序保持
|
||||
8. test_group_missing_key — 缺分组键兜底
|
||||
|
||||
## 任务 87:纯校验器
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:85 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`SimilarAsinRowValidator`:必填检查、ASIN 格式校验、重复检测;返回错误清单(不抛异常,由调用方决定);规则与现状一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_validate_required_present — 必填齐全通过
|
||||
2. test_validate_required_missing — 缺必填报错
|
||||
3. test_validate_asin_format — ASIN 格式
|
||||
4. test_validate_duplicates — 重复标记
|
||||
5. test_validate_blank_row — 空白行
|
||||
6. test_validate_no_error_happy — 无误通过
|
||||
7. test_validate_error_detail — 错误含行列信息
|
||||
8. test_validate_null_input — 空输入错误清单
|
||||
|
||||
## 任务 88:Sheet 构造器
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`SimilarAsinSheetBuilder`:结果 Workbook/Sheet 构造辅助(表头、列顺序、样式);输入数据 → 输出 workbook;不落库、无 IO 依赖。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_sheet_header_row — 表头正确
|
||||
2. test_sheet_column_order — 列顺序固定
|
||||
3. test_sheet_data_rows — 数据行写入
|
||||
4. test_sheet_empty_data — 空数据仍出表头
|
||||
5. test_sheet_style_applied — 样式应用
|
||||
6. test_sheet_zip_output — 可输出 xlsx 文件流
|
||||
7. test_sheet_large_rows — 大行数(5000)性能
|
||||
8. test_sheet_no_state_leak — 多次调用独立
|
||||
|
||||
## 任务 89:SimilarAsinService.parse 门面改委托
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:83-88 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
parse 方法内部改为:parser.parse → normalizer.normalize → validator → converter → 落库(落库逻辑保留原处);方法签名、参数、返回类型一字不变;删除搬走的代码。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_parse_signature_unchanged — 签名编译兼容
|
||||
2. test_parse_delegates_parser — 调用解析器
|
||||
3. test_parse_delegates_normalizer
|
||||
4. test_parse_delegates_validator
|
||||
5. test_parse_delegates_converter
|
||||
6. test_parse_persistence_kept — 落库逻辑仍在
|
||||
7. test_parse_result_same — 与改造前结果一致
|
||||
8. test_parse_exception_same — 异常行为一致
|
||||
|
||||
## 任务 90:抽取前后快照对比测试
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:89 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
夹具 Excel → 解析结果快照(golden 文件);抽取前后同一夹具输出完全一致;快照变更即失败(防止行为漂移)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_snapshot_parse_output — 解析输出快照一致
|
||||
2. test_snapshot_groups — 分组快照
|
||||
3. test_snapshot_dtos — DTO 快照
|
||||
4. test_snapshot_error_cases — 错误案例快照
|
||||
5. test_snapshot_reproducible — 可重复(跑两次一致)
|
||||
6. test_snapshot_golden_committed — golden 文件存在
|
||||
7. test_snapshot_diff_detected — 篡改 golden 即失败
|
||||
8. test_snapshot_regression_all_parse — 全 parse 路径回归
|
||||
|
||||
## 任务 91:SimilarAsin 历史查询组装抽取
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
历史列表 VO 拼装(history + toHistoryItem 辅助)抽到独立组件 `SimilarAsinHistoryAssembler`;只读不落库;输出与现状一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_assembler_history_items — 历史项组装
|
||||
2. test_assembler_no_result — 无结果空列表
|
||||
3. test_assembler_file_state — file 状态附带
|
||||
4. test_assembler_order — 排序保持
|
||||
5. test_assembler_null_task — 缺 task 兜底
|
||||
6. test_assembler_download_url — URL 构造
|
||||
7. test_assembler_immutable_input — 输入不被改
|
||||
8. test_assembler_consistency — 与现状输出一致
|
||||
|
||||
## 任务 92:SimilarAsin 全量回归
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:89-91 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
similarasin 模块相关测试全绿;`mvn test` 无回归;API 行为与改造前一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8. 回归清单:新组件测试全绿、既有 similarasin 测试全绿、controller 签名编译、DTO 字段快照、Python 回调相关测试、单测全量、package 通过、git diff 无越界
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
`mvn test` + `mvn clean package -DskipTests`。
|
||||
|
||||
## 任务 93:AppearancePatent 行解析/归一化抽取
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:83,85 **预估**:8-15 分钟
|
||||
|
||||
同 83/85 模式,针对 AppearancePatentTaskService 的解析与归一化逻辑(注意其 Excel 结构与 similarasin 不同)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:正常解析、单行、空表、空行、归一化规则、边界(超长/畸形)、输入安全、快照一致。
|
||||
|
||||
## 任务 94:AppearancePatent Sheet 构造抽取
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:88 **预估**:8-15 分钟
|
||||
|
||||
同 88 模式(列顺序以 appearancepatent 现状为准)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:表头、列序、数据行、空数据、样式、输出流、大行数、无状态泄漏。
|
||||
|
||||
## 任务 95:AppearancePatent 门面改委托
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:93,94 **预估**:8-15 分钟
|
||||
|
||||
同 89 模式;注意 appearancepatent 的 submitResult 双事务路径不动。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:签名不变、委托各组件、落库保留、结果一致、异常一致、双事务路径不变、owner 检查不变、全回归。
|
||||
|
||||
## 任务 96:AppearancePatent 快照对比测试
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:95 **预估**:8-15 分钟
|
||||
|
||||
同 90 模式(夹具为 appearancepatent 实际 Excel 结构)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 90。
|
||||
|
||||
## 任务 97:AppearancePatent 历史查询组装抽取
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
同 91 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 91。
|
||||
|
||||
## 任务 98:AppearancePatent 全量回归
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:95-97 **预估**:8-15 分钟
|
||||
|
||||
同 92 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 92(appearancepatent 相关)。
|
||||
|
||||
## 任务 99:ShopDataCrawl 行解析抽取
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:83,85 **预估**:8-15 分钟
|
||||
|
||||
同 93 模式(shopdatacrawl 结构)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 93。
|
||||
|
||||
## 任务 100:ShopDataCrawl Sheet 构造抽取
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:88 **预估**:8-15 分钟
|
||||
|
||||
同 94 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 94。
|
||||
|
||||
## 任务 101:ShopDataCrawl 门面改委托
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:99,100 **预估**:8-15 分钟
|
||||
|
||||
同 95 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 95。
|
||||
|
||||
## 任务 102:ShopDataCrawl 快照对比测试
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:101 **预估**:8-15 分钟
|
||||
|
||||
同 96 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 96。
|
||||
|
||||
## 任务 103:ShopDataCrawl 历史查询组装抽取
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
同 97 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 97。
|
||||
|
||||
## 任务 104:ShopDataCrawl 全量回归
|
||||
|
||||
**所属模块**:05 拆分 **依赖**:101-103 **预估**:8-15 分钟
|
||||
|
||||
同 98 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 98。
|
||||
|
||||
### 收尾验证(本模块)
|
||||
`mvn test` 全量 + `mvn clean package -DskipTests`;05 spec §4 不变要求逐项核对;三模块各一个独立提交。
|
||||
@@ -1,325 +0,0 @@
|
||||
# 06-plan — 只读查询与批量加载优化
|
||||
|
||||
> 对应 `docs/specs/06-read-query-batch-loading.md`。行为不变型优化 + 新增 progress/light 轻量接口。
|
||||
> 技术栈:Java 21 + MyBatis-Plus + Flyway。
|
||||
|
||||
## 任务 105:similarasin 历史列表 IN 查询批量加载
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
history 方法:任务+结果+Job 关联数据由逐条查询改为 IN 批量查询 + 按 ID Map 装配;分页结果、排序、过滤不变;输出与现状一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_history_batch_loads — 批量加载装配
|
||||
2. test_history_single_row — 单条
|
||||
3. test_history_multiple_tasks — 多任务
|
||||
4. test_history_no_jobs — 无 Job 兼容
|
||||
5. test_history_order_unchanged — 排序不变
|
||||
6. test_history_pagination — 分页不变
|
||||
7. test_history_missing_related — 关联缺失兜底
|
||||
8. test_history_sql_count — IN 查询次数(≤N,断言 mapper 调用次数)
|
||||
|
||||
### TDD 流程
|
||||
1. 写测试(mock mapper 断言查询次数与装配)→ RED
|
||||
2. 改造 history 实现 → GREEN
|
||||
3. `mvn test -Dtest=SimilarAsinTaskServiceTest` 通过
|
||||
|
||||
## 任务 106:appearancepatent 历史列表批量加载
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:105 **预估**:8-15 分钟
|
||||
|
||||
同 105 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 105(appearancepatent)。
|
||||
|
||||
## 任务 107:结果列表关联 Job 批量加载
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
结果列表/详情页关联 TaskFileJob 状态:findAssembleJobsByResultIds 覆盖审计;逐条查 result→job 的路径改 IN;输出不变。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_result_job_batch — 批量取 Job
|
||||
2. test_result_job_single — 单条
|
||||
3. test_result_job_empty — 空结果
|
||||
4. test_result_job_map_keyed — 按 resultId Map
|
||||
5. test_result_job_missing — 缺 Job 兜底
|
||||
6. test_result_job_query_count — 查询次数断言
|
||||
7. test_result_job_null_guard — null 安全
|
||||
8. test_result_job_consistency — 与现状一致
|
||||
|
||||
## 任务 108:dashboard 聚合查询
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
dashboard 统计改批量聚合(COUNT/GROUP BY 一次出);状态分类计数与逐条统计结果一致;输出结构不变。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_dashboard_counts — 各状态计数
|
||||
2. test_dashboard_empty — 空用户 0 计数
|
||||
3. test_dashboard_aggregate_sql — 聚合 SQL 调用
|
||||
4. test_dashboard_recent_tasks — 最近任务列表
|
||||
5. test_dashboard_consistency — 与逐条一致
|
||||
6. test_dashboard_mixed_status — 混合状态
|
||||
7. test_dashboard_user_filter — 用户过滤
|
||||
8. test_dashboard_big_data — 大数据量聚合
|
||||
|
||||
## 任务 109:progress/light 轻量接口(similarasin 首个)
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
新端点 `POST /api/similar-asin/tasks/progress/light`:body {taskIds};resp items[{taskId,status,statusCode?,fileStatus,fileReady,updatedAt}];旧 progress/batch 保留不动;走轻量查询(不查明细/result 行)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_light_returns_light_fields — 只返回轻量字段
|
||||
2. test_light_missing_task — missingTaskIds
|
||||
3. test_light_empty_ids — 空 ids 空结果
|
||||
4. test_light_dedup_ids — 去重
|
||||
5. test_light_old_endpoint_untouched — 旧端点仍工作
|
||||
6. test_light_status_mapping — 状态映射正确
|
||||
7. test_light_file_fields — file 字段附带
|
||||
8. test_light_unknown_id — 未知 id 缺失列表
|
||||
|
||||
### TDD 流程
|
||||
1. 测试(MockMvc 打新端点)→ RED(404)
|
||||
2. 实现 controller + service → GREEN
|
||||
3. `mvn test -Dtest=SimilarAsinControllerTest` 通过
|
||||
|
||||
## 任务 110:progress/light 字段白名单
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:109 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
响应仅含白名单字段(taskId/status/statusCode/fileStatus/fileReady/updatedAt);不含 items 明细/payload/result 内容;序列化断言。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_whitelist_no_items — 无明细数组
|
||||
2. test_whitelist_no_payload — 无 payload 字段
|
||||
3. test_whitelist_exact_keys — 键集合精确匹配
|
||||
4. test_whitelist_file_phase — file 字段在白名单
|
||||
5. test_whitelist_extra_rejected — 多余键测试失败
|
||||
6. test_whitelist_null_values_ok — null 值允许
|
||||
7. test_whitelist_response_size_small — 响应体小(<1KB)
|
||||
8. test_whitelist_documented — 白名单文档一致
|
||||
|
||||
## 任务 111:progress/light 空/超长 taskIds
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:109 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
空数组→空 items;null→空;>200 个截断或返回错误(定义行为);非正数过滤。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_light_empty_array — 空数组
|
||||
2. test_light_null_body — null body 处理
|
||||
3. test_light_negative_filter — 负数过滤
|
||||
4. test_light_zero_filter — 0 过滤
|
||||
5. test_light_over_200 — 超长截断/错误
|
||||
6. test_light_duplicates — 重复去重
|
||||
7. test_light_single — 单 id
|
||||
8. test_light_max_exact — 恰好上限
|
||||
|
||||
## 任务 112:progress/light 终态任务返回
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:109 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
SUCCESS/FAILED 任务在 light 接口返回终态状态 + file 阶段;前端可凭此停止轮询并展示。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_light_success_task — SUCCESS 返回
|
||||
2. test_light_failed_task — FAILED 返回
|
||||
3. test_light_pending — PENDING
|
||||
4. test_light_running — RUNNING
|
||||
5. test_light_success_file_status — 附带 fileStatus
|
||||
6. test_light_failed_file_error — 失败附带 fileError
|
||||
7. test_light_terminal_complete — 终态字段完整
|
||||
8. test_light_status_frozen — 状态值语义不变
|
||||
|
||||
## 任务 113:其余模块 progress/light 接入
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:109-112 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
同构端点接入:appearancepatent/publish/queryasin/shopdatacrawl/withdraw/patroldelete/shopmatch/productrisk/pricetrack/deletebrand/collectdata(11 个);路径模式统一;字段白名单一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_light_all_modules_exist — 12 个 light 端点存在
|
||||
2. test_light_common_shape — 响应结构一致
|
||||
3. test_light_module_specific_status — 各模块状态映射
|
||||
4. test_light_publish_files — publish 文件级字段
|
||||
5. test_light_old_endpoints_all_kept — 旧端点全保留
|
||||
6. test_light_whitelist_all — 白名单一致
|
||||
7. test_light_missing_all — 缺失任务处理
|
||||
8. test_light_contract_frozen — 契约快照
|
||||
|
||||
## 任务 114:批量加载等价快照测试
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:105-108 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
改造前后同数据:历史页、结果页、dashboard 输出字段完全一致(快照对比)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_history_snapshot_equiv — 历史快照一致
|
||||
2. test_dashboard_snapshot_equiv — dashboard 一致
|
||||
3. test_result_snapshot_equiv — 结果一致
|
||||
4. test_pagination_equiv — 分页一致
|
||||
5. test_snapshot_reproducible — 可重复
|
||||
6. test_snapshot_diff_fails — 篡改即失败
|
||||
7. test_snapshot_covers_all — 覆盖三页
|
||||
8. test_snapshot_regression_guard — 全量回归门禁
|
||||
|
||||
## 任务 115:高频查询 EXPLAIN 索引审计
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
对高频查询(history/progress/dashboard)逐条 EXPLAIN;产出索引迁移清单(表/列/类型/收益/风险);不做 DDL。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_explain_history_plan — history 执行计划记录
|
||||
2. test_explain_progress_plan — progress 计划
|
||||
3. test_explain_dashboard_plan — dashboard 计划
|
||||
4. test_full_scan_detected — 全表扫描标记
|
||||
5. test_index_candidates_listed — 候选索引清单
|
||||
6. test_plan_documented — 审计文档产出
|
||||
7. test_plan_repeatable — 可重复执行
|
||||
8. test_no_ddl_this_task — 本任务无 DDL
|
||||
|
||||
## 任务 116:索引迁移 V{N+1}
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:115 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
按审计清单追加 `db/V{N+1}__*.sql`(只追加不改历史);包含验证 SQL;标注锁表风险与窗口。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_migration_file_exists — 迁移文件存在
|
||||
2. test_migration_version_sequential — 版本号续接
|
||||
3. test_migration_validated — 验证 SQL 通过(副本库)
|
||||
4. test_migration_index_created — 索引生效
|
||||
5. test_explain_improved — 执行计划改善
|
||||
6. test_migration_no_alter_legacy — 不改历史迁移
|
||||
7. test_migration_rollback_doc — 回滚步骤记录
|
||||
8. test_migration_backward_safe — 旧数据兼容
|
||||
|
||||
## 任务 117:progress/light user_id 权限过滤
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:109 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
user_id 传入时仅返回该用户任务;未传时按 taskId 反查;越权任务进 missingTaskIds(不泄露)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_light_user_filter — 用户过滤
|
||||
2. test_light_no_user_reverse — 无 user 反查
|
||||
3. test_light_other_user_hidden — 他人任务隐藏
|
||||
4. test_light_missing_on_unauthorized — 越权进 missing
|
||||
5. test_light_user_null — 全空 userId
|
||||
6. test_light_admin_scope — 管理范围(按现状)
|
||||
7. test_light_user_consistent — 与旧端点一致
|
||||
8. test_light_no_leak — 响应不含他人数据
|
||||
|
||||
## 任务 118:前端 getModuleProgressLight 适配
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:109,44 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
java-modules.ts 新增 `getModuleProgressLight(module, taskIds)` 调 light 端点;返回结构归一为现有 progress 类型;页面可渐进切换。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_light_url_module — 模块路径正确
|
||||
2. test_light_payload — taskIds body
|
||||
3. test_light_response_shape — 归一结构
|
||||
4. test_light_fallback_flag — 可开关
|
||||
5. test_light_missing_ids — missingTaskIds 映射
|
||||
6. test_light_timeout — 10s 超时
|
||||
7. test_light_type_compat — 与旧类型兼容
|
||||
8. test_light_snapshot — 快照
|
||||
|
||||
## 任务 119:前端 dashboard/history/progress 分离调用测试
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
前端页面:dashboard 只调统计、history 只调摘要、progress 只调轻量;首次打开不加载全部明细;断言请求路径分离。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_page_dashboard_only_stats — 只调统计
|
||||
2. test_page_history_only_summary — 只调摘要
|
||||
3. test_page_progress_only_light — 只调进度
|
||||
4. test_page_no_full_detail_on_load — 首开不拉明细
|
||||
5. test_page_items_on_open — 打开明细才请求
|
||||
6. test_page_result_on_demand — 结果按需
|
||||
7. test_page_request_count_bounded — 请求数有界
|
||||
8. test_page_snapshot — 请求快照
|
||||
|
||||
## 任务 120:大页数据性能回归
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:105-108 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
500 任务级数据:history/dashboard/progress 响应时间上界(基准线);不劣于改造前。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_perf_history_500 — 历史耗时
|
||||
2. test_perf_dashboard_500 — dashboard 耗时
|
||||
3. test_perf_progress_200 — 200 任务进度
|
||||
4. test_perf_light_200 — light 更快
|
||||
5. test_perf_query_count — 查询次数上界
|
||||
6. test_perf_no_regression — 与基线对比
|
||||
7. test_perf_memory_bounded — 内存有界
|
||||
8. test_perf_report — 结果记录
|
||||
|
||||
## 任务 121:N+1 扫描审计
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
对 modules 下 Service 扫描逐条 selectById/selectOne 循环模式;产出 N+1 清单(位置/对象/影响);不做修改。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_scan_select_in_loop — 识别循环内单查
|
||||
2. test_scan_output_listed — 清单产出
|
||||
3. test_scan_priority — 按影响排序
|
||||
4. test_scan_module_coverage — 覆盖主要模块
|
||||
5. test_scan_false_positive_checked — 排除误报(已批量)
|
||||
6. test_scan_repeatable — 可重复
|
||||
7. test_scan_documented — 文档产出
|
||||
8. test_scan_no_edit — 本任务不改代码
|
||||
|
||||
## 任务 122:N+1 批量化修复
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:121 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
按清单修复高影响 N+1(IN 查询 + Map 装配);行为不变;快照对比验证。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_fix_in_query — 改 IN 查询
|
||||
2. test_fix_map_assembly — Map 装配
|
||||
3. test_fix_behavior_same — 行为一致
|
||||
4. test_fix_single_row — 单行兼容
|
||||
5. test_fix_empty — 空兼容
|
||||
6. test_fix_query_count_reduced — 查询次数下降
|
||||
7. test_fix_snapshot — 输出快照
|
||||
8. test_fix_no_side_effect — 无副作用
|
||||
|
||||
## 任务 123:06 全量回归
|
||||
|
||||
**所属模块**:06 批量加载 **依赖**:105-122 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
06 全部任务产出物 + 既有测试全绿;light 契约快照冻结;无行为回退。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:全部新测试绿、既有回归绿、light 契约快照、旧端点可用、索引迁移就绪、前端适配编译、性能基线、git diff 范围
|
||||
|
||||
### 验证方法
|
||||
`mvn test` 全量 + `cd frontend-vue && npm run build` + `npx vitest run`。
|
||||
@@ -1,250 +0,0 @@
|
||||
# 07-plan — 保守缩短事务边界
|
||||
|
||||
> 对应 `docs/specs/07-transaction-boundary.md`。硬约束:Python /result 成功确认时机、done=true 封口、状态成功时机、回滚语义全部不变。
|
||||
> 技术栈:Java 21 + Spring Transaction。
|
||||
|
||||
## 任务 124:@Transactional 方法审计清单
|
||||
|
||||
**所属模块**:07 事务 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
扫描 modules 下全部 @Transactional 方法,产出审计清单:方法/事务内代码段分类(必须事务内:落库/状态/锁;可移出:纯计算/DTO 组装/日志/清理);文档产出,不改代码。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_audit_covers_all_modules — 覆盖全部业务模块
|
||||
2. test_audit_classification — 分类完整(必须/可移出)
|
||||
3. test_audit_result_endpoints — /result 方法都在清单
|
||||
4. test_audit_python_facing — Python 回调相关标记
|
||||
5. test_audit_priority_order — 按收益排序
|
||||
6. test_audit_no_code_change — 本任务零代码变更
|
||||
7. test_audit_documented — 文档产出
|
||||
8. test_audit_repeatable — 可重复执行
|
||||
|
||||
### TDD 流程
|
||||
1. 写审计脚本/测试(断言清单文件存在且字段齐全)→ RED
|
||||
2. 产出清单 → GREEN
|
||||
3. 文档校验
|
||||
|
||||
## 任务 125:similarasin 纯计算移出事务
|
||||
|
||||
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
similarasin 的 /result 提交事务内纯计算段(分组/百分比/校验)抽为无事务方法,在写库前调用;输出与现状一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_pure_compute_outside_tx — 计算在事务外
|
||||
2. test_compute_result_same — 结果一致
|
||||
3. test_tx_persistence_kept — 落库仍在事务内
|
||||
4. test_failure_rollback — 落库失败回滚(计算无副作用)
|
||||
5. test_compute_idempotent — 计算幂等
|
||||
6. test_compute_repeat_safe — 重复调用安全
|
||||
7. test_no_tx_annotation_moved — 移动的方法无事务注解
|
||||
8. test_behavior_snapshot — 快照一致
|
||||
|
||||
### TDD 流程
|
||||
1. 测试断言事务边界(TransactionSynchronization 观察)→ RED
|
||||
2. 重构 → GREEN
|
||||
3. `mvn test -Dtest=SimilarAsinTaskServiceTest` 通过
|
||||
|
||||
## 任务 126:similarasin DTO 组装移出写事务
|
||||
|
||||
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
结果回传的 DTO/VO 组装移到事务提交后(afterCompletion 或事务外);不影响落库字段。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_dto_assembly_after_tx — 组装在事务后
|
||||
2. test_assembled_fields_same — 字段一致
|
||||
3. test_tx_commit_then_assembly — 先提交后组装
|
||||
4. test_rollback_no_assembly — 回滚不组装
|
||||
5. test_assembly_error_safe — 组装错误不影响事务
|
||||
6. test_response_built_ok — 响应正常构造
|
||||
7. test_assembly_no_db_read — 组装不读库
|
||||
8. test_snapshot_same — 快照一致
|
||||
|
||||
## 任务 127:similarasin 临时文件清理挂 afterCommit
|
||||
|
||||
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
事务完成后的临时文件清理改挂 TransactionSynchronization.afterCommit;回滚不清理(文件保留);清理异常不阻断。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_cleanup_after_commit — 提交后清理
|
||||
2. test_cleanup_no_rollback — 回滚不清理
|
||||
3. test_cleanup_error_swallowed — 异常吞掉
|
||||
4. test_cleanup_order — 在提交后
|
||||
5. test_cleanup_retryable — 失败可重试
|
||||
6. test_cleanup_tx_done — 事务状态已结束
|
||||
7. test_cleanup_idempotent — 幂等
|
||||
8. test_cleanup_integration — 全链路
|
||||
|
||||
## 任务 128:appearancepatent 事务收缩
|
||||
|
||||
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
|
||||
|
||||
同 125-127 模式(注意双事务路径:persistSubmittedChunk + completeSubmittedChunk 两段不变)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:计算移外、双事务路径不变、落库保留、回滚一致、清理时机、幂等、快照一致、集成。
|
||||
|
||||
## 任务 129:shopdatacrawl 事务收缩
|
||||
|
||||
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
|
||||
|
||||
同 125 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 125(shopdatacrawl 特有:items 分页写入路径)。
|
||||
|
||||
## 任务 130:publish 事务收缩
|
||||
|
||||
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
|
||||
|
||||
同 125 模式(publish 特有:RustFS 分片合并路径不动)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 125(publish:分片合并后落库仍在事务内)。
|
||||
|
||||
## 任务 131:collectdata 事务收缩
|
||||
|
||||
**所属模块**:07 事务 **依赖**:124 **预估**:8-15 分钟
|
||||
|
||||
同 125 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 125。
|
||||
|
||||
## 任务 132:/result 成功确认时机不变测试
|
||||
|
||||
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
/result 返回 HTTP 200 + success=true 在结果分片可靠落库**之后**;未落库前不返回成功;事务失败返回错误。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_result_200_after_persist — 落库后 200
|
||||
2. test_result_success_true — success=true
|
||||
3. test_result_persist_fail_no_200 — 落库失败不 200
|
||||
4. test_result_timing_order — 顺序断言
|
||||
5. test_result_retry_after_failure — 失败后重试
|
||||
6. test_result_chunk_then_ack — 分片先落库
|
||||
7. test_result_ack_then_response — 响应在 ACK 后
|
||||
8. test_result_contract_frozen — 契约快照
|
||||
|
||||
## 任务 133:回滚语义不变测试
|
||||
|
||||
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
落库异常 → 完整回滚(任务状态、结果、payload 不变);纯计算无副作用;重试安全。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_rollback_full — 完整回滚
|
||||
2. test_rollback_status_unchanged — 状态不变
|
||||
3. test_rollback_payload — payload 不变
|
||||
4. test_rollback_retry — 重试安全
|
||||
5. test_rollback_compute_noop — 计算无副作用
|
||||
6. test_rollback_error_raised — 异常抛出
|
||||
7. test_rollback_partial_write — 部分写入也回滚
|
||||
8. test_rollback_consistency — 与改造前一致
|
||||
|
||||
## 任务 134:done=true 封口时机不变测试
|
||||
|
||||
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
done=true 最后一批:强制处理未满批数据、生成结果文件的时机不变;封口语义不变。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_done_finalizes — 封口触发
|
||||
2. test_done_after_last_chunk — 最后一批后
|
||||
3. test_done_processes_remainder — 处理剩余
|
||||
4. test_done_generates_file — 生成结果
|
||||
5. test_done_idempotent — 重复 done 安全
|
||||
6. test_done_timing — 时机断言
|
||||
7. test_done_no_double — 不重复生成
|
||||
8. test_done_contract — 契约快照
|
||||
|
||||
## 任务 135:任务状态成功时机不变测试
|
||||
|
||||
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
任务状态变 SUCCESS 的时机(结果文件生成完成判断)不变;fileReady/downloadUrl 含义不变。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_success_timing — 成功时机
|
||||
2. test_success_after_file — 文件生成后
|
||||
3. test_file_ready_semantics — fileReady 语义
|
||||
4. test_download_url_semantics — downloadUrl 语义
|
||||
5. test_success_no_file — 无文件不成功
|
||||
6. test_success_state_transition — 状态迁移
|
||||
7. test_success_observable — 前端可观测
|
||||
8. test_success_contract — 契约快照
|
||||
|
||||
## 任务 136:事务外清理异常不阻断
|
||||
|
||||
**所属模块**:07 事务 **依赖**:127 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
afterCommit 清理抛异常:记录日志+指标,不影响响应;不重试成循环。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_cleanup_error_logged — 日志记录
|
||||
2. test_cleanup_error_response_ok — 响应不受影响
|
||||
3. test_cleanup_error_no_retry_loop — 不循环
|
||||
4. test_cleanup_error_tx_committed — 事务已提交
|
||||
5. test_cleanup_error_metric — 指标记录
|
||||
6. test_cleanup_error_next_time — 下次仍可清理
|
||||
7. test_cleanup_error_partial — 部分清理成功
|
||||
8. test_cleanup_error_integration — 集成
|
||||
|
||||
## 任务 137:重复提交幂等测试
|
||||
|
||||
**所属模块**:07 事务 **依赖**:132-135 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
同 submissionId 重复提交 /result:幂等接受(成功返回,不重复落库);不同内容冲突拒绝。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_duplicate_same_id_ok — 同 id 幂等
|
||||
2. test_duplicate_no_double_persist — 不重复落库
|
||||
3. test_duplicate_success_true — 返回成功
|
||||
4. test_duplicate_diff_content_reject — 内容不同拒绝
|
||||
5. test_duplicate_chunk_conflict — chunk 冲突
|
||||
6. test_duplicate_after_done — 封口后重复
|
||||
7. test_duplicate_many — 多次重复
|
||||
8. test_duplicate_contract — 契约快照
|
||||
|
||||
## 任务 138:事务时长性能对比基准
|
||||
|
||||
**所属模块**:07 事务 **依赖**:125-131 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
改造前后 /result 事务耗时基准对比(纯计算移出后的时间下降);记录基准数据。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_tx_duration_recorded — 耗时记录
|
||||
2. test_tx_duration_before_after — 前后对比
|
||||
3. test_tx_improved_or_equal — 不劣化
|
||||
4. test_tx_measure_repeatable — 可重复
|
||||
5. test_tx_load_200_chunks — 200 分片负载
|
||||
6. test_tx_no_regression — 无回退
|
||||
7. test_tx_benchmark_documented — 基准文档
|
||||
8. test_tx_bound_reasonable — 上界合理
|
||||
|
||||
## 任务 139:07 全量回归
|
||||
|
||||
**所属模块**:07 事务 **依赖**:132-138 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
07 全部契约测试(132-135)+ 各模块事务重构测试全绿;`mvn test` 无回归。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:契约 4 项全绿、幂等全绿、回滚全绿、各模块重构测试、全量单测、package、契约快照、git diff 范围
|
||||
|
||||
### 验证方法
|
||||
`mvn test` + `mvn clean package -DskipTests`。
|
||||
@@ -1,158 +0,0 @@
|
||||
# 08-plan — 结果文件阶段字段契约固化
|
||||
|
||||
> 对应 `docs/specs/08-result-file-phase-and-download.md`。**审计结论:Java 13 模块字段已实现、前端已消费,无代码改动需求。**
|
||||
> 本 plan 将现状固化为契约测试,防止未来回归;不新增业务字段。
|
||||
> 技术栈:Java 21 + JUnit5 + Vitest(前端)。
|
||||
|
||||
## 任务 140:13 模块 file 字段契约快照测试
|
||||
|
||||
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
对 13 个业务模块(similarasin/appearancepatent/shopdatacrawl/queryasin/withdraw/patroldelete/shopmatch/productrisk/pricetrack/deletebrand/publish/collectdata/brand)的响应 VO 断言 file 阶段字段存在且类型正确(collectdata 除外:断言其自洽语义);旧字段(taskId/resultId/downloadUrl/status)仍在。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_similar_has_file_fields — similarasin 字段齐全
|
||||
2. test_appearance_has_file_fields
|
||||
3. test_shopdatacrawl_has_file_fields
|
||||
4. test_publish_has_file_fields — publish 文件级
|
||||
5. test_collectdata_self_consistent — collectdata 无 file 字段(现状)
|
||||
6. test_old_fields_present — 旧字段全在
|
||||
7. test_file_field_types — 类型正确(boolean/string/integer)
|
||||
8. test_contract_frozen_snapshot — JSON 快照冻结
|
||||
|
||||
### TDD 流程
|
||||
1. 测试断言 VO 字段(反射/样例对象)→ 对现状应 GREEN(基线固化)
|
||||
2. 若未来删除字段即 RED(回归保护)
|
||||
3. `mvn test -Dtest=ResultFilePhaseContractTest` 通过
|
||||
|
||||
## 任务 141:similarasin file 进度合成逻辑单测
|
||||
|
||||
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
attachFileProgress 三路径:Coze 阶段(cozeCompleted/pending>0)、Python 上传阶段(未完成)、snapshot 百分比(上传完成无 coze);fileReady=true 时 100%。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_coze_progress_path — Coze 路径
|
||||
2. test_python_upload_path — Python 上传路径
|
||||
3. test_snapshot_percent_path — snapshot 路径
|
||||
4. test_file_ready_100 — ready=100%
|
||||
5. test_upload_not_complete_no_snapshot — 未完成且无快照
|
||||
6. test_can_treat_completed — 可视为完成
|
||||
7. test_task_not_running_skip — 非运行中跳过
|
||||
8. test_percent_cap_99 — 未 ready 时 ≤99
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
构造 FileResultEntity/TaskFileJobEntity/TaskProgressSnapshotEntity 组合断言输出(调用包可见/测试可见的 attachFileProgress 或经 toHistoryItem)。
|
||||
|
||||
## 任务 142:fileReady/fileStatus 语义测试
|
||||
|
||||
**所属模块**:08 结果阶段 **依赖**:140 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
fileReady = resultFileUrl 非空;无 job 时 fileStatus = ready?SUCCESS:null;有 job 时 fileStatus = job.status;fileError = job.errorMessage。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_ready_url_present — 有 URL ready=true
|
||||
2. test_ready_url_blank — 空 URL ready=false
|
||||
3. test_no_job_success_status — 无 job ready 时 SUCCESS
|
||||
4. test_no_job_null_status — 无 job 未 ready null
|
||||
5. test_job_status_mapped — job 状态映射
|
||||
6. test_job_error_mapped — job 错误映射
|
||||
7. test_ready_blank_whitespace — 空白字符串
|
||||
8. test_semantics_frozen — 语义快照
|
||||
|
||||
## 任务 143:publish 文件级 file 状态测试
|
||||
|
||||
**所属模块**:08 结果阶段 **依赖**:140 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
publish 的 file 状态是文件级(PublishResultVo.setFileReady(ready)/setFileStatus(file.status)),与其余模块 job 级不同;语义固化。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_publish_file_ready — ready 设置
|
||||
2. test_publish_file_status — 文件状态
|
||||
3. test_publish_per_file — 按文件独立
|
||||
4. test_publish_mixed_files — 多文件混合状态
|
||||
5. test_publish_ready_all — 全 ready
|
||||
6. test_publish_no_files — 无文件
|
||||
7. test_publish_failed_file — 失败文件
|
||||
8. test_publish_semantics_frozen — 语义快照
|
||||
|
||||
## 任务 144:前端 live progress 合并测试补强
|
||||
|
||||
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
mergeHistoryItemPreservingLiveProgress:history 缺失 file 进度时保留 live progress;incoming 有进度时用 incoming;可下载时不保留。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_merge_keeps_live_when_history_missing — 保留 live
|
||||
2. test_merge_incoming_wins — incoming 优先
|
||||
3. test_merge_no_keep_when_downloadable — 可下载不保留
|
||||
4. test_merge_no_previous — 无 previous 返回 incoming
|
||||
5. test_merge_partial_fields — 部分字段保留
|
||||
6. test_merge_meaningful_progress — 有效进度值判断
|
||||
7. test_merge_file_ready_flag — ready 标志保留
|
||||
8. test_merge_idempotent — 幂等
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
`npx vitest run`(扩展既有测试文件或新增)。
|
||||
|
||||
## 任务 145:前端可下载判定测试
|
||||
|
||||
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
canDownload/fileReady/fileStatus 终态判定:fileReady=true 可下载;fileStatus=SUCCESS/FAILED 可下载(FAILED 可下载错误文件或展示错误);其余不可下载。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_can_download_ready — ready 可下载
|
||||
2. test_can_download_status_success — SUCCESS 可下载
|
||||
3. test_can_download_status_failed — FAILED 展示错误
|
||||
4. test_can_not_download_pending — PENDING 不可
|
||||
5. test_can_not_download_null — null 不可
|
||||
6. test_file_status_lowercase — 小写归一
|
||||
7. test_ready_false_status_success — 组合判断
|
||||
8. test_download_flow_no_result_resubmit — 下载失败不重提交
|
||||
|
||||
## 任务 146:collectdata 自洽行为测试
|
||||
|
||||
**所属模块**:08 结果阶段 **依赖**:140 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
collectdata 前端用 success + downloadUrl 判定下载;后端不返回 file 字段;行为自洽(任务 SUCCESS 且有 URL 才可下载)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_collect_success_downloadable — SUCCESS+URL 可下载
|
||||
2. test_collect_success_no_url — 无 URL 不可
|
||||
3. test_collect_failed_no_download — 失败不可
|
||||
4. test_collect_ready_download_url — URL 有效
|
||||
5. test_collect_progress_display — 进度显示
|
||||
6. test_collect_self_consistent_backend — 后端无 file 字段
|
||||
7. test_collect_status_flow — 状态流
|
||||
8. test_collect_contract_frozen — 快照
|
||||
|
||||
## 任务 147:downloadUrl 永不过期验证
|
||||
|
||||
**所属模块**:08 结果阶段 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
generateFreshDownloadUrl 行为:result/ 前缀走 download-endpoint;非 result/ 走公开端点;无签名(URL 无过期参数);bucket 前缀正确。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_result_prefix_download_endpoint — result/ 走下载域名
|
||||
2. test_other_prefix_public — 其他走公开
|
||||
3. test_no_signed_params — 无签名参数
|
||||
4. test_bucket_in_url — bucket 包含
|
||||
5. test_blank_input_fallback — 空值回退
|
||||
6. test_uri_encoding — 路径编码
|
||||
7. test_scheme_https — https
|
||||
8. test_url_stable_over_time — 时间无关(无过期)
|
||||
|
||||
### TDD 流程 / 验证方法
|
||||
OssStorageService 单测(配置注入 mock endpoint)。
|
||||
|
||||
### 收尾验证(本模块)
|
||||
`mvn test` 相关类 + `cd frontend-vue && npx vitest run` 全绿;08 spec §2/§3 清单与实际一致。
|
||||
@@ -1,322 +0,0 @@
|
||||
# 09-plan — 临时文件生命周期治理
|
||||
|
||||
> 对应 `docs/specs/09-temp-file-lifecycle.md`。第一阶段只巡检不自动删;路径安全是硬门槛。
|
||||
> 技术栈:Java 21 + Spring Scheduling + JUnit5。
|
||||
|
||||
## 任务 148:临时目录配置盘点
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
盘点 TransientStorageProperties/StorageProperties/TransientPayloadStorageService 的临时目录配置(路径、前缀、保留期、现有清理逻辑);产出配置清单文档;不改代码。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_config_listed — 配置项清单齐全
|
||||
2. test_temp_root_defined — 临时根目录定义
|
||||
3. test_retention_period — 保留期定义
|
||||
4. test_payload_prefixes — payload 前缀
|
||||
5. test_upload_dir — 上传目录
|
||||
6. test_existing_cleanup_noted — 现有清理逻辑记录
|
||||
7. test_doc_committed — 文档存在
|
||||
8. test_no_code_change — 零代码变更
|
||||
|
||||
### TDD 流程
|
||||
1. 断言清单文档存在且字段齐全 → RED
|
||||
2. 产出文档 → GREEN
|
||||
|
||||
## 任务 149:创建/访问时间记录审计与补缺
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:148 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
临时文件创建时间/大小/最后访问时间记录:现有实现缺最后访问时间则补(文件 mtime 或记录表);不改变文件语义。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_creation_time_recorded — 创建时间
|
||||
2. test_size_recorded — 大小
|
||||
3. test_access_time_readable — 访问时间可读
|
||||
4. test_access_time_fallback — mtime 回退
|
||||
5. test_record_update — 访问更新
|
||||
6. test_record_missing_grace — 缺记录容忍
|
||||
7. test_record_no_io_error — IO 错误不阻断
|
||||
8. test_record_consistency — 一致
|
||||
|
||||
## 任务 150:引用检查(清理前)
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:148 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
清理前确认无任务引用:fileKey 被 task_file_job/file_result 引用则不清理;引用判定逻辑可测试。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_referenced_kept — 被引用不清理
|
||||
2. test_unreferenced_candidate — 无引用可清理
|
||||
3. test_reference_by_job — job 引用
|
||||
4. test_reference_by_result — result 引用
|
||||
5. test_reference_unknown — 未知引用安全
|
||||
6. test_check_no_side_effect — 检查无副作用
|
||||
7. test_check_failure_keeps — 检查失败保守保留
|
||||
8. test_check_batch — 批量检查
|
||||
|
||||
## 任务 151:路径安全校验
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:148 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
删除前校验:路径规范化后 startsWith(临时根目录);穿越(../、绝对路径逃逸、符号链接)拒绝;非法路径不删除并记录。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_inside_root_ok — 根内允许
|
||||
2. test_traversal_rejected — ../ 拒绝
|
||||
3. test_absolute_escape — 绝对路径逃逸拒绝
|
||||
4. test_symlink_escape — 符号链接逃逸拒绝
|
||||
5. test_normalize_before_check — 规范化后校验
|
||||
6. test_relative_subdir — 子目录允许
|
||||
7. test_sibling_rejected — 兄弟目录拒绝
|
||||
8. test_illegal_logged — 非法路径记录
|
||||
|
||||
### TDD 流程
|
||||
1. 测试(构造各种路径)→ RED
|
||||
2. 实现校验 → GREEN
|
||||
3. `mvn test -Dtest=TransientPathGuardTest` 通过
|
||||
|
||||
## 任务 152:清理失败吞异常记指标
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:150,151 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
清理失败:记录日志+指标(清理失败计数),不抛异常、不阻断主流程;不自动重试成循环。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_failure_logged — 日志
|
||||
2. test_failure_metric — 指标
|
||||
3. test_failure_no_throw — 不抛出
|
||||
4. test_failure_flow_continues — 主流程继续
|
||||
5. test_failure_no_retry_loop — 不循环
|
||||
6. test_failure_next_round — 下轮可再试
|
||||
7. test_failure_partial — 部分失败处理
|
||||
8. test_failure_isolation — 隔离其他文件
|
||||
|
||||
## 任务 153:fileKey 兜底查找
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:148 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
进程重启后 fileKey 兜底:上传记录持久化或重启后按 fileKey 重建索引;找不到时明确失败而非静默。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_file_key_found — 找到
|
||||
2. test_file_key_after_restart — 重启后找到
|
||||
3. test_file_key_missing — 缺失明确失败
|
||||
4. test_file_key_null — null 安全
|
||||
5. test_file_key_cleanup — 清理后不可找
|
||||
6. test_file_key_record_persist — 记录持久化
|
||||
7. test_file_key_rebuild — 索引重建
|
||||
8. test_file_key_semantics_frozen — 语义不变
|
||||
|
||||
## 任务 154:磁盘容量告警
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:152 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
临时目录容量超阈值:记录告警日志(当前容量/阈值);无监控栈时仅日志输出;不阻塞业务。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_warning_threshold — 阈值判断
|
||||
2. test_warning_logged — 告警日志
|
||||
3. test_under_threshold_silent — 未超不告警
|
||||
4. test_warning_repeat_limited — 告警频率限制
|
||||
5. test_usage_measured — 容量测量
|
||||
6. test_usage_zero — 空目录
|
||||
7. test_measure_error_grace — 测量失败容忍
|
||||
8. test_warning_no_block — 不阻塞
|
||||
|
||||
## 任务 155:孤立文件巡检报表
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:150 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
只读巡检:临时目录中无任何引用/超过保留期的文件清单输出到报表(日志或报表文件);不删除。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_orphan_detected — 孤立文件检出
|
||||
2. test_referenced_not_reported — 被引用不报
|
||||
3. test_report_output — 报表输出
|
||||
4. test_read_only_no_delete — 只读不删
|
||||
5. test_report_batch — 批量
|
||||
6. test_report_empty — 无孤立空报表
|
||||
7. test_report_rerun_safe — 可重复
|
||||
8. test_report_details — 详情(路径/大小/时间)
|
||||
|
||||
## 任务 156:孤立 Job 巡检报表
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
只读巡检:task_file_job 无对应 task/result 的孤儿 Job 清单;输出报表;不修改状态。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_orphan_job_detected — 检出
|
||||
2. test_valid_job_not_reported — 正常不报
|
||||
3. test_report_output — 输出
|
||||
4. test_read_only — 不修改
|
||||
5. test_job_retry_orphan — 重试耗尽孤儿
|
||||
6. test_report_empty — 空
|
||||
7. test_report_details — 详情
|
||||
8. test_rerun_safe — 可重复
|
||||
|
||||
## 任务 157:任务存在结果缺失巡检
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
只读巡检:任务存在但结果缺失(SUCCESS 任务无 file_result)清单。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_missing_result_detected — 检出
|
||||
2. test_with_result_not_reported — 有结果不报
|
||||
3. test_success_no_result — SUCCESS 无结果
|
||||
4. test_running_ignored — 运行中忽略
|
||||
5. test_report_empty
|
||||
6. test_read_only
|
||||
7. test_details
|
||||
8. test_rerun_safe
|
||||
|
||||
## 任务 158:结果存在文件缺失巡检
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
只读巡检:file_result 的 resultFileUrl 对应文件在 OSS/本地不存在清单。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_file_missing_detected
|
||||
2. test_file_exists_ok
|
||||
3. test_blank_url_handled — 空 URL
|
||||
4. test_oss_check — OSS 校验(mock)
|
||||
5. test_report_empty
|
||||
6. test_read_only
|
||||
7. test_details
|
||||
8. test_rerun_safe
|
||||
|
||||
## 任务 159:已完成任务活跃 Job 巡检
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
只读巡检:任务已终态(SUCCESS/FAILED)但仍有活跃(RUNNING/PENDING)Job 清单。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_active_job_after_terminal — 检出
|
||||
2. test_terminal_no_job_ok
|
||||
3. test_job_active_task_running_ok — 运行中任务正常
|
||||
4. test_stuck_job_reported — 卡死 Job
|
||||
5. test_report_empty
|
||||
6. test_read_only
|
||||
7. test_details
|
||||
8. test_rerun_safe
|
||||
|
||||
## 任务 160:超保留期仍被引用巡检
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:150 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
只读巡检:临时文件超保留期但仍有引用清单(供人工处理)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_over_retention_referenced — 检出
|
||||
2. test_in_retention_ok
|
||||
3. test_over_retention_unreferenced — 无引用(另表)
|
||||
4. test_boundary_retention — 边界时间
|
||||
5. test_report_empty
|
||||
6. test_read_only
|
||||
7. test_details
|
||||
8. test_rerun_safe
|
||||
|
||||
## 任务 161:巡检任务开关(默认 disabled)
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:155-160 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
全部巡检任务由配置开关控制(默认 disabled);启用后按调度间隔执行;双实例不重复输出(owner 或随机)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_disabled_by_default — 默认关
|
||||
2. test_enabled_runs — 启用执行
|
||||
3. test_schedule_interval — 间隔配置
|
||||
4. test_dual_instance_no_dup — 双实例不重复
|
||||
5. test_run_error_grace — 异常不阻断
|
||||
6. test_each_report_independent — 各报表独立
|
||||
7. test_config_override — 覆盖生效
|
||||
8. test_enabled_no_crash — 启用稳定
|
||||
|
||||
## 任务 162:路径穿越测试
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:151 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
穿越输入矩阵:`../`、`..\\`、绝对路径、URL 编码 `%2e%2e`、Unicode 全角点、混合分隔符——全部拒绝。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_dotdot_slash — ../
|
||||
2. test_dotdot_backslash — ..\
|
||||
3. test_encoded_dotdot — %2e%2e
|
||||
4. test_fullwidth_dot — 全角点
|
||||
5. test_abs_win_path — C:\ 形式
|
||||
6. test_abs_unix_path — /etc 形式
|
||||
7. test_mixed_separator — 混合分隔符
|
||||
8. test_null_byte — 空字节
|
||||
|
||||
## 任务 163:引用中文件不清测试
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:150 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
被 job/result 引用的文件:清理流程跳过;仅未引用文件被清理(清理流程本身在后续批次实现时,本任务先固化引用检查)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_job_referenced_skip — job 引用跳过
|
||||
2. test_result_referenced_skip — result 引用跳过
|
||||
3. test_unreferenced_passes — 未引用通过
|
||||
4. test_multi_reference — 多引用
|
||||
5. test_check_after_delete_history — 删历史后解除引用
|
||||
6. test_check_batch_mixed — 混合批次
|
||||
7. test_check_null_safe
|
||||
8. test_check_idempotent
|
||||
|
||||
## 任务 164:清理失败不阻断测试
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:152 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
清理一个文件失败不影响其他文件清理;主业务不受影响;错误可见(日志/指标)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_one_fail_others_succeed — 单失败其余成功
|
||||
2. test_failure_visible — 错误可见
|
||||
3. test_no_throw_up — 不上抛
|
||||
4. test_retry_next_round — 下轮重试
|
||||
5. test_partial_result_reported — 部分结果报告
|
||||
6. test_metric_recorded — 指标
|
||||
7. test_flow_continues — 流程继续
|
||||
8. test_no_cascading — 无级联
|
||||
|
||||
## 任务 165:巡检只读测试
|
||||
|
||||
**所属模块**:09 临时文件 **依赖**:155-161 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
全部巡检运行后:零删除、零状态修改、零写库(只读);可重复执行。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_no_delete — 零删除
|
||||
2. test_no_state_change — 状态不变
|
||||
3. test_no_db_write — 无写库
|
||||
4. test_read_repeatable — 重复一致
|
||||
5. test_isolated_reports — 报表隔离
|
||||
6. test_read_only_assert — 只读断言
|
||||
7. test_no_side_effects — 无副作用
|
||||
8. test_full_suite_run — 全巡检套件
|
||||
|
||||
### 收尾验证(本模块)
|
||||
`mvn test` 相关类全绿;09 spec §4 不变要求逐项核对(fileKey 语义、上传协议不变)。
|
||||
@@ -1,184 +0,0 @@
|
||||
# 10-plan — 外部 HTTP 客户端配置治理
|
||||
|
||||
> 对应 `docs/specs/10-http-client-governance.md`。现状:HttpClientPool 已统一(Coze/品牌/紫鸟共用连接池)。
|
||||
> 技术栈:Java 21 + JDK HttpClient + RestClient。
|
||||
|
||||
## 任务 166:各客户端契约表盘点
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
盘点 Coze/OSS/RustFS/图片下载/紫鸟各客户端现状:connect/read/write/call timeout、重试、幂等性;产出契约表文档;标注 JDK HttpClient 平台限制(无独立 write timeout、连接池上限不可配置);不改代码。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_contract_table_all_clients — 全客户端
|
||||
2. test_timeouts_listed — 超时现状
|
||||
3. test_retry_listed — 重试现状
|
||||
4. test_idempotency_listed — 幂等性
|
||||
5. test_jdk_limits_noted — 平台限制
|
||||
6. test_doc_committed — 文档存在
|
||||
7. test_no_code_change — 零代码
|
||||
8. test_repeatable — 可复查
|
||||
|
||||
### TDD 流程
|
||||
1. 断言文档存在 → RED
|
||||
2. 产出契约表 → GREEN
|
||||
|
||||
## 任务 167:aiimage.http-client.* 配置命名空间
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:166 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
application.yml 新增 `aiimage.http-client.*` 命名空间(connect-timeout/read-timeout/call-timeout/retry 默认值);默认值与现状一致;配置类绑定校验。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_config_namespace_exists — 命名空间
|
||||
2. test_defaults_match_current — 默认一致
|
||||
3. test_connect_timeout_bound — 合法值
|
||||
4. test_read_timeout_bound
|
||||
5. test_retry_count_bound
|
||||
6. test_invalid_values_clamped — 非法钳制
|
||||
7. test_config_class_binding — 绑定类
|
||||
8. test_env_override — env 覆盖
|
||||
|
||||
## 任务 168:Coze 客户端配置接入
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
Coze 客户端从配置读取超时/重试(现为硬编码或独立配置);行为不变(默认值等同现状)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_coze_timeout_from_config — 配置生效
|
||||
2. test_coze_default_kept — 默认不变
|
||||
3. test_coze_override — 覆盖
|
||||
4. test_coze_call_timeout — 总时长
|
||||
5. test_coze_retry_config — 重试配置
|
||||
6. test_coze_pool_shared — 共用连接池
|
||||
7. test_coze_idempotent_post — 幂等标注
|
||||
8. test_coze_behavior_same — 行为一致
|
||||
|
||||
## 任务 169:品牌检查客户端配置接入
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
|
||||
|
||||
同 168 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 168(品牌检查)。
|
||||
|
||||
## 任务 170:紫鸟客户端配置接入
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
|
||||
|
||||
同 168 模式。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 168(紫鸟)。
|
||||
|
||||
## 任务 171:图片下载客户端配置接入
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
|
||||
|
||||
同 168 模式(图片下载特有:大响应流式读取)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:配置生效、默认、覆盖、call timeout、重试、池共享、幂等、流式读取。
|
||||
|
||||
## 任务 172:幂等重试守卫
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:167 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
统一重试守卫:仅幂等请求(GET/HEAD)自动重试;非幂等(POST/PUT)不自动重试;重试次数与退避从配置;防重试风暴。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_get_retried — GET 重试
|
||||
2. test_post_not_retried — POST 不重试
|
||||
3. test_retry_count_limited — 次数限制
|
||||
4. test_retry_backoff — 退避
|
||||
5. test_idempotent_header_override — 显式幂等标记
|
||||
6. test_retry_success_after_fail — 重试成功
|
||||
7. test_retry_exhausted_fail — 耗尽失败
|
||||
8. test_no_retry_storm — 不风暴
|
||||
|
||||
## 任务 173:超时生效测试
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:168-171 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
mock 慢端点(>read timeout):请求在超时内失败;connect timeout 生效;call timeout 生效(RestClient 层)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_read_timeout_fires — 读超时
|
||||
2. test_read_timeout_duration — 时长断言
|
||||
3. test_connect_timeout_fires — 连接超时
|
||||
4. test_connect_timeout_duration
|
||||
5. test_call_timeout_fires — 总时长
|
||||
6. test_fast_response_ok — 快响应正常
|
||||
7. test_timeout_error_type — 错误类型
|
||||
8. test_timeout_after_config — 配置生效
|
||||
|
||||
## 任务 174:连接复用测试
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:168-171 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
连续 N 请求复用底层连接(共享 HttpClient);不同客户端共用连接池;连接不复用时暴露。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_connection_reused — 复用
|
||||
2. test_shared_across_clients — 跨客户端共用
|
||||
3. test_sequential_requests — 顺序复用
|
||||
4. test_keep_alive_header — keep-alive
|
||||
5. test_no_new_connection_burst — 突发不建新连
|
||||
6. test_pool_singleton — 单例
|
||||
7. test_concurrent_reuse — 并发复用
|
||||
8. test_connection_stats — 连接统计
|
||||
|
||||
## 任务 175:Python 回调超时不变确认
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
只读确认:Java 侧外部客户端改动不影响 Python 回调请求的超时与重试约定(Python 侧 requests 调用不动);写断言测试固化 Python 回调契约不受 Java 配置影响。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_python_callback_contract — 回调契约
|
||||
2. test_no_java_config_affects_python — 不受影响
|
||||
3. test_python_timeout_doc — 文档一致
|
||||
4. test_python_retry_doc
|
||||
5. test_python_headers — 头一致
|
||||
6. test_python_success_detection — 成功判定
|
||||
7. test_python_contract_frozen — 快照
|
||||
8. test_no_code_change_python — Python 零改动
|
||||
|
||||
## 任务 176:重试计数与日志字段
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:172 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
重试时记录日志(客户端/URL/尝试次数/耗时);重试计数指标;不记录敏感信息。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_retry_logged — 日志
|
||||
2. test_retry_attempt_field — 尝试次数
|
||||
3. test_retry_duration — 耗时
|
||||
4. test_retry_metric — 指标
|
||||
5. test_no_token_in_log — 无敏感信息
|
||||
6. test_success_no_retry_log — 成功不记
|
||||
7. test_log_level — 日志级别
|
||||
8. test_final_failure_logged — 最终失败
|
||||
|
||||
## 任务 177:10 全量回归
|
||||
|
||||
**所属模块**:10 HTTP 客户端 **依赖**:168-176 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
全部客户端配置改造后:现有测试全绿;外部服务 mock 集成测试通过;行为与默认配置下现状一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:各客户端测试绿、HttpClientPool 既有测试绿、配置绑定测试、超时测试、复用测试、幂等守卫、日志脱敏、全量单测
|
||||
|
||||
### 验证方法
|
||||
`mvn test` 全量 + `mvn clean package -DskipTests`。
|
||||
@@ -1,245 +0,0 @@
|
||||
# 11-plan — 可观测性:指标定义与日志字段规范
|
||||
|
||||
> 对应 `docs/specs/11-observability.md`。决策:指标名与日志字段规范先行落地;不引入新监控组件(Micrometer 若已依赖则用,未依赖则手动计数器+日志)。
|
||||
> 技术栈:Java 21 + Slf4j +(可选 Micrometer)。
|
||||
|
||||
## 任务 178:日志字段规范落地
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
业务日志统一携带结构化字段:traceId/taskId/moduleType/stage/submissionId/chunkIndex/chunkTotal/jobId/result/errorType;缺失字段用占位;不删现有日志。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_worker_log_has_task_id — Worker 日志含 taskId
|
||||
2. test_worker_log_has_module_type
|
||||
3. test_worker_log_has_stage
|
||||
4. test_result_log_fields — /result 日志字段
|
||||
5. test_heartbeat_log_fields
|
||||
6. test_missing_field_placeholder — 缺字段占位
|
||||
7. test_log_field_names_frozen — 字段名快照
|
||||
8. test_no_log_content_break — 日志内容不破坏
|
||||
|
||||
## 任务 179:禁止记录清单审计
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:178 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
审计日志代码:Token/Cookie/完整请求体/文件二进制/用户凭据/敏感 API Key 不入日志;发现问题修正。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_no_token_logged — 无 Token
|
||||
2. test_no_cookie_logged — 无 Cookie
|
||||
3. test_no_full_body_logged — 无完整 body
|
||||
4. test_no_binary_logged — 无二进制
|
||||
5. test_no_credential_logged — 无凭据
|
||||
6. test_no_api_key_logged — 无 API Key
|
||||
7. test_allowed_fields_kept — 允许字段保留
|
||||
8. test_audit_script — 审计脚本可重复
|
||||
|
||||
## 任务 180:Worker 日志字段对齐
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:73 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
TaskResultFileJobWorker(04 改造后)日志字段与规范对齐:jobId/taskId/moduleType/stage/errorType;现有 [task-file-job] 前缀保留。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_dispatch_log_fields — dispatch 日志
|
||||
2. test_success_log_fields
|
||||
3. test_failure_log_fields
|
||||
4. test_retry_log_fields
|
||||
5. test_heartbeat_log_fields
|
||||
6. test_stuck_log_fields
|
||||
7. test_field_names_consistent — 与规范一致
|
||||
8. test_no_sensitive — 无敏感
|
||||
|
||||
## 任务 181:task.created/running 指标埋点
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
任务创建(created 计数)与运行中(running gauge)指标;带 moduleType/instanceId 标签;无监控栈时输出日志记录。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_created_incremented — 创建计数
|
||||
2. test_running_gauge — 运行 gauge
|
||||
3. test_module_label — 标签
|
||||
4. test_instance_label — instanceId 标签
|
||||
5. test_created_module_specific — 分模块
|
||||
6. test_counter_persistent — 计数正确性
|
||||
7. test_gauge_update — 更新
|
||||
8. test_metric_name_frozen — 名称快照
|
||||
|
||||
## 任务 182:task.success/failed/cancelled 指标埋点
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:181 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
终态计数:success/failed/cancelled 各模块独立计数;与状态迁移一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_success_counted
|
||||
2. test_failed_counted
|
||||
3. test_cancelled_counted
|
||||
4. test_module_split — 分模块
|
||||
5. test_no_double_count — 不重复计
|
||||
6. test_terminal_once — 只计一次
|
||||
7. test_failed_then_success — 状态反转不重计
|
||||
8. test_names_frozen
|
||||
|
||||
## 任务 183:task.duration 指标埋点
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:182 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
任务耗时(开始→终态)记录;直方图或耗时日志;分模块。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_duration_recorded — 记录
|
||||
2. test_duration_positive — 正值
|
||||
3. test_module_split
|
||||
4. test_short_task — 短任务
|
||||
5. test_long_task — 长任务
|
||||
6. test_duration_bound — 上界
|
||||
7. test_duration_zero_guard — 零保护
|
||||
8. test_name_frozen
|
||||
|
||||
## 任务 184:task.heartbeat.age 指标埋点
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
心跳年龄 gauge:任务最后心跳距今时间;超阈值可观测(日志告警)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_age_computed — 年龄计算
|
||||
2. test_age_fresh — 新鲜
|
||||
3. test_age_stale — 陈旧
|
||||
4. test_age_threshold_warn — 阈值告警
|
||||
5. test_no_heartbeat — 无心跳处理
|
||||
6. test_age_zero — 刚心跳
|
||||
7. test_age_clock_negative — 时钟负保护
|
||||
8. test_name_frozen
|
||||
|
||||
## 任务 185:file-job.* 指标埋点
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:73 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
TaskFileJobWorker 指标:pending/running/success/failed/duration/retry;分 moduleType/instanceId。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_pending_counted
|
||||
2. test_running_counted
|
||||
3. test_success_counted
|
||||
4. test_failed_counted
|
||||
5. test_duration_recorded
|
||||
6. test_retry_counted
|
||||
7. test_module_instance_labels
|
||||
8. test_names_frozen
|
||||
|
||||
## 任务 186:上传耗时/大小指标埋点
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
文件上传:耗时、大小、成功率指标;分 moduleType。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_upload_duration
|
||||
2. test_upload_size
|
||||
3. test_upload_success_rate
|
||||
4. test_module_split
|
||||
5. test_upload_failed
|
||||
6. test_upload_large
|
||||
7. test_size_bound
|
||||
8. test_names_frozen
|
||||
|
||||
## 任务 187:临时磁盘指标埋点
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:154 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
临时磁盘容量/占用指标;与 09 告警联动。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_disk_usage_measured
|
||||
2. test_disk_capacity
|
||||
3. test_usage_percent
|
||||
4. test_threshold_warn
|
||||
5. test_empty_dir
|
||||
6. test_measure_failure_grace
|
||||
7. test_name_frozen
|
||||
8. test_no_block
|
||||
|
||||
## 任务 188:指标标签规范
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:181-187 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
统一标签:moduleType/instanceId 必带;标签值规范化(null→unknown);不记录用户级数据。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_module_label_all_metrics — 全指标带
|
||||
2. test_instance_label_all
|
||||
3. test_null_module_unknown — null 归一
|
||||
4. test_no_user_label — 无用户级
|
||||
5. test_label_consistent — 命名一致
|
||||
6. test_label_value_clean — 值清洗
|
||||
7. test_cardinality_bounded — 基数有界
|
||||
8. test_spec_frozen — 规范冻结
|
||||
|
||||
## 任务 189:指标命名一致性测试
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:188 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
全部指标名与 11 spec §1 标准名一致(aiimage.* 前缀);无拼写漂移。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_prefix_aiimage — 前缀
|
||||
2. test_task_metric_names — 任务族
|
||||
3. test_file_job_metric_names — 文件族
|
||||
4. test_no_typo_drift — 无拼写漂移
|
||||
5. test_snapshot_all_metrics — 全指标快照
|
||||
6. test_new_metric_must_register — 新指标注册
|
||||
7. test_metric_doc_sync — 文档同步
|
||||
8. test_case_consistent — 大小写一致
|
||||
|
||||
## 任务 190:日志脱敏测试
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:179 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
敏感值(Token/Key/凭据)即使传入日志调用点也被脱敏(占位符);断言日志输出无原文。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_token_masked
|
||||
2. test_api_key_masked
|
||||
3. test_password_masked
|
||||
4. test_cookie_masked
|
||||
5. test_partial_token_masked — 部分值
|
||||
6. test_url_query_masked — URL 查询参数
|
||||
7. test_masking_consistent — 一致
|
||||
8. test_normal_fields_kept — 正常字段保留
|
||||
|
||||
## 任务 191:双实例指标区分回归
|
||||
|
||||
**所属模块**:11 可观测性 **依赖**:188-190 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
双实例部署:instanceId 标签区分 server-110/server-121;指标不串;日志含实例标识。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_instance_110_label
|
||||
2. test_instance_121_label
|
||||
3. test_no_cross_instance — 不串
|
||||
4. test_instance_unknown — 未配置
|
||||
5. test_log_has_instance — 日志实例
|
||||
6. test_metric_aggregation_ok — 聚合可用
|
||||
7. test_label_stable — 标签稳定
|
||||
8. test_snapshot_frozen
|
||||
|
||||
### 收尾验证(本模块)
|
||||
`mvn test` 相关类全绿;11 spec §2 禁止记录清单逐项对照。
|
||||
@@ -1,137 +0,0 @@
|
||||
# 12-plan — Flyway 迁移规范与只读巡检
|
||||
|
||||
> 对应 `docs/specs/12-flyway-and-inspection.md`。只追加不改历史;巡检默认关闭。
|
||||
> 技术栈:Java 21 + Flyway + SQL。
|
||||
|
||||
## 任务 192:迁移规范模板
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
`docs/` 产出迁移规范模板:变更目的/影响表和数据量/锁表风险/验证 SQL/回滚步骤/上线窗口六项必填;新迁移文件头注释引用模板。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_template_exists — 模板存在
|
||||
2. test_six_fields — 六字段齐全
|
||||
3. test_template_has_example — 示例
|
||||
4. test_rollback_steps — 回滚步骤
|
||||
5. test_validation_sql — 验证 SQL 示例
|
||||
6. test_window_field — 上线窗口
|
||||
7. test_doc_committed
|
||||
8. test_template_usable — 可复制使用
|
||||
|
||||
## 任务 193:历史迁移盘点
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
盘点 db/ 下 V87+ 迁移:编号连续性、无修改历史(git 不动)、生产已执行版本核对;产出盘点报表。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_version_sequential — 编号连续
|
||||
2. test_no_legacy_modified — 历史未改
|
||||
3. test_latest_version_noted — 最新版本记录
|
||||
4. test_duplicate_version — 无重复编号
|
||||
5. test_migration_single_purpose — 单迁移单目的(抽查)
|
||||
6. test_report_committed
|
||||
7. test_checksum_stable — 校验和稳定
|
||||
8. test_repeatable
|
||||
|
||||
## 任务 194:orphan Job 巡检 SQL
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
巡检 SQL:task_file_job 无对应 task/result;SQL 只读;输出孤儿清单。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_sql_syntax_valid — 语法有效
|
||||
2. test_sql_read_only — 只读(SELECT)
|
||||
3. test_orphan_detected — 检出
|
||||
4. test_valid_excluded — 正常排除
|
||||
5. test_join_condition — 关联条件
|
||||
6. test_no_side_effect — 无副作用
|
||||
7. test_empty_result_ok — 空结果
|
||||
8. test_documented — 文档
|
||||
|
||||
## 任务 195:orphan payload 巡检 SQL
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
同 194 模式(payload 无对应任务)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 194(payload 表)。
|
||||
|
||||
## 任务 196:任务存在结果缺失巡检 SQL
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
同 194 模式(SUCCESS 任务无结果)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 194。
|
||||
|
||||
## 任务 197:结果存在文件缺失巡检 SQL
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
同 194 模式(resultFileUrl 对应对象不存在——SQL 先出清单,对象检查在 09/158 配合)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 194。
|
||||
|
||||
## 任务 198:已完成任务活跃 Job 巡检 SQL
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
同 194 模式(终态任务仍有活跃 job)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 194。
|
||||
|
||||
## 任务 199:超保留期引用巡检 SQL
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
同 194 模式(临时文件超保留期仍有引用)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
同 194。
|
||||
|
||||
## 任务 200:巡检报表任务落地
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:194-199 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
巡检定时任务:执行 6 张报表 SQL;默认 disabled;启用后输出报表日志;失败不阻断。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_disabled_default
|
||||
2. test_enabled_runs_all — 6 报表全跑
|
||||
3. test_report_output
|
||||
4. test_failure_grace
|
||||
5. test_schedule_config
|
||||
6. test_no_delete
|
||||
7. test_dual_instance
|
||||
8. test_enabled_stable
|
||||
|
||||
## 任务 201:迁移演练
|
||||
|
||||
**所属模块**:12 Flyway **依赖**:192 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
副本库演练:flyway migrate 干净执行;验证 SQL 通过;锁表风险评估(索引类迁移在表大小场景);回滚步骤验证。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_migrate_clean — 干净迁移
|
||||
2. test_validate_sql_pass — 验证 SQL
|
||||
3. test_rollback_script — 回滚
|
||||
4. test_lock_window_estimated — 锁窗口
|
||||
5. test_checksum_ok
|
||||
6. test_idempotent_rerun
|
||||
7. test_no_legacy_touch — 不动历史
|
||||
8. test_documented
|
||||
|
||||
### 收尾验证(本模块)
|
||||
`mvn test` 相关类 + 巡检 SQL 在副本库执行通过。
|
||||
@@ -1,315 +0,0 @@
|
||||
# 13-plan — 契约测试与模块边界治理
|
||||
|
||||
> 对应 `docs/specs/13-contract-tests-and-boundaries.md`。契约测试与代码同 PR 提交;CI 追加测试阶段。
|
||||
> 技术栈:Java 21 + JUnit5 + ArchUnit + Vitest(前端)。
|
||||
|
||||
## 任务 202:Python-contract 夹具准备
|
||||
|
||||
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
录制 app_client/amazon 实际调用(/result、/items、parsed-payload、heartbeat)的真实请求报文,脱敏后入测试资源(JSON 夹具);夹具文件结构明确。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_fixture_result_exists — result 夹具
|
||||
2. test_fixture_items_exists — items 夹具
|
||||
3. test_fixture_parsed_payload — parsed-payload 夹具
|
||||
4. test_fixture_heartbeat — heartbeat 夹具
|
||||
5. test_fixture_sanitized — 脱敏(无真实凭据)
|
||||
6. test_fixture_shape_valid — 结构有效
|
||||
7. test_fixture_fields_documented — 字段说明
|
||||
8. test_fixture_reproducible — 可复录
|
||||
|
||||
## 任务 203:/result 幂等契约测试
|
||||
|
||||
**所属模块**:13 契约 **依赖**:202 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
同 submissionId 重复提交 /result:HTTP 200 + success=true;只落一次;chunkIndex/chunkTotal 语义;done=true 封口。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_result_success_contract — 200+true
|
||||
2. test_result_duplicate_idempotent — 幂等
|
||||
3. test_result_single_persist — 单次落库
|
||||
4. test_result_chunk_fields — 分片字段
|
||||
5. test_result_done_contract — 封口
|
||||
6. test_result_error_contract — 失败语义
|
||||
7. test_result_unknown_task — 未知任务
|
||||
8. test_result_fixture_replay — 夹具回放
|
||||
|
||||
## 任务 204:/items 分页语义契约测试
|
||||
|
||||
**所属模块**:13 契约 **依赖**:202 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
collectdata/publish 的 items 接口:分页参数(page/pageSize)、排序、字段结构、缺省行为与 Python Worker 拉取约定一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_items_pagination — 分页
|
||||
2. test_items_defaults — 默认值
|
||||
3. test_items_field_shape — 字段结构
|
||||
4. test_items_page_bounds — 越界处理
|
||||
5. test_items_order — 排序
|
||||
6. test_items_empty — 空页
|
||||
7. test_items_worker_order — Worker 顺序
|
||||
8. test_items_fixture_replay
|
||||
|
||||
## 任务 205:parsed-payload 契约测试
|
||||
|
||||
**所属模块**:13 契约 **依赖**:202 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
similarasin/appearancepatent 的 parsed-payload:字段结构、分页语义、submissionId 关联与 Python 读取约定一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_parsed_payload_shape
|
||||
2. test_parsed_payload_pagination
|
||||
3. test_parsed_payload_submission
|
||||
4. test_parsed_payload_empty
|
||||
5. test_parsed_payload_unknown_task
|
||||
6. test_parsed_payload_fixture_replay
|
||||
7. test_parsed_payload_status
|
||||
8. test_parsed_payload_frozen
|
||||
|
||||
## 任务 206:heartbeat 旧字段契约测试
|
||||
|
||||
**所属模块**:13 契约 **依赖**:202 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
heartbeat 接口:路径、请求/响应字段与 Python Worker 约定一致;缺字段/多余字段处理。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_heartbeat_path
|
||||
2. test_heartbeat_fields
|
||||
3. test_heartbeat_unknown_task
|
||||
4. test_heartbeat_missing_optional
|
||||
5. test_heartbeat_extra_field_tolerant — 多余字段容忍
|
||||
6. test_heartbeat_fixture_replay
|
||||
7. test_heartbeat_success
|
||||
8. test_heartbeat_frozen
|
||||
|
||||
## 任务 207:done=true 最后一批契约测试
|
||||
|
||||
**所属模块**:13 契约 **依赖**:203 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
done=true 最后一批:强制处理剩余数据、生成结果文件、任务终态;协议与 Python 端一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_done_force_process
|
||||
2. test_done_finalize_task
|
||||
3. test_done_generate_file
|
||||
4. test_done_after_partial_chunks
|
||||
5. test_done_no_pending — 无剩余
|
||||
6. test_done_repeat
|
||||
7. test_done_fixture_replay
|
||||
8. test_done_frozen
|
||||
|
||||
## 任务 208:JavaApiResponse 包装契约测试(前端)
|
||||
|
||||
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
前端契约:JavaApiResponse 结构(success/message/data);LegacyApiSuccess(msg)兼容;解包行为(复用 01 callJava 测试)固化。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_java_response_success_shape
|
||||
2. test_java_response_failure_shape
|
||||
3. test_legacy_success_shape
|
||||
4. test_unwrap_success
|
||||
5. test_unwrap_failure_throws
|
||||
6. test_null_data_shape
|
||||
7. test_extra_fields_tolerant
|
||||
8. test_snapshot_frozen
|
||||
|
||||
## 任务 209:字段兼容 schema 覆盖
|
||||
|
||||
**所属模块**:13 契约 **依赖**:208 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
核心字段 schema:user_id/task_ids(请求)、taskId/resultId/fileKey/status/taskStatus/fileStatus(响应);api-field-compat 检查接入。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_request_user_id_schema
|
||||
2. test_request_task_ids_schema
|
||||
3. test_response_task_id_schema
|
||||
4. test_response_result_id_schema
|
||||
5. test_response_file_key_schema
|
||||
6. test_response_status_schema
|
||||
7. test_compat_checker_integrated
|
||||
8. test_schema_frozen
|
||||
|
||||
## 任务 210:ArchUnit 依赖方向规则
|
||||
|
||||
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
ArchUnit 规则:Controller→Service→Mapper 单向;Controller 不依赖外部 Client 细节;task 模块规则见 212;规则测试可运行。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_controller_depends_service — 允许方向
|
||||
2. test_service_depends_mapper — 允许
|
||||
3. test_controller_to_mapper_forbidden — 禁止
|
||||
4. test_no_cycle — 无环
|
||||
5. test_rule_scope_modules — 作用域
|
||||
6. test_rule_verbose — 失败信息
|
||||
7. test_all_controllers_covered — 覆盖
|
||||
8. test_rule_stable — 稳定
|
||||
|
||||
## 任务 211:ArchUnit Controller 不访问 Mapper
|
||||
|
||||
**所属模块**:13 契约 **依赖**:210 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
强化规则:任何 Controller 不得注入/调用 Mapper;违例失败。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_no_mapper_in_controller
|
||||
2. test_violation_detected — 违例检出
|
||||
3. test_message_clear
|
||||
4. test_controller_service_ok — 允许路径
|
||||
5. test_all_controllers_covered
|
||||
6. test_no_mapper_field
|
||||
7. test_rule_in_ci
|
||||
8. test_snapshot_frozen
|
||||
|
||||
## 任务 212:ArchUnit task 模块不依赖业务模块
|
||||
|
||||
**所属模块**:13 契约 **依赖**:210 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
公共 task 模块不得 import 业务模块(similarasin/appearancepatent/...);04 的 Handler SPI 已反转依赖;规则检查通过。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_task_no_business_dep — 无业务依赖
|
||||
2. test_spi_interface_allowed — SPI 接口豁免
|
||||
3. test_violation_detected
|
||||
4. test_message_clear
|
||||
5. test_04_registry_ok — 注册表符合
|
||||
6. test_all_task_classes_covered
|
||||
7. test_rule_in_ci
|
||||
8. test_snapshot_frozen
|
||||
|
||||
## 任务 213:前端共享层导出白名单
|
||||
|
||||
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
TS 检查:页面(pages/*)禁止直接 import shared/api/http.ts 或拼 URL;只允许 import java-modules.ts 的 API 函数与 bridges;违例编译失败(lint 规则或类型守卫)。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_page_no_http_direct — 页面不直连 http
|
||||
2. test_page_no_url_concat — 不拼 URL
|
||||
3. test_page_uses_api_module — 用 API 层
|
||||
4. test_shared_internal_allowed — shared 内部允许
|
||||
5. test_bridge_allowed — bridge 允许
|
||||
6. test_violation_detected
|
||||
7. test_check_runs_in_ci
|
||||
8. test_allowlist_frozen
|
||||
|
||||
## 任务 214:progress/batch 轻量响应契约
|
||||
|
||||
**所属模块**:13 契约 **依赖**:109 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
progress/batch 契约:items/missingTaskIds 结构;task 轻量字段;file 字段(除 collectdata);前端解析一致。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_progress_batch_shape
|
||||
2. test_missing_ids_shape
|
||||
3. test_task_light_fields
|
||||
4. test_file_fields_included
|
||||
5. test_collectdata_exception — 例外模块
|
||||
6. test_frontend_parse_compat
|
||||
7. test_snapshot_frozen
|
||||
8. test_light_vs_batch_consistency
|
||||
|
||||
## 任务 215:下载 URL 格式契约
|
||||
|
||||
**所属模块**:13 契约 **依赖**:147 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
downloadUrl 契约:公开直链格式(https、bucket 包含、result/ 前缀下载域名);无签名;前端 save_file 流程兼容。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_download_url_https
|
||||
2. test_download_url_bucket
|
||||
3. test_result_prefix_endpoint
|
||||
4. test_no_signature
|
||||
5. test_frontend_save_compat
|
||||
6. test_blank_handling
|
||||
7. test_contract_frozen
|
||||
8. test_download_flow_end2end
|
||||
|
||||
## 任务 216:CI 接入测试阶段
|
||||
|
||||
**所属模块**:13 契约 **依赖**:210-215 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
.gitea/workflows/build.yml 追加:mvn test(契约+ArchUnit)、前端 vitest、契约快照比对;失败即红。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_ci_has_test_stage — 测试阶段
|
||||
2. test_ci_java_tests — Java 测试命令
|
||||
3. test_ci_frontend_tests — 前端测试
|
||||
4. test_ci_snapshot_check
|
||||
5. test_ci_fail_fast — 失败即红
|
||||
6. test_ci_cache
|
||||
7. test_ci_timeout
|
||||
8. test_ci_documented
|
||||
|
||||
## 任务 217:快照对比工具
|
||||
|
||||
**所属模块**:13 契约 **依赖**:90 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
Service 拆分前后响应一致工具:录制(输入→输出)golden;对比(输出 diff);供 05 各模块使用。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_tool_records
|
||||
2. test_tool_compares_equal
|
||||
3. test_tool_diff_detected
|
||||
4. test_tool_output_report
|
||||
5. test_tool_reusable
|
||||
6. test_tool_commits_golden
|
||||
7. test_tool_clear_error
|
||||
8. test_tool_documented
|
||||
|
||||
## 任务 218:结果文件格式契约
|
||||
|
||||
**所属模块**:13 契约 **依赖**:无 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
结果文件格式契约:文件名(*-result.xlsx 模式)、Sheet 名称、列顺序、ZIP 结构;与 Python/前端约定一致;改造(04/05)后不变。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1. test_filename_pattern
|
||||
2. test_sheet_name
|
||||
3. test_column_order
|
||||
4. test_zip_structure
|
||||
5. test_encoding_utf8
|
||||
6. test_empty_result_file
|
||||
7. test_contract_frozen
|
||||
8. test_regression_guard
|
||||
|
||||
## 任务 219:13 全量契约回归
|
||||
|
||||
**所属模块**:13 契约 **依赖**:202-218 **预估**:8-15 分钟
|
||||
|
||||
### 功能点要求
|
||||
全部契约测试(Java + 前端)+ ArchUnit + 白名单检查全绿;契约快照冻结;CI 通过。
|
||||
|
||||
### 测试用例(≥8)
|
||||
1-8:Java 契约全绿、前端契约全绿、ArchUnit 三规则、白名单、快照比对、CI 模拟、全量单测、package
|
||||
|
||||
### 验证方法
|
||||
`mvn test` 全量 + `cd frontend-vue && npm run build && npx vitest run` + CI 检查。
|
||||
|
||||
### 收尾验证(全部模块——启动性/核心功能/质量 gate)
|
||||
1. `mvn clean package -DskipTests` 产 JAR,`java -jar target/aiimage-backend-0.0.1-SNAPSHOT.jar`(本地配置)启动,curl 健康检查端点返回预期
|
||||
2. 核心页面(`/newApi/api/...` 抽样)可访问
|
||||
3. 核心交互路径:上传→解析→进度→下载最小链路真实调用非空
|
||||
4. `mvn test` 全绿(≥80% 覆盖抽查)
|
||||
5. `npm run build`(vue-tsc + vite)零错误;`npx vitest run` 全绿
|
||||
6. check_progress 脚本返回 all tasks done(exit 0)
|
||||
7. git log 验证每个 task 有对应 commit
|
||||
@@ -1,45 +0,0 @@
|
||||
-- =============================================================
|
||||
-- V143 回滚补丁:撤销多公司一期(company 主表 + users.company_id + 后台「公司管理」菜单)
|
||||
--
|
||||
-- 【为什么是一个手工脚本,而不是一条 V144 迁移】
|
||||
-- src/main/resources/db/ 是 Flyway 的扫描路径,放进去的任何 V*.sql 都会在应用下次启动时
|
||||
-- 被自动执行。把回滚写成 V144__rollback_company.sql 的后果是:哪怕没人打算回滚,
|
||||
-- 只要集群里还起着带这个文件的 jar,Flyway 就会静默撤销 V143——表没了、列没了、
|
||||
-- 已归属公司的账号全变回无公司状态。回滚必须是一个"只有决定回滚时才有人跑"的东西。
|
||||
--
|
||||
-- 前置事实:V143 从未给任何业务表加列,所以业务数据不受影响,回滚面只有 users 这一列。
|
||||
-- 回滚后已建的 company_id 值一并丢失,账号本身、密码、角色、权限都不受影响。
|
||||
--
|
||||
-- 执行顺序(缺一都会留下不一致状态):
|
||||
-- 1. 停两台 java 应用 —— 否则回滚窗口里新代码还在往 users.company_id 写,会报 unknown column
|
||||
-- 2. 在 MySQL 上按本文件顺序执行(先删索引再删列,反了会 ER_CANT_DROP_FIELD_OR_KEY 之外还留残索引)
|
||||
-- 3. 把 flyway_schema_history 里本版本那行删掉(本文件最后一条语句)
|
||||
-- 不删的后果:将来重新部署带 V143 的 jar 时,Flyway 认为"已应用"直接跳过,
|
||||
-- 表和列都不会重建,而 Java 侧实体照常读写 company_id ⇒ 运行期报 unknown column
|
||||
-- 4. 回滚 jar 到 V142 版本,再起应用
|
||||
-- 5. 若两台不能同时停(滚动回退),必须保证第 2、3 步在**两台都已停下**之后才做
|
||||
-- =============================================================
|
||||
|
||||
ALTER TABLE `users` DROP INDEX `idx_users_company_id`;
|
||||
|
||||
ALTER TABLE `users` DROP COLUMN `company_id`;
|
||||
|
||||
DROP TABLE IF EXISTS `company`;
|
||||
|
||||
DELETE FROM `columns` WHERE `column_key` = 'admin_companies';
|
||||
|
||||
DELETE FROM `flyway_schema_history` WHERE `version` = '143';
|
||||
|
||||
-- =============================================================
|
||||
-- 验证(回滚后执行)
|
||||
-- SHOW COLUMNS FROM `users` LIKE 'company_id'; -> 期望 0 行
|
||||
-- SHOW INDEX FROM `users` WHERE Key_name = 'idx_users_company_id';
|
||||
-- -> 期望 0 行
|
||||
-- SHOW TABLES LIKE 'company'; -> 期望 0 行
|
||||
-- SELECT COUNT(*) AS menu_rows FROM `columns` WHERE `column_key` = 'admin_companies';
|
||||
-- -> 期望 0
|
||||
-- SELECT `version` FROM `flyway_schema_history` WHERE `version` = '143';
|
||||
-- -> 期望 0 行
|
||||
-- SELECT COUNT(*) AS max_version FROM `flyway_schema_history`
|
||||
-- WHERE CAST(`version` AS UNSIGNED) > 142; -> 期望 0
|
||||
-- =============================================================
|
||||
@@ -1,36 +0,0 @@
|
||||
-- 回滚 V145(人工补丁,不放进 src/main/resources/db/——那里是 Flyway 扫描路径,
|
||||
-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"这件事
|
||||
-- 在没有人工执行的情况下自己发生。)
|
||||
--
|
||||
-- 顺序:停两台应用 → 执行本脚本 → DELETE FROM flyway_schema_history WHERE version='145'
|
||||
-- → 回滚 jar → 起应用。
|
||||
-- 漏掉"删历史行"那步,将来重装带 V145 的 jar 时 Flyway 判定"已应用"直接跳过,列与键都不会重建,
|
||||
-- 而 Java 侧实体照常读写 company_id ⇒ 运行期 Unknown column。
|
||||
--
|
||||
-- ⚠ 本脚本默认只做「保留新列、把唯一键退回全局」这一档。
|
||||
-- 退回全局唯一键要求"跨公司没有同名值"——批次 2(消费侧)上线之后这个前提不再由代码保证,
|
||||
-- 所以第二段是注释掉的,解开前先备份这两张表。
|
||||
-- 报 1062 说明确实已经有跨公司同名行:此时【不要】硬删数据,改走"保留新键、只回滚 jar"
|
||||
-- (新列对新 jar 是惰性的,不读写就不影响)。
|
||||
|
||||
-- ---------- 1. 唯一键退回全局(先加旧键、后删新键,理由同 V145:中间任一步都至少有一个唯一键在守并发) ----------
|
||||
|
||||
ALTER TABLE `biz_invalid_asin_data`
|
||||
ADD UNIQUE KEY `uk_data_value_brand` (`data_value`, `brand`(191)),
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
ALTER TABLE `biz_invalid_asin_data`
|
||||
DROP INDEX `uk_company_value_brand`,
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
|
||||
ALTER TABLE `biz_dedupe_total_data`
|
||||
ADD UNIQUE KEY `uk_data_value` (`data_value`),
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
ALTER TABLE `biz_dedupe_total_data`
|
||||
DROP INDEX `uk_company_data_value`,
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
|
||||
-- ---------- 2. 真的要把列也删掉才解开下面两行(不可逆,先备份) ----------
|
||||
-- company_id 上带着 50.7 万行的归属信息,一旦 DROP 就只能靠"全表填 1"重建,而第 2 家公司已经开通
|
||||
-- ⇒ 那次之后再也分不清哪一行属于谁。除非确认没有任何一行 company_id <> 1,否则不要执行。
|
||||
-- ALTER TABLE `biz_invalid_asin_data` DROP COLUMN `uploader_user_id`, DROP COLUMN `company_id`;
|
||||
-- ALTER TABLE `biz_dedupe_total_data` DROP COLUMN `company_id`;
|
||||
@@ -1,42 +0,0 @@
|
||||
-- 回滚 V147(人工补丁,不放进 src/main/resources/db/——那里是 Flyway 扫描路径,
|
||||
-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"这件事
|
||||
-- 在没有人工执行的情况下自己发生。)
|
||||
--
|
||||
-- 顺序:停两台应用 → 执行本脚本 → DELETE FROM flyway_schema_history WHERE version='147'
|
||||
-- → 回滚 jar → 起应用。
|
||||
-- 漏掉"删历史行"那步,将来重装带 V147 的 jar 时 Flyway 判定"已应用"直接跳过,列与键都不会重建,
|
||||
-- 而 Java 侧实体照常读写 company_id ⇒ 运行期 Unknown column。
|
||||
--
|
||||
-- ⚠ 本脚本默认只做「保留新列、把唯一键退回全局」这一档。
|
||||
-- 退回全局唯一键要求"跨公司没有同名 category_key"。V147 之前该键是全平台唯一,所以【回填那一刻】
|
||||
-- 必然满足;但批次 2/3(每公司自建类目)上线之后这一前提不再由代码保证——两家各自建了同名
|
||||
-- 自定义类目时,generateCategoryKey(parentId, name) 会算出同一串。所以先跑第 0 段那条预检查询。
|
||||
-- 报 1062 说明确实已经有跨公司同名行:此时【不要】硬删数据,改走"保留新键、只回滚 jar"
|
||||
-- (新列对新 jar 是惰性的,不读写就不影响)。
|
||||
|
||||
-- ---------- 0. 预检(必须先跑,返回 0 行才允许第 1 段) ----------
|
||||
-- SELECT company_id, category_key, COUNT(*) c
|
||||
-- FROM `biz_product_category`
|
||||
-- GROUP BY company_id, category_key
|
||||
-- HAVING COUNT(*) > 1;
|
||||
-- -> 期望 0 行。非 0 就是"跨公司已有同名键",第 1 段会撞 1062。
|
||||
-- SELECT SUM(is_builtin = 1 AND company_id <> 0) AS bad_builtin
|
||||
-- FROM `biz_product_category`;
|
||||
-- -> 期望 0。非 0 说明有内置节点被当成公司自建,回滚后这些节点在旧 jar 里仍会出现在每一家的树上,
|
||||
-- 与 V147 之前的行为一致,不影响回滚本身,但要记进核对清单。
|
||||
|
||||
-- ---------- 1. 唯一键退回全局(先加旧键、后删新键,理由同 V147:中间任一步都至少有一个唯一键在守并发) ----------
|
||||
|
||||
ALTER TABLE `biz_product_category`
|
||||
ADD UNIQUE KEY `uk_product_category_key` (`category_key`),
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
ALTER TABLE `biz_product_category`
|
||||
DROP INDEX `uk_company_category_key`,
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
|
||||
-- ---------- 2. 真的要把列也删掉才解开下面这行(不可逆,先备份) ----------
|
||||
-- company_id 上写着"哪个自定义节点是哪一家建的",而这张表没有任何账号列(V147 §2:事后无法反推),
|
||||
-- 一旦 DROP 就只能靠"全表填 1"重建 ⇒ 第 2 家自建的类目会全部划归第 1 家,且再没有证据能分回去。
|
||||
-- 另外哨兵那条纪律在这里同样成立:摘 DEFAULT 用 ALTER COLUMN ... DROP DEFAULT,
|
||||
-- 任何时候都不要写 MODIFY COLUMN(重建表会按"当时的列默认值"物化历史行)。
|
||||
-- ALTER TABLE `biz_product_category` DROP COLUMN `company_id`;
|
||||
@@ -1,149 +0,0 @@
|
||||
-- =============================================================
|
||||
-- 回滚补丁 V149__permission_menu_company_tree(人工执行,故意放在 Flyway 扫描路径之外)
|
||||
-- 对应迁移:src/main/resources/db/V149__permission_menu_company_tree.sql
|
||||
-- 设计:crawler-plugin/docs/ops/menu-company-tree-design-2026-10-06.md §9
|
||||
--
|
||||
-- 【为什么不是 V150】src/main/resources/db/ 是 Flyway 扫描路径,任何 V*.sql 都会在应用下次启动时
|
||||
-- 自动执行。把回滚编成版本化迁移,等于让"决定回滚"这件事在没有人工执行的情况下自己发生。
|
||||
--
|
||||
-- 【执行顺序,一步不能换】
|
||||
-- 1) 停两台 java(/api 经主机 B 的 clb 打到两台,留一台跑旧 jar 会让回滚中途被写入)
|
||||
-- 2) 先跑第 0 段的两个 COUNT,把数记下来 —— 第 3 段判据要用它
|
||||
-- 3) 跑本脚本(第 1..7 段)
|
||||
-- 4) 删 flyway_schema_history 的 version=149 行(第 8 段;漏掉这步,将来重装时 Flyway
|
||||
-- 见"已应用"会跳过 V149,回滚就白做了一半)
|
||||
-- 5) 回滚 jar 到与本批不兼容的上一版(即只认 V147 及更早、columns 还没有 company_id 的那版构建;
|
||||
-- V148 是已退役空号,不存在对应 jar —— 号位以 docs/migration-inventory.md 为准)
|
||||
-- 6) 起应用
|
||||
--
|
||||
-- 【顺序上的唯一陷阱:必须先重指授权、后删副本】
|
||||
-- user_column_permission 的 FK 是 ON DELETE CASCADE:直接 DELETE 副本行会把它名下所有授权
|
||||
-- 一起删光 —— 而 V149 之后账号名下"本来就该"挂的是副本行。所以第 2 段先按 column_key 把指针
|
||||
-- 挪回公司 1 的源行,第 3 段才敢删副本。这两段写反 = 把 133 只账号的菜单全清掉。
|
||||
-- =============================================================
|
||||
|
||||
-- ---------- 0. 回滚前取证(只读,先把这两个数抄下来) ----------
|
||||
|
||||
-- 0a 副本行数(V149 后应 = 公司数-1 家 × 51)
|
||||
SELECT 'V149_ROLLBACK_PRE copy_rows' AS marker, COUNT(*) AS rows_to_delete
|
||||
FROM `columns` WHERE company_id <> 1;
|
||||
|
||||
-- 0b 挂在副本上的授权数(这些是回滚后必须回到源行的那批)
|
||||
SELECT 'V149_ROLLBACK_PRE grants_on_copies' AS marker, COUNT(*) AS grants_to_repoint
|
||||
FROM `user_column_permission` g
|
||||
JOIN `users` u ON u.id = g.user_id
|
||||
JOIN `columns` c ON c.id = g.column_id
|
||||
WHERE c.company_id <> 1;
|
||||
|
||||
-- ---------- 1. 备份(两张都整表抄,回滚失败时按 <表名>_bak_v149_rollback 反插) ----------
|
||||
-- 必须显式建、不要依赖 mysqldump:这两张表小(52+ 行 / 784 行),同库内备份是秒级,
|
||||
-- 而"删完才发现判据错"的唯一出路就是这里有原样一份。
|
||||
|
||||
CREATE TABLE IF NOT EXISTS `columns_bak_v149_rollback` AS SELECT * FROM `columns`;
|
||||
CREATE TABLE IF NOT EXISTS `user_column_permission_bak_v149_rollback` AS SELECT * FROM `user_column_permission`;
|
||||
|
||||
-- ---------- 2. 授权指针挪回公司 1 的源行 ----------
|
||||
|
||||
-- 2a 先去重:同一账号若同时挂着源行与副本(正常不会有,属 repair 中途态),删副本那一侧,
|
||||
-- 留源行那一侧给 2b 判定,避免 2b 撞 PK (user_id, column_id) 报 1062。
|
||||
DELETE dup FROM `user_column_permission` dup
|
||||
JOIN `users` u ON u.id = dup.user_id
|
||||
JOIN `columns` copy ON copy.id = dup.column_id AND copy.company_id = u.company_id
|
||||
JOIN `columns` src ON src.id <> copy.id AND src.column_key = copy.column_key AND src.company_id = 1
|
||||
JOIN `user_column_permission` old ON old.user_id = dup.user_id AND old.column_id = src.id;
|
||||
|
||||
-- 2b 重指回源行。
|
||||
UPDATE `user_column_permission` g
|
||||
JOIN `columns` copy ON copy.id = g.column_id AND copy.company_id <> 1
|
||||
JOIN `columns` src ON src.company_id = 1 AND src.column_key = copy.column_key
|
||||
SET g.column_id = src.id;
|
||||
|
||||
-- 2c 闸门:此时绝不允许再有"授权指向非 1 公司的行"。不为 0 就是 2b 漏了行,
|
||||
-- 下一步的 CASCADE 会把它们静默删掉 —— 宁可这里报错停下,也不要少一批菜单而没人知道。
|
||||
CREATE TEMPORARY TABLE `_v149_rb_gate` (`must_be_zero` INT NOT NULL);
|
||||
INSERT INTO `_v149_rb_gate`
|
||||
SELECT IF(COUNT(*) = 0, 0, NULL)
|
||||
FROM (
|
||||
SELECT g.user_id FROM `user_column_permission` g
|
||||
JOIN `columns` c ON c.id = g.column_id
|
||||
WHERE c.company_id <> 1
|
||||
) bad;
|
||||
DROP TEMPORARY TABLE `_v149_rb_gate`;
|
||||
|
||||
-- ---------- 3. 删副本 ----------
|
||||
|
||||
DELETE FROM `columns` WHERE company_id <> 1;
|
||||
|
||||
-- ---------- 4. 换回两条全平台唯一键(副本已删,源行本来就唯一 ⇒ 不会因重复失败) ----------
|
||||
|
||||
SET @db_name = DATABASE();
|
||||
|
||||
SET @idx_exists := (SELECT COUNT(DISTINCT INDEX_NAME) FROM information_schema.STATISTICS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'columns' AND INDEX_NAME = 'uk_column_key');
|
||||
SET @sql := IF(@idx_exists = 0,
|
||||
'ALTER TABLE `columns` ADD UNIQUE KEY `uk_column_key` (`column_key`)',
|
||||
'SELECT 1');
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
|
||||
SET @idx_exists := (SELECT COUNT(DISTINCT INDEX_NAME) FROM information_schema.STATISTICS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'columns' AND INDEX_NAME = 'uk_menu_type_route_path');
|
||||
SET @sql := IF(@idx_exists = 0,
|
||||
'ALTER TABLE `columns` ADD UNIQUE KEY `uk_menu_type_route_path` (`menu_type`, `route_path`)',
|
||||
'SELECT 1');
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
|
||||
-- ---------- 5. 摘掉两条按公司的新键 ----------
|
||||
|
||||
SET @idx_exists := (SELECT COUNT(DISTINCT INDEX_NAME) FROM information_schema.STATISTICS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'columns' AND INDEX_NAME = 'uk_company_column_key');
|
||||
SET @sql := IF(@idx_exists = 1, 'ALTER TABLE `columns` DROP INDEX `uk_company_column_key`', 'SELECT 1');
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
|
||||
SET @idx_exists := (SELECT COUNT(DISTINCT INDEX_NAME) FROM information_schema.STATISTICS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'columns'
|
||||
AND INDEX_NAME = 'uk_company_menu_type_route_path');
|
||||
SET @sql := IF(@idx_exists = 1, 'ALTER TABLE `columns` DROP INDEX `uk_company_menu_type_route_path`', 'SELECT 1');
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
|
||||
-- ---------- 6. 删列 ----------
|
||||
|
||||
SET @col_exists := (SELECT COUNT(*) FROM information_schema.COLUMNS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'columns' AND COLUMN_NAME = 'company_id');
|
||||
SET @sql := IF(@col_exists = 1, 'ALTER TABLE `columns` DROP COLUMN `company_id`', 'SELECT 1');
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
|
||||
-- ---------- 7. 复验(三条读数抄进回滚记录) ----------
|
||||
|
||||
-- 列已删(应 0 行)
|
||||
SELECT 'V149_ROLLBACK_POST company_col' AS marker, COUNT(*) AS col_still_there
|
||||
FROM information_schema.COLUMNS
|
||||
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'columns' AND COLUMN_NAME = 'company_id';
|
||||
|
||||
-- 两条旧键在、两条新键没了(应恰好 4 行且 NON_UNIQUE 全 0)
|
||||
SELECT 'V149_ROLLBACK_POST indexes' AS marker, INDEX_NAME,
|
||||
GROUP_CONCAT(COLUMN_NAME ORDER BY SEQ_IN_INDEX) AS cols, NON_UNIQUE
|
||||
FROM information_schema.STATISTICS
|
||||
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'columns' AND NON_UNIQUE = 0
|
||||
GROUP BY INDEX_NAME, NON_UNIQUE;
|
||||
|
||||
SELECT 'V149_ROLLBACK_POST rows' AS marker, COUNT(*) AS rows_now FROM `columns`;
|
||||
SELECT 'V149_ROLLBACK_POST grants' AS marker, COUNT(*) AS grants_now FROM `user_column_permission`;
|
||||
|
||||
-- ---------- 8. 删 Flyway 历史行(漏掉 = 重装时 V149 被跳过) ----------
|
||||
|
||||
DELETE FROM `flyway_schema_history` WHERE `version` = '149';
|
||||
|
||||
-- ---------- 9. 回滚后的语义,写明别当 bug ----------
|
||||
-- 公司 2 的 2 只账号回到 V149 之前的状态:授权挂在公司 1 的行上,两家共用一棵树。
|
||||
-- 跨公司串扰因此重新发生(这本来就是回滚的代价),而 columns 表回到全平台唯一键。
|
||||
-- 备份表 columns_bak_v149_rollback / user_column_permission_bak_v149_rollback 确认无误后手工 DROP。
|
||||
@@ -1,38 +0,0 @@
|
||||
-- 回滚 V150(人工补丁,不放进 src/main/resources/db/——那里是 Flyway 扫描路径,
|
||||
-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"这件事
|
||||
-- 在没有人工执行的情况下自己发生。)
|
||||
--
|
||||
-- 顺序:停两台应用 → 执行本脚本 → DELETE FROM flyway_schema_history WHERE version='150'
|
||||
-- → 回滚 jar → 起应用。
|
||||
-- 漏掉"删历史行"那步,将来重装带 V150 的 jar 时 Flyway 判定"已应用"直接跳过重建,
|
||||
-- 而 Java 侧实体照常读写 company_id ⇒ 运行期 Unknown column。
|
||||
--
|
||||
-- 【本版本没有唯一键要退】V150 刻意不动 uk_ziniao_token_hash(理由见迁移文件头注释第 4 段:
|
||||
-- 同一个紫鸟令牌在两家公司各存一行会被 ZiniaoApiKeyProvider 按令牌并成一条,白名单状态与代理互相顶掉),
|
||||
-- 所以这里没有 V147 那种"先加旧键后删新键"的第 1 段,也没有 1062 预检。
|
||||
--
|
||||
-- ---------- 0. 预检:这一列上到底有几家公司的行 ----------
|
||||
-- SELECT company_id, COUNT(*) AS rows_per_company
|
||||
-- FROM `biz_shop_key`
|
||||
-- GROUP BY company_id
|
||||
-- ORDER BY company_id;
|
||||
-- -> 只有一行(company_id=1):说明批次上线后没有第 2 家建过密钥,第 1 段 DROP 掉的只是"全 1"这一列,
|
||||
-- 损失可忽略。
|
||||
-- -> 出现 company_id<>1:第 2 家已经在这一列上登记过自己的令牌归属。此时【不要】DROP COLUMN——
|
||||
-- 这张表没有任何账号列,归属删掉就再也分不回去(V150 §2 写明了这个不可逆点)。
|
||||
-- 改走第 2 段"只回滚 jar、保留新列"。
|
||||
--
|
||||
-- ---------- 1. 把列也删掉才解开下面这行(不可逆,先备份) ----------
|
||||
-- ALTER TABLE `biz_shop_key` DROP COLUMN `company_id`;
|
||||
--
|
||||
-- ---------- 2. 默认档:保留新列,只回滚 jar ----------
|
||||
-- 旧 jar 的 ShopKeyEntity 没有 companyId 字段,MyBatis-Plus 的 insert 列清单不含它 ⇒
|
||||
-- 这一列对旧 jar 是惰性的:不读写就不影响,而 DEFAULT 1 正好把旧 jar 插入的行接住。
|
||||
-- 所以真要止损时,这一档比删列安全得多,也是第 0 段查出多家公司时的唯一走法。
|
||||
-- (代价:混合窗口里旧 jar 建的密钥会静默归进第 1 家——这与 V150 上线之前没有任何区别,
|
||||
-- 不是回滚引入的新问题。)
|
||||
--
|
||||
-- ALTER TABLE `biz_shop_key` ALTER COLUMN company_id DROP DEFAULT;
|
||||
-- ↑ 这一句【不属于回滚】。它是"摘 DEFAULT"那笔前向修复的内容(V150 §6)。
|
||||
-- 任何时候都不要写 MODIFY COLUMN ... NOT NULL:重建表会按"当时的列默认值"物化历史行,
|
||||
-- 而 V150 没有写回历史行,历史归属的全部依据就是那个默认值。
|
||||
@@ -1,69 +0,0 @@
|
||||
-- 回滚 V151(人工补丁,不放进 src/main/resources/db/——那里是 Flyway 扫描路径,
|
||||
-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"这件事
|
||||
-- 在没有人工执行的情况下自己发生。)
|
||||
--
|
||||
-- 顺序:停两台应用 → 执行本脚本 → DELETE FROM flyway_schema_history WHERE version='151'
|
||||
-- → 回滚 jar(回到仍按公司筛的那版)→ 起应用。
|
||||
-- 漏掉"删历史行"那步,将来重装带 V151 的 jar 时 Flyway 判定"已应用"直接跳过,两把公司键不再重建,
|
||||
-- 而回滚后的 jar 的读侧谓词是 company_id = X ⇒ 表现为"读得到但写同名值被 IGNORE 掉",不报错。
|
||||
--
|
||||
-- 回滚方向 = 把两把公司键加回来。加回来之前必须先回滚 jar:
|
||||
-- "键按公司、代码不分公司"时,第 2 家能建出与第 1 家同 (company_id 档, 值) 的行——
|
||||
-- 而 V151 之后的 jar 根本不写 company_id,两张表的这一列全由 DEFAULT 1 兜 ⇒ 加回公司键
|
||||
-- 在数据上是安全的(见第 0 段预检),但只有配回滚后的 jar 才有意义。
|
||||
--
|
||||
-- ⚠ 本脚本【不】恢复 company_id 列本身:V151 没有删列(列在 V151 之后仍然带着 DEFAULT 1),
|
||||
-- 所以回滚也不涉及建列。DROP COLUMN 是下一版的事,那一版的回滚要把列与默认值一起加回来,
|
||||
-- 并且必须先确认两张表的历史归属还能不能分清——品牌库能(uploader_user_id 还在),
|
||||
-- 类目表不能(这张表没有任何账号列,V147 §2 已写明事后无法反推)。
|
||||
|
||||
-- ---------- 0. 预检(必须先跑,返回 0 行才允许第 1、2 段) ----------
|
||||
-- SELECT data_value, LEFT(brand, 191) b, COUNT(*) c
|
||||
-- FROM `biz_invalid_asin_data`
|
||||
-- GROUP BY data_value, b
|
||||
-- HAVING COUNT(*) > 1;
|
||||
-- -> 期望 0 行。V151 之后全局键在守,所以这一条应当恒为 0;非 0 说明有人在 V151 与本次回滚
|
||||
-- 之间手工绕过迁移改过索引,先查 flyway_schema_history 再决定。
|
||||
-- SELECT company_id, COUNT(*) c FROM `biz_invalid_asin_data` GROUP BY company_id;
|
||||
-- -> 期望只有一档且值为 1(新 jar 的 INSERT 不带这一列,由 DEFAULT 1 兜)。
|
||||
-- 出现第二档说明有写入显式带过公司值,加回公司键后这些行会从别家的视图里隐身。
|
||||
-- SELECT category_key, COUNT(*) c FROM `biz_product_category` GROUP BY category_key HAVING c > 1;
|
||||
-- -> 期望 0 行(同上,V151 之后由全局键保证)。
|
||||
-- SELECT SUM(is_builtin = 1 AND company_id <> 0) AS bad_builtin FROM `biz_product_category`;
|
||||
-- -> 期望 0。V148 从未上线,内置节点仍挂哨兵 0;非 0 说明有人跑过 V148 的人工版本,
|
||||
-- 回滚后这些内置节点在旧 jar 的 company_id IN (0, X) 谓词下会同时出现在每一家的树上。
|
||||
|
||||
-- ---------- 1. 品牌数据库:先加公司键、后删全局键(中间任一步至少有一个唯一键在守并发) ----------
|
||||
|
||||
ALTER TABLE `biz_invalid_asin_data`
|
||||
ADD UNIQUE KEY `uk_company_value_brand` (`company_id`, `data_value`, `brand`(191)),
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
ALTER TABLE `biz_invalid_asin_data`
|
||||
DROP INDEX `uk_data_value_brand`,
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
|
||||
-- ---------- 2. 商品类目:同一形状 ----------
|
||||
|
||||
ALTER TABLE `biz_product_category`
|
||||
ADD UNIQUE KEY `uk_company_category_key` (`company_id`, `category_key`),
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
ALTER TABLE `biz_product_category`
|
||||
DROP INDEX `uk_product_category_key`,
|
||||
ALGORITHM = INPLACE, LOCK = NONE;
|
||||
|
||||
-- ---------- 3. biz_dedupe_total_data 不在本脚本范围内 ----------
|
||||
-- V151 没有动去重库(它的 uk_company_data_value 一直都在),回滚自然也不动它。
|
||||
|
||||
-- ---------- 4. 验证 ----------
|
||||
-- SELECT TABLE_NAME, INDEX_NAME,
|
||||
-- GROUP_CONCAT(CONCAT(COLUMN_NAME,'@',SEQ_IN_INDEX) ORDER BY SEQ_IN_INDEX) AS cols
|
||||
-- FROM information_schema.STATISTICS
|
||||
-- WHERE TABLE_SCHEMA = DATABASE()
|
||||
-- AND TABLE_NAME IN ('biz_invalid_asin_data','biz_product_category','biz_dedupe_total_data')
|
||||
-- AND NON_UNIQUE = 0
|
||||
-- GROUP BY TABLE_NAME, INDEX_NAME;
|
||||
-- -> 期望回到 V145+V147 之后的形状:
|
||||
-- uk_company_value_brand(company_id@1,data_value@2,brand@3)
|
||||
-- uk_company_category_key(company_id@1,category_key@2)
|
||||
-- uk_company_data_value(company_id@1,data_value@2)
|
||||
-- 加三行 PRIMARY(id);uk_data_value_brand / uk_product_category_key 必须【不】在结果里。
|
||||
@@ -1,36 +0,0 @@
|
||||
-- 回滚 V152(人工补丁,不放进 src/main/resources/db/——那里是 Flyway 扫描路径,
|
||||
-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"这件事
|
||||
-- 在没有人工执行的情况下自己发生。)
|
||||
--
|
||||
-- 触发场景:V152 上线后「摘错了」——出现场外的、省略 company_id 的写入被 1364 打出来。
|
||||
-- 如果只是回滚 jar(代码问题、与默认值无关),【不需要本补丁】:V149/V150 起的 jar 全部
|
||||
-- 显式落列,对默认值在不在毫无感知,V152 保持应用态即可。
|
||||
--
|
||||
-- 顺序:停两台应用 → 执行本脚本 → DELETE FROM flyway_schema_history WHERE version='152'
|
||||
-- → 回滚 jar → 起应用。
|
||||
-- 漏掉"删历史行"那步,将来重装带 V152 的 jar 时 Flyway 判定"已应用"直接跳过,
|
||||
-- 而脚本已经把 DEFAULT 装回去了 ⇒ 库状态与 history 声明的"已摘"长期互相矛盾
|
||||
-- (表现为启动期哨兵对这两张表一直喊 COMPANY_DEFAULT_STILL_PRESENT,而没人知道该不该摘)。
|
||||
--
|
||||
-- 与 rollback-V150 的差别:那里默认档是"保留新列、只回滚 jar"(删列不可逆,留注释由人工解开);
|
||||
-- 本笔只有默认值属性被动过,回滚就是把它装回去——纯元数据、可逆、无损,所以【默认档直接可执行】。
|
||||
--
|
||||
-- 【禁写成 MODIFY COLUMN ... NOT NULL DEFAULT 1】(V144 时代那种写法已废弃):
|
||||
-- MODIFY 会重建表,而这两张表历史行的归属依据就是加列时记录的默认值,重建是没必要的风险。
|
||||
|
||||
-- ---------- 1. 默认档:两列装回 DEFAULT 1(还原到 V152 之前的 schema) ----------
|
||||
-- 用 ALTER COLUMN ... SET DEFAULT 1——纯元数据操作,瞬时完成;重复执行无副作用
|
||||
-- (发布前在 scratch MySQL 8.4.9 上连跑两遍证实)。
|
||||
ALTER TABLE `columns`
|
||||
ALTER COLUMN company_id SET DEFAULT 1;
|
||||
|
||||
ALTER TABLE `biz_shop_key`
|
||||
ALTER COLUMN company_id SET DEFAULT 1;
|
||||
|
||||
-- ---------- 0. 验证(跑完第 1 段后) ----------
|
||||
-- SELECT TABLE_NAME, COLUMN_DEFAULT FROM information_schema.COLUMNS
|
||||
-- WHERE TABLE_SCHEMA = DATABASE() AND COLUMN_NAME = 'company_id'
|
||||
-- AND TABLE_NAME IN ('columns','biz_shop_key');
|
||||
-- -> 期望两行 COLUMN_DEFAULT 均为 1
|
||||
-- SHOW COLUMNS FROM `columns` LIKE 'company_id'; -> Default = 1
|
||||
-- SHOW COLUMNS FROM `biz_shop_key` LIKE 'company_id'; -> Default = 1
|
||||
@@ -1,46 +0,0 @@
|
||||
-- 回滚 V153(人工补丁,不放进 src/main/resources/db/——那里是 Flyway 扫描路径,
|
||||
-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"这件事
|
||||
-- 在没有人工执行的情况下自己发生。)
|
||||
--
|
||||
-- 顺序:停两台应用 → 执行本脚本 → DELETE FROM flyway_schema_history WHERE version='153'
|
||||
-- → 回滚 jar → 起应用。
|
||||
-- 漏掉"删历史行"那步,将来重装带 V153 的 jar 时 Flyway 判定"已应用"直接跳过重建,
|
||||
-- 而 Java 侧实体照常读写 company_id ⇒ 运行期 Unknown column。
|
||||
--
|
||||
-- 【回滚的前提比加迁移重】名字退回"全平台唯一"之前必须先消掉跨公司同名,
|
||||
-- 否则第 1 段末尾那条 ADD UNIQUE KEY 直接 1062 失败,而失败发生在停了两台之后。
|
||||
--
|
||||
-- ---------- 0. 预检:有没有跨公司同名(必须先跑,出任何一行都不能直接回滚) ----------
|
||||
-- SELECT g.`group_name`, COUNT(DISTINCT g.`company_id`) AS companies
|
||||
-- FROM `biz_shop_manage_group` g
|
||||
-- GROUP BY g.`group_name`
|
||||
-- HAVING companies > 1;
|
||||
-- -> 0 行:可以走第 1 段。
|
||||
-- -> 有行:先由业务把重名的分组改名(保留一份),再回来跑第 1 段。这一份脚本【不自动改名】,
|
||||
-- 因为"改哪一个"是业务判断,不是工程判断。
|
||||
--
|
||||
-- 另外单独看一眼 NULL 归属的行(组长账号已删的孤儿分组):
|
||||
-- SELECT `id`, `group_name` FROM `biz_shop_manage_group` WHERE `company_id` IS NULL;
|
||||
-- -> (NULL, name) 在全局键下与任何同名行都冲突,第 1 段会连带把它们一起钉住。
|
||||
-- 这些行本来就在所有公司的列表里不可见,回滚前一并改名或清掉更干净。
|
||||
--
|
||||
-- ---------- 1. 唯一键退回全局(先 ADD 旧键,后 DROP 新键:中间始终有一把在守并发) ----------
|
||||
-- ALTER TABLE `biz_shop_manage_group` ADD UNIQUE KEY `uk_group_name` (`group_name`),
|
||||
-- ALGORITHM = INPLACE, LOCK = NONE;
|
||||
-- ALTER TABLE `biz_shop_manage_group` DROP INDEX `uk_company_group_name`,
|
||||
-- ALGORITHM = INPLACE, LOCK = NONE;
|
||||
--
|
||||
-- ---------- 2. 列【不要删】:它是资产,删了就回不来 ----------
|
||||
-- company_id 存的是"组长账号在哪一家",而账号会被硬删(users 无软删列)——
|
||||
-- 今天删掉这一列,明天那些组长的账号一删,归属就永久无从追溯(这正是 V153 第 1 段
|
||||
-- 拒绝给孤儿行硬塞公司号的同一个理由)。列留着对旧 jar 是惰性的:
|
||||
-- 旧 ShopManageGroupEntity 没有 companyId 字段,MyBatis-Plus 的 insert 列清单不含它,
|
||||
-- 而这一列是 NULL DEFAULT NULL ⇒ 旧 jar 插入的行该列读作 NULL,与新代码
|
||||
-- "推不出归属就报错"的口径一致,不会静默归到某一家。
|
||||
-- ALTER TABLE `biz_shop_manage_group` DROP COLUMN `company_id`; -- 想清楚再解开这行
|
||||
--
|
||||
-- ---------- 3. 只回滚 jar(默认档) ----------
|
||||
-- 保留列与 uk_company_group_name,只把 jar 退回不带 companyId 的版本:
|
||||
-- 旧 jar 建分组时该列一律落成 NULL ⇒ 之后每一行新分组都变成"归属无从追溯",
|
||||
-- 且它们彼此可以重名(NULL 在唯一索引里互不等价)。这个形状能跑,但会把隔离一寸寸磨掉,
|
||||
-- 所以只作为"新代码有缺陷、需要立刻止血"时的临时档,停的时间不能过夜。
|
||||
@@ -1,23 +0,0 @@
|
||||
-- 回滚 V154(人工补丁,不放进 src/main/resources/db/——那是 Flyway 扫描路径,
|
||||
-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"
|
||||
-- 这件事在没有人工执行的情况下自己发生)。
|
||||
--
|
||||
-- 触发场景只有一个:出现了本迁移没预见的、省略 company_id 的写入通道,且它绕过了
|
||||
-- DedupeTotalDataService.requireCompanyAttribution 那道 Java 闸门(表现为 1364,
|
||||
-- 或被 INSERT IGNORE 落成 company_id=0 的行)。
|
||||
-- 仅仅"代码有问题需要回滚 jar"不需要本补丁:带闸门的 jar 全部显式落列,
|
||||
-- 对默认值在不在毫无感知,V154 保持应用态即可。
|
||||
--
|
||||
-- 执行顺序(两台都要,中间不停服会混版):
|
||||
-- 1) 停两台应用(docker stop java-server)
|
||||
-- 2) 在 aiimage 库执行下面的 SET DEFAULT 1(纯元数据、瞬时)
|
||||
-- 3) DELETE FROM flyway_schema_history WHERE version = '154';
|
||||
-- 4) 回滚 jar 到上一版
|
||||
-- 5) 起两台,确认 health=200 且 CompanyDefaultGuard 重新打 COMPANY_DEFAULT_STILL_PRESENT
|
||||
-- (它重新喊才是"回到改前"的证据,不喊说明 DEFAULT 没装回去)
|
||||
-- 6) 复查是否已经产生 company_id=0 的行:
|
||||
-- SELECT COUNT(*) FROM biz_dedupe_total_data WHERE company_id = 0;
|
||||
-- 有的话回滚不解决存量,要单独按 uploader/group 追认归属后再改。
|
||||
|
||||
ALTER TABLE `biz_dedupe_total_data`
|
||||
ALTER COLUMN company_id SET DEFAULT 1;
|
||||
@@ -1,15 +0,0 @@
|
||||
-- 回滚 V155(users.disabled_at)——人工执行,放在 Flyway 扫描路径之外。
|
||||
-- 理由:把回滚也做成版本化迁移,等于让"决定回滚"这件事自己发生(V150/V152/V154 同款处置)。
|
||||
--
|
||||
-- 只在"这列不该加"时才跑。仅仅回滚 jar 不需要它:旧 jar 不认识 disabled_at,留着 NULL 列零影响。
|
||||
--
|
||||
-- 顺序:停两台 java → 跑本文件 → 删 flyway_schema_history 的 version='155' 行 → 回滚 jar → 起 java。
|
||||
--
|
||||
-- ⚠ 跑之前先确认没有非 NULL 的停用行,否则 DROP COLUMN 会把停用记录一起抹掉、事后无从追认:
|
||||
-- SELECT COUNT(*) FROM `users` WHERE `disabled_at` IS NOT NULL; -- 期望 0
|
||||
|
||||
ALTER TABLE `users` DROP COLUMN `disabled_at`;
|
||||
|
||||
-- 复核:
|
||||
-- SHOW COLUMNS FROM `users` LIKE 'disabled_at'; -- 期望 Empty set
|
||||
-- DELETE FROM flyway_schema_history WHERE version = '155';
|
||||
@@ -1,31 +0,0 @@
|
||||
-- 回滚 V156(人工补丁,不放进 src/main/resources/db/——那里是 Flyway 扫描路径,
|
||||
-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"这件事
|
||||
-- 在没有人工执行的情况下自己发生)。
|
||||
--
|
||||
-- 触发场景:V156 把组 33/uid=1188(「先锋」)的 1452 行 company_id 从 1 回填到 3。
|
||||
-- 只有一种情况需要回滚本数据:控制方改判这 1452 行不属于先锋-团队。
|
||||
-- 仅仅"读侧切换的 jar 有问题要回滚"【不需要】动数据——旧读侧按上传账号认公司,
|
||||
-- 对这批 uploader 已删的行本来就不显示(company_id 是 1 还是 3 都看不见),
|
||||
-- 但**去重比对**(39de5035 已按 company_id)会跟着数据走:回滚数据 = 米椿花去重
|
||||
-- 重新吃到这 1452 个先锋 ASIN、先锋丢值,所以数据回滚必须与 jar 回滚同批做,
|
||||
-- 且回滚前先确认"改判"是真的(不是又一次误判归属)。
|
||||
--
|
||||
-- 执行顺序(两台都要,中间不停服会混版):
|
||||
-- 1) 停两台应用(docker stop java-server)
|
||||
-- 2) 在 aiimage 库执行下面的反向 UPDATE
|
||||
-- 3) DELETE FROM flyway_schema_history WHERE version = '156';
|
||||
-- 4) 回滚 jar 到上一版(读侧按上传账号的版本)
|
||||
-- 5) 起两台,确认 health=200
|
||||
-- 6) 复查:
|
||||
-- SELECT company_id, COUNT(*) FROM biz_dedupe_total_data
|
||||
-- WHERE uploader_user_id = 1188 GROUP BY company_id;
|
||||
-- 期望回到一行:1 | 1452。
|
||||
--
|
||||
-- 反向判据与 V156 原文一一对应(uploader_user_id=1188 AND group_id=33),
|
||||
-- company_id=3 限定保证重跑是 no-op;只回滚这一个精确集,不扩大射程。
|
||||
|
||||
UPDATE `biz_dedupe_total_data`
|
||||
SET `company_id` = 1
|
||||
WHERE `uploader_user_id` = 1188
|
||||
AND `group_id` = 33
|
||||
AND `company_id` = 3;
|
||||
@@ -1,79 +0,0 @@
|
||||
# Stale 任务收尾约束(公共心跳模块)
|
||||
|
||||
> 适用范围:所有使用 [TaskHeartbeatService](../src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatService.java) 的 file_task 模块
|
||||
> (PRODUCT_RISK_RESOLVE / PRICE_TRACK / SHOP_MATCH / PATROL_DELETE / QUERY_ASIN /
|
||||
> APPEARANCE_PATENT / SIMILAR_ASIN / DELETE_BRAND)。
|
||||
|
||||
## 历史故障(2026-06-08)
|
||||
|
||||
SIMILAR_ASIN taskId=13102 的 file_job 长期持有 RUNNING 等待 Python 凑齐
|
||||
batchSize 行再发 Coze。Python 端 13:20 异常掉线,但任务到下午 16 点仍卡在 12% 不前进,
|
||||
30 分钟兜底失效。
|
||||
|
||||
链路:
|
||||
|
||||
1. [resetStuckJobs](../src/main/java/com/nanri/aiimage/modules/task/service/TaskResultFileJobWorker.java)
|
||||
每 60 秒扫一次,把 RUNNING 超 30 分钟的 file_job 改回 PENDING。
|
||||
2. worker 立刻把它捞起来重跑 `processResultFileJob`。
|
||||
3. 重跑分支命中 "等 Python 上传更多 row" → 调用 `touchJavaSideTaskActivity`,
|
||||
把 `file_task.updated_at` 刷成 now。
|
||||
4. `finalizeStaleTasks` 用 `lt(updated_at, threshold)` 预过滤,于是这个任务
|
||||
永远进不到候选集,Redis 心跳判定那一步根本走不到。
|
||||
|
||||
→ Python 已断线 N 小时,任务仍在循环,永不收尾。
|
||||
|
||||
## 约束
|
||||
|
||||
### 1. stale-finalize 必须以 Redis 心跳为主信号
|
||||
|
||||
`TaskCacheService.touchTaskHeartbeat` 写的 Redis key 仅在 **Python 真实活动**
|
||||
(心跳接口、上传 result chunk、提交 row)时刷新。Java 内部循环不应触碰它。
|
||||
|
||||
stale 判定时应:
|
||||
|
||||
- 以 Redis heartbeat 为主信号;
|
||||
- 仅在 Redis 不可用 / 缺失时回落到 `file_task.updated_at`;
|
||||
- 不要再用 `lt(file_task.updated_at, threshold)` 做预过滤
|
||||
(除非该模块 100% 不存在长期 RUNNING 等待循环)。
|
||||
|
||||
参考实现:[SimilarAsinTaskService.finalizeStaleTasks / isHeartbeatStale](../src/main/java/com/nanri/aiimage/modules/similarasin/service/SimilarAsinTaskService.java)
|
||||
和 [AppearancePatentTaskService](../src/main/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentTaskService.java) 中 P1-7 注释段。
|
||||
|
||||
### 2. 不要在"等 Python"分支刷 file_task.updated_at
|
||||
|
||||
如果模块的 file_job 会持有 RUNNING 状态等待外部上传更多数据,
|
||||
**这条等待路径上不允许调 `setUpdatedAt(now)` 类方法**。
|
||||
|
||||
否则会触发 [resetStuckJobs](../src/main/java/com/nanri/aiimage/modules/task/service/TaskResultFileJobWorker.java)
|
||||
→ 重跑 → 续命 → 再 reset 的死循环。
|
||||
|
||||
如必须刷 `updated_at` 推动其他逻辑,应迁移到独立字段(例如
|
||||
`file_job.updated_at`、Redis pendingScope 字段),与 stale 判定信号解耦。
|
||||
|
||||
### 3. 新增/修改 stale-finalize 流程的 PR 检查清单
|
||||
|
||||
- [ ] stale 判定的主信号是 Redis 心跳(不是 `file_task.updated_at`)
|
||||
- [ ] 列出该模块所有刷 `file_task.updated_at` 的代码位置,
|
||||
其中没有任何一处会被 `processResultFileJob` 在"等 Python"分支重复触发
|
||||
- [ ] 如果 file_job 会持有长 RUNNING(pull-style 工作流),明确写明 stuck-reset
|
||||
重跑后的幂等行为(不会续命 updated_at)
|
||||
- [ ] 给 finalize 路径补一个 debug 接口(参考
|
||||
[DebugTaskRecoveryController](../src/main/java/com/nanri/aiimage/modules/debug/controller/DebugTaskRecoveryController.java)),
|
||||
绕过过滤直接对单 task 强制收尾,便于线上应急
|
||||
|
||||
## 当前各模块状态(2026-06-08 复核)
|
||||
|
||||
| 模块 | stale 入口 | 是否曾出现自我续命 | 是否需要改 |
|
||||
|---|---|---|---|
|
||||
| SIMILAR_ASIN | `SimilarAsinTaskService.finalizeStaleTasks` | 是(已修) | 已切 Redis-first |
|
||||
| APPEARANCE_PATENT | `AppearancePatentTaskService.finalizeStaleTasks` | 是(已修) | 已切 Redis-first |
|
||||
| PRODUCT_RISK_RESOLVE | `DeleteBrandStaleTaskService.failStaleProductRiskResolveTasks` | 否 | 当前不需要 |
|
||||
| PRICE_TRACK | `DeleteBrandStaleTaskService.failStalePriceTrackTasks` | 否 | 当前不需要 |
|
||||
| SHOP_MATCH | `DeleteBrandStaleTaskService.failStaleShopMatchTasks` | 否 | 当前不需要 |
|
||||
| PATROL_DELETE | `DeleteBrandStaleTaskService.failStalePatrolDeleteTasks` | 否 | 当前不需要 |
|
||||
| QUERY_ASIN | `DeleteBrandStaleTaskService.failStaleQueryAsinTasks` | 否 | 当前不需要 |
|
||||
| DELETE_BRAND | `DeleteBrandStaleTaskService.failStaleDeleteBrandTasks` | 否 | 当前不需要 |
|
||||
| BRAND | `BrandTaskService.failStaleRunningTasks`(独立心跳源) | 否 | 当前不需要 |
|
||||
|
||||
下次新增"等 row 凑批" / "pull-style 长 RUNNING file_job"型功能时,
|
||||
请先读本约束。
|
||||
@@ -1,28 +0,0 @@
|
||||
# 单次提交事务段耗时基线(task-138)
|
||||
|
||||
> 本文档由 `TxDurationBenchmarkTest` 断言存在与内容,用于冻结「Python 结果提交」单次调用的
|
||||
> 耗时上界,防止提交路径劣化。**不要删除**,劣化时更新数值并说明原因。
|
||||
|
||||
## 测量对象
|
||||
|
||||
`SimilarAsinTaskService.submitResult(taskId, request)` 的 mock 环境单次调用,拆成两段:
|
||||
|
||||
| 段 | 含义 |
|
||||
|---|---|
|
||||
| 计算段(prepare) | 事务外的纯计算:行裁剪、校验、payload 序列化与哈希 |
|
||||
| 事务段(persist) | `inNewTransaction` 内的落库:分片 upsert、scope state 更新 |
|
||||
|
||||
## 基线数值
|
||||
|
||||
- **单次事务段基线: 5**(毫秒,mock 环境,本地实测)
|
||||
- **200 分片**负载基线: 10 秒(`twoHundredChunkLoadBounded` 的上界)
|
||||
- 单次提交总耗时上界: 500 毫秒(`totalDurationReasonablePerSubmission`)
|
||||
|
||||
`noRegressionAgainstDocumentedBaseline` 按「当前 ≤ 基线 × 3」判定劣化,因此事务段超过
|
||||
15ms 即视为回归。
|
||||
|
||||
## 说明
|
||||
|
||||
- 该基线取的是 mock 环境(Mapper 全部打桩)而非真实 MySQL 的耗时,用于**相对劣化**而非绝对性能。
|
||||
- 真实环境的事务段耗时会显著高于此值,本基线不适用于容量规划。
|
||||
- 测量机器与 JDK 变更后如需调整,请同步更新本文件数值。
|
||||
@@ -1,93 +0,0 @@
|
||||
"""task-166 HTTP 客户端契约盘点测试。
|
||||
|
||||
对应 plan 10 任务 166 的 8 条用例:
|
||||
1. test_contract_table_all_clients 全客户端覆盖
|
||||
2. test_timeouts_listed 超时现状
|
||||
3. test_retry_listed 重试现状
|
||||
4. test_idempotency_listed 幂等性标注
|
||||
5. test_jdk_limits_noted 平台限制
|
||||
6. test_doc_committed 文档存在
|
||||
7. test_no_code_change 零代码变更
|
||||
8. test_repeatable 可复查
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import subprocess
|
||||
import unittest
|
||||
|
||||
from http_client_audit import (
|
||||
REPO_ROOT,
|
||||
extract_client_sites,
|
||||
extract_timeout_configs,
|
||||
scan,
|
||||
)
|
||||
|
||||
DOC_PATH = REPO_ROOT / "docs" / "http-client-contract-audit.md"
|
||||
|
||||
|
||||
class HttpClientAuditTest(unittest.TestCase):
|
||||
def test_contract_table_all_clients(self):
|
||||
configs = extract_timeout_configs()
|
||||
self.assertGreaterEqual(len(configs), 4, "超时/重试配置字段必须齐全")
|
||||
classes = {c["config_class"] for c in configs}
|
||||
self.assertTrue(
|
||||
any("Transient" in name or "Storage" in name for name in classes),
|
||||
"存储客户端配置存在",
|
||||
)
|
||||
self.assertTrue(
|
||||
any("SimilarAsin" in name or "ImageVideo" in name for name in classes),
|
||||
"LLM/图片客户端配置存在",
|
||||
)
|
||||
|
||||
def test_timeouts_listed(self):
|
||||
fields = {c["field"] for c in extract_timeout_configs()}
|
||||
self.assertTrue(any("connectTimeout" in f for f in fields), "connect 超时缺失")
|
||||
self.assertTrue(any("readTimeout" in f for f in fields), "read 超时缺失")
|
||||
self.assertTrue(any("writeTimeout" in f for f in fields), "write 超时缺失")
|
||||
self.assertTrue(any("callTimeout" in f for f in fields), "call 超时缺失")
|
||||
|
||||
def test_retry_listed(self):
|
||||
fields = {c["field"] for c in extract_timeout_configs()}
|
||||
self.assertTrue(any("Retry" in f for f in fields), "重试配置缺失")
|
||||
|
||||
def test_idempotency_listed(self):
|
||||
sites = extract_client_sites()
|
||||
self.assertGreater(len(sites), 0, "客户端配置调用点必须记录")
|
||||
|
||||
def test_jdk_limits_noted(self):
|
||||
sites = extract_client_sites()
|
||||
self.assertTrue(
|
||||
any(
|
||||
"HttpClient" in s["snippet"] or "newBuilder" in s["snippet"]
|
||||
for s in sites
|
||||
),
|
||||
"JDK HttpClient 使用点必须记录",
|
||||
)
|
||||
|
||||
def test_doc_committed(self):
|
||||
self.assertTrue(DOC_PATH.is_file(), f"契约表文档缺失: {DOC_PATH}")
|
||||
text = DOC_PATH.read_text(encoding="utf-8")
|
||||
self.assertIn("超时", text)
|
||||
self.assertIn("重试", text)
|
||||
self.assertIn("幂等", text)
|
||||
|
||||
def test_no_code_change(self):
|
||||
changed = subprocess.run(
|
||||
["git", "diff", "--name-only", "HEAD", "--", "backend-java/src"],
|
||||
cwd=REPO_ROOT,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
check=True,
|
||||
).stdout.strip()
|
||||
self.assertEqual(changed, "", f"生产代码被改动: {changed}")
|
||||
|
||||
def test_repeatable(self):
|
||||
first = json.dumps(scan().to_dict(), sort_keys=True)
|
||||
second = json.dumps(scan().to_dict(), sort_keys=True)
|
||||
self.assertEqual(first, second, "盘点可复查")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
@@ -1,199 +0,0 @@
|
||||
"""task-121 N+1 扫描审计测试。
|
||||
|
||||
对应 plan 06 任务 121 的 8 条用例 + 2 条补强:
|
||||
1. test_scan_select_in_loop 识别循环内单查
|
||||
2. test_scan_output_listed 清单产出(位置/对象/影响字段齐全)
|
||||
3. test_scan_priority 按影响排序
|
||||
4. test_scan_module_coverage 覆盖主要模块(真实代码扫描)
|
||||
5. test_scan_false_positive_checked 排除误报(已批量/循环外)
|
||||
6. test_scan_repeatable 可重复(同输入同输出)
|
||||
7. test_scan_documented 审计文档产出
|
||||
8. test_scan_no_edit 本任务不改生产代码
|
||||
9. test_scan_lambda_brace_less 无花括号 lambda 内单查识别
|
||||
10. test_scan_iterating_query_result 遍历查询结果集判 HIGH
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import subprocess
|
||||
import unittest
|
||||
from pathlib import Path
|
||||
|
||||
from n1_scan import (
|
||||
HIGH,
|
||||
LOW,
|
||||
MEDIUM,
|
||||
MODULES_ROOT,
|
||||
scan_modules,
|
||||
scan_text,
|
||||
)
|
||||
|
||||
SCRIPTS_DIR = Path(__file__).resolve().parent
|
||||
REPO_ROOT = SCRIPTS_DIR.parent.parent
|
||||
DOC_PATH = REPO_ROOT / "backend-java" / "docs" / "n1-scan-audit.md"
|
||||
|
||||
FIXTURE_LOOP = """package com.example;
|
||||
public class DemoService {
|
||||
public void batchByIds(List<Long> ids) {
|
||||
for (Long id : ids) {
|
||||
FileTaskEntity task = fileTaskMapper.selectById(id);
|
||||
}
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_QUERY_RESULT_LOOP = """package com.example;
|
||||
public class DemoService {
|
||||
public List<Vo> listVos() {
|
||||
List<FileTaskEntity> tasks = fileTaskMapper.selectList(new LambdaQueryWrapper<>());
|
||||
List<Vo> vos = new ArrayList<>();
|
||||
for (FileTaskEntity t : tasks) {
|
||||
FileResultEntity r = fileResultMapper.selectById(t.getResultId());
|
||||
vos.add(toVo(r));
|
||||
}
|
||||
return vos;
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_LAMBDA_BRACELESS = """package com.example;
|
||||
public class DemoService {
|
||||
public void touch(List<Long> ids) {
|
||||
ids.forEach(id -> fileTaskMapper.selectOne(
|
||||
new LambdaQueryWrapper<FileTaskEntity>().eq(FileTaskEntity::getId, id)));
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_BATCH_SAFE = """package com.example;
|
||||
public class DemoService {
|
||||
public List<FileTaskEntity> load(List<Long> ids) {
|
||||
List<FileTaskEntity> tasks = new ArrayList<>();
|
||||
for (Long id : ids) {
|
||||
tasks.addAll(fileTaskMapper.selectBatchIds(Collections.singleton(id)));
|
||||
}
|
||||
for (Long id : ids) {
|
||||
tasks.addAll(fileTaskMapper.selectByIds(Collections.singleton(id)));
|
||||
}
|
||||
return tasks;
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_NO_LOOP = """package com.example;
|
||||
public class DemoService {
|
||||
public FileTaskEntity one(Long id) {
|
||||
return fileTaskMapper.selectById(id);
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_LOOP_NO_QUERY = """package com.example;
|
||||
public class DemoService {
|
||||
public int sum(List<Integer> nums) {
|
||||
int s = 0;
|
||||
for (Integer n : nums) {
|
||||
s += n;
|
||||
}
|
||||
return s;
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_INDEX_LOOP = """package com.example;
|
||||
public class DemoService {
|
||||
public List<Vo> listVos(List<Long> ids) {
|
||||
List<Vo> vos = new ArrayList<>();
|
||||
for (int i = 0; i < ids.size(); i++) {
|
||||
FileTaskEntity t = fileTaskMapper.selectById(ids.get(i));
|
||||
vos.add(toVo(t));
|
||||
}
|
||||
return vos;
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_MIXED = (
|
||||
FIXTURE_QUERY_RESULT_LOOP
|
||||
+ "\n"
|
||||
+ FIXTURE_LAMBDA_BRACELESS
|
||||
+ "\n"
|
||||
+ FIXTURE_INDEX_LOOP
|
||||
)
|
||||
|
||||
|
||||
class ScanDetectTest(unittest.TestCase):
|
||||
def test_scan_select_in_loop(self):
|
||||
findings = scan_text(FIXTURE_LOOP, "DemoService.java")
|
||||
self.assertEqual(len(findings), 1)
|
||||
self.assertIn("selectById", findings[0]["statement"])
|
||||
self.assertEqual(findings[0]["loop_type"], "for")
|
||||
self.assertEqual(findings[0]["line"], 5)
|
||||
|
||||
def test_scan_output_listed(self):
|
||||
for finding in scan_text(FIXTURE_MIXED, "DemoService.java"):
|
||||
for key in ("file", "line", "statement", "loop_type", "impact"):
|
||||
self.assertIn(key, finding)
|
||||
self.assertTrue(finding[key] is not None and finding[key] != "")
|
||||
|
||||
def test_scan_priority(self):
|
||||
findings = scan_text(FIXTURE_MIXED, "DemoService.java")
|
||||
order = {HIGH: 0, MEDIUM: 1, LOW: 2}
|
||||
impacts = [order[f["impact"]] for f in findings]
|
||||
self.assertEqual(impacts, sorted(impacts))
|
||||
|
||||
def test_scan_false_positive_checked(self):
|
||||
self.assertEqual(len(scan_text(FIXTURE_BATCH_SAFE, "Batch.java")), 0)
|
||||
self.assertEqual(len(scan_text(FIXTURE_NO_LOOP, "NoLoop.java")), 0)
|
||||
self.assertEqual(len(scan_text(FIXTURE_LOOP_NO_QUERY, "NoQuery.java")), 0)
|
||||
|
||||
def test_scan_repeatable(self):
|
||||
first = scan_text(FIXTURE_MIXED, "DemoService.java")
|
||||
second = scan_text(FIXTURE_MIXED, "DemoService.java")
|
||||
self.assertEqual(
|
||||
json.dumps(first, sort_keys=True), json.dumps(second, sort_keys=True)
|
||||
)
|
||||
|
||||
def test_scan_lambda_brace_less(self):
|
||||
findings = scan_text(FIXTURE_LAMBDA_BRACELESS, "DemoService.java")
|
||||
self.assertEqual(len(findings), 1)
|
||||
self.assertEqual(findings[0]["loop_type"], "forEach")
|
||||
self.assertEqual(findings[0]["impact"], MEDIUM)
|
||||
|
||||
def test_scan_iterating_query_result(self):
|
||||
findings = scan_text(FIXTURE_QUERY_RESULT_LOOP, "DemoService.java")
|
||||
self.assertEqual(len(findings), 1)
|
||||
self.assertEqual(findings[0]["impact"], HIGH)
|
||||
|
||||
|
||||
class ScanCoverageTest(unittest.TestCase):
|
||||
def test_scan_module_coverage(self):
|
||||
report = scan_modules(MODULES_ROOT)
|
||||
self.assertGreaterEqual(report.scanned_files, 600)
|
||||
self.assertGreater(len(report.findings), 0)
|
||||
modules = {f["module"] for f in report.findings}
|
||||
self.assertGreaterEqual(len(modules), 3)
|
||||
order = {HIGH: 0, MEDIUM: 1, LOW: 2}
|
||||
impacts = [order[f["impact"]] for f in report.findings]
|
||||
self.assertEqual(impacts, sorted(impacts))
|
||||
|
||||
def test_scan_documented(self):
|
||||
self.assertTrue(DOC_PATH.is_file(), f"audit doc missing: {DOC_PATH}")
|
||||
text = DOC_PATH.read_text(encoding="utf-8")
|
||||
self.assertIn("N+1", text)
|
||||
self.assertIn("影响", text)
|
||||
|
||||
def test_scan_no_edit(self):
|
||||
changed = subprocess.run(
|
||||
["git", "diff", "--name-only", "HEAD", "--", "backend-java/src"],
|
||||
cwd=REPO_ROOT,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
check=True,
|
||||
).stdout.strip()
|
||||
self.assertEqual(changed, "", f"生产代码被改动: {changed}")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
@@ -1,89 +0,0 @@
|
||||
"""task-148 临时目录配置盘点测试。
|
||||
|
||||
对应 plan 09 任务 148 的 8 条用例:
|
||||
1. test_config_listed 配置项清单齐全
|
||||
2. test_temp_root_defined 临时根目录定义
|
||||
3. test_retention_period 保留期定义
|
||||
4. test_payload_prefixes payload 前缀
|
||||
5. test_upload_dir 上传目录
|
||||
6. test_existing_cleanup_noted 现有清理逻辑记录
|
||||
7. test_doc_committed 文档存在
|
||||
8. test_no_code_change 零代码变更
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import subprocess
|
||||
import unittest
|
||||
|
||||
from temp_config_audit import REPO_ROOT, extract_cleanup_calls, extract_configs, scan
|
||||
|
||||
DOC_PATH = REPO_ROOT / "docs" / "temp-file-config-audit.md"
|
||||
|
||||
|
||||
class TempConfigAuditTest(unittest.TestCase):
|
||||
def test_config_listed(self):
|
||||
configs = extract_configs()
|
||||
self.assertGreaterEqual(len(configs), 8, "配置项清单必须齐全")
|
||||
for item in configs:
|
||||
for key in ("key", "value", "line", "source"):
|
||||
self.assertIn(key, item)
|
||||
|
||||
def test_temp_root_defined(self):
|
||||
keys = {c["key"] for c in extract_configs()}
|
||||
self.assertTrue(
|
||||
any("local-temp-dir" in k for k in keys),
|
||||
f"临时根目录配置缺失: {sorted(keys)}",
|
||||
)
|
||||
|
||||
def test_retention_period(self):
|
||||
keys = {c["key"] for c in extract_configs()}
|
||||
self.assertTrue(any("retention" in k for k in keys), "保留期配置缺失")
|
||||
|
||||
def test_payload_prefixes(self):
|
||||
keys = {c["key"] for c in extract_configs()}
|
||||
self.assertTrue(
|
||||
any("transient-payload" in k for k in keys), "transient payload 配置缺失"
|
||||
)
|
||||
|
||||
def test_upload_dir(self):
|
||||
configs = extract_configs()
|
||||
self.assertTrue(
|
||||
any(
|
||||
"upload" in c["key"].lower() or "tmp" in c["key"].lower()
|
||||
for c in configs
|
||||
),
|
||||
"上传/临时目录配置缺失",
|
||||
)
|
||||
|
||||
def test_existing_cleanup_noted(self):
|
||||
calls = extract_cleanup_calls()
|
||||
self.assertGreater(len(calls), 0, "必须记录既有清理调用点")
|
||||
files = {c["file"] for c in calls}
|
||||
self.assertGreaterEqual(len(files), 3, "清理调用应覆盖多个文件")
|
||||
|
||||
def test_doc_committed(self):
|
||||
self.assertTrue(DOC_PATH.is_file(), f"盘点文档缺失: {DOC_PATH}")
|
||||
text = DOC_PATH.read_text(encoding="utf-8")
|
||||
self.assertIn("临时", text)
|
||||
self.assertIn("保留期", text)
|
||||
|
||||
def test_no_code_change(self):
|
||||
changed = subprocess.run(
|
||||
["git", "diff", "--name-only", "HEAD", "--", "backend-java/src"],
|
||||
cwd=REPO_ROOT,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
check=True,
|
||||
).stdout.strip()
|
||||
self.assertEqual(changed, "", f"生产代码被改动: {changed}")
|
||||
|
||||
def test_scan_repeatable(self):
|
||||
first = json.dumps(scan().to_dict(), sort_keys=True)
|
||||
second = json.dumps(scan().to_dict(), sort_keys=True)
|
||||
self.assertEqual(first, second, "盘点结果可重复")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
@@ -1,204 +0,0 @@
|
||||
"""task-124 @Transactional 方法审计清单测试。
|
||||
|
||||
对应 plan 07 任务 124 的 8 条用例 + 2 条补强:
|
||||
1. test_audit_covers_all_modules 覆盖全部业务模块
|
||||
2. test_audit_classification 分类完整(必须/可移出)
|
||||
3. test_audit_result_endpoints /result 相关方法都在清单
|
||||
4. test_audit_python_facing Python 回调相关标记
|
||||
5. test_audit_priority_order 按收益排序
|
||||
6. test_audit_no_code_change 本任务零代码变更
|
||||
7. test_audit_documented 文档产出
|
||||
8. test_audit_repeatable 可重复执行
|
||||
9. test_audit_detects_tx_method 识别 @Transactional 方法
|
||||
10. test_audit_classifies_movable 事务内可移出段分类
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import subprocess
|
||||
import unittest
|
||||
from pathlib import Path
|
||||
|
||||
from tx_audit import MODULES_ROOT, scan_modules, scan_text
|
||||
|
||||
SCRIPTS_DIR = Path(__file__).resolve().parent
|
||||
REPO_ROOT = SCRIPTS_DIR.parent.parent
|
||||
DOC_PATH = REPO_ROOT / "backend-java" / "docs" / "transaction-boundary-audit.md"
|
||||
|
||||
FIXTURE_TX = """package com.example;
|
||||
@Service
|
||||
public class DemoService {
|
||||
@Transactional
|
||||
public boolean submitResult(Long taskId, List<RowVo> rows) {
|
||||
List<ItemVo> items = rows.stream()
|
||||
.map(row -> toVo(row))
|
||||
.collect(Collectors.toList());
|
||||
int updated = fileResultMapper.update(null, new LambdaUpdateWrapper<FileResultEntity>()
|
||||
.eq(FileResultEntity::getId, taskId)
|
||||
.set(FileResultEntity::getStatus, "SUCCESS"));
|
||||
log.info("submitted taskId={} count={}", taskId, items.size());
|
||||
Files.deleteIfExists(Path.of("/tmp/task-" + taskId));
|
||||
return updated > 0;
|
||||
}
|
||||
|
||||
public void noTxMethod(Long id) {
|
||||
fileTaskMapper.selectById(id);
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_WRITE_ONLY = """package com.example;
|
||||
@Service
|
||||
public class DemoService {
|
||||
@Transactional
|
||||
public int markFailed(Long id) {
|
||||
return fileTaskMapper.update(null, new LambdaUpdateWrapper<FileTaskEntity>()
|
||||
.eq(FileTaskEntity::getId, id)
|
||||
.set(FileTaskEntity::getStatus, "FAILED"));
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_LOCK = """package com.example;
|
||||
@Service
|
||||
public class DemoService {
|
||||
@Transactional
|
||||
public void finalizeTask(Long taskId) {
|
||||
TaskDistributedLockService.LockHandle handle = acquireTaskLock("MODULE", taskId);
|
||||
if (handle == null) {
|
||||
return;
|
||||
}
|
||||
try (handle) {
|
||||
taskMapper.update(null, new LambdaUpdateWrapper<TaskFileEntity>()
|
||||
.eq(TaskFileEntity::getId, taskId));
|
||||
}
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
FIXTURE_PLAIN = """package com.example;
|
||||
@Service
|
||||
public class DemoService {
|
||||
public int sum(List<Integer> nums) {
|
||||
return nums.stream().mapToInt(Integer::intValue).sum();
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
|
||||
class TxAuditDetectTest(unittest.TestCase):
|
||||
def test_audit_detects_tx_method(self):
|
||||
findings = scan_text(FIXTURE_TX, "DemoService.java")
|
||||
self.assertEqual(len(findings), 1)
|
||||
self.assertEqual(findings[0]["method"], "submitResult")
|
||||
self.assertFalse(findings[0]["class_level"])
|
||||
|
||||
def test_audit_classifies_movable(self):
|
||||
findings = scan_text(FIXTURE_TX, "DemoService.java")
|
||||
self.assertEqual(len(findings), 1)
|
||||
movable = findings[0]["movable"]
|
||||
self.assertIn("compute", movable)
|
||||
self.assertIn("assembly", movable)
|
||||
self.assertIn("log", movable)
|
||||
self.assertIn("cleanup", movable)
|
||||
self.assertIn("write", findings[0]["must_stay"])
|
||||
self.assertGreater(findings[0]["priority"], 0)
|
||||
|
||||
def test_audit_no_tx_not_reported(self):
|
||||
self.assertEqual(len(scan_text(FIXTURE_PLAIN, "Plain.java")), 0)
|
||||
|
||||
def test_audit_write_only_no_movable(self):
|
||||
findings = scan_text(FIXTURE_WRITE_ONLY, "DemoService.java")
|
||||
self.assertEqual(len(findings), 1)
|
||||
self.assertIn("write", findings[0]["must_stay"])
|
||||
self.assertEqual(findings[0]["movable"], [])
|
||||
|
||||
def test_audit_lock_flagged_must_stay(self):
|
||||
findings = scan_text(FIXTURE_LOCK, "DemoService.java")
|
||||
self.assertEqual(len(findings), 1)
|
||||
self.assertIn("lock", findings[0]["must_stay"])
|
||||
|
||||
|
||||
class TxAuditCoverageTest(unittest.TestCase):
|
||||
def test_audit_covers_all_modules(self):
|
||||
report = scan_modules(MODULES_ROOT)
|
||||
self.assertGreaterEqual(report.scanned_files, 600)
|
||||
self.assertGreater(len(report.findings), 50)
|
||||
modules = {f["module"] for f in report.findings}
|
||||
self.assertGreaterEqual(len(modules), 15)
|
||||
|
||||
def test_audit_classification(self):
|
||||
for finding in scan_modules(MODULES_ROOT).findings:
|
||||
self.assertIn("must_stay", finding)
|
||||
self.assertIn("movable", finding)
|
||||
self.assertIsInstance(finding["must_stay"], list)
|
||||
self.assertIsInstance(finding["movable"], list)
|
||||
|
||||
def test_audit_result_endpoints(self):
|
||||
report = scan_modules(MODULES_ROOT)
|
||||
result_methods = [
|
||||
f
|
||||
for f in report.findings
|
||||
if "result" in f["method"].lower() or "submit" in f["method"].lower()
|
||||
]
|
||||
self.assertGreater(
|
||||
len(result_methods), 0, "应找到 /result 相关 @Transactional 方法"
|
||||
)
|
||||
modules_with_result = {f["module"] for f in result_methods}
|
||||
self.assertGreaterEqual(len(modules_with_result), 3)
|
||||
|
||||
def test_audit_python_facing(self):
|
||||
report = scan_modules(MODULES_ROOT)
|
||||
flagged = [f for f in report.findings if f["python_facing"]]
|
||||
self.assertGreater(len(flagged), 0, "应标记 Python 回调相关方法")
|
||||
for f in flagged:
|
||||
name = f["method"].lower()
|
||||
self.assertTrue(
|
||||
any(
|
||||
k in name
|
||||
for k in (
|
||||
"result",
|
||||
"submit",
|
||||
"upload",
|
||||
"chunk",
|
||||
"done",
|
||||
"ack",
|
||||
"report",
|
||||
)
|
||||
),
|
||||
f"python_facing 标记与命名不符: {f['method']}",
|
||||
)
|
||||
|
||||
def test_audit_priority_order(self):
|
||||
findings = scan_modules(MODULES_ROOT).findings
|
||||
priorities = [f["priority"] for f in findings]
|
||||
self.assertEqual(priorities, sorted(priorities, reverse=True))
|
||||
|
||||
def test_audit_repeatable(self):
|
||||
first = scan_modules(MODULES_ROOT).to_dict()
|
||||
second = scan_modules(MODULES_ROOT).to_dict()
|
||||
self.assertEqual(
|
||||
json.dumps(first, sort_keys=True), json.dumps(second, sort_keys=True)
|
||||
)
|
||||
|
||||
def test_audit_documented(self):
|
||||
self.assertTrue(DOC_PATH.is_file(), f"audit doc missing: {DOC_PATH}")
|
||||
text = DOC_PATH.read_text(encoding="utf-8")
|
||||
self.assertIn("事务", text)
|
||||
self.assertIn("必须", text)
|
||||
self.assertIn("可移出", text)
|
||||
|
||||
def test_audit_no_code_change(self):
|
||||
changed = subprocess.run(
|
||||
["git", "diff", "--name-only", "HEAD", "--", "backend-java/src"],
|
||||
cwd=REPO_ROOT,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
check=True,
|
||||
).stdout.strip()
|
||||
self.assertEqual(changed, "", f"生产代码被改动: {changed}")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
-121
@@ -1,121 +0,0 @@
|
||||
package com.nanri.aiimage.config;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
import java.nio.file.Paths;
|
||||
import java.util.List;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
|
||||
/**
|
||||
* 架构文档 §6 现状描述核对(任务 56,验证型)。
|
||||
* 断言 java-architecture-optimization-plan.md §6 已反映本轮实现现状:
|
||||
* multipart 直通、1MB 阈值、过滤器日志不读 body、未做项标注、spec 引用、
|
||||
* 与 00-overview 实施记录一致、无过时默认值/占位符残留。
|
||||
*/
|
||||
class ArchitecturePlanSection6DocTest {
|
||||
|
||||
private static final Path DOC = Paths.get("src", "main", "resources", "..", "..", "..",
|
||||
"docs", "java-architecture-optimization-plan.md").normalize();
|
||||
private static final Path OVERVIEW = Paths.get("src", "main", "resources", "..", "..", "..",
|
||||
"docs", "plans", "00-plan-overview.md").normalize();
|
||||
|
||||
private static String read(Path path) throws IOException {
|
||||
return new String(Files.readAllBytes(path), StandardCharsets.UTF_8);
|
||||
}
|
||||
|
||||
private static String section6() throws IOException {
|
||||
String doc = read(DOC);
|
||||
int start = doc.indexOf("## 6. ");
|
||||
int end = doc.indexOf("## 7. ", start);
|
||||
assertTrue(start >= 0, "文档存在 §6 章节");
|
||||
return end > start ? doc.substring(start, end) : doc.substring(start);
|
||||
}
|
||||
|
||||
private static List<String> section6Lines() throws IOException {
|
||||
return List.of(section6().split("\r?\n"));
|
||||
}
|
||||
|
||||
private static int docLineNumberOf(String section, String needle) {
|
||||
List<String> lines = List.of(section.split("\r?\n"));
|
||||
for (int i = 0; i < lines.size(); i++) {
|
||||
if (lines.get(i).contains(needle)) {
|
||||
return i + 1;
|
||||
}
|
||||
}
|
||||
return -1;
|
||||
}
|
||||
|
||||
@Test
|
||||
void noObsoleteDefaultRemains() throws IOException {
|
||||
for (String line : section6Lines()) {
|
||||
assertFalse(line.contains("104857600"), "§6 无过时默认值 104857600 残留:" + line);
|
||||
}
|
||||
}
|
||||
|
||||
@Test
|
||||
void multipartPassthroughStated() throws IOException {
|
||||
String section = section6();
|
||||
assertTrue(section.contains("multipart"), "§6 记录 multipart 处理");
|
||||
assertTrue(section.contains("直通") || section.contains("跳过缓存"),
|
||||
"§6 记录 multipart 直通现状");
|
||||
}
|
||||
|
||||
@Test
|
||||
void threshold1MbStated() throws IOException {
|
||||
String section = section6();
|
||||
assertTrue(section.contains("1MB") || section.contains("1 MiB") || section.contains("1048576"),
|
||||
"§6 记录 1MB 阈值现状");
|
||||
assertTrue(section.contains("1048576"), "§6 记录阈值具体值 1048576");
|
||||
}
|
||||
|
||||
@Test
|
||||
void notReadingBodyStated() throws IOException {
|
||||
String section = section6();
|
||||
assertTrue(section.contains("不读 body") || (section.contains("日志") && section.contains("body")),
|
||||
"§6 记录过滤器日志不读 body");
|
||||
}
|
||||
|
||||
@Test
|
||||
void deferredItemsListed() throws IOException {
|
||||
String section = section6();
|
||||
assertTrue(section.contains("未做") || section.contains("不做") || section.contains("后续批次"),
|
||||
"§6 标注本轮未做项");
|
||||
}
|
||||
|
||||
@Test
|
||||
void spec03Referenced() throws IOException {
|
||||
String section = section6();
|
||||
assertTrue(section.contains("specs/03-request-trace-filter.md")
|
||||
|| section.contains("03-request-trace-filter.md"),
|
||||
"§6 引用 03 spec");
|
||||
}
|
||||
|
||||
@Test
|
||||
void consistentWithOverview() throws IOException {
|
||||
String section = section6();
|
||||
String overview = read(OVERVIEW);
|
||||
for (String key : List.of("49", "50", "51", "52", "53", "54", "55", "56")) {
|
||||
assertTrue(overview.contains("| " + key + " |"), "00-overview 实施记录含任务 " + key);
|
||||
}
|
||||
assertTrue(overview.contains("multipart 直通"), "00-overview 记录 multipart 直通");
|
||||
assertEquals(1, overview.split("multipart 直通", -1).length - 1,
|
||||
"00-overview 实施记录恰好一条 multipart 直通条目(与 §6 现状一致)");
|
||||
}
|
||||
|
||||
@Test
|
||||
void noTodoLeft() throws IOException {
|
||||
String section = section6();
|
||||
assertTrue(docLineNumberOf(section, "### 现状") > 0 || section.contains("已实现"),
|
||||
"§6 有现状或已实现描述");
|
||||
assertFalse(section.contains("TBD"), "§6 无 TBD 残留");
|
||||
assertFalse(section.contains("TODO"), "§6 无 TODO 残留");
|
||||
assertFalse(section.contains("待确认"), "§6 无待确认残留");
|
||||
}
|
||||
}
|
||||
@@ -90,9 +90,6 @@ class CompanyDefaultDropV152Test {
|
||||
return normalize(stripComments(rawMigration()));
|
||||
}
|
||||
|
||||
private static Path rollbackPatch() {
|
||||
return ROOT.resolve("docs/rollback-V152-columns-shop-key-default.sql");
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------ SQL 预处理
|
||||
// 与 CompanyMigrationV144Test / ShopKeyMigrationV150Test 逐字同实现,理由见类注释。
|
||||
@@ -270,29 +267,6 @@ class CompanyDefaultDropV152Test {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 回滚补丁的默认档就是"两条 SET DEFAULT 1"——与 rollback-V150 的"空档"相反:
|
||||
* 本笔被动过的只有默认值属性,装回它既是完整回滚、又是纯元数据、可逆无损。
|
||||
* 破坏点:写成 MODIFY(重建表)或忘了删 flyway_schema_history 行(半套回滚,
|
||||
* 会让"重装 V152 时跳过执行"与"库里 DEFAULT 已被装回"长期互相矛盾)。
|
||||
*/
|
||||
@Test
|
||||
void rollbackPatchRestoresTheDefaultAndDeletesHistoryRow() throws IOException {
|
||||
Path doc = rollbackPatch();
|
||||
assertTrue(Files.isRegularFile(doc), "V152 的人工回滚补丁必须存在:" + doc);
|
||||
String whole = raw(doc);
|
||||
assertTrue(whole.contains("flyway_schema_history"), "回滚必须写明删 version='152' 的历史行");
|
||||
assertTrue(whole.contains("'152'"), "回滚补丁要点名本版本号,后来人才知道删的是哪一行");
|
||||
String executable = normalize(stripComments(whole));
|
||||
assertTrue(!executable.isEmpty(), "本笔回滚是可逆的元数据操作,默认档必须直接可执行(不学 V150 的空档)");
|
||||
assertEquals(2, count(executable, "SET DEFAULT 1"),
|
||||
"默认档应把两列的 DEFAULT 都装回去(各恰一次),实际可执行段:" + executable);
|
||||
assertTrue(executable.contains("ALTER TABLE `columns` ALTER COLUMN company_id SET DEFAULT 1;")
|
||||
&& executable.contains("ALTER TABLE `biz_shop_key` ALTER COLUMN company_id SET DEFAULT 1;"),
|
||||
"装回语句应逐字用 ALTER COLUMN ... SET DEFAULT 1:" + executable);
|
||||
assertFalse(executable.toUpperCase().contains("MODIFY"),
|
||||
"禁 MODIFY:重建表对这两张表的历史行归属没有意义且徒增风险");
|
||||
}
|
||||
|
||||
/**
|
||||
* 摘掉 DEFAULT 之后哨兵对这两张表本应静默,但清单要留着——它是"被装回"(dump 重建、
|
||||
@@ -312,15 +286,6 @@ class CompanyDefaultDropV152Test {
|
||||
}
|
||||
|
||||
/** 破坏点:盘点文档没跟着 V152 改 ⇒ 下一个人按"取号起点"取号就撞号,或按"最新版本"漏掉本文件。 */
|
||||
@Test
|
||||
void inventoryDocTracksV152() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/migration-inventory.md");
|
||||
String text = raw(doc);
|
||||
assertTrue(text.contains(migration().getFileName().toString()),
|
||||
"盘点文档应逐字保留本迁移文件名:" + migration().getFileName());
|
||||
assertTrue(text.contains("V150__shop_key_company_scope.sql"),
|
||||
"盘点文档应同时保留更早的文件名:只钉最新一条会重演「推进概览时把旧条目挤掉」那一次回归");
|
||||
}
|
||||
|
||||
/** 自检:本用例集扫的是真文件,且 normalize 后仍能命中关键串(0 命中的断言是恒绿的)。 */
|
||||
@Test
|
||||
@@ -330,8 +295,5 @@ class CompanyDefaultDropV152Test {
|
||||
assertTrue(count(sql, "ALTER COLUMN") == 2,
|
||||
"关键签名命中数应为 2(恰好两条),实际 " + count(sql, "ALTER COLUMN")
|
||||
+ ":预处理或文件路径坏了,本类的断言全部不可信");
|
||||
String rollbackExecutable = normalize(stripComments(raw(rollbackPatch())));
|
||||
assertTrue(count(rollbackExecutable, "ALTER COLUMN") == 2,
|
||||
"回滚补丁可执行段的 ALTER COLUMN 也应为 2(否则上面「装回两次」的断言进了恒绿分支)");
|
||||
}
|
||||
}
|
||||
|
||||
@@ -28,7 +28,6 @@ class CompanyMigrationV143Test {
|
||||
private static final Path ROOT = Path.of(System.getProperty("user.dir"));
|
||||
private static final Path DB_DIR = ROOT.resolve("src/main/resources/db");
|
||||
private static final Pattern VERSION_FILE = Pattern.compile("^V(\\d+)(?:_(\\d+))?__.*\\.sql$");
|
||||
private static final String ROLLBACK_RELATIVE = "docs/rollback-V143-company.sql";
|
||||
|
||||
// ---------------------------------------------------------------- 取文件
|
||||
|
||||
@@ -374,23 +373,6 @@ class CompanyMigrationV143Test {
|
||||
*/
|
||||
@Test
|
||||
void rollbackLivesOutsideFlywayScanPath() throws IOException {
|
||||
Path rollback = ROOT.resolve(ROLLBACK_RELATIVE);
|
||||
assertTrue(Files.isRegularFile(rollback),
|
||||
"回滚脚本应存在于 " + ROLLBACK_RELATIVE + "(Flyway 扫描路径之外),否则事故时无从回退");
|
||||
|
||||
String rb = normalize(stripComments(Files.readString(rollback, StandardCharsets.UTF_8)));
|
||||
assertMatches(rb, "ALTER TABLE `users`\\s+DROP INDEX `idx_users_company_id`", "回滚应删掉索引");
|
||||
assertMatches(rb, "DROP COLUMN `company_id`", "回滚应删掉 users.company_id");
|
||||
assertMatches(rb, "DROP TABLE (IF EXISTS )?`company`", "回滚应删掉 company 表");
|
||||
assertTrue(rb.contains("flyway_schema_history") && rb.contains("143"),
|
||||
"回滚必须清掉 flyway_schema_history 里 V143 的记录,否则重装 jar 时 Flyway 认为已应用而跳过");
|
||||
assertTrue(rb.contains("admin_companies"), "回滚应删掉后台「公司管理」菜单行");
|
||||
|
||||
assertTrue(rawMigration().contains(ROLLBACK_RELATIVE),
|
||||
"V143 头注释的「回滚步骤」必须点名该脚本,否则值班的人找不到它");
|
||||
assertFalse(rawMigration().contains("db/V144"),
|
||||
"回滚不得写成版本化迁移 V144:Flyway 会在下次启动时自动执行它,静默撤销 V143");
|
||||
|
||||
for (Path f : versionFiles()) {
|
||||
String name = f.getFileName().toString().toLowerCase();
|
||||
assertFalse(name.contains("rollback"), "Flyway 扫描路径内不得出现回滚迁移: " + f.getFileName());
|
||||
@@ -402,35 +384,4 @@ class CompanyMigrationV143Test {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:docs/migration-inventory.md 的数字没跟着改。
|
||||
* 下一个人按文档里的"取号起点"取号就会撞号(Flyway 启动失败),或以为 V143 还没被占用。
|
||||
*/
|
||||
@Test
|
||||
void inventoryDocTracksTheNewMigration() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/migration-inventory.md");
|
||||
assertTrue(Files.isRegularFile(doc), "盘点文档应存在");
|
||||
String text = Files.readString(doc, StandardCharsets.UTF_8);
|
||||
|
||||
List<Path> files = versionFiles();
|
||||
int maxOnDisk = files.stream().mapToInt(CompanyMigrationV143Test::versionOf).max().orElse(0);
|
||||
|
||||
assertTrue(text.contains(migration().getFileName().toString()),
|
||||
"盘点文档应记录最新迁移文件名 " + migration().getFileName());
|
||||
|
||||
Matcher count = Pattern.compile("版本化迁移文件数:\\*\\*(\\d+)\\*\\*").matcher(text);
|
||||
assertTrue(count.find(), "盘点文档应给出版本化迁移文件数");
|
||||
assertEquals(files.size(), Integer.parseInt(count.group(1)),
|
||||
"文档记录的迁移文件数与磁盘不符");
|
||||
|
||||
Matcher range = Pattern.compile("整数版本范围:\\*\\*V1\\.\\.V(\\d+)\\*\\*").matcher(text);
|
||||
assertTrue(range.find(), "盘点文档应给出整数版本范围");
|
||||
assertEquals(maxOnDisk, Integer.parseInt(range.group(1)),
|
||||
"文档记录的整数版本上界与磁盘不符");
|
||||
|
||||
Matcher next = Pattern.compile("从 \\*\\*V(\\d+)\\*\\* 起取号").matcher(text);
|
||||
assertTrue(next.find(), "盘点文档应给出取号起点");
|
||||
assertEquals(maxOnDisk + 1, Integer.parseInt(next.group(1)),
|
||||
"取号起点必须 = 磁盘最大版本 + 1,否则会撞号或留洞");
|
||||
}
|
||||
}
|
||||
|
||||
@@ -278,14 +278,4 @@ class CompanyMigrationV144Test {
|
||||
}
|
||||
|
||||
/** 破坏点:盘点文档没跟着 V144 改,下一个人按"取号起点"取号就撞号。 */
|
||||
@Test
|
||||
void inventoryDocTracksV144() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/migration-inventory.md");
|
||||
assertTrue(Files.isRegularFile(doc), "盘点文档应存在");
|
||||
String text = Files.readString(doc, StandardCharsets.UTF_8);
|
||||
assertTrue(text.contains(migration().getFileName().toString()),
|
||||
"盘点文档应记录 V144 文件名 " + migration().getFileName());
|
||||
assertTrue(text.contains("1539570901"),
|
||||
"盘点文档应记下 V143 的生产存量校验和,作为「不许原地改」的证据");
|
||||
}
|
||||
}
|
||||
|
||||
-21
@@ -312,17 +312,6 @@ class CompanyScopeMigrationV145Test {
|
||||
assertFalse(writesHistoryTable.matcher(executable).find(),
|
||||
"回滚不许编成版本化迁移:" + file.getFileName() + " 的执行段写了 flyway_schema_history");
|
||||
}
|
||||
Path rollback = ROOT.resolve("docs/rollback-V145-company-scope.sql");
|
||||
assertTrue(Files.isRegularFile(rollback), "回滚人工补丁必须存在:" + rollback);
|
||||
String whole = raw(rollback);
|
||||
assertTrue(whole.contains("flyway_schema_history"), "回滚必须删本版本历史行");
|
||||
String executable = normalize(stripComments(whole));
|
||||
assertTrue(executable.contains("ADD UNIQUE KEY `uk_data_value_brand` (`data_value`, `brand`(191))"),
|
||||
"回滚要把品牌库的全局唯一键加回来");
|
||||
assertTrue(executable.contains("ADD UNIQUE KEY `uk_data_value` (`data_value`)"),
|
||||
"回滚要去把去重库的全局唯一键加回来");
|
||||
assertFalse(executable.contains("DROP COLUMN"),
|
||||
"DROP COLUMN 是丢归属信息的动作,必须留在注释里由人工解开(第 2 家已开通,删了就无法再分清)");
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -379,16 +368,6 @@ class CompanyScopeMigrationV145Test {
|
||||
}
|
||||
|
||||
/** 破坏点:盘点文档没跟着改,下一个人按"取号起点"取号就撞号。 */
|
||||
@Test
|
||||
void inventoryDocTracksV145() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/migration-inventory.md");
|
||||
String text = raw(doc);
|
||||
assertTrue(text.contains(migration().getFileName().toString()), "盘点文档应记录 V145 文件名");
|
||||
// 取号起点不在这里钉:原先写死 contains("V146"),而 V146 真落地后它只因文档里还留着
|
||||
// 那个文件名而巧合为真。派生尺子=MigrationInventoryTest#inventoryDocNumberingStartIsMaxPlusOne。
|
||||
assertTrue(text.contains("1833593804"), "盘点文档应记下 V144 的生产存量校验和");
|
||||
assertTrue(text.contains("1539570901"), "盘点文档应保留 V143 的生产存量校验和");
|
||||
}
|
||||
|
||||
/** 自检:本用例集扫的是真文件,且 normalize 后仍能命中关键串(0 命中的断言是恒绿的)。 */
|
||||
@Test
|
||||
|
||||
@@ -1,131 +0,0 @@
|
||||
package com.nanri.aiimage.config;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
import java.nio.file.Paths;
|
||||
import java.util.List;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
|
||||
/**
|
||||
* 任务 115:高频查询 EXPLAIN 索引审计(文档产出验证)。
|
||||
* 审计文档必须覆盖 history/progress/dashboard 三类高频查询的执行计划结论、
|
||||
* 候选索引清单(表/列/类型/收益/风险)、全表扫描标记、可重复执行步骤,
|
||||
* 且本任务明确不做 DDL(只审计,不加索引)。
|
||||
*/
|
||||
class ExplainIndexAuditDocTest {
|
||||
|
||||
private static final Path AUDIT = Paths.get("src", "main", "resources", "..", "..", "..",
|
||||
"docs", "explain-index-audit.md").normalize();
|
||||
private static final Path FLYWAY_SPEC = Paths.get("src", "main", "resources", "..", "..", "..",
|
||||
"docs", "specs", "12-flyway-and-inspection.md").normalize();
|
||||
|
||||
private static String read(Path path) throws IOException {
|
||||
return new String(Files.readAllBytes(path), StandardCharsets.UTF_8);
|
||||
}
|
||||
|
||||
private static List<String> linesOf(Path path) throws IOException {
|
||||
return List.of(read(path).split("\r?\n"));
|
||||
}
|
||||
|
||||
private static String lineContaining(String content, String needle) {
|
||||
for (String line : content.split("\r?\n")) {
|
||||
if (line.contains(needle)) {
|
||||
return line;
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_explain_history_plan() throws Exception {
|
||||
String doc = read(AUDIT);
|
||||
assertTrue(doc.contains("history"), "审计文档覆盖 history 查询");
|
||||
assertTrue(doc.contains("EXPLAIN"), "审计文档包含 EXPLAIN 执行计划记录");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_explain_progress_plan() throws Exception {
|
||||
String doc = read(AUDIT);
|
||||
assertTrue(doc.contains("progress"), "审计文档覆盖 progress 查询");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_explain_dashboard_plan() throws Exception {
|
||||
String doc = read(AUDIT);
|
||||
assertTrue(doc.contains("dashboard"), "审计文档覆盖 dashboard 查询");
|
||||
assertTrue(doc.contains("GROUP BY"), "dashboard 聚合查询计划已记录");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_full_scan_detected() throws Exception {
|
||||
String doc = read(AUDIT);
|
||||
assertTrue(doc.contains("type=ALL") || doc.contains("全表扫描") || doc.contains("ALL")
|
||||
|| doc.contains("possible_keys") || doc.contains("扫描"),
|
||||
"审计文档记录执行计划扫描类型(full scan 标记)");
|
||||
String line = lineContaining(doc, "idx_file_job_task");
|
||||
assertTrue(line != null && line.contains("task_id"),
|
||||
"审计文档指出 task_id 前缀索引对 (module_type, job_type, task_id IN) 的局限");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_index_candidates_listed() throws Exception {
|
||||
String doc = read(AUDIT);
|
||||
assertTrue(doc.contains("idx_file_job_module_type_task")
|
||||
|| doc.contains("module_type") && doc.contains("job_type") && doc.contains("task_id"),
|
||||
"候选索引清单含 (module_type, job_type, task_id) 组合");
|
||||
assertTrue(doc.contains("收益") && doc.contains("风险"),
|
||||
"候选索引清单含收益与风险说明");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_plan_documented() throws Exception {
|
||||
String doc = read(AUDIT);
|
||||
assertTrue(doc.contains("biz_task_file_job"), "审计文档引用目标表");
|
||||
assertTrue(doc.contains("biz_file_task") || doc.contains("biz_file_result"),
|
||||
"审计文档引用业务任务/结果表");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_plan_repeatable() throws Exception {
|
||||
String doc = read(AUDIT);
|
||||
assertTrue(doc.contains("EXPLAIN SELECT") || doc.contains("EXPLAIN")
|
||||
&& doc.contains("手工执行") || doc.contains("执行"),
|
||||
"审计文档包含可重复执行的 EXPLAIN SQL 步骤");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_no_ddl_this_task() throws Exception {
|
||||
String audit = read(AUDIT);
|
||||
String spec = read(FLYWAY_SPEC);
|
||||
assertTrue(audit.contains("不做 DDL") || audit.contains("本任务无 DDL")
|
||||
|| audit.contains("不新增索引") || audit.contains("只审计"),
|
||||
"审计文档明确本任务不做 DDL");
|
||||
// 任务 116 落地 V101 索引后,审计文档会把 ALTER TABLE 作为候选索引的
|
||||
// 回滚说明引用。审计任务自身依然不执行 DDL——判定口径改为「ALTER TABLE
|
||||
// 只能出现在候选/回滚等说明性上下文」,而不是文档里不得出现该字符串。
|
||||
for (String line : audit.split("\r?\n")) {
|
||||
if (!line.contains("ALTER TABLE")) {
|
||||
continue;
|
||||
}
|
||||
assertTrue(line.contains("回滚") || line.contains("候选") || line.contains("建议")
|
||||
|| line.contains("风险") || line.trim().startsWith(">"),
|
||||
"审计文档中的 ALTER TABLE 必须是候选/回滚说明,实际行:" + line);
|
||||
}
|
||||
assertTrue(spec.contains("只读") || spec.contains("巡检"),
|
||||
"12 spec 巡检报表模式与审计文档对应");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_audit_reflects_batch_loading_queries() throws Exception {
|
||||
String doc = read(AUDIT);
|
||||
assertTrue(doc.contains("findAssembleJobsByTaskIds"), "审计覆盖轻量进度 Job 批量查询");
|
||||
assertTrue(doc.contains("findAssembleJobsByResultIds"), "审计覆盖结果列表 Job 批量查询");
|
||||
assertTrue(doc.contains("selectMaps") || doc.contains("GROUP BY"), "审计覆盖 dashboard 聚合查询");
|
||||
}
|
||||
}
|
||||
@@ -1,66 +0,0 @@
|
||||
package com.nanri.aiimage.config;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
|
||||
/**
|
||||
* task-201:迁移演练 runbook 契约。
|
||||
* docs/flyway-migration-drill.md 固化演练步骤:干净迁移/validate/验证 SQL/回滚/锁窗口/校验和/
|
||||
* 幂等重跑/不动历史;on-DB 步骤由运维在副本库按 runbook 执行(本环境无库)。
|
||||
*/
|
||||
class FlywayMigrationDrillDocTest {
|
||||
|
||||
private static final String DOC = "docs/flyway-migration-drill.md";
|
||||
|
||||
private String doc() throws IOException {
|
||||
return Files.readString(Path.of(System.getProperty("user.dir"), DOC));
|
||||
}
|
||||
|
||||
@Test
|
||||
void drillDocExists() {
|
||||
assertTrue(Files.exists(Path.of(System.getProperty("user.dir"), DOC)), "演练 runbook 应存在");
|
||||
}
|
||||
|
||||
@Test
|
||||
void cleanMigrateStepDescribed() throws IOException {
|
||||
assertTrue(doc().contains("migrate"), "应描述干净迁移步骤");
|
||||
}
|
||||
|
||||
@Test
|
||||
void validateStepDescribed() throws IOException {
|
||||
assertTrue(doc().contains("validate"), "应包含 validate 校验历史 checksum 步骤");
|
||||
}
|
||||
|
||||
@Test
|
||||
void validationSqlStepDescribed() throws IOException {
|
||||
assertTrue(doc().contains("验证 SQL"), "应包含验证 SQL 步骤");
|
||||
}
|
||||
|
||||
@Test
|
||||
void rollbackStepDescribed() throws IOException {
|
||||
assertTrue(doc().contains("回滚"), "应包含回滚验证步骤");
|
||||
}
|
||||
|
||||
@Test
|
||||
void lockWindowEstimatedStepDescribed() throws IOException {
|
||||
assertTrue(doc().contains("锁窗口"), "应包含锁窗口估算步骤");
|
||||
}
|
||||
|
||||
@Test
|
||||
void checksumAndIdempotentRerunDescribed() throws IOException {
|
||||
String text = doc();
|
||||
assertTrue(text.contains("checksum") || text.contains("校验和"), "应包含校验和检查");
|
||||
assertTrue(text.contains("幂等重跑") || text.contains("idempotent"), "应包含幂等重跑");
|
||||
}
|
||||
|
||||
@Test
|
||||
void noLegacyTouchGuarded() throws IOException {
|
||||
assertTrue(doc().contains("历史") && (doc().contains("未被动") || doc().contains("未被改动")),
|
||||
"应明确演练不动历史迁移");
|
||||
}
|
||||
}
|
||||
-76
@@ -1,76 +0,0 @@
|
||||
package com.nanri.aiimage.config;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
|
||||
/**
|
||||
* task-192:迁移规范模板契约。
|
||||
* docs/flyway-migration-template.md 存在且六项必填(目的/影响表与数据量/锁表风险/验证 SQL/
|
||||
* 回滚步骤/上线窗口)齐全,含示例 SQL,可被新迁移文件头注释引用。
|
||||
*/
|
||||
class FlywayMigrationTemplateDocTest {
|
||||
|
||||
private static final String DOC = "docs/flyway-migration-template.md";
|
||||
|
||||
private String doc() throws IOException {
|
||||
return Files.readString(Path.of(System.getProperty("user.dir"), DOC));
|
||||
}
|
||||
|
||||
@Test
|
||||
void templateExists() throws IOException {
|
||||
assertTrue(Files.exists(Path.of(System.getProperty("user.dir"), DOC)), "模板文件应存在");
|
||||
}
|
||||
|
||||
@Test
|
||||
void sixMandatoryFieldsPresent() throws IOException {
|
||||
String text = doc();
|
||||
for (int i = 1; i <= 6; i++) {
|
||||
assertTrue(text.contains(i + ". "), "头注释应含第 " + i + " 项必填");
|
||||
}
|
||||
}
|
||||
|
||||
@Test
|
||||
void fieldNamesListed() throws IOException {
|
||||
String text = doc();
|
||||
assertTrue(text.contains("变更目的"));
|
||||
assertTrue(text.contains("影响表与数据量"));
|
||||
assertTrue(text.contains("锁表风险"));
|
||||
assertTrue(text.contains("验证 SQL"));
|
||||
assertTrue(text.contains("回滚步骤"));
|
||||
assertTrue(text.contains("上线窗口"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void hasCopyableHeaderComment() throws IOException {
|
||||
assertTrue(doc().contains("复制以下头注释"), "模板应提供可复制头注释");
|
||||
assertTrue(doc().contains("V{N+1}__"), "头注释示例应含占位版本号");
|
||||
}
|
||||
|
||||
@Test
|
||||
void hasValidationSqlExample() throws IOException {
|
||||
assertTrue(doc().contains("SELECT COUNT(*)"), "应含验证 SQL 示例");
|
||||
}
|
||||
|
||||
@Test
|
||||
void hasRollbackField() throws IOException {
|
||||
assertTrue(doc().contains("回滚步骤"), "应含回滚步骤说明");
|
||||
}
|
||||
|
||||
@Test
|
||||
void hasUpgradeWindowField() throws IOException {
|
||||
assertTrue(doc().contains("上线窗口"), "应含上线窗口说明");
|
||||
}
|
||||
|
||||
@Test
|
||||
void templateUsableByNewMigrations() throws IOException {
|
||||
String text = doc();
|
||||
assertTrue(text.contains("src/main/resources/db/"), "应说明迁移文件目录");
|
||||
assertTrue(text.contains("只追加"), "应强调只追加不改历史");
|
||||
assertTrue(text.contains("V109") || text.contains("最大现有版本"), "应说明版本号取最大现有版本+1");
|
||||
}
|
||||
}
|
||||
@@ -22,8 +22,6 @@ class IndexMigrationV101Test {
|
||||
|
||||
private static final Path DB_DIR = Paths.get("src", "main", "resources", "db");
|
||||
private static final Path MIGRATION = DB_DIR.resolve("V101__task_file_job_module_type_task_index.sql");
|
||||
private static final Path AUDIT = Paths.get("src", "main", "resources", "..", "..", "..",
|
||||
"docs", "explain-index-audit.md").normalize();
|
||||
|
||||
private static String read(Path path) throws IOException {
|
||||
return new String(Files.readAllBytes(path), StandardCharsets.UTF_8);
|
||||
@@ -78,18 +76,8 @@ class IndexMigrationV101Test {
|
||||
void test_migration_validated() throws Exception {
|
||||
String sql = read(MIGRATION);
|
||||
assertTrue(sql.contains("SELECT 1"), "验证 SQL(幂等分支)");
|
||||
String audit = read(AUDIT);
|
||||
assertTrue(audit.contains("idx_file_job_module_type_task"), "审计清单已列出该索引");
|
||||
assertTrue(audit.contains("收益") && audit.contains("风险"), "审计清单含收益/风险");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_explain_improved() throws Exception {
|
||||
String audit = read(AUDIT);
|
||||
assertTrue(audit.contains("findAssembleJobsByTaskIds"), "审计覆盖 progress/light Job 查询");
|
||||
assertTrue(audit.contains("执行后重跑") || audit.contains("前后计划")
|
||||
|| audit.contains("对比"), "审计含迁移前后 EXPLAIN 对比步骤");
|
||||
}
|
||||
|
||||
@Test
|
||||
void test_migration_no_alter_legacy() throws Exception {
|
||||
@@ -109,9 +97,6 @@ class IndexMigrationV101Test {
|
||||
String sql = read(MIGRATION);
|
||||
assertTrue(sql.contains("DROP INDEX") || sql.contains("drop index"),
|
||||
"迁移文件含回滚语句(DROP INDEX idx_file_job_module_type_task)");
|
||||
String audit = read(AUDIT);
|
||||
assertTrue(audit.contains("回滚") || audit.contains("DROP"),
|
||||
"审计文档含回滚步骤说明");
|
||||
}
|
||||
|
||||
@Test
|
||||
|
||||
-46
@@ -376,45 +376,6 @@ class MenuTreeCompanyMigrationV149Test {
|
||||
assertTrue(raw.contains("information_schema.STATISTICS"), "验证 SQL 要复验两条旧键已摘、两条新键在");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:回滚被编成版本化迁移(Flyway 扫描路径里的 V*.sql 会在下次启动自动执行),
|
||||
* 或者回滚把"删副本"排在"重指授权"之前。
|
||||
*
|
||||
* <p>后者是这一版独有的陷阱:{@code user_column_permission} 的外键是 ON DELETE CASCADE,
|
||||
* 先删副本会把它名下授权一起删光——而 V149 之后账号名下"本来就该"挂的是副本行。
|
||||
* 写反的读数不是报错,是 133 只账号的菜单被清空。</p>
|
||||
*/
|
||||
@Test
|
||||
void rollbackRepointsGrantsBeforeDeletingTheCopiesAndStaysUnversioned() throws IOException {
|
||||
Pattern writesHistoryTable = Pattern.compile(
|
||||
"\\b(DELETE|UPDATE|INSERT|TRUNCATE|ALTER|DROP)\\b[^;]*\\bflyway_schema_history\\b",
|
||||
Pattern.CASE_INSENSITIVE);
|
||||
for (Path file : versionFiles()) {
|
||||
String executable = normalize(stripComments(raw(file)));
|
||||
assertFalse(writesHistoryTable.matcher(executable).find(),
|
||||
"回滚不许编成版本化迁移:" + file.getFileName() + " 的执行段写了 flyway_schema_history");
|
||||
}
|
||||
Path rollback = ROOT.resolve("docs/rollback-V149-permission-menu-company.sql");
|
||||
assertTrue(Files.isRegularFile(rollback), "回滚人工补丁必须存在:" + rollback);
|
||||
String whole = raw(rollback);
|
||||
assertTrue(whole.contains("flyway_schema_history"), "回滚必须删本版本历史行(漏掉=重装时 Flyway 跳过 V149)");
|
||||
String executable = normalize(stripComments(whole));
|
||||
assertTrue(executable.contains("SET g.column_id = src.id"), "回滚要先把授权指针挪回公司 1 的源行");
|
||||
assertTrue(executable.contains("DELETE FROM `columns` WHERE company_id <> 1"), "再删副本");
|
||||
assertTrue(executable.indexOf("SET g.column_id = src.id") < executable.indexOf("DELETE FROM `columns`"),
|
||||
"顺序不能反:FK 是 ON DELETE CASCADE,先删副本等于清空 133 只账号的菜单");
|
||||
assertTrue(whole.contains("ON DELETE CASCADE"), "注释要写明为什么这个顺序是陷阱");
|
||||
assertTrue(executable.contains("ADD UNIQUE KEY `uk_column_key` (`column_key`)"), "回滚要把两条全平台旧键加回来");
|
||||
assertTrue(executable.contains("ADD UNIQUE KEY `uk_menu_type_route_path` (`menu_type`, `route_path`)"));
|
||||
assertTrue(executable.contains("DROP INDEX `uk_company_column_key`"), "并摘掉两条按公司的新键");
|
||||
assertTrue(executable.contains("DROP INDEX `uk_company_menu_type_route_path`"));
|
||||
assertTrue(executable.indexOf("ADD UNIQUE KEY `uk_column_key`") < executable.indexOf("DROP INDEX `uk_company_column_key`"),
|
||||
"回滚同样是先 ADD 后 DROP:中间态必须还剩一个唯一键");
|
||||
assertTrue(executable.contains("CREATE TEMPORARY TABLE `_v149_rb_gate`"),
|
||||
"重指与删除之间要有闸门:漏一行就会被 CASCADE 静默吞掉");
|
||||
assertTrue(executable.contains("CREATE TABLE IF NOT EXISTS `columns_bak_v149_rollback`"),
|
||||
"删副本前必须整表留底");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:头注释喊了哨兵,哨兵却没探这一列 ⇒ "有人盯着摘 DEFAULT"这件事是假的。
|
||||
@@ -533,13 +494,6 @@ class MenuTreeCompanyMigrationV149Test {
|
||||
}
|
||||
|
||||
/** 破坏点:盘点文档没跟着改,下一个人按"取号起点"取号就撞号。 */
|
||||
@Test
|
||||
void inventoryDocTracksV149() throws IOException {
|
||||
String text = raw(ROOT.resolve("docs/migration-inventory.md"));
|
||||
assertTrue(text.contains(migration().getFileName().toString()), "盘点文档应记录 V149 文件名");
|
||||
assertTrue(text.contains("V152"), "盘点文档应记下新的取号起点(V150/V151 已被同批占用)");
|
||||
// 取号起点是否真等于"当前最大值 + 1"由 MigrationInventoryTest 派生判定,这里不重复钉死字面号。
|
||||
}
|
||||
|
||||
/** 自检:本用例集扫的是真文件,且 normalize 后仍能命中关键串(0 命中的断言是恒绿的)。 */
|
||||
@Test
|
||||
|
||||
@@ -138,49 +138,7 @@ class MigrationInventoryTest {
|
||||
}
|
||||
}
|
||||
|
||||
@Test
|
||||
void inventoryDocCommittedAndConsistent() throws IOException {
|
||||
Path doc = Path.of(System.getProperty("user.dir"), "docs/migration-inventory.md");
|
||||
assertTrue(Files.exists(doc), "盘点文档应存在并随仓库提交");
|
||||
String text = Files.readString(doc);
|
||||
int maxMajor = parseAll(versionFiles()).stream().filter(Migration::isInteger)
|
||||
.mapToInt(Migration::major).max().orElse(0);
|
||||
assertTrue(text.contains("V" + maxMajor), "文档应记录最新版本 V" + maxMajor);
|
||||
assertTrue(text.contains("25_1") || text.contains("V25_1"), "文档应记录历史小版本");
|
||||
for (int hole : RETIRED_HOLES) {
|
||||
assertTrue(text.contains(String.valueOf(hole)),
|
||||
"文档应记录退役空号 V" + hole + " 的来历,否则后来人会试图回填该号");
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 盘点文档的「起取号」必须是目录当前最大值 + 1 —— 派生式,不写死数字。
|
||||
*
|
||||
* <p>破坏点两条:加了 V148 却没改文档 ⇒ 后来人照文档取号撞上刚落地的 V148(改已应用版本=两台都起不来);
|
||||
* 文档把号位改超前 ⇒ 1..max 留洞,{@link #integerVersionsSequentialFromOne} 会红。
|
||||
* 各迁移自己的审计类原先把「起点推到 V14x」写死在 assertTrue 里,那种断言在 V14x 真落地那天就
|
||||
* 只因文档里还留着同名文件而恒为真(基线自己过期)。尺子挪到这里、只对「本轮目录」求值,
|
||||
* 才不需要每加一版都有人记得回来改一个数字。</p>
|
||||
*/
|
||||
@Test
|
||||
void inventoryDocNumberingStartIsMaxPlusOne() throws IOException {
|
||||
String text = Files.readString(Path.of(System.getProperty("user.dir"), "docs/migration-inventory.md"));
|
||||
String marker = "从 **V";
|
||||
int hits = 0, cursor = -1;
|
||||
while ((cursor = text.indexOf(marker, cursor + 1)) >= 0) hits++;
|
||||
assertEquals(1, hits, "「从 **V<号>** 起取号」应只有一条可解析的取号规则," + hits + " 条=后来人不知道按哪条取号");
|
||||
|
||||
int digitsFrom = text.indexOf(marker) + marker.length();
|
||||
int digitsTo = digitsFrom;
|
||||
while (digitsTo < text.length() && Character.isDigit(text.charAt(digitsTo))) digitsTo++;
|
||||
assertTrue(digitsTo > digitsFrom, "取号规则里 V 之后必须是数字(解析不出=本用例恒绿)");
|
||||
int stated = Integer.parseInt(text.substring(digitsFrom, digitsTo));
|
||||
|
||||
int maxMajor = parseAll(versionFiles()).stream().filter(Migration::isInteger)
|
||||
.mapToInt(Migration::major).max().orElse(0);
|
||||
assertEquals(maxMajor + 1, stated,
|
||||
"取号起点应是目录最大值 V" + maxMajor + " 的下一号,实际文档写 V" + stated);
|
||||
}
|
||||
|
||||
@Test
|
||||
void checksumStableAcrossReads() throws IOException {
|
||||
|
||||
-45
@@ -203,33 +203,6 @@ class ProductCategoryMigrationV147Test {
|
||||
"三段条件 DDL 都必须走 PREPARE/EXECUTE(MySQL 不能在 IF 里直接写 DDL)");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:回滚脚本没跟着写 ⇒ 出问题只能手工现编 SQL,而"漏删 flyway_schema_history 的 147 行"
|
||||
* 这一手会让重装带 V147 的 jar 时 Flyway 判定已应用直接跳过——列和键都不重建,
|
||||
* 而 Java 侧实体照常读写 company_id,运行期报 Unknown column。
|
||||
*
|
||||
* <p>与 V145 那份同形:{@code DROP COLUMN} 必须留在注释里由人工解开(这张表没有账号列,
|
||||
* 删了就再也分不出哪一家),而"回滚不得版本化"由 {@link CompanyScopeMigrationV145Test
|
||||
* #rollbackStaysOutOfFlywayScanAndCoversTheHistoryRow} 那支按全目录扫,本类不重复实现,
|
||||
* 只在下面那支按文件名把本迁移钉进盘点文档(号位起点由 {@link MigrationInventoryTest
|
||||
* #inventoryDocNumberingStartIsMaxPlusOne} 派生式盯着)。</p>
|
||||
*/
|
||||
@Test
|
||||
void rollbackIsAHumanPatchOutsideTheFlywayScanPath() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/rollback-V147-product-category-company.sql");
|
||||
assertTrue(Files.isRegularFile(doc), "V147 的人工回滚补丁必须存在:" + doc);
|
||||
String whole = raw(doc);
|
||||
assertTrue(whole.contains("flyway_schema_history"), "回滚必须写明删 version='147' 的历史行");
|
||||
String executable = normalize(stripComments(whole));
|
||||
assertTrue(executable.contains("ADD UNIQUE KEY `" + OLD_KEY + "` (`category_key`)"),
|
||||
"回滚要把全平台唯一键加回来(新键是旧键的严格放宽,回填那一刻必然不撞)");
|
||||
assertTrue(executable.contains("DROP INDEX `" + NEW_KEY + "`"), "回滚要摘掉按公司的新唯一键");
|
||||
assertTrue(executable.indexOf("ADD UNIQUE KEY") < executable.indexOf("DROP INDEX"),
|
||||
"回滚也必须先加旧键后删新键,理由与迁移同一半:中间时刻不许没有唯一键");
|
||||
assertFalse(executable.contains("DROP COLUMN"),
|
||||
"DROP COLUMN 是丢归属信息的动作,必须留在注释里由人工解开");
|
||||
assertFalse(executable.contains("MODIFY COLUMN"), "同上:任何时候不要写 MODIFY COLUMN");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点(2026-10-06 起方向相反):类目表随「商品类目做成所有公司共享」的定案<b>退出</b>了启动期
|
||||
@@ -297,24 +270,6 @@ class ProductCategoryMigrationV147Test {
|
||||
return hits.get(0);
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:盘点文档没跟着改 ⇒ 下一个人按"取号起点"取号就撞号,或者按"最新版本"漏掉本文件。
|
||||
* 这里把 V145/V146/V147 三个文件名同时钉住:只钉最新一条会重演
|
||||
* 「推进第 11 行时把 V145 挤掉」那一次回归(本轮真实发生过)。
|
||||
* 号位起点不写在这里——写死 "V148" 到 V148 落地那天就自己过期,改由
|
||||
* {@link MigrationInventoryTest#inventoryDocNumberingStartIsMaxPlusOne} 按「本轮目录最大值 + 1」求值。
|
||||
*/
|
||||
@Test
|
||||
void inventoryDocTracksV147AndTheEarlierFilenamesTogether() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/migration-inventory.md");
|
||||
String text = raw(doc);
|
||||
for (String keep : List.of("V145__brand_dedupe_company_scope.sql",
|
||||
"V146__users_expires_at_admin_expiry.sql",
|
||||
migration().getFileName().toString())) {
|
||||
assertTrue(text.contains(keep), "盘点文档应逐字保留文件名:" + keep);
|
||||
}
|
||||
assertTrue(text.contains("1833593804"), "盘点文档应记下 V144 的生产存量校验和");
|
||||
}
|
||||
|
||||
/** 自检:本用例集扫的是真文件,且 normalize 后仍能命中关键串(0 命中的断言是恒绿的)。 */
|
||||
@Test
|
||||
|
||||
@@ -223,27 +223,6 @@ class ShopKeyMigrationV150Test {
|
||||
assertTrue(whole.contains("没有实查") || whole.contains("未实查"), "行数没查过这件事必须写在文件里,不许读成已知");
|
||||
}
|
||||
|
||||
/**
|
||||
* 回滚是人工补丁,且在 Flyway 扫描路径之外。
|
||||
*
|
||||
* <p>本迁移的回滚默认档<b>一条 SQL 都不执行</b>:这张表没有账号列,删列就删掉了唯一的归属依据,
|
||||
* 所以 {@code DROP COLUMN} 留在注释里由人工解开,止损走"保留新列、只回 jar"那一档
|
||||
* (新列对旧 jar 是惰性的,{@code DEFAULT 1} 正好把旧 jar 插入的行接住)。
|
||||
* {@link CompanyScopeMigrationV145Test#rollbackStaysOutOfFlywayScanAndCoversTheHistoryRow} 按全目录
|
||||
* 钉"回滚不得版本化",本类只钉本迁移这一支的内容。</p>
|
||||
*/
|
||||
@Test
|
||||
void rollbackIsAHumanPatchThatDefaultsToKeepingTheColumn() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/rollback-V150-shop-key-company.sql");
|
||||
assertTrue(Files.isRegularFile(doc), "V150 的人工回滚补丁必须存在:" + doc);
|
||||
String whole = raw(doc);
|
||||
assertTrue(whole.contains("flyway_schema_history"), "回滚必须写明删 version='150' 的历史行");
|
||||
assertTrue(whole.contains("'150'"), "回滚补丁要点名本版本号,后来人才知道删的是哪一行");
|
||||
String executable = normalize(stripComments(whole));
|
||||
assertTrue(executable.isEmpty(),
|
||||
"默认档不执行任何 SQL(删列是不可逆动作,必须留在注释里由人工解开),实际可执行段:" + executable);
|
||||
assertTrue(whole.contains("DROP COLUMN"), "删列那一步要在文件里,只是不许默认可执行");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:V150 的 DEFAULT 1 没进启动期哨兵清单 ⇒ "下一次记得摘"这件事没人喊,
|
||||
@@ -262,15 +241,6 @@ class ShopKeyMigrationV150Test {
|
||||
}
|
||||
|
||||
/** 破坏点:盘点文档没跟着改 ⇒ 下一个人按"取号起点"取号就撞号,或按"最新版本"漏掉本文件。 */
|
||||
@Test
|
||||
void inventoryDocTracksTheShopKeyFile() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/migration-inventory.md");
|
||||
String text = raw(doc);
|
||||
assertTrue(text.contains(migration().getFileName().toString()),
|
||||
"盘点文档应逐字保留本迁移文件名:" + migration().getFileName());
|
||||
assertTrue(text.contains("V147__product_category_company_scope.sql"),
|
||||
"盘点文档应同时保留更早的文件名:只钉最新一条会重演「推进概览时把旧条目挤掉」那一次回归");
|
||||
}
|
||||
|
||||
/** 自检:本用例集扫的是真文件,且 normalize 后仍能命中关键串(0 命中的断言是恒绿的)。 */
|
||||
@Test
|
||||
@@ -279,10 +249,6 @@ class ShopKeyMigrationV150Test {
|
||||
assertTrue(sql.length() > 120, "剥注释后的 SQL 太短,说明预处理把内容吃掉了:" + sql.length());
|
||||
assertTrue(count(sql, "ALTER TABLE") >= 1 && count(sql, "information_schema") > 0,
|
||||
"关键签名 0 命中=预处理或文件路径坏了,本类的断言全部不可信");
|
||||
String rollbackExecutable = normalize(stripComments(raw(ROOT.resolve("docs/rollback-V150-shop-key-company.sql"))));
|
||||
assertTrue(raw(ROOT.resolve("docs/rollback-V150-shop-key-company.sql")).contains("--"),
|
||||
"回滚补丁若一条注释都没有,上面那条「可执行段为空」就成了恒真断言");
|
||||
assertTrue(rollbackExecutable.isEmpty(), "回滚补丁的可执行段应当确实为空");
|
||||
}
|
||||
|
||||
private static int count(String haystack, String needle) {
|
||||
|
||||
@@ -1,284 +0,0 @@
|
||||
# 品牌库 / 去重库 按公司隔离 · 二期设计方案
|
||||
|
||||
日期: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. 两张表都是**每公司一套**(不是全平台共享)。
|
||||
—— **本条对品牌库已被 2026-10-06 推翻**(`V151__rule_tables_shared_across_companies.sql` 退回全局唯一键);
|
||||
对去重库继续成立。
|
||||
2. 租户键**破例物化为 `company_id` 列**,不用 `uploader_user_id` 派生、不复用店铺分组。
|
||||
—— 这推翻一期"不给业务表加 `company_id` 冗余列"(`db/V143:5-8`)与"不复用店铺分组当租户"两条,仅限这两张表。
|
||||
3. 一期"复用店铺分组当租户"被否掉的理由仍然成立(那 4 段 UNION 覆盖面窄、成员表已判废),所以 `group_id` **保留原语义**(店铺分组 = 操作维度),公司边界一律走新 `company_id`,两者不互相替代。
|
||||
—— **2026-10-07 补:品牌库这一页上 `group_id` 只剩归类标签一个用途。**
|
||||
它既不是公司边界,也不是可见性边界——`InvalidAsinDataService` 的 `page/update/delete` 形参里不再收操作者与角色,
|
||||
任何能进这一页的账号看到同一份数据、可按任意分组筛选、可改删任意行;分组名册走该页自己的
|
||||
`GET /api/admin/invalid-asin-data/groups`(店铺页那个 `/shop-manages/groups` 对非超管只返回本人可访问分组,不能用)。
|
||||
反向钉在 `admin-frontend-vue/tests/align-invalid-asin-shared.test.ts`。
|
||||
|
||||
---
|
||||
|
||||
## 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 是否单独排期先上**:它是唯一有时间敏感性的部分(第二家公司一开,归属就永久补不回来了)。
|
||||
@@ -1,566 +0,0 @@
|
||||
# 多公司(租户)改造设计
|
||||
|
||||
> 日期:2026-10-04 状态:**一期已上线**(V143 于 2026-10-04 10:48:54 应用到生产库,jar 双节点同版;
|
||||
> V144「摘掉 `users.company_id` 的列默认值」随下一个 jar 窗口生效) 决策确认:brainstorm 流程(用户逐条拍定)
|
||||
> ⚠ 已应用的迁移字节封死:`V142` 校验和 `1152261840`、`V143` 校验和 `1539570901`
|
||||
> (2026-10-04 11:0x 只读实查 `flyway_schema_history`)。`spring.flyway.validate-on-migrate=true` 是硬编码,
|
||||
> 原地改这两个文件的任何一个空格 ⇒ 下次启动校验失败、两台 java 都起不来。口径变更只能写下一条迁移,
|
||||
> 由 `CompanyMigrationV144Test.appliedMigrationBytesAreFrozenAgainstProdChecksum` 把守。
|
||||
> 适用范围:`crawler-plugin/backend-java` + `crawler-plugin/admin-frontend-vue`(后台 admin-vue)+ `crawler-plugin/frontend-vue`(用户端 app-web)
|
||||
> **不修改** `app_client`(Python 桌面端零改动,见 §2.4)
|
||||
> 关联:`backend-java/docs/flyway-migration-template.md`、`backend-java/docs/migration-inventory.md`
|
||||
|
||||
---
|
||||
|
||||
## 0. 一句话结论
|
||||
|
||||
一期只做**账号归属**:新建 `company` 主表、给 `users` 挂 `company_id`、现有全部账号归属「厦门米椿花」。
|
||||
业务表**一张不碰、一行不回填**——57 张表里 26 张带 `user_id`,公司维度全部由 `user_id → users.company_id` 派生。
|
||||
唯一索引、登录定位、89 个数据过滤出口**一律不动**,因此一期对线上行为是零变化。
|
||||
|
||||
---
|
||||
|
||||
## 1. 现状取证(每条均可复查)
|
||||
|
||||
### 1.1 现有「公司」字样全是紫鸟语义,不可复用
|
||||
|
||||
| 位置 | 语义 |
|
||||
|---|---|
|
||||
| `biz_ziniao_memory_store.company_name`(`V8__add_company_name_to_ziniao_memory_store.sql`) | 紫鸟 ERP 侧浏览器配置文件的公司,自由文本、无外键 |
|
||||
| `biz_publish_file.company_name`(`V77__publish_task.sql:12`) | 同上,快照字段 |
|
||||
| `ZiniaoProperties.companyId` / `ClientCredentialProperties.ziniaoCompany` | 紫鸟自动化账号所属公司 |
|
||||
|
||||
读写点仅 `modules/ziniao/memory/service/ZiniaoMemoryStoreService.java:129-151`、`ZiniaoShopIndexService.java:219/329`。
|
||||
**全库无 company / tenant / organization 主表**,`biz_shop_manage` 也没有公司列。新建 `company` 表不与上述任何字段冲突,但命名上必须避免歧义:新表叫 `company`,紫鸟那两个字段保持原名不动。
|
||||
|
||||
### 1.2 没有任何框架级租户机制
|
||||
|
||||
`TenantLineHandler`、`DataPermissionInterceptor`、`MetaObjectHandler`、`@InterceptorIgnore` —— **全仓 0 命中**。
|
||||
隔离靠 service 层手写 wrapper:
|
||||
|
||||
- `.eq/.in(Entity::getUserId, …)` 共 **89 处**,分布在 **34 个文件**
|
||||
- 构成:`userId`(方法参数)**77 处**、`request.getUserId()` **8 处**、集合式(`allowedUserIds`/`uniqueIds`/`createdById`)**3 处**、`createdById` **1 处**
|
||||
- 热点两张表吃掉一半:`FileTaskEntity` 25 处、`FileResultEntity` 19 处
|
||||
- 另有约 **125 处**其他归属口径的引用(`created_by_id`、`"user:"+id` 字符串、`group_id`)——这是 grep 命中数,**不全是过滤条件**,二期逐个接入口时要重新按"是否构成数据范围判定"分类,不能直接当工作量
|
||||
- 「admin 看全部 / normal 看自己」的角色判定在 `common/security/DeviceSessionPolicy.java:26-36 resolveRole()`,经 `AdminAuthSupport.java:104-119` 暴露;`super_admin` 分支散在 **27 个文件、219 处**
|
||||
- 唯一的统一工具 `modules/permission/support/UserDataScopeSupport.java:33` 只服务 3 个模块,且带 `FALLBACK_LIMIT = 2000` 兜底
|
||||
- 并行存在 5 套各自实现的 scope(9 个文件、37 处引用):`TaskCenterScopeService`、`DedupeTotalDataService`、`ShopDataCrawlAdminTasksService`、`ShopDataDuplicateCheckQueryService`、`UserDataScopeSupport`
|
||||
|
||||
### 1.3 请求体里的 `user_id` 不校验归属
|
||||
|
||||
`validateUserId` 只判 `> 0`,**不判是不是登录人本人**:
|
||||
|
||||
- `modules/patroldelete/service/PatrolDeleteResolveService.java:244-248`
|
||||
- `modules/similarasin/service/SimilarAsinTaskService.java:1679-1683`
|
||||
|
||||
controller 原样透传 `request.getUserId()`(`patroldelete`/`pricetrack`/`productrisk`/`shopdatacrawl`/`shopmatch`/`similarasin`/`withdraw` 七个模块均如此)。
|
||||
|
||||
`config/AdminApiGuardFilter.java` 的 `USER_TOOL_PREFIXES` 列了 **14 个用户态前缀**(`/api/patrol-delete`、`/api/price-track`、`/api/similar-asin`、`/api/withdraw`、`/api/shop-match`、`/api/product-risk-resolve`、`/api/shop-data-crawl`、`/api/query-asin`、`/api/appearance-patent`、`/api/brand`、`/api/files`、`/api/digital-human`、`/api/collect-data`、`/api/tasks`),受 `aiimage.security.user-tool-guard-enabled` 控制,**默认 `false` = 匿名可达**(`AdminApiGuardFilter.java:128`)。
|
||||
|
||||
客户端确实带 `X-Internal-Token`(`app_client/amazon/tool.py:32 internal_token_or_empty()`),但那是**共享静态密钥**,过滤器注释自己写明「能证明走了内部通道,证明不了这个 user_id 是谁」(`AdminApiGuardFilter.java:48`)。
|
||||
→ **这 14 个前缀上的公司隔离,在阶段B(设备令牌)落地前无法真正强制。** 见 §7.3。
|
||||
|
||||
### 1.4 登录链路按 username 单列定位
|
||||
|
||||
- `modules/auth/service/AuthService.java:94` —— `selectOne(eq(username))`,依赖 `users.username` 的**全局唯一索引**
|
||||
- `AuthService.java:50-78` —— 登录失败锁定 map 的 key 是**裸 `username`**
|
||||
- `LoginResultVo.java:11-23` —— 改造前返回 `userId/username/role/isAdmin/deviceId/token/expiresIn/appColumns/adminColumns`,**无公司**(本轮按 §4 加了 `companyId`:16 / `companyName`:18)
|
||||
- `JwtService.issue()` claims 只有 `subject(userId)` / `username` / `deviceId`
|
||||
- 前端两套登录态机制不同:**用户端 `frontend-vue` 无 Pinia**,登录态存 localStorage(`shared/auth/ensure-auth.ts` 的 `AUTH_TOKEN_KEY = 'aiimage_auth_token'`,`uid`/`username` 由 `ensureAuth()` 与 `restoreLoginUser()` 两个函数各自回写),`shared/api/user.ts` 的 `getCurrentUserId()` 直接读 `localStorage.uid`;**后台 `admin-frontend-vue` 是 Pinia**(`src/stores/admin-session.ts` 的 `defineStore('admin-session')`),用户信息走 `src/api/session.ts` 的 `fetchCurrentUser()` → `/api/admin/current-user`
|
||||
- `/api/admin/current-user` 的返回体是 `AdminConsoleController.java:70-77` 里**手搭的 `Map<String,Object>`**(`id`/`username`/`role`/…),不是 VO 类 → 后台顶栏要显示公司名,改的是这个 Map,**不是** `LoginResultVo`
|
||||
|
||||
### 1.5 `users` 表映射了两个实体
|
||||
|
||||
`common/model/entity/AdminUserEntity.java` 与 `modules/auth/model/entity/LoginUserEntity.java` **都** `@TableName("users")`。加列必须同步改两处,漏一处就是半边链路读不到公司。
|
||||
|
||||
---
|
||||
|
||||
## 2. 一期范围
|
||||
|
||||
### 2.1 数据模型(V143)
|
||||
|
||||
见 §3 迁移全文。要点:
|
||||
|
||||
- `company` 主表,`company_name` 唯一
|
||||
- `users.company_id BIGINT NOT NULL DEFAULT 1` + 索引 —— **DEFAULT 1 已由 V144 摘除**,列现为 `NOT NULL` 无默认值(§6.3 / §8.2)
|
||||
- **业务表零 DDL**
|
||||
|
||||
### 2.2 建号:公司必选,超管可指定
|
||||
|
||||
规则与现有 `createdById` 完全同构(`AdminUserService.java:161-175`:超管可指定创建人,非超管强制落自己名下):
|
||||
|
||||
| 操作者 | `companyId` 传了 | 不传 |
|
||||
|---|---|---|
|
||||
| `super_admin` | 落指定公司(校验公司存在且启用) | 落自己所属公司 |
|
||||
| `admin`(公司内) | **只允许等于自己所属公司**,否则 403 | 落自己所属公司 |
|
||||
| `normal` | 不可建号(现状即如此:`POST /api/admin/user` 需管理员 + `admin_users` 菜单,`AdminUserService.java:136-140`) | — |
|
||||
|
||||
`AdminUserService.createUser` **永远显式写入** `company_id`,不依赖列 DEFAULT(`resolveTargetCompanyId` 在任何分支都返回一个具体值)。
|
||||
列 DEFAULT 曾只为混合版本窗口的旧 jar 存在(§8.2),**现已由 V144 摘除**:此后任何绕过 `createUser` 的写入若不带公司,
|
||||
MySQL 严格模式报 `1364 Field 'company_id' doesn't have a default value` 炸在日志里,而不是被静默塞进厦门米椿花。
|
||||
|
||||
**前端比后端严**:新后台的建号弹窗对超管**必须显式选一家**(`validateCreateUserForm(form, operator)`),
|
||||
而后端对"不传"仍落操作者自己公司。这不是矛盾——后端那条口径是给尚未升级的旧后台兜底的(§5.3),
|
||||
超管手里同时有 N 家公司时"静默落我自己那家"是危险默认。别把前端的必选当成冗余逻辑删掉。
|
||||
|
||||
移人(改账号所属公司):一期**仅超管**可做,且必须校验不变式——账号的 `created_by_id` 必须与自己同公司或为超管,否则拒绝。这条不变式是二期省掉逐个改 77 处过滤点的前提(§7.2)。
|
||||
|
||||
### 2.3 公司目录接口
|
||||
|
||||
新建 `modules/company/`:
|
||||
|
||||
| 方法 | 路径 | 权限 |
|
||||
|---|---|---|
|
||||
| GET | `/api/admin/companies` | 超管列全部;公司内 admin 只列自己公司 |
|
||||
| POST | `/api/admin/companies` | 仅超管 |
|
||||
| PUT | `/api/admin/companies/{id}` | 仅超管(改名 / 启停) |
|
||||
|
||||
**不做删除**:有账号挂着的公司删不掉,用 `status=0` 停用代替。
|
||||
菜单权限走现有口径:`columns` 表插 `admin_companies`,controller 用 `permissionMenuService.hasAnyAdminMenu(operator, List.of("admin_companies"))`(同 `AdminUserService.java:466-470`)。
|
||||
|
||||
账号列表(`AdminUserService.listUsers`)一期加 `companyId` **可选**筛选参数:超管可筛任意公司,admin 只能筛自己公司(传别家公司 → 视为无结果,不报错也不越权)。不传时行为与现状完全一致。若你只要"列表显示公司列"而不要筛选,去掉这个参数即可,其余设计不受影响(见 §9.3)。
|
||||
|
||||
### 2.4 登录态与前端显示公司名
|
||||
|
||||
- `LoginResultVo` + `check_login` 返回 `companyId` / `companyName`
|
||||
- **JWT 不加 claim**:`AdminAuthSupport.requireUser()` 每次都 `selectById` 回库,公司随实体自然带出;加 claim 反而要处理旧 token 无该 claim 的兼容
|
||||
- 前端两个部署物都要动(后台建号表单 + 公司目录在 `admin-frontend-vue`,用户端顶栏显示公司名在 `frontend-vue`),逐文件清单见 §5
|
||||
- **`app_client` 零改动**:桌面端窗口直载线上 app-web,前端发布即全端生效,无客户端版本碎片化
|
||||
|
||||
### 2.5 一期明确不做
|
||||
|
||||
| 推迟项 | 触发条件 |
|
||||
|---|---|
|
||||
| `users.username` 唯一索引 → `(company_id, username)` | 第二家公司开通时 |
|
||||
| 登录定位改造 + 锁定 key 改造 | 同上(两者必须同批,见 §7.1) |
|
||||
| 89 个数据过滤出口叠公司边界 | 同上 |
|
||||
| 14 个用户态前缀的越权收口 | 阶段B 设备令牌落地 |
|
||||
| 跨公司汇总 / 对比报表 | 用户已明确一期不要 |
|
||||
|
||||
---
|
||||
|
||||
## 3. V143 迁移
|
||||
|
||||
**正文以 `backend-java/src/main/resources/db/V143__company_and_users_company_id.sql` 为准**(已由
|
||||
`CompanyMigrationV143Test` 12 例 + 16 条变异自证钉住),本节只记不落进代码就丢失的决策。
|
||||
语句顺序共六步:建表 → 插初始公司 → 加列与索引 → 回填 → 收 NOT NULL 闸门 → 插后台菜单。
|
||||
|
||||
| 决策 | 为什么 |
|
||||
|---|---|
|
||||
| 初始公司 `id` 显式钉为 1 | V143 出厂时 `users.company_id` 的 DEFAULT 只能是字面量(MySQL 不允许 DEFAULT 子查询),存量回填也写死 `= 1`。id 交给 AUTO_INCREMENT,这两处就会指向一个不存在的公司。V144 摘掉 DEFAULT 后,"回填写死 1"这一处仍然依赖它 |
|
||||
| 加列 → 回填 → 再 `MODIFY NOT NULL`,不是一步建成 NOT NULL | `MODIFY ... NOT NULL` 本身就是自检闸门:回填漏任何一行就抛 `ER_INVALID_USE_OF_NULL` 让迁移失败,而不是留一堆 NULL 静默通过(NULL = 该账号在公司维度整体失明) |
|
||||
| 闸门留 `DEFAULT 1` | 只为混合版本窗口存在,见 §8.2;摘除**不能原地改这条迁移**(10:48:54 已落库),只能前向写成 V144 |
|
||||
| 每条语句都写成幂等(`IF NOT EXISTS` / `INSERT IGNORE` / 查 `information_schema` 后 `PREPARE` / `WHERE` 限定 / `NOT EXISTS` 守卫) | MySQL 的 DDL 不进事务。迁移中途失败时前面的语句已落库,而 §8.1 的恢复步骤(补数据 → `flyway repair` → 重启)会让 Flyway **从第一条语句重跑整个文件**;写成裸 `CREATE TABLE` / 裸 `INSERT ... VALUES`,恢复路径自己会撞 1050/1060/1062,把"补数据后重启"变成"必须手工清库" |
|
||||
| 菜单 `sort_order` 按同级 `MAX+5` 自算 | 现有子菜单的 sort_order 来自初始数据、从未被任何迁移设定过,写字面量等于猜 |
|
||||
| 菜单 `route_path = 'account/companies'`、`column_key = 'admin_companies'` | 真正的跨产物契约是 **`column_key` 必须在 `admin-frontend-vue/src/router/routes.ts` 登记为 `menuKey`**:侧边栏跳转、面包屑与路由门禁都按 key 关联,且 `menu-route-map.ts` 会用注册表算出的规范路径**覆盖**库里的 `route_path`——所以 `route_path` 写错并不会 404,没登记 menuKey 才会。两边都按现有值保持一致,由 `admin-frontend-vue/tests/company-menu-route.test.ts` 逐条核对;`columns.column_key` 上有 `uk_column_key`,非幂等插入会直接报错 |
|
||||
| 回滚是 `backend-java/docs/rollback-V143-company.sql`,**不是一条版本化迁移** | 见 §8.3。(实际的 V144 是**前向修复**——摘 DEFAULT,不是撤销 V143;两者别混) |
|
||||
|
||||
条件 DDL 的写法照 V142(本仓首例),幂等插菜单照 V103/V106。
|
||||
|
||||
> 菜单与公司表放同一条迁移,是因为取号存在真实争用风险(V138/V139/V140 已被其他计划占用,见 `migration-inventory.md`),一条迁移少占一个号。
|
||||
|
||||
**验证 SQL**
|
||||
|
||||
```sql
|
||||
SELECT COUNT(*) AS company_rows FROM company; -- 期望 1
|
||||
SELECT id, company_name, status FROM company; -- 期望 1 | 厦门米椿花 | 1
|
||||
SELECT COUNT(*) AS users_total,
|
||||
SUM(company_id IS NULL) AS null_company,
|
||||
SUM(company_id = 1) AS in_xiamen_michunghua
|
||||
FROM users; -- 期望 null_company=0 且 users_total=in_xiamen_michunghua
|
||||
SHOW COLUMNS FROM users LIKE 'company_id'; -- V143 出厂期望 Default=1;V144 上线后期望 Default=NULL
|
||||
SHOW INDEX FROM users WHERE Key_name = 'idx_users_company_id'; -- 期望 1 行
|
||||
SELECT c.id, c.name, c.column_key, c.route_path, c.sort_order, p.column_key AS parent_key
|
||||
FROM columns c LEFT JOIN columns p ON p.id = c.parent_id
|
||||
WHERE c.column_key = 'admin_companies'; -- 期望 1 行,parent_key=admin_group_account
|
||||
```
|
||||
|
||||
**生产实跑读数(2026-10-04 11:3x,只读,主机A 业务库)**
|
||||
|
||||
| 查的 | 读到的 | 判读 |
|
||||
|---|---|---|
|
||||
| `flyway_schema_history` 末三行 | `143 / 1539570901 / 10:48:54`、`142 / 1152261840 / 10-03 18:23:22`、`141 / -117620083 / 10-03 12:52:31` | 两个校验和就是冻结护栏里的常量,非记忆值 |
|
||||
| `information_schema.COLUMNS` 的 `company_id` | `IS_NULLABLE=NO`、**`COLUMN_DEFAULT=1`** | 回填与闸门都落上了;DEFAULT 仍在 ⇒ V144 有明确对象,尚未生效 |
|
||||
| `users` 归属分布 | `139 / null=0 / =1 的 139` | 一行不漏,全部落在厦门米椿花 |
|
||||
| `company` 行数 | `1` | 初始公司只一家 |
|
||||
| `idx_users_company_id` 索引行数 | `1` | 列与索引都在 |
|
||||
| 菜单 `admin_companies` | `id=109`、`route_path=account/companies`、父级 `admin_group_account` | 与前端 `routes.ts` 逐字一致 |
|
||||
| 两台 jar | 同版 `dd89997732dd1f9118aaeae96daca89e`(137,416,959 B;B 10:48:36、A 11:01:21) | 混合版本窗口闭合 |
|
||||
| 两台启动 Flyway 行 | B:`validated 143` → `142 → 143` applied;A:`validated 143` + `Current version: 143` | 校验通过,A 只是没东西可补 |
|
||||
| 哨兵 `COMPANY_DEFAULT_STILL_PRESENT` | 两台近 6h 各 **0** 次 | 与 §6.3 一致:1 家公司时本来就不该喊,摘没摘只能看上面那行 `COLUMN_DEFAULT` |
|
||||
| admin-vue(主机B) | 当前包 `20261004-110528`,含 `assets/companies-*.js`,`account/companies` 命中 1、`admin_companies` 命中 2 | 公司管理页已随包出厂 |
|
||||
| app-web(主机B) | 当前包 `20261003-130306`,`companyName` 命中 29 | 用户端带得到公司身份 |
|
||||
| 两台 `ERROR` 行(近 2h) | 各 0 | 这次迁移没带来新报错 |
|
||||
|
||||
> 更正一条我早先的读数:11:04 那次探到 `admin-vue 公司页 HITS=0`,不是 grep 姿势错,是**当时软链还指向 01:45 的包**(`20261004-014530`,公司页未随那版发)。11:05 切包后为 1/2 命中。
|
||||
|
||||
同步更新 `backend-java/docs/migration-inventory.md`:V144 落盘后文件数 142→**143**、范围 V1..V143→**V1..V144**、取号起点 V144→**V145**,并把 142/143 的生产校验和记进「已应用迁移的存量校验和」表。审计测试 `MigrationInventoryTest` 会校验整数版本从 1 连续到最大值(`RETIRED_HOLES = {132,133}` 除外)。
|
||||
|
||||
---
|
||||
|
||||
## 4. 后端改动清单
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `common/model/entity/AdminUserEntity.java` | +`companyId` |
|
||||
| `modules/auth/model/entity/LoginUserEntity.java` | +`companyId`(§1.5:两个实体都映射 users,必须同改) |
|
||||
| `modules/company/`(新建) | `CompanyEntity` / `CompanyMapper` / `CompanyService` / `CompanyController`;`CompanyService` 除目录读写外还有三条只读口径:`requireActive`(准入)、`namesByIds`(批量显示名,不做权限判定)、`nameOrEmpty`(单条显示名,查不到回空串) |
|
||||
| `modules/admin/service/AdminUserService.java` | `createUser` 写 `companyId`(§2.2 规则);`update` 支持超管移人 + 不变式校验;`listUsers` 加 `companyId` 可选筛选 + 批量取公司名 |
|
||||
| `modules/admin/controller/AdminUserController.java` | `GET /api/admin/users` +`@RequestParam(name = "company_id")` |
|
||||
| `modules/admin/model/vo/AdminUserItemVo.java` | +`company_id` / `company_name`(前端账号列的数据源,snake_case 与其余字段同规则) |
|
||||
| `modules/admin/model/dto/*` | 建号/改号请求 +`companyId` |
|
||||
| `modules/auth/model/vo/LoginResultVo.java` | +`companyId` / `companyName`(**用户端** app-web 走这条) |
|
||||
| `modules/admin/controller/AdminConsoleController.java:76-77` | `current-user` 的手搭 Map +`companyId` / `companyName`(**后台** admin-vue 顶栏走这条,见 §1.4) |
|
||||
| `modules/auth/service/AuthService.java` | `login` 与 `checkLogin` 回填公司名(**不改** username 定位逻辑) |
|
||||
| 启动期巡检 | `modules/company/service/CompanyDefaultGuard.java`(新建):`company` 表 >1 行 **且** `users.company_id` 仍带 DEFAULT → `log.error` 带 ASCII 标记 `COMPANY_DEFAULT_STILL_PRESENT`,探针自身失败降级为 `COMPANY_DEFAULT_PROBE_FAILED` 的 WARN(不许静默当成"查过了")。`scripts/_prod_watch.py` 的 `SIGNATURES` 收第一条并计入 ALERTS(§6.3) |
|
||||
|
||||
---
|
||||
|
||||
## 5. 前端改动清单
|
||||
|
||||
**两个前端是两个独立部署物,别混**:后台是 `admin-frontend-vue`(部署为 admin-vue),用户端是 `frontend-vue`(构建到 `new_web_source/`,部署为 app-web,桌面客户端窗口直载它)。建号表单和公司目录在**后台**,"用户登录后看到公司名"在**用户端**。
|
||||
|
||||
### 5.1 `admin-frontend-vue`(后台)
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `src/router/routes.ts` | 注册 `{ path: 'account/companies', menuKey: 'admin_companies', title: '公司管理', load: () => import('@/pages/account/CompaniesPage.vue') }`——`menuKey` 必须与菜单的 `column_key` 一致(否则菜单点进去 404,见 §3),`path` 与库里 `route_path` 保持一致 |
|
||||
| `src/pages/account/CompaniesPage.vue`(新建) | 公司列表 + 新建 + 改名/启停 |
|
||||
| `src/api/companies.ts`(新建,配 `-dto.ts`/`-model.ts`) | 按 `src/api/users.ts` 的现有 DTO/model 分层写,不另发明一套 |
|
||||
| `src/pages/account/UsersPage.vue` | 建号表单加公司下拉(必选,超管可选任意公司、admin 锁死自己公司);列表加公司列与筛选 |
|
||||
| `src/api/users-dto.ts` / `users-model.ts` / `users.ts` | +`companyId` / `companyName` |
|
||||
| `src/api/session.ts` + `src/stores/admin-session.ts` | **不改**:`fetchCurrentUser` 直接把 `/api/admin/current-user` 的 `item` 当 `AdminUser` 用(`session.ts:6`),不经解析器,所以 `companyId`/`companyName` 自动落到对象上;顶栏 `AdminLayout.vue:35` 的 `topbarUserOf(session.user)` 读它即可 |
|
||||
| `src/types/admin.ts` | `AdminUser` 类型 +`companyId`/`companyName` |
|
||||
| `src/layout/topbar-model.ts` + `AdminLayout.vue` | 顶栏显示当前公司名 |
|
||||
|
||||
### 5.2 `frontend-vue`(用户端 app-web)
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `src/shared/api/user.ts` | `LoginData` +`companyId` / `companyName` |
|
||||
| `src/shared/auth/company-identity.ts`(新建) | 公司名的 localStorage 读写:后端没带 `companyName` 就删键,避免换账号后残留上一个账号的公司 |
|
||||
| `src/shared/auth/ensure-auth.ts` | `check_login` 恢复登录态时一并回写公司名(该文件原本只恢复 `uid`/`username`,见 `:25-39`) |
|
||||
| `src/pages/login/DesktopLoginPage.vue` | 登录成功后写入公司名;`?logout=1 / ?switch=1` 那段清登录态时**连 `company_name` 一起清**(原本只清 token/uid/username) |
|
||||
| `src/shared/auth/kick-handler.ts` | 被顶下线(`handleKicked`)时连 `company_name` 一起清,与 uid/username 同一批 |
|
||||
| `src/pages/amazon/components/AmazonTopBar.vue` | 顶栏用户名左侧显示公司名;为空则整段不渲染 |
|
||||
|
||||
### 5.3 发布耦合
|
||||
|
||||
`admin-frontend-vue` 与后端 jar **不必同批**——因为 §2.2 把 `companyId` 做成"缺省 = 操作者所属公司",旧后台建号仍然可用(落操作者自己公司)。这是刻意的设计,目的就是消掉 §8.2 那个混合版本窗口。
|
||||
`frontend-vue` 同理可独立发布:后端未返回 `companyName` 时顶栏不显示该段即可,不要写成 `undefined`。
|
||||
|
||||
---
|
||||
|
||||
## 6. 护栏与验收
|
||||
|
||||
### 6.1 建号必写 company_id
|
||||
|
||||
用例:建号后断言落库行的 `company_id` 等于期望值(超管指定 / admin 落自己公司 / admin 指定他司被拒)。
|
||||
**变异自证**:把 `entity.setCompanyId(...)` 删掉,用例必须红——若仍绿说明用例在验 DEFAULT 而不是验代码,等于没验。
|
||||
|
||||
### 6.2 公司边界不变式
|
||||
|
||||
`AdminUserMoveCompanyTest` 8 例(建号那批用例见 §6.1;移人写进 `AdminUserService.updateUser`):
|
||||
|
||||
| 用例 | 钉住的行为 |
|
||||
|---|---|
|
||||
| `movingAloneIsAValidEdit` | 只传 `companyId`、不改密码/角色/权限,也是合法编辑(原代码的"请提供要修改的内容"会把这种请求打回) |
|
||||
| `moveIsRefusedWhenTheCreatorLivesInAnotherCompany` | 创建人在第三家公司 ⇒ 403 且**一条 UPDATE 都不发** |
|
||||
| `creatorSuperAdminIsExemptFromTheCompanyMatch` | 创建人是超管 ⇒ 不受同公司约束 |
|
||||
| `onlySuperAdminMayMoveAccounts` | 公司内 admin 传别家公司 ⇒ 403,不静默改写 |
|
||||
| `namingTheCurrentCompanyIsNotAMove` | 传的正好是账号现属公司按"没动"处理,照常改密码(幂等请求不该被判越权) |
|
||||
| `destinationCompanyMustExistAndBeActive` | 目标公司先 `requireActive` 再落库 |
|
||||
| `danglingCreatorBlocksTheMove` | `created_by_id` 悬空(创建人已删)⇒ 无法确认同公司,不移 |
|
||||
| `nullCreatedByIdMovesWithoutComplaint` | `created_by_id` 本来就空 ⇒ 没有冲突可校验,照移 |
|
||||
|
||||
不变式内容:**账号被移进 X 公司后,它的 `created_by_id` 要么仍是 X 公司的人,要么是超管**。
|
||||
这条是 §7.2 里"77 处 `eq(getUserId, userId)` 无需逐个改"的前提,破口就得回到逐出口补边界那条路。
|
||||
|
||||
一期**没做移人的前端入口**:账号列表只有公司列 + 超管筛选(§5.1),移人是后台手工动作,
|
||||
接口 `PUT /api/admin/user` 的 `companyId` 字段已就绪,UI 留给二期和公司目录一起出。
|
||||
|
||||
> 踩过的坑(写下一条同类用例前先看):`LambdaUpdateWrapper.getSqlSegment()` **只含 WHERE**,
|
||||
> SET 子句在 `getSqlSet()` 里。最初四条断言打在 `getSqlSegment()` 上,实际拿到的是
|
||||
> `(id = #{ew.paramNameValuePairs.MPGENVAL2})`——"改了哪一列"这一整组断言恒假红,
|
||||
> 而"没移人不许带 company_id"那条恒绿。断"这次真的写了哪一列"只能取 `getSqlSet()`。
|
||||
|
||||
### 6.3 DEFAULT 摘除告警(防「半套发布」)
|
||||
|
||||
`users.company_id DEFAULT 1` 是**临时**的,只为混合版本窗口存在。**V144 已经把它摘掉**(`MODIFY COLUMN company_id bigint NOT NULL`,不带 DEFAULT),
|
||||
所以本节现在盯的是「回潮」:半套发布、老 dump 重建、手工 `SET DEFAULT` 都会让库里又出现一个默认值——
|
||||
此后每个不显式传公司的建号被静默塞进那一家。
|
||||
启动期巡检:`SELECT COUNT(*) FROM company` > 1 **且** `users.company_id` 仍有 DEFAULT → 打 ERROR(纳入 `_prod_watch.py` 巡检 ALERTS)。用代码执行,不写进注释。
|
||||
|
||||
> **哨兵不能当 V144 的验收项**:`singleCompanyKeepsQuiet` 故意让"只有一家公司"时闭嘴(一期就是这个状态,否则每次重启都白喊)。
|
||||
> 而 V144 上线时库里恰好只有 1 家公司 ⇒ 摘没摘成功,哨兵一律不响。唯一复核手段是 `SHOW COLUMNS FROM users LIKE 'company_id'`
|
||||
> 看 `Default` 是否为 NULL——这就是 V144 头注释必须自带验证 SQL 的理由(§3、`CompanyMigrationV144Test.v144ShipsPostDeployVerificationSql`)。
|
||||
|
||||
`CompanyDefaultGuard`(`@EventListener(ApplicationReadyEvent.class)`)8 例:
|
||||
|
||||
| 用例 | 钉住的行为 |
|
||||
|---|---|
|
||||
| `secondCompanyWithDefaultStillOnShoutsError` | 2 家公司 + DEFAULT="1" ⇒ ERROR 带 `COMPANY_DEFAULT_STILL_PRESENT` 与公司数 |
|
||||
| `singleCompanyKeepsQuiet` | 只有一家公司时 DEFAULT 是发布期故意留的(§8.2),不许喊 |
|
||||
| `droppedDefaultKeepsQuiet` | `COLUMN_DEFAULT` 为 null ⇒ 已摘除,一声不响 |
|
||||
| `blankDefaultCountsAsDropped` | 空串/空白也按"已摘除"处理 |
|
||||
| `noCompanyAtAllKeepsQuiet` | 0 家公司时**连列都不去查**(短路顺序也是断言对象) |
|
||||
| `probeFailureIsAnnouncedNotSwallowed` | 探针抛错 ⇒ WARN 带 `COMPANY_DEFAULT_PROBE_FAILED`,不许静默读成"检查过了" |
|
||||
| `probeReadsTheRightColumn` | 捕获真实 SQL,必须探 `information_schema.COLUMNS` 的 `'users'` / `'company_id'`(表名列名写错等于没探) |
|
||||
| `guardRunsWhenTheApplicationIsReady` | 反射断 `checkOnStartup` 上挂着 `@EventListener(ApplicationReadyEvent.class)`——漏注解这哨兵永远不跑 |
|
||||
|
||||
两个标记串故意用 **ASCII**:巡检是靠 `docker logs | grep -aiE` 匹配的,中文一旦在容器里变了编码整条签名静默失效。
|
||||
`scripts/_prod_watch.py` 的 `SIGNATURES` 增 `('公司DEFAULT未摘', 'COMPANY_DEFAULT_STILL_PRESENT', True)`(第 12 条,实跑 `scripts/tests` 全绿)。
|
||||
`COMPANY_DEFAULT_PROBE_FAILED` 故意**不**进 ALERTS:生产 MySQL 账号本就缺 `information_schema` 读权限(见运维要点),把它做成告警只会变成常驻噪声;它出现在 WARN 里,人工核查时看得到。
|
||||
|
||||
### 6.4 迁移自检
|
||||
|
||||
`MODIFY ... NOT NULL` 本身即闸门(§3)。
|
||||
文件层护栏落在 `backend-java/src/test/java/com/nanri/aiimage/config/CompanyMigrationV143Test.java`
|
||||
(12 例,逐条标注它防的是哪个破坏点;断言打在**剥掉注释后的可执行 SQL** 上,避免"注释里写了这句话就算通过"):
|
||||
版本号与撞号、头注释六项、`uk_company_name` 唯一、初始公司 id 钉死为 1、只允许 ALTER `users` 一张表、
|
||||
回填与闸门的先后、DEFAULT 仍在、菜单幂等与 `route_path`/父级、可重跑性、回滚在扫描路径之外、
|
||||
盘点文档三个数字与取号起点。变异自证 16 条(脚本注入缺陷 → 指定期望用例必须红 → 用注入前读进内存的字节还原)。
|
||||
变异清单:去 `IF NOT EXISTS`、去 `IGNORE`、把 `IF(@col_exists=0)` 改成无条件执行、初始公司 id 改 7、
|
||||
去掉 INSERT 的 `id` 列、删掉回填 UPDATE、把 NOT NULL 闸门提到回填之前、去掉闸门的 `DEFAULT 1`、
|
||||
`uk_company_name` 降级成普通索引、去掉菜单的 `NOT EXISTS`、`route_path` 改错、父级分组改错、
|
||||
给 `biz_shop_manage` 也加 `company_id`、把回滚写成 `V144__rollback_company.sql` 放进 `src/main/resources/db/`、
|
||||
盘点文档取号起点不跟着改、盘点文档文件数不跟着改。
|
||||
另跑 `MigrationInventoryTest` 确认版本连续、命名合规、历史校验和未变。
|
||||
|
||||
**V144 与前向修复契约**(`CompanyMigrationV144Test` 8 例 + 7 条变异自证,全部被咬死):
|
||||
|
||||
| 用例 | 钉住的行为 |
|
||||
|---|---|
|
||||
| `appliedMigrationBytesAreFrozenAgainstProdChecksum` | 按 Flyway 的 CRC32(逐 `readLine()` 的 UTF-8 字节、行尾不入 CRC)复算 V142/V143,必须等于生产 `flyway_schema_history.checksum`。**这是本次差点踩的地雷**:V143 已在 10:48:54 落库,原地把它的 `DEFAULT 1` 改掉,下一次启动就会校验失败、两台 java 都起不来 |
|
||||
| `migrationIsVersionedOneFourFour` | 摘 DEFAULT 只能是 V144(当前最大版本),不能回填已应用的号 |
|
||||
| `v144DropsTheColumnDefault` | `MODIFY COLUMN company_id` 子句里不许再出现 DEFAULT,且头注释要写清 1364 的取舍与 V143 的来源 |
|
||||
| `v144TouchesOnlyUsersCompanyIdAndIsRerunnable` | 只 ALTER `users`;不许 CREATE TABLE / DROP TABLE·COLUMN·INDEX / ADD COLUMN —— 它是**前向修复,不是回滚** |
|
||||
| `v144HeaderCarriesTemplateFieldsAndWhyItExists` | 模板六项 + 「已应用」+「校验和」,让评审一眼看出这是追加而非补漏 |
|
||||
| `v144ShipsPostDeployVerificationSql` | 自带 `SHOW COLUMNS ... LIKE 'company_id'` 且期望写成 `Default = NULL`(§6.3:哨兵在单公司时不响,这是唯一验收面) |
|
||||
| `defaultSentinelStillShipsAndWired` | V144 上线后 `CompanyDefaultGuard` 不许被当历史包袱删掉 |
|
||||
| `inventoryDocTracksV144` | 盘点文档要记录 V144 文件名与 `1539570901`,否则下一个人无从知道 V143 不能碰 |
|
||||
|
||||
变异清单(M1–M7,`backend-java/target/mut_v144.py` + `mut_v144.sh`):把 `DEFAULT 1` 加回 MODIFY 子句、整条 ALTER 删掉、`MODIFY COLUMN` 改成 `ADD COLUMN`、验证段期望 `Default = NULL` 改成 `= 1`、头注释不再点名哨兵签名、删掉「已应用」口径、**原地改 V143 摘掉 DEFAULT**。
|
||||
最后一条是给冻结护栏本身做的红证:`8136eea9…` 注入后红的不是一堆用例,而恰好是 `appliedMigrationBytesAreFrozenAgainstProdChecksum` 一条。
|
||||
|
||||
> 同一轮里 `CompanyMigrationV143Test#migrationIsVersionedOneFourThree` 里那句"V143 必须是当前最大版本"被删掉了 —— V144 落盘后它是假前提(V143 已封死,不可能再是最大号)。号段连续性与撞号仍由 `MigrationInventoryTest` 把守,不是没人管了。
|
||||
|
||||
### 6.5 公司目录:读写收窄与出厂一致性(§2.3)
|
||||
|
||||
后端 4 个测试类共 26 例(`mvn -o test -Dtest="Company*Test"`):
|
||||
|
||||
| 测试类 | 例数 | 钉住的行为 |
|
||||
|---|---|---|
|
||||
| `CompanyServiceDirectoryTest` | 17 | 超管列全部(**不带任何查询条件**)、公司内 admin 只列自己公司、无角色与无公司归属一律 403、`admin_companies` 菜单闸门、写接口仅超管、名称 trim + 唯一(改名校验排除自身)+ 不超列宽、备注不超列宽、状态只能是 0/1 |
|
||||
| `CompanyControllerEndpointTest` | 5 | 每个 handler 先 `requireAdminOrInternal` 再碰目录(`InOrder` 断言调用次序)、路由与后台前端逐字一致、**不暴露 DELETE**、列表返回 VO 而非实体、写接口回保存后的公司 |
|
||||
| `CompanyVoTest` | 1 | 过真 `ObjectMapper` 序列化,键名恰好 `id/company_name/status/remark/created_at/updated_at`,日期 `yyyy-MM-dd HH:mm`、空日期出 `""` |
|
||||
| `CompanyServiceRequireActiveTest` | 3 | `requireActive`(§2.2 那批用例):本轮只把构造器补到 3 参,断言未动 |
|
||||
|
||||
前端 2 个文件共 15 例:`tests/company-user-list.test.ts`(7,含一条**反向排他**——解析器读到 camelCase `companyId/companyName` 必须忽略,防止前后端各猜一套)、`tests/company-user-create.test.ts`(8)。
|
||||
|
||||
实跑证据(2026-10-04 04:45–05:11;日志文件属 `target/` 产物,收尾已删,下面的数字取自当轮回显):
|
||||
`baseline: 26 例全绿` → 16 条变异 **16/16 KILLED**(每条都打印了它红的那一例)→
|
||||
`restore check: all files byte-identical to pre-injection`(三个文件还原后 sha1 与注入前逐字节一致)→
|
||||
`SURVIVORS/PROBLEMS: 0`、`PY_RC=0`。
|
||||
|
||||
16 条变异自证(脚本注入缺陷 → 指定的那几例必须红 → 用**注入前读进内存的字节**还原,不许 `git checkout`):
|
||||
`admin-directory-loses-own-company-filter`、`super-admin-directory-also-filtered`、`admin-without-company-falls-back-to-all`、
|
||||
`menu-gate-removed`、`role-gate-removed`、`super-admin-write-gate-removed`、`company-name-not-trimmed`、
|
||||
`duplicate-name-check-removed`、`duplicate-check-includes-self`、`status-range-check-removed`、`name-length-check-removed`、
|
||||
`remark-length-check-removed`、`vo-loses-snake-case-name`、`controller-create-skips-auth`、
|
||||
`controller-gets-a-delete-endpoint`、`controller-route-typo`。
|
||||
|
||||
两条踩过的坑,留给后续同类用例:
|
||||
|
||||
- **断言要打在"有没有带值的条件"上,不是打在列名上**。`company` 表压根没有 `company_id` 列,最初写的
|
||||
`getSqlSegment()).contains("company_id")` 一条恒假、配套的"超管不带条件"一条恒真,两条一起绿等于没断言。
|
||||
改成 `getParamNameValuePairs()).isEmpty()`(超管)对 `containsValue(2L)`(公司内 admin)。
|
||||
另两个 API 坑:`Wrapper` 不暴露 `getParamNameValuePairs()`,捕获类型必须是 `LambdaQueryWrapper`;
|
||||
且要先碰一次 `getSqlSegment()` 参数才会被铺出来。MP 3.5.7 的 `insert`/`updateById` 有 `Collection` 重载,
|
||||
`any()` 有歧义,必须写 `any(CompanyEntity.class)`。
|
||||
- **变异脚本每轮开跑前要把所有被注入的文件写回 pristine**(实测两批都栽了)。第一版只在 `finally` 里统一还原,
|
||||
于是每轮只重写"本轮那个文件":第 13 轮改 `CompanyVo` 时,第 12 轮改 `CompanyService` 的缺陷还留在盘上,
|
||||
红名单里混进上一轮的用例 ⇒ 日志里"红名单共 N 例"这个数字整批失真。
|
||||
16 条 KILLED 本身仍可采信,因为**每条变异期望红的那一例都只在自己那一轮出现**(已按用例名做过归因矩阵);
|
||||
但要是两轮期望的用例同名,就会被静默假判 KILLED。脚本已补上"逐轮回写 pristine"。
|
||||
- **变异脚本的锚点在 Windows 上要先对齐行尾**。源码是 CRLF,`decode("utf-8")` 不转换行尾,锚串里的 `\n`
|
||||
会 0 命中 ⇒ 注入静默失败 ⇒ 那一轮"没红"会被误读成"变异存活"。脚本因此加了 `align()` 和
|
||||
`--check-anchors` 预检(16 条锚点全部 hits=1 才开跑)。
|
||||
|
||||
### 6.6 第二批变异自证:登录态、移人、启动哨兵、列表公司列
|
||||
|
||||
覆盖 §2.4(登录/current-user 带出公司身份)、§6.2(移人不变式)、§6.3(DEFAULT 哨兵)、§2.3(列表公司列与筛选),
|
||||
被注入的 7 个类共 **39 例**(首轮 37 例,补进 2 例后 39 例)。脚本 `target/mutation_company_phase2.py`,表内 29 条变异
|
||||
(条目数由 AST 数出,不是手数),开跑前 `anchor pre-check: 29/29 锚点各命中 1 次`。
|
||||
|
||||
首轮实跑(2026-10-04 06:02–06:47,日志 `target/mutation_phase2.log`):
|
||||
|
||||
```
|
||||
baseline: 37 例全绿(报告 7 份,rc=0)
|
||||
SUMMARY: 25/28 KILLED, SURVIVED=2 ['names-by-ids-loses-dedupe', 'move-gate-for-company-admin-removed'],
|
||||
INCONCLUSIVE=1 ['move-only-request-rejected-as-empty-edit'], restore_ok=True
|
||||
PY_RC=1
|
||||
```
|
||||
|
||||
三条问题全部是**用例侧/脚本侧**的洞,不是实现有缺陷(实现一行没改):
|
||||
|
||||
- `names-by-ids-loses-dedupe` 存活:`AdminUserListCompanyTest` 把 `CompanyService` 整个 mock 掉了,
|
||||
捕获的是**调用方传出去的参数**,永远摸不到 `namesByIds` 内部的去重。全仓 grep 证明没有任何用例用**真实对象**
|
||||
调过这个方法 ⇒ 这条被注释宣称的护栏从未被证明过。修法:`CompanyServiceNameLookupTest`(真实 `CompanyService`
|
||||
+ mock mapper)补 2 例——重复 id 折成一次查询且 `IN` 参数每家公司只出现一遍(用 `in(col, coll)` 每元素一个
|
||||
MPGENVAL 参数来钉去重)、空列表与 `null` 一条 SQL 都不发。
|
||||
- `move-gate-for-company-admin-removed` 存活:断言写的是 `contains("公司")`,而"移人闸门"与"创建人同公司不变式"
|
||||
两条 403 文案**都含"公司"**——删掉闸门后仍由后者抛 403,用例"因为错的原因过"。修法:两条断言各钉自己的文案
|
||||
(`contains("超级管理员")` / `contains("创建人")`)。
|
||||
- `move-only-request-rejected-as-empty-edit` INCONCLUSIVE:变异串本身不是合法 Java(整行替换成 `)` 丢了 `{`
|
||||
⇒ 花括号失衡 ⇒ 编译失败 ⇒ 压根没有报告)。4 次尝试全 rc=1 且无 `TEST-*.xml` 即为此症。修法:替换串保留花括号。
|
||||
|
||||
修补后只复跑受影响的 4 条(06:53–07:00,`target/mutation_phase2b.log`,`--only` 过滤后"表内 29 条,本轮跳过 25 条"):
|
||||
|
||||
```
|
||||
baseline: 39 例全绿(报告 7 份,rc=0)
|
||||
[04] names-by-ids-loses-dedupe KILLED red=1/39 期望红=命中=batchLookupSendsEachCompanyIdOnce
|
||||
[05] names-by-ids-queries-on-empty-input KILLED red=1/39 期望红=命中=batchLookupOnEmptyInputSkipsTheTable
|
||||
[11] move-only-request-rejected-as-empty-edit KILLED red=5/39 期望红=命中=movingAloneIsAValidEdit
|
||||
[13] move-gate-for-company-admin-removed KILLED red=1/39 期望红=命中=onlySuperAdminMayMoveAccounts
|
||||
SUMMARY: 4/4 KILLED, SURVIVED=0, INCONCLUSIVE=0, restore_ok=True(表内 29 条,本轮跳过 25 条)
|
||||
PY_RC=0
|
||||
```
|
||||
|
||||
两个 7 文件的还原读数(首轮与复跑一致,sha256 前 12 位与注入前逐项相同):`CompanyService.java`
|
||||
`93513896eb9a`、`AuthService.java` `d35d7715b509`、`AdminConsoleController.java` `9102c2967947`、
|
||||
`AdminUserService.java` `cf1d200c49ee`、`CompanyDefaultGuard.java` `2900ed07c35c`、`AdminUserItemVo.java`
|
||||
`8ee2c28e9c9f`、`AdminUserController.java` `5849f9b48b39`,全部 `byte-identical`。
|
||||
复跑后 `13` 那轮的红名单恰好只有 `onlySuperAdminMayMoveAccounts` 一例——这本身就是"断言收紧后只咬它自己那条闸门"的证据。
|
||||
|
||||
29 条变异清单:`name-or-empty-queries-on-null-id`、`name-or-empty-throws-when-company-missing`、
|
||||
`name-or-empty-hides-disabled-company`、`names-by-ids-loses-dedupe`、`names-by-ids-queries-on-empty-input`、
|
||||
`login-loses-company-name`、`login-loses-company-id`、`login-gates-on-company-active`、
|
||||
`current-user-company-key-snake-cased`、`current-user-drops-company-identity`、
|
||||
`move-only-request-rejected-as-empty-edit`、`same-company-naming-treated-as-a-move`、
|
||||
`move-gate-for-company-admin-removed`、`move-target-company-existence-unchecked`、`creator-invariant-check-removed`、
|
||||
`super-admin-creator-not-exempted`、`null-creator-blocks-the-move`、`move-does-not-write-the-column`、
|
||||
`admin-cross-company-filter-falls-through`、`super-admin-filter-adds-no-condition`、
|
||||
`unknown-company-row-crashes-the-item`、`empty-page-still-asks-for-names`、`item-vo-company-name-loses-snake-case`、
|
||||
`company-filter-param-becomes-required`、`guard-threshold-off-by-one`、`guard-treats-blank-default-as-dropped`、
|
||||
`guard-probe-failure-is-swallowed`、`guard-never-runs-on-startup`、`guard-probes-the-wrong-column`。
|
||||
|
||||
新增一条规矩(第一条就栽过):**变异点落在被 mock 掉的依赖内部,用例必然咬不住**。判存活时先怀疑 mock 边界,
|
||||
再怀疑脚本;这类护栏要用真实对象另建一组用例,注释里写"已覆盖"不作数。
|
||||
|
||||
### 6.7 全量回归
|
||||
|
||||
`mvn test`(不许 skipTests、主树禁 clean):**2026-10-04 07:09 全量实跑 `Tests run: 3589, Failures: 0, Errors: 0, Skipped: 7`,`BUILD SUCCESS`,耗时 04:52**(日志 `target/mvn_full.log`,收尾已删)。
|
||||
+ `scripts/tests`(2026-10-04 06:12 实跑 **155 passed**,设计文档早前写的 137 已过期)+ `admin-frontend-vue` 的 `npm test`(06:25 复跑 **1678/1678**,RC=0)+ `frontend-vue` 的 `npm test`(06:20 复跑 **672/672**,RC=0,含本轮新增的下线清键 1 例)+ 两个前端各自的 `npm run build`(build 脚本自带 `vue-tsc --noEmit`,`frontend-vue` 06:21 RC=0,`admin-frontend-vue` 06:35 RC=0)。
|
||||
**这一轮全量绿是在「本批公司改动 + 另一批未提交的 task-center 改动」的同一棵工作区树上跑出来的**,提交只含前者。
|
||||
两者互不依赖已逐个取证:task-center 那 8 个改动/新增的 java 文件里 `compan` 关键词逐个文件命中 0 行(逐文件 `grep -ci`,不是全树一次过),本批改动的文件零引用 `taskcenter`;
|
||||
本批唯一改签名的方法 `AdminUserService.listUsers`(加 `companyIdFilter` 形参)在 HEAD 与工作区都只有
|
||||
`AdminUserController` 一个调用方,而它就在同一笔提交里;其余改动是纯增字段。
|
||||
提交子集已在**干净 worktree**(detached @ `27859af8`,补了 gitignore 的三处文档与 `application-local.yml`)单独跑过一遍全量,见下面的「V144 轮」。
|
||||
本批 V144 这一轮补做了那条「更硬的证据」:**`27859af8` 检出到干净 worktree(`git worktree add --detach`,工作区 0 脏件)全量实跑
|
||||
`Tests run: 3597, Failures: 1, Errors: 0`**(比 07:09 那轮多 8 例 = `CompanyMigrationV144Test` 的 8 例)。
|
||||
唯一一条红是 `TxDurationBenchmarkTest#measurementRepeatableWithinTolerance`(`两次测量偏差过大: 500 vs 1900`,容差 `upper <= lower*3`),
|
||||
**已归因为计时假红、不是回归**:同一台机器上把 BASE(`c4a35c64`,无 V144)与 GATE(`27859af8`,含 V144)各放一个干净 worktree,
|
||||
`mvn -o -B test -Dtest=TxDurationBenchmarkTest` 隔离单跑两轮,四跑全绿——BASE 8/0(16.79s / 29.18s)、GATE 8/0(15.24s / 30.47s),逐轮 `MVN_RC=0`。
|
||||
这条用例在全量套件里跑=和 3590 例抢 CPU,本来就脆(与「门禁不要与 Nuitka 打包并行」同源)。
|
||||
顺带一条读数坑:**主树并发**跑门禁时另一路会话同树 mvn 会换掉 `target/classes`,那一轮读到 `3592 例 / 12 errors`、
|
||||
`NoClassDefFoundError: TaskEntityLocalCache$Entry`——隔离复跑同类 16 例全绿,所以那不是回归,是并发污染。
|
||||
**e2e 没跑**:`admin-frontend-vue` 的 Playwright 用例(`e2e/*.spec.ts`,`npm run test:browser`)要起着前端与后端才成立,本轮未起服务,公司目录页也没有对应 spec——这一条是缺口,不是已通过项。
|
||||
SFC 那一行清键(`DesktopLoginPage.vue` 的登出/切号分支)没有自动化用例覆盖:`handleKicked` 那条有,另一条靠人肉读代码确认。
|
||||
既有红按差分读,不当回归:客户端批量测试有 8 例既有红、task_220 有 3 例既有红(已用干净 HEAD worktree 证实)。
|
||||
门禁不要与 Nuitka 打包并行跑(计时用例会假红)。
|
||||
|
||||
---
|
||||
|
||||
## 7. 二/三期路线(已定案的口径,防止丢失)
|
||||
|
||||
### 7.1 唯一索引与登录(必须同批)
|
||||
|
||||
`users.username` 唯一索引 → `UNIQUE (company_id, username)`。一旦允许跨公司同名:
|
||||
|
||||
1. `AuthService.java:94` 的 `selectOne(eq(username))` 会抛 `TooManyResultsException`,**登录全站挂** → 改为按 username 查列表,命中 1 条放行、多条要求指定公司(`LoginRequest` 加 `company`)。缺省不带公司时行为与现状完全一致。
|
||||
2. `AuthService.java:50-78` 锁定 key 从裸 `username` 改为 `companyId|username`。否则新公司建个同名账号反复错密码,就能把厦门米椿花的真人锁在门外——**跨租户 DoS,不是可选优化**。
|
||||
|
||||
这两条与索引切换必须同一次发版,任何一条滞后都是线上事故。
|
||||
|
||||
### 7.2 数据隔离(方案②:中央 scope + 逐出口接入 + 护栏)
|
||||
|
||||
- `CompanyScopeSupport`:`currentCompanyId(user)` / `memberUserIds(companyId)` / `assertSameCompany(...)`;`role=super_admin` 豁免(**按 role 判,不按 company_id 判**)
|
||||
- 需要叠公司边界的是**范围大于一人**的出口:5 套并行 scope(9 文件 37 处)、27 文件 219 处 super_admin 分支中「看全部」的部分、3 处集合式过滤、`AdminUserService.listUsers` 超管分支
|
||||
- 77 处 `eq(getUserId, userId)` 由 §2.2 的 `created_by_id` 同公司不变式覆盖,**无需逐个改**
|
||||
- 护栏:AST/正则扫描——对公司归属表的 `getUserId` 过滤若未走 scope 即红;变异自证(把 `in` 改回 `eq`、删掉超管豁免,必须被抓到)
|
||||
- 不给业务表冗余 `company_id`:与「数据按账号归属、公司维度跟着账号走」的定案相反。若日后 `IN (成员列表)` 在热表上撑不住,再单独议是否给那两三张表冗余
|
||||
|
||||
### 7.3 14 个用户态前缀的越权收口
|
||||
|
||||
`user-tool-guard-enabled` 默认 false(§1.3)。打开前必须先逐端点审计客户端是否带令牌,漏审一个就是线上集采/跟价全线 401——这正是当初把开关默认设成 false 的原因。
|
||||
且共享静态内部令牌**证明不了 user_id 是谁**,所以真正的公司隔离要等阶段B 设备令牌。建议与阶段B 绑成同一张工单。
|
||||
|
||||
---
|
||||
|
||||
## 8. 风险与回滚
|
||||
|
||||
### 8.1 迁移失败
|
||||
|
||||
`MODIFY ... NOT NULL` 抛错 → Flyway 标记该版本 failed,应用启动失败。恢复:补齐漏掉的行,`flyway repair` 清 failed 记录后重启。
|
||||
**不要手工改已应用迁移的文件内容**——`spring.flyway.validate-on-migrate=true` 是硬编码(`/app/java/application-server.yml` 没 pin 过它),
|
||||
改一个字节 ⇒ 下次启动 `DbValidate` 报校验和不匹配,两台都起不来。这条不再是口头纪律:
|
||||
`CompanyMigrationV144Test.appliedMigrationBytesAreFrozenAgainstProdChecksum` 会按 Flyway 的 CRC32 复算 V142/V143 并与生产存量校验和(`1152261840` / `1539570901`)比对,原地改就在 `mvn test` 阶段红。
|
||||
|
||||
这条恢复路径成立的前提是 **V143 每条语句都可重跑**:DDL 失败时前面的语句已经落库,repair 后 Flyway 会从文件第一条重新执行。所以建表带 `IF NOT EXISTS`、种子行 `INSERT IGNORE`、`ADD COLUMN` 先查 `information_schema` 再 `PREPARE`(§3)。若写成裸语句,重启会在恢复路上撞 1050/1060/1062,只剩"手工清库"一条路——这也是 `CompanyMigrationV143Test.migrationIsRerunnableAfterPartialFailure` 存在的理由。
|
||||
|
||||
### 8.2 混合版本窗口(DEFAULT 曾为此存在,现已由 V144 摘除)
|
||||
|
||||
发布期间一台已上新 jar、另一台仍是旧 jar,而 `/api` 经主机 B 的 clb 打到两台。旧 jar 的 `AdminUserService.create` 不给 `company_id` 赋值:
|
||||
|
||||
- 列若为 `NOT NULL` 无 DEFAULT → 严格模式报 `Field 'company_id' doesn't have a default value`,**打到旧节点的建号请求全失败**(约一半)
|
||||
- 列有 `DEFAULT 1` → 旧节点建号成功并落厦门米椿花。一期只有一家公司,这个结果**是正确的**,不是 bug
|
||||
|
||||
**两台同版后 DEFAULT 就成了死重,而且是有害的死重**:任何绕过 `createUser` 的写入(手工 SQL、将来漏改的入口、回滚到带 company 模块之前的 jar)都会被静默塞进厦门米椿花。
|
||||
所以定案是**宁可撞 1364 炸在日志里,也不要静默归错公司** ⇒ 写成 V144 前向修复摘掉它。
|
||||
摘完之后这条窗口的代价反过来:如果哪台退回到不带 company 模块的 jar,它的建号会报 1364 而不是悄悄归到公司 1——那是**响着失败**,不是静默失真,符合定案。
|
||||
`users` 表除 `AdminUserService` 之外还有没有写入口,见 §10 的枚举结论。
|
||||
|
||||
### 8.3 回滚
|
||||
|
||||
补丁脚本 `backend-java/docs/rollback-V143-company.sql`,**不是一条版本化迁移**——版本化迁移放进 `src/main/resources/db/` 就会被 Flyway 在下次启动时自动执行,那等于把 V143 静默撤销掉,还会让 `MigrationInventoryTest` 的版本连续性断言跟着变。执行顺序(停两台应用 → 跑脚本 → 删 `flyway_schema_history` 的 143 行 → 回退 jar → 起应用)写在脚本头部;漏掉删历史那步,将来重装带 V143 的 jar 时 Flyway 判定"已应用"直接跳过,表和列都不会重建,而 Java 侧实体照常读写 `company_id` ⇒ 运行期 unknown column。
|
||||
回滚窗口内已建的账号会连 `company_id` 一起丢,业务数据不受影响(业务表从未加列)。
|
||||
**要区分两种"下一条迁移"**:V144 是**口径前向修复**(摘 DEFAULT,库往更严格的方向走),回滚是**撤销已应用的那一笔**——只有前者可以做成版本化迁移,后者永远只能人工按顺序执行。回滚 V144 同样不进扫描路径:重设 `DEFAULT 1` + 删历史里 `version='144'` 那一行,步骤写在 V144 头注释第 5 项。
|
||||
这条"回滚不进 Flyway 扫描路径"的口径连同上一条"迁移必须可重跑",一并写进了 `backend-java/docs/migration-inventory.md` 的「约束」段,供后续所有迁移引用。
|
||||
|
||||
---
|
||||
|
||||
## 9. 待确认(一期按下列默认口径已实现,若要改请在此推翻)
|
||||
|
||||
1. **不加 `company_code`**。一期没有任何消费点:目录页、建号下拉、顶栏显示全都用 `company_name`。
|
||||
二期登录定位若真遇到跨公司同名账号,让用户在"先选公司"的下拉里挑比记短码更直观,短码只会多一处唯一索引 + 录入校验。
|
||||
2. **两端都显示公司名**——后台 `AdminLayout.vue` 用户名下方一行、用户端 `AmazonTopBar.vue` 用户名左侧,均已在做(§5.1/§5.2)。
|
||||
两处都是"后端没带 `companyName` 就整段不渲染",不显示 `undefined`。
|
||||
3. **既显示列,也支持筛选**(§2.3 口径已实现)。筛选下拉**仅超管可见**:公司内 admin 的读接口已被后端收窄到本公司,
|
||||
给它一个只能选到自己公司的筛选框是假功能。
|
||||
4. **公司内 admin 一期仍只看自己名下 1 层账号**(`AdminUserService.java:92-102` 现状不变:列表的非超管分支只放行「自己」或「自己创建的 normal」)。
|
||||
一期定案是"业务代码零改动",把可见范围放宽与 89 处数据出口叠公司边界放到同一批(§7.2);
|
||||
因此公司目录页对 admin 只显示自己这一家,**不承诺**"看见本公司全部账号"。
|
||||
|
||||
---
|
||||
|
||||
## 10. `users` 写入口枚举(V144 摘 DEFAULT 的影响面)
|
||||
|
||||
列默认值只在 **INSERT 省略该列**时生效——UPDATE / DELETE 与它无关。所以"摘掉 DEFAULT 会不会把线上写挂"这个问题
|
||||
只需要数清 `users` 的 INSERT 有几条。取证口径:`@TableName("users")` 的两个实体(`AdminUserEntity`、`LoginUserEntity`)
|
||||
→ 两张 `BaseMapper` → 全部写调用;再排除同名前缀的别的表(`user_notification`、`user_column_permission`、`user_api_secret` 都与 `users` 无关)。
|
||||
|
||||
| 位置 | 操作 | 摘掉 DEFAULT 之后 |
|
||||
|---|---|---|
|
||||
| `AdminUserService.java:186 adminUserMapper.insert(entity)` | **唯一的 INSERT** | 不受影响:`:184` 恒调 `resolveTargetCompanyId(...)`,任何分支都返回一个具体值并写进实体(超管不传 → 落自己公司;公司内 admin → 落自己公司或 403) |
|
||||
| `AdminUserService.java:323 adminUserMapper.update(...)` | 改账号(移公司 / 改密码 / 改角色) | UPDATE,与默认值无关;`company_id` 只在"真的要移人"时才进 `SET` 子句 |
|
||||
| `AdminUserService.java:391 adminUserMapper.deleteById(uid)` | 删号 | 无关 |
|
||||
| `AuthService.java:109 loginUserMapper.update(...)` | 登录链路写回 | 无关 |
|
||||
|
||||
- **没有任何 SQL 层的写路径**:`src/main/resources` 下**不存在** MyBatis XML mapper(整棵 resources 只有 `logback-spring.xml` 一支 xml),两个 Mapper 接口是空的 `BaseMapper` 子接口、注解 SQL(`@Insert/@Update/@Delete`)命中 **0** 处。
|
||||
⇒ `users` 的写只能来自这两个实体的 `BaseMapper` 调用,上表就是全集,不是"grep 没搜到所以没有"。
|
||||
- 非 Java 通道只有一份基线 dump(原 `src/main/resources/db/aiimage.sql`,2026-10-07 已移出仓库,现只在本地 gitignored 的 `backend-java/data/aiimage.sql`)——`INSERT INTO users VALUES (...)`,全列显式、且早于 V143 所以不带这一列。用它重建库时列由 V143 加、默认值由 V144 摘,顺序上成立。
|
||||
⚠ 顺带记一笔:这份 dump 含全体账号的 `pbkdf2:sha256:1000000$...` 口令散列,已在 git 里(非本次引入),将来要动 `users` 相关的对外交付时得把它算进暴露面。
|
||||
|
||||
**结论**:Java 侧不会因为 V144 新增任何 `1364`。剩下的暴露面全部在应用之外——手工 SQL、别的进程直连库、dump 重建——
|
||||
而那些正是我们**希望**它们报错的路径(§8.2)。
|
||||
@@ -1,245 +0,0 @@
|
||||
# 公司 tab(超管按公司看数据)+ 公司配置读写只超管 —— 设计
|
||||
|
||||
日期:2026-10-04
|
||||
状态:**批次 0-1 已实施**(计划 `docs/plans/19-company-tab.md` Task 1-12 出厂,Task 13 变异自证见 `backend-java/docs/mutation-company-tab.md`;人工实跑清单与上线命令另计)。**批次 2/3 由另一路会话在实施**(去重库/品牌库/查询ASIN/最低价ASIN/商品类目 + `V147`),本文件不替它写任务。
|
||||
关于 V145(§12 第 1 条当时留的那个决定):**它不是本批带的**——V145 早在 10-05 18:3x 那版 jar(出包树 `a9c74b9a`)之前就随历史进入生产,生产 Flyway 现 146;也就是"两张规则库表补 `company_id` + 唯一键改每公司一套"已落地,而它的消费侧正是上面那路批次 2/3。跨公司串扰的窗口因此由那一路收口,不由本批。
|
||||
线上现状(`git diff a9c74b9a..HEAD` 逐文件核过,10-06 00:0x):**批次 0-1 的大部分已经在这版线上 jar/构建里**——`DataReadScope`、日志管理与店铺管理两页的接线、以及前端 `src/layout/CompanyTabs.vue`(`AdminLayout.vue` 已挂载它,两处引用)都在出包树 `a9c74b9a` 中。**还没上线的只有一支功能提交** `3654d022`(任务看板五个端点按公司筛:`AdminTaskCenterController` + `TaskCenterScopeService`);其余 `a9c74b9a..HEAD` 的后端 `src/main` 改动(共 8 支,另 6 支为角色叫法/文案与按需注册修复)来自另一路会话。这一段区间**新增迁移 0 支**(`git diff --name-only a9c74b9a..HEAD -- backend-java/src/main/resources/db` 为空)⇒ 下一版 jar 不会动 Flyway 版本;`V147__product_category_company_scope.sql` 属批次 2/3,此刻仍未跟踪,一旦提交进区间,上线口径要重算。
|
||||
需求来源:用户三句话,逐字记录
|
||||
1. 「公司管理和创建用户选公司只能超管才能看到」
|
||||
2. 「除了超管都不能操作公司配置 读写都不行」
|
||||
3. 「前端改一下 超管通过tab看不同公司的数据,其他菜单也是这样(去重数据库之外的菜单)」(附「去重数据汇总」页截图,面包屑那一行画了四个空红框 = tab 位置)
|
||||
|
||||
已定的两个口径(用户选的,不是我推荐的):
|
||||
- 范围:**一次铺完 16 页**,分 3 批发布(我推荐的 5 页首批被否)。
|
||||
- 默认:**默认选中第一家,不允许「全部」**(我推荐的"默认全部"被否)。
|
||||
|
||||
配套文档:一期 `company-multi-tenant-design-2026-10-04.md`;二期(品牌库/去重库)`brand-dedupe-company-isolation-design-2026-10-04.md`。本方案**不依赖**二期落地,但批次 3 的两页要用二期的物化列。
|
||||
|
||||
---
|
||||
|
||||
## 1. 先更正一条我上一轮说错的事实
|
||||
|
||||
我说过"生产 `company` 表只有 1 行 ⇒ tab 上线只有一个标签"。**这句是错的**,来源是我的 13:5x 记忆快照,而 V145 头部记的是 15:0x 实查:
|
||||
|
||||
> `company` 表今天有两行(1=厦门米椿花、2 于 10-04 14:55 开通),第 2 家只有 1 个管理员账号(`users.id=1193`)、0 个任务、0 行去重数据。
|
||||
|
||||
两个后果,都比"tab 好不好看"更要紧:
|
||||
- tab 今天就有真实内容,不是空壳演示。
|
||||
- **二期的 `company_id DEFAULT 1` 摘除倒计时已经触发**(V145 头部自己写的:「第二家公司已于 10-04 14:55 开通 ⇒ 本次发布之后 DEFAULT 的每一分钟都是风险」)。而且 14:55 到批次 1 上线之间,第 2 家公司的**品牌库自动导入行无法追回**(`biz_invalid_asin_data` 今天连账号列都没有)。这条不在本方案范围内,但它决定了本方案什么时候能开工——见 §12 待确认第 1 条。
|
||||
|
||||
## 2. 需求拆成两件事,它们必须分开做
|
||||
|
||||
| | 是什么 | 判据 | 落点 |
|
||||
|---|---|---|---|
|
||||
| **A. 公司配置的读写只超管** | 页面/接口**可见性闸门** | 角色内在(`role == super_admin`),**不查菜单授权** | `CompanyService` + `PermissionMenuService` 三处出口 + 前端注册表 `superAdminOnly` |
|
||||
| **B. 超管按公司看数据** | 读路径的**数据过滤** | 超管 = tab 选中的公司;非超管 = 恒锁自己公司 | 各页接口 + tab store + 统一的范围解析入口 |
|
||||
|
||||
为什么 A 必须是"角色内在"而不是"菜单授权"——这正是 **10-04 12:3x 生产事故的形状**:`listVisible` 挂上 `admin_companies` 菜单闸门,而该菜单授权笔数为 0 ⇒ 15 个管理员账号一开「用户管理」就 403,被踢回登录页,报成"登录闪退"(见 `CompanyService.java:80` 那段注释记录的教训)。所以:
|
||||
|
||||
- 用 `role` 判,不用菜单授权判。菜单授权可以被人改坏,角色不能。
|
||||
- A 做完后,`admin_companies` 这个菜单行**仍然留在 `columns` 表里**(否则历史授权数据无处安放),只是从"可授予集合"里摘出来,让超管也没法把它授给别人。
|
||||
|
||||
## 3. 16 页归属普查(逐页取证,不是估的)
|
||||
|
||||
分母来源:`admin-frontend-vue/src/router/routes.ts:17-38` 共 22 页。扣掉 6 页非数据页——`account/users`(已有公司筛选,见 §3.1)、`account/companies`(A 类闸门,不做 tab)、`account/menus`(平台字典)、`records/software-version` / `records/tutorial` / `records/digital-human-version`(平台发布物,全公司共享)——**剩 16 页,与用户说的"16 页"对得上**。
|
||||
|
||||
| 类 | 判据 | 页 | 归属列证据 |
|
||||
|---|---|---|---|
|
||||
| **A(9)** | 表上有账号列,一条 `user_id IN (成员)` 就够 | 数据权限分组、密钥管理、密钥用量统计、店铺管理、生成记录、日志管理、视频任务记录、客户端任务管理、数据去重总数据 | `biz_shop_manage_group.user_id/created_by_id`、`biz_user_api_secret.user_id`、`biz_user_secret_usage_daily.user_id`、`biz_shop_manage.created_by_id`、`image_history.user_id`、`device_log_file.uid`、`biz_image_video_async_task.user_id`(`ImageVideoAdminTaskMapper.java:37` 已有 `<if test="userId != null"> AND t.user_id = #{userId}</if>`)、`biz_task.user_id`(`TaskCenterQueryMapper.java:93-95` 已有 `USER_SCOPE_T/USER_SCOPE_B` 的 `IN` 片段)、`biz_dedupe_total_data.uploader_user_id` |
|
||||
| **B(3)** | 只有 `group_id`,没有账号列 | 不符合ASIN数据(品牌库)、查询ASIN、最低价ASIN | `InvalidAsinDataEntity.java:20`、`QueryAsinEntity.java:20`、`SkipPriceAsinEntity.java:21` 都只有 `groupId`(品牌库二期 V145 后会多出 `company_id`) |
|
||||
| **C(2)** | **零归属列**,本质是全平台共享 | 商品类目、店铺密钥管理 | `ProductCategoryEntity.java:15-23`(`parentId/name/categoryKey/sortOrder/isBuiltin`,无归属);`ShopKeyEntity.java:17-32`(紫鸟 token 池 `ziniaoToken/proxyUrl/ipWhitelist*`,无归属) |
|
||||
| **D(2)** | 快照无归属列,可见性靠"店铺名集合"裁剪 | 店铺撞款监控、店铺数据记录 | `ShopDataDuplicateCheckQueryService.java:78-89 resolveVisibleShopKeys` + `cropShops/cropItems`;底层 `shop_data_duplicate_scan` 只有 `status/summary_json/payload_json`(`ShopDataDuplicateScanEntity.java:16-22`),**全局一份快照**;裁剪链靠 `ShopDuplicateCheckSourceMapper.java:87-97 selectManagedShopNames(operatorId)`(`biz_shop_manage.group_id IN (自己带的分组)`) |
|
||||
|
||||
### 3.1 参照实现已经有了:`用户管理`
|
||||
|
||||
`AdminUserController.java:43` 的 `@RequestParam(name="company_id", required=false)` 是**全仓唯一**一个收公司筛选的后台接口(已全仓 grep 确认)。它的语义就是本方案要复制的模板,两条都对:
|
||||
- 超管不传 = 不筛(`AdminUserService.java:89-90` 只在超管分支加 `eq(company_id)`);
|
||||
- 非超管传别家 = **返回空集,故意不报错也不越权**(`AdminUserService.java:75-81`)。
|
||||
|
||||
### 3.2 A 类不必新造范围机制
|
||||
|
||||
`modules/permission/support/UserDataScopeSupport.java` 已经提供 `resolveVisibleUserIds(operatorId)`(operator → 自己带的分组 → 成员 user ids,历史无分组主管回退按 `created_by_id` 兜底,上限 2000),并且已被密钥管理、任务看板(`TaskCenterScopeService.java:36`)、去重库(`DedupeTotalDataService.java:1188`)使用。
|
||||
|
||||
本方案只加**一条**新方法,然后与它组合,不另起平行实现:
|
||||
```
|
||||
CompanyScopeSupport.memberUserIds(companyId) // SELECT id FROM users WHERE company_id = ?
|
||||
```
|
||||
组合规则(**这是本方案唯一的范围公式,写在一处**):
|
||||
- 超管:`scope = memberUserIds(tabCompanyId)`(替换掉分组派生的" unrestricted",不是交集)。
|
||||
- 非超管:`scope = resolveVisibleUserIds(operatorId) ∩ memberUserIds(operatorCompanyId)`。
|
||||
今天这个交集是恒等的(第 2 家公司只有 1 个账号、0 条业务数据),但**它必须存在**:`resolveCompanyMove` 允许把账号在两家公司之间移(`AdminUserService.java:221-230`),移动后交集就起作用了。这条之所以安全,是因为移人已经有不变式兜着——「账号的 `created_by_id` 必须与它同一家公司,除非创建人是超管」(`AdminUserService.java:236-243` 注释明写这条是"二期不回改 77 处 `eq(getUserId, userId)` 过滤点的前提")。
|
||||
|
||||
`memberUserIds` 不加 `LIMIT`:今天全库 140 行 `users`。但要在代码里放一个**计数哨兵**:成员数 > 500 时把 `IN (...)` 改成子查询 `user_id IN (SELECT id FROM users WHERE company_id = #{companyId})`。**不预先做**(YAGNI),哨兵要有,理由见 §10 护栏 G6。
|
||||
|
||||
## 4. tab 是什么、不是什么(这条最重要)
|
||||
|
||||
**tab 不是安全边界。** 它是超管的一个读筛选。真正的边界是:
|
||||
- 非超管**永远**被会话裁剪到自己公司,前端传什么都不算(后端一律按 `operator.company_id` 覆盖);
|
||||
- 超管不传 `company_id` 时**保持今天的不筛行为**。
|
||||
|
||||
选这个弱度换来两件实在的好处:
|
||||
1. **发布顺序安全**:jar 先上(参数可选、向后兼容,旧前端不传照常),前端后上(tab 出现且真的开始筛)。反过来会有"tab 存在但不筛"的**撒谎窗口**——超管点了"第 2 家"却看到第 1 家的数据,这比报错更坏。
|
||||
2. 混合版本窗口里(一期实测约 15 分钟)旧 jar 遇到未知参数直接忽略,不会 500。
|
||||
|
||||
代价必须承认:**超管失去"一眼看全部公司"的能力**,这是"不允许「全部」"这个选择的直接后果。今天 2 家,来回切代价小;三家以上,"哪家在掉量"这类横向判断只能靠切 tab。二期 §12 已明确"不做跨公司汇总/对比报表",所以本方案**不**补汇总页,只在这里记账。
|
||||
|
||||
另两个必须钉死的口径(不写清就会各自理解):
|
||||
- **"第一家"的定义 = `company.id` 最小的启用中公司**,不是超管自己所属公司,也不是后端返回顺序的第一条。刷新后回到第一家(见下面 store 口径)。
|
||||
- **tab 状态不进 URL,只进 Pinia store**。理由:16 个页面的取数函数都去读 `route.query` 是真实成本,批次 1 铺不完;代价是**复制链接/截图不带公司上下文**,超管从 tab=2 发给同事的链接,对方打开是第一家。这个代价是否可接受,见 §12 待确认第 4 条。
|
||||
- tab 条渲染在 `AdminLayout.vue` 的顶栏/面包屑那一行(截图红框位置,`AdminLayout.vue:97-121`),**不在各页里各画一遍**。所以护栏不能测"页面渲染了 tab",只能测"页面的请求带了 companyId"(§10 G1)。
|
||||
|
||||
## 5. C 类两页:显式声明"不按公司分",而不是静默不筛
|
||||
|
||||
商品类目(平台字典,带 `isBuiltin`)和店铺密钥(紫鸟 token 池)**今天就没有任何归属列**。给它们加 tab 只有两种坏结果:要么假装有隔离(切 tab 数据纹丝不动,用户会以为隔离坏了),要么为它们临时造归属(回到二期 §12"不给其余 55 张表加 `company_id`"的破例讨论)。
|
||||
|
||||
做法:注册表里 `companyScoped: false`(**显式写,不留空**——留空与 `false` 运行时等价,但只有写出来才是"读过普查、决定不参与"的证据,实施计划 Task 1 Step 1 那支用例钉的就是这个)+ 一句"本页全平台共享,不按公司区分"。让用户看到的是"这页不参与",而不是"这页坏了"。这条也回答了二期 §9.4 对品牌库"未分组是预期的"的同类处理。
|
||||
|
||||
承载方式与原方案**有一处偏离**(10-04 定案时写的是"页头常驻一条说明"):那句话改放进 `operation-guides.ts` 这两页的既有引导文案里,随批次 1 一起上。两个理由:①"页头常驻一条说明"本身就是 §12 第 5 条不许的新提示条;②引导条那一支已经有分母取注册表的用例(谁被声明成 `false` 就自动被要求带这句),新控件没有这个搭车。⚠️ 这件事**不排在批次 3**:tab 条挂在 `AdminLayout` 上是全局件,批次 1 一上线"切了纹丝不动"这坏观感就同时上线。
|
||||
|
||||
## 6. 铁律:闸门读写同页;归属不从界面注入(2026-10-04 收窄过一次,最终版)
|
||||
|
||||
这一节原来写的是"一个页要进 tab 范围,它的读筛选和**写归属**必须同一批落地"。后半句已作废——它会把公司这个维度重新端回界面(弹窗里长出一个"所属公司"),而**新维度默认只做后端,界面暴露要单独批准**。拆成三条:
|
||||
|
||||
### 6.1 闸门必须读写同页(这条仍是铁律)
|
||||
|
||||
一页进了 tab 范围,它的**角色/归属闸门**要读写一起动。只收窄列表、不收窄按 id 的读出口 = "列表看不见但按 id 能读能下载",那是真越权。已定位必须补行级闸门的出口:
|
||||
|
||||
| 出口 | 要求 |
|
||||
|---|---|
|
||||
| 列表读 | 带 `company_id`,经 §7 的唯一入口 |
|
||||
| **导出** | 同一个 `company_id`。**否则 tab 筛了表格、导出全量 = 越权泄露**。已定位:`/api/admin/dedupe-total-data/export`(`dedupe-total-export.ts:5,39` 的 `toExportUrl(state)`)、`/api/admin/product-categories/export`、`/api/admin/shop-data-crawl/duplicate-check-export`(`AdminShopDataDuplicateCheckController.java:179`) |
|
||||
| **按 id 的详情 / 下载** | 凡该端点存在**非超管或内部令牌通道**的,必须先取行再判归属。已定位:`ImageVideoAdminTaskController.java:93`(`detail`)与 `:100`(`download-zip`)——它们走 `requireAdminOrInternal`,漏掉它 = 列表筛了但内容能越权读 |
|
||||
| 按 id 的单行 改 / 删 | 同上,用 `CompanyScopeSupport.assertSameCompany(...)`(`CompanyScopeSupport.java:44`,目前 **0 个生产调用方**,本方案是第一个使用者) |
|
||||
|
||||
反过来,**这页只有超管能进(无任何非超管/内部通道)时,按 id 的端点刻意不加公司闸门**:日志管理那页 9 个端点全是 `requireSuperAdmin`(`AdminDeviceLogController.java:152-159`),加了只会误伤 `uid IS NULL` 的麦象日志——那是排障现场不是越权面。这条边界要有测试钉着,不许下一个人"顺手补齐"(实施计划 Task 12 Step 4)。
|
||||
|
||||
### 6.2 归属由后端从操作者推导,写请求体一律不带 `company_id`
|
||||
|
||||
与二期的建号口径同源:`AdminUserService.resolveTargetCompanyId`(`:201-212`)在超管未传 `company_id` 时返回 `operator.getCompanyId()`,前端 `85e1e92a` 起**故意不发这个字段**,并被 `tests/company-user-create.test.ts` 反向钉住。店铺/分组(Task 11)沿用同一条,不搞两套。
|
||||
|
||||
另一个更硬的理由:`ShopManageEntity`/`ShopManageGroupEntity` 根本没有 `company_id` 列。⚠️ 而**店铺的归属人今天来自请求体的 `createdById`**(`ShopManageService.java:86` 读 `request.getCreatedById()`),不是操作者 ⇒ "落到第 2 家"早就做得到(把负责人选成第 2 家的账号)。再加一个 `company_id` 参数不是"补能力",是**造两个互相矛盾的归属控件**(选了第 2 家 + 负责人是公司 1 的人,听谁的?)。反过来,若为它加"负责人必须是那家成员"的校验,超管自己不在别家成员集里 ⇒ **超管把负责人留成自己就 403**,比今天更糟。
|
||||
|
||||
### 6.3 明写不吞的副作用
|
||||
|
||||
> **建号**:超管切到「第 2 家」tab 后建的号,仍归**超管自己所属的公司 1**(`resolveTargetCompanyId` 落操作者),要归属第 2 家必须用那家自己的 admin 登录去建(`users.id=1193` 就是这么来的)。memory 里那句"超管建的号一律归公司 1"就是这条。
|
||||
> **店铺/分组**(17:5x 实查后订正——上一版把这句一并写成了"仍归公司 1",**不对**):归属由请求体的**负责人 `created_by_id`** 决定,**与顶部 tab 无关**。把负责人选成第 2 家的账号,店铺就归第 2 家;这一条本轮一行代码都没动。
|
||||
|
||||
今天影响为零(第 2 家 0 行业务数据,实查见实施计划 Task 5 Step 0),但它是运维手册里必须存在的一行字。落点:`operation-guides.ts` 店铺管理那条引导加一句文案(**只加文案,不加控件**),由实施计划 **Task 7 Step 7** 与其余 7 页那句一起落,别在接线任务里再落一遍。
|
||||
|
||||
## 7. 后端:一个统一入口,不许各页自己 if
|
||||
|
||||
新增 `DataReadScope.readScope(...)`,**唯一**负责"操作者 + 请求里的 company_id → 该查哪批 user ids / 哪家公司":
|
||||
|
||||
```
|
||||
DataReadScope readScope(AdminUserEntity operator, Long requestedCompanyId)
|
||||
超管 + null → 不筛(今天的行为)
|
||||
超管 + id → memberUserIds(id)
|
||||
超管 + 不存在的 id → 空集(不 403;tab 值可能来自过期 store)
|
||||
非超管 + null → resolveVisibleUserIds(operator) ∩ memberUserIds(operator.companyId)
|
||||
非超管 + 自己 id → 同上
|
||||
非超管 + 别家 id → 空集(照 AdminUserService:75-81「故意不报错也不越权」)
|
||||
```
|
||||
|
||||
两条硬约束:
|
||||
- **每个收 `company_id` 参数的 controller 方法必须调这个入口**,不许出现第二个 if。护栏 G2 扫的就是这条。
|
||||
- `CompanyScopeSupport` 现有的 `requireCompanyId` 取不到就抛、绝不返回 null(`CompanyScopeSupport.java:25-42` 的注释给了理由:null 进实体 → MyBatis-Plus 跳过该列 → 被 V145 的 `DEFAULT 1` 静默兜住 = "归属失真且不报错")。**新入口沿用同一条纪律**:范围解析失败返回"空集"或抛,永不返回 null 让调用方自己猜。
|
||||
|
||||
## 8. 前端:两个闸门 + 一个 store
|
||||
|
||||
### 8.1 A 类(公司配置只超管)
|
||||
|
||||
- `routes.ts` 的 `AdminPageDef` 加 `superAdminOnly?: boolean`,`account/companies` 置 true。
|
||||
- `router/helpers.ts:26-33` 的 `isRouteAllowed` 现在是 `if (isSuperAdmin) return true` —— **超管恒 true,所以只剪菜单树对超管无效,只加角色闸门对非超管的侧边栏又不够**。两处都要做,缺一处就留旁路:
|
||||
1. `isRouteAllowed` 先判 `superAdminOnly && !isSuperAdmin → false`(与菜单树无关的硬闸门);
|
||||
2. `stores/admin-session.ts:30` 的 `canonicalizeMenuTree(...)` 之后**剪掉** `superAdminOnly` 节点(覆盖 sidebar、面包屑、`firstVisiblePath`、路由守卫四个消费者——它们都从这一棵树来,这是唯一单点)。
|
||||
- `CreateUserDialog.vue:123`:`v-if="companyOptions.length"` → `v-if="operatorSuper && companyOptions.length"`。今天非超管也会看到一个只有单项的"所属公司"(`selectableCompanies` 给非超管返回自己那一行),按需求 1 要整个隐藏。隐藏后**不需要**补默认值——后端 `resolveTargetCompanyId` 对非超管恒返回 `operator.getCompanyId()`。
|
||||
- `UsersPage.vue:146` 的 `void loadCompanies()`:改成超管才调。**这条必须在 jar 上 403 之前发**,见 §11。
|
||||
|
||||
### 8.2 B 类(tab)
|
||||
|
||||
- 新 store `company-tab`:`companies`(超管才拉)、`activeId`(默认 `id` 最小的启用公司)、`memberUserIds` 不缓存(每次请求交后端解析,避免"改了成员没刷新"的不一致)。
|
||||
- 请求侧:`company_id` 由各页的 api 模块**显式**从 store 取并塞进参数,**不做 http 层中央注入**。中央注入看着省事,实际会让"C 类页也带上参数",后端要么忽略(撒谎)要么honour(把平台字典误筛成公司私有)。护栏 G1 用双向对账来防漏:注册表声明了 `companyScoped: true` 的页,它的 api 模块必须出现 `company_id`;出现了 `company_id` 的页必须被注册表声明。
|
||||
|
||||
## 9. 三个会静默丢数据的坑(都不报错,都会让人以为改造坏了)
|
||||
|
||||
### 9.1 `group_id IS NULL` 的历史行会从**所有** tab 消失
|
||||
品牌库 14,224 行 AUTO 的 `group_id` 是 NULL(V145 头部实查 + 二期 §7.3 明确"这是刻意的切法")。B 类页若走 `group_id → 分组 → 公司` 推导,这些行在**每一个** tab 下都不出现 = 对超管等于数据被删。符合 memory 里那条「读过滤与写按范围替换必须同时改,否则隐藏=静默删除」。
|
||||
处置三选一,**不许默认选 (c)**:
|
||||
(a) 该页不声明 `companyScoped`;(b) 把 NULL 行回填成公司 1(它们事实上就属于公司 1);(c) 接受消失并写文案。
|
||||
**已锁 (a)**(§12 第 2 条):批次 2 开工前先跑 §11.2 的 SQL 数出 NULL 行数,(b) 需要用户单独授权才做。
|
||||
|
||||
### 9.2 日志管理的 `uid` 对麦象采集机恒空
|
||||
`DeviceLogFileEntity.java:27` 注释逐字:「桌面客户端当前登录用户 id(users.id),**maixiang 上报为空**」。⇒ 按 `uid IN (成员)` 筛之后,**所有麦象采集机日志在任何 tab 下都看不见**。而麦象机器正在跑跟价(见 `maixiang-linux-migration`)。
|
||||
处置(**已锁**,§12 第 2 条):日志管理按 `source` 分支——`client` 按 uid 筛、`maixiang` 恒可见。若 §11.2 第 2 条取证显示麦象行占多数,则整页改判不声明 `companyScoped`。**默认不筛**比默认丢日志安全。
|
||||
|
||||
### 9.3 tab 会改变"这页今天有几行"的观感
|
||||
一期 10-04 刚把三张任务记录列表页的日期初值改成留空(`00e5df02` / `48018068`)。tab 再一上,超管第一次切过去的行数变化会被报成"数据丢了"。承载方式按 §12 第 5 条:**不新做页头控件/提示条**,改在 `operation-guides.ts` 的既有引导条目里加一句"超级管理员可用页面上方的公司 tab 切换公司,切换后行数会变化——行数变少不是数据丢了",店铺管理那条再补一句 §6.3 的归属口径。分母取 `COMPANY_SCOPED_PAGES` 那 8 页(不是只有那三张任务记录页),其中「数据权限分组」今天共用通用 fallback,要给它一条独立文案——这是**故意**偏离"沿用旧版 guides 表原文"的约定,因为那句 tab 说明不能塞进 fallback(会被没进 tab 的页共用)。`admin_users` 不在其列:它一期就已按公司筛。
|
||||
|
||||
⚠️ **这句必须以"超级管理员"开头**:引导文案按 `menuKey` 取、**不分支角色**,而非超管看不到 tab 条(G1 那侧的 `isSuperAdmin` 判断)。写成"当前公司由上方 tab 决定"会让非超管读到一句指不到任何控件的话——比不写更容易被报成 bug。同理,文案不许给非超管承诺他们没拿到的收窄(附B 记了分组那半边本轮刻意没动)。缓解是**部分强度**:引导条默认展开,但折叠态按浏览器持久化,早就收起提示的人看不见这句。
|
||||
|
||||
## 10. 护栏(做进代码出口,不写进注释)+ 变异自证
|
||||
|
||||
| 号 | 断言 | 注入点(变异) |
|
||||
|---|---|---|
|
||||
| G1 | 注册表 `companyScoped:true` 的页 ↔ 其 api 模块出现 `company_id`,**双向**对账 | 把某页从注册表摘掉声明 / 从 api 模块删参数 |
|
||||
| G2 | 每个带 `@RequestParam(name="company_id")` 的 controller 方法必须调 `readScope(` | 把某一处的 `readScope` 换成裸 `eq` |
|
||||
| G3 | 非超管传别家 id ⇒ 空集;传自家 ⇒ 有数据;**两种都不许看到对方数据**(断言具体行为,不接受"没报错"当通过) | 删掉 `AdminUserService:75-81` 形状的那道判断 |
|
||||
| G4 | `admin_companies` 在 `/current-user/menus`、`permission-menus?grantableOnly=true`、`updateUserColumnPermissions` 提交三处都不出现/写不进;`grantableOnly=false` 时**仍**能列出(菜单行要可管理) | 任一出口漏剪 |
|
||||
| G5 | `CompanyService` 全文不出现 `hasAnyAdminMenu(`(防止有人把读路径重新挂回菜单授权,重演 12:3x),且 `ensureSuperAdmin(operator);` 恰好 3 处(create / update / **listVisible**) | 让 `listVisible` 退回非超管可 |
|
||||
| G6 | `memberUserIds` 的成员数哨兵:> 500 时用例红,提示改子查询 | 无(它本身就是倒计时) |
|
||||
| **G7** | **反向钉"已摘掉的维度不得回流"**(五支):`tests/company-user-create.test.ts`(建号不带 `companyId`)、`company-user-list.test.ts:66`(账号页不调 `fetchCompanies`)、Task 11 Step 1 第四支(店铺写入口不收 `company_id`)、Task 12 Step 4 那条(按 `fileId` 的端点不接 `company_id`)、Task 7 Step 7 第 4 支("当前公司"只由文案与 `is-active` 承载:`CompanyTabs.vue` 里不许长出提示条,且 `COMPANY_SCOPED_PAGES` 那 8 页的引导文案必须都带那句) | 给任一写入口加一个 `company_id` 参数 ⇒ 对应那条红;给 tab 组件加回提示条 ⇒ 那支的反向半红;从任一页文案里删掉那句 ⇒ 分母半红。**每支必须自带"该做的确实做了"的取样自检**,否则符号根本不存在时它恒绿 = 没钉 |
|
||||
|
||||
现有用例要**翻转**的三条(不是新增,是改正确的行为):`CompanyServiceDirectoryTest.java:121` 「公司内管理员的目录只查自己公司」、`:161` 「公司内管理员读到本公司那一行:读端点不查 admin_companies 菜单」、`:172` 的"读得到目录也不能建第二家公司"文案——按需求 2 全部改成 403。这三条改完,`CompanyReadPathMenuGateTest` 的 `ensureSuperAdmin` 计数从 2 变 3(G5)。
|
||||
|
||||
变异自证遵守既有八条硬规矩:每轮开跑前所有被注入文件写回 pristine;还原只认注入前读进内存的字节,**不许 `git checkout`**(会连未提交的 V145 实现一起抹掉);CRLF 锚串先对齐行尾;分母只认本轮扫描结果。
|
||||
|
||||
## 11. 分批与发布顺序
|
||||
|
||||
### 11.1 四批
|
||||
|
||||
| 批 | 内容 | 页 | 发布顺序 |
|
||||
|---|---|---|---|
|
||||
| **0** | 公司配置只超管(§2 A + §8.1),无 DDL | 公司管理 1 页(建号选公司与账号页公司列**已由 `85e1e92a` 对所有人摘掉**,本批只核对 + 反向钉,见实施计划 Task 2) | **FE 先,jar 后**(现网那版 admin-vue 早于 `85e1e92a`,仍在调 `GET /api/admin/companies`;反过来 15 个 admin 一开「用户管理」就撞 403) |
|
||||
| **1** | tab 机制 + A 类:客户端任务管理、视频任务记录、密钥用量统计、生成记录、日志管理、数据权限分组、密钥管理、店铺管理(8 页;**只筛读**,写侧归属按 §6.2 不动)。**日志管理只在 §9.2 的「`(source='maixiang' OR uid IN 成员集)` 一整组」这条路线下留在本批**;若 §11.2 第 2 条取证显示麦象行占多数,则改判不声明 `companyScoped`,本批变 7 页。**本批还捎带两件纯前端件**:§9.3 那 8 页的引导文案、§5 两页 C 类的 `companyScoped: false` 与"不参与"文案(都只是注册表标记 + 文案,无 DDL、无后端) | 8 | **jar 先,FE 后** |
|
||||
| **2** | B 类 group 推导:查询ASIN、最低价ASIN;D 类裁剪链:撞款监控、店铺数据记录(4 页)。**开工前必须先解 §9.1/§9.2** | 4 | jar 先,FE 后 |
|
||||
| **3** | 依赖二期 V145 物化列:数据去重总数据、不符合ASIN数据(**直接用 `company_id` 列,不许再走 §3.2 的推导路径,否则同页两个真相源**)。~~C 类两页的"显式声明不筛 + 文案"~~ 已提到**批次 1**(见 §5:tab 条一上线,"切了纹丝不动"就同时上线,等不到 V145) | 2 | 与二期批次 1 同批,见 §12 |
|
||||
|
||||
撞款监控/店铺数据记录(D 类)要新增"多成员版" `selectManagedShopNames`(现在只吃单个 `operatorId`,`ShopDuplicateCheckSourceMapper.java:87-97`),这是动裁剪链而不是加 SQL 条件,成本比 A 类高一档,所以不放批次 1。
|
||||
|
||||
### 11.2 上线前必须实跑的取证(只交付命令,由用户执行)
|
||||
|
||||
```sql
|
||||
-- 1) 三个 group-only 表的 NULL 归属行数(决定 §9.1 走 a/b/c)
|
||||
SELECT COUNT(*) total, SUM(group_id IS NULL) null_group FROM biz_query_asin;
|
||||
SELECT COUNT(*) total, SUM(group_id IS NULL) null_group FROM biz_skip_price_asin;
|
||||
-- 2) 日志管理里麦象行占比(决定 §9.2)
|
||||
SELECT source, COUNT(*) FROM device_log_file GROUP BY source;
|
||||
-- 3) 复核"admin_companies 授权 0 笔"这个前提(§2 的论证依赖它;一期 memory 记的是 0,需重取)
|
||||
SELECT COUNT(*) FROM user_column_permission
|
||||
WHERE column_id IN (SELECT id FROM columns WHERE column_key='admin_companies');
|
||||
-- 4) 每家公司成员数(§3.2 的 500 哨兵分母)
|
||||
SELECT company_id, COUNT(*) FROM users GROUP BY company_id;
|
||||
```
|
||||
|
||||
### 11.3 复验口径(沿用既有两条已付学费的规矩)
|
||||
逐节点复验**不能打 `0.0.0.0:18080`**(nginx 轮询池),主机 B 的 java 在 `127.0.0.1:19080`;两台 jar 必须同版,混合版本窗口里新参数会被旧 jar 随机忽略。admin-vue **只在主机 B 的 `/var/www`**,验"线上==本地构建"用整树聚合摘要。
|
||||
|
||||
## 12. 口径锁定(2026-10-04,用户「继续」= 按本文推荐执行;每条都可单独推翻,推翻只影响所列批次)
|
||||
|
||||
1. **不等二期 V145**:批次 0-2 先走,V145 那条线独立收尾(它的 `DEFAULT 1` 摘除有截止时间,不该被 tab 排期拖住)。⇒ 影响:批次 3 的排期挂到 V145 之后,批次 1 不因此改形。
|
||||
附(17:0x 更正):V145 **已提交**(`b7873209`),但**仍未上线**——线上 jar 还是 `e42b37c1…`,Flyway 停在 144。"提交"与"上线"的差别要在批次 1 出包时显式判断(本计划的 jar 一旦重建重启就会把 V145 一起带上去),见实施计划 Task 13 Step 2。
|
||||
2. **NULL 归属行的处置**:默认 (a) **不声明 `companyScoped`**(宁可不筛,不静默删可见性);要走 (b) 回填(动 14k+ 行的迁移)需用户单独授权,不在本方案里自决。批次 2 开工的**前置闸门**是 §11.2 四条 SQL 的实查结果——拿不到结果就不进批次 2。
|
||||
日志管理单独定:按 `source` 分支,`client` 按 `uid` 筛、`maixiang` 恒可见(§9.2 路线 a;实现形状见实施计划 Task 12 Step 3——它是 `(source='maixiang' OR uid IN 成员集)` 一整组,不是 `source` 值分支)。
|
||||
3. **`用户管理` 不在"必选一家"之列**:`85e1e92a` 之后这页连公司筛选器都没有了,超管看到的本来就是全公司账号——跨公司查号是它的职责。全局"默认选中第一家、不允许全部"只作用于 §11.1 批次 1 那 8 页。
|
||||
4. **tab 只进 Pinia store,不进 URL**:批次 1 的 8 页铺完优先于"链接带公司上下文"。已知代价(§4):发给同事的链接对方打开回到第一家。
|
||||
5. **界面暴露只批两处**(2026-10-04 定:新维度默认只做后端):已批 = ①`AdminLayout` 顶部那条公司 tab、②公司配置入口收窄到超管。**未批 = 任何页加"所属公司"列、任何弹窗加公司/成员下拉、按公司收窄的负责人选择器**。页头的"当前公司"行数说明也按未批处理——批次 1 先用 `operation-guides.ts` 的既有引导文案承载,不新做控件(§9.3)。
|
||||
6. **写侧归属不从界面注入**:见 §6.2/§6.3。tab 是**纯读视图**,写侧的归属规则本轮一行都不动(建号恒落操作者自己那家;店铺看请求体里的负责人,与 tab 无关——两条的差别见 §6.3);这些副作用明写不吞,并用反向钉测试钉住"写入口不许收 `company_id`"(实施计划 Task 11 Step 1 第四支、Task 12 Step 4 那条)。
|
||||
|
||||
## 13. 明确不做
|
||||
|
||||
- 不给其余 55 张业务表加 `company_id` 列(tab 全程用 `user_id → users.company_id` **派生**,零 DDL;只有二期那两张表的物化列是破例)。
|
||||
- 不做跨公司汇总/对比报表(二期 §12 同口径)。
|
||||
- 不改 `group_id` 语义,不拿它当租户键。
|
||||
- 不动 89 处数据出口、不重写 `UserDataScopeSupport` 的分组口径。
|
||||
- 不在本方案里做阶段B 设备令牌(它是二期的完成条件,不是本方案的)。
|
||||
- 不给 C 类两页临时造归属列。
|
||||
@@ -1,125 +0,0 @@
|
||||
# 店铺凭据密钥轮换设计(2026-10-02)
|
||||
|
||||
范围:`aiimage.security.shop-credential-key` 这一把密钥的轮换,以及轮换时三张库里凭据表怎么处理。
|
||||
本文只给设计、取证结果和待办,**没有执行过任何轮换或重启**。
|
||||
|
||||
## 一、为什么现在不能直接换密钥
|
||||
|
||||
`ShopCredentialCryptoService.decrypt()` 解不出来时回退返回原文(`ShopCredentialCryptoService.java:76-97`)。
|
||||
调用方拿到这串原文就当明文口令往外发——紫鸟账号、1688 店铺、第三方 api_key 都是这样被使用的。
|
||||
所以「改了密钥、没重加密存量」这段时间里的表现不是报错,而是**拿着密文当口令去登录**,
|
||||
失败点离原因很远,最难查。
|
||||
|
||||
本次改动(只做防护,未动线上):
|
||||
|
||||
- `ShopCredentialCryptoService` 支持 `shop-credential-key-previous`(逗号分隔的旧密钥),解密时当前密钥失败后按顺序回试旧密钥,加密只用当前密钥。
|
||||
- 回退不再静默:打 WARN,写明「当前密钥 + N 个历史密钥都试过」,并直接说出后果(这串密文会被当成明文口令发出去)。
|
||||
|
||||
## 二、生效值到底配在哪一层(今天的实测)
|
||||
|
||||
| 键 | 位置 | 读数 |
|
||||
| --- | --- | --- |
|
||||
| `shop-credential-key` | 容器 `/app/application-server.yml`(宿主 `/app/java/`) | `configured=yes len=64 sha8=190cc85c occurrences=1`,**两台一致** |
|
||||
| `jwt-secret` | 同上 | `len=64 sha8=2d40fe8a`,**两台一致** |
|
||||
| `AIIMAGE_SHOP_CREDENTIAL_KEY` | 宿主 `/.env`、java 进程 environ | **两处都没有** |
|
||||
| `AIIMAGE_JWT_SECRET` | 同上 | **两处都没有** |
|
||||
| `AIIMAGE_DB_PASSWORD` | 宿主 `/.env`(= java 进程 environ) | `len=16 sha8=83809acd`,两台一致 |
|
||||
|
||||
**结论:这两把密钥的生效值只有 yml 一个来源,没有环境变量覆盖它。** 之前按「改 `/.env` 追加 export」的
|
||||
配方去轮换这两把是无效的——那条配方只对 `/.env` 里真实存在的那些键有效。改密钥就改
|
||||
`/app/java/application-server.yml`,两台各一份,改完 `sha8` 应当同步变化。
|
||||
|
||||
复现命令(只读,值不出生产):
|
||||
|
||||
```
|
||||
MSYS2_ARG_CONV_EXCL='*' python scripts/_prod_config.py all --container java-server \
|
||||
--file /app/application-server.yml --key shop-credential-key
|
||||
```
|
||||
|
||||
## 三、存量行的形态:没有明文(本次实测)
|
||||
|
||||
`scripts/_probe_credential_decrypt_audit.sh` 在主机A 上用**当前密钥真解了一遍**三张表的七个凭据列,
|
||||
只输出计数。判据与 Java 一致:AES/ECB/PKCS5Padding,密钥 = SHA-256(原文密钥) 前 16 字节;
|
||||
并且必须过 base64 往返、16 字节对齐、填充合法、**解出来是合法 UTF-8** 四道关
|
||||
——只看长度和对齐是不够的,换错密钥也能解出「看着像样」的字节。
|
||||
|
||||
| 表.列 | 行数 | 空 | 解得出 | b64 非串 | 长度不对 | 填充不对 | 非 UTF-8 |
|
||||
| --- | --- | --- | --- | --- | --- | --- | --- |
|
||||
| `biz_shop_manage.password` | 86 | 0 | 86 | 0 | 0 | 0 | 0 |
|
||||
| `biz_user_api_secret.secret_value` | 314 | 0 | 314 | 0 | 0 | 0 | 0 |
|
||||
| `biz_image_video_secret.copy_api_key` | 7 | 0 | 7 | 0 | 0 | 0 | 0 |
|
||||
| `biz_image_video_secret.t8_key` | 7 | 0 | 7 | 0 | 0 | 0 | 0 |
|
||||
| `biz_image_video_secret.t8_video_key` | 7 | 2 | 5 | 0 | 0 | 0 | 0 |
|
||||
| `biz_image_video_secret.voice_api_key` | 7 | 0 | 7 | 0 | 0 | 0 | 0 |
|
||||
| `biz_image_video_secret.voice_group_id` | 7 | 0 | 7 | 0 | 0 | 0 | 0 |
|
||||
|
||||
三点用处:
|
||||
|
||||
1. **没有明文行**,435 行里 433 行是当前密钥解得出的密文,另 2 行是空值。所以重加密可以走纯 Java
|
||||
一条路,不需要「遇到解不出的行就跳过」的分支——那个分支的存在本身就等于把密文当明文写回去。
|
||||
2. 轮换前跑一次、轮换后跑一次,**`解得出` 的计数应当一模一样**,这是这批改动的验收标准。
|
||||
3. 写入路径本来就全过加密(`ShopManageService.java:100,124`、`UserApiSecretService.java:843`,
|
||||
两处 `setSecretValue`/`setPassword` 都包着 `encrypt(...)`),没有发现明文字段入口。
|
||||
|
||||
## 四、轮换顺序(每一步都能单独发版)
|
||||
|
||||
1. **先发版**:带双密钥回试的版本。此时 `previous` 为空,行为与旧版逐字节相同
|
||||
(`behaves_exactly_as_before_when_previous_keys_is_empty` 钉住这条)。
|
||||
2. **改配置**:两台 `/app/java/application-server.yml` 同时改——`shop-credential-key` 写新值、
|
||||
`shop-credential-key-previous` 写旧值。**这一步起新数据用新密钥加密,旧数据仍解得出。**
|
||||
回滚 = 把两行改回原值重启,比重加密便宜得多。
|
||||
3. **重加密存量**:跑一次迁移(下面第 5 节),把这 433 行用当前密钥重新加密。
|
||||
4. **验证**:再跑 `scripts/_probe_credential_decrypt_audit.sh`,`解得出` 仍是 433、其余四类仍为 0。
|
||||
5. **收尾**:清掉 `shop-credential-key-previous`,下次发版生效。留着不影响正确性,只是每次解密多一轮试。
|
||||
|
||||
顺序不能反:先改配置再发版的话,旧 jar 不认 `previous` 这个键,存量行立刻进回退分支。
|
||||
|
||||
## 五、重加密迁移的关键约束
|
||||
|
||||
- **只改密文,不改业务时间戳。** 这批表上有 `updated_at` 会被心跳/看板读,走实体更新会顺带刷新它。
|
||||
- **不要走业务 Service 的写入路径**(会带缓存刷新、索引重算、`ziniaoShopIndexRefreshTrigger` 之类的副作用)。
|
||||
用一条独立的取行→解密→用当前密钥加密→按主键回写的脚本,跑在 Java 侧。
|
||||
- 分表分批、每批独立事务;失败要能重跑(重加密天然幂等,重复跑只是再解一次)。
|
||||
- 迁移脚本**本次没写**,等你定了窗口再动。
|
||||
|
||||
## 六、不该走这条路的几把密钥
|
||||
|
||||
| 密钥 | 为什么另算 |
|
||||
| --- | --- |
|
||||
| `auth.jwt-secret`(sha8 `2d40fe8a`) | 换它 = 现有登录态全废,所有人被踢;必须单独定维护窗口,和重加密无关 |
|
||||
| `AIIMAGE_DB_PASSWORD`(sha8 `83809acd`) | 库口令,改它要同时动 `/.env` 与 MySQL 账号,属另一套流程 |
|
||||
| 极客图 / jikip / LLM 代理 key | 生效值在 yml 或 `biz_user_api_secret`,前者按普通配置轮换、后者随第五节的迁移一起走 |
|
||||
| MinIO(B 机设备日志、A 机业务桶) | 走各自的 `.env`/服务重启,与店铺凭据无关 |
|
||||
|
||||
## 七、验证做到哪一步
|
||||
|
||||
- 新增 `ShopCredentialCryptoServiceTest` 6 条,`mvn -o -Dtest=ShopCredentialCryptoServiceTest test`
|
||||
→ `Tests run: 6, Failures: 0, Errors: 0` + `BUILD SUCCESS`。
|
||||
- 变异检验:把 `candidates.addAll(previousKeySpecs)` 删掉后重跑 → `Tests run: 6, Failures: 2`
|
||||
(`rotates_key_but_still_decrypts_legacy_ciphertext`、`tries_several_previous_keys_in_order` 变红),
|
||||
说明这两条真的在钉双密钥回试,不是恒绿断言。
|
||||
(Python 侧的等价做法见 `scripts/tests/`:`umask 077` 挪到 `base64 -d >` 之后、或绕过 `upload_and_run_command` 直接拼命令,各有 1 条用例变红,改完的文件按 md5 原样还原。)
|
||||
- 这批测试走的是标准生命周期(`mvn -o -Dtest=ShopCredentialCryptoServiceTest test`)。
|
||||
上午有一段时间 `test-compile` 被并发会话新加的未跟踪测试挡住,当时只能用「javac 单编我的测试类 +
|
||||
`surefire:test` 单跑」绕过;09:5x 复跑时那条阻塞已经自己清了,没有动过别人的文件。
|
||||
- Python 侧:`scripts/tests` 共 78 例(`PYTHONUTF8=1 python -m pytest scripts/tests -q` 全绿)。
|
||||
掩码层那 8 个护栏点也各打坏过一次(出口不掩码、三层各自失效、`verdict` 把读不到当一致、裸标记不记录、MSYS 路径不拦、`atexit` 没注册),**8/8 都有用例变红**;其中「`atexit.register(_report)` 删掉」原本是漏网之鱼——直接调 `_report` 的用例看不见「没注册」这个状态,补了一条开子进程实跑的用例才咬住。
|
||||
|
||||
## 八、还欠什么
|
||||
|
||||
1. **轮换本身没执行**,新密钥由你定、yml 由你改(生产写操作按约定只交付命令,不代跑)。
|
||||
2. **重加密迁移脚本没写**——第五节的约束已经定好,等窗口。
|
||||
3. `ShopManageService.java:260` 往 VO 写的是 `masked`,读侧掩码是有的;**日志侧**这几把密钥有没有
|
||||
别的出口,本次没审。
|
||||
4. 外观/货源的 LLM key 分组那部分结论来自之前的实测记录(一把 key 平均挂 9.5 个账号),
|
||||
本次没复核,引它做决策前先重跑一遍当时的脚本。
|
||||
5. **两台 `/tmp` 里躺着 48 个 644 权限的历史探针副本**(主机A 36 个、主机B 12 个,其中 20 个含
|
||||
`password|secret|token|api_key` 形式的行)——那是 `_ssh_bash.py` 加 `rm -f` 收尾之前几次会话留下的。
|
||||
上传命令现在带 `umask 077`,新副本落成 600,但**旧的这 48 个还在**,删除算生产改动,命令给你:
|
||||
|
||||
```
|
||||
python scripts/_ssh_bash.py a scripts/清理用临时脚本 # 或直接
|
||||
MSYS2_ARG_CONV_EXCL='*' python scripts/_ssh_probe.py all 'rm -f /tmp/_run__*.sh; ls /tmp/_run__*.sh 2>/dev/null | wc -l'
|
||||
```
|
||||
|
||||
后面那条回读应当是 `0`。
|
||||
@@ -1,361 +0,0 @@
|
||||
# 菜单权限按公司一套树 · 设计(2026-10-06)
|
||||
|
||||
控制方要求:「菜单权限也加字段来区分,现在的默认归到 admin 下」,并在两个档位里选了重的那一档——
|
||||
**每家公司一套菜单树**(不是"只给字典行打个归属标记")。
|
||||
|
||||
关联:`company-multi-tenant-design-2026-10-04.md`(账号归属,已上线)、
|
||||
`brand-dedupe-company-isolation-design-2026-10-04.md`(规则库每公司一套,同一形状)。
|
||||
|
||||
## 1. 线上家底(2026-10-06 主机A 业务库只读实查,不是估的)
|
||||
|
||||
| 事实 | 读数 |
|
||||
| --- | --- |
|
||||
| `columns` 行数 | 52 = admin 26(id 4…109)+ app 24(id 1…96)+ internal 2(id 69、95) |
|
||||
| `columns` 列 | id/parent_id/name/column_key/menu_type/route_path/sort_order/created_at/updated_at,**无 company_id** |
|
||||
| 唯一键 | **两条**:`uk_column_key(column_key)`、`uk_menu_type_route_path(menu_type, route_path)` |
|
||||
| 其他索引/约束 | `PRIMARY(id)`、`idx_columns_parent_sort_id`、`idx_menu_type_sort_id`、`fk_columns_parent_id`→`columns(id)` |
|
||||
| `user_column_permission` | 784 笔 / 133 只账号 / 34 个被授权 column_id |
|
||||
| 授权按公司分布 | 公司 1(厦门米椿花)131 人 768 笔;公司 2(德阳)2 人 **16 笔** |
|
||||
| 同 key 重复行 | 0 行 ⇒ 原地换复合键不会因重复失败 |
|
||||
| `admin_companies`(id 109)授权 | 0 笔(10-04 事故后的既定状态) |
|
||||
|
||||
`PermissionMenuSchemaInitializer` 生产是关的(`application.yml:259` 默认 `false`),但它是 JdbcTemplate
|
||||
旁路,十几条种子 SQL 的幂等守卫全是裸 `NOT EXISTS(column_key)`——换键后它不改就会一声不响地不再插行。
|
||||
本批已把这条通道的 31 段种子语句逐条钉上 `company_id = 1`(落法与理由见 §5 末条,护栏见 §8)。
|
||||
|
||||
## 2. 三档定案(控制方「直接开干」,按推荐档落)
|
||||
|
||||
- **D1 存量授权**:V149 同笔把公司 2 那 16 笔授权按 `column_key` 重指向本公司副本。
|
||||
不留成人工动作,否则德阳那 2 只账号一上线就掉光菜单(隐藏=静默删除)。
|
||||
- **D2 谁能编辑别家的树**:站点超管可带 `company_id` 读写任意公司的树;非超管恒锁本公司,
|
||||
传了别人的 `company_id` 一律 403。今天就是超管在给 133 只账号配权限,锁死本公司等于把这件活关掉。
|
||||
- **D3 复制范围**:admin + app + internal 三种 `menu_type` 全复制(客户端账号同样分属两家公司,
|
||||
只复制 admin 会留半棵共享树);**`admin_companies` 那一行不复制**——它是角色内在闸门
|
||||
(`SUPER_ADMIN_ONLY_KEYS`),公司 2 的树里根本没有这行,比"有一行但看不见"更干净。
|
||||
- **D4 之后新建的公司**:V149 只补当时已存在的公司,「公司管理 → 新增公司」必须同批建树,
|
||||
否则新租户是一个零菜单行的公司(账号登录侧边栏全空、授权树一个勾都没有,全程不报错)。
|
||||
落法见 §5 的 `copyTreeFromTemplate`,与建号同一次写入、不留"上线后手工再跑一遍复制段"。
|
||||
|
||||
## 3. 数据模型(V149)
|
||||
|
||||
1. `ADD COLUMN company_id bigint NULL`(末位)→ `UPDATE ... SET company_id = 1 WHERE company_id IS NULL`
|
||||
→ `MODIFY COLUMN company_id bigint NOT NULL DEFAULT 1`。第三句同时是回填自检闸门:漏一行就抛 1048
|
||||
(V143 同形)。`DEFAULT 1` 只为混合版本窗口的旧 jar 存在(旧 jar 的实体没这字段,严格模式建菜单会 1364),
|
||||
摘除动作是下一版的一条纯元数据操作 `ALTER TABLE columns ALTER COLUMN company_id DROP DEFAULT`(**禁 MODIFY**,
|
||||
重建会按当时的列默认值物化历史行),取号见 `backend-java/docs/migration-inventory.md`(当前 V152 起)。
|
||||
哨兵 `CompanyDefaultGuard.WATCHED_TABLES` 已把 `columns` 探进清单——摘之前巡检每天多喊一条
|
||||
`COMPANY_DEFAULT_STILL_PRESENT`,那是哨兵在干活,不是新故障。
|
||||
2. 两条唯一键**先 ADD 后 DROP**(中间任一步失败都至少还有一个键在守并发):
|
||||
`uk_company_column_key(company_id, column_key)`、
|
||||
`uk_company_menu_type_route_path(company_id, menu_type, route_path)`。
|
||||
新键是旧键的严格放宽 ⇒ 不会因重复失败。索引字节预算(utf8mb4):8+256=264、8+80+1020=1108,都远低于 3072。
|
||||
3. 不加 `company_id` 的单列索引:新唯一键的最左前缀就是它,52 行的表再开索引就是 V139 那轮清理掉的冗余形状。
|
||||
4. 复制:按「`company` 全表 × 公司 1 的字典行」插副本(不是硬编码公司 2,第三家开通时不用再改迁移),
|
||||
`parent_id` **先留 NULL**,再由下一条 UPDATE 沿 `(company_id, column_key)` 把父指向重映射到同公司副本——
|
||||
与插入顺序无关,两级三层都成立。带源值插入是错的:那是全局 id,副本会跨公司挂到厦门米椿花的分组上,
|
||||
而 FK 只保证父行存在、挡不住挂在别家。
|
||||
5. 授权重指向:`user_column_permission` 按「账号公司 = 行公司」重算 `column_id`。
|
||||
重跑是 no-op(驱动条件要求行还挂在公司 1 上且账号不属于公司 1);重指前先摘掉"源行 + 副本"并存的重复授权,
|
||||
否则重指会撞 PK `(user_id, column_id)` 报 1062。
|
||||
6. 四道自检闸门(临时表 `must_be_zero INT NOT NULL`,V143 那个"约束替我喊"的家族):
|
||||
① 每家公司的树与公司 1 一样齐(专防复制段被 `NOT EXISTS` 守卫一声不响挡掉一整家);
|
||||
② 跨公司父指向残留 = 0;③ 跨公司授权残留 = 0;④ `company_id` 不为 NULL/不为 0。
|
||||
不为 0 就让迁移失败,而不是留下一个静默分叉的树。
|
||||
|
||||
外键 `fk_columns_parent_id` 只保证父行存在,**挡不住跨公司挂父**,所以同公司判定必须在应用层(§4)。
|
||||
|
||||
## 4. 后端读侧:出口一起收窄
|
||||
|
||||
判据只有一个来源:`loadRawMenus(companyId, menuType)`。它是 `hasAnyAdminMenu`、`expandDescendantIds`、
|
||||
`superAdminOnlyMenuIds`、授权树、有效菜单、`resolveGrantableMenuIds` 的共同上游,剪这一处等于剪一片。
|
||||
|
||||
| 出口 | 现在的形状 | 改成 |
|
||||
| --- | --- | --- |
|
||||
| `list()` 目录(菜单管理页) | 全量 52 行 | 按**操作者**公司;超管可用 `?company_id=` 指定 |
|
||||
| `list(operator, type, true)` 授权树 | 操作者范围 | 范围集按操作者公司算,跨公司项永不下发 |
|
||||
| `getUserColumnPermissions()` 有效菜单(登录/侧边栏) | `loadMenus(type)` 全表 | 按**被授权账号**公司 |
|
||||
| `getUserColumnIds()` 回填集 | 同上 | 按目标账号公司 |
|
||||
| `findDataPermission()`(`selectOne + LIMIT 1`) | 全局按 key 点查 | **必须带公司**:换键后同 key 有 N 行,`LIMIT 1` 会跨公司借位拿到别家的数据权限行——本次最危险的一处静默失效 |
|
||||
| `hasEffectiveColumnPermission()` | 查得到就展开判定 | 行公司与账号公司不同 ⇒ 直接 false |
|
||||
| `ensureUniqueColumnKey()` / `ensureUniqueRoutePath()` | 全局查重 | 本公司内查重;不改的话德阳在公司 1 建过的 key 上**根本建不出来** |
|
||||
| `resolveSortOrder()` / `reorder()` | 同类型全局 MAX+1 / 兄弟集 | 同公司内 |
|
||||
| `resolveMenuTypes()`(建号/编辑拆分 admin+app) | 按 id 归类 | **归类本身不带公司**(它按 id 批量取行,跨公司照样归得出类型);真正挡下别家 id 的是它下游的出口 3——`updateUserColumnPermissions` 的有效计数与 `loadMenus` 都按**目标账号公司**取,别家 id 在那里被抛 400「存在无效或不属于当前类型的菜单权限项」。这条要写准,否则下一个人会到 `resolveMenuTypes` 里找一道并不存在的公司闸门 |
|
||||
| 两个数据范围授权端点 | 只挡超管,用户列表全量 | 数据权限行按公司解析,用户列表按公司筛 |
|
||||
|
||||
`hasEffectiveColumnPermission` 那处保守方向要说清:跨公司拿不到行时判"无权限",是拒绝而不是放行。
|
||||
|
||||
**"请求里的 `company_id` 到底在哪一步被收窄"要说准**:不在 controller 里写 `if`,也不在各页 service 里各写一遍,
|
||||
而是收参数的当场交给 `PermissionMenuService.resolveScopeCompanyId(operator, companyId)`(公开方法,
|
||||
把返回值**往下传**而不是丢掉),六个带这参数的 handler 全部同形——目录 GET/POST、两个数据范围授权的 GET 与 PUT:
|
||||
|
||||
```java
|
||||
AdminUserEntity operator = requireAdmin(request);
|
||||
Long scopeCompanyId = permissionMenuService.resolveScopeCompanyId(operator, companyId);
|
||||
return ApiResponse.success(permissionMenuService.list(operator, menuType, grantableOnly, scopeCompanyId));
|
||||
```
|
||||
|
||||
这条出口注册进了 `CompanyIdParamGoesThroughReadScopeTest` 的 `SCOPE_DOORS`(现在是**三道门**:
|
||||
`readScope(`、`readCompanyIdOrOwn(`、`resolveScopeCompanyId(`),A/B/C/D 四条判据共用:
|
||||
handler 收了 `company_id` 就必须走门、取到的绑定名必须真的出现在下游实参里。
|
||||
所以"控制器多写一个带 `company_id` 的口却没过归属判定"是编译后跑一条用例就红,不靠人记着。
|
||||
`PUT /permission-users/{userId}/columns` 与 `update`/`delete`/`reorder` 故意不带这个参数:
|
||||
它们按行 id 或按被授权账号定位,归属在 service 里判(§5),前端再猜一个公司参数只会多出一个可伪造的入口。
|
||||
|
||||
## 5. 后端写侧
|
||||
|
||||
- `ensureAdminOperatorIfPresent` 只判 `isAdmin`,这是写侧唯一的洞——非超管今天能改整张目录。
|
||||
补两条:目标行公司 = 操作者公司(超管除外,`ensureMenuWritable`);`ensureParentValid` 对**整条祖先链**
|
||||
判同公司(一个同公司的父、上面挂着别家的分组,落库后这行在两棵树里都渲染不出)。
|
||||
- `delete` 与 `reorder` 都先过 `ensureMenuWritable`;`reorder` 原来不带操作者(控制器那一层),已补。
|
||||
- 新增菜单的归属:由**端点的 `company_id` 参数(缺省=操作者公司)**决定,前端不靠猜;超管传别家=给别家建。
|
||||
读侧与写侧共用同一个判据 `resolveScopeCompanyId`——分成两个迟早漂移成「读能看别家、写挡不住」。
|
||||
- `copyTreeFromTemplate(companyId, templateCompanyId)`(D4):`CompanyService.create` 在建号那笔事务里
|
||||
调它,模板公司是**操作者本公司**(参数由调用方给,方法内部不编默认值;缺归属直接拒)。
|
||||
两趟写与 V149 第 6/7 段同形:第一趟只管插、父先留空,第二趟按 `column_key` 认父;
|
||||
`SUPER_ADMIN_ONLY_KEYS` 那行不进副本;目标公司已有的 key 原样保留 ⇒ 重跑只补差集。
|
||||
- **旁路种子(`PermissionMenuSchemaInitializer`)只种公司 1**:七条 `INSERT INTO columns` 的列清单显式写
|
||||
`company_id`、投影写真常量 `1`;判存守卫、认父 JOIN、按 key 的 UPDATE、三条下划线→连字符改名,
|
||||
全部带 `company_id = 1`。理由是换键之后 `column_key` 只在单家公司内唯一——一条裸
|
||||
`WHERE column_key = ...` 在这张表上的语义是"把每一家的同名行都改一遍"(别家副本的 parent 被拍平、
|
||||
初始授权发给别家的行 id),而 `executeQuietly` 把 1048/1062 吞成一行 debug 日志,表现是"某一家
|
||||
一声不响少一套菜单"。`grantInitialShopDataCrawlDataPermissions` 那条 JOIN 另加
|
||||
`data_col.company_id = old_col.company_id`。显式写公司还有一层作用:这条通道不再依赖列上那条
|
||||
`DEFAULT 1`,于是 §3 待办里那句 `DROP DEFAULT` 落地时不会让建号变成 1364。
|
||||
别家公司的树不由这里插行——存量归 V149 的复制段,新建归 `copyTreeFromTemplate`。
|
||||
|
||||
## 6. 前端
|
||||
|
||||
每个响应只含一家公司的行 ⇒ `column_key` 在单响应内仍唯一,侧边栏、路由守卫、`hasMenuKey`、
|
||||
`menu-route-map`、`parseMenuTree` 全不用改。这条不变量的看守是"查询条件必须带公司"本身
|
||||
(§8 的 `everyMenuQueryCarriesTheOperatorsCompany` + `onlyTheSiteSuperAdminMayCrossCompanies`:
|
||||
不传 `company_id` 时锁操作者本公司,超管显式指定才换家),不是"响应里数一遍 key 有没有重复"——
|
||||
后者在假数据上永远为真,杀不掉任何变异。
|
||||
|
||||
- 「菜单管理」(`admin_columns`) 把 10-06 摘掉的公司 tab 装回来:`COMPANY_SCOPED_PAGES` 加一行
|
||||
(正向清单 `companyTabAppliesTo` 自动放行,不需要新代码),`MenusPage.vue` watch `tab.activeId`
|
||||
清掉本页那两个客户端筛选项(菜单名称/类型不进请求)并重取数。
|
||||
- **「菜单管理」这一页带 `company_id` 的只有两个口**:`fetchMenuManageNodes`(GET 目录)与 `createMenu`(POST 新建)。
|
||||
`updateMenu`/`deleteMenu`/`reorderMenus` 故意不带——它们按行 id 定位,归属判定在后端
|
||||
(`ensureMenuWritable` 比较行公司与操作者公司,跨公司 403);前端再从树里猜一个公司参数只会多出一个可被伪造的入口。
|
||||
- **用户管理里的授权弹窗必须带 `company_id`**(本条推翻初稿写的"不加参数:树按被授权账号的公司出,
|
||||
载荷里的 id 天然同公司"——那句在 V149 之后是错的):一棵树一套 id,
|
||||
授权树若按**操作者**公司下发,而目标账号在另一家(超管切了 tab 或在给自己以外公司的账号配权限),
|
||||
则该账号已有的 `column_id` 全都不在这棵树里 ⇒ 已授权一项勾不上,点保存又被
|
||||
`ensureGrantable` 判「无效的菜单权限项」,整页授权直接不可用。所以读侧(`fetchGrantableMenus`)
|
||||
与写侧(按范围整树替换)必须同时收窄,只窄一侧等于把授权藏掉。
|
||||
取值来源分两处、各对应后端真正会用的那一家:编辑弹窗用 `companyTab.requestCompanyId`
|
||||
(列表本来就由它筛 ⇒ 行公司 = tab 公司),新建弹窗用 `form.companyId`(建号弹窗里选的那家,
|
||||
与 `user-create-model` 下发给后端的 `payload.companyId` 同一个值;未选则为 null,后端落操作者本公司)。
|
||||
- **两处没做界面暴露(本批只到后端)**:图片视频任务、店铺数据任务那两个「数据范围授权」弹窗
|
||||
(`fetchImageVideoPermissionUsers` / `fetchShopDataTaskPermissionUsers` 及其 PUT 孪生)仍然一个公司参数都不发。
|
||||
后端那两个端点本批已经收下 `company_id`(缺省=操作者本公司 ⇒ 与改动前同义,不是回归),
|
||||
但站点超管在那两页切 tab 时弹窗候选不会跟着换家。这属于"新维度的界面暴露",按口径要单独批准,不在本批顺手做。
|
||||
|
||||
## 7. 发布顺序与混合版本窗口
|
||||
|
||||
路线甲(选定):V149 与 jar 同批发,双台同窗口(A 金丝雀过了立刻补 B),迁移在首台启动期执行。
|
||||
V149 不是单独一支 jar:按 `backend-java/docs/migration-inventory.md`,下一版要连着跑 `V150__shop_key_company_scope`
|
||||
与 `V151__rule_tables_shared_across_companies`(同批待发的另外两路),三条按序、一次启动跑完;
|
||||
取号只认"当前最大值 + 1",V148 已随它被推翻的口径退役,不许回填。
|
||||
窗口内旧 jar 的后果逐条列清:
|
||||
|
||||
- 目录/授权树会短时出现两排同名菜单(难看,不伤人);
|
||||
- `findDataPermission` 的 `LIMIT 1` 借到公司 1 的行时,判的是"本公司授权集合里没有这个 id" ⇒ **拒绝而不是放行**;
|
||||
- 建菜单会误报"菜单标识已存在"(旧 jar 的全局查重撞副本)。
|
||||
|
||||
都是分钟级、方向保守。路线乙(新 jar 带"本公司无行就回落公司 1"的临时分支)否决:那条回落正是
|
||||
`ProductCategoryService` 这一轮刚拆掉的"哨兵 0 可见集"形状,而且公司 2 在两批之间看不到自己的树。
|
||||
|
||||
## 8. 自证(落码后按实物补,不写"补一些用例"这种没法核对的话)
|
||||
|
||||
| 面 | 看守 | 数量 |
|
||||
| --- | --- | --- |
|
||||
| 迁移形状 | `MenuTreeCompanyMigrationV149Test`:列存在且 NOT NULL、两条新复合键在、两条旧键已摘、`company_id` 无 NULL/无 0、复制段与重指段的驱动条件逐条在场、四道 `_v149_gate` 自检各就各位、回滚脚本不在 Flyway 扫描路径、**旁路种子逐条钉公司**(`schemaInitializerSeedsEveryRowIntoTheTemplateCompany`:31 段种子/14 段按 key 认菜单,取样集有下限,且喂一条已知违规必须被抓到) | 20 例 |
|
||||
| 读侧收窄 | `PermissionMenuServiceCompanyScopeTest`:`loadRawMenus`/`findDataPermission`(`LIMIT 1` 借位那一形)/`hasEffectiveColumnPermission`/祖先链/重名查重/授权有效性计数/`resolveScopeCompanyId` 各按公司取;反向钉"不许出现回落公司 1 的临时分支" | 16 例 |
|
||||
| 控制器 | `PermissionMenuControllerTest`:`company_id` **先过 `resolveScopeCompanyId` 再往下传**(六个 handler 各验一次,桩返回 `99L` 与原始 `7L` 不同值 ⇒ "传了原值"和"传了判定值"不可能双双通过),缺省 `null` 那两例同样进门而不是编一个默认公司 | 10 例 |
|
||||
| 归属正门 | `CompanyIdParamGoesThroughReadScopeTest`:`SCOPE_DOORS` 从两道门加到三道(`readScope(` / `readCompanyIdOrOwn(` / `resolveScopeCompanyId(`),A/B/C/D 四条判据共用;新增三条 `menuScopeDoor*` 探针,其中"取到范围却丢掉"和"门参数列表里没有那个绑定名"两条必须红 | 3 例(含全部页面的取样) |
|
||||
| 哨兵 | `CompanyDefaultGuardTest`:`columns` 同时进 `WATCHED_TABLES` 与探测 SQL 的 IN 清单(双向钉同源) | 14 例 |
|
||||
| 闸门行不旁路 | `PermissionCompanyMenuHiddenTest`:本批给建树加了**第四处**出口,`SUPER_ADMIN_ONLY_KEYS` 的引用从"两处负向 + 一处反解"改成三处负向(`list` / `getUserColumnPermissions` / `copyTreeFromTemplate`)+ 一处正向反解,且只数剥掉注释后的可执行行——旧写法"整份文本里出现 ≥4 次"被 1 处定义 + 4 处 javadoc 就凑得满,三处过滤器全删照样绿 | 7 例 |
|
||||
| 前端接线 | `company-tab-wiring.test.ts`:`admin_columns` 进 `COMPANY_SCOPED_PAGES` + `SEND_POINTS` 登记三处新发送口(全表 21 处 / 按 (文件,整行) 聚成 17 组,与真文件条数逐处对平)、`WATCH_BODY_PINS` 加 `MenusPage.vue` 一对(共 10 对) | `node --test` 1731 例全绿 |
|
||||
| 前端文案 | `align-operation-guide.test.ts`:`admin_columns` 的引导文案补上公司 tab 那句(句子本体与分母规则见 `company-tab-design-2026-10-04.md`,不在本文件里):带 tab 那句的页面集合 = 注册表 16 页减去唯一豁免 = 15 页,多一页少一页都红 | 同一批 1731 例内 |
|
||||
| 建司种子 | `CompanyServiceDirectoryTest`:`create` 在插公司行之后同一次写入里调 `copyTreeFromTemplate(新公司, 操作者本公司)`(`InOrder` 钉顺序);重名被拒那一笔反向钉"不许留下一套挂在不存在公司上的菜单" | 19 例(本批新增 2 例) |
|
||||
| 类型 | `vue-tsc --noEmit` | 0 错误 |
|
||||
| 全量(主树 2026-10-06 16:59 / 17:0x 实跑) | 后端 `mvn -o test`(无 skipTests)`Tests run: 3891, Failures: 0, Errors: 0, Skipped: 7` / BUILD SUCCESS,460 支测试类(逐类相加同为 3891);前端 `node --test tests/*.test.ts` 1731 例 / 0 红 | 本轮跑出的三条红见下节末「补记」 |
|
||||
|
||||
变异自证(已实跑,2026-10-06,在 `tmp/v149-wt` 独立 worktree 里,主树 `PermissionMenuService.java`
|
||||
全程 md5 `2f29aa0bb39447dcab6f68878bd546b3` 未动):对 `PermissionMenuService` 逐点注入
|
||||
"把 `.eq(…companyId…)` 改成 `.eq(false, …companyId…)`"(这一形就是"列名还在、值被丢"的静默失效原型)
|
||||
以及三条建树/归属语义的反向改写,12 个点各开一次 mvn,分母恒为 `PermissionMenuServiceCompanyScopeTest` 的 16 例:
|
||||
|
||||
```
|
||||
PRISTINE bytes=86315 lines=1615
|
||||
BASELINE tests=16 failures=0 errors=0 rc=0 (401s)
|
||||
KILLED loadRawMenus drops company red=4/16 (286s)
|
||||
KILLED reorder siblings drop company red=1/16 (354s)
|
||||
KILLED grant validity count drops target company red=1/16 (317s)
|
||||
KILLED findDataPermission drops company (LIMIT 1 borrow) red=1/16 (211s)
|
||||
KILLED ensureUniqueColumnKey drops company red=1/16 (193s)
|
||||
KILLED grantableUserQuery drops company red=1/16 (216s)
|
||||
KILLED resolveScopeCompanyId lets anyone cross companies red=1/16 (182s)
|
||||
KILLED ensureMenuWritable stops guarding red=1/16 (135s)
|
||||
KILLED hasEffectiveColumnPermission stops denying foreign id red=1/16 (163s)
|
||||
KILLED ensureParentValid stops checking ancestor chain red=2/16 (208s)
|
||||
KILLED copyTree clones the role-intrinsic gate row red=1/16 (193s)
|
||||
KILLED copyTree no longer short-circuits self-copy red=1/16 (137s)
|
||||
RESTORE-CHECK ok
|
||||
SUMMARY injected=12 killed=12 survived=0 void=0
|
||||
```
|
||||
|
||||
`red=4/16` 那一处(`loadRawMenus`)是唯一的公共读口,四条用例同时红;其余各点各红 1 条,
|
||||
`ensureParentValid` 红 2 条。两条 `copyTree` 变异分别被「建树:三种 menu_type 全复制、闸门行不复制」
|
||||
和「建树不许靠默认值兜」这两条打死——D3(不复制 `admin_companies`)与"不自拷"都由这套用例独立看守,
|
||||
不是靠读侧顺带压住的;本轮选中的类只有 `PermissionMenuServiceCompanyScopeTest`(分母恒 16),
|
||||
所以这 12 条红全部出在它内部。`CompanyService.create` 那一笔种树调用另由
|
||||
`CompanyServiceDirectoryTest` 的「插行之后同一次写入里复制菜单树」与「建公司被拒时不建树」两条钉住
|
||||
(验的是调用点与顺序,不在变异分母里)。
|
||||
|
||||
**补记(那 12 轮之后全量跑出的三条红,加一处顺带收口)**:上面那份日志的 md5 只覆盖到扫描时点,
|
||||
之后的改动不在那 12 个点里,各自另加了尺子——
|
||||
|
||||
1. **后端红**:控制器六个 handler 收了 `company_id` 却没走任何归属出口
|
||||
(`CompanyIdParamGoesThroughReadScopeTest` 断言 A 红)。修法不是往 `READ_SCOPE_ALLOWLIST` 里添六条豁免,
|
||||
而是把 `resolveScopeCompanyId` 注册成**第三道正门**,并给它配三条自己的探针(能过 / 取了丢掉 / 传 null),
|
||||
让"下一个新页面忘了收口"这件事仍然是编译后跑一条用例就红。
|
||||
2. **后端红**:`copyTreeFromTemplate` 是 `SUPER_ADMIN_ONLY_KEYS` 的第四处引用点
|
||||
(`PermissionCompanyMenuHiddenTest` 红)。这条 SDD 台账里预先写过(要求加变异 + 把期望从
|
||||
"恰 2 负 + 恰 1 正 + ≥4"往前挪),本批按它挪成 **恰 3 负 + 恰 1 正 + 定义与出口共 ≥5 行**;
|
||||
对应变异就是那份日志里的第 11 轮 `copyTree clones the role-intrinsic gate row`(已被打死,`red=1/16`)。
|
||||
3. **前端红**:`align-user-menu-grantable.test.ts:105` 原本把控制器的调用形状钉成
|
||||
`list(requireAdmin(request), menuType, grantableOnly, companyId)`(原值透传),本批改过门之后它红。
|
||||
这条不是"测试写错了",而是**前端侧唯一读 Java 控制器源的那把尺子**——挪成新形状时补了一条
|
||||
`doesNotMatch(/menuType, grantableOnly, companyId\s*\)/)` 反向钉:不许有人图省事把 tab 原文再透传回去。
|
||||
4. **顺带收口**:旁路种子(`PermissionMenuSchemaInitializer`)的 31 段种子逐条钉上 `company_id`,
|
||||
并加 `schemaInitializerSeedsEveryRowIntoTheTemplateCompany` 反向钉住——这条通道的失效形状是
|
||||
`executeQuietly` 把 SQL 错误吞成 debug 日志,"某一家少一套菜单"不会喊。
|
||||
|
||||
这些都不在变异分母 16 例里(护栏形状与文件形状,不是运行时行为),靠的是各自用例里的取样下限 +
|
||||
已知违规探针;验收读数是本轮主树实跑:后端 `mvn -o test` **3891 例 / 0 红 / 7 skip**(460 支类,逐类相加同为 3891),
|
||||
前端 `node --test tests/*.test.ts` **1731 例 / 0 红**。
|
||||
|
||||
线上复验探针(发版后只读跑):`scripts/_probe_menu_company_shape.py` 在原有 8 条之后加了 5 条——
|
||||
各家 × `menu_type` 的行数(每家必须与公司 1 一样齐)、跨公司挂父 = 0、跨公司授权残留 = 0、
|
||||
`admin_companies` 那一行不在公司 1 之外、`columns.company_id` 的 `COLUMN_DEFAULT`(摘 DEFAULT 那条待办的复验口)。
|
||||
发版前跑这五条会各回一条 `Unknown column 'company_id'`——那是列还没有,不是探针坏,五条各有 `@@` 标记互不牵连。
|
||||
生产写操作一律先取证 → 备份 → `--apply`,由控制方执行或明确授权后代跑。
|
||||
|
||||
## 9. 回滚
|
||||
|
||||
`backend-java/docs/rollback-V149-permission-menu-company.sql`(Flyway 扫描路径之外):
|
||||
授权重指回公司 1 的行 → 删副本 → 换回两条旧唯一键 → `DROP COLUMN company_id` →
|
||||
删 `flyway_schema_history` 的 version=149 行 → 回滚 jar → 起应用。
|
||||
副本 `column_id` 一旦有新增授权,回滚脚本先报数再停手,不做静默删除。
|
||||
|
||||
## 10. 发版命令包(本批 0 手工 SQL:迁移在 jar 启动期由 Flyway 跑)
|
||||
|
||||
前提:两支待发的后端批次(V149 本批 + V150/V151 店铺密钥与规则库)都要先进同一个提交,
|
||||
出包树才能同时带上三条迁移;前端要带本批的 `admin_columns` 接线与 10-06 那三个公司 tab 文件。
|
||||
提交与推送由控制方决定,代跑生产写操作需要明确授权。
|
||||
|
||||
**下面每一行都在同一个目录下跑:工作区根 `D:\todesk\副业\数富AI`**(`scripts/` 在这一层,
|
||||
`crawler-plugin/` 也在这一层)。前面那条 `cd` 会把后面几行带到别的目录里去,所以每条需要换目录的
|
||||
都用子 shell 括号包住,不留状态。
|
||||
|
||||
**发版前取证(只读,我可以自己跑)**
|
||||
|
||||
```
|
||||
python scripts/_probe_jar_md5.py # 两台现网 jar 的 md5 与体积(回滚点)
|
||||
python scripts/_probe_menu_company_shape.py # 基线:前 8 条有数,后 5 条回 Unknown column 'company_id' 才是对的
|
||||
```
|
||||
|
||||
**出包(本地,从干净 worktree;入口与输入件路径 10-06 逐条 `-e` 验过存在)**
|
||||
|
||||
```
|
||||
git -C crawler-plugin worktree add crawler-plugin/tmp/v149-build <含本批的提交>
|
||||
# 三处文档输入未入库,读者是 ExplainIndexAuditDocTest / ArchitecturePlanSection6DocTest / IndexMigrationV101Test:
|
||||
cp -r crawler-plugin/backend-java/docs/specs crawler-plugin/tmp/v149-build/backend-java/docs/
|
||||
cp crawler-plugin/backend-java/docs/explain-index-audit.md \
|
||||
crawler-plugin/backend-java/docs/java-architecture-optimization-plan.md \
|
||||
crawler-plugin/tmp/v149-build/backend-java/docs/
|
||||
(cd crawler-plugin/tmp/v149-build/backend-java && mvn -o clean package) # 上线不许 skipTests;clean 只在出包树,主树禁
|
||||
ls -l crawler-plugin/tmp/v149-build/backend-java/target/*.jar
|
||||
```
|
||||
|
||||
**发布(写生产,两台同窗,逐台健康门禁按主机给端口:A 18080 / B 19080)**
|
||||
|
||||
```
|
||||
python scripts/_deploy_verified_jar.py <jar路径> <期望md5> --check # 只读:记录线上 md5 + 两台健康
|
||||
python scripts/_deploy_verified_jar.py <jar路径> <期望md5> # 上传 → 校验 → 重启 → 健康 → 复核
|
||||
(cd crawler-plugin/admin-frontend-vue && npm run build)
|
||||
python scripts/_deploy_admin_vue.py # dist 只在主机B /var/www,软链原子切
|
||||
```
|
||||
|
||||
**发版后复验(只读)**
|
||||
|
||||
```
|
||||
python scripts/_probe_menu_company_shape.py # cols_by_company 各家行数须等于公司 1;三条残留须为 0;
|
||||
# admin_companies_outside_company1 须为 0(D3)
|
||||
python scripts/_prod_watch.py --window 30m # ALERTS 只认 † 那几条;本批预期多一条 COMPANY_DEFAULT_STILL_PRESENT
|
||||
# (columns 进了哨兵清单,摘 DEFAULT 之前它每天都在喊,那是哨兵在干活)
|
||||
```
|
||||
|
||||
前端两件事各自单独核:**线上树 == 本地构建**用整树聚合摘要(本地在 `dist` 上跑、远端在
|
||||
`/var/www/admin-vue-<ts>` 上跑同一条管道,两个值必须相等):
|
||||
|
||||
```
|
||||
(cd crawler-plugin/admin-frontend-vue/dist && find . -type f | sort | xargs md5sum | cut -d' ' -f1 | sort | md5sum)
|
||||
```
|
||||
|
||||
**这版到底带没带本批的接线**用扛得住 minify 的字面量数:`dist/assets/MenusPage-*.js` 里 `company_id` 应为 2
|
||||
(目录 + 新建),带 `grantableOnly` 的那个 UsersPage chunk 里应为 1(授权树)。
|
||||
本地 10-06 17:05 那版构建(`vue-tsc --noEmit` 0 错误、`npm run build` RC=0)实测就是这两个数:
|
||||
`MenusPage-Cui-Lsn1.js` `company_id`=2、`UsersPage-DeJ6Wy_U.js` `company_id`=1(同文件 `grantableOnly`=2)。
|
||||
|
||||
## 11. 上线后复验(2026-10-06 17:3x–17:4x 实跑读数,不是计划)
|
||||
|
||||
**发版**:提交 `1d27806a`(本批 + 并行的 V150/V151 合在一笔,理由见提交说明)→ 出包树
|
||||
`crawler-plugin/tmp/v149-build`(`mvn -o clean package` 不 skipTests)→ `Tests run: 3891, Failures: 0,
|
||||
Errors: 0, Skipped: 7` / BUILD SUCCESS → jar `08b79b334091a80e2493d9de1bc9392a` / 137,499,094 B。
|
||||
两台上传后远端 md5 复核一致、health=200;回滚点 `.bak-20261006173005`(A) / `.bak-20261006173210`(B),
|
||||
上一版是 `39f6640745b985f5be32cb384eb8e220`。Flyway 到 **151**:rank 59/60/61 = 149/150/151,
|
||||
`success=1`,时间 17:32:29–30(只在先起的那台跑一次)。
|
||||
|
||||
**库侧形状**(`_probe_menu_company_shape.py`):`columns` 52→154 行,每家 admin 26/25/25、app 24、internal 2;
|
||||
`cross_company_parent` = 0、`cross_company_grant` = 0、`admin_companies_outside_company1` = 0(D3 成立);
|
||||
旧键 `uk_column_key`/`uk_menu_type_route_path` 已被 `uk_company_column_key`/`uk_company_menu_type_route_path`
|
||||
替换;`dup_keys` 从发版前 0 变成 51 = 每家一份同名 key 的必然结果(不是回归)。
|
||||
`grant_shape` 的 788 笔没变、而 `COUNT(DISTINCT column_id)` 从 34 涨到 50 = 恰好 +16,
|
||||
对上 D1「公司 2 的 16 笔重指向到自己副本」这个数。
|
||||
`company_id` 仍是 `NOT NULL DEFAULT 1` ⇒ 摘 DEFAULT 那条元数据操作仍欠着(下一版做)。
|
||||
V150:`biz_shop_key.company_id` 已加、16 行全归公司 1。V151:`biz_invalid_asin_data` 唯一键回到
|
||||
`uk_data_value_brand(data_value,brand)`、`biz_product_category` 回到 `uk_product_category_key(category_key)`
|
||||
(412 行 / 412 个不同 key ⇒ 全局唯一 satisfiable)。
|
||||
|
||||
**行为侧(内部令牌 + `operatorId`,两台各打一遍,逐行一致)**:
|
||||
只打 `GET /api/admin/permission-menus?menuType=admin`。**注意判据**:越界时 HTTP 仍是 200,
|
||||
拒绝在响应体的 `"code":403`(86 B)里 ⇒ 只看 `%{http_code}` 会把 403 读成放行。
|
||||
行数锚 `"column_key"`(VO 上是 `@JsonProperty("column_key")`,锚 `columnKey` 恒 0)。
|
||||
|
||||
| 操作者 | 参数 | 读数 |
|
||||
|---|---|---|
|
||||
| 超管 1 | 不带 | 26 行、含 `admin_companies` |
|
||||
| 超管 1 | `company_id=1/2/3` | 26 / 25 / 25 行,别两家不含 `admin_companies` |
|
||||
| 公司 2 管理员 1193 | 不带 / `company_id=1` | 25 行 / `"code":403` |
|
||||
| 公司 1 管理员 3(非超管) | 不带 / `company_id=2` | 26 行 / `"code":403` |
|
||||
| 公司 3 `company_super_admin` 1201 | 不带 / `company_id=1` | 25 行 / `"code":403` |
|
||||
|
||||
两点要记:① **超管不带 `company_id` 拿的是本公司那 26 行,不是三家混合**(`resolveScopeCompanyId`
|
||||
在 `requestedCompanyId == null` 时直接返回操作者公司,对超管也不例外)—— 前端 `menu-manage-api.ts`
|
||||
与 `company-scope.ts` 原先写的"超管拿到全部公司的行/两排同名菜单"与实现不符,已随本次复验改口。
|
||||
② `company_super_admin` 不算站点超管(跨家读被 403 挡住),这与 D2 只放开 `super_admin` 一致。
|
||||
|
||||
**前端**:`admin-vue-20261006-173552`(回滚点 `20261006-110820`),远端整树聚合摘要
|
||||
`eda9c8af236ae46e067e8ddcc0f62a3f` == 本地构建;`MenusPage-Cui-Lsn1.js` `company_id`=2、
|
||||
`UsersPage-DeJ6Wy_U.js` `company_id`=1。改那两处注释后重建,摘要逐字未变 ⇒ minify 剥注释,
|
||||
现网 dist 就是改注释之后的构建,不必重发。前端全量 **1731 例 / 0 红**。
|
||||
|
||||
**巡检 `--window 30m`**:ALERTS=3 = `公司DEFAULT未摘` 两台各 1(哨兵在干活,本批新增 `columns` 进清单)
|
||||
+ 主机B `类加载=121`。后者已归因:121 条全部落在重启那一分钟 `09:32Z`(=17:32 本地),之后 12 分钟
|
||||
12,611 行日志里 0 条,而 A 同版同窗口 0 条 —— 与 10-05 记下的"启动窗口惰性类加载被首批请求抢跑"同形,
|
||||
不是本批引入。缺的类是 `StandardMultipartHttpServletRequest`、`PropertyMetaData$1`、
|
||||
`SimilarAsinTaskDetailVo` 这类首次使用才加载的东西,与本批改动无交集。
|
||||
**未做**:真人浏览器打开「菜单权限」页看两排 tab 与切换后的树,仍欠。
|
||||
@@ -1,260 +0,0 @@
|
||||
# 上线后性能 / 逻辑优化建议(2026-10-02)
|
||||
|
||||
审查方式:只读代码,未连生产、未压测。所有 file:line 均已逐行回读确认;凡依赖线上数据才能定量化的,标了 `【待测】` 并给出取数语句。
|
||||
本报告按「能缩短多少单任务时长」排序,不按改动难度排序。
|
||||
|
||||
---
|
||||
|
||||
## 一、结论摘要
|
||||
|
||||
外观专利与货源是任务时长的大头(外观占 LLM 花费 95%)。这两条链上**最贵的不是 LLM 本身,而是夹在 LLM 批次之间的串行等待**:
|
||||
|
||||
| # | 问题 | 位置 | 每任务额外代价 |
|
||||
|---|---|---|---|
|
||||
| A1 | 每个 LLM 批次之间把全部分片从对象存储重读重解析一遍 | `AppearancePatentTaskService.java:1926`→`:3126` | 轮数 × 分片数 次远程 GET,全在批间空档,期内并发槽闲置 |
|
||||
| A2 | 品牌校验逐行发、每行各带一个 90 秒预算;同项目已有的批量+缓存过滤器没用 | `AppearancePatentLlmClient.java:916` | 一批 10 行 = 10 个独立 90s 预算串行 |
|
||||
| A3 | 货源采集链仍逐行回传 + 逐行查终态,没吃到变体链已上线的攒批 | `func/collect_data_run/handler.py:338-350` | 每行 2 次公网 HTTP |
|
||||
| A4 | 每次开页取 cookie 都让 Redis 全键空间 SCAN 一遍 | `maixiang_task_api/main.py:315` | 与开页次数等量(实测口径 10 万+ 次开页 = 10 万+ 次扫描) |
|
||||
|
||||
B 组是 DB / 对象存储的往返浪费(心跳整行读、删除路径的全表 COUNT、结果文件作业的调度自相矛盾),C 组是吞吐上限(要先测再改),D 组是交付层低成本项。
|
||||
|
||||
---
|
||||
|
||||
## 二、A 组:直接缩短单任务时长
|
||||
|
||||
### A1 外观专利:批间全量重读分片 `[P0]`
|
||||
|
||||
**证据链**
|
||||
- `modules/appearancepatent/service/AppearancePatentTaskService.java:902-904` 注释自陈「同步检测:按批次串行调用 LLM」;`:915` 取 `llm-batch-size`(yml:336 默认 **10**);`:949` 外层 `for (i += batchSize)` 串行推进。
|
||||
- 每轮批内 `:970 mergeLlmRowsIntoChunks` → `:1047` 定义 → `mergeLlmRowsIntoSubmittedChunks`:`:1926 loadSubmittedChunks(task.getId())` 取回**该任务全部分片**,`:1934` 对每一片调 `readChunkRows(chunk)`。
|
||||
- `:3126 readChunkRows` = `transientPayloadStorageService.resolvePayload(...)`(RustFS/OSS GET)+ 整片 JSON 反序列化。
|
||||
|
||||
**代价**:N 行任务 = ⌈N/10⌉ 轮,每轮 C 次载荷 GET + 全量解析(C = 分片数)。5000 行、C=25 → 500 轮 × 25 = **1.25 万次 GET、约 250 万行对象解析**,全部串在批与批之间。这段时间 `llm-row-concurrency:5`(yml:343)的槽是空着的。
|
||||
`【待测】C 的真实分布`:`SELECT task_id, COUNT(*) c FROM biz_task_chunk WHERE module_type='APPEARANCE_PATENT' GROUP BY task_id ORDER BY c DESC LIMIT 20;`
|
||||
|
||||
**改法**(纯读,不动写回)
|
||||
1. 把 `Map<chunkKey, Map<rowKey,row>>` 提成批循环的局部状态,在 `:1058 collectPendingLlmCandidates` 首次读片时就建好,批内 merge 只更新真正被写回的那几片;
|
||||
2. 参照 similarasin 侧已有的 `indexRowsByChunkKey` 思路建 `rowKey→chunkKey` 索引,去掉 `:1910` 对全部分片的线性试探。
|
||||
|
||||
**风险**:分片在批中被别的入口改写时读到旧态。现状靠 `mergeChunkPayload` 的 CAS 兜住,改后仍要走同一 CAS,只省读不省写。行数与判定结果不变。
|
||||
|
||||
**状态(2026-10-02 10:2x):改法 1 已提交 `91d85ec6`,未发版。**
|
||||
索引改为「分片键 → (payload_hash, rowKey 集合)」,在 `collectPendingLlmCandidates` 那一遍就建好,
|
||||
批内 merge 只对 hash 变过的分片重读(`chunkRowKeySet`);载荷哈希与内容在所有写入点都是同一条 UPDATE 落的,可直接作新鲜度锚。
|
||||
落库路径一行未动,`mergeChunkPayload` 仍自己 `selectOne` + 重读最新载荷再 CAS,索引不参与合并基底。
|
||||
每批的 `loadSubmittedChunks`(DB SELECT 全部分片)保留——它就是锚,不能省。
|
||||
读的次数从 `(批数+1)×分片数` 降到 `分片数 + 本批写过的片数`。
|
||||
改法 2(`rowKey→chunkKey` 索引去掉逐片线性试探)**未做**:那是内存里的 O(C) 扫描,不是这次的瓶颈。
|
||||
测试 `AppearancePatentChunkRowIndexTest` 3 例,逐条做过变异检验。
|
||||
|
||||
**货源侧同形态已消除(10-02 13:0x,未发版)** —— `SimilarAsinPipelineSupport`:判空探测与建行图
|
||||
合成 `readSubmittedChunks` 的一次读取(新增 `SubmittedChunk` record,只在当次调用内传递,不做字段级
|
||||
缓存),`collectPendingLlmCandidates` 改用已读到的行、不再逐片 GET。每轮 merge 的 GET 从
|
||||
`2×分片数 + 写回数` 降到 `分片数 + 写回数`(3 片实测 7→4),`submitLlmForSubmittedChunk` 从 `2C` 降到 `C`;
|
||||
写回次数与判定结果一行未动。测试 `SimilarAsinTaskServiceChunkReadReuseTest` 3 例(其中一例专防"做成跨调用缓存"),逐条变异检验。
|
||||
**货源侧没跟着做外观那套跨批复用索引**:余下的倍数在 `flushLlmBufferedResults`——它按 chunkScopeHash 分组、
|
||||
每组调一次 `mergeLlmRowsIntoChunk`,每次仍读全部分片(G 组 = G×C 次),要省得先把索引提到 flush 这一层,另计。
|
||||
|
||||
### A2 外观专利:品牌校验合批 + 复用已有缓存 `[P0]`
|
||||
|
||||
**证据链**
|
||||
- `modules/appearancepatent/client/AppearancePatentLlmClient.java:187-200` 是行循环,`:197 applyResult(...)`;`applyResult` 内 `:916` 调 `brandCheckClient.checkTitleText(result.title(), "Terms")`。
|
||||
- `modules/brand/client/BrandCheckClient.java:201-203 checkTitleText` → `checkAll(splitTitleText(title), strategy)`;`:100-101` 预算 `total-timeout-millis` **每次调用重算**(yml:320-325:`retry-times:10 / total-timeout-millis:90000 / read-timeout-millis:60000`)。
|
||||
- 同项目 `modules/collectdata/util/CollectDataBrandBatchFilter.java:26-31` 注释与 `:44-62` 实现已经做过这件事:按 10 行一批去重后一次 `checkAll`(整批共享预算)+ 512 条 LRU 判定缓存 + 远程抛错不写缓存。**外观侧完全没走它**。
|
||||
|
||||
**代价**:一批 10 行 = 10 个独立 90s 预算串行;上游 16890 劣化时批间隔被拉到分钟级。跨行同品牌(nike/adidas 这类高频词)零复用。
|
||||
|
||||
**这一条的量级取决于 16890 现在的状态**:9-28 实测 jikip 套餐彻底失效那轮,`distinct 品牌 291 / 最终判失败 290`(99.7%),A 机 45 分钟内 `整批耗时预算用尽` 290 次,当时的结论是"10 次重试纯放大时延、零收益"(`docs/ops/prod-decisions-2026-09-28.md` §八)。
|
||||
- 上游**正常**时:合批+缓存省的是 10 次往返 → 1 次,收益是个常数因子;
|
||||
- 上游**再次劣化**时:`每行一个 90s 预算` 意味着 10 行/批最坏 900s,改成整批共享预算后最坏仍是 90s/批 —— **这条真正的价值是把爆炸半径从"行"收回"批",和外观合批那次同样的思路**。所以下手前先看一眼 16890 现在的成功率,它决定 A2 排在 A1 前还是后。
|
||||
|
||||
**改法**:`applyResult` 拆两段——先收齐全批 keywords,`distinct` 后一次 `checkAll`,再按行取结论;缓存口径照抄 `CollectDataBrandBatchFilter.checkAndCache`。**不要新建类**,把该过滤器提到可被外观复用的位置即可。
|
||||
|
||||
**风险(必须拍)**:合并后同品牌在同批内共享一次结论。上游抖动时「第 1 行 OK、第 2 行 QUERY_FAILED」会变成两行同结论 → **判定集合可能变化**,属于本项目在意的静默错判族(参见外观 id 塌陷那次)。行数不变、LLM 输出不变。
|
||||
`【10-04 已落地】`没走 `CollectDataBrandBatchFilter` 复用那条路,改为 `BrandCheckClient.checkTitleTexts(List, strategy)`;实际改动比本文预估的大一圈——三个**回退点**原先也在逐行发查询,现已并入同一次批查询。落地形状、护栏与变异见 §九。未部署。
|
||||
|
||||
### A3 货源采集链:套用变体链已上线的攒批 `[P0]`
|
||||
|
||||
**证据链**
|
||||
- `maixiang_run_task/func/collect_data_run/handler.py:338-350 _emit`:每产出一条就 `feed(pending, False)`,紧跟 `:345 self._is_task_terminal(task_id)`。
|
||||
- `func/amazon_base.py:460-471 _is_task_terminal`:每次调 `api_client.get_batch_status(task_id)`,**无节流**。
|
||||
- 对照组 `func/variant-collection/handler.py:235-257`:攒批 flush + `TERMINAL_CHECK_INTERVAL` 节流 + 失败批留缓冲重发。变体链已改完,货源链没跟上。
|
||||
|
||||
**代价**:每行 2 次公网 HTTP(`API_BASE_URL` 走公网 121.196.149.225:18960),另加 `:343` 每行把整条 payload 打进日志。一次往返失败被 `tools/api_client.py:33-43`(timeout 30×3 + sleep 2)卡住最长约 94s。
|
||||
|
||||
**改法**:把变体链的缓冲与终态节流提到 `amazon_base` 的公共方法,`_emit` 走同一缓冲。
|
||||
**风险**:不改行数。**需采集机跑一次 `更新并重启.bat` 才生效**(与变体那条同一批次,不额外增加发布动作)。
|
||||
|
||||
### A4 取 cookie 的全键空间 SCAN `[P0]`
|
||||
|
||||
**证据链**:`maixiang_task_api/main.py:300 /api/cookie/get` → `:315 async for k in redis_client.scan_iter(match=f"{country}:*", count=100)`。
|
||||
**代价**:SCAN 的 `match` 是**扫完再过滤**,成本取决于键空间大小而非命中数。每一次开页要一个 cookie 就扫一遍全库,与队列 `LMOVE`、心跳抢同一条 Redis 连接池。
|
||||
**改法**:`/cookie/add` 时 `SADD cookie:{country}`、失效时 `SREM`,`get_cookie` 改 `SRANDMEMBER cookie:{country} 3`,保留 `:301-305` 注释写明的"随机打散取用"意图(那注释是为了避免所有并发任务抢同一个 cookie 被风控拉黑)。
|
||||
**风险**:存量 cookie 必须一次性回填 Set,漏回填=取不到 cookie=整链失败。这是本组唯一硬风险,上线判据要写"取空计数为 0"。
|
||||
|
||||
---
|
||||
|
||||
## 三、B 组:DB 与对象存储往返浪费
|
||||
|
||||
### B1 心跳每 60 秒整行读任务 + 全实体序列化进 Redis `[P1]`
|
||||
|
||||
- 频率:`app_client/amazon/main.py:311 HEARTBEAT_INTERVAL = 60`,每个在跑任务一次 POST `/api/tasks/{id}/heartbeat`。
|
||||
- 服务端 `modules/task/service/TaskHeartbeatService.java:101-106 selectFileTask` 只有 `eq(id).last("limit 1")`,**没有 `.select()` 投影** ⇒ 把 `biz_file_task` 的 `request_json`、`result_json` 整列读回来(`FileTaskEntity.java:23-24`)。
|
||||
- `:198-202` 无条件 `handler.saveTaskCache(task)`;`AbstractModuleTaskCacheService.java:203-216` 把**整个实体** `writeValueAsString` 后 `SET` 进 Redis(24h TTL)。
|
||||
- 节流只有 similar-asin 实现了(`SimilarAsinTaskHeartbeatSpi.java:46 checkpointInterval()` 是全仓唯一覆盖点),其余模块每轮心跳都写。
|
||||
- 同项目已有裁剪惯例,属漏改:`TaskProgressLightAssembler.java:49`、`StaleTaskRepairService.java:70`。
|
||||
|
||||
**改法**:`selectFileTask` 加 `.select(id, status, moduleType, userId, updatedAt)`;新增轻字段版缓存写入(或让心跳只写进度键,任务实体交给状态变更点)。
|
||||
**风险**:PriceTrack 的 `loadTaskForExecution` 依赖缓存行里的 `requestJson` 非空(`TaskFinalizeSupport.java:32-33` 已注明),必须保留 DB 兜底路径。
|
||||
`【待测】result_json 字节分布`:`SELECT id, LENGTH(result_json) FROM biz_file_task WHERE module_type IN ('QUERY_ASIN','PATROL_DELETE','SHOP_DATA_CRAWL') ORDER BY 2 DESC LIMIT 20;` —— 决定这一条值不值得动。
|
||||
`【10-04 已测,判断作废一半】`生产库里 MB 级的 `result_json` 全在**终态历史行**,而心跳/stale 读的是 `status='RUNNING'`(41 行、几张大列均宽 244–525 B ⇒ 整轮上界 ~31.7 KB)。所以"整行读"不是这条的伤口,剩下值得动的只有"全实体序列化进 Redis"那一半,详见 §九。
|
||||
|
||||
### B2 载荷物理删除每次跑两条无 task_id 的 JSON 全表 COUNT `[P1]`
|
||||
|
||||
- `TransientPayloadStorageService.java:329-340` 与 `:343-358`:先按 task_id 收敛查一次,**查不到就回退全表** `IN(payload_json, values)`;`:275` 的注释自己写明「调用方正常路径下引用数必然为 0」⇒ 正常删除路径**必然**走到全表回退。合计每次删除 4 条 COUNT,其中 2 条在 JSON/TEXT 列上无索引可走(V121 已删相关索引)。
|
||||
- 调用面广:全仓 50+ 个 `deletePayloadIfPresent` / `deleteReplacedPayloadIfNeeded` 生产调用点(chunk 回传、scope state 覆盖、结果项升级旧对象等)。
|
||||
- 已有的批量版 `TransientPayloadDeleteOrchestrator.batchReferencedPointers`(`:235`)目前只有 `ModuleHistoryCleanupService.java:339` 一个调用方在用;`TaskResultItemService.java:184` 注释显示结果项那条热路径已经改走编排器了。
|
||||
|
||||
**改法**:把剩余高频调用点改投 `submitDeletes(List.of(v))` + 周期 flush(编排器已带 journal 与去重);或让全局回退只在 `extractTaskId(pointer)` 解析失败时才执行(`:311` 已解析成功却仍全局查,等于把收敛当预筛而不是当边界)。
|
||||
**风险**:去掉回退会重演 28459 误删——所以**只对"指针能解析出 task_id"的路径**取消全局回退,解析不出仍按现口径。
|
||||
|
||||
### B3 结果文件作业:三个调度参数互相打架 `[P1]`
|
||||
|
||||
- 每 10s claim 20 条并全部翻成 RUNNING(`TaskResultFileJobWorker.java:70-84` + yml:279 `local-worker-delay-ms:10000`、:285 `batch-size:20`);
|
||||
- 本地派发池只有 2 线程、in-flight 满 64 就直接回落**在调度线程内联执行**(yml:276、`TaskFileJobLocalDispatcher.java:36-37,74-78`);
|
||||
- 卡死线 5 分钟、每 60s 扫一次(yml:280、:283)⇒ 排队超 5 分钟的 RUNNING 被翻回 PENDING,真正开跑时 `activateRunningClaim` 的 CAS 失败,整轮白跑。
|
||||
- 更实的问题:`:352-368` 对 PENDING 超阈值每轮 `retry_count++`(封顶 `MAX_RETRY_COUNT-1`=4,`MAX_RETRY_COUNT=5` 在 `:29`)⇒ **排队时间吃掉重试预算**,作业之后只要遇到一次真实 RUNNING 超时就直接判 FAILED,拿不到设计意图里的 5 次机会。
|
||||
|
||||
**改法**:`runPendingJobs` 的 limit 改 `min(batchSize, 本地剩余容量)`;PENDING 分支只补发 dispatch 事件、不递增 retry_count(`TaskFileJobService.java:352-368`)。
|
||||
**风险**:47 个 `@Scheduled` 共用 pool-size 16(`SchedulingConfig.java:31`),内联回落会挤占其他定时任务;改完要回看 `requeued because task lock is busy` 计数有没有回升。
|
||||
|
||||
### B4 其余四条已定位的重复读 / 串行下载 `[P1-P2]`
|
||||
|
||||
| 位置 | 问题 | 量级 | 改法 |
|
||||
|---|---|---|---|
|
||||
| `SimilarAsinResultWorkbookAssembler.java:576-595`(+`:646-658`)、`AppearancePatentTaskService.java:2466-2485` | 导出时逐分片 `LIMIT 1` 分页取片,且每个源文件都全量重扫 | 源文件数 × 分片数 次单行 SELECT + 载荷 GET | 一次 `selectList` 取回片列表,按片自带 `scopeHash` 过滤(外观 `:517` 已按 submissionId 生成) |
|
||||
| `SimilarAsinPayloadSupport.java:210/219/238` → `:244-259` | `prompt/apiKey/imgSwitch/categorySwitch` 各读一次全量 parsed payload(下载+反序列化+行对象复制 2-3 份),调用点 `SimilarAsinPipelineSupport.java:1018-1021` | 每轮回传 × 4-6 次全量读 | 合并成一个 `readTaskSettings(task)` 一次读完返回 record |
|
||||
| `PuzzleImageMerger.java:97-106`(`:211-231` 重试) | 一行 16 张 1688/alibaba 图仍串行下载,单张 10s(yml:363 池是 8 但这里没用) | 每行最多 16 次串行往返,最坏 320s | 复用 `SimilarAsinImageEmbedder` 已有的 `CompletionService + downloadPool(8) + 全局 deadline` 取字节,按 index 落回原顺序 |
|
||||
| `SimilarAsinLlmService.java:201`(`ProductCategoryService.java:43-50` 无缓存全表读)、`:359 tree.formatTwoLevels()` 每行重算 | 类目树每批全表 SELECT、两层清单每行重拼 | 图模式 `llm-batch-size:3` ⇒ 5000 行 ≈ 1667 次全表读 | `formatTwoLevels()` memoize;树按 `max(id)/updated_at` 做秒级 TTL |
|
||||
|
||||
`SimilarAsinImagePrefetchService.java:319 lookupBatch(...)` 已经写好但**全仓无调用方**,实际走 `:387 lookup(url)` 被 `SimilarAsinResultWorkbookAssembler.java:793-810` 在 URL 循环里逐条调;预热侧 `PREFETCH_POOL_SIZE=2` 且每 task 单 worker。属于"批量接口写了没接上"。
|
||||
|
||||
---
|
||||
|
||||
## 四、C 组:吞吐上限,先测再改
|
||||
|
||||
- **C1 单任务实际并发 ≈ 2,而闸给到 12。** 外观一轮批内:文本 10 行合 1 次调用、图片 10 行按 `llm-appearance-batch-size:5` 分 2 块并发(`AppearancePatentLlmClient.java:291-292` 的 `Semaphore(llmRowConcurrency=5)` 只在块数 >1 时才起作用),批与批之间串行(A1)。`task-queue.max-concurrent:12`(yml:314)远没用满。**先做 A1,再谈抬并发**——顺序反过来只会把等待搬个地方。
|
||||
- **C2 代理上游有没有账号级并发/RPM 上限,仍未归因。** 没测之前,抬并发、补消费者、MQ 化三条路都只能算猜测(外观一批 10 行线上实测 `costMs` 已到 214869/249250,慢在上游不在本机)。取数:同一任务把 `llm-row-concurrency` 从 5 抬到 8,观察 429/超时率与 `costMs` 分位;有 429 就说明上限在代理。
|
||||
- **C3 按负载选机(主机B 目前基本闲着)比 MQ 化便宜一个数量级。** `owner_instance_id` + `aiimage.instance-routing` 已保证"任务在哪台就由那台跑完",只需把**新任务落地机器**从"客户端解析到谁"改成按在飞作业数选机,不碰批次语义。
|
||||
- **C4 风控降级是进程全局的**:`func/amazon_base.py:163-168` 每页 401/403/503 都进同一个闸门,`config.py:51-54`(300s 窗口 / 阈值 8 / HOLD 600s)触发后把 4 槽压到 1 至少 10 分钟 ≈ 少产出 440 行(按单槽 880 行/h),且一个坏 cookie 池或一国风控会拖垮全部任务类型。改法:闸门按 `(task_type, country)` 分桶。**阈值要先看线上信号频次再动**,放宽等于真多烧代理费。
|
||||
|
||||
---
|
||||
|
||||
## 五、D 组:交付层低成本项
|
||||
|
||||
- **D1 管理后台首屏比用户端大 5.2 倍。** 实测产物:`admin-frontend-vue/dist/assets/index-CAmaFJ39.js` **1,127,603 B** + `index-CSE0eCeX.css` 383,318 B;用户端 `frontend-vue/new_web_source/assets/index-BwjSp_ZA.js` 217,568 B。根因:`admin-frontend-vue/src/main.ts:3-5` 全量 `import ElementPlus` + `element-plus/dist/index.css`,`vite.config.ts:32-35` 的 build 块没有 `manualChunks`。改法照用户端(`frontend-vue/vite.config.ts:5-7` 用 ElementPlusResolver),命令式组件样式按用户端 `main.ts:7-8` 补两行。**这是纯前端构建改动,风险最低、见效最快。** `【10-04 已落地】`同树 A/B 实测入口 JS −34.7%、CSS −45.6%、dist 整树 −567,203 B;改法与护栏见 §九。只欠逐页浏览器视觉验证。**落地时没照用户端的 `ElementPlusResolver`**:自动引入会把"到底注册了哪些组件"藏进构建产物,而这条的失败模式恰恰是漏注册不报错,显式注册表才能让护栏从源码推标签清单做双向比对。
|
||||
- **D2 轻量进度端点已就绪但只接了 5/12。** `frontend-vue/src/shared/api/progress-light.ts:19-32` 白名单 12 个模块、`endpoints.ts` 12 个 `progressLight` 都在;实际只有 appearancePatent / patrolDelete / queryAsin / shopDataCrawl / withdraw 五个 tab 调 `getModuleProgressLight`。`BrandSimilarAsinTab.vue:206` 仍传重型 `getSimilarAsinTaskProgressBatch`(同类还有 publish / priceTrack / collectData / deleteBrand / productRisk / shopMatch)。`useLiveTaskBoard.ts:430` 无条件调 `fetchProgressBatch`,所以每个 tab 的收益取决于它自己传的是哪个函数——照 `BrandAppearancePatentTab.vue:159` 的 `beforeBatch` + 行版本门控写法迁移即可。轮询节奏:可见 10s / 隐藏 60s(`task-progress-config.ts:16-17`)。
|
||||
- **D3 后台列表拉 LONGTEXT。** `modules/imagevideo/mapper/ImageVideoAdminTaskMapper.java:19` 列表 SELECT 了 `request_json/submit_response_json/result_json/video_urls_json/archived_videos_json`(V71 为 LONGTEXT),但列表只用 `request_json` 里一个标量(`ImageVideoAdminTaskService.java:226 modeOf`),另两列只有详情 `:238-245` 用。同类:`ShopDataCrawlDailyFileService.java:138-142` 无投影读 `row_payload`(MEDIUMTEXT, V93)却只用于判空(`ShopDataCrawlTaskService.java:849`)/取 resultId(`ShopDataCrawlAdminTasksService.java:96`)。改法:列表用 `JSON_UNQUOTE(JSON_EXTRACT(...))` 取标量,大列留给详情查询。
|
||||
- **D4 任务中心看板每 30s 全量 UNION COUNT + OFFSET 分页。** `TaskCenterBoardPage.vue:43,242` 每 30s 三接口;`TaskCenterQueryService.java:137` 对 `biz_file_task ∪ brand_crawl_tasks` 无时间界计数、`:144` OFFSET 无页上限;`TaskCenterQueryMapper.java:258-274` 的 UNION-ALL 每页被执行两遍,`:220-229` 含 4 个相关子查询 `EXISTS … LIKE '%…%'`。改法:总数短 TTL 缓存 + `last_id` 游标(范式见 `DedupeTotalDataService.java:194-201`)。
|
||||
- **D5 gzip 需要取证再定。** 仓库里的网关模板 `scripts/deploy_nginx_gateway.py:70-84` 只有 sendfile/tcp_nopush,全仓 grep 无 `gzip on`;但线上真正生效的是主机B `/opt/1panel/www/conf.d/api.aishufu.top.conf`(不在仓库),1Panel 可能已在全局开 gzip。**先 `curl -H 'Accept-Encoding: gzip' -sI <json接口>` 看有没有 `Content-Encoding`**,有就别动。
|
||||
- **D6 无依赖的串行 await**:`BrandPriceTrackTab.vue:1652-1653`、`BrandProductRiskTab.vue:495-496,805-806` 先 `await loadHistory()` 再 `await loadDashboard()`,两者互不依赖;`GroupEditorDialog.vue:58`、`pages/records/history-api.ts:17` 用 `page_size=999` 一次拉全量用户。
|
||||
|
||||
---
|
||||
|
||||
## 六、口径已知的遗留杠杆(不是新发现,列出来免得重复讨论)
|
||||
|
||||
1. **外观专利图片按内容寻址缓存** —— 唯一攻图片输入 token 的一条,也是合批之后剩余最大的成本杠杆,仍未做。
|
||||
2. **ASIN 跨任务缓存命中率低的真实原因(本次查清)**:键设计是干净的 `(country, asin)` 唯一键(`AsinResultCacheMapper.java:49-72`),TTL 按采集端真实开页时间 `observed_at`(`AsinResultCacheService.java:232`)——**不是键坏了**。0.1% 命中来自覆盖面与截断:服务端唯一写入口在 `CollectDataService.java:1855` 且硬编码 `AVAILABILITY_OK`(`AsinResultCacheService.java:187`);多选国家直接不写(`CollectDataService.java:1867-1874` → `AsinResultCacheService.java:175-178`);空价不写(`:181-183`);单次查询/写入各 500 行截断且不补查(`:95-98`、`:134-137`,默认值 yml:404-405);表没有保留期清理任务。要提命中率,动"多国家不写"和 500 截断这两处,别动 TTL。
|
||||
3. `FOR UPDATE SKIP LOCKED` 路线仍未实施。
|
||||
4. `biz_file_task.result_json` 存明文 apiKey 的泄露面仍未处理。
|
||||
|
||||
## 七、已经排除、不必再查的
|
||||
|
||||
加索引方向(瓶颈是行锁与大 JSON 列);清 `/app/java` 的 jar 备份;缩短 `DEFAULT_WAIT_MILLIS`;进一步合并 LLM 调用次数 / 词典替提词 / 拼图合并 / 家族页一次取价;空价格行的 KKBrowser 兜底耗时(只占 3.3%~3.9%);结果文件作业"纯轮询驱动"(`TaskFileJobDispatchCoordinator.java:25-45` 有事件点火);前端 `setInterval` 泄漏(两侧 8 个调用点,卸载清理与模块级单例都核过);Excel 导出(写出统一 `SXSSFWorkbook(200)` 流式,读入已改流式);`TaskObservabilityMetrics` 确认未接生产(无 `@Component`、无生产调用方、pom 无 prometheus registry),要做告警走日志字段或补 registry。
|
||||
|
||||
## 八、建议执行顺序
|
||||
|
||||
1. **A1 + B3**(外观批间重读 + 结果作业调度)——都在 jar 里,可同批发;A1 单条就能把 5000 行任务的批间空档基本抹掉。
|
||||
2. **A2**——需要一次判定口径的确认(同批同品牌共享结论),拍完就改。
|
||||
3. **A4**(18960)+ **A3**(采集机 `更新并重启.bat`,与变体攒批同一次更新)——与既欠的 18960 / 4.0.42 发版并批,不额外开窗口。
|
||||
4. **D1**(后台分包按需)——纯前端,随时可做。
|
||||
5. **B1/B2/B4** 一批发,收益是 DB 与对象存储往返,不改语义。
|
||||
6. **C2 的归因测量**与 C1/C3 的实施穿插做;不要在测出代理上限之前抬并发。
|
||||
|
||||
---
|
||||
|
||||
## 九、10-04 二轮:实做状态与实测否证
|
||||
|
||||
这一节是"做完之后回头量"的记录,与前八节的**预估**冲突时以本节为准。四条改完都在本地树,**尚未部署**。
|
||||
|
||||
### D1 后台按需注册 Element Plus —— 已落地,体积差是同树 A/B 实测
|
||||
|
||||
改法:新增 `admin-frontend-vue/src/plugins/element.ts`(逐个 `import El*` + 按组件引
|
||||
`element-plus/es/components/<短名>/style/css`),`main.ts` 改调 `installElement(app)`,
|
||||
全局中文语言包换到 `App.vue` 的 `<el-config-provider :locale="zhCn">`。
|
||||
|
||||
**A/B 只翻 `src/main.ts` + `src/App.vue` 两个入口文件**,其余文件(含同期在改的多公司那几份)
|
||||
两轮完全一致,所以下面的差值可整份归给这一条。A 组跑了两次,字节与文件名哈希完全相同(可复现):
|
||||
|
||||
| 产物 | B 整包(HEAD) | A 按需 | 差 |
|
||||
| --- | --- | --- | --- |
|
||||
| 入口 JS | 1,129,783 B(gzip 376.44 kB) | 737,303 B(gzip 250.12 kB) | **−34.7%** |
|
||||
| 入口 CSS | 383,318 B(gzip 52.89 kB) | 208,595 B(gzip 29.88 kB) | **−45.6%** |
|
||||
| dist 整树 | 1,950,119 B | 1,382,916 B | **−567,203 B(−29.1%)** |
|
||||
|
||||
护栏:`tests/perf-element-on-demand.test.ts` 7 例 + `tests/perf-admin-repeat-requests.test.ts` 3 例,
|
||||
`tests/align-locale.test.ts` 的落点从 main.ts 迁到 App.vue(强度不降)。清单不由人手写,
|
||||
而是**从 src 的 `.vue` 里把 `el-*` 标签推出来再双向比对注册表与样式导入**——按需引入最坏的
|
||||
失败模式是"某页面某组件没样式/渲染成裸标签",它不会让构建变红,所以护栏必须能自己发现漏项。
|
||||
变异自证 9 点全杀(M1 注册表缺项、M2 漏 dialog 样式、M3 漏 message-box 样式、M4 留死条目、
|
||||
M5 在页面里图省事引整包 CSS、M6 main.ts 搬回 `use(ElementPlus)`、M7 摘掉 `:locale`、
|
||||
M8 让 `reAnalyze` 再白拉一次整集、M9 把 `loadShopOptions` 放回 30s 心跳),还原后 sha256 一致。
|
||||
前端全量 `node --test tests/*.test.ts`(`npm test` 就是这个命令,本仓跑不了 vitest)**1698 例 0 红**。
|
||||
|
||||
**仍未做:逐页浏览器视觉验证。** 上面那套护栏证的是"清单齐、没有整包入口回流",
|
||||
证不了"每个页面每个组件真的长对了"——这条要人在真浏览器过一遍才算收口。
|
||||
|
||||
顺带两条重复请求(同批改,各由上面那条护栏钉住不得回流):
|
||||
- `DuplicateCheckPage.reAnalyze()` 原先 `await fetchDuplicateConsole(全空参数)` 把返回值丢掉、
|
||||
紧接着 `loadConsole()` 又拉一次;console 端点纯读,那一次是白跑的整集查询 ⇒ 删掉。
|
||||
- `TaskCenterBoardPage.refreshAll()` 的 `Promise.all` 里无条件带 `loadShopOptions()`,
|
||||
而它是 30s 心跳走的同一个函数,店铺候选是后端 `SELECT DISTINCT` 无缓存的字典数据
|
||||
⇒ 改为 `silent` 分档,心跳不重拉。代价:新入库店铺要等下一次进页/切页签/点「刷新」才进下拉。
|
||||
|
||||
### A2 外观品牌校验合批 —— 已落地,且把三个回退点并进了同一次批查询
|
||||
|
||||
- `BrandCheckClient` 新增 `checkTitleTexts(List<String>, strategy)`:一次 `checkWords`、
|
||||
**整批共用一个 `deadlineNanos`**、跨行 `LinkedHashSet` 去重、结论按行归因、返回与入参同序同长。
|
||||
- `AppearancePatentLlmClient.inspectRows` 的形状改成"一条 `(row, LlmResult)` 队列 + 唯一出口
|
||||
`applyLlmRowsInOneBatch`":标题缺失 / 标题识别失败 / 外观识别失败**三个回退点不再各自逐行发
|
||||
品牌查询**(回退行查的是整条原始标题,`splitTitleText` 能切出十几个词,逐行发反而最贵),
|
||||
与正常行合用同一次批查询。`pending.isEmpty()` 的早退分支也要刷,否则回退行连结论都拿不到。
|
||||
单参 `applyResult(row, result)` 重载已删(grep 零调用方 + 编译验证)。
|
||||
- 语义变化就是当初拍过的那条:同批同品牌共享一次结论。**行数不变、LLM 请求次数不变、
|
||||
代理提取次数不变** ⇒ 零成本;收益在上游劣化时把爆炸半径从"每行一个 90s 预算"收回"每批一个"。
|
||||
- 护栏:`AppearancePatentBrandBatchTest` 3 例 + `BrandCheckClientTitleBatchTest` 4 例,
|
||||
`AppearancePatentLlmClientTest` 里原来盯逐行 `checkTitleText` 的那条改为钉批接口
|
||||
(`times(1)` + `never().checkTitleText`)。断言各自守一个坑:`times(1)` 证明合批真发生了,
|
||||
而不是把逐行调用换了个名字;两行结论不同证明批内归因停在行,别行的侵权词没渗进干净行。
|
||||
变异 6/6 全杀。后端全量套件 **Tests run: 3631, Failures: 0, Errors: 0**(Skipped 7)BUILD SUCCESS。
|
||||
|
||||
### 实测否证:四条不要照本文的预估动手
|
||||
|
||||
- **#7 货源结果分片投影**:实测 ≈**0.13 ms/任务**,不改。
|
||||
- **#8 stale-check 八段全列扫加 `.select()` 投影**:生产实跑一轮 `s=0`(扫描 0 行)、
|
||||
整轮 29–33 ms;库里 `status='RUNNING'` 只有 **41 行**、几张大列均宽 **244–525 B**
|
||||
⇒ 整轮读回来的上界 ~31.7 KB。投影在"几乎读不到行"的热路径上没有可省的字节,不改。
|
||||
- **B1 的因果判断订正**:本文 B1 说"心跳每 60 秒整行读才是真伤口",**这条不成立**。
|
||||
实测 MB 级的那批 `result_json` 宽度属于**终态历史行**,而心跳/stale 的读取集合是
|
||||
`status='RUNNING'`(41 行 × 均宽 244–525 B ⇒ 上界 31.7 KB)。B1 剩下的真价值在
|
||||
"全实体 `writeValueAsString` 进 Redis"那一半,不在整行读这一半。
|
||||
- **#10 桌面跟价流水化**:主机B 的 live 路径是 `/opt/maixiang/maixiang_run_task` 的**单线程
|
||||
HTTP worker**(`pt_worker` 未运行),消费速率 <1 s/条、40–88 条/分;用户感知的等待主要来自
|
||||
客户端 **3 s 轮询粒度**与共享队列,不是本机串行。并发提交只会把等待从"执行"搬进"排队",
|
||||
并且多条共用同一把代理租约 IP ⇒ 有增加提取次数的风险。**不做。**
|
||||
|
||||
### 本轮新发现、尚未处理
|
||||
|
||||
- 主机B `/opt/maixiang/maixiang_run_task/logs/price-track-run.log` **逐条打印 jikip 提取 URL
|
||||
(含 key)**,约 53 MB/日 ⇒ 同时是凭据落盘面和日志体积问题,待决定是否加日志脱敏。
|
||||
- 待定档:跟价客户端首段轮询 3 s → 0.5 s(零成本,但属客户端默认值改动且要出包,不擅自改)。
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,719 +0,0 @@
|
||||
# 客户端任务管理(后台看板)实现计划
|
||||
|
||||
> **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 固定(不做配置)。
|
||||
@@ -1,159 +0,0 @@
|
||||
# 品牌检测失败自动补测(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 不做。
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@@ -1,350 +0,0 @@
|
||||
# 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**
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,766 +0,0 @@
|
||||
# 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 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。
|
||||
- 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。
|
||||
@@ -1,279 +0,0 @@
|
||||
# 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。
|
||||
@@ -1,52 +0,0 @@
|
||||
# 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 摘除)。
|
||||
@@ -1,157 +0,0 @@
|
||||
# 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 更新。
|
||||
@@ -1,221 +0,0 @@
|
||||
# 00 总览:后台管理系统 Vue 化与 Flask 移除
|
||||
|
||||
## 1. 文档目的
|
||||
|
||||
本目录是后台管理系统 Vue 化、Java 收敛和 Flask 管理能力移除的唯一设计输入,供后续 step-2 按功能点拆分任务。
|
||||
|
||||
本次范围不是客户端前端重构。客户端工程 `frontend-vue/` 及其 `new_web_source/` 不属于本项目的后台前端产物。
|
||||
|
||||
## 2. 已确认决策
|
||||
|
||||
| 主题 | 决策 |
|
||||
|---|---|
|
||||
| 前端工程 | 独立 `admin-frontend-vue/` |
|
||||
| UI | Vue 3 + TypeScript + Element Plus |
|
||||
| 状态 | Pinia 只保存用户、菜单和全局应用状态;页面数据局部管理 |
|
||||
| 路由 | Vue Router History;生产基准路径 `/admin-vue/` |
|
||||
| 菜单 | Java 后端返回树形菜单;前端不写死菜单分组 |
|
||||
| 权限粒度 | 仅菜单/页面级;不做按钮级权限 |
|
||||
| 权限存储 | 继续复用 `columns` 和 `user_column_permission` |
|
||||
| 权限 key 与 URL | 分离;`column_key` 是稳定权限标识,`route_path` 是 Vue 页面路径 |
|
||||
| API | 保持 `/api/admin/*`;不新建 v2 API |
|
||||
| 认证 | 复用现有同源 Cookie/Session;不引入 JWT |
|
||||
| 后端 | Java 成为后台管理唯一后端;Flask 管理能力完全移除 |
|
||||
| 版本接口 | Java 提供 `/api/version`、`/api/version/latest`,路径和字段不变 |
|
||||
| 静态资源 | Nginx 独立目录托管,不打进 Java JAR |
|
||||
| 入口 | `/admin` 重定向 `/admin-vue/` |
|
||||
| 旧链接 | 不兼容旧 `#tab=xxx` 和旧后台路径 |
|
||||
| 菜单迁移 | 通过 Flyway 正式迁移 |
|
||||
| 首批 | 后台壳层、用户、菜单、数据权限分组 |
|
||||
| 视觉 | 深色侧边栏 + 浅色内容区 |
|
||||
|
||||
## 3. 当前实现基线
|
||||
|
||||
### 3.1 旧后台前端
|
||||
|
||||
- 页面:`backend/web_source/admin.html`,包含 17 个面板、26 个弹窗和全部页面样式。
|
||||
- 业务脚本:`backend/static/admin.js`,将请求、状态、DOM 渲染、权限和轮询集中在单个 IIFE。
|
||||
- 横切交互:`backend/static/admin-interactions.js`,负责 loading、toast、confirm、键盘和按钮增强。
|
||||
- Java 静态副本:`backend-java/src/main/resources/static/admin.html` 及 `static/admin.js`。
|
||||
|
||||
### 3.2 现有后台 API
|
||||
|
||||
- Flask 管理蓝图:`backend/blueprints/admin_api.py`。
|
||||
- Java 管理控制器:`backend-java/src/main/java/com/nanri/aiimage/modules/admin/controller/AdminUserController.java`、`AdminConsoleController.java`。
|
||||
- Java 权限控制器:`backend-java/src/main/java/com/nanri/aiimage/modules/permission/controller/PermissionMenuController.java`。
|
||||
- 版本管理:`backend-java/src/main/java/com/nanri/aiimage/modules/softwareversion/controller/SoftwareVersionAdminController.java`。
|
||||
|
||||
### 3.3 已有权限数据模型
|
||||
|
||||
- `columns`:菜单、分组和页面节点。
|
||||
- `user_column_permission`:用户到菜单节点的直接授权。
|
||||
- `PermissionMenuService`:负责有效权限展开、父子菜单和授权边界。
|
||||
|
||||
## 4. 目标架构
|
||||
|
||||
```text
|
||||
Browser
|
||||
│
|
||||
├── /admin
|
||||
│ └── 302 → /admin-vue/
|
||||
│
|
||||
└── /admin-vue/*
|
||||
│
|
||||
▼
|
||||
Nginx/OpenResty
|
||||
├── /admin-vue/assets/* → 独立静态资源
|
||||
├── /admin-vue/<route> → History fallback 到 index.html
|
||||
└── /api/* → Java
|
||||
│
|
||||
├── Session/Auth
|
||||
├── Admin APIs
|
||||
├── Menu Tree API
|
||||
├── Version Admin API
|
||||
└── Public Version API
|
||||
```
|
||||
|
||||
```text
|
||||
admin-frontend-vue/
|
||||
├── src/layout/ # AdminLayout、侧边栏、顶栏
|
||||
├── src/router/ # History 路由和菜单守卫
|
||||
├── src/stores/ # Pinia 用户/菜单状态
|
||||
├── src/api/ # 后台 API 适配
|
||||
├── src/pages/account/ # 首批账号权限模块
|
||||
├── src/pages/asin/ # ASIN 数据中心
|
||||
├── src/pages/shop/ # 店铺中心
|
||||
├── src/pages/tasks/ # 任务和重复分析
|
||||
├── src/pages/records/ # 历史、版本
|
||||
└── dist/ # Nginx 发布目录
|
||||
```
|
||||
|
||||
## 5. 精确依赖图:现状符号到目标符号
|
||||
|
||||
| 当前文件与符号 | 当前依赖 | 目标替代/消费者 |
|
||||
|---|---|---|
|
||||
| `backend/blueprints/main.py:admin_page` | `blueprints.admin_api._load_current_backend_menu_items`、`utils.render.render_html`、`web_source/admin.html` | 删除 Flask 页面职责;`AdminConsoleController.adminPage` 重定向 `/admin-vue/` |
|
||||
| `backend/blueprints/main.py:serve_static` | `backend/static/*` | 删除后台静态托管职责;Nginx 托管 `admin-frontend-vue/dist` |
|
||||
| `backend/blueprints/admin_api.py:get_admin_current_user` | Flask Session、当前用户查询 | `AdminConsoleController.currentUser` |
|
||||
| `backend/blueprints/admin_api.py:get_admin_current_user_menus` | `_load_current_backend_menu_items`、Java 权限代理 | `AdminConsoleController.currentUserMenus` + `PermissionMenuService.getUserColumnPermissions` + 树构造器 |
|
||||
| `backend/blueprints/admin_api.py:list_users` | Flask DB/Java 代理、`_ensure_backend_menu_access` | `AdminUserController.listUsers` + `AdminUserService.listUsers` |
|
||||
| `backend/blueprints/admin_api.py:create_user/update_user/delete_user` | Flask 管理用户逻辑 | `AdminUserController.createUser/updateUser/deleteUser` |
|
||||
| `backend/blueprints/admin_api.py` 的菜单 CRUD 路由 | Flask 权限代理 | `PermissionMenuController.listMenus/createMenu/updateMenu/deleteMenu/reorderColumns` |
|
||||
| `backend/blueprints/version.py:api_version` | `APP_VERSION`、`APP_UPDATE_URL` | `PublicVersionController.currentVersion` |
|
||||
| `backend/blueprints/version.py:api_version_latest` | `utils.db.get_db`、`web_config` | `PublicVersionController.latestVersion` + `SoftwareVersionService.latestSoftwareVersion` |
|
||||
| `backend/web_source/admin.html` 的 `panel-users` | `admin.js:loadUsers`、DOM ID 约定 | `pages/account/UsersPage.vue` |
|
||||
| `backend/web_source/admin.html` 的 `panel-columns` | `admin.js:loadColumns`、拖拽排序 | `pages/account/MenusPage.vue` + 菜单 API |
|
||||
| `backend/web_source/admin.html` 的 `panel-group-manage` | `admin.js:loadShopManageGroups`、分组弹窗 | `pages/account/GroupsPage.vue` |
|
||||
| `backend/static/admin.js:loadAdminCurrentUser` | `/api/admin/current-user` | `api/session.ts:fetchCurrentUser` + `stores/admin-session.ts:initialize` |
|
||||
| `backend/static/admin.js:loadAdminMenus` | `/api/admin/current-user/menus`、`renderAdminTabs` | `api/session.ts:fetchAdminMenuTree` + `AdminLayout.vue` |
|
||||
| `backend/static/admin.js:activateAdminTab` | `hideAllAdminPanels`、`runTabLoader` | `router/index.ts` + 路由级异步页面组件 |
|
||||
| `backend/static/admin-interactions.js:showToast` | `adminToastRegion` | Element Plus `ElMessage` |
|
||||
| `backend/static/admin-interactions.js:openConfirm` | `adminConfirmModal` | Element Plus `ElMessageBox` |
|
||||
| `backend-java/.../AdminConsoleController.currentUser` | `AdminAuthSupport.requireAdminOrInternal` | 保留,作为 Vue Session 初始化接口 |
|
||||
| `backend-java/.../AdminConsoleController.currentUserMenus` | `PermissionMenuService.getUserColumnPermissions` | 保留调用,增加树形组装;输出 `key/name/route/children` |
|
||||
| `backend-java/.../PermissionMenuService.getUserColumnPermissions` | `columns`、`user_column_permission`、父子展开 | 保留为菜单权限唯一来源 |
|
||||
| `backend-java/.../AdminUserController.listUsers` | `AdminUserService.listUsers` | Vue `UsersPage` API 适配层 |
|
||||
| `backend-java/.../PermissionMenuController.listMenus` | `PermissionMenuService.list` | Vue `MenusPage` API 适配层 |
|
||||
| `backend-java/.../SoftwareVersionAdminController` | `SoftwareVersionService`、`web_config` | Vue Records/Version 页面 |
|
||||
| `frontend-vue/*` | 客户端 Vite 多页面工程 | 不依赖、不修改、不作为后台工程入口 |
|
||||
|
||||
## 6. 目标菜单数据契约
|
||||
|
||||
接口:`GET /api/admin/current-user/menus`。
|
||||
|
||||
目标响应的 `items` 是树形数组。页面节点至少包含:
|
||||
|
||||
| 字段 | 来源 | 语义 |
|
||||
|---|---|---|
|
||||
| `key` | `columns.column_key` | 稳定菜单权限标识 |
|
||||
| `name` | `columns.name` | 展示名称 |
|
||||
| `route` | `columns.route_path` | Vue Router 页面路径,不包含 `/admin-vue` 基准前缀 |
|
||||
| `children` | `columns.parent_id` | 子菜单;叶子页面可省略或为空数组 |
|
||||
| `sort` | `columns.sort_order` | 仅用于后端排序,是否输出由最终 DTO 决定 |
|
||||
|
||||
不输出按钮级 `actions`,不新增操作权限表。
|
||||
|
||||
## 7. 实现顺序
|
||||
|
||||
1. 固化 Java 版本接口契约和菜单树 DTO。
|
||||
2. 完成 Flyway 后台 route_path 迁移。
|
||||
3. 完成后台前端壳层、Session、菜单守卫。
|
||||
4. 完成账号与权限首批页面。
|
||||
5. 完成版本/历史和低风险数据页面。
|
||||
6. 完成 ASIN、店铺、任务、重复检查页面。
|
||||
7. 做 Java API 对照、权限回归、客户端版本更新回归。
|
||||
8. Nginx 发布 `/admin-vue/`,将 `/admin` 重定向到 Vue。
|
||||
9. 删除 Flask 管理蓝图、旧 admin 模板和旧管理脚本。
|
||||
10. 删除旧菜单响应、旧静态资源和迁移期间兼容代码。
|
||||
|
||||
## 8. 迁移边界
|
||||
|
||||
本次必须保留:
|
||||
|
||||
- `/api/version`。
|
||||
- `/api/version/latest`。
|
||||
- `/api/admin/*` 的业务 API 路径和业务响应语义。
|
||||
- Cookie/Session 登录态。
|
||||
- `columns`、`user_column_permission` 的数据库模型。
|
||||
|
||||
本次最终删除:
|
||||
|
||||
- Flask 管理页面路由。
|
||||
- Flask 管理 API 蓝图。
|
||||
- Flask 管理后台静态资源。
|
||||
- 旧 `admin.html`、`admin.js`、`admin-interactions.js`。
|
||||
- 客户端请求不到的 Flask 版本蓝图(版本能力已迁移 Java)。
|
||||
|
||||
## 10. 模块职责
|
||||
|
||||
本总览模块负责定义后台前端、Java API、权限存储、公开版本接口、静态部署和 Flask 删除之间的边界;不直接实现业务页面。
|
||||
|
||||
## 11. 依赖关系
|
||||
|
||||
所有模块依赖 `00-overview.md` 的技术选型和发布边界;页面模块依赖壳层与 Session 菜单模块;Java 菜单、版本和部署模块是最终切换的后端前置条件。
|
||||
|
||||
## 12. 核心接口
|
||||
|
||||
核心外部接口包括 `/admin`、`/admin-vue/`、`/api/admin/current-user`、`/api/admin/current-user/menus`、`/api/version`、`/api/version/latest`;各接口的原实现到目标实现映射见第 5 节和对应独立 spec。
|
||||
|
||||
## 13. 内部结构
|
||||
|
||||
总体系由独立后台前端、Java 管理 API、权限数据库、公开版本服务和 Nginx 发布层组成,结构图见第 4 节。
|
||||
|
||||
## 14. 类型映射
|
||||
|
||||
总体系的关键类型映射为:`column_key → menu key`、`route_path → Vue route`、`PermissionMenuItemVo[] → AdminMenuNode[]`、`web_config version/file_url → PublicVersionResponse`。
|
||||
|
||||
## 15. 迁移/实现注意事项
|
||||
|
||||
本总览约束所有子 spec 不得引入客户端前端依赖、按钮级权限、JWT、旧 hash 兼容或 Flask 管理长期兼容分支;未在本总览批准的跨模块变更必须先更新决策和对应 spec。
|
||||
## 9. 主要风险与验收标准
|
||||
|
||||
### P0:客户端更新接口中断
|
||||
|
||||
证据:Flask `version.py` 当前提供 `/api/version/latest`,客户端已有固定调用。
|
||||
|
||||
验收:Java 接口在 Flask 停止后仍返回同路径、同字段、同空数据语义;至少完成真实 HTTP 回归。
|
||||
|
||||
### P0:菜单权限树错误导致后台不可用或越权展示
|
||||
|
||||
证据:当前权限展开依赖 `PermissionMenuService` 和 `user_column_permission`。
|
||||
|
||||
验收:超级管理员、管理员、普通账号、无菜单权限账号分别验证菜单树和路由守卫;页面 API 仍由后端鉴权。
|
||||
|
||||
### P1:History 刷新 404
|
||||
|
||||
证据:Vue Router 使用 History,生产由 Nginx fallback。
|
||||
|
||||
验收:直接访问并刷新 `/admin-vue/account/users`、`/admin-vue/account/menus`;不存在的静态资源必须返回 404 而不是 HTML。
|
||||
|
||||
### P1:路由迁移破坏权限关系
|
||||
|
||||
证据:现有后端大量使用旧 `column_key`,而新版 URL 需要重组。
|
||||
|
||||
验收:Flyway 只改变 `route_path`,旧 `column_key` 授权关系保持可解析;菜单 key 与 route 独立测试。
|
||||
|
||||
### P2:前端首屏包过大
|
||||
|
||||
证据:Element Plus 和后台所有模块会产生较大 bundle。
|
||||
|
||||
验收:页面组件按路由异步加载;首批页面不得把所有业务模块静态导入首屏。
|
||||
|
||||
@@ -1,78 +0,0 @@
|
||||
# 01 后台前端壳层与路由
|
||||
|
||||
## 模块职责
|
||||
|
||||
提供所有后台页面共用的应用外壳,不承载业务列表和业务请求。负责侧边栏、顶栏、内容区、页面标题、全局错误展示、退出登录入口,以及 Vue Router 的页面容器。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:`02-session-menu-permission.md` 提供用户和菜单状态;`10-static-deployment-and-nginx.md` 提供 `/admin-vue/` 基准路径和 History fallback。
|
||||
|
||||
下游:所有业务页面挂载到 `AdminLayout` 的 `RouterView`;Pinia Session Store 提供菜单树和用户信息。
|
||||
|
||||
现有依赖:
|
||||
|
||||
- `backend/web_source/admin.html` 的 `.admin-layout`、`.admin-sidebar`、`.admin-topbar`、`.admin-content`。
|
||||
- `backend/static/admin-interactions.js` 的 loading、toast、confirm 横切行为。
|
||||
- 当前独立工程的 `admin-frontend-vue/src/layout/AdminLayout.vue`、`src/router/index.ts`、`src/styles/main.css`。
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 原实现 | 目标实现 |
|
||||
|---|---|
|
||||
| `admin.html` 内嵌完整布局 | `AdminLayout.vue` + 子组件 |
|
||||
| `admin.js:activateAdminTab` 通过 DOM 隐藏/显示面板 | Vue Router 路由切换 |
|
||||
| `admin.js:syncTabHash` 使用 `#tab` | History URL,如 `/admin-vue/account/users` |
|
||||
| `admin-interactions.js:showToast` | Element Plus `ElMessage` |
|
||||
| `admin-interactions.js:openConfirm` | Element Plus `ElMessageBox` |
|
||||
| 页面标题写死并由 DOM 更新 | 路由 `meta.title` 驱动 |
|
||||
|
||||
## 内部结构
|
||||
|
||||
```text
|
||||
AdminLayout
|
||||
├── AdminSidebar
|
||||
│ ├── 菜单分组
|
||||
│ └── 菜单页面项
|
||||
├── AdminTopbar
|
||||
│ ├── 当前页面标题
|
||||
│ ├── 当前用户名/角色
|
||||
│ └── 退出登录
|
||||
├── AdminContent
|
||||
│ ├── 全局错误提示
|
||||
│ └── RouterView
|
||||
└── 全局 Element Plus 消息/确认能力
|
||||
```
|
||||
|
||||
路由结构按业务域组织:
|
||||
|
||||
- `account/*`
|
||||
- `asin-center/*`
|
||||
- `shop-center/*`
|
||||
- `tasks/*`
|
||||
- `records/*`
|
||||
|
||||
路由 path 不承担权限标识,权限判断使用路由元数据中的 `menuKey` 与后端菜单节点 `key` 对比。
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 旧概念 | 目标类型 |
|
||||
|---|---|
|
||||
| `data-tab` | Vue route path |
|
||||
| `route_path` | 后端菜单 `route` |
|
||||
| `adminPageTitle` | `RouteMeta.title` |
|
||||
| `adminMenu` DOM | `AdminMenuNode[]` |
|
||||
| `adminCurrentUsername` | `AdminUser.username` |
|
||||
| `adminCurrentUserRole` | `AdminUser.role` |
|
||||
|
||||
`AdminMenuNode` 至少包含 `key`、`name`、可选 `route`、可选 `children`。
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. `createWebHistory('/admin-vue/')` 的基准路径必须和 Vite `base`、Nginx location 完全一致。
|
||||
2. 不实现旧 `#tab=xxx` 兼容;旧地址不属于目标契约。
|
||||
3. 不能把所有业务页面静态 import 到壳层;页面必须按路由异步加载。
|
||||
4. 侧边栏只渲染后端返回的菜单树,不根据角色在前端硬编码一份权限菜单。
|
||||
5. 页面级无权限时跳转到当前用户第一个可见页面;没有任何页面时展示无菜单状态。
|
||||
6. 视觉保持深色侧边栏、浅色内容区,但不得把旧 CSS 2.5 万行整体搬运进新工程。
|
||||
7. 全局 loading 只用于请求生命周期提示;业务页面仍需拥有自己的表格 loading 和空状态。
|
||||
@@ -1,81 +0,0 @@
|
||||
# 02 登录态、菜单树与菜单级权限
|
||||
|
||||
## 模块职责
|
||||
|
||||
负责后台 Vue 启动时的当前用户加载、菜单树加载、Cookie/Session 复用、路由级菜单权限判断、退出登录和未登录处理。本模块只处理菜单/页面级权限,不处理按钮级权限。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:Java `AdminAuthSupport`、`AdminConsoleController.currentUser`、`AdminConsoleController.currentUserMenus`、`PermissionMenuService.getUserColumnPermissions`。
|
||||
|
||||
下游:`AdminLayout`、Vue Router 守卫、所有页面权限元数据。
|
||||
|
||||
数据表:`columns`、`user_column_permission`、`users`。
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 接口/符号 | 原实现 | 目标实现 |
|
||||
|---|---|---|
|
||||
| 当前用户 | Flask `get_admin_current_user` 或 Java `AdminConsoleController.currentUser` | Java `GET /api/admin/current-user`,维持 `{item}` 语义 |
|
||||
| 菜单 | Flask `get_admin_current_user_menus` 返回扁平项;Java同样返回扁平项 | Java `GET /api/admin/current-user/menus` 返回树形 `items` |
|
||||
| 登出 | `admin.js` 直接 fetch `/api/admin/logout` | `api/session.ts:logout`,由 Pinia action 调用 |
|
||||
| 权限展开 | Flask `_effective_permission_sets` 或 Java `PermissionMenuService` | 统一由 Java `PermissionMenuService` 完成 |
|
||||
| 前端权限 | `hasAdminTabAccess`、`applyTabAccess` | Router guard 比较 `route.meta.menuKey` 和菜单树 `key` |
|
||||
|
||||
## 目标菜单契约
|
||||
|
||||
菜单节点:
|
||||
|
||||
- `key`:稳定的 `columns.column_key`。
|
||||
- `name`:展示名称。
|
||||
- `route`:相对于 `/admin-vue/` 的页面路径,例如 `account/users`。
|
||||
- `children`:分组节点和页面节点的层级。
|
||||
- `sort`:后端排序字段;前端按后端顺序展示,不二次重排。
|
||||
|
||||
分组节点可以没有 `route`;页面节点必须有 `route` 才能进入页面。
|
||||
|
||||
## 内部结构
|
||||
|
||||
```text
|
||||
admin-session store
|
||||
├── user
|
||||
├── menuTree
|
||||
├── initialized
|
||||
├── loading
|
||||
└── error
|
||||
|
||||
初始化顺序
|
||||
1. GET /api/admin/current-user
|
||||
2. GET /api/admin/current-user/menus
|
||||
3. 保存用户和菜单树
|
||||
4. Router guard 校验目标页面
|
||||
5. 无目标路径时进入第一个可见页面
|
||||
```
|
||||
|
||||
Cookie 规则:
|
||||
|
||||
- 请求使用同源 Cookie/Session。
|
||||
- 前端不保存密码、JWT 或长期敏感凭证。
|
||||
- Axios `withCredentials` 必须开启。
|
||||
- 401 统一跳转 `/login`,并携带当前目标路径作为 redirect 信息;是否实际接受 redirect 参数由登录模块决定。
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 原字段 | 目标字段 |
|
||||
|---|---|
|
||||
| `route_path` | `route` |
|
||||
| `column_key` | `key` |
|
||||
| `parent_id` | `children` 关系 |
|
||||
| `adminCurrentUsername` | `AdminUser.username` |
|
||||
| `currentUserRole` | `AdminUser.role` |
|
||||
| `adminTabs` | `AdminMenuNode[]` |
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. 后端必须先过滤当前用户的有效菜单,再组装树,不能把全量菜单发给前端后让前端过滤。
|
||||
2. 超级管理员可以获得全部 admin 菜单,但仍应通过同一树形 DTO 返回。
|
||||
3. 页面权限只控制菜单可见性和路由进入;具体 API 继续由 Java 后端鉴权。
|
||||
4. 不新增按钮级 `actions` 字段,不新增 action 权限表。
|
||||
5. 不保留 `X-Admin-Menu-Format` 双格式,不根据 User-Agent、查询参数或调用方返回不同菜单结构。
|
||||
6. `column_key` 继续作为稳定权限 key,Flyway 只迁移 `route_path`,避免现有 Java 业务权限常量失效。
|
||||
7. 菜单树为空时必须区分“权限为空”和“接口失败”,不能把接口失败误显示为无权限。
|
||||
@@ -1,86 +0,0 @@
|
||||
# 03 账号与权限页面
|
||||
|
||||
## 模块职责
|
||||
|
||||
覆盖首批账号与权限页面:用户管理、菜单管理、数据权限分组。负责列表、筛选、分页、编辑/新增入口、菜单树展示和分组管理入口,但权限粒度仍只到页面菜单。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:`02-session-menu-permission.md` 的用户和菜单状态;Java `AdminUserController`、`PermissionMenuController`、分组相关管理接口。
|
||||
|
||||
下游:`AdminLayout` 路由;后续业务页面使用用户选择器、分组数据。
|
||||
|
||||
旧页面来源:
|
||||
|
||||
- `admin.html#panel-users`
|
||||
- `admin.html#panel-columns`
|
||||
- `admin.html#panel-group-manage`
|
||||
- `admin.js:loadUsers`、`bindUserActions`
|
||||
- `admin.js:loadColumns`、`bindColumnActions`
|
||||
- `admin.js:loadShopManageGroups`、`initShopManageGroupPanel`
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 功能 | 原实现 | 目标实现 |
|
||||
|---|---|---|
|
||||
| 用户列表 | Flask `list_users` / Java `AdminUserController.listUsers` | `UsersPage.vue` 调用 `GET /api/admin/users` |
|
||||
| 新建用户 | `create_user` / `AdminUserController.createUser` | `UsersPage` 的 Element Plus Dialog + `POST /api/admin/user` |
|
||||
| 编辑用户 | `update_user` / `AdminUserController.updateUser` | Dialog 表单 + `PUT /api/admin/user/{uid}` |
|
||||
| 删除用户 | `delete_user` / `AdminUserController.deleteUser` | `ElMessageBox` 确认 + `DELETE /api/admin/user/{uid}` |
|
||||
| 菜单列表 | `admin.js:loadColumns` | `MenusPage.vue` + `GET /api/admin/permission-menus?menuType=admin` |
|
||||
| 菜单新增/编辑/删除 | Flask/Java 菜单 CRUD | Element Plus Dialog/Tree + 对应 `permission-menus` API |
|
||||
| 菜单排序 | `bindColumnDragSort`、`persistColumnOrder` | 菜单树同级排序组件 + `POST /api/admin/column/reorder` |
|
||||
| 用户菜单授权 | 旧用户编辑中的权限树 | 用户编辑时调用 `GET/PUT /api/admin/permission-users/{uid}/column-permissions` |
|
||||
| 分组列表 | `loadShopManageGroups` | `GroupsPage.vue` + `/api/admin/shop-manage-groups` |
|
||||
|
||||
## 内部结构
|
||||
|
||||
```text
|
||||
AccountPageGroup
|
||||
├── UsersPage
|
||||
│ ├── UserFilterBar
|
||||
│ ├── UserTable
|
||||
│ ├── UserEditorDialog
|
||||
│ └── UserPermissionTree
|
||||
├── MenusPage
|
||||
│ ├── MenuTreeTable
|
||||
│ ├── MenuEditorDialog
|
||||
│ └── SameLevelSortInteraction
|
||||
└── GroupsPage
|
||||
├── GroupFilter/summary
|
||||
├── GroupTable
|
||||
└── GroupEditorDialog
|
||||
```
|
||||
|
||||
页面级状态必须局部化:
|
||||
|
||||
- 当前页数据。
|
||||
- 筛选条件。
|
||||
- 分页。
|
||||
- Dialog/Drawer 可见状态。
|
||||
- 表单草稿。
|
||||
- 保存中的 loading。
|
||||
|
||||
Pinia 不保存这些业务表格状态。
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 原字段/概念 | 目标类型 |
|
||||
|---|---|
|
||||
| `userListBody` | `AdminUser[]` |
|
||||
| `userPagination` | `PaginationState` |
|
||||
| `columnTree` | `AdminMenuNode[]` / `PermissionMenuItem[]` |
|
||||
| `column_id` | `number` |
|
||||
| `created_by_id` | `number | null` |
|
||||
| `role` | 联合字面量或后端枚举映射 |
|
||||
| `grant_menu_routes` | `number[]` 的菜单 ID 授权请求 |
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. 用户接口分页字段要按 Java 实际 VO 归一化,不能直接假设 Flask 字段命名。
|
||||
2. 删除、创建、编辑继续保留后端权限校验;前端不添加按钮级权限体系。
|
||||
3. 菜单管理必须区分 admin 菜单和 app 菜单,默认只操作 `menuType=admin`。
|
||||
4. 菜单分组节点不应被当作可进入页面;叶子页面才产生 Router route。
|
||||
5. 用户授权更新必须提交菜单 ID,而不是前端路由字符串,除非后端 API 明确支持 route。
|
||||
6. 菜单迁移后 `column_key` 保持稳定,页面 URL 通过 `route_path` 变化。
|
||||
7. 数据权限分组的业务 API 若仍以旧字段返回,必须在 `api/groups.ts` 适配为稳定的前端 DTO,禁止把兼容逻辑散落在表格模板中。
|
||||
@@ -1,94 +0,0 @@
|
||||
# 04 ASIN 数据中心
|
||||
|
||||
## 模块职责
|
||||
|
||||
将旧后台中与 ASIN、品牌库、最低价和商品类目相关的页面重组为 ASIN 数据中心,保持现有 API 语义,改善筛选、导入、导出、详情抽屉和批量操作流程。
|
||||
|
||||
覆盖页面:
|
||||
|
||||
- 去重数据汇总:`dedupe-total-data`
|
||||
- 品牌数据库/无效 ASIN:`invalid-asin-data`
|
||||
- 查询 ASIN:`query-asin`
|
||||
- 最低价 ASIN:`skip-price-asin`
|
||||
- 商品类目:`product-categories`
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:账号菜单权限、用户和数据权限分组;Java 对应控制器和服务;统一下载/上传/进度适配器。
|
||||
|
||||
旧实现文件:
|
||||
|
||||
- `backend/web_source/admin.html` 的 `panel-dedupe-total-data`、`panel-invalid-asin-data`、`panel-query-asin`、`panel-skip-price-asin`、`panel-product-categories`。
|
||||
- `backend/static/admin.js:loadDedupeTotalData`、`loadInvalidAsinData`、`loadQueryAsin`、`loadSkipPriceAsin`、`loadProductCategories`。
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 领域 | 原接口族 | 目标前端模块 |
|
||||
|---|---|---|
|
||||
| 去重汇总 | `/api/admin/dedupe-total-data`、`/export`、`/import`、`/delete-import`、进度查询 | `pages/asin/DedupeRegistryPage.vue` |
|
||||
| 品牌数据库 | `/api/admin/invalid-asin-data` | `pages/asin/InvalidAsinPage.vue` |
|
||||
| 查询 ASIN | `/api/admin/query-asins`、`/query-asin`、`/export`、`/import`、`/delete-import` | `pages/asin/QueryAsinPage.vue` |
|
||||
| 最低价 ASIN | `/api/admin/skip-price-asins`、`/skip-price-asin`、导入/删除导入/导出 | `pages/asin/SkipPricePage.vue` |
|
||||
| 商品类目 | `/api/admin/product-categories/*`、`/product-category` | `pages/asin/ProductCategoriesPage.vue` |
|
||||
|
||||
API 路径保持 `/api/admin/*`,本模块只改变请求编排和页面表现,不改变后端业务规则。
|
||||
|
||||
## 内部结构
|
||||
|
||||
```text
|
||||
AsinCenter
|
||||
├── Registry
|
||||
│ ├── FilterBar
|
||||
│ ├── Import/ExportToolbar
|
||||
│ ├── PaginatedTable
|
||||
│ └── ImportProgressDialog
|
||||
├── InvalidAsin
|
||||
│ ├── FilterBar
|
||||
│ ├── PaginatedTable
|
||||
│ └── EditorDialog
|
||||
├── QueryAsin
|
||||
│ ├── FilterBar
|
||||
│ ├── Import/ExportToolbar
|
||||
│ ├── PaginatedTable
|
||||
│ └── DetailDrawer
|
||||
├── SkipPrice
|
||||
│ ├── FilterBar
|
||||
│ ├── Import/ExportToolbar
|
||||
│ ├── PaginatedTable
|
||||
│ └── DetailDrawer
|
||||
└── ProductCategories
|
||||
├── SearchBar
|
||||
├── CategoryTreeTable
|
||||
└── EditorDialog
|
||||
```
|
||||
|
||||
共用 composable:
|
||||
|
||||
- 分页和查询参数序列化。
|
||||
- 文件导入任务轮询。
|
||||
- 下载响应头文件名解析。
|
||||
- ASIN/国家/店铺选择器。
|
||||
- 删除确认。
|
||||
- 空结果和错误提示。
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 原字段 | 目标类型/规则 |
|
||||
|---|---|
|
||||
| `page`、`page_size` | `PaginationQuery` |
|
||||
| `items`、`total`、`total_pages` | `PaginatedResult<T>` |
|
||||
| `import_id` | `ImportJobId`,字符串化处理,禁止丢失大整数精度 |
|
||||
| `country`/`country_codes` | 国家代码联合类型;展示名称由共享字典转换 |
|
||||
| `file_url`、`download_url` | `DownloadDescriptor`,统一空白值判定 |
|
||||
| 抽屉详情字段 | `Record<string, unknown>` 经页面 schema 归一化,不直接在模板遍历原始 JSON |
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. 不把五个页面继续合成一个巨型组件;每个页面独立管理局部筛选、分页和弹窗。
|
||||
2. 导入流程必须保留“上传—解析—确认—入队—轮询—终态”的状态语义,不能只根据 HTTP 200 判断成功。
|
||||
3. 导出必须通过统一下载适配器处理文件名、空响应、错误响应和大文件等待。
|
||||
4. ASIN 详情抽屉只读展示时要做字段白名单和敏感字段脱敏,不能直接 `JSON.stringify` 全量输出。
|
||||
5. 查询条件切换时取消或失效旧请求,避免后返回的旧查询覆盖新结果。
|
||||
6. 所有删除操作保留二次确认;后端仍是最终鉴权边界。
|
||||
7. 商品类目树的展开状态属于页面局部状态,不放进 Pinia。
|
||||
8. 本模块不引入新的后端 v2 API;若 Flask 与 Java 字段存在差异,在 Admin API adapter 中完成归一化。
|
||||
@@ -1,79 +0,0 @@
|
||||
# 05 店铺中心
|
||||
|
||||
## 模块职责
|
||||
|
||||
将店铺密钥、店铺账号、最低价配置和店铺相关基础操作组织为店铺中心。最低价 ASIN 的复杂数据操作在 `04-asin-data-center.md` 定义,本文件只描述店铺侧入口和基础店铺管理边界。
|
||||
|
||||
覆盖页面:
|
||||
|
||||
- 店铺密钥:`shop-keys`
|
||||
- 店铺管理:`shop-manage`
|
||||
- 店铺分组选择器和店铺账号编辑
|
||||
- 店铺凭证展示、遮罩和安全操作
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:菜单树和用户权限;Java 店铺控制器;分组/用户选择器;下载和 confirm 基础组件。
|
||||
|
||||
旧实现:
|
||||
|
||||
- `admin.html` 的 `panel-shop-keys`、`panel-shop-manage`。
|
||||
- `admin.js:loadShopKeys`、`loadShopManage`、`loadShopManageGroups`、`renderShopPasswordCell`、`bindShopKeyActions`、`bindShopManageActions`。
|
||||
|
||||
Java API 主要来源:
|
||||
|
||||
- `ShopKeyController`:`/api/admin/shop-keys`、`/api/admin/shop-key`。
|
||||
- `ShopManageController`:`/api/admin/shop-manages`、`/api/admin/shop-manage`、凭证和分组接口。
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 功能 | 原实现 | 目标实现 |
|
||||
|---|---|---|
|
||||
| 店铺密钥列表 | `admin.js:loadShopKeys` | `ShopKeysPage.vue` + `/api/admin/shop-keys` |
|
||||
| 新增/编辑密钥 | 原生 modal + DOM 表单 | Element Plus Dialog + `/api/admin/shop-key` |
|
||||
| 店铺列表 | `admin.js:loadShopManage` | `ShopManagePage.vue` + `/api/admin/shop-manages` |
|
||||
| 店铺新增/编辑/删除 | DOM modal、手写确认 | Dialog/Drawer + `/api/admin/shop-manage` |
|
||||
| 店铺凭证 | `renderShopPasswordCell` | 显式遮罩组件,按需显示 |
|
||||
| 店铺分组 | 旧多处 select 和自定义下拉 | 可复用 `ShopGroupSelect`,数据来源统一 |
|
||||
|
||||
## 内部结构
|
||||
|
||||
```text
|
||||
ShopCenter
|
||||
├── ShopKeysPage
|
||||
│ ├── FilterBar
|
||||
│ ├── KeysTable
|
||||
│ └── KeyEditorDialog
|
||||
└── ShopManagePage
|
||||
├── FilterBar
|
||||
├── ShopsTable
|
||||
├── ShopEditorDrawer
|
||||
├── ShopGroupSelect
|
||||
└── CredentialReveal
|
||||
```
|
||||
|
||||
敏感字段生命周期:
|
||||
|
||||
1. 默认以遮罩或掩码展示。
|
||||
2. 用户主动点击后才显示短时内容。
|
||||
3. 不写入 Pinia、localStorage、URL 或日志。
|
||||
4. API 返回失败或离开页面时清理临时明文。
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 原字段 | 目标类型/规则 |
|
||||
|---|---|
|
||||
| `shop_name`、`mall_name` | `ShopSummary` |
|
||||
| `zn_username`、账号、密码 | `ShopCredential`,敏感字段分离 |
|
||||
| `group_id` | `number | null`,统一转成表单值 |
|
||||
| 紫鸟令牌/密钥 | `SensitiveString`,禁止进入通用日志 |
|
||||
| 店铺分页响应 | `PaginatedResult<ShopSummary>` |
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. 页面级权限只决定是否显示和进入店铺中心,不新增“查看密码”“编辑店铺”等按钮权限模型。
|
||||
2. 后端现有角色和数据权限校验必须保持;前端隐藏按钮不是安全措施。
|
||||
3. 编辑店铺和店铺密钥的表单不能共用一个无类型的大对象,避免提交多余字段。
|
||||
4. 删除、重置密钥、覆盖账号等不可逆操作必须使用明确的确认文案。
|
||||
5. 分组数据加载应有缓存但必须有失效机制;页面切换不应重复创建无限轮询或请求。
|
||||
6. 店铺凭证不能出现在错误消息、网络日志、埋点和前端异常上报中。
|
||||
@@ -1,94 +0,0 @@
|
||||
# 06 任务与重复分析中心
|
||||
|
||||
## 模块职责
|
||||
|
||||
覆盖高复杂度的任务记录、批量下载、权限配置和店铺数据重复检查,拆分旧 `admin.js` 中长函数和多种视图状态,保证任务轮询、下载和分析视图互不污染。
|
||||
|
||||
覆盖页面:
|
||||
|
||||
- 视频任务记录:`image-video-tasks`
|
||||
- 店铺数据记录:`shop-data-crawl-tasks`
|
||||
- 店铺数据重复检查:`shop-data-duplicate-check`
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:菜单级页面权限、统一任务状态类型、下载 URL/文件下载适配器、用户和店铺分组选择器。
|
||||
|
||||
旧实现:
|
||||
|
||||
- `admin.js:loadImageVideoTasks`
|
||||
- `admin.js:loadShopDataCrawlTasks`
|
||||
- `admin.js:loadShopDataDuplicateCheckOverview`
|
||||
- `admin.js:loadShopDataDuplicateCheckItems`
|
||||
- `admin.js:loadShopDataDuplicateDetail`
|
||||
- `admin.js:saveImageVideoPermissions`
|
||||
- `admin.js:saveShopDataTaskPermissions`
|
||||
|
||||
Java API 来源:
|
||||
|
||||
- `AdminImageVideoTaskController`
|
||||
- `AdminShopDataCrawlTasksController`
|
||||
- `AdminShopDataDuplicateCheckController`
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 功能 | 原实现 | 目标实现 |
|
||||
|---|---|---|
|
||||
| 视频任务列表 | DOM 卡片、批量下载 | `ImageVideoTasksPage.vue` + 状态化任务卡片/表格 |
|
||||
| 视频任务权限配置 | 旧权限 modal | 页面内 Permission Dialog,仍是用户/数据范围配置,不是按钮权限 |
|
||||
| 店铺数据任务 | 店铺分组卡片、分页 | `ShopDataTasksPage.vue` + 独立筛选和任务列表状态 |
|
||||
| 店铺数据批量下载 | 旧脚本直接组装 ZIP 请求 | `BatchDownloadController` composable + 下载状态面板 |
|
||||
| 重复检查总览 | `loadShopDataDuplicateCheckOverview` | `DuplicateCheckPage.vue` 的 Overview 区域 |
|
||||
| 重复检查明细 | `loadShopDataDuplicateCheckItems/detail` | Overview、Items、Detail 三个明确的数据源和视图状态 |
|
||||
| 重复检查导出/导入 | 旧按钮和 modal | 明确的任务状态 Dialog;不阻塞列表刷新 |
|
||||
|
||||
## 内部结构
|
||||
|
||||
```text
|
||||
TaskCenter
|
||||
├── ImageVideoTasksPage
|
||||
│ ├── TaskFilter
|
||||
│ ├── PermissionScopeDialog
|
||||
│ ├── TaskCardGrid
|
||||
│ └── BatchDownloadPanel
|
||||
├── ShopDataTasksPage
|
||||
│ ├── FilterBar
|
||||
│ ├── ShopTaskTable/CardView
|
||||
│ ├── PermissionScopeDialog
|
||||
│ └── BatchDownloadPanel
|
||||
└── DuplicateCheckPage
|
||||
├── FilterBar
|
||||
├── MetricsCards
|
||||
├── DistributionView
|
||||
├── DuplicateItemsTable
|
||||
└── DetailDrawer
|
||||
```
|
||||
|
||||
状态隔离:
|
||||
|
||||
- 每个页面维护自己的 filter key、page、loading 和 error。
|
||||
- 重复检查的总览、列表、详情使用独立请求 key。
|
||||
- 批量下载使用独立 job 状态,不能复用普通列表 loading。
|
||||
- 页面卸载时取消轮询、清理计时器和 AbortController。
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 原字段/概念 | 目标类型 |
|
||||
|---|---|
|
||||
| 任务状态字符串/数字 | `TaskStatus` 归一化枚举 |
|
||||
| `task_id`、`result_id` | `TaskId`、`ResultId`,保持字符串兼容 |
|
||||
| 结果文件 | `ResultFileDescriptor` |
|
||||
| 批量下载 | `BatchDownloadJob` |
|
||||
| 重复总览 | `DuplicateOverview` |
|
||||
| 重复明细 | `DuplicateItem`、`DuplicateDetail` |
|
||||
| 权限范围用户 | `PermissionUserItem[]` |
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. 任务列表刷新不能停止正在运行的下载或导出任务。
|
||||
2. 轮询必须有终态、失败退避、可见性降频和卸载清理,不能在组件每次更新时创建新计时器。
|
||||
3. 批量下载必须处理部分失败、响应头文件名、空文件和服务端错误摘要。
|
||||
4. 重复检查的 Overview、Items、Detail 不得使用一个全局 `currentData`,避免抽屉打开时覆盖主列表。
|
||||
5. 权限配置仍然是现有后端数据范围权限接口,不扩展为按钮 action 权限。
|
||||
6. 大数据导出必须展示等待状态,不得把完整数据加载到浏览器内存后再导出。
|
||||
7. 复杂视图可以保留专用 CSS,但公共表格、Dialog、Drawer、Pagination 使用 Element Plus。
|
||||
@@ -1,77 +0,0 @@
|
||||
# 07 记录与版本中心
|
||||
|
||||
## 模块职责
|
||||
|
||||
覆盖历史生成记录、客户端软件版本和数字人版本。该模块必须区分“后台管理版本页面”和“客户端公开更新接口”,前者可重构,后者必须保持兼容。
|
||||
|
||||
覆盖页面:
|
||||
|
||||
- 历史记录:`history`
|
||||
- 软件版本:`version`
|
||||
- 数字人版本:`digital-human-version`
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:菜单树、当前用户、分页/下载适配器。
|
||||
|
||||
后端:
|
||||
|
||||
- Java `ImageHistoryController`。
|
||||
- Java `SoftwareVersionAdminController`、`SoftwareVersionService`。
|
||||
- 数字人版本控制器和 `digitalhuman` 模块。
|
||||
|
||||
公开版本接口的详细契约见 `09-public-version-compatibility.md`。
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 功能 | 原实现 | 目标实现 |
|
||||
|---|---|---|
|
||||
| 历史记录 | `admin.js:loadHistory` + `panel-history` | `HistoryPage.vue` + 原 `/api/admin/history` |
|
||||
| 软件版本列表 | `admin.js:loadSoftwareVersions` + `/api/admin/versions` | `SoftwareVersionsPage.vue` |
|
||||
| 软件版本上传 | `admin.js` 上传 modal + `/api/admin/version` | Element Plus Upload/Dialog + 原接口 |
|
||||
| 数字人版本列表 | `admin.js:loadDigitalHumanVersions` | `DigitalHumanVersionsPage.vue` |
|
||||
| 数字人版本上传/发布 | 旧版本 modal 和按钮 | 页面局部表单,保持原数字人版本 API |
|
||||
| 客户端检查更新 | Flask `/api/version`、`/api/version/latest` | Java `PublicVersionController`,URL/字段完全不变 |
|
||||
|
||||
## 内部结构
|
||||
|
||||
```text
|
||||
RecordsCenter
|
||||
├── HistoryPage
|
||||
│ ├── HistoryFilterBar
|
||||
│ ├── HistoryTable
|
||||
│ └── ResultPreviewDrawer
|
||||
├── SoftwareVersionsPage
|
||||
│ ├── VersionTable
|
||||
│ └── SoftwareVersionUploadDialog
|
||||
└── DigitalHumanVersionsPage
|
||||
├── VersionTable
|
||||
├── UploadDialog
|
||||
└── Release/Latest actions
|
||||
```
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 原字段 | 目标类型 |
|
||||
|---|---|
|
||||
| `type` | `HistoryRecordType` |
|
||||
| `result_preview` | `PreviewDescriptor`,限制长度和字段 |
|
||||
| `version` | `VersionString` |
|
||||
| `file_url` | `PublicDownloadUrl` |
|
||||
| `created_at` | `DisplayDateTime`,后端格式化或前端统一解析 |
|
||||
| 数字人状态 | `DigitalHumanVersionStatus` |
|
||||
|
||||
公开接口映射:
|
||||
|
||||
- `/api/version`:`version`、`desc`、`url`。
|
||||
- `/api/version/latest`:`version`、`file_url`。
|
||||
- 不把 `/api/admin/version` 的上传响应当成客户端公开版本响应。
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. 软件版本管理页面调用 `/api/admin/versions` 和 `/api/admin/version`,客户端更新调用 `/api/version/latest`;二者不可混用。
|
||||
2. 最新版本判断沿用 `web_config.created_at DESC`,若同一时间并列,使用 id 倒序作为稳定次序。
|
||||
3. 上传成功后页面刷新列表,但不得改变公开接口的空值语义。
|
||||
4. 版本下载链接是公开客户端资源,页面展示时需要处理超长 URL,不把 URL 写入不必要的日志。
|
||||
5. 数字人版本与客户端软件版本是不同业务表和 API,不得合并 DTO。
|
||||
6. 历史记录预览要限制内容大小,避免大 JSON 直接阻塞页面。
|
||||
@@ -1,83 +0,0 @@
|
||||
# 08 Java 菜单树与 Flyway 权限迁移
|
||||
|
||||
## 模块职责
|
||||
|
||||
将 Java 权限模型作为后台菜单唯一来源,继续使用 `columns` 和 `user_column_permission`,把现有扁平有效菜单转换为后端维护的树形菜单,并通过 Flyway 把旧 route_path 迁移到新版 History 路由。
|
||||
|
||||
本模块不引入按钮级权限,不新增 action 表。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:现有数据库 `columns`、`user_column_permission`、`users`;`PermissionMenuService`。
|
||||
|
||||
下游:`AdminConsoleController.currentUserMenus`、Vue `fetchAdminMenuTree`、`MenusPage`。
|
||||
|
||||
相关文件和符号:
|
||||
|
||||
- `backend-java/.../permission/service/PermissionMenuService.java:getUserColumnPermissions`
|
||||
- `backend-java/.../permission/controller/PermissionMenuController.java:listMenus/createMenu/updateMenu/deleteMenu/reorderColumns`
|
||||
- `backend-java/.../permission/model/entity/PermissionMenuEntity.java`
|
||||
- `backend-java/.../permission/model/entity/UserColumnPermissionEntity.java`
|
||||
- `backend-java/.../admin/controller/AdminConsoleController.java:currentUserMenus`
|
||||
- `backend-java/src/main/resources/db/V100__admin_menu_frontend_routes.sql`(目标迁移文件)
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 内容 | 原实现 | 目标实现 |
|
||||
|---|---|---|
|
||||
| 当前用户菜单 | `List<PermissionMenuItemVo>` 扁平列表 | 树形 `items`,页面节点含 `key/name/route` |
|
||||
| 有效权限展开 | `PermissionMenuService.getUserColumnPermissions` | 保留,作为树输入;不在 Controller 重新实现授权规则 |
|
||||
| 菜单存储 | `columns.column_key` + `route_path` | `column_key` 保持稳定;`route_path` 改为 Vue path |
|
||||
| 用户授权 | `user_column_permission` | 保持不变 |
|
||||
| 菜单迁移 | 运行时 initializer 的默认菜单补齐 | Flyway 正式更新既有 admin route_path |
|
||||
| 权限菜单 CRUD | 旧 API 字段 | API 路径保持;页面使用树/表格适配器 |
|
||||
|
||||
## 内部结构\n\n`PermissionMenuService` 负责有效权限集合,`AdminConsoleController` 负责 DTO 树组装,Flyway 负责 route_path 数据迁移,`PermissionMenuController` 负责菜单管理 CRUD。\n\n## 目标树组装规则
|
||||
|
||||
1. 先由 `PermissionMenuService` 得到当前用户有效菜单集合。
|
||||
2. 以 `id` 建立节点索引。
|
||||
3. 用 `parent_id` 将子节点挂到父节点。
|
||||
4. 按 `sort_order`、再按稳定 key 排序。
|
||||
5. 分组节点可以无 route;页面节点带 route。
|
||||
6. 只返回当前用户有效节点,禁止返回全量菜单后由前端过滤。
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 数据库/旧 DTO | 目标菜单 DTO |
|
||||
|---|---|
|
||||
| `column_key` | `key` |
|
||||
| `name` | `name` |
|
||||
| `route_path` | `route` |
|
||||
| `parent_id` | `children` 关系 |
|
||||
| `sort_order` | 后端排序值 |
|
||||
| `menu_type=admin` | 后台菜单域 |
|
||||
|
||||
## Flyway 迁移内容
|
||||
|
||||
目标迁移按 `column_key` 更新 `route_path`,示例:
|
||||
|
||||
- `admin_users` → `account/users`
|
||||
- `admin_columns` → `account/menus`
|
||||
- `admin_group_manage` → `account/groups`
|
||||
- `admin_dedupe_total_data` → `asin-center/registry`
|
||||
- `admin_shop_manage` → `shop-center/shops`
|
||||
- `admin_history` → `records/history`
|
||||
- `admin_version` → `records/software-version`
|
||||
|
||||
迁移必须:
|
||||
|
||||
- 可重复执行或由 Flyway 保证版本只执行一次。
|
||||
- 不删除 `user_column_permission`。
|
||||
- 不修改既有 `column_key`,避免 Java 业务鉴权常量失效。
|
||||
- 迁移前后对比每个用户的有效菜单 key 集合。
|
||||
- 检查 `(menu_type, route_path)` 唯一约束。
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. `PermissionMenuSchemaInitializer` 仍可负责缺失基础表/默认数据兜底,但不能取代一次性数据迁移。
|
||||
2. Controller 不得根据当前请求头、User-Agent 或查询参数返回不同菜单结构。
|
||||
3. 树构造不能把同一个节点挂到多个父节点;发现脏数据应记录错误并阻止上线。
|
||||
4. 菜单分组虚拟 route 不能被当作页面路由。
|
||||
5. 新版前端不再兼容旧 route/hash,但权限 key 保持稳定,这两件事必须区分。
|
||||
6. 菜单 CRUD 新增页面时必须同时提供稳定 `column_key` 和 Vue `route_path`。
|
||||
|
||||
@@ -1,89 +0,0 @@
|
||||
# 09 客户端公开版本接口兼容
|
||||
|
||||
## 模块职责
|
||||
|
||||
把 Flask 版本蓝图中的公开客户端版本查询能力迁移到 Java,确保已发布客户端无需升级即可继续检查更新和下载新版本。
|
||||
|
||||
本模块只覆盖公开版本查询,不覆盖后台软件版本管理页面;后台页面见 `07-records-and-version.md`。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
原实现:
|
||||
|
||||
- `backend/blueprints/version.py:api_version`
|
||||
- `backend/blueprints/version.py:api_version_latest`
|
||||
- `backend/utils/db.py` 中 `web_config` 表初始化/访问
|
||||
|
||||
目标实现:
|
||||
|
||||
- `backend-java/.../softwareversion/controller/PublicVersionController.java:currentVersion`
|
||||
- `backend-java/.../softwareversion/controller/PublicVersionController.java:latestVersion`
|
||||
- `backend-java/.../softwareversion/service/SoftwareVersionService.java:latestSoftwareVersion`
|
||||
- `SoftwareVersionMapper`、`SoftwareVersionEntity`
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
### GET `/api/version`
|
||||
|
||||
原响应:
|
||||
|
||||
- `version`:当前服务版本,默认值与旧服务一致。
|
||||
- `desc`:当前为空字符串。
|
||||
- `url`:旧环境配置的更新 URL,当前保持空字符串/配置值语义。
|
||||
|
||||
目标:Java 直接提供同路径和同字段,不包装成通用 `ApiResponse`,避免改变客户端解析。
|
||||
|
||||
### GET `/api/version/latest`
|
||||
|
||||
原逻辑:
|
||||
|
||||
- 从 `web_config` 读取 `version`、`file_url`。
|
||||
- 按 `created_at DESC` 取第一条。
|
||||
- 无记录返回 `version=null,file_url=null`。
|
||||
|
||||
目标逻辑:Java `SoftwareVersionService.latestSoftwareVersion` 使用同一张表和同一次序规则。
|
||||
|
||||
### GET `/api/version/list`(2026-09-14 新增,非旧接口)
|
||||
|
||||
桌面端更新面板「指定版本更新」下拉的数据源:该功能允许用户显式安装某个历史版本(含回退),
|
||||
列表由服务端给全,前端不拼 OSS 地址(拼地址在版本被删除后会 404)。
|
||||
|
||||
- 匿名可达(与 `/latest` 同族,未登录也能用;登录页更新面板即匿名态)。
|
||||
- 按 `created_at DESC, id DESC` 返回最近 `PublicVersionLookup.DEFAULT_LIST_LIMIT`(50)条,
|
||||
上限 `MAX_LIST_LIMIT`(200);不作为则沿用旧 `version/file_url` 字段名。
|
||||
- 响应 `{"items":[{"id","version","file_url","created_at"}]}`,字段口径与管理端
|
||||
`/api/admin/versions` 一致(同一套前端解析);空表返回 `{"items":[]}`。
|
||||
- 同一版本的重复上传记录由前端按版本号去重(保留最新一条),后端不做折叠。
|
||||
|
||||
## 内部结构
|
||||
|
||||
```text
|
||||
PublicVersionController
|
||||
├── currentVersion()
|
||||
│ └── 应用版本配置
|
||||
├── latestVersion()
|
||||
│ └── SoftwareVersionService.latestSoftwareVersion()
|
||||
│ └── SoftwareVersionMapper → web_config
|
||||
└── listVersions()
|
||||
└── SoftwareVersionService.listPublicSoftwareVersions()
|
||||
└── SoftwareVersionMapper → web_config(LIMIT,字段口径同管理端列表)
|
||||
```
|
||||
|
||||
## 类型映射
|
||||
|
||||
| 旧字段 | 目标字段 | 约束 |
|
||||
|---|---|---|
|
||||
| `version` | `version` | 字符串,不自动转数字 |
|
||||
| `desc` | `desc` | 保留字段,即使为空 |
|
||||
| `url` | `url` | 保留字段,即使为空 |
|
||||
| `file_url` | `file_url` | 不改名为 `download_url` |
|
||||
| 空记录 | `null` | 不改成空对象或 `success=false` |
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. Flask 停止前必须完成 Java 接口真实 HTTP 验证。
|
||||
2. 不要将公开接口放到 `/api/admin/version`;客户端接口和后台上传接口职责不同。
|
||||
3. Java 服务启动失败或数据库不可用时,要记录明确错误;不要返回伪造的最新版本。
|
||||
4. 版本记录写入仍由后台版本管理 API 完成,公开查询只读。
|
||||
5. 上线验收至少使用一个有版本记录和一个空表/无记录夹具对比旧服务响应。
|
||||
6. 必须验证旧客户端的请求地址、字段读取和下载 URL 不需要修改。
|
||||
@@ -1,79 +0,0 @@
|
||||
# 10 静态资源部署与 Nginx History 托管
|
||||
|
||||
## 模块职责
|
||||
|
||||
定义后台 Vue 构建产物、Nginx 静态目录、History fallback、Java API 代理和 `/admin` 入口重定向的发布契约。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:`admin-frontend-vue/vite.config.ts` 的 `base=/admin-vue/`、`dist` 输出;Java API。
|
||||
|
||||
下游:浏览器访问后台、Vue Router 刷新、客户端 `/api/version/latest` 请求。
|
||||
|
||||
参考文件:
|
||||
|
||||
- `admin-frontend-vue/vite.config.ts`
|
||||
- `admin-frontend-vue/deploy/nginx-admin-vue.conf.example`
|
||||
- Java `AdminConsoleController.root/adminPage`
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 原实现 | 目标实现 |
|
||||
|---|---|
|
||||
| Java 重定向 `/admin.html` | Java 重定向 `/admin-vue/` |
|
||||
| Java classpath `admin.html` | Nginx 独立静态目录 `/var/www/admin-vue/` |
|
||||
| `admin.html` 内嵌 CSS/模板 | `dist/index.html` + hashed assets |
|
||||
| Flask `serve_static` | Nginx 静态资源 location |
|
||||
| 旧页面 hash 面板 | History route + fallback |
|
||||
|
||||
## 目录契约
|
||||
|
||||
```text
|
||||
/var/www/admin-vue/
|
||||
├── index.html
|
||||
├── assets/
|
||||
│ ├── index-<hash>.js
|
||||
│ ├── index-<hash>.css
|
||||
│ └── page-<hash>.js
|
||||
└── assets/logo.jpg
|
||||
```
|
||||
|
||||
浏览器路径:
|
||||
|
||||
- `/admin` → 302 `/admin-vue/`。
|
||||
- `/admin-vue/` → `index.html`。
|
||||
- `/admin-vue/account/users` → fallback `index.html`。
|
||||
- `/admin-vue/assets/<file>` → 真实文件。
|
||||
- `/api/*` → Java upstream。
|
||||
|
||||
## 内部结构
|
||||
|
||||
发布过程:
|
||||
|
||||
1. 在 `admin-frontend-vue` 执行依赖安装、类型检查和生产构建。
|
||||
2. 对 `dist/index.html`、assets 清单和入口引用做一致性校验。
|
||||
3. 上传到带版本号的临时发布目录。
|
||||
4. 校验完整后原子切换 Nginx 当前目录。
|
||||
5. 保留上一个版本目录用于快速回滚。
|
||||
|
||||
## 类型/路径映射
|
||||
|
||||
| 配置 | 目标值 |
|
||||
|---|---|
|
||||
| Vite `base` | `/admin-vue/` |
|
||||
| Vite `outDir` | `dist` |
|
||||
| Router history base | `/admin-vue/` |
|
||||
| Nginx 静态前缀 | `/admin-vue/` |
|
||||
| Java API upstream | `/api/` |
|
||||
| 登录跳转 | `/login` |
|
||||
|
||||
## 类型映射\n\n`dist/index.html` 映射为 `/admin-vue/` 入口;`dist/assets/*` 映射为 `/admin-vue/assets/*`;Vue Router 相对 route 映射为 `/admin-vue/<route>`;`/api/*` 不进入静态资源目录。\n\n## 迁移/实现注意事项
|
||||
|
||||
1. Nginx 对 `/admin-vue/assets/` 必须优先匹配真实文件,不能被 fallback 到 HTML。
|
||||
2. 不存在的 JS/CSS/图片必须返回 404,避免浏览器收到 HTML 后产生难以诊断的 MIME 错误。
|
||||
3. `try_files` 的 fallback 只针对 `/admin-vue/` 页面路径。
|
||||
4. hashed assets 可配置长期缓存;`index.html` 必须 no-cache 或短缓存。
|
||||
5. 发布不能把 `dist` 复制到客户端 `frontend-vue/new_web_source`。
|
||||
6. 静态资源不打进 Java JAR;Java 只承担 API 和入口重定向。
|
||||
7. 生产切换前必须验证 Nginx upstream 的 Cookie、Host、X-Forwarded-* 和 HTTPS 行为。
|
||||
|
||||
@@ -1,83 +0,0 @@
|
||||
# 11 Flask 管理能力移除与入口切换
|
||||
|
||||
> **状态(task-283 已执行阶段 5/6)**:Flask 管理蓝图(admin_api/auth/main)、`web_source/`、`backend/static/admin.*`、Java classpath 旧 admin.html/login.html 副本均已删除;`backend/app.py` 现仅保留版本公开 API 蓝图。Java 侧 `/`、`/admin`、`/admin.html` → `/admin-vue/`,`/login`、`/login.html` → `/admin-vue/login`(SPA 登录页)。Flask 进程(15124)仍保留 `/api/version*`,桌面客户端 `app_client` 的更新检查仍以它为 base_url,切换至 Java 前勿下线。工作区 `scripts/deploy.py` 的 pyfiles 动作已同步清理主机上的旧后台文件。
|
||||
|
||||
## 模块职责
|
||||
|
||||
定义从 Flask 管理后台到 Java + Vue 的最终切换、删除清单、回滚边界和依赖清理。版本公开接口不属于删除范围,因为已经迁移到 Java 后由客户端继续使用。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
前置:
|
||||
|
||||
- 所有后台页面完成 Vue 迁移。
|
||||
- Java `/api/admin/*` API 回归通过。
|
||||
- Java `/api/version`、`/api/version/latest` 回归通过。
|
||||
- Nginx `/admin-vue/` 正常服务。
|
||||
- Flyway 菜单 route_path 迁移完成。
|
||||
|
||||
被删除的 Flask 文件/符号:
|
||||
|
||||
- `backend/blueprints/main.py:admin_page`。
|
||||
- `backend/blueprints/admin_api.py` 的管理 API 路由和权限代理辅助函数。
|
||||
- `backend/web_source/admin.html`。
|
||||
- `backend/static/admin.js`。
|
||||
- `backend/static/admin-interactions.js`。
|
||||
- Java classpath 中同步旧后台的 `admin.html`、旧管理脚本副本。
|
||||
|
||||
保留并迁移后的能力:
|
||||
|
||||
- Flask `version.py:api_version` → Java `PublicVersionController.currentVersion`。
|
||||
- Flask `version.py:api_version_latest` → Java `PublicVersionController.latestVersion`。
|
||||
|
||||
## 核心接口:原实现 → 目标实现
|
||||
|
||||
| 迁移项 | 原实现 | 目标实现 |
|
||||
|---|---|---|
|
||||
| `/admin` | Flask/Java 旧 `admin.html` | Java/Nginx → `/admin-vue/` |
|
||||
| 管理页面 | Jinja + DOM | Nginx + Vue |
|
||||
| 管理 API | Flask `admin_api` 或 Java 兼容 API | Java 唯一实现 |
|
||||
| 公开版本检查 | Flask `version.py` | Java公开版本控制器 |
|
||||
| 管理权限 | Flask 代理/本地判断 + Java | Java `PermissionMenuService` |
|
||||
| 静态资源 | Flask/Java 双份 | Nginx 单份 dist |
|
||||
|
||||
## 内部结构
|
||||
|
||||
切换阶段:
|
||||
|
||||
```text
|
||||
阶段 1:Java API + Vue /admin-vue 并行开发
|
||||
阶段 2:Nginx 先发布 /admin-vue,不立即删除旧源文件
|
||||
阶段 3:/admin → /admin-vue/,开始真实用户回归
|
||||
阶段 4:确认版本接口和全部后台页面稳定
|
||||
阶段 5:删除 Flask 管理蓝图和旧后台资源
|
||||
阶段 6:清理旧权限响应、旧复制脚本、旧文档和部署配置
|
||||
```
|
||||
|
||||
## 类型映射\n\nFlask `admin_page` 映射为 Java `/admin` redirect;Flask `admin_api` 管理路由映射为 Java `/api/admin/*`;Flask `version.py` 映射为 Java `/api/version*`;旧 `admin.html` 映射为 Nginx `/admin-vue/index.html`。\n\n## 删除/保留清单
|
||||
|
||||
### 必须删除
|
||||
|
||||
- Flask 管理页面入口和管理 API。
|
||||
- 旧 admin HTML/JS/CSS 中只服务后台的代码。
|
||||
- Java static 中旧 admin 页面副本。
|
||||
- `admin.js` 依赖的旧 DOM ID 和旧 toast/confirm 容器。
|
||||
- 旧菜单扁平响应适配分支。
|
||||
|
||||
### 必须保留
|
||||
|
||||
- Java `/api/admin/*` 业务 API。
|
||||
- Java 登录态和后台鉴权。
|
||||
- `web_config` 版本表。
|
||||
- Java `/api/version`、`/api/version/latest`。
|
||||
- 客户端所需公开下载 URL。
|
||||
|
||||
## 迁移/实现注意事项
|
||||
|
||||
1. 删除 Flask 前必须确认生产 Nginx/API 流量不再指向 Python 管理接口。
|
||||
2. 删除旧页面前先保存一次前后端 API/权限快照,用于回归对比。
|
||||
3. 不因为后台删除而删除 `web_config` 或版本上传逻辑。
|
||||
4. Flask 进程如果还承担其他非管理插件能力,必须按部署文档单独确认;本 spec 只要求移除 Flask 的后台管理职责和版本查询职责,不能误删其他客户端插件 API。
|
||||
5. 若 Flask 进程承载不可迁移的其他 API,最终部署可以分离进程,但后台请求不得再依赖它;是否完全停止 Python 进程需以其他服务清单为前置验收。
|
||||
6. 切换失败时回滚的是 Nginx current 目录和 Java `/admin` 重定向,不回滚数据库已执行的 Flyway 版本;数据库迁移必须设计前向兼容。
|
||||
|
||||
@@ -1,110 +0,0 @@
|
||||
# 12 测试、回归与验收
|
||||
|
||||
## 模块职责
|
||||
|
||||
定义后台 Vue 化的测试层次、跨后端契约回归、版本接口保护和最终删除验收。该 spec 不实现测试代码,只规定后续任务必须覆盖的行为。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游:所有模块 spec;现有 `backend-java` Maven 测试体系;新 `admin-frontend-vue` 构建和测试命令。
|
||||
|
||||
相关现有测试/工具:
|
||||
|
||||
- `backend-java/src/test/java` 下的权限、控制器和契约测试。
|
||||
- `frontend-vue/tests` 仅作为客户端工程参考,不得把后台测试混入客户端测试目录。
|
||||
- 新后台测试放在 `admin-frontend-vue/tests`,Java 契约测试放在 `backend-java/src/test/java`。
|
||||
|
||||
## 核心接口\n\n测试对象包括菜单树、用户/权限 API、业务 API、公开版本接口、Nginx History 路由和 Flask 删除后的流量边界。\n\n## 内部结构\n\n验收分为前端静态检查、前端契约测试、Java API 契约测试、数据库迁移测试、真实 HTTP 验收和最终删除验收六层。\n\n## 类型映射\n\n测试夹具需要覆盖 `AdminMenuNode`、`AdminUser`、分页结果、任务状态、版本公开响应和空值响应。\n\n## 迁移/实现注意事项\n\n先冻结旧快照,再执行迁移和新实现回归;任何客户端版本接口差异都阻断 Flask 删除和 `/admin` 正式切换。\n\n## 测试层次
|
||||
|
||||
### 前端静态和类型检查
|
||||
|
||||
- Vue/TypeScript 类型检查零错误。
|
||||
- Vite 构建成功,产出 `dist/index.html` 和所有 assets。
|
||||
- 构建产物中的 base 路径全部为 `/admin-vue/`。
|
||||
- 页面模块按路由拆 chunk。
|
||||
- 工程不引用客户端 `frontend-vue/new_web_source`。
|
||||
|
||||
### 前端单元/契约测试
|
||||
|
||||
至少覆盖:
|
||||
|
||||
- 菜单树扁平节点组装为树。
|
||||
- 分组节点无 route 时不可作为页面进入。
|
||||
- 当前用户无菜单时展示空状态。
|
||||
- 非超级管理员访问无权限 route 时跳到第一个有权限页面。
|
||||
- 超级管理员可访问有效 admin 菜单。
|
||||
- 401 跳转登录。
|
||||
- API `{data}`、`{item}`、`{items}` 归一化。
|
||||
- 分页字段边界、空列表、请求失败。
|
||||
- 退出登录清理 Pinia 状态。
|
||||
- 上传/导入/下载终态和重复点击保护。
|
||||
|
||||
### Java API 契约测试
|
||||
|
||||
至少覆盖:
|
||||
|
||||
- `/api/admin/current-user` 返回当前用户的 `item`。
|
||||
- `/api/admin/current-user/menus` 只返回有效 admin 菜单树。
|
||||
- 树节点 `key`、`route`、`name` 和 parent-child 关系正确。
|
||||
- 普通用户、管理员、超级管理员菜单不同且不越权。
|
||||
- `/api/version` 字段为 `version/desc/url`。
|
||||
- `/api/version/latest` 字段为 `version/file_url`。
|
||||
- `web_config` 无记录返回两个 null。
|
||||
- 多条版本记录按创建时间和 id 稳定取最新。
|
||||
- 不带登录态访问需鉴权的 admin API 被拒绝。
|
||||
|
||||
### Flyway/数据库测试
|
||||
|
||||
- 迁移后所有 admin 菜单 route_path 唯一。
|
||||
- `column_key` 不被改写。
|
||||
- 用户直接授权记录数量不减少。
|
||||
- 父菜单授权的有效子菜单展开语义保持一致。
|
||||
- 重复执行迁移不会产生重复菜单或重复授权。
|
||||
|
||||
### Nginx/真实 HTTP 验收
|
||||
|
||||
- `/admin` 返回 302 到 `/admin-vue/`。
|
||||
- `/admin-vue/` 返回 HTML。
|
||||
- `/admin-vue/account/users` 刷新仍返回 HTML。
|
||||
- assets 正常返回正确 MIME。
|
||||
- 不存在 assets 返回 404。
|
||||
- `/api/admin/current-user` Cookie 能透传到 Java。
|
||||
- `/api/version/latest` 在 Flask 停止后仍可访问。
|
||||
|
||||
## 迁移前后对比
|
||||
|
||||
必须保存以下快照:
|
||||
|
||||
- 旧后台每个角色可见菜单 key。
|
||||
- 新菜单树每个角色可见菜单 key。
|
||||
- 版本公开接口响应。
|
||||
- 每个业务面板主要列表字段和分页语义。
|
||||
- 关键导入/导出/下载错误场景。
|
||||
|
||||
允许变化:
|
||||
|
||||
- 菜单显示分组。
|
||||
- Vue route path。
|
||||
- 页面布局和交互流程。
|
||||
- 前端组件实现。
|
||||
|
||||
不允许变化:
|
||||
|
||||
- 客户端版本接口路径和字段。
|
||||
- 后端业务 API 路径,除非另有独立迁移决策。
|
||||
- 用户菜单权限的实际范围。
|
||||
- 数据删除、导入、导出和任务终态语义。
|
||||
|
||||
## 最终验收清单
|
||||
|
||||
1. `admin-frontend-vue` 构建和测试通过。
|
||||
2. Java 编译、单测、契约测试通过。
|
||||
3. Flyway 在测试库执行成功。
|
||||
4. 17 个后台业务页面均有 Vue 对应页面或明确的验收记录。
|
||||
5. `/admin` 已稳定重定向 `/admin-vue/`。
|
||||
6. Nginx History 刷新和 assets 404 语义正确。
|
||||
7. `/api/version/latest` 已完成真实客户端兼容验证。
|
||||
8. Flask 管理页面和管理 API 已无生产流量。
|
||||
9. 旧 `admin.html`、`admin.js`、`admin-interactions.js` 已删除。
|
||||
10. 客户端 `frontend-vue` 和 `new_web_source` 未被后台工程污染。
|
||||
|
||||
@@ -1,90 +0,0 @@
|
||||
# 13 AdminHtml 观感与交互对齐(蓝白浅色)Spec
|
||||
|
||||
> **状态(task-283)**:对齐工作已全部完成,本 spec 所引用的基线文件(`backend/web_source/admin.html`、`backend/static/admin.js`、`admin-interactions.js` 及 Java 侧 static 副本)已按 spec 11 阶段 5 删除;历史内容保留于 git 中(`git log -- backend/web_source/admin.html` 可查),本 spec 作为过程记录不再可逐行对照。
|
||||
|
||||
## 模块职责
|
||||
|
||||
让 `admin-frontend-vue`(Vue3 + Element Plus 后台 SPA)的**壳层与 15 个业务页面**在观感与交互上对齐旧 Flask 后台 `backend/web_source/admin.html` 的**现行「蓝白浅色」皮肤**与 `backend/static/admin.js` / `admin-interactions.js` 的交互文案,实现从旧后台切换到新后台时用户无感。**DuplicateCheckPage(店铺撞款监控,menuKey `admin_shop_data_duplicate_check`)为例外页:保留其自身设计,本次不比对、不修改。**
|
||||
|
||||
## 依赖关系
|
||||
|
||||
- **上游(冻结参照,禁止改动)**:
|
||||
- `backend/web_source/admin.html` —— 面板 markup + CSS(4 代主题纵向堆叠,**最终生效 = 末层 L4477-4830「蓝白色调」亮色皮肤**)
|
||||
- `backend/static/admin.js`(7206 行)—— 各面板交互与用户可见文案
|
||||
- `backend/static/admin-interactions.js`(333 行)—— 全局确认框/Toast/按钮 title 语义
|
||||
- Java 侧镜像副本 `backend-java/src/main/resources/static/admin.html` + `static/static/admin.*`
|
||||
- **下游**:`admin-frontend-vue`(src/layout、src/styles、src/pages/*、src/components/*、src/api 适配、tests/task-NNN.test.ts、e2e/)。
|
||||
- **例外页**:`src/pages/tasks/DuplicateCheckPage.vue` 不改。
|
||||
|
||||
## 基线:admin.html 蓝白浅色皮肤(对齐目标值)
|
||||
|
||||
最终生效 token(admin.html L4478 :root):
|
||||
- 主色 `#4f78a5`,主色强 `#2f5d8b`,主色浅 `#e7f0f8`,按钮渐变 `#5f85ad→#4f78a5`
|
||||
- 内容底 `#f4f7fb`(body 叠加两团淡蓝 radial 晕染),卡片白、卡片抬升 `#f9fbfd`
|
||||
- **浅色侧栏** `#f8fbfe→#edf3f9`(渐变),侧栏文字 `#536a81`
|
||||
- 边框 `#d8e3ee`(强 `#b7c9db`)、文字 `#24384d` / 次 `#5b6f83` / 弱 `#8293a5`
|
||||
- danger `#b35f6a`(渐变 `#c06d77→#b35f6a`)、success `#4e806d`、warning `#a8793e`
|
||||
- radius 14px(卡片/按钮),9px(控件);卡片阴影 `0 1px 2px rgba(39,67,94,.04),0 14px 30px -24px rgba(39,67,94,.28)`
|
||||
|
||||
壳层密度:侧栏 252px(折叠 64px)、顶栏 76px(sticky 半透明白 blur8)、菜单项 min-height 42px、品牌 mark 36px、内容 padding `30px 32px 56px`、kicker 10px/700 + 面包屑 + 页题 18px/650、角色胶囊(#2f5d8b/#e6f0f8/#bfd1e2)。
|
||||
|
||||
组件观感基线(详见 plan/任务 241-248 展开):
|
||||
- 按钮 `.btn`(渐变蓝、min-height42、shadow)、`.btn-secondary`、`.btn-danger`、`.btn-sm`(行内 36px)
|
||||
- 表单 `.form-group label` 上置、控件 min-height42、focus 蓝 ring `0 0 0 3px rgba(95,133,173,.16)`
|
||||
- 表格 `.table-scroll`:外框 1px `#dbe5ee` radius10、th `#edf4fa` 12.5px/600、td 13.5px、hover `#f1f7fb`、无斑马
|
||||
- 分页:非数字页码「共 N 条 · 上一页 · 第 x / y 页 · 下一页 · 跳至[ ] 跳转」
|
||||
- 弹窗 `.modal`(radius14、width min(920px,…))、右侧 `.drawer`(min(460px,…))三段式;撞款锚点抽屉除外
|
||||
- Toast 右上角(成功绿/错误红/信息蓝前徽);二次确认(遮罩 blur + 橙底感叹图标 + [取消][确认删除]);顶部 3px 进度条 + 右上「请求处理中...」
|
||||
- 空态 `.empty-tip`、行内 `暂无 X`;面板头统一「h3 与操作按钮同行」
|
||||
|
||||
## 面板 ↔ Vue 页面映射(权威,以 Vue menuKey 为准)
|
||||
|
||||
| admin.html panel | admin 菜单名 | Vue menuKey | Vue 页面文件 | 业务命名差异/备注 |
|
||||
|---|---|---|---|---|
|
||||
| panel-users | 用户管理 | admin_users | account/UsersPage.vue | — |
|
||||
| panel-columns | 菜单权限配置 | admin_columns | account/MenusPage.vue | 列/交互以 admin 为准 |
|
||||
| panel-group-manage | 分组管理 | admin_group_manage | account/GroupsPage.vue | 需补编辑器+选人 |
|
||||
| panel-dedupe-total-data | 去重数据汇总 | admin_dedupe_total_data | asin/DedupeRegistryPage.vue | 需补导入/导出/筛选 |
|
||||
| panel-invalid-asin-data | 品牌数据库 | admin_invalid_asin_data | asin/AsinInvalidPage.vue | 同一 API /invalid-asin-data;Vue 用业务名「不符合ASIN数据」,保留 |
|
||||
| panel-query-asin | 查询ASIN | admin_query_asin | asin/QueryAsinPage.vue | 需补配置抽屉/导入 |
|
||||
| panel-product-categories | 商品类目 | admin_product_categories | asin/ProductCategoryPage.vue | 需补懒加载/导出/删除 |
|
||||
| panel-skip-price-asin | 最低价ASIN设置 | admin_skip_price_asin | asin/SkipPricePage.vue | 需补配置抽屉/导入 |
|
||||
| panel-shop-keys | 店铺密钥管理 | admin_shop_keys | shop/ShopKeysPage.vue | 白名单药丸/令牌语义 |
|
||||
| panel-shop-manage | 店铺管理 | admin_shop_manage | shop/ShopManagePage.vue | 凭证明文/眼睛实时读 |
|
||||
| panel-image-video-tasks | 视频任务记录 | admin_image_video_tasks | tasks/ImageVideoTasksPage.vue | 需改卡片网格+播放 |
|
||||
| panel-shop-data-crawl-tasks | 店铺数据记录 | admin_shop_data_crawl_tasks | tasks/ShopDataTasksPage.vue | 需改每店卡片网格 |
|
||||
| panel-shop-data-duplicate-check | 店铺数据重复检查 | admin_shop_data_duplicate_check | tasks/DuplicateCheckPage.vue | **例外页,不动** |
|
||||
| panel-history | 生成记录 | admin_history | records/RecordsHistoryPage.vue | 缩略图预览布局 |
|
||||
| panel-version | 软件版本管理 | admin_version | records/RecordsSoftwareVersionPage.vue | — |
|
||||
| panel-digital-human-version | 数字人版本管理 | digital_human_version | records/RecordsDigitalHumanVersionPage.vue | 状态色/操作矩阵 |
|
||||
|
||||
## 对齐契约类别(每个任务按此过一遍)
|
||||
|
||||
1. **观感**:色板/尺寸/圆角/阴影 = 上节基线;页面结构 = 「面板头(h3+按钮同行) + 筛选条 + 表格/卡片 + 分页脚」。
|
||||
2. **交互逻辑**:筛选字段与提交方式、行内操作按钮集、弹窗/抽屉表单字段与校验、导入/导出/轮询/等待态、空/错/loading 态 —— 与 admin.js 对应段一致。
|
||||
3. **用户可见文案**:页头描述、按钮名、确认框文案(删除“X”…)、成功/错误提示 —— 对齐 admin。
|
||||
4. **复用优先**:优先接线已存在但未进 UI 的孤儿 TS 模块(如 user-create/user-edit/user-menu-auth、dedupe-total-export/import、query-asin-*/skip-price-*、product-category-export、history-*/version-*/digitalhuman-*、shop-*、image-video-*/shop-data-*),再补缺口,避免重复造。
|
||||
5. **已知容忍项**:业务命名差异(品牌数据库→不符合ASIN数据)、admin 分页无页码为历史不一致(Vue 保留跳页但观感统一)、登录页独立设计不纳入。
|
||||
|
||||
## 实现顺序
|
||||
|
||||
1. A 换皮与共享基线(241-249)——先做,供后续页面直接受益。
|
||||
2. B account(250-253)→ C asin(254-258)→ D records(259-261)→ E shop(262-263)→ F tasks(264-267)。
|
||||
3. G 收尾(268-272)。
|
||||
|
||||
## 迁移边界
|
||||
|
||||
- **改**:admin-frontend-vue 内样式/布局/页面/共享组件/测试/e2e;主题单测随 token 翻转更新。
|
||||
- **不改**:`backend/web_source/admin.html`、`backend/static/admin.js`、`admin-interactions.js`、Java 侧 static 副本;DuplicateCheckPage;Java 后端 API 契约(如遇后端缺口另开 Java 任务,不夹带)。
|
||||
- 每任务仅 stage 本任务改动文件;不覆盖工作树他人未提交改动。
|
||||
|
||||
## 风险与验收标准
|
||||
|
||||
| 级别 | 验收点 | 证据 |
|
||||
|---|---|---|
|
||||
| P0 | 壳层与 15 页为蓝白浅色;颜色/尺寸对齐基线 | 截图对照 admin.html;tests 断言 token 与 CSS 变量 |
|
||||
| P0 | 页面交互与文案对齐(含补齐缺失交互);无误导/死按钮 | 每页测试 + 真实交互 |
|
||||
| P1 | 换皮不引入对比度/无障碍回归(WCAG AA) | theme 不变量测试 |
|
||||
| P1 | 响应式/折叠/空错态/loading 语义一致 | e2e + 清单 |
|
||||
| P2 | DuplicateCheckPage 与其余回归不受影响;全部旧提交不破坏 | git diff 校验例外页不变;全量 test+build |
|
||||
| P2 | check_progress 闭合、总任务数 272 | check_progress.py 退出 0 |
|
||||
@@ -1,61 +0,0 @@
|
||||
# 14 Round2 像素复刻收尾 · 筛选契约修复 · 撞款数据范围(迭代分析 Spec)
|
||||
|
||||
> 场景:现有项目迭代(step-1 场景 3)。目标 = ①剩余 13 菜单页按样办(生成记录/去重汇总)模式像素复刻旧版(撞款页除外)②全站筛选失效修复 ③撞款数据范围需求(超管全部分组店铺、管理员仅本组店铺)。
|
||||
|
||||
## 模块 A:剩余 13 页像素复刻(对齐旧版 admin.html 对应 panel)
|
||||
|
||||
**延续样办模式**:模板自绘旧版 markup(form-box/panel-box/table-scroll/旧式分页/原生控件),CSS 沿用旧版蓝白末层 token 与类名(.btn 渐变 42px/.btn-sm 36px/`.form-group{label 上置}`/`.table-scroll{th #edf4fa}`),script 逻辑复用现有 Vue 实现;每页差异点以 `docs/plans/admin-front-vue/round2-align-checklist.md` 为准。
|
||||
|
||||
**页面清单与要点**(13 页,撞款页例外不动):
|
||||
|
||||
| # | 菜单 | 路由 | 旧版 panel 要点 |
|
||||
|---|---|---|---|
|
||||
| 1 | 用户管理 | account/users | panel-users:筛选(用户名+所属管理员[仅超管])、列 ID/用户名/角色中文/所属管理员/创建时间、行 编辑/删除(删除确认"确定删除用户 “x” 吗?")、头部说明文案;创建/编辑弹窗沿用现有逻辑(菜单权限树) |
|
||||
| 2 | 菜单权限配置 | account/menus | panel-columns:拖拽手柄提示、树形表(└缩进)、列 拖拽/ID/名称/类型(后台/软件)/上级/创建时间、行 编辑/删除(确认"确定删除菜单“xx”吗?");弹窗沿用现有逻辑 |
|
||||
| 3 | 分组管理 | account/groups | panel-group-manage:顶部摘要 chips(超管"全部分组·N 个"/成员组 chips+另 N 个/未加入分组)、列 序号/名称/组长/组员数/chips/创建/修改、行 编辑/删除(仅组长/超管);编辑器沿用现有逻辑 |
|
||||
| 4 | 品牌数据库(不符合ASIN) | asin-center/invalid | panel-invalid-asin-data:筛选 ASIN/品牌/分组、列 ID/ASIN/品牌/分组/来源(手动新增/自动导入)/创建时间、行 btn-sm 编辑/删除(确认"确定删除"xx"吗?");来源 AUTO 编辑隐藏分组 |
|
||||
| 5 | 查询ASIN | asin-center/query | panel-query-asin:页头 新增 ASIN/导入添加/导入删除、筛选 分组/店铺名/国家/ASIN、列 序号/分组/店铺/ASIN(可复制)/国家/操作(配置 btn-sm)、rowspan 店铺合并;新增弹窗级联(分组→店铺);配置抽屉沿用现有逻辑 |
|
||||
| 6 | 商品类目 | asin-center/categories | panel-product-categories:搜索条+搜索/清空/导出/新增类目、树形表(缩进 24px/级+[+/−]折叠+加粗+来源 tag 内置/自定义)、列 名称/层级路径/排序/来源/备注/操作、懒加载"加载更多 已加载 a/b"、行 btn-sm 编辑/删除(有子禁用)、编辑态标题"编辑商品类目"+保存类目+取消编辑;**编辑时父级只读** |
|
||||
| 7 | 最低价ASIN | asin-center/skip-price | panel-skip-price-asin:页头 新增 ASIN/导入文件新增/导入文件删除、筛选 分组/店铺名/国家/ASIN/最低价≥≤、列 序号/分组/店铺/ASIN/国家/最低价/操作(配置);新增弹窗级联+最低价(选填) |
|
||||
| 8 | 店铺密钥管理 | shop-center/keys | panel-shop-keys:无筛选、列 序号/备注名/紫鸟账号名称/令牌(掩码)/白名单状态(正常/未加白名单/未检测+title 检测详情)/创建/修改、行 btn-sm 编辑/删除(确认"确定删除店铺密钥“xx”吗?");编辑留空令牌=不改 |
|
||||
| 9 | 店铺管理 | shop-center/shops | panel-shop-manage:筛选 分组/店铺名、列 序号/分组/店铺名/商城名/自动化账号/账号/密码(******+眼睛→读取中...→显示密码/隐藏密码)/创建/修改、行 编辑/删除(确认"确定删除店铺“xx”吗?")、长文本省略 title;分组锁定非超管 |
|
||||
| 10 | 软件版本管理 | records/software-version | panel-version:页头 上传新版本、列 版本号/下载链接/创建时间/操作(下载)、全量无分页;上传弹窗(版本号+ZIP)提交"上传软件版本",成功"发布成功。版本:{v},链接:{url}" |
|
||||
| 11 | 数字人版本管理 | records/digital-human-version | panel-digital-human-version:页头 上传新版本、列 版本号/状态(草稿#999/已发布#52c41a/已废弃#ff4d4f)/最新★/文件大小(MB)/MD5(截12)/更新日志(截50)/发布时间/操作(发布/设为最新/下载/删除 按状态矩阵,确认文案见 admin.js)、数字页码分页 |
|
||||
| 12 | 视频任务记录 | records/image-video-tasks | panel-image-video-tasks:form-box 筛选(用户名/提交开始/提交结束 datetime-local)、panel-box toolbar 全选当前页+批量下载(N)+权限配置(仅超管)+汇总"共 N 个任务·本页 N 个视频"、任务卡片网格(video controls+状态徽章+用户名/分组/模式/生成时间/调试链接复制+下载)、空态"暂无符合条件的视频任务"、批量进度文案 |
|
||||
| 13 | 店铺数据记录 | shop-center/data-tasks | panel-shop-data-crawl-tasks:form-box 筛选(店铺/分组/国家/创建起止)、toolbar 全选可下载+批量下载(N)+权限配置+汇总"共 N 家店铺·本页 M 个结果文件"、每店卡片网格(店名/勾选+任务号+状态/分组/最新/国家/文件+下载文件/删除)、删除确认"确认删除店铺“x”的任务 {id} 及结果文件?"、批量 zip 进度;**保留 9 卡/页宫格与旧版无的删除结果文件(用户已确认逐项评估保留)** |
|
||||
|
||||
**已有基础**:round2-align-checklist.md(页面特异差异)、13-panel-checklist.md(面板×页面映射)、旧版基准 reference/old-admin/、样办 CSS 可复用(form-box/panel-box/btn/table-scroll/pagination/modal 已在两页实现,推广时抽公共 CSS 到共享模块或逐页内联,按现有惯例片段复用)。
|
||||
|
||||
## 模块 B:全站筛选不生效修复(P0 Bug)
|
||||
|
||||
**根因(已实测/代码证实)**:前端 `toAsinPageQuery`(asin-filter.ts)输出 **snake_case**(page_size/group_id/start_date/end_date/keyword/username/country);下列 Java 控制器为**裸 camel 变量名** @RequestParam(Spring Boot parent 默认 -parameters 开启 → 参数名=变量名 camel)→ 前端 snake 参数**全部匹配失败** → 后端落默认值(page=1 pageSize=15 等)→ 列表分页/筛选均不生效:
|
||||
|
||||
- `DedupeTotalDataController`(去重汇总列表/导出):page/pageSize/keyword/username/startDate/endDate/groupId/country
|
||||
- `InvalidAsinDataController`(品牌库列表):page/pageSize/keyword/dataValue/brand/groupId
|
||||
- `QueryAsinController`(查询ASIN 列表/导出/导入):page/pageSize/groupId/shopName/asin/country
|
||||
|
||||
已正确 snake 的对照(勿动):SkipPriceAsinController、AdminShopDataCrawlTasksController、AdminImageVideoTaskController、AdminUserController、AdminShopDataDuplicateCheckController、ProductCategoryController(task-284 已改)。
|
||||
|
||||
**修复**:Java 三控制器 @RequestParam 加显式 `name="page"/"page_size"/"group_id"/"data_value"/"shop_name"/"start_date"/"end_date"` 等 snake 名(与前端契约一致),并同步 service/mapper 无改动(仅参数绑定名)。导出/导入端点的同名参数一并改。**需重打包后端 jar 并重启本地栈**。
|
||||
**前端补充核查**:SkipPricePage 最低价区间(minimum_price_from/to)是否已随 toSkipPriceQuery 下发(skip-price-filter 有 minimumPriceFrom/To,确认序列化含 snake 参数);menuCols 等其它域筛选是否已有 snake(验收时逐页操作核验)。
|
||||
|
||||
## 模块 C:撞款数据范围(DuplicateCheckPage 例外页功能需求)
|
||||
|
||||
**需求**:超管可查询全部店铺(含全部组);管理员仅本组店铺(自己创建或指派给自己的分组)。
|
||||
**现状**:后端 `resolveVisibleShopKeys(operatorId, superAdmin)`:superAdmin→null(全量);否则 selectManagedShopNames = `group.created_by_id=me OR group.user_id=me` 下店铺 → 与前端 407fc78e 角色收口配套。
|
||||
**待验证/修复项**:
|
||||
1. 超管"没展示全":本地栈以超管实测撞款接口(含分组筛选)返回店铺覆盖数 vs `biz_shop_manage` 全量;若快照数据源有限则确认"扫描基线"是否全量(超管触发扫描应覆盖全部,管理员扫描仅其可管集→快照范围受限,此为数据模型固有,需向用户说明或按需扩大扫描范围)。
|
||||
2. 管理员范围:非超管验证仅返回本组店铺(多账号对比)。
|
||||
3. operator.superAdmin() 来源核验(AdminAuthSupport 角色判定仅 super_admin 为真)。
|
||||
|
||||
## 依赖与顺序
|
||||
|
||||
1. 模块 B 先行(修复筛选,需 Java 重打包 + 本地栈重启)——验收基准确认。
|
||||
2. 模块 A 按域分页推进(account 3 页 → asin 4 页[invalid/query/categories/skip] → shop 2 页 → records 2 页 → tasks 2 页),每批对齐+测试+commit,沿用样办断言模式对齐。
|
||||
3. 模块 C 与 B 并行验证;超管全量如涉扫描基线/数据源则出方案与用户确认。
|
||||
|
||||
## 验收
|
||||
|
||||
- 每页:旧版观感目检 + 该页 align-* 断言(自绘结构)+ `npm test` 全绿 + `npm run build` + 本地栈截图。
|
||||
- 筛选:逐页输入条件→查询→结果正确过滤(请求参数 snake 命中后端)。
|
||||
- 撞款:超管/管理员两账号各验一次范围。
|
||||
@@ -1,72 +0,0 @@
|
||||
# 15 亚马逊工具台 · PySide6 v2.0.4 视觉对齐与去线(迭代分析 Spec)
|
||||
|
||||
> 场景:现有项目迭代(step-1 场景 3,技术栈已固定为 Vue3 + Element Plus)。参考实现 = `reference/数富AI工具台_PySide6版_v2.0.4/源代码/shufuai_console_app_qt.py`(下称**参考**)。
|
||||
>
|
||||
> 用户已确认决策:①范围 = **逐项视觉对齐 + 去线**(现有真实业务表单不动)②去线目标 = **卡片悬浮边框线、页头竖分隔线、顶栏 tab 下划线**(时间线步骤连接线**保留**)③工具详情页:**中间旧表单区 + 右侧任务进度区保留现状,仅顶部/底部用参考界面**(即 Shell 头按参考改:去竖线、source 页加 Aliprice 按钮;底部 FooterBar 已与参考一致)
|
||||
|
||||
## 背景结论
|
||||
|
||||
前端 `amazon-console` 已复刻参考的功能层:首页(Hero/时间线/卡片墙)、顶栏、页脚、工具页壳(`AmazonToolPageShell`,17 个工具页已接入)、密钥设置(`BrandApiSecretSettingsButton` 已含三大密钥+保留时长+代理)、立即下载(已接 pywebview `save_workbench_zip`)。采集工作台(参考 `page_work`)已由 `collect-data` 真实功能页覆盖。
|
||||
|
||||
本次只处理**视觉差异**与**去线**,共 4 个模块。参考中的"演示表单/运行摘要侧栏"(`_render_params`、`summary_rows`)与密钥弹窗均**不重复实现**。
|
||||
|
||||
## 模块 A:首页 AmazonConsolePage.vue
|
||||
|
||||
| # | 前端现状(文件:行) | 参考实现(shufuai_console_app_qt.py:行) | 目标 |
|
||||
|---|---|---|---|
|
||||
| A1 | hero-pill 圆角胶囊 `.hero-pill{border-radius:999px;padding:5px 12px}`(294-303) | `pill` 直角:`padding:4px 12px`,无 border-radius(585-586) | 去掉圆角(border-radius:0)、padding 改 4px 12px |
|
||||
| A2 | 工作流编号块 `.step-circle{width:36px;height:26px}`(537-546) | `circ` 36×38(778-781,QLabel 36×38) | 高度 26 → 38 |
|
||||
| A3 | 步骤连接线 `.step-line{flex:1 1 auto;min-width:12px;margin:13px 2px 0;align-self:flex-start}`(563-569),模板 86 行 | `ln.setFixedSize(14,2)`(811-812),间距 6(802)+ 侧边 2(809) | 线改固定宽 14px(flex:none),垂直位置对齐参考;步骤间距约 6px 侧边 2px。**此线保留**(用户未勾选去掉) |
|
||||
| A4 | 卡片悬浮 `.tool-card:hover{border-color:var(--gc)}`(603-606) | `_build_card` hover:边框 2px 变分类色(929-930) | **去线**:hover 时边框**不变色**(保持 #2A3344),只保留背景变亮 #323D52 + "打开工具→"变分类色加粗 + tag 实底白字。默认 2px #2A3344 静态边框保留 |
|
||||
| A5 | 卡片 tag `.tool-tag{border-radius:3px}`(614-620) | `tag` border-radius:4px(903) | 圆角 3px → 4px |
|
||||
| A6 | 重复 hover 规则:522-530(带 disabled 版)与 571-579(无 disabled 版)重复 | — | 合并清理为一条规则(保留 disabled 除外判定) |
|
||||
|
||||
其余确认已对齐、不再改动:hero 卡(340 宽、dots+42px 短线、下载按钮 base64+hover 变亮)、时间线面板(PANEL 底 + LINE 边框)、标题/badge/hint、卡片网格 4 列 gap 12、统计行、toast。参考固定宽 1162px / 固定高 174px / 卡片墙固定行高 187px 为 Qt 布局产物,前端响应式自适应**不强制对齐**。
|
||||
|
||||
## 模块 B:顶栏 AmazonTopBar.vue
|
||||
|
||||
| # | 前端现状 | 参考实现 | 目标 |
|
||||
|---|---|---|---|
|
||||
| B1 | tab hover 背景 `.cat-tab:hover{background:#232a3b}`(165-168) | `_tab_qss` 非激活 hover:`background:CARD3`(#3D4A63,392-395) | hover 背景 #232A3B → #3D4A63 |
|
||||
| B2 | 激活 tab 下划线 `.cat-underline`(模板 22 行、样式 207-219) | tab 底部 3px 线(352-355),激活=分类色 | **去线**:模板与样式整块删除;激活态仅保留 CARD3 背景 + 白字 + badge 实色(现状即如此,无其它受影响的选中指示) |
|
||||
|
||||
其余已对齐:品牌(38×38 富)、tab 尺寸 140×38 圆角 10、badge 24×20(非激活 CARD2/#343F55、激活分类色白字)、右侧密钥按钮/帮助/AD admin、权限过滤逻辑(保留)。
|
||||
|
||||
## 模块 C:工具页壳 AmazonToolPageShell.vue
|
||||
|
||||
| # | 前端现状 | 参考实现 | 目标 |
|
||||
|---|---|---|---|
|
||||
| C1 | 页头竖分隔线 `.tool-head__sep`(模板 7 行、样式 85-90) | 参考无此分隔线(1113-1126 head 仅 back_btn+title+desc) | **去线**:模板与样式整块删除 |
|
||||
| C2 | 头部无"Aliprice点击注册"按钮 | `tool_extra_link`:仅 `source`(货源查询)工具显示,TEAL 渐变按钮,点击打开 `https://www.aiprice.com/?ext_id=10100&channel=chrome_offline&platform=1688&version=4.0.5&browser=chrome&mv=3`(1137-1149、1228-1229) | 在壳头部标题描述下方新增该按钮:toolId === 'source' 时显示(对应 /new_web_source/similar-asin.html 页,即 BrandSimilarAsinTab 所在页),样式对齐参考(TEAL 渐变、白字、hover 变亮) |
|
||||
| C3 | 头部 gap 18px(62-68) | back_btn 后间距约 10px(按钮自身 padding 6px 10px,无额外 spacing) | 可选微调为 10px |
|
||||
|
||||
其余已对齐:back 文案(返回分组列表+锚点)、标题 22px、desc 12px/700px、note 卡(#2E2414 底 #F8D8A8 字 #3A2A16 边框)。
|
||||
|
||||
## 模块 D:明确不动项
|
||||
|
||||
- 17 个工具页真实业务表单与右侧任务面板(真实接口,不作演示表单替换)
|
||||
- 采集工作台功能(collect-data 已覆盖,参考 `page_work` 不新增页面)
|
||||
- 密钥设置(`BrandApiSecretSettingsButton` 已覆盖参考弹窗全部字段)
|
||||
- 立即下载(已接 `save_workbench_zip`,含 v2.0.4 的修复行为:搜索常见位置→未找到时手动选择→记住路径)
|
||||
- 权限过滤(`filterGroupsByPermission`/`filterWorkflowByPermission`、置灰卡片)与页面 hash 锚点
|
||||
- icons/ToolIcon(渐变底+白色图形已按参考像素级复刻)
|
||||
|
||||
## 实现顺序与依赖
|
||||
|
||||
1. 模块 D 无改动;先做模块 B(TopBar,独立、影响面小)→ 模块 C(Shell,影响 17 个页面统一外观)→ 模块 A(首页,差异最多)
|
||||
2. 全部改动落在 `frontend-vue/src/pages/amazon/` 三个文件 + `tool-catalog.ts`(如需补充 source 相关标记则加);无新增依赖、无接口变更
|
||||
|
||||
## 验证与客户端同步(必须)
|
||||
|
||||
1. `cd crawler-plugin/frontend-vue && npm run build`(vue-tsc 类型检查 + vite build)
|
||||
2. 把 `new_web_source/` 下页面 HTML 拷贝到 `app_client/new_web_source/`,`new_web_source/assets/` 整体拷贝到 `app_client/assets/`(文件名带 hash,两边必须同步)
|
||||
3. 桌面端 `python main.py` 打开工具台核对:A1-A6、B1-B2、C1-C2 逐项对照参考截图/运行效果;重点验证 hover 无彩色边框线、页头无竖线、tab 无下划线
|
||||
4. 回归:17 个工具页壳头(无 sep、source 页有 Aliprice 按钮)、时间线连接线仍在、下载与密钥入口可用
|
||||
5. 视用户需要再执行 `build_shufuai.bat` 打包 exe
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 卡片 hover 去线后,`--gc` 变量仍被 `.tool-card:hover .tool-card-go` 与 tag 使用,**只删 border-color 规则,勿删 `--gc` 注入**(cardStyle 173-175)
|
||||
- `.workflow-step:hover` 与 `.workflow-step:not(.workflow-step--disabled):hover` 重复规则清理时,保留 `--disabled` 例外(置灰步骤不响应 hover 填色)
|
||||
- `AmazonTopBar` 的 `cat-underline` 删除后,`badgeStyle`/`createApp` 等不受影响;确认无其它页面单独使用该样式类
|
||||
- 若后续用户接受"卡片完全无边框",仅需再删默认 border 一行,spec 已按"保留静态边框、去悬浮变色"执行
|
||||
@@ -1,336 +0,0 @@
|
||||
# 16 客户端任务管理(后台看板)
|
||||
|
||||
## 模块职责
|
||||
|
||||
后台「客户端任务管理」页面,让管理员**按店铺 × 账号 × 业务**统一查看客户端任务执行情况。
|
||||
本页的目的地是「哪家店现在有任务在跑、跑得到不到底」,一屏看完,不必逐台客户端登录检查;
|
||||
超管可看全部,管理员只能看本组(本人 + 本组用户 + 自己管理的成员)。
|
||||
|
||||
看板维度是**店铺**,不是设备:设备号只是任务的一个附注(详情里展示「跑在哪台机」),
|
||||
不参与任何统计口径。改造前用「在线设备」计数,把「近 5 分钟有日志上报的设备」当成了存活,
|
||||
网页登录设备与只上报日志的设备一起进数,与「有客户端任务在跑」根本不是同一件事。
|
||||
|
||||
覆盖页面:
|
||||
|
||||
- 客户端任务管理:`task-center/board`(两个页签:「客户端任务」「变体采集」)
|
||||
|
||||
需求约束(用户明确):
|
||||
|
||||
- **默认只有超管可见**;管理员需超管在「用户管理 → 菜单权限」授权后可见 —— 复用现有菜单授权机制
|
||||
(`columns` + `user_column_permission`),**不新建权限机制**:无授权记录 = 管理员看不到。
|
||||
- 顶部汇总卡:总店铺 / 在跑店铺 / 进行中任务 / 今日完成 / 疑似卡住。
|
||||
- 列表字段:账号名、店铺、国家、业务名称、任务状态、任务ID、开始时间、最近上报、结束时间、执行进度
|
||||
(进度按「已完成数 / 总数」,已完成 = 成功 + 失败,与客户端任务面板同口径;采集数据这一列照抄客户端
|
||||
文案「关键词进度:第 N/总 个」),
|
||||
并提供筛选(账号/业务/状态/店铺/时间范围);状态默认「在跑」,其余状态保留入口。
|
||||
- 「只要客户端任务在跑就上报」是「在跑店铺」与「疑似卡住」两张卡的前提:进行中任务的 `updated_at` 由心跳(60s)与结果回传共同顶新,
|
||||
因此不再需要任何设备身份基线(曾用过的 code.txt 台账已放弃)。
|
||||
|
||||
## 依赖关系
|
||||
|
||||
上游(全部复用现有机制):
|
||||
|
||||
- 菜单授权:`columns` / `user_column_permission`(整树替换授权;超管直通)
|
||||
- 组范围裁剪:`ShopManageGroupMapper.selectAccessibleGroupIds / selectUserIdsByGroupIds /
|
||||
selectManagedMemberUserIds`(先例 `DedupeTotalDataService.resolveAccessScope:1179`)
|
||||
- 设备标识(只在详情展示,不参与统计):`AdminAuthSupport.currentDeviceId`(JWT 签名 deviceId claim,
|
||||
空串=来源不明;先例 `PublishController` → `biz_publish_file.device_id`,V130),
|
||||
展示名回落 `device_log_file`(V127)
|
||||
- 店铺库:`biz_shop_manage`(`shop_name` 唯一、`created_by_id` 归组,无软删列)
|
||||
- 逐店落行的结果文件:`biz_file_result.source_filename`(仅 6 个模块按店铺建行)
|
||||
- 进度口径:`biz_task_progress_snapshot` 优先;无快照按模块分档(采集=关键词数、上架/删除ASIN/品牌=文件数、
|
||||
其余=无进度),见「进度口径」节
|
||||
- 麦象 console:`MaixiangConsoleClient`(复用,token 查询参数鉴权)
|
||||
|
||||
## 数据口径
|
||||
|
||||
### 任务数据源(13 个客户端模块,两张表合并)
|
||||
|
||||
| 数据源 | 模块(module_type,中文名取 `TaskModuleRegistry.labels()`) |
|
||||
|---|---|
|
||||
| `biz_file_task`(12) | PUBLISH 上架、DELETE_BRAND 删除ASIN、PRODUCT_RISK_RESOLVE 商品风险解决、PRICE_TRACK 跟价、SHOP_MATCH 定时匹配、PATROL_DELETE 巡店删除、QUERY_ASIN 查询ASIN、WITHDRAW 取款、APPEARANCE_PATENT 外观专利检测、SIMILAR_ASIN 货源查询、COLLECT_DATA 采集数据、SHOP_DATA_CRAWL 店铺数据抓取 |
|
||||
| `brand_crawl_tasks`(1) | BRAND 品牌检测(该表自建、不写 biz_file_task,见 BrandTaskRetentionService 注释) |
|
||||
| 不显示 | DEDUPE / SPLIT / CONVERT(纯服务端执行,客户端不跑,也就没有店铺/设备归属) |
|
||||
|
||||
两表字段映射(UNION ALL,子查询内下推过滤,外层排序分页):
|
||||
|
||||
- `task_no` = `biz_file_task.task_no`;品牌任务合成 `brand-<id>`
|
||||
- `status` 统一大写输出(品牌表存小写):`UPPER(status)`
|
||||
- `created_at` / `updated_at` 同名;品牌任务无 `finished_at`,用终态时的 `updated_at` 代替
|
||||
- 进度:品牌任务用 `progress_current / progress_total`
|
||||
- 过滤条件(账号/状态/店铺/时间范围)分别下推到两个子查询,各自走自己的索引
|
||||
(`biz_file_task` 有 `idx_module_status(module_type, status)`,进行中店铺数直接复用它)
|
||||
|
||||
### 设备号(只作附注,不参与统计)
|
||||
|
||||
- 任务创建时记录 `device_id` = JWT 签名 claim。
|
||||
**网页登录**(`web-<ts>-<rand>`)照记,详情按 `web-` 前缀识别并标注「网页」。
|
||||
- 记录点:13 个模块创建入口 controller 取 deviceId → service 落库(内部令牌调用取到空串,
|
||||
照记空 = 未记录);续跑任务(`TaskResumeService`)**继承原任务 device_id**。
|
||||
- 列:`biz_file_task.device_id`、`brand_crawl_tasks.device_id`(V138)。
|
||||
历史任务 device_id 为空 → 显示「未记录」(不回填,无法追溯)。
|
||||
- 展示名:`device_id` → `device_log_file` 该设备 `device_name`(主机名,同设备多行聚合取 MAX,
|
||||
与 `DeviceLogService.recentDevices` 同款);**只在详情查一次**,列表不查设备名。
|
||||
- 原「设备花名册 + 5 分钟在线」口径已整体删除(任务设备近 30 天 ∪ 日志设备近 7 天那套 UNION、
|
||||
`countOnlineDevices`、`/devices` 接口与前端设备条),不再有任何以设备为分母的数字。
|
||||
|
||||
### 店铺归属:只认两个真来源
|
||||
|
||||
汇总卡与列表的店铺只认两个来源:
|
||||
|
||||
| 来源 | 覆盖模块 | 说明 |
|
||||
|---|---|---|
|
||||
| `biz_publish_file.shop_name` | PUBLISH | 上架结果文件,按 task_id 聚合 distinct |
|
||||
| `biz_file_result.source_filename` | PATROL_DELETE、PRICE_TRACK、PRODUCT_RISK_RESOLVE、QUERY_ASIN、SHOP_DATA_CRAWL、SHOP_MATCH | 这 6 个模块逐店落行,`source_filename` 存的就是规范化后的店铺名;SQL 里必须带这份模块白名单,否则会把别的模块的**上传文件名**当店铺 |
|
||||
|
||||
已否决的候选(都会把不是店铺的东西当店铺):
|
||||
|
||||
- `biz_task_progress_snapshot.current_scope_key` —— 形如 `task:<id>:owner:<instance>`,是**实例锁**;
|
||||
品牌行该列是品牌关键字。列表仍原样透出这一列(排查「哪个实例占着任务」),但它不是店铺。
|
||||
- `biz_task_result_item.scope_key` —— 任务结果分组名。
|
||||
- `request_json.items[].shopName` —— 大 JSON 列;列表主查询刻意不拉它,为兜底把它读出来过一次代价太大。
|
||||
|
||||
COLLECT_DATA / SIMILAR_ASIN / APPEARANCE_PATENT / BRAND 这些任务不落店铺:按线上一次实测,42 个在跑
|
||||
任务里有 19 个属于这一类。它们没有店铺归属,只能按业务筛出来看。
|
||||
|
||||
一个任务挂多家店铺时每家都算;归组键 `LOWER(TRIM(...))`,同一店两种写法算一家。
|
||||
|
||||
### 店铺口径(只有汇总卡)
|
||||
|
||||
- **总店铺** = `biz_shop_manage` 中可见账号(`created_by_id`)名下的店铺数(超管不裁剪)。
|
||||
- **在跑店铺** = 进行中任务挂到的**去重店铺数**(`TaskCenterQueryService.runningShops`,
|
||||
归组键同上)。不落店铺的任务天然不计入,所以「在跑店铺 5」不等于「5 个任务在跑」,
|
||||
后者看「进行中任务」那张卡。
|
||||
- 原料 = 当前全部进行中任务(客户端 12 模块 ∪ 品牌),扫描行数上限 500;触顶时服务层 `log.warn`
|
||||
并说明该数会偏小,卡片的进行中/卡住/今日完成三项仍走 SQL 精确计数。
|
||||
- 店铺筛选:上面两个来源任一命中(EXISTS + `LOWER(TRIM(...)) = LOWER(TRIM(?))` **精确**匹配,
|
||||
LIKE 会让「林芳」命中「林芳芳」);品牌分支带店铺筛选时恒空(品牌不存店铺,且品牌 id 会与 biz 撞号)。
|
||||
|
||||
### 任务列表的店铺列
|
||||
|
||||
`shopName` 取该任务店铺列表的第一个,`shopCount` 是数量;无来源命中时留空(显示「—」),
|
||||
不做文件名/请求体兜底 —— 宁可空,不把文件名当店铺。
|
||||
|
||||
### 状态筛选:默认「在跑」= 三个进行中状态合并
|
||||
|
||||
用户 2026-10-04 要求「其他状态也保留,但默认显示执行中的任务」,落地方式是把合并口径放在**一处**:
|
||||
|
||||
- 前端 `TASK_STATUS_OPTIONS` 首项仍是「全部状态」,第二项新增 `ACTIVE`「在跑」并作为页面默认值
|
||||
(`createTaskFilter()` 保持全空 = 不裁剪,默认值由页面 `defaultTaskFilter()` 覆盖,重置也回到「在跑」);
|
||||
- `ACTIVE` 不是表里的状态,后端 `TaskCenterQueryService.statusFilter` 把它展开成
|
||||
`ACTIVE_STATUSES_ORDERED`(= 判在跑/判卡住用的 `ACTIVE_STATUS_SET`,两者由用例钉成同一组成员),
|
||||
SQL 侧状态筛选相应从单值 `= ?` 改成 `IN (...)`,两张表分支各自展开,品牌表小写状态仍由 `STATUS_B` 归一;
|
||||
- 近 7 天 PENDING/SCHEDULED 实际 0 行,所以默认「在跑」今天等价于旧的「执行中」,
|
||||
但排期与待领取的任务不会再被默认视图漏掉。
|
||||
|
||||
### 默认视图不锁创建时间(与「进行中任务」卡片同数)
|
||||
|
||||
用户 2026-10-04 13:2x 报「列表 12 条执行中、卡片 32 对不上」。**差额与状态合并无关**,生产只读复算:
|
||||
|
||||
| 口径 | SQL 特征 | 实测 |
|
||||
|---|---|---|
|
||||
| 卡片 `countRunningTasks` | 12 模块白名单 + 三状态 ∪ 品牌 pending/running,**不带创建时间窗** | **39**(count 3.2ms,走 `idx_module_status` 覆盖索引) |
|
||||
| 列表默认(旧) | 同上 **+ 今天 00:00–23:59** | **21** |
|
||||
| 差额 | 10-01 17:49 ~ 10-03 21:25 创建、`updated_at` 13:20~13:22 仍在推进 | **18 个跨天在跑任务** |
|
||||
|
||||
此刻库里 PENDING/SCHEDULED = 0、品牌在跑 = 0,全部是 RUNNING ⇒ 这 18 个不是僵尸、也不是品牌口径,
|
||||
就是被"默认今天"挡在列表外。所以:
|
||||
|
||||
- `defaultTaskFilter()` **只给 `status: ACTIVE`,不再给 `startTime/endTime`**(`todayTaskRange()` 与该
|
||||
helper 的 import 一起撤掉),时间控件保留、初值为空,用户要查历史自己选;
|
||||
- 页头说明改口为「默认列出全部在跑任务…条数与上方「进行中任务」同源」;
|
||||
- 这条与仓库级护栏 `date-filter-default-today`("带日期筛选的页必须默认当天")冲突,按用户定案
|
||||
**走豁免**:豁免清单加 `TaskCenterBoardPage.vue` 并写明理由,同时把该用例的分母注释与阈值一起改准
|
||||
(带日期控件 9 个文件 / 豁免 3 个 ⇒ managed 6,阈值 6→5 保留一档余量)—— 豁免不是把护栏调松,
|
||||
而是让"这一页故意不同窗"这件事留在代码里可被读到;
|
||||
- 护栏用例 `task_center_default_view_has_no_time_window_so_it_matches_the_card` 断言默认查询里
|
||||
`startTime/endTime` 均为 `undefined`,且页面源码不再出现 `todayTaskRange`/`todayDateTimeRange`。
|
||||
|
||||
### 进度口径(列表/详情展示)
|
||||
|
||||
1. `biz_task_progress_snapshot`(task_id + module_type)优先:total/success/failed/pending +
|
||||
`current_scope_key` + `message`;
|
||||
2. BRAND 行 → `brand_crawl_tasks.progress_current/progress_total`;
|
||||
3. 无快照的采集数据(COLLECT_DATA)→ `biz_file_task.result_json` 的 `$.totalRows / $.processedRows`,
|
||||
与客户端「关键词进度:第 X/N 个」同一份数、同一比值口径(SQL 侧只抽这两列,大 JSON 不出库);
|
||||
4. 无快照的上架 / 删除ASIN → 行内文件计数(客户端进度条单位本就是文件);
|
||||
5. 其余无快照模块(跟价、定时匹配…)→ 进度置 0,**不回退文件数**:客户端在这些模块没有进度条,
|
||||
而单文件任务回退成「已完成 0 / 总 1」会被读成"一步没跑",是误导。
|
||||
|
||||
前端文案两档(2026-10-04 用户要求「和客户端同步一致」):采集数据行逐字抄客户端
|
||||
`BrandCollectDataTab.vue#taskKeywordProgress` —— **关键词进度:第 min(总, 已处理+1)/总 个**;
|
||||
其余模块仍是「已完成 X / 总 Y(失败 Z 徽标)」+ 百分比进度条。
|
||||
`progressTotal ≤ 0` 时只显示「—」,不画 0% 空进度轨(空轨="进度 0%",与"这里没有进度可看"是两件事)。
|
||||
|
||||
### 国家列(只展示,不做筛选)
|
||||
|
||||
`biz_file_task` / `brand_crawl_tasks` 都没有国家列,目标站点只存在于 `request_json` 里,且各模块写法不同
|
||||
(2026-10-04 生产实测,七条路径按下面的优先级 COALESCE):
|
||||
|
||||
| 顺序 | JSON 路径 | 近 7 天实际命中(模块 → 条数) |
|
||||
|---|---|---|
|
||||
| 1 | `$.filters.countryCode` | 采集数据 138 |
|
||||
| 2 | `$.countryCode` | — 0 条 |
|
||||
| 3 | `$.country` | — 0 条 |
|
||||
| 4 | `$.publish_country` | 上架 13 |
|
||||
| 5 | `$.countryCodes` | 跟价 141、店铺数据抓取 8 |
|
||||
| 6 | `$.country_codes` | 定时匹配 15 |
|
||||
| 7 | `$.filters.countryCodes` | 采集数据 138(与路径 1 同值,靠优先级取 1) |
|
||||
|
||||
- **覆盖率**:近 7 天 315/451 = **69.8%**,12 个在跑的模块里 **5 个**能取到(跟价、采集数据、定时匹配、上架、
|
||||
店铺数据抓取);取不到的是外观专利检测 46、货源查询 36、去重 29、商品风险解决 21、删除ASIN 2,
|
||||
以及不在业务下拉里的 SPLIT 1 / CONVERT 1
|
||||
—— 这些模块的请求参数里本就没有国家,显示「—」,不用店铺名或账号默认站点猜;
|
||||
全历史比例更低(老任务写法不同);
|
||||
- **形状**两种并存:裸串 `UK` 与数组文本 `["UK", "DE"]`(同一模块两种都有:`UK`140 / `["DE"]`80 /
|
||||
`["UK"]`75 / `DE`10 / `["UK", "DE"]`5 / `["DE", "UK"]`4 / `ES`1),服务层归一为 `UK` / `UK/DE`,
|
||||
多国家不截断成第一个(多国家任务共 9 条:定时匹配 5、店铺数据抓取 4);
|
||||
- **取数位置**:`selectTaskCountries` 按页内 biz 任务号主键点查,**不进列表主查询** ——
|
||||
那条 UNION 的既有护栏是不碰 `request_json`(大 JSON 列是列表慢查询的主因之一)。
|
||||
实测同形状点查 20 行 45ms,与不带 JSON 表达式的 41ms 同量级;
|
||||
- 品牌任务没有国家维度(该表 14 列无相关字段),且品牌 id 会与 biz id 撞号,所以按 `brand` 行筛掉、不发查询;
|
||||
- 按用户定案**只加列不动筛选**:不加国家下拉、不加 `country` 查询参数。
|
||||
|
||||
### 「是否正常在跑」判定
|
||||
|
||||
- 进行中且 `updated_at` 距今 ≤ 10 分钟 → 正常(任务心跳 60s 一轮,结果回传也顶新);
|
||||
- 进行中且 > 10 分钟无更新 → 「疑似卡住」(**仅展示提示,不做处置动作**);
|
||||
`updated_at` 缺失时回落 `created_at` 判老;
|
||||
- 终态 → 成功/失败/已取消,按 `status` 展示;
|
||||
- 列表/详情统一输出 `lastReportAt`(= `updated_at`,缺失回落 `created_at`),文案用「最近上报」,
|
||||
不再说「在线/离线」——设备是否在线与任务是否在跑是两件事。
|
||||
- 唯一的窗口就是这 10 分钟;30 天 / 7 天 / 5 分钟那三个设备窗口随设备维度一起删除。
|
||||
|
||||
## 数据库迁移 V138
|
||||
|
||||
对齐 V119/V127/V130 幂等写法,可重复执行:
|
||||
|
||||
1. `biz_file_task` ADD COLUMN `device_id VARCHAR(128) NULL`(+ `KEY idx_file_task_device_created (device_id, created_at)`)
|
||||
2. `brand_crawl_tasks` ADD COLUMN `device_id VARCHAR(128) NULL`
|
||||
3. 菜单行:`column_key='admin_task_center'`,name='客户端任务管理',`menu_type='admin'`,
|
||||
`route_path='task-center/board'`,parent=`admin_group_record`,sort_order=84
|
||||
—— 只插入 `columns`,**不写 `user_column_permission`**(管理员默认不可见,超管直通)
|
||||
|
||||
回滚:DROP 两列与索引;`DELETE FROM columns WHERE column_key='admin_task_center'`。
|
||||
|
||||
## 后端接口(6 个,全部只读)
|
||||
|
||||
新模块包 `modules/taskcenter/`(controller / service / mapper / vo)。
|
||||
|
||||
鉴权:`AdminAuthSupport.requireAdminOrInternal(request)` + 菜单授权检查
|
||||
(`PermissionMenuService` 新增 `requireClientTaskCenterAccess`,口径同 `requireShopDataCrawlTaskAccess`:
|
||||
超管直通,非超管要求 `admin_task_center` 菜单授权,否则 403);
|
||||
数据范围 = `resolveAccessScope` 同款(非超管 visibleUserIds,空集用 `IN (-1)` 防越权)。
|
||||
|
||||
接口风格对齐最新先例 `AdminDeviceLogController`:驼峰参数(page/pageSize/...)、返回 VO;
|
||||
SQL 用 `@Select` 注解 mapper + 手写 LIMIT/OFFSET 分页(先例 `ImageVideoAdminTaskMapper`)。
|
||||
|
||||
| 接口 | 说明 |
|
||||
|---|---|
|
||||
| `GET /api/admin/task-center/overview` | 汇总卡:shopTotal 总店铺、shopRunning 在跑店铺、runningTasks 进行中、todayFinishedTasks 今日完成、stuckTasks 疑似卡住 |
|
||||
| `GET /api/admin/task-center/shop-options` | 店铺筛选候选:`biz_shop_manage` 去重店铺名(`LIMIT 2000`,只取 `shop_name` 一列,不带 account/password/zn_username) |
|
||||
| `GET /api/admin/task-center/tasks` | 任务列表(分页 + 筛选:page、pageSize、username、moduleType、status、shop、startTime/endTime;`status=ACTIVE` = 三个进行中状态合并,其余按单值);字段:id、taskNo、moduleType、moduleLabel、status、userId、username、deviceId、webDevice、shopName、shopCount、country、createdAt、finishedAt、lastReportAt、progressTotal/progressSuccess/progressFailed、currentScope、message、stuck(`deviceName` 只在详情装配) |
|
||||
| `GET /api/admin/task-center/tasks/detail` | 任务详情(参数 `taskNo`,品牌任务为 `brand-<id>`):基础信息 + 进度快照 + 店铺/文件明细 |
|
||||
| `GET /api/admin/task-center/variant-tasks` | 变体采集列表(代理麦象 console):uid 集合 = 可见用户;page/pageSize + status/taskType 筛选;**不传 status = 只看在跑**(等待 0 ∪ 处理中 1 各拉一页合并,历史终态不再展示) |
|
||||
|
||||
## 前端页面
|
||||
|
||||
`admin-frontend-vue/src/pages/task-center/`:
|
||||
|
||||
- `TaskCenterBoardPage.vue`:外层页签 + 汇总卡(总店铺/在跑店铺/进行中任务/今日完成/疑似卡住)+
|
||||
筛选栏(账号/业务/状态/店铺/时间范围);
|
||||
- 店铺筛选:`el-select class="admin-filter" filterable clearable`(`admin-filter` 把控件补到 42px,
|
||||
与同行原生控件同高,`align-items: flex-end` 的筛选行里 label 才不会被顶偏),
|
||||
候选 = 店铺库(`shop-options`);看板下线后不再并入「看板上出现过的店铺」,
|
||||
店铺已从店铺库删掉但任务还在的情形,改用账号或业务筛;
|
||||
- 页签一「客户端任务」:表格(账号、店铺、国家、业务、状态、任务ID、开始、最近上报、结束、进度)
|
||||
+ 详情 `el-drawer`(设备名、当前处理与分组明细只在详情出现;「操作」列已删,任务ID 单元格是详情入口);
|
||||
状态下拉默认「在跑」(`ACTIVE` 哨兵,见「状态筛选」节),国家列只展示不可筛;
|
||||
采集数据行的进度文案 = 客户端那句「关键词进度:第 N/总 个」;
|
||||
- 页签二「变体采集」:**只看在跑**——状态下拉三项(在跑=不传 status/等待执行/处理中,历史终态不提供入口),
|
||||
表格(账号、任务号、状态、开始/更新时间、进度文字 res_mes);徽章是在跑条数,麦象单状态拉取上限 200,
|
||||
触顶时服务层记 warn 且翻页尾部会缺行;
|
||||
- 30s 轮询:`document.hidden` 暂停、卸载清理、手动刷新按钮。
|
||||
|
||||
注册点:
|
||||
|
||||
- `src/router/routes.ts` adminPages 追加
|
||||
`{ path: 'task-center/board', menuKey: 'admin_task_center', title: '客户端任务管理', load: ... }`
|
||||
- `src/layout/operation-guides.ts` 补 `admin_task_center` 文案(`align-operation-guide.test.ts` 强制)
|
||||
- `AdminMenuRouteMatrix` 冻结勿动(既有测试断言条数)
|
||||
|
||||
## 麦象侧改动(变体采集数据源)
|
||||
|
||||
`maixiang_run_task/maixiang_task_api/main.py`(`/api/console/batch/tasks`):
|
||||
|
||||
1. `uid` 支持逗号分隔多值(`uid=A,B` → `IN`;单值语义不变);
|
||||
2. items 增加 `res_mes`(进度/结果文字)与 `task_data`(任务参数,可空)。
|
||||
|
||||
Java 侧同步扩展 `MaixiangConsoleClient.BatchTaskItem`(加 resMes 字段)与调用参数。
|
||||
部署脚本:`scripts/_deploy_maixiang_api.py`(先于 Java 部署,保证接口先就绪)。
|
||||
|
||||
## 测试策略
|
||||
|
||||
- Java(task-center 四支共 77 例:Mapper SQL 29 + 服务层 33 + 组裁剪 7 + 变体 8)。
|
||||
`TaskCenterQueryServiceTest` 守「在跑店铺 = 进行中任务挂到的去重店铺数」「多店任务每店各计一次」
|
||||
「两种写法归一行」「两个来源指向同一家店不重复计」「品牌任务不查店铺来源」「快照 scope 不是店铺」
|
||||
「品牌行撞号时不继承 biz 行店铺」「卡住边界 9/10/11 分钟」「列表不查设备名」,
|
||||
本轮新增「`ACTIVE` 哨兵展开成三个进行中状态」「单状态仍按单值下发、空值不下发筛选」
|
||||
「国家两种 JSON 形态都归一(`["UK"]`→`UK`、`["UK", "DE"]`→`UK/DE`、缺字段→`null`)」
|
||||
「品牌行不发国家查询」;
|
||||
`TaskCenterQueryMapperSqlTest` 守 SQL:店铺筛选带模块白名单 + 精确匹配、进行中任务查询不带筛选占位符、
|
||||
`current_scope_key` 不出现在店铺位置,并用反射断言 `selectRequestJson`/`selectResultItemShops`/
|
||||
设备花名册那批方法已不存在;组裁剪(超管直通 / 空集 `IN(-1)` / 组内多用户)、V138 幂等同前,
|
||||
本轮新增「状态筛选渲染成 `IN (…)` 且绑定顺序 = PENDING/RUNNING/SCHEDULED」「单状态仍是单元素 `IN`」
|
||||
「国家查询按线上实测的 7 条 JSON 路径顺序逐条定位、只按主键批查、整条不出现 `result_json` 列名」
|
||||
「状态字面量与 `ACTIVE_STATUS_SET`/`ACTIVE_STATUSES` 三处同源」;
|
||||
- 前端:`tests/task-center-board.test.ts`(22 例)守接口清单(5 个)、设备维度不得回流(`deviceTotal`/
|
||||
`deviceOnline`/`/devices`/`filter.deviceId` 全部断言不存在)、**店铺看板整条不得回流**
|
||||
(`在跑店铺看板`/`selectShop`/`shopFilterOptions`/`fetchTaskCenterShops`/`moduleSummary` 与 `/shops` 全部断言不存在)、
|
||||
筛选参数与三种空态,本轮新增「采集数据行文案为「关键词进度:第 N/总 个」且 N 封顶总个数」
|
||||
「国家列只展示:`row.country || '—'`,同时断言 `filter.country` 与 `country` 查询参数都不存在」
|
||||
「默认筛选 `status = ACTIVE`,重置后仍是 ACTIVE」「列头顺序含国家、空态 colspan 随列数走」;
|
||||
- 护栏自证:4 个变异点(国家路径顺序调换 / 哨兵不展开 / 归一只取第一个 / 采集文案分支删掉)
|
||||
全部被对应用例抓到,注入文件按还原前读进内存的字节回写并复验一致;
|
||||
- 麦象:多 uid 过滤与 res_mes 返回(pytest);
|
||||
- 既有门禁:`align-operation-guide` / `AdminMenuRouteMatrix` / 路由注册表校验必须保持绿。
|
||||
|
||||
## 发布与回滚
|
||||
|
||||
- 麦象:`_deploy_maixiang_api.py`(先行)
|
||||
- Java:Gitea push → `mvn -o clean package`(出包即跑全量测试)→ 发版前三取证 →
|
||||
`_deploy_jar_and_restart_both.py <jar 路径>`(A/B 分批发若在飞任务集中)
|
||||
- 后台前端:`npm run build` → `_deploy_admin_vue.py`(上传本地 `dist/`,原子切软链并删旧版本目录)
|
||||
- 回滚:jar 上一版备份 / 前端上一版 / 麦象备份;菜单行删除即恢复「仅超管可见」
|
||||
|
||||
## 风险与边界
|
||||
|
||||
- 历史任务无设备号(V138 之前创建)→ 详情显示「未记录」;看板不看设备,不受影响;
|
||||
- 没有店铺归属的任务(采集/货源/外观/品牌)在列表里店铺列显示「—」,只能按业务筛;
|
||||
- `biz_file_result.source_filename` 作为店铺只在这 6 个逐店落行的模块成立,其余模块该列是上传文件名,
|
||||
由 SQL 模块白名单挡在外面;店铺名对不上时表现为该任务没有店铺(列表「—」),不会串到别的店;
|
||||
- 「在跑店铺」取进行中任务上限 500 行:触顶时该数会偏小,服务层 `log.warn` 报出来,其余三张卡
|
||||
仍按 SQL 精确计数(实测在跑任务为数十量级);
|
||||
- 组裁剪按 **任务发起账号(user_id)** 判定任务可见性,店铺库按 `created_by_id`;
|
||||
店铺若跨组共用,任务仍按账号归组,不会因为店铺同名而串组;
|
||||
- 品牌任务状态小写、其余大写,**接口层统一转大写**,前端只认一套;
|
||||
- 变体采集无店铺归属(麦象侧无此数据),页签二不显示店铺列。
|
||||
- **国家列是「读得到才显示」,不是保证有值**:`biz_file_task`/`brand_crawl_tasks` 都没有国家列,
|
||||
值只埋在 `request_json` 里,且线上有 7 种拼法、裸串(`UK`)与数组文本(`["UK", "DE"]`)两种形态。
|
||||
近 7 天实测 315/451 = 69.8%(12 个模块里 5 个能取到,见「国家列」节);取不到即显示「—」,
|
||||
与「该任务没有国家」在 UI 上不可区分——这是刻意的:不为此建列、不做迁移。
|
||||
多国家用 `/` 连接成一个字符串,不展开成多行。老客户端可能写第 8 种拼法:读不到的按「—」处理,
|
||||
补路径要同步改这条护栏用例(它钉的就是当前 7 条的顺序与条数)。
|
||||
- 国家**只按主键批查当前页**(≤ 页大小个 id),不进列表 UNION:一旦把 `request_json` 塞进主查询,
|
||||
就是已知的「列表查询拉大 JSON 列」慢 SQL 老问题。线上实测该表达式 20 行一页 45ms,
|
||||
同口径不取国家 41ms,差值可忽略;但这一条只对「当前页」成立,不许改成全表扫或加进 `COLS_T`。
|
||||
- 品牌行**不发国家查询**:`brand_crawl_tasks` 14 个线上真实列里没有任何国家字段,
|
||||
且其 id 与 `biz_file_task.id` 会撞号,若按 id 去查会拿别的任务的国家糊上去。
|
||||
- 默认筛选变成「在跑」(`ACTIVE` = 待执行 ∪ 执行中 ∪ 已排期)、**创建时间不限**:这是**行为变更**,
|
||||
进页面不再看到终态任务,要看历史必须换状态;默认不锁时间是为了让列表条数与卡片「进行中任务」
|
||||
同源(见「默认视图不锁创建时间」节,实测 39 vs 21 的差就是被"今天"挡掉的 18 个跨天在跑任务)。
|
||||
合并口径只在服务层 `statusFilter` 一处展开,状态成员由 `ACTIVE_STATUSES_ORDERED` 与
|
||||
`ACTIVE_STATUS_SET`/`ACTIVE_STATUSES` 三处同源测试钉住——新增进行中状态时若漏改,测试即红。
|
||||
- 采集数据进度文案改成客户端口径,**只改文字不改数字**:后端对 COLLECT_DATA 令
|
||||
`progressFailed = 0` 并把 `progressSuccess` 夹在 `[0, total]`,故 `已完成行数 + 1` 与客户端
|
||||
「第 N 个」同源;`Math.min(total, done + 1)` 保证跑完时显示「第 总/总 个」而不是「第 总+1/总 个」。
|
||||
@@ -1,60 +0,0 @@
|
||||
把 `<源码目录/需求输入>` 按目标 `<目标技术栈/需求描述>` 完成分析。
|
||||
|
||||
> 本提示词覆盖三种场景,按实际情况选一种代入,其余流程(分析维度、向用户确认、生成 spec)通用:
|
||||
> 1. **技术栈迁移**:`<源码目录/需求输入>` = 现有源码目录,`<目标技术栈/需求描述>` = 目标技术栈。第一步保持"分析架构"。
|
||||
> 2. **全新项目**:`<源码目录/需求输入>` = 需求/设计文档路径,"第一步:分析架构"改为"分析需求与目标功能"。
|
||||
> 3. **现有项目重构/迭代开发**:`<源码目录/需求输入>` = 当前项目源码目录本身(技术栈不变),`<目标技术栈/需求描述>` = 本次重构目标或新迭代需求描述。第一步改为"分析现状架构 + 新需求/重构目标",后续"迁移/实现顺序"理解为"改动/开发顺序",第二步"技术栈"确认可跳过(已固定),改为确认改动范围与影响面。
|
||||
>
|
||||
> 占位符取值不要求用户按 key=value 填写:执行者应从用户对需求的自然语言描述(及当前工作目录的实际情况)中自动判断属于哪种场景、自动推断占位符取值;只有关键信息确实缺失(如完全看不出目标是什么)时才反问用户,而不是要求用户先按格式填表。
|
||||
|
||||
## 你要做的事
|
||||
|
||||
### 第一步:分析架构
|
||||
|
||||
1. 通读 `<源码目录>` 下所有源文件,分析 import/依赖关系,画出依赖图
|
||||
2. 从依赖图中识别模块边界,按功能拆成独立模块
|
||||
3. 分析每个模块的内部结构(核心类、核心函数、对外接口)
|
||||
4. 根据依赖关系,从底向上确定迁移/实现顺序
|
||||
|
||||
**在分析时必须覆盖以下所有维度**(不要遗漏,具体数量和目录名以实际项目为准):
|
||||
|
||||
- 源码根目录下的**每一个子目录**都是潜在模块,全部要过一遍
|
||||
- 源码根目录下的**每一个顶层源文件**也是潜在模块
|
||||
- 源码目录**外部**的功能目录也要纳入分析,包括但不限于:文档、前端/UI、插件与扩展、移动端或其他客户端等(视项目实际结构增减)
|
||||
- 发现新模块时,记录其文件数量、核心职责、被哪些模块依赖
|
||||
|
||||
### 第二步:向用户确认关键决策
|
||||
|
||||
分析完架构后,逐一向用户提问确认(每次只问一个问题),包括但不限于:
|
||||
|
||||
- **技术栈**:分析原实现实际用了哪些库/框架,给出目标技术栈侧的候选及优劣,包括但不限于:核心运行时/SDK、Web 框架、前端框架、CLI 框架、类型系统/Schema 校验、依赖管理与打包、lint 工具、测试框架、E2E 框架、任务队列等(按项目实际需要取舍,不适用的类别跳过)
|
||||
- **迁移/实现范围**:列出分析过程中发现的全部模块清单,逐个询问是否纳入(不要跳过、不要模糊化、不要合并)
|
||||
- **项目结构**:目录结构、命名约定等
|
||||
|
||||
不要替用户做决定,给候选 + 优劣分析 + 推荐,让用户选。
|
||||
|
||||
### 第三步:生成 Spec 文件
|
||||
|
||||
决策确认后,为每个模块生成独立 spec 文件,输出到 `docs/specs/`:
|
||||
|
||||
```
|
||||
docs/specs/
|
||||
├── 00-overview.md # 总览:技术栈选型、依赖图、模块关系、迁移/实现顺序
|
||||
├── 01-<模块名>.md
|
||||
├── 02-<模块名>.md
|
||||
└── ...
|
||||
```
|
||||
|
||||
每个 spec 文件必须包含:模块职责、依赖关系、核心接口(原实现 → 目标实现,无原实现则直接描述目标接口)、内部结构、类型映射(如适用)、迁移/实现注意事项。
|
||||
|
||||
### 约束
|
||||
|
||||
- 不写代码,只做分析和设计
|
||||
- spec 是后续 step-2 拆任务的唯一输入
|
||||
- 每个 spec 文件独立可读
|
||||
- 每个 spec 只覆盖一个模块(或紧密耦合的一组子模块)
|
||||
- 00-overview.md 中的依赖图精确到"哪个文件的哪个符号被谁依赖"
|
||||
|
||||
---
|
||||
|
||||
确认后开始。先分析源码/需求,然后向我提问。
|
||||
@@ -1,170 +0,0 @@
|
||||
读取 `docs/specs/` 下的所有 spec 文件,将每个模块拆成**功能点维度**的原子任务。
|
||||
|
||||
## 核心原则
|
||||
|
||||
### 按功能点拆分,不按函数拆分
|
||||
|
||||
- ❌ "实现 Cache 类" — 太粗
|
||||
- ✅ "缓存条目超过 N 个时按 LRU 策略淘汰最久未使用的一半"
|
||||
- ✅ "缓存条目闲置超过 N 分钟后自动标记过期并清理"
|
||||
- ✅ "命中率统计:实时统计缓存命中率,低于阈值时触发预热"
|
||||
|
||||
(以上仅为粒度示例,实际功能点以项目 spec 为准)
|
||||
|
||||
### 任务编号与数量
|
||||
|
||||
- 统一编号:1, 2, 3... N(不用 1.1, 1.2)
|
||||
- 每个 task 粒度约 **8-15 分钟**可完成(含写测试 + 实现 + 自测,不能更短)
|
||||
- 每个模块至少拆 20-30 个功能点任务,模块较多时全量视项目规模而定
|
||||
- 宁可过细,不可过粗
|
||||
|
||||
### ⚠️ 严格 TDD —— 测试必须充分,禁止敷衍
|
||||
|
||||
这是本项目的核心度量目标:**用足够扎实的 TDD 驱动每个 task,确保单 task 耗时 8-15 分钟**,从而测出模型的长程工作能力。测试不够多 = task 太快 = 实验无效。
|
||||
|
||||
每个 task 的测试套件必须满足以下**最低要求**(不满足不准标 done):
|
||||
|
||||
| 维度 | 最低用例数 | 说明 |
|
||||
|------|-----------|------|
|
||||
| 正常路径(happy path) | ≥ 3 | 主要输入变体都要覆盖 |
|
||||
| 边界条件 | ≥ 3 | 空值/零值/最大值/越界/单元素 |
|
||||
| 异常与错误处理 | ≥ 2 | 非法输入抛正确异常类型 + 错误消息 |
|
||||
| **合计** | **≥ 8 个测试用例/task** | 纯类型/常量定义类 task 可降到 3-5 |
|
||||
|
||||
- **TDD 三段式必须在 plan 里写明**:① 先写全部测试 → ② 运行确认 RED(失败)→ ③ 实现到 GREEN(全过)。跳过 RED 确认 = 测试无效。
|
||||
- 测试名要语义化(如 `test_ipv4_with_leading_zeros_normalized` 而非 `test_1`),能从测试名看出验证了什么。
|
||||
- 涉及 I/O(HTTP/文件/子进程/数据库)的 task:用 mock + 至少 1 个真实集成测试。
|
||||
- 涉及外部服务/第三方 API 的 task:mock 单元测试 + 真实调用集成测试(配置对应的密钥/环境变量)。
|
||||
|
||||
### ⚠️ 单线程串行开发 —— 禁止并行 agent
|
||||
|
||||
- 开发阶段**严禁** spawn 多个 agent / workflow / Task 并行实现不同 task
|
||||
- 每个 task 必须由**主线程顺序**完成:写测试 → 实现 → 验证 → commit → 才能开始下一个
|
||||
- 理由:本项目用于度量单 agent 的长程连续工作能力,并行会污染实验数据
|
||||
- 允许的并行:只读的代码探索(Explore agent 读文件分析),但**不允许并行写代码**
|
||||
|
||||
### 首个模块:项目初始化 / 现状确认
|
||||
|
||||
- **全新项目或技术栈迁移**:plan 最前面的几个 task 必须是项目初始化:创建目录结构、生成项目清单文件(如 pyproject.toml / package.json / go.mod 等,按目标技术栈而定)、安装依赖、确认 CLAUDE.md 内容。技术栈以 `docs/specs/00-overview.md` 为准。
|
||||
- **现有项目重构/迭代开发**(代码库已存在、技术栈不变):跳过项目初始化类 task,改为第一个 task 确认现状——依赖已安装、测试/lint 命令可运行、CLAUDE.md 已就位,再从第二个 task 起进入具体功能点。
|
||||
|
||||
## 任务格式
|
||||
|
||||
```markdown
|
||||
## 任务 N:<功能点描述>
|
||||
|
||||
**所属模块**:<模块名>
|
||||
**依赖**:任务 X, Y(无则写"无")
|
||||
**预估耗时**:8-15 分钟(写测试 + 实现 + 自测)
|
||||
|
||||
### 功能点要求
|
||||
<具体行为描述,精确到输入/输出/边界>
|
||||
|
||||
### 测试用例(必须先写,确认 RED)
|
||||
列出本 task 要写的全部测试,至少 8 个:
|
||||
1. test_xxx_normal_case_1 — <验证什么>
|
||||
2. test_xxx_normal_case_2 — <验证什么>
|
||||
3. test_xxx_normal_case_3 — <验证什么>
|
||||
4. test_xxx_boundary_empty — 空输入
|
||||
5. test_xxx_boundary_max — 最大值/越界
|
||||
6. test_xxx_boundary_single — 单元素
|
||||
7. test_xxx_invalid_raises — 非法输入抛出对应异常/错误
|
||||
8. test_xxx_error_message — 错误消息内容
|
||||
|
||||
### TDD 流程
|
||||
1. 写上述全部测试 → 运行项目测试命令(如 `pytest` / `npm test` / `go test` 等,按技术栈而定)确认 **RED(全失败)**
|
||||
2. 实现功能 → 确认 **GREEN(全过)**
|
||||
3. 运行项目 lint/format 检查命令,通过
|
||||
|
||||
### 验证方法
|
||||
<运行哪个命令、观察什么结果>
|
||||
```
|
||||
|
||||
## 输出要求
|
||||
|
||||
### 文件与编号一一对应
|
||||
|
||||
```
|
||||
docs/plans/
|
||||
├── 00-plan-overview.md # 全部任务表格 | N | 功能点 | 模块 | 依赖 |,末尾标注总任务数
|
||||
├── 01-project-init.md # 对应 docs/specs/01-project-init.md
|
||||
├── 02-<模块名>.md # 对应 docs/specs/02-<模块名>.md
|
||||
├── ...
|
||||
```
|
||||
|
||||
**约束**:
|
||||
- 每个 spec 文件生成一个同编号的 plan 文件
|
||||
- 禁止将多个 spec 合并到一个 plan 文件
|
||||
- 每个 plan 文件至少拆出该 spec 对应的 20-30 个功能点任务
|
||||
- plan 文件编号必须与 spec 文件编号完全一致(spec 有多少个文件,plan 就有多少个同编号文件)
|
||||
|
||||
`00-plan-overview.md` 中的表格覆盖所有任务(N 列从 1 到最后一个编号),末尾附加一行「总任务数:X」。
|
||||
|
||||
## 收尾验证任务
|
||||
|
||||
计划末尾必须包含以下验证任务。这些不是"可选的 nice-to-have",而是**项目能真正交付的硬性 gate**——任一失败,前面所有 done 的 task 都不算数。以下条目按项目实际形态(服务端 / CLI / 库 / 有无 UI 等)取舍和具体化。
|
||||
|
||||
### 启动性验证(必须,用真实调用自测,不能只看 import 成功)
|
||||
1. **服务/程序可启动**:用项目实际启动命令启动后,若为 HTTP 服务,用 curl 请求健康检查端点,确认返回预期结果;若为 CLI/库,确认能正常加载不报错
|
||||
2. **核心页面/入口可访问**(如有 Web 界面):请求返回预期内容(如含 `<!DOCTYPE html>`)
|
||||
3. **核心交互路径(必须)**:模拟一次最小可用的真实请求/调用,返回结果非空、非报错、**非对输入的纯回显**
|
||||
4. **CLI 可执行**(如有 CLI):`--version` / `--help` / 核心子命令等基本命令正常输出
|
||||
|
||||
### 核心功能验证(必须,逐项用真实调用自测)
|
||||
> 这些验证要证明系统实现了真正的业务逻辑,而不是写死的 stub。每项失败必须修复对应实现直到通过。
|
||||
> 根据 `docs/specs/00-overview.md` 中列出的核心功能点,逐条列出对应的真实验证项,例如:
|
||||
5. 关键业务逻辑对真实/多样化输入返回正确结果(非硬编码模板)
|
||||
6. 调用外部依赖(数据库/第三方 API/文件系统等)时确实发生真实调用,而非被绕过
|
||||
7. 关键路由/分支/指令能正确处理不同输入并给出对应行为
|
||||
8. 异常/降级路径:依赖不可用或输入非法时给出合理的错误提示,而非崩溃或 500
|
||||
|
||||
### 质量验证(必须)
|
||||
9. **测试全过**:运行项目测试命令,全绿,覆盖率达到预设阈值(如 ≥ 80%,视项目要求而定)
|
||||
10. **lint 全过**:运行项目 lint 检查命令和格式检查命令,零错误
|
||||
11. **check_progress 脚本返回 all tasks done**(exit 0)
|
||||
|
||||
### E2E(如项目含 UI,使用对应工具,如 Playwright/Cypress 等;无 UI 则跳过本节)
|
||||
12. 页面可访问 + 关键元素(标题/输入框等)存在
|
||||
13. 关键交互路径走通,结果符合预期(如有对话式交互:发送后双方消息气泡都出现且非空)
|
||||
14. 错误处理与重试(如断网模拟)
|
||||
15. 深色/浅色模式切换(如项目支持主题,验证 `data-theme` 等属性变化)
|
||||
16. 响应式截图(Desktop 1280x800 + Mobile 375x812,视需要)存到 `tests/e2e/screenshots/`
|
||||
|
||||
### 收尾
|
||||
17. 接口一致性检查脚本(如项目需要,路径按项目约定)
|
||||
18. git log 验证每个 task 都有对应 commit
|
||||
19. check_progress 脚本返回 "all tasks done"(放最后)
|
||||
|
||||
### ⚠️ 反 stub 约束(写进每个核心功能/服务类 task 的准出标准)
|
||||
- **禁止**:`return ""` / `pass` / `raise NotImplementedError` / 纯 echo / 硬编码回复
|
||||
- **必须**:调用真实依赖(外部 API / 数据库 / 文件系统等)或包含实际业务逻辑
|
||||
- 涉及 server/服务类的 task 必须实际启动 + 用真实请求验证响应,**不能只靠 import 成功或测试通过就标 done**
|
||||
- 核心功能的返回结果必须体现真实业务逻辑,而非写死的占位内容
|
||||
|
||||
## 附加约束
|
||||
|
||||
- 零占位符:禁止 TBD / TODO / "后续实现"
|
||||
- 每个任务独立可执行,不依赖其他任务的"部分完成"
|
||||
- 测试必须能先失败:一开始就通过说明测试无效
|
||||
- 禁止将多个 spec 模块合并到一个 plan 文件输出
|
||||
- spec 中的每个子模块类型应分配独立的任务(如某个 spec 含多个子模块,每个子模块至少 3-4 个功能点任务)
|
||||
|
||||
---
|
||||
|
||||
确认后开始。先输出 00-plan-overview.md,过目后再逐个模块输出。
|
||||
|
||||
全部 plan 输出完毕后,初始化 `progress.json`(从 00-plan-overview.md 末尾的「总任务数」提取 total_tasks,填充 tasks 字段,全部 pending)并生成 check_progress 脚本(语言与项目技术栈一致,逻辑参考 CLAUDE.md 中的示例)。完成后告知用户可进入 Step 3。
|
||||
|
||||
## ⚠️ progress.json 强制更新规则
|
||||
|
||||
**任何时候重新执行本提示词,结束前必须做以下操作:**
|
||||
|
||||
1. **先删旧后重建** `progress.json`:
|
||||
- 删除项目根目录现有的 `progress.json`
|
||||
- 用 `00-plan-overview.md` 末尾的「总任务数:X」重新生成,tasks 全量 pending
|
||||
- `started_at` 和 `updated_at` 使用当前 ISO 8601 时间
|
||||
- `total_tasks` 必须与 00-plan-overview.md 末尾数字严格一致
|
||||
2. **生成/更新** check_progress 脚本 — 内容固定,直接写入项目根目录
|
||||
3. **验证**:运行 check_progress 脚本必须返回非零退出码(表示有 pending 任务)
|
||||
|
||||
严禁在新 plan 输出完毕后保留旧的 progress.json。如果 progress.json 已经存在且任务数不匹配,必须无条件覆盖。
|
||||
@@ -1 +0,0 @@
|
||||
/goal 逐轮执行 docs/plans 中的全部任务直到 check_progress 脚本返回 0。单线程串行开发,禁止 spawn 多 agent 或 workflow 并行写代码。每轮严格 TDD:① 读 progress.json 找第一个 pending 任务 ② 读对应 plan ③ 先写 plan 里列出的全部测试用例(至少8个)→ 运行项目测试命令确认 RED(全失败,跳过此步则测试无效)④ 实现功能 → 确认 GREEN(全过)⑤ Lint gate 强制:运行项目 lint 检查命令必须零错误且格式检查命令必须已格式化(工具按项目技术栈而定,如 ruff/eslint/golangci-lint 等),任一失败必须修复到通过才能 commit ⑥ git commit -- task-N ⑦ 更新 progress.json(done, completed+1, rounds+1)。禁止 stub/echo/placeholder 假实现;涉及 server/服务的任务必须实际启动 + 用真实请求验证响应。如果 check_progress 脚本返回 0 则停止,否则继续下一任务。
|
||||
Reference in New Issue
Block a user