51 lines
3.7 KiB
Markdown
51 lines
3.7 KiB
Markdown
# VA-P30a · P30 Dashboard-Deluxe: Custom-Widgets + Export (M149/150)
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Dev (Code) |
|
|
| **Owner** | Akeshan |
|
|
| **Phase** | P30 — Komfort & Querschnitt (Dashboard-Deluxe) · v2-P10 |
|
|
| **Cycle/Fenster** | v2-W3 — Admin/Help/Dashboard/v2-Launch · fällig 2026-07-30 |
|
|
| **Status** | geplant |
|
|
|
|
## Abhängigkeiten & Parallelität
|
|
- **Blocked by:** `R-P11b` (Dashboard/Widget-Registry — voll gebaut in v1; P30 ergänzt nur das Komfort-Delta)
|
|
- **Blocks:** —
|
|
- **Läuft parallel zu:** `VA-P30b` (Querschnitt: Notif/i18n — gleiche Phase, getrennte Domänen), sowie `VA-P28b`/`VA-P29` im W3-Slot. Erweitert `prisma/schema/dashboard.prisma` additiv (AD-21).
|
|
- **Konflikt-Risiko:** gering — **Delta-Phase, kein Neubau**; additive Custom-Widget-/Layout-Felder auf v1-Dashboard.
|
|
|
|
## Was wir bauen
|
|
Das **Komfort-Delta auf dem v1-Dashboard** (M149/M150, kein Neubau): User passen ihr Dashboard an (**Drag/Resize**, **permission-gegateter Widget-Catalog**), bohren **pro Kachel in Drilldowns**, exportieren als **CSV/Report** (Report-Versand) und schalten **Realtime mit Opt-Out**. Die Widget-Registry steht aus v1 (R-P11b) — hier kommen Custom-Widgets + anpassbares Layout + Export dazu.
|
|
|
|
## Benötigte Screens (Backend bedient — Design liefert `D-P30`)
|
|
| Screen [Route] | Kern-Inhalt |
|
|
|---|---|
|
|
| Dashboard-Edit-Modus [`/dashboard` (edit)] | Grid mit **Drag/Resize**, Widget-Picker (**permission-gegateter Catalog**), Pro-Widget-Config, Layout speichern |
|
|
| Dashboard-Drilldown [`/dashboard` (Kachel)] | Pro-Kachel-Drilldown in Detail-Daten, **CSV-Export**, **Report-Export** |
|
|
|
|
## Definition of Done
|
|
- [ ] **Layout anpassbar** (Drag/Resize, **permission-gegateter** Widget-Catalog)
|
|
- [ ] **Drilldown pro Kachel** + **CSV-Export** + **Report-Versand**
|
|
- [ ] **Realtime-Updates mit Opt-Out**
|
|
- [ ] Wiederverwendung v1: Dashboard/Widget-Registry (R-P11b), Role-Default-Layouts (deklaratives Template, geteilt mit P3)
|
|
- [ ] Konnektor `tenantHasModule('dashboard')`; **RLS** auf `DashboardLayout`/`WidgetInstance`
|
|
|
|
## Technische Bausteine
|
|
- **Entities** (Delta auf `prisma/schema/dashboard.prisma`, AD-21): `Dashboard` (name, is_default_for_role gf/office/monteur, is_shared), `DashboardLayout` (dashboard_id, user_id NULL=shared, widgets[], layout_data — **Drag/Resize-Daten**), `WidgetInstance` (widget_catalog_key, config, position, size — **Custom-Widgets + Drag&Drop = v2-Delta**). `core.prisma` nur über Relation.
|
|
- **Widget-Catalog permission-gegated:** Catalog filtert nach Permissions des Users; Pro-Widget-Config persistiert in `WidgetInstance.config`.
|
|
- **Drilldown + Export:** Pro-Kachel-Drilldown in Detail-Query; CSV-Export + Report-Export (Versand über v1-Sende-Domain/`notify()`).
|
|
- **Realtime:** WebSocket-Updates pro Widget mit **Opt-Out**-Toggle.
|
|
- **RLS** überall; Role-Default-Layouts als deklaratives Template (geteilter Mechanismus mit P3-Branchen-Template).
|
|
|
|
## Quellen (granular)
|
|
- `ROADMAP-V2.md` → **§v2-P10 Komfort & Querschnitt** (Dashboard-Teil = Hauptquelle; Recut „Delta, kein Neubau")
|
|
- `ENTITY-MODEL.md` → **Domäne 6: Suche & Dashboard** (`Dashboard`/`DashboardLayout`/`WidgetInstance` — Custom-Widgets + Drag&Drop → v2)
|
|
- `ROADMAP.md` → Phase 30 · `PHASE-SOURCES.md` → Phase 30 (M149 Custom-Widgets + Drilldown, M150 Dashboard-Export/Report)
|
|
- `designer-briefs/P30-dashboard-deluxe-querschnitt.md` (Dashboard-Edit-Modus, Drilldown, Export — NUR Dashboard/Notif/i18n, HR-Drittanbieter = P34)
|
|
- `_bmad-output/specs/M20-dashboard.md` (Custom-Widgets/Export)
|
|
|
|
## Dev-Nachzug (nach Davids `D-P30`-Delta)
|
|
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
|
|
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
|
|
- [ ] Plane-Ticket `VA-P30a` aktualisiert
|