Files
laraundfelix/docs/architektur/medienzugriff-fuer-komponenten.md
LarsandClaude Sonnet 5.5 08d03d0f56
CI Feature / test (push) Successful in 1m55s
Deploy Test / test (push) Successful in 1m49s
Deploy Test / deploy (push) Successful in 28s
Lege die Website-Datei eines Films über die Warteschlange ab und erlaube sie auch nachträglich
Der Web-Prozess hat derived/ nur lesend; das Anlegen als eigenständiges Präsentationsmedium
schrieb dort selbst und scheiterte auf den Servern (die Tests fakten die Disk). Jetzt prüft
PresentationFile nur und übergibt das Kopieren an StorePresentationFile; ein Fehler steht am
Medium. Die Prüfung läuft vor dem Anlegen, sodass keine leere Hülle zurückbleibt, und nennt
das Format (MOV und M4V sind keine Website-Dateien).

Am Medium gibt es unter Website-Freigabe die Website-Datei zum nachträglichen Hochladen, auch
bei einem Film mit geschützter Fassung (ungeschützter Trailer). Die Fassung bleibt unverändert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 22:23:09 +01:00

20 KiB

Medienzugriff für CMS-Komponenten

Stand: 18.11.2026. Beschreibt den vorhandenen Weg. Keine neue Freigabe, kein zweites Rechtesystem.

Eine CMS-Komponente, die im Medienmanager liegt, ist ein Inhaltselement (ContentElement). Sie entscheidet den Zugriff nicht selbst. Sie ruft eine der drei vorhandenen Stellen auf, je nachdem, was sie tut.

Drei getrennte Stellen

Was die Komponente tut Stelle Was sie nicht tut
Anzeigedaten auf der Website lesen PublicMaterialReader keine Datei, keine Ausgabeadresse
Datei an ein Mitglied ausliefern DecideAccess, erneut bei jedem Abruf keine eigene Erlaubnis, keine Vereinigung von Berechtigungen
Ein öffentliches Bild zeigen, das kein Bestandsmedium ist PublicMedia keinen Pfad aus originals/ oder derived/

Die Pflege im Medienmanager ist eine vierte, nur redaktionelle Tür: Ansehen dürfen Redaktion und Katalogverwaltung, Ändern nur die Redaktion (ContentElementResource). Diese Tür gibt nichts auf der Website und nichts im Mitgliederbereich frei.

Anzeige auf der Website

PublicMaterialReader ist die einzige Lesesicht für ein Medium auf einer öffentlichen Seite. Die Medienkarte nutzt sie bereits.

Öffentlich genannt wird ein Medium nur, wenn alle Punkte zutreffen:

  • es ist nicht archiviert und hat mindestens eine nicht gesperrte Fassung,
  • es hat eine bereitgestellte Fassung,
  • die Inhaltsart ist nicht traineranleitung,
  • es gehört zur gezeigten Fassung eines öffentlich gezeigten Programms.

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), 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.

Auslieferung an Mitglieder

DecideAccess ist die einzige Entscheidung über eine Datei. Sie prüft an genau einer Berechtigung: aktives Konto, passender Artikel-Stand, Fassung im fixierten Inhalt dieses Stands, Fassung nicht gesperrt, Aktion im Rechte-Schnappschuss für die Ausgabeart. Zwei Berechtigungen werden nicht zu einer zusammengefügt.

Die Bibliothek ruft dieselbe Prüfung beim Aufbau der Seite und erneut beim Abruf auf (LibraryController::media, signierte Adresse, Leser gebunden). Eine Signatur, eine Karte oder eine gespeicherte Komponente ersetzen diesen zweiten Aufruf nicht.

Komponenten liefern Dateien nicht selbst aus. Sie bauen keine Adresse auf content.file, content.preview, content.rendition oder /bereich/.

Öffentliche Bilder außerhalb des Bestands

Heute liegen Bilder, die nur zur Website gehören, unter dem Präfix cms/ und laufen über PublicMedia und die Route media.public. Der Controller liefert nur Pfade, die mit cms/ beginnen, von den Platten media_public und cms_incoming.

Dieser Pfad ist kein Zugang zum Medienmanager. Ein Inhaltselement wird darüber nicht ausgeliefert. Umgekehrt wird eine geschützte Bestandsdatei nicht in cms/ gelegt, um sie öffentlich zu machen.

Website-Medien für Hero, Teaser und Slideshow

Hero-Grafiken, Teaserfilme und Slideshows liegen im Medienmanager. Sie werden nicht verkauft. Lizenzartikel, Angebot, Grant und DecideAccess bleiben dafür unbenutzt.

