yml2213
62d9053e8a
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`
供列表点击预览（按需拉取，不进列表响应）。
2026-10-04 20:03:42 +08:00
..
2026-10-04 20:03:42 +08:00
2026-09-11 10:31:46 +08:00
2026-10-04 19:22:34 +08:00