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