feat: 协作台账支持归档并精简状态列
This commit is contained in:
@@ -35,6 +35,9 @@ import type {
|
||||
HuyaCollabActivityBatchResult,
|
||||
HuyaCollabActivityItem,
|
||||
HuyaCollabActivityScope,
|
||||
HuyaCollabArchiveRequest,
|
||||
HuyaCollabArchiveResult,
|
||||
HuyaCollabArchiveScope,
|
||||
HuyaCollabCkExportResult,
|
||||
HuyaCollabCkPreview,
|
||||
HuyaCollabCkRequest,
|
||||
@@ -203,9 +206,12 @@ export const huyaApi = {
|
||||
/** 列表:共享视图,默认不按人过滤(负责人只是筛选维度) */
|
||||
listCollabOrders: (params: HuyaCollabOrderQuery = {}) =>
|
||||
api.get<HuyaCollabOrderList, HuyaCollabOrderList>('/huya/external-orders', { params }),
|
||||
/** 页头统计条:各业务状态计数 + CK 失效数 */
|
||||
collabOrdersSummary: () =>
|
||||
api.get<HuyaCollabSummary, HuyaCollabSummary>('/huya/external-orders/summary'),
|
||||
/** 页头统计条:口径与当前归档/作废过滤一致 */
|
||||
collabOrdersSummary: (params: {
|
||||
include_void?: boolean;
|
||||
archive_scope?: HuyaCollabArchiveScope;
|
||||
} = {}) =>
|
||||
api.get<HuyaCollabSummary, HuyaCollabSummary>('/huya/external-orders/summary', { params }),
|
||||
/** 负责人候选(全部活跃用户) */
|
||||
collabOrderOwners: () =>
|
||||
api.get<HuyaCollabOwner[], HuyaCollabOwner[]>('/huya/external-orders/owners'),
|
||||
@@ -278,6 +284,18 @@ export const huyaApi = {
|
||||
'/huya/external-orders/status/batch',
|
||||
data,
|
||||
),
|
||||
/** 归档抢购成功的订单(可带备注;archive_filtered 时按当前筛选批量归档) */
|
||||
archiveCollabOrders: (data: HuyaCollabArchiveRequest) =>
|
||||
api.post<HuyaCollabArchiveResult, HuyaCollabArchiveResult>(
|
||||
'/huya/external-orders/archive',
|
||||
data,
|
||||
),
|
||||
/** 取消归档,恢复回主台账 */
|
||||
unarchiveCollabOrders: (ids: number[]) =>
|
||||
api.post<HuyaCollabArchiveResult, HuyaCollabArchiveResult>(
|
||||
'/huya/external-orders/unarchive',
|
||||
{ ids },
|
||||
),
|
||||
/** 查这一单的积分 + 兑换记录(写一条生命周期快照,已上脚本的单会按结果自动改状态) */
|
||||
queryCollabOrderActivity: (id: number) =>
|
||||
api.post<HuyaCollabActivityItem, HuyaCollabActivityItem>(
|
||||
|
||||
@@ -1214,6 +1214,9 @@ export type HuyaCollabStatus =
|
||||
/** 凭据状态:CK 本身还有没有效 */
|
||||
export type HuyaCollabCkStatus = 'unverified' | 'valid' | 'invalid' | 'disabled';
|
||||
|
||||
/** 归档可见范围:默认活跃;查看归档时只返回已归档行 */
|
||||
export type HuyaCollabArchiveScope = 'active' | 'archived' | 'all';
|
||||
|
||||
export type HuyaCollabImageSlot = 'bind_images' | 'home_images';
|
||||
|
||||
/** 一行 = 一单 = 一个外部虎牙 CK */
|
||||
@@ -1258,6 +1261,12 @@ export interface HuyaCollabOrder {
|
||||
scripted_at: string | null;
|
||||
done_at: string | null;
|
||||
void_reason: string;
|
||||
/** 归档是可见性状态,不改业务状态;归档行只读 */
|
||||
is_archived: boolean;
|
||||
archived_at: string | null;
|
||||
archived_by: number | null;
|
||||
archived_by_name: string;
|
||||
archive_reason: string;
|
||||
points: number | null;
|
||||
elite_opened: boolean | null;
|
||||
snapshot_at: string | null;
|
||||
@@ -1421,6 +1430,36 @@ export interface HuyaCollabStatusBatchResult {
|
||||
results: HuyaCollabStatusBatchItem[];
|
||||
}
|
||||
|
||||
/** 归档请求:ids 为空且 archive_filtered=true 时按筛选范围归档 */
|
||||
export interface HuyaCollabArchiveRequest {
|
||||
ids?: number[];
|
||||
reason?: string;
|
||||
archive_filtered?: boolean;
|
||||
expected_count?: number;
|
||||
shop?: string;
|
||||
owner_id?: number | null;
|
||||
status?: string;
|
||||
ck_status?: string;
|
||||
gift_name?: string;
|
||||
keyword?: string;
|
||||
include_void?: boolean;
|
||||
}
|
||||
|
||||
export interface HuyaCollabArchiveItem {
|
||||
id: number;
|
||||
order_no: string;
|
||||
ok: boolean;
|
||||
message: string;
|
||||
}
|
||||
|
||||
export interface HuyaCollabArchiveResult {
|
||||
total: number;
|
||||
archived: number;
|
||||
unarchived: number;
|
||||
skipped: number;
|
||||
results: HuyaCollabArchiveItem[];
|
||||
}
|
||||
|
||||
/** 导出 CK 里的一行(ck_text 是**明文凭据**,只有导出接口会返回) */
|
||||
export interface HuyaCollabCkExportItem {
|
||||
id: number;
|
||||
@@ -1460,6 +1499,8 @@ export interface HuyaCollabSummary {
|
||||
total: number;
|
||||
by_status: Record<string, number>;
|
||||
ck_invalid: number;
|
||||
/** 全量已归档数量(不受当前 archive_scope 影响,用于入口角标) */
|
||||
archived_total: number;
|
||||
}
|
||||
|
||||
export interface HuyaCollabOwner {
|
||||
@@ -1484,6 +1525,7 @@ export interface HuyaCollabOrderQuery {
|
||||
gift_name?: string;
|
||||
keyword?: string;
|
||||
include_void?: boolean;
|
||||
archive_scope?: HuyaCollabArchiveScope;
|
||||
/** 服务端排序字段(后端白名单) */
|
||||
sort_by?: string;
|
||||
sort_order?: 'asc' | 'desc';
|
||||
|
||||
Reference in New Issue
Block a user