Files
crawler-plugin/admin-frontend-vue/src/api/task-center.ts
T

135 lines
4.6 KiB
TypeScript

import { http } from './http'
import { unwrap } from './envelope'
/** 客户端任务管理(后台看板):按账号 × 店铺 × 业务统一查看客户端任务,全部只读。 */
/** 查询参数(由页面侧 buildTaskQuery / buildVariantQuery 产出,空白项不下传)。 */
type QueryParams = Record<string, string | number>
export interface TaskCenterOverview {
shopTotal: number
shopRunning: number
runningTasks: number
todayFinishedTasks: number
stuckTasks: number
}
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
/** 目标站点国家码(后端从 request_json 归一,多国家用 / 连);该模块不写国家时为 null。 */
country: string | null
createdAt: string | null
finishedAt: string | null
lastReportAt: 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
* companyId = 公司 tab 选中的公司(超管专用,页面只从 companyTab.requestCompanyId 取);
* null/undefined 由这里自己丢掉——不发给后端 = 按会话口径看全部,不是「筛成空」。
*/
export async function fetchTaskCenterOverview(companyId?: number | null): Promise<TaskCenterOverview> {
const query: QueryParams = {}
if (companyId != null) query.company_id = companyId
const { data } = await http.get('/api/admin/task-center/overview', { params: query })
return unwrap<TaskCenterOverview>(data)
}
/**
* 店铺筛选候选(店铺库内的店铺名,精确匹配):GET /api/admin/task-center/shop-options
* 下拉候选必须跟列表同宽:少了这一支,切 tab 后能选到别家的店铺名(选了又筛不出东西)。
*/
export async function fetchTaskCenterShopOptions(companyId?: number | null): Promise<string[]> {
const query: QueryParams = {}
if (companyId != null) query.company_id = companyId
const { data } = await http.get('/api/admin/task-center/shop-options', { params: query })
return unwrap<string[]>(data)
}
/**
* 任务分页列表:GET /api/admin/task-center/tasks
* params 由 buildTaskQuery 构造(含 company_id,见 task-center-model.ts)。
*/
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,
companyId?: number | null,
): Promise<TaskCenterTaskDetail | null> {
const query: QueryParams = { taskNo }
if (companyId != null) query.company_id = companyId
const { data } = await http.get('/api/admin/task-center/tasks/detail', { params: query })
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
* params 由 buildVariantQuery 构造(含 company_id,见 task-center-model.ts)。
*/
export async function fetchTaskCenterVariantTasks(params: QueryParams): Promise<TaskCenterVariantPage> {
const { data } = await http.get('/api/admin/task-center/variant-tasks', { params })
return unwrap<TaskCenterVariantPage>(data)
}