Files
laraundfelix/docs/architektur/designsystem.md
T
LarsandClaude Opus 5.5 33aaf64024
CI Feature / test (push) Successful in 36s
Deploy Test / test (push) Successful in 32s
Deploy Test / deploy (push) Successful in 32s
Stabilisiere den Website-Rahmen und veredele die zentralen Widgets.
Designiteration 1 auf Grundlage des Brand-UI-Kits (vorläufige Werte):
- Kopfzeile mit konstanter Box und zwei Zuständen (großzügig, kompakt
  beim Scrollen) ohne Layoutsprung; Navigation bricht nie um, sondern
  verkürzt erst den Kontozugang und schaltet dann in den Menümodus.
  Scrollbalken-Reserve, gemeinsames Breitenmodell (Lesebereich,
  Standard, Breit, Vollbreite), Wortmarke und Inhalt fluchten.
- Fokusfalle im Mobilmenü schließt auch den Weg von der
  Menü-Schaltfläche in den Inhalt.
- Fußbereich mit Grundzeile für rechtliche Links und grünem Bogen.
- Markenakzente (Unterstreichung, Strahlen, Bogen) als Komponenten.
- Hero: Varianten Markenbühne (randlos) und Editorial, zweite
  Schaltfläche, Bildausschnitt. Bild und Text: Bildformat und
  Ausschnitt. Karten: hervorgehobene erste Karte, ganze Karte klickbar.
  Programmkarten mit Markentafel. Alles additiv, ohne neue Version.

Testanpassungen: Die Website-Wortmarke trägt jetzt brand-lockup, die
erste Hero-Schaltfläche button-brand (beabsichtigte Gestaltung).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 06:43:13 +01:00

15 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 Breitenstufen der Kopfzeile, Menü, Fokusfalle, Untermenüs, kompakter Zustand
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)
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 (SVG/PNG) fehlt; Logo-Varianten in den Filmmotiven weichen voneinander ab (Kit-README, Leitlinie 5) vorläufiger Schriftzug „Lara & Felix“ in Nunito, auf der Website (variant="lockup") mit grünem Schild „Stark im Alltag“ nach dem Web-Entwurf des Kits; gekennzeichnet data-brand-status="vorlaeufig", ohne Nachbildung der Filmwortmarke (keine Wolkenform, keine Drehung, kein Unterstrich-Schwung, keine Strahlen)
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)

  • 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. Unter 75 rem setzt ein Inline-Skript direkt nach der Kopfzeile den Menümodus vor dem ersten Zeichnen.
  • 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
Randlos – 100 % automatisch (section-bleed) Markenbühne allein im Abschnitt

Hintergründe reichen immer über die ganze Fensterbreite. --frame-inset = max(Randabstand, (100 % − Standard) / 2) richtet Inhalte in randlosen Flächen (Tafel der Markenbühne) am Standardraster aus, ohne 100vw (kein Scrollbalkenfehler). Die Schlüssel der Abschnittsbreiten sind gespeicherte Daten und bleiben unverändert; nur die Werte wurden angepasst (vorher 45/75/90 rem).