Files
laraundfelix/docs/ux/mitgliederbereich/abschlussbericht.md
T

10 KiB
Raw Blame History

Mitgliederbereich nach Brand-UI-Kit 14 – Abschlussbericht

Stand: 22.11.2026. Branch feature/mitgliederbereich-v2, auf develop (Test) gemergt. Entscheidung: ADR-45. Technisch fertig, nicht vom Betreiber abgenommen. Nicht auf luf-test mit einem Mitgliedskonto durchgespielt (siehe 5 und 7).

Referenz: docs/Brand-UI-Kit/14_mitgliederbereich_v2.0/ (Entwürfe, Handoff, Implementierungsbrief; liegt im Hauptverzeichnis ungetrackt und wurde nicht committet). Die Entwürfe geben Richtung und Hierarchie vor, keine Pixel, Daten oder Rechte.

1. Überarbeitete Ansichten

Ansicht Adresse Inhalt
Rahmen alle /bereich/… Kopfzeile mit freigegebener Wortmarke, Meine Bibliothek, Programme, Meine Lizenzen, Konto-Menü (Profil, Angebote, Abmelden); untere Leiste unter 56 rem
Startseite /bereich Begrüßung, Suche, Inhaltsart-Chips, „Meine Programme“, Schnellzugriff mit Zahlen je Art, Lizenzhinweis; Leerzustand ohne Inhalte
Bibliothek /bereich/bibliothek (?art=) Suche, aufklappbarer Filter (Säulen, Dimensionen, Verfügbarkeit), Inhaltsart mit Zahlen, Sortierung, Karten für Programme, Module, Filme, Materialien; Treffer- und Leerzustände
Programm und Modul /bereich/bibliothek/programm/{id} Kopf mit Kennzahlen, Überblick, Lernziele, geordnete Struktur mit Verschachtelung, Einsatz und Vorbereitung; Abschnitte nur mit Daten
Film und Material im Zusammenhang /bereich/bibliothek/programm/{id}/inhalt/{version} (neu) Player, Vollbild, Herunterladen nur mit Recht, Kurzbeschreibung, Begleitmaterial, Weg zurück zu Modul und Programm
Einzelartikel /bereich/bibliothek/{artikel} Wie bisher, im neuen Rahmen, mit getrennter Ansicht- und Downloadentscheidung
Meine Lizenzen /bereich/berechtigungen Aktiv, Inaktiv, Alle; je Berechtigung Herkunft, Zweck, Aktionen, Zeitraum, Zustand
Lizenzdetail /bereich/berechtigungen/{grant} (neu) Umfang, Nutzungsrechte, Herkunft und Zeitraum, Einschränkungen
Angebote, Bestellung, Profil, Lesen bestehende Adressen Neuer Rahmen und Kopfbereich, Funktionen unverändert

/bereich/materialien leitet auf den Filter ?art=material um; /bereich/bibliothek/module und /programme bleiben.

2. Verwendete Bausteine und Größeneinstellungen

  • Kit und Website: Wortmarke <x-site.brand variant="logo">, Markenakzent <x-brand.underline>, Schaltflächen .button, .button-secondary, Meldungen .status/.errors, Formular .form, Heroicons. Neue Komponenten: x-member.hero|card|type|status und resources/css/components/lf-member.css. Die Verwaltungsvorschau der Bibliothekskarte nutzt dieselbe x-member.card.
  • Größen: ausschließlich Tokens der Skala (ADR-44): --text-h1|h2|h3|body|small|lede|button, --space-*, --pad-card, --grid-gap, --touch-target, --header-height, --width-standard, --gutter, --radius-*. Neu ist nur das abgeleitete Token --card-min (80 % von --ds-media). Kein neuer Basiswert, kein --ds-* verändert. Karten- und Listentext sind --text-small, Kartentitel --text-h3: dichter als die Website, Trefferflächen bleiben 44 px.
  • Abweichungen von den Entwürfen: keine Fotos (nur freigegebene Vorschaubilder der Fachobjekte, sonst Platzhalter mit Inhaltsart); Kopfbereich ohne Blattmotiv; kein Hamburger-Menü (doppelte Navigation), das Konto-Menü bleibt; kein „Programm starten“, keine Zähler je Filterwert, kein Karten-/Listenwechsel, kein „Zuletzt genutzt“, kein Dokumentenreiter „Lizenzbedingungen (PDF)“ (alles ohne Datenbasis).

