goon/app/models/playback_event.py
goon-foss a4486980a4 style: myslniki em/en z komentarzy i docstringow (calosc repo)
1745 wystapien w 291 plikach (backend, scripts, mobile). Dominowal jeden ksztalt,
' — ' laczace zdania, wiec poszedl przecinek; myslnik otwierajacy mysl zdjety;
zakresy 0–5 i A–Z na dywiz.

Podzial komentarz/kod robil skaner stanow, nie regex, zeby nie ruszyc myslnika
stojacego w stringu albo w wyrazeniu regularnym. Potwierdzone maszynowo: po wycieciu
komentarzy z wersji HEAD i z dysku obie sa identyczne we wszystkich 291 plikach,
czyli poza komentarzami nie zmienilo sie nic. 233 pliki .py parsuja sie bez bledu,
tsc ma te same 11 bledow w tych samych 3 plikach co przed zmiana.

Dwie rzeczy wymagaly poprawki po automacie: wyrownane listy definicji, gdzie myslnik
byl separatorem kolumny (37 miejsc, kolumna przywrocona), i trzy przeniesienia mysli
do nowej linii, gdzie zostawal wiszacy przecinek na poczatku (poprawione recznie).

Bundla nie republikuje: Hermes i tak nie niesie komentarzy, wiec dla uzytkownika
to zero zmiany.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 11:51:57 +02:00

48 lines
2.3 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)
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
)