Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,63 @@
|
||||
# D-ADMIN · Plattform-Admin-Compose
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Typ** | Screen (Design) |
|
||||
| **Owner** | David |
|
||||
| **Phase** | P19 — Plattform-Admin (bedient `AK-P19`) |
|
||||
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-26 → fällig 2026-06-26 |
|
||||
| **Status** | geplant |
|
||||
|
||||
> 🟩 **Compose-Ticket:** deckt **alle Admin-Screens** (P19). Compose aus A2/A3/A4/A5/A6 + KPI/Charts — aber **eigene Admin-Shell** (nicht App-Shell A1): getrennte Sidebar/Topbar auf `admin.hivegrid.de`. Interner Polish reicht (kein 🌐-Niveau).
|
||||
|
||||
> 🟡 **v1-Schnitt (verbindlich):** Getrennte AdminUser-Identität / AdminRBAC-Parallelwelt (M038/M039) → **v2** (v1 = Boilerplate-User-Extension + `admin-mfa-gate`). **Keine** AdminUser-/AdminRole-Verwaltungs-Screens, **keine** Plattform-Lead-Pipeline/Deal-Kanban, **keine** Feature-Flag-Massen-Statistik, **kein** KWP-Sync-Status-Screen in v1; Churn/ARPU → v2. **Neu v1:** Admin stellt Tenant-Abos zusammen (Feature-Konnektoren togglen + Stripe-Positionen — Abo-Baukasten-Mechanik).
|
||||
|
||||
## Abhängigkeiten & Parallelität
|
||||
- **Blocked by:** `D-D0b` (Archetypen — Reuse der Bausteine; die Admin-Sidebar/-Topbar werden hier aber **getrennt** neu komponiert, kein A1-Reuse)
|
||||
- **Blockt:** —
|
||||
- **Bedient (Dev):** `AK-P19` (M37 Plattform-Admin + M32 Feature-Flag-UI)
|
||||
- **Subframe:** Pflicht je Route. Eigene Admin-Shell; Archetypen-Reuse A2/A3/A4/A5/A6 + KPI/Charts.
|
||||
|
||||
## Was wir bauen
|
||||
Die **getrennte Plattform-Admin-Welt** auf `admin.hivegrid.de`: Admin-Login + 2FA, Admin-Dashboard (Basis-KPIs), Tenant-Management inkl. **Abo-Zusammenstellung**, User-/Subscription-Verwaltung, Feature-Flags, Health/Worker-Queues, Support-Inbox, Admin-Audit und Subprozessoren/AVV.
|
||||
|
||||
## Benötigte Screens
|
||||
| Screen [Route] | Kern-Inhalt | Archetyp |
|
||||
|---|---|---|
|
||||
| Admin-Login + 2FA [`admin.hivegrid.de/login`, `/2fa`] | Email + Passwort (NIST/HIBP, Captcha ab 3. Fehler), TOTP-Pflicht, kein Magic-Link, 8h-Session | A4 / A5 |
|
||||
| Admin-Dashboard [`/dashboard`] | **Basis-KPIs: Tenants, aktive User, MRR** + System-Health-Ampel + Queue-Status · Klick je Kachel → Drill-Down · Zeitraum-Wechsler *(Churn/ARPU/Sales-Pipeline → v2)* | KPI |
|
||||
| Tenant-Liste [`/tenants`] | Name, Slug, Status (Klartext-Farbe), Plan, MRR, User-Anzahl, letzte Aktivität, Branche/Größe · Filter + Suche + Bulk (Tag/Email) | A2 |
|
||||
| **Tenant-Detail** [`/tenants/:id`] | Stammdaten, Status-Wechsler (Reason-Pflicht), **Abo-Zusammenstellung (Feature-Konnektoren togglen + Stripe-Positionen — Abo-Baukasten!)**, Trial-Verlängerung (Datum + Reason), Notizen (Markdown, kategorisiert, gepinnt), User-/Activity-/Audit-/Feature-Flag-Sektionen, **Impersonate mit Begründungs-Pflicht** | A2 / A3 + A6 |
|
||||
| Manuelle Tenant-Anlage [`/tenants/new`] | Name, Slug (Live-Validation), Branche, Größe, Initial-Admin-Email, Initial-Module/Plan, Trial-Dauer, Demo-Daten-Häkchen, Reason-Pflicht | A4 |
|
||||
| User-Liste + Detail [`/users`, `/:id`] | Liste: Email, Name, Tenant-Memberships, 2FA-Status, letzte Aktivität, Status · Detail: Memberships mit Rolle, Sessions, letzte Logins, Ops (2FA-Reset mit Reason, Session-Revoke, Deaktivieren, Lösch im Auftrag) | A2 / A3 |
|
||||
| Subscription-Liste + Detail [`/subscriptions`, `/:id`] | Liste: Tenant, Plan, MRR, Status, Renewal, Stripe-Sync · Detail: Stripe-Customer/Sub-ID (Link), Plan + Positionen + MRR, Trial, Rechnungs-History, manuelle Override (Plan/Sonderpreis/Reason), Stripe-Sync forcieren, Refund | A2 / A3 |
|
||||
| Feature-Flags [`/feature-flags`] | Flag-Liste (Key, Status, Targeting), Filter-Editor (plan-tier), Tenant-Override mit Ablauf *(Massen-Statistik → v2)* | A2 + A6 |
|
||||
| Health + Worker-Queues [`/health`, `/health/workers`] | Service-Ampeln (Web/API/Worker/Scheduler), DB/Redis/Storage · BullMQ-Queues: Active/Waiting/Delayed/Failed je Queue, Job-Detail mit Error-Stack, Retry (Bulk/einzeln), Pause/Resume · Error-Rate Top-10 | A2 + KPI |
|
||||
| Support-Inbox + Ticket-Detail [`/support`, `/:id`] | Liste: Betreff, Tenant, Source, Status, Priorität, Zugewiesen · Detail: Konversation, Antwort (Markdown + Anhänge), interne Notiz, Status/Priority/Tag/Assignee-Wechsler, Reaktions-Templates · **speist sich aus Feedback-Widget (P21)!** | A2 / A3 |
|
||||
| Admin-Audit [`/audit`] | Cross-Tenant-`AdminAuditLog` + aggregierter Tenant-Audit-Read · Filter (Akteur/Tenant/Action-Type/Zeitraum/Target), Volltext in Summary, Detail-Drawer mit Diff, Export (CSV/JSON) · read-only | A2 + Drawer |
|
||||
| Subprozessoren + AVV [`/legal/subprocessors`, `/legal/avv`] | Subprozessor-Liste (anlegen/edit/archiv, 14-Tage-Widerspruchs-Trigger) · AVV-Versionen (PDF-Vorlage, Aktiv-ab, akzeptierende/ausstehende Tenants, Re-Akzeptanz-Trigger) | A2 + A6 |
|
||||
|
||||
*(Entfällt v1: AdminUser-/AdminRole-Verwaltung, Plattform-Lead-Inbox/Deal-Kanban, KWP-Sync-Status, Feature-Flag-Massen-Statistik — alles v2.)*
|
||||
|
||||
## Features (muss abgedeckt sein)
|
||||
- [ ] Admin meldet sich auf `admin.hivegrid.de` an (Host-Routing, Cookie-Domain-Trennung, TOTP-Pflicht + MFA-Step-up); Admin-User ohne Tenant-Workspace; kein Generalschlüssel
|
||||
- [ ] Admin verwaltet Tenants/Subscription-Overrides/Feature-Flags; **Abo-Zusammenstellung** = Feature-Konnektoren togglen + Stripe-Positionen (Abo-Baukasten)
|
||||
- [ ] Admin-Dashboard: Boilerplate-KPIs (Tenants/User/MRR) + System-Health + Queue-Status
|
||||
- [ ] BullMQ-Queue-Monitoring (Retry/Pause/Resume, Job-Detail mit Error-Stack) + Support-Inbox
|
||||
- [ ] `AdminAuditLog` (tenant_id=null) über Audit-Hash-Kette; sensitive Aktionen (Status-Wechsel/Impersonate/Subscription-Override) mit Reason-Pflicht + Klartext-Bestätigung
|
||||
- [ ] Impersonate → temporäre Tenant-User-Session (max. 30 Min) mit Klartext-Banner im Tenant + Reason-Spur
|
||||
- [ ] Eigene getrennte Admin-Shell (Sidebar Dashboard/Tenants/Users/Subscriptions/Feature-Flags/Health/Audit/Support/Legal/Settings) — kein App-Sidebar-Reuse
|
||||
|
||||
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
|
||||
Eigene Admin-Sidebar + -Topbar (getrennt von A1); KPI-Kacheln mit Drill-Down + Zeitraum-Wechsler; System-Health-Ampel; Daten-Tabelle (sortierbar, paginiert, Spalten-Konfig); Filter-Bar; Bulk-Action-Toolbar; Status-Wechsler mit Reason-Pflicht-Modal; **Abo-Baukasten-Panel** (Feature-Konnektor-Toggles + Stripe-Positionsliste mit Preisen); Trial-Verlängerungs-Datum-Picker; Markdown-Notizen-Editor mit Pin + Kategorie; Impersonate-Button mit Begründungs-Modal; Stripe-Link-Badge; manuelle-Override-Formular; Queue-Status-Tabelle mit Retry/Pause/Resume; Job-Detail-Drawer mit Error-Stack; Feature-Flag-Liste + Targeting-Filter-Editor + Tenant-Override-mit-Ablauf; Support-Konversations-Ansicht + Markdown-Reply + interne-Notiz-Toggle + Reaktions-Templates; Audit-Tabelle mit Diff-Drawer + Export; Subprozessor-Tabelle + AVV-Versions-Liste mit PDF-Upload; Bestätigungs-Dialoge (Confirm-Phrase für destruktive Aktionen); Empty-/Loading-/Fehler-/Permission-Denied-States (Klartext mit Lösungs-Knopf).
|
||||
|
||||
## Quellen (granular)
|
||||
- `designer-briefs/P19-plattform-admin.md` (vollständiger Brief — alle Admin-Screens, diese Doc ist sein Ticket-Destillat)
|
||||
- `ENTITY-MODEL.md` → Domäne 11 (Plattform-Admin) + Domäne 12 (Abo-Baukasten, für Abo-Zusammenstellung)
|
||||
- `SCREEN-MAP.md` → §3 Plattform-Admin · `ROADMAP.md` → Phase 19 · `_bmad-output/specs/M37-plattform-admin.md`, `M32-feature-flags.md`
|
||||
|
||||
## Davids Delta (David füllt aus)
|
||||
- [ ] Überschriebene/geänderte Spec-Punkte:
|
||||
- [ ] Neue UI/UX-Entscheidungen:
|
||||
- [ ] Subframe-Screen-Link(s):
|
||||
- [ ] Offene Fragen an Dev:
|
||||
Reference in new issue
Block a user