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

6.6 KiB
Raw Blame History

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)