Files
laraundfelix/docs/architektur/designsystem.md
T
LarsandClaude Opus 5.5 cca069be48
CI Feature / test (push) Successful in 38s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 28s
Dokumentiere die vereinfachten Abschnittsabstände mit Messwerten.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 12:47:03 +01:00

17 KiB
Raw Blame History

Gemeinsames Designsystem (ADR-36) – umgesetzter Stand

Stand: 18.11.2026, Designiteration 1 (Branch feature/design-iteration-1; Vorstand 17.11.2026 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, für die Markenakzente resources/views/components/brand/).

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 (zwei Zustände), Hauptnavigation, Menümodus, Inhaltsfläche, Fußbereich, Markenakzente
resources/views/components/brand/ Markenakzente als Blade-Komponenten: underline (Unterstreichung), rays (Signalstrahlen), arc (grüner Bogen); dekorativ, aria-hidden, Farbe über Tokens
resources/js/site-nav.js Menü, Fokusfalle, Untermenüs, kompakter Zustand, Wiederholung der Breitenmessung (die Messung selbst steht inline in components/site/header.blade.php)
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, Wortmarken-Schild, Programmtafel auf dunkler Fläche) 5,22 : 1 Text 4,5
Grün dunkel auf Weiß (Art „Programm“/„Modul“ in Listen) 5,22 : 1 Text 4,5
Navy auf Gelb (Markenschaltfläche .button-brand) / Hover #ffe05c 10,28 / 11,58 : 1 Text 4,5
Navy auf Creme (Tafel der Markenbühne) 14,00 : 1 Text 4,5
Fußbereich Grundzeile #f4f6f8 auf Grün dunkel (falls der Bogen Links berührt) 4,82 : 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
Breiten Lesebereich 44 rem, Standard 82 rem, Breit 96 rem, Vollbreite; Randabstand 16–40 px (siehe Abschnitt 12)
Abschnittsabstände --section-space-{none,compact,normal,large} (oben/unten) und --section-gap-{none,compact,normal,large} (Widget-Abstand); Bedeutung in cms-widget-registry.md §11
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]; .button-brand Haupt-, Neben-, Textaktion; Farben aus der jeweiligen Fläche. .button-brand (Gelb, Navy-Schrift) nur für die erste Handlung im Seiteneinstieg
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 freigegebene Gestaltung (Brand-UI-Kit 08_freigegebene_logovarianten, 18.11.2026), als Rasterbild mit transparentem Hintergrund; eine Vektorfassung fehlt Website-Kopfzeile und Fußbereich (<x-site.brand variant="logo">, data-brand-status="freigegeben"): Kompaktfassung, zugeschnitten als public/images/brand/lara-felix-logo-kompakt-128.webp und -256.webp (1x/2x); Originaldatei unverändert. Höhe: Kopfzeile 60 px (Ausgangszustand 1,32-fach ≈ 80 px, kompakt 60 px), Smartphone 48 px, Fußbereich 72 px. Mitgliederbereich weiterhin mit Schriftzug (variant="plain")
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 Unterstreichung und Signalstrahlen (03_svg_entwuerfe) neue, nicht freigegebene Vorschläge seit Designiteration 1 verwendet als Akzente: Unterstreichung unter Einstiegs- und Abschnittsüberschriften, Strahlen an Bild- und Tafelecken; nie an der Wortmarke
Grüner Bogen eigene Ableitung nach dem Homepage-Entwurf des Kits Abschluss des Fußbereichs
SVG-Entwürfe Denkblase und Hand didaktische Symbole der Denkpause bewusst nicht als Dekor verwendet; gehören in Kursplayer und Lernansichten
SVG-Entwurf Monogramm kein freigegebenes Logo nicht verwendet, auch nicht als Favicon
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 (Designiteration 1)

  • Wortmarke: freigegebene Lara-&-Felix-Wortmarke (Kompaktfassung) als Bild mit festen Maßen im Markup; die Breitenmessung der Navigation stimmt dadurch schon vor dem Laden des Bildes.
  • Kopfzeile, zwei Zustände ohne Layoutsprung. Die Box ist immer --header-height-initial hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand (top: kompakt − initial). Die innere Leiste (.site-header-bar, 72 px) klebt oben. Beim Scrollen wandert sie 16 px nach oben und bleibt dann stehen; der Seitenfluss ändert sich nie. Ein Beobachter (data-site-header-sentinel) setzt .is-compact: Wortmarke von 1,16-facher auf normale Größe (nur transform) und Schatten. Unter prefers-reduced-motion ohne Übergang. Ohne JavaScript klebt die Kopfzeile genauso; nur die Wortmarke bleibt groß.
  • Breitenstufen der Navigation (site-nav.js, Messung an einer unsichtbaren Kopie): 1. Navigation und Kontozugang mit Beschriftung in einer Zeile; 2. sonst Kontozugang nur als Symbol (.is-account-compact); 3. sonst und immer unter 75 rem Menümodus (.is-menu-mode). Die Navigation bricht nie um; deshalb ist die Kopfzeile auf allen Seiten gleich hoch, unabhängig von Anzahl und Länge der CMS-Einträge. Die Messung steht inline direkt nach der Kopfzeile (window.lufHeaderMode) und setzt die Stufe vor dem ersten Zeichnen; site-nav.js wiederholt sie bei Größenänderungen und nach dem Laden der Schriften.
  • Hauptnavigation: aus navigation_items (header), aktiver Eintrag mit gelber Markenunterstreichung und aria-current, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit aria-expanded, Escape schließt, Klick außerhalb schließt).
  • Menümodus: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche direkt unter dem sichtbaren Teil der Kopfzeile, 48 px hohe Einträge, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator läuft im Kreis zwischen Schaltfläche und Einträgen, Escape schließt und gibt den Fokus zurück. Keine untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation unter 75 rem als umbrechende Liste sichtbar.
  • Kontozugang „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet) und vorbereiteter Warenkorbzugang (config/cms.php → cart.enabled, Vorgabe aus: es wird nichts ausgegeben).
  • Fußbereich (dunkle Fläche): Wortmarke, „Themenbereiche“ aus den veröffentlichten Säulen, Gruppen „Service“ und „Kontakt“ aus der CMS-Navigation; „Rechtliches“ in einer eigenen Grundzeile. Grüner Bogen als Abschluss. Leere Gruppen entfallen; es werden keine Kontakt- oder Rechtstexte erfunden.
  • Stabile Geometrie: scrollbar-gutter: stable auf html (kurze und lange Seiten gleich breit), scroll-padding-top für Sprungziele. Wortmarke, Navigation und Seiteninhalt fluchten im Standardraster.

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.

