diff --git a/docs/analysen/cms-abschnitte-bericht-2026-11-17.md b/docs/analysen/cms-abschnitte-bericht-2026-11-17.md new file mode 100644 index 0000000..a29682c --- /dev/null +++ b/docs/analysen/cms-abschnitte-bericht-2026-11-17.md @@ -0,0 +1,158 @@ +# Abschlussbericht CMS-Iteration 2: Website-Gerüst, Abschnittsraster, Seiteneditor + +Stand: 17.11.2026. Branch `feature/cms-sections`, auf `develop` übernommen (Fast-Forward) und über `deploy-test.yml` auf der Testinstanz (Port 3011) bereitgestellt. **Kein Merge nach `main`, keine Produktivsetzung.** Entwicklerdokumentation: `docs/architektur/cms-widget-registry.md` (Abschnitte, Editor, Rollback), `docs/architektur/designsystem.md` (Tokens, Komponenten, Marke). + +Commits: `480d559` (Umsetzung), `2ac2923` (Dokumentation), `4cad602` (Speicherlimit der Testsuite), `6152451` (Duplizieren direkt hinter dem Original), dazu dieser Bericht. + +## Ausgangslage und Grundlagen + +Geprüft: Implementierung der Iteration 1 (Widget-Registry, acht Widget-Arten, Editor, Vorschau, Revisionen, Navigation, Katalogverweise) im Code; ADR-22, -28, -29, -30, -32, -36 (`12_Entscheidungsprotokoll_ADR.md`, Arbeitsstand mit lokalen Änderungen, nicht verändert); `design-prinzipien.md`; Website-Zielkonzept (§§5–8, Designanalyse und Designsystem); Website-Zielarchitektur (§§4.5, 5.2–5.6); `trainingskonzept-und-produktstruktur.md`; `produktkonfiguration-und-mitgliederbereich.md`; Fachkonzept v1.1; Brand-UI-Kit mit Quellenmanifest. **`00_LUF_Projektkompass.md` ist im Repository nicht vorhanden** (auch nicht unter anderem Pfad). + +## 1. Umgesetzte Funktionen + +- **Abschnittsmodell**: Seite → Abschnitte → Plätze → je Platz höchstens ein Widget aus dem bestehenden Register. Sechs Raster (4, 2+2, 1+3, 3+1, 1+2+1, 1+1+1+1), Abschnittsgestaltung über Aufzählungswerte, stabile Kennungen, versionierte Hülle. +- **Adaptive Widgets**: Mindest- und Vorzugsbreite je Widget-Art im Register; Widget-Ansichten mit Container-Abfragen; Prüfung „zu schmal“ beim Speichern und Hinweis im Editor. +- **Abschnittsgestaltung**: Hintergrund (Standard, helle Markenfläche, dunkle Markenfläche, Markenakzent, Hintergrundbild mit Fokuspunkt und Überlagerung), Breite (schmal, Standard, breit, volle Breite), Abstand (kompakt, normal, großzügig), Trenner (Abstand, Linie, Markenakzent). +- **Editor**: volle Arbeitsbreite; Abschnitte mit grafischer Rasterauswahl, Plätzen im Rasterverhältnis, Widget-Vorschau in echter Platzbreite ohne Bildlaufleiste; Hinzufügen, Duplizieren (direkt hinter dem Original), Verschieben (Pfeile und Ziehen), Löschen mit Rückfrage; Rasterwechsel ohne Widget-Verlust; Fehlermeldungen mit Abschnitt, Platz und Widget-Art; Seite duplizieren. +- **Globales Website-Gerüst**: klebende kompakte Kopfzeile mit vorläufiger Wortmarke, CMS-Hauptnavigation mit aktivem Eintrag und einer Ebene Untermenü, Kontozugang „Mitgliederbereich“, vorbereiteter (abgeschalteter) Warenkorbzugang, mobile Navigation ohne untere Leiste; Fußbereich mit Themenbereichen und den CMS-Gruppen Service, Kontakt, Rechtliches. +- **Gemeinsames Designsystem**: zweistufige Tokens, Grundkomponenten, lokal ausgelieferte Schriften; Mitgliederbereich nutzt dieselben Tokens und dieselbe Wortmarke. +- **Wiederherstellungsweg**: flache Rollback-Fassung je Revision und Befehl `cms:revert-published`. + +## 2. Verwendete und erweiterte Komponenten + +| Bestand | Erweiterung | +|---|---| +| `WidgetRegistry`, `WidgetType`, acht Widget-Arten | `normalizeWidget()` für seitenweite Prüfung; `minUnits()`, `preferredUnits()`, `stages()` | +| `WidgetRenderer`, Widget-Ansichten | unverändert als Renderweg je Widget; Handlungsaufruf nutzt die gemeinsame Schaltfläche | +| `PageService`, `PageRevision` | speichert Abschnitte und Rollback-Fassung; `sections()`, `duplicate()` | +| `PageController`, Vorschaurouten | rendern über `SectionRenderer` | +| `WidgetEditor`, `WidgetBlock` | `slotBuilder()` für Plätze, Mindestbreite in der Auswahl | +| `NavigationItem`, `NavigationItemResource` | Fußbereichsgruppen als Platzwerte, `parent_id` für Untermenüs | +| Layouts `site`/`member`, `components/site/*` | Kopfzeile, Fußbereich, Wortmarke, Warenkorbzugang neu gefasst | +| `resources/css/app.css` | aufgeteilt in Tokens, Grundelemente, Komponenten, Gerüst, Abschnitte, Widgets | +| Neu | `PageSections`, `SectionLayouts`, `SectionStyle`, `SectionRenderer`, `SiteNavigation`, `SectionEditor`, `ReportsSectionErrors`, `RevertPublishedPages`, `site-nav.js` | + +Zwei ergänzende Migrationen: `page_revisions.sections` (JSON, nullable) und `navigation_items.parent_id` (nullable, beim Löschen des Elterneintrags `null`). Keine Daten werden geändert oder gelöscht. + +## 3. Abschnitts- und Slot-Modell + +Siehe `cms-widget-registry.md` §11. Kurz: Ein Abschnitt hat Kennung, Version, Raster, Gestaltung und genau so viele Plätze, wie das Raster Einheiten-Gruppen hat. Ein Platz enthält eine Widget-Hülle oder ist leer. Leere Plätze gibt es im Editor; öffentlich entfallen sie, die übrigen Plätze teilen sich die Breite im Verhältnis ihrer Einheiten; Abschnitte ohne Inhalt entfallen ganz. Mehr Widgets als Plätze werden beim Speichern abgewiesen, nie abgeschnitten. Keine Verschachtelung. + +## 4. Responsive Widget-Regeln + +Siehe `cms-widget-registry.md` §§11–12. Abschnitte stapeln unter 40 rem Abschnittsbreite immer, ab 40 rem bleiben gleich breite Plätze nebeneinander (4 Plätze als 2 × 2), ab 60 rem gilt das Rasterverhältnis. Gestapelt wird in Platzreihenfolge, die Lese- und Fokusreihenfolge bleibt gleich. Mindestbreiten: Einstieg und Bild-und-Text sowie FAQ 2 Einheiten, alle übrigen 1 Einheit (abgeleitet aus rund 276 px je Einheit auf dem Desktop). + +## 5. Gemeinsames Designsystem + +Siehe `designsystem.md`. Markenwerte (Navy `#032551`, Grün `#5b8625`/`#3b7b09`, Gelb `#fcd10a`, Creme `#f7f6f2`, Tinte `#15243a`) aus dem Brand-UI-Kit, ausdrücklich **vorläufig**. Bedeutungswerte für Text, Flächen, Linien, Fokus, Aktion, Erfolg, Warnung, Fehler, Information, Deaktiviert; Flächen setzen sie neu. Alle Textpaare erreichen mindestens 4,5 : 1 (gerechnet); Fokus mindestens 3 : 1. + +## 6. Kopfzeile, Navigation, Fußbereich + +- Kopfzeile 64/72 px, klebend mit Schatten beim Scrollen; Hauptnavigation ab 75 rem in einer Zeile, darunter Menü-Schaltfläche. +- Kontozugang und Kopfzeile sind für Gäste und Mitglieder **identisch** (vorher zeigte die Kopfzeile je nach Anmeldestatus „Registrieren“ oder „Mitgliederbereich“). Gäste gelangen über den Zugang zur Anmeldung. Eine Registrierung ist weiterhin über die Anmeldeseite erreichbar. +- Mobile Navigation: Fläche unter der Kopfzeile, 48 px hohe Einträge, Untermenü eingerückt, Fokusführung und Escape; ohne JavaScript bleibt die Liste sichtbar. Keine feste untere Leiste auf der Website. +- Warenkorb: `config/cms.php` → `cart.enabled` (Vorgabe aus). Solange aus, erscheint nichts. +- Fußbereich: Wortmarke, „Themenbereiche“ (veröffentlichte Säulen), Gruppen aus der CMS-Navigation. Keine erfundenen Kontakt- oder Rechtstexte; bisher gibt es nur die Gruppe „Service“ mit Impressum und Datenschutz. + +## 7. Schnittstellen zum Mitgliederbereich + +Gemeinsam: Tokens (über die bisherigen Variablennamen des Mitgliederbereichs, Werte unverändert), Schriften, Fokusregeln, Wortmarke, Schaltflächen, Formulare, Statusanzeigen. Unverändert: Layout, Seitenleiste, Bibliotheksnavigation, bestehende untere Leiste `member-dock`, Berechtigungen, Suche, Kursplayer. Sichtbare Änderung: Überschriften in Nunito statt Source Serif 4; Zusatz „Mitgliederbereich“ in der dunklen Seitenleiste jetzt kontraststark (vorher dunkle Schrift auf Navy). Geprüft: alle Mitglieder-Tests grün, Sichtprüfung lokal bei 390 und 1440 px ohne horizontalen Überlauf. Auf der Testinstanz stand kein Mitgliedskonto zur Verfügung. + +## 8. Automatisierte Tests + +| Prüfung | Ergebnis | +|---|---| +| Suite lokal | 183 Tests grün (Iteration 1: 145); neu `PageSectionsTest` (17), `CmsSectionRenderingTest` (13), `CmsRollbackCommandTest` (2), erweitert `CmsEditorTest`, `WidgetRegistryTest` | +| Pint | sauber | +| CI Feature-Branch | Läufe 4808/4809 rot, 4810/4811 grün | +| Deploy Testinstanz | Lauf 4812 erfolgreich, `/up` 200 | + +Abgedeckt: Registrierung und Mindestbreiten, Abschnitte und Plätze, Rastervalidierung, Layoutwechsel ohne Datenverlust (Editor und Speicherpfad), Abschnittshintergründe und öffentliche Medienfreigabe, freie Werte abgewiesen, Revisionen, Wiederherstellen und Rollback-Fassung, Navigation (Untermenü, Fußgruppen, ausgeblendete Eltern, Löschen), identische Ausgabe für Gäste und Mitglieder, keine Fremd-Schriftserver, Zugriffsschutz der Vorschau, Kompatibilität mit Altbestand (Text der Startseite unverändert nach Speichern im neuen Format). + +**Ursache der roten CI-Läufe:** Das Test-Image läuft mit dem PHP-Standardlimit von 128 MB; die gesamte Suite überschritt es kumulativ (Fatal Error). `phpunit.xml` setzt nun 512 MB wie `docker/php.ini` der Anwendung. Messung: Eine Bearbeitung einer Seite mit 20 Abschnitten à 2 Plätzen braucht rund 74 MB zusätzlich. Keine Prüfung wurde abgeschwächt. + +## 9. Browserprüfung auf der Testinstanz + +Mit dem Prüfkonto über die Oberfläche (Playwright, Chromium), nicht gegen Prod. + +| Prüfung | Ergebnis | +|---|---| +| Bestehende 12 öffentliche Seiten vor/nach Deploy (Status, Titel, Haupttext) | 12/12 unverändert | +| Referenzseite `/referenz-abschnitte` anlegen, gestalten, Layoutwechsel, Duplizieren, Reihenfolge, Löschen, Vorschau 390/768/1440, Veröffentlichen, Ändern, Revision wiederherstellen, mobile Navigation, Übergang zur Anmeldung | 25/25 | +| Untermenü über die Navigationsverwaltung, Tastatur (Enter, Tab, Escape), mobil, wieder entfernt | 8/8 | +| Kein horizontaler Überlauf bei 1440/768/390 px; genau eine H1 | ja | + +Die Referenzseite enthält: Einstieg über volle Breite auf Hintergrundbild (gekennzeichneter Testplatzhalter, dunkle Überlagerung), 2 + 2 auf heller Fläche, 1 + 3 auf dunkler Fläche, 1 + 1 + 1 + 1 auf Markenakzent, 3 + 1 mit dynamischer Programmreferenz; Trenner Markenakzent und Linie; Varianten Kompakte Liste, Bild rechts, Standard. + +**ADR-28, neun Bedienaufgaben** (automatisiert mit Zeitmessung; ersetzt nicht die Abnahme durch den Betreiber): + +| Nr. | Ergebnis | Zeit | Hinweis | +|---|---|---|---| +| T1 Landingpage aus Vorlage | bestanden | 19 s | „Vorlage“ = vorhandene Seite über „Duplizieren“; Vorlage unverändert | +| T2 Bild und Text, Bild, Alternativtext, Variante | bestanden | 10 s | Widget-Vorschau zeigt „Bild rechts“ vor dem Speichern | +| T3 umsortieren, duplizieren | bestanden | 2 s | erster Durchlauf scheiterte am Messskript (Aktionen ohne Warten auf Livewire), Wiederholung bestanden | +| T4 zwei Programme wählen, tauschen | bestanden | 15 s | Titel aus den Fachdaten | +| T5 zu langer Titel bei 390 px | bestanden (eingeschränkt) | – | kein Überlauf, Silbentrennung greift; „Erkennen ohne Hinweis“ ist nur mit Menschen prüfbar | +| T6 globalen Abschnitt ändern | **nicht bestanden** | – | globale Abschnitte sind nicht umgesetzt | +| T7 frühere Revision wiederherstellen | bestanden | 5 s | | +| T8 20 Abschnitte öffnen, ändern, speichern | bestanden | 2,0 / 0,3 / 1,4 / 2,3 s | Öffnen/Dialog/Übernehmen/Speichern; erste Messung 4,0 s enthielt Wartezeiten des Skripts. Mehrspaltige Seite (6 Abschnitte, 12 Plätze): 1,4 / 1,6 s | +| T9 Pflichtfeld leer | bestanden | 6 s | Dialog bleibt offen; Speicherfehler „Abschnitt 1, Platz 1 (Einstieg): braucht mindestens 2 Rastereinheiten“ als Meldung und am Abschnitt | + +Ergebnis: 8 von 9 Aufgaben technisch bestanden, darunter T1, T4, T8. Die Entscheidungsregel verlangt zusätzlich die Durchführung durch den Betreiber und dessen Aussage „so würde ich wöchentlich arbeiten“; das steht aus. + +Weitere Beobachtungen: Eine Konsolenmeldung 403 während der Bearbeitung (vermutlich Upload-Vorschau, nicht eingegrenzt); alle Bilder der veröffentlichten Seite liefern 200. Bildschirmleser und echte Mobilgeräte wurden nicht geprüft. + +## 10. Bekannte Einschränkungen + +- Keine globalen Abschnitte (T6), keine Seitentypen oder echten Vorlagen; „Duplizieren“ deckt den Vorlagenfall teilweise ab. +- Widget-Vorschauen im Editor zeigen die Abschnittsfläche nicht (heller Grund); die Seitenvorschau zeigt sie. +- Hintergrundbilder werden in Originalgröße ausgeliefert (kein `srcset`, keine abgeleiteten Zuschnitte); Fokuspunkt nur in neun Stufen. +- Mindestbreite gilt je Platz auf dem Desktop; die Widget-Auswahl bietet auch zu breite Widgets an und warnt erst im Platzkopf und beim Speichern. +- Raster mit weniger Plätzen sind gesperrt, solange mehr Widgets eingesetzt sind; ein automatisches „überzählige Widgets in neuen Abschnitt verschieben“ gibt es nicht. +- Öffentliche Seiten werden noch nicht zwischengespeichert (ADR-32 offen); sie sind aber anmeldeunabhängig gerendert. +- Seitenliste der Verwaltung zeigt 10 Einträge je Seite (Bestand). + +## 11. Marken- und Assetfreigaben + +| Asset / Wert | Verwendet | Status | +|---|---|---| +| Markenfarben aus Brand-UI-Kit (`tokens.json`) | ja | **vorläufig**, Freigabe fehlt | +| Nunito (Auszeichnung), Source Sans 3 (Lesen) | ja, lokal ausgeliefert | **vorläufig** (Zielkonzept 7.2, offen); Lizenz als frei angenommen, nicht geprüft | +| Wortmarke als Weblogo | **nein**, fehlt | vorläufiger Schriftzug, gekennzeichnet `data-brand-status="vorlaeufig"` | +| Titel-, Denkpause-, Outro-Motiv | nein | Originale vorhanden, öffentliche Nutzung laut Quellenmanifest nicht freigegeben | +| Figurenreferenzen | nein | nur intern | +| SVG-Entwürfe, KI-Konzeptgrafiken | nein | nicht freigegeben | +| Themensignaturen (5) | Platz vorbereitet (Nummer + Name, neutrale Tönung) | Symbole und Tönungen nicht entworfen | +| Hintergrundbild Referenzseite | gekennzeichneter Testplatzhalter | nur Testinstanz | + +## 12. Rollback- und Wiederherstellungsweg + +Siehe `cms-widget-registry.md` §9. Zusammengefasst: Ein reiner Code-Rollback ist nach Änderungen im neuen Editor **nicht sicher**. Auf Iteration 1 zeigt er alle Inhalte ohne Raster und Flächen; auf den heutigen Prod-Stand (vor der Registry) scheitert er an den neu gespeicherten Seiten. Vor jedem Rollback: `php artisan cms:revert-published --before=""` (Probelauf), dann `--apply`; der Befehl setzt nur Veröffentlichungszeiger zurück. SQL-Gegenstück für den Fall, dass der neue Code nicht mehr läuft, ist dokumentiert. Migrationen müssen nicht zurückgenommen werden. + +Für den späteren Merge nach `main`: `main` liegt jetzt 60 Commits hinter `develop` (Iteration 1 und 2 sowie die früheren Bibliothekspakete). Nach dem Prod-Deploy sollte vor der ersten Bearbeitung im Editor der Deploy-Zeitpunkt notiert werden. + +## 13. Empfehlungen für die visuelle Veredelung + +1. Freigaben einholen: Wortmarke als SVG, Farbwerte (mit gemessenem Kontrast), Schriften, Bildmotive mit Rechten und textfreien Zuschnitten. +2. Dann nur `tokens.css` und `components/site/brand.blade.php` ändern; Sichtprüfung 390/768/1440. +3. Widgets einzeln mit Design-Skills veredeln (Ansicht + `widgets.css`), Daten und Klassen bleiben stabil; zuerst Einstieg, Programmkarten (mit Themensignaturen statt Inhaltsart-Fläche), Bild und Text. +4. Themensignaturen-Familie entwerfen und je Säule pflegbar machen. +5. Abgeleitete Bildgrößen für Abschnittshintergründe über die Hintergrundverarbeitung. +6. UX-Abnahme T1–T9 mit dem Betreiber; anschließend über ADR-28 entscheiden. + +## Auswirkungen auf ADR-28, ADR-30, ADR-36 + +| ADR | Auswirkung | Status | +|---|---|---| +| ADR-28 Ausbau des Eigen-CMS | Abschnittsraster, Gestaltung und Seiten-Duplikat mit Filament-Bordmitteln ohne Zusatzpaket umgesetzt; 8 von 9 Bedienaufgaben technisch bestanden, T6 (globale Abschnitte) offen | **technisch gestützt, UX-Abnahme durch den Betreiber offen**; keine Freigabe durch diesen Bericht | +| ADR-30 Widget-Register | Vertrag unverändert, um Breitenmetadaten ergänzt; Abschnitte als zweite versionierte Hülle über dem Register, kein zweites Register; Editor und Vorschau nutzen weiterhin dieselbe Darstellung | bestätigt im umgesetzten Umfang | +| ADR-36 Designsystem | zweistufige Tokens im Repository, gemeinsame Basis für Website und Mitgliederbereich | Struktur umgesetzt; **Markenwerte und Schriften weiterhin unter Freigabevorbehalt** | +| ADR-32 (berührt) | öffentliche Ausgabe anmeldeunabhängig, Test belegt identisches HTML | Zwischenspeicher weiterhin offen | + +## Auf der Testinstanz angelegt oder geändert + +- Seite `/referenz-abschnitte` (veröffentlicht, Prüftexte, Testplatzhalter als Hintergrund `cms/testplatzhalter-hintergrund-*.jpg`). +- Seiten `/t1-landingpage` und `/t1-landingpage-b` (veröffentlicht, aus den Bedienaufgaben T1/T7). +- Neue Revision der Messseite `/pruefung-zwanzig-abschnitte` (weiterhin unveröffentlicht). +- Ein Navigations-Prüfeintrag wurde angelegt und wieder gelöscht. Keine sonstigen Navigationsänderungen. +- Keine Bereinigung bestehender Testinhalte: Die vorhandenen Seiten werden unverändert dargestellt und sind im neuen Editor bearbeitbar; eine Bereinigung war nicht nötig.