"""Playback telemetry — fire-and-forget ping z apki po każdej próbie odtwarzania.

Po co: ranking źródeł (Sites screen) potrzebuje realnego sygnału "czy to gra".
Świeżość i bogactwo metadanych liczymy z DB, ale "szybkość działania" znał tylko
telefon (resolve hosterów/WebView dzieje się phone-side). Bez tego sygnału źródło
może wyglądać świeżo i bogato, a serwować stub (problem hqfap/4k69).

Append-only, agregowane przez `run_source_stats` (okno 7d → health score per origin).
Retencja: stats-job kasuje wpisy starsze niż 30 dni. Brak FK na scene (scene_id
informacyjne, scena może zniknąć przez dedup/merge).
"""
from __future__ import annotations

import uuid
from datetime import datetime

from sqlalchemy import DateTime, Index, Integer, String, func
from sqlalchemy.dialects.postgresql import UUID
from sqlalchemy.orm import Mapped, mapped_column

from app.models.base import Base


class PlaybackEvent(Base):
    __tablename__ = "playback_events"
    __table_args__ = (
        Index("ix_playback_events_origin_created", "origin", "created_at"),
    )

    id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
    )
    # 'tube:<sitetag>' — zgodne z playback_sources.origin (join po origin).
    origin: Mapped[str] = mapped_column(String(64), nullable=False)
    scene_id: Mapped[uuid.UUID | None] = mapped_column(UUID(as_uuid=True), nullable=True)
    # 'success' = wideo realnie ruszyło; 'error' = resolve/player padł.
    status: Mapped[str] = mapped_column(String(16), nullable=False)
    # np. 'no_source', 'resolve_failed', 'player_error', 'timeout' (tylko gdy error).
    error_kind: Mapped[str | None] = mapped_column(String(64), nullable=True)
    # time-to-first-frame [ms] — "szybkość" (tylko przy success; None gdy nie zmierzono).
    ttff_ms: Mapped[int | None] = mapped_column(Integer, nullable=True)
    device_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
    created_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True), server_default=func.now(), nullable=False
    )