Files
crawler-plugin/admin-frontend-vue/tests/task-center-board.test.ts
T
huangzd1997 c4a35c6447 feat(看板): 变体采集只看在跑,进度列改客户端同源口径
两件事,都是用户当场指出的读数误导:

1. 变体采集页签徽章 106 是麦象历史全量。console 代理一次只接受一个 status,
   故 status 缺省时服务端合并 0(等待)∪1(处理中),按 createTime 倒序后内存切片;
   单状态各拉 200 条,触顶打 warn。前端状态下拉去掉「已完成/处理失败」两个入口。

2. 进度列的「已完成 0 / 总 1」来自 source_file_count(采集/跟价都是单文件任务),
   与客户端进度条不同源。改为按模块分档:COLLECT_DATA 取 result_json 的
   $.totalRows/$.processedRows(与客户端「关键词进度:第 X/N 个」同一对数),
   PRICE_TRACK/SHOP_MATCH 这类客户端本来没有进度条的返回 0,前端 progressTotal<=0
   显示「—」且不再画 0% 进度轨;PUBLISH/DELETE_BRAND/品牌行保持文件数/品牌行数。

护栏:Mapper SQL 渲染 26 例、QueryService 34 例、VariantService 8 例、
ScopeService 7 例;前端 node:test 1653 例。docs/specs/16-client-task-console.md
的「进度口径」一节按新规则重写。
2026-10-04 10:27:09 +08:00

