# D-P8 · Screens P8 — Projekt & Pipelines (Kern, ohne Kanban) | | | |---|---| | **Typ** | Screen (Design) | | **Owner** | David | | **Phase** | P8 — Projekt & Pipelines Kern (bedient `R-P8a`/`R-P8b`) | | **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-27 → 2026-06-28 · Gate W3 | | **Status** | geplant (NEU — schließt P8-Screen-Lücke außerhalb des Kanban) | > **Ergänzt das Bespoke-Ticket `D-KANBAN`** (Pipeline-Kanban, konfigurierbar). **Dieses Ticket deckt die übrigen P8-Screens** (Projekt-Detail-Basis, Listen-View, Pipeline-Config-Editor, Forecast/Reporting). Der Kanban-Screen ist **NICHT** Teil von D-P8. ## Abhängigkeiten & Parallelität - **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A6 Settings, KPI-Kit) - **Bedient (Dev):** `R-P8a` (Projekt-Kern + Pipeline-Engine), `R-P8b` (konfigurierbarer Kanban + Forecast/Reporting) - **Parallel/Geschwister:** `D-KANBAN` (BESPOKE, das eine Board für ALLE Pipeline-Typen) — D-P8 liefert Detail/Liste/Config/KPI, D-KANBAN das Board; embedded Task-Liste/Files/Audit-Drawer aus `D-P4`/`D-P3` - **Subframe:** Pflicht je Route (A2 Liste, A3 Muster-Detail-View, A6 Settings) ## Was wir bauen Die **Nicht-Kanban-Flächen des `Projekt`-Kerns + der Pipeline-Engine**: die Muster-Projekt-Detail-View, die Cross-Pipeline-Listen-View, den Pipeline-Config-Admin (Stages, Access, FieldConfig, Lost-Reasons) und die Datenquellen/KPIs für Forecast & Reporting. > 🔴 **Pivot-Vorrang (AD-20):** Es gilt das `ENTITY-MODEL.md`. Es gibt **EINEN `Projekt`-Kern** (typisierte Superset-Tabelle) und **konfigurierbare Pipeline-Views**. „Deal" und „Auftrag" sind **Pipeline-Typen** (`Pipeline.typ_hint = sales/auftrag/custom`), **keine** eigenen Entitäten. **Kein Won-Handoff**, kein zweiter Datensatz — ein Projekt wechselt nur die Pipeline. **`Status` ist immer pipeline-intern** (`PipelineStage.stage_kind = offen/gewonnen/verloren`); kein globaler Projektstatus. Field-Level-Sichtbarkeit (z. B. Volumen nur Vertrieb) läuft über **`PipelineFieldConfig`** + **`PipelineAccess`** (kein Deal-/Promotion-Modal). ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | **Projekt-Detail** [`/projects/:id`] | Stammdaten inline-editierbar (Nummer, Name, Beschreibung, Volumen/potenzieller Wert, Pipeline, Stage, Zeitraum, Adressen-Slots) · verknüpfte Kontakte mit Rolle (auftraggeber/bauherr/rechnungsempfaenger/ansprechpartner) · **Lead-Herkunft-Hinweis** (`konvertiert_aus_lead_id`) · **klickbare Stage-Bar** (pipeline-intern) + Stage-Historie mit Verweildauer · Gewonnen/Verloren-Banner mit 24h-Rückgängig · Tags · Custom-Felder (pro Pipeline via PipelineFieldConfig geschaltet) · Activity-Stream · Quick-Actions (Anrufen/Email/Termin/Task/Notiz) · Sub-Area-Tabs (Termine/Aufgaben/Aktivitäten/Dokumente — Rechnungen/Checklisten/Abnahme in P9) | A3 (**Muster-Detail-View**) | | Projekt-Liste [`/projects/list`] | Projekt-Nummer, Titel, Pipeline, Status (Stage), Volumen (gegated), verknüpfter Kontakt/Firma, Zeitraum/Close-Datum, letzte Activity · Cross-Pipeline-Sicht mit Pipeline-Spalte + -Filter · sortierbare Header, Spalten-Konfig, Bulk, CSV-Export, Pagination | A2 | | **Pipeline-Config-Admin** [`/admin/pipelines` bzw. `/:id`] | Pipelines-Liste (Name, typ_hint, Stage-Anzahl, aktive Projekte, Status) · Editor: Stages mit Drag&Drop je Name/`stage_kind` (offen/gewonnen/verloren)/Win-%/Farbe · **PipelineAccess** (wer darf sehen/bearbeiten: Rolle/User/Gruppe — kann_sehen/kann_bearbeiten) · **PipelineFieldConfig** (pro Feld — System ODER `custom:` — Sichtbarkeit + Pflicht + Reihenfolge, optional je Status) · Validation min. 1 gewonnen + 1 verloren · neue Pipeline anlegen/duplizieren/archivieren | A2 + A6 | | Lost-Reasons [`/admin/pipelines/lost-reasons`] | Liste (Name, Anzahl verknüpfter Projekte, Status) · Add/Edit/Archive (kein Hard-Delete — Reporting) · SHK-Default 5 Reasons geseedet | A2 | | Forecast/KPI-Quellen (Widgets in P11) | Datenquellen/Berechnungen: Pipeline-Forecast (Volumen × Win-%), realisierter Umsatz, KPIs pro Verantwortlichem, Stage-Conversion-Rates, Lost-Reason-Verteilung · Aggregat-Cache · (kein eigener Screen — Widgets leben in P11/D-DASH; hier: Datenform + Charts-Bausteine) | KPI-Kit/Charts | *(Pipeline-Kanban = **D-KANBAN** (BESPOKE). Plantafel + Rechnungen/Checklisten/Abnahme-Sub-Areas → P9. Alle Routen bleiben projekt-zentrisch.)* ## Features (muss abgedeckt sein) - [ ] EIN `Projekt`-Kern (typisierte Superset-Tabelle) mit fortlaufenden Projekt-Nummern (HiveNumberSeq) - [ ] Pipeline-Engine-Verwaltung (anlegen/benennen/duplizieren/archivieren; `typ_hint` sales/auftrag/custom; min. 1 gewonnen + 1 verloren) - [ ] PipelineAccess (Sichtbarkeit/Bearbeitung je Rolle/User/Gruppe) + PipelineFieldConfig (Feld-Sichtbarkeit + Pflicht + Reihenfolge je Pipeline/Status) - [ ] Listen-View mit Filter/Bulk/CSV (Cross-Pipeline) - [ ] Projekt-Detail mit klickbarer Stage-Bar, Stage-Historie, Lead-Herkunft-Hinweis, Gewonnen/Verloren-Banner (24h-Rückgängig) - [ ] Field-Level-Sichtbarkeit primär über PipelineFieldConfig; Volumen ohne Recht zeigt „—" - [ ] Forecast/KPI-Datenform + Charts-Bausteine (Forecast/Conversion/Lost-Verteilung) - [ ] Empty/Loading/Fehler/Permission-Denied-States (Klartext) ## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand) Daten-Tabelle (sortierbar, paginiert, Spalten-Konfig, CSV), Pipeline-Spalte + -Filter; Detail-Panel mit Inline-Edit; **klickbare Status-/Stage-Bar**; Stage-Historie mit Verweildauer; Lead-Herkunft-Hinweis; Relations-Liste mit Rollen-Badge (auftraggeber/bauherr/rechnungsempfaenger/ansprechpartner); Custom-Feld-Renderer je Typ; Tag-Chips; Activity-Timeline; Quick-Action-Buttons; gewonnen/verloren-Bestätigungs-Dialog (Lost-Reason-Pflicht) + 24h-Rückgängig-Banner; **Pipeline-Editor** (Stage-Drag&Drop, `stage_kind`/Win-%/Farbe); **PipelineAccess-Matrix** (Principal × sehen/bearbeiten); **PipelineFieldConfig-Liste** (Feld × sichtbar/pflicht/Reihenfolge je Status); Lost-Reasons-CRUD-Liste; KPI-Kacheln/Charts (Forecast/Conversion/Lost-Verteilung); „Volumen verborgen (—)"-Zustand; Empty-/Loading-/Fehler-/Permission-Denied-States. ## Quellen (granular) - `designer-briefs/P08-projekt-pipelines-kern.md` (vollständiger Brief MINUS Kanban — 🔴 Pivot-Vorrang AD-20) - `ENTITY-MODEL.md` → **Domäne 5** (Projekt-Kern + Pipeline/Stage/FieldConfig/Access) + Kern-Ketten-Diagramm + Modellierungs-Fragen 3/4 — 🔴 **Pivot-Vorrang (AD-20)** - `ROADMAP.md` → Phase 8 (+ Pivot-Note) · `REQUIREMENTS.md` → `REQ-projekt-kern-datenmodell` / `REQ-pipeline-rechte-config` / `REQ-projekt-kanban-listen-view` / `REQ-projekt-forecast-kpis` - Geschwister-Ticket (Kanban): `D-KANBAN` · Dev-Pendant: `ticket-docs/R-P8a.md`, `ticket-docs/R-P8b.md` ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: --- ## Umsetzungs-Notiz — Subframe-Baseline (2026-07-28, Akeshan) Davids Handoff `D-P8 + D-KANBAN` (2026-07-28, Repo `Hivegrid-Wireframes`, lokaler Stand = Source of Truth) hat den Flow `WF-P8 Pipelines` auf **23 Subframe-Seiten** neu geschnitten. Alle 23 sind inventarisiert; 10 davon wurden in diesem Durchgang neu gebaut, inklusive des fehlenden Datenmodells. **Davids Delta — beantwortet:** - [x] Überschriebene/geänderte Spec-Punkte: `S01b` und `S02a` entfallen; `S02` ist kein Karteikarten-Platzhalter mehr, sondern ein voller Editor mit Feldgruppen, Schnellaktionsleiste und rechter Pipeline-Seitenleiste. - [x] Neue UI/UX-Entscheidungen: M04 ist **statusgetrieben**, kein Button — das Erreichen der letzten Stage öffnet die Übergabe. M03 hängt am Rechtsklick auf die Kanban-Karte. Bei „Verloren" ist der Grund Pflicht, die Notiz optional. S00 = normale Board-Auswahl, S07 = Admin-Verwaltung. - [x] Subframe-Screen-Link(s): Flow `d9dfdec6-7236-4386-8514-697b9e0f0bc4`, Projekt `f023064a5ca0`. Einzel-Links stehen in den Screen-Dateien des Wireframe-Repos. - [ ] Offene Fragen an Dev → jetzt **Fragen an David**, siehe unten. **Rückfragen an David (blockieren nichts, ändern aber Verhalten):** 1. **M04, abgewählte Begleitdaten.** Der Screen zeigt nicht, was mit Notizen/Dateien/ Aufgaben/Terminen passiert, die *nicht* angehakt sind. Umgesetzt ist die nicht-destruktive Lesart: die Auswahl ist das Übergabe-Paket, abgewählte Daten bleiben unverändert am Projekt. Falls sie tatsächlich verschwinden sollen, ist das eine kleine Änderung im Service — bitte bestätigen. 2. **Nachfolge-Pipeline.** M04 braucht ein „welche Pipeline kommt danach", kein Screen zeigt dieses Control. Gebaut in den Board-Einstellungen. Falls es woanders hin soll, bitte melden. 3. **S05-Feldtypen.** Prozent, Datum + Uhrzeit, Person/Team, Adresse und Link fehlen im Backend und wurden bewusst nicht angeboten (sie bräuchten eine modulübergreifende Enum-Erweiterung im CRM). Sind sie für v1 nötig? **Stand der 23 Screens:** | Gruppe | Screens | Stand | |---|---|---| | Neu gebaut | M04, M04a, M04b, M04c, S02-A, S02-N, S02-T, S02-F, S05, M05 | ✅ inkl. Datenmodell | | Erweitert | S02 | ✅ Feldgruppen + Projektkontaktdaten | | Funktional integriert, 1:1-Nachzug offen | S00, S01, S01a, S03, S03a, S04, S06, S07, S07-D, S07a, M01, M03 | 🟡 | Detail-Proof, Rest-Delta und die technischen Entscheidungen stehen in der Querverweis-Notiz in [`R-P8a.md`](./R-P8a.md).