dejanandClaude Opus 5
1896d2772b
Die Uebergabe geht an einen Dev, der den Einbau mit einem Coding-Agenten macht. Dafuer reicht "hier ist das Repo" nicht. Vier neue Artefakte, alle gegen das Zielsystem geprueft, nicht aus dem Gedaechtnis geschrieben. **EINBAU.md** ist der Einstieg. Der wichtigste Satz darin steht ganz oben: Das Dashboard in HiveGrid ist kein leeres Blatt. Route, Widget-Registry, Rollen-Layouts, Drilldown, Export, Live-Updates und Layout-Speicherung sind gebaut. Wer dort eine neue Seite anlegt, wirft funktionierende Software weg. Das ist nicht meine Einschaetzung: Der Brief P30 im Zielsystem sagt woertlich "Delta-Phase, kein Neubau ... Dashboard/Widget-Registry voll gebaut". Analytics dagegen gibt es noch nicht und wird nach dem Muster von leads.analytics.tsx neu gebaut. Dazu eine Tabelle, welche Datei wohin wandert, und eine zweite, was ausdruecklich nicht mitwandert und warum. **docs/port/TICKET-ANALYTICS.md und TICKET-DASHBOARD.md** sind im Format von .planning/ticket-docs/ geschrieben, mit Header-Tabelle, Abhaengigkeiten, Definition of Done, Technischen Bausteinen, Quellen und Dev-Nachzug. Sie koennen dorthin kopiert werden; dann greift der bestehende Ablauf, statt dass wir einen zweiten danebenstellen. **docs/port/i18n-*.json plus TEXTE.md.** pnpm run verify:i18n ist in HiveGrid ein Gate: keine hartkodierten Strings. Dieser Prototyp ist zu 100 % hartkodiertes Deutsch. 185 Texte mit Schluesselvorschlag und Fundstelle, dazu derselbe Inhalt als einfuegbarer Baum. Erzeugt von scripts/i18n-inventar.py (npm run i18n:inventar), damit das Inventar nicht auseinanderlaeuft, wenn sich am Prototyp noch etwas aendert. Dabei gefunden: app.dashboard.widgets.* enthaelt bereits 17 Widgets, darunter genau fuenf, die dieser Prototyp gestaltet (receivables, orderIntake, daysToPayment, winRate, stageDistribution) und genau die drei, die er als reserviert markiert (myTasks, scheduleToday, hrRequests). Neue Schluessel dafuer waeren Dubletten; die acht sind in TEXTE.md einzeln aufgefuehrt. Die Anrede stimmt ebenfalls schon ueberein, HiveGrid duzt. **CLAUDE.md** als Einstiegspunkt, den Claude Code beim Oeffnen des Repos von selbst liest: was dieses Repo ist, die drei Dinge, an denen ein Einbau sonst scheitert, und wo was steht. Jeder in den Dokumenten genannte Pfad wurde in beiden Repos nachgeprueft. Ein Fehler dabei gefunden und behoben: der Designer-Brief heisst P11-suche-dashboard.md, nicht P11.md. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
67 lines
2.7 KiB
Markdown
67 lines
2.7 KiB
Markdown
# 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.
|