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

+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}`}