Benachrichtigungen

Benachrichtigungen

Das Basetool hat einen eingebauten Benachrichtigungs-Posteingang. Wenn etwas passiert, das dich betrifft — ein neuer Auftrag in deiner Einheit, ein Bankantrag, eine neue Discord-Anmeldung — bekommst du eine In-App-Benachrichtigung. Alles spielt sich innerhalb des Tools ab: Es gibt keine E-Mail-, Discord- oder Browser-Push-Benachrichtigungen.

Jede Benachrichtigung gehört genau dir. Dein Posteingang ist privat — niemand sonst sieht deine Benachrichtigungen, und du siehst keine fremden. Wer eine Benachrichtigung erhält, entscheidet ein regelbasiertes System (siehe Wann wirst du benachrichtigt?).

Die Glocke oben rechts

Auf jeder angemeldeten Seite sitzt oben rechts ein Glocken-Symbol. Solange du ungelesene Benachrichtigungen hast, zeigt die Glocke einen Zähler/eine Markierung.

• Zähler bleibt aktuell: Der ungelesene Zähler wird im Hintergrund regelmäßig nachgeladen (Polling) und nach jeder Aktion frisch vom Server geholt — er kann also nicht veralten. Zusätzlich gibt es eine Echtzeit-Push-Schicht (Server-Sent Events): Trifft eine neue Benachrichtigung ein, aktualisiert sich die Glocke sofort. Der Push ist „best effort"; das regelmäßige Nachladen ist der garantierte Rückfall, falls der Live-Stream einmal nicht durchkommt.
• Dropdown: Ein Klick auf die Glocke öffnet ein Dropdown mit deinen jüngsten Benachrichtigungen. Die Liste wird erst beim Öffnen geladen.
• Alle als gelesen markieren: Im Dropdown kannst du alle ungelesenen Benachrichtigungen auf einen Schlag als gelesen markieren — der Zähler verschwindet.

Die Übersichtsseite /notifications

Über die Glocke (bzw. direkt unter /notifications) erreichst du die vollständige Liste deiner Benachrichtigungen. Hier kannst du:

Aktion	Wirkung
Einzelne als gelesen markieren	Setzt genau diese Benachrichtigung auf gelesen.
Alle als gelesen markieren	Markiert alle ungelesenen auf einmal.
Einzelne löschen	Entfernt eine Benachrichtigung dauerhaft — egal ob gelesen oder ungelesen.
Gelesene aufräumen	Löscht alle bereits gelesenen Benachrichtigungen in einem Schritt.

Löschen ist jederzeit möglich und unabhängig vom automatischen Aufräumen (siehe unten). Da der Posteingang an dein Konto gebunden ist, kannst du nur deine eigenen Benachrichtigungen lesen, markieren oder löschen.

Automatisches Aufräumen (~90 Tage)

Damit der Posteingang nicht zuläuft, löscht ein geplanter Hintergrundlauf gelesene Benachrichtigungen, die älter als der konfigurierte Höchstwert sind (Standard: 90 Tage). Ungelesene Benachrichtigungen bleiben erhalten, egal wie alt. Dein manuelles Löschen ist davon getrennt — du kannst eigene Benachrichtigungen jederzeit selbst entfernen.

Wann wirst du benachrichtigt?

Wer welche Benachrichtigung bekommt, legt ein regelbasiertes System fest, das Admins zur Laufzeit konfigurieren. Eine Aktion im Tool löst ein Ereignis aus; Regeln entscheiden, welche Nutzer es erreicht. So lässt sich ein neuer Auslöser ergänzen, ohne dass am Code geschraubt werden muss.

Empfänger werden über Selektoren bestimmt — z. B. „eine bestimmte Person", „alle mit einer bestimmten Rolle", „die Offiziere/Leads/Logistiker der zuständigen Einheit", „die für ein Bankkonto berechtigten Bankmitarbeiter" oder „der konkrete Adressat des Ereignisses". Die Person, die die Aktion selbst auslöst, wird üblicherweise ausgenommen — du benachrichtigst dich nicht selbst.

Diese Auslöser sind aktuell eingebaut (die Regeln dahinter sind admin-editierbar):

Auslöser	Wer wird benachrichtigt?
Neuer Warenauftrag angelegt	Offiziere der zuständigen Staffel bzw. Leads des zuständigen Spezialkommandos, die Logistiker dieser Einheit und die Admins — ohne die Person, die den Auftrag erstellt hat. Siehe Warenauftraege.
Bank-Ein-/Auszahlungsantrag angelegt	Die Bankleitung und die für das betroffene Konto berechtigten Bankmitarbeiter (über den Konto-Bezug, nicht über eine Einheit). Siehe Kartellbank.
Bankantrag bestätigt oder abgelehnt	Der antragstellende Offizier/Lead, der den Antrag gestellt hat. Bei einer Ablehnung wird der Grund in der Benachrichtigung angezeigt.

Außerdem informiert das System über kontorelevante Vorgänge (z. B. Kontofreigaben), für die ebenfalls die Bank-Selektoren greifen. Welche Auslöser konkret aktiv sind, hängt von den geseedeten und admin-gepflegten Regeln ab — bei Abweichungen zählt immer der Code.

Hinweis für Offiziere: Offiziersstatus stammt aus deiner Keycloak-Rolle und wird ins Tool gespiegelt. Wirst du frisch zum Offizier befördert, wirst du erst nach dem nächsten Rollen-Abgleich (bis zu 5 Minuten) zum Empfänger der entsprechenden Regeln.

Discord-Anmeldungen (für Admins)

Reicht sich jemand neu über Discord an und wartet auf Freigabe, werden die zuständigen Stellen über das Benachrichtigungssystem informiert, damit die Anmeldung nicht liegen bleibt. Die Freigabe selbst läuft über den Admin-Bereich — siehe Discord-Anmeldung und Administration.

Regeln verwalten (Admins)

Admins konfigurieren die Empfänger-Regeln zur Laufzeit unter /admin/notification-rules („Notification rules"). Dort lassen sich Regeln anlegen, bearbeiten, aktivieren/deaktivieren und löschen, jeweils mit einem Editor für die Selektoren (welche Personen/Rollen/Einheiten eine Regel adressiert). Die Regelverwaltung ist Admin-only. Mehr dazu unter Administration.

Wer	Eigener Posteingang lesen/aufräumen	Benachrichtigungs-Regeln verwalten
Jede angemeldete Person	✅	❌
Admin	✅	✅

Die maßgebliche Rechte-Matrix steht in ROLES_AND_PERMISSIONS.md. Bei Abweichungen zählt immer der Code.

Gut zu wissen

• Sprache: Benachrichtigungen werden nicht in einer festen Sprache gespeichert, sondern erst beim Anzeigen in deine Sprache übersetzt.
• Zeiten: Zeitpunkte werden intern in UTC gespeichert und in lokaler Zeit (Europe/Berlin) angezeigt.
• Quelle gelöscht? Eine Benachrichtigung bleibt lesbar, auch wenn das ursprüngliche Objekt (z. B. der Auftrag) später entfernt wurde.

Verwandte Seiten

• Warenauftraege — löst die Standard-Auftragsbenachrichtigung aus
• Kartellbank — Antrags- und Kontobenachrichtigungen
• Discord-Anmeldung — neue Anmeldungen zur Freigabe
• Administration — Regelverwaltung
• Rollen-und-Berechtigungen — wer welche Rolle hat