feat(account): 官方兑换记录补成账号事件(三作用域)+ 一键查询结果落到账号

## 官方兑换记录 → 真正的账号事件

关键发现:斗鱼官方兑换记录**带真实兑换时间**(`time` 字段),所以可以直接
补成正常的历史事件,时间线因此变完整(这就是「账号全生命周期」该有的样子),
列表的兑换聚合也随之准确 —— 上线前的兑换不再是一片空白。

- **三个作用域都拉**:精英宝典 / 电竞手册(共用 `exchange_records`,只有 manual_id
  不同)/ 和平小店(`xpd_embed_query` → `xpd_purchase_records`)
- 幂等键含作用域:`official_exchange:{scope}:{account}:{commodity}:{time}`
- `detail.scope` 标作用域;`source=official_sync` 与"当场记的"分得开
- 任一作用域失败只记进 `errors`,不影响其余(小店未开通会报
  `Livelink登录态校验失败`,属正常)

## 一键查询结果落到账号(不再只留在任务里)

- 新增 `accounts.high_value_owned`(迁移 0048):**已兑换过的高价值套装名**,
  供列表展示。单开一列而不是让列表读 `overview_snapshot` —— 那份 JSON 有 1~2KB,
  15000 个账号各带一份会把响应放大到几十 MB。
- 迁移**可安全重跑**(启动时会自动跑):加列前查 `information_schema`。
  ⚠️ 回填里**不要** `op.get_bind().commit()` —— MySQL 的 DDL 自动提交而 commit
  会打乱版本记账,表现为"列加上了、版本号没更新",下次启动重复 ADD COLUMN
  直接把服务起不来(生产上就是启动即挂)。
- 迁移里从旧快照**回填** `high_value_owned`,已查过的账号不必重查。

## 两个 bug

1. **「最近一次兑换」按插入 id 排**(应为事件时间):补录的历史事件 id 最大、
   时间却最老,会把几个月前的老兑换显示成"最近一次"。改为 `occurred_at DESC, id DESC`。
2. **手写的 `@model_serializer` 没列新字段** → 属性有值、JSON 里没有。
   这是本项目第三次踩 Pydantic 静默丢字段;已补,并把断言改为看 `model_dump()`。

## 列表「兑换记录」口径

