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:
1 parent
9eec855f57
commit
b3d71c1f19
7 files changed
+109
-2
No files matched your search
@@ -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.
|
||||
|
||||
@@ -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:
|
||||
|
||||
|
||||
@@ -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`.
|
||||
|
||||
Reference in new issue
Block a user