Geviertstriche aus Text, Kommentaren und Doku entfernen
467 Stellen. Nicht durch einen anderen Strich ersetzt, sondern durch das
Satzzeichen, das an der jeweiligen Stelle richtig ist: Doppelpunkt, wo eine
Erlaeuterung folgt; Komma, wo der Satz weiterlaeuft; Punkt, wo zwei
Hauptsaetze aneinanderstiessen. Ein Halbgeviertstrich waere nur derselbe
Griff mit kuerzerem Strich gewesen.
Regelbasiert ersetzt und danach nachgeprueft, weil eine Regel allein nicht
reicht. Gefunden und einzeln korrigiert:
- Eingeschobene Saetze mit Strichpaar. Nur der oeffnende Strich passte ins
Muster, der schliessende blieb als "—," stehen. Drei Stellen, jetzt mit
Klammern oder als eigener Satz.
- Doppelte Doppelpunkte, wo beide Striche eines Paars zu Doppelpunkten wurden
("Globale Regeln: Schrift, Groessen, Abstaende: kommen aus HiveGrid").
Sieben Stellen in Doku und Oberflaeche, jetzt in Klammern.
- Pfade, denen ein Komma statt eines Doppelpunkts folgte.
- Ausgerichtete Kommentartabellen, in denen der Strich eine Spalte war.
Nicht angefasst: drei Geviertstriche, die keine Prosa sind, sondern
Tabellenplatzhalter fuer "kein Wert" (Trichter, Auftraege, Kunden). Dort ist
der Strich die Angabe selbst; ihn zu entfernen liesse leere Zellen zurueck.
tsc, lint, build, verify:carbon und verify:layout laufen sauber.
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
e998231fed
commit
6a0b36ddcc
75 files changed
+471
-471
No files matched your search
@@ -1,12 +1,12 @@
|
||||
# HiveGrid Analytics Dashboard — UI/UX-Prototyp
|
||||
# HiveGrid Analytics Dashboard: UI/UX-Prototyp
|
||||
|
||||
Gestaltungsvorlage für die Analytics-Dashboards in HiveGrid, fachlich auf einen
|
||||
SHK-/Handwerksbetrieb zugeschnitten. **Ziel dieses Repos ist die Übergabe an die
|
||||
Entwicklung** — nicht der Produktivbetrieb.
|
||||
Entwicklung**, nicht der Produktivbetrieb.
|
||||
|
||||
> **Zwei Features, nicht eines.** „Analytics" ist der Analysebereich mit fünf
|
||||
> Seiten und einem seitenweiten Filter; „Dashboard" ist der
|
||||
> Begrüßungsbildschirm — eine Seite aus Kacheln, jede mit eigenem Zeitraum. Es
|
||||
> Begrüßungsbildschirm, eine Seite aus Kacheln, jede mit eigenem Zeitraum. Es
|
||||
> zeigt die wichtigsten Auswertungen **plus** anderes (HR-Anträge, Aufgaben,
|
||||
> Termine), das noch nicht gebaut ist und im Raster als reservierte Plätze
|
||||
> steht. Beide sind gestaltet; offen ist, was aus der Analytics-Übersichtsseite
|
||||
@@ -25,14 +25,14 @@ npm run dev # http://localhost:4300 → leitet auf /dashboard
|
||||
|
||||
| Bereich | Inhalt |
|
||||
|---|---|
|
||||
| **5 Analyse-Seiten** | Übersicht, Finanzen, Aufträge, Kunden, Team — als Reiter im Menüpunkt **Analytics** |
|
||||
| **5 Analyse-Seiten** | Übersicht, Finanzen, Aufträge, Kunden, Team, als Reiter im Menüpunkt **Analytics** |
|
||||
| **Seitenleiste** | spiegelt die von HiveGrid Cloud (dieselbe Komponente, dieselben Gruppen) |
|
||||
| **26 KPIs** | vollständig definiert in [`docs/KPI-KATALOG.md`](docs/KPI-KATALOG.md) |
|
||||
| **9 Chart-Bausteine** | Fläche, Säulen, liegende Balken, Ring, Trichter, Auslastung, Sparkline, Legende, Leerzustand |
|
||||
| **Filtersystem** | Zeitraum + 5 Dimensionen, seitenabhängig relevant, in localStorage persistiert |
|
||||
| **Demo-Datensatz** | deterministisch erzeugt: 420 Kunden, 1.900 Aufträge, ~1.260 Rechnungen, 2,4 Mio. € Jahresumsatz |
|
||||
|
||||
Alles ist deutschsprachig, weil die Oberfläche deutschsprachig ist — inklusive
|
||||
Alles ist deutschsprachig, weil die Oberfläche deutschsprachig ist: inklusive
|
||||
Bezeichner im Code. Das erspart beim Einbau die ständige Übersetzung zwischen
|
||||
`revenue` und „Umsatz".
|
||||
|
||||
@@ -41,7 +41,7 @@ Bezeichner im Code. Das erspart beim Einbau die ständige Übersetzung zwischen
|
||||
## Wo was liegt
|
||||
|
||||
```
|
||||
app/ Next.js App Router — je Seite nur ein Wrapper
|
||||
app/ Next.js App Router: je Seite nur ein Wrapper
|
||||
features/dashboard/
|
||||
routes/ Verdrahtung Store → View-Model → Seite (wird beim
|
||||
Einbau durch den Loader ersetzt)
|
||||
@@ -57,7 +57,7 @@ features/dashboard/
|
||||
data/ types · seed (Dummy-Daten) · calculations · filtering
|
||||
· nutzer (Attrappe des angemeldeten Benutzers)
|
||||
hooks/ useAnalyseDaten, useIstSchmal
|
||||
pages/ die sechs Seiten — reine Komponenten ({ vm })
|
||||
pages/ die sechs Seiten: reine Komponenten ({ vm })
|
||||
utils/ chartTheme (Carbon-Tokens), formatters, dateUtils
|
||||
ui/ Subframe-Komponentenbibliothek (unverändert übernommen)
|
||||
docs/ Design-System, KPI-Katalog, Navigation, Datenmodell,
|
||||
@@ -70,7 +70,7 @@ scripts/verify-layout.mjs misst Textkollisionen über alle Seiten und Breite
|
||||
(jede Kennzahl als reine Funktion) und `features/dashboard/view-models/`
|
||||
(je Seite ein reiner Builder `(daten, filter) → VMState<…>`).
|
||||
|
||||
Die Seiten unter `pages/` sind **reine Komponenten** — sie bekommen ihr
|
||||
Die Seiten unter `pages/` sind **reine Komponenten**, sie bekommen ihr
|
||||
View-Model als Prop und greifen auf keinen Store zu. Das ist genau das Muster,
|
||||
das HiveGrid Cloud verlangt (`<XPage vm={} actions={} />`): Beim Einbau tritt der
|
||||
Loader an die Stelle des Containers unter `routes/`, die Seiten selbst bleiben
|
||||
@@ -82,15 +82,15 @@ unverändert. Details in [`docs/ZIELSYSTEM.md`](docs/ZIELSYSTEM.md) Abschnitt 3.
|
||||
|
||||
Drei Quellen sind hier zusammengeführt:
|
||||
|
||||
1. **Fachliche Planung** (Januar 2026, mit dem Branchenpartner erarbeitet) —
|
||||
1. **Fachliche Planung** (Januar 2026, mit dem Branchenpartner erarbeitet),
|
||||
Seitenschnitt, KPI-Auswahl, Filtersystem, Zahlen- und Spacing-Regeln.
|
||||
2. **Bestehender Pitch-Prototyp** — die Subframe-Komponentenbibliothek unter `ui/`
|
||||
2. **Bestehender Pitch-Prototyp**, die Subframe-Komponentenbibliothek unter `ui/`
|
||||
und die Gestaltungssprache der Oberfläche.
|
||||
3. **IBM Carbon Data Visualization** — Chart-Regeln, Farbpalette, Achsen, Tooltips.
|
||||
3. **IBM Carbon Data Visualization**: Chart-Regeln, Farbpalette, Achsen, Tooltips.
|
||||
Siehe [`docs/DESIGN-SYSTEM.md`](docs/DESIGN-SYSTEM.md).
|
||||
|
||||
Welche Quelle was beigesteuert hat — und an welchen Stellen bewusst von der
|
||||
Januar-Planung abgewichen wurde — steht in [`docs/HERKUNFT.md`](docs/HERKUNFT.md).
|
||||
Welche Quelle was beigesteuert hat, und an welchen Stellen bewusst von der
|
||||
Januar-Planung abgewichen wurde: steht in [`docs/HERKUNFT.md`](docs/HERKUNFT.md).
|
||||
|
||||
---
|
||||
|
||||
@@ -99,7 +99,7 @@ Januar-Planung abgewichen wurde — steht in [`docs/HERKUNFT.md`](docs/HERKUNFT.
|
||||
[`HANDOVER.md`](HANDOVER.md) listet auf, was echte Logik braucht, was bewusst
|
||||
Attrappe ist und in welcher Reihenfolge der Einbau sinnvoll ist.
|
||||
|
||||
Die Seite **/komponenten** zeigt jeden Baustein isoliert mit Dateipfad — der
|
||||
Die Seite **/komponenten** zeigt jeden Baustein isoliert mit Dateipfad, der
|
||||
schnellste Weg, sich zu orientieren.
|
||||
|
||||
```bash
|
||||
@@ -113,10 +113,10 @@ einem Screenshot deshalb unsichtbar bleiben.
|
||||
|
||||
Die Referenzwerte stehen mit Quelle und Version in
|
||||
[`docs/carbon-referenz.json`](docs/carbon-referenz.json), gezogen aus dem
|
||||
ausgelieferten Stylesheet von `@carbon/charts` — nicht aus der Dokumentation,
|
||||
ausgelieferten Stylesheet von `@carbon/charts`, nicht aus der Dokumentation,
|
||||
die an mehreren Stellen davon abweicht.
|
||||
|
||||
Für die Gestaltungsabnahme: [`docs/PRUEFFRAGEN.md`](docs/PRUEFFRAGEN.md) —
|
||||
Für die Gestaltungsabnahme: [`docs/PRUEFFRAGEN.md`](docs/PRUEFFRAGEN.md),
|
||||
Prüffragen mit nachprüfbarem Ja/Nein, für Reviews ohne Designerauge.
|
||||
|
||||
---
|
||||
@@ -124,11 +124,11 @@ Prüffragen mit nachprüfbarem Ja/Nein, für Reviews ohne Designerauge.
|
||||
## Zielsystem
|
||||
|
||||
Eingebaut wird das hier in **HiveGrid Cloud** (`HiveGrid-Cloud`, Gitea
|
||||
`toolctrl-labs`) — die eigentliche Software: pnpm-Monorepo, React Router 7,
|
||||
`toolctrl-labs`), der eigentlichen Software: pnpm-Monorepo, React Router 7,
|
||||
Prisma/Postgres, mandantenfähig. Zielort ist der Tenant-Dashboard-Screen unter
|
||||
`…/<tenant>/dashboard`.
|
||||
|
||||
Dort steht bereits eine Implementierung — bewusst als **Interim-UI**: gebaut aus
|
||||
Dort steht bereits eine Implementierung, bewusst als **Interim-UI**: gebaut aus
|
||||
derselben Subframe-Bibliothek gegen ein stabiles View-Model, damit die
|
||||
Backend-Tickets nicht auf den finalen Screen warten müssen. Die finale Optik ist
|
||||
dort als Nachzug vorgemerkt. Genau die Lücke füllt dieser Prototyp.
|
||||
@@ -137,18 +137,18 @@ Die Ausgangslage ist günstiger als üblich: **dasselbe Subframe-Projekt**
|
||||
(82 der 86 Komponenten identisch benannt) und **dieselbe Chart-Bibliothek**
|
||||
(Recharts). Der Einbau ist ein Port, keine Neuimplementierung.
|
||||
|
||||
Anzupassen sind vor allem vier Dinge — Daten kommen als View-Model-Prop mit fünf
|
||||
Anzupassen sind vor allem vier Dinge: Daten kommen als View-Model-Prop mit fünf
|
||||
Zuständen statt als Import, Texte laufen über i18n, Diagramme brauchen eine
|
||||
Textalternative für Screenreader, und das App-Chrome dieses Prototyps entfällt,
|
||||
weil die Zielanwendung Shell und Sidebar mitbringt.
|
||||
|
||||
**Nicht alles in der Zielanwendung sieht heute final aus.** HiveGrid Cloud
|
||||
arbeitet designer-first: Für jede Phase gibt es einen Brief mit den benötigten
|
||||
UI-Elementen, den finalen Screen entwirft der Designer in Subframe — Layout und
|
||||
UI-Elementen, den finalen Screen entwirft der Designer in Subframe: Layout und
|
||||
Anordnung sind ausdrücklich dessen Entscheidung. Ein großer Teil dieser Screens
|
||||
ist noch offen und läuft bis dahin auf Interim-UI. Für diesen Prototyp heißt
|
||||
das: Verbindlich zu übergeben sind **Kennzahl-Definitionen, Chart-Regeln und
|
||||
Verhalten** — die Pixelanordnung ist ein Vorschlag.
|
||||
Verhalten**, die Pixelanordnung ist ein Vorschlag.
|
||||
|
||||
**Rangfolge:** Wo dieser Prototyp von HiveGrid abweicht, gilt HiveGrid. Schrift,
|
||||
Größen, Abstände, Farben und App-Shell kommen von dort; aus diesem Repo kommen
|
||||
@@ -156,6 +156,6 @@ die Kennzahl-Definitionen, die Diagrammregeln, das Verhalten und die
|
||||
Navigationsstruktur als Verabredung.
|
||||
|
||||
Details, Dateipfade und die konkrete Einbau-Liste stehen in
|
||||
[`docs/ZIELSYSTEM.md`](docs/ZIELSYSTEM.md) — die Rangfolge in Abschnitt 0. Welche Bereiche der Zielanwendung
|
||||
bereits finale Subframe-Screens tragen — und damit als Leitplanke taugen — steht
|
||||
[`docs/ZIELSYSTEM.md`](docs/ZIELSYSTEM.md): die Rangfolge in Abschnitt 0. Welche Bereiche der Zielanwendung
|
||||
bereits finale Subframe-Screens tragen, und damit als Leitplanke taugen: steht
|
||||
in [`docs/LEITPLANKEN.md`](docs/LEITPLANKEN.md).
|
||||
Reference in new issue
Block a user