feat: models

2026-06-07 14:50:35 +03:00
parent 87b48e941e
commit dfd512a13f
11 changed files with 732 additions and 1 deletions
@@ -0,0 +1,71 @@
+"""ORM model for tracks — the central entity.
+
+``id`` is the stable, client-facing ``content_id`` (generated app-side by
+``UUIDPrimaryKeyMixin``) — never regenerate it. Dedup is enforced on both
+``(source, source_id)`` (unique) and ``acoustid_fingerprint`` (indexed) so
+imports/downloads stay idempotent (plan §4, §6.1).
+"""
+
+import uuid
+
+from sqlalchemy import ForeignKey, Integer, String, UniqueConstraint
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.infrastructure.db.base import Base
+from app.infrastructure.db.models.enums import MetadataStatus, StoragePolicy
+from app.infrastructure.db.models.mixins import TimestampMixin, UUIDPrimaryKeyMixin
+
+
+class TrackModel(UUIDPrimaryKeyMixin, TimestampMixin, Base):
+    __tablename__ = "tracks"
+    __table_args__ = (
+        # Dedup by source identity — a source never yields the same id twice.
+        UniqueConstraint("source", "source_id", name="uq_tracks_source_source_id"),
+    )
+
+    title: Mapped[str] = mapped_column(String(1024), index=True, nullable=False)
+    artist_id: Mapped[uuid.UUID] = mapped_column(
+        ForeignKey("artists.id", ondelete="CASCADE"),
+        index=True,
+        nullable=False,
+    )
+    album_id: Mapped[uuid.UUID | None] = mapped_column(
+        ForeignKey("albums.id", ondelete="SET NULL"),
+        index=True,
+        nullable=True,
+    )
+    track_number: Mapped[int | None] = mapped_column(Integer, nullable=True)
+    duration_seconds: Mapped[int | None] = mapped_column(Integer, nullable=True)
+    genre: Mapped[str | None] = mapped_column(String(255), index=True, nullable=True)
+    year: Mapped[int | None] = mapped_column(Integer, nullable=True)
+
+    # -- file (original, stored as-is) -----------------------------------
+    file_path: Mapped[str] = mapped_column(String(2048), nullable=False)
+    file_format: Mapped[str] = mapped_column(String(32), nullable=False)
+    file_size: Mapped[int] = mapped_column(Integer, nullable=False)
+    bitrate: Mapped[int | None] = mapped_column(Integer, nullable=True)
+
+    # -- dedup / external ids --------------------------------------------
+    acoustid_fingerprint: Mapped[str | None] = mapped_column(String(64), index=True, nullable=True)
+    musicbrainz_id: Mapped[str | None] = mapped_column(String(36), index=True, nullable=True)
+
+    # -- provenance / policy ---------------------------------------------
+    source: Mapped[str] = mapped_column(String(32), nullable=False)
+    source_id: Mapped[str] = mapped_column(String(512), nullable=False)
+    is_replaceable: Mapped[bool] = mapped_column(nullable=False, default=False)
+    storage_policy: Mapped[str] = mapped_column(
+        String(16),
+        nullable=False,
+        default=StoragePolicy.AS_IS.value,
+    )
+    metadata_status: Mapped[str] = mapped_column(
+        String(16),
+        nullable=False,
+        default=MetadataStatus.PENDING.value,
+    )
+
+    added_by: Mapped[uuid.UUID | None] = mapped_column(
+        ForeignKey("users.id", ondelete="SET NULL"),
+        index=True,
+        nullable=True,
+    )