Files
laraundfelix/docs/analysen/adaptive-widgets-bericht-2026-11-18.md
T
LarsandClaude Opus 5.5 f4d225d0b2
CI Feature / test (push) Successful in 38s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 28s
Dokumentiere die Nachprüfung der Referenzseite, Abstand oben und Wortmarke.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 12:07:02 +01:00

18 KiB
Raw Blame History

Abschlussbericht: Adaptive Widgets und Premium-Design v1.6

Stand: 18.11.2026.

  • Branch: feature/adaptive-widgets, abgezweigt vom Stand feature/design-iteration-1 einschließlich der beiden Doku-Commits von Lars.
  • Per Fast-Forward auf develop übernommen und über deploy-test.yml auf der Testinstanz bereitgestellt.
  • Kein Merge nach main. develop liegt 73 Commits vor main.
Schritt Stand
Commit Umsetzung 0bfb534
CI Feature-Branch Lauf 4834 grün
Deploy Testinstanz Lauf 4835 erfolgreich, /up 200
Bericht dieser Commit

Entscheidung: ADR-38 im zentralen Protokoll. Technische Dokumentation:

  • docs/architektur/cms-widget-registry.md §§2–4, 8, 9, 12
  • docs/architektur/designsystem.md §13

1. Grundlage und Abweichungen vom Kit

Grundlage war der Repository-Stand docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6: Komponenten, CSS, layout-profiles.json, Registry-Hinweise, Beispiele und Referenzscreenshots. Die Ordner 07–12 sind im Repository nicht versioniert (untracked). Übernommen wurden Code und CSS, angepasst an die tatsächliche Struktur. Die Kit-Ordner selbst wurden nicht eingecheckt.

Kit v1.6 Umsetzung Grund
Kennungen lf-brand-hero, lf-editorial-bild-text bestehende Kennungen hero und image_text als kompatible Weiterentwicklung Kennungen und Revisionen bleiben erhalten
Varianten photo-split, editorial-solid photo_split, editorial_solid Variantenkennungen der Registry: ^[a-z][a-z0-9_]*$
settings.image_side Variante image_left / image_right keine doppelte Einstellung
settings.image_focus {x,y} data.focus_x, data.focus_y (0–100) settings trägt nur Aufzählungswerte
Überschriftenebene H1/H2/H3 frei „Automatisch“ (erstes Widget der Seite = H1), H2, H3 Regel „genau eine H1 je Seite“; Widerspruch nicht still aufgelöst, sondern dokumentiert
Linkziele nur https, Pfad, Anker bestehende SafeUrl-Regel (zusätzlich http) Repository-Regel gilt
Einstiegsbild immer sofort laden nur das erste Widget der Seite sofort, alle anderen verzögert bestehende Ladeprioritäten
CSS v1.6 übernommen nach resources/css/components/lf-hero.css und lf-bild-text.css zusätzlich: Überschriften erben Farbe (globale h1–h3-Regeln), Unterstreichung als Block, Fläche „clear“ übernimmt die Farben dunkler Abschnitte, Strahlen-Akzent, Fokusfarbe aus den Tokens

Das frühere Hero- und Bild-und-Text-CSS sowie der Randlos-Mechanismus der Designiteration 1 sind entfernt. Es laden keine alten und neuen Stylesheets parallel.

2. Gemeinsamer Layoutmechanismus (ADR-38)

In der bestehenden Registry (WidgetType) erklärt jede Art:

  • zulässige Rasterbreiten (supportedUnits()); die Mindestbreite ist daraus abgeleitet;
  • Höhen aus einem gemeinsamen Vokabular (auto, compact, normal, large, spacious, fill). Sie werden als settings.height gespeichert und wie jede Einstellung geprüft;
  • Darstellungsmodi (stages()) und das Verhalten bei wenig Platz (narrowBehavior()).

Wirkung:

  • Ein Platz mit nicht unterstützter Breite wird beim Speichern abgewiesen: „… ist für Plätze mit 3 oder 4 Rastereinheiten vorgesehen; dieser Platz hat 2“.
  • Der Platzkopf im Editor warnt vorher, und die Widget-Auswahl nennt die zulässigen Breiten.
  • Die Höhe erscheint als Klasse widget-height-* an der Hülle.
  • Die Ansichten reagieren über Container-Abfragen auf die tatsächliche Breite.
  • Es gibt keine zweite Registry, kein zweites Abschnittsmodell und keine Migration.
