Author SHA1 Message Date
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
95 changed files with 9442 additions and 630 deletions

No files matched your search

+3 -3
View File
@@ -264,11 +264,11 @@ private function normalizeSection(array $section, int $index, array &$errors, ar
} }
$type = $this->widgets->get($widget['type']); $type = $this->widgets->get($widget['type']);
if ($slotUnits < $type->minUnits()) { if (! $type->supportsUnits($slotUnits)) {
$errors["$prefix.slots.$position.units"] = [sprintf( $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->label(),
$type->minUnits(), $type->unitsLabel(),
$slotUnits, $slotUnits,
)]; )];
} }
+2 -2
View File
@@ -19,10 +19,10 @@ final class SectionStyle
/** @var array<string, string> */ /** @var array<string, string> */
public const WIDTHS = [ public const WIDTHS = [
'narrow' => 'Schmal (Lesebreite)', 'narrow' => 'Lesebereich',
'standard' => 'Standard', 'standard' => 'Standard',
'wide' => 'Breit', 'wide' => 'Breit',
'full' => 'Volle Breite', 'full' => 'Vollbreite',
]; ];
/** @var array<string, string> */ /** @var array<string, string> */
@@ -16,18 +16,21 @@
final class ImageRefFields final class ImageRefFields
{ {
/** /**
* @param bool $live Änderungen sofort an die Vorschau im Bearbeitungsdialog geben.
* @return list<Field> * @return list<Field>
*/ */
public static function fields(string $label = 'Bild'): array public static function fields(string $label = 'Bild', bool $live = false): array
{ {
return [ return [
Select::make('image') Select::make('image')
->live($live)
->label($label.': vorhandenes Bild') ->label($label.': vorhandenes Bild')
->options(fn (): array => PublicMedia::imageOptions()) ->options(fn (): array => PublicMedia::imageOptions())
->searchable() ->searchable()
->placeholder('Kein Bild') ->placeholder('Kein Bild')
->helperText('Auswahl aus den Bildern, die bereits für die Website hochgeladen wurden.'), ->helperText('Auswahl aus den Bildern, die bereits für die Website hochgeladen wurden.'),
FileUpload::make('_upload') FileUpload::make('_upload')
->live($live)
->label($label.': neu hochladen') ->label($label.': neu hochladen')
->disk('cms_incoming') ->disk('cms_incoming')
->directory('cms') ->directory('cms')
@@ -0,0 +1,200 @@
<?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 des Bildes')
->maxLength(300)
->live(onBlur: true)
->helperText('Beschreibt, was auf dem Bild zu sehen ist. Pflicht, sobald ein Bild gewählt ist.');
}
/**
* 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;
}
if ($hasImage && $data['alt'] === null) {
$errors->add('data.alt', 'Bitte einen Alternativtext für das Bild angeben.');
}
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',
};
}
}
@@ -25,9 +25,22 @@ public function description(): string
return 'Hervorgehobene Fläche mit Überschrift, Text und einer Schaltfläche.'; 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 public function preferredUnits(): int
+10 -4
View File
@@ -32,12 +32,17 @@ public function label(): string
public function description(): 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 public function preferredUnits(): int
@@ -49,7 +54,7 @@ public function stages(): array
{ {
return [ return [
'narrow' => 'eine Karte je Zeile', '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 +73,7 @@ public function variants(): array
return [ return [
'standard' => 'Raster', 'standard' => 'Raster',
'compact' => 'Kompakte Liste', 'compact' => 'Kompakte Liste',
'featured' => 'Erste Karte hervorgehoben',
]; ];
} }
@@ -37,9 +37,14 @@ public function description(): string
return 'Ausgewählte Programme und Module; Titel und Beschreibung kommen automatisch aus den Fachdaten.'; 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 public function preferredUnits(): int
+7 -2
View File
@@ -24,9 +24,14 @@ public function description(): string
return 'Häufige Fragen mit Antworten.'; 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 public function preferredUnits(): int
@@ -23,9 +23,14 @@ public function description(): string
return 'Abschnittsüberschrift mit kurzem Einleitungstext.'; 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 public function preferredUnits(): int
+111 -48
View File
@@ -4,15 +4,22 @@
use App\Domain\Cms\Widgets\RenderContext; use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\ImageRefFields; 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\PublicMedia;
use App\Domain\Cms\Widgets\Support\SafeUrl;
use App\Domain\Cms\Widgets\WidgetErrors; use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType; use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\Textarea; use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput; use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Grid;
use Filament\Schemas\Components\Group; 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 class HeroWidget extends WidgetType
{ {
public function key(): string public function key(): string
@@ -27,27 +34,46 @@ public function label(): string
public function description(): 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; return 2;
} }
public function preferredUnits(): int public function supportedUnits(): array
{ {
return 4; return [3, 4];
} }
public function stages(): array public function stages(): array
{ {
return [ return [
'narrow' => 'unter 48rem Slotbreite: Bild unter dem Text', 'wide' => 'ab 860 px Containerbreite: Foto über die ganze Fläche, Text links auf heller Fläche; Mindesthöhe nach Höheneinstellung',
'wide' => 'ab 48rem: Bild neben dem Text, größere Überschrift', '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 public function icon(): string
{ {
return 'heroicon-o-sparkles'; return 'heroicon-o-sparkles';
@@ -55,26 +81,72 @@ public function icon(): string
public function schematic(): array 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 public function variants(): array
{ {
return [ return [
'standard' => 'Standard (Bild neben dem Text)', 'photo_split' => 'Foto mit Textfläche',
'highlight' => 'Hervorgehoben (Markenflä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 public function dataRules(): array
{ {
return [ return [
'heading' => ['required', 'string', 'max:200'], 'heading' => ['required', 'string', 'max:200'],
'text' => ['nullable', 'string', 'max:600'], 'text' => ['nullable', 'string', 'max:600'],
'cta_label' => ['nullable', 'string', 'max:80', 'required_with:data.cta_url'], ] + PremiumFields::rules();
'cta_url' => ['nullable', 'string', 'max:500', 'required_with:data.cta_label'],
'alt' => ['nullable', 'string', 'max:300'],
];
} }
public function refRules(): array public function refRules(): array
@@ -85,66 +157,57 @@ public function refRules(): array
public function dataFields(): array public function dataFields(): array
{ {
return [ return [
TextInput::make('heading')->label('Überschrift')->required()->maxLength(200), PremiumFields::eyebrowField(),
Textarea::make('text')->label('Beschreibung')->rows(3)->maxLength(600), TextInput::make('heading')->label('Überschrift')->required()->maxLength(200)->live(onBlur: true),
Grid::make(2)->schema([ Textarea::make('text')->label('Beschreibung')->rows(3)->maxLength(600)->live(onBlur: true),
TextInput::make('cta_label')->label('Schaltfläche: Beschriftung (optional)')->maxLength(80), PremiumFields::ctaFields(),
TextInput::make('cta_url') PremiumFields::altField(),
->label('Schaltfläche: Linkziel') ...PremiumFields::focusFields(68, 50),
->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.'),
]; ];
} }
public function refFields(): array public function refFields(): array
{ {
return ImageRefFields::fields(); return ImageRefFields::fields(live: true);
} }
public function editorSchema(): array 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 [ return [
Group::make([$heading, $text, $cta])->statePath('data'),
Group::make($this->refFields())->statePath('refs'), 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 public function clean(array $data, array $refs, WidgetErrors $errors): array
{ {
$refs = ImageRefFields::clean($refs, $errors); $refs = ImageRefFields::clean($refs, $errors);
$data['heading'] = trim((string) ($data['heading'] ?? ''));
foreach (['text', 'cta_label', 'cta_url', 'alt'] as $key) { $data['text'] = filled($data['text'] ?? null) ? trim((string) $data['text']) : null;
$data[$key] = filled($data[$key] ?? null) ? trim($data[$key]) : null; $data = PremiumFields::clean($data, $errors, $refs['image'] !== 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.');
}
return [$data, $refs]; return [$data, $refs];
} }
public function resolve(array $widget, RenderContext $context): array public function resolve(array $widget, RenderContext $context): array
{ {
$data = $widget['data']; $actions = PremiumFields::actions($widget['data']);
$hasAction = filled($data['cta_label'] ?? null) && SafeUrl::isSafe($data['cta_url'] ?? null);
return [ return [
'imageUrl' => PublicMedia::imageUrl($widget['refs']), 'imageUrl' => PublicMedia::imageUrl($widget['refs']),
'action' => $hasAction ? ['label' => $data['cta_label'], 'url' => $data['cta_url']] : 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',
]; ];
} }
+109 -38
View File
@@ -4,6 +4,7 @@
use App\Domain\Cms\Widgets\RenderContext; use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\ImageRefFields; 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\PublicMedia;
use App\Domain\Cms\Widgets\Support\RichText; use App\Domain\Cms\Widgets\Support\RichText;
use App\Domain\Cms\Widgets\WidgetErrors; use App\Domain\Cms\Widgets\WidgetErrors;
@@ -13,10 +14,13 @@
use Filament\Schemas\Components\Group; 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 1 (Bestand): data {image, alt, body} mit Klartext.
* Version 2: data {title, body (formatierter Text), alt}, refs {image}, Varianten Bild links/rechts. * 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 class ImageTextWidget extends WidgetType
{ {
@@ -32,12 +36,17 @@ public function label(): string
public function description(): 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 public function preferredUnits(): int
@@ -48,14 +57,29 @@ public function preferredUnits(): int
public function stages(): array public function stages(): array
{ {
return [ return [
'narrow' => 'unter 36rem Slotbreite: Bild über dem Text', 'stacked' => 'unter 540 px Containerbreite: Bild über dem Text, Schaltflächen untereinander in voller Breite',
'wide' => 'ab 36rem: Bild links oder rechts neben dem Text', '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 public function icon(): string
@@ -65,7 +89,7 @@ public function icon(): string
public function schematic(): array 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 public function variants(): array
@@ -76,24 +100,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 public function upgrade(array $widget, int $from): array
{ {
if ($from !== 1) { if ($from === 1) {
return parent::upgrade($widget, $from); $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'] = [ if (! isset($data['focus_x'], $data['focus_y'])) {
'title' => null, $data = PremiumFields::focusFromEnum($settings['focus'] ?? null) + $data;
'body' => RichText::fromPlainText(is_string($data['body'] ?? null) ? $data['body'] : ''), }
'alt' => $data['alt'] ?? null,
];
$widget['refs'] = [
'image' => PublicMedia::fromUploadState($data['image'] ?? null),
];
return $widget; unset($settings['focus'], $settings['format']);
$widget['settings'] = $settings;
$widget['data'] = $data;
return $widget;
}
return parent::upgrade($widget, $from);
} }
public function dataRules(): array public function dataRules(): array
@@ -101,8 +165,7 @@ public function dataRules(): array
return [ return [
'title' => ['nullable', 'string', 'max:160'], 'title' => ['nullable', 'string', 'max:160'],
'body' => ['required', 'string', 'max:40000'], 'body' => ['required', 'string', 'max:40000'],
'alt' => ['nullable', 'string', 'max:300'], ] + PremiumFields::rules();
];
} }
public function refRules(): array public function refRules(): array
@@ -113,31 +176,38 @@ public function refRules(): array
public function dataFields(): array public function dataFields(): array
{ {
return [ return [
TextInput::make('title')->label('Titel (optional)')->maxLength(160), PremiumFields::eyebrowField(),
TextInput::make('title')->label('Überschrift')->maxLength(160)->live(onBlur: true),
RichEditor::make('body') RichEditor::make('body')
->label('Text') ->label('Text')
->required() ->required()
->live(onBlur: true)
->toolbarButtons(RichText::TOOLBAR), ->toolbarButtons(RichText::TOOLBAR),
TextInput::make('alt') PremiumFields::ctaFields(),
->label('Alternativtext des Bildes') PremiumFields::altField(),
->maxLength(300) ...PremiumFields::focusFields(64, 43),
->helperText('Beschreibt, was auf dem Bild zu sehen ist. Pflicht, sobald ein Bild gewählt ist.'),
]; ];
} }
public function refFields(): array public function refFields(): array
{ {
return ImageRefFields::fields(); return ImageRefFields::fields(live: true);
} }
public function editorSchema(): array 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 [ return [
Group::make([$title, $body])->statePath('data'),
Group::make($this->refFields())->statePath('refs'), Group::make($this->refFields())->statePath('refs'),
Group::make([$alt])->statePath('data'), Group::make([$alt, $focusX, $focusY])->statePath('data'),
]; ];
} }
@@ -145,25 +215,26 @@ public function clean(array $data, array $refs, WidgetErrors $errors): array
{ {
$refs = ImageRefFields::clean($refs, $errors); $refs = ImageRefFields::clean($refs, $errors);
$data['body'] = RichText::sanitize($data['body'] ?? ''); $data['body'] = RichText::sanitize($data['body'] ?? '');
$data['title'] = filled($data['title'] ?? null) ? trim($data['title']) : null; $data['title'] = filled($data['title'] ?? null) ? trim((string) $data['title']) : null;
$data['alt'] = filled($data['alt'] ?? null) ? trim($data['alt']) : null; $data = PremiumFields::clean($data, $errors, $refs['image'] !== null);
if (RichText::isBlank($data['body'])) { if (RichText::isBlank($data['body'])) {
$errors->add('data.body', 'Bitte einen Text eingeben.'); $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]; return [$data, $refs];
} }
public function resolve(array $widget, RenderContext $context): array public function resolve(array $widget, RenderContext $context): array
{ {
$surface = $widget['settings']['surface'] ?? 'cream';
return [ return [
'imageUrl' => PublicMedia::imageUrl($widget['refs']), 'imageUrl' => PublicMedia::imageUrl($widget['refs']),
'body' => RichText::sanitize(is_string($widget['data']['body'] ?? null) ? $widget['data']['body'] : ''), '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',
]; ];
} }
+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.'; 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 public function preferredUnits(): int
+13 -3
View File
@@ -45,8 +45,18 @@ public function register(WidgetType $type): void
throw new InvalidArgumentException("Widget „{$key}“ braucht eine Schemaversion ab 1."); throw new InvalidArgumentException("Widget „{$key}“ braucht eine Schemaversion ab 1.");
} }
if ($type->minUnits() < 1 || $type->minUnits() > 4 || $type->preferredUnits() < $type->minUnits() || $type->preferredUnits() > 4) { // Gemeinsamer Layoutvertrag (ADR-38): Breiten, Vorzugsbreite und Höhen aus festen Wertebereichen.
throw new InvalidArgumentException("Widget „{$key}“ braucht eine Mindest- und Vorzugsbreite zwischen 1 und 4 Rastereinheiten."); $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() === []) { if ($type->variants() === []) {
@@ -266,7 +276,7 @@ private function validateOne(WidgetType $type, array $widget, string $errorPrefi
} }
$settings = []; $settings = [];
$allowedSettings = $type->settings(); $allowedSettings = $type->settingOptions();
foreach ($widget['settings'] as $key => $value) { foreach ($widget['settings'] as $key => $value) {
if ($value === null || $value === '') { if ($value === null || $value === '') {
continue; continue;
+6 -1
View File
@@ -61,6 +61,7 @@ public function renderWidget(array $widget, RenderContext $context, bool $first
'refs' => $widget['refs'], 'refs' => $widget['refs'],
'variant' => $widget['variant'], 'variant' => $widget['variant'],
'settings' => $widget['settings'], 'settings' => $widget['settings'],
'height' => $type->height($widget),
'first' => $first, 'first' => $first,
'context' => $context, 'context' => $context,
] + $type->resolve($widget, $context))->render()); ] + $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']).'"' : ''; $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 .$inner
.'</section>'; .'</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. * Gemeinsames Höhenvokabular aller Widget-Arten (ADR-38). Eine Art bietet davon nur die sinnvollen Werte an
* Ein schmalerer Slot wird beim Speichern abgewiesen. Auf Tablet und Smartphone stapeln die Slots ohnehin. * (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 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. */ /** 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']; 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. */ /** Heroicon-Name für Auswahl und Liste im Editor. */
public function icon(): string public function icon(): string
{ {
@@ -102,6 +183,44 @@ public function settings(): array
return []; 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'). * 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> * @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 public function editorSchema(): array
{ {
$schema = []; $schema = [];
+2 -2
View File
@@ -524,8 +524,8 @@ private static function slotLabel(array $state, ?int $index, mixed $layout): str
$type = $items !== [] ? (array_values($items)[0]['type'] ?? null) : null; $type = $items !== [] ? (array_values($items)[0]['type'] ?? null) : null;
$registry = app(WidgetRegistry::class); $registry = app(WidgetRegistry::class);
if ($registry->has($type) && $registry->get($type)->minUnits() > $slotUnits) { if ($registry->has($type) && ! $registry->get($type)->supportsUnits($slotUnits)) {
$label .= ' · zu schmal: „'.$registry->get($type)->label().'“ braucht '.$registry->get($type)->minUnits(); $label .= ' · passt nicht: „'.$registry->get($type)->label().'“ ist für '.$registry->get($type)->unitsLabel().' Einheiten vorgesehen';
} }
return $label; return $label;
+110 -20
View File
@@ -13,7 +13,13 @@
use Filament\Forms\Components\Select; use Filament\Forms\Components\Select;
use Filament\Forms\Components\ToggleButtons; use Filament\Forms\Components\ToggleButtons;
use Filament\Notifications\Notification; 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\Foundation\Vite;
use Illuminate\Support\HtmlString; use Illuminate\Support\HtmlString;
use Illuminate\Support\Str; use Illuminate\Support\Str;
@@ -83,29 +89,69 @@ public static function slotBuilder(string $name = 'widget'): Builder
public static function block(WidgetType $type): Block public static function block(WidgetType $type): Block
{ {
$variants = $type->variants(); $icons = $type->optionIcons();
$display = [];
$schema = [Hidden::make('id')]; if (count($type->variants()) > 1) {
$display[] = ToggleButtons::make('variant')
$schema[] = count($variants) > 1
? ToggleButtons::make('variant')
->label('Darstellung') ->label('Darstellung')
->options($variants) ->options($type->variants())
->icons($icons['variant'] ?? [])
->default($type->defaultVariant()) ->default($type->defaultVariant())
->inline() ->inline()
->required() ->required()
: Hidden::make('variant')->default($type->defaultVariant()); ->live();
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');
} }
foreach ($type->editorSchema() as $component) { $settings = [];
$schema[] = $component; $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()) return WidgetBlock::make($type->key())
@@ -233,6 +279,50 @@ public static function notifyErrors(array $errors, array $blocks): void
->send(); ->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. * 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 private static function unitsHint(WidgetType $type): string
{ {
return $type->minUnits() === 1 return $type->supportedUnits() === [1, 2, 3, 4]
? 'Passt in jeden Platz' ? 'Passt in jeden Platz (1 bis 4 Einheiten)'
: 'Braucht einen Platz ab '.$type->minUnits().' Rastereinheiten'; : 'Für Plätze mit '.$type->unitsLabel().' Rastereinheiten';
} }
/** /**
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,173 @@
# 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.
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

@@ -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,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`).
+277 -40
View File
@@ -1,45 +1,73 @@
# 12 – Entscheidungsprotokoll (ADR) # 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 | 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.
| ADR-01 | Gesamtarchitektur | Integrierter modularer Kern mit Community als Satellit, mit getrennten Rechten im Innern | 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.
| ADR-02 | Stapel des Kerns | **Beschlossen (15.11.2026):** Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert | 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.
| ADR-03 | Vier Ebenen des Produktmodells | Inhalt, Lizenzartikel, Angebot, Berechtigung mit je eigener Identität | 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.
| ADR-04 | Artikelgrenze | ausdrückliche Deklaration, keine Ableitung aus dem Inhaltsgraphen |
| ADR-05 | Berechtigung als unteilbares Bündel | Entscheidung je einzelner Berechtigung, nie Vereinigung | **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).
| 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 | ## Übersicht der Architekturentscheidungen
| 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 | 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-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 | Thema | Prüfstand (17.11.2026) | Kernaussage |
| ADR-12 | Community | ausgereiftes Fremdprodukt; Kern ist Identitätsgeber und führt Gruppen | |---|---|---|---|
| ADR-13 | Trainerverzeichnis | im Kern, nicht in der Forensoftware | | ADR-01 | Gesamtarchitektur | Grundrichtung fachlich gedeckt; Community-Teil offen | Modularer Kern belegt; Community-Integration weiter geplant |
| ADR-14 | Zahlung | Adapter; Freischaltung nur auf geprüftes Ereignis oder aktive Abfrage; aktiver Abgleich | | ADR-02 | Technologiestapel | Ist-Entscheidung durch Umsetzung; Produktivabnahme offen | Laravel 13/Filament 5 realisiert; frühere offene Technologieauswahl historisch |
| ADR-15 | Streamingschutz | signierte Sitzungsadressen, kein DRM | | ADR-03 | Produktmodell | Fachlich verbindlich; Grundstruktur implementiert | Inhalt, Komposition, Lizenzartikel, Angebot, Berechtigung strikt getrennt |
| ADR-16 | Medienauslieferung | austauschbarer Adapter; lokal beginnen, Auslieferungsnetz nach Schwellen | | ADR-04 | Artikelgrenze | Fachlich verbindlich; Abdeckungsprüfung implementiert | Lizenzartikelgrenze vom Betreiber; Abdeckung kontrolliert |
| ADR-17 | Kennzeichnung | Stufenmodell; unsichtbares Videowasserzeichen erst nach Erprobung | | ADR-05 | Rechteprüfung | Fachlich verbindlich; im Kern umgesetzt, G9 offen | Aktionen aus genau einer tragenden Berechtigung, keine Rechtevereinigung |
| ADR-18 | Ausgabenachweis | vor Erzeugung angelegt, für jede individuelle Ausgabe | | ADR-06 | Kaufsnapshot | Fachlich verbindlich; technische Details nicht vollständig abgenommen | Historischen Kaufumfang und Konditionen fixieren |
| ADR-19 | Hintergrundverarbeitung | datenbankgestützte Warteschlange und Postausgang | | ADR-07 | Versionierung | Fachlich verbindlich; Fassungsmodell implementiert, UX in Arbeit | Freigabefassungen unveränderlich; redaktioneller Entwurfsworkflow weiter verbessern |
| ADR-20 | Betrieb | Container auf einem Server; identische Anwendung in allen Stufen | | ADR-08 | Veröffentlichung | Fachliche Sicherheitsanforderung; technische Atomarität nicht vollständig nachgewiesen | Neue Freigaben beschädigen keine bestehende Veröffentlichung |
| ADR-21 | Rechnung | externer Dienst hinter Adapter | | ADR-09 | Updates | Fachlich beschlossen; Produktregel verbindlich | Aktualisierungen desselben Artikels grundsätzlich enthalten; neue Artikel nicht |
| ADR-22 | Seiten und Katalogdarstellung | Seiten aus Bausteinen; Katalogbausteine zeigen auf Identitäten | | ADR-10 | Upgrade | Fachliche Schutzregel verbindlich; Upgrade-Technik nur vorgeschlagen | Kein Rechteverlust durch Upgrade; Erwerbsmechanismus noch nicht abgenommen |
| ADR-23 | Berechtigungsquelle | Erwerb als individuelle Quelle je Inhaber; das allgemeine Angebot ist keine Quelle | | ADR-11 | Inhaber | Zielbild fachlich fest; institutioneller Betrieb später | Organisationen als Zielbild, Einzelpersonen im ersten Verkaufsschnitt |
| ADR-24 | Medienausgabe | Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands; Freigabe je Datei | | ADR-12 | Community | Architekturvorschlag; Community nicht umgesetzt | Community als späterer Satellit vorgeschlagen; Discourse Kandidat |
| ADR-25 | Schadensbegrenzung | getrennte Rechte je Prozess, getrennte Herkunftsadressen, Verwaltung ohne Alleskönner | | ADR-13 | Trainerverzeichnis | Fachliches Zielbild, technische Zuordnung vorgeschlagen | Trainerverzeichnis mit geschützter Privatsphäre; Realisierung später |
| ADR-26 | Sicherung und Wiederanlauf | fortlaufend außer Haus und nur anfügbar; Sicherheitsjournal; Ziele je Schadensfall | | ADR-14 | Zahlung | Verbindliche Zahlungsprinzipien; Adapter nicht umgesetzt | Externer Zahlungsdienst, konkreter Adapter noch nicht gebaut |
| ADR-27 | Ereignis und Abgleich | Ereignisse für Schnelligkeit, wiederholbarer Soll-Ist-Abgleich für Richtigkeit | | 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-01 – Integrierter modularer Kern mit Community-Satellit ## 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). **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. **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`). **Alternativen.** Kopfloses, komponiertes System; Komposition aus Standardsoftware; vollständiger Eigenbau einschließlich Community (`02`).
@@ -49,15 +77,23 @@ ## ADR-01 – Integrierter modularer Kern mit Community-Satellit
## ADR-02 – Technologiestapel des Kerns (ersetzt) ## 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. **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). **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. **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. **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.
**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). **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 ## 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. **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. **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. **Alternativen.** Ein „Produkt“-Objekt mit Typfeld und Eltern-Kind-Beziehung.
@@ -66,6 +102,10 @@ ## ADR-03 – Vier Ebenen des Produktmodells
## ADR-04 – Artikelgrenze durch ausdrückliche Deklaration ## 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. **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. **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. **Alternativen.** Automatische Ableitung durch Abstieg im Inhaltsgraphen.
@@ -74,6 +114,10 @@ ## ADR-04 – Artikelgrenze durch ausdrückliche Deklaration
## ADR-05 – Berechtigung als unteilbares Bündel ## 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. **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. **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. **Alternativen.** Wirksame Rechte als Vereinigung aller Fähigkeiten mit nachträglichen Ausschlussregeln.
@@ -82,6 +126,10 @@ ## ADR-05 – Berechtigung als unteilbares Bündel
## ADR-06 – Eingefrorener Bestellumfang ## 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. **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. **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. **Alternativen.** Nur Verweis auf die unveränderliche Angebotsfassung.
@@ -90,6 +138,10 @@ ## ADR-06 – Eingefrorener Bestellumfang
## ADR-07 – Versionierung der Lernprodukte ## 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. **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. **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. **Alternativen.** „Aktuelle Fassung“ als gleitender Verweis; gemeinsame Versionsnummer für alle Bestandteile.
@@ -98,6 +150,10 @@ ## ADR-07 – Versionierung der Lernprodukte
## ADR-08 – Veröffentlichung als Vorgang mit atomarer Umschaltung ## 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. **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. **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. **Alternativen.** Schrittweises Aktivieren einzelner Objekte.
@@ -106,6 +162,10 @@ ## ADR-08 – Veröffentlichung als Vorgang mit atomarer Umschaltung
## ADR-09 – Aktualisierungen: alle freigegebenen Fassungen des Artikels (ersetzt) ## 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. **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). **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. **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 +175,10 @@ ## ADR-09 – Aktualisierungen: alle freigegebenen Fassungen des Artikels (erset
## ADR-10 – Upgrade als zusätzlicher Erwerb (ersetzt) ## 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. **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). **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). **Alternativen.** (a) Zusatzrecht, das eine vorhandene Berechtigung ergänzt; (b) Ersetzung der Ausgangsberechtigung mit Zustand „aufgegangen“ (frühere Fassung).
@@ -124,6 +188,10 @@ ## ADR-10 – Upgrade als zusätzlicher Erwerb (ersetzt)
## ADR-11 – Inhaber ist Person oder Organisation ## 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. **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. **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. **Alternativen.** Berechtigung am Konto; Organisationen später nachrüsten.
@@ -133,8 +201,12 @@ ## ADR-11 – Inhaber ist Person oder Organisation
## ADR-12 – Community als Fremdprodukt, Kern führt ## 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. **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. **Alternativen.** Eigenbau; gehostetes Produkt; anderes Forenprodukt.
**Begründung.** Reife Moderations- und Kommunikationsfunktionen; schmale Kopplung; Ausfall ohne Wirkung auf Kernwege. **Begründung.** Reife Moderations- und Kommunikationsfunktionen; schmale Kopplung; Ausfall ohne Wirkung auf Kernwege.
**Folgen.** Zweiter Technologiestapel mit eigenem Aktualisierungsrhythmus; Mailversand zwingend. **Folgen.** Zweiter Technologiestapel mit eigenem Aktualisierungsrhythmus; Mailversand zwingend.
@@ -142,14 +214,22 @@ ## ADR-12 – Community als Fremdprodukt, Kern führt
## ADR-13 – Trainerverzeichnis im Kern ## 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. **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. **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. **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. **Folgen.** Eigenentwicklung überschaubaren Umfangs.
## ADR-14 – Zahlung hinter Adapter mit aktivem Abgleich ## 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). **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. **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. **Alternativen.** Freischaltung beim Rücksprung des Browsers; Vertrauen allein auf Wiederholungen des Dienstes.
@@ -159,6 +239,10 @@ ## ADR-14 – Zahlung hinter Adapter mit aktivem Abgleich
## ADR-15 – Streamingschutz ohne DRM ## 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. **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. **Entscheidung.** Segmentiertes Streaming über kurzlebig signierte, an eine Sitzung gebundene Adressen; optional Abschnittsverschlüsselung.
**Alternativen.** Kommerzielles DRM. **Alternativen.** Kommerzielles DRM.
@@ -167,6 +251,10 @@ ## ADR-15 – Streamingschutz ohne DRM
## ADR-16 – Medienauslieferung als Adapter ## 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. **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. **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. **Alternativen.** Von Beginn an Auslieferungsnetz; dauerhaft lokal; vollständiger Videodienst.
@@ -175,6 +263,10 @@ ## ADR-16 – Medienauslieferung als Adapter
## ADR-17 – Stufenmodell der Kennzeichnung ## 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. **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. **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. **Alternativen.** Sofortige Zusage eines unsichtbaren Videowasserzeichens; Verzicht auf individuelle Kennzeichnung.
@@ -183,6 +275,10 @@ ## ADR-17 – Stufenmodell der Kennzeichnung
## ADR-18 – Ausgabenachweis vor Erzeugung ## 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. **Kontext.** VER-009, INV-10.
**Entscheidung.** Der Nachweis wird beim Anfordern angelegt und begleitet die Datei durch Erzeugung und Auslieferung. **Entscheidung.** Der Nachweis wird beim Anfordern angelegt und begleitet die Datei durch Erzeugung und Auslieferung.
**Alternativen.** Protokollierung nach erfolgreichem Download. **Alternativen.** Protokollierung nach erfolgreichem Download.
@@ -192,6 +288,10 @@ ## ADR-18 – Ausgabenachweis vor Erzeugung
## ADR-19 – Datenbankgestützte Hintergrundverarbeitung ## 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. **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. **Entscheidung.** Aufträge und fachliche Ereignisse liegen in der Kerndatenbank und werden in derselben Transaktion wie die auslösende Änderung geschrieben.
**Alternativen.** Eigener Warteschlangendienst. **Alternativen.** Eigener Warteschlangendienst.
@@ -200,6 +300,10 @@ ## ADR-19 – Datenbankgestützte Hintergrundverarbeitung
## ADR-20 – Containerbetrieb auf einem Server ## 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. **Kontext.** OPS-001 bis OPS-004.
**Entscheidung.** Alle Bausteine als Container mit einer Compose-Beschreibung; gesamter Zustand in Datenbank, Medienspeicher und Community-Sicherung. **Entscheidung.** Alle Bausteine als Container mit einer Compose-Beschreibung; gesamter Zustand in Datenbank, Medienspeicher und Community-Sicherung.
**Alternativen.** Direktinstallation; Orchestrierer. **Alternativen.** Direktinstallation; Orchestrierer.
@@ -209,30 +313,46 @@ ## ADR-20 – Containerbetrieb auf einem Server
## ADR-21 – Rechnung über externen Dienst ## 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. **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. **Alternativen.** Erzeugung im Kern; Rechnungsfunktion des Zahlungsdienstes.
**Begründung.** Formatpflichten, Nummernkreise, Korrekturen und Übergabe an die Steuerberatung sind nicht Kernkompetenz der Plattform. **Begründung.** Formatpflichten, Nummernkreise, Korrekturen und Übergabe an die Steuerberatung sind nicht Kernkompetenz der Plattform.
**Folgen.** Laufende Kosten; Produktwahl mit der Steuerberatung. **Folgen.** Laufende Kosten; Produktwahl mit der Steuerberatung.
## ADR-22 – Seiten aus Bausteinen, Katalogdarstellung über Verweise ## 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. **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. **Alternativen.** Freier Layout-Editor; feste Seitenvorlagen ohne Baukasten.
**Begründung.** Konsistenz zwischen Seite, Angebot und Freischaltung; Zugänglichkeit bleibt prüfbar; Redaktion bleibt beweglich. **Begründung.** Konsistenz zwischen Seite, Angebot und Freischaltung; Zugänglichkeit bleibt prüfbar; Redaktion bleibt beweglich.
**Folgen.** Neue Bausteintypen sind Entwicklungsarbeit. **Folgen.** Neue Bausteintypen sind Entwicklungsarbeit.
## ADR-23 – Erwerb als individuelle Berechtigungsquelle (neu) ## 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. **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. **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. **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. **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) ## 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. **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). **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. **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 +361,10 @@ ## ADR-24 – Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands (ne
## ADR-25 – Schadensbegrenzung innerhalb des Kerns (neu) ## 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. **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. **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. **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 +373,10 @@ ## ADR-25 – Schadensbegrenzung innerhalb des Kerns (neu)
## ADR-26 – Sicherung außer Reichweite, Sicherheitsjournal, Ziele je Schadensfall (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. **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. **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. **Alternativen.** (a) Zweiter, laufend gespiegelter Standort; (b) tägliche Sicherung außer Haus ohne Änderungsprotokoll; (c) sofortiger Umzug auf einen Mietserver.
@@ -257,8 +385,117 @@ ## ADR-26 – Sicherung außer Reichweite, Sicherheitsjournal, Ziele je Schadens
## ADR-27 – Ereignisse für Schnelligkeit, Abgleich für Richtigkeit (neu) ## 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. **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. **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. **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. **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. **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.
+67 -28
View File
@@ -46,7 +46,7 @@ ## 2. Widget-Vertrag
| `type` | Typkennung aus dem Register; ändert sich nie | | `type` | Typkennung aus dem Register; ändert sich nie |
| `v` | Schemaversion der Art | | `v` | Schemaversion der Art |
| `variant` | eine der für die Art registrierten Varianten | | `variant` | eine der für die Art registrierten Varianten |
| `settings` | nur registrierte Aufzählungswerte (derzeit nutzt keine Art Einstellungen; freie Werte werden abgewiesen) | | `settings` | nur registrierte Aufzählungswerte (`WidgetType::settingOptions()`, einschließlich der gemeinsamen Höhe `height`); freie Werte werden abgewiesen. Fehlt ein Wert, gilt die Vorgabe der Darstellung |
| `data` | redaktionelle Inhalte | | `data` | redaktionelle Inhalte |
| `refs` | Verweise auf Fachobjekte oder Medien, nur Kennungen bzw. Pfade im öffentlichen Bereich `cms/` | | `refs` | Verweise auf Fachobjekte oder Medien, nur Kennungen bzw. Pfade im öffentlichen Bereich `cms/` |
@@ -62,26 +62,52 @@ ## 3. Versionierung und Altbestand
- Unbekannte Widget-Arten werden ausgelassen; unbekannte Raster- oder Gestaltungswerte fallen beim Lesen auf Vorgaben zurück. Eine Hülle mit höherer Version als im Code wird bestmöglich dargestellt, aber nicht gespeichert. - Unbekannte Widget-Arten werden ausgelassen; unbekannte Raster- oder Gestaltungswerte fallen beim Lesen auf Vorgaben zurück. Eine Hülle mit höherer Version als im Code wird bestmöglich dargestellt, aber nicht gespeichert.
- Regel: Optionale neue Felder brauchen keine neue Version. Umbenennen, Umdeuten oder Verschieben von Feldern braucht eine neue Version mit `upgrade()` und einen Test. Gleiches gilt für die Abschnittshülle (`PageSections::VERSION`). - Regel: Optionale neue Felder brauchen keine neue Version. Umbenennen, Umdeuten oder Verschieben von Feldern braucht eine neue Version mit `upgrade()` und einen Test. Gleiches gilt für die Abschnittshülle (`PageSections::VERSION`).
Beispiel: `image_text` Version 1 `{image, alt, body (Klartext)}` → Version 2 `data {title, body (bereinigtes HTML), alt}`, `refs {image}`, Variante `image_left`. Beispiele:
- `image_text` Version 1 `{image, alt, body (Klartext)}` → Version 2 `data {title, body (bereinigtes HTML), alt}`, `refs {image}`, Variante `image_left` → Version 3 (Kit v1.6): `settings.format` entfällt, `settings.focus` wird zu `data.focus_x/focus_y` (Prozent).
- `hero` Version 1 → Version 2 (Kit v1.6): Varianten `standard`/`stage` → `photo_split`, `highlight`/`editorial` → `editorial_solid`; `settings.focus` wird zu `data.focus_x/focus_y`, `settings.text_side` entfällt. Die data-Schlüssel (`heading`, `text`, `cta_*`, `alt`) bleiben, damit ein Code-Rollback darstellbar bleibt.
## 4. Registrierte Widget-Arten ## 4. Registrierte Widget-Arten
| Kennung | Name | Version | Varianten | Verweise | Mindestbreite | | Kennung | Name | Version | Varianten | Breiten (Einheiten) | Höhen | Verweise |
|---|---|---|---|---|---| |---|---|---|---|---|---|---|
| `hero` | Einstieg (Hero) | 1 | `standard` (Bild neben dem Text), `highlight` (Markenfläche) | `refs.image` | 2 | | `hero` | Einstieg (Hero), Premium nach Kit v1.6 | 2 | `photo_split` (Foto mit Textfläche), `editorial_solid` (Navy-Markenfläche) | 3, 4 | `compact` (mind. 400 px), `normal` (512 px, Vorgabe), `large` (640 px) | `refs.image` |
| `heading` | Überschrift und Einleitung | 1 | `standard` | – | 1 | | `heading` | Überschrift und Einleitung | 1 | `standard` | 1–4 | – | – |
| `prose` | Fließtext | 1 | `standard` | – | 1 | | `prose` | Fließtext | 1 | `standard` | 1–4 | – | – |
| `image_text` | Bild und Text | 2 | `image_left`, `image_right` | `refs.image` | 2 | | `image_text` | Bild und Text, Premium nach Kit v1.6 | 3 | `image_left`, `image_right` (Bildseite) | 1–4 | `compact`, `normal` (Vorgabe), `spacious` | `refs.image` |
| `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (kompakte Liste) | Bild je Karte in `data.items[].image` | 1 | | `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (Liste), `featured` (erste Karte hervorgehoben) | 1–4 | – | Bild je Karte in `data.items[].image` |
| `catalog_cards` | Programm- und Modulkarten | 1 | `standard` (Karten mit Kurzbeschreibung), `compact` (Liste) | `refs.items[] = {type: composition, id}` | 1 | | `catalog_cards` | Programm- und Modulkarten | 1 | `standard`, `compact` | 1–4 | – | `refs.items[] = {type: composition, id}` |
| `call_to_action` | Handlungsaufruf | 1 | `standard` | – | 1 | | `call_to_action` | Handlungsaufruf | 1 | `standard` | 1–4 | `auto` (Vorgabe), `fill` (Abschnittshöhe füllen) | – |
| `faq` | FAQ | 1 | `standard` | – | 2 | | `faq` | FAQ | 1 | `standard` | 2–4 | – | – |
Darstellungsklassen: `widget widget-<typ> widget-variant-<variante>` an der Widget-Hülle; je Ansicht eigene Klassen (`hero-highlight`, `image-text-right`, `cards-compact`, `catalog-cards-compact`). Die visuelle Veredelung verändert nur `resources/views/widgets/*` und `resources/css/widgets.css`, nicht Daten, Register oder Editor. Darstellungsklassen an der Widget-Hülle: `widget widget-<typ> widget-variant-<variante>` und, wenn die Art Höhen anbietet, `widget-height-<höhe>`. Premium-Ansichten: `lf-hero lf-hero--{photo-split|editorial-solid} lf-hero--height-<höhe> lf-hero--accent-<akzent>` und `lf-bt lf-bt--{cream|clear|navy} lf-bt--image-{left|right} lf-bt--height-<höhe>`.
**Premium-Widgets (Kit v1.6).** Ansichten `resources/views/widgets/hero.blade.php` und `image_text.blade.php`, Stylesheets `resources/css/components/lf-hero.css` und `lf-bild-text.css` (aus `12_premium_widgets_adaptiv_v1.6/components/*.v1.6.css` übernommen und angepasst; sie ersetzen das frühere Hero- und Bild-und-Text-CSS und werden nicht parallel geladen). Gemeinsame Felder in `App\Domain\Cms\Widgets\Support\PremiumFields`:
| Feld | Gespeichert als | Hinweis |
|---|---|---|
| Label | `data.eyebrow` | höchstens 80 Zeichen |
| Überschrift | `data.heading` (Einstieg), `data.title` (Bild und Text) | |
| Beschreibung | `data.text` (Klartext, Einstieg), `data.body` (bereinigter formatierter Text, Bild und Text) | |
| Schaltflächen | `data.cta_label/cta_url`, `data.cta2_label/cta2_url` | Linkziele über `SafeUrl` |
| Bild, Alternativtext | `refs.image`, `data.alt` | öffentlicher Bereich `cms/`; Alternativtext Pflicht bei Bild |
| Bildfokus | `data.focus_x`, `data.focus_y` | ganze Zahlen 0–100; Vorgabe Einstieg 68/50, Bild und Text 64/43 |
| Überschriftenebene | `settings.heading_level` | `auto` (Vorgabe), `h2`, `h3`; das erste Widget der Seite ist immer H1 |
| Akzent (Einstieg) | `settings.accent` | `underline` (Vorgabe), `rays`, `none` |
| Fläche (Bild und Text) | `settings.surface` | `cream` (Vorgabe), `clear` (übernimmt den Abschnitt), `navy` |
| Höhe | `settings.height` | gemeinsamer Layoutvertrag (§12) |
**Abweichungen vom Kit (bewusst):**
- Kennungen bleiben `hero` und `image_text`, nicht `lf-brand-hero`/`lf-editorial-bild-text`; Varianten `photo_split`/`editorial_solid` mit Unterstrich, weil Variantenkennungen `^[a-z][a-z0-9_]*$` folgen.
- Bildseite von Bild und Text bleibt die Variante (`image_left/right`), nicht zusätzlich `settings.image_side`, damit es keine doppelte Einstellung gibt.
- Bildfokus in `data` statt `settings.image_focus`, weil Einstellungen nur Aufzählungswerte tragen.
- Überschriftenebene ohne frei wählbare H1 (Regel: genau eine H1 je Seite, erstes Widget).
- Linkziele: Seitenpfad, `#Anker`, `http` und `https` (bestehende `SafeUrl`-Regel); das Kit erlaubt nur `https`.
- Das Kit lädt das Einstiegsbild immer sofort; hier nur beim ersten Widget der Seite, alle anderen verzögert.
- Kit-CSS ergänzt: Überschriften erben Farbe (globale h1–h3-Regeln), Unterstreichung als Block, Fläche `clear` übernimmt die Farben dunkler Abschnitte, Strahlen-Akzent aus `components/brand/rays.blade.php`, Fokusfarbe aus den Tokens.
## 5. Neues Widget hinzufügen ## 5. Neues Widget hinzufügen
1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, `minUnits()`/`preferredUnits()`/`stages()` (Abschnitt 12), `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()`, `mediaPaths()`, `summary()`, `schematic()`, `icon()`. 1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, Layoutvertrag `supportedUnits()`/`preferredUnits()`/`heights()`/`stages()`/`narrowBehavior()` (Abschnitt 12), `settings()`/`settingLabels()`/`optionIcons()`, `mediaSchema()` für den Reiter „Medien“, `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()`, `mediaPaths()`, `summary()`, `schematic()`, `icon()`.
2. Ansicht `resources/views/widgets/<kennung>.blade.php` anlegen. Verfügbar: `$data`, `$refs`, `$variant`, `$settings`, `$first`, `$context` (Vorschau ja/nein) und die Rückgabe von `resolve()`. Kein `{!! !!}` außer für mit `RichText::sanitize` bereinigten Text. Breitenabhängige Regeln als Container-Abfrage `@container slot (…)`, nicht als Fenster-Medienabfrage; Farben nur über Bedeutungs-Tokens. 2. Ansicht `resources/views/widgets/<kennung>.blade.php` anlegen. Verfügbar: `$data`, `$refs`, `$variant`, `$settings`, `$first`, `$context` (Vorschau ja/nein) und die Rückgabe von `resolve()`. Kein `{!! !!}` außer für mit `RichText::sanitize` bereinigten Text. Breitenabhängige Regeln als Container-Abfrage `@container slot (…)`, nicht als Fenster-Medienabfrage; Farben nur über Bedeutungs-Tokens.
3. Klasse in `config/cms.php` unter `widgets` eintragen. 3. Klasse in `config/cms.php` unter `widgets` eintragen.
4. Tests ergänzen (Registrierung und Prüfregeln in `tests/Unit/WidgetRegistryTest.php`, Darstellung in `tests/Feature/CmsWidgetRenderingTest.php` bzw. `CmsSectionRenderingTest.php`). 4. Tests ergänzen (Registrierung und Prüfregeln in `tests/Unit/WidgetRegistryTest.php`, Darstellung in `tests/Feature/CmsWidgetRenderingTest.php` bzw. `CmsSectionRenderingTest.php`).
@@ -117,7 +143,9 @@ ## 8. Editor und Vorschau
- **Raster**: grafische Auswahl mit sechs Kacheln. Raster mit weniger Plätzen als eingesetzten Widgets sind gesperrt. Beim Wechsel entfallen zuerst leere Plätze; Widgets behalten ihre Reihenfolge (`SectionEditor::arrangeSlots`). Kein Wechsel entfernt ein Widget. - **Raster**: grafische Auswahl mit sechs Kacheln. Raster mit weniger Plätzen als eingesetzten Widgets sind gesperrt. Beim Wechsel entfallen zuerst leere Plätze; Widgets behalten ihre Reihenfolge (`SectionEditor::arrangeSlots`). Kein Wechsel entfernt ein Widget.
- **Gestaltung des Abschnitts** (eingeklappt, Zusammenfassung im Kopf): Hintergrund, Breite, Abstand, Trenner; bei Hintergrundbild zusätzlich Bild (Auswahl oder Upload), Fokuspunkt und Überlagerung. Abschnitts- und Widget-Einstellungen sind getrennt. - **Gestaltung des Abschnitts** (eingeklappt, Zusammenfassung im Kopf): Hintergrund, Breite, Abstand, Trenner; bei Hintergrundbild zusätzlich Bild (Auswahl oder Upload), Fokuspunkt und Überlagerung. Abschnitts- und Widget-Einstellungen sind getrennt.
- **Plätze** stehen im Verhältnis des Desktop-Rasters nebeneinander; Widgets lassen sich per Ziehen zwischen Plätzen tauschen. Der Platzkopf nennt Breite und warnt, wenn das Widget breiter sein müsste. Ein freier Platz bietet „Widget einsetzen“ (Auswahl mit Name, Beschreibung, Symbolbild, Mindestbreite), danach öffnet der Widget-Dialog. Ein Klick auf die Vorschau öffnet denselben Dialog: eine Dialogebene. - **Plätze** stehen im Verhältnis des Desktop-Rasters nebeneinander; Widgets lassen sich per Ziehen zwischen Plätzen tauschen. Der Platzkopf nennt Breite und warnt, wenn das Widget breiter sein müsste. Ein freier Platz bietet „Widget einsetzen“ (Auswahl mit Name, Beschreibung, Symbolbild, Mindestbreite), danach öffnet der Widget-Dialog. Ein Klick auf die Vorschau öffnet denselben Dialog: eine Dialogebene.
- **Widget-Vorschau**: dieselbe Ansicht wie öffentlich, im isolierten `iframe` mit dem Website-Stylesheet, in der tatsächlichen Platzbreite (Container-Abfragen greifen). Keine eigene Bildlaufleiste; über 22 rem wird gekürzt mit Hinweis „vollständig in der Seitenvorschau“. Die Abschnittsfläche zeigt erst die Seitenvorschau. - **Widget-Dialog**: Arten mit Darstellungsoptionen oder Medien gliedern den Dialog in die Reiter **Inhalt**, **Medien** und **Darstellung** (generisch aus der Registry: `editorSchema()`, `mediaSchema()`, Varianten und `settingOptions()`); andere Arten zeigen ihre Felder direkt. Varianten und Höhen sind sichtbare Auswahlknöpfe mit Symbol, Bildfokus zwei Schieberegler (0–100). „Darstellung“ nennt die zulässigen Platzbreiten und das Verhalten bei wenig Platz.
- **Live-Vorschau im Dialog**: rendert den ungespeicherten Zustand mit derselben Ansicht wie die Website (`WidgetEditor::renderPreview`) in einer wählbaren logischen Platzbreite (Smartphone 390 px und die zulässigen Einheiten: 310/640/960/1300 px, entsprechend dem Standardabschnitt bei 1440 px Fensterbreite) und verkleinert sie auf die Dialogbreite. Die Breitenwahl wird nicht gespeichert.
- **Widget-Vorschau im Platz**: dieselbe Ansicht im isolierten `iframe` in der Breite des Platzes im Editor; über 28 rem gekürzt mit Hinweis „vollständig in der Seitenvorschau“.
- „Entwurf speichern“ erzeugt eine Revision (bei unverändertem Stand keine weitere). „Veröffentlichen“ speichert zuerst den aktuellen Stand im Editor und veröffentlicht genau diesen; enthält er Fehler, wird nichts veröffentlicht. Vorher veröffentlichte „Veröffentlichen“ nur die zuletzt gespeicherte Revision, sodass übernommene, aber ungespeicherte Änderungen (etwa ein gewähltes Bild) verloren gingen. - „Entwurf speichern“ erzeugt eine Revision (bei unverändertem Stand keine weitere). „Veröffentlichen“ speichert zuerst den aktuellen Stand im Editor und veröffentlicht genau diesen; enthält er Fehler, wird nichts veröffentlicht. Vorher veröffentlichte „Veröffentlichen“ nur die zuletzt gespeicherte Revision, sodass übernommene, aber ungespeicherte Änderungen (etwa ein gewähltes Bild) verloren gingen.
- Verlassen oder Neuladen mit ungespeicherten Änderungen löst eine Warnung des Browsers aus. - Verlassen oder Neuladen mit ungespeicherten Änderungen löst eine Warnung des Browsers aus.
- Ganzseitige Vorschau: `/redaktion/vorschau/{revision}/geraete` mit Umschaltern 390/768/1440 px; zeigt Kopfzeile, Navigation, Abschnitte, Flächen, Trenner und Fußbereich mit demselben Renderer wie die öffentliche Seite; `noindex`. - Ganzseitige Vorschau: `/redaktion/vorschau/{revision}/geraete` mit Umschaltern 390/768/1440 px; zeigt Kopfzeile, Navigation, Abschnitte, Flächen, Trenner und Fußbereich mit demselben Renderer wie die öffentliche Seite; `noindex`.
@@ -157,7 +185,11 @@ ## 9. Rollback und Datenformat (wichtig vor dem Merge nach `main`)
WHERE p.published_revision_id IN (SELECT id FROM page_revisions WHERE created_at >= :deploy); WHERE p.published_revision_id IN (SELECT id FROM page_revisions WHERE created_at >= :deploy);
``` ```
Die Migrationen (`sections`, `parent_id`) sind ergänzend und müssen beim Rollback nicht zurückgenommen werden; älterer Code ignoriert beide Spalten. Ein reiner Code-Rollback ist nach redaktionellen Änderungen im neuen Editor **nicht** als sicher anzusehen; der Weg oben ist Teil jedes Rollbacks. Die Migrationen (`sections`, `parent_id`) sind ergänzend und müssen beim Rollback nicht zurückgenommen werden; älterer Code ignoriert beide Spalten.
**Adaptive Widgets (ADR-38)** bringen keine Migration. Gespeichert werden ab jetzt `hero` Version 2 und `image_text` Version 3. Ein Code-Rollback auf Designiteration 1 stellt diese Hüllen „bestmöglich“ dar (höhere Version als im Code): unbekannte Varianten fallen auf die Vorgabe zurück, die data-Schlüssel sind unverändert; Höhe, Fläche, Label und Fokus werden nicht dargestellt, aber nicht gelöscht. Speichern im alten Editor ist für diese Hüllen nicht möglich, bis der neue Code wieder läuft.
**Designiteration 1** bringt keine Migration. Bei einem Code-Rollback auf Iteration 2 fallen die neuen Varianten beim Lesen auf die Vorgabe zurück (`stage`/`editorial` → `standard`, `featured` → `standard`); die neuen Einstellungen und `cta2_*` werden nicht dargestellt, aber nicht gelöscht. Seiten bleiben darstellbar; der Wiederherstellungsweg oben ist dafür nicht nötig. Ein reiner Code-Rollback ist nach redaktionellen Änderungen im neuen Editor **nicht** als sicher anzusehen; der Weg oben ist Teil jedes Rollbacks.
## 10. Navigation ## 10. Navigation
@@ -199,19 +231,26 @@ ## 11. Abschnitte und Plätze
- **Erstes Widget** der Seite ist der Seiteneinstieg (Überschrift erster Ordnung); seitenweit genau eine. - **Erstes Widget** der Seite ist der Seiteneinstieg (Überschrift erster Ordnung); seitenweit genau eine.
- **Grenzen**: höchstens 30 Abschnitte und 60 Widgets je Seite; keine Verschachtelung. - **Grenzen**: höchstens 30 Abschnitte und 60 Widgets je Seite; keine Verschachtelung.
## 12. Responsive Widget-Regeln ## 12. Responsive Widget-Regeln und gemeinsamer Layoutvertrag (ADR-38)
Jede Widget-Art meldet `minUnits()` (kleinste zulässige Platzbreite auf dem Desktop), `preferredUnits()` (Hinweis) und `stages()` (Darstellungsstufen). Jeder Platz ist ein Container (`slot`); die Widget-Ansichten verwenden Container-Abfragen statt Fensterbreiten. Jede Widget-Art erklärt in `WidgetType`:
- `supportedUnits()`: zulässige Platzbreiten (1–4); `minUnits()` ist daraus abgeleitet. Ein Platz mit anderer Breite wird beim Speichern abgewiesen („… ist für Plätze mit 3 oder 4 Rastereinheiten vorgesehen“); der Platzkopf im Editor warnt vorher („passt nicht“), die Widget-Auswahl nennt die zulässigen Breiten.
- `heights()`: angebotene Höhen aus `WidgetType::HEIGHTS` (`auto`, `compact`, `normal`, `large`, `spacious`, `fill`), gespeichert als `settings.height`; `defaultHeight()` gilt ohne Angabe. Höhen sind Mindesthöhen oder Proportionen, nie Begrenzungen. `fill` streckt das Widget auf die Höhe der Abschnittszeile, wenn Plätze nebeneinander stehen.
- `stages()` und `narrowBehavior()`: Darstellungsmodi nach Containerbreite und Verhalten bei wenig Platz.
| Widget | Mindestbreite | Vorzug | Stufen | Jeder Platz ist ein Container (`slot`); die Premium-Widgets haben zusätzlich eigene Container (`lf-hero`, `lf-bt`). Entscheidend ist die tatsächliche Breite, nicht die Einheitenzahl.
| Widget | Breiten | Höhen | Darstellung nach Containerbreite |
|---|---|---|---| |---|---|---|---|
| Einstieg (Hero) | 2 | 4 | unter 48 rem Bild unter dem Text; ab 48 rem nebeneinander; Überschrift wächst mit der Platzbreite | | Einstieg (Hero) | 3, 4 | compact/normal/large | ab 860 px Foto über die Fläche, Text links, Mindesthöhe 400/512/640 px; darunter Sicherheitsumbruch: Foto 16:9 über dem Text, Höhe nach Inhalt; unter 440 px Schaltflächen untereinander |
| Überschrift | 1 | 4 | Größe folgt der Platzbreite | | Bild und Text | 1–4 | compact/normal/spacious | unter 540 px gestapelt, Schaltflächen in voller Breite; 540–899 px flacher Bildstreifen (2,5 : 1 / 2,15 : 1 / 1,8 : 1) über dem Text; ab 900 px zweispaltig, Bild links oder rechts |
| Fließtext | 1 | 2 | Zeilenlänge höchstens etwa 70 Zeichen | | Überschrift | 1–4 | – | Größe folgt der Platzbreite, lange Wörter werden getrennt |
| Bild und Text | 2 | 4 | unter 36 rem gestapelt; ab 36 rem Bild links oder rechts | | Fließtext | 1–4 | – | Zeilenlänge höchstens etwa 70 Zeichen, lange Adressen brechen um |
| Redaktionelle Karten | 1 | 4 | so viele Karten nebeneinander, wie bei 14 rem Kartenbreite passen | | Redaktionelle Karten | 1–4 | – | so viele Karten nebeneinander, wie bei 15 rem Kartenbreite passen; hervorgehobene Karte ab 44 rem mit Bild neben dem Text |
| Programm- und Modulkarten | 1 | 4 | ab 16 rem Kartenbreite mehrspaltig; kompakte Liste für schmale Plätze | | Programm- und Modulkarten | 1–4 | – | ab 17 rem Kartenbreite mehrspaltig; eine einzelne Karte ab 40 rem mit Tafel neben dem Text |
| Handlungsaufruf | 1 | 2 | unter 20 rem Schaltfläche in voller Breite | | Handlungsaufruf | 1–4 | auto/fill | unter 20 rem Schaltfläche in voller Breite; Beschriftungen brechen um |
| FAQ | 2 | 4 | Fragen untereinander, Antworten auf Lesebreite | | FAQ | 2–4 | – | Fragen untereinander, Antworten auf Lesebreite |
Ableitung: Ein Platz mit einer Einheit ist bei Standardbreite auf dem Desktop etwa 17 rem (rund 276 px) breit. Bild-neben-Text und Einstieg sind darin nicht sinnvoll lesbar (zwei Spalten unter je 140 px); Karten, Fließtext und Aufrufe bleiben es. Ein zu schmaler Platz wird beim Speichern mit Abschnitt und Platz gemeldet; der Platzkopf im Editor zeigt „zu schmal“ bereits vorher. Auf Tablet und Smartphone stapeln die Plätze, dort gilt die Mindestbreite nicht. Gemessene Platzbreiten im Standardabschnitt (82 rem) bei 1440 px Fensterbreite: 1 Einheit etwa 301–319 px, 2 Einheiten 638 px, 3 Einheiten 957 px, 4 Einheiten 1312 px. Bei 1200 px Fensterbreite hat ein Platz mit 3 Einheiten 807 px; der Einstieg zeigt dort den Sicherheitsumbruch.
Ableitung: Bild und Text funktioniert dank gestapelter Darstellung auch in einer Einheit; der Einstieg braucht für seine Komposition mindestens etwa 860 px und ist deshalb nur für 3 oder 4 Einheiten freigegeben. Auf Tablet und Smartphone stapeln die Plätze; dort gelten die Breitenregeln nicht, die Widgets reagieren auf ihre Containerbreite.
+50 -13
View File
@@ -1,8 +1,8 @@
# Gemeinsames Designsystem (ADR-36) – umgesetzter Stand # Gemeinsames Designsystem (ADR-36) – umgesetzter Stand
Stand: 17.11.2026, Branch `feature/cms-sections`. Gilt für öffentliche Website, Anmeldung, Mitgliederbereich und Mitgliederbibliothek; später für Warenkorb und Checkout. Die Verwaltung (Filament) bleibt in Standardgestaltung. Stand: 18.11.2026, Designiteration 1 (Branch `feature/design-iteration-1`; Vorstand 17.11.2026 `feature/cms-sections`). Gilt für öffentliche Website, Anmeldung, Mitgliederbereich und Mitgliederbibliothek; später für Warenkorb und Checkout. Die Verwaltung (Filament) bleibt in Standardgestaltung.
**Status der Werte:** Alle Markenwerte, Schriften und die Wortmarke sind **vorläufig**. Sie stammen aus `docs/Brand-UI-Kit/02_design_tokens` (Entwurf vom 15.11.2026, aus den Originalmotiven abgeleitet, laut Kit nicht freigegeben) und aus der Empfehlung im Website-Zielkonzept §7.2. Diese Datei ist keine Markenfreigabe. Eine Freigabe ändert ausschließlich `resources/css/tokens.css` (und für die Wortmarke `resources/views/components/site/brand.blade.php`). **Status der Werte:** Alle Markenwerte, Schriften und die Wortmarke sind **vorläufig**. Sie stammen aus `docs/Brand-UI-Kit/02_design_tokens` (Entwurf vom 15.11.2026, aus den Originalmotiven abgeleitet, laut Kit nicht freigegeben) und aus der Empfehlung im Website-Zielkonzept §7.2. Diese Datei ist keine Markenfreigabe. Eine Freigabe ändert ausschließlich `resources/css/tokens.css` (und für die Wortmarke `resources/views/components/site/brand.blade.php`, für die Markenakzente `resources/views/components/brand/`).
## 1. Dateien ## 1. Dateien
@@ -11,7 +11,9 @@ ## 1. Dateien
| `resources/css/tokens.css` | Ebene 1 Markenwerte (`--lf-*`), Ebene 2 Bedeutungswerte (`--color-*`), Typografie, Abstände, Rundungen, Layoutmaße, Flächen-Gültigkeitsbereiche `.scope-dark`, `.scope-accent`, `.scope-light` | | `resources/css/tokens.css` | Ebene 1 Markenwerte (`--lf-*`), Ebene 2 Bedeutungswerte (`--color-*`), Typografie, Abstände, Rundungen, Layoutmaße, Flächen-Gültigkeitsbereiche `.scope-dark`, `.scope-accent`, `.scope-light` |
| `resources/css/base.css` | Grundelemente, Überschriften, Links, Fokus, Sprunglink, `prefers-reduced-motion` | | `resources/css/base.css` | Grundelemente, Überschriften, Links, Fokus, Sprunglink, `prefers-reduced-motion` |
| `resources/css/components.css` | Grundkomponenten: Container, Schaltflächen, Formulare, Statusanzeigen, Karte, Dialog, Kennzeile, Themensignatur, Redaktionshinweise | | `resources/css/components.css` | Grundkomponenten: Container, Schaltflächen, Formulare, Statusanzeigen, Karte, Dialog, Kennzeile, Themensignatur, Redaktionshinweise |
| `resources/css/site.css` | Website-Gerüst: Wortmarke, Kopfzeile, Hauptnavigation, mobile Navigation, Inhaltsfläche, Fußbereich | | `resources/css/site.css` | Website-Gerüst: Wortmarke, Kopfzeile (zwei Zustände), Hauptnavigation, Menümodus, Inhaltsfläche, Fußbereich, Markenakzente |
| `resources/views/components/brand/` | Markenakzente als Blade-Komponenten: `underline` (Unterstreichung), `rays` (Signalstrahlen), `arc` (grüner Bogen); dekorativ, `aria-hidden`, Farbe über Tokens |
| `resources/js/site-nav.js` | Menü, Fokusfalle, Untermenüs, kompakter Zustand, Wiederholung der Breitenmessung (die Messung selbst steht inline in `components/site/header.blade.php`) |
| `resources/css/sections.css` | Abschnitte, Raster, Flächen, Hintergrundbilder, Trenner | | `resources/css/sections.css` | Abschnitte, Raster, Flächen, Hintergrundbilder, Trenner |
| `resources/css/widgets.css` | Widget-Ansichten (Container-Abfragen) | | `resources/css/widgets.css` | Widget-Ansichten (Container-Abfragen) |
| `resources/css/app.css` | bindet alles ein; Mitgliederbereich über seine bisherigen Variablennamen, die auf die gemeinsamen Tokens zeigen | | `resources/css/app.css` | bindet alles ein; Mitgliederbereich über seine bisherigen Variablennamen, die auf die gemeinsamen Tokens zeigen |
@@ -48,7 +50,11 @@ ## 4. Kontraste (berechnet nach WCAG-Formel)
| Fließtext `#15243a` auf Weiß / Creme | 15,61 / 14,43 : 1 | Text 4,5 | | Fließtext `#15243a` auf Weiß / Creme | 15,61 / 14,43 : 1 | Text 4,5 |
| Leiser Text `#3e4c5c` auf Weiß / Creme | 8,78 / 8,11 : 1 | Text 4,5 | | Leiser Text `#3e4c5c` auf Weiß / Creme | 8,78 / 8,11 : 1 | Text 4,5 |
| Navy (Überschrift, Link) auf Weiß | 15,14 : 1 | Text 4,5 | | Navy (Überschrift, Link) auf Weiß | 15,14 : 1 | Text 4,5 |
| Weiß auf Aktionsgrün `#3b7b09` (Schaltfläche, Markenakzent) | 5,22 : 1 | Text 4,5 | | Weiß auf Aktionsgrün `#3b7b09` (Schaltfläche, Markenakzent, Wortmarken-Schild, Programmtafel auf dunkler Fläche) | 5,22 : 1 | Text 4,5 |
| Grün dunkel auf Weiß (Art „Programm“/„Modul“ in Listen) | 5,22 : 1 | Text 4,5 |
| Navy auf Gelb (Markenschaltfläche `.button-brand`) / Hover `#ffe05c` | 10,28 / 11,58 : 1 | Text 4,5 |
| Navy auf Creme (Tafel der Markenbühne) | 14,00 : 1 | Text 4,5 |
| Fußbereich Grundzeile `#f4f6f8` auf Grün dunkel (falls der Bogen Links berührt) | 4,82 : 1 | Text 4,5 |
| Text `#f4f6f8` / leise `#d3dde8` auf Navy | 13,97 / 11,01 : 1 | Text 4,5 | | Text `#f4f6f8` / leise `#d3dde8` auf Navy | 13,97 / 11,01 : 1 | Text 4,5 |
| Navy auf Gelb (Schaltfläche auf dunkler Fläche) | 10,28 : 1 | Text 4,5 | | Navy auf Gelb (Schaltfläche auf dunkler Fläche) | 10,28 : 1 | Text 4,5 |
| Leiser Text `#eef4e8` auf Aktionsgrün | 4,66 : 1 | Text 4,5 | | Leiser Text `#eef4e8` auf Aktionsgrün | 4,66 : 1 | Text 4,5 |
@@ -69,7 +75,7 @@ ## 5. Typografie, Abstände, Maße
| Skala | Fließtext 17 → 18 px, Zeilenhöhe 1,6; H3 20 → 22; H2 26 → 34; H1 34 → 52; Lesebreite 70 Zeichen | | Skala | Fließtext 17 → 18 px, Zeilenhöhe 1,6; H3 20 → 22; H2 26 → 34; H1 34 → 52; Lesebreite 70 Zeichen |
| Abstände | Grundmaß 4 px: 4, 8, 12, 16, 24, 32, 48, 64, 96 px | | Abstände | Grundmaß 4 px: 4, 8, 12, 16, 24, 32, 48, 64, 96 px |
| Rundungen | 8 (klein), 14 (Karte), 22 (Fläche), Pille | | Rundungen | 8 (klein), 14 (Karte), 22 (Fläche), Pille |
| Container | schmal 45 rem, Standard 75 rem, breit 90 rem; Randabstand 16–32 px | | Breiten | Lesebereich 44 rem, Standard 82 rem, Breit 96 rem, Vollbreite; Randabstand 16–40 px (siehe Abschnitt 12) |
| Trefferfläche | mindestens 44 × 44 px | | Trefferfläche | mindestens 44 × 44 px |
| Fokus | 3 px Rahmen in `--color-focus`, 3 px Abstand, auf jeder Fläche sichtbar | | Fokus | 3 px Rahmen in `--color-focus`, 3 px Abstand, auf jeder Fläche sichtbar |
@@ -80,7 +86,7 @@ ## 6. Grundkomponenten
| Komponente | Klassen | Hinweis | | Komponente | Klassen | Hinweis |
|---|---|---| |---|---|---|
| Container | `.ui-container`, `.ui-container-wide` | Standard- bzw. breite Inhaltsbreite mit Randabstand | | Container | `.ui-container`, `.ui-container-wide` | Standard- bzw. breite Inhaltsbreite mit Randabstand |
| Schaltfläche | `.button` / `.ui-button`, `-secondary`, `-quiet`, `[disabled]` | Haupt-, Neben-, Textaktion; Farben aus der jeweiligen Fläche | | Schaltfläche | `.button` / `.ui-button`, `-secondary`, `-quiet`, `[disabled]`; `.button-brand` | Haupt-, Neben-, Textaktion; Farben aus der jeweiligen Fläche. `.button-brand` (Gelb, Navy-Schrift) nur für die erste Handlung im Seiteneinstieg |
| Formular | `.form`, `.ui-field`, `.ui-input`, `.ui-field-error`, `.check` | sichtbare Beschriftung, Fehlerzustand über `aria-invalid` | | Formular | `.form`, `.ui-field`, `.ui-input`, `.ui-field-error`, `.check` | sichtbare Beschriftung, Fehlerzustand über `aria-invalid` |
| Statusanzeige | `.status`, `.errors`, `.ui-notice-{success,warning,danger,info}` | Farbe, Randlinie und Text, nie Farbe allein | | Statusanzeige | `.status`, `.errors`, `.ui-notice-{success,warning,danger,info}` | Farbe, Randlinie und Text, nie Farbe allein |
| Karte | `.ui-card`, `.empty` | helle Fläche mit Linie | | Karte | `.ui-card`, `.empty` | helle Fläche mit Linie |
@@ -94,10 +100,13 @@ ## 7. Wortmarke und Markenassets
| Asset | Status | Verwendung | | Asset | Status | Verwendung |
|---|---|---| |---|---|---|
| Wortmarke als Weblogo (SVG/PNG) | **fehlt**; Logo-Varianten in den Filmmotiven weichen voneinander ab (Kit-README, Leitlinie 5) | vorläufiger Schriftzug „Lara & Felix / Stark im Alltag“ in Nunito, gekennzeichnet `data-brand-status="vorlaeufig"`, ohne Nachbildung (keine Drehung, kein Unterstrich-Schwung) | | Wortmarke als Weblogo (SVG/PNG) | **fehlt**; Logo-Varianten in den Filmmotiven weichen voneinander ab (Kit-README, Leitlinie 5) | vorläufiger Schriftzug „Lara & Felix“ in Nunito, auf der Website (`variant="lockup"`) mit grünem Schild „Stark im Alltag“ nach dem Web-Entwurf des Kits; gekennzeichnet `data-brand-status="vorlaeufig"`, ohne Nachbildung der Filmwortmarke (keine Wolkenform, keine Drehung, kein Unterstrich-Schwung, keine Strahlen) |
| Titel-, Denkpause-, Outro-Motiv (`01_originale`) | Original vorhanden, **öffentliche Nutzung nicht freigegeben** (Quellenmanifest) | nicht verwendet; nicht in `public/` oder den Medienbestand kopiert | | Titel-, Denkpause-, Outro-Motiv (`01_originale`) | Original vorhanden, **öffentliche Nutzung nicht freigegeben** (Quellenmanifest) | nicht verwendet; nicht in `public/` oder den Medienbestand kopiert |
| Figurenreferenzen Lara, Felix, Oma | nur interne Referenz | nicht verwendet | | Figurenreferenzen Lara, Felix, Oma | nur interne Referenz | nicht verwendet |
| SVG-Entwürfe (`03_svg_entwuerfe`: Monogramm, Strahlen, Unterstreichung, Denkblase, Hand) | neue, nicht freigegebene Vorschläge | nicht verwendet | | SVG-Entwürfe Unterstreichung und Signalstrahlen (`03_svg_entwuerfe`) | neue, nicht freigegebene Vorschläge | **seit Designiteration 1 verwendet** als Akzente: Unterstreichung unter Einstiegs- und Abschnittsüberschriften, Strahlen an Bild- und Tafelecken; nie an der Wortmarke |
| Grüner Bogen | eigene Ableitung nach dem Homepage-Entwurf des Kits | Abschluss des Fußbereichs |
| SVG-Entwürfe Denkblase und Hand | didaktische Symbole der Denkpause | bewusst nicht als Dekor verwendet; gehören in Kursplayer und Lernansichten |
| SVG-Entwurf Monogramm | kein freigegebenes Logo | nicht verwendet, auch nicht als Favicon |
| KI-Konzeptgrafiken (`04_visuelle_entwuerfe`) | erfundene Inhalte, nicht freigegeben | nicht verwendet | | KI-Konzeptgrafiken (`04_visuelle_entwuerfe`) | erfundene Inhalte, nicht freigegeben | nicht verwendet |
| Themensymbole der fünf Bereiche | nicht entworfen | nicht verwendet; Platz vorbereitet | | Themensymbole der fünf Bereiche | nicht entworfen | nicht verwendet; Platz vorbereitet |
@@ -107,12 +116,15 @@ ## 8. Themensignaturen (vorbereitet)
`.ui-theme-signature` trägt Nummer (1–5) und Name des Themenbereichs; `--color-theme-1` bis `--color-theme-5` sind Platzhalter, die bis zur Freigabe alle auf die neutrale helle Fläche zeigen. Unterscheidung erfolgt damit ohne Farbe (Design-Prinzipien §3). Nach Freigabe werden Tönungen in `tokens.css` und Symbole als SVG je Säule ergänzt; Mehrfachzuordnung ist als Reihe von Marken vorgesehen. `.ui-theme-signature` trägt Nummer (1–5) und Name des Themenbereichs; `--color-theme-1` bis `--color-theme-5` sind Platzhalter, die bis zur Freigabe alle auf die neutrale helle Fläche zeigen. Unterscheidung erfolgt damit ohne Farbe (Design-Prinzipien §3). Nach Freigabe werden Tönungen in `tokens.css` und Symbole als SVG je Säule ergänzt; Mehrfachzuordnung ist als Reihe von Marken vorgesehen.
## 9. Website-Gerüst ## 9. Website-Gerüst (Designiteration 1)
- **Kopfzeile** (klebend, 64/72 px): Wortmarke, CMS-Hauptnavigation, Kontozugang „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet), vorbereiteter Warenkorbzugang (`config/cms.php` → `cart.enabled`, Vorgabe aus: es wird nichts ausgegeben). - **Kopfzeile, zwei Zustände ohne Layoutsprung.** Die Box ist immer `--header-height-initial` hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand (`top: kompakt − initial`). Die innere Leiste (`.site-header-bar`, 72 px) klebt oben. Beim Scrollen wandert sie 16 px nach oben und bleibt dann stehen; der Seitenfluss ändert sich nie. Ein Beobachter (`data-site-header-sentinel`) setzt `.is-compact`: Wortmarke von 1,16-facher auf normale Größe (nur `transform`) und Schatten. Unter `prefers-reduced-motion` ohne Übergang. Ohne JavaScript klebt die Kopfzeile genauso; nur die Wortmarke bleibt groß.
- **Hauptnavigation**: aus `navigation_items` (`header`), aktiver Eintrag mit gelber Linie und `aria-current`, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit `aria-expanded`, Escape schließt, Klick außerhalb schließt). Ab 75 rem in der Zeile, darunter Menü-Schaltfläche. - **Breitenstufen der Navigation** (`site-nav.js`, Messung an einer unsichtbaren Kopie): 1. Navigation und Kontozugang mit Beschriftung in einer Zeile; 2. sonst Kontozugang nur als Symbol (`.is-account-compact`); 3. sonst und immer unter 75 rem Menümodus (`.is-menu-mode`). Die Navigation bricht nie um; deshalb ist die Kopfzeile auf allen Seiten gleich hoch, unabhängig von Anzahl und Länge der CMS-Einträge. Die Messung steht inline direkt nach der Kopfzeile (`window.lufHeaderMode`) und setzt die Stufe vor dem ersten Zeichnen; `site-nav.js` wiederholt sie bei Größenänderungen und nach dem Laden der Schriften.
- **Mobile Navigation**: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche unter der Kopfzeile mit 48 px hohen Einträgen, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator bleibt im Menü, Escape schließt und gibt den Fokus an die Schaltfläche zurück. Keine feste untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation als umbrechende Liste sichtbar. - **Hauptnavigation**: aus `navigation_items` (`header`), aktiver Eintrag mit gelber Markenunterstreichung und `aria-current`, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit `aria-expanded`, Escape schließt, Klick außerhalb schließt).
- **Fußbereich** (dunkle Fläche): Wortmarke, „Themenbereiche“ aus den veröffentlichten Säulen, Gruppen „Service“, „Kontakt“, „Rechtliches“ aus der CMS-Navigation. Leere Gruppen entfallen; es werden keine Kontakt- oder Rechtstexte erfunden. - **Menümodus**: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche direkt unter dem sichtbaren Teil der Kopfzeile, 48 px hohe Einträge, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator läuft im Kreis zwischen Schaltfläche und Einträgen, Escape schließt und gibt den Fokus zurück. Keine untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation unter 75 rem als umbrechende Liste sichtbar.
- **Kontozugang** „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet) und vorbereiteter Warenkorbzugang (`config/cms.php` → `cart.enabled`, Vorgabe aus: es wird nichts ausgegeben).
- **Fußbereich** (dunkle Fläche): Wortmarke, „Themenbereiche“ aus den veröffentlichten Säulen, Gruppen „Service“ und „Kontakt“ aus der CMS-Navigation; „Rechtliches“ in einer eigenen Grundzeile. Grüner Bogen als Abschluss. Leere Gruppen entfallen; es werden keine Kontakt- oder Rechtstexte erfunden.
- **Stabile Geometrie**: `scrollbar-gutter: stable` auf `html` (kurze und lange Seiten gleich breit), `scroll-padding-top` für Sprungziele. Wortmarke, Navigation und Seiteninhalt fluchten im Standardraster.
## 10. Schnittstellen zum Mitgliederbereich ## 10. Schnittstellen zum Mitgliederbereich
@@ -125,3 +137,28 @@ ## 11. Veredelung mit Design-Skills (Empfehlung)
3. Themensignaturen als Symbolfamilie entwerfen (Design-Prinzipien §3, Zielkonzept §7.4), dann `--color-theme-*` und Symbole je Säule ergänzen. 3. Themensignaturen als Symbolfamilie entwerfen (Design-Prinzipien §3, Zielkonzept §7.4), dann `--color-theme-*` und Symbole je Säule ergänzen.
4. Hintergrundbilder: textfreie Zuschnitte der Originalmotive mit Fokuspunkt erzeugen (Hintergrundverarbeitung, `srcset`), sobald freigegeben. 4. Hintergrundbilder: textfreie Zuschnitte der Originalmotive mit Fokuspunkt erzeugen (Hintergrundverarbeitung, `srcset`), sobald freigegeben.
5. Sichtprüfung 390/768/1440 px und Kontrastmessung mit Prüfwerkzeug nach jeder Änderung an Markenwerten. 5. Sichtprüfung 390/768/1440 px und Kontrastmessung mit Prüfwerkzeug nach jeder Änderung an Markenwerten.
## 12. Breitenmodell (Designiteration 1)
| Stufe | Token | Wert | Abschnittsbreite im Editor | Einsatz |
|---|---|---|---|---|
| Lesebereich | `--width-reading` | 44 rem | `narrow` | lange Texte, Formulare |
| Standard | `--width-standard` | 82 rem | `standard` | Grundraster; Kopfzeile, Fußbereich und Inhalt fluchten hier |
| Breit | `--width-wide` | 96 rem | `wide` | bildstarke Kompositionen |
| Vollbreite | – | 100 % abzüglich Randabstand | `full` | Inhalt bis an den Rand |
Hintergründe reichen immer über die ganze Fensterbreite. `--frame-inset` = `max(Randabstand, (100 % − Standard) / 2)` steht für Inhalte in fensterbreiten Flächen bereit, ohne `100vw` (kein Scrollbalkenfehler). Die randlose Markenbühne der Designiteration 1 ist mit Kit v1.6 entfallen; der Premium-Einstieg ist eine Karte im Abschnitt. Die Schlüssel der Abschnittsbreiten sind gespeicherte Daten und bleiben unverändert; nur die Werte wurden angepasst (vorher 45/75/90 rem).
## 13. Premium-Widgets (Brand-UI-Kit v1.6, ADR-38)
Einstieg und Bild und Text verwenden die Komponenten aus `docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`, übernommen nach `resources/css/components/lf-hero.css` und `lf-bild-text.css` (über `app.css` geladen; das frühere Hero- und Bild-und-Text-CSS ist entfernt). Die Kit-Variablen `--lf-font-display`, `--lf-font-ui` und `--lf-muted` zeigen in `tokens.css` auf die gemeinsamen Werte. Nunito wird zusätzlich in Stärke 900 lokal ausgeliefert (Überschrift des Einstiegs).
| Paar | Kontrast |
|---|---|
| Label `#17370b` auf `#dff0c0` (Einstieg) | 10,9 : 1 |
| Weiß auf Grün dunkel (Schaltflächen) | 5,22 : 1 |
| Navy auf Creme / Weiß auf Navy (Flächen) | 14,0 / 15,1 : 1 |
| Fließtext `#46556b` auf Creme (Bild und Text) | 7,0 : 1 |
| Label `#295b08` auf Creme; `#fff2b0` auf Navy | 7,5 / 13,4 : 1 |
Bildmotive des Kits (`09_hero_widget/assets`, `10_bild_text_widget/assets`) sind für die öffentliche Verwendung nicht freigegeben; sie wurden nur lokal für die Sichtprüfung verwendet.
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,201 @@
# Lara & Felix – Ideen- und Entscheidungsstand zu Übungen, Trainingsplanung und Vermarktung
**Stand:** 16.11.2026
**Status:** Diskussionsstand / Zukunftskonzept – **kein** Implementierungsauftrag, **keine** Änderung des bestehenden MVP-Scope
**Zweck:** Die in der UX-/Prozessdiskussion neu entstandenen Ideen bewahren, ohne die unmittelbar anstehende Verbesserung der bereits implementierten Benutzeroberflächen zu verzögern.
> **Wichtig:** Dieses Dokument ersetzt weder `01_LUF_Zielbild_und_Fachkonzept_v1.1.md` noch `produktkonfiguration-und-mitgliederbereich.md` oder `trainingskonzept-und-produktstruktur.md`. Bestehende verbindliche Regeln behalten Vorrang. Neue Ideen sind ausdrücklich nach Entscheidungsstand gekennzeichnet. Vor einer späteren Implementierung werden nur die tatsächlich erforderlichen Änderungen am Fach- und Datenmodell geprüft.
## 1. Abgrenzung: Was ist jetzt zu tun – und was nicht?
### Unmittelbare Priorität: UX/UI für den vorhandenen MVP
Die nächste Iteration soll die **bereits implementierten Elemente** in einen verständlichen, zusammenhängenden Benutzerprozess überführen, statt neue Fachfunktionen vorzuziehen. Zu den vorhandenen Elementen zählen laut Abschlussbericht vom 16.11.2026 insbesondere:
- Medien und fachliche Inhalte sowie deren Fassungen;
- redaktionelle Stammdaten, Dimensionen und Vorschaubilder;
- fachliche Kompositionen, Module und Programme mit Versionierung und Freigaben;
- Lizenzartikel, Pakete, Rechteprofile und Angebote;
- geschützte Mitgliederbibliothek mit Programmen, Modulen, Material und Medienausgabe.
**UX-Ziel:** Ein fachlicher Betreiber kann vorhandene Inhalte suchen, anlegen, zu Modulen/Programmen kombinieren, strukturiert prüfen, freigeben und den Bezug zu Lizenzartikeln und Angeboten verstehen – ohne das zugrunde liegende Datenmodell kennen zu müssen. Als erster Referenzfall dient das bestehende **„Programm Abstand“**.
Der bestehende MVP ist technisch noch nicht vollständig abgenommen: Der Abschlussbericht dokumentiert unter anderem fehlendes Tor B und G9. Diese technische Restabnahme ist von der UX-Erprobung zu unterscheiden.
**Nicht Bestandteil der ersten UX-Iteration:** neuer Übungsarbeitsplatz, eigenständige Trainingsplan-Verwaltung, persönlicher Kursplaner, vollständiger Kursplayer mit Ablaufsteuerung, neues Freemium-/Abo-Modell und nicht vorhandene Shop-/CMS-Funktionen. Diese Ideen gehören in die spätere Produktentwicklung und dürfen nicht als stillschweigende MVP-Pflicht in den aktuellen Auftrag geraten.
### Vorgehensprinzip
Kleine, **durchgängig benutzbare vertikale Iterationen**: bereits vorhandene Fachregeln heranziehen → konkrete Aufgabe und Bedienweg knapp definieren → auf der Testinstanz umsetzen → durch den Betreiber selbst testen → gezielt verbessern. Keine erneute monatelange Gesamtplanung oder offene UX-Gates.
## 2. Bestand: Verbindliche fachliche Grundlage
Die folgenden Regeln sind bereits dokumentiert und dürfen nicht durch die neue Begriffsdiskussion versehentlich ersetzt werden:
| Gegenstand | Bisheriger Fachstand | Quelle |
|---|---|---|
| **Inhaltselement** | Film, PDF, Audio, Text, Anleitung usw.; stabile Identität und versionierte Inhalte | Zielbild `PROD-002`; Produktkonfiguration §2 |
| **Übung / Modul / Programm** | Frei komponierbare didaktische Einheiten ohne technisch erzwungene starre Hierarchie | Zielbild `PROD-001`; Trainingskonzept §4–6 |
| **Modul** | Eigenständig nutzbare didaktische Einheit mit möglichen Lernzielen, Medien, Übungen und Materialien | Produktkonfiguration §6 |
| **Programm** | Wiederverwendbare didaktische Zusammenstellung von Modulen und ggf. weiteren Inhalten; kein automatisch identisches Verkaufspaket | Trainingskonzept §4 und §6 |
| **Lizenzartikel** | Kleinste vom Betreiber ausdrücklich als eigenständig lizenzierbar definierte Einheit; kann einzelner Inhalt oder Komposition sein | Zielbild `PROD-003`; Produktkonfiguration §2/7 |
| **Bundle / Angebot** | Kommerzielle Zusammenstellung von Artikeln mit Preis, Rechten und Konditionen; unabhängig von der didaktischen Struktur | Zielbild `PROD-004` bis `PROD-008`; Produktkonfiguration §7 |
| **Wiederverwendung und Versionierung** | Keine Medienkopien je Verwendung; veröffentlichte, aufeinander abgestimmte Fassungen historisch stabil | Zielbild `VER-001` bis `VER-010` |
| **Persönliche Trainingsplanung** | Gespeicherte persönliche Kurssammlungen und didaktischer Spezialplayer ausdrücklich nicht als MVP entschieden | Produktkonfiguration §1, §7, §14 |
**Terminologischer Hinweis:** Der vorhandene technische `CompositionKind` mit dem Wert `uebung` darf nicht unbesehen mit dem hier neu präzisierten fachlichen Übungsobjekt gleichgesetzt werden. Ebenso bedeutet „Modul“ nicht automatisch „Lizenzartikel“.
## 3. Neu präzisiertes didaktisches Modell
**Status: Arbeitshypothese / fachliche Richtung; noch nicht als Änderung des normativen Fachkonzepts umgesetzt.**
### 3.1 Modul: kuratierter Werkzeugkasten
Aus Betreibersicht ist ein Modul typischerweise ein zusammengehöriger, professionell ausgearbeiteter Baukasten: Filme/Medien, Begleitmaterialien, Trainerinformationen, Methodenhinweise und ggf. Übungen. **Module sollen bevorzugt kommerziell vermarktbare Einheiten sein**, ohne dass jedes Modul zwingend ein Lizenzartikel wird.
Für einen erfahrenen Trainer kann eine kompakte Übersicht über Thema, Ziele, Inhalte und Materialien genügen. Ein anderer Trainer kann ausführliche Hinweise benötigen. Die UX sollte deshalb **Überblick und Vertiefung** ermöglichen, nicht eine starre Schritt-für-Schritt-Durchführung erzwingen.
### 3.2 Übung: konkrete, wiederverwendbare Methodik
Eine Übung beschreibt eine tatsächlich durchführbare Aktivität, etwa mit:
- Lernziel(en), Zielgruppe und Voraussetzungen;
- Einstieg und Durchführung;
- Moderations-/Reflexionshinweisen und typischen Schwierigkeiten;
- möglichen Varianten und Alternativen;
- erforderlichen oder optionalen Medien und Materialien;
- ggf. Zeitbedarf und Vorbereitung.
Übungen werden redaktionell vorbereitet, gespeichert und in unterschiedlichen Modulen bzw. Trainingsplan-Vorlagen wiederverwendet. Derselbe Film kann je nach Ziel als Einstieg, Fragestellung oder Reflexionsimpuls dienen; die Methodik ist nicht zwingend identisch.
**Illustratives Beispiel:** „Persönliche Grenzen erkennen“
- **Variante A – mit Medium:** Film „Lara im Park“ als Impuls, Denkpause, Gespräch und anschließendes Rollenspiel; geschützte Medienaktion nur mit entsprechender Berechtigung.
- **Variante B – ohne Medium:** geschilderte Alltagssituation, Gespräch oder Rollenspiel und Reflexion; kein Zugriff auf den kostenpflichtigen Film erforderlich.
Varianten sind alternative **gleichzeitig mögliche Durchführungen**, nicht automatisch verschiedene Fassungen einer Übung. Eine fachliche Überarbeitung der Übung selbst unterliegt hingegen der bestehenden Versionierungslogik.
**Offen:** Wie eine Übung im Detail gespeichert und freigegeben wird, wie frei bzw. geschützt einzelne Übungsinhalte sind und wie Varianten auf konkrete Medien-/Kompositionsfassungen verweisen. Dies **nicht** in der laufenden MVP-UX-Iteration neu implementieren.
### 3.3 Programm: didaktische Vorlage
Ein Programm stellt einen wiederverwendbaren didaktischen Zusammenhang und übergeordnete Ziele dar. Es kann mehrere Module oder andere Inhalte bündeln, ist **nicht gleichbedeutend mit einem kommerziellen Bundle** und muss auch nicht einer konkreten Durchführung entsprechen.
### 3.4 Redaktionelle Trainingsplan-Vorlage
Eine Trainingsplan-Vorlage zeigt einen **möglichen konkreten Einsatz** von Übungen und Modulen – z. B. eine 60-minütige Einheit für eine bestimmte Zielgruppe mit Reihenfolge, Zeitbedarf, Materialien, Alternativen und methodischen Hinweisen.
Sie kann auf einem Programm basieren oder unabhängig davon zusammengestellt werden. Die Vorlage ist weder die persönliche Durchführung noch notwendigerweise ein selbstständiger Verkaufsartikel. Sie kann dem Trainer als Orientierung dienen und auf die zur Umsetzung benötigten lizenzierten Module verweisen.
### 3.5 Persönlicher Trainingsplan und tatsächliches Training
- **Persönlicher Trainingsplan:** Ein Trainer übernimmt eine Vorlage oder stellt einen Ablauf für seine konkrete Gruppe selbst zusammen, passt Zeiten, Übungen und Materialien an und kann eigene Notizen hinterlegen.
- **Training / Durchführung:** Die reale Durchführung dieser Planung mit einer Gruppe. Eine mögliche spätere Dokumentation ist davon getrennt und braucht nicht automatisch personenbezogene Kinderdaten.
Der **persönliche Planer** und ein weitergehender didaktischer **Kursplayer** (z. B. automatische Denkpause, Ablauf-/Präsentationssteuerung) gehören zur späteren Ausbaustufe, nicht zum bestehenden MVP.
## 4. Website, Nutzerreise und Vermarktungsfunktion
**Fachlich angestrebte Richtung:** Trainingsplan-Vorlagen und authentische Erfahrungsberichte können auf der öffentlichen Website demonstrieren, wie die Methode in der Praxis eingesetzt wird. Eine „kleine Reise durch die Nutzung“ führt vom Trainingsanlass über beispielhafte Übungen und Materialien zu den tatsächlich benötigten Modulen und Angeboten.
Mögliche öffentliche Darstellung:
1. Problem/Anlass und Lernziele verständlich vorstellen;
2. ausgewählte Ablaufabschnitte, Film-Teaser oder Methodenausschnitte zeigen;
3. echte Praxisbeispiele und Erfahrungsberichte mit Zustimmung der Beteiligten darstellen;
4. benötigte Module und Materialien transparent nennen;
5. passende Lizenzangebote und alternativ die persönlichen Gewaltschutzkurse des Betreibers aufzeigen.
**Leitplanke:** Eine öffentlich gezeigte Trainingsplan-Vorschau schaltet keine geschützten Medien, vollständigen Trainerunterlagen oder anderen Premiuminhalte frei. Marketingdarstellung, didaktische Zusammenstellung, Lizenzartikel und konkrete Nutzungsrechte bleiben getrennt – mit gemeinsamer Datenbasis, damit Informationen nicht mehrfach inkonsistent gepflegt werden.
## 5. Kostenloser Einstieg: 60-Minuten-Demo
**Status: konkret befürwortete Angebotsidee, aber nicht Teil des aktuellen MVP-UX-Auftrags.**
Ein kostenlos registriertes Mitglied soll perspektivisch mit einem **vollständig durchführbaren, etwa einstündigen Demo-Trainingsplan** beginnen können. Die benötigten ausgewählten Demo-Module werden dazu in einem passenden kostenfreien Angebot zugänglich gemacht.
- Filme grundsätzlich **nur geschützt streambar**, ohne allgemeines Film-Downloadrecht;
- Vorführung im Kurs muss zum tatsächlich gewährten Nutzungszweck passen;
- notwendige Ausdrucke/Begleitmaterialien müssen entweder entbehrlich oder ausdrücklich passend freigegeben sein;
- der Kurs muss fachlich vollständig und sinnvoll sein, nicht eine künstlich beschnittene Demonstration;
- vertiefende Module, Programme und zusätzliche Nutzungsrechte bieten weiterführenden Mehrwert.
Die Website soll den Demo-Plan verständlich vorstellen und zur kostenlosen Registrierung sowie später zu passenden Zusatzmodulen führen.
**Noch zu klären, bevor dieses Angebot wirklich veröffentlicht wird:** konkreter Umfang, zulässige Nutzungszwecke (auch kommerzielle Kurse?), etwaige Gültigkeit und welche Begleitmaterialien heruntergeladen werden dürfen. Das technische Grundprinzip kostenloser Grants und differenzierter Medienrechte ist bereits fachlich vorgesehen.
## 6. Know-how-Schutz und Geschäftsmodell – noch nicht abschließend entschieden
**Wichtige neue strategische Erkenntnis:** Der Betreiber bietet selbst persönlich durchgeführte Gewaltschutzkurse an und möchte sich als Gewaltschutztrainer positionieren. Andere Trainer sind daher zugleich Kunden und mögliche Wettbewerber.
Das wertvolle eigene Know-how liegt **nicht nur in Filmen und PDFs**, sondern auch in Übungen, Moderation, methodischen Varianten, konkreten Ablaufplänen, Best Practices und ausgearbeiteten Gesamtkonzepten. Ein vollständiges kostenloses Ausrollen aller Pläne und Anleitungen könnte das eigene Dienstleistungsgeschäft schwächen.
### Entwicklung der Diskussion – keine fälschliche Endentscheidung
1. **Frühe Idee:** Trainingsplan-Vorlagen und Übungen grundsätzlich frei; Vermarktung vorrangig über Medien und Module.
2. **Erweiterte Überlegung:** Ein echter kostenloser Demokurs mit ausgewählten Streamingmodulen als niedrigschwelliger Einstieg.
3. **Jüngste Gegenüberlegung:** Nicht der gesamte Methoden- und Planungsfundus sollte kostenlos verfügbar sein. Umfangreiche Durchführungspläne, Trainer-Best-Practices und professionelle Materialien könnten nur innerhalb erworbener Module/Programme zugänglich sein. Eine übergreifende Fachbibliotheks-Lizenz ist eine denkbare spätere Option.
**Aktueller Entscheidungsstand:** Die Frage **„Welche Übungen, Pläne und Methodendetails sind öffentlich, für kostenlose Mitglieder bzw. nur mit erworbenen Rechten verfügbar?“ ist noch offen.** Die frühere Aussage „alle Übungen und Trainingspläne kostenlos“ ist **keine verbindliche aktuelle Festlegung**. Auch eine eigenständige Pflichtlizenz für alle Trainingspläne ist **nicht** beschlossen.
Als **Arbeitshypothese**, nicht als Regel:
| Ebene | Möglicher Zugang | Mögliche Rolle |
|---|---|---|
| Öffentliche Website | Teaser, Methode, ausgewählte Planabschnitte, Beispiele, echte Erfahrungsberichte | Vertrauen, Auffindbarkeit, eigener Kursvertrieb und digitale Vermarktung |
| Kostenlose Mitgliedschaft | Vollständig nutzbarer Demo-Plan, ausgewählte kostenlose Übungen und notwendige Demo-Medienrechte | Praxisnutzen erlebbar machen |
| Erworbene Module/Programme | Erweiterte Medien, vollständige Anleitungen, passende Ausführungspläne und Methoden | Kommerzieller Kern |
| Optionaler umfassender Zugang | Breitere Fachbibliothek mit vielen Plänen/Methoden | Spätere zu prüfende Produktvariante |
Rechtliche Schutzfähigkeit von konkreten Werken, Methoden und Know-how sowie angemessene Nutzungsbedingungen sind **separat zu prüfen**; die bloße Zugangssperre erzeugt kein allgemeines Ausschließlichkeitsrecht an pädagogischen Methoden.
## 7. Spätere UX-/UI-Anforderungen aus diesen Ideen
Dies sind **Hinweise für spätere Iterationen**, keine sofort zu implementierende Oberfläche:
| Anwender | Aufgabe | Mögliche UX-Anforderung |
|---|---|---|
| Redaktion | Übung erstellen und in mehreren Kontexten nutzen | Wiederverwendbare Übung, gemeinsame Hinweise, alternative Methoden und referenzierte Materialien einfach pflegen |
| Redaktion | Trainingsplan-Vorlage aufbauen | Zeitlicher Ablauf, Übungen/Varianten, benötigte Medien, Alternativen und Trainerhinweise verständlich zusammenstellen |
| Redaktion/Marketing | Öffentliche Vorschau gestalten | Offen zugängliche Teaser vs. geschützte fachliche Details eindeutig unterscheiden |
| Betreiber | Free-/Premium-Zugang steuern | Zugangsregeln am realen Inhalt verständlich darstellen, nicht technische Grant-Tabellen im Vordergrund |
| Mitglied | Geeignete Übungsvariante finden | Verfügbarkeit und notwendige Rechte je Alternative verstehen; ohne Berechtigung sinnvolle Wege erkennen |
| Trainer | Trainingsplan für eigene Gruppe übernehmen | Vorlage adaptieren, ohne Original oder erworbene Rechte zu verändern |
| Interessent | Vom Praxisbeispiel zum passenden Inhalt gelangen | Tatsächlich benötigte Module und Nutzen des Erwerbs im Zusammenhang sehen |
**UX-Prinzip:** Professionelle Trainer brauchen einen schnellen kompakten Überblick; detaillierte methodische Hinweise sollen bei Bedarf zugänglich sein. Ein starres Pflichtschema „Einstieg → Film → Gespräch → Übung → Abschluss“ wird nicht vorausgesetzt.
## 8. Konsequenzen für Datenmodell und Architektur – ausdrücklich vertagt
Aus den neuen Überlegungen könnten später zusätzliche Fachobjekte oder Beziehungen folgen, beispielsweise:
- explizite Übung mit Durchführungsvarianten;
- redaktionelle Trainingsplan-Vorlage mit konkreter zeitlicher Struktur;
- persönlicher Trainingsplan als Kopie/Ableitung einer Vorlage;
- abweichende Zugangstiefen für öffentliche Vorschau, kostenlose Inhalte und vollständige Fachanleitungen;
- Transparenz darüber, welche Module/Medien eine Variante benötigt.
**Noch keine Entscheidung**, ob hierfür Tabellen/Modelle ergänzt oder bestehende Kompositionen, Inhaltsfassungen und Lizenzregeln genutzt werden. Das wird erst bei der passenden späteren Implementierungsiteration gezielt geprüft. Es darf nicht rückwirkend die aktuelle UX-Verbesserung des bestehenden MVP blockieren.
## 9. Fokus und nächster umsetzbarer Schritt
**Jetzt:** Die bestehenden Elemente (Medien, Module, Programme, Fachliche Kombinationen, Freigaben, Lizenzartikel, Pakete, Rechteprofile, Angebote und Mitgliederbibliothek) auf einen **klaren redaktionellen und kommerziellen Workflow** abbilden. Benutzerbegriffe, Kontext, Suche, Zusammenstellung, Vorschau, Freigaben und Übergänge so gestalten, dass das bestehende Testprogramm „Abstand“ ohne Spezialwissen aufgebaut, verstanden und administriert werden kann.
**Erster praxisnaher Prüffall:** Der Betreiber öffnet „Programm Abstand“, versteht die Struktur, kann enthaltene Module und Medien finden, sinnvoll bearbeiten oder neu zuordnen, Vorschau/Freigabe nachvollziehen und anschließend erkennen, wie das Programm mit einem Lizenzartikel und einem Angebot zusammenhängt. Die Benutzbarkeit wird **durch den Betreiber auf der Testinstanz** beurteilt, nicht allein durch Code- oder UI-Snapshot-Tests.
**Später:** Übungsvarianten, Trainingsplan-Vorlagen, Demoangebot, eigene Trainingsplanung und abgestufte Veröffentlichung nach den dann ausdrücklich getroffenen Entscheidungen iterativ entwickeln.
---
## 10. Quell- und Nachweisbasis
Die bestehenden fachlichen Regeln und der aktuelle Implementierungsstand wurden gegen die vorliegenden Projektunterlagen abgegrenzt:
- `01_LUF_Zielbild_und_Fachkonzept_v1.1.md` (fortgeschrieben 14.11.2026), insbesondere `VIS-004`, `WEB-001` bis `WEB-005`, `PROD-001` bis `PROD-008`, `LIC-001` bis `LIC-003`, `VER-001` bis `VER-010`.
- `trainingskonzept-und-produktstruktur.md`, insbesondere §§4–9 zur Begrifflichkeit, flexiblen Trainingsstruktur und Vermarktung.
- `produktkonfiguration-und-mitgliederbereich.md` (15.11.2026), insbesondere §§1–2, 6–7, 12–14.
- `03_LUF_Pruefszenarien_v1.1.md`, insbesondere SC-01 bis SC-11 und SC-16 bis SC-20.
- `abschlussbericht-mvp-2026-11-16.md`, insbesondere implementierte Pakete und zurückgestellte Funktionen.
- Fachliche Diskussion vom 16.11.2026 zu Übung, Modul, Programm, Trainingsplan, kostenfreier Demo und Schutz des eigenen Methoden-Know-hows. Die neuen Aussagen sind **als solche** gekennzeichnet und nicht nachträglich den alten Dokumenten zugeschrieben.
**Dokumentenpflege:** Dieses Papier kann später als Entscheidungs- und Ideenbasis in `docs/fachkonzept/` oder `docs/strategie/` des Repositories übernommen werden. Es ist gegenwärtig ausschließlich eine separate Notiz und wurde nicht im Repository eingepflegt.
@@ -0,0 +1,70 @@
# Lara & Felix – Architekturabgleich Produktkonfiguration und Mitgliederbereich
**Stand:** 15.11.2026
**Status:** Gezielter Abgleich der vorhandenen *fachlichen und konzeptionellen Dokumente*. **Keine** Codeprüfung und kein E2E-Test.
## 1. Geprüfte Ausgangsdokumente
- `01_LUF_Zielbild_und_Fachkonzept_v1.1.md`, insbesondere PROD-001 bis PROD-008 und LIC-001 bis LIC-007
- `04_Domaenenmodell(2).md`, insbesondere §§1–5
- `05_Lizenz_und_Berechtigungslogik(2).md`, insbesondere §§1–4
- `08_Medien_Streaming_Kennzeichnung.md`, §§1 und 3
- `09_CMS_Administration_Community(2).md`, A.3–A.5
- `16_MVP_Slice(1).md`, §§2–3
- `trainingskonzept-und-produktstruktur.md`, §§4–10
- `design-prinzipien.md`, insbesondere UX/Player
Die frühere mündlich zusammengefasste Code-Audit-Sichtung reicht nicht aus, um aktuelle Repository-Dateien zu verifizieren. Aus diesem Bericht folgt keine Aussage, dass eine Änderung bereits implementiert wurde.
## 2. Konkrete Abweichungen
| ID | Befund | Quelle und Fundstelle | Erforderliche Anpassung |
|---|---|---|---|
| **A01 – Konflikt** | Artikel-Titel, Kurzbeschreibung, Zielgruppe und Lernziele sind in der bisherigen Zuordnung pauschal am Artikel-Stand verortet; redaktionelle Änderung wird mit Artikel-Veröffentlichung gekoppelt. | `09`, A.4 „Wo liegt welcher Text?“ | Redaktionelle **Anzeige- und Suchdaten** an stabilen fachlichen Identitäten führen und ohne neuen Inhaltsrelease aktualisieren. **Lehrinhalt und Lernzieltexte** weiterhin fachlich versionieren. Vertragsrelevante Daten und Kaufkopie fixiert lassen. |
| **A02 – Erweiterung** | `ASSET_VERSION.metadaten` umfasst heterogene Beispiele (Dauer, Sprungmarken, Lernziele). Konfigurierbare Dimensionen und direkte Zuordnung zu Programmen/Modulen sind in der Modellskizze nicht ausreichend ausgedrückt. | `04`, §2 | Feldverantwortung trennen: aktuelle redaktionelle Metadaten, fassungsspezifische technische Daten und didaktische Inhaltsdaten. Konfigurierbare Dimensionen mit direkter Zuordnung zu Assets **und** Kompositionen vorsehen. |
| **A03 – Erweiterung** | Vorschaubilder entstehen grundsätzlich als Medienableitung, aber gezielte Videoframe-Auswahl, eigenständige Pflege aller fachlichen Objektarten und öffentliche Freigabe sind nicht ausformuliert. | `08`, §1 | Frame-Auswahl mit Filmvorschau und Zeitposition, Upload/Override, Bildformate, Alt-Text und öffentliche/geschützte Sichtbarkeit ergänzen; ohne Filmneuversion. |
| **A04 – Konflikt zur neuen Priorisierung** | MVP-Bibliothek wird vornehmlich als „Materialien je Lizenzartikel“ beschrieben. | `16`, §3.1 Bibliothek | Zugängliche **fachliche Bibliothek** mit Programmen, Modulen, Einzelmaterialien, Suche und konfigurierbaren Filtern zum MVP-Pflichtumfang machen. Lizenzartikel im Backend für Berechtigungen beibehalten. |
| **A05 – Präzisierung** | Bestehende Regeln zu Wiederverwendung und „nicht mehrfach in der Bibliothek“ sind zu allgemein. | `trainingskonzept-und-produktstruktur.md`, §§5 und 9; `04`, §2 | Mehrfaches Vorkommen innerhalb **jedes** Programms ausdrücklich fordern. Deduplizierung nur übergreifend für dieselbe stabile Einzelidentität; unterschiedliche Fassungen korrekt kenntlich machen. |
| **A06 – Prioritätskonflikt** | Automatische Denkpause, Sprungmarkensteuerung und weitergehender Player erscheinen im ursprünglichen MVP-Schnitt bzw. Medienzielbild als früh verfügbare Funktionen. | `08`, §3.3; `16`, §§2–3; `design-prinzipien.md` | Einfache geschützte Medienwiedergabe P0; spezialisierter Kursplayer mit automatischer Denkpause, didaktischer Ablaufsteuerung und Präsentationsmodus **Add-on**. Felder für künftige Zeitmarken dürfen bestehen bleiben. |
| **A07 – Funktionslücke** | CMS-Artikelkarten und Katalogbausteine existieren konzeptionell; vollständige Modul-/Programmdetails mit verschachtelter Struktur, Kontextrollen und partiellen Zugriffen sind nicht hinreichend konkret. | `09`, A.3; `trainingskonzept`, §§6/9 | Verschachtelte Detailansichten, Modulrollen, Rechtezustände und klare fachliche Typen spezifizieren und E2E prüfen; PDF nicht als „Kurs“ darstellen. |
| **A08 – Bedienlücke** | Der Kompositions-/Angebotszusammenhang kennt die Abdeckungsprüfung und „Paket aus Komposition vorschlagen“, aber der redaktionelle Gesamtablauf ist nicht ausreichend prüfbar. | `04`, §3.1 | Geführte Bearbeitung von Asset → Komposition → Artikel/Bundle → Offer; getrennte Vorschau von Mitgliederdarstellung, didaktischem Inhalt und lizenziertem Angebotsumfang. |
| **A09 – Abgrenzung** | CMS-Seiten brauchen Revision und Publikationsprozess; neue redaktionelle Inhaltsstammdaten sollen unmittelbar wirksam werden. | `09`, A.5; neue Fachspezifikation §4 | Beide Prozesse getrennt halten: CMS-Entwurf/Veröffentlichung beibehalten; reine Inhaltsstammdaten speichern + Audit, ohne Asset-/Artikel-Release. |
| **A10 – Beibehalten** | Veröffentlichung fixiert konkrete Fassungen, Rechte werden quellengebunden je Aktion geprüft, Angebotsfassungen bleiben unveränderlich. | `04`, §§2–5; `05`, §§1–4 | **Kein Rückbau.** Neue redaktionelle Stammdaten dürfen niemals die `ARTICLE_RELEASE`-/`RELEASE_CONTENT`-/`ORDER_SCOPE_ITEM`-Historie oder serverseitige Zugriffsentscheidung umgehen. |
| **A11 – Prüfung weiterer Dokumente** | Die P0-/Add-on-Grenze könnte auch in Versions-, Test- und Roadmap-Dokumenten referenziert werden. | Querverweise aus `04`, `08`, `16` auf `06`, `03`, `15` | Vor Implementierungsauftrag die einschlägigen Abschnitte dieser Dokumente zusätzlich gezielt lesen und nur tatsächliche Widersprüche ändern. Für sie wird hier **keine vollständige Prüfung behauptet**. |
## 3. Reihenfolge der Dokumentanpassungen
1. **`04_Domaenenmodell(2).md`:** Redaktionsstammdaten, Facetten und Thumbnail-Beziehungen im konzeptionellen Modell präzisieren. Freigabe-/Rechteinvarianten unverändert.
2. **`09_CMS_Administration_Community(2).md`:** Herkunft und Publikationsregeln für aktuelle redaktionelle Titel/Beschreibungen/Thumbnails von versionierten fachlichen Lernzielen und verbindlichen Angebots-/Bestelltexten trennen.
3. **`08_Medien_Streaming_Kennzeichnung.md`:** Video-Frame als Thumbnail und seine Zugriffsklasse ergänzen; didaktische Playerfunktionen als Add-on kennzeichnen, normale Wiedergabe erhalten.
4. **`16_MVP_Slice(1).md`:** Mitgliederbibliothek als eigenständig nutzbares P0-Produkt mit Suche/Filtern, Modul-/Programmansichten, korrekter Mehrfachverwendung und einfachen Medienaktionen beschreiben.
5. **`trainingskonzept-und-produktstruktur.md`:** Deduplizierungsregel kontextbezogen präzisieren und technische Player-Priorität aktualisieren; pädagogische Methode nicht ändern.
6. **`design-prinzipien.md`:** Terminologie und zeitliche Priorisierung des optionalen Players angleichen; die verbindlichen qualitativen UX-Anforderungen beibehalten.
7. **Weitere Referenzdokumente:** `06` Veröffentlichung, `03` Tests und Roadmap `15` auf dieselben Widersprüche prüfen, bevor ein verbindlicher Entwicklungsauftrag formuliert wird.
## 4. Unverzichtbare Architekturgrenzen
- **„Metadaten ohne Versionierung“ bedeutet keine Überschreibung des Lehrinhalts.** Ändert sich die Filmdatei, Übungsanleitung oder die Mitgliedschaft/Reihenfolge einer Komposition, wird weiterhin neu versioniert.
- **Deduplizierung der Einzelbibliothek bedeutet nicht Auslassung im Programm.** Programm A und B zeigen beide dieselbe ihnen zugeordnete Datei; die Materialübersicht zeigt eine stabile Einzelidentität.
- **Vollständig nutzbares Programm bedeutet nicht Programmkauf.** Es können mehrere getrennte, kompatible Berechtigungen sämtliche Bestandteile abdecken; die Kaufhistorie bleibt korrekt.
- **Direkte Säulen am Programm sind keine automatisch aggregierten Film-Tags.** Beide Informationen bleiben unterscheidbar.
- **Thumbnail aus Film ist kein öffentlicher Film- oder Bildfreigabeautomatismus.**
- **Kursplayer als Add-on entbindet nicht von sicherem Streaming und einem üblichen Player.**
- **Preise und Rechte sind keine frei veränderlichen CMS-Texte.** Der Bestell-/Vertragssnapshot darf nicht indirekt überschrieben werden.
- **Einzelne Berechtigungen dürfen nicht zu stärkeren Gesamtberechtigungen kombiniert werden.**
## 5. Erforderliche lesende Codeprüfung vor Umsetzung
Vor Codeänderungen soll der Coding-Agent Folgendes am tatsächlichen Repository nachweisen:
- Modell-/Tabellenverantwortung für Titel, Beschreibungen, Thumbnails, Säulen und fassungsspezifische Daten.
- Direkte Zuordnung von Fachdimensionen zu Asset **und** Komposition; Herkunft abgeleiteter Facetten.
- Reale Kompositionsauflösung bis zu beliebigen Unterebenen, mit Kontextrolle und Reihenfolge.
- Zwei Programme mit gemeinsamem Film und PDF; Deduplizierung in der Einzelbibliothek, nicht innerhalb der Programme.
- Rechteprüfung für Stream, Browser-Dokumentanzeige und Download an echten Dateien statt nur UI-Buttons.
- Medienablage/Thumbnail-Ableitungsprozess und öffentliche/geschützte Sichtbarkeit.
- Aktuelle Publikationsgates für reine redaktionelle Änderungen.
- Tatsächliche Funktionen und Kosten des bisherigen Players, damit nur die didaktischen Add-ons zurückgestellt werden.
- E2E-Tests für komplexe Programme, partielle Rechte und historische Fassungen; keine Scheintests durch reines Überschriftenrendering.
**Ergebnis dieses Dokuments:** Fachliche Soll-Abweichungen sind benannt. Der technische Änderungsumfang und konkrete Migrationen können erst nach dieser lesenden Bestandserhebung seriös festgelegt werden.
@@ -0,0 +1,218 @@
# Lara & Felix – Produktkonfiguration und Mitgliederbereich
**Stand:** 15.11.2026
**Status:** Konsolidierte fachliche Soll-Spezifikation; vor Implementierung mit bestehender Architektur abzugleichen
**Zielpfad:** `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md`
## 1. Zielbild und Priorität
Die Plattform „Lara & Felix – Stark im Alltag“ unterstützt erwachsene Trainer und pädagogische Fachkräfte beim Auffinden, Vorbereiten und Verwenden von didaktischen Trainingsmaterialien. Fachliche Struktur, technische Medien und kommerzieller Lizenzumfang sind unabhängig voneinander zu verwalten.
**MVP-Pflicht ist eine professionelle, vollständig nutzbare Mitgliederbibliothek.** Programme, Module, Übungen, Filme, Traineranleitungen, Merkblätter und sonstige Materialien müssen durchsuchbar, filterbar, fachlich unterscheidbar und innerhalb ihrer jeweiligen Zusammenhänge nutzbar sein. Eine flache Liste von Lizenzartikeln oder Dateinamen ist kein gleichwertiger Ersatz.
**P0/MVP:** konfigurierbare Fachdimensionen; fachliche Stammdaten; Thumbnails; Einbindung wiederverwendbarer Materialien in Modulen und Programmen; konfigurierbare Lizenzartikel/Pakete/Angebotsvarianten mit Preisen; Mitgliederbibliothek; Suche/Filter; Modul-/Programmdetails; berechtigtes Dokumentansehen und -laden; einfaches geschütztes Videostreaming; Redaktionsvorschau und Auditierung.
**Späteres Add-on:** spezialisierter Kursplayer mit automatischer Denkpause, vorgegebener Ablaufsteuerung, Präsentations-/Trainermodus, Fortschrittsverfolgung oder synchronisiertem Zweitgerät. Übliche Videofunktionen wie Abspielen, Pause, Zeitsuche und Vollbild bleiben Bestandteil des MVP. Eine didaktische Denkpause ist als **Methode** weiterhin relevant, aber nicht als zwingende automatische Playerfunktion.
## 2. Fachliches Objektmodell
| Ebene | Objekt | Fachliche Aufgabe |
|---|---|---|
| Inhalt | Asset/Inhaltselement | Stabile Identität von Film, PDF, Audio, Text, Aufgabe usw. |
| Versionierter Inhalt | Asset-Version | Konkrete unveränderliche Datei bzw. Lehrinhaltsfassung |
| Didaktik | Komposition | Stabile Identität einer Übung, eines Moduls, Programms oder einer anderen frei definierten Zusammenstellung |
| Didaktische Fassung | Kompositionsversion | Geordnete Verweise auf konkrete Fassungen anderer Inhalte und Kompositionen; Rolle je Verwendung |
| Redaktion | Fachdimensionen und Stammdaten | Beschreibung, Auffindbarkeit und visuelle Darstellung stabiler Identitäten |
| Lizenzierung | Lizenzartikel / Artikel-Stand | Vom Betreiber festgelegte kleinste Lizenzierungseinheit / freigegebener, fixierter Leistungsstand |
| Kommerzielles Angebot | Paket, Angebot, Angebotsfassung, Rechteprofil | Artikelumfang, Preise, Laufzeiten, Nutzungsrechte, Bedingungen |
| Berechtigung | Erwerb und Grant | Individuelle Rechtequelle, zugehöriger Artikel und wirksame Aktionen |
**Es gibt keine technische Pflicht-Hierarchie** „Film → Übung → Modul → Programm → Paket“. Ein einzelner Film kann eigenständig lizenziert sein, ein Modul eine kommerziell unteilbare Einheit bilden, oder mehrere Module können als getrennte Lizenzartikel in einem Programmangebot verkauft werden. Die Artikelgrenze wird ausdrücklich vom Betreiber definiert. Der Preis gehört zur **Angebotsfassung**, nicht zum Inhalt oder Themenbereich.
Wiederverwendung bedeutet Verlinkung derselben stabilen Identität und gegebenenfalls derselben fachlichen Fassung, **nicht** das Anlegen neuer Medienkopien. Zirkuläre Kompositionen und Pakete sind auszuschließen. Veröffentlichte Fassungen und die aufgelösten Inhalte eines Artikel-Stands bleiben unveränderlich.
## 3. Konfigurierbare, mehrdimensionale Fachklassifikation
Der Betreiber kann Fachdimensionen und ihre Werte ohne Programmierung pflegen: stabile Kennung, Name, Beschreibung, Aktivierung/Archivierung, Reihenfolge, zugelassene Objekttypen, Einfach- oder Mehrfachauswahl und Verwendung als Suchfilter. Das Umbenennen eines Werts ändert nicht seine Identität. Ein noch verwendeter Wert darf nicht folgenlos gelöscht werden.
Initiale Dimensionen: **fachliche Säulen/Themenbereiche**, Altersbereich/Zielgruppe, fachliche Inhaltsart (z. B. Film, Merkblatt, Traineranleitung, Übung, Modul, Programm), Einsatzbereich und Schlagwörter. Erweiterungen müssen ohne Codeänderung möglich sein. Die fünf gegenwärtigen Säulen sind konfigurierbare Startwerte, keine fünf technisch fest codierten Verkaufssparten:
1. Meine Grenzen – Ich darf Nein sagen
2. Sicher handeln im Alltag
3. Geheimnisse, Vertrauen und Hilfe holen
4. Freundschaft, Selbstbehauptung und Zivilcourage
5. Streit, Bedrängung und Konflikte bewältigen
**Zuordnung muss an Assets, Übungen, Modulen und Programmen unmittelbar möglich sein.** Eine Zuordnung nur auf Medienebene genügt nicht. Direkte redaktionelle Zuordnungen und für die Suche aus enthaltenen Elementen abgeleitete Zuordnungen sind voneinander unterscheidbar. Eine Ableitung ersetzt die direkten Tags nicht. Fachdimensionen erzeugen **niemals** Zugriffsrechte.
Die Rolle eines Mediums innerhalb eines Moduls (z. B. „Gesprächseinstieg“ oder „Reflexionsbeispiel“) ist Eigenschaft seiner **konkreten Verwendung in der Komposition**, nicht ein globales Attribut des Mediums. Dasselbe Video darf in unterschiedlichen Modulen verschiedene Rollen haben.
## 4. Redaktionelle Stammdaten ohne unnötige Inhaltsversionen
Die Daten werden in drei strikt getrennte Klassen aufgeteilt:
| Klasse | Beispiele | Änderungsregel |
|---|---|---|
| **A – Aktuelle Anzeigedaten** | Anzeige-Titel, Kurzbeschreibung, redaktionelle Beschreibung, Thumbnail und Alternativtext, Säulen, Tags, informative Alterszuordnung, Suchattribute | Direkt speichern und sofort aktualisieren; **kein** neuer Asset-, Kompositions- oder Artikel-Release; nachvollziehbares Änderungsprotokoll |
| **B – Fachlicher Lehrinhalt** | Film-/Dokumentdatei, eigentliche Übungsanweisung, didaktische Lernzieltexte, Unterrichtsfragen, verbindliche Kompositionsmitglieder, Reihenfolge, kontextuelle Rollen, fassungsgebundene Zeitmarken | Neue Inhalts- oder Kompositionsfassung mit vorhandener Prüfung und Veröffentlichung |
| **C – Kommerziell/verbindlich** | Preis, Rechteprofil, Vertrags-/Angebotsversprechen, Laufzeit, Bedingungen, aufgelöster Kaufumfang, Bestellbezeichnung | Neue Angebotsfassung; frühere Angebots- und Bestell-Snapshots bleiben fixiert |
Insbesondere muss die Verwaltung **freie Beschreibungsfelder** von **normativen Lehranweisungen** unterscheiden. Eine Änderung der Kurzbeschreibung ist Klasse A, eine neue fachliche Anweisung Klasse B. Eine korrigierte allgemeine Altersempfehlung kann A sein; eine Änderung, die ein verbindliches Leistungsversprechen berührt, erfordert zusätzlich Klasse C. Der zuständige Datenbereich muss für die Redaktion erkennbar sein.
Das Ändern eines gegenwärtigen Anzeigetitels darf **nicht** einen historischen Kauf, Rechnungs- oder Ausgabenachweis rückwirkend umbenennen. Auditinformationen für Klasse A enthalten Bearbeiter, Zeit und Änderung; UI-Caches und Suchindizes sind zu aktualisieren. Das eigenständige Entwurfs-/Publikationsmodell für CMS-Seiten bleibt davon unberührt.
## 5. Thumbnails für alle darstellbaren Inhalte
Jedes Asset, jede Übung, jedes Modul und jedes Programm kann ein **eigenes Vorschaubild** erhalten. Falls ein eigenständiger Lizenzartikel redaktionell anders präsentiert werden muss, kann auch dieser eine geeignete Bildzuordnung besitzen. Bei fehlender Zuordnung wird eine neutrale, passende Fallback-Grafik verwendet.
**Bearbeitungsoptionen:**
- Eigenes Bild hochladen bzw. vorhandenes geeignetes Bild wählen.
- Bei Videos: konkrete Filmfassung öffnen, gewünschten Zeitpunkt visuell auswählen, Frame extrahieren und als Thumbnail übernehmen. Zeitposition und Vorschau müssen zusammenpassen.
- Bei Kompositionen: optional ein Bild aus enthaltenen Medien als Vorschlag übernehmen; eine explizit gesetzte Bildwahl hat Vorrang.
- Alternativtext pflegen; Vorschaubild in echten Kartenformaten prüfen; optimierte Größen erzeugen.
Thumbnails sind eigenständige redaktionelle Bildableitungen und können ohne neue Film-/Inhaltsfassung geändert werden. Der Originalfilm und seine Prüfsumme bleiben unverändert. Bildverarbeitungsfehler führen zu einem erklärten Fehlerzustand und einem Fallback statt zu einer kaputten Karte.
**Öffentliche Sichtbarkeit ist gesondert zu regeln:** Ein aus einem geschützten Film extrahierter Frame ist nicht automatisch als frei sichtbares Marketingbild freigegeben. Interne und öffentliche Vorschaubildverwendungen sind zu unterscheiden.
## 6. Fachliche Module und Programme
### Module
Ein Modul ist eine eigenständig verwendbare didaktische Einheit mit eigenen Stammdaten und optional Lernzielen, Vorbereitung, Materialbedarf, Zeitbedarf sowie zusammengehörenden Materialien. Es kann Film, Text, Übung, Traineranleitung, Reflexion und Merkblatt enthalten, muss aber **keinen** bestimmten Typ enthalten. Die veröffentlichten Mitglieder und ihre konkrete Reihenfolge werden in einer Kompositionsfassung fixiert.
### Programme
Ein Programm besitzt eigene Metadaten, ein übergeordnetes Trainingsziel und eine strukturierte Zusammenstellung von Modulen, Unterkompositionen und gegebenenfalls programmspezifischen Materialien. Es kann mehrere Säulen umfassen und dieselben Module wie andere Programme nutzen. Reihenfolge und fachliche Mitgliedschaft sind versioniert; rein beschreibende Stammdaten nicht.
### Verbindliche Regel zur Mehrfachverwendung
**Ein Inhalt, der zu mehreren Programmen eines Nutzers gehört, wird innerhalb *jedes* dieser Programme und an seiner dort definierten Position angezeigt.** Dies gilt gleichermaßen für Filme, Merkblätter, Übungen und komplette Module. Die Anzeige in einem Programm darf nicht verschwinden, weil derselbe Inhalt bereits an anderer Stelle verwendet wird.
**Nur in programmübergreifenden Einzelinhaltslisten** wird derselbe fachliche Inhalt nach **stabiler Identität** dedupliziert: ein Merkblatt, das in drei Programmen vorkommt, hat dort eine eigene Karte, innerhalb der drei Programme aber drei kontextuelle Vorkommen. Gleichlautende Titel unterschiedlicher Identitäten bleiben getrennt. Bei verschiedenen historischen Fassungen derselben Identität darf die Darstellung deren Unterschiede nicht verschweigen; die Verwendungsstellen behalten die jeweils referenzierte Fassung.
„Verwendet in“ zeigt rückwärts die betroffenen Module und Programme. Mehrfache Anzeige begründet weder weitere Käufe noch neue Berechtigungen.
## 7. Konfigurierbare kommerzielle Produkte
Der Betreiber kann ohne Programmierung lizenzierbare Einheiten bilden aus einzelnen Medien, Texten, Übungen, Modulen oder ganzen Programmen; ein Programm kann alternativ durch mehrere separate Artikel gedeckt sein. Aus Artikeln und verschachtelten Paketen werden Angebote mit unterschiedlichen Rechteprofilen, Preisen und Laufzeiten gebildet.
Ein Angebot muss vor Aktivierung prüfen, ob die beworbene fachliche Zusammenstellung tatsächlich durch die enthaltenen Lizenzartikel abgedeckt ist. Ausschlüsse werden ausdrücklich kenntlich gemacht. Die Rechteprofile unterscheiden Nutzungszweck und technische Aktionen **je Ausgabeklasse**; zum Beispiel darf ein Film nur streambar sein, während ein zugehöriges PDF angesehen und geladen werden darf.
**Eine Berechtigung wird nicht aus mehreren unvollständigen Grants zu einem neuen Tarif zusammengesetzt.** Kommerzielles Streaming und nichtkommerzieller Download ergeben keinen kommerziellen Download. Berechtigungen aus verschiedenen Erwerbsquellen bleiben unabhängig; die Bibliothek kann sie verständlich zusammenfassen, aber ihre Rechte nicht neu kombinieren.
**Referenzfälle ohne Preis- oder Tarifentscheidung:** kostenloses Merkblatt; Einzelmodul als ein Artikel; Programm als ein Artikel; Programm als Paket eigenständiger Module; themenübergreifendes Paket; mehrere Lizenzangebote mit unterschiedlich erlaubten Medienaktionen für denselben Artikel.
Individuelle **betreiberseitige** Pakete müssen modellierbar sein. Kundenseitige freie Paketkonfiguratoren und persönlich gespeicherte Kurssammlungen sind noch nicht als MVP entschieden.
## 8. Mitgliederbibliothek: allgemeine Anforderungen
Die Benutzeroberfläche richtet sich an Trainer, nicht an Katalogadministratoren. Fachlicher Typ und **technisches Dateiformat** bleiben unterscheidbar: Eine Übungsbeschreibung kann als PDF oder Text vorliegen, bleibt fachlich aber eine Übung. Ein PDF wird nicht aufgrund seiner Lizenzierbarkeit als „Kurs“ etikettiert.
**Vorgeschlagene Nutzersichten:** Meine Bibliothek (zentrale Suche), Programme, Module, Materialien, Meine Lizenzen sowie gegebenenfalls Entdecken. Die genauen Menünamen sind UX-Entwurfsdetails; verbindlich sind die Funktionen und die Trennung von fachlicher Navigation und Lizenzübersicht.
### Suche und Filter
- Suche über Titel, Kurzbeschreibung, Schlagwörter und geeignete Suchattribute.
- Kombinierbare Filter nach fachlichem Typ, Säulen, Altersbereich, Einsatzbereich, weiteren aktivierten Dimensionen und tatsächlicher Verfügbarkeit.
- Filterkonfiguration und Werte stammen aus Betreiber-Fachdimensionen; keine Festcodierung der fünf Säulen.
- Ein Programm muss über direkt gepflegte Themen **und** passend abgeleitete Themen seiner enthaltenen Module auffindbar sein; Herkunft intern nachvollziehbar.
- Übergreifende Suchergebnisse deduplizieren stabile Identitäten, nicht bloß Dateinamen oder Titel.
- Standardkombination: ODER bei mehreren Werten derselben Dimension, UND zwischen verschiedenen Dimensionen; bei UX-Abnahme testen.
- Leere Ergebnisse, Berechtigungsfehler, Ladefehler, mobile Filter und Zurücksetzen sind fachlich vorgesehen.
### Karten
Eine Karte enthält Thumbnail/Platzhalter, fachlichen Typ, Titel, kurze Beschreibung, gegebenenfalls Altersbereich/Themen und einen wahrheitsgemäßen Verfügbarkeitsstatus. Angebots-/Rechteangaben stammen aus dem dafür zuständigen Katalog, nicht aus frei getippten Kopien.
### Status
Unterscheide vollständig nutzbare, teilweise nutzbare, nicht nutzbare und gesperrte Inhalte. Nicht verfügbare Bestandteile dürfen im fachlichen Kontext erklärend sichtbar sein, ohne dass die geschützte Datei ausgeliefert wird.
## 9. Moduldetail
Ein Modul zeigt:
1. **Kopf:** eigenes Thumbnail, Titel, Kurzbeschreibung, Alters-/Themenangaben und tatsächliche Verfügbarkeit.
2. **Überblick:** inhaltliche Beschreibung, Lernziele und ggf. Zeit- und Materialbedarf.
3. **Inhalte:** strukturierte, geordnete Kompositionsbestandteile mit Rolle, Fachtyp und vorhandenen Untergruppen. Verschachtelung darf nicht zu einer flachen Dateiliste zusammenfallen.
4. **Zusammenhänge:** Verwendung in anderen Modulen und Programmen.
5. **Aktionen:** je Film geschütztes Streaming; je Dokument berechtigtes Ansehen und/oder Laden; je Übung sinnvolle Anzeige.
Die Darstellung soll dem Trainer das Verständnis der Trainingseinheit ermöglichen, ohne ihn in eine vorgegebene Player-Sequenz zu zwingen.
## 10. Programmdetail
Ein Programm zeigt eigene Metadaten und eine vollständige Struktur aller enthaltenen Module und programmspezifischen Materialien in redaktioneller Reihenfolge. Gemeinsame Materialien werden **in jedem betroffenen Programm** angezeigt. Eine Veränderung einer Programmansicht darf keine andere Programmreferenz entfernen.
Der Status „**inhaltlich vollständig nutzbar**“ ist nicht gleichbedeutend mit „**als Programm gekauft**“. Ein Nutzer kann alle Bestandteile über separate Artikel und mehrere gültige Erwerbsquellen nutzen. Das tatsächliche Zugriffsrecht bleibt je angeforderter Aktion maßgeblich.
Teilweise verfügbare Programme sind klar zu kennzeichnen und können getrennt von vollständig nutzbaren Programmen entdeckt werden. Die genaue Position dieser Ansicht in der Navigation kann anhand eines UX-Tests entschieden werden; unvollständige Programme dürfen nicht fälschlich als vollständig besessen erscheinen.
## 11. Standard-Medienaktionen und Zugriff im MVP
**Video:** Authentifizierte, berechtigte Wiedergabe im normalen Player (Play, Pause, Zeitsuche, Vollbild, Lautstärke, vorhandene Untertitel). Adaptive und geschützte Medienausgabe gemäß bestehendem Medienkonzept. **Keine** verpflichtende automatische Denkpause oder dedizierte Kursablaufsteuerung.
**Dokumente:** Ansehen im Browser und Download sind getrennte Berechtigungsaktionen. Kennzeichnung und Ausgabenachweis bleiben erhalten, soweit das bestehende Rechte-/Medienmodell dies verlangt.
**Sicherheit:** Vor jeder Auslieferung prüfen: Artikel, veröffentlichter Stand, darin enthaltene Inhaltsfassung, angeforderte Aktion, genau eine tragende Berechtigung. Keine Rechtevergabe durch Thumbnail, Filter, Kompositionszuordnung oder bloßes UI-Anzeigen. Originalmedien werden nicht direkt öffentlich geliefert. Signierte URLs dürfen die Berechtigungsentscheidung nicht ersetzen.
**Geräte:** Desktop, Tablet und Smartphone. Eine installierbare PWA bedeutet keine automatische Berechtigung, geschützte Medien offline zu speichern.
## 12. Redaktionsverwaltung und Arbeitsablauf
Die Verwaltung bildet praktische Aufgaben ab, nicht nur Tabellen: **Inhalte**, **Module/Programme und Fachdimensionen**, **Lizenzartikel/Pakete/Angebote**, **Prüfung/Veröffentlichung**.
1. **Medium anlegen:** Typ wählen, Film/PDF/Text hochladen bzw. erstellen, Verarbeitung und Fehlerstatus sehen.
2. **Stammdaten pflegen:** Titel, Beschreibungen, Säulen, weitere Dimensionen, Altersbereich und Thumbnail jederzeit ändern; Auditspur ohne Inhaltsrelease.
3. **Modul erstellen:** bestehende Assets und Unterkompositionen suchen, referenzieren, Rollen je Verwendung festlegen und Reihenfolge bestimmen.
4. **Programm erstellen:** bestehende Module und programmspezifische Inhalte wiederverwenden, eigene Metadaten pflegen, Struktur prüfen.
5. **Produkt konfigurieren:** Lizenzartikelgrenze ausdrücklich festlegen, Artikel/Pakete zusammenstellen, Rechteprofil, Preis und Laufzeit in einer Angebotsfassung bestimmen.
6. **Drei getrennte Vorschauen:** tatsächliche Mitgliederansicht, didaktische Kompositionsstruktur, kaufbarer Umfang samt Berechtigungen.
7. **Veröffentlichen:** fachlich neuen Stand nach bestehender Prüfung freigeben; eigenständige Angebotsfassung gesondert aktivieren.
8. **Nachbearbeiten:** Klasse-A-Stammdaten sofort wirksam; Klasse-B- und Klasse-C-Änderungen kontrolliert als neue Fassungen.
„Verwendet in“ und „Versionen“ müssen in den Bearbeitungsmasken auffindbar sein. In der Mitgliederansicht werden keine administrativen Lizenzstrukturdetails als Ersatz für pädagogische Inhalte gezeigt.
## 13. Abnahmefälle
| ID | Prüffall | Erwartetes Ergebnis |
|---|---|---|
| B01 | Film hochladen | Als Film erfasst, nicht als Kurs oder bloßer Lizenzartikel dargestellt |
| B02 | Titel, Kurzbeschreibung, Thumbnail ändern | Direkt sichtbar, kein neuer Inhalts-/Artikel-Release; Änderung protokolliert |
| B03 | Videoframe als Thumbnail auswählen | Beliebige geeignete Zeitposition visuell wählbar; Film unverändert |
| B04 | Geschützten Filmframe auswählen | Keine implizite öffentliche Marketingfreigabe |
| B05 | Neue Fachsäule administrieren | An Asset, Modul und Programm zuweisbar und filterbar |
| B06 | Thema nur am Modul setzen | Modul selbst darüber auffindbar; kein Tag am Film erforderlich |
| B07 | Verschachtelte Komposition | Unterstrukturen, Rollen und Reihenfolge vollständig erhalten |
| B08 | Film in zwei Modulen | Ein Asset; unterschiedliche Kontextrollen möglich |
| B09 | Dasselbe Modul in Programm A und B | Modul wird **in beiden** Programmen angezeigt |
| B10 | Dasselbe PDF in Programm A und B | PDF wird **in beiden** Programmen angezeigt |
| B11 | Übergreifende Materialliste | PDF als **ein** Eintrag, mit Verweisen auf A und B |
| B12 | Gleicher Titel, andere Identität | Keine falsche Deduplizierung |
| B13 | Verschiedene historische Fassungen eines Assets | Je Programm richtige Fassung; keine stille Versionsmischung |
| B14 | Nur einzelne Module lizenziert | Programm als teilweise nutzbar kenntlich; geschützte Teile bleiben gesperrt |
| B15 | Alle Programmteile über separate Artikel lizenziert | Inhalte vollständig nutzbar, ohne fingierten Programmkauf |
| B16 | Film streambar, nicht downloadbar | Stream funktioniert; Download serverseitig verweigert |
| B17 | Grants mit abweichenden Nutzungszwecken | Keine künstlich kombinierten Rechte |
| B18 | Kompositionsreihenfolge ändern | Neue Kompositionsfassung; früherer Stand unverändert |
| B19 | Filmdatei austauschen | Neue Asset-Fassung, ursprüngliche Datei und Referenzen erhalten |
| B20 | Angebots-Preis oder -Rechte ändern | Neue Angebotsfassung; alter Erwerb historisch korrekt |
| B21 | PDF-Ansehen und PDF-Download | Je Aktion getrennt und serverseitig korrekt entschieden |
| B22 | Responsive Bibliothek | Desktop, Tablet, Smartphone mit funktionsfähiger Suche und Filtern |
| B23 | Programm-/Modulvorschau im Editor | Dieselbe fachliche Struktur wie später bei Mitgliedern |
| B24 | Redaktionelle Änderung nach Kauf | Neue Anzeige sichtbar; Vertrags-/Bestell-Snapshot unverändert |
Erforderlich sind reale Ende-zu-Ende-Tests mit zwei Programmen, gemeinsam genutzten Inhalten, mehreren Erwerbsquellen und tatsächlichen Medienaktionen. Ein Screenshot und ein Test auf die Überschrift „Kurs“ sind keine hinreichende Abnahme.
## 14. Abgestimmte Regeln und noch offene Optionen
**Verbindlich abgestimmt:** Zentrale Mitgliederbibliothek vor spezialisiertem Kursplayer; frei konfigurierbare Fachdimensionen auch für Kompositionen; Beschreibung, Thumbnail und reine Such-/Anzeigedaten ohne neuen fachlichen Release; gewünschter Videoframe als Thumbnail; vollständige Wiederholung aller Verwendungen innerhalb **jedes** Programms und Deduplizierung **nur** in übergreifenden Einzelinhaltslisten; einfache Streaming-/Dokumentfunktionen; getrennte didaktische und kommerzielle Struktur; historische Versions- und Lizenzintegrität.
**Nicht stillschweigend für das MVP entscheiden:** von Kunden selbst konfigurierbare Pakete; gespeicherte persönliche Kursabläufe; automatische Denkpausen-/Präsentationssteuerung; geräteübergreifende Synchronisation; konkrete Tarife, Preise und Honorargrenzen; genaue Navigationsposition teilweise verfügbarer Programme; Frage, ob spezifische Altersvarianten eigene Produkte oder Versionen sind.
## 15. Quellenbasis und Architekturabgleich
Diese fachliche Fassung baut auf folgenden Projektquellen auf: `trainingskonzept-und-produktstruktur.md`, `01_LUF_Zielbild_und_Fachkonzept_v1.1.md`, `04_Domaenenmodell(2).md`, `05_Lizenz_und_Berechtigungslogik(2).md`, `08_Medien_Streaming_Kennzeichnung.md`, `09_CMS_Administration_Community(2).md`, `16_MVP_Slice(1).md` und `design-prinzipien.md`.
Die dazu notwendigen **gezielten** Anpassungen sind in `docs/architektur/abgleich-produktkonfiguration-und-mitgliederbereich.md` dokumentiert. Bestehende Sicherheits-, Berechtigungs- und Veröffentlichungsinvarianten bleiben gültig, soweit nicht ausdrücklich und fachlich begründet angepasst. Diese Spezifikation ist **noch kein Auftrag zur ungeprüften Codeumsetzung**.
@@ -0,0 +1,246 @@
# Lara & Felix – Trainingskonzept und fachliche Produktstruktur
**Geltungsbereich:** Pädagogisches Gesamtkonzept, Themenbereiche, Lernziele, Übungen, Filme, Module, Programme sowie deren fachliche und kommerzielle Darstellung.
## 1. Positionierung und Zweck
**„Lara & Felix – Stark im Alltag“ ist ein strukturiertes Konzept für Gewaltprävention, Selbstbehauptung und die Förderung sicherer Handlungsentscheidungen bei Kindern.** Es unterstützt erwachsene Trainer und pädagogische Fachkräfte bei der Durchführung von Gruppen- und Präsenzkursen.
Im Mittelpunkt stehen **praktische Übungen und angeleitete Lernprozesse**. Alltagsszenen in Filmen helfen beim Einstieg, bei der Reflexion und bei der Besprechung von Handlungsalternativen. Traineranleitungen, Merkzettel, Arbeitsblätter und weitere Materialien unterstützen die Durchführung.
Die gegenwärtige Film- und Materialreihe richtet sich insbesondere an Kinder im Alter von ungefähr sechs bis sieben Jahren. Die Plattform darf grundsätzlich auch altersdifferenzierte Programme und andere Produktlinien unterstützen.
Die Öffentlichkeit soll Lara & Felix als **Gesamtkonzept mit Programmen und Modulen** wahrnehmen – nicht als Shop für isolierte Einzelfilme. Das schließt eine fachlich begründete Einzellizenzierung geeigneter Materialien nicht aus.
### Leitgedanke
**Geschichten zum Mitdenken und Mitmachen: Alltagssituationen verstehen, Handlungsmöglichkeiten besprechen und praktisch erproben.**
Das Konzept vermittelt Handlungsmöglichkeiten; es behauptet keine garantierte Verhinderung von Gewalt oder einen automatisch eintretenden Lernerfolg.
## 2. Die fünf wesentlichen Themenbereiche
Die fünf Bereiche bilden die gegenwärtige fachliche Klammer des Lara-&-Felix-Konzepts. Sie sind **keine fünf zwangsläufig getrennten Produkte oder Lizenzpakete**.
### 2.1 Meine Grenzen – Ich darf Nein sagen
**Lernschwerpunkt:** Eigene Grenzen wahrnehmen und ausdrücken; Grenzen anderer erkennen und respektieren.
**Beispiele praktischer Übungen:**
- Sicherer Stand und selbstbewusste Körperhaltung.
- Stimme bewusst einsetzen.
- Deutlich „Stopp“ beziehungsweise „Nein“ sagen.
- Persönliche Distanz wahrnehmen.
- Grenzen anderer respektieren.
**Ergänzende Filmbeispiele:** „Lara im Park“, „Felix bei Oma“.
### 2.2 Sicher handeln im Alltag
**Lernschwerpunkt:** Situationen aufmerksam wahrnehmen, angemessenen Abstand halten und sichere Entscheidungen im Alltag besprechen und üben.
**Beispiele praktischer Übungen:**
- Umgebung und Veränderungen wahrnehmen.
- Abstand halten und persönliche Sicherheit berücksichtigen.
- Verschiedene Handlungsoptionen vergleichen.
- Verhalten an der Haustür praktisch erproben.
- Telefonsituationen nachspielen.
**Ergänzende Filmbeispiele beziehungsweise Situationen:** „Lara und Mia“, „Autofahrer“, „Einkäufe“, „Postbote“, „Telefon“.
### 2.3 Geheimnisse, Vertrauen und Hilfe holen
**Lernschwerpunkt:** Vertrauenspersonen erkennen, über belastende Situationen sprechen und Unterstützung holen.
**Beispiele praktischer Übungen:**
- Vertrauenspersonen im eigenen Umfeld benennen.
- Hilfe ansprechen und um Unterstützung bitten.
- Gute Überraschungen und belastende Geheimnisse unterscheiden.
**Ergänzende Filmbeispiele:** „Felix beim Onkel“, „Lara und Paul“.
### 2.4 Freundschaft, Selbstbehauptung und Zivilcourage
**Lernschwerpunkt:** Eigene Meinungen vertreten, sozialem Druck begegnen und anderen verantwortungsvoll helfen.
**Beispiele praktischer Übungen:**
- Eigene Meinung vertreten.
- Gruppendruck widerstehen.
- Selbstsicher auftreten.
- Hilfsbereitschaft und Zivilcourage in altersgerechten Situationen üben.
**Ergänzendes Filmbeispiel:** „Lara und Paul“.
### 2.5 Streit, Bedrängung und Konflikte bewältigen
**Lernschwerpunkt:** Konflikte möglichst früh erkennen, angemessen kommunizieren, Distanz schaffen und eine belastende Situation verlassen.
**Beispiele praktischer Übungen:**
- Konfliktgespräche führen.
- Körpersprache wahrnehmen und einsetzen.
- Einfache Ausweichbewegungen.
- Abstand schaffen.
- Laut um Hilfe rufen.
- Sich aus unangenehmen oder bedrängenden Situationen entfernen.
**Ergänzende Filme:** Passende zusätzliche Filme können zugeordnet werden.
### 2.6 Status der Beispiele
Die genannten Filme und Situationen beschreiben **fachlich vorgesehene Zuordnungen**. Aus einer Nennung folgt nicht automatisch, dass eine verwendbare Datei bereits freigegeben, veröffentlicht oder Bestandteil eines bestimmten Kaufangebots ist. Der Inhalt und die Verfügbarkeit ergeben sich aus den tatsächlichen Veröffentlichungs- und Katalogdaten.
## 3. Pädagogische Methode
Das Konzept verbindet Beobachtung, Reflexion und praktische Anwendung. Ein typischer Kursabschnitt kann folgende Schritte umfassen:
1. Eine alltagsnahe Situation vorstellen – beispielsweise mit einem Film, einer Erzählung oder einem Rollenspiel.
2. An einer geeigneten Stelle innehalten und eine **Denkpause** ermöglichen.
3. Mit Kindern verschiedene Handlungsmöglichkeiten besprechen.
4. Eine oder mehrere Reaktionen in kindgerechten praktischen Übungen ausprobieren.
5. Erfahrungen zusammenfassen, einen Merksatz ableiten und auf ähnliche Situationen übertragen.
Dieser Ablauf ist **kein technisch erzwungenes Schema**: Ein Modul kann auch ohne Film funktionieren oder einzelne Schritte anders kombinieren. Die Denkpause ist eine didaktische Funktion, kein obligatorisches Quiz.
Trainerhinweise sollen kurz, praktisch und unmittelbar einsetzbar sein. Sie unterstützen die Durchführung, ersetzen aber keine qualifizierte Gewaltschutztrainer-Ausbildung.
Die konkrete Durchführung berücksichtigt Alter, Gruppensituation, Erfahrungen und mögliche Belastungsreaktionen der Kinder. Übungen sollen Handlungsfähigkeit fördern, ohne Kinder unter Druck zu setzen oder gefährliche Situationen nachzustellen.
## 4. Fachliche Begriffe und Abgrenzungen
| Begriff | Bedeutung | Verhältnis zu anderen Objekten |
| --- | --- | --- |
| **Gesamtkonzept** | Übergreifende Methode und Marke „Lara & Felix – Stark im Alltag“ | Kein automatisch einheitliches Verkaufsprodukt |
| **Themenbereich** | Einer der fünf fachlichen Lernschwerpunkte | Kann zahlreiche Module, Programme und Materialien umfassen; Mehrfachzuordnungen möglich |
| **Modul** | Eigenständig sinnvoll einsetzbare didaktische Trainingseinheit mit Lernzielen und passenden Bestandteilen | Kann in mehreren Programmen vorkommen und mehreren Themenbereichen zugeordnet werden |
| **Programm** | Didaktisch strukturierte Kombination von Modulen und gegebenenfalls weiteren Bestandteilen für einen Trainingszweck | Kann mehrere Themenbereiche abdecken; muss keinem kommerziellen Paket entsprechen |
| **Inhaltselement** | Film, Text, PDF, Bild, Ton, Übungsbeschreibung, Traineranleitung usw. | Wiederverwendbar in mehreren Modulen und Programmen, versionierbar |
| **Didaktische Komposition** | Geordnete Zusammenstellung von konkreten Fassungen beliebiger Inhalte oder weiterer Kompositionen | Technische Grundlage für unterschiedliche Modul-/Programmstrukturen ohne starre Hierarchie |
| **Lizenzartikel** | Vom Betreiber definierte kleinste eigenständig lizenzierbare Einheit | Kann einzelnes Inhaltselement oder eine Komposition repräsentieren |
| **Kommerzielles Paket** | Zusammenfassung lizenzierbarer Artikel | Fachlich unabhängig von Modulen und Programmen |
| **Angebot** | Lizenzumfang, Rechte, Konditionen und gegebenenfalls Preis | Bestimmt, welche Artikel und Rechte ein Käufer tatsächlich erwirbt |
| **Berechtigung** | Individuell zugeordnete Nutzungsberechtigung aus einer konkreten Erwerbsquelle | Kontrolliert Zugriff auf veröffentlichte Artikel und ihre Inhalte |
**Fachliche Begriffe dürfen nicht stillschweigend mit kommerziellen Objekten gleichgesetzt werden.** Ein Programm kann als Lizenzartikel angeboten oder über mehrere Artikel kommerziell abgebildet werden; diese Wahl ist ausdrücklich zu treffen.
## 5. Wiederverwendung und Zuordnung
Die fachliche Struktur ist **mehrdimensional**, nicht ein einziger fester Baum.
- Ein Film kann in mehreren Modulen und Programmen verwendet werden.
- Ein Modul kann mehreren Themenbereichen angehören.
- Ein Modul kann Bestandteil mehrerer Programme sein.
- Ein Programm kann mehrere Themenbereiche behandeln.
- Ein Themenbereich kann unterschiedliche, unabhängig veröffentlichbare Module enthalten.
- Dieselbe didaktische Zusammenstellung kann bei unterschiedlichen kommerziellen Angeboten auf verschiedene Weise lizenziert werden, soweit die Lizenzartikelgrenzen das erlauben.
Beispiel: „Lara und Paul“ kann in den Themenbereichen **Geheimnisse, Vertrauen und Hilfe holen** sowie **Freundschaft, Selbstbehauptung und Zivilcourage** als didaktischer Einstieg genutzt werden, ohne dass der Film doppelt gespeichert werden muss.
Fachliche Zuordnungen, Reihenfolgen und Präsentationen schaffen **keine Berechtigung** für das zugrunde liegende Medium. Maßgeblich bleibt die erworbene Lizenz.
## 6. Programme und Module in der Kursdurchführung
### Modul
Ein Modul kann – je nach pädagogischer Aufgabe – unter anderem folgende Informationen beziehungsweise Bestandteile besitzen:
- Titel und fachliche Beschreibung;
- einen oder mehrere Themenbereiche;
- Zielgruppe beziehungsweise Altersbereich;
- Lernziele und Vorbereitung;
- benötigte Materialien und Raum-/Technikhinweise;
- praktischen Ablauf mit geeigneten Übungen und Trainerfragen;
- optional Film, Denkpause, Reflexionsfragen und Merksatz;
- zugehörige Traineranleitungen, Merkzettel oder Arbeitsblätter.
Nicht alle Bestandteile sind in jedem Modul zwingend erforderlich. Ein Modul bleibt fachlich verwendbar, auch wenn es keinen Film enthält.
### Programm
Ein Programm bündelt geeignete Module zu einem nachvollziehbaren Trainingsziel. Reihenfolge, Schwerpunkt und Umfang können je nach Zielgruppe variieren. Ein Programm darf Module aus unterschiedlichen Bereichen kombinieren. Eine pädagogische Programmstruktur ist unabhängig davon, ob ein Anbieter sie als ein Lizenzartikel, mehrere Lizenzartikel oder ein Paket kommerziell anbietet.
### Praktische Nutzbarkeit
Die Nutzeroberfläche soll nachvollziehbar zeigen, **wie** ein Trainer mit einem Programm oder Modul arbeitet: Einstieg, Material, Übungen, Reflexion und Durchführungshinweise. Eine reine Auflistung enthaltenen Dateien reicht dafür nicht aus.
## 7. Vermarktbare Produkte und Rechteumfang
Das öffentliche Leistungsversprechen ist ein **didaktisch einsetzbares Trainingsangebot**. Die Vermarktung priorisiert deshalb Konzept, Themenbereiche, Programme und Module vor Einzelfilmen.
Der konkret kaufbare Gegenstand ist jedoch eindeutig zu bestimmen:
- **Pädagogischer Nutzen:** Was lernt beziehungsweise übt die Zielgruppe?
- **Enthaltene Inhalte:** Welche Module, Filme, Unterlagen und Übungen gehören zur beworbenen Zusammenstellung?
- **Lizenzumfang:** Welche Lizenzartikel werden tatsächlich erworben?
- **Nutzungsrechte:** Was darf ein Trainer mit diesen Materialien tun, für welchen Zweck und wie lange?
- **Konditionen:** Welche Preis- und Vertragsbedingungen gelten?
Eine Programmbeschreibung darf pädagogisch zusammengehörige Inhalte erläutern, aber nur **tatsächlich enthaltene oder ausdrücklich als optional bezeichnete** Materialien als Leistungsumfang darstellen. Freigaben und Zugriffe folgen den gültigen Berechtigungen, nicht der grafischen Nähe oder Themenzuordnung.
Kostenlose Beispiele, freie Einstiegsmaterialien, Einzelmodule, Programme und themenübergreifende Pakete können koexistieren. Ihre konkrete kommerzielle Verfügbarkeit ist jeweils eine Betreiberentscheidung, keine automatische Ableitung der pädagogischen Gliederung.
## 8. Darstellung auf der öffentlichen Webseite
Die öffentliche Darstellung soll diesen Aufbau verständlich machen:
1. **Gesamtkonzept und Methodik** – wofür Lara & Felix steht und wie die Trainingsmaterialien eingesetzt werden.
2. **Fünf Themenbereiche** – die wesentlichen pädagogischen Lernschwerpunkte.
3. **Programme und Module** – konkrete Durchführungseinheiten mit Zielgruppen, Lernzielen und Zusammensetzung.
4. **Film- und Materialbeispiele** – anschauliche didaktische Bestandteile und Vorschauen.
5. **Angebote und Lizenzen** – tatsächlich kaufbare Zusammenstellungen mit korrektem Rechteumfang.
Die fünf Themenbereiche erhalten wiedererkennbare gestalterische Signaturen. Einzelfilme dürfen auffindbare Detailseiten besitzen, bilden aber nicht die dominante Handels- und Navigationsebene.
Fachliche Seitentexte bleiben mit den aktuell veröffentlichten Produkt- und Angebotsdaten konsistent. Regeln zur visuellen Umsetzung und Suchmaschinenauffindbarkeit stehen in den beiden Prinzipiendokumenten.
## 9. Mitgliederbereich und Trainingsnutzung
Die Mitgliederbibliothek unterstützt die Arbeit mit **Programmen, Modulen und ihren Materialien**. Nutzer sollen berechtigte Zusammenstellungen erkennen, Inhalte nach Themenbereich finden, Lernziele sehen und zur konkreten Durchführung gelangen können.
Wichtige fachliche Regeln:
- Berechtigungen hängen an Lizenzartikeln und Erwerbsquellen, nicht an einer bloßen thematischen Zuordnung.
- Mehrere Berechtigungen für denselben Artikel dürfen in der Darstellung zusammengefasst, aber **nicht zu neuen, stärkeren Rechten vereinigt** werden.
- Gemeinsame Inhalte müssen nicht mehrfach in der Bibliothek erscheinen, nur weil sie aus verschiedenen Programmen oder Paketen stammen.
- Vor der Ausgabe einer Datei wird geprüft, ob sie Bestandteil des konkreten berechtigten veröffentlichten Artikel-Stands ist und die gewünschte Aktion erlaubt ist.
- Traineranleitungen, Filme und Begleitmaterial bleiben in der Oberfläche als zusammengehörige didaktische Einheit erkennbar.
## 10. Mobile Nutzung und PWA
Die öffentliche Präsentation und die Kursdurchführung sollen auch auf Smartphones und Tablets gut nutzbar sein. Besondere Bedeutung haben die Auffindbarkeit eines Programms, das Öffnen von Trainerunterlagen und die einfache Bedienung des Filmplayers mit Denkpause.
Die Plattform wird als installierbare PWA genutzt, ohne dass dadurch automatisch ein Offline-Nutzungsrecht für geschützte Materialien entsteht. Mobiler Zugang und Lizenzumfang bleiben voneinander getrennt.
## 11. Fachliche Prüfkriterien für die Software
Die fachliche Konformität ist anhand zusammenhängender Nutzungsszenarien zu prüfen. Die folgenden Anforderungen gelten unabhängig von einer konkreten Tabellen- oder Klassenstruktur:
1. Ein einzelnes Material kann in mehreren Modulen verwendet werden.
2. Ein Modul kann mehreren Themenbereichen zugeordnet werden.
3. Ein Modul kann in mehreren Programmen auftreten.
4. Ein Programm kann mehrere der fünf Themenbereiche behandeln.
5. Module und Programme können didaktisch dargestellt werden, ohne zugleich kommerzielle Pakete sein zu müssen.
6. Ein einzelnes Material, Modul oder Programm kann nach ausdrücklicher Entscheidung als Lizenzartikel definiert werden.
7. Ein kommerzielles Paket kann mehrere Lizenzartikel verschiedener Themen oder Programme umfassen.
8. Der Kauf beziehungsweise die freie Freischaltung gewährt ausschließlich die im Angebot festgelegten Rechte.
9. Änderungen an gemeinsam genutzten Medien verändern bestehende veröffentlichte, versionierte Zusammenstellungen nicht stillschweigend.
10. Die Mitgliederbibliothek zeigt Mehrfachzuordnungen und unterschiedliche Erwerbsquellen korrekt, ohne Dubletten oder unzulässige Rechtekombination.
11. Die tatsächliche Durchführung eines Moduls mit Film, Denkpause und Begleitmaterial ist im Mitgliederbereich praktisch möglich.
12. Mobile Nutzung und PWA-Funktionen verändern weder die fachlichen Freigaben noch den Lizenzschutz.
Diese Kriterien beschreiben **fachliches Verhalten**. Ob vorhandene Tabellen oder Dienste erweitert werden müssen, ergibt sich aus der Prüfung der tatsächlichen Implementierung; das Konzept schreibt keine neue starre Produktdatenhierarchie vor.
## Normative Bezüge
- `docs/prinzipien/design-prinzipien.md`
- `docs/prinzipien/seo-und-content-prinzipien.md`
- `docs/architektur/04_Domaenenmodell.md`
- `docs/architektur/05_Lizenz_und_Berechtigungslogik.md`
- `docs/architektur/06_Versionierung_und_Veroeffentlichung.md`
- `docs/architektur/09_CMS_Administration_Community.md`
**Verbindlicher Leitsatz:** Das Gesamtkonzept ist der pädagogische Wert, Programme und Module organisieren die praktische Nutzung, Filme und Materialien unterstützen die Durchführung, und lizenzierbare Artikel beziehungsweise Angebote definieren unabhängig davon die tatsächlichen Nutzungsrechte.
+178
View File
@@ -0,0 +1,178 @@
# Lara & Felix – Verbindliche Design- und UX-Prinzipien
**Geltungsbereich:** Öffentliche Webseite, CMS-Bausteine, Katalog, Anmeldung, Mitgliederbereich, Bibliothek, Angebots- und Kaufprozess, Kursplayer sowie installierbare Progressive Web App (PWA).
## 1. Gestalterisches Ziel
„Lara & Felix – Stark im Alltag“ ist eine professionelle digitale Plattform für pädagogisch angeleitete Gewaltprävention und Selbstbehauptung. Die Oberfläche verbindet eine eigenständige, aus den vorhandenen Filmen entwickelte Markenwelt mit der Klarheit und Bedienbarkeit eines hochwertigen digitalen Produkts.
Gestaltung, Funktionalität, Zugänglichkeit, Sicherheit und Wartbarkeit sind gleichrangige Qualitätsanforderungen. Ein austauschbares, offensichtlich aus Standardbausteinen zusammengesetztes KI-Webdesign erfüllt die Anforderungen nicht.
Die öffentliche Webseite verkauft in erster Linie **das Trainingskonzept sowie Programme und Module**. Filme, Übungen und Unterlagen werden als Bestandteile eines pädagogisch zusammenhängenden Angebots präsentiert, nicht als isolierte Videothek.
## 2. Markenpersönlichkeit und Zielgruppen
Die Marke vermittelt Selbstwirksamkeit, Mut, Vertrauen, Sicherheit, Respekt, Freundlichkeit und pädagogische Glaubwürdigkeit. Sie ist positiv und zugewandt, ohne Gefahren zu dramatisieren oder eine nachweislose Schutzgarantie zu suggerieren.
Die Plattform richtet sich an **erwachsene Trainer, Lehrkräfte, pädagogische Fachkräfte und Einrichtungen**. Die Lerninhalte richten sich gegenwärtig insbesondere an Kinder im Grundschulalter. Daraus ergeben sich zwei miteinander verbundene visuelle Ausdrucksweisen:
- **Plattform und Vermarktung:** hochwertig, ruhig, klar, erwachsenengerecht, orientierungsstark und professionell.
- **Filmwelt und Didaktik:** emotionaler, bildstärker, freundlich, leicht verständlich und mit prägnanten grafischen Lernsignalen.
Beide verwenden dieselbe grundlegende Markenidentität. Die Filmästhetik darf die funktionalen Seiten nicht überladen; umgekehrt soll die Produktoberfläche nicht beliebig oder steril wirken.
## 3. Die fünf fachlichen Themenbereiche als Markensystem
Die fünf Bereiche sind die wiederkehrende öffentliche Gliederung des Trainingskonzepts:
| Nr. | Themenbereich | Grafische Leitidee |
| --- | --- | --- |
| 1 | **Meine Grenzen – Ich darf Nein sagen** | Stopp, persönliche Grenze, Selbstbestimmung |
| 2 | **Sicher handeln im Alltag** | Wahrnehmung, Abstand, überlegtes Handeln |
| 3 | **Geheimnisse, Vertrauen und Hilfe holen** | Vertrauenspersonen, Zuhören, Unterstützung |
| 4 | **Freundschaft, Selbstbehauptung und Zivilcourage** | Zugehörigkeit, Standpunkt, gegenseitige Hilfe |
| 5 | **Streit, Bedrängung und Konflikte bewältigen** | Kommunikation, Distanz, Deeskalation |
Es ist eine zusammengehörige **Familie von fünf Signaturen** aus Symbol, Bezeichnung und gegebenenfalls unterstützendem Farbakzent zu gestalten. Die Bereiche müssen auch ohne Farbwahrnehmung unterscheidbar sein. Sie sind keine fünf unabhängigen Submarken und legen keine starre technische Produktstruktur fest.
Die Bereichssignaturen erscheinen konsistent auf Themen-, Programm- und Modulseiten, in geeigneten Bibliotheksansichten und in Trainerunterlagen. Ein Modul, eine Komposition oder ein Film darf fachlich mehreren Bereichen zugeordnet sein; die visuelle Kennzeichnung muss Mehrfachzuordnungen unterstützen.
## 4. Markenassets und Bildsprache
Die vorhandene Lara-&-Felix-Markenwelt ist die maßgebliche visuelle Ausgangsbasis. Zu ihren sichtbaren Elementen gehören:
- das **Titelmotiv** mit Lara, Felix, Wortmarke und dem Zusatz „Stark im Alltag“;
- das **Denkpause-Motiv** mit Fragewolke, Fragezeichen und grüner Kennzeichnung;
- das **Outro-/Freiflächenmotiv** als Vorlage für grafische Kompositionen;
- bestehende **Figurenreferenzen** und authentisch wirkende Alltagsszenen aus dem Filmprojekt.
Bevorzugte Bildwirkung: fotorealistische Charaktere, natürliches Licht, freundliche Alltagssituationen, warme Grüntöne im Hintergrund, glaubwürdige Mimik und ruhige Tiefenschärfe. Die Filmfiguren sollen über freigegebene Darstellungen hinweg wiedererkennbar bleiben.
### 4.1 Asset-Verbindlichkeit
Ein Bild ist nicht allein wegen seiner Existenz im Medienbestand freigegeben. Für den produktiven Markeneinsatz müssen Motiv, Logo-Variante, Charakterkonsistenz, Bildauflösung, Nutzungsrechte und Verwendungskontext geklärt sein. Dazu dient ein kuratierter Asset-Katalog mit Kennung, Quelle, Zweck, Freigabestatus und geeigneten Formatvarianten.
**Originaldateien bleiben unverändert.** Aus ihnen können geeignete Zuschnitte und optimierte Ableitungen erzeugt werden. Figuren oder Wortmarken dürfen nicht ungeprüft durch KI neu interpretiert werden. Das Markenlogo ist als eigenständige, möglichst skalierbare Ressource vorzusehen; ein vollständiges Filmbild ist kein Ersatz für ein korrektes Weblogo.
### 4.2 Visuelle Rollen
- **Titel-/Keyvisual:** markenprägender Einstieg auf Kampagnen- und Konzeptseiten.
- **Denkpause:** didaktisches Funktionsmotiv innerhalb der Lern- und Kursdarstellung, nicht universeller Seitenhintergrund.
- **Filmbilder:** anschauliche Belege für die Einsatzmöglichkeiten der Methode.
- **Figurenreferenzen:** Grundlage für Konsistenzprüfung neuer Darstellungen, nicht automatisch öffentliches Bildmaterial.
- **Ruhige Freiflächenbilder:** Hintergrund für gut lesbare Texte, sofern technisch und barrierefrei geeignet.
Texte in Filmplakaten und Titelmotiven bleiben Bestandteil der Grafik. Wesentliche Seitentitel, Leistungsbeschreibungen und Handlungsaufforderungen müssen **zusätzlich als echte HTML-Texte** bereitstehen.
## 5. Farb- und Typografiesystem
Die identitätsstiftende Farbwelt nutzt **Dunkelblau, Grün, Gelb sowie Weiß und helle warme Neutralfarben**.
| Rolle | Einsatz |
| --- | --- |
| Dunkelblau | Haupttext, Überschriften, Navigation, tragende Markenflächen |
| Grün | positive Markenakzente, „Stark im Alltag“, geeignete Handlungsflächen |
| Gelb | sparsame Denk- und Aufmerksamkeitsakzente, Unterstreichungen, Signalstrahlen |
| Helle Neutralfarben | Inhaltsflächen, großzügige Abstände, ruhige Hintergründe |
Verbindliche numerische Farb-Tokens werden aus den **ausgewählten Originalassets** abgeleitet und auf Kontrast geprüft; Näherungswerte aus KI-Mockups sind keine autoritative Farbquelle. Markenfarben und semantische UI-Zustandsfarben (Fehler, Warnung, Erfolg, Information) sind getrennt zu definieren.
Die Wortmarke besitzt eine charakteristische, freundlich gerundete Schriftanmutung. Für längere Inhalte, Formulare und Navigation ist eine hochgradig lesbare Webtypografie mit klarer Hierarchie zu verwenden. Marken-/Kampagnenschrift und Leseschrift dürfen unterschiedliche Aufgaben erfüllen. Schriftwahl berücksichtigt Darstellungsqualität, Ladezeiten und Nutzungsrechte.
## 6. Layout- und Kompositionsprinzipien
- Präzises Raster und wiederverwendbares Abstands- und Größenmaßsystem.
- Bewusste visuelle Hierarchie; ausreichend Ruhe und Weißraum.
- Hochwertige Editorial-Komposition für öffentliche Konzept- und Themenseiten.
- Klarheit, Orientierung und Informationsdichte nach Nutzungszweck für Katalog, Bibliothek und Konto.
- Differenzierte Bildschirmkomposition statt identischer Reihen gleichförmiger Karten.
- Bild-Text-Verhältnisse und Zuschnitte für verschiedene Bildschirmgrößen gezielt gestalten.
- Keine bedeutungslosen Dekorelemente, Überanimationen oder Effekte, die wichtige Inhalte überlagern.
Asymmetrische Layouts sind eine mögliche Qualität der öffentlichen Kommunikation, aber kein Zwang für transaktionale oder funktionale Ansichten.
## 7. Öffentliche Seiten und Angebotsdarstellung
Die Hauptnavigation und die Seitenarchitektur sollen sich am Nutzerversprechen orientieren: **Konzept, fünf Themenbereiche, Programme und Module, Anwendung für Trainer, Angebote und Mitgliederbereich**. Die genaue Informationsarchitektur ist im CMS pflegbar.
Die Startseite erklärt klar:
1. welches Problem das Trainingskonzept adressiert;
2. wie die Methode Alltagssituationen, Reflexion und praktische Übungen verbindet;
3. welche fünf Themenbereiche behandelt werden;
4. wie Programme und Module im Unterricht beziehungsweise Kurs eingesetzt werden;
5. welche Materialien, Angebote und Nutzungsrechte tatsächlich verfügbar sind.
**Programme und Module stehen visuell vor Einzelfilmen.** Ein Programm erhält eine übersichtliche Darstellung seiner Lernziele, Zielgruppen, enthaltenen Module, Materialien und methodischen Verwendung. Filme erscheinen im didaktischen Kontext. Angebotskarten erläutern den konkreten lizenzierten Umfang; sie dürfen ihn nicht mit dem pädagogisch zugehörigen, aber nicht enthaltenen Material verwechseln.
Die Seiten verwenden Katalogdaten aus der maßgeblichen Veröffentlichung statt abweichender Kopien. Keine erfundenen Referenzen, Kundenbewertungen, Preise, Zertifikate, Qualifikationen oder Wirksamkeitsversprechen.
## 8. Mitgliederbereich und Kursplayer
Der Mitgliederbereich ist ein eigenständiges, professionelles Produkt und **keine umbenannte Filament-Administration**.
Er bietet eine verständliche Navigation nach verfügbaren Programmen, Modulen, Themen und Materialien. Suche, Filter, Fortschritts- und Berechtigungsinformationen müssen bei wachsenden Katalogen übersichtlich bleiben. Derselbe Lizenzartikel soll bei mehreren Erwerbsquellen nicht als irreführende Mehrfachkopie erscheinen; Rechtequellen bleiben separat nachvollziehbar und dürfen fachlich nicht unzulässig vereinigt werden.
Der Kursplayer unterstützt die reale Kursdurchführung. Besonders wichtig sind einfache Bedienung, gut lesbare Steuerelemente, Vollbild, Untertitel, Wiederholung und kontrollierbare **Denkpausen**. Die Denkpause ist eine echte didaktische Funktion, keine dekorative Unterbrechung. Der Kursplayer muss auch auf Tablets und mobilen Geräten zuverlässig bedienbar sein.
## 9. Komponenten und Zustände
Ein einheitliches Designsystem enthält mindestens folgende Familien:
- **Plattformkomponenten:** Header, Navigation, Buttons, Suche, Filter, Formulare, Dialoge, Statusanzeigen, Kaufprozess, Benutzerkonto.
- **Inhaltskomponenten:** Programm- und Modulkarten, Lernzielansichten, Filmvorschauen, Traineranleitungen, Dokumente, Materiallisten, Lizenzinformationen.
- **Didaktische Komponenten:** Denkpause, Reflexionsfrage, Merksatz, Trainerhinweis, Übungsfolge.
Für jede relevante Komponente sind Normal-, Hover-, Fokus-, Lade-, Leer-, Fehler-, Erfolgs- und gegebenenfalls deaktivierte Zustände konsistent zu gestalten. Die Komponenten dürfen das generische Inhalts-/Kompositionsmodell nicht auf einzelne Filmepisoden reduzieren.
## 10. Interaktionen und Animationen
Interaktionen sollen unmittelbar verständlich sein. Geeignete Mikroanimationen unterstützen Orientierung, Zustandswechsel und Rückmeldung. Hover- und Fokuszustände, Eingabevalidierung, Navigation, Ladeanzeigen und Fehlermeldungen sind sorgfältig gestaltet.
Animationen dürfen weder ablenken noch die Bedienung verzögern. `prefers-reduced-motion` muss respektiert werden. Die Anwendung vermeidet vermeidbare Layoutsprünge, animierte Pflichtinformationen und rein dekorative Bewegung.
## 11. Mobile First und PWA
Die gesamte öffentliche Webseite sowie Anmeldung, Mitgliederbibliothek, Angebote, Checkout und Kursplayer werden **Mobile First** umgesetzt. Mobile ist eine vollwertige Nutzungssituation und keine verkleinerte Desktopversion.
Die Plattform ist als **installierbare Progressive Web App** konzipiert. Dazu gehören:
- gültiges Web-App-Manifest, Name, Markenicons und geeigneter Startpunkt;
- responsives, touchfreundliches Bedienkonzept einschließlich Tablets;
- Service Worker mit dokumentierter, sicherer Cache-Strategie;
- sinnvolle Offline-/Verbindungsfehleransicht für nicht verfügbare Netzwerkinhalte;
- geprüfte Aktualisierung und Navigation in der installierten App;
- Installation und Service-Worker-Funktionen in einem sicheren Ursprung (HTTPS beziehungsweise geeignete lokale Entwicklungsumgebung).
Die PWA ersetzt nicht die öffentliche, servergerenderte Website. Installation gewährt **keine zusätzlichen Nutzungsrechte**. Authentifizierte Seiten, personenbezogene Daten, signierte Medien-URLs, individuelle PDF-Ausgaben und geschützte Videos dürfen nicht unbeabsichtigt dauerhaft offline gespeichert oder über gemeinsam genutzte Caches bereitgestellt werden. Ein Offline-Modus für lizenzierte Inhalte erfordert eine gesonderte fachliche und technische Festlegung.
## 12. Zugänglichkeit und Performance
Die Plattform orientiert sich an **WCAG 2.2 AA** und den **Core Web Vitals**.
Relevant sind insbesondere semantische HTML-Struktur, ausreichende Kontraste, Tastaturbedienung, sichtbare Fokusindikatoren, verständliche Formulare, passende Alternativtexte, Untertitel und zugängliche Player-Bedienelemente. Die Seitentypografie bleibt auch bei Zoom und kleinen Ansichten nutzbar.
Bilder und Medien werden größen- und formatgerecht ausgeliefert. Große Hero-Bilder dürfen die Ladezeit nicht unnötig beeinträchtigen. Unnötiges JavaScript, Layoutverschiebungen und übermäßige Animationslast sind zu vermeiden.
**Gemeinsame Anforderungen an öffentliche Inhalte, Indexierbarkeit und Struktur** stehen in `seo-und-content-prinzipien.md`. Die Designprinzipien bestimmen die Darstellung und Bedienung; die SEO-Prinzipien bestimmen die Auffindbarkeit und Content-Regeln.
## 13. Visuelle Qualitätssicherung
Funktionierende Tests ersetzen keine visuelle Prüfung. Wesentliche Ansichten sind in der **tatsächlich gerenderten Anwendung** mindestens auf Desktop (ca. 1440 px), Tablet (ca. 768 px) und Smartphone (ca. 390 px) zu prüfen. Zusätzlich sind echte Interaktions- und Fehlersituationen einzubeziehen.
Zu kontrollieren sind Typografie, Proportionen, Bildzuschnitte, visuelle Hierarchie, Navigationsverhalten, Formularzustände, Touch-Bedienbarkeit, Lesbarkeit, Farbkontrast, Konsistenz mit den freigegebenen Markenassets und fachliche Verständlichkeit der Programm-/Modulangebote.
Ein Entwurf oder Mockup ist keine geprüfte Produktansicht. Eine Prüfung darf nur als durchgeführt gemeldet werden, wenn die jeweilige Ansicht tatsächlich betrachtet wurde.
## 14. Externe Designwerkzeuge und Anti-Patterns
Design-Skills und Komponentenbibliotheken sind unterstützende Werkzeuge. Maßgeblich sind die freigegebene Lara-&-Felix-Markenidentität, dieses Regelwerk und die tatsächlichen Nutzeraufgaben. Externe Skills dürfen kein eigenständiges Designsystem ohne Bezug zur vorhandenen Bildwelt erzwingen.
Zu vermeiden sind insbesondere generische Blau-Violett-Verläufe, beliebige Stockfotos, austauschbare SaaS-Heros, identische Kartenwüsten, dekoratives Glassmorphism ohne Funktion, übertriebene Schatten, inflationäre Icons, unnötige Bewegung und eine durchgängig kindliche Posterästhetik.
## Normative Bezüge
- `docs/prinzipien/seo-und-content-prinzipien.md`
- `docs/fachkonzept/trainingskonzept-und-produktstruktur.md`
- [WCAG 2.2 (W3C)](https://www.w3.org/TR/WCAG22/)
- [Core Web Vitals](https://web.dev/articles/vitals)
@@ -0,0 +1,192 @@
# Lara & Felix – Verbindliche SEO-, Content- und Marketing-Prinzipien
**Geltungsbereich:** Öffentliche Website, CMS, Konzept- und Themenseiten, Programme, Module, Katalog- und Angebotsseiten, Suchmaschinen, KI-gestützte Suche und datenbasierte Marketingsteuerung.
## 1. Positionierung und Marketingziel
„Lara & Felix – Stark im Alltag“ wird als **pädagogisches Gesamtkonzept für Gewaltprävention und Selbstbehauptung** vermarktet. Der zentrale Nutzen liegt in der Kombination aus strukturierten Trainingsprogrammen, flexibel einsetzbaren Modulen, praktischen Übungen, didaktischen Filmen und begleitenden Trainer- und Unterrichtsmaterialien.
Die Vermarktung richtet sich besonders an Trainer, Lehrkräfte, pädagogische Fachkräfte und Einrichtungen. Der öffentliche Auftritt ist **keine vorrangige Film-Verkaufsplattform**. Einzelfilme dürfen beschrieben und gegebenenfalls separat lizenziert werden, stehen kommunikativ aber hinter dem didaktischen Gesamtkonzept.
Ziele sind organische Sichtbarkeit bei relevanten Suchanfragen, qualifizierte Besuche, Auffindbarkeit in geeigneten KI-Suchdiensten, Registrierungen, sinnvolle Nutzung kostenfreier Inhalte und Erwerb passender Angebote. Eine bestimmte Rankingposition oder KI-Zitation wird **nicht garantiert**.
## 2. Die fünf Themenbereiche als zentrale Informationsstruktur
Die öffentliche Website bildet die fünf fachlichen Schwerpunkte deutlich ab:
1. **Meine Grenzen – Ich darf Nein sagen**
2. **Sicher handeln im Alltag**
3. **Geheimnisse, Vertrauen und Hilfe holen**
4. **Freundschaft, Selbstbehauptung und Zivilcourage**
5. **Streit, Bedrängung und Konflikte bewältigen**
Jeder Bereich kann eine redaktionell gepflegte Themenseite mit verständlicher fachlicher Einordnung, Lernzielen, Übungen, geeigneten Filmbeispielen, zugehörigen Modulen/Programmen und tatsächlich verfügbaren Angeboten erhalten.
Die fünf Bereiche sind **inhaltliche Einstiege**, nicht automatisch eigenständige Verkaufsprodukte. Eine Übung, ein Film, ein Modul oder ein Programm darf mehreren Bereichen zugeordnet sein; doppelte Inhalte und nahezu identische indexierbare URLs sind zu vermeiden.
Die konkrete pädagogische Zuordnung wird in `docs/fachkonzept/trainingskonzept-und-produktstruktur.md` festgelegt.
## 3. Nutzungsorientierte Informationsarchitektur
Die öffentlich zugängliche Site-Struktur unterscheidet:
| Seitengruppe | Primärer Zweck |
| --- | --- |
| Konzept- und Methodikseiten | Trainingsidee, pädagogische Vorgehensweise, Einsatzmöglichkeiten verstehen |
| Fünf Themenseiten | Lernschwerpunkte und praktische Übungen erschließen |
| Programm- und Modulseiten | Lernziele, Aufbau, Inhalte und Zielgruppen verständlich machen |
| Katalog- und Angebotsseiten | Lizenzierbaren Umfang, Nutzungsrechte und Konditionen korrekt darstellen |
| Fachbeiträge und Hilfeseiten | Konkrete Fragen von Trainern und Pädagogen beantworten |
| Mitgliederbereich | Persönlich berechtigte Materialien nutzen; nicht öffentlich indexierbar |
Wichtige Informationen sollen über nachvollziehbare Navigation und interne Links erreichbar sein. Die öffentliche Darstellung der pädagogischen Zusammenhänge ist von der kommerziellen Bündelung und Berechtigung strikt getrennt.
## 4. Menschenorientierter, fachlich belastbarer Content
Inhalte müssen reale Fragen der Zielgruppen beantworten. Eigene Filme, Trainingsmaterialien, methodische Erläuterungen und nachweisbare Praxiserfahrungen sind die Grundlage eigenständiger Inhalte.
Fachliche Aussagen werden hinsichtlich Richtigkeit, Nachvollziehbarkeit und bei Bedarf Quellenlage geprüft. Angaben zu Wirksamkeit, Sicherheit und Schutz dürfen nicht über vorhandene Evidenz hinausgehen. Autorenschaft, Herausgeber und fachliche Qualifikationen werden korrekt und transparent dargestellt.
Automatisierte Textproduktion dient der Unterstützung, nicht der Erzeugung großer Mengen austauschbarer Suchmaschinenseiten. Keine erfundenen Bewertungen, Testimonials, Partner, Qualifikationen oder Ergebnisse.
### Methodische Kommunikation
Die Vermittlung kann die Struktur **„Alltagssituation erleben – gemeinsam nachdenken – praktisch ausprobieren – Handlungsmöglichkeiten reflektieren“** verwenden. Dies ist ein Kommunikationsrahmen, keine zwingende Schrittfolge jedes Moduls.
Die öffentliche Kommunikation soll erklären, **wie** Trainer mit den Materialien arbeiten und welchen pädagogischen Zweck ein Angebot verfolgt, statt nur Medienzahlen aufzulisten.
## 5. Technische SEO-Anforderungen
Öffentliche Seiten verwenden semantisch sinnvolles, möglichst servergerendertes HTML. Folgende Funktionen gehören zur Plattform:
- individuelle Seitentitel und sinnvolle Meta-Beschreibungen;
- eindeutige kanonische URLs und stabile, lesbare Pfade;
- funktionierende Weiterleitungen bei URL-Änderungen;
- automatisch aus geeigneten veröffentlichten URLs erzeugte XML-Sitemap;
- definierte `robots.txt`- und `noindex`-Regeln;
- Breadcrumb-Navigation und nachvollziehbare interne Verlinkung;
- Open-Graph- und andere geeignete Social-Preview-Metadaten;
- strukturierte Daten nur für passende, öffentlich belegbare Seitentypen;
- responsive, zugängliche und performante Auslieferung;
- gültige HTTP-Statuscodes und korrekte Behandlung nicht vorhandener Inhalte.
Die CMS-Verwaltung ermöglicht die Bearbeitung von SEO-Titel, Beschreibung, URL-Pfad, Vorschau, Indexierungsstatus und redaktionellen Metadaten. SEO-Inhalte sind versionier- und veröffentlichbar wie andere Seiteninhalte.
## 6. Dynamische Seiten aus Katalogdaten
Programm-, Modul-, Artikel-, Paket- und Angebotsseiten lesen verbindliche Informationen aus den **veröffentlichten** maßgeblichen Fachobjekten. Das umfasst beispielsweise Titel, Zielgruppe, Lernziele, Inhalte, Preis, Lizenzrechte und Laufzeit.
Redaktionelle Seitentexte dürfen ergänzen, aber keine abweichenden Produktversprechen erzeugen. Ein pädagogisch zugeordnetes Material wird nicht automatisch als Bestandteil eines kommerziellen Angebots angegeben.
Nicht jede Kombination aus Inhalt, Thema, Schlagwort und Paket muss eine eigene indexierbare URL erhalten. Indexierbare Seiten brauchen einen eigenständigen Informationsnutzen. Bei Überschneidungen sind geeignete kanonische URLs, Zusammenführung oder kontrollierte Nichtindexierung vorzusehen.
## 7. Bilder, Videos und textliche Erschließung
Die vorhandene Lara-&-Felix-Bildwelt wird konsistent genutzt; Freigaben und Rechte bleiben Voraussetzung.
- Bilder erhalten geeignete Beschreibungen beziehungsweise funktionsbezogene Alt-Texte, responsive Größen und optimierte Dateiformate.
- Wesentliche Überschriften, Leistungsbeschreibungen, Lernziele, Fragen und CTAs müssen als **echter HTML-Text** vorliegen, auch wenn Titelgrafiken Schrift enthalten.
- Öffentlich freigegebene Filmvorschauen dürfen mit zutreffenden Titeln, Standbildern, Beschreibungen und gegebenenfalls geeigneten Video-Metadaten präsentiert werden.
- Zusammenfassungen oder Transkriptauszüge werden nur veröffentlicht, wenn sie dafür bestimmt sind; geschützte Volltexte und Originalmedien bleiben privat.
- Große Medien dürfen die Ladezeiten der Einstiegsseiten nicht unnötig belasten.
Gestaltung und Markenelemente richten sich nach `docs/prinzipien/design-prinzipien.md`.
## 8. Strukturierte Daten
Strukturierte Daten dürfen nur vorhandene, sichtbare und korrekte Sachverhalte beschreiben. Geeignet können je nach Seitentyp Angaben zu Herausgeber, Website, Breadcrumbs, Fachbeiträgen, Videos oder kommerziellen Angeboten sein.
Die aktuelle Unterstützung des jeweiligen Suchdienstes ist zu prüfen. Nicht passende `schema.org`-Typen, erfundene Preise, Bewertungen oder Wirkungsangaben sind unzulässig. Validierung ist Teil der Veröffentlichungskontrolle.
## 9. KI-gestützte Suche (GEO/AEO)
Auffindbarkeit und Zitierbarkeit in KI-gestützten Suchsystemen werden durch **klar strukturierte, verlässliche und öffentlich zugängliche Fachinhalte** unterstützt:
- präzise Antworten auf tatsächlich gestellte Fragen;
- eindeutige Begriffe und nachvollziehbare Überschriften;
- benannte Autoren und Herausgeber;
- fachliche Quellen bei überprüfungsbedürftigen Behauptungen;
- konsistente Angaben zu Methode, Programm, Modul und Angebot;
- stabile, intern verlinkte öffentliche Seiten;
- zugängliche Textbeschreibungen für visuelle Medien.
Es werden keine unbelegten Spezialtricks, angeblich garantierten KI-Markups oder Rankingversprechen eingesetzt. Mögliche Zitationen durch KI-Systeme sind externe Ergebnisse, keine vom System kontrollierbaren Eigenschaften.
## 10. Indexierung, Datenschutz und Zugangsschutz
Indexierung ist ausschließlich für geeignete veröffentlichte öffentliche Seiten vorgesehen. Entwürfe, zurückgezogene oder nicht freigegebene Inhalte, Verwaltungsansichten, personenbezogene Profile, Bestellungen, geschützte Medien und Mitgliederbibliotheken dürfen nicht unkontrolliert öffentlich sichtbar werden.
Die Testumgebung muss zuverlässig gegen öffentliche Indexierung und unerwünschten Zugriff abgesichert sein. **`robots.txt` und `noindex` sind keine Authentifizierung und kein Schutz für vertrauliche Daten.** Geschützte Medien und Seiten benötigen unabhängig davon serverseitige Zugriffsentscheidungen.
Sitemaps und strukturierte Daten dürfen keine nicht veröffentlichten oder sensiblen Informationen preisgeben.
## 11. Mobile Web und PWA
Die Website bleibt **ohne Installation** öffentlich zugänglich und indexierbar. Die installierbare PWA ist ein zusätzlicher Nutzungsweg für Mitglieder und Trainer.
Service Worker, clientseitige Navigation und Caches dürfen weder stabile öffentliche URLs noch serverseitig ausgelieferte Inhalte, kanonische Angaben, Metadaten und strukturierte Daten beeinträchtigen. Geschützte Inhalte dürfen nicht über PWA-Caches öffentlich oder nutzerübergreifend verfügbar werden.
Mobile Performance, Zugänglichkeit und Core Web Vitals sind gemeinsame Anforderungen der Design- und SEO-Prinzipien.
## 12. Inhaltliche Themen- und Suchstrategie
Themen werden aus den fünf Bereichen, der tatsächlichen Trainingspraxis und dem Informationsbedarf der Zielgruppen entwickelt. Mögliche Themenfelder sind persönliche Grenzen, Nein-Sagen, sichere Entscheidungen, Vertrauenspersonen, Hilfeholen, Freundschaft, Zivilcourage und Konfliktbewältigung.
Suchvolumen, Konkurrenz und Suchintention sind **zu messen beziehungsweise zu recherchieren**, nicht zu erfinden. Themencluster bestehen aus wenigen eigenständigen, hilfreichen Beiträgen mit sinnvoller Verbindung zu Programmen und Modulen. Keine massenhaft erzeugten Keyword-Variationen oder künstlich aufgeblähten Landingpages.
## 13. Messung und Marketing-Intelligence
Die Marketingsteuerung soll tatsächliche Datenquellen nutzen, sobald autorisierte Zugänge vorliegen, insbesondere:
- Google Search Console;
- Bing Webmaster Tools und verfügbare KI-Suchleistungsdaten;
- datenschutzkonforme Webanalyse;
- interne Registrierungs-, Nutzungs- und Kaufkennzahlen.
Messbar sind abhängig von der Datenquelle organische Impressionen, Klicks, Suchanfragen, Landingpage-Leistung, Indexierungsprobleme, Registrierungen, Nutzung kostenloser Inhalte, Käufe und Conversion-Raten. Kennzahlen zur Zitation in KI-Antworten werden nur dargestellt, soweit der jeweilige Anbieter entsprechende Daten tatsächlich liefert.
Jede Kennzahl enthält nach Möglichkeit Quelle, Zeitraum und Definition. **Messwerte, Schätzungen, Analysen und KI-Empfehlungen dürfen nicht verwechselt werden.** Fehlende Daten werden als fehlend dargestellt.
## 14. Kontinuierliche Marketingsteuerung
Die Marketingfunktionen arbeiten mit drei klar unterscheidbaren Automatisierungsstufen:
**Datenerhebung und technische Überwachung:** regelmäßige Abfragen vorhandener Schnittstellen, Erkennung auffälliger Veränderungen und Meldung technischer Probleme.
**Analyse und Maßnahmenvorschläge:** Erkennen unvollständiger Seiten, thematischer Chancen, schwacher Landingpages, fehlender interner Links und veralteter Inhalte; Priorisierung anhand nachvollziehbarer Daten.
**Redaktionelle Unterstützung:** Erstellung von Briefings, Themenplänen, Textentwürfen, alternativen Überschriften, Meta-Beschreibungen und Verbesserungsvorschlägen.
KI-generierte Vorschläge werden als solche markiert und im bestehenden CMS als prüfbare Entwürfe behandelt. Neue fachliche Aussagen, öffentliche Kampagnen, externe Kommunikation und bezahlte Werbebudgets benötigen geeignete menschliche Freigaben. Automatische Routinearbeiten können innerhalb definierter Berechtigungen ohne manuelle Einzelfreigabe laufen.
Die automatisierte Vermarktung darf nicht zu einem unkontrollierten SEO-Content-Generator werden. Fachliche Verantwortung und Wahrheitstreue stehen über Veröffentlichungsfrequenz.
## 15. Qualitätssicherung
Für öffentliche Seiten sind insbesondere zu prüfen:
- korrekte Metadaten, kanonische URLs und Statuscodes;
- Sitemap ohne Entwürfe, geschützte oder irrelevante Seiten;
- konsistente Anzeige von Angeboten und Lizenzumfang;
- gültige und sichtbare strukturierte Daten;
- funktionierende Verlinkung zwischen Themen, Modulen, Programmen und Angeboten;
- richtige Bildbeschreibungen und zugängliche Textstruktur;
- keine unerlaubte Veröffentlichung oder Indexierung geschützter Medien;
- mobile Bedienbarkeit, Ladeleistung und Zugänglichkeit;
- korrekte Zuordnung und Definition erhobener Marketingkennzahlen.
**Technische SEO-Korrektheit garantiert keine bestimmte Suchposition.** Die tatsächliche Wirkung ist anhand späterer realer Suchdaten zu beurteilen.
## Normative Bezüge und Fachquellen
- `docs/prinzipien/design-prinzipien.md`
- `docs/fachkonzept/trainingskonzept-und-produktstruktur.md`
- [Google: SEO Starter Guide](https://developers.google.com/search/docs/fundamentals/seo-starter-guide)
- [Google: Helpful, reliable, people-first content](https://developers.google.com/search/docs/fundamentals/creating-helpful-content)
- [Google: AI features and your website](https://developers.google.com/search/docs/appearance/ai-features)
- [Google: Structured data](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data)
- [Google: Sitemaps](https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap)
- [Google: Prevent indexing with noindex](https://developers.google.com/search/docs/crawling-indexing/block-indexing)
- [Bing Webmaster Blog](https://blogs.bing.com/webmaster)
- [WCAG 2.2](https://www.w3.org/TR/WCAG22/)
- [Core Web Vitals](https://web.dev/articles/vitals)
File diff suppressed because it is too large. Load diff
+396
View File
@@ -0,0 +1,396 @@
\# Lara \& Felix – SEO, KI-Suche und autonomes Marketing
Diese Anforderungen ergänzen den bestehenden Cursor-Entwicklungsauftrag.
Marketing und Auffindbarkeit sind integrale Bestandteile der Plattform und müssen bereits bei der Entwicklung der öffentlichen Webseite und des CMS berücksichtigt werden.
\## 1. Strategisches Ziel
Die Plattform soll kontinuierlich qualifizierte Interessenten erreichen, insbesondere Gewaltschutztrainer, Lehrkräfte, pädagogische Fachkräfte und Vereine.
Ziel ist eine nachhaltige Steigerung von:
\- Organischer Sichtbarkeit
\- Qualifizierten Webseitenbesuchen
\- Sichtbarkeit als Quelle in KI-Suchsystemen
\- Registrierungen
\- Nutzung kostenloser Materialien
\- Verkäufen und wiederkehrenden Kunden
Ein bestimmtes Suchmaschinenranking darf nicht garantiert werden.
\## 2. Technische SEO- und GEO-Grundlage
Implementiere für alle geeigneten öffentlichen Seiten:
\- Servergerendertes, semantisches HTML
\- Individuelle Seitentitel und Meta-Beschreibungen
\- Konfigurierbare kanonische URLs
\- XML-Sitemap, automatisch aus veröffentlichten Seiten und Katalogobjekten
\- Korrekte robots.txt-Steuerung
\- Indexierungsregeln für Entwürfe, Archive und geschützte Inhalte
\- Open-Graph-Metadaten und Vorschaubilder
\- Strukturierte Daten nach schema.org, sofern für den konkreten Inhalt sinnvoll und von Suchmaschinen unterstützt
\- Interne Verlinkungen zwischen Themen, Inhalten, Lizenzartikeln und Angeboten
\- Lesbare, stabile URL-Strukturen
\- Weiterleitungen bei Änderung veröffentlichter URL-Pfade
\- Optimierte Bilder und Ladezeiten
\- Mobile-First- und barrierearme Darstellung
Die Testumgebung darf nicht öffentlich indexiert werden.
Private Mitgliederseiten, Bestellungen, personenbezogene Daten und geschützte Medien dürfen niemals über SEO-Funktionen öffentlich zugänglich werden.
\## 3. Dynamische SEO-Seiten aus dem Katalog
Nutze das bestehende flexible Inhalts- und Produktmodell.
Ermögliche automatisch erzeugte beziehungsweise aktualisierte öffentliche Seiten für:
\- Lizenzartikel
\- Filme
\- Übungen
\- Trainingsprogramme
\- Themen
\- Pakete und Angebote
Die Seiten sollen ihre fachlich maßgeblichen Daten aus veröffentlichten Artikel- und Angebotsfassungen beziehen.
Zusätzliche redaktionelle Texte dürfen diese Daten ergänzen.
Es dürfen keine widersprüchlichen Preise, Lizenzrechte oder Leistungszusagen entstehen.
Bereits veröffentlichte Inhalte sollen durch neue Versionen aktualisierbar sein, ohne die bestehenden Versionsregeln zu umgehen.
Nicht jede Kombination von Artikeln, Kategorien oder Schlagwörtern darf automatisch zu einer eigenen indexierbaren Seite führen. Vermeide dünne, doppelte oder ausschließlich für Suchmaschinen erzeugte Seiten.
\## 4. Optimierung für KI-basierte Suche
Gestalte öffentliche Inhalte so, dass Such- und KI-Systeme sie nachvollziehen können:
\- Klare Themenstruktur
\- Verständliche Überschriften
\- Präzise Antworten auf häufige fachliche Fragen
\- Fachlich nachvollziehbare Erklärungen
\- Eindeutige Angaben zu Autoren, Herausgebern und Qualifikationen
\- Belegte Aussagen mit Quellenangaben
\- Strukturierte, konsistente Beschreibung der Inhalte
\- Gut zugängliche Textinformationen zu vorhandenen Filmen
\- Stabile URLs und öffentliche Verlinkbarkeit
Nutze öffentliche Vorschautexte und gegebenenfalls freigegebene Transkriptauszüge, ohne kostenpflichtige oder vertrauliche Inhalte offenzulegen.
Erfinde keine Fachqualifikationen, wissenschaftlichen Belege oder Erfolgsaussagen.
Implementiere keine angeblichen GEO-Tricks ohne belastbare Grundlage.
\## 5. Marketing- und Redaktionsfunktionen
Erweitere das bestehende CMS schrittweise um einen Marketingbereich.
Dieser soll ermöglichen:
\- Verwaltung von Zielgruppen und Themenschwerpunkten
\- Anlage von Themenclustern
\- Planung von Beiträgen und Kampagnen
\- Redaktionelle Landingpages
\- SEO-Prüfung vor Veröffentlichung
\- Vorschläge für interne Verlinkung
\- Identifikation veralteter Inhalte
\- Übersicht geplanter und veröffentlichter Maßnahmen
Marketinginhalte nutzen die vorhandenen Entwurfs-, Revisions- und Veröffentlichungsmechanismen.
Es entsteht kein zweites unabhängiges CMS.
\## 6. Kontinuierliche Marketing Intelligence
Bereite die Integration folgender Datenquellen vor:
\- Google Search Console
\- Bing Webmaster Tools
\- Datenschutzkonforme Webanalyse
\- Interne Registrierung- und Verkaufskennzahlen
Die Anbindung erfolgt über klar getrennte Adapter.
Sobald die erforderlichen Zugänge vorhanden sind, soll das System periodisch:
1\. Suchleistung und Veränderungen analysieren.
2\. Erfolgreiche und schwache Seiten identifizieren.
3\. Relevante Suchanfragen und Themenchancen erkennen.
4\. Fehlende oder unvollständige Inhalte feststellen.
5\. Konkrete Verbesserungsmaßnahmen vorschlagen.
6\. Priorisierte Marketingaufgaben erzeugen.
7\. Die Wirkung durchgeführter Maßnahmen verfolgen.
Unterscheide gemessene Kennzahlen, geschätzte Chancen und KI-generierte Empfehlungen.
\## 7. KI-gestützte Marketingautomatisierung
Plane einen konfigurierbaren Marketingassistenten innerhalb der vorhandenen Plattformarchitektur.
Er soll langfristig:
\- Themen recherchieren
\- Themencluster vorschlagen
\- Content-Briefings erstellen
\- Fachartikelentwürfe vorbereiten
\- Titel und Beschreibungen optimieren
\- Bestehende Seiten auf Verbesserungsmöglichkeiten untersuchen
\- Interne Verlinkungen vorschlagen
\- Marketingmaßnahmen priorisieren
\- Regelmäßige Erfolgsberichte erzeugen
Verwende austauschbare KI-Modelle und konfigurierbare API-Zugänge.
Trenne Vorschlag, fachliche Prüfung, Freigabe und Veröffentlichung.
Technische Routineaufgaben dürfen automatisiert erfolgen. Neue fachliche Aussagen, Wirkungsversprechen, externe Kampagnen und Veröffentlichungen müssen standardmäßig durch einen berechtigten Benutzer freigegeben werden.
Keine unkontrollierte Massenproduktion von SEO-Texten.
\## 8. Marketing-Dashboard
Das Administrationssystem soll schrittweise ein Dashboard erhalten mit:
\- Organischen Impressionen und Klicks
\- Suchanfragen und Landingpages
\- Klickrate und Rankingentwicklung, soweit tatsächlich messbar
\- Registrierungs- und Conversion-Raten
\- Nutzung kostenloser Inhalte
\- Kaufabschlüssen
\- Sichtbarkeit beziehungsweise Quellenzitaten in KI-Suchsystemen, soweit entsprechende Daten bereitgestellt werden
\- Erkannten Problemen und priorisierten Empfehlungen
Kennzeichne nicht vorhandene Daten ausdrücklich. Keine erfundenen Marketingkennzahlen.
\## 9. Entwicklungspriorisierung
\### Sofort in U0 und den ersten CMS-Funktionen
Implementiere die technischen Grundlagen für SEO, strukturierte Seiten, Metadaten, Sitemap, Indexierungssteuerung und ein suchmaschinenfreundliches Design.
\### Während des MVP-Ausbaus
Ergänze dynamische Katalogseiten, Themen- und Landingpages, redaktionelle SEO-Funktionen sowie die Messbarkeit wichtiger Nutzerwege.
\### Danach als kontinuierliche Funktion
Implementiere die Datenintegration, automatisierte Marketinganalysen, KI-gestützte Empfehlungen und die wiederkehrende Marketingsteuerung.
Die automatisierten Marketingfunktionen dürfen den Entwicklungsstart oder die Fertigstellung des funktionsfähigen MVP nicht blockieren.
\## 10. Qualitätssicherung
Prüfe:
\- Öffentliche Seiten enthalten sinnvolle Metadaten.
\- Nicht veröffentlichte und geschützte Inhalte erscheinen nicht in der Sitemap.
\- Mitgliederbereiche bleiben von Suchmaschinen und unberechtigten Nutzern abgeschirmt.
\- Strukturierte Daten stimmen mit sichtbaren Inhalten überein.
\- Geänderte URL-Pfade erzeugen passende Weiterleitungen.
\- Neue Katalogeinträge erzeugen keine unerwünschten Duplikate.
\- Die Webseite erfüllt die festgelegten Performance- und Zugänglichkeitsziele.
\*\*Ziel ist eine technisch hervorragend auffindbare Plattform mit einem dauerhaft messbaren, zunehmend automatisierten Marketingprozess – keine vermeintliche Garantie für Suchmaschinenplatzierungen.\*\*
Setze die Grundlagen im laufenden Entwicklungsauftrag unmittelbar um. Keine neue Architekturstudie und kein zusätzlicher Freigabe-Stopp.
File diff suppressed because it is too large. Load diff
+3
View File
@@ -10,6 +10,9 @@
@import './site.css'; @import './site.css';
@import './sections.css'; @import './sections.css';
@import './widgets.css'; @import './widgets.css';
/* Premium-Widgets nach Brand-UI-Kit v1.6; ersetzen das frühere Hero- und Bild-und-Text-CSS. */
@import './components/lf-hero.css';
@import './components/lf-bild-text.css';
/* /*
* Mitgliederbereich: eigene Anwendungsoberfläche mit eigener Navigation. Er verwendet die gemeinsamen * Mitgliederbereich: eigene Anwendungsoberfläche mit eigener Navigation. Er verwendet die gemeinsamen
+4
View File
@@ -13,6 +13,10 @@ html {
font-size: 100%; font-size: 100%;
line-height: var(--leading-body); line-height: var(--leading-body);
-webkit-text-size-adjust: 100%; -webkit-text-size-adjust: 100%;
/* Platz für den Scrollbalken immer freihalten: kurze und lange Seiten haben dieselbe Breite, nichts springt. */
scrollbar-gutter: stable;
/* Sprungziele und Fokus nicht unter der klebenden Kopfzeile verstecken. */
scroll-padding-top: calc(var(--header-height) + var(--space-4));
} }
body { body {
+14
View File
@@ -29,6 +29,9 @@ .ui-button {
font: inherit; font: inherit;
font-weight: 700; font-weight: 700;
line-height: 1.2; line-height: 1.2;
max-width: 100%;
text-align: center;
overflow-wrap: anywhere;
text-decoration: none; text-decoration: none;
cursor: pointer; cursor: pointer;
transition: background-color 0.15s ease, border-color 0.15s ease; transition: background-color 0.15s ease, border-color 0.15s ease;
@@ -41,6 +44,17 @@ .ui-button:hover {
text-decoration: none; text-decoration: none;
} }
/* Markenschaltfläche: Gelb mit dunkelblauer Schrift (11:1), für die wichtigste Handlung im Seiteneinstieg. */
.button-brand {
background: var(--lf-yellow);
color: var(--lf-navy);
}
.button-brand:hover {
background: #ffe05c;
color: var(--lf-navy);
}
.button-secondary, .button-secondary,
.ui-button-secondary { .ui-button-secondary {
background: transparent; background: transparent;
+226
View File
@@ -0,0 +1,226 @@
/*
* Premium-Bild-und-Text – übernommen aus docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6/components/lf-bild-text.v1.6.css.
* Ersetzt das bisherige Bild-und-Text-CSS (nicht parallel laden). Die Darstellung folgt der tatsächlichen
* Containerbreite, nicht der Einheitenzahl.
*
* Anpassungen an das Repository:
* - Oberfläche „clear“ übernimmt die Bedeutungswerte des Abschnitts (auch auf dunklen Abschnitten lesbar).
* - Überschrift erbt Farbe und Schrift (globale h1–h3-Regeln setzen sonst Navy).
* - Fokusfarbe aus den Tokens; Schriften über --lf-font-display und --lf-font-ui.
*/
.lf-bt-host { container: lf-bt / inline-size; inline-size: 100%; min-inline-size: 0; max-inline-size: 100%; }
.lf-bt-host, .lf-bt-host * { box-sizing: border-box; }
.lf-bt {
--bt-navy: var(--lf-navy, #032551);
--bt-green: var(--lf-green-deep, #3b7b09);
--bt-yellow: var(--lf-yellow, #fcd10a);
--bt-cream: var(--lf-cream, #f7f6f2);
--bt-muted: var(--lf-muted, #46556b);
--bt-eyebrow: #295b08;
--bt-focus-x: 64%;
--bt-focus-y: 43%;
--color-focus: var(--lf-focus);
display: grid;
grid-template-columns: minmax(0, 1fr);
align-items: start;
gap: clamp(0.9rem, 2.65cqi, 2rem);
padding: clamp(1rem, 2.8cqi, 3.25rem);
border-radius: clamp(1rem, 1.8cqi, 1.65rem);
min-inline-size: 0;
max-inline-size: 100%;
background: var(--bt-cream);
color: var(--bt-navy);
font: 400 1rem/1.6 var(--lf-font-ui);
overflow-wrap: break-word;
}
.lf-bt--navy {
--bt-muted: #f0f4f9;
--bt-eyebrow: #fff2b0;
--color-focus: var(--lf-yellow);
background: var(--bt-navy);
color: #fff;
}
/* Ohne eigene Fläche: Farben des Abschnitts (hell, dunkel, Markenakzent). */
.lf-bt--clear {
--bt-muted: var(--color-text-muted);
--bt-eyebrow: var(--color-heading);
--color-focus: inherit;
background: transparent;
color: var(--color-heading);
padding-inline: 0;
}
.lf-bt__copy { min-inline-size: 0; max-inline-size: 49rem; align-self: center; }
.lf-bt__eyebrow {
display: flex;
align-items: center;
gap: 0.6rem;
margin: 0 0 0.8rem;
color: var(--bt-eyebrow);
font-size: 0.73rem;
line-height: 1.45;
font-weight: 800;
letter-spacing: 0.065em;
text-transform: uppercase;
overflow-wrap: anywhere;
}
.lf-bt__eyebrow::before {
content: '';
flex: 0 0 auto;
inline-size: 1.35rem;
block-size: 0.25rem;
background: var(--bt-yellow);
border-radius: 999px;
}
.lf-bt__headline {
margin: 0;
color: inherit;
font-family: var(--lf-font-display);
font-size: clamp(1.55rem, 4.5cqi, 3.35rem);
line-height: 1.14;
letter-spacing: -0.03em;
font-weight: 850;
overflow-wrap: anywhere;
hyphens: manual;
text-wrap: balance;
}
.lf-bt__accent {
display: block;
inline-size: clamp(4.6rem, 12cqi, 7rem);
block-size: 0.36rem;
margin: clamp(0.55rem, 1.7cqi, 1rem) 0 clamp(0.8rem, 2.3cqi, 1.25rem) 0.12rem;
background: var(--bt-yellow);
border-radius: 90% 35% 75% 40%;
transform: rotate(-1deg);
}
.lf-bt__body { color: var(--bt-muted); font-size: clamp(0.97rem, 1.45cqi, 1.12rem); line-height: 1.62; overflow-wrap: anywhere; }
.lf-bt__body > :first-child { margin-block-start: 0; }
.lf-bt__body > :last-child { margin-block-end: 0; }
.lf-bt__body p { margin: 0 0 0.9em; }
.lf-bt__body ul,
.lf-bt__body ol { padding-inline-start: 1.35em; margin: 0.6em 0; }
.lf-bt__body a { color: inherit; text-decoration: underline; text-underline-offset: 0.15em; }
.lf-bt__actions { display: flex; flex-wrap: wrap; align-items: stretch; gap: 0.65rem; margin-block-start: clamp(1rem, 2cqi, 1.5rem); min-inline-size: 0; }
.lf-bt__button {
display: inline-flex;
align-items: center;
justify-content: center;
gap: 0.5rem;
max-inline-size: 100%;
min-inline-size: 0;
min-block-size: 2.95rem;
padding: 0.7rem 1rem;
background: var(--bt-green);
border: 2px solid var(--bt-green);
color: #fff;
border-radius: 999px;
text-decoration: none;
text-align: center;
font-size: 0.89rem;
font-weight: 800;
line-height: 1.33;
overflow-wrap: anywhere;
white-space: normal;
transition: background-color 0.14s ease, transform 0.14s ease;
}
.lf-bt__button:visited { color: #fff; }
.lf-bt__button:hover { background: #285a06; color: #fff; transform: translateY(-1px); }
.lf-bt__button--secondary,
.lf-bt__button--secondary:visited { background: transparent; border-color: currentColor; color: inherit; }
.lf-bt__button--secondary:hover { background: rgb(3 37 81 / 6%); color: inherit; }
.lf-bt--navy .lf-bt__button--secondary:hover,
.scope-dark .lf-bt--clear .lf-bt__button--secondary:hover,
.scope-accent .lf-bt--clear .lf-bt__button--secondary:hover { background: rgb(255 255 255 / 12%); }
.lf-bt__button:focus-visible,
.lf-bt__body a:focus-visible { outline: 3px solid var(--color-focus); outline-offset: 3px; }
.lf-bt__media { position: relative; display: block; order: -1; min-inline-size: 0; isolation: isolate; }
.lf-bt__media::before {
content: '';
position: absolute;
inset: auto -0.42rem -0.45rem 1rem;
z-index: -1;
block-size: 53%;
border-radius: 1.1rem;
background: #8ab848;
transform: rotate(1.5deg);
}
.lf-bt--navy .lf-bt__media::before { background: var(--bt-yellow); }
.lf-bt__image {
display: block;
inline-size: 100%;
max-inline-size: none;
block-size: auto;
aspect-ratio: 16 / 10;
object-fit: cover;
object-position: var(--bt-focus-x) var(--bt-focus-y);
border-radius: clamp(0.78rem, 1.8cqi, 1.3rem);
box-shadow: 0 10px 28px rgb(3 37 81 / 11%);
}
.lf-bt--height-compact .lf-bt__image { aspect-ratio: 16 / 9; }
.lf-bt--height-spacious .lf-bt__image { aspect-ratio: 4 / 3; }
.lf-bt--height-compact { gap: clamp(0.75rem, 2cqi, 1.45rem); }
.lf-bt--height-spacious { gap: clamp(1.15rem, 3.4cqi, 2.7rem); }
.lf-bt--without-image { grid-template-columns: minmax(0, 1fr); }
/* Schmale Plätze: vollständiger Text und Links, keine erzwungene Höhe. */
@container lf-bt (max-width: 539.99px) {
.lf-bt__actions { display: grid; grid-template-columns: minmax(0, 1fr); }
.lf-bt__button { inline-size: 100%; }
.lf-bt__headline { font-size: clamp(1.42rem, 6.8cqi, 2.2rem); }
.lf-bt__eyebrow { letter-spacing: 0.03em; }
}
/* Mittlere Containerbreite (meist zwei Einheiten): flacher Bildstreifen statt gequetschter Zweispaltigkeit. */
@container lf-bt (min-width: 540px) and (max-width: 899.99px) {
.lf-bt { gap: clamp(0.8rem, 1.6cqi, 1.2rem); padding: clamp(1.1rem, 2.4cqi, 1.65rem); }
.lf-bt--clear { padding-inline: 0; }
.lf-bt__media { inline-size: 100%; }
.lf-bt__image { aspect-ratio: 2.15 / 1; }
.lf-bt--height-compact .lf-bt__image { aspect-ratio: 2.5 / 1; }
.lf-bt--height-spacious .lf-bt__image { aspect-ratio: 1.8 / 1; }
.lf-bt__headline { font-size: clamp(1.65rem, 3.6cqi, 2.28rem); }
.lf-bt__body { font-size: 1.01rem; line-height: 1.59; }
.lf-bt__actions { margin-block-start: 0.95rem; }
.lf-bt__button { flex: 1 1 13rem; }
}
/* Breiter Container: zweispaltige Komposition, Bild links oder rechts. */
@container lf-bt (min-width: 900px) {
.lf-bt {
grid-template-columns: minmax(0, 1.02fr) minmax(0, 0.98fr);
align-items: center;
gap: clamp(1.8rem, 4cqi, 4.5rem);
padding: clamp(1.8rem, 4cqi, 4.5rem);
}
.lf-bt--clear { padding-inline: 0; }
.lf-bt__media { order: 0; align-self: stretch; }
.lf-bt--image-left .lf-bt__media { order: -1; }
.lf-bt__image { block-size: 100%; min-block-size: 18rem; aspect-ratio: 4 / 3; }
.lf-bt--height-compact .lf-bt__image { min-block-size: 14rem; aspect-ratio: 3 / 2; }
.lf-bt--height-spacious .lf-bt__image { min-block-size: 24rem; aspect-ratio: 1 / 1; }
.lf-bt--height-compact { padding-block: clamp(1.25rem, 2.8cqi, 2.6rem); }
.lf-bt--height-spacious { padding-block: clamp(2.15rem, 4.5cqi, 4.75rem); }
.lf-bt--without-image { grid-template-columns: minmax(0, 1fr); }
}
@media (prefers-reduced-motion: reduce) {
.lf-bt__button { transition: none; }
.lf-bt__button:hover { transform: none; }
}
+209
View File
@@ -0,0 +1,209 @@
/*
* Premium-Einstieg – übernommen aus docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6/components/lf-hero.v1.6.css.
* Ersetzt das bisherige Hero-CSS (nicht parallel laden).
*
* Anpassungen an das Repository (dokumentiert in docs/architektur/cms-widget-registry.md):
* - Überschrift und Akzent erben Farbe und erhalten Blockdarstellung (die globalen h1–h3-Regeln setzen sonst Navy).
* - Akzentwahl underline/rays/none; Strahlen aus resources/views/components/brand/rays.blade.php.
* - Fokusfarbe und Schriften über die gemeinsamen Tokens (--lf-font-display, --lf-font-ui, --color-focus).
* Die Höhen sind Mindesthöhen ab 860 px Containerbreite; Inhalte vergrößern jede Variante.
*/
.lf-hero-host { container: lf-hero / inline-size; inline-size: 100%; min-inline-size: 0; max-inline-size: 100%; }
.lf-hero-host, .lf-hero-host * { box-sizing: border-box; }
.lf-hero {
--lf-hero-navy: var(--lf-navy, #032551);
--lf-hero-green: var(--lf-green-deep, #3b7b09);
--lf-hero-yellow: var(--lf-yellow, #fcd10a);
--lf-hero-cream: var(--lf-cream, #f7f6f2);
--lf-hero-focus-x: 68%;
--lf-hero-focus-y: 50%;
--color-focus: var(--lf-focus);
isolation: isolate;
position: relative;
display: grid;
align-items: center;
min-inline-size: 0;
min-block-size: 32rem;
max-inline-size: 100%;
border-radius: clamp(1rem, 1.9cqi, 1.75rem);
background: var(--lf-hero-cream);
color: var(--lf-hero-navy);
font-family: var(--lf-font-display);
}
.lf-hero--height-compact { min-block-size: 25rem; }
.lf-hero--height-normal { min-block-size: 32rem; }
.lf-hero--height-large { min-block-size: 40rem; }
.lf-hero__photo {
position: absolute;
inset: 0;
z-index: -2;
inline-size: 100%;
block-size: 100%;
max-inline-size: none;
object-fit: cover;
object-position: var(--lf-hero-focus-x) var(--lf-hero-focus-y);
border-radius: inherit;
}
.lf-hero--photo-split::before {
content: '';
position: absolute;
inset: 0;
z-index: -1;
border-radius: inherit;
background: linear-gradient(90deg, rgb(250 249 243 / 99%) 0%, rgb(250 249 243 / 98%) 28%, rgb(250 249 243 / 85%) 41%, rgb(250 249 243 / 12%) 69%, transparent 80%);
}
.lf-hero--editorial-solid {
--color-focus: var(--lf-yellow);
background: var(--lf-hero-navy);
color: #fff;
}
.lf-hero--editorial-solid::before {
content: '';
position: absolute;
inset: auto -7% -50% auto;
z-index: -1;
inline-size: 40%;
aspect-ratio: 1;
background: var(--lf-hero-green);
border-radius: 50%;
opacity: 0.8;
}
.lf-hero--editorial-solid { overflow: hidden; }
.lf-hero__inner {
inline-size: 100%;
max-inline-size: 1440px;
min-inline-size: 0;
margin-inline: auto;
padding: clamp(1.8rem, 4.3cqi, 5rem);
padding-block: clamp(2.1rem, 5cqi, 5rem);
}
.lf-hero__copy { position: relative; max-inline-size: min(660px, 58%); min-inline-size: 0; }
.lf-hero--editorial-solid .lf-hero__copy { max-inline-size: 760px; }
.lf-hero__eyebrow {
display: inline-block;
margin: 0;
padding: 0.35em 0.75em;
border-radius: 999px;
background: #dff0c0;
color: #17370b;
font-weight: 800;
font-size: clamp(0.78rem, 1.25cqi, 0.95rem);
overflow-wrap: anywhere;
}
.lf-hero__title {
margin: 0.25em 0;
color: inherit;
font-family: inherit;
font-size: clamp(2.1rem, 5.4cqi, 4.9rem);
line-height: 1.06;
letter-spacing: -0.035em;
font-weight: 900;
text-wrap: balance;
overflow-wrap: anywhere;
hyphens: manual;
}
.lf-hero__title-accent {
display: block;
inline-size: clamp(6rem, 15cqi, 15rem);
block-size: 0.42rem;
margin: 0 0 clamp(1.1rem, 2cqi, 1.5rem);
background: var(--lf-hero-yellow);
border-radius: 90% 30% 45% 25%;
transform: rotate(-1deg);
}
.lf-hero__rays {
position: absolute;
inset-block-start: -2.4rem;
inset-inline-start: -2.2rem;
inline-size: clamp(2.6rem, 4.5cqi, 3.6rem);
color: var(--lf-hero-yellow);
transform: rotate(-24deg);
pointer-events: none;
}
.lf-hero__description {
max-inline-size: 56ch;
margin: 0 0 clamp(1.25rem, 2.1cqi, 2rem);
font-family: var(--lf-font-ui);
font-size: clamp(1.05rem, 1.7cqi, 1.3rem);
line-height: 1.5;
overflow-wrap: anywhere;
}
.lf-hero__actions { display: flex; flex-wrap: wrap; align-items: stretch; gap: 0.75rem; min-inline-size: 0; }
.lf-hero__button {
display: inline-flex;
align-items: center;
justify-content: center;
min-inline-size: 0;
max-inline-size: 100%;
min-block-size: 3rem;
padding: 0.77rem 1.2rem;
border: 2px solid transparent;
border-radius: 999px;
font: 800 0.96rem/1.28 var(--lf-font-ui);
text-decoration: none;
text-align: center;
white-space: normal;
overflow-wrap: anywhere;
transition: transform 0.15s ease, background-color 0.15s ease;
}
.lf-hero__button:hover { transform: translateY(-1px); }
.lf-hero__button:focus-visible { outline: 3px solid var(--color-focus); outline-offset: 3px; }
.lf-hero__button--primary,
.lf-hero__button--primary:visited { background: var(--lf-hero-green); color: #fff; }
.lf-hero__button--primary:hover { background: #285a06; color: #fff; }
.lf-hero__button--secondary,
.lf-hero__button--secondary:visited { background: rgb(255 255 255 / 95%); color: var(--lf-hero-navy); border-color: var(--lf-hero-navy); }
.lf-hero__button--secondary:hover { color: var(--lf-hero-navy); }
.lf-hero__bottom {
position: absolute;
inset: auto 0 0;
block-size: 15px;
border-radius: 0 0 1.5rem 1.5rem;
background: linear-gradient(105deg, var(--lf-hero-yellow) 0%, var(--lf-hero-yellow) 22%, var(--lf-hero-green) 72%);
clip-path: polygon(0 45%, 30% 90%, 65% 75%, 100% 0, 100% 100%, 0 100%);
pointer-events: none;
}
/* Sicherheitsumbruch, wenn der Container physisch zu schmal ist; keine eigene redaktionelle Variante. */
@container lf-hero (max-width: 859.99px) {
.lf-hero { display: block; min-block-size: 0; }
.lf-hero--height-compact,
.lf-hero--height-normal,
.lf-hero--height-large { min-block-size: 0; }
.lf-hero__photo { position: relative; display: block; block-size: auto; aspect-ratio: 16 / 9; }
.lf-hero--photo-split::before { display: none; }
.lf-hero__inner { padding: clamp(1.2rem, 3.5cqi, 2rem); padding-block-end: 2.4rem; }
.lf-hero__copy { max-inline-size: 100%; }
.lf-hero__title { font-size: clamp(2rem, 5.5cqi, 3.1rem); }
.lf-hero__description { font-size: 1.07rem; }
.lf-hero--editorial-solid .lf-hero__copy { max-inline-size: 100%; }
.lf-hero__rays { inset-block-start: -1.6rem; inset-inline-start: auto; inset-inline-end: 0; transform: rotate(10deg); }
}
@container lf-hero (max-width: 440px) {
.lf-hero__actions { display: grid; grid-template-columns: minmax(0, 1fr); }
.lf-hero__button { inline-size: 100%; }
}
@media (prefers-reduced-motion: reduce) {
.lf-hero__button { transition: none; }
.lf-hero__button:hover { transform: none; }
}
+294 -111
View File
@@ -31,24 +31,88 @@ .brand-claim {
white-space: nowrap; white-space: nowrap;
} }
/* Kopfzeile: kompakt und klebend; nimmt höchstens 4,5 rem ein. */ /* Website-Variante: Name und Zusatz als grünes Schild (Brand-Kit 05_web_preview). Weiß auf Grün dunkel 5,2:1. */
.site-header { .brand-lockup {
position: sticky; flex: none;
top: 0; align-items: flex-start;
z-index: 50; gap: 0.3rem;
background: var(--lf-white);
border-bottom: 1px solid var(--color-border);
} }
.site-header.is-scrolled { .brand-lockup .brand-name {
box-shadow: 0 6px 18px rgb(3 37 81 / 8%); font-size: 1.5rem;
color: var(--color-heading);
}
.brand-lockup .brand-claim {
font-family: var(--font-display);
font-size: 0.75rem;
font-weight: 800;
letter-spacing: 0.01em;
color: var(--lf-white);
background: var(--lf-green-deep);
border-radius: var(--radius-pill);
padding: 0.2rem 0.6rem 0.25rem;
}
/*
* Kopfzeile. Die Box hat immer dieselbe Höhe (--header-height-initial) und klebt mit negativem Abstand.
* Die innere Leiste klebt oben: Beim Scrollen wandert sie um den Unterschied nach oben, danach bleibt
* genau die kompakte Leiste stehen. Der Seitenfluss ändert sich nie; ohne JavaScript funktioniert es genauso.
*/
.site-header-sentinel {
position: absolute;
top: 0;
left: 0;
width: 1px;
height: max(1px, var(--header-height-initial) - var(--header-height));
pointer-events: none;
}
.site-header {
position: sticky;
top: calc(var(--header-height) - var(--header-height-initial));
z-index: 50;
height: var(--header-height-initial);
background: var(--lf-white);
box-shadow: 0 1px 0 var(--color-border);
transition: box-shadow 0.2s ease;
}
.site-header.is-compact {
box-shadow: 0 1px 0 var(--color-border), 0 8px 22px rgb(3 37 81 / 8%);
}
/* Außenabstand statt Innenabstand der Kopfzeile: Klebende Elemente bleiben in der Inhaltsbox ihres Elternelements. */
.site-header-bar {
position: sticky;
top: 0;
height: var(--header-height);
margin-top: calc((var(--header-height-initial) - var(--header-height)) / 2);
} }
.site-header-inner { .site-header-inner {
display: flex; display: flex;
align-items: center; align-items: center;
gap: var(--space-4) var(--space-6); gap: var(--space-4) var(--space-6);
min-height: var(--header-height); height: 100%;
}
/* Großzügige Wortmarke im Ausgangszustand, kompakt beim Scrollen. Nur transform: keine Layoutverschiebung. */
@media (min-width: 75rem) {
.site-header .brand-lockup {
transform-origin: left center;
transform: scale(1.16);
transition: transform 0.22s ease;
}
.site-header.is-compact .brand-lockup {
transform: none;
}
/* Platz für die skalierte Wortmarke, damit die Navigation nicht überdeckt wird. */
.site-header .site-nav {
margin-left: var(--space-6);
}
} }
.site-header-actions { .site-header-actions {
@@ -56,6 +120,7 @@ .site-header-actions {
align-items: center; align-items: center;
gap: var(--space-2); gap: var(--space-2);
margin-left: auto; margin-left: auto;
flex: none;
} }
.site-icon-link, .site-icon-link,
@@ -66,21 +131,24 @@ .site-menu-button {
gap: var(--space-2); gap: var(--space-2);
min-width: var(--touch-target); min-width: var(--touch-target);
min-height: var(--touch-target); min-height: var(--touch-target);
padding: 0 var(--space-3); padding: 0 var(--space-4);
border: 1px solid var(--color-border-strong); border: 2px solid var(--lf-navy);
border-radius: var(--radius-pill); border-radius: var(--radius-pill);
background: transparent; background: transparent;
color: var(--color-heading); color: var(--lf-navy);
font: inherit; font: inherit;
font-weight: 600; font-size: 1rem;
font-weight: 700;
white-space: nowrap;
text-decoration: none; text-decoration: none;
cursor: pointer; cursor: pointer;
transition: background-color 0.15s ease, color 0.15s ease;
} }
.site-icon-link:hover, .site-icon-link:hover,
.site-menu-button:hover { .site-menu-button:hover {
border-color: var(--color-heading); background: var(--lf-navy);
color: var(--color-heading); color: var(--lf-white);
} }
.site-icon-link svg, .site-icon-link svg,
@@ -90,7 +158,7 @@ .site-menu-button svg {
flex: none; flex: none;
} }
/* Hauptnavigation (Desktop) */ /* Hauptnavigation (Desktop): eine Zeile, nie umbrechend. Passt sie nicht, schaltet site-nav.js in den Menümodus. */
.site-nav-list, .site-nav-list,
.site-subnav { .site-subnav {
list-style: none; list-style: none;
@@ -105,36 +173,56 @@ .site-nav {
.site-nav-list { .site-nav-list {
display: flex; display: flex;
flex-wrap: wrap; flex-wrap: nowrap;
align-items: center; align-items: center;
gap: var(--space-1) 0; gap: 0 var(--space-1);
} }
.site-nav-item { .site-nav-item {
position: relative; position: relative;
display: flex; display: flex;
align-items: center; align-items: center;
flex: none;
} }
.site-nav a { .site-nav a {
position: relative;
display: inline-flex; display: inline-flex;
align-items: center; align-items: center;
min-height: var(--touch-target); min-height: var(--touch-target);
padding: 0 0.6rem; padding: 0 0.55rem;
font-size: 1rem; font-size: 1rem;
color: var(--color-heading); color: var(--lf-navy);
font-weight: 600; font-weight: 600;
white-space: nowrap;
text-decoration: none; text-decoration: none;
border-radius: var(--radius-small); border-radius: var(--radius-small);
} }
.site-nav a:hover { .site-nav a:hover {
color: var(--lf-navy);
text-decoration: underline; text-decoration: underline;
text-decoration-thickness: 2px;
text-underline-offset: 0.35em;
} }
.site-nav a[aria-current='page'], /* Aktive Seite: gelbe Markenunterstreichung (Brand-Kit), zusätzlich aria-current für Hilfsmittel. */
.site-nav .is-active-trail > a { .site-nav-list > .site-nav-item > a[aria-current='page']::after,
box-shadow: inset 0 -3px 0 var(--color-accent); .site-nav-list > .site-nav-item.is-active-trail > a::after {
content: '';
position: absolute;
left: 0.55rem;
right: 0.55rem;
bottom: 0.2rem;
height: 0.3rem;
border-radius: 0.3rem;
background: var(--lf-yellow);
transform: rotate(-1deg);
}
.site-nav-list > .site-nav-item > a[aria-current='page']:hover,
.site-nav-list > .site-nav-item.is-active-trail > a:hover {
text-decoration: none;
} }
.site-nav-toggle { .site-nav-toggle {
@@ -143,9 +231,10 @@ .site-nav-toggle {
justify-content: center; justify-content: center;
width: 2rem; width: 2rem;
min-height: var(--touch-target); min-height: var(--touch-target);
margin-left: -0.4rem;
border: 0; border: 0;
background: transparent; background: transparent;
color: var(--color-heading); color: var(--lf-navy);
cursor: pointer; cursor: pointer;
border-radius: var(--radius-small); border-radius: var(--radius-small);
} }
@@ -168,37 +257,41 @@ .site-subnav a {
width: 100%; width: 100%;
} }
@media (min-width: 75rem) { .site-header:not(.is-menu-mode) .site-subnav {
.site-subnav { position: absolute;
position: absolute; top: calc(100% + 0.25rem);
top: 100%; left: 0;
left: 0; min-width: 15rem;
min-width: 15rem; padding: var(--space-2);
padding: var(--space-2); background: var(--lf-white);
background: var(--lf-white); border: 1px solid var(--color-border);
border: 1px solid var(--color-border); border-radius: var(--radius-card);
border-radius: var(--radius-card); box-shadow: var(--shadow-raised);
box-shadow: var(--shadow-raised); }
}
.site-nav-item.is-open > .site-subnav { .site-header:not(.is-menu-mode) .site-nav-item.is-open > .site-subnav {
display: block; display: block;
}
} }
.site-menu-button { .site-menu-button {
display: none; display: none;
} }
/* /* Kontozugang nur als Symbol: unter 75 rem und wenn die Navigation sonst nicht in eine Zeile passt. */
* Mobile Navigation (unter 75 rem, nur mit JavaScript): Menü-Schaltfläche in der Kopfzeile öffnet eine .site-header.is-account-compact .site-account-label {
* Fläche unter der Kopfzeile. Ohne JavaScript bleibt die Navigation als umbrechende Liste sichtbar. position: absolute;
*/ width: 1px;
@media (max-width: 74.99rem) { height: 1px;
.site-header-inner { overflow: hidden;
flex-wrap: wrap; clip: rect(0 0 0 0);
} white-space: nowrap;
}
.site-header.is-account-compact .site-account-link {
padding: 0;
}
@media (max-width: 74.99rem) {
.site-account-label { .site-account-label {
position: absolute; position: absolute;
width: 1px; width: 1px;
@@ -208,65 +301,100 @@ @media (max-width: 74.99rem) {
white-space: nowrap; white-space: nowrap;
} }
.site-icon-link {
padding: 0;
}
/* Ohne JavaScript: Navigation als umbrechende Liste unter der Leiste, Kopfzeile wächst mit. */
html:not(.js) .site-header {
height: auto;
}
html:not(.js) .site-header-bar {
position: static;
height: auto;
margin-top: 0;
}
html:not(.js) .site-header-inner {
flex-wrap: wrap;
min-height: var(--header-height);
}
html:not(.js) .site-nav { html:not(.js) .site-nav {
order: 3; order: 3;
flex-basis: 100%; flex-basis: 100%;
padding-bottom: var(--space-2); padding-bottom: var(--space-2);
} }
html.js .site-menu-button { html:not(.js) .site-nav-list {
display: inline-flex; flex-wrap: wrap;
} }
}
html.js .site-nav { /*
display: none; * Menümodus (mit JavaScript): unter 75 rem und immer dann, wenn die Navigation aus dem CMS nicht in eine Zeile passt.
position: fixed; * Die Menü-Schaltfläche öffnet eine Fläche unter der sichtbaren Leiste. Keine Navigation am unteren Bildschirmrand.
inset: var(--header-height) 0 0; */
z-index: 49; .site-header.is-menu-mode .site-menu-button {
overflow-y: auto; display: inline-flex;
overscroll-behavior: contain; }
background: var(--lf-white);
padding: var(--space-4) var(--gutter) var(--space-8);
border-top: 1px solid var(--color-border);
}
html.js .site-header.is-menu-open .site-nav { .site-header.is-menu-mode .site-nav {
display: block; display: none;
} position: fixed;
inset: var(--site-menu-top, var(--header-height)) 0 0;
z-index: 49;
overflow-y: auto;
overscroll-behavior: contain;
margin: 0;
background: var(--lf-white);
padding: var(--space-4) var(--gutter) var(--space-8);
border-top: 1px solid var(--color-border);
}
html.js .site-nav-list { .site-header.is-menu-mode.is-menu-open .site-nav {
display: block; display: block;
} }
html.js .site-nav-item { .site-header.is-menu-mode .site-nav-list {
display: block; display: block;
border-bottom: 1px solid var(--color-border); }
}
html.js .site-nav a { .site-header.is-menu-mode .site-nav-item {
min-height: 3rem; display: block;
font-size: 1.125rem; border-bottom: 1px solid var(--color-border);
width: 100%; }
}
html.js .site-nav-toggle { .site-header.is-menu-mode .site-nav a {
display: none; min-height: 3rem;
} font-size: 1.125rem;
width: 100%;
white-space: normal;
}
html.js .site-subnav { .site-header.is-menu-mode .site-nav-list > .site-nav-item > a::after {
display: block; right: auto;
padding: 0 0 var(--space-2) var(--space-4); width: 3rem;
} }
html.js .site-subnav a { .site-header.is-menu-mode .site-nav-toggle {
font-size: 1rem; display: none;
font-weight: 400; }
min-height: var(--touch-target);
}
body.has-open-menu { .site-header.is-menu-mode .site-subnav {
overflow: hidden; display: block;
} padding: 0 0 var(--space-2) var(--space-4);
}
.site-header.is-menu-mode .site-subnav a {
font-size: 1rem;
font-weight: 400;
min-height: var(--touch-target);
}
body.has-open-menu {
overflow: hidden;
} }
/* Inhaltsfläche */ /* Inhaltsfläche */
@@ -344,22 +472,31 @@ .course-actions {
gap: var(--space-2); gap: var(--space-2);
} }
/* Fußbereich */ /* Fußbereich: dunkle Markenfläche, Wortmarke, Linkgruppen aus dem CMS, grüner Bogen als Abschluss. */
.site-footer { .site-footer {
position: relative;
overflow: hidden;
isolation: isolate;
background: var(--color-surface); background: var(--color-surface);
color: var(--color-text); color: var(--color-text);
padding: var(--space-8) 0 var(--space-7); padding: clamp(3rem, 2rem + 4vw, 5rem) 0 0;
margin-top: 0; margin-top: 0;
} }
/* Endet die Seite mit einer dunklen Fläche, trennt eine feine Linie sie vom Fußbereich. */
main:has(> .page-section.scope-dark:last-child) + .site-footer {
box-shadow: inset 0 1px 0 rgb(255 255 255 / 18%);
}
.site-footer-inner { .site-footer-inner {
display: grid; display: grid;
gap: var(--space-6) var(--space-7); gap: var(--space-6) var(--space-7);
padding-bottom: clamp(2.5rem, 2rem + 2vw, 3.5rem);
} }
@media (min-width: 48rem) { @media (min-width: 48rem) {
.site-footer-inner { .site-footer-inner {
grid-template-columns: minmax(12rem, 1.2fr) repeat(auto-fit, minmax(11rem, 1fr)); grid-template-columns: minmax(13rem, 1.3fr) repeat(auto-fit, minmax(11rem, 1fr));
} }
} }
@@ -367,21 +504,17 @@ .site-footer .brand {
color: var(--color-heading); color: var(--color-heading);
} }
.site-footer-brand p { .site-footer .brand-lockup .brand-name {
margin: var(--space-3) 0 0; font-size: 1.75rem;
color: var(--color-text-muted);
font-size: var(--text-small);
max-width: 22rem;
} }
.site-footer h2 { .site-footer h2 {
font-family: var(--font-reading); font-family: var(--font-display);
font-size: 0.875rem; font-size: 1.0625rem;
font-weight: 700; font-weight: 800;
letter-spacing: 0.08em; letter-spacing: 0;
text-transform: uppercase; color: var(--color-heading);
color: var(--color-text-muted); margin: 0 0 var(--space-2);
margin: 0 0 var(--space-3);
} }
.site-footer ul { .site-footer ul {
@@ -394,15 +527,65 @@ .site-footer li a {
display: inline-flex; display: inline-flex;
align-items: center; align-items: center;
min-height: var(--touch-target); min-height: var(--touch-target);
color: var(--color-link); color: var(--color-text-muted);
text-decoration: none;
} }
.site-footer-meta { .site-footer li a:hover,
grid-column: 1 / -1; .site-footer li a[aria-current='page'] {
color: var(--color-link-hover);
text-decoration: underline;
}
/* Grundzeile mit den rechtlichen Links; der Bogen läuft rechts darunter aus. */
.site-footer-base {
position: relative;
z-index: 1;
border-top: 1px solid var(--color-border); border-top: 1px solid var(--color-border);
padding-top: var(--space-4); padding: var(--space-3) 0 clamp(3rem, 2rem + 4vw, 4.5rem);
}
.site-footer-base ul {
display: flex;
flex-wrap: wrap;
gap: 0 var(--space-5);
}
/* Helle Schrift: auf Navy 14:1, auf dem grünen Bogen 4,8:1. */
.site-footer-base li a {
font-size: var(--text-small); font-size: var(--text-small);
color: var(--color-text-muted); color: var(--color-text);
}
/* Grün dunkel unter weißer Schrift: 5,2:1, auch wenn der Bogen Links berührt. */
.site-footer-arc {
position: absolute;
right: 0;
bottom: 0;
z-index: -1;
width: min(46rem, 70%);
height: clamp(2.5rem, 1.5rem + 4vw, 5rem);
color: var(--lf-green-deep);
}
.site-footer:not(:has(.site-footer-base)) .site-footer-inner {
padding-bottom: clamp(4rem, 3rem + 4vw, 6rem);
}
/* Markenakzente (Brand-Kit 03_svg_entwuerfe, Entwürfe). Nur dekorativ, Farbe über Tokens. */
.brand-underline {
display: block;
width: 100%;
height: 0.55em;
color: var(--color-accent);
overflow: visible;
}
.brand-rays {
display: block;
width: 3.5rem;
height: auto;
color: var(--lf-yellow);
} }
/* Fußbereich schließt auch kurze Seiten am unteren Rand ab (nicht im Mitgliederbereich). */ /* Fußbereich schließt auch kurze Seiten am unteren Rand ab (nicht im Mitgliederbereich). */
+32 -6
View File
@@ -71,6 +71,11 @@ :root {
--color-theme-4: var(--color-surface-subtle); --color-theme-4: var(--color-surface-subtle);
--color-theme-5: var(--color-surface-subtle); --color-theme-5: var(--color-surface-subtle);
/* Schriftvariablen der Kit-Komponenten (Brand-UI-Kit v1.6) zeigen auf die gemeinsamen Schriften. */
--lf-font-display: var(--font-display);
--lf-font-ui: var(--font-reading);
--lf-muted: #46556b;
/* Typografie (Website-Zielkonzept 7.2: Fließtext 17 → 18 px, H1 34 → 52 px) */ /* Typografie (Website-Zielkonzept 7.2: Fließtext 17 → 18 px, H1 34 → 52 px) */
--font-reading: var(--font-sans); --font-reading: var(--font-sans);
--text-small: 0.9375rem; --text-small: 0.9375rem;
@@ -101,19 +106,40 @@ :root {
--radius-pill: 999px; --radius-pill: 999px;
--shadow-raised: 0 10px 28px rgb(3 37 81 / 8%); --shadow-raised: 0 10px 28px rgb(3 37 81 / 8%);
/* Layoutmaße */ /*
--gutter: clamp(1rem, 4vw, 2rem); * Breitenmodell (Designiteration 1). Vier semantische Stufen; die Abschnittsbreiten des Editors
--grid-gap: clamp(1.25rem, 2.5vw, 2rem); * (narrow, standard, wide, full) zeigen auf sie. Hintergründe reichen immer über die ganze Fensterbreite,
--container-narrow: 45rem; * nur der Inhalt wird begrenzt.
--container-standard: 75rem; * - Lesebereich: lange Texte, Formulare
--container-wide: 90rem; * - Standard: Grundraster der Website; Kopfzeile, Fußbereich und Seiteninhalt fluchten hier
* - Breit: bildstarke Kompositionen auf großen Bildschirmen
* - Vollbreite: Inhalt bis an den Seitenrand (mit Randabstand)
*/
--gutter: clamp(1rem, 4vw, 2.5rem);
--grid-gap: clamp(1.25rem, 2.5vw, 2.25rem);
--width-reading: 44rem;
--width-standard: 82rem;
--width-wide: 96rem;
--container-narrow: var(--width-reading);
--container-standard: var(--width-standard);
--container-wide: var(--width-wide);
/* Linker Rand des Grundrasters innerhalb einer fensterbreiten Fläche (ohne 100vw, daher ohne Scrollbalken-Fehler). */
--frame-inset: max(var(--gutter), (100% - var(--width-standard)) / 2);
/*
* Kopfzeile: zwei Zustände bei unveränderter Box (kein Layoutsprung). Die Kopfzeile ist
* --header-height-initial hoch und klebt mit negativem Abstand, sodass beim Scrollen nur die
* kompakte Leiste (--header-height) sichtbar bleibt. Auf Smartphones sind beide Werte gleich.
*/
--header-height: 4rem; --header-height: 4rem;
--header-height-initial: 4rem;
--touch-target: 2.75rem; --touch-target: 2.75rem;
} }
@media (min-width: 75rem) { @media (min-width: 75rem) {
:root { :root {
--header-height: 4.5rem; --header-height: 4.5rem;
--header-height-initial: 6.5rem;
} }
} }
+281 -145
View File
@@ -1,11 +1,37 @@
/* /*
* Widget-Ansichten. Jede Regel verwendet Bedeutungswerte und richtet sich nach der Slotbreite * Widget-Ansichten der Bestandswidgets. Jede Regel verwendet Bedeutungswerte und richtet sich nach der Slotbreite
* (Container „slot“), nicht nach dem Fenster. Die visuelle Veredelung einzelner Widgets erfolgt später; * (Container „slot“), nicht nach dem Fenster. Markenakzente (Unterstreichung, Strahlen) stammen aus
* Struktur und Klassen bleiben dafür stabil. * resources/views/components/brand und sind dekorativ.
*/ */
.widget { .widget {
min-width: 0;
color: var(--color-text); color: var(--color-text);
overflow-wrap: break-word;
}
/*
* Gemeinsamer Layoutvertrag (ADR-38): Höhe „fill“ streckt das Widget auf die Höhe der Abschnittszeile, wenn Plätze
* nebeneinander stehen. Gestapelt (schmaler Abschnitt) entspricht das der Inhaltshöhe. Inhalte werden nie begrenzt.
*/
.section-slot:has(> .widget-height-fill) {
align-self: stretch;
display: flex;
flex-direction: column;
}
.section-slot > .widget-height-fill {
flex: 1 1 auto;
display: flex;
flex-direction: column;
}
.widget-height-fill > .cta {
flex: 1 1 auto;
display: flex;
flex-direction: column;
justify-content: center;
align-items: flex-start;
} }
.widget > :last-child, .widget > :last-child,
@@ -19,229 +45,327 @@ .widget-heading h2 {
max-width: 22ch; max-width: 22ch;
} }
/* Einstieg (Hero). Varianten: standard, highlight. Stufen: schmal (Bild unter Text), breit (nebeneinander). */
.hero {
display: grid;
gap: var(--space-5);
align-items: center;
}
.hero h1,
.hero h2 {
font-size: clamp(2rem, 1.1rem + 4.2cqi, 3.5rem);
max-width: 16ch;
}
.hero .lede {
max-width: 52ch;
}
.hero .button {
margin-top: var(--space-2);
}
.hero-image {
width: 100%;
display: block;
border-radius: var(--radius-panel);
aspect-ratio: 4 / 3;
object-fit: cover;
}
@container slot (min-width: 48rem) {
.hero-with-image {
grid-template-columns: minmax(0, 1.1fr) minmax(0, 1fr);
gap: var(--space-7);
}
}
.hero-highlight {
padding: clamp(1.5rem, 5cqi, 3.5rem);
border-radius: var(--radius-panel);
background: var(--lf-navy);
--color-text: #f4f6f8;
--color-heading: var(--lf-white);
--color-link: var(--lf-white);
--color-focus: var(--lf-yellow);
--color-action: var(--lf-yellow);
--color-action-hover: #ffe05c;
--color-action-text: var(--lf-navy);
color: var(--color-text);
}
/* Fließtext */ /* Fließtext */
.widget-prose .prose p { .widget-prose .prose p {
margin: 0 0 var(--space-4); margin: 0 0 var(--space-4);
} }
/* Bild und Text. Varianten: image_left, image_right. Stufen: schmal (gestapelt), breit (nebeneinander ab 36rem). */ /* ------------------------------------------------------------------------------------------------
.image-text { * Redaktionelle Karten. Varianten: Raster (cards-grid), kompakte Liste (cards-compact),
display: grid; * erste Karte hervorgehoben (cards-featured). Die ganze Karte ist über den Titellink klickbar.
gap: var(--space-5); * ---------------------------------------------------------------------------------------------- */
}
.image-text img {
width: 100%;
display: block;
border-radius: var(--radius-card);
}
@container slot (min-width: 36rem) {
.image-text {
grid-template-columns: minmax(12rem, 0.8fr) minmax(0, 1.2fr);
align-items: center;
gap: var(--space-6);
}
.image-text-right {
grid-template-columns: minmax(0, 1.2fr) minmax(12rem, 0.8fr);
}
.image-text-right > img {
order: 2;
}
.image-text-no-image {
grid-template-columns: minmax(0, 1fr);
}
}
.image-text-copy > :first-child {
margin-top: 0;
}
/* Redaktionelle Karten. Varianten: Raster (cards-grid), kompakte Liste (cards-compact). */
.cards { .cards {
--card-surface: var(--lf-cream);
display: grid; display: grid;
grid-template-columns: repeat(auto-fill, minmax(min(14rem, 100%), 1fr)); grid-template-columns: repeat(auto-fill, minmax(min(15rem, 100%), 1fr));
gap: var(--space-4); gap: var(--grid-gap);
list-style: none; list-style: none;
padding: 0; padding: 0;
margin: 0; margin: 0;
} }
.section-bg-light .cards,
.scope-dark .cards,
.scope-accent .cards,
.section-bg-image .cards {
--card-surface: var(--lf-white);
}
.card { .card {
background: var(--lf-white); position: relative;
border: 1px solid var(--lf-line); display: flex;
flex-direction: column;
background: var(--card-surface);
border-radius: var(--radius-card); border-radius: var(--radius-card);
padding: var(--space-5);
overflow: hidden; overflow: hidden;
color: var(--lf-ink); color: var(--lf-ink);
--color-text: var(--lf-ink); --color-text: var(--lf-ink);
--color-text-muted: var(--lf-ink-muted);
--color-heading: var(--lf-navy); --color-heading: var(--lf-navy);
--color-link: var(--lf-navy); --color-link: var(--lf-navy);
--color-focus: var(--lf-focus); --color-focus: var(--lf-focus);
} }
.card h3 { .card-media {
margin: 0 0 var(--space-2); aspect-ratio: 3 / 2;
} overflow: hidden;
background: var(--lf-green-tint);
.card p {
margin: 0;
color: var(--lf-ink-muted);
}
.card a {
color: inherit;
text-decoration: none;
display: block;
}
.card a:hover h3 {
text-decoration: underline;
} }
.card-image { .card-image {
display: block; display: block;
width: calc(100% + 2 * var(--space-5)); width: 100%;
max-width: none; height: 100%;
aspect-ratio: 4 / 3;
object-fit: cover; object-fit: cover;
margin: calc(-1 * var(--space-5)) calc(-1 * var(--space-5)) var(--space-4);
} }
.card-body {
display: grid;
gap: var(--space-2);
padding: var(--space-5);
}
.card-title {
font-size: clamp(1.1875rem, 1.1rem + 0.4cqi, 1.375rem);
line-height: 1.2;
margin: 0;
}
.card-title a {
color: inherit;
text-decoration: none;
}
/* Gestreckter Link: die ganze Karte ist klickbar, ein einziger Tabstopp. */
.card-title a::after {
content: '';
position: absolute;
inset: 0;
border-radius: inherit;
}
.card-linked:hover .card-title a {
text-decoration: underline;
text-decoration-thickness: 2px;
text-underline-offset: 0.2em;
}
.card-linked:has(a:focus-visible) {
outline: 3px solid var(--color-focus);
outline-offset: 3px;
}
.card-title a:focus-visible {
outline: none;
}
.card p {
margin: 0;
color: var(--color-text-muted);
}
/* Karte ohne Bild: gelbe Markenkante oben. */
.cards-grid .card:not(.card-with-image),
.cards-featured .card:not(.card-with-image) {
box-shadow: inset 0 5px 0 var(--lf-yellow);
}
/* Hervorgehoben: Die erste Karte nimmt die ganze Zeile ein, ab 44rem Bild neben dem Text. */
.cards-featured .card-lead {
grid-column: 1 / -1;
}
.cards-featured .card-lead .card-title {
font-size: clamp(1.5rem, 1.1rem + 1.8cqi, 2.25rem);
}
.cards-featured .card-lead .card-body {
padding: clamp(1.5rem, 4cqi, 3rem);
align-content: center;
}
@container slot (min-width: 44rem) {
.cards-featured .card-lead.card-with-image {
display: grid;
grid-template-columns: minmax(0, 1.25fr) minmax(0, 1fr);
}
.cards-featured .card-lead .card-media {
aspect-ratio: auto;
min-height: 20rem;
}
}
/* Kompakte Liste: redaktionelle Zeilen mit Trennlinie, Bild klein rechts. */
.cards-compact { .cards-compact {
grid-template-columns: minmax(0, 1fr); grid-template-columns: minmax(0, 1fr);
gap: 0; gap: 0;
} }
.cards-compact .card { .cards-compact .card {
border-width: 0 0 1px; flex-direction: row-reverse;
align-items: center;
gap: var(--space-4);
border-radius: 0; border-radius: 0;
background: transparent; background: transparent;
padding: var(--space-3) 0; border-top: 1px solid var(--color-border);
color: var(--color-text); color: var(--color-text);
--color-text: inherit;
--color-heading: inherit; --color-heading: inherit;
border-color: var(--color-border); --color-link: inherit;
--color-text-muted: inherit;
overflow: visible;
}
.cards-compact .card:last-child {
border-bottom: 1px solid var(--color-border);
}
.cards-compact .card-body {
flex: 1;
padding: var(--space-4) 0;
} }
.cards-compact .card p { .cards-compact .card p {
color: var(--color-text-muted); opacity: 0.88;
} }
.cards-compact .card-image { .cards-compact .card-media {
display: none; flex: none;
width: clamp(4.5rem, 18cqi, 6.5rem);
aspect-ratio: 1;
margin-block: var(--space-3);
border-radius: var(--radius-small);
}
/* ------------------------------------------------------------------------------------------------
* Programm- und Modulkarten. Inhalte aus den Fachdaten; die Markentafel trägt die Art (Programm, Modul).
* Stufen: schmal gestapelt; ab 40rem Slotbreite bei einer Karte Tafel neben dem Text; Liste in „compact“.
* ---------------------------------------------------------------------------------------------- */
.catalog-cards > h2 {
max-width: 22ch;
} }
/* Programm- und Modulkarten. Inhalte kommen aus den Fachdaten. */
.catalog-list { .catalog-list {
display: grid; display: grid;
grid-template-columns: repeat(auto-fill, minmax(min(16rem, 100%), 1fr)); grid-template-columns: repeat(auto-fill, minmax(min(17rem, 100%), 1fr));
gap: var(--space-4); gap: var(--grid-gap);
list-style: none; list-style: none;
padding: 0; padding: 0;
margin: var(--space-4) 0 0; margin: var(--space-5) 0 0;
}
.catalog-cards > :first-child + .catalog-list,
.catalog-cards > .catalog-list:first-child {
margin-top: 0;
} }
.catalog-card { .catalog-card {
position: relative;
display: flex;
flex-direction: column;
background: var(--lf-white); background: var(--lf-white);
border: 1px solid var(--lf-line); border: 1px solid var(--lf-line);
border-radius: var(--radius-card); border-radius: var(--radius-card);
overflow: hidden; overflow: hidden;
display: flex;
flex-direction: column;
color: var(--lf-ink); color: var(--lf-ink);
--color-text: var(--lf-ink); --color-text: var(--lf-ink);
--color-text-muted: var(--lf-ink-muted);
--color-heading: var(--lf-navy); --color-heading: var(--lf-navy);
--color-link: var(--lf-navy); --color-link: var(--lf-navy);
--color-focus: var(--lf-focus); --color-focus: var(--lf-focus);
} }
.catalog-card-visual { .catalog-card-visual {
background: var(--lf-cream); position: relative;
border-bottom: 4px solid var(--lf-yellow);
min-height: 6rem;
display: flex; display: flex;
align-items: flex-end; align-items: flex-end;
padding: var(--space-3) var(--space-4); min-height: 7rem;
padding: var(--space-4) var(--space-5);
background: var(--lf-navy);
border-bottom: 5px solid var(--lf-yellow);
}
/* Auf dunklen Flächen trägt Grün dunkel die Tafel, damit sie sich vom Abschnitt abhebt. */
.scope-dark .catalog-card-visual {
background: var(--lf-green-deep);
} }
.catalog-card-visual span { .catalog-card-visual span {
font-family: var(--font-display); font-family: var(--font-display);
font-weight: 800; font-weight: 800;
font-size: 1.125rem; font-size: 1.25rem;
color: var(--lf-navy); color: var(--lf-white);
}
.catalog-card-rays {
position: absolute;
top: var(--space-4);
right: var(--space-5);
width: 2.75rem;
} }
.catalog-card-body { .catalog-card-body {
padding: var(--space-4) var(--space-5) var(--space-5); display: grid;
gap: var(--space-2);
align-content: start;
padding: var(--space-5);
} }
.catalog-card-body h3 { .catalog-card-body h3 {
margin: 0 0 var(--space-2); font-size: clamp(1.25rem, 1.15rem + 0.5cqi, 1.5rem);
line-height: 1.2;
margin: 0;
}
.catalog-card-body h3 a {
color: inherit;
text-decoration: none;
}
.catalog-card-linked h3 a::after {
content: '';
position: absolute;
inset: 0;
}
.catalog-card-linked:hover h3 a {
text-decoration: underline;
text-decoration-thickness: 2px;
text-underline-offset: 0.2em;
}
.catalog-card-linked:has(a:focus-visible) {
outline: 3px solid var(--color-focus);
outline-offset: 3px;
}
.catalog-card-linked h3 a:focus-visible {
outline: none;
} }
.catalog-card-body p { .catalog-card-body p {
margin: 0 0 var(--space-2); margin: 0;
color: var(--color-text-muted);
}
/* Die Art steht in der Tafel; für Hilfsmittel bleibt sie im Text erhalten. */
.catalog-cards-standard .catalog-card-kind {
position: absolute;
width: 1px;
height: 1px;
overflow: hidden;
clip: rect(0 0 0 0);
white-space: nowrap;
} }
.catalog-card-kind { .catalog-card-kind {
font-size: 0.8125rem; font-size: var(--text-small);
font-weight: 700; font-weight: 700;
text-transform: uppercase; color: var(--lf-green-deep);
letter-spacing: 0.08em; margin: 0;
color: var(--lf-ink-muted); }
.catalog-cards[data-count='1'] .catalog-list {
grid-template-columns: minmax(0, 1fr);
}
@container slot (min-width: 40rem) {
.catalog-cards-standard[data-count='1'] .catalog-card {
display: grid;
grid-template-columns: minmax(12rem, 1fr) minmax(0, 2fr);
}
.catalog-cards-standard[data-count='1'] .catalog-card-visual {
border-bottom: 0;
border-right: 5px solid var(--lf-yellow);
min-height: 11rem;
}
.catalog-cards-standard[data-count='1'] .catalog-card-body {
align-content: center;
padding: var(--space-6);
}
} }
.catalog-cards-compact .catalog-list { .catalog-cards-compact .catalog-list {
@@ -250,18 +374,25 @@ .catalog-cards-compact .catalog-list {
} }
.catalog-cards-compact .catalog-card { .catalog-cards-compact .catalog-card {
border-width: 0 0 1px; border-width: 1px 0 0;
border-radius: 0; border-radius: 0;
background: transparent; background: transparent;
color: var(--color-text); color: var(--color-text);
--color-text: inherit; --color-text: inherit;
--color-text-muted: inherit;
--color-heading: inherit; --color-heading: inherit;
--color-link: inherit; --color-link: inherit;
border-color: var(--color-border); border-color: var(--color-border);
overflow: visible;
}
.catalog-cards-compact .catalog-card:last-child {
border-bottom-width: 1px;
} }
.catalog-cards-compact .catalog-card-body { .catalog-cards-compact .catalog-card-body {
padding: var(--space-3) 0; padding: var(--space-4) 0;
gap: var(--space-1);
} }
.catalog-cards-compact .catalog-card-kind { .catalog-cards-compact .catalog-card-kind {
@@ -275,9 +406,10 @@ .catalog-card-internal {
/* Handlungsaufruf */ /* Handlungsaufruf */
.cta { .cta {
position: relative;
background: var(--color-surface-subtle); background: var(--color-surface-subtle);
border-radius: var(--radius-panel); border-radius: var(--radius-panel);
padding: clamp(1.25rem, 5cqi, 2.5rem); padding: clamp(1.5rem, 5cqi, 3rem);
color: var(--lf-ink); color: var(--lf-ink);
--color-heading: var(--lf-navy); --color-heading: var(--lf-navy);
--color-text: var(--lf-ink); --color-text: var(--lf-ink);
@@ -288,8 +420,12 @@ .cta {
--color-action-text: var(--lf-white); --color-action-text: var(--lf-white);
} }
.section-bg-light .cta {
background: var(--lf-white);
}
.cta h2 { .cta h2 {
font-size: clamp(1.5rem, 1.1rem + 2cqi, 2.125rem); font-size: clamp(1.5rem, 1.1rem + 2cqi, 2.25rem);
} }
.cta p { .cta p {
+67 -19
View File
@@ -1,19 +1,27 @@
/** /**
* Website-Kopfzeile: mobile Navigation, Untermenüs und Schatten beim Scrollen. * Website-Kopfzeile: Menümodus, mobile Navigation, Untermenüs und kompakter Zustand beim Scrollen.
*
* Breitenstufen der Kopfzeile (Messung inline in header.blade.php, window.lufHeaderMode):
* 1. Navigation und Kontozugang mit Beschriftung passen in eine Zeile.
* 2. Sonst: Kontozugang nur als Symbol (is-account-compact).
* 3. Sonst und immer unter 75 rem: Menümodus (is-menu-mode).
* So bricht die Navigation aus dem CMS nie um, und die Höhe der Kopfzeile bleibt auf allen Seiten gleich.
* Ohne JavaScript bleibt die Navigation als umbrechende Liste bedienbar (CSS: html:not(.js)). * Ohne JavaScript bleibt die Navigation als umbrechende Liste bedienbar (CSS: html:not(.js)).
*/ */
const DESKTOP = window.matchMedia('(min-width: 75rem)'); const BASELINE = window.matchMedia('(max-width: 74.99rem)');
function focusableIn(element) { function focusableIn(element) {
return [...element.querySelectorAll('a[href], button:not([disabled])')].filter((node) => node.offsetParent !== null); return [...element.querySelectorAll('a[href], button:not([disabled])')].filter((node) => node.offsetParent !== null);
} }
const isMenuMode = (header) => header.classList.contains('is-menu-mode');
function setupMenu(header) { function setupMenu(header) {
const button = header.querySelector('[data-site-menu-button]'); const button = header.querySelector('[data-site-menu-button]');
const nav = header.querySelector('#site-nav'); const nav = header.querySelector('#site-nav');
if (!button || !nav) { if (!button || !nav) {
return; return () => {};
} }
const label = button.querySelector('[data-menu-label]'); const label = button.querySelector('[data-menu-label]');
@@ -21,6 +29,10 @@ function setupMenu(header) {
const iconClose = button.querySelector('[data-icon-close]'); const iconClose = button.querySelector('[data-icon-close]');
const setOpen = (open, { restoreFocus = true } = {}) => { const setOpen = (open, { restoreFocus = true } = {}) => {
if (open) {
// Die Fläche beginnt unter dem sichtbaren Teil der Kopfzeile, gleich in welchem Zustand.
header.style.setProperty('--site-menu-top', `${Math.max(0, Math.round(header.getBoundingClientRect().bottom))}px`);
}
header.classList.toggle('is-menu-open', open); header.classList.toggle('is-menu-open', open);
document.body.classList.toggle('has-open-menu', open); document.body.classList.toggle('has-open-menu', open);
button.setAttribute('aria-expanded', String(open)); button.setAttribute('aria-expanded', String(open));
@@ -51,16 +63,15 @@ function setupMenu(header) {
return; return;
} }
// Fokus bleibt in Menü und Menü-Schaltfläche, solange das Menü offen ist. // Fokus bleibt in Menü-Schaltfläche und Menü, solange das Menü offen ist. Die Reihenfolge wird vollständig
// selbst gesteuert, weil die Schaltfläche im Quelltext hinter der Navigation steht (sonst springt Tab in den Inhalt).
if (event.key === 'Tab') { if (event.key === 'Tab') {
const items = [button, ...focusableIn(nav)]; const items = [button, ...focusableIn(nav)];
const index = items.indexOf(document.activeElement); const index = items.indexOf(document.activeElement);
const next = event.shiftKey ? index - 1 : index + 1; const next = index === -1 ? 0 : (index + (event.shiftKey ? -1 : 1) + items.length) % items.length;
if (index === -1 || next < 0 || next >= items.length) { event.preventDefault();
event.preventDefault(); items[next].focus();
items[event.shiftKey ? items.length - 1 : 0].focus();
}
} }
}); });
@@ -70,11 +81,37 @@ function setupMenu(header) {
} }
}); });
DESKTOP.addEventListener('change', (event) => { // Rückgabe: schließt das Menü, wenn der Menümodus endet.
if (event.matches && header.classList.contains('is-menu-open')) { return () => {
if (header.classList.contains('is-menu-open')) {
setOpen(false, { restoreFocus: false }); setOpen(false, { restoreFocus: false });
} }
}); };
}
/**
* Breitenstufen: Die Messung steht als window.lufHeaderMode inline direkt nach der Kopfzeile
* (components/site/header.blade.php), damit schon der erste Frame stimmt. Hier wird sie bei Größenänderungen,
* beim Wechsel über 75 rem und nach dem Laden der Schriften wiederholt.
*/
function setupMode(header, closeMenu) {
const apply = window.lufHeaderMode;
const inner = header.querySelector('.site-header-inner');
if (typeof apply !== 'function' || !inner) {
return;
}
const update = () => {
if (apply(header) !== 'menu') {
closeMenu();
}
};
update();
new ResizeObserver(update).observe(inner);
BASELINE.addEventListener('change', update);
document.fonts?.ready.then(update);
} }
function setupSubmenus(header) { function setupSubmenus(header) {
@@ -113,7 +150,7 @@ function setupSubmenus(header) {
}); });
item.addEventListener('focusout', (event) => { item.addEventListener('focusout', (event) => {
if (DESKTOP.matches && !item.contains(event.relatedTarget)) { if (!isMenuMode(header) && !item.contains(event.relatedTarget)) {
close(item); close(item);
} }
}); });
@@ -124,14 +161,25 @@ function setupSubmenus(header) {
}); });
} }
function setupShadow(header) { /**
const update = () => header.classList.toggle('is-scrolled', window.scrollY > 8); * Kompakter Zustand: Sobald der Bereich über der kompakten Leiste aus dem Bild gescrollt ist, wird die Wortmarke
window.addEventListener('scroll', update, { passive: true }); * verkleinert und ein Schatten gesetzt. Die Höhe im Seitenfluss ändert sich dabei nicht.
update(); */
function setupCompact(header) {
const sentinel = document.querySelector('[data-site-header-sentinel]');
if (!sentinel || !('IntersectionObserver' in window)) {
return;
}
new IntersectionObserver(([entry]) => {
header.classList.toggle('is-compact', !entry.isIntersecting);
}).observe(sentinel);
} }
document.querySelectorAll('[data-site-header]').forEach((header) => { document.querySelectorAll('[data-site-header]').forEach((header) => {
setupMenu(header); const closeMenu = setupMenu(header);
setupMode(header, closeMenu);
setupSubmenus(header); setupSubmenus(header);
setupShadow(header); setupCompact(header);
}); });
@@ -0,0 +1,2 @@
{{-- Markenakzent „Bogen“: grüne Schwungfläche als Abschluss dunkler Flächen (nach dem Homepage-Entwurf des Brand-Kits). Dekorativ. --}}
<svg {{ $attributes->class(['brand-arc']) }} viewBox="0 0 400 120" preserveAspectRatio="none" aria-hidden="true" focusable="false"><path d="M0 120 C120 112 250 80 400 0 L400 120 Z" fill="currentColor"/></svg>
@@ -0,0 +1,2 @@
{{-- Markenakzent „Signalstrahlen“ (Brand-Kit 03_svg_entwuerfe/yellow-rays.svg, Entwurf). Dekorativ; nie an der Wortmarke. --}}
<svg {{ $attributes->class(['brand-rays']) }} viewBox="0 0 100 85" aria-hidden="true" focusable="false"><g fill="none" stroke="currentColor" stroke-linecap="round" stroke-width="11"><path d="M23 52L6 40"/><path d="M48 29L46 9"/><path d="M74 44L89 23"/></g></svg>
@@ -0,0 +1,2 @@
{{-- Markenakzent „Unterstreichung“ (Brand-Kit 03_svg_entwuerfe/yellow-underline.svg, Entwurf). Dekorativ, Farbe über currentColor. --}}
<svg {{ $attributes->class(['brand-underline']) }} viewBox="0 0 280 28" preserveAspectRatio="none" aria-hidden="true" focusable="false"><path d="M9 18 Q102 1 270 12" fill="none" stroke="currentColor" stroke-width="13" stroke-linecap="round" vector-effect="non-scaling-stroke"/></svg>
@@ -1,10 +1,12 @@
{{-- {{--
Wortmarke. VORLÄUFIG: Es liegt keine freigegebene Logodatei vor (docs/Brand-UI-Kit/README.md, Markenleitlinie 5). Wortmarke. VORLÄUFIG: Es liegt keine freigegebene Logodatei vor (docs/Brand-UI-Kit/README.md, Markenleitlinie 5).
Bis dahin steht hier ein schlichter Schriftzug in der vorläufigen Auszeichnungsschrift, ohne Nachbildung der Bis dahin steht hier ein Schriftzug in der vorläufigen Auszeichnungsschrift. Die Variante „lockup“ (Website)
Filmwortmarke (keine Drehung, kein Unterstrich-Schwung). Eine freigegebene SVG-Datei wird ausschließlich hier eingesetzt. ergänzt den Zusatz als grünes Schild nach dem Web-Entwurf des Brand-Kits (05_web_preview). Keine Nachbildung der
Filmwortmarke: keine Wolkenform, keine Drehung, kein Unterstrich-Schwung, keine Strahlen.
Eine freigegebene SVG-Datei wird ausschließlich hier eingesetzt.
--}} --}}
@props(['href' => null, 'claim' => 'Stark im Alltag']) @props(['href' => null, 'claim' => 'Stark im Alltag', 'variant' => 'plain'])
<a {{ $attributes->class(['brand']) }} href="{{ $href ?? route('home') }}" data-brand-status="vorlaeufig"> <a {{ $attributes->class(['brand', 'brand-lockup' => $variant === 'lockup']) }} href="{{ $href ?? route('home') }}" data-brand-status="vorlaeufig">
<span class="brand-name">Lara &amp; Felix</span> <span class="brand-name">Lara &amp; Felix</span>
<span class="brand-claim">{{ $claim }}</span> <span class="brand-claim">{{ $claim }}</span>
</a> </a>
@@ -1,16 +1,21 @@
@props(['navigation', 'path' => null]) @props(['navigation', 'path' => null])
@php @php
$groups = \App\Domain\Cms\SiteNavigation::forPath($navigation, $path ?? request()->path())->footerGroups(); $groups = collect(\App\Domain\Cms\SiteNavigation::forPath($navigation, $path ?? request()->path())->footerGroups());
$legal = $groups->firstWhere('key', 'footer_legal');
$columns = $groups->reject(fn (array $group): bool => $group['key'] === 'footer_legal');
$themes = \App\Domain\Catalog\Pillar::query()->published()->get(['id', 'name', 'slug']); $themes = \App\Domain\Catalog\Pillar::query()->published()->get(['id', 'name', 'slug']);
@endphp @endphp
{{-- Fußbereich: Links aus der CMS-Navigation (Plätze „Fußbereich: …“) und die veröffentlichten Themenbereiche. Keine erfundenen Kontakt- oder Rechtstexte. --}} {{--
Fußbereich: Links aus der CMS-Navigation (Plätze „Fußbereich: …“) und die veröffentlichten Themenbereiche.
Keine eigene Inhaltsverwaltung, keine erfundenen Kontakt- oder Rechtstexte. „Rechtliches“ steht in der Grundzeile.
--}}
<footer class="site-footer scope-dark"> <footer class="site-footer scope-dark">
<div class="site-footer-inner ui-container"> <div class="site-footer-inner ui-container">
<div class="site-footer-brand"> <div class="site-footer-brand">
<x-site.brand /> <x-site.brand variant="lockup" />
</div> </div>
@if ($themes->isNotEmpty()) @if ($themes->isNotEmpty())
<nav aria-labelledby="fuss-themen"> <nav class="site-footer-group site-footer-themes" aria-labelledby="fuss-themen">
<h2 id="fuss-themen">Themenbereiche</h2> <h2 id="fuss-themen">Themenbereiche</h2>
<ul> <ul>
@foreach ($themes as $theme) @foreach ($themes as $theme)
@@ -19,8 +24,8 @@
</ul> </ul>
</nav> </nav>
@endif @endif
@foreach ($groups as $group) @foreach ($columns as $group)
<nav aria-labelledby="fuss-{{ $group['key'] }}"> <nav class="site-footer-group" aria-labelledby="fuss-{{ $group['key'] }}">
<h2 id="fuss-{{ $group['key'] }}">{{ $group['heading'] }}</h2> <h2 id="fuss-{{ $group['key'] }}">{{ $group['heading'] }}</h2>
<ul> <ul>
@foreach ($group['links'] as $link) @foreach ($group['links'] as $link)
@@ -30,4 +35,17 @@
</nav> </nav>
@endforeach @endforeach
</div> </div>
@if ($legal)
<div class="site-footer-base ui-container">
<nav aria-labelledby="fuss-footer_legal">
<h2 id="fuss-footer_legal" class="visually-hidden">{{ $legal['heading'] }}</h2>
<ul>
@foreach ($legal['links'] as $link)
<li><a href="{{ $link['href'] }}" @if ($link['current']) aria-current="page" @endif>{{ $link['label'] }}</a></li>
@endforeach
</ul>
</nav>
</div>
@endif
<x-brand.arc class="site-footer-arc" />
</footer> </footer>
@@ -2,45 +2,81 @@
@php @php
$entries = \App\Domain\Cms\SiteNavigation::forPath($navigation, $path ?? request()->path())->header(); $entries = \App\Domain\Cms\SiteNavigation::forPath($navigation, $path ?? request()->path())->header();
@endphp @endphp
{{-- Gleiche Ausgabe für Gäste und Mitglieder (ADR-32): Der Kontozugang führt zum Mitgliederbereich, der bei Bedarf zur Anmeldung leitet. --}} {{--
Globale Kopfzeile. Gleiche Ausgabe für Gäste und Mitglieder (ADR-32): Der Kontozugang führt zum Mitgliederbereich,
der bei Bedarf zur Anmeldung leitet.
Geometrie: Die Box ist immer --header-height-initial hoch und klebt mit negativem Abstand; die innere Leiste
klebt oben. Beim Scrollen bleibt nur die kompakte Leiste sichtbar, ohne dass sich die Höhe im Seitenfluss ändert.
--}}
<span class="site-header-sentinel" aria-hidden="true" data-site-header-sentinel></span>
<header class="site-header" data-site-header> <header class="site-header" data-site-header>
<div class="site-header-inner ui-container ui-container-wide"> <div class="site-header-bar">
<x-site.brand /> <div class="site-header-inner ui-container">
<nav class="site-nav" id="site-nav" aria-label="Hauptnavigation"> <x-site.brand variant="lockup" />
<ul class="site-nav-list"> <nav class="site-nav" id="site-nav" aria-label="Hauptnavigation">
@foreach ($entries as $entry) <ul class="site-nav-list">
<li @class(['site-nav-item', 'has-children' => $entry['children'] !== [], 'is-active-trail' => $entry['activeTrail']])> @foreach ($entries as $entry)
@if ($entry['href']) <li @class(['site-nav-item', 'has-children' => $entry['children'] !== [], 'is-active-trail' => $entry['activeTrail']])>
<a href="{{ $entry['href'] }}" @if ($entry['current']) aria-current="page" @endif>{{ $entry['label'] }}</a> @if ($entry['href'])
@else <a href="{{ $entry['href'] }}" @if ($entry['current']) aria-current="page" @endif>{{ $entry['label'] }}</a>
<a href="#untermenue-{{ $entry['id'] }}" data-site-subnav-label>{{ $entry['label'] }}</a> @else
@endif <a href="#untermenue-{{ $entry['id'] }}" data-site-subnav-label>{{ $entry['label'] }}</a>
@if ($entry['children'] !== []) @endif
<button type="button" class="site-nav-toggle" aria-expanded="false" aria-controls="untermenue-{{ $entry['id'] }}" data-site-subnav-toggle> @if ($entry['children'] !== [])
<x-heroicon-o-chevron-down aria-hidden="true" /> <button type="button" class="site-nav-toggle" aria-expanded="false" aria-controls="untermenue-{{ $entry['id'] }}" data-site-subnav-toggle>
<span class="visually-hidden">Untermenü {{ $entry['label'] }}</span> <x-heroicon-o-chevron-down aria-hidden="true" />
</button> <span class="visually-hidden">Untermenü {{ $entry['label'] }}</span>
<ul class="site-subnav" id="untermenue-{{ $entry['id'] }}"> </button>
@foreach ($entry['children'] as $child) <ul class="site-subnav" id="untermenue-{{ $entry['id'] }}">
<li><a href="{{ $child['href'] }}" @if ($child['current']) aria-current="page" @endif>{{ $child['label'] }}</a></li> @foreach ($entry['children'] as $child)
@endforeach <li><a href="{{ $child['href'] }}" @if ($child['current']) aria-current="page" @endif>{{ $child['label'] }}</a></li>
</ul> @endforeach
@endif </ul>
</li> @endif
@endforeach </li>
</ul> @endforeach
</nav> </ul>
<div class="site-header-actions"> </nav>
<a class="site-icon-link" href="{{ route('member.dashboard') }}"> <div class="site-header-actions">
<x-heroicon-o-user-circle aria-hidden="true" /> <a class="site-icon-link site-account-link" href="{{ route('member.dashboard') }}">
<span class="site-account-label">Mitgliederbereich</span> <x-heroicon-o-user-circle aria-hidden="true" />
</a> <span class="site-account-label">Mitgliederbereich</span>
<x-site.cart-link /> </a>
<button type="button" class="site-menu-button" aria-expanded="false" aria-controls="site-nav" data-site-menu-button> <x-site.cart-link />
<x-heroicon-o-bars-3 aria-hidden="true" data-icon-open /> <button type="button" class="site-menu-button" aria-expanded="false" aria-controls="site-nav" data-site-menu-button>
<x-heroicon-o-x-mark aria-hidden="true" data-icon-close hidden /> <x-heroicon-o-bars-3 aria-hidden="true" data-icon-open />
<span data-menu-label>Menü</span> <x-heroicon-o-x-mark aria-hidden="true" data-icon-close hidden />
</button> <span data-menu-label>Menü</span>
</button>
</div>
</div> </div>
</div> </div>
</header> </header>
{{--
Breitenstufen vor dem ersten Zeichnen setzen (läuft nach dem Laden des Stylesheets, vor dem Zeichnen):
full = Navigation und beschrifteter Kontozugang passen in eine Zeile, icon = Kontozugang nur als Symbol,
menu = Menümodus (immer unter 75 rem). Gemessen wird die Desktop-Darstellung an der echten Navigation;
resources/js/site-nav.js ruft dieselbe Funktion bei Größenänderungen und nach dem Laden der Schriften erneut auf.
--}}
<script>
window.lufHeaderMode = function (h) {
var state = 'menu';
if (!window.matchMedia('(max-width: 74.99rem)').matches) {
var menu = h.classList.contains('is-menu-mode'), compact = h.classList.contains('is-account-compact');
h.classList.remove('is-menu-mode', 'is-account-compact');
var w = function (e) { return e.getBoundingClientRect().width; };
var inner = h.querySelector('.site-header-inner'), nav = h.querySelector('.site-nav'), list = h.querySelector('.site-nav-list');
var actions = h.querySelector('.site-header-actions'), account = h.querySelector('.site-account-link');
var gap = parseFloat(getComputedStyle(inner).columnGap) || 0;
var room = inner.clientWidth - w(h.querySelector('.brand')) - 2 * gap - (parseFloat(getComputedStyle(nav).marginLeft) || 0) - (w(actions) - w(account));
var needed = list.scrollWidth, full = w(account), icon = parseFloat(getComputedStyle(account).minWidth) || 44;
h.classList.toggle('is-menu-mode', menu);
h.classList.toggle('is-account-compact', compact);
state = needed + full <= room ? 'full' : (needed + icon <= room ? 'icon' : 'menu');
}
h.classList.toggle('is-account-compact', state !== 'full');
h.classList.toggle('is-menu-mode', state === 'menu');
return state;
};
window.lufHeaderMode(document.querySelector('[data-site-header]'));
</script>
+35 -2
View File
@@ -9,7 +9,7 @@
/* Widget-Vorschau: kompakt, ohne eigene Bildlaufleiste; lange Inhalte werden gekürzt angezeigt. */ /* Widget-Vorschau: kompakt, ohne eigene Bildlaufleiste; lange Inhalte werden gekürzt angezeigt. */
.luf-widget-preview { position: relative; } .luf-widget-preview { position: relative; }
.luf-widget-preview-frame { display: block; width: 100%; min-height: 3rem; max-height: 22rem; border: 0; overflow: hidden; pointer-events: none; background: #fff; } .luf-widget-preview-frame { display: block; width: 100%; min-height: 3rem; max-height: 28rem; border: 0; overflow: hidden; pointer-events: none; background: #fff; }
.luf-widget-preview.is-clipped::after { .luf-widget-preview.is-clipped::after {
content: 'Vorschau gekürzt – vollständig in der Seitenvorschau'; content: 'Vorschau gekürzt – vollständig in der Seitenvorschau';
position: absolute; inset: auto 0 0 0; padding: 2.5rem .75rem .5rem; position: absolute; inset: auto 0 0 0; padding: 2.5rem .75rem .5rem;
@@ -18,6 +18,13 @@
} }
.luf-widget-preview-empty { margin: 0; padding: 1rem; font-size: .875rem; opacity: .75; } .luf-widget-preview-empty { margin: 0; padding: 1rem; font-size: .875rem; opacity: .75; }
/* Live-Vorschau im Bearbeitungsdialog: feste logische Breite, auf die Dialogbreite verkleinert. */
.luf-live-preview { border: 1px solid rgb(0 0 0 / 10%); border-radius: .75rem; padding: .75rem; background: rgb(247 246 242 / 60%); }
.luf-live-preview-caption { margin: 0 0 .5rem; font-size: .75rem; opacity: .75; }
.luf-live-preview-stage { position: relative; overflow: hidden; background: #fff; border-radius: .5rem; }
.luf-live-preview-frame { display: block; border: 0; pointer-events: none; background: #fff; transform-origin: 0 0; }
.luf-preview-width .fi-btn-group { flex-wrap: wrap; }
/* Abschnitte: breite Arbeitsfläche, deutlich abgesetzte Abschnitte */ /* Abschnitte: breite Arbeitsfläche, deutlich abgesetzte Abschnitte */
.luf-sections > .fi-fo-repeater-items { gap: 1.25rem; } .luf-sections > .fi-fo-repeater-items { gap: 1.25rem; }
.luf-sections > .fi-fo-repeater-items > .fi-fo-repeater-item { border-left: 4px solid rgb(3 37 81 / 70%); } .luf-sections > .fi-fo-repeater-items > .fi-fo-repeater-item { border-left: 4px solid rgb(3 37 81 / 70%); }
@@ -50,8 +57,34 @@
</style> </style>
<script> <script>
// Vorschau-Iframes an ihren Inhalt anpassen (nach Bildern und Schriften erneut), Höhe begrenzen. // Vorschau-Iframes an ihren Inhalt anpassen (nach Bildern und Schriften erneut), Höhe begrenzen.
// Live-Vorschau im Dialog: Inhalt in logischer Breite rendern, dann auf die verfügbare Breite skalieren.
window.lufLivePreview = window.lufLivePreview || function (frame) {
const stage = frame.parentElement;
const width = Number(frame.dataset.width) || 1200;
const fit = () => {
const doc = frame.contentDocument;
if (!doc || !doc.documentElement || !stage) return;
const scale = Math.min(1, stage.clientWidth / width);
frame.style.width = width + 'px';
const height = doc.documentElement.scrollHeight;
frame.style.height = height + 'px';
frame.style.transform = 'scale(' + scale + ')';
stage.style.height = Math.ceil(height * scale) + 'px';
};
fit();
try {
const doc = frame.contentDocument;
doc.fonts?.ready.then(fit);
doc.querySelectorAll('img').forEach((img) => img.complete || img.addEventListener('load', fit, { once: true }));
if (window.ResizeObserver) {
new ResizeObserver(fit).observe(doc.body);
new ResizeObserver(fit).observe(stage);
}
} catch (error) {}
};
window.lufFitPreview = window.lufFitPreview || function (frame) { window.lufFitPreview = window.lufFitPreview || function (frame) {
const max = 352; const max = 448;
const fit = () => { const fit = () => {
const doc = frame.contentDocument; const doc = frame.contentDocument;
if (!doc || !doc.documentElement) return; if (!doc || !doc.documentElement) return;
@@ -0,0 +1,29 @@
{{--
Live-Vorschau im Bearbeitungsdialog eines Widgets. Gerendert wird mit derselben Widget-Ansicht wie auf der
öffentlichen Seite (WidgetEditor::renderPreview), in einer festen logischen Breite und auf die Dialogbreite
verkleinert. So greifen die Container-Abfragen der Widgets wie auf der Website.
--}}
@php
$document = '<!DOCTYPE html><html lang="de"><head><meta charset="utf-8"><base target="_blank">'
.$stylesheets
.'<style>html,body{background:#fff;overflow:hidden}html{scrollbar-gutter:auto}body{margin:0;padding:0;min-height:0}main{display:block}</style>'
.'</head><body><main class="sheet-preview"><div class="section-slot">'.$html.'</div></main></body></html>';
@endphp
<div class="luf-live-preview">
<p class="luf-live-preview-caption">Vorschau bei {{ $width }} px Platzbreite, verkleinert. Gleiche Darstellung wie auf der Website.</p>
@if (trim($html) === '')
<p class="luf-widget-preview-empty">Dieses Widget zeigt mit den aktuellen Angaben öffentlich nichts an.</p>
@else
<div class="luf-live-preview-stage" wire:key="live-preview-{{ md5($document) }}-{{ $width }}">
<iframe
class="luf-live-preview-frame"
title="Live-Vorschau des Widgets"
tabindex="-1"
scrolling="no"
data-width="{{ $width }}"
srcdoc="{{ $document }}"
onload="window.lufLivePreview && window.lufLivePreview(this)"
></iframe>
</div>
@endif
</div>
@@ -6,7 +6,7 @@
@php @php
$document = '<!DOCTYPE html><html lang="de"><head><meta charset="utf-8"><base target="_blank">' $document = '<!DOCTYPE html><html lang="de"><head><meta charset="utf-8"><base target="_blank">'
.$stylesheets .$stylesheets
.'<style>html,body{background:#fff;overflow:hidden}body{margin:0;padding:1rem 1.25rem;min-height:0}main{display:block}</style>' .'<style>html,body{background:#fff;overflow:hidden}html{scrollbar-gutter:auto}body{margin:0;padding:1rem 1.25rem;min-height:0}main{display:block}</style>'
.'</head><body><main class="sheet-preview"><div class="section-slot">'.$html.'</div></main></body></html>'; .'</head><body><main class="sheet-preview"><div class="section-slot">'.$html.'</div></main></body></html>';
@endphp @endphp
@if (trim($html) === '') @if (trim($html) === '')
+27 -17
View File
@@ -1,26 +1,36 @@
{{--
Redaktionelle Karten. Varianten: standard (Raster), compact (Liste), featured (erste Karte hervorgehoben).
Die ganze Karte ist über den Titellink klickbar (gestreckter Link); Bilder sind dekorativ.
--}}
@php
$variant = in_array($variant, ['standard', 'compact', 'featured'], true) ? $variant : 'standard';
@endphp
@if ($items !== []) @if ($items !== [])
<ul class="cards cards-{{ $variant === 'compact' ? 'compact' : 'grid' }}"> <ul class="cards cards-{{ $variant === 'standard' ? 'grid' : $variant }}">
@foreach ($items as $item) @foreach ($items as $item)
<li class="card @if ($item['imageUrl']) card-with-image @endif"> <li @class([
@if ($item['url']) 'card',
<a href="{{ $item['url'] }}"> 'card-with-image' => $item['imageUrl'],
@if ($item['imageUrl']) 'card-linked' => $item['url'],
<img class="card-image" src="{{ $item['imageUrl'] }}" alt="" loading="lazy"> 'card-lead' => $variant === 'featured' && $loop->first,
])>
@if ($item['imageUrl'])
<div class="card-media">
<img class="card-image" src="{{ $item['imageUrl'] }}" alt="" loading="lazy" decoding="async">
</div>
@endif
<div class="card-body">
<h3 class="card-title">
@if ($item['url'])
<a href="{{ $item['url'] }}">{{ $item['title'] }}</a>
@else
{{ $item['title'] }}
@endif @endif
<h3>{{ $item['title'] }}</h3> </h3>
@if (filled($item['text']))
<p>{{ $item['text'] }}</p>
@endif
</a>
@else
@if ($item['imageUrl'])
<img class="card-image" src="{{ $item['imageUrl'] }}" alt="" loading="lazy">
@endif
<h3>{{ $item['title'] }}</h3>
@if (filled($item['text'])) @if (filled($item['text']))
<p>{{ $item['text'] }}</p> <p>{{ $item['text'] }}</p>
@endif @endif
@endif </div>
</li> </li>
@endforeach @endforeach
</ul> </ul>
@@ -1,5 +1,10 @@
{{--
Programm- und Modulkarten. Titel, Kurzbeschreibung, Art und Ziel kommen zur Laufzeit aus den maßgeblichen
Fachdaten (PublicCatalogReader); nichts davon wird im CMS gespeichert. Statt Bildern trägt eine Markentafel die Art.
Darstellung nach Slotbreite: schmal gestapelt, breit mit Tafel neben dem Text (siehe widgets.css).
--}}
@if ($entries !== [] || $context->preview) @if ($entries !== [] || $context->preview)
<div class="catalog-cards catalog-cards-{{ $variant === 'compact' ? 'compact' : 'standard' }}"> <div class="catalog-cards catalog-cards-{{ $variant === 'compact' ? 'compact' : 'standard' }}" data-count="{{ count($entries) }}">
@if (filled($data['heading'] ?? null)) @if (filled($data['heading'] ?? null))
<h2>{{ $data['heading'] }}</h2> <h2>{{ $data['heading'] }}</h2>
@endif @endif
@@ -11,9 +16,12 @@
@else @else
<ul class="catalog-list"> <ul class="catalog-list">
@foreach ($entries as $entry) @foreach ($entries as $entry)
<li class="catalog-card @unless ($entry->public) catalog-card-internal @endunless"> <li @class(['catalog-card', 'catalog-card-linked' => $entry->url, 'catalog-card-internal' => ! $entry->public])>
@if ($variant !== 'compact') @if ($variant !== 'compact')
<div class="catalog-card-visual" aria-hidden="true"><span>{{ $entry->kindLabel }}</span></div> <div class="catalog-card-visual" aria-hidden="true">
<span>{{ $entry->kindLabel }}</span>
<x-brand.rays class="catalog-card-rays" />
</div>
@endif @endif
<div class="catalog-card-body"> <div class="catalog-card-body">
<p class="catalog-card-kind">{{ $entry->kindLabel }}</p> <p class="catalog-card-kind">{{ $entry->kindLabel }}</p>
+42 -15
View File
@@ -1,18 +1,45 @@
<div class="hero hero-{{ $variant === 'highlight' ? 'highlight' : 'standard' }} @if ($imageUrl) hero-with-image @endif"> {{--
<div class="hero-copy"> Premium-Einstieg (Brand-UI-Kit v1.6, Komponente lf-hero), angepasst an die Widget-Hülle der Registry.
@if (! empty($first)) Varianten: photo_split (Foto mit heller Textfläche), editorial_solid (Navy-Markenfläche ohne Foto).
<h1>{{ $data['heading'] ?? '' }}</h1> Höhen compact/normal/large sind Mindesthöhen ab 860 px Containerbreite; darunter Sicherheitsumbruch.
@else Das Bild des ersten Widgets der Seite wird sofort geladen, alle anderen verzögert.
<h2>{{ $data['heading'] ?? '' }}</h2> --}}
@endif @php
@if (filled($data['text'] ?? null)) $layout = $variant === 'editorial_solid' ? 'editorial-solid' : 'photo-split';
<p class="lede">{{ $data['text'] }}</p> $heightClass = in_array($height, ['compact', 'normal', 'large'], true) ? $height : 'normal';
@endif $tag = \App\Domain\Cms\Widgets\Support\PremiumFields::headingTag($settings, ! empty($first));
@if ($action) $loading = ! empty($first) ? 'loading="eager" fetchpriority="high"' : 'loading="lazy"';
<a class="button" href="{{ $action['url'] }}">{{ $action['label'] }}</a> @endphp
<div class="lf-hero-host">
<div class="lf-hero lf-hero--{{ $layout }} lf-hero--height-{{ $heightClass }} lf-hero--accent-{{ $accent }}"
style="--lf-hero-focus-x: {{ $focus['x'] }}%; --lf-hero-focus-y: {{ $focus['y'] }}%">
@if ($layout === 'photo-split' && $imageUrl)
<img class="lf-hero__photo" src="{{ $imageUrl }}" alt="{{ $data['alt'] ?? '' }}" {!! $loading !!} decoding="async">
@endif @endif
<div class="lf-hero__inner">
<div class="lf-hero__copy">
@if ($accent === 'rays')
<x-brand.rays class="lf-hero__rays" />
@endif
@if (filled($data['eyebrow'] ?? null))
<p class="lf-hero__eyebrow">{{ $data['eyebrow'] }}</p>
@endif
<{{ $tag }} class="lf-hero__title">{{ $data['heading'] ?? '' }}</{{ $tag }}>
@if ($accent !== 'none')
<span class="lf-hero__title-accent" aria-hidden="true"></span>
@endif
@if (filled($data['text'] ?? null))
<p class="lf-hero__description">{{ $data['text'] }}</p>
@endif
@if ($actions !== [])
<div class="lf-hero__actions">
@foreach ($actions as $index => $item)
<a @class(['lf-hero__button', 'lf-hero__button--primary' => $index === 0, 'lf-hero__button--secondary' => $index > 0]) href="{{ $item['url'] }}">{{ $item['label'] }}</a>
@endforeach
</div>
@endif
</div>
</div>
<span class="lf-hero__bottom" aria-hidden="true"></span>
</div> </div>
@if ($imageUrl)
<img class="hero-image" src="{{ $imageUrl }}" alt="{{ $data['alt'] ?? '' }}">
@endif
</div> </div>
+43 -11
View File
@@ -1,15 +1,47 @@
<div class="image-text image-text-{{ $variant === 'image_right' ? 'right' : 'left' }} @unless ($imageUrl) image-text-no-image @endunless"> {{--
@if ($imageUrl) Premium-Bild-und-Text (Brand-UI-Kit v1.6, Komponente lf-bild-text), angepasst an die Widget-Hülle der Registry.
<img src="{{ $imageUrl }}" alt="{{ $data['alt'] ?? '' }}" loading="lazy"> Darstellung nach tatsächlicher Containerbreite: unter 540 px gestapelt, 540–899 px flacher Bildstreifen,
@endif ab 900 px zweispaltig mit Bild links oder rechts (Variante). Die Höhe ändert Bildproportion und Abstände,
<div class="image-text-copy"> nie die zulässige Textmenge. Der Text ist bereits bereinigter formatierter Text (RichText::sanitize).
@if (filled($data['title'] ?? null)) --}}
@if (! empty($first)) @php
<h1>{{ $data['title'] }}</h1> $side = $variant === 'image_left' ? 'left' : 'right';
@else $heightClass = in_array($height, ['compact', 'normal', 'spacious'], true) ? $height : 'normal';
<h2>{{ $data['title'] }}</h2> $tag = \App\Domain\Cms\Widgets\Support\PremiumFields::headingTag($settings, ! empty($first));
@endphp
<div class="lf-bt-host">
<div @class([
'lf-bt',
'lf-bt--'.$surface,
'lf-bt--image-'.$side,
'lf-bt--height-'.$heightClass,
'lf-bt--without-image' => ! $imageUrl,
]) style="--bt-focus-x: {{ $focus['x'] }}%; --bt-focus-y: {{ $focus['y'] }}%">
<div class="lf-bt__copy">
@if (filled($data['eyebrow'] ?? null))
<p class="lf-bt__eyebrow">{{ $data['eyebrow'] }}</p>
@endif @endif
@if (filled($data['title'] ?? null))
<{{ $tag }} class="lf-bt__headline">{{ $data['title'] }}</{{ $tag }}>
<span class="lf-bt__accent" aria-hidden="true"></span>
@endif
<div class="lf-bt__body">{!! $body !!}</div>
@if ($actions !== [])
<div class="lf-bt__actions">
@foreach ($actions as $index => $item)
@if ($index === 0)
<a class="lf-bt__button" href="{{ $item['url'] }}">{{ $item['label'] }} <span aria-hidden="true">→</span></a>
@else
<a class="lf-bt__button lf-bt__button--secondary" href="{{ $item['url'] }}">{{ $item['label'] }}</a>
@endif
@endforeach
</div>
@endif
</div>
@if ($imageUrl)
<div class="lf-bt__media">
<img class="lf-bt__image" src="{{ $imageUrl }}" alt="{{ $data['alt'] ?? '' }}" @if (! empty($first)) loading="eager" fetchpriority="high" @else loading="lazy" @endif decoding="async">
</div>
@endif @endif
<div class="prose">{!! $body !!}</div>
</div> </div>
</div> </div>
+91
View File
@@ -0,0 +1,91 @@
<?php
namespace Tests\Feature;
use App\Domain\Cms\NavigationItem;
use App\Domain\Cms\Page;
use App\Domain\Cms\PageService;
use App\Domain\Cms\Widgets\WidgetRegistry;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
/**
* Designiteration 1: stabiler Website-Rahmen, Markenakzente und Karten-Varianten.
* Einstieg und Bild und Text sind seit Kit v1.6 Premium-Widgets (Tests in CmsPremiumWidgetsTest).
*/
class CmsDesignIterationTest extends TestCase
{
use RefreshDatabase;
/**
* @param list<array<string, mixed>> $content Abschnitte oder Widgets
*/
private function publish(string $path, array $content): string
{
$page = Page::query()->create(['path' => $path]);
$service = app(PageService::class);
$service->publish($page, $service->saveRevision($page, $content, null, null, null));
return $this->get($path)->assertOk()->getContent();
}
/**
* @param list<array<string, mixed>|null> $slots
* @param array<string, string> $style
* @return array<string, mixed>
*/
private function section(string $layout, array $slots, array $style = []): array
{
return ['layout' => $layout, 'style' => $style, 'slots' => $slots];
}
public function test_header_keeps_one_box_with_compact_bar_and_sets_the_menu_mode_before_painting(): void
{
$html = $this->publish('/rahmen', [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Rahmen']]]);
$this->assertStringContainsString('data-site-header-sentinel', $html);
$this->assertMatchesRegularExpression('#<header class="site-header" data-site-header>\s*<div class="site-header-bar">\s*<div class="site-header-inner ui-container">#', $html);
$this->assertStringContainsString('class="brand brand-lockup"', $html);
$this->assertStringContainsString('class="site-icon-link site-account-link" href="'.route('member.dashboard').'"', $html);
// Breitenstufen werden direkt nach der Kopfzeile gesetzt, vor dem ersten Zeichnen, nicht erst durch das Modul-Skript.
$this->assertMatchesRegularExpression('#</header>\s*<script>\s*window\.lufHeaderMode = function \(h\)#', $html);
$this->assertStringContainsString("window.lufHeaderMode(document.querySelector('[data-site-header]'));", $html);
}
public function test_footer_shows_legal_links_in_the_base_row_and_a_decorative_arc(): void
{
$legal = Page::query()->create(['path' => '/impressum-test']);
NavigationItem::query()->create(['label' => 'Impressum', 'page_id' => $legal->id, 'placement' => 'footer_legal', 'sort_order' => 1, 'is_visible' => true]);
$html = $this->publish('/fuss', [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Fuß']]]);
$this->assertMatchesRegularExpression('#<div class="site-footer-base ui-container">\s*<nav aria-labelledby="fuss-footer_legal">\s*<h2 id="fuss-footer_legal" class="visually-hidden">Rechtliches</h2>#', $html);
$this->assertStringContainsString('Impressum', $html);
$this->assertMatchesRegularExpression('#<svg class="brand-arc site-footer-arc"[^>]*aria-hidden="true"#', $html);
}
public function test_featured_cards_lead_with_the_first_card_and_link_the_whole_card(): void
{
$html = $this->publish('/karten', [[
'type' => 'cards', 'v' => 1, 'variant' => 'featured',
'data' => ['items' => [
['title' => 'Erste', 'text' => 'Hervorgehoben', 'url' => '/a', 'image' => 'cms/a.jpg'],
['title' => 'Zweite', 'url' => '/b'],
['title' => 'Dritte'],
]],
]]);
$this->assertStringContainsString('<ul class="cards cards-featured">', $html);
$this->assertMatchesRegularExpression('#<li class="card card-with-image card-linked card-lead">#', $html);
$this->assertSame(1, substr_count($html, 'card-lead'));
$this->assertMatchesRegularExpression('#<h3 class="card-title">\s*<a href="/a">Erste</a>#', $html);
$this->assertMatchesRegularExpression('#<h3 class="card-title">\s*Dritte\s*</h3>#', $html, 'Karten ohne Linkziel bleiben ohne Link.');
}
public function test_unknown_variant_from_a_newer_version_falls_back_to_the_default(): void
{
$widget = app(WidgetRegistry::class)->upcast(['type' => 'cards', 'v' => 1, 'variant' => 'masonry', 'data' => ['items' => [['title' => 'Eins']]]]);
$this->assertSame('standard', $widget['variant']);
}
}
+97 -9
View File
@@ -5,6 +5,7 @@
use App\Domain\Catalog\PillarService; use App\Domain\Catalog\PillarService;
use App\Domain\Cms\NavigationItem; use App\Domain\Cms\NavigationItem;
use App\Domain\Cms\Page; use App\Domain\Cms\Page;
use App\Domain\Cms\PageService;
use App\Filament\Resources\NavigationItems\Pages\ManageNavigationItems; use App\Filament\Resources\NavigationItems\Pages\ManageNavigationItems;
use App\Filament\Resources\Pages\Pages\CreatePage; use App\Filament\Resources\Pages\Pages\CreatePage;
use App\Filament\Resources\Pages\Pages\EditPage; use App\Filament\Resources\Pages\Pages\EditPage;
@@ -13,6 +14,8 @@
use App\Models\User; use App\Models\User;
use Filament\Actions\Testing\TestAction; use Filament\Actions\Testing\TestAction;
use Filament\Facades\Filament; use Filament\Facades\Filament;
use Filament\Forms\Components\Slider;
use Filament\Forms\Components\ToggleButtons;
use Illuminate\Foundation\Testing\RefreshDatabase; use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Storage; use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str; use Illuminate\Support\Str;
@@ -48,7 +51,7 @@ public function test_editor_creates_a_page_with_sections_and_registered_widgets_
'seo_title' => 'Themenseite', 'seo_title' => 'Themenseite',
'sections' => [ 'sections' => [
$this->sectionState('u4', [ $this->sectionState('u4', [
['type' => 'hero', 'data' => ['variant' => 'highlight', 'data' => ['heading' => 'Stark im Alltag', 'text' => 'Einstieg']]], ['type' => 'hero', 'data' => ['variant' => 'editorial_solid', 'data' => ['heading' => 'Stark im Alltag', 'text' => 'Einstieg']]],
], ['background' => 'dark', 'divider' => 'accent']), ], ['background' => 'dark', 'divider' => 'accent']),
$this->sectionState('u1_3', [ $this->sectionState('u1_3', [
['type' => 'cards', 'data' => ['variant' => 'compact', 'data' => ['items' => $this->keyed([['title' => 'Prävention', 'url' => '/praevention']])]]], ['type' => 'cards', 'data' => ['variant' => 'compact', 'data' => ['items' => $this->keyed([['title' => 'Prävention', 'url' => '/praevention']])]]],
@@ -75,8 +78,8 @@ public function test_editor_creates_a_page_with_sections_and_registered_widgets_
$this->assertSame('wide', $sections[1]['style']['width']); $this->assertSame('wide', $sections[1]['style']['width']);
$this->assertNull($sections[2]['slots'][1], 'Ein leerer Platz bleibt als Platz erhalten.'); $this->assertNull($sections[2]['slots'][1], 'Ein leerer Platz bleibt als Platz erhalten.');
$this->assertSame(['hero', 'cards', 'image_text', 'catalog_cards'], array_column($blocks, 'type'), 'Die Rollback-Spalte enthält alle Widgets in Lesereihenfolge.'); $this->assertSame(['hero', 'cards', 'image_text', 'catalog_cards'], array_column($blocks, 'type'), 'Die Rollback-Spalte enthält alle Widgets in Lesereihenfolge.');
$this->assertSame(['highlight', 'compact', 'image_right', 'standard'], array_column($blocks, 'variant')); $this->assertSame(['editorial_solid', 'compact', 'image_right', 'standard'], array_column($blocks, 'variant'));
$this->assertSame(2, $blocks[2]['v']); $this->assertSame(3, $blocks[2]['v']);
$this->assertStringContainsString('<strong>Betonung</strong>', $blocks[2]['data']['body']); $this->assertStringContainsString('<strong>Betonung</strong>', $blocks[2]['data']['body']);
$this->assertSame([['title' => 'Prävention', 'text' => null, 'url' => '/praevention', 'image' => null]], $blocks[1]['data']['items']); $this->assertSame([['title' => 'Prävention', 'text' => null, 'url' => '/praevention', 'image' => null]], $blocks[1]['data']['items']);
$this->assertSame([['type' => 'composition', 'id' => $program->composition_id]], $blocks[3]['refs']['items']); $this->assertSame([['type' => 'composition', 'id' => $program->composition_id]], $blocks[3]['refs']['items']);
@@ -163,7 +166,7 @@ public function test_publishing_with_an_invalid_draft_publishes_nothing(): void
$component->set("data.sections.$sectionKey.layout", 'u1_3'); $component->set("data.sections.$sectionKey.layout", 'u1_3');
$slotKeys = array_keys($component->get("data.sections.$sectionKey.slots")); $slotKeys = array_keys($component->get("data.sections.$sectionKey.slots"));
$component->set("data.sections.$sectionKey.slots.{$slotKeys[0]}.widget", [ $component->set("data.sections.$sectionKey.slots.{$slotKeys[0]}.widget", [
(string) Str::uuid() => ['type' => 'hero', 'data' => ['variant' => 'standard', 'data' => ['heading' => 'Zu schmal']]], (string) Str::uuid() => ['type' => 'hero', 'data' => ['variant' => 'photo_split', 'data' => ['heading' => 'Zu schmal']]],
]); ]);
$component->callAction('publish')->assertNotified('Nicht gespeichert'); $component->callAction('publish')->assertNotified('Nicht gespeichert');
@@ -230,7 +233,7 @@ public function test_widget_too_wide_for_its_slot_is_reported_at_the_section():
'path' => '/raster-pruefung', 'path' => '/raster-pruefung',
'sections' => [ 'sections' => [
$this->sectionState('u1_3', [ $this->sectionState('u1_3', [
['type' => 'hero', 'data' => ['variant' => 'standard', 'data' => ['heading' => 'Zu schmal']]], ['type' => 'hero', 'data' => ['variant' => 'photo_split', 'data' => ['heading' => 'Zu schmal']]],
null, null,
], ['background' => 'accent', 'spacing' => 'large', 'divider' => 'line']), ], ['background' => 'accent', 'spacing' => 'large', 'divider' => 'line']),
], ],
@@ -274,7 +277,7 @@ public function test_errors_found_only_by_the_registry_are_announced_with_the_se
$component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]); $component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]);
$state = $component->get('data.sections'); $state = $component->get('data.sections');
$state[(string) Str::uuid()] = $this->sectionState('u4', [ $state[(string) Str::uuid()] = $this->sectionState('u4', [
['type' => 'hero', 'data' => ['variant' => 'standard', 'data' => ['heading' => 'Mit Bild'], 'refs' => ['image' => 'cms/bild.jpg']]], ['type' => 'hero', 'data' => ['variant' => 'photo_split', 'data' => ['heading' => 'Mit Bild'], 'refs' => ['image' => 'cms/bild.jpg']]],
]); ]);
$component->set('data.sections', $state) $component->set('data.sections', $state)
@@ -391,8 +394,8 @@ public function test_block_preview_uses_the_public_widget_view_with_unsaved_stat
'refs' => ['image' => null, '_upload' => []], 'refs' => ['image' => null, '_upload' => []],
]); ]);
$this->assertStringContainsString('image-text image-text-right', $html); $this->assertStringContainsString('lf-bt lf-bt--cream lf-bt--image-right', $html);
$this->assertStringContainsString('<h2>Ungespeichert</h2>', $html); $this->assertStringContainsString('<h2 class="lf-bt__headline">Ungespeichert</h2>', $html);
$this->assertStringContainsString('Vorschautext', $html); $this->assertStringContainsString('Vorschautext', $html);
$cards = WidgetEditor::renderPreview('cards', [ $cards = WidgetEditor::renderPreview('cards', [
@@ -414,7 +417,7 @@ public function test_editor_offers_every_registered_widget_layouts_and_section_d
->assertSee('Einstieg (Hero)') ->assertSee('Einstieg (Hero)')
->assertSee('Programm- und Modulkarten') ->assertSee('Programm- und Modulkarten')
->assertSee('Titel und Beschreibung kommen automatisch aus den Fachdaten') ->assertSee('Titel und Beschreibung kommen automatisch aus den Fachdaten')
->assertSee('Braucht einen Platz ab 2 Rastereinheiten') ->assertSee('Für Plätze mit 3 oder 4 Rastereinheiten')
->assertSee('Gestaltung des Abschnitts') ->assertSee('Gestaltung des Abschnitts')
->assertSee('1 + 2 + 1') ->assertSee('1 + 2 + 1')
->assertSee('Widget einsetzen') ->assertSee('Widget einsetzen')
@@ -486,6 +489,91 @@ public function test_navigation_rejects_script_addresses(): void
$this->get('/praevention')->assertDontSee('javascript:alert(1)', false); $this->get('/praevention')->assertDontSee('javascript:alert(1)', false);
} }
/**
* Premium-Einstieg (Kit v1.6) über den Editor: Variante, Höhe, Überschriftenebene, Akzent, Label, Fokus und zwei
* Schaltflächen werden gespeichert und öffentlich mit derselben Ansicht dargestellt.
*/
public function test_editor_saves_premium_hero_with_layout_settings(): void
{
Storage::fake('media_public');
Storage::fake('cms_incoming');
Storage::disk('media_public')->put('cms/park.jpg', 'bild');
Livewire::actingAs($this->editor(), 'staff')
->test(CreatePage::class)
->fillForm([
'path' => '/premium-einstieg',
'sections' => [
$this->sectionState('u3_1', [
['type' => 'hero', 'data' => [
'variant' => 'photo_split',
'settings' => ['height' => 'large', 'heading_level' => 'h3', 'accent' => 'rays'],
'data' => ['eyebrow' => 'Stark im Alltag', 'heading' => 'Kinder stark im Alltag', 'text' => 'Beschreibung', 'cta_label' => 'Programme', 'cta_url' => '/programme', 'cta2_label' => 'Mitgliederbereich', 'cta2_url' => '/bereich', 'alt' => 'Lara und Felix', 'focus_x' => 72, 'focus_y' => 40],
'refs' => ['image' => 'cms/park.jpg'],
]],
['type' => 'call_to_action', 'data' => ['settings' => ['height' => 'fill'], 'data' => ['heading' => 'Daneben', 'label' => 'Los', 'url' => '/bereich']]],
], ['width' => 'wide']),
],
])
->call('create')
->assertHasNoFormErrors();
$page = Page::query()->where('path', '/premium-einstieg')->firstOrFail();
$hero = $page->latestRevision->sections[0]['slots'][0];
$this->assertSame(2, $hero['v']);
$this->assertSame('photo_split', $hero['variant']);
$this->assertSame(['height' => 'large', 'heading_level' => 'h3', 'accent' => 'rays'], $hero['settings']);
$this->assertSame([72, 40], [$hero['data']['focus_x'], $hero['data']['focus_y']]);
$this->assertSame('fill', $page->latestRevision->sections[0]['slots'][1]['settings']['height']);
app(PageService::class)->publish($page, $page->latestRevision);
$this->get('/premium-einstieg')
->assertOk()
->assertSee('lf-hero lf-hero--photo-split lf-hero--height-large lf-hero--accent-rays', false)
->assertSee('--lf-hero-focus-x: 72%; --lf-hero-focus-y: 40%', false)
->assertSee('<h1 class="lf-hero__title">Kinder stark im Alltag</h1>', false)
->assertSee('<p class="lf-hero__eyebrow">Stark im Alltag</p>', false)
->assertSee('<a class="lf-hero__button lf-hero__button--secondary" href="/bereich">Mitgliederbereich</a>', false)
->assertSee('widget-call-to-action widget-variant-standard widget-height-fill', false);
}
public function test_widget_dialog_groups_content_media_and_display_with_live_preview(): void
{
$page = Page::query()->where('path', '/')->firstOrFail();
$component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]);
$state = $component->get('data.sections');
$state[(string) Str::uuid()] = $this->sectionState('u4', [
['type' => 'image_text', 'data' => ['variant' => 'image_left', 'settings' => ['height' => 'spacious', 'surface' => 'navy'], 'data' => ['title' => 'Vorschau im Dialog', 'body' => '<p>Text</p>'], 'refs' => []]],
]);
$component->set('data.sections', $state);
$sectionKey = array_key_last($component->get('data.sections'));
$slotKey = array_key_first($component->get("data.sections.$sectionKey.slots"));
$itemKey = array_key_first($component->get("data.sections.$sectionKey.slots.$slotKey.widget"));
// Modalinhalte rendert Livewire im Test nicht als HTML; geprüft werden die Felder des geöffneten Dialogs.
$component->mountAction(TestAction::make('edit')->schemaComponent("sections.$sectionKey.slots.$slotKey.widget")->arguments(['item' => $itemKey]))
->assertFormFieldExists('variant', fn ($field) => $field instanceof ToggleButtons && array_keys($field->getOptions()) === ['image_left', 'image_right'])
->assertFormFieldExists('settings.height', fn ($field) => $field instanceof ToggleButtons && array_keys($field->getOptions()) === ['compact', 'normal', 'spacious'])
->assertFormFieldExists('settings.surface')
->assertFormFieldExists('settings.heading_level')
->assertFormFieldExists('data.eyebrow')
->assertFormFieldExists('data.cta2_url')
->assertFormFieldExists('refs.image')
->assertFormFieldExists('data.focus_x', fn ($field) => $field instanceof Slider)
->assertFormFieldExists('data.focus_y', fn ($field) => $field instanceof Slider)
->assertFormFieldExists('_preview_width', fn ($field) => array_keys($field->getOptions()) === [390, 310, 640, 960, 1300]);
// Die Live-Vorschau des Dialogs rendert den ungespeicherten Zustand mit der öffentlichen Ansicht.
$html = view('filament.cms.widget-live-preview', [
'html' => WidgetEditor::renderPreview('image_text', $component->get("data.sections.$sectionKey.slots.$slotKey.widget.$itemKey.data")),
'stylesheets' => '',
'width' => 1300,
])->render();
$this->assertStringContainsString('Vorschau bei 1300 px Platzbreite', $html);
$this->assertStringContainsString('lf-bt lf-bt--navy lf-bt--image-left lf-bt--height-spacious', htmlspecialchars_decode($html));
}
private function editor(): User private function editor(): User
{ {
$editor = User::factory()->redakteur()->create(); $editor = User::factory()->redakteur()->create();
+203
View File
@@ -0,0 +1,203 @@
<?php
namespace Tests\Feature;
use App\Domain\Cms\Page;
use App\Domain\Cms\PageService;
use App\Domain\Cms\Sections\SectionLayouts;
use App\Domain\Cms\Widgets\WidgetRegistry;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Validation\ValidationException;
use Tests\TestCase;
/**
* Premium-Widgets nach Brand-UI-Kit v1.6 und gemeinsamer Layoutvertrag (ADR-38).
* Gespeicherte Daten früherer Versionen bleiben lesbar und speicherbar.
*/
class CmsPremiumWidgetsTest extends TestCase
{
use RefreshDatabase;
/**
* @param list<array<string, mixed>> $content
*/
private function publish(string $path, array $content): string
{
$page = Page::query()->create(['path' => $path]);
$service = app(PageService::class);
$service->publish($page, $service->saveRevision($page, $content, null, null, null));
return $this->get($path)->assertOk()->getContent();
}
/**
* @param list<array<string, mixed>|null> $slots
* @param array<string, string> $style
* @return array<string, mixed>
*/
private function section(string $layout, array $slots, array $style = []): array
{
return ['layout' => $layout, 'style' => $style, 'slots' => $slots];
}
public function test_hero_from_design_iteration_one_is_upgraded_and_stays_savable(): void
{
$registry = app(WidgetRegistry::class);
$standard = $registry->upcast(['type' => 'hero', 'v' => 1, 'variant' => 'stage', 'settings' => ['focus' => 'top_right', 'text_side' => 'left'], 'data' => ['heading' => 'Alt', 'cta2_label' => 'Zwei', 'cta2_url' => '/b']]);
$this->assertSame(2, $standard['v']);
$this->assertSame('photo_split', $standard['variant']);
$this->assertSame([], $standard['settings'], 'Nicht mehr vorhandene Einstellungen werden entfernt.');
$this->assertSame([100, 0], [$standard['data']['focus_x'], $standard['data']['focus_y']]);
$this->assertSame('/b', $standard['data']['cta2_url']);
$highlight = $registry->upcast(['type' => 'hero', 'v' => 1, 'variant' => 'highlight', 'data' => ['heading' => 'Alt']]);
$this->assertSame('editorial_solid', $highlight['variant']);
$this->assertSame('editorial_solid', $registry->upcast(['type' => 'hero', 'v' => 1, 'variant' => 'editorial', 'data' => ['heading' => 'Alt']])['variant']);
// Szenario „bestehende Seite unverändert speichern“: gespeicherte v1-Hülle geht ohne Fehler durch die Prüfung.
$saved = $registry->normalize([['type' => 'hero', 'v' => 1, 'variant' => 'stage', 'settings' => ['focus' => 'left', 'text_side' => 'right'], 'data' => ['heading' => 'Alt', 'alt' => 'Bild'], 'refs' => ['image' => 'cms/alt.jpg']]]);
$this->assertSame(['photo_split', 2, [0, 50]], [$saved[0]['variant'], $saved[0]['v'], [$saved[0]['data']['focus_x'], $saved[0]['data']['focus_y']]]);
}
public function test_image_text_from_design_iteration_one_is_upgraded_and_stays_savable(): void
{
$saved = app(WidgetRegistry::class)->normalize([[
'type' => 'image_text', 'v' => 2, 'variant' => 'image_left',
'settings' => ['format' => 'portrait', 'focus' => 'bottom'],
'data' => ['title' => 'Alt', 'body' => '<p>Text</p>', 'alt' => 'Bild'], 'refs' => ['image' => 'cms/alt.jpg'],
]])[0];
$this->assertSame(3, $saved['v']);
$this->assertSame([], $saved['settings']);
$this->assertSame([50, 100], [$saved['data']['focus_x'], $saved['data']['focus_y']]);
$this->assertSame('image_left', $saved['variant']);
}
public function test_premium_hero_renders_variants_heights_and_accents(): void
{
$html = $this->publish('/einstiege', [
$this->section('u4', [[
'type' => 'hero', 'v' => 2, 'variant' => 'photo_split', 'settings' => ['height' => 'compact', 'accent' => 'none'],
'data' => ['eyebrow' => '<script>alert(1)</script>', 'heading' => 'Erster Einstieg', 'alt' => 'Lara und Felix', 'focus_x' => 30, 'focus_y' => 70],
'refs' => ['image' => 'cms/park.jpg'],
]]),
$this->section('u3_1', [[
'type' => 'hero', 'v' => 2, 'variant' => 'editorial_solid', 'settings' => ['height' => 'large', 'heading_level' => 'h3', 'accent' => 'rays'],
'data' => ['heading' => 'Zweiter Einstieg', 'cta_label' => 'Konzept', 'cta_url' => '/konzept'],
], null]),
]);
$this->assertStringContainsString('class="lf-hero lf-hero--photo-split lf-hero--height-compact lf-hero--accent-none"', $html);
$this->assertStringContainsString('style="--lf-hero-focus-x: 30%; --lf-hero-focus-y: 70%"', $html);
$this->assertStringContainsString('alt="Lara und Felix" loading="eager" fetchpriority="high" decoding="async"', $html);
$this->assertStringContainsString('&lt;script&gt;alert(1)&lt;/script&gt;', $html);
$this->assertStringNotContainsString('<script>alert(1)</script>', $html);
$this->assertSame(1, substr_count($html, '<h1'), 'Genau eine Hauptüberschrift je Seite.');
$this->assertStringContainsString('<h1 class="lf-hero__title">Erster Einstieg</h1>', $html);
$this->assertStringContainsString('<h3 class="lf-hero__title">Zweiter Einstieg</h3>', $html);
$this->assertStringContainsString('lf-hero--editorial-solid lf-hero--height-large lf-hero--accent-rays', $html);
$this->assertStringContainsString('brand-rays lf-hero__rays', $html);
$this->assertSame(1, substr_count($html, 'lf-hero__title-accent'), 'Ohne Akzent keine Unterstreichung.');
$this->assertStringContainsString('widget-hero widget-variant-photo-split widget-height-compact', $html);
}
public function test_hero_rejects_unsafe_links_and_out_of_range_focus(): void
{
$cases = [
'blocks.0.data.cta2_url' => ['heading' => 'X', 'cta2_label' => 'Böse', 'cta2_url' => 'javascript:alert(1)'],
'blocks.0.data.focus_x' => ['heading' => 'X', 'focus_x' => 150],
];
foreach ($cases as $key => $data) {
try {
app(WidgetRegistry::class)->normalize([['type' => 'hero', 'v' => 2, 'data' => $data]]);
$this->fail("$key wurde angenommen.");
} catch (ValidationException $exception) {
$this->assertArrayHasKey($key, $exception->errors());
}
}
}
public function test_premium_image_text_renders_surface_height_side_and_sanitized_body(): void
{
$html = $this->publish('/bild-text', [
['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Seite']],
$this->section('u4', [[
'type' => 'image_text', 'v' => 3, 'variant' => 'image_left',
'settings' => ['surface' => 'navy', 'height' => 'spacious', 'heading_level' => 'h3'],
'data' => ['eyebrow' => 'Unser Ansatz', 'title' => 'Geschichten', 'body' => '<p>Text</p><script>alert(1)</script>', 'alt' => 'Park', 'cta_label' => 'Mehr', 'cta_url' => '/konzept', 'cta2_label' => 'Themen', 'cta2_url' => 'https://example.org/themen', 'focus_x' => 10, 'focus_y' => 90],
'refs' => ['image' => 'cms/park.jpg'],
]]),
$this->section('u4', [['type' => 'image_text', 'v' => 3, 'data' => ['body' => '<p>Ohne Bild</p>']]]),
]);
$this->assertStringContainsString('class="lf-bt lf-bt--navy lf-bt--image-left lf-bt--height-spacious"', $html);
$this->assertStringContainsString('style="--bt-focus-x: 10%; --bt-focus-y: 90%"', $html);
$this->assertStringContainsString('<h3 class="lf-bt__headline">Geschichten</h3>', $html);
$this->assertStringContainsString('<p class="lf-bt__eyebrow">Unser Ansatz</p>', $html);
$this->assertStringNotContainsString('<script>alert(1)</script>', $html);
$this->assertStringContainsString('<a class="lf-bt__button" href="/konzept">Mehr <span aria-hidden="true">→</span></a>', $html);
$this->assertStringContainsString('<a class="lf-bt__button lf-bt__button--secondary" href="https://example.org/themen">Themen</a>', $html);
$this->assertStringContainsString('lf-bt lf-bt--cream lf-bt--image-left lf-bt--height-normal lf-bt--without-image', $html);
}
/**
* Gemeinsamer Layoutvertrag für alle Bestandswidgets: In jeder zulässigen Platzbreite wird gerendert; nicht
* zulässige Breiten werden beim Speichern mit verständlicher Meldung abgewiesen.
*/
public function test_every_widget_renders_in_each_supported_width_and_rejects_the_others(): void
{
$samples = [
'heading' => ['heading' => 'Überschrift mit einem sehr langen Wort Gewaltpräventionsfortbildungsmaßnahme'],
'prose' => ['body' => 'Fließtext mit einer langen Adresse https://example.org/'.str_repeat('a', 80)],
'cards' => ['items' => [['title' => 'Karte mit langem Titel für schmale Plätze', 'text' => 'Beschreibung', 'url' => '/a']]],
'call_to_action' => ['heading' => 'Aufruf', 'text' => 'Text', 'label' => 'Eine ausgesprochen lange Schaltflächenbeschriftung zum Prüfen', 'url' => '/a'],
'faq' => ['items' => [['question' => 'Frage?', 'answer' => 'Antwort.']]],
'hero' => ['heading' => 'Einstieg mit einer langen Überschrift, die umbrechen muss'],
'image_text' => ['title' => 'Bild und Text', 'body' => '<p>Text</p>'],
];
$registry = app(WidgetRegistry::class);
$layouts = ['u4' => [4], 'u3_1' => [3, 1], 'u2_2' => [2, 2], 'u1_1_1_1' => [1, 1, 1, 1]];
$path = 0;
foreach ($samples as $type => $data) {
$widgetType = $registry->get($type);
$widget = ['type' => $type, 'v' => $widgetType->version(), 'data' => $data];
foreach ($layouts as $layout => $units) {
$slots = array_fill(0, count($units), null);
$slots[0] = $widget;
if ($widgetType->supportsUnits($units[0])) {
$html = $this->publish('/raster-'.(++$path), [$this->section($layout, $slots)]);
$this->assertStringContainsString('widget-'.str_replace('_', '-', $type), $html, "$type in $layout");
$this->assertStringContainsString('data-units="'.$units[0].'"', $html, "$type in $layout");
} else {
try {
app(PageService::class)->saveRevision(Page::query()->create(['path' => '/abgewiesen-'.(++$path)]), [$this->section($layout, $slots)], null, null, null);
$this->fail("$type in $layout ({$units[0]} Einheiten) wurde angenommen.");
} catch (ValidationException $exception) {
$this->assertStringContainsString($widgetType->unitsLabel().' Rastereinheiten', $exception->errors()['sections.0.slots.0.units'][0]);
}
}
}
}
$this->assertSame(['u4', 'u2_2', 'u1_3', 'u3_1', 'u1_2_1', 'u1_1_1_1'], array_keys(SectionLayouts::UNITS));
}
public function test_fill_height_marks_the_widget_and_defaults_to_content_height(): void
{
$html = $this->publish('/fuellen', [
$this->section('u2_2', [
['type' => 'call_to_action', 'v' => 1, 'settings' => ['height' => 'fill'], 'data' => ['heading' => 'Gleich hoch', 'label' => 'Los', 'url' => '/a']],
['type' => 'call_to_action', 'v' => 1, 'data' => ['heading' => 'Nach Inhalt', 'label' => 'Los', 'url' => '/b']],
]),
]);
$this->assertStringContainsString('widget-call-to-action widget-variant-standard widget-height-fill', $html);
$this->assertStringContainsString('widget-call-to-action widget-variant-standard widget-height-auto', $html);
$this->assertStringNotContainsString('widget-prose widget-variant-standard widget-height', $html);
}
}
+1 -1
View File
@@ -137,7 +137,7 @@ public function test_global_layout_has_header_navigation_mobile_menu_and_footer(
$html = $this->get('/praevention')->assertOk()->getContent(); $html = $this->get('/praevention')->assertOk()->getContent();
$this->assertStringContainsString('<a class="skip" href="#inhalt">', $html); $this->assertStringContainsString('<a class="skip" href="#inhalt">', $html);
$this->assertStringContainsString('class="brand" href="'.route('home').'" data-brand-status="vorlaeufig"', $html); $this->assertStringContainsString('class="brand brand-lockup" href="'.route('home').'" data-brand-status="vorlaeufig"', $html);
$this->assertStringContainsString('aria-label="Hauptnavigation"', $html); $this->assertStringContainsString('aria-label="Hauptnavigation"', $html);
$this->assertMatchesRegularExpression('#<a href="[^"]*/praevention"\s+aria-current="page"\s*>Prävention</a>#', $html); $this->assertMatchesRegularExpression('#<a href="[^"]*/praevention"\s+aria-current="page"\s*>Prävention</a>#', $html);
$this->assertStringContainsString('data-site-menu-button', $html); $this->assertStringContainsString('data-site-menu-button', $html);
+7 -6
View File
@@ -140,7 +140,8 @@ public function test_new_revisions_are_stored_as_widget_envelopes(): void
$this->assertSame(['id', 'type', 'v', 'variant', 'settings', 'data', 'refs'], array_keys($revision->blocks[0])); $this->assertSame(['id', 'type', 'v', 'variant', 'settings', 'data', 'refs'], array_keys($revision->blocks[0]));
$this->assertSame('prose', $revision->blocks[0]['type']); $this->assertSame('prose', $revision->blocks[0]['type']);
$this->assertSame(['body' => 'Altes Eingabeformat'], $revision->blocks[0]['data']); $this->assertSame(['body' => 'Altes Eingabeformat'], $revision->blocks[0]['data']);
$this->assertSame('highlight', $revision->blocks[1]['variant']); // Gespeichert wird immer die aktuelle Version: hero v1 „highlight“ wird zu v2 „editorial_solid“.
$this->assertSame([2, 'editorial_solid'], [$revision->blocks[1]['v'], $revision->blocks[1]['variant']]);
$this->assertNull($page->fresh()->published_revision_id, 'Speichern veröffentlicht nicht.'); $this->assertNull($page->fresh()->published_revision_id, 'Speichern veröffentlicht nicht.');
} }
@@ -156,11 +157,11 @@ public function test_reference_widgets_render_their_variants(): void
$this->get('/varianten') $this->get('/varianten')
->assertOk() ->assertOk()
->assertSee('hero hero-highlight', false) ->assertSee('lf-hero lf-hero--editorial-solid lf-hero--height-normal', false)
->assertSee('<h1>Stark im Alltag</h1>', false) ->assertSee('<h1 class="lf-hero__title">Stark im Alltag</h1>', false)
->assertSee('class="button" href="/praevention"', false) ->assertSee('class="lf-hero__button lf-hero__button--primary" href="/praevention"', false)
->assertSee('image-text image-text-right', false) ->assertSee('lf-bt lf-bt--cream lf-bt--image-right lf-bt--height-normal', false)
->assertSee('<h2>Bild rechts</h2>', false) ->assertSee('<h2 class="lf-bt__headline">Bild rechts</h2>', false)
->assertSee('<em>betont</em>', false) ->assertSee('<em>betont</em>', false)
->assertSee(route('media.public', ['path' => 'cms/beispiel.jpg']), false) ->assertSee(route('media.public', ['path' => 'cms/beispiel.jpg']), false)
->assertSee('cards cards-compact', false); ->assertSee('cards cards-compact', false);
+19 -8
View File
@@ -108,20 +108,31 @@ public function test_surplus_empty_slots_are_compacted_without_losing_widgets():
$this->assertSame(['A', 'C'], array_map(fn ($slot) => $slot['data']['heading'], $stored[0]['slots'])); $this->assertSame(['A', 'C'], array_map(fn ($slot) => $slot['data']['heading'], $stored[0]['slots']));
} }
public function test_widget_minimum_width_is_enforced_per_slot(): void /**
* Layoutvertrag (ADR-38): Ein Platz muss eine der unterstützten Breiten haben. Der Premium-Einstieg ist seit
* Kit v1.6 nur für 3 oder 4 Einheiten vorgesehen (vorher Mindestbreite 2).
*/
public function test_widget_supported_widths_are_enforced_per_slot(): void
{ {
$hero = ['type' => 'hero', 'v' => 1, 'data' => ['heading' => 'Einstieg']]; $hero = ['type' => 'hero', 'v' => 2, 'data' => ['heading' => 'Einstieg']];
try { foreach ([['u1_3', [$hero, null]], ['u2_2', [$hero, null]]] as [$layout, $slots]) {
$this->sections()->normalize([$this->section('u1_3', [$hero, null])]); try {
$this->fail('Einstieg im schmalen Platz wurde angenommen.'); $this->sections()->normalize([$this->section($layout, $slots)]);
} catch (ValidationException $exception) { $this->fail("Einstieg im zu schmalen Platz ($layout) wurde angenommen.");
$this->assertArrayHasKey('sections.0.slots.0.units', $exception->errors()); } catch (ValidationException $exception) {
$this->assertArrayHasKey('sections.0.slots.0.units', $exception->errors());
$this->assertStringContainsString('3 oder 4 Rastereinheiten', $exception->errors()['sections.0.slots.0.units'][0]);
}
} }
$stored = $this->sections()->normalize([$this->section('u1_3', [null, $hero])]); $stored = $this->sections()->normalize([$this->section('u1_3', [null, $hero])]);
$this->assertSame('hero', $stored[0]['slots'][1]['type']); $this->assertSame('hero', $stored[0]['slots'][1]['type']);
$this->assertSame(2, app(WidgetRegistry::class)->get('hero')->minUnits()); $this->assertSame([3, 4], app(WidgetRegistry::class)->get('hero')->supportedUnits());
$imageText = ['type' => 'image_text', 'v' => 3, 'data' => ['body' => '<p>Schmal</p>']];
$stored = $this->sections()->normalize([$this->section('u1_1_1_1', [$imageText, null, null, null])]);
$this->assertSame('image_text', $stored[0]['slots'][0]['type'], 'Bild und Text ist für 1 bis 4 Einheiten freigegeben.');
} }
public function test_free_style_values_and_unknown_layouts_are_rejected(): void public function test_free_style_values_and_unknown_layouts_are_rejected(): void
+49 -11
View File
@@ -66,18 +66,56 @@ public function test_registration_rejects_keys_that_are_not_stable_identifiers()
new WidgetRegistry([$this->customWidget('Teaser Box')]); new WidgetRegistry([$this->customWidget('Teaser Box')]);
} }
public function test_every_widget_declares_a_minimum_width_within_four_units(): void /** Gemeinsamer Layoutvertrag (ADR-38) für jede registrierte Art. */
public function test_every_widget_declares_the_shared_layout_contract(): void
{ {
foreach ($this->registry()->all() as $key => $type) { foreach ($this->registry()->all() as $key => $type) {
$this->assertGreaterThanOrEqual(1, $type->minUnits(), $key); $units = $type->supportedUnits();
$this->assertLessThanOrEqual($type->preferredUnits(), $type->minUnits(), $key); $this->assertNotEmpty($units, $key);
$this->assertLessThanOrEqual(4, $type->preferredUnits(), $key); $this->assertSame([], array_diff($units, [1, 2, 3, 4]), $key);
$this->assertSame(min($units), $type->minUnits(), $key);
$this->assertTrue($type->supportsUnits($type->preferredUnits()), $key);
$this->assertNotEmpty($type->stages(), $key); $this->assertNotEmpty($type->stages(), $key);
$this->assertNotSame('', $type->narrowBehavior(), $key);
$this->assertSame([], array_diff(array_keys($type->heights()), array_keys(WidgetType::HEIGHTS)), $key);
if ($type->heights() !== []) {
$this->assertArrayHasKey($type->defaultHeight(), $type->heights(), $key);
$this->assertSame($type->heights(), $type->settingOptions()['height'], $key);
}
} }
$this->assertSame(2, $this->registry()->get('hero')->minUnits()); $this->assertSame([3, 4], $this->registry()->get('hero')->supportedUnits());
$this->assertSame(2, $this->registry()->get('image_text')->minUnits()); $this->assertSame(['compact', 'normal', 'large'], array_keys($this->registry()->get('hero')->heights()));
$this->assertSame(1, $this->registry()->get('catalog_cards')->minUnits()); $this->assertSame([1, 2, 3, 4], $this->registry()->get('image_text')->supportedUnits());
$this->assertSame(['compact', 'normal', 'spacious'], array_keys($this->registry()->get('image_text')->heights()));
$this->assertSame(['auto', 'fill'], array_keys($this->registry()->get('call_to_action')->heights()));
$this->assertSame([2, 3, 4], $this->registry()->get('faq')->supportedUnits());
$this->assertSame('3 oder 4', $this->registry()->get('hero')->unitsLabel());
$this->assertSame('1 bis 4', $this->registry()->get('cards')->unitsLabel());
}
public function test_height_is_an_enumerated_setting_with_a_default(): void
{
$widget = $this->registry()->normalize([
['type' => 'hero', 'v' => 2, 'settings' => ['height' => 'large'], 'data' => ['heading' => 'X']],
])[0];
$this->assertSame('large', $widget['settings']['height']);
$this->assertSame('normal', $this->registry()->get('hero')->height(['settings' => []]));
try {
$this->registry()->normalize([['type' => 'hero', 'v' => 2, 'settings' => ['height' => '900px'], 'data' => ['heading' => 'X']]]);
$this->fail('Freie Höhe wurde angenommen.');
} catch (ValidationException $exception) {
$this->assertArrayHasKey('blocks.0.settings.height', $exception->errors());
}
try {
$this->registry()->normalize([['type' => 'prose', 'v' => 1, 'settings' => ['height' => 'compact'], 'data' => ['body' => 'Text']]]);
$this->fail('Höhe für eine Art ohne Höhenwahl wurde angenommen.');
} catch (ValidationException $exception) {
$this->assertArrayHasKey('blocks.0.settings.height', $exception->errors());
}
} }
public function test_a_new_widget_type_works_through_the_contract_alone(): void public function test_a_new_widget_type_works_through_the_contract_alone(): void
@@ -112,7 +150,7 @@ public function test_unknown_type_and_unregistered_variant_are_rejected(): void
} }
try { try {
$this->registry()->normalize([['type' => 'hero', 'v' => 1, 'variant' => 'gross-und-bunt', 'data' => ['heading' => 'X']]]); $this->registry()->normalize([['type' => 'hero', 'v' => 2, 'variant' => 'gross-und-bunt', 'data' => ['heading' => 'X']]]);
$this->fail('Unbekannte Variante wurde angenommen.'); $this->fail('Unbekannte Variante wurde angenommen.');
} catch (ValidationException $exception) { } catch (ValidationException $exception) {
$this->assertArrayHasKey('blocks.0.variant', $exception->errors()); $this->assertArrayHasKey('blocks.0.variant', $exception->errors());
@@ -204,13 +242,13 @@ public function test_legacy_blocks_are_read_as_version_one_envelopes(): void
], $widget); ], $widget);
} }
public function test_legacy_image_text_is_upgraded_to_version_two_on_read(): void public function test_legacy_image_text_is_upgraded_to_the_current_version_on_read(): void
{ {
$legacy = ['type' => 'image_text', 'image' => 'cms/alt.jpg', 'alt' => 'Kinder im Kreis', 'body' => "Erster Absatz & mehr.\n\nZweiter <Absatz>."]; $legacy = ['type' => 'image_text', 'image' => 'cms/alt.jpg', 'alt' => 'Kinder im Kreis', 'body' => "Erster Absatz & mehr.\n\nZweiter <Absatz>."];
$widget = $this->registry()->upcast($legacy); $widget = $this->registry()->upcast($legacy);
$this->assertSame(2, $widget['v']); $this->assertSame(3, $widget['v']);
$this->assertSame('image_left', $widget['variant']); $this->assertSame('image_left', $widget['variant']);
$this->assertSame(['image' => 'cms/alt.jpg'], $widget['refs']); $this->assertSame(['image' => 'cms/alt.jpg'], $widget['refs']);
$this->assertSame('Kinder im Kreis', $widget['data']['alt']); $this->assertSame('Kinder im Kreis', $widget['data']['alt']);
@@ -225,7 +263,7 @@ public function test_stored_version_one_envelope_is_upgraded_as_well(): void
'data' => ['image' => null, 'alt' => 'x', 'body' => 'Nur Text'], 'refs' => [], 'data' => ['image' => null, 'alt' => 'x', 'body' => 'Nur Text'], 'refs' => [],
]); ]);
$this->assertSame(2, $widget['v']); $this->assertSame(3, $widget['v']);
$this->assertSame('abc', $widget['id']); $this->assertSame('abc', $widget['id']);
$this->assertSame('image_left', $widget['variant']); $this->assertSame('image_left', $widget['variant']);
$this->assertSame('<p>Nur Text</p>', $widget['data']['body']); $this->assertSame('<p>Nur Text</p>', $widget['data']['body']);
+1 -1
View File
@@ -11,7 +11,7 @@ export default defineConfig({
fonts: [ fonts: [
// Vorläufige Markenschriften (Website-Zielkonzept 7.2, nicht freigegeben); beim Build lokal abgelegt. // Vorläufige Markenschriften (Website-Zielkonzept 7.2, nicht freigegeben); beim Build lokal abgelegt.
bunny('Nunito', { bunny('Nunito', {
weights: [700, 800], weights: [700, 800, 900],
optimizedFallbacks: false, optimizedFallbacks: false,
}), }),
bunny('Source Sans 3', { bunny('Source Sans 3', {