BN-03 – Nachrichtenvorschau¶

Stand: 12.10.2026 11:23 Branch: main Status: Abgeschlossen

Use Case: UC07 – Benachrichtigungen Screen: BN-03 Status: erster Vorschlag Stand: Mai 2026

Wireframe¶

Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.

1. Zweck¶

BN-03 zeigt die konkrete Vorschau einer Benachrichtigung vor dem Versand.

Der Screen dient dazu, Empfänger, Kanal, fachlichen Auslöser, verwendete Vorlage, ersetzte Platzhalter und finalen Nachrichtentext zu prüfen. Zusätzlich werden Versandbereitschaft, Datenschutzstatus und fachlicher Bezug zur Quelle angezeigt, z. B. UC05-Fristdaten.

BN-03 versendet selbst keine Nachricht. Die Freigabe und der tatsächliche Versand erfolgen über BN-04 oder BN-05.

2. Primäre Nutzer¶

Rolle	Nutzung
`tenant_admin`	prüft Nachricht und gibt sie für den Versand weiter
`mitarbeiter`	prüft operative Nachricht, falls Tenant erlaubt
`kunde`	erhält die Nachricht, nutzt aber keine interne Ansicht
`superadmin`	nicht Zielnutzer dieses Tenant-Screens

3. Einstieg / Auslöser¶

Einstieg	Beschreibung
BN-02	Nachrichtenvorschau aus Vorschlagsliste öffnen
BN-04	Rücksprung aus Einzelversand-Bestätigung
BN-05	Prüfung einer Nachricht aus Sammelversand-Kontext
BN-06	Prüfung einer fehlgeschlagenen oder gesendeten Nachricht

4. Angezeigte Informationen¶

4.1 Kopfbereich¶

Information	Beschreibung
Vorschlags-ID	eindeutige Referenz der Benachrichtigung
Status	draft, ready, needs_review oder blocked
Quelle	z. B. UC05 / Fristdetail
Auslöser	due_soon, due_today, overdue, blocked
Versandbereitschaft	ready, prüfen oder blockiert
Datenschutzstatus	OK, prüfen oder blockiert

4.2 Empfänger- und Kanaldaten¶

Feld	Beschreibung
Empfänger	Name des Kunden oder internen Benutzers
Empfängertyp	Kunde, Mitarbeiter, Tenant-Admin
E-Mail-Adresse	Empfängeradresse, falls Kanal E-Mail
Portalzugang	vorhanden, nicht vorhanden oder vorbereitet
Kanal	E-Mail, Portal, intern
Einwilligungsstatus	offen / zu prüfen, falls erforderlich

4.3 Nachrichtenvorschau¶

Feld	Beschreibung
Vorlage	verwendete Nachrichtenvorlage
Betreff	finaler Betreff nach Platzhalterersetzung
Nachrichtentext	finaler Nachrichtentext
Platzhalter	Liste ersetzter Werte
interne Hinweise	nur intern sichtbar, nicht Bestandteil der Kundennachricht

5. Eingaben / Aktionen¶

Aktion	Beschreibung
zurück zu Vorschlägen	öffnet BN-02
Einzelversand vorbereiten	öffnet BN-04
in Sammelversand übernehmen	öffnet oder markiert für BN-05
Vorlage öffnen	öffnet BN-07
Regel öffnen	öffnet BN-08
Fristdetail öffnen	öffnet UC05 / FR-03
Nachricht überspringen	markiert Vorschlag als skipped, ggf. mit Grund

6. Validierungen / Regeln¶

ID	Regel
BN03-R01	BN-03 zeigt nur Benachrichtigungen des eigenen Tenants
BN03-R02	BN-03 versendet keine Nachricht direkt
BN03-R03	Versand erfolgt erst über BN-04 oder BN-05
BN03-R04	Platzhalter müssen vollständig aufgelöst sein
BN03-R05	fehlende Platzhalterwerte erzeugen `needs_review` oder `blocked`
BN03-R06	Kundennachrichten dürfen keine internen Prüfnotizen enthalten
BN03-R07	Empfänger und Kanal müssen eindeutig sein
BN03-R08	Datenschutz- oder Einwilligungsblockaden verhindern Weitergabe an Versand
BN03-R09	geänderte Vorlagen müssen separat über BN-07 verwaltet werden

7. Status- und Fehlermeldungen¶

Situation	Meldung / Darstellung
Nachricht bereit	„Nachricht ist versandbereit."
Platzhalter fehlt	„Platzhalter konnte nicht ersetzt werden."
Empfänger fehlt	„Empfänger nicht eindeutig."
Kanal fehlt	„Kein gültiger Versandkanal vorhanden."
Datenschutz prüfen	„Datenschutzprüfung erforderlich."
interner Hinweis erkannt	„Interne Hinweise dürfen nicht an Kunden versendet werden."
keine Berechtigung	„Zugriff verweigert."

8. Bezug zu Datenmodell¶

Bereich	Bezug
Vorschlag / Queue	`notification_queue`
Empfänger	`notification_recipients`
Vorlage	`notification_templates`
Regel	`notification_rules`
Quelle	`source_uc`, `source_entity_id`
Fristdaten	UC05 / `next_due_date`, `due_status`, `days_until_due`
Nachrichtentext	gerenderte Vorschau, nicht zwingend final gespeichert
Log	`notification_log` bei späterem Versand

9. Sicherheits- und Datenschutzbezug¶

Thema	Umsetzung
Tenant-Isolation	serverseitig erzwingen
Datenminimierung	nur notwendige Kundendaten in Nachricht aufnehmen
interne Hinweise	nicht in Kundentext übernehmen
Platzhalterprüfung	fehlende Werte sichtbar machen
kein Versand	BN-03 bleibt Vorschau
Protokollierung	Versand erst in BN-04 / BN-05 protokollieren

10. Akzeptanzkriterien¶

ID	Kriterium
BN03-AC01	Benutzer kann BN-03 aus BN-02 öffnen
BN03-AC02	System zeigt Empfänger, Kanal, Vorlage und Auslöser
BN03-AC03	System zeigt finalen Betreff und Nachrichtentext
BN03-AC04	System zeigt ersetzte Platzhalterwerte
BN03-AC05	System markiert fehlende Platzhalter oder Empfängerdaten
BN03-AC06	System zeigt Datenschutzstatus
BN03-AC07	Benutzer kann BN-04 zur Einzelversand-Bestätigung öffnen
BN03-AC08	Benutzer kann FR-03 zur Quelle öffnen
BN03-AC09	BN-03 zeigt keine fremden Tenant-Daten
BN03-AC10	BN-03 versendet keine Nachricht direkt

11. Offene Punkte¶

ID	Frage	Status
BN03-O01	Darf Nachrichtentext vor Versand manuell angepasst werden?	Vorschlag: nicht V1, über Vorlage
BN03-O02	Wird gerenderter Text vor Versand gespeichert?	technische Detailklärung
BN03-O03	Wird Datenschutzcheck automatisiert oder nur angezeigt?	offen
BN03-O04	Wird Einwilligungsstatus in V1 geprüft?	rechtlich / technisch offen
BN03-O05	Wird Vorschau mehrerer Kanäle parallel angezeigt?	V1: primärer Kanal

Ä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