UC07 – Benachrichtigungen
Stand : 2026-08-01, 11:12:55
Branch: main
Status: Abgeschlossen
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 01.08.2026 11:12 |
1.0 |
Kopfbereich ergänzt |
David |
Spezifikationsdatei – Leitdokument für Entwicklung, Testing und Abnahme
Stand: Mai 2026 | Version: 0.1
Autor: David | Review: offen
Status-Übersicht
| Schritt |
Bezeichnung |
Status |
Kommentar |
| 1 |
Steckbrief |
✅ Erstellt |
fachlicher Rahmen für UC07 definiert |
| 2 |
Scope & Abgrenzung |
✅ Erstellt |
Benachrichtigung, Versand und Protokollierung abgegrenzt |
| 3 |
Rollenmodell |
🟡 In Bearbeitung |
tenant_admin und mitarbeiter vorbereitet |
| 4 |
Benachrichtigungsarten |
🟡 In Bearbeitung |
Fristen, Prüfungen, Portal und Systemhinweise vorbereitet |
| 5 |
Kanalmodell |
🟡 In Bearbeitung |
E-Mail V1, Portal vorbereitet, Push später |
| 6 |
Versandstatus / Wiederholung |
🟡 In Bearbeitung |
Grundmodell erstellt |
| 7 |
Datenmodell-Vorbereitung |
🟡 In Bearbeitung |
Regeln, Vorlagen und Log vorbereitet |
| 8 |
Screen-Flow BN-01 bis BN-08 |
⬜ Offen |
Screen-Dokumente noch nicht erstellt |
| 9 |
Review / Quality Gate |
⬜ Offen |
nach Screen-Ausarbeitung durchführen |
Legende: ✅ Erstellt | 🟡 In Bearbeitung | 🔴 Blockiert | ⬜ Offen
1. Steckbrief
| Feld |
Inhalt |
| UC-ID |
UC07 |
| Name |
Benachrichtigungen |
| Version |
V1 MVP |
| Zielgruppe |
Tauchschule |
| Primärakteur |
tenant_admin |
| Sekundärakteur |
mitarbeiter |
| Betroffener Akteur |
kunde |
| Systemakteur |
Benachrichtigungsmodul / Versanddienst |
| Reifegrad V1 |
fachliche Spezifikation gestartet |
| Priorität |
Hoch |
1.1 Ziel
UC07 stellt die Benachrichtigungslogik für DiveLogix360 bereit.
Das Modul soll Benachrichtigungen aus fachlichen Auslösern vorbereiten, prüfen, versenden und protokollieren. Für V1 liegt der Schwerpunkt auf Fristenbenachrichtigungen aus UC05, insbesondere für bald fällige, heute fällige, überfällige oder gesperrte Equipment-Fristen.
UC07 übernimmt damit das, was UC05 nur vorbereitet: Versandlogik, Empfängerprüfung, Nachrichtenvorlagen, Kanalsteuerung, Versandstatus und Protokollierung.
2. Scope & Abgrenzung
2.1 Gehört zu UC07 V1
| Bereich |
Enthalten |
| Fristenbenachrichtigungen aus UC05 |
Ja |
| manuelle Versandfreigabe durch berechtigten Benutzer |
Ja |
| Vorschau vor Versand |
Ja |
| E-Mail-Kanal |
Ja, V1-Kern |
| Portal-Hinweis vorbereiten |
Ja, abhängig von UC06 |
| Push-Benachrichtigung |
Nein, später UC12 |
| Versandstatus führen |
Ja |
| Versandprotokoll führen |
Ja |
| Wiederholungslogik vorbereiten |
Ja, einfache V1-Regeln |
| Empfängerprüfung |
Ja |
| Datenschutz- und Einwilligungsprüfung vorbereiten |
Ja |
| Benachrichtigungsvorlagen |
Ja, einfache V1-Vorlagen |
| tenant-spezifische Texte |
vorbereitet, Umfang offen |
2.2 Gehört nicht zu UC07 V1
| Bereich |
Hinweis |
| Marketing-Newsletter |
nicht Bestandteil V1 |
| Push-Benachrichtigung |
später UC12 |
| komplexe Kampagnensteuerung |
nicht V1 |
| frei programmierbare Automationsregeln |
später prüfen |
| vollständiges Template-Studio |
nicht V1 |
| SMS / WhatsApp-Versand |
nicht V1 |
| Rechnungs- oder Zahlungsbenachrichtigungen |
nicht V1 |
| externe Kommunikationsplattformen |
später prüfen |
3. Bezug zu anderen Use Cases
| UC |
Bezug |
| UC05 – Fristen-Dashboard |
liefert Fristdaten und Benachrichtigungsvorschläge |
| UC06 – Kunden einladen & Portal |
stellt Kundenzugang und Portal-Hinweise bereit |
| UC08 – Benutzerverwaltung |
regelt interne Benutzer, Rollen und Berechtigungen |
| UC09 – Berichte & Export |
kann Benachrichtigungslisten und Versandprotokolle exportieren |
| UC01 – Equipment erfassen |
liefert Equipment- und Kundenzuordnung |
| UC02 – TÜV-Inspektion einreichen |
liefert Prüfstatus und Fristgrundlagen |
| UC12 – Push-Benachrichtigungen |
spätere Erweiterung für Push-Kanäle |
4. Rollenmodell V1
| Rolle |
Bedeutung für UC07 |
tenant_admin |
konfiguriert Grundregeln, prüft Vorschläge, versendet und sieht Protokolle |
mitarbeiter |
darf operative Benachrichtigungen vorbereiten oder versenden, falls Tenant erlaubt |
kunde |
erhält Benachrichtigungen, aber nutzt keine interne UC07-Ansicht |
superadmin |
nicht Zielnutzer des Tenant-Moduls; Plattformregeln später in UC-SA |
4.1 Rollenrechte V1
| Aktion |
tenant_admin |
mitarbeiter |
kunde |
| Benachrichtigungsübersicht öffnen |
Ja |
Ja / optional |
Nein |
| Vorschläge prüfen |
Ja |
Ja |
Nein |
| Benachrichtigungsvorschau öffnen |
Ja |
Ja |
Nein |
| Einzelbenachrichtigung versenden |
Ja |
optional |
Nein |
| Sammelversand auslösen |
Ja |
optional / offen |
Nein |
| Vorlagen bearbeiten |
Ja |
Nein / offen |
Nein |
| Versandprotokoll sehen |
Ja |
Ja / eingeschränkt |
Nein |
| Regeln konfigurieren |
Ja |
Nein |
Nein |
5. Benachrichtigungsarten V1
| Art |
Beschreibung |
V1 |
due_soon |
Frist wird bald fällig |
Ja |
due_today |
Frist ist heute fällig |
Ja |
overdue |
Frist ist überfällig |
Ja |
blocked |
Equipment ist gesperrt oder darf nicht genutzt werden |
Ja |
in_progress |
Prüf- oder Serviceprozess läuft |
vorbereitet |
unknown_due |
Fristdaten sind unklar oder fehlen |
intern, vorbereitet |
portal_invitation |
Kunde wird in Portal eingeladen |
Bezug zu UC06 |
system_notice |
interne Systemhinweise |
später prüfen |
6. Kanalmodell
| Kanal |
Beschreibung |
V1 |
| E-Mail |
primärer Versandkanal für Kunden- und interne Hinweise |
Ja |
| Portal |
Hinweis im Kundenportal, abhängig von UC06 |
vorbereitet |
| In-App intern |
Hinweis für tenant_admin / mitarbeiter |
vorbereitet |
| Push |
mobile Push-Benachrichtigung |
Nein, UC12 |
| SMS |
Kurznachricht |
Nein |
| WhatsApp |
externer Messenger |
Nein |
6.1 Kanalregeln V1
| Regel |
Beschreibung |
| E-Mail benötigt gültige Empfängeradresse |
ohne E-Mail kein E-Mail-Versand |
| Portal setzt aktiven Kundenportalzugang voraus |
Bezug zu UC06 |
| Push ist nicht V1 |
spätere Erweiterung |
| Kanal muss pro Benachrichtigung protokolliert werden |
wichtig für Nachvollziehbarkeit |
| fehlender Kanal blockiert Versand |
Status blocked oder needs_review |
7. Versandstatus
| Status |
Bedeutung |
draft |
Benachrichtigung wurde vorbereitet, aber nicht freigegeben |
ready |
Benachrichtigung ist versandbereit |
needs_review |
Daten oder Inhalt müssen geprüft werden |
blocked |
Versand nicht möglich |
queued |
Versand wurde ausgelöst und steht in Warteschlange |
sent |
Versand erfolgreich |
failed |
Versand fehlgeschlagen |
cancelled |
Versand wurde verworfen |
skipped |
Versand bewusst übersprungen |
8. Wiederholungs- und Eskalationslogik
8.1 V1-Grundmodell
| Auslöser |
mögliche Regel |
| bald fällig |
einmalige Erinnerung z. B. 30 Tage vorher |
| heute fällig |
optionale Erinnerung am Fälligkeitstag |
| überfällig |
erneute Erinnerung nach definierter Zeit |
| gesperrt |
interne Warnung / Eskalation |
| Versand fehlgeschlagen |
erneuter Versuch oder Status failed |
8.2 Abgrenzung V1
Für V1 soll die Wiederholungslogik einfach bleiben. Komplexe Serien, frei definierbare Intervalle oder Kampagnenlogik werden nicht umgesetzt.
9. Nachrichtenvorlagen V1
| Vorlage |
Zweck |
| Frist bald fällig |
Kunde oder intern wird über kommende Prüfung informiert |
| Frist heute fällig |
Hinweis auf Fälligkeit am aktuellen Tag |
| Frist überfällig |
Hinweis auf überschrittene Frist |
| Equipment gesperrt |
Hinweis auf Sperrstatus / Handlungsbedarf |
| Daten prüfen |
interner Hinweis auf unklare Fristdaten |
9.1 Platzhalter
| Platzhalter |
Bedeutung |
customer_name |
Name des Kunden |
equipment_label |
Equipment-Bezeichnung |
equipment_type |
Equipment-Typ |
due_date |
Fälligkeitsdatum |
days_until_due |
Tage bis Frist |
days_overdue |
Tage seit Überschreitung |
tenant_name |
Name der Tauchschule |
portal_link |
späterer Portal-Link, falls UC06 aktiv |
10. Datenmodell-Vorbereitung
10.1 Mögliche Tabellen / Bereiche
| Bereich |
Bedeutung |
notification_rules |
tenant-spezifische Benachrichtigungsregeln |
notification_templates |
Nachrichtenvorlagen |
notification_queue |
ausstehende oder geplante Benachrichtigungen |
notification_log |
Versandprotokoll |
notification_recipients |
Empfänger und Kanalstatus |
notification_preferences |
spätere Empfängerpräferenzen |
audit_log |
sicherheitsrelevante Aktionen |
10.2 Wichtige Felder
| Feld |
Beschreibung |
tenant_id |
Tenant-Isolation |
source_uc |
z. B. UC05 |
source_entity_id |
Frist, Equipment oder Workflow |
recipient_type |
Kunde, Mitarbeiter, Tenant-Admin |
recipient_id |
Empfängerreferenz |
channel |
E-Mail, Portal, intern |
template_id |
verwendete Vorlage |
status |
Versandstatus |
scheduled_at |
geplanter Versandzeitpunkt |
sent_at |
tatsächlicher Versandzeitpunkt |
failed_reason |
Fehlergrund |
created_by |
auslösender Benutzer oder System |
11. Sicherheits- und Datenschutzregeln
| ID |
Regel |
| UC07-SEC-R01 |
Tenant-Isolation ist zwingend |
| UC07-SEC-R02 |
Ein Tenant darf nur eigene Empfänger und Fristdaten nutzen |
| UC07-SEC-R03 |
Kundenbenachrichtigungen dürfen keine internen Prüfnotizen enthalten |
| UC07-SEC-R04 |
Versand personenbezogener Daten muss rollen- und datenschutzabhängig geprüft werden |
| UC07-SEC-R05 |
fehlende oder unklare Kontaktadresse blockiert Versand |
| UC07-SEC-R06 |
Versandaktionen müssen protokolliert werden |
| UC07-SEC-R07 |
Vorlagenänderungen müssen nachvollziehbar sein |
| UC07-SEC-R08 |
System darf keine Benachrichtigung ohne eindeutigen Empfänger versenden |
| UC07-SEC-R09 |
Fehlerhafte Versandversuche dürfen nicht stillschweigend verschwinden |
12. Screen-Flow BN-01 bis BN-08
| Screen |
Bezeichnung |
Zweck |
| BN-01 |
Benachrichtigungsübersicht |
zentrale Übersicht über Vorschläge, Queue und Versandstatus |
| BN-02 |
Benachrichtigungsvorschläge prüfen |
aus UC05 übernommene Vorschläge prüfen und freigeben |
| BN-03 |
Nachrichtenvorschau |
konkrete Nachricht mit Empfänger, Kanal und Inhalt prüfen |
| BN-04 |
Einzelversand bestätigen |
einzelne Benachrichtigung freigeben / versenden |
| BN-05 |
Sammelversand vorbereiten |
mehrere Benachrichtigungen prüfen und gesammelt übergeben |
| BN-06 |
Versandstatus & Fehler |
gesendete, fehlgeschlagene oder blockierte Benachrichtigungen prüfen |
| BN-07 |
Vorlagen verwalten |
einfache V1-Vorlagen prüfen und ggf. tenant-spezifisch anpassen |
| BN-08 |
Benachrichtigungsregeln |
einfache Regeln und Warnzeiträume konfigurieren |
12.1 Empfohlener V1-Kern
| Screen |
Bewertung |
| BN-01 |
zwingend V1 |
| BN-02 |
zwingend V1 |
| BN-03 |
zwingend V1 |
| BN-04 |
zwingend V1 |
| BN-05 |
sinnvoll V1-light |
| BN-06 |
zwingend V1 |
| BN-07 |
V1-light |
| BN-08 |
V1-light, Regeln begrenzt |
13. Akzeptanzkriterien UC07 V1
| ID |
Kriterium |
| UC07-AC01 |
tenant_admin kann Benachrichtigungsübersicht öffnen |
| UC07-AC02 |
System kann Vorschläge aus UC05 übernehmen |
| UC07-AC03 |
System prüft Empfänger, Kanal und Versandbereitschaft |
| UC07-AC04 |
Benutzer kann Nachricht vor Versand anzeigen |
| UC07-AC05 |
System verhindert Versand ohne eindeutigen Empfänger |
| UC07-AC06 |
System verhindert Versand bei fehlendem Kanal |
| UC07-AC07 |
Versandaktion wird protokolliert |
| UC07-AC08 |
fehlgeschlagener Versand wird sichtbar angezeigt |
| UC07-AC09 |
System zeigt keine fremden Tenant-Daten |
| UC07-AC10 |
System verwendet keine internen Prüfnotizen in Kundennachrichten |
| UC07-AC11 |
Benutzer kann Versandstatus und Fehler prüfen |
14. Offene Fragen / Restentscheidungen
| ID |
Frage |
Vorschlag / Status |
| UC07-O01 |
Darf mitarbeiter Benachrichtigungen versenden? |
offen, Vorschlag: tenant-spezifisch konfigurierbar |
| UC07-O02 |
Wird Sammelversand in V1 erlaubt? |
Vorschlag: V1-light mit Bestätigung |
| UC07-O03 |
Muss jede Kundenbenachrichtigung manuell freigegeben werden? |
Vorschlag: Ja für V1 |
| UC07-O04 |
Gibt es automatische Erinnerungen in V1? |
Vorschlag: vorbereitet, aber manuelle Freigabe bevorzugt |
| UC07-O05 |
Sind tenant-spezifische Vorlagentexte V1? |
Vorschlag: Ja, begrenzt |
| UC07-O06 |
Wird Einwilligungsstatus geprüft? |
rechtlich / technisch offen |
| UC07-O07 |
Welcher E-Mail-Dienst wird verwendet? |
technisch offen |
| UC07-O08 |
Werden Versandfehler automatisch erneut versucht? |
Vorschlag: einfache Retry-Strategie prüfen |
| UC07-O09 |
Werden interne und Kundenbenachrichtigungen getrennt behandelt? |
Vorschlag: Ja |
| UC07-O10 |
Werden Portalhinweise schon in V1 aktiv genutzt? |
abhängig von UC06 |
15. Nächster Schritt
Als nächstes sollten die Screen-Vorgaben unter folgendem Ordner angelegt werden:
docs/developer/uc07/screens/
Start mit:
BN-01 – Benachrichtigungsübersicht
Je Screen werden analog zu UC02, UC03, UC05 und UC08 drei Dateien erstellt: