@@ -65,6 +65,7 @@ ## Übersicht der Architekturentscheidungen
| ADR-42 | Angebot und Warenkorb | Fachlich beschlossen | Gemeinsame Angebotsseite mit Lizenzwahl, Mehrangebotswarenkorb und Geltung der Bestellfassung je Position |
| ADR-43 | Trailer auf Karten | Umgesetzt auf Test (21.11.2026); Abnahme offen | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer beim Überfahren oder Antippen; ohne Freigabe nur das Bild |
| ADR-44 | Gemeinsame, konfigurierbare Größenskala | Umgesetzt auf `develop` (22.11.2026); Abnahme durch den Betreiber offen | Zehn Basiswerte steuern Typografie, Abstände, Kopfzeile, Breite und Bildhöhen für Website, CMS-Vorschau und gemeinsam genutzte Komponenten; einstellbar in „Website → Design → Größen“ ohne Deployment |
| ADR-45 | Mitgliederbereich nach Brand-UI-Kit 14 | Umgesetzt auf `develop` (22.11.2026); Abnahme durch den Betreiber offen | Eine Navigation (Bibliothek, Programme, Lizenzen, Konto), eine Karte je Medienidentität in der übergreifenden Liste, Film und Material im Zusammenhang, Lizenzdetail je Berechtigung; keine neuen Datenmodelle, Größen nur aus der Skala |
- **Konfiguration in der Verwaltung:** Seite „Website → Design → Größen“ (`App\Filament\Pages\DesignGroessen`, Navigationsgruppe „Design“), nur für den Systemverwalter. Arbeitsstand mit einer Speicherhandlung, Prüfung der Wertebereiche und der Reihenfolge (Fließtext + 6 ≤ Überschrift 2, Überschrift 2 + 4 ≤ Überschrift 1 ≤ Display), „Standardwerte wiederherstellen“ mit Bestätigung. Speicher: Tabelle `site_settings` (Schlüssel `design.scale`, JSON), rein ergänzende Migration; ohne Zeile gelten die Standardwerte, „Wiederherstellen“ löscht die Zeile.
- **Wirkung ohne Deployment:** Abweichende Werte werden als Inline-Stylesheet (`<style id="lf-design-scale">:root{…}</style>`) nach dem Stylesheet in `layouts/site`, `layouts/member` und in alle CMS-Vorschauen (`WidgetEditor::previewStylesheets()`) eingefügt. Ausgegeben werden nur geprüfte ganze Zahlen zu bekannten Schlüsseln. Lesen ist ausfallsicher: fehlende Tabelle, Datenbankfehler oder beschädigte Daten ergeben die Standardwerte, nie eine Fehlerseite (deshalb ist auch ein Code-Rollback folgenlos).
- **Nicht einstellbar (Barrierefreiheit):** Trefferflächen 44 px; Fließtext nie unter 16 px, auch auf Smartphones; Fokusdarstellung.
- **Mitgliederbereich:** Er verwendet dieselben Tokens und folgt daher Fließtext, Überschrift 3, kleiner Schrift und Abstandsraster. Seine festen Überschriften H1/H2 und sein Layout bleiben unverändert. Kopfzeile, Abschnittsabstände, Inhaltsbreite und Bildhöhen werden nur von der öffentlichen Website verwendet. Die Überarbeitung des Mitgliederbereichs nach seinem eigenen Design-Kit ist ein eigenes Arbeitspaket und nutzt diese Grundlage.
- **Mitgliederbereich:** Er verwendet dieselben Tokens und folgt daher Fließtext, Überschrift 3, kleiner Schrift und Abstandsraster. Seine festen Überschriften H1/H2 und sein Layout bleiben unverändert. Kopfzeile, Abschnittsabstände, Inhaltsbreite und Bildhöhen werden nur von der öffentlichen Website verwendet. Die Überarbeitung des Mitgliederbereichs nach seinem eigenen Design-Kit ist mit ADR-45 erfolgt; er bindet seine Überschriften, Abstände, Kopfzeile und Breite jetzt an die Tokens.
- **Verwaltungsoberfläche:** Die Filament-Oberfläche lädt `app.css` nicht und bleibt unberührt. Die Vorschau-Iframes laden es und zeigen deshalb die aktiven Werte.
**Alternativen.** Je CSS-Eigenschaft eine Einstellung (verworfen: nicht wartbar, Fehleinstellungen); Größen nur im Code (verworfen: Betreiber will praktisch feinjustieren); Ableitung in PHP und Ausgabe aller Tokens (verworfen: zweite Quelle der Regeln neben dem Stylesheet); `zoom`, `transform: scale()` oder globale Prozentskalierung (verworfen: Lesbarkeit, Barrierefreiheit); getrennte Skalen für Website und Mitgliederbereich (verworfen: widerspricht ADR-36).
**Folgen.** Neue Komponenten verwenden die abgeleiteten Tokens, keine eigenen Größen. Neue Basiswerte erfordern Eintrag in `tokens.css` und `DesignScale::PARAMETERS`. Die Kit-Komponenten weichen weiter vom Brand-UI-Kit v1.6/v1.7 ab (dokumentiert in `designsystem.md` §15). Die Abnahmebilder der Verwaltung mit Vorschau sind bei Änderung der Werte nicht mehr maßgeblich für Größen.
## ADR-45 – Mitgliederbereich nach Brand-UI-Kit 14
**Status am 22.11.2026:** Umgesetzt auf `develop` (Branch `feature/mitgliederbereich-v2`); Abnahme durch den Betreiber offen. Technische Fertigstellung ist keine UX-Abnahme. Baut auf ADR-36 (Designsystem) und ADR-44 (Größenskala) auf; die Fachregeln stehen in `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md` §§6–11.
**Kontext.** Die drei freigegebenen Entwürfe unter `docs/Brand-UI-Kit/14_mitgliederbereich_v2.0/` geben Gestaltungsrichtung und Informationshierarchie vor, keine Pixel, Daten oder Rechte. Der bestehende Mitgliederbereich hatte eine Seitenleiste und eine zweite untere Leiste mit fünf Zielen, feste Überschriftengrößen, eine eingebettete Wiedergabe in der Programmstruktur und eine Lizenzliste nur mit Artikelcode.
**Entscheidung.**
- **Eine Navigation.** Kopfzeile mit der freigegebenen Wortmarke, „Meine Bibliothek“, „Programme“, „Meine Lizenzen“ und dem Konto-Menü (Profil, Angebote, Abmelden). Unter 56 rem ersetzt eine untere Leiste mit denselben drei Zielen die Hauptnavigation; ein Hamburger-Menü entfällt, weil es dieselben Ziele doppeln würde. „Module“ und „Materialien“ sind keine Navigationspunkte mehr, sondern Werte des Filters „Inhaltsart“ (Programme, Module, Filme, Materialien); die Adressen `/bereich/bibliothek/module` und `/bereich/materialien` bleiben (Letztere leitet auf den Filter).
- **Eine Karte je Medienidentität.**`App\Http\LibraryCatalog` baut den Strukturbaum je Komposition einmal pro Anfrage und führt zugängliche Einzelmedien nach Inhaltselement (stabile Identität) zusammen; „Verwendet in“ nennt die Programme und Module. Innerhalb eines Programms bleibt jede Einbindung an ihrer Stelle. Gleiche Titel verschiedener Elemente bleiben getrennte Karten; mehrere Fassungen derselben Identität werden kenntlich gemacht. Es gibt keine neue Tabelle.
- **Film und Material im Zusammenhang.** Neue Route `member.content` (`/bereich/bibliothek/programm/{composition}/inhalt/{version}`) zeigt Player, Beschreibung, Begleitmaterial (Geschwister im selben Modul) und den Weg zurück. Sie findet nur Stellen, die in der angezeigten Fassung des Programms stehen (sonst 404). Wiedergabe-, Ansicht- und Downloadadresse kommen weiter ausschließlich aus `DecideAccess` und den signierten Medienrouten; ohne Recht antwortet die Seite mit 403 und enthält keine Adresse. Ansehen und Laden werden getrennt entschieden.
- **Lizenzübersicht je Berechtigung.** Neue Leseschicht `App\Http\MemberLicenses` und Route `member.grant` (`/bereich/berechtigungen/{grant}`, nur für Berechtigungen, die das Konto nutzen darf, sonst 404). Je Grant ein Eintrag mit Herkunft (Erwerbsart, Angebotsname), Inhaber, Zweck, erlaubten Aktionen, Zeitraum und Zustand. Der Zustand folgt der Regel von `DecideAccess` (Status, Beginn, Ende), damit die Anzeige nie mehr verspricht als die Entscheidung erlaubt. Rechte verschiedener Erwerbe werden weder addiert noch vereinigt; zwei Berechtigungen für denselben Artikel sind zwei Einträge. Nicht mehr aktive Berechtigungen bleiben unter „Inaktiv“ nachvollziehbar. Nicht gezeigt wird, was nicht vorliegt: Lizenzbedingungen als Dokument, Preise, erfundene Laufzeiten.
- **Anzeigetexte** der Bibliothek kommen aus `EditorialProfileReader` mit dem Kontext „Mitgliederbibliothek“ (Abweichung, sonst zentrale Angabe, sonst interne Bezeichnung), also aus der Fachverwaltung, nicht aus Kopien.
- **Größen.**`resources/css/components/lf-member.css` ersetzt den Block `body.member` und verwendet nur Tokens der Größenskala (`--text-*`, `--space-*`, `--pad-card`, `--touch-target`, `--width-standard`, `--header-height`, `--grid-gap`) und ein abgeleitetes Token `--card-min` (80 % der Bildhöhe `--ds-media`). Es gibt keinen neuen Basiswert und keine zweite Größenverwaltung. Auf Smartphones sind Karten kompakt (Bild links).
- **Nicht enthalten, bewusst:** „Zuletzt genutzt“ und Favoriten (es gibt keine Nutzungshistorie; `DeliveryLog` ist ein Lizenznachweis, keine Nutzerhistorie), Karten-/Listenwechsel, Fortschritt, Denkpause, Kursplayer, Zahlen je Filterwert.
- **Ansprache.** Die überarbeiteten Mitgliederseiten verwenden „du“ wie die Entwürfe und der Shop. Anmeldeseiten und Systemmeldungen anderer Abläufe sind unverändert („Sie“); eine einheitliche Regel steht aus und ist eine Entscheidung des Betreibers.
**Alternativen.** Eigene Bibliotheks-Tabelle oder Suchindex (verworfen: zweite Wahrheit neben den Fachobjekten); „Verwendet in“ als gespeicherte Beziehung (verworfen: abgeleitet aus den Strukturen); Player weiter eingebettet in der Programmstruktur (verworfen: lädt jeden Film der Seite, trennt Film und Begleitmaterial nicht); Übernahme der Entwurfspixel (verworfen: widerspricht ADR-44).
**Folgen.** Tests, die Markup der alten Ansichten prüften, sind bewusst geändert (Begründung im Commit). Die Vorschau der Bibliothekskarte in der Verwaltung rendert dieselbe Komponente `<x-member.card>`. Offene Abhängigkeiten zur Fachverwaltung stehen im Abschlussbericht `docs/ux/mitgliederbereich/abschlussbericht.md`.
**Quelle.** `docs/Brand-UI-Kit/14_mitgliederbereich_v2.0/` (Handoff, Implementierungsbrief), Fachkonzept §§6–11 und 13, ADR-36, ADR-44.
| Abschnittsabstände, Bildhöhen (Widgets) | ja | Abstände über `--space-*`; Kartenbreite über das abgeleitete Token `--card-min` (80 % von `--ds-media`) |
Die Überarbeitung des Mitgliederbereichs nach seinem eigenen Design-Kit ist ein eigenes Arbeitspaket; es nutzt dieselben Basiswerte und Tokens und kann seine Überschriften an `--text-h1|h2` anbinden.
Der Mitgliederbereich (`resources/css/components/lf-member.css`, ADR-45) verwendet ausschließlich diese Tokens; Karten- und Listentext sind `--text-small`, Trefferflächen `--touch-target`. Er hat keine eigenen Basiswerte.
### 15.5 Abweichung vom Brand-UI-Kit
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.