Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/R-P8b.md
T

57 lines
5.0 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.
# R-P8b · P8 Konfigurierbarer Kanban + Forecast/Reporting
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P8 — Projekt & Pipelines (Kern + Pipeline-Engine) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-28 → 2026-06-29 · Gate W3 |
| **Status** | geplant |
> 🔴 **Pivot-Vorrang (AD-20):** EIN konfigurierbarer Pipeline-Kanban (ein Board für **alle** Pipeline-Typen sales/auftrag/custom) statt getrenntem Sales-Kanban + Projekt-Kanban. Karten = Projekte des `Projekt`-Kerns. Drop in `gewonnen`/`verloren`-Stage = Pipeline-internes Stage-Event, **kein Won-Handoff**.
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P8a` (Projekt-Kern + Pipeline-Engine + PipelineAccess/-FieldConfig/-FieldVisibility)
- **Blocks:** `R-P9a` (Auftrags-Welt baut auf demselben Kern auf; `deal.won`-Event), `R-P11b` (Dashboard verbraucht Sales-Aggregate)
- **Sequenz (Raffaels Kern-Kette):** strikt sequenziell — P8b ist Glied 4 (`R-P8a → R-P8b → R-P9a …`).
- **Läuft parallel zu:** Akeshans Module W3. Schema-Trennung nach **AD-21**.
## Was wir bauen
Den **EINEN konfigurierbaren Kanban** über dem Projekt-Kern: Spalten = Stages der gewählten Pipeline, Drag&Drop-Stage-Wechsel mit Validation, gewonnen/verloren-Workflow (Lost-Reason-Pflicht), Pipeline-Switcher, SSE-Realtime. Dazu die **Listen-View** (Filter/Bulk/CSV/Spalten-Konfig), **Forecast/KPIs/Stage-Conversion/Lost-Verteilung** mit Aggregat-Cache und **Field-Level-Sichtbarkeit** (Volumen/Aggregate) über `PipelineFieldVisibility` (Backstop `deals.read_aggregates`). Emittiert `deal.won` für nachgelagerte Phasen.
## Benötigte Screens (Backend bedient — Design liefert `D-KANBAN` + `D-P8`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Pipeline-Kanban (konfigurierbar) [`/projects` · `/projects/pipelines/:id`] | Spalten = Stages (Name, Projekt-Anzahl, Aggregat-Volumen gegated, Win-%); Projekt-Karten (Titel, gegatetes Volumen, Avatar, Datum, max. 3 Tags, Stuck-Marker); **Drag&Drop** mit Stage-Validation; Drop `gewonnen` → Bestätigung, Drop `verloren` → Lost-Reason-Pflicht; **Pipeline-Switcher**; Filter + „nur meine"; Bulk-Select; Pagination pro Spalte (100+); SSE-Realtime |
| Projekt-Liste [`/projects/list`] | Cross-Pipeline-Sicht (Pipeline-Spalte + -Filter), Projekt-Nummer/Titel/Stage/Volumen (gegated)/Kontakt/Zeitraum/letzte Activity, sortierbar, Spalten-Konfig, Bulk, CSV-Export, Pagination |
| Forecast/KPI-Quellen (Widgets in P11) | Datenquellen: Pipeline-Forecast (Volumen × Win-%), realisierter Umsatz, KPIs pro Verantwortlichem, Stage-Conversion-Rates, Lost-Reason-Verteilung — Aggregat-Cache (kein eigener Screen, Widgets in P11) |
## Definition of Done
- [ ] **EIN konfigurierbarer Kanban** (Drag&Drop, **Stage-Wechsel-Validation**, gewonnen/verloren-Workflow mit Lost-Reason-Pflicht, Pipeline-Switcher) + **SSE-Realtime**
- [ ] **Listen-View** mit Filter / Sort / Bulk / Spalten-Konfig / CSV-Export / Pagination
- [ ] **Forecast/KPIs** (Volumen × Win-%, realisierter Umsatz, KPIs pro Verantwortlichem) + **Stage-Conversion-Rates** + Lost-Reason-Verteilung — alles mit **Aggregat-Cache**
- [ ] **Field-Level-Permissions** (Volumen/Aggregate): primär `PipelineFieldVisibility`, Backstop `deals.read_volume_*`/`read_aggregates`; Volumen ohne Recht → „—"
- [ ] 24h-Rückgängig-Banner aus gewonnen/verloren-Stages
- [ ] **`deal.won`-Event** emittiert (Extension-Point für P9/Reporting)
- [ ] Konnektor `tenantHasModule('projects')` (Kanban/Listen/Actions gated)
## Technische Bausteine
- **Erweitert `prisma/schema/projekt.prisma`** (keine neuen Kern-Entities — Kanban/Forecast lesen auf Projekt/Pipeline/Stage aus R-P8a); Aggregat-Cache-Tabelle bzw. materialisierte Sicht für Forecast/KPIs.
- **RLS** durchgängig (AD-1); Kanban-Query filtert über `PipelineAccess` + `PipelineFieldVisibility` (server-seitig, nie durchsickern).
- **SSE-Realtime** für Karten-Bewegung + Spalten-Aggregate; Stage-Wechsel append-only in **Activity** (P6) + `deal.won`-Event.
- **HiveNumberSeq** (aus R-P8a) bleibt Quelle der Projekt-Nummern; hier nicht neu.
- **Konnektor** `tenantHasModule('projects')` gated.
- `is_demo_data`-Flag auf Demo-Projekten respektiert (Aggregate filtern bei Echt-Start-Bereinigung).
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 5** (Projekt/Pipeline/Stage + PipelineFieldVisibility für gegatete Aggregate) — 🔴 **Pivot-Vorrang (AD-20)**: ein Board für alle Pipeline-Typen, kein Won-Handoff
- `REQUIREMENTS.md` → `REQ-projekt-kanban-listen-view`, `REQ-projekt-forecast-kpis`, `REQ-pipeline-rechte-config` (Field-Level) (Phase 8)
- `ROADMAP.md` → Phase 8 (+ Pivot-Note) · `PHASE-SOURCES.md` → P8
- `designer-briefs/P08-projekt-pipelines-kern.md` (Kanban BESPOKE, Pivot-Vorrang-Hinweis)
- `_bmad-output/specs/M03-sales-pipeline.md` (⚠ teils pre-pivot — ENTITY-MODEL hat Vorrang)
## Dev-Nachzug (nach Davids `D-KANBAN`/`D-P8`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P8b` aktualisiert