feat(events): 补齐资产【出项】—— 开通金额、鱼翅消耗、积分到期(C 最全)

审「哪些操作该进账号生命周期」时发现:**进项有账、出项没账** ——
充值/积分到账都有金额,而开通(花积分)、送礼(花鱼翅)几乎没记,
于是「一共充了多少」算得出来,「花哪儿了」算不出来。

按确认的范围一次做完(应用宝充值**不动** —— 它按游戏角色记账、且未启用)。

## A. 开通类事件补金额

`elite_opened` / `esports_opened` 以前只记「开通后的积分余额」,不记**花了多少**。
现在补 `amount = -(开通前后积分差)`,并用**实测余额差**而不是"开通要多少分"的常量
(活动价、折扣会让实际扣减不同)。任一侧拿不到就不写金额,不编数字。

## B. 鱼翅消耗事件(新 `gold_spent`)

送礼以前只发「积分到账」,**花掉的鱼翅没有任何记录**。现在:
- 送礼**前后各刷一次**鱼翅(原来只在送礼后刷),取**实测余额差**;
- 发 `gold_spent`,`amount` 用负数(与 `exchange` 一致);
- 余额没减少或拿不到 → **不发**:宁可少一条,也不要记一笔没发生的消耗。

## C. 积分到期(新 `points_expire`)

积分到期是资产真实减少,但**斗鱼不会通知** —— 只在积分查询里给 `willExpireTime`。
所以:
- 新增 `accounts.points_expire_at`(迁移 `0046`),送礼流程学到就写下来;
- 新增作业 `points_expire_check`:扫「已到期且积分未归零」的账号,补写事件并清标记
  (不重复记);积分已为 0 则只清标记、不发事件(避免 `-0` 噪声)。

⚠️ **金额的诚实边界**:到期那一刻**到底扣了多少,我们没亲眼看到**。
所以默认 `confirmed=False`、标题带「(预计)」,记的是「当时余额」这个**预计要归零**的数量,
**不假装它是确认过的扣减**。作业刻意不发网络请求(纯 DB 可跑、不需要 CK),
要变成已确认只能由「到期后重查、真看到余额下降」的调用方补。

## 顺带修掉一个会静默丢事件的坑

同一个任务可能产生**两条事件**(送礼:既「积分到账」又「消耗鱼翅」)。
`source_ref` 是唯一键 —— 共用 `task_ref(task_id)` 会让**后写的那条被静默丢弃**。
已让副事件带后缀(`douyu_task:{id}:gold`),主事件保持原形态(与旧收集器一致)。
有用例专门钉住「一个任务两条事件都不丢」。

## 验证

- `TZ=Asia/Shanghai`:**550 passed / 6 skipped**(+18 条)
- `TZ=UTC`(事件 + 迁移 + 绑定)95 passed;ruff 全绿;前端 build 通过、lint 0 errors
- 真实开发库:迁移 `0046` 已应用;作业烟测 → 扫到 1 个到期账号,
  写入「积分到期 -500(预计)」`confirmed=False`,标记被清、重跑不再重复

## 现在的资产流水(斗鱼侧)

