Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -1,73 +1,80 @@
# R-P2a · P2 Mandant + Auth (Email/PW/HIBP) + Sessions + TOTP
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P2 — Identität & Mandantentrennung |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-19 · Gate W1 |
| **Status** | geplant |
| | |
| ----------------- | ------------------------------------------------------------ |
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P2 — Identität & Mandantentrennung |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-19 · Gate W1 |
| **Status** | Done (Plane; Stand-Audit 2026-07-17: 6/6 DoD im Code belegt) |
**🎨 design-nachzug: offen** (seit 2026-07-06) — Interim-UI (`new-account` „Workspace anlegen / ohne Tenant") aus `~/ui` steht; finale Subframe-Optik aus `D-P2` (Signup/2FA/Geräteliste/Tenant-Auswahl/new-account) ausstehend, nicht Done-blockierend (AD-28).
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P1b` (Service-Kerne + Konnektor), `EXT-12` (Geo-IP + HIBP anbinden), `AK-INFRA2` (mCaptcha per ENV)
- **Blocks:** `R-P2b` (RLS-Härtung baut auf dem Auth-/Tenant-Kern auf)
- **Läuft parallel zu:** Akeshans P4-Schiene (`AK-P4a`/`AK-P4b`, Files/Tasks) — **erstes echtes Code-Paar P2‖P4.** Disjunkte Domänen (Identität vs. Files/Tasks), eigene `prisma/schema/*.prisma` je Modul → **kein Schema-Konflikt** (AD-21).
- **Konflikt-Risiko:** gering — Berührung an `core.prisma`/`accounts.prisma` (Tenant/User), aber Felder additiv; db push auf Branch, Migration erst beim Merge.
## Was wir bauen
Den **Auth- und Mandanten-Kern**: Self-Service-Signup, der Tenant + auto-generierten Slug (Reserved-Words geblockt) + Auto-SHK-Seed erzeugt; Login mit Email+Passwort (NIST-konform, Have-I-Been-Pwned-Breach-Block + Brute-Force-Schutz mit mCaptcha ab 3. Fehlversuch); **TOTP-2FA** (RFC 6238, QR-Setup + Trust-Device); serverseitige **Sessions** in Postgres (Source-of-Truth, Geräte-Liste, Revoke einzeln / „überall abmelden") mit Redis-Cache (AD-4). Multi-Tenant-Membership inkl. Tenant-Auswahl.
## Benötigte Screens (Backend bedient — Design liefert `D-P2` aus `D-D0a`/`D-D0b`)
| Screen [Route] | Kern-Inhalt | Liefert (Design) |
|---|---|---|
| Signup [`/signup`] | Email, PW (Stärke + Breach-Hinweis), Firmenname, Name, Telefon, USt-ID, AGB/DSGVO/AVV → Tenant + Auto-SHK-Seed | `D-P2` (A4) |
| Login [`/login`] | Email, PW, mCaptcha ab 3. Fehlversuch, Magic-Link-Alternative | `D-P2` (A4) |
| 2FA-Eingabe | 6-stelliger TOTP-Code, Trust-Device | `D-P2` (A4/A5) |
| Passwort vergessen [`/forgot-password`] | Email → Magic-Link | `D-P2` (A4) |
| Tenant-Auswahl + „ohne Tenant" | Tenant-Liste (zuletzt genutzt, Suche) / Workspace anlegen / auf Einladung warten | `D-P2` (A2) |
| Session-Verwaltung [`/settings/security`] | Aktive Sessions (Gerät/Browser/IP/Standort) + Revoke + „überall abmelden" + Trust-Device-Revoke | `D-P2` (A2/A6) |
| Profil [`/settings/profile`] | Name, Avatar, Telefon, PW ändern, 2FA (QR), Hell/Dunkel (Sprache fest DE) | `D-P2` (A6) |
*(Davids P2-Screens werden über das Ticket `D-P2` geliefert — komponiert aus `D-D0a`/`D-D0b`.)*
| Screen [Route] | Kern-Inhalt | Liefert (Design) |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ---------------- |
| Signup [`/signup`] | Email, PW (Stärke + Breach-Hinweis), Firmenname, Name, Telefon, USt-ID, AGB/DSGVO/AVV → Tenant + Auto-SHK-Seed | `D-P2` (A4) |
| Login [`/login`] | Email, PW, mCaptcha ab 3. Fehlversuch, Magic-Link-Alternative | `D-P2` (A4) |
| 2FA-Eingabe | 6-stelliger TOTP-Code, Trust-Device | `D-P2` (A4/A5) |
| Passwort vergessen [`/forgot-password`] | Email → Magic-Link | `D-P2` (A4) |
| Tenant-Auswahl + „ohne Tenant" | Tenant-Liste (zuletzt genutzt, Suche) / Workspace anlegen / auf Einladung warten | `D-P2` (A2) |
| Session-Verwaltung [`/settings/security`] | Aktive Sessions (Gerät/Browser/IP/Standort) + Revoke + „überall abmelden" + Trust-Device-Revoke | `D-P2` (A2/A6) |
| Profil [`/settings/profile`] | Name, Avatar, Telefon, PW ändern, 2FA (QR), Hell/Dunkel (Sprache fest DE) | `D-P2` (A6) |
_(Davids P2-Screens werden über das Ticket `D-P2` geliefert — komponiert aus `D-D0a`/`D-D0b`.)_
## Definition of Done
> Alle Bausteine code-seitig gebaut + getestet (3741 Tests grün, Branch `p2a-auth-tenant`). Haken = umgesetzt; finale Screen-Optik/Abnahme läuft über `D-P2` (Ticket steht daher auf **Blocked / wartet-auf-screen**, nicht Done).
- [x] Self-Service-Signup + Auto-Slug (Reserved-Words geblockt) + Auto-SHK-Seed *(Signup+Slug fertig; Auto-SHK-Seed bewusst → P6, da CRM-Entitäten erst dort existieren)*
- [x] Self-Service-Signup + Auto-Slug (Reserved-Words geblockt) + Auto-SHK-Seed _(Signup+Slug fertig; Auto-SHK-Seed bewusst → P6, da CRM-Entitäten erst dort existieren)_
- [x] Login Email/PW + **HIBP-Breach-Block** (NIST) + Brute-Force (mCaptcha ab 3. Fehlversuch) + Magic-Link-Alternative
- [x] **TOTP-2FA** (RFC 6238, QR-Setup + Trust-Device)
- [x] **Sessions Postgres-SoT + Redis-Cache** (AD-4): Geräte-Liste, Revoke einzeln, „überall abmelden"
- [x] Multi-Tenant-Membership + Tenant-Auswahl-Screen *(Backend + Routen fertig; finale Screen-Optik via `D-P2`)*
- [x] Multi-Tenant-Membership + Tenant-Auswahl-Screen _(Backend + Routen fertig; finale Screen-Optik via `D-P2`)_
- [x] Konnektor: alle Auth-/Settings-Routen sitzen im App-Shell-Gating (R-P1c)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/accounts.prisma` bzw. `auth.prisma`): `Tenant` (slug, status trial/active/past_due/frozen/suspended/deletion_pending, default_language), `User` (email, language, timezone, theme_preference — **global, kein RLS**), `TenantUser`, `Session` (Postgres-SoT + Redis-Cache, browser_fingerprint), `TenantUserInvitation` (48h, Anlage hier vorbereitet). Boilerplate-`ApiKey`-Modell bleibt **ungenutzt** (Scope-Schnitt → v2, nicht in Sidebar).
- **RLS** auf `Tenant`/`TenantUser`/`Session` (AD-1); `User` global ohne RLS.
- Auth-Block hat HIGH-Boilerplate-Coverage (`apps/web/app/services/auth/`) — wiederverwenden; **RLS = Eigenbau** (Boilerplate nur App-Level-Scoping).
- `is_demo_data`-Flag am Auto-SHK-Seed (Bulk-Lösch beim Echt-Start).
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 1: Identität & Mandanten** (Tenant/User/TenantUser/Session/Invitation) + Tenant/User-Achse
- `REQUIREMENTS.md` → `REQ-auth-multi-tenancy`, `REQ-auth-methoden`
- `ROADMAP.md` → Phase 2 · `PHASE-SOURCES.md` → Phase 2 (M018/M020/M021/M022)
- `ROADMAP.md` → Phase 2 · Milestones: (M018/M020/M021/M022)
- `designer-briefs/P02-identitaet-mandantentrennung.md` · Ticket-Doc `D-P2.md`
- `_bmad-output/specs/M27-auth-multi-tenancy.md`
## Dev-Nachzug (nach Davids `D-P2`-Delta)
- [x] **Interim-UI aus `~/ui` gebaut (AD-28, 2026-07-06, Akeshan-Beitrag).** Der bisher einzige
handgeschriebene Auth-Screen `new-account` („Workspace anlegen / ohne Tenant") ist jetzt aus `~/ui`
komponiert (`apps/web/app/components/screens/auth/CreateWorkspacePage.tsx`, `AuthShell` + `~/ui`,
VM/Props als Prop, kein handgeschriebenes Tailwind, Fehler als inline `Alert` statt Legacy-`ErrorModal`);
die Route rendert nur noch `<CreateWorkspacePage … />`, die Legacy-`TenantNew` wurde abgelöst/gelöscht.
Die übrigen sechs Auth-Screens (Signup/Login/2FA/Forgot/Tenant-Auswahl/Security/Profil) liefen bereits
auf `~/ui` (Davids WF-P2/D-P2). Zusätzlich M015/M017-Hot-Swap-Stack für die zwei VM-Screens nachgezogen
(session-list, select-tenant): view-models-Mapper + ui-subframe/ui-mock-Renderer + ui-app-Adapter + Tests.
Stabile Marker (`ui.account.create.*`) erhalten, Smoke `tests/e2e/new-account.spec.ts` ergänzt.
handgeschriebene Auth-Screen `new-account` („Workspace anlegen / ohne Tenant") ist jetzt aus `~/ui`
komponiert (`apps/web/app/components/screens/auth/CreateWorkspacePage.tsx`, `AuthShell` + `~/ui`,
VM/Props als Prop, kein handgeschriebenes Tailwind, Fehler als inline `Alert` statt Legacy-`ErrorModal`);
die Route rendert nur noch `<CreateWorkspacePage … />`, die Legacy-`TenantNew` wurde abgelöst/gelöscht.
Die übrigen sechs Auth-Screens (Signup/Login/2FA/Forgot/Tenant-Auswahl/Security/Profil) liefen bereits
auf `~/ui` (Davids WF-P2/D-P2). Zusätzlich M015/M017-Hot-Swap-Stack für die zwei VM-Screens nachgezogen
(session-list, select-tenant): view-models-Mapper + ui-subframe/ui-mock-Renderer + ui-app-Adapter + Tests.
Stabile Marker (`ui.account.create.*`) erhalten, Smoke `tests/e2e/new-account.spec.ts` ergänzt.
- [ ] **Finale Subframe-Optik aus `D-P2`** (Signup/2FA/Geräteliste/Tenant-Auswahl/new-account) — Swap hinter
der stabilen VM/Loader-Grenze; `design-nachzug: offen`, Plane-Label `design-nachzug`. Nicht Done-blockierend (AD-28).
der stabilen VM/Loader-Grenze; `design-nachzug: offen`, Plane-Label `design-nachzug`. Nicht Done-blockierend (AD-28).
- [ ] Auth-Flows an Davids UI-Entscheidungen angepasst (Signup-Felder, 2FA-Flow)
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] REQUIREMENTS/ROADMAP nachgezogen
- [x] Plane-Ticket `R-P2a` aktualisiert (Kommentar + Label `design-nachzug`)
## Umsetzungsstand (Claude, 2026-06-18 — Code-seitig, finale Abnahme mit Davids `D-P2` morgen)
@@ -79,6 +86,7 @@ Den **Auth- und Mandanten-Kern**: Self-Service-Signup, der Tenant + auto-generie
> dem frischen Stand gebaut wird. Den finalen DoD-Haken/Done macht Raffael.
**Gebaut (code-seitig, Slices, je grün + Tests):**
- **S1 — Slug + Reserved-Words** (`tenantService.ts`): `validateDesiredTenantSlug()` (pure, typisierte
Gründe empty/too-short/reserved) + Degenerate-Name-Härtung in `getAvailableTenantSlug`. Der
Reserved-Block selbst lag vor (`isReservedTenantSlug`/`getExistingSlug`). Commit `26b5f90b`.
@@ -102,6 +110,7 @@ Den **Auth- und Mandanten-Kern**: Self-Service-Signup, der Tenant + auto-generie
Konnektor-Gating (R-P1c in `appData`/`AppSidebar`, Settings unter App-Shell) bestehen. Commit `942db7b0`.
**S4b — Session-Hot-Path-Wiring (nachgezogen 2026-06-18, additiv):**
- **S4b-1** (`191f1877`): Login/Signup/Verify legen die `UserSession`-Zeile mit Geräte-Kontext an
(best-effort) und geben den Token ins Cookie; `requireUserId` honoriert Revoke (Cookie zerstören +
`/login`, fail-open bei Store-Fehler, Alt-Cookies ohne Token unberührt); `logout` revoked die Zeile.
@@ -112,6 +121,7 @@ Den **Auth- und Mandanten-Kern**: Self-Service-Signup, der Tenant + auto-generie
- Damit ist die Session-Kette **end-to-end nutzbar** (Login legt an → Revoke/„überall abmelden" greifen).
**D1 — 2FA-Login-Gate + Trust-Device (nachgezogen 2026-06-18, additiv):**
- **Produktentscheidung 18.06.:** TOTP wird beim Tenant-Login **erzwungen** (vorher fragte der Login
keinen Code ab; 2FA lief nur als Step-up für sensible Aktionen). Zweig ist **additiv** — Nicht-TOTP-
Nutzer loggen sich unverändert ein (Regressionstest).
@@ -146,6 +156,7 @@ Den **Auth- und Mandanten-Kern**: Self-Service-Signup, der Tenant + auto-generie
Node 22.12.0. Branch `p2b-rls`, nicht nach `main` gemergt.
**Bewusst ausgelagert / Rest (dokumentiert):**
- **Trust-Device-Konsum + Widerruf**: **vollständig erledigt** (TrustedDevice-Tabelle, Login-Skip,
Geräteliste + Einzel-/Alle-Widerruf in Settings > Sicherheit).
- **Voll-SoT (statt additiv)**: Cookie trägt heute Identität + Token (additiv). Reine Token-im-Cookie-
@@ -169,6 +180,7 @@ war nicht erreichbar, daher db push offen — Migration ohnehin beim Merge). Bra
> Profil. Einziger echter handgeschriebener Rest: `new-account`.
**Gebaut:**
- **Interim-Screen `CreateWorkspacePage`** (`apps/web/app/components/screens/auth/`) aus `AuthShell` + `~/ui`
(`TextInput`/`Button`/`Alert`/`LinkButton`), VM/Props als Prop, kein handgeschriebenes Tailwind. Route
`new-account.tsx` verschlankt (Loader/Action unverändert), Legacy `TenantNew` abgelöst/gelöscht. Fehler
@@ -188,8 +200,39 @@ Windows-Umgebung: `test:hot-swap` (tsx-ESM) + einige undici-`new Request`-Tests
**Offen (nicht Done-blockierend, AD-28):** finale Subframe-Optik aus `D-P2` (`design-nachzug: offen`).
## Status (Stand 2026-06-19)
**Backend ~100 % · Ticket-Abschluss wartet auf `D-P2` (David).** Alle eigenständig baubaren Bausteine
(Signup, Login+HIBP+Brute-Force, Server-Sessions+Revoke, TOTP-Enrollment, 2FA-Login-Gate, Trust-Device
inkl. Tabellen-Widerruf, Session-IP/AD-22) sind fertig + getestet. **Selbst machbar offen: 0.**
**Blockiert:** Davids `D-P2`-Screens (finale Optik Signup/2FA/Geräteliste/Tenant-Auswahl) + finale
Abnahme/Merge. `prisma db push` (TrustedDevice/UserSession) beim Merge.
## Dependency-Nachzug 2026-07-15 · R-P20b
- Der hier bewusst verschobene Auto-SHK-Default ist jetzt zentral in `R-P20b` umgesetzt. Es sind echte Workspace-Defaults, keine Demo-/Seed-Daten.
- Self-Service bleibt der Primärpfad: Signup erzeugt User, Owner-Mitgliedschaft, globale `Admin`-Zuweisung und SHK-Defaults atomar und aktiviert den Tenant erst als letzten DB-Schritt.
- Die sichtbaren AGB-/Datenschutz-Checkboxen werden zusätzlich serverseitig erzwungen; ein direkt gebauter POST kann die UI-Sperre nicht umgehen.
## Regression-Nachzug 2026-07-29 · konfigurierte Pflichtfelder
Der Live-Audit des Staging-Registrierungsflows hat eine serverseitige Lücke
gezeigt: Bei direkter Registrierung übersprang ein gültiges Passwort wegen
einer `else if`-Kette die nachfolgenden Prüfungen für Firma sowie Vor- und
Nachname. Leerstrings galten außerdem als vorhanden.
- Passwort-, Organisations- und Namensprüfung laufen jetzt unabhängig
voneinander.
- `requireOrganization` verlangt eine nicht-leere Firma;
`requireName` verlangt nicht-leeren Vor- und Nachnamen.
- Das Registrierungsformular markiert Vor- und Nachname passend zur
Serverkonfiguration als `required`; Firma nutzte diesen Vertrag bereits.
- Regressionstests decken Direktregistrierung, initialen
E-Mail-Verifizierungs-POST, Leerstrings und die Formularattribute ab.
**Proof:** `pnpm typecheck`, `pnpm lint`, `pnpm test` (7.847 grün,
60 übersprungen), 34 fokussierte Registrierungs-/Screen-Tests,
`verify:i18n`, `verify:source-health`, `verify:ci-baseline` und
`git diff --check` grün.
**Fortschritt:** R-P2a bleibt bei 6/6 DoD = 100 % done. Der Nachzug härtet den
bestehenden Signup-Vertrag; er erweitert weder Scope noch Datenmodell.