Files
laraundfelix/docs/architektur/designsystem.md
T
LarsandClaude Opus 5.5 2ac2923852
CI Feature / test (push) Failing after 16s
Dokumentiere Abschnittsmodell, Rollback-Weg und Designsystem.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 20:40:30 +01:00

11 KiB
Raw Blame History

Gemeinsames Designsystem (ADR-36) – umgesetzter Stand

Stand: 17.11.2026, Branch feature/cms-sections. Gilt für öffentliche Website, Anmeldung, Mitgliederbereich und Mitgliederbibliothek; später für Warenkorb und Checkout. Die Verwaltung (Filament) bleibt in Standardgestaltung.

Status der Werte: Alle Markenwerte, Schriften und die Wortmarke sind vorläufig. Sie stammen aus docs/Brand-UI-Kit/02_design_tokens (Entwurf vom 15.11.2026, aus den Originalmotiven abgeleitet, laut Kit nicht freigegeben) und aus der Empfehlung im Website-Zielkonzept §7.2. Diese Datei ist keine Markenfreigabe. Eine Freigabe ändert ausschließlich resources/css/tokens.css (und für die Wortmarke resources/views/components/site/brand.blade.php).

1. Dateien

Datei Inhalt
resources/css/tokens.css Ebene 1 Markenwerte (--lf-*), Ebene 2 Bedeutungswerte (--color-*), Typografie, Abstände, Rundungen, Layoutmaße, Flächen-Gültigkeitsbereiche .scope-dark, .scope-accent, .scope-light
resources/css/base.css Grundelemente, Überschriften, Links, Fokus, Sprunglink, prefers-reduced-motion
resources/css/components.css Grundkomponenten: Container, Schaltflächen, Formulare, Statusanzeigen, Karte, Dialog, Kennzeile, Themensignatur, Redaktionshinweise
resources/css/site.css Website-Gerüst: Wortmarke, Kopfzeile, Hauptnavigation, mobile Navigation, Inhaltsfläche, Fußbereich
resources/css/sections.css Abschnitte, Raster, Flächen, Hintergrundbilder, Trenner
resources/css/widgets.css Widget-Ansichten (Container-Abfragen)
resources/css/app.css bindet alles ein; Mitgliederbereich über seine bisherigen Variablennamen, die auf die gemeinsamen Tokens zeigen
vite.config.js Schriften Nunito (700, 800) und Source Sans 3 (400, 600), beim Build lokal abgelegt; keine Anfrage an Fremdserver zur Laufzeit

2. Markenwerte (Ebene 1, vorläufig)

Token Wert Herkunft Verwendung
--lf-navy #032551 Brand-UI-Kit, Titelmotiv Überschriften, Navigation, dunkle Flächen, Fußbereich
--lf-navy-deep #01244c Brand-UI-Kit Reserve
--lf-green #5b8625 Brand-UI-Kit nur Flächen ohne Text (Weiß darauf nur 4,3:1)
--lf-green-deep #3b7b09 Brand-UI-Kit Aktionsfläche, Markenakzent, Link-Hover
--lf-yellow #fcd10a Brand-UI-Kit Akzentlinien, Trenner, aktive Navigation, Fokus auf dunklen Flächen; nie Textfarbe auf hellem Grund
--lf-cream #f7f6f2 Brand-UI-Kit helle Markenfläche
--lf-white #ffffff Brand-UI-Kit Seitenfläche, Karten
--lf-ink #15243a Brand-UI-Kit Fließtext
--lf-ink-muted #3e4c5c bisheriger Mitgliederbereich leiser Text
--lf-line #d5ddd6 bisheriger Mitgliederbereich Linien
--lf-focus #1769aa Brand-UI-Kit Fokusrahmen auf hellem Grund

Nicht übernommen: Farbwerte der KI-Konzeptgrafiken (04_visuelle_entwuerfe) und die nur in der HTML-Vorschau verwendeten Zwischentöne.

3. Bedeutungswerte (Ebene 2)

--color-text, --color-text-muted, --color-heading, --color-link, --color-link-hover, --color-surface, --color-surface-subtle, --color-surface-raised, --color-border, --color-border-strong, --color-focus, --color-accent, --color-action, --color-action-hover, --color-action-text, --color-action-secondary-text, --color-success(-surface), --color-warning(-surface), --color-danger(-surface), --color-info(-surface), --color-disabled(-surface), --color-theme-1 bis --color-theme-5.

