goon/app/models/playback_event.py
goon-foss 2feef620a1 feat(telemetry): playback_events.via, skad przyszedl adres w odtwarzaczu
Po przejsciu porndoe na resolver po stronie telefonu 35 urzadzen dalej
dostawalo wylacznie 403 i nie dalo sie odroznic, czy pada nowa droga, zapas
przez WebView, czy stara paczka. Apka wysyla teraz via: phone, backend,
hoster, webview, proxy, movie; '-re' po ponownym rozwiazaniu w tym samym
ekranie, '<droga>>wv' gdy adres wyciagnal WebView jako zapas. NULL = paczka
sprzed tej zmiany. Migracja 0053 (kolumna nullable, sama zmiana metadanych).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 16:25:56 +02:00

51 lines
2.5 KiB
Python

"""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)
# Surowa treść błędu z native playera (ExoPlayer message, ucięta), dokładna
# diagnostyka realnych padów niereprodukowalnych na emulatorze.
error_detail: Mapped[str | None] = mapped_column(String(512), 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)
# Skad przyszedl adres w odtwarzaczu: 'phone', 'backend', 'hoster', 'webview',
# 'proxy' (z '-re' po ponownym rozwiazaniu). NULL = paczka sprzed 2026-10-06.
via: Mapped[str | None] = mapped_column(String(16), 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
)