Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -2,20 +2,38 @@
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Plane** | `HIVEGRID-111` |
|
||||
| **Typ** | Dev (Code) |
|
||||
| **Owner** | Raffael |
|
||||
| **Phase** | Phase 28 (v2-P8) — Plattform-Admin-Tiefe |
|
||||
| **Cycle/Fenster** | v2-W3 — Admin/Help/Dashboard/v2-Launch · fällig 2026-07-29 |
|
||||
| **Status** | geplant |
|
||||
| **Status** | Ready for Review |
|
||||
|
||||
🎨 **design-nachzug: offen** · Die produktiv verdrahtete Interim-UI ist die aktuelle
|
||||
Visual-Baseline; Davids späteres Subframe-Delta wird separat nachgezogen.
|
||||
|
||||
## Abhängigkeiten & Parallelität
|
||||
- **Blocked by:** `AK-P19` (v1-Admin-Welt-Fundament: Host-Routing `admin.hivegrid.de`, Cookie-Trennung, TOTP-Pflicht, AdminAuditLog, Audit-Hash-Kette — die v1-Auflagen-Brücke M034)
|
||||
- **Blocks:** `VR-P31` (DSGVO-Admin-Legal-Verwaltung braucht die AdminUser-Identität/-RBAC + cross-tenant AdminAuditLog), `VA-P28b` (Akeshans Flag-Massen-Statistik/interne Lead-Pipeline läuft in derselben Admin-Welt)
|
||||
- **Läuft parallel zu:** `VA-P28b` (Flag-Massen-Statistik + interne Lead-Pipeline, Akeshan) — gleiche Phase, getrennte Bausteine: Raffael = Identität/RBAC/Audit, Akeshan = Flag-Statistik/Lead-Pipeline. Eigene `prisma/schema/admin.prisma` (AD-21), **getrennte Welt, KEIN `tenant_id`** auf Admin-Tabellen. Koordination nur am gemeinsamen AdminAuditLog.
|
||||
- **Blocks:** `VR-P31`, `VA-P28b` (CRM Core/M040b), `VA-P28c` (persönliche
|
||||
Admin-Mailboxen) und `VR-P28a-RBAC` (vorbereitete Mitarbeiter, Rollenpakete und
|
||||
Own-/All-Scope); die übrigen Admin-Sales-Tickets konsumieren diese
|
||||
Identity-/Permission-Verträge transitiv.
|
||||
- **Läuft parallel zu:** `VA-P28b` nur in dessen unabhängigem M033-Anteil. Eigene
|
||||
`prisma/schema/admin.prisma` (AD-21), **getrennte Welt, KEIN `tenant_id`** auf Admin-Tabellen.
|
||||
- **Konflikt-Risiko:** gering — gemeinsamer AdminAuditLog (Owner = Raffael, Akeshan dockt an); berührt `core.prisma` nur für die Ablösung der v1-User-Extension.
|
||||
|
||||
> **M040a-/Sales-Kompatibilitätsvertrag (2026-07-24):** `R-LEADS` darf vor diesem Ticket gegen die
|
||||
> bestehende AdminUser/User-Brücke bauen. Beim Wechsel auf die getrennte AdminUser-Welt müssen
|
||||
> `assignedToAdminUserId`, Source-Defaults, Notification-Empfänger, Activities sowie später angelegte
|
||||
> Sales-Ownership-Felder verlustfrei migriert werden.
|
||||
>
|
||||
> **Delivery-Owner-Update 2026-07-24:** Raffael übernimmt `VA-P28c` bis `VA-P28i`. Der von
|
||||
> `VR-P28a` bereitgestellte Identity-/RBAC-Vertrag sowie Scope, Termine und Abhängigkeiten bleiben unverändert.
|
||||
|
||||
**Fortschritt:** **6/6 DoD = 100 % done**.
|
||||
|
||||
## Was wir bauen
|
||||
Die **echte getrennte AdminUser-Identität und AdminRBAC** auf `admin.hivegrid.de` (M038/M039) — sie **löst die v1-Auflagen-Brücke** (Boilerplate-User-Extension + `admin-mfa-gate.server.ts`) ab. Eigene `AdminUser`-Klasse, hart getrennt von `User`/`TenantUser` (eigene Cookies SameSite=Strict, kein Cross-Routing, **kein BYPASSRLS** — der Admin liest Tenant-Daten via RLS mit gesetztem `app.tenant_id`). AdminRBAC mit eigenen Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer), **2FA-Pflicht**, 8h-Session, **Self-Permission-Schutz** (letzter super_admin darf sich nicht entrechten). **AdminAuditLog cross-tenant** mit Reason-Pflicht bei sensitiven Aktionen; Impersonate mit Reason + Banner.
|
||||
Die **echte getrennte AdminUser-Identität und AdminRBAC** auf `admin.hivegrid.de` (M038/M039) — sie **löst die v1-Auflagen-Brücke** (Boilerplate-User-Extension + `admin-mfa-gate.server.ts`) ab. Authentik bleibt gemäß Estate-Standard der einzige produktive Admin-Login und liefert die geprüfte MFA-Assurance. Eigene `AdminUser`-Klasse und `AdminSession`, hart getrennt von `User`/`TenantUser` (eigene Cookies SameSite=Strict, kein Cross-Routing, **kein BYPASSRLS** — der Admin liest Tenant-Daten via RLS mit gesetztem `app.tenant_id`). AdminRBAC mit eigenen Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer), erzwungener MFA-Assurance, 8h-Session, **Self-Permission-Schutz** (letzter super_admin darf sich nicht entrechten). **AdminAuditLog cross-tenant** mit Reason-Pflicht bei sensitiven Aktionen; Impersonate mit Reason + Banner. Es entsteht kein zweiter produktiver Passwort-/TOTP-Stack.
|
||||
|
||||
## Benötigte Screens (Backend bedient — Design liefert `D-P28`/`D-ADMIN` — interner Polish)
|
||||
| Screen [Route] | Kern-Inhalt |
|
||||
@@ -26,33 +44,63 @@ Die **echte getrennte AdminUser-Identität und AdminRBAC** auf `admin.hivegrid.d
|
||||
| Admin-Security-Settings [`/settings/security`] | Aktive Sessions + individueller Revoke, 2FA-Pflicht, 8h-Session-Policy |
|
||||
| Cross-Tenant-Audit-View [`/audit`] | `AdminAuditLog` über alle Tenants, Reason-Pflicht-Einträge, Impersonate-Records, Filter |
|
||||
|
||||
*(Feature-Flag-Massen-Statistik + interne Lead-Pipeline = Akeshans `VA-P28b`.)*
|
||||
*(M040a Intake/AdminLead-Inbox = `R-LEADS`; Feature-Flag-Massenstatistik, M040b und CRM Core =
|
||||
`VA-P28b`; weitere Sales-Kanäle = `VA-P28c` bis `VA-P28i`.)*
|
||||
|
||||
## Definition of Done
|
||||
- [ ] Eigene `AdminUser`-Klasse, **kein BYPASSRLS** (Admin liest Tenant-Daten via RLS mit `app.tenant_id`), eigene Cookies **SameSite=Strict**, kein Cross-Routing
|
||||
- [ ] **AdminRBAC** + eigene Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer) + **2FA-Pflicht** + 8h-Session + **Self-Permission-Schutz** (letzter super_admin)
|
||||
- [ ] **AdminAuditLog cross-tenant** mit **Reason-Pflicht** bei sensitiven Aktionen
|
||||
- [ ] **Impersonate** mit Reason + Klartext-Banner im Tenant (kein BYPASSRLS, temporäre Tenant-Session)
|
||||
- [ ] v1-Boilerplate-User-Extension (`admin-mfa-gate.server.ts`) durch die echte getrennte Identität abgelöst
|
||||
- [x] Eigene `AdminUser`-/`AdminSession`-Welt, Authentik als einziger produktiver Login, **kein BYPASSRLS** (Admin liest Tenant-Daten via RLS mit `app.tenant_id`), eigene Cookies **SameSite=Strict**, kein Cross-Routing
|
||||
- [x] **AdminRBAC** + eigene Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer) + erzwungene Authentik-MFA-Assurance + 8h-Session + **Self-Permission-Schutz** (letzter super_admin)
|
||||
- [x] **AdminAuditLog cross-tenant** mit **Reason-Pflicht** bei sensitiven Aktionen
|
||||
- [x] **Impersonate** mit Reason + Klartext-Banner im Tenant (kein BYPASSRLS, temporäre Tenant-Session)
|
||||
- [x] v1-Boilerplate-User-Extension (`admin-mfa-gate.server.ts`) aus produktiven Auth-/MFA-Pfaden entfernt; ausschließlich der fail-closed gegatete lokale Admin-Fallback bleibt
|
||||
- [x] Granulare Admin-Sales-Permissions und Rollen-Mapping für CRM, E-Mail, Telefonie, Sequenzen,
|
||||
Booking, Quote/Signatur, Reporting, Automation und Integrationen stehen; bestehende R-LEADS-Assignments
|
||||
sind verlustfrei übernommen
|
||||
|
||||
## Technische Bausteine
|
||||
- **Entities** (eigene `prisma/schema/admin.prisma` — **KEIN `tenant_id`**, getrennte Welt, AD-21): `AdminUser` ([v2]: `email`, `password_hash`, `totp_secret` (Pflicht), `status`), `AdminRole`/`AdminPermission`/`AdminSession` ([v2]: `name` super_admin/support/sales/…, `permission_id`, `expires_at` (8h), `ip`), `AdminAuditLog` (`admin_user_id`, `action_type`, `target_kind`/`id`, `summary_text`, `metadata` Diff — cross-tenant, tenant_id=null, über Audit-Hash-Kette aus AK-P3).
|
||||
- **Wiederverwendung:** v1-Auth-Bausteine (TOTP/Bcrypt/Session) — wiederverwendet, **eigene Tabellen**; nicht das TenantUser-Modell teilen.
|
||||
- **Entities** (eigene `prisma/schema/admin.prisma` — **KEIN `tenant_id`**, getrennte Welt, AD-21): `AdminUser` (`email`, Authentik-Subject, Status und Assurance-Metadaten, keine produktiven lokalen Credentials), `AdminRole`/`AdminPermission`/`AdminSession` (`name` super_admin/support/sales/…, `permission_id`, `expires_at` (8h), `ip`), `AdminAuditLog` (`admin_user_id`, `action_type`, `target_kind`/`id`, `summary_text`, `metadata` Diff — cross-tenant, tenant_id=null, über Audit-Hash-Kette aus AK-P3).
|
||||
- **Authentifizierung:** Authentik-OIDC wird serverseitig validiert und an eine eigene `AdminSession` gebunden. Der lokale Credential-Fallback bleibt ausschließlich unter den fail-closed Dev-Guards aus `AGENTS.md`; er ist kein produktiver Auth-Vertrag.
|
||||
- **Kein BYPASSRLS (Hardgrenze):** Admin-Datenzugriff auf Tenant-Daten läuft über RLS mit gesetztem `app.tenant_id` — bewusste Härtegrenze (konsistent mit VR-P32b Admin-View).
|
||||
- **Impersonate:** generiert temporäre Tenant-User-Session mit Banner + Audit-Spur + Reason-Pflicht; kein BYPASSRLS.
|
||||
- **Konnektor:** AdminRBAC-Bundles (keine `tenantHasModule`-Logik — Admin-Welt ist tenant-los).
|
||||
- **Sales-Permission-Bundles:** `admin_sales.crm.*`, `admin_sales.email.*`, `admin_sales.phone.*`,
|
||||
`admin_sales.sequence.*`, `admin_sales.booking.*`, `admin_sales.quote.*`,
|
||||
`admin_sales.signature.*`, `admin_sales.reporting.*`, `admin_sales.automation.*` und
|
||||
`admin_sales.integrations.*`; konkrete Actions verwenden nur die kleinste nötige Permission.
|
||||
- **`is_demo_data`:** nicht relevant (Admin-Welt, keine Tenant-Seed-Daten).
|
||||
|
||||
## Quellen (granular)
|
||||
- `ROADMAP-V2.md` → §v2-P8 (Success-Criteria 1/2/3, AdminUser/RBAC/Audit-Screens) — **Hauptquelle**
|
||||
- `ROADMAP.md` → Phase 28
|
||||
- `PHASE-SOURCES.md` → Phase 28 (M038/M039); Scope-Schnitt 12.06.: M038/M039 → v2; bindende v1-M034-Auflagen (TOTP/kein Workspace/Host-Routing/Cookie-Trennung) als Fundament
|
||||
- Historische Milestone-Zuordnung: Phase 28 (M038/M039); Scope-Schnitt 12.06.: M038/M039 → v2; bindende v1-M034-Auflagen (TOTP/kein Workspace/Host-Routing/Cookie-Trennung) als Fundament
|
||||
- `ENTITY-MODEL.md` → Domäne 11 Plattform-Admin (`AdminUser`/`AdminRole`/`AdminSession` [v2], `AdminAuditLog`, eigene Welt ohne tenant_id)
|
||||
- `designer-briefs/P28-plattform-admin-tiefe.md` (Admin-Screens, Hardgrenze Admin-Welt, kein BYPASSRLS)
|
||||
- `_bmad-output/specs/M37-plattform-admin.md` (Block A–D)
|
||||
- Querverweis: `ticket-docs/AK-P19.md` (v1-Admin-Welt-Fundament, v1-Cuts → v2)
|
||||
|
||||
## Dev-Nachzug (nach Davids `D-P28`-Delta)
|
||||
- [x] Interim-UI aus bestehenden `~/ui`-Komponenten mit VM-/Action-Grenze für
|
||||
`/admin-users`, `/admin-users/:id`, `/admin-users/roles` und `/settings/security`
|
||||
produktiv verdrahtet
|
||||
- [x] Interim-Visual-Baseline unter
|
||||
`tests/component/__screenshots__/vr-p28a-admin-security.png` erfasst
|
||||
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
|
||||
- [ ] Plane-Ticket `VR-P28a` aktualisiert
|
||||
- [ ] REQUIREMENTS/ROADMAP nachgezogen
|
||||
- [x] Plane-Ticket `VR-P28a` für den Code-Review vorbereitet
|
||||
|
||||
## Umsetzungs-Notiz
|
||||
|
||||
**2026-07-24 · 6/6 DoD = 100 % done**
|
||||
|
||||
- Authentik-gebundene, tenant-lose AdminIdentity, eigene gehashte 8h-AdminSession,
|
||||
AdminRBAC/Sales-Permissions, letzter-Superadmin-Schutz, Reason-Audit und begrenzte
|
||||
Tenant-Impersonation: `6c9acd9e9`
|
||||
- Erreichbare Interim-UI, reine View-Models, Sidebar-/Permission-Gates, i18n,
|
||||
Route-/Component-/Visual-/E2E-Proofs: `30685cc2e`
|
||||
- Proofs: `pnpm typecheck`, `pnpm lint`, `pnpm test` (1.030 Testdateien,
|
||||
7.380 Tests bestanden), `pnpm build`, RLS-Live-Integration (45/45),
|
||||
Component-/Visual-Test (2/2), Admin-Identity-Browser-Smoke (1/1),
|
||||
i18n-, Sidebar-, Boundary-, Tenant-Policy-, Cross-Cutting-, A11y-,
|
||||
Hot-Swap-, Source-Health- und CI-Baseline-Verifier grün.
|
||||
- Entsprechend dem gemeinsamen P28-Protokoll wurde im Feature-Block ausschließlich
|
||||
`prisma db push` verwendet. Die gemeinsame forward-only P28-Merge-Migration mit
|
||||
Inverse-SQL entsteht nach Abschluss aller Admin-Sales-Schemas.
|
||||
Reference in new issue
Block a user