Zum Inhalt springen

App-Dokumentation · DE

Service-Tickets

Mit Service-Tickets betreiben Sie einen Support-Desk auf Basis des ServiceManager-Backends: Support-Faelle von offen bis geschlossen verfolgen, Aktivitaeten in einem Verlauf je Fall festhalten und Faelle mit einer schriftlichen Loesung abschliessen. Eine KPI-Leiste und eine Wissensdatenbank-Suche ergaenzen den Arbeitsbereich.

Bereiche

  • Faelle: eine KPI-Leiste, eine Filterzeile (Suche + Status + Prioritaet), die Fallliste und ein Formular fuer einen neuen Fall. Beim Oeffnen eines Falls werden die Details, der Aktivitaetsverlauf, ein Kommentarfeld und das Formular zum Schliessen mit Loesung angezeigt.
  • Wissensdatenbank: veroeffentlichte Hilfeartikel durchsuchen.
  • Hilfe: In-App-Hinweise.

Felder und Begriffe

  • Fall: customer_id, optional contract_id, title, optional description, priority (low|normal|high|urgent), optional channel und ein Lebenszyklus-status (open|in_progress|waiting|resolved|closed).
  • Ereignis: ein Verlaufseintrag. Diese App fuegt comment-Ereignisse hinzu; das Backend unterstuetzt zudem status_change, assignment und time_log.
  • Kennzahlen: openCases, avgResolutionHours, contractsActive, timeBudgetUtilization.

Backend-Vertrag

Alle Routen liegen unter /api/service-manager, mandantenbezogen, mit dem {success, data}-Umschlag.

  • GET /cases — Faelle auflisten.
  • POST /cases — Fall erstellen. Body (snake_case): {customer_id, contract_id?, title, description?, priority?, channel?}. Liefert 201 oder 422 bei Validierungsfehlern.
  • GET /cases/{id} — einen Fall lesen.
  • POST /cases/{id}/events — ein Ereignis anhaengen. Body: {type, payload}. Liefert {id, events: [...]}.
  • POST /cases/{id}/close — mit einer Loesung schliessen. Body: {resolution}.
  • GET /kpis?from=&to= — KPI-Momentaufnahme.
  • GET /knowledge/search?q= und GET /knowledge — Wissensdatenbank suchen / auflisten.

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

Typischer Ablauf

  1. KPI-Leiste pruefen und die Fallliste filtern.
  2. Einen Fall mit Kunden-ID, Titel und Prioritaet erstellen. Solange die Anfrage laeuft, bleibt die Schaltflaeche gesperrt; dadurch wird derselbe Fall bei langsamer Verbindung nicht doppelt angelegt.
  3. Einen Fall oeffnen, Kommentare zum Verlauf hinzufuegen und ihn mit einer Loesung schliessen.
  4. Waehrend der Bearbeitung die Wissensdatenbank nach passenden Artikeln durchsuchen.