# 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** | On Hold — serverseitig umgesetzt, Screen-Delta `D-KANBAN`/`D-P8` offen | > 🔴 **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**. **Dependency-Stand 2026-07-01:** `R-P8a` ist serverseitig umgesetzt (Projekt-Kern, Pipeline-Engine, Field-Level-Konfig, Lost-Reasons, Permissions, M049 Auto-Projektanlage) und bleibt nur wegen fehlender `D-KANBAN`/`D-P8` Screens auf On Hold. `R-P8b` kann backendseitig auf `prisma/schema/projekt.prisma` und `projectService.server.ts` aufsetzen; visuelle Kanban-/Listen-Abnahme bleibt screen-blockiert. ## 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 - [x] **EIN konfigurierbarer Kanban** (serverseitiger Board-Contract, Stage-Wechsel-Validation, gewonnen/verloren-Workflow mit Lost-Reason-Pflicht, Pipeline-Switcher) + **SSE-Realtime** - [x] **Listen-View** mit Filter / Sort / Bulk-Contract / Spalten-Konfig-Contract / CSV-Export / Pagination - [x] **Forecast/KPIs** (Volumen × Win-%, realisierter Umsatz, KPIs pro Verantwortlichem) + **Stage-Conversion-Rates** + Lost-Reason-Verteilung — alles mit **Aggregat-Cache** - [x] **Field-Level-Permissions** (Volumen/Aggregate): primär `PipelineFieldVisibility`, Backstop `deals.read_volume_*`/`read_aggregates`; Volumen ohne Recht → „—" - [x] 24h-Rückgängig-Banner aus gewonnen/verloren-Stages (serverseitig via `undoStageChangeUntil`) - [x] **`deal.won`-Event** emittiert (Extension-Point für P9/Reporting) - [x] Konnektor `tenantHasModule('projects')` (Kanban/Listen/Actions gated) ## Umsetzungs-Notiz **2026-07-01 — Server-/Contract-Umsetzung ohne finale Screens:** `ProjektStageChange` und `PipelineAggregateSnapshot` in `prisma/schema/projekt.prisma` ergänzt, RLS-Artefakt und Tenant-Snapshot-Registry nachgezogen. `projectService.server.ts` liefert jetzt Board-VM (`loadProjectBoard`), Stage-Move mit Validation, Lost-Reason-Pflicht, 24h-Undo (`undoLastProjectStageChange`), Listen-Query mit Filter/Sort/Pagination/CSV, Forecast/KPI-Aggregat-Cache, Field-Level-Backstop für Volumen/Aggregate und `deal.won` via Workflow-Outbox. Routes: `/projects`, `/projects/list`, `/projects/pipelines/:pipelineId`, `/projects/pipelines/:pipelineId/stream`. **Proof:** `pnpm typecheck`, `pnpm lint`, `pnpm run verify:i18n`, `pnpm run verify:tenant-isolation-report`, `pnpm --filter @hivegrid/web test -- app/utils/integrations/projects/projectService.test.ts` und full `pnpm test` grün. **Stand:** R-P8b: 7/7 DoD = 100 % serverseitig done. Ticket bleibt fachlich **On Hold**, bis `D-KANBAN`/`D-P8` final geliefert und die Drag&Drop-/Listen-/Banner-UI visuell abgenommen ist. ## 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