first commit

backend/models/session.py

@@ -0,0 +1,55 @@
+"""Модель 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()
+    )