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