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
@@ -0,0 +1,113 @@
"""账号列表要显示一键查询的结果:加一个**极小**的字段
账号列表的「兑换记录」列一直来自我们自己的 `account_events`,
而事件是**上线后才开始记**的 —— 更早的兑换在列表里就是空的,
看起来像"从没兑换过"(用户报的正是这个:账号 6966677706 明明有官方兑换记录,
列表却显示未兑换)。
一键查询能查到官方兑换记录,但那份 JSON 有 1~2KB。
账号列表是全站最热的接口之一,15000 个账号各带一份会把响应放大到几十 MB,
所以**不能**直接把 `overview_snapshot` 返回给列表。
这里加一个只含列表所需两项的小字段:
`{"owned": ["兔兔白日梦"], "exchanges": 2}`
"""
from __future__ import annotations
import json
import sqlalchemy as sa
from alembic import op
revision: str = "20261004_0048"
down_revision: str | None = "20261004_0047"
branch_labels: str | None = None
depends_on: str | None = None
def _backfill_from_snapshot() -> None:
"""从已有的 `overview_snapshot` 回填。
必须回填:加这个字段之前已经查过的账号,快照里**早就有**这两项信息,
不回填的话列表会对它们显示「未查询」—— 明明查过,界面却在骗人。
"""
conn = op.get_bind()
rows = conn.execute(
sa.text(
"SELECT id, overview_snapshot FROM accounts "
"WHERE overview_snapshot IS NOT NULL"
)
).fetchall()
updated = 0
for account_id, snapshot in rows:
data = snapshot
if isinstance(data, (str, bytes)):
try:
data = json.loads(data)
except ValueError:
continue
if not isinstance(data, dict):
continue
goods = data.get("high_value_goods")
owned = [
g.get("name")
for g in (goods if isinstance(goods, list) else [])
if isinstance(g, dict) and g.get("owned") and g.get("name")
]
# 只留「已兑换过哪些高价值套装」。
# 兑换条数不再存这里 —— 列表改成从**官方事件**聚合(口径更准,
# 而且不用维护两套计数)。
owned_value = owned
conn.execute(
sa.text("UPDATE accounts SET high_value_owned = :owned WHERE id = :id"),
{"owned": json.dumps(owned_value, ensure_ascii=False), "id": account_id},
)
updated += 1
# ⚠️ **不要**在这里 `conn.commit()`。
# 曾经加过,后果很隐蔽:DDL(ALTER TABLE)在 MySQL 上是自动提交的,
# 但 commit 会打乱 alembic 自己的版本记账 —— 表现为
# **列加上了、版本号却没更新**,下次启动升级时又去 ADD COLUMN,
# 直接 `Duplicate column name` 把服务起不来(生产上就是启动即挂)。
# 数据改动用 `op.get_bind().execute(...)` 写即可,提交由 alembic 负责
# (仓库里 0042 的 S1 回填就是这么写的,一直正常)。
if updated:
print(f"[0048] 已从快照回填 {updated} 个账号的 high_value_owned")
def _column_exists(name: str) -> bool:
"""列是否已存在。
应用启动时会自动跑迁移,所以迁移必须**可安全重跑** ——
万一出现「列已在、版本号没更新」的状态(本迁移就踩过),
无脑 ADD COLUMN 会直接 `Duplicate column name` 让服务起不来。
"""
conn = op.get_bind()
count = conn.execute(
sa.text(
"SELECT COUNT(*) FROM information_schema.columns "
"WHERE table_schema = DATABASE() "
"AND table_name = 'accounts' AND column_name = :name"
),
{"name": name},
).scalar()
return bool(count)
def upgrade() -> None:
if not _column_exists("high_value_owned"):
op.add_column(
"accounts",
sa.Column(
"high_value_owned",
sa.JSON(),
nullable=True,
comment="一键查询得到的「已兑换过的高价值套装名」列表(列表用,极小)",
),
)
# 无论列是不是这一步加的,都跑回填(幂等:覆盖式写入)
_backfill_from_snapshot()
def downgrade() -> None:
op.drop_column("accounts", "high_value_owned")