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"
/>