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
274 lines
9.8 KiB
TypeScript
274 lines
9.8 KiB
TypeScript
"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 { AlertList } from "../components/cards/AlertList";
|
|
import { StatZeile } from "../components/cards/StatZeile";
|
|
import { AreaVerlauf } from "../components/charts/AreaVerlauf";
|
|
import { BalkenHorizontal } from "../components/charts/BalkenHorizontal";
|
|
import { AuslastungsBalken } from "../components/charts/AuslastungsBalken";
|
|
import { Trichter } from "../components/charts/Trichter";
|
|
import { ChartLegende } from "../components/charts/ChartLegende";
|
|
import { DataTable, type Spalte } from "../components/tables/DataTable";
|
|
import { AuftragBadge } from "../components/tables/StatusBadge";
|
|
import { useAnalyseDaten } from "../hooks/useAnalyseDaten";
|
|
import {
|
|
aktiveAuftraege,
|
|
handlungsbedarf,
|
|
marge,
|
|
neueKunden,
|
|
neueKundenVorperiode,
|
|
zahlungsdauer,
|
|
offenePosten,
|
|
teamKennzahlen,
|
|
ueberfaelligeAuftraege,
|
|
umsatz,
|
|
umsatzNachGewerk,
|
|
umsatzVerlauf,
|
|
umsatzVorperiode,
|
|
vertriebsTrichter,
|
|
} from "../data/calculations";
|
|
import {
|
|
berechneTrend,
|
|
formatEuro,
|
|
formatEuroAchse,
|
|
formatEuroKompakt,
|
|
formatProzent,
|
|
formatZahl,
|
|
tageSeit,
|
|
tageLabel,
|
|
formatTage,
|
|
} from "../utils/formatters";
|
|
import { HEUTE } from "../utils/dateUtils";
|
|
import { PRIMAER_FARBE, VERGLEICH_FARBE,
|
|
STATUS_TEXT,
|
|
} from "../utils/chartTheme";
|
|
import type { Auftrag } from "../data/types";
|
|
|
|
export function UebersichtSeite() {
|
|
const { daten, filter } = useAnalyseDaten("uebersicht");
|
|
|
|
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 aktiv = aktiveAuftraege(daten.auftraege);
|
|
const ueberfaellig = ueberfaelligeAuftraege(daten.auftraege);
|
|
const team = teamKennzahlen(daten.mitarbeiter, daten.zeiten, daten.auftraege, filter.zeitraum);
|
|
const alerts = handlungsbedarf(daten);
|
|
|
|
const monteureAktiv = team.filter((t) => t.mitarbeiter.status === "aktiv");
|
|
const durchschnittAuslastung =
|
|
monteureAktiv.length > 0
|
|
? monteureAktiv.reduce((s, t) => s + t.auslastungProzent, 0) / monteureAktiv.length
|
|
: 0;
|
|
|
|
const sparkline = verlauf.slice(-10).map((p) => p.value);
|
|
|
|
const gewerkUmsatz = umsatzNachGewerk(daten.auftraege, daten.rechnungen, filter.zeitraum);
|
|
const trichter = vertriebsTrichter(daten.auftraege);
|
|
|
|
const auftragSpalten: Spalte<Auftrag>[] = [
|
|
{
|
|
key: "nummer",
|
|
titel: "Auftrag",
|
|
breite: "26%",
|
|
zelle: (a) => (
|
|
<div className="flex flex-col">
|
|
<span className="font-medium">{a.titel}</span>
|
|
<span className="text-[11px] text-text-neutral-tertiary">{a.nummer}</span>
|
|
</div>
|
|
),
|
|
sortWert: (a) => a.nummer,
|
|
},
|
|
{
|
|
key: "gewerk",
|
|
titel: "Gewerk",
|
|
zelle: (a) => <span className="text-text-neutral-secondary">{a.gewerk}</span>,
|
|
sortWert: (a) => a.gewerk,
|
|
},
|
|
{ key: "status", titel: "Status", zelle: (a) => <AuftragBadge status={a.status} /> },
|
|
{
|
|
key: "faellig",
|
|
titel: "Fällig seit",
|
|
numerisch: true,
|
|
zelle: (a) => (
|
|
<span className="font-medium" style={{ color: STATUS_TEXT.negativ }}>
|
|
{tageLabel(tageSeit(a.faelligAm, HEUTE))}
|
|
</span>
|
|
),
|
|
sortWert: (a) => tageSeit(a.faelligAm, HEUTE),
|
|
},
|
|
{
|
|
key: "wert",
|
|
titel: "Wert",
|
|
numerisch: true,
|
|
zelle: (a) => formatEuro(a.wert),
|
|
sortWert: (a) => a.wert,
|
|
},
|
|
];
|
|
|
|
return (
|
|
<>
|
|
<PageHeader
|
|
titel="Übersicht"
|
|
beschreibung="Die Kennzahlen, nach denen der Betrieb gesteuert wird — Umsatz, Auslastung, offene Posten und Handlungsbedarf."
|
|
/>
|
|
<AnalyticsToolbar seite="uebersicht" />
|
|
|
|
<PageContainer>
|
|
<Raster spalten={5}>
|
|
<KPICard
|
|
label="Umsatz (Zahlungseingang)"
|
|
wert={formatEuro(umsatzAktuell)}
|
|
zusatz={`Deckungsbeitrag ${formatProzent(marge(daten.auftraege, filter.zeitraum))}`}
|
|
trend={berechneTrend(umsatzAktuell, umsatzVorher)}
|
|
icon="Euro"
|
|
verlauf={sparkline}
|
|
/>
|
|
<KPICard
|
|
label="Offene Forderungen"
|
|
wert={formatEuro(posten.gesamt)}
|
|
zusatz={`${posten.anzahl} Rechnungen · ${posten.ueberfaelligAnzahl} überfällig`}
|
|
icon="FileText"
|
|
bezug="stichtag"
|
|
akzent={posten.ueberfaelligAnzahl > 0 ? "warnung" : "neutral"}
|
|
/>
|
|
<KPICard
|
|
label="Aktive Aufträge"
|
|
wert={formatZahl(aktiv.length)}
|
|
zusatz={`${formatEuro(aktiv.reduce((s, a) => s + a.wert, 0))} Auftragsbestand`}
|
|
icon="ClipboardList"
|
|
bezug="stichtag"
|
|
/>
|
|
<KPICard
|
|
label="Ø Auslastung Monteure"
|
|
wert={formatProzent(durchschnittAuslastung, 0)}
|
|
zusatz={`${monteureAktiv.length} Personen im Einsatz`}
|
|
icon="HardHat"
|
|
akzent={durchschnittAuslastung > 95 ? "warnung" : durchschnittAuslastung < 70 ? "info" : "positiv"}
|
|
/>
|
|
<KPICard
|
|
label="Neue Kunden"
|
|
wert={formatZahl(neueKunden(daten.kunden, filter.zeitraum))}
|
|
zusatz={`${formatZahl(daten.kunden.filter((k) => k.auftraegeGesamt > 0).length)} Kunden mit Auftrag insgesamt`}
|
|
trend={berechneTrend(
|
|
neueKunden(daten.kunden, filter.zeitraum),
|
|
neueKundenVorperiode(daten.kunden, filter.zeitraum)
|
|
)}
|
|
icon="Users"
|
|
/>
|
|
</Raster>
|
|
|
|
<ChartCard
|
|
id="uebersicht-handlungsbedarf"
|
|
titel="Handlungsbedarf"
|
|
untertitel="Sortiert nach Dringlichkeit — jede Zeile führt in die zugehörige Arbeitsliste"
|
|
>
|
|
<AlertList eintraege={alerts} spalten={2} />
|
|
</ChartCard>
|
|
|
|
<div className="grid grid-cols-1 items-start gap-4 xl:grid-cols-3">
|
|
<ChartCard
|
|
id="uebersicht-umsatzverlauf"
|
|
titel="Zahlungseingang im Zeitverlauf"
|
|
untertitel="Aktueller Zeitraum gegen den Vorjahreszeitraum"
|
|
hinweis="Gezählt wird der Tag des Zahlungseingangs, nicht das Rechnungsdatum. Dadurch entspricht die Kurve dem tatsächlichen Geldfluss."
|
|
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={268}
|
|
/>
|
|
<StatZeile
|
|
spalten={3}
|
|
eintraege={[
|
|
{ label: "Vorperiode", wert: formatEuro(umsatzVorher) },
|
|
{
|
|
label: "Ø Auftragswert",
|
|
wert: formatEuro(
|
|
daten.auftraege.length
|
|
? daten.auftraege.reduce((s, a) => s + a.wert, 0) / daten.auftraege.length
|
|
: 0
|
|
),
|
|
},
|
|
{ label: "Ø Zahlungsdauer", wert: formatTage(zahlungsdauer(daten.rechnungen, filter.zeitraum)) },
|
|
]}
|
|
/>
|
|
</ChartCard>
|
|
|
|
<ChartCard
|
|
id="uebersicht-gewerke"
|
|
titel="Umsatz nach Gewerk"
|
|
untertitel="Zahlungseingang im gewählten Zeitraum"
|
|
hinweis="Fünf Gewerke in fester Rangfolge. Dieselbe Kodierung wie auf der Finanzseite — ein Ring und eine Balkenliste für dieselbe Zahl wären zwei Bilder für einen Sachverhalt."
|
|
>
|
|
<BalkenHorizontal
|
|
daten={gewerkUmsatz}
|
|
formatWert={formatEuroKompakt}
|
|
einfarbig={false}
|
|
/>
|
|
</ChartCard>
|
|
</div>
|
|
|
|
<div className="grid grid-cols-1 items-start gap-4 lg:grid-cols-2">
|
|
<ChartCard
|
|
id="uebersicht-trichter"
|
|
titel="Vertriebstrichter"
|
|
untertitel="Angebotsgeschäft ab 6.000 €, zum Stichtag"
|
|
hinweis="Nur Vorhaben, für die ein schriftliches Angebot erstellt wird. Wartung und Notdienst laufen ohne Angebot und würden die Quoten verfälschen. Rechte Spalte: Übergang von der vorherigen Stufe."
|
|
>
|
|
<Trichter stufen={trichter} formatWert={(w) => formatZahl(w)} />
|
|
</ChartCard>
|
|
|
|
<ChartCard
|
|
id="uebersicht-auslastung"
|
|
titel="Auslastung Monteure"
|
|
untertitel="Produktive Stunden gegen verfügbare Stunden"
|
|
hinweis="Nur auf Aufträge gebuchte Stunden zählen als produktiv. Über 100 % bedeutet Überstunden."
|
|
>
|
|
<AuslastungsBalken
|
|
zeilen={monteureAktiv.slice(0, 6).map((t) => ({
|
|
name: t.mitarbeiter.name,
|
|
wert: t.auslastungProzent,
|
|
zusatz: t.mitarbeiter.gewerk,
|
|
}))}
|
|
/>
|
|
</ChartCard>
|
|
|
|
</div>
|
|
|
|
<ChartCard
|
|
id="uebersicht-ueberfaellig"
|
|
titel={`Aufträge über Termin (${ueberfaellig.length})`}
|
|
untertitel="Fälligkeitsdatum überschritten, noch nicht abgeschlossen"
|
|
>
|
|
<DataTable
|
|
zeilen={ueberfaellig}
|
|
spalten={auftragSpalten}
|
|
proSeite={6}
|
|
suchFelder={(a) => `${a.titel} ${a.nummer} ${a.gewerk}`}
|
|
leerText="Kein Auftrag ist über Termin — sehr gut."
|
|
/>
|
|
</ChartCard>
|
|
|
|
</PageContainer>
|
|
</>
|
|
);
|
|
}
|