Compare commits

...
Author SHA1 Message Date
StommerandClaude Sonnet 5.5 9f7c645baf Binde Stripe im Testmodus an die Kasse an
CI Feature / test (push) Successful in 1m53s
Neuer Zahlungsweg PAYMENT_DRIVER=stripe: Checkout Session über die Stripe-API (Http-Client, kein
SDK), Freischaltung nur durch die signierte Meldung an POST /stripe/webhook (Signatur und
Zeittoleranz geprüft, Betrag und Währung gegen die Bestellung, wiederholte Meldung wirkungslos).
Nur Testschlüssel (sk_test_), nie in Produktion; Standard bleibt der Testweg. Die Freischaltung
nutzt denselben Weg wie die Testzahlung (Checkout::settle). Die Schaltfläche „Widerrufen“ ist im
Stripe-Modus ausgeblendet, weil sie kein Geld zurückbucht. Betrieb: docs/betrieb/DEPLOYMENT.md.

Bestandstests geändert: ShopProductPageTest und CmsSectionRenderingTest (2 Stellen) nutzten
„stripe“ als Beispiel für einen nicht freigegebenen Zahlungsweg. Stripe ist jetzt freigegeben,
die Tests nehmen den unbekannten Treiber „unbekannt“; die Assertions bleiben unverändert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 22:26:09 +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
39 changed files with 2043 additions and 49 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));
}
}
@@ -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,9 @@
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Media\FilmStill;
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 +56,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 +93,51 @@ 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 !== '',
'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 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;
@@ -32,6 +33,13 @@ 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;
@@ -56,6 +64,27 @@ 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 [];
}
public function view(): string
{
return 'widgets.premium_card';
@@ -110,7 +139,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 +155,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 +227,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 +243,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 +280,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, self::TEXT_MISSING[$textSource] ?? '');
}
$heading = filled($data['heading'] ?? null) ? trim((string) $data['heading']) : null;
$lead = filled($data['summary'] ?? null) ? trim((string) $data['summary']) : null;
@@ -302,7 +340,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 +352,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, self::TEXT_MISSING[$textSource] ?? '');
}
$text = $subject?->{$field};
return is_string($text) && trim($text) !== '' ? Str::limit(trim($text), 120) : null;
+27 -6
View File
@@ -140,6 +140,27 @@ private function createOrder(User $user, Party $holder, array $pairs): Order
public function confirmTestPayment(Order $order, string $reference): Order
{
$this->assertTestDriver();
return $this->settle($order, 'test', $reference);
}
/**
* Zahlung eines Anbieters (Stripe): wie die Testzahlung, aber erst nach Prüfung von Betrag und Währung gegen die
* Bestellung. Wiederholte Meldungen sind wirkungslos.
*/
public function confirmProviderPayment(Order $order, string $provider, string $reference, int $amountCents, string $currency): Order
{
$expected = (int) ($order->total_cents ?? $order->lines()->sum('price_cents'));
if ($amountCents !== $expected || strtoupper($currency) !== strtoupper((string) ($order->currency ?? 'EUR'))) {
throw new DomainRuleException('Der gezahlte Betrag weicht von der Bestellung ab.');
}
return $this->settle($order, $provider, $reference);
}
private function settle(Order $order, string $provider, string $reference): Order
{
$reference = trim($reference);
if ($reference === '') {
@@ -147,7 +168,7 @@ public function confirmTestPayment(Order $order, string $reference): Order
}
$paidNow = false;
$order = DB::transaction(function () use ($order, $reference, &$paidNow): Order {
$order = DB::transaction(function () use ($order, $provider, $reference, &$paidNow): Order {
$order = Order::query()->lockForUpdate()->findOrFail($order->id);
if ($order->status === 'bezahlt') {
@@ -158,11 +179,11 @@ public function confirmTestPayment(Order $order, string $reference): Order
throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.');
}
$order->payments()->create([
'provider' => 'test',
'status' => 'bestaetigt',
'provider_reference' => $reference,
]);
// Eine bei Stripe angelegte offene Zahlung mit derselben Referenz wird bestätigt statt doppelt geführt.
$order->payments()->updateOrCreate(
['provider_reference' => $reference],
['provider' => $provider, 'status' => 'bestaetigt'],
);
$order->status = 'bezahlt';
$order->save();
$paidNow = true;
+12 -1
View File
@@ -9,8 +9,19 @@
*/
final class Shop
{
public static function driver(): string
{
return (string) config('services.payment.driver');
}
public static function enabled(): bool
{
return ! app()->isProduction() && config('services.payment.driver') === 'test';
return ! app()->isProduction() && in_array(self::driver(), ['test', 'stripe'], true);
}
/** Stripe-Kasse (Etappe 1: nur Testmodus, nie in Produktion). */
public static function stripe(): bool
{
return ! app()->isProduction() && self::driver() === 'stripe';
}
}
@@ -0,0 +1,145 @@
<?php
namespace App\Domain\Commerce\Stripe;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Commerce\Order;
use Illuminate\Http\Client\ConnectionException;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Http\Client\Response;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Log;
/**
* Stripe-Kasse (Checkout Session) für die Testzahlung in Etappe 1. Ausschließlich Testschlüssel: Ein Live-Schlüssel
* oder die Produktionsumgebung werden abgewiesen, bevor ein Aufruf an Stripe geht. Bezahlt wird bei Stripe; Kartendaten
* berühren diese Anwendung nie. Die Freischaltung erfolgt allein über die signierte Meldung (StripeWebhook).
*/
class StripeGateway
{
/**
* Legt für die Bestellung eine Checkout Session an oder liefert die noch offene wieder.
*
* @return array{id: string, url: string}
*/
public function checkoutFor(Order $order): array
{
$this->assertSandbox();
$order->loadMissing('lines', 'user');
if ($order->status !== 'offen') {
throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.');
}
$open = $this->reusableSession($order);
if ($open !== null) {
return $open;
}
$attempt = $order->payments()->where('provider', 'stripe')->count() + 1;
$params = [
'mode' => 'payment',
'client_reference_id' => (string) $order->id,
'customer_email' => $order->user->email,
'locale' => 'de',
'success_url' => route('member.order', $order).'?zahlung=zurueck',
'cancel_url' => route('member.order', $order).'?zahlung=abbruch',
'metadata' => ['order_id' => (string) $order->id],
'payment_intent_data' => ['metadata' => ['order_id' => (string) $order->id]],
];
foreach ($order->lines->values() as $index => $line) {
$params['line_items'][$index] = [
'quantity' => 1,
'price_data' => [
'currency' => strtolower((string) ($line->currency ?? $order->currency ?? 'EUR')),
'unit_amount' => (int) $line->price_cents,
'product_data' => ['name' => filled($line->offer_name) ? (string) $line->offer_name : 'Lizenz'],
],
];
}
$response = $this->request()
->withHeaders(['Idempotency-Key' => 'luf-order-'.$order->id.'-'.$attempt])
->post('/v1/checkout/sessions', $params);
$this->assertOk($response, 'angelegt');
$id = (string) $response->json('id');
$url = (string) $response->json('url');
if ($id === '' || $url === '') {
throw new DomainRuleException('Stripe hat keine Kasse geliefert. Bitte versuche es später noch einmal.');
}
$order->payments()->create(['provider' => 'stripe', 'status' => 'offen', 'provider_reference' => $id]);
return ['id' => $id, 'url' => $url];
}
public function assertSandbox(): void
{
$secret = (string) config('services.stripe.secret');
if (app()->isProduction()) {
throw new DomainRuleException('Stripe ist in Produktion nicht freigegeben.');
}
if ($secret === '') {
throw new DomainRuleException('Stripe ist nicht eingerichtet: Der Schlüssel fehlt.');
}
if (! str_starts_with($secret, 'sk_test_') && ! str_starts_with($secret, 'rk_test_')) {
throw new DomainRuleException('Etappe 1 erlaubt nur den Stripe-Testmodus (Schlüssel sk_test_).');
}
}
/**
* @return array{id: string, url: string}|null
*/
private function reusableSession(Order $order): ?array
{
$payment = $order->payments()->where('provider', 'stripe')->where('status', 'offen')->latest('id')->first();
if ($payment === null) {
return null;
}
try {
$response = $this->request()->get('/v1/checkout/sessions/'.$payment->provider_reference);
} catch (ConnectionException) {
return null;
}
if ($response->successful() && $response->json('status') === 'open' && filled($response->json('url'))) {
return ['id' => (string) $payment->provider_reference, 'url' => (string) $response->json('url')];
}
return null;
}
private function request(): PendingRequest
{
return Http::baseUrl(rtrim((string) config('services.stripe.api_base'), '/'))
->withToken((string) config('services.stripe.secret'))
->asForm()
->acceptJson()
->timeout(15);
}
private function assertOk(Response $response, string $what): void
{
if ($response->successful()) {
return;
}
// Nur Statuscode und Fehlertyp ins Log, nie Schlüssel oder Kundendaten.
Log::warning('Stripe-Anfrage fehlgeschlagen', [
'status' => $response->status(),
'type' => $response->json('error.type'),
'code' => $response->json('error.code'),
]);
throw new DomainRuleException('Die Zahlung konnte bei Stripe nicht '.$what.' werden. Bitte versuche es später noch einmal.');
}
}
@@ -0,0 +1,59 @@
<?php
namespace App\Domain\Commerce\Stripe;
use App\Domain\Catalog\DomainRuleException;
/**
* Prüft die Signatur einer Stripe-Meldung (Header „Stripe-Signature“: t=Zeit, v1=HMAC-SHA256 über „t.Nutzlast“).
* Eine Meldung ohne gültige Signatur oder außerhalb der Zeittoleranz wird abgewiesen.
*/
class StripeSignature
{
public const TOLERANCE_SECONDS = 300;
public function verify(string $payload, ?string $header, ?int $now = null): void
{
$secret = (string) config('services.stripe.webhook_secret');
if ($secret === '') {
throw new DomainRuleException('Das Webhook-Geheimnis ist nicht eingerichtet.');
}
if ($header === null || trim($header) === '') {
throw new DomainRuleException('Die Signatur fehlt.');
}
$timestamp = null;
$signatures = [];
foreach (explode(',', $header) as $part) {
[$key, $value] = array_pad(explode('=', trim($part), 2), 2, '');
if ($key === 't') {
$timestamp = ctype_digit($value) ? (int) $value : null;
} elseif ($key === 'v1' && $value !== '') {
$signatures[] = $value;
}
}
if ($timestamp === null || $signatures === []) {
throw new DomainRuleException('Die Signatur ist unvollständig.');
}
$expected = hash_hmac('sha256', $timestamp.'.'.$payload, $secret);
$valid = false;
foreach ($signatures as $signature) {
$valid = hash_equals($expected, $signature) || $valid;
}
if (! $valid) {
throw new DomainRuleException('Die Signatur stimmt nicht.');
}
if (abs(($now ?? now()->getTimestamp()) - $timestamp) > self::TOLERANCE_SECONDS) {
throw new DomainRuleException('Die Meldung ist zu alt.');
}
}
}
+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;
@@ -3,7 +3,11 @@
namespace App\Filament\Support;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Media\FilmStill;
use App\Domain\Media\WebsiteMedia;
use App\Filament\Resources\ContentElements\ContentElementResource;
use Filament\Notifications\Notification;
/**
@@ -31,6 +35,82 @@ 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()));
}
/**
* @param callable(FilmStill, ContentElement): ContentElement $make
*/
private function adoptFilmStill(string $pfad, int $elementId, callable $make): void
{
abort_unless(ContentElementResource::editor(), 403);
if (preg_match('/^(data|mountedActions\.\d+\.data)(\.[A-Za-z0-9_-]+)+\.image$/', $pfad) !== 1) {
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);
$title = ($still->display_title ?: $still->working_title);
if (! $stills->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;
}
// 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();
} 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.')
->persistent()
->send();
}
}
/**
* Filament rendert bei offenen Aktionsdialogen nur den Dialogteil neu; der Picker liegt darüber und braucht die
* ganze Seite.
@@ -9,7 +9,9 @@
use App\Domain\Commerce\Checkout;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\OrderHolders;
use App\Domain\Commerce\Shop;
use App\Domain\Commerce\StaleOverview;
use App\Domain\Commerce\Stripe\StripeGateway;
use App\Domain\Entitlement\GrantIssuer;
use App\Http\Controllers\Controller;
use Illuminate\Http\RedirectResponse;
@@ -99,9 +101,26 @@ public function show(Request $request, Order $order): View
return view('member.order', [
'order' => $order,
'testPayment' => ! app()->isProduction() && config('services.payment.driver') === 'test',
'stripePayment' => Shop::stripe(),
'zahlung' => $request->query('zahlung'),
]);
}
/** Leitet zur Stripe-Kasse (Testmodus). Freigeschaltet wird erst durch die signierte Meldung von Stripe. */
public function pay(Request $request, Order $order, StripeGateway $stripe): RedirectResponse
{
abort_unless($order->user_id === $request->user()->id, 403);
abort_unless(Shop::stripe(), 404);
try {
$session = $stripe->checkoutFor($order);
} catch (DomainRuleException $exception) {
return back()->withErrors(['payment' => $exception->getMessage()]);
}
return redirect()->away($session['url']);
}
public function confirm(Request $request, Order $order, Checkout $checkout): RedirectResponse
{
abort_unless($order->user_id === $request->user()->id, 403);
@@ -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,114 @@
<?php
namespace App\Http\Controllers;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Commerce\Checkout;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\Payment;
use App\Domain\Commerce\Shop;
use App\Domain\Commerce\Stripe\StripeSignature;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
/**
* Empfängt die signierten Meldungen von Stripe (Etappe 1: Testmodus). Ohne gültige Signatur geschieht nichts. Die
* Freischaltung nutzt denselben geprüften Weg wie die Testzahlung und ist bei Wiederholung wirkungslos.
* Antworten: 404 wenn Stripe nicht aktiv ist, 400 bei ungültiger Signatur, sonst 200 (Stripe wiederholt sonst).
*/
class StripeWebhookController extends Controller
{
public function __invoke(Request $request, StripeSignature $signature, Checkout $checkout): JsonResponse
{
abort_unless(Shop::stripe(), 404);
$payload = $request->getContent();
try {
$signature->verify($payload, $request->header('Stripe-Signature'));
} catch (DomainRuleException $exception) {
Log::warning('Stripe-Meldung abgewiesen', ['grund' => $exception->getMessage()]);
return response()->json(['error' => 'Ungültige Signatur.'], 400);
}
$event = json_decode($payload, true);
if (! is_array($event) || ! isset($event['type'])) {
return response()->json(['error' => 'Ungültige Nutzlast.'], 400);
}
$session = (array) ($event['data']['object'] ?? []);
return match ($event['type']) {
'checkout.session.completed', 'checkout.session.async_payment_succeeded' => $this->paid($session, $checkout),
'checkout.session.expired', 'checkout.session.async_payment_failed' => $this->notPaid($session, (string) $event['type']),
default => response()->json(['received' => true, 'handled' => false]),
};
}
/**
* @param array<string, mixed> $session
*/
private function paid(array $session, Checkout $checkout): JsonResponse
{
if (($session['payment_status'] ?? null) !== 'paid') {
return response()->json(['received' => true, 'handled' => false]);
}
$order = $this->orderOf($session);
$reference = (string) ($session['id'] ?? '');
if ($order === null || $reference === '') {
Log::warning('Stripe-Zahlung ohne zugehörige Bestellung', ['session' => $reference]);
return response()->json(['received' => true, 'handled' => false]);
}
try {
$checkout->confirmProviderPayment(
$order,
'stripe',
$reference,
(int) ($session['amount_total'] ?? -1),
(string) ($session['currency'] ?? ''),
);
} catch (DomainRuleException $exception) {
// Dauerhafter Fehler (Betragsabweichung, Bestellung nicht mehr offen): nichts freischalten, Zahlung zur
// Prüfung festhalten und 200 antworten, damit Stripe nicht endlos wiederholt.
Log::warning('Stripe-Zahlung nicht übernommen', ['order' => $order->id, 'session' => $reference, 'grund' => $exception->getMessage()]);
$order->payments()->updateOrCreate(['provider_reference' => $reference], ['provider' => 'stripe', 'status' => 'zu_pruefen']);
return response()->json(['received' => true, 'handled' => false]);
}
return response()->json(['received' => true, 'handled' => true]);
}
/**
* @param array<string, mixed> $session
*/
private function notPaid(array $session, string $type): JsonResponse
{
$payment = Payment::query()->where('provider', 'stripe')->where('provider_reference', (string) ($session['id'] ?? ''))->first();
// Die Bestellung bleibt offen und lässt sich erneut bezahlen; nur diese Kasse gilt nicht mehr.
if ($payment !== null && $payment->status === 'offen') {
$payment->status = $type === 'checkout.session.expired' ? 'abgelaufen' : 'fehlgeschlagen';
$payment->save();
}
return response()->json(['received' => true, 'handled' => $payment !== null]);
}
/**
* @param array<string, mixed> $session
*/
private function orderOf(array $session): ?Order
{
$id = $session['client_reference_id'] ?? ($session['metadata']['order_id'] ?? null);
return is_numeric($id) ? Order::query()->find((int) $id) : null;
}
}
+2
View File
@@ -17,6 +17,8 @@
)
->withMiddleware(function (Middleware $middleware): void {
$middleware->trustProxies(at: '*');
// Stripe sendet ohne Sitzung und CSRF-Token; die Signatur der Meldung ersetzt beides.
$middleware->validateCsrfTokens(except: ['stripe/webhook']);
$middleware->prepend(UseStaffSessionCookie::class);
$middleware->prepend(UseRequestRootUrl::class);
$middleware->prepend(IgnoreEmptyForwardedHeaders::class);
+7
View File
@@ -29,9 +29,16 @@
],
'payment' => [
// test: Testweg ohne Anbieter. stripe: Stripe-Kasse, in Etappe 1 nur mit Testschlüsseln (sk_test_).
'driver' => env('PAYMENT_DRIVER', 'test'),
],
'stripe' => [
'secret' => env('STRIPE_SECRET'),
'webhook_secret' => env('STRIPE_WEBHOOK_SECRET'),
'api_base' => env('STRIPE_API_BASE', 'https://api.stripe.com'),
],
'slack' => [
'notifications' => [
'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'),
@@ -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.
}
};
+4 -1
View File
@@ -27,7 +27,10 @@ MAIL_MAILER=log
MAIL_FROM_ADDRESS="noreply@example.invalid"
MAIL_FROM_NAME="${APP_NAME}"
# test bleibt der lokale Testweg. Ein echter Zahlungsdienst ist noch nicht festgelegt.
# test: lokaler Testweg ohne Anbieter. stripe: Stripe-Kasse, in Etappe 1 nur mit Testschlüsseln und nie in Produktion.
# Die Schlüssel stehen nur in /etc/luf/<umgebung>.env auf dem Server, nie im Repo.
PAYMENT_DRIVER=test
# STRIPE_SECRET=sk_test_... (Entwickler > API-Schlüssel, Testmodus)
# STRIPE_WEBHOOK_SECRET=whsec_... (Entwickler > Webhooks > Endpunkt > Signiergeheimnis)
# Medienpfade setzt Compose auf den Host-Mount (/srv/luf/<env>/media/...). Hier nichts eintragen.
@@ -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,7 @@ ## ADR-39 – Premium-Karten mit Fachbezug
- Gleiche Höhe je Zeile über die gemeinsame Höhe `fill` (ADR-38). Für gemischte Raster sind die Abschnittsraster 1 + 1 + 2 und 2 + 1 + 1 ergänzt (additiv, bestehende Kennungen unverändert).
**Alternativen.** Ein Widget mit mehreren Karten und eigenem Spannweitenraster (verworfen: zweites Kartenraster neben dem Abschnittsraster); eine Widget-Art mit Variante je Fachobjekt (verworfen: Verweisschema hinge von der Variante ab); redaktionell gepflegte Kartentexte (verworfen: Kopien von Fachdaten); Vorschaubilder der Bibliothek als Kartenbild (verworfen: geschützt, Paket 6).
**Nachbesserung (18.11.2026, nach Betreiberprüfung).** Themenkarten bieten alle Säulen an (nicht veröffentlichte nur für die Redaktionsvorschau). Medienkarten zeigen die Kurzbeschreibung des Mediums (auf ausdrücklichen Wunsch), unterscheiden Film (Filmtafel) und Material (Materialsymbol) und zeigen das geschützte Vorschaubild der Bibliothek nur in der Redaktionsvorschau. Traineranleitungen erscheinen nie öffentlich. Programm-/Modulkarten nutzen Lernziel und Dauer und lassen Programme/Module ohne Anzeigefreigabe für die Vorschau zu. Fehlende Inhalte erscheinen nur in der Vorschau als Hinweise.
**Nachbesserung 2 (21.11.2026, Betreiberwunsch).** Die Medienkarte wählt ihren Text je Karte (Automatisch, Teaser, Kurzbeschreibung, Ausführliche Beschreibung; `settings.text_source`). Die ausführliche Beschreibung ist damit auf ausdrückliche Wahl öffentlich (vorher nie). Ein Film liefert über `FilmStill` ein Einzelbild für die Karte: das Vorschaubild des Films oder eine gewählte Stelle, einmal gezogen (bis 1600 px) und als gewöhnliches Bild-Medium abgelegt, mit eigener Website-Freigabe; der Film bleibt geschützt. Additive Tabelle `film_still_sources`.
**Offene Entscheidungen.** (1) Freigabe von Vorschaubildern für die Website und öffentliche Filmvorschauen (minimaler Erweiterungsbedarf in `cms-widget-registry.md` §13). (2) Ob bei Traineranleitungen schon der Titel auf der Programmseite öffentlich sein soll (Programmseite, nicht Karte).
**Folgen und offene Prüfung.** Keine Migration; bestehende Seiten und Widgets unverändert (gemessen). Mit ADR-29 ersetzen öffentliche Profile die Übergangsregeln in `PublicCatalogReader` und `PublicMaterialReader`; die gespeicherten Karten ändern sich dadurch nicht. Offen: gestalterische Freigabe v1.7, freigegebene Motive statt Platzhaltern, eine kaufbare Angebotskarte (eigenes Fachobjekt „Angebot“ mit Umfang, Zweck und Lizenzbedingungen, nicht Teil dieser Karten).
**Quelle.** Brand-UI-Kit v1.7 (`docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf`, README, `docs/design-config.json`); `docs/architektur/cms-widget-registry.md` §§4, 6, 11, 13; ADR-29, ADR-30, ADR-38.
+5 -1
View File
@@ -312,6 +312,10 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**Darstellung** (Reiter „Darstellung“): Variante `adaptive` (ab 520 px Bild neben Text) oder `stacked` (Bild immer oben); Höhe `auto` oder `fill` („An die Zeile angleichen“); `settings.format` (`landscape` 16:9 Vorgabe, `square`, `portrait` 3:4); `settings.fit` (`cover` Vorgabe, `contain` für Dokumente und Poster); `settings.heading_level` (`h3` Vorgabe, `h2`, `h4`); Anzeigen/Ausblenden von Kurzbeschreibung, Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px).
**Text der Medienkarte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`); nur an der Medienkarte. `auto` entspricht dem bisherigen Verhalten (Kurzbeschreibung, sonst Teaser). Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Die ausführliche Beschreibung erscheint nur auf diese Wahl (öffentlich, sofern die Karte öffentlich ist). Der eigene Text der Karte (`data.summary`) hat Vorrang.
**Bild aus dem Film (Medienkarte).** Reiter „Medien“, nur bei einem Film: „Vorschaubild des Films übernehmen“ oder eine Stelle wählen. `FilmStill` legt das Einzelbild (bis 1600 px) einmal als Bild-Medium ab; `refs.image` trägt dessen Kennung. Details und Grenzen: `medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“.
**Redaktionsvorschau.** Nicht öffentliche Karten tragen die Marke „Nur Redaktionsvorschau“. Fehlende Inhalte (Kurzbeschreibung, Text für die Website, Anzeigetitel, Dauer, Laufzeit, Kartenbild) stehen eingeklappt unter „Hinweise für die Redaktion“, mit dem Ort, an dem sie gepflegt werden. Öffentlich erscheinen weder Marke noch Hinweise noch Bibliotheksbilder.
**Raster.** Eine Karte je Platz. Gemischte Raster entstehen über die Abschnittsraster, zum Beispiel 1 + 1 + 2 (`u1_1_2`), 2 + 2, 1 + 1 + 1 + 1. Gleiche Höhe: alle Karten einer Zeile auf „An die Zeile angleichen“ stellen; die Aktion steht dann am unteren Rand. Eine öffentlich nicht sichtbare Karte lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Solche Karten daher in einen eigenen Abschnitt setzen oder mit einem Platz kombinieren, der allein gut aussieht.
@@ -320,7 +324,7 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**Erweiterungsbedarf für öffentliche Vorschaubilder und Filmvorschauen (nicht umgesetzt, minimal):**
1. *Vorschaubild für die Website freigeben:* je `ContentElement` und `Composition` ein Freigabevermerk (`thumbnail_public_at`, `thumbnail_public_by`, Bezug auf `thumbnail_source`), gesetzt nur durch eine ausdrückliche Aktion „Vorschaubild für die Website freigeben“ in der Medien- bzw. Modulbearbeitung. Die Hintergrundverarbeitung kopiert das freigegebene Standbild nach `media_public` (eigener Pfad, zum Beispiel `katalog/`), Zurücknehmen löscht die Kopie. Die Karte nimmt dieses Bild, wenn kein Kartenbild gewählt ist. Der Web-Prozess schreibt weiterhin nicht in den Medienbestand.
2. *Öffentliche Filmvorschau (Trailer, Ausschnitt):* eine eigene Ausgabe (`MediaRendition` mit Rolle `preview`) und eine eigene Freigabe je Fassung, getrennt vom lizenzpflichtigen Film; ausgeliefert ohne Signatur nur nach dieser Freigabe. Bis dahin hat die Karte keine Abspielfunktion.
2. *Öffentliche Filmvorschau (Trailer, Ausschnitt; ein Einzelbild aus dem Film ist seit 21.11.2026 über FilmStill möglich):* eine eigene Ausgabe (`MediaRendition` mit Rolle `preview`) und eine eigene Freigabe je Fassung, getrennt vom lizenzpflichtigen Film; ausgeliefert ohne Signatur nur nach dieser Freigabe. Bis dahin hat die Karte keine Abspielfunktion.
3. *Laufzeit:* ein Feld in den Mediendaten der Fassung (zum Beispiel `metadata.duration_seconds`, beim Transkodieren mit ffprobe ermittelt).
Alle drei Erweiterungen hängen mit ADR-29 (öffentliche Profile) zusammen und brauchen eine Entscheidung von Lars.
@@ -27,7 +27,7 @@ ## Anzeige auf der Website
Solange öffentliche Profile (ADR-29) fehlen, ist das die Übergangsregel. Ein Medium hat keine eigene öffentliche Seite. Die Karte verweist dann auf die Programmseite.
Gelesen werden Anzeigename (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart und Ausgabeart. Nicht gelesen und nicht ausgegeben werden Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtext und jede Datei.
Gelesen werden Anzeigename (sonst Arbeitstitel), Inhaltsart und Ausgabeart sowie genau einer der Texte Teaser, Kurzbeschreibung oder ausführliche Beschreibung (siehe „Text der Medien- und Materialkarte“). Nicht gelesen und nicht ausgegeben werden Einsatzhinweis, Lizenzvermerk, Lehrtext und jede Datei.
Das Vorschaubild der Bibliothek erscheint nur in der Redaktionsvorschau, über die Route `editorial.card`, und nur für angemeldete Redaktion. Auf einer öffentlichen Seite hat dieses Bild keine Adresse.
@@ -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,41 @@ ## Präsentationszuordnungen (19.11.2026, ADR-41)
Öffentliche Seiten lesen ein Bild nur über `WebsiteImage` und damit über `WebsiteMedia`. Ein freigegebener Film oder ein Hörstück wird über `website.media` ausgeliefert. Geschützte Originaldateien und Vorschaubilder der Bibliothek bleiben auf diesem Weg geschlossen. Wird die Freigabe zurückgenommen, endet die öffentliche Ausgabe; Überschriften und Texte bleiben. Ein Widget ohne verbleibenden Inhalt entfällt.
Die ausführliche Beschreibung, Einsatzhinweise, Lizenzvermerke und Lehrtexte bleiben außerhalb der öffentlichen Karte. `PublicMaterialReader` und `PublicCatalogReader` lesen dafür die Klasse-A-Angaben (`EditorialProfileReader`) und keine Datei.
Einsatzhinweise, Lizenzvermerke und Lehrtexte bleiben außerhalb der öffentlichen Karte. Die ausführliche Beschreibung erscheint nur, wenn die Redaktion sie für diese Karte ausdrücklich wählt (siehe unten). `PublicMaterialReader` und `PublicCatalogReader` lesen dafür die Klasse-A-Angaben (`EditorialProfileReader`) und keine Datei.
## Text der Medien- und Materialkarte, Bild aus dem Film (21.11.2026)
### Text
Die Redaktion wählt je Karte in der Darstellung „Text der Karte“:
| Wahl | Text |
|---|---|
| Automatisch (Vorgabe) | Kurzbeschreibung, sonst Teaser (wie bisher) |
| Teaser | `teaser` |
| Kurzbeschreibung | `summary` |
| Ausführliche Beschreibung | `description` |
- Jede Wahl liest dieselbe Quelle wie die übrige Karte: das Medium, mit einer Abweichung für die Mitgliederbibliothek (`EditorialProfileReader`, Zielgruppe `bibliothek`), wenn es sie gibt. Die Zielgruppe `cms` („CMS-Teaser“) wird weiterhin nirgends gelesen; ein Wechsel würde bestehende Karten ändern und ist eine offene Frage.
- Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Ist der gewählte Text nicht gepflegt, bleibt die Karte ohne Text; die Redaktionsvorschau nennt, wo er zu pflegen ist. Öffentlich erscheint nie ein Hinweis.
- Der eigene Text der Karte (`data.summary`, „Text nur für diese Karte“) hat Vorrang vor der Wahl.
- **Neu öffentlich auf ausdrückliche Wahl:** die ausführliche Beschreibung, die bisher Bibliothekstext war. Der Dialog sagt das („erscheint öffentlich“). Einsatzhinweis und Lizenzvermerk sind nicht wählbar. Öffentlich ist die Karte weiterhin nur, wenn das Medium zu einem öffentlich gezeigten Programm gehört.
- Die Wahl gibt es nur an der Medien- und Materialkarte; Themen- und Programmkarte lesen weiter ihren Text.
### Bild aus dem Film
Das Vorschaubild eines Films (Medienmanager) und jede Filmstelle sind geschützt und erscheinen öffentlich nie. Für die Karte gibt es einen ausdrücklichen Weg, daraus ein Website-Bild zu machen. Im Reiter „Medien“ der Medienkarte, bei einem Film:
1. „Vorschaubild des Films übernehmen“ oder
2. eine Zeitposition wählen, „Anzeigen“, „Dieses Bild übernehmen“.
`FilmStill` zieht das Einzelbild **einmal** und legt es über `WebsiteIntake` als gewöhnliches Bild-Medium (`output_class = bild`) im Medienmanager ab. Die Warteschlange leitet es ab und gibt genau diese Ableitung frei, wie bei jedem Upload aus dem CMS. Die Karte speichert die Kennung dieses Bildes in `refs.image`.
- **Kein Neuziehen:** Seitenaufrufe lesen nur die gespeicherte Datei; `ffmpeg` läuft nur beim Übernehmen und in der Vorschau des Dialogs (Route `editorial.frame`, nur angemeldete Redaktion). Test: `FilmStillTest` zählt die Extraktionen.
- **Einmal je Stelle:** `film_still_sources` (additive Tabelle) ordnet Film, Quelle (`frame:{Fassung}@{Sekunde}` oder `file:{SHA-256}`) und Bild zu. Dieselbe Stelle, auch über „Vorschaubild übernehmen“ eines Filmbilds aus derselben Stelle, ergibt dasselbe Medium. Ein archiviertes 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).
+24
View File
@@ -27,6 +27,30 @@ ## Env-Datei ändern (zum Beispiel Mail, `APP_URL`)
**nginx findet die neue App selbst (seit 21.11.2026).** Der Web-Container löst den Namen `app` über Dockers DNS zur Laufzeit auf (`resolver 127.0.0.11` in `docker/nginx/default.conf`). Vorher war die Adresse beim Start von nginx festgeschrieben: Ein erneuter Lauf mit unverändertem Code erzeugte die App neu, nicht aber den Web-Container, und Prod antwortete mit 502, bis `luf-prod-web-1` neu gestartet wurde (20.11.2026). Ein Test (`tests/Unit/NginxConfigTest.php`) hält die Konfiguration fest.
## Stripe-Sandbox (nur Test, Etappe 1)
Die Stripe-Kasse läuft ausschließlich im Testmodus und nie in Produktion. Sie ist nur aktiv, wenn `PAYMENT_DRIVER=stripe` gesetzt ist; sonst bleibt es beim Testweg (`test`). Ein Schlüssel ohne `sk_test_` (oder `rk_test_`) wird abgewiesen, in Produktion lehnt die Anwendung Stripe ganz ab. Kartendaten berühren die Anwendung nie, bezahlt wird bei Stripe.
**Ablauf:** Bestellung anlegen, „Jetzt bezahlen (Stripe-Testmodus)“, Weiterleitung zur Stripe-Kasse. Freigeschaltet wird erst durch die signierte Meldung von Stripe an `POST /stripe/webhook` (Ereignis `checkout.session.completed`). Betrag und Währung werden gegen die Bestellung geprüft; wiederholte Meldungen schalten nichts doppelt frei. Eine Zahlung mit falschem Betrag oder auf eine nicht mehr offene Bestellung schaltet nichts frei und steht als Zahlung mit Status `zu_pruefen` in der Bestellung.
**Einrichten (Test):**
1. In Stripe den Testmodus („Sandbox“) wählen. Unter Entwickler > API-Schlüssel den Geheimschlüssel `sk_test_…` kopieren.
2. Unter Entwickler > Webhooks einen Endpunkt anlegen: URL `https://dev.laraundfelix.de/stripe/webhook`, Ereignisse `checkout.session.completed`, `checkout.session.expired`, `checkout.session.async_payment_succeeded`, `checkout.session.async_payment_failed`. Das Signiergeheimnis `whsec_…` des Endpunkts kopieren.
3. Auf llm-node in `/etc/luf/test.env` eintragen (Rechte `640`, nichts davon ins Repo, in Commits, Logs oder Chat):
```
PAYMENT_DRIVER=stripe
STRIPE_SECRET=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
```
4. In Gitea den letzten Lauf von „Deploy Test“ erneut starten (siehe „Env-Datei ändern“). `docker exec luf-test-app-1 printenv PAYMENT_DRIVER` muss `stripe` zeigen.
5. Testkauf mit der Stripe-Testkarte `4242 4242 4242 4242` (beliebiges künftiges Ablaufdatum, beliebige Prüfziffer). In Stripe unter Entwickler > Webhooks > Endpunkt > Ereignisse ist jede Zustellung samt Antwortcode zu sehen.
**Zurück zum Testweg:** `PAYMENT_DRIVER=test` setzen und neu ausrollen. Offene Stripe-Bestellungen bleiben offen.
**Grenzen:** Erstattungen laufen nicht über Stripe. Die Schaltfläche „Widerrufen“ ist im Stripe-Modus ausgeblendet; die Rückzahlung gehört zum Verkaufsstart (Live-Stripe, Belegprozess, Rückabwicklung). Steuer, Rechnung, Rabattcodes und Rechtstexte sind nicht Teil der Sandbox.
## Trennung Test und Prod (beide auf llm-node)
| | Test | Prod |
@@ -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,49 @@
{{--
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.
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: null, base: @js($framePfad) }">
<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
</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
</div>
</x-dynamic-component>
@@ -86,6 +86,14 @@
.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-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; }
+17 -4
View File
@@ -19,6 +19,11 @@
<div class="errors" role="alert">{{ $errors->first() }}</div>
@endif
<p class="state">Status: {{ $statusText }}</p>
@if ($order->status === 'offen' && $zahlung === 'zurueck')
<p class="state" role="status">Danke. Wir warten auf die Bestätigung von Stripe. Sobald sie da ist, steht die Bestellung auf „Bezahlt“. <a href="{{ route('member.order', $order) }}">Status neu laden</a></p>
@elseif ($order->status === 'offen' && $zahlung === 'abbruch')
<p class="state" role="status">Die Zahlung wurde abgebrochen. Es wurde nichts abgebucht. Du kannst erneut bezahlen.</p>
@endif
<dl class="facts">
<div><dt>Lizenzinhaber</dt><dd>{{ $order->party?->display_name }}</dd></div>
<div><dt>Bestellt von</dt><dd>{{ $order->user?->name }}</dd></div>
@@ -32,6 +37,12 @@
@endforeach
</ul>
<p class="state">Summe: {{ \App\Domain\Commerce\Money::format($order->total_cents ?? $order->lines->sum('price_cents')) }}</p>
@if ($stripePayment && $order->status === 'offen')
<form method="post" action="{{ route('member.order.pay', $order) }}">
@csrf
<button class="button" type="submit">Jetzt bezahlen (Stripe-Testmodus)</button>
</form>
@endif
@if ($testPayment && $order->status === 'offen')
<form method="post" action="{{ route('member.order.confirm', $order) }}">
@csrf
@@ -44,9 +55,11 @@
@endif
@if ($order->status === 'bezahlt')
<p><a class="button" href="{{ route('member.library') }}">Zur Bibliothek</a></p>
<form method="post" action="{{ route('member.order.refund', $order) }}">
@csrf
<button class="button button-quiet" type="submit">Widerrufen</button>
</form>
@if (! $stripePayment)
<form method="post" action="{{ route('member.order.refund', $order) }}">
@csrf
<button class="button button-quiet" type="submit">Widerrufen</button>
</form>
@endif
@endif
@endsection
@@ -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
+4
View File
@@ -14,6 +14,7 @@
use App\Http\Controllers\PublicCatalogController;
use App\Http\Controllers\PublicMediaController;
use App\Http\Controllers\ShopController;
use App\Http\Controllers\StripeWebhookController;
use App\Http\Controllers\ThemeController;
use App\Http\Controllers\WebsiteMediaController;
use App\Http\Middleware\EnsureShopEnabled;
@@ -42,6 +43,8 @@
});
});
Route::post('/stripe/webhook', StripeWebhookController::class)->name('stripe.webhook');
Route::middleware('guest')->group(function () {
Route::get('/registrieren', [RegistrationController::class, 'create'])->name('register');
Route::post('/registrieren', [RegistrationController::class, 'store']);
@@ -121,6 +124,7 @@
Route::post('/angebote/{offer}/abrufen', [CheckoutController::class, 'claim'])->name('offers.claim');
Route::post('/angebote/{offer}/kaufen', [CheckoutController::class, 'place'])->name('offers.buy');
Route::get('/bestellung/{order}', [CheckoutController::class, 'show'])->name('order');
Route::post('/bestellung/{order}/bezahlen', [CheckoutController::class, 'pay'])->name('order.pay');
Route::post('/bestellung/{order}/bestaetigen', [CheckoutController::class, 'confirm'])->name('order.confirm');
Route::post('/bestellung/{order}/ablehnen', [CheckoutController::class, 'fail'])->name('order.fail');
Route::post('/bestellung/{order}/widerrufen', [CheckoutController::class, 'refund'])->name('order.refund');
+174
View File
@@ -0,0 +1,174 @@
<?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']));
$this->assertArrayNotHasKey('text_source', $registry->get('program_card')->settingOptions());
$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];
}
}
+2 -2
View File
@@ -136,7 +136,7 @@ public function test_public_page_is_identical_for_guests_and_members(): void
public function test_global_layout_has_header_navigation_mobile_menu_and_footer(): void
{
// Der Warenkorb gehört zum Shop (Etappe 1, nur Testzahlung). Ohne aktiven Shop erscheint kein Kaufknopf.
config(['services.payment.driver' => 'stripe']);
config(['services.payment.driver' => 'unbekannt']);
$html = $this->get('/praevention')->assertOk()->getContent();
$this->assertStringContainsString('<a class="skip" href="#inhalt">', $html);
@@ -161,7 +161,7 @@ public function test_cart_entry_appears_only_when_the_shop_is_enabled(): void
// statt der früheren Vorbereitung über cms.cart.*.
$this->get('/praevention')->assertSee('Warenkorb')->assertSee('href="'.route('cart').'"', false);
config(['services.payment.driver' => 'stripe']);
config(['services.payment.driver' => 'unbekannt']);
$this->get('/praevention')->assertDontSee('Warenkorb');
}
+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();
}
}
+2 -1
View File
@@ -98,7 +98,8 @@ public function test_the_shop_exists_only_with_test_payment_and_never_in_product
{
$this->assertTrue(Shop::enabled());
config(['services.payment.driver' => 'stripe']);
// Ein nicht freigegebener Zahlungsweg (Stripe ist seit der Sandbox-Anbindung freigegeben, siehe StripeSandboxTest).
config(['services.payment.driver' => 'unbekannt']);
$this->get(route('shop'))->assertNotFound();
$this->get(route('cart'))->assertNotFound();
$this->post(route('cart.add', $this->privateKonflikte()))->assertNotFound();
+314
View File
@@ -0,0 +1,314 @@
<?php
namespace Tests\Feature;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\Shop;
use App\Domain\Entitlement\Acquisition;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Http\Client\Request as HttpRequest;
use Illuminate\Support\Facades\Http;
use Illuminate\Testing\TestResponse;
use Tests\Support\BuildsShop;
use Tests\TestCase;
/**
* Stripe-Sandbox (Etappe 1): Kasse über eine Checkout Session, Freischaltung nur durch die signierte Meldung.
* Alle Aufrufe an Stripe sind gefälscht (Http::fake); es geht nie ein echter Aufruf hinaus.
*/
class StripeSandboxTest extends TestCase
{
use BuildsShop;
use RefreshDatabase;
private const WEBHOOK_SECRET = 'whsec_testgeheimnis_nur_fuer_tests';
protected function setUp(): void
{
parent::setUp();
$this->seedShop();
config([
'services.payment.driver' => 'stripe',
'services.stripe.secret' => 'sk_test_nur_fuer_tests',
'services.stripe.webhook_secret' => self::WEBHOOK_SECRET,
'services.stripe.api_base' => 'https://stripe.test',
]);
$this->travelTo('2026-11-22 10:00:00');
}
public function test_stripe_is_a_shop_driver_but_never_in_production(): void
{
$this->assertTrue(Shop::enabled());
$this->assertTrue(Shop::stripe());
$this->app['env'] = 'production';
$this->assertFalse(Shop::enabled());
$this->assertFalse(Shop::stripe());
}
public function test_the_order_page_offers_stripe_and_not_the_test_buttons(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$this->actingAs($this->tina())->get(route('member.order', $order))
->assertOk()
->assertSee('Jetzt bezahlen (Stripe-Testmodus)')
->assertDontSee('Testzahlung bestätigen')
->assertDontSee('Testzahlung ablehnen');
}
public function test_paying_creates_a_checkout_session_with_the_order_amounts_and_redirects(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte(), $this->privateGrenzen()]);
Http::fake(['stripe.test/v1/checkout/sessions' => Http::response(['id' => 'cs_test_1', 'url' => 'https://checkout.stripe.test/c/pay/cs_test_1'])]);
$this->actingAs($this->tina())->post(route('member.order.pay', $order))
->assertRedirect('https://checkout.stripe.test/c/pay/cs_test_1');
Http::assertSent(function (HttpRequest $request) use ($order): bool {
parse_str($request->body(), $body);
return $request->url() === 'https://stripe.test/v1/checkout/sessions'
&& $request->hasHeader('Authorization', 'Bearer sk_test_nur_fuer_tests')
&& $request->hasHeader('Idempotency-Key', 'luf-order-'.$order->id.'-1')
&& $body['mode'] === 'payment'
&& $body['client_reference_id'] === (string) $order->id
&& $body['metadata']['order_id'] === (string) $order->id
&& $body['line_items'][0]['price_data']['currency'] === 'eur'
&& (int) $body['line_items'][0]['price_data']['unit_amount'] === 4900
&& (int) $body['line_items'][1]['price_data']['unit_amount'] === 2900
&& str_ends_with($body['success_url'], '?zahlung=zurueck')
&& str_ends_with($body['cancel_url'], '?zahlung=abbruch');
});
$this->assertSame('offen', $order->payments()->where('provider', 'stripe')->value('status'));
$this->assertSame('offen', $order->fresh()->status, 'Bezahlt wird erst durch die signierte Meldung.');
}
public function test_an_open_session_is_reused(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$order->payments()->create(['provider' => 'stripe', 'status' => 'offen', 'provider_reference' => 'cs_test_alt']);
Http::fake(['stripe.test/v1/checkout/sessions/cs_test_alt' => Http::response(['id' => 'cs_test_alt', 'status' => 'open', 'url' => 'https://checkout.stripe.test/alt'])]);
$this->actingAs($this->tina())->post(route('member.order.pay', $order))->assertRedirect('https://checkout.stripe.test/alt');
Http::assertNotSent(fn (HttpRequest $request): bool => $request->method() === 'POST');
}
public function test_an_expired_session_is_replaced_by_a_new_one(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$order->payments()->create(['provider' => 'stripe', 'status' => 'offen', 'provider_reference' => 'cs_test_alt']);
Http::fake([
'stripe.test/v1/checkout/sessions/cs_test_alt' => Http::response(['id' => 'cs_test_alt', 'status' => 'expired']),
'stripe.test/v1/checkout/sessions' => Http::response(['id' => 'cs_test_neu', 'url' => 'https://checkout.stripe.test/neu']),
]);
$this->actingAs($this->tina())->post(route('member.order.pay', $order))->assertRedirect('https://checkout.stripe.test/neu');
Http::assertSent(fn (HttpRequest $request): bool => $request->hasHeader('Idempotency-Key', 'luf-order-'.$order->id.'-2'));
}
public function test_only_the_buyer_pays_and_only_an_open_order(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
Http::fake();
$this->actingAs($this->max())->post(route('member.order.pay', $order))->assertForbidden();
Http::assertNothingSent();
$order->forceFill(['status' => 'bezahlt'])->save();
$this->actingAs($this->tina())->post(route('member.order.pay', $order))
->assertSessionHasErrors('payment');
Http::assertNothingSent();
}
public function test_only_test_keys_reach_stripe(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
Http::fake();
foreach (['sk_live_abc', '', 'pk_test_abc'] as $secret) {
config(['services.stripe.secret' => $secret]);
$this->actingAs($this->tina())->post(route('member.order.pay', $order))->assertSessionHasErrors('payment');
}
Http::assertNothingSent();
}
public function test_a_stripe_error_leaves_the_order_open_and_shows_a_plain_message(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
Http::fake(['stripe.test/*' => Http::response(['error' => ['type' => 'api_error']], 500)]);
$this->actingAs($this->tina())->post(route('member.order.pay', $order))
->assertSessionHasErrors(['payment' => 'Die Zahlung konnte bei Stripe nicht angelegt werden. Bitte versuche es später noch einmal.']);
$this->assertSame('offen', $order->fresh()->status);
$this->assertSame(0, $order->payments()->count());
}
public function test_a_signed_paid_event_grants_every_line_once_even_when_repeated(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte(), $this->privateGrenzen()]);
$payload = $this->sessionEvent('checkout.session.completed', $order, 'cs_test_bezahlt', 7800);
$this->webhook($payload)->assertOk()->assertJson(['handled' => true]);
$this->webhook($payload)->assertOk();
$this->assertSame('bezahlt', $order->fresh()->status);
$this->assertSame(2, Acquisition::query()->where('reference_type', 'order_line')->whereIn('reference_id', $order->lines()->pluck('id'))->count(), 'Je Position genau ein Erwerb.');
$this->assertSame(1, $order->payments()->count());
$payment = $order->payments()->first();
$this->assertSame('stripe', $payment->provider);
$this->assertSame('bestaetigt', $payment->status);
$this->assertSame('cs_test_bezahlt', $payment->provider_reference);
}
public function test_a_paid_event_confirms_the_open_payment_row_instead_of_adding_one(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$order->payments()->create(['provider' => 'stripe', 'status' => 'offen', 'provider_reference' => 'cs_test_zeile']);
$this->webhook($this->sessionEvent('checkout.session.completed', $order, 'cs_test_zeile', 4900))->assertOk();
$this->assertSame(1, $order->payments()->count());
$this->assertSame('bestaetigt', $order->payments()->first()->status);
}
public function test_an_unsigned_wrongly_signed_or_stale_message_does_nothing(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$payload = $this->sessionEvent('checkout.session.completed', $order, 'cs_test_x', 4900);
$before = Acquisition::query()->count();
$this->call('POST', route('stripe.webhook'), [], [], [], ['CONTENT_TYPE' => 'application/json'], $payload)->assertStatus(400);
$this->webhook($payload, 'sig-falsch')->assertStatus(400);
$this->webhook($payload, 't='.now()->getTimestamp().',v1=abc')->assertStatus(400);
$this->webhook($payload, $this->signature($payload, now()->subMinutes(10)->getTimestamp()))->assertStatus(400);
$this->webhook($payload.' ', $this->signature($payload))->assertStatus(400);
$this->assertSame('offen', $order->fresh()->status);
$this->assertSame($before, Acquisition::query()->count(), 'Es wird nichts freigeschaltet.');
}
public function test_a_wrong_amount_or_currency_grants_nothing_and_is_marked_for_review(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$this->webhook($this->sessionEvent('checkout.session.completed', $order, 'cs_test_zuwenig', 100))->assertOk()->assertJson(['handled' => false]);
$this->webhook($this->sessionEvent('checkout.session.completed', $order, 'cs_test_usd', 4900, 'usd'))->assertOk()->assertJson(['handled' => false]);
$this->assertSame('offen', $order->fresh()->status);
$this->assertSame(['zu_pruefen', 'zu_pruefen'], $order->payments()->orderBy('id')->pluck('status')->all());
}
public function test_an_unpaid_session_an_unknown_order_and_unknown_events_are_ignored(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$this->webhook($this->sessionEvent('checkout.session.completed', $order, 'cs_test_offen', 4900, 'eur', 'unpaid'))->assertOk()->assertJson(['handled' => false]);
$this->webhook($this->event('checkout.session.completed', ['id' => 'cs_x', 'client_reference_id' => '999999', 'payment_status' => 'paid', 'amount_total' => 1, 'currency' => 'eur']))->assertOk()->assertJson(['handled' => false]);
$this->webhook($this->event('customer.created', ['id' => 'cus_1']))->assertOk()->assertJson(['handled' => false]);
$this->assertSame('offen', $order->fresh()->status);
}
public function test_an_expired_session_keeps_the_order_open_and_payable(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$order->payments()->create(['provider' => 'stripe', 'status' => 'offen', 'provider_reference' => 'cs_test_abgelaufen']);
$this->webhook($this->sessionEvent('checkout.session.expired', $order, 'cs_test_abgelaufen', 4900, 'eur', 'unpaid'))->assertOk();
$this->assertSame('offen', $order->fresh()->status);
$this->assertSame('abgelaufen', $order->payments()->first()->status);
}
public function test_a_payment_for_an_order_that_is_no_longer_open_is_not_applied(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$order->forceFill(['status' => 'fehlgeschlagen'])->save();
$this->webhook($this->sessionEvent('checkout.session.completed', $order, 'cs_test_spaet', 4900))->assertOk()->assertJson(['handled' => false]);
$this->assertSame('fehlgeschlagen', $order->fresh()->status);
$this->assertSame('zu_pruefen', $order->payments()->first()->status);
}
public function test_the_webhook_does_not_exist_outside_stripe_mode_or_in_production(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$payload = $this->sessionEvent('checkout.session.completed', $order, 'cs_test_x', 4900);
config(['services.payment.driver' => 'test']);
$this->webhook($payload)->assertNotFound();
config(['services.payment.driver' => 'stripe']);
$this->app['env'] = 'production';
$this->webhook($payload)->assertNotFound();
$this->assertSame('offen', $order->fresh()->status);
}
public function test_without_a_webhook_secret_every_message_is_refused(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$payload = $this->sessionEvent('checkout.session.completed', $order, 'cs_test_x', 4900);
$header = $this->signature($payload);
config(['services.stripe.webhook_secret' => '']);
$this->webhook($payload, $header)->assertStatus(400);
$this->assertSame('offen', $order->fresh()->status);
}
public function test_the_return_page_explains_waiting_and_cancelling(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$this->actingAs($this->tina())->get(route('member.order', $order).'?zahlung=zurueck')->assertSee('Wir warten auf die Bestätigung von Stripe');
$this->actingAs($this->tina())->get(route('member.order', $order).'?zahlung=abbruch')->assertSee('Es wurde nichts abgebucht');
}
public function test_a_paid_order_offers_the_library_and_no_withdrawal_that_would_not_refund_money(): void
{
$order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);
$this->webhook($this->sessionEvent('checkout.session.completed', $order, 'cs_test_ok', 4900))->assertOk();
$this->actingAs($this->tina())->get(route('member.order', $order))
->assertSee('Zur Bibliothek')
->assertDontSee('Widerrufen');
}
/**
* @param array<string, mixed> $object
*/
private function event(string $type, array $object): string
{
return json_encode(['id' => 'evt_'.$type, 'object' => 'event', 'type' => $type, 'data' => ['object' => $object]], JSON_THROW_ON_ERROR);
}
private function sessionEvent(string $type, Order $order, string $sessionId, int $amount, string $currency = 'eur', string $paymentStatus = 'paid'): string
{
return $this->event($type, [
'id' => $sessionId,
'object' => 'checkout.session',
'client_reference_id' => (string) $order->id,
'payment_status' => $paymentStatus,
'amount_total' => $amount,
'currency' => $currency,
'metadata' => ['order_id' => (string) $order->id],
]);
}
private function signature(string $payload, ?int $timestamp = null): string
{
$timestamp ??= now()->getTimestamp();
return 't='.$timestamp.',v1='.hash_hmac('sha256', $timestamp.'.'.$payload, self::WEBHOOK_SECRET);
}
private function webhook(string $payload, ?string $signature = null): TestResponse
{
return $this->call('POST', route('stripe.webhook'), [], [], [], [
'CONTENT_TYPE' => 'application/json',
'HTTP_STRIPE_SIGNATURE' => $signature ?? $this->signature($payload),
], $payload);
}
}