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,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>
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user