diff --git a/docs/analysen/designiteration-1-bericht-2026-11-18.md b/docs/analysen/designiteration-1-bericht-2026-11-18.md new file mode 100644 index 0000000..f086f97 --- /dev/null +++ b/docs/analysen/designiteration-1-bericht-2026-11-18.md @@ -0,0 +1,163 @@ +# Abschlussbericht Designiteration 1: Markenintegration, Website-Gerüst, Premium-Widgets + +Stand: 18.11.2026. Branch `feature/design-iteration-1` (von `develop`), per Fast-Forward auf `develop` übernommen und über `deploy-test.yml` auf der Testinstanz (Port 3011) bereitgestellt, zuletzt Lauf 4826. **Kein Merge nach `main`.** Commits: `33aaf64` (Umsetzung), `8390dcd` und `7c1caec` (Breitenmessung der Navigation), `d89d4bd` (Markenstrich), dazu dieser Bericht. + +Fachliche Dokumentation: `docs/architektur/designsystem.md` (Tokens, Breitenmodell, Kopfzeile, Markenassets) und `docs/architektur/cms-widget-registry.md` (Varianten, Einstellungen, Randlos-Darstellung, Rollback). + +## 1. Quellen + +Geprüft: `docs/prinzipien/design-prinzipien.md` (mit Vorrang), `docs/strategie/website-cms-seo-marketing-zielkonzept.md`, `docs/architektur/website-cms-marketing-zielarchitektur.md`, `docs/architektur/12_Entscheidungsprotokoll_ADR.md` (lokaler Arbeitsstand, nicht verändert), `docs/architektur/cms-widget-registry.md`, das Brand-UI-Kit unter `docs/Brand-UI-Kit/` (ZIP und entpackte Ordner `01`–`06`, README, Quellenmanifest, Cursor-Übergabe). + +**`00_LUF_Projektkompass.md` liegt weiterhin nicht im Repository.** + +## 2. Ist-Befund vor der Umsetzung + +Gemessen mit echten Scrollbalken (Chromium, lokale Kopie und Testinstanz): + +| Beobachtung | Ursache im Code | +|---|---| +| Kopfzeile wechselt zwischen 73 und 93 px Höhe | Die Navigation brach mit `flex-wrap: wrap` zwischen etwa 1200 und 1410 px in zwei Zeilen um. Ob sie umbrach, hing davon ab, ob die Seite einen Scrollbalken hatte: Bei 1400 px war die Kopfzeile auf langen Seiten 93 px, auf kurzen 73 px hoch. | +| Wortmarke und Inhalt springen waagerecht | Kein `scrollbar-gutter`: Lange Seiten waren 15 px schmaler, der zentrierte Inhalt verschob sich um 7,5 px. | +| Wortmarke fluchtet nicht mit dem Inhalt | Kopfzeile im breiten Container (90 rem), Inhalt im Standardcontainer (75 rem): bei 1440 px 32 px gegenüber 112 px Abstand vom Rand. | +| Große Bildschirme kaum genutzt | Keine randlosen Bildflächen; die Widgets waren gleichförmige Grundmuster. | +| Farben und Schriften | Bereits aus dem Kit übernommen (Iteration 2) und zentral in `tokens.css`; kein zweites Token-System. | +| Widgets | Acht Arten mit schlichter Darstellung; nur `hero`, `cards`, `image_text`, `catalog_cards` hatten Varianten. | +| Assets | Alle Originale laut Quellenmanifest „public usage not independently verified“. Keine freigegebene Logodatei. SVG-Entwürfe sind neue Vorschläge. | + +Brand-Kit-Ansichten: Der Homepage-Entwurf (`04_visuelle_entwuerfe`) zeigt weiße Kopfzeile mit Wortmarke, große Bildbühne mit Text rechts, gelbe Hauptschaltfläche, Navy-Fußbereich mit grünem Bogen. Die Web-Vorschau (`05_web_preview`) zeigt die Textmarke mit grünem Schild. Beide sind laut README nicht freigegeben und enthalten teils erfundene Inhalte; übernommen wurden nur Gestaltungsprinzipien, keine Texte, Preise oder Motive. + +## 3. Aus dem Brand-Kit übernommen + +| Element | Herkunft | Umsetzung | +|---|---|---| +| Markenfarben Navy, Grün, Grün dunkel, Gelb, Creme | `02_design_tokens` | unverändert in `tokens.css` (seit Iteration 2); Kontraste neu nachgerechnet | +| Schriften | Kit-Vorschlag Nunito, Lesetext Source Sans 3 | Nunito 700/800 und Source Sans 3 400/600, beim Build lokal abgelegt, keine Anfrage an Fremdserver | +| Textmarke mit grünem Schild „Stark im Alltag“ | `05_web_preview` | Wortmarken-Variante `lockup` für Kopf- und Fußbereich, gekennzeichnet `data-brand-status="vorlaeufig"` | +| Gelbe Unterstreichung | `03_svg_entwuerfe/yellow-underline.svg` | Komponente `x-brand.underline`: Markenstrich unter Einstiegs- und Abschnittsüberschriften, aktiver Navigationseintrag | +| Signalstrahlen | `03_svg_entwuerfe/yellow-rays.svg` | Komponente `x-brand.rays`: an Bild- und Tafelecken, auf Programmtafeln | +| Grüner Bogen | Homepage-Entwurf | Komponente `x-brand.arc`: Abschluss des Fußbereichs | +| Bildbühne mit Text auf einer Seite, gelbe Hauptschaltfläche, Outline-Nebenschaltfläche | Homepage-Entwurf | Hero-Variante „Markenbühne“, `.button-brand` | + +Bewusst nicht übernommen: Monogramm (kein Logo, auch nicht als Favicon), Denkblase und Hand (didaktische Symbole der Denkpause, kein Dekor), KI-Konzeptgrafiken und deren Texte, Preise und Produktnamen, eine Nachzeichnung der Filmwortmarke. + +## 4. Verwendete Originalassets + +**Keine.** Die Originalmotive sind nicht zur Veröffentlichung freigegeben. Die Referenzseite auf der Testinstanz verwendet ausschließlich selbst erzeugte, sichtbar beschriftete Platzhalter („PLATZHALTER – Originalmotiv noch nicht freigegeben“, Format und Fokus im Bild). + +Eine lokale Designvorschau mit den verkleinerten Kopien aus `05_web_preview/assets` war vorgesehen. Sie wurde nicht erstellt: Das Kopieren der Motive in den lokalen öffentlichen Medienordner wurde von der Sicherheitsprüfung der Arbeitsumgebung blockiert. Die Wirkung mit echten Motiven ist daher nicht geprüft. + +## 5. Vorläufig oder nicht freigegeben + +| Entscheidung | Status | Freigabe durch | +|---|---|---| +| Wortmarke (Textmarke mit grünem Schild) | vorläufig; keine Logodatei vorhanden | Lars: finale SVG-/PNG-Wortmarke | +| Farbwerte | vorläufig (aus Motiven abgeleitet) | Lars | +| Schriften Nunito und Source Sans 3 | vorläufig, Lizenz OFL, lokal ausgeliefert | Lars | +| Unterstreichung, Strahlen, Bogen | Kit-Entwürfe, nicht freigegeben | Lars | +| Bildmotive für Markenbühne, Bild und Text, Karten | nicht freigegeben; Nutzungsrechte offen | Lars (Rechte, Auswahl, Zuschnitte) | +| Themensignaturen der fünf Bereiche | nicht entworfen | Gestaltung und Freigabe offen | +| Breitenstufen (44/82/96 rem) und Kopfzeilenhöhen (104/72/64 px) | technische Festlegung dieser Iteration | Abnahme durch Lars | + +## 6. Änderungen am globalen Layout + +- **Konstante Kopfzeile.** Die Box ist immer gleich hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand; die innere Leiste (72 px) klebt oben. Beim Scrollen bleibt nur die kompakte Leiste sichtbar, die Wortmarke wird per `transform` von 1,16-facher auf normale Größe verkleinert. Der Seitenfluss ändert sich nie. Unter `prefers-reduced-motion` gibt es keinen Übergang. Ohne JavaScript klebt die Kopfzeile genauso. +- **Navigation bricht nie um.** Stufen: Navigation und Kontozugang mit Beschriftung; sonst Kontozugang nur als Symbol; sonst und immer unter 75 rem Menümodus. Gemessen wird die Desktop-Darstellung an der echten Navigation. Unter 75 rem setzt ein Inline-Skript den Menümodus vor dem ersten Zeichnen. +- **Stabile Breite.** `scrollbar-gutter: stable`; ein gemeinsames Breitenmodell (Lesebereich 44 rem, Standard 82 rem, Breit 96 rem, Vollbreite). Kopfzeile, Fußbereich und Inhalt fluchten im Standardraster. `--frame-inset` richtet Inhalte in randlosen Flächen am Raster aus, ohne `100vw`. Die Breitenschlüssel des Editors bleiben, die Bezeichnungen lauten jetzt Lesebereich, Standard, Breit, Vollbreite. +- **Menümodus.** Die Fläche beginnt unter dem sichtbaren Teil der Kopfzeile; keine untere Navigationsleiste. Behoben wurde ein schon vorher vorhandener Fehler: Vom Knopf „Schließen“ sprang der Tabulator in den Seiteninhalt. Jetzt läuft der Fokus im Kreis. +- **Fußbereich.** Navy-Fläche, Textmarke, Gruppen aus der CMS-Navigation, „Rechtliches“ in einer Grundzeile, grüner Bogen. Keine zweite Inhaltsverwaltung, keine erfundenen Texte. +- **Mitgliederbereich.** Unverändert: schlichte Wortmarke, eigene Navigation. Die Tokens bleiben gemeinsam. + +## 7. Änderungen an den Widgets + +Alle Änderungen sind additiv. Es gibt keine neue Schemaversion und keine Migration, und gespeicherte Widgets bleiben gültig. + +| Widget | Neu | +|---|---| +| Einstieg (Hero) | **Markenbühne**: Bild über die volle Breite, randlos wenn allein im Abschnitt. Der Text steht auf einer hellen Tafel (Kontrast 14:1 unabhängig vom Motiv), wahlweise links oder rechts. Schmal: Bild 4:3 mit überlappender Tafel. **Editorial**: große Überschrift, Beschreibung und Schaltflächen nebeneinander, optional ein Bildband 21:9. Für alle Varianten: zweite Schaltfläche, Bildausschnitt. Die erste Schaltfläche ist die gelbe Markenschaltfläche. Das Bild des ersten Widgets lädt sofort mit hoher Priorität, alle anderen verzögert. | +| Bild und Text | Bildformat (Quer-, Hochformat, Quadrat, Original) und Bildausschnitt; versetzte Markenfläche hinter dem Bild; ab 56 rem Bild betont (7:5); Markenstrich unter dem Titel | +| Redaktionelle Karten | Variante **erste Karte hervorgehoben**: ganze Zeile, ab 44 rem Bild neben dem Text. Raster mit großen Bildflächen; Karten ohne Bild bekommen eine gelbe Kante. Kompakte Liste mit kleinem Bild. Die ganze Karte ist über den Titellink klickbar (ein Tabstopp). | +| Programm- und Modulkarten | Markentafel statt erfundener Bilder (Navy, auf dunklen Flächen Grün dunkel). Eine einzelne Karte ist ab 40 rem breit, mit Tafel neben dem Text. Unverändert: Fachdaten zur Laufzeit, keine Kopie im CMS, Freigabelogik (ADR-29), keine öffentlichen Modulprofile. | + +Einstellungen sind nur Aufzählungswerte; freie Werte werden abgewiesen. Der Editor zeigt sie mit deutschen Bezeichnungen und dem Hinweis „Vorgabe der Darstellung“. + +**Rollback:** Ein Code-Rollback auf Iteration 2 stellt die neuen Varianten mit der Vorgabe dar; Daten gehen nicht verloren. Der Wiederherstellungsweg aus `cms-widget-registry.md` §9 bleibt für einen Rollback hinter Iteration 2 nötig. + +## 8. Design-Referenzseite + +`/designreferenz` auf der Testinstanz, über die Editoroberfläche angelegt und veröffentlicht. Die Texte stammen aus den Design-Prinzipien (Themenbereiche, Methode, Zielgruppe). Keine Produkte, Preise, Kurse oder Filmfreigaben; Bilder sind gekennzeichnete Platzhalter. + +| Abschnitt | Zeigt | +|---|---| +| 1 | Markenbühne randlos, zwei Schaltflächen, Bildausschnitt links | +| 2 | Bild und Text (breit), Trenner Markenakzent | +| 3 | Raster 1 + 3 auf heller Fläche: Überschrift und hervorgehobene Karten (fünf Themenbereiche) | +| 4 | Programmkarte aus den Fachdaten auf dunkler Fläche | +| 5 | Editorial-Einstieg, großzügiger Abstand, Trenner Linie | +| 6 | Raster 2 + 2 auf Markenakzent: Text und kompakte Karten | +| Rahmen | Markenkopfzeile, Fußbereich mit Bogen | + +## 9. Tests und Prüfungen + +| Prüfung | Ergebnis | +|---|---| +| Testsuite lokal (`php artisan test`) | 194 Tests grün, davon 9 neu (`CmsDesignIterationTest` 8, Editortest Markenbühne 1). Bewusst angepasst: zwei Erwartungen an Klassen (`brand brand-lockup`, `button button-brand`). | +| Pint | sauber | +| CI Feature-Branch | Läufe 4819, 4821, 4823, 4825 grün | +| Deploy Testinstanz | Läufe 4820, 4822, 4824, 4826 erfolgreich, `/up` 200 | +| Bestehende Seiten (12, Status, Titel, Haupttext) | vor und nach dem Deploy unverändert | +| Referenzseite über die Oberfläche (Testinstanz) | 11/11 | +| Browser-QA (Testinstanz und lokal) | 18/18 | +| Untermenü mit Maus und Tastatur (Testinstanz) | 8/8; der Prüfeintrag ist wieder entfernt | +| Geometrie über 5 Seiten bei 1920/1440/1400/1366/1280/1200/390 px | je Breite genau eine Kopfzeilenhöhe, eine Wortmarken- und eine Navigationsposition | +| Fenstergröße ändern 1280 → 1440 → 1100 → 1920 → 390 → 1440 | Moduswechsel korrekt, keine Konsolenfehler, eine Navigation im DOM | + +Die Browser-QA umfasst: +- Layoutverschiebung beim Kaltstart und Scrollen (CLS 0,0006 bei 1440 px, 0 bei 390 px) +- Ausgangszustand und kompakten Zustand der Kopfzeile bei unverändertem Seitenfluss +- Reduced Motion +- Mobilmenü mit Fokusfalle und Escape +- Tabulatorreihenfolge und sichtbaren Fokus +- Ladeverhalten der Bilder (erstes eager/high, Rest lazy) +- kein horizontales Scrollen bei 390, 768, 1440 und 2560 px + +Kontraste (berechnet): Navy auf Gelb 10,3:1, Navy auf Creme 14:1, Weiß auf Grün dunkel 5,2:1, Grün dunkel auf Weiß 5,2:1, Fußbereichslinks auf Navy 11:1. Die Grundzeilen-Links erreichen auch auf dem grünen Bogen 4,8:1. + +## 10. Screenshots + +Alle von der Testinstanz mit Platzhaltern, unter `docs/analysen/designiteration-1-screenshots/`: + +1. `01-1440-kopfzeile-markenbuehne.jpg`: Ausgangszustand der Kopfzeile, Markenbühne +2. `02-1440-kopfzeile-kompakt.jpg`: kompakte Kopfzeile beim Scrollen +3. `03-1440-referenzseite-gesamt.jpg`: ganze Referenzseite, Desktop +4. `04-2560-breiter-bildschirm.jpg`: breiter Bildschirm, Bühne randlos, Tafel im Standardraster +5. `05-768-referenzseite-gesamt.jpg`: Tablet +6. `06-390-referenzseite-gesamt.jpg`: Smartphone +7. `07-390-mobilmenue.jpg`: geöffnetes Mobilmenü +8. `08-1440-kurze-seite.jpg`: kurze Seite, gleiche Kopfzeile + +## 11. Bekannte Einschränkungen + +- **Navigation der Testinstanz.** Sie hat acht teils lange Einträge. Damit zeigt die Kopfzeile den Kontozugang als Symbol und schaltet zwischen 1280 und 1366 px in den Menümodus. Mit fünf bis sechs kurzen Einträgen wie im Kit-Entwurf bleibt die Navigation bis 75 rem in der Zeile. +- **Kleine Verschiebung beim Kaltstart.** Bei 1440 px und mehr verkürzt sich der Kontozugang beim ersten Messen (CLS 0,0006, weit unter dem Grenzwert 0,1). +- **Keine echten Motive.** Wirkung und Zuschnitte mit echten Motiven sind nicht geprüft (siehe Abschnitt 4). +- **Keine responsiven Bildvarianten.** Es gibt noch kein `srcset`; Bilder werden in Originalgröße ausgeliefert. Feste Formate verhindern Verschiebungen, nicht aber die Ladegröße. Die Ableitungen gehören in die Hintergrundverarbeitung, weil der Webprozess keine Medien schreibt. +- **Programmkarten.** Sie zeigen nur Titel, Kurzbeschreibung und Art. Zuordnung zu Themenbereichen und Umfang stehen nicht im `CatalogEntry` und wären eine Erweiterung des Fachlesers. +- **Karten-Raster.** Bei vier Karten neben einer hervorgehobenen ergibt sich je nach Breite eine einzelne Karte in der letzten Zeile. +- **Vorschau im Editor.** Die Markenbühne ist höher als die Vorschaufläche (22 rem) und wird dort beschnitten (mit Hinweis). Die Gerätevorschau zeigt sie vollständig. +- **Build-Warnung.** `npm run build` meldet „Some chunks are larger than 500 kB“. Ob die Warnung schon vor dieser Iteration auftrat, ist nicht geprüft; diese Iteration ergänzt nur wenige Kilobyte Skript. + +## 12. Empfehlungen für die nächste Designiteration + +1. **Freigaben einholen:** Wortmarke als SVG, Farbwerte, Schriften, drei bis fünf Motive mit geklärten Rechten (Titel und Outro eignen sich für die Markenbühne, das Outro mit freier rechter Fläche besonders). Dann nur `tokens.css`, `components/site/brand.blade.php` und die Medien austauschen. +2. **Bildableitungen in der Hintergrundverarbeitung:** WebP/AVIF in 3–4 Breiten mit `srcset`/`sizes` und Fokuspunkt; Einstieg mit `preload`. +3. **Themensignaturen:** fünf Symbole und Tönungen gestalten, dann in Karten, Programmtafeln und Themenseiten einsetzen. +4. **Programmkarten erweitern:** Themenbereiche und Umfang aus dem veröffentlichten Fachstand im Leser ergänzen; Test, dass nichts Unveröffentlichtes durchsickert. +5. **Navigation redaktionell auf fünf bis sechs Hauptpunkte straffen** (Design-Prinzipien §7: Konzept, Themenbereiche, Programme, Anwendung, Angebote, Mitgliederbereich). +6. **Startseite** aus der Referenz ableiten (redaktionelle Entscheidung, keine technische). +7. Messung mit Prüfwerkzeug (axe, Lighthouse) an der gerenderten Seite vor der Farbfreigabe. + +## 13. Auf der Testinstanz angelegt + +- Seite `/designreferenz` (veröffentlicht, eine Revision). +- Platzhalterbilder im öffentlichen Medienbereich: `cms/platzhalter-markenbuehne-*`, `cms/platzhalter-bild-text-*`, `cms/platzhalter-karte-1/2/3-*` (Dateinamen mit Zufallssuffix). +- Prüfeintrag „Referenz Abschnitte (Prüfeintrag)“ in der Navigation: zweimal angelegt und jeweils wieder gelöscht. Ein Durchlauf brach ab und hinterließ den Eintrag kurzzeitig; der nächste Durchlauf hat ihn entfernt. diff --git a/docs/analysen/designiteration-1-screenshots/01-1440-kopfzeile-markenbuehne.jpg b/docs/analysen/designiteration-1-screenshots/01-1440-kopfzeile-markenbuehne.jpg new file mode 100644 index 0000000..821a874 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/01-1440-kopfzeile-markenbuehne.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/02-1440-kopfzeile-kompakt.jpg b/docs/analysen/designiteration-1-screenshots/02-1440-kopfzeile-kompakt.jpg new file mode 100644 index 0000000..39a9da7 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/02-1440-kopfzeile-kompakt.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/03-1440-referenzseite-gesamt.jpg b/docs/analysen/designiteration-1-screenshots/03-1440-referenzseite-gesamt.jpg new file mode 100644 index 0000000..b9279fd Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/03-1440-referenzseite-gesamt.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/04-2560-breiter-bildschirm.jpg b/docs/analysen/designiteration-1-screenshots/04-2560-breiter-bildschirm.jpg new file mode 100644 index 0000000..b36a948 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/04-2560-breiter-bildschirm.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/05-768-referenzseite-gesamt.jpg b/docs/analysen/designiteration-1-screenshots/05-768-referenzseite-gesamt.jpg new file mode 100644 index 0000000..825e186 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/05-768-referenzseite-gesamt.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/06-390-referenzseite-gesamt.jpg b/docs/analysen/designiteration-1-screenshots/06-390-referenzseite-gesamt.jpg new file mode 100644 index 0000000..af6b7f6 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/06-390-referenzseite-gesamt.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/07-390-mobilmenue.jpg b/docs/analysen/designiteration-1-screenshots/07-390-mobilmenue.jpg new file mode 100644 index 0000000..45a9b7a Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/07-390-mobilmenue.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/08-1440-kurze-seite.jpg b/docs/analysen/designiteration-1-screenshots/08-1440-kurze-seite.jpg new file mode 100644 index 0000000..727cc64 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/08-1440-kurze-seite.jpg differ