docs: Rangfolge beim Einbau festhalten — HiveGrid gewinnt

Klarstellung, damit beim Port keine globalen Regeln aus diesem Repo in die
Software wandern.

Verbindlich ist aus diesem Repo nur das Analytics-Eigene und das Fachliche:
Kennzahl-Definitionen, Diagrammregeln, Verhalten — und die Navigationsstruktur
als Verabredung (zwei Einträge in der Seitenleiste, Analytics mit innerer
Leiste).

Nicht verbindlich ist alles Globale: Schrift, Schriftgrößen, Abstände, Farben,
Radien, Control-Höhen, App-Shell, Kopfzeile, i18n, Formatierung. Das kommt
ausschließlich aus HiveGrid. Dass dieser Prototyp dieselbe Schrift, dieselbe
Seitenleisten-Komponente und dieselben Token benutzt, dient allein der
Lesbarkeit neben der Software — es ist keine Vorlage, an der sich die Software
auszurichten hätte. Weicht ein Wert hier von HiveGrid ab, ist der Wert hier
falsch.

Ebenso festgehalten, was Gerüst ist und wegfällt: AppShell, unsere Kopie der
Seitenleiste, PageHeader, die Kopfzeile, die Routen unter app/ und die
Dashboard-Platzhalterseite. Der Nachbau der inneren Leiste wird nicht portiert;
in HiveGrid entsteht sie über das dortige SidebarIconsLayout.

Vermerkt in ZIELSYSTEM.md (neuer Abschnitt 0 mit Zuständigkeitstabelle), im
Kopf von HANDOVER.md und README.md, bei der Struktur in NAVIGATION.md, als
Vorbemerkung zu den bewussten Abweichungen in LEITPLANKEN.md — und als
Kommentarblock in AppShell.tsx und AnalyticsInnerNav.tsx, weil beim Port oft
zuerst der Code gelesen wird.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
This commit is contained in:
dejanandClaude Opus 5 committed 2026-08-29 21:11:43 +02:00
1 parent 9eec855f57
commit b3d71c1f19
7 files changed
+109 -2

No files matched your search

