59 lines
6.6 KiB
Markdown
59 lines
6.6 KiB
Markdown
# 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)
|