56 lines
4.3 KiB
Markdown
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
|