backend/app/models/progress.py - master - DaniilSk/DesignLab

backend/app/models/progress.py
112 строк6 KB
Даниил
feat(loyalty): add loyalty and event registration api
13 июл 2026, 01:57
13 июл 2026, 01:57da7ec36
import uuid
from datetime import datetime

from sqlalchemy import Boolean, DateTime, ForeignKey, Index, Integer, String, UniqueConstraint
from sqlalchemy.dialects.postgresql import JSONB, UUID
from sqlalchemy.orm import Mapped, mapped_column, relationship

from app.models.base import Base, TimestampMixin, UUIDMixin


class UserProgress(Base, TimestampMixin):
    __tablename__ = "user_progress"

    user_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), primary_key=True)
    level: Mapped[int] = mapped_column(Integer, default=1, nullable=False)
    points_balance: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
    total_points: Mapped[int] = mapped_column(Integer, default=0, nullable=False)


class LoyaltyProgram(Base, UUIDMixin, TimestampMixin):
    __tablename__ = "loyalty_programs"

    code: Mapped[str] = mapped_column(String(80), unique=True, nullable=False)
    title: Mapped[str] = mapped_column(String(180), nullable=False)
    description: Mapped[str | None] = mapped_column(String(800))
    image_url: Mapped[str | None] = mapped_column(String(1000))
    is_active: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)

    levels: Mapped[list["LoyaltyLevel"]] = relationship(back_populates="program", cascade="all, delete-orphan")


class LoyaltyLevel(Base, UUIDMixin, TimestampMixin):
    __tablename__ = "loyalty_levels"
    __table_args__ = (UniqueConstraint("program_id", "level_order", name="uq_loyalty_level_order"),)

    program_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("loyalty_programs.id", ondelete="CASCADE"))
    title: Mapped[str] = mapped_column(String(180), nullable=False)
    level_order: Mapped[int] = mapped_column(Integer, nullable=False)
    required_points: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
    choose_one_reward: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)

    program: Mapped[LoyaltyProgram] = relationship(back_populates="levels")
    rewards: Mapped[list["LoyaltyReward"]] = relationship(back_populates="level", cascade="all, delete-orphan")


class LoyaltyReward(Base, UUIDMixin, TimestampMixin):
    __tablename__ = "loyalty_rewards"
    __table_args__ = (Index("ix_loyalty_rewards_level_order", "level_id", "display_order"),)

    level_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("loyalty_levels.id", ondelete="CASCADE"))
    title: Mapped[str] = mapped_column(String(180), nullable=False)
    description: Mapped[str | None] = mapped_column(String(800))
    image_url: Mapped[str | None] = mapped_column(String(1000))
    display_order: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
    is_active: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
    stock_limit: Mapped[int | None] = mapped_column(Integer)
    claimed_count: Mapped[int] = mapped_column(Integer, default=0, nullable=False)

    level: Mapped[LoyaltyLevel] = relationship(back_populates="rewards")


class UserLoyaltyProgress(Base, TimestampMixin):
    __tablename__ = "user_loyalty_progress"
    __table_args__ = (UniqueConstraint("user_id", "program_id", name="uq_user_loyalty_progress"),)

    user_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), primary_key=True)
    program_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("loyalty_programs.id", ondelete="CASCADE"), primary_key=True)
    current_level_id: Mapped[uuid.UUID | None] = mapped_column(UUID(as_uuid=True), ForeignKey("loyalty_levels.id", ondelete="SET NULL"))
    points: Mapped[int] = mapped_column(Integer, default=0, nullable=False)


class UserRewardClaim(Base, UUIDMixin, TimestampMixin):
    __tablename__ = "user_reward_claims"
    __table_args__ = (
        UniqueConstraint("user_id", "reward_id", name="uq_user_reward_claim"),
        UniqueConstraint("user_id", "level_id", name="uq_user_reward_level_claim"),
    )

    user_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), nullable=False)
    reward_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("loyalty_rewards.id", ondelete="CASCADE"), nullable=False)
    level_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("loyalty_levels.id", ondelete="CASCADE"), nullable=False)
    status: Mapped[str] = mapped_column(String(32), default="claimed", nullable=False)
    claimed_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))


class PointTransaction(Base, UUIDMixin, TimestampMixin):
    __tablename__ = "point_transactions"

    user_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), nullable=False)
    amount: Mapped[int] = mapped_column(Integer, nullable=False)
    reason: Mapped[str] = mapped_column(String(160), nullable=False)
    source_type: Mapped[str | None] = mapped_column(String(64))
    source_id: Mapped[str | None] = mapped_column(String(64))
    metadata_json: Mapped[dict] = mapped_column("metadata", JSONB, default=dict, nullable=False)


class Reward(Base, UUIDMixin, TimestampMixin):
    __tablename__ = "rewards"

    code: Mapped[str] = mapped_column(String(80), unique=True, nullable=False)
    title: Mapped[str] = mapped_column(String(160), nullable=False)
    description: Mapped[str | None] = mapped_column(String(500))
    metadata_json: Mapped[dict] = mapped_column("metadata", JSONB, default=dict, nullable=False)


class UserReward(Base, UUIDMixin, TimestampMixin):
    __tablename__ = "user_rewards"
    __table_args__ = (UniqueConstraint("user_id", "reward_id", name="uq_user_reward"),)

    user_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), nullable=False)
    reward_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("rewards.id", ondelete="CASCADE"), nullable=False)
    status: Mapped[str] = mapped_column(String(32), default="earned", nullable=False)