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:
dejanandClaude Opus 5 committed 2026-08-29 17:25:20 +02:00
commit b8bf987d0e
250 files changed
+33153

No files matched your search

@@ -0,0 +1,135 @@
"use client";
import React from "react";
import { CHART, STATUS_FARBEN } from "../../utils/chartTheme";
import { ChartLeer } from "./ChartLeer";
/**
* Auslastung je Person als Punktdiagramm mit Zielkorridor.
*
* Warum kein Balken: Auslastungswerte liegen im Betrieb zwischen etwa 70 und
* 100 %. Ein Balken muss bei 0 beginnen (sonst verzerrt die Länge), und dann
* sind 74 % und 96 % optisch fast gleich lang — das Diagramm zeigt nichts.
* Ein Punkt kodiert über die Position, nicht über die Länge, und darf deshalb
* einen ausgeschnittenen Bereich zeigen. Carbon nennt das Dot-Plot.
*
* Die Schwellen sind betrieblich gedacht, nicht mathematisch:
* < 70 % Luft frei — Kapazität ungenutzt
* 70–95 % Zielkorridor
* > 95 % ausgebucht — Überlastrisiko, Termine gefährdet
* Der Korridor liegt als graues Band hinter den Punkten, die 100-%-Marke als
* beschriftete Linie. Damit erklärt sich die Grafik ohne Ampel-Legende.
*/
const SCHWELLEN = { frei: 70, ausgebucht: 95 };
export function AuslastungsBalken({
zeilen,
maxZeilen = 8,
}: {
zeilen: { name: string; wert: number; zusatz?: string }[];
maxZeilen?: number;
}) {
const [aktiv, setAktiv] = React.useState<string | null>(null);
const sichtbar = zeilen.slice(0, maxZeilen);
if (!sichtbar.length) return <ChartLeer hoehe={200} />;
// Skala umschließt die Daten, bleibt aber mindestens 60–110 %, damit der
// Zielkorridor immer als Fläche erkennbar ist.
const min = Math.min(60, Math.floor(Math.min(...sichtbar.map((z) => z.wert)) / 10) * 10);
const max = Math.max(110, Math.ceil(Math.max(...sichtbar.map((z) => z.wert)) / 10) * 10);
const pos = (wert: number) => ((Math.min(Math.max(wert, min), max) - min) / (max - min)) * 100;
const ticks = [];
for (let t = min; t <= max; t += 10) ticks.push(t);
return (
<div className="flex flex-col gap-2">
{sichtbar.map((zeile) => {
const farbe =
zeile.wert < SCHWELLEN.frei
? STATUS_FARBEN.info
: zeile.wert <= SCHWELLEN.ausgebucht
? STATUS_FARBEN.positiv
: STATUS_FARBEN.warnung;
const hervorgehoben = aktiv === zeile.name;
return (
<div
key={zeile.name}
onMouseEnter={() => setAktiv(zeile.name)}
onMouseLeave={() => setAktiv(null)}
className="grid grid-cols-[minmax(96px,24%)_minmax(0,1fr)_48px] items-center gap-3"
>
<span className="flex min-w-0 flex-col">
<span className="truncate text-[12px] text-text-neutral-secondary">{zeile.name}</span>
{zeile.zusatz ? (
<span className="truncate text-[11px] text-text-neutral-tertiary">
{zeile.zusatz}
</span>
) : null}
</span>
<span className="relative block h-5 w-full">
{/* Zielkorridor als ruhiges Band hinter allen Zeilen */}
<span
className="absolute top-1/2 h-4 -translate-y-1/2 rounded-sm bg-neutral-100"
style={{
left: `${pos(SCHWELLEN.frei)}%`,
width: `${pos(SCHWELLEN.ausgebucht) - pos(SCHWELLEN.frei)}%`,
}}
aria-hidden="true"
/>
{/* Grundlinie */}
<span
className="absolute top-1/2 h-px w-full -translate-y-1/2"
style={{ background: CHART.grid }}
aria-hidden="true"
/>
{/* 100-%-Marke */}
<span
className="absolute top-0 h-full w-px"
style={{ left: `${pos(100)}%`, background: CHART.achse }}
aria-hidden="true"
/>
<span
className="absolute top-1/2 block h-2.5 w-2.5 -translate-x-1/2 -translate-y-1/2 rounded-full ring-2 ring-white transition-opacity duration-200"
style={{
left: `${pos(zeile.wert)}%`,
background: farbe,
opacity: aktiv && !hervorgehoben ? 0.45 : 1,
}}
title={`${zeile.name}: ${zeile.wert.toFixed(0)} %`}
/>
</span>
<span className="text-right text-[12px] font-semibold tabular-nums text-text-neutral-primary">
{zeile.wert.toFixed(0)} %
</span>
</div>
);
})}
{/* Achse statt Farblegende — die Zonen erklären sich über das Band. */}
<div className="grid grid-cols-[minmax(96px,24%)_minmax(0,1fr)_48px] items-center gap-3 pt-1">
<span />
<span className="relative block h-4">
{ticks.map((t) => (
<span
key={t}
className="absolute top-0 -translate-x-1/2 text-[11px] tabular-nums text-text-neutral-tertiary"
style={{ left: `${pos(t)}%` }}
>
{t}
</span>
))}
</span>
<span className="text-right text-[11px] text-text-neutral-tertiary">%</span>
</div>
<p className="border-t border-solid border-border-default pt-2 text-[11px] text-text-neutral-tertiary">
Graues Band = Zielkorridor {SCHWELLEN.frei}–{SCHWELLEN.ausgebucht} %, Linie = 100 % der
vertraglichen Stunden.
</p>
</div>
);
}