feat(taskcenter): 前端看板页面(页签/筛选/汇总卡/设备条/详情抽屉)

- 路由 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 通过,
浏览器真跑:页签切换、设备卡筛选、详情抽屉均正常,控制台无报错
This commit is contained in:
2026-09-28 23:35:54 +08:00
parent 70a6018175
commit dfb75dd0ff
6 changed files with 1527 additions and 0 deletions
+119
View File
@@ -0,0 +1,119 @@
import { http } from './http'
import { unwrap } from './envelope'
/** 客户端任务管理(后台看板):按账号 × 设备 × 业务统一查看客户端任务,全部只读。 */
/** 查询参数(由页面侧 buildTaskQuery / buildVariantQuery 产出,空白项不下传)。 */
type QueryParams = Record<string, string | number>
export interface TaskCenterOverview {
deviceTotal: number
deviceOnline: number
runningTasks: number
todayFinishedTasks: number
stuckTasks: number
}
export interface TaskCenterDevice {
deviceId: string
deviceName: string | null
lastActiveAt: string | null
online: boolean
runningTasks: number
recentTaskAt: string | null
webDevice: boolean
}
export interface TaskCenterTaskRow {
id: number
taskNo: string
moduleType: string
moduleLabel: string
status: string
userId: number | null
username: string | null
deviceId: string | null
deviceName: string | null
webDevice: boolean
shopName: string | null
shopCount: number
createdAt: string | null
finishedAt: string | null
progressTotal: number
progressSuccess: number
progressFailed: number
currentScope: string | null
message: string | null
stuck: boolean
}
export interface TaskCenterTaskPage {
items: TaskCenterTaskRow[]
total: number
page: number
pageSize: number
}
export interface TaskCenterShopStat {
scopeKey: string
total: number
success: number
failed: number
}
export interface TaskCenterTaskDetail extends TaskCenterTaskRow {
shops: TaskCenterShopStat[]
errorMessage: string | null
}
export interface TaskCenterVariantTaskRow {
taskId: string
uid: string | null
username: string | null
status: number | null
statusLabel: string | null
resMes: string | null
taskData: string | null
createTime: string | null
updateTime: string | null
}
export interface TaskCenterVariantPage {
items: TaskCenterVariantTaskRow[]
total: number
page: number
pageSize: number
}
/** 汇总卡:GET /api/admin/task-center/overview */
export async function fetchTaskCenterOverview(): Promise<TaskCenterOverview> {
const { data } = await http.get('/api/admin/task-center/overview')
return unwrap<TaskCenterOverview>(data)
}
/** 设备花名册(任务设备近 30 天 ∪ 日志设备近 7 天):GET /api/admin/task-center/devices */
export async function fetchTaskCenterDevices(): Promise<TaskCenterDevice[]> {
const { data } = await http.get('/api/admin/task-center/devices')
return unwrap<TaskCenterDevice[]>(data)
}
/** 任务分页列表:GET /api/admin/task-center/tasks */
export async function fetchTaskCenterTasks(params: QueryParams): Promise<TaskCenterTaskPage> {
const { data } = await http.get('/api/admin/task-center/tasks', { params })
return unwrap<TaskCenterTaskPage>(data)
}
/** 任务详情(品牌任务 taskNo 形如 brand-1):GET /api/admin/task-center/tasks/detail
* 任务不存在或不在可见范围时后端返回 success + data:null,这里归一为 null 供页面提示(unwrap 对 null data 会回传信封)。 */
export async function fetchTaskCenterTaskDetail(taskNo: string): Promise<TaskCenterTaskDetail | null> {
const { data } = await http.get('/api/admin/task-center/tasks/detail', { params: { taskNo } })
const envelope = data as { data?: unknown } | null
if (envelope && typeof envelope === 'object' && 'data' in envelope && envelope.data == null) return null
return unwrap<TaskCenterTaskDetail>(data)
}
/** 变体采集(代理麦象 console,取当前可见用户集合):GET /api/admin/task-center/variant-tasks */
export async function fetchTaskCenterVariantTasks(params: QueryParams): Promise<TaskCenterVariantPage> {
const { data } = await http.get('/api/admin/task-center/variant-tasks', { params })
return unwrap<TaskCenterVariantPage>(data)
}