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

# Bugtracker

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

![Bugtracker](/documentation/blume-assets/content/docs/img/screenshots/13-audit-log.png)

## Ü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)

| Status | Bedeutung |
|--------|---------|
| **Neu** | Frisch eingereicht, noch nicht geprüft |
| **Behoben** | Problem gelöst (Code-Fix, Konfigurationsänderung usw.) |
| **Wird nicht behoben** | Kein Bug, so gewollt oder außerhalb des Umfangs |

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:

```bash
# 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

| Methode | Pfad | Zugriff |
|--------|------|--------|
| `GET` | `/api/v1/bug-reports` | Alle angemeldeten Benutzer |
| `GET` | `/api/v1/bug-reports/{id}` | Alle angemeldeten Benutzer |
| `PATCH` | `/api/v1/bug-reports/{id}` | System-Administrator |

### PATCH-Body

```json
{
  "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

| Rolle | Kann ansehen | Kann Status ändern |
|------|-----------|-------------------|
| Mitglied | ✅ | ❌ |
| Workspace-Administrator | ✅ | ❌ |
| System-Administrator | ✅ | ✅ |

## 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