from datetime import datetime from sqlalchemy import Boolean, DateTime, ForeignKey, Integer, String from sqlalchemy.orm import Mapped, mapped_column, relationship from app.db import Base class AuthUser(Base): __tablename__ = "auth_users" id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True) username: Mapped[str] = mapped_column(String(255), unique=True, nullable=False, index=True) password_hash: Mapped[str] = mapped_column(String(255), nullable=False) is_active: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True) force_password_change: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True) created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False) # TOTP fields (Phase B, M4-T04) — nullable/false by default so existing users are unaffected totp_secret: Mapped[str | None] = mapped_column(String(64), nullable=True) totp_enabled: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False) sessions: Mapped[list["AuthSession"]] = relationship(back_populates="user") recovery_codes: Mapped[list["RecoveryCode"]] = relationship(back_populates="user") class AuthSession(Base): __tablename__ = "auth_sessions" id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True) user_id: Mapped[int] = mapped_column(ForeignKey("auth_users.id"), nullable=False, index=True) token_hash: Mapped[str] = mapped_column(String(64), unique=True, nullable=False, index=True) csrf_token: Mapped[str] = mapped_column(String(128), nullable=False) created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False) expires_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False, index=True) revoked_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True) user: Mapped[AuthUser] = relationship(back_populates="sessions") class RecoveryCode(Base): """One-time TOTP recovery codes for AuthUser. ``code_hash`` stores the Argon2 hash of the plaintext code (plaintext is returned only at setup time and never stored). ``used_at`` is NULL while the code is still valid; set to the consumption timestamp when consumed. """ __tablename__ = "auth_recovery_code" id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True) user_id: Mapped[int] = mapped_column(ForeignKey("auth_users.id"), nullable=False, index=True) code_hash: Mapped[str] = mapped_column(String(255), nullable=False) used_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True) user: Mapped[AuthUser] = relationship(back_populates="recovery_codes")