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,53 @@
|
||||
# VA-P28b · P28 Flag-Massen-Statistik (M033) + interne Lead-Pipeline (M040)
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Typ** | Dev (Code) |
|
||||
| **Owner** | Akeshan |
|
||||
| **Phase** | P28 — Plattform-Admin-Tiefe · v2-P8 |
|
||||
| **Cycle/Fenster** | v2-W3 — Admin/Help/Dashboard/v2-Launch · fällig 2026-07-31 |
|
||||
| **Status** | geplant |
|
||||
|
||||
## Abhängigkeiten & Parallelität
|
||||
- **Blocked by:** `AK-P19` (Plattform-Admin — Admin-Welt/Host-Routing/Permissions), `VR-P28a` (AdminUser-Identität/RBAC + AdminAuditLog — Raffaels Teil derselben Phase)
|
||||
- **Blocks:** —
|
||||
- **Läuft parallel zu:** `VR-P28a` (Raffael, gleiche Phase, getrennte Domänen: Identität/RBAC vs. Flag-Statistik/Lead-Pipeline) sowie `VA-P29`/`VA-P30a/b` im W3-Slot.
|
||||
- **Konflikt-Risiko:** mittel — beides läuft in der **Plattform-Admin-Welt** (`admin.hivegrid.de`, **kein** tenant_id, **kein BYPASSRLS**); Schnittstelle zu VR-P28a sauber an AdminUser/AdminAuditLog ziehen.
|
||||
|
||||
## Was wir bauen
|
||||
Zwei Plattform-Admin-Bausteine: die **Feature-Flag-Massen-Statistik** (M033) — effektive Auswertung über alle Tenants (X aktiv / Y nicht), **Live-Filter-Vorschau** (Read-Replica) und **Bulk-Override** mit **deterministischer Auswertung** (Override > Filter > Default) + Audit — und eine **interne Lead-Pipeline** (M040) für **HiveGrid-eigene Verkäufe** (unser eigenes Sales-Tool). Beides in der getrennten Admin-Welt auf `admin.hivegrid.de`, **kein BYPASSRLS**.
|
||||
|
||||
## Benötigte Screens (Backend bedient — Design liefert `D-P28`, interner Polish)
|
||||
| Screen [Route] | Kern-Inhalt |
|
||||
|---|---|
|
||||
| Feature-Flag Effektiv-Statistik [`admin.hivegrid.de/feature-flags`] | Pro Flag: **X aktiv / Y nicht aktiv** über alle Tenants, deterministische Auswertung (Override > Filter > Default) |
|
||||
| Filter-Editor (Live-Match) [`/feature-flags/:key`] | Filter-Regeln definieren, **Live-Vorschau** der getroffenen Tenants (Read-Replica) |
|
||||
| Bulk-Override [`/feature-flags/:key/bulk`] | Massen-Setzen von Overrides auf gefilterte Tenant-Menge, **mit Audit** |
|
||||
| Interne Lead-Pipeline [`admin.hivegrid.de/leads`] | HiveGrid-eigene Verkäufe: Lead-/Deal-Liste + Detail, Quelle/source_detail, Stage |
|
||||
|
||||
## Definition of Done
|
||||
- [ ] **Flag-Massen-Statistik:** Effektiv-Auswertung (X aktiv/Y nicht) + **Live-Filter-Vorschau** (Read-Replica) + **Bulk-Override**
|
||||
- [ ] **Deterministische Auswertung** (Override > Filter > Default) + **Audit** (AdminAuditLog)
|
||||
- [ ] **Interne Lead-Pipeline** (HiveGrid-eigene Verkäufe) mit Lead/Deal/Stage + Quelle/source_detail
|
||||
- [ ] Läuft in der Admin-Welt (`admin.hivegrid.de`, **kein** tenant_id, **kein BYPASSRLS** — Tenant-Lesungen via RLS mit gesetztem `app.tenant_id`)
|
||||
- [ ] Sensitive Aktionen mit **Reason-Pflicht** + AdminAuditLog (cross-tenant)
|
||||
|
||||
## Technische Bausteine
|
||||
- **Entities** (eigene `prisma/schema/admin-flags.prisma` / Admin-Welt, **kein tenant_id**, AD-21): Massen-Statistik liest v1-`FeatureFlag`-Modell + `tenantHasFlag()` (P8 ergänzt nur die Massen-UI/-Auswertung). Lead-Pipeline: `AdminLead` / `AdminDeal` / `AdminLeadActivity` (M040 Plattform-Lead-Pipeline — unser eigenes Sales-Tool). Schreibt `AdminAuditLog` (admin_user_id, action_type, target_kind/id, metadata-Diff, tenant_id=null).
|
||||
- **Deterministische Flag-Auswertung:** Resolver-Reihenfolge **Override > Filter > Default**; Effektiv-Zähler aggregiert über alle Tenants.
|
||||
- **Live-Filter-Vorschau:** Filter-Regeln gegen **Read-Replica** matchen (keine Last auf Primär-DB); Vorschau-Liste der getroffenen Tenants.
|
||||
- **Bulk-Override:** Massen-Setzen auf gefilterte Menge mit Bestätigung (betroffene Tenant-Anzahl) + Audit.
|
||||
- **Kein BYPASSRLS:** Admin liest Tenant-Daten via RLS mit gesetztem `app.tenant_id` (Hardgrenze); Self-Permission-Schutz aus VR-P28a respektieren.
|
||||
|
||||
## Quellen (granular)
|
||||
- `ROADMAP-V2.md` → **§v2-P8 Plattform-Admin-Tiefe** (Flag-Massen-Statistik + interne Lead-Pipeline = Hauptquelle; Recut „kein BYPASSRLS")
|
||||
- `ENTITY-MODEL.md` → **Domäne 11: Plattform-Admin** (`AdminLead`/`AdminDeal`/`AdminLeadActivity` M040, `AdminAuditLog` cross-tenant) + v1-FeatureFlag-Modell
|
||||
- `ROADMAP.md` → Phase 28 · `PHASE-SOURCES.md` → Phase 28 (M033 Flag-Massen-Statistik, M040 interne Lead-Pipeline)
|
||||
- `designer-briefs/P28-plattform-admin-tiefe.md` (Flag-Effektiv-Statistik, Live-Match-Vorschau, Bulk-Override, Lead-Pipeline)
|
||||
- `_bmad-output/specs/M32-feature-flags.md` (Massen-Statistik), `M37-plattform-admin.md` (Block A–D)
|
||||
- Querverweis: `ticket-docs/AK-P19.md` (Plattform-Admin-Fundament), VR-P28a (AdminUser-Identität/RBAC + AdminAuditLog)
|
||||
|
||||
## Dev-Nachzug (nach Davids `D-P28`-Delta)
|
||||
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
|
||||
- [ ] Plane-Ticket `VA-P28b` aktualisiert
|
||||
Reference in new issue
Block a user