BN-05 – Sammelversand vorbereiten
Stand: 12.10.2026 11:23
Branch: main
Status: Abgeschlossen
Änderungshistorie anzeigen
Use Case: UC07 – Benachrichtigungen
Screen: BN-05
Status: erster Vorschlag
Stand: Mai 2026
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
BN-05 dient zur Vorbereitung eines Sammelversands mehrerer Benachrichtigungen.
Der Screen fasst ausgewählte Benachrichtigungsvorschläge zusammen, prüft deren Versandfähigkeit, schliesst blockierte oder prüfpflichtige Einträge aus und bereitet die bewusste Sammelbestätigung vor.
BN-05 ist für V1 als kontrollierter Sammelprozess gedacht. Der Sammelversand darf nur versandbereite Einträge enthalten und muss vollständig protokolliert werden.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
bereitet Sammelversand vor und bestätigt diesen |
mitarbeiter |
optional, falls Tenant Versandrecht erlaubt |
kunde |
Empfänger, keine interne Ansicht |
superadmin |
nicht Zielnutzer dieses Tenant-Screens |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| BN-02 |
Mehrfachauswahl versandbereiter Vorschläge |
| BN-01 |
Schnellaktion „Sammelversand" |
| FR-07 |
vorbereitete Sammelvorschläge aus UC05 |
4.1 Kopfbereich
| Information |
Beschreibung |
| Anzahl ausgewählt |
Gesamtanzahl der ausgewählten Vorschläge |
| versandbereit |
Anzahl direkt versandfähiger Vorschläge |
| ausgeschlossen |
Anzahl blockierter oder prüfpflichtiger Vorschläge |
| Kanalverteilung |
z. B. E-Mail, Portal, intern |
| Quelle |
z. B. UC05 / Fristen-Dashboard |
| Zielstatus |
queued oder sent |
4.2 Sammelliste
| Spalte |
Beschreibung |
| Empfänger |
Kunde oder interner Benutzer |
| Equipment |
ID, Typ und Bezeichnung |
| Auslöser |
due_soon, due_today, overdue, blocked |
| Kanal |
E-Mail, Portal, intern |
| Vorlage |
verwendete Nachrichtenvorlage |
| Versandstatus |
ready, needs_review, blocked |
| Einschluss |
enthalten oder ausgeschlossen |
| Prüfhinweis |
Grund für Ausschluss oder Warnung |
| Aktion |
Vorschau, entfernen, Detail öffnen |
5. Prüf- und Ausschlusslogik
| Status |
Verhalten im Sammelversand |
ready |
darf enthalten sein |
needs_review |
darf nicht ohne Prüfung enthalten sein |
blocked |
wird automatisch ausgeschlossen |
failed |
nur nach Fehlerprüfung erneut aufnehmen |
skipped |
nicht enthalten |
cancelled |
nicht enthalten |
5.1 V1-Empfehlung
Für V1 werden nur Einträge mit Status ready in den Sammelversand übernommen. Alle anderen Einträge bleiben sichtbar, werden aber ausgeschlossen und mit Grund angezeigt.
6. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Sammelversand prüfen |
zeigt Versandfähigkeit und Ausschlüsse |
| einzelne Vorschau öffnen |
öffnet BN-03 |
| Eintrag entfernen |
entfernt Vorschlag aus Sammelauswahl |
| blockierten Eintrag prüfen |
zurück zu BN-02 oder Datenquelle |
| Sammelversand bestätigen |
übergibt alle enthaltenen Einträge an Queue / Versanddienst |
| zurück zu Vorschlägen |
öffnet BN-02 |
| abbrechen |
Sammelprozess ohne Versand verlassen |
7. Validierungen / Regeln
| ID |
Regel |
| BN05-R01 |
BN-05 zeigt nur Benachrichtigungen des eigenen Tenants |
| BN05-R02 |
Sammelversand darf nur ready-Einträge enthalten |
| BN05-R03 |
blockierte oder prüfpflichtige Einträge werden ausgeschlossen |
| BN05-R04 |
Benutzer muss Sammelversand bewusst bestätigen |
| BN05-R05 |
jeder Eintrag im Sammelversand muss einzeln protokolliert werden |
| BN05-R06 |
Sammelaktion selbst muss zusätzlich protokolliert werden |
| BN05-R07 |
Kundennachrichten dürfen keine internen Prüfnotizen enthalten |
| BN05-R08 |
fehlgeschlagene Einzeleinträge dürfen andere erfolgreiche Einträge nicht verdecken |
| BN05-R09 |
Ergebnis muss je Eintrag sichtbar bleiben |
| BN05-R10 |
Benutzer ohne Versandrecht darf Sammelversand nicht auslösen |
8. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| keine versandbereiten Einträge |
„Keine versandbereiten Benachrichtigungen ausgewählt." |
| Einträge ausgeschlossen |
„Nicht versandbereite Einträge wurden ausgeschlossen." |
| Sammelversand bestätigt |
„Sammelversand wurde an die Queue übergeben." |
| Teilfehler |
„Einige Benachrichtigungen konnten nicht übergeben werden." |
| keine Berechtigung |
„Du bist für Sammelversand nicht berechtigt." |
| blockierter Eintrag |
„Eintrag ist blockiert und nicht im Sammelversand enthalten." |
9. Bezug zu Datenmodell
| Bereich |
Bezug |
| Queue |
notification_queue |
| Empfänger |
notification_recipients |
| Vorlagen |
notification_templates |
| Sammelaktion |
optional notification_batches |
| Versandlog |
notification_log |
| Quelle |
source_uc, source_entity_id |
| Status |
status, queued_at, sent_at, failed_reason |
| ausführender Benutzer |
created_by, sent_by |
| Audit |
audit_log |
10. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Rollenprüfung |
Sammelversand nur für berechtigte Benutzer |
| Datenschutz |
Kundentexte vor Versand prüfen |
| bewusste Aktion |
keine automatische Sammelauslösung in V1 |
| Protokollierung |
Einzeleinträge und Sammelaktion speichern |
| Fehlertransparenz |
Teilerfolge und Fehler je Eintrag sichtbar halten |
11. Akzeptanzkriterien
| ID |
Kriterium |
| BN05-AC01 |
Benutzer kann BN-05 aus BN-02 öffnen |
| BN05-AC02 |
System zeigt Anzahl ausgewählt, versandbereit und ausgeschlossen |
| BN05-AC03 |
System übernimmt nur ready-Einträge in den Sammelversand |
| BN05-AC04 |
System zeigt ausgeschlossene Einträge mit Grund |
| BN05-AC05 |
Benutzer kann einzelne Nachrichtenvorschau BN-03 öffnen |
| BN05-AC06 |
Benutzer muss Sammelversand bewusst bestätigen |
| BN05-AC07 |
Sammelversand erzeugt je Eintrag Status queued oder Fehlerstatus |
| BN05-AC08 |
Sammelaktion und Einzeleinträge werden protokolliert |
| BN05-AC09 |
BN-05 zeigt keine fremden Tenant-Daten |
| BN05-AC10 |
Benutzer ohne Berechtigung kann Sammelversand nicht auslösen |
12. Offene Punkte
| ID |
Frage |
Status |
| BN05-O01 |
Wird eine eigene Tabelle notification_batches benötigt? |
technisch prüfen, sinnvoll |
| BN05-O02 |
Wird Sammelversand in V1 für Mitarbeiter erlaubt? |
offene Rollenentscheidung |
| BN05-O03 |
Gibt es eine maximale Anzahl pro Sammelaktion? |
technische Detailklärung |
| BN05-O04 |
Wird bei Teilausfall automatisch Retry ausgelöst? |
eher BN-06 / technische Retry-Logik |
| BN05-O05 |
Ist ein Sammelkommentar Pflicht? |
Vorschlag: 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 |