feat(dashboard): Analytics-Dashboard als Gestaltungsvorlage zur Übergabe
UI/UX-Prototyp der Analytics-Dashboards in HiveGrid, fachlich auf einen SHK-/Handwerksbetrieb zugeschnitten. Ziel ist die Übergabe an die Entwicklung, nicht der Produktivbetrieb. Inhalt: sechs Seiten (Übersicht, Finanzen, Aufträge, Kunden, Team, Komponenten), 26 KPIs, neun Chart-Bausteine, Filtersystem mit seitenabhängiger Relevanz und ein deterministischer Demo-Datensatz (420 Kunden, 1.900 Aufträge, Stichtag 30.07.2026). Drei Quellen sind zusammengeführt: die fachliche Planung mit dem Branchenpartner (Januar 2026), die Subframe-Komponentenbibliothek aus dem HiveGrid-Pitch und IBM Carbon Data Visualization für die Diagrammregeln. Herkunft und bewusste Abweichungen stehen in docs/HERKUNFT.md. Dokumentation: README, HANDOVER (was echte Logik braucht), docs/DESIGN-SYSTEM, KPI-KATALOG, DATENMODELL, NAVIGATION, HERKUNFT, ZIELSYSTEM (Einbauort in HiveGrid Cloud) und LEITPLANKEN (welche Cloud-Screens als Vorbild taugen). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
This commit is contained in:
commit
b8bf987d0e
250 files changed
+33153
No files matched your search
@@ -0,0 +1,131 @@
|
||||
"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} />;
|
||||
|
||||
// Bei vielen Punkten nur jede n-te Beschriftung zeigen, sonst überlappen sie.
|
||||
const intervall =
|
||||
daten.length > MAX_ACHSENLABELS ? Math.ceil(daten.length / MAX_ACHSENLABELS) - 1 : 0;
|
||||
|
||||
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} {...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>
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user