3d12689349
后端已把心跳里的 current/total 透到 progress/light,但 TaskItemView.progress 是可空字段:
页面少写一行不会报错也不会红,界面上就是安静地没有进度条——11 类客户端任务里 7 类正是这样。
- 新增 src/shared/api/task-progress-live.ts:进度走独立通道,模块级缓存 + 60s 新鲜窗口
为什么不并进任务对象:各页 {...prev.task, ...detail.task} 合并里有 5 处带「变更签名」守卫
(rowsVersion|status|fileStatus|fileReady)。进度每轮都在动,而签名在「正在翻页、还没攒够一批
回传」的时段不变——照那条路走,进度条会一路停在上一次回传的数字上,看着像卡死
- 写入点挂在 light 出口(progress-light.ts)而不是聚合层:4 个页面直接调 getModuleProgressLight
不经过 getPollingProgressBatch,挂聚合层它们永远拿不到;命中缓存也要刷一遍读数,
否则进度会在缓存窗口里被自己的新鲜判定踢掉、凭空消失
- toBatchItems 与 LightPollingItem 补三字段:这里的键集是逐字段挑的,少挑一个就把后端给的数丢掉
- 10 页接 liveProgress:解决风控、跟价、定时匹配、状态查询、提款、巡店删除、商品管理采集等
- Convert/Dedupe/Split 三页写死 progress: null 并说明原因:它们卡列的是完成记录、没有可数的分母。
显式 null 与省略字段在代码里必须长得不一样,否则下一个人无法区分「没得画」和「忘了接」
- 新增 tests/task-progress-view-wiring.test.ts:适配器清单由文件系统给出、总数硬钉 16,
判据同时认 `progress:` 与 ES6 简写 `progress,`(只认冒号把 BrandBrandTab 误报成缺口,
而误报的尺子会被人当噪音绕过去);变异自证三处全 KILLED——抽掉跟价页的接线、
摘掉批次白名单的 progressTotal、去掉分母塌 0 时的旧读数清理,还原后字节哈希一致
- tests/task-progress-polling.test.ts 的整份形状断言同步加三字段(它本来就该在我改白名单时红)
76 lines
3.9 KiB
TypeScript
76 lines
3.9 KiB
TypeScript
import { test } from 'node:test'
|
||
import assert from 'node:assert/strict'
|
||
import { readFileSync, readdirSync } from 'node:fs'
|
||
import { join } from 'node:path'
|
||
|
||
/**
|
||
* 任务卡片的「进度条接线」普查。
|
||
*
|
||
* 为什么要它:TaskItemView.progress 是可空字段,页面少写一行不会报错、不会红,
|
||
* 界面上就是安静地没有进度条。11 个任务页各写一处,漏哪一处全靠这条出声。
|
||
*
|
||
* 分母不手抄:扫 src/pages/brand/components 下所有写了 `to*TaskView(...): TaskItemView`
|
||
* 适配器的页面,清单由文件系统给出;再把总数硬钉住——新增页面没接进度、或有人把
|
||
* 适配器改名躲开扫描,都在这条上出声(只比总数会被「内部搬家」绕过,所以逐个点名)。
|
||
*/
|
||
|
||
const COMPONENTS = join(import.meta.dirname, '..', 'src', 'pages', 'brand', 'components')
|
||
const ADAPTER_PATTERN = /function (to\w*TaskView)\(/
|
||
|
||
/**
|
||
* 判据只看「适配器返回的对象里出现了 progress 属性」,两种写法都认:
|
||
* `progress: {…}` 与 ES6 简写 `progress,`(BrandBrandTab 用后者,只认冒号会把它误报成缺口,
|
||
* 而误报的尺子很快会被人当噪音绕过去)。
|
||
*/
|
||
const PROGRESS_KEY = /^\s*(?:progress\s*:|progress\s*,)/m
|
||
|
||
function adaptersOf(file: string) {
|
||
const lines = readFileSync(join(COMPONENTS, file), 'utf8').split(/\r?\n/)
|
||
const found: { name: string; start: number; end: number }[] = []
|
||
for (let index = 0; index < lines.length; index += 1) {
|
||
const matched = ADAPTER_PATTERN.exec(lines[index])
|
||
if (!matched) continue
|
||
let end = index
|
||
while (end + 1 < lines.length && lines[end + 1] !== '}') end += 1
|
||
found.push({ name: matched[1], start: index, end })
|
||
}
|
||
return found
|
||
}
|
||
|
||
const pages = readdirSync(COMPONENTS).filter((name) => name.endsWith('.vue'))
|
||
const seen = pages.flatMap((file) => adaptersOf(file).map((a) => ({ file, ...a })))
|
||
|
||
test('被扫描的任务卡适配器数量必须硬钉(少扫或多扫都说明扫描面变了)', () => {
|
||
assert.equal(seen.length, 16, `扫到 ${seen.length} 个 to*TaskView 适配器:${seen.map((s) => `${s.file}#${s.name}`).join(', ')}`)
|
||
})
|
||
|
||
test('每个任务卡适配器都必须给出进度读数,或明确给出 null', () => {
|
||
const offenders = seen
|
||
.filter((entry) => {
|
||
const lines = readFileSync(join(COMPONENTS, entry.file), 'utf8').split(/\r?\n/)
|
||
const body = lines.slice(entry.start, entry.end + 1).join('\n')
|
||
return !PROGRESS_KEY.test(body)
|
||
})
|
||
.map((entry) => `${entry.file}#${entry.name}`)
|
||
assert.deepEqual(offenders, [], '这些任务页画不出进度条:' + offenders.join(', '))
|
||
})
|
||
|
||
test('实时进度通道的写入点只有一个,且在 light 出口上', () => {
|
||
const sharedDir = join(import.meta.dirname, '..', 'src', 'shared', 'api')
|
||
const callers = readdirSync(sharedDir)
|
||
.filter((name) => name.endsWith('.ts') && name !== 'task-progress-live.ts')
|
||
.filter((name) => readFileSync(join(sharedDir, name), 'utf8').includes('rememberLiveProgress('))
|
||
assert.deepEqual(callers, ['progress-light.ts'],
|
||
'rememberLiveProgress 的调用者必须是 light 出口一处;多处写会让刷新时机和过期判定分家:' + callers.join(', '))
|
||
})
|
||
|
||
test('light 白名单与后端 VO 的进度三字段同名同形', () => {
|
||
const light = readFileSync(join(import.meta.dirname, '..', 'src', 'shared', 'api', 'progress-light.ts'), 'utf8')
|
||
const polling = readFileSync(join(import.meta.dirname, '..', 'src', 'shared', 'api', 'task-progress-polling.ts'), 'utf8')
|
||
for (const field of ['progressCurrent', 'progressTotal', 'progressLabel']) {
|
||
assert.ok(light.includes(`${field}?:`), `progress-light.ts 的白名单缺 ${field}`)
|
||
// toBatchItems 的键集是逐字段挑的,少挑一个就把后端给的数丢掉
|
||
assert.ok(polling.includes(`${field}: item.${field} ?? null`), `task-progress-polling.ts 归一时丢了 ${field}`)
|
||
}
|
||
})
|