6.6 KiB
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".Statusist immer pipeline-intern (PipelineStage.stage_kind = offen/gewonnen/verloren) — kein globaler Projektstatus.
Abhängigkeiten & Parallelität
- Blocked by:
R-P7(Lead-Inbox liefertlead.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-P15Email/Telefonie u.a.). Schema-Trennung nach AD-21 (Modul = eigene.prisma,db pushlokal, 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_hintsales/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 ODERcustom:<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.prismanur ü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), protenant_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, hartedeals.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-HandoffREQUIREMENTS.md→REQ-projekt-kern-datenmodell,REQ-pipeline-rechte-config,REQ-projekt-pipeline-wechsel(Phase 8)ROADMAP.md→ Phase 8 (+ Pivot-Note) ·PHASE-SOURCES.md→ P8designer-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-P8aaktualisiert (Titel von „Deal-CRUD" auf projekt-zentrisch nachziehen)