Dokumentiere Abschnittsmodell, Rollback-Weg und Designsystem.
CI Feature / test (push) Failing after 16s
CI Feature / test (push) Failing after 16s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
480d55989b
commit
2ac2923852
2 files changed
+268
-42
No files matched your search
@@ -1,38 +1,48 @@
|
||||
# CMS: Widget-Registry, Seiteneditor und Basislayout
|
||||
# CMS: Widget-Registry, Abschnitte, Seiteneditor und Website-Gerüst
|
||||
|
||||
Stand: 17.11.2026, Branch `feature/cms-widget-registry`. Bezug: ADR-22, ADR-28, ADR-29, ADR-30, ADR-36 (`12_Entscheidungsprotokoll_ADR.md`), Website-CMS-Zielarchitektur §§5.3–5.4, 6.2.
|
||||
Stand: 17.11.2026, Iteration 2 (Branch `feature/cms-sections`, baut auf Iteration 1 `feature/cms-widget-registry` auf). Bezug: ADR-22, ADR-28, ADR-29, ADR-30, ADR-32, ADR-36 (`12_Entscheidungsprotokoll_ADR.md`), Website-CMS-Zielarchitektur §§5.3–5.6, 6.2. Designsystem: `docs/architektur/designsystem.md`.
|
||||
|
||||
Dieses Dokument beschreibt den **umgesetzten** Stand für Entwickler. Es ist keine fachliche Freigabe der ADRs.
|
||||
|
||||
## 1. Überblick
|
||||
|
||||
```
|
||||
config/cms.php ──► WidgetRegistry ──► WidgetRenderer ──► widgets/<typ>.blade.php
|
||||
│ ▲
|
||||
Seite → Abschnitte (Raster, Gestaltung) → Plätze → je Platz höchstens ein Widget aus dem Register
|
||||
|
||||
config/cms.php ──► WidgetRegistry ──► PageSections (Lesen, Prüfen, Rollback-Fassung)
|
||||
│ │
|
||||
│ ▼
|
||||
│ SectionRenderer ──► WidgetRenderer ──► widgets/<typ>.blade.php
|
||||
│ ▲ ▲
|
||||
│ │ └── Widget-Vorschau im Editor (WidgetBlock)
|
||||
│ ├── öffentliche Seite (PageController::show)
|
||||
│ ├── Vorschau einer Revision (PageController::preview)
|
||||
│ └── Blockvorschau im Editor (WidgetBlock::renderPreview)
|
||||
└──► WidgetEditor (Filament-Builder: Auswahl, Felder, Varianten, Zusammenfassung)
|
||||
│ └── Vorschau einer Revision (PageController::preview)
|
||||
└──► SectionEditor + WidgetEditor (Filament: Abschnitte, Raster, Plätze, Widget-Dialoge)
|
||||
```
|
||||
|
||||
| Baustein | Datei | Aufgabe |
|
||||
|---|---|---|
|
||||
| Vertrag | `app/Domain/Cms/Widgets/WidgetType.php` | abstrakte Basisklasse jeder Widget-Art |
|
||||
| Register | `app/Domain/Cms/Widgets/WidgetRegistry.php` | Registrierung, Lesen (Anheben älterer Fassungen), Prüfen und Bereinigen beim Speichern |
|
||||
| Darstellung | `app/Domain/Cms/Widgets/WidgetRenderer.php` | einziger Renderweg für alle drei Darstellungsorte |
|
||||
| Editor-Adapter | `app/Filament/Support/WidgetEditor.php`, `WidgetBlock.php` | baut den Filament-Builder vollständig aus dem Register |
|
||||
| Vertrag | `app/Domain/Cms/Widgets/WidgetType.php` | abstrakte Basisklasse jeder Widget-Art, einschließlich Mindestbreite |
|
||||
| Register | `app/Domain/Cms/Widgets/WidgetRegistry.php` | Registrierung, Lesen (Anheben älterer Fassungen), Prüfen und Bereinigen je Widget |
|
||||
| Abschnitte | `app/Domain/Cms/Sections/PageSections.php` | Abschnitts- und Platzmodell: Lesen, Prüfen, flache Rollback-Fassung, Medien |
|
||||
| Raster und Gestaltung | `app/Domain/Cms/Sections/SectionLayouts.php`, `SectionStyle.php` | freigegebene Raster und Gestaltungswerte (Aufzählungen) |
|
||||
| Darstellung | `app/Domain/Cms/Sections/SectionRenderer.php`, `Widgets/WidgetRenderer.php` | einziger Renderweg für Seite, Vorschau und Editor |
|
||||
| Editor-Adapter | `app/Filament/Support/SectionEditor.php`, `WidgetEditor.php`, `WidgetBlock.php`, `ReportsSectionErrors.php` | Abschnitte, Rasterauswahl, Plätze, Widget-Dialoge, Fehlermeldungen |
|
||||
| Navigation | `app/Domain/Cms/SiteNavigation.php` | Kopf- und Fußnavigation aus dem CMS-Navigationsmodell |
|
||||
| Katalog-Lesesicht | `app/Domain/Cms/Catalog/PublicCatalogReader.php` | einzige Stelle, die entscheidet, welche Programme/Module öffentlich erscheinen |
|
||||
| Hilfen | `app/Domain/Cms/Widgets/Support/*` | sichere Links, bereinigter formatierter Text, öffentlicher Medienbereich, Bildauswahl |
|
||||
| Seitenvorlagen | `app/Domain/Cms/PageTemplates.php`, `resources/views/site/templates/` | derzeit nur `standard` |
|
||||
| Layout | `resources/views/layouts/site.blade.php`, `resources/views/components/site/*` | Kopf, Marke, Navigation, Inhaltsbereich, Fuß |
|
||||
| Seitenvorlagen | `app/Domain/Cms/PageTemplates.php`, `resources/views/site/templates/` | derzeit nur `standard` (Abschnitte untereinander) |
|
||||
| Layout | `resources/views/layouts/site.blade.php`, `resources/views/components/site/*` | Kopfzeile, Wortmarke, Navigation, Inhaltsfläche, Fußbereich |
|
||||
| Designsystem | `resources/css/{tokens,base,components,site,sections,widgets}.css` | Tokens, Grundkomponenten, Gerüst, Abschnitte, Widgets |
|
||||
| Wiederherstellung | `app/Console/Commands/RevertPublishedPages.php` | `cms:revert-published` vor einem Code-Rollback (Abschnitt 9) |
|
||||
|
||||
## 2. Widget-Vertrag
|
||||
|
||||
Jede Instanz in `page_revisions.blocks` hat dieselbe Hülle:
|
||||
Jede Widget-Instanz (in einem Platz von `page_revisions.sections` und in der flachen Liste `page_revisions.blocks`) hat dieselbe Hülle:
|
||||
|
||||
| Feld | Inhalt |
|
||||
|---|---|
|
||||
| `id` | stabile Kennung (UUID), bleibt beim Bearbeiten erhalten; Duplikate erhalten beim Speichern eine neue |
|
||||
| `id` | stabile Kennung (UUID), bleibt beim Bearbeiten erhalten; Duplikate erhalten beim Speichern eine neue (seitenweit geprüft) |
|
||||
| `type` | Typkennung aus dem Register; ändert sich nie |
|
||||
| `v` | Schemaversion der Art |
|
||||
| `variant` | eine der für die Art registrierten Varianten |
|
||||
@@ -46,36 +56,37 @@ ## 3. Versionierung und Altbestand
|
||||
|
||||
- **Altformat** (vor der Registry: `{type, heading, intro, …}` ohne `v`) wird beim Lesen als Version 1 interpretiert (`WidgetType::fromLegacy`).
|
||||
- Liegt `v` unter der aktuellen Version, hebt `WidgetType::upgrade($widget, $from)` schrittweise an.
|
||||
- Gespeicherte Revisionen werden **nicht** umgeschrieben. Erst eine neue Revision aus dem Editor speichert die aktuelle Hülle.
|
||||
- „Wiederherstellen“ kopiert die Bausteine einer Revision unverändert.
|
||||
- Unbekannte Arten werden öffentlich ausgelassen und in der Vorschau als Hinweis gezeigt. Eine Hülle mit höherer Version als im Code (zum Beispiel nach einem Code-Rollback) wird bestmöglich dargestellt, aber nicht gespeichert.
|
||||
- Regel: Optionale neue Felder brauchen keine neue Version. Umbenennen, Umdeuten oder Verschieben von Feldern braucht eine neue Version mit `upgrade()` und einen Test.
|
||||
- **Revisionen ohne Abschnitte** (`sections = null`, alles vor Iteration 2) werden als einspaltige Abschnitte mit kompaktem Abstand gelesen (`PageSections::read`).
|
||||
- Gespeicherte Revisionen werden **nicht** umgeschrieben. Erst eine neue Revision aus dem Editor speichert Abschnitte und aktuelle Hüllen.
|
||||
- „Wiederherstellen“ kopiert Abschnitte und flache Liste einer Revision unverändert.
|
||||
- Unbekannte Widget-Arten werden ausgelassen; unbekannte Raster- oder Gestaltungswerte fallen beim Lesen auf Vorgaben zurück. Eine Hülle mit höherer Version als im Code wird bestmöglich dargestellt, aber nicht gespeichert.
|
||||
- Regel: Optionale neue Felder brauchen keine neue Version. Umbenennen, Umdeuten oder Verschieben von Feldern braucht eine neue Version mit `upgrade()` und einen Test. Gleiches gilt für die Abschnittshülle (`PageSections::VERSION`).
|
||||
|
||||
Beispiel: `image_text` Version 1 `{image, alt, body (Klartext)}` → Version 2 `data {title, body (bereinigtes HTML), alt}`, `refs {image}`, Variante `image_left`.
|
||||
|
||||
## 4. Registrierte Widget-Arten
|
||||
|
||||
| Kennung | Name | Version | Varianten | Verweise |
|
||||
|---|---|---|---|---|
|
||||
| `hero` | Einstieg (Hero) | 1 | `standard` (Bild neben dem Text), `highlight` (Markenfläche) | `refs.image` |
|
||||
| `heading` | Überschrift und Einleitung | 1 | `standard` | – |
|
||||
| `prose` | Fließtext | 1 | `standard` | – |
|
||||
| `image_text` | Bild und Text | 2 | `image_left`, `image_right` | `refs.image` |
|
||||
| `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (kompakte Liste) | Bild je Karte in `data.items[].image` |
|
||||
| `catalog_cards` | Programm- und Modulkarten | 1 | `standard` (Karten mit Kurzbeschreibung), `compact` (Liste) | `refs.items[] = {type: composition, id}` |
|
||||
| `call_to_action` | Handlungsaufruf | 1 | `standard` | – |
|
||||
| `faq` | FAQ | 1 | `standard` | – |
|
||||
| Kennung | Name | Version | Varianten | Verweise | Mindestbreite |
|
||||
|---|---|---|---|---|---|
|
||||
| `hero` | Einstieg (Hero) | 1 | `standard` (Bild neben dem Text), `highlight` (Markenfläche) | `refs.image` | 2 |
|
||||
| `heading` | Überschrift und Einleitung | 1 | `standard` | – | 1 |
|
||||
| `prose` | Fließtext | 1 | `standard` | – | 1 |
|
||||
| `image_text` | Bild und Text | 2 | `image_left`, `image_right` | `refs.image` | 2 |
|
||||
| `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (kompakte Liste) | Bild je Karte in `data.items[].image` | 1 |
|
||||
| `catalog_cards` | Programm- und Modulkarten | 1 | `standard` (Karten mit Kurzbeschreibung), `compact` (Liste) | `refs.items[] = {type: composition, id}` | 1 |
|
||||
| `call_to_action` | Handlungsaufruf | 1 | `standard` | – | 1 |
|
||||
| `faq` | FAQ | 1 | `standard` | – | 2 |
|
||||
|
||||
Darstellungsklassen: `widget widget-<typ> widget-variant-<variante>` an der Abschnittshülle; je Ansicht eigene Klassen (`hero-highlight`, `image-text-right`, `cards-compact`, `catalog-cards-compact`). Ein späterer Design-Schritt verändert nur `resources/views/widgets/*` und `resources/css/app.css`, nicht Daten oder Editor.
|
||||
Darstellungsklassen: `widget widget-<typ> widget-variant-<variante>` an der Widget-Hülle; je Ansicht eigene Klassen (`hero-highlight`, `image-text-right`, `cards-compact`, `catalog-cards-compact`). Die visuelle Veredelung verändert nur `resources/views/widgets/*` und `resources/css/widgets.css`, nicht Daten, Register oder Editor.
|
||||
|
||||
## 5. Neues Widget hinzufügen
|
||||
|
||||
1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()` (Verweise zur Laufzeit auflösen), `mediaPaths()`, `summary()`, `schematic()`, `icon()`.
|
||||
2. Ansicht `resources/views/widgets/<kennung>.blade.php` anlegen. Verfügbar: `$data`, `$refs`, `$variant`, `$settings`, `$first`, `$context` (Vorschau ja/nein) und die Rückgabe von `resolve()`. Kein `{!! !!}` außer für mit `RichText::sanitize` bereinigten Text.
|
||||
1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, `minUnits()`/`preferredUnits()`/`stages()` (Abschnitt 12), `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()`, `mediaPaths()`, `summary()`, `schematic()`, `icon()`.
|
||||
2. Ansicht `resources/views/widgets/<kennung>.blade.php` anlegen. Verfügbar: `$data`, `$refs`, `$variant`, `$settings`, `$first`, `$context` (Vorschau ja/nein) und die Rückgabe von `resolve()`. Kein `{!! !!}` außer für mit `RichText::sanitize` bereinigten Text. Breitenabhängige Regeln als Container-Abfrage `@container slot (…)`, nicht als Fenster-Medienabfrage; Farben nur über Bedeutungs-Tokens.
|
||||
3. Klasse in `config/cms.php` unter `widgets` eintragen.
|
||||
4. Tests ergänzen (Registrierung und Prüfregeln in `tests/Unit/WidgetRegistryTest.php`, Darstellung in `tests/Feature/CmsWidgetRenderingTest.php`).
|
||||
4. Tests ergänzen (Registrierung und Prüfregeln in `tests/Unit/WidgetRegistryTest.php`, Darstellung in `tests/Feature/CmsWidgetRenderingTest.php` bzw. `CmsSectionRenderingTest.php`).
|
||||
|
||||
Editor, Vorschau, Speicherung und öffentliche Darstellung brauchen keine Änderung. `WidgetRegistryTest::test_a_new_widget_type_works_through_the_contract_alone` belegt das mit einer nur im Test definierten Art.
|
||||
Editor, Plätze, Vorschau, Speicherung und öffentliche Darstellung brauchen keine Änderung. `WidgetRegistryTest::test_a_new_widget_type_works_through_the_contract_alone` belegt das mit einer nur im Test definierten Art.
|
||||
|
||||
**Fachobjekt-Widgets** (künftig Angebote, Lizenzartikel, Kampagnen) speichern ausschließlich Kennungen in `refs` und lesen Anzeigeinhalte über eine Lesesicht wie `PublicCatalogReader`. Preise, Rechte und Angebotsbedingungen werden nie in `data` kopiert.
|
||||
|
||||
@@ -95,23 +106,111 @@ ## 6. Öffentliche Freigabe von Programmen und Modulen (Übergangsregel)
|
||||
|
||||
## 7. Medien
|
||||
|
||||
- Wählbar sind nur Bilder im öffentlichen Website-Bereich `cms/` (`media_public` bzw. noch nicht übertragene Uploads in `cms_incoming`). Bibliotheksmedien erscheinen nicht.
|
||||
- Neue Uploads landen im Webprozess in `cms_incoming` (privater Speicher); `PublishPublicMedia` überträgt sie in der Hintergrundverarbeitung nach `media_public`. Der Web-Prozess schreibt nicht in den Medienbestand.
|
||||
- Bilder sind in jedem Widget an einen Alternativtext gebunden (Ausnahme: Kartenbilder gelten als dekorativ, `alt=""`).
|
||||
- Wählbar sind nur Bilder im öffentlichen Website-Bereich `cms/` (`media_public` bzw. noch nicht übertragene Uploads in `cms_incoming`). Bibliotheksmedien und Filmstandbilder erscheinen nicht, auch nicht als Abschnittshintergrund.
|
||||
- Neue Uploads (Widgets und Abschnittshintergründe) landen im Webprozess in `cms_incoming` (privater Speicher); `PublishPublicMedia` überträgt sie in der Hintergrundverarbeitung nach `media_public`. Der Web-Prozess schreibt nicht in den Medienbestand.
|
||||
- Widget-Bilder sind an einen Alternativtext gebunden (Ausnahme: Kartenbilder gelten als dekorativ, `alt=""`). Abschnittshintergründe sind dekorativ (`alt=""`); tragende Aussagen stehen als HTML-Text in den Widgets.
|
||||
|
||||
## 8. Editor und Vorschau
|
||||
|
||||
- Seiteneditor: Abschnitte als kompakte Vorschau (dieselbe Ansicht wie öffentlich, in einem isolierten `iframe` mit dem Website-Stylesheet), Kopfzeile mit Art · Variante – Zusammenfassung, Aktionen Sortieren (Pfeile und Ziehen), Bearbeiten (Dialog), Duplizieren, Löschen.
|
||||
- Arbeitsfläche in voller Breite (`maxContentWidth = Full`); „Seite und Suchmaschinen“ ist beim Bearbeiten eingeklappt.
|
||||
- **Abschnitte** (Repeater): Kopfzeile „Abschnitt N · Raster 1 + 3 · Fläche · Widgets“; Aktionen Ziehen, nach oben/unten, Duplizieren, Löschen (mit Rückfrage), Einklappen, jeweils mit Tooltip.
|
||||
- **Raster**: grafische Auswahl mit sechs Kacheln. Raster mit weniger Plätzen als eingesetzten Widgets sind gesperrt. Beim Wechsel entfallen zuerst leere Plätze; Widgets behalten ihre Reihenfolge (`SectionEditor::arrangeSlots`). Kein Wechsel entfernt ein Widget.
|
||||
- **Gestaltung des Abschnitts** (eingeklappt, Zusammenfassung im Kopf): Hintergrund, Breite, Abstand, Trenner; bei Hintergrundbild zusätzlich Bild (Auswahl oder Upload), Fokuspunkt und Überlagerung. Abschnitts- und Widget-Einstellungen sind getrennt.
|
||||
- **Plätze** stehen im Verhältnis des Desktop-Rasters nebeneinander; Widgets lassen sich per Ziehen zwischen Plätzen tauschen. Der Platzkopf nennt Breite und warnt, wenn das Widget breiter sein müsste. Ein freier Platz bietet „Widget einsetzen“ (Auswahl mit Name, Beschreibung, Symbolbild, Mindestbreite), danach öffnet der Widget-Dialog. Ein Klick auf die Vorschau öffnet denselben Dialog: eine Dialogebene.
|
||||
- **Widget-Vorschau**: dieselbe Ansicht wie öffentlich, im isolierten `iframe` mit dem Website-Stylesheet, in der tatsächlichen Platzbreite (Container-Abfragen greifen). Keine eigene Bildlaufleiste; über 22 rem wird gekürzt mit Hinweis „vollständig in der Seitenvorschau“. Die Abschnittsfläche zeigt erst die Seitenvorschau.
|
||||
- „Entwurf speichern“ erzeugt eine Revision; „Veröffentlichen“ setzt die zuletzt gespeicherte Revision live.
|
||||
- Ganzseitige Vorschau: `/redaktion/vorschau/{revision}/geraete` mit Umschaltern 390/768/1440 px; nur für Personal (`auth:staff` + Seitenrecht).
|
||||
- Ganzseitige Vorschau: `/redaktion/vorschau/{revision}/geraete` mit Umschaltern 390/768/1440 px; zeigt Kopfzeile, Navigation, Abschnitte, Flächen, Trenner und Fußbereich mit demselben Renderer wie die öffentliche Seite; `noindex`.
|
||||
- Revisionen: Vorschau, Veröffentlichen, Wiederherstellen (legt eine neue Revision an).
|
||||
- Seitenliste: „Duplizieren“ legt eine unveröffentlichte Kopie des zuletzt gespeicherten Stands unter neuer Adresse an; die Vorlage bleibt unverändert.
|
||||
|
||||
Fehler, die erst die Registry beim Speichern erkennt (zum Beispiel Bild ohne Alternativtext, nicht mehr freigegebenes Programm), erscheinen zusätzlich als Meldung mit Abschnittsnummer und Art, weil die Felder im Dialog liegen. Pflichtfelder prüft schon der Dialog beim Übernehmen.
|
||||
Fehler beim Speichern erscheinen als Meldung „Abschnitt N, Platz M (Widget-Art): …“ und als Zusammenfassung am Platzraster des Abschnitts, auch wenn das Feld im geschlossenen Widget-Dialog liegt (Registry-Fehler über `SectionEditor::mapErrors`, Formularfehler über `ReportsSectionErrors`).
|
||||
|
||||
## 9. Rollback und Datenformat (wichtig vor dem Merge nach `main`)
|
||||
|
||||
Die Migration (`is_visible`) ist ergänzend. Das **Datenformat der Revisionen** ist es nicht in Rückrichtung: Jede Seite, die nach dem Deploy im neuen Editor gespeichert wird, liegt im Hüllenformat vor. Der Code-Rollback von `scripts/deploy.sh` setzt nur den Code zurück; der alte Code kann Hüllen und die neuen Arten `hero`/`catalog_cards` nicht darstellen (Fehler 500 auf genau diesen Seiten, sofern deren veröffentlichte Revision im neuen Format ist). Abhilfe nach einem Rollback: In der Revisionsliste eine Revision aus der Zeit vor dem Deploy veröffentlichen (sie liegt unverändert im Altformat vor) oder den Code wieder vorwärts deployen.
|
||||
**Speicherung.** Jede neue Revision schreibt zwei Spalten:
|
||||
|
||||
| Spalte | Inhalt | Wer liest sie |
|
||||
|---|---|---|
|
||||
| `page_revisions.sections` (neu, ergänzend, nullable) | Abschnitte mit Raster, Gestaltung und Plätzen | Code ab Iteration 2 |
|
||||
| `page_revisions.blocks` (bestehend) | alle Widgets in Lesereihenfolge als flache Hüllenliste | Code der Iteration 1; Iteration 2 nur bei `sections = null` |
|
||||
|
||||
**Was ein reiner Code-Rollback bewirkt** (`scripts/deploy.sh` setzt nur den Code zurück):
|
||||
|
||||
| Rollback auf | Seiten, die nach dem Deploy gespeichert wurden | Sicher? |
|
||||
|---|---|---|
|
||||
| Iteration 1 (Widget-Registry ohne Abschnitte) | zeigen alle Widgets untereinander; Raster, Flächen, Hintergrundbilder, Trenner und Untermenüs entfallen | darstellbar, aber **nicht gleichwertig** |
|
||||
| Stand vor der Widget-Registry (derzeitiger Stand `main`/Prod) | `blocks` liegt im Hüllenformat vor, das dieser Code nicht lesen kann: Fehler auf genau diesen Seiten | **nicht sicher** |
|
||||
|
||||
**Wiederherstellungsweg** (vor dem Code-Rollback, solange der neue Code läuft):
|
||||
|
||||
1. Probelauf: `php artisan cms:revert-published --before="<Zeitpunkt des Deployments>"` listet jede veröffentlichte Seite, deren Revision danach entstand, und die Revision, auf die zurückgesetzt würde.
|
||||
2. Ausführen mit `--apply`: Nur der Veröffentlichungszeiger wechselt auf die letzte Revision vor dem Zeitpunkt (Altformat). Seiten ohne ältere Revision werden zurückgezogen, nicht gelöscht. Keine Revision wird geändert oder gelöscht.
|
||||
3. Danach den Code zurückrollen. Nach einem erneuten Vorwärts-Deploy lassen sich die neueren Revisionen in der Revisionsliste wieder veröffentlichen.
|
||||
|
||||
Ist der neue Code nicht mehr lauffähig, entspricht Schritt 2 dieser Anweisung (nur nach bestätigtem Backup, PostgreSQL; `:deploy` ersetzen):
|
||||
|
||||
```sql
|
||||
UPDATE pages p SET published_revision_id = (
|
||||
SELECT r.id FROM page_revisions r
|
||||
WHERE r.page_id = p.id AND r.created_at < :deploy ORDER BY r.id DESC LIMIT 1)
|
||||
WHERE p.published_revision_id IN (SELECT id FROM page_revisions WHERE created_at >= :deploy);
|
||||
```
|
||||
|
||||
Die Migrationen (`sections`, `parent_id`) sind ergänzend und müssen beim Rollback nicht zurückgenommen werden; älterer Code ignoriert beide Spalten. Ein reiner Code-Rollback ist nach redaktionellen Änderungen im neuen Editor **nicht** als sicher anzusehen; der Weg oben ist Teil jedes Rollbacks.
|
||||
|
||||
## 10. Navigation
|
||||
|
||||
`NavigationItemResource`: Einträge bearbeiten, aus-/einblenden (`is_visible`), löschen, Reihenfolge per Ziehen („Reihenfolge ändern“), gruppiert nach Kopf-/Fußzeile, interne Seite oder geprüfte Adresse. Keine zweite Navigationsstruktur im Seiteneditor, keine Mehrstufigkeit.
|
||||
`NavigationItemResource`: Einträge bearbeiten, aus-/einblenden (`is_visible`), löschen, Reihenfolge per Ziehen („Reihenfolge ändern“), interne Seite oder geprüfte Adresse.
|
||||
|
||||
- **Plätze**: `header` (Hauptnavigation), `footer` (Fußbereich: Service), `footer_contact` (Kontakt), `footer_legal` (Rechtliches). Die Fußbereichsgruppen sind Werte derselben Spalte, keine zweite Verwaltung. Leere Gruppen erscheinen nicht.
|
||||
- **Untermenü**: eine Ebene über `parent_id` (ergänzende Migration), nur in der Hauptnavigation und nur unter Einträgen der obersten Ebene. Ist der übergeordnete Eintrag ausgeblendet, sind seine Untereinträge es auch; wird er gelöscht, rücken sie nach oben. Ein Eintrag mit Untereinträgen darf ohne eigenes Ziel nur das Untermenü öffnen.
|
||||
- **Aktiver Eintrag**: aus dem angefragten Pfad (`aria-current="page"`; der übergeordnete Eintrag wird als aktiver Pfad markiert).
|
||||
- Die Ausgabe hängt nie vom Anmeldestatus ab (ADR-32). Der Kontozugang „Mitgliederbereich“ ist für alle gleich und leitet Gäste zur Anmeldung.
|
||||
|
||||
## 11. Abschnitte und Plätze
|
||||
|
||||
Gespeicherte Hülle eines Abschnitts (`sections[]`, Version 1):
|
||||
|
||||
```json
|
||||
{"id": "uuid", "v": 1, "layout": "u1_3",
|
||||
"style": {"background": "dark", "image": null, "focus": "center", "overlay": "light",
|
||||
"width": "standard", "spacing": "normal", "divider": "line"},
|
||||
"slots": [{"id": "…", "type": "cards", "v": 1, "…": "…"}, null]}
|
||||
```
|
||||
|
||||
| Raster | Einheiten | Desktop (Abschnitt ab 60 rem) | Tablet (40–60 rem) | Smartphone |
|
||||
|---|---|---|---|---|
|
||||
| `u4` | 4 | volle Breite | volle Breite | volle Breite |
|
||||
| `u2_2` | 2 + 2 | 1 : 1 | zwei Spalten | gestapelt |
|
||||
| `u1_3` / `u3_1` | 1 + 3 / 3 + 1 | 1 : 3 / 3 : 1 | gestapelt | gestapelt |
|
||||
| `u1_2_1` | 1 + 2 + 1 | 1 : 2 : 1 | gestapelt | gestapelt |
|
||||
| `u1_1_1_1` | 1 + 1 + 1 + 1 | vier Spalten | 2 × 2 | gestapelt |
|
||||
|
||||
- Die Einheiten werden als Spaltenverhältnis (`fr`) umgesetzt, nicht als zweites CSS-Grundraster. Der Umbruch richtet sich nach der Breite des Abschnitts (Container-Abfrage `section`); ein schmaler Abschnitt stapelt deshalb früher.
|
||||
- Gestapelt wird immer in Platzreihenfolge; Lese- und Fokusreihenfolge bleiben gleich (keine visuelle Umordnung).
|
||||
- **Leere Plätze** gibt es im Editor. Öffentlich entfallen sie; die übrigen Plätze teilen sich die Breite im Verhältnis ihrer Einheiten. Ein Abschnitt ohne darstellbares Widget entfällt samt Fläche und Trenner.
|
||||
- **Gestaltung**: nur Aufzählungswerte (`SectionStyle`), abgebildet auf Tokens. Freie Werte (Farbcodes, CSS, unbekannte Schlüssel) werden abgewiesen.
|
||||
- Hintergrund: Standard, helle Markenfläche, dunkle Markenfläche, Markenakzent, Hintergrundbild. Jede Fläche setzt die Bedeutungs-Tokens neu (`scope-dark`, `scope-accent`, `scope-light`).
|
||||
- Breite: schmal (45 rem), Standard (75 rem), breit (90 rem), volle Breite. Der Hintergrund reicht immer über die ganze Bildschirmbreite.
|
||||
- Abstand: kompakt, normal (48 → 96 px), großzügig.
|
||||
- Hintergrundbild: nur aus `cms/`, Fokuspunkt als `object-position` (neun Positionen), Überlagerung hell (84 % Weiß) oder dunkel (78 % Navy) oder keine. Das Bild des ersten Abschnitts lädt sofort, alle übrigen verzögert.
|
||||
- **Trenner** stehen zwischen Abschnitten, nie nach dem letzten: zusätzlicher Abstand, dezente Linie, Markenakzent (kurzer gelber Balken).
|
||||
- **Erstes Widget** der Seite ist der Seiteneinstieg (Überschrift erster Ordnung); seitenweit genau eine.
|
||||
- **Grenzen**: höchstens 30 Abschnitte und 60 Widgets je Seite; keine Verschachtelung.
|
||||
|
||||
## 12. Responsive Widget-Regeln
|
||||
|
||||
Jede Widget-Art meldet `minUnits()` (kleinste zulässige Platzbreite auf dem Desktop), `preferredUnits()` (Hinweis) und `stages()` (Darstellungsstufen). Jeder Platz ist ein Container (`slot`); die Widget-Ansichten verwenden Container-Abfragen statt Fensterbreiten.
|
||||
|
||||
| Widget | Mindestbreite | Vorzug | Stufen |
|
||||
|---|---|---|---|
|
||||
| Einstieg (Hero) | 2 | 4 | unter 48 rem Bild unter dem Text; ab 48 rem nebeneinander; Überschrift wächst mit der Platzbreite |
|
||||
| Überschrift | 1 | 4 | Größe folgt der Platzbreite |
|
||||
| Fließtext | 1 | 2 | Zeilenlänge höchstens etwa 70 Zeichen |
|
||||
| Bild und Text | 2 | 4 | unter 36 rem gestapelt; ab 36 rem Bild links oder rechts |
|
||||
| Redaktionelle Karten | 1 | 4 | so viele Karten nebeneinander, wie bei 14 rem Kartenbreite passen |
|
||||
| Programm- und Modulkarten | 1 | 4 | ab 16 rem Kartenbreite mehrspaltig; kompakte Liste für schmale Plätze |
|
||||
| Handlungsaufruf | 1 | 2 | unter 20 rem Schaltfläche in voller Breite |
|
||||
| FAQ | 2 | 4 | Fragen untereinander, Antworten auf Lesebreite |
|
||||
|
||||
Ableitung: Ein Platz mit einer Einheit ist bei Standardbreite auf dem Desktop etwa 17 rem (rund 276 px) breit. Bild-neben-Text und Einstieg sind darin nicht sinnvoll lesbar (zwei Spalten unter je 140 px); Karten, Fließtext und Aufrufe bleiben es. Ein zu schmaler Platz wird beim Speichern mit Abschnitt und Platz gemeldet; der Platzkopf im Editor zeigt „zu schmal“ bereits vorher. Auf Tablet und Smartphone stapeln die Plätze, dort gilt die Mindestbreite nicht.
|
||||
@@ -0,0 +1,127 @@
|
||||
# Gemeinsames Designsystem (ADR-36) – umgesetzter Stand
|
||||
|
||||
Stand: 17.11.2026, Branch `feature/cms-sections`. Gilt für öffentliche Website, Anmeldung, Mitgliederbereich und Mitgliederbibliothek; später für Warenkorb und Checkout. Die Verwaltung (Filament) bleibt in Standardgestaltung.
|
||||
|
||||
**Status der Werte:** Alle Markenwerte, Schriften und die Wortmarke sind **vorläufig**. Sie stammen aus `docs/Brand-UI-Kit/02_design_tokens` (Entwurf vom 15.11.2026, aus den Originalmotiven abgeleitet, laut Kit nicht freigegeben) und aus der Empfehlung im Website-Zielkonzept §7.2. Diese Datei ist keine Markenfreigabe. Eine Freigabe ändert ausschließlich `resources/css/tokens.css` (und für die Wortmarke `resources/views/components/site/brand.blade.php`).
|
||||
|
||||
## 1. Dateien
|
||||
|
||||
| Datei | Inhalt |
|
||||
|---|---|
|
||||
| `resources/css/tokens.css` | Ebene 1 Markenwerte (`--lf-*`), Ebene 2 Bedeutungswerte (`--color-*`), Typografie, Abstände, Rundungen, Layoutmaße, Flächen-Gültigkeitsbereiche `.scope-dark`, `.scope-accent`, `.scope-light` |
|
||||
| `resources/css/base.css` | Grundelemente, Überschriften, Links, Fokus, Sprunglink, `prefers-reduced-motion` |
|
||||
| `resources/css/components.css` | Grundkomponenten: Container, Schaltflächen, Formulare, Statusanzeigen, Karte, Dialog, Kennzeile, Themensignatur, Redaktionshinweise |
|
||||
| `resources/css/site.css` | Website-Gerüst: Wortmarke, Kopfzeile, Hauptnavigation, mobile Navigation, Inhaltsfläche, Fußbereich |
|
||||
| `resources/css/sections.css` | Abschnitte, Raster, Flächen, Hintergrundbilder, Trenner |
|
||||
| `resources/css/widgets.css` | Widget-Ansichten (Container-Abfragen) |
|
||||
| `resources/css/app.css` | bindet alles ein; Mitgliederbereich über seine bisherigen Variablennamen, die auf die gemeinsamen Tokens zeigen |
|
||||
| `vite.config.js` | Schriften Nunito (700, 800) und Source Sans 3 (400, 600), beim Build lokal abgelegt; keine Anfrage an Fremdserver zur Laufzeit |
|
||||
|
||||
## 2. Markenwerte (Ebene 1, vorläufig)
|
||||
|
||||
| Token | Wert | Herkunft | Verwendung |
|
||||
|---|---|---|---|
|
||||
| `--lf-navy` | `#032551` | Brand-UI-Kit, Titelmotiv | Überschriften, Navigation, dunkle Flächen, Fußbereich |
|
||||
| `--lf-navy-deep` | `#01244c` | Brand-UI-Kit | Reserve |
|
||||
| `--lf-green` | `#5b8625` | Brand-UI-Kit | nur Flächen ohne Text (Weiß darauf nur 4,3:1) |
|
||||
| `--lf-green-deep` | `#3b7b09` | Brand-UI-Kit | Aktionsfläche, Markenakzent, Link-Hover |
|
||||
| `--lf-yellow` | `#fcd10a` | Brand-UI-Kit | Akzentlinien, Trenner, aktive Navigation, Fokus auf dunklen Flächen; nie Textfarbe auf hellem Grund |
|
||||
| `--lf-cream` | `#f7f6f2` | Brand-UI-Kit | helle Markenfläche |
|
||||
| `--lf-white` | `#ffffff` | Brand-UI-Kit | Seitenfläche, Karten |
|
||||
| `--lf-ink` | `#15243a` | Brand-UI-Kit | Fließtext |
|
||||
| `--lf-ink-muted` | `#3e4c5c` | bisheriger Mitgliederbereich | leiser Text |
|
||||
| `--lf-line` | `#d5ddd6` | bisheriger Mitgliederbereich | Linien |
|
||||
| `--lf-focus` | `#1769aa` | Brand-UI-Kit | Fokusrahmen auf hellem Grund |
|
||||
|
||||
Nicht übernommen: Farbwerte der KI-Konzeptgrafiken (`04_visuelle_entwuerfe`) und die nur in der HTML-Vorschau verwendeten Zwischentöne.
|
||||
|
||||
## 3. Bedeutungswerte (Ebene 2)
|
||||
|
||||
`--color-text`, `--color-text-muted`, `--color-heading`, `--color-link`, `--color-link-hover`, `--color-surface`, `--color-surface-subtle`, `--color-surface-raised`, `--color-border`, `--color-border-strong`, `--color-focus`, `--color-accent`, `--color-action`, `--color-action-hover`, `--color-action-text`, `--color-action-secondary-text`, `--color-success(-surface)`, `--color-warning(-surface)`, `--color-danger(-surface)`, `--color-info(-surface)`, `--color-disabled(-surface)`, `--color-theme-1` bis `--color-theme-5`.
|
||||
|
||||
Komponenten und Widgets verwenden nur diese Werte. Dunkle Flächen, Markenakzent und Hintergrundbilder setzen sie über `.scope-dark`, `.scope-accent` und `.scope-light` neu; Karten mit eigener heller Fläche setzen sie lokal zurück. Dadurch funktionieren alle Widgets auf allen Abschnittsflächen ohne Sonderregeln.
|
||||
|
||||
## 4. Kontraste (berechnet nach WCAG-Formel)
|
||||
|
||||
| Paar | Kontrast | Anforderung |
|
||||
|---|---|---|
|
||||
| Fließtext `#15243a` auf Weiß / Creme | 15,61 / 14,43 : 1 | Text 4,5 |
|
||||
| Leiser Text `#3e4c5c` auf Weiß / Creme | 8,78 / 8,11 : 1 | Text 4,5 |
|
||||
| Navy (Überschrift, Link) auf Weiß | 15,14 : 1 | Text 4,5 |
|
||||
| Weiß auf Aktionsgrün `#3b7b09` (Schaltfläche, Markenakzent) | 5,22 : 1 | Text 4,5 |
|
||||
| Text `#f4f6f8` / leise `#d3dde8` auf Navy | 13,97 / 11,01 : 1 | Text 4,5 |
|
||||
| Navy auf Gelb (Schaltfläche auf dunkler Fläche) | 10,28 : 1 | Text 4,5 |
|
||||
| Leiser Text `#eef4e8` auf Aktionsgrün | 4,66 : 1 | Text 4,5 |
|
||||
| Fokus `#1769aa` auf Weiß; Gelb auf Navy; Gelb auf Grün | 5,77 / 10,28 / 3,55 : 1 | Nicht-Text 3 |
|
||||
| Warnung, Fehler, Erfolg auf ihrer Fläche | 7,36 / 7,69 / 6,86 : 1 | Text 4,5 |
|
||||
| Deaktiviert `#6b7682` auf `#eceeec` | 3,97 : 1 | deaktivierte Bedienelemente sind ausgenommen |
|
||||
| Text auf heller Bildüberlagerung (ungünstigster Bildpunkt schwarz) | 10,74 : 1 | Text 4,5 |
|
||||
| Text auf dunkler Bildüberlagerung (ungünstigster Bildpunkt weiß) | 7,06 : 1 | Text 4,5 |
|
||||
|
||||
Die Werte sind gerechnet; eine Messung mit Prüfwerkzeug an der gerenderten Seite steht vor der Farbfreigabe aus (Website-Zielkonzept §5.3).
|
||||
|
||||
## 5. Typografie, Abstände, Maße
|
||||
|
||||
| Bereich | Wert |
|
||||
|---|---|
|
||||
| Auszeichnung (H1–H3, Wortmarke) | Nunito 700/800, vorläufig |
|
||||
| Lesen und Bedienen | Source Sans 3 400/600 (bereits bisher verwendet) |
|
||||
| Skala | Fließtext 17 → 18 px, Zeilenhöhe 1,6; H3 20 → 22; H2 26 → 34; H1 34 → 52; Lesebreite 70 Zeichen |
|
||||
| Abstände | Grundmaß 4 px: 4, 8, 12, 16, 24, 32, 48, 64, 96 px |
|
||||
| Rundungen | 8 (klein), 14 (Karte), 22 (Fläche), Pille |
|
||||
| Container | schmal 45 rem, Standard 75 rem, breit 90 rem; Randabstand 16–32 px |
|
||||
| Trefferfläche | mindestens 44 × 44 px |
|
||||
| Fokus | 3 px Rahmen in `--color-focus`, 3 px Abstand, auf jeder Fläche sichtbar |
|
||||
|
||||
Source Serif 4 wird nicht mehr ausgeliefert; die interne Redaktionsvorschau der Bibliothek fällt dort auf Georgia zurück.
|
||||
|
||||
## 6. Grundkomponenten
|
||||
|
||||
| Komponente | Klassen | Hinweis |
|
||||
|---|---|---|
|
||||
| Container | `.ui-container`, `.ui-container-wide` | Standard- bzw. breite Inhaltsbreite mit Randabstand |
|
||||
| Schaltfläche | `.button` / `.ui-button`, `-secondary`, `-quiet`, `[disabled]` | Haupt-, Neben-, Textaktion; Farben aus der jeweiligen Fläche |
|
||||
| Formular | `.form`, `.ui-field`, `.ui-input`, `.ui-field-error`, `.check` | sichtbare Beschriftung, Fehlerzustand über `aria-invalid` |
|
||||
| Statusanzeige | `.status`, `.errors`, `.ui-notice-{success,warning,danger,info}` | Farbe, Randlinie und Text, nie Farbe allein |
|
||||
| Karte | `.ui-card`, `.empty` | helle Fläche mit Linie |
|
||||
| Dialog | `.ui-dialog` (natives `dialog`) | Hintergrund abgedunkelt |
|
||||
| Kennzeile | `.ui-flag` | gelbe Linie vor Großbuchstaben-Kennzeile |
|
||||
| Themensignatur | `.ui-theme-signature[data-theme=1…5]`, `.ui-theme-signature-mark` | siehe Abschnitt 8 |
|
||||
|
||||
Die bestehenden Klassen des Mitgliederbereichs (`body.member …`) bleiben; ihre Variablen (`--text`, `--aktion`, `--fokus`, …) zeigen jetzt auf die gemeinsamen Tokens. Werte sind gleich geblieben, nur die Auszeichnungsschrift wechselt von Source Serif 4 zu Nunito.
|
||||
|
||||
## 7. Wortmarke und Markenassets
|
||||
|
||||
| Asset | Status | Verwendung |
|
||||
|---|---|---|
|
||||
| Wortmarke als Weblogo (SVG/PNG) | **fehlt**; Logo-Varianten in den Filmmotiven weichen voneinander ab (Kit-README, Leitlinie 5) | vorläufiger Schriftzug „Lara & Felix / Stark im Alltag“ in Nunito, gekennzeichnet `data-brand-status="vorlaeufig"`, ohne Nachbildung (keine Drehung, kein Unterstrich-Schwung) |
|
||||
| Titel-, Denkpause-, Outro-Motiv (`01_originale`) | Original vorhanden, **öffentliche Nutzung nicht freigegeben** (Quellenmanifest) | nicht verwendet; nicht in `public/` oder den Medienbestand kopiert |
|
||||
| Figurenreferenzen Lara, Felix, Oma | nur interne Referenz | nicht verwendet |
|
||||
| SVG-Entwürfe (`03_svg_entwuerfe`: Monogramm, Strahlen, Unterstreichung, Denkblase, Hand) | neue, nicht freigegebene Vorschläge | nicht verwendet |
|
||||
| KI-Konzeptgrafiken (`04_visuelle_entwuerfe`) | erfundene Inhalte, nicht freigegeben | nicht verwendet |
|
||||
| Themensymbole der fünf Bereiche | nicht entworfen | nicht verwendet; Platz vorbereitet |
|
||||
|
||||
Austausch nach Freigabe: Logodatei unter `public/` ablegen und ausschließlich in `components/site/brand.blade.php` einsetzen; Kopfzeile, Fußbereich und Mitgliederbereich verwenden diese eine Komponente.
|
||||
|
||||
## 8. Themensignaturen (vorbereitet)
|
||||
|
||||
`.ui-theme-signature` trägt Nummer (1–5) und Name des Themenbereichs; `--color-theme-1` bis `--color-theme-5` sind Platzhalter, die bis zur Freigabe alle auf die neutrale helle Fläche zeigen. Unterscheidung erfolgt damit ohne Farbe (Design-Prinzipien §3). Nach Freigabe werden Tönungen in `tokens.css` und Symbole als SVG je Säule ergänzt; Mehrfachzuordnung ist als Reihe von Marken vorgesehen.
|
||||
|
||||
## 9. Website-Gerüst
|
||||
|
||||
- **Kopfzeile** (klebend, 64/72 px): Wortmarke, CMS-Hauptnavigation, Kontozugang „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet), vorbereiteter Warenkorbzugang (`config/cms.php` → `cart.enabled`, Vorgabe aus: es wird nichts ausgegeben).
|
||||
- **Hauptnavigation**: aus `navigation_items` (`header`), aktiver Eintrag mit gelber Linie und `aria-current`, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit `aria-expanded`, Escape schließt, Klick außerhalb schließt). Ab 75 rem in der Zeile, darunter Menü-Schaltfläche.
|
||||
- **Mobile Navigation**: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche unter der Kopfzeile mit 48 px hohen Einträgen, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator bleibt im Menü, Escape schließt und gibt den Fokus an die Schaltfläche zurück. Keine feste untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation als umbrechende Liste sichtbar.
|
||||
- **Fußbereich** (dunkle Fläche): Wortmarke, „Themenbereiche“ aus den veröffentlichten Säulen, Gruppen „Service“, „Kontakt“, „Rechtliches“ aus der CMS-Navigation. Leere Gruppen entfallen; es werden keine Kontakt- oder Rechtstexte erfunden.
|
||||
|
||||
## 10. Schnittstellen zum Mitgliederbereich
|
||||
|
||||
Gemeinsam: Tokens, Schriften, Fokusregeln, Wortmarke (`<x-site.brand>` mit Zusatz „Mitgliederbereich“), Schaltflächen-, Formular- und Statusklassen. Nicht verändert: Layout, Seitenleiste, Bibliotheksnavigation, die bestehende untere Leiste `member-dock` (fünf Einträge, bereits vor dieser Iteration vorhanden), Berechtigungs- und Suchlogik, Kursplayer. Eine Überarbeitung der mobilen Mitgliedernavigation (höchstens vier bis fünf Funktionen) braucht eine eigene UX-Abnahme; die Tokens und Komponenten sind dafür vorbereitet.
|
||||
|
||||
## 11. Veredelung mit Design-Skills (Empfehlung)
|
||||
|
||||
1. Erst Freigaben einholen (Wortmarke als SVG, Farbwerte, Schriften, Bildmotive mit Rechten); dann nur `tokens.css` und `brand.blade.php` anpassen.
|
||||
2. Widgets einzeln veredeln: nur `resources/views/widgets/<typ>.blade.php` und `widgets.css`, Klassen und Daten bleiben stabil; Container-Abfragen beibehalten.
|
||||
3. Themensignaturen als Symbolfamilie entwerfen (Design-Prinzipien §3, Zielkonzept §7.4), dann `--color-theme-*` und Symbole je Säule ergänzen.
|
||||
4. Hintergrundbilder: textfreie Zuschnitte der Originalmotive mit Fokuspunkt erzeugen (Hintergrundverarbeitung, `srcset`), sobald freigegeben.
|
||||
5. Sichtprüfung 390/768/1440 px und Kontrastmessung mit Prüfwerkzeug nach jeder Änderung an Markenwerten.
|
||||
Reference in new issue
Block a user