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
18 changed files with 745 additions and 47 deletions

No files matched your search

@@ -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,
);
}
@@ -8,6 +8,7 @@
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;
@@ -115,6 +116,7 @@ protected function imageSourceFields(): array
'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',
];
}),
@@ -128,6 +130,11 @@ private function filmFor(mixed $id): ?ContentElement
return $element instanceof ContentElement && app(FilmStill::class)->refusal($element) === null ? $element : null;
}
protected function subjectNoun(): string
{
return 'Medium';
}
protected function textChoices(): array
{
return [
@@ -33,13 +33,6 @@ abstract class PremiumCardWidget extends WidgetType
{
public const SHOW = ['yes' => 'Anzeigen', 'no' => 'Ausblenden'];
/** Hinweise der Redaktionsvorschau, wenn der gewählte zentrale Text nicht gepflegt ist. */
public const TEXT_MISSING = [
'teaser' => 'Kein Teaser gepflegt (Medium bearbeiten → Teaser).',
'summary' => 'Keine Kurzbeschreibung gepflegt (Medium bearbeiten → Kurzbeschreibung).',
'description' => 'Keine ausführliche Beschreibung gepflegt (Medium bearbeiten → Beschreibung).',
];
/** Schlüssel des Fachobjekts in refs, zum Beispiel 'pillar'. */
abstract protected function refKey(): string;
@@ -85,6 +78,26 @@ 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';
@@ -283,7 +296,7 @@ public function resolve(array $widget, RenderContext $context): array
$textSource = $option('text_source', 'auto');
if ($subject instanceof CardSubject && $textSource !== 'auto' && isset($this->textChoices()[$textSource])) {
$subject = $subject->withTextChoice($textSource, self::TEXT_MISSING[$textSource] ?? '');
$subject = $subject->withTextChoice($textSource, $this->missingTextHint($textSource));
}
$heading = filled($data['heading'] ?? null) ? trim((string) $data['heading']) : null;
@@ -353,7 +366,7 @@ private function centralText(mixed $id, string $field, mixed $textSource = null)
}
if ($subject instanceof CardSubject && is_string($textSource) && isset($this->textChoices()[$textSource]) && $textSource !== 'auto') {
$subject = $subject->withTextChoice($textSource, self::TEXT_MISSING[$textSource] ?? '');
$subject = $subject->withTextChoice($textSource, $this->missingTextHint($textSource));
}
$text = $subject?->{$field};
@@ -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');
}
}
+53 -5
View File
@@ -2,9 +2,11 @@
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;
@@ -58,6 +60,38 @@ public function adoptFilmFrame(string $pfad, int $elementId, string $sekunde): v
$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
*/
@@ -65,7 +99,7 @@ private function adoptFilmStill(string $pfad, int $elementId, callable $make): v
{
abort_unless(ContentElementResource::editor(), 403);
if (preg_match('/^(data|mountedActions\.\d+\.data)(\.[A-Za-z0-9_-]+)+\.image$/', $pfad) !== 1) {
if ($this->imageTargetIsInvalid($pfad)) {
return;
}
@@ -86,9 +120,24 @@ private function adoptFilmStill(string $pfad, int $elementId, callable $make): v
}
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 (! $stills->reused) {
if (! $reused) {
Notification::make()
->success()
->title('Im Medienmanager angelegt: „'.$title.'“')
@@ -98,14 +147,13 @@ private function adoptFilmStill(string $pfad, int $elementId, callable $make): v
return;
}
// Dieselbe Stelle war schon übernommen: Der tatsächliche Stand des Bildes entscheidet über die Meldung.
if (app(WebsiteMedia::class)->present($still) !== null) {
Notification::make()->success()->title('Bereits im Medienmanager: „'.$title.'“')->body('Diese Stelle war schon übernommen. Das Bild ist als Kartenbild ausgewählt.')->send();
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('Diese Stelle war schon übernommen und die Website-Freigabe wurde zurückgenommen. Das Bild erscheint öffentlich erst wieder, wenn sie im Medienmanager (Reiter „Website“) erneut gegeben wird.')
->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();
}
@@ -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.
@@ -519,6 +519,7 @@ ## ADR-39 – Premium-Karten mit Fachbezug
**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.
+2 -2
View File
@@ -312,9 +312,9 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**Darstellung** (Reiter „Darstellung“): Variante `adaptive` (ab 520 px Bild neben Text) oder `stacked` (Bild immer oben); Höhe `auto` oder `fill` („An die Zeile angleichen“); `settings.format` (`landscape` 16:9 Vorgabe, `square`, `portrait` 3:4); `settings.fit` (`cover` Vorgabe, `contain` für Dokumente und Poster); `settings.heading_level` (`h3` Vorgabe, `h2`, `h4`); Anzeigen/Ausblenden von Kurzbeschreibung, Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px).
**Text der Medienkarte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`); nur an der Medienkarte. `auto` entspricht dem bisherigen Verhalten (Kurzbeschreibung, sonst Teaser). Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Die ausführliche Beschreibung erscheint nur auf diese Wahl (öffentlich, sofern die Karte öffentlich ist). Der eigene Text der Karte (`data.summary`) hat Vorrang.
**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: „Vorschaubild des Films übernehmen“ oder eine Stelle wählen. `FilmStill` legt das Einzelbild (bis 1600 px) einmal als Bild-Medium ab; `refs.image` trägt dessen Kennung. Details und Grenzen: `medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“.
**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.
@@ -157,14 +157,15 @@ ### Text
- Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Ist der gewählte Text nicht gepflegt, bleibt die Karte ohne Text; die Redaktionsvorschau nennt, wo er zu pflegen ist. Öffentlich erscheint nie ein Hinweis.
- Der eigene Text der Karte (`data.summary`, „Text nur für diese Karte“) hat Vorrang vor der Wahl.
- **Neu öffentlich auf ausdrückliche Wahl:** die ausführliche Beschreibung, die bisher Bibliothekstext war. Der Dialog sagt das („erscheint öffentlich“). Einsatzhinweis und Lizenzvermerk sind nicht wählbar. Öffentlich ist die Karte weiterhin nur, wenn das Medium zu einem öffentlich gezeigten Programm gehört.
- Die Wahl gibt es nur an der Medien- und Materialkarte; Themen- und Programmkarte lesen weiter ihren Text.
- 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. „Vorschaubild des Films übernehmen“ oder
2. eine Zeitposition wählen, „Anzeigen“, „Dieses Bild übernehmen“.
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`.
@@ -176,3 +177,8 @@ ### Bild 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, 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).
@@ -1,9 +1,8 @@
{{--
Medien- und Materialkarte, Reiter „Medien“: ein Bild aus dem Film als Kartenbild übernehmen.
- „Vorschaubild des Films übernehmen“ und „Dieses Bild übernehmen“ legen das Bild einmal als Bild-Medium im
Medienmanager ab (FilmStill) und wählen es im Bildfeld aus. Seitenaufrufe lesen nur diese Datei.
- Die Vorschau der gewählten Stelle zieht ein Bild über die Redaktionsroute editorial.frame (nur angemeldete
Redaktion) und startet erst nach „Anzeigen“, nicht bei jeder Eingabe.
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
@@ -12,38 +11,44 @@
$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: null, base: @js($framePfad) }">
<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 ($filmHasThumbnail)
<x-filament::button color="gray" size="sm" icon="heroicon-o-photo" wire:loading.attr="disabled"
wire:click="adoptFilmThumbnail({{ \Illuminate\Support\Js::from($ziel) }}, {{ (int) $film->id }})">
Vorschaubild des Films übernehmen
</x-filament::button>
@endif
@if ($framePfad !== null)
<div class="luf-filmbild-frame">
<label class="luf-filmbild-label">
Zeitposition in Sekunden
<input type="number" min="0" max="7200" step="0.5" x-model.lazy="second" class="luf-filmbild-second">
</label>
<x-filament::button color="gray" size="sm" icon="heroicon-o-eye" type="button" x-on:click="shown = second">
Anzeigen
<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>
<template x-if="shown !== null">
<div class="luf-filmbild-preview">
<img :src="base + '?sekunde=' + encodeURIComponent(shown)" alt="Vorschau der gewählten Filmstelle">
<x-filament::button color="primary" size="sm" icon="heroicon-o-check-circle" type="button" wire:loading.attr="disabled"
x-on:click="$wire.adoptFilmFrame({{ \Illuminate\Support\Js::from($ziel) }}, {{ (int) $film->id }}, String(shown))">
Dieses Bild übernehmen
</x-filament::button>
</div>
</template>
</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>
@@ -92,6 +92,11 @@
.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; }
+2 -1
View File
@@ -98,7 +98,8 @@ public function test_the_choice_is_limited_to_the_three_central_texts_and_to_the
$registry = app(WidgetRegistry::class);
$this->assertSame(['auto', 'teaser', 'summary', 'description'], array_keys($registry->get('media_card')->settingOptions()['text_source']));
$this->assertArrayNotHasKey('text_source', $registry->get('program_card')->settingOptions());
// 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) {
@@ -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();
}
}