Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,59 @@
# 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: