Compare commits

..
Author SHA1 Message Date
LarsandClaude Sonnet 5.5 fc40aba26c Ergänze die Release-Vorbereitung um Shop-Fakten, Umgebungsschlüssel und den Migrationsvergleich.
CI Feature / test (push) Successful in 1m47s
Deploy Test / test (push) Successful in 1m45s
Deploy Test / deploy (push) Successful in 34s
Der Shop ist in Produktion durch EnsureShopEnabled gesperrt (APP_ENV=production, 404). Keine neuen Umgebungs-
schlüssel; genau fünf Migrationen ausstehend; Prod hat keine Bestellungen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 21:34:42 +01:00
LarsandClaude Sonnet 5.5 32837639e6 Berichte die Programm- und Modulkarte und bereite die Übergabe nach Prod vor.
CI Feature / test (push) Successful in 1m34s
Bericht mit Prüfergebnissen von luf-test und die Release-Vorbereitung develop → main: Inhalt, Migrationen,
Prod-Stand (lesend geprüft) und die Entscheidungen, die Lars vor dem Merge trifft. Der Merge selbst bleibt
ein manueller Schritt von Lars.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 21:31:38 +01:00
LarsandClaude Sonnet 5.5 3825f53a9b Wähle den Kartentext auch an der Programm- und Modulkarte und führe den Filmbild-Regler nach.
CI Feature / test (push) Successful in 1m46s
Deploy Test / test (push) Successful in 1m45s
Deploy Test / deploy (push) Successful in 36s
- Programm- und Modulkarte: „Text der Karte“ (Automatisch wie bisher: Teaser, sonst Kurzbeschreibung, sonst
  Lernziel; Teaser, Kurzbeschreibung, Ausführliche Beschreibung, Lernziel der Fassung). Eine ausdrückliche Wahl
  ersetzt nicht still; die Vorschau nennt, wo der Text zu pflegen ist. Das Vorschaubild des Programms oder Moduls
  lässt sich als Bild-Medium übernehmen (CompositionStill, additive Tabelle composition_still_sources).
- Filmbild im Dialog wie im Medienmanager: Regler und Zahlenfeld zeigen dieselbe Stelle, das Bild folgt dem Regler
  nach kurzer Pause, „Diese Stelle übernehmen“; das Vorschaubild des Films mit kleiner Ansicht daneben.
- Gemeinsame Meldung nach dem tatsächlichen Stand für Film- und Programmbilder.
- Test bewusst angepasst: Die Programmkarte hat jetzt eine Textwahl (vorher nur die Medienkarte).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 21:19:43 +01:00
LarsandClaude Sonnet 5.5 604e1791c5 Berichte die Medienkarte mit Textwahl und Bild aus dem Film.
CI Feature / test (push) Successful in 1m47s
Deploy Test / test (push) Successful in 1m48s
Deploy Test / deploy (push) Successful in 26s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 19:36:38 +01:00
LarsandClaude Sonnet 5.5 cd66561ca9 Melde die Wiederverwendung eines Filmbilds ehrlich und erlaube das Löschen der Medien.
- Wird eine schon übernommene Stelle erneut gewählt, nennt die Meldung den tatsächlichen Stand: bereits freigegeben,
  wird verarbeitet oder Website-Freigabe zurückgenommen (bleibt zurückgenommen). Ein bei der Verarbeitung
  gescheitertes oder archiviertes Bild wird nicht wiederverwendet; die Herkunft zeigt dann auf das neue Bild.
- „Medium löschen“ erreicht jetzt Standbilder (film_still_sources: cascade) und übernommene CMS-Bilder
  (website_media_aliases: Zuordnung bleibt als Sperre, die frühere Adresse /medien/cms/… liefert 404, das Widget
  zeigt kein Bild). Vorher hätte der Fremdschlüssel das Löschen mit einem Fehler abgebrochen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 19:36:07 +01:00
LarsandClaude Sonnet 5.5 886715af96 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>
2026-11-21 19:11:01 +01:00
LarsandClaude Sonnet 5.5 05bd36509c Wähle den Kartentext der Medienkarte und übernimm Bilder aus dem Film.
Text: Einstellung „Text der Karte“ (Automatisch, Teaser, Kurzbeschreibung, Ausführliche Beschreibung). Automatisch
bleibt wie bisher (Kurzbeschreibung, sonst Teaser). Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes
Feld; ist sie nicht gepflegt, bleibt die Karte ohne Text und die Vorschau nennt, wo sie zu pflegen ist. Der eigene
Text der Karte hat weiter Vorrang. Einsatzhinweis und Lizenzvermerk bleiben intern.

Film: Im Reiter „Medien“ lässt sich das Vorschaubild des Films oder eine gewählte Stelle als Kartenbild übernehmen.
FilmStill zieht das Einzelbild einmal (bis 1600 px, nie vergrößert) und legt es über WebsiteIntake als gewöhnliches
Bild-Medium ab; die Warteschlange leitet ab und gibt frei. Dieselbe Stelle ergibt dasselbe Medium
(film_still_sources, additive Tabelle). Seitenaufrufe lesen nur die gespeicherte Datei und starten kein ffmpeg.
Der Film bleibt geschützt; Traineranleitungen, archivierte und nicht bereitgestellte Filme sind ausgeschlossen.
ThumbnailDeriver::jpegAtVersion behält seine Signatur, die Auflösungswahl steht in frameJpeg.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 19:09:00 +01:00
33 changed files with 1989 additions and 34 deletions

No files matched your search

+32 -15
View File
@@ -15,6 +15,8 @@
* Redaktionsvorschau (Route editorial.card, nur für angemeldete Redaktion); öffentlich nie ausgegeben, weil es
* keine Freigabe für die Website hat.
* - missing: was für eine vollständige Karte fehlt, als Hinweis nur in der Redaktionsvorschau.
* - texts: die zentralen Texte des Fachobjekts, aus denen die Karte einen wählen kann (teaser, summary, description).
* summary bleibt der Text der Vorgabe („Automatisch“); texts wird nur gelesen, wenn die Redaktion einen wählt.
*/
final readonly class CardSubject
{
@@ -36,24 +38,39 @@ public function __construct(
public ?string $previewImage = null,
public array $missing = [],
public ?string $style = null,
public array $texts = [],
) {}
public function withText(?string $title, ?string $summary): self
{
return new self(
title: $title ?? $this->title,
summary: $summary ?? $this->summary,
kind: $this->kind,
badge: $this->badge,
meta: $this->meta,
url: $this->url,
public: $this->public,
notice: $this->notice,
visual: $this->visual,
visualLabel: $this->visualLabel,
previewImage: $this->previewImage,
missing: $this->missing,
style: $this->style,
);
return $this->copy(['title' => $title ?? $this->title, 'summary' => $summary ?? $this->summary]);
}
/**
* Text der Karte aus einem zentralen Text des Fachobjekts. Ist er nicht gepflegt, bleibt die Karte ohne Text
* (kein stiller Ersatz aus einem anderen Feld); in der Redaktionsvorschau steht dann ein Hinweis.
*/
public function withTextChoice(string $field, string $missingHint): self
{
if (! array_key_exists($field, $this->texts)) {
return $this;
}
$text = $this->texts[$field];
$missing = array_values(array_filter($this->missing, fn (string $hint): bool => ! str_contains($hint, 'Kurzbeschreibung')));
if ($text === null) {
$missing[] = $missingHint;
}
return $this->copy(['summary' => $text, 'missing' => $missing]);
}
/**
* @param array<string, mixed> $changes
*/
private function copy(array $changes): self
{
return new self(...array_merge(get_object_vars($this), $changes));
}
}
@@ -265,6 +265,13 @@ public function subject(mixed $id, bool $includeNonPublic): ?CardSubject
$profile = app(EditorialProfileReader::class)->read($composition, 'kachel');
$summary = $profile->value('teaser') ?: $profile->value('summary');
$goal = filled($version?->learning_goal) ? trim((string) $version->learning_goal) : null;
// Zentrale Texte, aus denen die Redaktion den Kartentext wählen kann (Zielgruppe „Öffentliche Kachel“).
$texts = [
'teaser' => $profile->value('teaser'),
'summary' => $profile->value('summary'),
'description' => $profile->value('description'),
'goal' => $goal,
];
$missing = [];
if ($summary === null) {
@@ -313,6 +320,7 @@ public function subject(mixed $id, bool $includeNonPublic): ?CardSubject
visualLabel: $kind,
previewImage: $includeNonPublic ? ThumbnailRef::url('editorial.card', 'komposition', (int) $composition->id, $composition->thumbnail_path) : null,
missing: $missing,
texts: $texts,
);
}
@@ -20,9 +20,12 @@
* öffentlich, mit Verweis auf diese Programmseite, und nur mit bereitgestellter Fassung. Traineranleitungen erscheinen
* nie öffentlich (vertraulich für Trainerinnen und Trainer).
*
* Öffentlich gelesen werden Anzeigetitel (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart und Ausgabeart. Nie:
* Beschreibung, Einsatzhinweis, Lizenzvermerk, Dateien, Lehrtexte, Ausgabeadressen. Das Vorschaubild (Filmstandbild)
* der Bibliothek ist nicht für die Website freigegeben; es erscheint nur in der Redaktionsvorschau.
* Öffentlich gelesen werden Anzeigetitel (sonst Arbeitstitel), Inhaltsart und Ausgabeart sowie einer der Texte
* Teaser, Kurzbeschreibung oder ausführliche Beschreibung. Welcher Text erscheint, entscheidet die Redaktion je Karte
* (Einstellung „Text der Karte“); ohne Wahl gilt die Kurzbeschreibung, sonst der Teaser. Die ausführliche Beschreibung
* erscheint nur, wenn die Redaktion sie ausdrücklich wählt. Nie: Einsatzhinweis, Lizenzvermerk, Dateien, Lehrtexte,
* Ausgabeadressen. Das Vorschaubild der Bibliothek ist nicht für die Website freigegeben; es erscheint nur in der
* Redaktionsvorschau und kann in der Karte ausdrücklich als Website-Bild übernommen werden (FilmStill).
* Eine Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei.
*/
class PublicMaterialReader
@@ -124,7 +127,7 @@ public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?
$shown = clone $element;
foreach (['working_title', 'display_title', 'summary', 'thumbnail_path', 'thumbnail_alt'] as $field) {
foreach (['working_title', 'display_title', 'teaser', 'summary', 'description', 'thumbnail_path', 'thumbnail_alt'] as $field) {
if (! array_key_exists($field, $draft)) {
continue;
}
@@ -146,6 +149,18 @@ public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?
$summary = trim((string) $shown->teaser);
}
$texts = [];
foreach (['teaser', 'summary', 'description'] as $field) {
$own = filled($shown->getAttribute($field)) ? trim((string) $shown->getAttribute($field)) : null;
if (! array_key_exists($field, $draft) && $profile->origin($field) === 'variante') {
$own = $profile->value($field);
}
$texts[$field] = $own;
}
$title = (string) ($shown->display_title ?: $shown->working_title);
if (! array_key_exists('display_title', $draft) && $profile->origin('display_title') === 'variante') {
@@ -184,6 +199,7 @@ public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?
previewImage: $previewImage,
missing: $missing,
style: $film ? 'media' : 'material',
texts: $texts,
);
}
@@ -127,6 +127,10 @@ public function url(mixed $value, bool $preview = false): ?string
$legacy = self::normalize($value);
if (is_string($legacy) && WebsiteMediaAlias::isRetired($legacy)) {
return null;
}
return is_string($legacy) ? PublicMedia::url($legacy) : null;
}
@@ -175,6 +179,10 @@ public function status(mixed $value): ?array
$id = $this->elementId($value);
if ($id === null && WebsiteMediaAlias::isRetired($value)) {
return ['public' => false, 'state' => 'missing', 'title' => basename((string) $value), 'note' => 'Das Medium wurde gelöscht.', 'thumb' => null, 'manageUrl' => null];
}
if ($id === null) {
return [
'public' => true,
@@ -7,6 +7,10 @@
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Media\FilmStill;
use App\Domain\Media\ThumbnailRef;
use Filament\Forms\Components\ViewField;
use Filament\Schemas\Components\Utilities\Get;
/**
* Medien- und Materialkarte (Kit v1.7 „media“): ein Inhaltselement mit Anzeigetitel, Kurzbeschreibung, Inhaltsart und
@@ -53,7 +57,7 @@ protected function refLabel(): string
protected function refHelp(): string
{
return 'Wählbar sind alle nicht archivierten, nicht gesperrten Filme und Materialien. Öffentlich erscheint die Karte nur mit bereitgestellter Fassung und wenn der Inhalt zu einem öffentlich gezeigten Programm gehört; Traineranleitungen nie. Titel und Kurzbeschreibung pflegen Sie im Medium.';
return 'Wählbar sind alle nicht archivierten, nicht gesperrten Filme und Materialien. Öffentlich erscheint die Karte nur mit bereitgestellter Fassung und wenn der Inhalt zu einem öffentlich gezeigten Programm gehört; Traineranleitungen nie. Titel, Teaser, Kurzbeschreibung und Beschreibung pflegen Sie im Medium; welcher Text auf der Karte erscheint, wählen Sie unter „Darstellung“.';
}
protected function searchSubjects(?string $term): array
@@ -90,6 +94,57 @@ protected function cardStyle(): string
return 'media';
}
/**
* Bei einem Film: das Vorschaubild des Films oder eine Stelle des Films als Kartenbild übernehmen. Das Bild wird
* einmal als Bild-Medium abgelegt (FilmStill) und wie jedes andere Bild ausgewählt; die Karte liest nur diese Datei.
*/
protected function imageSourceFields(): array
{
return [
ViewField::make('_filmbild')
->label('Bild aus dem Film')
->view('filament.cms.filmbild-feld')
->dehydrated(false)
->visible(fn (Get $get): bool => $this->filmFor($get('element')) !== null)
->viewData(function (Get $get): array {
$film = $this->filmFor($get('element'));
$stills = app(FilmStill::class);
$version = $film instanceof ContentElement ? $stills->version($film) : null;
return [
'film' => $film,
'filmTitle' => $film instanceof ContentElement ? (string) ($film->display_title ?: $film->working_title) : '',
'filmVersionId' => $version?->id,
'filmHasThumbnail' => $film instanceof ContentElement && is_string($film->thumbnail_path) && $film->thumbnail_path !== '',
'filmThumbnailUrl' => $film instanceof ContentElement ? ThumbnailRef::url('editorial.card', 'element', (int) $film->id, $film->thumbnail_path) : null,
'filmStartSecond' => $film instanceof ContentElement ? ($stills->thumbnailSecond($film) ?? '0') : '0',
];
}),
];
}
private function filmFor(mixed $id): ?ContentElement
{
$element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null;
return $element instanceof ContentElement && app(FilmStill::class)->refusal($element) === null ? $element : null;
}
protected function subjectNoun(): string
{
return 'Medium';
}
protected function textChoices(): array
{
return [
'auto' => 'Automatisch (Kurzbeschreibung, sonst Teaser)',
'teaser' => 'Teaser',
'summary' => 'Kurzbeschreibung',
'description' => 'Ausführliche Beschreibung (erscheint öffentlich)',
];
}
protected function centralCoverId(mixed $id): ?int
{
$element = is_numeric($id) ? ContentElement::query()->find((int) $id) : null;
@@ -10,6 +10,7 @@
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\Field;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Group;
@@ -56,6 +57,47 @@ abstract protected function defaultActionLabel(): string;
/** Gestaltungsvariante des Kits: editorial, media oder catalog. */
abstract protected function cardStyle(): string;
/**
* Weitere Wege zum Kartenbild im Reiter „Medien“, zum Beispiel ein Bild aus dem Film. Standard: keine.
*
* @return list<Field>
*/
protected function imageSourceFields(): array
{
return [];
}
/**
* Zentrale Texte des Fachobjekts, aus denen die Redaktion den Kartentext wählen kann: Wert => Bezeichnung.
* Leer: keine Wahl (die Karte nimmt den Text ihrer Vorgabe). Mit Wahl gilt „auto“ als Vorgabe.
*
* @return array<string, string>
*/
protected function textChoices(): array
{
return [];
}
/** Was die Redaktion bearbeitet, um einen Text zu pflegen („Medium“, „Programm oder Modul“); für Hinweise. */
protected function subjectNoun(): string
{
return 'Objekt';
}
/** Hinweis der Redaktionsvorschau, wenn der gewählte zentrale Text nicht gepflegt ist. */
private function missingTextHint(string $field): string
{
$noun = $this->subjectNoun();
return match ($field) {
'teaser' => 'Kein Teaser gepflegt ('.$noun.' bearbeiten → Teaser).',
'summary' => 'Keine Kurzbeschreibung gepflegt ('.$noun.' bearbeiten → Kurzbeschreibung).',
'description' => 'Keine ausführliche Beschreibung gepflegt ('.$noun.' bearbeiten → Beschreibung).',
'goal' => 'Kein Lernziel gepflegt ('.$noun.' bearbeiten → Lernziel der Fassung).',
default => '',
};
}
public function view(): string
{
return 'widgets.premium_card';
@@ -110,7 +152,9 @@ public function optionIcons(): array
public function settings(): array
{
return [
$choices = $this->textChoices();
return ($choices === [] ? [] : ['text_source' => $choices]) + [
'format' => ['landscape' => 'Querformat 16:9', 'square' => 'Quadrat 1:1', 'portrait' => 'Hochformat 3:4'],
'fit' => ['cover' => 'Ausschnitt füllt die Fläche', 'contain' => 'Ganzes Bild zeigen (Dokument, Poster)'],
'heading_level' => ['h3' => 'H3', 'h2' => 'H2', 'h4' => 'H4'],
@@ -124,10 +168,11 @@ public function settings(): array
public function settingLabels(): array
{
return [
'text_source' => ['Text der Karte', 'Welche Angabe aus der Redaktion die Karte zeigt. Vorgabe: Automatisch. Der gewählte Text erscheint öffentlich, wenn die Karte öffentlich ist; ist er nicht gepflegt, bleibt die Karte ohne Text.'],
'format' => ['Bildformat', 'Vorgabe: Querformat 16:9. Gilt auch neben dem Text; das Motiv wird nicht nachträglich hochkant beschnitten.'],
'fit' => ['Bilddarstellung', 'Vorgabe: Ausschnitt. „Ganzes Bild“ zeigt Dokumente und Poster vollständig auf ruhiger Fläche.'],
'heading_level' => ['Überschriftenebene', 'Vorgabe: H3, passend unter einer Abschnittsüberschrift (H2).'],
'show_summary' => ['Kurzbeschreibung', 'Aus den Fachdaten. Vorgabe: anzeigen.'],
'show_summary' => ['Text anzeigen', 'Aus den Fachdaten. Vorgabe: anzeigen.'],
'show_kind' => ['Art oder Label', 'Zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: anzeigen.'],
'show_meta' => ['Zusatzangaben', 'Aus den Fachdaten, zum Beispiel Ausgabeart oder Programmzugehörigkeit. Vorgabe: anzeigen.'],
'show_action' => ['Aktion', 'Verweis auf die öffentliche Seite des Fachobjekts, falls es eine gibt. Vorgabe: anzeigen.'],
@@ -195,13 +240,13 @@ public function editorSchema(): array
->hintColor(fn (?string $state): string => filled($state) ? 'warning' : 'gray')
->helperText('Leer übernimmt den Anzeigenamen des Fachobjekts. Eine Eintragung gilt nur für diese Karte und ändert die Quelle nicht.'),
TextInput::make('summary')
->label('Teaser nur für diese Karte')
->label('Text nur für diese Karte')
->maxLength(500)
->live(onBlur: true)
->placeholder(fn (Get $get): string => $this->centralText($get('../refs.'.$this->refKey()), 'summary') ?? 'Zentraler Teaser oder Kurzbeschreibung')
->placeholder(fn (Get $get): string => $this->centralText($get('../refs.'.$this->refKey()), 'summary', $get('../settings.text_source')) ?? 'Zentraler Text aus der Redaktion')
->hint(fn (?string $state): string => filled($state) ? 'Eigene Angabe für diese Karte' : 'Aus der Redaktion')
->hintColor(fn (?string $state): string => filled($state) ? 'warning' : 'gray')
->helperText('Leer übernimmt Teaser oder Kurzbeschreibung. Lehrinhalt, Rechte und Preise bleiben unberührt.'),
->helperText('Leer übernimmt den Text, den „Text der Karte“ (Darstellung) wählt. Lehrinhalt, Rechte und Preise bleiben unberührt.'),
])->statePath('data'),
];
}
@@ -211,7 +256,7 @@ public function mediaSchema(): array
[, , $alt, $focusX, $focusY] = $this->dataFields();
return [
Group::make(ImageRefFields::fields('Kartenbild', live: true))->statePath('refs'),
Group::make([...ImageRefFields::fields('Kartenbild', live: true), ...$this->imageSourceFields()])->statePath('refs'),
Group::make([$alt, $focusX, $focusY])->statePath('data'),
];
}
@@ -248,6 +293,12 @@ public function resolve(array $widget, RenderContext $context): array
$data = $widget['data'];
$subject = $this->subject($widget['refs'][$this->refKey()] ?? null, $context);
$textSource = $option('text_source', 'auto');
if ($subject instanceof CardSubject && $textSource !== 'auto' && isset($this->textChoices()[$textSource])) {
$subject = $subject->withTextChoice($textSource, $this->missingTextHint($textSource));
}
$heading = filled($data['heading'] ?? null) ? trim((string) $data['heading']) : null;
$lead = filled($data['summary'] ?? null) ? trim((string) $data['summary']) : null;
@@ -302,7 +353,7 @@ protected function centralCoverId(mixed $id): ?int
/**
* Zentraler Anzeigename oder Teaser des gewählten Objekts (Redaktionsstand) für Platzhalter im Editor.
*/
private function centralText(mixed $id, string $field): ?string
private function centralText(mixed $id, string $field, mixed $textSource = null): ?string
{
if (blank($id)) {
return null;
@@ -314,6 +365,10 @@ private function centralText(mixed $id, string $field): ?string
return null;
}
if ($subject instanceof CardSubject && is_string($textSource) && isset($this->textChoices()[$textSource]) && $textSource !== 'auto') {
$subject = $subject->withTextChoice($textSource, $this->missingTextHint($textSource));
}
$text = $subject?->{$field};
return is_string($text) && trim($text) !== '' ? Str::limit(trim($text), 120) : null;
@@ -7,6 +7,10 @@
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Media\CompositionStill;
use App\Domain\Media\ThumbnailRef;
use Filament\Forms\Components\ViewField;
use Filament\Schemas\Components\Utilities\Get;
/**
* Modul- und Programmkarte (Kit v1.7 „catalog“): ein Programm oder Modul über PublicCatalogReader, dieselbe
@@ -41,6 +45,59 @@ public function schematic(): array
return [[2, 2, 56, 32, 'line'], [5, 5, 22, 26, 'ink'], [8, 24, 10, 2, 'accent'], [31, 8, 10, 2, 'line'], [31, 13, 22, 4, 'ink'], [31, 25, 14, 5, 'ink']];
}
/**
* Das Vorschaubild des Programms oder Moduls als Kartenbild übernehmen. Es wird einmal als Bild-Medium abgelegt
* (CompositionStill) und wie jedes andere Bild ausgewählt; die Karte liest nur diese Datei.
*/
protected function imageSourceFields(): array
{
return [
ViewField::make('_programmbild')
->label('Bild aus dem Programm oder Modul')
->view('filament.cms.kompositionsbild-feld')
->dehydrated(false)
->visible(fn (Get $get): bool => $this->compositionFor($get('composition')) !== null)
->viewData(function (Get $get): array {
$composition = $this->compositionFor($get('composition'));
return [
'composition' => $composition,
'compositionTitle' => $composition instanceof Composition ? (string) ($composition->display_title ?: $composition->designation) : '',
'compositionThumbnailUrl' => $composition instanceof Composition && app(CompositionStill::class)->hasThumbnail($composition)
? ThumbnailRef::url('editorial.card', 'komposition', (int) $composition->id, $composition->thumbnail_path)
: null,
];
}),
];
}
private function compositionFor(mixed $id): ?Composition
{
$composition = is_numeric($id) ? Composition::query()->with('editorialContentKind')->find((int) $id) : null;
return $composition instanceof Composition && app(PublicCatalogReader::class)->isCardSelectable($composition) ? $composition : null;
}
protected function subjectNoun(): string
{
return 'Programm oder Modul';
}
/**
* Wählbare Texte: die zentralen Texte des Programms oder Moduls und das Lernziel der Fassung. „Automatisch“ bleibt
* wie bisher: Teaser, sonst Kurzbeschreibung, sonst Lernziel. Die ausführliche Beschreibung erscheint nur auf Wahl.
*/
protected function textChoices(): array
{
return [
'auto' => 'Automatisch (Teaser, sonst Kurzbeschreibung, sonst Lernziel)',
'teaser' => 'Teaser',
'summary' => 'Kurzbeschreibung',
'description' => 'Ausführliche Beschreibung (erscheint öffentlich)',
'goal' => 'Lernziel der Fassung',
];
}
public function settings(): array
{
// Die Art (Programm oder Modul) bleibt immer sichtbar; sie lässt sich nicht ausblenden.
+100
View File
@@ -0,0 +1,100 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\DomainRuleException;
use App\Models\User;
use Illuminate\Database\QueryException;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
/**
* Übernimmt das Vorschaubild eines Programms oder Moduls als gewöhnliches Bild-Medium im Medienmanager
* (Programm- und Modulkarte), nach demselben Prinzip wie FilmStill.
*
* - Ausdrückliche Handlung der Redaktion. Das Vorschaubild ist ein geschütztes Bibliotheksbild; erst die Übernahme
* legt ein Medium an, das für die Website freigegeben werden kann (WebsiteIntake, Warteschlange).
* - Die Datei wird einmal kopiert. Dieselbe Vorschaudatei ergibt dasselbe Medium (composition_still_sources).
* - Es entsteht keine Fassung, keine Berechtigung, kein Lizenzartikel.
*/
class CompositionStill
{
/** Wahr, wenn der letzte Aufruf ein schon vorhandenes Bild geliefert hat. */
public bool $reused = false;
public function __construct(private readonly WebsiteIntake $intake) {}
public function refusal(Composition $composition): ?string
{
if ($composition->archived_at !== null) {
return 'Das Programm oder Modul ist archiviert.';
}
return null;
}
public function hasThumbnail(Composition $composition): bool
{
$path = $composition->thumbnail_path;
return is_string($path) && str_starts_with($path, 'vorschau/') && ! str_contains($path, '..')
&& Storage::disk('media_derived')->exists($path);
}
public function fromThumbnail(Composition $composition, ?User $actor = null): ContentElement
{
$this->reused = false;
$refusal = $this->refusal($composition);
if ($refusal !== null) {
throw new DomainRuleException($refusal);
}
if (! $this->hasThumbnail($composition)) {
throw new DomainRuleException('Dieses Programm oder Modul hat noch kein Vorschaubild. Setzen Sie es im Redaktionsmanager.');
}
$bytes = Storage::disk('media_derived')->get((string) $composition->thumbnail_path);
if (! is_string($bytes) || $bytes === '') {
throw new DomainRuleException('Das Vorschaubild ließ sich nicht lesen.');
}
$key = 'file:'.hash('sha256', $bytes);
$existing = $this->existing($composition, $key);
if ($existing instanceof ContentElement) {
$this->reused = true;
return $existing;
}
$title = (string) ($composition->display_title ?: $composition->designation);
$path = 'cms/titelbild-'.$composition->id.'-'.Str::lower(Str::random(8)).'.jpg';
Storage::disk('cms_incoming')->put($path, $bytes);
$still = $this->intake->acceptImage($path, 'Titelbild: '.$title, null, 'Titelbild zu „'.$title.'“', $actor);
try {
CompositionStillSource::query()->updateOrCreate(
['composition_id' => $composition->id, 'source_key' => $key],
['still_element_id' => $still->id, 'actor_id' => $actor?->id],
);
} catch (QueryException) {
return $this->existing($composition, $key) ?? $still;
}
return $still;
}
private function existing(Composition $composition, string $key): ?ContentElement
{
$source = CompositionStillSource::query()->with('still')->where('composition_id', $composition->id)->where('source_key', $key)->first();
$still = $source?->still;
// Ein archiviertes oder bei der Verarbeitung gescheitertes Bild wird nicht wiederverwendet.
return $still instanceof ContentElement && $still->archived_at === null && ! filled($still->thumbnail_error) ? $still : null;
}
}
@@ -0,0 +1,26 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\ContentElement;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Herkunft eines Bild-Mediums aus dem Vorschaubild eines Programms oder Moduls (source_key file:{SHA-256}).
*/
class CompositionStillSource extends Model
{
protected $fillable = ['composition_id', 'still_element_id', 'source_key', 'actor_id'];
public function composition(): BelongsTo
{
return $this->belongsTo(Composition::class);
}
public function still(): BelongsTo
{
return $this->belongsTo(ContentElement::class, 'still_element_id');
}
}
+213
View File
@@ -0,0 +1,213 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentElementVersion;
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Models\User;
use Illuminate\Database\QueryException;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
/**
* Legt ein Bild aus einem Film als gewöhnliches Bild-Medium im Medienmanager ab (Medien- und Materialkarte).
*
* - Zwei Wege: das Vorschaubild des Films übernehmen oder eine Stelle (Sekunde) wählen. Beides ist eine
* ausdrückliche Handlung der Redaktion; erst dadurch entsteht ein Bild, das für die Website freigegeben werden kann.
* - Das Bild wird einmal gezogen und gespeichert (WebsiteIntake legt es an, die Warteschlange leitet es ab und gibt
* es frei). Seitenaufrufe lesen nur die gespeicherte Datei und starten nie ffmpeg.
* - Dieselbe Stelle (oder dieselbe Vorschaudatei) ergibt dasselbe Medium (film_still_sources).
* - Es wird nie der Film selbst, nur ein Einzelbild bis 1600 px Breite abgelegt. Traineranleitungen und
* archivierte oder gesperrte Filme sind ausgeschlossen. Eine Rechte- oder Lizenzentscheidung entsteht nicht.
*/
class FilmStill
{
/** Breite eines übernommenen Standbilds; die kleine Filmstufe (640 px) wäre auf der Website sichtbar unscharf. */
public const WIDTH = 1600;
/** Wahr, wenn der letzte Aufruf ein schon vorhandenes Bild geliefert hat (keine neue Extraktion). */
public bool $reused = false;
public function __construct(
private readonly ThumbnailDeriver $deriver,
private readonly WebsiteIntake $intake,
) {}
/** Grund, warum aus diesem Medium kein Standbild übernommen wird, sonst null. */
public function refusal(ContentElement $film): ?string
{
if ($film->output_class !== 'film') {
return 'Nur aus einem Film lässt sich ein Bild übernehmen.';
}
if ($film->archived_at !== null) {
return 'Der Film ist archiviert.';
}
$slug = $film->editorialContentKind?->slug;
if (in_array($slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true)) {
return 'Aus Traineranleitungen werden keine Bilder für die Website übernommen.';
}
return null;
}
/** Die bereitgestellte Fassung, aus der Stellen gezogen werden (die höchste). */
public function version(ContentElement $film): ?ContentElementVersion
{
return $film->versions()
->where('status', ContentVersionStatus::Bereit->value)
->orderByDesc('number')
->first();
}
/** Sekunde der Stelle, aus der das aktuelle Vorschaubild des Films stammt, sonst null. */
public function thumbnailSecond(ContentElement $film): ?string
{
$source = $film->thumbnail_source;
return is_string($source) && preg_match('/^frame:\d+@([\d.]+)$/', $source, $match) === 1 ? $match[1] : null;
}
public function fromSecond(ContentElement $film, float $seconds, ?User $actor = null): ContentElement
{
$this->reused = false;
$this->guard($film);
if ($seconds < 0 || $seconds > 7200) {
throw new DomainRuleException('Die Zeitposition liegt außerhalb des Films.');
}
$version = $this->version($film);
if (! $version instanceof ContentElementVersion) {
throw new DomainRuleException('Der Film hat noch keine bereitgestellte Fassung.');
}
return $this->fromFrame($film, $version, $seconds, $actor);
}
public function fromThumbnail(ContentElement $film, ?User $actor = null): ContentElement
{
$this->reused = false;
$this->guard($film);
// Stammt das Vorschaubild aus einer Filmstelle, wird dieselbe Stelle in voller Auflösung gezogen.
$second = $this->thumbnailSecond($film);
if ($second !== null && preg_match('/^frame:(\d+)@/', (string) $film->thumbnail_source, $match) === 1) {
$version = ContentElementVersion::query()->find((int) $match[1]);
if ($version instanceof ContentElementVersion
&& (int) $version->content_element_id === (int) $film->id
&& $version->status !== ContentVersionStatus::Gesperrt) {
try {
return $this->fromFrame($film, $version, (float) $second, $actor);
} catch (DomainRuleException) {
// Die Stelle lässt sich nicht mehr ziehen: das gespeicherte Vorschaubild selbst übernehmen.
}
}
}
$path = $film->thumbnail_path;
if (! is_string($path) || ! str_starts_with($path, 'vorschau/') || str_contains($path, '..') || ! Storage::disk('media_derived')->exists($path)) {
throw new DomainRuleException('Dieser Film hat noch kein Vorschaubild. Setzen Sie es im Medienmanager oder wählen Sie eine Stelle.');
}
$bytes = Storage::disk('media_derived')->get($path);
if (! is_string($bytes) || $bytes === '') {
throw new DomainRuleException('Das Vorschaubild ließ sich nicht lesen.');
}
$key = 'file:'.hash('sha256', $bytes);
$existing = $this->existing($film, $key);
if ($existing instanceof ContentElement) {
$this->reused = true;
return $existing;
}
return $this->store($film, $key, $bytes, 'Vorschaubild', $actor);
}
private function fromFrame(ContentElement $film, ContentElementVersion $version, float $seconds, ?User $actor): ContentElement
{
$second = $this->secondText($seconds);
$key = 'frame:'.$version->id.'@'.$second;
$existing = $this->existing($film, $key);
if ($existing instanceof ContentElement) {
$this->reused = true;
return $existing;
}
$bytes = $this->deriver->frameJpeg($version, (float) $second, self::WIDTH, original: true);
if (! is_string($bytes)) {
throw new DomainRuleException('Aus dieser Filmstelle ließ sich kein Bild erzeugen.');
}
return $this->store($film, $key, $bytes, 'Fassung '.$version->number.', '.str_replace('.', ',', $second).' s', $actor);
}
private function guard(ContentElement $film): void
{
$refusal = $this->refusal($film);
if ($refusal !== null) {
throw new DomainRuleException($refusal);
}
}
private function existing(ContentElement $film, string $key): ?ContentElement
{
$source = FilmStillSource::query()->with('still')->where('film_element_id', $film->id)->where('source_key', $key)->first();
$still = $source?->still;
// Ein archiviertes oder an der Verarbeitung gescheitertes Bild wird nicht wiederverwendet; die Stelle kann neu
// übernommen werden (store() ordnet dann das neue Bild zu).
return $still instanceof ContentElement && $still->archived_at === null && ! filled($still->thumbnail_error) ? $still : null;
}
private function store(ContentElement $film, string $key, string $bytes, string $label, ?User $actor): ContentElement
{
$title = (string) ($film->display_title ?: $film->working_title);
$path = 'cms/standbild-'.$film->id.'-'.Str::lower(Str::random(8)).'.jpg';
Storage::disk('cms_incoming')->put($path, $bytes);
$still = $this->intake->acceptImage(
$path,
'Standbild: '.$title.' ('.$label.')',
filled($film->website_credit) ? (string) $film->website_credit : null,
'Szene aus dem Film „'.$title.'“',
$actor,
);
try {
FilmStillSource::query()->updateOrCreate(
['film_element_id' => $film->id, 'source_key' => $key],
['still_element_id' => $still->id, 'actor_id' => $actor?->id],
);
} catch (QueryException) {
// Gleichzeitige Übernahme derselben Stelle: das zuerst angelegte Bild gilt.
return $this->existing($film, $key) ?? $still;
}
return $still;
}
private function secondText(float $seconds): string
{
$text = number_format(max(0, min(7200, $seconds)), 3, '.', '');
return rtrim(rtrim($text, '0'), '.') ?: '0';
}
}
+26
View File
@@ -0,0 +1,26 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\ContentElement;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Herkunft eines Standbilds: aus welchem Film und welcher Stelle (frame:{Fassung}@{Sekunde}) oder aus welcher Datei
* (file:{SHA-256}) das Bild-Medium stammt.
*/
class FilmStillSource extends Model
{
protected $fillable = ['film_element_id', 'still_element_id', 'source_key', 'actor_id'];
public function film(): BelongsTo
{
return $this->belongsTo(ContentElement::class, 'film_element_id');
}
public function still(): BelongsTo
{
return $this->belongsTo(ContentElement::class, 'still_element_id');
}
}
+27 -3
View File
@@ -138,8 +138,20 @@ public function forCompositionFrame(Composition $composition, ContentElementVers
$this->rememberChoice($composition, 'frame:'.$version->id.'@'.$this->secondText($seconds));
}
public function frameInput(ContentElementVersion $version): ?string
/**
* Datei, aus der ein Bild gezogen wird. Vorgabe: die kleine Filmstufe (schnell, für die Vorschau). Mit $original
* zuerst die Mediendatei selbst, damit ein übernommenes Standbild nicht aus der kleinen Stufe hochgerechnet wird.
*/
public function frameInput(ContentElementVersion $version, bool $original = false): ?string
{
if ($original) {
$master = is_array($version->metadata) ? ($version->metadata['file'] ?? null) : null;
if ($this->readableDerived($master, 'inhalte/')) {
return $master;
}
}
$proxy = MediaRendition::query()
->where('content_element_version_id', $version->id)
->where('role', 'variant')
@@ -155,13 +167,25 @@ public function frameInput(ContentElementVersion $version): ?string
return $this->readableDerived($file, 'inhalte/') ? $file : null;
}
/**
* Einzelbild einer Filmstelle als JPEG, 640 px breit aus der kleinen Stufe (Vorschau im Editor und Vorschaubild).
*/
public function jpegAtVersion(ContentElementVersion $version, float $seconds): ?string
{
return $this->frameJpeg($version, $seconds);
}
/**
* Einzelbild einer Filmstelle als JPEG. Ein übernommenes Standbild (FilmStill) wird mit $width und $original aus der
* Mediendatei gezogen statt aus der kleinen Stufe und dabei nie über die Breite der Quelle hinaus vergrößert.
*/
public function frameJpeg(ContentElementVersion $version, float $seconds, int $width = 640, bool $original = false): ?string
{
if ($seconds < 0 || $seconds > 7200) {
return null;
}
$file = $this->frameInput($version);
$file = $this->frameInput($version, $original);
if ($file === null) {
return null;
@@ -186,7 +210,7 @@ public function jpegAtVersion(ContentElementVersion $version, float $seconds): ?
'-frames:v',
'1',
'-vf',
'scale=640:-2',
$width === 640 ? 'scale=640:-2' : 'scale=min('.max(160, min(2400, $width)).'\,iw):-2',
'-f',
'image2pipe',
'-vcodec',
+10
View File
@@ -37,6 +37,16 @@ public static function effectiveFor(mixed $path): ?self
return $alias instanceof self && $alias->everReleased() ? $alias : null;
}
/**
* Früherer Pfad, dessen übernommenes Medium inzwischen gelöscht wurde. Die Datei unter cms/ bleibt liegen, wird aber
* weder ausgeliefert noch als Bild gezeigt: Das Löschen des Mediums gilt auch für die frühere Adresse.
*/
public static function isRetired(mixed $path): bool
{
return is_string($path) && $path !== ''
&& self::query()->where('legacy_path', $path)->whereNull('content_element_id')->exists();
}
public function everReleased(): bool
{
$element = $this->element;
@@ -2,8 +2,14 @@
namespace App\Filament\Support;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Media\CompositionStill;
use App\Domain\Media\FilmStill;
use App\Domain\Media\WebsiteMedia;
use App\Filament\Resources\ContentElements\ContentElementResource;
use Filament\Notifications\Notification;
/**
@@ -31,6 +37,128 @@ public function openWebsiteImagePicker(string $pfad): void
$this->forceRenderForPicker();
}
/**
* Medien- und Materialkarte: das Vorschaubild des Films als Bild für die Website übernehmen. Es entsteht ein Bild
* im Medienmanager (einmal gespeichert), das im Bildfeld ausgewählt wird. Die Datei des Films bleibt geschützt.
*/
public function adoptFilmThumbnail(string $pfad, int $elementId): void
{
$this->adoptFilmStill($pfad, $elementId, fn (FilmStill $stills, ContentElement $film): ContentElement => $stills->fromThumbnail($film, auth('staff')->user()));
}
/**
* Medien- und Materialkarte: eine Stelle des Films wählen und als Bild für die Website übernehmen.
*/
public function adoptFilmFrame(string $pfad, int $elementId, string $sekunde): void
{
if (! is_numeric($sekunde)) {
Notification::make()->danger()->title('Bitte eine Zeitposition in Sekunden angeben.')->send();
return;
}
$this->adoptFilmStill($pfad, $elementId, fn (FilmStill $stills, ContentElement $film): ContentElement => $stills->fromSecond($film, (float) $sekunde, auth('staff')->user()));
}
/**
* Programm- und Modulkarte: das Vorschaubild des Programms oder Moduls als Bild für die Website übernehmen
* (Bild-Medium im Medienmanager, einmal kopiert).
*/
public function adoptCompositionThumbnail(string $pfad, int $compositionId): void
{
abort_unless(ContentElementResource::editor(), 403);
if ($this->imageTargetIsInvalid($pfad)) {
return;
}
$composition = Composition::query()->find($compositionId);
if (! $composition instanceof Composition) {
return;
}
$stills = app(CompositionStill::class);
try {
$still = $stills->fromThumbnail($composition, auth('staff')->user());
} catch (DomainRuleException $exception) {
Notification::make()->danger()->title($exception->getMessage())->send();
return;
}
data_set($this, $pfad, $still->id);
$this->announceAdoptedStill($still, $stills->reused, 'Dieses Vorschaubild war schon übernommen.');
}
/**
* @param callable(FilmStill, ContentElement): ContentElement $make
*/
private function adoptFilmStill(string $pfad, int $elementId, callable $make): void
{
abort_unless(ContentElementResource::editor(), 403);
if ($this->imageTargetIsInvalid($pfad)) {
return;
}
$film = ContentElement::query()->with('editorialContentKind')->find($elementId);
if (! $film instanceof ContentElement) {
return;
}
$stills = app(FilmStill::class);
try {
$still = $make($stills, $film);
} catch (DomainRuleException $exception) {
Notification::make()->danger()->title($exception->getMessage())->send();
return;
}
data_set($this, $pfad, $still->id);
$this->announceAdoptedStill($still, $stills->reused, 'Diese Stelle war schon übernommen.');
}
/** Nur das Bildfeld eines Widgets oder Abschnitts ist ein zulässiges Ziel (…image). */
private function imageTargetIsInvalid(string $pfad): bool
{
return preg_match('/^(data|mountedActions\.\d+\.data)(\.[A-Za-z0-9_-]+)+\.image$/', $pfad) !== 1;
}
/**
* Meldung nach dem tatsächlichen Stand des Bildes: neu angelegt, schon vorhanden und freigegeben, wird verarbeitet
* oder Website-Freigabe zurückgenommen (bleibt zurückgenommen).
*/
private function announceAdoptedStill(ContentElement $still, bool $reused, string $reusedText): void
{
$title = ($still->display_title ?: $still->working_title);
if (! $reused) {
Notification::make()
->success()
->title('Im Medienmanager angelegt: „'.$title.'“')
->body('Das Bild ist als Kartenbild ausgewählt. Nach der Verarbeitung wird es für die Website freigegeben; dort lässt sich die Freigabe auch zurücknehmen.')
->send();
return;
}
if (app(WebsiteMedia::class)->present($still) !== null) {
Notification::make()->success()->title('Bereits im Medienmanager: „'.$title.'“')->body($reusedText.' Das Bild ist als Kartenbild ausgewählt.')->send();
} elseif (blank($still->thumbnail_path) && blank($still->thumbnail_error)) {
Notification::make()->success()->title('Bereits im Medienmanager: „'.$title.'“')->body('Das Bild wird noch verarbeitet und danach für die Website freigegeben.')->send();
} else {
Notification::make()->warning()->title('Bild ausgewählt, aber nicht für die Website freigegeben: „'.$title.'“')
->body($reusedText.' Die Website-Freigabe wurde zurückgenommen. Das Bild erscheint öffentlich erst wieder, wenn sie im Medienmanager (Reiter „Website“) erneut gegeben wird.')
->persistent()
->send();
}
}
/**
* Filament rendert bei offenen Aktionsdialogen nur den Dialogteil neu; der Picker liegt darüber und braucht die
* ganze Seite.
@@ -14,6 +14,8 @@ public function show(string $path, WebsiteMedia $media): StreamedResponse
abort_if(str_contains($path, '..') || ! str_starts_with($path, 'cms/'), 404);
// Ein in den Medienmanager übernommenes Bild folgt dessen Website-Freigabe, auch unter der früheren Adresse.
abort_if(WebsiteMediaAlias::isRetired($path), 404);
$alias = WebsiteMediaAlias::effectiveFor($path);
abort_if($alias !== null && $media->present($alias->content_element_id) === null, 404);
@@ -0,0 +1,32 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Herkunft der Standbilder, die aus einem Film als Bild-Medium übernommen wurden (Medien- und Materialkarte).
* Additiv. Sie verhindert, dass dieselbe Filmstelle mehrfach als neues Medium entsteht, und hält fest, woher das
* Bild kommt. Das Standbild selbst ist ein gewöhnliches Medium (output_class bild) mit eigener Website-Freigabe.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('film_still_sources', function (Blueprint $table) {
$table->id();
$table->foreignId('film_element_id')->constrained('content_elements')->restrictOnDelete();
$table->foreignId('still_element_id')->constrained('content_elements')->restrictOnDelete();
$table->string('source_key', 120);
$table->unsignedBigInteger('actor_id')->nullable();
$table->timestamps();
$table->unique(['film_element_id', 'source_key']);
});
}
public function down(): void
{
Schema::dropIfExists('film_still_sources');
}
};
@@ -0,0 +1,44 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* „Medium löschen“ (Medien ohne Fassung) muss auch Standbilder aus Filmen und übernommene CMS-Bilder erreichen.
*
* - film_still_sources: Die Herkunftszeile eines gelöschten Standbilds entfällt (cascade); dieselbe Stelle kann neu
* übernommen werden.
* - website_media_aliases: Die Zuordnung bleibt als Sperre bestehen (content_element_id wird leer). Ein früherer Pfad
* mit gelöschtem Medium wird nicht wieder über /medien/cms/… ausgeliefert und nicht mehr als Bild gezeigt.
*
* Lockert nur Fremdschlüssel; bestehende Daten bleiben unverändert (rückwärtskompatibel).
*/
return new class extends Migration
{
public function up(): void
{
Schema::table('film_still_sources', function (Blueprint $table) {
$table->dropForeign(['still_element_id']);
});
Schema::table('film_still_sources', function (Blueprint $table) {
$table->foreign('still_element_id')->references('id')->on('content_elements')->cascadeOnDelete();
});
Schema::table('website_media_aliases', function (Blueprint $table) {
$table->dropForeign(['content_element_id']);
});
Schema::table('website_media_aliases', function (Blueprint $table) {
$table->unsignedBigInteger('content_element_id')->nullable()->change();
});
Schema::table('website_media_aliases', function (Blueprint $table) {
$table->foreign('content_element_id')->references('id')->on('content_elements')->nullOnDelete();
});
}
public function down(): void
{
// Bewusst leer: Die gelockerten Fremdschlüssel schaden älterem Code nicht, und leere Zuordnungen
// (gelöschte Medien) ließen sich nicht in den strengeren Zustand zurückführen.
}
};
@@ -0,0 +1,32 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Herkunft der Bild-Medien, die aus dem Vorschaubild eines Programms oder Moduls übernommen wurden
* (Programm- und Modulkarte). Additiv. Verhindert, dass dasselbe Vorschaubild mehrfach als neues Medium entsteht.
* Das übernommene Bild ist ein gewöhnliches Medium (output_class bild) mit eigener Website-Freigabe.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('composition_still_sources', function (Blueprint $table) {
$table->id();
$table->foreignId('composition_id')->constrained('compositions')->cascadeOnDelete();
$table->foreignId('still_element_id')->constrained('content_elements')->cascadeOnDelete();
$table->string('source_key', 120);
$table->unsignedBigInteger('actor_id')->nullable();
$table->timestamps();
$table->unique(['composition_id', 'source_key']);
});
}
public function down(): void
{
Schema::dropIfExists('composition_still_sources');
}
};
@@ -0,0 +1,42 @@
# Programm- und Modulkarte: Textwahl und Bild, Filmbild-Regler – Bericht (21.11.2026)
Branch `feature/karten-text-und-bild-programm`, separater Worktree, Deploy ausschließlich über `develop` (Testinstanz), kein Merge nach `main`. Baut auf `medienkarte-text-und-filmbild-bericht-2026-11-21.md` auf. Technik: `medienzugriff-fuer-komponenten.md`, Registry §13, ADR-39.
## 1. Rückmeldung aus der Abnahme und Umsetzung
| Rückmeldung | Umsetzung |
|---|---|
| Der Bildwähler aus dem Film ist nicht gelungen; im Medienmanager gibt es einen Regler, der das Bild fast in Echtzeit zeigt | Der Dialog arbeitet jetzt wie der Medienmanager: Regler und Zahlenfeld zeigen dieselbe Zeitposition, das Bild der Stelle folgt dem Regler nach kurzer Pause (ohne weiteren Knopf), „Diese Stelle übernehmen“ legt genau die angezeigte Stelle ab. Das im Medienmanager gesetzte Vorschaubild des Films lässt sich mit kleiner Ansicht daneben übernehmen. Der Regler reicht bis 120 s und wächst mit dem Zahlenfeld (bis 7200 s). |
| Textwahl soll auch an der Programm- und Modulkarte gelten | „Text der Karte“: Automatisch (wie bisher: Teaser, sonst Kurzbeschreibung, sonst Lernziel), Teaser, Kurzbeschreibung, Ausführliche Beschreibung, **Lernziel der Fassung**. Gelesen mit der Zielgruppe „Öffentliche Kachel“. Eine ausdrückliche Wahl ersetzt nicht still; die Vorschau nennt „Programm oder Modul bearbeiten → …“. |
| Die übrigen Anpassungen auch für Programm und Modul | Das Vorschaubild des Programms oder Moduls lässt sich als Bild-Medium übernehmen („Vorschaubild übernehmen“, `CompositionStill`), einmal kopiert, dieselbe Datei ergibt dasselbe Medium, ehrliche Meldung auch bei zurückgenommener Freigabe. |
Die Themenkarte hat nur einen Text („Text für die Website“) und bekommt deshalb keine Wahl.
## 2. Prüfung
| Prüfung | Ergebnis |
|---|---|
| Testsuite, Pint | 459 grün, Pint sauber (neu: 6 Tests Programm- und Modulkarte; bewusst geändert: die Programmkarte hat jetzt eine Textwahl) |
| CI und Deploy | CI 4987, Deploy 4988 (Commit `3825f53`) |
| Oberfläche lokal, echter Test-Film | Filmkarte 19/19 (Regler bewegt, Bild folgt, Zahl und Regler gleich), Programmkarte 13/13 |
| Testinstanz, Filmkarte „Lara im Park“, regulärer Seitenkonfigurator | **23 von 23**: Regler und Bild sofort da, Bild folgt dem Regler, Zahleneingabe führt es nach, Stelle übernommen (1600 px), dieselbe Stelle ergibt dasselbe Medium, vier Textstufen entsprechen den gepflegten Feldern, interne Angaben nie sichtbar, Rücknahme der Freigabe verifiziert (404) |
| Testinstanz, Modul „UX-Pilot Entwurf“ (Kurzbeschreibung, Beschreibung, Lernziel, Vorschaubild) | **15 von 15**: Vorschaubild übernommen und wiederverwendet, Textwahl mit Lernziel, nicht gepflegter Teaser zeigt keinen Text, Karten nennen „Modul“, Entwurf öffentlich nicht erreichbar |
| Aufräumen auf der Testinstanz | die angelegten Bilder 27, 28, 29 über „Medium löschen“ entfernt, Herkunftszeilen mit gelöscht (Datenbank geprüft) |
| Bestehende Seiten vor und nach dem Deploy | unverändert (16 Messungen, 12 Textvergleiche) |
**Nicht live gezeigt:** die öffentliche Darstellung der Karten auf einer veröffentlichten Seite der Testinstanz (nur Entwürfe); die öffentlichen Regeln belegen die Feature-Tests.
## 3. Auf der Testinstanz zurückgeblieben
- Entwürfe `/medienkarte-regler-entwurf` (Seite 24) und `/programmkarte-regler-entwurf` (Seite 25) sowie ältere Prüfentwürfe. Seiten lassen sich nicht löschen.
- Das Standbild „Standbild: Felix beim Onkel (Fassung 1, 22,5 s)“ (Medium 26, freigegeben) stammt nicht von dieser Arbeit (angelegt 19:51, vermutlich bei der Abnahme); unangetastet.
## 4. Grenzen
- Das übernommene Programm-Vorschaubild hat die Größe der Vorschaudatei (640 px); für ein breites Kartenbild reicht das, für ein Hero nicht. Ein Film-Standbild kommt bis 1600 px aus der Mediendatei.
- Eine Filmstelle direkt für ein Programm zu wählen gibt es nicht; das Vorschaubild des Programms lässt sich im Redaktionsmanager aus einem Film setzen und dann übernehmen.
- Das übernommene Bild folgt späteren Änderungen am Vorschaubild nicht (eigenes Medium).
## 5. Prod
Die Vorbereitung des Merges `develop` → `main` (Inhalt, Migrationen, Prod-Stand, Entscheidungen) steht in `docs/betrieb/Release-Vorbereitung_2026-11-21.md`. Den Merge löst Lars in Gitea aus.
@@ -0,0 +1,75 @@
# Medien- und Materialkarte: Textwahl und Bild aus dem Film – Bericht (21.11.2026)
Branch `feature/medienkarte-text-und-filmbild`, gearbeitet in einem separaten Worktree, Deploy ausschließlich über `develop` (Testinstanz). Kein Merge nach `main`. Technik: `docs/architektur/medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“, und `cms-widget-registry.md` §13.
## 1. Anforderung 1: Text der Karte wählen
**Ausgangslage.** Die Karte nahm immer die Kurzbeschreibung, den Teaser nur als Ersatz, die ausführliche Beschreibung nie.
**Jetzt.** Im Reiter „Darstellung“ der Medienkarte gibt es „Text der Karte“:
| Wahl | Text |
|---|---|
| Automatisch (Vorgabe) | Kurzbeschreibung, sonst Teaser, unverändert zu vorher; bestehende Karten ändern sich nicht |
| Teaser | `teaser` |
| Kurzbeschreibung | `summary` |
| Ausführliche Beschreibung | `description`, der Dialog nennt „erscheint öffentlich“ |
- Eine ausdrückliche Wahl ersetzt **nicht still** durch ein anderes Feld. Ist der Text nicht gepflegt, bleibt die Karte ohne Text; die Redaktionsvorschau nennt, wo er zu pflegen ist (öffentlich nie ein Hinweis).
- Der eigene Text der Karte („Text nur für diese Karte“) hat weiter Vorrang. Sein Platzhalter im Editor zeigt jetzt den gewählten zentralen Text.
- Einsatzhinweis und Lizenzvermerk sind nicht wählbar und erscheinen nie.
- Die Wahl gibt es nur an der Medienkarte, nicht an Themen- und Programmkarte.
**Entschieden durch diese Arbeit:** Die **ausführliche Beschreibung ist auf ausdrückliche Wahl öffentlich**, bisher war sie Bibliothekstext. Die Doku (`medienzugriff-fuer-komponenten.md`) stand dem entgegen und ist angepasst. Öffentlich ist die Karte weiterhin nur, wenn das Medium zu einem öffentlich gezeigten Programm gehört.
## 2. Anforderung 2: Bild aus dem Film
**Ursache der Sperre.** Das Vorschaubild eines Films ist ein geschütztes Bibliotheksbild und für die Website nicht freigegeben. `WebsiteRelease` kann bei Filmen nur ein Teaser-Video freigeben, kein Standbild. Die Karte zeigte es deshalb nur in der Redaktionsvorschau.
**Lösung, ohne neue Freigabelogik.** Im Reiter „Medien“ der Medienkarte erscheint bei einem Film das Feld „Bild aus dem Film“:
1. **„Vorschaubild des Films übernehmen“**: übernimmt das im Medienmanager gesetzte Vorschaubild. Stammt es aus einer Filmstelle, wird dieselbe Stelle in voller Auflösung neu gezogen.
2. **Stelle wählen**: Zeitposition eingeben, „Anzeigen“ (Vorschau), „Dieses Bild übernehmen“.
`FilmStill` zieht das Einzelbild **einmal** und legt es über das vorhandene `WebsiteIntake` als gewöhnliches Bild-Medium im Medienmanager ab. Die Warteschlange leitet es ab und gibt es frei, wie bei jedem Upload aus dem CMS. Die Karte speichert nur dessen Kennung in `refs.image`.
- **Kein Neuziehen bei Seitenaufrufen:** Die Karte liest nur die gespeicherte Datei. Ein Test zählt die Extraktionen: Drei Seitenaufrufe starten keine.
- **Einmal je Stelle:** Dieselbe Stelle (auch über den anderen Weg) ergibt dasselbe Medium. Eine neue Tabelle `film_still_sources` (additiv) hält die Herkunft fest.
- **Auflösung:** bis 1600 px Breite aus der Mediendatei, nie über die Breite der Quelle hinaus vergrößert. Geprüft mit echten Videos: 1280 px bleiben 1280, 2560 px werden 1600. Auf der Testinstanz kamen Bilder mit 1600 px aus dem Film.
- **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, dieselbe Rolle wie beim Upload). Das entstandene Bild lässt sich im Medienmanager („Website“) wieder zurücknehmen.
- **Das Bild ist ein eigenes Medium** („Standbild: {Film} (Fassung n, x s)“, Alternativtext „Szene aus dem Film …“, Quellenzeile des Films). Es folgt späteren Änderungen am Vorschaubild des Films nicht. Wer es als Titelbild des Films für alle Karten nutzen will, ordnet es im Medienmanager als Präsentationsmedium zu.
## 3. Prüfung
| Prüfung | Ergebnis |
|---|---|
| Testsuite | 453 grün (davon neu: 4 Textwahl, 9 Filmbild einschließlich Wiederverwendung, gescheiterte Verarbeitung, Löschen). Die Extraktion (`ffmpeg`) ist dort gestubbt. |
| CI und Deploy | CI 4983 und Deploy 4984 für den ersten Stand (Commit `886715a`); die Korrektur (`cd66561`) steht in der Übergabe. |
| `ffmpeg`-Skalierung | mit echten Videos geprüft (siehe oben) |
| Bestehende Seiten vor und nach dem Deploy | unverändert: 16 Messungen der Geometrie, 12 Textvergleiche, 16 Bilder |
| Oberfläche lokal (echter Test-Film) | 16 von 16 |
| Oberfläche auf der Testinstanz, regulärer Seitenkonfigurator, Film „Lara im Park“ mit allen drei Texten | **16 von 16**: Vorschaubild übernommen (Stelle 41,5 s), eine Stelle gewählt (12 s), dieselbe Stelle noch einmal ergab dasselbe Medium, Textwahl in allen vier Stufen entspricht den gepflegten Feldern, Einsatzhinweis und Lizenzvermerk erschienen nie, wieder geöffnet, Vorschau zeigt das gespeicherte Bild über `/website-medien/…` (1600 px), Entwurf öffentlich nicht erreichbar |
| Rücknahme der angelegten Bilder auf der Testinstanz | beide Medien zurückgenommen, `/website-medien/…` liefert 404 |
**Nicht live gezeigt:** Die öffentliche Darstellung der Karte auf einer veröffentlichten Seite der Testinstanz. Es durfte nur ein Entwurf entstehen. Die öffentlichen Regeln belegen die Feature-Tests.
**Beim Prüfen gefunden und behoben (Commit `cd66561`):**
- Wählt die Redaktion eine schon übernommene, inzwischen zurückgenommene Stelle erneut, bekam sie dasselbe Bild zurück, die Meldung versprach aber eine Freigabe. Jetzt nennt die Meldung den tatsächlichen Stand (bereits freigegeben, wird verarbeitet, Freigabe zurückgenommen) und weist auf den Medienmanager hin. Ein bei der Verarbeitung gescheitertes oder archiviertes Bild wird nicht wiederverwendet.
- „Medium löschen“ wäre bei Standbildern und, aus meiner früheren Umstellung, bei übernommenen CMS-Bildern an einem Fremdschlüssel gescheitert. Das Löschen funktioniert jetzt; ein gelöschtes übernommenes Medium macht seine frühere Adresse nicht wieder öffentlich (404, kein Bild).
## 4. Auf der Testinstanz zurückgeblieben
- Entwurf `/medienkarte-pruefung-entwurf` (Seite 23); seine Karte A verweist auf das zurückgenommene Standbild.
- Die Medien „Standbild: Lara im Park (Fassung 1, 41,5 s)“ und „… (Fassung 1, 12 s)“, beide zurückgenommen.
- Aus früheren Prüfungen: die Entwürfe `/karten-nachbesserung-entwurf` und `/medien-pruefung-entwurf` sowie das Medium „Platzhalter Upload Medienpruefung“.
Seiten lassen sich nicht löschen; die Medien über „Medium löschen“ im Medienmanager.
## 5. Grenzen und offene Fragen
1. **Vorschau und übernommenes Bild:** Die Vorschau im Dialog kommt aus der kleinen Stufe (640 px), das übernommene Bild aus der Mediendatei. Beim Springen auf dieselbe Sekunde können beide minimal abweichen.
2. **Das Bild folgt dem Film nicht.** Ändert die Redaktion später das Vorschaubild des Films, bleibt die Karte beim übernommenen Bild.
3. **Das übernommene Bild ist ein eigenes Medium und hat eigene Rechte:** Wird der Film zurückgezogen, bleibt das Bild, solange es nicht ausdrücklich zurückgenommen wird.
4. **Frage:** Sollen Karten die Zielgruppe `cms` („CMS-Teaser“) statt `bibliothek` für abweichende Formulierungen lesen? Heute wird `cms` nirgends gelesen; ein Wechsel würde bestehende Karten ändern.
5. **Frage:** Die Programmkarte nimmt zuerst den Teaser, die Medienkarte zuerst die Kurzbeschreibung. Soll das einheitlich werden?
6. **Weiter offen:** eine öffentliche Filmvorschau (Trailer, Ausschnitt) und die Laufzeit, siehe Registry §13.
@@ -518,6 +518,8 @@ ## 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`.
**Nachbesserung 3 (21.11.2026, nach Betreiberprüfung).** Der Bildwähler im Dialog arbeitet wie im Medienmanager (Regler, Zahlenfeld, Live-Bild). Die Textwahl gilt auch an der Programm- und Modulkarte (zusätzlich Lernziel); deren Vorschaubild lässt sich wie ein Filmbild als Bild-Medium übernehmen (`CompositionStill`, additive Tabelle `composition_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 Karte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`; an der Programm- und Modulkarte zusätzlich `goal`, das Lernziel der Fassung). `auto` entspricht dem bisherigen Verhalten je Karte (Medien: Kurzbeschreibung, sonst Teaser; Programm und Modul: Teaser, sonst Kurzbeschreibung, sonst Lernziel); die Themenkarte hat nur einen Text und keine Wahl. 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: eine Stelle mit Regler und Live-Bild wählen („Diese Stelle übernehmen“) oder „Vorschaubild des Films übernehmen“. An der Programm- und Modulkarte entsprechend „Vorschaubild übernehmen“ (`CompositionStill`). `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.
@@ -129,6 +129,7 @@ ### Übernahme der früheren CMS-Bilder
(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)
@@ -137,4 +138,47 @@ ## 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 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.
@@ -0,0 +1,62 @@
# Release-Vorbereitung develop → main (21.11.2026)
Vorbereitet von Claude. **Den Merge nach `main` löst Lars in Gitea aus** (Pull Request `develop` → `main`, nach Prüfung des Teststands). Claude merged, pusht und deployt nicht nach `main`. Ein Merge löst über `deploy-prod.yml` sofort das Produktiv-Deployment aus.
Stand: `develop` mit der Programm- und Modulkarte (Commit `3825f53` plus die Dokumentation dieser Übergabe), `main` auf `759b3e1` (PR #2).
## 1. Inhalt (18 Commits, 338 Dateien)
| Bereich | Inhalt | Von |
|---|---|---|
| Medien- und Materialkarte | Text der Karte wählen (Teaser, Kurzbeschreibung, Ausführliche Beschreibung); Bild aus dem Film (Regler mit Live-Bild, Vorschaubild übernehmen) | Claude |
| Programm- und Modulkarte | Text der Karte wählen (zusätzlich Lernziel); Vorschaubild als Website-Bild übernehmen | Claude |
| Medienmanager | „Medium löschen“ erreicht Standbilder und übernommene CMS-Bilder (Fremdschlüssel gelockert) | Claude |
| Fachliche Säulen | Vereinheitlichung auf die zentrale Säulenverwaltung | Lars (anderer Rechner) |
| Shop | Shop-Verwaltung, Warenkorb, Artikel/Paket/Angebot mit Voraussetzungen, Mehrpositionen-Kasse, Organisationskäufe | Lars (anderer Rechner) |
| Dokumentation | Anforderungen FACH-56 bis FACH-59, Brand-UI-Kit 1.2 bis 1.7 ohne Originalmotive, Berichte | beide |
Der Shop-Teil ist umfangreich (neue Tabellen, Routen, Kasse, Tests). Ich habe ihn nicht inhaltlich geprüft; die Abnahme steht in `docs/ux/verwaltung/abnahme/`.
**Fakten zum Shop nach dem Merge (aus dem Code geprüft):**
- **In Produktion nicht erreichbar.** `/shop`, `/warenkorb…` und `/kasse` liegen hinter `EnsureShopEnabled`; `Shop::enabled()` ist nur wahr, wenn die Umgebung **nicht** Produktion ist und der Zahlungstreiber `test` gilt („Etappe 1 erteilt keine Produktivfreigabe“). Prod läuft als `APP_ENV=production` (lesend bestätigt): Alle Shop-Adressen antworten dort mit 404, der Kopflink erscheint nicht.
- **Keine neuen Umgebungsschlüssel.** Gegenüber `main` gibt es keinen neuen `env()`-Zugriff, `.env.example`, `docker-compose.yml` und `scripts/deploy.sh` sind unverändert. `/etc/luf/prod.env` braucht nichts Neues (die Datei selbst habe ich nicht geöffnet). Die bisherigen Werte `LUF_CART_ENABLED` und `LUF_CART_URL` werden nicht mehr gelesen.
- **Folge:** Der Shop schadet in Prod nicht, ist aber auch nicht nutzbar. Er wird dort erst mit einer späteren Produktivfreigabe aktiv.
- **Entscheidung für Lars:** Mit diesem Merge nach Prod, oder die Shop-Commits erst später? (Eine Trennung wäre nur über einen eigenen Branch ohne die Shop-Commits möglich.)
## 2. Teststand
- Testsuite lokal: 459 grün, Pint sauber. Gate in Gitea (`ci-feature`, `develop`): CI 4987 und Deploy 4988 grün für den Stand der Karten.
- Die neuen Karten und Bildwähler sind in einem echten Browser gegen die Testinstanz (`luf-test`) im regulären Seitenkonfigurator geprüft (Berichte `docs/analysen/medienkarte-text-und-filmbild-bericht-2026-11-21.md` und `karten-text-und-bild-programm-bericht-2026-11-21.md`).
- Nicht gezeigt: die öffentliche Darstellung der neuen Karten auf einer veröffentlichten Seite der Testinstanz (nur Entwurf); die öffentlichen Regeln belegen die Feature-Tests.
## 3. Migrationen (Prod steht bei der 32. Migration `2026_11_20_200000_editorial_master_data_management`)
| Migration | Wirkung | Rückwärtskompatibel |
|---|---|---|
| `2026_11_21_100000_unify_pillar_assignments` | neue Tabellen `composition_pillar`, `license_article_pillar`, Anpassung `editorial_dimension_values` | ja, additiv |
| `2026_11_21_120000_create_film_still_sources` | neue Tabelle | ja |
| `2026_11_21_130000_add_shop_foundation` | Spalten an `offers`, `orders`, `order_lines`, `acquisitions`, neue Tabelle `memberships`, Rückrechnung bestehender Bestellungen | additiv; Daten werden berechnet, nicht gelöscht |
| `2026_11_21_130000_allow_deleting_media_with_stills_and_aliases` | lockert zwei Fremdschlüssel (`film_still_sources`, `website_media_aliases`) | ja, lockert nur |
| `2026_11_21_140000_create_composition_still_sources` | neue Tabelle | ja |
Keine bestehende Migration wurde geändert. Verglichen mit der Migrationstabelle von Prod (lesend): Prod hat 32 angewendet, `develop` 37 Dateien, **genau diese fünf sind ausstehend**, nichts auf Prod fehlt in `develop`. Prod hat 0 Bestellungen; die Rückrechnung in `add_shop_foundation` hat dort nichts zu tun. Der Rollback des Deploy-Skripts setzt nur den Code zurück, nicht die Datenbank; die neuen Tabellen und gelockerten Schlüssel stören älteren Code nicht.
## 4. Stand von Prod (lesend geprüft, 21.11.2026)
- 8 Seiten, alle veröffentlicht; 2 Medien (1 Bild, 1 Film), 1 davon für die Website freigegeben; **keine fachlichen Säulen** (Themenkarte hat dort noch nichts zur Auswahl); keine früheren CMS-Bilder unter `cms/` (die Bildübernahme früherer Bilder ist dort ohne Wirkung).
- Alle Container laufen; der Queue-Container startet planmäßig stündlich neu.
- Voraussetzungen für Bilder aus dem Film: `ffmpeg` ist im Image (`Dockerfile`); Warteschlange schreibt `public/derived/originals` (wie bisher).
## 5. Was Lars nach dem Deploy für die Pflege der Webseite wissen sollte
- Themenkarte: erst Säulen anlegen und veröffentlichen (mit Adresse und „Text für die Website“), sonst bleibt sie leer.
- Medienkarte und Programm-/Modulkarte erscheinen öffentlich nur, wenn das Medium bzw. Programm die Freigaberegeln erfüllt (Medium im öffentlichen Programm, Programm mit Anzeigefreigabe; Module nie).
- **Ausführliche Beschreibung** wird öffentlich, sobald sie als Kartentext gewählt wird. Trainermaterialien vorher als „Traineranleitung“ einordnen (die erscheinen nie öffentlich).
- Ein Bild aus einem Film oder aus dem Vorschaubild eines Programms entsteht als eigenes Bild im Medienmanager und wird nach der Verarbeitung automatisch für die Website freigegeben; die Freigabe lässt sich im Medienmanager (Reiter „Website“) zurücknehmen.
## 6. Ablauf (nur Lars)
1. Teststand und Shop-Entscheidung prüfen.
2. Pull Request `develop` → `main` in Gitea anlegen und nach Prüfung zusammenführen.
3. Der Workflow `deploy-prod.yml` testet und deployt; den Verlauf in Gitea beobachten.
4. Nach dem Deploy: Prod-Seiten und die neuen Karten ansehen (`/`, eine Seite mit Karte).
@@ -120,6 +120,7 @@ .lf-pc .lf-pc__title {
}
.lf-pc__summary {
white-space: pre-line;
margin: 0;
color: var(--color-text-muted);
}
@@ -0,0 +1,54 @@
{{--
Medien- und Materialkarte, Reiter „Medien“: ein Bild aus dem Film als Kartenbild übernehmen.
Bedienung wie im Medienmanager: Regler und Zahlenfeld zeigen dieselbe Zeitposition, das Bild der Stelle folgt
dem Regler nach kurzer Pause (Route editorial.frame, nur angemeldete Redaktion). „Diese Stelle übernehmen“ legt genau
die angezeigte Stelle einmal als Bild-Medium im Medienmanager ab (FilmStill) und wählt es als Kartenbild.
Die Datei des Films bleibt geschützt; übernommen wird nur ein Einzelbild bis 1600 px Breite.
--}}
@php
$pfad = $getStatePath();
$ziel = preg_replace('/[^.]+$/', 'image', $pfad);
$framePfad = $filmVersionId !== null ? route('editorial.frame', ['version' => $filmVersionId]) : null;
@endphp
<x-dynamic-component :component="$getFieldWrapperView()" :field="$field">
<div class="luf-filmbild"
x-data="{ second: @js((string) $filmStartSecond), shown: @js((string) $filmStartSecond), base: @js($framePfad), ziel: @js($ziel), id: {{ (int) $film->id }},
show() { if (this.second !== '' && ! isNaN(Number(this.second)) && Number(this.second) >= 0) { this.shown = this.second; } } }">
<p class="luf-filmbild-lead">
Aus dem Film „{{ $filmTitle }}“ ein Bild für die Website übernehmen. Das Bild wird einmal gespeichert und im
Medienmanager als Bild angelegt. Der Film selbst wird nicht veröffentlicht; die Karte spielt nichts ab.
</p>
@if ($framePfad !== null)
<div class="luf-filmbild-regler">
<label class="luf-filmbild-label" for="filmbild-stelle-{{ $film->id }}">Zeitposition in Sekunden</label>
<input id="filmbild-stelle-{{ $film->id }}" type="range" min="0" step="0.5"
:max="Math.max(120, Math.ceil(Number(second) || 0))" x-model="second" x-on:input.debounce.250ms="show()">
<input type="number" min="0" max="7200" step="0.1" class="luf-filmbild-second" aria-label="Zeitposition als Zahl"
x-model="second" x-on:input.debounce.250ms="show()">
</div>
<img class="luf-filmbild-bild" :src="base + '?sekunde=' + encodeURIComponent(shown)" alt="Vorschau der gewählten Filmstelle">
<div>
<x-filament::button color="primary" size="sm" icon="heroicon-o-check-circle" type="button" wire:loading.attr="disabled"
x-on:click="$wire.adoptFilmFrame(ziel, id, String(shown))">
Diese Stelle übernehmen
</x-filament::button>
</div>
@else
<p class="luf-filmbild-lead">Der Film hat noch keine bereitgestellte Fassung; eine Stelle lässt sich erst danach wählen.</p>
@endif
@if ($filmHasThumbnail)
<div class="luf-filmbild-aktuell">
@if ($filmThumbnailUrl)
<img src="{{ $filmThumbnailUrl }}" alt="Aktuelles Vorschaubild des Films">
@endif
<div>
<p class="luf-filmbild-lead">Oder das Vorschaubild übernehmen, das im Medienmanager für diesen Film gesetzt ist.</p>
<x-filament::button color="gray" size="sm" icon="heroicon-o-photo" type="button" wire:loading.attr="disabled"
wire:click="adoptFilmThumbnail({{ \Illuminate\Support\Js::from($ziel) }}, {{ (int) $film->id }})">
Vorschaubild des Films übernehmen
</x-filament::button>
</div>
</div>
@endif
</div>
</x-dynamic-component>
@@ -0,0 +1,33 @@
{{--
Programm- und Modulkarte, Reiter „Medien“: das Vorschaubild des Programms oder Moduls als Kartenbild übernehmen.
Das Vorschaubild ist ein geschütztes Bibliotheksbild und erscheint öffentlich nie. „Vorschaubild übernehmen“ legt es
einmal als Bild-Medium im Medienmanager ab (CompositionStill) und wählt es als Kartenbild; die Website-Freigabe
geschieht dort nach der Verarbeitung automatisch und lässt sich zurücknehmen.
--}}
@php
$ziel = preg_replace('/[^.]+$/', 'image', $getStatePath());
@endphp
<x-dynamic-component :component="$getFieldWrapperView()" :field="$field">
<div class="luf-filmbild">
@if ($compositionThumbnailUrl)
<div class="luf-filmbild-aktuell">
<img src="{{ $compositionThumbnailUrl }}" alt="Aktuelles Vorschaubild von „{{ $compositionTitle }}“">
<div>
<p class="luf-filmbild-lead">
Das Vorschaubild von „{{ $compositionTitle }}“ aus dem Redaktionsmanager als Bild für die Website
übernehmen. Es wird einmal gespeichert und im Medienmanager als Bild angelegt.
</p>
<x-filament::button color="gray" size="sm" icon="heroicon-o-photo" type="button" wire:loading.attr="disabled"
wire:click="adoptCompositionThumbnail({{ \Illuminate\Support\Js::from($ziel) }}, {{ (int) $composition->id }})">
Vorschaubild übernehmen
</x-filament::button>
</div>
</div>
@else
<p class="luf-filmbild-lead">
„{{ $compositionTitle }}“ hat noch kein Vorschaubild. Es lässt sich im Redaktionsmanager setzen und danach hier übernehmen,
oder ein anderes Bild oben auswählen.
</p>
@endif
</div>
</x-dynamic-component>
@@ -86,6 +86,19 @@
.luf-media-badge-warn { background: #fff1c7; color: #6b4b00; }
.luf-media-badge-wait { background: #e5eef8; color: #18456f; }
.luf-media-badge-quiet { background: #eceff1; color: #3e4c5c; }
/* Medien- und Materialkarte: Bild aus dem Film übernehmen. */
.luf-filmbild { display: flex; flex-direction: column; gap: .75rem; padding: .75rem; border: 1px solid #d5ddd6; border-radius: .5rem; }
.luf-filmbild-lead { margin: 0; font-size: .875rem; }
.luf-filmbild-frame { display: flex; flex-wrap: wrap; align-items: flex-end; gap: .75rem; }
.luf-filmbild-label { display: flex; flex-direction: column; gap: .25rem; font-size: .875rem; }
.luf-filmbild-second { width: 8rem; padding: .35rem .5rem; border: 1px solid #b9c4bd; border-radius: .375rem; }
.luf-filmbild-regler { display: flex; flex-wrap: wrap; align-items: center; gap: .75rem; }
.luf-filmbild-regler input[type=range] { flex: 1 1 14rem; min-width: 10rem; }
.luf-filmbild-bild { width: 100%; max-width: 28rem; height: auto; border-radius: .375rem; background: #eef1ee; }
.luf-filmbild-aktuell { display: flex; gap: .75rem; align-items: flex-start; padding-top: .5rem; border-top: 1px solid #e3e8e4; }
.luf-filmbild-aktuell img { width: 9rem; height: auto; border-radius: .375rem; background: #eef1ee; }
.luf-filmbild-preview { display: flex; flex-direction: column; gap: .5rem; align-items: flex-start; width: 100%; }
.luf-filmbild-preview img { width: 100%; max-width: 28rem; height: auto; border-radius: .375rem; background: #eef1ee; }
.luf-media-status { display: flex; gap: 1rem; align-items: flex-start; padding: .75rem; border: 1px solid #d5ddd6; border-radius: .5rem; }
.luf-media-status img { width: 10rem; height: auto; border-radius: .375rem; }
.luf-media-status strong { display: block; }
@@ -24,7 +24,7 @@
$panelName = ['catalog' => 'die Navy-Tafel', 'film' => 'die Filmtafel', 'material' => 'das Materialsymbol'][$subject->visual] ?? 'die Karte ohne Bild';
if ($context->preview && $imageUrl === null) {
$hints[] = $subject->previewImage !== null
? 'Das Vorschaubild der Bibliothek ist nicht für die Website freigegeben; öffentlich erscheint stattdessen '.$panelName.'. Ein freigegebenes Motiv kann im Reiter „Medien“ als Kartenbild gewählt werden.'
? 'Das Vorschaubild der Bibliothek ist nicht für die Website freigegeben; öffentlich erscheint stattdessen '.$panelName.'. Ein freigegebenes Motiv kann im Reiter „Medien“ als Kartenbild gewählt werden'.($subject->visual === 'film' ? '; bei einem Film genügt „Vorschaubild des Films übernehmen“.' : '.')
: 'Kein Kartenbild gewählt; öffentlich erscheint '.$panelName.' (Kartenbild im Reiter „Medien“).';
}
@endphp
+175
View File
@@ -0,0 +1,175 @@
<?php
namespace Tests\Feature;
use App\Domain\Catalog\CompositionDisplayRelease;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Cms\Page;
use App\Domain\Cms\PageRevision;
use App\Domain\Cms\PageService;
use App\Domain\Cms\Widgets\WidgetRegistry;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Validation\ValidationException;
use Tests\Support\BuildsCatalog;
use Tests\TestCase;
/**
* Medien- und Materialkarte: Die Redaktion wählt, welcher zentrale Text (Teaser, Kurzbeschreibung, ausführliche
* Beschreibung) auf der Karte erscheint. Ohne Wahl gilt wie bisher die Kurzbeschreibung, sonst der Teaser.
*/
class CmsMediaCardTextTest extends TestCase
{
use BuildsCatalog;
use RefreshDatabase;
public function test_the_card_shows_the_text_the_editor_chose_and_the_default_stays_unchanged(): void
{
$film = $this->publicFilm();
$this->publish('/textwahl', [
$this->card($film, []),
$this->card($film, ['text_source' => 'auto']),
$this->card($film, ['text_source' => 'teaser']),
$this->card($film, ['text_source' => 'summary']),
$this->card($film, ['text_source' => 'description']),
]);
$cards = $this->cards($this->get('/textwahl')->assertOk()->getContent());
$this->assertCount(5, $cards);
$this->assertStringContainsString('KURZ-TEXT', $cards[0]);
$this->assertStringContainsString('KURZ-TEXT', $cards[1]);
$this->assertStringContainsString('TEASER-TEXT', $cards[2]);
$this->assertStringNotContainsString('KURZ-TEXT', $cards[2]);
$this->assertStringContainsString('KURZ-TEXT', $cards[3]);
$this->assertStringContainsString('LANG-TEXT', $cards[4]);
$this->assertStringContainsString('zweiter Absatz', $cards[4]);
foreach ($cards as $index => $card) {
foreach (['EINSATZ-INTERN', 'LIZENZ-INTERN'] as $internal) {
$this->assertStringNotContainsString($internal, $card, "Karte $index: Einsatzhinweis und Lizenzvermerk bleiben intern.");
}
}
foreach ([0, 1, 2, 3] as $index) {
$this->assertStringNotContainsString('LANG-TEXT', $cards[$index], 'Die ausführliche Beschreibung erscheint nur auf ausdrückliche Wahl.');
}
}
public function test_the_default_falls_back_to_the_teaser_but_an_explicit_choice_does_not(): void
{
$film = $this->publicFilm(['summary' => null]);
$revision = $this->publish('/textwahl-ersatz', [
$this->card($film, []),
$this->card($film, ['text_source' => 'summary']),
]);
$cards = $this->cards($this->get('/textwahl-ersatz')->assertOk()->getContent());
$this->assertStringContainsString('TEASER-TEXT', $cards[0], 'Vorgabe: ohne Kurzbeschreibung der Teaser, wie bisher.');
$this->assertStringNotContainsString('lf-pc__summary', $cards[1], 'Gewählte, nicht gepflegte Kurzbeschreibung: kein stiller Ersatz.');
$this->assertStringNotContainsString('TEASER-TEXT', $cards[1]);
$this->assertStringNotContainsString('Keine Kurzbeschreibung gepflegt', $this->get('/textwahl-ersatz')->getContent(), 'Hinweise erscheinen öffentlich nie.');
$this->assertStringNotContainsString('Für eine vollständige Karte', $this->get('/textwahl-ersatz')->getContent());
$preview = $this->actingAs(User::factory()->redakteur()->create(), 'staff')->get(route('pages.preview', $revision))->assertOk()->getContent();
$this->assertStringContainsString('Keine Kurzbeschreibung gepflegt (Medium bearbeiten → Kurzbeschreibung).', $preview);
}
public function test_the_own_text_of_the_card_wins_over_the_chosen_central_text(): void
{
$film = $this->publicFilm();
$this->publish('/textwahl-eigen', [
$this->card($film, ['text_source' => 'description'], ['summary' => 'EIGENER-KARTENTEXT']),
]);
$card = $this->cards($this->get('/textwahl-eigen')->assertOk()->getContent())[0];
$this->assertStringContainsString('EIGENER-KARTENTEXT', $card);
$this->assertStringNotContainsString('LANG-TEXT', $card);
}
public function test_the_choice_is_limited_to_the_three_central_texts_and_to_the_media_card(): void
{
$film = $this->publicFilm();
$registry = app(WidgetRegistry::class);
$this->assertSame(['auto', 'teaser', 'summary', 'description'], array_keys($registry->get('media_card')->settingOptions()['text_source']));
// Seit 21.11.2026 hat auch die Programm- und Modulkarte die Wahl (mit Lernziel); ein Thema hat nur einen Text.
$this->assertSame(['auto', 'teaser', 'summary', 'description', 'goal'], array_keys($registry->get('program_card')->settingOptions()['text_source']));
$this->assertArrayNotHasKey('text_source', $registry->get('topic_card')->settingOptions());
foreach (['usage_note', 'license_note', 'working_title'] as $internal) {
try {
$registry->normalize([['type' => 'media_card', 'v' => 1, 'variant' => 'adaptive', 'settings' => ['text_source' => $internal], 'data' => [], 'refs' => ['element' => $film->id]]]);
$this->fail("Der interne Text $internal wurde als Kartentext angenommen.");
} catch (ValidationException $exception) {
$this->assertArrayHasKey('blocks.0.settings.text_source', $exception->errors());
}
}
}
/**
* @param array<string, mixed> $extra
*/
private function publicFilm(array $extra = []): ContentElement
{
$content = app(ContentService::class);
$kind = fn (string $slug) => EditorialContentKind::query()->where('slug', $slug)->value('id');
$film = $content->createElement('film', 'film', 'Denkpause Rohschnitt');
$film->update($extra + [
'display_title' => 'Eine Pause, die stark macht',
'teaser' => 'TEASER-TEXT',
'summary' => 'KURZ-TEXT',
'description' => "LANG-TEXT erster Absatz\n\nzweiter Absatz",
'usage_note' => 'EINSATZ-INTERN',
'license_note' => 'LIZENZ-INTERN',
]);
$version = $content->publishElementVersion($film, 'Film');
$composition = $content->createComposition('Programm Denkpause');
$composition->editorial_content_kind_id = $kind('programm');
$composition->save();
$shown = $content->publishComposition($composition, [['role' => 'Film', 'target' => $version]]);
app(CompositionDisplayRelease::class)->release($shown, User::factory()->create());
return $film->refresh();
}
/**
* @param array<string, string> $settings
* @param array<string, mixed> $data
* @return array<string, mixed>
*/
private function card(ContentElement $film, array $settings, array $data = []): array
{
return ['layout' => 'u4', 'style' => [], 'slots' => [
['type' => 'media_card', 'v' => 1, 'variant' => 'adaptive', 'settings' => $settings, 'data' => $data, 'refs' => ['element' => $film->id]],
]];
}
/**
* @param list<array<string, mixed>> $sections
*/
private function publish(string $path, array $sections): PageRevision
{
$page = Page::query()->create(['path' => $path]);
$service = app(PageService::class);
$revision = $service->saveRevision($page, $sections, null, null, null);
$service->publish($page, $revision);
return $revision;
}
/**
* @return list<string>
*/
private function cards(string $html): array
{
preg_match_all('#<article class="lf-pc .*?</article>#s', $html, $matches);
return $matches[0];
}
}
@@ -0,0 +1,252 @@
<?php
namespace Tests\Feature;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionDisplayRelease;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Cms\Page;
use App\Domain\Cms\PageRevision;
use App\Domain\Cms\PageService;
use App\Domain\Cms\Widgets\WidgetRegistry;
use App\Domain\Media\CompositionStill;
use App\Domain\Media\CompositionStillSource;
use App\Domain\Media\WebsiteRelease;
use App\Filament\Resources\Pages\Pages\EditPage;
use App\Models\User;
use Filament\Facades\Filament;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Storage;
use Livewire\Livewire;
use Tests\TestCase;
/**
* Programm- und Modulkarte: Die Redaktion wählt den Kartentext (Teaser, Kurzbeschreibung, ausführliche Beschreibung,
* Lernziel) und kann das Vorschaubild des Programms oder Moduls als Website-Bild übernehmen.
*/
class CmsProgramCardTextAndImageTest extends TestCase
{
use RefreshDatabase;
protected function setUp(): void
{
parent::setUp();
Storage::fake('cms_incoming');
Storage::fake('media_derived');
Storage::fake('media_public');
Storage::fake('media_originals');
Filament::setCurrentPanel(Filament::getPanel('verwaltung'));
}
public function test_the_card_shows_the_chosen_text_and_the_default_keeps_its_order(): void
{
$program = $this->program('Programm Selbstvertrauen', [
'teaser' => 'TEASER-TEXT',
'summary' => 'KURZ-TEXT',
'description' => "LANG-TEXT erster Absatz\n\nzweiter Absatz",
], goal: 'LERNZIEL-TEXT');
$this->publish('/programmtext', [
$this->card($program, []),
$this->card($program, ['text_source' => 'auto']),
$this->card($program, ['text_source' => 'teaser']),
$this->card($program, ['text_source' => 'summary']),
$this->card($program, ['text_source' => 'description']),
$this->card($program, ['text_source' => 'goal']),
]);
$cards = $this->cards($this->get('/programmtext')->assertOk()->getContent());
$this->assertCount(6, $cards);
$this->assertStringContainsString('TEASER-TEXT', $cards[0], 'Automatisch: Teaser vor Kurzbeschreibung, wie bisher.');
$this->assertStringContainsString('TEASER-TEXT', $cards[1]);
$this->assertStringContainsString('TEASER-TEXT', $cards[2]);
$this->assertStringContainsString('KURZ-TEXT', $cards[3]);
$this->assertStringNotContainsString('TEASER-TEXT', $cards[3]);
$this->assertStringContainsString('LANG-TEXT', $cards[4]);
$this->assertStringContainsString('zweiter Absatz', $cards[4]);
$this->assertStringContainsString('LERNZIEL-TEXT', $cards[5]);
$this->assertStringNotContainsString('LANG-TEXT', $cards[0], 'Die ausführliche Beschreibung erscheint nur auf ausdrückliche Wahl.');
$this->assertStringNotContainsString('LANG-TEXT', $cards[3]);
}
public function test_automatic_falls_back_to_summary_then_goal_but_an_explicit_choice_does_not(): void
{
$withSummary = $this->program('Programm Nur Kurz', ['summary' => 'KURZ-TEXT'], goal: 'LERNZIEL-TEXT');
$onlyGoal = $this->program('Programm Nur Lernziel', [], goal: 'LERNZIEL-TEXT');
$revision = $this->publish('/programmtext-ersatz', [
$this->card($withSummary, []),
$this->card($onlyGoal, []),
$this->card($onlyGoal, ['text_source' => 'teaser']),
$this->card($onlyGoal, ['text_source' => 'description']),
]);
$cards = $this->cards($this->get('/programmtext-ersatz')->assertOk()->getContent());
$this->assertStringContainsString('KURZ-TEXT', $cards[0]);
$this->assertStringContainsString('LERNZIEL-TEXT', $cards[1], 'Automatisch: ohne Teaser und Kurzbeschreibung das Lernziel, wie bisher.');
$this->assertStringNotContainsString('lf-pc__summary', $cards[2], 'Gewählter, nicht gepflegter Teaser: kein stiller Ersatz.');
$this->assertStringNotContainsString('lf-pc__summary', $cards[3]);
$public = $this->get('/programmtext-ersatz')->getContent();
$this->assertStringNotContainsString('Kein Teaser gepflegt', $public, 'Hinweise erscheinen öffentlich nie.');
$preview = $this->actingAs(User::factory()->redakteur()->create(), 'staff')->get(route('pages.preview', $revision))->assertOk()->getContent();
$this->assertStringContainsString('Kein Teaser gepflegt (Programm oder Modul bearbeiten → Teaser).', $preview);
$this->assertStringContainsString('Keine ausführliche Beschreibung gepflegt (Programm oder Modul bearbeiten → Beschreibung).', $preview);
}
public function test_the_text_choice_is_offered_on_the_program_card_only_with_its_own_choices(): void
{
$registry = app(WidgetRegistry::class);
$this->assertSame(['auto', 'teaser', 'summary', 'description', 'goal'], array_keys($registry->get('program_card')->settingOptions()['text_source']));
$this->assertArrayNotHasKey('text_source', $registry->get('topic_card')->settingOptions(), 'Ein Thema hat nur einen Text.');
}
public function test_the_thumbnail_of_a_program_becomes_one_image_medium_for_the_website(): void
{
$program = $this->program('Programm Mut', ['summary' => 'x'], thumbnail: true);
$editor = User::factory()->redakteur()->create();
$still = app(CompositionStill::class)->fromThumbnail($program, $editor)->refresh();
$this->assertSame('bild', $still->output_class);
$this->assertSame('Titelbild: Programm Mut', $still->display_title);
$this->assertSame('Titelbild zu „Programm Mut“', $still->website_alt);
$this->assertSame(0, $still->versions()->count());
$this->assertNotNull($still->website_released_at, 'Die Warteschlange gibt das abgeleitete Bild für die Website frei.');
$this->assertSame($still->id, CompositionStillSource::query()->where('composition_id', $program->id)->value('still_element_id'));
$stills = app(CompositionStill::class);
$this->assertSame($still->id, $stills->fromThumbnail($program)->id, 'Dasselbe Vorschaubild ergibt dasselbe Medium.');
$this->assertTrue($stills->reused);
$this->assertSame(1, ContentElement::query()->where('output_class', 'bild')->count());
$still->forceFill(['thumbnail_error' => 'Die Bilddatei ließ sich nicht lesen.'])->save();
$this->assertNotSame($still->id, $stills->fromThumbnail($program)->id, 'Ein gescheitertes Bild wird nicht wiederverwendet.');
$this->get(route('website.media', $still))->assertOk();
$still->delete();
$this->assertSame(1, CompositionStillSource::query()->count(), 'Nur die Herkunft des gelöschten Bildes entfällt.');
}
public function test_programs_without_thumbnail_or_archived_yield_no_image(): void
{
$without = $this->program('Programm Ohne Bild', ['summary' => 'x']);
$archived = $this->program('Programm Archiv', ['summary' => 'x'], thumbnail: true);
$archived->update(['archived_at' => now()]);
foreach ([[$without, 'noch kein Vorschaubild'], [$archived, 'archiviert']] as [$composition, $message]) {
try {
app(CompositionStill::class)->fromThumbnail($composition);
$this->fail("Erwartete Ablehnung: $message");
} catch (DomainRuleException $exception) {
$this->assertStringContainsString($message, $exception->getMessage());
}
}
$this->assertSame(0, ContentElement::query()->where('output_class', 'bild')->count());
}
public function test_the_editor_adopts_the_thumbnail_into_the_image_field_and_says_when_the_release_was_withdrawn(): void
{
$program = $this->program('Programm Park', ['summary' => 'x'], thumbnail: true);
$editor = User::factory()->redakteur()->create();
$editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP');
$page = Page::query()->create(['path' => '/programmbild-editor']);
app(PageService::class)->saveRevision($page, [
['layout' => 'u4', 'style' => [], 'slots' => [['type' => 'program_card', 'v' => 1, 'variant' => 'adaptive', 'settings' => [], 'data' => [], 'refs' => ['composition' => $program->id]]]],
], null, null, null);
$component = Livewire::actingAs($editor, 'staff')->test(EditPage::class, ['record' => $page->id]);
$component->call('adoptCompositionThumbnail', 'data.ziel.image', $program->id);
$still = ContentElement::query()->where('output_class', 'bild')->latest('id')->firstOrFail();
$component->assertNotified('Im Medienmanager angelegt: „Titelbild: Programm Park“');
$this->assertSame($still->id, $component->get('data.ziel.image'));
$component->call('adoptCompositionThumbnail', 'data.ziel2.image', $program->id);
$component->assertNotified('Bereits im Medienmanager: „Titelbild: Programm Park“');
app(WebsiteRelease::class)->withdraw($still);
$component->call('adoptCompositionThumbnail', 'data.ziel3.image', $program->id);
$component->assertNotified('Bild ausgewählt, aber nicht für die Website freigegeben: „Titelbild: Programm Park“');
$before = ContentElement::query()->count();
$component->call('adoptCompositionThumbnail', 'umgebung.geheim', $program->id);
$component->call('adoptCompositionThumbnail', 'data.ziel4.bild', $program->id);
$component->call('adoptCompositionThumbnail', 'data.ziel5.image', 999999);
$this->assertSame($before, ContentElement::query()->count(), 'Fremde Ziele und fehlende Programme legen nichts an.');
}
/**
* @param array<string, string> $texts
*/
private function program(string $designation, array $texts, ?string $goal = null, bool $thumbnail = false): Composition
{
$content = app(ContentService::class);
$composition = $content->createComposition($designation);
$composition->forceFill(['editorial_content_kind_id' => EditorialContentKind::query()->where('slug', 'programm')->value('id')] + $texts)->save();
if ($thumbnail) {
$composition->forceFill(['thumbnail_path' => 'vorschau/komposition-'.$composition->id.'.jpg', 'thumbnail_source' => 'eigen'])->save();
Storage::disk('media_derived')->put($composition->thumbnail_path, $this->jpeg());
}
$version = $content->publishComposition(
$composition,
[['role' => 'Text', 'target' => $content->publishElementVersion($content->createElement('text', 'text', $designation.' Blatt'), 'Inhalt')]],
didactic: $goal !== null ? ['learning_goal' => $goal] : [],
);
app(CompositionDisplayRelease::class)->release($version, User::factory()->create());
return $composition->refresh();
}
/**
* @param array<string, string> $settings
* @return array<string, mixed>
*/
private function card(Composition $program, array $settings): array
{
return ['layout' => 'u4', 'style' => [], 'slots' => [
['type' => 'program_card', 'v' => 1, 'variant' => 'adaptive', 'settings' => $settings, 'data' => [], 'refs' => ['composition' => $program->id]],
]];
}
/**
* @param list<array<string, mixed>> $sections
*/
private function publish(string $path, array $sections): PageRevision
{
$page = Page::query()->create(['path' => $path]);
$service = app(PageService::class);
$revision = $service->saveRevision($page, $sections, null, null, null);
$service->publish($page, $revision);
return $revision;
}
/**
* @return list<string>
*/
private function cards(string $html): array
{
preg_match_all('#<article class="lf-pc .*?</article>#s', $html, $matches);
return $matches[0];
}
private function jpeg(): string
{
$image = imagecreatetruecolor(800, 450);
imagefill($image, 0, 0, imagecolorallocate($image, 20, 80, 150));
ob_start();
imagejpeg($image);
return (string) ob_get_clean();
}
}
+25
View File
@@ -140,6 +140,31 @@ public function test_former_cms_images_are_imported_once_deduplicated_and_withou
$this->assertTrue(ContentElement::query()->get()->every(fn (ContentElement $element): bool => $element->website_released_at !== null));
}
public function test_deleting_an_imported_medium_keeps_the_former_file_closed_and_shows_no_image(): void
{
Storage::disk('media_public')->put('cms/geloescht-ffffff.jpg', $this->jpeg(1000, 500));
$this->publish('/geloescht', [
['layout' => 'u4', 'style' => [], 'slots' => [
['type' => 'hero', 'v' => 2, 'variant' => 'photo_split', 'data' => ['heading' => 'Ohne Bild'], 'refs' => ['image' => 'cms/geloescht-ffffff.jpg']],
]],
]);
(new ImportCmsImages)->handle(app(WebsiteIntake::class));
$medium = WebsiteMediaAlias::query()->firstOrFail()->element;
$this->refreshScoped();
$this->get('/geloescht')->assertSee('src="'.route('website.media', $medium).'"', false);
$medium->delete();
$this->refreshScoped();
$this->assertNull(WebsiteMediaAlias::query()->sole()->content_element_id, 'Die Zuordnung bleibt als Sperre bestehen.');
$main = $this->main($this->get('/geloescht')->assertOk()->getContent());
$this->assertStringContainsString('Ohne Bild', $main, 'Das Widget bleibt.');
$this->assertStringNotContainsString('<img', $main);
$this->assertStringNotContainsString('/medien/cms/geloescht', $main);
$this->get('/medien/cms/geloescht-ffffff.jpg')->assertNotFound();
Storage::disk('media_public')->assertExists('cms/geloescht-ffffff.jpg');
}
public function test_an_alias_takes_effect_only_after_the_medium_was_released(): void
{
Storage::disk('media_public')->put('cms/kaputt-dddddd.jpg', 'keine Bilddaten');
+320
View File
@@ -0,0 +1,320 @@
<?php
namespace Tests\Feature;
use App\Domain\Catalog\CompositionDisplayRelease;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentElementVersion;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Cms\Page;
use App\Domain\Cms\PageService;
use App\Domain\Entitlement\Grant;
use App\Domain\Media\FilmStill;
use App\Domain\Media\FilmStillSource;
use App\Domain\Media\ThumbnailDeriver;
use App\Domain\Media\WebsiteRelease;
use App\Filament\Resources\Pages\Pages\EditPage;
use App\Models\User;
use Filament\Facades\Filament;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Storage;
use Livewire\Livewire;
use Tests\TestCase;
/**
* Bild aus einem Film für die Medien- und Materialkarte: einmal als Bild-Medium ablegen, danach nur lesen.
* Die Bildextraktion (ffmpeg) wird durch einen Stub ersetzt und mitgezählt.
*/
class FilmStillTest extends TestCase
{
use RefreshDatabase;
/** @var object{calls: list<array{second: float, width: int, original: bool}>, fail: bool} */
private object $extractor;
protected function setUp(): void
{
parent::setUp();
Storage::fake('cms_incoming');
Storage::fake('media_derived');
Storage::fake('media_public');
Storage::fake('media_originals');
Filament::setCurrentPanel(Filament::getPanel('verwaltung'));
$jpeg = $this->jpeg(1600, 900);
$this->extractor = new class($jpeg) extends ThumbnailDeriver
{
/** @var list<array{second: float, width: int, original: bool}> */
public array $calls = [];
public bool $fail = false;
public function __construct(private readonly string $jpeg) {}
public function frameJpeg(ContentElementVersion $version, float $seconds, int $width = 640, bool $original = false): ?string
{
$this->calls[] = ['second' => $seconds, 'width' => $width, 'original' => $original];
return $this->fail ? null : $this->jpeg;
}
};
$this->app->instance(ThumbnailDeriver::class, $this->extractor);
}
public function test_a_chosen_frame_becomes_one_image_medium_that_is_released_for_the_website(): void
{
$film = $this->film();
$editor = User::factory()->redakteur()->create();
$still = app(FilmStill::class)->fromSecond($film, 41.5, $editor)->refresh();
$this->assertSame('bild', $still->output_class);
$this->assertSame('Standbild: Lara im Park (Fassung 1, 41,5 s)', $still->display_title);
$this->assertSame('Szene aus dem Film „Lara im Park“', $still->website_alt);
$this->assertSame('Foto: Lara und Felix', $still->website_credit, 'Die Quellenzeile des Films wird übernommen.');
$this->assertSame(0, $still->versions()->count(), 'Es entsteht keine Inhaltsfassung.');
$this->assertSame(0, Grant::query()->count(), 'Es entsteht keine Berechtigung.');
$this->assertNotNull($still->website_released_at, 'Die Warteschlange gibt das abgeleitete Bild für die Website frei.');
$this->assertSame([['second' => 41.5, 'width' => 1600, 'original' => true]], $this->extractor->calls, 'Aus der Mediendatei in voller Auflösung, nicht aus der kleinen Stufe.');
$this->assertSame($still->id, FilmStillSource::query()->where('film_element_id', $film->id)->value('still_element_id'));
$this->assertSame($editor->id, FilmStillSource::query()->value('actor_id'));
$this->assertSame(1, ContentElement::query()->where('output_class', 'film')->count(), 'Der Film bleibt unverändert.');
}
public function test_the_same_frame_is_never_extracted_or_stored_twice(): void
{
$film = $this->film();
$first = app(FilmStill::class)->fromSecond($film, 12);
$second = app(FilmStill::class)->fromSecond($film, 12.0);
$other = app(FilmStill::class)->fromSecond($film, 13);
$this->assertSame($first->id, $second->id);
$this->assertNotSame($first->id, $other->id);
$this->assertCount(2, $this->extractor->calls, 'Die zweite Anforderung derselben Stelle liest das gespeicherte Bild.');
$this->assertSame(2, ContentElement::query()->where('output_class', 'bild')->count());
$first->update(['archived_at' => now()]);
$this->assertNotSame($first->id, app(FilmStill::class)->fromSecond($film, 12)->id, 'Ein archiviertes Bild wird nicht wiederverwendet.');
}
public function test_the_thumbnail_of_the_film_is_taken_over_in_full_resolution_or_as_its_own_file(): void
{
$film = $this->film();
$film->forceFill(['thumbnail_path' => 'vorschau/element-'.$film->id.'.jpg', 'thumbnail_source' => 'frame:'.$film->versions()->value('id').'@41.5'])->save();
Storage::disk('media_derived')->put($film->thumbnail_path, $this->jpeg(640, 360));
$fromFrame = app(FilmStill::class)->fromThumbnail($film);
$this->assertSame([['second' => 41.5, 'width' => 1600, 'original' => true]], $this->extractor->calls, 'Eine Filmstelle wird in voller Auflösung neu gezogen.');
$this->assertSame($fromFrame->id, app(FilmStill::class)->fromSecond($film, 41.5)->id, 'Dieselbe Stelle ergibt dasselbe Medium, egal auf welchem Weg.');
$this->assertCount(1, $this->extractor->calls);
$own = $this->film('Interview');
$own->forceFill(['thumbnail_path' => 'vorschau/element-'.$own->id.'.jpg', 'thumbnail_source' => 'eigen'])->save();
Storage::disk('media_derived')->put($own->thumbnail_path, $this->jpeg(800, 450));
$copied = app(FilmStill::class)->fromThumbnail($own);
$this->assertSame($copied->id, app(FilmStill::class)->fromThumbnail($own)->id, 'Dieselbe Vorschaudatei ergibt dasselbe Medium.');
$this->assertCount(1, $this->extractor->calls, 'Ein eigenes Vorschaubild wird kopiert, nicht aus dem Film gezogen.');
$this->assertStringStartsWith('Standbild: Interview (Vorschaubild)', $copied->refresh()->display_title);
}
public function test_confidential_blocked_or_unusable_films_yield_no_image(): void
{
$content = app(ContentService::class);
$guide = $this->film('Traineranleitung als Film');
$guide->update(['editorial_content_kind_id' => EditorialContentKind::query()->where('slug', 'traineranleitung')->value('id')]);
$archived = $this->film('Archiviert');
$archived->update(['archived_at' => now()]);
$draftOnly = $content->createElement('film', 'film', 'Nur Entwurf');
$content->draftElementVersion($draftOnly, 'Entwurf');
$text = $content->createElement('text', 'text', 'Ein Text');
$noThumbnail = $this->film('Ohne Vorschaubild');
$cases = [
[fn () => app(FilmStill::class)->fromSecond($guide, 5), 'Traineranleitungen'],
[fn () => app(FilmStill::class)->fromSecond($archived, 5), 'archiviert'],
[fn () => app(FilmStill::class)->fromSecond($draftOnly, 5), 'bereitgestellte Fassung'],
[fn () => app(FilmStill::class)->fromSecond($text, 5), 'Nur aus einem Film'],
[fn () => app(FilmStill::class)->fromSecond($noThumbnail, -1), 'außerhalb des Films'],
[fn () => app(FilmStill::class)->fromSecond($noThumbnail, 7201), 'außerhalb des Films'],
[fn () => app(FilmStill::class)->fromThumbnail($noThumbnail), 'noch kein Vorschaubild'],
];
foreach ($cases as [$call, $message]) {
try {
$call();
$this->fail("Erwartete Ablehnung: $message");
} catch (DomainRuleException $exception) {
$this->assertStringContainsString($message, $exception->getMessage());
}
}
$this->extractor->fail = true;
try {
app(FilmStill::class)->fromSecond($noThumbnail, 5);
$this->fail('Eine nicht ziehbare Stelle wurde angenommen.');
} catch (DomainRuleException $exception) {
$this->assertStringContainsString('kein Bild erzeugen', $exception->getMessage());
}
$this->assertSame(0, ContentElement::query()->where('output_class', 'bild')->count(), 'Bei einer Ablehnung entsteht kein Medium.');
$this->assertSame(0, FilmStillSource::query()->count());
}
public function test_the_card_shows_the_stored_image_and_a_page_view_never_extracts_a_frame(): void
{
$film = $this->film();
$still = app(FilmStill::class)->fromSecond($film, 41.5)->refresh();
$this->assertCount(1, $this->extractor->calls);
$this->publishInProgram($film);
$page = Page::query()->create(['path' => '/filmkarte']);
$service = app(PageService::class);
$service->publish($page, $service->saveRevision($page, [
['layout' => 'u4', 'style' => [], 'slots' => [
['type' => 'media_card', 'v' => 1, 'variant' => 'adaptive', 'settings' => [], 'data' => [], 'refs' => ['element' => $film->id, 'image' => $still->id]],
]],
], null, null, null));
for ($i = 0; $i < 3; $i++) {
$html = $this->get('/filmkarte')->assertOk()->getContent();
}
$this->assertStringContainsString('src="'.route('website.media', $still).'"', $html);
$this->assertStringContainsString('alt="Szene aus dem Film „Lara im Park“"', htmlspecialchars_decode($html));
$this->assertStringNotContainsString('lf-pc__panel--film', $html, 'Mit freigegebenem Bild erscheint keine Filmtafel.');
$this->assertStringNotContainsString('/redaktion/', $html);
$this->assertCount(1, $this->extractor->calls, 'Seitenaufrufe lesen nur die gespeicherte Datei und starten keine Bildextraktion.');
app(WebsiteRelease::class)->withdraw($still);
$this->app->forgetScopedInstances();
$this->assertStringNotContainsString('<img', $this->main($this->get('/filmkarte')->getContent()), 'Zurückgenommen: das Bild entfällt, die Karte bleibt (Filmtafel).');
}
public function test_the_editor_adopts_a_frame_into_the_image_field_and_rejects_foreign_targets(): void
{
$film = $this->film();
$film->forceFill(['thumbnail_path' => 'vorschau/element-'.$film->id.'.jpg', 'thumbnail_source' => 'eigen'])->save();
Storage::disk('media_derived')->put($film->thumbnail_path, $this->jpeg(640, 360));
$editor = User::factory()->redakteur()->create();
$editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP');
$page = Page::query()->create(['path' => '/filmbild-editor']);
app(PageService::class)->saveRevision($page, [
['layout' => 'u4', 'style' => [], 'slots' => [['type' => 'media_card', 'v' => 1, 'variant' => 'adaptive', 'settings' => [], 'data' => [], 'refs' => ['element' => $film->id]]]],
], null, null, null);
$component = Livewire::actingAs($editor, 'staff')->test(EditPage::class, ['record' => $page->id]);
$component->call('adoptFilmFrame', 'data.ziel.image', $film->id, '12.5');
$frame = ContentElement::query()->where('output_class', 'bild')->latest('id')->firstOrFail();
$this->assertSame($frame->id, $component->get('data.ziel.image'));
$this->assertSame('Standbild: Lara im Park (Fassung 1, 12,5 s)', $frame->display_title);
$component->call('adoptFilmThumbnail', 'data.ziel2.image', $film->id);
$this->assertNotNull($component->get('data.ziel2.image'));
$before = ContentElement::query()->count();
$component->call('adoptFilmFrame', 'data.ziel3.image', $film->id, 'abc');
$component->call('adoptFilmFrame', 'umgebung.geheim', $film->id, '5');
$component->call('adoptFilmFrame', 'data.ziel4.bild', $film->id, '5');
$component->call('adoptFilmFrame', 'data.ziel5.image', 999999, '5');
$this->assertSame($before, ContentElement::query()->count(), 'Fremde Ziele, falsche Eingaben und fehlende Filme legen nichts an.');
$this->assertNull($component->get('data.ziel3.image'));
}
public function test_a_withdrawn_still_is_reused_but_the_message_says_it_is_not_public(): void
{
$film = $this->film();
$editor = User::factory()->redakteur()->create();
$editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP');
$page = Page::query()->create(['path' => '/zurueckgenommen']);
app(PageService::class)->saveRevision($page, [
['layout' => 'u4', 'style' => [], 'slots' => [['type' => 'media_card', 'v' => 1, 'variant' => 'adaptive', 'settings' => [], 'data' => [], 'refs' => ['element' => $film->id]]]],
], null, null, null);
$component = Livewire::actingAs($editor, 'staff')->test(EditPage::class, ['record' => $page->id]);
$component->call('adoptFilmFrame', 'data.ziel.image', $film->id, '12.5');
$still = ContentElement::query()->where('output_class', 'bild')->latest('id')->firstOrFail();
$title = 'Standbild: Lara im Park (Fassung 1, 12,5 s)';
$component->assertNotified('Im Medienmanager angelegt: „'.$title.'“');
$component->call('adoptFilmFrame', 'data.ziel2.image', $film->id, '12.5');
$component->assertNotified('Bereits im Medienmanager: „'.$title.'“');
$this->assertSame($still->id, $component->get('data.ziel2.image'));
$this->assertCount(1, $this->extractor->calls, 'Die zweite Übernahme zieht nichts neu.');
app(WebsiteRelease::class)->withdraw($still);
$component->call('adoptFilmFrame', 'data.ziel3.image', $film->id, '12.5');
$component->assertNotified('Bild ausgewählt, aber nicht für die Website freigegeben: „'.$title.'“');
$this->assertSame($still->id, $component->get('data.ziel3.image'), 'Das zurückgenommene Bild bleibt ein und dasselbe Medium.');
$this->assertCount(1, $this->extractor->calls);
}
public function test_a_still_that_failed_during_processing_is_replaced_by_a_new_one_for_the_same_frame(): void
{
$film = $this->film();
$first = app(FilmStill::class)->fromSecond($film, 7);
$first->forceFill(['thumbnail_error' => 'Die Bilddatei ließ sich nicht lesen.'])->save();
$second = app(FilmStill::class)->fromSecond($film, 7);
$this->assertNotSame($first->id, $second->id, 'Ein gescheitertes Bild blockiert die Stelle nicht.');
$this->assertSame($second->id, FilmStillSource::query()->where('film_element_id', $film->id)->sole()->still_element_id, 'Die Herkunft zeigt auf das neue Bild.');
$this->assertSame($second->id, app(FilmStill::class)->fromSecond($film, 7)->id);
}
public function test_deleting_a_still_in_the_media_manager_works_and_the_frame_can_be_taken_over_again(): void
{
$film = $this->film();
$still = app(FilmStill::class)->fromSecond($film, 3);
$still->delete();
$this->assertSame(0, FilmStillSource::query()->count(), 'Die Herkunftszeile entfällt mit dem Bild.');
$this->assertSame($film->id, ContentElement::query()->where('output_class', 'film')->value('id'), 'Der Film bleibt.');
$again = app(FilmStill::class)->fromSecond($film, 3);
$this->assertNotSame($still->id, $again->id);
}
private function film(string $title = 'Lara im Park'): ContentElement
{
$content = app(ContentService::class);
$film = $content->createElement('film', 'film', $title);
$film->update(['website_credit' => 'Foto: Lara und Felix']);
$content->publishElementVersion($film, 'Film');
return $film->refresh();
}
private function publishInProgram(ContentElement $film): void
{
$content = app(ContentService::class);
$composition = $content->createComposition('Programm Park');
$composition->editorial_content_kind_id = EditorialContentKind::query()->where('slug', 'programm')->value('id');
$composition->save();
$version = $content->publishComposition($composition, [['role' => 'Film', 'target' => $film->versions()->firstOrFail()]]);
app(CompositionDisplayRelease::class)->release($version, User::factory()->create());
}
private function main(string $html): string
{
preg_match('#<main[^>]*>(.*)</main>#s', $html, $match);
return $match[1] ?? '';
}
private function jpeg(int $width, int $height): string
{
$image = imagecreatetruecolor($width, $height);
imagefill($image, 0, 0, imagecolorallocate($image, 40, 120, 90));
ob_start();
imagejpeg($image);
return (string) ob_get_clean();
}
}