"""作业:把已经到期的积分记进账号时间线。 ## 为什么需要单独一个作业 积分到期是账号资产的**真实减少**,但斗鱼**不会通知**你 —— 它只在积分查询里 给一个 `willExpireTime`。所以: 1. 送礼流程顺手把这个时刻写进 `accounts.points_expire_at`(学习即记录); 2. 本作业扫「到期时刻已过、且积分还没归零」的账号,补写一条 `points_expire` 事件,然后清掉该字段(不重复记)。 没有它,积分到期在时间线上就是永久空白 —— 进项有账、这项没账。 ## 金额的诚实边界(重要) `willExpireTime` 的语义是「**当前**这些积分在此时到期」,但到期那一刻**到底扣了 多少分,我们并没有亲眼看到**(斗鱼不给回调,重查要按账号发网络请求)。 所以本作业写出的 `amount` 是**当时账号上的积分余额**(也就是预计要归零的数量), 并且 `detail.confirmed = False`、标题带「(预计)」—— **标成预计,而不是假装它是确认过的扣减**。 要变成已确认,只能由「到期后重查、真的看到余额下降」的调用方补一条 `confirmed=True` 的事件。这里刻意不做网络请求:本作业要能在纯 DB 上跑完, 不必持有 CK,也不给斗鱼侧增加调用量。 """ from __future__ import annotations import json from datetime import UTC, datetime from typing import Any from loguru import logger from sqlalchemy.orm import Session from ....models import Account, AutomationJob from ...business_events import record_points_expire JOB_KEY = "points_expire_check" #: 一次最多处理多少个账号(避免一轮里写太多事件) DEFAULT_BATCH = 200 def _positive_int(value: Any, default: int) -> int: try: parsed = int(value) except (TypeError, ValueError): return default return parsed if parsed > 0 else default def _load_config(job: AutomationJob) -> dict[str, Any]: config = job.config if isinstance(config, str): try: config = json.loads(config) except ValueError: config = {} return dict(config) if isinstance(config, dict) else {} def run_points_expire_check(db: Session, job: AutomationJob) -> dict[str, Any]: batch = _positive_int(job.batch_size, DEFAULT_BATCH) now = datetime.now(UTC) rows = ( db.query(Account) .filter( Account.points_expire_at.isnot(None), Account.points_expire_at <= now, ) .order_by(Account.points_expire_at.asc(), Account.id.asc()) .limit(batch) .all() ) written = 0 skipped_zero = 0 for account in rows: points = account.points if not points or int(points) <= 0: # 没有积分可到期:不写事件(写一条 -0 只是噪声),但要把字段清掉 skipped_zero += 1 account.points_expire_at = None continue record_points_expire( db, account, amount=int(points), occurred_at=account.points_expire_at, expires_at=account.points_expire_at, # 没亲眼看到扣减 —— 如实标成预计 confirmed=False, ) account.points_expire_at = None written += 1 db.commit() message = ( f"积分到期补记 {written} 条(另有 {skipped_zero} 个账号积分已为 0,只清标记)" ) logger.info(message) return { "scanned": len(rows), "written": written, "skipped_zero": skipped_zero, "message": message, }