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
@@ -63,7 +63,7 @@ export function AlertList({
|
||||
/**
|
||||
* Der Trennstrich sitzt oben, nicht unten.
|
||||
*
|
||||
* Unten liegend braucht er eine Ausnahme für die letzte Zeile — und
|
||||
* Unten liegend braucht er eine Ausnahme für die letzte Zeile, und
|
||||
* „die letzte Zeile" gibt es bei zwei Spalten zweimal, einmal je
|
||||
* Spalte, an einer Stelle, die von der Anzahl der Einträge abhängt.
|
||||
* Die rechte Spalte behielt dadurch einen Strich, unter dem nichts
|
||||
@@ -82,10 +82,10 @@ export function AlertList({
|
||||
>
|
||||
<button
|
||||
onClick={() =>
|
||||
zeigeToast(eintrag.aktion, `${eintrag.text} — Absprung folgt in der Umsetzung`)
|
||||
zeigeToast(eintrag.aktion, `${eintrag.text}: Absprung folgt in der Umsetzung`)
|
||||
}
|
||||
/* -mx-2 und die zusätzliche Breite: Der Untergrund lief vorher
|
||||
genau bis zum Pfeil und schnitt dort hart ab — bei zwei Spalten
|
||||
genau bis zum Pfeil und schnitt dort hart ab, bei zwei Spalten
|
||||
besonders sichtbar, weil daneben 32 px Spaltenabstand ungefärbt
|
||||
blieben. Jetzt greift er acht Pixel über den Inhalt hinaus und
|
||||
hat runde Ecken; er liest sich als Fläche unter der Zeile statt
|
||||
|
||||
@@ -27,7 +27,7 @@ export function ChartCard({
|
||||
children,
|
||||
className = "",
|
||||
}: {
|
||||
/** Stabile ID — Schlüssel für Ausblenden/Einblenden. */
|
||||
/** Stabile ID: Schlüssel für Ausblenden/Einblenden. */
|
||||
id: string;
|
||||
titel: string;
|
||||
untertitel?: string;
|
||||
@@ -49,7 +49,7 @@ export function ChartCard({
|
||||
const schliesse = (event: MouseEvent) => {
|
||||
if (!menu.current?.contains(event.target as Node)) setMenuOffen(false);
|
||||
};
|
||||
// Escape schliesst und gibt den Fokus an den Ausloeser zurueck — sonst
|
||||
// Escape schliesst und gibt den Fokus an den Ausloeser zurueck, sonst
|
||||
// landet die Tastaturbedienung nach dem Schliessen am Seitenanfang.
|
||||
const taste = (event: KeyboardEvent) => {
|
||||
if (event.key === "Escape") {
|
||||
@@ -123,7 +123,7 @@ export function ChartCard({
|
||||
</button>
|
||||
<button
|
||||
onClick={() => {
|
||||
zeigeToast("Als Bild vorgemerkt", `${titel} — Export folgt in der Umsetzung`);
|
||||
zeigeToast("Als Bild vorgemerkt", `${titel}: Export folgt in der Umsetzung`);
|
||||
setMenuOffen(false);
|
||||
}}
|
||||
className="flex items-center gap-2 px-3 py-2 text-left text-[13px] text-text-neutral-primary hover:bg-neutral-50"
|
||||
@@ -141,7 +141,7 @@ export function ChartCard({
|
||||
{/* justify-center: Karten einer Zeile sind gleich hoch, aber nicht gleich
|
||||
voll. Eine Karte mit einem Balken neben einer mit einem Diagramm über
|
||||
400 px bekommt den Überschuss oben und unten je zur Hälfte, statt ihn
|
||||
unten abzuladen. Der Inhalt behält seine natürliche Höhe — die Karte
|
||||
unten abzuladen. Der Inhalt behält seine natürliche Höhe, die Karte
|
||||
wächst weiter mit, wenn mehr hineinkommt. */}
|
||||
<div className="flex min-h-0 grow flex-col justify-center px-4 pb-4">{children}</div>
|
||||
</section>
|
||||
|
||||
@@ -6,7 +6,7 @@ import { FeatherIcon } from "../layout/FeatherIcon";
|
||||
import { Sparkline } from "../charts/Sparkline";
|
||||
import { CHART, STATUS_FARBEN } from "../../utils/chartTheme";
|
||||
|
||||
/** Zeitbezug einer Kennzahl — siehe docs/KPI-KATALOG.md. */
|
||||
/** Zeitbezug einer Kennzahl: siehe docs/KPI-KATALOG.md. */
|
||||
export type Bezug = "zeitraum" | "stichtag" | "gesamt";
|
||||
|
||||
const BEZUG_LABEL: Record<Bezug, string> = {
|
||||
@@ -19,14 +19,14 @@ const BEZUG_LABEL: Record<Bezug, string> = {
|
||||
* KPI-Karte nach UI_UX_GUIDELINES.md, Abschnitt 4:
|
||||
* Label oben links · Icon oben rechts · Wert · Zusatz · Fußzeile.
|
||||
*
|
||||
* Alle Karten einer Reihe haben dieselbe Anatomie — auch die ohne Trend.
|
||||
* Alle Karten einer Reihe haben dieselbe Anatomie, auch die ohne Trend.
|
||||
* Wo kein Vorperiodenvergleich möglich ist (stichtagsbezogene Kennzahlen),
|
||||
* trägt die Fußzeile den Zeitbezug. Ohne das steht in einer Reihe eine
|
||||
* Karte mit Trendzeile neben vier Karten mit leerem Fuß, und das Auge
|
||||
* sucht eine Regel, die es nicht gibt.
|
||||
*
|
||||
* Der Trend vergleicht immer mit der gleich langen Vorperiode
|
||||
* (30 Tage gegen die 30 Tage davor) — nicht mit dem Vorjahr.
|
||||
* (30 Tage gegen die 30 Tage davor): nicht mit dem Vorjahr.
|
||||
*/
|
||||
export function KPICard({
|
||||
label,
|
||||
@@ -38,7 +38,7 @@ export function KPICard({
|
||||
/**
|
||||
* Überschreibt die Fußzeile. Analytics hat einen seitenweiten Filter, deshalb
|
||||
* heißt es dort "im gewählten Zeitraum". Auf dem Dashboard gibt es den nicht
|
||||
* — jede Kachel trägt ihren eigenen Zeitraum und muss ihn benennen können.
|
||||
* jede Kachel trägt ihren eigenen Zeitraum und muss ihn benennen können.
|
||||
*/
|
||||
bezugText,
|
||||
icon,
|
||||
@@ -58,7 +58,7 @@ export function KPICard({
|
||||
verlauf?: number[];
|
||||
/**
|
||||
* Färbt das Icon. Nur setzen, wenn die Farbe aus einem Schwellenvergleich
|
||||
* kommt — ein dekorativ grünes Icon behauptet "gut", ohne es zu belegen
|
||||
* kommt, ein dekorativ grünes Icon behauptet "gut", ohne es zu belegen
|
||||
* (docs/DESIGN-SYSTEM.md §1: Statusfarben nur für Aussagen).
|
||||
*/
|
||||
akzent?: "neutral" | "positiv" | "warnung" | "negativ" | "info";
|
||||
@@ -85,14 +85,14 @@ export function KPICard({
|
||||
return (
|
||||
/* h-full: Die Karte füllt ihre Rasterzelle. Ohne das ist die Karte mit
|
||||
Trendzeile und Verlaufskurve höher als ihre Nachbarn, und eine Reihe
|
||||
gleichartiger Kennzahlen bekommt eine ungleiche Unterkante — auf dem
|
||||
gleichartiger Kennzahlen bekommt eine ungleiche Unterkante: auf dem
|
||||
Dashboard sichtbar, weil dort ein Link zwischen Zelle und Karte steht
|
||||
und die Streckung des Rasters nicht mehr durchreicht. */
|
||||
<article className="flex h-full min-h-[136px] flex-col rounded-lg border border-solid border-border-default bg-white p-4 shadow-sm transition-shadow duration-200 hover:shadow-md">
|
||||
<div className="flex items-start justify-between gap-2">
|
||||
{/* min-w-0 + break-words: Ohne das schiebt ein langes Label wie
|
||||
„Umsatz (Zahlungseingang)" das Icon aus der Karte und laeuft selbst
|
||||
ueber den Rand. Die Karte wird dadurch eine Zeile hoeher — das ist
|
||||
ueber den Rand. Die Karte wird dadurch eine Zeile hoeher, das ist
|
||||
der Preis dafuer, dass die Beschriftung vollstaendig lesbar bleibt
|
||||
(docs/DESIGN-SYSTEM.md §9). */}
|
||||
<span className="min-w-0 break-words text-[12px] font-medium leading-tight text-text-neutral-tertiary">
|
||||
@@ -150,7 +150,7 @@ export function KPICard({
|
||||
{verlauf && verlauf.length > 1 ? (
|
||||
<span className="h-8 w-16 flex-none">
|
||||
{/* Die Kurve trägt dieselbe Aussage wie der Pfeil daneben und
|
||||
deshalb auch dieselbe Farbe — sonst zeigt die Karte zwei
|
||||
deshalb auch dieselbe Farbe, sonst zeigt die Karte zwei
|
||||
widersprüchliche Signale. */}
|
||||
<Sparkline werte={verlauf} farbe={trend ? trendFarbe : CHART.achse} />
|
||||
</span>
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
import React from "react";
|
||||
|
||||
/**
|
||||
* Kompakte Zusatzkennzahlen unter einem Chart —
|
||||
* Kompakte Zusatzkennzahlen unter einem Chart,
|
||||
* beantwortet "und was heißt das jetzt?" ohne eigene Karte.
|
||||
*/
|
||||
export function StatZeile({
|
||||
eintraege,
|
||||
/**
|
||||
* Spalten auf breiten Schirmen. In einer Drittelkarte brechen vier Spalten
|
||||
* mitten im Betrag um ("1,22 Mio." / "€") — dort gehoeren zwei hin.
|
||||
* mitten im Betrag um ("1,22 Mio." / "€"): dort gehoeren zwei hin.
|
||||
*/
|
||||
spalten = 4,
|
||||
}: {
|
||||
|
||||
@@ -31,7 +31,7 @@ import type { ZeitreihePunkt } from "../../data/types";
|
||||
*
|
||||
* Bewusst `ComposedChart`, nicht `AreaChart`: Recharts sammelt in einem
|
||||
* AreaChart ausschließlich `Area`-Kinder ein (generateCategoricalChart mit
|
||||
* GraphicalChild = Area). Ein `<Line>` darin wird stillschweigend verworfen —
|
||||
* GraphicalChild = Area). Ein `<Line>` darin wird stillschweigend verworfen,
|
||||
* die Vergleichsreihe stand monatelang in der Legende, ohne je gezeichnet zu
|
||||
* werden. ComposedChart nimmt beide Typen.
|
||||
*
|
||||
|
||||
@@ -9,14 +9,14 @@ import { ChartLeer } from "./ChartLeer";
|
||||
*
|
||||
* Warum kein Balken: Auslastungswerte liegen im Betrieb zwischen etwa 70 und
|
||||
* 100 %. Ein Balken muss bei 0 beginnen (sonst verzerrt die Länge), und dann
|
||||
* sind 74 % und 96 % optisch fast gleich lang — das Diagramm zeigt nichts.
|
||||
* sind 74 % und 96 % optisch fast gleich lang, das Diagramm zeigt nichts.
|
||||
* Ein Punkt kodiert über die Position, nicht über die Länge, und darf deshalb
|
||||
* einen ausgeschnittenen Bereich zeigen. Carbon nennt das Dot-Plot.
|
||||
*
|
||||
* Die Schwellen sind betrieblich gedacht, nicht mathematisch:
|
||||
* < 70 % Luft frei — Kapazität ungenutzt
|
||||
* < 70 % Luft frei Kapazität ungenutzt
|
||||
* 70–95 % Zielkorridor
|
||||
* > 95 % ausgebucht — Überlastrisiko, Termine gefährdet
|
||||
* > 95 % ausgebucht Überlastrisiko, Termine gefährdet
|
||||
* Der Korridor liegt als graues Band hinter den Punkten, die 100-%-Marke als
|
||||
* beschriftete Linie. Damit erklärt sich die Grafik ohne Ampel-Legende.
|
||||
*/
|
||||
@@ -109,10 +109,10 @@ export function AuslastungsBalken({
|
||||
);
|
||||
})}
|
||||
|
||||
{/* Achse statt Farblegende — die Zonen erklären sich über das Band.
|
||||
{/* Achse statt Farblegende, die Zonen erklären sich über das Band.
|
||||
In sehr schmalen Karten bleibt für die Spur nur rund 40 px; dort
|
||||
stoßen selbst die beiden Randmarken aneinander. Eine Achse, die man
|
||||
nicht mehr lesen kann, ist kein Kompromiss, sondern Störung — sie
|
||||
nicht mehr lesen kann, ist kein Kompromiss, sondern Störung, sie
|
||||
entfällt dann, und die Erläuterung darunter trägt die Skala. */}
|
||||
<div className="hidden grid-cols-[minmax(96px,24%)_minmax(0,1fr)_48px] items-center gap-3 pt-1 @sm:grid">
|
||||
<span />
|
||||
@@ -120,7 +120,7 @@ export function AuslastungsBalken({
|
||||
{/* Beschriftungsdichte staffelt sich mit der Containerbreite: ganz
|
||||
schmal nur die Enden, dann die 100-%-Marke, dann jede zweite, dann
|
||||
alle. Container-Query, weil dieselbe Karte mal ein Drittel und mal
|
||||
die volle Seitenbreite einnimmt — der Viewport weiß davon nichts. */}
|
||||
die volle Seitenbreite einnimmt, der Viewport weiß davon nichts. */}
|
||||
{ticks.map((t, index) => {
|
||||
const stufe =
|
||||
t === min || t === max
|
||||
@@ -131,7 +131,7 @@ export function AuslastungsBalken({
|
||||
? "hidden @lg:inline"
|
||||
: "hidden @md:inline";
|
||||
// Zentriert man auch die Randmarken, ragt die Haelfte ihrer
|
||||
// Breite ueber die Spur hinaus — links wie rechts je rund 10 px.
|
||||
// Breite ueber die Spur hinaus: links wie rechts je rund 10 px.
|
||||
const rand =
|
||||
t === min ? "translate-x-0" : t === max ? "-translate-x-full" : "-translate-x-1/2";
|
||||
return (
|
||||
|
||||
@@ -24,7 +24,7 @@ export function BalkenHorizontal({
|
||||
einfarbig = true,
|
||||
farbeStart = 1,
|
||||
/**
|
||||
* Zweitwert rechts neben dem Hauptwert — z. B. Auftragswert neben der
|
||||
* Zweitwert rechts neben dem Hauptwert: z. B. Auftragswert neben der
|
||||
* Anzahl Abschlüsse. Erspart eine zweite Karte mit derselben Kodierung
|
||||
* auf derselben Personenachse.
|
||||
*/
|
||||
|
||||
@@ -52,7 +52,7 @@ export function BalkenVertikal({
|
||||
// Monatsnamen standen in einer Drittelkarte ohne Lücke aneinander.
|
||||
const intervall = achsenIntervall(punkte.length);
|
||||
|
||||
// Ganzzahlreihen brauchen ganzzahlige Ticks — sonst steht "1,5 Vorgänge".
|
||||
// Ganzzahlreihen brauchen ganzzahlige Ticks, sonst steht "1,5 Vorgänge".
|
||||
const maximum = Math.max(...punkte.map((p) => p.value));
|
||||
const raster = nurGanzzahlen
|
||||
? undefined
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
import React from "react";
|
||||
import { FeatherBarChart2 } from "@subframe/core";
|
||||
|
||||
/** Leerzustand — wichtiger als er aussieht: Filter können jedes Chart leeren. */
|
||||
/** Leerzustand: wichtiger als er aussieht: Filter können jedes Chart leeren. */
|
||||
export function ChartLeer({
|
||||
text = "Keine Daten im gewählten Zeitraum",
|
||||
hoehe = 220,
|
||||
|
||||
@@ -9,7 +9,7 @@ import React from "react";
|
||||
*/
|
||||
export function ChartLegende({
|
||||
eintraege,
|
||||
/** Ausgeblendete Reihen erscheinen ausgegraut — Klick schaltet um. */
|
||||
/** Ausgeblendete Reihen erscheinen ausgegraut: Klick schaltet um. */
|
||||
inaktiv = [],
|
||||
onToggle,
|
||||
}: {
|
||||
|
||||
@@ -8,7 +8,7 @@ import { CHART, TOOLTIP_SCHATTEN } from "../../utils/chartTheme";
|
||||
*
|
||||
* Carbon-Vorgabe (@carbon/charts, .cds--cc--tooltip): helle Fläche
|
||||
* (--cds-layer-02), Text in --cds-text-primary, 12 px, abgesetzt allein durch
|
||||
* den Schatten — kein Rahmen, kein Doppelpunkt zwischen Name und Wert,
|
||||
* den Schatten, kein Rahmen, kein Doppelpunkt zwischen Name und Wert,
|
||||
* maximal 270 px breit.
|
||||
*
|
||||
* Bis Carbon v10 war der Tooltip dunkel (#393939). Viele Quellen im Netz
|
||||
|
||||
@@ -13,11 +13,11 @@ import { DONUT, farbeFuer, gruppiereRest } from "../../utils/chartTheme";
|
||||
* - maximal 5 Segmente, Rest als "Sonstige" (gruppiereRest)
|
||||
* - größtes Segment startet oben, dann im Uhrzeigersinn absteigend
|
||||
* - Gesamtwert steht in der Mitte, sonst muss man die Segmente addieren
|
||||
* - Legende rechts mit Wert — Carbon: „positioned to the right of the chart
|
||||
* - Legende rechts mit Wert: Carbon: „positioned to the right of the chart
|
||||
* when space is plentiful". Ist der Platz nicht reichlich, rutscht sie unter
|
||||
* den Ring, statt Namen und Werte ineinanderlaufen zu lassen. Gesteuert über
|
||||
* eine Container-Query, weil dieselbe Karte mal ein Drittel und mal die halbe
|
||||
* Seitenbreite einnimmt — der Viewport weiß davon nichts.
|
||||
* Seitenbreite einnimmt, der Viewport weiß davon nichts.
|
||||
* - Klick auf einen Legendeneintrag hebt das Segment hervor
|
||||
*/
|
||||
export function Donut({
|
||||
@@ -29,7 +29,7 @@ export function Donut({
|
||||
/**
|
||||
* Format der Ringmitte. Getrennt vom Legendenformat, weil die Mitte eine
|
||||
* Schlagzahl ist: Steht dieselbe Summe als Kennzahl auf der Seite, muss sie
|
||||
* gleich geschrieben sein — "285,3 T€" neben "285.318 €" liest sich wie
|
||||
* gleich geschrieben sein: "285,3 T€" neben "285.318 €" liest sich wie
|
||||
* zwei verschiedene Zahlen.
|
||||
*/
|
||||
formatMitte,
|
||||
|
||||
@@ -12,28 +12,28 @@ import { ChartLeer } from "./ChartLeer";
|
||||
* Übergangsquote ist die Zahl, nach der Betriebe ihren Vertrieb steuern:
|
||||
* Sie zeigt, wo Vorgänge verloren gehen.
|
||||
*
|
||||
* Einfarbig: Die Stufen sind eine Reihenfolge, keine unabhängigen Kategorien —
|
||||
* Einfarbig: Die Stufen sind eine Reihenfolge, keine unabhängigen Kategorien,
|
||||
* DESIGN-SYSTEM.md §1 „Rangfolgen einfarbig". Eine Farbabstufung würde nur
|
||||
* kodieren, was die Reihenfolge ohnehin sagt.
|
||||
*
|
||||
* Die Balken sind zentriert, nicht linksbündig: So liest man die Verjüngung als
|
||||
* Trichterform, ohne die gemeinsame Skala aufzugeben. Ein echtes Funnel-Chart
|
||||
* mit breitenkodierten Segmenten kennt Carbon bewusst nicht — es verzerrt.
|
||||
* mit breitenkodierten Segmenten kennt Carbon bewusst nicht, es verzerrt.
|
||||
*
|
||||
* **Zum Verhalten beim Überfahren:** Die Zeile unter dem Zeiger bekommt einen
|
||||
* Untergrund, die übrigen bleiben unverändert. Das war vorher andersherum
|
||||
* gelöst — die nicht berührten Balken wurden auf 45 % Deckkraft gesetzt — und
|
||||
* gelöst, die nicht berührten Balken wurden auf 45 % Deckkraft gesetzt, und
|
||||
* das war aus drei Gründen falsch:
|
||||
*
|
||||
* 1. Es hat mehr bewegt als gemeint war. Ein Zeiger, der über eine Zeile
|
||||
* streift, ließ fünf von sechs Balken verblassen; das liest sich wie eine
|
||||
* Auswahl, nicht wie ein Überfahren.
|
||||
* 2. Es war in sich widersprüchlich. Die Balken verblassten, die Namen und
|
||||
* Zahlen daneben blieben schwarz — dieselbe Zeile sagte gleichzeitig
|
||||
* Zahlen daneben blieben schwarz: dieselbe Zeile sagte gleichzeitig
|
||||
* „unwichtig" und „unverändert".
|
||||
* 3. Deckkraft trägt in diesem Diagramm bereits eine Bedeutung: Der Balken
|
||||
* kodiert einen Anteil. Ihn heller zu machen, heißt in der Sprache des
|
||||
* Diagramms „weniger" — und nicht „gerade nicht berührt".
|
||||
* Diagramms „weniger": und nicht „gerade nicht berührt".
|
||||
*
|
||||
* Der Untergrund ist derselbe wie in der Handlungsbedarf-Liste und in den
|
||||
* Tabellen (`bg-neutral-50`): Überfahren sieht überall gleich aus.
|
||||
|
||||
@@ -5,16 +5,16 @@ import { FeatherAlertTriangle, FeatherCheckCircle } from "@subframe/core";
|
||||
import { STATUS_FARBEN } from "../../utils/chartTheme";
|
||||
|
||||
/**
|
||||
* Der Begrüßungskopf des Dashboards — in der Software das `hero`-Widget
|
||||
* Der Begrüßungskopf des Dashboards, in der Software das `hero`-Widget
|
||||
* (`DashboardWidgetKind = "hero"`, siehe `dashboard-page.vm.ts`).
|
||||
*
|
||||
* Er beantwortet die einzige Frage, die vor allen Zahlen kommt: „Muss ich
|
||||
* heute etwas tun?" Deshalb steht neben der Anrede ein Satz zur Lage und
|
||||
* nicht etwa eine weitere Kennzahl — die kommen darunter.
|
||||
* nicht etwa eine weitere Kennzahl, die kommen darunter.
|
||||
*
|
||||
* Bewusst ohne Rahmen und ohne Karte: Eine Karte behauptet, hier stünden
|
||||
* Daten, die man mit den Nachbarkarten vergleichen kann. Das ist nicht der
|
||||
* Fall — das ist eine Ansprache. Sie trägt die Seitenüberschrift, deshalb
|
||||
* Fall, das ist eine Ansprache. Sie trägt die Seitenüberschrift, deshalb
|
||||
* hat diese Seite keinen `PageHeader` mit „Dashboard" darüber: Zwei
|
||||
* Überschriften übereinander, von denen eine den Namen der Seite und die
|
||||
* andere den Namen des Lesers nennt, sind eine zu viel.
|
||||
|
||||
@@ -6,7 +6,7 @@ import type { ReservierterBereich } from "../../view-models/dashboard.vm";
|
||||
* Ein Platz, der noch kein Widget ist.
|
||||
*
|
||||
* Das Dashboard zeigt heute nur Analytics, wird aber mehr: eigene Aufgaben,
|
||||
* Termine des Tages, offene HR-Anträge — alle drei stehen im Designer-Brief
|
||||
* Termine des Tages, offene HR-Anträge, alle drei stehen im Designer-Brief
|
||||
* P11 und haben in der Software bereits ihre Widget-Domäne (`tasks`,
|
||||
* `schedule`, `hr`).
|
||||
*
|
||||
|
||||
@@ -9,8 +9,8 @@ import { ZEITRAUM_LABEL, type WidgetDomaene, type WidgetZeitraum } from "../../v
|
||||
/**
|
||||
* Rahmen einer Dashboard-Kachel.
|
||||
*
|
||||
* Sieht aus wie `ChartCard` aus Analytics — gleiche Kante, gleiche Abstände,
|
||||
* gleiche Schriftgrößen — trägt aber nicht deren Logik. Das ⋯-Menü und das
|
||||
* Sieht aus wie `ChartCard` aus Analytics: gleiche Kante, gleiche Abstände,
|
||||
* gleiche Schriftgrößen: trägt aber nicht deren Logik. Das ⋯-Menü und das
|
||||
* Ausblenden gehören zu Analytics; im Dashboard macht das die Widget-Registry
|
||||
* der Software (`docs/SCOPE-ANALYTICS-DASHBOARD.md`, Abschnitt 3.3).
|
||||
*
|
||||
@@ -23,7 +23,7 @@ import { ZEITRAUM_LABEL, type WidgetDomaene, type WidgetZeitraum } from "../../v
|
||||
*
|
||||
* 2. **Einen eigenen Zeitraum.** In Analytics gilt ein Filter für alle Karten.
|
||||
* Im Dashboard trägt jede Kachel ihren eigenen (P11: „Edit = nur
|
||||
* Widget-Filter/Zeitraum"). Deshalb steht er auf der Kachel — ohne das
|
||||
* Widget-Filter/Zeitraum"). Deshalb steht er auf der Kachel, ohne das
|
||||
* zeigt eine Kachel stillschweigend einen anderen Zeitraum als ihre
|
||||
* Nachbarin, und niemand merkt es.
|
||||
*/
|
||||
@@ -54,11 +54,11 @@ export function WidgetKachel({
|
||||
}: {
|
||||
titel: string;
|
||||
untertitel?: string;
|
||||
/** Erklärt die Kennzahl; erscheint als Tooltip am (i) — wie in Analytics. */
|
||||
/** Erklärt die Kennzahl; erscheint als Tooltip am (i): wie in Analytics. */
|
||||
hinweis?: string;
|
||||
domaene: WidgetDomaene;
|
||||
zeitraum: WidgetZeitraum;
|
||||
/** Ziel des Absprungs in die Analyse — `widget.drilldownHref` in der Software. */
|
||||
/** Ziel des Absprungs in die Analyse: `widget.drilldownHref` in der Software. */
|
||||
absprung?: string;
|
||||
absprungText?: string;
|
||||
children: React.ReactNode;
|
||||
@@ -67,7 +67,7 @@ export function WidgetKachel({
|
||||
return (
|
||||
<section
|
||||
/* @container: Die Kachelbreite hängt am Raster, nicht am Fenster. Eine
|
||||
Vier-Zwölftel-Kachel ist bei 1024 px rund 235 px breit — dieselbe
|
||||
Vier-Zwölftel-Kachel ist bei 1024 px rund 235 px breit: dieselbe
|
||||
Kachel bei 1920 px doppelt so viel. Was sich im Kopf einblendet, muss
|
||||
deshalb die Kachel messen und nicht den Viewport. */
|
||||
className={`@container flex h-full flex-col overflow-hidden rounded-lg border border-solid border-border-default bg-white shadow-sm ${className}`}
|
||||
@@ -112,7 +112,7 @@ export function WidgetKachel({
|
||||
{/* justify-center: Karten einer Zeile sind gleich hoch, aber nicht gleich
|
||||
voll. Eine Karte mit einem Balken neben einer mit einem Diagramm über
|
||||
400 px bekommt den Überschuss oben und unten je zur Hälfte, statt ihn
|
||||
unten abzuladen. Der Inhalt behält seine natürliche Höhe — die Karte
|
||||
unten abzuladen. Der Inhalt behält seine natürliche Höhe, die Karte
|
||||
wächst weiter mit, wenn mehr hineinkommt. */}
|
||||
<div className="flex min-h-0 grow flex-col justify-center px-4 pb-4">{children}</div>
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ import React from "react";
|
||||
/**
|
||||
* Das Kachelraster des Dashboards.
|
||||
*
|
||||
* Übernommen aus `DashboardPage.tsx` der Software — dort steht wörtlich
|
||||
* Übernommen aus `DashboardPage.tsx` der Software, dort steht wörtlich
|
||||
*
|
||||
* <div className="grid grid-cols-1 gap-4 md:grid-cols-2
|
||||
* lg:grid-flow-row-dense lg:grid-cols-12">
|
||||
@@ -15,7 +15,7 @@ import React from "react";
|
||||
* `{ size: { w: 8 }, position: { x: 0 } }`.
|
||||
*
|
||||
* Der Unterschied ist die Herkunft der Zahlen, nicht ihre Bedeutung. Im
|
||||
* Prototyp sind sie geschrieben, in der Software gespeichert — dort kann der
|
||||
* Prototyp sind sie geschrieben, in der Software gespeichert, dort kann der
|
||||
* Benutzer das Layout bearbeiten.
|
||||
*/
|
||||
export function WidgetRaster({ children }: { children: React.ReactNode }) {
|
||||
@@ -28,7 +28,7 @@ export function WidgetRaster({ children }: { children: React.ReactNode }) {
|
||||
|
||||
/**
|
||||
* Eine Rasterzelle. Zeichengleich zu `dashboardWidgetGridClass` in der
|
||||
* Software — bis auf einen Zusatz: Dort fehlt der Fall `x === 9`, weil noch
|
||||
* Software, bis auf einen Zusatz: Dort fehlt der Fall `x === 9`, weil noch
|
||||
* keine Rolle vier Kacheln nebeneinander stellt. Unsere Kennzahlenreihe tut
|
||||
* das, deshalb steht er hier. Beim Einbau ist das die eine Zeile, die in
|
||||
* `dashboardWidgetGridClass` zu ergänzen ist; ohne sie fließt die vierte
|
||||
@@ -41,15 +41,15 @@ export function Widget({
|
||||
mittelVoll = false,
|
||||
children,
|
||||
}: {
|
||||
/** Spalten von zwölf — entspricht `widget.size.w`. */
|
||||
/** Spalten von zwölf: entspricht `widget.size.w`. */
|
||||
breite: 3 | 4 | 6 | 8 | 12;
|
||||
/** Erste Spalte, nullbasiert — entspricht `widget.position.x`. */
|
||||
/** Erste Spalte, nullbasiert: entspricht `widget.position.x`. */
|
||||
start?: 0 | 3 | 4 | 6 | 8 | 9;
|
||||
/**
|
||||
* Volle Breite schon im Zweispalter zwischen `md` und `lg`, obwohl die
|
||||
* Kachel schmaler als sechs Zwölftel ist. Für die Fälle, in denen die
|
||||
* Nachbarkachel derselben Zeile breit ist und die schmale sonst allein in
|
||||
* einer halben Zeile stünde — die andere Hälfte bliebe leer.
|
||||
* einer halben Zeile stünde, die andere Hälfte bliebe leer.
|
||||
*/
|
||||
mittelVoll?: boolean;
|
||||
children: React.ReactNode;
|
||||
@@ -85,7 +85,7 @@ export function Widget({
|
||||
* werden darf, entscheidet der Inhalt:
|
||||
*
|
||||
* Kennzahlen und Listen (drei bis vier Zwölftel) vertragen eine halbe Spalte
|
||||
* — bei 768 px sind das rund 200 px, und mehr braucht eine Zahl mit Etikett
|
||||
* bei 768 px sind das rund 200 px, und mehr braucht eine Zahl mit Etikett
|
||||
* nicht. Diagramme (sechs Zwölftel und mehr) vertragen es nicht: Auf 200 px
|
||||
* rücken die Beschriftungen der Zeitachse ineinander, und die Balken der
|
||||
* Auslastung schrumpfen auf Strichbreite. Sie nehmen deshalb schon hier die
|
||||
|
||||
@@ -21,7 +21,7 @@ const ZEITRAEUME: ZeitraumPreset[] = ["heute", "7_tage", "30_tage", "quartal", "
|
||||
* Filterleiste über dem Seiteninhalt.
|
||||
*
|
||||
* Zeigt nur die Filter, die auf der jeweiligen Seite etwas bewirken
|
||||
* (FILTER_RELEVANZ) — ein Auftragsstatus-Filter auf der Finanzseite würde
|
||||
* (FILTER_RELEVANZ): ein Auftragsstatus-Filter auf der Finanzseite würde
|
||||
* sonst wirkungslos wirken und Vertrauen kosten.
|
||||
* Aktive Einschränkungen erscheinen darunter als entfernbare Chips (FILT-06).
|
||||
*/
|
||||
@@ -30,7 +30,7 @@ export function AnalyticsToolbar({
|
||||
optionen,
|
||||
}: {
|
||||
seite: SeitenId;
|
||||
/** Auswahllisten aus dem vollständigen Datensatz — in der Software aus dem Loader. */
|
||||
/** Auswahllisten aus dem vollständigen Datensatz, in der Software aus dem Loader. */
|
||||
optionen: FilterOptionen;
|
||||
}) {
|
||||
const { filter, setFilter, toggleWert, leereFeld, zuruecksetzen } = useFilter();
|
||||
@@ -70,7 +70,7 @@ export function AnalyticsToolbar({
|
||||
<div className="dv-no-print sticky top-14 z-20 flex flex-col gap-2 border-b border-solid border-border-default bg-neutral-50/95 px-4 py-3 backdrop-blur sm:px-6">
|
||||
{/* `relative` ist der Bezugsrahmen für die Filter-Panels: Unter `sm`
|
||||
hängen sie an dieser Zeile statt am einzelnen Knopf und nutzen die
|
||||
volle Breite — siehe MehrfachAuswahl. */}
|
||||
volle Breite: siehe MehrfachAuswahl. */}
|
||||
<div className="relative flex flex-wrap items-center gap-2">
|
||||
{/* Zeitraum als Segment-Control: eine Auswahl, immer sichtbar.
|
||||
*
|
||||
@@ -79,7 +79,7 @@ export function AnalyticsToolbar({
|
||||
* Ein Segment-Control ist ein Bauteil mit einem Rahmen, und die
|
||||
* Stufen stehen in einer Reihenfolge (heute → alles). Über zwei
|
||||
* Zeilen gebrochen liest es sich als zwei Steuerelemente, und die
|
||||
* Reihenfolge geht verloren. Deshalb scrollt es waagerecht — ohne
|
||||
* Reihenfolge geht verloren. Deshalb scrollt es waagerecht, ohne
|
||||
* sichtbare Leiste, weil der angeschnittene letzte Knopf schon
|
||||
* anzeigt, dass es weitergeht.
|
||||
*
|
||||
|
||||
@@ -53,7 +53,7 @@ export function MehrfachAuswahl({
|
||||
|
||||
return (
|
||||
// Unter `sm` bewusst *nicht* `relative`: Das Panel ist 256 px breit, der
|
||||
// vierte Filterknopf steht bei 375 px aber schon bei x = 278 — an den Knopf
|
||||
// vierte Filterknopf steht bei 375 px aber schon bei x = 278: an den Knopf
|
||||
// gehängt liefe es weit aus dem Bild. Ohne eigenen Bezugsrahmen hängt es
|
||||
// stattdessen an der Filterleiste (AnalyticsToolbar, `relative` an der
|
||||
// Knopfzeile) und nimmt dort die volle Zeilenbreite ein.
|
||||
|
||||
@@ -11,20 +11,20 @@ import type { SeitenId } from "../../data/filtering";
|
||||
/**
|
||||
* Innere Navigation des Analytics-Bereichs.
|
||||
*
|
||||
* Nachbau von `SidebarIconsLayout` aus dem Zielsystem — der Leiste, die dort
|
||||
* Nachbau von `SidebarIconsLayout` aus dem Zielsystem, der Leiste, die dort
|
||||
* jeder Arbeitsbereich mit Geschwisterseiten benutzt (Leads, Termine, HR,
|
||||
* Einstellungen; 17 Aufrufstellen). Analytics mit fünf Analyse-Seiten ist
|
||||
* derselbe Fall.
|
||||
*
|
||||
* Verhalten wie dort: eine schmale Icon-Leiste, die bei Zeigerkontakt oder
|
||||
* Tastaturfokus auf Beschriftungen aufklappt — verzögert, damit sie beim
|
||||
* Tastaturfokus auf Beschriftungen aufklappt: verzögert, damit sie beim
|
||||
* bloßen Überstreichen nicht aufspringt. Unterhalb `sm` tritt an ihre Stelle
|
||||
* eine Reiterleiste; auch das ist aus dem Original übernommen.
|
||||
*
|
||||
* ────────────────────────────────────────────────────────────────────────────
|
||||
* BEIM EINBAU: Dieser Nachbau wird NICHT portiert.
|
||||
*
|
||||
* Verbindlich ist die Verabredung — Analytics bekommt eine innere Leiste mit
|
||||
* Verbindlich ist die Verabredung: Analytics bekommt eine innere Leiste mit
|
||||
* den fünf Analyse-Seiten. Gebaut wird sie in HiveGrid mit dem dortigen
|
||||
* `SidebarIconsLayout`, das genau diesen Zweck hat (Leads, Termine, HR,
|
||||
* Einstellungen nutzen es bereits). Diese Datei beschreibt das Ziel, sie ist
|
||||
@@ -101,11 +101,11 @@ export function AnalyticsInnerNav({
|
||||
</SidebarInside>
|
||||
</div>
|
||||
|
||||
{/* Schmale Fenster: Reiter statt Leiste — wie im Original.
|
||||
{/* Schmale Fenster: Reiter statt Leiste, wie im Original.
|
||||
Waagerecht scrollend statt umbrechend: Fünf Reiter brauchen mindestens
|
||||
425 px, bei 375 px lief die ganze Seite dadurch seitlich über. Über
|
||||
zwei Zeilen gebrochen liest sich ein Reiterband als zwei Steuerelemente
|
||||
— dasselbe Mittel wie beim Zeitraum-Segment in der Filterleiste. */}
|
||||
dasselbe Mittel wie beim Zeitraum-Segment in der Filterleiste. */}
|
||||
<div className="dv-scroll-x w-full min-w-0 overflow-x-auto border-b border-solid border-border-default bg-white px-4 py-2 sm:hidden">
|
||||
<Tabs className="w-max min-w-full">
|
||||
{ANALYSE_SEITEN.map((seite) => (
|
||||
|
||||
@@ -13,12 +13,12 @@ import type { FilterOptionen } from "../../view-models/filter-optionen";
|
||||
*
|
||||
* „Analytics" ist in der Seitenleiste **ein** Menüpunkt. Die fünf Analyse-Seiten
|
||||
* sind darin über Reiter erreichbar und tauchen nicht als Unterpunkte in der
|
||||
* Navigation auf — sonst konkurrieren zwei Navigationsebenen um dieselbe Sache.
|
||||
* Navigation auf, sonst konkurrieren zwei Navigationsebenen um dieselbe Sache.
|
||||
*
|
||||
* Die Unter-Navigation ist eine **innere Leiste**, kein Reiterband: Das
|
||||
* Zielsystem benutzt für Arbeitsbereiche mit Geschwisterseiten durchgängig
|
||||
* `SidebarIconsLayout` (Leads, Termine, HR, Einstellungen). Reiter sind dort
|
||||
* für Abschnitte *innerhalb einer Seite* reserviert — und sind zugleich der
|
||||
* für Abschnitte *innerhalb einer Seite* reserviert, und sind zugleich der
|
||||
* Rückfall der inneren Leiste auf schmalen Fenstern. Begründung ausführlich
|
||||
* in docs/NAVIGATION.md.
|
||||
*
|
||||
|
||||
@@ -13,7 +13,7 @@ import { formatDatum, formatZahl } from "../../utils/formatters";
|
||||
import { HEUTE } from "../../utils/dateUtils";
|
||||
|
||||
/**
|
||||
* Rahmen der Anwendung — Seitenleiste nach dem Vorbild von HiveGrid Cloud.
|
||||
* Rahmen der Anwendung: Seitenleiste nach dem Vorbild von HiveGrid Cloud.
|
||||
*
|
||||
* Bewusst dieselbe Komponente wie dort (`~/ui/components/SidebarWithSections`)
|
||||
* mit denselben Gruppen und derselben Reihenfolge. Wer den Prototyp neben der
|
||||
@@ -22,7 +22,7 @@ import { HEUTE } from "../../utils/dateUtils";
|
||||
*
|
||||
* Jeder Eintrag führt auf eine echte Seite. „Dashboard" landet auf einer
|
||||
* Platzhalterseite, weil es ein eigenes Feature ist und hier nicht gestaltet
|
||||
* wird — aber ein Menüpunkt, der nur einen Hinweis auslöst, lässt offen, ob
|
||||
* wird, aber ein Menüpunkt, der nur einen Hinweis auslöst, lässt offen, ob
|
||||
* etwas fehlt oder etwas kaputt ist.
|
||||
*
|
||||
* ────────────────────────────────────────────────────────────────────────────
|
||||
@@ -31,7 +31,7 @@ import { HEUTE } from "../../utils/dateUtils";
|
||||
* Sie existiert, damit der Prototyp alleine lauffähig ist. In HiveGrid Cloud
|
||||
* übernehmen `SubframeAppShell` und `AppSidebar`. Verbindlich ist aus dieser
|
||||
* Datei allein die **Struktur**: zwei Einträge in der Seitenleiste, Dashboard
|
||||
* und Analytics — mehr nicht, weil alles Übrige dort schon steht.
|
||||
* und Analytics, mehr nicht, weil alles Übrige dort schon steht.
|
||||
*
|
||||
* Globale Regeln (Schrift, Größen, Abstände, Farben, Control-Höhen) kommen
|
||||
* ausschließlich aus HiveGrid und werden von hier aus nicht überschrieben.
|
||||
@@ -48,7 +48,7 @@ export function AppShell({ children }: { children: React.ReactNode }) {
|
||||
const istSchmal = useIstSchmal();
|
||||
const ausloeser = React.useRef<HTMLButtonElement>(null);
|
||||
|
||||
// Beim Seitenwechsel schließen — sonst bleibt die Leiste über dem Ziel
|
||||
// Beim Seitenwechsel schließen, sonst bleibt die Leiste über dem Ziel
|
||||
// liegen. Der Pfad wandert dafür in den State: Zustand beim Rendern
|
||||
// anzupassen ist hier richtig, ein Effekt würde einen zweiten Durchlauf
|
||||
// auslösen und die Leiste kurz über der neuen Seite zeigen.
|
||||
@@ -69,7 +69,7 @@ export function AppShell({ children }: { children: React.ReactNode }) {
|
||||
* Nicht optional: Der Rahmen trägt `role="dialog"` und `aria-modal`, und
|
||||
* damit ist einem Screenreader zugesagt, dass nichts dahinter erreichbar ist.
|
||||
* Ohne Falle wandert der Tabulator hinter die Abdeckung in eine Seite, die
|
||||
* optisch verdeckt ist — die Zusage wäre eine Unwahrheit.
|
||||
* optisch verdeckt ist, die Zusage wäre eine Unwahrheit.
|
||||
*
|
||||
* Übernommen aus `SubframeAppShell` im Zielsystem: Tab und Umschalt+Tab
|
||||
* laufen zyklisch, Escape schließt und gibt den Fokus an den Auslöser
|
||||
@@ -78,7 +78,7 @@ export function AppShell({ children }: { children: React.ReactNode }) {
|
||||
* Beim Öffnen bekommt der **Rahmen** den Fokus, nicht der erste Link. Das
|
||||
* ist das übliche Vorgehen für einen Dialog und hat hier einen sichtbaren
|
||||
* Grund: Ein per Skript fokussierter Link zeigt in Chrome seinen Fokusring,
|
||||
* auch wenn die Schublade mit der Maus geöffnet wurde — dann liegt ein
|
||||
* auch wenn die Schublade mit der Maus geöffnet wurde, dann liegt ein
|
||||
* blauer Rahmen um „Dashboard", ohne dass jemand dorthin getippt hat. Der
|
||||
* Rahmen selbst trägt `tabIndex={-1}` und keinen Ring; die Sprachausgabe
|
||||
* liest trotzdem den Dialog an, und der erste Tabulatorschritt landet auf
|
||||
@@ -112,7 +112,7 @@ export function AppShell({ children }: { children: React.ReactNode }) {
|
||||
const aktiv = document.activeElement;
|
||||
// `aktiv === leiste` gehört dazu: Direkt nach dem Öffnen liegt der Fokus
|
||||
// auf dem Rahmen selbst. Er steht im Dokument vor seinen Kindern, also
|
||||
// muss Umschalt+Tab von dort ans Ende springen — sonst verlässt der
|
||||
// muss Umschalt+Tab von dort ans Ende springen, sonst verlässt der
|
||||
// Tabulator den Dialog rückwärts, und die Zusage von `aria-modal` wäre
|
||||
// gebrochen.
|
||||
if (event.shiftKey && (aktiv === erstes || aktiv === leiste || !leiste.contains(aktiv))) {
|
||||
@@ -132,13 +132,13 @@ export function AppShell({ children }: { children: React.ReactNode }) {
|
||||
/**
|
||||
* Zuletzt benutzte Eingabeart am Wurzelelement vermerken.
|
||||
*
|
||||
* `:focus-visible` allein reicht nicht: Wenn ein Skript den Fokus setzt —
|
||||
* beim Schließen der Schublade zurück auf den Hamburger — behandelt Chrome
|
||||
* `:focus-visible` allein reicht nicht: Wenn ein Skript den Fokus setzt,
|
||||
* beim Schließen der Schublade zurück auf den Hamburger: behandelt Chrome
|
||||
* das wie Tastaturbedienung und zeigt den Ring. Nach einem Mausklick steht
|
||||
* er dann sichtbar da, bis man woanders hinklickt.
|
||||
*
|
||||
* Die Regel dazu steht in `app/globals.css`. Sie unterdrückt den Ring nur,
|
||||
* solange die letzte Eingabe ein Zeiger war, und nur an Knöpfen und Links —
|
||||
* solange die letzte Eingabe ein Zeiger war, und nur an Knöpfen und Links,
|
||||
* Eingabefelder behalten ihn immer, dort gehört er zum Zustand „hier wird
|
||||
* gerade geschrieben". Der erste Tastendruck schaltet ihn sofort zurück.
|
||||
*/
|
||||
@@ -203,8 +203,8 @@ export function AppShell({ children }: { children: React.ReactNode }) {
|
||||
|
||||
{/* z-50 ist nötig, nicht dekorativ: `position: sticky` erzeugt einen
|
||||
eigenen Stapelkontext. Ohne z-Wert am Rahmen bleibt das z-index des
|
||||
Einklapp-Knopfes darin gefangen, und die Inhaltsspalte — ein späteres
|
||||
Geschwisterelement — malt über den Teil, der aus der Leiste
|
||||
Einklapp-Knopfes darin gefangen, und die Inhaltsspalte, ein späteres
|
||||
Geschwisterelement: malt über den Teil, der aus der Leiste
|
||||
herausragt. Die Software setzt an derselben Stelle ebenfalls z-50. */}
|
||||
<div
|
||||
ref={leisteRef}
|
||||
|
||||
@@ -2,11 +2,11 @@ import React from "react";
|
||||
|
||||
/**
|
||||
* Inhaltsspalte einer Seite.
|
||||
* 24 px Außenabstand, 16 px Rasterabstand — entspricht dem 8-px-System
|
||||
* 24 px Außenabstand, 16 px Rasterabstand: entspricht dem 8-px-System
|
||||
* aus den UI-Guidelines (internal ≤ external).
|
||||
*
|
||||
* Unter `sm` sind 24 px Rand ein Achtel der Fensterbreite: Der Rand kostet
|
||||
* dort mehr Platz, als er Ruhe bringt. Deshalb 16 px — der nächste Wert der
|
||||
* dort mehr Platz, als er Ruhe bringt. Deshalb 16 px, der nächste Wert der
|
||||
* Skala, nicht ein neuer.
|
||||
*/
|
||||
export function PageContainer({ children }: { children: React.ReactNode }) {
|
||||
@@ -32,7 +32,7 @@ export function Raster({
|
||||
}) {
|
||||
/**
|
||||
* Jede Leiter beginnt einspaltig. Zwei Spalten sind bei 375 px rund 155 px
|
||||
* je Karte — darin bricht ein Währungswert zwischen Betrag und Euro-Zeichen
|
||||
* je Karte: darin bricht ein Währungswert zwischen Betrag und Euro-Zeichen
|
||||
* um, und die Karte wird höher statt schmaler.
|
||||
*
|
||||
* Wann die erste Verdopplung kommt, hängt am Inhalt, nicht an der Zielzahl:
|
||||
@@ -42,7 +42,7 @@ export function Raster({
|
||||
* Diagramme und Tabellen, die halbiert erst ab `md` lesbar bleiben.
|
||||
*
|
||||
* Keine Leiter erhöht bei `md`: Dort kommt die Seitenleiste zurück und
|
||||
* nimmt 240 px weg — die Karten würden schmaler statt breiter.
|
||||
* nimmt 240 px weg, die Karten würden schmaler statt breiter.
|
||||
*
|
||||
* Ab 1024 px ist jede Leiter identisch zum abgenommenen Stand.
|
||||
*/
|
||||
|
||||
@@ -6,7 +6,7 @@ import { useToast } from "../../context/ToastContext";
|
||||
|
||||
/**
|
||||
* Kopf einer Analyse-Seite: Titel, Einordnung, Seitenaktionen.
|
||||
* Die Aktionen sind im Prototyp bewusst folgenlos (Toast statt Export) —
|
||||
* Die Aktionen sind im Prototyp bewusst folgenlos (Toast statt Export),
|
||||
* siehe HANDOVER.md, Abschnitt "Was noch Logik braucht".
|
||||
*/
|
||||
export function PageHeader({
|
||||
@@ -15,7 +15,7 @@ export function PageHeader({
|
||||
aktionen,
|
||||
/**
|
||||
* Aktualisieren, Export und Teilen. Auf Seiten ohne Inhalt gibt es nichts zu
|
||||
* aktualisieren oder zu exportieren — dort schaltet man sie ab, statt
|
||||
* aktualisieren oder zu exportieren, dort schaltet man sie ab, statt
|
||||
* Schaltflächen anzubieten, die ins Leere greifen.
|
||||
*/
|
||||
standardAktionen = true,
|
||||
@@ -29,8 +29,8 @@ export function PageHeader({
|
||||
|
||||
/**
|
||||
* Unter `sm` tragen die beiden beschrifteten Knöpfe nur ihr Icon.
|
||||
* Nebeneinander brauchen "Aktualisieren" und "Export" rund 240 px — mehr,
|
||||
* als bei 375 px neben dem Titel überhaupt vorhanden ist. Die Beschriftung
|
||||
* Nebeneinander brauchen "Aktualisieren" und "Export" rund 240 px. Das ist
|
||||
* mehr, als bei 375 px neben dem Titel überhaupt vorhanden ist. Die Beschriftung
|
||||
* entfällt, `aria-label` bleibt: Für die Sprachausgabe ändert sich nichts.
|
||||
*/
|
||||
const knopf =
|
||||
@@ -40,7 +40,7 @@ export function PageHeader({
|
||||
|
||||
return (
|
||||
// Unter `sm` untereinander: Titel und Aktionen nebeneinander lassen für den
|
||||
// Titel keine 130 px übrig — er zerfiele in vier Zeilen, während die Knöpfe
|
||||
// Titel keine 130 px übrig, er zerfiele in vier Zeilen, während die Knöpfe
|
||||
// aus dem Bild laufen.
|
||||
<div className="flex flex-col items-stretch gap-4 px-4 pb-6 pt-6 sm:flex-row sm:flex-wrap sm:items-start sm:justify-between sm:px-6">
|
||||
<div className="flex min-w-0 flex-col gap-0">
|
||||
|
||||
@@ -4,7 +4,7 @@ import type { SeitenId } from "../../data/filtering";
|
||||
* Navigationsstruktur des Prototyps.
|
||||
*
|
||||
* Hier stehen **nur unsere beiden Features**: Dashboard und Analytics. Alles
|
||||
* andere — Kontakte, Leads, Pipelines, Postfach, Termine, Einstellungen — ist
|
||||
* andere (Kontakte, Leads, Pipelines, Postfach, Termine, Einstellungen) ist
|
||||
* in der Seitenleiste der Software bereits vorhanden und wird hier nicht
|
||||
* verdoppelt. Der Prototyp zeigt, was dazukommt, nicht was schon da ist.
|
||||
*
|
||||
@@ -37,7 +37,7 @@ export interface NavGruppe {
|
||||
/** Einstieg des Analytics-Bereichs. */
|
||||
export const ANALYTICS_START = "/analytics";
|
||||
|
||||
/** Der Begrüßungsbildschirm — Ziel der Weiterleitung von „/", wie in der Software. */
|
||||
/** Der Begrüßungsbildschirm: Ziel der Weiterleitung von „/", wie in der Software. */
|
||||
export const DASHBOARD_START = "/dashboard";
|
||||
|
||||
export const NAV_GRUPPEN: NavGruppe[] = [
|
||||
@@ -46,7 +46,7 @@ export const NAV_GRUPPEN: NavGruppe[] = [
|
||||
titel: "",
|
||||
eintraege: [
|
||||
{
|
||||
// Der Begrüßungsbildschirm — eine einzelne Seite, deshalb ohne innere
|
||||
// Der Begrüßungsbildschirm, eine einzelne Seite, deshalb ohne innere
|
||||
// Leiste. Er ist das Ziel der Weiterleitung von „/".
|
||||
id: "dashboard",
|
||||
label: "Dashboard",
|
||||
@@ -66,10 +66,10 @@ export const NAV_GRUPPEN: NavGruppe[] = [
|
||||
];
|
||||
|
||||
/**
|
||||
* Unterer Bereich, durch einen Trenner abgesetzt — wie in der Software.
|
||||
* Unterer Bereich, durch einen Trenner abgesetzt, wie in der Software.
|
||||
*
|
||||
* Hier steht nur, was zum Prototyp gehört: die Bausteingalerie. Sie ist für
|
||||
* die **Abstimmung** da, nicht für die Umsetzung — sie zeigt jeden Baustein in
|
||||
* die **Abstimmung** da, nicht für die Umsetzung, sie zeigt jeden Baustein in
|
||||
* allen Zuständen, auch in denen, die die Demo-Daten nie erzeugen (negativer
|
||||
* Trend, leer, Fehler, „kleiner ist besser"). Wer den Prototyp einbaut,
|
||||
* braucht sie nicht: Dafür sind die Datei-Pfade und `docs/DESIGN-SYSTEM.md`
|
||||
@@ -88,7 +88,7 @@ export const NAV_SEKUNDAER: NavEintrag[] = [
|
||||
|
||||
/**
|
||||
* Die fünf Analyse-Seiten. Sie erscheinen **nicht** in der Seitenleiste,
|
||||
* sondern als Reiter innerhalb des Menüpunkts „Analytics" — dem Hausmuster
|
||||
* sondern als Reiter innerhalb des Menüpunkts „Analytics": dem Hausmuster
|
||||
* für Unter-Navigation in HiveGrid (`SettingsHubShell.tsx`: ein `Link` um ein
|
||||
* `Tabs.Item`, damit jeder Reiter eine echte Navigation ist).
|
||||
*/
|
||||
@@ -107,21 +107,21 @@ export const ANALYSE_SEITEN: AnalyseSeite[] = [
|
||||
icon: "LayoutDashboard",
|
||||
label: "Übersicht",
|
||||
href: "/analytics",
|
||||
beschreibung: "Die Kennzahlen, nach denen der Betrieb gesteuert wird — Umsatz, Auslastung, offene Posten und Handlungsbedarf.",
|
||||
beschreibung: "Die Kennzahlen, nach denen der Betrieb gesteuert wird: Umsatz, Auslastung, offene Posten und Handlungsbedarf.",
|
||||
},
|
||||
{
|
||||
id: "finanzen",
|
||||
icon: "Euro",
|
||||
label: "Finanzen",
|
||||
href: "/analytics/finanzen",
|
||||
beschreibung: "Umsatz, Zahlungseingang und offene Forderungen — die Sicht der Buchhaltung auf den Betrieb.",
|
||||
beschreibung: "Umsatz, Zahlungseingang und offene Forderungen: die Sicht der Buchhaltung auf den Betrieb.",
|
||||
},
|
||||
{
|
||||
id: "auftraege",
|
||||
icon: "ClipboardList",
|
||||
label: "Aufträge",
|
||||
href: "/analytics/auftraege",
|
||||
beschreibung: "Von der Anfrage bis zur Abnahme — wo die Vorgänge stehen, was gebunden ist und was über Termin läuft.",
|
||||
beschreibung: "Von der Anfrage bis zur Abnahme: wo die Vorgänge stehen, was gebunden ist und was über Termin läuft.",
|
||||
},
|
||||
{
|
||||
id: "kunden",
|
||||
@@ -135,6 +135,6 @@ export const ANALYSE_SEITEN: AnalyseSeite[] = [
|
||||
icon: "HardHat",
|
||||
label: "Team",
|
||||
href: "/analytics/team",
|
||||
beschreibung: "Auslastung, produktive Stunden und Abschlüsse der Monteure — die Kennzahl hinter der Terminplanung.",
|
||||
beschreibung: "Auslastung, produktive Stunden und Abschlüsse der Monteure: die Kennzahl hinter der Terminplanung.",
|
||||
},
|
||||
];
|
||||
@@ -14,7 +14,7 @@ export interface Spalte<T> {
|
||||
titel: string;
|
||||
/** Zellinhalt; darf beliebige Knoten liefern (Badges, Links). */
|
||||
zelle: (zeile: T) => React.ReactNode;
|
||||
/** Sortierwert — ohne diesen ist die Spalte nicht sortierbar. */
|
||||
/** Sortierwert, ohne diesen ist die Spalte nicht sortierbar. */
|
||||
sortWert?: (zeile: T) => number | string;
|
||||
/** Zahlen gehören rechtsbündig und in Tabellenziffern. */
|
||||
numerisch?: boolean;
|
||||
@@ -26,7 +26,7 @@ export interface Spalte<T> {
|
||||
*
|
||||
* Enthält die Interaktionen, die man in einer Demo wirklich braucht:
|
||||
* Sortieren per Klick auf den Spaltenkopf, Volltextsuche, Blättern.
|
||||
* Alles clientseitig — bei echten Datenmengen gehört das auf den Server.
|
||||
* Alles clientseitig, bei echten Datenmengen gehört das auf den Server.
|
||||
*/
|
||||
export function DataTable<T extends { id: string }>({
|
||||
zeilen,
|
||||
@@ -105,7 +105,7 @@ export function DataTable<T extends { id: string }>({
|
||||
{/* Der waagerechte Scrollbereich der Tabelle. Ohne min-w-0 am Elternteil
|
||||
greift er nicht: Ein Flex-Kind wird nicht schmaler als sein Inhalt,
|
||||
die Tabelle bliebe also breit und schöbe stattdessen die Seite auf.
|
||||
Vorher trug der Bereich zusätzlich -mx-1/px-1 — das machte ihn 8 px
|
||||
Vorher trug der Bereich zusätzlich -mx-1/px-1: das machte ihn 8 px
|
||||
breiter als seine Spalte und ließ die Karte um 4 px überlaufen. Den
|
||||
Fokusring der Sortierknöpfe deckt bereits das px-2 der Kopfzelle. */}
|
||||
<div className="dv-scroll w-full min-w-0 overflow-x-auto">
|
||||
|
||||
Reference in new issue
Block a user