3. Erhaltene und ergänzte Funktionen

Erhalten: Anmeldung, Sitzung, Rollen, Medienwege (signierte Routen, DecideAccess, DeliveryLog), Lizenzzuordnung, Angebote, Bestellung, Profil, Routen und Routennamen (member.*). Keine Migration, kein neues Datenmodell.

Ergänzt: Inhaltsart-Filter, Sortierung, Suche auch in Suchbegriffen, programmübergreifende Medienliste mit „Verwendet in“, Kontextseite für Film und Material, getrennte Downloadentscheidung bei Begleitmaterial und Artikeln, Lizenzdetail, Inaktive Lizenzen, Zustand nach DecideAccess-Regel, Anzeigetexte aus der Fachverwaltung (Kontext „Mitgliederbibliothek“).

4. Abhängigkeiten zur Fachverwaltung

  1. Anzeigetexte: Titel, Kurzbeschreibung und Beschreibung kommen aus EditorialProfileReader (Kontext „Mitgliederbibliothek“). Pflegt die Verwaltung dort nichts, gelten zentrale Angaben, zuletzt die interne Bezeichnung.
  2. Vorschaubilder: member.thumbnail erlaubt nur Wurzel-Kompositionen und Medien im Artikelstand einer Berechtigung. Verschachtelte Module haben deshalb keine eigenen Karten- oder Zeilenbilder (Platzhalter). Eine Erweiterung wäre eine bewusste, getestete Änderung der Bildfreigabe.
  3. Zielgruppe, Altersbereich: Es gibt kein eigenes Feld. Sie erscheinen nur als Filterwerte der gepflegten Fachdimensionen, nicht auf Karte oder Detail. Zeitbedarf nur, wenn die Fassung ihn trägt.
  4. Inhaltsart „Modul“: Module sind Kompositionen mit Inhaltsart modul; alles andere zählt als Programm.
  5. Sortierung „Neueste“: Es gibt kein belastbares Datum der Bibliotheksaufnahme. Angeboten werden Reihenfolge der Lizenzen und Titel A–Z.
  6. Mitglieder-Anzeigefreigabe: unverändert CompositionDisplayRelease; nicht freigegebene Fassungen erscheinen weder in der Liste noch als Programmseite (404).

5. Browser- und Testergebnisse

  • Automatisiert: 591 Tests grün (php artisan test), Pint auf app tests config database routes ohne Befund, npm run build ohne Fehler. Neu: tests/Feature/MemberAreaV2Test.php (16 Tests). Gitea: feature/mitgliederbereich-v2 und der Merge auf develop (Lauf 5044) erfolgreich.
  • Bewusst geänderte Bestandstests (Begründung im Commit): Film spielt auf der Kontextseite statt eingebettet; Download-Links tragen ein Symbol (Zählung per Laden</a>, ein vakuöses assertDontSee wurde dabei mitgeführt); Platzhalter ist ein dekoratives Element; Wortmarke ist das freigegebene Logo; Begrüßung „Willkommen zurück“; Verwaltungsvorschau prüft mb-card.
  • Browser (Chromium, lokal, Demodaten des ShopDemoSeeder, Test- und Berechtigungskonten): Szenarien 1 bis 10 durchgespielt: Anmeldung und Start, Bibliothek mit Filter und Inhaltsart, Programm, Kontextseite des Films, Begleitmaterial, Rückweg, Lizenzliste und -detail, Konto ohne Lizenz (Programm sichtbar, alle Teile „Nicht enthalten“, Kontextseite 403 ohne <video> und ohne Medienadresse). Desktop 1280 px und Smartphone 390 px, Bilder in abnahme/.
  • Skriptprüfung (59 Prüfpunkte, 57 bestanden): Konto-Menü per Tastatur (Enter, Fokus ins Menü, Escape mit Fokusrückgabe, Klick außen), Sprunglink als erster Tabstopp, genau eine h1 je Seite, kein waagerechtes Scrollen bei 320, 390 und 768 px, Trefferflächen mindestens 44 px, prefers-reduced-motion im Kontext gesetzt. Zwei Prüfpunkte sind keine Befunde: „Fokus sichtbar“ traf das Suchfeld, dessen Fokusring der Rahmen .mb-search:focus-within zeigt; „Textgröße 200 %“ war methodisch ungültig (Media-Queries folgen einer per CSS überschriebenen Schriftgröße nicht), die schmalen Breiten decken den Fall ab.
  • Nicht durchgeführt: Durchlauf als Mitglied auf luf-test. Es gibt dort kein bekanntes Mitgliedskonto mit Lizenzen. Ein Prüfkonto über das Registrierungsformular anzulegen und den Bestätigungslink aus dem Container-Protokoll zu lesen, wurde von der Berechtigungsprüfung abgelehnt und nicht umgangen. Geprüft ist nur, dass https://dev.laraundfelix.de die neuen Stile ausliefert (mb-header-inner, --card-min im ausgelieferten Stylesheet) und /up, /anmelden, /registrieren antworten.

