Support Playbook
Date: 2026-06-03
AIS fehlt
**Typische Ursachen**
- keine AIS-Quelle
- Empfänger aus
- Signalpfad unterbrochen
**Prüfschritte**
- AIS-Ansicht prüfen
- Quellenstatus prüfen
- Verkabelung und Empfänger kontrollieren
**Nächste Schritte**
- Quelle wieder verbinden
- Status explizit als fehlend markieren
- Kunde nicht in falscher Sicherheit lassen
GPS fehlt
**Typische Ursachen**
- kein Positionssignal
- GPS-Receiver nicht aktiv
- Kabelproblem
**Prüfschritte**
- Position prüfen
- SignalK- oder NMEA-Pfad prüfen
- Bordhardware kontrollieren
**Nächste Schritte**
- Quelle wiederherstellen
- Position nicht erfinden
- Route als eingeschränkt behandeln
Routing degraded
**Typische Ursachen**
- veralteter Forecast
- kalter Cache
- nicht frische Wetterquelle
**Prüfschritte**
- Wetterlage prüfen
- Forecast-Frische prüfen
- Cache-/Upstream-Kontext prüfen
**Nächste Schritte**
- Lage als degradiert markieren
- kein falsches Live-Versprechen geben
- neu berechnen sobald möglich
SignalK down
**Typische Ursachen**
- Dienst nicht verfügbar
- Verbindung unterbrochen
- Upstream gestört
**Prüfschritte**
- Dienststatus prüfen
- Netzpfad prüfen
- Host-Health prüfen
**Nächste Schritte**
- Service wiederherstellen
- Cockpit weiter nutzbar halten
- Status klar kommunizieren
AI degraded
**Typische Ursachen**
- AI nicht provisioniert
- Backend offline
- bewusst deaktiviert
**Prüfschritte**
- AI-Seite ansehen
- Backendstatus prüfen
- Knowledge Base prüfen
**Nächste Schritte**
- AI als optional behandeln
- Coach bleibt sonst nutzbar
- keine falschen Erwartungen wecken
CAN down
**Typische Ursachen**
- kein Bus
- Adapter fehlt
- Anschluss problematisch
**Prüfschritte**
- CAN-Hardware prüfen
- Kabel prüfen
- Bus-Status prüfen
**Nächste Schritte**
- Hardwarepfad fixen
- Status nicht verschleiern
- Live-Board-Daten fehlen dann bewusst
Kundenfehler erfassen
Auf der Produktseite im FastAPI-Cockpit steht unter **Support -> Fehler melden** ein offline-faehiges Formular bereit. Es erfasst Kategorie, Prioritaet, Betreff, Beschreibung, Reproduktionsschritte, erwartetes Verhalten und optional eine Kontaktadresse. Jede Meldung bekommt eine Ticket-ID im Format KB-YYYYMMDD-XXXXXX.
Die Meldung wird lokal unter support/bug-reports.jsonl im Runtime-State gespeichert. Es findet dabei kein automatischer Upload, keine Telemetrieuebertragung und keine Weitergabe von Zugangsdaten statt. Der Kunde bzw. Supporttechniker nutzt danach **Diagnose exportieren**. Die ZIP-Datei enthaelt support/bug-reports.jsonl zusammen mit dem bereits vorhandenen Health-, Bundle- und Diagnosekontext und kann an Kiboko uebermittelt werden.
**Wichtig:** Keine Passwoerter, privaten Schluessel, Zugangstoken oder vollstaendigen Logauszuege in die Fehlerbeschreibung schreiben. Sicherheitsrelevante Stoerungen werden als kritisch markiert und zusaetzlich direkt an den vereinbarten Kiboko- Supportkontakt gemeldet.