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
@@ -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}`}
|
||||
|
||||
Reference in new issue
Block a user