shaguabijia-app-server/app/models/signin.py

"""签到记录表。

每次签到一行,(user_id, signin_date) 唯一,天然防一天签两次。
  - cycle_day: 1..7,7 天循环里今天落在第几档,决定发多少金币;断签后重置回 1。
  - streak:   连续签到天数(不封顶),用于"已连续签到 N 天"展示;断签后重置回 1。
"""
from __future__ import annotations

from datetime import date, datetime

from sqlalchemy import Date, DateTime, ForeignKey, Integer, UniqueConstraint, func
from sqlalchemy.orm import Mapped, mapped_column

from app.db.base import Base


class SigninRecord(Base):
    __tablename__ = "signin_record"
    __table_args__ = (
        UniqueConstraint("user_id", "signin_date", name="uq_signin_user_date"),
    )

    id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
    user_id: Mapped[int] = mapped_column(
        Integer, ForeignKey("user.id"), index=True, nullable=False
    )
    # 签到日期(北京时间的 date)
    signin_date: Mapped[date] = mapped_column(Date, nullable=False)
    cycle_day: Mapped[int] = mapped_column(Integer, nullable=False)
    streak: Mapped[int] = mapped_column(Integer, nullable=False)
    coin_awarded: Mapped[int] = mapped_column(Integer, nullable=False)

    created_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True), server_default=func.now(), nullable=False
    )

    def __repr__(self) -> str:  # pragma: no cover
        return (
            f"<SigninRecord user_id={self.user_id} date={self.signin_date} "
            f"day={self.cycle_day} streak={self.streak}>"
        )