goon/app/models/bug_report.py
jtrzupek d1f2f035b0 feat(bug-reports): two-way replies (device-scoped) + admin reply endpoint
Reports were anonymous and one-way. Tie each report to the submitting device
(X-Device-Id), add an admin response back-channel, and let the app fetch replies for
its own device:
- migration 0023: bug_reports gains device_id, response, responded_at, response_seen.
- create_bug_report captures device_id.
- GET /bug-reports/mine (device-scoped) returns this device's reports + unseen count.
- POST /bug-reports/mine/seen clears the unseen flag.
- POST /bug-reports/{id}/reply sets the admin response (authored during triage).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 11:35:44 +02:00

61 lines
2.9 KiB
Python

"""In-app bug reports — composed wewnątrz mobile, wysłane przez POST /bug-reports.
Powód: użytkownik nie może łatwo zgłaszać bugów bo Android FLAG_SECURE blokuje
screenshoty (NSFW content). Przepisywanie tytułów ręcznie z telefonu na Google
Keep jest powolne. Tu mobile sam screen capture'uje (przez react-native-view-shot
omija FLAG_SECURE) i wysyła z metadata.
"""
from __future__ import annotations
import uuid
from datetime import datetime
from sqlalchemy import DateTime, ForeignKey, String, Text, func
from sqlalchemy.dialects.postgresql import UUID
from sqlalchemy.orm import Mapped, mapped_column
from app.models.base import Base
class BugReport(Base):
__tablename__ = "bug_reports"
id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
)
created_at: Mapped[datetime] = mapped_column(
DateTime(timezone=True), server_default=func.now(), nullable=False
)
# Free-form context: {"screen": "SceneDetail", "build_version": "0.1.2", ...}
screen_name: Mapped[str | None] = mapped_column(String(64), nullable=True)
app_version: Mapped[str | None] = mapped_column(String(32), nullable=True)
# Nullable scene/movie FK — bug może być na liście, na ekranie favorites itd.
# Mobile w Player ekranie używa tego samego param `sceneId` dla movies (legacy
# progress tracking hack), więc backend smart-routes po lookup'ie: payload
# `scene_id` próbujemy najpierw jako Scene, jeśli nie ma — jako Movie.
scene_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True),
ForeignKey("scenes.id", ondelete="SET NULL"),
nullable=True,
)
movie_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True),
ForeignKey("movies.id", ondelete="SET NULL"),
nullable=True,
)
# Device który wysłał zgłoszenie (X-Device-Id). Pozwala zaadresować odpowiedź
# admina z powrotem do TEGO urządzenia (GET /bug-reports/mine). Nullable —
# legacy reports sprzed device-trackingu i klienci bez headera.
device_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
message: Mapped[str] = mapped_column(Text, nullable=False)
# PNG/JPEG bytes z react-native-view-shot, base64. Limit 1MB w API (per-request).
screenshot_b64: Mapped[str | None] = mapped_column(Text, nullable=True)
# Po obejrzeniu/naprawieniu: True. Brak osobnej tabeli statusów — single-user app.
resolved: Mapped[bool] = mapped_column(default=False, nullable=False)
# Odpowiedź admina do usera (np. "to blok regionalny po Twojej stronie"). Apka
# pokazuje ją w "Your messages" pod FAB. response_seen=false → kropka na FAB.
response: Mapped[str | None] = mapped_column(Text, nullable=True)
responded_at: Mapped[datetime | None] = mapped_column(
DateTime(timezone=True), nullable=True
)
response_seen: Mapped[bool] = mapped_column(default=False, nullable=False)