Widget Breiten Höhen
Einstieg (Hero) 3, 4 compact (mind. 400 px), normal (512 px), large (640 px)
Bild und Text 1–4 compact, normal, spacious
Handlungsaufruf 1–4 auto, fill (gleich hoch wie die Nachbarplätze)
Überschrift, Fließtext, Karten, Programmkarten 1–4 – (nach Inhalt)
FAQ 2–4 –

Die Gestaltung der Bestandswidgets bleibt unverändert. Für schmale Plätze kamen hinzu:

  • Umbruch langer Wörter und Adressen;
  • Schaltflächen mit overflow-wrap, max-width: 100 % und mittig ausgerichtetem Text.

3. Premium-Widgets

Einstieg (hero Version 2):

  • Varianten „Foto mit Textfläche“ und „Markenfläche“.
  • Drei Höhen, Label, Überschrift und Ebene, Beschreibung, Bild aus dem öffentlichen Medienbereich (Auswahl oder Hochladen).
  • Bildfokus (zwei Schieberegler) und Alternativtext.
  • Zwei Schaltflächen und ein Akzent: Unterstreichung, Unterstreichung mit Signalstrahlen oder keiner.
  • Ab 860 px Containerbreite die Komposition aus dem Kit, darunter der technische Sicherheitsumbruch (Foto 16:9 über dem Text).

Bild und Text (image_text Version 3):

  • Fläche creme, ohne eigene Fläche oder navy.
  • Bild links oder rechts, drei Höhen, Label, Überschrift und Ebene.
  • Formatierter Text (bereinigt), Bild, Fokus, Alternativtext, zwei Schaltflächen.
  • Darstellung nach Containerbreite:
Containerbreite Darstellung
unter 540 px gestapelt
540–899 px flacher Bildstreifen
ab 900 px zweispaltig

Die Grenzwerte aus dem Kit haben sich im CMS bewährt und sind unverändert.

Bestehende Daten:

  • hero Version 1 wird beim Lesen angehoben: standard/stage → photo_split, highlight/editorial → editorial_solid. Der Fokuspunkt wird in Prozent umgerechnet, und nicht mehr vorhandene Einstellungen entfallen.
  • image_text Version 2 wird ebenso angehoben: Bildformat entfällt, Fokus in Prozent.
  • Gespeicherte Revisionen bleiben unverändert. Die data-Schlüssel sind gleich geblieben, damit ein Code-Rollback darstellbar bleibt (siehe cms-widget-registry.md §9).

4. Editor

  • Bearbeitungsdialog: Reiter Inhalt, Medien und Darstellung, generisch aus der Registry.
    • Varianten und Höhen sind Auswahlknöpfe mit Symbol.
    • Der Bildfokus wird mit Schiebereglern eingestellt.
    • Weitere Darstellungsparameter sind Auswahllisten mit dem Hinweis „Vorgabe der Darstellung“.
    • Der Reiter Darstellung nennt die zulässigen Platzbreiten und das Verhalten bei wenig Platz.
  • Live-Vorschau im Dialog:
    • Derselbe Renderer wie die Website, in wählbarer Platzbreite: Smartphone 390 px oder die zulässigen Einheiten mit 310, 640, 960 bzw. 1300 px.
    • Verkleinert auf die Dialogbreite; Änderungen erscheinen sofort.
  • Abschnitts- und Widget-Einstellungen sind getrennt:
    • Abschnitt: Raster, Hintergrund, Breite, Abstand, Trenner.
    • Widget: Anordnung, Fläche, Höhe, Bild, Fokus, Texte, Schaltflächen, Akzent.

5. Tests und praktische Abnahme

Prüfung Ergebnis
php artisan test 199 Tests grün
Pint (Code-Pfade) sauber
Build erfolgreich (Nunito 900 zusätzlich lokal ausgeliefert)
CI 4834 grün
Deploy 4835 erfolgreich
12 bestehende öffentliche Seiten (Status, Titel, Text) vor und nach dem Deploy unverändert
Szenario 1: /designreferenz, /praevention-im-alltag, /referenz-abschnitte, /t1-landingpage im Editor geöffnet und unverändert gespeichert 4/4 ohne Fehler
Redaktionsablauf auf Test (/premium-referenz, über die Oberfläche) 16 von 18 Prüfungen im Skript bestanden; die beiden Abweichungen sind Prüffehler, nicht Anwendungsfehler (siehe unten)
Matrix lokal (/pruefmatrix, mit Kit-Motiven) und auf Test (/premium-referenz), 390/768/1200/1440/1920 px kein seitlicher Überlauf, kein abgeschnittener Text oder Button, genau eine H1
Rahmen (Kopfzeile, Menü, Tastatur, CLS, Bewegung reduzieren) auf Test 18/18

