KP-02 – Kunde auswählen & Einladung vorbereiten
Stand: 12.10.2026 11:23
Branch: main
Status: Abgeschlossen
Änderungshistorie anzeigen
Use Case: UC06 – Kunden einladen & Portal
Screen: KP-02
Status: erster Vorschlag
Stand: Mai 2026
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
KP-02 dient dazu, einen Kunden auszuwählen und eine Portal-Einladung fachlich vorzubereiten.
Der Screen prüft, ob der Kunde eine gültige E-Mail-Adresse besitzt, ob bereits ein Portalzugang existiert, ob eine Einladung offen, abgelaufen oder widerrufen ist und ob die Einladung fachlich sinnvoll vorbereitet werden kann.
KP-02 versendet keine Einladung direkt. Die Versandvorschau und Übergabe an UC07 erfolgen über KP-03.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
wählt Kunden aus und bereitet Einladung vor |
mitarbeiter |
optional, falls Tenant dies erlaubt |
kunde |
keine interne Ansicht |
superadmin |
nicht Zielnutzer dieses Tenant-Screens |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| KP-01 |
Aktion „Kunde einladen" |
| Kundenstamm |
Absprung aus Kundendetail |
| UC05 |
Einladung aus Fristenkontext vorbereiten |
| UC07 |
Rücksprung nach fehlgeschlagener Einladung |
4.1 Kundenauswahl
| Feld |
Beschreibung |
| Kundensuche |
Suche nach Name, Kundennummer oder E-Mail |
| Kunde |
ausgewählter Kunde |
| Kundennummer |
interne Referenz |
| E-Mail |
primäre Kontaktadresse |
| Telefon |
optional, nur informativ |
| Portalstatus |
not_invited, invited, active, blocked usw. |
| Einladungsstatus |
draft, invited, expired, revoked, failed |
| Equipment-Anzahl |
Anzahl zugeordneter Equipment-Datensätze |
| Fristenhinweise |
Anzahl relevanter Fristen aus UC05 |
4.2 Prüfbereich
| Prüfung |
Beschreibung |
| E-Mail vorhanden |
Einladung nur mit gültiger Adresse vorbereiten |
| Kunde eindeutig |
kein Versand an unklare Kundenzuordnung |
| Portalzugang vorhanden |
aktive Zugänge nicht erneut neu einladen |
| Einladung offen |
erneute Einladung nur kontrolliert vorbereiten |
| Einladung abgelaufen |
erneute Einladung möglich |
| Portal gesperrt |
Einladung blockiert, erst Sperrgrund prüfen |
| Tenant-Isolation |
Kunde muss zum aktuellen Tenant gehören |
5. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Kunde suchen |
filtert Kundenliste |
| Kunde auswählen |
lädt Kundendetails und Prüfbereich |
| Einladung vorbereiten |
erzeugt Einladungsentwurf |
| Einladung erneut vorbereiten |
bei expired oder failed möglich |
| Status prüfen |
öffnet KP-04 |
| Kundendetail öffnen |
öffnet Kundenstamm / UC01-Kontext |
| Einladungsvorschau öffnen |
öffnet KP-03 |
| abbrechen |
zurück zu KP-01 |
6. Validierungen / Regeln
| ID |
Regel |
| KP02-R01 |
KP-02 zeigt nur Kunden des eigenen Tenants |
| KP02-R02 |
Einladung ohne gültige E-Mail-Adresse ist nicht möglich |
| KP02-R03 |
Kunde muss eindeutig ausgewählt sein |
| KP02-R04 |
aktiver Portalzugang darf nicht erneut als Neueinladung vorbereitet werden |
| KP02-R05 |
gesperrter Portalzugang blockiert Einladungsvorbereitung |
| KP02-R06 |
abgelaufene oder fehlgeschlagene Einladung darf kontrolliert erneut vorbereitet werden |
| KP02-R07 |
Einladungsentwurf erhält noch keinen Versandstatus invited |
| KP02-R08 |
Versand erfolgt erst über KP-03 / UC07 |
| KP02-R09 |
Vorbereitung muss protokollierbar sein, falls Entwurf gespeichert wird |
7. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| Kunde nicht gefunden |
„Kein Kunde gefunden." |
| E-Mail fehlt |
„Einladung nicht möglich: E-Mail-Adresse fehlt." |
| Kunde aktiv |
„Portalzugang ist bereits aktiv." |
| Einladung offen |
„Einladung wurde bereits versendet." |
| Einladung abgelaufen |
„Einladung kann erneut vorbereitet werden." |
| Portal gesperrt |
„Portalzugang ist gesperrt." |
| 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 |
| Fristen |
UC05 / next_due_date, due_status |
| Benachrichtigung |
UC07 / notification_queue |
| Audit |
audit_log |
9. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Rollenprüfung |
Einladungsvorbereitung rollenbasiert einschränken |
| E-Mail-Prüfung |
keine Einladung ohne gültige Kontaktadresse |
| kein Direktversand |
Versand erst über KP-03 / UC07 |
| gesperrte Zugänge |
keine Umgehung durch Neueinladung |
| Protokollierung |
Vorbereitung, erneute Vorbereitung und Blockaden nachvollziehbar halten |
10. Akzeptanzkriterien
| ID |
Kriterium |
| KP02-AC01 |
Benutzer kann KP-02 aus KP-01 öffnen |
| KP02-AC02 |
Benutzer kann Kunden suchen und auswählen |
| KP02-AC03 |
System zeigt Kundendaten, E-Mail, Portalstatus und Einladungsstatus |
| KP02-AC04 |
System verhindert Einladung ohne gültige E-Mail |
| KP02-AC05 |
System verhindert Neueinladung bei aktivem Portalzugang |
| KP02-AC06 |
System blockiert Einladung bei gesperrtem Portalzugang |
| KP02-AC07 |
Benutzer kann bei zulässigem Zustand Einladungsvorschau KP-03 öffnen |
| KP02-AC08 |
KP-02 versendet keine Einladung direkt |
| KP02-AC09 |
KP-02 zeigt keine fremden Tenant-Daten |
| KP02-AC10 |
Benutzer ohne Berechtigung kann keine Einladung vorbereiten |
11. Offene Punkte
| ID |
Frage |
Status |
| KP02-O01 |
Darf mitarbeiter Einladungen vorbereiten? |
offene Rollenentscheidung |
| KP02-O02 |
Wird Einladungsentwurf gespeichert oder nur temporär übergeben? |
technische Detailklärung |
| KP02-O03 |
Wird E-Mail-Adresse vor Einladung verifiziert? |
abhängig vom Auth-Mechanismus |
| KP02-O04 |
Wird Wiederholung einer Einladung begrenzt? |
Empfehlung: Rate-Limit / Protokoll |
| KP02-O05 |
Wird Kunde ohne E-Mail zur Datenpflege markiert? |
sinnvoll, aber 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 |