Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/designer-briefs/P02-identitaet-mandantentrennung.md

6.5 KiB
Raw Permalink Blame History

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) Quellen: ROADMAP.md §Phase 2 · SCREEN-MAP.md §1 AUTH-SCREENS · REQUIREMENTS.md Modul 27 (REQ-auth-multi-tenancy, -methoden, -rbac, -user-lifecycle) · ENTITY-MODEL.md Domäne 1 (Tenant/User/TenantUser/TenantRole/Permission/Group/Invitation/Session) · _bmad-output/specs/M27-auth-multi-tenancy.md Subframe: Pflicht je Route. Archetypen aus D0 (A4 Form/Input, A5 Modal/Wizard, A6 Settings, A2 Liste).

⚙️ 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-Seed; Login mit Email+Passwort (NIST/Breach-Check) plus TOTP-2FA; serverseitige Sessions in Postgres (Geräte-Liste, Revoke, „überall abmelden") mit Redis-Cache; 6 SHK-Standard-Rollen geseedet; 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).

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 · 6 SHK-Rollen vorgeseedet · 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
  • 6 SHK-Standard-Rollen geseedet; 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/PHASE-SOURCES nachgezogen:
  • Plane-Ticket (R-P2a/b) aktualisiert: