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:
1 parent
b8bf987d0e
commit
99be627dad
28 files changed
+1030
-340
No files matched your search
@@ -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>
|
||||
|
||||
Reference in new issue
Block a user