Das Dashboard ist ein eigenes Feature neben Analytics: der Begruessungsbildschirm, nicht ein zweiter Analysebereich. Es zeigt heute nur Auswertungen, ist aber so gebaut, dass die spaeteren Bereiche als weitere Kacheln dazukommen und nicht als Umbau. Aufbau: Begruessung, vier Kennzahlen (je ein Link in die Analyse), Handlungsbedarf, vier Diagramme, drei reservierte Plaetze. Drei Entscheidungen, die dabei getroffen wurden: - Kein seitenweiter Filter. Jede Kachel traegt ihren eigenen Zeitraum und schreibt ihn in den Kopf. Das ist das Bedienmodell der Software (P11) und war die unbequemere Variante; eine Filterleiste haette beim Einbau alle Kacheln wieder auseinandergenommen. - Das Raster ist aus DashboardPage.tsx der Software uebernommen, nicht erfunden: dieselben Klassen, dieselbe Ableitung aus size.w und position.x. Der Software fehlt dafuer eine Zeile (position.x === 9); vermerkt in WidgetRaster.tsx. - Die reservierten Plaetze zeigen keine erfundenen Zahlen. "2 neue Antraege" aus dem Nichts liest sich in einer Abnahme wie eine fertige Funktion. Absichtliche Doppelung: Der Handlungsbedarf steht jetzt auf dem Dashboard und weiterhin auf der Analytics-Uebersicht. Ihn dort zu entfernen haette die offene Frage 5.1 mitentschieden. Dokumentiert in Abschnitt 3a des Scope-Papiers, aufzuloesen vor dem Port. Nebenbei zwei Fehler behoben, die auch Analytics betrafen: - Die Beschriftungen der Zeitachse liefen in schmalen Karten ineinander (fuenf Kalenderwochen brauchen 200px, eine halbe Kachel bei 768px hat 150). Recharts duennt sie jetzt selbst aus und haelt Anfang und Ende. - Das Zeitraum-Etikett im Kachelkopf schaltete per Viewport-Breakpoint, die Kachelbreite haengt aber am Raster. Bei 1024px blieben dem Untertitel 77px, und er lief ins Diagramm. Jetzt Container-Query. Die Wurzel leitet auf /dashboard statt /analytics — wie in der Software, wo nach der Anmeldung der Begruessungsbildschirm steht. tsc, lint, build, verify:carbon und verify:layout (7 Seiten x 9 Breiten) laufen sauber. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
148 lines
4.9 KiB
TypeScript
148 lines
4.9 KiB
TypeScript
"use client";
|
|
|
|
import React from "react";
|
|
import {
|
|
Area,
|
|
CartesianGrid,
|
|
ComposedChart,
|
|
Line,
|
|
ResponsiveContainer,
|
|
Tooltip,
|
|
XAxis,
|
|
YAxis,
|
|
} from "recharts";
|
|
import { ChartTooltip } from "./ChartTooltip";
|
|
import { ChartLeer } from "./ChartLeer";
|
|
import {
|
|
CHART,
|
|
MARGIN,
|
|
MAX_ACHSENLABELS,
|
|
PRIMAER_FARBE,
|
|
VERGLEICH_FARBE,
|
|
achseX,
|
|
achseY,
|
|
nettesRaster,
|
|
} from "../../utils/chartTheme";
|
|
import type { ZeitreihePunkt } from "../../data/types";
|
|
|
|
/**
|
|
* Zeitverlauf als Fläche mit optionaler Vergleichslinie (Vorjahr).
|
|
*
|
|
* Bewusst `ComposedChart`, nicht `AreaChart`: Recharts sammelt in einem
|
|
* AreaChart ausschließlich `Area`-Kinder ein (generateCategoricalChart mit
|
|
* GraphicalChild = Area). Ein `<Line>` darin wird stillschweigend verworfen —
|
|
* die Vergleichsreihe stand monatelang in der Legende, ohne je gezeichnet zu
|
|
* werden. ComposedChart nimmt beide Typen.
|
|
*
|
|
* Carbon-Regeln, die hier umgesetzt sind:
|
|
* - nur horizontale Gridlines (#e0e0e0), vertikale lenken ab
|
|
* - keine Tick-Marks, Achsenbeschriftung 12 px in #525252
|
|
* - lineare Interpolation: eine Monotone-Kurve erfindet Zwischenwerte
|
|
* zwischen zwei Messpunkten, die es nicht gibt
|
|
* - Vergleichsreihe gestrichelt und neutral, damit sie die Hauptreihe
|
|
* nicht um Aufmerksamkeit bringt
|
|
*/
|
|
export function AreaVerlauf({
|
|
daten,
|
|
formatWert,
|
|
/** Kürzere Schreibweise für die Y-Achse; ohne Angabe wie formatWert. */
|
|
formatAchse,
|
|
hoehe = 260,
|
|
zeigeVergleich = false,
|
|
farbe = PRIMAER_FARBE,
|
|
labelPrefix,
|
|
}: {
|
|
daten: ZeitreihePunkt[];
|
|
formatWert: (wert: number) => string;
|
|
formatAchse?: (wert: number) => string;
|
|
hoehe?: number;
|
|
zeigeVergleich?: boolean;
|
|
farbe?: string;
|
|
labelPrefix?: string;
|
|
}) {
|
|
// Zwei Verläufe auf einer Seite dürfen sich keinen Gradienten teilen.
|
|
const gradientId = `verlauf-${React.useId().replace(/:/g, "")}`;
|
|
|
|
const hatWerte = daten.some((d) => d.value > 0 || (d.vergleich ?? 0) > 0);
|
|
if (!daten.length || !hatWerte) return <ChartLeer hoehe={hoehe} />;
|
|
|
|
/**
|
|
* Beschriftungen der Zeitachse ausdünnen — zweistufig, weil zwei
|
|
* verschiedene Dinge sie zum Kollidieren bringen.
|
|
*
|
|
* Viele Punkte: Bei mehr als zwölf Werten wird fest jede n-te Beschriftung
|
|
* gezeigt. Das ist eine Entscheidung über die Lesbarkeit der Reihe und darf
|
|
* nicht von der Kartenbreite abhängen, sonst zeigt dieselbe Reihe auf zwei
|
|
* Bildschirmen verschiedene Stützstellen.
|
|
*
|
|
* Wenige Punkte in einer schmalen Karte: Fünf Kalenderwochen brauchen rund
|
|
* 200 px. Eine halbe Kachel bei 768 px hat 150 px — dort liefen "KW 27" und
|
|
* "KW 28" ineinander. `preserveStartEnd` mit `minTickGap` überlässt Recharts
|
|
* das Weglassen und hält dabei die erste und letzte Beschriftung, damit der
|
|
* Zeitraum ablesbar bleibt.
|
|
*/
|
|
const vieleWerte = daten.length > MAX_ACHSENLABELS;
|
|
const intervall = vieleWerte
|
|
? Math.ceil(daten.length / MAX_ACHSENLABELS) - 1
|
|
: ("preserveStartEnd" as const);
|
|
|
|
const maximum = Math.max(
|
|
...daten.map((d) => Math.max(d.value, zeigeVergleich ? (d.vergleich ?? 0) : 0))
|
|
);
|
|
const raster = nettesRaster(maximum);
|
|
|
|
return (
|
|
<div style={{ height: hoehe }}>
|
|
<ResponsiveContainer width="100%" height="100%">
|
|
<ComposedChart data={daten} margin={MARGIN.standard}>
|
|
<defs>
|
|
<linearGradient id={gradientId} x1="0" y1="0" x2="0" y2="1">
|
|
<stop offset="0%" stopColor={farbe} stopOpacity={0.24} />
|
|
<stop offset="100%" stopColor={farbe} stopOpacity={0.02} />
|
|
</linearGradient>
|
|
</defs>
|
|
|
|
<CartesianGrid stroke={CHART.grid} vertical={false} />
|
|
<XAxis dataKey="label" interval={intervall} minTickGap={12} {...achseX} />
|
|
<YAxis
|
|
domain={raster.domain}
|
|
ticks={raster.ticks}
|
|
tickFormatter={formatAchse ?? formatWert}
|
|
{...achseY}
|
|
/>
|
|
<Tooltip
|
|
cursor={{ stroke: CHART.achse, strokeWidth: 1, strokeDasharray: "3 3" }}
|
|
content={(props) => (
|
|
<ChartTooltip {...props} formatWert={formatWert} labelPrefix={labelPrefix} />
|
|
)}
|
|
/>
|
|
|
|
<Area
|
|
type="linear"
|
|
dataKey="value"
|
|
name="Aktueller Zeitraum"
|
|
stroke={farbe}
|
|
strokeWidth={2}
|
|
fill={`url(#${gradientId})`}
|
|
dot={false}
|
|
activeDot={{ r: 4, fill: farbe, stroke: "#fff", strokeWidth: 2 }}
|
|
/>
|
|
|
|
{zeigeVergleich ? (
|
|
<Line
|
|
type="linear"
|
|
dataKey="vergleich"
|
|
name="Vorjahr"
|
|
stroke={VERGLEICH_FARBE}
|
|
strokeWidth={1.5}
|
|
strokeDasharray="4 4"
|
|
dot={false}
|
|
activeDot={{ r: 4, fill: VERGLEICH_FARBE, stroke: "#fff", strokeWidth: 2 }}
|
|
/>
|
|
) : null}
|
|
</ComposedChart>
|
|
</ResponsiveContainer>
|
|
</div>
|
|
);
|
|
}
|