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
@@ -10,47 +10,34 @@ import { AuslastungsBalken } from "../components/charts/AuslastungsBalken";
|
||||
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 { teamKennzahlen, type MitarbeiterKennzahl } from "../data/calculations";
|
||||
import { formatEuro, formatEuroKompakt, formatProzent, formatStunden, formatZahl } from "../utils/formatters";
|
||||
import { imFenster, zeitfenster } from "../utils/dateUtils";
|
||||
import { SeitenZustand } from "../components/layout/SeitenZustand";
|
||||
import type { VMState } from "../view-models";
|
||||
import type { TeamDaten, TeamZeile } from "../view-models/team.vm";
|
||||
import type { FilterOptionen } from "../view-models/filter-optionen";
|
||||
|
||||
export function TeamSeite() {
|
||||
const { daten, filter } = useAnalyseDaten("team");
|
||||
export function TeamSeite({
|
||||
vm,
|
||||
optionen,
|
||||
}: {
|
||||
vm: VMState<TeamDaten>;
|
||||
optionen: FilterOptionen;
|
||||
}) {
|
||||
if (vm.status !== "ready") {
|
||||
return (
|
||||
<>
|
||||
<PageHeader
|
||||
titel="Team"
|
||||
beschreibung="Auslastung, produktive Stunden und Abschlüsse der Monteure — die Kennzahl hinter der Terminplanung."
|
||||
/>
|
||||
<AnalyticsToolbar seite="team" optionen={optionen} />
|
||||
<SeitenZustand vm={vm} />
|
||||
</>
|
||||
);
|
||||
}
|
||||
const d = vm.data;
|
||||
|
||||
const kennzahlen = teamKennzahlen(
|
||||
daten.mitarbeiter,
|
||||
daten.zeiten,
|
||||
daten.auftraege,
|
||||
filter.zeitraum
|
||||
);
|
||||
const aktive = kennzahlen.filter((k) => k.mitarbeiter.status === "aktiv");
|
||||
|
||||
const durchschnitt =
|
||||
aktive.length > 0 ? aktive.reduce((s, k) => s + k.auslastungProzent, 0) / aktive.length : 0;
|
||||
const stundenGesamt = aktive.reduce((s, k) => s + k.stunden, 0);
|
||||
const produktivGesamt = aktive.reduce((s, k) => s + k.produktivStunden, 0);
|
||||
const produktivQuote = stundenGesamt > 0 ? (produktivGesamt / stundenGesamt) * 100 : 0;
|
||||
|
||||
const fenster = zeitfenster(filter.zeitraum);
|
||||
const abwesenheiten = daten.zeiten.filter(
|
||||
(z) => z.art === "abwesenheit" && imFenster(z.datum, fenster)
|
||||
);
|
||||
const abwesenheitNach = React.useMemo(() => {
|
||||
const zaehler = new Map<string, number>();
|
||||
const label: Record<string, string> = {
|
||||
urlaub: "Urlaub",
|
||||
krank: "Krank",
|
||||
fortbildung: "Fortbildung",
|
||||
};
|
||||
for (const eintrag of abwesenheiten) {
|
||||
const name = label[eintrag.abwesenheitsgrund ?? "sonstige"] ?? "Sonstige";
|
||||
zaehler.set(name, (zaehler.get(name) ?? 0) + eintrag.stunden);
|
||||
}
|
||||
return [...zaehler.entries()].map(([name, value]) => ({ name, value }));
|
||||
}, [abwesenheiten]);
|
||||
|
||||
const spalten: Spalte<MitarbeiterKennzahl & { id: string }>[] = [
|
||||
const spalten: Spalte<TeamZeile>[] = [
|
||||
{
|
||||
key: "name",
|
||||
titel: "Mitarbeiter",
|
||||
@@ -134,47 +121,45 @@ export function TeamSeite() {
|
||||
},
|
||||
];
|
||||
|
||||
const tabellenZeilen = kennzahlen.map((k) => ({ ...k, id: k.mitarbeiter.id }));
|
||||
|
||||
return (
|
||||
<>
|
||||
<PageHeader
|
||||
titel="Team"
|
||||
beschreibung="Auslastung, produktive Stunden und Abschlüsse der Monteure — die Kennzahl hinter der Terminplanung."
|
||||
/>
|
||||
<AnalyticsToolbar seite="team" />
|
||||
<AnalyticsToolbar seite="team" optionen={optionen} />
|
||||
|
||||
<PageContainer>
|
||||
<Raster spalten={5}>
|
||||
<KPICard
|
||||
label="Im Einsatz"
|
||||
wert={formatZahl(aktive.length)}
|
||||
zusatz={`von ${formatZahl(kennzahlen.length)} gewerblich Beschäftigten`}
|
||||
wert={formatZahl(d.aktive.length)}
|
||||
zusatz={`von ${formatZahl(d.mitarbeiterGesamt)} gewerblich Beschäftigten`}
|
||||
icon="HardHat"
|
||||
bezug="stichtag"
|
||||
/>
|
||||
<KPICard
|
||||
label="Ø Auslastung"
|
||||
wert={formatProzent(durchschnitt, 0)}
|
||||
wert={formatProzent(d.durchschnittAuslastung, 0)}
|
||||
zusatz="Produktive Stunden zu verfügbaren"
|
||||
icon="Activity"
|
||||
akzent={durchschnitt > 95 ? "warnung" : "positiv"}
|
||||
akzent={d.durchschnittAuslastung > 95 ? "warnung" : "positiv"}
|
||||
/>
|
||||
<KPICard
|
||||
label="Produktivquote"
|
||||
wert={formatProzent(produktivQuote, 0)}
|
||||
wert={formatProzent(d.produktivQuote, 0)}
|
||||
zusatz="Anteil auftragsbezogener Stunden"
|
||||
icon="Target"
|
||||
/>
|
||||
<KPICard
|
||||
label="Erfasste Stunden"
|
||||
wert={formatStunden(stundenGesamt)}
|
||||
zusatz={`${formatStunden(produktivGesamt)} auf Aufträge gebucht`}
|
||||
wert={formatStunden(d.stundenGesamt)}
|
||||
zusatz={`${formatStunden(d.produktivGesamt)} auf Aufträge gebucht`}
|
||||
icon="Clock"
|
||||
/>
|
||||
<KPICard
|
||||
label="Abwesenheit"
|
||||
wert={formatStunden(abwesenheiten.reduce((s, a) => s + a.stunden, 0))}
|
||||
wert={formatStunden(d.abwesenheitStunden)}
|
||||
zusatz="Urlaub, Krankheit, Fortbildung"
|
||||
icon="CalendarOff"
|
||||
richtungGut="negativ"
|
||||
@@ -188,7 +173,7 @@ export function TeamSeite() {
|
||||
hinweis="Werte über 100 % bedeuten Überstunden. Dauerhaft über 95 % ist ein Warnsignal für Terminrisiken."
|
||||
>
|
||||
<AuslastungsBalken
|
||||
zeilen={aktive.map((k) => ({
|
||||
zeilen={d.aktive.map((k) => ({
|
||||
name: k.mitarbeiter.name,
|
||||
wert: k.auslastungProzent,
|
||||
zusatz: `${k.mitarbeiter.rolle} · ${k.mitarbeiter.gewerk}`,
|
||||
@@ -205,7 +190,7 @@ export function TeamSeite() {
|
||||
hinweis="Der Balken zeigt die Anzahl — sie ist die vergleichbare Größe. Der Auftragswert steht daneben, ist aber ausdrücklich kein Leistungsvergleich: Ein Wärmepumpen-Auftrag ist um ein Vielfaches größer als eine Wartung."
|
||||
>
|
||||
<BalkenHorizontal
|
||||
daten={aktive.map((k) => ({
|
||||
daten={d.aktive.map((k) => ({
|
||||
name: k.mitarbeiter.name,
|
||||
value: k.abgeschlossen,
|
||||
zweitwert: k.umsatz,
|
||||
@@ -222,7 +207,7 @@ export function TeamSeite() {
|
||||
untertitel="Stunden im gewählten Zeitraum"
|
||||
>
|
||||
<Donut
|
||||
daten={abwesenheitNach}
|
||||
daten={d.abwesenheitNach}
|
||||
formatWert={(w) => formatStunden(w)}
|
||||
hoehe={210}
|
||||
mitteLabel="Stunden"
|
||||
@@ -236,7 +221,7 @@ export function TeamSeite() {
|
||||
untertitel="Alle gewerblich Beschäftigten mit Kennzahlen"
|
||||
>
|
||||
<DataTable
|
||||
zeilen={tabellenZeilen}
|
||||
zeilen={d.zeilen}
|
||||
spalten={spalten}
|
||||
proSeite={10}
|
||||
suchFelder={(k) => `${k.mitarbeiter.name} ${k.mitarbeiter.rolle} ${k.mitarbeiter.gewerk}`}
|
||||
|
||||
Reference in new issue
Block a user