Dokumentiere die Premium-Karten v1.7 (ADR-39, Registry, Designsystem).
CI Feature / test (push) Successful in 39s

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-18 13:33:35 +01:00
1 parent 127ea86817
commit 39ab25d8c6
3 files changed
+59

No files matched your search

@@ -59,6 +59,7 @@ ## Übersicht der Architekturentscheidungen
| ADR-36 | Designsystem | Designprinzip fest; Tokens offen | Gemeinsame Design-Tokens für Website und Mitgliederbereich |
| ADR-37 | n8n-Anbindung | Option / nicht beschlossen | n8n allenfalls für externe Kanäle, ohne direkten Datenbankzugang |
| ADR-38 | Layoutvertrag der Widgets | Umgesetzt auf Test (18.11.2026); UX-Abnahme offen | Zulässige Rasterbreiten, Höhen und Verhalten bei wenig Platz je Widget-Art in der bestehenden Registry; Darstellung nach realer Containerbreite |
| ADR-39 | Premium-Karten mit Fachbezug | Umgesetzt auf Test (18.11.2026); gestalterische Freigabe v1.7 offen | Eine Karte je Platz im Abschnittsraster; Inhalte und Linkziel aus Thema, Medium oder Programm/Modul; keine Preise, keine Freigabe geschützter Medien |
---
@@ -499,3 +500,17 @@ ## ADR-38 – Gemeinsamer Layoutvertrag für Widget-Arten
**Alternativen.** Je Widget eigene Breitenlogik im Editor; feste Pixelhöhen; Höhe als Abschnittseinstellung (verworfen: doppelte, widersprüchliche Einstellmöglichkeit neben Abstand und Raster).
**Folgen und offene Prüfung.** Premium-Einstieg (`hero` Version 2) und Bild und Text (`image_text` Version 3) heben ältere Instanzen beim Lesen an; gespeicherte Revisionen bleiben unverändert. Ein Einstieg in einem Platz mit 2 Einheiten ist nicht mehr zulässig (vorher Mindestbreite 2; auf der Testinstanz kein Bestand betroffen). Bewusste Abweichungen vom Kit: Bildfokus als `data.focus_x/focus_y` (Einstellungen tragen nur Aufzählungswerte), Überschriftenebene „Automatisch/H2/H3“ statt freier H1 (genau eine H1 je Seite), Linkziele über die bestehende `SafeUrl`-Regel. Praktische Redaktionsabnahme (Bedienung, Bildzuschnitte mit freigegebenen Motiven) steht aus.
**Quelle.** Brand-UI-Kit v1.6 (`docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`, `docs/layout-profiles.json`); `docs/architektur/cms-widget-registry.md` §§2, 4, 12; ADR-30, ADR-36.
## ADR-39 – Premium-Karten mit Fachbezug
**Status am 18.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/premium-karten`). **Gestalterische Freigabe des Kits v1.7 offen** (`13_premium_karten_v1.7_entwurf/docs/FREIGABE.md`: alle drei Varianten „zur visuellen Freigabe“). Ergänzt ADR-30 und ADR-38.
**Kontext.** Das Brand-UI-Kit v1.7 liefert drei Kartenvarianten (redaktionelle Themenkarte, Medien- und Materialkarte, Modul- und Programmkarte) als reine Darstellungskomponente mit eigenem Beispielraster. Im CMS sollen Redakteure diese Karten in regulären Abschnitten einsetzen, mit bestehenden Fachobjekten verbinden und gestalten, ohne Titel, Medienangaben, Programme oder Module zu kopieren und ohne geschützte Inhalte freizugeben.
**Entscheidung.**
- Drei Widget-Arten in der bestehenden Registry (`topic_card`, `media_card`, `program_card`) auf einer gemeinsamen Basis (`PremiumCardWidget`) mit einer Ansicht (`widgets/premium_card.blade.php`). Eine Karte je Widget, ein Widget je Platz; Spalten und Abstände bestimmt das Abschnittsraster. Das Beispielraster des Kits wird nicht übernommen.
- `refs` speichert genau eine Kennung (Thema `pillar`, Inhaltselement `element`, Komposition `composition`) und optional ein Bild aus dem öffentlichen Website-Bereich. Titel, Kurzbeschreibung, Art, Zusatzangaben und Linkziel werden bei jeder Darstellung aus den Fachdaten gelesen. Redaktionell sind nur Bild, Alternativtext, Bildausschnitt, Beschriftung der Aktion und ein kurzer Hinweis.
- Linkziel nur aus dem Fachobjekt: Themenseite eines veröffentlichten Themas, Programmseite eines öffentlichen Programms. Kein freies Linkziel, kein Download, kein Abspielen, kein Preis, keine Kaufaktion.
- Sichtbarkeit (Übergangsregel bis ADR-29): Themen nur veröffentlicht; Programme nach `PublicCatalogReader`; Module nur in der Redaktionsvorschau; Medien und Materialien öffentlich nur, wenn sie zur gezeigten Fassung eines öffentlichen Programms gehören (dort sind sie heute schon öffentlich genannt), sonst nur in der Redaktionsvorschau (`PublicMaterialReader`).
- Gleiche Höhe je Zeile über die gemeinsame Höhe `fill` (ADR-38). Für gemischte Raster sind die Abschnittsraster 1 + 1 + 2 und 2 + 1 + 1 ergänzt (additiv, bestehende Kennungen unverändert).
**Alternativen.** Ein Widget mit mehreren Karten und eigenem Spannweitenraster (verworfen: zweites Kartenraster neben dem Abschnittsraster); eine Widget-Art mit Variante je Fachobjekt (verworfen: Verweisschema hinge von der Variante ab); redaktionell gepflegte Kartentexte (verworfen: Kopien von Fachdaten); Vorschaubilder der Bibliothek als Kartenbild (verworfen: geschützt, Paket 6).
**Folgen und offene Prüfung.** Keine Migration; bestehende Seiten und Widgets unverändert (gemessen). Mit ADR-29 ersetzen öffentliche Profile die Übergangsregeln in `PublicCatalogReader` und `PublicMaterialReader`; die gespeicherten Karten ändern sich dadurch nicht. Offen: gestalterische Freigabe v1.7, freigegebene Motive statt Platzhaltern, eine kaufbare Angebotskarte (eigenes Fachobjekt „Angebot“ mit Umfang, Zweck und Lizenzbedingungen, nicht Teil dieser Karten).
**Quelle.** Brand-UI-Kit v1.7 (`docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf`, README, `docs/design-config.json`); `docs/architektur/cms-widget-registry.md` §§4, 6, 11, 13; ADR-29, ADR-30, ADR-38.
+36
View File
@@ -76,6 +76,9 @@ ## 4. Registrierte Widget-Arten
| `image_text` | Bild und Text, Premium nach Kit v1.6 | 3 | `image_left`, `image_right` (Bildseite) | 1–4 | `compact`, `normal` (Vorgabe), `spacious` | `refs.image` |
| `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (Liste), `featured` (erste Karte hervorgehoben) | 1–4 | – | Bild je Karte in `data.items[].image` |
| `catalog_cards` | Programm- und Modulkarten | 1 | `standard`, `compact` | 1–4 | – | `refs.items[] = {type: composition, id}` |
| `topic_card` | Themenkarte, Premium-Karte nach Kit v1.7 | 1 | `adaptive`, `stacked` | 1–4 | `auto` (Vorgabe), `fill` | `refs.pillar`, `refs.image` |
| `media_card` | Medien- und Materialkarte, Kit v1.7 | 1 | `adaptive`, `stacked` | 1–4 | `auto` (Vorgabe), `fill` | `refs.element`, `refs.image` |
| `program_card` | Programm- oder Modulkarte, Kit v1.7 | 1 | `adaptive`, `stacked` | 1–4 | `auto` (Vorgabe), `fill` | `refs.composition`, `refs.image` |
| `call_to_action` | Handlungsaufruf | 1 | `standard` | 1–4 | `auto` (Vorgabe), `fill` (Abschnittshöhe füllen) | – |
| `faq` | FAQ | 1 | `standard` | 2–4 | – | – |
@@ -122,6 +125,10 @@ ## 6. Öffentliche Freigabe von Programmen und Modulen (Übergangsregel)
| Objekt | Im Editor wählbar | Öffentlich sichtbar | Redaktionsvorschau |
|---|---|---|---|
| Thema (Säule), veröffentlicht | ja (Themenkarte) | ja, mit Link auf `/themen/{slug}` | ja |
| Thema, nicht veröffentlicht | nein | nein | Hinweis „nicht mehr veröffentlicht“ |
| Medium/Material (Inhaltselement) mit bereitgestellter Fassung, nicht archiviert, Bestandteil der gezeigten Fassung eines öffentlichen Programms | ja (Medienkarte) | ja, mit Link auf die Programmseite (dort ist es bereits öffentlich genannt) | ja |
| Medium/Material ohne öffentliches Programm | ja | **nein** | ja, mit Hinweis „Nur in der Redaktionsvorschau sichtbar“ |
| Programm mit Anzeigefreigabe, nicht archiviert | ja | ja, mit Link auf `/programme/{id}` (dieselbe Regel wie die bestehende Programmliste) | ja |
| Modul mit Anzeigefreigabe, nicht archiviert | ja | **nein** | ja, mit Hinweis „Nur in der Redaktionsvorschau sichtbar“ |
| Fassung ohne Anzeigefreigabe, Entwurf, archiviert, ohne Inhaltsart | nein (Speichern wird abgewiesen) | nein | nein |
@@ -220,6 +227,7 @@ ## 11. Abschnitte und Plätze
| `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 |
| `u1_1_2` / `u2_1_1` | 1 + 1 + 2 / 2 + 1 + 1 | 1 : 1 : 2 / 2 : 1 : 1 | gestapelt | 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).
@@ -269,9 +277,37 @@ ## 12. Responsive Widget-Regeln und gemeinsamer Layoutvertrag (ADR-38)
| Fließtext | 1–4 | – | Zeilenlänge höchstens etwa 70 Zeichen, lange Adressen brechen um |
| Redaktionelle Karten | 1–4 | – | so viele Karten nebeneinander, wie bei 15 rem Kartenbreite passen; hervorgehobene Karte ab 44 rem mit Bild neben dem Text |
| Programm- und Modulkarten | 1–4 | – | ab 17 rem Kartenbreite mehrspaltig; eine einzelne Karte ab 40 rem mit Tafel neben dem Text |
| Premium-Karten (Thema, Medium, Programm) | 1–4 | auto/fill | unter 520 px Platzbreite Bild oder Tafel über dem Text; ab 520 px Bild links (42 %), Text rechts (58 %), außer Variante „Bild immer über dem Text“; nutzbar ab etwa 240 px, empfohlen ab 280 px |
| Handlungsaufruf | 1–4 | auto/fill | unter 20 rem Schaltfläche in voller Breite; Beschriftungen brechen um |
| FAQ | 2–4 | – | Fragen untereinander, Antworten auf Lesebreite |
Gemessene Platzbreiten im Standardabschnitt (82 rem) bei 1440 px Fensterbreite: 1 Einheit etwa 301–319 px, 2 Einheiten 638 px, 3 Einheiten 957 px, 4 Einheiten 1312 px. Bei 1200 px Fensterbreite hat ein Platz mit 3 Einheiten 807 px; der Einstieg zeigt dort den Sicherheitsumbruch.
Ableitung: Bild und Text funktioniert dank gestapelter Darstellung auch in einer Einheit; der Einstieg braucht für seine Komposition mindestens etwa 860 px und ist deshalb nur für 3 oder 4 Einheiten freigegeben. Auf Tablet und Smartphone stapeln die Plätze; dort gelten die Breitenregeln nicht, die Widgets reagieren auf ihre Containerbreite.
## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
Drei Widget-Arten auf der gemeinsamen Basis `App\Domain\Cms\Widgets\Types\PremiumCardWidget`, Ansicht `resources/views/widgets/premium_card.blade.php`, Stylesheet `resources/css/components/lf-premium-card.css` (aus `13_premium_karten_v1.7_entwurf/components/lf-premium-card.css` übernommen und angepasst). Das Kit ist ein **Entwurf zur visuellen Freigabe**; die Freigabe steht aus.
| Art | Fachobjekt | Gelesen aus | Art/Label | Zusatzangaben | Aktion (Vorgabe) |
|---|---|---|---|---|---|
| Themenkarte `topic_card` | Thema (`Pillar`) | Name, öffentlicher Text | „Thema“ | – | „Thema entdecken“ → `/themen/{slug}` |
| Medien- und Materialkarte `media_card` | Inhaltselement (`ContentElement`) über `PublicMaterialReader` | Anzeigetitel (sonst Arbeitstitel), Kurzbeschreibung | Inhaltsart (zum Beispiel „Merkblatt“), sonst Ausgabeart; Ausgabeart als Marke auf dem Bild | Ausgabeart, „Im Programm …“ | „Im Programm ansehen“ → Programmseite |
| Programm- oder Modulkarte `program_card` | Komposition über `PublicCatalogReader` | Anzeigetitel, Kurzbeschreibung | „Programm“ oder „Modul“, immer sichtbar; ohne Bild als Navy-Tafel | Anzahl Module der gezeigten Fassung | „Programm ansehen“ → `/programme/{id}`; Module ohne Aktion |
**Gespeichert** (Hülle wie jedes Widget): `refs.{pillar|element|composition}` (Kennung), `refs.image` (öffentlicher Bereich `cms/`), `data.action_label`, `data.note`, `data.alt` (Pflicht bei Bild), `data.focus_x/focus_y` (0–100, Vorgabe 66/45). Kein Titel, kein Text, kein Linkziel.
**Darstellung** (Reiter „Darstellung“): Variante `adaptive` (ab 520 px Bild neben Text) oder `stacked` (Bild immer oben); Höhe `auto` oder `fill` („An die Zeile angleichen“); `settings.format` (`landscape` 16:9 Vorgabe, `square`, `portrait` 3:4); `settings.fit` (`cover` Vorgabe, `contain` für Dokumente und Poster); `settings.heading_level` (`h3` Vorgabe, `h2`, `h4`); Anzeigen/Ausblenden von Kurzbeschreibung, Art (nicht bei Programm/Modul), Zusatzangaben und Aktion.
**Raster.** Eine Karte je Platz. Gemischte Raster entstehen über die Abschnittsraster, zum Beispiel 1 + 1 + 2 (`u1_1_2`), 2 + 2, 1 + 1 + 1 + 1. Gleiche Höhe: alle Karten einer Zeile auf „An die Zeile angleichen“ stellen; die Aktion steht dann am unteren Rand. Die Einstellung gilt je Karte, nicht je Abschnitt.
**Sicherheit.** Keine Vorschaubilder oder Filmstandbilder der Bibliothek, keine Adressen unter `/bereich/` oder `/redaktion/`, kein Abspielen, kein Download, kein Preis, keine Kaufaktion (Tests `CmsPremiumCardsTest`). Eine Karte begründet keine Berechtigung.
**Abweichungen vom Kit (bewusst):**
- Kein `.lf-pc-grid`/`.lf-pc-section`/Spannweitenklassen: Das Abschnittsraster ist das einzige Raster.
- Umschaltung bei 520 px über den Platz-Container `slot` statt eines eigenen Kartencontainers (eine Karte füllt ihren Platz, die Breite ist dieselbe).
- Überschriftenebene ohne H1 (Karten sind nie Seiteneinstieg).
- Gelber Akzent der Tafel als `components/brand/underline` (SVG, Farbe über Token) statt Bilddatei; Schriftgewichte 600 statt 750 (vorhandene Schnitte von Source Sans 3).
- „Nur Redaktionsvorschau“-Karten mit gestricheltem Rand und Hinweis.
**Grenzen.** Medienkarten öffentlich nur über ein öffentliches Programm; Module nur in der Vorschau (beides bis ADR-29). Zusatzangaben nur, soweit Fachdaten sie hergeben (keine Laufzeit, keine Altersangabe, keine Seitenzahl). Eine **kaufbare Angebotskarte** gibt es nicht; sie braucht ein eigenes Fachobjekt „Angebot“ mit Umfang, Zweck und Lizenzbedingungen und wird gesondert konzipiert.
+8
View File
@@ -164,3 +164,11 @@ ## 13. Premium-Widgets (Brand-UI-Kit v1.6, ADR-38)
| Label `#295b08` auf Creme; `#fff2b0` auf Navy | 7,5 / 13,4 : 1 |
Bildmotive des Kits (`09_hero_widget/assets`, `10_bild_text_widget/assets`) sind für die öffentliche Verwendung nicht freigegeben; sie wurden nur lokal für die Sichtprüfung verwendet.
## 14. Premium-Karten (Brand-UI-Kit v1.7, Entwurf, ADR-39)
- Komponente `lf-pc` mit Varianten `lf-pc--editorial` (ruhige Textaktion mit gelber Unterstreichung), `lf-pc--media` (Metadatenband, grüne Aktion `--lf-green-deep`), `lf-pc--catalog` (Navy-Tafel ohne Foto, Navy-Aktion).
- Eigene helle Fläche (`--lf-white`, Rand `--lf-line`, Radius `--radius-panel`, Schatten `--shadow-raised`), auch in dunklen Abschnitten; Bildradius `--radius-card`.
- Schriften: Titel `--font-display` 800, Text `--font-reading`; keine neuen Schriften.
- Ab 520 px Platzbreite Bild 42 % neben Text 58 %; Bildformat 16:9, 1:1 oder 3:4 bleibt erhalten; kein line-clamp.
- Status: Entwurf zur visuellen Freigabe; auf der Testinstanz nur mit gekennzeichneten Platzhalterbildern.