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 { ACTIVE_TASK_STATUS, 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_five_endpoints', () => { const api = readSource(API) for (const path of [ '/api/admin/task-center/overview', '/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', '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, '脏负数不按负进度画') }) /** * 采集数据的进度文案逐字抄客户端(BrandCollectDataTab.vue taskKeywordProgress): * 客户端从不显示「已完成 0 / 总 1」,看板这么写就会被读成任务卡在第 0 步。 * N = 已处理 + 1(下一个要处理的关键词),封顶总个数——跑完时客户端也停在「第 总/总 个」,不会跳到 总+1。 */ test('task_center_collect_data_progress_wording_matches_the_client', () => { assert.equal( progressText({ progressSuccess: 0, progressFailed: 0, progressTotal: 1, moduleType: 'COLLECT_DATA' }), '关键词进度:第 1/1 个', ) assert.equal( progressText({ progressSuccess: 1, progressFailed: 0, progressTotal: 2, moduleType: 'COLLECT_DATA' }), '关键词进度:第 2/2 个', '已处理 1/2 ⇒ 正在处理第 2 个,不是 50% 那种读法', ) assert.equal( progressText({ progressSuccess: 41, progressFailed: 0, progressTotal: 41, moduleType: 'COLLECT_DATA' }), '关键词进度:第 41/41 个', '跑完不溢出成 42/41', ) assert.equal( progressText({ progressSuccess: 3, progressFailed: 0, progressTotal: 10, moduleType: 'collect_data' }), '关键词进度:第 4/10 个', '大小写差异不放过(品牌任务状态就是小写)', ) assert.equal( progressText({ progressSuccess: 3, progressFailed: 0, progressTotal: 10, moduleType: 'PUBLISH' }), '已完成 3 / 总 10', '只有采集数据换文案,按文件数计进度的模块不动', ) assert.equal( progressText({ progressSuccess: 0, progressFailed: 0, progressTotal: 0, moduleType: 'COLLECT_DATA' }), '—', '客户端 total 不可用时也是空串,这边继续画「—」', ) }) /** * 后端把「客户端没有进度条」的模块(跟价/定时匹配)progressTotal 置 0 ⇒ 前端只画「—」: * 留一条 0% 空进度轨会被读成「进度 0%」,和「这里没有进度可看」是两件事。 */ test('task_center_progress_bar_is_dropped_when_there_is_no_progress', () => { const page = readSource(PAGE) assert.match(page, /