6.7 KiB
Designer-Brief · P2 — Identität & Mandantentrennung
Phase: 2/21 · Modul: M27 (Auth / Multi-Tenancy / RBAC / Sessions) · Owner-Dev: Raffael (R-P2a/b) · Designer: David (D-P2, fällig So 21.06. mit D0-Baseline)
Aktive Quellen: zugehörige Ticket-Docs · ROADMAP.md/ROADMAP-V2.md · REQUIREMENTS.md · ENTITY-MODEL.md.
Subframe: Pflicht je Route. Archetypen aus D0 (A4 Form/Input, A5 Modal/Wizard, A6 Settings, A2 Liste).
🖥️ Interim-UI gebaut (AD-28): Screen-Referenz in ../HiveGrid-Wireframes/Tickets/Interim-Handover/P02-Auth-RBAC.md — David-Delta (D-P2) liegt bereits vor, dient nur dem Konsistenz-Abgleich.
⚙️ Scope-Hinweis (Scope-Schnitt 12.06.): API-Keys (M027) → v2 mit Public-API; das Boilerplate-
ApiKey-Modell bleibt ungenutzt im Code — kein API-Key-Screen in v1. Magic-Link ist v1 nur als Login-Alternative (das exklusive Customer-Portal-Magic-Link gehört zu v2/P26). Sprache fest DE — kein Sprach-Wechsler im Profil.
Was dieses Modul tut (Kurzfassung)
Ein Handwerksbetrieb registriert sich selbst, meldet sich sicher an und arbeitet in einem vollständig RLS-isolierten Mandanten mit rollenbasierten Rechten. Self-Service-Signup erzeugt Tenant + auto-generierten Slug (Reserved-Words geblockt) + Auto-SHK-Defaults; Login mit Email+Passwort (NIST/Breach-Check) plus TOTP-2FA; serverseitige Sessions in Postgres (Geräte-Liste, Revoke, „überall abmelden") mit Redis-Cache; fünf editierbare SHK-Tenant-Rollen werden angelegt und der Owner erhält ausschließlich die globale Rolle Admin; Admin kann Nutzer einladen (48h-Token), deaktivieren (mit Reassign-Workflow) und DSGVO-konform per PII-Anonymisierung löschen. RLS-Policies verhindern nachweisbar mandantenübergreifenden Datenzugriff (AD-1/AD-29).
Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
Signup [/signup] |
Email, Passwort (Stärke-Anzeige + Breach-Check-Hinweis), Firmenname, Vor-/Nachname, Telefon, USt-ID, AGB/DSGVO/AVV-Checkboxen → erzeugt Tenant + Auto-SHK-Seed (kein Wizard) | A4 |
Login [/login] |
Email, Passwort, mCaptcha ab 3. Fehlversuch, Magic-Link-Alternative | A4 |
| 2FA-Eingabe | 6-stelliger TOTP-Code, Trust-Device-Checkbox | A4/A5 |
Passwort vergessen [/forgot-password] |
Email-Eingabe → Magic-Link | A4 |
| Tenant-Auswahl | Tenant-Liste mit zuletzt-genutzt, Suchfeld (Erst-Login mit ≥2 Tenants); plus Klartext-Screen „ohne Tenant" mit Funktionen „Neuen Workspace anlegen" / „Auf Einladung warten" | A2 |
Session-Verwaltung [/settings/security] |
Aktive Sessions (Gerät, Browser, IP, Standort, letzte Aktivität) + Abmelden je Session + „überall abmelden" · Trust-Device-Liste mit Revoke | A2/A6 |
Profil [/settings/profile] |
Name, Avatar, Telefon, Passwort ändern, 2FA einrichten (QR), Hell/Dunkel-Toggle (Sprache fest DE — kein Wechsler v1) | A6 |
Rollen-Editor [/admin/roles] |
Rollen-Liste (Name, User-Anzahl) · Editor: Name, Beschreibung, Permission-Bundles + Advanced-Einzelrechte · fünf editierbare SHK-Tenant-Rollen vorgeseedet; Owner ausschließlich mit globaler Rolle Admin · Löschen mit Block bei zugewiesenen Usern → Ersatz-Rolle/Bulk-Reassign |
A2+A6 |
Gruppen [/admin/groups] |
Gruppen-Liste mit Mitgliederzahl, Bulk-Add/Remove | A2 |
Mitarbeiter [/admin/users] |
User-Liste (Name, Email, Rolle, Status, 2FA) · Einladungs-Modal (Email, Rolle, Gruppen, Nachricht) · Einladungs-Status-Liste · Deaktivieren mit Reassign-Workflow (offene Verknüpfungen anzeigen, Bulk-Übertragung) | A2+A5 |
Konto löschen [/settings/account] |
Multi-Step: Erklärung → optional Daten-Export → Passwort+2FA → Countdown-Bestätigung · Block-Edge-Case wenn einziger Tenant-Admin (Klartext + Direkt-Link zum Lösen) | A5 |
(API-Keys → v2. Audit/Notif/Files/Tasks-Oberflächen → P3/P4. Plattform-Admin-Welt → P19.)
Geplante Features (muss abgedeckt sein)
- Self-Service-Signup mit auto-generiertem Tenant-Slug (Reserved-Words geblockt), Auto-SHK-Seed, Landing unter app.hivegrid.de
- Login Email+Passwort (NIST-konform, Have-I-Been-Pwned-Breach-Check mit Klartext-Block) + mCaptcha ab 3. Fehlversuch + Magic-Link-Alternative
- TOTP-2FA (RFC 6238) mit QR-Einrichtung + Trust-Device
- Serverseitige Postgres-Sessions (Geräte-Liste, Revoke einzeln, „von allen Geräten abmelden") mit Redis-Cache (AD-4)
- RLS-Policies (USING/WITH CHECK,
SET LOCAL app.tenant_id, App-Rolle ohne BYPASSRLS) verhindern nachweisbar Cross-Tenant-Zugriff (AD-1) — Backend, aber prägt „keine-Berechtigung"-Zustände der UI - Fünf editierbare SHK-Tenant-Rollen angelegt; Owner ausschließlich mit globaler Rolle
Admin; Rollen-/Gruppen-Verwaltung (Permission-Bundles + Advanced-Einzelrechte) - User-Einladung (48h-Token), Soft-Deaktivierung mit Reassign-Workflow, DSGVO-Löschung via PII-Anonymisierung ohne Audit-Trail-Verlust
- Multi-Tenant-Membership: Tenant-Auswahl-Screen + Tenant-Switcher (Topbar aus P1) + „ohne Tenant"-Screen
- (→ v2)
API-Key-Verwaltung mit Scopes/Rate-Limit— wandert mit Public-API (M161–163)
Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Auth-Formulare mit Email/Passwort-Feldern, Passwort-Stärke-Anzeige + Breach-Klartext-Block, Checkbox-Reihe (AGB/DSGVO/AVV); mCaptcha-Einbindungs-Slot; TOTP-Code-Eingabe (6-stellig) + Trust-Device-Checkbox + QR-Code-Anzeige für 2FA-Setup; Magic-Link-Hinweis/-Trigger; Tenant-Auswahl-Liste mit zuletzt-genutzt + Suchfeld; „ohne Tenant"-Klartext-Screen mit zwei Aktions-Buttons; Session-Tabelle (Gerät/Browser/IP/Standort/letzte-Aktivität) mit Per-Zeile-Abmelden + „überall abmelden"-Button + Trust-Device-Revoke-Liste; Profil-Settings mit Avatar-Upload, Inline-Edit-Feldern, Passwort-ändern-Block, 2FA-Einrichtungs-Block, Theme-Toggle; Rollen-Liste + Rollen-Editor mit Permission-Bundle-Auswahl und ausklappbaren Advanced-Einzelrechten; Rollen-Lösch-Dialog mit Ersatz-Rollen-Picker/Bulk-Reassign; Gruppen-Liste mit Bulk-Add/Remove; User-Liste mit Status-/2FA-Badges; Einladungs-Modal (Email/Rolle/Gruppen/Nachricht) + Einladungs-Status-Liste; Deaktivierungs-Workflow-Panel das offene Verknüpfungen auflistet + Bulk-Übertragungs-Picker; mehrstufiger Konto-Lösch-Wizard mit optionalem Daten-Export-Schritt, Passwort+2FA-Gate, Countdown-Bestätigung und Block-Klartext für den einzigen-Admin-Edge-Case; Klartext-Fehler- und Empty-/Loading-/Permission-Denied-States.
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev:
Dev-Nachzug (wir nach Davids Delta)
- Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
- REQUIREMENTS/ROADMAP nachgezogen:
- Plane-Ticket (R-P2a/b) aktualisiert: