Первоначальная версия VidConf

backend/models/invitee.py

@@ -0,0 +1,61 @@
+"""Модель ConferenceInvitee — приглашённый на конференцию (ADR-003).
+
+Не путать с `ConferenceParticipant` (ADR-002) — та таблица фиксирует
+ФАКТИЧЕСКОЕ присутствие в сеансе, эта — состав, заданный организатором ДО
+конференции. Организатор в этой таблице не хранится: он всегда выводится из
+`conferences.owner_id` (см. ADR-003, п.2) — инвариант «организатор всегда в
+составе и неудаляем» обеспечен конструктивно, без триггеров.
+"""
+
+import uuid
+from datetime import datetime
+
+from sqlalchemy import CheckConstraint, DateTime, ForeignKey, Index, String, func, text
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import Mapped, mapped_column
+
+from models.base import Base
+
+
+class ConferenceInvitee(Base):
+    """Приглашённый: ровно одна identity — зарегистрированный `user_id` ИЛИ внешний `email`."""
+
+    __tablename__ = "conference_invitees"
+    __table_args__ = (
+        CheckConstraint(
+            "(user_id IS NOT NULL)::int + (email IS NOT NULL)::int = 1",
+            name="ck_conference_invitees_single_identity",
+        ),
+        # Частичные уникальные индексы (ADR-003, п.1): без дублей приглашения
+        # одного и того же пользователя/email на одну конференцию.
+        # `lower(email)` — регистронезависимо (email нормализуется в lower-case
+        # уже на уровне схемы `InviteeIn`, индекс — доп. страховка).
+        Index(
+            "uq_conference_invitees_user",
+            "conference_id",
+            "user_id",
+            unique=True,
+            postgresql_where=text("user_id IS NOT NULL"),
+        ),
+        Index(
+            "uq_conference_invitees_email",
+            "conference_id",
+            text("lower(email)"),
+            unique=True,
+            postgresql_where=text("email IS NOT NULL"),
+        ),
+    )
+
+    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
+    )
+    user_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), nullable=True
+    )
+    email: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), nullable=False, server_default=func.now()
+    )