feat(看板): 客户端任务管理从设备维度改为店铺维度全局在跑看板

原「在线设备」卡按日志上报窗口统计,把 89 台算成在线,与实际在跑的客户端数差一个
量级,且设备维度并不能回答"哪台机器上有任务卡住"。改为:

- 汇总卡:总店铺 / 在跑店铺 / 进行中任务 / 今日完成 / 疑似卡住
- 新增「在跑店铺看板」:当前所有进行中任务按店铺归组(在跑数、卡住数、业务分布、
  最近上报),点店铺行下筛该店铺任务;不落店铺的任务归「不挂店铺」桶
- 卡片与面板同源(同一个 aggregateShops),杜绝口径分裂
- 店铺只认两个真来源:上架结果文件 + 逐店落行的结果文件名;
  biz_task_progress_snapshot.current_scope_key 是实例锁不是店铺,已从口径中剔除
- 设备号退为详情附注,花名册 /devices 与在线判定整条链删除
- 上报口径只留一个 10 分钟窗口(进行中且超 10 分钟无上报 = 疑似卡住)

后端 3487 例全绿;新增反射护栏断言设备维度查询与快照当店铺的来源已彻底移除。
This commit is contained in:
2026-10-03 22:41:29 +08:00
parent e4083732a9
commit 06396d537e
18 changed files with 1222 additions and 1037 deletions
@@ -43,11 +43,12 @@ test('task_center_guide_present_for_menu_key', () => {
assert.equal(guide.steps.length, 3)
})
test('task_center_api_has_five_endpoints', () => {
test('task_center_api_has_six_endpoints', () => {
const api = readSource(API)
for (const path of [
'/api/admin/task-center/overview',
'/api/admin/task-center/devices',
'/api/admin/task-center/shops',
'/api/admin/task-center/shop-options',
'/api/admin/task-center/tasks',
'/api/admin/task-center/tasks/detail',
'/api/admin/task-center/variant-tasks',
@@ -56,7 +57,8 @@ test('task_center_api_has_five_endpoints', () => {
}
for (const fn of [
'fetchTaskCenterOverview',
'fetchTaskCenterDevices',
'fetchTaskCenterShops',
'fetchTaskCenterShopOptions',
'fetchTaskCenterTasks',
'fetchTaskCenterTaskDetail',
'fetchTaskCenterVariantTasks',
@@ -66,6 +68,20 @@ test('task_center_api_has_five_endpoints', () => {
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'), '执行中')
@@ -118,7 +134,7 @@ test('task_center_progress_text_and_percent_boundaries', () => {
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: '' },
{ username: ' 张三 ', moduleType: 'COLLECT_DATA', status: 'RUNNING', shop: '林芳旗舰店', startTime: '2026-09-28T10:00', endTime: '' },
2,
20,
)
@@ -127,8 +143,7 @@ test('task_center_query_builder_omits_blanks_and_normalizes_time', () => {
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.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')
@@ -148,7 +163,7 @@ test('task_center_variant_query_builder_keeps_paging', () => {
test('task_center_filter_reset_clears_every_field', () => {
const filter = createTaskFilter()
assert.deepEqual(Object.values(filter), ['', '', '', '', '', '', ''])
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')
@@ -159,7 +174,7 @@ test('task_center_filter_reset_clears_every_field', () => {
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, /暂无变体采集任务/, '变体空态')
assert.match(page, /ElMessage\.error/, '接口失败提示')
assert.match(page, /resetFilter/, '筛选重置接线')
@@ -167,6 +182,19 @@ test('task_center_page_handles_empty_and_error_states', () => {
assert.match(page, /@size-change="changeVariantSize"/, '变体分页每页条数切换')
})
test('task_center_shop_panel_is_the_board_and_drills_down_by_exact_shop', () => {
const page = readSource(PAGE)
assert.match(page, /在跑店铺看板/, '面板标题')
assert.match(page, /最近上报/, '面板与任务表都带最近上报')
assert.match(page, /row\.noShop \? null : selectShop\(row\.shop\)/, '点店铺行下钻,「不挂店铺」桶不可点')
assert.match(page, /不落店铺/, '桶行说明:这类任务本来就没有店铺维度')
assert.match(page, /shopFilterOptions/, '店铺下拉候选 = 店铺库 ∪ 面板出现的店铺')
assert.match(page, /fetchTaskCenterShops/, '面板取数')
assert.match(page, /fetchTaskCenterShopOptions/, '候选取数')
assert.match(page, /moduleSummary/, '业务分布列')
assert.equal(page.includes('device-strip'), false, '设备卡条已删除')
})
test('task_center_page_wires_tabs_filters_and_polling', () => {
const page = readSource(PAGE)
assert.match(page, /客户端任务/, '页签一文案')