Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P8b.md
T
2026-07-08 16:15:37 +02:00

6.6 KiB
Raw Blame History

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

  • 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, Backstop deals.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-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