feat: 协作台账支持归档并精简状态列

This commit is contained in:
yml2213
2026-10-19 13:04:27 +08:00
parent 375567cbd2
commit 781b27e63a
11 changed files with 1040 additions and 66 deletions
+21 -3
View File
@@ -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>(
+42
View File
@@ -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';