Finalize P8 pipeline wireframe handoff

This commit is contained in:
david committed 2026-07-28 19:32:30 +02:00
1 parent 8ee75ae314
commit 8266352421
33 files changed
+1389 -459

No files matched your search

@@ -5,53 +5,55 @@ ticket: D-KANBAN
package: WF-P8 Pipelines
id: S01
screen: Kanban-Board
typ: BESPOKE Board
subframe_name: "S01 Kanban-Board"
subframe_page_id: "52699d37-974d-4f5d-b3d0-003de765b692"
typ: Board-Hauptansicht
umsetzung: Bauen
status: Validiert
route: "/projects"
subframe: ""
status: In Subframe
route: ""
subframe: "https://app.subframe.com/f023064a5ca0/design/52699d37-974d-4f5d-b3d0-003de765b692/edit"
source_checked: 2026-07-28
---
# S01 — Kanban-Board ⭐
# S01 — Kanban-Board
## Ziel
## Ziel und Rolle im Flow
Der Vertrieb auf einen Blick: Wo steht welches Projekt, was hängt, was ist gewonnen?
Projektarbeit in der Board-Ansicht der ausgewählten Pipeline. Das Beispiel zeigt „Vertrieb: Anlagen-Verkauf“ und ist die Board-Schwesteransicht von [[S03 Projekt-Liste]].
## Was das Tool können muss
## Sichtbare Struktur und Daten
- **EIN Board-System für alle Board-Typen** (Vertrieb/Auftrag/eigene) — Boards sind Views auf denselben Projekt-Datensatz
- **Karten ziehen = Status wechseln**, mit Validation (unerlaubte Spalte → Karte springt zurück + Klartext)
- **Gewonnen-Spalte:** Regel greift (Auto-Verschieben nach Board X, Toast) oder [[M02 Board-Wechsel-Dialog]]
- **Verloren-Spalte:** [[M01 Verloren-Dialog]] — Grund ist Pflicht
- Umsatz-Aggregate nur für Berechtigte (sonst »—«)
- Live (mehrere Nutzer sehen Änderungen sofort), Pagination je Spalte (100+)
- Kopf: Pipelines, Board-Auswahl, Umschalter Board/Liste, Board-Einstellungen, Projekt anlegen.
- Filter: Sachbearbeiter, Kundentyp, Tags, Zeitraum, Auftragswert; Schnellfilter „Nur meine Projekte“.
- Aktive Filter im Beispiel: PV / Solar, Wärmepumpe, Nur meine Projekte.
- Spalten: Neu (4), Qualifiziert (4), Angebot (3).
- Karten: Projektname, Kontakt/Ort, Tags, Auftragswert oder „—“, Avatar, Start-/Enddatum, nächster Termin und Prioritätsvariante.
- Die elf Beispielprojekte entsprechen der Tabellenansicht in S03.
## Pattern / Archetyp
## Aktionen und Verknüpfungen
**BESPOKE** — horizontales Spalten-Board.
- Umschalter „Liste“ → [[S03 Projekt-Liste]].
- „Board-Einstellungen“ → [[S04 Board-Einstellungen]].
- Projektkarte öffnen → [[S02 Pipelines Detailansicht]] (fachlich aus Card/Detail-Seitenfamilie abgeleitet).
- Leerer bzw. weggefilterter Zustand → [[S01a Kanban-Board Empty State]].
- Rechtsklick auf eine Kanban-Karte → [[M03 Kontextmen_ Rechtsklick]].
- Status „Verloren“ gehört zum Pflichtdialog [[M01 Verloren-Dialog]].
- Wird eine Karte in die letzte Stage bzw. den abschließenden Status gezogen, öffnet sich automatisch [[M04 Pipeline-Uebergabe]]. Das ist statusgetrieben und kein eigener Button.
## Daten
## Aktueller Umfang
- Board-Wechsler oben (nur Boards, die die Rolle sehen darf) + Umschalter Board/Liste ([[S03 Projekt-Liste]])
- Spaltenkopf: Name · Projekt-Anzahl · Summe (gegated) · Win-%
- Karte (fix, kein Karten-Editor v1): Titel · Umsatz (gegated) · Verantwortlicher-Avatar · Termin-/Abschlussdatum · max. 3 Tags · Hänger-Marker (zu lange in Spalte)
- Filter: Verantwortlicher, Tags, Umsatz-Bereich, Datum · »nur meine«-Schnellfilter
Im JSX sind drei Board-Spalten und statische `ProjectCard`-Instanzen sichtbar. Drag-and-drop-, Bulk- oder Live-Logik ist im exportierten Screen-Code nicht verdrahtet. Für Development ist jedoch validiert: Karten-Rechtsklick öffnet M03; das Setzen auf die letzte Stage öffnet statusbasiert M04.
## Aktionen
## Permissions / Gates
- Karte öffnen → [[S02 Projekt-Detailseite]]
- Drag&Drop · Mehrfachauswahl + Bulk (zuweisen, Spalte, Tags)
- Admin: **»Board verwalten«** → [[S04 Board-Einstellungen]] · **Edit-Mode** → [[S05 Detail-Schablone Edit-Mode]]
- Einzelne Auftragswerte werden als „—“ dargestellt; andere Karten zeigen Beträge.
- Der Screen selbst erklärt den Grund dafür nicht, bildet aber damit einen gegateten Wertzustand ab.
## Zustände
## Verwendete Komponenten
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leeres Board | »Noch keine Projekte« + CTA (Lead-Eingang / anlegen) | Nur dokumentieren |
| Live weg | Inline »aktualisiert sich gerade nicht« | Nur dokumentieren |
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
`KanbanColumn`, `ProjectCard`, `FilterBar`, `DropdownMenuMultiSelect`, `ToggleGroup`, `Switch`, `Tag_Label`, `Avatar`, `Button`.
## Subframe
- (erst nach explizitem OK)
- [Screen direkt öffnen](https://app.subframe.com/f023064a5ca0/design/52699d37-974d-4f5d-b3d0-003de765b692/edit)
- [P8-Flow öffnen](https://app.subframe.com/f023064a5ca0/flow/d9dfdec6-7236-4386-8514-697b9e0f0bc4/edit)