Files
Dashboard/features/dashboard/components/charts/AuslastungsBalken.tsx
T
dejanandClaude Opus 5 351a26efa4 fix(layout): kollidierenden und überlaufenden Text beseitigen
Gemeldeter Fehler: In der Ringlegende klebten Bezeichnung und Wert aneinander
("Gestellt189,1 T€"). Ursache war eine eigene Regression — beim Beheben der
abgeschnittenen Legendennamen war das truncate entfallen, ohne Ersatz. Damit
schrumpft die Namensspalte durch min-w-0 + grow auf null Breite, und der Text
läuft sichtbar über seinen Kasten hinaus:

  1280 px  Kastenbreite 0 px, Text 43 px darüber hinaus
  1440 px  Kastenbreite 25 px, Text 18 px darüber hinaus
  1600 px  unauffällig

Genau deshalb war es auf den Screenshots nicht zu sehen: Der Fehler tritt nur in
bestimmten Fensterbreiten auf.

Neu: scripts/verify-layout.mjs + npm run verify:layout. Lädt alle sechs Seiten in
sieben Breiten (1024–1920) und misst jede Textzeile über Range.getClientRects.
Gemessen wird auf Textzeilen, nicht auf Elementkästen — sonst melden benachbarte
Tabellenzellen mit Innenabstand falsch positiv. Mindestabstand 8 px = Carbon
$spacing-03. Der Lauf fand 110 Fehler; alle behoben:

- Ringlegende: Container-Query statt fester Zweispaltigkeit. Legende sitzt rechts
  vom Ring, wenn Platz ist, sonst darunter — Carbon: "positioned to the right of
  the chart when space is plentiful". Namen brechen um statt überzulaufen.
- Auslastungs-Achse: Beschriftungsdichte staffelt sich über drei Container-Stufen,
  vorher überlappten die Zahlen in schmalen Karten um bis zu 16 px.
- Handlungsbedarf und Kennzahl-Labels: break-words statt Überlauf.
- Kartentitel und -untertitel: break-words, weil Dateipfade keine Leerzeichen
  zum Umbrechen haben.

Dokumentiert als DESIGN-SYSTEM.md §9 mit Begründung, warum das ein gemessener
Prüfer sein muss und keine Sichtprüfung.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
2026-08-29 19:32:55 +02:00

150 lines
5.9 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"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="@container 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">
{/* Beschriftungsdichte staffelt sich mit der Containerbreite: ganz
schmal nur die Enden, dann die 100-%-Marke, dann jede zweite, dann
alle. Container-Query, weil dieselbe Karte mal ein Drittel und mal
die volle Seitenbreite einnimmt — der Viewport weiß davon nichts. */}
{ticks.map((t, index) => {
const stufe =
t === min || t === max
? ""
: t === 100
? "hidden @sm:inline"
: index % 2 === 1
? "hidden @lg:inline"
: "hidden @md:inline";
return (
<span
key={t}
className={`absolute top-0 -translate-x-1/2 text-[11px] tabular-nums text-text-neutral-tertiary ${stufe}`}
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>
);
}