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
136 lines
5.2 KiB
TypeScript
136 lines
5.2 KiB
TypeScript
"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>
|
||
);
|
||
}
|