Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VA-P28b.md
T

4.6 KiB
Raw Blame History

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