feat(huya): 协作台账状态机新口径(跳步/已确认绑定/兑换失败)+ 账号全生命周期快照(迁移 0059)

This commit is contained in:
yml2213
2026-10-16 22:00:34 +08:00
parent aac264b639
commit e8abd60734
11 changed files with 1897 additions and 84 deletions
+25
View File
@@ -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 }>(
+107 -1
View File
@@ -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;