KP-04 – Einladungsstatus & Fehler
Stand: 12.10.2026 11:23
Branch: main
Status: Abgeschlossen
Änderungshistorie anzeigen
Use Case: UC06 – Kunden einladen & Portal
Screen: KP-04
Status: erster Vorschlag
Stand: Mai 2026
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
KP-04 zeigt den Status und mögliche Fehler von Kundenportal-Einladungen.
Der Screen dient dazu, versendete, angenommene, abgelaufene, widerrufene, fehlgeschlagene oder blockierte Einladungen nachvollziehbar zu prüfen. KP-04 zeigt ausserdem, ob ein erneuter Versand vorbereitet werden kann oder ob zuerst Kundendaten, E-Mail-Adresse, Portalstatus oder Sperrgrund geklärt werden müssen.
Der tatsächliche Versandstatus kommt aus UC07 – Benachrichtigungen.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
prüft Einladungsstatus, Fehler und Folgeaktionen |
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 „Status" oder Problemstatus |
| KP-02 |
Statusprüfung vor erneuter Einladung |
| KP-03 |
Rücksprung nach Versandübergabe |
| UC07 |
Rücksprung aus Versandstatus oder Fehlerprüfung |
4.1 Kopfbereich
| Information |
Beschreibung |
| Kunde |
Name und Kundennummer |
| Portalstatus |
not_invited, invited, active, blocked |
| Einladungsstatus |
draft, invited, accepted, expired, revoked, failed |
| Versandstatus |
ready, queued, sent, failed, blocked |
| Ablaufdatum |
Zeitpunkt, ab dem Einladung ungültig ist |
| letzter Versandversuch |
Datum / Uhrzeit |
| letzter Fehler |
letzter bekannter Fehler aus UC07 |
4.2 Statusverlauf
| Spalte |
Beschreibung |
| Zeitpunkt |
Ereigniszeitpunkt |
| Ereignis |
vorbereitet, übergeben, versendet, angenommen, abgelaufen, widerrufen, Fehler |
| Quelle |
UC06, UC07, System, Benutzer |
| Status vorher |
vorheriger Status |
| Status danach |
neuer Status |
| Benutzer / System |
auslösende Instanz |
| Hinweis |
Fehlergrund oder Kommentar |
5. Mögliche Folgeaktionen
| Aktion |
Beschreibung |
| Einladung erneut vorbereiten |
öffnet KP-02 oder KP-03 |
| Einladung widerrufen |
macht offenen Link ungültig |
| Fehler in UC07 öffnen |
öffnet Versandstatus / Fehler in UC07 |
| Kundendaten korrigieren |
öffnet Kundenstamm / UC01-Kontext |
| Portalzugang sperren |
setzt Portalstatus auf blocked |
| Portalzugang reaktivieren |
hebt Sperre auf, falls berechtigt |
| zurück zur Übersicht |
öffnet KP-01 |
6. Validierungen / Regeln
| ID |
Regel |
| KP04-R01 |
KP-04 zeigt nur Einladungen des eigenen Tenants |
| KP04-R02 |
widerrufene Einladungen dürfen nicht mehr angenommen werden |
| KP04-R03 |
abgelaufene Einladungen dürfen nicht mehr angenommen werden |
| KP04-R04 |
erneuter Versand erzeugt eine neue kontrollierte Einladung oder aktualisierte Einladung |
| KP04-R05 |
fehlgeschlagene Einladungen müssen Fehlergrund und Zeitpunkt enthalten |
| KP04-R06 |
Versandfehler werden aus UC07 übernommen |
| KP04-R07 |
Statuswechsel müssen protokolliert werden |
| KP04-R08 |
Portalzugang darf nicht ohne Berechtigung gesperrt oder reaktiviert werden |
| KP04-R09 |
vollständige Token dürfen nicht angezeigt werden |
7. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| Einladung versendet |
„Einladung wurde versendet." |
| Einladung angenommen |
„Einladung wurde angenommen." |
| Einladung abgelaufen |
„Einladung ist abgelaufen." |
| Einladung widerrufen |
„Einladung wurde widerrufen." |
| Versand fehlgeschlagen |
„Versand fehlgeschlagen." mit Fehlergrund |
| erneuter Versand möglich |
„Einladung kann erneut vorbereitet werden." |
| erneuter Versand blockiert |
„Erneuter Versand aktuell nicht möglich." |
| 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 |
| Versandlog |
UC07 / notification_log |
| Aktivität |
customer_portal_activity_log |
| Audit |
audit_log |
9. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Token-Schutz |
vollständige Token nicht anzeigen |
| Rollenprüfung |
Widerruf, Sperre und Reaktivierung schützen |
| Fehlertransparenz |
Fehler sichtbar und nachvollziehbar halten |
| Protokollierung |
Statuswechsel, Benutzer und Zeitpunkt speichern |
| UC07-Bezug |
Versanddetails nur soweit notwendig anzeigen |
10. Akzeptanzkriterien
| ID |
Kriterium |
| KP04-AC01 |
Benutzer kann KP-04 aus KP-01 oder KP-03 öffnen |
| KP04-AC02 |
System zeigt Portalstatus, Einladungsstatus und Versandstatus |
| KP04-AC03 |
System zeigt Ablaufdatum und letzten Versandversuch |
| KP04-AC04 |
System zeigt Fehlergrund bei fehlgeschlagenem Versand |
| KP04-AC05 |
Benutzer kann abgelaufene oder fehlgeschlagene Einladung erneut vorbereiten |
| KP04-AC06 |
Benutzer kann offene Einladung widerrufen, falls berechtigt |
| KP04-AC07 |
Widerrufene oder abgelaufene Einladungen sind nicht mehr aktivierbar |
| KP04-AC08 |
KP-04 zeigt keine fremden Tenant-Daten |
| KP04-AC09 |
vollständige Token werden nicht angezeigt |
| KP04-AC10 |
Statuswechsel werden protokolliert |
11. Offene Punkte
| ID |
Frage |
Status |
| KP04-O01 |
Wird erneuter Versand mit neuer Einladung oder gleicher Einladung umgesetzt? |
technisch klären, Empfehlung: neuer Token |
| KP04-O02 |
Darf mitarbeiter Einladungen widerrufen? |
offene Rollenentscheidung |
| KP04-O03 |
Wird Statusverlauf als eigenes Audit-Log angezeigt? |
sinnvoll |
| KP04-O04 |
Wie lange bleiben Einladungsverläufe sichtbar? |
Datenschutz / Aufbewahrung klären |
| KP04-O05 |
Wird Fehlerdetail aus UC07 vollständig oder gekürzt angezeigt? |
Empfehlung: gekürzt |
Ä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 |