feat(huya): 外部 CK 协作台账(S1–S6)+ 图片上传能力
协作台账:新表 huya_external_orders 替代 Excel 多人协同表(设计见
docs/设计-虎牙外部CK协作台账.md),一条 CK 一行,所有人共享、改动留痕。
- 前端 pages/HuyaCollabPage.tsx + 菜单「虎牙 → 外部单协作」/huya/collab:
内联编辑(带乐观锁 version)、图片缩略图、详情抽屉(字段表单 + 两个图片槽位 +
操作时间线)、粘贴导入弹窗(带 TSV 预览)、批量/单条验证 CK、页头统计条、筛选
- 两套状态机:业务 pending→bound→recharged→scripted→done(旁路 void)、
凭据 unverified/valid/invalid/disabled;唯一写入口在 services/huya_collab_service.py,
字段级审计 + 整数 version 乐观锁(不用 updated_at:DATETIME 只到秒)
- CK 只读探针 check_user_bind_game_account(真机判据:响应非 None 且 status == 200),
成功即覆盖写绑定快照 bind_game_account/bind_game_role/bind_game_channel(迁移 0056),
失败只改凭据状态、不动业务状态;人工只能停用/恢复(POST /{id}/ck/status)
- 贴/换/重建 CK、TSV 批量导入(SAVEPOINT 单行隔离,部分失败不整体失败)、
权限 huya:collab:view/edit/manage(删除只给运营)
- 孤儿图清理脚本 scripts/cleanup_orphan_file_assets.py(默认 --dry-run)
图片上传(协作台账截图用):OSS/本地双后端 + 缩略图变体 + /api/files 代理回读,
权限 file:upload / file:view。
验证:pytest 880 passed / 6 skipped;ruff format 全绿、ruff check 仅剩既有告警;
前端 tsc -b / eslint / vite build 通过;接口端到端冒烟 29 项全绿(TestClient,探针用假客户端);
探针真机冒烟 3 例(有效 CK=True、别人 uid=False、裸 cookie=False)。
This commit is contained in:
@@ -31,6 +31,20 @@ import type {
|
||||
HuyaTaskBatchResult,
|
||||
HuyaTaskItem,
|
||||
HuyaBrowserExchangeKit,
|
||||
HuyaCollabAuditItem,
|
||||
HuyaCollabCkRequest,
|
||||
HuyaCollabCkStatusRequest,
|
||||
HuyaCollabImagesRequest,
|
||||
HuyaCollabImportResult,
|
||||
HuyaCollabOrder,
|
||||
HuyaCollabOrderCreate,
|
||||
HuyaCollabOrderList,
|
||||
HuyaCollabOrderQuery,
|
||||
HuyaCollabOrderUpdate,
|
||||
HuyaCollabOwner,
|
||||
HuyaCollabStatusRequest,
|
||||
HuyaCollabSummary,
|
||||
HuyaCollabVerifyResult,
|
||||
HuyaExchangeTargetKey,
|
||||
HuyaExternalCkImportRequest,
|
||||
HuyaExternalCkImportResult,
|
||||
@@ -172,4 +186,53 @@ export const huyaApi = {
|
||||
/** 本机浏览器兑换: 获取目标页与登录脚本, 由用户在自己浏览器的控制台执行 (target 不传 = elite) */
|
||||
createBrowserExchange: (accountId: number, target?: HuyaExchangeTargetKey) =>
|
||||
api.post<HuyaBrowserExchangeKit, HuyaBrowserExchangeKit>(`/huya/accounts/${accountId}/browser-exchange`, { target }),
|
||||
|
||||
// ---- 虎牙外部 CK 协作台账(共享表,替代 Excel;业务规则见 docs/设计-虎牙外部CK协作台账.md)----
|
||||
/** 列表:共享视图,默认不按人过滤(负责人只是筛选维度) */
|
||||
listCollabOrders: (params: HuyaCollabOrderQuery = {}) =>
|
||||
api.get<HuyaCollabOrderList, HuyaCollabOrderList>('/huya/external-orders', { params }),
|
||||
/** 页头统计条:各业务状态计数 + CK 失效数 */
|
||||
collabOrdersSummary: () =>
|
||||
api.get<HuyaCollabSummary, HuyaCollabSummary>('/huya/external-orders/summary'),
|
||||
/** 负责人候选(全部活跃用户) */
|
||||
collabOrderOwners: () =>
|
||||
api.get<HuyaCollabOwner[], HuyaCollabOwner[]>('/huya/external-orders/owners'),
|
||||
/** 已用过的店铺(筛选下拉) */
|
||||
collabOrderShops: () => api.get<string[], string[]>('/huya/external-orders/shops'),
|
||||
getCollabOrder: (id: number) =>
|
||||
api.get<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}`),
|
||||
createCollabOrder: (data: HuyaCollabOrderCreate) =>
|
||||
api.post<HuyaCollabOrder, HuyaCollabOrder>('/huya/external-orders', data),
|
||||
/** 编辑:必须带 expected_version(别人先改过会 409) */
|
||||
updateCollabOrder: (id: number, data: HuyaCollabOrderUpdate) =>
|
||||
api.put<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}`, data),
|
||||
/** 推进/回退业务状态(回退必须显式 rollback) */
|
||||
updateCollabOrderStatus: (id: number, data: HuyaCollabStatusRequest) =>
|
||||
api.post<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}/status`, data),
|
||||
/** 贴/换 CK(action=paste)或从 raw_cookie 重建(action=rebuild) */
|
||||
updateCollabOrderCk: (id: number, data: HuyaCollabCkRequest) =>
|
||||
api.post<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}/ck`, data),
|
||||
/** 人工停用 / 恢复这份 CK(valid / invalid 只能由探针给) */
|
||||
updateCollabOrderCkStatus: (id: number, data: HuyaCollabCkStatusRequest) =>
|
||||
api.post<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}/ck/status`, data),
|
||||
/** 整槽替换图片(提交 /api/files/upload 返回的 object_key 数组) */
|
||||
updateCollabOrderImages: (id: number, data: HuyaCollabImagesRequest) =>
|
||||
api.post<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}/images`, data),
|
||||
/** 验证 CK(只读探针):写 ck_status,并刷新绑定账号/角色快照 */
|
||||
verifyCollabOrder: (id: number) =>
|
||||
api.post<HuyaCollabOrder, HuyaCollabOrder>(`/huya/external-orders/${id}/verify`),
|
||||
/** 批量验证 CK:人工触发、串行带间隔,一次最多 50 条 */
|
||||
verifyCollabOrders: (ids: number[]) =>
|
||||
api.post<HuyaCollabVerifyResult, HuyaCollabVerifyResult>('/huya/external-orders/ck/verify', { ids }),
|
||||
/** Excel/文本粘贴批量导入(TSV,首行可为表头) */
|
||||
importCollabOrders: (text: string) =>
|
||||
api.post<HuyaCollabImportResult, HuyaCollabImportResult>('/huya/external-orders/import', { text }),
|
||||
/** 操作时间线(直接读 audit_logs) */
|
||||
collabOrderTimeline: (id: number) =>
|
||||
api.get<HuyaCollabAuditItem[], HuyaCollabAuditItem[]>(`/huya/external-orders/${id}/timeline`),
|
||||
/** 删除一行(只给运营:huya:collab:manage) */
|
||||
deleteCollabOrder: (id: number) =>
|
||||
api.delete<{ success: boolean; order_no: string }, { success: boolean; order_no: string }>(
|
||||
`/huya/external-orders/${id}`,
|
||||
),
|
||||
};
|
||||
|
||||
Reference in New Issue
Block a user