Zum Inhalt springen

App-Dokumentation · DE

SLA-Tracker

Mit dem SLA-Tracker verfolgen Sie Reaktionszeiten (Zeit bis zur ersten Reaktion) und Lösungszeiten gegen SLA-Ziele für ein beliebiges Subjekt, das durch ein Paar (Subjekt-Typ, Subjekt-ID) unter einer benannten Richtlinie identifiziert wird. Richtlinien anlegen, Reaktion/Lösung erfassen, verletzte, aber offene Tracker eskalieren und die Erfüllung berichten.

Bereiche

  • Tracker: einen Tracker per Subjekt-Typ + -ID laden, Fälligkeiten und Reaktions-/Lösungs-Breach-Badges sehen, erste Reaktion und Lösung erfassen, den Eskalations-Sweep ausführen und ein neues Subjekt tracken.
  • Richtlinien: SLA-Richtlinien auflisten und eine mit Reaktions- und Lösungszielen (in Minuten) anlegen.
  • Bericht: der SLA-Erfüllungsbericht für einen Zeitraum, optional auf einen Subjekt-Typ eingeschränkt.
  • Hilfe: In-App-Hinweise.

Felder und Begriffe

  • Richtlinie: code, name, reaction_target_minutes, resolution_target_minutes.
  • Tracker: ein zum Zeitpunkt opened_at an eine Richtlinie gebundenes Subjekt; das Backend leitet reaction_due_at und resolution_due_at ab. Das Erfassen einer Reaktion/Lösung setzt reaction_breached / resolution_breached, wenn sie nach der Fälligkeit erfolgt.
  • Eskalation: Der Sweep kennzeichnet und eskaliert jeden Tracker, der noch offen ist, noch nicht eskaliert wurde und dessen Lösungs-Fälligkeit überschritten ist.
  • Bericht: total, reaction_met, resolution_met und die beiden Erfüllungsprozentsätze (Strings mit 2 Dezimalstellen).

Backend-Vertrag

Alle Routen liegen unter /api/erp/sla, mandantenbezogen, mit der {success, data}-Hülle.

  • GET /policies — Richtlinien auflisten → {policies}.
  • POST /policies — Richtlinie anlegen. Body: {code, name, reaction_target_minutes, resolution_target_minutes}. Liefert 201 {id}.
  • POST /trackers — Tracking starten. Body: {subject_type, subject_id, policy_id, opened_at}. Liefert 201 {id}.
  • GET /trackers/{type}/{id} — einen Tracker laden, oder 404.
  • POST /trackers/{type}/{id}/response — erste Reaktion erfassen. Body: {response_at}.
  • POST /trackers/{type}/{id}/resolution — Lösung erfassen. Body: {resolved_at}.
  • POST /trackers/escalate — Eskalations-Sweep ausführen. Body: {now?} → {escalated}.
  • GET /report?from=&to=&subject_type= — Erfüllungsbericht.

Die Authentifizierung nutzt httpOnly-Cookie + CSRF über @it-tremmel.de/platform-http authedFetch (credentials: 'include'); es werden keine Tokens aus localStorage gelesen.

Typischer Ablauf

  1. Unter Richtlinien eine SLA-Richtlinie mit Reaktions- und Lösungszielen anlegen.
  2. Unter Tracker ein Subjekt unter dieser Richtlinie tracken.
  3. Erste Reaktion und Lösung erfassen; die Breach-Badges beobachten.
  4. Den Eskalations-Sweep ausführen und anschließend den Bericht für den Zeitraum prüfen.

Aktionen werden während der Bestätigung, Verarbeitung und des anschließenden Nachladens gesperrt. Mehrfaches Auslösen erzeugt keine zweite Anfrage. Nach Abschluss oder einem Fehler können Sie erneut versuchen.