Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VA-P30a.md
T

3.7 KiB

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