feat(fulfillment): 增加账号商品能力索引与生命周期事件

This commit is contained in:
yml
2026-11-18 19:30:59 +08:00
parent dc95d83b32
commit 667634a8df
35 changed files with 3076 additions and 82 deletions
+103
View File
@@ -1637,6 +1637,109 @@ class AccountEvent(Base):
)
class AccountCommodityState(Base):
"""账号对具体斗鱼商品的当前兑换能力。
``accounts`` 保存账号级状态(CK、积分、宝典、换绑冷却),本表保存
“这个账号现在能不能换这个商品”。它是查询快照的派生索引,不是新的账号主表:
- ``availability`` 是最近一次官方商品列表得出的结论;
- ``observed_at`` / ``valid_until`` 明确这条结论的有效期;
- ``last_exchange_at`` / ``exchange_count_365d`` 是兑换历史的高频反规范化;
- 真正发生过的兑换仍然只追加到 ``account_events``。
匹配读取本表,真正占用账号前再做一次实时确认。查不到时保留上一有效结论,
但过期的 ``available`` 不允许继续参与自动匹配。
"""
__tablename__ = "account_commodity_states"
id: Mapped[int] = mapped_column(BigInteger, primary_key=True, autoincrement=True)
account_id: Mapped[int] = mapped_column(
ForeignKey("accounts.id", ondelete="CASCADE"), nullable=False
)
platform: Mapped[str] = mapped_column(
String(16), nullable=False, default="douyu", server_default="douyu"
)
scope: Mapped[str] = mapped_column(
String(16), nullable=False, default="elite", server_default="elite"
)
commodity_id: Mapped[str] = mapped_column(String(64), nullable=False)
commodity_name: Mapped[str] = mapped_column(
String(256), nullable=False, default="", server_default=""
)
# available / limited / no_stock / not_open / not_offered / unknown
availability: Mapped[str] = mapped_column(
String(16), nullable=False, default="unknown", server_default="unknown"
)
blocking_reason: Mapped[str] = mapped_column(
String(255), nullable=False, default="", server_default=""
)
raw_status: Mapped[str] = mapped_column(
String(16), nullable=False, default="", server_default=""
)
time_limited: Mapped[bool] = mapped_column(
Boolean, nullable=False, default=False, server_default="0"
)
available_from: Mapped[datetime | None] = mapped_column(
UTCDateTime, nullable=True
)
available_until: Mapped[datetime | None] = mapped_column(
UTCDateTime, nullable=True
)
schedule_json: Mapped[list | None] = mapped_column(JSON, nullable=True)
observed_at: Mapped[datetime | None] = mapped_column(
UTCDateTime, nullable=True
)
valid_until: Mapped[datetime | None] = mapped_column(
UTCDateTime, nullable=True
)
next_check_at: Mapped[datetime | None] = mapped_column(
UTCDateTime, nullable=True
)
last_exchange_at: Mapped[datetime | None] = mapped_column(
UTCDateTime, nullable=True
)
exchange_count_365d: Mapped[int] = mapped_column(
Integer, nullable=False, default=0, server_default="0"
)
source: Mapped[str] = mapped_column(
String(24), nullable=False, default="", server_default=""
)
error_code: Mapped[str] = mapped_column(
String(64), nullable=False, default="", server_default=""
)
created_at: Mapped[datetime] = mapped_column(UTCDateTime, default=_utcnow)
updated_at: Mapped[datetime] = mapped_column(
UTCDateTime, default=_utcnow, onupdate=_utcnow
)
__table_args__ = (
UniqueConstraint(
"account_id",
"platform",
"scope",
"commodity_id",
name="uq_account_commodity_state",
),
Index(
"ix_account_commodity_match",
"platform",
"scope",
"commodity_id",
"availability",
"valid_until",
"account_id",
),
Index(
"ix_account_commodity_account",
"account_id",
"platform",
"scope",
),
)
class AccountLease(Base):
"""账号租约:谁在**此刻**可以使用这个账号。