Hilfeanfragen

Hilfeanfragen sind das in Aptli integrierte System zur Verfolgung von Problemen und Supportanfragen. Jeder Benutzer kann eine Hilfeanfrage direkt von der Detailseite eines Datensatzes aus stellen — die Anfrage wird automatisch an diesen Datensatz angehängt, sodass es nie Unklarheiten darüber gibt, worum es geht. Administratoren verwalten die Warteschlange über das Admin-Panel.

Hilfeanfrage-Panel

Wer nutzt Hilfeanfragen?

Rolle	Aufgaben
Alle Benutzer	Öffnen das Hilfepanel von der Detailseite eines Datensatzes, um eine Anfrage zu diesem Datensatz zu stellen
Administrator	Überprüft die Warteschlange, aktualisiert den Status und löst Anfragen

Eine Hilfeanfrage einreichen (von einem beliebigen Datensatz)

Die Detailseite jedes Datensatzes (/[entity]/[id]) hat eine Schaltfläche Um Hilfe bitten in der Kopfzeile — suchen Sie nach dem badge-help-Symbol. Dies gilt für Projekte, Berichte, Aufgaben, Arbeitsaufträge, Validierungen, Standorte, Ressourcen und Bestandsartikel.

Schritte:

Eine beliebige Detailseite öffnen (z. B. eine Aufgabe, einen Arbeitsauftrag oder ein Benutzerprofil)
Im Seitenkopf auf Um Hilfe bitten klicken
Ein Einschub auf der rechten Seite öffnet sich — der Datensatz ist bereits als Ziel angehängt (als schreibgeschützter Chip im Feld „Bezug” angezeigt)
Die Felder ausfüllen:
- Titel (erforderlich) — eine kurze, klare Beschreibung des Problems
- Beschreibung — Schritte zur Reproduktion oder zusätzlicher Kontext
- Zielrolle — welches Team dies bearbeiten soll (durchsuchbares Dropdown; optional — leer lassen für beliebigen Admin)
- Dringlichkeit — Niedrig / Mittel / Hoch / Kritisch
- Anhänge — optionale Fotos oder Dateien
- Zielrolle benachrichtigen — optionales Kontrollkästchen, um die Zielrolle sofort per E-Mail zu informieren
Auf Einreichen klicken

Die Kontext-URL wird still erfasst, damit Admins direkt zur Seite zurückspringen können, auf der die Anfrage gestellt wurde.

Kein Overlay — Weiterarbeiten während Sie schreiben

Das Hilfepanel öffnet sich als rechtsseitiger Einschub ohne Modal-Overlay, sodass Sie den Datensatz dahinter noch scrollen, lesen und Text kopieren können, während Sie Ihre Beschreibung schreiben. Schließen Sie das Panel — Ihre Bearbeitungen am Datensatz bleiben unberührt.

Badge für zugehörige Hilfeanfragen

Jeder Datensatz, der Hilfeanfragen akzeptiert, zeigt ein aggregiertes Hilfeanfrage-Badge neben der Schaltfläche „Um Hilfe bitten”. Das Badge fasst offene Anfragen zu diesem spezifischen Datensatz auf einen Blick zusammen.

Grau / null — keine zugehörigen Anfragen
Farbig / Anzahl — eine oder mehrere Anfragen; beim Darüberfahren mit der Maus wird eine Statusaufschlüsselung eingeblendet

Ein Klick auf das Badge springt zur gefilterten Listenansicht, beschränkt auf diesen Datensatz.

Einen Datensatz in einer Anfrage teilen

Jede Detailseite hat auch eine Schaltfläche Teilen, die einen Kurzlink (z. B. /help/:id) in die Zwischenablage kopiert. Fügen Sie ihn überall ein — Slack, E-Mail oder die Beschreibung einer anderen Hilfeanfrage — und er löst sich für jeden, der ihn öffnet, zum genauen Datensatz auf.

Dringlichkeitsstufen

Stufe	Wann zu verwenden
Niedrig	Wünschenswert, kein Zeitdruck
Mittel	Beeinträchtigt den Arbeitsablauf, aber es gibt eine Umgehungslösung
Hoch	Behindert produktives Arbeiten
Kritisch	Verursacht Datenverlust oder Systemausfall

Ältere Anfragen mit numerischen Dringlichkeitswerten werden beim Lesen automatisch auf die neuen Bezeichnungen abgebildet — keine Migration erforderlich.

Admin: Verwaltung der Warteschlange

Navigieren Sie zu Admin → Hilfeanfragen (/admin/help-requests), um alle eingereichten Anfragen anzuzeigen.

