diff --git a/frontend-vue/src/pages/brand/components/BrandConvertTab.vue b/frontend-vue/src/pages/brand/components/BrandConvertTab.vue index f19d90cdb..152611209 100644 --- a/frontend-vue/src/pages/brand/components/BrandConvertTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandConvertTab.vue @@ -210,6 +210,8 @@ function toConvertTaskView(item: ConvertResultItem): TaskItemView { ...(item.outputFilename ? [`压缩包文件:${item.outputFilename}`] : []), ...(item.error ? [`错误信息:${userNotice(item.error)}`] : []), ], + // 显式给 null:这一类是点了就跑完的一次性操作,卡片列的是完成记录,没有可数的分母。写死 null 而不是省略字段,是为了让「没得画」和「忘了接」在代码里长得不一样(守卫:tests/task-progress-view-wiring.test.ts)。 + progress: null, source: item, } } diff --git a/frontend-vue/src/pages/brand/components/BrandDedupeTab.vue b/frontend-vue/src/pages/brand/components/BrandDedupeTab.vue index b37dbe8de..0e9378384 100644 --- a/frontend-vue/src/pages/brand/components/BrandDedupeTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandDedupeTab.vue @@ -234,6 +234,8 @@ function toDedupeTaskView(item: DedupeResultItem): TaskItemView { ...(item.outputFilename ? [`输出文件:${item.outputFilename}`] : []), ...(item.error ? [`错误信息:${userNotice(item.error)}`] : []), ], + // 显式给 null:这一类是点了就跑完的一次性操作,卡片列的是完成记录,没有可数的分母。写死 null 而不是省略字段,是为了让「没得画」和「忘了接」在代码里长得不一样(守卫:tests/task-progress-view-wiring.test.ts)。 + progress: null, source: item, } } diff --git a/frontend-vue/src/pages/brand/components/BrandPatrolDeleteTab.vue b/frontend-vue/src/pages/brand/components/BrandPatrolDeleteTab.vue index c15517b6e..1b58a5b37 100644 --- a/frontend-vue/src/pages/brand/components/BrandPatrolDeleteTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandPatrolDeleteTab.vue @@ -297,6 +297,7 @@ import { isRecordMissingError } from '@/shared/utils/task-queue-state.ts' import { useTablePaging } from '@/shared/composables/useTablePaging.ts' import { getModuleProgressLight } from '@/shared/api/progress-light.ts' import { createRowsVersionTracker } from '@/shared/api/task-progress-polling.ts' +import { liveProgress } from '@/shared/api/task-progress-live.ts' import { confirmTaskDeletion } from '@/shared/task-delete-confirm'; import { TERMINAL_TASK_STATUSES, isTerminalTaskStatus, waitForTaskTerminal as waitForTaskTerminalShared } from '@/shared/utils/task-terminal' @@ -397,6 +398,7 @@ function toPatrolTaskView(item: PatrolDeleteHistoryItem): TaskItemView { `模板: ${formatTemplateSummary(item)}`, ...(formatTaskGroupErrors(item) ? [`错误: ${userNotice(formatTaskGroupErrors(item))}`] : []), ], + progress: liveProgress(Number(item.taskId)), source: item, } } diff --git a/frontend-vue/src/pages/brand/components/BrandPriceTrackTab.vue b/frontend-vue/src/pages/brand/components/BrandPriceTrackTab.vue index 94a0b66b7..a342780f4 100644 --- a/frontend-vue/src/pages/brand/components/BrandPriceTrackTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandPriceTrackTab.vue @@ -277,6 +277,7 @@ import { type PriceTrackTaskDetailVo, } from '@/shared/api/java-modules' import { getPollingProgressBatch } from '@/shared/api/task-progress-polling.ts' +import { liveProgress } from '@/shared/api/task-progress-live.ts' import { formatDateTime } from '@/shared/utils/datetime' import { taskStatusClass, taskStatusText } from '@/shared/utils/task-status-text' import { isTerminalTaskStatus, waitForTaskTerminal as waitForTaskTerminalShared } from '@/shared/utils/task-terminal' @@ -1574,6 +1575,7 @@ function toPriceTrackTaskView(item: PriceTrackHistoryItem): TaskItemView { ...(item.outputFilename ? [`文件:${item.outputFilename}`] : []), ...(item.error ? [`错误:${userNotice(item.error)}`] : []), ], + progress: liveProgress(Number(item.taskId)), source: item, } } diff --git a/frontend-vue/src/pages/brand/components/BrandProductRiskTab.vue b/frontend-vue/src/pages/brand/components/BrandProductRiskTab.vue index 1921ffb5b..e325913c3 100644 --- a/frontend-vue/src/pages/brand/components/BrandProductRiskTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandProductRiskTab.vue @@ -193,6 +193,7 @@ import { runBatchDelete } from '@/shared/utils/batch-delete' import { isRecordMissingError } from '@/shared/utils/task-queue-state.ts' import { useTablePaging } from '@/shared/composables/useTablePaging.ts' import { getPollingProgressBatch } from '@/shared/api/task-progress-polling.ts' +import { liveProgress } from '@/shared/api/task-progress-live.ts' import { confirmTaskDeletion } from '@/shared/task-delete-confirm' const shopInput = ref('') @@ -724,6 +725,7 @@ function toRiskTaskView(item: ProductRiskHistoryItem): TaskItemView { ...(item.outputFilename ? [`文件:${item.outputFilename}`] : []), ...(item.error ? [`错误:${userNotice(item.error)}`] : []), ], + progress: liveProgress(Number(item.taskId)), source: item, } } diff --git a/frontend-vue/src/pages/brand/components/BrandQueryAsinTab.vue b/frontend-vue/src/pages/brand/components/BrandQueryAsinTab.vue index 5c715e8bb..15726b1fb 100644 --- a/frontend-vue/src/pages/brand/components/BrandQueryAsinTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandQueryAsinTab.vue @@ -252,6 +252,7 @@ import { isRecordMissingError, parseTaskStartTimes, removeTaskStartTime, upsertT import { useTablePaging } from '@/shared/composables/useTablePaging.ts' import { getModuleProgressLight } from '@/shared/api/progress-light.ts' import { createRowsVersionTracker } from '@/shared/api/task-progress-polling.ts' +import { liveProgress } from '@/shared/api/task-progress-live.ts' import { confirmTaskDeletion } from '@/shared/task-delete-confirm'; import { TERMINAL_TASK_STATUSES, isTerminalTaskStatus, waitForTaskTerminal as waitForTaskTerminalShared } from '@/shared/utils/task-terminal' import { dispatchedPruneNotice, mergeDispatchedArchive, pruneRows } from '@/shared/utils/dispatch-row-prune'; @@ -355,6 +356,7 @@ function toQueryAsinTaskView(item: QueryAsinHistoryItem): TaskItemView { `ASIN结构: ${formatTemplateSummary(item)}`, ...(item.error ? [`错误: ${userNotice(item.error)}`] : []), ], + progress: liveProgress(Number(item.taskId)), source: item, }; } diff --git a/frontend-vue/src/pages/brand/components/BrandShopDataCrawlTab.vue b/frontend-vue/src/pages/brand/components/BrandShopDataCrawlTab.vue index 3988143c3..e5d9b44b9 100644 --- a/frontend-vue/src/pages/brand/components/BrandShopDataCrawlTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandShopDataCrawlTab.vue @@ -170,6 +170,7 @@ import { runBatchDelete } from '@/shared/utils/batch-delete' import { useTablePaging } from '@/shared/composables/useTablePaging.ts' import { getModuleProgressLight } from '@/shared/api/progress-light.ts' import { createRowsVersionTracker } from '@/shared/api/task-progress-polling.ts' +import { liveProgress } from '@/shared/api/task-progress-live.ts' import { confirmTaskDeletion } from '@/shared/task-delete-confirm' const COUNTRY_OPTIONS = [ @@ -256,6 +257,7 @@ function toShopDataCrawlTaskView(item: ShopDataCrawlHistoryItem): TaskItemView { ...(item.platform ? [`平台:${item.platform}`] : []), ...(item.outputFilename ? [`文件:${item.outputFilename}`] : []), ], + progress: liveProgress(Number(item.taskId)), source: item, } } diff --git a/frontend-vue/src/pages/brand/components/BrandShopMatchTab.vue b/frontend-vue/src/pages/brand/components/BrandShopMatchTab.vue index 6f5067f72..b53dffa2e 100644 --- a/frontend-vue/src/pages/brand/components/BrandShopMatchTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandShopMatchTab.vue @@ -129,6 +129,7 @@ import ZiniaoVersionSetting from '@/shared/components/ZiniaoVersionSetting.vue' import { LISTING_FILTER_OPTIONS, type ListingFilterValue } from '@/pages/brand/components/listingFilters' import { activateShopMatchTask, addShopMatchCandidate, createShopMatchTask, deleteShopMatchCandidate, deleteShopMatchHistory, deleteShopMatchTask, getShopMatchCountryPreference, getShopMatchDashboard, getShopMatchHistory, getShopMatchResultDownloadUrl, getShopMatchTaskProgressBatch, listShopMatchCandidates, matchShopMatchShops, putShopMatchCountryPreference, type ShopMatchCandidateVo, type ShopMatchCreateTaskItem, type ShopMatchDashboardVo, type ShopMatchHistoryItem, type ShopMatchShopQueueItem, type ShopMatchTaskDetailVo } from '@/shared/api/java-modules' import { getPollingProgressBatch } from '@/shared/api/task-progress-polling.ts' +import { liveProgress } from '@/shared/api/task-progress-live.ts' import { getPywebviewApi } from '@/shared/bridges/pywebview' import { getTaskPollIntervalMs } from '@/shared/task-progress-config' import { createCategorizedTimers } from '@/shared/utils/categorized-timers' @@ -236,6 +237,7 @@ function toShopMatchTaskView(item: ShopMatchHistoryItem): TaskItemView { ...(item.outputFilename ? [`文件: ${item.outputFilename}`] : []), ...(item.error ? [`错误: ${userNotice(item.error)}`] : []), ], + progress: liveProgress(Number(item.taskId)), source: item, } } diff --git a/frontend-vue/src/pages/brand/components/BrandSplitTab.vue b/frontend-vue/src/pages/brand/components/BrandSplitTab.vue index 506b76d92..5e3a2db73 100644 --- a/frontend-vue/src/pages/brand/components/BrandSplitTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandSplitTab.vue @@ -233,6 +233,8 @@ function toSplitTaskView(item: SplitResultItem): TaskItemView { ...(item.entries && item.entries.length ? [`压缩包内容:${formatSplitEntries(item.entries)}`] : []), ...(item.error ? [`错误信息:${userNotice(item.error)}`] : []), ], + // 显式给 null:这一类是点了就跑完的一次性操作,卡片列的是完成记录,没有可数的分母。写死 null 而不是省略字段,是为了让「没得画」和「忘了接」在代码里长得不一样(守卫:tests/task-progress-view-wiring.test.ts)。 + progress: null, source: item, } } diff --git a/frontend-vue/src/pages/brand/components/BrandWithdrawTab.vue b/frontend-vue/src/pages/brand/components/BrandWithdrawTab.vue index 64c8679af..103d6e435 100644 --- a/frontend-vue/src/pages/brand/components/BrandWithdrawTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandWithdrawTab.vue @@ -279,6 +279,7 @@ import { isRecordMissingError, parseTaskStartTimes, removeTaskStartTime, upsertT import { useTablePaging } from '@/shared/composables/useTablePaging.ts' import { getModuleProgressLight } from '@/shared/api/progress-light.ts' import { createRowsVersionTracker } from '@/shared/api/task-progress-polling.ts' +import { liveProgress } from '@/shared/api/task-progress-live.ts' import { confirmTaskDeletion } from '@/shared/task-delete-confirm' import { waitForTaskTerminal as waitForTaskTerminalShared } from '@/shared/utils/task-terminal' @@ -386,6 +387,7 @@ function toWithdrawTaskView(item: WithdrawTaskGroupItem): TaskItemView { statusText: statusText(item.taskStatus), statusClass: statusClass(item.taskStatus), extraLines: item.error ? [`错误:${userNotice(item.error)}`] : [], + progress: liveProgress(Number(item.taskId)), source: item, }; } diff --git a/frontend-vue/src/shared/api/progress-light.ts b/frontend-vue/src/shared/api/progress-light.ts index 8e6c82b72..4a7ddd74d 100644 --- a/frontend-vue/src/shared/api/progress-light.ts +++ b/frontend-vue/src/shared/api/progress-light.ts @@ -3,6 +3,7 @@ import { buildJavaUrl } from './url.ts' import { API_ENDPOINTS } from './endpoints.ts' import { getTaskProgressCacheTtlMs, getTaskProgressTimeoutMs } from '../task-progress-config.ts' import { createTaskProgressRequestCache } from '../task-progress-request-cache.ts' +import { rememberLiveProgress } from './task-progress-live.ts' import type { TaskProgressBatchVo } from './types/task.ts' /** @@ -44,6 +45,13 @@ export interface TaskProgressLightItem { updatedAt?: string | null /** 结果行版本(「最后变更时间毫秒#行数」):未变说明行数据没动过,可跳过重型 batch。 */ rowsVersion?: string | null + /** + * 客户端心跳上报的执行进度(2026-10-10)。后端保证三者同生同灭: + * 读不到位置、或分母不是正数时三个都是 null,所以这里的「没有」不等于 0%。 + */ + progressCurrent?: number | null + progressTotal?: number | null + progressLabel?: string | null } export interface GetModuleProgressLightOptions { @@ -85,6 +93,9 @@ export function getModuleProgressLight( const cacheKey = `${path}::${normalizedTaskIds.join(",")}` const cached = progressLightCache.get(cacheKey) if (!options.force && cached !== undefined) { + // 命中缓存也要刷新一遍读数:进度按「最后一次被任何一轮 light 看到」计时, + // 只在真发请求时刷新会让进度条在缓存窗口里被判成过期而凭空消失。 + rememberLiveProgress(cached.items) return Promise.resolve(cached) } const inflight = progressLightCache.getInflight(cacheKey) @@ -104,6 +115,7 @@ export function getModuleProgressLight( missingTaskIds: data?.missingTaskIds || [], } progressLightCache.set(cacheKey, normalized) + rememberLiveProgress(normalized.items) return normalized }) .finally(() => { diff --git a/frontend-vue/src/shared/api/task-progress-live.ts b/frontend-vue/src/shared/api/task-progress-live.ts new file mode 100644 index 000000000..22efe3606 --- /dev/null +++ b/frontend-vue/src/shared/api/task-progress-live.ts @@ -0,0 +1,87 @@ +/** + * 心跳上报的实时进度(模块级缓存,2026-10-10)。 + * + * 为什么不直接把 progressCurrent/progressTotal 并进任务对象:各页把 light 结果 + * `{...prev.task, ...detail.task}` 合并进快照时,有 5 处带「变更签名」守卫 + * (签名 = rowsVersion|status|fileStatus|fileReady)。进度每轮都在动,而签名在 + * 「正在翻页、还没攒够一批回传」的时段里不变——照那条路走,进度条会一路停在上一次 + * 回传时的数字,看着像卡住。签名守卫是为「行数据按需拉取」省流量而设的,不该为它让步。 + * + * 所以进度走这条独立通道:轮询出口写入一次,页面渲染时按 taskId 读。 + * 读不到(老后端、老客户端没报位置、或超过 FRESH_WINDOW_MS 没刷新)就返回 null, + * 由卡片决定**不画**——「没有进度」和「进度 0%」是两件事。 + */ + +export interface LiveTaskProgress { + percent: number + stage?: string +} + +interface ProgressEntry { + current: number + total: number + label?: string + seenAt: number +} + +/** 超过这个时长没被任何一轮 light 刷新,就当作已经没有活的进度。 */ +const FRESH_WINDOW_MS = 60_000 +/** 缓存上限:正常一页在册任务远小于它,触顶时按最久未刷新淘汰(防无界增长)。 */ +const MAX_ENTRIES = 800 + +const entries = new Map() + +function clampPercent(current: number, total: number): number { + const percent = Math.floor((current * 100) / total) + if (!Number.isFinite(percent)) return 0 + return Math.min(100, Math.max(0, percent)) +} + +/** + * 记录一轮 light 响应里的进度。 + * + * 后端已保证「读不到位置」时三个字段一起为 null,这里再守一道:分母非正数就不登记, + * 免得 0/0 被算成一个 0% 的空轨(客户端归一化在四级 key 全缺时正是发 0/0)。 + */ +export function rememberLiveProgress(lightItems: unknown[] | null | undefined): void { + const now = Date.now() + for (const raw of lightItems || []) { + const item = raw as { taskId?: number; progressTotal?: number | null; progressCurrent?: number | null; progressLabel?: string | null } | null + if (!item || typeof item.taskId !== 'number' || item.taskId <= 0) continue + const total = typeof item.progressTotal === 'number' ? item.progressTotal : 0 + if (total <= 0) { + entries.delete(item.taskId) + continue + } + const current = typeof item.progressCurrent === 'number' && item.progressCurrent > 0 ? item.progressCurrent : 0 + const label = typeof item.progressLabel === 'string' && item.progressLabel.trim() ? item.progressLabel.trim() : undefined + entries.set(item.taskId, { current, total, label, seenAt: now }) + } + if (entries.size > MAX_ENTRIES) { + const stale = Array.from(entries.entries()) + .sort((left, right) => left[1].seenAt - right[1].seenAt) + .slice(0, entries.size - MAX_ENTRIES) + for (const [taskId] of stale) entries.delete(taskId) + } +} + +/** 取某任务的实时进度;没有活的读数时返回 null(调用方不得折成 0%)。 */ +export function liveProgress(taskId: number | null | undefined, now: number = Date.now()): LiveTaskProgress | null { + if (typeof taskId !== 'number' || taskId <= 0) return null + const entry = entries.get(taskId) + if (!entry) return null + if (now - entry.seenAt > FRESH_WINDOW_MS) { + entries.delete(taskId) + return null + } + return { percent: clampPercent(entry.current, entry.total), stage: entry.label } +} + +/** 任务结束或页面卸载时清掉读数。 */ +export function forgetLiveProgress(taskId: number): void { + entries.delete(taskId) +} + +export function resetLiveProgress(): void { + entries.clear() +} diff --git a/frontend-vue/src/shared/api/task-progress-polling.ts b/frontend-vue/src/shared/api/task-progress-polling.ts index 1b87442eb..aff1b453e 100644 --- a/frontend-vue/src/shared/api/task-progress-polling.ts +++ b/frontend-vue/src/shared/api/task-progress-polling.ts @@ -25,6 +25,9 @@ export interface LightPollingItem { fileError?: string | null fileReady?: boolean | null updatedAt?: string | null + progressCurrent?: number | null + progressTotal?: number | null + progressLabel?: string | null } } @@ -33,7 +36,8 @@ export function toBatchItems(lightItems: unknown[]): LightPollingItem[] { for (const raw of lightItems || []) { const item = raw as { taskId?: number; status?: string | null; statusCode?: string | null fileStatus?: string | null; fileError?: string | null; fileReady?: boolean | null - updatedAt?: string | null } | null + updatedAt?: string | null; progressCurrent?: number | null; progressTotal?: number | null + progressLabel?: string | null } | null if (!item || typeof item.taskId !== 'number' || item.taskId <= 0) { continue } @@ -48,6 +52,9 @@ export function toBatchItems(lightItems: unknown[]): LightPollingItem[] { fileError: item.fileError ?? null, fileReady: item.fileReady ?? null, updatedAt: item.updatedAt ?? null, + progressCurrent: item.progressCurrent ?? null, + progressTotal: item.progressTotal ?? null, + progressLabel: item.progressLabel ?? null, }, }) } diff --git a/frontend-vue/tests/task-progress-live.test.ts b/frontend-vue/tests/task-progress-live.test.ts new file mode 100644 index 000000000..1ff0d9f89 --- /dev/null +++ b/frontend-vue/tests/task-progress-live.test.ts @@ -0,0 +1,78 @@ +import { test } from 'node:test' +import assert from 'node:assert/strict' +import { + forgetLiveProgress, + liveProgress, + rememberLiveProgress, + resetLiveProgress, +} from '../src/shared/api/task-progress-live.ts' + +test('心跳读数换算成百分比与阶段文案', () => { + resetLiveProgress() + rememberLiveProgress([ + { taskId: 1, progressCurrent: 12, progressTotal: 50, progressLabel: '国家 US(3/5)' }, + ]) + + assert.deepEqual(liveProgress(1, 1_000), { percent: 24, stage: '国家 US(3/5)' }) +}) + +test('分母非正数一律不登记(没有进度不等于 0%)', () => { + resetLiveProgress() + rememberLiveProgress([ + { taskId: 2, progressCurrent: 0, progressTotal: 0 }, + { taskId: 3, progressCurrent: 5, progressTotal: null }, + ]) + + assert.equal(liveProgress(2), null, '0/0 必须读成「没有进度」,否则卡片画一条 0% 空轨') + assert.equal(liveProgress(3), null) +}) + +test('分母塌回 0 时把旧读数清掉,进度条不许停在最后一次回传的数字上', () => { + resetLiveProgress() + rememberLiveProgress([{ taskId: 4, progressCurrent: 30, progressTotal: 40 }]) + assert.equal(liveProgress(4)?.percent, 75) + + rememberLiveProgress([{ taskId: 4, progressCurrent: 0, progressTotal: 0 }]) + + assert.equal(liveProgress(4), null) +}) + +test('百分比钳在 0..100,超过分母不给 114%', () => { + resetLiveProgress() + rememberLiveProgress([ + { taskId: 5, progressCurrent: 57, progressTotal: 50 }, + { taskId: 6, progressCurrent: -3, progressTotal: 50 }, + ]) + + assert.equal(liveProgress(5)?.percent, 100) + assert.equal(liveProgress(6)?.percent, 0) +}) + +test('超过新鲜窗口不再报进度(心跳停了就别说还在跑)', () => { + resetLiveProgress() + rememberLiveProgress([{ taskId: 7, progressCurrent: 1, progressTotal: 4 }]) + const seenAt = Date.now() + + assert.equal(liveProgress(7, seenAt + 59_000)?.percent, 25) + assert.equal(liveProgress(7, seenAt + 61_000), null, '60 秒没被任何一轮 light 刷新就当作没有活进度') + assert.equal(liveProgress(7), null, '过期条目要顺手清掉,不能留着让 Map 无界增长') +}) + +test('forget 与非法 taskId 安全', () => { + resetLiveProgress() + rememberLiveProgress([{ taskId: 8, progressCurrent: 1, progressTotal: 2 }]) + assert.equal(liveProgress(8)?.percent, 50) + + forgetLiveProgress(8) + assert.equal(liveProgress(8), null) + assert.equal(liveProgress(null), null) + assert.equal(liveProgress(0), null) + assert.equal(liveProgress(-5), null) +}) + +test('文案为空白时不产出空 stage', () => { + resetLiveProgress() + rememberLiveProgress([{ taskId: 9, progressCurrent: 1, progressTotal: 2, progressLabel: ' ' }]) + + assert.deepEqual(liveProgress(9), { percent: 50, stage: undefined }) +}) diff --git a/frontend-vue/tests/task-progress-polling.test.ts b/frontend-vue/tests/task-progress-polling.test.ts index fb0bfcf30..c193ab643 100644 --- a/frontend-vue/tests/task-progress-polling.test.ts +++ b/frontend-vue/tests/task-progress-polling.test.ts @@ -16,9 +16,22 @@ test('轻量项归一为重型 batch 的嵌套形状', () => { fileError: null, fileReady: false, updatedAt: '2026-09-14T06:00:00', + progressCurrent: null, + progressTotal: null, + progressLabel: null, }) }) +test('心跳进度三字段照抄进嵌套 task,不被白名单丢掉', () => { + const items = toBatchItems([ + { taskId: 8, status: 'RUNNING', progressCurrent: 12, progressTotal: 50, progressLabel: 'US(3/5)' }, + ]) + + assert.equal(items[0].task?.progressCurrent, 12) + assert.equal(items[0].task?.progressTotal, 50) + assert.equal(items[0].task?.progressLabel, 'US(3/5)') +}) + test('缺少 taskId 的项被丢弃,非法 taskId 同样丢弃', () => { const items = toBatchItems([{ status: 'RUNNING' }, { taskId: 0, status: 'RUNNING' }, { taskId: 3 }]) diff --git a/frontend-vue/tests/task-progress-view-wiring.test.ts b/frontend-vue/tests/task-progress-view-wiring.test.ts new file mode 100644 index 000000000..74b80b0e3 --- /dev/null +++ b/frontend-vue/tests/task-progress-view-wiring.test.ts @@ -0,0 +1,75 @@ +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}`) + } +})