BU-05 – Einladung verwalten
Stand: 13.10.2026 14:15
Branch: main
Status: erster Vorschlag
Änderungshistorie anzeigen
Use Case: UC08 – Benutzerverwaltung
Screen: BU-05
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
BU-05 dient zur Verwaltung bestehender Benutzereinladungen innerhalb eines Tenants.
Der Tenant-Admin kann offene, abgelaufene, angenommene oder widerrufene Einladungen prüfen, eine Einladung erneut versenden, eine offene Einladung widerrufen oder Details zur Einladung nachvollziehen.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
verwaltet Einladungen des eigenen Tenants |
mitarbeiter |
keine Berechtigung zur Einladungsverwaltung in V1 |
kunde |
keine Nutzung dieser internen Ansicht |
superadmin |
nicht Zielnutzer dieses Screens |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| BU-01 |
Bereich „Offene Einladungen“ |
| BU-02 |
nach Versand einer neuen Einladung |
| BU-03 |
bei Benutzerstatus invited |
| Audit-Prüfung |
Kontrolle von Einladungsvorgängen |
4.1 Einladungsübersicht
| Spalte |
Beschreibung |
| E-Mail |
eingeladene Adresse |
| Rolle |
vorgesehene Rolle nach Annahme |
| Status |
pending, accepted, expired, revoked |
| eingeladen durch |
Benutzer, der Einladung erstellt hat |
| erstellt am |
Erstellzeitpunkt |
| gültig bis |
Ablaufdatum |
| letzter Versand |
Zeitpunkt des letzten Versandversuchs; von der UC00-Programmierschnittstelle derzeit bewusst nicht geliefert (BU05-O05) |
| Zustellung |
Versand ausstehend, versendet, Versandfehler, unzustellbar; abgeleitet aus delivery_status gemäss ADR-024 |
| Aktionen |
erneut senden, widerrufen, Detail öffnen |
4.2 Detailbereich
| Feld |
Beschreibung |
| Einladung-ID |
technische Referenz |
| Tenant |
Tenant-Bezug |
| Token-Status |
aktiv, abgelaufen, widerrufen, angenommen |
| Token-Hash |
nicht sichtbar im UI |
| Annahmezeitpunkt |
falls akzeptiert |
| Widerrufszeitpunkt |
falls widerrufen |
| Widerrufsgrund |
falls erfasst |
| Zustellung |
Versand ausstehend (queued), versendet (sent), Versandfehler (send_failed), unzustellbar (undeliverable); ohne Fehlercodes oder Providertexte |
5. Aktionen
| Aktion |
Beschreibung |
| Einladung erneut senden |
erzeugt neuen Token und versendet neue E-Mail |
| Einladung widerrufen |
macht Einladung dauerhaft ungültig |
| Einladung detailieren |
zeigt technische und fachliche Details |
| neue Einladung erstellen |
öffnet BU-02 |
| zur Benutzerübersicht |
zurück zu BU-01 |
| Audit öffnen |
öffnet BU-08 gefiltert auf Einladung |
6. Validierungen / Regeln
| ID |
Regel |
| BU05-R01 |
Nur tenant_admin darf Einladungen verwalten |
| BU05-R02 |
Einladungen sind tenant-isoliert |
| BU05-R03 |
Token werden niemals im Klartext angezeigt |
| BU05-R04 |
Erneuter Versand erzeugt einen neuen Token oder invalidiert den alten Token |
| BU05-R05 |
Widerrufene Einladungen dürfen nicht erneut angenommen werden |
| BU05-R06 |
Abgelaufene Einladungen dürfen nicht angenommen werden |
| BU05-R07 |
Angenommene Einladungen dürfen nicht widerrufen werden |
| BU05-R08 |
Widerruf benötigt optional oder verpflichtend einen Grund; für V1 empfohlen: Pflichtgrund |
| BU05-R09 |
Erneuter Versand und Widerruf müssen auditierbar sein |
| BU05-R10 |
Einladung als tenant_admin muss deutlich als administrativ markiert werden |
7. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| keine Einladungen |
„Keine Einladungen vorhanden.“ |
| Einladung pending |
Badge „offen“ |
| Einladung abgelaufen |
Badge „abgelaufen“ |
| Einladung widerrufen |
Badge „widerrufen“ |
| Einladung angenommen |
Badge „angenommen“ |
| erneuter Versand erfolgreich |
„Einladung wurde erneut versendet.“ |
| Widerruf erfolgreich |
„Einladung wurde widerrufen.“ |
| Token nicht sichtbar |
Hinweis „Token wird aus Sicherheitsgründen nicht angezeigt.“ |
| Zustellung unzustellbar |
Badge „unzustellbar“ und Hinweis „Die Einladung konnte nicht zugestellt werden. Bitte E-Mail-Adresse prüfen.“ (UC00 G151) |
| Zustellung mit Versandfehler |
Badge „Versandfehler“; erneuter Versand möglich |
8. Bezug zu Datenmodell
| Bereich |
Bezug |
| Einladung |
user_invitations |
| Tenant |
tenant_id |
| Rolle |
role |
| Token |
token_hash |
| Ablauf |
expires_at |
| Status |
pending, accepted, expired, revoked |
| Versand |
notification_log mit Verweis invitation_token_id; daraus abgeleitet delivery_status (ADR-024) |
| Annahme |
accepted_at |
| Widerruf |
revoked_at, revoked_by, revocation_reason |
| Audit |
audit_log |
9. Sicherheits- und Audit-Bezug
| Thema |
Umsetzung |
| Token-Schutz |
Token nicht anzeigen, nur Hash speichern |
| erneuter Versand |
neuer Token, alter Token ungültig |
| Widerruf |
Einladung endgültig ungültig machen |
| administrative Rolle |
Warnhinweis bei tenant_admin-Einladung |
| Audit |
Erstellung, erneuter Versand, Widerruf und Annahme nachvollziehbar |
10. Akzeptanzkriterien
| ID |
Kriterium |
| BU05-AC01 |
tenant_admin kann Einladungen des eigenen Tenants sehen |
| BU05-AC02 |
System zeigt Status, Rolle, Ablaufdatum und Versandstatus |
| BU05-AC03 |
tenant_admin kann offene Einladungen erneut senden |
| BU05-AC04 |
tenant_admin kann offene Einladungen widerrufen |
| BU05-AC05 |
widerrufene oder abgelaufene Einladungen können nicht angenommen werden |
| BU05-AC06 |
Token wird im UI nicht angezeigt |
| BU05-AC07 |
erneuter Versand und Widerruf werden auditierbar protokolliert |
| BU05-AC08 |
angenommene Einladungen können nicht widerrufen werden |
| BU05-AC09 |
tenant_admin erkennt unzustellbare Einladungen an Badge und Hinweis (UC00 G151) |
11. Offene Punkte
| ID |
Frage |
Status |
| BU05-O01 |
Ist Widerrufsgrund Pflicht? |
Vorschlag: Ja für V1 |
| BU05-O02 |
Wie lange bleiben alte Einladungen sichtbar? |
offen |
| BU05-O03 |
Erneuter Versand: alter Token sofort ungültig? |
Vorschlag: Ja |
| BU05-O04 |
Wird Versandfehler automatisch erneut versucht? |
offen / später |
| BU05-O05 |
Wird der Zeitpunkt des letzten Versands im UI benötigt? Die UC00-Programmierschnittstelle liefert ihn aus Gründen der Datenminimierung derzeit nicht. |
offen |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 13.10.2026 14:15 |
1.4 |
Zustellstatus gemäss ADR-024 ergänzt: Spalte und Badge «unzustellbar» mit Hinweis, Detailfeld, Datenmodellbezug, Akzeptanzkriterium BU05-AC09 und offener Punkt BU05-O05; Wireframes (SVG, JSX) nachgeführt |
Claude |
| 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 |
Branch-Angabe im Kopfbereich auf main korrigiert |
Claude |
| 01.08.2026 14:55 |
1.0 |
Kopfbereich vereinheitlicht |
David Mittig |