Mache die Premium-Karten mit vorhandenen Fachobjekten nutzbar.

- Themenkarte: alle Säulen wählbar; nicht veröffentlichte nur in der Redaktionsvorschau.
- Medienkarte: Kurzbeschreibung, Film (Filmtafel, Hinweis auf den geschützten Film) und Material
  (Materialsymbol) getrennt; Filmstandbild der Bibliothek nur in der Redaktionsvorschau, markiert;
  Entwürfe wählbar, gesperrte nicht; Traineranleitungen nie öffentlich.
- Programm-/Modulkarte: Lernziel als Text, Dauer und Modulzahl; Programme/Module ohne Anzeigefreigabe
  für die Vorschau wählbar; Module weiterhin ohne Link.
- Fehlende Inhalte nur in der Vorschau als eingeklappte Redaktionshinweise.
- Tests bewusst angepasst: Medien zeigen jetzt die Kurzbeschreibung (Betreibervorgabe), unveröffentlichte
  Themen und Programme ohne Freigabe sind wählbar.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-18 16:20:40 +01:00
1 parent bc1f84ac89
commit a08067c078
13 files changed
+611 -151

No files matched your search

@@ -512,6 +512,7 @@ ## ADR-39 – Premium-Karten mit Fachbezug
- 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`). Von Medien wird keine Kurzbeschreibung gezeigt.
- 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).
**Offene Entscheidung (zuerst).** Welche Felder eines Inhaltselements öffentlich auf einer Karte erscheinen dürfen. Heute nennt nur die Programmseite Bestandteile, und zwar mit Titel. Die Medienkarte zeigt deshalb öffentlich Titel (Anzeigetitel, sonst Arbeitstitel), Inhaltsart, Ausgabeart und Programmzugehörigkeit, aber keine Kurzbeschreibung. Zu prüfen ist besonders bei Traineranleitungen, ob schon der Titel öffentlich sein darf.
**Nachbesserung (18.11.2026, nach Betreiberprüfung).** Themenkarten bieten alle Säulen an (nicht veröffentlichte nur für die Redaktionsvorschau). Medienkarten zeigen die Kurzbeschreibung des Mediums (auf ausdrücklichen Wunsch), unterscheiden Film (Filmtafel) und Material (Materialsymbol) und zeigen das geschützte Vorschaubild der Bibliothek nur in der Redaktionsvorschau. Traineranleitungen erscheinen nie öffentlich. Programm-/Modulkarten nutzen Lernziel und Dauer und lassen Programme/Module ohne Anzeigefreigabe für die Vorschau zu. Fehlende Inhalte erscheinen nur in der Vorschau als Hinweise.
**Offene Entscheidungen.** (1) Freigabe von Vorschaubildern für die Website und öffentliche Filmvorschauen (minimaler Erweiterungsbedarf in `cms-widget-registry.md` §13). (2) Ob bei Traineranleitungen schon der Titel auf der Programmseite öffentlich sein soll (Programmseite, nicht Karte).
**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.
+26 -17
View File
@@ -125,10 +125,11 @@ ## 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“ |
| Thema (Säule), veröffentlicht mit öffentlicher Adresse | ja (Themenkarte) | ja, mit Link auf `/themen/{slug}` | ja |
| Thema, nicht veröffentlicht | ja (Themenkarte) | nein | ja, mit Hinweis „Nur Redaktionsvorschau“ |
| Medium/Material, nicht archiviert, mit bereitgestellter Fassung, Bestandteil der gezeigten Fassung eines öffentlichen Programms, keine Traineranleitung | ja (Medienkarte) | ja, mit Link auf die Programmseite (dort ist es bereits öffentlich genannt) | ja |
| Medium/Material ohne öffentliches Programm, nur mit Entwurfsfassung oder Traineranleitung | ja (nicht gesperrt) | **nein** | ja, mit Hinweis |
| Programm oder Modul mit bereitgestellter Fassung, ohne Anzeigefreigabe | ja (nur Programm-/Modulkarte, nicht Katalogkarten) | nein | ja, mit Hinweis |
| 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 |
@@ -287,29 +288,37 @@ ## 12. Responsive Widget-Regeln und gemeinsamer Layoutvertrag (ADR-38)
## 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.
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. Stand nach der fachlichen Nachbesserung vom 18.11.2026.
| Art | Fachobjekt | Gelesen aus | Art/Label | Zusatzangaben | Aktion (Vorgabe) |
| Art | Fachobjekt (Lesesicht) | Wählbar | Gelesen | Bildbereich ohne Kartenbild | Aktion |
|---|---|---|---|---|---|
| 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); **keine Kurzbeschreibung** (heute nirgends öffentlich, offene Entscheidung) | 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 |
| Themenkarte `topic_card` | Säule (`Pillar`) | alle Säulen | Name, Text für die Website, Zahl veröffentlichter Seiten zum Thema | keiner | „Thema entdecken“ → `/themen/{slug}`, nur veröffentlicht |
| Medien- und Materialkarte `media_card` | Inhaltselement (`PublicMaterialReader`) | nicht archiviert, mindestens eine nicht gesperrte Fassung | Anzeigetitel (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart, Ausgabeart, Programmzugehörigkeit; Film: Hinweis auf den geschützten vollständigen Film | Film: Filmtafel (Navy, Filmstreifen, kein Abspielsymbol); Material: Materialsymbol (Creme); Redaktionsvorschau: Vorschaubild der Bibliothek, markiert | „Im Programm ansehen“ → Programmseite, nur öffentlich |
| Programm- oder Modulkarte `program_card` | Komposition (`PublicCatalogReader::subject`) | Programm/Modul, nicht archiviert, bereitgestellte Fassung | Anzeigetitel, Kurzbeschreibung (sonst Lernziel), Art, Zahl der Module, Dauer | Navy-Tafel mit Art; Redaktionsvorschau: Vorschaubild der Bibliothek, markiert | „Programm ansehen“ → `/programme/{id}`, nur Programme mit Anzeigefreigabe; Module ohne Link |
**Darstellung der Medienkarte nach Ausgabeart:** Film → Variante `lf-pc--media` (grüne Aktion, Metadatenband, Filmtafel); Dokument, Text, Hörstück, Bild → `lf-pc--material` (Materialsymbol). Die Unterscheidung folgt `output_class`, nicht einer redaktionellen Einstellung.
**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 (nicht bei Medien), Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px), damit breite gestapelte Karten nicht übermäßig hoch werden.
**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. Bildhöhe höchstens min(70vh, 640 px).
**Hinweis für die Redaktion.** Eine Karte, die öffentlich nicht erscheint (Modul, Medium ohne öffentliches Programm), lässt ihren Platz entfallen; die übrigen Plätze des Abschnitts teilen sich die Breite. Solche Karten daher in einen eigenen Abschnitt setzen oder mit einem Platz kombinieren, der allein gut aussieht.
**Redaktionsvorschau.** Nicht öffentliche Karten tragen die Marke „Nur Redaktionsvorschau“. Fehlende Inhalte (Kurzbeschreibung, Text für die Website, Anzeigetitel, Dauer, Laufzeit, Kartenbild) stehen eingeklappt unter „Hinweise für die Redaktion“, mit dem Ort, an dem sie gepflegt werden. Öffentlich erscheinen weder Marke noch Hinweise noch Bibliotheksbilder.
**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.
**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. Eine öffentlich nicht sichtbare Karte lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Solche Karten daher in einen eigenen Abschnitt setzen oder mit einem Platz kombinieren, der allein gut aussieht.
**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.
**Sicherheit.** Vorschaubilder der Bibliothek (Filmstandbilder, Modulvorschau) nur über `editorial.card` (Redaktionsanmeldung) und nur in der Redaktionsvorschau; öffentlich nie. Keine Adressen unter `/bereich/` oder `/redaktion/` auf öffentlichen Seiten, kein Abspielen, kein Download, kein Preis, keine Kaufaktion. Nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtexte, Traineranleitungen. Eine Karte begründet keine Berechtigung (Tests `CmsPremiumCardsTest`).
**Erweiterungsbedarf für öffentliche Vorschaubilder und Filmvorschauen (nicht umgesetzt, minimal):**
1. *Vorschaubild für die Website freigeben:* je `ContentElement` und `Composition` ein Freigabevermerk (`thumbnail_public_at`, `thumbnail_public_by`, Bezug auf `thumbnail_source`), gesetzt nur durch eine ausdrückliche Aktion „Vorschaubild für die Website freigeben“ in der Medien- bzw. Modulbearbeitung. Die Hintergrundverarbeitung kopiert das freigegebene Standbild nach `media_public` (eigener Pfad, zum Beispiel `katalog/`), Zurücknehmen löscht die Kopie. Die Karte nimmt dieses Bild, wenn kein Kartenbild gewählt ist. Der Web-Prozess schreibt weiterhin nicht in den Medienbestand.
2. *Öffentliche Filmvorschau (Trailer, Ausschnitt):* eine eigene Ausgabe (`MediaRendition` mit Rolle `preview`) und eine eigene Freigabe je Fassung, getrennt vom lizenzpflichtigen Film; ausgeliefert ohne Signatur nur nach dieser Freigabe. Bis dahin hat die Karte keine Abspielfunktion.
3. *Laufzeit:* ein Feld in den Mediendaten der Fassung (zum Beispiel `metadata.duration_seconds`, beim Transkodieren mit ffprobe ermittelt).
Alle drei Erweiterungen hängen mit ADR-29 (öffentliche Profile) zusammen und brauchen eine Entscheidung von Lars.
**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).
- Umschaltung bei 520 px über den Platz-Container `slot` statt eines eigenen Kartencontainers.
- Ü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.
- Gelber Akzent der Tafel als `components/brand/underline` (SVG); Schriftgewichte 600 statt 750 (vorhandene Schnitte).
- Zusätzlich Filmtafel und Materialsymbol für Medien ohne freigegebenes Bild; Tafel neben dem Text mittig statt gestreckt.
**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.
**Grenzen.** Module haben keine öffentliche Seite (ADR-29) und erscheinen nur in der Vorschau. Medien öffentlich nur über ein öffentliches Programm. Keine öffentlichen Vorschaubilder ohne die oben beschriebene Freigabe. Eine **kaufbare Angebotskarte** gibt es nicht; sie braucht ein eigenes Fachobjekt „Angebot“ mit Umfang, Zweck und Lizenzbedingungen und wird gesondert konzipiert.