feat(huya): 协作台账店铺字典·新建强校验·同买家多单 + uid 放开(迁移 0057/0058)

- 店铺字典(迁移 0057):大按钮点选 + 「新店」自定义自动登记;重命名可级联、
  停用/备注;列表行内改、详情、筛选条共用同一个 picker
- 新建强校验:订单编号/店铺/CK/礼包名/主页截图必填;贴 CK 即探针预览,
  读不到绑定角色禁止提交;礼包用工作台配置的活动 SID 现拉(浏览器缓存 + 强制刷新)
- 图片:绑定图停用、「绑定斗鱼号」下线(绑定关系改由探针读 bind_game_*),
  主页截图改为新建必填(弹窗内先传 OSS 再随表单落库)
- 同买家多单软识别:按「绑定账号 + 绑定角色」整批一次查询,列表「同买家」列 +
  详情分组,点单号直接切单
- uid 放开唯一性(迁移 0058):同一份 CK 可服务多单,原 409 冲突改为提示 + 审计
- 列表体验:序号列、搜索扩到 11 个字段、CK 状态列截断、新建弹窗放大并去滚动条
- 验证:pytest 932 passed / 6 skipped;接口冒烟 56 项全绿;tsc+eslint+build 通过
This commit is contained in:
yml2213
2026-10-16 21:29:08 +08:00
parent df8c63b829
commit aac264b639
17 changed files with 3237 additions and 155 deletions
+22
View File
@@ -32,6 +32,7 @@ import type {
HuyaTaskItem,
HuyaBrowserExchangeKit,
HuyaCollabAuditItem,
HuyaCollabCkPreview,
HuyaCollabCkRequest,
HuyaCollabCkStatusRequest,
HuyaCollabImagesRequest,
@@ -42,6 +43,9 @@ import type {
HuyaCollabOrderQuery,
HuyaCollabOrderUpdate,
HuyaCollabOwner,
HuyaCollabShop,
HuyaCollabShopCreate,
HuyaCollabShopUpdate,
HuyaCollabStatusRequest,
HuyaCollabSummary,
HuyaCollabVerifyResult,
@@ -199,6 +203,18 @@ export const huyaApi = {
api.get<HuyaCollabOwner[], HuyaCollabOwner[]>('/huya/external-orders/owners'),
/** 已用过的店铺(筛选下拉) */
collabOrderShops: () => api.get<string[], string[]>('/huya/external-orders/shops'),
// ---- 店铺字典(新建协作单时点选;见业务规则 docs/设计-虎牙外部CK协作台账.md)----
/** 全部店铺(含停用的:管理弹窗要看到;新建下拉由页面按 is_active 过滤) */
listCollabShops: () => api.get<HuyaCollabShop[], HuyaCollabShop[]>('/huya/collab-shops'),
createCollabShop: (data: HuyaCollabShopCreate) =>
api.post<HuyaCollabShop, HuyaCollabShop>('/huya/collab-shops', data),
updateCollabShop: (id: number, data: HuyaCollabShopUpdate) =>
api.put<HuyaCollabShop, HuyaCollabShop>(`/huya/collab-shops/${id}`, data),
deleteCollabShop: (id: number) =>
api.delete<{ success: boolean; name: string }, { success: boolean; name: string }>(
`/huya/collab-shops/${id}`,
),
getCollabOrder: (id: number) =>
api.get<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}`),
createCollabOrder: (data: HuyaCollabOrderCreate) =>
@@ -218,6 +234,12 @@ export const huyaApi = {
/** 整槽替换图片(提交 /api/files/upload 返回的 object_key 数组) */
updateCollabOrderImages: (id: number, data: HuyaCollabImagesRequest) =>
api.post<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}/images`, data),
/** 粘贴 CK 后的即时预览(只读):探针 + 拉活动礼包,一行都不写库 */
previewCollabCk: (ck_text: string, with_gifts = true) =>
api.post<HuyaCollabCkPreview, HuyaCollabCkPreview>('/huya/external-orders/ck/preview', {
ck_text,
with_gifts,
}),
/** 验证 CK(只读探针):写 ck_status,并刷新绑定账号/角色快照 */
verifyCollabOrder: (id: number) =>
api.post<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}/verify`),
+90
View File
@@ -1259,6 +1259,33 @@ export interface HuyaCollabOrder {
version: number;
created_at: string | null;
updated_at: string | null;
/**
* 同一买家的其它单(软识别:绑定账号 + 绑定角色相同,只读派生)。
* 只有真的 ≥2 单才有值,否则是 null。
*/
buyer_cluster: HuyaCollabBuyerCluster | null;
}
/** 「同一买家的其它单」里的一条 */
export interface HuyaCollabBuyerOrder {
id: number;
order_no: string;
shop: string;
gift_name: string;
uid: string;
status: HuyaCollabStatus;
status_label: string;
created_at: string | null;
}
/** 同一买家的多单(软识别,不是人工"软绑定"关系) */
export interface HuyaCollabBuyerCluster {
/** 买家指纹的可读文本:绑定账号 · 绑定角色 */
key: string;
/** 识别口径(后端说明字段,界面上标注用) */
method: string;
total: number;
others: HuyaCollabBuyerOrder[];
}
export interface HuyaCollabOrderList {
@@ -1306,7 +1333,11 @@ export interface HuyaCollabOrderCreate {
ck_text?: string;
bind_douyu_account?: string;
gift_name?: string;
/** 主页截图(object_key 数组,第一张作封面);严格模式下必填至少 1 张 */
home_images?: string[];
remark?: string;
/** 严格模式(默认 true):店铺/CK/礼包名/主页截图必填,且 CK 必须读到绑定角色 */
require_verified?: boolean;
}
export interface HuyaCollabOrderUpdate {
@@ -1386,3 +1417,62 @@ export interface FileUploadResult {
content_type: string;
size: number;
}
/** 活动礼包(用一份有效 CK 现拉) */
export interface HuyaCollabGift {
product_id: string;
name: string;
price: number | null;
remain_text: string;
stock: number | null;
score: number | null;
category_name: string;
icon: string;
}
/** 粘贴 CK 后的即时预览:ok 且 has_role 才允许提交新建 */
export interface HuyaCollabCkPreview {
ok: boolean;
message: string;
uid: string;
yyuid: string;
hy_username: string;
ck_status: HuyaCollabCkStatus;
bind_game_account: string;
bind_game_role: string;
bind_game_channel: string;
has_role: boolean;
gifts: HuyaCollabGift[];
gifts_message: string;
/** 这个虎牙号已经挂在哪些单上(允许同一份 CK 服务多单,只是提示) */
uid_used_by: HuyaCollabBuyerOrder[];
}
/** 协作台账的店铺字典项 */
export interface HuyaCollabShop {
id: number;
name: string;
sort_order: number;
/** false = 停用(新建时不再出现在下拉里;历史订单照旧) */
is_active: boolean;
remark: string;
created_by_name: string;
updated_by_name: string;
created_at: string | null;
updated_at: string | null;
}
export interface HuyaCollabShopCreate {
name: string;
sort_order?: number;
remark?: string;
}
export interface HuyaCollabShopUpdate {
name?: string;
sort_order?: number;
is_active?: boolean;
remark?: string;
/** 改名时是否级联更新已有订单里的店铺名(默认 true) */
rename_orders?: boolean;
}