Dokumentiere die adaptiven Widgets mit Prüfergebnissen und Screenshots.
CI Feature / test (push) Successful in 37s
Deploy Test / test (push) Successful in 36s
Deploy Test / deploy (push) Successful in 29s

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-18 11:02:52 +01:00
1 parent 0bfb53463a
commit 87a7ffc45f
7 files changed
+173

No files matched your search

@@ -0,0 +1,173 @@
# 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.
Binary file not shown.

After

Width:  |  Height:  |  Size: 260 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 362 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 257 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 91 KiB