Die Website-Freigabe ist eine eigene Entscheidung am Inhaltselement. Sie hängt nicht daran, dass eine Fassung bereit ist, und nicht daran, dass das Medium in einem öffentlichen Programm liegt. PublicMaterialReader bleibt die Lesesicht der Programmkarte. Widgets für Hero, Bild und Slideshow lesen WebsiteMedia.

Aufruf Klasse Ergebnis
Ein Medium WebsiteMedia::present($elementOderId) WebsitePresentation oder null
Slideshow, Reihenfolge bleibt WebsiteMedia::presentMany([$id, ...]) nur freigegebene Einträge

WebsitePresentation enthält elementId, title, alt, credit, kind (bild oder film) und url. url ist die einzige Dateiadresse, Route website.media. credit ist die öffentliche Quellenzeile. license_note steht dort nicht.

Ein Widget speichert die Kennung des Inhaltselements (refs.element oder bei einer Slideshow refs.elements), nicht einen kopierten Dateipfad. Ist present leer, gibt das Widget nichts aus. Vorhandene Bilder unter cms/ bleiben gültig, bis das jeweilige Widget umgestellt ist.

Neues Bild aus dem CMS

WebsiteIntake::acceptImage($pfad, $titel, $quellenzeile, $alternativtext, $redakteur) legt das Medium an und gibt seine Kennung sofort zurück. $pfad ist die bereits hochgeladene Datei auf cms_incoming und beginnt mit cms/ oder vorschau/. Titel, Quellenzeile und Alternativtext werden am Medium gespeichert. Eine Inhaltsfassung entsteht dabei nicht.

Die Warteschlange liest die Datei, schreibt das JPEG nach vorschau/element-{id}.jpg und gibt danach genau diese Ableitung frei. present bleibt leer, bis das abgeschlossen ist. Eine unlesbare Datei bleibt im Eingang, das Medium trägt thumbnail_error und wird nicht freigegeben. Fehlt die Datei, liegt sie außerhalb des Eingangs oder fehlt der Titel, entsteht kein Medium.

Das CMS ruft dafür nicht DeriveThumbnail und nicht WebsiteRelease auf.

Freigeben und Zurücknehmen eines schon abgelegten Mediums stehen in der Medienansicht, Bereich Beschreibung (WebsiteRelease). Die Warteschlange kopiert die Ableitung nach media_public unter website/{id}/datei.{endung} und setzt website_released_at. Der Web-Prozess schreibt diese Datei nicht. Zurücknehmen löscht nur diese Kopie.

Was freigegeben werden kann:

  • Bild: Vorschaubild unter vorschau/ auf media_derived, Endung jpg, jpeg, png, webp oder gif. Eine Inhaltsfassung ist dafür nicht nötig.
  • Film oder Hörstück ohne Inhaltsfassung: preview_path am Medium, unter teaser/, Film mp4 oder webm, Hörstück mp3, m4a oder ogg.
  • Film mit Inhaltsfassung: an der höchsten bereitgestellten Fassung eine Ausgabe mit Rolle preview und Pfad unter teaser/, Endung mp4 oder webm. Das gilt, wenn am Medium kein preview_path liegt.

Originaldatei, Master-Fassung und Traineranleitungen werden abgelehnt. Eine Quellenzeile (website_credit) und ein Alternativtext (website_alt) gehören zu den Anzeigedaten und erzeugen keine neue Fassung. Die Quellenzeile erscheint nur, solange die Freigabe besteht. Der interne Vermerk bleibt intern.

Ein neues Website-Bild nimmt WebsiteIntake auf und gibt es nach der Ableitung frei. Ein eigenständiges Präsentationsmedium legt PresentationFile ohne Inhaltsfassung an und gibt es nicht von selbst frei. Der Web-Prozess liest derived/ nur; er prüft die Datei (Film: MP4 oder WebM, Hörstück: MP3, M4A oder OGG) und übergibt das Kopieren an die Warteschlange (StorePresentationFile). Dieselbe Website-Datei lässt sich unter „Website-Freigabe“ am Medium auch zu einem Film mit geschützter Inhaltsfassung hinzufügen, zum Beispiel für einen ungeschützten Trailer; die Fassung bleibt dabei unverändert. Öffentliche Profile nach ADR-29 sind damit nicht umgesetzt.

Was eine Komponente einhält

  1. Identität und Anzeigedaten bleiben am Inhaltselement. Die Komponente speichert die Kennung, nicht eine Kopie von Titel, Text oder Datei.
  2. Eine Programmkarte liest das Fachobjekt über PublicMaterialReader und ein Bild über WebsiteImage. Hero, Bild und Text sowie Karten lesen WebsiteMedia. Ist das Medium nicht freigegeben, wird es nicht ausgeliefert. Texte und übrige Inhalte des Widgets bleiben. Ein Widget ohne verbleibenden Inhalt entfällt.
  3. Öffentliche Seiten enthalten keine Adresse unter /redaktion/ oder /bereich/ und kein Bibliotheksbild.
  4. Die Mitgliedsdatei entsteht nur über den Mitgliederabruf, der DecideAccess erneut aufruft. Die Website-Ableitung läuft ausschließlich über website.media.
  5. Der Web-Prozess schreibt nicht nach originals/ und nicht nach derived/ oder public/.

