- 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> |
||
|---|---|---|
| .. | ||
| README.md | ||
| sitemap.md | ||
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;errmitrole="alert", sonstrole="status".Field id label hint– Label immer sichtbar und verknüpft, Hinweis peraria-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 inapps/e2e(Login, Dashboard, Kundenliste, Kunden-Dashboard; hell/Desktop und dunkel/360 px). - Tastatur: sichtbarer Fokus (
--focus), logische Reihenfolge,autoFocusnur 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.