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

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