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 { 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, /
/, '无进度时不画进度轨') }) /** * 失败任务的进度列(2026-10-04 用户要求):失败任务的进度快照要么冻在中间阶段、 * 要么按构建单位写满格,列表继续画「已完成 N / 总 N」+ 满格条会被读成「跑完了」—— * 失败行(含详情抽屉)只给失败徽标,不给进度条也不说「已完成」。 */ test('task_center_failed_rows_never_render_a_progress_bar', () => { const sources = { row: readSource(TASK_TABLE), detail: readSource(PAGE) } for (const scope of ['row', 'detail']) { const branch = new RegExp( ``, ).exec(sources[scope as keyof typeof sources]) assert.ok(branch, `${scope} 的失败分支存在`) assert.equal(branch[0].includes('p-track'), false, '失败分支不画进度轨') assert.equal(branch[0].includes('progressText'), false, '失败分支不说「已完成 X / 总 Y」') assert.match(branch[0], /badge danger/, '有失败数时给红色失败徽标') assert.match(branch[0], /v-else/, '无失败数时画「—」') } }) 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 ⇒ 后端返回全部状态') 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(readSource(TASK_TABLE), /暂无符合条件的任务/, '任务空态') assert.match(readSource(VARIANT_TABLE), /暂无变体采集任务/, '变体空态:四态口径下不再限定「在跑」') assert.match(page, /showAdminFeedback\([^\n]*, 'error'\)/, '接口失败提示走统一出口') assert.match(page, /resetFilter/, '筛选重置接线') assert.match(page, /@size="changeTaskSize"/, '分页每页条数切换') assert.match(page, /@size="changeVariantSize"/, '变体分页每页条数切换') }) test('task_center_has_no_shop_panel_anymore', () => { const page = readSource(PAGE) for (const gone of ['在跑店铺看板', 'selectShop', 'shopFilterOptions', 'fetchTaskCenterShops', 'moduleSummary']) { assert.equal(page.includes(gone), false, `店铺看板已整条拆除,页面里不该再出现 ${gone}`) } assert.equal(readSource(API).includes('/api/admin/task-center/shops'), false, '接口层不留 /shops') assert.match(page, /fetchTaskCenterShopOptions/, '店铺筛选候选仍要取数') assert.match(page, /v-for="shop in shopOptions"/, '下拉候选就是店铺库本身,不再并入面板出现的店铺') assert.match(readSource(TASK_TABLE), /最近上报/, '任务表仍带最近上报') 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 table = readSource(TASK_TABLE) const style = page.slice(page.indexOf('