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,106 @@
|
||||
"use client";
|
||||
|
||||
import React from "react";
|
||||
import { Bar, BarChart, CartesianGrid, Cell, ResponsiveContainer, Tooltip, XAxis, YAxis } from "recharts";
|
||||
import { ChartTooltip } from "./ChartTooltip";
|
||||
import { ChartLeer } from "./ChartLeer";
|
||||
import {
|
||||
BALKEN,
|
||||
CHART,
|
||||
MARGIN,
|
||||
MAX_ACHSENLABELS,
|
||||
PRIMAER_FARBE,
|
||||
achseX,
|
||||
achseY,
|
||||
nettesRaster,
|
||||
} from "../../utils/chartTheme";
|
||||
|
||||
/**
|
||||
* Vertikale Balken für Mengen über Zeit oder Kategorien mit Nulllinie.
|
||||
* Balkenbreite ist gedeckelt (Carbon: Abstand ≥ halbe Balkenbreite),
|
||||
* damit vier Balken nicht wie Flächen wirken.
|
||||
*/
|
||||
export function BalkenVertikal({
|
||||
daten,
|
||||
formatWert,
|
||||
/** Kürzere Schreibweise für die Y-Achse; ohne Angabe wie formatWert. */
|
||||
formatAchse,
|
||||
hoehe = 240,
|
||||
farbe = PRIMAER_FARBE,
|
||||
/** Einzelne Balken einfärben, z. B. Alters-Buckets von grün nach rot. */
|
||||
farbenProBalken,
|
||||
/** Bei Stückzahlen: keine Zwischenwerte auf der Achse ("1, 1, 2, 2"). */
|
||||
nurGanzzahlen = false,
|
||||
labelPrefix,
|
||||
}: {
|
||||
daten: { name?: string; label?: string; value: number }[];
|
||||
formatWert: (wert: number) => string;
|
||||
formatAchse?: (wert: number) => string;
|
||||
hoehe?: number;
|
||||
farbe?: string;
|
||||
farbenProBalken?: string[];
|
||||
nurGanzzahlen?: boolean;
|
||||
labelPrefix?: string;
|
||||
}) {
|
||||
const [aktiv, setAktiv] = React.useState<number | null>(null);
|
||||
|
||||
const punkte = daten.map((d) => ({ label: d.label ?? d.name ?? "", value: d.value }));
|
||||
if (!punkte.length || !punkte.some((p) => p.value > 0)) return <ChartLeer hoehe={hoehe} />;
|
||||
|
||||
const intervall =
|
||||
punkte.length > MAX_ACHSENLABELS ? Math.ceil(punkte.length / MAX_ACHSENLABELS) - 1 : 0;
|
||||
|
||||
// Ganzzahlreihen brauchen ganzzahlige Ticks — sonst steht "1,5 Vorgänge".
|
||||
const maximum = Math.max(...punkte.map((p) => p.value));
|
||||
const raster = nurGanzzahlen
|
||||
? undefined
|
||||
: nettesRaster(maximum);
|
||||
|
||||
return (
|
||||
<div style={{ height: hoehe }}>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart
|
||||
data={punkte}
|
||||
margin={MARGIN.standard}
|
||||
barCategoryGap={BALKEN.kategorieAbstand}
|
||||
onMouseMove={(zustand) =>
|
||||
setAktiv(typeof zustand?.activeTooltipIndex === "number" ? zustand.activeTooltipIndex : null)
|
||||
}
|
||||
onMouseLeave={() => setAktiv(null)}
|
||||
>
|
||||
<CartesianGrid stroke={CHART.grid} vertical={false} />
|
||||
<XAxis dataKey="label" interval={intervall} {...achseX} />
|
||||
<YAxis
|
||||
tickFormatter={formatAchse ?? formatWert}
|
||||
allowDecimals={!nurGanzzahlen}
|
||||
{...(raster ? { domain: raster.domain, ticks: raster.ticks } : {})}
|
||||
{...achseY}
|
||||
/>
|
||||
<Tooltip
|
||||
cursor={{ fill: "rgba(22,22,22,0.04)" }}
|
||||
content={(props) => (
|
||||
<ChartTooltip {...props} formatWert={formatWert} labelPrefix={labelPrefix} />
|
||||
)}
|
||||
/>
|
||||
<Bar
|
||||
dataKey="value"
|
||||
name="Wert"
|
||||
fill={farbe}
|
||||
maxBarSize={BALKEN.maxBreite}
|
||||
radius={[BALKEN.radius, BALKEN.radius, 0, 0]}
|
||||
>
|
||||
{punkte.map((_, index) => (
|
||||
<Cell
|
||||
key={index}
|
||||
fill={
|
||||
farbenProBalken ? farbenProBalken[index % farbenProBalken.length] : farbe
|
||||
}
|
||||
opacity={aktiv !== null && aktiv !== index ? 0.45 : 1}
|
||||
/>
|
||||
))}
|
||||
</Bar>
|
||||
</BarChart>
|
||||
</ResponsiveContainer>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user