Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P11b.md
T
2026-07-08 16:15:37 +02:00

5.3 KiB

R-P11b · P11 Dashboard (3 Rollen-Layouts)

⚠️ KI→MCP-Pivot (AD-26): Die „KI"-Widget-Quelle entfällt aus dem Widget-Katalog (kein LLM/KI-Layer in v1 — HiveGrid wird MCP-Server, VR-MCP). Die Widget-Registry bleibt voll gebaut und erweiterbar; nur die KI-Widgets fallen weg.

Typ Dev (Code)
Owner Raffael
Phase P11 — Globale Suche & Dashboard
Cycle/Fenster W4 — USP, Härtung & Launch · 2026-07-04 → 2026-07-05 · Gate W4
Status On Hold (technische Basis umgesetzt, wartet auf D-DASH)

🟢 Kein Pivot-Sonderfall. Aber: Dashboard-Widgets greifen auf den Projekt-Kern zu (nicht getrennte Deal-/Project-Entitäten). v1 = nur 3 feste Rollen-Layouts (GF/Büro/Monteur) ohne Drag&Drop (Scope-Schnitt 12.06.; User-Layout-Persistenz + Custom-Widgets + Export → v2). Die Widget-Registry wird voll gebaut (Inversion M064→M147).

Abhängigkeiten & Parallelität

  • Blocked by: R-P11a (Suche/Index), R-P8b (Sales-Aggregate für Widgets)
  • Blocks: R-P12a (Automation danach)
  • Sequenz (Raffaels Kern-Kette): sequenziell nach P11a (R-P11a → R-P11b → R-P12a …).
  • Läuft parallel zu: Akeshans Module W4. Schema-Trennung nach AD-21.

Was wir bauen

3 feste Rollen-Dashboards (GF/Büro/Monteur, SHK-Default geseedet) aus einem Widget-Katalog (Sales/Projekte/Tasks/HR/KI (entfällt AD-26)/Activity/Comms), live aktualisiert (SSE/WebSocket, Aggregat-Cache). Edit in v1 = nur Widget-Filter/Zeitraum (kein Drag&Drop-Grid).

Benötigte Screens (Backend bedient — Design liefert D-DASH-Paket)

Screen [Route] Kern-Inhalt
Dashboard [/dashboard bzw. /] 3 feste Rollen-Layouts (kein Drag&Drop v1): GF (Begrüßung, Sales-KPIs, Umsatz-Forecast, Projekt-KPIs, Auslastung, offene Mängel, Team-heute) · Büro (Begrüßung, Projekt-KPIs, meine Tasks, Anrufe heute, HR-Anträge) · Monteur 📱 (meine Termine heute, meine Projekte, meine Tasks); Widgets: KPI-Kachel/Liste/Trend-Chart; Live-Update (SSE/WebSocket) + „Live-Updates pausieren"; Edit = nur Widget-Filter/Zeitraum; „Daten zuletzt aktualisiert vor X Min"
Dashboard-Switcher [im Header] Verfügbare Dashboards (rollen-gematcht) + Default-Routing nach Rolle

Definition of Done

  • 3 feste Rollen-Layouts (GF/Büro/Monteur, SHK-Default geseedet) aus Widget-Katalog
  • Widgets aus Sales/Projekte/Tasks/HR/KI (entfällt AD-26)/Activity/Comms; Widget-Registry voll gebaut (Custom-Widgets/Drag&Drop → v2)
  • Live-Update (WebSocket/SSE) mit Aggregat-Cache + Lazy-Load/Skeleton; Widgets permission-gegated (Quellen-Modul-Permission); Monteur-Dashboard mobile-first
  • Dashboard-Switcher + rollenbasiertes Default-Routing
  • Konnektor tenantHasModule('dashboard') (Dashboard gated)
  • Permissions: dashboard.read/customize (v1: nur Filter/Zeitraum; Drag&Drop-Customize → v2)

Umsetzungsnotiz

2026-07-01: Technische Basis auf main vorbereitet: Prisma-Modelle Dashboard/DashboardLayout/WidgetInstance inkl. RLS-Artefakt, dashboard-Entitlement, dashboard.read/dashboard.customize, Sidebar-Gating, /dashboard-Loader mit rollenbasiertem Switcher, serverseitige Widget-Registry und /dashboard/stream als SSE-Snapshot-Route. Widget-Daten werden permission-gegated aus vorhandenen Quellen gelesen, inkl. Pipeline-Aggregaten, Projekten, Tasks, HR-Anträgen, Activity, Calls, Terminen und offenen Mängeln. Verifikation: pnpm typecheck, pnpm lint, pnpm prisma validate, pnpm test, gezielte R-P11b-Tests und git diff --check grün. Plane-Kommentar geschrieben und Ticket auf Blocked / On Hold gesetzt. DoD: 6/6 technische Punkte = 100 % selbst machbar erledigt. Extern blockiert: finaler Screen-Abgleich und visuelle Integration mit Davids D-DASH-Paket. Ticket bleibt deshalb On Hold, nicht Done.

Technische Bausteine

  • Entities (eigene prisma/schema/dashboard.prisma): Dashboard (name, is_default_for_role gf/office/monteur, is_shared), DashboardLayout (dashboard_id, user_id NULL=shared, widgets[], layout_data — 3 feste Rollen-Layouts v1), WidgetInstance (widget_catalog_key, config, position, size — Custom/Drag&Drop v2). Aggregat-Cache auf Quell-Module über deren .prisma nur lesend (AD-21).
  • RLS auf Dashboard/Layout/Widget (AD-1); Widget-Daten zusätzlich über Quellen-Modul-Permission gegated.
  • Live-Update: SSE/WebSocket-Push bei Aggregat-Änderung; Aggregat-Cache (aus R-P8b für Sales) wiederverwendet.
  • Konnektor tenantHasModule('dashboard') gated.
  • is_demo_data-Flag auf SHK-Default-Layouts/Demo-Widgets.

Quellen (granular)

  • ENTITY-MODEL.md → Domäne 6: Suche & Dashboard (Dashboard/DashboardLayout/WidgetInstance) — Projekt-Kern als Widget-Quelle
  • REQUIREMENTS.md → REQ-dashboard-datenmodell (3 feste Rollen-Layouts), REQ-dashboard-widgets (Phase 11)
  • ROADMAP.md → Phase 11 · PHASE-SOURCES.md → P11
  • designer-briefs/P11-suche-dashboard.md (3 Rollen-Layouts, kein Drag&Drop v1)
  • _bmad-output/specs/M20-dashboard.md (⚠ 7 Rollen-Dashboards → v1 nur 3; Drag&Drop/Custom-Widgets → v2)

Dev-Nachzug (nach Davids D-DASH-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket R-P11b aktualisiert