只聚合**官方**记录(`source=official_sync`):用户要求列表看官方的权威口径,
我们当场记的那些留给详情页时间线。另加 `GET /accounts/{id}/exchange-records`
供列表点击预览(按需拉取,不进列表响应)。
This commit is contained in:
yml2213
2026-10-04 20:03:42 +08:00
parent 93d972d3fb
commit 62d9053e8a
7 changed files with 436 additions and 18 deletions
+78 -1
View File
@@ -41,6 +41,7 @@ from ..services.account_events_service import (
EVENT_RECHARGE,
EVENT_REMARK_CHANGED,
EVENT_TAG_CHANGED,
OFFICIAL_SYNC_SOURCE,
emit_bulk,
)
from ..services.account_lifecycle import (
@@ -251,12 +252,20 @@ def list_accounts(
.filter(
AccountEvent.account_id.in_(ids),
AccountEvent.event_type == EVENT_EXCHANGE,
# 列表的「兑换记录」只反映**斗鱼官方记录**(口径权威且完整)。
# 我们当场记的那些留给详情页时间线 —— 用户明确要求这么分。
AccountEvent.source == OFFICIAL_SYNC_SOURCE,
)
.group_by(AccountEvent.account_id)
.all()
):
exchange_stats[int(account_id)] = (int(count or 0), last_at, "")
# ② 最近一次兑换的商品名(窗口函数取每个账号的最新一条)
#
# ⚠️ 按 **`occurred_at`** 排,不能按 `id`:
# 一键查询会把斗鱼官方的**历史**兑换记录补成事件,它们的 `id` 是刚插进去的
# (最新),但 `occurred_at` 是几年前的。按 id 排会把一条老兑换显示成"最近一次"
# —— 实测就把 08-30 的兔兔白日梦错报成了 10-01(那是另一次兑换)。
ranked = (
db.query(
AccountEvent.account_id.label("account_id"),
@@ -264,13 +273,17 @@ def list_accounts(
func.row_number()
.over(
partition_by=AccountEvent.account_id,
order_by=AccountEvent.id.desc(),
order_by=(
AccountEvent.occurred_at.desc(),
AccountEvent.id.desc(),
),
)
.label("rn"),
)
.filter(
AccountEvent.account_id.in_(ids),
AccountEvent.event_type == EVENT_EXCHANGE,
AccountEvent.source == OFFICIAL_SYNC_SOURCE,
)
.subquery()
)
@@ -306,6 +319,12 @@ def list_accounts(
last_exchange_at=exchange_stats.get(acc.id, (0, None, ""))[1],
last_exchange_name=exchange_stats.get(acc.id, (0, None, ""))[2],
**bind_payload(acc),
# 一键查询得到的「已兑换过的高价值套装」(不是整份快照 ——
# 列表带不起 1~2KB/账号 的 JSON)。兑换条数不在这里:
# 上面的 exchange_count 已经是**官方事件**聚合的结果。
high_value_owned=acc.high_value_owned or [],
# 「有没有查过」靠它判断 —— 否则"查过但没兑换"和"没查过"都是空,分不开
overview_queried_at=acc.overview_queried_at,
)
# 只有管理员可看完整字段(密码、邮箱等)
if can_include_sensitive:
@@ -909,6 +928,63 @@ def batch_delete_accounts_selection(
return {"message": f"已删除 {deleted} 个账号", "deleted": deleted, "success": True}
@router.get("/{account_id}/exchange-records")
def account_exchange_records(
account_id: int,
db: Session = Depends(get_db),
current: User = Depends(get_current_user),
):
"""该账号在三个作用域下的**斗鱼官方兑换记录**(按作用域分组)。
列表的「兑换记录」格点开就用这个 —— **按需拉取**,不把记录塞进列表响应
(15000 个账号各带一堆记录会把响应撑爆)。
数据源是 `source=official_sync` 的事件,也就是一键查询从官方补录的那些,
它们带**真实兑换时间**。
"""
if (
not _visible_accounts_query(db, current)
.filter(Account.id == account_id)
.first()
):
raise HTTPException(status_code=404, detail="账号不存在或无权查看")
rows = (
db.query(AccountEvent)
.filter(
AccountEvent.account_id == account_id,
AccountEvent.event_type == EVENT_EXCHANGE,
AccountEvent.source == OFFICIAL_SYNC_SOURCE,
)
.order_by(AccountEvent.occurred_at.desc(), AccountEvent.id.desc())
.all()
)
grouped: dict[str, list[dict[str, object]]] = {
"elite": [],
"esports": [],
"peace": [],
}
for row in rows:
detail = row.detail or {}
scope = str(detail.get("scope") or "elite")
grouped.setdefault(scope, []).append(
{
"title": row.title or "",
"commodity_id": detail.get("commodity_id") or "",
"commodity_name": detail.get("commodity_name") or "",
"score": detail.get("score"),
"show_name": detail.get("show_name") or "",
"exchange_num": detail.get("exchange_num"),
"occurred_at": row.occurred_at.isoformat() if row.occurred_at else None,
}
)
return {
"groups": grouped,
"total": sum(len(v) for v in grouped.values()),
"queried_at": None,
}
@router.get("/{account_id}/overview")
def account_overview(
account_id: int,
@@ -1003,6 +1079,7 @@ def account_overview(
"points_expire_at": acc.points_expire_at,
"overview_snapshot": acc.overview_snapshot,
"overview_queried_at": acc.overview_queried_at,
"high_value_owned": acc.high_value_owned or [],
"elite_opened": acc.elite_opened,
"elite_expire_time": acc.elite_expire_time,
"esports_points": acc.esports_points,