# 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