Neue Tests in der Suite:

  • CmsPremiumWidgetsTest: Upgrades, Varianten, Höhen, Akzente, Fläche, Sanitizing, unsichere Links, Fokusgrenzen, alle Widgets in jeder zulässigen bzw. unzulässigen Breite, Höhe „fill“.
  • Editortest: Premium-Einstieg mit Höhe, Ebene, Akzent, Fokus und zwei Schaltflächen speichern und veröffentlichen; Dialogfelder und Live-Vorschau.
  • Registry-Tests zum Layoutvertrag.

Bewusst angepasste Tests:

  • Einstieg braucht 3 oder 4 statt mindestens 2 Einheiten.
  • image_text ist Version 3.
  • Klassen der neuen Ansichten.
  • Die Hero- und Bild-Tests der Designiteration 1 sind ersetzt.

Redaktionsablauf auf der Testinstanz (Szenarien 2–11):

  • Angelegt über die Oberfläche: Einstieg in 4/4 (groß, normal) und 3/4 (kompakt, Markenfläche, H3, lange Überschrift und Schaltfläche), Aufruf mit voller Höhe, Bild und Text in 4/4, 3/4, 2/4 und 1/4 mit allen Höhen und Flächen, gemischt mit Überschrift, Fließtext und Karten.
  • Danach im Editor geändert: Überschrift, Beschriftung, Höhe und Fokus.
    • Die Live-Vorschau zeigt Höhe, Fokus (80/30 %) und Text sofort.
    • Die Smartphone-Breite zeigt den Sicherheitsumbruch.
  • Veröffentlicht; die öffentliche Seite zeigt alle Änderungen.

Die zwei Abweichungen im Skript:

  • Es erwartete 15 Widgets; angelegt waren 13. Die Zahl im Skript war falsch.
  • Der Vergleich Vorschau gegen öffentliche Seite meldete einen Unterschied. Das genaue Diff zeigt als einzigen Unterschied den beabsichtigten Vorschauhinweis „Vorschau einer unveröffentlichten Revision“. Das Markup der Widgets ist identisch.

Bilder:

  • Lokal wurden die Kit-Motive (09_hero_widget/assets/lara-felix-park-hero.webp, 10_bild_text_widget/assets/lara-felix-park.webp) für den Sichtvergleich mit den Kit-Screenshots verwendet; die Darstellung entspricht ihnen.
  • Auf der Testinstanz stehen gekennzeichnete Platzhalter. Begründung: Alles, was im Editor gespeichert wird, ist über /medien/cms/… öffentlich abrufbar, und die öffentliche Bildverwendung ist laut Kit nicht freigegeben.

Screenshots (Testinstanz, Platzhalter) unter docs/analysen/adaptive-widgets-screenshots/:

  • Referenzseite bei 1440, 768 und 390 px
  • Dialog „Darstellung“
  • Live-Vorschau bei 390 und 1300 px