Komponenten und Widgets verwenden nur diese Werte. Dunkle Flächen, Markenakzent und Hintergrundbilder setzen sie über .scope-dark, .scope-accent und .scope-light neu; Karten mit eigener heller Fläche setzen sie lokal zurück. Dadurch funktionieren alle Widgets auf allen Abschnittsflächen ohne Sonderregeln.

4. Kontraste (berechnet nach WCAG-Formel)

Paar Kontrast Anforderung
Fließtext #15243a auf Weiß / Creme 15,61 / 14,43 : 1 Text 4,5
Leiser Text #3e4c5c auf Weiß / Creme 8,78 / 8,11 : 1 Text 4,5
Navy (Überschrift, Link) auf Weiß 15,14 : 1 Text 4,5
Weiß auf Aktionsgrün #3b7b09 (Schaltfläche, Markenakzent) 5,22 : 1 Text 4,5
Text #f4f6f8 / leise #d3dde8 auf Navy 13,97 / 11,01 : 1 Text 4,5
Navy auf Gelb (Schaltfläche auf dunkler Fläche) 10,28 : 1 Text 4,5
Leiser Text #eef4e8 auf Aktionsgrün 4,66 : 1 Text 4,5
Fokus #1769aa auf Weiß; Gelb auf Navy; Gelb auf Grün 5,77 / 10,28 / 3,55 : 1 Nicht-Text 3
Warnung, Fehler, Erfolg auf ihrer Fläche 7,36 / 7,69 / 6,86 : 1 Text 4,5
Deaktiviert #6b7682 auf #eceeec 3,97 : 1 deaktivierte Bedienelemente sind ausgenommen
Text auf heller Bildüberlagerung (ungünstigster Bildpunkt schwarz) 10,74 : 1 Text 4,5
Text auf dunkler Bildüberlagerung (ungünstigster Bildpunkt weiß) 7,06 : 1 Text 4,5

Die Werte sind gerechnet; eine Messung mit Prüfwerkzeug an der gerenderten Seite steht vor der Farbfreigabe aus (Website-Zielkonzept §5.3).

5. Typografie, Abstände, Maße

Bereich Wert
Auszeichnung (H1–H3, Wortmarke) Nunito 700/800, vorläufig
Lesen und Bedienen Source Sans 3 400/600 (bereits bisher verwendet)
Skala Fließtext 17 → 18 px, Zeilenhöhe 1,6; H3 20 → 22; H2 26 → 34; H1 34 → 52; Lesebreite 70 Zeichen
Abstände Grundmaß 4 px: 4, 8, 12, 16, 24, 32, 48, 64, 96 px
Rundungen 8 (klein), 14 (Karte), 22 (Fläche), Pille
Container schmal 45 rem, Standard 75 rem, breit 90 rem; Randabstand 16–32 px
Trefferfläche mindestens 44 × 44 px
Fokus 3 px Rahmen in --color-focus, 3 px Abstand, auf jeder Fläche sichtbar

Source Serif 4 wird nicht mehr ausgeliefert; die interne Redaktionsvorschau der Bibliothek fällt dort auf Georgia zurück.

6. Grundkomponenten

Komponente Klassen Hinweis
Container .ui-container, .ui-container-wide Standard- bzw. breite Inhaltsbreite mit Randabstand
Schaltfläche .button / .ui-button, -secondary, -quiet, [disabled] Haupt-, Neben-, Textaktion; Farben aus der jeweiligen Fläche
Formular .form, .ui-field, .ui-input, .ui-field-error, .check sichtbare Beschriftung, Fehlerzustand über aria-invalid
Statusanzeige .status, .errors, .ui-notice-{success,warning,danger,info} Farbe, Randlinie und Text, nie Farbe allein
Karte .ui-card, .empty helle Fläche mit Linie
Dialog .ui-dialog (natives dialog) Hintergrund abgedunkelt
Kennzeile .ui-flag gelbe Linie vor Großbuchstaben-Kennzeile
Themensignatur .ui-theme-signature[data-theme=1…5], .ui-theme-signature-mark siehe Abschnitt 8

Die bestehenden Klassen des Mitgliederbereichs (body.member …) bleiben; ihre Variablen (--text, --aktion, --fokus, …) zeigen jetzt auf die gemeinsamen Tokens. Werte sind gleich geblieben, nur die Auszeichnungsschrift wechselt von Source Serif 4 zu Nunito.

7. Wortmarke und Markenassets

