BN-07 – Vorlagen verwalten
Stand: 12.10.2026 11:23
Branch: main
Status: Abgeschlossen
Änderungshistorie anzeigen
Use Case: UC07 – Benachrichtigungen
Screen: BN-07
Status: erster Vorschlag
Stand: Mai 2026
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
BN-07 dient zur Verwaltung einfacher Benachrichtigungsvorlagen für UC07.
Der Screen ermöglicht es, vorhandene Systemvorlagen und tenant-spezifische Varianten zu prüfen, zu bearbeiten oder für die spätere Nutzung vorzubereiten. Für V1 liegt der Schwerpunkt auf klar begrenzten Fristen-Vorlagen aus UC05.
BN-07 ist kein vollständiges Template-Studio. Komplexe Layouts, HTML-Editoren, Mehrsprachigkeit und Kampagnenfunktionen werden für V1 bewusst begrenzt.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
prüft und verwaltet tenant-spezifische Vorlagen |
mitarbeiter |
in V1 eher lesend oder ohne Zugriff |
kunde |
keine interne Ansicht in UC07 |
superadmin |
nicht Zielnutzer dieses Tenant-Screens; Systemvorlagen später UC-SA |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| BN-01 |
Arbeitsbereich „Vorlagen" |
| BN-03 |
Vorlage aus Nachrichtenvorschau öffnen |
| BN-08 |
Regel verweist auf verwendete Vorlage |
4.1 Vorlagenliste
| Spalte |
Beschreibung |
| Vorlagen-ID |
interne Referenz |
| Name |
sprechender Vorlagenname |
| Typ |
due_soon, due_today, overdue, blocked, unknown_due |
| Kanal |
E-Mail, Portal, intern |
| Status |
aktiv, Entwurf, inaktiv, prüfen |
| Quelle |
Systemvorlage oder Tenant-Vorlage |
| Sprache |
vorbereitet, V1 primär Deutsch |
| letzte Änderung |
Datum / Benutzer |
| Aktion |
Vorschau, bearbeiten, deaktivieren, duplizieren |
4.2 Vorlagendetails
| Feld |
Beschreibung |
| Name |
interner Name der Vorlage |
| Betreff |
E-Mail-Betreff oder Portal-Titel |
| Nachrichtentext |
Nachricht mit Platzhaltern |
| erlaubte Platzhalter |
z. B. customer_name, equipment_label, due_date |
| Kanal |
E-Mail, Portal, intern |
| Status |
aktiv, Entwurf, inaktiv |
| Tenant-Anpassung |
ob Vorlage vom Tenant geändert wurde |
| Datenschutzprüfung |
ob Kundentext interne Informationen enthalten könnte |
5. Erlaubte V1-Vorlagen
| Vorlage |
Auslöser |
Kanal |
V1 |
| Frist bald fällig |
due_soon |
E-Mail |
Ja |
| Frist heute fällig |
due_today |
E-Mail |
Ja |
| Frist überfällig |
overdue |
E-Mail |
Ja |
| Equipment gesperrt |
blocked |
E-Mail / intern |
Ja |
| Daten prüfen |
unknown_due |
intern |
vorbereitet |
| Portal-Hinweis |
due_soon / overdue |
Portal |
abhängig von UC06 |
6. Platzhaltermodell
| Platzhalter |
Bedeutung |
customer_name |
Name des Kunden |
equipment_label |
Equipment-Kurzbezeichnung |
equipment_type |
Equipment-Typ |
due_date |
Fälligkeitsdatum |
days_until_due |
Tage bis zur Frist |
days_overdue |
Tage seit Fristüberschreitung |
tenant_name |
Name der Tauchschule |
portal_link |
Portal-Link, falls UC06 aktiv |
6.1 Platzhalterregeln
| Regel |
Beschreibung |
| Platzhalter müssen validiert werden |
unbekannte Platzhalter sind nicht erlaubt |
| fehlende Werte blockieren Versand |
Nachricht wird needs_review oder blocked |
| interne Felder sind gesperrt |
interne Prüfnotizen dürfen nicht in Kundenvorlagen verwendet werden |
| Kanalabhängigkeit beachten |
Portal-Link nur verwenden, wenn UC06 / Portal aktiv |
7. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Vorlage öffnen |
Detailansicht der Vorlage |
| Vorlage bearbeiten |
V1 begrenzt auf Betreff und Text |
| Vorschau anzeigen |
rendert Beispielnachricht mit Testdaten |
| Vorlage duplizieren |
Systemvorlage als Tenant-Variante übernehmen |
| Vorlage deaktivieren |
verhindert weitere Nutzung |
| Änderungen speichern |
speichert tenant-spezifische Variante |
| zurück zur Übersicht |
öffnet BN-01 |
8. Validierungen / Regeln
| ID |
Regel |
| BN07-R01 |
BN-07 zeigt nur Vorlagen des eigenen Tenants und freigegebene Systemvorlagen |
| BN07-R02 |
Systemvorlagen dürfen durch Tenant nicht direkt überschrieben werden |
| BN07-R03 |
Tenant-Anpassungen müssen als eigene Variante gespeichert werden |
| BN07-R04 |
unbekannte Platzhalter sind nicht zulässig |
| BN07-R05 |
Kundenvorlagen dürfen keine internen Prüfnotizen enthalten |
| BN07-R06 |
inaktive Vorlagen dürfen nicht für neue Benachrichtigungen genutzt werden |
| BN07-R07 |
Vorlagenänderungen müssen protokolliert werden |
| BN07-R08 |
Mitarbeiter dürfen Vorlagen nur bearbeiten, wenn dies explizit erlaubt ist |
| BN07-R09 |
Portal-Platzhalter dürfen nur bei aktivem Portal verwendet werden |
9. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| Vorlage aktiv |
„Vorlage aktiv." |
| Vorlage in Entwurf |
„Vorlage ist noch nicht aktiv." |
| Platzhalter ungültig |
„Unbekannter Platzhalter." |
| Pflichtplatzhalter fehlt |
„Erforderlicher Platzhalter fehlt." |
| interner Inhalt erkannt |
„Interne Hinweise dürfen nicht in Kundenvorlagen verwendet werden." |
| Systemvorlage geschützt |
„Systemvorlage kann nur dupliziert werden." |
| keine Berechtigung |
„Du bist für Vorlagenänderungen nicht berechtigt." |
10. Bezug zu Datenmodell
| Bereich |
Bezug |
| Vorlagen |
notification_templates |
| Regeln |
notification_rules |
| Tenant-Variante |
tenant_id, base_template_id |
| Platzhalter |
allowed_placeholders oder technische Validierungslogik |
| Status |
status |
| Änderung |
updated_by, updated_at |
| Audit |
audit_log |
11. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Systemvorlagen |
nicht direkt überschreiben |
| interne Hinweise |
nicht in Kundenvorlagen zulassen |
| Datenminimierung |
nur notwendige Informationen in Kundentexte aufnehmen |
| Änderungsprotokoll |
Vorlagenänderungen nachvollziehbar speichern |
| Rollenprüfung |
Bearbeitung auf tenant_admin begrenzen |
12. Akzeptanzkriterien
| ID |
Kriterium |
| BN07-AC01 |
tenant_admin kann BN-07 öffnen |
| BN07-AC02 |
System zeigt Systemvorlagen und tenant-spezifische Vorlagen |
| BN07-AC03 |
Benutzer kann eine Vorlage öffnen und Vorschau anzeigen |
| BN07-AC04 |
Benutzer kann Systemvorlage als Tenant-Variante duplizieren |
| BN07-AC05 |
System verhindert unbekannte Platzhalter |
| BN07-AC06 |
System verhindert interne Prüfnotizen in Kundenvorlagen |
| BN07-AC07 |
Benutzer kann tenant-spezifische Vorlage speichern |
| BN07-AC08 |
Vorlagenänderung wird protokolliert |
| BN07-AC09 |
BN-07 zeigt keine fremden Tenant-Daten |
| BN07-AC10 |
Benutzer ohne Berechtigung kann keine Vorlage ändern |
13. Offene Punkte
| ID |
Frage |
Status |
| BN07-O01 |
Sind tenant-spezifische Texte bereits V1? |
Vorschlag: ja, begrenzt |
| BN07-O02 |
Wird HTML oder nur Plain Text unterstützt? |
Empfehlung V1: Plain Text / einfache Formatierung |
| BN07-O03 |
Wird Mehrsprachigkeit in Vorlagen vorbereitet? |
Ja, aber Umsetzung später UC17 |
| BN07-O04 |
Gibt es Freigabestatus für Vorlagenänderungen? |
V1 vermutlich nicht |
| BN07-O05 |
Wird Vorschau mit echten oder Testdaten gerendert? |
Empfehlung: Testdaten / ausgewählter Vorschlag |
Ä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 |