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

67 lines
6.6 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** | 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