Files
live-hub-py/web/backend/migrations/versions/20261004_0048_overview_summary.py
T
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

114 lines
4.3 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""账号列表要显示一键查询的结果:加一个**极小**的字段
账号列表的「兑换记录」列一直来自我们自己的 `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")