331 lines
17 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import test from 'node:test'
import assert from 'node:assert/strict'
import { readSource } from './helpers.ts'
import { adminPages, validateAdminPages } from '../src/router/routes.ts'
import { operationGuideFor } from '../src/layout/operation-guides.ts'
import {
MODULE_OPTIONS,
TASK_STATUS_OPTIONS,
VARIANT_STATUS_OPTIONS,
buildTaskQuery,
buildVariantQuery,
createTaskFilter,
createVariantFilter,
deviceDisplayName,
progressPercent,
progressText,
shopDisplayName,
tabCount,
taskStatusLabel,
taskStatusType,
toApiTime,
variantAccountText,
variantStatusLabel,
} from '../src/pages/task-center/task-center-model.ts'
// 客户端任务管理看板(后台):路由注册 / guides 对齐 / 接口层 / 纯逻辑映射。
const PAGE = 'src/pages/task-center/TaskCenterBoardPage.vue'
const API = 'src/api/task-center.ts'
test('task_center_route_registered_with_menu_key', () => {
const page = adminPages.find((p) => p.path === 'task-center/board')
assert.ok(page, '路由注册表登记 task-center/board')
assert.equal(page.menuKey, 'admin_task_center')
assert.equal(page.title, '客户端任务管理')
assert.match(String(page.load), /task-center\/TaskCenterBoardPage\.vue/)
assert.deepEqual(validateAdminPages(adminPages), [])
})
test('task_center_guide_present_for_menu_key', () => {
const guide = operationGuideFor('admin_task_center')
assert.ok(guide, '菜单 key 有独立 guide(align-operation-guide 强制)')
assert.ok(guide.text.length > 10)
assert.equal(guide.steps.length, 3)
})
test('task_center_api_has_six_endpoints', () => {
const api = readSource(API)
for (const path of [
'/api/admin/task-center/overview',
'/api/admin/task-center/shops',
'/api/admin/task-center/shop-options',
'/api/admin/task-center/tasks',
'/api/admin/task-center/tasks/detail',
'/api/admin/task-center/variant-tasks',
]) {
assert.ok(api.includes(path), `接口层覆盖 ${path}`)
}
for (const fn of [
'fetchTaskCenterOverview',
'fetchTaskCenterShops',
'fetchTaskCenterShopOptions',
'fetchTaskCenterTasks',
'fetchTaskCenterTaskDetail',
'fetchTaskCenterVariantTasks',
]) {
assert.match(api, new RegExp(`export (async )?function ${fn}`), `导出 ${fn}`)
}
assert.match(api, /unwrap</, '统一走 unwrap 解包')
})
/** 设备维度已下线:卡片是店铺,接口不再有 /devices,筛选不再有 deviceId。 */
test('task_center_device_dimension_is_gone', () => {
const api = readSource(API)
const model = readSource('src/pages/task-center/task-center-model.ts')
const page = readSource(PAGE)
for (const dead of ['deviceTotal', 'deviceOnline', 'TaskCenterDevice', '/devices', 'fetchTaskCenterDevices']) {
assert.equal(api.includes(dead), false, `接口层不再有 ${dead}`)
}
assert.equal(model.includes("deviceId: ''"), false, '筛选条件不再有设备号')
assert.equal(/buildTaskQuery[\s\S]*put\('deviceId'/.test(model), false, '查询参数不再下传 deviceId')
assert.equal(page.includes('filter.deviceId'), false, '页面不再按设备筛')
assert.equal('deviceId' in createTaskFilter(), false)
})
test('task_center_status_labels_cover_backend_states', () => {
assert.equal(taskStatusLabel('PENDING'), '待执行')
assert.equal(taskStatusLabel('RUNNING'), '执行中')
assert.equal(taskStatusLabel('SUCCESS'), '已完成')
assert.equal(taskStatusLabel('FAILED'), '失败')
assert.equal(taskStatusLabel('CANCELLED'), '已取消')
assert.equal(taskStatusLabel(''), '未知')
assert.equal(taskStatusType('SUCCESS'), 'success')
assert.equal(taskStatusType('FAILED'), 'failed')
assert.equal(taskStatusType('CANCELLED'), 'cancelled')
assert.equal(taskStatusType('PENDING'), 'pending')
assert.equal(taskStatusType('RUNNING'), 'running')
assert.ok(TASK_STATUS_OPTIONS.length >= 5)
assert.equal(TASK_STATUS_OPTIONS[0].value, '')
assert.equal(MODULE_OPTIONS[0].value, '', '首项为「全部业务」')
assert.equal(MODULE_OPTIONS.slice(1).every((o) => o.value && o.label), true)
assert.ok(MODULE_OPTIONS.length >= 13, '业务下拉覆盖客户端模块')
})
test('task_center_variant_status_map_follows_maixiang_semantics', () => {
assert.equal(variantStatusLabel(0), '等待执行')
assert.equal(variantStatusLabel(1), '处理中')
assert.equal(variantStatusLabel(2), '已完成')
assert.equal(variantStatusLabel(3), '处理失败')
assert.equal(variantStatusLabel(9), '未知')
assert.equal(variantStatusLabel(null), '未知')
assert.equal(variantStatusLabel('2'), '已完成', '字符串数字同样识别')
})
/**
* 变体采集页签只讲「在跑」(2026-10-04 用户口径:历史彻底不看):
* 状态下拉必须收掉 2 已完成 / 3 处理失败 两个入口,空值改成「在跑」而不是「全部状态」——
* 文案留着「全部状态」会让用户以为后端还在给他合并历史。
*/
test('task_center_variant_status_options_drop_history_states', () => {
assert.deepEqual(VARIANT_STATUS_OPTIONS, [
{ value: '', label: '在跑' },
{ value: '0', label: '等待执行' },
{ value: '1', label: '处理中' },
])
const values = VARIANT_STATUS_OPTIONS.map((o) => o.value)
assert.equal(values.includes('2'), false, '已完成不再是可选项')
assert.equal(values.includes('3'), false, '处理失败不再是可选项')
const page = readSource(PAGE)
assert.match(page, /只看在跑/, '面板说明写明只看在跑')
assert.match(page, /title="麦象在跑批量任务条数/, '徽章 tooltip 是在跑口径不是全部状态')
assert.equal(/麦象批量任务条数(全部状态)/.test(page), false)
})
test('task_center_device_display_falls_back_to_truncated_id', () => {
assert.equal(deviceDisplayName('小明的电脑', 'dev-1'), '小明的电脑')
const long = 'a'.repeat(40)
const shown = deviceDisplayName(null, long)
assert.ok(shown.length < long.length, '无设备名时截断设备号')
assert.ok(shown.endsWith('…'))
assert.equal(deviceDisplayName('', ''), '未记录')
assert.equal(shopDisplayName('店铺甲', 1), '店铺甲')
assert.equal(shopDisplayName('店铺甲', 3), '店铺甲 等3个')
assert.equal(shopDisplayName('', 0), '—')
})
/**
* 进度口径与客户端一致:完成数 = 已处理(成功 + 失败都算跑完一步),
* 见 frontend-vue `BrandBrandTab.vue`「完成数 = 已处理品牌行(成功或查询失败都计入)」。
* 旧文案「成功 0 / 总 1」会把一个已跑完(失败 1)的任务读成 0% 进度。
*/
test('task_center_progress_counts_done_rows_like_the_client', () => {
assert.equal(progressText({ progressSuccess: 3, progressFailed: 0, progressTotal: 10 }), '已完成 3 / 总 10')
assert.equal(
progressText({ progressSuccess: 0, progressFailed: 1, progressTotal: 1 }),
'已完成 1 / 总 1',
'失败的那一步同样是已完成的一步',
)
assert.equal(progressText({ progressSuccess: 0, progressFailed: 0, progressTotal: 0 }), '—')
assert.equal(progressText({ progressSuccess: 0, progressFailed: 0, progressTotal: -1 }), '—', '哨兵总数不当进度')
assert.equal(progressPercent({ progressSuccess: 3, progressFailed: 1, progressTotal: 10 }), 40)
assert.equal(progressPercent({ progressSuccess: 0, progressFailed: 1, progressTotal: 1 }), 100)
assert.equal(progressPercent({ progressSuccess: 0, progressFailed: 0, progressTotal: 0 }), 0)
assert.equal(progressPercent({ progressSuccess: 15, progressFailed: 0, progressTotal: 10 }), 100, '超出按 100 截断')
assert.equal(progressPercent({ progressSuccess: -5, progressFailed: 0, progressTotal: 10 }), 0, '脏负数不按负进度画')
})
/**
* 后端把「客户端没有进度条」的模块(跟价/定时匹配)progressTotal 置 0 ⇒ 前端只画「—」:
* 留一条 0% 空进度轨会被读成「进度 0%」,和「这里没有进度可看」是两件事。
*/
test('task_center_progress_bar_is_dropped_when_there_is_no_progress', () => {
const page = readSource(PAGE)
assert.match(page, /<div class="p-track" v-if="row\.progressTotal > 0">/, '无进度时不画进度轨')
})
test('task_center_query_builder_omits_blanks_and_normalizes_time', () => {
const query = buildTaskQuery(
{ username: ' 张三 ', moduleType: 'COLLECT_DATA', status: 'RUNNING', shop: '林芳旗舰店', startTime: '2026-09-28T10:00', endTime: '' },
2,
20,
)
assert.equal(query.page, 2)
assert.equal(query.pageSize, 20)
assert.equal(query.username, '张三')
assert.equal(query.moduleType, 'COLLECT_DATA')
assert.equal(query.status, 'RUNNING')
assert.equal(query.shop, '林芳旗舰店', '店铺名原样下传,由后端做 LOWER(TRIM) 精确匹配')
assert.equal(query.startTime, '2026-09-28T10:00:00')
assert.equal(query.endTime, undefined)
assert.equal(toApiTime(' 2026-09-28T10:00 '), '2026-09-28T10:00:00')
assert.equal(toApiTime('2026-09-28T10:00:30'), '2026-09-28T10:00:30')
assert.equal(toApiTime(''), undefined)
})
test('task_center_variant_query_builder_keeps_paging', () => {
const empty = buildVariantQuery({ status: '' }, 1, 20)
assert.equal(empty.status, undefined, '空状态不下传 status ⇒ 后端按在跑(0∪1)合并')
assert.equal(empty.page, 1)
const filtered = buildVariantQuery({ status: '1' }, 3, 50)
assert.equal(filtered.status, 1)
assert.equal(buildVariantQuery({ status: '0' }, 1, 20).status, 0, '状态 0 是 falsy,不能被当成「没选」')
assert.equal(filtered.page, 3)
assert.equal(filtered.pageSize, 50)
})
test('task_center_filter_reset_clears_every_field', () => {
const filter = createTaskFilter()
assert.deepEqual(Object.values(filter), ['', '', '', '', '', ''])
assert.deepEqual(createVariantFilter(), { status: '' })
assert.deepEqual(buildTaskQuery(createTaskFilter(), 1, 20), { page: 1, pageSize: 20 }, '重置后只带分页参数')
assert.equal(variantAccountText({ username: 'wangwu', uid: '1048' }), 'wangwu')
assert.equal(variantAccountText({ username: null, uid: 'collect-27475' }), 'collect-27475', '伪 uid 回落')
assert.equal(variantAccountText({ username: '', uid: '' }), '—')
})
test('task_center_page_handles_empty_and_error_states', () => {
const page = readSource(PAGE)
assert.match(page, /暂无符合条件的任务/, '任务空态')
assert.match(page, /暂无在跑店铺/, '店铺面板空态')
assert.match(page, /暂无在跑的变体采集任务/, '变体空态:口径是在跑不是全部')
assert.match(page, /ElMessage\.error/, '接口失败提示')
assert.match(page, /resetFilter/, '筛选重置接线')
assert.match(page, /@size-change="changeTaskSize"/, '分页每页条数切换')
assert.match(page, /@size-change="changeVariantSize"/, '变体分页每页条数切换')
})
test('task_center_shop_panel_is_the_board_and_drills_down_by_exact_shop', () => {
const page = readSource(PAGE)
assert.match(page, /在跑店铺看板/, '面板标题')
assert.match(page, /最近上报/, '面板与任务表都带最近上报')
assert.match(page, /row\.noShop \? null : selectShop\(row\.shop\)/, '点店铺行下钻,「不挂店铺」桶不可点')
assert.match(page, /不落店铺/, '桶行说明:这类任务本来就没有店铺维度')
assert.match(page, /shopFilterOptions/, '店铺下拉候选 = 店铺库 ∪ 面板出现的店铺')
assert.match(page, /fetchTaskCenterShops/, '面板取数')
assert.match(page, /fetchTaskCenterShopOptions/, '候选取数')
assert.match(page, /moduleSummary/, '业务分布列')
assert.equal(page.includes('device-strip'), false, '设备卡条已删除')
})
/**
* 任务列表列改造(2026-10-04 用户要求):
* ① 「当前处理」列全是「—」(无快照模块没有 current_scope_key),换成任务 ID;
* ID 单元格继承被删掉的「查看」按钮职责,否则详情抽屉没有入口。
* ② 账号下方的 taskNo 副行删掉——ID 已经在独立列里,长任务号只把行撑高。
* ③ 「操作」列整条删除,空态 colspan 跟着从 10 收到 9。
* ④ 店铺那组比别的多一行提示文案,而 .form-row 是 align-items: flex-end,
* 于是它的 label 被顶高一行——提示必须退出列流(绝对定位)而不是删掉。
*/
test('task_center_task_list_columns_are_trimmed_to_the_data_that_exists', () => {
const page = readSource(PAGE)
const style = page.slice(page.indexOf('<style scoped>'))
assert.match(page, /<th style="width: 170px">任务ID<\/th>/, '「当前处理」列改名任务ID')
assert.equal(/<th[^>]*>当前处理<\/th>/.test(page), false, '列表不再有全「—」的当前处理列')
assert.match(page, /<td>\s*<button class="cell-link mono" type="button" @click="openDetail\(row\)">\{\{ row\.id \}\}<\/button>/, 'ID 单元格点开详情')
assert.match(page, /:key="row\.taskNo"/, ':key 仍是唯一任务号(biz 与 brand 两张表的自增 id 会撞)')
assert.equal(/<span class="sub">\{\{ row\.taskNo \}\}<\/span>/.test(page), false, '账号下方不再重复任务号')
assert.equal(/<th[^>]*>操作<\/th>/.test(page), false, '操作列已删')
assert.equal(page.includes('btn-sm'), false, '没有别的按钮后 btn-sm 样式一并撤掉')
assert.equal(/colspan="10"/.test(page), false, '任务表空态不再是 10 列')
assert.equal(page.match(/colspan="9"/g)?.length, 2, '加载中/空态两处收到 9 列')
assert.match(style, /\.shop-filter\s*\{[^}]*position: relative/, '店铺组是提示的定位父元素')
assert.match(style, /\.filter-tip\s*\{[^}]*position: absolute/, '提示绝对定位,不再撑高该组把 label 顶上去')
assert.match(style, /\.form-row\s*\{[^}]*align-items: flex-end[^}]*margin-bottom: 22px/, '底部留白容纳提示行')
assert.match(
page,
/<el-select[\s\S]{0,220}class="admin-filter"[\s\S]{0,220}placeholder="全部店铺"/,
'店铺下拉挂全局 admin-filter(控件 42px,与其它原生控件同高,flex-end 下 label 才齐线)',
)
})
test('task_center_page_wires_tabs_filters_and_polling', () => {
const page = readSource(PAGE)
assert.match(page, /客户端任务/, '页签一文案')
assert.match(page, /变体采集/, '页签二文案')
assert.match(page, /panel-box/, '复用全局 panel-box 样式')
assert.match(page, /form-row/, '复用全局筛选行样式')
assert.match(page, /OldPagination/, '旧版分页组件')
assert.match(page, /formatDateTime/, '统一时间格式')
assert.match(page, /el-drawer/, '任务详情抽屉')
assert.match(page, /疑似卡住/, 'stuck 徽标文案')
assert.match(page, /网页/, '网页登录设备徽标')
assert.match(page, /visibilitychange/, '页面回前台恢复刷新')
assert.match(page, /document\.visibilityState/, '隐藏时跳过轮询')
assert.match(page, /POLL_INTERVAL_MS/, '30s 轮询常量')
assert.match(page, /clearInterval/, '卸载清理定时器')
assert.match(page, /resMes/, '变体表展示麦象 res_mes')
assert.equal(/shopName/.test(readSource(PAGE)), true)
})
/**
* 页签徽章的两个口径缺陷:
* ① 「客户端任务」曾绑列表 total(默认全部状态、全部时间 = 历史全量,线上 1135 条,
* 且每天 00:00 的 7 天保留清理会把它往下掉),而这一页讲的是「当前在跑」——
* 现在绑汇总卡的 runningTasks,两处不允许各算各的。
* ② 「变体采集」曾恒显示 0:refreshAll 只加载当前页签的列表,停在页签一时该接口
* 从未请求过(线上此刻返回 106 条)。没查过与"查了是 0"必须是两个读数。
*/
test('task_center_tab_badge_never_claims_an_unqueried_count', () => {
assert.equal(tabCount(undefined), null, '接口没回 total 不能读成 0')
assert.equal(tabCount(null), null)
assert.equal(tabCount(''), null)
assert.equal(tabCount(Number.NaN), null)
assert.equal(tabCount(-1), null, '麦象未注册结果表时 total 是 -1 哨兵,不是条数')
assert.equal(tabCount(0), 0, '接口真的返回 0 才算 0')
assert.equal(tabCount('106'), 106)
const page = readSource(PAGE)
// ① 页签一 = 在跑数,与汇总卡同源;历史全量只留给分页用
assert.match(page, /const runningBadge = computed\(\(\) => tabCount\(overview\.value\?\.runningTasks\)\)/,
'页签一徽章取 overview.runningTasks')
assert.match(page, /\{\{\s*runningBadge\s*\?\?\s*'—'\s*\}\}/, '页签一画在跑数,没取到时画 —')
assert.equal(/<span class="t-count">\{\{ taskTotal/.test(page), false, '页签一不再绑列表总数')
// ② 页签二 = 真查过的条数,未查过/查失败都画 —
assert.match(page, /const variantTotal = ref<number \| null>\(null\)/, '初始是「没查过」不是 0')
assert.match(page, /\{\{\s*variantTotal\s*\?\?\s*'—'\s*\}\}/, '页签二未查过时徽章画 —')
assert.match(page, /variantTotal\.value = tabCount\(/, '变体总数经 tabCount 归一')
assert.match(page, /catch[\s\S]{0,160}variantTotal\.value = null/, '加载失败退回「没查过」,不留在 0')
assert.match(page, /loadInactiveTabTotal/, '首屏补查另一个页签的条数')
assert.match(page, /onMounted\(\(\) => \{[\s\S]{0,220}loadInactiveTabTotal/, '补查挂在首屏')
assert.match(
page,
/activeTab\.value === 'tasks' \? loadTasks\(silent\) : loadVariants\(silent\)/,
'30s 轮询仍只刷当前页签:麦象 console 是外部依赖,不进热路径',
)
})