6.6 KiB
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 ingewonnen/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
- EIN konfigurierbarer Kanban (serverseitiger Board-Contract, Stage-Wechsel-Validation, gewonnen/verloren-Workflow mit Lost-Reason-Pflicht, Pipeline-Switcher) + SSE-Realtime
- Listen-View mit Filter / Sort / Bulk-Contract / Spalten-Konfig-Contract / 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, Backstopdeals.read_volume_*/read_aggregates; Volumen ohne Recht → „—" - 24h-Rückgängig-Banner aus gewonnen/verloren-Stages (serverseitig via
undoStageChangeUntil) deal.won-Event emittiert (Extension-Point für P9/Reporting)- 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-HandoffREQUIREMENTS.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→ P8designer-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-P8baktualisiert