// api/record.ts Day 53(D24):下行批次记录接口(契约先行,Day60 record API 前由 // msw mock 承载——FE 全程不被后端阻塞;后端实现须按本契约回填 api/v1/record.go)。 import { get, post } from './request' /** 下行批次行(message_task 聚合口径;进度四态+发送中=mobile_count)。 * intercepted_count 为 message_detail status=5 聚合计数(后端 Day60 实现)。 */ export interface DownRecord { id: number task_no: string send_type: number // 1群发 2个性 3定时 4文件 sign: string content: string mobile_count: number success_count: number fail_count: number unknown_count: number intercepted_count: number sending_count: number // 待发+提交中(0待发1提交) fee_total: number audit_status: number // 0待 1过 2拒 3免审 4超时 status: number // 0待发 1进行中 2完成 3失败 4已取消 created_at: string finished_at: string | null } /** 下行批次列表查询参数(分页 100/页为验收口径)。 */ export interface DownQuery { page: number page_size: number task_no?: string send_type?: number status?: number start_time?: string end_time?: string } export interface DownPage { list: DownRecord[] total: number } /** 下行批次分页列表。 */ export function fetchDownRecords(q: DownQuery): Promise { return get('/record/down', { ...q }) } /** 拦截号码下载(CSV:mobile,error_code,reason;无拦截时后端返回 404 业务码)。 * 原生 fetch 直取(不走 axios XHR——jsdom XHR+blob 与 msw 拦截层不兼容, * 同 fe2 multipart 坑;真实浏览器两条路径等价)。失败时抛 BizError 同构 Error。 */ export async function downloadIntercepted(taskId: number): Promise { const base = import.meta.env.VITE_API_BASE_URL as string const resp = await fetch(`${base}/record/down/${taskId}/intercepted?format=csv`, { headers: { Accept: 'text/csv' }, }) const ct = resp.headers.get('content-type') ?? '' if (!resp.ok || ct.includes('application/json')) { // 404 业务码:{code,msg}(无拦截/任务不存在) const body = (await resp.json().catch(() => null)) as { code?: string; msg?: string } | null throw new Error(body?.msg ?? `下载失败 HTTP:${resp.status}`) } return resp.blob() } /** 进度占比工具已拆至 record-progress.ts(无 request 依赖,mock 安全引用);此处 re-export 保持既有 import 兼容。 */ export { progressOf } from './record-progress' /** 拦截明细行(下载预览/测试断言用)。 */ export interface InterceptedRow { mobile: string error_code: string reason: string } // ---- D25 下行明细(号码级,5 天热数据;契约先行,mock 承载,Day60 后端回填) ---- /** 号码级明细行(message_detail 口径,与 D22 SendDetail 同构+task_no 冗余便于全局检索)。 */ export interface DownDetail { id: number task_id: number task_no: string mobile: string province: string carrier: string // 移动/联通/电信 status: number // 0待发 1已提交 2成功 3失败 4未知 5拦截 error_code: string // ISC:xxx/通道原始码(空=成功) ext_code: string call_data: string fee: number created_at: string } /** 明细查询参数(5 天热数据窗口由后端保证;分页 100/页与批次口径一致)。 */ export interface DownDetailQuery { page: number page_size: number mobile?: string // 模糊(尾号匹配) task_no?: string // 精确(批次钻入预填) status?: number error_code?: string // 精确(ISC 码筛选联调) start_time?: string end_time?: string } export interface DownDetailPage { list: DownDetail[] total: number } /** 号码级明细分页(D25)。 */ export function fetchDownDetails(q: DownDetailQuery): Promise { return get('/record/down/details', { ...q }) } /** 通道侧交互记录(CMPP 钻入:channel_log 按 detail 检索)。 */ export interface ChannelLogEntry { at: string kind: string // connect/submit/deliver/reclaim… level: number // 0 info/1 warn/2 error msg_id: string detail: string latency_ms: number } /** CMPP/通道日志钻入(D25;拦截号未投通道→空列表)。 */ export function fetchDetailChannelLogs(detailId: number): Promise<{ total: number; list: ChannelLogEntry[] }> { return get<{ total: number; list: ChannelLogEntry[] }>(`/record/down/details/${detailId}/channel-logs`) } // ---- D26 历史记录(>5 天全量,ClickHouse 冷数据;契约先行,Day61 后端回填) ---- /** 历史明细行(冷数据口径:与 DownDetail 同构+终态锁定,无进行中态)。 */ export interface HistoryRecord { id: number task_id: number task_no: string mobile: string province: string carrier: string status: number // 冷数据仅终态:2成功/3失败/4未知/5拦截 error_code: string fee: number created_at: string } /** 历史查询参数(时间范围为冷数据主索引;后端 ClickHouse 分区裁剪,mock 同语义)。 */ export interface HistoryQuery { page: number page_size: number mobile?: string task_no?: string status?: number start_time?: string end_time?: string } export interface HistoryPage { list: HistoryRecord[] total: number } /** 全量历史明细分页(D26;查询 <3s 验收)。 */ export function fetchHistoryRecords(q: HistoryQuery): Promise { return get('/record/history', { ...q }) } /** 异步导出任务(D26;状态机 pending→ready/failed,完成后下载中心取件)。 */ export interface ExportTask { id: number scope: string // 导出范围描述(筛选条件快照) status: 'pending' | 'ready' | 'failed' total: number // 匹配行数(ready 时) created_at: string expires_at: string // 下载链接有效期(默认 24h) } /** 提交异步导出(当前筛选条件快照;返回任务号,轮询下载中心)。 */ export function createHistoryExport(q: Omit): Promise<{ id: number }> { return post<{ id: number }>('/record/history/export', { ...q }) } /** 下载中心:导出任务列表(D26;Day62 MinIO 落地后切真实下载)。 */ export function fetchHistoryExports(): Promise<{ list: ExportTask[] }> { return get<{ list: ExportTask[] }>('/record/history/exports') } // ---- D27 上行记录(message_uplink 口径;契约先行,mock 承载,Day60 后端回填) ---- /** 上行记录行(message_uplink:Deliver MO→码号分配→落库;Day49 后端已交付)。 */ export interface UplinkRecord { id: number dest_code: string // 接入码号(归属分配依据:精确>前缀>admin 兜底) src_mobile: string // 上行来源手机号 content: string account_id: number // 归属账号 account_name: string // 冗余展示(mock 口径;真实联调由后端 join) channel_id: number recv_at: string match_task_id: number // 0=未匹配(15 天窗口外/无下行);>0=窗口内最近下行明细 } /** 上行查询参数(码号/手机号为主筛选;matched 三态筛选)。 */ export interface UplinkQuery { page: number page_size: number dest_code?: string // 精确/前缀(码号两级匹配同口径) src_mobile?: string // 模糊(尾号匹配) matched?: number // 0=未匹配 1=已匹配(缺省=全部) start_time?: string end_time?: string } export interface UplinkPage { list: UplinkRecord[] total: number } /** 上行记录分页(D27;15 天匹配窗口由后端保证,前端提示口径)。 */ export function fetchUplinkRecords(q: UplinkQuery): Promise { return get('/record/uplink', { ...q }) } /** 提交上行导出(权限:uplink:export;无权限后端 403,按钮前端隐藏为第一道闸)。 * 复用 D26 异步导出任务模型(下载中心取件),scope 快照含上行筛选条件。 */ export function createUplinkExport(q: Omit): Promise<{ id: number }> { return post<{ id: number }>('/record/uplink/export', { ...q }) } // ---- D28 回执重推工具+手动配对(message_report 30 天窗口;契约先行,mock 承载,Day58 后端 repush 域回填) ---- /** 回执行(message_report 口径;Day56 消费者已落库,30 天重推窗口数据源)。 */ export interface RepushReport { id: number detail_id: number task_no: string // 冗余便于检索(后端 join message_detail) mobile: string account_id: number status: 'SUCCESS' | 'FAILURE' | 'UNKNOWN' // Day55 三态 raw_code: string // 通道原始码(DELIVRD/GB:0001…) error_code: string report_at: string push_status: number // 0未推 1已推 2推送失败(重推候选) pushed_at: string | null } /** 回执查询参数(重推工具筛选)。 */ export interface RepushQuery { page: number page_size: number account_id?: number mobile?: string // 尾号模糊 task_no?: string // 精确 status?: 'SUCCESS' | 'FAILURE' | 'UNKNOWN' start_time?: string end_time?: string } /** 回执分页(D28)。 */ export function fetchRepushReports(q: RepushQuery): Promise<{ list: RepushReport[]; total: number }> { return get<{ list: RepushReport[]; total: number }>('/record/repush', { ...q }) } /** 重推请求(时间窗必填;账号/手机号收窄;30 天窗口后端强校验=第二道闸)。 */ export interface RepushRequest { account_id?: number mobiles?: string[] start_time: string end_time: string } /** 重推受理结果(异步任务:count=窗口内匹配回执数,推送反馈同批挂账 Day60)。 */ export interface RepushResult { task_id: number count: number } /** 提交回执重推(30 天窗口校验:超窗后端 ISC:400 业务错)。 */ export function createRepush(req: RepushRequest): Promise { return post('/record/repush', req) } /** 手动配对四方式(实施计划 5.5:3h 外无状态明细手工指定终态)。 */ export type PairMode = 'msg_mobile' | 'detail' | 'task_time' | 'time_mobile' /** 配对请求(按 mode 取对应字段;target_status 指定终态,资金口径后端同 Day57)。 */ export interface PairRequest { mode: PairMode msg_id?: string // msg_mobile:通道 msg_id+手机号精确 mobile?: string // msg_mobile/time_mobile:手机号 detail_id?: number // detail:明细雪花 ID 精确 task_no?: string // task_time:任务号 start_time?: string // task_time/time_mobile:时间窗 end_time?: string target_status: 2 | 3 | 4 // 成功(不退费)/失败(退款)/未知(冻结释放) } /** 配对结果(matched=圈中挂起明细;updated=回写终态;skipped=已终态跳过)。 */ export interface PairResult { matched: number updated: number skipped: number } /** 提交手动配对(结果回写挂起列表:updated 行离场)。 */ export function createManualPair(req: PairRequest): Promise { return post('/record/repush/pair', req) } /** 挂起明细行(手动配对数据源:3h 外仍 status=1 的明细)。 */ export interface PendingDetail { detail_id: number task_no: string msg_id: string // 通道 msg_id(msg_mobile 配对键) mobile: string content: string sent_at: string age_hours: number // 挂起时长(>3 为可配对口径) } /** 挂起明细分页(配对页列表;仅 3h 外)。 */ export function fetchPendingDetails( q: { page: number; page_size: number; mobile?: string; task_no?: string }, ): Promise<{ list: PendingDetail[]; total: number }> { return get<{ list: PendingDetail[]; total: number }>('/record/repush/pending', { ...q }) }