kundencenter/docs/design
Claude (KI) 03cf2b00c4 Öffentliche Statusseite mit Wartungs- und Vorfallverwaltung (#23)
- Modul status (Migration 044): Störungen und Wartungen mit Zustand,
  Auswirkung, Bereich, Zeitraum und Meldungsverlauf. Öffentlich
  (/v1/public/status, Seite /status) nur, was das Personal veröffentlicht –
  nur dessen Texte, keine Kunden-/Ressourcen-/Anbieterdaten, nicht aus den
  internen Betriebsalarmen gespeist. Gesamtzustand aus aktiven Einträgen;
  angekündigte Wartungen zählen erst ab Beginn.
- Verwaltung /admin/status (Support/Admin/Superadmin; Buchhaltung und Kunden
  nicht), Navigation.
- Tests: API (Rechte, Veröffentlichung, Zustände, Abschluss, Felder) und
  Browser (Status- und Registrierungsseite barrierefrei, 12/12 grün).
Passkeys und Berichte bleiben eigene offene Teilaufgaben.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 13:32:19 +02:00
..
README.md Formularhinweise per aria-describedby an das Eingabefeld binden 2026-10-06 12:19:20 +02:00
sitemap.md Öffentliche Statusseite mit Wartungs- und Vorfallverwaltung (#23) 2026-10-06 13:32:19 +02:00

Designsystem und Seitenstruktur

Stand: 06.10.2026. Quelle der Wahrheit ist der Code: Tokens in apps/web/src/app/globals.css, Bausteine in apps/web/src/components/ui.tsx, Icons in components/Icon.tsx (Lucide-Pfade, keine Emojis). Stil „FlessingLabs“ (an flessinglabs.com angelehnt, live seit #121–#127) – die frühere Calm-Cloud/KeyControl-Palette ist abgelöst und wird nicht wiederhergestellt.

  • sitemap.md – Seitenlandkarte (öffentlich, Kunde, Personal) und Kernabläufe
  • Dieses Dokument – Tokens, Komponenten, Zustände, Barrierefreiheit

Tokens (CSS-Variablen)

Gruppe Hell Dunkel Verwendung
Hintergrund/Fläche --bg #f5f7fb, --surface #fff, --surface-2 #eef1f7 #05060a, #0b0d14, #121622 Seite, Karten, abgesetzte Flächen
Text --text #111522, --muted #5b6475 #f5f7ff, #9aa4b5 Fließtext, Nebeninfo (≥ 4,5:1 auf Fläche)
Akzent --accent #1a5fd0, --accent2 #0a7ea8, --focus #1a5fd0 #4d9dff, #20d4f5, #20d4f5 Links, primäre Aktionen, Fokusring
Rahmen --border #e3e7ef, --border-strong #7a8599 rgba(255,255,255,.08), #5f6b7c Trennlinien; Eingabefelder immer --border-strong (3:1 für UI-Komponenten)
Status --ok/-bg, --info/-bg, --warn/-bg, --err/-bg, --lock/-bg dunkle Varianten Badges, Hinweise; nie nur Farbe – immer Symbol + Text
Navigation --nav-bg #0b0d14 … #05060a … dunkle Seitenleiste in beiden Modi
Marke --brand-gradient (#20d4f5 → #2584ff → #7028ff), --brand-btn gleich Logo, primärer Knopf
Form --radius 12px, --radius-lg 16px, --radius-sm 10px
Abstände --s1 4, --s2 8, --s3 16, --s4 24, --s5 40 px
Schrift Geist / Geist Mono (next/font), Fallback system-ui

Hell/Dunkel folgt prefers-color-scheme; die manuelle Wahl (ThemeToggle) setzt data-theme und wird gemerkt.

Bausteine (components/ui.tsx)

  • Alert kind=err|warn|ok|info – Meldungen; err mit role="alert", sonst role="status".
  • Field id label hint – Label immer sichtbar und verknüpft, Hinweis per aria-describedby.
  • Empty title – Leerzustand mit Erklärung, was zu tun ist.
  • Status-Badges (Status, ResState, JobStatus, OrderStatusBadge, ContractStatusBadge, InvoiceStatusBadge, TicketStatusBadge) – Symbol (aria-hidden) + Klartext.
  • TableCards – Tabellen werden auf schmalen Bildschirmen (≤ 800 px) automatisch zu Karten (Spaltenkopf als Label).
  • SecretField – Geheimnisse nur auf ausdrücklichen Abruf, Kopieren ohne Anzeige.
  • Formatierer: fmt (Datum+Zeit), fmtDate, fmtDay (Kalendertag in UTC), eur (Cent → Euro).

Zustände (Pflicht für jede Seite mit Daten)

Zustand Vorgabe Beispiel
Laden Text „Wird geladen …“ mit role="status" (kein reiner Spinner) Rechnungen → Fällig
Leer Empty mit Titel und nächstem Schritt „Keine fälligen Perioden“
Fehler Alert kind="err" mit der Meldung der API (errMsg), Formularwerte bleiben erhalten alle Formulare
Offline / Server nicht erreichbar errMsg liefert „Der Server ist nicht erreichbar. Bitte später erneut versuchen.“ API-Client
Teilfehler / veraltet Alert kind="warn" + Badge „Veraltet“, es wird der zuletzt bekannte Stand gezeigt Ressourcen (Anbieter nicht erreichbar)
Gesperrt / Lizenz nötig Badge lock bzw. Hinweis „nur mit Lizenz“ mit Link zu Einstellungen → Lizenz Testmodus-Hinweisleiste
Betriebsalarm Karte „Betriebsalarme“ im Dashboard (role="alert") #38

Barrierefreiheit (WCAG 2.2 AA)

  • Kontrast Text ≥ 4,5:1, UI-Komponenten ≥ 3:1 (Eingaben mit --border-strong); geprüft automatisch per axe in apps/e2e (Login, Dashboard, Kundenliste, Kunden-Dashboard; hell/Desktop und dunkel/360 px).
  • Tastatur: sichtbarer Fokus (--focus), logische Reihenfolge, autoFocus nur auf dem ersten Feld eines Formulars, Enter sendet. E2E prüft Fokus/Tab/Enter auf der Anmeldung.
  • Mobil: Mindestgröße für Bedienelemente 44 px (untere Navigation 56 px), Navigation unten mit „Mehr“-Menü; kein horizontales Scrollen bei 360 px.
  • Bewegung: keine automatischen Animationen mit Bedeutung; Statusänderungen als Text.

Automatische Prüfung: ops/test/run-e2e.sh (CI-Job e2e, #39). Neue Seiten in apps/e2e/tests aufnehmen.