Notification-Modul - Administrator Handbuch¶

Überblick¶

Das Notification-Modul ermöglicht es, Push-Nachrichten an Mitglieder zu senden. Die Nachrichten werden über Firebase an mobile Apps und Web-Browser der Benutzer übertragen.

Hauptbereiche des Moduls¶

1. Notifications (Benachrichtigungen)¶

Menüpunkt: Notifications → Notifications

Hier erstellen und verwalten Sie Nachrichten, die an Mitglieder gesendet werden können.

Neue Nachricht erstellen¶

1. Klicken Sie auf "Notification hinzufügen"
2. Füllen Sie folgende Felder aus:
3. Subject (Betreff): Kurzer Titel der Nachricht
4. Message (Nachricht): Der eigentliche Nachrichtentext
5. Users (Benutzer): Spezifische Benutzer auswählen (optional)
6. Group (Gruppe): Nachricht an eine komplette Benutzergruppe senden (optional)
7. Work Assignment (Arbeitseinsatz): Nachricht an alle Teilnehmer eines bestimmten Arbeitseinsatzes (optional)

Nachricht versenden¶

Nach dem Erstellen einer Nachricht haben Sie zwei Möglichkeiten:

Option 1: Über die Nachrichtenliste 1. Gehen Sie zur Notifications-Liste 2. Klicken Sie in der entsprechenden Zeile auf "Send Now"

Option 2: Über die Nachrichtenbearbeitung 1. Öffnen Sie die gewünschte Nachricht zur Bearbeitung 2. Klicken Sie auf den Button "Nachricht senden" (öffnet sich in neuem Tab)

Was passiert im Hintergrund beim Versenden?¶

1. Das System ermittelt die Empfänger basierend auf Ihrer Auswahl
2. Eine Hintergrundaufgabe (Celery Task) wird gestartet
3. Firebase sendet die Push-Nachrichten an alle Geräte der Empfänger
4. Jede gesendete Nachricht wird im Notification Log protokolliert
5. Ungültige Geräte-Tokens werden automatisch aus dem System entfernt

2. Notification Tokens (Geräte-Tokens)¶

Menüpunkt: Notifications → Notification tokens

Hier werden die technischen Tokens verwaltet, die für das Senden von Push-Nachrichten an die Geräte der Benutzer benötigt werden.

Übersicht¶

• User: Welcher Benutzer besitzt das Token
• Token: Technischer Identifier des Geräts (sehr langer Text)
• Created at / Updated at: Zeitstempel der Token-Erstellung/-Aktualisierung

Token löschen¶

Ungültige oder alte Tokens können gelöscht werden: 1. Token in der Liste auswählen 2. "Löschen" wählen

3. Notification Logs (Versendungsprotokoll)¶

Menüpunkt: Notifications → Notification logs

Das Protokoll aller versendeten Nachrichten - nur zur Ansicht.

Übersicht¶

• User: An welchen Benutzer die Nachricht gesendet wurde
• Title: Betreff der Nachricht
• Body: Inhalt der Nachricht
• Sent at: Zeitpunkt der Versendung

Suchen und Filtern¶

• Suche: Nach Titel, Nachrichtentext oder Benutzername
• Filter: Nach Versendungsdatum oder Benutzer
• Datumsnavigation: Schneller Zugriff auf Nachrichten bestimmter Tage/Monate

Häufige Arbeitsabläufe¶

Nachricht an alle Mitglieder senden¶

1. Notifications → Notification hinzufügen
2. Subject und Message ausfüllen
3. Keine Benutzer, Gruppe oder Arbeitseinsatz auswählen
4. Speichern
5. "Send Now" klicken

Nachricht an bestimmte Gruppe senden¶

1. Notifications → Notification hinzufügen
2. Subject und Message ausfüllen
3. Bei "Group" die gewünschte Gruppe auswählen
4. Speichern
5. "Send Now" klicken

Nachricht an Arbeitseinsatz-Teilnehmer senden¶

1. Notifications → Notification hinzufügen
2. Subject und Message ausfüllen
3. Bei "Work Assignment" den entsprechenden Arbeitseinsatz auswählen
4. Speichern
5. "Send Now" klicken

Fehlerbehebung¶

Nachricht kommt nicht an¶

1. Prüfen Sie das Notification Log, ob die Nachricht versendet wurde
2. Kontrollieren Sie bei Notification Tokens, ob der Benutzer ein gültiges Token hat
3. Der Benutzer muss die App geöffnet und Push-Nachrichten erlaubt haben

Token werden nicht angezeigt¶

Tokens werden erst erstellt, wenn sich Benutzer in der mobilen App oder im Web-Interface anmelden und Push-Nachrichten aktivieren.