Files
crawler-plugin/admin-frontend-vue/tests/task-center-board.test.ts
T
huangzd1997 3a8f6968ff feat(taskcenter): 前端看板页面(页签/筛选/汇总卡/设备条/详情抽屉)
- 路由 task-center/board(menuKey admin_task_center)+ guides 文案,both 由既有门禁守
- api 层 5 个只读接口;详情接口把后端 data:null 归一为 null(unwrap 对 null data 回传信封)
- 页签一:5 项汇总卡 + 设备卡条(点击按设备筛选/再点取消)+ 10 列任务表(stuck/网页/失败角标、进度条)+ 详情抽屉(分组明细)
- 页签二:变体采集专列(不显示设备与店铺),展示麦象 res_mes 与任务参数
- 30s 轮询:页面隐藏跳过、回前台立即刷新、卸载清理;另有手动刷新
- 顺带补 admin_device_logs 缺失的 guide(a7f244f9 登记路由时漏补,align-operation-guide 一直红)

Tests run: 1634, Failures: 0(node --test 全量)+ vue-tsc 无错误 + vite build 通过,
浏览器真跑:页签切换、设备卡筛选、详情抽屉均正常,控制台无报错
2026-09-28 23:35:54 +08:00

188 lines
8.1 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,
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_five_endpoints', () => {
const api = readSource(API)
for (const path of [
'/api/admin/task-center/overview',
'/api/admin/task-center/devices',
'/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',
'fetchTaskCenterDevices',
'fetchTaskCenterTasks',
'fetchTaskCenterTaskDetail',
'fetchTaskCenterVariantTasks',
]) {
assert.match(api, new RegExp(`export (async )?function ${fn}`), `导出 ${fn}`)
}
assert.match(api, /unwrap</, '统一走 unwrap 解包')
})
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'), '已完成', '字符串数字同样识别')
assert.equal(VARIANT_STATUS_OPTIONS.length, 5)
})
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), '—')
})
test('task_center_progress_text_and_percent_boundaries', () => {
assert.equal(progressText({ progressSuccess: 3, progressTotal: 10 }), '成功 3 / 总 10')
assert.equal(progressText({ progressSuccess: 0, progressTotal: 0 }), '—')
assert.equal(progressPercent({ progressSuccess: 3, progressTotal: 10 }), 30)
assert.equal(progressPercent({ progressSuccess: 0, progressTotal: 0 }), 0)
assert.equal(progressPercent({ progressSuccess: 15, progressTotal: 10 }), 100, '超出按 100 截断')
})
test('task_center_query_builder_omits_blanks_and_normalizes_time', () => {
const query = buildTaskQuery(
{ username: ' 张三 ', moduleType: 'COLLECT_DATA', status: 'RUNNING', deviceId: 'dev-1', 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.deviceId, 'dev-1')
assert.equal(query.shop, undefined, '空白店铺不下传')
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)
assert.equal(empty.page, 1)
const filtered = buildVariantQuery({ status: '3' }, 3, 50)
assert.equal(filtered.status, 3)
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_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)
})