Eine Karte oder eine Komponente begründet keine Berechtigung.

Umsetzung im CMS (19.11.2026, ADR-40)

Alle Bildstellen des CMS lesen den zentralen Medienbestand: Einstieg (Hero), Bild und Text, redaktionelle Karten, Premium-Karten (Kartenbild) und Abschnittshintergrund. Das CMS hat keine eigene Medienverwaltung mehr.

  • Gespeichert wird die Kennung des Inhaltselements im jeweiligen Bildschlüssel: refs.image (Einstieg, Bild und Text, Premium-Karten), data.items[].image (redaktionelle Karten), style.image (Abschnittshintergrund). Abweichung von refs.element: Die Medienkarte verwendet refs.element bereits für ihr Fachobjekt; ein gemeinsamer Bildschlüssel image hält alle Widgets gleich und ändert die gespeicherte Struktur nicht.
  • Lesen: App\Domain\Cms\Widgets\Support\WebsiteImage ruft WebsiteMedia::present auf. Öffentlich erscheint ein Bild nur über website.media. In der Redaktionsvorschau erscheint ein nicht freigegebenes Bild als Vorschaubild über editorial.card mit Hinweis; öffentlich nie.
  • Nicht freigegeben: Das Medium wird nicht öffentlich ausgeliefert. Überschrift, Text und Schaltflächen bleiben. Ein Widget, das danach keinen Inhalt mehr hat, entfällt. Die Redaktionsvorschau zeigt ein nicht freigegebenes Bild weiter mit Hinweis. Entschieden am 19.11.2026, siehe ADR-40.
  • Neu hochladen im Widget-Dialog: Die Datei geht über WebsiteIntake::acceptImage sofort in den Medienmanager und wird ausgewählt. Titel aus dem Dateinamen, ohne Quellenzeile; beides ist im Medienmanager änderbar. Die Warteschlange leitet ab und gibt frei (wie dokumentiert).
  • Auswahl: alle Bilder (output_class = bild, nicht archiviert, keine Traineranleitung) mit Vorschaubild, Titel und Website-Status; das gewählte Medium mit Status und Verweis auf den Medienmanager. Die Bildauswahl des Modul-/Programmeditors ist an dessen Livewire-Seite gebunden und lässt sich nicht als Formularfeld einhängen; das Bedienmuster (Suche, Vorschaubild, Auswahl) ist übernommen.
  • Alternativtext: aus dem Medium (website_alt, sonst Titel). Das Feld im Widget ist eine optionale Abweichung.
  • Website-Ableitung: Bilder werden bis 2400 px breit abgeleitet (vorher 640 px), nie vergrößert.
  • Medienmanager: Die Medienansicht nennt die Website-Seiten, auf denen ein Bild verwendet wird (WebsiteImageUsage), damit vor dem Zurücknehmen sichtbar ist, welche Seiten das Bild verlieren.

Übernahme der früheren CMS-Bilder

  • Der Job ImportCmsImages (angestoßen von einer Migration, ausgeführt von der Warteschlange) nimmt jede Bilddatei unter media_public/cms/ über WebsiteIntake auf. Bytegleiche Dateien werden ein Medium (SHA-256). Der Titel kommt aus dem Dateinamen ohne Zufallskennung. Nichts wird gelöscht; der Job ist wiederholbar.
  • website_media_aliases ordnet jeden früheren Pfad seinem Medium zu. Wirksam wird die Zuordnung erst, wenn das Medium einmal für die Website freigegeben war; bis dahin (oder wenn die Ableitung scheitert) gilt der frühere Pfad weiter, damit keine Seite ihr Bild verliert.
  • Danach entscheidet die Website-Freigabe des Mediums allein, auch über die frühere Adresse /medien/cms/… (404, wenn zurückgenommen).
  • Gespeicherte Revisionen bleiben unverändert; frühere Pfade werden beim Darstellen zugeordnet und beim nächsten Speichern durch die Kennung ersetzt. Frühere Pfade ohne Zuordnung bleiben über PublicMedia gültig.
  • Wird ein übernommenes Medium gelöscht, bleibt die Zuordnung als Sperre bestehen (content_element_id leer): Der frühere Pfad wird weder über /medien/cms/… ausgeliefert noch als Bild gezeigt; die Datei unter cms/ bleibt liegen. Die Karte oder das Widget bleibt ohne Bild.
  • Eine Slideshow gibt es im CMS nicht; WebsiteMedia::presentMany ist für sie vorbereitet und noch unbenutzt.

