Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/R-P8a.md
T

59 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-P8a · P8 Pipeline-Engine + Projekt-CRUD (Sales-Sicht) + Auto-Verkaufsfall
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P8 — Projekt & Pipelines (Kern + Pipeline-Engine) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-27 → 2026-06-28 · Gate W3 |
| **Status** | geplant |
> 🔴 **Pivot-Vorrang (AD-20):** Das Snapshot-Ticket heißt noch „Deal-CRUD". Korrekt projekt-zentrisch: Es gibt **EINEN `Projekt`-Kern** (typisierte Superset-Tabelle, Deal- + Auftrags-Felder in einer Tabelle). **„Deal" ist ein Pipeline-Typ** (`Pipeline.typ_hint = sales`), **KEINE eigene Entität**. „Projekt-CRUD in Sales-Pipeline-Sicht" statt „Deal-CRUD". `Status` ist immer pipeline-intern (`PipelineStage.stage_kind = offen/gewonnen/verloren`) — kein globaler Projektstatus.
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P7` (Lead-Inbox liefert `lead.qualified`-Event)
- **Blocks:** `R-P8b` (Kanban + Forecast bauen auf Engine + Projekt-Kern auf)
- **Sequenz (Raffaels Kern-Kette):** strikt sequenziell `R-P7 → R-P8a → R-P8b → R-P9a …`. P8a ist Glied 3.
- **Läuft parallel zu:** Akeshans Module W3 (`AK-P14`/`AK-P15` Email/Telefonie u.a.). Schema-Trennung nach **AD-21** (Modul = eigene `.prisma`, `db push` lokal, Migration beim Merge).
## Was wir bauen
Den **`Projekt`-Kern als eine typisierte Tabelle** (Superset der Felder + `CustomFieldValue`) und die **Pipeline-Engine** als frei konfigurierbare Views: Pipeline anlegen/benennen/duplizieren/archivieren (`typ_hint` sales/auftrag/custom), Stages je Pipeline (= die Statuswerte), Zugriff je Rolle/User/Gruppe (`PipelineAccess`), Feld-Sichtbarkeit + Pflichtfelder pro Pipeline+Status (`PipelineFieldConfig`) und **Field-Level-Rechte** je Principal (`PipelineFieldVisibility` — z.B. Auftragsvolumen nur für Vertrieb). Dazu fortlaufende Projekt-Nummern (HiveNumberSeq, lückenlos), Lost-Reason-CRUD und der **Auto-Verkaufsfall** (M049): `lead.qualified` → Projekt in Sales-Pipeline. Kanban/Listen-View + Forecast folgen in P8b.
## Benötigte Screens (Backend bedient — Design liefert `D-KANBAN` + `D-P8`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Projekt-Detail [`/projects/:id`] | Inline-Edit Stammdaten (Nummer/Name/Beschreibung/Volumen/potenzieller Wert/Pipeline/Stage/Zeitraum/Adress-Slots), verknüpfte Kontakte mit Rolle, Lead-Herkunft-Hinweis (`konvertiert_aus_lead_id`), klickbare Stage-Bar, Stage-Historie, gewonnen/verloren-Banner mit 24h-Rückgängig, Tags, Custom-Felder (pro Pipeline via PipelineFieldConfig), Activity-Stream, Quick-Actions |
| Pipeline-Config-Admin [`/admin/pipelines` · `/admin/pipelines/:id`] | Pipelines-Liste + Editor: Stages (Name/stage_kind/Win-%/Farbe, Drag&Drop), **PipelineAccess** (Principal × kann_sehen/kann_bearbeiten), **PipelineFieldConfig** (Feld × sichtbar/pflicht/Reihenfolge je Status), **PipelineFieldVisibility** (Field-Level-Rechte je Rolle/Gruppe/User), Validation min. 1 gewonnen + 1 verloren, anlegen/duplizieren/archivieren |
| Lost-Reasons [`/admin/pipelines/lost-reasons`] | Liste + Add/Edit/Archive (kein Hard-Delete — Reporting), SHK-Default 5 Reasons geseedet |
## Definition of Done
- [ ] **EIN `Projekt`-Kern** (typisierte Superset-Tabelle: Deal- + Auftrags-Felder + `CustomFieldValue`) mit fortlaufenden Projekt-Nummern (**HiveNumberSeq, Row-Lock/lückenlos**); RLS + Soft-Delete
- [ ] **Pipeline-Engine:** Pipeline anlegen/benennen/duplizieren/archivieren (`typ_hint` sales/auftrag/custom); `PipelineStage` = die Statuswerte; Validation min. 1 gewonnen + 1 verloren
- [ ] **PipelineAccess** (wer sieht/bearbeitet Pipeline je Rolle/User/Gruppe)
- [ ] **PipelineFieldConfig** (Feld-Sichtbarkeit + Pflicht + Reihenfolge je Pipeline/Status; nicht sichtbare Felder **bleiben erhalten**)
- [ ] **PipelineFieldVisibility** (Field-Level-Rechte je Principal — z.B. Auftragsvolumen nur für Vertrieb; ohne Eintrag = für alle sichtbar)
- [ ] **M049: `lead.qualified` → Auto-Verkaufsfall** (Projekt automatisch in Sales-Pipeline) — Pipeline-Wechsel-Modell, kein Won-Handoff/zweiter Datensatz
- [ ] **Lost-Reason-CRUD** (kein Hard-Delete, SHK-Defaults geseedet)
- [ ] Konnektor `tenantHasModule('projects')` (Sidebar + Routes + Actions gated)
- [ ] `projects.*`/`deals.read_volume_*`-Permission-Backstop (Field-Level primär über PipelineFieldVisibility; Volumen ohne Recht → „—")
## Technische Bausteine
- **Entities** (eigene `prisma/schema/projekt.prisma`): `Projekt` (Superset, `stage_id`=Status, `konvertiert_aus_lead_id`, Adress-Slots), `Pipeline` (`typ_hint`), `PipelineStage` (`stage_kind`/win_probability/color), **`PipelineFieldConfig`** (pipeline_id/stage_id NULL=pipeline-weit/field_key System ODER `custom:<id>`/sichtbar/pflicht/reihenfolge), **`PipelineFieldVisibility`** (field_config_id/principal_type rolle|gruppe|user/principal_id/kann_sehen/kann_bearbeiten), **`PipelineAccess`** (pipeline_id/principal/kann_sehen/kann_bearbeiten), `ProjektKontakt` (M:N-Brücke, Rolle), `Adresse`, Lost-Reason. `leads.prisma`/`crm.prisma` nur über Relationen berühren (AD-21).
- **HiveNumberSeq** für Projekt-Nummern: `SELECT … FOR UPDATE`-Row-Lock, **lückenlos** (keine Postgres-Sequence wegen Rollback-Lücken), pro `tenant_id` + `entity_type`.
- **RLS** auf allem Tenant-bezogenen (AD-1); `[Soft-Delete]` auf Projekt/Pipeline/Kontakt.
- **Konnektor** `tenantHasModule('projects')` gated.
- `is_demo_data`-Flag auf geseedeten SHK-Pipelines/Stages/Lost-Reasons/Demo-Projekten.
- Field-Level-Sichtbarkeit **primär über `PipelineFieldVisibility`**, harte `deals.read_volume_*`-Bundles nur als Backstop.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 5: Projekt-zentrischer CRM-Kern** (Projekt/Pipeline/PipelineStage/**PipelineFieldConfig**/**PipelineFieldVisibility**/**PipelineAccess**/ProjektKontakt) + Kern-Ketten-Diagramm + Modellierungs-Fragen 3 (Pipeline-Rechte) & 4 (HiveNumberSeq) — 🔴 **Pivot-Vorrang (AD-20)**: ein Projekt-Kern, Deal = Pipeline-Typ, kein Won-Handoff
- `REQUIREMENTS.md` → `REQ-projekt-kern-datenmodell`, `REQ-pipeline-rechte-config`, `REQ-projekt-pipeline-wechsel` (Phase 8)
- `ROADMAP.md` → Phase 8 (+ Pivot-Note) · `PHASE-SOURCES.md` → P8
- `designer-briefs/P08-projekt-pipelines-kern.md` (Screens + UI-Elemente, Pivot-Vorrang-Hinweis)
- `_bmad-output/specs/M03-sales-pipeline.md` (⚠ teils pre-pivot: „Deal"/„won_handoff_project_id" überholt — 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-P8a` aktualisiert (Titel von „Deal-CRUD" auf projekt-zentrisch nachziehen)