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,285 @@
|
||||
/**
|
||||
* Zentrales Chart-Theme — abgeleitet aus IBM Carbon Data Visualization.
|
||||
*
|
||||
* Die Werte stammen aus dem ausgelieferten Stylesheet von @carbon/charts
|
||||
* (dist/styles.css, Light Theme):
|
||||
* Gridlines #e0e0e0 (--cds-layer-accent-01)
|
||||
* Achse #8d8d8d (--cds-border-strong-01)
|
||||
* Text primär #161616 (--cds-text-primary)
|
||||
* Text sek. #525252 (--cds-text-secondary)
|
||||
* Tooltip #393939 (--cds-background-inverse) auf #ffffff Text
|
||||
*
|
||||
* Warum kein bunter "Marketing"-Farbsatz: Die Carbon-Palette ist auf
|
||||
* Unterscheidbarkeit und Kontrast optimiert und in dieser Reihenfolge
|
||||
* getestet. Reihenfolge deshalb nie umsortieren, nur von vorne nehmen.
|
||||
*
|
||||
* Siehe docs/DESIGN-SYSTEM.md.
|
||||
*/
|
||||
|
||||
/** Carbon "14-color" categorical palette, Light Theme, in Originalreihenfolge. */
|
||||
export const KATEGORIE_FARBEN = [
|
||||
"#6929c4", // purple 70
|
||||
"#1192e8", // cyan 50
|
||||
"#005d5d", // teal 70
|
||||
"#9f1853", // magenta 70
|
||||
"#fa4d56", // red 50
|
||||
"#520408", // red 100
|
||||
"#198038", // green 60
|
||||
"#002d9c", // blue 80
|
||||
"#ee5396", // magenta 50
|
||||
"#b28600", // yellow 50
|
||||
"#009d9a", // teal 50
|
||||
"#012749", // cyan 90
|
||||
"#8a3800", // orange 70
|
||||
"#a56eff", // purple 50
|
||||
] as const;
|
||||
|
||||
/**
|
||||
* Carbon empfiehlt maximal 5 gleichzeitig unterscheidbare Kategorien.
|
||||
* Alles darüber wird in "Sonstige" zusammengefasst (siehe gruppiereRest()).
|
||||
*/
|
||||
export const MAX_KATEGORIEN = 5;
|
||||
|
||||
/** Ampelfarben für Status-Aussagen (nicht für Kategorien verwenden). */
|
||||
export const STATUS_FARBEN = {
|
||||
positiv: "#198038",
|
||||
warnung: "#b28600",
|
||||
negativ: "#da1e28",
|
||||
neutral: "#8d8d8d",
|
||||
info: "#1192e8",
|
||||
} as const;
|
||||
|
||||
/**
|
||||
* Feste Farbe je Gewerk.
|
||||
*
|
||||
* Eine Kategorie behält ihre Farbe über alle Charts und Seiten hinweg —
|
||||
* sonst ist Heizung im Ring lila und im Balkendiagramm blau, und man muss
|
||||
* jede Legende neu lesen. Die Werte stammen aus der Carbon-Palette.
|
||||
*/
|
||||
export const GEWERK_FARBEN: Record<string, string> = {
|
||||
Heizung: "#6929c4",
|
||||
Sanitär: "#1192e8",
|
||||
"Klima & Lüftung": "#005d5d",
|
||||
Photovoltaik: "#9f1853",
|
||||
Elektro: "#198038",
|
||||
};
|
||||
|
||||
/**
|
||||
* Feste Farben für Statuswerte.
|
||||
*
|
||||
* Hier trägt die Farbe Bedeutung: „Verloren" und „Überfällig" sind rot,
|
||||
* „Bezahlt" und „In Arbeit" grün, Neutrales grau. Eine zufällige
|
||||
* Palettenfarbe für „Verloren" würde die Aussage der Grafik verwässern.
|
||||
*/
|
||||
export const STATUS_KATEGORIE_FARBEN: Record<string, string> = {
|
||||
// Auftragsstatus
|
||||
Anfrage: "#a56eff",
|
||||
"Vor-Aufmaß": "#1192e8",
|
||||
Angebot: "#6929c4",
|
||||
Beauftragt: "#009d9a",
|
||||
"In Arbeit": "#198038",
|
||||
Abgeschlossen: "#005d5d",
|
||||
Verloren: "#fa4d56",
|
||||
// Rechnungsstatus
|
||||
Bezahlt: "#198038",
|
||||
Gestellt: "#1192e8",
|
||||
Überfällig: "#da1e28",
|
||||
Entwurf: "#8d8d8d",
|
||||
// Förderung
|
||||
Bewilligt: "#198038",
|
||||
Beantragt: "#b28600",
|
||||
"Nicht beantragt": "#8d8d8d",
|
||||
// Abwesenheit
|
||||
Urlaub: "#1192e8",
|
||||
Krank: "#fa4d56",
|
||||
Fortbildung: "#6929c4",
|
||||
// Sammelposten
|
||||
Sonstige: "#8d8d8d",
|
||||
};
|
||||
|
||||
/**
|
||||
* Textfarben für Statusaussagen in Tabellen und Listen.
|
||||
*
|
||||
* Nicht dieselben Werte wie STATUS_FARBEN: Flächen dürfen heller sein, Text
|
||||
* braucht auf Weiß mehr Kontrast (WCAG AA, 4,5:1 bei 12–13 px). Deshalb je
|
||||
* eine Stufe dunkler aus derselben Carbon-Familie.
|
||||
*/
|
||||
export const STATUS_TEXT = {
|
||||
negativ: "#a2191f", // red 70
|
||||
warnung: "#8a3800", // orange 70
|
||||
positiv: "#0e6027", // green 70
|
||||
} as const;
|
||||
|
||||
/**
|
||||
* Vierstufige Risikorampe für geordnete Dimensionen (Forderungsalter).
|
||||
*
|
||||
* Durchgehend Statusfarben aus der Carbon-Skala, keine Palettenfarbe
|
||||
* dazwischen: Altersklassen sind eine Reihenfolge mit wachsendem Risiko,
|
||||
* keine unabhängigen Kategorien.
|
||||
*/
|
||||
export const RISIKO_RAMPE = [
|
||||
"#198038", // green 60 — im Zahlungsziel
|
||||
"#b28600", // yellow 50 — beobachten
|
||||
"#ba4e00", // orange 60 — mahnen
|
||||
"#da1e28", // red 60 — Abschreibungsrisiko
|
||||
] as const;
|
||||
|
||||
/**
|
||||
* Badge-Töne: helle Fläche mit dunklem Text derselben Carbon-Familie.
|
||||
* Alle Paare erreichen auf ihrer Fläche mindestens 7:1 — Badges sind klein
|
||||
* (11 px) und brauchen mehr Reserve als Fließtext.
|
||||
*/
|
||||
export const BADGE_TON = {
|
||||
neutral: "bg-neutral-100 text-neutral-700",
|
||||
information: "bg-[#e5f6ff] text-[#00539a]",
|
||||
lila: "bg-[#e8daff] text-[#491d8b]",
|
||||
teal: "bg-[#d9fbfb] text-[#005d5d]",
|
||||
positiv: "bg-[#defbe6] text-[#0e6027]",
|
||||
negativ: "bg-[#fff1f1] text-[#a2191f]",
|
||||
} as const;
|
||||
|
||||
/** Einzelserie (Umsatzverlauf o. Ä.) — Carbon Cyan 50. */
|
||||
export const PRIMAER_FARBE = "#1192e8";
|
||||
/** Vergleichsserie (Vorjahr) — bewusst neutral, damit sie zurücktritt. */
|
||||
export const VERGLEICH_FARBE = "#8d8d8d";
|
||||
|
||||
export const CHART = {
|
||||
grid: "#e0e0e0",
|
||||
achse: "#8d8d8d",
|
||||
text: "#161616",
|
||||
textSekundaer: "#525252",
|
||||
tooltipBg: "#393939",
|
||||
tooltipFg: "#ffffff",
|
||||
} as const;
|
||||
|
||||
/**
|
||||
* Chart-Innenabstände.
|
||||
* Carbon rechnet Achsenbeschriftungen in den Chart-Rahmen ein; die Karte selbst
|
||||
* liefert bereits 16 px Padding, deshalb hier nur der Platz für Achsen.
|
||||
*/
|
||||
export const MARGIN = {
|
||||
/** Vertikale Balken / Flächen mit Y-Achse links.
|
||||
* Rechts genug Platz, damit die letzte Achsenbeschriftung nicht abschneidet. */
|
||||
standard: { top: 8, right: 24, bottom: 4, left: 4 },
|
||||
/** Horizontale Balken: links Platz für Kategorienamen. */
|
||||
horizontal: { top: 4, right: 56, bottom: 4, left: 4 },
|
||||
/** Sparkline / Mini-Chart ohne Achsen. */
|
||||
kompakt: { top: 2, right: 2, bottom: 2, left: 2 },
|
||||
} as const;
|
||||
|
||||
/** Typografie im Chart (Carbon: 12 px Labels, 14 px Titel). */
|
||||
export const CHART_FONT = {
|
||||
achse: 12,
|
||||
label: 12,
|
||||
legende: 12,
|
||||
titel: 14,
|
||||
} as const;
|
||||
|
||||
/** Gemeinsame Achsen-Props für Recharts (Carbon-Look: keine Ticks, dünne Achse). */
|
||||
export const achseX = {
|
||||
tickLine: false,
|
||||
axisLine: { stroke: CHART.achse, strokeWidth: 1 },
|
||||
tick: { fill: CHART.textSekundaer, fontSize: CHART_FONT.achse },
|
||||
dy: 4,
|
||||
} as const;
|
||||
|
||||
export const achseY = {
|
||||
tickLine: false,
|
||||
axisLine: false,
|
||||
tick: { fill: CHART.textSekundaer, fontSize: CHART_FONT.achse },
|
||||
// 58 px laut docs/DESIGN-SYSTEM.md §2 — reicht für "245 T€".
|
||||
// Werte im Mio.-Bereich bekommen über achsenFormat() eine kurze Einheit.
|
||||
width: 58,
|
||||
} as const;
|
||||
|
||||
/** Balkenbreiten nach Carbon: Abstand zwischen Balken ≥ halbe Balkenbreite. */
|
||||
export const BALKEN = {
|
||||
maxBreite: 48,
|
||||
/** Recharts-Kategorieabstand in Prozent der Kategoriebreite. */
|
||||
kategorieAbstand: "28%",
|
||||
radius: 2,
|
||||
hoeheHorizontal: 20,
|
||||
} as const;
|
||||
|
||||
/** Donut-Proportionen (Carbon: kräftiger Ring, Gesamtwert in der Mitte). */
|
||||
export const DONUT = {
|
||||
innenRadius: "62%",
|
||||
aussenRadius: "88%",
|
||||
segmentAbstand: 2,
|
||||
} as const;
|
||||
|
||||
/**
|
||||
* Reduziert eine Kategorienliste auf MAX_KATEGORIEN und fasst den Rest
|
||||
* zu "Sonstige" zusammen — verhindert unlesbare Donuts mit 12 Segmenten.
|
||||
*/
|
||||
export function gruppiereRest<T extends { name: string; value: number }>(
|
||||
daten: T[],
|
||||
max: number = MAX_KATEGORIEN
|
||||
): { name: string; value: number }[] {
|
||||
const sortiert = [...daten].sort((a, b) => b.value - a.value);
|
||||
if (sortiert.length <= max) return sortiert.map((d) => ({ name: d.name, value: d.value }));
|
||||
|
||||
const kopf = sortiert.slice(0, max - 1).map((d) => ({ name: d.name, value: d.value }));
|
||||
const rest = sortiert.slice(max - 1).reduce((summe, d) => summe + d.value, 0);
|
||||
// "Sonstige" wird einsortiert, nicht angehaengt: der Ring laeuft sonst nicht
|
||||
// mehr absteigend, obwohl DESIGN-SYSTEM.md §4 genau das verlangt.
|
||||
return [...kopf, { name: "Sonstige", value: rest }].sort((a, b) => b.value - a.value);
|
||||
}
|
||||
|
||||
/**
|
||||
* Rundes Achsenraster.
|
||||
*
|
||||
* Recharts leitet Ticks aus max/(n-1) ab und rundet den Rohschritt auf — bei
|
||||
* 219 T€ ergibt das 0/55/110/165/220. Krumme Achsenwerte kosten den Leser
|
||||
* bei jedem Blick eine Rechenoperation. Deshalb Schrittweiten aus der
|
||||
* 1-2-2,5-5-Reihe erzwingen.
|
||||
*/
|
||||
export function nettesRaster(
|
||||
max: number,
|
||||
maxIntervalle = 5
|
||||
): { domain: [number, number]; ticks: number[] } {
|
||||
if (!Number.isFinite(max) || max <= 0) return { domain: [0, 1], ticks: [0, 1] };
|
||||
const groessenordnung = 10 ** Math.floor(Math.log10(max));
|
||||
const kandidaten = [1, 2, 2.5, 5, 10]
|
||||
.flatMap((k) => [(k * groessenordnung) / 10, k * groessenordnung, k * groessenordnung * 10])
|
||||
.sort((a, b) => a - b);
|
||||
for (const schritt of kandidaten) {
|
||||
const anzahl = Math.ceil(max / schritt);
|
||||
if (anzahl <= maxIntervalle) {
|
||||
return {
|
||||
domain: [0, schritt * anzahl],
|
||||
ticks: Array.from({ length: anzahl + 1 }, (_, i) => i * schritt),
|
||||
};
|
||||
}
|
||||
}
|
||||
return { domain: [0, max], ticks: [0, max] };
|
||||
}
|
||||
|
||||
/**
|
||||
* Ab wie vielen Datenpunkten nur noch jede n-te Beschriftung gezeigt wird.
|
||||
* Eine Konstante, damit Flaeche und Balken nicht unterschiedlich ausduennen.
|
||||
*/
|
||||
export const MAX_ACHSENLABELS = 12;
|
||||
|
||||
/** Farbe nach Index, rotiert sicher innerhalb der Palette. */
|
||||
export function farbe(index: number): string {
|
||||
return KATEGORIE_FARBEN[index % KATEGORIE_FARBEN.length];
|
||||
}
|
||||
|
||||
/**
|
||||
* Farbe für einen Kategorienamen: feste Zuordnung wenn vorhanden,
|
||||
* sonst Position in der Palette.
|
||||
*/
|
||||
export function farbeFuer(name: string, index: number): string {
|
||||
return GEWERK_FARBEN[name] ?? STATUS_KATEGORIE_FARBEN[name] ?? farbe(index);
|
||||
}
|
||||
|
||||
/** Abgestufte Einfärbung für Trichterstufen — eine Farbe, abnehmende Sättigung. */
|
||||
export function trichterFarbe(index: number, gesamt: number): string {
|
||||
const anteil = gesamt > 1 ? index / (gesamt - 1) : 0;
|
||||
// Von Carbon Purple 70 nach Purple 40: gleiche Farbfamilie, klare Reihenfolge.
|
||||
const start = { r: 0x69, g: 0x29, b: 0xc4 };
|
||||
const ende = { r: 0xbe, g: 0x95, b: 0xff };
|
||||
const misch = (a: number, b: number) => Math.round(a + (b - a) * anteil);
|
||||
return `rgb(${misch(start.r, ende.r)} ${misch(start.g, ende.g)} ${misch(start.b, ende.b)})`;
|
||||
}
|
||||
@@ -0,0 +1,132 @@
|
||||
import type { ZeitraumPreset } from "../data/types";
|
||||
|
||||
/**
|
||||
* Fester "Heute"-Bezugspunkt des Prototyps.
|
||||
*
|
||||
* Wichtig: Die Dummy-Daten sind deterministisch relativ zu diesem Datum erzeugt.
|
||||
* Dadurch bleiben alle Zahlen ueber Reloads und Screenshots hinweg identisch.
|
||||
* In der echten Software wird das durch `new Date()` ersetzt.
|
||||
*/
|
||||
export const HEUTE = new Date("2026-07-30T12:00:00");
|
||||
|
||||
export interface Zeitfenster {
|
||||
von: Date;
|
||||
bis: Date;
|
||||
}
|
||||
|
||||
export function addTage(datum: Date, tage: number): Date {
|
||||
const d = new Date(datum);
|
||||
d.setDate(d.getDate() + tage);
|
||||
return d;
|
||||
}
|
||||
|
||||
export function addMonate(datum: Date, monate: number): Date {
|
||||
const d = new Date(datum);
|
||||
d.setMonth(d.getMonth() + monate);
|
||||
return d;
|
||||
}
|
||||
|
||||
export function toISO(datum: Date): string {
|
||||
return datum.toISOString().slice(0, 10);
|
||||
}
|
||||
|
||||
/** Zeitfenster eines Presets, bezogen auf HEUTE. */
|
||||
export function zeitfenster(preset: ZeitraumPreset): Zeitfenster {
|
||||
const bis = new Date(HEUTE);
|
||||
bis.setHours(23, 59, 59, 999);
|
||||
|
||||
switch (preset) {
|
||||
case "heute": {
|
||||
const von = new Date(HEUTE);
|
||||
von.setHours(0, 0, 0, 0);
|
||||
return { von, bis };
|
||||
}
|
||||
case "7_tage":
|
||||
return { von: addTage(bis, -7), bis };
|
||||
case "30_tage":
|
||||
return { von: addTage(bis, -30), bis };
|
||||
case "quartal":
|
||||
return { von: addMonate(bis, -3), bis };
|
||||
case "jahr":
|
||||
return { von: addMonate(bis, -12), bis };
|
||||
case "alles":
|
||||
default:
|
||||
return { von: new Date("2000-01-01"), bis };
|
||||
}
|
||||
}
|
||||
|
||||
/** Gleich langes Fenster direkt davor — Basis fuer Trend-Vergleiche. */
|
||||
export function vorperiode(preset: ZeitraumPreset): Zeitfenster {
|
||||
const { von, bis } = zeitfenster(preset);
|
||||
const dauer = bis.getTime() - von.getTime();
|
||||
return {
|
||||
von: new Date(von.getTime() - dauer),
|
||||
bis: new Date(von.getTime() - 1),
|
||||
};
|
||||
}
|
||||
|
||||
export function imFenster(iso: string | null, fenster: Zeitfenster): boolean {
|
||||
if (!iso) return false;
|
||||
const t = new Date(iso).getTime();
|
||||
return t >= fenster.von.getTime() && t <= fenster.bis.getTime();
|
||||
}
|
||||
|
||||
/** ISO-Kalenderwoche als sortierbarer Schluessel: "2026-W31". */
|
||||
export function isoWoche(datum: Date): string {
|
||||
const d = new Date(Date.UTC(datum.getFullYear(), datum.getMonth(), datum.getDate()));
|
||||
// Donnerstag derselben Woche bestimmt nach ISO 8601 Jahr und Wochennummer.
|
||||
d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
|
||||
const jahresstart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
|
||||
const woche = Math.ceil(((d.getTime() - jahresstart.getTime()) / 86_400_000 + 1) / 7);
|
||||
return `${d.getUTCFullYear()}-W${String(woche).padStart(2, "0")}`;
|
||||
}
|
||||
|
||||
/** "2026-W31" -> "KW 31" */
|
||||
export function formatWoche(schluessel: string): string {
|
||||
return `KW ${schluessel.slice(6)}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Passende Buckets fuer eine Zeitreihe.
|
||||
*
|
||||
* Die Aufloesung folgt der Frage, nicht dem Kalender: Bei rund zwei Vorgaengen
|
||||
* pro Tag ist eine Tagesreihe ueber 30 Tage Rauschen, kein Verlauf. Deshalb
|
||||
* Tage nur bis eine Woche, danach Kalenderwochen, ab einem Jahr Monate.
|
||||
*/
|
||||
export function bucketsFuer(preset: ZeitraumPreset): {
|
||||
art: "tag" | "woche" | "monat";
|
||||
schluessel: string[];
|
||||
} {
|
||||
const { von, bis } = zeitfenster(preset);
|
||||
|
||||
if (preset === "heute" || preset === "7_tage") {
|
||||
const schluessel: string[] = [];
|
||||
for (let d = new Date(von); d <= bis; d = addTage(d, 1)) schluessel.push(toISO(d));
|
||||
return { art: "tag", schluessel };
|
||||
}
|
||||
|
||||
if (preset === "30_tage" || preset === "quartal") {
|
||||
const schluessel: string[] = [];
|
||||
for (let d = new Date(von); d <= bis; d = addTage(d, 7)) {
|
||||
const key = isoWoche(d);
|
||||
if (!schluessel.includes(key)) schluessel.push(key);
|
||||
}
|
||||
const letzte = isoWoche(bis);
|
||||
if (!schluessel.includes(letzte)) schluessel.push(letzte);
|
||||
return { art: "woche", schluessel };
|
||||
}
|
||||
|
||||
const monate: string[] = [];
|
||||
const start = preset === "alles" ? addMonate(bis, -23) : von;
|
||||
for (let d = new Date(start.getFullYear(), start.getMonth(), 1); d <= bis; d = addMonate(d, 1)) {
|
||||
monate.push(`${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}`);
|
||||
}
|
||||
return { art: "monat", schluessel: monate };
|
||||
}
|
||||
|
||||
/** Bucket-Schluessel eines Datums fuer die gewaehlte Aufloesung. */
|
||||
export function bucketKey(iso: string, art: "tag" | "woche" | "monat"): string {
|
||||
if (art === "monat") return iso.slice(0, 7);
|
||||
if (art === "woche") return isoWoche(new Date(iso));
|
||||
return iso.slice(0, 10);
|
||||
}
|
||||
@@ -0,0 +1,158 @@
|
||||
/**
|
||||
* Deutsche Zahlen-, Waehrungs- und Datumsformatierung.
|
||||
* Regeln aus UI_UX_GUIDELINES.md (Abschnitt 3, Zahlenformatierung):
|
||||
* Punkt als Tausender-Trenner, Komma als Dezimaltrenner, grosse Zahlen abkuerzen.
|
||||
*/
|
||||
|
||||
const NF = new Intl.NumberFormat("de-DE");
|
||||
|
||||
/** 12450 -> "12.450" · 1250000 -> "1,3 Mio." */
|
||||
export function formatZahl(value: number, dezimalstellen = 0): string {
|
||||
if (Math.abs(value) >= 1_000_000) {
|
||||
return `${(value / 1_000_000).toFixed(1).replace(".", ",")} Mio.`;
|
||||
}
|
||||
return new Intl.NumberFormat("de-DE", {
|
||||
minimumFractionDigits: dezimalstellen,
|
||||
maximumFractionDigits: dezimalstellen,
|
||||
}).format(value);
|
||||
}
|
||||
|
||||
/** 8420 -> "8.420 €" · 245000 -> "245.000 €" (immer voll, fuer KPI-Werte) */
|
||||
export function formatEuro(value: number): string {
|
||||
return `${NF.format(Math.round(value))} €`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Kompakte Waehrung fuer Achsen und Balken-Labels.
|
||||
* 8420 -> "8,4 T€" · 245000 -> "245 T€" · 1250000 -> "1,25 Mio. €"
|
||||
*/
|
||||
export function formatEuroKompakt(value: number): string {
|
||||
const abs = Math.abs(value);
|
||||
if (abs >= 1_000_000) {
|
||||
return `${(value / 1_000_000).toFixed(2).replace(".", ",")} Mio. €`;
|
||||
}
|
||||
if (abs >= 1_000) {
|
||||
return `${(value / 1_000).toFixed(1).replace(".", ",")} T€`;
|
||||
}
|
||||
return `${NF.format(Math.round(value))} €`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Noch kompakter für Achsenbeschriftungen: dort zählt jede Stelle,
|
||||
* und Nachkommastellen sind bei einer Skala ohnehin überflüssig.
|
||||
* 34000 -> "34 T€" · 1250000 -> "1,3 Mio. €"
|
||||
*/
|
||||
export function formatEuroAchse(value: number): string {
|
||||
// Die Nulllinie traegt keine Einheit: "0 €" neben "10 T€" liest sich wie ein
|
||||
// Einheitenwechsel mitten in der Skala.
|
||||
if (value === 0) return "0";
|
||||
const abs = Math.abs(value);
|
||||
if (abs >= 1_000_000) return `${(value / 1_000_000).toFixed(1).replace(".", ",")} Mio. €`;
|
||||
if (abs >= 1_000) return `${Math.round(value / 1_000)} T€`;
|
||||
return `${NF.format(Math.round(value))} €`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Achsenformat, einmal aus dem Maximum gewaehlt.
|
||||
*
|
||||
* formatEuroAchse entscheidet die Einheit pro Wert — dadurch steht "0 €"
|
||||
* neben "10 T€". Eine Achse traegt aber genau eine Einheit.
|
||||
*/
|
||||
export function achsenFormat(max: number): (wert: number) => string {
|
||||
if (max >= 1_000_000) {
|
||||
return (wert) =>
|
||||
wert === 0 ? "0" : `${(wert / 1_000_000).toFixed(1).replace(".", ",")} Mio. €`;
|
||||
}
|
||||
if (max >= 1_000) {
|
||||
return (wert) => (wert === 0 ? "0" : `${NF.format(Math.round(wert / 1_000))} T€`);
|
||||
}
|
||||
return (wert) => (wert === 0 ? "0" : formatEuro(wert));
|
||||
}
|
||||
|
||||
/** 45.32 -> "45,3 %" */
|
||||
export function formatProzent(value: number, dezimalstellen = 1): string {
|
||||
return `${value.toFixed(dezimalstellen).replace(".", ",")} %`;
|
||||
}
|
||||
|
||||
const NF1 = new Intl.NumberFormat("de-DE", {
|
||||
minimumFractionDigits: 1,
|
||||
maximumFractionDigits: 1,
|
||||
});
|
||||
|
||||
/** 2.4 -> "2,4 Tage" · 1234.5 -> "1.234,5 Tage" */
|
||||
export function formatTage(value: number): string {
|
||||
return `${NF1.format(value)} Tage`;
|
||||
}
|
||||
|
||||
/** 2812.5 -> "2.812,5 h" */
|
||||
export function formatStunden(value: number): string {
|
||||
return `${NF1.format(value)} h`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Ganze Tage mit korrektem Numerus — "1 Tag", "3 Tage".
|
||||
* Ohne das steht in der Terminspalte "1 Tage ueber".
|
||||
*/
|
||||
export function tageLabel(anzahl: number, suffix = ""): string {
|
||||
const wort = Math.abs(anzahl) === 1 ? "Tag" : "Tage";
|
||||
return `${NF.format(anzahl)} ${wort}${suffix ? ` ${suffix}` : ""}`;
|
||||
}
|
||||
|
||||
/** Dativform fuer "seit …": "seit 1 Tag" / "seit 99 Tagen". */
|
||||
export function tageLabelDativ(anzahl: number): string {
|
||||
const wort = Math.abs(anzahl) === 1 ? "Tag" : "Tagen";
|
||||
return `${NF.format(anzahl)} ${wort}`;
|
||||
}
|
||||
|
||||
/** "2026-07-30" -> "30.07.2026" */
|
||||
export function formatDatum(iso: string): string {
|
||||
const d = new Date(iso);
|
||||
return d.toLocaleDateString("de-DE", {
|
||||
day: "2-digit",
|
||||
month: "2-digit",
|
||||
year: "numeric",
|
||||
});
|
||||
}
|
||||
|
||||
/** "2026-07-30" -> "30.07." */
|
||||
export function formatDatumKurz(iso: string): string {
|
||||
const d = new Date(iso);
|
||||
return d.toLocaleDateString("de-DE", { day: "2-digit", month: "2-digit" });
|
||||
}
|
||||
|
||||
/** "2026-07" -> "Jul 26" */
|
||||
export function formatMonatKurz(iso: string): string {
|
||||
const [jahr, monat] = iso.split("-");
|
||||
const namen = ["Jan", "Feb", "Mär", "Apr", "Mai", "Jun", "Jul", "Aug", "Sep", "Okt", "Nov", "Dez"];
|
||||
return `${namen[Number(monat) - 1]} ${jahr.slice(2)}`;
|
||||
}
|
||||
|
||||
/** Tage zwischen heute und einem ISO-Datum (positiv = in der Vergangenheit). */
|
||||
export function tageSeit(iso: string, referenz: Date): number {
|
||||
const diff = referenz.getTime() - new Date(iso).getTime();
|
||||
return Math.floor(diff / 86_400_000);
|
||||
}
|
||||
|
||||
/**
|
||||
* Trend zwischen aktueller und vorheriger Periode.
|
||||
* Gibt Prozentpunkte und Richtung zurueck; < 0,5 % gilt als unveraendert.
|
||||
*/
|
||||
export function berechneTrend(
|
||||
aktuell: number,
|
||||
vorher: number
|
||||
): { wert: number; richtung: "up" | "down" | "flat" } {
|
||||
if (vorher === 0) {
|
||||
return aktuell > 0 ? { wert: 100, richtung: "up" } : { wert: 0, richtung: "flat" };
|
||||
}
|
||||
const veraenderung = ((aktuell - vorher) / vorher) * 100;
|
||||
if (Math.abs(veraenderung) < 0.5) return { wert: 0, richtung: "flat" };
|
||||
return {
|
||||
wert: Math.abs(veraenderung),
|
||||
richtung: veraenderung > 0 ? "up" : "down",
|
||||
};
|
||||
}
|
||||
|
||||
/** Text auf maxLaenge kuerzen, Ellipse anhaengen. */
|
||||
export function kuerze(text: string, maxLaenge: number): string {
|
||||
return text.length <= maxLaenge ? text : `${text.slice(0, maxLaenge - 1)}…`;
|
||||
}
|
||||
Reference in new issue
Block a user