Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/R-P11b.md
T

56 lines
4.3 KiB
Markdown

# 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** | geplant |
> 🟢 **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)
## 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