6. Verbleibende Einschränkungen

  • Kit-Dateien verändert (mein Fehler):
    • Ein Pint-Lauf ohne Pfadangabe hat vier untracked PHP-Beispieldateien im Kit umformatiert (nur Leerraum und Klammern):
      • 11_bild_text_widget_v1.5/laravel/app/Support/LfBildTextPayload.php
      • 11_bild_text_widget_v1.5/laravel/examples/registry-adapter.example.php
      • 11_bild_text_widget_v1.5/laravel/tests/LfBildTextPayloadTest.php
      • 12_premium_widgets_adaptiv_v1.6/laravel/app/Support/LfBildTextPayload.php
    • Die übrigen 112 Kit-Dateien sind bytegleich mit dem Archiv.
    • Das Zurückschreiben aus Downloads/Lara_Felix_Brand_UI_Kit_v1.6_Adaptive_Premium_Widgets.zip wurde von der Rechteprüfung blockiert. Bitte diese vier Dateien aus dem Archiv wiederherstellen.
  • Freigaben: Die öffentliche Verwendung der Lara-&-Felix-Motive ist nicht freigegeben. Die Testseiten zeigen deshalb Platzhalter.
  • Validierungsmeldungen auf Englisch: Es gibt kein deutsches Sprachpaket (lang/de fehlt), zum Beispiel „The … field is required when … is present“. Das betrifft die ganze Anwendung.
  • Livewire-Timing: Werden Felder schneller ausgefüllt, als die Live-Aktualisierung zurückkommt (unter etwa 0,5 s, nur bei automatischer Eingabe beobachtet), kann ein gerade verlassenes Feld überschrieben werden. Bei menschlichem Tempo trat das nicht auf.
  • Eingeklappter Abschnitt bei der Neuanlage: „Seite und Suchmaschinen“ bleibt nach dem Bearbeiten einer Seite auch beim Anlegen eingeklappt, weil Filament den Zustand merkt. Das Verhalten stammt aus Iteration 2.
  • Vorschau im Platz: Sie ist über 28 rem gekürzt; der Einstieg wird dort beschnitten. Vollständig zeigen ihn die Live-Vorschau im Dialog und die Seitenvorschau.
  • Keine responsiven Bildvarianten: srcset fehlt; die Ableitungen gehören in die Hintergrundverarbeitung.
  • Code-Rollback auf die Designiteration: Ältere Software stellt hero v2 und image_text v3 „bestmöglich“ dar, kann sie aber nicht speichern (§9 der Registry-Dokumentation).
  • Größe der Repository-Historie: Mit dem Fast-Forward sind Lars' Commits 5dccbbc und 3cdb36e auf develop gelandet. Sie enthalten die Kit-Originalbilder und das Kit-ZIP (27,7 MB) in der Historie. Das ZIP ist in 3cdb36e wieder entfernt, bleibt aber in der Historie.
  • UX-Abnahme: Die Bedienung durch den Betreiber steht aus (ADR-38 „UX-Abnahme offen“).

7. Auf der Testinstanz angelegt

  • Seite /premium-referenz (veröffentlicht), mit Platzhalterbildern cms/platzhalter-* (Dateinamen mit Zufallssuffix).
  • Neue Entwurfsrevisionen (nicht veröffentlicht) auf /designreferenz, /praevention-im-alltag, /referenz-abschnitte und /t1-landingpage aus dem Speichertest. Die veröffentlichten Stände sind unverändert.

8. Nachprüfung vom 18.11.2026 (Seitenliste, Abstand oben, Wortmarke)

Branch feature/cms-liste-logo-abstand, Commit 89fd95b; CI 4838, Deploy 4839 auf der Testinstanz. Gearbeitet wurde in einem separaten Worktree; der offene Branch designkit und das Arbeitsverzeichnis wurden nicht verändert.

Befund zu /premium-referenz

/premium-referenz war und ist ein regulärer CMS-Seitendatensatz:

Merkmal Wert
Tabelle und Kennung pages, Kennung 17
Bearbeitungsadresse /verwaltung/pages/17/edit
Inhalt 7 Abschnitte, 13 Widgets, mehrere Revisionen
Öffentliche Auslieferung über die normale Seitenroute (PageController)

Es gibt keine Sonderroute, keine Testimplementierung und keine andere Datenquelle. Angelegt wurde die Seite tatsächlich über die Editoroberfläche; diese Aussage des Berichts stimmt. Unvollständig war sie in einem Punkt: Ohne Suche war die Seite nicht zu finden.

Ursache:

  • Die Seitenliste hatte keine Sortierung und zeigte 10 Einträge je Seite in Anlagereihenfolge.
  • Die zuletzt angelegte Seite stand deshalb auf Listenseite 2 von 2.
  • Die Spalte „Geändert“ zeigte das Anlagedatum in UTC, weil gespeicherte Revisionen die Seite nicht als geändert markierten.
  • Filter, Status, Berechtigungen, Seitentyp oder eine Bereichszuordnung spielten keine Rolle; die Liste hat keine Filter.

Behoben:

  • Die Liste zeigt die zuletzt bearbeiteten Seiten zuerst; Pfad und Datum sind sortierbar.
  • Je Seite stehen 25, 50 oder 100 Einträge.
  • Die Spalte heißt „Zuletzt bearbeitet“ und zeigt deutsche Zeit.
  • Jede gespeicherte Revision und jede Veröffentlichung aktualisiert die Seite.

