Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-P8.md
T

9.4 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. 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:

  • Ü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.
  • 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.
  • 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.