# 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 - [x] **EIN `Projekt`-Kern** (typisierte Superset-Tabelle: Deal- + Auftrags-Felder + `CustomFieldValue`) mit fortlaufenden Projekt-Nummern (**HiveNumberSeq, Row-Lock/lückenlos**); RLS + Soft-Delete - [x] **Pipeline-Engine:** Pipeline anlegen/benennen/duplizieren/archivieren (`typ_hint` sales/auftrag/custom); `PipelineStage` = die Statuswerte; Validation min. 1 gewonnen + 1 verloren - [x] **PipelineAccess** (wer sieht/bearbeitet Pipeline je Rolle/User/Gruppe) - [x] **PipelineFieldConfig** (Feld-Sichtbarkeit + Pflicht + Reihenfolge je Pipeline/Status; nicht sichtbare Felder **bleiben erhalten**) - [x] **PipelineFieldVisibility** (Field-Level-Rechte je Principal — z.B. Auftragsvolumen nur für Vertrieb; ohne Eintrag = für alle sichtbar) - [x] **M049: `lead.qualified` → Auto-Projekt** (Projekt automatisch in Sales-Pipeline) — Pipeline-Wechsel-Modell, kein Won-Handoff/zweiter Datensatz - [x] **Lost-Reason-CRUD** (kein Hard-Delete, SHK-Defaults geseedet) - [x] Konnektor `tenantHasModule('projects')` (Sidebar + Routes + Actions gated) - [x] `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:`/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)