refactor(dashboard): Seiten von der Datenquelle entkoppeln

Die Seiten holten ihre Zahlen selbst aus einem globalen Store. HiveGrid Cloud
verlangt reine Screens nach dem Muster <XPage vm={} actions={} /> — jede Seite
hätte beim Einbau auseinandergenommen werden müssen.

Neue Schichtung:

  view-models/<seite>.vm.ts   baue<Seite>VM(daten, filter) → VMState<…>
                              reine Funktion, kein React, kein Store
  pages/<Seite>.tsx           ({ vm, optionen }) → JSX      wird portiert
  routes/<Seite>Route.tsx     Store + Builder + Seite       wird ersetzt

view-models/index.ts spiegelt VMState wortgleich aus @hivegrid/view-models;
beim Einbau ist es ein Import-Wechsel. Der Loader ruft denselben Builder mit
echten Daten, die Seiten bleiben unberührt.

Dabei abgefallen: die fünf Seitenzustände (idle · loading · ready · empty ·
error) über SeitenZustand — bisher lief der Prototyp nur im Zustand "Daten da",
in der Cloud sind alle fünf DoD-Pflicht. Die Filterleiste bekommt ihre
Auswahllisten jetzt als Prop (in der Software die Facetten aus dem Loader)
statt sie selbst aus dem Datensatz zu ziehen.

Store- und Rohdatenzugriff gibt es damit ausschließlich in routes/. Alle sechs
Seiten rendern pixelgleich; typecheck, lint und build sind grün.

Nicht geändert: Next.js bleibt. Im gesamten Projekt gibt es vier
Next-spezifische Importe, alle in AppShell und app/layout — beide Dateien
entfallen beim Einbau ohnehin, weil die Cloud Shell und Root-Layout mitbringt.
Ein Framework-Wechsel wäre Aufwand ohne Ertrag.

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:39:41 +02:00
1 parent b8bf987d0e
commit 99be627dad
28 files changed
+1030 -340

No files matched your search

