app/models/class_session_progress.py

from __future__ import annotations

from datetime import datetime
from typing import Any

from sqlalchemy import DateTime, ForeignKey, JSON, String, UniqueConstraint, func
from sqlalchemy.orm import Mapped, mapped_column

from app.core.database import Base
from app.utils.ids import prefixed_id


class ClassSessionProgress(Base):
    """Per-user, per-class tuition class progress (the 11-step guided class).

    One row per (user, class_session_id). The resumable class state is stored as
    a JSON blob so the step shape can evolve freely.
    """

    __tablename__ = "class_session_progress"
    __table_args__ = (
        UniqueConstraint("user_id", "class_session_id", name="uq_class_session_user_session"),
    )

    id: Mapped[str] = mapped_column(
        String(40),
        primary_key=True,
        default=lambda: prefixed_id("cprog"),
    )
    user_id: Mapped[str] = mapped_column(
        String(40),
        ForeignKey("users.id"),
        index=True,
        nullable=False,
    )
    class_session_id: Mapped[str] = mapped_column(String(200), nullable=False)
    data: Mapped[dict[str, Any]] = mapped_column(JSON, default=dict, nullable=False)
    created_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True),
        server_default=func.now(),
        nullable=False,
    )
    updated_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True),
        server_default=func.now(),
        onupdate=func.now(),
        nullable=False,
    )