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
252 lines
8.9 KiB
TypeScript
252 lines
8.9 KiB
TypeScript
"use client";
|
|
|
|
import React from "react";
|
|
import { PageHeader } from "../components/layout/PageHeader";
|
|
import { PageContainer, Raster } from "../components/layout/PageContainer";
|
|
import { AnalyticsToolbar } from "../components/filters/AnalyticsToolbar";
|
|
import { KPICard } from "../components/cards/KPICard";
|
|
import { ChartCard } from "../components/cards/ChartCard";
|
|
import { AlertList } from "../components/cards/AlertList";
|
|
import { StatZeile } from "../components/cards/StatZeile";
|
|
import { AreaVerlauf } from "../components/charts/AreaVerlauf";
|
|
import { BalkenHorizontal } from "../components/charts/BalkenHorizontal";
|
|
import { AuslastungsBalken } from "../components/charts/AuslastungsBalken";
|
|
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 {
|
|
berechneTrend,
|
|
formatEuro,
|
|
formatEuroAchse,
|
|
formatEuroKompakt,
|
|
formatProzent,
|
|
formatZahl,
|
|
tageSeit,
|
|
tageLabel,
|
|
formatTage,
|
|
} from "../utils/formatters";
|
|
import { HEUTE } from "../utils/dateUtils";
|
|
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({
|
|
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>[] = [
|
|
{
|
|
key: "nummer",
|
|
titel: "Auftrag",
|
|
breite: "26%",
|
|
zelle: (a) => (
|
|
<div className="flex flex-col">
|
|
<span className="font-medium">{a.titel}</span>
|
|
<span className="text-[11px] text-text-neutral-tertiary">{a.nummer}</span>
|
|
</div>
|
|
),
|
|
sortWert: (a) => a.nummer,
|
|
},
|
|
{
|
|
key: "gewerk",
|
|
titel: "Gewerk",
|
|
zelle: (a) => <span className="text-text-neutral-secondary">{a.gewerk}</span>,
|
|
sortWert: (a) => a.gewerk,
|
|
},
|
|
{ key: "status", titel: "Status", zelle: (a) => <AuftragBadge status={a.status} /> },
|
|
{
|
|
key: "faellig",
|
|
titel: "Fällig seit",
|
|
numerisch: true,
|
|
zelle: (a) => (
|
|
<span className="font-medium" style={{ color: STATUS_TEXT.negativ }}>
|
|
{tageLabel(tageSeit(a.faelligAm, HEUTE))}
|
|
</span>
|
|
),
|
|
sortWert: (a) => tageSeit(a.faelligAm, HEUTE),
|
|
},
|
|
{
|
|
key: "wert",
|
|
titel: "Wert",
|
|
numerisch: true,
|
|
zelle: (a) => formatEuro(a.wert),
|
|
sortWert: (a) => a.wert,
|
|
},
|
|
];
|
|
|
|
return (
|
|
<>
|
|
<PageHeader
|
|
titel="Übersicht"
|
|
beschreibung="Die Kennzahlen, nach denen der Betrieb gesteuert wird — Umsatz, Auslastung, offene Posten und Handlungsbedarf."
|
|
/>
|
|
<AnalyticsToolbar seite="uebersicht" optionen={optionen} />
|
|
|
|
<PageContainer>
|
|
<Raster spalten={5}>
|
|
<KPICard
|
|
label="Umsatz (Zahlungseingang)"
|
|
wert={formatEuro(d.umsatzAktuell)}
|
|
zusatz={`Deckungsbeitrag ${formatProzent(d.margeProzent)}`}
|
|
trend={berechneTrend(d.umsatzAktuell, d.umsatzVorher)}
|
|
icon="Euro"
|
|
verlauf={d.sparkline}
|
|
/>
|
|
<KPICard
|
|
label="Offene Forderungen"
|
|
wert={formatEuro(d.posten.gesamt)}
|
|
zusatz={`${d.posten.anzahl} Rechnungen · ${d.posten.ueberfaelligAnzahl} überfällig`}
|
|
icon="FileText"
|
|
bezug="stichtag"
|
|
akzent={d.posten.ueberfaelligAnzahl > 0 ? "warnung" : "neutral"}
|
|
/>
|
|
<KPICard
|
|
label="Aktive Aufträge"
|
|
wert={formatZahl(d.aktiveAuftraege.length)}
|
|
zusatz={`${formatEuro(d.auftragsbestand)} Auftragsbestand`}
|
|
icon="ClipboardList"
|
|
bezug="stichtag"
|
|
/>
|
|
<KPICard
|
|
label="Ø Auslastung Monteure"
|
|
wert={formatProzent(d.durchschnittAuslastung, 0)}
|
|
zusatz={`${d.monteureAktiv.length} Personen im Einsatz`}
|
|
icon="HardHat"
|
|
akzent={d.durchschnittAuslastung > 95 ? "warnung" : d.durchschnittAuslastung < 70 ? "info" : "positiv"}
|
|
/>
|
|
<KPICard
|
|
label="Neue Kunden"
|
|
wert={formatZahl(d.neueKunden)}
|
|
zusatz={`${formatZahl(d.kundenMitAuftrag)} Kunden mit Auftrag insgesamt`}
|
|
trend={berechneTrend(d.neueKunden, d.neueKundenVorher)}
|
|
icon="Users"
|
|
/>
|
|
</Raster>
|
|
|
|
<ChartCard
|
|
id="uebersicht-handlungsbedarf"
|
|
titel="Handlungsbedarf"
|
|
untertitel="Sortiert nach Dringlichkeit — jede Zeile führt in die zugehörige Arbeitsliste"
|
|
>
|
|
<AlertList eintraege={d.alerts} spalten={2} />
|
|
</ChartCard>
|
|
|
|
<div className="grid grid-cols-1 items-start gap-4 xl:grid-cols-3">
|
|
<ChartCard
|
|
id="uebersicht-umsatzverlauf"
|
|
titel="Zahlungseingang im Zeitverlauf"
|
|
untertitel="Aktueller Zeitraum gegen den Vorjahreszeitraum"
|
|
hinweis="Gezählt wird der Tag des Zahlungseingangs, nicht das Rechnungsdatum. Dadurch entspricht die Kurve dem tatsächlichen Geldfluss."
|
|
className="xl:col-span-2"
|
|
legende={
|
|
<ChartLegende
|
|
eintraege={[
|
|
{ name: "Aktueller Zeitraum", farbe: PRIMAER_FARBE },
|
|
{ name: "Vorjahr", farbe: VERGLEICH_FARBE, gestrichelt: true },
|
|
]}
|
|
/>
|
|
}
|
|
>
|
|
<AreaVerlauf
|
|
daten={d.verlauf}
|
|
formatWert={formatEuroKompakt}
|
|
formatAchse={formatEuroAchse}
|
|
zeigeVergleich
|
|
hoehe={268}
|
|
/>
|
|
<StatZeile
|
|
spalten={3}
|
|
eintraege={[
|
|
{ label: "Vorperiode", wert: formatEuro(d.umsatzVorher) },
|
|
{
|
|
label: "Ø Auftragswert",
|
|
wert: formatEuro(d.durchschnittAuftragswert),
|
|
},
|
|
{ label: "Ø Zahlungsdauer", wert: formatTage(d.zahlungsdauerTage) },
|
|
]}
|
|
/>
|
|
</ChartCard>
|
|
|
|
<ChartCard
|
|
id="uebersicht-gewerke"
|
|
titel="Umsatz nach Gewerk"
|
|
untertitel="Zahlungseingang im gewählten Zeitraum"
|
|
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={d.gewerkUmsatz}
|
|
formatWert={formatEuroKompakt}
|
|
einfarbig={false}
|
|
/>
|
|
</ChartCard>
|
|
</div>
|
|
|
|
<div className="grid grid-cols-1 items-start gap-4 lg:grid-cols-2">
|
|
<ChartCard
|
|
id="uebersicht-trichter"
|
|
titel="Vertriebstrichter"
|
|
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={d.trichter} formatWert={(w) => formatZahl(w)} />
|
|
</ChartCard>
|
|
|
|
<ChartCard
|
|
id="uebersicht-auslastung"
|
|
titel="Auslastung Monteure"
|
|
untertitel="Produktive Stunden gegen verfügbare Stunden"
|
|
hinweis="Nur auf Aufträge gebuchte Stunden zählen als produktiv. Über 100 % bedeutet Überstunden."
|
|
>
|
|
<AuslastungsBalken
|
|
zeilen={d.monteureAktiv.slice(0, 6).map((t) => ({
|
|
name: t.mitarbeiter.name,
|
|
wert: t.auslastungProzent,
|
|
zusatz: t.mitarbeiter.gewerk,
|
|
}))}
|
|
/>
|
|
</ChartCard>
|
|
|
|
</div>
|
|
|
|
<ChartCard
|
|
id="uebersicht-ueberfaellig"
|
|
titel={`Aufträge über Termin (${d.ueberfaellige.length})`}
|
|
untertitel="Fälligkeitsdatum überschritten, noch nicht abgeschlossen"
|
|
>
|
|
<DataTable
|
|
zeilen={d.ueberfaellige}
|
|
spalten={auftragSpalten}
|
|
proSeite={6}
|
|
suchFelder={(a) => `${a.titel} ${a.nummer} ${a.gewerk}`}
|
|
leerText="Kein Auftrag ist über Termin — sehr gut."
|
|
/>
|
|
</ChartCard>
|
|
|
|
</PageContainer>
|
|
</>
|
|
);
|
|
}
|