BN-04 – Einzelversand bestätigen
Stand: 12.10.2026 11:23
Branch: main
Status: Abgeschlossen
Änderungshistorie anzeigen
Use Case: UC07 – Benachrichtigungen
Screen: BN-04
Status: erster Vorschlag
Stand: Mai 2026
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
BN-04 dient zur finalen Bestätigung und Auslösung einer einzelnen Benachrichtigung.
Der Screen fasst Empfänger, Kanal, Vorlage, Nachrichtenzusammenfassung, fachlichen Auslöser, Datenschutzstatus und Versandbereitschaft zusammen. Erst nach bewusster Bestätigung darf die Benachrichtigung in die Versand-Queue übergeben oder direkt an den Versanddienst übergeben werden.
BN-04 ist damit der kontrollierte Übergang von der Vorschau zum tatsächlichen Versand.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
bestätigt und versendet einzelne Benachrichtigungen |
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-03 |
Aktion „Einzelversand vorbereiten" |
| BN-02 |
direkter Absprung aus versandbereitem Vorschlag |
| BN-06 |
erneuter Versand nach Fehlerprüfung, falls erlaubt |
4.1 Versandzusammenfassung
| Feld |
Beschreibung |
| Vorschlags-ID |
eindeutige Referenz |
| Empfänger |
Name und Empfängertyp |
| Kanal |
E-Mail, Portal oder intern |
| Empfängeradresse |
z. B. E-Mail-Adresse |
| Vorlage |
verwendete Vorlage |
| Auslöser |
due_soon, due_today, overdue, blocked |
| Quelle |
UC05 / Frist / Equipment |
| Versandstatus aktuell |
ready oder needs_review |
| Zielstatus |
queued oder sent |
4.2 Prüfbereich
| Prüfung |
Bedeutung |
| Empfänger eindeutig |
ohne eindeutigen Empfänger kein Versand |
| Kanal gültig |
z. B. gültige E-Mail-Adresse vorhanden |
| Platzhalter vollständig |
alle Platzhalter ersetzt |
| Datenschutz OK |
Kundentext enthält keine internen Hinweise |
| Berechtigung OK |
Benutzer darf Versand auslösen |
| Tenant-Isolation OK |
Quelle und Empfänger gehören zum Tenant |
4.3 Bestätigung
| Feld |
Beschreibung |
| bewusste Bestätigung |
Benutzer bestätigt Versandabsicht |
| optionaler Kommentar |
interner Versandkommentar |
| Versandzeitpunkt |
sofort oder später vorbereitet |
| Protokollhinweis |
Versandaktion wird protokolliert |
5. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Versand bestätigen |
übergibt Nachricht an Queue / Versanddienst |
| zurück zur Vorschau |
öffnet BN-03 |
| zurück zu Vorschlägen |
öffnet BN-02 |
| Kommentar erfassen |
optionaler interner Hinweis |
| Versand abbrechen |
setzt Status zurück oder lässt Vorschlag unverändert |
| Fehlerdetails öffnen |
falls Prüfung nicht bestanden wurde |
6. Validierungen / Regeln
| ID |
Regel |
| BN04-R01 |
BN-04 zeigt nur Benachrichtigungen des eigenen Tenants |
| BN04-R02 |
Versand darf nur bei Status ready ausgelöst werden |
| BN04-R03 |
Empfänger muss eindeutig sein |
| BN04-R04 |
Kanal muss gültig und aktiv sein |
| BN04-R05 |
Platzhalter müssen vollständig ersetzt sein |
| BN04-R06 |
Kundennachricht darf keine internen Prüfnotizen enthalten |
| BN04-R07 |
Benutzer muss Versand bewusst bestätigen |
| BN04-R08 |
Versandaktion muss protokolliert werden |
| BN04-R09 |
Bei Versandfehler muss Status failed mit Fehlergrund entstehen |
| BN04-R10 |
Erfolgreicher Versand erzeugt Status sent oder bei Queue zunächst queued |
7. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| Versand bereit |
„Benachrichtigung ist versandbereit." |
| Versand bestätigt |
„Benachrichtigung wurde an den Versand übergeben." |
| Queue verwendet |
„Benachrichtigung wurde in die Versand-Queue gestellt." |
| Versand erfolgreich |
Status sent |
| Versand fehlgeschlagen |
Status failed mit Fehlergrund |
| Prüfung fehlgeschlagen |
„Versand ist noch nicht möglich." |
| keine Berechtigung |
„Du bist für diese Versandaktion nicht berechtigt." |
| Kanal ungültig |
„Kein gültiger Versandkanal vorhanden." |
8. Bezug zu Datenmodell
| Bereich |
Bezug |
| Queue |
notification_queue |
| Empfänger |
notification_recipients |
| Vorlage |
notification_templates |
| 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 |
9. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Rollenprüfung |
Versand nur für berechtigte Benutzer |
| Datenschutz |
Kundentext vor Versand prüfen |
| bewusste Aktion |
kein automatischer Versand ohne Bestätigung in V1 |
| Protokollierung |
Versand, Fehler und Benutzer speichern |
| Fehlertransparenz |
fehlgeschlagene Versuche sichtbar halten |
10. Akzeptanzkriterien
| ID |
Kriterium |
| BN04-AC01 |
Benutzer kann BN-04 aus BN-03 öffnen |
| BN04-AC02 |
System zeigt Empfänger, Kanal, Vorlage, Quelle und Versandstatus |
| BN04-AC03 |
System zeigt alle relevanten Versandprüfungen |
| BN04-AC04 |
System verhindert Versand, wenn Empfänger, Kanal oder Platzhalter ungültig sind |
| BN04-AC05 |
Benutzer muss Versand bewusst bestätigen |
| BN04-AC06 |
Versandübergabe erzeugt Status queued oder sent |
| BN04-AC07 |
Fehler erzeugen Status failed mit Fehlergrund |
| BN04-AC08 |
Versandaktion wird protokolliert |
| BN04-AC09 |
BN-04 zeigt keine fremden Tenant-Daten |
| BN04-AC10 |
Benutzer ohne Berechtigung kann keinen Versand auslösen |
11. Offene Punkte
| ID |
Frage |
Status |
| BN04-O01 |
Wird in V1 direkt gesendet oder immer zuerst queued? |
Empfehlung: Queue verwenden |
| BN04-O02 |
Ist Kommentar vor Versand Pflicht? |
Vorschlag: nein, optional |
| BN04-O03 |
Wird erneuter Versand nach Fehler direkt aus BN-04 erlaubt? |
eher über BN-06 |
| BN04-O04 |
Darf mitarbeiter Einzelversand auslösen? |
offene Rollenentscheidung |
| BN04-O05 |
Wird Versandzeitpunkt planbar? |
V1: sofort / Queue, spätere Planung prüfen |
Ä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 |