dejanandClaude Opus 5
b8bf987d0e
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
100 lines
4.0 KiB
Markdown
100 lines
4.0 KiB
Markdown
# Datenmodell
|
|
|
|
Definiert in `features/dashboard/data/types.ts`, erzeugt in `data/seed.ts`.
|
|
Die Struktur ist bewusst nah an den HiveGrid-Entities gehalten, damit beim
|
|
Einbau nur die Datenquelle getauscht werden muss.
|
|
|
|
---
|
|
|
|
## Zuordnung zu HiveGrid
|
|
|
|
| Prototyp | HiveGrid-Entity | Verwendete Felder |
|
|
|---|---|---|
|
|
| `Rechnung` | `invoice` | `amount`, `status`, `issuedAt`, `dueDate`, bezahlt-am |
|
|
| `Auftrag` | `order` | `totalValue`, `status`, `startDate`, `endDate`, Gewerk, Marge, Förderung |
|
|
| `Kunde` | `company` | `name`, `source`, `createdAt`, Typ, Region |
|
|
| `Mitarbeiter` | `TenantUser` + `User` | Name, Rolle, Gewerk, Status, Wochenstunden |
|
|
| `Zeiteintrag` | `timeEntry` | `hours`, `date`, Auftragsbezug, Abwesenheitsgrund |
|
|
|
|
**Felder, die es so noch nicht gibt** und beim Einbau ergänzt werden müssen:
|
|
|
|
| Feld | Wo | Wofür |
|
|
|---|---|---|
|
|
| `gewerk` | Auftrag, Mitarbeiter | Alle Gewerke-Auswertungen und der Gewerk-Filter |
|
|
| `margeProzent` | Auftrag | Deckungsbeitrag |
|
|
| `foerderung` / `foerderbetrag` | Auftrag | Förderquote BAFA/KfW |
|
|
| `verlorenAb` | Auftrag | Ehrlicher Vertriebstrichter (siehe unten) |
|
|
| `ueberAngebot` | Auftrag | Trennt Angebotsgeschäft von Direktaufträgen |
|
|
| `wochenstunden` | Mitarbeiter | Auslastungsberechnung |
|
|
| `zahlungsmoralTage` | Kunde | Auffällige Zahlungsmoral (auch aus Rechnungen ableitbar) |
|
|
|
|
---
|
|
|
|
## Statuswerte
|
|
|
|
**Auftrag:** `anfrage` → `aufmass` → `angebot` → `beauftragt` → `in_arbeit` →
|
|
`abgeschlossen`, dazu `verloren` als Endzustand.
|
|
|
|
`verlorenAb` hält fest, welche Stufe ein verlorener Vorgang zuletzt erreicht
|
|
hat. Ohne dieses Feld müsste der Trichter raten und würde die oberen Stufen
|
|
systematisch zu klein zeigen.
|
|
|
|
`ueberAngebot` trennt das Angebotsgeschäft (ab etwa 6.000 €) von Aufträgen, die
|
|
direkt beauftragt werden — Wartung, Notdienst, E-Check. Trichter und
|
|
Abschlussquote beziehen sich ausschließlich auf das Angebotsgeschäft.
|
|
|
|
**Rechnung:** `entwurf` · `gestellt` · `bezahlt` · `ueberfaellig`.
|
|
|
|
---
|
|
|
|
## Gewerke und Leistungsarten
|
|
|
|
| Gewerk | Leistungsarten |
|
|
|---|---|
|
|
| Heizung | Wärmepumpe, Gastherme, Heizkörper, Wartung |
|
|
| Sanitär | Bad-Sanierung, Rohrleitungen, Armaturen, Notdienst |
|
|
| Klima & Lüftung | Splitgerät, Lüftungsanlage, Kanalreinigung, Wartung |
|
|
| Photovoltaik | PV-Anlage, Batteriespeicher, Wallbox, Wartung |
|
|
| Elektro | Elektroinstallation, Zählerschrank, Smart Home, E-Check |
|
|
|
|
Förderfähig (BAFA/KfW) sind Wärmepumpe, PV-Anlage, Batteriespeicher und
|
|
Lüftungsanlage.
|
|
|
|
---
|
|
|
|
## Der Demo-Datensatz
|
|
|
|
Erzeugt mit festem Seed (`mulberry32`, Seed `20260730`) — die Zahlen bleiben
|
|
über Reloads und Screenshots identisch. Bezugsdatum ist der **30.07.2026**
|
|
(`HEUTE` in `utils/dateUtils.ts`).
|
|
|
|
Fiktiver Betrieb: **Meister Krause GmbH**, Raum Rhein-Main, 24 Beschäftigte
|
|
(3 Meister, 14 Monteure, 3 Auszubildende, 4 Büro).
|
|
|
|
| Größe | Wert |
|
|
|---|---|
|
|
| Kunden | 420 |
|
|
| Aufträge (24 Monate) | 1.900 |
|
|
| Rechnungen | ~1.270 |
|
|
| Zeiteinträge (12 Wochen) | ~1.500 |
|
|
| Jahresumsatz | ~2,4 Mio. € |
|
|
| Offene Forderungen | ~230 T€ |
|
|
| Abschlussquote (Angebotsgeschäft) | ~38 % |
|
|
| Ø Auslastung | ~73 % |
|
|
|
|
**Eingebaute Effekte**, damit die Charts nicht künstlich flach aussehen:
|
|
|
|
- **Saisonalität** — Heizung und Lüftung ziehen von September bis Februar an,
|
|
der Hochsommer ist schwächer (`SAISON_INDEX`)
|
|
- **Wachstum** — rund 12 % gegenüber dem Vorjahr
|
|
- **Größenabhängige Abschlussquote** — Wartung und Notdienst werden fast immer
|
|
ausgeführt, große Anlagen dagegen verglichen und häufiger verloren
|
|
- **Zahlungsverhalten** — die Mehrheit zahlt nahe am Zahlungsziel (21 Tage),
|
|
ein kleiner Rest wird zum Mahnfall; Forderungen älter als sieben Monate sind
|
|
eingebracht oder ausgebucht und stehen nicht mehr in der offenen Liste
|
|
- **Förderanträge** — nur bei Vorgängen der letzten rund 100 Tage offen; ein
|
|
Bescheid dauert Wochen, nicht Jahre
|
|
|
|
Diese Effekte sind fachlich begründet, nicht kosmetisch: Ein gleichverteilter
|
|
Zufallsdatensatz erzeugt Charts, an denen sich keine Gestaltung prüfen lässt.
|