Dokumentiere Textwahl und Bild aus dem Film der Medienkarte.
CI Feature / test (push) Successful in 1m39s
Deploy Test / test (push) Successful in 1m41s
Deploy Test / deploy (push) Successful in 25s

Medienzugriff, Registry §13 und ADR-39: Text der Karte, die ausführliche Beschreibung als ausdrücklich gewählter
öffentlicher Text, Filmbild einmal als Bild-Medium (FilmStill, film_still_sources) und die Grenzen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Sonnet 5.5 committed 2026-11-21 19:11:01 +01:00
1 parent 05bd36509c
commit 886715af96
3 files changed
+43 -3

No files matched your search

@@ -518,6 +518,7 @@ ## ADR-39 – Premium-Karten mit Fachbezug
- 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).
**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.
**Nachbesserung 2 (21.11.2026, Betreiberwunsch).** Die Medienkarte wählt ihren Text je Karte (Automatisch, Teaser, Kurzbeschreibung, Ausführliche Beschreibung; `settings.text_source`). Die ausführliche Beschreibung ist damit auf ausdrückliche Wahl öffentlich (vorher nie). Ein Film liefert über `FilmStill` ein Einzelbild für die Karte: das Vorschaubild des Films oder eine gewählte Stelle, einmal gezogen (bis 1600 px) und als gewöhnliches Bild-Medium abgelegt, mit eigener Website-Freigabe; der Film bleibt geschützt. Additive Tabelle `film_still_sources`.
**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.
+5 -1
View File
@@ -312,6 +312,10 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**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).
**Text der Medienkarte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`); nur an der Medienkarte. `auto` entspricht dem bisherigen Verhalten (Kurzbeschreibung, sonst Teaser). Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Die ausführliche Beschreibung erscheint nur auf diese Wahl (öffentlich, sofern die Karte öffentlich ist). Der eigene Text der Karte (`data.summary`) hat Vorrang.
**Bild aus dem Film (Medienkarte).** Reiter „Medien“, nur bei einem Film: „Vorschaubild des Films übernehmen“ oder eine Stelle wählen. `FilmStill` legt das Einzelbild (bis 1600 px) einmal als Bild-Medium ab; `refs.image` trägt dessen Kennung. Details und Grenzen: `medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“.
**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. 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.
@@ -320,7 +324,7 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**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.
2. *Öffentliche Filmvorschau (Trailer, Ausschnitt; ein Einzelbild aus dem Film ist seit 21.11.2026 über FilmStill möglich):* 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.
@@ -27,7 +27,7 @@ ## Anzeige auf der Website
Solange öffentliche Profile (ADR-29) fehlen, ist das die Übergangsregel. Ein Medium hat keine eigene öffentliche Seite. Die Karte verweist dann auf die Programmseite.
Gelesen werden Anzeigename (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart und Ausgabeart. Nicht gelesen und nicht ausgegeben werden Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtext und jede Datei.
Gelesen werden Anzeigename (sonst Arbeitstitel), Inhaltsart und Ausgabeart sowie genau einer der Texte Teaser, Kurzbeschreibung oder ausführliche Beschreibung (siehe „Text der Medien- und Materialkarte“). Nicht gelesen und nicht ausgegeben werden Einsatzhinweis, Lizenzvermerk, Lehrtext und jede Datei.
Das Vorschaubild der Bibliothek erscheint nur in der Redaktionsvorschau, über die Route `editorial.card`, und nur für angemeldete Redaktion. Auf einer öffentlichen Seite hat dieses Bild keine Adresse.
@@ -137,4 +137,39 @@ ## Präsentationszuordnungen (19.11.2026, ADR-41)
Öffentliche Seiten lesen ein Bild nur über `WebsiteImage` und damit über `WebsiteMedia`. Ein freigegebener Film oder ein Hörstück wird über `website.media` ausgeliefert. Geschützte Originaldateien und Vorschaubilder der Bibliothek bleiben auf diesem Weg geschlossen. Wird die Freigabe zurückgenommen, endet die öffentliche Ausgabe; Überschriften und Texte bleiben. Ein Widget ohne verbleibenden Inhalt entfällt.
Die ausführliche Beschreibung, Einsatzhinweise, Lizenzvermerke und Lehrtexte bleiben außerhalb der öffentlichen Karte. `PublicMaterialReader` und `PublicCatalogReader` lesen dafür die Klasse-A-Angaben (`EditorialProfileReader`) und keine Datei.
Einsatzhinweise, Lizenzvermerke und Lehrtexte bleiben außerhalb der öffentlichen Karte. Die ausführliche Beschreibung erscheint nur, wenn die Redaktion sie für diese Karte ausdrücklich wählt (siehe unten). `PublicMaterialReader` und `PublicCatalogReader` lesen dafür die Klasse-A-Angaben (`EditorialProfileReader`) und keine Datei.
## Text der Medien- und Materialkarte, Bild aus dem Film (21.11.2026)
### Text
Die Redaktion wählt je Karte in der Darstellung „Text der Karte“:
| Wahl | Text |
|---|---|
| Automatisch (Vorgabe) | Kurzbeschreibung, sonst Teaser (wie bisher) |
| Teaser | `teaser` |
| Kurzbeschreibung | `summary` |
| Ausführliche Beschreibung | `description` |
- Jede Wahl liest dieselbe Quelle wie die übrige Karte: das Medium, mit einer Abweichung für die Mitgliederbibliothek (`EditorialProfileReader`, Zielgruppe `bibliothek`), wenn es sie gibt. Die Zielgruppe `cms` („CMS-Teaser“) wird weiterhin nirgends gelesen; ein Wechsel würde bestehende Karten ändern und ist eine offene Frage.
- Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Ist der gewählte Text nicht gepflegt, bleibt die Karte ohne Text; die Redaktionsvorschau nennt, wo er zu pflegen ist. Öffentlich erscheint nie ein Hinweis.
- Der eigene Text der Karte (`data.summary`, „Text nur für diese Karte“) hat Vorrang vor der Wahl.
- **Neu öffentlich auf ausdrückliche Wahl:** die ausführliche Beschreibung, die bisher Bibliothekstext war. Der Dialog sagt das („erscheint öffentlich“). Einsatzhinweis und Lizenzvermerk sind nicht wählbar. Öffentlich ist die Karte weiterhin nur, wenn das Medium zu einem öffentlich gezeigten Programm gehört.
- Die Wahl gibt es nur an der Medien- und Materialkarte; Themen- und Programmkarte lesen weiter ihren Text.
### Bild aus dem Film
Das Vorschaubild eines Films (Medienmanager) und jede Filmstelle sind geschützt und erscheinen öffentlich nie. Für die Karte gibt es einen ausdrücklichen Weg, daraus ein Website-Bild zu machen. Im Reiter „Medien“ der Medienkarte, bei einem Film:
1. „Vorschaubild des Films übernehmen“ oder
2. eine Zeitposition wählen, „Anzeigen“, „Dieses Bild übernehmen“.
`FilmStill` zieht das Einzelbild **einmal** und legt es über `WebsiteIntake` als gewöhnliches Bild-Medium (`output_class = bild`) im Medienmanager ab. Die Warteschlange leitet es ab und gibt genau diese Ableitung frei, wie bei jedem Upload aus dem CMS. Die Karte speichert die Kennung dieses Bildes in `refs.image`.
- **Kein Neuziehen:** Seitenaufrufe lesen nur die gespeicherte Datei; `ffmpeg` läuft nur beim Übernehmen und in der Vorschau des Dialogs (Route `editorial.frame`, nur angemeldete Redaktion). Test: `FilmStillTest` zählt die Extraktionen.
- **Einmal je Stelle:** `film_still_sources` (additive Tabelle) ordnet Film, Quelle (`frame:{Fassung}@{Sekunde}` oder `file:{SHA-256}`) und Bild zu. Dieselbe Stelle, auch über „Vorschaubild übernehmen“ eines Filmbilds aus derselben Stelle, ergibt dasselbe Medium. Ein archiviertes Bild wird nicht wiederverwendet.
- **Auflösung:** Aus der Mediendatei (`inhalte/`) bis 1600 px Breite, nie über die Breite der Quelle hinaus vergrößert; ohne Mediendatei aus der kleinen Stufe (480 p). Die Vorschau im Dialog und das Vorschaubild des Medienmanagers bleiben bei 640 px.
- **Rechte:** Es wird nie der Film abgelegt, nur ein Einzelbild; keine Fassung, keine Berechtigung, kein Lizenzartikel. Ausgeschlossen sind Traineranleitungen, archivierte Filme und Filme ohne bereitgestellte Fassung. Die Handlung ist ausdrücklich (Redakteur, wie beim Upload); die Freigabe des entstandenen Bildes lässt sich im Medienmanager zurücknehmen (Wirkung: das Bild entfällt auf allen Seiten).
- **Das Bild ist ein eigenes Medium** mit Titel „Standbild: {Film} (Fassung n, x s)“, Alternativtext „Szene aus dem Film …“ und der Quellenzeile des Films. Es folgt späteren Änderungen des Film-Vorschaubilds nicht; wer es als Titelbild des Films verwenden will, ordnet es im Medienmanager als Präsentationsmedium zu (dann nutzen alle Karten des Films es automatisch).
- **Nicht umgesetzt:** eine öffentliche Filmvorschau (Trailer, Ausschnitt) und die Laufzeit. Beides bleibt Erweiterungsbedarf (Registry §13).