12. Breitenmodell (Designiteration 1)

Stufe Token Wert Abschnittsbreite im Editor Einsatz
Lesebereich --width-reading 44 rem narrow lange Texte, Formulare
Standard --width-standard 82 rem standard Grundraster; Kopfzeile, Fußbereich und Inhalt fluchten hier
Breit --width-wide 96 rem wide bildstarke Kompositionen
Vollbreite – 100 % abzüglich Randabstand full Inhalt bis an den Rand

Hintergründe reichen immer über die ganze Fensterbreite. --frame-inset = max(Randabstand, (100 % − Standard) / 2) steht für Inhalte in fensterbreiten Flächen bereit, ohne 100vw (kein Scrollbalkenfehler). Die randlose Markenbühne der Designiteration 1 ist mit Kit v1.6 entfallen; der Premium-Einstieg ist eine Karte im Abschnitt. Die Schlüssel der Abschnittsbreiten sind gespeicherte Daten und bleiben unverändert; nur die Werte wurden angepasst (vorher 45/75/90 rem).

13. Premium-Widgets (Brand-UI-Kit v1.6, ADR-38)

Einstieg und Bild und Text verwenden die Komponenten aus docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6, übernommen nach resources/css/components/lf-hero.css und lf-bild-text.css (über app.css geladen; das frühere Hero- und Bild-und-Text-CSS ist entfernt). Die Kit-Variablen --lf-font-display, --lf-font-ui und --lf-muted zeigen in tokens.css auf die gemeinsamen Werte. Nunito wird zusätzlich in Stärke 900 lokal ausgeliefert (Überschrift des Einstiegs).

Paar Kontrast
Label #17370b auf #dff0c0 (Einstieg) 10,9 : 1
Weiß auf Grün dunkel (Schaltflächen) 5,22 : 1
Navy auf Creme / Weiß auf Navy (Flächen) 14,0 / 15,1 : 1
Fließtext #46556b auf Creme (Bild und Text) 7,0 : 1
Label #295b08 auf Creme; #fff2b0 auf Navy 7,5 / 13,4 : 1

Bildmotive des Kits (09_hero_widget/assets, 10_bild_text_widget/assets) sind für die öffentliche Verwendung nicht freigegeben; sie wurden nur lokal für die Sichtprüfung verwendet.