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:
1 parent
e998231fed
commit
6a0b36ddcc
75 files changed
+471
-471
No files matched your search
+36
-36
@@ -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`.
|
||||
|
||||
|
||||
Reference in new issue
Block a user