KP-03 – Einladungsvorschau & Versandübergabe
Stand: 12.10.2026 11:23
Branch: main
Status: Abgeschlossen
Änderungshistorie anzeigen
Use Case: UC06 – Kunden einladen & Portal
Screen: KP-03
Status: erster Vorschlag
Stand: Mai 2026
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
KP-03 zeigt die Vorschau einer Portal-Einladung und bereitet die Übergabe an UC07 – Benachrichtigungen vor.
Der Screen dient dazu, Empfänger, E-Mail-Adresse, Einladungsstatus, Portal-Link-Token, Ablaufdatum, Nachrichtenvorlage und finalen Einladungstext zu prüfen. Erst nach bewusster Bestätigung wird die Einladung an UC07 übergeben. UC07 übernimmt anschliessend Versandstatus, Queue, Fehlerbehandlung und Versandprotokollierung.
KP-03 selbst versendet keine Einladung direkt.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
prüft Einladung und übergibt sie an UC07 |
mitarbeiter |
optional, falls Tenant dies erlaubt |
kunde |
Empfänger der Einladung, keine interne Ansicht |
superadmin |
nicht Zielnutzer dieses Tenant-Screens |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| KP-02 |
Einladung wurde vorbereitet |
| KP-04 |
erneute Einladung nach abgelaufenem oder fehlgeschlagenem Status |
| UC07 |
Rücksprung nach Versandvorschau oder Fehlerprüfung |
4.1 Einladungskopf
| Feld |
Beschreibung |
| Kunde |
Name und Kundennummer |
| Empfängeradresse |
E-Mail-Adresse des Kunden |
| Portalstatus |
aktueller Status vor Versand |
| Einladungsstatus |
Entwurf, abgelaufen, fehlgeschlagen oder erneut vorbereitet |
| Ablaufdatum |
geplantes Ablaufdatum des Einladungslinks |
| Quelle |
UC06 / Kundenportal |
| Zielsystem |
UC07 / Benachrichtigungen |
4.2 Token- und Linkprüfung
| Prüfung |
Beschreibung |
| Token wird vorbereitet |
Token wird technisch erzeugt oder reserviert |
| Token ist zeitlich begrenzt |
Ablaufdatum vorhanden |
| Token ist tenant-gebunden |
Tenant-ID eindeutig |
| Token ist kunden-gebunden |
Customer-ID eindeutig |
| Token ist nicht mehrfach nutzbar |
Einmaligkeit muss technisch sichergestellt sein |
| Link nicht vollständig im Log anzeigen |
sensible Token nicht unnötig offenlegen |
4.3 Nachrichtenvorschau
| Feld |
Beschreibung |
| Vorlage |
Portal-Einladung |
| Betreff |
finaler Betreff |
| Nachrichtentext |
finaler Einladungstext |
| Portal-Link |
Link oder Platzhalter, Token maskiert |
| Gültigkeit |
z. B. 14 Tage |
| Absender |
Tenant / Tauchschule |
5. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Einladung an UC07 übergeben |
erzeugt Benachrichtigungsvorschlag / Queue-Eintrag |
| zurück zu KP-02 |
Einladungsvorbereitung ändern |
| Status öffnen |
öffnet KP-04 |
| Vorlage prüfen |
öffnet UC07 / BN-07 oder BN-03 |
| Versandvorschau UC07 öffnen |
öffnet UC07-Kontext |
| abbrechen |
zurück zu KP-01 oder KP-02 |
6. Validierungen / Regeln
| ID |
Regel |
| KP03-R01 |
KP-03 zeigt nur Kunden des eigenen Tenants |
| KP03-R02 |
Einladung kann nur bei gültiger E-Mail vorbereitet werden |
| KP03-R03 |
aktiver Portalzugang verhindert Neueinladung |
| KP03-R04 |
gesperrter Portalzugang verhindert Einladung ohne Reaktivierung |
| KP03-R05 |
Einladungslink muss zeitlich begrenzt sein |
| KP03-R06 |
Token muss tenant- und kunden-gebunden sein |
| KP03-R07 |
Token darf nicht mehrfach aktivierbar sein |
| KP03-R08 |
KP-03 versendet nicht direkt, sondern übergibt an UC07 |
| KP03-R09 |
Übergabe an UC07 muss protokollierbar sein |
| KP03-R10 |
vollständige Token dürfen nicht unnötig in UI oder Log angezeigt werden |
7. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| Einladung bereit |
„Einladung ist bereit zur Übergabe an UC07." |
| E-Mail fehlt |
„Einladung nicht möglich: E-Mail-Adresse fehlt." |
| Portalzugang aktiv |
„Kunde hat bereits einen aktiven Portalzugang." |
| Portal gesperrt |
„Portalzugang ist gesperrt." |
| Ablaufdatum fehlt |
„Ablaufdatum für Einladung fehlt." |
| Tokenfehler |
„Einladungslink konnte nicht vorbereitet werden." |
| Übergabe erfolgreich |
„Einladung wurde an UC07 übergeben." |
| keine Berechtigung |
„Du bist für diese Aktion nicht berechtigt." |
8. Bezug zu Datenmodell
| Bereich |
Bezug |
| Kunden |
customers |
| Portalzugang |
customer_portal_accounts |
| Einladungen |
customer_invitations |
| Token |
customer_invitation_tokens |
| Benachrichtigung |
UC07 / notification_queue, notification_templates |
| Versandlog |
UC07 / notification_log |
| Audit |
audit_log |
9. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Token-Sicherheit |
Token zeitlich begrenzen und nicht erratbar machen |
| Token-Sichtbarkeit |
vollständigen Token nicht unnötig anzeigen |
| Rollenprüfung |
Übergabe nur für berechtigte Benutzer |
| kein Direktversand |
Versandstatus und Fehlerbehandlung in UC07 |
| Protokollierung |
Übergabe, Erstellung, Versand und Fehler nachvollziehbar speichern |
10. Akzeptanzkriterien
| ID |
Kriterium |
| KP03-AC01 |
Benutzer kann KP-03 aus KP-02 öffnen |
| KP03-AC02 |
System zeigt Kunde, Empfängeradresse, Portalstatus und Einladungsstatus |
| KP03-AC03 |
System zeigt Nachrichtenvorschau der Einladung |
| KP03-AC04 |
System zeigt Ablaufdatum der Einladung |
| KP03-AC05 |
System verhindert Übergabe bei fehlender E-Mail |
| KP03-AC06 |
System verhindert Übergabe bei aktivem oder gesperrtem Portalzugang |
| KP03-AC07 |
Benutzer kann Einladung an UC07 übergeben |
| KP03-AC08 |
KP-03 versendet keine Einladung direkt |
| KP03-AC09 |
KP-03 zeigt keine fremden Tenant-Daten |
| KP03-AC10 |
Übergabe an UC07 wird protokollierbar vorbereitet |
11. Offene Punkte
| ID |
Frage |
Status |
| KP03-O01 |
Wird Token vor oder nach UC07-Übergabe erzeugt? |
technisch klären |
| KP03-O02 |
Wie lange ist die Einladung gültig? |
Vorschlag: 14 Tage |
| KP03-O03 |
Wird Einladungslink im UI maskiert angezeigt? |
Empfehlung: Ja |
| KP03-O04 |
Wird UC07 BN-03 für Versandvorschau wiederverwendet? |
sinnvoll |
| KP03-O05 |
Wird Absenderadresse tenant-spezifisch oder systemweit verwendet? |
technisch / betrieblich klären |
Ä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 |