+54 -71
View File
@@ -13,19 +13,6 @@ import { Donut } from "../components/charts/Donut";
import { Trichter } from "../components/charts/Trichter";
import { DataTable, type Spalte } from "../components/tables/DataTable";
import { AuftragBadge } from "../components/tables/StatusBadge";
import { useAnalyseDaten } from "../hooks/useAnalyseDaten";
import {
abschlussquote,
aktiveAuftraege,
auftraegeImZeitraum,
auftraegeNachGewerk,
auftraegeNachStatus,
auftragseingang,
durchlaufzeit,
foerderQuote,
ueberfaelligeAuftraege,
vertriebsTrichter,
} from "../data/calculations";
import {
berechneTrend,
formatDatum,
@@ -39,31 +26,33 @@ import {
tageLabelDativ,
} from "../utils/formatters";
import { STATUS_TEXT } from "../utils/chartTheme";
import { HEUTE, vorperiode, imFenster } from "../utils/dateUtils";
import { HEUTE } from "../utils/dateUtils";
import type { Auftrag } from "../data/types";
import { SeitenZustand } from "../components/layout/SeitenZustand";
import type { VMState } from "../view-models";
import type { AuftraegeDaten } from "../view-models/auftraege.vm";
import type { FilterOptionen } from "../view-models/filter-optionen";
export function AuftraegeSeite() {
const { daten, filter } = useAnalyseDaten("auftraege");
const imZeitraum = auftraegeImZeitraum(daten.auftraege, filter.zeitraum);
const vorher = daten.auftraege.filter((a) => imFenster(a.angelegtAm, vorperiode(filter.zeitraum)));
const aktiv = aktiveAuftraege(daten.auftraege);
const ueberfaellig = ueberfaelligeAuftraege(daten.auftraege);
const quote = abschlussquote(daten.auftraege);
const laufzeit = durchlaufzeit(daten.auftraege);
const foerderung = foerderQuote(daten.auftraege);
const eingang = auftragseingang(daten.auftraege, filter.zeitraum);
const bestand = aktiv.reduce((s, a) => s + a.wert, 0);
const mitarbeiterName = React.useMemo(
() => new Map(daten.mitarbeiter.map((m) => [m.id, m.name])),
[daten.mitarbeiter]
);
const kundeName = React.useMemo(
() => new Map(daten.kunden.map((k) => [k.id, k.name])),
[daten.kunden]
);
export function AuftraegeSeite({
vm,
optionen,
}: {
vm: VMState<AuftraegeDaten>;
optionen: FilterOptionen;
}) {
if (vm.status !== "ready") {
return (
<>
<PageHeader
titel="Aufträge"
beschreibung="Von der Anfrage bis zur Abnahme — wo die Vorgänge stehen, was gebunden ist und was über Termin läuft."
/>
<AnalyticsToolbar seite="auftraege" optionen={optionen} />
<SeitenZustand vm={vm} />
</>
);
}
const d = vm.data;
const spalten: Spalte<Auftrag>[] = [
{
@@ -74,7 +63,7 @@ export function AuftraegeSeite() {
<div className="flex flex-col">
<span className="font-medium">{a.titel}</span>
<span className="text-[11px] text-text-neutral-tertiary">
{a.nummer} · {kundeName.get(a.kundeId) ?? "Unbekannt"}
{a.nummer} · {d.kundeName.get(a.kundeId) ?? "Unbekannt"}
</span>
</div>
),
@@ -92,10 +81,10 @@ export function AuftraegeSeite() {
titel: "Verantwortlich",
zelle: (a) => (
<span className="text-text-neutral-secondary">
{mitarbeiterName.get(a.mitarbeiterId) ?? "—"}
{d.mitarbeiterName.get(a.mitarbeiterId) ?? "—"}
</span>
),
sortWert: (a) => mitarbeiterName.get(a.mitarbeiterId) ?? "",
sortWert: (a) => d.mitarbeiterName.get(a.mitarbeiterId) ?? "",
},
{
key: "faellig",
@@ -128,47 +117,47 @@ export function AuftraegeSeite() {
titel="Aufträge"
beschreibung="Von der Anfrage bis zur Abnahme — wo die Vorgänge stehen, was gebunden ist und was über Termin läuft."
/>
<AnalyticsToolbar seite="auftraege" />
<AnalyticsToolbar seite="auftraege" optionen={optionen} />
<PageContainer>
<Raster spalten={5}>
<KPICard
label="Neue Vorgänge"
wert={formatZahl(imZeitraum.length)}
wert={formatZahl(d.imZeitraum.length)}
zusatz="Nach Anlagedatum gezählt"
trend={berechneTrend(imZeitraum.length, vorher.length)}
trend={berechneTrend(d.imZeitraum.length, d.vorher.length)}
icon="ClipboardList"
verlauf={eingang.slice(-10).map((p) => p.value)}
verlauf={d.sparkline}
/>
<KPICard
label="Aktive Aufträge"
wert={formatZahl(aktiv.length)}
zusatz={`${formatEuro(bestand)} Auftragsbestand`}
wert={formatZahl(d.aktiv.length)}
zusatz={`${formatEuro(d.bestand)} Auftragsbestand`}
icon="Package"
bezug="stichtag"
/>
<KPICard
label="Über Termin"
wert={formatZahl(ueberfaellig.length)}
wert={formatZahl(d.ueberfaellig.length)}
zusatz={
ueberfaellig.length
? `Ältester seit ${tageLabelDativ(tageSeit(ueberfaellig[0].faelligAm, HEUTE))} fällig`
d.ueberfaellig.length
? `Ältester seit ${tageLabelDativ(tageSeit(d.ueberfaellig[0].faelligAm, HEUTE))} fällig`
: "Alle Termine gehalten"
}
icon="AlertTriangle"
bezug="stichtag"
akzent={ueberfaellig.length ? "negativ" : "positiv"}
akzent={d.ueberfaellig.length ? "negativ" : "positiv"}
/>
<KPICard
label="Abschlussquote"
wert={formatProzent(quote, 0)}
wert={formatProzent(d.quote, 0)}
zusatz="Aus Angebot wird Auftrag"
icon="Target"
bezug="stichtag"
/>
<KPICard
label="Ø Durchlaufzeit"
wert={formatTage(laufzeit)}
wert={formatTage(d.laufzeit)}
zusatz="Anfrage bis Abnahme"
icon="Clock"
bezug="stichtag"
@@ -183,18 +172,14 @@ export function AuftraegeSeite() {
untertitel="Neu angelegte Vorgänge im Zeitverlauf"
className="xl:col-span-2"
>
<BalkenVertikal daten={eingang} formatWert={(w) => formatZahl(w)} hoehe={250} nurGanzzahlen />
<BalkenVertikal daten={d.eingang} formatWert={(w) => formatZahl(w)} hoehe={250} nurGanzzahlen />
<StatZeile
spalten={2}
eintraege={[
{ label: "Vorperiode", wert: formatZahl(vorher.length) },
{ label: "Vorperiode", wert: formatZahl(d.vorher.length) },
{
label: "Ø Auftragswert",
wert: formatEuro(
imZeitraum.length
? imZeitraum.reduce((s, a) => s + a.wert, 0) / imZeitraum.length
: 0
),
wert: formatEuro(d.durchschnittAuftragswert),
},
]}
/>
@@ -206,7 +191,7 @@ export function AuftraegeSeite() {
untertitel="Angebotsgeschäft ab 6.000 €, nach erreichter Stufe"
hinweis="Nur Vorhaben mit schriftlichem Angebot. Wartung und Notdienst gehen ohne Angebot direkt in die Ausführung — mitgezählt wäre der Trichter unten breiter als oben. Verlorene Vorgänge zählen bis zu der Stufe, auf der sie abgesprungen sind."
>
<Trichter stufen={vertriebsTrichter(daten.auftraege)} formatWert={(w) => formatZahl(w)} />
<Trichter stufen={d.trichter} formatWert={(w) => formatZahl(w)} />
</ChartCard>
</div>
@@ -217,7 +202,7 @@ export function AuftraegeSeite() {
untertitel="Alle Vorgänge seit Beginn — unabhängig vom Zeitraumfilter"
>
<Donut
daten={auftraegeNachStatus(daten.auftraege)}
daten={d.statusVerteilung}
formatWert={(w) => formatZahl(w)}
hoehe={220}
mitteLabel="Vorgänge"
@@ -230,7 +215,7 @@ export function AuftraegeSeite() {
untertitel="Anzahl seit Beginn, zum Stichtag"
>
<BalkenHorizontal
daten={auftraegeNachGewerk(daten.auftraege)}
daten={d.gewerkAnzahl}
formatWert={(w) => formatZahl(w)}
einfarbig={false}
maxBalken={5}
@@ -240,13 +225,13 @@ export function AuftraegeSeite() {
<ChartCard
id="auftraege-foerderung"
titel="Förderquote BAFA / KfW"
untertitel={`${formatProzent(foerderung.quote, 0)} der ${formatZahl(
foerderung.foerderfaehig
untertitel={`${formatProzent(d.foerderung.quote, 0)} der ${formatZahl(
d.foerderung.foerderfaehig
)} förderfähigen Aufträge`}
hinweis="Bezugsgröße sind nur förderfähige Leistungen: Wärmepumpe, PV-Anlage, Batteriespeicher und Lüftungsanlage. Über alle Aufträge gerechnet wäre die Quote wertlos."
>
<Donut
daten={foerderung.verteilung}
daten={d.foerderung.verteilung}
formatWert={(w) => formatZahl(w)}
hoehe={200}
mitteLabel="Förderfähig"
@@ -254,12 +239,10 @@ export function AuftraegeSeite() {
<StatZeile
spalten={2}
eintraege={[
{ label: "Fördersumme", wert: formatEuroKompakt(foerderung.summe) },
{ label: "Fördersumme", wert: formatEuroKompakt(d.foerderung.summe) },
{
label: "Ø je Auftrag",
wert: formatEuroKompakt(
foerderung.bewilligt ? foerderung.summe / foerderung.bewilligt : 0
),
wert: formatEuroKompakt(d.foerderungJeAuftrag),
},
]}
/>
@@ -268,15 +251,15 @@ export function AuftraegeSeite() {
<ChartCard
id="auftraege-liste"
titel={`Aktive Aufträge (${aktiv.length})`}
titel={`Aktive Aufträge (${d.aktiv.length})`}
untertitel="Beauftragt oder in Arbeit"
>
<DataTable
zeilen={aktiv}
zeilen={d.aktiv}
spalten={spalten}
proSeite={8}
suchFelder={(a) =>
`${a.titel} ${a.nummer} ${a.gewerk} ${mitarbeiterName.get(a.mitarbeiterId) ?? ""}`
`${a.titel} ${a.nummer} ${a.gewerk} ${d.mitarbeiterName.get(a.mitarbeiterId) ?? ""}`
}
leerText="Keine aktiven Aufträge"
/>
+51 -50
View File
@@ -14,17 +14,6 @@ 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,
@@ -44,24 +33,34 @@ import {
VERGLEICH_FARBE,
} from "../utils/chartTheme";
import type { Rechnung } from "../data/types";
import { SeitenZustand } from "../components/layout/SeitenZustand";
import type { VMState } from "../view-models";
import type { FinanzenDaten } from "../view-models/finanzen.vm";
import type { FilterOptionen } from "../view-models/filter-optionen";
/** 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]
);
export function FinanzenSeite({
vm,
optionen,
}: {
vm: VMState<FinanzenDaten>;
optionen: FilterOptionen;
}) {
if (vm.status !== "ready") {
return (
<>
<PageHeader
titel="Finanzen"
beschreibung="Umsatz, Zahlungseingang und offene Forderungen — die Sicht der Buchhaltung auf den Betrieb."
/>
<AnalyticsToolbar seite="finanzen" optionen={optionen} />
<SeitenZustand vm={vm} />
</>
);
}
const d = vm.data;
const spalten: Spalte<Rechnung>[] = [
{
@@ -71,7 +70,7 @@ export function FinanzenSeite() {
<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"}
{d.kundeName.get(r.kundeId) ?? "Unbekannt"}
</span>
</div>
),
@@ -121,44 +120,44 @@ export function FinanzenSeite() {
titel="Finanzen"
beschreibung="Umsatz, Zahlungseingang und offene Forderungen — die Sicht der Buchhaltung auf den Betrieb."
/>
<AnalyticsToolbar seite="finanzen" />
<AnalyticsToolbar seite="finanzen" optionen={optionen} />
<PageContainer>
<Raster spalten={5}>
<KPICard
label="Umsatz (bezahlt)"
wert={formatEuro(umsatzAktuell)}
wert={formatEuro(d.umsatzAktuell)}
zusatz="Zahlungseingang im Zeitraum"
trend={berechneTrend(umsatzAktuell, umsatzVorher)}
trend={berechneTrend(d.umsatzAktuell, d.umsatzVorher)}
icon="Euro"
verlauf={verlauf.slice(-10).map((p) => p.value)}
verlauf={d.sparkline}
/>
<KPICard
label="Offene Forderungen"
wert={formatEuro(posten.gesamt)}
zusatz={`${posten.anzahl} Rechnungen`}
wert={formatEuro(d.posten.gesamt)}
zusatz={`${d.posten.anzahl} Rechnungen`}
icon="FileText"
bezug="stichtag"
/>
<KPICard
label="Überfällig"
wert={formatEuro(posten.ueberfaelligBetrag)}
zusatz={`${posten.ueberfaelligAnzahl} Rechnungen im Mahnlauf`}
wert={formatEuro(d.posten.ueberfaelligBetrag)}
zusatz={`${d.posten.ueberfaelligAnzahl} Rechnungen im Mahnlauf`}
icon="AlertTriangle"
bezug="stichtag"
akzent={posten.ueberfaelligBetrag > 0 ? "negativ" : "positiv"}
akzent={d.posten.ueberfaelligBetrag > 0 ? "negativ" : "positiv"}
/>
<KPICard
label="Ø Zahlungsdauer"
wert={formatTage(dauer)}
wert={formatTage(d.zahlungsdauerTage)}
zusatz="Rechnung bis Zahlungseingang"
icon="Clock"
akzent={dauer > 30 ? "warnung" : "positiv"}
akzent={d.zahlungsdauerTage > 30 ? "warnung" : "positiv"}
richtungGut="negativ"
/>
<KPICard
label="Deckungsbeitrag"
wert={formatProzent(margeProzent)}
wert={formatProzent(d.margeProzent)}
zusatz="Gewichtet über Abschlüsse"
icon="Percent"
/>
@@ -181,7 +180,7 @@ export function FinanzenSeite() {
}
>
<AreaVerlauf
daten={verlauf}
daten={d.verlauf}
formatWert={formatEuroKompakt}
formatAchse={formatEuroAchse}
zeigeVergleich
@@ -190,10 +189,10 @@ export function FinanzenSeite() {
<StatZeile
spalten={2}
eintraege={[
{ label: "Vorperiode", wert: formatEuro(umsatzVorher) },
{ label: "Vorperiode", wert: formatEuro(d.umsatzVorher) },
{
label: "Veränderung",
wert: `${umsatzAktuell >= umsatzVorher ? "+" : "−"}${formatEuro(Math.abs(umsatzAktuell - umsatzVorher))}`,
wert: `${d.umsatzAktuell >= d.umsatzVorher ? "+" : "−"}${formatEuro(Math.abs(d.umsatzAktuell - d.umsatzVorher))}`,
},
]}
/>
@@ -206,7 +205,7 @@ export function FinanzenSeite() {
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)}
daten={d.offenNachStatus}
formatWert={formatEuroKompakt}
hoehe={200}
mitteLabel="Offen"
@@ -220,11 +219,11 @@ export function FinanzenSeite() {
className="lg:col-span-2"
id="finanzen-alter"
titel="Offene Forderungen nach Alter"
untertitel={`Gesamt ${formatEuro(posten.gesamt)}`}
untertitel={`Gesamt ${formatEuro(d.posten.gesamt)}`}
hinweis="Alter ab Fälligkeitsdatum. Ab 60 Tagen sinkt die Einbringungsquote erfahrungsgemäß deutlich."
>
<BalkenVertikal
daten={posten.nachAlter}
daten={d.posten.nachAlter}
formatWert={formatEuroKompakt}
formatAchse={formatEuroAchse}
hoehe={240}
@@ -235,10 +234,12 @@ export function FinanzenSeite() {
eintraege={[
{
label: "Älter als 90 Tage",
wert: formatEuro(posten.nachAlter.find((b) => b.name === "> 90 Tage")?.value ?? 0),
wert: formatEuro(
d.posten.nachAlter.find((b) => b.name === "> 90 Tage")?.value ?? 0
),
hinweis: "Abschreibungsrisiko",
},
{ label: "Überfällig gesamt", wert: formatEuro(posten.ueberfaelligBetrag) },
{ label: "Überfällig gesamt", wert: formatEuro(d.posten.ueberfaelligBetrag) },
]}
/>
</ChartCard>
@@ -249,7 +250,7 @@ export function FinanzenSeite() {
untertitel="Zahlungseingang im Zeitraum"
>
<BalkenHorizontal
daten={umsatzNachGewerk(daten.auftraege, daten.rechnungen, filter.zeitraum)}
daten={d.gewerkUmsatz}
formatWert={formatEuroKompakt}
einfarbig={false}
maxBalken={5}
@@ -260,14 +261,14 @@ export function FinanzenSeite() {
<ChartCard
id="finanzen-offene-liste"
titel={`Offene Rechnungen (${posten.anzahl})`}
titel={`Offene Rechnungen (${d.posten.anzahl})`}
untertitel="Sortiert nach Fälligkeit — die Arbeitsliste für den Mahnlauf"
>
<DataTable
zeilen={posten.liste}
zeilen={d.posten.liste}
spalten={spalten}
proSeite={8}
suchFelder={(r) => `${r.nummer} ${kundeName.get(r.kundeId) ?? ""}`}
suchFelder={(r) => `${r.nummer} ${d.kundeName.get(r.kundeId) ?? ""}`}
leerText="Keine offenen Rechnungen"
/>
</ChartCard>
+42 -46
View File
@@ -10,16 +10,6 @@ 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,
@@ -30,26 +20,32 @@ import {
tageLabel,
} from "../utils/formatters";
import { STATUS_TEXT } from "../utils/chartTheme";
import { imFenster, vorperiode } from "../utils/dateUtils";
import type { Kunde } from "../data/types";
import { SeitenZustand } from "../components/layout/SeitenZustand";
import type { VMState } from "../view-models";
import type { KundenDaten } from "../view-models/kunden.vm";
import type { FilterOptionen } from "../view-models/filter-optionen";
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);
export function KundenSeite({
vm,
optionen,
}: {
vm: VMState<KundenDaten>;
optionen: FilterOptionen;
}) {
if (vm.status !== "ready") {
return (
<>
<PageHeader
titel="Kunden"
beschreibung="Woher Kunden kommen, wie viel sie bringen und wo Nachfassen lohnt."
/>
<AnalyticsToolbar seite="kunden" optionen={optionen} />
<SeitenZustand vm={vm} />
</>
);
}
const d = vm.data;
const spalten: Spalte<Kunde>[] = [
{
@@ -117,46 +113,46 @@ export function KundenSeite() {
titel="Kunden"
beschreibung="Woher Kunden kommen, wie viel sie bringen und wo Nachfassen lohnt."
/>
<AnalyticsToolbar seite="kunden" />
<AnalyticsToolbar seite="kunden" optionen={optionen} />
<PageContainer>
<Raster spalten={5}>
<KPICard
label="Kunden gesamt"
wert={formatZahl(daten.kunden.length)}
zusatz={`${formatZahl(mitAuftrag.length)} mit mindestens einem Auftrag`}
wert={formatZahl(d.kundenGesamt)}
zusatz={`${formatZahl(d.kundenMitAuftrag)} mit mindestens einem Auftrag`}
icon="Users"
bezug="stichtag"
/>
<KPICard
label="Neue Kunden"
wert={formatZahl(neu)}
wert={formatZahl(d.neueKunden)}
zusatz="Nach Anlagedatum gezählt"
trend={berechneTrend(neu, neuVorher)}
trend={berechneTrend(d.neueKunden, d.neueKundenVorher)}
icon="UserPlus"
verlauf={entwicklung.slice(-10).map((p) => p.value)}
verlauf={d.sparkline}
/>
<KPICard
label="Wiederkehrende Kunden"
wert={formatProzent(wiederkehrend, 0)}
wert={formatProzent(d.wiederkehrendProzent, 0)}
zusatz="Mehr als ein Auftrag"
icon="Repeat"
bezug="stichtag"
/>
<KPICard
label="Ø Kundenwert"
wert={formatEuro(kundenwert)}
wert={formatEuro(d.kundenwert)}
zusatz="Je Kunde mit mindestens einem Auftrag"
icon="CircleDollarSign"
bezug="gesamt"
/>
<KPICard
label="Reaktivierbar"
wert={formatZahl(inaktiv.length)}
wert={formatZahl(d.inaktive.length)}
zusatz="Über 12 Monate ohne Auftrag"
icon="Clock"
bezug="stichtag"
akzent={inaktiv.length > 0 ? "warnung" : "neutral"}
akzent={d.inaktive.length > 0 ? "warnung" : "neutral"}
/>
</Raster>
@@ -167,7 +163,7 @@ export function KundenSeite() {
untertitel="Anlagedatum des Kundendatensatzes"
className="xl:col-span-2"
>
<BalkenVertikal daten={entwicklung} formatWert={(w) => formatZahl(w)} hoehe={250} nurGanzzahlen />
<BalkenVertikal daten={d.entwicklung} formatWert={(w) => formatZahl(w)} hoehe={250} nurGanzzahlen />
</ChartCard>
<ChartCard
@@ -177,7 +173,7 @@ export function KundenSeite() {
hinweis="Empfehlungen und Bestandskunden zusammen zeigen, wie stark der Betrieb ohne Werbebudget wächst."
>
<Donut
daten={kundenNach(daten.kunden, "quelle")}
daten={d.nachQuelle}
formatWert={(w) => formatZahl(w)}
hoehe={220}
mitteLabel="Kunden"
@@ -188,7 +184,7 @@ export function KundenSeite() {
<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")}
daten={d.nachTyp}
formatWert={(w) => formatZahl(w)}
hoehe={200}
mitteLabel="Kunden"
@@ -201,18 +197,18 @@ export function KundenSeite() {
titel="Top-Kunden nach Umsatz"
untertitel="Bezahlter Gesamtumsatz"
>
<BalkenHorizontal daten={topKunden(daten.kunden, 6)} formatWert={formatEuroKompakt} />
<BalkenHorizontal daten={d.topKunden} 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})`}
titel={`Reaktivierungspotenzial (${d.inaktive.length})`}
untertitel="Kunden mit Historie, aber über 12 Monate ohne Auftrag"
>
<DataTable
zeilen={inaktiv}
zeilen={d.inaktive}
spalten={spalten.filter((s) => s.key !== "zahlung")}
proSeite={6}
suchFelder={(k) => `${k.name} ${k.ort} ${k.quelle}`}
@@ -222,11 +218,11 @@ export function KundenSeite() {
<ChartCard
id="kunden-zahlung"
titel={`Auffällige Zahlungsmoral (${auffaellig.length})`}
titel={`Auffällige Zahlungsmoral (${d.auffaellige.length})`}
untertitel="Durchschnittlich über 30 Tage bis zum Zahlungseingang"
>
<DataTable
zeilen={auffaellig}
zeilen={d.auffaellige}
spalten={spalten.filter((s) => s.key !== "letzter")}
proSeite={6}
suchFelder={(k) => `${k.name} ${k.ort}`}
+38 -53
View File
@@ -10,47 +10,34 @@ import { AuslastungsBalken } from "../components/charts/AuslastungsBalken";
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 { teamKennzahlen, type MitarbeiterKennzahl } from "../data/calculations";
import { formatEuro, formatEuroKompakt, formatProzent, formatStunden, formatZahl } from "../utils/formatters";
import { imFenster, zeitfenster } from "../utils/dateUtils";
import { SeitenZustand } from "../components/layout/SeitenZustand";
import type { VMState } from "../view-models";
import type { TeamDaten, TeamZeile } from "../view-models/team.vm";
import type { FilterOptionen } from "../view-models/filter-optionen";
export function TeamSeite() {
const { daten, filter } = useAnalyseDaten("team");
export function TeamSeite({
vm,
optionen,
}: {
vm: VMState<TeamDaten>;
optionen: FilterOptionen;
}) {
if (vm.status !== "ready") {
return (
<>
<PageHeader
titel="Team"
beschreibung="Auslastung, produktive Stunden und Abschlüsse der Monteure — die Kennzahl hinter der Terminplanung."
/>
<AnalyticsToolbar seite="team" optionen={optionen} />
<SeitenZustand vm={vm} />
</>
);
}
const d = vm.data;
const kennzahlen = teamKennzahlen(
daten.mitarbeiter,
daten.zeiten,
daten.auftraege,
filter.zeitraum
);
const aktive = kennzahlen.filter((k) => k.mitarbeiter.status === "aktiv");
const durchschnitt =
aktive.length > 0 ? aktive.reduce((s, k) => s + k.auslastungProzent, 0) / aktive.length : 0;
const stundenGesamt = aktive.reduce((s, k) => s + k.stunden, 0);
const produktivGesamt = aktive.reduce((s, k) => s + k.produktivStunden, 0);
const produktivQuote = stundenGesamt > 0 ? (produktivGesamt / stundenGesamt) * 100 : 0;
const fenster = zeitfenster(filter.zeitraum);
const abwesenheiten = daten.zeiten.filter(
(z) => z.art === "abwesenheit" && imFenster(z.datum, fenster)
);
const abwesenheitNach = React.useMemo(() => {
const zaehler = new Map<string, number>();
const label: Record<string, string> = {
urlaub: "Urlaub",
krank: "Krank",
fortbildung: "Fortbildung",
};
for (const eintrag of abwesenheiten) {
const name = label[eintrag.abwesenheitsgrund ?? "sonstige"] ?? "Sonstige";
zaehler.set(name, (zaehler.get(name) ?? 0) + eintrag.stunden);
}
return [...zaehler.entries()].map(([name, value]) => ({ name, value }));
}, [abwesenheiten]);
const spalten: Spalte<MitarbeiterKennzahl & { id: string }>[] = [
const spalten: Spalte<TeamZeile>[] = [
{
key: "name",
titel: "Mitarbeiter",
@@ -134,47 +121,45 @@ export function TeamSeite() {
},
];
const tabellenZeilen = kennzahlen.map((k) => ({ ...k, id: k.mitarbeiter.id }));
return (
<>
<PageHeader
titel="Team"
beschreibung="Auslastung, produktive Stunden und Abschlüsse der Monteure — die Kennzahl hinter der Terminplanung."
/>
<AnalyticsToolbar seite="team" />
<AnalyticsToolbar seite="team" optionen={optionen} />
<PageContainer>
<Raster spalten={5}>
<KPICard
label="Im Einsatz"
wert={formatZahl(aktive.length)}
zusatz={`von ${formatZahl(kennzahlen.length)} gewerblich Beschäftigten`}
wert={formatZahl(d.aktive.length)}
zusatz={`von ${formatZahl(d.mitarbeiterGesamt)} gewerblich Beschäftigten`}
icon="HardHat"
bezug="stichtag"
/>
<KPICard
label="Ø Auslastung"
wert={formatProzent(durchschnitt, 0)}
wert={formatProzent(d.durchschnittAuslastung, 0)}
zusatz="Produktive Stunden zu verfügbaren"
icon="Activity"
akzent={durchschnitt > 95 ? "warnung" : "positiv"}
akzent={d.durchschnittAuslastung > 95 ? "warnung" : "positiv"}
/>
<KPICard
label="Produktivquote"
wert={formatProzent(produktivQuote, 0)}
wert={formatProzent(d.produktivQuote, 0)}
zusatz="Anteil auftragsbezogener Stunden"
icon="Target"
/>
<KPICard
label="Erfasste Stunden"
wert={formatStunden(stundenGesamt)}
zusatz={`${formatStunden(produktivGesamt)} auf Aufträge gebucht`}
wert={formatStunden(d.stundenGesamt)}
zusatz={`${formatStunden(d.produktivGesamt)} auf Aufträge gebucht`}
icon="Clock"
/>
<KPICard
label="Abwesenheit"
wert={formatStunden(abwesenheiten.reduce((s, a) => s + a.stunden, 0))}
wert={formatStunden(d.abwesenheitStunden)}
zusatz="Urlaub, Krankheit, Fortbildung"
icon="CalendarOff"
richtungGut="negativ"
@@ -188,7 +173,7 @@ export function TeamSeite() {
hinweis="Werte über 100 % bedeuten Überstunden. Dauerhaft über 95 % ist ein Warnsignal für Terminrisiken."
>
<AuslastungsBalken
zeilen={aktive.map((k) => ({
zeilen={d.aktive.map((k) => ({
name: k.mitarbeiter.name,
wert: k.auslastungProzent,
zusatz: `${k.mitarbeiter.rolle} · ${k.mitarbeiter.gewerk}`,
@@ -205,7 +190,7 @@ export function TeamSeite() {
hinweis="Der Balken zeigt die Anzahl — sie ist die vergleichbare Größe. Der Auftragswert steht daneben, ist aber ausdrücklich kein Leistungsvergleich: Ein Wärmepumpen-Auftrag ist um ein Vielfaches größer als eine Wartung."
>
<BalkenHorizontal
daten={aktive.map((k) => ({
daten={d.aktive.map((k) => ({
name: k.mitarbeiter.name,
value: k.abgeschlossen,
zweitwert: k.umsatz,
@@ -222,7 +207,7 @@ export function TeamSeite() {
untertitel="Stunden im gewählten Zeitraum"
>
<Donut
daten={abwesenheitNach}
daten={d.abwesenheitNach}
formatWert={(w) => formatStunden(w)}
hoehe={210}
mitteLabel="Stunden"
@@ -236,7 +221,7 @@ export function TeamSeite() {
untertitel="Alle gewerblich Beschäftigten mit Kennzahlen"
>
<DataTable
zeilen={tabellenZeilen}
zeilen={d.zeilen}
spalten={spalten}
proSeite={10}
suchFelder={(k) => `${k.mitarbeiter.name} ${k.mitarbeiter.rolle} ${k.mitarbeiter.gewerk}`}
+50 -72
View File
@@ -15,23 +15,6 @@ 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,
@@ -48,29 +31,31 @@ import { PRIMAER_FARBE, VERGLEICH_FARBE,
STATUS_TEXT,
} from "../utils/chartTheme";
import type { Auftrag } from "../data/types";
import { SeitenZustand } from "../components/layout/SeitenZustand";
import type { VMState } from "../view-models";
import type { UebersichtDaten } from "../view-models/uebersicht.vm";
import type { FilterOptionen } from "../view-models/filter-optionen";
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);
export function UebersichtSeite({
vm,
optionen,
}: {
vm: VMState<UebersichtDaten>;
optionen: FilterOptionen;
}) {
if (vm.status !== "ready") {
return (
<>
<PageHeader
titel="Übersicht"
beschreibung="Die Kennzahlen, nach denen der Betrieb gesteuert wird — Umsatz, Auslastung, offene Posten und Handlungsbedarf."
/>
<AnalyticsToolbar seite="uebersicht" optionen={optionen} />
<SeitenZustand vm={vm} />
</>
);
}
const d = vm.data;
const auftragSpalten: Spalte<Auftrag>[] = [
{
@@ -118,48 +103,45 @@ export function UebersichtSeite() {
titel="Übersicht"
beschreibung="Die Kennzahlen, nach denen der Betrieb gesteuert wird — Umsatz, Auslastung, offene Posten und Handlungsbedarf."
/>
<AnalyticsToolbar seite="uebersicht" />
<AnalyticsToolbar seite="uebersicht" optionen={optionen} />
<PageContainer>
<Raster spalten={5}>
<KPICard
label="Umsatz (Zahlungseingang)"
wert={formatEuro(umsatzAktuell)}
zusatz={`Deckungsbeitrag ${formatProzent(marge(daten.auftraege, filter.zeitraum))}`}
trend={berechneTrend(umsatzAktuell, umsatzVorher)}
wert={formatEuro(d.umsatzAktuell)}
zusatz={`Deckungsbeitrag ${formatProzent(d.margeProzent)}`}
trend={berechneTrend(d.umsatzAktuell, d.umsatzVorher)}
icon="Euro"
verlauf={sparkline}
verlauf={d.sparkline}
/>
<KPICard
label="Offene Forderungen"
wert={formatEuro(posten.gesamt)}
zusatz={`${posten.anzahl} Rechnungen · ${posten.ueberfaelligAnzahl} überfällig`}
wert={formatEuro(d.posten.gesamt)}
zusatz={`${d.posten.anzahl} Rechnungen · ${d.posten.ueberfaelligAnzahl} überfällig`}
icon="FileText"
bezug="stichtag"
akzent={posten.ueberfaelligAnzahl > 0 ? "warnung" : "neutral"}
akzent={d.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`}
wert={formatZahl(d.aktiveAuftraege.length)}
zusatz={`${formatEuro(d.auftragsbestand)} Auftragsbestand`}
icon="ClipboardList"
bezug="stichtag"
/>
<KPICard
label="Ø Auslastung Monteure"
wert={formatProzent(durchschnittAuslastung, 0)}
zusatz={`${monteureAktiv.length} Personen im Einsatz`}
wert={formatProzent(d.durchschnittAuslastung, 0)}
zusatz={`${d.monteureAktiv.length} Personen im Einsatz`}
icon="HardHat"
akzent={durchschnittAuslastung > 95 ? "warnung" : durchschnittAuslastung < 70 ? "info" : "positiv"}
akzent={d.durchschnittAuslastung > 95 ? "warnung" : d.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)
)}
wert={formatZahl(d.neueKunden)}
zusatz={`${formatZahl(d.kundenMitAuftrag)} Kunden mit Auftrag insgesamt`}
trend={berechneTrend(d.neueKunden, d.neueKundenVorher)}
icon="Users"
/>
</Raster>
@@ -169,7 +151,7 @@ export function UebersichtSeite() {
titel="Handlungsbedarf"
untertitel="Sortiert nach Dringlichkeit — jede Zeile führt in die zugehörige Arbeitsliste"
>
<AlertList eintraege={alerts} spalten={2} />
<AlertList eintraege={d.alerts} spalten={2} />
</ChartCard>
<div className="grid grid-cols-1 items-start gap-4 xl:grid-cols-3">
@@ -189,7 +171,7 @@ export function UebersichtSeite() {
}
>
<AreaVerlauf
daten={verlauf}
daten={d.verlauf}
formatWert={formatEuroKompakt}
formatAchse={formatEuroAchse}
zeigeVergleich
@@ -198,16 +180,12 @@ export function UebersichtSeite() {
<StatZeile
spalten={3}
eintraege={[
{ label: "Vorperiode", wert: formatEuro(umsatzVorher) },
{ label: "Vorperiode", wert: formatEuro(d.umsatzVorher) },
{
label: "Ø Auftragswert",
wert: formatEuro(
daten.auftraege.length
? daten.auftraege.reduce((s, a) => s + a.wert, 0) / daten.auftraege.length
: 0
),
wert: formatEuro(d.durchschnittAuftragswert),
},
{ label: "Ø Zahlungsdauer", wert: formatTage(zahlungsdauer(daten.rechnungen, filter.zeitraum)) },
{ label: "Ø Zahlungsdauer", wert: formatTage(d.zahlungsdauerTage) },
]}
/>
</ChartCard>
@@ -219,7 +197,7 @@ export function UebersichtSeite() {
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}
daten={d.gewerkUmsatz}
formatWert={formatEuroKompakt}
einfarbig={false}
/>
@@ -233,7 +211,7 @@ export function UebersichtSeite() {
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)} />
<Trichter stufen={d.trichter} formatWert={(w) => formatZahl(w)} />
</ChartCard>
<ChartCard
@@ -243,7 +221,7 @@ export function UebersichtSeite() {
hinweis="Nur auf Aufträge gebuchte Stunden zählen als produktiv. Über 100 % bedeutet Überstunden."
>
<AuslastungsBalken
zeilen={monteureAktiv.slice(0, 6).map((t) => ({
zeilen={d.monteureAktiv.slice(0, 6).map((t) => ({
name: t.mitarbeiter.name,
wert: t.auslastungProzent,
zusatz: t.mitarbeiter.gewerk,
@@ -255,11 +233,11 @@ export function UebersichtSeite() {
<ChartCard
id="uebersicht-ueberfaellig"
titel={`Aufträge über Termin (${ueberfaellig.length})`}
titel={`Aufträge über Termin (${d.ueberfaellige.length})`}
untertitel="Fälligkeitsdatum überschritten, noch nicht abgeschlossen"
>
<DataTable
zeilen={ueberfaellig}
zeilen={d.ueberfaellige}
spalten={auftragSpalten}
proSeite={6}
suchFelder={(a) => `${a.titel} ${a.nummer} ${a.gewerk}`}