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,241 @@
|
||||
"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 { BalkenVertikal } from "../components/charts/BalkenVertikal";
|
||||
import { BalkenHorizontal } from "../components/charts/BalkenHorizontal";
|
||||
import { Donut } from "../components/charts/Donut";
|
||||
import { DataTable, type Spalte } from "../components/tables/DataTable";
|
||||
import { useAnalyseDaten } from "../hooks/useAnalyseDaten";
|
||||
import {
|
||||
inaktiveKunden,
|
||||
kundenEntwicklung,
|
||||
kundenNach,
|
||||
neueKunden,
|
||||
topKunden,
|
||||
wiederkehrquote,
|
||||
zahlungsauffaellig,
|
||||
} from "../data/calculations";
|
||||
import {
|
||||
berechneTrend,
|
||||
formatDatum,
|
||||
formatEuro,
|
||||
formatEuroKompakt,
|
||||
formatProzent,
|
||||
formatZahl,
|
||||
tageLabel,
|
||||
} from "../utils/formatters";
|
||||
import { STATUS_TEXT } from "../utils/chartTheme";
|
||||
import { imFenster, vorperiode } from "../utils/dateUtils";
|
||||
import type { Kunde } from "../data/types";
|
||||
|
||||
export function KundenSeite() {
|
||||
const { daten, filter } = useAnalyseDaten("kunden");
|
||||
|
||||
const neu = neueKunden(daten.kunden, filter.zeitraum);
|
||||
const neuVorher = daten.kunden.filter((k) =>
|
||||
imFenster(k.angelegtAm, vorperiode(filter.zeitraum))
|
||||
).length;
|
||||
|
||||
const mitAuftrag = daten.kunden.filter((k) => k.auftraegeGesamt > 0);
|
||||
const wiederkehrend = wiederkehrquote(daten.kunden);
|
||||
const kundenwert =
|
||||
mitAuftrag.length > 0
|
||||
? mitAuftrag.reduce((s, k) => s + k.umsatzGesamt, 0) / mitAuftrag.length
|
||||
: 0;
|
||||
const inaktiv = inaktiveKunden(daten.kunden);
|
||||
const auffaellig = zahlungsauffaellig(daten.kunden);
|
||||
const entwicklung = kundenEntwicklung(daten.kunden, filter.zeitraum);
|
||||
|
||||
const spalten: Spalte<Kunde>[] = [
|
||||
{
|
||||
key: "name",
|
||||
titel: "Kunde",
|
||||
breite: "26%",
|
||||
zelle: (k) => (
|
||||
<div className="flex flex-col">
|
||||
<span className="font-medium">{k.name}</span>
|
||||
<span className="text-[11px] text-text-neutral-tertiary">{k.typ}</span>
|
||||
</div>
|
||||
),
|
||||
sortWert: (k) => k.name,
|
||||
},
|
||||
{
|
||||
key: "quelle",
|
||||
titel: "Quelle",
|
||||
zelle: (k) => <span className="text-text-neutral-secondary">{k.quelle}</span>,
|
||||
sortWert: (k) => k.quelle,
|
||||
},
|
||||
{
|
||||
key: "auftraege",
|
||||
titel: "Aufträge",
|
||||
numerisch: true,
|
||||
zelle: (k) => formatZahl(k.auftraegeGesamt),
|
||||
sortWert: (k) => k.auftraegeGesamt,
|
||||
},
|
||||
{
|
||||
key: "umsatz",
|
||||
titel: "Umsatz",
|
||||
numerisch: true,
|
||||
zelle: (k) => <span className="font-medium">{formatEuro(k.umsatzGesamt)}</span>,
|
||||
sortWert: (k) => k.umsatzGesamt,
|
||||
},
|
||||
{
|
||||
key: "zahlung",
|
||||
titel: "Ø Zahlung",
|
||||
numerisch: true,
|
||||
zelle: (k) => (
|
||||
<span
|
||||
className={k.zahlungsmoralTage > 30 ? "font-medium" : ""}
|
||||
style={k.zahlungsmoralTage > 30 ? { color: STATUS_TEXT.warnung } : undefined}
|
||||
>
|
||||
{tageLabel(k.zahlungsmoralTage)}
|
||||
</span>
|
||||
),
|
||||
sortWert: (k) => k.zahlungsmoralTage,
|
||||
},
|
||||
{
|
||||
key: "letzter",
|
||||
titel: "Letzter Auftrag",
|
||||
zelle: (k) =>
|
||||
k.letzterAuftragAm ? (
|
||||
formatDatum(k.letzterAuftragAm)
|
||||
) : (
|
||||
<span className="text-text-neutral-subtle">—</span>
|
||||
),
|
||||
sortWert: (k) => k.letzterAuftragAm ?? "",
|
||||
},
|
||||
];
|
||||
|
||||
return (
|
||||
<>
|
||||
<PageHeader
|
||||
titel="Kunden"
|
||||
beschreibung="Woher Kunden kommen, wie viel sie bringen und wo Nachfassen lohnt."
|
||||
/>
|
||||
<AnalyticsToolbar seite="kunden" />
|
||||
|
||||
<PageContainer>
|
||||
<Raster spalten={5}>
|
||||
<KPICard
|
||||
label="Kunden gesamt"
|
||||
wert={formatZahl(daten.kunden.length)}
|
||||
zusatz={`${formatZahl(mitAuftrag.length)} mit mindestens einem Auftrag`}
|
||||
icon="Users"
|
||||
bezug="stichtag"
|
||||
/>
|
||||
<KPICard
|
||||
label="Neue Kunden"
|
||||
wert={formatZahl(neu)}
|
||||
zusatz="Nach Anlagedatum gezählt"
|
||||
trend={berechneTrend(neu, neuVorher)}
|
||||
icon="UserPlus"
|
||||
verlauf={entwicklung.slice(-10).map((p) => p.value)}
|
||||
/>
|
||||
<KPICard
|
||||
label="Wiederkehrende Kunden"
|
||||
wert={formatProzent(wiederkehrend, 0)}
|
||||
zusatz="Mehr als ein Auftrag"
|
||||
icon="Repeat"
|
||||
bezug="stichtag"
|
||||
/>
|
||||
<KPICard
|
||||
label="Ø Kundenwert"
|
||||
wert={formatEuro(kundenwert)}
|
||||
zusatz="Je Kunde mit mindestens einem Auftrag"
|
||||
icon="CircleDollarSign"
|
||||
bezug="gesamt"
|
||||
/>
|
||||
<KPICard
|
||||
label="Reaktivierbar"
|
||||
wert={formatZahl(inaktiv.length)}
|
||||
zusatz="Über 12 Monate ohne Auftrag"
|
||||
icon="Clock"
|
||||
bezug="stichtag"
|
||||
akzent={inaktiv.length > 0 ? "warnung" : "neutral"}
|
||||
/>
|
||||
</Raster>
|
||||
|
||||
<div className="grid grid-cols-1 items-start gap-4 xl:grid-cols-3">
|
||||
<ChartCard
|
||||
id="kunden-entwicklung"
|
||||
titel="Neukunden im Zeitverlauf"
|
||||
untertitel="Anlagedatum des Kundendatensatzes"
|
||||
className="xl:col-span-2"
|
||||
>
|
||||
<BalkenVertikal daten={entwicklung} formatWert={(w) => formatZahl(w)} hoehe={250} nurGanzzahlen />
|
||||
</ChartCard>
|
||||
|
||||
<ChartCard
|
||||
id="kunden-quelle"
|
||||
titel="Kunden nach Quelle"
|
||||
untertitel="Wie der Erstkontakt zustande kam"
|
||||
hinweis="Empfehlungen und Bestandskunden zusammen zeigen, wie stark der Betrieb ohne Werbebudget wächst."
|
||||
>
|
||||
<Donut
|
||||
daten={kundenNach(daten.kunden, "quelle")}
|
||||
formatWert={(w) => formatZahl(w)}
|
||||
hoehe={220}
|
||||
mitteLabel="Kunden"
|
||||
/>
|
||||
</ChartCard>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 items-start gap-4 lg:grid-cols-2">
|
||||
<ChartCard id="kunden-typ" titel="Kundenstruktur" untertitel="Privat, Gewerbe, Verwaltung">
|
||||
<Donut
|
||||
daten={kundenNach(daten.kunden, "typ")}
|
||||
formatWert={(w) => formatZahl(w)}
|
||||
hoehe={200}
|
||||
mitteLabel="Kunden"
|
||||
/>
|
||||
</ChartCard>
|
||||
|
||||
|
||||
<ChartCard
|
||||
id="kunden-top"
|
||||
titel="Top-Kunden nach Umsatz"
|
||||
untertitel="Bezahlter Gesamtumsatz"
|
||||
>
|
||||
<BalkenHorizontal daten={topKunden(daten.kunden, 6)} formatWert={formatEuroKompakt} />
|
||||
</ChartCard>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 items-start gap-4 xl:grid-cols-2">
|
||||
<ChartCard
|
||||
id="kunden-inaktiv"
|
||||
titel={`Reaktivierungspotenzial (${inaktiv.length})`}
|
||||
untertitel="Kunden mit Historie, aber über 12 Monate ohne Auftrag"
|
||||
>
|
||||
<DataTable
|
||||
zeilen={inaktiv}
|
||||
spalten={spalten.filter((s) => s.key !== "zahlung")}
|
||||
proSeite={6}
|
||||
suchFelder={(k) => `${k.name} ${k.ort} ${k.quelle}`}
|
||||
leerText="Alle Kunden waren zuletzt aktiv"
|
||||
/>
|
||||
</ChartCard>
|
||||
|
||||
<ChartCard
|
||||
id="kunden-zahlung"
|
||||
titel={`Auffällige Zahlungsmoral (${auffaellig.length})`}
|
||||
untertitel="Durchschnittlich über 30 Tage bis zum Zahlungseingang"
|
||||
>
|
||||
<DataTable
|
||||
zeilen={auffaellig}
|
||||
spalten={spalten.filter((s) => s.key !== "letzter")}
|
||||
proSeite={6}
|
||||
suchFelder={(k) => `${k.name} ${k.ort}`}
|
||||
leerText="Keine Auffälligkeiten"
|
||||
/>
|
||||
</ChartCard>
|
||||
</div>
|
||||
|
||||
</PageContainer>
|
||||
</>
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user