"""ORM models for admin analytics snapshots.""" from __future__ import annotations from datetime import UTC, datetime from sqlalchemy import Index, String, Text from sqlalchemy.orm import Mapped, mapped_column from deerflow.persistence.base import Base from deerflow.persistence.types import BeijingDateTime, PortableJSON class AdminLeaderboardDailyStatRow(Base): """One precomputed leaderboard snapshot for a single local calendar day.""" __tablename__ = "admin_leaderboard_daily_stats" __table_args__ = ( Index("ix_admin_leaderboard_daily_stats_status", "status"), Index("ix_admin_leaderboard_daily_stats_updated_at", "updated_at"), ) stat_date: Mapped[str] = mapped_column(String(10), primary_key=True) settings_hash: Mapped[str] = mapped_column(String(64), primary_key=True) status: Mapped[str] = mapped_column(String(16), default="ready") payload_json: Mapped[dict] = mapped_column(PortableJSON(), default=dict) message: Mapped[str | None] = mapped_column(Text) error: Mapped[str | None] = mapped_column(Text) generated_at: Mapped[datetime | None] = mapped_column(BeijingDateTime()) created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=lambda: datetime.now(UTC)) updated_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=lambda: datetime.now(UTC), onupdate=lambda: datetime.now(UTC))