dfb75dd0ff
- 路由 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(79b5d403 登记路由时漏补,align-operation-guide 一直红) Tests run: 1634, Failures: 0(node --test 全量)+ vue-tsc 无错误 + vite build 通过, 浏览器真跑:页签切换、设备卡筛选、详情抽屉均正常,控制台无报错
188 lines
8.1 KiB
TypeScript
188 lines
8.1 KiB
TypeScript
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)
|
||
})
|