+8
View File
@@ -190,6 +190,14 @@ lieber neu zählen.
## 6. Wo dieser Prototyp bewusst abweicht
> Vorab, damit die folgende Tabelle nicht falsch gelesen wird: **Eine bewusste
> Abweichung ist eine Bitte um eine Entscheidung, kein Freibrief.** Bei
> globalen Regeln — Schrift, Größen, Abstände, Farben, Control-Höhen — gilt
> ohne Diskussion HiveGrid. Die Punkte unten betreffen ausschließlich den
> Analytics-Bereich und sind begründet, damit sie beim Einbau nicht
> versehentlich „korrigiert" werden. Rangfolge: [ZIELSYSTEM.md](ZIELSYSTEM.md)
> Abschnitt 0.
Ein Abgleich mit den nachgezogenen Cloud-Screens fördert drei Stellen zutage, an
denen dieser Prototyp anders arbeitet. Sie stehen hier, damit sie beim Einbau
als **Entscheidung** erkennbar sind und nicht als Versehen wegkorrigiert werden.
+9
View File
@@ -19,6 +19,15 @@ Gerendert wird mit derselben Komponente wie in der Software
(`ui/components/SidebarWithSections`, aus der Cloud-Fassung portiert) und
derselben Schrift (Instrument Sans, selbst gehostet aus denselben Dateien).
> **Für den Einbau:** Verbindlich ist an dieser Seitenleiste die **Struktur** —
> zwei Einträge, Analytics mit innerer Leiste. Nicht verbindlich ist ihre
> Umsetzung hier. In der Software werden die zwei Einträge in die bestehende
> `AppSidebar` eingehängt und die innere Leiste über das dortige
> `SidebarIconsLayout` gebaut; unser Nachbau wird nicht mitportiert. Globale
> Regeln — Schrift, Größen, Abstände, Farben — kommen ausschließlich aus
> HiveGrid und werden von hier aus **nicht** überschrieben. Siehe
> [ZIELSYSTEM.md](ZIELSYSTEM.md) Abschnitt 0.
**Analytics ist ein einzelner Menüpunkt**, kein aufklappbarer Bereich. Die fünf
Analyse-Seiten sind darin über eine **innere Leiste** erreichbar:
+52
View File
@@ -11,6 +11,58 @@ Größenordnung: 678 Route-Dateien, davon 575 im Core-Manifest.
---
## 0. Rangfolge beim Einbau — HiveGrid gewinnt
**Dieser Prototyp ist nachrangig.** Wo er von HiveGrid Cloud abweicht, gilt
HiveGrid — ohne Rückfrage, ohne Ausnahme. Das betrifft alles Globale:
| | Wer bestimmt |
|---|---|
| Schrift, Schriftgrößen, Zeilenhöhen | **HiveGrid** |
| Abstände, Paddings, Margins, Raster | **HiveGrid** |
| Farben der Oberfläche, Rahmen, Radien, Schatten | **HiveGrid** |
| Control-Höhen, Komponentenvarianten, Zustände | **HiveGrid** |
| App-Shell, Seitenleiste, Kopfzeile, Seitenkopf | **HiveGrid** |
| i18n, Formatierung, Zeitzone | **HiveGrid** |
Dass dieser Prototyp dieselbe Schrift, dieselbe Seitenleisten-Komponente und
dieselben Token benutzt, hat **einen einzigen Zweck**: Er soll neben der
Software lesbar sein und nicht wie ein Fremdkörper wirken. Es ist **keine
Vorlage, an der sich die Software auszurichten hätte.** Fällt beim Einbau auf,
dass hier ein Wert von HiveGrid abweicht, ist der Wert hier falsch — nicht dort.
### Was aus diesem Repo verbindlich ist
Nur das Fachliche und das Analytics-Eigene:
1. **Die Navigationsstruktur als Verabredung** — zwei Einträge in der
Seitenleiste (`Dashboard`, `Analytics`), und Analytics trägt eine **innere
Leiste** mit den fünf Analyse-Seiten. Verbindlich ist die *Struktur*, nicht
ihre Umsetzung hier: In der Software werden diese zwei Einträge in die
bestehende `AppSidebar` eingehängt und die innere Leiste über das dortige
`SidebarIconsLayout` gebaut. Unser Nachbau ist die Beschreibung, nicht das
Bauteil.
2. **Kennzahl-Definitionen** ([KPI-KATALOG.md](KPI-KATALOG.md)) —
was gerechnet wird, mit welchem Zeitbezug.
3. **Diagrammregeln** ([DESIGN-SYSTEM.md](DESIGN-SYSTEM.md)) — Palette,
Achsen, Diagrammwahl, Leerzustände. Das ist die Lücke, die HiveGrid heute
nicht füllt (siehe [LEITPLANKEN.md](LEITPLANKEN.md) Abschnitt 4).
4. **Verhalten** — Filterlogik, Zeitbezüge, Widget-Sichtbarkeit,
Sortier- und Blätterverhalten.
### Was aus diesem Repo Gerüst ist und wegfällt
`components/layout/AppShell.tsx`, unsere Kopie der Seitenleiste, `PageHeader`,
die Kopfzeile mit Suche und Glocke, die Routen unter `app/` und die
Platzhalterseite für das Dashboard. All das existiert, damit der Prototyp
alleine lauffähig und beurteilbar ist. Beim Einbau übernehmen
`SubframeAppShell`, `AppSidebar`, `PageShell` und die Loader der Software.
**Kurz:** Aus diesem Repo kommt der Inhalt des Analytics-Bereichs und die
Verabredung, wo er in der Navigation sitzt. Alles andere kommt aus HiveGrid.
---
## 1. Der Platz dieses Prototyps
Das Ziel ist der Tenant-Dashboard-Screen unter `…/<tenant>/dashboard`.