"""Модель ConferenceSession — один запуск конференции, единица AI-пайплайна (ADR-001).

Таблица `conference_sessions` исторически получена переименованием старой
`conferences` — семантика `pipeline_status` (идемпотентная статус-машина
пост-обработки) при этом не менялась.
"""

import uuid
from datetime import datetime

from sqlalchemy import DateTime, Enum, ForeignKey, Index, String, Text, func, text
from sqlalchemy.dialects.postgresql import UUID
from sqlalchemy.orm import Mapped, mapped_column

from models.base import Base

PIPELINE_STATUSES: tuple[str, ...] = (
    "recording",
    "transcribing",
    "summarizing",
    "notified",
    "failed",
)
"""Полный перечень статусов пайплайна — переиспользуется метриками Prometheus
(`backend/api/metrics.py`), чтобы gauge по статусам не
"пропадал" из `/metrics` для статусов без единого сеанса на момент scrape."""

PipelineStatus = Enum(*PIPELINE_STATUSES, name="pipeline_status")


class ConferenceSession(Base):
    """Один сеанс конференции и состояние его pipeline пост-обработки."""

    __tablename__ = "conference_sessions"
    __table_args__ = (
        Index("ix_conference_sessions_conference_id_t_start", "conference_id", "t_start"),
        Index("ix_conference_sessions_pipeline_status", "pipeline_status"),
    )

    id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True), primary_key=True, server_default=text("gen_random_uuid()")
    )
    conference_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True), ForeignKey("conferences.id", ondelete="CASCADE"), nullable=False
    )
    title: Mapped[str | None] = mapped_column(String(255), nullable=True)
    t_start: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False)
    t_end: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
    summary_data: Mapped[str | None] = mapped_column(Text, nullable=True)
    pipeline_status: Mapped[str] = mapped_column(
        PipelineStatus, nullable=False, server_default="recording"
    )
    created_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True), nullable=False, server_default=func.now()
    )