Files
laraundfelix/docs/analysen/cms-abschnitte-bericht-2026-11-17.md
LarsandClaude Opus 5.5 3a5e5290f1
CI Feature / test (push) Successful in 32s
Deploy Test / test (push) Successful in 31s
Deploy Test / deploy (push) Successful in 32s
Bringe den Bericht auf den bereitgestellten Stand.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 22:11:09 +01:00

19 KiB
Raw Permalink Blame History

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), dc33f0e (Bericht), c6186fb (Veröffentlichen speichert zuerst, Warnung bei ungespeicherten Änderungen), dazu diese Berichtskorrektur.

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 185 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/4813/4815 grün
Deploy Testinstanz Läufe 4812, 4814, 4816 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. Die Durchläufe dieses Abschnitts (25/25, 8/8, T1–T9) liefen auf Stand 6152451, also vor der Änderung an „Veröffentlichen“ (c6186fb). Danach geprüft: die Suite, der gemeldete Ablauf (direkt veröffentlichen mit neuem Bild) und dass die Warnung bei ungespeicherten Änderungen ohne Änderung nicht erscheint (Neuladen, nach Speichern, Wiederherstellen, Navigation). Die Prüfskripte erwarten im Bestätigungsdialog noch die alte Schaltflächenbeschriftung und müssen für eine Wiederholung angepasst werden (neu: „Speichern und veröffentlichen“).

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.

Rückmeldung des Auftraggebers während der Prüfung: „Bild im Widget gewählt oder hochgeladen, im Editor sichtbar, nach Veröffentlichen nicht auf der Website und nach Neuladen im Editor weg.“ Auswahl, Upload, neue und vorhandene Widgets (Einstieg, Bild und Text, Karten) speicherten auf der Testinstanz jeweils korrekt, sobald „Entwurf speichern“ geklickt wurde. Ein Verlust ließ sich in keinem Ablauf mit „Entwurf speichern“ reproduzieren. Reproduzierbar war nur der Ablauf Übernehmen → Veröffentlichen ohne Speichern: „Veröffentlichen“ stellte die zuletzt gespeicherte Revision live, die ungespeicherte Änderung ging beim Neuladen verloren (Hinweis nur im Bestätigungsdialog). Das ist die wahrscheinliche Ursache, nicht nachgewiesen. Vor Deploy 4812 lief auf der Testinstanz noch der Code der Iteration 1. Behoben: „Veröffentlichen“ speichert zuerst und veröffentlicht genau diesen Stand; unveränderte Stände erzeugen keine weitere Revision; der Editor warnt beim Verlassen oder Neuladen mit ungespeicherten Änderungen. Tests: zwei neue Editor-Tests (zuerst rot, dann grün), Browserprüfung des gemeldeten Ablaufs auf der Testinstanz.

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="<Deploy-Zeitpunkt>" (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 62 Commits hinter develop (einschließlich dieser Berichtskorrektur 63) (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).
  • Seiten /bildpruefung-select und /bildpruefung-upload (veröffentlicht, Bildprüfung zur Rückmeldung), mehrere Revisionen darin; auf /bildpruefung-select zuletzt eine wiederhergestellte, unveröffentlichte Revision.
  • /referenz-abschnitte: Abschnitt 3 („Bild und Text“) hat nachträglich ein Bild erhalten und wurde neu veröffentlicht.
  • Mehrere Testbilder cms/testplatzhalter-hintergrund-*.jpg im öffentlichen Medienbereich der Testinstanz.
  • 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.