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:
dejanandClaude Opus 5 committed 2026-08-31 20:51:19 +02:00
1 parent e998231fed
commit 6a0b36ddcc
75 files changed
+471 -471

No files matched your search

+36 -36
View File
@@ -11,10 +11,10 @@ Größenordnung: 678 Route-Dateien, davon 575 im Core-Manifest.
---
## 0. Rangfolge beim Einbau — HiveGrid gewinnt
## 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:
HiveGrid, ohne Rückfrage, ohne Ausnahme. Das betrifft alles Globale:
| | Wer bestimmt |
|---|---|
@@ -29,25 +29,25 @@ 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.
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
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)) —
2. **Kennzahl-Definitionen** ([KPI-KATALOG.md](KPI-KATALOG.md)),
was gerechnet wird, mit welchem Zeitbezug.
3. **Diagrammregeln** ([DESIGN-SYSTEM.md](DESIGN-SYSTEM.md)) — Palette,
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,
4. **Verhalten**: Filterlogik, Zeitbezüge, Widget-Sichtbarkeit,
Sortier- und Blätterverhalten.
### Was aus diesem Repo Gerüst ist und wegfällt
@@ -60,7 +60,7 @@ Prototyp alleine lauffähig und beurteilbar ist. Beim Einbau übernehmen
der Software.
Das **Kachelraster des Dashboards** ist die Ausnahme in dieser Liste: Es ist
kein Gerüst, sondern aus `DashboardPage.tsx` der Software übernommen —
kein Gerüst, sondern aus `DashboardPage.tsx` der Software übernommen,
dieselben Klassen, dieselbe Ableitung aus `size.w` und `position.x`. Es fällt
nicht weg, es trifft dort auf sein Original.
@@ -88,7 +88,7 @@ Fachlich ist das die Phase **P11** (Modul M20): drei feste Rollen-Layouts
Komfort-Delta aus **P30** (Edit-Modus, Drilldown, CSV-/Report-Export,
Realtime-Opt-out).
**Wichtig:** Dieser Stand ist ausdrücklich **Interim-UI nach AD-28** — der Dev
**Wichtig:** Dieser Stand ist ausdrücklich **Interim-UI nach AD-28**, der Dev
baut aus `~/ui` gegen ein stabiles View-Model, damit das Ticket nicht auf den
finalen Screen wartet. Der Kommentarkopf von `DashboardPage.tsx` sagt es
wörtlich: *„Final Subframe optics = tracked design-nachzug (D-DASH / VD-P30)."*
@@ -98,14 +98,14 @@ kein Umbau gegen den Strom.
---
## 2. Gemeinsame Basis — und wo sie auseinanderläuft
## 2. Gemeinsame Basis, und wo sie auseinanderläuft
| | Prototyp | HiveGrid Cloud |
|---|---|---|
| Subframe-Projekt | `f023064a5ca0` | `f023064a5ca0` — **dasselbe** |
| Subframe-Projekt | `f023064a5ca0` | `f023064a5ca0`: **dasselbe** |
| Bibliothek | `ui/`, 86 Komponenten | `apps/web/app/ui/`, Alias `~/ui/*`, 92 Komponenten |
| Überschneidung | 82 Komponenten gleich benannt | dieselben 82 |
| Diagramme | Recharts ^2.15.4 | Recharts ^2.15.3 — **dieselbe Bibliothek** |
| Diagramme | Recharts ^2.15.4 | Recharts ^2.15.3: **dieselbe Bibliothek** |
| Framework | Next.js 16 | React Router 7 |
Die vier Namensunterschiede: `DialogFullscreen` → `FullscreenDialog`,
@@ -120,7 +120,7 @@ Grund, warum der Einbau realistisch ein Port ist und keine Neuimplementierung.
## 3. Was beim Einbau konkret anders wird
### 3.1 Daten kommen als View-Model-Prop — bereits umgesetzt
### 3.1 Daten kommen als View-Model-Prop: bereits umgesetzt
**Das ist im Prototyp schon so gebaut.** Jede Analyse-Seite ist eine reine
Komponente:
@@ -177,13 +177,13 @@ Fünf Zustände statt einem. Der Prototyp kennt nur „Daten da"; `loading`,
Was der Builder noch **nicht** kennt: `DashboardPageData` führt in der Cloud
zusätzlich `activeRole`, `layout`, `generatedAt`, `streamUrl`, `canCustomize`,
`liveUpdatesEnabled`, `layoutSource` und `catalog`. Das Dashboard ist dort
rollen- und berechtigungsabhängig — diese Felder kommen beim Einbau dazu.
rollen- und berechtigungsabhängig, diese Felder kommen beim Einbau dazu.
### 3.1a Warum der Prototyp auf Next.js bleibt
Die Frage liegt nahe, weil die Software auf React Router 7 läuft. Ein Umbau
brächte aber nichts: Im gesamten Prototyp gibt es **vier** Next-spezifische
Importe, alle in zwei Dateien —
Importe, alle in zwei Dateien,
| Datei | Import | Schicksal beim Einbau |
|---|---|---|
@@ -191,19 +191,19 @@ Importe, alle in zwei Dateien —
| `app/layout.tsx` | `next`, `next/font/google` | entfällt, Root-Layout gehört der Cloud |
Portiert wird nicht die Anwendung, sondern der Ordner
`features/dashboard/{pages,components,view-models,utils}` — und der enthält
`features/dashboard/{pages,components,view-models,utils}`, und der enthält
keine Framework-Bindung. React 19, Tailwind v4 und Recharts sind in beiden
Repos dieselben. Ein Framework-Wechsel im Prototyp wäre Aufwand ohne Ertrag und
würde die Gestaltungsarbeit nur verzögern.
### 3.1b Wo die Analyse in der Navigation landet — offen
### 3.1b Wo die Analyse in der Navigation landet: offen
**Die Seitenleiste des Prototyps ist Gerüst, kein Vorschlag.** Sie existiert nur,
damit die Seiten einzeln aufrufbar sind, und entfällt beim Einbau (siehe 3.2).
Wohin die fünf Analyse-Seiten in der echten Navigation gehören, ist **noch nicht
entschieden**.
Der Stand in der Software: Die Seitenleiste hat sechs Gruppen —
Der Stand in der Software: Die Seitenleiste hat sechs Gruppen,
Start (Dashboard, Aufgaben) · Kunden · Projekte · Kommunikation · Organisation ·
Automatisierung. **Eine Analyse-Gruppe gibt es nicht.** Es gibt aber bereits
zwei konkurrierende Muster:
@@ -211,7 +211,7 @@ zwei konkurrierende Muster:
| Muster | Beispiel | Charakter |
|---|---|---|
| Rollen-Dashboard als Startseite | `/dashboard` (P11/P30) | Widgets, drei Rollen-Layouts, „wie ist meine Lage" |
| Analyse **innerhalb** der Fachdomäne | `leads/analytics` — existiert bereits | vertieft genau eine Domäne |
| Analyse **innerhalb** der Fachdomäne | `leads/analytics`: existiert bereits | vertieft genau eine Domäne |
Dieser Prototyp schlägt implizit ein drittes Muster vor: einen
**domänenübergreifenden Analysebereich** mit gemeinsamem Zeitraum- und
@@ -225,7 +225,7 @@ Dimensionsfilter.
(Übersicht → Detail). Finanzen greift über Projekte, Rechnungen und Kontakte
hinweg und passt in keine einzelne Domäne.
*Dagegen:* eine siebte Gruppe in einer schon langen Seitenleiste.
2. **Verteilt in die Domänen** — Finanzen unter Projekte, Kunden-Analyse unter
2. **Verteilt in die Domänen**: Finanzen unter Projekte, Kunden-Analyse unter
Kunden, analog zu `leads/analytics`.
*Dafür:* folgt dem bestehenden Muster, keine neue Gruppe.
*Dagegen:* Der gemeinsame Zeitraumfilter zerfällt, die Übersichtsseite hat
@@ -235,12 +235,12 @@ Dimensionsfilter.
Analyse „warum ist das so". Beides in eine Seite zu legen, macht aus dem
Einstieg eine Halde.
**Entschieden am 29.08.2026: Option 1**, mit dem Namen **„Analytics"** — der
**Entschieden am 29.08.2026: Option 1**, mit dem Namen **„Analytics"**, der
Prototyp setzt das um. Die Seitenleiste spiegelt jetzt die der Software
(dieselbe Komponente, dieselben Gruppen); „Analytics" ist ein einzelner
Menüpunkt neben „Dashboard", die fünf Seiten sind darin über Reiter erreichbar.
*Ursprüngliche Empfehlung war der Name* **„Statistiken"** — so heißt der
*Ursprüngliche Empfehlung war der Name* **„Statistiken"**: so heißt der
Breadcrumb im Prototyp bereits, und „Analyse" ist im Haus durch
`leads/analytics` belegt. Das bestehende `/dashboard` bleibt Startseite; unsere
Seite „Übersicht" braucht dann einen anderen Namen, sonst konkurrieren zwei
@@ -251,14 +251,14 @@ Einstiegsseiten um dieselbe Rolle.
| Prototyp | In der Software |
|---|---|
| „Übersicht" | kollidiert mit der Startseite „Dashboard" |
| „Aufträge" | keine Entität — eine Pipeline-View auf den Projekt-Kern (AD-20) |
| „Kunden" | keine Entität — ein Status am `Kontakt` |
| „Aufträge" | keine Entität, eine Pipeline-View auf den Projekt-Kern (AD-20) |
| „Kunden" | keine Entität, ein Status am `Kontakt` |
| „Team" | thematisch unter Organisation/HR; Datenquelle erst in v2 |
Das ist eine Produkt- und Designentscheidung, keine Umsetzungsfrage. Sie gehört
in die Runde mit dem Head of Design, nicht in den Einbau.
**Nachtrag 29.08.2026:** Die Frage hängt an einer größeren — „Analytics" und
**Nachtrag 29.08.2026:** Die Frage hängt an einer größeren: „Analytics" und
„Dashboard" sind zwei Features. Siehe
[SCOPE-ANALYTICS-DASHBOARD.md](SCOPE-ANALYTICS-DASHBOARD.md).
@@ -267,7 +267,7 @@ in die Runde mit dem Head of Design, nicht in den Einbau.
`AppShell.tsx` aus diesem Prototyp fällt beim Einbau **weg**. Die Cloud-Routen
laufen bereits in der echten App-Shell mit Sidebar, Tenant-Layout und
Breadcrumb (`SubframeAppShell.tsx`, `AppSidebar.tsx`). Screen-Komponenten
dürfen dort ausdrücklich **kein** `~/ui/layouts/DefaultPageLayout` rendern —
dürfen dort ausdrücklich **kein** `~/ui/layouts/DefaultPageLayout` rendern,
das bringt eine eigene Beispiel-Sidebar mit und erzeugt eine doppelte
Navigation. Stattdessen gilt `PageShell` / `PageHeader` / `PageBody` aus
`components/screens/shared/PageShell.tsx`.
@@ -278,7 +278,7 @@ Unsere Seitenköpfe und die Filterleiste bleiben, die Rahmen-Navigation nicht.
Alle statischen Texte laufen über `react-i18next` (`t("app.dashboard.…")`).
Dieser Prototyp hat deutsche Strings fest im JSX. Das ist beim Einbau
mechanische Arbeit, aber flächendeckend — es betrifft jede Karte, jede
mechanische Arbeit, aber flächendeckend, es betrifft jede Karte, jede
Achsenbeschriftung und jeden Leerzustand.
Die deutschen **Bezeichner im Code** (`umsatz`, `auftraege`) bleiben davon
@@ -289,7 +289,7 @@ in P30).
In der Cloud sind Charts konsequent `aria-hidden="true"`, und die umgebende
Karte liefert eine Textzusammenfassung plus Datentabelle für Screenreader.
Dieser Prototyp hat das **nicht**. Beim Einbau ist es Pflicht — das Repo fährt
Dieser Prototyp hat das **nicht**. Beim Einbau ist es Pflicht, das Repo fährt
ein a11y-Lint-Baseline-Gate und axe-Tests je Primitive.
### 3.5 Stabile Oberflächen-IDs
@@ -304,7 +304,7 @@ müssen aber auf das dortige Namensschema umgestellt werden.
`.planning/INTERIM-UI-DESIGN-STANDARDS.md` schreibt fest: Page-Padding **24**,
Card **16**, Grid-Gap **16**, Section-Gap **24**, Field-Gap **16**,
Control-Höhe Medium **36**, Input-Radius **4**. Das deckt sich mit dem
8-px-System in [DESIGN-SYSTEM.md](DESIGN-SYSTEM.md) Abschnitt 5 — hier ist
8-px-System in [DESIGN-SYSTEM.md](DESIGN-SYSTEM.md) Abschnitt 5: hier ist
nichts anzupassen.
---
@@ -318,7 +318,7 @@ Farben direkt im JSX (`fill="#334155"`, `fill="#cbd5e1"`), jedes mit eigenem
Gitter (`strokeDasharray="3 3"`), eigener Achsenbreite und eigenem
Balkenradius. Es gibt keine geteilte Palette, keine Kategorien-Obergrenze und
keine feste Farbzuordnung. `features/dashboard/utils/chartTheme.ts` ist genau
das, was dort fehlt — und der Teil, der sich am ehesten unabhängig vom Rest
das, was dort fehlt, und der Teil, der sich am ehesten unabhängig vom Rest
übernehmen lässt.
**Ausformulierte Diagramm-Regeln.** [DESIGN-SYSTEM.md](DESIGN-SYSTEM.md) hat in
@@ -332,20 +332,20 @@ Definition.
---
## 5. Wer entwirft was — der Rest ist noch nicht fertig designt
## 5. Wer entwirft was, der Rest ist noch nicht fertig designt
HiveGrid Cloud ist nach dem **Designer-First-Prinzip** organisiert
(`.planning/DESIGNER-FIRST-PLAYBOOK.md`). Der Ablauf ist verbindlich:
1. Dev/Planung stellt je Phase einen **Designer-Brief** bereit —
1. Dev/Planung stellt je Phase einen **Designer-Brief** bereit,
*was* das Modul tut und *welche UI-Elemente* vorkommen müssen, **kein Layout**.
2. Der Designer entwirft die Screens in Subframe und darf Spec und UI/UX
**überschreiben** — Anordnung und Layout sind eine Design-Entscheidung.
**überschreiben**: Anordnung und Layout sind eine Design-Entscheidung.
3. Das **Delta** (geänderte Spec-Punkte, neue UX-Entscheidungen, Subframe-Link)
wird in den Brief eingetragen.
4. Der Dev setzt um und zieht Spec und Doku nach.
Es gibt 31 solcher Briefs (`.planning/designer-briefs/P01…P34.md`) — Auth, CRM,
Es gibt 31 solcher Briefs (`.planning/designer-briefs/P01…P34.md`): Auth, CRM,
Lead-Inbox, Projekt-Pipelines, Automation-Flow-Editor, Form-Builder, Plantafel,
Kalender, Telefonie, HR, Billing, Customer-Portal, Help-Center. Für einen
großen Teil davon steht der Delta-Block **noch leer**: Der finale Screen ist
@@ -357,7 +357,7 @@ noch nicht entworfen, die Route läuft bis dahin auf Interim-UI.
Anwendung. Es fügt sich in eine App-Shell und ein Design-System ein, die
bereits stehen.
- Was hier an Anordnung und Raster festgelegt ist, ist ein **Vorschlag**. Die
Layout-Hoheit liegt beim Designer — der Brief zu P11 sagt ausdrücklich
Layout-Hoheit liegt beim Designer, der Brief zu P11 sagt ausdrücklich
„Anordnung = Davids freie Hand". Verbindlich zu übergeben sind die
**Kennzahl-Definitionen, die Chart-Regeln und das Verhalten**, nicht die
Pixelanordnung.
@@ -378,7 +378,7 @@ pnpm dev:local
```
Tenant-App auf `http://app.localhost:3000`. Die lokalen Demo-Zugänge (Tenant
„HiveGrid Demo SHK") stehen im README von HiveGrid Cloud unter „App starten" —
„HiveGrid Demo SHK") stehen im README von HiveGrid Cloud unter „App starten",
sie werden hier bewusst nicht wiederholt. Die Demo-Daten sind zunächst
ausgeblendet und erscheinen über **„Demo-Daten anzeigen"** oder `?demo=show`.