Files
Dashboard/features/dashboard/hooks/useAnalyseDaten.ts
T
dejanandClaude Opus 5 b8bf987d0e feat(dashboard): Analytics-Dashboard als Gestaltungsvorlage zur Übergabe
UI/UX-Prototyp der Analytics-Dashboards in HiveGrid, fachlich auf einen
SHK-/Handwerksbetrieb zugeschnitten. Ziel ist die Übergabe an die Entwicklung,
nicht der Produktivbetrieb.

Inhalt: sechs Seiten (Übersicht, Finanzen, Aufträge, Kunden, Team, Komponenten),
26 KPIs, neun Chart-Bausteine, Filtersystem mit seitenabhängiger Relevanz und ein
deterministischer Demo-Datensatz (420 Kunden, 1.900 Aufträge, Stichtag 30.07.2026).

Drei Quellen sind zusammengeführt: die fachliche Planung mit dem Branchenpartner
(Januar 2026), die Subframe-Komponentenbibliothek aus dem HiveGrid-Pitch und
IBM Carbon Data Visualization für die Diagrammregeln. Herkunft und bewusste
Abweichungen stehen in docs/HERKUNFT.md.

Dokumentation: README, HANDOVER (was echte Logik braucht), docs/DESIGN-SYSTEM,
KPI-KATALOG, DATENMODELL, NAVIGATION, HERKUNFT, ZIELSYSTEM (Einbauort in
HiveGrid Cloud) und LEITPLANKEN (welche Cloud-Screens als Vorbild taugen).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
2026-08-29 17:25:20 +02:00

31 lines
1.1 KiB
TypeScript

"use client";
import React from "react";
import { DATENSATZ } from "../data/seed";
import { wendeFilterAn, wirksameFilter, type SeitenId } from "../data/filtering";
import { useFilter } from "../context/FilterContext";
import type { Datensatz, FilterState } from "../data/types";
/**
* Liefert den auf die aktive Filterauswahl zugeschnittenen Datensatz.
*
* `daten` — gefiltert nach den auf dieser Seite wirksamen Dimensionen
* `filter` — die tatsächlich wirksamen Filter (irrelevante sind neutralisiert)
*
* Der Zeitraum steckt bewusst nur im Filter, nicht im Datensatz: Manche
* Kennzahlen sind zeitraumbezogen (Umsatz), andere stichtagsbezogen
* (offene Posten). Die Berechnungen entscheiden das jeweils selbst.
*/
export function useAnalyseDaten(seite: SeitenId): {
daten: Datensatz;
filter: FilterState;
gesamt: Datensatz;
} {
const { filter } = useFilter();
const wirksam = React.useMemo(() => wirksameFilter(filter, seite), [filter, seite]);
const daten = React.useMemo(() => wendeFilterAn(DATENSATZ, wirksam), [wirksam]);
return { daten, filter: wirksam, gesamt: DATENSATZ };
}