Author SHA1 Message Date
LarsandClaude Opus 5.5 c4be6ed8dc Berichte die Umstellung auf die zentrale Medienverwaltung mit Prüfergebnissen.
CI Feature / test (push) Successful in 44s
Deploy Test / test (push) Successful in 45s
Deploy Test / deploy (push) Successful in 30s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 22:44:16 +01:00
LarsandClaude Opus 5.5 053a8d4648 Stelle alle CMS-Bilder auf die zentrale Medienverwaltung um.
CI Feature / test (push) Successful in 48s
Deploy Test / test (push) Successful in 44s
Deploy Test / deploy (push) Successful in 37s
- Einstieg, Bild und Text, redaktionelle Karten, Premium-Karten und Abschnittshintergrund speichern die
  Kennung des Mediums (Bildschlüssel image) und lesen über WebsiteMedia; öffentlich nur mit Website-Freigabe,
  in der Redaktionsvorschau sonst das Vorschaubild mit Hinweis.
- Gemeinsame Felder: Medienpicker mit Vorschaubild und Status, Upload direkt über WebsiteIntake, Anzeige des
  gewählten Mediums mit Verweis auf den Medienmanager. Die CMS-eigene Bildauswahl entfällt.
- Frühere CMS-Bilder übernimmt ein Warteschlangen-Job (dedupliziert, nichts gelöscht); website_media_aliases
  ordnet frühere Pfade zu, wirksam erst nach der ersten Website-Freigabe; /medien/cms/ folgt danach der Freigabe.
- Medienansicht nennt die Website-Seiten, die ein Bild verwenden.
- Bewusst geändert: Der Alternativtext gehört zum Medium und ist im Widget nur noch eine optionale Abweichung;
  die Tests zur Alt-Text-Pflicht prüfen jetzt Übernahme und andere Registry-Fehler.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 22:32:29 +01:00
LarsandClaude Opus 5.5 7c63424ea6 Leite Website-Bilder bis 2400 px statt in Vorschaugröße ab.
Ein Bild (Ausgabeart „bild“) dient über die Website-Freigabe auch als Einstieg und Abschnittshintergrund;
640 px wären bei 1440 px Fensterbreite sichtbar unscharf. Bilder werden nie vergrößert, transparente
Flächen werden weiß. Filmstandbilder und Modulvorschauen bleiben bei 640 px.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 22:13:12 +01:00
LarsandCursor 13530b8171 Gib Website-Bilder aus dem Medienmanager frei, ohne sie zu lizenzieren.
Deploy Test / test (push) Successful in 48s
Deploy Test / deploy (push) Successful in 29s
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-18 22:01:05 +01:00
LarsandCursor 72130d66c5 Mache den Medieneditor breit, ruhig und mit lesbaren Registerkarten.
Deploy Test / test (push) Successful in 52s
Deploy Test / deploy (push) Successful in 32s
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-18 20:51:36 +01:00
LarsandCursor d37a7093dd Pflege Anzeigedaten ohne neue Fassung und zeige sie in den echten Karten.
Deploy Test / test (push) Successful in 47s
Deploy Test / deploy (push) Successful in 28s
Der Medieneditor trennt Beschreibung, Inhalt, Fassungen und Verwendung. Der vorhandene Picker filtert nach Zusammenhang und lässt Entwürfe für die gemeinsame Freigabe sichtbar.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-18 20:03:56 +01:00
LarsandCursor 3e56314cf9 Zeige den Medienbestand als Kacheln und Liste mit Fassung, Freigabe und Verwendung.
Deploy Test / test (push) Successful in 45s
Deploy Test / deploy (push) Successful in 30s
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-18 19:44:51 +01:00
LarsandClaude Opus 5.5 8a6678aad7 Trage die Prüfung der Premium-Karten auf der Testinstanz in den Bericht ein.
CI Feature / test (push) Successful in 41s
Deploy Test / test (push) Successful in 40s
Deploy Test / deploy (push) Successful in 35s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 17:08:37 +01:00
LarsandClaude Opus 5.5 b178939852 Ergänze den Bericht zur Nachbesserung und streiche den nicht behebbaren Laufzeit-Hinweis.
CI Feature / test (push) Successful in 48s
Deploy Test / test (push) Successful in 47s
Deploy Test / deploy (push) Successful in 28s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 16:23:59 +01:00
LarsandClaude Opus 5.5 a08067c078 Mache die Premium-Karten mit vorhandenen Fachobjekten nutzbar.
- Themenkarte: alle Säulen wählbar; nicht veröffentlichte nur in der Redaktionsvorschau.
- Medienkarte: Kurzbeschreibung, Film (Filmtafel, Hinweis auf den geschützten Film) und Material
  (Materialsymbol) getrennt; Filmstandbild der Bibliothek nur in der Redaktionsvorschau, markiert;
  Entwürfe wählbar, gesperrte nicht; Traineranleitungen nie öffentlich.
- Programm-/Modulkarte: Lernziel als Text, Dauer und Modulzahl; Programme/Module ohne Anzeigefreigabe
  für die Vorschau wählbar; Module weiterhin ohne Link.
- Fehlende Inhalte nur in der Vorschau als eingeklappte Redaktionshinweise.
- Tests bewusst angepasst: Medien zeigen jetzt die Kurzbeschreibung (Betreibervorgabe), unveröffentlichte
  Themen und Programme ohne Freigabe sind wählbar.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 16:20:40 +01:00
LarsandClaude Opus 5.5 bc1f84ac89 Zeige von Medien keine Kurzbeschreibung und begrenze die Kartenbildhöhe.
CI Feature / test (push) Successful in 43s
Deploy Test / test (push) Successful in 40s
Deploy Test / deploy (push) Successful in 34s
- Medienkarten nennen öffentlich nur Titel, Art und Programmzugehörigkeit; die Kurzbeschreibung eines
  Elements ist heute nirgends öffentlich (offene Entscheidung, ADR-39).
- PublicMaterialReader je Anfrage einmal (scoped), nicht je Karte.
- Kartenbild höchstens min(70vh, 640 px), damit breite gestapelte Karten nicht übermäßig hoch werden.
- Bericht mit Prüfungen, Grenzen und dem offenen Bedarf einer kaufbaren Angebotskarte.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 13:58:10 +01:00
LarsandClaude Opus 5.5 39ab25d8c6 Dokumentiere die Premium-Karten v1.7 (ADR-39, Registry, Designsystem).
CI Feature / test (push) Successful in 39s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 13:33:35 +01:00
LarsandClaude Opus 5.5 127ea86817 Integriere die Premium-Karten v1.7 als Themen-, Medien- und Programmkarte.
CI Feature / test (push) Successful in 46s
Deploy Test / test (push) Successful in 39s
Deploy Test / deploy (push) Successful in 29s
- Drei Widget-Arten (topic_card, media_card, program_card) auf gemeinsamer Basis, eine Karte je Platz im
  bestehenden Abschnittsraster; kein zweites Kartenraster.
- Titel, Kurzbeschreibung, Art, Zusatzangaben und Linkziel kommen zur Laufzeit aus Thema, Inhaltselement
  bzw. Programm/Modul; im CMS stehen nur Kennungen, Bild, Bildausschnitt, Beschriftung und Hinweis.
- Medienkarten sind öffentlich nur als Bestandteil eines öffentlichen Programms (PublicMaterialReader),
  Module nur in der Redaktionsvorschau; keine Bibliotheksbilder, kein Preis, keine Kaufaktion.
- Gleiche Höhe je Zeile über die gemeinsame Höhe „fill“; Raster 1 + 1 + 2 und 2 + 1 + 1 ergänzt.
- Tests zu Raster- und Widgetliste bewusst um die neuen Raster und Arten erweitert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 13:25:06 +01:00
LarsandClaude Opus 5.5 cca069be48 Dokumentiere die vereinfachten Abschnittsabstände mit Messwerten.
CI Feature / test (push) Successful in 38s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 28s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 12:47:03 +01:00
LarsandClaude Opus 5.5 f511ad10de Vereinfache die Abschnittsabstände auf oben, unten und Widget-Abstand.
CI Feature / test (push) Successful in 42s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 31s
Die Abschnittshülle Version 2 kennt genau drei unabhängige Abstände mit
denselben Stufen (Kein Abstand, Kompakt, Normal, Großzügig):
- spacing_top / spacing_bottom: Innenabstand des Abschnitts; zwischen
  zwei Abschnitten addieren sich unten und oben (0 + 0 = 0).
- gap: Abstand zwischen den Plätzen des Rasters, nebeneinander und
  gestapelt. Widget-Innenabstände bleiben im Widget.

Entfallen sind „Abstand oben und unten“, die Abweichung „Abstand oben“
(same/small/none), die versteckte Regel, die oben zwischen zwei
Abschnitten ohne Fläche auf null setzte, und der Trenner „Zusätzlicher
Abstand“.

Hüllen der Version 1 werden beim Lesen ohne Layoutänderung übersetzt
(SectionStyle::migrateSpacing); gespeicherte Revisionen bleiben. Einzige
Abweichung: „Gering“ hat keine eigene Stufe mehr und wird „Kompakt“.

Tests bewusst angepasst (Hüllenversion 2, neue Klassen, Prüfung freier
Werte über die neuen Schlüssel); neue Tests für Addition, Vorgaben und
die Übersetzung aller Fälle der Version 1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 12:39:57 +01:00
LarsandClaude Opus 5.5 f4d225d0b2 Dokumentiere die Nachprüfung der Referenzseite, Abstand oben und Wortmarke.
CI Feature / test (push) Successful in 38s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 28s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 12:07:02 +01:00
LarsandClaude Opus 5.5 89fd95b243 Mache jede Seite in der Liste auffindbar, binde die freigegebene Wortmarke ein und erlaube Abstand oben.
CI Feature / test (push) Successful in 46s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 27s
- Seitenliste: zuletzt bearbeitete Seiten zuerst, „Zuletzt bearbeitet“
  in deutscher Zeit (jede Revision und Veröffentlichung aktualisiert
  die Seite), Pfad und Datum sortierbar, 25/50/100 je Seite. Bisher
  stand eine neue Seite ohne Suche auf einer späteren Listenseite.
- Kopfzeile und Fußbereich zeigen die freigegebene Lara-&-Felix-
  Wortmarke (Kompaktfassung aus Brand-UI-Kit 08) als zugeschnittene
  WebP-Ableitung mit festen Maßen; Ausgangszustand ≈ 80 px, kompakt
  60 px, Smartphone 48 px. Mitgliederbereich unverändert.
- Abschnittsgestaltung „Abstand oben“ (wie Abstand / gering / kein):
  Der erste Abschnitt kann direkt unter der Kopfzeile beginnen; der
  Abstand unten und alle anderen Abschnitte bleiben unverändert.

Tests: Erwartung an die Wortmarke bewusst angepasst (brand-logo statt
brand-lockup); neue Tests für Liste, Bearbeitungsdatum und Abstand oben.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 11:54:10 +01:00
LarsandClaude Opus 5.5 87a7ffc45f Dokumentiere die adaptiven Widgets mit Prüfergebnissen und Screenshots.
CI Feature / test (push) Successful in 37s
Deploy Test / test (push) Successful in 36s
Deploy Test / deploy (push) Successful in 29s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 11:02:52 +01:00
LarsandClaude Opus 5.5 0bfb53463a Führe einen gemeinsamen Layoutvertrag ein und integriere die Premium-Widgets.
CI Feature / test (push) Successful in 41s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 33s
Layoutvertrag (ADR-38) in der bestehenden Registry: Jede Widget-Art
erklärt zulässige Rasterbreiten (supportedUnits), Höhen aus einem
gemeinsamen Vokabular (heights, gespeichert als settings.height),
Darstellungsmodi und Verhalten bei wenig Platz. Unzulässige Breiten
werden beim Speichern verständlich abgewiesen; Höhe „fill“ streckt
den Handlungsaufruf auf die Abschnittszeile.

Premium-Widgets nach Brand-UI-Kit v1.6:
- hero Version 2: photo_split/editorial_solid, Höhen compact/normal/
  large, Label, Überschriftenebene, Akzent, Bildfokus in Prozent, zwei
  Schaltflächen; nur 3 oder 4 Einheiten. Upgrade aus Version 1.
- image_text Version 3: Fläche cream/clear/navy, Höhen compact/normal/
  spacious, Label, zwei Schaltflächen, Bildfokus; 1 bis 4 Einheiten.
  Upgrade aus Version 2 (format entfällt, Fokus in Prozent).
- Kit-CSS ersetzt das bisherige Hero- und Bild-und-Text-CSS; der
  Randlos-Mechanismus der Designiteration 1 entfällt.

Editor: Reiter Inhalt/Medien/Darstellung aus der Registry, Auswahl-
knöpfe mit Symbolen, Schieberegler für den Bildfokus und eine Live-
Vorschau im Dialog mit demselben Renderer in wählbarer Platzbreite.

Tests bewusst angepasst: Einstieg braucht jetzt 3 oder 4 Einheiten
(vorher Mindestbreite 2), image_text ist Version 3, Klassen der neuen
Ansichten; die Hero-/Bild-Tests der Designiteration 1 sind durch
CmsPremiumWidgetsTest ersetzt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 10:20:09 +01:00
Lars 3cdb36e7a3 design kit update
CI Feature / test (push) Successful in 35s
2026-11-18 09:44:48 +01:00
Lars 5dccbbce80 Add SEO and Marketing Strategy Documentation for Lara & Felix Platform
CI Feature / test (push) Successful in 36s
- Introduced comprehensive SEO and marketing requirements in a new document (SEO-Marketing.md) to enhance visibility and user engagement.
- Developed a strategic framework for the ongoing development of the Lara & Felix platform, focusing on digital product strategy, user experience, and marketing automation in a new document (Strategieentwicklung.md).
2026-11-18 09:44:08 +01:00
LarsandClaude Opus 5.5 8a3f6df770 Bringe Bericht und Designsystem auf den bereitgestellten Stand.
CI Feature / test (push) Successful in 33s
Deploy Test / test (push) Successful in 31s
Deploy Test / deploy (push) Successful in 30s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 07:43:30 +01:00
LarsandClaude Opus 5.5 656f999d2c Setze die Breitenstufen der Kopfzeile vor dem ersten Zeichnen.
CI Feature / test (push) Successful in 36s
Deploy Test / test (push) Successful in 32s
Deploy Test / deploy (push) Successful in 32s
Bei 1280 bis 1920 px zeigten die ersten Frames die volle, überlaufende
Navigation, bis das verzögert geladene Modul umschaltete. Die Messung
steht jetzt als window.lufHeaderMode inline direkt nach der Kopfzeile
(nach dem Stylesheet, vor dem Zeichnen); site-nav.js wiederholt sie bei
Größenänderungen und nach dem Laden der Schriften.

Außerdem: Widget-Vorschau ohne Scrollbalken-Reserve, feine Linie über
dem Fußbereich, wenn die Seite mit einer dunklen Fläche endet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 07:30:40 +01:00
LarsandClaude Opus 5.5 8387cc90df Dokumentiere Designiteration 1 mit Prüfergebnissen und Screenshots.
CI Feature / test (push) Successful in 32s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 07:19:43 +01:00
LarsandClaude Opus 5.5 d89d4bdc70 Verlängere den Markenstrich im Editorial-Einstieg.
CI Feature / test (push) Successful in 39s
Deploy Test / test (push) Successful in 32s
Deploy Test / deploy (push) Successful in 28s
Der kurze Strich lag unter dem ersten Wort der letzten Zeile und wirkte
wie die Hervorhebung eines einzelnen Wortes. Er läuft jetzt als Linie
unter der Überschrift.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 07:15:11 +01:00
LarsandClaude Opus 5.5 7c1caec546 Miss die Navigationsbreite ohne Kopie im DOM.
CI Feature / test (push) Successful in 38s
Deploy Test / test (push) Successful in 31s
Deploy Test / deploy (push) Successful in 40s
Die Messkopie verdoppelte Navigationselemente samt Zustandsklassen und
störte Prüfungen, die die Navigation über Klassen finden. Gemessen wird
jetzt an der echten Navigation: Zustandsklassen werden innerhalb eines
Aufrufs entfernt und wiederhergestellt, ohne Zeichnen dazwischen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 07:10:02 +01:00
LarsandClaude Opus 5.5 8390dcdb41 Schirme die Messkopie der Navigation vollständig ab.
CI Feature / test (push) Successful in 35s
Deploy Test / test (push) Successful in 32s
Deploy Test / deploy (push) Successful in 29s
Die unsichtbare Kopie für die Breitenmessung trug Kennungen, Ziele und
Skript-Merkmale der echten Navigation sowie die Klasse site-header.
Sie ist jetzt inert, ohne id, href, aria- und data-Attribute und ohne
Kopfzeilenklasse; der Abstand zur Wortmarke wird an der echten
Navigation gemessen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 06:55:25 +01:00
LarsandClaude Opus 5.5 33aaf64024 Stabilisiere den Website-Rahmen und veredele die zentralen Widgets.
CI Feature / test (push) Successful in 36s
Deploy Test / test (push) Successful in 32s
Deploy Test / deploy (push) Successful in 32s
Designiteration 1 auf Grundlage des Brand-UI-Kits (vorläufige Werte):
- Kopfzeile mit konstanter Box und zwei Zuständen (großzügig, kompakt
  beim Scrollen) ohne Layoutsprung; Navigation bricht nie um, sondern
  verkürzt erst den Kontozugang und schaltet dann in den Menümodus.
  Scrollbalken-Reserve, gemeinsames Breitenmodell (Lesebereich,
  Standard, Breit, Vollbreite), Wortmarke und Inhalt fluchten.
- Fokusfalle im Mobilmenü schließt auch den Weg von der
  Menü-Schaltfläche in den Inhalt.
- Fußbereich mit Grundzeile für rechtliche Links und grünem Bogen.
- Markenakzente (Unterstreichung, Strahlen, Bogen) als Komponenten.
- Hero: Varianten Markenbühne (randlos) und Editorial, zweite
  Schaltfläche, Bildausschnitt. Bild und Text: Bildformat und
  Ausschnitt. Karten: hervorgehobene erste Karte, ganze Karte klickbar.
  Programmkarten mit Markentafel. Alles additiv, ohne neue Version.

Testanpassungen: Die Website-Wortmarke trägt jetzt brand-lockup, die
erste Hero-Schaltfläche button-brand (beabsichtigte Gestaltung).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 06:43:13 +01:00
172 changed files with 16785 additions and 888 deletions

No files matched your search

+5
View File
@@ -17,6 +17,10 @@ class ContentElement extends Model
'description',
'usage_note',
'license_note',
'website_credit',
'website_alt',
'website_released_at',
'website_public_path',
'summary',
'thumbnail_path',
'thumbnail_alt',
@@ -30,6 +34,7 @@ protected function casts(): array
{
return [
'archived_at' => 'datetime',
'website_released_at' => 'datetime',
];
}
+40
View File
@@ -0,0 +1,40 @@
<?php
namespace App\Domain\Cms\Catalog;
/**
* Anzeigedaten des Fachobjekts hinter einer Premium-Karte (Thema, Medium/Material, Programm/Modul).
* Wird zur Laufzeit aus den maßgeblichen Fachdaten gelesen und nie im CMS gespeichert.
*
* - url: nur ein öffentlich freigegebenes Ziel aus dem Fachobjekt (Themenseite, Programmseite), sonst null.
* - public: false heißt „nur in der Redaktionsvorschau“; öffentlich entfällt die Karte dann.
* - notice: redaktioneller Hinweis für die Vorschau, warum die Karte öffentlich nicht erscheint.
* - visual: Darstellung ohne Kartenbild: 'film' (Medientafel Film), 'material' (Materialsymbol),
* 'catalog' (Navy-Tafel Programm/Modul) oder null (Karte ohne Bildbereich).
* - previewImage: geschütztes Vorschaubild der Bibliothek (Filmstandbild, Vorschau des Moduls). Nur für die
* 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.
*/
final readonly class CardSubject
{
/**
* @param list<string> $meta reine Anzeigetexte aus Fachdaten
* @param list<string> $missing Hinweise für die Redaktion
*/
public function __construct(
public string $title,
public ?string $summary,
public string $kind,
public ?string $badge,
public array $meta,
public ?string $url,
public bool $public,
public ?string $notice = null,
public ?string $visual = null,
public ?string $visualLabel = null,
public ?string $previewImage = null,
public array $missing = [],
public ?string $style = null,
) {}
}
@@ -5,7 +5,9 @@
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionDisplayRelease;
use App\Domain\Catalog\CompositionVersion;
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Media\ThumbnailRef;
use Illuminate\Support\Collection;
/**
@@ -171,6 +173,162 @@ public function entries(array $refs, bool $includeNonPublic): array
return $entries;
}
/**
* Für die Programm- oder Modulkarte wählbar: Programm oder Modul, nicht archiviert, mit mindestens einer
* bereitgestellten Fassung. Anders als bei den Katalogkarten ist keine Anzeigefreigabe nötig, damit die Redaktion
* eine Karte vorbereiten kann; öffentlich gilt unverändert isPublic().
*/
public function isCardSelectable(Composition $composition): bool
{
return $composition->archived_at === null
&& in_array($composition->editorialContentKind?->slug, self::SELECTABLE_KINDS, true)
&& $this->latestReadyVersion($composition) !== null;
}
/**
* @return array<int, string>
*/
public function cardSearch(?string $term, int $limit = 25): array
{
$term = trim((string) $term);
$candidates = Composition::query()
->with('editorialContentKind')
->whereNull('archived_at')
->whereHas('editorialContentKind', fn ($query) => $query->whereIn('slug', self::SELECTABLE_KINDS))
->when($term !== '', function ($query) use ($term): void {
$like = '%'.mb_strtolower($term).'%';
$query->where(fn ($inner) => $inner
->whereRaw('LOWER(designation) LIKE ?', [$like])
->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like]));
})
->orderBy('designation')
->limit($limit * 3)
->get();
$options = [];
foreach ($candidates as $composition) {
if (! $this->isCardSelectable($composition)) {
continue;
}
$options[$composition->id] = $this->cardOptionLabel($composition);
if (count($options) >= $limit) {
break;
}
}
return $options;
}
public function cardLabelFor(mixed $id): ?string
{
$composition = is_numeric($id) ? Composition::query()->with('editorialContentKind')->find((int) $id) : null;
return $composition === null ? null : $this->cardOptionLabel($composition);
}
/**
* Anzeigedaten für eine Programm- oder Modulkarte (Premium-Karte).
*
* - Öffentlich nur Programme mit Anzeigefreigabe (dieselbe Regel wie /programme), mit Programmseite als Ziel.
* Module haben keine öffentliche Seitenart (ADR-29) und erscheinen nur in der Redaktionsvorschau, ohne Link.
* - Text: Kurzbeschreibung, sonst das Lernziel der gezeigten (öffentlich) bzw. neuesten bereitgestellten Fassung;
* das Lernziel steht auf der öffentlichen Programmseite bereits öffentlich.
* - Zusatzangaben: Zahl der Module, Dauer. Kein Preis, kein Angebot, keine Kaufaktion; eine Karte ist kein
* Lizenzartikel. Das Vorschaubild der Bibliothek erscheint nur in der Redaktionsvorschau.
*/
public function subject(mixed $id, bool $includeNonPublic): ?CardSubject
{
$composition = is_numeric($id) ? Composition::query()->with('editorialContentKind')->find((int) $id) : null;
if ($composition === null || ! $this->isCardSelectable($composition)) {
return null;
}
$shown = $this->shownVersion($composition);
$public = $shown !== null && $composition->archived_at === null;
if (! $public && ! $includeNonPublic) {
return null;
}
$version = $shown ?? $this->latestReadyVersion($composition);
$program = $composition->editorialContentKind?->slug === 'programm';
$kind = (string) ($composition->editorialContentKind?->label ?? ($program ? 'Programm' : 'Modul'));
$summary = filled($composition->summary) ? trim((string) $composition->summary) : null;
$goal = filled($version?->learning_goal) ? trim((string) $version->learning_goal) : null;
$missing = [];
if ($summary === null) {
$missing[] = $goal !== null
? 'Keine Kurzbeschreibung gepflegt; die Karte zeigt das Lernziel.'
: 'Weder Kurzbeschreibung noch Lernziel gepflegt.';
}
$meta = [];
if ($version !== null) {
$modules = $version->members()
->whereNotNull('nested_composition_version_id')
->with('nestedCompositionVersion.composition.editorialContentKind')
->get()
->filter(fn ($member): bool => $member->nestedCompositionVersion?->composition?->editorialContentKind?->slug === 'modul')
->count();
if ($program && $modules > 0) {
$meta[] = $modules === 1 ? '1 Modul' : $modules.' Module';
}
if (is_numeric($version->duration_minutes) && (int) $version->duration_minutes > 0) {
$meta[] = 'Dauer '.(int) $version->duration_minutes.' Min.';
} else {
$missing[] = 'Keine Dauer gepflegt.';
}
}
$notice = null;
if (! $public) {
$notice = 'Nur in der Redaktionsvorschau sichtbar: '.($program
? 'Das Programm hat keine Anzeigefreigabe.'
: 'Für Module gibt es noch keine öffentliche Seitenart (öffentliches Profil, ADR-29); die Karte erhält deshalb keinen Link.');
}
return new CardSubject(
title: $this->title($composition),
summary: $summary ?? $goal,
kind: $kind,
badge: null,
meta: $meta,
url: $public ? route('public.program', $composition) : null,
public: $public,
notice: $notice,
visual: 'catalog',
visualLabel: $kind,
previewImage: $includeNonPublic ? ThumbnailRef::url('editorial.card', 'komposition', (int) $composition->id, $composition->thumbnail_path) : null,
missing: $missing,
);
}
private function latestReadyVersion(Composition $composition): ?CompositionVersion
{
return $composition->versions()
->where('status', ContentVersionStatus::Bereit->value)
->orderByDesc('number')
->first();
}
private function cardOptionLabel(Composition $composition): string
{
$visibility = match (true) {
$this->isPublic($composition) => 'öffentlich sichtbar',
$composition->editorialContentKind?->slug === 'modul' => 'Modul, nur Redaktionsvorschau',
default => 'ohne Anzeigefreigabe, nur Redaktionsvorschau',
};
return $this->title($composition).' · '.($composition->editorialContentKind?->label ?? '').' · '.$visibility;
}
private function title(Composition $composition): string
{
return (string) ($composition->display_title ?: $composition->designation);
@@ -0,0 +1,272 @@
<?php
namespace App\Domain\Cms\Catalog;
use App\Domain\Catalog\CompositionStructureReader;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\StructureNode;
use App\Domain\Media\ThumbnailRef;
/**
* Lesesicht „Medien und Materialien“ für Premium-Karten (Website-CMS-Zielarchitektur 6.2).
*
* Auswahl in der Redaktion: jedes nicht archivierte Inhaltselement mit mindestens einer nicht gesperrten Fassung.
*
* Öffentliche Sichtbarkeit (Übergangsregel, solange öffentliche Fachobjektprofile nach ADR-29 fehlen):
* Ein Medium hat keine eigene öffentliche Seite. Öffentlich genannt wird es heute nur als Bestandteil der gezeigten
* Fassung eines öffentlichen Programms (Programmseite /programme/{id}). Genau dann erscheint auch die Karte
* ö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.
* Eine Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei.
*/
class PublicMaterialReader
{
/** Inhaltsarten, die nie öffentlich auf einer Karte erscheinen. */
public const CONFIDENTIAL_KINDS = ['traineranleitung'];
/** @var array<int, array{id: int, title: string}>|null Element-ID => erstes öffentliches Programm */
private ?array $publicIndex = null;
public function __construct(
private readonly PublicCatalogReader $catalog,
private readonly CompositionStructureReader $structure,
) {}
public function isSelectable(ContentElement $element): bool
{
return $element->archived_at === null
&& $element->versions()->where('status', '!=', ContentVersionStatus::Gesperrt->value)->exists();
}
public function isReady(ContentElement $element): bool
{
return $element->versions()->where('status', ContentVersionStatus::Bereit->value)->exists();
}
/**
* Öffentliches Programm, in dessen gezeigter Fassung das Element vorkommt, sonst null.
*
* @return array{id: int, title: string}|null
*/
public function publicProgramFor(ContentElement $element): ?array
{
return $this->publicIndex()[$element->id] ?? null;
}
public function isPublic(ContentElement $element): bool
{
return $this->isSelectable($element)
&& $this->isReady($element)
&& ! in_array($element->editorialContentKind?->slug, self::CONFIDENTIAL_KINDS, true)
&& $this->publicProgramFor($element) !== null;
}
/**
* @return array<int, string>
*/
public function search(?string $term, int $limit = 25): array
{
$term = trim((string) $term);
$candidates = ContentElement::query()
->with('editorialContentKind')
->whereNull('archived_at')
->whereHas('versions', fn ($query) => $query->where('status', '!=', ContentVersionStatus::Gesperrt->value))
->when($term !== '', function ($query) use ($term): void {
$like = '%'.mb_strtolower($term).'%';
$query->where(fn ($inner) => $inner
->whereRaw('LOWER(working_title) LIKE ?', [$like])
->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like]));
})
->orderBy('working_title')
->limit($limit)
->get();
$options = [];
foreach ($candidates as $element) {
$options[$element->id] = $this->optionLabel($element);
}
return $options;
}
public function labelFor(mixed $id): ?string
{
$element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null;
return $element === null ? null : $this->optionLabel($element);
}
/**
* Anzeigedaten für eine Karte. Öffentlich null, wenn das Element nicht öffentlich genannt wird.
*
* @param array<string, mixed> $draft ungespeicherte Anzeigedaten, nur für die Redaktionsvorschau
*/
public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?CardSubject
{
$element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null;
if ($element === null || ! $this->isSelectable($element)) {
return null;
}
$public = $this->isPublic($element);
if (! $public && ! $includeNonPublic) {
return null;
}
$shown = clone $element;
foreach (['working_title', 'display_title', 'summary', 'thumbnail_path', 'thumbnail_alt'] as $field) {
if (! array_key_exists($field, $draft)) {
continue;
}
$value = $draft[$field];
$shown->setAttribute($field, is_string($value) && trim($value) === '' ? null : $value);
}
$program = $this->publicProgramFor($element);
$output = self::outputLabel((string) $shown->output_class);
$film = $shown->output_class === 'film';
$editorialKind = $element->editorialContentKind?->label;
$summary = filled($shown->summary) ? trim((string) $shown->summary) : null;
$meta = [$output];
if ($program !== null) {
$meta[] = 'Im Programm „'.$program['title'].'“';
}
if ($film) {
$meta[] = 'Vollständiger Film nur mit Lizenz im Mitgliederbereich';
}
$missing = [];
if ($summary === null) {
$missing[] = 'Keine Kurzbeschreibung gepflegt (Medium bearbeiten → Kurzbeschreibung).';
}
if (! filled($shown->display_title)) {
$missing[] = 'Kein Anzeigetitel gepflegt; die Karte zeigt den Arbeitstitel.';
}
$previewImage = $includeNonPublic ? ThumbnailRef::url('editorial.card', 'element', (int) $element->id, $shown->thumbnail_path) : null;
return new CardSubject(
title: (string) ($shown->display_title ?: $shown->working_title),
summary: $summary,
kind: filled($editorialKind) ? (string) $editorialKind : $output,
badge: $output,
meta: $meta,
url: $public && $program !== null ? route('public.program', $program['id']) : null,
public: $public,
notice: $public ? null : $this->notice($element, $program),
visual: $film ? 'film' : 'material',
visualLabel: $output,
previewImage: $previewImage,
missing: $missing,
style: $film ? 'media' : 'material',
);
}
/** Bezeichnung der Ausgabeart, wie in der Redaktionsstruktur (CompositionRelease::outputLabel). */
public static function outputLabel(string $outputClass): string
{
return match ($outputClass) {
'film' => 'Film',
'audio' => 'Hörstück',
'bild' => 'Bild',
'document', 'pdf' => 'Dokument',
default => 'Text',
};
}
public function visibilityNote(ContentElement $element): string
{
if ($this->isPublic($element)) {
$program = $this->publicProgramFor($element);
return 'Öffentlich nur als Teil der Programmseite „'.($program['title'] ?? '').'“. Die Mediendatei wird dabei nicht ausgeliefert.';
}
return $this->notice($element, $this->publicProgramFor($element));
}
/**
* @param array{id: int, title: string}|null $program
*/
private function notice(ContentElement $element, ?array $program): string
{
$reason = match (true) {
in_array($element->editorialContentKind?->slug, self::CONFIDENTIAL_KINDS, true) => 'Traineranleitungen erscheinen nie öffentlich.',
! $this->isReady($element) => 'Das Medium hat noch keine bereitgestellte Fassung.',
$program === null => 'Das Medium gehört zu keinem öffentlich gezeigten Programm. Medien haben noch keine eigene öffentliche Freigabe (öffentliches Profil, ADR-29).',
default => 'Das Medium ist nicht öffentlich.',
};
return 'Nur in der Redaktionsvorschau sichtbar: '.$reason;
}
private function optionLabel(ContentElement $element): string
{
$visibility = $this->isPublic($element)
? 'öffentlich über Programmseite'
: ($this->isReady($element) ? 'nur Redaktionsvorschau' : 'Entwurf, nur Redaktionsvorschau');
$kind = $element->editorialContentKind?->label ?: self::outputLabel((string) $element->output_class);
return (string) ($element->display_title ?: $element->working_title).' · '.$kind.' · '.$visibility;
}
/**
* Index aller Elemente, die in der gezeigten Fassung eines öffentlichen Programms vorkommen (auch verschachtelt).
*
* @return array<int, array{id: int, title: string}>
*/
private function publicIndex(): array
{
if ($this->publicIndex !== null) {
return $this->publicIndex;
}
$index = [];
foreach ($this->catalog->publicPrograms() as $program) {
$version = $this->catalog->shownVersion($program);
if ($version === null) {
continue;
}
$entry = ['id' => (int) $program->id, 'title' => (string) ($program->display_title ?: $program->designation)];
foreach ($this->elementIds($this->structure->tree($version)) as $elementId) {
$index[$elementId] ??= $entry;
}
}
return $this->publicIndex = $index;
}
/**
* @param list<StructureNode> $nodes
* @return list<int>
*/
private function elementIds(array $nodes): array
{
$ids = [];
foreach ($nodes as $node) {
if ($node->contentElementId !== null) {
$ids[] = (int) $node->contentElementId;
}
array_push($ids, ...$this->elementIds($node->children));
}
return $ids;
}
}
+3
View File
@@ -148,6 +148,9 @@ private function storeRevision(Page $page, array $blocks, ?array $sections, ?str
$revision = $page->revisions()->create($attributes);
// „Geändert“ in der Seitenliste zeigt die letzte Bearbeitung, nicht das Anlagedatum.
$page->touch();
foreach ($this->sections->mediaPaths($revision->sections()) as $path) {
PublishPublicMedia::dispatch($path);
}
+35 -20
View File
@@ -2,7 +2,9 @@
namespace App\Domain\Cms\Sections;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetRegistry;
use Illuminate\Support\Str;
use Illuminate\Validation\ValidationException;
@@ -11,14 +13,17 @@
* Abschnitts- und Slotmodell einer Seite: Seite → Abschnitte → Slots → Widget-Instanzen.
*
* Gespeicherte Hülle eines Abschnitts (Version 1):
* {id, v, layout, style: {background, image, focus, overlay, width, spacing, divider}, slots: [Widget-Hülle|null, …]}
* {id, v, layout, style: {background, image, focus, overlay, width, spacing_top, spacing_bottom, gap, divider}, slots: [Widget-Hülle|null, …]}
*
* Version 2 (Abstände): oben, unten und Widget-Abstand sind drei unabhängige Werte. Hüllen der Version 1 werden beim
* Lesen übersetzt (SectionStyle::migrateSpacing), ohne die Darstellung zu ändern; gespeicherte Revisionen bleiben.
*
* Jeder Slot enthält höchstens ein Widget aus dem zentralen Widget-Register. Abschnitte sind nicht verschachtelbar.
* Revisionen ohne Abschnitte (Bestand vor dieser Fassung) werden beim Lesen als einspaltige Abschnitte gelesen.
*/
class PageSections
{
public const VERSION = 1;
public const VERSION = 2;
public const MAX_SECTIONS = 30;
@@ -41,10 +46,8 @@ public function read(?array $sections, ?array $blocks = null): array
$result = [];
foreach (array_values($sections) as $section) {
if (is_array($section)) {
$result[] = $this->upcastSection($section);
}
foreach (SectionStyle::migrateSpacing(array_values(array_filter($sections, 'is_array')), byVersion: true) as $section) {
$result[] = $this->upcastSection($section);
}
return $result;
@@ -74,6 +77,12 @@ public function normalize(array $content): array
$seenWidgetIds = [];
$widgetCount = 0;
// Eingaben mit Abständen der Version 1 (zum Beispiel ältere Aufrufer) werden wie beim Lesen übersetzt.
$migrated = SectionStyle::migrateSpacing(array_map(
fn ($item) => is_array($item) && array_key_exists('slots', $item) ? $item : ['style' => [], 'slots' => [$item]],
$items,
));
foreach ($items as $index => $item) {
if (! is_array($item)) {
$errors["sections.$index"] = ['Ein Abschnitt ist unvollständig.'];
@@ -83,6 +92,8 @@ public function normalize(array $content): array
if (! array_key_exists('slots', $item)) {
$item = ['id' => null, 'layout' => SectionLayouts::DEFAULT, 'style' => [], 'slots' => [$item]];
} else {
$item['style'] = $migrated[$index]['style'] ?? ($item['style'] ?? []);
}
$sections[] = $this->normalizeSection($item, $index, $errors, $seenSectionIds, $seenWidgetIds, $widgetCount);
@@ -136,7 +147,7 @@ public function mediaPaths(array $sections): array
foreach ($sections as $section) {
$style = SectionStyle::fromStored($section['style'] ?? []);
if ($style['image'] !== null && PublicMedia::isPublicPath($style['image'])) {
if (is_string($style['image']) && PublicMedia::isPublicPath($style['image'])) {
$paths[] = $style['image'];
}
}
@@ -164,13 +175,14 @@ private function wrapWidgets(array $blocks): array
{
$sections = [];
foreach ($this->widgets->read($blocks) as $widget) {
foreach ($this->widgets->read($blocks) as $position => $widget) {
$sections[] = [
'id' => null,
'v' => self::VERSION,
'layout' => SectionLayouts::DEFAULT,
// Bestand vor dem Raster stand in einem durchgehenden Blatt: kompakte Abstände kommen dem am nächsten.
'style' => ['spacing' => 'compact'] + SectionStyle::DEFAULTS,
// Bestand vor dem Raster stand in einem durchgehenden Blatt: kompakte Abstände, zwischen den Widgets
// nur einmal (oben kein Abstand ab dem zweiten), wie bisher.
'style' => ['spacing_top' => $position === 0 ? 'compact' : 'none', 'spacing_bottom' => 'compact', 'gap' => 'normal'] + SectionStyle::DEFAULTS,
'slots' => [$widget],
];
}
@@ -264,11 +276,11 @@ private function normalizeSection(array $section, int $index, array &$errors, ar
}
$type = $this->widgets->get($widget['type']);
if ($slotUnits < $type->minUnits()) {
if (! $type->supportsUnits($slotUnits)) {
$errors["$prefix.slots.$position.units"] = [sprintf(
'„%s“ braucht mindestens %d Rastereinheiten; dieser Platz hat %d. Wählen Sie ein breiteres Raster oder einen breiteren Platz.',
'„%s“ ist für Plätze mit %s Rastereinheiten vorgesehen; dieser Platz hat %d. Wählen Sie ein passendes Raster oder einen passenden Platz.',
$type->label(),
$type->minUnits(),
$type->unitsLabel(),
$slotUnits,
)];
}
@@ -325,14 +337,17 @@ private function normalizeStyle(array $style, string $prefix, array &$errors): a
$result[$key] = $value;
}
$upload = PublicMedia::fromUploadState($style['_upload'] ?? null);
$image = $upload ?? PublicMedia::fromUploadState($style['image'] ?? null);
if ($result['background'] === 'image') {
if ($image === null) {
$errors["$prefix.style.image"] = ['Bitte ein Hintergrundbild wählen oder hochladen.'];
} elseif (! PublicMedia::isPublicPath($image)) {
$errors["$prefix.style.image"] = ['Das Hintergrundbild liegt nicht im öffentlichen Medienbereich.'];
$widgetErrors = new WidgetErrors;
$refs = ImageRefFields::clean(['image' => $style['image'] ?? null, '_upload' => $style['_upload'] ?? null], $widgetErrors, errorKey: 'image');
$image = $refs['image'];
foreach ($widgetErrors->all() as $messages) {
$errors["$prefix.style.image"] = $messages;
}
if ($image === null && ! isset($errors["$prefix.style.image"])) {
$errors["$prefix.style.image"] = ['Bitte ein Hintergrundbild aus dem Medienmanager wählen oder hochladen.'];
}
$result['image'] = $image;
@@ -22,6 +22,8 @@ final class SectionLayouts
'u3_1' => [3, 1],
'u1_2_1' => [1, 2, 1],
'u1_1_1_1' => [1, 1, 1, 1],
'u1_1_2' => [1, 1, 2],
'u2_1_1' => [2, 1, 1],
];
/** @var array<string, string> */
@@ -32,6 +34,8 @@ final class SectionLayouts
'u3_1' => 'Breit und schmal',
'u1_2_1' => 'Mitte betont',
'u1_1_1_1' => 'Vier gleich breit',
'u1_1_2' => 'Zwei schmal, eins breit',
'u2_1_1' => 'Eins breit, zwei schmal',
];
public static function has(mixed $key): bool
+10 -10
View File
@@ -3,7 +3,7 @@
namespace App\Domain\Cms\Sections;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetRenderer;
use Illuminate\Support\HtmlString;
@@ -56,7 +56,7 @@ public function renderAll(array $sections, RenderContext $context): HtmlString
$last = count($rendered) - 1;
foreach ($rendered as $index => $item) {
$html .= $this->renderSection($item['section'], $item['cells'], $index);
$html .= $this->renderSection($item['section'], $item['cells'], $index, $context);
$divider = $item['section']['style']['divider'] ?? 'none';
if ($index < $last && in_array($divider, ['line', 'accent'], true)) {
@@ -71,17 +71,21 @@ public function renderAll(array $sections, RenderContext $context): HtmlString
* @param array<string, mixed> $section
* @param list<array{units: int, html: string}> $cells
*/
private function renderSection(array $section, array $cells, int $index): string
private function renderSection(array $section, array $cells, int $index, RenderContext $context): string
{
$style = SectionStyle::fromStored($section['style'] ?? []);
$columns = SectionLayouts::columns(array_column($cells, 'units'));
$hasImage = $style['background'] === 'image' && $style['image'] !== null && PublicMedia::isPublicPath($style['image']);
// Hintergrundbild aus dem Medienmanager: öffentlich nur mit Website-Freigabe (WebsiteImage → WebsiteMedia).
$imageUrl = $style['background'] === 'image' ? app(WebsiteImage::class)->url($style['image'], $context->preview) : null;
$hasImage = $imageUrl !== null;
$classes = [
'page-section',
'section-bg-'.($hasImage ? 'image' : ($style['background'] === 'image' ? 'default' : $style['background'])),
'section-width-'.$style['width'],
'section-space-'.$style['spacing'],
'section-space-top-'.$style['spacing_top'],
'section-space-bottom-'.$style['spacing_bottom'],
'section-gap-'.$style['gap'],
'section-layout-'.str_replace('_', '-', $section['layout']),
];
@@ -101,17 +105,13 @@ private function renderSection(array $section, array $cells, int $index): string
$classes[] = $scope;
}
if ($style['divider'] === 'space') {
$classes[] = 'section-divider-space';
}
$id = is_string($section['id'] ?? null) ? ' id="bereich-'.e($section['id']).'"' : '';
$html = '<div class="'.e(implode(' ', $classes)).'"'.$id.'>';
if ($hasImage) {
// Das Bild des ersten Abschnitts ist meist das größte sichtbare Element und wird nicht verzögert geladen.
$loading = $index === 0 ? 'loading="eager" fetchpriority="high"' : 'loading="lazy"';
$html .= '<img class="page-section-image" src="'.e(PublicMedia::url($style['image'])).'" alt="" '.$loading.' decoding="async"'
$html .= '<img class="page-section-image" src="'.e($imageUrl).'" alt="" '.$loading.' decoding="async"'
.' style="object-position: '.e(SectionStyle::FOCUS_POSITIONS[$style['focus']]).'">';
}
+104 -10
View File
@@ -2,6 +2,8 @@
namespace App\Domain\Cms\Sections;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
/**
* Semantische Abschnittsgestaltung. Jeder Wert ist eine Aufzählung, die auf zentrale Design-Tokens
* abgebildet wird (resources/css/app.css, Abschnitt „Abschnitte“). Keine freie CSS- oder Farbangabe.
@@ -19,14 +21,25 @@ final class SectionStyle
/** @var array<string, string> */
public const WIDTHS = [
'narrow' => 'Schmal (Lesebreite)',
'narrow' => 'Lesebereich',
'standard' => 'Standard',
'wide' => 'Breit',
'full' => 'Volle Breite',
'full' => 'Vollbreite',
];
/** @var array<string, string> */
/**
* Gemeinsame Stufen der drei Abstände eines Abschnitts (Hülle Version 2):
* - spacing_top: Abstand vor dem Inhalt (oben),
* - spacing_bottom: Abstand nach dem Inhalt (unten),
* - gap: Abstand zwischen den Plätzen im Abschnittsraster, nebeneinander und gestapelt.
* Zwischen zwei Abschnitten addieren sich „unten“ des ersten und „oben“ des zweiten; es gibt keine weitere
* versteckte Vorgabe. Liegt eine eigene Fläche (Hintergrund) vor, liegen oben und unten innerhalb dieser Fläche.
* Werte: resources/css/tokens.css (--section-space-*, --section-gap-*).
*
* @var array<string, string>
*/
public const SPACINGS = [
'none' => 'Kein Abstand',
'compact' => 'Kompakt',
'normal' => 'Normal',
'large' => 'Großzügig',
@@ -35,7 +48,6 @@ final class SectionStyle
/** @var array<string, string> */
public const DIVIDERS = [
'none' => 'Kein Trenner',
'space' => 'Zusätzlicher Abstand',
'line' => 'Dezente Linie',
'accent' => 'Markenakzent',
];
@@ -79,7 +91,9 @@ final class SectionStyle
'focus' => 'center',
'overlay' => 'light',
'width' => 'standard',
'spacing' => 'normal',
'spacing_top' => 'compact',
'spacing_bottom' => 'compact',
'gap' => 'normal',
'divider' => 'none',
];
@@ -95,7 +109,9 @@ public static function enums(): array
'focus' => self::FOCUS,
'overlay' => self::OVERLAYS,
'width' => self::WIDTHS,
'spacing' => self::SPACINGS,
'spacing_top' => self::SPACINGS,
'spacing_bottom' => self::SPACINGS,
'gap' => self::SPACINGS,
'divider' => self::DIVIDERS,
];
}
@@ -104,7 +120,7 @@ public static function enums(): array
* Lesepfad: gespeicherte Werte; Unbekanntes fällt auf die Vorgabe zurück, damit alte oder fremde Daten
* nie eine Seite brechen.
*
* @return array{background: string, image: ?string, focus: string, overlay: string, width: string, spacing: string, divider: string}
* @return array{background: string, image: ?string, focus: string, overlay: string, width: string, spacing_top: string, spacing_bottom: string, gap: string, divider: string}
*/
public static function fromStored(mixed $style): array
{
@@ -118,7 +134,7 @@ public static function fromStored(mixed $style): array
}
}
$result['image'] = $result['background'] === 'image' && is_string($style['image'] ?? null) ? $style['image'] : null;
$result['image'] = $result['background'] === 'image' ? WebsiteImage::normalize($style['image'] ?? null) : null;
return $result;
}
@@ -137,8 +153,13 @@ public static function summary(array $style): string
$parts[] = self::WIDTHS[$style['width']];
}
if ($style['spacing'] !== 'normal') {
$parts[] = 'Abstand '.mb_strtolower(self::SPACINGS[$style['spacing']]);
if ($style['spacing_top'] !== self::DEFAULTS['spacing_top'] || $style['spacing_bottom'] !== self::DEFAULTS['spacing_bottom']) {
$parts[] = 'Abstand oben '.mb_strtolower(self::SPACINGS[$style['spacing_top']])
.', unten '.mb_strtolower(self::SPACINGS[$style['spacing_bottom']]);
}
if ($style['gap'] !== 'normal') {
$parts[] = 'Widget-Abstand '.mb_strtolower(self::SPACINGS[$style['gap']]);
}
if ($style['divider'] !== 'none') {
@@ -147,4 +168,77 @@ public static function summary(array $style): string
return implode(' · ', $parts);
}
/**
* Ob eine gespeicherte Gestaltung noch die Abstände der Hülle Version 1 trägt
* („Abstand oben und unten“ spacing, Abweichung „Abstand oben“ same/small/none).
*
* @param array<string, mixed> $style
*/
public static function hasLegacySpacing(array $style): bool
{
return array_key_exists('spacing', $style)
|| in_array($style['spacing_top'] ?? null, ['same', 'small'], true);
}
/**
* Übersetzt die Abstände der Hülle Version 1 in die drei Werte der Version 2, ohne die Darstellung zu ändern.
*
* Version 1 rechnete so: jeder Abschnitt oben und unten „spacing“ (Vorgabe normal); die Abweichung
* „Abstand oben“ ersetzte nur oben (small/none); und eine versteckte Regel setzte oben auf null, wenn ein Abschnitt
* ohne eigene Fläche direkt auf einen Abschnitt ohne eigene Fläche folgte (ohne Linien- oder Akzenttrenner dazwischen).
* Diese Regel wird hier als „oben: kein Abstand“ ausgeschrieben. „Gering“ hat keine eigene Stufe mehr und wird
* „Kompakt“ (dokumentierte Abweichung). Der Widget-Abstand entspricht dem bisherigen festen Rasterabstand („normal“).
*
* @param list<array<string, mixed>> $sections Abschnitte in Lesereihenfolge (mit style und slots)
* @param bool $byVersion true: jede Hülle mit v < 2 gilt als Version 1 (Lesepfad gespeicherter Revisionen);
* false: nur Gestaltungen mit alten Schlüsseln (Eingaben ohne Versionsangabe)
* @return list<array<string, mixed>> dieselben Abschnitte mit übersetzter Gestaltung
*/
public static function migrateSpacing(array $sections, bool $byVersion = false): array
{
$previous = null;
foreach ($sections as $index => $section) {
$style = is_array($section['style'] ?? null) ? $section['style'] : [];
$rendered = is_array($section['slots'] ?? null) && array_filter($section['slots'], 'is_array') !== [];
$background = is_string($style['background'] ?? null) && isset(self::BACKGROUNDS[$style['background']]) ? $style['background'] : 'default';
if ($background === 'image' && WebsiteImage::normalize($style['image'] ?? null) === null) {
$background = 'default';
}
$divider = in_array($style['divider'] ?? null, ['line', 'accent'], true) ? $style['divider'] : 'none';
$legacy = $byVersion ? (int) ($section['v'] ?? 1) < 2 : self::hasLegacySpacing($style);
if ($legacy) {
$level = in_array($style['spacing'] ?? null, ['compact', 'normal', 'large'], true) ? $style['spacing'] : 'normal';
$override = $style['spacing_top'] ?? 'same';
$collapsed = $background === 'default' && $previous !== null && $previous['background'] === 'default' && ! in_array($previous['divider'], ['line', 'accent'], true);
$style['spacing_top'] = match (true) {
$override === 'none' => 'none',
$override === 'small' => 'compact',
$collapsed => 'none',
default => $level,
};
$style['spacing_bottom'] = $level;
$style['gap'] = 'normal';
// Trenner „Zusätzlicher Abstand“ (Version 1) fügte unten noch einmal den Abschnittsabstand an.
if (($style['divider'] ?? null) === 'space') {
$style['spacing_bottom'] = ['compact' => 'normal', 'normal' => 'large', 'large' => 'large'][$level];
$style['divider'] = 'none';
}
unset($style['spacing']);
$sections[$index]['style'] = $style;
}
if ($rendered) {
$previous = ['background' => $background, 'divider' => $divider];
}
}
return $sections;
}
}
+56
View File
@@ -0,0 +1,56 @@
<?php
namespace App\Domain\Cms;
use App\Domain\Catalog\ContentElement;
use App\Domain\Media\WebsiteMediaAlias;
/**
* Wo ein Medium auf Website-Seiten als Bild verwendet wird (veröffentlichte Fassung und neuester Entwurf).
* Für den Medienmanager: Vor dem Zurücknehmen einer Website-Freigabe ist sichtbar, welche Seiten das Bild verlieren.
*/
class WebsiteImageUsage
{
/**
* @return list<array{path: string, published: bool, draft: bool}>
*/
public function pages(ContentElement $element): array
{
$legacy = WebsiteMediaAlias::query()->where('content_element_id', $element->id)->pluck('legacy_path')->all();
$usages = [];
foreach (Page::query()->with(['publishedRevision', 'latestRevision'])->orderBy('path')->get() as $page) {
$published = $page->publishedRevision !== null && $this->uses($page->publishedRevision->sections ?? [], $element->id, $legacy);
$draft = $page->latestRevision !== null && $page->latestRevision->id !== $page->published_revision_id
&& $this->uses($page->latestRevision->sections ?? [], $element->id, $legacy);
if ($published || $draft) {
$usages[] = ['path' => (string) $page->path, 'published' => $published, 'draft' => $draft];
}
}
return $usages;
}
/**
* @param list<string> $legacy
*/
private function uses(mixed $value, int $id, array $legacy): bool
{
if (! is_array($value)) {
return false;
}
foreach ($value as $key => $item) {
if ($key === 'image' && (($item === $id || (is_string($item) && ($item === (string) $id || in_array($item, $legacy, true)))))) {
return true;
}
if (is_array($item) && $this->uses($item, $id, $legacy)) {
return true;
}
}
return false;
}
}
@@ -5,37 +5,80 @@
use App\Domain\Cms\Widgets\WidgetErrors;
use Filament\Forms\Components\Field;
use Filament\Forms\Components\FileUpload;
use Filament\Forms\Components\Placeholder;
use Filament\Forms\Components\Select;
use Illuminate\Support\Str;
use Filament\Notifications\Notification;
use Filament\Schemas\Components\Utilities\Get;
use Filament\Schemas\Components\Utilities\Set;
use Illuminate\Support\HtmlString;
use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
/**
* Gemeinsame Bildauswahl für Widgets: vorhandenes Bild aus dem öffentlichen Website-Bereich wählen
* oder ein neues hochladen. Keine eigene Medienverwaltung.
* Gemeinsame Bildauswahl aller Widgets und des Abschnittshintergrunds: Bilder aus dem zentralen Medienmanager
* (siehe WebsiteImage, docs/architektur/medienzugriff-fuer-komponenten.md). Keine eigene CMS-Medienverwaltung.
*
* - Auswahl: durchsuchbare Liste mit Vorschaubild, Titel und Website-Status.
* - Neu hochladen: Das Bild wird sofort als Medium im Medienmanager angelegt (WebsiteIntake) und ausgewählt.
* - Anzeige des gewählten Mediums mit Status und Verweis auf die Freigabe im Medienmanager.
*
* Das Bedienmuster folgt der Bildauswahl im Modul- und Programmeditor (Suche, Vorschaubild, Auswählen); jene ist an
* die Livewire-Seite des Editors gebunden und lässt sich nicht als Formularfeld im Widget-Dialog einhängen.
*/
final class ImageRefFields
{
/**
* @return list<Field>
* @param bool $live Änderungen sofort an die Vorschau im Bearbeitungsdialog geben.
* @param string|null $altField Name des Alternativtext-Felds im selben Formular (für neue Medien), falls vorhanden.
* @return list<Field|Placeholder>
*/
public static function fields(string $label = 'Bild'): array
public static function fields(string $label = 'Bild', bool $live = false, string $key = 'image', ?string $altField = null): array
{
return [
Select::make('image')
->label($label.': vorhandenes Bild')
->options(fn (): array => PublicMedia::imageOptions())
Select::make($key)
->live()
->label($label.' aus dem Medienmanager')
->searchable()
->allowHtml()
->options(fn (): array => app(WebsiteImage::class)->options())
->getSearchResultsUsing(fn (?string $search): array => app(WebsiteImage::class)->options($search))
->getOptionLabelUsing(fn (mixed $value): ?string => app(WebsiteImage::class)->optionHtml($value))
->placeholder('Kein Bild')
->helperText('Auswahl aus den Bildern, die bereits für die Website hochgeladen wurden.'),
->helperText('Alle Bilder des Medienmanagers. Öffentlich erscheint ein Bild nur mit Website-Freigabe.'),
FileUpload::make('_upload')
->label($label.': neu hochladen')
->disk('cms_incoming')
->directory('cms')
->live()
->label($label.': neues Bild hochladen')
->image()
->maxSize(8192)
->acceptedFileTypes(['image/jpeg', 'image/png', 'image/webp'])
->getUploadedFileNameForStorageUsing(fn (TemporaryUploadedFile $file): string => Str::slug(pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME)).'-'.Str::lower(Str::random(6)).'.'.$file->guessExtension())
->helperText('Ein neues Bild ersetzt die Auswahl oben. Es wird beim Speichern im öffentlichen Bereich der Website abgelegt.'),
->storeFiles(false)
->afterStateUpdated(function (mixed $state, Set $set, Get $get) use ($key, $altField): void {
$file = is_array($state) ? (array_values($state)[0] ?? null) : $state;
if (! $file instanceof TemporaryUploadedFile) {
return;
}
$element = app(WebsiteImage::class)->accept($file, $altField !== null ? $get($altField) : null);
$set('_upload', null);
if ($element === null) {
Notification::make()->danger()->title('Das Bild konnte nicht übernommen werden.')->send();
return;
}
$set($key, $element->id);
Notification::make()
->success()
->title('Im Medienmanager angelegt: „'.($element->display_title ?: $element->working_title).'“')
->body('Das Bild ist ausgewählt. Nach der Verarbeitung wird es automatisch für die Website freigegeben.')
->send();
})
->helperText('Das Bild wird im Medienmanager angelegt und hier ausgewählt. Nur Bilder mit geklärten Rechten hochladen.'),
Placeholder::make('_media_status')
->label('Gewähltes Bild')
->visible(fn (Get $get): bool => WebsiteImage::normalize($get($key)) !== null)
->content(fn (Get $get): HtmlString => self::statusHtml($get($key))),
];
}
@@ -45,29 +88,49 @@ public static function fields(string $label = 'Bild'): array
public static function rules(): array
{
return [
'image' => ['nullable', 'string', 'max:255'],
'image' => ['nullable'],
'_upload' => ['nullable'],
];
}
/**
* Übernimmt einen neuen Upload als Bild und prüft, dass das Bild im öffentlichen Bereich liegt.
* Prüft das gewählte Bild. Ein früherer CMS-Pfad mit wirksamer Zuordnung wird zur Kennung des Mediums.
* Ein noch als Datei übergebener Upload (frühere Formulare) wird über den Medienmanager aufgenommen.
*
* @param array<string, mixed> $refs
* @return array<string, mixed>
*/
public static function clean(array $refs, WidgetErrors $errors, string $key = 'image', ?string $errorKey = null): array
{
$upload = PublicMedia::fromUploadState($refs['_upload'] ?? null);
$image = $upload ?? PublicMedia::fromUploadState($refs[$key] ?? null);
$images = app(WebsiteImage::class);
$upload = $refs['_upload'] ?? null;
$upload = is_array($upload) ? (array_values($upload)[0] ?? null) : $upload;
if ($image !== null && ! PublicMedia::isPublicPath($image)) {
$errors->add($errorKey ?? "refs.$key", 'Das Bild liegt nicht im öffentlichen Medienbereich.');
if ($upload instanceof TemporaryUploadedFile) {
$element = $images->accept($upload);
$refs[$key] = $element?->id ?? $refs[$key] ?? null;
}
$refs[$key] = $image;
$refs[$key] = $images->clean($refs[$key] ?? null, $errors, $errorKey ?? "refs.$key");
unset($refs['_upload']);
return $refs;
}
public static function statusHtml(mixed $value): HtmlString
{
$status = app(WebsiteImage::class)->status($value);
if ($status === null) {
return new HtmlString('');
}
$thumb = $status['thumb'] !== null ? '<img src="'.e($status['thumb']).'" alt="">' : '';
$link = $status['manageUrl'] !== null
? '<a href="'.e($status['manageUrl']).'" target="_blank" rel="noopener">Im Medienmanager öffnen</a>'
: '';
return new HtmlString('<div class="luf-media-status luf-media-status-'.e($status['state']).'">'.$thumb
.'<div><strong>'.e($status['title']).'</strong><p>'.e($status['note']).'</p>'.$link.'</div></div>');
}
}
@@ -0,0 +1,196 @@
<?php
namespace App\Domain\Cms\Widgets\Support;
use App\Domain\Cms\Sections\SectionStyle;
use App\Domain\Cms\Widgets\WidgetErrors;
use Filament\Forms\Components\Slider;
use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Grid;
/**
* Gemeinsame Bausteine der Premium-Widgets (Einstieg, Bild und Text; Brand-UI-Kit v1.6): Label, Überschriftenebene,
* Bildfokus in Prozent und zwei Schaltflächen. Alle Werte bleiben in data bzw. settings der bestehenden Hülle.
*
* Abweichungen vom Kit (bewusst, dokumentiert in cms-widget-registry.md):
* - Bildfokus als data.focus_x / data.focus_y (ganze Zahlen 0–100), weil settings nur Aufzählungswerte trägt.
* - Überschriftenebene „Automatisch“ statt freier H1: Die Seite hat genau eine H1 (erstes Widget der Seite).
* - Linkziele über SafeUrl des Repositorys (Seitenpfad, #Anker, http und https), nicht nur https.
*/
final class PremiumFields
{
public const HEADING_LEVELS = [
'auto' => 'Automatisch (Seiteneinstieg H1, sonst H2)',
'h2' => 'H2',
'h3' => 'H3',
];
/**
* @return array<string, mixed>
*/
public static function rules(): array
{
return [
'eyebrow' => ['nullable', 'string', 'max:80'],
'cta_label' => ['nullable', 'string', 'max:80', 'required_with:data.cta_url'],
'cta_url' => ['nullable', 'string', 'max:500', 'required_with:data.cta_label'],
'cta2_label' => ['nullable', 'string', 'max:80', 'required_with:data.cta2_url'],
'cta2_url' => ['nullable', 'string', 'max:500', 'required_with:data.cta2_label'],
'alt' => ['nullable', 'string', 'max:300'],
'focus_x' => ['nullable', 'numeric', 'between:0,100'],
'focus_y' => ['nullable', 'numeric', 'between:0,100'],
];
}
public static function eyebrowField(): TextInput
{
return TextInput::make('eyebrow')
->label('Label über der Überschrift (optional)')
->maxLength(80)
->live(onBlur: true)
->helperText('Kurzer Hinweis, zum Beispiel ein Themenbereich. Kein Pflichtfeld.');
}
public static function ctaFields(): Grid
{
$url = fn (string $name, string $label, string $pair) => TextInput::make($name)
->label($label)
->maxLength(500)
->rule(SafeUrl::rule())
->requiredWith($pair)
->live(onBlur: true)
->placeholder('/programme');
return Grid::make(['default' => 1, 'md' => 2])->schema([
TextInput::make('cta_label')->label('Hauptschaltfläche: Beschriftung')->maxLength(80)->live(onBlur: true),
$url('cta_url', 'Hauptschaltfläche: Linkziel', 'cta_label'),
TextInput::make('cta2_label')->label('Zweite Schaltfläche: Beschriftung')->maxLength(80)->live(onBlur: true),
$url('cta2_url', 'Zweite Schaltfläche: Linkziel', 'cta2_label'),
]);
}
/**
* @return list<Slider>
*/
public static function focusFields(int $defaultX = 50, int $defaultY = 50): array
{
// Ohne gespeicherten Wert zeigt der Regler die Vorgabe der Widget-Art, die auch die Darstellung verwendet.
$slider = fn (string $name, string $label, int $default) => Slider::make($name)
->label($label)
->range(0, 100)
->step(1)
->required(false)
->tooltips()
->default($default)
->afterStateHydrated(function (Slider $component, mixed $state) use ($default): void {
if (! is_numeric($state)) {
$component->state($default);
}
})
->live();
return [
$slider('focus_x', 'Bildausschnitt waagerecht (0 = links, 100 = rechts)', $defaultX),
$slider('focus_y', 'Bildausschnitt senkrecht (0 = oben, 100 = unten)', $defaultY),
];
}
public static function altField(): TextInput
{
return TextInput::make('alt')
->label('Alternativtext (optional)')
->maxLength(300)
->live(onBlur: true)
->helperText('Leer lassen, dann gilt der Alternativtext des Mediums aus dem Medienmanager. Nur ausfüllen, wenn das Bild hier etwas anderes aussagen soll.');
}
/**
* Bereinigt Label, Schaltflächen, Alternativtext und Fokus; meldet unsichere Linkziele.
*
* @param array<string, mixed> $data
* @return array<string, mixed>
*/
public static function clean(array $data, WidgetErrors $errors, bool $hasImage): array
{
foreach (['eyebrow', 'cta_label', 'cta_url', 'cta2_label', 'cta2_url', 'alt'] as $key) {
$data[$key] = filled($data[$key] ?? null) ? trim((string) $data[$key]) : null;
}
foreach (['cta_url', 'cta2_url'] as $key) {
if ($data[$key] !== null && ! SafeUrl::isSafe($data[$key])) {
$errors->add("data.$key", SafeUrl::message());
}
}
foreach (['focus_x', 'focus_y'] as $key) {
$value = $data[$key] ?? null;
$data[$key] = is_numeric($value) ? (int) round(max(0, min(100, (float) $value))) : null;
}
return $data;
}
/**
* Schaltflächen mit sicherem Linkziel in Anzeigereihenfolge.
*
* @param array<string, mixed> $data
* @return list<array{label: string, url: string}>
*/
public static function actions(array $data): array
{
$actions = [];
foreach ([['cta_label', 'cta_url'], ['cta2_label', 'cta2_url']] as [$label, $url]) {
if (filled($data[$label] ?? null) && SafeUrl::isSafe($data[$url] ?? null)) {
$actions[] = ['label' => (string) $data[$label], 'url' => (string) $data[$url]];
}
}
return $actions;
}
/**
* Bildfokus in Prozent; ohne Angabe die Vorgabe der Widget-Art.
*
* @param array<string, mixed> $data
* @return array{x: int, y: int}
*/
public static function focus(array $data, int $defaultX = 50, int $defaultY = 50): array
{
$clamp = fn (mixed $value, int $default): int => is_numeric($value) ? (int) round(max(0, min(100, (float) $value))) : $default;
return ['x' => $clamp($data['focus_x'] ?? null, $defaultX), 'y' => $clamp($data['focus_y'] ?? null, $defaultY)];
}
/**
* Übersetzt den früheren Fokuspunkt (Aufzählung wie beim Abschnittshintergrund) in Prozentwerte.
*
* @return array{focus_x: int|null, focus_y: int|null}
*/
public static function focusFromEnum(mixed $focus): array
{
if (! is_string($focus) || ! isset(SectionStyle::FOCUS_POSITIONS[$focus])) {
return ['focus_x' => null, 'focus_y' => null];
}
[$x, $y] = array_map(fn (string $part): int => (int) rtrim($part, '%'), explode(' ', SectionStyle::FOCUS_POSITIONS[$focus]));
return ['focus_x' => $x, 'focus_y' => $y];
}
/**
* Überschriftenebene: „auto“ ergibt H1 für das erste Widget der Seite, sonst H2. Eine weitere H1 gibt es nicht.
*
* @param array<string, mixed> $settings
*/
public static function headingTag(array $settings, bool $first): string
{
$level = $settings['heading_level'] ?? 'auto';
return match (true) {
$first => 'h1',
$level === 'h3' => 'h3',
default => 'h2',
};
}
}
+2 -65
View File
@@ -2,20 +2,14 @@
namespace App\Domain\Cms\Widgets\Support;
use Illuminate\Support\Facades\Storage;
use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
use Throwable;
/**
* Öffentlicher Medienbereich der Website ("cms/"). Nur Dateien aus diesem Bereich dürfen in Widgets
* verwendet werden. Geschützte Bibliotheksmedien (Inhaltsdateien, Vorschaubilder) sind hier nie wählbar.
* Frühere öffentliche CMS-Bilder („cms/“, Route media.public). Neue Bilder kommen aus dem Medienmanager (WebsiteImage);
* dieser Bereich bleibt nur für gespeicherte Revisionen mit früheren Pfaden, die (noch) keinem Medium zugeordnet sind.
*/
final class PublicMedia
{
public const PREFIX = 'cms/';
private const IMAGE_EXTENSIONS = ['jpg', 'jpeg', 'png', 'webp', 'gif', 'avif'];
public static function isPublicPath(mixed $path): bool
{
return is_string($path)
@@ -29,36 +23,6 @@ public static function url(string $path): string
return route('media.public', ['path' => $path]);
}
/**
* Bereits vorhandene Bilder im öffentlichen Bereich (veröffentlicht oder zur Veröffentlichung vorgemerkt).
*
* @return array<string, string>
*/
public static function imageOptions(): array
{
$options = [];
foreach (['media_public', 'cms_incoming'] as $disk) {
try {
$files = Storage::disk($disk)->allFiles(rtrim(self::PREFIX, '/'));
} catch (Throwable) {
$files = [];
}
foreach ($files as $file) {
$extension = strtolower(pathinfo($file, PATHINFO_EXTENSION));
if (self::isPublicPath($file) && in_array($extension, self::IMAGE_EXTENSIONS, true)) {
$options[$file] = substr($file, strlen(self::PREFIX));
}
}
}
ksort($options);
return $options;
}
/**
* Pfad aus dem Zustand eines Upload-Felds (Zeichenkette oder Liste).
*/
@@ -70,31 +34,4 @@ public static function fromUploadState(mixed $state): ?string
return is_string($state) && $state !== '' ? $state : null;
}
/**
* Bildadresse für Darstellung und Blockvorschau. In der Vorschau kann ein noch nicht gespeicherter Upload vorliegen.
*
* @param array<string, mixed> $refs
*/
public static function imageUrl(array $refs, string $key = 'image'): ?string
{
$upload = $refs['_upload'] ?? null;
$upload = is_array($upload) ? (array_values($upload)[0] ?? null) : $upload;
if ($upload instanceof TemporaryUploadedFile) {
try {
return $upload->temporaryUrl();
} catch (Throwable) {
return null;
}
}
if (self::isPublicPath($upload)) {
return self::url($upload);
}
$path = $refs[$key] ?? null;
return self::isPublicPath($path) ? self::url($path) : null;
}
}
@@ -0,0 +1,349 @@
<?php
namespace App\Domain\Cms\Widgets\Support;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Media\ThumbnailRef;
use App\Domain\Media\WebsiteIntake;
use App\Domain\Media\WebsiteMedia;
use App\Domain\Media\WebsiteMediaAlias;
use App\Domain\Media\WebsitePresentation;
use App\Filament\Resources\ContentElements\ContentElementResource;
use App\Models\User;
use Illuminate\Support\Str;
use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
use Throwable;
/**
* Bilder in CMS-Widgets und Abschnittshintergründen aus dem zentralen Medienbestand
* (docs/architektur/medienzugriff-fuer-komponenten.md).
*
* Gespeichert wird im jeweiligen Bildschlüssel (refs.image, style.image, data.items[].image) die Kennung des
* Inhaltselements (int). Frühere Werte sind Pfade unter cms/ (string):
* - mit wirksamer Zuordnung (WebsiteMediaAlias) gelten sie als das zugeordnete Medium,
* - ohne Zuordnung gelten sie weiter als öffentliches CMS-Bild (PublicMedia), bis das Widget umgestellt ist.
*
* Öffentlich erscheint ein Medium nur über WebsiteMedia (Website-Freigabe, Route website.media). In der
* Redaktionsvorschau erscheint ein nicht freigegebenes Bild als Vorschaubild der Bibliothek (Route editorial.card)
* mit Hinweis. Eine CMS-Verwendung gibt nichts frei.
*
* Je Anfrage gebunden (scoped): Ergebnisse werden innerhalb einer Anfrage zwischengespeichert.
*/
class WebsiteImage
{
/** @var array<string, int|string|null> */
private array $resolved = [];
/** @var array<int, WebsitePresentation|false> */
private array $presentations = [];
public function __construct(private readonly WebsiteMedia $media) {}
/**
* Gespeicherter oder eingegebener Wert → Kennung (int), früherer Pfad (string) oder null.
*/
public static function normalize(mixed $value): int|string|null
{
if (is_array($value)) {
$value = array_values($value)[0] ?? null;
}
if (is_int($value) && $value > 0) {
return $value;
}
if (is_string($value) && preg_match('/^[1-9][0-9]*$/', $value) === 1) {
return (int) $value;
}
return PublicMedia::isPublicPath($value) ? $value : null;
}
/**
* Kennung des Mediums: gespeicherte Kennung oder wirksam zugeordneter früherer Pfad; sonst null.
*/
public function elementId(mixed $value): ?int
{
$value = self::normalize($value);
if (is_int($value)) {
return $value;
}
if ($value === null) {
return null;
}
if (! array_key_exists($value, $this->resolved)) {
$this->resolved[$value] = WebsiteMediaAlias::effectiveFor($value)?->content_element_id;
}
$id = $this->resolved[$value];
return is_int($id) ? $id : null;
}
public function presentation(mixed $value): ?WebsitePresentation
{
$id = $this->elementId($value);
if ($id === null) {
return null;
}
if (! array_key_exists($id, $this->presentations)) {
$this->presentations[$id] = $this->media->present($id) ?? false;
}
return $this->presentations[$id] ?: null;
}
/**
* Bildadresse für die Darstellung. Öffentlich nur freigegebene Medien (oder frühere CMS-Bilder ohne Zuordnung);
* in der Redaktionsvorschau zusätzlich das Vorschaubild eines nicht freigegebenen Mediums.
*/
public function url(mixed $value, bool $preview = false): ?string
{
$presentation = $this->presentation($value);
if ($presentation !== null) {
return $presentation->kind === 'bild' ? $presentation->url : null;
}
$id = $this->elementId($value);
if ($id !== null) {
if (! $preview) {
return null;
}
$element = ContentElement::query()->find($id);
return $element === null ? null : ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path);
}
$legacy = self::normalize($value);
return is_string($legacy) ? PublicMedia::url($legacy) : null;
}
/** Alternativtext: Angabe im Widget, sonst der Alternativtext des Mediums. */
public function alt(mixed $value, mixed $override = null): string
{
if (is_string($override) && trim($override) !== '') {
return trim($override);
}
return $this->presentation($value)?->alt ?? '';
}
/** Öffentliche Quellenzeile des Mediums (nur solange es freigegeben ist). */
public function credit(mixed $value): ?string
{
return $this->presentation($value)?->credit;
}
/**
* Hinweis für die Redaktionsvorschau, wenn das gewählte Bild öffentlich nicht erscheint; sonst null.
*/
public function previewNotice(mixed $value, string $label = 'Das gewählte Bild'): ?string
{
$status = $this->status($value);
if ($status === null || $status['public']) {
return null;
}
return $label.' „'.$status['title'].'“ erscheint öffentlich nicht: '.$status['note'];
}
/**
* Zustand für Editor und Vorschau.
*
* @return array{public: bool, state: string, title: string, note: string, thumb: ?string, manageUrl: ?string}|null
*/
public function status(mixed $value): ?array
{
$value = self::normalize($value);
if ($value === null) {
return null;
}
$id = $this->elementId($value);
if ($id === null) {
return [
'public' => true,
'state' => 'legacy',
'title' => basename((string) $value),
'note' => 'Früheres CMS-Bild, noch nicht in den Medienmanager übernommen.',
'thumb' => PublicMedia::url((string) $value),
'manageUrl' => null,
];
}
$element = ContentElement::query()->with('editorialContentKind')->find($id);
if ($element === null) {
return ['public' => false, 'state' => 'missing', 'title' => 'Medium '.$id, 'note' => 'Das Medium gibt es nicht mehr.', 'thumb' => null, 'manageUrl' => null];
}
$title = (string) ($element->display_title ?: $element->working_title);
$thumb = ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path);
$manageUrl = ContentElementResource::getUrl('view', ['record' => $element]);
$public = $this->presentation($id) !== null;
$note = match (true) {
$public => 'Für die Website freigegeben.',
$element->archived_at !== null => 'Das Medium ist archiviert.',
filled($element->thumbnail_error) => 'Die Datei ließ sich nicht verarbeiten: '.Str::limit((string) $element->thumbnail_error, 120),
$element->thumbnail_path === null => 'Wird gerade verarbeitet. Danach wird es automatisch für die Website freigegeben.',
default => 'Nicht für die Website freigegeben. Die Freigabe steht im Medienmanager beim Medium unter „Beschreibung“ (Website-Freigabe).',
};
return [
'public' => $public,
'state' => $public ? 'released' : ($element->thumbnail_path === null && ! filled($element->thumbnail_error) ? 'pending' : 'unreleased'),
'title' => $title,
'note' => $note,
'thumb' => $thumb,
'manageUrl' => $manageUrl,
];
}
/**
* Prüft einen Wert beim Speichern. Ein früherer Pfad mit wirksamer Zuordnung wird zur Kennung des Mediums.
*/
public function clean(mixed $value, WidgetErrors $errors, string $errorKey): int|string|null
{
$raw = is_array($value) ? (array_values($value)[0] ?? null) : $value;
$value = self::normalize($raw);
if ($value === null) {
if ($raw !== null && $raw !== '') {
$errors->add($errorKey, 'Bitte ein Bild aus dem Medienmanager wählen.');
}
return null;
}
if (is_string($value)) {
return $this->elementId($value) ?? $value;
}
$element = ContentElement::query()->find($value);
if ($element === null || ! self::isSelectable($element)) {
$errors->add($errorKey, 'Dieses Medium ist kein Bild für die Website (nur Bilder aus dem Medienmanager, keine Traineranleitungen).');
return null;
}
return $element->id;
}
public static function isSelectable(ContentElement $element): bool
{
if ($element->output_class !== 'bild' || $element->archived_at !== null) {
return false;
}
$slug = $element->editorialContentKind?->slug
?? ($element->editorial_content_kind_id !== null ? EditorialContentKind::query()->whereKey($element->editorial_content_kind_id)->value('slug') : null);
return ! in_array($slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true);
}
/**
* Auswahl für den Medienpicker: Bilder aus dem Medienmanager mit Vorschaubild, Titel und Freigabestatus (HTML).
*
* @return array<int, string>
*/
public function options(?string $search = null, int $limit = 60): array
{
$search = trim((string) $search);
$elements = ContentElement::query()
->with('editorialContentKind')
->where('output_class', 'bild')
->whereNull('archived_at')
->when($search !== '', function ($query) use ($search): void {
$like = '%'.mb_strtolower($search).'%';
$query->where(fn ($inner) => $inner
->whereRaw('LOWER(working_title) LIKE ?', [$like])
->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like]));
})
->orderByDesc('id')
->limit($limit)
->get();
$options = [];
foreach ($elements as $element) {
if (self::isSelectable($element)) {
$options[$element->id] = $this->optionHtml($element->id);
}
}
return $options;
}
/** HTML-Bezeichnung einer Option oder des gewählten Werts (auch für frühere Pfade). */
public function optionHtml(mixed $value): ?string
{
$status = $this->status($value);
if ($status === null) {
return null;
}
$badge = match ($status['state']) {
'released' => ['ok', 'Website: freigegeben'],
'pending' => ['wait', 'Wird verarbeitet'],
'legacy' => ['quiet', 'Früheres CMS-Bild'],
default => ['warn', 'Website: nicht freigegeben'],
};
$thumb = $status['thumb'] !== null
? '<img src="'.e($status['thumb']).'" alt="" loading="lazy">'
: '<span class="luf-media-option-empty" aria-hidden="true"></span>';
return '<span class="luf-media-option">'.$thumb
.'<span class="luf-media-option-text"><strong>'.e($status['title']).'</strong>'
.'<span class="luf-media-badge luf-media-badge-'.$badge[0].'">'.e($badge[1]).'</span></span></span>';
}
/**
* Neues Bild direkt aus dem CMS: Datei in den Eingang legen und über WebsiteIntake als Medium anlegen.
* Die Warteschlange leitet das Bild ab und gibt die Ableitung für die Website frei.
*/
public function accept(TemporaryUploadedFile $file, ?string $alt = null): ?ContentElement
{
$base = Str::slug(pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME)) ?: 'bild';
$name = $base.'-'.Str::lower(Str::random(6)).'.'.($file->guessExtension() ?: 'jpg');
try {
$path = $file->storeAs('cms', $name, 'cms_incoming');
} catch (Throwable $exception) {
report($exception);
return null;
}
if (! is_string($path) || $path === '') {
return null;
}
$actor = auth('staff')->user();
return app(WebsiteIntake::class)->acceptImage(
$path,
Str::title(str_replace(['-', '_'], ' ', $base)),
null,
filled($alt) ? trim((string) $alt) : null,
$actor instanceof User ? $actor : null,
);
}
}
@@ -25,9 +25,22 @@ public function description(): string
return 'Hervorgehobene Fläche mit Überschrift, Text und einer Schaltfläche.';
}
public function minUnits(): int
public function supportedUnits(): array
{
return 1;
return [1, 2, 3, 4];
}
public function narrowBehavior(): string
{
return 'Unter 20 rem Slotbreite steht die Schaltfläche in voller Breite; Überschrift, Text und Beschriftung brechen um.';
}
public function heights(): array
{
return [
'auto' => 'Automatisch (nach Inhalt)',
'fill' => 'Abschnittshöhe füllen (gleich hoch wie Nachbarplätze)',
];
}
public function preferredUnits(): int
+22 -8
View File
@@ -6,6 +6,7 @@
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\Support\SafeUrl;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\Repeater;
@@ -32,12 +33,17 @@ public function label(): string
public function description(): string
{
return 'Mehrere Karten mit Titel, Text, Linkziel und optionalem Bild. Als Raster oder kompakte Liste.';
return 'Mehrere Karten mit Titel, Text, Linkziel und optionalem Bild. Als Raster, kompakte Liste oder mit hervorgehobener erster Karte.';
}
public function minUnits(): int
public function supportedUnits(): array
{
return 1;
return [1, 2, 3, 4];
}
public function narrowBehavior(): string
{
return 'Karten stehen untereinander, sobald keine zwei 15 rem breiten Karten nebeneinander passen; die hervorgehobene Karte stapelt Bild und Text.';
}
public function preferredUnits(): int
@@ -49,7 +55,7 @@ public function stages(): array
{
return [
'narrow' => 'eine Karte je Zeile',
'wide' => 'so viele Karten nebeneinander, wie bei mindestens 14rem Kartenbreite passen',
'wide' => 'so viele Karten nebeneinander, wie bei mindestens 15rem Kartenbreite passen; hervorgehobene Karte ab 44rem mit Bild neben dem Text',
];
}
@@ -68,6 +74,7 @@ public function variants(): array
return [
'standard' => 'Raster',
'compact' => 'Kompakte Liste',
'featured' => 'Erste Karte hervorgehoben',
];
}
@@ -78,14 +85,14 @@ public function dataRules(): array
'items.*.title' => ['required', 'string', 'max:120'],
'items.*.text' => ['nullable', 'string', 'max:500'],
'items.*.url' => ['nullable', 'string', 'max:500'],
'items.*.image' => ['nullable', 'string', 'max:255'],
'items.*.image' => ['nullable'],
'items.*._upload' => ['nullable'],
];
}
public function dataFields(): array
{
[$image, $upload] = ImageRefFields::fields('Bild (optional)');
[$image, $upload, $status] = ImageRefFields::fields('Bild (optional)');
return [
Repeater::make('items')
@@ -100,6 +107,7 @@ public function dataFields(): array
->helperText('Seitenpfad wie /praevention oder eine http(s)-Adresse. Leer lassen für eine Karte ohne Link.'),
$image,
$upload,
$status,
])
->minItems(1)
->maxItems(12)
@@ -133,7 +141,9 @@ public function clean(array $data, array $refs, WidgetErrors $errors): array
public function resolve(array $widget, RenderContext $context): array
{
$images = app(WebsiteImage::class);
$items = [];
$notices = [];
foreach ($widget['data']['items'] ?? [] as $item) {
if (! is_array($item) || ! filled($item['title'] ?? null)) {
@@ -144,11 +154,15 @@ public function resolve(array $widget, RenderContext $context): array
'title' => $item['title'],
'text' => $item['text'] ?? null,
'url' => SafeUrl::isSafe($item['url'] ?? null) ? $item['url'] : null,
'imageUrl' => PublicMedia::imageUrl($item),
'imageUrl' => $images->url($item['image'] ?? null, $context->preview),
];
if ($context->preview && ($notice = $images->previewNotice($item['image'] ?? null, 'Das Bild der Karte „'.$item['title'].'“')) !== null) {
$notices[] = $notice;
}
}
return ['items' => $items];
return ['items' => $items, 'imageNotice' => $notices === [] ? null : implode(' ', $notices)];
}
public function mediaPaths(array $widget): array
@@ -37,9 +37,14 @@ public function description(): string
return 'Ausgewählte Programme und Module; Titel und Beschreibung kommen automatisch aus den Fachdaten.';
}
public function minUnits(): int
public function supportedUnits(): array
{
return 1;
return [1, 2, 3, 4];
}
public function narrowBehavior(): string
{
return 'Karten stehen untereinander, die Markentafel über dem Text; lange Titel brechen um.';
}
public function preferredUnits(): int
+7 -2
View File
@@ -24,9 +24,14 @@ public function description(): string
return 'Häufige Fragen mit Antworten.';
}
public function minUnits(): int
public function supportedUnits(): array
{
return 2;
return [2, 3, 4];
}
public function narrowBehavior(): string
{
return 'Fragen und Antworten untereinander; Antworten höchstens in Lesebreite.';
}
public function preferredUnits(): int
@@ -23,9 +23,14 @@ public function description(): string
return 'Abschnittsüberschrift mit kurzem Einleitungstext.';
}
public function minUnits(): int
public function supportedUnits(): array
{
return 1;
return [1, 2, 3, 4];
}
public function narrowBehavior(): string
{
return 'Überschriftengröße folgt der Platzbreite; lange Wörter werden getrennt.';
}
public function preferredUnits(): int
+118 -49
View File
@@ -4,15 +4,23 @@
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PremiumFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\Support\SafeUrl;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Grid;
use Filament\Schemas\Components\Group;
/**
* Premium-Einstieg nach Brand-UI-Kit v1.6 (12_premium_widgets_adaptiv_v1.6, Komponente lf-hero).
*
* Version 2: Varianten photo_split und editorial_solid, Höhen compact/normal/large (Mindesthöhen ab 860 px
* Containerbreite), Label, Überschriftenebene, Bildfokus in Prozent, Akzent, zwei Schaltflächen.
* Die data-Schlüssel der Version 1 (heading, text, cta_*, alt) bleiben unverändert, damit ältere Revisionen und ein
* Code-Rollback darstellbar bleiben.
*/
class HeroWidget extends WidgetType
{
public function key(): string
@@ -27,27 +35,46 @@ public function label(): string
public function description(): string
{
return 'Großer Seiteneinstieg mit Überschrift, Beschreibung, optionalem Bild und optionaler Schaltfläche.';
return 'Markenprägender Seiteneinstieg: großes Foto mit Textfläche oder dunkle Markenfläche, Überschrift, Beschreibung und bis zu zwei Schaltflächen.';
}
public function minUnits(): int
public function version(): int
{
return 2;
}
public function preferredUnits(): int
public function supportedUnits(): array
{
return 4;
return [3, 4];
}
public function stages(): array
{
return [
'narrow' => 'unter 48rem Slotbreite: Bild unter dem Text',
'wide' => 'ab 48rem: Bild neben dem Text, größere Überschrift',
'wide' => 'ab 860 px Containerbreite: Foto über die ganze Fläche, Text links auf heller Fläche; Mindesthöhe nach Höheneinstellung',
'safety' => 'unter 860 px nur technischer Sicherheitsumbruch: Foto 16:9 über dem Text, Schaltflächen ab 440 px untereinander',
];
}
public function narrowBehavior(): string
{
return 'Für breite Plätze (3 oder 4 Einheiten). Unter 860 px Containerbreite steht das Foto über dem Text; die Höhe richtet sich dann nach dem Inhalt.';
}
public function heights(): array
{
return [
'compact' => 'Kompakt (mind. 400 px)',
'normal' => 'Normal (mind. 512 px)',
'large' => 'Groß (mind. 640 px)',
];
}
public function defaultHeight(): ?string
{
return 'normal';
}
public function icon(): string
{
return 'heroicon-o-sparkles';
@@ -55,26 +82,72 @@ public function icon(): string
public function schematic(): array
{
return [[2, 3, 56, 30, 'line'], [6, 8, 26, 6, 'ink'], [6, 17, 24, 3, 'line'], [6, 24, 12, 5, 'accent'], [36, 7, 18, 22, 'image']];
return [[2, 3, 56, 30, 'image'], [6, 8, 24, 6, 'ink'], [6, 16, 10, 2, 'accent'], [6, 21, 22, 3, 'line'], [6, 27, 12, 4, 'accent']];
}
public function variants(): array
{
return [
'standard' => 'Standard (Bild neben dem Text)',
'highlight' => 'Hervorgehoben (Markenfläche)',
'photo_split' => 'Foto mit Textfläche',
'editorial_solid' => 'Markenfläche (ohne Foto)',
];
}
public function optionIcons(): array
{
return [
'variant' => ['photo_split' => 'heroicon-o-photo', 'editorial_solid' => 'heroicon-o-swatch'],
'height' => ['compact' => 'heroicon-o-bars-2', 'normal' => 'heroicon-o-bars-3', 'large' => 'heroicon-o-bars-4'],
];
}
public function settings(): array
{
return [
'heading_level' => PremiumFields::HEADING_LEVELS,
'accent' => ['underline' => 'Gelbe Unterstreichung', 'rays' => 'Unterstreichung und Signalstrahlen', 'none' => 'Ohne Akzent'],
];
}
public function settingLabels(): array
{
return [
'heading_level' => ['Überschriftenebene', 'Der erste Einstieg einer Seite ist immer die Hauptüberschrift (H1).'],
'accent' => ['Markenakzent', 'Freigegebene Akzente aus dem Brand-UI-Kit. Vorgabe: gelbe Unterstreichung.'],
];
}
/**
* Version 1 (bis Designiteration 1) → 2: Varianten abbilden, früheren Fokuspunkt in Prozent umrechnen,
* nicht mehr vorhandene Einstellungen (focus, text_side) entfernen. Inhalte bleiben unverändert.
*/
public function upgrade(array $widget, int $from): array
{
if ($from !== 1) {
return parent::upgrade($widget, $from);
}
$widget['variant'] = in_array($widget['variant'] ?? null, ['highlight', 'editorial'], true) ? 'editorial_solid' : 'photo_split';
$settings = is_array($widget['settings'] ?? null) ? $widget['settings'] : [];
$data = is_array($widget['data'] ?? null) ? $widget['data'] : [];
if (! isset($data['focus_x'], $data['focus_y'])) {
$data = PremiumFields::focusFromEnum($settings['focus'] ?? null) + $data;
}
unset($settings['focus'], $settings['text_side']);
$widget['settings'] = $settings;
$widget['data'] = $data;
return $widget;
}
public function dataRules(): array
{
return [
'heading' => ['required', 'string', 'max:200'],
'text' => ['nullable', 'string', 'max:600'],
'cta_label' => ['nullable', 'string', 'max:80', 'required_with:data.cta_url'],
'cta_url' => ['nullable', 'string', 'max:500', 'required_with:data.cta_label'],
'alt' => ['nullable', 'string', 'max:300'],
];
] + PremiumFields::rules();
}
public function refRules(): array
@@ -85,66 +158,62 @@ public function refRules(): array
public function dataFields(): array
{
return [
TextInput::make('heading')->label('Überschrift')->required()->maxLength(200),
Textarea::make('text')->label('Beschreibung')->rows(3)->maxLength(600),
Grid::make(2)->schema([
TextInput::make('cta_label')->label('Schaltfläche: Beschriftung (optional)')->maxLength(80),
TextInput::make('cta_url')
->label('Schaltfläche: Linkziel')
->maxLength(500)
->rule(SafeUrl::rule())
->requiredWith('cta_label'),
]),
TextInput::make('alt')
->label('Alternativtext des Bildes')
->maxLength(300)
->helperText('Pflicht, sobald ein Bild gewählt ist.'),
PremiumFields::eyebrowField(),
TextInput::make('heading')->label('Überschrift')->required()->maxLength(200)->live(onBlur: true),
Textarea::make('text')->label('Beschreibung')->rows(3)->maxLength(600)->live(onBlur: true),
PremiumFields::ctaFields(),
PremiumFields::altField(),
...PremiumFields::focusFields(68, 50),
];
}
public function refFields(): array
{
return ImageRefFields::fields();
return ImageRefFields::fields(live: true);
}
public function editorSchema(): array
{
[$heading, $text, $cta, $alt] = $this->dataFields();
[$eyebrow, $heading, $text, $ctas] = $this->dataFields();
return [Group::make([$eyebrow, $heading, $text, $ctas])->statePath('data')];
}
public function mediaSchema(): array
{
[, , , , $alt, $focusX, $focusY] = $this->dataFields();
return [
Group::make([$heading, $text, $cta])->statePath('data'),
Group::make($this->refFields())->statePath('refs'),
Group::make([$alt])->statePath('data'),
Group::make([$alt, $focusX, $focusY])->statePath('data'),
];
}
public function clean(array $data, array $refs, WidgetErrors $errors): array
{
$refs = ImageRefFields::clean($refs, $errors);
foreach (['text', 'cta_label', 'cta_url', 'alt'] as $key) {
$data[$key] = filled($data[$key] ?? null) ? trim($data[$key]) : null;
}
if ($data['cta_url'] !== null && ! SafeUrl::isSafe($data['cta_url'])) {
$errors->add('data.cta_url', SafeUrl::message());
}
if ($refs['image'] !== null && $data['alt'] === null) {
$errors->add('data.alt', 'Bitte einen Alternativtext für das Bild angeben.');
}
$data['heading'] = trim((string) ($data['heading'] ?? ''));
$data['text'] = filled($data['text'] ?? null) ? trim((string) $data['text']) : null;
$data = PremiumFields::clean($data, $errors, $refs['image'] !== null);
return [$data, $refs];
}
public function resolve(array $widget, RenderContext $context): array
{
$data = $widget['data'];
$hasAction = filled($data['cta_label'] ?? null) && SafeUrl::isSafe($data['cta_url'] ?? null);
$actions = PremiumFields::actions($widget['data']);
$images = app(WebsiteImage::class);
$image = $widget['refs']['image'] ?? null;
return [
'imageUrl' => PublicMedia::imageUrl($widget['refs']),
'action' => $hasAction ? ['label' => $data['cta_label'], 'url' => $data['cta_url']] : null,
'imageUrl' => $images->url($image, $context->preview),
'imageAlt' => $images->alt($image, $widget['data']['alt'] ?? null),
'imageNotice' => $context->preview ? $images->previewNotice($image) : null,
'actions' => $actions,
'action' => $actions[0] ?? null,
'focus' => PremiumFields::focus($widget['data'], 68, 50),
'accent' => in_array($widget['settings']['accent'] ?? null, ['underline', 'rays', 'none'], true) ? $widget['settings']['accent'] : 'underline',
];
}
+116 -39
View File
@@ -4,8 +4,10 @@
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PremiumFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\Support\RichText;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\RichEditor;
@@ -13,10 +15,13 @@
use Filament\Schemas\Components\Group;
/**
* Bild und Text.
* Bild und Text, Premium-Fassung nach Brand-UI-Kit v1.6 (Komponente lf-bild-text).
*
* Version 1 (Bestand): data {image, alt, body} mit Klartext.
* Version 2: data {title, body (formatierter Text), alt}, refs {image}, Varianten Bild links/rechts.
* Version 3: zusätzlich Label, zwei Schaltflächen, Bildfokus in Prozent; Einstellungen Oberfläche, Höhe und
* Überschriftenebene. Die Bildseite bleibt die Variante (keine doppelte Einstellung). Die Einstellung
* format der Designiteration 1 entfällt; die Bildproportion folgt jetzt der Höhe.
*/
class ImageTextWidget extends WidgetType
{
@@ -32,12 +37,17 @@ public function label(): string
public function description(): string
{
return 'Bild neben formatiertem Text; Bild links oder rechts, auf dem Smartphone untereinander.';
return 'Redaktionelle Bild-Text-Komposition mit Label, formatiertem Text und bis zu zwei Schaltflächen; passt sich der Platzbreite an.';
}
public function minUnits(): int
public function version(): int
{
return 2;
return 3;
}
public function supportedUnits(): array
{
return [1, 2, 3, 4];
}
public function preferredUnits(): int
@@ -48,14 +58,29 @@ public function preferredUnits(): int
public function stages(): array
{
return [
'narrow' => 'unter 36rem Slotbreite: Bild über dem Text',
'wide' => 'ab 36rem: Bild links oder rechts neben dem Text',
'stacked' => 'unter 540 px Containerbreite: Bild über dem Text, Schaltflächen untereinander in voller Breite',
'band' => '540 bis 899 px: flacher Bildstreifen über dem vollständigen Text (typisch zwei Einheiten)',
'wide' => 'ab 900 px: Bild und Text nebeneinander, Bild links oder rechts nach Variante',
];
}
public function version(): int
public function narrowBehavior(): string
{
return 2;
return 'Unter 900 px Containerbreite steht das Bild über dem Text, unabhängig von „Bild links/rechts“; die gespeicherte Seite bleibt erhalten. Text und Schaltflächen werden nie gekürzt.';
}
public function heights(): array
{
return [
'compact' => 'Kompakt (flacheres Bild, engere Abstände)',
'normal' => 'Normal',
'spacious' => 'Großzügig (höheres Bild, mehr Abstand)',
];
}
public function defaultHeight(): ?string
{
return 'normal';
}
public function icon(): string
@@ -65,7 +90,7 @@ public function icon(): string
public function schematic(): array
{
return [[4, 6, 22, 24, 'image'], [30, 7, 24, 4, 'ink'], [30, 15, 26, 3, 'line'], [30, 21, 22, 3, 'line']];
return [[4, 6, 22, 24, 'image'], [30, 7, 10, 2, 'accent'], [30, 11, 24, 4, 'ink'], [30, 18, 26, 3, 'line'], [30, 24, 14, 4, 'accent']];
}
public function variants(): array
@@ -76,24 +101,64 @@ public function variants(): array
];
}
public function optionIcons(): array
{
return [
'variant' => ['image_left' => 'heroicon-o-arrow-left', 'image_right' => 'heroicon-o-arrow-right'],
'height' => ['compact' => 'heroicon-o-bars-2', 'normal' => 'heroicon-o-bars-3', 'spacious' => 'heroicon-o-bars-4'],
];
}
public function settings(): array
{
return [
'surface' => ['cream' => 'Creme (Markenfläche)', 'clear' => 'Ohne eigene Fläche', 'navy' => 'Navy (dunkel)'],
'heading_level' => PremiumFields::HEADING_LEVELS,
];
}
public function settingLabels(): array
{
return [
'surface' => ['Hintergrund des Widgets', 'Unabhängig vom Abschnittshintergrund. „Ohne eigene Fläche“ übernimmt den Abschnitt.'],
'heading_level' => ['Überschriftenebene', 'Steht das Widget als erstes auf der Seite, ist die Überschrift immer H1.'],
];
}
public function upgrade(array $widget, int $from): array
{
if ($from !== 1) {
return parent::upgrade($widget, $from);
if ($from === 1) {
$data = $widget['data'];
$widget['data'] = [
'title' => null,
'body' => RichText::fromPlainText(is_string($data['body'] ?? null) ? $data['body'] : ''),
'alt' => $data['alt'] ?? null,
];
$widget['refs'] = [
'image' => PublicMedia::fromUploadState($data['image'] ?? null),
];
return $widget;
}
$data = $widget['data'];
if ($from === 2) {
// Designiteration 1 → Premium: Fokus in Prozent, Bildformat entfällt (Proportion folgt der Höhe).
$settings = is_array($widget['settings'] ?? null) ? $widget['settings'] : [];
$data = is_array($widget['data'] ?? null) ? $widget['data'] : [];
$widget['data'] = [
'title' => null,
'body' => RichText::fromPlainText(is_string($data['body'] ?? null) ? $data['body'] : ''),
'alt' => $data['alt'] ?? null,
];
$widget['refs'] = [
'image' => PublicMedia::fromUploadState($data['image'] ?? null),
];
if (! isset($data['focus_x'], $data['focus_y'])) {
$data = PremiumFields::focusFromEnum($settings['focus'] ?? null) + $data;
}
return $widget;
unset($settings['focus'], $settings['format']);
$widget['settings'] = $settings;
$widget['data'] = $data;
return $widget;
}
return parent::upgrade($widget, $from);
}
public function dataRules(): array
@@ -101,8 +166,7 @@ public function dataRules(): array
return [
'title' => ['nullable', 'string', 'max:160'],
'body' => ['required', 'string', 'max:40000'],
'alt' => ['nullable', 'string', 'max:300'],
];
] + PremiumFields::rules();
}
public function refRules(): array
@@ -113,31 +177,38 @@ public function refRules(): array
public function dataFields(): array
{
return [
TextInput::make('title')->label('Titel (optional)')->maxLength(160),
PremiumFields::eyebrowField(),
TextInput::make('title')->label('Überschrift')->maxLength(160)->live(onBlur: true),
RichEditor::make('body')
->label('Text')
->required()
->live(onBlur: true)
->toolbarButtons(RichText::TOOLBAR),
TextInput::make('alt')
->label('Alternativtext des Bildes')
->maxLength(300)
->helperText('Beschreibt, was auf dem Bild zu sehen ist. Pflicht, sobald ein Bild gewählt ist.'),
PremiumFields::ctaFields(),
PremiumFields::altField(),
...PremiumFields::focusFields(64, 43),
];
}
public function refFields(): array
{
return ImageRefFields::fields();
return ImageRefFields::fields(live: true);
}
public function editorSchema(): array
{
[$title, $body, $alt] = $this->dataFields();
[$eyebrow, $title, $body, $ctas] = $this->dataFields();
return [Group::make([$eyebrow, $title, $body, $ctas])->statePath('data')];
}
public function mediaSchema(): array
{
[, , , , $alt, $focusX, $focusY] = $this->dataFields();
return [
Group::make([$title, $body])->statePath('data'),
Group::make($this->refFields())->statePath('refs'),
Group::make([$alt])->statePath('data'),
Group::make([$alt, $focusX, $focusY])->statePath('data'),
];
}
@@ -145,25 +216,31 @@ public function clean(array $data, array $refs, WidgetErrors $errors): array
{
$refs = ImageRefFields::clean($refs, $errors);
$data['body'] = RichText::sanitize($data['body'] ?? '');
$data['title'] = filled($data['title'] ?? null) ? trim($data['title']) : null;
$data['alt'] = filled($data['alt'] ?? null) ? trim($data['alt']) : null;
$data['title'] = filled($data['title'] ?? null) ? trim((string) $data['title']) : null;
$data = PremiumFields::clean($data, $errors, $refs['image'] !== null);
if (RichText::isBlank($data['body'])) {
$errors->add('data.body', 'Bitte einen Text eingeben.');
}
if ($refs['image'] !== null && $data['alt'] === null) {
$errors->add('data.alt', 'Bitte einen Alternativtext für das Bild angeben.');
}
return [$data, $refs];
}
public function resolve(array $widget, RenderContext $context): array
{
$surface = $widget['settings']['surface'] ?? 'cream';
$images = app(WebsiteImage::class);
$image = $widget['refs']['image'] ?? null;
return [
'imageUrl' => PublicMedia::imageUrl($widget['refs']),
'imageUrl' => $images->url($image, $context->preview),
'imageAlt' => $images->alt($image, $widget['data']['alt'] ?? null),
'imageNotice' => $context->preview ? $images->previewNotice($image) : null,
'body' => RichText::sanitize(is_string($widget['data']['body'] ?? null) ? $widget['data']['body'] : ''),
'actions' => PremiumFields::actions($widget['data']),
'focus' => PremiumFields::focus($widget['data'], 64, 43),
'surface' => in_array($surface, ['cream', 'clear', 'navy'], true) ? $surface : 'cream',
];
}
@@ -0,0 +1,91 @@
<?php
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Catalog\ContentElement;
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\RenderContext;
/**
* Medien- und Materialkarte (Kit v1.7 „media“): ein Inhaltselement mit Anzeigetitel, Kurzbeschreibung, Inhaltsart und
* Ausgabeart. Filme erscheinen als Medienkarte (grüne Aktion, Filmtafel ohne freigegebenes Bild), Dokumente und andere
* Materialien als Materialkarte (Materialsymbol). Öffentlich nur nach den Regeln von PublicMaterialReader; die Aktion
* führt auf die öffentliche Programmseite. Die Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei.
*/
class MediaCardWidget extends PremiumCardWidget
{
public function key(): string
{
return 'media_card';
}
public function label(): string
{
return 'Medien- und Materialkarte';
}
public function description(): string
{
return 'Karte zu einem Film oder Material aus der Bibliothek; Titel und Art kommen aus den Fachdaten, kein Abspielen, kein Download.';
}
public function icon(): string
{
return 'heroicon-o-film';
}
public function schematic(): array
{
return [[2, 2, 56, 32, 'line'], [5, 5, 22, 26, 'image'], [7, 7, 8, 3, 'accent'], [31, 8, 22, 4, 'ink'], [31, 15, 22, 5, 'line'], [31, 25, 14, 5, 'accent']];
}
protected function refKey(): string
{
return 'element';
}
protected function refLabel(): string
{
return 'Medium oder Material';
}
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.';
}
protected function searchSubjects(?string $term): array
{
return app(PublicMaterialReader::class)->search($term);
}
protected function subjectLabel(mixed $id): ?string
{
return app(PublicMaterialReader::class)->labelFor($id);
}
protected function rejectSubject(int $id): ?string
{
$element = ContentElement::query()->find($id);
return $element !== null && app(PublicMaterialReader::class)->isSelectable($element)
? null
: 'Dieser Inhalt ist archiviert oder gesperrt.';
}
protected function subject(mixed $id, RenderContext $context): ?CardSubject
{
return app(PublicMaterialReader::class)->subject($id, includeNonPublic: $context->preview);
}
protected function defaultActionLabel(): string
{
return 'Im Programm ansehen';
}
protected function cardStyle(): string
{
return 'media';
}
}
@@ -0,0 +1,276 @@
<?php
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PremiumFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Group;
/**
* Gemeinsame Basis der Premium-Karten (Brand-UI-Kit v1.7, Entwurf zur visuellen Freigabe):
* Redaktionelle Themenkarte, Medien- und Materialkarte, Modul- und Programmkarte.
*
* - Eine Karte je Widget, ein Widget je Platz. Das Raster ist das bestehende Abschnittsraster (1 bis 4 Einheiten);
* es gibt kein zweites Kartenraster.
* - refs: genau ein Fachobjekt (Kennung) und optional ein Bild aus dem öffentlichen Website-Bereich.
* Titel, Kurzbeschreibung, Art, Zusatzangaben und Linkziel kommen zur Laufzeit aus den Fachdaten.
* - data: nur Redaktionelles, das es im Fachobjekt nicht gibt: Beschriftung der Aktion, Hinweis, Alternativtext,
* Bildausschnitt. Ein freies Linkziel gibt es nicht; das Ziel ist immer die öffentliche Seite des Fachobjekts.
* - Bilder der Bibliothek (Vorschaubilder, Filmstandbilder) werden nie gezeigt.
*/
abstract class PremiumCardWidget extends WidgetType
{
public const SHOW = ['yes' => 'Anzeigen', 'no' => 'Ausblenden'];
/** Schlüssel des Fachobjekts in refs, zum Beispiel 'pillar'. */
abstract protected function refKey(): string;
abstract protected function refLabel(): string;
abstract protected function refHelp(): string;
/**
* @return array<int, string>
*/
abstract protected function searchSubjects(?string $term): array;
abstract protected function subjectLabel(mixed $id): ?string;
/** Prüft beim Speichern, ob das Objekt gewählt werden darf; liefert sonst die Fehlermeldung. */
abstract protected function rejectSubject(int $id): ?string;
abstract protected function subject(mixed $id, RenderContext $context): ?CardSubject;
abstract protected function defaultActionLabel(): string;
/** Gestaltungsvariante des Kits: editorial, media oder catalog. */
abstract protected function cardStyle(): string;
public function view(): string
{
return 'widgets.premium_card';
}
public function supportedUnits(): array
{
return [1, 2, 3, 4];
}
public function preferredUnits(): int
{
return 1;
}
public function stages(): array
{
return [
'stacked' => 'unter 520 px Kartenbreite: Bild oder Tafel über dem Text',
'side' => 'ab 520 px: Bild links (42 %), Text rechts (58 %); das gewählte Bildformat bleibt erhalten',
];
}
public function narrowBehavior(): string
{
return 'Unter 520 px Kartenbreite steht das Bild über dem Text. Ab etwa 240 px nutzbar, empfohlen ab 280 px (eine Einheit ab Tablet). Texte werden nie gekürzt.';
}
public function heights(): array
{
return [
'auto' => 'Natürliche Höhe',
'fill' => 'An die Zeile angleichen',
];
}
public function variants(): array
{
return [
'adaptive' => 'Anpassend (ab 520 px Bild neben Text)',
'stacked' => 'Bild immer über dem Text',
];
}
public function optionIcons(): array
{
return [
'variant' => ['adaptive' => 'heroicon-o-view-columns', 'stacked' => 'heroicon-o-bars-3-bottom-left'],
'height' => ['auto' => 'heroicon-o-arrows-pointing-in', 'fill' => 'heroicon-o-arrows-up-down'],
];
}
public function settings(): array
{
return [
'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'],
'show_summary' => self::SHOW,
'show_kind' => self::SHOW,
'show_meta' => self::SHOW,
'show_action' => self::SHOW,
];
}
public function settingLabels(): array
{
return [
'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_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.'],
];
}
public function dataRules(): array
{
return [
'action_label' => ['nullable', 'string', 'max:60'],
'note' => ['nullable', 'string', 'max:200'],
'alt' => ['nullable', 'string', 'max:300'],
'focus_x' => ['nullable', 'numeric', 'between:0,100'],
'focus_y' => ['nullable', 'numeric', 'between:0,100'],
];
}
public function refRules(): array
{
return [$this->refKey() => ['required', 'integer']] + ImageRefFields::rules();
}
public function dataFields(): array
{
return [
TextInput::make('action_label')
->label('Beschriftung der Aktion (optional)')
->maxLength(60)
->placeholder($this->defaultActionLabel())
->live(onBlur: true)
->helperText('Das Linkziel ist immer die öffentliche Seite des gewählten Objekts und kann nicht frei gesetzt werden.'),
TextInput::make('note')
->label('Hinweis (optional)')
->maxLength(200)
->live(onBlur: true)
->helperText('Kurzer redaktioneller Satz über der Aktion, zum Beispiel „Für die nächste Kursstunde“. Begründet keine Berechtigung.'),
PremiumFields::altField(),
...PremiumFields::focusFields(66, 45),
];
}
public function refFields(): array
{
return [$this->subjectField(), ...ImageRefFields::fields(live: true)];
}
public function editorSchema(): array
{
[$action, $note] = $this->dataFields();
return [
Group::make([$this->subjectField()])->statePath('refs'),
Group::make([$action, $note])->statePath('data'),
];
}
public function mediaSchema(): array
{
[, , $alt, $focusX, $focusY] = $this->dataFields();
return [
Group::make(ImageRefFields::fields('Kartenbild', live: true))->statePath('refs'),
Group::make([$alt, $focusX, $focusY])->statePath('data'),
];
}
public function clean(array $data, array $refs, WidgetErrors $errors): array
{
$key = $this->refKey();
$id = (int) $refs[$key];
$rejection = $this->rejectSubject($id);
if ($rejection !== null) {
$errors->add("refs.$key", $rejection);
}
$refs[$key] = $id;
$refs = ImageRefFields::clean($refs, $errors);
foreach (['action_label', 'note', 'alt'] as $field) {
$data[$field] = filled($data[$field] ?? null) ? trim((string) $data[$field]) : null;
}
foreach (['focus_x', 'focus_y'] as $field) {
$value = $data[$field] ?? null;
$data[$field] = is_numeric($value) ? (int) round(max(0, min(100, (float) $value))) : null;
}
return [$data, $refs];
}
public function resolve(array $widget, RenderContext $context): array
{
$settings = $widget['settings'];
$option = fn (string $key, string $default): string => is_string($settings[$key] ?? null) && isset($this->settingOptions()[$key][$settings[$key]]) ? $settings[$key] : $default;
$data = $widget['data'];
$subject = $this->subject($widget['refs'][$this->refKey()] ?? null, $context);
return [
'subject' => $subject,
'cardStyle' => $subject?->style ?? $this->cardStyle(),
'imageUrl' => app(WebsiteImage::class)->url($widget['refs']['image'] ?? null, $context->preview),
'alt' => app(WebsiteImage::class)->alt($widget['refs']['image'] ?? null, $data['alt'] ?? null),
'imageNotice' => $context->preview ? app(WebsiteImage::class)->previewNotice($widget['refs']['image'] ?? null, 'Das Kartenbild') : null,
'focus' => PremiumFields::focus($data, 66, 45),
'format' => $option('format', 'landscape'),
'fit' => $option('fit', 'cover'),
'headingTag' => $option('heading_level', 'h3'),
'show' => [
'summary' => ! array_key_exists('show_summary', $this->settings()) || $option('show_summary', 'yes') === 'yes',
'kind' => ! array_key_exists('show_kind', $this->settings()) || $option('show_kind', 'yes') === 'yes',
'meta' => $option('show_meta', 'yes') === 'yes',
'action' => $option('show_action', 'yes') === 'yes',
],
'actionLabel' => filled($data['action_label'] ?? null) ? (string) $data['action_label'] : $this->defaultActionLabel(),
'note' => filled($data['note'] ?? null) ? (string) $data['note'] : null,
'stacked' => $widget['variant'] === 'stacked',
];
}
public function mediaPaths(array $widget): array
{
$image = $widget['refs']['image'] ?? null;
return PublicMedia::isPublicPath($image) ? [$image] : [];
}
public function summary(array $widget): string
{
$label = $this->subjectLabel($widget['refs'][$this->refKey()] ?? null);
return $label ?? 'Kein Objekt gewählt';
}
private function subjectField(): Select
{
return Select::make($this->refKey())
->label($this->refLabel())
->helperText($this->refHelp())
->required()
->live()
->searchable()
->getSearchResultsUsing(fn (?string $search): array => $this->searchSubjects($search))
->getOptionLabelUsing(fn (mixed $value): ?string => $this->subjectLabel($value))
->options(fn (): array => $this->searchSubjects(null));
}
}
@@ -0,0 +1,100 @@
<?php
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Catalog\Composition;
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Cms\Widgets\RenderContext;
/**
* Modul- und Programmkarte (Kit v1.7 „catalog“): ein Programm oder Modul über PublicCatalogReader, dieselbe
* Freigaberegel wie die Programm- und Modulkarten (Programme öffentlich mit Programmseite, Module nur in der
* Redaktionsvorschau). Die Art ist immer sichtbar benannt. Ohne Bild trägt eine Navy-Tafel die Art.
* Kein Preis, kein Angebot, keine Kaufaktion; eine Karte ist kein Lizenzartikel.
*/
class ProgramCardWidget extends PremiumCardWidget
{
public function key(): string
{
return 'program_card';
}
public function label(): string
{
return 'Programm- oder Modulkarte';
}
public function description(): string
{
return 'Karte zu einem Programm oder Modul; Titel, Beschreibung und Art kommen aus den Fachdaten, ohne Preis und ohne Kaufaktion.';
}
public function icon(): string
{
return 'heroicon-o-academic-cap';
}
public function schematic(): array
{
return [[2, 2, 56, 32, 'line'], [5, 5, 22, 26, 'ink'], [8, 24, 10, 2, 'accent'], [31, 8, 10, 2, 'line'], [31, 13, 22, 4, 'ink'], [31, 25, 14, 5, 'ink']];
}
public function settings(): array
{
// Die Art (Programm oder Modul) bleibt immer sichtbar; sie lässt sich nicht ausblenden.
$settings = parent::settings();
unset($settings['show_kind']);
return $settings;
}
protected function refKey(): string
{
return 'composition';
}
protected function refLabel(): string
{
return 'Programm oder Modul';
}
protected function refHelp(): string
{
return 'Wählbar sind Programme und Module mit bereitgestellter Fassung. Öffentlich erscheinen nur Programme mit Anzeigefreigabe (mit Programmseite); Module haben keine öffentliche Seite und erscheinen nur in der Redaktionsvorschau.';
}
protected function searchSubjects(?string $term): array
{
return app(PublicCatalogReader::class)->cardSearch($term);
}
protected function subjectLabel(mixed $id): ?string
{
return app(PublicCatalogReader::class)->cardLabelFor($id);
}
protected function rejectSubject(int $id): ?string
{
$composition = Composition::query()->with('editorialContentKind')->find($id);
return $composition !== null && app(PublicCatalogReader::class)->isCardSelectable($composition)
? null
: 'Dieses Objekt ist kein Programm oder Modul mit bereitgestellter Fassung.';
}
protected function subject(mixed $id, RenderContext $context): ?CardSubject
{
return app(PublicCatalogReader::class)->subject($id, includeNonPublic: $context->preview);
}
protected function defaultActionLabel(): string
{
return 'Programm ansehen';
}
protected function cardStyle(): string
{
return 'catalog';
}
}
+7 -2
View File
@@ -23,9 +23,14 @@ public function description(): string
return 'Längerer Text in Absätzen. Eine Leerzeile beginnt einen neuen Absatz.';
}
public function minUnits(): int
public function supportedUnits(): array
{
return 1;
return [1, 2, 3, 4];
}
public function narrowBehavior(): string
{
return 'Fließtext bricht um; Zeilen höchstens etwa 70 Zeichen.';
}
public function preferredUnits(): int
@@ -0,0 +1,137 @@
<?php
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Catalog\Pillar;
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Widgets\RenderContext;
/**
* Redaktionelle Themenkarte (Kit v1.7 „editorial“): ein Thema (fachliche Säule) mit Name, Text für die Website und
* Verweis auf die Themenseite /themen/{slug}. Ruhige Textaktion mit gelber Unterstreichung. Wählbar sind alle Säulen;
* ein nicht veröffentlichtes Thema erscheint nur in der Redaktionsvorschau, öffentlich nicht.
*/
class TopicCardWidget extends PremiumCardWidget
{
public function key(): string
{
return 'topic_card';
}
public function label(): string
{
return 'Themenkarte';
}
public function description(): string
{
return 'Redaktionelle Karte zu einem veröffentlichten Thema; Name, Kurzbeschreibung und Ziel kommen aus dem Thema.';
}
public function icon(): string
{
return 'heroicon-o-bookmark-square';
}
public function schematic(): array
{
return [[2, 2, 56, 32, 'line'], [5, 5, 22, 26, 'image'], [31, 8, 10, 2, 'accent'], [31, 13, 22, 4, 'ink'], [31, 20, 20, 3, 'line'], [31, 27, 12, 2, 'accent']];
}
protected function refKey(): string
{
return 'pillar';
}
protected function refLabel(): string
{
return 'Thema';
}
protected function refHelp(): string
{
return 'Alle fachlichen Säulen sind wählbar. Öffentlich erscheint die Karte nur, wenn das Thema veröffentlicht ist; Name und Text pflegen Sie unter „Fachliche Säulen“, nicht hier.';
}
protected function searchSubjects(?string $term): array
{
$term = trim((string) $term);
return Pillar::query()
->orderBy('sort_order')
->orderBy('name')
->when($term !== '', fn ($query) => $query->whereRaw('LOWER(name) LIKE ?', ['%'.mb_strtolower($term).'%']))
->limit(50)
->get()
->mapWithKeys(fn (Pillar $pillar): array => [$pillar->id => $this->optionLabel($pillar)])
->all();
}
protected function subjectLabel(mixed $id): ?string
{
$pillar = is_numeric($id) ? Pillar::query()->find((int) $id) : null;
return $pillar === null ? null : $this->optionLabel($pillar);
}
protected function rejectSubject(int $id): ?string
{
return Pillar::query()->whereKey($id)->exists() ? null : 'Dieses Thema gibt es nicht.';
}
protected function subject(mixed $id, RenderContext $context): ?CardSubject
{
$pillar = is_numeric($id) ? Pillar::query()->find((int) $id) : null;
if ($pillar === null) {
return null;
}
$public = self::isPublic($pillar);
if (! $public && ! $context->preview) {
return null;
}
$summary = filled($pillar->public_summary) ? trim((string) $pillar->public_summary) : null;
$pages = $pillar->pages()->whereNotNull('published_revision_id')->count();
$missing = [];
if ($summary === null) {
$missing[] = 'Kein Text für die Website gepflegt (Fachliche Säulen → Text für die Website).';
}
return new CardSubject(
title: (string) $pillar->name,
summary: $summary,
kind: 'Thema',
badge: null,
meta: $pages > 0 ? [$pages === 1 ? '1 Seite zum Thema' : $pages.' Seiten zum Thema'] : [],
url: $public ? $pillar->publicUrl() : null,
public: $public,
notice: $public ? null : 'Nur in der Redaktionsvorschau sichtbar: Das Thema ist nicht veröffentlicht (Fachliche Säulen → Öffentliche Adresse und „Auf der Website veröffentlichen“).',
missing: $missing,
);
}
/** Öffentlich ist ein Thema mit Veröffentlichung und öffentlicher Adresse (dieselbe Regel wie /themen). */
public static function isPublic(Pillar $pillar): bool
{
return $pillar->published_at !== null && filled($pillar->slug);
}
private function optionLabel(Pillar $pillar): string
{
return $pillar->name.' · Thema · '.(self::isPublic($pillar) ? 'veröffentlicht' : 'nicht veröffentlicht, nur Redaktionsvorschau');
}
protected function defaultActionLabel(): string
{
return 'Thema entdecken';
}
protected function cardStyle(): string
{
return 'editorial';
}
}
+13 -3
View File
@@ -45,8 +45,18 @@ public function register(WidgetType $type): void
throw new InvalidArgumentException("Widget „{$key}“ braucht eine Schemaversion ab 1.");
}
if ($type->minUnits() < 1 || $type->minUnits() > 4 || $type->preferredUnits() < $type->minUnits() || $type->preferredUnits() > 4) {
throw new InvalidArgumentException("Widget „{$key}“ braucht eine Mindest- und Vorzugsbreite zwischen 1 und 4 Rastereinheiten.");
// Gemeinsamer Layoutvertrag (ADR-38): Breiten, Vorzugsbreite und Höhen aus festen Wertebereichen.
$units = $type->supportedUnits();
if ($units === [] || array_diff($units, [1, 2, 3, 4]) !== [] || $units !== array_values(array_unique($units)) || ! $type->supportsUnits($type->preferredUnits())) {
throw new InvalidArgumentException("Widget „{$key}“ braucht unterstützte Breiten zwischen 1 und 4 Rastereinheiten und eine darin enthaltene Vorzugsbreite.");
}
if (array_diff(array_keys($type->heights()), array_keys(WidgetType::HEIGHTS)) !== []) {
throw new InvalidArgumentException("Widget „{$key}“ verwendet eine Höhe außerhalb des gemeinsamen Vokabulars.");
}
if (array_key_exists('height', $type->settings())) {
throw new InvalidArgumentException("Widget „{$key}“ deklariert die Höhe über heights(), nicht über settings().");
}
if ($type->variants() === []) {
@@ -266,7 +276,7 @@ private function validateOne(WidgetType $type, array $widget, string $errorPrefi
}
$settings = [];
$allowedSettings = $type->settings();
$allowedSettings = $type->settingOptions();
foreach ($widget['settings'] as $key => $value) {
if ($value === null || $value === '') {
continue;
+6 -1
View File
@@ -61,6 +61,7 @@ public function renderWidget(array $widget, RenderContext $context, bool $first
'refs' => $widget['refs'],
'variant' => $widget['variant'],
'settings' => $widget['settings'],
'height' => $type->height($widget),
'first' => $first,
'context' => $context,
] + $type->resolve($widget, $context))->render());
@@ -71,7 +72,11 @@ public function renderWidget(array $widget, RenderContext $context, bool $first
$id = is_string($widget['id'] ?? null) ? ' id="abschnitt-'.e($widget['id']).'"' : '';
return '<section class="block widget widget-'.e(str_replace('_', '-', $widget['type'])).' widget-variant-'.e(str_replace('_', '-', $widget['variant'])).'"'.$id.'>'
// Gemeinsamer Layoutvertrag (ADR-38): Höhe als Klasse an der Hülle, nur wenn die Art Höhen anbietet.
$height = $type->height($widget);
$heightClass = $height !== null ? ' widget-height-'.e($height) : '';
return '<section class="block widget widget-'.e(str_replace('_', '-', $widget['type'])).' widget-variant-'.e(str_replace('_', '-', $widget['variant'])).$heightClass.'"'.$id.'>'
.$inner
.'</section>';
}
+133 -3
View File
@@ -35,12 +35,57 @@ public function version(): int
}
/**
* Kleinste Slotbreite in logischen Rastereinheiten (1 bis 4), in der das Widget auf dem Desktop lesbar bleibt.
* Ein schmalerer Slot wird beim Speichern abgewiesen. Auf Tablet und Smartphone stapeln die Slots ohnehin.
* Gemeinsames Höhenvokabular aller Widget-Arten (ADR-38). Eine Art bietet davon nur die sinnvollen Werte an
* (heights()). Die Höhe ist ein Gestaltungsparameter, nie eine Begrenzung: Inhalte erhalten immer den nötigen Platz.
*/
public const HEIGHTS = [
'auto' => 'Automatisch',
'compact' => 'Kompakt',
'normal' => 'Normal',
'large' => 'Groß',
'spacious' => 'Großzügig',
'fill' => 'Abschnittshöhe füllen',
];
/**
* Gemeinsamer Layoutvertrag (ADR-38), Teil 1: zulässige Platzbreiten in logischen Rastereinheiten (1 bis 4).
* Ein Platz mit nicht unterstützter Breite wird beim Speichern abgewiesen. Auf Tablet und Smartphone stapeln die
* Plätze; dort bestimmt die tatsächliche Containerbreite die Darstellung (Container-Abfragen), nicht die Einheitenzahl.
*
* @return list<int>
*/
public function supportedUnits(): array
{
return [1, 2, 3, 4];
}
public function supportsUnits(int $units): bool
{
return in_array($units, $this->supportedUnits(), true);
}
/** Kleinste zulässige Platzbreite; abgeleitet aus supportedUnits(). */
public function minUnits(): int
{
return 1;
return min($this->supportedUnits());
}
/** Lesbare Angabe der zulässigen Platzbreiten, zum Beispiel „1 bis 4“ oder „3 oder 4“. */
public function unitsLabel(): string
{
$units = $this->supportedUnits();
if (count($units) === 1) {
return (string) $units[0];
}
if ($units === range(min($units), max($units)) && count($units) > 2) {
return min($units).' bis '.max($units);
}
$last = array_pop($units);
return implode(', ', $units).' oder '.$last;
}
/** Empfohlene Slotbreite in Rastereinheiten; Hinweis in der Widget-Auswahl. */
@@ -60,6 +105,42 @@ public function stages(): array
return ['fluid' => 'passt sich fließend an jede Slotbreite an'];
}
/**
* Gemeinsamer Layoutvertrag, Teil 2: angebotene Höhen (Schlüssel aus HEIGHTS => Bezeichnung im Editor).
* Leer: keine Höhenwahl, die Höhe folgt dem Inhalt. Der erste Eintrag ist die Vorgabe.
*
* @return array<string, string>
*/
public function heights(): array
{
return [];
}
public function defaultHeight(): ?string
{
$key = array_key_first($this->heights());
return $key === null ? null : (string) $key;
}
/**
* Wirksame Höhe einer Instanz (gespeicherte Einstellung oder Vorgabe).
*
* @param array<string, mixed> $widget
*/
public function height(array $widget): ?string
{
$height = $widget['settings']['height'] ?? null;
return is_string($height) && array_key_exists($height, $this->heights()) ? $height : $this->defaultHeight();
}
/** Gemeinsamer Layoutvertrag, Teil 3: Verhalten bei reduziertem Platzangebot (Hinweis im Editor und in der Dokumentation). */
public function narrowBehavior(): string
{
return 'Text bricht um, nichts wird abgeschnitten.';
}
/** Heroicon-Name für Auswahl und Liste im Editor. */
public function icon(): string
{
@@ -102,6 +183,44 @@ public function settings(): array
return [];
}
/**
* Bezeichnungen der Einstellungen im Editor: Schlüssel => [Bezeichnung, Hilfetext].
* Ohne leere Auswahl gilt die Vorgabe der Darstellung.
*
* @return array<string, array{0: string, 1?: string}>
*/
public function settingLabels(): array
{
return [];
}
/**
* Alle zulässigen Einstellungen einschließlich der gemeinsamen Höhe. Registry-Prüfung, Editor und Darstellung
* verwenden ausschließlich diese Zusammenführung.
*
* @return array<string, array<string, string>>
*/
final public function settingOptions(): array
{
$options = $this->settings();
if ($this->heights() !== []) {
$options['height'] = $this->heights();
}
return $options;
}
/**
* Symbole für die visuelle Auswahl im Editor: 'variant' oder Einstellungsschlüssel => [Wert => Heroicon].
*
* @return array<string, array<string, string>>
*/
public function optionIcons(): array
{
return [];
}
/**
* Prüfregeln für data. Schlüssel relativ zu data (zum Beispiel 'heading', 'items.*.title').
*
@@ -142,6 +261,17 @@ public function refFields(): array
*
* @return list<Component>
*/
/**
* Felder der Gruppe „Medien“ im Bearbeitungsdialog (Bild, Bildausschnitt, Alternativtext). Leer: keine eigene Gruppe;
* Verweise stehen dann mit im Inhalt (editorSchema()).
*
* @return list<Component>
*/
public function mediaSchema(): array
{
return [];
}
public function editorSchema(): array
{
$schema = [];
+27 -1
View File
@@ -52,6 +52,18 @@ public function forElementUpload(ContentElement $element, string $incoming): voi
$this->rememberElement($element, 'eigen');
}
public function forWebsiteImage(ContentElement $element, string $incoming): void
{
if ($element->output_class !== 'bild' || ! $this->incomingIsSafe($incoming)) {
$this->fail($element, 'Das Bild für die Website wurde nicht übernommen.');
return;
}
$this->still($element, Storage::disk('cms_incoming'), $incoming, 'element-'.$element->id);
$this->rememberElement($element, 'eigen');
}
public function forElementFrame(ContentElement $element, ContentElementVersion $version, float $seconds): void
{
if ($version->content_element_id !== $element->id || $element->output_class !== 'film') {
@@ -201,6 +213,14 @@ private function readableDerived(mixed $path, string $prefix): bool
return Storage::disk('media_derived')->exists($path);
}
private function incomingIsSafe(string $incoming): bool
{
return (str_starts_with($incoming, 'cms/') || str_starts_with($incoming, 'vorschau/'))
&& ! str_contains($incoming, '..')
&& preg_match('#^(cms|vorschau)/[A-Za-z0-9._\-/]+$#', $incoming) === 1
&& Storage::disk('cms_incoming')->exists($incoming);
}
private function secondText(float $seconds): string
{
$seconds = max(0, min(7200, $seconds));
@@ -271,9 +291,15 @@ private function still(ContentElement|Composition $subject, Filesystem $disk, st
$width = imagesx($image);
$height = imagesy($image);
$targetWidth = 640;
// Bilder (Ausgabeart „bild“) dienen auch als Website-Ableitung für Einstieg und Hintergrund. 640 px wären dort
// sichtbar unscharf; deshalb bis 2400 px, nie vergrößert. Filmstandbilder und Modulvorschauen bleiben bei 640 px.
$targetWidth = $subject instanceof ContentElement && $subject->output_class === 'bild'
? max(1, min(2400, $width))
: 640;
$targetHeight = (int) max(1, round($height * ($targetWidth / max(1, $width))));
$canvas = imagecreatetruecolor($targetWidth, $targetHeight);
// Transparente Flächen (PNG, GIF) werden im JPEG weiß statt schwarz.
imagefill($canvas, 0, 0, (int) imagecolorallocate($canvas, 255, 255, 255));
imagecopyresampled($canvas, $image, 0, 0, 0, 0, $targetWidth, $targetHeight, $width, $height);
ob_start();
imagejpeg($canvas, null, 82);
+54
View File
@@ -0,0 +1,54 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\IdentityProfile;
use App\Jobs\AcceptWebsiteImage;
use App\Models\User;
use Illuminate\Support\Facades\Storage;
/**
* Nimmt ein neues Website-Bild in den Medienmanager auf.
* Die Warteschlange erzeugt danach die Ableitung und gibt sie frei.
*/
class WebsiteIntake
{
public function acceptImage(
string $incomingPath,
string $title,
?string $credit = null,
?string $alt = null,
?User $actor = null,
): ContentElement {
$title = trim($title);
if ($title === '') {
throw new DomainRuleException('Der Titel fehlt.');
}
if (! $this->incomingIsReadable($incomingPath)) {
throw new DomainRuleException('Die Bilddatei liegt nicht im Eingang.');
}
$element = app(ContentService::class)->createElement('bild', 'bild', $title);
app(IdentityProfile::class)->fill($element, [
'display_title' => $title,
'website_credit' => $credit,
'website_alt' => $alt,
], $actor);
AcceptWebsiteImage::dispatch($element->id, $incomingPath, $actor?->id);
return $element->fresh();
}
private function incomingIsReadable(string $path): bool
{
return (str_starts_with($path, 'cms/') || str_starts_with($path, 'vorschau/'))
&& ! str_contains($path, '..')
&& preg_match('#^(cms|vorschau)/[A-Za-z0-9._\-/]+$#', $path) === 1
&& Storage::disk('cms_incoming')->exists($path);
}
}
+72
View File
@@ -0,0 +1,72 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\ContentElement;
use Illuminate\Support\Facades\Storage;
/**
* Lesesicht für Hero, Teaser und Slideshow.
* Liefert nur eine freigegebene öffentliche Ableitung, sonst nichts.
*/
class WebsiteMedia
{
public function present(ContentElement|int $element): ?WebsitePresentation
{
$element = $element instanceof ContentElement
? $element
: ContentElement::query()->find($element);
if (! $element instanceof ContentElement || $element->website_released_at === null) {
return null;
}
$path = $element->website_public_path;
$expected = '#^website/'.$element->id.'/datei\.[a-z0-9]+$#';
if (! is_string($path) || preg_match($expected, $path) !== 1) {
return null;
}
if (! Storage::disk('media_public')->exists($path)) {
return null;
}
$title = trim((string) ($element->display_title ?: $element->working_title));
$alt = trim((string) ($element->website_alt ?? ''));
return new WebsitePresentation(
elementId: $element->id,
title: $title,
alt: $alt !== '' ? $alt : $title,
credit: filled($element->website_credit) ? trim((string) $element->website_credit) : null,
kind: $element->output_class === 'film' ? 'film' : 'bild',
url: route('website.media', $element),
);
}
/**
* Slideshow: freigegebene Medien in der angegebenen Reihenfolge. Nicht freigegebene Einträge entfallen.
*
* @param list<int|string> $ids
* @return list<WebsitePresentation>
*/
public function presentMany(array $ids): array
{
$presentations = [];
foreach ($ids as $id) {
if (! is_numeric($id)) {
continue;
}
$presentation = $this->present((int) $id);
if ($presentation !== null) {
$presentations[] = $presentation;
}
}
return $presentations;
}
}
+59
View File
@@ -0,0 +1,59 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\IdentityChange;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Früherer CMS-Bildpfad (cms/…), der in den Medienmanager übernommen wurde.
*
* Wirksam ist die Zuordnung erst, wenn das Medium mindestens einmal für die Website freigegeben war. Bis dahin
* (Ableitung läuft noch oder ist fehlgeschlagen) bleibt der frühere Pfad gültig, damit keine Seite ihr Bild verliert.
* Danach entscheidet allein die Website-Freigabe des Mediums, auch über die frühere Adresse /medien/cms/….
*/
class WebsiteMediaAlias extends Model
{
protected $fillable = ['legacy_path', 'content_element_id', 'sha256'];
public function element(): BelongsTo
{
return $this->belongsTo(ContentElement::class, 'content_element_id');
}
/**
* Wirksame Zuordnung für einen früheren Pfad, sonst null. Zwischengespeichert wird im Aufrufer (WebsiteImage, je Anfrage).
*/
public static function effectiveFor(mixed $path): ?self
{
if (! is_string($path) || $path === '') {
return null;
}
$alias = self::query()->with('element')->where('legacy_path', $path)->first();
return $alias instanceof self && $alias->everReleased() ? $alias : null;
}
public function everReleased(): bool
{
$element = $this->element;
if ($element === null) {
return false;
}
if ($element->website_released_at !== null) {
return true;
}
return IdentityChange::query()
->where('subject_type', $element->getMorphClass())
->where('subject_id', $element->id)
->where('field', 'website_released_at')
->whereNotNull('after')
->exists();
}
}
+19
View File
@@ -0,0 +1,19 @@
<?php
namespace App\Domain\Media;
/**
* Öffentliche Ableitung eines für die Website freigegebenen Mediums.
* Enthält keine internen Vermerke und keine Adresse einer Bestandsdatei.
*/
final class WebsitePresentation
{
public function __construct(
public readonly int $elementId,
public readonly string $title,
public readonly string $alt,
public readonly ?string $credit,
public readonly string $kind,
public readonly string $url,
) {}
}
+121
View File
@@ -0,0 +1,121 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Jobs\PublishWebsiteMedia;
use App\Models\User;
use Illuminate\Support\Facades\Storage;
/**
* Gibt eine Ableitung für die Website frei oder nimmt sie zurück.
* Legt keinen Lizenzartikel an und ruft DecideAccess nicht auf.
* Der Web-Prozess schreibt die öffentliche Datei nicht selbst; das tut die Warteschlange.
*/
class WebsiteRelease
{
public function release(ContentElement $element, ?User $actor = null): string
{
$refusal = $this->refusal($element);
if ($refusal !== null) {
return $refusal;
}
PublishWebsiteMedia::dispatch($element->id, 'release', $actor?->id);
return 'Für die Website freigegeben. Öffentliche Seiten lesen nur diese Ableitung.';
}
public function withdraw(ContentElement $element, ?User $actor = null): string
{
PublishWebsiteMedia::dispatch($element->id, 'withdraw', $actor?->id);
return 'Die Website-Freigabe ist zurückgenommen.';
}
public function refusal(ContentElement $element): ?string
{
if ($this->isConfidential($element)) {
return 'Traineranleitungen werden nicht für die Website freigegeben.';
}
if ($this->derivedPath($element) === null) {
return 'Für die Website fehlt eine freigebbare Ableitung. Beim Bild ist das das Vorschaubild, beim Film eine Teaserfassung unter teaser/. Die Originaldatei bleibt geschützt.';
}
return null;
}
public function derivedPath(ContentElement $element): ?string
{
if ($this->isConfidential($element)) {
return null;
}
if ($element->output_class === 'bild') {
return $this->allowedDerivedPath($element->thumbnail_path, 'vorschau/');
}
if ($element->output_class !== 'film') {
return null;
}
$version = $element->versions()
->where('status', ContentVersionStatus::Bereit->value)
->orderByDesc('number')
->first();
if ($version === null) {
return null;
}
$path = MediaRendition::query()
->where('content_element_version_id', $version->id)
->where('role', 'preview')
->orderByDesc('id')
->value('path');
return $this->allowedDerivedPath($path, 'teaser/');
}
public function publicPath(ContentElement $element, string $derivedPath): string
{
$extension = strtolower(pathinfo($derivedPath, PATHINFO_EXTENSION));
return 'website/'.$element->id.'/datei.'.$extension;
}
private function isConfidential(ContentElement $element): bool
{
$slug = $element->editorialContentKind?->slug;
if ($slug === null && $element->editorial_content_kind_id !== null) {
$slug = EditorialContentKind::query()->whereKey($element->editorial_content_kind_id)->value('slug');
}
return in_array($slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true);
}
private function allowedDerivedPath(mixed $path, string $prefix): ?string
{
if (! is_string($path) || ! str_starts_with($path, $prefix) || str_contains($path, '..')) {
return null;
}
$extension = strtolower(pathinfo($path, PATHINFO_EXTENSION));
if (! in_array($extension, ['jpg', 'jpeg', 'png', 'webp', 'gif', 'mp4', 'webm'], true)) {
return null;
}
if (! Storage::disk('media_derived')->exists($path)) {
return null;
}
return $path;
}
}
@@ -20,6 +20,7 @@
use App\Domain\Catalog\IdentityDimensionValue;
use App\Domain\Catalog\IdentityProfile;
use App\Domain\Catalog\StructureNode;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Filament\Resources\ContentElements\ContentElementResource;
use App\Filament\Support\EditorialCatalog;
use App\Filament\Support\MediumForm;
@@ -87,6 +88,8 @@ abstract class EditComposition extends EditRecord
public string $pickerKind = 'alle';
public string $pickerLayout = 'kacheln';
public string $pickerDimension = '';
public string $pickerSelected = '';
@@ -351,6 +354,7 @@ public function pickerDetail(): ?array
$row = app(EditorialCatalog::class)->rowForTarget(
$this->pickerSelected,
(int) $this->getRecord()->getKey(),
allowDraft: true,
);
if ($row === null) {
@@ -360,10 +364,13 @@ public function pickerDetail(): ?array
$row['playback'] = null;
if (preg_match('/^element:(\d+)$/', (string) $row['target'], $match) === 1) {
$version = ContentElementVersion::query()->with('element')->find($match[1]);
$version = ContentElementVersion::query()->with('element.editorialContentKind')->find($match[1]);
$row['playback'] = $version instanceof ContentElementVersion
? app(ContentPreviewController::class)->playback($version)
: null;
if ($version?->element !== null) {
$row['visibility'] = app(PublicMaterialReader::class)->visibilityNote($version->element);
}
}
return $row;
@@ -3,11 +3,18 @@
namespace App\Filament\Resources\ContentElements\Pages;
use App\Filament\Resources\ContentElements\ContentElementResource;
use App\Filament\Support\MediaLibrary;
use App\Filament\Support\MediumForm;
use App\Filament\Support\ReportsDomainRules;
use Filament\Actions\Action;
use Filament\Resources\Pages\ListRecords;
use Filament\Schemas\Components\RenderHook;
use Filament\Schemas\Components\View;
use Filament\Schemas\Schema;
use Filament\Support\Enums\Width;
use Filament\View\PanelsRenderHook;
use Illuminate\Contracts\Support\Htmlable;
use Livewire\Attributes\Url;
class ListContentElements extends ListRecords
{
@@ -15,9 +22,141 @@ class ListContentElements extends ListRecords
protected static string $resource = ContentElementResource::class;
#[Url(as: 'suche', except: '')]
public string $suche = '';
#[Url(as: 'ansicht', except: 'kacheln')]
public string $ansicht = 'kacheln';
#[Url(as: 'art', except: '')]
public string $art = '';
#[Url(as: 'freigabe', except: '')]
public string $freigabe = '';
#[Url(as: 'entwurf', except: '')]
public string $entwurf = '';
#[Url(as: 'fassung', except: '')]
public string $fassung = '';
#[Url(as: 'nutzung', except: '')]
public string $nutzung = '';
#[Url(as: 'saeule', except: '')]
public string $saeule = '';
#[Url(as: 'einordnung', except: '')]
public string $einordnung = '';
#[Url(as: 'verarbeitung', except: '')]
public string $verarbeitung = '';
#[Url(as: 'archiv', except: 'aktiv')]
public string $archiv = 'aktiv';
public function getSubheading(): string|Htmlable|null
{
return 'Die Dateien und Texte. Eine Übung, ein Kurs oder eine fachliche Kombination verweist darauf; die Datei wird nicht für jede Verwendung neu hochgeladen.';
return 'Die Dateien und Texte. Ein Modul oder ein Programm verweist auf eine Fassung; die Datei wird nicht für jede Verwendung neu hochgeladen.';
}
public function getMaxContentWidth(): Width|string|null
{
return Width::Full;
}
public function content(Schema $schema): Schema
{
return $schema->components([
$this->getTabsContentComponent(),
RenderHook::make(PanelsRenderHook::RESOURCE_PAGES_LIST_RECORDS_TABLE_BEFORE),
View::make('filament.media.library'),
RenderHook::make(PanelsRenderHook::RESOURCE_PAGES_LIST_RECORDS_TABLE_AFTER),
]);
}
public function showingList(): bool
{
return $this->ansicht === 'liste';
}
/**
* @return list<array<string, mixed>>
*/
public function cards(): array
{
return app(MediaLibrary::class)->cards($this->libraryFilters(), ContentElementResource::editor());
}
/**
* @return list<array{value: string, label: string}>
*/
public function typeOptions(): array
{
return app(MediaLibrary::class)->types();
}
/**
* @return list<array{id: int, name: string}>
*/
public function pillarOptions(): array
{
return app(MediaLibrary::class)->pillars();
}
/**
* @return list<array{id: int, label: string}>
*/
public function classificationOptions(): array
{
return app(MediaLibrary::class)->classifications();
}
public function filtersActive(): bool
{
return trim($this->suche) !== ''
|| $this->art !== ''
|| $this->freigabe !== ''
|| $this->entwurf !== ''
|| $this->fassung !== ''
|| $this->nutzung !== ''
|| $this->saeule !== ''
|| $this->einordnung !== ''
|| $this->verarbeitung !== ''
|| $this->archiv !== 'aktiv';
}
public function resetFilters(): void
{
$this->suche = '';
$this->art = '';
$this->freigabe = '';
$this->entwurf = '';
$this->fassung = '';
$this->nutzung = '';
$this->saeule = '';
$this->einordnung = '';
$this->verarbeitung = '';
$this->archiv = 'aktiv';
}
/**
* @return array<string, string>
*/
private function libraryFilters(): array
{
return [
'suche' => $this->suche,
'art' => $this->art,
'freigabe' => $this->freigabe,
'entwurf' => $this->entwurf,
'fassung' => $this->fassung,
'nutzung' => $this->nutzung,
'saeule' => $this->saeule,
'einordnung' => $this->einordnung,
'verarbeitung' => $this->verarbeitung,
'archiv' => $this->archiv,
];
}
protected function getHeaderActions(): array
@@ -6,23 +6,32 @@
use App\Domain\Catalog\ContentElementVersion;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\EditorialDimensionValue;
use App\Domain\Catalog\IdentityChange;
use App\Domain\Catalog\IdentityDimension;
use App\Domain\Catalog\IdentityDimensionValue;
use App\Domain\Catalog\IdentityProfile;
use App\Domain\Catalog\Pillar;
use App\Domain\Catalog\PillarService;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\WebsiteImageUsage;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Media\ThumbnailRef;
use App\Domain\Media\WebsiteMedia;
use App\Domain\Media\WebsiteRelease;
use App\Filament\Resources\ContentElements\ContentElementResource;
use App\Filament\Support\CatalogReading;
use App\Filament\Support\EditorialCatalog;
use App\Filament\Support\ElementRevision;
use App\Filament\Support\MediaLibrary;
use App\Filament\Support\ReportsDomainRules;
use App\Http\Controllers\ContentPreviewController;
use App\Jobs\DeriveThumbnail;
use Filament\Actions\Action;
use Filament\Forms\Components\CheckboxList;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Resources\Pages\ViewRecord;
use Filament\Schemas\Components\View;
use Filament\Schemas\Schema;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Collection;
use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
@@ -47,6 +56,48 @@ class ViewContentElement extends ViewRecord
public mixed $previewUpload = null;
public string $bereich = 'inhalt';
public string $workingTitle = '';
public string $displayTitle = '';
public string $summary = '';
public string $descriptionText = '';
public string $usageNote = '';
public string $licenseNote = '';
public string $websiteCredit = '';
public string $websiteAlt = '';
public string $websiteFeedback = '';
public int|string|null $kindId = null;
/** @var list<int|string> */
public array $pillarIds = [];
/** @var list<int|string> */
public array $dimensionIds = [];
public string $editorialFeedback = '';
public string $previewWidth = '640';
public string $previewSurface = 'website';
public string $pickerQuery = '';
public string $pickerContext = 'modul';
public string $pickerLayout = 'kacheln';
public string $pickerSelected = '';
public function mount(int|string $record): void
{
parent::mount($record);
@@ -57,13 +108,28 @@ public function mount(int|string $record): void
$this->fassung = $requested;
}
$bereich = (string) request()->query('bereich', 'beschreibung');
$this->bereich = in_array($bereich, ['beschreibung', 'inhalt', 'fassungen', 'verwendung', 'vorschau'], true)
? $bereich
: 'beschreibung';
$this->thumbnailAlt = (string) ($this->getRecord()->thumbnail_alt ?? '');
$this->fillEditorial();
$this->syncBodyDraft();
}
public function getHeading(): string|Htmlable
{
return (string) $this->getRecord()->working_title;
}
public function getSubheading(): string|Htmlable|null
{
return 'Jede Fassung hat eine eigene Nummer und bleibt einsehbar. Beschreibung, Arbeitstitel und Säulen gehören zum Medium und ändern keine Fassung. Eine deaktivierte Fassung wird nicht mehr ausgeliefert und lässt sich nicht neu einbauen.';
return 'Texte und Vorschaubild ändern keine Fassung. Eine neue Datei oder ein geänderter Lehrtext braucht eine neue Fassung.';
}
public function getMaxContentWidth(): Width|string|null
{
return Width::Full;
}
public function infolist(Schema $schema): Schema
@@ -242,40 +308,6 @@ public function deactivateAction(): Action
protected function getHeaderActions(): array
{
return [
Action::make('describe')
->label('Beschreibung ändern')
->visible(fn (): bool => ContentElementResource::editor())
->fillForm(fn (): array => [
'working_title' => $this->getRecord()->working_title,
'description' => $this->getRecord()->description,
'usage_note' => $this->getRecord()->usage_note,
'license_note' => $this->getRecord()->license_note,
'pillars' => $this->getRecord()->pillars()->pluck('pillars.id')->all(),
])
->schema([
TextInput::make('working_title')->label('Arbeitstitel')->required(),
Textarea::make('description')->label('Beschreibung')->rows(4)
->helperText('Gilt für das Medium. Speichern legt keine neue Fassung an.'),
Textarea::make('usage_note')->label('Hinweise für den Einsatz')->rows(4),
Textarea::make('license_note')->label('Interner Lizenzvermerk')->rows(3)
->helperText('Nur in der Verwaltung. Nicht in der Bibliothek und nicht auf der Website.'),
CheckboxList::make('pillars')
->label('Fachliche Säulen')
->options(fn (): array => Pillar::query()->orderBy('name')->pluck('name', 'id')->all()),
])
->action(function (array $data): void {
$this->report(function () use ($data): void {
/** @var ContentElement $element */
$element = $this->getRecord();
app(ContentService::class)->describe($element, (string) $data['working_title'], $data['description'] ?? null);
app(IdentityProfile::class)->fill($element, [
'usage_note' => $data['usage_note'] ?? null,
'license_note' => $data['license_note'] ?? null,
], auth()->user());
app(PillarService::class)->assign($element, array_map(intval(...), $data['pillars'] ?? []));
}, 'Die Beschreibung ist gespeichert.');
$this->getRecord()->refresh();
}),
Action::make('releaseVersion')
->label('Fassung freigeben')
->modalHeading('Fassung freigeben')
@@ -395,6 +427,7 @@ private function pictureCaption(ContentElement $element): string
return match ($source) {
'eigen' => 'Eigenes Vorschaubild.',
'datei' => 'Vorschaubild aus der Datei des Mediums.',
'bestand' => 'Vorschaubild aus einem Bild im Bestand. Es ist damit nicht für die Website freigegeben.',
default => '',
};
}
@@ -406,4 +439,289 @@ private function ownedVersion(int $id): ?ContentElementVersion
return $element->versions()->whereKey($id)->first();
}
public function saveEditorial(): void
{
abort_unless(ContentElementResource::editor(), 403);
/** @var ContentElement $element */
$element = $this->getRecord();
$title = trim($this->workingTitle);
if ($title === '') {
$this->editorialFeedback = 'Der Arbeitstitel fehlt.';
return;
}
$versions = $element->versions()->count();
app(IdentityProfile::class)->fill($element, [
'working_title' => $title,
'display_title' => $this->displayTitle,
'summary' => $this->summary,
'description' => $this->descriptionText,
'usage_note' => $this->usageNote,
'license_note' => $this->licenseNote,
'website_credit' => $this->websiteCredit,
'website_alt' => $this->websiteAlt,
'thumbnail_alt' => $this->thumbnailAlt,
'editorial_content_kind_id' => filled($this->kindId) ? (int) $this->kindId : null,
], auth()->user());
app(PillarService::class)->assign($element, array_map(intval(...), $this->pillarIds));
$ids = array_map(intval(...), $this->dimensionIds);
IdentityDimensionValue::query()
->where('subject_type', $element->getMorphClass())
->where('subject_id', $element->id)
->where('origin', 'direkt')
->whereNotIn('editorial_dimension_value_id', $ids === [] ? [0] : $ids)
->delete();
foreach (EditorialDimensionValue::query()->whereIn('id', $ids)->get() as $value) {
app(IdentityDimension::class)->assign($element, $value, 'direkt');
}
$element->refresh();
$this->fillEditorial();
$this->editorialFeedback = $element->versions()->count() === $versions
? 'Gespeichert. Es gibt keine neue Fassung.'
: 'Gespeichert. Prüfe die Fassungen, ihre Zahl hat sich geändert.';
}
public function releaseForWebsite(): void
{
abort_unless(ContentElementResource::editor(), 403);
/** @var ContentElement $element */
$element = $this->getRecord();
app(IdentityProfile::class)->fill($element, [
'website_credit' => $this->websiteCredit,
'website_alt' => $this->websiteAlt,
], auth()->user());
$element->refresh();
$this->websiteFeedback = app(WebsiteRelease::class)->release($element, auth()->user());
$element->refresh();
$this->fillEditorial();
}
public function withdrawWebsite(): void
{
abort_unless(ContentElementResource::editor(), 403);
/** @var ContentElement $element */
$element = $this->getRecord();
$this->websiteFeedback = app(WebsiteRelease::class)->withdraw($element, auth()->user());
$element->refresh();
$this->fillEditorial();
}
/**
* Website-Seiten, die dieses Medium als Bild verwenden (CMS-Widgets und Abschnittshintergründe).
*
* @return list<array{path: string, published: bool, draft: bool}>
*/
public function websitePages(): array
{
/** @var ContentElement $element */
$element = $this->getRecord();
return app(WebsiteImageUsage::class)->pages($element);
}
public function websiteIsPublic(): bool
{
/** @var ContentElement $element */
$element = $this->getRecord();
return app(WebsiteMedia::class)->present($element->fresh()) !== null;
}
public function adoptLibraryImage(): void
{
abort_unless(ContentElementResource::editor(), 403);
/** @var ContentElement $element */
$element = $this->getRecord();
$detail = $this->selectionDetail();
$sourceId = (int) ($detail['element_id'] ?? 0);
$source = $sourceId > 0 ? ContentElement::query()->find($sourceId) : null;
$path = $source?->thumbnail_path;
if (! $source instanceof ContentElement || $source->output_class !== 'bild' || ! is_string($path) || ! str_starts_with($path, 'vorschau/') || str_contains($path, '..')) {
$this->pictureFeedback = 'Dieses Bild hat noch kein übernehmbares Vorschaubild.';
return;
}
$versions = $element->versions()->count();
app(IdentityProfile::class)->fill($element, [
'thumbnail_path' => $path,
'thumbnail_alt' => filled($source->thumbnail_alt) ? $source->thumbnail_alt : $source->working_title,
'thumbnail_source' => 'bestand',
'thumbnail_error' => null,
], auth()->user());
$element->refresh();
$this->thumbnailAlt = (string) ($element->thumbnail_alt ?? '');
$this->pictureFeedback = $element->versions()->count() === $versions
? 'Vorschaubild übernommen. Es gibt keine neue Fassung. Für die Website ist es damit nicht freigegeben.'
: 'Vorschaubild übernommen. Prüfe die Fassungen.';
}
/**
* @return array{items: list<array<string, mixed>>, more: bool}
*/
public function selection(): array
{
return app(EditorialCatalog::class)->browse(
$this->pickerQuery,
$this->pickerContext === 'bild' ? 'bild' : 'alle',
'',
0,
elementsOnly: $this->pickerContext !== 'modul',
);
}
/**
* @return array<string, mixed>|null
*/
public function selectionDetail(): ?array
{
if ($this->pickerSelected === '') {
return null;
}
$row = app(EditorialCatalog::class)->rowForTarget($this->pickerSelected, 0, allowDraft: true);
if ($row === null || ! isset($row['element_id'])) {
return $row;
}
$element = ContentElement::query()->with('editorialContentKind')->find((int) $row['element_id']);
if ($element instanceof ContentElement) {
$row['visibility'] = app(PublicMaterialReader::class)->visibilityNote($element);
}
return $row;
}
public function previewHtml(): string
{
/** @var ContentElement $element */
$element = $this->getRecord();
$draft = [
'working_title' => $this->workingTitle,
'display_title' => $this->displayTitle,
'summary' => $this->summary,
'thumbnail_alt' => $this->thumbnailAlt,
];
if ($this->previewSurface === 'bibliothek') {
$title = trim($this->displayTitle) !== '' ? trim($this->displayTitle) : trim($this->workingTitle);
return view('member.partials.card', [
'href' => '#vorschau',
'card' => [
'title' => $title !== '' ? $title : $element->working_title,
'summary' => trim($this->summary) !== '' ? trim($this->summary) : null,
'kind' => PublicMaterialReader::outputLabel((string) $element->output_class),
'coverage' => 'offen',
'image' => trim($this->thumbnailAlt) !== '' ? trim($this->thumbnailAlt) : $title,
'image_url' => ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path),
'error' => 'Vorschau der Kartenform. Ob jemand sie öffnen darf, entscheidet die Lizenz.',
],
])->render();
}
$subject = app(PublicMaterialReader::class)->subject($element->id, true, $draft);
if ($subject === null) {
return '<p class="preview-note">Für dieses Medium liegt noch keine anzeigbare Fassung vor. Die Karte erscheint deshalb auch in der Vorschau nicht.</p>';
}
return view('widgets.premium_card', [
'subject' => $subject,
'context' => RenderContext::preview(),
'cardStyle' => $subject->style ?? 'media',
'imageUrl' => null,
'alt' => '',
'focus' => ['x' => 50, 'y' => 45],
'format' => 'landscape',
'fit' => 'cover',
'headingTag' => 'h3',
'show' => ['summary' => true, 'kind' => true, 'meta' => true, 'action' => true],
'actionLabel' => 'Ansehen',
'note' => null,
'stacked' => $this->previewWidth === '390',
])->render();
}
/**
* @return list<array{field: string, after: string, when: string}>
*/
public function editorialHistory(): array
{
/** @var ContentElement $element */
$element = $this->getRecord();
$labels = [
'working_title' => 'Arbeitstitel',
'display_title' => 'Anzeigename',
'description' => 'Beschreibung',
'summary' => 'Kurzbeschreibung',
'usage_note' => 'Einsatzhinweis',
'license_note' => 'Interner Lizenzvermerk',
'website_credit' => 'Quellenzeile',
'website_alt' => 'Alternativtext der Website',
'website_released_at' => 'Website-Freigabe',
'thumbnail_alt' => 'Alternativtext',
'thumbnail_path' => 'Vorschaubild',
'thumbnail_source' => 'Herkunft des Vorschaubilds',
'editorial_content_kind_id' => 'Inhaltsart',
];
return IdentityChange::query()
->where('subject_type', $element->getMorphClass())
->where('subject_id', $element->id)
->latest('occurred_at')
->limit(8)
->get()
->map(fn (IdentityChange $change): array => [
'field' => $labels[$change->field] ?? $change->field,
'after' => is_scalar($change->after) ? (string) $change->after : '',
'when' => $change->occurred_at?->timezone(config('app.timezone'))->format('d.m.Y H:i') ?? '',
])
->all();
}
/**
* @return array<string, mixed>
*/
public function usageCard(): array
{
/** @var ContentElement $element */
$element = $this->getRecord();
return app(MediaLibrary::class)->cardFor($element, ContentElementResource::editor());
}
private function fillEditorial(): void
{
/** @var ContentElement $element */
$element = $this->getRecord();
$this->workingTitle = (string) $element->working_title;
$this->displayTitle = (string) ($element->display_title ?? '');
$this->summary = (string) ($element->summary ?? '');
$this->descriptionText = (string) ($element->description ?? '');
$this->usageNote = (string) ($element->usage_note ?? '');
$this->licenseNote = (string) ($element->license_note ?? '');
$this->websiteCredit = (string) ($element->website_credit ?? '');
$this->websiteAlt = (string) ($element->website_alt ?? '');
$this->kindId = $element->editorial_content_kind_id;
$this->pillarIds = $element->pillars()->pluck('pillars.id')->all();
$this->dimensionIds = IdentityDimensionValue::query()
->where('subject_type', $element->getMorphClass())
->where('subject_id', $element->id)
->where('origin', 'direkt')
->pluck('editorial_dimension_value_id')
->all();
}
}
@@ -75,13 +75,20 @@ public static function form(Schema $schema): Schema
public static function table(Table $table): Table
{
return $table
// Zuletzt bearbeitete Seiten zuerst; jede Seite ist ohne Suche auffindbar (Spalten sortierbar, bis 100 je Seite).
->columns([
TextColumn::make('path')->label('Pfad')->searchable(),
TextColumn::make('path')->label('Pfad')->searchable()->sortable(),
TextColumn::make('published_revision_id')
->label('Veröffentlicht')
->formatStateUsing(fn ($state): string => $state ? 'Ja' : 'Entwurf'),
TextColumn::make('updated_at')->label('Geändert')->dateTime('d.m.Y H:i'),
TextColumn::make('updated_at')
->label('Zuletzt bearbeitet')
->dateTime('d.m.Y H:i', timezone: 'Europe/Berlin')
->sortable(),
])
->defaultSort('updated_at', 'desc')
->paginated([25, 50, 100])
->defaultPaginationPageOption(25)
->recordUrl(fn (Page $record): string => static::getUrl('edit', ['record' => $record]))
->recordActions([
Action::make('duplicate')
+44 -3
View File
@@ -16,7 +16,9 @@
use App\Domain\Catalog\IdentityDimensionValue;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\OfferStatus;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Filament\Resources\Combinations\CombinationResource;
use App\Filament\Resources\ContentElements\ContentElementResource;
use App\Filament\Resources\Courses\CourseResource;
use App\Filament\Resources\Exercises\ExerciseResource;
use Illuminate\Database\Eloquent\Builder;
@@ -111,7 +113,7 @@ public function rowForTarget(string $target, int $exceptCompositionId, bool $all
'identity' => 'medium:'.$element->id,
'open_url' => route('content.preview', $version),
'open_label' => 'Medium ansehen',
'edit_url' => null,
'edit_url' => ContentElementResource::getUrl('view', ['record' => $element]),
];
}
@@ -262,7 +264,7 @@ public function search(string $query, string $scope, int $exceptCompositionId):
/**
* @return array{items: list<array<string, string|null>>, more: bool}
*/
public function browse(string $query, string $kind, string $dimension, int $exceptCompositionId): array
public function browse(string $query, string $kind, string $dimension, int $exceptCompositionId, bool $elementsOnly = false): array
{
$query = trim($query);
$like = '%'.str_replace(['%', '_'], ['', ''], $query).'%';
@@ -294,7 +296,7 @@ public function browse(string $query, string $kind, string $dimension, int $exce
}
}
if (in_array($kind, ['alle', 'modul'], true)) {
if (! $elementsOnly && in_array($kind, ['alle', 'modul'], true)) {
$latestCompositions = CompositionVersion::query()
->selectRaw('MAX(id)')
->where('status', ContentVersionStatus::Bereit)
@@ -372,6 +374,8 @@ public function browse(string $query, string $kind, string $dimension, int $exce
}
}
$rows = $this->withVisibility($rows);
return [
'items' => array_slice($rows, 0, $limit),
'more' => count($rows) > $limit,
@@ -400,6 +404,42 @@ public function cardUrl(string $kind, int $id, ?string $path): ?string
return route('editorial.card', ['kind' => $kind, 'subject' => $id]);
}
/**
* @param list<array<string, mixed>> $rows
* @return list<array<string, mixed>>
*/
private function withVisibility(array $rows): array
{
$ids = [];
foreach ($rows as $row) {
if (isset($row['element_id'])) {
$ids[] = (int) $row['element_id'];
}
}
if ($ids === []) {
return $rows;
}
$reader = app(PublicMaterialReader::class);
$elements = ContentElement::query()
->with('editorialContentKind')
->whereIn('id', array_values(array_unique($ids)))
->get()
->keyBy('id');
foreach ($rows as $index => $row) {
$element = $elements->get((int) ($row['element_id'] ?? 0));
if ($element instanceof ContentElement) {
$rows[$index]['visibility'] = $reader->visibilityNote($element);
}
}
return $rows;
}
/**
* @param Builder<ContentElement> $builder
*/
@@ -408,6 +448,7 @@ private function constrainElement($builder, string $query, string $like, string
$outputs = match ($kind) {
'film' => ['film'],
'text' => ['text'],
'bild' => ['bild'],
'dokument' => ['pdf', 'document'],
default => null,
};
+570
View File
@@ -0,0 +1,570 @@
<?php
namespace App\Filament\Support;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionKind;
use App\Domain\Catalog\CompositionMember;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentElementVersion;
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\EditorialDimension;
use App\Domain\Catalog\IdentityDimensionValue;
use App\Domain\Catalog\Pillar;
use App\Domain\Catalog\ReleaseContent;
use App\Domain\Media\ThumbnailRef;
use App\Filament\Resources\ContentElements\ContentElementResource;
use Illuminate\Support\Collection;
use Illuminate\Support\Str;
class MediaLibrary
{
public function __construct(private readonly EditorialCatalog $catalog) {}
/**
* @return list<array{value: string, label: string}>
*/
public function types(): array
{
return [
['value' => 'film', 'label' => 'Film'],
['value' => 'text', 'label' => 'Text'],
['value' => 'document', 'label' => 'Dokument'],
['value' => 'bild', 'label' => 'Bild'],
['value' => 'audio', 'label' => 'Hörstück'],
];
}
/**
* @return list<array{id: int, name: string}>
*/
public function pillars(): array
{
return Pillar::query()
->orderBy('name')
->get(['id', 'name'])
->map(fn (Pillar $pillar): array => ['id' => $pillar->id, 'name' => $pillar->name])
->all();
}
/**
* @return list<array{id: int, label: string}>
*/
public function classifications(): array
{
$options = [];
foreach (EditorialDimension::query()->with('values')->orderBy('label')->get() as $dimension) {
foreach ($dimension->values->sortBy('label') as $value) {
$options[] = [
'id' => $value->id,
'label' => $dimension->label.': '.$value->label,
];
}
}
return $options;
}
/**
* @param array<string, string> $filters
* @return list<array<string, mixed>>
*/
/**
* @return array<string, mixed>
*/
public function cardFor(ContentElement $element, bool $canEdit): array
{
$element->loadMissing(['versions', 'pillars']);
$versionIds = $element->versions->pluck('id')->all();
return $this->card(
$element,
$this->portrait($element),
$this->placements($versionIds)[$element->id] ?? [],
$this->licenses($versionIds)[$element->id] ?? [],
$canEdit,
);
}
/**
* @param array<string, string> $filters
* @return list<array<string, mixed>>
*/
public function cards(array $filters, bool $canEdit): array
{
$filters = $this->normalize($filters);
$elements = ContentElement::query()
->with(['versions', 'pillars'])
->orderBy('working_title')
->get();
$versionIds = $elements->flatMap(fn (ContentElement $element) => $element->versions->pluck('id'))->all();
$placements = $this->placements($versionIds);
$licenses = $this->licenses($versionIds);
$classified = $this->classifiedIds();
$needle = mb_strtolower($filters['suche']);
$cards = [];
foreach ($elements as $element) {
$portrait = $this->portrait($element);
$uses = $placements[$element->id] ?? [];
$codes = $licenses[$element->id] ?? [];
if (! $this->matches($element, $portrait, $uses, $filters, $needle, $classified)) {
continue;
}
$cards[] = $this->card($element, $portrait, $uses, $codes, $canEdit);
}
usort($cards, fn (array $left, array $right): int => strcasecmp(
mb_strtolower($left['title']),
mb_strtolower($right['title']),
));
return $cards;
}
/**
* @param array<string, string> $filters
* @return array<string, string>
*/
private function normalize(array $filters): array
{
return [
'suche' => trim($filters['suche'] ?? ''),
'art' => $this->choice($filters['art'] ?? '', ['film', 'text', 'document', 'bild', 'audio']),
'freigabe' => $this->choice($filters['freigabe'] ?? '', ['freigegeben', 'entwurf', 'ohne']),
'entwurf' => $this->choice($filters['entwurf'] ?? '', ['offen', 'keiner']),
'fassung' => $this->choice($filters['fassung'] ?? '', ['mit', 'nur']),
'nutzung' => $this->choice($filters['nutzung'] ?? '', ['verwendet', 'unbenutzt']),
'saeule' => ctype_digit($filters['saeule'] ?? '') ? $filters['saeule'] : '',
'einordnung' => ctype_digit($filters['einordnung'] ?? '') ? $filters['einordnung'] : '',
'verarbeitung' => $this->choice($filters['verarbeitung'] ?? '', ['fehler', 'uebernahme']),
'archiv' => $this->choice($filters['archiv'] ?? '', ['aktiv', 'archiviert', 'alle'], 'aktiv'),
];
}
/**
* @param list<string> $allowed
*/
private function choice(string $value, array $allowed, string $fallback = ''): string
{
return in_array($value, $allowed, true) ? $value : $fallback;
}
/**
* @param list<int> $versionIds
* @return array<int, list<array<string, mixed>>>
*/
private function placements(array $versionIds): array
{
if ($versionIds === []) {
return [];
}
$grouped = [];
$members = CompositionMember::query()
->whereIn('content_element_version_id', $versionIds)
->with(['compositionVersion.composition', 'contentElementVersion'])
->orderBy('id')
->get();
foreach ($members as $member) {
$version = $member->contentElementVersion;
$compositionVersion = $member->compositionVersion;
$composition = $compositionVersion?->composition;
if (! $version instanceof ContentElementVersion || $compositionVersion === null || ! $composition instanceof Composition) {
continue;
}
$elementId = $version->content_element_id;
$key = $composition->id.'-'.$compositionVersion->id.'-'.$version->id;
$role = trim((string) $member->role);
if (! isset($grouped[$elementId][$key])) {
$grouped[$elementId][$key] = [
'compositionId' => $composition->id,
'name' => $this->catalog->compositionTitle($composition),
'type' => $this->kindLabel($composition),
'mediumVersion' => $this->versionLabel($version),
'hostVersion' => 'Fassung '.$compositionVersion->number,
'url' => EditorialCatalog::editUrl($composition),
'roles' => [],
];
}
if ($role !== '' && ! in_array($role, $grouped[$elementId][$key]['roles'], true)) {
$grouped[$elementId][$key]['roles'][] = $role;
}
}
$placements = [];
foreach ($grouped as $elementId => $rows) {
$list = array_values($rows);
usort($list, fn (array $left, array $right): int => [$left['type'], $left['name'], $left['hostVersion']]
<=> [$right['type'], $right['name'], $right['hostVersion']]);
$placements[$elementId] = $list;
}
return $placements;
}
/**
* @param list<int> $versionIds
* @return array<int, list<string>>
*/
private function licenses(array $versionIds): array
{
if ($versionIds === []) {
return [];
}
$codes = [];
$contents = ReleaseContent::query()
->whereIn('content_element_version_id', $versionIds)
->with(['release.article', 'elementVersion'])
->orderBy('id')
->get();
foreach ($contents as $content) {
$version = $content->elementVersion;
$code = $content->release?->article?->code;
if (! $version instanceof ContentElementVersion || ! is_string($code) || $code === '') {
continue;
}
$codes[$version->content_element_id][$code] = $code;
}
return array_map(fn (array $row): array => array_values($row), $codes);
}
/**
* @return array<int, list<int>>
*/
private function classifiedIds(): array
{
$map = [];
$rows = IdentityDimensionValue::query()
->where('subject_type', (new ContentElement)->getMorphClass())
->where('origin', 'direkt')
->get(['subject_id', 'editorial_dimension_value_id']);
foreach ($rows as $row) {
$map[(int) $row->subject_id][] = (int) $row->editorial_dimension_value_id;
}
return $map;
}
/**
* @return array{
* ready: ?ContentElementVersion,
* draft: ?ContentElementVersion,
* blocked: ?ContentElementVersion,
* versionCount: int,
* archived: bool,
* processing: ?string,
* stand: string,
* standTone: string,
* draftNote: ?string,
* blockedNote: ?string
* }
*/
private function portrait(ContentElement $element): array
{
/** @var Collection<int, ContentElementVersion> $versions */
$versions = $element->versions->sortByDesc('number')->values();
$ready = $versions->first(fn (ContentElementVersion $version): bool => $version->status === ContentVersionStatus::Bereit);
$draft = $versions->first(fn (ContentElementVersion $version): bool => $version->status === ContentVersionStatus::Entwurf);
$blocked = $versions->first(fn (ContentElementVersion $version): bool => $version->status === ContentVersionStatus::Gesperrt);
$processing = $this->processing($versions);
if ($ready instanceof ContentElementVersion) {
$stand = 'Fassung '.$ready->number.' freigegeben';
$tone = 'ready';
} elseif ($draft instanceof ContentElementVersion) {
$stand = 'Entwurf, noch nicht freigegeben';
$tone = 'draft';
} elseif ($blocked instanceof ContentElementVersion) {
$stand = 'Fassung '.$blocked->number.' deaktiviert';
$tone = 'blocked';
} else {
$stand = 'Noch keine Fassung';
$tone = 'quiet';
}
return [
'ready' => $ready instanceof ContentElementVersion ? $ready : null,
'draft' => $draft instanceof ContentElementVersion ? $draft : null,
'blocked' => $blocked instanceof ContentElementVersion ? $blocked : null,
'versionCount' => $versions->count(),
'archived' => $element->archived_at !== null,
'processing' => $processing,
'stand' => $stand,
'standTone' => $tone,
'draftNote' => $ready instanceof ContentElementVersion && $draft instanceof ContentElementVersion
? 'Entwurf offen'
: null,
'blockedNote' => $blocked instanceof ContentElementVersion && ($ready instanceof ContentElementVersion || $draft instanceof ContentElementVersion)
? 'Fassung '.$blocked->number.' deaktiviert'
: null,
];
}
/**
* @param Collection<int, ContentElementVersion> $versions
*/
private function processing(Collection $versions): ?string
{
foreach ($versions as $version) {
$meta = is_array($version->metadata) ? $version->metadata : [];
if (is_string($meta['error'] ?? null) && trim($meta['error']) !== '') {
return 'Verarbeitungsfehler';
}
}
foreach ($versions as $version) {
$meta = is_array($version->metadata) ? $version->metadata : [];
$incoming = $meta['incoming'] ?? null;
$hasIncoming = (is_string($incoming) && $incoming !== '') || (is_array($incoming) && $incoming !== []);
if ($hasIncoming && ! is_string($meta['file'] ?? null)) {
return 'Datei wird übernommen';
}
}
return null;
}
/**
* @param array<string, mixed> $portrait
* @param list<array<string, mixed>> $uses
* @param array<string, string> $filters
* @param array<int, list<int>> $classified
*/
private function matches(ContentElement $element, array $portrait, array $uses, array $filters, string $needle, array $classified): bool
{
if ($needle !== '' && ! str_contains($this->haystack($element), $needle)) {
return false;
}
if (! $this->matchesArt($element, $filters['art'])) {
return false;
}
$onlyBlocked = $portrait['ready'] === null && $portrait['draft'] === null && $portrait['blocked'] !== null;
if ($onlyBlocked && $filters['fassung'] === '' && $filters['archiv'] === 'aktiv') {
return false;
}
if ($filters['archiv'] === 'aktiv' && $portrait['archived']) {
return false;
}
if ($filters['archiv'] === 'archiviert' && ! $portrait['archived']) {
return false;
}
if ($filters['freigabe'] === 'freigegeben' && $portrait['ready'] === null) {
return false;
}
if ($filters['freigabe'] === 'entwurf' && ($portrait['draft'] === null || $portrait['ready'] !== null)) {
return false;
}
if ($filters['freigabe'] === 'ohne' && $portrait['ready'] !== null) {
return false;
}
if ($filters['entwurf'] === 'offen' && $portrait['draft'] === null) {
return false;
}
if ($filters['entwurf'] === 'keiner' && $portrait['draft'] !== null) {
return false;
}
if ($filters['fassung'] === 'mit' && $portrait['blocked'] === null) {
return false;
}
if ($filters['fassung'] === 'nur' && ($portrait['blocked'] === null || $portrait['ready'] !== null || $portrait['draft'] !== null)) {
return false;
}
$used = $this->usageCount($uses) > 0;
if ($filters['nutzung'] === 'verwendet' && ! $used) {
return false;
}
if ($filters['nutzung'] === 'unbenutzt' && $used) {
return false;
}
if ($filters['saeule'] !== '' && ! $element->pillars->contains('id', (int) $filters['saeule'])) {
return false;
}
if ($filters['einordnung'] !== '' && ! in_array((int) $filters['einordnung'], $classified[$element->id] ?? [], true)) {
return false;
}
if ($filters['verarbeitung'] === 'fehler' && $portrait['processing'] !== 'Verarbeitungsfehler') {
return false;
}
if ($filters['verarbeitung'] === 'uebernahme' && $portrait['processing'] !== 'Datei wird übernommen') {
return false;
}
return true;
}
private function matchesArt(ContentElement $element, string $art): bool
{
if ($art === '') {
return true;
}
$class = (string) $element->output_class;
if ($art === 'document') {
return in_array($class, ['document', 'pdf'], true);
}
return $class === $art;
}
private function haystack(ContentElement $element): string
{
return mb_strtolower(implode("\n", array_filter([
$element->working_title,
$element->display_title,
$element->description,
$element->summary,
$element->usage_note,
], fn (mixed $value): bool => is_string($value) && trim($value) !== '')));
}
/**
* @param array<string, mixed> $portrait
* @param list<array<string, mixed>> $uses
* @param list<string> $codes
* @return array<string, mixed>
*/
private function card(ContentElement $element, array $portrait, array $uses, array $codes, bool $canEdit): array
{
$description = trim((string) ($element->description ?: $element->summary ?: ''));
$usageNote = trim((string) $element->usage_note);
$licenseNote = trim((string) $element->license_note);
$typeKey = $this->typeKey((string) $element->output_class);
$count = $this->usageCount($uses);
return [
'id' => $element->id,
'title' => $element->working_title,
'type' => $this->catalog->outputLabel((string) $element->output_class),
'typeKey' => $typeKey,
'description' => $description === '' ? null : $description,
'usageNote' => $usageNote === '' ? null : $usageNote,
'licenseNote' => $licenseNote === '' ? null : $licenseNote,
'image' => ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path),
'imageAlt' => trim((string) ($element->thumbnail_alt ?: $element->working_title)),
'imageNote' => $this->imageNote($element),
'stand' => $portrait['stand'],
'standTone' => $portrait['standTone'],
'draftNote' => $portrait['draftNote'],
'blockedNote' => $portrait['blockedNote'],
'processing' => $portrait['processing'],
'archived' => $portrait['archived'],
'versionCount' => $portrait['versionCount'],
'versionLabel' => $this->versionCountLabel($portrait['versionCount']),
'usageCount' => $count,
'usageLabel' => $count === 0
? 'In keinem Modul oder Programm verwendet'
: ($count === 1 ? '1 Verwendung' : $count.' Verwendungen'),
'usages' => $uses,
'licenseText' => $this->licenseText($codes),
'url' => ContentElementResource::getUrl('view', ['record' => $element]),
'editUrl' => $canEdit ? ContentElementResource::getUrl('edit', ['record' => $element]) : null,
];
}
/**
* @param list<array<string, mixed>> $uses
*/
private function usageCount(array $uses): int
{
return count(array_unique(array_column($uses, 'compositionId')));
}
private function versionCountLabel(int $count): ?string
{
return match ($count) {
0 => null,
1 => '1 Fassung',
default => $count.' Fassungen',
};
}
/**
* @param list<string> $codes
*/
private function licenseText(array $codes): ?string
{
if ($codes === []) {
return null;
}
$named = count($codes) === 1
? 'Im Lizenzartikel '.$codes[0].' genannt.'
: 'In den Lizenzartikeln '.implode(', ', $codes).' genannt.';
return $named.' Das belegt keinen Zugriff in der Bibliothek.';
}
private function imageNote(ContentElement $element): ?string
{
if (is_string($element->thumbnail_error) && trim($element->thumbnail_error) !== '') {
return Str::limit(trim($element->thumbnail_error), 180);
}
return null;
}
private function typeKey(string $outputClass): string
{
return match ($outputClass) {
'film' => 'film',
'audio' => 'audio',
'bild' => 'bild',
'document', 'pdf' => 'document',
default => 'text',
};
}
private function kindLabel(Composition $composition): string
{
$kind = $composition->kind;
return ($kind instanceof CompositionKind ? $kind : CompositionKind::from((string) $kind))->deskLabel();
}
private function versionLabel(ContentElementVersion $version): string
{
return match ($version->status) {
ContentVersionStatus::Entwurf => 'Entwurf',
ContentVersionStatus::Gesperrt => 'Fassung '.$version->number.', deaktiviert',
default => 'Fassung '.$version->number,
};
}
}
+24 -28
View File
@@ -5,10 +5,9 @@
use App\Domain\Cms\Sections\PageSections;
use App\Domain\Cms\Sections\SectionLayouts;
use App\Domain\Cms\Sections\SectionStyle;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\WidgetRegistry;
use Filament\Actions\Action;
use Filament\Forms\Components\FileUpload;
use Filament\Forms\Components\Hidden;
use Filament\Forms\Components\Repeater;
use Filament\Forms\Components\Select;
@@ -20,7 +19,6 @@
use Filament\Schemas\Components\Utilities\Set;
use Illuminate\Support\HtmlString;
use Illuminate\Support\Str;
use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
/**
* Seiteneditor für Abschnitte und Slots.
@@ -143,35 +141,33 @@ private static function styleFields(): array
->default('standard')
->selectablePlaceholder(false)
->helperText('Ein Hintergrund reicht immer über die ganze Bildschirmbreite.'),
Select::make('spacing')
->label('Abstand oben und unten')
Select::make('spacing_top')
->label('Abstand oben')
->options(SectionStyle::SPACINGS)
->default('normal')
->selectablePlaceholder(false),
->default(SectionStyle::DEFAULTS['spacing_top'])
->selectablePlaceholder(false)
->helperText('Vor dem Inhalt. Zwischen zwei Abschnitten addieren sich „unten“ und „oben“; „Kein Abstand“ lässt einen Einstieg direkt unter der Kopfzeile beginnen.'),
Select::make('spacing_bottom')
->label('Abstand unten')
->options(SectionStyle::SPACINGS)
->default(SectionStyle::DEFAULTS['spacing_bottom'])
->selectablePlaceholder(false)
->helperText('Nach dem Inhalt. Bei eigener Fläche liegen beide Abstände innerhalb der Fläche.'),
Select::make('gap')
->label('Widget-Abstand')
->options(SectionStyle::SPACINGS)
->default(SectionStyle::DEFAULTS['gap'])
->selectablePlaceholder(false)
->helperText('Zwischen den Plätzen dieses Abschnitts, nebeneinander und gestapelt. Abstände innerhalb eines Widgets bleiben Sache des Widgets.'),
Select::make('divider')
->label('Trenner zum nächsten Abschnitt')
->options(SectionStyle::DIVIDERS)
->default('none')
->selectablePlaceholder(false),
Select::make('image')
->label('Hintergrundbild: vorhandenes Bild')
->options(fn (): array => PublicMedia::imageOptions())
->searchable()
->placeholder('Bitte wählen')
->helperText('Nur Bilder aus dem öffentlichen Website-Bereich. Geschützte Filmbilder sind hier nicht wählbar.')
->visible(fn (Get $get): bool => $get('background') === 'image')
->columnSpan(['default' => 1, 'md' => 2]),
FileUpload::make('_upload')
->label('Hintergrundbild: neu hochladen')
->disk('cms_incoming')
->directory('cms')
->image()
->maxSize(8192)
->acceptedFileTypes(['image/jpeg', 'image/png', 'image/webp'])
->getUploadedFileNameForStorageUsing(fn (TemporaryUploadedFile $file): string => Str::slug(pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME)).'-'.Str::lower(Str::random(6)).'.'.$file->guessExtension())
->helperText('Ersetzt die Auswahl links. Nur Bilder mit geklärter Veröffentlichungsfreigabe hochladen.')
->visible(fn (Get $get): bool => $get('background') === 'image')
->columnSpan(['default' => 1, 'md' => 2]),
...array_map(
fn ($field) => $field->visible(fn (Get $get): bool => $get('background') === 'image')->columnSpan(['default' => 1, 'md' => 2]),
ImageRefFields::fields('Hintergrundbild'),
),
Select::make('focus')
->label('Bildausschnitt (Fokuspunkt)')
->options(SectionStyle::FOCUS)
@@ -524,8 +520,8 @@ private static function slotLabel(array $state, ?int $index, mixed $layout): str
$type = $items !== [] ? (array_values($items)[0]['type'] ?? null) : null;
$registry = app(WidgetRegistry::class);
if ($registry->has($type) && $registry->get($type)->minUnits() > $slotUnits) {
$label .= ' · zu schmal: „'.$registry->get($type)->label().'“ braucht '.$registry->get($type)->minUnits();
if ($registry->has($type) && ! $registry->get($type)->supportsUnits($slotUnits)) {
$label .= ' · passt nicht: „'.$registry->get($type)->label().'“ ist für '.$registry->get($type)->unitsLabel().' Einheiten vorgesehen';
}
return $label;
+110 -20
View File
@@ -13,7 +13,13 @@
use Filament\Forms\Components\Select;
use Filament\Forms\Components\ToggleButtons;
use Filament\Notifications\Notification;
use Filament\Schemas\Components\Group;
use Filament\Schemas\Components\Grid;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Tabs;
use Filament\Schemas\Components\Tabs\Tab;
use Filament\Schemas\Components\Text;
use Filament\Schemas\Components\Utilities\Get;
use Filament\Schemas\Components\View;
use Illuminate\Foundation\Vite;
use Illuminate\Support\HtmlString;
use Illuminate\Support\Str;
@@ -83,29 +89,69 @@ public static function slotBuilder(string $name = 'widget'): Builder
public static function block(WidgetType $type): Block
{
$variants = $type->variants();
$icons = $type->optionIcons();
$display = [];
$schema = [Hidden::make('id')];
$schema[] = count($variants) > 1
? ToggleButtons::make('variant')
if (count($type->variants()) > 1) {
$display[] = ToggleButtons::make('variant')
->label('Darstellung')
->options($variants)
->options($type->variants())
->icons($icons['variant'] ?? [])
->default($type->defaultVariant())
->inline()
->required()
: Hidden::make('variant')->default($type->defaultVariant());
if ($type->settings() !== []) {
$settings = [];
foreach ($type->settings() as $key => $options) {
$settings[] = Select::make($key)->label(Str::headline($key))->options($options);
}
$schema[] = Group::make($settings)->statePath('settings');
->live();
}
foreach ($type->editorSchema() as $component) {
$schema[] = $component;
$settings = [];
$labels = $type->settingLabels();
foreach ($type->settingOptions() as $key => $options) {
// Gemeinsame Höhe (ADR-38): immer als sichtbare Auswahl mit Vorgabe, nie als freie Eingabe.
$settings[] = $key === 'height'
? ToggleButtons::make('height')
->label('Höhe')
->helperText('Gestaltungsparameter, keine Begrenzung: Längere Inhalte erhalten immer den nötigen Platz.')
->options($options)
->icons($icons['height'] ?? [])
->default($type->defaultHeight())
->inline()
->live()
: Select::make($key)
->label($labels[$key][0] ?? Str::headline($key))
->helperText($labels[$key][1] ?? null)
->placeholder('Vorgabe der Darstellung')
->options($options)
->live();
}
if ($settings !== []) {
$display[] = Grid::make(['default' => 1, 'md' => 2])->schema($settings)->statePath('settings');
}
$variantField = count($type->variants()) > 1 ? [] : [Hidden::make('variant')->default($type->defaultVariant())];
$content = $type->editorSchema();
$media = $type->mediaSchema();
if ($display === [] && $media === []) {
$schema = [Hidden::make('id'), ...$variantField, ...$content];
} else {
$tabs = [Tab::make('Inhalt')->icon('heroicon-o-pencil-square')->schema($content)];
if ($media !== []) {
$tabs[] = Tab::make('Medien')->icon('heroicon-o-photo')->schema($media);
}
if ($display !== []) {
$tabs[] = Tab::make('Darstellung')->icon('heroicon-o-adjustments-horizontal')->schema([
...$display,
Text::make('Platzbreiten: '.$type->unitsLabel().' Rastereinheiten. '.$type->narrowBehavior()),
]);
}
$schema = [
Hidden::make('id'),
...$variantField,
Tabs::make('Widget')->tabs($tabs)->contained(false),
self::livePreview($type),
];
}
return WidgetBlock::make($type->key())
@@ -233,6 +279,50 @@ public static function notifyErrors(array $errors, array $blocks): void
->send();
}
/** Logische Vorschaubreiten in px: tatsächliche Platzbreiten im Standardabschnitt bei 1440 px Fensterbreite. */
public const PREVIEW_UNIT_WIDTHS = [1 => 310, 2 => 640, 3 => 960, 4 => 1300];
public const PREVIEW_PHONE_WIDTH = 390;
/**
* Live-Vorschau im Bearbeitungsdialog: rendert den ungespeicherten Zustand mit derselben Ansicht wie die Website
* in einer wählbaren Platzbreite. Die Breitenwahl (_preview_width) wird nicht gespeichert.
*/
private static function livePreview(WidgetType $type): Section
{
$default = (string) self::PREVIEW_UNIT_WIDTHS[$type->preferredUnits()];
$widths = [(string) self::PREVIEW_PHONE_WIDTH => 'Smartphone'];
foreach ($type->supportedUnits() as $units) {
$widths[(string) self::PREVIEW_UNIT_WIDTHS[$units]] = $units.' '.($units === 1 ? 'Einheit' : 'Einheiten');
}
return Section::make('Vorschau')
->description('Änderungen erscheinen sofort. Unter 860 px zeigt der Einstieg den Sicherheitsumbruch, Bild und Text ab 900 px zwei Spalten.')
->collapsible()
->compact()
->schema([
ToggleButtons::make('_preview_width')
->hiddenLabel()
->options($widths)
->default($default)
->inline()
->live()
->dehydrated(false)
->extraAttributes(['class' => 'luf-preview-width']),
View::make('filament.cms.widget-live-preview')
->viewData(fn (Get $get): array => [
'html' => self::renderPreview($type->key(), [
'variant' => $get('variant'),
'settings' => $get('settings'),
'data' => $get('data'),
'refs' => $get('refs'),
]),
'stylesheets' => self::previewStylesheets(),
'width' => (int) ($get('_preview_width') ?: $default),
]),
]);
}
/**
* Blockvorschau: dieselbe Widget-Ansicht wie öffentlich, aus dem ungespeicherten Zustand.
*
@@ -287,9 +377,9 @@ private static function pickerLabel(WidgetType $type): HtmlString
private static function unitsHint(WidgetType $type): string
{
return $type->minUnits() === 1
? 'Passt in jeden Platz'
: 'Braucht einen Platz ab '.$type->minUnits().' Rastereinheiten';
return $type->supportedUnits() === [1, 2, 3, 4]
? 'Passt in jeden Platz (1 bis 4 Einheiten)'
: 'Für Plätze mit '.$type->unitsLabel().' Rastereinheiten';
}
/**
@@ -2,15 +2,21 @@
namespace App\Http\Controllers;
use App\Domain\Media\WebsiteMedia;
use App\Domain\Media\WebsiteMediaAlias;
use Illuminate\Support\Facades\Storage;
use Symfony\Component\HttpFoundation\StreamedResponse;
class PublicMediaController extends Controller
{
public function show(string $path): StreamedResponse
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.
$alias = WebsiteMediaAlias::effectiveFor($path);
abort_if($alias !== null && $media->present($alias->content_element_id) === null, 404);
foreach (['media_public', 'cms_incoming'] as $disk) {
if (Storage::disk($disk)->exists($path)) {
return Storage::disk($disk)->response($path);
@@ -0,0 +1,25 @@
<?php
namespace App\Http\Controllers;
use App\Domain\Catalog\ContentElement;
use App\Domain\Media\WebsiteMedia;
use Illuminate\Support\Facades\Storage;
use Symfony\Component\HttpFoundation\StreamedResponse;
class WebsiteMediaController extends Controller
{
public function show(ContentElement $element, WebsiteMedia $media): StreamedResponse
{
$presentation = $media->present($element);
abort_if($presentation === null, 404);
$path = $element->website_public_path;
abort_if(! is_string($path), 404);
return Storage::disk('media_public')->response($path, null, [
'Content-Disposition' => 'inline',
'X-Content-Type-Options' => 'nosniff',
]);
}
}
+49
View File
@@ -0,0 +1,49 @@
<?php
namespace App\Jobs;
use App\Domain\Catalog\ContentElement;
use App\Domain\Media\ThumbnailDeriver;
use App\Domain\Media\WebsiteRelease;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Queue\Queueable;
use Illuminate\Support\Facades\Storage;
class AcceptWebsiteImage implements ShouldQueue
{
use Queueable;
public function __construct(
public int $elementId,
public string $incoming,
public ?int $actorId = null,
) {}
public function handle(ThumbnailDeriver $deriver, WebsiteRelease $release): void
{
$element = ContentElement::query()->find($this->elementId);
if (! $element instanceof ContentElement) {
return;
}
$deriver->forWebsiteImage($element, $this->incoming);
$element->refresh();
if ($release->derivedPath($element) === null) {
return;
}
if ($this->incomingIsDisposable()) {
Storage::disk('cms_incoming')->delete($this->incoming);
}
PublishWebsiteMedia::dispatch($element->id, 'release', $this->actorId);
}
private function incomingIsDisposable(): bool
{
return (str_starts_with($this->incoming, 'cms/') || str_starts_with($this->incoming, 'vorschau/'))
&& ! str_contains($this->incoming, '..');
}
}
+83
View File
@@ -0,0 +1,83 @@
<?php
namespace App\Jobs;
use App\Domain\Media\WebsiteIntake;
use App\Domain\Media\WebsiteMediaAlias;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Queue\Queueable;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
use Throwable;
/**
* Übernimmt die bisherigen CMS-Bilder (media_public, cms/…) in den Medienmanager.
*
* - Bytegleiche Dateien werden ein Medium (SHA-256); jeder frühere Pfad erhält eine Zuordnung (WebsiteMediaAlias).
* - Neue Medien entstehen über WebsiteIntake: Die Warteschlange leitet das Bild ab und gibt genau diese Ableitung
* für die Website frei. Erst danach wird die Zuordnung wirksam; bis dahin bleibt der frühere Pfad gültig.
* - Wiederholbar: Bereits zugeordnete Pfade werden übersprungen. Es wird nichts gelöscht; die Dateien unter cms/
* bleiben liegen (frühere Revisionen, Rückweg).
*/
class ImportCmsImages implements ShouldQueue
{
use Queueable;
private const EXTENSIONS = ['jpg', 'jpeg', 'png', 'webp', 'gif'];
public function handle(WebsiteIntake $intake): void
{
$public = Storage::disk('media_public');
try {
$files = $public->allFiles('cms');
} catch (Throwable) {
return;
}
sort($files);
foreach ($files as $path) {
if (! $this->isImage($path) || WebsiteMediaAlias::query()->where('legacy_path', $path)->exists()) {
continue;
}
$bytes = $public->get($path);
if (! is_string($bytes) || $bytes === '') {
continue;
}
$hash = hash('sha256', $bytes);
$twin = WebsiteMediaAlias::query()->where('sha256', $hash)->first();
if ($twin instanceof WebsiteMediaAlias) {
WebsiteMediaAlias::query()->create(['legacy_path' => $path, 'content_element_id' => $twin->content_element_id, 'sha256' => $hash]);
continue;
}
Storage::disk('cms_incoming')->put($path, $bytes);
$element = $intake->acceptImage($path, self::titleFor($path));
WebsiteMediaAlias::query()->create(['legacy_path' => $path, 'content_element_id' => $element->id, 'sha256' => $hash]);
}
}
/** „cms/platzhalter-karte-1-liyjqa.jpg“ → „Platzhalter Karte 1“ (ohne die angehängte Zufallskennung). */
public static function titleFor(string $path): string
{
$name = pathinfo($path, PATHINFO_FILENAME);
$name = preg_replace('/-[a-z0-9]{6}$/', '', $name) ?? $name;
$title = trim(str_replace(['-', '_'], ' ', $name));
return $title === '' ? 'Website-Bild' : Str::title($title);
}
private function isImage(string $path): bool
{
return str_starts_with($path, 'cms/')
&& ! str_contains($path, '..')
&& preg_match('#^cms/[A-Za-z0-9._\-/]+$#', $path) === 1
&& in_array(strtolower(pathinfo($path, PATHINFO_EXTENSION)), self::EXTENSIONS, true);
}
}
+90
View File
@@ -0,0 +1,90 @@
<?php
namespace App\Jobs;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\IdentityChange;
use App\Domain\Media\WebsiteRelease;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Queue\Queueable;
use Illuminate\Support\Facades\Storage;
class PublishWebsiteMedia implements ShouldQueue
{
use Queueable;
public function __construct(
public int $elementId,
public string $action,
public ?int $actorId = null,
) {}
public function handle(WebsiteRelease $release): void
{
$element = ContentElement::query()->find($this->elementId);
if (! $element instanceof ContentElement || ! in_array($this->action, ['release', 'withdraw'], true)) {
return;
}
if ($this->action === 'withdraw') {
$this->deletePublicFile($element);
$this->mark($element, $element->website_released_at?->toIso8601String(), null);
$element->forceFill([
'website_released_at' => null,
'website_public_path' => null,
])->save();
return;
}
$derived = $release->derivedPath($element);
if ($derived === null) {
return;
}
$target = $release->publicPath($element, $derived);
$previous = $element->website_public_path;
Storage::disk('media_public')->put($target, Storage::disk('media_derived')->get($derived));
if (is_string($previous) && $previous !== $target && str_starts_with($previous, 'website/'.$element->id.'/')) {
Storage::disk('media_public')->delete($previous);
}
$this->mark($element, $element->website_released_at?->toIso8601String(), now()->toIso8601String());
$element->forceFill([
'website_released_at' => now(),
'website_public_path' => $target,
])->save();
}
private function deletePublicFile(ContentElement $element): void
{
$path = $element->website_public_path;
if (! is_string($path) || ! str_starts_with($path, 'website/'.$element->id.'/') || str_contains($path, '..')) {
return;
}
Storage::disk('media_public')->delete($path);
}
private function mark(ContentElement $element, ?string $before, ?string $after): void
{
if ($before === $after) {
return;
}
IdentityChange::query()->create([
'subject_type' => $element->getMorphClass(),
'subject_id' => $element->id,
'field' => 'website_released_at',
'before' => $before,
'after' => $after,
'actor_id' => $this->actorId,
'occurred_at' => now(),
]);
}
}
+5
View File
@@ -2,10 +2,12 @@
namespace App\Providers;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\NavigationItem;
use App\Domain\Cms\NavigationItemPolicy;
use App\Domain\Cms\Page;
use App\Domain\Cms\PagePolicy;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetRegistry;
use App\Domain\Media\FfmpegFilmTranscoder;
use App\Domain\Media\FilmTranscoder;
@@ -23,6 +25,9 @@ class AppServiceProvider extends ServiceProvider
public function register(): void
{
$this->app->bind(FilmTranscoder::class, FfmpegFilmTranscoder::class);
// Je Anfrage einmal den Index der öffentlich genannten Medien bilden, nicht je Karte.
$this->app->scoped(PublicMaterialReader::class);
$this->app->scoped(WebsiteImage::class);
$this->app->singleton(WidgetRegistry::class, fn ($app): WidgetRegistry => new WidgetRegistry(
array_map(fn (string $class) => $app->make($class), config('cms.widgets', [])),
));
+6
View File
@@ -7,7 +7,10 @@
use App\Domain\Cms\Widgets\Types\HeadingWidget;
use App\Domain\Cms\Widgets\Types\HeroWidget;
use App\Domain\Cms\Widgets\Types\ImageTextWidget;
use App\Domain\Cms\Widgets\Types\MediaCardWidget;
use App\Domain\Cms\Widgets\Types\ProgramCardWidget;
use App\Domain\Cms\Widgets\Types\ProseWidget;
use App\Domain\Cms\Widgets\Types\TopicCardWidget;
return [
@@ -24,6 +27,9 @@
ImageTextWidget::class,
CardsWidget::class,
CatalogCardsWidget::class,
TopicCardWidget::class,
MediaCardWidget::class,
ProgramCardWidget::class,
CallToActionWidget::class,
FaqWidget::class,
],
@@ -0,0 +1,30 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::table('content_elements', function (Blueprint $table) {
$table->text('website_credit')->nullable()->after('license_note');
$table->string('website_alt')->nullable()->after('website_credit');
$table->timestamp('website_released_at')->nullable()->after('website_alt');
$table->string('website_public_path')->nullable()->after('website_released_at');
});
}
public function down(): void
{
Schema::table('content_elements', function (Blueprint $table) {
$table->dropColumn([
'website_credit',
'website_alt',
'website_released_at',
'website_public_path',
]);
});
}
};
@@ -0,0 +1,28 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Zuordnung früherer CMS-Bildpfade (cms/…) zu Medien im Medienmanager. Additiv: Gespeicherte Revisionen und
* die Dateien unter cms/ bleiben unverändert; die Zuordnung wird beim Darstellen gelesen.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('website_media_aliases', function (Blueprint $table) {
$table->id();
$table->string('legacy_path')->unique();
$table->foreignId('content_element_id')->constrained()->restrictOnDelete();
$table->string('sha256', 64)->index();
$table->timestamps();
});
}
public function down(): void
{
Schema::dropIfExists('website_media_aliases');
}
};
@@ -0,0 +1,27 @@
<?php
use App\Jobs\ImportCmsImages;
use Illuminate\Database\Migrations\Migration;
/**
* Übernimmt die bisherigen CMS-Bilder (media_public, cms/…) in den Medienmanager. Die Migration läuft im
* App-Container, der keine Medien schreibt; sie stößt deshalb nur den Job der Hintergrundverarbeitung an.
* Der Job ist wiederholbar und löscht nichts.
*/
return new class extends Migration
{
public function up(): void
{
// In Tests liegen echte Medien nicht vor; die Übernahme prüfen eigene Tests mit Testplatten.
if (app()->runningUnitTests()) {
return;
}
ImportCmsImages::dispatch();
}
public function down(): void
{
// Nichts zurückzunehmen: Die übernommenen Medien und Zuordnungen bleiben; die Tabelle entfernt die vorige Migration.
}
};
Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 217 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 132 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 233 KiB

@@ -0,0 +1 @@
<!doctype html><html lang="de"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Lara & Felix – Designkonzept Bibliothek</title><meta name="robots" content="noindex,nofollow"><link rel="stylesheet" href="site.css"></head><body class="app-bg"><div class="apphead"><header class="top"><div class="nav wrap"><a class="brand" href="index.html" aria-label="Lara und Felix, Startseite">Lara & Felix<small>Stark im Alltag</small></a><nav class="links" aria-label="Hauptnavigation"><a href="index.html">Start</a><a href="bibliothek.html">Filme & Materialien</a><a href="player.html">Methodik</a><a class="btn outline" href="bibliothek.html">Anmelden</a><a class="btn green" href="bibliothek.html">Mitgliederbereich</a></nav></div></header></div><div class="appwrap"><aside class="side"><a href="index.html">⌂ Übersicht</a><a class="active" href="bibliothek.html">▦ Meine Bibliothek</a><a href="player.html">▷ Filme</a><a href="bibliothek.html">▤ Materialien</a><a href="bibliothek.html">♧ Berechtigungen</a></aside><main class="main"><div class="dash-head"><div><span class="flag">Mitgliederbereich · Layoutentwurf</span><h1>Meine Bibliothek</h1><p>Alles für die nächste Kursstunde an einem Ort.</p></div><div class="search" aria-label="Suche (nur Layoutkonzept)">⌕ &nbsp; Inhalte suchen …</div></div><div class="filters"><span class="filter on">Alle Inhalte</span><span class="filter">Filme</span><span class="filter">Übungen</span><span class="filter">Materialien</span><span class="filter">Programme</span></div><div class="library-grid"><article class="media-card"><a href="player.html"><div class="photo" style="background-image:url('assets/titel_original.webp')"><span class="type">Film</span></div></a><div class="body"><div class="small">DEMO · kein echter Artikel</div><h3>Film zur Erprobung</h3><p>Ein Film kann mit Übungen und Materialien verbunden sein.</p><span class="status">○ Zugang aus Berechtigung</span></div></article><article class="media-card"><a href="player.html"><div class="photo" style="background-image:url('assets/denkpause_original.webp')"><span class="type">Übung</span></div></a><div class="body"><div class="small">DEMO · kein echter Artikel</div><h3>Nachdenken und sprechen</h3><p>Das Material kann in mehreren Kompositionen genutzt werden.</p><span class="status">○ Zugang aus Berechtigung</span></div></article><article class="media-card"><a href="player.html"><div class="photo" style="background-image:url('assets/outro_original.webp')"><span class="type">Dokument</span></div></a><div class="body"><div class="small">DEMO · kein echter Artikel</div><h3>Begleitmaterial</h3><p>Trainerunterlagen erscheinen als eigenständige Medientypen.</p><span class="status">○ Zugang aus Berechtigung</span></div></article></div><div class="notice"><strong>Hinweis zur Lizenzansicht</strong><span>Ein Lizenzartikel soll einmal sichtbar sein, auch wenn mehrere Erwerbsquellen vorhanden sind. Einzelne Rechte bleiben getrennt prüfbar.</span></div></main></div></body></html>
@@ -0,0 +1 @@
<!doctype html><html lang="de"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Lara & Felix – Designkonzept Startseite</title><meta name="robots" content="noindex,nofollow"><link rel="stylesheet" href="site.css"></head><body><header class="top"><div class="nav wrap"><a class="brand" href="index.html" aria-label="Lara und Felix, Startseite">Lara & Felix<small>Stark im Alltag</small></a><nav class="links" aria-label="Hauptnavigation"><a href="index.html">Start</a><a href="bibliothek.html">Filme & Materialien</a><a href="player.html">Methodik</a><a class="btn outline" href="bibliothek.html">Anmelden</a><a class="btn green" href="bibliothek.html">Mitgliederbereich</a></nav></div></header><main><section class="hero"><div class="hero-picture" role="img" aria-label="Lara und Felix mit Serienlogo im sonnigen Park"></div><div class="hero-text wrap"><span class="flag">Für Trainer und pädagogische Fachkräfte</span><h1>Geschichten, die Kinder stärken.</h1><p>Filme und praxisnahe Materialien für Gewaltprävention, Selbstbehauptung und gemeinsame Gespräche.</p><div class="hero-actions"><a class="btn yellow" href="bibliothek.html">Materialien entdecken →</a><a class="btn outline" href="player.html">Unsere Methode</a></div><p class="hero-note">Gestaltungsvorschau – funktionale Angebote und Aussagen vor Veröffentlichung prüfen.</p></div></section><section class="section"><div class="wrap"><div class="intro-head"><div><span class="flag">Unser Ansatz</span><h2>Aus dem Alltag. Für den Alltag.</h2></div><p>Die Filme schaffen Gesprächsanlässe. Trainer gestalten daraus Übungen, Reflexion und gemeinsames Lernen.</p></div><div class="features"><div class="feature"><div class="sym">▣</div><h3>Geschichten erleben</h3><p>Anschauliche Situationen aus einer vertrauten Lebenswelt als Einstieg in den Kurs.</p></div><div class="feature"><div class="sym">?</div><h3>Gemeinsam nachdenken</h3><p>Bewusste Denkpausen geben Raum für Fragen, Gespräche und eigene Ideen.</p></div><div class="feature"><div class="sym">✓</div><h3>Handeln üben</h3><p>Begleitmaterial und Aufgaben helfen, das Gespräch praktisch fortzuführen.</p></div></div></div></section><section class="section offwhite"><div class="wrap"><div class="intro-head"><div><span class="flag">Einblicke</span><h2>Filme und Materialien</h2></div><p>Beispielhafte Darstellung möglicher Medientypen; keine realen Katalogangebote.</p></div><div class="card-grid"><article class="media-card"><div class="photo" style="background-image:url('assets/titel_original.webp')"><span class="type">Film · Beispiel</span></div><div class="body"><h3>Alltagssituation</h3><p>Videogestützte Einstiege in das gemeinsame Training.</p></div></article><article class="media-card"><div class="photo" style="background-image:url('assets/denkpause_original.webp')"><span class="type">Didaktik · Beispiel</span></div><div class="body"><h3>Denkpause</h3><p>Ein bewusstes Innehalten für Fragen und Austausch.</p></div></article><article class="media-card"><div class="photo" style="background-image:url('assets/outro_original.webp')"><span class="type">Material · Beispiel</span></div><div class="body"><h3>Trainermaterial</h3><p>Praktische Materialien können Filme ergänzen und verbinden.</p></div></article></div></div></section></main><footer class="foot"><div class="wrap"><div><strong>Lara & Felix</strong><small>Stark im Alltag · Designkonzept, keine Live-Webseite</small></div><p>Dieses UI-Kit verwendet konzeptionelle Texte und keine tatsächlichen Preise, Angebote oder Kundenangaben.</p></div></footer></body></html>
@@ -0,0 +1 @@
<!doctype html><html lang="de"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Lara & Felix – Designkonzept Kursplayer</title><meta name="robots" content="noindex,nofollow"><link rel="stylesheet" href="site.css"></head><body><header class="top"><div class="nav wrap"><a class="brand" href="index.html" aria-label="Lara und Felix, Startseite">Lara & Felix<small>Stark im Alltag</small></a><nav class="links" aria-label="Hauptnavigation"><a href="index.html">Start</a><a href="bibliothek.html">Filme & Materialien</a><a href="player.html">Methodik</a><a class="btn outline" href="bibliothek.html">Anmelden</a><a class="btn green" href="bibliothek.html">Mitgliederbereich</a></nav></div></header><main class="player-wrap"><div class="crumb">Meine Bibliothek / Film / Kursplayer</div><h1>Denkpause: Was würdet ihr tun?</h1><p class="sub">Gestaltungsvorschau · der Player ist nicht mit echten Medien oder Rechten verbunden.</p><div class="player" role="img" aria-label="Denkpause-Grafik mit Lara und Felix"><div class="still"></div><div class="player-controls"><span>❚❚</span><span>0:46</span><div class="progress"></div><span>2:00</span><span>⛶</span></div></div><div class="under-player"><section class="panel"><span class="flag">Didaktischer Moment</span><h3>Gespräch in der Gruppe</h3><p>Die Denkpause bietet einen natürlichen Moment, um mit den Kindern über Handlungsoptionen zu sprechen. Die tatsächliche Fortsetzung wird später im funktionalen Player eingebunden.</p><a class="btn green" href="bibliothek.html">Zur Bibliothek</a></section><section class="panel"><span class="flag">Trainermaterial</span><h3>Begleitende Unterlagen</h3><p>Trainerhinweise, Übungen und Arbeitsblätter werden an dieser Stelle aus der wirklichen Artikelkomposition geladen.</p><span class="pill">Layoutentwurf</span></section></div></main><footer class="foot"><div class="wrap"><div><strong>Lara & Felix</strong><small>Stark im Alltag · Designkonzept, keine Live-Webseite</small></div><p>Dieses UI-Kit verwendet konzeptionelle Texte und keine tatsächlichen Preise, Angebote oder Kundenangaben.</p></div></footer></body></html>
Binary file not shown.

After

Width:  |  Height:  |  Size: 363 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 440 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 663 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 928 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 215 KiB

+10
View File
@@ -0,0 +1,10 @@
@import url('https://fonts.googleapis.com/css2?family=Nunito:wght@500;600;700;800;900&family=Nunito+Sans:wght@400;500;600;700;800&display=swap');
:root {--navy:#032551;--navy2:#01244c;--green:#5B8625;--yellow:#FCD10A;--cream:#F7F6F2;--paper:#FBFBF7;--muted:#5D6A78;--line:#E0E9E0;--shadow:0 18px 45px rgba(3,37,81,.07)}
*,*:before,*:after{box-sizing:border-box}body{margin:0;background:#FBFBF7;color:#162b45;font:16px/1.55 'Nunito Sans','Segoe UI',sans-serif}button,a{font:inherit}a{color:inherit;text-decoration:none}img{max-width:100%}h1,h2,h3{font-family:'Nunito','Trebuchet MS',sans-serif;line-height:1.15;letter-spacing:-.035em;color:var(--navy)}h1{font-size:clamp(34px,4vw,60px)}h2{font-size:clamp(25px,2.5vw,36px)}p{margin:0 0 1rem}.wrap{width:min(1180px,calc(100% - 56px));margin:auto}
.top{background:white;border-bottom:1px solid #eef1eb;position:relative;z-index:10}.nav{height:82px;display:flex;align-items:center;justify-content:space-between;gap:28px}.brand{line-height:.92;color:var(--navy);font-family:'Nunito',sans-serif;font-weight:900;letter-spacing:-.05em;font-size:25px;transform:rotate(-1deg)}.brand>small{display:block;width:max-content;background:var(--green);font-size:11px;letter-spacing:0;color:white;padding:5px 11px;border-radius:20px;margin-top:5px}.brand:after{content:'';display:block;width:82%;height:5px;border-radius:90%;background:var(--yellow);transform:rotate(-2deg);margin-top:-25px;position:relative;top:-1px;z-index:-1}.links{display:flex;gap:28px;align-items:center;font-size:14px;font-weight:800;color:#19334c}.links a:focus-visible,.btn:focus-visible{outline:3px solid #1676ac;outline-offset:3px}.links a:not(.btn):hover{color:var(--green)}.btn{display:inline-flex;gap:8px;justify-content:center;align-items:center;border-radius:999px;padding:12px 21px;font-size:14px;font-weight:900;white-space:nowrap;border:1px solid transparent;transition:transform .18s,box-shadow .18s}.btn:hover{transform:translateY(-2px);box-shadow:0 8px 22px rgba(3,37,81,.15)}.btn.primary{background:var(--navy);color:white}.btn.green{background:var(--green);color:white}.btn.outline{background:white;color:var(--navy);border-color:#c8d5d6}.btn.yellow{background:var(--yellow);color:var(--navy)}
.flag{font-size:11px;letter-spacing:.11em;text-transform:uppercase;font-weight:900;color:var(--green);display:inline-flex;align-items:center;gap:9px}.flag:before{content:'';width:26px;height:4px;background:var(--yellow);border-radius:4px}.hero{background:#f0f2e8;overflow:hidden}.hero-picture{position:relative;min-height:560px;background-image:url('assets/outro_original.webp');background-position:center;background-size:cover}.hero-text{position:absolute;left:52%;top:24%;max-width:520px;padding:10px}.hero-text h1{font-size:clamp(33px,4vw,61px);margin:10px 0 22px;letter-spacing:-.045em}.hero-text p{font-size:17px;max-width:420px}.hero-actions{display:flex;gap:12px;flex-wrap:wrap;margin-top:24px}.hero-note{font-size:12px;color:var(--muted);margin-top:20px}.section{padding:80px 0}.intro-head{display:flex;align-items:flex-end;justify-content:space-between;gap:30px;margin-bottom:29px}.intro-head h2{margin:8px 0 0}.intro-head>p{max-width:420px;color:var(--muted)}.features{display:grid;grid-template-columns:repeat(3,1fr);gap:16px}.feature{background:white;border:1px solid var(--line);border-radius:22px;padding:28px;min-height:178px;box-shadow:var(--shadow)}.feature .sym{height:46px;width:46px;background:#e6f0dc;border-radius:14px;display:grid;place-items:center;font-size:23px}.feature h3{font-size:21px;margin:18px 0 7px}.feature p{color:var(--muted);font-size:14px}.offwhite{background:#F2F5ED}.card-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:18px}.media-card{background:white;border-radius:20px;overflow:hidden;box-shadow:var(--shadow);border:1px solid var(--line)}.media-card .photo{height:190px;background-size:cover;background-position:center;position:relative}.photo .type{position:absolute;bottom:13px;left:13px;background:#fff;border-radius:20px;padding:5px 10px;color:var(--navy);font-size:12px;font-weight:900}.media-card .body{padding:20px}.media-card h3{margin:0 0 10px;font-size:20px}.media-card p{font-size:14px;color:var(--muted);margin:0}.pill{display:inline-block;background:#eaf1e3;color:#365e1d;padding:6px 11px;border-radius:25px;font-size:12px;font-weight:900}.foot{background:var(--navy);color:#d3e2ed;padding:45px 0}.foot .wrap{display:flex;justify-content:space-between;gap:25px;align-items:center}.foot p{font-size:13px;margin:0}.foot strong{font-family:Nunito,sans-serif;color:white;font-size:21px}.foot small{display:block;color:#c0d7e3}
/* library */.app-bg{background:#f4f7f4;min-height:100vh}.apphead{background:white;border-bottom:1px solid #e4e8e6}.appwrap{max-width:1260px;margin:auto;display:grid;grid-template-columns:210px 1fr;min-height:calc(100vh - 82px)}.side{padding:36px 18px 30px;border-right:1px solid #e1e9e8}.side a{display:block;margin:7px 0;padding:11px 14px;border-radius:12px;font-weight:800;font-size:14px}.side a.active{background:#e4efe4;color:var(--green)}.main{padding:37px 40px 70px}.dash-head{display:flex;align-items:flex-end;justify-content:space-between;gap:20px}.dash-head h1{font-size:39px;margin:8px 0}.dash-head p{color:var(--muted)}.search{background:white;border:1px solid #d7e2e0;border-radius:100px;min-width:280px;padding:12px 18px;color:#8995a0;font-size:14px}.filters{display:flex;gap:8px;margin:26px 0 24px;flex-wrap:wrap}.filter{background:white;border:1px solid #dde7e3;border-radius:20px;padding:8px 15px;font-weight:800;font-size:12px}.filter.on{background:var(--navy);color:white}.library-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:18px}.library-grid .photo{height:158px}.media-card .small{color:#55707d;font-weight:700;font-size:12px}.media-card .status{margin-top:15px;display:inline-block;color:#376f1c;background:#edf5e8;padding:6px 10px;border-radius:20px;font-size:12px;font-weight:900}.notice{margin-top:30px;padding:19px 23px;border-radius:18px;background:#e8f0de;display:flex;gap:15px;align-items:center;font-size:14px;color:#35532a}.notice strong{color:#254316}
/* player */.player-wrap{max-width:1060px;margin:50px auto 100px;padding:0 28px}.crumb{font-size:13px;font-weight:800;color:#6b7d86}.player-wrap h1{font-size:38px;margin:16px 0 10px}.player-wrap .sub{color:var(--muted);margin-bottom:25px}.player{position:relative;aspect-ratio:16/9;background:var(--navy);border-radius:24px;overflow:hidden;box-shadow:0 20px 56px rgba(3,37,81,.15)}.player .still{position:absolute;inset:0;background:url('assets/denkpause_original.webp') center/cover}.player:after{content:'';position:absolute;inset:65% 0 0;background:linear-gradient(transparent,rgba(3,37,81,.45));pointer-events:none}.player-controls{position:absolute;bottom:18px;left:25px;right:25px;display:flex;align-items:center;gap:15px;z-index:1;color:white;font-weight:800}.progress{height:6px;background:#ffffff78;border-radius:6px;flex:1}.progress:before{content:'';display:block;width:41%;height:100%;background:var(--yellow);border-radius:6px}.under-player{display:grid;grid-template-columns:1.5fr 1fr;gap:18px;margin-top:22px}.panel{padding:28px;background:white;border:1px solid var(--line);border-radius:20px}.panel h3{margin:0 0 12px;font-size:20px}.panel p{font-size:14px;color:var(--muted)}
@media (max-width:980px){.nav{height:74px}.links a:not(.btn){display:none}.hero-picture{min-height:500px;background-position:40% center}.hero-text{left:52%;top:19%;max-width:400px}.hero-text h1{font-size:39px}.features,.card-grid,.library-grid{grid-template-columns:repeat(2,1fr)}.appwrap{grid-template-columns:170px 1fr}.main{padding:24px}.under-player{grid-template-columns:1fr}}
@media (max-width:680px){.wrap{width:min(100% - 32px,560px)}.brand{font-size:22px}.brand>small{font-size:10px}.links{gap:7px}.links a.btn:first-of-type{display:none}.links a.btn{padding:9px 13px;font-size:12px}.hero-picture{min-height:0;aspect-ratio:1.4/1;background-size:cover;background-position:17% center}.hero-text{position:static;background:#fbfbf7;padding:27px 18px 40px;max-width:none}.hero-text h1{font-size:36px}.hero-text p{font-size:15px}.hero-actions{gap:9px}.hero-note{margin-top:15px}.section{padding:48px 0}.intro-head{display:block}.features,.card-grid,.library-grid{grid-template-columns:1fr}.feature{min-height:auto}.media-card .photo{height:210px}.foot .wrap{display:block}.foot p{margin-top:10px}.appwrap{display:block}.side{display:flex;overflow:auto;padding:10px 16px;gap:5px;border-right:0;border-bottom:1px solid #e1e9e8}.side a{white-space:nowrap}.main{padding:30px 16px}.dash-head{display:block}.dash-head h1{font-size:32px}.search{width:100%;margin-top:18px}.library-grid .photo{height:190px}.player-wrap{margin:25px auto 70px;padding:0 16px}.player-wrap h1{font-size:28px}.player{border-radius:14px}.player-controls{bottom:10px;left:10px;right:10px;font-size:10px;gap:5px}.panel{padding:20px}}
@media(prefers-reduced-motion: reduce){*,*:before,*:after{scroll-behavior:auto!important;transition:none!important;animation:none!important}}
@@ -0,0 +1,165 @@
# Abschlussbericht: MVP-Beauftragung Mitgliederbibliothek
**Stand:** 16.11.2026
**Branch:** `develop`, Commit `30833f6`
**Testinstanz:** `luf-test` auf `llm-node`, Port 3011, Image `luf-app-test:30833f62a1e1` und `luf-web-test:30833f62a1e1`
**Grundlage:** `docs/analysen/umsetzungsplan-mitgliederbibliothek.md`, Verträge G1–G9, Ergänzung E-W12, die beiden Zusatzaufträge UX/UI des Mitgliederbereichs und fachliche Inhaltsverwaltung
Dieser Bericht schließt die Beauftragung ab. Er ist keine kommerzielle Freigabe. Der Plan macht Tor B zur Abnahme der Pakete 1 bis 8. Dieser Lauf ist nicht ausgeführt.
`docs/betrieb/MVP-Stand.md` beschreibt eine frühere Scheibe und ist durch diesen Bericht überholt.
## Auftrag
Umgesetzt werden sollten die Pakete 1 bis 9 des Umsetzungsplans, die Verträge G1 bis G9 und die didaktischen Metadaten E-W12. Gearbeitet wurde auf `develop`. Ein Push dorthin deployt die Testinstanz. Produktion und `main` wurden nicht angefasst.
Zwei Zusatzaufträge gehören dazu:
1. **Mitgliederbereich.** Der Kursraum für erwachsene Trainer folgt der vorgesehenen Gliederung und den vorhandenen Gestaltungsprinzipien. Nicht freigegebene Markenwerte bleiben austauschbare Tokens. Die Fläche darf nicht wie ein umbenanntes Filament aussehen. Geprüft wird in den Breiten 390, 768 und 1440 Pixel.
2. **Fachliche Inhaltsverwaltung.** Eine Person ohne technischen Hintergrund legt in der vorhandenen Verwaltung Medien und Dokumente an, beschreibt und ordnet sie, führt Fassungen, baut Module und Programme mit Lernziel, Zeit, Material und geordneten Bestandteilen, sucht vorhandene Inhalte einschließlich einer konkreten Fassung, ändert Rolle, Reihenfolge und Verschachtelung, sieht die Verwendung, unterscheidet Entwurf, technische Bereitschaft, Anzeigefreigabe und historische Fassungen, prüft die Struktur und gibt sie frei, hängt Lizenzartikel und Angebote an und nutzt die Abdeckungsprüfung. Die Beschriftung ist fachlich. Der Nachweis läuft durch die Oberfläche, nicht durch Seeder oder SQL.
Bewusst außerhalb bleiben Denkpause, Ablaufsteuerung, Präsentationsmodus, Fortschritt, zweites Gerät, Community, echter Zahlungsdienst, Organisationslizenzen, konkrete Preise, die Marketingstrecke M1–M3, ein Neubau der öffentlichen Website und der Editor-Prototyp W-P als zweites CMS. W-P bleibt der dokumentierte Wegwerfstand auf `feature/w-p-editor-prototype` (`docs/analysen/wp-editor-prototyp-2026-03-15.md`).
## Ergebnis in einem Satz
Die Pakete 1 bis 8, E-W12 und beide Zusatzaufträge sind im Code, in der Suite und auf der Testinstanz vorhanden und am Trainingsprogramm **Programm Abstand** durch die Oberfläche benutzbar. Die geplante Abschlussprüfung Tor B und drei eng umrissene Paketpunkte sind offen.
## Prüfstand
| | |
|---|---|
| Suite vor dem letzten Push | 76 Tests, 406 Zusicherungen, grün |
| Gate | `scripts/ci-test.sh`: Pint und `php artisan test` in einem Wegwerf-Container |
| Instanz | `http://192.168.2.144:3011/up` antwortet 200 |
| Medien | NFS `/srv/luf/test/media`. Der Web-Prozess schreibt die Ableitungen nicht. Die Queue schreibt Vorschaubilder und HLS nach `derived/`. |
| Demokatalog | Der Deploy legt ihn nicht mehr an. Der vorherige grüne Deploy hatte ihn einmal neu erzeugt. Diese Zeilen sind auf der Testinstanz wieder entfernt. |
Der erste Push der Medienableitung (`c997eb5`) ist am Image-Bau gescheitert, weil die Lockdatei mit einer neueren npm-Version geschrieben war als im Image. `295f784` gleicht die Lockdatei mit npm 10.9.9 ab. Danach sind die Images durchgelaufen.
## Pakete
| Paket | Stand | Was vorliegt |
|---|---|---|
| 0 Befund | erledigt, historisch | `docs/analysen/befund-paket-0-testinstanz-2026-03-15.md`. Zum Zeitpunkt des Befunds keine doppelte aktive Angebotsfassung. Der heutige Testbestand ist der Abstand-Graph nach der freigegebenen Löschung der alten Testzeilen. Produktion wurde nicht gelesen. |
| 1 Angebotsfassung | umgesetzt | Eine Aktivierung beendet die bisher aktive Fassung desselben Angebots. Registrierung und Kauf lesen eine aktive Fassung. Neue Bestellzeilen speichern die Bezeichnung. Parallelität ist durch einen Test abgedeckt. |
| 2 Inhaltsart | umgesetzt | `CompositionKind` bleibt `kurs`, `uebung`, `kombination`. Die Inhaltsart ist eine eigene Achse mit den Werten Programm, Modul, Merkblatt und Traineranleitung. Die Erklärung des Enums enthält weiterhin „Ein Kurs ist keine Übung“. |
| 3 Bibliothek | umgesetzt | G1 liest eine ausdrücklich angegebene Fassung unabhängig von der Anzeigefreigabe. G2 gibt Fassungen zur Anzeige frei und nimmt sie zurück. Die Bibliothek zeigt Programme, Module und Material. Teilrechte bleiben sichtbar, nicht getragene Blätter haben keine Datei. `DecideAccess` entscheidet je Abruf. Zwei Grants werden nicht vereinigt. |
| 4 Stammdaten | umgesetzt | Anzeigetitel und Kurzbeschreibung liegen an der Identität, mit Protokoll. Sie erzeugen keine neue Lehrfassung. Die Bibliothek liest sie, sobald sie gefüllt sind. |
| 5 Dimensionen und Filter | umgesetzt | Dimensionen sind pflegbar. Die fünf Säulen sind Startwerte und bleiben als Spalten erhalten. Direkte Zuordnung an Kompositionen ist von abgeleiteten Themen getrennt. Die Bibliothek sucht und filtert. Eine Säule vergibt keine Berechtigung. |
| 6 Vorschaubilder | umgesetzt, mit einer Lücke | Bild an Medium und Zusammenstellung, Alternativtext, Platzhalter, keine öffentliche Route, keine neue Inhaltsfassung. Ein Film liefert ein Bild aus dem ersten Frame. Eine wählbare Zeitposition fehlt. |
| 7 Vorschau und Abdeckung | umgesetzt | Die Maske zeigt die Verwendung. Die Redaktion sieht denselben Baum wie das Mitglied. Eine Aktivierung nennt fehlende Blätter und nimmt ein ungedecktes Programm nicht still auf. |
| 8 Medienausgabe | umgesetzt, in der vereinbarten Ehrlichkeit | Drei HLS-Stufen, signierte Playlists und Segmente, Nachweis je Ausgabe mit Kopiennummer, Prüfsumme und Kennzeichnung. Ohne Streamrecht keine Variante, ohne Laderecht keine Quelldatei. Eine schon gespeicherte Datei bleibt lesbar, bis eine Ableitung existiert. Texte im Leser tragen die sichtbare Lizenzzeile. Dateibytes von Film und PDF werden nicht gestempelt. |
| 9 Tor A / Tor B | nicht bestanden | Die lokale Suite und ein Durchlauf des Abstand-Programms ersetzen den verlangten HTTP-Lauf gegen die Testinstanz nicht. Eine wiederholbare Instanz-Suite (G9) ist nicht angelegt. |
## Verträge
| Vertrag | Stand |
|---|---|
| G1 Strukturleser | eine Klasse neben `ContentResolver`, ohne Person und ohne Berechtigung |
| G2 Anzeigefreigabe | je Kompositionsfassung, mit Bearbeiter und Zeitpunkt, unabhängig von `bereit` |
| G3 Inhaltsart | konfigurierbare Werte, setzen ändert `kind` und `output_class` nicht |
| G4 Anzeigefelder | ein Titel und eine Kurzbeschreibung für die Bibliothek, mit Protokoll |
| G5 Dimensionen | stabile Kennungen, Säulen behalten ihre Identität, direkt und abgeleitet bleiben unterscheidbar |
| G6 Bildableitung | ein Queue-Auftrag, geschützte Ablage unter `vorschau/` |
| G7 Abdeckungsbefund | lesbar vor der Aktivierung |
| G8 aktive Angebotsfassung | eine aktive Fassung, bei Alt-Dubletten die höchste Nummer |
| G9 Instanz-Suite | nicht gebaut |
| E-W12 | Lernziel, Zeitbedarf und Materialbedarf an der Kompositionsfassung; eine Änderung erzeugt eine neue Fassung |
## Zusatz 1: Mitgliederbereich
Der Kursraum ist eine eigene Oberfläche, nicht die Verwaltungsoptik. Überschriften, Suche, Säulenfilter, Verfügbarkeit und die Karten sprechen von Programmen, Modulen und Material. Die untere Navigation führt zu Bibliothek, Programmen, Modulen, Material und Lizenzen.
Die Gestaltung wurde auf der Testinstanz in 390, 768 und 1440 Pixel geprüft. Nach dem Player-Fix wurde die Seite von Programm Abstand erneut bei 390 Pixel geprüft: kein horizontaler Überlauf, der Film lädt. Markenwerte, die nicht freigegeben sind, wurden nicht erfunden. Die Programmkarte zeigt den Platzhalter, weil für dieses Programm kein eigenes Vorschaubild hochgeladen wurde. Das abgeleitete Bild von „Lara im Park“ liegt am Medium.
## Zusatz 2: Fachliche Inhaltsverwaltung
Die Redaktion arbeitet weiter unter `/verwaltung`. Die Navigation heißt Medien, Fachliche Kombinationen, Module, Programme, Fachliche Säulen, Lizenzartikel, Pakete, Rechteprofile und Angebote. Die Programmliste erklärt: „Ein Programm aus Modulen und weiteren Inhalten.“ Die gespeicherte Art bleibt Kurs, Übung oder Kombination. Die Maske nennt das Feld Zusammenstellung.
Auf der Testinstanz wurde der folgende Weg durch die Oberfläche angelegt und danach erneut geöffnet:
| Schritt | Ergebnis |
|---|---|
| Trainerunterlage Abstand | Text, Fassung 1: „Im Kurs zuerst den Abstand ansprechen, dann das Blatt austeilen.“ |
| Modul Abstand | Unterlage plus Film „Lara im Park“, Fassung 1, Lernziel, 15 Minuten, zur Anzeige freigegeben |
| Modul Hilfe | dieselbe Unterlage, Fassung 1, Lernziel, 10 Minuten, freigegeben |
| Programm Abstand | beide Module in dieser Reihenfolge, Lernziel, 25 Minuten, Gliederung sichtbar, freigegeben |
| Lizenzartikel | `abstand-trainer`, Stand 1, Wurzel ist die Programmfassung |
| Rechteprofil | „Abstand ansehen“: Film streamen, Dokument ansehen, Text ansehen |
| Angebot | Testangebot Abstand, auf Abruf, Abdeckung gegen die Programmfassung |
| Trainer | Abruf in die Bibliothek, Programm nutzbar |
Ein neues Vorschaubild an einer Zusammenstellung geht über die Queue nach `derived/vorschau/` und erzeugt keine neue Fassung.
## Was auf der Testinstanz geprüft wurde
Angemeldet als Prüftrainer:
- Die Bibliothek zeigt nur Programm Abstand, Status Nutzbar.
- Die Programmseite zeigt Lernziel, beide Module, die Unterlage und den Film.
- Der Film spielt über hls.js. Bild 854×480, Wiedergabe bereit. Die Master-Playlist verweist auf die Stufen 480, 720 und 1080. Die Signatur gilt für diese Ausgabe.
- Die Unterlage zeigt den Text, die Zeile „Lizenziert für …“ mit Lizenzkopie und die Kennzeichnung „ehrenamtlich“.
Angemeldet in der Verwaltung:
- Die Programmliste enthält nur Programm Abstand und den fachlichen Erklärungssatz.
Die Ableitung von „Lara im Park“ wurde nach dem Deploy in die Queue gegeben. Vorschaubild und die vier Playlist-Zeilen (480, 720, 1080, Master) liegen vor. Der Auftrag ist ohne Fehlereintrag durchgelaufen. Die Quelldatei bleibt unter `derived/` liegen.
## Offen gegenüber dem Plan
Tor B ist nicht bestanden. Der Plan verlangt auf der Testinstanz, vollständig und nicht nur soweit die Suite es an Wegwerfdaten zeigt:
- zwei freigegebene Programme, gemeinsamer Film, gemeinsames PDF, unterschiedliche Rollen
- eine nur bereite Programmfassung mit demselben Film bleibt unsichtbar
- eine Person mit nur einem Modul, eine mit allen Teilen über getrennte Artikel, eine ohne Grant
- Stream nur für die berechtigte Person; Laden des Films scheitert ohne dieses Recht
- Ansehen und Laden eines PDF sind getrennt
- das teilweise Programm ist gekennzeichnet; das vollständige Programm erzeugt keinen zusätzlichen Erwerb
- die Materialliste zeigt das gemeinsame PDF einmal
- Umbenennung ohne neue Fassung, die gespeicherte Bestellbezeichnung bleibt
- Filter und direkte Themen an Modul und Programm
- Thumbnail nicht über die öffentliche Route
- Abdeckungsverweigerung und dieselbe Struktur in der Vorschau
- genau eine aktive Angebotsfassung, auch im Parallelfall
Diese Fälle sind in der lokalen Suite einzeln vorhanden. Auf der Instanz liegt ein Programm, eine Textunterlage und ein Film. Eine PDF-Datei im Testmedienbestand fehlt. Eine wiederholbare HTTP-Suite gegen `luf-test` fehlt.
Weitere Lücken im Pakettext:
- Vorschaubild eines Films: erstes Bild, keine wählbare Zeitposition und keine Vorschau genau dieser Position.
- Originale liegen nicht getrennt unter `originals/`. Neue und vorhandene Dateien bleiben in `derived/`. Die Kennzeichnung hängt daran nicht.
## Zurückgestellt
Automatische Denkpause, Ablaufsteuerung, Präsentationsmodus, Fortschritt, zweites Gerät. `decision_seconds` bleibt gespeichert und steuert die Bibliothek nicht.
Organisationslizenzen, Community, echter Zahlungsdienst, kundeneigene Paketkonfiguratoren, konkrete Preise und Tarife. Der Testkaufpreis aus dem früheren Demokatalog ist keine Preisentscheidung; dieser Katalog ist auf der Testinstanz entfernt.
Designsystem, öffentliche Objektseiten und der Neubau des CMS. Die vorhandenen öffentlichen Seiten und die veröffentlichten Säulen unter `/themen` bleiben. W-P wird nicht in die Verwaltung übernommen.
## Zugang zur Prüfung
Nur die Testinstanz, Adresse `http://192.168.2.144:3011`.
- Trainer: `/anmelden`, Konto `trainer-pruefung@example.test`, das bereits mitgeteilte Prüfkennwort. Bibliothek, Programm Abstand, Film und Unterlage.
- Redaktion: `/verwaltung`, Konto `redaktion-pruefung@example.test`, das bereits mitgeteilte Prüfkennwort und der bestehende Authenticator. Rollen Redaktion und Katalog.
## Commits auf `develop`, die diesen Stand tragen
| Commit | Inhalt |
|---|---|
| `7820bec` | Paket 1 |
| `1a2b129` | Paket 2 |
| `5ed01b9`, `fc08e6d`, `7b54c38` | Paket 3, Bibliothek, Anzeigefreigabe |
| `5e763d1` | Pakete 4 bis 7 und der Ausgabenachweis |
| `c99a957` | Nutzbarkeit, Didaktik, öffentliche Programmfassung |
| `1d8315c`, `9b52181` | Kursraum |
| `d6ff881` | fachliche Inhaltsverwaltung |
| `c997eb5`, `295f784` | geschützte Vorschaubilder und Filmstufen |
| `57802df` | Programmvorschau über die Queue, kein erneutes Seeden |
| `30833f6` | HLS über hls.js, wenn der Browser die Fähigkeit nur behauptet |
## Empfehlung
Die fachliche Erprobung des Abstand-Programms kann sofort auf der Testinstanz stattfinden. Eine Aussage „MVP abgenommen“ oder „kommerziell freigegeben“ setzt den fehlenden Tor-B-Lauf voraus, einschließlich einer echten PDF-Datei und der zweiten Programmfassung mit getrennten Personen.
@@ -0,0 +1,315 @@
# Abschlussbericht: Adaptive Widgets und Premium-Design v1.6
Stand: 18.11.2026.
- Branch: `feature/adaptive-widgets`, abgezweigt vom Stand `feature/design-iteration-1` einschließlich der beiden Doku-Commits von Lars.
- Per Fast-Forward auf `develop` übernommen und über `deploy-test.yml` auf der Testinstanz bereitgestellt.
- **Kein Merge nach `main`.** `develop` liegt 73 Commits vor `main`.
| Schritt | Stand |
|---|---|
| Commit Umsetzung | `0bfb534` |
| CI Feature-Branch | Lauf 4834 grün |
| Deploy Testinstanz | Lauf 4835 erfolgreich, `/up` 200 |
| Bericht | dieser Commit |
Entscheidung: ADR-38 im zentralen Protokoll. Technische Dokumentation:
- `docs/architektur/cms-widget-registry.md` §§2–4, 8, 9, 12
- `docs/architektur/designsystem.md` §13
## 1. Grundlage und Abweichungen vom Kit
Grundlage war der Repository-Stand `docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`: Komponenten, CSS, `layout-profiles.json`, Registry-Hinweise, Beispiele und Referenzscreenshots. Die Ordner 07–12 sind im Repository nicht versioniert (untracked). Übernommen wurden Code und CSS, angepasst an die tatsächliche Struktur. Die Kit-Ordner selbst wurden nicht eingecheckt.
| Kit v1.6 | Umsetzung | Grund |
|---|---|---|
| Kennungen `lf-brand-hero`, `lf-editorial-bild-text` | bestehende Kennungen `hero` und `image_text` als kompatible Weiterentwicklung | Kennungen und Revisionen bleiben erhalten |
| Varianten `photo-split`, `editorial-solid` | `photo_split`, `editorial_solid` | Variantenkennungen der Registry: `^[a-z][a-z0-9_]*$` |
| `settings.image_side` | Variante `image_left` / `image_right` | keine doppelte Einstellung |
| `settings.image_focus {x,y}` | `data.focus_x`, `data.focus_y` (0–100) | `settings` trägt nur Aufzählungswerte |
| Überschriftenebene H1/H2/H3 frei | „Automatisch“ (erstes Widget der Seite = H1), H2, H3 | Regel „genau eine H1 je Seite“; Widerspruch nicht still aufgelöst, sondern dokumentiert |
| Linkziele nur `https`, Pfad, Anker | bestehende `SafeUrl`-Regel (zusätzlich `http`) | Repository-Regel gilt |
| Einstiegsbild immer sofort laden | nur das erste Widget der Seite sofort, alle anderen verzögert | bestehende Ladeprioritäten |
| CSS v1.6 | übernommen nach `resources/css/components/lf-hero.css` und `lf-bild-text.css` | zusätzlich: Überschriften erben Farbe (globale h1–h3-Regeln), Unterstreichung als Block, Fläche „clear“ übernimmt die Farben dunkler Abschnitte, Strahlen-Akzent, Fokusfarbe aus den Tokens |
Das frühere Hero- und Bild-und-Text-CSS sowie der Randlos-Mechanismus der Designiteration 1 sind entfernt. Es laden keine alten und neuen Stylesheets parallel.
## 2. Gemeinsamer Layoutmechanismus (ADR-38)
In der bestehenden Registry (`WidgetType`) erklärt jede Art:
- **zulässige Rasterbreiten** (`supportedUnits()`); die Mindestbreite ist daraus abgeleitet;
- **Höhen** aus einem gemeinsamen Vokabular (`auto`, `compact`, `normal`, `large`, `spacious`, `fill`). Sie werden als `settings.height` gespeichert und wie jede Einstellung geprüft;
- **Darstellungsmodi** (`stages()`) und das **Verhalten bei wenig Platz** (`narrowBehavior()`).
Wirkung:
- Ein Platz mit nicht unterstützter Breite wird beim Speichern abgewiesen: „… ist für Plätze mit 3 oder 4 Rastereinheiten vorgesehen; dieser Platz hat 2“.
- Der Platzkopf im Editor warnt vorher, und die Widget-Auswahl nennt die zulässigen Breiten.
- Die Höhe erscheint als Klasse `widget-height-*` an der Hülle.
- Die Ansichten reagieren über Container-Abfragen auf die tatsächliche Breite.
- Es gibt keine zweite Registry, kein zweites Abschnittsmodell und keine Migration.
| Widget | Breiten | Höhen |
|---|---|---|
| Einstieg (Hero) | 3, 4 | compact (mind. 400 px), normal (512 px), large (640 px) |
| Bild und Text | 1–4 | compact, normal, spacious |
| Handlungsaufruf | 1–4 | auto, fill (gleich hoch wie die Nachbarplätze) |
| Überschrift, Fließtext, Karten, Programmkarten | 1–4 | – (nach Inhalt) |
| FAQ | 2–4 | – |
Die Gestaltung der Bestandswidgets bleibt unverändert. Für schmale Plätze kamen hinzu:
- Umbruch langer Wörter und Adressen;
- Schaltflächen mit `overflow-wrap`, `max-width: 100 %` und mittig ausgerichtetem Text.
## 3. Premium-Widgets
**Einstieg (`hero` Version 2):**
- Varianten „Foto mit Textfläche“ und „Markenfläche“.
- Drei Höhen, Label, Überschrift und Ebene, Beschreibung, Bild aus dem öffentlichen Medienbereich (Auswahl oder Hochladen).
- Bildfokus (zwei Schieberegler) und Alternativtext.
- Zwei Schaltflächen und ein Akzent: Unterstreichung, Unterstreichung mit Signalstrahlen oder keiner.
- Ab 860 px Containerbreite die Komposition aus dem Kit, darunter der technische Sicherheitsumbruch (Foto 16:9 über dem Text).
**Bild und Text (`image_text` Version 3):**
- Fläche creme, ohne eigene Fläche oder navy.
- Bild links oder rechts, drei Höhen, Label, Überschrift und Ebene.
- Formatierter Text (bereinigt), Bild, Fokus, Alternativtext, zwei Schaltflächen.
- Darstellung nach Containerbreite:
| Containerbreite | Darstellung |
|---|---|
| unter 540 px | gestapelt |
| 540–899 px | flacher Bildstreifen |
| ab 900 px | zweispaltig |
Die Grenzwerte aus dem Kit haben sich im CMS bewährt und sind unverändert.
**Bestehende Daten:**
- `hero` Version 1 wird beim Lesen angehoben: `standard`/`stage` → `photo_split`, `highlight`/`editorial` → `editorial_solid`. Der Fokuspunkt wird in Prozent umgerechnet, und nicht mehr vorhandene Einstellungen entfallen.
- `image_text` Version 2 wird ebenso angehoben: Bildformat entfällt, Fokus in Prozent.
- Gespeicherte Revisionen bleiben unverändert. Die data-Schlüssel sind gleich geblieben, damit ein Code-Rollback darstellbar bleibt (siehe `cms-widget-registry.md` §9).
## 4. Editor
- **Bearbeitungsdialog:** Reiter **Inhalt**, **Medien** und **Darstellung**, generisch aus der Registry.
- Varianten und Höhen sind Auswahlknöpfe mit Symbol.
- Der Bildfokus wird mit Schiebereglern eingestellt.
- Weitere Darstellungsparameter sind Auswahllisten mit dem Hinweis „Vorgabe der Darstellung“.
- Der Reiter Darstellung nennt die zulässigen Platzbreiten und das Verhalten bei wenig Platz.
- **Live-Vorschau im Dialog:**
- Derselbe Renderer wie die Website, in wählbarer Platzbreite: Smartphone 390 px oder die zulässigen Einheiten mit 310, 640, 960 bzw. 1300 px.
- Verkleinert auf die Dialogbreite; Änderungen erscheinen sofort.
- **Abschnitts- und Widget-Einstellungen sind getrennt:**
- Abschnitt: Raster, Hintergrund, Breite, Abstand, Trenner.
- Widget: Anordnung, Fläche, Höhe, Bild, Fokus, Texte, Schaltflächen, Akzent.
## 5. Tests und praktische Abnahme
| Prüfung | Ergebnis |
|---|---|
| `php artisan test` | 199 Tests grün |
| Pint (Code-Pfade) | sauber |
| Build | erfolgreich (Nunito 900 zusätzlich lokal ausgeliefert) |
| CI | 4834 grün |
| Deploy | 4835 erfolgreich |
| 12 bestehende öffentliche Seiten (Status, Titel, Text) vor und nach dem Deploy | unverändert |
| Szenario 1: `/designreferenz`, `/praevention-im-alltag`, `/referenz-abschnitte`, `/t1-landingpage` im Editor geöffnet und unverändert gespeichert | 4/4 ohne Fehler |
| Redaktionsablauf auf Test (`/premium-referenz`, über die Oberfläche) | 16 von 18 Prüfungen im Skript bestanden; die beiden Abweichungen sind Prüffehler, nicht Anwendungsfehler (siehe unten) |
| Matrix lokal (`/pruefmatrix`, mit Kit-Motiven) und auf Test (`/premium-referenz`), 390/768/1200/1440/1920 px | kein seitlicher Überlauf, kein abgeschnittener Text oder Button, genau eine H1 |
| Rahmen (Kopfzeile, Menü, Tastatur, CLS, Bewegung reduzieren) auf Test | 18/18 |
**Neue Tests in der Suite:**
- `CmsPremiumWidgetsTest`: Upgrades, Varianten, Höhen, Akzente, Fläche, Sanitizing, unsichere Links, Fokusgrenzen, alle Widgets in jeder zulässigen bzw. unzulässigen Breite, Höhe „fill“.
- Editortest: Premium-Einstieg mit Höhe, Ebene, Akzent, Fokus und zwei Schaltflächen speichern und veröffentlichen; Dialogfelder und Live-Vorschau.
- Registry-Tests zum Layoutvertrag.
**Bewusst angepasste Tests:**
- Einstieg braucht 3 oder 4 statt mindestens 2 Einheiten.
- `image_text` ist Version 3.
- Klassen der neuen Ansichten.
- Die Hero- und Bild-Tests der Designiteration 1 sind ersetzt.
**Redaktionsablauf auf der Testinstanz (Szenarien 2–11):**
- Angelegt über die Oberfläche: Einstieg in 4/4 (groß, normal) und 3/4 (kompakt, Markenfläche, H3, lange Überschrift und Schaltfläche), Aufruf mit voller Höhe, Bild und Text in 4/4, 3/4, 2/4 und 1/4 mit allen Höhen und Flächen, gemischt mit Überschrift, Fließtext und Karten.
- Danach im Editor geändert: Überschrift, Beschriftung, Höhe und Fokus.
- Die Live-Vorschau zeigt Höhe, Fokus (80/30 %) und Text sofort.
- Die Smartphone-Breite zeigt den Sicherheitsumbruch.
- Veröffentlicht; die öffentliche Seite zeigt alle Änderungen.
**Die zwei Abweichungen im Skript:**
- Es erwartete 15 Widgets; angelegt waren 13. Die Zahl im Skript war falsch.
- Der Vergleich Vorschau gegen öffentliche Seite meldete einen Unterschied. Das genaue Diff zeigt als einzigen Unterschied den beabsichtigten Vorschauhinweis „Vorschau einer unveröffentlichten Revision“. Das Markup der Widgets ist identisch.
**Bilder:**
- Lokal wurden die Kit-Motive (`09_hero_widget/assets/lara-felix-park-hero.webp`, `10_bild_text_widget/assets/lara-felix-park.webp`) für den Sichtvergleich mit den Kit-Screenshots verwendet; die Darstellung entspricht ihnen.
- Auf der Testinstanz stehen gekennzeichnete Platzhalter. Begründung: Alles, was im Editor gespeichert wird, ist über `/medien/cms/…` öffentlich abrufbar, und die öffentliche Bildverwendung ist laut Kit nicht freigegeben.
**Screenshots** (Testinstanz, Platzhalter) unter `docs/analysen/adaptive-widgets-screenshots/`:
- Referenzseite bei 1440, 768 und 390 px
- Dialog „Darstellung“
- Live-Vorschau bei 390 und 1300 px
## 6. Verbleibende Einschränkungen
- **Kit-Dateien verändert (mein Fehler):**
- Ein Pint-Lauf ohne Pfadangabe hat vier untracked PHP-Beispieldateien im Kit umformatiert (nur Leerraum und Klammern):
- `11_bild_text_widget_v1.5/laravel/app/Support/LfBildTextPayload.php`
- `11_bild_text_widget_v1.5/laravel/examples/registry-adapter.example.php`
- `11_bild_text_widget_v1.5/laravel/tests/LfBildTextPayloadTest.php`
- `12_premium_widgets_adaptiv_v1.6/laravel/app/Support/LfBildTextPayload.php`
- Die übrigen 112 Kit-Dateien sind bytegleich mit dem Archiv.
- Das Zurückschreiben aus `Downloads/Lara_Felix_Brand_UI_Kit_v1.6_Adaptive_Premium_Widgets.zip` wurde von der Rechteprüfung blockiert. Bitte diese vier Dateien aus dem Archiv wiederherstellen.
- **Freigaben:** Die öffentliche Verwendung der Lara-&-Felix-Motive ist nicht freigegeben. Die Testseiten zeigen deshalb Platzhalter.
- **Validierungsmeldungen auf Englisch:** Es gibt kein deutsches Sprachpaket (`lang/de` fehlt), zum Beispiel „The … field is required when … is present“. Das betrifft die ganze Anwendung.
- **Livewire-Timing:** Werden Felder schneller ausgefüllt, als die Live-Aktualisierung zurückkommt (unter etwa 0,5 s, nur bei automatischer Eingabe beobachtet), kann ein gerade verlassenes Feld überschrieben werden. Bei menschlichem Tempo trat das nicht auf.
- **Eingeklappter Abschnitt bei der Neuanlage:** „Seite und Suchmaschinen“ bleibt nach dem Bearbeiten einer Seite auch beim Anlegen eingeklappt, weil Filament den Zustand merkt. Das Verhalten stammt aus Iteration 2.
- **Vorschau im Platz:** Sie ist über 28 rem gekürzt; der Einstieg wird dort beschnitten. Vollständig zeigen ihn die Live-Vorschau im Dialog und die Seitenvorschau.
- **Keine responsiven Bildvarianten:** `srcset` fehlt; die Ableitungen gehören in die Hintergrundverarbeitung.
- **Code-Rollback auf die Designiteration:** Ältere Software stellt `hero` v2 und `image_text` v3 „bestmöglich“ dar, kann sie aber nicht speichern (§9 der Registry-Dokumentation).
- **Größe der Repository-Historie:** Mit dem Fast-Forward sind Lars' Commits `5dccbbc` und `3cdb36e` auf `develop` gelandet. Sie enthalten die Kit-Originalbilder und das Kit-ZIP (27,7 MB) in der Historie. Das ZIP ist in `3cdb36e` wieder entfernt, bleibt aber in der Historie.
- **UX-Abnahme:** Die Bedienung durch den Betreiber steht aus (ADR-38 „UX-Abnahme offen“).
## 7. Auf der Testinstanz angelegt
- Seite `/premium-referenz` (veröffentlicht), mit Platzhalterbildern `cms/platzhalter-*` (Dateinamen mit Zufallssuffix).
- Neue Entwurfsrevisionen (nicht veröffentlicht) auf `/designreferenz`, `/praevention-im-alltag`, `/referenz-abschnitte` und `/t1-landingpage` aus dem Speichertest. Die veröffentlichten Stände sind unverändert.
## 8. Nachprüfung vom 18.11.2026 (Seitenliste, Abstand oben, Wortmarke)
Branch `feature/cms-liste-logo-abstand`, Commit `89fd95b`; CI 4838, Deploy 4839 auf der Testinstanz. Gearbeitet wurde in einem separaten Worktree; der offene Branch `designkit` und das Arbeitsverzeichnis wurden nicht verändert.
### Befund zu `/premium-referenz`
`/premium-referenz` war und ist ein **regulärer CMS-Seitendatensatz**:
| Merkmal | Wert |
|---|---|
| Tabelle und Kennung | `pages`, Kennung 17 |
| Bearbeitungsadresse | `/verwaltung/pages/17/edit` |
| Inhalt | 7 Abschnitte, 13 Widgets, mehrere Revisionen |
| Öffentliche Auslieferung | über die normale Seitenroute (`PageController`) |
Es gibt keine Sonderroute, keine Testimplementierung und keine andere Datenquelle. Angelegt wurde die Seite tatsächlich über die Editoroberfläche; diese Aussage des Berichts stimmt. Unvollständig war sie in einem Punkt: Ohne Suche war die Seite nicht zu finden.
**Ursache:**
- Die Seitenliste hatte keine Sortierung und zeigte 10 Einträge je Seite in Anlagereihenfolge.
- Die zuletzt angelegte Seite stand deshalb auf Listenseite 2 von 2.
- Die Spalte „Geändert“ zeigte das Anlagedatum in UTC, weil gespeicherte Revisionen die Seite nicht als geändert markierten.
- Filter, Status, Berechtigungen, Seitentyp oder eine Bereichszuordnung spielten keine Rolle; die Liste hat keine Filter.
**Behoben:**
- Die Liste zeigt die zuletzt bearbeiteten Seiten zuerst; Pfad und Datum sind sortierbar.
- Je Seite stehen 25, 50 oder 100 Einträge.
- Die Spalte heißt „Zuletzt bearbeitet“ und zeigt deutsche Zeit.
- Jede gespeicherte Revision und jede Veröffentlichung aktualisiert die Seite.
**Geprüfter Weg auf der Testinstanz** (Skript über die normale Oberfläche, ohne direkte Datenbankänderung und ohne Hilfsrouten):
1. Anmeldung mit dem Prüfkonto.
2. Verwaltung → Seitenleiste „Seiten“. `/premium-referenz` steht in Zeile 1, ohne Suche.
3. Klick auf die Zeile → `/verwaltung/pages/17/edit`.
4. Alle 13 Widgets nacheinander über „Bearbeiten“ geöffnet und ein Textfeld geändert: Einstieg (3), Handlungsaufruf, Bild und Text (6), Fließtext, Überschrift und Einleitung, Redaktionelle Karten.
5. Erster Abschnitt: „Gestaltung des Abschnitts“ → „Abstand oben: Kein Abstand“.
6. „Entwurf speichern“ → Meldung „Entwurf gespeichert“.
7. „Vorschau“ zeigt alle 13 Änderungen und den Abstand.
8. „Veröffentlichen“ → die öffentliche Seite zeigt alle 13 Änderungen und den Abstand.
9. Dasselbe Vorgehen für `/praevention-im-alltag` (Zeile 3, `/verwaltung/pages/9/edit`), dort „Abstand oben: Gering“.
Ergebnis: 22 von 22 Prüfungen, keine Konsolenfehler. Ein zweiter Durchlauf hat die Prüfmarken in den Texten über die Oberfläche wieder entfernt (ebenfalls 22/22).
### Abstand zwischen Kopfzeile und erstem Abschnitt
- Bisher ließ sich der Abstand oben nur über „Abstand oben und unten“ verkleinern, und zwar auf höchstens „Kompakt“ (etwa 24–48 px), nie auf null.
- Neu ist in der Abschnittsgestaltung „Abstand oben“ mit drei Werten:
- „Wie ‚Abstand oben und unten‘“ (Vorgabe)
- „Gering“ (etwa 12–20 px)
- „Kein Abstand“
- Gespeichert wird der Wert als `style.spacing_top`. Er wirkt nur auf den gewählten Abschnitt und nur oben.
- Der Abstand unten und alle anderen Abschnitte bleiben unverändert. Es gibt keine globale Regel und keine Änderung an bestehenden Seiten, solange niemand die Einstellung wählt.
### Wortmarke in Kopfzeile und Fußbereich
- **Quelle:** `docs/Brand-UI-Kit/08_freigegebene_logovarianten/logo_lara_felix_kompakt.png`, gelesen aus Lars' lokalem Commit `1223dc8` (Branch `designkit`), weil die Kit-Ordner im Arbeitsverzeichnis fehlen.
- **Freistellung:** Die Datei hat entgegen der Kit-README einen transparenten Hintergrund. Auf Weiß und auf Navy wirkt sie sauber, das ist im Browser geprüft. Die Standardfassung ist größtenteils halbtransparent und wird nicht verwendet.
- **Eingebunden:** zugeschnittene WebP-Ableitungen `public/images/brand/lara-felix-logo-kompakt-128.webp` und `-256.webp` (1x/2x). Die Originaldatei bleibt unverändert.
- **Größen:**
| Ort | Logohöhe |
|---|---|
| Kopfzeile, Ausgangszustand | etwa 80 px (Box unverändert 104 px) |
| Kopfzeile, kompakt beim Scrollen | 60 px in der 72-px-Leiste |
| Smartphone | 48 px |
| Fußbereich | 72 px |
- **Stabilität:** Breite und Höhe stehen im Markup; die Navigation misst dadurch schon vor dem Laden des Bildes richtig.
- **Mitgliederbereich:** unverändert (Schriftzug).
- **Prüfung auf der Testinstanz:**
- Kopfzeile 18/18.
- Fünf Seiten bei 1920/1440/1366/1280/390 px: je Breite eine Höhe sowie eine Wortmarken- und Navigationsposition.
- Erster Frame ohne Layoutverschiebung (CLS 0).
**Abnahme-Screenshots** (Testinstanz) unter `docs/analysen/adaptive-widgets-screenshots/`:
- `07`–`09`: `/premium-referenz` bei 1440 px (Ausgangszustand und kompakt) und bei 390 px
- `10`, `11`: `/praevention-im-alltag` bei 1440 und 390 px
- `12`, `13`: `/praevention` bei 1440 und 390 px
- `14`: Seitenkonfigurator, Seite 17
- `15`: Abschnittsgestaltung mit „Abstand oben“
**Tests:**
- 203 grün; neu ist `CmsPageListAndSpacingTest` (Sortierung der Liste, Bearbeitungsdatum, Abstand oben, Aufzählungsprüfung).
- Bewusst angepasst: Erwartung an die Wortmarke (`brand-logo` statt `brand-lockup`).
**Offen:**
- Eine Vektorfassung der Wortmarke fehlt; die Rasterfassung ist für die gezeigten Größen scharf (2x-Ableitung).
- Bitte die Wortmarke in Kopf- und Fußbereich visuell abnehmen.
## 9. Korrektur: Abschnittsabstände vereinfacht (18.11.2026)
Branch `feature/abschnittsabstaende`, Commit `f511ad1`; CI 4842, Deploy 4843 auf `develop`, gearbeitet in einem separaten Worktree. Kein Merge nach `main`.
**Ersetzt** wurden:
- „Abstand oben und unten“,
- die Abweichung „Abstand oben“,
- die versteckte Regel, die oben zwischen zwei Abschnitten ohne Fläche auf null setzte,
- der Trenner „Zusätzlicher Abstand“.
**Neu** sind genau drei unabhängige Einstellungen: **Abstand oben**, **Abstand unten** und **Widget-Abstand**, jeweils mit den Stufen Kein Abstand, Kompakt, Normal und Großzügig. Gespeichert werden sie in der Abschnittshülle Version 2; Einzelheiten stehen in `cms-widget-registry.md` §11.
**Bestehende Seiten:** Hüllen der Version 1 werden beim Lesen übersetzt.
| Seite | Breiten | Ergebnis vor und nach dem Deploy |
|---|---|---|
| `/`, `/praevention`, `/designreferenz`, `/referenz-abschnitte`, `/premium-referenz`, `/t1-landingpage` | 1440 und 390 px | pixelgleich: Seitenhöhe, Lage jedes Abschnitts und Rasters, Innenabstände, Rasterabstände, Platzpositionen |
| `/praevention-im-alltag` | 1440 und 390 px | erster Abschnitt oben +24,5 px bzw. +12 px, weil „Gering“ jetzt „Kompakt“ ist (gewollte Folge der vier Stufen) |
**Prüfung über den regulären Seitenkonfigurator:**
- Angelegt wurde `/abstand-pruefung` (Seite 18) mit aufeinanderfolgenden Abschnitten:
| Abschnitt | Raster | oben / unten / Widget-Abstand |
|---|---|---|
| 1 | 4/4 | 0 / 0 / 0 |
| 2 | 3:1 | 0 / 0 / 0 |
| 3 | 4/4 | Kompakt / Normal / Normal |
| 4 | 3:1 | Großzügig / 0 / Großzügig |
| 5 | 3:1 | 0 / Kompakt / Kompakt |
- Die Gestaltung zeigt genau die drei Felder, „Abstand oben und unten“ gibt es nicht mehr.
- Berechnete CSS-Werte (26 von 26 Prüfungen):
| Prüfung | 1440 px | 390 px |
|---|---|---|
| Stufen oben/unten (Kompakt / Normal / Großzügig) | 44,8 / 89,6 / 120 px | 24 / 48 / 72 px |
| Stufen Widget-Abstand (Kompakt / Normal / Großzügig) | 18 / 36 / 56 px | 12 / 20 / 32 px |
| Innenabstände und Rasterabstand je Abschnitt | wie eingestellt, Außenabstand jeweils 0 | wie eingestellt, Außenabstand jeweils 0 |
| Inhalt 1 → 2 (0 + 0) | 0,0 px | 0,0 px |
| Inhalt 2 → 3 (0 + Kompakt) | 44,8 px | 24 px |
| Inhalt 3 → 4 (Normal + Großzügig) | 209,6 px | 120 px |
| Inhalt 4 → 5 (0 + 0) | 0,0 px | 0,0 px |
| Widget-Abstand 3:1 | nebeneinander 0 / 56 / 18 px | gestapelt 0 / 32 / 12 px |
**Tests:** 204 grün.
- Neu:
- Addition und Vorgaben,
- Übersetzung aller Fälle der Version 1 (Abweichung, versteckte Regel, eigene Fläche, Linientrenner, leerer Abschnitt, Zusatzabstand),
- Abweisung freier Werte für alle drei Felder.
- Bewusst angepasst: Hüllenversion 2, neue Klassen, Prüfung freier Werte über die neuen Schlüssel.
**Vorgabe für neue Abschnitte:** oben und unten Kompakt, Widget-Abstand Normal. Damit bleibt der Abstand zwischen zwei neuen Abschnitten so groß wie bisher, und ein neuer erster Abschnitt beginnt näher an der Kopfzeile als vorher.
Binary file not shown.

After

Width:  |  Height:  |  Size: 260 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 362 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 257 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 91 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 89 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 102 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 68 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 99 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 100 KiB

@@ -0,0 +1,77 @@
# Einheitliche Medienverwaltung im CMS – Bericht
Branch `feature/cms-medienverwaltung`, Commits `7c63424` (Website-Ableitung) und `053a8d4` (Umstellung). Gearbeitet wurde in einem separaten Worktree, der Deploy lief über `develop` (CI 4859, Deploy 4860). Kein Merge nach `main`.
- Entscheidung: ADR-40.
- Technik: `docs/architektur/medienzugriff-fuer-komponenten.md`, Abschnitt „Umsetzung im CMS“, und `cms-widget-registry.md` §§ 7 und 9.
## 1. Ergebnis
**Bildstellen:**
- Alle Bildstellen des CMS verwenden den zentralen Medienbestand: Einstieg (Hero), Bild und Text, redaktionelle Karten, Premium-Karten (Kartenbild) und Abschnittshintergrund.
- Gespeichert wird die Kennung des Mediums, nicht ein Pfad.
- Öffentlich erscheint ein Bild nur mit Website-Freigabe (`WebsiteMedia`, Route `website.media`).
- Die CMS-eigene Bildauswahl entfällt.
**Im Widget-Dialog** (Reiter „Medien“, beim Abschnitt „Gestaltung“):
| Funktion | Verhalten |
|---|---|
| Auswahl | Alle Bilder des Medienmanagers, durchsuchbar, mit Vorschaubild, Titel und Website-Status (freigegeben, nicht freigegeben, wird verarbeitet) |
| Neues Bild hochladen | Das Bild wird sofort im Medienmanager angelegt (`WebsiteIntake`) und ausgewählt. Nach der Verarbeitung gibt die Warteschlange es automatisch für die Website frei. |
| Gewähltes Bild | Vorschaubild, Status mit Begründung und „Im Medienmanager öffnen“ (dort steht die Website-Freigabe) |
| Austauschen | Ein anderes Bild in der Auswahl wählen; Bildausschnitt und Darstellung bleiben im Widget |
| Alternativtext | Kommt aus dem Medium. Das Feld im Widget ist eine optionale Abweichung. |
**Medienmanager:** Die Medienansicht nennt jetzt die Website-Seiten, die das Bild verwenden. Beim Zurücknehmen der Freigabe weist sie darauf hin, dass das Bild dort verschwindet.
**Nicht freigegeben:** Öffentlich entfällt nur das Bild; Überschrift, Text und Schaltflächen des Widgets bleiben. Die Redaktionsvorschau zeigt das Vorschaubild mit dem Hinweis, warum es öffentlich nicht erscheint und wo die Freigabe steht.
**Website-Ableitung:** Bilder werden bis 2400 px breit abgeleitet statt in 640 px Vorschaugröße und nie vergrößert. Transparente Flächen werden weiß. Filmstandbilder bleiben bei 640 px. Diese Änderung betrifft Lars' `ThumbnailDeriver` und liegt deshalb in einem eigenen Commit.
## 2. Übernahme der Bestandsmedien (Testinstanz)
Der Job `ImportCmsImages` wurde beim Deploy von einer Migration angestoßen und von der Warteschlange ausgeführt. Ergebnis, lesend geprüft:
- **21 frühere Bilddateien** unter `cms/`, bytegleich zusammengefasst zu **9 Medien**: Felix und die Einkäufe (Intro), Lara Felix Park (Original), Platzhalter Bild Text, Platzhalter Karte 1, 2 und 3, Platzhalter Markenbühne, Prüfbild, Testplatzhalter Hintergrund.
- Alle 9 Medien sind abgeleitet und freigegeben. Es gibt keine offenen und keine fehlgeschlagenen Jobs.
- Gelöscht wurde nichts. Die Dateien unter `cms/` und alle Revisionen bleiben unverändert.
- Frühere Pfade gelten über `website_media_aliases` als das jeweilige Medium. Beim nächsten Speichern wird die Kennung eingetragen.
## 3. Prüfung
| Prüfung | Ergebnis |
|---|---|
| Testsuite | 245 grün, davon neu: 8 Tests für die Medienanbindung und 2 für die Ableitungsgröße. Bewusst geändert: Die Alt-Text-Pflicht im Widget entfällt, weil der Alternativtext zum Medium gehört. |
| Bestehende Seiten vor und nach Deploy und Übernahme | Geometrie unverändert (16 Messungen: 8 Seiten bei 1440 und 390 px), Texte unverändert (12 Seiten). Alle 16 Bilder auf 5 Seiten kommen jetzt über `/website-medien/`, sind geladen und haben dieselben Maße und Alternativtexte (zuvor `/medien/cms/`). Frühere Revisionen werden damit korrekt dargestellt. |
| Browser auf der Testinstanz, Redaktionsablauf (13 von 13) | siehe Liste darunter |
| Browser auf der Testinstanz, Freigabe zurücknehmen (8 von 8) | siehe Liste darunter |
| Slideshow | Im CMS gibt es keine Slideshow. Neue Widget-Arten waren nicht Teil des Auftrags. `WebsiteMedia::presentMany` ist vorbereitet, aber noch unbenutzt. |
**Redaktionsablauf, Prüfkonto, regulärer Seitenkonfigurator, Entwurfsseite, nichts veröffentlicht:**
- Vorhandenes Bild aus dem Medienmanager im Einstieg gewählt; Picker und Statusanzeige mit Vorschaubild und Verweis.
- Übernommene Platzhaltergrafik („Platzhalter Markenbühne“) durch „Platzhalter Bild Text“ ersetzt.
- Neues Bild direkt im Dialog hochgeladen: Es war sofort ausgewählt, zuerst mit „Wird gerade verarbeitet“, danach freigegeben. Im Medienmanager per Suche auffindbar; dessen Ansicht nennt die verwendende Seite.
- Dasselbe Medium in Einstieg und Karte verwendet.
- Gespeichert, wieder geöffnet, Vorschau: alle Bilder über `/website-medien/`, geladen, 1200 bis 1600 px breit.
**Freigabe zurücknehmen, auf `/premium-referenz`, danach wiederhergestellt:**
- Die Medienansicht nennt die Seite.
- Nach dem Zurücknehmen fehlt das Bild öffentlich; die übrigen 6 Bilder bleiben.
- `/website-medien/15` und die frühere Adresse `/medien/cms/…` liefern 404.
- Nach der erneuten Freigabe ist der Ausgangszustand wieder da; Geometrie und Bilder entsprechen dem Stand vorher.
**Auf der Testinstanz neu angelegt:**
- das Medium „Platzhalter Upload Medienpruefung“ (gekennzeichneter Platzhalter),
- die Entwurfsseite `/medien-pruefung-entwurf`.
Beides lässt sich über den Medienmanager bzw. die Seitenverwaltung entfernen.
## 4. Offene Punkte für Lars
1. **Bild entfällt oder Widget entfällt?** Die Dokumentation sagt, eine Komponente ohne freigegebenes Medium „erscheint öffentlich nicht“. Umgesetzt ist, dass nur das Bild entfällt, damit eine zurückgenommene Freigabe keine Überschrift (H1) von einer Seite entfernt.
2. **Bildschlüssel:** Gespeichert wird im bisherigen Schlüssel `image` (`refs.image`, `style.image`, `data.items[].image`), nicht in `refs.element`. Grund: Die Medienkarte nutzt `refs.element` für ihr Fachobjekt. Das Dokument ist entsprechend ergänzt.
3. **Originalmotiv freigegeben:** „Lara Felix Park Original“ (`cms/lara-felix-park-original-…png`) lag bereits öffentlich unter `cms/` und ist durch die Übernahme ein freigegebenes Medium. Ist die Veröffentlichung nicht geklärt, im Medienmanager zurücknehmen; `/premium-referenz` zeigt es dann nicht mehr.
4. **Titel und Quellenzeilen der übernommenen Medien** kommen aus den Dateinamen, ohne Quellenzeile, zum Beispiel „Platzhalter Markenbuehne“ ohne Umlaut. Beides lässt sich im Medienmanager pflegen.
5. **Rollback:** Eine Code-Fassung vor der Umstellung zeigt Bilder nicht, die danach gespeichert wurden (Kennung statt Pfad). Texte bleiben, die Dateien unter `cms/` bleiben (Registry §9).
6. **Bedienmuster:** Die Bildauswahl des Modul- und Programmeditors ist an dessen Seite gebunden und ließ sich nicht als Formularfeld wiederverwenden. Das Bedienmuster (Suche, Vorschaubild, Auswahl) ist übernommen, die Abfrage greift auf denselben Bestand zu.
@@ -0,0 +1,167 @@
# Abschlussbericht Designiteration 1: Markenintegration, Website-Gerüst, Premium-Widgets
Stand: 18.11.2026. Branch `feature/design-iteration-1` (von `develop`), per Fast-Forward auf `develop` übernommen und über `deploy-test.yml` auf der Testinstanz (Port 3011) bereitgestellt, zuletzt Lauf 4829. **Kein Merge nach `main`.** Commits: `33aaf64` (Umsetzung), `8390dcd` und `7c1caec` (Breitenmessung der Navigation), `d89d4bd` (Markenstrich), `8387cc9` (Bericht), `656f999` (Breitenstufen vor dem ersten Zeichnen, Vorschau, Fußbereichslinie), dazu diese Berichtskorrektur.
Fachliche Dokumentation: `docs/architektur/designsystem.md` (Tokens, Breitenmodell, Kopfzeile, Markenassets) und `docs/architektur/cms-widget-registry.md` (Varianten, Einstellungen, Randlos-Darstellung, Rollback).
## 1. Quellen
Geprüft: `docs/prinzipien/design-prinzipien.md` (mit Vorrang), `docs/strategie/website-cms-seo-marketing-zielkonzept.md`, `docs/architektur/website-cms-marketing-zielarchitektur.md`, `docs/architektur/12_Entscheidungsprotokoll_ADR.md` (lokaler Arbeitsstand, nicht verändert), `docs/architektur/cms-widget-registry.md`, das Brand-UI-Kit unter `docs/Brand-UI-Kit/` (ZIP und entpackte Ordner `01`–`06`, README, Quellenmanifest, Cursor-Übergabe).
**`00_LUF_Projektkompass.md` liegt weiterhin nicht im Repository.**
## 2. Ist-Befund vor der Umsetzung
Gemessen mit echten Scrollbalken (Chromium, lokale Kopie und Testinstanz):
| Beobachtung | Ursache im Code |
|---|---|
| Kopfzeile wechselt zwischen 73 und 93 px Höhe | Die Navigation brach mit `flex-wrap: wrap` zwischen etwa 1200 und 1410 px in zwei Zeilen um. Ob sie umbrach, hing davon ab, ob die Seite einen Scrollbalken hatte: Bei 1400 px war die Kopfzeile auf langen Seiten 93 px, auf kurzen 73 px hoch. |
| Wortmarke und Inhalt springen waagerecht | Kein `scrollbar-gutter`: Lange Seiten waren 15 px schmaler, der zentrierte Inhalt verschob sich um 7,5 px. |
| Wortmarke fluchtet nicht mit dem Inhalt | Kopfzeile im breiten Container (90 rem), Inhalt im Standardcontainer (75 rem): bei 1440 px 32 px gegenüber 112 px Abstand vom Rand. |
| Große Bildschirme kaum genutzt | Keine randlosen Bildflächen; die Widgets waren gleichförmige Grundmuster. |
| Farben und Schriften | Bereits aus dem Kit übernommen (Iteration 2) und zentral in `tokens.css`; kein zweites Token-System. |
| Widgets | Acht Arten mit schlichter Darstellung; nur `hero`, `cards`, `image_text`, `catalog_cards` hatten Varianten. |
| Assets | Alle Originale laut Quellenmanifest „public usage not independently verified“. Keine freigegebene Logodatei. SVG-Entwürfe sind neue Vorschläge. |
Brand-Kit-Ansichten: Der Homepage-Entwurf (`04_visuelle_entwuerfe`) zeigt weiße Kopfzeile mit Wortmarke, große Bildbühne mit Text rechts, gelbe Hauptschaltfläche, Navy-Fußbereich mit grünem Bogen. Die Web-Vorschau (`05_web_preview`) zeigt die Textmarke mit grünem Schild. Die Mobilansicht der Web-Vorschau zeigt das Bild oben und den Text darunter auf heller Fläche; so verhält sich die Markenbühne in schmalen Plätzen. Beide Entwürfe sind laut README nicht freigegeben und enthalten teils erfundene Inhalte; übernommen wurden nur Gestaltungsprinzipien, keine Texte, Preise oder Motive.
## 3. Aus dem Brand-Kit übernommen
| Element | Herkunft | Umsetzung |
|---|---|---|
| Markenfarben Navy, Grün, Grün dunkel, Gelb, Creme | `02_design_tokens` | unverändert in `tokens.css` (seit Iteration 2); Kontraste neu nachgerechnet |
| Schriften | Kit-Vorschlag Nunito, Lesetext Source Sans 3 | Nunito 700/800 und Source Sans 3 400/600, beim Build lokal abgelegt, keine Anfrage an Fremdserver |
| Textmarke mit grünem Schild „Stark im Alltag“ | `05_web_preview` | Wortmarken-Variante `lockup` für Kopf- und Fußbereich, gekennzeichnet `data-brand-status="vorlaeufig"` |
| Gelbe Unterstreichung | `03_svg_entwuerfe/yellow-underline.svg` | Komponente `x-brand.underline`: Markenstrich unter Einstiegs- und Abschnittsüberschriften, aktiver Navigationseintrag |
| Signalstrahlen | `03_svg_entwuerfe/yellow-rays.svg` | Komponente `x-brand.rays`: an Bild- und Tafelecken, auf Programmtafeln |
| Grüner Bogen | Homepage-Entwurf | Komponente `x-brand.arc`: Abschluss des Fußbereichs |
| Bildbühne mit Text auf einer Seite, gelbe Hauptschaltfläche, Outline-Nebenschaltfläche | Homepage-Entwurf | Hero-Variante „Markenbühne“, `.button-brand` |
Bewusst nicht übernommen: Monogramm (kein Logo, auch nicht als Favicon), Denkblase und Hand (didaktische Symbole der Denkpause, kein Dekor), KI-Konzeptgrafiken und deren Texte, Preise und Produktnamen, eine Nachzeichnung der Filmwortmarke.
## 4. Verwendete Originalassets
**Keine.** Die Originalmotive sind nicht zur Veröffentlichung freigegeben. Die Referenzseite auf der Testinstanz verwendet ausschließlich selbst erzeugte, sichtbar beschriftete Platzhalter („PLATZHALTER – Originalmotiv noch nicht freigegeben“, Format und Fokus im Bild).
Eine lokale Designvorschau mit den verkleinerten Kopien aus `05_web_preview/assets` war vorgesehen. Sie wurde nicht erstellt: Das Kopieren der Motive in den lokalen öffentlichen Medienordner wurde von der Sicherheitsprüfung der Arbeitsumgebung blockiert. Die Wirkung mit echten Motiven ist daher nicht geprüft.
## 5. Vorläufig oder nicht freigegeben
| Entscheidung | Status | Freigabe durch |
|---|---|---|
| Wortmarke (Textmarke mit grünem Schild) | vorläufig; keine Logodatei vorhanden | Lars: finale SVG-/PNG-Wortmarke |
| Farbwerte | vorläufig (aus Motiven abgeleitet) | Lars |
| Schriften Nunito und Source Sans 3 | vorläufig, Lizenz OFL, lokal ausgeliefert | Lars |
| Unterstreichung, Strahlen, Bogen | Kit-Entwürfe, nicht freigegeben | Lars |
| Bildmotive für Markenbühne, Bild und Text, Karten | nicht freigegeben; Nutzungsrechte offen | Lars (Rechte, Auswahl, Zuschnitte) |
| Themensignaturen der fünf Bereiche | nicht entworfen | Gestaltung und Freigabe offen |
| Breitenstufen (44/82/96 rem) und Kopfzeilenhöhen (104/72/64 px) | technische Festlegung dieser Iteration | Abnahme durch Lars |
## 6. Änderungen am globalen Layout
- **Konstante Kopfzeile.** Die Box ist immer gleich hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand; die innere Leiste (72 px) klebt oben. Beim Scrollen bleibt nur die kompakte Leiste sichtbar, die Wortmarke wird per `transform` von 1,16-facher auf normale Größe verkleinert. Der Seitenfluss ändert sich nie. Unter `prefers-reduced-motion` gibt es keinen Übergang. Ohne JavaScript klebt die Kopfzeile genauso.
- **Navigation bricht nie um.** Stufen: Navigation und Kontozugang mit Beschriftung; sonst Kontozugang nur als Symbol; sonst und immer unter 75 rem Menümodus. Gemessen wird die Desktop-Darstellung an der echten Navigation, und zwar inline direkt nach der Kopfzeile (`window.lufHeaderMode`, nach dem Stylesheet, vor dem Zeichnen). Schon der erste Frame zeigt deshalb die richtige Stufe; `site-nav.js` wiederholt die Messung bei Größenänderungen und nach dem Laden der Schriften. Eine erste Fassung setzte die Stufe erst im Modul; bei 1280 bis 1920 px zeigten die ersten Frames dann kurz die überlaufende Navigation. Das ist behoben.
- **Stabile Breite.** `scrollbar-gutter: stable`; ein gemeinsames Breitenmodell (Lesebereich 44 rem, Standard 82 rem, Breit 96 rem, Vollbreite). Kopfzeile, Fußbereich und Inhalt fluchten im Standardraster. `--frame-inset` richtet Inhalte in randlosen Flächen am Raster aus, ohne `100vw`. Die Breitenschlüssel des Editors bleiben, die Bezeichnungen lauten jetzt Lesebereich, Standard, Breit, Vollbreite.
- **Menümodus.** Die Fläche beginnt unter dem sichtbaren Teil der Kopfzeile; keine untere Navigationsleiste. Behoben wurde ein schon vorher vorhandener Fehler: Vom Knopf „Schließen“ sprang der Tabulator in den Seiteninhalt. Jetzt läuft der Fokus im Kreis.
- **Fußbereich.** Navy-Fläche, Textmarke, Gruppen aus der CMS-Navigation, „Rechtliches“ in einer Grundzeile, grüner Bogen. Endet die Seite mit einer dunklen Fläche, trennt eine feine Linie sie vom Fußbereich. Keine zweite Inhaltsverwaltung, keine erfundenen Texte.
- **Widget-Vorschau im Editor.** Ohne Scrollbalken-Reserve (`scrollbar-gutter: auto`); in Chromium war ohnehin kein Rand reserviert, die Angabe sichert andere Browser ab.
- **Mitgliederbereich.** Unverändert: schlichte Wortmarke, eigene Navigation. Die Tokens bleiben gemeinsam.
## 7. Änderungen an den Widgets
Alle Änderungen sind additiv. Es gibt keine neue Schemaversion und keine Migration, und gespeicherte Widgets bleiben gültig.
| Widget | Neu |
|---|---|
| Einstieg (Hero) | **Markenbühne**: Bild über die volle Breite, randlos wenn allein im Abschnitt. Der Text steht auf einer hellen Tafel (Kontrast 14:1 unabhängig vom Motiv), wahlweise links oder rechts. Schmal: Bild 4:3 mit überlappender Tafel. **Editorial**: große Überschrift, Beschreibung und Schaltflächen nebeneinander, optional ein Bildband 21:9. Für alle Varianten: zweite Schaltfläche, Bildausschnitt. Die erste Schaltfläche ist die gelbe Markenschaltfläche. Das Bild des ersten Widgets lädt sofort mit hoher Priorität, alle anderen verzögert. |
| Bild und Text | Bildformat (Quer-, Hochformat, Quadrat, Original) und Bildausschnitt; versetzte Markenfläche hinter dem Bild; ab 56 rem Bild betont (7:5); Markenstrich unter dem Titel |
| Redaktionelle Karten | Variante **erste Karte hervorgehoben**: ganze Zeile, ab 44 rem Bild neben dem Text. Raster mit großen Bildflächen; Karten ohne Bild bekommen eine gelbe Kante. Kompakte Liste mit kleinem Bild. Die ganze Karte ist über den Titellink klickbar (ein Tabstopp). |
| Programm- und Modulkarten | Markentafel statt erfundener Bilder (Navy, auf dunklen Flächen Grün dunkel). Eine einzelne Karte ist ab 40 rem breit, mit Tafel neben dem Text. Unverändert: Fachdaten zur Laufzeit, keine Kopie im CMS, Freigabelogik (ADR-29), keine öffentlichen Modulprofile. |
Einstellungen sind nur Aufzählungswerte; freie Werte werden abgewiesen. Der Editor zeigt sie mit deutschen Bezeichnungen und dem Hinweis „Vorgabe der Darstellung“.
**Rollback:** Ein Code-Rollback auf Iteration 2 stellt die neuen Varianten mit der Vorgabe dar; Daten gehen nicht verloren. Der Wiederherstellungsweg aus `cms-widget-registry.md` §9 bleibt für einen Rollback hinter Iteration 2 nötig.
## 8. Design-Referenzseite
`/designreferenz` auf der Testinstanz, über die Editoroberfläche angelegt und veröffentlicht. Die Texte stammen aus den Design-Prinzipien (Themenbereiche, Methode, Zielgruppe). Keine Produkte, Preise, Kurse oder Filmfreigaben; Bilder sind gekennzeichnete Platzhalter.
| Abschnitt | Zeigt |
|---|---|
| 1 | Markenbühne randlos, zwei Schaltflächen, Bildausschnitt links |
| 2 | Bild und Text (breit), Trenner Markenakzent |
| 3 | Raster 1 + 3 auf heller Fläche: Überschrift und hervorgehobene Karten (fünf Themenbereiche) |
| 4 | Programmkarte aus den Fachdaten auf dunkler Fläche |
| 5 | Editorial-Einstieg, großzügiger Abstand, Trenner Linie |
| 6 | Raster 2 + 2 auf Markenakzent: Text und kompakte Karten |
| Rahmen | Markenkopfzeile, Fußbereich mit Bogen |
## 9. Tests und Prüfungen
| Prüfung | Ergebnis |
|---|---|
| Testsuite lokal (`php artisan test`) | 194 Tests grün, davon 9 neu (`CmsDesignIterationTest` 8, Editortest Markenbühne 1). Bewusst angepasst: zwei Erwartungen an Klassen (`brand brand-lockup`, `button button-brand`). |
| Pint | sauber |
| CI Feature-Branch | Läufe 4819, 4821, 4823, 4825, 4827, 4828 grün |
| Deploy Testinstanz | Läufe 4820, 4822, 4824, 4826, 4829 erfolgreich, `/up` 200 |
| Bestehende Seiten (12, Status, Titel, Haupttext) | vor und nach dem Deploy unverändert |
| Referenzseite über die Oberfläche (Testinstanz) | 11/11 |
| Browser-QA (Testinstanz und lokal) | 18/18 |
| Untermenü mit Maus und Tastatur (Testinstanz) | 8/8; der Prüfeintrag ist wieder entfernt |
| Geometrie über 5 Seiten bei 1920/1440/1400/1366/1280/1200/390 px (Testinstanz, Lauf 4829) | je Breite genau eine Kopfzeilenhöhe, eine Wortmarken- und eine Navigationsposition |
| Erster gezeichneter Frame bei 1280/1366/1440/1920 px, CPU vierfach gedrosselt (Testinstanz) | richtige Stufe ab dem ersten Frame, kein Überlauf, CLS 0 |
| Schmale Plätze (lokal): Markenbühne und Bild und Text in 2 + 2, Programmkarten in 1 + 3, kompakte Listen in 1 + 1 + 1 + 1 | sichtbar geprüft bei 1440 und 768 px, ohne Befund; ein Einstieg in einem Platz mit einer Einheit wird beim Speichern abgewiesen |
| Fenstergröße ändern 1280 → 1440 → 1100 → 1920 → 390 → 1440 | Moduswechsel korrekt, keine Konsolenfehler, eine Navigation im DOM |
Die Browser-QA umfasst:
- Layoutverschiebung beim Kaltstart und Scrollen (CLS 0 bei 1440 und 390 px)
- Ausgangszustand und kompakten Zustand der Kopfzeile bei unverändertem Seitenfluss
- Reduced Motion
- Mobilmenü mit Fokusfalle und Escape
- Tabulatorreihenfolge und sichtbaren Fokus
- Ladeverhalten der Bilder (erstes eager/high, Rest lazy)
- kein horizontales Scrollen bei 390, 768, 1440 und 2560 px
Kontraste (berechnet): Navy auf Gelb 10,3:1, Navy auf Creme 14:1, Weiß auf Grün dunkel 5,2:1, Grün dunkel auf Weiß 5,2:1, Fußbereichslinks auf Navy 11:1. Die Grundzeilen-Links erreichen auch auf dem grünen Bogen 4,8:1.
## 10. Screenshots
Alle von der Testinstanz mit Platzhaltern, unter `docs/analysen/designiteration-1-screenshots/`:
1. `01-1440-kopfzeile-markenbuehne.jpg`: Ausgangszustand der Kopfzeile, Markenbühne
2. `02-1440-kopfzeile-kompakt.jpg`: kompakte Kopfzeile beim Scrollen
3. `03-1440-referenzseite-gesamt.jpg`: ganze Referenzseite, Desktop
4. `04-2560-breiter-bildschirm.jpg`: breiter Bildschirm, Bühne randlos, Tafel im Standardraster
5. `05-768-referenzseite-gesamt.jpg`: Tablet
6. `06-390-referenzseite-gesamt.jpg`: Smartphone
7. `07-390-mobilmenue.jpg`: geöffnetes Mobilmenü
8. `08-1440-kurze-seite.jpg`: kurze Seite, gleiche Kopfzeile
## 11. Bekannte Einschränkungen
- **Navigation der Testinstanz.** Sie hat acht teils lange Einträge. Damit zeigt die Kopfzeile den Kontozugang als Symbol und schaltet zwischen 1280 und 1366 px in den Menümodus. Mit fünf bis sechs kurzen Einträgen wie im Kit-Entwurf bleibt die Navigation bis 75 rem in der Zeile.
- **Schriften nachgeladen.** Die Stufe wird vor dem Laden der Webschriften gemessen und danach erneut geprüft. Weicht die Breite der Ersatzschrift stark ab, kann die Stufe einmal wechseln; in den Messungen trat das nicht auf.
- **Kopfzeilenverhalten nicht in der Testsuite.** Breitenstufen, Fokusfalle, kompakter Zustand und erster Frame sind nur durch Browser-Skripte geprüft (Playwright, außerhalb des Repositorys). Empfehlung: diese Skripte als Ausgangspunkt der Instanz-Suite (U0) übernehmen, mit Zugangsdaten aus der Umgebung statt aus einer Datei.
- **Keine echten Motive.** Wirkung und Zuschnitte mit echten Motiven sind nicht geprüft (siehe Abschnitt 4).
- **Keine responsiven Bildvarianten.** Es gibt noch kein `srcset`; Bilder werden in Originalgröße ausgeliefert. Feste Formate verhindern Verschiebungen, nicht aber die Ladegröße. Die Ableitungen gehören in die Hintergrundverarbeitung, weil der Webprozess keine Medien schreibt.
- **Programmkarten.** Sie zeigen nur Titel, Kurzbeschreibung und Art. Zuordnung zu Themenbereichen und Umfang stehen nicht im `CatalogEntry` und wären eine Erweiterung des Fachlesers.
- **Karten-Raster.** Bei vier Karten neben einer hervorgehobenen ergibt sich je nach Breite eine einzelne Karte in der letzten Zeile.
- **Vorschau im Editor.** Die Markenbühne ist höher als die Vorschaufläche (22 rem) und wird dort beschnitten (mit Hinweis). Die Gerätevorschau zeigt sie vollständig.
- **Build-Warnung.** `npm run build` meldet „Some chunks are larger than 500 kB“. Ob die Warnung schon vor dieser Iteration auftrat, ist nicht geprüft; diese Iteration ergänzt nur wenige Kilobyte Skript.
## 12. Empfehlungen für die nächste Designiteration
1. **Freigaben einholen:** Wortmarke als SVG, Farbwerte, Schriften, drei bis fünf Motive mit geklärten Rechten (Titel und Outro eignen sich für die Markenbühne, das Outro mit freier rechter Fläche besonders). Dann nur `tokens.css`, `components/site/brand.blade.php` und die Medien austauschen.
2. **Bildableitungen in der Hintergrundverarbeitung:** WebP/AVIF in 3–4 Breiten mit `srcset`/`sizes` und Fokuspunkt; Einstieg mit `preload`.
3. **Themensignaturen:** fünf Symbole und Tönungen gestalten, dann in Karten, Programmtafeln und Themenseiten einsetzen.
4. **Programmkarten erweitern:** Themenbereiche und Umfang aus dem veröffentlichten Fachstand im Leser ergänzen; Test, dass nichts Unveröffentlichtes durchsickert.
5. **Navigation redaktionell auf fünf bis sechs Hauptpunkte straffen** (Design-Prinzipien §7: Konzept, Themenbereiche, Programme, Anwendung, Angebote, Mitgliederbereich).
6. **Startseite** aus der Referenz ableiten (redaktionelle Entscheidung, keine technische).
7. Messung mit Prüfwerkzeug (axe, Lighthouse) an der gerenderten Seite vor der Farbfreigabe.
## 13. Auf der Testinstanz angelegt
- Seite `/designreferenz` (veröffentlicht, eine Revision).
- Platzhalterbilder im öffentlichen Medienbereich: `cms/platzhalter-markenbuehne-*`, `cms/platzhalter-bild-text-*`, `cms/platzhalter-karte-1/2/3-*` (Dateinamen mit Zufallssuffix).
- Prüfeintrag „Referenz Abschnitte (Prüfeintrag)“ in der Navigation: zweimal angelegt und jeweils wieder gelöscht. Ein Durchlauf brach ab und hinterließ den Eintrag kurzzeitig; der nächste Durchlauf hat ihn entfernt.
Binary file not shown.

After

Width:  |  Height:  |  Size: 120 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 103 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 252 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 279 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 224 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

@@ -0,0 +1,354 @@
# Ist-Soll-Abgleich: Mitgliederbibliothek und Produktkonfiguration
**Stand:** 15.11.2026, nach Review des Umsetzungsplans ergänzt
**Art:** Lesende Codeprüfung. Keine Änderung an Anwendung, Daten oder bestehenden Fachspezifikationen.
**Nachtrag:** Abschnitt „Architekturentscheidungen nach der Review“. Die Befunde A-01 bis E-02 bleiben die nachgewiesene Ist-Aufnahme. Neue Entscheidungen sind dort gekennzeichnet und ändern den Status eines Befunds nicht.
**Soll:** `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md` (konsolidierte Fassung vom 15.11.2026), eingeordnet mit `docs/fachkonzept/abgleich-produktkonfiguration-und-mitgliederbereich.md` und `docs/fachkonzept/trainingskonzept-und-produktstruktur.md`.
Der im Auftrag genannte Pfad `docs/architektur/abgleich-produktkonfiguration-und-mitgliederbereich.md` ist im Repository nicht vorhanden. Die inhaltlich entsprechende Datei liegt unter `docs/fachkonzept/abgleich-produktkonfiguration-und-mitgliederbereich.md`. Sie prüft Dokumente, nicht den Code, und verweist in Abschnitt 5 auf genau diese Bestandserhebung.
Priorität dieser Prüfung: Die Mitgliederbibliothek ist MVP-Pflicht. Ein didaktischer Kursplayer mit automatischer Denkpause ist ein späteres Add-on. Ein normaler geschützter Videoplayer gehört zum MVP.
## Nachweisgrenze
Nachgewiesen ist, was im Quelltext, in Migrationen, Blade-Ansichten, Routen und automatisierten Tests steht. Die Testinstanz wurde nicht geöffnet. Es wurde kein Film hochgeladen, keine Datenbank abgefragt und die Testsuite nicht ausgeführt.
Annahmen sind unten ausdrücklich als Annahme gekennzeichnet. Wo ein Laufzeitverhalten nur aus dem Quelltext folgt, gilt es als am Code nachgewiesen, nicht als auf der Testinstanz beobachtet.
Die frühere Audit-Sichtung vom selben Tag ist durch diese Datei ersetzt, soweit die neue Soll-Fassung die Bewertung ändert. Insbesondere ist der spezialisierte Kursplayer kein Mangel des MVP mehr, sondern ein zurückzustellendes Add-on.
## Kurzbefund
| Bereich | Ergebnis |
|---|---|
| Stabile Identitäten, versionierte Mitgliedschaft, getrennte Lizenzobjekte | Im Modell und in der Verwaltung vorhanden und belastbar |
| Fachdimensionen an Modul und Programm, Thumbnails, Suche, Filter | Nicht vorhanden |
| Mitgliederbibliothek als fachliche Struktur | Nicht erfüllt. Sie listet Berechtigungen und nennt sie Kurse |
| Mehrfachanzeige je Programm und Deduplizierung nur in der Einzelmaterialliste | Nicht erfüllt, weil es keine Programm- und keine Identitätsliste gibt |
| Rechteprüfung je Medienaktion, unveränderliche Fassungen und Schnappschüsse | Für Stream und Ansehen vorhanden. Download ist serverseitig vorgesehen und in der Bibliothek nicht ausgelöst |
| Normaler Player gegenüber didaktischem Player | Der HTML5-Player ist da. Dieselbe Mitgliedsseite hängt zusätzlich eine Entscheidungsmarke daran |
Die Bibliothek kann auf dem vorhandenen Kompositions- und Berechtigungsmodell neu gelesen werden. Dafür müssen weder Artikel-Stände noch Grants umgebaut werden.
---
## A. Fachliches Inhaltsmodell
### A-01 Stabile, wiederverwendbare Identitäten
- **Anforderung:** Produktkonfiguration §2. Ein Asset und eine Komposition behalten ihre Identität. Wiederverwendung verlinkt diese Identität und eine konkrete Fassung, statt eine Mediendatei zu kopieren.
- **Ist-Zustand:** `content_elements` und `compositions` sind die Identitäten. Fassungen hängen als `content_element_versions` und `composition_versions` daran. `composition_members` verweist auf eine Inhaltsfassung oder eine verschachtelte Kompositionsfassung. `ContentService::publishElementVersion` und `publishComposition` legen neue Nummern an. `CatalogOptions::assignmentTargets` bietet vorhandene bereite Fassungen an.
- **Status:** erfüllt
- **Abweichung und Auswirkung:** Keine für die Identität. Die Mitgliederseite benutzt diese Identität nicht als Bibliotheksgegenstand, siehe C-01.
- **Empfohlene Maßnahme:** bestehende Funktion nutzen.
- **Risiko:** Ein Neubau der Tabellen würde veröffentlichte `release_contents` und Grants von ihren Fassungen lösen. Die Identitäten bleiben.
### A-02 Programme und Module frei zusammenstellen
- **Anforderung:** Produktkonfiguration §2 und §6. Keine Pflicht-Hierarchie Film → Übung → Modul → Programm → Paket. Ein Modul muss keinen festen Bestandteilstyp enthalten. Programme bestehen aus Modulen und weiteren Inhalten. Zyklen sind ausgeschlossen.
- **Ist-Zustand:** `CompositionKind` ist ein geschlossener Code-Enum mit `uebung`, `kurs` und `kombination`. `EditComposition` lässt jede bereite Inhalts- oder Kompositionsfassung als Baustein zu, unabhängig von der Art. `ContentService::assertAcyclic` und `ContentResolver::expand` lehnen Zyklen ab. `DemoCatalogSeeder` legt eine Kombination und eine Übung an, keinen Kurs. „Demo Programm“ ist ein `Bundle`, kein Kurs.
- **Status:** teilweise erfüllt
- **Abweichung und Auswirkung:** Verschachteln und Wiederverwenden geht in der Verwaltung. Eine neue Zusammenstellungsart oder die im Soll genannten Typen Modul und Programm sind nicht ohne Codeänderung pflegbar. Kurs und Übung sind fest beschriftete Arten, kein frei konfigurierbarer Fachtyp. Der Demo-Bestand bildet das Soll-Programm nicht ab.
- **Empfohlene Maßnahme:** Die vorhandene Komposition ergänzen. Die drei gespeicherten Arten nicht als Verkaufsstruktur und nicht still als Programm oder Modul lesen. Technische Struktur und redaktionelle Inhaltsart sind in E-T getrennt.
- **Risiko:** Vorhandene Zeilen mit `kind = uebung` oder `kombination` bleiben gültige Kompositionen. Ein stilles Umbenennen von `kurs` in „Programm“ in der Datenbank ist unnötig, solange die Anzeige den fachlichen Typ aus den Stammdaten bezieht.
### A-03 Fachdimensionen an Medien, Modulen und Programmen
- **Anforderung:** Produktkonfiguration §3. Dimensionen und Werte ohne Programmierung. Direkte Zuordnung an Assets, Übungen, Module und Programme. Abgeleitete Zuordnungen bleiben davon unterscheidbar. Dimensionen vergeben keine Rechte. Die fünf Säulen sind Startwerte.
- **Ist-Zustand:** Es gibt genau eine feste Dimension: `pillars`, plus `content_element_pillar` und `page_pillar` (`2026_11_15_150000_create_pillars.php`, `2026_11_15_170000_publish_pillars_to_the_site.php`). `PillarService::assign` hängt Säulen an Inhaltselemente. `Pillar::elements` und `pages` haben keine Beziehung zu `compositions`. `CatalogReading::memberPillars` leitet Säulen nur aus enthaltenen Medien ab und kennzeichnet diese Ableitung nicht als solche. Weitere Dimensionen, Altersbereich, Einsatzbereich und Schlagwörter haben keine Tabellen. `DecideAccess` liest Säulen nicht.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** Ein Medium kann mehreren Säulen gehören. Ein Modul oder Programm kann nicht selbst einem Thema zugeordnet werden. Abnahmekriterium B06 ist nicht erfüllbar. Filter in der Bibliothek haben keine Datenquelle. Die öffentlichen Themen unter `/themen` zeigen CMS-Seiten, keine Trainingszusammenstellungen.
- **Empfohlene Maßnahme:** ergänzen. Die vorhandenen Säulen als erste Dimension und ihre Medien-Zuordnungen übernehmen. Keine zweite, parallele Themenliste danebenstellen.
- **Risiko:** `content_element_pillar` enthält die einzigen echten Themenzuordnungen. Sie dürfen beim Einführen allgemeiner Dimensionen nicht gelöscht werden, bevor sie übernommen sind. Veröffentlichte CMS-Themen bleiben ein eigener Seitenmechanismus.
### A-04 Rolle je Verwendung
- **Anforderung:** Produktkonfiguration §3. Die Rolle eines Mediums ist Eigenschaft der konkreten Verwendung. Dieselbe Datei darf in zwei Modulen verschiedene Rollen haben.
- **Ist-Zustand:** `composition_members.role` ist ein Pflichttext je Baustein (`EditComposition`, Feld „Rolle“). Dieselbe `content_element_version_id` kann in mehreren Zeilen mit unterschiedlichem Rollentext stehen. `ArticleService::publishRelease` übernimmt beim Auflösen die Rolle der jeweiligen Mitgliedszeile nach `ContentResolver::expand`. Die Mitgliedsseite zeigt diese Rolle neben dem Arbeitstitel, aber nur in der flachen Liste des Artikel-Stands.
- **Status:** teilweise erfüllt
- **Abweichung und Auswirkung:** Die Redaktion kann unterschiedliche Rollen setzen. Die Bibliothek zeigt sie nicht im Zusammenhang eines Moduls oder Programms. Bei Verschachtelung bleibt im Artikel-Stand die Rolle der Blattzeile erhalten, der Pfad liegt in `release_contents.path` und wird in `member/article.blade.php` nicht angezeigt.
- **Empfohlene Maßnahme:** bestehende Mitgliedszeile nutzen. Die Anzeige am Kompositionsbaum korrigieren, nicht eine zweite Rollentabelle anlegen.
- **Risiko:** Rollen bereits gespeicherter Mitglieder bleiben gültig. Eine Normalisierung freier Texte ist eine redaktionelle Entscheidung, keine Migration, die Fassungen ändern darf.
### A-05 Versionsarchitektur
- **Anforderung:** Produktkonfiguration §2 und §4 Klasse B und C. Veröffentlichte Inhalts-, Kompositions- und Angebotsfassungen sowie der aufgelöste Artikel-Stand bleiben unveränderlich. Eine neue Datei, Mitgliedschaft oder Reihenfolge erzeugt eine neue Fassung.
- **Ist-Zustand:** `ContentElementVersion`, `CompositionVersion`, `CompositionMember`, `ArticleRelease`, `ReleaseContent`, `BundleVersion`, `OfferVersion`, `OfferLine`, `ResolvedScope` und `RightsProfileVersion` weisen Änderungen an bereitgestellten oder aktivierten Zeilen über `updating` zurück. `ContentService::publishComposition` schreibt Mitglieder nur in eine neue Fassung. `ArticleService::publishRelease` schreibt `release_contents` neu und löst den vorherigen Stand ab, ohne ihn zu überschreiben. `CatalogRulesTest` prüft, dass eine neue Medienfassung eine veröffentlichte Komposition nicht ändert und eine Paketänderung eine aktivierte Angebotsfassung nicht ändert.
- **Status:** erfüllt
- **Abweichung und Auswirkung:** Die Architektur bleibt fachlich korrekt. Klasse-A-Daten liegen teilweise schon außerhalb der Fassung, siehe B-01. `OfferService::activate` legt eine neue Fassung an, beendet die vorherige aktive Fassung aber nicht, siehe D-02.
- **Empfohlene Maßnahme:** bestehende Funktion nutzen. Neue Stammdaten nicht in die Fassungstabellen legen.
- **Risiko:** Jede Migration, die `body`, `metadata`, `members_hash` oder `release_contents` bestehender veröffentlichter Zeilen fortschreibt, verletzt die vorhandene Invariante. `StoreContentFile` darf eine Fassung nur im Status Entwurf fortschreiben und tut das auch.
---
## B. Redaktionelle Verwaltung
### B-01 Anzeigedaten ohne neuen Inhaltsrelease
- **Anforderung:** Produktkonfiguration §4 und Abnahme B02, B24. Titel, Kurzbeschreibung, Suchattribute und Themen sind Klasse A: sofort wirksam, kein Asset-, Kompositions- oder Artikel-Release, mit Bearbeiter, Zeit und Änderung. Normative Lehranweisungen bleiben Klasse B. Ein geänderter Anzeigetitel schreibt Kauf und Bestellung nicht um.
- **Ist-Zustand:** `ContentService::describe` speichert `working_title` und `description` auf `content_elements`. `PillarService::assign` ändert nur die Zuordnung. Beides legt keine `content_element_versions`-Zeile an. `EditComposition` speichert `designation` und `kind`, ohne eine neue Kompositionsfassung, solange die Bausteine gleich bleiben. Es gibt keine Tabelle für Änderungsprotokoll, Kurzbeschreibung, Schlagwörter oder getrennte Lehranweisung. Der Lehrtext steht in `content_element_versions.body` und ist nach Bereitstellung gesperrt. Die Bestellseite liest `offerVersion->offer->name` live und `order_lines.price_cents` als Kopie (`resources/views/member/order.blade.php`).
- **Status:** teilweise erfüllt
- **Abweichung und Auswirkung:** Arbeitstitel, Beschreibung und Säulen eines Mediums sowie die Bezeichnung einer Komposition ändern sich ohne neue Inhaltsfassung. Es fehlt die Auditspur. Es fehlt die sichtbare Trennung von Anzeigetext und Lehranweisung. Eine Umbenennung des Angebots ändert die sichtbare Bestellbezeichnung, obwohl der Preis stehen bleibt. Kompositionen haben keine Beschreibung.
- **Empfohlene Maßnahme:** ergänzen, auf den vorhandenen Identitätstabellen. Lehrtext und Datei in der Fassung lassen.
- **Risiko:** Ein Protokoll darf keine alte Fassung nachträglich beschreiben. Die Bestellbezeichnung braucht eine eigene Kopie, sonst erfüllt B24 nur den Preis, nicht den Namen. Bestehende `description`-Texte sind nicht danach getrennt, ob sie Anzeige oder Lehrinhalt sind. Das ist eine redaktionelle Sichtung, keine automatische Umschreibung.
### B-02 Thumbnails für alle darstellbaren Typen
- **Anforderung:** Produktkonfiguration §5. Eigenes Vorschaubild für Asset, Übung, Modul, Programm und bei Bedarf Lizenzartikel. Fallback, Alternativtext, optimierte Größen. Änderung ohne neue Filmfassung. Öffentliche und geschützte Verwendung sind getrennt.
- **Ist-Zustand:** Im Anwendungscode, in den Views und in den Migrationen gibt es kein Vorschaubild, kein Poster und keinen Alternativtext für Inhalte. Suche nach `thumbnail`, `poster` und `vorschaubild` bleibt ohne Treffer.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** Karten können das Soll nicht erfüllen. Ein fehlendes Bild kann heute nicht auf eine definierte Fallback-Grafik ausweichen, weil es keine Karten dieses Typs gibt.
- **Empfohlene Maßnahme:** ergänzen, als Klasse-A-Ableitung an der Identität, nicht als neue Inhaltsfassung.
- **Risiko:** Thumbnail-Dateien gehören nach `derived/` oder einer eigenen Ableitung, nicht nach `originals/` als Ersatz des Films. Ein extrahierter Frame darf nicht in `media_public` gelangen, siehe B-03.
### B-03 Frame eines Videos als Thumbnail
- **Anforderung:** Produktkonfiguration §5 und Abnahme B03, B04. Zeitpunkt in der konkreten Filmfassung wählen, Frame übernehmen, Film und Prüfsumme unverändert. Keine automatische öffentliche Marketingfreigabe.
- **Ist-Zustand:** Kein ffmpeg, keine Frame-Extraktion, keine Zeitposition für Bilder. `decision_seconds` in den Fassungsmetadaten ist eine didaktische Marke und wird beim Ändern als neue Inhaltsfassung behandelt (`ElementRevision`). `StoreContentFile` kopiert die hochgeladene Datei unverändert nach `media_derived`.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** B03 und B04 sind nicht ausführbar. Die vorhandene Marke darf nicht zweckentfremdet als Thumbnail-Zeitpunkt dienen, weil ihre Änderung eine neue Lehrfassung erzwingt.
- **Empfohlene Maßnahme:** ergänzen, mit eigener Bildableitung und eigener Sichtbarkeit. Den Film dabei nicht anfassen.
- **Risiko:** Die einzige Filmkopie liegt heute unter `derived/`, nicht unter `originals/`. Eine Extraktion kann diese Kopie lesen. Sie darf die Datei und `content_hash` nicht neu schreiben. Ob große Dateien bei der Extraktion an `memory_limit = 512M` scheitern, ist nicht ausgeführt worden. Das ist eine Annahme über das Betriebsverhalten, kein beobachteter Fehler.
### B-04 Kompositionseditor verwendet vorhandene Inhalte wieder
- **Anforderung:** Produktkonfiguration §12 Schritte 3 und 4. Vorhandene Assets und Unterkompositionen suchen, referenzieren, Rolle und Reihenfolge setzen.
- **Ist-Zustand:** `ListCompositionKind` legt eine leere Komposition an. `EditComposition` füllt ein Wiederholfeld aus der letzten bereiten Fassung. `CatalogOptions::assignmentTargets` listet bereite Medien- und Kompositionsfassungen und lässt nur die gerade bearbeitete Komposition aus. Speichern ruft `ContentService::publishComposition` auf, wenn Rolle oder Ziel sich ändern. `MediaAdministrationTest` tauscht einen Baustein über die Übungsseite. `CatalogRulesTest::test_c_one_element_version_can_be_reused` zeigt dieselbe Fassung in zwei Kompositionen auf Dienstebene.
- **Status:** erfüllt
- **Abweichung und Auswirkung:** Die Wiederverwendung funktioniert in der Verwaltung. Es gibt keinen Test, der denselben Film über die Oberfläche in zwei Übungen mit unterschiedlichen Rollen einbaut. Die Auswahl ist eine lange Liste bereiter Fassungen, keine Suche nach der stabilen Identität mit anschließender Fassungswahl.
- **Empfohlene Maßnahme:** bestehende Funktion nutzen. Die Auswahl später auf Identität und Suche erweitern, ohne die Mitgliedszeile zu ersetzen.
- **Risiko:** Gering, solange weiter konkrete Fassungs-IDs gespeichert werden. Ein Speichern nur der Identität würde die Versionsinvariante aufgeben.
### B-05 Verwendung in Modulen und Programmen nachvollziehen
- **Anforderung:** Produktkonfiguration §6 und §12. „Verwendet in“ zeigt Module und Programme. Die Bearbeitungsmaske macht Verwendung und Versionen auffindbar.
- **Ist-Zustand:** `CatalogReading::elementUsage` wird in `ViewContentElement` angezeigt und nennt Kompositionen mit Art, Bezeichnung, Fassungsnummer und Rolle sowie Lizenzartikel. `CatalogReading::compositionUsage` ermittelt Elternkompositionen und Artikel, wird von keiner Seite aufgerufen. Die Übungs- und Kursmaske zeigt die eigenen Bausteine und abgeleitete Säulen, nicht die Verwendung dieser Übung in anderen Kursen.
- **Status:** teilweise erfüllt
- **Abweichung und Auswirkung:** Für ein Medium ist die Rückwärtsverwendung in der Verwaltung sichtbar. Für eine Übung oder einen Kurs ist dieselbe Auskunft im Code vorhanden und in der Maske nicht erreichbar. Die Mitgliederansicht hat kein „Verwendet in“.
- **Empfohlene Maßnahme:** die vorhandene Methode `compositionUsage` in der Bearbeitungsmaske anzeigen. Für Mitglieder erst mit der Bibliothek ausgeben.
- **Risiko:** Keine Datenänderung. Die Methode liest nur.
---
## C. Mitgliederbibliothek
Routen unter `bereich`, alle hinter `auth` und `verified`: `/bibliothek`, `/bibliothek/{article}`, `/materialien`, `/berechtigungen`, `/ausgabe/{article}/{release}/{version}/{action}`. Controller: `LibraryController`.
### C-01 Fachliche Darstellung von Programmen, Modulen, Filmen, Übungen und Materialien
- **Anforderung:** Produktkonfiguration §1, §8 und §9. Programme, Module, Übungen, Filme und Materialien sind unterscheidbar. Ein PDF wird nicht wegen seiner Lizenzierbarkeit zum Kurs. Die Bibliothek richtet sich an Trainer. Administrative Lizenzstruktur ersetzt den pädagogischen Inhalt nicht.
- **Ist-Zustand:** `resources/views/member/library.blade.php` setzt Titel und Überschrift auf „Kurse“ und listet jede aktive Berechtigung. `CourseOutline::title` nimmt die Bezeichnung der Wurzelkomposition, sonst den Arbeitstitel, sonst die Kennung. `kindLabel` ist nur gesetzt, wenn die Wurzel eine Komposition ist. `DemoCatalogSeeder` veröffentlicht `demo-merkblatt` als Artikel auf einer PDF-Fassung ohne Komposition. Diese Berechtigung erscheint in derselben Kursliste. `member/article.blade.php` sagt im leeren Zustand „Dieser Kurs hat noch keinen veröffentlichten Stand“ und zeigt unten `Artikel {{ $article->code }}`. `member/materials.blade.php` heißt „Filme und Materialien“ und lässt nur Artikel mit Ausgabeklasse `film` oder `audio` zu. `CoursePlayerTest` erwartet die Überschrift „Kurse“ für eine Übung namens „Alltag üben“.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** Ein Merkblatt, eine Übung und ein späterer Kurs sind nicht als Typen getrennt. Der Trainer sieht Lizenzartikel. Abnahme B01 scheitert an dieser Darstellung, auch wenn die Anlage des Films in der Verwaltung gelingt.
- **Empfohlene Maßnahme:** ersetzen. Die Seite neu aus Programmen, Modulen und Materialien aufbauen. `DecideAccess` und die Artikel-Stände bleiben die Freigabe, nicht die Gliederung.
- **Risiko:** Vorhandene Grants bleiben die Rechtequelle. Eine neue Gliederung darf keinen Grant anlegen, nur weil eine Komposition einen Film enthält. Der Test `CoursePlayerTest` schreibt die falsche Überschrift fest und muss bei der Umsetzung geändert werden, nicht die Oberfläche an den Test angepasst werden.
### C-02 Suche und kombinierbare Filter
- **Anforderung:** Produktkonfiguration §8. Suche über Titel, Kurzbeschreibung, Schlagwörter und Suchattribute. Filter nach Typ, Säule, Alter, Einsatzbereich, weiteren Dimensionen und Verfügbarkeit. Mehrere Werte einer Dimension mit ODER, verschiedene Dimensionen mit UND. Leere Ergebnisse, Fehler, mobiles Filter und Zurücksetzen.
- **Ist-Zustand:** `LibraryController` nimmt keinen Suchbegriff und keinen Filter entgegen. Die Mitgliedsviews enthalten kein Suchfeld. `searchable()` kommt nur in Filament-Tabellen vor. Es gibt keine Schlagwort- oder Altersdaten, siehe A-03.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** Die Bibliothek ist nicht durchsuchbar. B05, B06 und B22 sind für Suche und Filter nicht erfüllbar. Filament-Suche ist keine Mitgliedersuche.
- **Empfohlene Maßnahme:** ergänzen, nachdem Typen und Dimensionen eine Datenquelle haben. Vorher eine Suche nur über Arbeitstitel bauen würde die Soll-Filter nicht tragen.
- **Risiko:** Ein eigener Suchindex darf Klasse-A-Änderungen sofort übernehmen und keine Rechte vergeben. Ob die spätere Suche PostgreSQL oder einen externen Index nutzt, ist nicht entschieden und hier nicht festgelegt.
### C-03 Vollständige Modul- und Programmstruktur
- **Anforderung:** Produktkonfiguration §9 und §10, Abnahme B07. Kopf, Überblick, geordnete Bestandteile mit Rolle und Fachtyp, Untergruppen. Verschachtelung fällt nicht zu einer Dateiliste zusammen.
- **Ist-Zustand:** `LibraryController::show` lädt `article.currentRelease.contents` und gibt eine flache Liste aus. `ContentResolver::expand` löst verschachtelte Kompositionen in Blattfassungen auf. `ArticleService` speichert dabei `path`, die View verwendet `role` und den Arbeitstitel. Lernziele, Zeit- und Materialbedarf haben keine Spalten. Eine Komposition ohne Lizenzartikel hat keine Mitgliedsroute.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** Ein Kurs aus einer Übung aus Film und Merkblatt wird eine Liste von Dateien. Reihenfolge der Blätter bleibt erhalten, die Zwischenstufen nicht. Der Trainer kann die Trainingseinheit daran nicht verstehen.
- **Empfohlene Maßnahme:** ersetzen, durch einen Leser, der die veröffentlichte Kompositionsfassung als Baum anzeigt und je Blatt `DecideAccess` fragt. `release_contents` bleibt die Prüfung, ob die Fassung zum Artikel-Stand gehört.
- **Risiko:** Der Baum muss die in `composition_members` fixierten Fassungen zeigen, nicht still die jeweils neueste Fassung der Identität. Sonst vermischen sich historische Stände, entgegen B13.
### C-04 Mehrfachanzeige innerhalb jedes Programms
- **Anforderung:** Produktkonfiguration §6 und §10, Abnahme B09 und B10. Ein gemeinsam genutzter Film, ein PDF oder ein Modul erscheint in jedem Programm an seiner dortigen Position. Die Anzeige in einem Programm entfällt nicht, weil der Inhalt woanders schon vorkommt.
- **Ist-Zustand:** Es gibt keine Programmansicht. Zwei Artikel, die dieselbe Fassung enthalten, erscheinen als zwei Berechtigungen. Öffnet man beide Artikel, sieht man die Fassung in jedem Artikel erneut. Das folgt aus je eigenem `release_contents`-Satz, nicht aus einer Programmregel. Ein Modul, das in zwei Programmen liegt, wird nicht als Modul in beiden Programmen gezeigt.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** Die neue Mehrfachregel ist nicht umgesetzt. Die ältere Formulierung im Trainingskonzept, gemeinsame Inhalte müssten in der Bibliothek nicht mehrfach erscheinen, ist durch die Produktkonfiguration §6 für den Programmkontext ersetzt. Der Code erfüllt keine der beiden Lesarten als Programmregel.
- **Empfohlene Maßnahme:** im neuen Programmdetail jede Mitgliedszeile anzeigen, auch wenn die Identität woanders vorkommt.
- **Risiko:** Mehrfachanzeige darf keine zweite Berechtigung und keinen zweiten Kauf erzeugen. Die Auslieferung bleibt an der einen Identität und der einen Fassung hängen.
### C-05 Deduplizierung nur in programmübergreifenden Einzelinhaltslisten
- **Anforderung:** Produktkonfiguration §6 und §8, Abnahme B11 und B12. In der übergreifenden Materialliste eine Karte je stabiler Identität, mit Verweisen auf die Programme. Gleiche Titel verschiedener Identitäten bleiben getrennt. Verschiedene Fassungen derselben Identität werden nicht verschwiegen.
- **Ist-Zustand:** `materials` filtert Grants und verlinkt wieder den Artikel. Es gibt keine Gruppierung nach `content_element_id`. Zwei Artikel mit demselben Film ergeben zwei Listeneinträge. Zwei verschiedene Medien mit gleichem Arbeitstitel wären ebenfalls zwei Einträge, aber nicht wegen einer Identitätsregel, sondern weil es zwei Artikel sind.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** B11 ist nicht erfüllbar. Eine Deduplizierung nach Titel wäre zusätzlich falsch und ist nicht eingebaut. B12 ist damit nicht durch eine vorhandene Deduplizierung gefährdet, aber auch nicht durch eine korrekte Identitätsliste erfüllt.
- **Empfohlene Maßnahme:** ergänzen, als eigene Materialsicht auf Identitäten, gespeist aus den berechtigten Vorkommen.
- **Risiko:** Deduplizierung nach Dateipfad oder Titel würde verschiedene Identitäten oder Fassungen zusammenziehen. Schlüssel ist die Identität, die Fassung bleibt am Vorkommen sichtbar.
### C-06 Teilweise verfügbare Programme
- **Anforderung:** Produktkonfiguration §8 und §10, Abnahme B14 und B15. Vollständig nutzbar, teilweise nutzbar, nicht nutzbar und gesperrt sind unterscheidbar. Ein Programm kann vollständig nutzbar sein, ohne als Programm gekauft worden zu sein. Gesperrte Dateien bleiben im Zusammenhang sichtbar und werden nicht ausgeliefert.
- **Ist-Zustand:** Die Bibliothek kennt nur aktive Grants. In der Artikelliste setzt `show` je Blatt `allowed` und zeigt sonst „Für diesen Teil liegt keine Freigabe vor.“ Ein gesperrter Stand oder eine gesperrte Fassung scheitert in `DecideAccess`. Es gibt keinen Programmstatus und keine Ansicht, die getrennte Artikel zu einem Programm zusammenzieht.
- **Status:** nicht erfüllt
- **Abweichung und Auswirkung:** B14 und B15 sind nicht darstellbar. Der Satz auf der Artikelseite ist ein brauchbares Verhalten für ein einzelnes Blatt, aber kein Programmstatus.
- **Empfohlene Maßnahme:** ergänzen, als Ableitung aus den vorhandenen Grants je Blatt. Keinen Grant für das Programm erzeugen, nur weil alle Teile anderweitig lizenziert sind.
- **Risiko:** Ein abgeleiteter Status „vollständig nutzbar“ darf nicht als Kauferwerb in `acquisitions` erscheinen. Sonst wird B15 zu einem fingierten Programmkauf.
### C-07 Medienanzeige, Streaming und Download
- **Anforderung:** Produktkonfiguration §11, Abnahme B16 und B21. Berechtigtes Streaming im normalen Player. Ansehen und Laden sind getrennte Dokumentaktionen. Vor jeder Auslieferung: Artikel, Stand, Fassung, Aktion, genau eine tragende Berechtigung. Signierte URLs ersetzen die Entscheidung nicht.
- **Ist-Zustand:** `LibraryController::show` verlangt für Film und Audio `streamen`, sonst `ansehen`. Die Aktion `laden` wird in der Bibliothek nie gesetzt. `media` akzeptiert `ansehen`, `streamen` und `laden`, prüft die Leser-ID und ruft `DecideAccess` erneut auf. Die Antwort ist `Storage::disk('media_derived')->response` mit `inline` oder, nur bei `laden`, `attachment`. Das Video-Element hat `controls`, `preload="metadata"` und `playsinline`. Es gibt kein `<track>` für Untertitel. `CoursePlayerTest` prüft die Seite, nicht den Dateiabruf.
- **Status:** teilweise erfüllt
- **Abweichung und Auswirkung:** Stream und Ansehen werden serverseitig entschieden, wenn die Rechte die Aktion enthalten. Ein PDF mit nur `laden` bleibt in der Oberfläche gesperrt, obwohl der Endpunkt Laden könnte. B16 ist im Code angelegt und nicht mit einer echten Datei nachgewiesen. B21 ist in der Oberfläche nicht erfüllt. Adaptive Auslieferung ist nicht vorhanden; die Soll-Spannung dazu steht in E-02.
- **Empfohlene Maßnahme:** korrigieren. Getrennte Aktionen anbieten, beide über denselben Endpunkt. Den normalen Player behalten.
- **Risiko:** Die Signatur darf weiterhin nur der Transport sein. Ein neuer Download-Knopf ohne erneutes `DecideAccess` würde die vorhandene Prüfung umgehen. Kennzeichnung und Ausgabenachweis sind nicht implementiert. Ob sie für das Bibliotheks-MVP noch denselben Rang haben wie im Architektur-Schnitt 16, ist in der neuen Prioritätenliste nicht als zurückgestellt markiert. Das ist eine offene Einordnung, keine Codeaussage. Siehe E-02.
---
## D. Produkt- und Lizenzmodell
### D-01 Trennung von Medien, Kompositionen, Lizenzartikeln und Angeboten
- **Anforderung:** Produktkonfiguration §2 und §7. Die Artikelgrenze setzt der Betreiber. Ein Programm kann ein Artikel oder ein Paket aus Modul-Artikeln sein. Der Preis gehört zur Angebotsfassung.
- **Ist-Zustand:** Getrennte Tabellen und Dienste: `ContentElement`, `Composition`, `LicenseArticle`, `Bundle`, `Offer`, `Grant`. Filament-Gruppen „Inhalte“ und „Katalog“. `ArticleService::publishRelease` bindet eine konkrete Wurzel. `BundleService` und `OfferService::scopeFor` lösen Pakete in Artikel auf. `GrantIssuer` legt je aufgelöstem Artikel einen Grant mit eigenem Schnappschuss an.
- **Status:** erfüllt
- **Abweichung und Auswirkung:** Die Trennung im Modell ist korrekt. Darstellung und Demodaten ziehen sie wieder zusammen: das Paket heißt „Demo Programm“, die Bibliothek heißt „Kurse“. Eine Abdeckungsprüfung, ob die beworbenen Kompositionen durch die Artikel tatsächlich lizenziert sind, gibt es in `OfferService::activate` nicht.
- **Empfohlene Maßnahme:** das Modell nutzen. Die fehlende Abdeckungsprüfung ergänzen. Die Bibliothek nicht aus Paketnamen gliedern.
- **Risiko:** Eine Abdeckungsprüfung darf eine bereits aktivierte Fassung nicht nachträglich verengen. Sie gilt für die nächste Angebotsfassung.
### D-02 Konfigurierbare bepreiste Angebotsfassungen
- **Anforderung:** Produktkonfiguration §7, Abnahme B20. Preise, Rechteprofile und Laufzeiten je Angebotsfassung. Eine Änderung erzeugt eine neue Fassung. Frühere Erwerbe bleiben historisch korrekt.
- **Ist-Zustand:** `ViewOffer` aktiviert eine Fassung mit Vergabeart, Preis in Cent und Positionen aus Artikel oder Paketfassung plus Rechteprofil. `OfferService::activate` legt die nächste Nummer an, schreibt `resolved_scopes` und sperrt verwendete Rechtefassungen über `locked_at`. `OfferVersion::updating` verbietet Änderungen an einer aktiven oder beendeten Fassung. `Checkout::place` kopiert Preis, Laufzeit und Recht in `order_lines` und `order_scope_items`. Die vorherige Fassung mit Status `aktiv` wird nicht beendet. `Checkout` und `GrantIssuer::activeVersion` nehmen die höchste aktive Nummer. `GrantIssuer::grantRegistrationOffers` liest alle aktiven Fassungen mit Vergabe „bei Registrierung“, ohne Sortierung je Angebot.
- **Status:** teilweise erfüllt
- **Abweichung und Auswirkung:** Neue Fassungen und Preise sind pflegbar und danach unveränderlich. Mehrere Fassungen desselben Angebots können gleichzeitig `aktiv` bleiben. Neue Käufe und der Abruf nutzen die höchste Nummer. Die Registrierungsvergabe kann bei zwei aktiven Fassungen desselben Angebots an der ersten bereits angelegten Erwerbszeile stehen bleiben, weil `issue` einen vorhandenen Erwerb unverändert zurückgibt. Ob solche Doppel-Aktivierungen in einer laufenden Datenbank existieren, ist nicht geprüft.
- **Empfohlene Maßnahme:** korrigieren, und zwar vor der Bibliothek. Die Bestandserhebung und die enge Ausnahme am Unveränderlichkeitshaken stehen in der Architekturentscheidung E-L.
- **Risiko:** `OfferVersion::updating` weist heute jede Änderung einer aktiven Fassung ab, auch einen reinen Statuswechsel nach `beendet`. Ein ungeprüftes Umschreiben von Preis oder Umfang bleibt verboten. Ob auf Test oder Produktion bereits mehrere aktive Fassungen desselben Angebots liegen, ist nicht nachgewiesen. Eine Bereinigung setzt die lesende Bestandsaufnahme voraus.
### D-03 Unveränderliche Vertrags- und Berechtigungsdaten
- **Anforderung:** Produktkonfiguration §4 Klasse C und §7. Kaufumfang, Bedingungen und Berechtigung bleiben an der Erwerbsquelle fixiert. Anzeigedaten dürfen sich ändern, ohne diese Kopien umzuschreiben.
- **Ist-Zustand:** `grants.rights_snapshot`, `release_at_grant_id`, `order_lines.price_cents` und `order_scope_items.rights_snapshot` werden beim Erwerb geschrieben. `DecideAccess` liest den Schnappschuss, nicht das live bearbeitbare Rechteprofil. Die sichtbare Bestellzeile nutzt dennoch den aktuellen `offers.name`. Didaktische Titel liegen auf der Identität und sind absichtlich nicht in der Bestellung kopiert.
- **Status:** teilweise erfüllt
- **Abweichung und Auswirkung:** Preis, Recht und Artikel des Kaufs bleiben stehen. Die sichtbare Angebotsbezeichnung nicht. Ein späterer Leser der Bestellung sieht den heutigen Namen.
- **Empfohlene Maßnahme:** ergänzen, eine Bezeichnungskopie an der Bestellzeile. Vorhandene Schnappschüsse nicht migrieren, außer um die damals gültige Bezeichnung einmalig zu sichern, und nur nach gesonderter Freigabe.
- **Risiko:** Ein nachträgliches Füllen alter Bestellnamen aus dem heutigen `offers.name` würde die Historie verfälschen, wenn das Angebot schon umbenannt wurde. Ob das in den Daten vorkommt, ist nicht nachgewiesen.
### D-04 Rechteprüfung bei jeder tatsächlichen Medienaktion
- **Anforderung:** Produktkonfiguration §11. Prüfung von Artikel, veröffentlichtem Stand, enthaltener Fassung und Aktion. Genau eine tragende Berechtigung. Themen, Thumbnails und Kompositionszugehörigkeit vergeben keine Rechte.
- **Ist-Zustand:** `DecideAccess` prüft Konto, Artikel des Stands, Freigabestatus, Vorkommen in `release_contents`, Sperre der Fassung, Gültigkeit und ob der Schnappschuss die Aktion für die Ausgabeklasse enthält. Bei mehreren passenden Grants wird eine ausgewählt, die Fähigkeiten werden nicht vereinigt. `LibraryController::media` ruft dieselbe Prüfung nach der Signatur erneut auf. Säulen und die nicht vorhandenen Thumbnails kommen in der Entscheidung nicht vor. Die Vorschau `content.preview` ist an `auth:staff` gebunden, nicht an einen Grant.
- **Status:** erfüllt
- **Abweichung und Auswirkung:** Die Prüfung tut das Verlangte für die Aktionen, die sie erreicht. Die Bibliothek ruft Laden nicht auf, siehe C-07. Ein Test, der eine echte Datei nur mit `streamen` holt und `laden` abweist, fehlt.
- **Empfohlene Maßnahme:** bestehende Funktion nutzen und für Laden denselben Weg erzwingen.
- **Risiko:** Eine Bibliothek, die Dateien bereits beim Rendern der Seite ohne diese Prüfung ausliefert, würde die Invariante aufgeben. Signierte Links müssen kurz bleiben und die Aktion enthalten.
### D-05 Keine Vermischung zu einem stärkeren Nutzungsrecht
- **Anforderung:** Produktkonfiguration §7, Abnahme B17. Kommerzielles Streaming und ehrenamtlicher Download ergeben keinen kommerziellen Download. Quellen bleiben getrennt. Die Bibliothek darf sie verständlich zusammenfassen.
- **Ist-Zustand:** `DecideAccess` filtert Grants einzeln. Ein Grant muss Zweck nicht mit einem anderen Grant kombinieren, weil der Zweck im Schnappschuss liegt und die Aktion nur gegen diesen einen Schnappschuss geprüft wird. Die Bibliothek fasst Grants nicht zusammen. Sie zeigt sie unter Berechtigungen als Artikelschlüssel, Zweck und Datum. Ein Test, der zwei Grants mit verschiedenen Zwecken gegeneinander stellt, ist nicht vorhanden. `CatalogRulesTest` legt einzelne Grants an.
- **Status:** erfüllt
- **Abweichung und Auswirkung:** Die Entscheidung vermischt Rechte nicht. Die fehlende Zusammenfassung ist eine Darstellungslücke, kein zu starkes Recht. B17 ist am Code nachvollziehbar und nicht durch einen Negativtest festgehalten.
- **Empfohlene Maßnahme:** die Entscheidung unverändert lassen. Einen Negativtest ergänzen. Eine spätere Zusammenfassung darf nur anzeigen, nicht die Schnappschüsse mergen.
- **Risiko:** Hoch, wenn eine „wirksame Rechte“-Menge als Vereinigung aller Grants gebaut wird. Das wäre ein neues, nicht erworbenes Recht.
---
## E. MVP-Abgrenzung des Players
### E-01 Normaler Player und didaktisches Add-on
- **Anforderung:** Produktkonfiguration §1, §11 und §14 sowie Architekturabgleich A06. Play, Pause, Zeitsuche, Vollbild und Lautstärke sind MVP. Automatische Denkpause, Ablaufsteuerung, Präsentationsmodus, Fortschritt und zweites Gerät sind Add-on. Felder für spätere Zeitmarken dürfen bleiben.
- **Ist-Zustand:** `resources/views/content/player.blade.php` und das Video auf der Mitgliedsseite nutzen das Browser-Element mit `controls`. Das liefert die üblichen Bedienfunktionen des Browsers. `resources/js/app.js` reagiert auf `data-course-decision` und `data-course-restart`: Sprung zur Marke und Pause, sowie Neustart. Es gibt kein `timeupdate`, also keine automatische Pause beim Erreichen der Marke. Kein Präsentationsmodus, kein Fortschritt, kein zweites Gerät. `decision_seconds` liegt in den Fassungsmetadaten und erzwingt beim Ändern eine neue Inhaltsfassung. `LibraryController` und `member/article.blade.php` reichen die Marke an den Player. Die Verwaltungsvorschau zeigt die Marke nicht als Knopf. `CoursePlayerTest` verlangt den Knopftext „Zur Entscheidungsmarke“.
- **Status:** widersprüchlich
- **Abweichung und Auswirkung:** Der normale Player ist vorhanden und an dieselbe Seite gebunden wie ein früher didaktischer Knopf. Der Knopf ist kein automatischer Kursplayer, blockiert die Trennung aber, weil Test und Mitgliedsansicht ihn zum erwarteten Verhalten machen. Die Marke als Datenfeld ist mit dem Add-on vereinbar. Ihre Kopplung an einen neuen Inhaltsrelease ist Klasse B und darf bleiben, solange sie Lehrinhalt ist und kein Thumbnail.
- **Empfohlene Maßnahme:** korrigieren, klein und abgegrenzt. In der Bibliothek den Browser-Player ohne Entscheidungsmarke ausliefern. Den Knopf und den Test aus dem MVP-Pfad nehmen. Das Metadatenfeld nicht löschen.
- **Risiko:** Gering für Daten. Ein Entfernen von `decision_seconds` aus vorhandenen Fassungen wäre eine verbotene Änderung bereitgestellter Versionen. Die Abhängigkeit ist auf drei Stellen begrenzt: `LibraryController`, `member/article.blade.php`, `resources/js/app.js`, plus der Test. Es gibt keine Player-Bibliothek, keinen Fortschrittsspeicher und keine zweite Route, die eine Trennung erschweren würde.
### E-02 Soll-Spannung bei Streaming, Kennzeichnung und Nachweis
- **Anforderung:** Produktkonfiguration §1 nennt einfaches geschütztes Videostreaming als P0. §11 verlangt zusätzlich „adaptive und geschützte Medienausgabe gemäß bestehendem Medienkonzept“ sowie Kennzeichnung und Ausgabenachweis, soweit das bestehende Modell das verlangt. Der Architekturabgleich A06 stellt nur den didaktischen Player zurück, nicht ausdrücklich das adaptive Streaming.
- **Ist-Zustand:** Die Auslieferung ist eine signierte Dateiantwort aus `media_derived`, kein HLS und keine Varianten. `docs/betrieb/MVP-Stand.md` sagt, adaptives Streaming, persönliche PDF-Kennzeichnung und Ausgabenachweis seien noch nicht der Zielschnitt. Originaldateien unter `/srv/luf/test/media/originals` und `/srv/luf/prod/media/originals` werden von PHP nicht geschrieben.
- **Status:** widersprüchlich
- **Abweichung und Auswirkung:** Gegen die neue P0-Zeile fehlt ein einfacher geschützter Player nur noch in der fachlich richtigen Bibliothek, nicht ein kompletter Streaming-Stapel. Gegen §11 und den Architektur-Schnitt 16 fehlen Adaptivität, Kennzeichnung und Nachweis. Der Ist-Stand bleibt widersprüchlich. Die Einordnung in zwei Stufen ist die Entscheidung E-M, kein neuer Codebefund.
- **Empfohlene Maßnahme:** nicht streichen. Die Architekturentscheidung E-M trennt eine intern testbare Bibliothek von der kommerziell freigabefähigen Medienausgabe und nimmt adaptives Streaming, Kennzeichnung und Ausgabenachweis als eigenes Paket auf.
- **Risiko:** Ein Umbau der Dateiablage, der vorhandene `derived`-Pfade in Artikel-Ständen ungültig macht, würde bereits hochgeladene Fassungen unlesbar machen. Ob auf der Testinstanz solche Dateien liegen, ist nicht geprüft.
---
## Was nicht nachgewiesen ist
- Ob auf Test oder Produktion bereits Filme, Artikel oder mehrere aktive Angebotsfassungen liegen.
- Ob ein Upload von 2 GB bei `memory_limit = 512M` in PHP tatsächlich scheitert. Die Grenzen stehen in `docker/php.ini` und `docker/nginx/default.conf`. Ein Lauf fehlt.
- Ob die Queue auf der Testinstanz Dateien nach `derived/` übernimmt.
- Bedienbarkeit auf Smartphone, Tablet und Desktop. Es gibt keine responsive Prüfung und keine PWA-Prüfung in dieser Sichtung.
- Ob `compositionUsage` in einer alten Oberfläche sichtbar war. Im aktuellen Code gibt es keinen Aufruf.
## Folgerung für die Umsetzung
Erhalten bleiben Identität, Fassung, Mitgliedschaft, Artikel-Stand, Angebotsfassung, Grant und `DecideAccess`.
Ersetzt werden die Mitgliedsansichten, die Berechtigungen als Kurse und Dateien als flache Liste zeigen.
Die Review vom 15.11.2026 ändert die Reihenfolge und schließt die vorher offenen Punkte zu Typ, Angebotsfassung, Medienabgrenzung und Frontend-Umfang. Das steht in den folgenden Entscheidungen. Der priorisierte Plan steht in `docs/analysen/umsetzungsplan-mitgliederbibliothek.md`.
## Architekturentscheidungen nach der Review
Diese Entscheidungen sind neu. Sie sind keine zusätzlichen Codebefunde. Ist-Zustand und Status der Abschnitte A bis E bleiben bestehen.
### E-A Auflösung von Programm und Berechtigung
**Entscheidung.** Die Mitgliederbibliothek liest die Struktur aus redaktionell zur Anzeige freigegebenen Kompositionsfassungen. Kommerziell veröffentlicht ist daran nicht beteiligt. Ein Paket, ein Angebot oder ein Grant ist kein Elternknoten.
Technische Bereitschaft und Anzeigefreigabe sind zwei Schritte. Status `bereit` bedeutet nur, dass die Fassung vollständig und nicht gesperrt ist. Sie erscheint deshalb noch nicht in der Bibliothek. Die redaktionelle Freigabe zur Anzeige bezieht sich auf genau diese Fassung, ändert ihre Mitglieder nicht und legt keinen Lizenzartikel an. Eine neuere bereite Fassung ohne eigene Freigabe ersetzt eine freigegebene Fassung nicht.
Gezeigt wird genau die freigegebene Fassung, mit den in `composition_members` gespeicherten Kindesfassungen und Rollen. Mitglieder aus einer älteren und einer neueren Fassung werden nicht in einem Baum gemischt. Die Kinder sind Teil dieser einen freigegebenen Struktur. Eine eigenständige Modulansicht braucht eine eigene Freigabe der Kindesfassung.
**Präzisierung aus dem Website-Zielkonzept, ohne zweiten Freigabemechanismus.** Dieselbe Anzeigefreigabe (G2) und derselbe Strukturleser (G1) gelten für Bibliothek und öffentliche Seite. Öffentlich gelistet ist eine weitere Entscheidung an der Identität und keine zweite Freigabe der Struktur. Sie verweist nur auf eine bereits zur Anzeige freigegebene Fassung.
Eine öffentlich gezeigte Programmfassung stellt jedes enthaltene Modul an seiner Position als Strukturzeile dar: Anzeigetitel, gesetzte Inhaltsart, Rolle und die Materialien dieser Kindesfassung. Dafür braucht das Modul weder eine eigene Anzeigefreigabe noch eine eigene öffentliche Seite. Ein Verweis auf eine Modulseite entsteht nur, wenn diese Seite dieselbe Kindesfassung zeigt. Zeigt sie eine andere Fassung, bleibt die Zeile ohne Verweis. Die Modulseite beschreibt dann nicht Lernziele oder Bestandteile, die das Programm nicht enthält.
Historische Fassungen bleiben ganze Stände. Struktur, Rollen, Reihenfolge und didaktische Lehrtexte kommen aus der gezeigten Fassung. Der Anzeigetitel der Identität ist Klasse A und ist auf allen Ständen derselbe. Eine neuere, nur bereite Fassung ersetzt weder in der Bibliothek noch öffentlich die bisher gezeigte Fassung. Weicht der aktuelle Artikel-Stand von der gezeigten Fassung ab, bleibt die gezeigte Fassung stehen, und es entsteht ein Befund statt einer gemischten Ansicht.
Ein Programm gelangt in die persönliche Bibliothek nur, wenn diese Programmfassung zur Anzeige freigegeben ist und die Person an mindestens einem Blatt genau dieser Fassung eine gültige Berechtigung hat, oder wenn ein berechtigter Artikel-Stand diese freigegebene Fassung als Wurzel hat. Der Zugriff auf einen enthaltenen Film reicht nicht. Liegt der Film in einer nur bereiten, nicht freigegebenen Programmfassung, erscheint er über seinen eigenen Artikel als Material, ohne Programmbaum, ohne Pfad und ohne Hinweis auf diese Fassung. Die Verwaltung darf die Verwendung weiter sehen. Die Mitgliederansicht nicht.
Alle übrigen Programme bleiben außerhalb dieser Bibliothek. Ihre öffentliche Vorstellung gehört zum separaten Auftrag für Design, Website und CMS.
Jedes Blatt wird einzeln zurückgeführt:
1. Kandidat ist ein Artikel-Stand mit Status veröffentlicht oder abgelöst-verfügbar, dessen `release_contents` genau diese Inhaltsfassung enthält, und zu dessen Artikel die Person mindestens einen zeitlich gültigen, aktiven Grant hat.
2. Für die angeforderte Aktion gilt das vorhandene `DecideAccess`. Es trägt genau ein Grant. Schnappschüsse werden nicht vereinigt.
3. Mehrere Erwerbsquellen dürfen genannt werden. Die Auslieferung nennt die eine tragende Quelle. Entfällt sie, wird neu entschieden.
4. Der Blattstatus ist nutzbar, wenn für die angebotene Aktion ein Kandidat trägt; gesperrt, wenn Fassung oder Stand gesperrt ist oder kein Schnappschuss die Aktion erlaubt; sonst nicht nutzbar. Der Knoten bleibt sichtbar. Eine Datei-URL gibt es nur bei nutzbar, und die Ausgabe prüft erneut.
Der Programmstatus wird nur aus den Blättern der angezeigten Fassung abgeleitet: vollständig nutzbar, teilweise nutzbar, nicht nutzbar oder gesperrt. Vollständig nutzbar schreibt keinen Erwerb. Die Kennzeichnung „als Programm erworben“ steht nur, wenn ein Grant auf einem Artikel liegt, dessen Stand diese Kompositionsfassung als Wurzel hat.
Die vorausgewählte Fassung ist der Wurzelstand des berechtigten aktuellen Artikel-Releases, falls diese Fassung zur Anzeige freigegeben ist. Sonst die höchste zur Anzeige freigegebene Programmfassung, die mindestens ein berechtiges Blatt enthält. Eine höhere nur bereite Fassung wird nicht gewählt. Ältere freigegebene Fassungen, deren eigene Blätter berechtigt sind, bleiben als ganze Stände erreichbar. Nur bereite ältere Fassungen nicht.
Dieselbe Inhaltsidentität erscheint in jedem Programm an der dort gespeicherten Position. Die programmübergreifende Materialliste gruppiert nach `content_elements.id`. Verschiedene Fassungen derselben Identität bleiben an den Vorkommen sichtbar und werden nicht zu einer fassungslosen Karte.
### E-T Fachliche Typen
**Entscheidung.** Technische Struktur und redaktionelle Inhaltsart sind getrennt. Fachliche Typen werden nicht dauerhaft auf `CompositionKind` beschränkt und vorhandene Zeilen nicht automatisch umgedeutet.
Die technische Struktur bleibt der vorhandene Enum mit den gespeicherten Werten `kurs`, `uebung` und `kombination`. Er trägt Verschachtelung, Zyklenprüfung und die bestehenden Verwaltungsmasken. Es kommt dafür kein Wert `modul` oder `programm` hinzu. Gespeicherte Werte werden nicht umbenannt und nicht still als Programm oder Modul angezeigt. Ohne gesetzte Inhaltsart zeigt die Bibliothek die bisherige Bezeichnung des gespeicherten Werts: Kurs, Übung, fachliche Kombination.
Die redaktionelle Inhaltsart ist konfigurierbar, mit stabiler Kennung, und wird je Identität ausdrücklich gesetzt. Programm, Modul, Merkblatt und Traineranleitung sind Werte dieser Art, keine neuen Code-Enums. Bestehende Zeilen bleiben ohne Zuordnung, bis jemand sie setzt. Eine Zuordnung ändert `kind` und `output_class` nicht und erzeugt keine neue Fassung.
Die erste Bibliothek liest diese eine Inhaltsart bereits. Weitere Dimensionen wie Säule, Alter und Einsatzbereich folgen später und legen keine zweite Inhaltsartenliste an. Weichen gesetzte Inhaltsart und technischer Strukturtyp voneinander ab, zeigt die Karte die Inhaltsart und behandelt den Enum nur als technische Herkunft.
Blätter ohne Inhaltsart zeigen den gespeicherten `kind` und die `output_class` sowie die Rolle der Verwendung. Ein einzelnes PDF wird durch eine gesetzte Art Merkblatt zum Merkblatt. Ohne diese Zuordnung bleibt es ein PDF und wird nicht zum Programm.
### E-L Lizenz- und Bestellkorrektur
**Entscheidung.** Die Aktivierung genau einer aktuellen Angebotsfassung, die Registrierungsvergabe nur dieser Fassung und die Bezeichnungskopie neuer Bestellungen liegen vor der Bibliothek.
Der Unveränderlichkeitshaken an `OfferVersion` erlaubt heute keinen Übergang von `aktiv` nach `beendet`. Die Umsetzung darf nur diesen einen Feldwechsel zulassen. Preis, Umfang und Recht bleiben gesperrt.
Bestehende Daten werden vor jeder Bereinigung nur gelesen. Solange Dubletten nicht freigegeben bereinigt sind, vergibt die Registrierung trotzdem nur die höchste aktive Nummer je Angebot. Alte Grants bleiben. Alte Bestellungen ohne Bezeichnungskopie werden nicht aus dem heutigen Angebotsnamen gefüllt.
### E-M Zwei Stufen der Medienausgabe
**Entscheidung.** Die intern testbare Bibliothek liefert die berechtigte Datei signiert an den normalen Browser-Player und trennt Ansehen und Laden. Adaptives Streaming, Kennzeichnung und Ausgabenachweis werden nicht gestrichen. Sie bleiben Pflichtpaket. Eine kommerzielle Freigabe setzt dieses Paket und alle übrigen MVP-Pflichtpakete voraus, nicht nur die Medienausgabe und nicht einen früheren Zwischenstand. Die technische Zwischenabnahme wartet nicht auf die Medienausgabe.
### E-W12 Didaktische Metadaten
**Entscheidung, abgegrenzt.** Lernziele, Zeitbedarf und Materialbedarf sind Lehrinhalt der Klasse B an der Kompositionsfassung. Sie fehlen im Code und in den Paketen 0 bis 9. Sie werden einmalig ergänzt, bevor Programm- und Modulseiten öffentlich vollständig erscheinen. Der Strukturleser G1 liest sie aus derselben Fassung. Ein zweites Feld, eine zweite Fassungstabelle oder ein zweiter Leser entsteht nicht. Vorhandene Fassungen bleiben leer. Eine Änderung legt eine neue Kompositionsfassung an und schreibt die bisherige nicht um.
### E-D Design, Website und CMS
**Entscheidung.** Designsystem, öffentliche Website und CMS-Neubau sind ein separater Auftrag. Dieser Plan verwendet das vorhandene Seitenlayout, funktionale Listen und den Browser-Player. Einfache Thumbnails, als geschütztes Bild oder neutraler Platzhalter, gehören dazu. Keine neue Komponentenbibliothek, keine öffentlichen Themenseiten und keine CMS-Bausteine werden dafür neu gebaut.
@@ -0,0 +1,170 @@
# Premium-Karten v1.7 im CMS – Bericht (18.11.2026)
Branch `feature/premium-karten`, gearbeitet in einem separaten Worktree. Deploy ausschließlich über `develop` (Testinstanz, Port 3011). **Kein Merge nach `main`.** Entscheidung: ADR-39; Technik: `docs/architektur/cms-widget-registry.md` §13.
Grundlage: `docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf`. Das Kit ist ein **Entwurf zur visuellen Freigabe**. `FREIGABE.md` führt alle drei Varianten als „zur visuellen Freigabe“. Aus der Integration folgt keine Freigabe.
## 1. Ergebnis
Redakteure können die drei Kartenarten in regulären Abschnitten einsetzen, mit bestehenden Fachobjekten verbinden und gestalten, ohne Code zu ändern:
| Widget | Fachobjekt | Öffentlich sichtbar | Aktion |
|---|---|---|---|
| Themenkarte | veröffentlichtes Thema (Säule) | ja | „Thema entdecken“ → `/themen/{slug}` |
| Medien- und Materialkarte | Inhaltselement mit bereitgestellter Fassung | nur als Bestandteil eines öffentlichen Programms, sonst nur in der Redaktionsvorschau | „Im Programm ansehen“ → Programmseite |
| Programm- oder Modulkarte | Programm oder Modul mit Anzeigefreigabe | Programme ja, Module nur in der Redaktionsvorschau | „Programm ansehen“ → `/programme/{id}`; Module ohne Aktion |
- **Gespeichert** werden nur Kennungen, Bild, Alternativtext, Bildausschnitt, die Beschriftung der Aktion und ein kurzer Hinweis. Titel, Beschreibung, Art und Linkziel liest die Karte bei jeder Darstellung aus den Fachdaten. Eine Änderung am Thema oder Programm erscheint deshalb ohne Seitenbearbeitung.
- **Gestaltung:**
- Variante: Anpassend (ab 520 px Bild neben Text) oder Bild immer oben.
- Höhe: Natürlich oder An die Zeile angleichen.
- Bildformat: 16:9, 1:1 oder 3:4.
- Bilddarstellung: Ausschnitt oder ganzes Bild.
- Bildausschnitt in Prozent.
- Überschriftenebene: H2, H3 oder H4.
- Ein- und Ausblenden von Kurzbeschreibung, Art, Zusatzangaben und Aktion.
- **Raster:**
- Eine Karte je Platz im bestehenden Abschnittsraster; es gibt kein zweites Kartenraster.
- Neu sind die Raster 1 + 1 + 2 und 2 + 1 + 1. Bestehende Raster und Kennungen sind unverändert.
- **Keine Freigabe geschützter Inhalte:**
- keine Vorschaubilder der Bibliothek
- keine Adressen unter `/bereich/` oder `/redaktion/`
- kein Abspielen, kein Download
- kein Preis, keine Kaufaktion
## 2. Prüfungen
| Prüfung | Ergebnis |
|---|---|
| Testsuite (`php artisan test`) | 212 grün, davon 8 neu in `CmsPremiumCardsTest` |
| CI Feature-Branch / Deploy Testinstanz | 4846 / 4847 erfolgreich (Code); Folgecommits siehe Git-Verlauf |
| Bestehende Seiten vor und nach dem Deploy | unverändert: 16 Messungen (8 Seiten × 1440/390 px), Lage und Maße aller Abschnitte und Plätze; 12 Textschnappschüsse des Hauptbereichs |
| Lokale Probe des Redaktionsablaufs (Wegwerfdatenbank) | 114 von 114 Prüfungen. Abläufe: Thema veröffentlichen; Entwurfsseite anlegen mit 1 + 1 + 2, 2 + 2, 4/4, 1 + 1 + 1 + 1 und 1 + 3; Karte wieder öffnen und bearbeiten; speichern; Redaktionsvorschau; veröffentlichen. Messung bei 1440, 1024, 768 und 390 px: gleiche Höhe je Zeile, Bild neben Text genau ab 520 px Kartenbreite, keine Karte schmaler als 240 px, kein Überlauf, keine geschützten Adressen. **Gilt nicht als Abnahme auf der Testinstanz.** |
| Redaktionsablauf auf der Testinstanz | **offen.** Das Skript ist fertig, in dieser Sitzung fehlten die Zugangsdaten des Prüfkontos. |
**Feature-Tests** (`tests/Feature/CmsPremiumCardsTest.php`):
- Fachbezug ohne Kopie: Die Revision enthält nur Kennungen; Namensänderungen erscheinen sofort.
- Rückzug: Wird ein Thema zurückgezogen oder ein Element archiviert, verschwindet die Karte.
- Programmkarten benennen ihre Art, ohne Bild über die Navy-Tafel. Module erscheinen nur in der Vorschau, mit Hinweis. Kein Preis, keine Kaufbegriffe.
- Medienkarten:
- erscheinen öffentlich nur über ein öffentliches Programm, mit Link auf die Programmseite;
- geben keine Bibliotheksvorschau, keine geschützte Adresse, kein Video und keinen Inhalt aus;
- zeigen keine Kurzbeschreibung.
- Abweisung:
- nicht veröffentlichter oder nicht freigegebener Objekte;
- eines Bildes ohne Alternativtext;
- freier Einstellungswerte.
- Gemischte Raster (1 + 1 + 2, 2 + 2): gleiche Höhe, Bildformat, Bildausschnitt, Variante, Optionen, lange Texte ungekürzt.
- Redaktionsablauf über den Editor (Livewire):
- alle drei Karten anlegen; als Entwurf gespeichert;
- wieder öffnen; Dialog mit den Reitern Inhalt, Medien und Darstellung;
- Live-Vorschau; erneut speichern; veröffentlichen.
## 3. Grenzen und offene Punkte
1. **Öffentliche Felder der Medienkarte (Entscheidung von Lars).** Heute nennt nur die Programmseite Bestandteile, und zwar nur mit Titel.
- Die Karte zeigt öffentlich den Titel (Anzeigetitel, sonst Arbeitstitel), die Inhalts- und Ausgabeart und die Programmzugehörigkeit.
- Die Kurzbeschreibung bleibt aus.
- Zu prüfen: ob bei Traineranleitungen schon der Titel öffentlich sein darf.
2. **ADR-29 (öffentliche Profile).** Bis dahin sind Module und Medien ohne öffentliches Programm nur in der Redaktionsvorschau sichtbar. Profile ersetzen später die Übergangsregeln in `PublicCatalogReader` und `PublicMaterialReader`; gespeicherte Karten bleiben gültig.
3. **Gestalterische Freigabe v1.7** und freigegebene Motive. Auf der Testinstanz stehen nur gekennzeichnete Platzhalterbilder.
4. **Zusatzangaben** gibt es nur, soweit die Fachdaten sie hergeben: Ausgabeart, Programmzugehörigkeit, Modulanzahl. Laufzeit, Altersangabe oder Seitenzahl fehlen in den Fachdaten.
5. **Gleiche Höhe** wird je Karte eingestellt, nicht je Abschnitt. Alle Karten einer Zeile müssen „An die Zeile angleichen“ tragen.
6. **Entfallende Plätze.** Eine öffentlich nicht sichtbare Karte (Modul) lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Hinweis für die Redaktion in §13 der Registry-Dokumentation.
7. **Kaufbare Angebotskarte: offener Bedarf.** Die Karten tragen bewusst keinen Preis und keine Kaufaktion. Eine Angebotskarte braucht ein eigenes Fachobjekt „Angebot“ mit Umfang, Zweck, Lizenzbedingungen und Preisquelle aus dem kommerziellen System. Sie ist gesondert zu konzipieren (Zielkonzept: „Angebotskarte … Neu konzipieren“, Lizenzvergleich).
8. **Validierungsmeldungen** sind teils englisch, weil `lang/de` fehlt. Das ist bekannt und unverändert.
## 4. Abweichungen vom Kit
- Kein Beispielraster (`.lf-pc-grid`) und keine Spannweitenklassen; das Abschnittsraster ist das einzige Raster.
- Umschaltung bei 520 px über den Platz-Container.
- Keine H1.
- Gelber Akzent als SVG-Komponente.
- Schriftgewicht 600 statt 750, weil nur vorhandene Schnitte verwendet werden.
- Bildhöhe höchstens min(70vh, 640 px).
- Karten, die nur in der Vorschau erscheinen, mit gestricheltem Rand.
## 5. Fachliche Nachbesserung nach der Betreiberprüfung (18.11.2026)
Branch `feature/premium-karten-nachbesserung`, separater Worktree, Deploy nur über `develop`. Keine neue Widget-Art, keine neuen Fachobjekte, keine Migration, keine Änderung an Lizenz- oder Kaufrechten.
**Ursache „keine Themen“.** Die Themenkarte bot nur veröffentlichte Säulen an. Auf der Testinstanz gibt es fünf Säulen (lesende Abfrage am 18.11.2026), keine ist veröffentlicht, keine hat eine öffentliche Adresse oder einen Text für die Website. Jetzt sind alle Säulen wählbar; öffentlich gilt unverändert die Regel der Themenseiten (veröffentlicht und mit Adresse).
**Datenstand der Testinstanz (lesend geprüft):**
- 5 Säulen, unveröffentlicht, ohne Website-Text; Säule 1 hat ein zugeordnetes Medium, Säule 2 eine veröffentlichte Seite.
- Film „Lara im Park“: bereitgestellte Fassung, Filmstandbild (aus dem Film bei 41,5 s), Beschreibung vorhanden, **keine Kurzbeschreibung und kein Anzeigetitel**; Bestandteil von „Programm Abstand“ (über Modul Abstand) und der UX-Prüfung, beide öffentlich.
- Zwei weitere Filme nur als Entwurf; Textmaterialien ohne Inhaltsart; eine gesperrte Traineranleitung.
- Module mit Lernziel, Dauer und Materialhinweis; zwei Module mit Vorschaubild; keine Kurzbeschreibungen außer einem Entwurfsmodul.
- Keine Laufzeiten in den Mediendaten (Metadaten nur `file`, `held`).
### Themenkarte
| | |
|---|---|
| Verfügbare Fachdaten | Name, öffentliche Adresse, Text für die Website, Veröffentlichung, zugeordnete Seiten und Medien |
| Dargestellt | Name, Text für die Website, „N Seiten zum Thema“ (veröffentlichte Seiten), Aktion auf `/themen/{slug}` |
| Redaktion | alle Säulen wählbar, mit Status „veröffentlicht“ / „nicht veröffentlicht, nur Redaktionsvorschau“; Vorschau mit Hinweisen auf fehlenden Text und fehlendes Kartenbild |
| Fehlt | auf der Testinstanz: Veröffentlichung, Adresse und Text aller Säulen (Pflege unter „Fachliche Säulen“) |
| Bewusst | kein Themenbild aus Medien des Themas (geschützt); Bild nur als Kartenbild aus dem öffentlichen Website-Bereich |
### Medien- und Materialkarte
| | |
|---|---|
| Verfügbare Fachdaten | Arbeits- und Anzeigetitel, Kurzbeschreibung, Beschreibung, Einsatzhinweis, Lizenzvermerk, Inhaltsart, Ausgabeart, Fassungsstatus, Vorschaubild (Filmstandbild, geschützt), Programmzugehörigkeit |
| Dargestellt | **Film:** Titel, Kurzbeschreibung, Inhalts- und Ausgabeart, „Im Programm …“, „Vollständiger Film nur mit Lizenz im Mitgliederbereich“, Filmtafel; Aktion auf die öffentliche Programmseite. **Material:** eigene Darstellung mit Materialsymbol, Titel, Kurzbeschreibung, Art. **Vorschau:** Filmstandbild der Bibliothek mit Marke „Bibliotheksbild · nur Vorschau“ |
| Unterschieden | öffentliche Filmvorschau: **gibt es fachlich noch nicht** (keine eigene Ausgabe, keine Freigabe); geschützter vollständiger Film: nie über die Karte, nur Hinweis; Film ohne freigegebenes Vorschaumaterial: öffentlich Filmtafel oder redaktionelles Kartenbild |
| Redaktion | Filme und Materialien mit Entwurfs- oder bereitgestellter Fassung wählbar (gesperrte nicht), Sichtbarkeit in der Auswahl; Hinweise auf fehlende Kurzbeschreibung, Anzeigetitel, freigegebenes Bild |
| Fehlt | Kurzbeschreibungen und Anzeigetitel in den Medien; Laufzeit in den Mediendaten; Freigabe von Vorschaubildern für die Website; öffentliche Filmvorschau (Erweiterungsbedarf: `cms-widget-registry.md` §13) |
| Bewusst | Traineranleitungen nie öffentlich; nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Dateien; kein Abspielen, kein Download |
### Programm- und Modulkarte
| | |
|---|---|
| Verfügbare Fachdaten | Bezeichnung, Anzeigetitel, Kurzbeschreibung, Inhaltsart, Fassungen mit Lernziel, Dauer, Materialhinweis, Anzeigefreigabe, Vorschaubild (geschützt), Bestandteile |
| Dargestellt | Titel, Kurzbeschreibung (sonst Lernziel; auf der Programmseite bereits öffentlich), Art „Programm“/„Modul“, Zahl der Module, Dauer, Navy-Tafel; Aktion nur für Programme mit Anzeigefreigabe; Vorschau: Vorschaubild der Bibliothek, markiert |
| Redaktion | Programme und Module mit bereitgestellter Fassung wählbar, auch ohne Anzeigefreigabe (nur Vorschau); Hinweise auf fehlende Kurzbeschreibung und Dauer |
| Fehlt | Kurzbeschreibungen; öffentliche Modulseite (ADR-29, nicht Teil dieses Auftrags); Freigabe von Vorschaubildern |
| Bewusst | kein künstlicher Link für Module; kein Materialhinweis öffentlich; kein Preis, keine Kaufaktion |
### Prüfungen der Nachbesserung
| Prüfung | Ergebnis |
|---|---|
| Testsuite | 214 grün (Kartentests 10, davon neu: Entwurf/ohne Freigabe nur in der Vorschau, unveröffentlichte Themen; erweitert: Film/Material, Traineranleitung, keine internen Felder, Bibliotheksbild nur in der Vorschau) |
| Lokaler Redaktionsablauf mit nachgebildetem Datenstand der Testinstanz | 32 von 32: vorhandene Säule, Film, Material, Modul, Programm in 1 + 1 + 2, 2 + 2, 4/4, 1 + 1 + 1 + 1; speichern, wieder öffnen, bearbeiten, speichern; Vorschau bei 1440/1024/768/390 px (alle Karten mindestens 240 px, kein Überlauf, gleiche Höhe je Zeile); Entwurfsseite öffentlich nicht erreichbar. **Gilt nicht als Abnahme auf der Testinstanz.** |
| Redaktionsablauf auf der Testinstanz (Prüfkonto, regulärer Seitenkonfigurator) | **32 von 32.** Die Auswahl bietet alle fünf Säulen und alle Filme und Materialien mit Sichtbarkeit an. Gewählt wurden „Meine Grenzen“, „Lara im Park“, ein Textmaterial, die Module „Freigabe mit Anleitung“ und „Modul Abstand“ sowie „Programm Abstand“, verteilt auf 1 + 1 + 2, 2 + 2, 4/4 und 1 + 1 + 1 + 1. Danach: Entwurf angelegt, wieder geöffnet, bearbeitet, gespeichert. Vorschau bei 1440/1024/768/390 px: alle 10 Karten, mindestens 240 px breit, kein Überlauf, gleiche Höhe je Zeile. Das Filmstandbild erscheint nur in der Vorschau, markiert. Die Entwurfsseite `/karten-nachbesserung-entwurf` (Seite 19) ist öffentlich nicht erreichbar (404). Es wurde nichts veröffentlicht. |
### Was die Karten mit den heutigen Daten der Testinstanz zeigen
- **Programmkarte „Programm Abstand“** (öffentlich): Titel, Lernziel als Text, „2 Module“, „Dauer 25 Min.“, Navy-Tafel, Aktion auf die Programmseite. Die vollständigste Karte.
- **Filmkarte „Lara im Park“** (öffentlich über „Programm Abstand“): Titel, Filmtafel, „Film“, „Im Programm …“, Hinweis auf den geschützten Film, Aktion auf die Programmseite. **Kein Text, weil das Medium keine Kurzbeschreibung hat**; in der Vorschau zusätzlich das Filmstandbild, als nicht öffentlich markiert.
- **Materialkarte „Trainerunterlage Abstand“** (öffentlich über „Programm Abstand“): Titel, Materialsymbol, „Text“, Programmbezug.
- **Modulkarten**: nur in der Vorschau, mit Lernziel und Dauer; „Mod - eigene Grenzen erkennen“ mit Vorschaubild der Bibliothek (markiert).
- **Themenkarten**: nur in der Vorschau, weil keine Säule veröffentlicht ist und keine einen Website-Text hat.
Die verbleibenden Lücken sind **fehlende Fachdaten, nicht fehlender Code**:
| Fehlt | Gepflegt unter |
|---|---|
| Kurzbeschreibung und Anzeigetitel der Medien | Medium bearbeiten → Anzeigetitel, Kurzbeschreibung |
| Veröffentlichung, Adresse und Text der Themen | Fachliche Säulen → Öffentliche Adresse, Text für die Website, „Auf der Website veröffentlichen“ |
| Kurzbeschreibung der Programme und Module | Programm/Modul → Kurzbeschreibung |
| öffentliches Bild | Kartenbild im Reiter „Medien“ (freigegebenes Motiv), später Freigabe von Vorschaubildern (§13 der Registry) |
### Neu öffentlich und bewusst entschieden
- **Kurzbeschreibung von Medien** (Betreibervorgabe) und **Dauer von Programmen** („Dauer N Min.“): beide stehen bisher auf keiner öffentlichen Seite. Die Programmseite zeigt das Lernziel, nicht die Dauer.
- **Vertraulichkeit hängt an der Inhaltsart.** Nie öffentlich sind Elemente mit der Inhaltsart „Traineranleitung“. „Trainerunterlage Abstand“ hat auf der Testinstanz keine Inhaltsart und gehört zu einem öffentlichen Programm. Die Karte ist deshalb öffentlich zulässig. Heute zeigt sie nur den Titel, der auf der Programmseite ohnehin steht. Eine später gepflegte Kurzbeschreibung würde öffentlich. **Vor dem Pflegen von Kurzbeschreibungen den Trainermaterialien die Inhaltsart „Traineranleitung“ zuordnen.**
### Offene Fragen an Lars
1. Soll die vorhandene „Beschreibung“ eines Mediums (zum Beispiel 215 Zeichen bei „Lara im Park“) öffentlich als Ersatz dienen, wenn keine Kurzbeschreibung gepflegt ist? Derzeit nein: Die Beschreibung ist Bibliothekstext.
2. Freigabe von Vorschaubildern für die Website und öffentliche Filmvorschauen: minimaler Erweiterungsbedarf in `cms-widget-registry.md` §13.
3. Öffentliche Sichtbarkeit auf der Testinstanz ist nicht live gezeigt, weil keine Hilfsseite veröffentlicht werden darf. Die Regeln belegen die Feature-Tests. Alternative: eine echte Seite mit Karten veröffentlichen.
4. Die Entwurfsseite `/karten-nachbesserung-entwurf` (Seite 19) bleibt zur Ansicht in der Redaktionsvorschau stehen; danach über die Seitenverwaltung löschen.
### Prüfskript für die Testinstanz
Das Prüfskript ist `e2e_karten2.py` (im Arbeitsordner der Sitzung, nicht im Repository). Es veröffentlicht nichts und legt die Entwurfsseite `/karten-nachbesserung-entwurf` an. Diese Seite nach der Prüfung über die Seitenverwaltung löschen.
@@ -0,0 +1,463 @@
# Umsetzungsplan: Mitgliederbibliothek
**Stand:** 15.11.2026, nach Review überarbeitet
**Status:** Vorschlag zur Freigabe. Kein Auftrag zur Umsetzung.
**Grundlage:** `docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md`, insbesondere die Architekturentscheidungen E-A, E-T, E-L, E-M und E-D
**Soll:** `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md`
Es wird nichts implementiert, nichts migriert und nichts deployt, solange dieser Plan nicht freigegeben ist.
Die Befunde A-01 bis E-02 bleiben gültig. Dieser Plan ändert ihre Beschreibung nicht. Neu sind die Entscheidungen der Review und die Paketfolge.
## Paketfolge
| Nr. | Paket | Wofür es dasteht |
|---|---|---|
| 0 | Lesende Bestandsaufnahme | Wissen, ob Dubletten und Bestellungen ohne Bezeichnungskopie existieren, bevor etwas bereinigt wird |
| 1 | Angebotsfassung, Registrierung, Bestellbezeichnung | Lizenz- und Bestellfehler, bevor die Bibliothek darauf aufbaut |
| 2 | Technische Struktur und redaktionelle Inhaltsart | Die Bibliothek kann eine gesetzte Art lesen, ohne vorhandene Zeilen umzudeuten |
| 3 | Bibliothek und interne Medienaktionen | Fachliche Struktur, Auflösung, normaler Player, getrennte Dokumentaktionen |
| 4 | Klasse-A-Stammdaten | Titel und Protokoll ohne neuen Inhaltsrelease |
| 5 | Fachdimensionen, Suche, Filter | Themen an Kompositionen und kombinierbare Filter |
| 6 | Einfache Thumbnails | Karte mit Bild oder Platzhalter, ohne Designsystem |
| 7 | Redaktionelle Vorschau und Angebotabdeckung | Dieselbe Struktur wie in der Bibliothek, Ausschlüsse vor der Aktivierung |
| 8 | Kommerziell freigabefähige Medienausgabe | Adaptives Streaming, Kennzeichnung, Ausgabenachweis |
| 9 | E2E-Abnahme auf der Testinstanz | Tor A ist Zwischenstand. Die kommerzielle Freigabe prüft alle MVP-Pflichtpakete |
Der didaktische Kursplayer bleibt kein Paket.
## Abhängigkeiten
```text
0 Bestandsaufnahme
│
▼
1 Lizenz und Bestellung ─────────────┐
│ │
▼ │
2 Strukturtypen │
│ │
▼ │
3 Bibliothek, intern testbar ◄───────┘
│
├──► 4 Stammdaten ──► 5 Suche und Filter
│
├──► 6 Einfache Thumbnails
│
└──► 7 Vorschau und Abdeckung
3 ist intern abnahmefähig.
8 hängt an 3 und ist notwendig, aber allein nicht hinreichend für die kommerzielle Freigabe.
9 Tor A prüft 1, 2 und 3 technisch auf der Testinstanz und gibt nichts frei.
9 Tor B prüft die vollständig umgesetzten Pakete 1 bis 8.
```
Paket 4, 5, 6 und 7 warten auf Paket 3, nicht aufeinander, außer Paket 5 auf Paket 4 wegen der durchsuchbaren Kurztexte. Paket 8 wartet nicht auf Thumbnails oder das Designsystem. Paket 0 blockiert nur die Bereinigung vorhandener Zeilen, nicht den Codepfad von Paket 1.
## Leitgrenzen
Diese Bestände bleiben in Funktion und Bedeutung erhalten:
- Identitäten, Fassungen, `composition_members` und die Unveränderlichkeit bereitgestellter Lehrfassungen
- Artikel-Stände, `release_contents`, Grants und `DecideAccess` ohne Vereinigung von Schnappschüssen
- Bestellpreis und `order_scope_items`
- CMS-Entwurf und CMS-Veröffentlichung
- Der Web-Prozess schreibt nicht nach `originals/` und liest `derived/` und `public/` nur
- Signierte URLs ersetzen die Berechtigungsentscheidung nicht
Neue Anzeigedaten werden nicht in veröffentlichte Fassungen zurückgeschrieben. Die Bibliothek legt keine Grants und keine Erwerbe an.
Designsystem, öffentliche Website und CMS werden nicht neu gebaut. Die Bibliothek nutzt das vorhandene Layout, funktionale Überschriften und Listen sowie das Browser-Video.
Automatisierte Tests eines Pakets laufen in der vorhandenen Suite mit Wegwerfdaten. Sie sind keine Abnahme auf der Testinstanz. Die Testinstanz wird nicht mit `RefreshDatabase`, `migrate:fresh` oder `DatabaseTruncation` gegen `luf-test` geprüft. Produktion wird nicht beschrieben.
## Auflösung, die Paket 3 umsetzt
Verbindlich ist E-A. Für die Umsetzung in Kurzform:
- Der Baum kommt nur aus einer zur Anzeige freigegebenen Kompositionsfassung. Status `bereit` genügt nicht. Paket, Angebot und Grant sind keine Knoten.
- Ein berechtigter Film in einer nicht freigegebenen Programmfassung erscheint als Material und zeigt diese Programmstruktur nicht.
- Jede Mitgliedszeile behält ihre Kindesfassung und ihre Rolle. Eine neuere Fassung derselben Identität ersetzt sie nicht.
- Ein Blatt ist nur auslieferbar, wenn genau diese Inhaltsfassung in einem veröffentlichten oder abgelöst verfügbaren Artikel-Stand steht und genau ein Grant die angeforderte Aktion trägt.
- Teilweise lizenzierte Programme bleiben als Baum sichtbar. Nicht getragene Blätter haben keine Datei-URL.
- Vollständig nutzbar ist ein abgeleiteter Status und kein Programmkauf.
- Dieselbe Identität steht in jedem betroffenen Programm. Die Materialliste dedupliziert nur nach der Identität und verschweigt abweichende Fassungen nicht.
- Ein einzelnes berechtigtes PDF ist ein Material, kein Programm.
## Paket 0 — Lesende Bestandsaufnahme
**Ziel.** Vor jeder Bereinigung liegt ein Befund über die tatsächlichen Test- und, nur lesend und nur nach Freigabe, Produktionsdaten.
**Ergebnisse.** Eine Aufstellung, kein Schreibvorgang:
- Angebote mit mehr als einer Fassung im Status aktiv, mit Nummern und Vergabeart
- Registrierungsangebote und welche Fassung `grantRegistrationOffers` heute träfe
- Bestellzeilen, deren sichtbarer Name aus `offers.name` kommt
- Ob Angebote seit der Bestellung umbenannt wurden, soweit die Daten das hergeben
- Anzahl der Grants je betroffener Angebotsfassung, ohne ihre Schnappschüsse zu ändern
**Betroffene Komponenten.** Keine Anwendung. Lesende Abfrage. Kein Deploy.
**Abhängigkeiten.** Keine.
**Zu erhalten.** Alle Zeilen. Der Befund autorisiert noch keine Bereinigung.
**Automatisierte Tests.** Keine. Der Befund ist eine Prüfung vorhandener Daten, kein Fixture.
**Abnahme.** Der Befund nennt je Punkt eine Zahl oder „nicht geprüft, weil kein lesender Zugang“. Eine Bereinigung ohne diesen Befund ist nicht freigegeben.
## Paket 1 — Angebotsfassung, Registrierung, Bestellbezeichnung
**Ziel.** Neue Aktivierungen hinterlassen genau eine aktive Fassung je Angebot. Die Registrierung vergibt nur diese Fassung. Neue Bestellungen speichern ihre Bezeichnung. Vorhandene Schnappschüsse bleiben.
**Ergebnisse.**
- `OfferService::activate` legt die neue Fassung an und beendet die bisher aktive Fassung desselben Angebots in derselben Transaktion.
- Der Haken an `OfferVersion` lässt dafür nur den Übergang `aktiv` nach `beendet` zu. Jede andere Änderung einer aktiven oder beendeten Fassung bleibt abgewiesen. Das ist die Entscheidung E-L.
- `GrantIssuer::grantRegistrationOffers` und der Kauf lesen je Angebot nur die höchste aktive Nummer. Das gilt auch, solange alte Dubletten noch nicht bereinigt sind.
- Neue `order_lines` speichern die Angebotsbezeichnung zum Bestellzeitpunkt. Die Bestellansicht liest diese Kopie.
- Alte Bestellzeilen werden nicht aus dem heutigen Namen gefüllt.
- Eine Bereinigung schon aktiver Dubletten ist ein eigener Schritt nach Paket 0 und einer ausdrücklichen Freigabe des Befunds. Sie setzt nur überzählige Fassungen auf `beendet` und schreibt Preis, Umfang und Grants nicht um.
**Betroffene Komponenten.** `OfferVersion`, `OfferService`, `GrantIssuer`, `Checkout`, `resources/views/member/order.blade.php`.
**Abhängigkeiten.** Paket 0 vor der Bereinigung. Der Codepfad darf vorher entstehen.
**Zu erhalten.** Historische Preise, Rechtsschnappschüsse, `locked_at`, bereits erteilte Grants.
**Automatisierte Tests.**
- Eine zweite Aktivierung lässt genau eine aktive Fassung übrig. Preis und Positionen der ersten Fassung sind unverändert.
- Ein Versuch, an einer aktiven Fassung den Preis zu ändern, scheitert.
- Zwei künstlich aktive Fassungen: die Registrierung legt nur Grants der höheren Nummer an und legt keinen zweiten Erwerb für die niedrigere an.
- Nach dem Kauf ändert ein neuer Angebotsname die gespeicherte Bestellbezeichnung nicht.
- Ein vorhandener Grant behält `rights_snapshot` und `release_at_grant_id`.
- Zwei überlappende Aktivierungen desselben Angebots hinterlassen genau eine aktive Fassung. Beide Fassungen bleiben vollständig gespeichert. Preis und Positionen keiner der beiden werden vermischt oder überschrieben. Die unterlegene Fassung endet auf `beendet`, oder die zweite Transaktion scheitert sauber, ohne eine zweite aktive Fassung zu hinterlassen. Der Test sperrt die Angebotszeile und läuft nicht nur nacheinander.
## Paket 2 — Technische Struktur und redaktionelle Inhaltsart
**Ziel.** Die erste Bibliothek kann eine ausdrücklich gesetzte Inhaltsart zeigen. Vorhandene Zeilen behalten ihren technischen Wert und werden nicht umgedeutet. Entscheidung E-T.
**Ergebnisse.**
- `CompositionKind` bleibt `kurs`, `uebung` und `kombination`. Kein neuer Enum-Wert und keine Umschreibung vorhandener Zeilen.
- Eine konfigurierbare Inhaltsart mit stabiler Kennung, zunächst nur diese eine Achse. Programm, Modul, Merkblatt und Traineranleitung werden als Werte angelegt und nicht vergeben.
- Die Zuordnung ist je Identität ausdrücklich. Sie ändert `kind` und `output_class` nicht und erzeugt keine Fassung.
- Ohne Zuordnung zeigt die Bibliothek die bisherige technische Bezeichnung. Mit Zuordnung zeigt sie die Inhaltsart.
- Paket 5 übernimmt diese Achse und legt keine zweite Liste an.
**Betroffene Komponenten.** Neue Zuordnung neben `CompositionKind`, Filament-Feld an Medium und Komposition, Anzeige in der Bibliothek. Der Enum und die drei bestehenden Masken bleiben.
**Abhängigkeiten.** Keine fachliche Abhängigkeit von Paket 1. Die Bibliothek in Paket 3 hängt von diesem Paket ab.
**Zu erhalten.** Verschachtelung, Zyklenprüfung, gespeicherte Arten, Bezeichnungen und Mitgliedsrollen.
**Automatisierte Tests.**
- Eine vorhandene Komposition `kurs` wird weiterhin als Kurs angezeigt, solange keine Inhaltsart gesetzt ist. `kind` bleibt `kurs`.
- Das Setzen der Inhaltsart Programm ändert die Anzeige und nicht die gespeicherte Art, keine Fassung und keine Mitgliedschaft.
- Ein neuer Wert Modul entsteht ohne Codeänderung und lässt sich einer bestehenden Übung zuweisen.
- Eine Übung ohne Inhaltsart wird nicht als Programm angezeigt.
- Ein PDF ohne Inhaltsart bleibt ein PDF. Nach gesetzter Art Merkblatt bleibt `output_class` unverändert.
- Kein Test und kein Seeder schreibt vorhandenen Zeilen automatisch eine Inhaltsart zu.
## Paket 3 — Bibliothek und interne Medienaktionen
**Ziel.** Die persönliche Bibliothek folgt E-A. Sie ist intern testbar: Struktur, Teilrechte und ein normaler Player mit getrennten Dokumentaktionen. Sie ist noch nicht die kommerzielle Medienfreigabe.
**Ergebnisse.**
- Programm-, Modul- und Materialansicht auf dem vorhandenen Layout. Die Überschrift „Kurse“ für jede Berechtigung entfällt.
- Baum nur aus zur Anzeige freigegebenen Fassungen, mit Rolle, Reihenfolge und fixierter Kindesfassung. Eine bloß bereite Fassung bleibt unsichtbar. `ContentResolver::expand` bleibt der Abgleich für den Artikel-Stand und wird nicht die Ansicht.
- Ein berechtigter Film, der nur in einer nicht freigegebenen Programmfassung liegt, erscheint als Material ohne Programm, Pfad oder Verwendungshinweis.
- Status vollständig, teilweise, nicht nutzbar und gesperrt, ohne neuen Erwerb.
- Mehrfachanzeige in jedem Programm, Deduplizierung nach Identität nur in der Materialliste, Fassungen bleiben sichtbar.
- Film über den Browser-Player mit Play, Pause, Zeitsuche, Vollbild und Lautstärke, soweit das Element `controls` das hergibt. Keine Entscheidungsmarke, kein Präsentationsmodus.
- Ansehen und Laden sind getrennte Aktionen und laufen beide durch die vorhandene, erneute Prüfung.
- Dateien kommen weiter als signierte Antwort aus `derived/`. Kein HLS, keine Kennzeichnung und kein Ausgabenachweis in diesem Paket.
- `decision_seconds` bleibt gespeichert und steuert diese Ansicht nicht.
**Betroffene Komponenten.** `LibraryController`, `CourseOutline`, Mitgliedsviews, `routes/web.php`, `resources/js/app.js` nur für das Entfernen des Entscheidungsknopfs, neuer Leser neben `ContentResolver`. `DecideAccess` bleibt.
**Abhängigkeiten.** Paket 2. Paket 1, damit neue Registrierungen und Käufe nicht auf doppelten aktiven Fassungen entstehen, während die Bibliothek geprüft wird.
**Zu erhalten.** Grants, Artikel-Stände, Signatur, Leserbindung, keine Vereinigung von Rechten.
**Automatisierte Tests.**
- B07 Rolle und Reihenfolge einer Verschachtelung bleiben im Baum.
- B09 und B10 Modul und PDF erscheinen in Programm A und Programm B an ihrer Position.
- B11 Die Materialliste zeigt die Identität einmal und nennt beide Programme.
- B12 Gleicher Titel, andere Identität: zwei Karten.
- B13 Zwei Programmfassungen zeigen je die gespeicherte Filmfassung.
- B14 Ein nur teilweise getragenes Programm ist gekennzeichnet. Die nicht getragene Datei liefert 403.
- B15 Alle Blätter über getrennte Artikel nutzbar, Zahl der Erwerbe bleibt gleich.
- B01 und das Demo-Merkblatt: Film und PDF sind nicht als Programm beschriftet, solange niemand diese Inhaltsart gesetzt hat.
- Ein Grant nur auf einen Film zeigt den Film. Eine bereite Programmfassung, die diesen Film enthält und nicht zur Anzeige freigegeben ist, erscheint weder als Baum noch als Pfad noch unter „verwendet in“.
- Eine freigegebene Programmfassung zeigt das enthaltene Modul auch ohne dessen eigene Freigabe. Ein Verweis auf eine eigene Modulansicht entsteht nur, wenn dort dieselbe Kindesfassung freigegeben ist.
- B16 Stream gelingt an einer Fixture-Datei. Laden derselben Datei ohne Recht liefert 403.
- B21 Ansehen und Laden eines PDF werden getrennt entschieden.
- B17 Zwei Grants mit verschiedenen Zwecken ergeben keine Aktion, die keiner allein erlaubt.
- Der Test erwartet nicht mehr „Zur Entscheidungsmarke“.
- Das Rendern der Bibliothek legt keine Grants an.
## Paket 4 — Klasse-A-Stammdaten
**Ziel.** Anzeigetitel und Kurzbeschreibung ändern die Bibliothek ohne neue Lehrfassung. Die Änderung ist protokolliert. Lehrtext und Datei bleiben versioniert.
**Ergebnisse.**
- Anzeigefelder an Asset und Komposition. Vorhandene `description`-Texte werden vor dem ersten Schreiben redaktionell eingeordnet, nicht automatisch umetikettiert.
- Speichern ruft keine neue Inhalts- oder Kompositionsfassung auf.
- Protokoll mit Bearbeiter, Zeit und Änderung.
- Die Bibliothek liest diese Felder, sobald sie gefüllt sind, und sonst den bisherigen Arbeitstitel oder die Bezeichnung.
**Betroffene Komponenten.** `ContentElement`, `Composition`, `ContentService::describe`, Bearbeitungsmasken, Protokolltabelle. Keine Spalte an den Fassungstabellen.
**Abhängigkeiten.** Paket 3 als Leser. Die Bestellbezeichnung ist bereits Paket 1 und wird hier nicht erneut gebaut.
**Zu erhalten.** `body`, `metadata`, `classification_note`, CMS-Revisionen, Bestellpreis und Bezeichnungskopie.
**Automatisierte Tests.**
- B02 Titel und Kurzbeschreibung erscheinen in der Bibliothek und erzeugen keine neue Fassung und keinen neuen Artikel-Stand. Das Protokoll enthält Bearbeiter und Zeit.
- B18 und B19 Reihenfolge und Datei erzeugen weiterhin neue Fassungen. Die alte Fassung bleibt.
- B24 Die redaktionelle Umbenennung ändert die Bibliothek und nicht die gespeicherte Bestellbezeichnung.
- Eine Änderung von `body` an einer bereiten Fassung scheitert.
## Paket 5 — Fachdimensionen, Suche und Filter
**Ziel.** Dimensionen sind pflegbar und an Medien, Module und Programme direkt setzbar. Die Bibliothek sucht und filtert. Die Inhaltsart aus Paket 2 bleibt dieselbe Achse. Sie wird nicht ein zweites Mal angelegt und deutet den technischen Enum nicht um.
**Ergebnisse.**
- Dimension und Werte mit stabiler Kennung, ohne die fünf Säulen im Code festzuschreiben.
- Die Inhaltsart aus Paket 2 bleibt diese Achse. Säulen kommen als weitere Dimension dazu.
- Übernahme der vorhandenen `pillars` und `content_element_pillar`. Alte Spalten werden in diesem Paket nicht gelöscht.
- Direkte Zuordnung an Kompositionen. Abgeleitete Themen bleiben als abgeleitet markiert.
- Suche über Titel und Kurzbeschreibung. Filter mit ODER innerhalb einer Dimension und UND zwischen Dimensionen.
- Filament-Formulare, keine neuen CMS-Blöcke und keine neuen öffentlichen Themenseiten.
**Betroffene Komponenten.** Neue Fachdimension, `PillarService` nur als Quelle der Übernahme, Kompositionsmasken, `LibraryController`. `DecideAccess` liest keine Dimension.
**Abhängigkeiten.** Paket 3 und Paket 4.
**Zu erhalten.** Öffentliche Themen, Medien-Säulen, die Regel, dass eine Säule keine Berechtigung erzeugt, `CompositionKind` als Strukturtyp.
**Automatisierte Tests.**
- B05 Ein neuer Wert ist Medien, Modul und Programm zuweisbar und filtert die Bibliothek.
- B06 Ein Thema nur am Modul findet das Modul ohne Tag am Film.
- Direktes und abgeleitetes Thema sind im Ergebnis unterscheidbar.
- Leere Suche und Zurücksetzen. Ein Filter liefert keine Datei, deren Aktion `DecideAccess` verneint.
- Weichen gesetzte Inhaltsart und `CompositionKind` voneinander ab, zeigt die Karte die Inhaltsart. Der Enum bleibt unverändert.
## Paket 6 — Einfache Thumbnails
**Ziel.** Karten zeigen ein eigenes geschütztes Bild oder einen neutralen Platzhalter. Ein Videoframe kann als Bild übernommen werden. Der Film bleibt unverändert. Das ist keine Gestaltungsvorlage für die öffentliche Website.
**Ergebnisse.**
- Klasse-A-Bild und Alternativtext an Asset, Modul und Programm.
- Upload eines Bildes. Für Video: Zeitposition, erzeugtes Bild, Vorschau, die zur Position passt.
- Fehler zeigen den Platzhalter und einen kurzen Fehlertext.
- Das Bild ist nicht über die öffentliche Medienroute abrufbar.
- Keine Bildsprache, keine Marketingfreigabe und kein CMS-Baustein.
**Betroffene Komponenten.** Identitätstabellen, ein Ableitungsjob neben `StoreContentFile`, Filament-Felder, die Karte aus Paket 3. Ablage unter der geschützten Ableitung, nicht als Ersatz der Filmdatei.
**Abhängigkeiten.** Paket 3 und Paket 4. Die Frame-Extraktion liest die vorhandene Datei und schreibt `content_hash` nicht neu.
**Zu erhalten.** Filmdaten, bereitgestellte Fassungen, öffentliche Medien der CMS-Seiten.
**Automatisierte Tests.**
- B02 Ein neues Vorschaubild erzeugt keine Inhaltsfassung.
- B03 Die Filmdatei und ihr Hash bleiben nach der Frame-Übernahme gleich. Das Bild liegt vor.
- B04 Die öffentliche Medienroute liefert das Bild nicht.
- Ein fehlgeschlagenes Bild lässt die Karte mit Platzhalter ausliefern.
- Eine gesetzte Bildwahl der Komposition bleibt vor einem Vorschlag aus enthaltenen Medien.
## Paket 7 — Redaktionelle Vorschau und Angebotabdeckung
**Ziel.** Die Redaktion sieht die Verwendung einer Komposition und dieselbe Struktur wie das Mitglied. Eine Angebotsfassung nennt Ausschlüsse, bevor sie aktiv wird.
**Ergebnisse.**
- `compositionUsage` in der Maske von Modul, Übung und Programm.
- Vorschau des Baums aus Paket 3, getrennt von der Liste des kaufbaren Artikelumfangs.
- Vor `activate` ein Befund, welche Blätter der beworbenen Kompositionsfassung in keinem gewählten Artikel-Stand liegen. Stille Aufnahme eines Ausschlusses unterbleibt.
- Die Aktivierung selbst bleibt die Transaktion aus Paket 1.
**Betroffene Komponenten.** `EditComposition`, `CatalogReading`, `OfferService`, `ViewOffer`.
**Abhängigkeiten.** Paket 1 und Paket 3.
**Zu erhalten.** Historische Angebotsfassungen, Grants, Zyklenprüfung der Pakete.
**Automatisierte Tests.**
- B23 Vorschau und Mitgliedsansicht zeigen für dieselbe Fassung dieselben Knoten, Rollen und Fassungsnummern.
- B20 bleibt aus Paket 1 grün.
- Ein Angebot, das ein Programm nicht deckt, wird nicht aktiviert und nennt die fehlenden Blätter.
- Eine Übung, die in einem Programm steckt, zeigt diese Verwendung in der Maske.
## Paket 8 — Kommerziell freigabefähige Medienausgabe
**Ziel.** Die in §11 der Produktkonfiguration und im Medienkonzept verlangte Ausgabe ist umgesetzt und nicht still entfallen. Entscheidung E-M. Dieses Paket ist eine notwendige Bedingung der kommerziellen Freigabe. Hinreichend wird sie erst, wenn Tor B alle MVP-Pflichtpakete abgenommen hat. Die interne Testbibliothek aus Paket 3 bleibt bis dahin der technische Stand.
**Ergebnisse.**
- Adaptive, geschützte Videoausgabe nach dem bestehenden Medienkonzept. Die Berechtigung bleibt `DecideAccess` je Aktion. Eine Signatur gilt für das entschiedene Ausgabeformat, nicht für eine beliebige Datei.
- Dokumente tragen die vorgesehene Lizenzkennzeichnung auch bei der Anzeige im Browser.
- Jede tatsächliche Ausgabe erzeugt einen Ausgabenachweis zur tragenden Berechtigung, ohne eine zweite Berechtigung zu schaffen.
- Vorhandene Pfade in `derived/` bleiben für bereits gespeicherte Fassungen lesbar. Neue Ableitungen ersetzen diese Pfade nicht rückwirkend.
- Originaldateien werden nicht öffentlich ausgeliefert. Ob die fehlende Ablage nach `originals/` in diesem Paket nachgezogen wird, ist Teil der technischen Umsetzung, nicht eine Streichung der Kennzeichnung.
**Betroffene Komponenten.** Auslieferung neben `LibraryController::media`, Queue, Nachweisdaten. Nicht der didaktische Player und nicht das Designsystem.
**Abhängigkeiten.** Paket 3. Paket 1, weil kommerzielle Käufe eine eindeutige Angebotsfassung brauchen.
**Zu erhalten.** Artikel-Stände, Grants, die Trennung der Aktionen, die Unveränderlichkeit der Filmfassung beim Erzeugen einer Ableitung.
**Automatisierte Tests.**
- B16 gilt weiter für die adaptive Ausgabe: ohne Streamrecht keine Variante, ohne Laderecht kein Download der Quelldatei.
- Eine Dokumentausgabe enthält die Kennzeichnung und einen Nachweis. Dieselbe Datei ohne passenden Grant erzeugt keinen erfolgreichen Nachweis.
- Zwei Grants werden im Nachweis nicht zu einem dritten Recht zusammengezogen.
- Eine bereits gespeicherte, nicht adaptive Datei bleibt über den bisherigen berechtigten Abruf lesbar, bis ihre Fassung eine neue Ableitung erhält.
## Paket 9 — E2E-Abnahme auf der Testinstanz
**Ziel.** Die Suite mit Fixtures wird durch einen Lauf gegen die laufende Testinstanz ergänzt. Es werden echte Dateien und echte Berechtigungsfälle verwendet. Tor A ist ein technischer Zwischenstand. Eine kommerzielle Freigabe setzt die vollständige Umsetzung und die bestandene Abnahme aller MVP-Pflichtpakete voraus.
MVP-Pflichtpakete sind 1, 2, 3, 4, 5, 6, 7 und 8. Paket 0 ist die Bestandsaufnahme vor einer Bereinigung und kein Produktpaket. Ein Paket, das zur Abnahme zufällig noch nicht fertig ist, gilt nicht als erfüllt.
**Ergebnisse.** Zwei Tore, beide nur gegen Test, nie gegen Produktion und nie mit Leeren der Testdatenbank.
**Tor A, technischer Zwischenstand nach Paket 1, 2 und 3.** Auf der Testinstanz:
- ein Film und ein PDF, die als Dateien unter dem Testmedienbestand liegen und nicht nur als `Storage::fake`
- zwei zur Anzeige freigegebene Programme, gemeinsamer Film, gemeinsames PDF, unterschiedliche Rollen
- eine nur bereite Programmfassung mit demselben Film bleibt für das Mitglied unsichtbar
- eine Person mit nur einem Modul, eine Person mit allen Teilen über getrennte Artikel, eine Person ohne Grant
- Stream gelingt nur für die berechtigte Person. Laden des Films scheitert, wenn es nicht im Schnappschuss steht
- Ansehen und Laden des PDF sind getrennt
- das teilweise Programm ist gekennzeichnet, das vollständige Programm hat keinen zusätzlichen Erwerb erzeugt
- die Materialliste zeigt das gemeinsame PDF einmal
- vorhandene Kompositionen ohne gesetzte Inhaltsart tragen weiterhin ihre technische Bezeichnung
Tor A gibt die Bibliothek nicht für zahlende Trainer frei und ersetzt kein späteres Paket.
**Tor B, kommerzielle Abnahme.** Erst wenn die Pakete 1 bis 8 umgesetzt sind und ihre automatisierten Tests bestehen. Der Lauf wiederholt Tor A und prüft zusätzlich, vollständig und nicht nur soweit schon deployt:
- adaptive Ausgabe, Kennzeichnung und Ausgabenachweis aus Paket 8
- Umbenennung ohne neue Fassung und unveränderte Bestellbezeichnung aus Paket 4
- Filter und direkte Themen an Modul und Programm aus Paket 5
- Thumbnail ohne öffentliche Route aus Paket 6
- Abdeckungsverweigerung und dieselbe Struktur in der Vorschau aus Paket 7
- genau eine aktive Angebotsfassung, auch nach dem Parallelitätstest aus Paket 1
Fehlt eines dieser Ergebnisse, ist Tor B nicht bestanden.
**Betroffene Komponenten.** Testinstanz `luf-test`, Testdaten, die sich wiederfinden lassen und Produktionsmedien nicht berühren. Der Demo-Seeder legt keine Inhaltsarten auf vorhandene Zeilen. Ein zweiter Lauf legt dieselben Kennungen nicht erneut an.
**Abhängigkeiten.** Tor A: Pakete 1, 2 und 3. Paket 0 muss den Befund geliefert haben, wenn eine Dublette bereinigt werden soll. Tor B: Pakete 1 bis 8 vollständig.
**Zu erhalten.** Produktionsdaten, der Medienbestand von `luf-prod`, fremde Anwendungen auf dem Host.
**Automatisierte Tests.** Der Lauf ist ein HTTP-Lauf gegen die Testinstanz oder ein eigener Wegwerf-Container mit eigener Datenbank und einer echten Datei. Er ist kein `php artisan test` im Container von `luf-test`. Ein Test, der nur die Überschrift „Kurse“ erwartet, ist keine Abnahme. Tor A ist kein Ersatz für Tor B.
## Zurückgestellt
Automatische Denkpause, Ablaufsteuerung, Präsentationsmodus, Fortschritt und zweites Gerät. `decision_seconds` bleibt in den Fassungen und wird nicht zum Thumbnail.
Die Bibliothekspakete bauen kein Designsystem, keine öffentlichen Objektseiten und kein CMS. Diese Arbeit liegt in der Spur W und beginnt nicht mit diesem Plan. Einzige Ausnahme im ersten Schritt ist der wegwerfbare Editor-Prototyp W-P. Einfache Thumbnails und die funktionale Bibliothek bleiben in den Paketen 3 und 6.
Organisationslizenzen, Community, echter Zahlungsdienst, kundeneigene Paketkonfiguratoren, konkrete Preise und Tarife.
## Verbleibende Entscheidungen zur Freigabe
Entschieden mit dieser Präzisierung: Eine nur bereite Programmfassung wird nicht durch einen Filmzugriff sichtbar. Fachliche Typen sind konfigurierbare Inhaltsarten. Bestehende Enum-Werte werden nicht umgedeutet. Tor A ist kein Freigabetor. Kommerziell freigegeben wird nur nach bestandener Abnahme der Pakete 1 bis 8.
Offen bleibt nach der Übernahme des Website-Zielkonzepts:
1. **Bereinigung.** Nach dem Befund aus Paket 0: Welche konkret genannten Dubletten dürfen auf `beendet` gesetzt werden? Ohne diese Freigabe bleibt der Codepfad aus Paket 1, und die alten Zeilen bleiben stehen.
2. **Ort der Teilprogramme.** E-A legt fest, wann ein zur Anzeige freigegebenes und nur teilweise nutzbares Programm in der persönlichen Bibliothek erscheint. Die Position in der Navigation bleibt eine spätere UX-Entscheidung und blockiert Paket 3 nicht.
3. **Bereinigung nach Paket 0** bleibt die einzige Freigabe, die den Code von Paket 1 nicht blockiert. Öffentliche Listung, W2 und der Verkaufsstart sind nicht Teil der ersten Schritte.
## Gemeinsame Verträge mit Website und CMS
Übernommen aus `docs/architektur/website-cms-marketing-zielarchitektur.md`, Kapitel 14.1, und dem strategischen Zielkonzept. Die Pakete 0 bis 9 behalten Inhalt und Reihenfolge. Es entsteht kein zweites Datenmodell, kein zweiter Strukturleser und kein zweiter Freigabemechanismus.
| Vertrag | Was einmal gebaut wird | Implementierungsort | Hängt ab von | Genutzt von |
|---|---|---|---|---|
| **G1** Strukturleser | Löst eine **ausdrücklich angegebene** Kompositionsfassung auf — **unabhängig** von ihrer Anzeigefreigabe. Baum: Identität, fixierte Kindesfassung, Rolle, Reihenfolge, Inhaltsart, Klasse-A-Daten, ab E-W12 auch Lernziel, Zeit und Material der Fassung. Kennt keine Person und keine Berechtigung. | Paket 3, eine Klasse neben `ContentResolver`. `expand` bleibt der Abgleich des Artikel-Stands. | G2, G3. Klasse-A-Felder dürfen leer sein, bis G4 steht. Didaktische Felder bleiben leer, bis E-W12 steht. | Paket 3 legt die Berechtigung je Blatt darüber (G2). Paket 7 zeigt denselben Baum. Redaktionelle Vorschau darf auch noch nicht freigegebene Fassungen lesen. Die öffentliche Lesesicht projiziert denselben Baum ohne geschützte Felder. |
| **G2** Anzeigefreigabe | Prüft Freigabe für Mitglieder und Öffentlichkeit. Zustand je Kompositionsfassung mit Bearbeiter und Zeitpunkt; Freigabe und Rücknahme **versionsgebunden** und nachvollziehbar, ohne unveränderliche Fassungsinhalte oder Mitgliedschaften nachträglich zu verändern. Unabhängig von `bereit` und vom Artikel-Stand. Abfragen: ist diese Fassung freigegeben, und welches ist die höchste freigegebene Fassung der Identität. | Paket 3, an `composition_versions`, nicht an Seiten und nicht am Artikel-Stand. | Paket 3 | Paket 3, Paket 7, öffentliches Profil. Die Listung verweist nur auf eine hier freigegebene Fassung. |
| **G3** Inhaltsart | Konfigurierbare Werte mit stabiler Kennung. Startwerte `programm`, `modul`, `merkblatt`, `traineranleitung`, zunächst unvergeben. Setzen ändert weder `kind` noch `output_class`. | Paket 2 | keine | Paket 3, Paket 5 übernimmt dieselbe Achse, W3 bestimmt daraus Seitentyp und Adresse. |
| **G4** Klasse-A-Anzeigefelder | Anzeigetitel und Kurzbeschreibung an der Identität, ein Protokoll, ein Titel für Bibliothek und Website. | Paket 4 | Paket 3 als Leser | Paket 3, Paket 5, W3, SEO-Vorbelegung |
| **G5** Dimensionswerte | Stabile Kennung je Wert. Säulen behalten ihre Identität. Direkte und abgeleitete Zuordnung bleiben unterscheidbar. `/themen` bleibt erreichbar. | Paket 5 | Paket 4 | Paket 5, Themenseiten, spätere Signaturen, öffentliches Profil der Säulen |
| **G6** Bildableitung | Ein Auftrag in der Queue erzeugt geschützte Ableitungen aus Bild oder Videoframe. Öffentlich oder geschützt ist eine Eigenschaft der Verwendung, kein zweiter Auftrag. | Paket 6 | Paket 4 | Paket 6, W2, W3 gibt eine Ableitung ausdrücklich öffentlich frei |
| **G7** Abdeckungsbefund | Lesedienst: welche Blätter dieser Kompositionsfassung liegen in keinem Artikel-Stand des genannten Angebotsumfangs. Aufrufbar außerhalb der Aktivierung. | Paket 7 | G1 | Paket 7, W3 für „nicht enthalten“ |
| **G8** Aktuelle Angebotsfassung | Eine Lesefunktion: die eine aktive Fassung des Angebots. Bei noch nicht bereinigten Dubletten die höchste aktive Nummer. | Paket 1, `OfferService` | Paket 1 | Registrierung, Kauf, W3 |
| **G9** Instanz-Suite | Browser-Lauf über HTTP gegen die Testinstanz oder einen Wegwerf-Container. Nie Produktion. Nie Leeren der Testdatenbank. | Paket 9, oder W1, falls die Spur W zuerst eine Sichtprüfung braucht. Eine Suite, nicht zwei. | die jeweils geprüften Pakete | Tor A, Tor B, W1 bis W4 |
Verträge G1 bis G8 werden festgehalten, bevor Paket 3 beginnt. Paket 0, Paket 1 und W-P warten darauf nicht.
## Sichtbarkeit und historische Fassungen
Gilt für Bibliothek und öffentliche Seite über G1 und G2.
- Eine zur Anzeige freigegebene Programmfassung zeigt jedes enthaltene Modul als Bestandteil dieser Fassung. Die eigene Anzeigefreigabe des Moduls ist dafür nicht nötig.
- Eine öffentliche Programmseite tut dasselbe. Zusätzlich verlinkt sie ein Modul nur, wenn die gelistete Modulseite dieselbe Kindesfassung zeigt. Sonst bleibt die Zeile ohne Link, mit Befund.
- Die öffentliche Listung gibt die Moduldatei nicht frei und macht eine nur bereite Programmfassung nicht sichtbar.
- Jede Ansicht zeigt genau eine Fassung. Bestände werden nicht gemischt. Lehrtexte und Struktur stammen aus dieser Fassung. Der Anzeigetitel stammt aus der Identität.
- Folgt eine öffentliche Seite einem Artikel-Stand, übernimmt sie dessen Wurzelfassung nur, wenn diese zur Anzeige freigegeben ist. Sonst bleibt die bisher gezeigte Fassung, und der neue Stand wird als Befund gemeldet.
- Hat kein Artikel die Programmfassung als Wurzel, bestätigt die Redaktion eine freigegebene Fassung. Vorschlag ist die höchste freigegebene, nicht die höchste bloß bereite.
- In der Bibliothek bleibt ein Stand mit eigener Anzeigefreigabe als ganzer Stand erreichbar. Eine neuere unfreigegebene Fassung ersetzt ihn nicht.
## Ergänzung E-W12 — didaktische Metadaten
**Ziel.** Lernziele, Zeitbedarf und Materialbedarf liegen an der Kompositionsfassung und sind vor der vollständigen öffentlichen Programm- und Moduldarstellung lesbar. Entscheidung E-W12 im Abgleich.
**Zuschnitt.** Ein Schreibweg über die vorhandene neue Kompositionsfassung. Keine Änderung an einer bereits bereiten Fassung, keine zweite Tabelle, kein eigener Leser. G1 gibt die drei Felder am Versionsknoten aus. Sind sie leer, zeigen Bibliothek und spätere öffentliche Seite Kurzbeschreibung und Struktur und nicht eine erfundenen Lernzielblock.
**Ort in der Folge.** Nach Paket 3, unabhängig von den Paketen 4, 5, 6 und 7, zwingend vor W3a. W3a beginnt nicht mit einer Programmseite, der diese Felder fehlen.
**Tests.** Eine Änderung der Lernziele erzeugt eine neue Fassung und lässt die bisherige unverändert. G1 liefert am alten und am neuen Stand jeweils den zugehörigen Text. Eine Fassung ohne diese Felder bleibt lesbar. Es wird kein vorhandener Datensatz gefüllt.
## Erste Schritte, noch nicht begonnen
Bibliothek und Website werden nicht umgesetzt. Freigegeben zum Vorbereiten sind nur die folgenden drei Arbeiten. Jede weitere Arbeit wartet auf ihre explizite Freigabe.
### Paket 0 — Befund, nur lesend
Auf der Testinstanz, ohne Schreibzugriff und ohne Deploy, zählen und auflisten:
- Angebote mit mehr als einer Fassung im Status aktiv: Angebotskennung, Fassungsnummern, Vergabeart
- welche dieser Fassungen die Registrierung heute träfe, wenn sie alle aktiven Fassungen läse
- Bestellzeilen ohne gespeicherte Bezeichnungskopie: Anzahl, nicht die Namen von Personen
- Grants je solcher Angebotsfassung: Anzahl, nicht Namen und nicht Schnappschüsse
Personenbezogene Werte kommen nicht in das Repository. Der Befund nennt Zahlen und fachliche Kennungen. Eine Bereinigung folgt erst nach Freigabe genau dieser Zeilen. Produktion wird nicht abgefragt, solange das nicht eigens freigegeben ist.
### Paket 1 — Codepfad, ohne Datenbereinigung
Auf einem Feature-Branch, nicht auf `main`:
- `OfferService::activate` sperrt das Angebot und beendet in derselben Transaktion die bisher aktive Fassung nur durch den Status `beendet`
- `OfferVersion` lässt ausschließlich diesen Übergang zu
- Registrierung und Kauf lesen G8, also eine aktive Fassung, bei Alt-Dubletten die höchste Nummer
- neue Bestellzeilen speichern die Bezeichnung
- Tests aus dem Paket, einschließlich des Parallelitätstests mit zwei überlappenden Aktivierungen
- keine Änderung bestehender Bestellungen und keine Statusänderung bereits vorhandener Dubletten
Der Branch wird nicht deployt, solange die Tests nicht grün sind und die Freigabe zum Test-Deploy fehlt.
### W-P — Editor-Prototyp, unabhängig
Wegwerfcode auf einem eigenen Feature-Branch. Keine Migration. Nur Seiteneditor, Bausteinregister und Bausteinansichten. Keine Mitgliedsansichten, keine Kataloglogik, kein Designsystem. Daten bleiben auf `pages` und `page_revisions`.
Umfang und Abnahme stehen in der Zielarchitektur, Abschnitt 4.5: Aufgaben T1 bis T9, Kriterien K1 bis K5. Programmkarten speichern nur Kennungen und lesen die vorhandene Bezeichnung. Der Prototyp wird nicht in W2 übernommen. W2 startet nicht, bevor das Ergebnis von W-P festgehalten ist.
W-P kann gleichzeitig mit Paket 0 und dem Codepfad von Paket 1 laufen, weil es dieselben Dateien nicht berührt.
@@ -0,0 +1,37 @@
# W-P — Editor-Prototyp (Wegwerf-Branch `feature/w-p-editor-prototype`)
Stand: 2026-03-15. Zielarchitektur §4.5. Keine Migration, nur `pages` / `page_revisions`.
## Umgesetzt
| Bereich | Inhalt |
|---|---|
| Bausteinregister | Heldenbereich (`hero`, Varianten `split` / `centered`), Bild-Text-Varianten, `program_cards`, `global_reference`; Bestandsbausteine unverändert nutzbar |
| Blockvorschau | Live-Vorschau je Repeater-Eintrag über dieselben `public.blocks.*`-Blades (K1) |
| Ganzseitige Vorschau | Breiten-Umschalter 390 / 768 / 1440 px an der Vorschauroute |
| Vorlage | „Aus Vorlage“ in der Listenansicht; „Als Vorlage duplizieren“ im Editor |
| Globaler Abschnitt | Baustein `global_reference` mit Pfad; Auflösung bei Darstellung über `BlockExpander` |
| Programmkarten | Nur `composition_id` in den Daten; Bezeichnung zur Laufzeit aus `compositions.designation` |
## Bedienprüfung (vorbereitet)
Lokal oder auf Test, Redaktion unter `/redaktion`, Rolle mit Seiten-Recht.
1. **T1 / Vorlage:** Seiten → „Aus Vorlage“ → Vorlage `/praevention` → neuer Pfad → drei Texte ändern → speichern → veröffentlichen → öffentliche URL prüfen; Vorlage unverändert.
2. **T2:** Baustein Bild-Text, Variante wechseln → Blockvorschau ohne Speichern.
3. **T3:** Abschnitte umsortieren / duplizieren → Ganzseitenvorschau.
4. **T4:** Programmkarten: zwei Kompositionen suchen, Reihenfolge tauschen → Bezeichnungen aus Fachdaten.
5. **T5:** Vorschau 390 px → langer Titel korrigieren.
6. **T6:** Globale Seite z. B. `/global/w-p-footer` pflegen, auf Landing per `global_reference` einbinden, veröffentlichen.
7. **T7:** Revisionen-Tab → frühere Revision wiederherstellen.
8. **T8 / T9:** Viele Bausteine / Pflichtfeld leer — wie in §4.5.
Zeiten und Stockungen sind beim Durchlauf durch den Betreiber zu notieren.
## Nicht enthalten (bewusst)
Seitentypen, Schemaversion, Medienbibliothek, öffentliches Profil, Kataloglogik, Designsystem. Code wird nicht nach W2 übernommen.
## Technische Tests
`tests/Feature/WpEditorPrototypeTest.php` (Registry, Renderer, Abwärtskompatibilität `image_text`).
+304 -40
View File
@@ -1,45 +1,75 @@
# 12 – Entscheidungsprotokoll (ADR)
Status der Einträge: **vorgeschlagen**, sofern nicht anders vermerkt. Die Entscheidung liegt beim Auftraggeber. ADRs sind Architekturvorschläge, keine Fachregeln.
**Abgleichstand:** 17.11.2026
**Dokumentenstatus:** Konsolidiertes bestehendes ADR-Protokoll; übergreifender Abgleich mit dem Fachkonzept v1.1, den konsolidierten Fach-/Designkonzepten, den Website-/CMS-Entwürfen vom 15.11.2026 und dem dokumentierten MVP-Teststand vom 16.11.2026. **Keine neue formale Freigabe** durch diesen redaktionellen Abgleich.
**ADR-02 ist am 15.11.2026 beschlossen:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert. Die Umsetzung hat begonnen. Die übrigen Einträge bleiben Vorschläge.
## Leseregel und Quellenrangfolge
**Stand nach der Challenger-Prüfung vom 14.11.2026** (`13`, Abschnitte 8 und 9): ADR-02, ADR-09 und ADR-10 sind **ersetzt**; ADR-01, ADR-11, ADR-12, ADR-14, ADR-18 und ADR-20 sind **ergänzt**; ADR-23 bis ADR-27 sind **neu**. Die übrigen wurden geprüft und unverändert beibehalten. Die frühere Fassung der ersetzten Einträge ist jeweils unter „Abgelöst“ in einem Satz festgehalten.
Dieses Protokoll trennt **fachlich verbindliche Regeln**, **tatsächlich belegten Iststand**, **Architekturvorschläge** und **bewusst offene Entscheidungen**. Die Formulierungen „Entscheidung“ in den historischen ADR-Abschnitten bezeichnen vielfach den ursprünglich vorgeschlagenen Lösungsweg, **nicht** automatisch eine bestätigte Betreiberentscheidung. Maßgeblich ist der jeweils vorangestellte Status.
| Nr. | Thema | Empfehlung in einem Satz |
|---|---|---|
| ADR-01 | Gesamtarchitektur | Integrierter modularer Kern mit Community als Satellit, mit getrennten Rechten im Innern |
| ADR-02 | Stapel des Kerns | **Beschlossen (15.11.2026):** Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert |
| ADR-03 | Vier Ebenen des Produktmodells | Inhalt, Lizenzartikel, Angebot, Berechtigung mit je eigener Identität |
| ADR-04 | Artikelgrenze | ausdrückliche Deklaration, keine Ableitung aus dem Inhaltsgraphen |
| ADR-05 | Berechtigung als unteilbares Bündel | Entscheidung je einzelner Berechtigung, nie Vereinigung |
| ADR-06 | Eingefrorener Bestellumfang | Kopie des aufgelösten Umfangs in der Bestellposition |
| ADR-07 | Versionierung der Lernprodukte | unveränderliche Fassungen, exakte Verweise, Kompatibilitätsbestätigung |
| ADR-08 | Veröffentlichung | Vorgang mit Vorabprüfung und atomarer Zeigerumschaltung |
| ADR-09 | Aktualisierungen | jede gültige Berechtigung deckt alle freigegebenen Fassungen ihres Artikels; keine wählbaren Anspruchsregeln |
| ADR-10 | Upgrade | zusätzlicher Erwerb mit neuer vollständiger Berechtigung; die vorhandene bleibt unverändert |
| ADR-11 | Inhaber | Person oder Organisation von Beginn an |
| ADR-12 | Community | ausgereiftes Fremdprodukt; Kern ist Identitätsgeber und führt Gruppen |
| ADR-13 | Trainerverzeichnis | im Kern, nicht in der Forensoftware |
| ADR-14 | Zahlung | Adapter; Freischaltung nur auf geprüftes Ereignis oder aktive Abfrage; aktiver Abgleich |
| ADR-15 | Streamingschutz | signierte Sitzungsadressen, kein DRM |
| ADR-16 | Medienauslieferung | austauschbarer Adapter; lokal beginnen, Auslieferungsnetz nach Schwellen |
| ADR-17 | Kennzeichnung | Stufenmodell; unsichtbares Videowasserzeichen erst nach Erprobung |
| ADR-18 | Ausgabenachweis | vor Erzeugung angelegt, für jede individuelle Ausgabe |
| ADR-19 | Hintergrundverarbeitung | datenbankgestützte Warteschlange und Postausgang |
| ADR-20 | Betrieb | Container auf einem Server; identische Anwendung in allen Stufen |
| ADR-21 | Rechnung | externer Dienst hinter Adapter |
| ADR-22 | Seiten und Katalogdarstellung | Seiten aus Bausteinen; Katalogbausteine zeigen auf Identitäten |
| ADR-23 | Berechtigungsquelle | Erwerb als individuelle Quelle je Inhaber; das allgemeine Angebot ist keine Quelle |
| ADR-24 | Medienausgabe | Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands; Freigabe je Datei |
| ADR-25 | Schadensbegrenzung | getrennte Rechte je Prozess, getrennte Herkunftsadressen, Verwaltung ohne Alleskönner |
| ADR-26 | Sicherung und Wiederanlauf | fortlaufend außer Haus und nur anfügbar; Sicherheitsjournal; Ziele je Schadensfall |
| ADR-27 | Ereignis und Abgleich | Ereignisse für Schnelligkeit, wiederholbarer Soll-Ist-Abgleich für Richtigkeit |
1. Bestätigte Fachregeln aus `01_LUF_Zielbild_und_Fachkonzept_v1.1.md`, `trainingskonzept-und-produktstruktur.md` und `produktkonfiguration-und-mitgliederbereich.md` haben Vorrang vor älteren technischen Vorschlägen.
2. `design-prinzipien.md` ist für Gestaltungsziele verbindlich. Konkrete Markenwerte, Schriften und Assets sind nur dann verbindlich, wenn freigegeben.
3. `website-cms-seo-marketing-zielkonzept.md` und `website-cms-marketing-zielarchitektur.md` vom 15.11.2026 sind **Entwürfe**, keine Implementierungsnachweise; die darin beschriebenen ADR-28 bis ADR-37 werden hier ausdrücklich nur als Vorschläge geführt.
4. `abschlussbericht-mvp-2026-11-16.md` ist ein zeitgebundener Beleg für implementierte Teile auf `develop`/`luf-test`, **keine** erfolgreiche Tor-B- oder G9-Abnahme. Spätere UX-Iterationen aus Chat/Screenshots sind nicht automatisch durch diese Datei belegt.
5. Neuere dokumentierte Tatsachen korrigieren veraltete Istbehauptungen aus älteren Architekturstudien, ohne frühere Fachentscheidungen zu überschreiben. Offene Entscheidungen bleiben offen, wenn keine ausdrückliche Bestätigung nachweisbar ist.
**Wichtige Abgrenzungen:** Die Wahl Laravel/Filament ist im realen Bestand vollzogen (ADR-02), aber die Website-CMS-Richtung „Eigenkern mit erweitertem Builder“ steht weiterhin unter einem UX-/Prototyp-Vorbehalt (ADR-28). Die Facharten **Medien, Module, Programme, Lizenzartikel und Angebote** sind nicht gleichzusetzen. Öffentliche Listung ist nicht dasselbe wie Mitglieder-Anzeigefreigabe oder kommerzielle Angebotsaktivierung (ADR-22/29). Die Referenzen im Website-Entwurf, dass Lernziel-, Zeit- und Materialfelder noch fehlen, sind gegenüber dem MVP-Abschlussbericht vom 16.11.2026 **veraltet** (dort E-W12 als implementiert dokumentiert).
## Übersicht der Architekturentscheidungen
Die Statusspalte ist ein **Prüfstand**, kein Automatismus zur formalen Annahme technischer Optionen. „Fachlich fest“ bezieht sich auf die zugehörige verbindliche Fachanforderung; der konkrete technische ADR-Weg kann dennoch in Teilen vorgeschlagen sein.
| ADR | Thema | Prüfstand (17.11.2026) | Kernaussage |
|---|---|---|---|
| ADR-01 | Gesamtarchitektur | Grundrichtung fachlich gedeckt; Community-Teil offen | Modularer Kern belegt; Community-Integration weiter geplant |
| ADR-02 | Technologiestapel | Ist-Entscheidung durch Umsetzung; Produktivabnahme offen | Laravel 13/Filament 5 realisiert; frühere offene Technologieauswahl historisch |
| ADR-03 | Produktmodell | Fachlich verbindlich; Grundstruktur implementiert | Inhalt, Komposition, Lizenzartikel, Angebot, Berechtigung strikt getrennt |
| ADR-04 | Artikelgrenze | Fachlich verbindlich; Abdeckungsprüfung implementiert | Lizenzartikelgrenze vom Betreiber; Abdeckung kontrolliert |
| ADR-05 | Rechteprüfung | Fachlich verbindlich; im Kern umgesetzt, G9 offen | Aktionen aus genau einer tragenden Berechtigung, keine Rechtevereinigung |
| ADR-06 | Kaufsnapshot | Fachlich verbindlich; technische Details nicht vollständig abgenommen | Historischen Kaufumfang und Konditionen fixieren |
| ADR-07 | Versionierung | Fachlich verbindlich; Fassungsmodell implementiert, UX in Arbeit | Freigabefassungen unveränderlich; redaktioneller Entwurfsworkflow weiter verbessern |
| ADR-08 | Veröffentlichung | Fachliche Sicherheitsanforderung; technische Atomarität nicht vollständig nachgewiesen | Neue Freigaben beschädigen keine bestehende Veröffentlichung |
| ADR-09 | Updates | Fachlich beschlossen; Produktregel verbindlich | Aktualisierungen desselben Artikels grundsätzlich enthalten; neue Artikel nicht |
| ADR-10 | Upgrade | Fachliche Schutzregel verbindlich; Upgrade-Technik nur vorgeschlagen | Kein Rechteverlust durch Upgrade; Erwerbsmechanismus noch nicht abgenommen |
| ADR-11 | Inhaber | Zielbild fachlich fest; institutioneller Betrieb später | Organisationen als Zielbild, Einzelpersonen im ersten Verkaufsschnitt |
| ADR-12 | Community | Architekturvorschlag; Community nicht umgesetzt | Community als späterer Satellit vorgeschlagen; Discourse Kandidat |
| ADR-13 | Trainerverzeichnis | Fachliches Zielbild, technische Zuordnung vorgeschlagen | Trainerverzeichnis mit geschützter Privatsphäre; Realisierung später |
| ADR-14 | Zahlung | Verbindliche Zahlungsprinzipien; Adapter nicht umgesetzt | Externer Zahlungsdienst, konkreter Adapter noch nicht gebaut |
| ADR-15 | Streaming | MVP-Teilbeleg: signiertes HLS; weitergehender Schutz offen | Signiertes HLS im Test belegt; kein DRM-Versprechen |
| ADR-16 | Auslieferung | Lokale Ausgabe belegt; austauschbares CDN/Adaptermodell nicht abgenommen | Lokale Medienausgabe vorhanden; CDN-Wechsel später |
| ADR-17 | Kennzeichnung | Teilimplementierung; forensisches Wasserzeichen offen | Kennzeichnung stufenweise; unsichtbares Wasserzeichen nicht belegt |
| ADR-18 | Ausgabenachweis | Nachweisfunktion implementiert; Manipulationsschutz nicht belegt | Ausgabenachweis im Test; Manipulationsschutz zusätzlich prüfen |
| ADR-19 | Hintergrundjobs | Queue belegt; Outbox-Garantie offen | Queue für Ableitungen vorhanden; transaktionales Outbox-Modell offen |
| ADR-20 | Betrieb | Container-Testbetrieb belegt; Produktivbetrieb offen | Container-Testbetrieb belegt; noch keine Produktivabnahme |
| ADR-21 | Rechnung | Architekturvorschlag; geschäftlich und technisch offen | Rechnungsadapter vorgeschlagen; Dienstwahl offen |
| ADR-22 | CMS/Katalog | Gemeinsames Fachprinzip verbindlich; konkrete CMS-Lösung unter Vorbehalt | CMS-Bausteine und Katalogverweise; komfortabler CMS-Ausbau noch zu erproben |
| ADR-23 | Berechtigungsquelle | Erwerbs-/Quellenprinzip fachlich gedeckt; Abo später | Erwerb als Nachweisquelle; Abo-Typ kein MVP-Fakt |
| ADR-24 | Ausgaberecht | Fachlich verbindlich; Kernprüfungen belegt, G9 offen | Geschützte Ausgabe nur mit Artikelstand, konkreter Fassung und Recht |
| ADR-25 | Schadensbegrenzung | Verbindliches Sicherheitsziel; detaillierte technische Maßnahmen vorgeschlagen | Schadensbegrenzung verbindlich; konkrete Isolation unbewiesen |
| ADR-26 | Backup/Wiederanlauf | Technischer Sicherheits- und Betriebsentwurf; Umsetzung nicht belegt | Ausfallsicherung vorgeschlagen; Wiederherstellungsnachweis offen |
| ADR-27 | Abgleich | Architekturvorschlag; teils zukünftig | Soll-Ist-Abgleich als Ergänzung zu Ereignissen vorgeschlagen |
| ADR-28 | CMS-Ausbau | Präferenz unter Vorbehalt | Eigen-CMS als bevorzugte Variante unter Editor-Prototyp-Vorbehalt |
| ADR-29 | Öffentliches Profil | Entwurf / nicht umgesetzt | Öffentliches Profil je Fachobjekt und bewusst gewählte Fassung |
| ADR-30 | Widget-Register | Entwurf / nicht vollständig umgesetzt | Registrierte Widget-Arten mit Schemaversion, Varianten und Referenzen |
| ADR-31 | Adressen/SEO | Entwurf | Anwendungsseitige Adressen, Weiterleitungen, SEO-Regeln |
| ADR-32 | Seiten-Cache | Entwurf / ungeprüft | Öffentliche Seiten ohne Sitzung und mit sicherem Cache |
| ADR-33 | Marketing | Zukunftskonzept | Marketing-Cockpit im Kern mit personenarmen Messdaten |
| ADR-34 | KI | Zukunftskonzept | KI nur als protokollierter Vorschlags-/Entwurfsschritt |
| ADR-35 | Messung | Entwurf / Rechtsprüfung offen | Reichweitenmessung ohne Cookies als Vorschlag; Prüfung offen |
| ADR-36 | Designsystem | Designprinzip fest; Tokens offen | Gemeinsame Design-Tokens für Website und Mitgliederbereich |
| ADR-37 | n8n-Anbindung | Option / nicht beschlossen | n8n allenfalls für externe Kanäle, ohne direkten Datenbankzugang |
| ADR-38 | Layoutvertrag der Widgets | Umgesetzt auf Test (18.11.2026); UX-Abnahme offen | Zulässige Rasterbreiten, Höhen und Verhalten bei wenig Platz je Widget-Art in der bestehenden Registry; Darstellung nach realer Containerbreite |
| ADR-39 | Premium-Karten mit Fachbezug | Umgesetzt auf Test (18.11.2026); gestalterische Freigabe v1.7 offen | Eine Karte je Platz im Abschnittsraster; Inhalte und Linkziel aus Thema, Medium oder Programm/Modul; keine Preise, keine Freigabe geschützter Medien |
| ADR-40 | Zentrale Medienverwaltung im CMS | Umgesetzt auf Test (19.11.2026); Abnahme offen | CMS-Bilder sind Medien des Medienmanagers (Kennung statt Pfad), öffentlich nur mit Website-Freigabe; frühere CMS-Bilder übernommen |
---
## ADR-01 – Integrierter modularer Kern mit Community-Satellit
**Status am 17.11.2026:** Grundrichtung fachlich gedeckt; Community-Teil offen.
**Abgleich mit dem aktuellen Projektstand:** Der modulare Laravel-Kern ist für die Testinstanz belegt; eine Community-Integration ist weder durch den MVP-Bericht nachgewiesen noch als konkretes Forum freigegeben. Die technische Trennung von Vertrauensbereichen bleibt ein zu prüfendes Sicherheitsziel.
**Belege:** Fachkonzept VIS-004/VIS-006; Abschlussbericht 16.11., § Pakete; ADR-25.
**Kontext.** Das Zielbild verbindet Website, Katalog, Lizenzen, Kauf, Medien, Organisationen und Community. Ein kleiner Anbieter betreibt die Plattform (VIS-006).
**Entscheidung.** Eine in Module gegliederte Kernanwendung mit einer Datenbank; Community als eigenständiges Produkt, schmal angebunden.
**Alternativen.** Kopfloses, komponiertes System; Komposition aus Standardsoftware; vollständiger Eigenbau einschließlich Community (`02`).
@@ -49,15 +79,23 @@ ## ADR-01 – Integrierter modularer Kern mit Community-Satellit
## ADR-02 – Technologiestapel des Kerns (ersetzt)
**Status am 17.11.2026:** Ist-Entscheidung durch Umsetzung; Produktivabnahme offen.
**Abgleich mit dem aktuellen Projektstand:** Der reale Kern wurde mit Laravel 13, Filament 5, PHP 8.4 und Tailwind 4 implementiert. Der frühere Technologievergleich Laravel versus Django ist damit für **den bestehenden Code** überholt; das Projekt soll nicht als technologieoffen dargestellt werden. Die Datenbankwahl PostgreSQL aus dem früheren Vorschlag ist durch die hier geprüften Belege nicht als Ist-Befund bestätigt. Es gibt nur eine Testinstanz, kein abgenommenes Produktivsystem.
**Belege:** Website-Zielarchitektur, §2 [BELEGT]; Abschlussbericht 16.11., Einleitung und Ergebnis.
**Kontext.** Redaktionsarbeitsplatz (WEB-005), Lizenzkern mit umfangreicher Verwaltung, Hintergrundverarbeitung, Medienverarbeitung; ein Betreiber mit begrenzter Wartungszeit, der Laravel/Filament aktuell betreibt und Python/PostgreSQL/Docker kennt.
**Entscheidung.** **Beschlossen am 15.11.2026 mit Beginn der Umsetzung:** Laravel 13, Filament 5, PHP 8.4 und PostgreSQL. Die Seiten sind server-gerendert; Entwurf, Vorschau, Veröffentlichung und Wiederherstellung einer Revision sind Bestandteil der Anwendung. Der frühere Vergleich bleibt als Begründung stehen: Unter dem Betriebsrahmen sprach mehr für Laravel + Filament. Der Machbarkeitsnachweis aus `10`, Abschnitt 2.1, wird durch die laufende Umsetzung ersetzt und nicht erneut als Studie geführt.
**Stand und technische Wahl.** Der frühere Kandidatenvergleich ist für das inzwischen bestehende System abgeschlossen **durch die realisierte Implementierung**: Laravel 13, Filament 5, PHP 8.4 und Tailwind 4 sind im Code dokumentiert. Das bezeichnet den Iststand, nicht eine nachträglich fingierte formale ADR-Freigabe. Django + Wagtail ist historische Alternative, nicht parallele aktuelle Umsetzung. Die konkrete Datenbanktechnologie ist mit den hier geprüften Nachweisen nicht gesichert; PostgreSQL war Teil des älteren Vorschlags. Das CMS-Erweiterungskonzept bleibt unter einem eigenen, noch zu prüfenden Editor-Prototyp-Vorbehalt (ADR-28).
**Alternativen.** Next.js + Payload; FastAPI + React + Headless CMS (beide weiterhin nicht empfohlen).
**Begründung.** Keine Fachanforderung entscheidet zwischen den beiden Kandidaten. Django + Wagtail bringt die Redaktion öffentlicher Seiten fertig mit und hat längere Pflegezeiträume. Laravel + Filament bringt die Verwaltungsoberflächen des Lizenzkerns (größter Einzelaufwand), die Hintergrundverarbeitung und die vorhandene Betriebserfahrung mit und vermeidet einen dritten Stapel.
**Folgen.** Die Umsetzung hat begonnen. Ein Wechsel des Stapels ist nicht mehr mit vertretbarem Aufwand möglich. Die Modulgrenzen aus `03` bleiben bestehen; die Formulierung älterer Kapitel ist weiterhin stapelneutral und wird nicht neu geschrieben.
**Abgelöst.** Frühere Fassung: „Django + Wagtail, knapp, wegen fertiger Redaktion und Medienwerkzeugen im selben Sprachraum“. Das Medienargument hielt der Prüfung nicht stand, das Redaktionsargument nur für öffentliche Seiten (Befunde CH-52, CH-53).
**Folgen.** Für bestehende Module gelten Laravel-/Filament-Schnittstellen als realer Bestand. Eine Grundsatz-Neuentscheidung zum Stack wäre ein Migrationsprojekt, keine offene Kleinentscheidung. Kein Rückschluss auf ein abgenommenes Produktivsystem.
**Historie (abgelöst).** Ursprüngliche Empfehlung: Django + Wagtail; danach offener Vergleich mit Laravel + Filament. Die spätere tatsächliche Laravel-/Filament-Implementierung ersetzt den offenen Stackvergleich für den Bestandskern. Der redaktionelle CMS-Komfort wird gesondert nachgewiesen (ADR-28).
## ADR-03 – Vier Ebenen des Produktmodells
**Status am 17.11.2026:** Fachlich verbindlich; Grundstruktur implementiert.
**Abgleich mit dem aktuellen Projektstand:** Die Trennung von Asset, didaktischer Komposition, Lizenzartikel, Angebot und Berechtigung ist fachlich festgelegt; der MVP-Bericht dokumentiert die entsprechenden Verwaltungs- und Katalogbereiche. „Modul“ und „Programm“ sind fachliche Inhaltsarten, nicht automatisch Artikel oder Pakete.
**Belege:** Fachkonzept PROD-001–008; Produktkonfiguration §2; Abschlussbericht, Pakete 2–7.
**Kontext.** PROD-001 verbietet eine starre Hierarchie; PROD-008 verlangt eigene Rollen für Medien, Inhalte, Artikel, Pakete, Angebote.
**Entscheidung.** Inhalt, Lizenzartikel, Angebot und Berechtigung sind getrennte Ebenen mit eigenen Identitäten und eigenen Lebenszyklen.
**Alternativen.** Ein „Produkt“-Objekt mit Typfeld und Eltern-Kind-Beziehung.
@@ -66,6 +104,10 @@ ## ADR-03 – Vier Ebenen des Produktmodells
## ADR-04 – Artikelgrenze durch ausdrückliche Deklaration
**Status am 17.11.2026:** Fachlich verbindlich; Abdeckungsprüfung implementiert.
**Abgleich mit dem aktuellen Projektstand:** Die Artikelgrenze ist eine ausdrückliche Entscheidung des Betreibers. Paket 7 der Mitgliederbibliothek enthält eine Abdeckungsprüfung; Tor B ist damit noch nicht bestanden.
**Belege:** Fachkonzept PROD-003–005; Produktkonfiguration §7; Abschlussbericht, Paket 7/Tor B.
**Kontext.** PROD-005 verlangt Auflösung auf die „kleinsten enthaltenen lizenzierbaren Artikel“. Im freien Inhaltsgraphen ist „kleinste“ nicht eindeutig, sobald sich Artikel überschneiden oder Material keinem kleineren Artikel angehört.
**Entscheidung.** Lizenzartikel sind die Blätter des Paketgraphen und werden nie weiter zerlegt. Der Betreiber deklariert sie. Eine Abdeckungsprüfung meldet Material, das von keinem Artikel erfasst ist.
**Alternativen.** Automatische Ableitung durch Abstieg im Inhaltsgraphen.
@@ -74,6 +116,10 @@ ## ADR-04 – Artikelgrenze durch ausdrückliche Deklaration
## ADR-05 – Berechtigung als unteilbares Bündel
**Status am 17.11.2026:** Fachlich verbindlich; im Kern umgesetzt, G9 offen.
**Abgleich mit dem aktuellen Projektstand:** Berechtigungen dürfen niemals aus Teilrechten verschiedener Erwerbsquellen kombiniert werden. Der MVP implementiert getrennte Rechteprüfungen, aber der vollständige HTTP-End-to-End-Nachweis G9 steht aus.
**Belege:** Fachkonzept LIC-005/LIC-006; Produktkonfiguration §7/§11; Abschlussbericht, Pakete 3/8/9.
**Kontext.** LIC-006: keine Vermischung zu nicht erworbenen Kombinationen.
**Entscheidung.** Jede Berechtigung trägt ein vollständiges Rechtebündel. Die Entscheidungsfunktion prüft jede Bedingung an **derselben** Berechtigung. Eine Vereinigung über Berechtigungen existiert im Code nicht.
**Alternativen.** Wirksame Rechte als Vereinigung aller Fähigkeiten mit nachträglichen Ausschlussregeln.
@@ -82,6 +128,10 @@ ## ADR-05 – Berechtigung als unteilbares Bündel
## ADR-06 – Eingefrorener Bestellumfang
**Status am 17.11.2026:** Fachlich verbindlich; technische Details nicht vollständig abgenommen.
**Abgleich mit dem aktuellen Projektstand:** Unveränderliche Kauf-/Lizenznachweise und eine historische Bestellbezeichnung sind verbindlich. Paket 1 sichert nach Bericht die Bestellbezeichnung; vollständige technische Prüfung sämtlicher Rechte-, Laufzeit- und Snapshot-Daten ist damit nicht belegt.
**Belege:** Fachkonzept PROD-006, PAY-005; Abschlussbericht, Paket 1/G8 und Tor B.
**Kontext.** PROD-006, PAY-005: Angebote und Pakete ändern sich; frühere Käufe müssen rekonstruierbar bleiben.
**Entscheidung.** Die Bestellposition verweist auf die Angebotsfassung **und** trägt eine eigene Kopie des aufgelösten Umfangs einschließlich einer Kopie der Rechte, der Laufzeit und der Updatezusage.
**Alternativen.** Nur Verweis auf die unveränderliche Angebotsfassung.
@@ -90,6 +140,10 @@ ## ADR-06 – Eingefrorener Bestellumfang
## ADR-07 – Versionierung der Lernprodukte
**Status am 17.11.2026:** Fachlich verbindlich; Fassungsmodell implementiert, UX in Arbeit.
**Abgleich mit dem aktuellen Projektstand:** Freigegebene Fassungen und Referenzen bleiben historisch fixiert. Ein dauerhafter Bearbeitungsentwurf mit beliebig vielen Speicherungen vor einer Freigabe wurde im UX-Chat als Ziel konkretisiert; seine Umsetzung ist aus den geprüften Dateien nicht nachgewiesen. Ein Speichern im Editor darf nicht ohne Prüfung als fachlicher Release gelten.
**Belege:** Fachkonzept VER-001–010; Produktkonfiguration §4/§12; Abschlussbericht, Redaktion.
**Kontext.** VER-001 bis VER-006.
**Entscheidung.** Unveränderliche Fassungen für Inhalte und Kompositionen; Kompositionen verweisen auf exakte Mitgliedsfassungen; Kompatibilitätsbestätigung ist an die Prüfsumme der Mitgliedermenge gebunden.
**Alternativen.** „Aktuelle Fassung“ als gleitender Verweis; gemeinsame Versionsnummer für alle Bestandteile.
@@ -98,6 +152,10 @@ ## ADR-07 – Versionierung der Lernprodukte
## ADR-08 – Veröffentlichung als Vorgang mit atomarer Umschaltung
**Status am 17.11.2026:** Fachliche Sicherheitsanforderung; technische Atomarität nicht vollständig nachgewiesen.
**Abgleich mit dem aktuellen Projektstand:** Unfertige oder fehlerhafte neue Fassungen dürfen veröffentlichte Stände nicht beschädigen. Die genaue technische Transaktionsgrenze und vollständige atomare Veröffentlichung sind in den verfügbaren MVP-Nachweisen nicht unabhängig abgenommen.
**Belege:** Fachkonzept VER-003/VER-005, ADM-003; Abschlussbericht, Tor B offen.
**Kontext.** VER-005, ADM-003, SC-18: kein halb veröffentlichter Stand.
**Entscheidung.** Alle Medien liegen vor der Freigabe vollständig und unveränderlich adressiert vor; die Veröffentlichung ändert in einer Transaktion nur Zeiger und Status.
**Alternativen.** Schrittweises Aktivieren einzelner Objekte.
@@ -106,6 +164,10 @@ ## ADR-08 – Veröffentlichung als Vorgang mit atomarer Umschaltung
## ADR-09 – Aktualisierungen: alle freigegebenen Fassungen des Artikels (ersetzt)
**Status am 17.11.2026:** Fachlich beschlossen; Produktregel verbindlich.
**Abgleich mit dem aktuellen Projektstand:** Die Beschlüsse F-NEU-01/02 sind ausdrücklich verbindlich: Neue freigegebene Fassungen **desselben Lizenzartikels** sind während der Gültigkeit grundsätzlich enthalten; ältere zulässige Fassungen bleiben grundsätzlich verfügbar. **Neue Artikel** kommen dadurch nicht automatisch hinzu. Verfügbarkeit einzelner historischer Stände im gesamten E2E-Betrieb bleibt zu prüfen.
**Belege:** Fachkonzept VER-008/VER-010/§15; Produktkonfiguration §14; Abschlussbericht.
**Kontext.** VER-008 und VER-010 in der Fassung vom 14.11.2026 (Beschlüsse F-NEU-01, F-NEU-02): Die Updatepolitik ist entschieden.
**Entscheidung.** Eine gültige Berechtigung deckt jeden freigegebenen, nicht gesperrten Stand ihres Lizenzartikels (INV-18). Es gibt keine wählbaren Anspruchsregeln. Abgelöste Stände bleiben im Regelfall verfügbar; Sperre und Rückzug sind begründungspflichtige Einzelentscheidungen. Die Updatezusage wird als fester Wert in Angebotsfassung und Bestellung festgehalten. Die Einordnung „neue Fassung“ oder „neues Produkt“ ist eine festgehaltene Betreiberentscheidung mit Begründung; der Auswirkungsbericht zeigt ihre Folgen (`06`, Abschnitt 7).
**Alternativen.** (a) Wählbare Regeln je Angebot (frühere Fassung); (b) Regel nur im Code ohne festgehaltene Zusage; (c) technische Kriterien für die Produktgrenze.
@@ -115,6 +177,10 @@ ## ADR-09 – Aktualisierungen: alle freigegebenen Fassungen des Artikels (erset
## ADR-10 – Upgrade als zusätzlicher Erwerb (ersetzt)
**Status am 17.11.2026:** Fachliche Schutzregel verbindlich; Upgrade-Technik nur vorgeschlagen.
**Abgleich mit dem aktuellen Projektstand:** LIC-012 verbietet unbeabsichtigte Verschlechterung erworbener Rechte. Die hier skizzierte technische Umsetzung als **zusätzlicher Erwerb mit vollständiger Berechtigung** und Abhängigkeitskennzeichen ist ein Architekturvorschlag; Preisformel, Abhängigkeit und Upgrade-Betriebsablauf sind nicht freigegeben bzw. nicht als MVP umgesetzt.
**Belege:** Fachkonzept LIC-012/LIC-011; Zukunftskonzept 16.11.; Abschlussbericht, Zurückgestellt.
**Kontext.** LIC-007, LIC-012 (Beschluss F-NEU-03), SC-09.
**Entscheidung.** Ein Upgrade ist eine Bestellposition und wird zu einem eigenen Erwerb mit einer neuen, vollständigen Berechtigung. Die vorhandene Berechtigung bleibt **unverändert aktiv** (INV-19). Die Bestellposition hält fest, auf welche Berechtigung sich das Upgrade bezieht und ob es von deren Fortbestand abhängt („abhängig“ oder „eigenständig“). Fällt die Bezugsberechtigung eines abhängigen Upgrades durch Erstattung, Rückbuchung oder Widerruf weg, wird das Upgrade ausgesetzt und ein Klärungsfall angelegt (`05`, Abschnitt 8).
**Alternativen.** (a) Zusatzrecht, das eine vorhandene Berechtigung ergänzt; (b) Ersetzung der Ausgangsberechtigung mit Zustand „aufgegangen“ (frühere Fassung).
@@ -124,6 +190,10 @@ ## ADR-10 – Upgrade als zusätzlicher Erwerb (ersetzt)
## ADR-11 – Inhaber ist Person oder Organisation
**Status am 17.11.2026:** Zielbild fachlich fest; institutioneller Betrieb später.
**Abgleich mit dem aktuellen Projektstand:** Organisationen als eigenständige Lizenzinhaber sind Teil des Zielbilds. Der erste kommerzielle Slice darf sich auf Einzelpersonen beschränken; er darf persönliche Freischaltungen **nicht** als Organisationslizenzen ausgeben. Technische Sitzpool-/Zuweisungsdetails sind nicht als MVP-Implementierung nachgewiesen.
**Belege:** Fachkonzept ID-003/ID-004 und §15 F-NEU-04; Abschlussbericht, Zurückgestellt.
**Kontext.** ID-003, ID-004, SCOPE-003.
**Entscheidung.** Berechtigungen zeigen von Beginn an auf einen abstrakten Inhaber. Sitzpool und Sitzzuweisung sind Teil des Grundmodells, auch wenn die Oberfläche später kommt.
**Alternativen.** Berechtigung am Konto; Organisationen später nachrüsten.
@@ -133,8 +203,12 @@ ## ADR-11 – Inhaber ist Person oder Organisation
## ADR-12 – Community als Fremdprodukt, Kern führt
**Status am 17.11.2026:** Architekturvorschlag; Community nicht umgesetzt.
**Abgleich mit dem aktuellen Projektstand:** Eine Fachcommunity ist fachlich vorgesehen; Discourse und die skizzierte Foren-Synchronisation sind Kandidaten, keine getroffene Softwarewahl. Kein Community-Betrieb wurde im MVP-Bericht nachgewiesen.
**Belege:** Fachkonzept COM-001–007; Abschlussbericht, Zurückgestellt.
**Kontext.** COM-001 bis COM-007.
**Entscheidung.** Selbst betriebene Forensoftware (Kandidat: Discourse); der Kern ist Identitätsgeber, steuert Gruppen aktiv und legt Themen je Artikel an. Kein Zustand der Community verändert Rechte im Kern.
**Architekturvorschlag.** Selbst betriebene Forensoftware (Discourse ist **Kandidat**, nicht ausgewählt); der Kern wäre Identitätsgeber und würde Gruppen steuern. Kein Zustand der Community darf die Produktrechte im Kern verändern.
**Alternativen.** Eigenbau; gehostetes Produkt; anderes Forenprodukt.
**Begründung.** Reife Moderations- und Kommunikationsfunktionen; schmale Kopplung; Ausfall ohne Wirkung auf Kernwege.
**Folgen.** Zweiter Technologiestapel mit eigenem Aktualisierungsrhythmus; Mailversand zwingend.
@@ -142,14 +216,22 @@ ## ADR-12 – Community als Fremdprodukt, Kern führt
## ADR-13 – Trainerverzeichnis im Kern
**Status am 17.11.2026:** Fachliches Zielbild, technische Zuordnung vorgeschlagen.
**Abgleich mit dem aktuellen Projektstand:** Privatsphäre und fachliche Trainerverifikation sind verbindliche Anforderungen; die konkrete Verzeichnisimplementierung im Kern ist noch Zukunftsarchitektur.
**Belege:** Fachkonzept ID-002, COM-003/COM-005; Abschlussbericht, Zurückgestellt.
**Kontext.** COM-003, COM-005, SC-22: Sichtbarkeit je Angabe, Suche darf Verborgenes nicht verraten.
**Entscheidung.** Profil, Sichtbarkeit, Verzeichnis, Suche und Kontaktanfrage liegen im Kern.
**Architekturvorschlag.** Profil, Sichtbarkeit, Verzeichnis, Suche und Kontaktanfrage liegen im Kern; genaue Ausgestaltung und Freigabe für eine öffentliche Auflistung erfordern eine spätere Implementierungsentscheidung.
**Alternativen.** Nutzerverzeichnis und Standorterweiterung der Forensoftware.
**Begründung.** Feines Privatsphäremodell; Verknüpfung mit dem Trainerstatus; Darstellung auch auf der Website; die geprüfte Erweiterung bietet das nicht in der nötigen Feinheit.
**Folgen.** Eigenentwicklung überschaubaren Umfangs.
## ADR-14 – Zahlung hinter Adapter mit aktivem Abgleich
**Status am 17.11.2026:** Verbindliche Zahlungsprinzipien; Adapter nicht umgesetzt.
**Abgleich mit dem aktuellen Projektstand:** Ein externer Zahlungsdienst und belastbare Freischaltung sind vorgesehen. Konkreter Zahlungsanbieter, Zahlungsarten und die vollständige Adapterarchitektur sind weiterhin offen; der Bericht schließt echten Zahlungsdienst aus dem MVP aus.
**Belege:** Fachkonzept PAY-001–006; Abschlussbericht, Zurückgestellt.
**Kontext.** PAY-001, PAY-004, OPS-003, SC-24; Anbieter offen (PAY-006).
**Entscheidung.** Adapter mit vier Operationen. Freischaltung nur nach signiertem Ereignis oder aktiver Statusabfrage. Eingangskorb mit eindeutiger Ereignis-ID. Regelmäßiger Abgleich der Ereignisliste und aller offenen Bestellungen.
**Alternativen.** Freischaltung beim Rücksprung des Browsers; Vertrauen allein auf Wiederholungen des Dienstes.
@@ -159,6 +241,10 @@ ## ADR-14 – Zahlung hinter Adapter mit aktivem Abgleich
## ADR-15 – Streamingschutz ohne DRM
**Status am 17.11.2026:** MVP-Teilbeleg: signiertes HLS; weitergehender Schutz offen.
**Abgleich mit dem aktuellen Projektstand:** Die Testinstanz spielt HLS mit signierten Playlists und Segmenten ab. Eine durchgehend sitzungsgebundene Adressvergabe oder optionale Segmentverschlüsselung ist hier nicht unabhängig nachgewiesen. Kein DRM zu versprechen.
**Belege:** Fachkonzept MED-001/MED-003; Abschlussbericht, Paket 8 und Medientest.
**Kontext.** MED-001, MED-003; MED-002 verlangt keine absolute Kopierverhinderung.
**Entscheidung.** Segmentiertes Streaming über kurzlebig signierte, an eine Sitzung gebundene Adressen; optional Abschnittsverschlüsselung.
**Alternativen.** Kommerzielles DRM.
@@ -167,6 +253,10 @@ ## ADR-15 – Streamingschutz ohne DRM
## ADR-16 – Medienauslieferung als Adapter
**Status am 17.11.2026:** Lokale Ausgabe belegt; austauschbares CDN/Adaptermodell nicht abgenommen.
**Abgleich mit dem aktuellen Projektstand:** Die lokale geschützte Medienausgabe wird im MVP-Test beschrieben. Austauschbarkeit des Lieferadapters und Umschaltung auf ein CDN sind Zielarchitektur, nicht gegenwärtige Produktfunktion.
**Belege:** Fachkonzept MED-003/MED-006; Abschlussbericht, Pakete 6/8.
**Kontext.** OPS-001 verlangt Start auf eigenem Server; MED-006 verlangt verlässliche Wiedergabe im Kurs.
**Entscheidung.** Ausgabe stellt signierte Adressen aus; wer sie bedient, ist konfigurierbar. Start lokal; Wechsel auf ein Auslieferungsnetz bei definierten Schwellen.
**Alternativen.** Von Beginn an Auslieferungsnetz; dauerhaft lokal; vollständiger Videodienst.
@@ -175,6 +265,10 @@ ## ADR-16 – Medienauslieferung als Adapter
## ADR-17 – Stufenmodell der Kennzeichnung
**Status am 17.11.2026:** Teilimplementierung; forensisches Wasserzeichen offen.
**Abgleich mit dem aktuellen Projektstand:** Der MVP-Bericht bestätigt Ausgabenachweis und sichtbare Lizenzzeile für Text. Ein forensisch wirksames unsichtbares Videowasserzeichen ist ausdrücklich **nicht nachgewiesen** und darf nicht vermarktet werden.
**Belege:** Fachkonzept MED-002/MED-005; Abschlussbericht, Paket 8.
**Kontext.** MED-002, MED-005, OPEN-05.
**Entscheidung.** Nachweis, eingebettete Kennung und sichtbare Lizenzzeile als feste Stufen; unauffällige Dokumentmerkmale als Ergänzung; forensisches Videowasserzeichen als Option nach bestandenem Versuch.
**Alternativen.** Sofortige Zusage eines unsichtbaren Videowasserzeichens; Verzicht auf individuelle Kennzeichnung.
@@ -183,6 +277,10 @@ ## ADR-17 – Stufenmodell der Kennzeichnung
## ADR-18 – Ausgabenachweis vor Erzeugung
**Status am 17.11.2026:** Nachweisfunktion implementiert; Manipulationsschutz nicht belegt.
**Abgleich mit dem aktuellen Projektstand:** Der Bericht dokumentiert individuelle Ausgabenachweise. Datenbankseitige Append-only-Garantien, externe Audit-Anker sowie Wiederherstellungsbeweise sind damit nicht automatisch erfüllt.
**Belege:** Fachkonzept VER-009, SEC-003; Abschlussbericht, Paket 8; ADR-25/26.
**Kontext.** VER-009, INV-10.
**Entscheidung.** Der Nachweis wird beim Anfordern angelegt und begleitet die Datei durch Erzeugung und Auslieferung.
**Alternativen.** Protokollierung nach erfolgreichem Download.
@@ -192,6 +290,10 @@ ## ADR-18 – Ausgabenachweis vor Erzeugung
## ADR-19 – Datenbankgestützte Hintergrundverarbeitung
**Status am 17.11.2026:** Queue belegt; Outbox-Garantie offen.
**Abgleich mit dem aktuellen Projektstand:** Eine Queue für Vorschaubild-/HLS-Ableitungen ist technisch belegt. Ob **alle** fachlichen Ereignisse transaktional und ausfallsicher in einem Outbox-Modell verarbeitet werden, ist durch die vorliegenden Quellen nicht belegt.
**Belege:** Abschlussbericht, Paket 6/Deployment; ADR-27.
**Kontext.** Medienverarbeitung, Individualisierung, Abgleich, Benachrichtigung, Community-Abgleich; OPS-003 verlangt verlustfreien Umzug offener Aufträge.
**Entscheidung.** Aufträge und fachliche Ereignisse liegen in der Kerndatenbank und werden in derselben Transaktion wie die auslösende Änderung geschrieben.
**Alternativen.** Eigener Warteschlangendienst.
@@ -200,6 +302,10 @@ ## ADR-19 – Datenbankgestützte Hintergrundverarbeitung
## ADR-20 – Containerbetrieb auf einem Server
**Status am 17.11.2026:** Container-Testbetrieb belegt; Produktivbetrieb offen.
**Abgleich mit dem aktuellen Projektstand:** Die Testinstanz läuft als Container auf dem beschriebenen Server; ein Produktivsystem ist im Bericht nicht vorhanden. Standortausfall, Wiederanlauf und belastbare RPO/RTO sind nicht abgenommen.
**Belege:** Fachkonzept OPS-001–004; Abschlussbericht, Einleitung; ADR-26.
**Kontext.** OPS-001 bis OPS-004.
**Entscheidung.** Alle Bausteine als Container mit einer Compose-Beschreibung; gesamter Zustand in Datenbank, Medienspeicher und Community-Sicherung.
**Alternativen.** Direktinstallation; Orchestrierer.
@@ -209,30 +315,46 @@ ## ADR-20 – Containerbetrieb auf einem Server
## ADR-21 – Rechnung über externen Dienst
**Status am 17.11.2026:** Architekturvorschlag; geschäftlich und technisch offen.
**Abgleich mit dem aktuellen Projektstand:** Die externe Rechnungs-/Zahlungsdienstwahl ist ausdrücklich noch offen. Diese Adapter-Empfehlung ist kein ausgewähltes Produkt und keine freigegebene Rechnungslösung.
**Belege:** Fachkonzept PAY-005/PAY-006; Abschlussbericht, Zurückgestellt.
**Kontext.** PAY-005; E-Rechnung zwischen Unternehmen wird verpflichtend.
**Entscheidung.** Rechnungsadapter; der Kern hält Nummer und unveränderliche Kopie.
**Architekturvorschlag.** Rechnungsadapter; der Kern hält Nummer und unveränderliche Kopie. Auswahl des externen Dienstes und konkreter Rechnungsprozess sind offen.
**Alternativen.** Erzeugung im Kern; Rechnungsfunktion des Zahlungsdienstes.
**Begründung.** Formatpflichten, Nummernkreise, Korrekturen und Übergabe an die Steuerberatung sind nicht Kernkompetenz der Plattform.
**Folgen.** Laufende Kosten; Produktwahl mit der Steuerberatung.
## ADR-22 – Seiten aus Bausteinen, Katalogdarstellung über Verweise
**Status am 17.11.2026:** Gemeinsames Fachprinzip verbindlich; konkrete CMS-Lösung unter Vorbehalt.
**Abgleich mit dem aktuellen Projektstand:** Keine doppelte Produktdatenpflege und geprüfte Katalogverweise sind verbindlich. Bestehendes Seitensystem mit sechs Blockarten, Revision und Vorschau ist belegt; **Varianten, öffentliche Objektprofile und komfortabler Seiteneditor sind nicht allein dadurch umgesetzt**. Ausbau des Eigen-CMS ist bevorzugte Architektur **unter Vorbehalt des Editor-Prototyps**, keine ungeprüft endgültige CMS-Wahl.
**Belege:** Fachkonzept WEB-001/WEB-004; Website-Zielarchitektur §§2, 4.4–4.5, 5.3; Website-Zielkonzept §10.
**Kontext.** WEB-004, WEB-005.
**Entscheidung.** Freier Seitenbaum mit geprüfter Bausteinbibliothek; Katalogbausteine zeigen auf Identitäten und stellen den aktuell veröffentlichten Stand dar; Preise und Rechte sind auf Seiten nicht frei eintippbar.
**Fachliche Regel und Zielarchitektur.** Seiten bestehen aus geprüften Bausteinen; Katalogbausteine sollen auf Fachidentitäten zeigen und nur die öffentlich zulässige Fassung aus maßgeblichen Daten anzeigen. Preise und Rechte dürfen auf Seiten nicht als frei gepflegte Ersatzdaten geführt werden. Ein vollständig freier mehrstufiger Seitenbaum und dynamische Katalogbausteine sind **Zielumfang**, nicht als fertig belegt; die vorhandenen sechs CMS-Bausteine und Seitenrevisionen sind Istbestand.
**Alternativen.** Freier Layout-Editor; feste Seitenvorlagen ohne Baukasten.
**Begründung.** Konsistenz zwischen Seite, Angebot und Freischaltung; Zugänglichkeit bleibt prüfbar; Redaktion bleibt beweglich.
**Folgen.** Neue Bausteintypen sind Entwicklungsarbeit.
## ADR-23 – Erwerb als individuelle Berechtigungsquelle (neu)
**Status am 17.11.2026:** Erwerbs-/Quellenprinzip fachlich gedeckt; Abo später.
**Abgleich mit dem aktuellen Projektstand:** Berechtigungsquelle und Inhaber müssen nachvollziehbar bleiben. Kostenloser Abruf und manuelle Vergabe sind im Kern angelegt; der technische „Erwerb“ aus dem ursprünglichen Architekturvorschlag darf nicht ohne Codeprüfung als exakt so implementiert gelten. **Abonnements sind offen**, kein bestehender vierter MVP-Erwerbstyp.
**Belege:** Fachkonzept LIC-001/LIC-005; Produktkonfiguration §2/§7; Abschlussbericht, Testangebot und Zurückgestellt.
**Kontext.** LIC-001, LIC-005, PAY-004; Befunde CH-01, CH-02: Die frühere „Quelle“ war je nach Fundstelle ein Angebot, eine Bestellposition oder eine Inhaberart, und ihre Eindeutigkeitsregel ließ entweder nur ein Mitglied je kostenlosem Angebot zu oder gar keine Sicherung gegen Doppelvergabe.
**Entscheidung.** Jede Berechtigung gehört zu genau einem **Erwerb** mit genau einem Inhaber. Vier Erwerbstypen: Bestellposition, freier Abruf, manuelle Vergabe, Abonnement. Eindeutig ist der Erwerb je Bestellposition bzw. je (Inhaber, kostenloses Angebot) und die Berechtigung je (Erwerb, Artikel, Rechteprofil-Fassung). Das allgemeine Angebot und die Organisation sind keine Quellen; „über Organisation X“ ist ein Zugriffsweg.
**Architekturvorschlag.** Jede Berechtigung gehört zu genau einem **Erwerb** mit genau einem Inhaber. Vorgesehen sind Bestellposition, freier Abruf und manuelle Vergabe; Abonnement bleibt eine spätere, nicht beschlossene Geschäftsoption und ist kein nachgewiesener MVP-Erwerbstyp. Eindeutig ist der Erwerb je Bestellposition bzw. je (Inhaber, kostenloses Angebot) und die Berechtigung je (Erwerb, Artikel, Rechteprofil-Fassung). Das allgemeine Angebot und die Organisation sind keine Quellen; „über Organisation X“ ist ein Zugriffsweg.
**Alternativen.** (a) Inhaber in den Eindeutigkeitsschlüssel der Berechtigung aufnehmen und die Quelle beim Angebot belassen; (b) je Vergabe eine namenlose Quellenzeile ohne eigene Eindeutigkeit.
**Begründung.** (a) behebt die Kollision, lässt aber die Vermengung von Angebot und Herkunft bestehen und trägt Upgrade-Bezug, Sitzpool und eingefrorene Bedingungen nicht. (b) verliert die Idempotenz. Der Erwerb ist der natürliche Träger für alles, was beim Erwerb vereinbart wurde.
**Folgen.** Ein zusätzliches Objekt in der zentralen Struktur; gehört zu den nicht verhandelbaren Vorleistungen der ersten Stufe.
## ADR-24 – Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands (neu)
**Status am 17.11.2026:** Fachlich verbindlich; Kernprüfungen belegt, G9 offen.
**Abgleich mit dem aktuellen Projektstand:** Ausgabe nur bei zutreffendem Artikel-Stand, enthaltenem Medium und passender Berechtigung je Aktion ist fachlich verbindlich. Die lokale Testsuite deckt diese Logik nach Bericht ab; die wiederholbare HTTP-Instanzsuite und Tor B fehlen.
**Belege:** Fachkonzept MED-003, LIC-006; Produktkonfiguration §11; Abschlussbericht, Paket 8/G9.
**Kontext.** MED-003, VER-008 Nr. 4; Befunde CH-03, CH-14: Die Entscheidung prüfte das Recht, aber nicht, ob das angefragte Medium zu dem Artikel und Stand gehört, für den das Recht besteht.
**Entscheidung.** Jeder Stand hält bei der Freigabe seinen fixierten Inhalt als flache, unveränderliche Liste fest. Die Entscheidung lehnt ab, wenn der Stand nicht zum Artikel oder die Inhaltsfassung nicht zu diesem Inhalt gehört. Eine Zugriffsfreigabe gilt für genau eine Datei bzw. ein Stream-Format der entschiedenen Inhaltsfassung, mit passendem Zweck (INV-17).
**Alternativen.** (a) Zugehörigkeit bei jeder Anfrage durch Durchlaufen des Kompositionsgraphen ermitteln; (b) Schutz allein durch nicht erratbare Dateipfade; (c) Verschlüsselung je Artikel.
@@ -241,6 +363,10 @@ ## ADR-24 – Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands (ne
## ADR-25 – Schadensbegrenzung innerhalb des Kerns (neu)
**Status am 17.11.2026:** Verbindliches Sicherheitsziel; detaillierte technische Maßnahmen vorgeschlagen.
**Abgleich mit dem aktuellen Projektstand:** SEC-003 verpflichtet zu begrenztem Schaden nach Kompromittierung. Zwei Datenbankrollen, getrennte administrative Herkunftsadressen, append-only auf Datenbankebene und Unterprozess-Isolation sind konkrete Architekturvorschläge; die verfügbaren Unterlagen belegen **keine vollständige Umsetzung**.
**Belege:** Fachkonzept SEC-001–004; Website-Zielarchitektur §2 (nicht geprüfte Sicherheitsfragen); Abschlussbericht.
**Kontext.** SEC-003 (Beschluss F-NEU-05); Befunde CH-37, CH-44, CH-46, CH-47: ein Prozess, ein Datenbankzugang, eine Rolle „alles“; „unveränderlich“ nur als Konvention.
**Entscheidung.** Der Kern bleibt eine ausrollbare Einheit, läuft aber in getrennten Betriebsarten mit verschiedenen Rechten: Die Web-Betriebsart hat eine eingeschränkte Datenbankrolle (Auditprotokoll und Ausgabenachweis nur anfügbar, freigegebene Fassungen nicht änderbar, keine Schemaänderung) und keinen Zugriff auf Originale. Fremde Dateien werden in einem abgeschotteten Unterprozess gelesen. Website, Forum und Verwaltung haben getrennte Herkunftsadressen. In der Verwaltung gibt es keine Rolle „alles“; Rollenvergabe liegt bei einem eigenen Systemkonto; wirkungsstarke Vorgänge haben Mengengrenzen und eine Meldung außerhalb der Plattform.
**Alternativen.** (a) Aufteilung des Kerns in getrennte Dienste (Variante B); (b) Verzicht auf innere Grenzen und Verlass auf Aktualisierungen und Mehrfaktor; (c) erzwungenes Vier-Augen-Prinzip.
@@ -249,6 +375,10 @@ ## ADR-25 – Schadensbegrenzung innerhalb des Kerns (neu)
## ADR-26 – Sicherung außer Reichweite, Sicherheitsjournal, Ziele je Schadensfall (neu)
**Status am 17.11.2026:** Technischer Sicherheits- und Betriebsentwurf; Umsetzung nicht belegt.
**Abgleich mit dem aktuellen Projektstand:** Gesicherter Betrieb, Backups und Wiederherstellung sind Ziele, aber fortlaufende externe WAL-Protokolle, anfügebare Sicherung, Sicherheitsjournal und gemessene Wiederanlaufzeiten sind durch den geprüften MVP-Bericht nicht nachgewiesen. Keine Aussage „umgesetzt“ oder „RTO erreicht“.
**Belege:** Fachkonzept OPS-002/OPS-003, SEC-002; Abschlussbericht.
**Kontext.** OPS-002, OPS-003, SEC-002; Befunde CH-41 bis CH-45: Die Zielwerte waren für Standortverlust und Kompromittierung nicht getragen; Sicherungen waren vom Server aus zerstörbar; eine Wiederherstellung hob Sicherheitsentscheidungen auf.
**Entscheidung.** (1) Ziele je Schadensfall statt eines Pauschalwerts; sie gelten erst nach einer Übung mit Zeitmessung als belegt. (2) Fortlaufendes Änderungsprotokoll der Datenbank an zwei Ziele, eines außer Haus. (3) Das Außer-Haus-Ziel ist aus Sicht des Servers nur anfügbar. (4) Eine Inhaltsfassung wird erst „bereit“, wenn ihr Original an zwei Orten bestätigt vorliegt. (5) Ein Sicherheitsjournal außerhalb des Servers hält Rückzüge, Sperren, Entzüge und Löschungen fest und wird nach jedem Zurückspielen erneut angewendet, bevor die Plattform öffnet. (6) Anker der Audit-Kette außerhalb des Servers. (7) Fehlbedienung und Kontomissbrauch werden vorwärts korrigiert, nicht zurückgespielt.
**Alternativen.** (a) Zweiter, laufend gespiegelter Standort; (b) tägliche Sicherung außer Haus ohne Änderungsprotokoll; (c) sofortiger Umzug auf einen Mietserver.
@@ -257,8 +387,142 @@ ## ADR-26 – Sicherung außer Reichweite, Sicherheitsjournal, Ziele je Schadens
## ADR-27 – Ereignisse für Schnelligkeit, Abgleich für Richtigkeit (neu)
**Status am 17.11.2026:** Architekturvorschlag; teils zukünftig.
**Abgleich mit dem aktuellen Projektstand:** Ereignis plus idempotenter Soll-Ist-Abgleich ist ein plausibles Muster. Für Payment- und Community-Synchronisation besteht nach dem MVP-Bericht noch keine abgeschlossene Integration; daher nicht als vorhandenes System deklarieren.
**Belege:** Fachkonzept PAY-004, COM-002; Abschlussbericht, Zurückgestellt.
**Kontext.** PAY-004, PROD-005, COM-002; Befunde CH-18, CH-21, CH-30: Mehrere Zusicherungen hingen an genau einem Ereignis und gingen verloren, wenn es fehlte, doppelt kam oder in falscher Reihenfolge eintraf.
**Entscheidung.** Wo ein Anspruch aus einer Regel folgt (kostenloses Angebot, dynamische Angebotsfassung) oder ein Zustand in einem fremden System nachzuführen ist (Zahlungszustand, Gruppen und Sperren im Forum), gibt es neben dem Ereignis einen wiederholbaren, idempotenten Soll-Ist-Abgleich.
**Alternativen.** Verlass auf garantierte Zustellung der Ereignisse.
**Begründung.** Zustellung ist zwischen getrennten Systemen und über Ausfälle hinweg nicht garantierbar; ein Abgleich ist bei den erwarteten Mengen billig und macht Fehler selbstheilend.
**Folgen.** Jede abgeglichene Operation muss idempotent sein (ADR-23 sichert das für Vergaben). Abweichungen werden behoben **und** gemeldet, nie stillschweigend.
---
## ADR-28 – Ausbaurichtung des bestehenden CMS
**Status am 17.11.2026:** Bevorzugter Architekturentwurf, **nicht abschließend freigegeben**.
**Kontext.** Das Laravel-/Filament-Seitensystem besitzt Seitenrevisionen, Vorschau und sechs Bausteinarten; Vorlagen, Abschnittsvarianten und Katalogbezug fehlen laut Code-Sichtung vom 15.11.2026.
**Vorschlag.** Den vorhandenen CMS-Kern mit Seitentypen, Vorlagen, Varianten und globalen Abschnitten erweitern (Variante D). Vor verbindlicher Entscheidung den dokumentierten kleinen Editor-Prototyp W-P mit neun Bedienaufgaben prüfen.
**Alternativen.** Statamic, Twill, freier Builder, Headless-CMS.
**Folgen und offene Prüfung.** Nur bei bestandener praktischer UX-Abnahme wird D bestätigt. Die ursprüngliche Architektur erlaubt bei Bedienproblemen einen anderen Editor unter demselben Bausteinvertrag.
**Quelle.** Website-CMS-Zielarchitektur §§4.4–4.5, 12, 14; Website-Zielkonzept §10.
## ADR-29 – Öffentliche Fachobjektprofile
**Status am 17.11.2026:** Architekturentwurf, **öffentliche Katalogintegration nicht nachgewiesen**.
**Kontext.** Die Bibliothek unterscheidet technische Bereitschaft, Freigabe für Mitglieder und kommerzielle Berechtigung. Öffentliche Listung ist eine zusätzliche redaktionelle Entscheidung.
**Vorschlag.** Ein schmales öffentliches Profil je Fachidentität speichert Listungszustand, Adresse, Fassungsauswahl, freigegebenes Marketingbild und SEO-Überschreibungen; Darstellung liest Fachdaten ohne Kopien. Nur ausdrücklich freigegebene und geeignete Fassungen sind öffentlich sichtbar.
**Alternativen.** Je Fachobjekt kopierte CMS-Seite; automatische öffentliche Anzeige aufgrund einer Mitgliederfreigabe.
**Folgen und offene Prüfung.** Geschützte Dateien, Lehrtexte, Trainerfragen und interne Medienadressen dürfen die öffentliche Lesesicht nicht passieren; Freigabe und Fassungswechsel benötigen Nachweise.
**Quelle.** Fachkonzept WEB-004; Produktkonfiguration §§4–5; Website-CMS-Zielarchitektur §6.2 und ADR-29-Tabelle.
## ADR-30 – Erweiterbares Baustein-/Widget-Register
**Status am 17.11.2026:** Technisch konkretisierter **Vorschlag**; vollständige Umsetzung nicht belegt.
**Kontext.** Ein Seiteneditor muss statische Inhalte, kuratierte Katalogbezüge und später regelbasierte Listen tragen, ohne ein zweites Produktdatenmodell einzuführen.
**Vorschlag.** Codebasiertes Register mit `id`, `type`, `v`, `variant`, `settings`, `data`, `refs`; jeder Widget-Typ liefert eigenes Bearbeitungsschema, Validierung, freigegebene Darstellungsvarianten, Blade-Ansicht und sichere Auflösung von Verweisen. Eine neue Widget-Art ist Entwicklungsarbeit; Redaktion konfiguriert Instanzen und wählt bestehende Varianten.
**Alternativen.** Jede Widget-Art direkt in den zentralen Editor verdrahten; frei installierbare Laufzeit-Plugins; frei eingebbares HTML/JavaScript.
**Folgen und offene Prüfung.** Alte CMS-Revisionen bleiben lesbar (Schema-Aufwärtsfunktion), Vorschaubild und öffentliche Darstellung verwenden dieselbe Rendererlogik; Editor-UX ist praktisch nachzuweisen. Keine beliebige Ausführung von Code durch Redakteure.
**Quelle.** Website-CMS-Zielarchitektur §§5.3–5.4 und ADR-30-Tabelle; Website-Zielkonzept §10.3–10.5. Die weitere UX-Präferenz aus der laufenden Fachabstimmung ist **keine** Freigabe eines beliebigen Plugin-Systems.
## ADR-31 – Öffentliche Adressen, Weiterleitungen und Indexierung
**Status am 17.11.2026:** Architekturentwurf, Umsetzung nicht abgenommen.
**Kontext.** Die vorhandene öffentliche Seitenauflösung kann laut Sichtung nur ein Pfadsegment auflösen; fachliche Objektseiten benötigen konsistente Adressen.
**Vorschlag.** Anwendungsgesteuerte Adressauflösung mit reservierten Präfixen, Weiterleitungen und `robots`-/Indexierungsregeln je Seitentyp und Umgebung.
**Alternativen.** Manuelle Proxy-Regeln; feste Seitenadressen ohne Weiterleitungsverwaltung.
**Folgen und offene Prüfung.** Keine versehentliche Indexierung geschützter/Testseiten; SEO-Regeln und Pfadänderungen sind zu testen.
**Quelle.** Website-CMS-Zielarchitektur §7, ADR-31-Tabelle.
## ADR-32 – Sitzungsfreie öffentliche Seitenauslieferung
**Status am 17.11.2026:** Architekturentwurf; Sitzungsfreiheit und Cache-Entwertung nicht nachgewiesen.
**Kontext.** Öffentliche Seiten sollen unabhängig vom jeweiligen Mitgliedszustand auslieferbar sein; geschützte Bibliotheksausgaben nicht.
**Vorschlag.** Öffentliche Seiten serverseitig ohne Sitzung und für Gäste/Mitglieder identisch rendern, zwischenspeichern und bei relevanten redaktionellen oder Katalogereignissen gezielt entwerten. Anfragen/Formulare laufen getrennt.
**Alternativen.** Personalisierte öffentliche Seiten; Proxy-Cache als einzige Ebene.
**Folgen und offene Prüfung.** Die Freigabeänderung muss die öffentliche Sicht sofort wirksam machen; keine Mitglieder- oder Lizenzdaten in öffentlichen Caches.
**Quelle.** Website-CMS-Zielarchitektur §§5.5–5.6 und ADR-32-Tabelle.
## ADR-33 – Marketingsteuerung als Modul des Kerns
**Status am 17.11.2026:** Zukunftskonzept, kein MVP-Implementierungsauftrag.
**Kontext.** Marketingauswertung benötigt konsistente Fachbezüge, sollte aber keine zusätzliche personenbezogene Schattenverwaltung erzeugen.
**Vorschlag.** Marketing-Cockpit mit aggregierten Such- und Seitenwerten, Befunden, Maßnahmen und Wirkungsnotizen im Kern.
**Alternativen.** n8n als führende Steuerung; separates Marketing-System.
**Folgen und offene Prüfung.** Messbedarf und Datenschutz vor Implementierung entscheiden; es werden keine abgeschlossenen Marketingfunktionen behauptet.
**Quelle.** Website-Zielkonzept §12; Website-CMS-Zielarchitektur §§8–9, ADR-33-Tabelle; Abschlussbericht, Zurückgestellt.
## ADR-34 – Kontrollierter KI-Einsatz in der Redaktion
**Status am 17.11.2026:** Zukunftskonzept, kein MVP-Implementierungsauftrag.
**Kontext.** KI-generierte Texte und Recherchen dürfen keine ungeprüften fachlichen oder rechtlichen Aussagen veröffentlichen.
**Vorschlag.** Abgegrenzte, protokollierte KI-Arbeitsschritte mit Modelladapter; die Ausgabe bleibt Vorschlag oder redaktioneller Entwurf bis zur menschlichen Prüfung.
**Alternativen.** Selbstständig publizierender Agentenverbund; unprotokollierte KI-Texterzeugung.
**Folgen und offene Prüfung.** Anbieter, zulässige Aussagen, Quellenprozess, Datenschutz und redaktionelle Freigabe gesondert festlegen.
**Quelle.** Website-Zielkonzept §12; Website-CMS-Zielarchitektur §9, ADR-34-Tabelle.
## ADR-35 – Messung der Website-Nutzung
**Status am 17.11.2026:** Messkonzept vorgeschlagen; rechtliche Bewertung und Realisierung offen.
**Kontext.** Der Plattformbetreiber benötigt belastbare Hinweise auf Nutzung und Nachfrage, ohne unnötig personenbezogene Daten zu sammeln.
**Vorschlag.** Aggregierte, möglichst cookielose eigene Ereigniszählung; für Suchdaten externe Schnittstellen, soweit tatsächlich verfügbar.
**Alternativen.** Selbst betriebenes Analysewerkzeug; Drittanbieter.
**Folgen und offene Prüfung.** Keine pauschale Rechtsbehauptung „ohne Cookies = immer einwilligungsfrei“. Datenschutz und technische Parameter vor Aktivierung prüfen.
**Quelle.** Website-Zielkonzept §§11–12; Website-CMS-Zielarchitektur §8, ADR-35-Tabelle.
## ADR-36 – Gemeinsames Designsystem
**Status am 17.11.2026:** Gestaltungsgrundsätze verbindlich; konkrete Tokens und Schriften nur nach Markenfreigabe.
**Kontext.** Website, Mitgliederbibliothek und Inhaltsverwaltung sollen keine widersprüchlichen Marken- und Inhaltsdarstellungen entwickeln.
**Vorschlag.** Gemeinsame zweistufige Design-Tokens (Markenwerte und semantische Werte) im Repository; dieselbe zugelassene Farb-/Typografiebasis und abgestimmte Karten-/Dialogmuster für öffentliche und geschützte Ansichten. Markenwerte werden erst nach Prüfung der Originalassets freigegeben.
**Alternativen.** Je Bereich eigene Styles; frei pflegbare Werte im CMS bereits im MVP.
**Folgen und offene Prüfung.** Änderungen an Markenwerten brauchen bewusstes Review, Kontrastprüfung und Sichtprüfung in 390/768/1440 px. Die konkrete Verwaltungs-UX darf funktional anders ausfallen als die Marketingseite, aber Fachbegriffe und Präsentationsdaten bleiben konsistent.
**Quelle.** Designprinzipien §§5–13; Website-Zielkonzept §7; Website-CMS-Zielarchitektur §5.5, ADR-36-Tabelle.
## ADR-37 – Optionale externe Workflow-Anbindung
**Status am 17.11.2026:** Option für spätere externe Kanäle, keine beschlossene Umsetzung.
**Kontext.** Externe Kanäle können Integrationen benötigen, dürfen aber weder Fach- noch Katalogregeln übergehen.
**Vorschlag.** n8n allenfalls für Anbindungen fremder Kanäle über eine eng begrenzte, geprüfte Schnittstelle, ohne direkten Datenbankzugang und ohne führende Produktlogik.
**Alternativen.** Keine externe Workflow-Engine; n8n als allgemeine Produktsteuerung.
**Folgen und offene Prüfung.** Umsetzung erst bei konkret nachgewiesenem Kanalbedarf.
**Quelle.** Website-Zielkonzept §12; Website-CMS-Zielarchitektur §9, ADR-37-Tabelle.
## ADR-38 – Gemeinsamer Layoutvertrag für Widget-Arten
**Status am 18.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/adaptive-widgets`); **UX-Abnahme durch den Betreiber offen**. Ergänzt ADR-30, ersetzt es nicht.
**Kontext.** Das Abschnittsraster (vier logische Einheiten, ein Widget je Platz) verteilte Widgets bisher nur mit einer Mindestbreite. Das Brand-UI-Kit v1.6 (`12_premium_widgets_adaptiv_v1.6`) verlangt für die Premium-Widgets bestimmte Rasterbreiten (Einstieg 3–4, Bild und Text 1–4), Höhenvarianten und eine Darstellung nach realer Containerbreite.
**Entscheidung.** Jede Widget-Art erklärt in der bestehenden Registry (`WidgetType`) einen gemeinsamen Layoutvertrag:
- `supportedUnits()`: zulässige Platzbreiten aus 1–4; ein Platz mit anderer Breite wird beim Speichern mit verständlicher Meldung abgewiesen; `minUnits()` ist daraus abgeleitet.
- `heights()`: angebotene Höhen aus einem gemeinsamen Vokabular (`auto`, `compact`, `normal`, `large`, `spacious`, `fill`), gespeichert als `settings.height`, geprüft wie jede Einstellung; Höhen sind Mindestwerte oder Proportionen, nie Begrenzungen.
- `stages()` und `narrowBehavior()`: Darstellungsmodi und Verhalten bei reduziertem Platz, im Editor angezeigt.
Die Widget-Ansichten entscheiden über Container-Abfragen nach der tatsächlichen Breite, nicht nach der Einheitenzahl. Keine zweite Registry, kein zweites Abschnittsmodell, keine freien CSS-Werte.
**Alternativen.** Je Widget eigene Breitenlogik im Editor; feste Pixelhöhen; Höhe als Abschnittseinstellung (verworfen: doppelte, widersprüchliche Einstellmöglichkeit neben Abstand und Raster).
**Folgen und offene Prüfung.** Premium-Einstieg (`hero` Version 2) und Bild und Text (`image_text` Version 3) heben ältere Instanzen beim Lesen an; gespeicherte Revisionen bleiben unverändert. Ein Einstieg in einem Platz mit 2 Einheiten ist nicht mehr zulässig (vorher Mindestbreite 2; auf der Testinstanz kein Bestand betroffen). Bewusste Abweichungen vom Kit: Bildfokus als `data.focus_x/focus_y` (Einstellungen tragen nur Aufzählungswerte), Überschriftenebene „Automatisch/H2/H3“ statt freier H1 (genau eine H1 je Seite), Linkziele über die bestehende `SafeUrl`-Regel. Praktische Redaktionsabnahme (Bedienung, Bildzuschnitte mit freigegebenen Motiven) steht aus.
**Quelle.** Brand-UI-Kit v1.6 (`docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`, `docs/layout-profiles.json`); `docs/architektur/cms-widget-registry.md` §§2, 4, 12; ADR-30, ADR-36.
## ADR-39 – Premium-Karten mit Fachbezug
**Status am 18.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/premium-karten`). **Gestalterische Freigabe des Kits v1.7 offen** (`13_premium_karten_v1.7_entwurf/docs/FREIGABE.md`: alle drei Varianten „zur visuellen Freigabe“). Ergänzt ADR-30 und ADR-38.
**Kontext.** Das Brand-UI-Kit v1.7 liefert drei Kartenvarianten (redaktionelle Themenkarte, Medien- und Materialkarte, Modul- und Programmkarte) als reine Darstellungskomponente mit eigenem Beispielraster. Im CMS sollen Redakteure diese Karten in regulären Abschnitten einsetzen, mit bestehenden Fachobjekten verbinden und gestalten, ohne Titel, Medienangaben, Programme oder Module zu kopieren und ohne geschützte Inhalte freizugeben.
**Entscheidung.**
- Drei Widget-Arten in der bestehenden Registry (`topic_card`, `media_card`, `program_card`) auf einer gemeinsamen Basis (`PremiumCardWidget`) mit einer Ansicht (`widgets/premium_card.blade.php`). Eine Karte je Widget, ein Widget je Platz; Spalten und Abstände bestimmt das Abschnittsraster. Das Beispielraster des Kits wird nicht übernommen.
- `refs` speichert genau eine Kennung (Thema `pillar`, Inhaltselement `element`, Komposition `composition`) und optional ein Bild aus dem öffentlichen Website-Bereich. Titel, Kurzbeschreibung, Art, Zusatzangaben und Linkziel werden bei jeder Darstellung aus den Fachdaten gelesen. Redaktionell sind nur Bild, Alternativtext, Bildausschnitt, Beschriftung der Aktion und ein kurzer Hinweis.
- Linkziel nur aus dem Fachobjekt: Themenseite eines veröffentlichten Themas, Programmseite eines öffentlichen Programms. Kein freies Linkziel, kein Download, kein Abspielen, kein Preis, keine Kaufaktion.
- Sichtbarkeit (Übergangsregel bis ADR-29): Themen nur veröffentlicht; Programme nach `PublicCatalogReader`; Module nur in der Redaktionsvorschau; Medien und Materialien öffentlich nur, wenn sie zur gezeigten Fassung eines öffentlichen Programms gehören (dort sind sie heute schon öffentlich genannt), sonst nur in der Redaktionsvorschau (`PublicMaterialReader`). Von Medien wird keine Kurzbeschreibung gezeigt.
- 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.
**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.
## ADR-40 – Zentrale Medienverwaltung im CMS
**Status am 19.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/cms-medienverwaltung`); Abnahme durch den Betreiber offen. Baut auf der Website-Freigabe des Medienmanagers auf (`medienzugriff-fuer-komponenten.md`).
**Kontext.** Das CMS hatte eine eigene Bildablage (`cms/`, `PublishPublicMedia`). Redakteure sollen Bilder im Medienmanager, im Modul-/Programmeditor und in CMS-Widgets aus demselben Bestand verwenden; öffentlich darf nur erscheinen, was für die Website freigegeben ist.
**Entscheidung.** Alle Bildstellen (Einstieg, Bild und Text, redaktionelle Karten, Premium-Karten, Abschnittshintergrund) speichern die Kennung des Inhaltselements im bisherigen Bildschlüssel `image` und lesen über `WebsiteMedia`. Uploads im Widget-Dialog laufen über `WebsiteIntake`. Frühere CMS-Bilder werden per Warteschlangen-Job übernommen (dedupliziert, nichts gelöscht) und über `website_media_aliases` zugeordnet; die Zuordnung wird erst nach der ersten Website-Freigabe wirksam. Ein nicht freigegebenes Bild entfällt öffentlich, das Widget bleibt.
**Alternativen.** Schlüssel `refs.element` wie im Dokument (verworfen: kollidiert mit dem Fachobjekt der Medienkarte); Revisionen per Migration umschreiben (verworfen: Revisionen bleiben unverändert, Rollback); ganzes Widget bei fehlender Freigabe ausblenden (verworfen bis zur Entscheidung: entfernt Überschriften und H1).
**Folgen und offene Prüfung.** Rollback zeigt nach der Umstellung gespeicherte Bilder nicht (Registry §9). Website-Bilder werden bis 2400 px abgeleitet. Offen: Entscheidung „Bild entfällt“ vs. „Widget entfällt“; übernommene Medien tragen Dateinamen als Titel und keine Quellenzeile; ein unter `cms/` liegendes Originalmotiv (`lara-felix-park-original`) wurde mit übernommen und ist damit ein freigegebenes Medium – prüfen und gegebenenfalls zurücknehmen.
**Quelle.** `docs/architektur/medienzugriff-fuer-komponenten.md`; `cms-widget-registry.md` §§7, 9; ADR-30, ADR-38, ADR-39.
Loaded 100 of 172 files, more files were not shown because too many files have changed in this diff. Show more