"use client"; import React from "react"; import Link from "next/link"; import { Begruessung } from "../components/dashboard/Begruessung"; import { Widget, WidgetRaster } from "../components/dashboard/WidgetRaster"; import { WidgetKachel } from "../components/dashboard/WidgetKachel"; import { KPICard } from "../components/cards/KPICard"; import { AlertList } from "../components/cards/AlertList"; import { AreaVerlauf } from "../components/charts/AreaVerlauf"; import { BalkenHorizontal } from "../components/charts/BalkenHorizontal"; import { AuslastungsBalken } from "../components/charts/AuslastungsBalken"; import { Trichter } from "../components/charts/Trichter"; import { ChartLegende } from "../components/charts/ChartLegende"; import { SeitenZustand } from "../components/layout/SeitenZustand"; import { PRIMAER_FARBE, VERGLEICH_FARBE } from "../utils/chartTheme"; import { formatEuro, formatEuroAchse, formatEuroKompakt, formatProzent, formatZahl, } from "../utils/formatters"; import type { VMState } from "../view-models"; import { ZEITRAUM_LABEL, type DashboardDaten, type KennzahlKachel } from "../view-models/dashboard.vm"; /** * Das Dashboard, der Begrüßungsbildschirm nach der Anmeldung. * * ## Was hier steht und warum * * Das Dashboard beantwortet „Wie ist meine Lage?", Analytics beantwortet * „Warum ist das so?" (`docs/SCOPE-ANALYTICS-DASHBOARD.md`). Daraus folgt die * Reihenfolge auf dieser Seite, und zwar in dieser Richtung: * * 1. **Ansprache und Lage**: muss ich heute überhaupt etwas tun? * 2. **Vier Kennzahlen**, die Lage in Zahlen. Jede ist ein Link in die * Analyse, die sie erklärt. * 3. **Handlungsbedarf**, was zu tun ist. Laut Scope-Papier (3.2) gehört * diese Liste hierher und nicht auf die Analytics-Übersicht; das ist * hiermit umgesetzt. * 4. **Vier Diagramme**, die Zusammenfassung aus Analytics. * 5. **Reservierte Plätze**, was das Dashboard noch wird. * * Absteigend nach Dringlichkeit, nicht nach Fachgebiet. Ein Dashboard, das * nach Fachgebieten sortiert ist, ist ein Inhaltsverzeichnis. * * ## Wie das Raster zu lesen ist * * Jede Kachel steht in ``. Diese beiden Zahlen * sind in der Software `widget.size.w` und `widget.position.x` und kommen dort * aus dem gespeicherten Layout, der Benutzer kann es bearbeiten. Hier sind * sie geschrieben. Das ist der einzige Unterschied; das Raster darunter ist * dasselbe (siehe `WidgetRaster.tsx`). * * ## Was hier bewusst fehlt * * Kein seitenweiter Filter. In Analytics wirkt eine Filterleiste auf alle * Karten; im Dashboard trägt jede Kachel ihren eigenen Zeitraum und sagt ihn * an (P11: „Edit = nur Widget-Filter/Zeitraum"). Eine Filterleiste über * dieser Seite wäre die bequemere Lösung und der falsche Weg, sie würde die * Kacheln beim Einbau alle wieder auseinandernehmen. * * Auch keine Rollenumschaltung. Der Prototyp gestaltet die Sicht der * Geschäftsführung; die Layouts für Büro und Monteur entstehen aus denselben * Kacheln in anderer Zusammenstellung und sind eine Produktentscheidung, * keine Gestaltungsfrage. */ export function DashboardSeite({ vm }: { vm: VMState }) { if (vm.status !== "ready") { return ; } const d = vm.data; const kritisch = d.handlungsbedarf.some((a) => a.art === "kritisch"); /** Die vier Kennzahlen sitzen nebeneinander in je drei von zwölf Spalten. */ const kennzahlStart = [0, 3, 6, 9] as const; return ( <>
{d.kennzahlen.map((kachel, index) => ( ))} {/* mittelVoll: Der Verlauf daneben nimmt zwischen `md` und `lg` die volle Breite. Ohne das stünde diese Kachel dort allein in einer halben Zeile, und die andere Hälfte bliebe weiß. */} formatZahl(w)} /> {/* ──────────────────────────────────────────────────────────────── HIER GEHT ES WEITER: an dieser Stelle, nicht woanders. Das Dashboard zeigt heute nur Auswertungen. Es wird mehr: eigene Aufgaben, Termine des Tages, offene HR-Anträge. Alle drei stehen im Designer-Brief P11 und haben in HiveGrid bereits ihre Widget-Domäne (`tasks`, `schedule`, `hr`): sie brauchen kein neues Raster, nur Daten. Konkret kommen sie als drei weitere `` mit `start={0}`, `{4}` und `{8}` unter diese Zeile. Das Raster darüber bleibt dabei unangetastet; genau dafür ist es aus `DashboardPage.tsx` übernommen. Die Kacheln sind beschrieben in `RESERVIERTE_BEREICHE` (view-models/dashboard.vm.ts) und zu sehen unter „/komponenten", Abschnitt „Dashboard-Kacheln". Der Zuschnitt steht in docs/SCOPE-ANALYTICS-DASHBOARD.md, Abschnitt 3a. Warum sie hier nicht als Platzhalter stehen: Der Begrüßungsbildschirm ist kein Ort für Ankündigungen. Wer sich morgens anmeldet, will seine Lage sehen und nicht lesen, was später einmal kommt. ──────────────────────────────────────────────────────────────── */}
); } /** * Eine Kennzahl als Kachel. * * Es ist dieselbe `KPICard` wie in Analytics: dieselbe Anatomie, dieselben * Regeln zu Trend und Farbe. Neu ist nur, dass sie ein Link ist: Auf dem * Dashboard ist jede Zahl ein Absprung in die Analyse, die sie erklärt. Genau * so macht es die Software (`widget.href` legt den Link um die `StatsCard`). */ function KennzahlWidget({ kachel, sparkline, }: { kachel: KennzahlKachel; sparkline?: number[]; }) { const wert = kachel.formatAls === "euro" ? formatEuro(kachel.wert) : kachel.formatAls === "prozent" ? formatProzent(kachel.wert, 0) : formatZahl(kachel.wert); return ( ); }