Führe eine konfigurierbare Größenskala für Website und Vorschau ein

Zehn Basiswerte (Fließtext, Überschriften, Abstände, Kopfzeile, Inhaltsbreite, Bildhöhe) leiten in tokens.css alle Größen ab. Einstieg, Bild und Text, Premium-Karten, Karten, Kopf, Fuß und Schaltflächen verwenden nur noch diese Tokens. Die Werte sind unter Website, Design, Größen einstellbar und wirken ohne Deployment über ein Inline-Stylesheet in Website, Mitgliederbereich-Layout und CMS-Vorschau. Lesen fällt bei fehlender Tabelle oder beschädigten Daten auf die Standardwerte zurück. Die Migration ist rein ergänzend.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
StommerandClaude Sonnet 5.5 committed 2026-11-22 14:54:14 +01:00
1 parent e0a3fdbb70
commit 67614158e4
23 files changed
+1110 -111

No files matched your search

+3 -3
View File
@@ -70,9 +70,9 @@ public function narrowBehavior(): string
public function heights(): array
{
return [
'compact' => 'Kompakt (mind. 400 px)',
'normal' => 'Normal (mind. 512 px)',
'large' => 'Groß (mind. 640 px)',
'compact' => 'Kompakt (niedriger, 75 % der Standardhöhe)',
'normal' => 'Standard',
'large' => 'Großzügig (höher, 130 % der Standardhöhe)',
];
}
@@ -73,7 +73,7 @@ public function heights(): array
{
return [
'compact' => 'Kompakt (flacheres Bild, engere Abstände)',
'normal' => 'Normal',
'normal' => 'Standard',
'spacious' => 'Großzügig (höheres Bild, mehr Abstand)',
];
}
+1 -1
View File
@@ -41,7 +41,7 @@ public function version(): int
public const HEIGHTS = [
'auto' => 'Automatisch',
'compact' => 'Kompakt',
'normal' => 'Normal',
'normal' => 'Standard',
'large' => 'Groß',
'spacious' => 'Großzügig',
'fill' => 'Abschnittshöhe füllen',
+164
View File
@@ -0,0 +1,164 @@
<?php
namespace App\Domain\Design;
use Illuminate\Support\Facades\Validator;
/**
* Basiswerte der Größenskala des gemeinsamen Designsystems (ADR-44). Es sind bewusst nur zehn Werte; alles Weitere
* (Überschrift 3, Einleitung, kleine Schrift, Abschnitts- und Widget-Abstände, Kopfzeile kompakt, Mindesthöhen der
* Varianten …) leitet resources/css/tokens.css daraus ab. Die Ableitungsregeln stehen nur dort.
*
* Die Werte sind Pixel als ganze Zahl. Im Stylesheet werden sie in rem umgerechnet, damit die Textgröße des Browsers
* wirkt. Die Standardwerte stehen ebenfalls in tokens.css (Block „Basiswerte“); ein Test hält beide gleich.
* Trefferflächen (44 px) und die Untergrenze der Schrift auf Smartphones (16 px) sind nicht einstellbar.
*/
final class DesignScale
{
/**
* @var array<string, array{label: string, default: int, min: int, max: int, unit: string, group: string, hint: string, effect: string}>
*/
public const PARAMETERS = [
'body' => ['label' => 'Fließtext', 'default' => 17, 'min' => 16, 'max' => 20, 'unit' => 'px', 'group' => 'Schrift',
'hint' => 'Schriftgröße auf Desktop; auf kleinen Bildschirmen etwa 1 px weniger, nie unter 16 px.',
'effect' => 'Auch Einleitung, Überschrift 3, kleine Schrift und Schaltflächen folgen daraus.'],
'h1' => ['label' => 'Überschrift 1', 'default' => 40, 'min' => 30, 'max' => 56, 'unit' => 'px', 'group' => 'Schrift',
'hint' => 'Seitentitel auf Desktop; schrumpft auf Smartphones auf etwa 70 %.',
'effect' => 'Muss mindestens 4 px größer sein als Überschrift 2.'],
'h2' => ['label' => 'Überschrift 2', 'default' => 28, 'min' => 22, 'max' => 40, 'unit' => 'px', 'group' => 'Schrift',
'hint' => 'Abschnittstitel auf Desktop; auch Titel in Bild und Text, Handlungsaufruf und breiten Karten.',
'effect' => 'Muss mindestens 6 px größer sein als der Fließtext. Überschrift 3 bleibt darunter.'],
'display' => ['label' => 'Display-Überschrift (Höchstwert)', 'default' => 52, 'min' => 36, 'max' => 80, 'unit' => 'px', 'group' => 'Schrift',
'hint' => 'Größter Titel (Einstieg). Wächst mit der Breite des Platzes bis zu diesem Wert.',
'effect' => 'Mindestens so groß wie Überschrift 1.'],
'space' => ['label' => 'Basisabstand', 'default' => 8, 'min' => 6, 'max' => 12, 'unit' => 'px', 'group' => 'Abstände',
'hint' => 'Grundmaß des Abstandsrasters (halber, einfacher, anderthalbfacher bis zwölffacher Wert).',
'effect' => 'Alle Abstandsstufen der Komponenten und die Abstände zwischen Plätzen im Raster.'],
'section' => ['label' => 'Abschnittsabstand (Desktop)', 'default' => 48, 'min' => 24, 'max' => 96, 'unit' => 'px', 'group' => 'Abstände',
'hint' => 'Stufe „Normal“ auf Desktop. „Kompakt“ ist zwei Drittel davon, „Großzügig“ das Anderthalbfache.',
'effect' => 'Auf Smartphones werden alle Stufen kleiner.'],
'card_pad' => ['label' => 'Karten-Innenabstand', 'default' => 20, 'min' => 12, 'max' => 32, 'unit' => 'px', 'group' => 'Abstände',
'hint' => 'Innenabstand von Karten auf Desktop.',
'effect' => 'Große Flächen (Einstieg, Bild und Text, Handlungsaufruf) verwenden das Ein- bis Zweifache.'],
'header' => ['label' => 'Höhe der Kopfzeile', 'default' => 80, 'min' => 56, 'max' => 112, 'unit' => 'px', 'group' => 'Rahmen',
'hint' => 'Kopfzeile im Ausgangszustand auf Desktop. Beim Scrollen und auf Smartphones gilt 80 % davon.',
'effect' => 'Die Anzeigegröße der Wortmarke folgt daraus; die Wortmarke selbst bleibt unverändert.'],
'width' => ['label' => 'Maximale Inhaltsbreite', 'default' => 1312, 'min' => 960, 'max' => 1600, 'unit' => 'px', 'group' => 'Rahmen',
'hint' => 'Breite des Standardrasters; Kopfzeile, Inhalt und Fußbereich fluchten hier. „Breit“ ist etwa 17 % mehr.',
'effect' => 'Der Lesebereich (44 rem) ist davon unabhängig.'],
'media' => ['label' => 'Bildhöhe in Bild und Text (Desktop)', 'default' => 320, 'min' => 200, 'max' => 480, 'unit' => 'px', 'group' => 'Medien',
'hint' => 'Höhe des Bildes neben dem Text in der Variante „Standard“. Kompakt: 75 %, Großzügig: 130 %.',
'effect' => 'Bestimmt zugleich die Mindesthöhe des Einstiegs (das 1,2-Fache; kompakt und großzügig wie bei Bild und Text).'],
];
/** Gruppen in fester Reihenfolge. */
public const GROUPS = ['Schrift', 'Abstände', 'Rahmen', 'Medien'];
/**
* @return array<string, int>
*/
public static function defaults(): array
{
return array_map(static fn (array $p): int => $p['default'], self::PARAMETERS);
}
/** Name der CSS-Variable, zum Beispiel card_pad → --ds-card-pad. */
public static function variable(string $key): string
{
return '--ds-'.str_replace('_', '-', $key);
}
/**
* Prüft vollständige Eingaben (Zeichenketten aus dem Formular oder Zahlen). Gibt Fehlermeldungen je Schlüssel zurück;
* leer, wenn alles zulässig ist.
*
* @param array<string, mixed> $input
* @return array<string, string>
*/
public static function errors(array $input): array
{
$rules = [];
$messages = [];
$names = [];
foreach (self::PARAMETERS as $key => $p) {
$rules[$key] = ['required', 'integer', 'min:'.$p['min'], 'max:'.$p['max']];
$names[$key] = $p['label'];
$messages["$key.required"] = $p['label'].': Bitte einen Wert eintragen.';
$messages["$key.integer"] = $p['label'].': Bitte eine ganze Zahl in Pixeln eintragen.';
$messages["$key.min"] = $p['label'].': Der Wert muss mindestens '.$p['min'].' px betragen.';
$messages["$key.max"] = $p['label'].': Der Wert darf höchstens '.$p['max'].' px betragen.';
}
$validator = Validator::make(array_intersect_key($input, self::PARAMETERS), $rules, $messages, $names);
$errors = [];
foreach ($validator->errors()->messages() as $key => $list) {
$errors[$key] = $list[0];
}
if ($errors !== []) {
return $errors;
}
$v = array_map('intval', array_intersect_key($input, self::PARAMETERS));
if ($v['h2'] < $v['body'] + 6) {
$errors['h2'] = 'Überschrift 2 muss mindestens 6 px größer sein als der Fließtext ('.($v['body'] + 6).' px).';
}
if ($v['h1'] < $v['h2'] + 4) {
$errors['h1'] = 'Überschrift 1 muss mindestens 4 px größer sein als Überschrift 2 ('.($v['h2'] + 4).' px).';
}
if ($v['display'] < $v['h1']) {
$errors['display'] = 'Die Display-Überschrift darf nicht kleiner sein als Überschrift 1 ('.$v['h1'].' px).';
}
return $errors;
}
/**
* Gespeicherte Werte lesen: nur bekannte Schlüssel, ganze Zahlen im zulässigen Bereich und stimmige Reihenfolge.
* Alles andere (fehlende Schlüssel, Fremdes, beschädigte Daten) ergibt die Standardwerte, nie einen Fehler.
*
* @return array<string, int>
*/
public static function read(mixed $stored): array
{
if (! is_array($stored)) {
return self::defaults();
}
$merged = self::defaults();
foreach (array_keys(self::PARAMETERS) as $key) {
if (array_key_exists($key, $stored) && (is_int($stored[$key]) || (is_string($stored[$key]) && ctype_digit($stored[$key])))) {
$merged[$key] = (int) $stored[$key];
}
}
return self::errors($merged) === [] ? $merged : self::defaults();
}
/**
* Inline-Stylesheet mit den abweichenden Basiswerten. Ausgegeben werden ausschließlich geprüfte ganze Zahlen zu
* bekannten Schlüsseln. Ohne Abweichung leer: dann gelten die Standardwerte aus tokens.css.
*
* @param array<string, int> $values
*/
public static function css(array $values): string
{
$declarations = '';
foreach (self::PARAMETERS as $key => $p) {
$value = $values[$key] ?? $p['default'];
if ($value !== $p['default'] && $value >= $p['min'] && $value <= $p['max']) {
$declarations .= sprintf('%s:%d;', self::variable($key), $value);
}
}
return $declarations === '' ? '' : ':root{'.$declarations.'}';
}
}
+121
View File
@@ -0,0 +1,121 @@
<?php
namespace App\Domain\Design;
use App\Models\User;
use Illuminate\Support\Carbon;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\HtmlString;
use Throwable;
/**
* Lesen und Schreiben der Größenskala (Schlüssel „design.scale“ in site_settings).
*
* Die öffentliche Ausgabe hängt nie am Erfolg dieser Klasse: Fehlt die Tabelle (Code vor Migration), ist die Datenbank
* nicht erreichbar oder sind die Daten beschädigt, gelten die Standardwerte aus tokens.css, ohne Fehlerseite.
* Änderungen wirken sofort (Zwischenspeicher wird beim Speichern geleert), ohne Deployment.
*/
final class DesignSettings
{
public const KEY = 'design.scale';
private const CACHE_KEY = 'design.scale.v1';
/** @var array<string, int>|null */
private static ?array $memo = null;
/**
* Wirksame Werte (gespeichert oder Standard).
*
* @return array<string, int>
*/
public static function values(): array
{
if (self::$memo !== null) {
return self::$memo;
}
try {
$stored = Cache::rememberForever(self::CACHE_KEY, static function (): array {
$row = SiteSetting::query()->find(self::KEY);
return $row === null ? [] : (array) $row->value;
});
return self::$memo = $stored === [] ? DesignScale::defaults() : DesignScale::read($stored);
} catch (Throwable) {
return self::$memo = DesignScale::defaults();
}
}
/** Ob abweichende Werte wirksam sind. */
public static function isCustomised(): bool
{
return self::values() !== DesignScale::defaults();
}
/**
* Speichert vollständige, geprüfte Werte.
*
* @param array<string, mixed> $input
* @return array<string, string> Fehlermeldungen je Schlüssel; leer bei Erfolg
*/
public static function save(array $input, ?User $by = null): array
{
$errors = DesignScale::errors($input);
if ($errors !== []) {
return $errors;
}
$ordered = [];
foreach (array_keys(DesignScale::PARAMETERS) as $key) {
$ordered[$key] = (int) $input[$key];
}
SiteSetting::query()->updateOrCreate(['key' => self::KEY], ['value' => $ordered, 'updated_by' => $by?->getKey()]);
self::flush();
return [];
}
/** Standardwerte wiederherstellen: die Zeile entfällt, es gelten wieder die Werte aus tokens.css. */
public static function reset(): void
{
SiteSetting::query()->whereKey(self::KEY)->delete();
self::flush();
}
/** Zeitpunkt der letzten Speicherung, falls vorhanden. */
public static function updatedAt(): ?Carbon
{
try {
return SiteSetting::query()->find(self::KEY)?->updated_at;
} catch (Throwable) {
return null;
}
}
public static function flush(): void
{
self::$memo = null;
try {
Cache::forget(self::CACHE_KEY);
} catch (Throwable) {
// Der Zwischenspeicher ist nur Beschleunigung.
}
}
/**
* Stylesheet-Block für Layouts und Vorschauen; nach dem Stylesheet der Website einzufügen, damit er gewinnt.
* Leer, solange keine abweichenden Werte gespeichert sind.
*/
public static function styleTag(): HtmlString
{
$css = DesignScale::css(self::values());
return new HtmlString($css === '' ? '' : '<style id="lf-design-scale">'.$css.'</style>');
}
}
+31
View File
@@ -0,0 +1,31 @@
<?php
namespace App\Domain\Design;
use Illuminate\Database\Eloquent\Model;
/**
* Eine Einstellung der Website (Schlüssel-Wert, Wert als JSON). Lesen und Schreiben der Größenskala
* läuft über DesignSettings.
*
* @property string $key
* @property array<string, mixed> $value
* @property int|null $updated_by
*/
class SiteSetting extends Model
{
protected $table = 'site_settings';
protected $primaryKey = 'key';
public $incrementing = false;
protected $keyType = 'string';
protected $guarded = [];
protected function casts(): array
{
return ['value' => 'array'];
}
}
+133
View File
@@ -0,0 +1,133 @@
<?php
namespace App\Filament\Pages;
use App\Domain\Design\DesignScale;
use App\Domain\Design\DesignSettings;
use App\Domain\Identity\StaffRole;
use Filament\Notifications\Notification;
use Filament\Pages\Page;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
/**
* Website → Design → Größen (ADR-44): die zehn Basiswerte der Größenskala einsehen, ändern, speichern und auf die
* Standardwerte zurücksetzen. Gespeichert wird erst mit „Größen speichern“; offene Eingaben bleiben beim Wechseln
* der Ansicht erhalten. Die Werte wirken sofort auf die öffentliche Website und alle CMS-Vorschauen, ohne Deployment.
* Zugriff nur für den Systemverwalter.
*/
class DesignGroessen extends Page
{
protected static string|\UnitEnum|null $navigationGroup = 'Design';
protected static ?string $navigationLabel = 'Größen';
protected static ?int $navigationSort = 30;
protected static ?string $slug = 'design/groessen';
protected static ?string $title = 'Größen';
protected string $view = 'filament.design.groessen';
/** Eingaben je Basiswert (Zeichenketten aus dem Formular). @var array<string, int|string> */
public array $werte = [];
/** Fehlermeldungen je Basiswert nach dem letzten Speichern. @var array<string, string> */
public array $fehler = [];
/** @var array{aktion: string, argument: int|string|null, titel: string, text: string, label: string, gefahr: bool}|null */
public ?array $bestaetigung = null;
public static function canAccess(): bool
{
return auth()->user()?->hasStaffRole(StaffRole::Systemverwalter) === true;
}
public function mount(): void
{
$this->ladeGespeicherte();
}
public function getHeading(): string|Htmlable|null
{
return 'Größen';
}
public function getMaxContentWidth(): Width|string|null
{
return Width::SevenExtraLarge;
}
/** Wirksame Werte der Website (gespeichert oder Standard). @return array<string, int> */
public function gespeichert(): array
{
return DesignSettings::values();
}
/** Ob die Eingaben vom wirksamen Stand abweichen. */
public function geaendert(): bool
{
$aktuell = [];
foreach (array_keys(DesignScale::PARAMETERS) as $key) {
$wert = $this->werte[$key] ?? '';
$aktuell[$key] = is_string($wert) && ctype_digit($wert) ? (int) $wert : $wert;
}
return $aktuell !== $this->gespeichert();
}
public function speichern(): void
{
$this->fehler = DesignSettings::save($this->werte, auth()->user());
if ($this->fehler !== []) {
Notification::make()->danger()->title('Nicht gespeichert')->body('Bitte die markierten Werte korrigieren.')->send();
return;
}
$this->ladeGespeicherte();
Notification::make()->success()->title('Größen gespeichert')->body('Die Werte gelten jetzt auf der Website und in den CMS-Vorschauen.')->send();
}
public function askConfirmation(string $aktion, int|string|null $argument = null): void
{
$this->bestaetigung = match ($aktion) {
'standard' => ['aktion' => 'standard', 'argument' => null, 'titel' => 'Standardwerte wiederherstellen?', 'text' => 'Die gespeicherten Größen werden entfernt. Website und Vorschauen verwenden sofort wieder die Standardwerte aus dem Designsystem. Offene Eingaben gehen dabei verloren.', 'label' => 'Standardwerte wiederherstellen', 'gefahr' => true],
'verwerfen' => ['aktion' => 'verwerfen', 'argument' => null, 'titel' => 'Änderungen verwerfen?', 'text' => 'Die Eingaben kehren zum wirksamen Stand zurück. Gespeichert wird dabei nichts.', 'label' => 'Verwerfen', 'gefahr' => true],
default => null,
};
}
public function confirmConfirmation(): void
{
$frage = $this->bestaetigung;
$this->bestaetigung = null;
match ($frage['aktion'] ?? null) {
'standard' => $this->standardWiederherstellen(),
'verwerfen' => $this->ladeGespeicherte(),
default => null,
};
}
public function cancelConfirmation(): void
{
$this->bestaetigung = null;
}
private function standardWiederherstellen(): void
{
DesignSettings::reset();
$this->ladeGespeicherte();
Notification::make()->success()->title('Standardwerte wiederhergestellt')->body('Website und Vorschauen verwenden wieder die Standardwerte.')->send();
}
private function ladeGespeicherte(): void
{
$this->werte = $this->gespeichert();
$this->fehler = [];
}
}
+2 -1
View File
@@ -7,6 +7,7 @@
use App\Domain\Cms\Widgets\WidgetRegistry;
use App\Domain\Cms\Widgets\WidgetRenderer;
use App\Domain\Cms\Widgets\WidgetType;
use App\Domain\Design\DesignSettings;
use Filament\Actions\Action;
use Filament\Forms\Components\Builder;
use Filament\Forms\Components\Builder\Block;
@@ -426,7 +427,7 @@ public static function renderPreview(string $type, array $state): string
public static function previewStylesheets(): string
{
try {
return app(Vite::class)(['resources/css/app.css'])->toHtml();
return app(Vite::class)(['resources/css/app.css'])->toHtml().DesignSettings::styleTag()->toHtml();
} catch (Throwable) {
return '';
}