Geprüfter Weg auf der Testinstanz (Skript über die normale Oberfläche, ohne direkte Datenbankänderung und ohne Hilfsrouten):

  1. Anmeldung mit dem Prüfkonto.
  2. Verwaltung → Seitenleiste „Seiten“. /premium-referenz steht in Zeile 1, ohne Suche.
  3. Klick auf die Zeile → /verwaltung/pages/17/edit.
  4. Alle 13 Widgets nacheinander über „Bearbeiten“ geöffnet und ein Textfeld geändert: Einstieg (3), Handlungsaufruf, Bild und Text (6), Fließtext, Überschrift und Einleitung, Redaktionelle Karten.
  5. Erster Abschnitt: „Gestaltung des Abschnitts“ → „Abstand oben: Kein Abstand“.
  6. „Entwurf speichern“ → Meldung „Entwurf gespeichert“.
  7. „Vorschau“ zeigt alle 13 Änderungen und den Abstand.
  8. „Veröffentlichen“ → die öffentliche Seite zeigt alle 13 Änderungen und den Abstand.
  9. Dasselbe Vorgehen für /praevention-im-alltag (Zeile 3, /verwaltung/pages/9/edit), dort „Abstand oben: Gering“.

Ergebnis: 22 von 22 Prüfungen, keine Konsolenfehler. Ein zweiter Durchlauf hat die Prüfmarken in den Texten über die Oberfläche wieder entfernt (ebenfalls 22/22).

Abstand zwischen Kopfzeile und erstem Abschnitt

  • Bisher ließ sich der Abstand oben nur über „Abstand oben und unten“ verkleinern, und zwar auf höchstens „Kompakt“ (etwa 24–48 px), nie auf null.
  • Neu ist in der Abschnittsgestaltung „Abstand oben“ mit drei Werten:
    • „Wie ‚Abstand oben und unten‘“ (Vorgabe)
    • „Gering“ (etwa 12–20 px)
    • „Kein Abstand“
  • Gespeichert wird der Wert als style.spacing_top. Er wirkt nur auf den gewählten Abschnitt und nur oben.
  • Der Abstand unten und alle anderen Abschnitte bleiben unverändert. Es gibt keine globale Regel und keine Änderung an bestehenden Seiten, solange niemand die Einstellung wählt.

Wortmarke in Kopfzeile und Fußbereich

  • Quelle: docs/Brand-UI-Kit/08_freigegebene_logovarianten/logo_lara_felix_kompakt.png, gelesen aus Lars' lokalem Commit 1223dc8 (Branch designkit), weil die Kit-Ordner im Arbeitsverzeichnis fehlen.
  • Freistellung: Die Datei hat entgegen der Kit-README einen transparenten Hintergrund. Auf Weiß und auf Navy wirkt sie sauber, das ist im Browser geprüft. Die Standardfassung ist größtenteils halbtransparent und wird nicht verwendet.
  • Eingebunden: zugeschnittene WebP-Ableitungen public/images/brand/lara-felix-logo-kompakt-128.webp und -256.webp (1x/2x). Die Originaldatei bleibt unverändert.
  • Größen:
Ort Logohöhe
Kopfzeile, Ausgangszustand etwa 80 px (Box unverändert 104 px)
Kopfzeile, kompakt beim Scrollen 60 px in der 72-px-Leiste
Smartphone 48 px
Fußbereich 72 px
  • Stabilität: Breite und Höhe stehen im Markup; die Navigation misst dadurch schon vor dem Laden des Bildes richtig.
  • Mitgliederbereich: unverändert (Schriftzug).
  • Prüfung auf der Testinstanz:
    • Kopfzeile 18/18.
    • Fünf Seiten bei 1920/1440/1366/1280/390 px: je Breite eine Höhe sowie eine Wortmarken- und Navigationsposition.
    • Erster Frame ohne Layoutverschiebung (CLS 0).

Abnahme-Screenshots (Testinstanz) unter docs/analysen/adaptive-widgets-screenshots/:

  • 07–09: /premium-referenz bei 1440 px (Ausgangszustand und kompakt) und bei 390 px
  • 10, 11: /praevention-im-alltag bei 1440 und 390 px
  • 12, 13: /praevention bei 1440 und 390 px
  • 14: Seitenkonfigurator, Seite 17
  • 15: Abschnittsgestaltung mit „Abstand oben“

Tests:

  • 203 grün; neu ist CmsPageListAndSpacingTest (Sortierung der Liste, Bearbeitungsdatum, Abstand oben, Aufzählungsprüfung).
  • Bewusst angepasst: Erwartung an die Wortmarke (brand-logo statt brand-lockup).

Offen:

  • Eine Vektorfassung der Wortmarke fehlt; die Rasterfassung ist für die gezeigten Größen scharf (2x-Ableitung).
  • Bitte die Wortmarke in Kopf- und Fußbereich visuell abnehmen.