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

107 lines
9.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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:**
- [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).