Author SHA1 Message Date
StommerandClaude Sonnet 5.5 ca0f68e8f6 Zeige die Überschrift der Größen-Seite nur einmal
Deploy Test / test (push) Successful in 2m12s
Deploy Test / deploy (push) Successful in 27s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 15:31:31 +01:00
Stommer aa1e6eb6ac Merge branch 'feature/design-groessen' into develop
Deploy Test / test (push) Successful in 3m9s
Deploy Test / deploy (push) Successful in 35s
2026-11-22 15:02:22 +01:00
LarsandClaude Sonnet 5.5 b8c5c68887 Sperre andere Methoden als GET/HEAD auf den Shop-Hosts bei X-Forwarded-Proto http
CI Feature / test (push) Successful in 2m2s
Deploy Test / test (push) Successful in 1m52s
Deploy Test / deploy (push) Successful in 30s
Setzt die Synology ausdrücklich X-Forwarded-Proto: http, enden POST, PUT, DELETE
usw. auf lara-und-felix.de, www.lara-und-felix.de und www.laraundfelix.de mit
403 im Nginx, bevor Laravel die Anfrage sieht. GET und HEAD werden wie bisher
per 301 weitergeleitet. Unverändert bleiben HTTPS (Stripe-Webhook), die
ACME-Ausnahme, dev.laraundfelix.de und der Zugriff ohne X-Forwarded-Proto
(Health-Check).

Mit nginx 1.27.5 in 49 Fällen geprüft; Reihenfolge und Zusagen in
NginxConfigTest, Betrieb in docs/betrieb/DEPLOYMENT.md.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 12:33:39 +01:00
LarsandClaude Sonnet 5.5 acb88e4a1d Leite www- und HTTP-Aufrufe im Shop-Nginx auf lara-und-felix.de um
CI Feature / test (push) Successful in 2m40s
Deploy Test / test (push) Successful in 2m4s
Deploy Test / deploy (push) Successful in 30s
GET und HEAD auf www.lara-und-felix.de und www.laraundfelix.de sowie auf
http://lara-und-felix.de (nur bei X-Forwarded-Proto http) bekommen ein 301 auf
die feste Adresse https://lara-und-felix.de, Pfad und Query bleiben erhalten.
Andere Methoden (Stripe-Webhook), die ACME-Prüfung, dev.laraundfelix.de und
direkter Zugriff ohne Proxy-Header (Health-Check) bleiben unverändert.

Mit nginx 1.27.5 und php-cgi in 30 Fällen geprüft; Zusagen der Konfiguration
stehen in NginxConfigTest, Betrieb in docs/betrieb/DEPLOYMENT.md.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 11:52:46 +01:00
LarsandClaude Sonnet 5.5 2a54347d50 Belege die gegliederte Darstellung mit Screenshots
Deploy Test / test (push) Successful in 1m51s
Deploy Test / deploy (push) Successful in 32s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 10:35:18 +01:00
Lars 992171bb7a Merge remote-tracking branch 'origin/develop' into feature/darstellung-gruppiert
Deploy Test / test (push) Successful in 1m45s
Deploy Test / deploy (push) Successful in 24s
2026-11-22 10:28:14 +01:00
LarsandClaude Sonnet 5.5 061181f30d Gliedere den Reiter Darstellung in Gruppen und erkläre jede Einstellung im (i)
CI Feature / test (push) Successful in 1m46s
Aufbau, Gruppen je Widget (Bild und Video, Texte auf der Karte, Seitenstruktur,
Aussehen), Erklärungen als Tooltip statt Hilfetext, Bezeichnungen vereinheitlicht.
Bei „Texte auf der Karte: Ausblenden“ verschwinden die Einzelschalter; ihre Werte bleiben.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 10:26:19 +01:00
15 changed files with 398 additions and 29 deletions

No files matched your search

