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

54 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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