Files
Aurora-Core/app/models/artwork.py
T

53 lines
2.1 KiB
Python
Raw Normal View History

2026-09-04 17:34:03 -05:00
"""Artwork as a first-class entity (section 10) — never a `poster_url`
column on media tables, so provenance/licensing can be tracked per asset."""
from __future__ import annotations
import uuid
from sqlalchemy import Boolean, Float, ForeignKey, Index, Integer, String, Text
from sqlalchemy.orm import Mapped, mapped_column, relationship
from app.models.base import Base, TimestampMixin, UUIDPrimaryKeyMixin
from app.models.enums import ArtworkType
from app.models.provider import Provider
class Artwork(Base, UUIDPrimaryKeyMixin, TimestampMixin):
__tablename__ = "artwork"
__table_args__ = (
Index("ix_artwork_entity", "entity_type", "entity_id", "artwork_type"),
)
# Polymorphic target: "movie", "series", "season", "episode", "person",
# "company", "collection".
entity_type: Mapped[str] = mapped_column(String(30), nullable=False)
entity_id: Mapped[uuid.UUID] = mapped_column(nullable=False)
artwork_type: Mapped[ArtworkType] = mapped_column(nullable=False)
language_code: Mapped[str | None] = mapped_column(
ForeignKey("languages.code"), nullable=True
)
width: Mapped[int | None] = mapped_column(Integer, nullable=True)
height: Mapped[int | None] = mapped_column(Integer, nullable=True)
aspect_ratio: Mapped[float | None] = mapped_column(Float, nullable=True)
vote_average: Mapped[float | None] = mapped_column(Float, nullable=True)
is_primary: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
provider_id: Mapped[uuid.UUID] = mapped_column(
ForeignKey("providers.id", ondelete="CASCADE"), nullable=False
)
provider_asset_id: Mapped[str | None] = mapped_column(String(200), nullable=True)
original_url: Mapped[str] = mapped_column(String(1000), nullable=False)
local_path: Mapped[str | None] = mapped_column(String(1000), nullable=True)
checksum: Mapped[str | None] = mapped_column(String(128), nullable=True)
attribution: Mapped[str | None] = mapped_column(Text, nullable=True)
license: Mapped[str | None] = mapped_column(Text, nullable=True)
provider: Mapped[Provider] = relationship()
__all__ = ["Artwork"]