Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/D-P8.md
T

7.1 KiB
Raw Blame History

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:<id> — 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. „Deal-Liste/Deal-Detail" aus SCREEN-MAP entfällt — projekt-zentrische Routen oben.)

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 · PHASE-SOURCES.md → P8
  • _bmad-output/specs/M03-sales-pipeline.md (⚠ „Deal"/„won_handoff_project_id" = Projekt-Kern bzw. Pipeline-Wechsel)
  • 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: