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'];
}
}