Dashboards
Zweck
Dashboards sind individuell zusammenstellbare Sichten auf KPIs, Listen und Charts. Pro Dashboard pflegen Sie ein Tile-Grid (DashboardGrid) — die Tiles selbst sind separate DashboardTile-Datensaetze. Ein KI-Tile-Generator (DashboardTileChat) hilft beim Erzeugen passender Tiles via natuerlicher Sprache, sofern in Zustand-Store mindestens ein verfuegbarer AI-Provider hinterlegt ist.
Voraussetzungen
Berechtigungen (CASL)
| Action | Subject | Wirkung | Keycloak-Rolle |
|---|---|---|---|
view | FE_Dashboard, Dashboard | Liste/Details aufrufbar | — |
create/update/delete | Dashboard | Pflegen | APP_SPEAMCORE_CREATE/UPDATE/DELETE_DASHBOARD |
view | DashboardTile | Tiles im Grid sichtbar | APP_SPEAMCORE_VIEW_DASHBOARD_TILE |
Schritt-für-Schritt-Anleitung
Dashboard anlegen
- Dashboards (
/dashboards) → + Neu. - Name vergeben.
- Tiles im DashboardGrid ergaenzen — manuell oder per Klick auf den KI-Tile-Chat.
Dashboard zuweisen
Dashboards werden über DepartmentDashboardAssignments und RoleDashboardAssignments verknuepft — geschieht typischerweise in der Administration.
UI-Elemente
Komponente: DashboardGrid
Rendert die Tiles. Im Offline-Modus laeuft der Grid mit previewMode = true (Daten-Stale-Check).
Komponente: DashboardTileChat
KI-gestuetzter Generator. Erfordert mindestens einen AI-Provider mit available = true. Wird sonst nicht angezeigt.
Felder und Eingaben
| Feldname | Pflicht | Datentyp | Beschreibung | Wirkung beim Ausfuellen | Voraussetzung |
|---|---|---|---|---|---|
name | nein | String | Dashboard-Bezeichnung. | Erscheint in Auswahl-Listen und in Department-/Role-Zuweisungen. | — |
Tiles selbst sind keine Felder im Dashboard-Form — sie werden über DashboardTile (eigene CRUD) verwaltet.
Wiederverwendbare Konzepte
Verknuepfungen zu anderen Modulen
- DepartmentDashboardAssignments — Dashboard ↔ Abteilung (N:M).
- RoleDashboardAssignments — Dashboard ↔ Rolle (N:M).
- Mitarbeiter — Tab Dashboard im Mitarbeiter-Stamm zeigt zugewiesene Dashboards.
Häufige Fehler und Lösungen
| Fehler | Lösung |
|---|---|
| KI-Tile-Chat nicht sichtbar | Kein AI-Provider mit available = true. AI-Provider in Zustand-Store hinterlegen. |
| Tiles aktualisieren nicht | Online-Status prüfen — im Offline-Modus laeuft previewMode = true. |
| Dashboard nicht im Mitarbeiter sichtbar | Department- oder Role-Zuweisung fehlt. |
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|---|---|---|
GET | /api/dashboards | Liste | view Dashboard |
GET | /api/dashboards/:id | Detail | view Dashboard |
POST | /api/dashboards | Anlegen | create Dashboard |
PATCH | /api/dashboards/:id | Ändern | update Dashboard |
DELETE | /api/dashboards/:id | Soft-Delete | delete Dashboard |
GET | /api/dashboards/:id/tiles | Tiles | view DashboardTile |
POST | /api/dashboards/:id/tiles | Tile anlegen | create DashboardTile |
Versionshinweise
- 2026-04-29: Initiale Veroeffentlichung.