Bugtracker

Instanzweite Fehlerberichte, die über PostHog-Umfragen eingereicht werden. Alle angemeldeten Benutzer können sie einsehen; System-Administratoren…

Instanzweite Fehlerberichte, die über PostHog-Umfragen eingereicht werden. Alle angemeldeten Benutzer können sie einsehen; System-Administratoren verwalten den Status.

Überblick

Die Seite Bugtracker zeigt eine Tabelle aller Fehlerberichte der Instanz.

Spalten:

• Titel — Aus der Umfrageantwort
• Status — Neu / Behoben / Wird nicht behoben
• Person — Benutzer, der den Bericht eingereicht hat (falls identifizierbar)
• Erstellt — Zeitstempel
• Aktionen — Details ansehen (alle), Status setzen (System-Administrator)

Fehlerberichte ansehen

1. In der Seitenleiste Bugtracker öffnen (für alle angemeldeten Benutzer sichtbar)
2. Die Tabelle lädt automatisch
3. In einer beliebigen Zeile auf Details anzeigen klicken → Dialog mit dem vollständigen Bericht

Der Detaildialog zeigt

• Vollständige Fehlerbeschreibung
• Angaben zur meldenden Person (E-Mail, Workspace, Rolle)
• Browser-/Umgebungs-Metadaten
• Status + optionaler Administrator-Kommentar
• System-Administrator: Status-Dropdown + Kommentarfeld

Statusverwaltung (nur System-Administrator)

So aktualisierst du den Status:

1. Detaildialog öffnen
2. Neuen Status im Dropdown auswählen
3. Optional: Kommentar hinzufügen (im Dialog sichtbar)
4. Auf Speichern klicken

Änderungen werden im Audit-Log protokolliert (bug_report.status_changed).

Wie Berichte entstehen

Anbindung der PostHog-Umfrage

1. Benutzer stößt auf ein Problem → klickt auf „Report Bug“ (oder automatische Aufforderung)
2. Die PostHog-Umfrage „Bug report“ wird angezeigt
3. Benutzer füllt aus: Titel, Beschreibung, Schweregrad, Schritte zur Reproduktion
4. Beim Absenden → PostHog-Webhook → POST /api/v1/bug-reports/webhook
5. Fehlerbericht wird in der Datenbank angelegt

Historische Berichte nachladen

Mit dem Skill bugtracker-backfill importierst du frühere Umfrageantworten:

# From PostHog MCP or script
python .opencode/skills/bugtracker-backfill/backfill.py

Der Import erkennt keine Duplikate — spiele nur Antworten ein, die noch nicht vorhanden sind.

API-Endpunkte

PATCH-Body

{
  "status": "fixed",
  "adminComment": "Fixed in v0.9.250 — was a race condition in SSE handler"
}

Konfiguration

Umgebungsvariable:

• BUGTRACKER_WEBHOOK_SECRET — Validiert PostHog-Webhook-Aufrufe

Berechtigungen

Letzte Änderungen

• Bugtracker-Seite — Instanzweite Tabelle der Fehlerberichte mit Detaildialog
• PostHog-Webhook — Automatische Übernahme aus „Bug report“-Umfragen
• Status-Workflow — Neu → Behoben / Wird nicht behoben, mit Administrator-Kommentaren
• Backfill-Skill — Historische Umfrageantworten importieren