6. Sicherheits- und Berechtigungsprüfungen

  • Jede Wiedergabe-, Ansicht- und Downloadadresse entsteht nur nach DecideAccess je Aktion; die Medienrouten sind unverändert (signed:relative, Leser-Prüfung, DeliveryLog).
  • Tests: Streamen erlaubt und Laden verweigert (kein Download-Link, Hinweis, erratene signierte Adresse ergibt 403); Konto ohne Recht erhält 403 ohne Medienadresse; Stelle außerhalb des Programms 404; nicht freigegebenes Programm 404; Gäste werden zur Anmeldung geleitet; fremde Berechtigung 404 (kein Einblick in andere Konten); widerrufene, abgelaufene und noch nicht gültige Berechtigungen erscheinen als inaktiv und öffnen nichts; zwei Berechtigungen mit unterschiedlichem Zweck bleiben zwei Einträge ohne kombinierte Rechte; die Lizenzseite zeigt weder erfundene Lizenzbedingungen noch Preise.
  • Keine Dateipfade in Seiten (Test), Originale nie öffentlich verlinkt.

7. Verbleibende Einschränkungen und Entscheidungen für Lars

  1. luf-test-Durchlauf offen. Dafür braucht es ein Mitgliedskonto mit Lizenzen auf der Testinstanz (z. B. ShopDemoSeeder durch Lars, oder ein freigegebenes Prüfkonto) oder die Freigabe, ein Konto über die Registrierung anzulegen.
  2. Ansprache: Die überarbeiteten Seiten sagen „du“ (Entwürfe, Shop). Anmeldung, Registrierung und viele Systemmeldungen sagen „Sie“. Eine einheitliche Regel fehlt; der Wechsel ist reine Textarbeit in den Views.
  3. Player nicht mit echtem Film geprüft: Lokal gab es keine Mediendateien; die Wiedergabe (HLS) selbst ist unverändert, das Layout des Players mit Platzhalter geprüft.
  4. Bilder: Die Karten mit echten Vorschaubildern sind nur per Test geprüft, nicht visuell.
  5. Kein „Zuletzt genutzt“, keine Favoriten: Es gibt keine Nutzungshistorie. Falls gewünscht: eigene, schlanke Ergänzung (z. B. Tabelle „zuletzt geöffnet“ je Konto), ausdrücklich zu beschließen.
  6. Zahlen je Filterwert, Karten-/Listenwechsel, Lizenzbedingungen als Dokument fehlen mangels Datenbasis bzw. Beschluss.
  7. Dokumentenansicht: „Ansehen“ liefert die Datei oder den Text über den bestehenden Weg; eine eingebettete Dokumentvorschau gibt es nicht.
  8. Größenskala: Die Verwaltung („Website → Design → Größen“) wirkt jetzt auch auf den Mitgliederbereich; ein hoher Fließtext-Wert vergrößert Karten (--card-min folgt --ds-media, nicht dem Fließtext).

8. Commit- und Deploymentstand

  • 2e6260a Gestalte den Mitgliederbereich nach Brand-UI-Kit 14 neu; 0c4ef4c Dokumentation und Absicherung; Merge 8b64429 auf develop.
  • Gitea: Lauf 5042 (Feature-Branch) und 5044 (develop, Tests und Deploy Test) erfolgreich. Nichts nach main, keine Produktivsetzung, kein Eingriff auf den Servern.
  • Abnahmebilder und dieser Bericht kamen nachträglich auf develop (Docs-Commit).