test(account): 一键查询 / 官方兑换记录 / 生命周期用例

围绕这几轮改动补齐用例(本文件共 53 条):

- **判定规则**:只看官方兑换记录;全局库存**永不**推出「该账号已拥有」
  (回归用例 —— 正是第一版踩的坑);字段缺失是 None(未知)而不是 False(没有)
- **失败隔离**:单项外部调用失败不影响其余,且如实写进 errors
- **只读性**:一键查询不发事件、不改生命周期状态
- **官方记录补成事件**:带**真实兑换时间**(不是"发现它的时刻")、
  幂等(重复查询不重复落)、无 commodityId 时跳过
- **排序回归**:「最近一次兑换」按事件时间,不是插入 id
- **时间归一化**:0 / "0" / 空 / 负数 → None(1970 那个 bug 的回归)
- **迁移安全**:不得在迁移里 commit(op.get_bind());加列前必须有存在性检查
  (扫代码时**跳过注释** —— 注释里正解释着"不要这样做",第一版用例因此假红)
- **接口契约**:详情返回快照与查询时间、列表**不**带整份快照;
  断言一律看 model_dump()(只看属性会假绿 —— AccountOut 有手写
  @model_serializer,字段没列进去时属性有值、JSON 里没有)

另修两条**把 bug 当期望值**的既有用例:

1. 「最近一次兑换」原断言的是最后**插入**的那条(旧行为按 id 排),
   改为真正最近的(按事件时间);
2. 按用户名查找夹具不可靠(make_account("key") 每次建新账号、库里一直累积),
   改为按 id 精确查找。
This commit is contained in:
yml2213
2026-10-04 20:04:11 +08:00
parent f416397cc8
commit 6865b916ba
3 changed files with 444 additions and 7 deletions
+23 -3
View File
@@ -902,7 +902,10 @@ class TestExchangeRecordColumn(_Base):
def _exchange(self, account_id: int, name: str, *, days_ago: int = 0):
from datetime import timedelta
from web.backend.services.account_events_service import emit
from web.backend.services.account_events_service import (
OFFICIAL_SYNC_SOURCE,
emit,
)
emit(
self.session,
@@ -912,6 +915,9 @@ class TestExchangeRecordColumn(_Base):
category="business",
subject_key=name,
occurred_at=NOW - timedelta(days=days_ago),
# 列表的「兑换记录」列**只聚合斗鱼官方记录**(source=official_sync),
# 我们当场记的那些留给详情页时间线 —— 这是刻意的口径划分。
source=OFFICIAL_SYNC_SOURCE,
)
self.session.commit()
@@ -930,9 +936,23 @@ class TestExchangeRecordColumn(_Base):
item = self._item("hasex")
assert item.exchange_count == 3
# 「最近」按**事件 id** 取(同一天多次兑换时时间戳可能相同,靠 id 定序)
# 「最近一次」按**事件时间**取:三条分别是 3 天前 / 1 天前 / 2 天前,
# 所以最近的是「冠军鸡腿」(1 天前)。
#
# ⚠️ 这里原来断言的是「烟花」(**最后插入**的那条)—— 那是错的,
# 因为当时后端按事件 **id** 排序,于是「最近一次」实际是"最后插入的一次"。
# 一键查询把斗鱼官方的**历史**兑换补成事件后这个 bug 才暴露:
# 补录的事件 id 最大、时间却最老,会把几个月前的老兑换显示成"最近一次"。
# 现在排序是 `occurred_at DESC, id DESC`(时间相同才用 id 兜底)。
# 后端返回事件原始 title;剥掉「兑换 」前缀是前端展示层的事。
assert item.last_exchange_name == "兑换 烟花"
assert item.last_exchange_name == "兑换 冠军鸡腿"
def test_latest_uses_id_only_to_break_ties(self):
"""时间相同时再用 id 定序(同一天多次兑换时间戳可能一样)。"""
account = self.make_account("tie")
self._exchange(account.id, "先插入", days_ago=1)
self._exchange(account.id, "后插入", days_ago=1)
assert self._item("tie").last_exchange_name == "兑换 后插入"
def test_only_exchange_events_count(self):
"""别的类型(充值 / 登录 / 状态)不能混进兑换次数。"""