# Dashboard-Prototyp: Einstieg für Coding-Agenten

Dieses Repo ist **kein Produkt und keine Bibliothek**. Es ist eine
Gestaltungsvorlage, die in `HiveGrid-Cloud` eingebaut wird.

## Wenn du hier etwas ändern sollst

Lies zuerst `README.md`, dann die Datei zum Thema in `docs/`. Vor jedem Commit:

```bash
npx tsc --noEmit && npm run lint && npm run build
npm run verify:carbon    # Palette, Tooltip, Achsenraster gegen @carbon/charts
npm run verify:layout    # Textkollisionen, 7 Seiten x 9 Breiten (Server muss laufen)
```

Beide `verify:*` sind keine Formsache. `verify:layout` hat in dieser Sitzung
mehrfach Fehler gefunden, die auf einem Screenshot nicht zu sehen waren.

## Wenn du das hier in HiveGrid einbauen sollst

**→ `EINBAU.md` lesen, vollständig, vor der ersten Änderung.**

Die drei Dinge, an denen ein Einbau sonst scheitert:

1. **Das Dashboard existiert in HiveGrid bereits**, mit Route,
   Widget-Registry, Rollen-Layouts, Drilldown, Export und Live-Updates. Dieses
   Repo liefert die *Gestaltung*, nicht den Rahmen. Wer dort eine neue Seite
   anlegt, wirft funktionierende Software weg. Analytics dagegen gibt es noch
   nicht und wird neu gebaut.

2. **HiveGrid gewinnt bei allen globalen Regeln**: Schrift, Größen, Abstände,
   Farben, Ansprache. Was dieses Repo dazu setzt, existiert nur, damit es
   allein lauffähig ist. Verbindlich sind hier die *Diagrammregeln* und die
   *Kennzahl-Definitionen*.

3. **Alle Texte sind hartkodiertes Deutsch**, HiveGrid verlangt `t()` und
   prüft das mit `pnpm run verify:i18n`. Die Schlüsselliste liegt fertig unter
   `docs/port/`.

## Zwei Ticket-Docs liegen bereit

`docs/port/TICKET-ANALYTICS.md` und `docs/port/TICKET-DASHBOARD.md` sind im
Format von `.planning/ticket-docs/` geschrieben und können dort hineinkopiert
werden. Dann greift der normale HiveGrid-Ablauf.

## Wo finde ich was

| Was | Wo |
|---|---|
| **Einbau in HiveGrid** | `EINBAU.md` |
| Ticket-Docs für den Einbau | `docs/port/TICKET-*.md` |
| Texte und i18n-Schlüssel | `docs/port/TEXTE.md`, `i18n-de.json` |
| Was übergeben wird, was Attrappe ist | `HANDOVER.md` |
| Diagramm- und Farbregeln | `docs/DESIGN-SYSTEM.md` |
| Jede Kennzahl mit Formel und Zeitbezug | `docs/KPI-KATALOG.md` |
| Feldherkunft, Lücken im Modell | `docs/DATENMODELL.md` |
| Rangfolge Prototyp ↔ HiveGrid | `docs/ZIELSYSTEM.md` Abschnitt 0 |
| Zuschnitt Analytics ↔ Dashboard | `docs/SCOPE-ANALYTICS-DASHBOARD.md` |
| Navigation und Seitenaufbau | `docs/NAVIGATION.md` |
| Fertige vs. Interim-UI im Zielsystem | `docs/LEITPLANKEN.md` |
| Woher die Gestaltung stammt | `docs/HERKUNFT.md` |
| Fragen für die Abnahme | `docs/PRUEFFRAGEN.md` |

## Sprache
Code-Kommentare, Doku und Oberfläche sind auf Deutsch. Die Anwendung duzt.
Keine Geviertstriche.