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

+278
View File
@@ -0,0 +1,278 @@
"use client";
import React from "react";
import { PageHeader } from "../components/layout/PageHeader";
import { PageContainer, Raster } from "../components/layout/PageContainer";
import { AnalyticsToolbar } from "../components/filters/AnalyticsToolbar";
import { KPICard } from "../components/cards/KPICard";
import { ChartCard } from "../components/cards/ChartCard";
import { StatZeile } from "../components/cards/StatZeile";
import { AreaVerlauf } from "../components/charts/AreaVerlauf";
import { BalkenVertikal } from "../components/charts/BalkenVertikal";
import { BalkenHorizontal } from "../components/charts/BalkenHorizontal";
import { Donut } from "../components/charts/Donut";
import { ChartLegende } from "../components/charts/ChartLegende";
import { DataTable, type Spalte } from "../components/tables/DataTable";
import { RechnungBadge } from "../components/tables/StatusBadge";
import { useAnalyseDaten } from "../hooks/useAnalyseDaten";
import {
marge,
offenePosten,
offeneNachStatus,
umsatz,
umsatzNachGewerk,
umsatzVerlauf,
umsatzVorperiode,
zahlungsdauer,
} from "../data/calculations";
import {
berechneTrend,
formatDatum,
formatEuro,
formatEuroAchse,
formatEuroKompakt,
formatProzent,
formatTage,
tageSeit,
tageLabel,
} from "../utils/formatters";
import { HEUTE } from "../utils/dateUtils";
import {
PRIMAER_FARBE,
RISIKO_RAMPE,
STATUS_TEXT,
VERGLEICH_FARBE,
} from "../utils/chartTheme";
import type { Rechnung } from "../data/types";
/** Ampelfarben für die Altersstruktur: je älter die Forderung, desto kritischer. */
const ALTER_FARBEN = [...RISIKO_RAMPE];
export function FinanzenSeite() {
const { daten, filter } = useAnalyseDaten("finanzen");
const umsatzAktuell = umsatz(daten.rechnungen, filter.zeitraum);
const umsatzVorher = umsatzVorperiode(daten.rechnungen, filter.zeitraum);
const verlauf = umsatzVerlauf(daten.rechnungen, filter.zeitraum);
const posten = offenePosten(daten.rechnungen);
const dauer = zahlungsdauer(daten.rechnungen, filter.zeitraum);
const margeProzent = marge(daten.auftraege, filter.zeitraum);
const kundeName = React.useMemo(
() => new Map(daten.kunden.map((k) => [k.id, k.name])),
[daten.kunden]
);
const spalten: Spalte<Rechnung>[] = [
{
key: "nummer",
titel: "Rechnung",
zelle: (r) => (
<div className="flex flex-col">
<span className="font-medium">{r.nummer}</span>
<span className="text-[11px] text-text-neutral-tertiary">
{kundeName.get(r.kundeId) ?? "Unbekannt"}
</span>
</div>
),
sortWert: (r) => r.nummer,
breite: "30%",
},
{ key: "status", titel: "Status", zelle: (r) => <RechnungBadge status={r.status} /> },
{
key: "gestellt",
titel: "Gestellt",
zelle: (r) => formatDatum(r.gestelltAm),
sortWert: (r) => r.gestelltAm,
},
{
key: "faellig",
titel: "Überfällig",
numerisch: true,
zelle: (r) => {
const tage = tageSeit(r.faelligAm, HEUTE);
return tage > 0 ? (
<span
className={tage > 30 ? "font-medium" : ""}
style={{ color: tage > 30 ? STATUS_TEXT.negativ : STATUS_TEXT.warnung }}
>
{tageLabel(tage)}
</span>
) : (
<span className="text-text-neutral-tertiary">
in {Math.abs(tage) === 1 ? "1 Tag" : `${Math.abs(tage)} Tagen`}
</span>
);
},
sortWert: (r) => tageSeit(r.faelligAm, HEUTE),
},
{
key: "betrag",
titel: "Betrag",
numerisch: true,
zelle: (r) => <span className="font-medium">{formatEuro(r.betrag)}</span>,
sortWert: (r) => r.betrag,
},
];
return (
<>
<PageHeader
titel="Finanzen"
beschreibung="Umsatz, Zahlungseingang und offene Forderungen — die Sicht der Buchhaltung auf den Betrieb."
/>
<AnalyticsToolbar seite="finanzen" />
<PageContainer>
<Raster spalten={5}>
<KPICard
label="Umsatz (bezahlt)"
wert={formatEuro(umsatzAktuell)}
zusatz="Zahlungseingang im Zeitraum"
trend={berechneTrend(umsatzAktuell, umsatzVorher)}
icon="Euro"
verlauf={verlauf.slice(-10).map((p) => p.value)}
/>
<KPICard
label="Offene Forderungen"
wert={formatEuro(posten.gesamt)}
zusatz={`${posten.anzahl} Rechnungen`}
icon="FileText"
bezug="stichtag"
/>
<KPICard
label="Überfällig"
wert={formatEuro(posten.ueberfaelligBetrag)}
zusatz={`${posten.ueberfaelligAnzahl} Rechnungen im Mahnlauf`}
icon="AlertTriangle"
bezug="stichtag"
akzent={posten.ueberfaelligBetrag > 0 ? "negativ" : "positiv"}
/>
<KPICard
label="Ø Zahlungsdauer"
wert={formatTage(dauer)}
zusatz="Rechnung bis Zahlungseingang"
icon="Clock"
akzent={dauer > 30 ? "warnung" : "positiv"}
richtungGut="negativ"
/>
<KPICard
label="Deckungsbeitrag"
wert={formatProzent(margeProzent)}
zusatz="Gewichtet über Abschlüsse"
icon="Percent"
/>
</Raster>
<div className="grid grid-cols-1 gap-4 xl:grid-cols-3">
<ChartCard
id="finanzen-verlauf"
titel="Zahlungseingang im Zeitverlauf"
untertitel="Aktueller Zeitraum gegen Vorjahr"
hinweis="Grundlage sind bezahlte Ausgangsrechnungen zum Zahlungsdatum."
className="xl:col-span-2"
legende={
<ChartLegende
eintraege={[
{ name: "Aktueller Zeitraum", farbe: PRIMAER_FARBE },
{ name: "Vorjahr", farbe: VERGLEICH_FARBE, gestrichelt: true },
]}
/>
}
>
<AreaVerlauf
daten={verlauf}
formatWert={formatEuroKompakt}
formatAchse={formatEuroAchse}
zeigeVergleich
hoehe={250}
/>
<StatZeile
spalten={2}
eintraege={[
{ label: "Vorperiode", wert: formatEuro(umsatzVorher) },
{
label: "Veränderung",
wert: `${umsatzAktuell >= umsatzVorher ? "+" : "−"}${formatEuro(Math.abs(umsatzAktuell - umsatzVorher))}`,
},
]}
/>
</ChartCard>
<ChartCard
id="finanzen-status"
titel="Offener Bestand nach Status"
untertitel="Wie viel des offenen Bestands bereits überfällig ist"
hinweis="Bezugsgröße ist ausschließlich der offene Bestand zum Stichtag. Bezahlte Rechnungen sind nicht enthalten — sie würden über 90 % des Rings belegen und die Aussage erdrücken."
>
<Donut
daten={offeneNachStatus(daten.rechnungen)}
formatWert={formatEuroKompakt}
hoehe={200}
mitteLabel="Offen"
formatMitte={formatEuro}
/>
</ChartCard>
</div>
<div className="grid grid-cols-1 items-start gap-4 lg:grid-cols-3">
<ChartCard
className="lg:col-span-2"
id="finanzen-alter"
titel="Offene Forderungen nach Alter"
untertitel={`Gesamt ${formatEuro(posten.gesamt)}`}
hinweis="Alter ab Fälligkeitsdatum. Ab 60 Tagen sinkt die Einbringungsquote erfahrungsgemäß deutlich."
>
<BalkenVertikal
daten={posten.nachAlter}
formatWert={formatEuroKompakt}
formatAchse={formatEuroAchse}
hoehe={240}
farbenProBalken={ALTER_FARBEN}
/>
<StatZeile
spalten={2}
eintraege={[
{
label: "Älter als 90 Tage",
wert: formatEuro(posten.nachAlter.find((b) => b.name === "> 90 Tage")?.value ?? 0),
hinweis: "Abschreibungsrisiko",
},
{ label: "Überfällig gesamt", wert: formatEuro(posten.ueberfaelligBetrag) },
]}
/>
</ChartCard>
<ChartCard
id="finanzen-gewerke"
titel="Umsatz nach Gewerk"
untertitel="Zahlungseingang im Zeitraum"
>
<BalkenHorizontal
daten={umsatzNachGewerk(daten.auftraege, daten.rechnungen, filter.zeitraum)}
formatWert={formatEuroKompakt}
einfarbig={false}
maxBalken={5}
/>
</ChartCard>
</div>
<ChartCard
id="finanzen-offene-liste"
titel={`Offene Rechnungen (${posten.anzahl})`}
untertitel="Sortiert nach Fälligkeit — die Arbeitsliste für den Mahnlauf"
>
<DataTable
zeilen={posten.liste}
spalten={spalten}
proSeite={8}
suchFelder={(r) => `${r.nummer} ${kundeName.get(r.kundeId) ?? ""}`}
leerText="Keine offenen Rechnungen"
/>
</ChartCard>
</PageContainer>
</>
);
}