feat(huya): 协作台账状态机新口径(跳步/已确认绑定/兑换失败)+ 账号全生命周期快照(迁移 0059)
This commit is contained in:
@@ -32,11 +32,14 @@ import type {
|
||||
HuyaTaskItem,
|
||||
HuyaBrowserExchangeKit,
|
||||
HuyaCollabAuditItem,
|
||||
HuyaCollabActivityBatchResult,
|
||||
HuyaCollabActivityItem,
|
||||
HuyaCollabCkPreview,
|
||||
HuyaCollabCkRequest,
|
||||
HuyaCollabCkStatusRequest,
|
||||
HuyaCollabImagesRequest,
|
||||
HuyaCollabImportResult,
|
||||
HuyaCollabMetric,
|
||||
HuyaCollabOrder,
|
||||
HuyaCollabOrderCreate,
|
||||
HuyaCollabOrderList,
|
||||
@@ -47,6 +50,8 @@ import type {
|
||||
HuyaCollabShopCreate,
|
||||
HuyaCollabShopUpdate,
|
||||
HuyaCollabStatusRequest,
|
||||
HuyaCollabStatusBatchRequest,
|
||||
HuyaCollabStatusBatchResult,
|
||||
HuyaCollabSummary,
|
||||
HuyaCollabVerifyResult,
|
||||
HuyaExchangeTargetKey,
|
||||
@@ -252,6 +257,26 @@ export const huyaApi = {
|
||||
/** 操作时间线(直接读 audit_logs) */
|
||||
collabOrderTimeline: (id: number) =>
|
||||
api.get<HuyaCollabAuditItem[], HuyaCollabAuditItem[]>(`/huya/external-orders/${id}/timeline`),
|
||||
/** 勾选多行一次改业务状态(单个也走这里;回退要带 rollback) */
|
||||
batchUpdateCollabOrderStatus: (data: HuyaCollabStatusBatchRequest) =>
|
||||
api.post<HuyaCollabStatusBatchResult, HuyaCollabStatusBatchResult>(
|
||||
'/huya/external-orders/status/batch',
|
||||
data,
|
||||
),
|
||||
/** 查这一单的积分 + 兑换记录(写一条生命周期快照,已上脚本的单会按结果自动改状态) */
|
||||
queryCollabOrderActivity: (id: number) =>
|
||||
api.post<HuyaCollabActivityItem, HuyaCollabActivityItem>(
|
||||
`/huya/external-orders/${id}/activity/query`,
|
||||
),
|
||||
/** 勾选多行查询积分 + 兑换记录(串行带间隔) */
|
||||
batchQueryCollabOrderActivity: (ids: number[]) =>
|
||||
api.post<HuyaCollabActivityBatchResult, HuyaCollabActivityBatchResult>(
|
||||
'/huya/external-orders/activity/query',
|
||||
{ ids },
|
||||
),
|
||||
/** 这一单的「账号全生命周期」时间线(每次查询的快照,新→旧) */
|
||||
collabOrderMetrics: (id: number) =>
|
||||
api.get<HuyaCollabMetric[], HuyaCollabMetric[]>(`/huya/external-orders/${id}/metrics`),
|
||||
/** 删除一行(只给运营:huya:collab:manage) */
|
||||
deleteCollabOrder: (id: number) =>
|
||||
api.delete<{ success: boolean; order_no: string }, { success: boolean; order_no: string }>(
|
||||
|
||||
@@ -1199,7 +1199,15 @@ export interface AccountExchangeRecords {
|
||||
// ---- 虎牙外部 CK 协作台账(/api/huya/external-orders,见 docs/设计-虎牙外部CK协作台账.md)----
|
||||
|
||||
/** 业务状态:一单卡在哪一步(void 是旁路) */
|
||||
export type HuyaCollabStatus = 'pending' | 'bound' | 'recharged' | 'scripted' | 'done' | 'void';
|
||||
export type HuyaCollabStatus =
|
||||
| 'pending'
|
||||
| 'bound'
|
||||
| 'recharged'
|
||||
| 'scripted'
|
||||
| 'done'
|
||||
/** 旁路终态:抢购后查兑换记录没查到这一单的礼包(人工确认后可作废或回退重试) */
|
||||
| 'failed'
|
||||
| 'void';
|
||||
|
||||
/** 凭据状态:CK 本身还有没有效 */
|
||||
export type HuyaCollabCkStatus = 'unverified' | 'valid' | 'invalid' | 'disabled';
|
||||
@@ -1264,6 +1272,12 @@ export interface HuyaCollabOrder {
|
||||
* 只有真的 ≥2 单才有值,否则是 null。
|
||||
*/
|
||||
buyer_cluster: HuyaCollabBuyerCluster | null;
|
||||
/** 最近一次「查积分 + 兑换记录」的快照(完整时间线走 GET /{id}/metrics) */
|
||||
last_score: number | null;
|
||||
last_metric_at: string | null;
|
||||
last_verdict: HuyaCollabVerdict | '';
|
||||
last_verdict_label: string;
|
||||
last_metric_message: string;
|
||||
}
|
||||
|
||||
/** 「同一买家的其它单」里的一条 */
|
||||
@@ -1288,6 +1302,98 @@ export interface HuyaCollabBuyerCluster {
|
||||
others: HuyaCollabBuyerOrder[];
|
||||
}
|
||||
|
||||
/** 系统与接口的判定结论(人工不写,只读) */
|
||||
export type HuyaCollabVerdict = 'success' | 'failed' | 'unknown';
|
||||
|
||||
/** 「账号全生命周期」里匹配到的兑换记录 */
|
||||
export interface HuyaCollabMetricMatched {
|
||||
prize_name: string;
|
||||
score: number | null;
|
||||
status_label: string;
|
||||
order_id: string;
|
||||
exchange_time: number | null;
|
||||
}
|
||||
|
||||
/** 一次「查积分 + 兑换记录」的快照(只追加,不更新) */
|
||||
export interface HuyaCollabMetric {
|
||||
id: number;
|
||||
order_id: number;
|
||||
order_no: string;
|
||||
uid: string;
|
||||
sid: number | null;
|
||||
score: number | null;
|
||||
gained_score: number | null;
|
||||
used_score: number | null;
|
||||
records_total: number;
|
||||
records_matched: number;
|
||||
verdict: HuyaCollabVerdict;
|
||||
verdict_label: string;
|
||||
message: string;
|
||||
/** manual(人工点)/ batch(勾选批量) */
|
||||
source: string;
|
||||
matched_preview: HuyaCollabMetricMatched[];
|
||||
created_by: number | null;
|
||||
created_by_name: string;
|
||||
created_at: string | null;
|
||||
}
|
||||
|
||||
/** 单个订单查询积分/兑换记录的结果 */
|
||||
export interface HuyaCollabActivityItem {
|
||||
ok: boolean;
|
||||
order_id: number;
|
||||
order_no: string;
|
||||
verdict: HuyaCollabVerdict;
|
||||
verdict_label: string;
|
||||
score: number | null;
|
||||
gained_score: number | null;
|
||||
used_score: number | null;
|
||||
records_total: number;
|
||||
records_matched: number;
|
||||
message: string;
|
||||
/** 查询后自动改成的状态(空 = 没改:只有「已上脚本」的单会自动改) */
|
||||
auto_status: HuyaCollabStatus | '';
|
||||
auto_status_label: string;
|
||||
status: HuyaCollabStatus;
|
||||
status_label: string;
|
||||
}
|
||||
|
||||
/** 批量查询汇总 */
|
||||
export interface HuyaCollabActivityBatchResult {
|
||||
total: number;
|
||||
success: number;
|
||||
failed: number;
|
||||
unknown: number;
|
||||
auto_changed: number;
|
||||
results: HuyaCollabActivityItem[];
|
||||
}
|
||||
|
||||
/** 批量改状态请求(单个也走这里) */
|
||||
export interface HuyaCollabStatusBatchRequest {
|
||||
ids: number[];
|
||||
status: HuyaCollabStatus;
|
||||
reason?: string;
|
||||
/** 目标不是「向前」时必须显式 true */
|
||||
rollback?: boolean;
|
||||
}
|
||||
|
||||
/** 批量改状态里的一行结论 */
|
||||
export interface HuyaCollabStatusBatchItem {
|
||||
id: number;
|
||||
order_no: string;
|
||||
ok: boolean;
|
||||
message: string;
|
||||
}
|
||||
|
||||
/** 批量改状态汇总 */
|
||||
export interface HuyaCollabStatusBatchResult {
|
||||
total: number;
|
||||
updated: number;
|
||||
failed: number;
|
||||
target: HuyaCollabStatus;
|
||||
target_label: string;
|
||||
results: HuyaCollabStatusBatchItem[];
|
||||
}
|
||||
|
||||
export interface HuyaCollabOrderList {
|
||||
items: HuyaCollabOrder[];
|
||||
total: number;
|
||||
|
||||
Reference in New Issue
Block a user