BN-06 – Versandstatus & Fehler
Stand: 12.10.2026 11:23
Branch: main
Status: Abgeschlossen
Änderungshistorie anzeigen
Use Case: UC07 – Benachrichtigungen
Screen: BN-06
Status: erster Vorschlag
Stand: Mai 2026
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
BN-06 zeigt den Versandstatus und Fehler von Benachrichtigungen.
Der Screen dient dazu, gesendete, wartende, fehlgeschlagene, blockierte oder übersprungene Benachrichtigungen nachvollziehbar zu prüfen. Fehlergründe werden sichtbar gemacht, damit Benutzer entscheiden können, ob ein erneuter Versand vorbereitet, eine Datenkorrektur nötig oder ein Eintrag bewusst übersprungen werden soll.
BN-06 ist damit die Kontroll- und Fehleranalyseansicht von UC07.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
prüft Versandstatus, Fehler, Queue und Protokolle |
mitarbeiter |
prüft operative Versandfehler, falls Tenant erlaubt |
kunde |
keine interne Ansicht in UC07 |
superadmin |
nicht Zielnutzer dieses Tenant-Screens |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| BN-01 |
Aktion „Versandstatus & Fehler" |
| BN-04 |
Rücksprung nach Einzelversand |
| BN-05 |
Rücksprung nach Sammelversand |
| UC09 |
Rücksprung aus Export / Protokollauswertung |
4.1 Kopfbereich
| Information |
Beschreibung |
| Zeitraum |
z. B. heute, letzte 7 Tage, letzte 30 Tage |
| in Queue |
Anzahl wartender Benachrichtigungen |
| gesendet |
Anzahl erfolgreicher Benachrichtigungen |
| fehlgeschlagen |
Anzahl fehlgeschlagener Zustellungen |
| blockiert |
Anzahl blockierter Benachrichtigungen |
| übersprungen |
Anzahl bewusst nicht versendeter Benachrichtigungen |
4.2 Versandliste
| Spalte |
Beschreibung |
| Zeitpunkt |
Versand-, Queue- oder Fehlerzeitpunkt |
| Empfänger |
Kunde oder interner Benutzer |
| Kanal |
E-Mail, Portal, intern |
| Vorlage |
verwendete Vorlage |
| Quelle |
z. B. UC05 / Frist / Equipment |
| Status |
queued, sent, failed, blocked, skipped |
| Fehlergrund |
z. B. SMTP-Fehler, fehlende Adresse, ungültiger Kanal |
| Retry |
möglich, nicht möglich, bereits geplant |
| Aktion |
Details, Vorschau, Retry vorbereiten, Export |
5. Filter und Sortierung
| Filter |
Beschreibung |
| Status |
queued, sent, failed, blocked, skipped |
| Kanal |
E-Mail, Portal, intern |
| Fehlergrund |
technische Fehler, Empfängerdaten, Vorlage, Berechtigung |
| Zeitraum |
heute, 7 Tage, 30 Tage, frei |
| Quelle |
UC05, UC06, System |
| Empfänger |
Kunde oder interner Benutzer |
| Sortierung |
Zweck |
| Zeitpunkt absteigend |
neueste Ereignisse zuerst |
| Fehlerstatus |
Fehler priorisieren |
| Kanal |
kanalbezogene Fehler erkennen |
| Empfänger |
wiederholte Probleme je Empfänger erkennen |
6. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Versanddetails öffnen |
zeigt Detailinformationen zum Eintrag |
| Nachrichtenvorschau öffnen |
öffnet BN-03 |
| Retry vorbereiten |
öffnet BN-04 oder markiert für erneute Queue-Übergabe |
| Fehler als geprüft markieren |
interne Prüfung dokumentieren |
| Datenquelle öffnen |
z. B. UC01 / UC06 bei Empfängerproblem |
| Export vorbereiten |
Übergang zu UC09 |
| zurück zur Übersicht |
öffnet BN-01 |
7. Validierungen / Regeln
| ID |
Regel |
| BN06-R01 |
BN-06 zeigt nur Benachrichtigungen des eigenen Tenants |
| BN06-R02 |
Fehler dürfen nicht stillschweigend ausgeblendet werden |
| BN06-R03 |
fehlgeschlagene Versandversuche müssen Fehlergrund und Zeitpunkt enthalten |
| BN06-R04 |
erneuter Versand darf nur vorbereitet werden, wenn Empfänger, Kanal und Vorlage gültig sind |
| BN06-R05 |
Retry-Aktionen müssen protokolliert werden |
| BN06-R06 |
Versandstatus darf nicht manuell manipuliert werden, sondern nur über definierte Aktionen wechseln |
| BN06-R07 |
Export von Versandprotokollen gehört fachlich zu UC09 |
| BN06-R08 |
blockierte Einträge müssen den Blockierungsgrund sichtbar machen |
| BN06-R09 |
Kundenbenachrichtigungstexte dürfen keine internen Prüfnotizen enthalten |
8. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| keine Einträge |
„Keine Versandereignisse im gewählten Zeitraum vorhanden." |
| queued |
„Benachrichtigung wartet auf Versand." |
| sent |
„Benachrichtigung wurde erfolgreich versendet." |
| failed |
„Versand fehlgeschlagen." mit Fehlergrund |
| blocked |
„Versand blockiert." mit Grund |
| skipped |
„Benachrichtigung wurde übersprungen." |
| Retry nicht möglich |
„Erneuter Versand nicht möglich, Daten prüfen." |
| keine Berechtigung |
„Zugriff verweigert." |
9. Bezug zu Datenmodell
| Bereich |
Bezug |
| Queue |
notification_queue |
| Versandlog |
notification_log |
| Empfänger |
notification_recipients |
| Vorlagen |
notification_templates |
| Quelle |
source_uc, source_entity_id |
| Status |
status, queued_at, sent_at, failed_reason |
| Retry |
retry_count, next_retry_at, last_error |
| Audit |
audit_log |
| Export |
UC09 / später export_jobs |
10. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Fehlertransparenz |
Fehler sichtbar und nachvollziehbar halten |
| Rollenprüfung |
Retry und Protokollzugriff rollenbasiert schützen |
| Datenminimierung |
Versandliste zeigt nur notwendige Empfängerdaten |
| keine Statusmanipulation |
Statuswechsel nur über definierte Aktionen |
| Protokollierung |
Retry, Prüfung und Fehlerbehandlung speichern |
11. Akzeptanzkriterien
| ID |
Kriterium |
| BN06-AC01 |
Benutzer kann BN-06 aus BN-01 öffnen |
| BN06-AC02 |
System zeigt queued, sent, failed, blocked und skipped Einträge |
| BN06-AC03 |
System zeigt Fehlergrund und Zeitpunkt bei failed oder blocked |
| BN06-AC04 |
Benutzer kann nach Status, Kanal, Zeitraum und Fehlergrund filtern |
| BN06-AC05 |
Benutzer kann Nachrichtenvorschau BN-03 öffnen |
| BN06-AC06 |
Benutzer kann Retry vorbereiten, falls Daten gültig sind |
| BN06-AC07 |
Retry-Aktionen werden protokolliert |
| BN06-AC08 |
BN-06 zeigt keine fremden Tenant-Daten |
| BN06-AC09 |
Versandstatus wird nicht frei manuell verändert |
| BN06-AC10 |
Benutzer kann Export / Protokollübergabe zu UC09 vorbereiten |
12. Offene Punkte
| ID |
Frage |
Status |
| BN06-O01 |
Gibt es automatische Retry-Versuche in V1? |
Empfehlung: einfache technische Retry-Strategie prüfen |
| BN06-O02 |
Darf Benutzer Retry manuell auslösen? |
Vorschlag: ja, über BN-04 nach Prüfung |
| BN06-O03 |
Wie lange bleiben Versandlogs sichtbar? |
rechtlich / technisch klären |
| BN06-O04 |
Werden technische Fehlerdetails vollständig angezeigt oder gekürzt? |
Vorschlag: gekürzt, Details intern |
| BN06-O05 |
Wird „als geprüft markieren" in V1 umgesetzt? |
sinnvoll, aber optional |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
1.3 |
Abschnitt «Wireframe» mit klickbarem Bild des Screens ergänzt |
Claude |
| 12.10.2026 09:58 |
1.2 |
Änderungshistorie ans Dokumentende verschoben und Sprunglink «Änderungshistorie anzeigen» unter dem Kopf ergänzt (einheitlicher Dokumentaufbau gemäss AGENTS.md) |
Claude |
| 12.10.2026 09:08 |
1.1 |
Kopfbereich auf das Format Stand: TT.MM.JJJJ hh:mm umgestellt |
Claude |
| 01.08.2026 11:12 |
1.0 |
Kopfbereich ergänzt |
David |