Dokumentiere Umsetzung und Prüfung der Abschnitte und des Website-Gerüsts.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
6152451e2e
commit
dc33f0ee37
1 file changed
+158
@@ -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="<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 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.
|
||||
Reference in new issue
Block a user