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

7.8 KiB
Raw Blame History

R-P8a · P8 Pipeline-Engine + Projekt-CRUD (Sales-Sicht) + Auto-Projekt

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 On Hold — serverseitig umgesetzt, Screen-Delta D-KANBAN/D-P8 offen

🔴 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 das Auto-Projekt (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-Projekt (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 → „—")

Umsetzungs-Notiz

2026-07-01 — Server-/Contract-Umsetzung ohne finale Screens: Projekt/Pipeline-Schema in prisma/schema/projekt.prisma, RLS-Artefakt prisma/rls/projekt-isolation.sql, Tenant-Snapshot-Registry, projects-Entitlement, Default-Permissions, Sidebar-Gate und minimale Routes ergänzt. Project-Service baut lückenlose HiveNumberSeq-Projekt-Nummern via SELECT ... FOR UPDATE, Default-Sales-Pipeline + SHK-Lost-Reasons, Pipeline CRUD/duplicate/archive, PipelineAccess, PipelineFieldConfig, PipelineFieldVisibility, Lost-Reason CRUD und M049 lead.qualified → automatische Projektanlage. Der Lead-Detail-Convert-Pfad ruft bei fehlender Projekt-ID direkt createProjectFromQualifiedLead auf.

Proof lokal: Implementierungs-Commit 6c8cec822; pnpm typecheck, pnpm lint, pnpm run verify:i18n, pnpm exec prisma validate, pnpm run verify:tenant-isolation-report, pnpm test grün. Zusätzlich fokussiert: projectService.test.ts, AppSidebar.test.tsx, tenant/models.test.ts, Entitlements-/RoleDisplay-/UIInventory-Tests.

Stand: R-P8a: 9/9 DoD = 100 % serverseitig done. Ticket bleibt fachlich On Hold, bis D-KANBAN/D-P8 final geliefert und die Screen-Implementierung/visuelle Abnahme nachgezogen ist.

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)