feat(huya): 批量查询拆成「查积分」与「查兑换记录」两个按钮

前端工具栏原来一个按钮同时查两件事,拆开后每次只查一半,所以重点在
「没查的那一半不能被当成没查到」:

- 接口加 scope(both / score / records),默认 both 保持原行为;
  只查积分时不产生判定(空串「未判定」,与 unknown「无法判定」分开),
  也**不会**自动改业务状态(连判定都没有,凭什么改)。
- 列表的积分与判定各取「最近一条查到过它的」快照:点「查积分」不再把
  整页判定徽标冲成未判定,点「查兑换记录」也不再清空积分;但新的
  unknown 仍会盖掉旧的 success(抖动结果不许藏)。
- 结果弹窗 / 积分列 Tooltip / 生命周期时间线都按 scope 显示,
  不再把「本次没查」显示成「积分 -」「兑换记录 0 条」。
- 新增 12 例测试(TestCollabActivityScopeSplit),并做了 4 次反向验证
  (去掉判定分支 / 判定跟随最新 / 积分跟随最新 / 删掉响应字段),全部确认变红。

顺带修掉文档漂移:AGENTS.md 的迁移 head 早就过期(main 实际
20261016_0059、dev 20261008_0053),并补上「两侧已分叉成两个 head、
合并 dev 前必须先 alembic merge」这条;设计文档补 §11.9。
This commit is contained in:
yml2213
2026-10-17 23:32:51 +08:00
parent b47dde47e9
commit c441b6c663
10 changed files with 722 additions and 121 deletions
+9 -3
View File
@@ -34,6 +34,7 @@ import type {
HuyaCollabAuditItem,
HuyaCollabActivityBatchResult,
HuyaCollabActivityItem,
HuyaCollabActivityScope,
HuyaCollabCkExportResult,
HuyaCollabCkPreview,
HuyaCollabCkRequest,
@@ -271,11 +272,16 @@ export const huyaApi = {
api.post<HuyaCollabActivityItem, HuyaCollabActivityItem>(
`/huya/external-orders/${id}/activity/query`,
),
/** 勾选多行查询积分 + 兑换记录(串行带间隔) */
batchQueryCollabOrderActivity: (ids: number[]) =>
/**
* 勾选多行查积分 / 查兑换记录(串行带间隔)。
*
* `scope` 决定查哪一半(页面上是两个独立按钮):`score` 只查积分、
* `records` 只查兑换记录、`both` 两个都查(默认,保持旧行为)。
*/
batchQueryCollabOrderActivity: (ids: number[], scope: HuyaCollabActivityScope = 'both') =>
api.post<HuyaCollabActivityBatchResult, HuyaCollabActivityBatchResult>(
'/huya/external-orders/activity/query',
{ ids },
{ ids, scope },
),
/** 这一单的「账号全生命周期」时间线(每次查询的快照,新→旧) */
collabOrderMetrics: (id: number) =>
+31 -6
View File
@@ -1274,12 +1274,20 @@ export interface HuyaCollabOrder {
* 只有真的 ≥2 单才有值,否则是 null。
*/
buyer_cluster: HuyaCollabBuyerCluster | null;
/** 最近一次「查积分 + 兑换记录」的快照(完整时间线走 GET /{id}/metrics) */
/**
* 最近一次「查积分 / 查兑换记录」的快照(完整时间线走 GET /{id}/metrics)。
*
* 拆分两个查询入口后,积分与判定**各自取最近一条查到过它的**:
* 只查积分的那次不产生判定,只查兑换记录的那次不产生积分。
*/
last_score: number | null;
last_metric_at: string | null;
last_metric_message: string;
last_verdict: HuyaCollabVerdict | '';
last_verdict_label: string;
last_metric_message: string;
/** 那条判定是什么时候查出来的(与 `last_metric_at` 可能不是同一次) */
last_verdict_at: string | null;
last_verdict_message: string;
}
/** 「同一买家的其它单」里的一条 */
@@ -1307,6 +1315,13 @@ export interface HuyaCollabBuyerCluster {
/** 系统与接口的判定结论(人工不写,只读) */
export type HuyaCollabVerdict = 'success' | 'failed' | 'unknown';
/**
* 本次查询查了哪一半(两个批量按钮各用一个):
* `both` 两个接口都查、`score` 只查积分、`records` 只查兑换记录。
* 只查积分时没有判定结论,条目的 `verdict` 是**空串**(不是 `unknown`)。
*/
export type HuyaCollabActivityScope = 'both' | 'score' | 'records';
/** 「账号全生命周期」里匹配到的兑换记录 */
export interface HuyaCollabMetricMatched {
prize_name: string;
@@ -1316,7 +1331,7 @@ export interface HuyaCollabMetricMatched {
exchange_time: number | null;
}
/** 一次「查积分 + 兑换记录」的快照(只追加,不更新) */
/** 一次「查积分 / 兑换记录」的快照(只追加,不更新) */
export interface HuyaCollabMetric {
id: number;
order_id: number;
@@ -1328,7 +1343,10 @@ export interface HuyaCollabMetric {
used_score: number | null;
records_total: number;
records_matched: number;
verdict: HuyaCollabVerdict;
/** 这条快照查了哪一半:时间线据此决定显示「积分」还是「本次没查积分」 */
scope: HuyaCollabActivityScope;
/** 只查积分的那条快照是**空串**(本次没查兑换记录,不算「无法判定」) */
verdict: HuyaCollabVerdict | '';
verdict_label: string;
message: string;
/** manual(人工点)/ batch(勾选批量) */
@@ -1344,7 +1362,10 @@ export interface HuyaCollabActivityItem {
ok: boolean;
order_id: number;
order_no: string;
verdict: HuyaCollabVerdict;
/** 本次查的是哪一半(只查积分时 verdict 是空串) */
scope: HuyaCollabActivityScope | '';
scope_label: string;
verdict: HuyaCollabVerdict | '';
verdict_label: string;
score: number | null;
gained_score: number | null;
@@ -1359,13 +1380,17 @@ export interface HuyaCollabActivityItem {
status_label: string;
}
/** 批量查询汇总 */
/** 批量查询汇总(`success + failed + unknown + not_judged = total`) */
export interface HuyaCollabActivityBatchResult {
total: number;
success: number;
failed: number;
unknown: number;
/** 本次没查兑换记录、因此没有判定结论的行数(只查积分时全落这里) */
not_judged: number;
auto_changed: number;
scope: HuyaCollabActivityScope | '';
scope_label: string;
results: HuyaCollabActivityItem[];
}