Files
Dashboard/features/dashboard/components/charts/AreaVerlauf.tsx
T
dejanandClaude Opus 5 831a6ec9ad Dashboard als Widget-Flaeche bauen, Platzhalter ersetzen
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
2026-08-31 16:51:09 +02:00

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>
);
}