Filtern

Verwenden Sie die Filterleiste oben, um nach Titel oder Beschreibung zu suchen
Verwenden Sie den Statusfilter — standardmäßig auf Offen gesetzt, damit Admins zuerst die handlungsfähigen Anfragen sehen. Weitere Optionen: Committed, Deferred, Failed, Resolved
Aktivieren Sie oben rechts Gelöschte anzeigen, um archivierte Anfragen einzublenden
Verwenden Sie Meine Anfragen (Link oben im Panel), um nur Anfragen anzuzeigen, die Sie selbst gestellt haben

Eine Anfrage anzeigen

Klicken Sie auf den Erweiterungspfeil in einer beliebigen Zeile, um die vollständigen Anfragedetails anzuzeigen, darunter:

E-Mail-Adresse des Anfragenden und Einreichungsdatum
Angehängter Datensatz (das Ziel — als Link dargestellt)
Kontext-URL (die Seite, auf der sich der Benutzer beim Einreichen befand)
Beschreibung und Anhänge
Zugewiesene Zielrolle
Aktueller Status und Dringlichkeit

Eine Anfrage aktualisieren

In der aufgeklappten Ansicht können Administratoren:

Den Status ändern (siehe Lebenszyklus unten)
Die Zielrolle neu zuweisen
Die Dringlichkeit anpassen, wenn die ursprüngliche Einschätzung nicht zutreffend war
Eine Lösungsnotiz, gelöst von und gelöst am erfassen (wird automatisch ausgefüllt, wenn Sie „Resolved” setzen)

Änderungen mit der Schaltfläche Änderungen einreichen speichern (Cloud-Upload-Symbol, oben rechts). Änderungen werden sofort wirksam.

Lebenszyklus einer Anfrage

open → committed (Arbeit begonnen)
     → deferred  (bestätigt, noch nicht terminiert)
     → failed    (konnte nicht gelöst werden)
     → resolved  (abgeschlossen — erfasst resolvedAt/resolvedBy/resolutionNote)

Status	Bedeutung
Open	Neu eingereicht, noch nicht geprüft
Committed	Administrator hat akzeptiert und mit der Arbeit begonnen
Deferred	Protokolliert, aber derzeit nicht umsetzbar
Failed	Lösung wurde versucht, aber ohne Erfolg
Resolved	Abgeschlossen — Lösungsnotiz, gelöst-von und gelöst-am werden erfasst

Eine Anfrage abschließen

Klicken Sie in der aufgeklappten Ansicht auf Abschließen, um das Abschließen-Modal zu öffnen. Geben Sie eine Lösungsnotiz ein, die zusammenfasst, was getan wurde, und bestätigen Sie — die Anfrage wechselt zu resolved, gestempelt mit Ihrem Benutzer und Zeitstempel. Der Anfragende sieht die Lösungsnotiz, wenn er die Anfrage erneut aufruft.

Massenaktionen

Wählen Sie mehrere Zeilen mithilfe der Kontrollkästchen aus, um:

Massenlöschung oder Massenwiederherstellung von Anfragen
Massenaktualisierung gemeinsamer Eigenschaften über die Einstellungen-Schaltfläche (Zahnrad) in der schwebenden Symbolleiste

Sicherheit — Anfragender wird serverseitig erzwungen

Der Anfragende einer Hilfeanfrage wird serverseitig aus der Sitzung gesetzt. Ein Benutzer kann beim Einreichen keinen anderen Benutzer als Anfragenden vortäuschen. Admin-Bearbeitungen ändern den ursprünglichen Anfragenden nicht.

Tipps

Öffnen Sie das Panel vom tatsächlichen Datensatz aus — der angehängte Datensatz bedeutet, dass der Admin nie fragen muss: „Um welchen Datensatz geht es?”
Seien Sie im Titel konkret. „Karte wird auf Standort S-42 nicht geladen” ist aussagekräftiger als „Kartenproblem.”
Verwenden Sie Zielrolle, wenn Sie wissen, welches Team für diese Art von Problem zuständig ist — das hilft Admins, schneller eine Priorität zu setzen
Kritische Anfragen sollten auch direkt kommuniziert werden (Telefon, Nachricht) — die Warteschlange in der App ist kein Echtzeit-Warnsystem
Zielrolle benachrichtigen ist nützlich für dringende Probleme, bei denen das Admin-Team sofort alarmiert werden soll
Abgeschlossene Anfragen verbleiben im System — filtern Sie nach Resolved (oder Gelöschte anzeigen), um historische Abschlüsse nachzuschlagen