Asset Status Verwendung
Wortmarke als Weblogo (SVG/PNG) fehlt; Logo-Varianten in den Filmmotiven weichen voneinander ab (Kit-README, Leitlinie 5) vorläufiger Schriftzug „Lara & Felix / Stark im Alltag“ in Nunito, gekennzeichnet data-brand-status="vorlaeufig", ohne Nachbildung (keine Drehung, kein Unterstrich-Schwung)
Titel-, Denkpause-, Outro-Motiv (01_originale) Original vorhanden, öffentliche Nutzung nicht freigegeben (Quellenmanifest) nicht verwendet; nicht in public/ oder den Medienbestand kopiert
Figurenreferenzen Lara, Felix, Oma nur interne Referenz nicht verwendet
SVG-Entwürfe (03_svg_entwuerfe: Monogramm, Strahlen, Unterstreichung, Denkblase, Hand) neue, nicht freigegebene Vorschläge nicht verwendet
KI-Konzeptgrafiken (04_visuelle_entwuerfe) erfundene Inhalte, nicht freigegeben nicht verwendet
Themensymbole der fünf Bereiche nicht entworfen nicht verwendet; Platz vorbereitet

Austausch nach Freigabe: Logodatei unter public/ ablegen und ausschließlich in components/site/brand.blade.php einsetzen; Kopfzeile, Fußbereich und Mitgliederbereich verwenden diese eine Komponente.

8. Themensignaturen (vorbereitet)

.ui-theme-signature trägt Nummer (1–5) und Name des Themenbereichs; --color-theme-1 bis --color-theme-5 sind Platzhalter, die bis zur Freigabe alle auf die neutrale helle Fläche zeigen. Unterscheidung erfolgt damit ohne Farbe (Design-Prinzipien §3). Nach Freigabe werden Tönungen in tokens.css und Symbole als SVG je Säule ergänzt; Mehrfachzuordnung ist als Reihe von Marken vorgesehen.

9. Website-Gerüst

  • Kopfzeile (klebend, 64/72 px): Wortmarke, CMS-Hauptnavigation, Kontozugang „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet), vorbereiteter Warenkorbzugang (config/cms.php → cart.enabled, Vorgabe aus: es wird nichts ausgegeben).
  • Hauptnavigation: aus navigation_items (header), aktiver Eintrag mit gelber Linie und aria-current, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit aria-expanded, Escape schließt, Klick außerhalb schließt). Ab 75 rem in der Zeile, darunter Menü-Schaltfläche.
  • Mobile Navigation: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche unter der Kopfzeile mit 48 px hohen Einträgen, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator bleibt im Menü, Escape schließt und gibt den Fokus an die Schaltfläche zurück. Keine feste untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation als umbrechende Liste sichtbar.
  • Fußbereich (dunkle Fläche): Wortmarke, „Themenbereiche“ aus den veröffentlichten Säulen, Gruppen „Service“, „Kontakt“, „Rechtliches“ aus der CMS-Navigation. Leere Gruppen entfallen; es werden keine Kontakt- oder Rechtstexte erfunden.

10. Schnittstellen zum Mitgliederbereich

Gemeinsam: Tokens, Schriften, Fokusregeln, Wortmarke (<x-site.brand> mit Zusatz „Mitgliederbereich“), Schaltflächen-, Formular- und Statusklassen. Nicht verändert: Layout, Seitenleiste, Bibliotheksnavigation, die bestehende untere Leiste member-dock (fünf Einträge, bereits vor dieser Iteration vorhanden), Berechtigungs- und Suchlogik, Kursplayer. Eine Überarbeitung der mobilen Mitgliedernavigation (höchstens vier bis fünf Funktionen) braucht eine eigene UX-Abnahme; die Tokens und Komponenten sind dafür vorbereitet.

11. Veredelung mit Design-Skills (Empfehlung)

  1. Erst Freigaben einholen (Wortmarke als SVG, Farbwerte, Schriften, Bildmotive mit Rechten); dann nur tokens.css und brand.blade.php anpassen.
  2. Widgets einzeln veredeln: nur resources/views/widgets/<typ>.blade.php und widgets.css, Klassen und Daten bleiben stabil; Container-Abfragen beibehalten.
  3. Themensignaturen als Symbolfamilie entwerfen (Design-Prinzipien §3, Zielkonzept §7.4), dann --color-theme-* und Symbole je Säule ergänzen.
  4. Hintergrundbilder: textfreie Zuschnitte der Originalmotive mit Fokuspunkt erzeugen (Hintergrundverarbeitung, srcset), sobald freigegeben.
  5. Sichtprüfung 390/768/1440 px und Kontrastmessung mit Prüfwerkzeug nach jeder Änderung an Markenwerten.