+9 -1
View File
@@ -115,10 +115,18 @@ public function settings(): array
]; ];
} }
public function settingGroups(): array
{
return [
'Aussehen' => ['accent'],
'Seitenstruktur' => ['heading_level'],
];
}
public function settingLabels(): array public function settingLabels(): array
{ {
return [ return [
'heading_level' => ['Überschriftenebene', 'Der erste Einstieg einer Seite ist immer die Hauptüberschrift (H1).'], 'heading_level' => ['Überschriftenebene', 'Betrifft nur die Gliederung für Suchmaschinen und Hilfstechnik, nicht das Aussehen. Der erste Einstieg einer Seite ist immer die Hauptüberschrift (H1).'],
'accent' => ['Markenakzent', 'Freigegebene Akzente aus dem Brand-UI-Kit. Vorgabe: gelbe Unterstreichung.'], 'accent' => ['Markenakzent', 'Freigegebene Akzente aus dem Brand-UI-Kit. Vorgabe: gelbe Unterstreichung.'],
]; ];
} }
@@ -117,11 +117,19 @@ public function settings(): array
]; ];
} }
public function settingGroups(): array
{
return [
'Aussehen' => ['surface'],
'Seitenstruktur' => ['heading_level'],
];
}
public function settingLabels(): array public function settingLabels(): array
{ {
return [ return [
'surface' => ['Hintergrund des Widgets', 'Unabhängig vom Abschnittshintergrund. „Ohne eigene Fläche“ übernimmt den Abschnitt.'], '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.'], 'heading_level' => ['Überschriftenebene', 'Betrifft nur die Gliederung für Suchmaschinen und Hilfstechnik, nicht das Aussehen. Steht das Widget als erstes auf der Seite, ist die Überschrift immer H1.'],
]; ];
} }
@@ -176,19 +176,34 @@ public function settings(): array
]; ];
} }
public function settingGroups(): array
{
return [
'Bild und Video' => ['format', 'fit', 'clip'],
'Texte auf der Karte' => ['show_body', 'text_source', 'show_summary', 'show_kind', 'show_meta', 'show_action'],
'Seitenstruktur' => ['heading_level'],
];
}
public function settingHiddenWhen(): array
{
// „Texte auf der Karte: Ausblenden“ macht die Einzelschalter wirkungslos; sie bleiben gespeichert, aber unsichtbar.
return array_fill_keys(['text_source', 'show_summary', 'show_kind', 'show_meta', 'show_action'], ['show_body', 'no']);
}
public function settingLabels(): array public function settingLabels(): array
{ {
return [ return [
'text_source' => ['Text der Karte', 'Welche Angabe aus der Redaktion die Karte zeigt. Vorgabe: Automatisch. Der gewählte Text erscheint öffentlich, wenn die Karte öffentlich ist; ist er nicht gepflegt, bleibt die Karte ohne Text.'], 'format' => ['Bildformat', 'Seitenverhältnis des Bildes oder Videos. Vorgabe: Querformat 16:9. Gilt auch neben dem Text; das Motiv wird nicht nachträglich hochkant beschnitten.'],
'fit' => ['Bildausschnitt', 'Ausschnitt füllt die ganze Fläche; „Ganzes Bild“ zeigt Dokumente und Poster vollständig auf ruhiger Fläche. Vorgabe: Ausschnitt.'],
'clip' => ['Trailer auf der Karte', 'Spielt den freigegebenen Trailer als stumme Vorschau, solange die Maus auf der Karte steht; ein Klick oder Tipp auf das Bild oder die kleine Schaltfläche (auch per Tastatur) spielt ihn mit Ton. Gewählt wird der Trailer (sonst der Vorschauclip) in der Präsentation des Objekts, bei einem Film ersatzweise sein freigegebener Teaser. Ohne freigegebenen Clip bleibt das Kartenbild. Vorgabe: Abspielen.'], 'clip' => ['Trailer auf der Karte', 'Spielt den freigegebenen Trailer als stumme Vorschau, solange die Maus auf der Karte steht; ein Klick oder Tipp auf das Bild oder die kleine Schaltfläche (auch per Tastatur) spielt ihn mit Ton. Gewählt wird der Trailer (sonst der Vorschauclip) in der Präsentation des Objekts, bei einem Film ersatzweise sein freigegebener Teaser. Ohne freigegebenen Clip bleibt das Kartenbild. Vorgabe: Abspielen.'],
'show_body' => ['Texte neben dem Bild', 'Ausblenden zeigt nur Bild und Video, ohne Titel, Text, Art, Zusatzangaben und Aktion. Für Hilfstechnik bleibt der Titel unsichtbar erhalten. Sinnvoll, wenn das Video allein erklärt. Vorgabe: anzeigen.'], 'show_body' => ['Texte auf der Karte', 'Hauptschalter für alle Texte neben dem Bild. „Ausblenden“ zeigt nur Bild und Video, ohne Titel, Beschreibung, Art, Zusatzangaben und Schaltfläche; die Einzelschalter darunter verschwinden dann. Für Hilfstechnik bleibt der Titel unsichtbar erhalten. Sinnvoll, wenn das Video allein erklärt. Vorgabe: Anzeigen.'],
'format' => ['Bildformat', 'Vorgabe: Querformat 16:9. Gilt auch neben dem Text; das Motiv wird nicht nachträglich hochkant beschnitten.'], 'text_source' => ['Quelle der Beschreibung', 'Welche Angabe aus der Redaktion als Beschreibung erscheint. Vorgabe: Automatisch. Der Text erscheint öffentlich, wenn die Karte öffentlich ist; ist er nicht gepflegt, bleibt die Karte ohne Beschreibung.'],
'fit' => ['Bilddarstellung', 'Vorgabe: Ausschnitt. „Ganzes Bild“ zeigt Dokumente und Poster vollständig auf ruhiger Fläche.'], 'show_summary' => ['Beschreibung', 'Der Beschreibungstext unter dem Titel, aus den Fachdaten. Vorgabe: Anzeigen.'],
'heading_level' => ['Überschriftenebene', 'Vorgabe: H3, passend unter einer Abschnittsüberschrift (H2).'], 'show_kind' => ['Art-Label', 'Kleines Label über dem Titel, zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: Anzeigen.'],
'show_summary' => ['Text anzeigen', 'Aus den Fachdaten. Vorgabe: anzeigen.'], 'show_meta' => ['Zusatzangaben', 'Angaben aus den Fachdaten, zum Beispiel Ausgabeart oder Programmzugehörigkeit. Vorgabe: Anzeigen.'],
'show_kind' => ['Art oder Label', 'Zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: anzeigen.'], 'show_action' => ['Schaltfläche', 'Verweis auf die öffentliche Seite des Fachobjekts, falls es eine gibt. Vorgabe: Anzeigen.'],
'show_meta' => ['Zusatzangaben', 'Aus den Fachdaten, zum Beispiel Ausgabeart oder Programmzugehörigkeit. Vorgabe: anzeigen.'], 'heading_level' => ['Überschriftenebene', 'Betrifft nur die Gliederung für Suchmaschinen und Hilfstechnik, nicht das Aussehen. Vorgabe: H3, passend unter einer Abschnittsüberschrift (H2).'],
'show_action' => ['Aktion', 'Verweis auf die öffentliche Seite des Fachobjekts, falls es eine gibt. Vorgabe: anzeigen.'],
]; ];
} }
+23
View File
@@ -194,6 +194,29 @@ public function settingLabels(): array
return []; return [];
} }
/**
* Gliederung der Einstellungen im Reiter „Darstellung“: Gruppentitel => Schlüssel der Einstellungen in der
* Reihenfolge der Anzeige. Variante und Höhe stehen immer in der ersten Gruppe „Aufbau“. Einstellungen ohne
* Gruppe erscheinen unter „Weitere Einstellungen“, so geht keine verloren.
*
* @return array<string, list<string>>
*/
public function settingGroups(): array
{
return [];
}
/**
* Einstellungen, die im Editor ausgeblendet werden, solange eine andere Einstellung einen bestimmten Wert hat:
* Schlüssel => [steuernde Einstellung, Wert, bei dem ausgeblendet wird]. Die Werte bleiben dabei erhalten.
*
* @return array<string, array{0: string, 1: string}>
*/
public function settingHiddenWhen(): array
{
return [];
}
/** /**
* Alle zulässigen Einstellungen einschließlich der gemeinsamen Höhe. Registry-Prüfung, Editor und Darstellung * Alle zulässigen Einstellungen einschließlich der gemeinsamen Höhe. Registry-Prüfung, Editor und Darstellung
* verwenden ausschließlich diese Zusammenführung. * verwenden ausschließlich diese Zusammenführung.
+2 -1
View File
@@ -49,9 +49,10 @@ public function mount(): void
$this->ladeGespeicherte(); $this->ladeGespeicherte();
} }
/** Die Überschrift steht im gemeinsamen Objektkopf (filament.verwaltung.kopf), nicht doppelt im Seitenkopf. */
public function getHeading(): string|Htmlable|null public function getHeading(): string|Htmlable|null
{ {
return 'Größen'; return null;
} }
public function getMaxContentWidth(): Width|string|null public function getMaxContentWidth(): Width|string|null
+60 -12
View File
@@ -17,6 +17,7 @@
use Filament\Forms\Components\ToggleButtons; use Filament\Forms\Components\ToggleButtons;
use Filament\Notifications\Notification; use Filament\Notifications\Notification;
use Filament\Schemas\Components\Grid; use Filament\Schemas\Components\Grid;
use Filament\Schemas\Components\Group;
use Filament\Schemas\Components\Section; use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Tabs; use Filament\Schemas\Components\Tabs;
use Filament\Schemas\Components\Tabs\Tab; use Filament\Schemas\Components\Tabs\Tab;
@@ -121,45 +122,92 @@ public static function slotBuilder(string $name = 'widget'): Builder
->columnSpanFull(); ->columnSpanFull();
} }
/**
* Erklärung als kleines (i) neben der Bezeichnung: erscheint beim Überfahren und beim Fokussieren.
*/
private static function withInfo(ToggleButtons|Select $component, ?string $help): ToggleButtons|Select
{
return filled($help)
? $component->hintIcon('heroicon-m-information-circle', tooltip: $help)->hintColor('gray')
: $component;
}
public static function block(WidgetType $type): Block public static function block(WidgetType $type): Block
{ {
$icons = $type->optionIcons(); $icons = $type->optionIcons();
$display = []; $display = [];
// Aufbau: Anordnung (Variante) und gemeinsame Höhe. Erklärungen stehen im (i) neben der Bezeichnung.
$layout = [];
if (count($type->variants()) > 1) { if (count($type->variants()) > 1) {
$display[] = ToggleButtons::make('variant') $layout[] = self::withInfo(ToggleButtons::make('variant')
->label('Darstellung') ->label('Anordnung')
->options($type->variants()) ->options($type->variants())
->icons($icons['variant'] ?? []) ->icons($icons['variant'] ?? [])
->default($type->defaultVariant()) ->default($type->defaultVariant())
->inline() ->inline()
->required() ->required()
->live(); ->live(), 'Wie Bild und Text zueinander stehen. Bei wenig Platz stellt sich jede Anordnung selbständig um; die gespeicherte Seite bleibt erhalten.');
} }
$settings = []; $options = $type->settingOptions();
$labels = $type->settingLabels(); $labels = $type->settingLabels();
foreach ($type->settingOptions() as $key => $options) { $hiddenWhen = $type->settingHiddenWhen();
$field = function (string $key) use ($options, $labels, $type, $icons, $hiddenWhen): Select|ToggleButtons {
$help = $labels[$key][1] ?? null;
// Gemeinsame Höhe (ADR-38): immer als sichtbare Auswahl mit Vorgabe, nie als freie Eingabe. // Gemeinsame Höhe (ADR-38): immer als sichtbare Auswahl mit Vorgabe, nie als freie Eingabe.
$settings[] = $key === 'height' $component = $key === 'height'
? ToggleButtons::make('height') ? ToggleButtons::make('height')
->label('Höhe') ->label('Höhe')
->helperText('Gestaltungsparameter, keine Begrenzung: Längere Inhalte erhalten immer den nötigen Platz.') ->options($options['height'])
->options($options)
->icons($icons['height'] ?? []) ->icons($icons['height'] ?? [])
->default($type->defaultHeight()) ->default($type->defaultHeight())
->inline() ->inline()
->live() ->live()
: Select::make($key) : Select::make($key)
->label($labels[$key][0] ?? Str::headline($key)) ->label($labels[$key][0] ?? Str::headline($key))
->helperText($labels[$key][1] ?? null)
->placeholder('Vorgabe der Darstellung') ->placeholder('Vorgabe der Darstellung')
->options($options) ->options($options[$key])
->live(); ->live();
if ($key === 'height') {
$help = 'Gestaltungsparameter, keine Begrenzung: Längere Inhalte erhalten immer den nötigen Platz.';
}
if (isset($hiddenWhen[$key])) {
[$controller, $value] = $hiddenWhen[$key];
// Ausgeblendete Werte bleiben gespeichert, damit ein späteres Einblenden nichts zurücksetzt.
$component->hidden(fn (Get $get): bool => ($get($controller) ?? null) === $value)->dehydratedWhenHidden();
}
return self::withInfo($component, $help);
};
if (isset($options['height'])) {
$layout[] = Group::make([$field('height')])->statePath('settings');
} }
if ($settings !== []) { if ($layout !== []) {
$display[] = Grid::make(['default' => 1, 'md' => 2])->schema($settings)->statePath('settings'); $display[] = Section::make('Aufbau')->compact()->schema($layout);
}
$grouped = [];
foreach ($type->settingGroups() as $title => $keys) {
$keys = array_values(array_filter($keys, fn (string $key): bool => isset($options[$key]) && $key !== 'height'));
$grouped = [...$grouped, ...$keys];
if ($keys !== []) {
$display[] = Section::make($title)->compact()->schema([
Grid::make(['default' => 1, 'md' => 2])->schema(array_map($field, $keys))->statePath('settings'),
]);
}
}
$rest = array_values(array_filter(array_keys($options), fn (string $key): bool => $key !== 'height' && ! in_array($key, $grouped, true)));
if ($rest !== []) {
$display[] = Section::make($grouped === [] && $layout === [] ? 'Einstellungen' : 'Weitere Einstellungen')->compact()->schema([
Grid::make(['default' => 1, 'md' => 2])->schema(array_map($field, $rest))->statePath('settings'),
]);
} }
$variantField = count($type->variants()) > 1 ? [] : [Hidden::make('variant')->default($type->defaultVariant())]; $variantField = count($type->variants()) > 1 ? [] : [Hidden::make('variant')->default($type->defaultVariant())];
+47
View File
@@ -1,3 +1,42 @@
# Kanonische Adresse: https://lara-und-felix.de. Der Synology-Reverse-Proxy beendet HTTPS und spricht intern HTTP mit
# diesem Container. Das öffentliche Protokoll steht deshalb in X-Forwarded-Proto, der öffentliche Host in
# X-Forwarded-Host (falls die Synology ihn setzt) oder sonst im Host-Header.
#
# Weitergeleitet werden nur normale Seitenaufrufe (GET und HEAD):
# - www.lara-und-felix.de und www.laraundfelix.de (HTTP und HTTPS, Protokoll egal) -> https://lara-und-felix.de
# - http://lara-und-felix.de, aber nur wenn X-Forwarded-Proto ausdrücklich "http" lautet. Fehlt der Header
# (direkter Zugriff, Health-Check auf 127.0.0.1), wird nie weitergeleitet. Das verhindert Schleifen, falls ein
# HTTPS-Aufruf ohne den Header ankommt.
# Ebenfalls nur bei ausdrücklichem X-Forwarded-Proto "http", auf genau diesen drei Hostnamen (lara-und-felix.de,
# www.lara-und-felix.de, www.laraundfelix.de): alle anderen Methoden (POST, PUT, DELETE, ...) enden hier mit 403 und
# erreichen Laravel nicht. Ein 301 wäre für sie falsch (der Client schickte den Inhalt erneut oder als GET), und über
# unverschlüsseltes HTTP sollen keine Eingaben oder Zugangsdaten ankommen. Über HTTPS (zum Beispiel der Stripe-Webhook)
# und ohne X-Forwarded-Proto (direkter Zugriff, Health-Check) ändert sich nichts.
# Nie angefasst werden: die ACME-Prüfung unter /.well-known/acme-challenge/ (jede Methode), dev.laraundfelix.de und
# alles, was nicht in der Liste steht.
# Das Ziel ist fest; Pfad und Query-String bleiben über $request_uri erhalten.
map $http_x_forwarded_host $luf_forwarded_host {
default "";
"~*^\s*(?<luf_fh>[^,\s:]+)" $luf_fh;
}
map $luf_forwarded_host $luf_public_host {
"" $host;
default $luf_forwarded_host;
}
# Schlüssel: Methode|X-Forwarded-Proto|öffentlicher Host|Pfad. Die Einträge werden der Reihe nach geprüft, der erste
# Treffer gilt: die ACME-Ausnahme steht vor den Weiterleitungen (1), diese vor der Sperre für andere Methoden (2).
# Die Sperre braucht deshalb keine Methodenliste: GET und HEAD sind in den Zeilen davor bereits entschieden.
map "$request_method|$http_x_forwarded_proto|$luf_public_host|$uri" $luf_canonical_redirect {
default 0;
"~*^[^|]*\|[^|]*\|[^|]*\|/\.well-known/acme-challenge/" 0;
"~*^(GET|HEAD)\|[^|]*\|www\.lara-und-felix\.de\.?\|" 1;
"~*^(GET|HEAD)\|[^|]*\|www\.laraundfelix\.de\.?\|" 1;
"~*^(GET|HEAD)\|\s*http\s*(,[^|]*)?\|lara-und-felix\.de\.?\|" 1;
"~*^[^|]*\|\s*http\s*(,[^|]*)?\|(www\.lara-und-felix|www\.laraundfelix|lara-und-felix)\.de\.?\|" 2;
}
server { server {
listen 80; listen 80;
server_name _; server_name _;
@@ -9,6 +48,14 @@ server {
# alte Adresse und antwortet mit 502 – etwa bei einem erneuten Deploy-Lauf nach einer Änderung der Env-Datei. # alte Adresse und antwortet mit 502 – etwa bei einem erneuten Deploy-Lauf nach einer Änderung der Env-Datei.
resolver 127.0.0.11 valid=10s ipv6=off; resolver 127.0.0.11 valid=10s ipv6=off;
# Läuft vor der Auswahl der location (Rewrite-Phase des Servers), daher steckt die ACME-Ausnahme in der map oben.
if ($luf_canonical_redirect = 1) {
return 301 https://lara-und-felix.de$request_uri;
}
if ($luf_canonical_redirect = 2) {
return 403;
}
client_max_body_size 2048m; client_max_body_size 2048m;
client_body_timeout 3600s; client_body_timeout 3600s;
send_timeout 3600s; send_timeout 3600s;
+3 -3
View File
@@ -110,7 +110,7 @@ ## 4. Registrierte Widget-Arten
## 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()`, 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()`. 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()` (Bezeichnung und Erklärung für das (i))/`settingGroups()`/`settingHiddenWhen()`/`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`).
@@ -154,7 +154,7 @@ ## 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 oben**, **Abstand unten**, **Widget-Abstand** (je Kein Abstand / Kompakt / Normal / Großzügig, siehe §11), 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 oben**, **Abstand unten**, **Widget-Abstand** (je Kein Abstand / Kompakt / Normal / Großzügig, siehe §11), 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-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. - **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. Der Reiter „Darstellung“ ist gegliedert: **Aufbau** (Anordnung und Höhe), danach die Gruppen der Art aus `settingGroups()` (bei den Karten „Bild und Video“, „Texte auf der Karte“, „Seitenstruktur“; bei Hero und Bild-Text-Widget „Aussehen“ und „Seitenstruktur“). Einstellungen ohne Gruppe erscheinen unter „Weitere Einstellungen“. Die Erklärung zu jeder Einstellung steht im kleinen (i) neben der Bezeichnung (`settingLabels()`, zweiter Eintrag; Tooltip beim Überfahren). `settingHiddenWhen()` blendet abhängige Schalter aus, ohne ihre Werte zu verlieren: Bei „Texte auf der Karte: Ausblenden“ verschwinden Quelle der Beschreibung, Beschreibung, Art-Label, Zusatzangaben und Schaltfläche.
- **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. - **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“. - **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.
@@ -316,7 +316,7 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**Video im Einstieg (Hero, Variante `photo_split`).** Optional `refs.video`: ein Film aus dem Medienmanager (Auswahl über `HeroVideo`, geprüft: Film, nicht archiviert, nicht gesperrt, keine Traineranleitung). Gespielt wird der freigegebene Clip nach der Regel der Karte (`CardClip`: Trailer, Vorschauclip, sonst die freigegebene Website-Datei des Films). Das Video liegt stumm auf der Fläche des Fotos, startet nach dem Laden von selbst (nicht bei „reduzierte Bewegung“, Datensparmodus, 2G), hat eine Schaltfläche zum Anhalten und fällt bei Fehlern auf das Foto zurück; `resources/js/hero-video.js`. Die Markenfläche zeigt kein Video. Entscheidung: ADR-43 (Nachtrag). **Video im Einstieg (Hero, Variante `photo_split`).** Optional `refs.video`: ein Film aus dem Medienmanager (Auswahl über `HeroVideo`, geprüft: Film, nicht archiviert, nicht gesperrt, keine Traineranleitung). Gespielt wird der freigegebene Clip nach der Regel der Karte (`CardClip`: Trailer, Vorschauclip, sonst die freigegebene Website-Datei des Films). Das Video liegt stumm auf der Fläche des Fotos, startet nach dem Laden von selbst (nicht bei „reduzierte Bewegung“, Datensparmodus, 2G), hat eine Schaltfläche zum Anhalten und fällt bei Fehlern auf das Foto zurück; `resources/js/hero-video.js`. Die Markenfläche zeigt kein Video. Entscheidung: ADR-43 (Nachtrag).
**Karte ohne Texte (Medien-, Programm- und Modulkarte).** Einstellung `settings.show_body` (`yes` Vorgabe, `no`; Darstellung → „Texte neben dem Bild“). Bei `no` zeigt die Karte nur Bild oder Video: ohne Titel, Text, Art, Zusatzangaben, Aktion und Marke im Bild, immer Bild über dem (leeren) Textbereich. Der Titel bleibt als `visually-hidden`-Überschrift für Hilfstechnik, ein Trailer läuft weiter, die Redaktionsvorschau zeigt ihre Hinweise weiter. Die Themenkarte hat die Einstellung nicht (sie bliebe leer). **Karte ohne Texte (Medien-, Programm- und Modulkarte).** Einstellung `settings.show_body` (`yes` Vorgabe, `no`; Darstellung → „Texte auf der Karte“). Bei `no` zeigt die Karte nur Bild oder Video: ohne Titel, Text, Art, Zusatzangaben, Aktion und Marke im Bild, immer Bild über dem (leeren) Textbereich. Der Titel bleibt als `visually-hidden`-Überschrift für Hilfstechnik, ein Trailer läuft weiter, die Redaktionsvorschau zeigt ihre Hinweise weiter. Die Themenkarte hat die Einstellung nicht (sie bliebe leer).
**Trailer auf der Karte (Medien-, Programm- und Modulkarte).** Einstellung `settings.clip` (`yes` Vorgabe, `no`). Der Clip ist der Trailer des Objekts (Präsentationsrolle „Trailer“, sonst „Vorschauclip“, bei einem Film ersatzweise sein freigegebener Teaser), nur wenn er für die Website freigegeben ist (`CardClip`). Er liegt über dem Kartenbild: Beim Überfahren mit der Maus läuft eine stumme Vorschau in Schleife; ein Klick oder Tipp (Handy) auf das Bild oder die kleine Schaltfläche (auch per Tastatur) spielt ihn mit Ton ab; `resources/js/card-clip.js`. Ohne Freigabe bleibt das Bild; die Redaktionsvorschau nennt den Grund. Entscheidung: ADR-43. **Trailer auf der Karte (Medien-, Programm- und Modulkarte).** Einstellung `settings.clip` (`yes` Vorgabe, `no`). Der Clip ist der Trailer des Objekts (Präsentationsrolle „Trailer“, sonst „Vorschauclip“, bei einem Film ersatzweise sein freigegebener Teaser), nur wenn er für die Website freigegeben ist (`CardClip`). Er liegt über dem Kartenbild: Beim Überfahren mit der Maus läuft eine stumme Vorschau in Schleife; ein Klick oder Tipp (Handy) auf das Bild oder die kleine Schaltfläche (auch per Tastatur) spielt ihn mit Ton ab; `resources/js/card-clip.js`. Ohne Freigabe bleibt das Bild; die Redaktionsvorschau nennt den Grund. Entscheidung: ADR-43.
+23
View File
@@ -99,6 +99,29 @@ ## Medien-Ablage auf dem NAS
- Die CI-Tests mounten keine Medien (`Storage::fake()`). - Die CI-Tests mounten keine Medien (`Storage::fake()`).
- Datensicherung: Originale sind laut `11_Betrieb_Sicherheit_Datenschutz.md` kritisch (NAS und außer Haus). Snapshots und Replikation für `luf_media` sind Sache des NAS und noch nicht eingerichtet. - Datensicherung: Originale sind laut `11_Betrieb_Sicherheit_Datenschutz.md` kritisch (NAS und außer Haus). Snapshots und Replikation für `luf_media` sind Sache des NAS und noch nicht eingerichtet.
## Kanonische Adresse und Weiterleitungen (Nginx im Shop-Container)
Die Shop-Adresse ist `https://lara-und-felix.de`. Der Nginx des Containers (`docker/nginx/default.conf`) leitet normale Seitenaufrufe (`GET`, `HEAD`) mit `301` auf diese feste Adresse um, Pfad und Query-String bleiben erhalten. Die Entscheidung trifft eine `map` über Methode, `X-Forwarded-Proto`, öffentlichen Host und Pfad.
| Aufruf (Methode `GET`/`HEAD`) | Verhalten |
|---|---|
| `http://lara-und-felix.de` (nur bei `X-Forwarded-Proto: http`) | `301` auf `https://lara-und-felix.de` |
| `http://` und `https://www.lara-und-felix.de` | `301` direkt auf `https://lara-und-felix.de` |
| `http://` und `https://www.laraundfelix.de` | `301` direkt auf `https://lara-und-felix.de` |
| `https://lara-und-felix.de` | Shop |
| `dev.laraundfelix.de` | Testinstanz, unverändert |
| `laraundfelix.de` ohne `www` | nicht betroffen, die STRATO-Weiterleitung übernimmt |
| Jede andere Methode (`POST`, `PUT`, `DELETE` …) auf den drei Shop-Hosts, nur bei `X-Forwarded-Proto: http` | `403` im Nginx, die Anfrage erreicht Laravel nicht |
- **Öffentlicher Host:** erster Wert von `X-Forwarded-Host`, sonst der `Host`-Header (ohne Port, Groß-/Kleinschreibung egal). Eine Adresse ohne Proxy (`127.0.0.1:3010`, `192.168.2.144:3011`) trifft keine Regel.
- **Öffentliches Protokoll:** nur `X-Forwarded-Proto`, nie das lokale Schema. Fehlt der Header, wird `lara-und-felix.de` **nicht** weitergeleitet. Dadurch gibt es keine Schleife, falls ein HTTPS-Aufruf ohne den Header ankäme, und der Health-Check des Deploys (`http://127.0.0.1:$WEB_PORT/up`) bleibt unberührt. Die `www`-Adressen werden unabhängig vom Protokoll weitergeleitet.
- **Andere Methoden:** Auf `lara-und-felix.de`, `www.lara-und-felix.de` und `www.laraundfelix.de` endet jede Methode außer `GET`/`HEAD` mit `403` im Nginx, **wenn** der Proxy ausdrücklich `X-Forwarded-Proto: http` setzt (erster Wert der Liste). Ein `301` wäre für sie falsch, und über unverschlüsseltes HTTP sollen keine Eingaben ankommen. Unverändert an die Anwendung gehen: alle Methoden über HTTPS (der Stripe-Webhook `/stripe/webhook` ist ein `POST` und muss als `https://` in Stripe eingetragen sein), alle Methoden ohne `X-Forwarded-Proto` (direkter Zugriff, Health-Check) und `dev.laraundfelix.de`. Im Repository ist keine Webhook-Adresse hinterlegt; welche Adresse im Stripe-Dashboard steht, ist [?] nicht geprüft. **Vor dem Aktivieren der HTTP-Regeln prüfen:** Steht dort `http://…`, würde der Webhook mit `403` abgewiesen und muss auf `https://` umgestellt werden.
- **ACME:** `/.well-known/acme-challenge/` wird nie umgeleitet oder gesperrt, für jede Methode (Ausnahme zuerst in der `map`), auch nicht auf den `www`-Hosts. Der Shop beantwortet diesen Pfad selbst nicht (Laravel liefert 404); das Zertifikat holt die Synology, sie muss die Prüfung also selbst beantworten und darf sie nicht an den Shop weiterreichen. [?] Beim ersten Erneuern beobachten.
- **Signierte URLs:** `App\Http\SignedLink` signiert nur den Pfad (relative Signatur), der Host fließt nicht ein. Ein Wechsel zwischen den Alias-Hosts macht Links also nicht ungültig. Im Repository kommt kein Alias-Host vor; Stripe-Rücksprungadressen entstehen aus `route()` und damit aus `APP_URL` bzw. dem Anfrage-Host.
- **Synology:** Setzt der Reverse-Proxy `X-Forwarded-Proto` nicht von selbst, dann einen eigenen Kopfzeilen-Eintrag `X-Forwarded-Proto` mit dem Wert `$scheme` anlegen. Für die Testinstanz ist belegt, dass Protokoll und Host der Synology in der Anwendung ankommen (Stand 2026-11-22: `https://dev.laraundfelix.de/verwaltung` leitet auf `https://dev.laraundfelix.de/verwaltung/login`). Für die Prod-Regeln ist das [?] nicht geprüft.
- **Prüfung:** Die Fälle der Tabelle, `HEAD`, Pfad mit Query, Großschreibung, Port im Host, `X-Forwarded-Host`, `POST`/`PUT`, direkter Zugriff und ACME wurden 2026-11-22 mit Windows-nginx 1.27.5 (nicht das Alpine-Image) und `php-cgi` als Upstream durchgespielt (30 Fälle). Reihenfolge und Zusagen der Konfiguration sichert `tests/Unit/NginxConfigTest.php`.
- **Nach dem Deploy auf Test** (Lars oder Claude, nur gegen `192.168.2.144:3011`, nie gegen Prod): `curl -sI -H 'Host: www.laraundfelix.de' -H 'X-Forwarded-Proto: https' 'http://192.168.2.144:3011/a?b=1'` muss `301` mit `Location: https://lara-und-felix.de/a?b=1` liefern.
## Einmalig auf llm-node vorzubereiten (nicht automatisiert, braucht `sudo`) ## Einmalig auf llm-node vorzubereiten (nicht automatisiert, braucht `sudo`)
1. `sudo mkdir -p /etc/luf && sudo chown llmadmin:llmadmin /etc/luf && sudo chmod 750 /etc/luf` 1. `sudo mkdir -p /etc/luf && sudo chown llmadmin:llmadmin /etc/luf && sudo chmod 750 /etc/luf`
@@ -12,7 +12,8 @@ ## 1. Inhalt (Stand 21.11.2026 abends: 22 Commits seit `main`)
| Programm- und Modulkarte | Text der Karte wählen (zusätzlich Lernziel); Vorschaubild als Website-Bild übernehmen | Claude | | Programm- und Modulkarte | Text der Karte wählen (zusätzlich Lernziel); Vorschaubild als Website-Bild übernehmen | Claude |
| Trailer auf Karten | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer (Rolle Trailer, sonst Vorschauclip, bei Filmen ersatzweise der eigene Teaser) beim Überfahren mit der Maus als stumme Vorschau und per Klick oder Tipp mit Ton ab (kleine Symbolschaltfläche); je Karte abschaltbar; die Medienroute beantwortet Bereichsabrufe (ADR-43). Auf luf-test mit einem echten Clip geprüft. Keine Migration | Claude | | Trailer auf Karten | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer (Rolle Trailer, sonst Vorschauclip, bei Filmen ersatzweise der eigene Teaser) beim Überfahren mit der Maus als stumme Vorschau und per Klick oder Tipp mit Ton ab (kleine Symbolschaltfläche); je Karte abschaltbar; die Medienroute beantwortet Bereichsabrufe (ADR-43). Auf luf-test mit einem echten Clip geprüft. Keine Migration | Claude |
| Medienkarte: Film nur mit Website-Datei | Ein Medium ohne Fassung (z. B. Teaser) ist auf der Medienkarte wählbar und erscheint öffentlich, sobald die Datei für die Website freigegeben ist (ohne Programmseite, ohne Aktion). Keine Migration | Claude | | Medienkarte: Film nur mit Website-Datei | Ein Medium ohne Fassung (z. B. Teaser) ist auf der Medienkarte wählbar und erscheint öffentlich, sobald die Datei für die Website freigegeben ist (ohne Programmseite, ohne Aktion). Keine Migration | Claude |
| Karte ohne Texte | Medien- und Programmkarte: Einstellung „Texte neben dem Bild“ (Ausblenden) zeigt nur Bild oder Video; der Titel bleibt für Hilfstechnik. Keine Migration | Claude | | Karte ohne Texte | Medien- und Programmkarte: Einstellung „Texte auf der Karte“ (Ausblenden) zeigt nur Bild oder Video; der Titel bleibt für Hilfstechnik. Keine Migration | Claude |
| Reiter „Darstellung“ gegliedert | Aufbau, Gruppen je Widget, Erklärungen im (i), Einzelschalter für Texte verschwinden bei „Texte auf der Karte: Ausblenden“; Bezeichnungen vereinheitlicht. Keine Migration, gespeicherte Werte unverändert | Claude |
| Hero mit Video | Der Einstieg (Variante Foto mit Textfläche) spielt auf Wunsch ein freigegebenes Video stumm auf der Fläche des Fotos ab, mit Schaltfläche zum Anhalten; Foto als Rückfall (ADR-43 Nachtrag). Keine Migration | Claude | | Hero mit Video | Der Einstieg (Variante Foto mit Textfläche) spielt auf Wunsch ein freigegebenes Video stumm auf der Fläche des Fotos ab, mit Schaltfläche zum Anhalten; Foto als Rückfall (ADR-43 Nachtrag). Keine Migration | Claude |
| Website-Datei eines Films | Ablage der Datei eines eigenständigen Präsentationsmediums über die Warteschlange, nachträgliches Hochladen am Medium (Behebung: der Web-Prozess darf `derived/` nicht schreiben) | Lars (anderer Rechner) | | Website-Datei eines Films | Ablage der Datei eines eigenständigen Präsentationsmediums über die Warteschlange, nachträgliches Hochladen am Medium (Behebung: der Web-Prozess darf `derived/` nicht schreiben) | Lars (anderer Rechner) |
| Medienmanager | „Medium löschen“ erreicht Standbilder und übernommene CMS-Bilder (Fremdschlüssel gelockert) | Claude | | Medienmanager | „Medium löschen“ erreicht Standbilder und übernommene CMS-Bilder (Fremdschlüssel gelockert) | Claude |
+11
View File
@@ -0,0 +1,11 @@
# Abnahme: Reiter „Darstellung“ gegliedert (luf-test, 2026-11-22)
Geprüft in der echten Anwendung (Medien- und Materialkarte, 1440 px, Playwright gegen luf-test, nichts gespeichert):
- Gruppen **Aufbau**, **Bild und Video**, **Texte auf der Karte**, **Seitenstruktur**; Erklärungen als kleines (i) neben der Bezeichnung, der Text erscheint beim Überfahren.
- „Texte auf der Karte: Ausblenden“ blendet Quelle der Beschreibung, Beschreibung, Art-Label, Zusatzangaben und Schaltfläche aus; „Anzeigen“ bringt sie mit den früheren Werten zurück.
- Offen: Der Hinweis erscheint beim Überfahren; für Tastatur und Touch ist das (i) nicht gesondert geprüft.
| | |
|---|---|
| ![Gruppiert, Hinweis beim Überfahren](darstellung/01-gruppiert-mit-hinweis.png) | ![Texte ausgeblendet](darstellung/02-texte-ausgeblendet.png) |
Binary file not shown.

After

Width:  |  Height:  |  Size: 253 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 238 KiB

+136 -1
View File
@@ -7,16 +7,151 @@
/** /**
* Der Web-Container (nginx) muss den App-Container zur Laufzeit über Dockers DNS finden. Mit einer festen Adresse * Der Web-Container (nginx) muss den App-Container zur Laufzeit über Dockers DNS finden. Mit einer festen Adresse
* beim Start antwortete Prod nach einem erneuten Deploy-Lauf mit 502 (App neu erzeugt, nginx nicht). * beim Start antwortete Prod nach einem erneuten Deploy-Lauf mit 502 (App neu erzeugt, nginx nicht).
*
* Außerdem leitet er die Alias-Adressen auf https://lara-und-felix.de weiter. Das Verhalten wurde mit nginx selbst
* geprüft (Ergebnis in docs/betrieb/DEPLOYMENT.md). Diese Tests sichern die Zusagen der Konfiguration gegen
* versehentliche Änderungen, denn im CI-Container läuft kein nginx.
*/ */
class NginxConfigTest extends TestCase class NginxConfigTest extends TestCase
{ {
private function config(): string
{
return (string) file_get_contents(dirname(__DIR__, 2).'/docker/nginx/default.conf');
}
/**
* Zeilen der Weiterleitungs-map in der Reihenfolge der Datei (nginx wertet sie in dieser Reihenfolge aus).
*
* @return list<string>
*/
private function redirectMap(): array
{
$found = preg_match('/^map\s+"[^"]*"\s+\$luf_canonical_redirect\s*\{(.*?)^\}/ms', $this->config(), $match);
$this->assertSame(1, $found, 'Die map $luf_canonical_redirect fehlt.');
return array_values(array_filter(array_map('trim', explode("\n", $match[1]))));
}
/**
* @return list<string> Zeilen der map, die weiterleiten (Wert 1)
*/
private function redirectRules(): array
{
return array_values(array_filter($this->redirectMap(), fn (string $line) => str_ends_with($line, '" 1;')));
}
public function test_nginx_resolves_the_app_container_at_request_time(): void public function test_nginx_resolves_the_app_container_at_request_time(): void
{ {
$config = (string) file_get_contents(dirname(__DIR__, 2).'/docker/nginx/default.conf'); $config = $this->config();
$this->assertMatchesRegularExpression('/^\s*resolver\s+127\.0\.0\.11\b[^;]*valid=\d+s[^;]*;/m', $config); $this->assertMatchesRegularExpression('/^\s*resolver\s+127\.0\.0\.11\b[^;]*valid=\d+s[^;]*;/m', $config);
$this->assertMatchesRegularExpression('/^\s*set\s+\$php_upstream\s+app:9000;/m', $config); $this->assertMatchesRegularExpression('/^\s*set\s+\$php_upstream\s+app:9000;/m', $config);
$this->assertMatchesRegularExpression('/^\s*fastcgi_pass\s+\$php_upstream;/m', $config); $this->assertMatchesRegularExpression('/^\s*fastcgi_pass\s+\$php_upstream;/m', $config);
$this->assertDoesNotMatchRegularExpression('/^\s*fastcgi_pass\s+app:9000;/m', $config); $this->assertDoesNotMatchRegularExpression('/^\s*fastcgi_pass\s+app:9000;/m', $config);
} }
public function test_nginx_keeps_the_fastcgi_and_timeout_settings(): void
{
$config = $this->config();
$this->assertMatchesRegularExpression('/^\s*fastcgi_read_timeout\s+3600s;/m', $config);
$this->assertMatchesRegularExpression('/^\s*fastcgi_send_timeout\s+3600s;/m', $config);
$this->assertMatchesRegularExpression('/^\s*client_max_body_size\s+2048m;/m', $config);
$this->assertMatchesRegularExpression('/^\s*fastcgi_param\s+HTTP_X_FORWARDED_PROTO\s+\$forwarded_proto;/m', $config);
$this->assertStringContainsString('try_files $uri $uri/ /index.php?$query_string;', $config);
$this->assertStringContainsString('location ~ /\.(?!well-known) {', $config);
}
public function test_alias_hosts_are_redirected_to_the_fixed_canonical_domain(): void
{
$config = $this->config();
$this->assertStringContainsString('if ($luf_canonical_redirect = 1) {', $config);
$this->assertStringContainsString('return 301 https://lara-und-felix.de$request_uri;', $config, 'Fest verdrahtetes Ziel, Pfad und Query-String aus $request_uri.');
$this->assertSame(1, preg_match_all('/^\s*return\s+30\d\s/m', $config), 'Es gibt genau eine Weiterleitung.');
$this->assertSame(2, preg_match_all('/^\s*return\s+\d{3}\b/m', $config), 'Nur Weiterleitung und Sperre antworten selbst.');
$this->assertDoesNotMatchRegularExpression('/return\s+30\d\s+[^;]*\$(host|http_host|http_x_forwarded_host|scheme)/', $config, 'Das Ziel darf nicht aus Anfragewerten entstehen.');
}
public function test_redirect_rules_cover_both_www_aliases_and_the_http_apex_only(): void
{
$rules = implode("\n", $this->redirectRules());
$this->assertCount(3, $this->redirectRules());
$this->assertStringContainsString('www\.lara-und-felix\.de', $rules);
$this->assertStringContainsString('www\.laraundfelix\.de', $rules);
$this->assertStringContainsString('\|\s*http\s*(,[^|]*)?\|lara-und-felix\.de', $rules, 'Der Apex wird nur bei ausdrücklichem X-Forwarded-Proto http weitergeleitet.');
$this->assertStringNotContainsString('dev.', $rules, 'dev.laraundfelix.de bleibt unverändert.');
$this->assertStringNotContainsString('|laraundfelix', $rules, 'laraundfelix.de ohne www übernimmt die STRATO-Weiterleitung.');
$this->assertStringContainsString('default 0;', implode("\n", $this->redirectMap()));
}
public function test_only_get_and_head_are_redirected(): void
{
foreach ($this->redirectRules() as $rule) {
$this->assertStringContainsString('"~*^(GET|HEAD)\|', $rule, 'POST (zum Beispiel der Stripe-Webhook) darf kein 301 bekommen: '.$rule);
}
}
/**
* @return list<string> Zeilen der map, die andere Methoden sperren (Wert 2)
*/
private function blockRules(): array
{
return array_values(array_filter($this->redirectMap(), fn (string $line) => str_ends_with($line, '" 2;')));
}
public function test_other_methods_on_the_three_shop_hosts_end_at_nginx_when_proxy_says_http(): void
{
$config = $this->config();
$rules = $this->blockRules();
$this->assertCount(1, $rules);
$rule = $rules[0];
$this->assertStringStartsWith('"~*^[^|]*\|', $rule, 'Jede Methode, die nicht vorher als GET/HEAD entschieden wurde.');
$this->assertStringContainsString('\|\s*http\s*(,[^|]*)?\|', $rule, 'Nur bei ausdrücklichem X-Forwarded-Proto http (erster Wert).');
foreach (['www\.lara-und-felix', 'www\.laraundfelix', '(www\.lara-und-felix|www\.laraundfelix|lara-und-felix)\.de'] as $host) {
$this->assertStringContainsString($host, $rule);
}
$this->assertStringNotContainsString('dev', $rule, 'dev.laraundfelix.de bleibt unverändert.');
$this->assertStringNotContainsString('https', $rule);
$this->assertMatchesRegularExpression('/^\s*if\s*\(\$luf_canonical_redirect = 2\)\s*\{\s*return\s+403;\s*\}/m', $config, 'Die Sperre antwortet in nginx, bevor die Anfrage Laravel erreicht.');
$this->assertDoesNotMatchRegularExpression('/\$luf_canonical_redirect = 2\)\s*\{[^}]*(fastcgi_pass|proxy_pass)/', $config);
}
public function test_block_rule_comes_after_acme_exception_and_the_redirects(): void
{
// nginx nimmt den ersten passenden Regex-Eintrag: Ausnahme, dann GET/HEAD-Weiterleitungen, zuletzt die Sperre.
$values = array_map(fn (string $line) => rtrim(substr($line, (int) strrpos($line, ' ') + 1), ';'), $this->redirectMap());
$this->assertSame(['0', '0', '1', '1', '1', '2'], $values, 'Reihenfolge: default, ACME, drei Weiterleitungen, Sperre.');
}
public function test_acme_challenge_is_excluded_before_any_redirect_rule(): void
{
$acme = null;
$firstRedirect = null;
foreach ($this->redirectMap() as $index => $line) {
if ($acme === null && str_contains($line, '/\.well-known/acme-challenge/') && str_ends_with($line, '" 0;')) {
$acme = $index;
}
if ($firstRedirect === null && (str_ends_with($line, '" 1;') || str_ends_with($line, '" 2;'))) {
$firstRedirect = $index;
}
}
$this->assertNotNull($acme, 'Die ACME-Ausnahme fehlt.');
$this->assertNotNull($firstRedirect);
$this->assertLessThan($firstRedirect, $acme, 'nginx wertet map-Einträge der Reihe nach aus: die Ausnahme muss vorn stehen.');
}
public function test_redirect_decision_uses_forwarded_headers_and_never_the_local_scheme(): void
{
$config = $this->config();
$this->assertStringContainsString('map "$request_method|$http_x_forwarded_proto|$luf_public_host|$uri" $luf_canonical_redirect {', $config);
$this->assertStringContainsString('map $http_x_forwarded_host $luf_forwarded_host {', $config);
$this->assertMatchesRegularExpression('/^\s*""\s+\$host;/m', $config, 'Ohne X-Forwarded-Host gilt der Host-Header.');
$this->assertStringNotContainsString('$scheme|', $config, 'Ohne X-Forwarded-Proto darf nie weitergeleitet werden (direkter Zugriff, Health-Check).');
}
} }
+49
View File
@@ -70,6 +70,55 @@ public function test_registration_rejects_keys_that_are_not_stable_identifiers()
} }
/** Gemeinsamer Layoutvertrag (ADR-38) für jede registrierte Art. */ /** Gemeinsamer Layoutvertrag (ADR-38) für jede registrierte Art. */
public function test_settings_are_grouped_explained_and_consistent_for_every_widget(): void
{
foreach ($this->registry()->all() as $key => $type) {
$options = $type->settingOptions();
$labels = $type->settingLabels();
$grouped = [];
foreach ($type->settingGroups() as $title => $keys) {
$this->assertNotSame('', $title, $key);
foreach ($keys as $setting) {
// Gemeinsame Gruppen dürfen Einstellungen nennen, die eine Art nicht anbietet (zum Beispiel Trailer
// oder Art-Label); der Editor übergeht sie.
$this->assertNotContains($setting, $grouped, "$key: $setting steht in zwei Gruppen");
$grouped[] = $setting;
}
}
// Jede Einstellung außer der Höhe (hat eigenen Hinweis) ist gruppiert, benannt und erklärt.
foreach (array_keys($options) as $setting) {
if ($setting === 'height') {
continue;
}
$this->assertContains($setting, $grouped, "$key: $setting gehört in eine Gruppe");
$this->assertNotEmpty($labels[$setting][0] ?? null, "$key: $setting braucht eine Bezeichnung");
$this->assertNotEmpty($labels[$setting][1] ?? null, "$key: $setting braucht eine Erklärung für das (i)");
}
foreach ($type->settingHiddenWhen() as $setting => [$controller, $value]) {
// Gemeinsame Regeln dürfen Einstellungen nennen, die eine Art nicht anbietet; wirksam sind sie nur,
// wenn beide da sind, und der Wert muss dann zur steuernden Einstellung passen.
if (isset($options[$setting], $options[$controller])) {
$this->assertArrayHasKey($value, $options[$controller], "$key: $controller kennt den Wert $value nicht");
}
}
$this->assertNotNull(WidgetEditor::block($type), $key);
}
}
public function test_text_switches_are_hidden_when_all_texts_are_switched_off(): void
{
$hidden = $this->registry()->get('media_card')->settingHiddenWhen();
foreach (['text_source', 'show_summary', 'show_kind', 'show_meta', 'show_action'] as $setting) {
$this->assertSame(['show_body', 'no'], $hidden[$setting]);
}
$this->assertArrayNotHasKey('heading_level', $hidden);
}
public function test_every_widget_declares_the_shared_layout_contract(): void 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) {