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
This commit is contained in:
commit
b8bf987d0e
250 files changed
+33153
No files matched your search
@@ -0,0 +1,69 @@
|
||||
"use client";
|
||||
|
||||
import React from "react";
|
||||
import { erstellePersistentenStore } from "./persistenterStore";
|
||||
|
||||
/**
|
||||
* Sichtbarkeit einzelner Widgets.
|
||||
*
|
||||
* Jede Karte hat eine stabile ID; über das ⋯-Menü lässt sie sich ausblenden.
|
||||
* Ausgeblendete Karten sammelt die Filterleiste und macht sie einzeln oder
|
||||
* gesammelt wieder sichtbar. Der Zustand überlebt einen Reload.
|
||||
*/
|
||||
|
||||
interface WidgetState {
|
||||
versteckt: string[];
|
||||
/** Titel für die "wieder einblenden"-Liste. */
|
||||
titel: Record<string, string>;
|
||||
}
|
||||
|
||||
const STANDARD: WidgetState = { versteckt: [], titel: {} };
|
||||
|
||||
const store = erstellePersistentenStore<WidgetState>("hivegrid.analytics.widgets.v1", STANDARD);
|
||||
|
||||
interface WidgetContextValue extends WidgetState {
|
||||
istSichtbar: (id: string) => boolean;
|
||||
verstecke: (id: string, titel: string) => void;
|
||||
zeige: (id: string) => void;
|
||||
zeigeAlle: () => void;
|
||||
}
|
||||
|
||||
const WidgetContext = React.createContext<WidgetContextValue | null>(null);
|
||||
|
||||
export function WidgetProvider({ children }: { children: React.ReactNode }) {
|
||||
const zustand = React.useSyncExternalStore(
|
||||
store.subscribe,
|
||||
store.getSnapshot,
|
||||
store.getServerSnapshot
|
||||
);
|
||||
|
||||
const wert = React.useMemo<WidgetContextValue>(
|
||||
() => ({
|
||||
versteckt: zustand.versteckt,
|
||||
titel: zustand.titel,
|
||||
istSichtbar: (id) => !zustand.versteckt.includes(id),
|
||||
verstecke: (id, kartenTitel) =>
|
||||
store.setzen((aktuell) => ({
|
||||
versteckt: aktuell.versteckt.includes(id)
|
||||
? aktuell.versteckt
|
||||
: [...aktuell.versteckt, id],
|
||||
titel: { ...aktuell.titel, [id]: kartenTitel },
|
||||
})),
|
||||
zeige: (id) =>
|
||||
store.setzen((aktuell) => ({
|
||||
...aktuell,
|
||||
versteckt: aktuell.versteckt.filter((eintrag) => eintrag !== id),
|
||||
})),
|
||||
zeigeAlle: () => store.setzen((aktuell) => ({ ...aktuell, versteckt: [] })),
|
||||
}),
|
||||
[zustand]
|
||||
);
|
||||
|
||||
return <WidgetContext.Provider value={wert}>{children}</WidgetContext.Provider>;
|
||||
}
|
||||
|
||||
export function useWidgets(): WidgetContextValue {
|
||||
const ctx = React.useContext(WidgetContext);
|
||||
if (!ctx) throw new Error("useWidgets muss innerhalb von <WidgetProvider> verwendet werden");
|
||||
return ctx;
|
||||
}
|
||||
Reference in new issue
Block a user