Präsentationszuordnungen (19.11.2026, ADR-41)

Ein Titelbild, Trailer oder Galerieelement an einem Film, Modul, Programm oder Lizenzartikel ist eine Referenz (presentation_assignments) auf die Medienidentität. Eine Inhaltsfassung ist dafür nicht erforderlich. source_version_id hält nur eine ausdrücklich hinterlegte Fassung fest. Die Rolle ist keine Verwendung im Aufbau, keine Inhaltsart und keine Website-Freigabe. Die Zuordnung macht das Medium nicht lizenzierbar.

Ö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.

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 an der Medien- und Materialkarte und an der Programm- und Modulkarte. Ein Thema hat nur einen Text („Text für die Website“); dort gibt es nichts zu wählen.
  • Programm- und Modulkarte: Wahl Automatisch (Teaser, sonst Kurzbeschreibung, sonst Lernziel, wie bisher), Teaser, Kurzbeschreibung, Ausführliche Beschreibung oder Lernziel der Fassung (steht auf der öffentlichen Programmseite bereits öffentlich). Die Texte werden mit der Zielgruppe „Öffentliche Kachel“ gelesen. Auch hier ersetzt eine ausdrückliche Wahl nicht still durch ein anderes Feld; die Vorschau nennt, wo der Text zu pflegen ist („Programm oder Modul bearbeiten“).

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. eine Stelle wählen: Regler und Zahlenfeld zeigen dieselbe Zeitposition, das Bild der Stelle folgt dem Regler nach kurzer Pause (wie im Medienmanager); „Diese Stelle übernehmen“ legt genau die angezeigte Stelle ab, oder
  2. „Vorschaubild des Films übernehmen“ (das im Medienmanager gesetzte Vorschaubild; mit kleiner Ansicht daneben).

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 oder bei der Verarbeitung gescheitertes Bild wird nicht wiederverwendet; die Stelle lässt sich dann neu übernehmen.
  • Wiederverwendung ehrlich melden: Wird ein schon übernommenes Bild gewählt, sagt die Meldung, wie es steht (bereits freigegeben, wird verarbeitet oder Website-Freigabe zurückgenommen). Eine zurückgenommene Freigabe bleibt zurückgenommen; das Bild erscheint öffentlich erst nach erneuter Freigabe im Medienmanager (Reiter „Website“).
  • Löschen: „Medium löschen“ (Medien ohne Fassung) entfernt auch ein Standbild; die Herkunftszeile entfällt (Migration allow_deleting_media_with_stills_and_aliases), dieselbe Stelle lässt sich neu übernehmen.
  • 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).

Vorschaubild eines Programms oder Moduls (Programm- und Modulkarte)

Das Vorschaubild eines Programms oder Moduls (Redaktionsmanager) ist ebenfalls ein geschütztes Bibliotheksbild. Im Reiter „Medien“ der Programm- und Modulkarte übernimmt „Vorschaubild übernehmen“ es als Bild-Medium („Titelbild: {Titel}“); CompositionStill arbeitet wie FilmStill: einmal kopiert (bis zur Größe der Vorschaudatei, 640 px), über WebsiteIntake abgelegt, Herkunft in composition_still_sources (dasselbe Vorschaubild ergibt dasselbe Medium), ein gescheitertes oder archiviertes Bild wird nicht wiederverwendet, die Meldung nennt den tatsächlichen Stand (auch bei zurückgenommener Freigabe). Ein Programm ohne Vorschaubild zeigt den Hinweis, es im Redaktionsmanager zu setzen. Eine Stelle aus einem Film des Programms zu wählen gibt es hier nicht; das Vorschaubild des Programms selbst lässt sich im Redaktionsmanager aus einem Film setzen.

Trailer auf Medien-, Programm- und Modulkarten

Ein Trailer ist ein eigenes Medium (Film ohne Fassung, Ableitung unter teaser/), das im Medienmanager einem Medium, Programm oder Modul in der Präsentation mit der Rolle „Trailer“ oder „Vorschauclip“ zugeordnet wird. Die Karte spielt ihn ab, wenn er für die Website freigegeben ist (Reiter „Website“ am Trailer). Lesende Klasse: CardClip (Trailer, sonst Vorschauclip, bei einem Film ersatzweise sein eigener freigegebener Teaser). Ausgeliefert wird über website.media, die Bereichsabrufe (Range) beantwortet. Nicht freigegebene Clips, der vollständige Film und Originale kommen nie über die Karte. Die Redaktionsvorschau spielt ebenfalls nur freigegebene Clips und nennt sonst den Grund. Verhalten (Maus, Tipp, Tastatur, reduzierte Bewegung, Datensparmodus): ADR-43.