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

@@ -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.",
},
];