diff --git a/docs/specs/16-client-task-console.md b/docs/specs/16-client-task-console.md index 759c7a8ea..a536fb218 100644 --- a/docs/specs/16-client-task-console.md +++ b/docs/specs/16-client-task-console.md @@ -123,6 +123,29 @@ COLLECT_DATA / SIMILAR_ASIN / APPEARANCE_PATENT / BRAND 这些任务不落店铺 - 近 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 + @@ -261,7 +284,7 @@ Java 侧同步扩展 `MaixiangConsoleClient.BatchTaskItem`(加 resMes 字段 本轮新增「状态筛选渲染成 `IN (…)` 且绑定顺序 = PENDING/RUNNING/SCHEDULED」「单状态仍是单元素 `IN`」 「国家查询按线上实测的 7 条 JSON 路径顺序逐条定位、只按主键批查、整条不出现 `result_json` 列名」 「状态字面量与 `ACTIVE_STATUS_SET`/`ACTIVE_STATUSES` 三处同源」; -- 前端:`tests/task-center-board.test.ts`(21 例)守接口清单(5 个)、设备维度不得回流(`deviceTotal`/ +- 前端:`tests/task-center-board.test.ts`(22 例)守接口清单(5 个)、设备维度不得回流(`deviceTotal`/ `deviceOnline`/`/devices`/`filter.deviceId` 全部断言不存在)、**店铺看板整条不得回流** (`在跑店铺看板`/`selectShop`/`shopFilterOptions`/`fetchTaskCenterShops`/`moduleSummary` 与 `/shops` 全部断言不存在)、 筛选参数与三种空态,本轮新增「采集数据行文案为「关键词进度:第 N/总 个」且 N 封顶总个数」 @@ -303,8 +326,9 @@ Java 侧同步扩展 `MaixiangConsoleClient.BatchTaskItem`(加 resMes 字段 同口径不取国家 41ms,差值可忽略;但这一条只对「当前页」成立,不许改成全表扫或加进 `COLS_T`。 - 品牌行**不发国家查询**:`brand_crawl_tasks` 14 个线上真实列里没有任何国家字段, 且其 id 与 `biz_file_task.id` 会撞号,若按 id 去查会拿别的任务的国家糊上去。 -- 默认筛选变成「在跑」(`ACTIVE` = 待执行 ∪ 执行中 ∪ 已排期)+ 今天:这是**行为变更**, - 进页面不再看到历史任务,要看历史必须换状态或放宽创建时间(页头有说明文字)。 +- 默认筛选变成「在跑」(`ACTIVE` = 待执行 ∪ 执行中 ∪ 已排期)、**创建时间不限**:这是**行为变更**, + 进页面不再看到终态任务,要看历史必须换状态;默认不锁时间是为了让列表条数与卡片「进行中任务」 + 同源(见「默认视图不锁创建时间」节,实测 39 vs 21 的差就是被"今天"挡掉的 18 个跨天在跑任务)。 合并口径只在服务层 `statusFilter` 一处展开,状态成员由 `ACTIVE_STATUSES_ORDERED` 与 `ACTIVE_STATUS_SET`/`ACTIVE_STATUSES` 三处同源测试钉住——新增进行中状态时若漏改,测试即红。 - 采集数据进度文案改成客户端口径,**只改文字不改数字**:后端对 COLLECT_DATA 令