# 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