KP-01 – Kundenportal-Übersicht intern
Stand : 2026-08-01, 11:12:55
Branch: main
Status: Abgeschlossen
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 01.08.2026 11:12 |
1.0 |
Kopfbereich ergänzt |
David |
Use Case: UC06 – Kunden einladen & Portal
Screen: KP-01
Status: erster Vorschlag
Stand: Mai 2026
1. Zweck
KP-01 ist die interne Übersicht für Kundenportal-Zugänge und Einladungen.
Der Screen zeigt je Kunde den aktuellen Portalstatus, Einladungsstatus, letzte Aktivität, mögliche Fehler, Sperren und nächste Aktionen. KP-01 ist der Einstiegspunkt für interne Benutzer, um Kunden einzuladen, Einladungen erneut zu senden, Einladungen zu widerrufen oder Portalzugänge zu prüfen.
KP-01 ist eine interne Verwaltungsansicht. Kunden nutzen diesen Screen nicht.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
vollständige Übersicht, Einladungen und Portalzugänge verwalten |
mitarbeiter |
optional, Portalstatus prüfen und ggf. Einladungen vorbereiten |
kunde |
keine interne Ansicht |
superadmin |
nicht Zielnutzer dieses Tenant-Screens |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| Hauptnavigation |
Menüpunkt „Kundenportal" |
| Kundenstamm |
Absprung aus Kundendetail |
| UC07 |
Rücksprung aus Einladungs- oder Benachrichtigungsstatus |
| UC05 |
Portalbezug aus Fristenhinweis |
4.1 Kopfbereich
| Information |
Beschreibung |
| Anzahl Kunden |
alle Kunden im Tenant |
| nicht eingeladen |
Kunden ohne Einladung |
| eingeladen |
Einladung versendet, noch nicht angenommen |
| aktiv |
Kunden mit aktivem Portalzugang |
| abgelaufen |
Einladung abgelaufen |
| gesperrt |
Portalzugang gesperrt |
| fehlgeschlagen |
Einladung konnte nicht zugestellt werden |
4.2 Kundenliste
| Spalte |
Beschreibung |
| Kunde |
Name / Kundennummer |
| E-Mail |
primäre Kontaktadresse |
| Portalstatus |
not_invited, invited, active, blocked usw. |
| Einladungsstatus |
draft, invited, accepted, expired, revoked, failed |
| letzte Einladung |
Datum / Uhrzeit |
| letzter Login |
Datum / Uhrzeit oder nie |
| Equipment |
Anzahl zugeordneter Equipment-Datensätze |
| Fristenhinweise |
Anzahl relevanter Fristen aus UC05 |
| Aktion |
einladen, erneut senden, sperren, Details öffnen |
5. Filter und Sortierung
| Filter |
Beschreibung |
| Portalstatus |
nicht eingeladen, eingeladen, aktiv, gesperrt |
| Einladungsstatus |
invited, expired, failed, revoked |
| E-Mail vorhanden |
ja / nein |
| letzte Aktivität |
aktiv, nie eingeloggt, länger inaktiv |
| Fristenhinweis |
mit offenen Fristen, ohne offene Fristen |
| Kunde |
Suche nach Name / Kundennummer |
| Sortierung |
Zweck |
| Status |
problematische Einträge zuerst |
| Kunde |
alphabetische Übersicht |
| letzte Einladung |
neueste oder älteste Einladungen |
| letzter Login |
inaktive Kunden erkennen |
| Fristenhinweise |
Kunden mit Handlungsbedarf priorisieren |
6. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Kunde einladen |
öffnet KP-02 |
| Einladungsvorschau öffnen |
öffnet KP-03 |
| Einladungsstatus prüfen |
öffnet KP-04 |
| Portalzugang sperren |
setzt Portalstatus auf blocked, falls berechtigt |
| Portalzugang reaktivieren |
berechtigte Aktion, falls fachlich erlaubt |
| Kundenportal-Sicht prüfen |
öffnet KP-06 / interne Vorschau, falls erlaubt |
| Equipment & Fristen öffnen |
öffnet KP-07 oder UC05-Kontext |
| Änderungsanfragen öffnen |
öffnet KP-08 |
7. Validierungen / Regeln
| ID |
Regel |
| KP01-R01 |
KP-01 zeigt nur Kunden des eigenen Tenants |
| KP01-R02 |
Kunden ohne gültige E-Mail können nicht direkt eingeladen werden |
| KP01-R03 |
bereits aktive Kunden werden nicht erneut als neu eingeladen |
| KP01-R04 |
abgelaufene Einladungen können kontrolliert erneut vorbereitet werden |
| KP01-R05 |
widerrufene Einladungen sind nicht mehr aktivierbar |
| KP01-R06 |
gesperrte Portalzugänge müssen deutlich sichtbar sein |
| KP01-R07 |
Kunden dürfen keine internen Prüfnotizen oder fremde Daten sehen |
| KP01-R08 |
Einladungsversand erfolgt über UC07, nicht direkt aus KP-01 |
| KP01-R09 |
Sperren, Reaktivierungen und Widerrufe müssen protokolliert werden |
8. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| keine Kunden |
„Keine Kunden vorhanden." |
| keine E-Mail |
„Einladung nicht möglich: E-Mail-Adresse fehlt." |
| Einladung abgelaufen |
„Einladung abgelaufen – erneut senden möglich." |
| Einladung fehlgeschlagen |
„Einladung konnte nicht zugestellt werden." |
| Portalzugang aktiv |
grüner Status „aktiv" |
| Portalzugang gesperrt |
roter Status „gesperrt" |
| keine Berechtigung |
„Du bist für diese Aktion nicht berechtigt." |
9. Bezug zu Datenmodell
| Bereich |
Bezug |
| Kunden |
customers |
| Portalzugang |
customer_portal_accounts |
| Einladungen |
customer_invitations |
| Token |
customer_invitation_tokens |
| Portalaktivität |
customer_portal_activity_log |
| Fristen |
UC05 / next_due_date, due_status |
| Benachrichtigung |
UC07 / notification_queue, notification_log |
| Audit |
audit_log |
10. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Rollenprüfung |
Aktionen rollenbasiert einschränken |
| Kundendaten |
nur notwendige interne Verwaltungsdaten anzeigen |
| kein Direktversand |
Versand über UC07 |
| Protokollierung |
Einladung, Widerruf, Sperre und Reaktivierung speichern |
| Kundensicht |
keine internen Notizen oder fremden Kundendaten |
11. Akzeptanzkriterien
| ID |
Kriterium |
| KP01-AC01 |
tenant_admin kann KP-01 öffnen |
| KP01-AC02 |
System zeigt Kunden des eigenen Tenants mit Portalstatus |
| KP01-AC03 |
System zeigt Einladungsstatus, letzte Einladung und letzten Login |
| KP01-AC04 |
System markiert fehlende E-Mail-Adressen |
| KP01-AC05 |
Benutzer kann KP-02 zum Einladen öffnen |
| KP01-AC06 |
Benutzer kann KP-04 zur Statusprüfung öffnen |
| KP01-AC07 |
System verhindert Einladung ohne gültige E-Mail |
| KP01-AC08 |
KP-01 zeigt keine fremden Tenant-Daten |
| KP01-AC09 |
Einladungsversand erfolgt nicht direkt in KP-01 |
| KP01-AC10 |
Sperren und Reaktivierungen werden protokolliert |
12. Offene Punkte
| ID |
Frage |
Status |
| KP01-O01 |
Darf mitarbeiter Kunden einladen? |
offene Rollenentscheidung |
| KP01-O02 |
Wird eine interne Portalvorschau angeboten? |
optional, Sicherheitsprüfung nötig |
| KP01-O03 |
Werden Fristenhinweise direkt in KP-01 gezählt? |
sinnvoll, Bezug zu UC05 |
| KP01-O04 |
Wird letzter Login in V1 gespeichert? |
sinnvoll, technisch prüfen |
| KP01-O05 |
Darf Portalzugang direkt aus KP-01 gesperrt werden? |
Vorschlag: ja für tenant_admin |