4.6 KiB
4.6 KiB
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) sowieVA-P29/VA-P30a/bim 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 gesetztemapp.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). SchreibtAdminAuditLog(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/AdminLeadActivityM040,AdminAuditLogcross-tenant) + v1-FeatureFlag-ModellROADMAP.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-P28baktualisiert