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, countryLabel, 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 TASK_TABLE = 'src/pages/task-center/TaskCenterTaskTable.vue' const VARIANT_TABLE = 'src/pages/task-center/TaskCenterVariantTable.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', () => { // 三态收敛(2026-10-04 用户定案:只要 执行中/成功/失败):进行中各态并入执行中, // 完成态并入成功,失败/出错/取消并入失败(取消 = 没成功也不在跑)。 assert.equal(taskStatusLabel('PENDING'), '执行中') assert.equal(taskStatusLabel('RUNNING'), '执行中') assert.equal(taskStatusLabel('SCHEDULED'), '执行中') assert.equal(taskStatusLabel('SUCCESS'), '成功') assert.equal(taskStatusLabel('COMPLETED'), '成功', '完成态历史拼写并入成功') assert.equal(taskStatusLabel('FAILED'), '失败') assert.equal(taskStatusLabel('ERROR'), '失败', '出错并入失败') assert.equal(taskStatusLabel('CANCELLED'), '失败', '取消并入失败') assert.equal(taskStatusLabel('CANCELED'), '失败', '历史脏拼写同样并入失败') assert.equal(taskStatusLabel(''), '执行中', '未知状态不是终态,按执行中读') assert.equal(taskStatusLabel('WEIRD'), '执行中') assert.equal(taskStatusType('SUCCESS'), 'success') assert.equal(taskStatusType('FAILED'), 'failed') assert.equal(taskStatusType('CANCELLED'), 'failed') assert.equal(taskStatusType('PENDING'), 'running') assert.equal(taskStatusType('RUNNING'), 'running') assert.ok(TASK_STATUS_OPTIONS.length >= 4) 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 >= 14, '业务下拉覆盖客户端模块(2026-10-16 删除ASIN/巡店删除恢复后 12→14)') // 正向钉:2026-10-16 用户口径恢复这两项。此前那条「退役不许回流」的反向钉随功能恢复一并作废—— // 后端 TaskModuleRegistry 的枚举一直在,前端下拉与它对齐;这两值再消失就是判红。 assert.equal( MODULE_OPTIONS.some((o) => o.value === 'DELETE_BRAND' && o.label === '删除ASIN'), true, '删除ASIN 必须单列在下拉里(恢复后不许再消失)') assert.equal( MODULE_OPTIONS.some((o) => o.value === 'PATROL_DELETE' && o.label === '巡店删除'), true, '巡店删除 必须单列在下拉里(恢复后不许再消失)') }) test('task_center_variant_status_map_follows_maixiang_semantics', () => { // 四态文案(2026-10-05 用户定案):待执行/处理中/成功/失败,不再有 等待执行/已完成/处理失败 旧词。 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-05 用户定案,取代同日早先「只看在跑」的口径): * 空值恢复「全部状态」,2 成功 / 3 失败 回列入口,「在跑」合并口径从下拉与文案里彻底撤掉。 */ test('task_center_variant_status_options_are_the_four_states', () => { assert.deepEqual(VARIANT_STATUS_OPTIONS, [ { value: '', label: '全部状态' }, { value: '0', label: '待执行' }, { value: '1', label: '处理中' }, { value: '2', label: '成功' }, { value: '3', label: '失败' }, ]) const page = readSource(PAGE) assert.equal(/只看在跑/.test(page), false, '面板说明不再写只看在跑') assert.match(page, /title="麦象变体采集任务条数(全部状态)/, '徽章 tooltip 换成全部状态口径') assert.match(page, /默认全部状态(待执行\/处理中\/成功\/失败)/, '面板说明写明四态') }) 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 table = readSource(TASK_TABLE) assert.match(table, /