| 方向 | 覆盖 |
| --- | --- |
| 进项 | 充值(二维码/供应商/回调三路径去重)✅、积分到账 ✅ |
| 出项 | 兑换 ✅、**开通 ✅(新补金额)**、**送礼鱼翅 ✅(新)**、**积分到期 ✅(新,标预计)** |
| 未动 | 应用宝充值(独立系统、按游戏角色记、当前未启用) |
This commit is contained in:
yml2213
2026-10-04 18:10:46 +08:00
parent 4c1fe0c84f
commit 0b1fc1dee0
10 changed files with 548 additions and 8 deletions
+89 -2
View File
@@ -10,7 +10,7 @@ from sqlalchemy.orm import Session
from core.douyu import DouyuActivityClient
from ..models import Account, DouyuTask
from .business_events import record_points_credit
from .business_events import record_gold_spent, record_points_credit
DOUYU_GIFT_POINTS_REFRESH_TIMES = 3
DOUYU_GIFT_POINTS_REFRESH_INTERVAL = 2
@@ -139,6 +139,13 @@ class DonateMixin:
db.commit()
except Exception as exc: # noqa: BLE001 外部接口与任务边界需要保留宽泛异常兜底
self._push_log("warning", f"赠送{gift_name}前刷新电竞积分失败: {exc}")
baseline_gold = account.gold_balance
try:
gold_before = self._refresh_account_gold_balance(client, account)
db.commit()
baseline_gold = gold_before["gold_balance"]
except Exception as exc: # noqa: BLE001 外部接口与任务边界需要保留宽泛异常兜底
self._push_log("warning", f"赠送{gift_name}前刷新鱼翅失败: {exc}")
result = client.donate_esports_gift(
gift_name=gift_name,
@@ -195,6 +202,15 @@ class DonateMixin:
confirmed=confirmed,
source_label=gift_name,
)
record_gold_spent(
db,
account,
task_id=task.id,
amount=_gold_spent(baseline_gold, account.gold_balance),
reason=f"赠送{gift_name} x{gift_count}",
source_label=f"赠送{gift_name}",
balance_after=account.gold_balance,
)
self._mark_task(db, task, "success", message, result)
def _execute_donate_esports_chicken_gift(
@@ -254,6 +270,15 @@ class DonateMixin:
baseline_points = baseline_result["points"]
except Exception as exc: # noqa: BLE001 外部接口与任务边界需要保留宽泛异常兜底
self._push_log("warning", f"赠送精英令前刷新积分失败: {exc}")
# 鱼翅基线:送礼会**消耗鱼翅**,要记出项就必须有送礼前的余额。
# 直接读 account.gold_balance 是上次刷新的旧值,算出来的差会偏。
baseline_gold = account.gold_balance
try:
gold_before = self._refresh_account_gold_balance(client, account)
db.commit()
baseline_gold = gold_before["gold_balance"]
except Exception as exc: # noqa: BLE001 外部接口与任务边界需要保留宽泛异常兜底
self._push_log("warning", f"赠送精英令前刷新鱼翅失败: {exc}")
result = client.donate_elite_gift(
gift_count=gift_count,
room_id=str(payload.get("room_id") or config["room_id"]),
@@ -289,6 +314,12 @@ class DonateMixin:
if account.gold_balance is not None:
message += f",鱼翅余额: {account.gold_balance}"
confirmed = bool(result.get("gift_points_confirmed"))
# 顺手记下积分到期时刻:斗鱼只在这次查询里给,不记下来以后就没机会了。
# 到期是资产减少,但斗鱼不会通知 —— 由作业在到期后补写事件。
expire_at = _points_expire_at(result)
expire_dt = _parse_expire_at(expire_at)
if expire_dt is not None:
account.points_expire_at = expire_dt
if account.points is not None:
message += f",积分: {account.points}"
if result.get("gift_points_target") is not None and not confirmed:
@@ -303,10 +334,21 @@ class DonateMixin:
task_id=task.id,
gain=max(0, gift_count) * 10,
points_after=account.points,
expire_at=_points_expire_at(result),
expire_at=expire_at,
confirmed=confirmed,
source_label="精英令",
)
# 鱼翅出项:以前只记「积分到账」,花掉的鱼翅没有任何记录 ——
# 充值有账、消耗没账,对不上。金额取实测余额差。
record_gold_spent(
db,
account,
task_id=task.id,
amount=_gold_spent(baseline_gold, account.gold_balance),
reason=f"赠送精英令 x{gift_count}",
source_label="赠送精英令",
balance_after=account.gold_balance,
)
self._mark_task(db, task, "success", message, result)
@@ -338,3 +380,48 @@ def _esports_gift_points(result: dict, baseline_points: int | None) -> int | Non
return None
delta = int(after) - int(baseline_points)
return delta if delta > 0 else None
def _gold_spent(before: int | None, after: int | None) -> int | None:
"""送礼前后鱼翅余额的差(正数 = 花掉的)。
用**实测余额差**而不是礼物单价:单价会变、活动会打折,只有观测到的差是真的。
任一侧拿不到、或余额没减少(甚至变多,例如同时另一笔充值到账)→ 返回 None,
事件就不写金额 —— 宁可少记,不要编一个数进账。
"""
if not isinstance(before, (int, float)) or not isinstance(after, (int, float)):
return None
delta = int(before) - int(after)
return delta if delta > 0 else None
def _parse_expire_at(value: object) -> datetime | None:
"""把斗鱼给的到期时间解析成 datetime。
它可能是秒级时间戳(int/str),也可能是 `YYYY-MM-DD HH:MM:SS` 字符串 ——
两种都见过,所以都兜住;认不出来就返回 None(宁可不记,也不要猜一个时刻)。
"""
if value is None or isinstance(value, bool):
return None
if isinstance(value, (int, float)):
seconds = float(value)
else:
text = str(value).strip()
if not text:
return None
if text.isdigit():
seconds = float(text)
else:
for fmt in ("%Y-%m-%d %H:%M:%S", "%Y-%m-%dT%H:%M:%S", "%Y-%m-%d"):
try:
return datetime.strptime(text, fmt).replace(tzinfo=UTC)
except ValueError:
continue
return None
# 毫秒时间戳也兜一下
if seconds > 10_000_000_000:
seconds /= 1000
try:
return datetime.fromtimestamp(seconds, tz=UTC)
except (OverflowError, OSError, ValueError):
return None