first commit

backend/models/email_delivery.py

@@ -0,0 +1,59 @@
+"""Модель EmailDelivery — факт отправки письма.
+
+Идемпотентность рассылки саммари (`kind='summary'`): уникальный частичный
+индекс `(session_id, recipient_email)` не даёт повторной отправке того же
+письма тому же адресату. Приглашения (`kind='invitation'`) — только журнал,
+без unique (изменение расписания обязано переслать обновление).
+"""
+
+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 EmailDelivery(Base):
+    """Запись об отправленном письме: саммари (`session_id`) либо приглашение (`conference_id`)."""
+
+    __tablename__ = "email_deliveries"
+    __table_args__ = (
+        CheckConstraint("kind IN ('summary', 'invitation')", name="ck_email_deliveries_kind"),
+        CheckConstraint(
+            "(kind = 'summary') = (session_id IS NOT NULL)",
+            name="ck_email_deliveries_summary_has_session",
+        ),
+        CheckConstraint(
+            "(kind = 'invitation') = (conference_id IS NOT NULL)",
+            name="ck_email_deliveries_invitation_has_conference",
+        ),
+        Index(
+            "uq_email_deliveries_summary",
+            "session_id",
+            "recipient_email",
+            unique=True,
+            postgresql_where=text("kind = 'summary'"),
+        ),
+        Index("ix_email_deliveries_conference", "conference_id"),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, server_default=text("gen_random_uuid()")
+    )
+    session_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("conference_sessions.id", ondelete="CASCADE"),
+        nullable=True,
+    )
+    conference_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("conferences.id", ondelete="CASCADE"), nullable=True
+    )
+    # Хранится в lower() (нормализация — на уровне сервиса-отправителя).
+    recipient_email: Mapped[str] = mapped_column(String(320), nullable=False)
+    kind: Mapped[str] = mapped_column(String(16), nullable=False)
+    sent_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), nullable=False, server_default=func.now()
+    )