107 lines
9.4 KiB
Markdown
107 lines
9.4 KiB
Markdown
# 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).
|