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:
@@ -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")
|
||||
Reference in New Issue
Block a user