Compare commits

...
Author SHA1 Message Date
LarsandClaude Sonnet 5.5 6518d1b80f Belege die Verkaufsstart-Etappe auf luf-test im Abnahmeprotokoll
CI Feature / test (push) Successful in 2m52s
Deploy Test / test (push) Successful in 3m6s
Deploy Test / deploy (push) Successful in 34s
Abschnitt im Abnahmeprotokoll mit geprüftem Commit, Workflow-Status, Klickfolge,
Browserbelegen, nicht geprüften Punkten (Verein, PDF, Stripe-Wiederholung, Mail)
und offenen Freigabepunkten. Nur Dokumentation; der Anwendungscode entspricht 69a22de.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 22:46:50 +01:00
LarsandClaude Sonnet 5.5 69a22deb1f Sichere Rechnungs- und Livepfad ab und dokumentiere die Entscheidungen zum Verkaufsstart
CI Feature / test (push) Successful in 2m52s
Deploy Test / test (push) Successful in 2m40s
Deploy Test / deploy (push) Successful in 40s
Eine Bestellung auf Rechnung lässt sich auch mit dem Stripe-Treiber nicht per Karte
bezahlen; der Betreiber, der den Zahlungseingang bestätigt, wird an der Zahlung
festgehalten; im Livebetrieb ist der alte Einzelkauf ohne Pflichtangaben gesperrt und
placeFromCart verlangt die Zustimmungen. ADR-47, Domänenmodell, Lizenzlogik,
Kernabläufe, Szenarien, Fachanforderungen und DEPLOYMENT nachgeführt.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 20:11:24 +01:00
LarsandClaude Sonnet 5.5 f0287eec2f Mache den Anmeldetest deterministisch und entferne die doppelte Meldung in der Kasse
CI Feature / test (push) Successful in 3m26s
RegistrationTest: Der Name kam aus dem Faker und enthielt gelegentlich ein
Apostroph (O'Hara), das im HTML maskiert wird; der Test schlug dadurch zufällig im
Gitea-Lauf fehl. Der Name ist jetzt fest, die Assertion unverändert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 20:02:41 +01:00
LarsandClaude Sonnet 5.5 42e0a6bb93 Mache den Download bei reiner Download-Lizenz erreichbar und zeige den Stand zum Verkaufsstart
CI Feature / test (push) Failing after 3m2s
Die Artikelseite zeigte bei einer Lizenz nur zum Herunterladen (kein Streamen oder
Ansehen) "Nicht enthalten"; jetzt bietet sie den Download. Tests belegen Einzelfilm
und Begleit-PDF aus der Bibliothek mit Dateiname und Zugriffsgrenzen. Neue
Verwaltungsseite Verkaufsstart nennt fehlende Rechtstexte und den Zustand der
Zahlungseinrichtung, ohne Schlüssel zu zeigen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 19:58:22 +01:00
LarsandClaude Sonnet 5.5 76fab81386 Verwalte Rabattcodes mit Kontofreigabe und Bestellungen mit Rechnungsweg und Erstattung
Neue Verwaltungsseiten Rabattcodes (Anlegen und Bearbeiten in einer Maske, Konten
für genau diesen Code freischalten und entziehen) und Bestellungen (Zahlungseingang
bei Rechnung bestätigen, vollständig erstatten). Der Nutzerkreis ist in der
Angebotsmaske ein Pflichtfeld. BestandslisteTest: die Fassung ohne Nutzerkreis
verlangt jetzt dessen Angabe beim Bearbeiten; die geprüfte Aussage (verdeckte
Konditionen bleiben erhalten) ist unverändert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 19:53:56 +01:00
LarsandClaude Sonnet 5.5 1ce2e1e51f Gib Paketen eine eigene Produktseite und ergänze Tests zu Nutzerkreis und Verkaufsstart
Ein eigenständig vermarktetes Paket (offers.standalone_bundle) erhält /pakete/{id}
mit seinem tatsächlichen Umfang, Shop-Kachel und Suche. Die Angebotsmaske kennt
Nutzerkreis und Anzahl Trainer. Zwei Bestandstests (CartTest, Vergleich der
Rechte und Erwerbsarten) legen die Vergleichsangebote jetzt als Einzellizenz an,
weil der Nutzerkreis zum identischen Umfang gehört; ihre Aussagen bleiben.
Eine Rechnungs- oder Stripe-Bestellung lässt sich nicht mit der Testzahlung bestätigen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 19:47:15 +01:00
LarsandClaude Sonnet 5.5 0154182f3b Führe Rabattcodes, Nutzerkreis der Lizenzoption und Pflichtangaben der Kasse ein
Domäne: Rabattcodes mit Geltungsbereich (Warenkorb oder gewählte Ziele) und
Einlösungsberechtigung (allgemein oder freigeschaltete Konten) unabhängig
voneinander; Prüfung bei Eingabe, in jeder Übersicht und unter Sperre vor
Bestellabschluss (Prüfsumme der Übersicht enthält den Rabatt). Rabatt je
Position, Zwischensumme und Zahlbetrag in der Bestellung; Stripe erhält den
Preis nach Rabatt. Nutzerkreis (Einzel-/Mehrfachlizenz, Trainerzahl) an der
Angebotsfassung, kopiert in Bestellposition und Erwerb, Teil der Prüfung
"Bereits erworben". OfferService::activate lehnt Angebote ohne veröffentlichten
Artikelstand ab. Kasse: Zustimmungen als Pflichtangabe mit Nachweis,
"Zahlungspflichtig bestellen", Rechnungsweg für Organisationen, Erstattung über
Stripe, Widerruf erklären. Produktivfreigabe SHOP_LIVE_RELEASE standardmäßig aus.

Bestandstests geändert (fachlich überholt, Assertions nicht abgeschwächt): die
Schaltfläche heißt "Zahlungspflichtig bestellen" (§ 312j BGB), die Summe heißt
"Zu zahlen", der Vereinshinweis steht als Rollenliste; Bestellungen über die
Kasse senden jetzt die Zustimmungen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 19:42:02 +01:00
LarsandClaude Sonnet 5.5 cb80835c92 Zeige auf der Artikelseite den Anzeigetitel und das passende Symbol; belege luf-test
Deploy Test / test (push) Successful in 2m44s
Deploy Test / deploy (push) Successful in 37s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 18:49:28 +01:00
LarsandClaude Sonnet 5.5 e7efb073da Behebe Player, Download-Namen und ergänze Profil, Fußzeile und Lizenzhinweis
CI Feature / test (push) Successful in 2m45s
Deploy Test / test (push) Successful in 2m57s
Deploy Test / deploy (push) Successful in 30s
- app.js: Der Anfangsscan übergab das Dokument, das kein Element ist; HLS-Filme im Quelltext wurden nie angebunden.
  Vollbild findet sein Video auch neben dem Player.
- Download und Ansicht heißen nach dem Anzeigetitel statt „laden.mp4“.
- Mitgliederprofil: Name, E-Mail mit Bestätigung der neuen Adresse, Passwort, Rechnungsadresse (ADR-46).
- Kleine Fußzeile mit Rechtlichem aus der CMS-Navigation.
- Lizenzdetail nennt, dass Einzel-/Mehrfachlizenz nicht festgelegt ist (Funktion gibt es noch nicht).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 18:38:59 +01:00
Lars 433f9aee61 Merge remote-tracking branch 'origin/develop' into feature/mitgliederbereich-v2
Deploy Test / test (push) Successful in 2m29s
Deploy Test / deploy (push) Successful in 38s
2026-11-22 18:09:19 +01:00
LarsandClaude Sonnet 5.5 bb0949dcd9 Belege den Mitgliederbereich mit Abschlussbericht und lokalen Abnahmebildern
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 18:09:18 +01:00
Lars 2d54d39c24 Merge remote-tracking branch 'origin/develop' into feature/kopfzeile-desktop-menue-merge
Deploy Test / test (push) Successful in 2m26s
Deploy Test / deploy (push) Successful in 41s
2026-11-22 18:04:37 +01:00
LarsandClaude Sonnet 5.5 cf50d341f5 Zeige auf dem Desktop die offene Navigation und nutze den Burger nur als letzte Stufe
CI Feature / test (push) Successful in 2m24s
Die Messung der Kopfzeile verglich die Breite des Navigationsbereichs, der sich
auf den freien Platz dehnt, und schaltete bei acht Einträgen auf jeder Breite in
den Menümodus. Jetzt wird der echte Platzbedarf der Einträge gemessen und vor
dem Menümodus eine enge Stufe (kleinerer Abstand und Schrift) eingeschoben.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 18:00:52 +01:00
Lars 8b644292a7 Merge remote-tracking branch 'origin/develop' into feature/mitgliederbereich-v2
Deploy Test / test (push) Successful in 2m14s
Deploy Test / deploy (push) Successful in 38s
2026-11-22 18:00:09 +01:00
LarsandClaude Sonnet 5.5 0c4ef4c4ed Dokumentiere den Mitgliederbereich (ADR-45) und sichere Medien ohne Element ab
CI Feature / test (push) Successful in 2m50s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 17:56:59 +01:00
LarsandClaude Sonnet 5.5 2e6260acca Gestalte den Mitgliederbereich nach Brand-UI-Kit 14 neu
Eine Navigation (Meine Bibliothek, Programme, Meine Lizenzen, Konto-Menü) mit der freigegebenen Wortmarke,
Startseite ohne erfundene Inhalte, Bibliothek mit Inhaltsart-Filter und einer Karte je Medienidentität
(„Verwendet in“), Programm-/Moduldetail, Film und Material im Zusammenhang mit Begleitmaterial und Weg zurück,
Lizenzübersicht mit Detailseite je Berechtigung. Alle Größen aus der Größenskala (ADR-44, neues Token --card-min).

Tests bewusst angepasst: Der Film spielt auf der Kontextseite statt eingebettet im Programm, Download-Links tragen
ein Symbol, der Platzhalter ist ein dekoratives Element, die Wortmarke ist das freigegebene Logo. Die Vorschau der
Bibliothekskarte in der Verwaltung nutzt dieselbe Komponente.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 17:56:16 +01:00
LarsandClaude Sonnet 5.5 8ecc1ecdaa Verlinke Anmeldung und Registrierung gegenseitig
CI Feature / test (push) Successful in 2m42s
Deploy Test / test (push) Successful in 2m50s
Deploy Test / deploy (push) Successful in 28s
Die Anmeldeseite wies Neukunden nicht auf die Registrierung hin und die
Registrierungsseite nicht auf die Anmeldung. Beide Seiten verlinken sich
jetzt, mit Feature-Tests.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 17:45:50 +01:00
StommerandClaude Sonnet 5.5 9f070fbab2 Entferne die Fehlermeldung beim Korrigieren und belege die Abnahme der Größen-Seite
Deploy Test / test (push) Successful in 2m32s
Deploy Test / deploy (push) Successful in 32s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 15:49:09 +01:00
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
StommerandClaude Sonnet 5.5 05d487dd0b Dokumentiere die Größenskala (ADR-44), Designsystem und Widget-Registry
CI Feature / test (push) Successful in 3m1s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 14:54:14 +01:00
StommerandClaude Sonnet 5.5 67614158e4 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>
2026-11-22 14:54:14 +01:00
StommerandClaude Sonnet 5.5 e0a3fdbb70 Analysebericht zur Größenskala der Website
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 14:14:33 +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
StommerandClaude Sonnet 5.5 8b59946bb1 Merge branch 'feature/stripe-abnahme-doku' into develop
Deploy Test / test (push) Successful in 1m41s
Deploy Test / deploy (push) Successful in 26s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 10:26:26 +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
StommerandClaude Sonnet 5.5 f54acd55e6 Dokumentiere die Stripe-Sandbox-Abnahme und die Stolpersteine der Einrichtung
CI Feature / test (push) Successful in 1m39s
Bestellung 7 wurde über die Stripe-Kasse im Testmodus bezahlt und per Webhook freigeschaltet.
Betriebsdoku um die erlebten Stolpersteine ergänzt (pk_ statt sk_, Managed Payments, inklusiver
Steuersatz, Neuausrollen, Fehlersuche im Protokoll).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 10:26:13 +01:00
LarsandClaude Sonnet 5.5 2ca7a8b268 Biete an Medien- und Programmkarten an, alle Texte auszublenden
CI Feature / test (push) Successful in 2m16s
Deploy Test / test (push) Successful in 1m59s
Deploy Test / deploy (push) Successful in 27s
Neue Einstellung „Texte neben dem Bild“ (Darstellung): Ausblenden zeigt nur Bild oder Video,
ohne Titel, Text, Art, Zusatzangaben, Aktion und Marke im Bild. Der Titel bleibt unsichtbar für
Hilfstechnik, ein Trailer läuft weiter. Die Themenkarte hat die Einstellung nicht. Keine Migration.
Außerdem steht in der Beschreibung der Trailer-Einstellung jetzt der Ton nach Bedienung.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:59:56 +01:00
StommerandClaude Sonnet 5.5 cc890d9fc7 Merge branch 'feature/stripe-idempotenz' into develop
Deploy Test / test (push) Successful in 1m57s
Deploy Test / deploy (push) Successful in 28s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:55:29 +01:00
StommerandClaude Sonnet 5.5 37056761a3 Leite den Idempotenzschlüssel für Stripe aus den Parametern ab
CI Feature / test (push) Successful in 1m56s
Stripe lehnte die Anfrage mit „Keys for idempotent requests can only be used with the same
parameters“ ab: Der Schlüssel luf-order-<id>-<n> blieb nach einer geänderten Anfrage (Steuersatz)
gleich, weil fehlgeschlagene Versuche keine Zahlungszeile anlegen. Der Schlüssel enthält jetzt einen
Fingerabdruck der Parameter und die Minute. Ein doppelter Klick bleibt wirkungslos, geänderte
Parameter und Neuversuche nach einer Korrektur nutzen einen neuen Schlüssel.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:55:24 +01:00
LarsandClaude Sonnet 5.5 1413e0640f Wähle eine Stelle auch aus der Website-Datei eines Films ohne Fassung als Kartenbild
CI Feature / test (push) Successful in 1m57s
Deploy Test / test (push) Successful in 1m57s
Deploy Test / deploy (push) Successful in 26s
Der Regler „Bild aus dem Film“ der Medienkarte blieb bei einem Film nur mit Website-Datei
(zum Beispiel ein Teaser) aus, weil er eine bereitgestellte Fassung verlangte. Die Stelle
kommt jetzt aus der Website-Datei (Herkunft frame:0@Sekunde, wie im Medienmanager), mit
Vorschau über die Redaktionsroute und Übernahme als Bild-Medium in bis zu 1600 px Breite.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:41:36 +01:00
StommerandClaude Sonnet 5.5 631502c064 Merge branch 'feature/stripe-steuersatz' into develop
Deploy Test / test (push) Successful in 2m3s
Deploy Test / deploy (push) Successful in 27s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:37:39 +01:00
StommerandClaude Sonnet 5.5 4bc2e5871b Gib Stripe auf Wunsch einen im Preis enthaltenen Steuersatz je Position mit
CI Feature / test (push) Successful in 1m54s
Stripe lehnte die Checkout Session mit „Invalid line_items[0]: the product tax code is missing“ ab.
Neue optionale Einstellung STRIPE_TAX_RATE_ID (txr_...): Der Steuersatz wird jeder Position
mitgegeben. Eine ungültige ID wird vor jedem Aufruf abgewiesen. Der Satz muss in Stripe inklusiv
angelegt sein, damit der gezahlte Betrag der Bestellsumme entspricht (die Betragsprüfung bleibt).
Die Anwendung wählt keinen Satz; das entscheiden Steuer und Finance. Doku und env-Beispiel ergänzt.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:37:34 +01:00
LarsandClaude Sonnet 5.5 1bc5356e84 Mache die Trailer-Schaltfläche zum kleinen Symbol und spiele den Trailer nach Bedienung mit Ton
CI Feature / test (push) Successful in 1m57s
Deploy Test / test (push) Successful in 2m0s
Deploy Test / deploy (push) Successful in 35s
Die Schaltfläche mit Text verdeckte bei kleinen Karten viel vom Video und wiederholte die Art-Marke
Film. Sie ist jetzt ein 30-px-Symbol (44 px Trefferfläche, Beschriftung nur für Hilfstechnik).
Ein Klick oder Tipp startet den Trailer mit Ton, einmal ohne Schleife; während der stummen
Vorschau beim Überfahren schaltet er den Ton zu. Das Überfahren selbst bleibt stumm, weil
Browser dafür keinen Ton erlauben.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:23:04 +01:00
StommerandClaude Sonnet 5.5 2094961b6e Merge branch 'feature/stripe-fehlermeldung' into develop
Deploy Test / test (push) Successful in 1m54s
Deploy Test / deploy (push) Successful in 28s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:16:02 +01:00
StommerandClaude Sonnet 5.5 7ef58e0e6e Schreibe Begründung und Parameter einer abgelehnten Stripe-Anfrage ins Protokoll
CI Feature / test (push) Successful in 2m0s
Der Fehler 400 invalid_request_error war ohne Begründung nicht zu deuten. Das Protokoll nennt
jetzt zusätzlich den betroffenen Parameter und die gekürzte Begründung von Stripe. Schlüssel
und Kundendaten bleiben draußen (Test).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 08:15:50 +01:00
LarsandClaude Sonnet 5.5 94eda30298 Kürze die Optionsnamen des Schutzfilters, damit die Auswahl nichts abschneidet
CI Feature / test (push) Successful in 1m58s
Deploy Test / test (push) Successful in 2m4s
Deploy Test / deploy (push) Successful in 27s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 07:54:48 +01:00
LarsandClaude Sonnet 5.5 bff17a9e8e Kennzeichne Präsentationsmedien und Website-Freigabe in der Medienübersicht und filtere nach Schutz
CI Feature / test (push) Successful in 1m59s
Deploy Test / test (push) Successful in 2m24s
Deploy Test / deploy (push) Successful in 30s
Die Zeile nennt bei einem Bild, Film oder Hörstück ohne Inhaltsfassung „Präsentationsmedium“
statt „Noch keine Fassung“ und zeigt, ob das Medium für die Website freigegeben ist. Der neue
Filter „Schutz“ unterscheidet geschützte Medien (mit Fassung), öffentliche Medien
(Präsentationsmedien) und für die Website freigegebene; Alle Medien hebt ihn auf.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 07:49:01 +01:00
LarsandClaude Sonnet 5.5 73126fec0c Spiele im Einstieg ein freigegebenes Video stumm auf der Fläche des Fotos ab
CI Feature / test (push) Successful in 2m17s
Deploy Test / test (push) Successful in 2m4s
Deploy Test / deploy (push) Successful in 33s
Neue optionale Auswahl refs.video am Hero (Variante Foto mit Textfläche). Gespielt wird der
für die Website freigegebene Clip nach der Regel der Karte (Trailer, Vorschauclip, Website-Datei
des Films); nie der vollständige Film. Start nach dem Laden, Schaltfläche zum Anhalten, Foto als
Rückfall, kein Selbststart bei reduzierter Bewegung, Datensparmodus und 2G. Keine Migration.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 07:24:03 +01:00
LarsandClaude Sonnet 5.5 437bb394b2 Biete einen Film nur mit Website-Datei auf der Medienkarte zur Auswahl an
Ein Medium ohne Inhaltsfassung, etwa ein freigegebener Teaser, fehlte im Dropdown der
Medienkarte und wurde beim Speichern als archiviert oder gesperrt abgelehnt, weil die
Auswahl mindestens eine Fassung verlangte. Ein Film mit Website-Datei ist jetzt wählbar.
Öffentlich erscheint die Karte, sobald die Datei freigegeben ist, ohne Programmseite und
ohne Aktion; ohne Freigabe nur in der Redaktionsvorschau, mit Hinweis in der Auswahl.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 07:24:03 +01:00
LarsandClaude Sonnet 5.5 5e28538551 Wähle das Vorschaubild auch aus der Website-Datei eines Films ohne Fassung
CI Feature / test (push) Successful in 1m57s
Deploy Test / test (push) Successful in 1m53s
Deploy Test / deploy (push) Successful in 30s
Die Filmstelle konnte nur aus der Datei einer Inhaltsfassung gezogen werden; ein Medium
mit reiner Website-Datei hatte keine Quelle. Jetzt zieht die Auswahl die Stelle aus der
Website-Datei (Herkunft frame:0@Sekunde, bestehende Leser bleiben gültig). Die Vorschau
des Einzelbilds liegt hinter einer Redaktions-Route.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 07:07:32 +01:00
LarsandClaude Sonnet 5.5 be932c113a Zeige die Website-Datei eines Mediums ohne Fassung im Medienmanager an
CI Feature / test (push) Successful in 2m5s
Deploy Test / test (push) Successful in 1m56s
Deploy Test / deploy (push) Successful in 27s
Ein Film oder Hörstück ohne Inhaltsfassung zeigte nur „Noch keine Inhaltsfassung“; die
hochgeladene Website-Datei war nirgends ansehbar. Die Detailansicht spielt sie jetzt ab
(Reiter Inhalt und Website), über eine Redaktions-Route nur für angemeldete Redakteure,
mit Bereichsabrufen. Die Bereichsauslieferung liegt in einem gemeinsamen Trait für die
Website-Route und die Redaktions-Route. Fehler der Übernahme erscheinen an derselben Stelle.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 06:55:36 +01:00
StommerandClaude Sonnet 5.5 ef3af0e036 Merge branch 'feature/stripe-sandbox' into develop
Deploy Test / test (push) Successful in 1m52s
Deploy Test / deploy (push) Successful in 30s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 06:32:20 +01:00
LarsandClaude Sonnet 5.5 936c85ef5e Trage den Trailer auf Karten in die Release-Vorbereitung ein
CI Feature / test (push) Successful in 1m41s
Deploy Test / test (push) Successful in 2m2s
Deploy Test / deploy (push) Successful in 29s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 22:50:59 +01:00
LarsandClaude Sonnet 5.5 c61869f8aa Setze die Trailer-Schaltfläche nach oben rechts
CI Feature / test (push) Successful in 1m59s
Deploy Test / test (push) Successful in 1m42s
Deploy Test / deploy (push) Successful in 26s
Unten links lag sie in der Redaktionsvorschau über dem Hinweis
"Bibliotheksbild nur Vorschau"; bei schmalen Karten überlappten beide.
Oben rechts ist der Bildbereich frei, auch auf der Filmtafel.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 22:39:56 +01:00
LarsandClaude Sonnet 5.5 08d03d0f56 Lege die Website-Datei eines Films über die Warteschlange ab und erlaube sie auch nachträglich
CI Feature / test (push) Successful in 1m55s
Deploy Test / test (push) Successful in 1m49s
Deploy Test / deploy (push) Successful in 28s
Der Web-Prozess hat derived/ nur lesend; das Anlegen als eigenständiges Präsentationsmedium
schrieb dort selbst und scheiterte auf den Servern (die Tests fakten die Disk). Jetzt prüft
PresentationFile nur und übergibt das Kopieren an StorePresentationFile; ein Fehler steht am
Medium. Die Prüfung läuft vor dem Anlegen, sodass keine leere Hülle zurückbleibt, und nennt
das Format (MOV und M4V sind keine Website-Dateien).

Am Medium gibt es unter Website-Freigabe die Website-Datei zum nachträglichen Hochladen, auch
bei einem Film mit geschützter Fassung (ungeschützter Trailer). Die Fassung bleibt unverändert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 22:23:09 +01:00
LarsandClaude Sonnet 5.5 ea4244487f Spiele den freigegebenen Trailer auf Medien-, Programm- und Modulkarten ab
CI Feature / test (push) Successful in 2m55s
Deploy Test / test (push) Successful in 1m56s
Deploy Test / deploy (push) Successful in 28s
Die Karte spielt den für die Website freigegebenen Trailer (Rolle Trailer, sonst
Vorschauclip, bei einem Film ersatzweise sein Teaser) stumm beim Überfahren mit
der Maus ab, am Handy mit Tippen, per Tastatur über die Schaltfläche. Reduzierte
Bewegung und Datensparmodus starten nichts von selbst; der Clip wird erst beim
ersten Start geladen. Ohne Freigabe bleibt das Kartenbild, die Redaktionsvorschau
nennt den Grund. Neue Einstellung "Trailer auf der Karte" je Karte (ADR-43).

Die Route website.media beantwortet Bereichsabrufe (206/416) für Filme und
Hörstücke, damit Safari und iOS abspielen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 22:12:51 +01:00
LarsandClaude Sonnet 5.5 fc40aba26c Ergänze die Release-Vorbereitung um Shop-Fakten, Umgebungsschlüssel und den Migrationsvergleich.
CI Feature / test (push) Successful in 1m47s
Deploy Test / test (push) Successful in 1m45s
Deploy Test / deploy (push) Successful in 34s
Der Shop ist in Produktion durch EnsureShopEnabled gesperrt (APP_ENV=production, 404). Keine neuen Umgebungs-
schlüssel; genau fünf Migrationen ausstehend; Prod hat keine Bestellungen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 21:34:42 +01:00
LarsandClaude Sonnet 5.5 32837639e6 Berichte die Programm- und Modulkarte und bereite die Übergabe nach Prod vor.
CI Feature / test (push) Successful in 1m34s
Bericht mit Prüfergebnissen von luf-test und die Release-Vorbereitung develop → main: Inhalt, Migrationen,
Prod-Stand (lesend geprüft) und die Entscheidungen, die Lars vor dem Merge trifft. Der Merge selbst bleibt
ein manueller Schritt von Lars.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 21:31:38 +01:00
LarsandClaude Sonnet 5.5 3825f53a9b Wähle den Kartentext auch an der Programm- und Modulkarte und führe den Filmbild-Regler nach.
CI Feature / test (push) Successful in 1m46s
Deploy Test / test (push) Successful in 1m45s
Deploy Test / deploy (push) Successful in 36s
- Programm- und Modulkarte: „Text der Karte“ (Automatisch wie bisher: Teaser, sonst Kurzbeschreibung, sonst
  Lernziel; Teaser, Kurzbeschreibung, Ausführliche Beschreibung, Lernziel der Fassung). Eine ausdrückliche Wahl
  ersetzt nicht still; die Vorschau nennt, wo der Text zu pflegen ist. Das Vorschaubild des Programms oder Moduls
  lässt sich als Bild-Medium übernehmen (CompositionStill, additive Tabelle composition_still_sources).
- Filmbild im Dialog wie im Medienmanager: Regler und Zahlenfeld zeigen dieselbe Stelle, das Bild folgt dem Regler
  nach kurzer Pause, „Diese Stelle übernehmen“; das Vorschaubild des Films mit kleiner Ansicht daneben.
- Gemeinsame Meldung nach dem tatsächlichen Stand für Film- und Programmbilder.
- Test bewusst angepasst: Die Programmkarte hat jetzt eine Textwahl (vorher nur die Medienkarte).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 21:19:43 +01:00
301 changed files with 15769 additions and 1517 deletions

No files matched your search

+90
View File
@@ -0,0 +1,90 @@
<?php
namespace App\Domain\Catalog;
/**
* Berechtigter Nutzerkreis einer Lizenzoption: Einzellizenz (ein Trainer) oder Mehrfachlizenz (festgelegte Zahl von
* Trainern). Das ist eine vertragliche Angabe der Lizenzoption. Sie ist unabhängig vom Lizenzinhaber (Person oder
* Verein), vom technischen Downloadzugriff (nur das bestellende Konto) und vom Nutzungszweck (ehrenamtlich,
* kommerziell, institutionell). Sie wird weder aus dem Zweck noch aus dem Preis abgeleitet.
*/
final class LicenceScope
{
public const SINGLE = 'einzel';
public const MULTI = 'mehrfach';
/** Obergrenze der Trainerzahl einer Mehrfachlizenz (Eingabeschutz). */
public const MAX_TRAINERS = 999;
/**
* @return array{0: ?string, 1: ?int} Nutzerkreis und Trainerzahl, geprüft und vereinheitlicht
*/
public static function normalise(?string $scope, mixed $trainers): array
{
$scope = filled($scope) ? (string) $scope : null;
if ($scope === null) {
if (filled($trainers)) {
throw new DomainRuleException('Die Trainerzahl gehört zu einer Einzel- oder Mehrfachlizenz. Wähle zuerst den Nutzerkreis.');
}
return [null, null];
}
if ($scope === self::SINGLE) {
if (filled($trainers) && (int) $trainers !== 1) {
throw new DomainRuleException('Eine Einzellizenz gilt für genau einen Trainer.');
}
return [self::SINGLE, 1];
}
if ($scope === self::MULTI) {
$count = filled($trainers) ? (int) $trainers : 0;
if ($count < 2 || $count > self::MAX_TRAINERS) {
throw new DomainRuleException('Eine Mehrfachlizenz gilt für mindestens 2 und höchstens '.self::MAX_TRAINERS.' Trainer. Gib die Zahl der Trainer an.');
}
return [self::MULTI, $count];
}
throw new DomainRuleException('Der Nutzerkreis ist Einzellizenz oder Mehrfachlizenz.');
}
/** Kurzform: „Einzellizenz · 1 Trainer“, „Mehrfachlizenz · bis zu 5 Trainer“ oder „keine Angabe“. */
public static function label(?string $scope, ?int $trainers): string
{
return match ($scope) {
self::SINGLE => 'Einzellizenz · 1 Trainer',
self::MULTI => 'Mehrfachlizenz · bis zu '.(int) $trainers.' Trainer',
default => 'Nutzerkreis nicht festgelegt',
};
}
/** Erklärung für Käufer: was der Umfang bedeutet und was er nicht bedeutet. */
public static function explanation(?string $scope, ?int $trainers): ?string
{
return match ($scope) {
self::SINGLE => 'Die Inhalte dürfen von einem Trainer eingesetzt werden.',
self::MULTI => 'Die Inhalte dürfen von bis zu '.(int) $trainers.' Trainern eingesetzt werden. Zugriff und Download erhält zum Start nur das bestellende Konto.',
default => null,
};
}
/** Wert für Vergleich identischer Lizenzen („Bereits erworben“). */
public static function key(?string $scope, ?int $trainers): string
{
return ($scope ?? '-').'|'.($trainers ?? 0);
}
/** @return array<string, string> */
public static function options(): array
{
return [
self::SINGLE => 'Einzellizenz (ein Trainer)',
self::MULTI => 'Mehrfachlizenz (mehrere Trainer)',
];
}
}
+8
View File
@@ -12,8 +12,16 @@ class Offer extends Model
'name',
'composition_id',
'option_label',
'standalone_bundle',
];
protected function casts(): array
{
return [
'standalone_bundle' => 'boolean',
];
}
/** Komposition, deren öffentliche Seite die Produktseite dieser Lizenzoption ist. */
public function composition(): BelongsTo
{
+42 -1
View File
@@ -102,10 +102,18 @@ public function activate(Offer $offer, array $lines, array $attributes = []): Of
'dynamic' => false,
'grant_kind' => 'kauf',
'holder_kind' => 'person',
'licence_scope' => null,
'trainer_count' => null,
], $attributes);
if ($offer->standalone_bundle && (count($lines) !== 1 || ! $lines[0]['target'] instanceof BundleVersion)) {
throw new DomainRuleException('Ein Angebot mit eigener Paketseite besteht aus genau einer Paketfassung. Wähle eine Paketfassung oder ordne das Angebot der Seite eines Programms zu.');
}
$this->assertAttributes($attributes);
[$attributes['licence_scope'], $attributes['trainer_count']] = LicenceScope::normalise($attributes['licence_scope'], $attributes['trainer_count']);
$scope = $this->scopeFor($lines);
$this->assertSellableContent($scope);
$this->assertCoverage($lines, $attributes);
return DB::transaction(function () use ($offer, $lines, $attributes, $scope): OfferVersion {
@@ -126,6 +134,8 @@ public function activate(Offer $offer, array $lines, array $attributes = []): Of
'dynamic' => $attributes['dynamic'],
'grant_kind' => $attributes['grant_kind'],
'holder_kind' => $attributes['holder_kind'],
'licence_scope' => $attributes['licence_scope'],
'trainer_count' => $attributes['trainer_count'],
]);
foreach (array_values($lines) as $index => $line) {
@@ -176,13 +186,18 @@ public function end(Offer $offer): OfferVersion
* Produktzuordnung der Option: Die Komposition bestimmt die öffentliche Produktseite und die Alternativgruppe,
* die Bezeichnung benennt die Option auf dieser Seite. Beides sind keine bindenden Konditionen.
*/
public function assignProduct(Offer $offer, ?int $compositionId, ?string $optionLabel): Offer
public function assignProduct(Offer $offer, ?int $compositionId, ?string $optionLabel, bool $ownBundlePage = false): Offer
{
if ($compositionId !== null) {
Composition::query()->findOrFail($compositionId);
}
if ($ownBundlePage && $compositionId !== null) {
throw new DomainRuleException('Ein Paket hat entweder eine eigene Paketseite oder die Seite eines Programms, nicht beides.');
}
$offer->composition_id = $compositionId;
$offer->standalone_bundle = $ownBundlePage;
$offer->option_label = filled($optionLabel) ? trim((string) $optionLabel) : null;
$offer->save();
@@ -219,6 +234,32 @@ private function assertAttributes(array $attributes): void
}
}
/**
* Ein Angebot ohne verkaufbaren Inhalt wird nicht aktiviert: Jeder Lizenzartikel des Umfangs braucht einen
* veröffentlichten Stand, sonst erhielten Käufer nichts. Die Prüfung liegt im Domänenmodell, nicht nur in der
* Maske, damit auch jeder andere Weg (Skript, Import) sie durchläuft.
*
* @param list<array{license_article_id: int, rights_profile_version_id: int}> $scope
*/
private function assertSellableContent(array $scope): void
{
$ids = array_values(array_unique(array_column($scope, 'license_article_id')));
$missing = LicenseArticle::query()->with('currentRelease')->whereIn('id', $ids)->orderBy('code')->get()
->filter(fn (LicenseArticle $article): bool => ! ($article->currentRelease instanceof ArticleRelease
&& StatusValue::of($article->currentRelease->status) === ReleaseStatus::Veroeffentlicht->value));
if ($missing->isEmpty()) {
return;
}
$names = $missing->map(fn (LicenseArticle $article): string => '„'.($article->working_title ?: $article->code).'“ ('.$article->code.')')->implode(', ');
throw new DomainRuleException(($missing->count() === 1 ? 'Der Lizenzartikel ' : 'Die Lizenzartikel ').$names
.($missing->count() === 1 ? ' hat' : ' haben')
.' noch keinen veröffentlichten Stand und vergibt'.($missing->count() === 1 ? '' : ' keine').' keine Inhalte. '
.'Lege zuerst am Artikel den Inhalt fest, bevor das Angebot aktiviert wird.');
}
/**
* @param list<array{target: LicenseArticle|BundleVersion, rights: RightsProfileVersion}> $lines
* @return list<array{license_article_id: int, rights_profile_version_id: int}>
+2
View File
@@ -19,6 +19,8 @@ class OfferVersion extends Model
'dynamic',
'grant_kind',
'holder_kind',
'licence_scope',
'trainer_count',
'activated_at',
];
@@ -265,6 +265,13 @@ public function subject(mixed $id, bool $includeNonPublic): ?CardSubject
$profile = app(EditorialProfileReader::class)->read($composition, 'kachel');
$summary = $profile->value('teaser') ?: $profile->value('summary');
$goal = filled($version?->learning_goal) ? trim((string) $version->learning_goal) : null;
// Zentrale Texte, aus denen die Redaktion den Kartentext wählen kann (Zielgruppe „Öffentliche Kachel“).
$texts = [
'teaser' => $profile->value('teaser'),
'summary' => $profile->value('summary'),
'description' => $profile->value('description'),
'goal' => $goal,
];
$missing = [];
if ($summary === null) {
@@ -313,6 +320,7 @@ public function subject(mixed $id, bool $includeNonPublic): ?CardSubject
visualLabel: $kind,
previewImage: $includeNonPublic ? ThumbnailRef::url('editorial.card', 'komposition', (int) $composition->id, $composition->thumbnail_path) : null,
missing: $missing,
texts: $texts,
);
}
@@ -8,11 +8,13 @@
use App\Domain\Catalog\EditorialProfileReader;
use App\Domain\Catalog\StructureNode;
use App\Domain\Media\ThumbnailRef;
use App\Domain\Media\WebsiteMedia;
/**
* Lesesicht „Medien und Materialien“ für Premium-Karten (Website-CMS-Zielarchitektur 6.2).
*
* Auswahl in der Redaktion: jedes nicht archivierte Inhaltselement mit mindestens einer nicht gesperrten Fassung.
* Auswahl in der Redaktion: jedes nicht archivierte Inhaltselement mit mindestens einer nicht gesperrten Fassung, dazu
* jeder Film, der nur aus einer Website-Datei besteht (Medium ohne Inhaltsfassung, z. B. ein Teaser).
*
* Öffentliche Sichtbarkeit (Übergangsregel, solange öffentliche Fachobjektprofile nach ADR-29 fehlen):
* Ein Medium hat keine eigene öffentliche Seite. Öffentlich genannt wird es heute nur als Bestandteil der gezeigten
@@ -20,13 +22,17 @@
* öffentlich, mit Verweis auf diese Programmseite, und nur mit bereitgestellter Fassung. Traineranleitungen erscheinen
* nie öffentlich (vertraulich für Trainerinnen und Trainer).
*
* Ein Film nur mit Website-Datei hat weder Fassung noch Programm. Er erscheint öffentlich, sobald seine Website-Datei
* für die Website freigegeben ist (die Freigabe ist die ausdrückliche Entscheidung der Redaktion), ohne Verweis auf
* eine Programmseite und damit ohne Aktion. Ohne Freigabe bleibt er auf die Redaktionsvorschau beschränkt.
*
* Öffentlich gelesen werden Anzeigetitel (sonst Arbeitstitel), Inhaltsart und Ausgabeart sowie einer der Texte
* Teaser, Kurzbeschreibung oder ausführliche Beschreibung. Welcher Text erscheint, entscheidet die Redaktion je Karte
* (Einstellung „Text der Karte“); ohne Wahl gilt die Kurzbeschreibung, sonst der Teaser. Die ausführliche Beschreibung
* erscheint nur, wenn die Redaktion sie ausdrücklich wählt. Nie: Einsatzhinweis, Lizenzvermerk, Dateien, Lehrtexte,
* Ausgabeadressen. Das Vorschaubild der Bibliothek ist nicht für die Website freigegeben; es erscheint nur in der
* Redaktionsvorschau und kann in der Karte ausdrücklich als Website-Bild übernommen werden (FilmStill).
* Eine Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei.
* Eine Karte spielt höchstens den für die Website freigegebenen Trailer ab (CardClip), bietet keinen Download und gibt kein Medium frei.
*/
class PublicMaterialReader
{
@@ -44,14 +50,36 @@ public function __construct(
public function isSelectable(ContentElement $element): bool
{
return $element->archived_at === null
&& $element->versions()->where('status', '!=', ContentVersionStatus::Gesperrt->value)->exists();
&& ($element->versions()->where('status', '!=', ContentVersionStatus::Gesperrt->value)->exists()
|| $this->isWebsiteOnlyFilm($element));
}
/**
* Ein Film ohne jede Inhaltsfassung, der nur die Website-Datei (`teaser/…`) hat, zum Beispiel ein Teaser. Er kann
* auf der Medienkarte gewählt werden; was daraus öffentlich wird, bestimmt allein die Freigabe der Datei.
*/
public function isWebsiteOnlyFilm(ContentElement $element): bool
{
return $element->output_class === 'film'
&& filled($element->preview_path)
&& ! $element->versions()->exists();
}
public function isReady(ContentElement $element): bool
{
if ($this->isWebsiteOnlyFilm($element)) {
return $this->isWebsiteReleased($element);
}
return $element->versions()->where('status', ContentVersionStatus::Bereit->value)->exists();
}
/** Die Website-Datei des Films ist freigegeben und wird tatsächlich ausgeliefert (WebsiteMedia). */
private function isWebsiteReleased(ContentElement $element): bool
{
return app(WebsiteMedia::class)->present($element)?->kind === 'film';
}
/**
* Öffentliches Programm, in dessen gezeigter Fassung das Element vorkommt, sonst null.
*
@@ -67,7 +95,7 @@ public function isPublic(ContentElement $element): bool
return $this->isSelectable($element)
&& $this->isReady($element)
&& ! in_array($element->editorialContentKind?->slug, self::CONFIDENTIAL_KINDS, true)
&& $this->publicProgramFor($element) !== null;
&& ($this->publicProgramFor($element) !== null || $this->isWebsiteOnlyFilm($element));
}
/**
@@ -80,7 +108,13 @@ public function search(?string $term, int $limit = 25): array
$candidates = ContentElement::query()
->with('editorialContentKind')
->whereNull('archived_at')
->where(fn ($selectable) => $selectable
->whereHas('versions', fn ($query) => $query->where('status', '!=', ContentVersionStatus::Gesperrt->value))
->orWhere(fn ($websiteOnly) => $websiteOnly
->where('output_class', 'film')
->whereNotNull('preview_path')
->where('preview_path', '!=', '')
->whereDoesntHave('versions')))
->when($term !== '', function ($query) use ($term): void {
$like = '%'.mb_strtolower($term).'%';
$query->where(fn ($inner) => $inner
@@ -167,11 +201,12 @@ public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?
$title = (string) $profile->value('display_title');
}
$websiteOnly = $this->isWebsiteOnlyFilm($element);
$meta = [$output];
if ($program !== null) {
$meta[] = 'Im Programm „'.$program['title'].'“';
}
if ($film) {
if ($film && ! $websiteOnly) {
$meta[] = 'Vollständiger Film nur mit Lizenz im Mitgliederbereich';
}
@@ -220,7 +255,11 @@ public function visibilityNote(ContentElement $element): string
if ($this->isPublic($element)) {
$program = $this->publicProgramFor($element);
return 'Öffentlich nur als Teil der Programmseite „'.($program['title'] ?? '').'“. Die Mediendatei wird dabei nicht ausgeliefert.';
if ($program === null) {
return 'Öffentlich mit der für die Website freigegebenen Datei, ohne Verweis auf eine Programmseite. Die Originaldatei wird nie ausgeliefert.';
}
return 'Öffentlich nur als Teil der Programmseite „'.$program['title'].'“. Die Mediendatei wird dabei nicht ausgeliefert.';
}
return $this->notice($element, $this->publicProgramFor($element));
@@ -233,6 +272,7 @@ private function notice(ContentElement $element, ?array $program): string
{
$reason = match (true) {
in_array($element->editorialContentKind?->slug, self::CONFIDENTIAL_KINDS, true) => 'Traineranleitungen erscheinen nie öffentlich.',
$this->isWebsiteOnlyFilm($element) => 'Die Website-Datei ist nicht für die Website freigegeben (Medium öffnen → Reiter „Website“ → freigeben).',
! $this->isReady($element) => 'Das Medium hat noch keine bereitgestellte Fassung.',
$program === null => 'Das Medium gehört zu keinem öffentlich gezeigten Programm. Medien haben noch keine eigene öffentliche Freigabe (öffentliches Profil, ADR-29).',
default => 'Das Medium ist nicht öffentlich.',
@@ -243,9 +283,14 @@ private function notice(ContentElement $element, ?array $program): string
private function optionLabel(ContentElement $element): string
{
$visibility = $this->isPublic($element)
? 'öffentlich über Programmseite'
: ($this->isReady($element) ? 'nur Redaktionsvorschau' : 'Entwurf, nur Redaktionsvorschau');
$visibility = match (true) {
$this->isWebsiteOnlyFilm($element) => $this->isPublic($element)
? 'öffentlich mit Website-Datei'
: 'Website-Datei nicht freigegeben, nur Redaktionsvorschau',
$this->isPublic($element) => 'öffentlich über Programmseite',
$this->isReady($element) => 'nur Redaktionsvorschau',
default => 'Entwurf, nur Redaktionsvorschau',
};
$kind = $element->editorialContentKind?->label ?: self::outputLabel((string) $element->output_class);
return (string) ($element->display_title ?: $element->working_title).' · '.$kind.' · '.$visibility;
@@ -0,0 +1,98 @@
<?php
namespace App\Domain\Cms\Widgets\Support;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\PresentationAssignment;
use App\Domain\Media\WebsiteMedia;
use Illuminate\Database\Eloquent\Model;
/**
* Der kurze Clip, den eine Premium-Karte beim Überfahren oder Antippen abspielt.
*
* Gelesen wird nur, was die Redaktion ohnehin für die Website freigegeben hat (WebsiteMedia, Route website.media):
* 1. der Trailer des Fachobjekts (Präsentationsrolle „Trailer“), sonst der Vorschauclip,
* 2. bei einem Film ersatzweise dessen eigener freigegebener Teaser.
* Der vollständige Film, die Originaldatei und nicht freigegebene Clips kommen nie über die Karte. Die Karte gibt
* nichts frei; ohne freigegebenen Clip bleibt es beim Kartenbild.
*
* In der Redaktionsvorschau erklärt `notice`, warum kein Clip läuft (zugeordnet, aber nicht freigegeben).
*/
class CardClip
{
/** Rollen in der Reihenfolge, in der ein Clip gesucht wird. */
public const ROLES = ['trailer', 'vorschauclip'];
public function __construct(private readonly WebsiteMedia $media) {}
/**
* @return array{url: string|null, title: string, source: string, notice: string|null, hint: string|null}
*/
public function for(Model $subject, bool $preview): array
{
$assigned = PresentationAssignment::query()
->with(['role', 'element'])
->where('subject_type', $subject->getMorphClass())
->where('subject_id', $subject->getKey())
->whereHas('role', fn ($query) => $query->whereIn('slug', self::ROLES))
->orderBy('position')
->orderBy('id')
->get()
->sortBy(fn (PresentationAssignment $row): int => (int) array_search($row->role?->slug, self::ROLES, true))
->values();
$unreleased = null;
foreach ($assigned as $assignment) {
$element = $assignment->element;
if (! $element instanceof ContentElement || $element->archived_at !== null || $element->output_class !== 'film') {
continue;
}
$present = $this->media->present($element);
if ($present !== null && $present->kind === 'film') {
return $this->found($present->url, $present->title, $assignment->role?->slug === 'trailer' ? 'trailer' : 'vorschauclip');
}
$unreleased ??= $element;
}
if ($subject instanceof ContentElement && $subject->output_class === 'film') {
$own = $this->media->present($subject);
if ($own !== null && $own->kind === 'film') {
return $this->found($own->url, $own->title, 'teaser');
}
}
if (! $preview) {
return $this->none();
}
if ($unreleased instanceof ContentElement) {
$title = (string) ($unreleased->display_title ?: $unreleased->working_title);
return $this->none('Der Trailer „'.$title.'“ ist nicht für die Website freigegeben; öffentlich bleibt es beim Kartenbild (Medium öffnen → Reiter „Website“ → freigeben).');
}
return $this->none(null, 'Kein Trailer zugeordnet; die Karte zeigt nur das Bild (Rolle „Trailer“ in der Präsentation des Mediums).');
}
/**
* @return array{url: string|null, title: string, source: string, notice: string|null, hint: string|null}
*/
private function found(string $url, string $title, string $source): array
{
return ['url' => $url, 'title' => $title, 'source' => $source, 'notice' => null, 'hint' => null];
}
/**
* @return array{url: string|null, title: string, source: string, notice: string|null, hint: string|null}
*/
private function none(?string $notice = null, ?string $hint = null): array
{
return ['url' => null, 'title' => '', 'source' => 'none', 'notice' => $notice, 'hint' => $hint];
}
}
@@ -0,0 +1,137 @@
<?php
namespace App\Domain\Cms\Widgets\Support;
use App\Domain\Catalog\ContentElement;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\WidgetErrors;
/**
* Das Video des Einstiegs (Hero): ein stummer Clip auf der Fläche des Fotos.
*
* Gewählt wird ein Film aus dem Medienmanager. Abgespielt wird nur, was die Redaktion für die Website freigegeben hat,
* und zwar nach derselben Regel wie auf der Karte (CardClip): Trailer des Films, sonst sein Vorschauclip, sonst seine
* eigene freigegebene Website-Datei. Der vollständige Film, die Originaldatei und nicht freigegebene Clips kommen nie
* über den Einstieg. Ohne freigegebenen Clip bleibt es beim Foto; die Auswahl gibt nichts frei.
*/
final class HeroVideo
{
public function __construct(
private readonly CardClip $clips,
private readonly PublicMaterialReader $materials,
) {}
/**
* Auswahlliste: Filme, die auf der Website gezeigt werden dürfen, mit dem Stand ihrer Freigabe.
*
* @return array<int, string>
*/
public function options(?string $term, int $limit = 25): array
{
$term = trim((string) $term);
$candidates = ContentElement::query()
->with('editorialContentKind')
->where('output_class', 'film')
->whereNull('archived_at')
->when($term !== '', function ($query) use ($term): void {
$like = '%'.mb_strtolower($term).'%';
$query->where(fn ($inner) => $inner
->whereRaw('LOWER(working_title) LIKE ?', [$like])
->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like]));
})
->orderBy('working_title')
->limit($limit * 2)
->get();
$options = [];
foreach ($candidates as $element) {
if (! $this->allowed($element)) {
continue;
}
$options[$element->id] = $this->label($element);
if (count($options) >= $limit) {
break;
}
}
return $options;
}
public function labelFor(mixed $id): ?string
{
$element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null;
return $element instanceof ContentElement ? $this->label($element) : null;
}
/**
* Prüft die gewählte Kennung. Gibt die Kennung zurück oder null, wenn keine gewählt ist oder die Wahl ungültig ist.
*/
public function clean(mixed $value, WidgetErrors $errors, string $key = 'refs.video'): ?int
{
if ($value === null || $value === '' || $value === false) {
return null;
}
$element = is_numeric($value) ? ContentElement::query()->with('editorialContentKind')->find((int) $value) : null;
if (! $element instanceof ContentElement || ! $this->allowed($element)) {
$errors->add($key, 'Bitte einen Film aus dem Medienmanager wählen (nicht archiviert, nicht gesperrt, keine Traineranleitung).');
return null;
}
return $element->id;
}
/**
* @return array{url: string|null, title: string, notice: string|null}
*/
public function resolve(mixed $id, bool $preview): array
{
$element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null;
if (! $element instanceof ContentElement) {
return ['url' => null, 'title' => '', 'notice' => null];
}
$title = (string) ($element->display_title ?: $element->working_title);
if (! $this->allowed($element)) {
return ['url' => null, 'title' => $title, 'notice' => $preview ? 'Das gewählte Medium „'.$title.'“ ist archiviert oder gesperrt; es erscheint kein Video.' : null];
}
$clip = $this->clips->for($element, $preview);
if ($clip['url'] !== null) {
return ['url' => $clip['url'], 'title' => $clip['title'] !== '' ? $clip['title'] : $title, 'notice' => null];
}
return [
'url' => null,
'title' => $title,
'notice' => $preview
? 'Für „'.$title.'“ gibt es kein für die Website freigegebenes Video (Trailer, Vorschauclip oder freigegebene Website-Datei des Mediums); öffentlich bleibt es beim Foto. Freigabe: Medium öffnen → Reiter „Website“.'
: null,
];
}
/** Ein Film, der nicht archiviert, nicht gesperrt und keine Traineranleitung ist. */
private function allowed(ContentElement $element): bool
{
return $element->output_class === 'film'
&& $this->materials->isSelectable($element)
&& ! in_array($element->editorialContentKind?->slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true);
}
private function label(ContentElement $element): string
{
$state = $this->clips->for($element, false)['url'] !== null ? 'Video freigegeben' : 'noch kein freigegebenes Video';
return (string) ($element->display_title ?: $element->working_title).' · '.$state;
}
}
+41 -6
View File
@@ -3,12 +3,14 @@
namespace App\Domain\Cms\Widgets\Types;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\HeroVideo;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PremiumFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Group;
@@ -20,6 +22,10 @@
* Containerbreite), Label, Überschriftenebene, Bildfokus in Prozent, Akzent, zwei Schaltflächen.
* Die data-Schlüssel der Version 1 (heading, text, cta_*, alt) bleiben unverändert, damit ältere Revisionen und ein
* Code-Rollback darstellbar bleiben.
*
* Optional ein Video (refs.video, ein Film aus dem Medienmanager): In der Variante „Foto mit Textfläche“ läuft ein
* stummer, für die Website freigegebener Clip auf der Fläche des Fotos (HeroVideo, resources/js/hero-video.js). Neuer
* Schlüssel ohne Versionssprung; ältere Revisionen ohne `video` bleiben unverändert darstellbar.
*/
class HeroWidget extends WidgetType
{
@@ -64,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)',
];
}
@@ -109,10 +115,18 @@ public function settings(): array
];
}
public function settingGroups(): array
{
return [
'Aussehen' => ['accent'],
'Seitenstruktur' => ['heading_level'],
];
}
public function settingLabels(): array
{
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.'],
];
}
@@ -152,7 +166,7 @@ public function dataRules(): array
public function refRules(): array
{
return ImageRefFields::rules();
return ImageRefFields::rules() + ['video' => ['nullable']];
}
public function dataFields(): array
@@ -169,7 +183,19 @@ public function dataFields(): array
public function refFields(): array
{
return ImageRefFields::fields(live: true);
return [...ImageRefFields::fields(live: true), $this->videoField()];
}
private function videoField(): Select
{
return Select::make('video')
->label('Video (optional)')
->helperText('Ein Film aus dem Medienmanager. Läuft stumm auf der Fläche des Fotos, nur in der Variante „Foto mit Textfläche“ und nur, wenn ein Trailer, Vorschauclip oder die Website-Datei des Films für die Website freigegeben ist. Das Foto bleibt als Rückfall, bei „reduzierte Bewegung“ und im Datensparmodus startet das Video nur auf Wunsch. Die Auswahl gibt nichts frei.')
->live()
->searchable()
->getSearchResultsUsing(fn (?string $search): array => app(HeroVideo::class)->options($search))
->getOptionLabelUsing(fn (mixed $value): ?string => app(HeroVideo::class)->labelFor($value))
->options(fn (): array => app(HeroVideo::class)->options(null));
}
public function editorSchema(): array
@@ -192,6 +218,8 @@ public function mediaSchema(): array
public function clean(array $data, array $refs, WidgetErrors $errors): array
{
$refs = ImageRefFields::clean($refs, $errors);
$video = app(HeroVideo::class)->clean($refs['video'] ?? null, $errors);
$video === null ? $refs = array_diff_key($refs, ['video' => true]) : $refs['video'] = $video;
$data['heading'] = trim((string) ($data['heading'] ?? ''));
$data['text'] = filled($data['text'] ?? null) ? trim((string) $data['text']) : null;
$data = PremiumFields::clean($data, $errors, $refs['image'] !== null);
@@ -205,8 +233,15 @@ public function resolve(array $widget, RenderContext $context): array
$images = app(WebsiteImage::class);
$image = $widget['refs']['image'] ?? null;
$video = app(HeroVideo::class)->resolve($widget['refs']['video'] ?? null, $context->preview);
$photoSplit = ($widget['variant'] ?? 'photo_split') !== 'editorial_solid';
if (! $photoSplit && $video['title'] !== '') {
$video = ['url' => null, 'title' => $video['title'], 'notice' => $context->preview ? 'Das Video erscheint nur in der Variante „Foto mit Textfläche“; die Markenfläche zeigt kein Video.' : null];
}
return [
'video' => $video,
'imageUrl' => $images->url($image, $context->preview),
'imageAlt' => $images->alt($image, $widget['data']['alt'] ?? null),
'imageNotice' => $context->preview ? $images->previewNotice($image) : null,
@@ -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)',
];
}
@@ -117,11 +117,19 @@ public function settings(): array
];
}
public function settingGroups(): array
{
return [
'Aussehen' => ['surface'],
'Seitenstruktur' => ['heading_level'],
];
}
public function settingLabels(): array
{
return [
'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.'],
];
}
@@ -8,14 +8,16 @@
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Media\FilmStill;
use App\Domain\Media\ThumbnailRef;
use Filament\Forms\Components\ViewField;
use Filament\Schemas\Components\Utilities\Get;
use Illuminate\Database\Eloquent\Model;
/**
* Medien- und Materialkarte (Kit v1.7 „media“): ein Inhaltselement mit Anzeigetitel, Kurzbeschreibung, Inhaltsart und
* Ausgabeart. Filme erscheinen als Medienkarte (grüne Aktion, Filmtafel ohne freigegebenes Bild), Dokumente und andere
* Materialien als Materialkarte (Materialsymbol). Öffentlich nur nach den Regeln von PublicMaterialReader; die Aktion
* führt auf die öffentliche Programmseite. Die Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei.
* führt auf die öffentliche Programmseite. Die Karte spielt höchstens den für die Website freigegebenen Trailer ab (CardClip), bietet keinen Download und gibt kein Medium frei.
*/
class MediaCardWidget extends PremiumCardWidget
{
@@ -31,7 +33,7 @@ public function label(): string
public function description(): string
{
return 'Karte zu einem Film oder Material aus der Bibliothek; Titel und Art kommen aus den Fachdaten, kein Abspielen, kein Download.';
return 'Karte zu einem Film oder Material aus der Bibliothek; Titel und Art kommen aus den Fachdaten, Trailer nur wenn freigegeben, kein Download.';
}
public function icon(): string
@@ -56,7 +58,7 @@ protected function refLabel(): string
protected function refHelp(): string
{
return 'Wählbar sind alle nicht archivierten, nicht gesperrten Filme und Materialien. Öffentlich erscheint die Karte nur mit bereitgestellter Fassung und wenn der Inhalt zu einem öffentlich gezeigten Programm gehört; Traineranleitungen nie. Titel, Teaser, Kurzbeschreibung und Beschreibung pflegen Sie im Medium; welcher Text auf der Karte erscheint, wählen Sie unter „Darstellung“.';
return 'Wählbar sind alle nicht archivierten, nicht gesperrten Filme und Materialien. Öffentlich erscheint die Karte nur mit bereitgestellter Fassung und wenn der Inhalt zu einem öffentlich gezeigten Programm gehört; ein Film nur mit Website-Datei (zum Beispiel ein Teaser) erscheint, sobald diese Datei für die Website freigegeben ist. Traineranleitungen nie. Titel, Teaser, Kurzbeschreibung und Beschreibung pflegen Sie im Medium; welcher Text auf der Karte erscheint, wählen Sie unter „Darstellung“.';
}
protected function searchSubjects(?string $term): array
@@ -105,8 +107,18 @@ protected function imageSourceFields(): array
->view('filament.cms.filmbild-feld')
->dehydrated(false)
->visible(fn (Get $get): bool => $this->filmFor($get('element')) !== null)
->viewData(function (Get $get): array {
$film = $this->filmFor($get('element'));
->viewData(fn (Get $get): array => $this->filmFieldData($this->filmFor($get('element')))),
];
}
/**
* Anzeigedaten des Felds „Bild aus dem Film“. Die Stelle kommt aus der bereitgestellten Fassung, bei einem Film
* nur mit Website-Datei aus dieser (Route content.website-frame).
*
* @return array<string, mixed>
*/
protected function filmFieldData(?ContentElement $film): array
{
$stills = app(FilmStill::class);
$version = $film instanceof ContentElement ? $stills->version($film) : null;
@@ -114,11 +126,13 @@ protected function imageSourceFields(): array
'film' => $film,
'filmTitle' => $film instanceof ContentElement ? (string) ($film->display_title ?: $film->working_title) : '',
'filmVersionId' => $version?->id,
'filmWebsiteFrameUrl' => $film instanceof ContentElement && $version === null && $stills->websiteFile($film) !== null
? route('content.website-frame', ['element' => $film])
: null,
'filmHasThumbnail' => $film instanceof ContentElement && is_string($film->thumbnail_path) && $film->thumbnail_path !== '',
'filmThumbnailUrl' => $film instanceof ContentElement ? ThumbnailRef::url('editorial.card', 'element', (int) $film->id, $film->thumbnail_path) : null,
'filmStartSecond' => $film instanceof ContentElement ? ($stills->thumbnailSecond($film) ?? '0') : '0',
];
}),
];
}
private function filmFor(mixed $id): ?ContentElement
@@ -128,6 +142,11 @@ private function filmFor(mixed $id): ?ContentElement
return $element instanceof ContentElement && app(FilmStill::class)->refusal($element) === null ? $element : null;
}
protected function subjectNoun(): string
{
return 'Medium';
}
protected function textChoices(): array
{
return [
@@ -138,6 +157,18 @@ protected function textChoices(): array
];
}
protected function supportsClip(): bool
{
return true;
}
protected function clipSubject(mixed $id): ?Model
{
$element = is_numeric($id) ? ContentElement::query()->find((int) $id) : null;
return $element instanceof ContentElement ? $element : null;
}
protected function centralCoverId(mixed $id): ?int
{
$element = is_numeric($id) ? ContentElement::query()->find((int) $id) : null;
@@ -4,6 +4,7 @@
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Cms\Widgets\Support\CardClip;
use App\Domain\Cms\Widgets\Support\ImageRefFields;
use App\Domain\Cms\Widgets\Support\PremiumFields;
use App\Domain\Cms\Widgets\Support\PublicMedia;
@@ -15,6 +16,7 @@
use Filament\Forms\Components\TextInput;
use Filament\Schemas\Components\Group;
use Filament\Schemas\Components\Utilities\Get;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Str;
/**
@@ -33,13 +35,6 @@ abstract class PremiumCardWidget extends WidgetType
{
public const SHOW = ['yes' => 'Anzeigen', 'no' => 'Ausblenden'];
/** Hinweise der Redaktionsvorschau, wenn der gewählte zentrale Text nicht gepflegt ist. */
public const TEXT_MISSING = [
'teaser' => 'Kein Teaser gepflegt (Medium bearbeiten → Teaser).',
'summary' => 'Keine Kurzbeschreibung gepflegt (Medium bearbeiten → Kurzbeschreibung).',
'description' => 'Keine ausführliche Beschreibung gepflegt (Medium bearbeiten → Beschreibung).',
];
/** Schlüssel des Fachobjekts in refs, zum Beispiel 'pillar'. */
abstract protected function refKey(): string;
@@ -74,6 +69,15 @@ protected function imageSourceFields(): array
return [];
}
/**
* Fachobjekt, dessen Trailer die Karte beim Überfahren oder Antippen abspielt (Medium, Programm, Modul).
* Null: diese Karte hat keinen Clip (Thema). Der Clip kommt aus der Präsentation des Objekts (CardClip).
*/
protected function clipSubject(mixed $id): ?Model
{
return null;
}
/**
* Zentrale Texte des Fachobjekts, aus denen die Redaktion den Kartentext wählen kann: Wert => Bezeichnung.
* Leer: keine Wahl (die Karte nimmt den Text ihrer Vorgabe). Mit Wahl gilt „auto“ als Vorgabe.
@@ -85,6 +89,26 @@ protected function textChoices(): array
return [];
}
/** Was die Redaktion bearbeitet, um einen Text zu pflegen („Medium“, „Programm oder Modul“); für Hinweise. */
protected function subjectNoun(): string
{
return 'Objekt';
}
/** Hinweis der Redaktionsvorschau, wenn der gewählte zentrale Text nicht gepflegt ist. */
private function missingTextHint(string $field): string
{
$noun = $this->subjectNoun();
return match ($field) {
'teaser' => 'Kein Teaser gepflegt ('.$noun.' bearbeiten → Teaser).',
'summary' => 'Keine Kurzbeschreibung gepflegt ('.$noun.' bearbeiten → Kurzbeschreibung).',
'description' => 'Keine ausführliche Beschreibung gepflegt ('.$noun.' bearbeiten → Beschreibung).',
'goal' => 'Kein Lernziel gepflegt ('.$noun.' bearbeiten → Lernziel der Fassung).',
default => '',
};
}
public function view(): string
{
return 'widgets.premium_card';
@@ -141,7 +165,7 @@ public function settings(): array
{
$choices = $this->textChoices();
return ($choices === [] ? [] : ['text_source' => $choices]) + [
return ($choices === [] ? [] : ['text_source' => $choices]) + ($this->supportsClip() ? ['clip' => ['yes' => 'Abspielen', 'no' => 'Nicht abspielen'], 'show_body' => self::SHOW] : []) + [
'format' => ['landscape' => 'Querformat 16:9', 'square' => 'Quadrat 1:1', 'portrait' => 'Hochformat 3:4'],
'fit' => ['cover' => 'Ausschnitt füllt die Fläche', 'contain' => 'Ganzes Bild zeigen (Dokument, Poster)'],
'heading_level' => ['h3' => 'H3', 'h2' => 'H2', 'h4' => 'H4'],
@@ -152,17 +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
{
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', 'Vorgabe: Querformat 16:9. Gilt auch neben dem Text; das Motiv wird nicht nachträglich hochkant beschnitten.'],
'fit' => ['Bilddarstellung', 'Vorgabe: Ausschnitt. „Ganzes Bild“ zeigt Dokumente und Poster vollständig auf ruhiger Fläche.'],
'heading_level' => ['Überschriftenebene', 'Vorgabe: H3, passend unter einer Abschnittsüberschrift (H2).'],
'show_summary' => ['Text anzeigen', 'Aus den Fachdaten. Vorgabe: anzeigen.'],
'show_kind' => ['Art oder Label', 'Zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: anzeigen.'],
'show_meta' => ['Zusatzangaben', 'Aus den Fachdaten, zum Beispiel Ausgabeart oder Programmzugehörigkeit. Vorgabe: anzeigen.'],
'show_action' => ['Aktion', 'Verweis auf die öffentliche Seite des Fachobjekts, falls es eine gibt. Vorgabe: anzeigen.'],
'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.'],
'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.'],
'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.'],
'show_summary' => ['Beschreibung', 'Der Beschreibungstext unter dem Titel, aus den Fachdaten. Vorgabe: Anzeigen.'],
'show_kind' => ['Art-Label', 'Kleines Label über dem Titel, zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: Anzeigen.'],
'show_meta' => ['Zusatzangaben', 'Angaben aus den Fachdaten, zum Beispiel Ausgabeart oder Programmzugehörigkeit. Vorgabe: Anzeigen.'],
'show_action' => ['Schaltfläche', 'Verweis auf die öffentliche Seite des Fachobjekts, falls es eine gibt. 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).'],
];
}
@@ -283,7 +324,7 @@ public function resolve(array $widget, RenderContext $context): array
$textSource = $option('text_source', 'auto');
if ($subject instanceof CardSubject && $textSource !== 'auto' && isset($this->textChoices()[$textSource])) {
$subject = $subject->withTextChoice($textSource, self::TEXT_MISSING[$textSource] ?? '');
$subject = $subject->withTextChoice($textSource, $this->missingTextHint($textSource));
}
$heading = filled($data['heading'] ?? null) ? trim((string) $data['heading']) : null;
@@ -296,8 +337,16 @@ public function resolve(array $widget, RenderContext $context): array
$storedImage = WebsiteImage::normalize($widget['refs']['image'] ?? null);
$imageRef = $storedImage ?? $this->centralCoverId($widget['refs'][$this->refKey()] ?? null);
$clip = null;
if ($this->supportsClip() && $option('clip', 'yes') === 'yes' && $subject instanceof CardSubject) {
$owner = $this->clipSubject($widget['refs'][$this->refKey()] ?? null);
$clip = $owner instanceof Model ? app(CardClip::class)->for($owner, $context->preview) : null;
}
return [
'subject' => $subject,
'clip' => $clip,
'cardStyle' => $subject?->style ?? $this->cardStyle(),
'imageUrl' => app(WebsiteImage::class)->url($imageRef, $context->preview),
'alt' => app(WebsiteImage::class)->alt($imageRef, $data['alt'] ?? null),
@@ -315,6 +364,7 @@ public function resolve(array $widget, RenderContext $context): array
'actionLabel' => filled($data['action_label'] ?? null) ? (string) $data['action_label'] : $this->defaultActionLabel(),
'note' => filled($data['note'] ?? null) ? (string) $data['note'] : null,
'stacked' => $widget['variant'] === 'stacked',
'bare' => $this->supportsClip() && $option('show_body', 'yes') === 'no',
];
}
@@ -337,6 +387,11 @@ protected function centralCoverId(mixed $id): ?int
return null;
}
protected function supportsClip(): bool
{
return false;
}
/**
* Zentraler Anzeigename oder Teaser des gewählten Objekts (Redaktionsstand) für Platzhalter im Editor.
*/
@@ -353,7 +408,7 @@ private function centralText(mixed $id, string $field, mixed $textSource = null)
}
if ($subject instanceof CardSubject && is_string($textSource) && isset($this->textChoices()[$textSource]) && $textSource !== 'auto') {
$subject = $subject->withTextChoice($textSource, self::TEXT_MISSING[$textSource] ?? '');
$subject = $subject->withTextChoice($textSource, $this->missingTextHint($textSource));
}
$text = $subject?->{$field};
@@ -7,6 +7,11 @@
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Media\CompositionStill;
use App\Domain\Media\ThumbnailRef;
use Filament\Forms\Components\ViewField;
use Filament\Schemas\Components\Utilities\Get;
use Illuminate\Database\Eloquent\Model;
/**
* Modul- und Programmkarte (Kit v1.7 „catalog“): ein Programm oder Modul über PublicCatalogReader, dieselbe
@@ -41,6 +46,59 @@ public function schematic(): array
return [[2, 2, 56, 32, 'line'], [5, 5, 22, 26, 'ink'], [8, 24, 10, 2, 'accent'], [31, 8, 10, 2, 'line'], [31, 13, 22, 4, 'ink'], [31, 25, 14, 5, 'ink']];
}
/**
* Das Vorschaubild des Programms oder Moduls als Kartenbild übernehmen. Es wird einmal als Bild-Medium abgelegt
* (CompositionStill) und wie jedes andere Bild ausgewählt; die Karte liest nur diese Datei.
*/
protected function imageSourceFields(): array
{
return [
ViewField::make('_programmbild')
->label('Bild aus dem Programm oder Modul')
->view('filament.cms.kompositionsbild-feld')
->dehydrated(false)
->visible(fn (Get $get): bool => $this->compositionFor($get('composition')) !== null)
->viewData(function (Get $get): array {
$composition = $this->compositionFor($get('composition'));
return [
'composition' => $composition,
'compositionTitle' => $composition instanceof Composition ? (string) ($composition->display_title ?: $composition->designation) : '',
'compositionThumbnailUrl' => $composition instanceof Composition && app(CompositionStill::class)->hasThumbnail($composition)
? ThumbnailRef::url('editorial.card', 'komposition', (int) $composition->id, $composition->thumbnail_path)
: null,
];
}),
];
}
private function compositionFor(mixed $id): ?Composition
{
$composition = is_numeric($id) ? Composition::query()->with('editorialContentKind')->find((int) $id) : null;
return $composition instanceof Composition && app(PublicCatalogReader::class)->isCardSelectable($composition) ? $composition : null;
}
protected function subjectNoun(): string
{
return 'Programm oder Modul';
}
/**
* Wählbare Texte: die zentralen Texte des Programms oder Moduls und das Lernziel der Fassung. „Automatisch“ bleibt
* wie bisher: Teaser, sonst Kurzbeschreibung, sonst Lernziel. Die ausführliche Beschreibung erscheint nur auf Wahl.
*/
protected function textChoices(): array
{
return [
'auto' => 'Automatisch (Teaser, sonst Kurzbeschreibung, sonst Lernziel)',
'teaser' => 'Teaser',
'summary' => 'Kurzbeschreibung',
'description' => 'Ausführliche Beschreibung (erscheint öffentlich)',
'goal' => 'Lernziel der Fassung',
];
}
public function settings(): array
{
// Die Art (Programm oder Modul) bleibt immer sichtbar; sie lässt sich nicht ausblenden.
@@ -99,6 +157,18 @@ protected function cardStyle(): string
return 'catalog';
}
protected function supportsClip(): bool
{
return true;
}
protected function clipSubject(mixed $id): ?Model
{
$composition = is_numeric($id) ? Composition::query()->find((int) $id) : null;
return $composition instanceof Composition ? $composition : null;
}
protected function centralCoverId(mixed $id): ?int
{
$composition = is_numeric($id) ? Composition::query()->find((int) $id) : null;
+24 -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',
@@ -194,6 +194,29 @@ public function settingLabels(): array
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
* verwenden ausschließlich diese Zusammenführung.
+62 -6
View File
@@ -6,6 +6,9 @@
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Domain\Commerce\Discount\DiscountResult;
use App\Domain\Commerce\Discount\DiscountService;
use App\Domain\Identity\Party;
use App\Domain\Identity\PartyType;
use App\Models\User;
@@ -20,6 +23,9 @@ class Cart
{
public const KEY = 'shop.cart';
/** Eingelöster Rabattcode (Kennung); höchstens einer je Bestellung. */
public const DISCOUNT_KEY = 'shop.discount';
public const ADDED = 'added';
public const PRESENT = 'present';
@@ -32,6 +38,7 @@ public function __construct(
private readonly OwnershipCheck $ownership,
private readonly OrderHolders $holders,
private readonly OfferService $offers,
private readonly DiscountService $discounts,
) {}
/**
@@ -57,7 +64,10 @@ public function has(Offer $offer): bool
*/
public function alternativeTo(Offer $offer): ?Offer
{
if ($offer->composition_id === null) {
$products = app(ProductOptions::class);
$group = $products->groupKey($offer);
if ($group === null) {
return null;
}
@@ -65,8 +75,8 @@ public function alternativeTo(Offer $offer): ?Offer
return $ids === [] ? null : Offer::query()
->whereIn('id', $ids)
->where('composition_id', $offer->composition_id)
->first();
->get()
->first(fn (Offer $other): bool => $products->groupKey($other) === $group);
}
public function add(Offer $offer): string
@@ -133,13 +143,51 @@ public function acceptCurrent(Offer $offer): void
public function clear(): void
{
session()->forget(self::KEY);
session()->forget([self::KEY, self::DISCOUNT_KEY]);
}
/** Der im Warenkorb eingelöste Code, auch wenn er gerade nicht (mehr) gilt. */
public function discountCode(): ?DiscountCode
{
$id = session()->get(self::DISCOUNT_KEY);
return is_numeric($id) ? DiscountCode::query()->with('targets')->find((int) $id) : null;
}
/**
* Löst einen Code ein. Er wird nur vorgemerkt, wenn er für diesen Warenkorb und dieses Konto gilt; sonst bleibt
* der bisherige Stand und das Ergebnis nennt den Grund. Ein zweiter Code ersetzt den ersten (höchstens ein Code).
*/
public function applyCode(string $input, ?User $user, ?int $holderPartyId = null): DiscountResult
{
$code = $this->discounts->find($input);
if ($code === null) {
return new DiscountResult(null, DiscountResult::UNKNOWN, 'Diesen Code kennen wir nicht. Prüfe die Schreibweise.');
}
$previous = session()->get(self::DISCOUNT_KEY);
session()->put(self::DISCOUNT_KEY, $code->id);
$result = $this->review($user, $holderPartyId)->discount;
if ($result === null || ! $result->applied()) {
$previous === null ? session()->forget(self::DISCOUNT_KEY) : session()->put(self::DISCOUNT_KEY, $previous);
return $result ?? new DiscountResult($code, DiscountResult::NO_MATCH, 'Der Code kann auf diese Bestellung nicht angewendet werden.');
}
return $result;
}
public function removeCode(): void
{
session()->forget(self::DISCOUNT_KEY);
}
/**
* Serverseitige Prüfung: aktuelle Fassung, Preis, Kaufbarkeit, passende Inhaberart, vorhandene Rechte.
*/
public function review(?User $user = null, ?int $holderPartyId = null): CartReview
public function review(?User $user = null, ?int $holderPartyId = null, bool $lockDiscount = false): CartReview
{
$offers = Offer::query()
->whereIn('id', array_keys($this->items()))
@@ -203,7 +251,15 @@ public function review(?User $user = null, ?int $holderPartyId = null): CartRevi
}
}
return new CartReview($lines, $holder);
$code = $this->discountCode();
$discount = null;
if ($code !== null) {
$orderable = array_values(array_filter($lines, fn (CartLine $line): bool => $line->orderable()));
$discount = $this->discounts->evaluate($code, $user, $orderable, lock: $lockDiscount);
}
return new CartReview($lines, $holder, $discount);
}
/**
+8
View File
@@ -45,6 +45,14 @@ public function blocks(): bool
public function title(): string
{
if ($this->offer->standalone_bundle && $this->version !== null) {
$bundle = app(ProductOptions::class)->bundleOf($this->version);
if ($bundle !== null) {
return (string) $bundle->name;
}
}
$composition = $this->offer->composition;
return $composition !== null
+29 -3
View File
@@ -2,6 +2,7 @@
namespace App\Domain\Commerce;
use App\Domain\Commerce\Discount\DiscountResult;
use App\Domain\Identity\Party;
/**
@@ -16,6 +17,7 @@ final class CartReview
public function __construct(
public readonly array $lines,
public readonly ?Party $holder,
public readonly ?DiscountResult $discount = null,
) {}
/** @return list<CartLine> */
@@ -24,11 +26,35 @@ public function orderable(): array
return array_values(array_filter($this->lines, fn (CartLine $line): bool => $line->orderable()));
}
public function totalCents(): int
/** Summe der Listenpreise der Positionen, die in die Bestellung eingehen. */
public function subtotalCents(): int
{
return array_sum(array_map(fn (CartLine $line): int => (int) $line->currentPriceCents, $this->orderable()));
}
public function discountCents(): int
{
return $this->discount?->totalCents() ?? 0;
}
/** Endgültiger Zahlbetrag: Listenpreise abzüglich Rabatt. */
public function totalCents(): int
{
return $this->subtotalCents() - $this->discountCents();
}
/** Rabatt einer Position in Cent. */
public function discountFor(CartLine $line): int
{
return $this->discount?->forOffer($line->offer->id) ?? 0;
}
/** Ein vorgemerkter Code, der jetzt nicht gilt, hält die Bestellung an, bis er entfernt wird. */
public function discountBlocks(): bool
{
return $this->discount !== null && ! $this->discount->applied();
}
public function blocked(): bool
{
foreach ($this->lines as $line) {
@@ -47,7 +73,7 @@ public function empty(): bool
public function canOrder(): bool
{
return $this->holder !== null && ! $this->blocked() && ! $this->empty();
return $this->holder !== null && ! $this->blocked() && ! $this->empty() && ! $this->discountBlocks();
}
public function digest(): string
@@ -60,6 +86,6 @@ public function digest(): string
sort($parts);
return hash('sha256', ($this->holder?->id ?? 0).'|'.implode(',', $parts));
return hash('sha256', ($this->holder?->id ?? 0).'|'.implode(',', $parts).'|'.($this->discount?->digestPart() ?? '-'));
}
}
+116 -14
View File
@@ -6,12 +6,15 @@
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Domain\Commerce\Stripe\StripeGateway;
use App\Domain\Entitlement\Acquisition;
use App\Domain\Entitlement\AcquisitionType;
use App\Domain\Entitlement\GrantIssuer;
use App\Domain\Entitlement\GrantStatus;
use App\Domain\Identity\AccountStatus;
use App\Domain\Identity\Party;
use App\Domain\Identity\PartyType;
use App\Mail\OrderConfirmed;
use App\Models\User;
use Illuminate\Support\Facades\DB;
@@ -32,6 +35,12 @@ public function place(User $user, Offer $offer): Order
{
$this->assertActive($user);
// Dieser Einzelkauf kennt weder Zustimmungen noch „Zahlungspflichtig bestellen“. Im Livebetrieb gibt es nur den
// Weg über die Kasse mit Pflichtangaben.
if (Shop::live()) {
throw new DomainRuleException('Bestelle über den Warenkorb und die Kasse.');
}
$version = $this->offers->currentActiveVersion($offer);
if ($version->grant_kind !== 'kauf' || $version->holder_kind !== 'person') {
@@ -44,7 +53,7 @@ public function place(User $user, Offer $offer): Order
$holder = $this->holders->resolve($user, null);
return DB::transaction(fn (): Order => $this->createOrder($user, $holder, [[$offer, $version]]));
return DB::transaction(fn (): Order => $this->createOrder($user, $holder, [[$offer, $version]], null, null, Shop::driver() === 'stripe' ? 'stripe' : 'test'));
}
/**
@@ -53,14 +62,25 @@ public function place(User $user, Offer $offer): Order
* Bestellung und der Käufer sieht zuerst die aktualisierte Übersicht. Positionen, deren Umfang der Inhaber bereits
* mit denselben Rechten besitzt, erzeugen keine Bestellposition.
*/
public function placeFromCart(User $user, Cart $cart, ?int $holderPartyId, string $digest): Order
public function placeFromCart(User $user, Cart $cart, ?int $holderPartyId, string $digest, ?array $consent = null, ?string $paymentMethod = null): Order
{
$this->assertActive($user);
$order = DB::transaction(function () use ($user, $cart, $holderPartyId, $digest): Order {
// Optionen sperren, damit eine gleichzeitige Aktivierung die Prüfung nicht unterläuft.
if ($consent === null && Shop::live()) {
throw new DomainRuleException('Bitte bestätige die Zustimmungen vor dem verbindlichen Abschluss.');
}
$order = DB::transaction(function () use ($user, $cart, $holderPartyId, $digest, $consent, $paymentMethod): Order {
// Optionen und den Rabattcode sperren, damit eine gleichzeitige Aktivierung, Deaktivierung oder ein Entzug
// der Freigabe die Prüfung nicht unterläuft.
Offer::query()->whereIn('id', array_keys($cart->items()))->orderBy('id')->lockForUpdate()->get();
$review = $cart->review($user, $holderPartyId);
$discountId = session()->get(Cart::DISCOUNT_KEY);
if (is_numeric($discountId)) {
DiscountCode::query()->whereKey((int) $discountId)->lockForUpdate()->first();
}
$review = $cart->review($user, $holderPartyId, lockDiscount: true);
if ($review->holder === null) {
throw new DomainRuleException('Für diesen Lizenzinhaber ist das Konto nicht bestellberechtigt.');
@@ -78,9 +98,19 @@ public function placeFromCart(User $user, Cart $cart, ?int $holderPartyId, strin
throw new DomainRuleException('Es gibt nichts zu bestellen. Alle Positionen sind bereits erworben.');
}
if ($review->discountBlocks()) {
throw new DomainRuleException(($review->discount?->message ?? 'Der Rabattcode gilt nicht.').' Entferne den Code, um ohne Rabatt zu bestellen.');
}
$method = $paymentMethod ?? (Shop::driver() === 'stripe' ? 'stripe' : 'test');
if ($method === 'rechnung' && ! ($review->holder->type === PartyType::Organisation && Shop::invoice())) {
throw new DomainRuleException('Der Kauf auf Rechnung ist nur für Vereine und Organisationen auf Anfrage möglich.');
}
$pairs = array_map(fn (CartLine $line): array => [$line->offer, $line->version], $review->orderable());
return $this->createOrder($user, $review->holder, $pairs);
return $this->createOrder($user, $review->holder, $pairs, $review, $consent === null ? null : SalesTerms::proof($consent), $method);
});
$cart->clear();
@@ -90,16 +120,28 @@ public function placeFromCart(User $user, Cart $cart, ?int $holderPartyId, strin
/**
* @param list<array{0: Offer, 1: OfferVersion}> $pairs
* @param array<string, mixed>|null $terms Nachweis der Zustimmungen (SalesTerms::proof)
*/
private function createOrder(User $user, Party $holder, array $pairs): Order
private function createOrder(User $user, Party $holder, array $pairs, ?CartReview $review, ?array $terms, string $method): Order
{
$subtotal = array_sum(array_map(fn (array $pair): int => (int) $pair[1]->price_cents, $pairs));
$discount = $review?->discount;
$discountCents = $review?->discountCents() ?? 0;
$order = Order::query()->create([
'user_id' => $user->id,
'party_id' => $holder->id,
'status' => 'offen',
'holder_kind' => $holder->type->value,
'total_cents' => array_sum(array_map(fn (array $pair): int => (int) $pair[1]->price_cents, $pairs)),
'subtotal_cents' => $subtotal,
'discount_cents' => $discountCents,
'total_cents' => $subtotal - $discountCents,
'currency' => 'EUR',
'discount_code_id' => $discountCents > 0 ? $discount?->code?->id : null,
'discount_snapshot' => $discountCents > 0 ? $discount?->snapshot() : null,
'payment_method' => $method,
'terms_accepted_at' => $terms === null ? null : now(),
'terms_snapshot' => $terms,
]);
foreach ($pairs as [$offer, $version]) {
@@ -114,6 +156,9 @@ private function createOrder(User $user, Party $holder, array $pairs): Order
'tax_class' => $version->tax_class,
'grant_kind' => $version->grant_kind,
'holder_party_id' => $holder->id,
'licence_scope' => $version->licence_scope,
'trainer_count' => $version->trainer_count,
'discount_cents' => $discountCents > 0 ? $discount->forOffer($offer->id) : 0,
]);
$version->load('resolvedScopes.rights');
@@ -140,6 +185,7 @@ private function createOrder(User $user, Party $holder, array $pairs): Order
public function confirmTestPayment(Order $order, string $reference): Order
{
$this->assertTestDriver();
$this->assertTestOrder($order);
return $this->settle($order, 'test', $reference);
}
@@ -150,7 +196,7 @@ public function confirmTestPayment(Order $order, string $reference): Order
*/
public function confirmProviderPayment(Order $order, string $provider, string $reference, int $amountCents, string $currency): Order
{
$expected = (int) ($order->total_cents ?? $order->lines()->sum('price_cents'));
$expected = (int) ($order->total_cents ?? $order->lines()->sum('price_cents') - $order->lines()->sum('discount_cents'));
if ($amountCents !== $expected || strtoupper($currency) !== strtoupper((string) ($order->currency ?? 'EUR'))) {
throw new DomainRuleException('Der gezahlte Betrag weicht von der Bestellung ab.');
@@ -159,7 +205,23 @@ public function confirmProviderPayment(Order $order, string $provider, string $r
return $this->settle($order, $provider, $reference);
}
private function settle(Order $order, string $provider, string $reference): Order
/**
* Kauf auf Rechnung (PAY-006): Der Betreiber hat die Rechnung manuell erstellt und bestätigt den Zahlungseingang.
* Nur für Bestellungen mit Zahlungsweg „Rechnung“; das Mitglied kann das nicht selbst auslösen. Die Referenz
* (Rechnungsnummer oder Buchung) wird an der Zahlung festgehalten.
*/
public function confirmInvoicePayment(Order $order, string $reference, User $actor): Order
{
$order->refresh();
if ($order->payment_method !== 'rechnung') {
throw new DomainRuleException('Nur eine Bestellung auf Rechnung wird manuell als bezahlt bestätigt.');
}
return $this->settle($order, 'ueberweisung', 'rechnung-'.trim($reference), $actor);
}
private function settle(Order $order, string $provider, string $reference, ?User $confirmedBy = null): Order
{
$reference = trim($reference);
@@ -168,7 +230,7 @@ private function settle(Order $order, string $provider, string $reference): Orde
}
$paidNow = false;
$order = DB::transaction(function () use ($order, $provider, $reference, &$paidNow): Order {
$order = DB::transaction(function () use ($order, $provider, $reference, $confirmedBy, &$paidNow): Order {
$order = Order::query()->lockForUpdate()->findOrFail($order->id);
if ($order->status === 'bezahlt') {
@@ -182,7 +244,7 @@ private function settle(Order $order, string $provider, string $reference): Orde
// Eine bei Stripe angelegte offene Zahlung mit derselben Referenz wird bestätigt statt doppelt geführt.
$order->payments()->updateOrCreate(
['provider_reference' => $reference],
['provider' => $provider, 'status' => 'bestaetigt'],
['provider' => $provider, 'status' => 'bestaetigt', 'amount_cents' => $order->payable(), 'confirmed_by' => $confirmedBy?->id],
);
$order->status = 'bezahlt';
$order->save();
@@ -207,6 +269,7 @@ private function settle(Order $order, string $provider, string $reference): Orde
public function failTestPayment(Order $order, string $reference): Order
{
$this->assertTestDriver();
$this->assertTestOrder($order);
return DB::transaction(function () use ($order, $reference): Order {
$order = Order::query()->lockForUpdate()->findOrFail($order->id);
@@ -229,9 +292,11 @@ public function failTestPayment(Order $order, string $reference): Order
/**
* Vollerstattung: widerruft die Berechtigungen aller Positionen dieser Bestellung. Andere Erwerbsquellen
* (kostenlose Vergabe, frühere Käufe) bleiben unberührt.
* (kostenlose Vergabe, frühere Käufe) bleiben unberührt. Bundles sind Rückgabeeinheiten; freiwillige
* Teilerstattungen gibt es zum Start nicht. Bei einer Zahlung über Stripe wird die Rückzahlung zuerst bei Stripe
* veranlasst; erst wenn Stripe sie annimmt, werden Rechte entzogen. Wirkt sie dort nicht, bleibt alles unverändert.
*/
public function refund(Order $order, string $reason): Order
public function refund(Order $order, string $reason, ?StripeGateway $stripe = null): Order
{
$reason = trim($reason);
@@ -239,6 +304,13 @@ public function refund(Order $order, string $reason): Order
throw new DomainRuleException('Eine Erstattung braucht eine Begründung.');
}
$current = Order::query()->findOrFail($order->id);
$stripePayment = $current->payments()->where('provider', 'stripe')->where('status', 'bestaetigt')->latest('id')->first();
if ($current->status === 'bezahlt' && $stripePayment !== null) {
($stripe ?? app(StripeGateway::class))->refund($current, $stripePayment, $reason);
}
return DB::transaction(function () use ($order, $reason): Order {
$order = Order::query()->lockForUpdate()->findOrFail($order->id);
@@ -270,6 +342,28 @@ public function refund(Order $order, string $reason): Order
});
}
/**
* Das Mitglied erklärt den Widerruf (Verkaufsstart: kein Selbstbedienungs-Widerruf). Es entzieht nichts und
* erstattet nichts; der Betreiber prüft den Fall (Erlöschen des Widerrufsrechts bei sofortiger Bereitstellung mit
* ausdrücklicher Zustimmung) und erstattet bei Bedarf in der Bestellverwaltung.
*/
public function requestWithdrawal(Order $order, string $note): Order
{
if (! in_array($order->status, ['bezahlt', 'offen'], true)) {
throw new DomainRuleException('Für diese Bestellung kann kein Widerruf erklärt werden.');
}
if ($order->withdrawal_requested_at !== null) {
return $order;
}
$order->withdrawal_requested_at = now();
$order->withdrawal_note = trim($note) !== '' ? trim($note) : null;
$order->save();
return $order;
}
private function assertActive(User $user): void
{
if ($user->status !== AccountStatus::Aktiv || $user->party_id === null) {
@@ -277,6 +371,14 @@ private function assertActive(User $user): void
}
}
/** Eine Bestellung auf Rechnung oder über Stripe wird nie mit der Testzahlung bestätigt. */
private function assertTestOrder(Order $order): void
{
if (in_array(Order::query()->whereKey($order->id)->value('payment_method'), ['rechnung', 'stripe'], true)) {
throw new DomainRuleException('Diese Bestellung wird nicht mit der Testzahlung bezahlt.');
}
}
private function assertTestDriver(): void
{
if (app()->isProduction() || config('services.payment.driver') !== 'test') {
@@ -0,0 +1,74 @@
<?php
namespace App\Domain\Commerce\Discount;
/**
* Reine Rechenregel für den Rabatt je Position (ganze Cent, keine Datenbank, keine Uhr).
*
* Prozent: je Position gerundet (kaufmännisch, ab 0,5 Cent nach oben), höchstens der Positionspreis. Die Summe ist
* die Summe der gerundeten Positionsrabatte. Das kann um bis zu einen Cent je Position von der Rundung auf der
* Warenkorbsumme abweichen (Rechenbeispiel in der Abnahme zum Verkaufsstart, Fachfrage).
*
* Betrag: Der Festbetrag gilt je Bestellung, höchstens bis zur Summe der betroffenen Positionen. Er wird anteilig
* zum Positionspreis verteilt; verbleibende Cent erhalten die Positionen mit dem größten Rest, bei Gleichstand die
* frühere Position.
*/
final class DiscountCalculator
{
/**
* @param array<int|string, int> $prices Schlüssel der Position => Preis in Cent (nur betroffene Positionen)
* @return array<int|string, int> Schlüssel => Rabatt in Cent
*/
public static function allocate(string $kind, ?int $percent, ?int $amountCents, array $prices): array
{
$discounts = array_fill_keys(array_keys($prices), 0);
if ($prices === []) {
return $discounts;
}
if ($kind === DiscountCode::PERCENT) {
$percent = max(0, min(100, (int) $percent));
foreach ($prices as $key => $price) {
$discounts[$key] = min($price, intdiv($price * $percent + 50, 100));
}
return $discounts;
}
$sum = array_sum($prices);
$total = min(max(0, (int) $amountCents), $sum);
if ($total === 0 || $sum === 0) {
return $discounts;
}
$remainders = [];
$given = 0;
foreach ($prices as $key => $price) {
$share = intdiv($total * $price, $sum);
$discounts[$key] = $share;
$remainders[$key] = ($total * $price) % $sum;
$given += $share;
}
$rest = $total - $given;
$order = array_keys($prices);
usort($order, fn ($left, $right): int => $remainders[$right] <=> $remainders[$left]);
foreach ($order as $key) {
if ($rest === 0) {
break;
}
if ($discounts[$key] < $prices[$key]) {
$discounts[$key]++;
$rest--;
}
}
return $discounts;
}
}
@@ -0,0 +1,103 @@
<?php
namespace App\Domain\Commerce\Discount;
use App\Domain\Commerce\Money;
use Carbon\CarbonInterface;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
/**
* Rabattcode (PAY-008, FACH-14). Zwei voneinander unabhängige Einstellungen:
* - Geltungsbereich: gesamter Warenkorb oder nur ausdrücklich gewählte Ziele (Angebot, Lizenzartikel, Paket);
* - Einlösungsberechtigung: allgemein oder nur für ausdrücklich freigeschaltete Konten (Freigabe gilt nur für diesen Code).
* Der Rabatt ändert den Preis, nie den Nutzungsumfang.
*/
class DiscountCode extends Model
{
public const PERCENT = 'prozent';
public const AMOUNT = 'betrag';
public const SCOPE_CART = 'warenkorb';
public const SCOPE_SELECTED = 'auswahl';
public const OPEN = 'allgemein';
public const RESTRICTED = 'freigabe';
public const TARGET_OFFER = 'angebot';
public const TARGET_ARTICLE = 'lizenzartikel';
public const TARGET_BUNDLE = 'paket';
protected $fillable = [
'code',
'label',
'kind',
'percent',
'amount_cents',
'scope',
'eligibility',
'valid_from',
'valid_until',
'active',
'note',
];
protected function casts(): array
{
return [
'valid_from' => 'datetime',
'valid_until' => 'datetime',
'active' => 'boolean',
];
}
/** Eingabe und Speicherung vereinheitlicht: ohne Leerzeichen, Großschreibung. */
public static function normalise(string $input): string
{
return mb_strtoupper((string) preg_replace('/\s+/u', '', $input));
}
public function targets(): HasMany
{
return $this->hasMany(DiscountCodeTarget::class);
}
public function releases(): HasMany
{
return $this->hasMany(DiscountRelease::class)->latest('id');
}
public function restricted(): bool
{
return $this->eligibility === self::RESTRICTED;
}
public function forSelection(): bool
{
return $this->scope === self::SCOPE_SELECTED;
}
/** Lesbare Höhe: „10 %“ oder „5,00 €“. */
public function valueLabel(): string
{
return $this->kind === self::PERCENT
? (int) $this->percent.' %'
: Money::format((int) $this->amount_cents);
}
/** Zeitlicher Zustand zum Zeitpunkt: 'aktiv', 'abgelaufen', 'noch_nicht' oder 'deaktiviert'. */
public function stateAt(CarbonInterface $now): string
{
return match (true) {
! $this->active => 'deaktiviert',
$this->valid_from !== null && $this->valid_from->greaterThan($now) => 'noch_nicht',
$this->valid_until !== null && ! $this->valid_until->greaterThan($now) => 'abgelaufen',
default => 'aktiv',
};
}
}
@@ -0,0 +1,24 @@
<?php
namespace App\Domain\Commerce\Discount;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Ausdrücklich gewähltes Ziel eines Codes mit Geltungsbereich „Auswahl“. Ein Paket ist ein eigenes Ziel; seine
* Rabattfähigkeit folgt nie aus einem enthaltenen Lizenzartikel und umgekehrt.
*/
class DiscountCodeTarget extends Model
{
protected $fillable = [
'discount_code_id',
'target_type',
'target_id',
];
public function code(): BelongsTo
{
return $this->belongsTo(DiscountCode::class, 'discount_code_id');
}
}
@@ -0,0 +1,59 @@
<?php
namespace App\Domain\Commerce\Discount;
use App\Models\User;
use Carbon\CarbonInterface;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Freigabe eines Mitgliedskontos für genau einen Code. Freigaben werden nie gelöscht, nur entzogen; Verlauf und
* Begründung bleiben erhalten. Eine Freigabe für Code X berechtigt nicht zur Nutzung von Code Y.
*/
class DiscountRelease extends Model
{
protected $table = 'discount_code_releases';
protected $fillable = [
'discount_code_id',
'user_id',
'granted_by',
'granted_at',
'valid_until',
'revoked_by',
'revoked_at',
'reason',
];
protected function casts(): array
{
return [
'granted_at' => 'datetime',
'valid_until' => 'datetime',
'revoked_at' => 'datetime',
];
}
public function code(): BelongsTo
{
return $this->belongsTo(DiscountCode::class, 'discount_code_id');
}
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
public function grantor(): BelongsTo
{
return $this->belongsTo(User::class, 'granted_by');
}
public function isActiveAt(CarbonInterface $now): bool
{
return $this->revoked_at === null
&& $this->granted_at->lessThanOrEqualTo($now)
&& ($this->valid_until === null || $this->valid_until->greaterThan($now));
}
}
@@ -0,0 +1,83 @@
<?php
namespace App\Domain\Commerce\Discount;
/**
* Ergebnis der Prüfung eines Codes gegen einen Warenkorb: angewandt (Rabatt je Option) oder nicht angewandt mit
* einer verständlichen Begründung. Ein Code, der gerade nicht gilt, bleibt als Ergebnis sichtbar, damit der Käufer
* den Grund erfährt.
*/
final class DiscountResult
{
public const OK = 'ok';
public const UNKNOWN = 'unbekannt';
public const INACTIVE = 'deaktiviert';
public const NOT_YET = 'noch_nicht';
public const EXPIRED = 'abgelaufen';
public const LOGIN = 'anmeldung';
public const NO_RELEASE = 'keine_freigabe';
public const NO_MATCH = 'keine_position';
public const TOO_HIGH = 'zu_hoch';
/**
* @param array<int, int> $perOffer Kennung der Option => Rabatt in Cent
*/
public function __construct(
public readonly ?DiscountCode $code,
public readonly string $state,
public readonly ?string $message = null,
public readonly array $perOffer = [],
) {}
public function applied(): bool
{
return $this->state === self::OK && $this->totalCents() > 0;
}
public function totalCents(): int
{
return $this->state === self::OK ? array_sum($this->perOffer) : 0;
}
public function forOffer(int $offerId): int
{
return $this->state === self::OK ? (int) ($this->perOffer[$offerId] ?? 0) : 0;
}
/** Für die Bestellung festgehaltene Angaben zum Zeitpunkt der Bestellung. */
public function snapshot(): array
{
return [
'code' => $this->code?->code,
'label' => $this->code?->label,
'kind' => $this->code?->kind,
'percent' => $this->code?->percent,
'amount_cents' => $this->code?->amount_cents,
'scope' => $this->code?->scope,
'eligibility' => $this->code?->eligibility,
'discount_cents' => $this->totalCents(),
];
}
/** Teil der Prüfsumme der Bestellübersicht. */
public function digestPart(): string
{
$parts = [];
$perOffer = $this->perOffer;
ksort($perOffer);
foreach ($perOffer as $offerId => $cents) {
$parts[] = $offerId.'='.$cents;
}
return ($this->code?->id ?? 0).':'.$this->state.':'.implode(',', $parts);
}
}
@@ -0,0 +1,327 @@
<?php
namespace App\Domain\Commerce\Discount;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Commerce\CartLine;
use App\Domain\Commerce\Money;
use App\Models\User;
use Carbon\CarbonInterface;
use Illuminate\Support\Carbon;
use Illuminate\Support\Facades\DB;
/**
* Prüfung und Pflege von Rabattcodes. Die Prüfung läuft serverseitig bei der Eingabe, in jeder Übersicht und
* unmittelbar vor Bestellabschluss (unter Sperre); sie liest nur und ändert keine Bestellung.
*/
class DiscountService
{
/** Kleinster Zahlbetrag einer Bestellung mit Rabatt (Mindestbetrag der Kartenzahlung bei Stripe: 0,50 EUR). */
public const MIN_PAYABLE_CENTS = 50;
public function find(string $input): ?DiscountCode
{
$code = DiscountCode::normalise($input);
return $code === '' ? null : DiscountCode::query()->where('code', $code)->first();
}
/**
* @param list<CartLine> $lines nur Positionen, die in die Bestellung eingehen
*/
public function evaluate(DiscountCode $code, ?User $user, array $lines, ?CarbonInterface $now = null, bool $lock = false): DiscountResult
{
$now ??= now();
$timing = $code->stateAt($now);
if ($timing !== 'aktiv') {
return new DiscountResult($code, $timing, match ($timing) {
'deaktiviert' => 'Dieser Code ist nicht mehr gültig, der Betreiber hat ihn deaktiviert.',
'noch_nicht' => 'Dieser Code gilt erst ab dem '.$code->valid_from?->timezone(config('app.timezone'))->format('d.m.Y').'.',
default => 'Dieser Code ist abgelaufen (gültig bis '.$code->valid_until?->timezone(config('app.timezone'))->format('d.m.Y').').',
});
}
if ($code->restricted()) {
if ($user === null) {
return new DiscountResult($code, DiscountResult::LOGIN, 'Dieser Code gilt nur für freigeschaltete Konten. Melde dich an, damit wir prüfen können, ob er für dein Konto gilt.');
}
if ($this->activeRelease($code, $user, $now, $lock) === null) {
return new DiscountResult($code, DiscountResult::NO_RELEASE, 'Dieser Code ist für dein Konto nicht freigeschaltet. Er gilt nur für Konten, die der Betreiber ausdrücklich dafür freigegeben hat. Wenn du denkst, dass dir die Freigabe zusteht, wende dich an den Betreiber.');
}
}
$matching = [];
foreach ($lines as $line) {
if ($line->version !== null && $this->matches($code, $line->offer, $line->version)) {
$matching[$line->offer->id] = (int) $line->currentPriceCents;
}
}
if ($matching === []) {
return new DiscountResult($code, DiscountResult::NO_MATCH, $code->forSelection()
? 'Dieser Code gilt nur für bestimmte Angebote, und keines davon liegt in deiner Bestellung.'
: 'In deiner Bestellung gibt es keine Position, auf die der Code angewendet werden kann.');
}
$perOffer = DiscountCalculator::allocate($code->kind, $code->percent, $code->amount_cents, $matching);
$payable = array_sum(array_map(fn (CartLine $line): int => (int) $line->currentPriceCents, $lines)) - array_sum($perOffer);
if ($payable < self::MIN_PAYABLE_CENTS) {
return new DiscountResult($code, DiscountResult::TOO_HIGH, 'Mit diesem Code läge der Zahlbetrag unter '.Money::format(self::MIN_PAYABLE_CENTS).'. Das ist beim Start nicht vorgesehen. Wähle zusätzlich eine weitere Position oder verzichte auf den Code.');
}
return new DiscountResult($code, DiscountResult::OK, null, $perOffer);
}
/**
* Passt die Position? Verglichen werden nur die ausdrücklich gewählten Ziele mit den unmittelbaren Positionen der
* Angebotsfassung. Ein Paket gilt nur, wenn es selbst gewählt ist; ein enthaltener Artikel macht es nicht
* rabattfähig, und ein Artikel in einem Paket macht das Angebot nicht rabattfähig.
*/
public function matches(DiscountCode $code, Offer $offer, OfferVersion $version): bool
{
if (! $code->forSelection()) {
return true;
}
$targets = $code->targets->groupBy('target_type')->map(fn ($rows) => $rows->pluck('target_id')->map(fn ($id): int => (int) $id)->all());
if (in_array($offer->id, $targets->get(DiscountCode::TARGET_OFFER, []), true)) {
return true;
}
$version->loadMissing('lines.bundleVersion');
foreach ($version->lines as $line) {
if ($line->license_article_id !== null && in_array((int) $line->license_article_id, $targets->get(DiscountCode::TARGET_ARTICLE, []), true)) {
return true;
}
if ($line->bundleVersion !== null && in_array((int) $line->bundleVersion->bundle_id, $targets->get(DiscountCode::TARGET_BUNDLE, []), true)) {
return true;
}
}
return false;
}
public function activeRelease(DiscountCode $code, User $user, ?CarbonInterface $now = null, bool $lock = false): ?DiscountRelease
{
$now ??= now();
$query = DiscountRelease::query()->where('discount_code_id', $code->id)->where('user_id', $user->id)->whereNull('revoked_at');
if ($lock) {
$query->lockForUpdate();
}
return $query->get()->first(fn (DiscountRelease $release): bool => $release->isActiveAt($now));
}
/**
* Legt einen Code an oder ändert ihn. Gleiche Prüfung für Anlegen und Bearbeiten.
*
* @param array<string, mixed> $data
* @param list<array{type: string, id: int}> $targets
*/
public function save(array $data, array $targets, ?DiscountCode $existing = null): DiscountCode
{
$code = DiscountCode::normalise((string) ($data['code'] ?? ''));
$label = trim((string) ($data['label'] ?? ''));
if (preg_match('/^[A-Z0-9][A-Z0-9_-]{2,39}$/', $code) !== 1) {
throw new DomainRuleException('Der Code besteht aus 3 bis 40 Zeichen: Buchstaben, Ziffern, Bindestrich oder Unterstrich, ohne Leerzeichen.');
}
if ($label === '') {
throw new DomainRuleException('Der Name des Codes fehlt. Er ist nur für die Verwaltung und erscheint nicht im Shop.');
}
if (DiscountCode::query()->where('code', $code)->when($existing !== null, fn ($query) => $query->whereKeyNot($existing->id))->exists()) {
throw new DomainRuleException('Diesen Code gibt es schon.');
}
$kind = (string) ($data['kind'] ?? '');
$percent = null;
$amount = null;
if ($kind === DiscountCode::PERCENT) {
$percent = (int) ($data['percent'] ?? 0);
if ($percent < 1 || $percent > 100) {
throw new DomainRuleException('Der Prozentsatz liegt zwischen 1 und 100.');
}
} elseif ($kind === DiscountCode::AMOUNT) {
$amount = Money::parse($data['amount_euro'] ?? ($data['amount_cents'] ?? null));
if ($amount === null || $amount <= 0) {
throw new DomainRuleException('Der Rabattbetrag ist ein Eurobetrag über 0,00 €.');
}
} else {
throw new DomainRuleException('Die Art des Rabatts ist Prozent oder fester Betrag.');
}
$scope = (string) ($data['scope'] ?? '');
$eligibility = (string) ($data['eligibility'] ?? '');
if (! in_array($scope, [DiscountCode::SCOPE_CART, DiscountCode::SCOPE_SELECTED], true)) {
throw new DomainRuleException('Der Geltungsbereich ist der gesamte Warenkorb oder eine Auswahl.');
}
if (! in_array($eligibility, [DiscountCode::OPEN, DiscountCode::RESTRICTED], true)) {
throw new DomainRuleException('Die Einlösung ist allgemein oder auf freigeschaltete Konten beschränkt.');
}
$targets = $this->cleanTargets($targets);
if ($scope === DiscountCode::SCOPE_SELECTED && $targets === []) {
throw new DomainRuleException('Wähle mindestens ein Angebot, einen Lizenzartikel oder ein Paket, für das der Code gilt, oder lass ihn für den gesamten Warenkorb gelten.');
}
$from = $this->date($data['valid_from'] ?? null);
$until = $this->date($data['valid_until'] ?? null, true);
if ($from !== null && $until !== null && $until->lessThanOrEqualTo($from)) {
throw new DomainRuleException('Das Ende der Gültigkeit liegt vor dem Beginn.');
}
return DB::transaction(function () use ($existing, $code, $label, $kind, $percent, $amount, $scope, $eligibility, $from, $until, $data, $targets): DiscountCode {
$model = $existing ?? new DiscountCode;
$model->fill([
'code' => $code,
'label' => $label,
'kind' => $kind,
'percent' => $percent,
'amount_cents' => $amount,
'scope' => $scope,
'eligibility' => $eligibility,
'valid_from' => $from,
'valid_until' => $until,
'active' => (bool) ($data['active'] ?? true),
'note' => filled($data['note'] ?? null) ? trim((string) $data['note']) : null,
]);
$model->save();
$model->targets()->delete();
if ($scope === DiscountCode::SCOPE_SELECTED) {
foreach ($targets as $target) {
$model->targets()->create(['target_type' => $target['type'], 'target_id' => $target['id']]);
}
}
return $model->load('targets');
});
}
public function setActive(DiscountCode $code, bool $active): DiscountCode
{
$code->active = $active;
$code->save();
return $code;
}
/**
* Schaltet ein Konto für genau diesen Code frei. Eine zweite aktive Freigabe desselben Kontos gibt es nicht.
*/
public function release(DiscountCode $code, User $member, ?User $actor, ?CarbonInterface $until = null, ?string $reason = null): DiscountRelease
{
if (! $code->restricted()) {
throw new DomainRuleException('Dieser Code ist allgemein einlösbar. Freigaben gibt es nur für Codes mit beschränkter Einlösung.');
}
if ($member->party_id === null) {
throw new DomainRuleException('Nur ein Mitgliedskonto kann für einen Code freigeschaltet werden.');
}
return DB::transaction(function () use ($code, $member, $actor, $until, $reason): DiscountRelease {
DiscountCode::query()->whereKey($code->id)->lockForUpdate()->firstOrFail();
if ($this->activeRelease($code, $member) !== null) {
throw new DomainRuleException('Dieses Konto ist für den Code bereits freigeschaltet.');
}
if ($until !== null && $until->lessThanOrEqualTo(now())) {
throw new DomainRuleException('Das Ende der Freigabe liegt in der Vergangenheit.');
}
return DiscountRelease::query()->create([
'discount_code_id' => $code->id,
'user_id' => $member->id,
'granted_by' => $actor?->id,
'granted_at' => now(),
'valid_until' => $until,
'reason' => filled($reason) ? trim((string) $reason) : null,
]);
});
}
/**
* Entzieht die Freigabe. Sie bleibt mit Zeitpunkt, Person und Begründung gespeichert.
*/
public function revoke(DiscountRelease $release, ?User $actor, ?string $reason = null): DiscountRelease
{
return DB::transaction(function () use ($release, $actor, $reason): DiscountRelease {
$release = DiscountRelease::query()->lockForUpdate()->findOrFail($release->id);
if ($release->revoked_at !== null) {
throw new DomainRuleException('Diese Freigabe ist bereits entzogen.');
}
$release->revoked_at = now();
$release->revoked_by = $actor?->id;
$release->reason = filled($reason) ? trim((string) $reason) : $release->reason;
$release->save();
return $release;
});
}
/**
* @param list<array{type: string, id: int}> $targets
* @return list<array{type: string, id: int}>
*/
private function cleanTargets(array $targets): array
{
$clean = [];
foreach ($targets as $target) {
$type = (string) ($target['type'] ?? '');
$id = (int) ($target['id'] ?? 0);
$exists = match ($type) {
DiscountCode::TARGET_OFFER => Offer::query()->whereKey($id)->exists(),
DiscountCode::TARGET_ARTICLE => LicenseArticle::query()->whereKey($id)->exists(),
DiscountCode::TARGET_BUNDLE => Bundle::query()->whereKey($id)->exists(),
default => false,
};
if (! $exists) {
throw new DomainRuleException('Ein gewähltes Ziel des Codes gibt es nicht (mehr).');
}
$clean[$type.':'.$id] = ['type' => $type, 'id' => $id];
}
return array_values($clean);
}
/** Ein Datum ohne Uhrzeit gilt als Tag: ab Tagesbeginn, als Ende einschließlich des ganzen Tages. */
private function date(mixed $value, bool $endOfDay = false): ?CarbonInterface
{
if (! filled($value)) {
return null;
}
$date = Carbon::parse((string) $value, config('app.timezone'));
return $endOfDay && strlen(trim((string) $value)) <= 10 ? $date->endOfDay() : $date;
}
}
+31
View File
@@ -17,8 +17,39 @@ class Order extends Model
'holder_kind',
'total_cents',
'currency',
'subtotal_cents',
'discount_cents',
'discount_code_id',
'discount_snapshot',
'payment_method',
'terms_accepted_at',
'terms_snapshot',
'withdrawal_requested_at',
'withdrawal_note',
];
protected function casts(): array
{
return [
'discount_snapshot' => 'array',
'terms_snapshot' => 'array',
'terms_accepted_at' => 'datetime',
'withdrawal_requested_at' => 'datetime',
];
}
/** Listenpreise vor Rabatt; bei älteren Bestellungen die Summe der Positionen. */
public function subtotal(): int
{
return (int) ($this->subtotal_cents ?? $this->total_cents ?? $this->lines->sum('price_cents'));
}
/** Endgültiger Zahlbetrag. */
public function payable(): int
{
return (int) ($this->total_cents ?? $this->lines->sum('price_cents'));
}
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
+9
View File
@@ -22,8 +22,17 @@ class OrderLine extends Model
'tax_class',
'grant_kind',
'holder_party_id',
'licence_scope',
'trainer_count',
'discount_cents',
];
/** Preis dieser Position nach Rabatt. */
public function payable(): int
{
return (int) $this->price_cents - (int) $this->discount_cents;
}
public function order(): BelongsTo
{
return $this->belongsTo(Order::class);
+12
View File
@@ -2,6 +2,7 @@
namespace App\Domain\Commerce;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Entitlement\Grant;
use App\Domain\Entitlement\GrantStatus;
@@ -27,12 +28,23 @@ public function covers(Party $holder, OfferVersion $version): bool
$byAcquisition = Grant::query()
->where('status', GrantStatus::Aktiv)
->whereHas('acquisition', fn ($query) => $query->where('party_id', $holder->id))
->with('acquisition')
->get()
->filter(fn (Grant $grant): bool => ($grant->valid_from === null || ! $grant->valid_from->greaterThan($now))
&& ($grant->valid_until === null || $grant->valid_until->greaterThan($now)))
->groupBy('acquisition_id');
$wanted = LicenceScope::key($version->licence_scope, $version->trainer_count);
foreach ($byAcquisition as $grants) {
$conditions = (array) ($grants->first()->acquisition?->conditions ?? []);
// Gleicher Umfang heißt auch gleicher Nutzerkreis: Eine Einzellizenz deckt keine Mehrfachlizenz ab und
// umgekehrt (der Nutzerkreis wird nicht aus Zweck oder Preis abgeleitet).
if (LicenceScope::key($conditions['licence_scope'] ?? null, isset($conditions['trainer_count']) ? (int) $conditions['trainer_count'] : null) !== $wanted) {
continue;
}
$have = [];
foreach ($grants as $grant) {
+3
View File
@@ -12,6 +12,9 @@ class Payment extends Model
'provider',
'status',
'provider_reference',
'provider_payment_ref',
'amount_cents',
'confirmed_by',
];
public function order(): BelongsTo
+133 -2
View File
@@ -2,8 +2,10 @@
namespace App\Domain\Commerce;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\EditorialProfileReader;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -37,6 +39,125 @@ public function forComposition(Composition $composition): array
return $options;
}
/**
* Kaufbare Optionen der eigenen Produktseite eines Pakets: Angebote mit eigener Paketseite, deren aktive Fassung
* dieses Paket verkauft.
*
* @return list<array<string, mixed>>
*/
public function forBundle(Bundle $bundle): array
{
$options = [];
foreach (Offer::query()->where('standalone_bundle', true)->orderBy('id')->get() as $offer) {
$version = $this->offers->purchasableVersion($offer);
if ($version !== null && $this->bundleOf($version)?->id === $bundle->id) {
$options[] = $this->describe($offer, $version);
}
}
return $options;
}
/**
* Das Paket, das die Fassung unmittelbar verkauft (erste Paketposition), sonst null.
*/
public function bundleOf(OfferVersion $version): ?Bundle
{
$version->loadMissing('lines.bundleVersion.bundle');
return $version->lines->first(fn ($line): bool => $line->bundleVersion !== null)?->bundleVersion?->bundle;
}
/** Gruppenschlüssel der Alternativen: Produktseite eines Programms oder eigene Paketseite. */
public function groupKey(Offer $offer): ?string
{
if ($offer->composition_id !== null) {
return 'c:'.$offer->composition_id;
}
if ($offer->standalone_bundle) {
$version = $this->offers->purchasableVersion($offer) ?? $offer->versions()->orderByDesc('number')->first();
$bundle = $version === null ? null : $this->bundleOf($version);
return $bundle === null ? null : 'b:'.$bundle->id;
}
return null;
}
/** Adresse der Produktseite, auf der die Option angeboten wird, sonst null. */
public function pageUrl(Offer $offer): ?string
{
if ($offer->composition_id !== null) {
return route('public.program', $offer->composition_id);
}
$key = $this->groupKey($offer);
return $key !== null && str_starts_with($key, 'b:') ? route('public.package', (int) substr($key, 2)) : null;
}
/**
* Pakete mit eigener Produktseite und kaufbarer Option: Paketkennung => günstigster Preis und Zahl der Optionen.
*
* @return array<int, array{from_cents: int, count: int}>
*/
public function bundleSummaries(): array
{
$summary = [];
foreach (Offer::query()->where('standalone_bundle', true)->orderBy('id')->get() as $offer) {
$version = $this->offers->purchasableVersion($offer);
$bundle = $version === null ? null : $this->bundleOf($version);
if ($bundle === null) {
continue;
}
$current = $summary[$bundle->id] ?? ['from_cents' => PHP_INT_MAX, 'count' => 0];
$summary[$bundle->id] = [
'from_cents' => min($current['from_cents'], (int) $version->price_cents),
'count' => $current['count'] + 1,
];
}
return $summary;
}
/**
* Der tatsächliche Umfang einer Paketseite: die Artikel aller Optionen ohne Doppelte, in der Reihenfolge der
* Optionen, mit Name und Kurzbeschreibung aus der Redaktion.
*
* @param list<array<string, mixed>> $options
* @return list<array{title: string, teaser: string}>
*/
public function bundleContents(array $options): array
{
$contents = [];
foreach ($options as $option) {
$option['version']->loadMissing('resolvedScopes.article');
foreach ($option['version']->resolvedScopes as $item) {
$article = $item->article;
if ($article === null || isset($contents[$article->id])) {
continue;
}
$profile = app(EditorialProfileReader::class)->read($article, 'detail');
$contents[$article->id] = [
'title' => $this->articleTitle($article),
'teaser' => trim((string) ($profile->value('teaser') ?? '')),
];
}
}
return array_values($contents);
}
/**
* Zeilen für Shop-Suche und Kacheln: je Komposition die günstigste Option.
*
@@ -89,18 +210,28 @@ public function describe(Offer $offer, OfferVersion $version): array
'for' => $version->holder_kind === 'organisation' ? 'Organisationen und Vereine' : 'Privatpersonen',
'holder_kind' => $version->holder_kind,
'term' => self::termLabel($version),
'licence' => LicenceScope::label($version->licence_scope, $version->trainer_count),
'licence_scope' => $version->licence_scope,
'trainer_count' => $version->trainer_count,
'licence_note' => LicenceScope::explanation($version->licence_scope, $version->trainer_count),
'scope' => $scope,
];
}
public static function termLabel(OfferVersion $version): string
{
return match ($version->term_rule) {
return self::termRuleLabel($version->term_rule);
}
/** Laufzeitregel aus der Angebotsfassung oder aus den Bedingungen eines Erwerbs (gleiche Schlüssel). */
public static function termRuleLabel(?string $rule): string
{
return match ((string) $rule) {
'dauerhaft' => 'Dauerhaft nutzbar',
'befristet' => 'Befristet',
'solange_angebot_aktiv' => 'Solange das Angebot aktiv ist',
'periodisch' => 'Laufend, periodisch',
default => (string) $version->term_rule,
default => (string) $rule,
};
}
+127
View File
@@ -0,0 +1,127 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Cms\Page;
/**
* Pflichtangaben und Zustimmungen im Bestellablauf (Verkaufsstart Deutschland, PAY-005, PAY-009).
*
* Die finalen Rechtstexte (AGB, Lizenzbedingungen, Widerrufsbelehrung, Impressum, Datenschutz) liegen als Seiten im
* CMS und werden hier nur verlinkt. Der Wortlaut der Zustimmungen unten ist ein ENTWURF zur Prüfung durch die
* Rechtsberatung. Er ist nicht rechtlich freigegeben; `VERSION` hält fest, welcher Wortlaut galt, damit die Zustimmung
* je Bestellung nachvollziehbar bleibt.
*/
final class SalesTerms
{
public const VERSION = '2026-11-24-entwurf';
/** Schaltfläche zum verbindlichen Abschluss (Button-Lösung, § 312j Abs. 3 BGB). */
public const ORDER_BUTTON = 'Zahlungspflichtig bestellen';
public const ORDER_BUTTON_INVOICE = 'Zahlungspflichtig auf Rechnung bestellen';
/**
* Seiten der Rechtstexte: Schlüssel => Bezeichnung und mögliche Pfade im CMS (erste veröffentlichte Seite gilt).
*
* @return array<string, array{label: string, paths: list<string>, required: bool}>
*/
public static function pages(): array
{
return [
'agb' => ['label' => 'Allgemeine Geschäftsbedingungen', 'paths' => ['/agb'], 'required' => true],
'lizenz' => ['label' => 'Lizenzbedingungen', 'paths' => ['/lizenzbedingungen', '/lizenz'], 'required' => true],
'widerruf' => ['label' => 'Widerrufsbelehrung', 'paths' => ['/widerruf', '/widerrufsbelehrung'], 'required' => true],
'impressum' => ['label' => 'Impressum', 'paths' => ['/impressum'], 'required' => true],
'datenschutz' => ['label' => 'Datenschutzerklärung', 'paths' => ['/datenschutz'], 'required' => true],
];
}
/**
* Veröffentlichte Seite des Rechtstextes oder null.
*/
public static function page(string $key): ?Page
{
$definition = self::pages()[$key] ?? null;
if ($definition === null) {
return null;
}
return Page::query()
->whereIn('path', $definition['paths'])
->whereNotNull('published_revision_id')
->orderBy('id')
->first();
}
public static function url(string $key): ?string
{
return self::page($key)?->publicUrl();
}
/**
* Fehlende oder unveröffentlichte Rechtstexte (Schlüssel => Bezeichnung).
*
* @return array<string, string>
*/
public static function missingPages(): array
{
$missing = [];
foreach (self::pages() as $key => $definition) {
if ($definition['required'] && self::page($key) === null) {
$missing[$key] = $definition['label'];
}
}
return $missing;
}
/**
* Zustimmungen im Checkout: Schlüssel => Wortlaut (ENTWURF).
*
* @return array<string, string>
*/
public static function consents(): array
{
return [
'agb' => 'Ich habe die Allgemeinen Geschäftsbedingungen und die Lizenzbedingungen gelesen und stimme ihnen zu.',
'sofort' => 'Ich verlange ausdrücklich, dass mit der Ausführung des Vertrags vor Ablauf der Widerrufsfrist begonnen wird und die digitalen Inhalte sofort nach Zahlungseingang bereitgestellt werden. Mir ist bekannt, dass ich mein Widerrufsrecht verliere, sobald die Ausführung begonnen hat.',
];
}
/**
* Prüft die Zustimmungen und liefert den Nachweis für die Bestellung (Wortlaut, Fassung, Seiten, Zeit).
*
* @param array<string, mixed> $accepted Schlüssel => angekreuzt
* @return array<string, mixed>
*/
public static function proof(array $accepted): array
{
$texts = [];
foreach (self::consents() as $key => $wording) {
if (empty($accepted[$key])) {
throw new DomainRuleException('Bitte bestätige die Zustimmungen vor dem verbindlichen Abschluss.');
}
$texts[$key] = $wording;
}
$pages = [];
foreach (array_keys(self::pages()) as $key) {
$page = self::page($key);
$pages[$key] = $page === null ? null : ['path' => $page->path, 'revision_id' => $page->published_revision_id];
}
return [
'version' => self::VERSION,
'consents' => $texts,
'pages' => $pages,
'recorded_at' => now()->toIso8601String(),
];
}
}
+41 -7
View File
@@ -3,9 +3,12 @@
namespace App\Domain\Commerce;
/**
* Etappe 1 verwendet ausschließlich Testzahlung und erteilt keine Produktivfreigabe. Der Shop (Warenkorb, Kasse,
* Kopflink) ist deshalb nur aktiv, wenn die Umgebung nicht Produktion ist und der Zahlungstreiber „test“ gilt.
* Dieselbe Bedingung gilt für die Testzahlung der Bestellseite.
* Wann der Shop (Warenkorb, Kasse, Kopflink) aktiv ist.
*
* Test und Sandbox: nicht in Produktion, Zahlungstreiber „test“ oder „stripe“ (Testschlüssel).
* Produktion: nur mit der ausdrücklichen Produktivfreigabe (`SHOP_LIVE_RELEASE`, Entscheidung von Lars), dem
* Zahlungstreiber „stripe“ mit Live-Schlüssel und veröffentlichten Rechtstexten. Fehlt eines davon, bleibt der Shop in
* Produktion abgeschaltet. Die Freigabe ist standardmäßig aus.
*/
final class Shop
{
@@ -14,14 +17,45 @@ public static function driver(): string
return (string) config('services.payment.driver');
}
public static function enabled(): bool
/** Produktivbetrieb ist freigegeben und vollständig vorbereitet (Freigabe, Live-Schlüssel, Rechtstexte). */
public static function live(): bool
{
return ! app()->isProduction() && in_array(self::driver(), ['test', 'stripe'], true);
return app()->isProduction()
&& config('shop.live_release') === true
&& self::driver() === 'stripe'
&& self::liveKey()
&& SalesTerms::missingPages() === [];
}
/** Stripe-Kasse (Etappe 1: nur Testmodus, nie in Produktion). */
public static function enabled(): bool
{
if (app()->isProduction()) {
return self::live();
}
return in_array(self::driver(), ['test', 'stripe'], true);
}
/** Stripe-Kasse: im Test nur mit Testschlüsseln, in Produktion nur nach der Produktivfreigabe. */
public static function stripe(): bool
{
return ! app()->isProduction() && self::driver() === 'stripe';
if (app()->isProduction()) {
return self::live();
}
return self::driver() === 'stripe';
}
/** Kauf auf Rechnung für Organisationen (manuelle Rechnung, Zahlungseingang durch den Betreiber). */
public static function invoice(): bool
{
return self::enabled() && (bool) config('shop.invoice', true);
}
private static function liveKey(): bool
{
$secret = (string) config('services.stripe.secret');
return str_starts_with($secret, 'sk_live_') || str_starts_with($secret, 'rk_live_');
}
}
+106 -15
View File
@@ -3,7 +3,10 @@
namespace App\Domain\Commerce\Stripe;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\Payment;
use App\Domain\Commerce\Shop;
use Illuminate\Http\Client\ConnectionException;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Http\Client\Response;
@@ -11,9 +14,11 @@
use Illuminate\Support\Facades\Log;
/**
* Stripe-Kasse (Checkout Session) für die Testzahlung in Etappe 1. Ausschließlich Testschlüssel: Ein Live-Schlüssel
* oder die Produktionsumgebung werden abgewiesen, bevor ein Aufruf an Stripe geht. Bezahlt wird bei Stripe; Kartendaten
* berühren diese Anwendung nie. Die Freischaltung erfolgt allein über die signierte Meldung (StripeWebhook).
* Stripe-Kasse (Checkout Session). Außerhalb der Produktion nur mit Testschlüsseln; ein Live-Schlüssel wird dort
* abgewiesen. In Produktion nur nach der Produktivfreigabe (Shop::live) und nur mit Live-Schlüssel; in jedem anderen
* Fall wird abgewiesen, bevor ein Aufruf an Stripe geht. Bezahlt wird bei Stripe; Kartendaten berühren diese Anwendung
* nie. Die Freischaltung erfolgt allein über die signierte Meldung (StripeWebhook). Der Betrag je Position ist der
* Preis nach Rabatt, damit die Summe bei Stripe genau dem gespeicherten Zahlbetrag der Bestellung entspricht.
*/
class StripeGateway
{
@@ -24,13 +29,18 @@ class StripeGateway
*/
public function checkoutFor(Order $order): array
{
$this->assertSandbox();
$this->assertAllowed();
$order->loadMissing('lines', 'user');
$taxRate = $this->taxRate();
if ($order->status !== 'offen') {
throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.');
}
if ($order->payment_method === 'rechnung') {
throw new DomainRuleException('Diese Bestellung wird auf Rechnung bezahlt, nicht bei Stripe.');
}
$open = $this->reusableSession($order);
if ($open !== null) {
@@ -50,18 +60,28 @@ public function checkoutFor(Order $order): array
];
foreach ($order->lines->values() as $index => $line) {
$productData = ['name' => filled($line->offer_name) ? (string) $line->offer_name : 'Lizenz'];
if ((int) $line->discount_cents > 0) {
$productData['description'] = 'Listenpreis '.Money::format((int) $line->price_cents).', Rabatt '.Money::format((int) $line->discount_cents);
}
$params['line_items'][$index] = [
'quantity' => 1,
'price_data' => [
'currency' => strtolower((string) ($line->currency ?? $order->currency ?? 'EUR')),
'unit_amount' => (int) $line->price_cents,
'product_data' => ['name' => filled($line->offer_name) ? (string) $line->offer_name : 'Lizenz'],
'unit_amount' => $line->payable(),
'product_data' => $productData,
],
];
if ($taxRate !== null) {
$params['line_items'][$index]['tax_rates'] = [$taxRate];
}
}
$response = $this->request()
->withHeaders(['Idempotency-Key' => 'luf-order-'.$order->id.'-'.$attempt])
->withHeaders(['Idempotency-Key' => $this->idempotencyKey($order, $attempt, $params)])
->post('/v1/checkout/sessions', $params);
$this->assertOk($response, 'angelegt');
@@ -77,21 +97,89 @@ public function checkoutFor(Order $order): array
return ['id' => $id, 'url' => $url];
}
public function assertSandbox(): void
public function assertAllowed(): void
{
$secret = (string) config('services.stripe.secret');
if (app()->isProduction()) {
throw new DomainRuleException('Stripe ist in Produktion nicht freigegeben.');
}
if ($secret === '') {
throw new DomainRuleException('Stripe ist nicht eingerichtet: Der Schlüssel fehlt.');
}
if (! str_starts_with($secret, 'sk_test_') && ! str_starts_with($secret, 'rk_test_')) {
throw new DomainRuleException('Etappe 1 erlaubt nur den Stripe-Testmodus (Schlüssel sk_test_).');
if (app()->isProduction()) {
if (! Shop::live()) {
throw new DomainRuleException('Stripe ist in Produktion nicht freigegeben.');
}
return;
}
if (! str_starts_with($secret, 'sk_test_') && ! str_starts_with($secret, 'rk_test_')) {
throw new DomainRuleException('Außerhalb der Produktion erlaubt Stripe nur den Testmodus (Schlüssel sk_test_).');
}
}
/**
* Vollerstattung der bezahlten Bestellung bei Stripe. Der Betrag ist der gespeicherte Zahlbetrag. Der
* Idempotenzschlüssel verhindert eine doppelte Rückzahlung bei Wiederholung. Schlägt sie fehl, wird nichts
* entzogen (Aufrufer: Checkout::refund).
*/
public function refund(Order $order, Payment $payment, string $reason): void
{
$this->assertAllowed();
$intent = (string) $payment->provider_payment_ref;
if ($intent === '') {
$session = $this->request()->get('/v1/checkout/sessions/'.$payment->provider_reference);
$this->assertOk($session, 'abgefragt');
$intent = (string) $session->json('payment_intent');
}
if ($intent === '') {
throw new DomainRuleException('Zu dieser Zahlung gibt es bei Stripe keinen Zahlungsvorgang. Erstatte sie im Stripe-Dashboard und prüfe den Fall.');
}
$response = $this->request()
->withHeaders(['Idempotency-Key' => 'luf-refund-'.$order->id.'-'.$payment->id])
->post('/v1/refunds', [
'payment_intent' => $intent,
'amount' => $order->payable(),
'reason' => 'requested_by_customer',
'metadata' => ['order_id' => (string) $order->id, 'grund' => mb_substr($reason, 0, 200)],
]);
$this->assertOk($response, 'erstattet');
$payment->provider_payment_ref = $intent;
$payment->save();
}
/**
* Stripe bindet einen Schlüssel an die Parameter der ersten Anfrage und lehnt dieselbe Kennung mit anderen
* Parametern ab. Der Schlüssel enthält deshalb einen Fingerabdruck der Parameter und die Minute: Ein
* doppelter Klick bleibt wirkungslos, eine geänderte Anfrage oder ein Neuversuch nach einer Korrektur nicht.
*
* @param array<string, mixed> $params
*/
private function idempotencyKey(Order $order, int $attempt, array $params): string
{
$fingerprint = substr(sha1(json_encode([$params, now()->format('YmdHi')], JSON_THROW_ON_ERROR)), 0, 12);
return 'luf-order-'.$order->id.'-'.$attempt.'-'.$fingerprint;
}
/** Konfigurierter Steuersatz oder null; eine ungültige ID wird abgewiesen, statt geraten zu werden. */
private function taxRate(): ?string
{
$id = trim((string) config('services.stripe.tax_rate'));
if ($id === '') {
return null;
}
if (! preg_match('/^txr_[A-Za-z0-9]+$/', $id)) {
throw new DomainRuleException('Die Steuersatz-ID für Stripe ist ungültig (erwartet txr_...).');
}
return $id;
}
/**
@@ -133,11 +221,14 @@ private function assertOk(Response $response, string $what): void
return;
}
// Nur Statuscode und Fehlertyp ins Log, nie Schlüssel oder Kundendaten.
// Statuscode, Fehlertyp, Code, betroffener Parameter und Begründung von Stripe, damit die Ursache lesbar ist.
// Nie Schlüssel oder Kundendaten; die Begründung wird gekürzt.
Log::warning('Stripe-Anfrage fehlgeschlagen', [
'status' => $response->status(),
'type' => $response->json('error.type'),
'code' => $response->json('error.code'),
'param' => $response->json('error.param'),
'message' => mb_substr((string) $response->json('error.message'), 0, 300),
]);
throw new DomainRuleException('Die Zahlung konnte bei Stripe nicht '.$what.' werden. Bitte versuche es später noch einmal.');
+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'];
}
}
+6
View File
@@ -101,6 +101,10 @@ public function issueFromOrderLine(OrderLine $line, Party $holder, User $actor):
'update_promise' => $line->update_promise,
'holder_kind' => $line->holder_kind,
'offer_version_id' => $line->offer_version_id,
'licence_scope' => $line->licence_scope,
'trainer_count' => $line->trainer_count,
'price_cents' => (int) $line->price_cents,
'discount_cents' => (int) $line->discount_cents,
],
]);
@@ -150,6 +154,8 @@ public function issue(
'update_promise' => $version->update_promise,
'holder_kind' => $version->holder_kind,
'offer_version_id' => $version->id,
'licence_scope' => $version->licence_scope,
'trainer_count' => $version->trainer_count,
],
]);
+44
View File
@@ -0,0 +1,44 @@
<?php
namespace App\Domain\Identity;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Rechnungsadresse eines Lizenzinhabers (Person oder Organisation). Eine je Inhaber. Sie wird nur gepflegt;
* eine Bestellung kopiert sie erst, wenn die Rechnungsstellung sie braucht.
*/
class BillingAddress extends Model
{
/** Auswählbare Länder (ISO 3166-1 Alpha-2). */
public const COUNTRIES = [
'DE' => 'Deutschland',
'AT' => 'Österreich',
'CH' => 'Schweiz',
'LI' => 'Liechtenstein',
'LU' => 'Luxemburg',
'BE' => 'Belgien',
'NL' => 'Niederlande',
'FR' => 'Frankreich',
'IT' => 'Italien',
'DK' => 'Dänemark',
'PL' => 'Polen',
'CZ' => 'Tschechien',
];
protected $fillable = [
'party_id',
'recipient',
'line2',
'street',
'postal_code',
'city',
'country',
];
public function party(): BelongsTo
{
return $this->belongsTo(Party::class);
}
}
+5
View File
@@ -25,6 +25,11 @@ public function user(): HasOne
return $this->hasOne(User::class);
}
public function billingAddress(): HasOne
{
return $this->hasOne(BillingAddress::class);
}
public function profile(): HasOne
{
return $this->hasOne(Profile::class);
+100
View File
@@ -0,0 +1,100 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\DomainRuleException;
use App\Models\User;
use Illuminate\Database\QueryException;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
/**
* Übernimmt das Vorschaubild eines Programms oder Moduls als gewöhnliches Bild-Medium im Medienmanager
* (Programm- und Modulkarte), nach demselben Prinzip wie FilmStill.
*
* - Ausdrückliche Handlung der Redaktion. Das Vorschaubild ist ein geschütztes Bibliotheksbild; erst die Übernahme
* legt ein Medium an, das für die Website freigegeben werden kann (WebsiteIntake, Warteschlange).
* - Die Datei wird einmal kopiert. Dieselbe Vorschaudatei ergibt dasselbe Medium (composition_still_sources).
* - Es entsteht keine Fassung, keine Berechtigung, kein Lizenzartikel.
*/
class CompositionStill
{
/** Wahr, wenn der letzte Aufruf ein schon vorhandenes Bild geliefert hat. */
public bool $reused = false;
public function __construct(private readonly WebsiteIntake $intake) {}
public function refusal(Composition $composition): ?string
{
if ($composition->archived_at !== null) {
return 'Das Programm oder Modul ist archiviert.';
}
return null;
}
public function hasThumbnail(Composition $composition): bool
{
$path = $composition->thumbnail_path;
return is_string($path) && str_starts_with($path, 'vorschau/') && ! str_contains($path, '..')
&& Storage::disk('media_derived')->exists($path);
}
public function fromThumbnail(Composition $composition, ?User $actor = null): ContentElement
{
$this->reused = false;
$refusal = $this->refusal($composition);
if ($refusal !== null) {
throw new DomainRuleException($refusal);
}
if (! $this->hasThumbnail($composition)) {
throw new DomainRuleException('Dieses Programm oder Modul hat noch kein Vorschaubild. Setzen Sie es im Redaktionsmanager.');
}
$bytes = Storage::disk('media_derived')->get((string) $composition->thumbnail_path);
if (! is_string($bytes) || $bytes === '') {
throw new DomainRuleException('Das Vorschaubild ließ sich nicht lesen.');
}
$key = 'file:'.hash('sha256', $bytes);
$existing = $this->existing($composition, $key);
if ($existing instanceof ContentElement) {
$this->reused = true;
return $existing;
}
$title = (string) ($composition->display_title ?: $composition->designation);
$path = 'cms/titelbild-'.$composition->id.'-'.Str::lower(Str::random(8)).'.jpg';
Storage::disk('cms_incoming')->put($path, $bytes);
$still = $this->intake->acceptImage($path, 'Titelbild: '.$title, null, 'Titelbild zu „'.$title.'“', $actor);
try {
CompositionStillSource::query()->updateOrCreate(
['composition_id' => $composition->id, 'source_key' => $key],
['still_element_id' => $still->id, 'actor_id' => $actor?->id],
);
} catch (QueryException) {
return $this->existing($composition, $key) ?? $still;
}
return $still;
}
private function existing(Composition $composition, string $key): ?ContentElement
{
$source = CompositionStillSource::query()->with('still')->where('composition_id', $composition->id)->where('source_key', $key)->first();
$still = $source?->still;
// Ein archiviertes oder bei der Verarbeitung gescheitertes Bild wird nicht wiederverwendet.
return $still instanceof ContentElement && $still->archived_at === null && ! filled($still->thumbnail_error) ? $still : null;
}
}
@@ -0,0 +1,26 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\ContentElement;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Herkunft eines Bild-Mediums aus dem Vorschaubild eines Programms oder Moduls (source_key file:{SHA-256}).
*/
class CompositionStillSource extends Model
{
protected $fillable = ['composition_id', 'still_element_id', 'source_key', 'actor_id'];
public function composition(): BelongsTo
{
return $this->belongsTo(Composition::class);
}
public function still(): BelongsTo
{
return $this->belongsTo(ContentElement::class, 'still_element_id');
}
}
+45 -1
View File
@@ -15,6 +15,8 @@
/**
* Legt ein Bild aus einem Film als gewöhnliches Bild-Medium im Medienmanager ab (Medien- und Materialkarte).
*
* - Die Stelle kommt aus der bereitgestellten Fassung, bei einem Film ohne solche Fassung (zum Beispiel ein Teaser nur
* mit Website-Datei) aus der Website-Datei (`teaser/`, Herkunft `frame:0@Sekunde`).
* - Zwei Wege: das Vorschaubild des Films übernehmen oder eine Stelle (Sekunde) wählen. Beides ist eine
* ausdrückliche Handlung der Redaktion; erst dadurch entsteht ein Bild, das für die Website freigegeben werden kann.
* - Das Bild wird einmal gezogen und gespeichert (WebsiteIntake legt es an, die Warteschlange leitet es ab und gibt
@@ -65,6 +67,23 @@ public function version(ContentElement $film): ?ContentElementVersion
->first();
}
/**
* Die Website-Datei, aus der Stellen gezogen werden, wenn es keine bereitgestellte Fassung gibt (Film nur mit
* Website-Datei). Sonst null.
*/
public function websiteFile(ContentElement $film): ?string
{
$path = $film->preview_path;
if ($this->version($film) instanceof ContentElementVersion
|| ! is_string($path) || $path === '' || str_contains($path, '..') || ! str_starts_with($path, 'teaser/')
|| ! Storage::disk('media_derived')->exists($path)) {
return null;
}
return $path;
}
/** Sekunde der Stelle, aus der das aktuelle Vorschaubild des Films stammt, sonst null. */
public function thumbnailSecond(ContentElement $film): ?string
{
@@ -85,7 +104,11 @@ public function fromSecond(ContentElement $film, float $seconds, ?User $actor =
$version = $this->version($film);
if (! $version instanceof ContentElementVersion) {
throw new DomainRuleException('Der Film hat noch keine bereitgestellte Fassung.');
if ($this->websiteFile($film) !== null) {
return $this->fromWebsiteFrame($film, $seconds, $actor);
}
throw new DomainRuleException('Der Film hat weder eine bereitgestellte Fassung noch eine Website-Datei.');
}
return $this->fromFrame($film, $version, $seconds, $actor);
@@ -158,6 +181,27 @@ private function fromFrame(ContentElement $film, ContentElementVersion $version,
return $this->store($film, $key, $bytes, 'Fassung '.$version->number.', '.str_replace('.', ',', $second).' s', $actor);
}
private function fromWebsiteFrame(ContentElement $film, float $seconds, ?User $actor): ContentElement
{
$second = $this->secondText($seconds);
$key = 'frame:0@'.$second;
$existing = $this->existing($film, $key);
if ($existing instanceof ContentElement) {
$this->reused = true;
return $existing;
}
$bytes = $this->deriver->websiteFileJpeg($film, (float) $second, self::WIDTH);
if (! is_string($bytes)) {
throw new DomainRuleException('Aus dieser Stelle der Website-Datei ließ sich kein Bild erzeugen.');
}
return $this->store($film, $key, $bytes, 'Website-Datei, '.str_replace('.', ',', $second).' s', $actor);
}
private function guard(ContentElement $film): void
{
$refusal = $this->refusal($film);
+65 -17
View File
@@ -4,39 +4,72 @@
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\DomainRuleException;
use App\Jobs\StorePresentationFile;
use Illuminate\Support\Facades\Storage;
/**
* Legt die technische Ableitung eines Präsentationsmediums an der Medienidentität ab.
* Es entsteht keine Inhaltsfassung, keine Freigabe und keine Berechtigung.
* Legt die technische Ableitung eines Präsentationsmediums (Website-Datei) an der Medienidentität ab.
* Es entsteht keine Inhaltsfassung, keine Freigabe und keine Berechtigung. Eine vorhandene Inhaltsfassung bleibt
* unverändert und geschützt; die Website-Datei ist eine eigene, bewusst gewählte Datei daneben.
*
* Der Web-Prozess hat `derived/` nur lesend. Er prüft deshalb nur und gibt das Kopieren an die Warteschlange
* (`StorePresentationFile`, ruft `place()` auf).
*/
class PresentationFile
{
public function store(ContentElement $element, string $incoming): void
/**
* Dateiendungen, die ein Browser auf der Website abspielen kann.
*
* @var array<string, list<string>>
*/
public const EXTENSIONS = [
'bild' => ['jpg', 'jpeg', 'png', 'webp', 'gif'],
'audio' => ['mp3', 'm4a', 'ogg'],
'film' => ['mp4', 'webm'],
];
/**
* Prüft die Datei im Eingang, ohne etwas zu verändern. Wirft eine verständliche Regelverletzung.
*/
public function validate(string $outputClass, string $incoming): void
{
if (! in_array($element->output_class, ['bild', 'film', 'audio'], true)) {
if (! isset(self::EXTENSIONS[$outputClass])) {
throw new DomainRuleException('Eine Präsentationsdatei ist ein Bild, ein Film oder ein Hörstück.');
}
if ($element->versions()->exists()) {
throw new DomainRuleException('Dieses Medium hat bereits eine Inhaltsfassung. Die Präsentationsdatei ersetzt sie nicht.');
$extension = strtolower(pathinfo($incoming, PATHINFO_EXTENSION));
if (! in_array($extension, self::EXTENSIONS[$outputClass], true)) {
throw new DomainRuleException(sprintf(
'Für die Website geht nur %s. Eine %s-Datei kann der Browser nicht direkt abspielen; wandle sie vorher um oder lade sie ohne „Eigenständiges Präsentationsmedium“ hoch.',
$this->formats($outputClass),
$extension === '' ? 'Datei ohne Endung' : '.'.$extension,
));
}
if (! $this->readable($incoming)) {
throw new DomainRuleException('Die Datei liegt nicht im Eingang.');
}
$extension = strtolower(pathinfo($incoming, PATHINFO_EXTENSION));
$allowed = match ($element->output_class) {
'bild' => ['jpg', 'jpeg', 'png', 'webp', 'gif'],
'audio' => ['mp3', 'm4a', 'ogg'],
default => ['mp4', 'webm'],
};
if (! in_array($extension, $allowed, true)) {
throw new DomainRuleException('Diese Datei ist keine freigebbare Ableitung. Es wird keine Inhaltsfassung angelegt.');
}
public function store(ContentElement $element, string $incoming): void
{
$this->validate((string) $element->output_class, $incoming);
$element->thumbnail_error = null;
$element->save();
StorePresentationFile::dispatch($element->id, $incoming);
}
/**
* Kopiert die Datei nach `derived/`. Läuft nur in der Warteschlange, die dort schreiben darf.
*/
public function place(ContentElement $element, string $incoming): void
{
$this->validate((string) $element->output_class, $incoming);
$extension = strtolower(pathinfo($incoming, PATHINFO_EXTENSION));
$prefix = $element->output_class === 'bild' ? 'vorschau' : 'teaser';
$target = $prefix.'/'.$element->id.'/datei.'.$extension;
$stream = Storage::disk('cms_incoming')->readStream($incoming);
@@ -46,11 +79,15 @@ public function store(ContentElement $element, string $incoming): void
}
try {
Storage::disk('media_derived')->writeStream($target, $stream);
$written = Storage::disk('media_derived')->writeStream($target, $stream);
} finally {
fclose($stream);
}
if ($written === false) {
throw new DomainRuleException('Die Datei ließ sich nicht ablegen.');
}
if ($element->output_class === 'bild') {
$element->thumbnail_path = $target;
$element->thumbnail_source = 'eigen';
@@ -58,7 +95,18 @@ public function store(ContentElement $element, string $incoming): void
$element->preview_path = $target;
}
$element->thumbnail_error = null;
$element->save();
Storage::disk('cms_incoming')->delete($incoming);
}
public function formats(string $outputClass): string
{
return match ($outputClass) {
'bild' => 'JPG, PNG, WebP oder GIF',
'audio' => 'MP3, M4A oder OGG',
default => 'MP4 (H.264) oder WebM',
};
}
private function readable(string $path): bool
+50 -1
View File
@@ -87,6 +87,27 @@ public function forElementFrame(ContentElement $element, ContentElementVersion $
$this->rememberElement($element, 'frame:'.$version->id.'@'.$this->secondText($seconds));
}
/**
* Vorschaubild aus einer Stelle der Website-Datei. Die Herkunft steht als `frame:0@{Sekunde}`; die 0 steht für die
* Website-Datei (es gibt keine Fassung), alle Leser der Herkunft kommen damit zurecht.
*/
public function forElementWebsiteFrame(ContentElement $element, float $seconds): void
{
$bytes = $this->jpegAtWebsiteFile($element, $seconds);
if (! is_string($bytes)) {
$this->fail($element, 'Aus dieser Filmstelle ließ sich kein Vorschaubild erzeugen.');
return;
}
$name = 'element-'.$element->id;
$path = 'vorschau/'.$name.'.jpg';
Storage::disk('media_derived')->put($path, $bytes);
$this->still($element, Storage::disk('media_derived'), $path, $name);
$this->rememberElement($element, 'frame:0@'.$this->secondText($seconds));
}
public function forCompositionUpload(Composition $composition, string $incoming): void
{
if (! str_starts_with($incoming, 'vorschau/') || str_contains($incoming, '..')) {
@@ -187,7 +208,35 @@ public function frameJpeg(ContentElementVersion $version, float $seconds, int $w
$file = $this->frameInput($version, $original);
if ($file === null) {
return $file === null ? null : $this->jpegFromFile($file, $seconds, $width);
}
/**
* Einzelbild aus der Website-Datei eines Films (`teaser/`), für Medien ohne Inhaltsfassung.
*/
public function jpegAtWebsiteFile(ContentElement $element, float $seconds): ?string
{
return $this->websiteFileJpeg($element, $seconds, 640);
}
/**
* Einzelbild aus der Website-Datei in der gewünschten Breite, nie über die Breite der Datei hinaus (Standbild für
* die Medienkarte, FilmStill).
*/
public function websiteFileJpeg(ContentElement $element, float $seconds, int $width): ?string
{
$file = $element->preview_path;
if ($element->output_class !== 'film' || ! $this->readableDerived($file, 'teaser/')) {
return null;
}
return $this->jpegFromFile($file, $seconds, $width);
}
private function jpegFromFile(string $file, float $seconds, int $width): ?string
{
if ($seconds < 0 || $seconds > 7200) {
return null;
}
+1 -1
View File
@@ -44,7 +44,7 @@ public function refusal(ContentElement $element): ?string
}
if ($this->derivedPath($element) === null) {
return 'Für die Website fehlt eine freigebbare Ableitung. Beim Bild ist das das Vorschaubild. Film und Hörstück ohne Inhaltsfassung nutzen die Datei am Medium unter teaser/. Ein Film mit Inhaltsfassung nutzt die Teaserfassung seiner bereitgestellten Fassung. Die Originaldatei bleibt geschützt.';
return 'Für die Website fehlt eine freigebbare Datei. Beim Bild ist das das Vorschaubild. Bei Film und Hörstück lädst du unter „Website-Freigabe“ eine Website-Datei hoch (Film als MP4 oder WebM); die geschützte Originaldatei bleibt unberührt.';
}
return null;
+140
View File
@@ -0,0 +1,140 @@
<?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();
}
/** Die Überschrift steht im gemeinsamen Objektkopf (filament.verwaltung.kopf), nicht doppelt im Seitenkopf. */
public function getHeading(): string|Htmlable|null
{
return null;
}
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();
}
/** Eine Eingabe wurde geändert: ihre Fehlermeldung vom letzten Speichern entfällt. */
public function updatedWerte(mixed $value, string $key): void
{
unset($this->fehler[$key]);
}
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 = [];
}
}
+107
View File
@@ -0,0 +1,107 @@
<?php
namespace App\Filament\Pages;
use App\Domain\Commerce\SalesTerms;
use App\Domain\Commerce\Shop;
use App\Filament\Support\ShopAccess;
use Filament\Pages\Page;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Facades\DB;
/**
* Verkaufsstart: Was ist bereit, was fehlt noch? Die Seite liest nur. Sie nennt die fehlenden Rechtstexte, den
* Zustand der Zahlungseinrichtung und der Produktivfreigabe, ohne Schlüssel oder Werte zu zeigen. Die Produktivfreigabe
* ist eine Entscheidung von Lars und wird nicht hier, sondern in der Umgebungsdatei des Servers gesetzt.
*/
class Verkaufsstart extends Page
{
protected static string|\UnitEnum|null $navigationGroup = 'Verkauf';
protected static ?string $navigationLabel = 'Verkaufsstart';
protected static ?int $navigationSort = 3;
protected static ?string $slug = 'verkaufsstart';
protected static ?string $title = 'Verkaufsstart';
protected string $view = 'filament.pages.verkaufsstart';
public static function canAccess(): bool
{
return ShopAccess::allowed();
}
public function getHeading(): string|Htmlable|null
{
return null;
}
public function getMaxContentWidth(): Width|string|null
{
return Width::Full;
}
/**
* @return array<string, mixed>
*/
public function daten(): array
{
$legal = [];
foreach (SalesTerms::pages() as $key => $definition) {
$page = SalesTerms::page($key);
$legal[] = [
'text' => $definition['label'],
'neben' => $page === null
? 'Fehlt: Es gibt keine veröffentlichte Seite unter '.implode(' oder ', $definition['paths']).'. Die Seite pflegst du in der Webpräsenz; den Text liefert die Rechtsberatung.'
: 'Veröffentlicht unter '.$page->path.'. Inhalt und Vollständigkeit prüft die Rechtsberatung.',
'zustand' => $page === null ? ['label' => 'Fehlt', 'ton' => 'offen'] : ['label' => 'Veröffentlicht', 'ton' => 'gut'],
];
}
$secret = (string) config('services.stripe.secret');
$mode = match (true) {
$secret === '' => 'nicht eingerichtet',
str_starts_with($secret, 'sk_test_'), str_starts_with($secret, 'rk_test_') => 'Testmodus',
str_starts_with($secret, 'sk_live_'), str_starts_with($secret, 'rk_live_') => 'Live-Schlüssel',
default => 'unbekanntes Format',
};
$withoutScope = DB::table('offer_versions')->where('status', 'aktiv')->where('grant_kind', 'kauf')->whereNull('licence_scope')->count();
$zahlung = [
['text' => 'Zahlungsweg: '.Shop::driver(), 'neben' => 'Test: Testzahlung ohne Anbieter. Stripe: Kasse bei Stripe.', 'zustand' => Shop::driver() === 'stripe' ? ['label' => 'Stripe', 'ton' => 'gut'] : ['label' => 'Test', 'ton' => 'neutral']],
['text' => 'Stripe-Schlüssel: '.$mode, 'neben' => 'Der Schlüssel steht nur in der Umgebungsdatei des Servers und wird hier nie angezeigt.', 'zustand' => $mode === 'nicht eingerichtet' ? ['label' => 'Fehlt', 'ton' => 'offen'] : ['label' => $mode, 'ton' => 'neutral']],
['text' => 'Signaturschlüssel für Stripe-Meldungen: '.(filled(config('services.stripe.webhook_secret')) ? 'gesetzt' : 'fehlt'), 'neben' => 'Ohne ihn weist die Anwendung jede Meldung von Stripe ab; Zahlungen schalten dann nichts frei.', 'zustand' => filled(config('services.stripe.webhook_secret')) ? ['label' => 'Gesetzt', 'ton' => 'gut'] : ['label' => 'Fehlt', 'ton' => 'offen']],
['text' => 'Steuersatz bei Stripe: '.(filled(config('services.stripe.tax_rate')) ? 'hinterlegt' : 'nicht hinterlegt'), 'neben' => 'Steuerstatus und Belegangaben sind noch nicht entschieden (OPEN-06). Ohne sie gibt es keinen Steuerausweis auf der Stripe-Kasse und keine Rechnungsvorlage.', 'zustand' => filled(config('services.stripe.tax_rate')) ? ['label' => 'Hinterlegt', 'ton' => 'gut'] : ['label' => 'Offen', 'ton' => 'offen']],
['text' => 'Kauf auf Rechnung für Vereine: '.(Shop::invoice() ? 'angeboten' : 'aus'), 'neben' => 'Die Rechnung erstellt der Betreiber manuell; den Zahlungseingang bestätigst du in der Bestellverwaltung.', 'zustand' => ['label' => Shop::invoice() ? 'Bereit' : 'Aus', 'ton' => 'neutral']],
];
$freigabe = [
['text' => 'Produktivfreigabe (SHOP_LIVE_RELEASE): '.(config('shop.live_release') === true ? 'gesetzt' : 'nicht gesetzt'), 'neben' => 'Standardmäßig aus. Setzt Lars in der Umgebungsdatei des Servers, wenn er den Verkauf freigibt. Ohne sie bleibt der Shop in Produktion abgeschaltet und Stripe nimmt dort keine Zahlung an.', 'zustand' => config('shop.live_release') === true ? ['label' => 'Gesetzt', 'ton' => 'gut'] : ['label' => 'Aus', 'ton' => 'neutral']],
['text' => 'Umgebung: '.(app()->isProduction() ? 'Produktion' : 'Test oder lokal'), 'neben' => app()->isProduction() ? 'Der Shop ist hier '.(Shop::enabled() ? 'aktiv.' : 'abgeschaltet.') : 'Hier läuft der Shop mit Test- oder Sandbox-Zahlung.', 'zustand' => app()->isProduction() ? (Shop::enabled() ? ['label' => 'Live', 'ton' => 'gut'] : ['label' => 'Abgeschaltet', 'ton' => 'neutral']) : ['label' => 'Test', 'ton' => 'neutral']],
];
$angebote = [
['text' => $withoutScope === 0 ? 'Alle aktiven Käufe haben einen Nutzerkreis.' : $withoutScope.' aktive Kaufangebote ohne festgelegten Nutzerkreis', 'neben' => $withoutScope === 0 ? null : 'Käufer sähen „Nutzerkreis nicht festgelegt“. Lege Einzel- oder Mehrfachlizenz mit „Geänderte Fassung aktivieren“ am Angebot fest.', 'zustand' => $withoutScope === 0 ? ['label' => 'Vollständig', 'ton' => 'gut'] : ['label' => 'Offen', 'ton' => 'offen']],
];
return [
'kopf' => [
'titel' => 'Verkaufsstart',
'typ' => 'Bereitschaft für den Verkauf in Deutschland',
'status' => ['text' => SalesTerms::missingPages() === [] ? 'Alle Rechtstexte sind veröffentlicht. Die rechtliche Freigabe der Inhalte steht aus, bis die Rechtsberatung sie bestätigt.' : 'Es fehlen veröffentlichte Rechtstexte. Ohne sie bleibt der Shop in Produktion abgeschaltet.', 'ton' => SalesTerms::missingPages() === [] ? 'gut' : 'offen'],
],
'haupt' => [
['titel' => 'Rechtstexte im Bestellablauf', 'hilfe' => 'Der Checkout verlinkt diese Seiten und hält mit jeder Bestellung fest, welche Fassung galt. Den Wortlaut der Zustimmungen im Checkout hat der Betreiber noch rechtlich zu prüfen (Entwurf '.SalesTerms::VERSION.').', 'zeilen' => $legal],
['titel' => 'Zahlung und Belege', 'zeilen' => $zahlung],
],
'seite' => [
['titel' => 'Freigabe', 'zeilen' => $freigabe, 'hilfe' => 'Die Produktivfreigabe liegt bei Lars. Sie wird nicht über diese Oberfläche gesetzt.'],
['titel' => 'Angebote', 'zeilen' => $angebote],
],
];
}
}
@@ -40,6 +40,9 @@ class ListContentElements extends ListRecords
#[Url(as: 'freigabe', except: '')]
public string $freigabe = '';
#[Url(as: 'schutz', except: '')]
public string $schutz = '';
#[Url(as: 'entwurf', except: '')]
public string $entwurf = '';
@@ -85,7 +88,7 @@ public function content(Schema $schema): Schema
protected function bestandFilterEigenschaften(): array
{
return ['suche', 'art', 'freigabe', 'entwurf', 'fassung', 'nutzung', 'saeule', 'inhaltsart', 'einordnung', 'verarbeitung', 'archiv'];
return ['suche', 'art', 'schutz', 'freigabe', 'entwurf', 'fassung', 'nutzung', 'saeule', 'inhaltsart', 'einordnung', 'verarbeitung', 'archiv'];
}
public function showingList(): bool
@@ -138,6 +141,7 @@ public function filtersActive(): bool
return trim($this->suche) !== ''
|| $this->art !== ''
|| $this->freigabe !== ''
|| $this->schutz !== ''
|| $this->entwurf !== ''
|| $this->fassung !== ''
|| $this->nutzung !== ''
@@ -153,6 +157,7 @@ public function resetFilters(): void
$this->suche = '';
$this->art = '';
$this->freigabe = '';
$this->schutz = '';
$this->entwurf = '';
$this->fassung = '';
$this->nutzung = '';
@@ -200,11 +205,12 @@ public function bestand(): array
'suche' => ['eigenschaft' => 'suche', 'label' => 'Suche', 'platzhalter' => 'Titel, Beschreibung oder Suchbegriff'],
'filter' => [
['eigenschaft' => 'art', 'label' => 'Technische Art', 'vorgabe' => '', 'alle' => 'Alle Arten', 'optionen' => $optionen($this->typeOptions(), 'value', 'label')],
['eigenschaft' => 'schutz', 'label' => 'Schutz', 'vorgabe' => '', 'alle' => 'Alle Medien', 'optionen' => ['geschuetzt' => 'Geschützte Medien', 'oeffentlich' => 'Öffentliche Medien', 'website' => 'Auf der Website frei']],
['eigenschaft' => 'freigabe', 'label' => 'Freigabe', 'vorgabe' => '', 'alle' => 'Alle Freigaben', 'optionen' => ['freigegeben' => 'Freigegebene Fassung', 'entwurf' => 'Nur offener Entwurf', 'ohne' => 'Keine freigegebene Fassung']],
['eigenschaft' => 'nutzung', 'label' => 'Verwendung', 'vorgabe' => '', 'alle' => 'Verwendung egal', 'optionen' => ['verwendet' => 'Verwendet', 'unbenutzt' => 'Nicht verwendet']],
],
'weitere' => $weitere,
'hinweis' => 'Freigabe meint die Fassung des Mediums, nicht die Website und keinen Zugriff. Materialart und Einordnung sind die redaktionelle Klassifikation; Verwendung zeigt, wo das Medium tatsächlich eingebunden ist. Deaktivierte und archivierte Medien bleiben über „Weitere Filter“ auffindbar.',
'hinweis' => 'Freigabe meint die Fassung des Mediums, nicht die Website und keinen Zugriff. Geschützte Medien haben eine Inhaltsfassung und laufen über Lizenzen. Öffentliche Medien sind eigenständige Präsentationsmedien ohne Fassung für die Website; ob sie freigegeben sind, zeigt die Kennzeichnung an der Zeile. Materialart und Einordnung sind die redaktionelle Klassifikation; Verwendung zeigt, wo das Medium tatsächlich eingebunden ist. Deaktivierte und archivierte Medien bleiben über „Weitere Filter“ auffindbar.',
'zeilen' => array_map($this->zeile(...), $this->cards()),
'einheit' => ['Medium', 'Medien'],
'leer' => ['titel' => 'Noch keine Medien', 'text' => 'Mit „Medium anlegen“ oben lädst du eine Datei hoch oder schreibst einen Text.'],
@@ -218,13 +224,19 @@ public function bestand(): array
*/
private function zeile(array $card): array
{
$chips = [['label' => $card['stand'], 'ton' => match ($card['standTone']) {
$chips = [['label' => $card['presentation'] ? 'Präsentationsmedium, ohne Inhaltsfassung' : $card['stand'], 'ton' => match ($card['standTone']) {
'ready' => 'gut',
'draft' => 'offen',
'blocked' => 'achtung',
default => 'leise',
}]];
if ($card['websiteReleased']) {
$chips[] = ['label' => 'Für die Website freigegeben', 'ton' => 'gut'];
} elseif ($card['presentation']) {
$chips[] = ['label' => 'Nicht für die Website freigegeben', 'ton' => 'offen'];
}
foreach ([['draftNote', 'offen'], ['blockedNote', 'achtung'], ['processing', 'offen'], ['versionLabel', 'leise']] as [$feld, $ton]) {
if (filled($card[$feld] ?? null)) {
$chips[] = ['label' => (string) $card[$feld], 'ton' => $ton];
@@ -272,6 +284,7 @@ private function libraryFilters(): array
'suche' => $this->suche,
'art' => $this->art,
'freigabe' => $this->freigabe,
'schutz' => $this->schutz,
'entwurf' => $this->entwurf,
'fassung' => $this->fassung,
'nutzung' => $this->nutzung,
@@ -17,6 +17,7 @@
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\WebsiteImageUsage;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Media\PresentationFile;
use App\Domain\Media\ThumbnailRef;
use App\Domain\Media\WebsiteMedia;
use App\Domain\Media\WebsiteRelease;
@@ -37,6 +38,7 @@
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Blade;
use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
use Livewire\WithFileUploads;
@@ -92,6 +94,9 @@ class ViewContentElement extends ViewRecord
public string $websiteFeedback = '';
/** Gewählte Website-Datei für Film oder Hörstück (ungeschützt, getrennt von der Inhaltsfassung). */
public mixed $websiteUpload = null;
public int|string|null $kindId = null;
/** @var list<int|string> */
@@ -262,8 +267,9 @@ public function adoptFrame(): void
/** @var ContentElement $element */
$element = $this->getRecord();
$shown = $this->shownVersion();
$fromWebsiteFile = ! $shown instanceof ContentElementVersion && $this->hasWebsiteFilm($element);
if (! $shown instanceof ContentElementVersion || $element->output_class !== 'film') {
if ((! $shown instanceof ContentElementVersion && ! $fromWebsiteFile) || $element->output_class !== 'film') {
$this->pictureFeedback = 'Für dieses Medium gibt es keine Filmstelle.';
return;
@@ -286,7 +292,9 @@ public function adoptFrame(): void
$this->keepAlt($element);
$element->thumbnail_error = null;
$element->save();
DeriveThumbnail::dispatch('element', $element->id, null, null, $shown->id, $seconds);
$fromWebsiteFile
? DeriveThumbnail::dispatch('element', $element->id, null, null, null, $seconds, true)
: DeriveThumbnail::dispatch('element', $element->id, null, null, $shown->id, $seconds);
$element->refresh();
$this->pictureFeedback = $element->thumbnail_error
?: 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.';
@@ -361,10 +369,24 @@ public function useOwnImage(): void
?: 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.';
}
/** Ein Film ohne Inhaltsfassung, aber mit Website-Datei: die Filmstelle kommt aus dieser Datei. */
public function hasWebsiteFilm(?ContentElement $element = null): bool
{
$element ??= $this->getRecord();
return $element->output_class === 'film'
&& filled($element->preview_path)
&& ! $element->versions()->exists();
}
public function framePreviewUrl(): ?string
{
$shown = $this->shownVersion();
if (! $shown instanceof ContentElementVersion && $this->hasWebsiteFilm() && is_numeric($this->frameSecond) && trim($this->frameSecond) !== '') {
return route('content.website-frame', ['element' => $this->getRecord(), 'sekunde' => $this->frameSecond]);
}
if (! $shown instanceof ContentElementVersion || ! is_numeric($this->frameSecond) || trim($this->frameSecond) === '') {
return null;
}
@@ -844,6 +866,61 @@ public function releaseForWebsite(): void
$element->refresh();
}
/**
* Legt die Datei ab, die auf der Website laufen soll (zum Beispiel ein Trailer). Die geschützte Inhaltsfassung
* bleibt unberührt; öffentlich wird die Datei erst mit der Website-Freigabe.
*/
public function storeWebsiteFile(): void
{
abort_unless(ContentElementResource::editor(), 403);
/** @var ContentElement $element */
$element = $this->getRecord();
if (! in_array($element->output_class, ['film', 'audio'], true)) {
$this->websiteFeedback = 'Eine Website-Datei gibt es nur für Filme und Hörstücke.';
return;
}
if (! $this->websiteUpload instanceof TemporaryUploadedFile) {
$this->websiteFeedback = 'Wähle zuerst eine Datei.';
return;
}
$files = app(PresentationFile::class);
$extension = strtolower($this->websiteUpload->getClientOriginalExtension());
if (! in_array($extension, PresentationFile::EXTENSIONS[$element->output_class], true)) {
$this->websiteFeedback = 'Für die Website geht nur '.$files->formats($element->output_class).'. Eine .'.$extension.'-Datei kann der Browser nicht direkt abspielen.';
return;
}
$path = $this->websiteUpload->storeAs('inhalte', 'web-'.bin2hex(random_bytes(6)).'.'.$extension, 'cms_incoming');
$this->websiteUpload = null;
if (! is_string($path)) {
$this->websiteFeedback = 'Die Datei wurde nicht übernommen.';
return;
}
try {
$files->store($element, $path);
} catch (DomainRuleException $e) {
$this->websiteFeedback = $e->getMessage();
return;
}
$element->refresh();
$this->websiteFeedback = filled($element->thumbnail_error)
? (string) $element->thumbnail_error
: 'Die Website-Datei ist übernommen. Sie ist erst nach „Für die Website freigeben“ öffentlich. Ein bereits freigegebenes Medium zeigt danach die neue Datei.';
}
public function withdrawWebsite(): void
{
abort_unless(ContentElementResource::editor(), 403);
@@ -970,18 +1047,20 @@ public function previewHtml(): string
if ($this->previewSurface === 'bibliothek') {
$title = trim($this->displayTitle) !== '' ? trim($this->displayTitle) : trim($this->workingTitle);
return view('member.partials.card', [
'href' => '#vorschau',
// Dieselbe Karte wie im Mitgliederbereich (<x-member.card>), ohne Verfügbarkeit: Die entscheidet die Lizenz.
return Blade::render('<x-member.card :card="$card" />', [
'card' => [
'type' => $element->output_class === 'film' ? 'film' : 'material',
'url' => '#vorschau',
'title' => $title !== '' ? $title : $element->working_title,
'summary' => trim($this->summary) !== '' ? trim($this->summary) : null,
'kind' => PublicMaterialReader::outputLabel((string) $element->output_class),
'coverage' => 'offen',
'hide_status' => true,
'image' => trim($this->thumbnailAlt) !== '' ? trim($this->thumbnailAlt) : $title,
'image_url' => ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path),
'error' => 'Vorschau der Kartenform. Ob jemand sie öffnen darf, entscheidet die Lizenz.',
],
])->render();
]);
}
$subject = app(PublicMaterialReader::class)->subject($element->id, true, $draft);
@@ -0,0 +1,65 @@
<?php
namespace App\Filament\Resources\DiscountCodes;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Filament\Resources\DiscountCodes\Pages\ListDiscountCodes;
use App\Filament\Resources\DiscountCodes\Pages\ViewDiscountCode;
use App\Filament\Support\ShopAccess;
use Filament\Resources\Resource;
use Filament\Schemas\Schema;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use Illuminate\Auth\Access\Response;
use Illuminate\Database\Eloquent\Model;
/**
* Rabattcodes (FACH-14): anlegen, bearbeiten, zeitlich begrenzen, deaktivieren und einzelne Konten freischalten.
* Die Seiten nutzen die gemeinsamen Bausteine (Bestandsliste, Objektseite, Dialoge) wie die übrigen Kataloglisten.
*/
class DiscountCodeResource extends Resource
{
protected static ?string $model = DiscountCode::class;
protected static string|\UnitEnum|null $navigationGroup = 'Verkauf';
protected static ?string $navigationLabel = 'Rabattcodes';
protected static ?string $modelLabel = 'Rabattcode';
protected static ?string $pluralModelLabel = 'Rabattcodes';
protected static ?string $recordTitleAttribute = 'code';
protected static ?int $navigationSort = 2;
public static function canViewAny(): bool
{
return ShopAccess::allowed();
}
public static function getViewAuthorizationResponse(Model $record): Response
{
return ShopAccess::allowed() ? Response::allow() : Response::deny();
}
public static function form(Schema $schema): Schema
{
return $schema;
}
public static function table(Table $table): Table
{
return $table->columns([
TextColumn::make('code')->label('Code')->searchable(),
]);
}
public static function getPages(): array
{
return [
'index' => ListDiscountCodes::route('/'),
'view' => ViewDiscountCode::route('/{record}'),
];
}
}
@@ -0,0 +1,103 @@
<?php
namespace App\Filament\Resources\DiscountCodes\Pages;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Domain\Commerce\Discount\DiscountService;
use App\Filament\Resources\DiscountCodes\DiscountCodeResource;
use App\Filament\Support\DiscountCodeForm;
use App\Filament\Support\ListsCatalog;
use App\Filament\Support\ReportsDomainRules;
use Filament\Actions\Action;
use Filament\Resources\Pages\ListRecords;
use Illuminate\Contracts\Support\Htmlable;
class ListDiscountCodes extends ListRecords
{
use ListsCatalog;
use ReportsDomainRules;
protected static string $resource = DiscountCodeResource::class;
public function getSubheading(): string|Htmlable|null
{
return 'Ein Code gilt für den ganzen Warenkorb oder nur für ausgewählte Ziele, und er ist allgemein einlösbar oder nur für freigeschaltete Konten. Beides stellst du unabhängig voneinander ein. Pro Bestellung gilt höchstens ein Code.';
}
protected function getHeaderActions(): array
{
return [
Action::make('create')->label('Code anlegen')
->modalHeading('Neuer Rabattcode')
->modalDescription('Dieselbe Maske öffnet sich später beim Bearbeiten. Freigaben für einzelne Konten verwaltest du danach auf der Seite des Codes.')
->modalSubmitActionLabel('Code anlegen')
->modalWidth('3xl')
->fillForm(['kind' => DiscountCode::PERCENT, 'scope' => DiscountCode::SCOPE_CART, 'eligibility' => DiscountCode::OPEN, 'active' => true])
->schema(DiscountCodeForm::schema())
->action(function (array $data): void {
$code = null;
$this->report(function () use ($data, &$code): void {
[$fields, $targets] = DiscountCodeForm::fromForm($data);
$code = app(DiscountService::class)->save($fields, $targets);
}, 'Der Rabattcode ist angelegt.');
if ($code instanceof DiscountCode) {
$this->redirect(DiscountCodeResource::getUrl('view', ['record' => $code]));
}
}),
];
}
protected function catalogRows(): array
{
$rows = [];
$now = now();
foreach (DiscountCode::query()->with('targets')->withCount(['releases as active_releases_count' => fn ($query) => $query->whereNull('revoked_at')])->orderByDesc('id')->get() as $code) {
$state = $code->stateAt($now);
$url = DiscountCodeResource::getUrl('view', ['record' => $code]);
$rows[] = [
'schluessel' => 'c'.$code->id,
'titel' => $code->code,
'meta' => 'Rabattcode · '.$code->label,
'text' => $code->valueLabel().' · '.($code->forSelection() ? 'ausgewählte Ziele ('.$code->targets->count().')' : 'gesamter Warenkorb').' · '.($code->restricted() ? 'nur freigeschaltete Konten' : 'allgemein einlösbar'),
'symbol' => 'etikett',
'url' => $url,
'chips' => [
match ($state) {
'aktiv' => ['label' => 'Gültig', 'ton' => 'gut'],
'abgelaufen' => ['label' => 'Abgelaufen', 'ton' => 'leise'],
'noch_nicht' => ['label' => 'Noch nicht gültig', 'ton' => 'offen'],
default => ['label' => 'Deaktiviert', 'ton' => 'leise'],
},
['label' => $code->valueLabel(), 'ton' => 'neutral'],
['label' => $code->restricted() ? $code->active_releases_count.' freigeschaltet' : 'Allgemein', 'ton' => 'neutral'],
],
'zustand' => [$state === 'aktiv' ? 'aktiv' : 'inaktiv'],
'aktionen' => [['label' => 'Öffnen', 'href' => $url]],
];
}
return $rows;
}
protected function zustandOptionen(): array
{
return ['alle' => 'Jeder Zustand', 'aktiv' => 'Gerade gültig', 'inaktiv' => 'Abgelaufen, deaktiviert oder noch nicht gültig'];
}
protected function suchPlatzhalter(): string
{
return 'Code oder Name';
}
protected function einheit(): array
{
return ['Rabattcode', 'Rabattcodes'];
}
protected function leer(): array
{
return ['titel' => 'Noch keine Rabattcodes', 'text' => 'Mit „Code anlegen“ oben entsteht der erste Rabattcode, zum Beispiel der gemeinsame Zertifizierungscode.'];
}
}
@@ -0,0 +1,293 @@
<?php
namespace App\Filament\Resources\DiscountCodes\Pages;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Domain\Commerce\Discount\DiscountRelease;
use App\Domain\Commerce\Discount\DiscountService;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\Order;
use App\Filament\Resources\DiscountCodes\DiscountCodeResource;
use App\Filament\Support\DiscountCodeForm;
use App\Filament\Support\ReportsDomainRules;
use App\Models\User;
use Filament\Actions\Action;
use Filament\Forms\Components\DatePicker;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;
use Filament\Resources\Pages\ViewRecord;
use Filament\Schemas\Components\View;
use Filament\Schemas\Schema;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Carbon;
/**
* Rabattcode im gemeinsamen Rahmen. Bearbeiten nutzt dieselbe Maske wie Anlegen. Konten werden für genau diesen Code
* freigeschaltet und die Freigabe wird mit Begründung entzogen; der Verlauf bleibt stehen.
*/
class ViewDiscountCode extends ViewRecord
{
use ReportsDomainRules;
protected static string $resource = DiscountCodeResource::class;
public function getTitle(): string|Htmlable
{
return (string) $this->getRecord()->code;
}
public function getHeading(): string|Htmlable
{
return '';
}
public function getMaxContentWidth(): Width|string|null
{
return Width::Full;
}
protected function getHeaderActions(): array
{
return [];
}
/**
* @return array<string, string>
*/
public function getBreadcrumbs(): array
{
return [];
}
public function infolist(Schema $schema): Schema
{
return $schema->components([
View::make('filament.catalog.objekt')->viewData(fn (): array => $this->codeDaten())->columnSpanFull(),
])->columns(1);
}
private function code(): DiscountCode
{
/** @var DiscountCode $code */
$code = $this->getRecord();
return $code;
}
public function editAction(): Action
{
return Action::make('edit')
->label('Code bearbeiten')
->modalHeading(fn (): string => 'Rabattcode „'.$this->code()->code.'“ bearbeiten')
->modalDescription('Bestellungen, die schon aufgegeben sind, behalten ihren gespeicherten Rabatt. Eine Änderung wirkt auf künftige Einlösungen und auf offene Warenkörbe. „Abbrechen“ verwirft die Eingaben.')
->modalSubmitActionLabel('Änderungen speichern')
->modalWidth('3xl')
->fillForm(fn (): array => DiscountCodeForm::fill($this->code()))
->schema(DiscountCodeForm::schema())
->action(function (array $data): void {
$this->report(function () use ($data): void {
[$fields, $targets] = DiscountCodeForm::fromForm($data);
app(DiscountService::class)->save($fields, $targets, $this->code());
}, 'Der Rabattcode ist gespeichert.');
$this->refreshRecord();
});
}
public function toggleAction(): Action
{
return Action::make('toggle')
->label(fn (): string => $this->code()->active ? 'Code deaktivieren' : 'Code aktivieren')
->color(fn (): string => $this->code()->active ? 'danger' : 'success')
->requiresConfirmation()
->modalHeading(fn (): string => $this->code()->active ? 'Code „'.$this->code()->code.'“ deaktivieren?' : 'Code „'.$this->code()->code.'“ aktivieren?')
->modalDescription(fn (): string => $this->code()->active
? 'Der Code lässt sich danach nicht mehr einlösen. In offenen Warenkörben zeigt die Bestellübersicht den Grund; bereits aufgegebene Bestellungen bleiben unverändert. Freigaben und Einstellungen bleiben erhalten.'
: 'Der Code lässt sich danach wieder einlösen, soweit sein Gültigkeitszeitraum und die Freigaben es zulassen.')
->modalSubmitActionLabel(fn (): string => $this->code()->active ? 'Deaktivieren' : 'Aktivieren')
->action(function (): void {
$code = $this->code();
$this->report(function () use ($code): string {
app(DiscountService::class)->setActive($code, ! $code->active);
return $code->active ? 'Der Code ist aktiviert.' : 'Der Code ist deaktiviert.';
}, 'Gespeichert.');
$this->refreshRecord();
});
}
public function releaseAction(): Action
{
return Action::make('release')
->label('Konto freischalten')
->modalHeading(fn (): string => 'Konto für den Code „'.$this->code()->code.'“ freischalten')
->modalDescription('Das Konto darf genau diesen Code einlösen, solange Code und Freigabe gültig sind, auch bei späteren Bestellungen. Die Freigabe gilt nicht für andere Codes. Prüfe vorher die Zertifizierung des Kontos.')
->modalSubmitActionLabel('Konto freischalten')
->schema([
Select::make('user_id')->label('Mitgliedskonto')->required()->searchable()
->getSearchResultsUsing(fn (string $search): array => $this->searchMembers($search))
->getOptionLabelUsing(fn ($value): ?string => ($user = User::query()->find($value)) === null ? null : $user->name.' ('.$user->email.')')
->helperText('Suche nach Name oder E-Mail-Adresse. Nur Konten mit Mitgliedsprofil.'),
DatePicker::make('valid_until')->label('Freigabe gültig bis einschließlich')->native(false)->displayFormat('d.m.Y')
->helperText('Leer: ohne Ende. Danach gilt der Code für dieses Konto nicht mehr.'),
Textarea::make('reason')->label('Grundlage der Freigabe')->rows(2)->maxLength(500)
->helperText('Zum Beispiel „Zertifikat vom 12.11.2026 geprüft“. Bleibt im Verlauf stehen.'),
])
->visible(fn (): bool => $this->code()->restricted())
->action(function (array $data): void {
$this->report(function () use ($data): string {
$member = User::query()->findOrFail($data['user_id']);
$until = filled($data['valid_until'] ?? null) ? Carbon::parse((string) $data['valid_until'], config('app.timezone'))->endOfDay() : null;
app(DiscountService::class)->release($this->code(), $member, auth('staff')->user() ?? auth()->user(), $until, $data['reason'] ?? null);
return 'Das Konto von '.$member->name.' ist für den Code freigeschaltet.';
}, 'Das Konto ist freigeschaltet.');
$this->refreshRecord();
});
}
public function revokeAction(): Action
{
return Action::make('revoke')
->label('Freigabe entziehen')
->color('danger')
->requiresConfirmation()
->modalHeading('Freigabe entziehen?')
->modalDescription('Das Konto kann diesen Code danach nicht mehr einlösen. Offene Warenkörbe des Kontos zeigen den Grund und lassen sich erst ohne Code bestellen. Aufgegebene Bestellungen bleiben unverändert; die Freigabe bleibt mit dem Entzug im Verlauf stehen.')
->modalSubmitActionLabel('Freigabe entziehen')
->schema([
Textarea::make('reason')->label('Grund')->rows(2)->maxLength(500),
])
->action(function (array $data, array $arguments): void {
$this->report(function () use ($data, $arguments): string {
$release = DiscountRelease::query()->where('discount_code_id', $this->code()->id)->findOrFail((int) ($arguments['release'] ?? 0));
app(DiscountService::class)->revoke($release, auth('staff')->user() ?? auth()->user(), $data['reason'] ?? null);
return 'Die Freigabe ist entzogen.';
}, 'Die Freigabe ist entzogen.');
$this->refreshRecord();
});
}
private function refreshRecord(): void
{
$this->getRecord()->unsetRelations();
$this->getRecord()->refresh();
}
/**
* @return array<int, string>
*/
private function searchMembers(string $search): array
{
$like = '%'.mb_strtolower(trim($search)).'%';
return User::query()
->whereNotNull('party_id')
->where(fn ($query) => $query->whereRaw('LOWER(name) LIKE ?', [$like])->orWhereRaw('LOWER(email) LIKE ?', [$like]))
->orderBy('name')
->limit(20)
->get()
->mapWithKeys(fn (User $user): array => [$user->id => $user->name.' ('.$user->email.')'])
->all();
}
/**
* @return array<string, mixed>
*/
private function codeDaten(): array
{
$code = $this->code();
$code->loadMissing('targets');
$state = $code->stateAt(now());
$date = fn (?Carbon $value): string => $value === null ? '' : $value->timezone(config('app.timezone'))->format('d.m.Y');
$targets = [];
foreach ($code->targets as $target) {
$targets[] = match ($target->target_type) {
DiscountCode::TARGET_OFFER => 'Angebot „'.(Offer::query()->find($target->target_id)?->name ?? 'gelöscht').'“',
DiscountCode::TARGET_ARTICLE => 'Lizenzartikel '.(LicenseArticle::query()->find($target->target_id)?->code ?? 'gelöscht'),
DiscountCode::TARGET_BUNDLE => 'Paket „'.(Bundle::query()->find($target->target_id)?->name ?? 'gelöscht').'“',
default => 'Ziel',
};
}
$releases = $code->releases()->with(['user', 'grantor'])->get();
$active = $releases->filter(fn (DiscountRelease $release): bool => $release->revoked_at === null);
$past = $releases->filter(fn (DiscountRelease $release): bool => $release->revoked_at !== null);
$orders = Order::query()->where('discount_code_id', $code->id)->with('user')->latest('id')->limit(10)->get();
$paid = Order::query()->where('discount_code_id', $code->id)->where('status', 'bezahlt')->count();
return [
'kopf' => [
'brot' => [['label' => 'Rabattcodes', 'href' => DiscountCodeResource::getUrl('index')], $code->code],
'titel' => $code->code,
'typ' => 'Rabattcode · '.$code->label,
'status' => match ($state) {
'aktiv' => ['text' => 'Gerade gültig'.($code->valid_until ? ' bis einschließlich '.$date($code->valid_until) : ''), 'ton' => 'gut'],
'abgelaufen' => ['text' => 'Abgelaufen am '.$date($code->valid_until).'. Der Code lässt sich nicht mehr einlösen.', 'ton' => 'offen'],
'noch_nicht' => ['text' => 'Gilt erst ab dem '.$date($code->valid_from).'.', 'ton' => 'offen'],
default => ['text' => 'Deaktiviert. Der Code lässt sich nicht einlösen.', 'ton' => 'offen'],
},
'aktionen' => [
['label' => 'Code bearbeiten', 'wire' => "mountAction('edit')", 'art' => 'primary'],
...($code->restricted() ? [['label' => 'Konto freischalten', 'wire' => "mountAction('release')", 'art' => 'line']] : []),
['label' => $code->active ? 'Code deaktivieren' : 'Code aktivieren', 'wire' => "mountAction('toggle')", 'art' => 'line'],
],
],
'haupt' => [
[
'titel' => 'Der Code auf einen Blick',
'hilfe' => 'Geltungsbereich und Einlösungsberechtigung sind zwei getrennte Einstellungen. Der Rabatt ändert den Preis, nie den Nutzungsumfang.',
'zeilen' => [
['text' => 'Rabatt: '.$code->valueLabel(), 'neben' => $code->kind === DiscountCode::PERCENT ? 'Je Position gerundet.' : 'Je Bestellung, anteilig auf die betroffenen Positionen verteilt.'],
['text' => 'Geltungsbereich: '.($code->forSelection() ? 'nur ausgewählte Ziele' : 'gesamter Warenkorb'), 'neben' => $code->forSelection() ? 'Ein Paket ist ein eigenes Ziel und folgt nicht aus einem enthaltenen Artikel.' : null],
...array_map(fn (string $target): array => ['text' => '· '.$target, 'neben' => null], $targets),
['text' => 'Einlösung: '.($code->restricted() ? 'nur freigeschaltete Konten' : 'allgemein, für alle angemeldeten Käufer'), 'neben' => 'Pro Bestellung gilt höchstens ein Code.'],
['text' => 'Gültigkeit: '.($code->valid_from ? 'ab '.$date($code->valid_from) : 'sofort').($code->valid_until ? ' bis einschließlich '.$date($code->valid_until) : ', unbegrenzt'), 'neben' => $code->active ? 'Aktiv' : 'Deaktiviert'],
...(filled($code->note) ? [['text' => 'Notiz: '.$code->note, 'neben' => null]] : []),
],
],
[
'titel' => $code->restricted() ? 'Freigeschaltete Konten' : 'Freigaben',
'zusatz' => $code->restricted() ? $active->count().' aktiv' : null,
'hilfe' => $code->restricted()
? 'Nur diese Konten können den Code einlösen. Die Freigabe gilt nur für diesen Code und wiederholt, solange Code und Freigabe gültig sind.'
: 'Der Code ist allgemein einlösbar. Freigaben sind nicht nötig. Stelle „Einlösung“ auf freigeschaltete Konten, um den Code zu beschränken.',
'zeilen' => $code->restricted() ? $active->map(fn (DiscountRelease $release): array => [
'text' => ($release->user?->name ?? 'Konto').' ('.($release->user?->email ?? '').')',
'neben' => 'freigeschaltet am '.$date($release->granted_at).($release->grantor ? ' von '.$release->grantor->name : '').($release->valid_until ? ', gültig bis einschließlich '.$date($release->valid_until) : '').(filled($release->reason) ? ' · '.$release->reason : ''),
'aktion' => ['label' => 'Entziehen', 'wire' => "mountAction('revoke', { release: ".$release->id.' })'],
])->values()->all() : [],
'leer' => ['titel' => $code->restricted() ? 'Noch kein Konto freigeschaltet' : 'Keine Freigaben nötig', 'text' => $code->restricted() ? 'Mit „Konto freischalten“ oben gibst du ein Konto für diesen Code frei, zum Beispiel nach der Prüfung eines Zertifikats.' : 'Jeder angemeldete Käufer kann den Code einlösen.'],
],
],
'seite' => [
[
'titel' => 'Verwendung',
'zeilen' => $orders->map(fn (Order $order): array => [
'text' => 'Bestellung '.$order->id.' · −'.Money::format((int) $order->discount_cents),
'zustand' => ['label' => match ($order->status) {
'bezahlt' => 'Bezahlt', 'erstattet' => 'Erstattet', 'fehlgeschlagen' => 'Fehlgeschlagen', default => 'Offen'
}, 'ton' => $order->status === 'bezahlt' ? 'gut' : 'leise'],
'neben' => ($order->user?->name ?? '').' · '.$date($order->created_at),
])->all(),
'leer' => 'Der Code wurde noch in keiner Bestellung verwendet.',
'hilfe' => $orders->isEmpty() ? null : $paid.' bezahlte Bestellung'.($paid === 1 ? '' : 'en').' mit diesem Code. Gezeigt werden die letzten zehn.',
],
[
'titel' => 'Entzogene Freigaben',
'zeilen' => $past->map(fn (DiscountRelease $release): array => [
'text' => ($release->user?->name ?? 'Konto'),
'neben' => 'entzogen am '.$date($release->revoked_at).(filled($release->reason) ? ' · '.$release->reason : ''),
])->values()->all(),
'leer' => 'Keine Freigabe wurde entzogen.',
'hilfe' => 'Der Verlauf bleibt erhalten.',
],
],
];
}
}
@@ -7,6 +7,7 @@
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionVersion;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -45,6 +46,9 @@ class ViewOffer extends ViewRecord
protected static string $resource = OfferResource::class;
/** Wert der Auswahl „Produktseite“ für ein Paket mit eigener Seite. */
private const OWN_BUNDLE_PAGE = '__paket';
public function getTitle(): string|Htmlable
{
return (string) $this->getRecord()->name;
@@ -120,6 +124,16 @@ public function activateAction(): Action
'organisation' => 'Organisationen und Vereine',
])->required()
->helperText('Wähle die Eignung passend zu den Rechten: Organisationslizenzen brauchen institutionelle Rechte. Das System erzwingt diese Kopplung nicht.'),
Select::make('licence_scope')->label('Nutzerkreis')
->options(LicenceScope::options())
->required()
->live()
->helperText('Wie viele Trainer die Inhalte einsetzen dürfen. Das ist unabhängig vom Lizenzinhaber (Person oder Verein), vom Nutzungszweck der Rechte und vom Preis; es wird aus keinem davon abgeleitet. Der Download bleibt zum Start beim bestellenden Konto. Der Wert wird mit der Bestellung festgehalten.'),
TextInput::make('trainer_count')->label('Anzahl Trainer')
->numeric()->minValue(2)->maxValue(LicenceScope::MAX_TRAINERS)->integer()
->required(fn (Get $get): bool => $get('licence_scope') === LicenceScope::MULTI)
->visible(fn (Get $get): bool => $get('licence_scope') === LicenceScope::MULTI)
->helperText('Höchstzahl der Trainer, die die Inhalte einsetzen dürfen, mindestens 2. Eine Einzellizenz gilt immer für genau einen Trainer.'),
Select::make('grant_kind')->label('Vergabe')->options([
'kauf' => 'Kauf',
'auf_abruf' => 'Auf Abruf',
@@ -201,13 +215,16 @@ public function activateAction(): Action
$version = DB::transaction(function () use ($service, $offer, $data, $lines, $kept, $price) {
$service->assignProduct(
$offer,
filled($data['composition_id'] ?? null) ? (int) $data['composition_id'] : null,
filled($data['composition_id'] ?? null) && $data['composition_id'] !== self::OWN_BUNDLE_PAGE ? (int) $data['composition_id'] : null,
$data['option_label'] ?? null,
($data['composition_id'] ?? null) === self::OWN_BUNDLE_PAGE,
);
return $service->activate($offer, $lines, [
...$kept,
'holder_kind' => $data['holder_kind'],
'licence_scope' => $data['licence_scope'] ?? null,
'trainer_count' => $data['trainer_count'] ?? null,
'grant_kind' => $data['grant_kind'],
'price_cents' => $price,
'composition_version_id' => filled($data['composition_version_id'] ?? null) ? (int) $data['composition_version_id'] : null,
@@ -267,7 +284,7 @@ private function productPages(): array
{
$catalog = app(PublicCatalogReader::class);
return Composition::query()
return [self::OWN_BUNDLE_PAGE => 'Eigene Paketseite · zeigt den Umfang des Pakets (nur für ein Angebot aus genau einer Paketfassung)'] + Composition::query()
->with('editorialContentKind')
->whereNull('archived_at')
->orderBy('designation')
@@ -291,15 +308,17 @@ private function formFromActive(): array
$active = $this->activeVersion();
/** @var Offer $offer */
$offer = $this->getRecord();
$option = ['option_label' => $offer->option_label, 'composition_id' => $offer->composition_id];
$option = ['option_label' => $offer->option_label, 'composition_id' => $offer->standalone_bundle ? self::OWN_BUNDLE_PAGE : $offer->composition_id];
if ($active === null) {
return [...$option, 'holder_kind' => 'person', 'grant_kind' => 'kauf', 'lines' => [['kind' => 'article']]];
return [...$option, 'holder_kind' => 'person', 'licence_scope' => LicenceScope::SINGLE, 'grant_kind' => 'kauf', 'lines' => [['kind' => 'article']]];
}
return [
...$option,
'holder_kind' => $active->holder_kind,
'licence_scope' => $active->licence_scope,
'trainer_count' => $active->trainer_count,
'grant_kind' => $active->grant_kind,
'price_euro' => $active->price_cents === null ? null : number_format($active->price_cents / 100, 2, ',', ''),
'lines' => $active->lines->sortBy('position')->map(fn ($line): array => [
@@ -400,6 +419,7 @@ private function optionAbschnitt(Offer $offer, OfferVersion $active): array
->unique()
->implode('; ');
$seite = $offer->composition;
$eigeneSeite = $offer->standalone_bundle;
$kaufbar = app(OfferService::class)->purchasableVersion($offer) !== null;
return [
@@ -409,10 +429,11 @@ private function optionAbschnitt(Offer $offer, OfferVersion $active): array
'zeilen' => [
['text' => 'Preis: '.$option['price'], 'neben' => $active->grant_kind === 'kauf' ? 'Kauf mit Testzahlung' : CatalogLabels::vergabe($active)],
['text' => 'Geeignet für: '.$option['for'], 'neben' => $option['term']],
['text' => 'Nutzerkreis: '.$option['licence'], 'neben' => $option['licence_scope'] === null ? 'Mit „Geänderte Fassung aktivieren“ festlegen.' : 'Lizenzinhaber, Nutzerkreis und Downloadkonto sind getrennte Angaben.'],
['text' => 'Rechte: '.($rechte !== '' ? $rechte : 'keine'), 'neben' => null],
['text' => 'Zugrunde liegender Inhalt: '.($inhalt !== '' ? $inhalt : '–'), 'neben' => null],
['text' => 'Status: '.($kaufbar ? 'Öffentlich kaufbar' : 'Nicht als Kauf angeboten'), 'neben' => $kaufbar ? 'Aktive Fassung '.$active->number : null],
['text' => 'Produktseite: '.($seite !== null ? ($seite->display_title ?: $seite->designation) : 'noch nicht zugeordnet'), 'neben' => $seite !== null ? 'Option „'.$offer->optionName().'“' : 'Mit „Geänderte Fassung aktivieren“ zuordnen.'],
['text' => 'Produktseite: '.($eigeneSeite ? 'eigene Paketseite mit dem Umfang des Pakets' : ($seite !== null ? ($seite->display_title ?: $seite->designation) : 'noch nicht zugeordnet')), 'neben' => $eigeneSeite || $seite !== null ? 'Option „'.$offer->optionName().'“' : 'Mit „Geänderte Fassung aktivieren“ zuordnen.'],
],
];
}
@@ -0,0 +1,68 @@
<?php
namespace App\Filament\Resources\Orders;
use App\Domain\Commerce\Order;
use App\Filament\Resources\Orders\Pages\ListOrders;
use App\Filament\Resources\Orders\Pages\ViewOrder;
use App\Filament\Support\ShopAccess;
use Filament\Resources\Resource;
use Filament\Schemas\Schema;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use Illuminate\Auth\Access\Response;
use Illuminate\Database\Eloquent\Model;
/**
* Bestellverwaltung (PAY-006): Bestellungen lesen, bei Kauf auf Rechnung den Zahlungseingang bestätigen und
* bezahlte Bestellungen vollständig erstatten. Es gibt keine Bearbeitung der gespeicherten Konditionen.
*/
class OrderResource extends Resource
{
protected static ?string $model = Order::class;
protected static string|\UnitEnum|null $navigationGroup = 'Verkauf';
protected static ?string $navigationLabel = 'Bestellungen';
protected static ?string $modelLabel = 'Bestellung';
protected static ?string $pluralModelLabel = 'Bestellungen';
protected static ?int $navigationSort = 1;
public static function canViewAny(): bool
{
return ShopAccess::allowed();
}
public static function canCreate(): bool
{
return false;
}
public static function getViewAuthorizationResponse(Model $record): Response
{
return ShopAccess::allowed() ? Response::allow() : Response::deny();
}
public static function form(Schema $schema): Schema
{
return $schema;
}
public static function table(Table $table): Table
{
return $table->columns([
TextColumn::make('id')->label('Bestellung'),
]);
}
public static function getPages(): array
{
return [
'index' => ListOrders::route('/'),
'view' => ViewOrder::route('/{record}'),
];
}
}
@@ -0,0 +1,104 @@
<?php
namespace App\Filament\Resources\Orders\Pages;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\Order;
use App\Filament\Resources\Orders\OrderResource;
use App\Filament\Support\ListsCatalog;
use Filament\Resources\Pages\ListRecords;
use Illuminate\Contracts\Support\Htmlable;
class ListOrders extends ListRecords
{
use ListsCatalog;
protected static string $resource = OrderResource::class;
public function getSubheading(): string|Htmlable|null
{
return 'Bestellungen mit Lizenzinhaber, Zahlungsweg und Zahlbetrag. Bei Kauf auf Rechnung bestätigst du hier den Zahlungseingang; bezahlte Bestellungen erstattest du vollständig.';
}
protected function getHeaderActions(): array
{
return [];
}
protected function catalogRows(): array
{
$rows = [];
foreach (Order::query()->with(['lines', 'user', 'party'])->orderByDesc('id')->limit(300)->get() as $order) {
$url = OrderResource::getUrl('view', ['record' => $order]);
$zustand = [$order->status];
$chips = [
match ($order->status) {
'bezahlt' => ['label' => 'Bezahlt', 'ton' => 'gut'],
'erstattet' => ['label' => 'Erstattet', 'ton' => 'leise'],
'fehlgeschlagen' => ['label' => 'Fehlgeschlagen', 'ton' => 'leise'],
default => ['label' => $order->payment_method === 'rechnung' ? 'Offen: wartet auf Zahlungseingang' : 'Offen', 'ton' => 'offen'],
},
['label' => match ($order->payment_method) {
'rechnung' => 'Rechnung', 'stripe' => 'Stripe', default => 'Testzahlung'
}, 'ton' => 'neutral'],
['label' => Money::format($order->payable()), 'ton' => 'neutral'],
];
if ($order->discount_cents > 0) {
$chips[] = ['label' => 'Rabatt '.($order->discount_snapshot['code'] ?? ''), 'ton' => 'neutral'];
}
if ($order->withdrawal_requested_at !== null) {
$chips[] = ['label' => 'Widerruf erklärt', 'ton' => 'offen'];
$zustand[] = 'widerruf';
}
if ($order->payment_method === 'rechnung' && $order->status === 'offen') {
$zustand[] = 'rechnung_offen';
}
$rows[] = [
'schluessel' => 'o'.$order->id,
'titel' => 'Bestellung '.$order->id,
'meta' => ($order->party?->display_name ?? '–').' · bestellt von '.($order->user?->name ?? '–'),
'text' => $order->lines->pluck('offer_name')->implode('; '),
'suchtext' => (string) ($order->user?->email ?? ''),
'symbol' => 'etikett',
'url' => $url,
'chips' => $chips,
'zustand' => $zustand,
'aktionen' => [['label' => 'Öffnen', 'href' => $url]],
];
}
return $rows;
}
protected function zustandOptionen(): array
{
return [
'alle' => 'Jeder Zustand',
'rechnung_offen' => 'Rechnung: wartet auf Zahlungseingang',
'widerruf' => 'Widerruf erklärt',
'offen' => 'Offen',
'bezahlt' => 'Bezahlt',
'erstattet' => 'Erstattet',
];
}
protected function suchPlatzhalter(): string
{
return 'Nummer, Name, E-Mail oder Angebot';
}
protected function einheit(): array
{
return ['Bestellung', 'Bestellungen'];
}
protected function leer(): array
{
return ['titel' => 'Noch keine Bestellungen', 'text' => 'Sobald im Shop bestellt wird, erscheinen die Bestellungen hier.'];
}
}
@@ -0,0 +1,212 @@
<?php
namespace App\Filament\Resources\Orders\Pages;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Commerce\Checkout;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\OrderLine;
use App\Domain\Commerce\Payment;
use App\Filament\Resources\Orders\OrderResource;
use App\Filament\Support\ReportsDomainRules;
use Filament\Actions\Action;
use Filament\Facades\Filament;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Resources\Pages\ViewRecord;
use Filament\Schemas\Components\View;
use Filament\Schemas\Schema;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Carbon;
/**
* Bestellung im gemeinsamen Rahmen. Die gespeicherten Konditionen sind unveränderlich; der Betreiber bestätigt bei
* Kauf auf Rechnung den Zahlungseingang und erstattet bezahlte Bestellungen vollständig (Bundles als Einheit).
*/
class ViewOrder extends ViewRecord
{
use ReportsDomainRules;
protected static string $resource = OrderResource::class;
public function getTitle(): string|Htmlable
{
return 'Bestellung '.$this->order()->id;
}
public function getHeading(): string|Htmlable
{
return '';
}
public function getMaxContentWidth(): Width|string|null
{
return Width::Full;
}
protected function getHeaderActions(): array
{
return [];
}
/**
* @return array<string, string>
*/
public function getBreadcrumbs(): array
{
return [];
}
public function infolist(Schema $schema): Schema
{
return $schema->components([
View::make('filament.catalog.objekt')->viewData(fn (): array => $this->bestellDaten())->columnSpanFull(),
])->columns(1);
}
private function order(): Order
{
/** @var Order $order */
$order = $this->getRecord();
return $order;
}
public function confirmInvoiceAction(): Action
{
return Action::make('confirmInvoice')
->label('Zahlungseingang bestätigen')
->modalHeading(fn (): string => 'Zahlungseingang für Bestellung '.$this->order()->id.' bestätigen')
->modalDescription(fn (): string => 'Du bestätigst, dass '.Money::format($this->order()->payable()).' für die Rechnung eingegangen sind. Die Inhalte werden sofort für das bestellende Konto freigeschaltet; Lizenzinhaber bleibt '.($this->order()->party?->display_name ?? 'der Käufer').'. Die Bestätigung lässt sich nicht zurücknehmen, nur die Bestellung erstatten.')
->modalSubmitActionLabel('Zahlungseingang bestätigen')
->schema([
TextInput::make('reference')->label('Rechnungsnummer oder Buchungsreferenz')->required()->maxLength(120)
->helperText('Bleibt an der Zahlung gespeichert, zum Beispiel „RE-2026-014“.'),
])
->visible(fn (): bool => $this->order()->payment_method === 'rechnung' && $this->order()->status === 'offen')
->action(function (array $data): void {
$this->report(function () use ($data): string {
app(Checkout::class)->confirmInvoicePayment($this->order(), (string) $data['reference'], Filament::auth()->user());
return 'Der Zahlungseingang ist bestätigt. Die Inhalte sind freigeschaltet.';
}, 'Bestätigt.');
$this->order()->unsetRelations();
$this->order()->refresh();
});
}
public function refundAction(): Action
{
return Action::make('refund')
->label('Bestellung erstatten')
->color('danger')
->modalHeading(fn (): string => 'Bestellung '.$this->order()->id.' vollständig erstatten?')
->modalDescription(fn (): string => 'Alle Positionen dieser Bestellung werden zurückgegeben: Die Berechtigungen daraus werden widerrufen, andere Erwerbsquellen (kostenlose Vergabe, frühere Käufe) bleiben unberührt. Pakete sind eine Einheit; Teilerstattungen gibt es zum Start nicht. '.(
$this->order()->payments()->where('provider', 'stripe')->where('status', 'bestaetigt')->exists()
? 'Die Rückzahlung von '.Money::format($this->order()->payable()).' wird bei Stripe veranlasst; nur wenn Stripe sie annimmt, werden die Rechte entzogen.'
: 'Die Rückzahlung selbst veranlasst du außerhalb dieser Anwendung, zum Beispiel per Überweisung.'
))
->modalSubmitActionLabel('Vollständig erstatten')
->schema([
Textarea::make('reason')->label('Begründung')->required()->rows(2)->maxLength(500)
->helperText('Bleibt am Widerruf der Berechtigungen stehen, zum Beispiel „Widerruf geprüft, Frist gewahrt“.'),
])
->visible(fn (): bool => $this->order()->status === 'bezahlt')
->action(function (array $data): void {
$this->report(function () use ($data): string {
app(Checkout::class)->refund($this->order(), (string) $data['reason']);
return 'Die Bestellung ist erstattet. Die Berechtigungen sind widerrufen.';
}, 'Erstattet.');
$this->order()->unsetRelations();
$this->order()->refresh();
});
}
/**
* @return array<string, mixed>
*/
private function bestellDaten(): array
{
$order = $this->order();
$order->loadMissing(['lines', 'user', 'party', 'payments']);
$date = fn (?Carbon $value): string => $value === null ? '' : $value->timezone(config('app.timezone'))->format('d.m.Y H:i');
$method = match ($order->payment_method) {
'rechnung' => 'Überweisung auf Rechnung (manuell)',
'stripe' => 'Stripe',
default => 'Testzahlung',
};
return [
'kopf' => [
'brot' => [['label' => 'Bestellungen', 'href' => OrderResource::getUrl('index')], 'Bestellung '.$order->id],
'titel' => 'Bestellung '.$order->id,
'typ' => 'Lizenzinhaber: '.($order->party?->display_name ?? '–').' · bestellt von '.($order->user?->name ?? '–').' ('.($order->user?->email ?? '').')',
'status' => [
['text' => match ($order->status) {
'bezahlt' => 'Bezahlt ('.$method.')',
'erstattet' => 'Erstattet. Die Berechtigungen sind widerrufen.',
'fehlgeschlagen' => 'Zahlung fehlgeschlagen. Es wurde nichts freigeschaltet.',
default => $order->payment_method === 'rechnung' ? 'Offen: Rechnung erstellen und Zahlungseingang bestätigen.' : 'Offen: Zahlung steht aus.',
}, 'ton' => $order->status === 'bezahlt' ? 'gut' : 'offen'],
$order->withdrawal_requested_at !== null ? ['text' => 'Widerruf erklärt am '.$date($order->withdrawal_requested_at).'. Prüfen und gegebenenfalls erstatten.', 'ton' => 'offen'] : null,
],
'aktionen' => [
...($order->payment_method === 'rechnung' && $order->status === 'offen' ? [['label' => 'Zahlungseingang bestätigen', 'wire' => "mountAction('confirmInvoice')", 'art' => 'primary']] : []),
...($order->status === 'bezahlt' ? [['label' => 'Bestellung erstatten', 'wire' => "mountAction('refund')", 'art' => 'line']] : []),
],
],
'haupt' => [
[
'titel' => 'Positionen',
'hilfe' => 'Fassung, Preis, Rabatt, Nutzerkreis und Umfang sind beim Kauf festgehalten und ändern sich nicht.',
'zeilen' => $order->lines->map(fn (OrderLine $line): array => [
'text' => ($line->offer_name ?: 'Angebot').': '.Money::format((int) $line->price_cents).($line->discount_cents > 0 ? ' − Rabatt '.Money::format((int) $line->discount_cents).' = '.Money::format($line->payable()) : ''),
'neben' => LicenceScope::label($line->licence_scope, $line->trainer_count).' · Angebotsfassung '.($line->offerVersion?->number ?? '–'),
])->values()->all(),
'leer' => ['titel' => 'Keine Positionen', 'text' => 'Diese Bestellung hat keine Positionen.'],
],
[
'titel' => 'Beträge',
'zeilen' => [
['text' => 'Zwischensumme (Listenpreise): '.Money::format($order->subtotal()), 'neben' => null],
...($order->discount_cents > 0 ? [['text' => 'Rabatt: −'.Money::format((int) $order->discount_cents), 'neben' => 'Code '.($order->discount_snapshot['code'] ?? '').' · '.($order->discount_snapshot['label'] ?? '')]] : []),
['text' => 'Zahlbetrag: '.Money::format($order->payable()), 'neben' => 'Dieser Betrag ging an '.$method.'.'],
],
],
[
'titel' => 'Zahlungen',
'zeilen' => $order->payments->map(fn (Payment $payment): array => [
'text' => match ($payment->provider) {
'stripe' => 'Stripe', 'ueberweisung' => 'Überweisung', default => 'Testzahlung'
}.' · '.match ($payment->status) {
'bestaetigt' => 'bestätigt', 'erstattet' => 'erstattet', 'offen' => 'offen', 'abgelaufen' => 'abgelaufen', 'zu_pruefen' => 'zu prüfen', 'fehlgeschlagen' => 'fehlgeschlagen', default => $payment->status
},
'neben' => $payment->provider_reference.($payment->amount_cents !== null ? ' · '.Money::format((int) $payment->amount_cents) : ''),
])->values()->all(),
'leer' => ['titel' => 'Noch keine Zahlung', 'text' => 'Es gibt noch keinen Zahlungsvorgang zu dieser Bestellung.'],
],
],
'seite' => [
[
'titel' => 'Zustimmung',
'zeilen' => $order->terms_accepted_at === null ? [] : [
['text' => 'Zugestimmt am '.$date($order->terms_accepted_at), 'neben' => 'Fassung der Texte: '.($order->terms_snapshot['version'] ?? '–')],
...collect($order->terms_snapshot['consents'] ?? [])->map(fn (string $wording): array => ['text' => $wording, 'neben' => null])->values()->all(),
],
'leer' => 'Zu dieser Bestellung ist keine Zustimmung festgehalten (Bestellung vor dem Verkaufsstart oder über den Testweg).',
],
[
'titel' => 'Widerruf',
'zeilen' => $order->withdrawal_requested_at === null ? [] : [
['text' => 'Erklärt am '.$date($order->withdrawal_requested_at), 'neben' => filled($order->withdrawal_note) ? $order->withdrawal_note : null],
],
'leer' => 'Kein Widerruf erklärt.',
'hilfe' => 'Der Widerruf entzieht nichts. Du prüfst ihn (bei sofortiger Bereitstellung mit Zustimmung kann das Recht erloschen sein) und erstattest bei Bedarf über „Bestellung erstatten“.',
],
],
];
}
}
+53 -5
View File
@@ -2,9 +2,11 @@
namespace App\Filament\Support;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Media\CompositionStill;
use App\Domain\Media\FilmStill;
use App\Domain\Media\WebsiteMedia;
use App\Filament\Resources\ContentElements\ContentElementResource;
@@ -58,6 +60,38 @@ public function adoptFilmFrame(string $pfad, int $elementId, string $sekunde): v
$this->adoptFilmStill($pfad, $elementId, fn (FilmStill $stills, ContentElement $film): ContentElement => $stills->fromSecond($film, (float) $sekunde, auth('staff')->user()));
}
/**
* Programm- und Modulkarte: das Vorschaubild des Programms oder Moduls als Bild für die Website übernehmen
* (Bild-Medium im Medienmanager, einmal kopiert).
*/
public function adoptCompositionThumbnail(string $pfad, int $compositionId): void
{
abort_unless(ContentElementResource::editor(), 403);
if ($this->imageTargetIsInvalid($pfad)) {
return;
}
$composition = Composition::query()->find($compositionId);
if (! $composition instanceof Composition) {
return;
}
$stills = app(CompositionStill::class);
try {
$still = $stills->fromThumbnail($composition, auth('staff')->user());
} catch (DomainRuleException $exception) {
Notification::make()->danger()->title($exception->getMessage())->send();
return;
}
data_set($this, $pfad, $still->id);
$this->announceAdoptedStill($still, $stills->reused, 'Dieses Vorschaubild war schon übernommen.');
}
/**
* @param callable(FilmStill, ContentElement): ContentElement $make
*/
@@ -65,7 +99,7 @@ private function adoptFilmStill(string $pfad, int $elementId, callable $make): v
{
abort_unless(ContentElementResource::editor(), 403);
if (preg_match('/^(data|mountedActions\.\d+\.data)(\.[A-Za-z0-9_-]+)+\.image$/', $pfad) !== 1) {
if ($this->imageTargetIsInvalid($pfad)) {
return;
}
@@ -86,9 +120,24 @@ private function adoptFilmStill(string $pfad, int $elementId, callable $make): v
}
data_set($this, $pfad, $still->id);
$this->announceAdoptedStill($still, $stills->reused, 'Diese Stelle war schon übernommen.');
}
/** Nur das Bildfeld eines Widgets oder Abschnitts ist ein zulässiges Ziel (…image). */
private function imageTargetIsInvalid(string $pfad): bool
{
return preg_match('/^(data|mountedActions\.\d+\.data)(\.[A-Za-z0-9_-]+)+\.image$/', $pfad) !== 1;
}
/**
* Meldung nach dem tatsächlichen Stand des Bildes: neu angelegt, schon vorhanden und freigegeben, wird verarbeitet
* oder Website-Freigabe zurückgenommen (bleibt zurückgenommen).
*/
private function announceAdoptedStill(ContentElement $still, bool $reused, string $reusedText): void
{
$title = ($still->display_title ?: $still->working_title);
if (! $stills->reused) {
if (! $reused) {
Notification::make()
->success()
->title('Im Medienmanager angelegt: „'.$title.'“')
@@ -98,14 +147,13 @@ private function adoptFilmStill(string $pfad, int $elementId, callable $make): v
return;
}
// Dieselbe Stelle war schon übernommen: Der tatsächliche Stand des Bildes entscheidet über die Meldung.
if (app(WebsiteMedia::class)->present($still) !== null) {
Notification::make()->success()->title('Bereits im Medienmanager: „'.$title.'“')->body('Diese Stelle war schon übernommen. Das Bild ist als Kartenbild ausgewählt.')->send();
Notification::make()->success()->title('Bereits im Medienmanager: „'.$title.'“')->body($reusedText.' Das Bild ist als Kartenbild ausgewählt.')->send();
} elseif (blank($still->thumbnail_path) && blank($still->thumbnail_error)) {
Notification::make()->success()->title('Bereits im Medienmanager: „'.$title.'“')->body('Das Bild wird noch verarbeitet und danach für die Website freigegeben.')->send();
} else {
Notification::make()->warning()->title('Bild ausgewählt, aber nicht für die Website freigegeben: „'.$title.'“')
->body('Diese Stelle war schon übernommen und die Website-Freigabe wurde zurückgenommen. Das Bild erscheint öffentlich erst wieder, wenn sie im Medienmanager (Reiter „Website“) erneut gegeben wird.')
->body($reusedText.' Die Website-Freigabe wurde zurückgenommen. Das Bild erscheint öffentlich erst wieder, wenn sie im Medienmanager (Reiter „Website“) erneut gegeben wird.')
->persistent()
->send();
}
+126
View File
@@ -0,0 +1,126 @@
<?php
namespace App\Filament\Support;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\Offer;
use App\Domain\Commerce\Discount\DiscountCode;
use Filament\Forms\Components\DatePicker;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Schemas\Components\Utilities\Get;
/**
* Die eine Maske für Rabattcodes: Anlegen und Bearbeiten nutzen dieselben Felder (FACH-20). Geltungsbereich und
* Einlösungsberechtigung sind zwei voneinander unabhängige Einstellungen.
*/
final class DiscountCodeForm
{
/**
* @return list<mixed>
*/
public static function schema(): array
{
return [
TextInput::make('code')->label('Code')->required()->maxLength(40)
->helperText('So gibt ihn der Käufer ein, 3 bis 40 Zeichen: Buchstaben, Ziffern, Bindestrich. Groß- und Kleinschreibung spielen keine Rolle.'),
TextInput::make('label')->label('Name für die Verwaltung')->required()->maxLength(120)
->helperText('Nur intern, zum Beispiel „Zertifizierungscode 2026“. Der Käufer sieht ihn nicht.'),
Select::make('kind')->label('Art des Rabatts')->options([
DiscountCode::PERCENT => 'Prozent',
DiscountCode::AMOUNT => 'Fester Betrag in Euro',
])->required()->live(),
TextInput::make('percent')->label('Prozent')->numeric()->minValue(1)->maxValue(100)->integer()->suffix('%')
->required(fn (Get $get): bool => $get('kind') === DiscountCode::PERCENT)
->visible(fn (Get $get): bool => $get('kind') === DiscountCode::PERCENT)
->helperText('Je Position gerundet. Der Zahlbetrag der Bestellung darf 0,50 € nicht unterschreiten.'),
TextInput::make('amount_euro')->label('Rabattbetrag')->suffix('€')
->required(fn (Get $get): bool => $get('kind') === DiscountCode::AMOUNT)
->visible(fn (Get $get): bool => $get('kind') === DiscountCode::AMOUNT)
->helperText('Gilt je Bestellung und wird anteilig auf die betroffenen Positionen verteilt, zum Beispiel 5,00.'),
Select::make('scope')->label('Geltungsbereich')->options([
DiscountCode::SCOPE_CART => 'Gesamter Warenkorb',
DiscountCode::SCOPE_SELECTED => 'Nur ausdrücklich ausgewählte Angebote, Lizenzartikel oder Pakete',
])->required()->live()
->helperText('Wofür der Rabatt gilt. Unabhängig davon legst du unten fest, wer den Code einlösen darf.'),
Select::make('offer_ids')->label('Angebote')->multiple()->searchable()
->options(fn (): array => Offer::query()->orderBy('name')->pluck('name', 'id')->all())
->visible(fn (Get $get): bool => $get('scope') === DiscountCode::SCOPE_SELECTED)
->helperText('Die gewählte Lizenzoption selbst (Fassung egal).'),
Select::make('article_ids')->label('Lizenzartikel')->multiple()->searchable()
->options(fn (): array => app(PublicationReadiness::class)->articleOptions())
->visible(fn (Get $get): bool => $get('scope') === DiscountCode::SCOPE_SELECTED)
->helperText('Gilt für Angebote, die diesen Artikel unmittelbar als Position führen. Ein Artikel in einem Paket macht das Paket nicht rabattfähig.'),
Select::make('bundle_ids')->label('Pakete')->multiple()->searchable()
->options(fn (): array => Bundle::query()->orderBy('name')->pluck('name', 'id')->all())
->visible(fn (Get $get): bool => $get('scope') === DiscountCode::SCOPE_SELECTED)
->helperText('Ein Paket wird gezielt gewählt. Es folgt nicht aus einem enthaltenen Artikel.'),
Select::make('eligibility')->label('Wer darf den Code einlösen?')->options([
DiscountCode::OPEN => 'Alle angemeldeten Käufer (allgemein einlösbar)',
DiscountCode::RESTRICTED => 'Nur ausdrücklich freigeschaltete Konten',
])->required()
->helperText('Bei „freigeschaltete Konten“ schaltest du einzelne Konten auf der Seite des Codes frei und entziehst die Freigabe wieder. Eine Freigabe gilt nur für diesen Code.'),
DatePicker::make('valid_from')->label('Gültig ab')->native(false)->displayFormat('d.m.Y')
->helperText('Leer: sofort.'),
DatePicker::make('valid_until')->label('Gültig bis einschließlich')->native(false)->displayFormat('d.m.Y')
->helperText('Leer: unbegrenzt. Am Tag danach gilt der Code nicht mehr.'),
Toggle::make('active')->label('Aktiv')->default(true)
->helperText('Deaktivierte Codes lassen sich nicht einlösen; bereits aufgegebene Bestellungen bleiben unverändert.'),
Textarea::make('note')->label('Notiz')->rows(2)->maxLength(500)
->helperText('Zum Beispiel, woran die Berechtigung geprüft wird.'),
];
}
/**
* Formularwerte → Angaben und Ziele des Dienstes.
*
* @param array<string, mixed> $data
* @return array{0: array<string, mixed>, 1: list<array{type: string, id: int}>}
*/
public static function fromForm(array $data): array
{
$targets = [];
foreach ([
DiscountCode::TARGET_OFFER => 'offer_ids',
DiscountCode::TARGET_ARTICLE => 'article_ids',
DiscountCode::TARGET_BUNDLE => 'bundle_ids',
] as $type => $key) {
foreach ((array) ($data[$key] ?? []) as $id) {
$targets[] = ['type' => $type, 'id' => (int) $id];
}
}
return [$data, $targets];
}
/**
* Vorbelegung der Maske aus einem vorhandenen Code.
*
* @return array<string, mixed>
*/
public static function fill(DiscountCode $code): array
{
$code->loadMissing('targets');
$ids = fn (string $type): array => $code->targets->where('target_type', $type)->pluck('target_id')->map(fn ($id): int => (int) $id)->values()->all();
return [
'code' => $code->code,
'label' => $code->label,
'kind' => $code->kind,
'percent' => $code->percent,
'amount_euro' => $code->amount_cents === null ? null : number_format($code->amount_cents / 100, 2, ',', ''),
'scope' => $code->scope,
'offer_ids' => $ids(DiscountCode::TARGET_OFFER),
'article_ids' => $ids(DiscountCode::TARGET_ARTICLE),
'bundle_ids' => $ids(DiscountCode::TARGET_BUNDLE),
'eligibility' => $code->eligibility,
'valid_from' => $code->valid_from?->timezone(config('app.timezone'))->toDateString(),
'valid_until' => $code->valid_until?->timezone(config('app.timezone'))->toDateString(),
'active' => $code->active,
'note' => $code->note,
];
}
}
+26
View File
@@ -144,6 +144,7 @@ private function normalize(array $filters): array
'suche' => trim($filters['suche'] ?? ''),
'art' => $this->choice($filters['art'] ?? '', ['film', 'text', 'document', 'bild', 'audio']),
'freigabe' => $this->choice($filters['freigabe'] ?? '', ['freigegeben', 'entwurf', 'ohne']),
'schutz' => $this->choice($filters['schutz'] ?? '', ['geschuetzt', 'oeffentlich', 'website']),
'entwurf' => $this->choice($filters['entwurf'] ?? '', ['offen', 'keiner']),
'fassung' => $this->choice($filters['fassung'] ?? '', ['mit', 'nur']),
'nutzung' => $this->choice($filters['nutzung'] ?? '', ['verwendet', 'unbenutzt']),
@@ -383,6 +384,20 @@ private function matches(ContentElement $element, array $portrait, array $uses,
return false;
}
$presentation = $this->isPresentationMedium($element, $portrait['versionCount']);
if ($filters['schutz'] === 'geschuetzt' && $presentation) {
return false;
}
if ($filters['schutz'] === 'oeffentlich' && ! $presentation) {
return false;
}
if ($filters['schutz'] === 'website' && $element->website_released_at === null) {
return false;
}
if ($filters['freigabe'] === 'freigegeben' && $portrait['ready'] === null) {
return false;
}
@@ -444,6 +459,15 @@ private function matches(ContentElement $element, array $portrait, array $uses,
return true;
}
/**
* Eigenständiges Präsentationsmedium: Bild, Film oder Hörstück ohne Inhaltsfassung. Es ist für die Website
* bestimmt und nicht lizenziert; alles mit einer Inhaltsfassung gilt als geschützt.
*/
private function isPresentationMedium(ContentElement $element, int $versionCount): bool
{
return $versionCount === 0 && in_array($element->output_class, ['bild', 'film', 'audio'], true);
}
private function matchesArt(ContentElement $element, string $art): bool
{
if ($art === '') {
@@ -498,6 +522,8 @@ private function card(ContentElement $element, array $portrait, array $uses, arr
'image' => ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path),
'imageAlt' => trim((string) ($element->thumbnail_alt ?: $element->working_title)),
'imageNote' => $this->imageNote($element),
'presentation' => $this->isPresentationMedium($element, $portrait['versionCount']),
'websiteReleased' => $element->website_released_at !== null,
'stand' => $portrait['stand'],
'standTone' => $portrait['standTone'],
'draftNote' => $portrait['draftNote'],
+23 -14
View File
@@ -43,7 +43,7 @@ public static function fields(bool $creating, ?ContentElement $element = null):
->required(fn ($get): bool => filled($get('shape')) && $get('shape') !== 'text');
$fields[] = Checkbox::make('without_version')
->label('Eigenständiges Präsentationsmedium')
->helperText('Bild, Film oder Hörstück ohne fachliche Inhaltsfassung. Die Datei bleibt eine technische Ableitung am Medium. Sie wird nicht lizenziert und nicht automatisch für die Website freigegeben.')
->helperText('Bild, Film oder Hörstück ohne fachliche Inhaltsfassung, zum Beispiel ein Trailer, der ungeschützt auf der Website laufen soll. Der Film muss dafür MP4 (H.264) oder WebM sein. Er wird nicht lizenziert und erst nach „Für die Website freigeben“ öffentlich.')
->visible(fn ($get): bool => in_array($get('shape'), ['film', 'audio', 'bild'], true));
} elseif ($element?->output_class === 'text') {
$fields[] = Textarea::make('body')->label('Text')->rows(8)->required();
@@ -94,20 +94,10 @@ public static function create(array $data, bool $hold): ContentElement
{
$service = app(ContentService::class);
[$kind, $output] = self::shape($data['shape'] ?? null);
$element = $service->createElement($kind, $output, (string) $data['working_title']);
self::remember($element, $data);
$incoming = null;
if ($output === 'text') {
$body = trim((string) ($data['body'] ?? ''));
if ($body === '') {
throw new DomainRuleException('Der Text braucht einen Inhalt.');
}
$hold
? $service->draftElementVersion($element, $body)
: $service->publishElementVersion($element, $body);
} else {
if ($output !== 'text') {
// Alles prüfen, bevor etwas angelegt wird: Eine abgelehnte Datei darf kein leeres Medium hinterlassen.
$incoming = IncomingFile::store($data['incoming'] ?? null);
if ($incoming === null) {
@@ -126,6 +116,25 @@ public static function create(array $data, bool $hold): ContentElement
throw new DomainRuleException('Diese Datei passt nicht zur gewählten Art.');
}
if (! empty($data['without_version']) && in_array($output, ['bild', 'film', 'audio'], true)) {
app(PresentationFile::class)->validate($output, $incoming);
}
}
$element = $service->createElement($kind, $output, (string) $data['working_title']);
self::remember($element, $data);
if ($output === 'text') {
$body = trim((string) ($data['body'] ?? ''));
if ($body === '') {
throw new DomainRuleException('Der Text braucht einen Inhalt.');
}
$hold
? $service->draftElementVersion($element, $body)
: $service->publishElementVersion($element, $body);
} else {
if (! empty($data['without_version']) && in_array($output, ['bild', 'film', 'audio'], true)) {
app(PresentationFile::class)->store($element, $incoming);
} else {
+24 -7
View File
@@ -8,6 +8,7 @@
use App\Domain\Catalog\BundleStatus;
use App\Domain\Catalog\BundleVersion;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -227,7 +228,8 @@ public function forOffer(Offer $offer): array
$missing = $this->unusableArticles($articleIds);
$buyable = $hasActive && $this->offers->purchasableVersion($offer) !== null;
$page = $offer->composition;
$shown = $page !== null && $this->catalog->shownVersion($page) !== null;
$own = (bool) $offer->standalone_bundle;
$shown = $own || ($page !== null && $this->catalog->shownVersion($page) !== null);
$pageName = $page !== null ? (string) ($page->display_title ?: $page->designation) : '';
$activate = ['label' => $hasActive ? 'Geänderte Fassung aktivieren' : 'Angebot konfigurieren', 'wire' => "mountAction('activate')"];
@@ -258,21 +260,36 @@ public function forOffer(Offer $offer): array
'stand' => $buyable ? 'erledigt' : 'offen',
'aktion' => $buyable ? null : ($hasActive ? $activate : null),
],
[
'titel' => 'Nutzerkreis festlegen',
'text' => ! $hasActive
? 'Wird mit der Fassung festgelegt: Einzellizenz (ein Trainer) oder Mehrfachlizenz (Zahl der Trainer).'
: ($active->licence_scope !== null
? LicenceScope::label($active->licence_scope, $active->trainer_count).'. Der Käufer sieht das auf der Produktseite und in der Bestellung.'
: 'Diese Fassung hat keinen festgelegten Nutzerkreis. Käufer sehen „Nutzerkreis nicht festgelegt“. Lege ihn mit „Geänderte Fassung aktivieren“ fest.'),
'stand' => $hasActive && $active->licence_scope !== null ? 'erledigt' : 'offen',
'aktion' => $hasActive && $active->licence_scope === null ? $activate : null,
'pflicht' => false,
],
[
'titel' => 'Produktseite zuordnen',
'text' => $page !== null
'text' => $own
? 'Eigene Paketseite: Sie zeigt den Umfang des Pakets. Optionen desselben Pakets sind Alternativen im Warenkorb.'
: ($page !== null
? 'Zugeordnet: „'.$pageName.'“. Optionen derselben Produktseite sind Alternativen im Warenkorb.'
: 'Der Shop zeigt ein Angebot auf der Seite eines Programms. Wähle in der Maske die Produktseite. Ein Paket braucht eine eigene Produktseite, sonst ist es Alternative zu den Einzelangeboten dieser Seite.',
'stand' => $page !== null ? 'erledigt' : 'offen',
'aktion' => $page !== null ? null : $activate,
: 'Der Shop zeigt ein Angebot auf der Seite eines Programms. Wähle in der Maske die Produktseite. Ein Paket, das für sich verkauft wird, erhält dort „Eigene Paketseite“ und zeigt seinen Umfang; sonst erscheint es auf der Seite eines fremden Programms.'),
'stand' => $own || $page !== null ? 'erledigt' : 'offen',
'aktion' => $own || $page !== null ? null : $activate,
],
[
'titel' => 'Produktseite öffentlich',
'text' => $page === null
'text' => ! $own && $page === null
? 'Wird geprüft, sobald eine Produktseite zugeordnet ist.'
: ($own
? 'Die eigene Paketseite ist öffentlich, sobald die aktive Fassung ein Kauf mit Preis ist.'
: ($shown
? 'Das Programm ist zur Anzeige freigegeben. Das Angebot erscheint in der Shop-Suche und auf der Produktseite.'
: 'Das Programm „'.$pageName.'“ ist nicht zur Anzeige freigegeben oder kein Programm. Das Angebot ist dort nicht auffindbar.'),
: 'Das Programm „'.$pageName.'“ ist nicht zur Anzeige freigegeben oder kein Programm. Das Angebot ist dort nicht auffindbar.')),
'stand' => $shown ? 'erledigt' : 'offen',
'aktion' => $page === null || $shown ? null : ['label' => 'Programm öffnen', 'href' => EditorialCatalog::editUrl($page)],
],
+22
View File
@@ -0,0 +1,22 @@
<?php
namespace App\Filament\Support;
use App\Domain\Identity\StaffRole;
use App\Models\User;
use Filament\Facades\Filament;
/**
* Wer Rabattcodes, Freigaben und Bestellungen verwalten darf: Katalogverwalter und Kundenbetreuung. Die
* Berechtigung zum Verkaufen und Erstatten ist eine Betreiberaufgabe, nicht die der Redaktion.
*/
final class ShopAccess
{
public static function allowed(): bool
{
$user = Filament::auth()->user();
return $user instanceof User
&& ($user->hasStaffRole(StaffRole::Katalogverwalter) || $user->hasStaffRole(StaffRole::Kundenbetreuung));
}
}
+62 -13
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;
@@ -16,6 +17,7 @@
use Filament\Forms\Components\ToggleButtons;
use Filament\Notifications\Notification;
use Filament\Schemas\Components\Grid;
use Filament\Schemas\Components\Group;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Tabs;
use Filament\Schemas\Components\Tabs\Tab;
@@ -120,45 +122,92 @@ public static function slotBuilder(string $name = 'widget'): Builder
->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
{
$icons = $type->optionIcons();
$display = [];
// Aufbau: Anordnung (Variante) und gemeinsame Höhe. Erklärungen stehen im (i) neben der Bezeichnung.
$layout = [];
if (count($type->variants()) > 1) {
$display[] = ToggleButtons::make('variant')
->label('Darstellung')
$layout[] = self::withInfo(ToggleButtons::make('variant')
->label('Anordnung')
->options($type->variants())
->icons($icons['variant'] ?? [])
->default($type->defaultVariant())
->inline()
->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();
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.
$settings[] = $key === 'height'
$component = $key === 'height'
? ToggleButtons::make('height')
->label('Höhe')
->helperText('Gestaltungsparameter, keine Begrenzung: Längere Inhalte erhalten immer den nötigen Platz.')
->options($options)
->options($options['height'])
->icons($icons['height'] ?? [])
->default($type->defaultHeight())
->inline()
->live()
: Select::make($key)
->label($labels[$key][0] ?? Str::headline($key))
->helperText($labels[$key][1] ?? null)
->placeholder('Vorgabe der Darstellung')
->options($options)
->options($options[$key])
->live();
if ($key === 'height') {
$help = 'Gestaltungsparameter, keine Begrenzung: Längere Inhalte erhalten immer den nötigen Platz.';
}
if ($settings !== []) {
$display[] = Grid::make(['default' => 1, 'md' => 2])->schema($settings)->statePath('settings');
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 ($layout !== []) {
$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())];
@@ -426,7 +475,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 '';
}
+6 -6
View File
@@ -7,6 +7,7 @@
use App\Domain\Commerce\Cart;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\OrderHolders;
use App\Domain\Commerce\ProductOptions;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;
@@ -31,9 +32,8 @@ public function show(Request $request, Cart $cart, OrderHolders $holders): View
public function add(Offer $offer, Cart $cart, PublicCatalogReader $catalog): RedirectResponse
{
$page = $offer->composition;
$result = $page !== null && $catalog->shownVersion($page) !== null
? $cart->add($offer)
: Cart::UNAVAILABLE;
$listed = $offer->standalone_bundle || ($page !== null && $catalog->shownVersion($page) !== null);
$result = $listed ? $cart->add($offer) : Cart::UNAVAILABLE;
$back = $this->productPage($offer);
return match ($result) {
@@ -81,8 +81,8 @@ public function accept(Offer $offer, Cart $cart): RedirectResponse
private function productPage(Offer $offer): RedirectResponse
{
return $offer->composition_id !== null
? redirect()->route('public.program', $offer->composition_id)
: redirect()->route('cart');
$url = app(ProductOptions::class)->pageUrl($offer);
return $url !== null ? redirect()->to($url) : redirect()->route('cart');
}
}
@@ -0,0 +1,94 @@
<?php
namespace App\Http\Controllers\Concerns;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use Symfony\Component\HttpFoundation\StreamedResponse;
/**
* Liefert eine Datei einer Disk aus, bei Filmen und Hörstücken mit Bereichsabrufen (206/416). Safari und iOS spielen
* sonst nicht ab, und ohne Bereiche ist kein Springen möglich.
*/
trait ServesByteRanges
{
private const CHUNK = 262144;
protected function respondWithRanges(Request $request, string $diskName, string $path, bool $ranged): StreamedResponse
{
$headers = [
'Content-Disposition' => 'inline',
'X-Content-Type-Options' => 'nosniff',
'Accept-Ranges' => 'bytes',
];
$range = $request->header('Range');
if (! is_string($range) || ! $ranged) {
return Storage::disk($diskName)->response($path, null, $headers);
}
$disk = Storage::disk($diskName);
$size = (int) $disk->size($path);
$bounds = $this->bounds($range, $size);
if ($bounds === null) {
return response()->stream(fn () => null, 416, $headers + ['Content-Range' => 'bytes */'.$size]);
}
[$start, $end] = $bounds;
$length = $end - $start + 1;
$stream = $disk->readStream($path);
abort_if(! is_resource($stream), 404);
return response()->stream(function () use ($stream, $start, $length): void {
fseek($stream, $start);
$left = $length;
while ($left > 0 && ! feof($stream)) {
$chunk = fread($stream, min(self::CHUNK, $left));
if ($chunk === false || $chunk === '') {
break;
}
echo $chunk;
$left -= strlen($chunk);
}
fclose($stream);
}, 206, $headers + [
'Content-Type' => (string) ($disk->mimeType($path) ?: 'application/octet-stream'),
'Content-Length' => (string) $length,
'Content-Range' => 'bytes '.$start.'-'.$end.'/'.$size,
]);
}
/**
* Erster Bereich aus „bytes=a-b“, „bytes=a-“ oder „bytes=-n“; null, wenn er nicht erfüllbar ist.
*
* @return array{0: int, 1: int}|null
*/
private function bounds(string $header, int $size): ?array
{
if ($size < 1 || preg_match('/^bytes=(\d*)-(\d*)(?:,.*)?$/', trim($header), $match) !== 1) {
return null;
}
[, $from, $to] = $match;
if ($from === '' && $to === '') {
return null;
}
if ($from === '') {
$suffix = min((int) $to, $size);
return $suffix < 1 ? null : [$size - $suffix, $size - 1];
}
$start = (int) $from;
$end = $to === '' ? $size - 1 : min((int) $to, $size - 1);
return $start > $end || $start >= $size ? null : [$start, $end];
}
}
@@ -2,12 +2,16 @@
namespace App\Http\Controllers;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentElementVersion;
use App\Domain\Identity\StaffRole;
use App\Domain\Media\FilmPlayback;
use App\Domain\Media\HlsPlaylist;
use App\Domain\Media\MediaRendition;
use App\Domain\Media\ThumbnailDeriver;
use App\Http\Controllers\Concerns\ServesByteRanges;
use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Storage;
use Illuminate\View\View;
@@ -15,6 +19,27 @@
class ContentPreviewController extends Controller
{
use ServesByteRanges;
/**
* Die Website-Datei eines Films oder Hörstücks, damit die Redaktion sie vor der Freigabe ansehen kann. Nur für
* angemeldete Redakteure; öffentlich ist erst die freigegebene Kopie (`website.media`).
*/
public function websiteFile(Request $request, ContentElement $element): StreamedResponse
{
$this->authorizeStaff();
$path = $element->preview_path;
abort_unless(
is_string($path) && str_starts_with($path, 'teaser/') && ! str_contains($path, '..')
&& in_array($element->output_class, ['film', 'audio'], true)
&& Storage::disk('media_derived')->exists($path),
404,
);
return $this->respondWithRanges($request, 'media_derived', $path, true);
}
public function show(ContentElementVersion $version): View
{
$this->authorizeStaff();
@@ -38,6 +63,24 @@ public function file(ContentElementVersion $version): StreamedResponse
]);
}
/**
* Einzelbild einer Stelle der Website-Datei, zur Auswahl des Vorschaubilds.
*/
public function websiteFrame(Request $request, ContentElement $element, ThumbnailDeriver $deriver): Response
{
$this->authorizeStaff();
$seconds = $request->query('sekunde');
abort_unless(is_numeric($seconds), 404);
$bytes = $deriver->jpegAtWebsiteFile($element, (float) $seconds);
abort_unless(is_string($bytes), 404);
return response($bytes, 200, [
'Content-Type' => 'image/jpeg',
'Cache-Control' => 'private, no-store',
]);
}
public function fileUrl(ContentElementVersion $version): ?string
{
return $this->storedPath($version) === null ? null : route('content.file', $version);
@@ -9,10 +9,12 @@
use App\Domain\Commerce\Checkout;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\OrderHolders;
use App\Domain\Commerce\SalesTerms;
use App\Domain\Commerce\Shop;
use App\Domain\Commerce\StaleOverview;
use App\Domain\Commerce\Stripe\StripeGateway;
use App\Domain\Entitlement\GrantIssuer;
use App\Domain\Identity\PartyType;
use App\Http\Controllers\Controller;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
@@ -39,7 +41,7 @@ public function claim(Request $request, Offer $offer, GrantIssuer $issuer): Redi
return back()->withErrors(['offer' => $exception->getMessage()]);
}
return redirect()->route('member.library')->with('status', 'Das Angebot liegt in Ihrer Bibliothek.');
return redirect()->route('member.library')->with('status', 'Das Angebot liegt in deiner Bibliothek.');
}
public function place(Request $request, Offer $offer, Checkout $checkout): RedirectResponse
@@ -67,9 +69,38 @@ public function checkout(Request $request, Cart $cart, OrderHolders $holders): V
return view('shop.checkout', [
'review' => $review,
'holders' => $holders->for($request->user()),
'consents' => SalesTerms::consents(),
'legalPages' => SalesTerms::pages(),
'invoice' => Shop::invoice() && $review->holder?->type === PartyType::Organisation,
]);
}
/**
* Rabattcode einlösen. Höchstens ein Code je Bestellung; ein zweiter ersetzt den ersten. Gilt der Code nicht,
* bleibt der bisherige Stand und die Meldung nennt den Grund.
*/
public function applyCode(Request $request, Cart $cart): RedirectResponse
{
$data = $request->validate(['code' => ['required', 'string', 'max:60'], 'bestellen_als' => ['nullable', 'integer']], [
'code.required' => 'Gib einen Rabattcode ein.',
]);
$holderId = isset($data['bestellen_als']) ? (int) $data['bestellen_als'] : null;
$result = $cart->applyCode($data['code'], $request->user(), $holderId);
$back = redirect()->route('checkout', array_filter(['bestellen_als' => $holderId]));
return $result->applied()
? $back->with('status', 'Der Rabattcode '.$result->code->code.' ist angewendet.')
: $back->withErrors(['code' => $result->message ?? 'Der Code kann nicht angewendet werden.']);
}
public function removeCode(Request $request, Cart $cart): RedirectResponse
{
$cart->removeCode();
$holderId = $request->integer('bestellen_als') ?: null;
return redirect()->route('checkout', array_filter(['bestellen_als' => $holderId]))->with('status', 'Der Rabattcode ist entfernt.');
}
/**
* Legt die Bestellung an, aber nur, wenn die serverseitige Prüfung zur gezeigten Übersicht passt.
*/
@@ -78,19 +109,28 @@ public function placeOrder(Request $request, Cart $cart, Checkout $checkout): Re
$data = $request->validate([
'digest' => ['required', 'string'],
'bestellen_als' => ['nullable', 'integer'],
'zahlungsweg' => ['nullable', 'in:online,rechnung'],
'zustimmung' => ['nullable', 'array'],
]);
$holderId = isset($data['bestellen_als']) ? (int) $data['bestellen_als'] : null;
$back = redirect()->route('checkout', array_filter(['bestellen_als' => $holderId]));
$method = ($data['zahlungsweg'] ?? 'online') === 'rechnung' ? 'rechnung' : null;
try {
$order = $checkout->placeFromCart($request->user(), $cart, $holderId, $data['digest']);
// Die Zustimmungen sind eine Pflichtangabe und werden serverseitig geprüft, nicht nur im Formular.
SalesTerms::proof((array) ($data['zustimmung'] ?? []));
$order = $checkout->placeFromCart($request->user(), $cart, $holderId, $data['digest'], (array) ($data['zustimmung'] ?? []), $method);
} catch (StaleOverview $exception) {
return $back->withErrors(['checkout' => $exception->getMessage()]);
} catch (DomainRuleException $exception) {
return $back->withErrors(['checkout' => $exception->getMessage()]);
}
return redirect()->route('member.order', $order)->with('status', 'Die Bestellung ist angelegt. Bestätige jetzt die Testzahlung.');
return redirect()->route('member.order', $order)->with('status', match (true) {
$order->payment_method === 'rechnung' => 'Deine Bestellung auf Rechnung ist eingegangen. Wir senden dir die Rechnung. Die Inhalte sind nach Zahlungseingang in der Bibliothek.',
Shop::stripe() => 'Die Bestellung ist angelegt. Bezahle jetzt sicher bei Stripe.',
default => 'Die Bestellung ist angelegt. Bestätige jetzt die Testzahlung.',
});
}
public function show(Request $request, Order $order): View
@@ -103,9 +143,25 @@ public function show(Request $request, Order $order): View
'testPayment' => ! app()->isProduction() && config('services.payment.driver') === 'test',
'stripePayment' => Shop::stripe(),
'zahlung' => $request->query('zahlung'),
'live' => Shop::live(),
]);
}
/** Erklärt den Widerruf; der Betreiber prüft und erstattet gegebenenfalls in der Bestellverwaltung. */
public function withdraw(Request $request, Order $order, Checkout $checkout): RedirectResponse
{
abort_unless($order->user_id === $request->user()->id, 403);
$data = $request->validate(['note' => ['nullable', 'string', 'max:1000']]);
try {
$checkout->requestWithdrawal($order, (string) ($data['note'] ?? ''));
} catch (DomainRuleException $exception) {
return back()->withErrors(['payment' => $exception->getMessage()]);
}
return redirect()->route('member.order', $order)->with('status', 'Dein Widerruf ist eingegangen. Wir prüfen ihn und melden uns per E-Mail.');
}
/** Leitet zur Stripe-Kasse (Testmodus). Freigeschaltet wird erst durch die signierte Meldung von Stripe. */
public function pay(Request $request, Order $order, StripeGateway $stripe): RedirectResponse
{
@@ -150,6 +206,8 @@ public function fail(Request $request, Order $order, Checkout $checkout): Redire
public function refund(Request $request, Order $order, Checkout $checkout): RedirectResponse
{
abort_unless($order->user_id === $request->user()->id, 403);
// Nur der Testzahlungsweg erstattet auf Knopfdruck. Echte Zahlungen erstattet der Betreiber nach Prüfung.
abort_unless(! app()->isProduction() && Shop::driver() === 'test', 404);
try {
$checkout->refund($order, 'Widerruf durch das Mitglied im Testmodus');
+139 -90
View File
@@ -21,8 +21,10 @@
use App\Http\Controllers\Controller;
use App\Http\CourseOutline;
use App\Http\LibraryCatalog;
use App\Http\MemberLicenses;
use App\Http\SignedLink;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Collection;
@@ -32,12 +34,28 @@
class LibraryController extends Controller
{
/** Inhaltsarten der Bibliothek (Schlüssel der Adresse und des Filters). */
public const TYPES = [
'programm' => 'Programme',
'modul' => 'Module',
'film' => 'Filme',
'material' => 'Materialien',
];
public function index(Request $request, ?string $sicht = null): View
{
$catalog = app(LibraryCatalog::class)->index($request->user());
$untouched = $catalog['programs'] === [] && $catalog['modules'] === [] && $catalog['materials'] === [];
$items = [...$catalog['programs'], ...$catalog['modules'], ...$catalog['materials']];
$untouched = $items === [];
$query = trim((string) $request->query('q', ''));
$nutzung = (string) $request->query('nutzung', '');
$sortierung = $request->query('sortierung') === 'titel' ? 'titel' : 'standard';
$art = match ($sicht) {
'programme' => 'programm',
'module' => 'modul',
default => (string) $request->query('art', ''),
};
$art = array_key_exists($art, self::TYPES) ? $art : '';
$dimensionIds = array_values(array_filter(array_map(intval(...), (array) $request->query('dimension', []))));
$saeuleIds = array_values(array_filter(array_map(intval(...), (array) $request->query('saeule', []))));
$dimensions = app(IdentityDimension::class);
@@ -52,94 +70,60 @@ public function index(Request $request, ?string $sicht = null): View
$dimensionIds = array_values($dimensionIds);
$saeuleIds = array_values(array_unique($saeuleIds));
$pillarOptions = $this->visiblePillars($catalog, $saeuleIds);
$pillarOptions = $this->visiblePillars($items, $saeuleIds);
foreach (['programs', 'modules'] as $shelf) {
if ($query !== '') {
$catalog[$shelf] = array_values(array_filter(
$catalog[$shelf],
fn (array $card): bool => $this->matches($card, $query),
));
// Gemeinsame Filter für alle Inhaltsarten. Die Zahl je Art zeigt, was die übrigen Filter übrig lassen.
$matching = array_values(array_filter($items, function (array $card) use ($query, $nutzung, $dimensionIds, $saeuleIds, $dimensions): bool {
return ($query === '' || $this->matches($card, $query))
&& ($dimensionIds === [] || $dimensions->matches($card['subject'], $dimensionIds))
&& ($saeuleIds === [] || $this->hasPillar($card['subject'], $saeuleIds))
&& (! in_array($nutzung, ['nutzbar', 'teilweise', 'nicht enthalten'], true) || ($card['coverage'] ?? '') === $nutzung);
}));
$counts = array_fill_keys(array_keys(self::TYPES), 0);
foreach ($matching as $card) {
$counts[$card['type']]++;
}
if ($dimensionIds !== []) {
$catalog[$shelf] = array_values(array_filter(
$catalog[$shelf],
fn (array $card): bool => $dimensions->matches($card['composition'], $dimensionIds),
));
$shown = $art === '' ? $matching : array_values(array_filter($matching, fn (array $card): bool => $card['type'] === $art));
if ($sortierung === 'titel') {
usort($shown, fn (array $left, array $right): int => strcoll(mb_strtolower($left['title']), mb_strtolower($right['title'])));
}
if ($saeuleIds !== []) {
$catalog[$shelf] = array_values(array_filter(
$catalog[$shelf],
fn (array $card): bool => $this->hasPillar($card['composition'], $saeuleIds),
));
}
if (in_array($nutzung, ['nutzbar', 'teilweise', 'nicht enthalten'], true)) {
$catalog[$shelf] = array_values(array_filter(
$catalog[$shelf],
fn (array $card): bool => ($card['coverage'] ?? '') === $nutzung,
));
$shelves = [];
foreach (self::TYPES as $type => $label) {
$cards = array_values(array_filter($shown, fn (array $card): bool => $card['type'] === $type));
if ($cards !== []) {
$shelves[$type] = ['label' => $label, 'cards' => $cards];
}
}
if ($query !== '') {
$catalog['materials'] = array_values(array_filter(
$catalog['materials'],
fn (array $card): bool => $this->matches($card, $query),
));
}
if ($dimensionIds !== []) {
$catalog['materials'] = array_values(array_filter(
$catalog['materials'],
function (array $card) use ($dimensions, $dimensionIds): bool {
$release = $card['article']->currentRelease;
$subject = $release?->rootCompositionVersion?->composition
?? $release?->rootElementVersion?->element
?? $card['article'];
return $dimensions->matches($subject, $dimensionIds);
},
));
}
if ($saeuleIds !== []) {
$catalog['materials'] = array_values(array_filter(
$catalog['materials'],
fn (array $card): bool => $this->hasPillar($this->materialSubject($card), $saeuleIds),
));
}
if ($nutzung === 'teilweise' || $nutzung === 'nicht enthalten') {
$catalog['materials'] = [];
}
$filterActive = $query !== '' || $nutzung !== '' || $dimensionIds !== [] || $saeuleIds !== [] || $art !== '';
return view('member.library', [
...$catalog,
'shelves' => $shelves,
'total' => count($shown),
'counts' => $counts,
'allCount' => count($matching),
'art' => $art,
'types' => self::TYPES,
'query' => $query,
'sicht' => $sicht,
'nutzung' => $nutzung,
'sortierung' => $sortierung,
'dimensionIds' => $dimensionIds,
'saeuleIds' => $saeuleIds,
'filterPillars' => $pillarOptions,
'filterDimensions' => app(EditorialVocabulary::class)->memberFilterDimensions(array_map(intval(...), $dimensionIds)),
'libraryEmpty' => $untouched,
'filterActive' => $filterActive,
'filterCount' => count($dimensionIds) + count($saeuleIds) + ($nutzung !== '' ? 1 : 0),
]);
}
/**
* Subjekt eines Materialkarte: Programm oder Modul, Medium oder der Artikel selbst.
*
* @param array<string, mixed> $card
*/
private function materialSubject(array $card): Model
{
$release = $card['article']->currentRelease;
return $release?->rootCompositionVersion?->composition
?? $release?->rootElementVersion?->element
?? $card['article'];
}
/**
* Direkte Säulenzuordnung des Objekts selbst; die Säulen enthaltener Medien zählen hier nicht.
*
@@ -154,22 +138,16 @@ private function hasPillar(Model $subject, array $pillarIds): bool
* Säulen für den Filter: nur solche, die ein sichtbares Objekt der Bibliothek tatsächlich trägt, und eine bereits
* gewählte. So erscheinen neue oder interne Säulen ohne Zuordnung nicht in der Bibliothek.
*
* @param array<string, mixed> $catalog
* @param list<array<string, mixed>> $items
* @param list<int> $selected
* @return Collection<int, Pillar>
*/
private function visiblePillars(array $catalog, array $selected)
private function visiblePillars(array $items, array $selected)
{
$used = [];
foreach (array_merge($catalog['programs'], $catalog['modules']) as $card) {
foreach ($card['composition']->pillars()->pluck('pillars.id') as $id) {
$used[(int) $id] = true;
}
}
foreach ($catalog['materials'] as $card) {
foreach ($this->materialSubject($card)->pillars()->pluck('pillars.id') as $id) {
foreach ($items as $card) {
foreach ($card['subject']->pillars()->pluck('pillars.id') as $id) {
$used[(int) $id] = true;
}
}
@@ -193,20 +171,55 @@ public function program(Request $request, Composition $composition): View
return view('member.program', app(LibraryCatalog::class)->program($request->user(), $composition));
}
public function materials(Request $request): View
/**
* Film oder Material im Zusammenhang seines Programms oder Moduls. Die Seite zeigt nur Stellen, die in der
* angezeigten Fassung des Programms stehen; die Wiedergabe- und Downloadadressen kommen aus DecideAccess.
*/
public function content(Request $request, Composition $composition, int $version): View|Response
{
return view('member.materials', [
'grants' => $this->grantQuery($request)->with('article.currentRelease.contents.elementVersion.element')->get(),
]);
$data = app(LibraryCatalog::class)->content($request->user(), $composition, $version);
abort_if($data === null, 404);
return response()->view('member.content', $data, $data['allowed'] ? 200 : 403);
}
/** Die frühere Seite „Materialien“ ist ein Filter der Bibliothek (eine Navigation statt zwei). */
public function materials(): RedirectResponse
{
return redirect()->route('member.library', ['art' => 'material']);
}
public function grants(Request $request): View
{
$entries = app(MemberLicenses::class)->overview($request->user());
$filter = in_array($request->query('status'), ['aktiv', 'inaktiv'], true) ? (string) $request->query('status') : 'alle';
return view('member.grants', [
'grants' => $this->grantQuery($request)->get(),
'entries' => match ($filter) {
'aktiv' => $entries->where('active', true)->values(),
'inaktiv' => $entries->where('active', false)->values(),
default => $entries,
},
'filter' => $filter,
'counts' => [
'aktiv' => $entries->where('active', true)->count(),
'inaktiv' => $entries->where('active', false)->count(),
'alle' => $entries->count(),
],
]);
}
/** Eine einzelne Berechtigung. Nur eigene (oder die der eigenen Organisation mit Bestellrecht); sonst nicht gefunden. */
public function grant(Request $request, Grant $grant): View
{
abort_unless(
Grant::query()->usableBy($request->user())->whereKey($grant->id)->exists(),
404,
);
return view('member.grant', app(MemberLicenses::class)->detail($request->user(), $grant));
}
public function show(Request $request, LicenseArticle $article): View
{
$release = $article->currentRelease()->with('contents.elementVersion.element.pillars')->first();
@@ -219,8 +232,11 @@ public function show(Request $request, LicenseArticle $article): View
$metadata = is_array($version->metadata) ? $version->metadata : [];
$action = $class === 'film' || $class === 'audio' ? 'streamen' : 'ansehen';
$decision = app(DecideAccess::class)($request->user(), $article, $release, $version, $action);
$download = app(DecideAccess::class)($request->user(), $article, $release, $version, 'laden');
$file = $metadata['file'] ?? null;
$entries[] = [
'title' => app(LibraryCatalog::class)->text($version->element)['title'],
'class' => $class,
'content' => $content,
'version' => $version,
'role' => $content->role,
@@ -232,6 +248,15 @@ public function show(Request $request, LicenseArticle $article): View
: null,
'playable' => $decision->allowed && is_string($file) && $file !== '' && ($class === 'film' || $class === 'audio'),
'playback' => app(FilmPlayback::class)->mode($version->id),
'download_url' => $download->allowed
? SignedLink::temporary('member.media', now()->addMinutes(10), [
'article' => $article->id,
'release' => $release->id,
'version' => $version->id,
'action' => 'laden',
'reader' => $request->user()->id,
])
: null,
'pillars' => $version->element->pillars->pluck('name')->all(),
'url' => $decision->allowed
? SignedLink::temporary('member.media', now()->addMinutes(10), [
@@ -352,7 +377,7 @@ public function thumbnail(Request $request, string $kind, int $subject): Streame
*/
private function matches(array $card, string $query): bool
{
$haystack = mb_strtolower(($card['title'] ?? '').' '.($card['summary'] ?? ''));
$haystack = mb_strtolower(($card['title'] ?? '').' '.($card['summary'] ?? '').' '.($card['subject']->search_terms ?? ''));
return str_contains($haystack, mb_strtolower($query));
}
@@ -424,10 +449,34 @@ private function fileResponse(
'k0',
);
return $disk->response($file, basename($file), [
'Content-Disposition' => $action === 'laden' ? 'attachment' : 'inline',
'X-License-Copy' => $delivery->copy_id,
]);
// Dateiname aus dem Anzeigetitel statt aus der Adresse („laden.mp4“); Laravel setzt Content-Disposition mit
// ASCII-Rückfall und UTF-8-Name.
return $disk->response(
$file,
$this->downloadName($version, $file),
['X-License-Copy' => $delivery->copy_id],
$action === 'laden' ? 'attachment' : 'inline',
);
}
/**
* Dateiname für Ansicht und Download: Anzeigetitel des Mediums (Mitgliedertext, sonst Arbeitstitel) mit der
* Endung der gespeicherten Datei. Zeichen, die in Dateinamen nicht erlaubt sind, entfallen.
*/
private function downloadName(ContentElementVersion $version, string $file): string
{
$element = $version->element;
$title = $element === null ? '' : app(LibraryCatalog::class)->text($element)['title'];
$title = (string) preg_replace('/[\x00-\x1F\x7F\/\\\\:*?"<>|]+/u', ' ', $title);
$title = trim((string) preg_replace('/\s+/u', ' ', $title));
$title = rtrim(mb_substr($title, 0, 120), '. ');
$extension = strtolower(pathinfo($file, PATHINFO_EXTENSION));
if ($title === '') {
return basename($file);
}
return $extension === '' ? $title : $title.'.'.$extension;
}
private function renditionBelongsTo(int $versionId, string $path): bool
@@ -2,10 +2,9 @@
namespace App\Http\Controllers\Member;
use App\Domain\Identity\AccountStatus;
use App\Http\Controllers\Controller;
use App\Http\LibraryCatalog;
use Illuminate\Http\RedirectResponse;
use App\Http\MemberLicenses;
use Illuminate\Http\Request;
use Illuminate\View\View;
@@ -14,35 +13,17 @@ class MemberController extends Controller
public function dashboard(Request $request): View
{
$catalog = app(LibraryCatalog::class)->index($request->user());
$films = array_filter($catalog['materials'], fn (array $card): bool => $card['type'] === 'film');
return view('member.dashboard', [
'programCount' => count($catalog['programs']),
'moduleCount' => count($catalog['modules']),
'materialCount' => count($catalog['materials']),
'programs' => array_slice($catalog['programs'], 0, 4),
'counts' => [
'programm' => count($catalog['programs']),
'modul' => count($catalog['modules']),
'film' => count($films),
'material' => count($catalog['materials']) - count($films),
],
'licenseCount' => app(MemberLicenses::class)->overview($request->user())->where('active', true)->count(),
]);
}
public function profile(): View
{
return view('member.profile');
}
public function updateProfile(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv, 403);
$data = $request->validate([
'name' => ['required', 'string', 'max:120'],
]);
$user->name = $data['name'];
$user->save();
$user->party?->update(['display_name' => $data['name']]);
$user->party?->profile?->update(['display_name' => $data['name']]);
return redirect()->route('member.profile')->with('status', 'Der Name ist gespeichert. Er ist nicht öffentlich.');
}
}
@@ -0,0 +1,154 @@
<?php
namespace App\Http\Controllers\Member;
use App\Domain\Identity\AccountStatus;
use App\Domain\Identity\BillingAddress;
use App\Http\Controllers\Controller;
use App\Models\User;
use App\Notifications\ConfirmNewEmailAddress;
use App\Notifications\EmailChangeRequested;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Notification;
use Illuminate\Validation\Rule;
use Illuminate\Validation\Rules\Password;
use Illuminate\View\View;
/**
* Mitgliederprofil: Name, E-Mail-Adresse, Passwort und Rechnungsadresse. Jeder Block hat seine eigene Speicherhandlung
* und seine eigenen Fehlermeldungen; nichts wird verdeckt mitgespeichert. Sicherheitsrelevante Änderungen (Adresse,
* Passwort) verlangen das aktuelle Passwort.
*/
class ProfileController extends Controller
{
public function show(Request $request): View
{
$user = $request->user();
return view('member.profile', [
'address' => $user->party?->billingAddress,
'countries' => BillingAddress::COUNTRIES,
]);
}
public function updateName(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv, 403);
$data = $request->validateWithBag('name', [
'name' => ['required', 'string', 'max:120'],
]);
$user->name = $data['name'];
$user->save();
$user->party?->update(['display_name' => $data['name']]);
$user->party?->profile?->update(['display_name' => $data['name']]);
return redirect()->route('member.profile')->with('status', 'Der Name ist gespeichert. Er ist nicht öffentlich.');
}
/**
* Die neue Adresse gilt erst nach Bestätigung über einen Link an sie. Bis dahin bleibt die bisherige Adresse
* in Kraft und erhält einen Hinweis.
*/
public function requestEmail(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv, 403);
$data = $request->validateWithBag('email', [
'email' => ['required', 'string', 'email:rfc', 'max:255', Rule::unique('users', 'email')],
'current_password' => ['required', 'current_password'],
], [
'email.unique' => 'Diese Adresse ist bereits vergeben.',
'current_password.current_password' => 'Das Passwort stimmt nicht.',
]);
$new = mb_strtolower(trim($data['email']));
if ($new === mb_strtolower($user->email)) {
return back()->withErrors(['email' => 'Das ist bereits deine Adresse.'], 'email');
}
$user->forceFill(['pending_email' => $new])->save();
Notification::route('mail', $new)->notify(new ConfirmNewEmailAddress($user->id, $new));
$user->notify(new EmailChangeRequested($new));
return redirect()->route('member.profile')->with('status', 'Wir haben einen Bestätigungslink an '.$new.' geschickt. Die Adresse wechselt, sobald du ihn öffnest.');
}
public function confirmEmail(Request $request, int $id, string $hash): RedirectResponse
{
$user = $request->user();
abort_unless($user->id === $id, 403);
$pending = $user->pending_email;
if (! is_string($pending) || $pending === '' || ! hash_equals(sha1($pending), $hash)) {
return redirect()->route('member.profile')->withErrors(['email' => 'Dieser Link gilt nicht mehr. Fordere die Änderung bitte erneut an.'], 'email');
}
if (User::query()->where('email', $pending)->whereKeyNot($user->id)->exists()) {
$user->forceFill(['pending_email' => null])->save();
return redirect()->route('member.profile')->withErrors(['email' => 'Diese Adresse ist inzwischen vergeben.'], 'email');
}
$user->forceFill(['email' => $pending, 'pending_email' => null, 'email_verified_at' => now()])->save();
return redirect()->route('member.profile')->with('status', 'Deine E-Mail-Adresse ist geändert.');
}
public function cancelEmail(Request $request): RedirectResponse
{
$request->user()->forceFill(['pending_email' => null])->save();
return redirect()->route('member.profile')->with('status', 'Die Änderung der E-Mail-Adresse ist verworfen.');
}
public function updatePassword(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv, 403);
$data = $request->validateWithBag('password', [
'current_password' => ['required', 'current_password'],
'password' => ['required', 'confirmed', Password::defaults(), 'different:current_password'],
], [
'current_password.current_password' => 'Das bisherige Passwort stimmt nicht.',
'password.different' => 'Das neue Passwort muss sich vom bisherigen unterscheiden.',
]);
$user->forceFill(['password' => Hash::make($data['password'])])->save();
$request->session()->regenerate();
return redirect()->route('member.profile')->with('status', 'Dein Passwort ist geändert.');
}
public function updateAddress(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv || $user->party === null, 403);
$data = $request->validateWithBag('address', [
'recipient' => ['required', 'string', 'max:160'],
'line2' => ['nullable', 'string', 'max:160'],
'street' => ['required', 'string', 'max:160'],
'postal_code' => ['required', 'string', 'max:16'],
'city' => ['required', 'string', 'max:120'],
'country' => ['required', Rule::in(array_keys(BillingAddress::COUNTRIES))],
], [
'recipient.required' => 'Bitte gib Name oder Firma an.',
'street.required' => 'Bitte gib Straße und Hausnummer an.',
'postal_code.required' => 'Bitte gib die Postleitzahl an.',
'city.required' => 'Bitte gib den Ort an.',
]);
BillingAddress::query()->updateOrCreate(['party_id' => $user->party_id], $data);
return redirect()->route('member.profile')->with('status', 'Die Rechnungsadresse ist gespeichert.');
}
}
@@ -2,6 +2,7 @@
namespace App\Http\Controllers;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionStructureReader;
use App\Domain\Cms\Catalog\PublicCatalogReader;
@@ -17,6 +18,25 @@ public function index(PublicCatalogReader $catalog): View
return view('public.programs', ['programs' => $catalog->publicPrograms()]);
}
/**
* Eigene Produktseite eines Pakets, das für sich vermarktet wird: Sie zeigt den tatsächlichen Umfang des Pakets
* (die enthaltenen Artikel) und darunter die kaufbaren Lizenzoptionen. Ohne kaufbare Option gibt es sie nicht.
*/
public function package(Bundle $bundle, ProductOptions $products, Cart $cart): View
{
abort_unless(Shop::enabled(), 404);
$options = $products->forBundle($bundle);
abort_if($options === [], 404);
return view('public.package', [
'bundle' => $bundle,
'contents' => $products->bundleContents($options),
'options' => $options,
'cart' => $cart,
'switchTo' => session('shop.switch'),
]);
}
public function program(Composition $composition, PublicCatalogReader $catalog, ProductOptions $products, Cart $cart): View
{
$version = $catalog->shownVersion($composition);
+22 -1
View File
@@ -2,6 +2,7 @@
namespace App\Http\Controllers;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\Composition;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Commerce\Money;
@@ -37,7 +38,7 @@ public function index(Request $request, ProductOptions $products, PublicCatalogR
$summary = $summaries[$composition->id];
$cards[] = [
'composition' => $composition,
'url' => route('public.program', $composition),
'title' => $title,
'teaser' => (string) ($composition->teaser ?: $composition->summary),
'from' => Money::format($summary['from_cents']),
@@ -45,6 +46,26 @@ public function index(Request $request, ProductOptions $products, PublicCatalogR
];
}
// Pakete mit eigener Produktseite: gelistet mit Name und enthaltenen Artikeln.
foreach (Bundle::query()->whereIn('id', array_keys($products->bundleSummaries()))->orderBy('name')->get() as $bundle) {
$options = $products->forBundle($bundle);
$contents = $products->bundleContents($options);
$names = implode(', ', array_column($contents, 'title'));
if ($term !== '' && ! str_contains(mb_strtolower($bundle->name.' '.$names), mb_strtolower($term))) {
continue;
}
$summary = $products->bundleSummaries()[$bundle->id];
$cards[] = [
'url' => route('public.package', $bundle),
'title' => (string) $bundle->name,
'teaser' => 'Paket mit '.count($contents).' '.(count($contents) === 1 ? 'Inhalt' : 'Inhalten').($names !== '' ? ': '.$names : ''),
'from' => Money::format($summary['from_cents']),
'count' => $summary['count'],
];
}
return view('shop.index', ['cards' => $cards, 'term' => $term]);
}
}
@@ -83,6 +83,10 @@ private function paid(array $session, Checkout $checkout): JsonResponse
return response()->json(['received' => true, 'handled' => false]);
}
if (filled($session['payment_intent'] ?? null)) {
$order->payments()->where('provider_reference', $reference)->update(['provider_payment_ref' => (string) $session['payment_intent']]);
}
return response()->json(['received' => true, 'handled' => true]);
}
@@ -4,12 +4,15 @@
use App\Domain\Catalog\ContentElement;
use App\Domain\Media\WebsiteMedia;
use Illuminate\Support\Facades\Storage;
use App\Http\Controllers\Concerns\ServesByteRanges;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\StreamedResponse;
class WebsiteMediaController extends Controller
{
public function show(ContentElement $element, WebsiteMedia $media): StreamedResponse
use ServesByteRanges;
public function show(Request $request, ContentElement $element, WebsiteMedia $media): StreamedResponse
{
$presentation = $media->present($element);
abort_if($presentation === null, 404);
@@ -17,9 +20,6 @@ public function show(ContentElement $element, WebsiteMedia $media): StreamedResp
$path = $element->website_public_path;
abort_if(! is_string($path), 404);
return Storage::disk('media_public')->response($path, null, [
'Content-Disposition' => 'inline',
'X-Content-Type-Options' => 'nosniff',
]);
return $this->respondWithRanges($request, 'media_public', $path, $presentation->kind !== 'bild');
}
}
+329 -43
View File
@@ -9,6 +9,7 @@
use App\Domain\Catalog\CompositionVersion;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentElementVersion;
use App\Domain\Catalog\EditorialProfileReader;
use App\Domain\Catalog\ReleaseStatus;
use App\Domain\Catalog\StructureNode;
use App\Domain\Entitlement\DecideAccess;
@@ -18,24 +19,48 @@
use App\Domain\Media\ThumbnailRef;
use App\Filament\Support\EditorialCatalog;
use App\Models\User;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Collection;
/**
* Liest die Mitgliederbibliothek aus den vorhandenen Fachobjekten (Kompositionen, Medien, Artikelstände, Berechtigungen).
* Sie hält keine eigenen Daten. Jede Zugriffsfrage entscheidet DecideAccess; die Oberfläche zeigt nur das Ergebnis.
*
* Einmalaufbau: Der Strukturbaum einer Komposition wird je Anfrage nur einmal gebaut und für Verfügbarkeit,
* Zählungen und die programmübergreifende Medienliste gemeinsam genutzt.
*/
class LibraryCatalog
{
/** @var array<string, list<array<string, mixed>>> */
private array $trees = [];
/** @var array<string, array{title: string, summary: ?string, description: ?string}> */
private array $texts = [];
/** @var array<int, ?ContentElement> */
private array $elements = [];
public function __construct(
private readonly CompositionDisplayRelease $display,
private readonly CompositionStructureReader $structure,
private readonly DecideAccess $access,
private readonly EditorialProfileReader $profiles,
) {}
/**
* Programme, Module und einzelne Medien (Filme und Materialien) der Berechtigungen des Kontos.
*
* Einzelne Medien erscheinen genau einmal je stabiler Medienidentität (Inhaltselement), gleich in wie vielen Programmen
* oder Modulen sie vorkommen. „used_in“ nennt diese Verwendungen. Innerhalb eines Programms bleibt jede Einbindung an
* ihrer Stelle erhalten (program()). Gleiche Titel verschiedener Elemente bleiben getrennt.
*
* @return array{programs: list<array<string, mixed>>, modules: list<array<string, mixed>>, materials: list<array<string, mixed>>}
*/
public function index(User $user): array
{
$programs = [];
$modules = [];
$materials = [];
$media = [];
foreach ($this->grants($user) as $grant) {
$article = $grant->article;
@@ -44,124 +69,365 @@ public function index(User $user): array
$version = $release?->rootCompositionVersion;
if ($composition !== null && $version !== null && $this->display->isReleased($version)) {
$shown = $this->display->highestReleasedVersion($composition);
$nodes = $shown === null ? [] : $this->tree($user, $shown, false, $composition->id);
$picture = app(EditorialCatalog::class)->visiblePicture($composition, $version);
$text = $this->text($composition);
$card = [
'type' => $composition->editorialContentKind?->slug === 'modul' ? 'modul' : 'programm',
'composition' => $composition,
'subject' => $composition,
'version' => $version,
'title' => filled($composition->display_title) ? $composition->display_title : $composition->designation,
'summary' => $composition->summary,
'title' => $text['title'],
'summary' => $text['summary'],
'kind' => $composition->editorialContentKind?->label
?? ($composition->kind?->label()),
'coverage' => $this->coverageLabel($user, $composition),
'coverage' => $this->coverage($nodes),
'module_count' => $this->countCompositions($nodes),
'duration_minutes' => $shown?->duration_minutes,
'image' => $picture['alt'] ?? null,
'image_url' => $picture === null ? null : route('member.thumbnail', [
'kind' => $picture['kind'],
'subject' => $picture['subject'],
]),
'url' => route('member.program', $composition),
];
$shelf = $composition->editorialContentKind?->slug === 'modul' ? 'modules' : 'programs';
if ($shelf === 'modules') {
if ($card['type'] === 'modul') {
$modules[$composition->id] = $card;
} else {
$programs[$composition->id] = $card;
}
$this->collect($media, $nodes, [['title' => $text['title'], 'url' => $card['url'], 'id' => $composition->id]], $composition);
continue;
}
$element = $release?->rootElementVersion?->element;
$elementId = $element?->id;
$key = $composition !== null
? 'komposition-'.$composition->id
: ($elementId !== null ? 'element-'.$elementId : 'artikel-'.$article->id);
: ($element?->id !== null ? 'element-'.$element->id : 'artikel-'.$article->id);
$subject = $element ?? $composition ?? $article;
$text = $element !== null ? $this->text($element) : null;
$imageUrl = $element === null ? null : ThumbnailRef::url('member.thumbnail', 'element', $element->id, $element->thumbnail_path);
$materials[$key] = [
'article' => $article,
'title' => app(CourseOutline::class)->title($article),
'summary' => $element?->summary ?? $composition?->summary,
'kind' => app(CourseOutline::class)->kindLabel($article),
'coverage' => 'nutzbar',
'image' => $imageUrl === null ? null : ($element->thumbnail_alt ?: $element->working_title),
'image_url' => $imageUrl,
$media[$key] = ($media[$key] ?? []) + [
'used_in' => [],
'versions' => [],
'context' => null,
];
$media[$key] = [
...$media[$key],
'key' => $key,
'type' => $element?->output_class === 'film' ? 'film' : 'material',
'article' => $article,
'subject' => $subject,
'title' => $text['title'] ?? app(CourseOutline::class)->title($article),
'summary' => $text['summary'] ?? $element?->summary ?? $composition?->summary,
'kind' => app(CourseOutline::class)->kindLabel($article) ?? ($element === null ? null : $this->outputLabel($element->output_class)),
'coverage' => 'nutzbar',
'image' => $imageUrl === null ? null : ($element->thumbnail_alt ?: ($text['title'] ?? $element->working_title)),
'image_url' => $imageUrl,
'url' => route('member.article', $article),
];
}
foreach ($media as $key => $item) {
if (! isset($item['url'])) {
$media[$key]['url'] = route('member.content', [
'composition' => $item['context']['composition']->id,
'version' => $item['context']['version_id'],
]);
}
}
return [
'programs' => array_values($programs),
'modules' => array_values($modules),
'materials' => array_values($materials),
'materials' => array_values($media),
];
}
/**
* @return array{composition: Composition, title: string, kind: ?string, nodes: list<array<string, mixed>>}
* Programm- oder Moduldetail: gesamte Struktur mit allen Einbindungen an ihrer Stelle.
*
* @return array<string, mixed>
*/
public function program(User $user, Composition $composition): array
{
$version = $this->display->highestReleasedVersion($composition);
abort_if($version === null, 404);
$nodes = array_map(
fn (StructureNode $node): array => $this->present($user, $node),
$this->structure->tree($version),
);
$nodes = $this->tree($user, $version, true, $composition->id);
$leaves = $this->leaves($nodes);
$open = count(array_filter($leaves, fn (array $leaf): bool => $leaf['view_url'] !== null));
$text = $this->text($composition);
return [
'composition' => $composition,
'picture' => app(EditorialCatalog::class)->visiblePicture($composition, $version),
'title' => filled($composition->display_title) ? $composition->display_title : $composition->designation,
'summary' => $composition->summary,
'title' => $text['title'],
'summary' => $text['summary'],
'description' => $text['description'],
'kind' => $composition->editorialContentKind?->label
?? ($composition->kind?->label()),
'is_module' => $composition->editorialContentKind?->slug === 'modul',
'learning_goal' => $version->learning_goal,
'duration_minutes' => $version->duration_minutes,
'material_note' => $version->material_note,
'coverage' => $leaves === [] ? 'nicht enthalten' : ($open === count($leaves) ? 'nutzbar' : ($open === 0 ? 'nicht enthalten' : 'teilweise')),
'coverage' => $this->coverage($nodes),
'module_count' => $this->countCompositions($nodes),
'film_count' => count(array_filter($leaves, fn (array $leaf): bool => $leaf['output_class'] === 'film')),
'material_count' => count(array_filter($leaves, fn (array $leaf): bool => $leaf['element_id'] !== null && $leaf['output_class'] !== 'film')),
'open_count' => count(array_filter($leaves, fn (array $leaf): bool => $leaf['view_url'] !== null)),
'leaf_count' => count($leaves),
'nodes' => $nodes,
];
}
/**
* Eine Filmstelle oder ein Material im Zusammenhang seines Programms oder Moduls.
* Gesucht wird die Einbindung in der angezeigten Fassung; was dort nicht steht, gibt es hier nicht.
*
* @return array<string, mixed>|null
*/
public function content(User $user, Composition $composition, int $elementVersionId): ?array
{
$version = $this->display->highestReleasedVersion($composition);
if ($version === null) {
return null;
}
$nodes = $this->tree($user, $version, true, $composition->id);
$found = $this->locate($nodes, $elementVersionId, []);
if ($found === null) {
return null;
}
$node = $found['node'];
$element = $node['element_id'] === null ? null : $this->element($node['element_id']);
$text = $element === null ? ['title' => $node['title'], 'summary' => null, 'description' => null] : $this->text($element);
$rootText = $this->text($composition);
$trail = [['label' => $rootText['title'], 'url' => route('member.program', $composition)]];
foreach ($found['parents'] as $parent) {
if ($parent['program_url'] !== null && $parent['composition_id'] !== $composition->id) {
$trail[] = ['label' => $parent['title'], 'url' => $parent['program_url']];
}
}
$companions = array_values(array_filter(
$found['siblings'],
fn (array $sibling): bool => $sibling['children'] === []
&& $sibling['element_id'] !== null
&& $sibling['version_id'] !== $elementVersionId,
));
return [
'composition' => $composition,
'program_title' => $rootText['title'],
'node' => $node,
'element' => $element,
'title' => $text['title'],
'summary' => $text['summary'],
'description' => $text['description'],
'trail' => $trail,
'back' => $trail[array_key_last($trail)],
'companions' => $companions,
'allowed' => $node['view_url'] !== null,
];
}
/**
* Anzeigetitel und -texte für die Mitgliederbibliothek: Abweichung für „Mitgliederbibliothek“, sonst die zentrale Angabe,
* zuletzt die interne Bezeichnung. Nichts wird kopiert oder ergänzt.
*
* @return array{title: string, summary: ?string, description: ?string}
*/
public function text(Model $subject): array
{
$key = $subject->getMorphClass().':'.$subject->getKey();
if (isset($this->texts[$key])) {
return $this->texts[$key];
}
$profile = $this->profiles->read($subject, 'bibliothek');
return $this->texts[$key] = [
'title' => $profile->value('display_title') ?? $profile->workingTitle ?? '',
'summary' => $profile->value('summary') ?? $profile->value('teaser'),
'description' => $profile->value('description'),
];
}
public function outputLabel(?string $outputClass): ?string
{
return match ($outputClass) {
'film' => 'Film',
'audio' => 'Hörstück',
'document', 'pdf' => 'Dokument',
'text' => 'Text',
'bild' => 'Bild',
null => null,
default => $outputClass,
};
}
/**
* @param list<array<string, mixed>> $nodes
* @param list<array{title: string, url: string, id: int}> $contexts
* @param array<string, array<string, mixed>> $media
*/
private function collect(array &$media, array $nodes, array $contexts, Composition $root): void
{
foreach ($nodes as $node) {
if ($node['children'] !== []) {
$nested = $contexts;
if ($node['composition_id'] !== null && $node['program_url'] !== null && $node['composition_id'] !== $root->id) {
$nested[] = ['title' => $node['title'], 'url' => $node['program_url'], 'id' => $node['composition_id']];
}
$this->collect($media, $node['children'], $nested, $root);
continue;
}
if ($node['element_id'] === null || $node['view_url'] === null) {
continue;
}
$key = 'element-'.$node['element_id'];
$element = $this->element($node['element_id']);
if ($element === null) {
continue;
}
$text = $this->text($element);
$item = $media[$key] ?? [
'key' => $key,
'type' => $node['output_class'] === 'film' ? 'film' : 'material',
'article' => null,
'subject' => $element,
'title' => $text['title'],
'summary' => $text['summary'],
'kind' => $node['kind'] ?? $this->outputLabel($node['output_class']),
'coverage' => 'nutzbar',
'image' => $node['poster_url'] === null ? null : ($element->thumbnail_alt ?: $text['title']),
'image_url' => $node['poster_url'],
'used_in' => [],
'versions' => [],
'context' => null,
];
foreach ($contexts as $context) {
$item['used_in'][$context['id']] = ['title' => $context['title'], 'url' => $context['url']];
}
$item['versions'][$node['version_id']] = true;
$item['context'] ??= ['composition' => $root, 'version_id' => $node['version_id']];
$media[$key] = $item;
}
}
/**
* @return list<array<string, mixed>>
*/
private function tree(User $user, CompositionVersion $version, bool $full, int $rootId): array
{
$key = $version->id.':'.($full ? 'voll' : 'kurz').':'.$rootId;
return $this->trees[$key] ??= array_map(
fn (StructureNode $node): array => $this->present($user, $node, $full, $rootId),
$this->structure->tree($version),
);
}
/**
* @return array<string, mixed>
*/
private function present(User $user, StructureNode $node): array
private function present(User $user, StructureNode $node, bool $full, int $rootId): array
{
$view = null;
$download = null;
$playback = 'file';
$poster = null;
$element = $node->contentElementId === null ? null : $this->element($node->contentElementId);
if ($node->contentElementVersionId !== null) {
$view = $this->open($user, $node->contentElementVersionId, $this->viewAction($node->outputClass));
if ($full) {
$download = $this->open($user, $node->contentElementVersionId, 'laden');
$playback = app(FilmPlayback::class)->mode($node->contentElementVersionId);
if ($view !== null && $node->contentElementId !== null) {
$path = ContentElement::query()->whereKey($node->contentElementId)->value('thumbnail_path');
$poster = ThumbnailRef::url('member.thumbnail', 'element', $node->contentElementId, $path);
}
if ($view !== null && $element !== null) {
$poster = ThumbnailRef::url('member.thumbnail', 'element', $element->id, $element->thumbnail_path);
}
}
$title = $node->title;
if ($element !== null) {
$title = $this->text($element)['title'] ?: $title;
} elseif ($node->compositionId !== null) {
$nested = Composition::query()->find($node->compositionId);
$title = $nested === null ? $title : ($this->text($nested)['title'] ?: $title);
}
return [
'role' => $node->role,
'title' => $node->title,
'kind' => $node->editorialKindLabel ?? $node->technicalKindLabel,
'title' => $title,
'summary' => $element === null ? null : $this->text($element)['summary'],
'kind' => $node->editorialKindLabel ?? $this->outputLabel($node->technicalKindLabel) ?? $node->technicalKindLabel,
'output_class' => $node->outputClass,
'playback' => $playback,
'view_url' => $view,
'poster_url' => $poster,
'download_url' => $download,
'program_url' => $this->programUrl($node),
'composition_id' => $node->compositionId,
'element_id' => $node->contentElementId,
'version_id' => $node->contentElementVersionId,
'content_url' => $node->contentElementVersionId === null ? null : route('member.content', [
'composition' => $rootId,
'version' => $node->contentElementVersionId,
]),
'children' => array_map(
fn (StructureNode $child): array => $this->present($user, $child),
fn (StructureNode $child): array => $this->present($user, $child, $full, $rootId),
$node->children,
),
];
}
/**
* @param list<array<string, mixed>> $nodes
* @param list<array<string, mixed>> $parents
* @return array{node: array<string, mixed>, parents: list<array<string, mixed>>, siblings: list<array<string, mixed>>}|null
*/
private function locate(array $nodes, int $versionId, array $parents): ?array
{
foreach ($nodes as $node) {
if ($node['version_id'] === $versionId) {
return ['node' => $node, 'parents' => $parents, 'siblings' => $nodes];
}
if ($node['children'] !== []) {
$found = $this->locate($node['children'], $versionId, [...$parents, $node]);
if ($found !== null) {
return $found;
}
}
}
return null;
}
/**
* @param list<array<string, mixed>> $nodes
* @return list<array<string, mixed>>
@@ -183,18 +449,29 @@ private function leaves(array $nodes): array
return $leaves;
}
private function coverageLabel(User $user, Composition $composition): string
/**
* @param list<array<string, mixed>> $nodes
*/
private function countCompositions(array $nodes): int
{
$version = $this->display->highestReleasedVersion($composition);
$count = 0;
if ($version === null) {
return 'nicht enthalten';
foreach ($nodes as $node) {
if ($node['composition_id'] !== null) {
$count++;
}
$nodes = array_map(
fn (StructureNode $node): array => $this->present($user, $node),
$this->structure->tree($version),
);
$count += $this->countCompositions($node['children']);
}
return $count;
}
/**
* @param list<array<string, mixed>> $nodes
*/
private function coverage(array $nodes): string
{
$leaves = $this->leaves($nodes);
$open = count(array_filter($leaves, fn (array $leaf): bool => $leaf['view_url'] !== null));
@@ -205,6 +482,15 @@ private function coverageLabel(User $user, Composition $composition): string
return $open === count($leaves) ? 'nutzbar' : 'teilweise';
}
private function element(int $id): ?ContentElement
{
if (! array_key_exists($id, $this->elements)) {
$this->elements[$id] = ContentElement::query()->find($id);
}
return $this->elements[$id];
}
private function programUrl(StructureNode $node): ?string
{
if ($node->compositionId === null || $node->compositionVersionId === null) {
+325
View File
@@ -0,0 +1,325 @@
<?php
namespace App\Http;
use App\Domain\Catalog\CompositionStructureReader;
use App\Domain\Catalog\StructureNode;
use App\Domain\Commerce\OrderLine;
use App\Domain\Commerce\ProductOptions;
use App\Domain\Entitlement\AcquisitionType;
use App\Domain\Entitlement\Grant;
use App\Domain\Entitlement\GrantStatus;
use App\Domain\Identity\PartyType;
use App\Domain\Media\ThumbnailRef;
use App\Filament\Support\CatalogLabels;
use App\Models\User;
use Carbon\CarbonInterface;
use Illuminate\Support\Collection;
/**
* Lizenzübersicht für Mitglieder: macht Erwerb, Zweck, Aktionen und Zeitraum je Berechtigung lesbar.
*
* Es gibt keine eigene Rechtelogik. Gezeigt wird je Berechtigung (Grant) genau das, was in ihr steht; Rechte verschiedener
* Erwerbe werden weder zusammengezählt noch zu einem Gesamtprofil vereinigt. Den Zustand „aktiv“ bestimmt dieselbe Regel
* wie die Zugriffsentscheidung (Status, Beginn und Ende), damit die Anzeige nie mehr verspricht als DecideAccess erlaubt.
*/
class MemberLicenses
{
public function __construct(
private readonly LibraryCatalog $catalog,
private readonly CompositionStructureReader $structure,
) {}
/**
* @return Collection<int, array<string, mixed>>
*/
public function overview(User $user): Collection
{
return $this->grants($user)->map(fn (Grant $grant): array => $this->entry($user, $grant))->values();
}
/**
* @return array<string, mixed>
*/
public function detail(User $user, Grant $grant): array
{
$grant->loadMissing('article.currentRelease.contents.elementVersion.element', 'article.currentRelease.rootCompositionVersion.composition');
$entry = $this->entry($user, $grant);
$release = $grant->article->currentRelease;
$classes = [];
$contents = [];
foreach ($release?->contents ?? [] as $content) {
$element = $content->elementVersion?->element;
if ($element === null) {
continue;
}
$classes[$element->output_class] = ($classes[$element->output_class] ?? 0) + 1;
$contents[$element->id] = [
'title' => $this->catalog->text($element)['title'],
'kind' => $this->catalog->outputLabel($element->output_class),
'role' => $content->role,
];
}
$moduleCount = 0;
$rootVersion = $release?->rootCompositionVersion;
if ($rootVersion !== null) {
$moduleCount = $this->countCompositions($this->structure->tree($rootVersion));
}
$scope = [];
if ($moduleCount > 0) {
$scope[] = $moduleCount.' '.($moduleCount === 1 ? 'Modul' : 'Module');
}
foreach ($classes as $class => $count) {
$scope[] = $count.' '.$this->plural((string) $class, $count);
}
$granted = $this->granted($grant);
$restrictions = [];
foreach (array_keys($classes) as $class) {
foreach (CatalogLabels::FAEHIGKEITEN as $key => $label) {
if (str_starts_with($key, $class.':') && ! in_array($key, $granted, true)) {
$restrictions[] = $label.' ist in diesem Erwerb nicht enthalten.';
}
}
}
if ($entry['state'] !== 'aktiv') {
array_unshift($restrictions, $entry['state_note']);
}
if ($entry['holder_kind'] === 'organisation') {
$restrictions[] = 'Die Nutzung gilt, solange deine Mitgliedschaft in dieser Organisation mit Bestellberechtigung besteht.';
}
return $entry + [
'scope' => $scope,
'contents' => array_values($contents),
'restrictions' => $restrictions,
'composition' => $rootVersion?->composition,
'open_url' => $rootVersion?->composition !== null
? route('member.program', $rootVersion->composition)
: route('member.article', $grant->article),
];
}
/**
* @return array<string, mixed>
*/
private function entry(User $user, Grant $grant): array
{
$grant->loadMissing('article.currentRelease.rootCompositionVersion.composition.editorialContentKind', 'article.currentRelease.rootElementVersion.element', 'acquisition.party');
$article = $grant->article;
$release = $article->currentRelease;
$state = $this->state($grant);
$snapshot = is_array($grant->rights_snapshot) ? $grant->rights_snapshot : [];
$conditions = is_array($grant->acquisition?->conditions) ? $grant->acquisition->conditions : [];
$holderKind = $grant->acquisition?->party?->type === PartyType::Organisation ? 'organisation' : 'person';
$composition = $release?->rootCompositionVersion?->composition;
$element = $release?->rootElementVersion?->element;
$imageUrl = null;
if ($grant->status === GrantStatus::Aktiv) {
$imageUrl = $composition !== null
? ThumbnailRef::url('member.thumbnail', 'komposition', $composition->id, $composition->thumbnail_path)
: ($element === null ? null : ThumbnailRef::url('member.thumbnail', 'element', $element->id, $element->thumbnail_path));
}
$title = $composition !== null
? $this->catalog->text($composition)['title']
: ($element !== null ? $this->catalog->text($element)['title'] : app(CourseOutline::class)->title($article));
return [
'grant' => $grant,
'id' => $grant->id,
'title' => $title !== '' ? $title : $article->code,
'kind' => app(CourseOutline::class)->kindLabel($article),
'code' => $article->code,
'image_url' => $imageUrl,
'state' => $state['key'],
'state_label' => $state['label'],
'state_note' => $state['note'],
'active' => $state['key'] === 'aktiv',
'purpose' => filled($snapshot['purpose'] ?? null) ? CatalogLabels::zweck((string) $snapshot['purpose']) : null,
'rights' => CatalogLabels::faehigkeiten(is_array($snapshot['capabilities'] ?? null) ? $snapshot['capabilities'] : []),
'valid_from' => $grant->valid_from,
'valid_until' => $grant->valid_until,
'validity' => $this->validity($grant, $conditions),
'term' => filled($conditions['term_rule'] ?? null) ? ProductOptions::termRuleLabel((string) $conditions['term_rule']) : null,
'updates' => ($conditions['update_promise'] ?? null) === 'alle_freigegebenen_fassungen'
? 'Spätere freigegebene Fassungen sind eingeschlossen.'
: null,
'source' => $this->source($user, $grant),
'licence_scope' => $conditions['licence_scope'] ?? null,
'trainer_count' => isset($conditions['trainer_count']) ? (int) $conditions['trainer_count'] : null,
'holder_kind' => $holderKind,
'holder' => $holderKind === 'organisation' ? (string) ($grant->acquisition?->party?->display_name ?? 'Organisation') : 'Persönlich',
'url' => route('member.grant', $grant),
];
}
/**
* Zustand wie in DecideAccess: Status aktiv, Beginn erreicht, Ende nicht überschritten.
*
* @return array{key: string, label: string, note: string}
*/
private function state(Grant $grant): array
{
$now = now();
if ($grant->status === GrantStatus::Widerrufen) {
return ['key' => 'widerrufen', 'label' => 'Widerrufen', 'note' => 'Diese Berechtigung wurde widerrufen.'.$this->reason($grant)];
}
if ($grant->status === GrantStatus::Ausgesetzt) {
return ['key' => 'ausgesetzt', 'label' => 'Ausgesetzt', 'note' => 'Diese Berechtigung ist derzeit ausgesetzt.'.$this->reason($grant)];
}
if ($grant->status === GrantStatus::Abgelaufen || ($grant->valid_until !== null && ! $grant->valid_until->greaterThan($now))) {
return ['key' => 'abgelaufen', 'label' => 'Abgelaufen', 'note' => 'Der Zeitraum dieser Berechtigung ist abgelaufen.'];
}
if ($grant->valid_from !== null && $grant->valid_from->greaterThan($now)) {
return ['key' => 'geplant', 'label' => 'Noch nicht gültig', 'note' => 'Diese Berechtigung beginnt am '.$this->date($grant->valid_from).'.'];
}
return ['key' => 'aktiv', 'label' => 'Aktiv', 'note' => ''];
}
private function reason(Grant $grant): string
{
return filled($grant->status_reason) ? ' Grund: '.$grant->status_reason : '';
}
/**
* @param array<string, mixed> $conditions
*/
private function validity(Grant $grant, array $conditions): string
{
$parts = [];
if ($grant->valid_from !== null) {
$parts[] = 'seit '.$this->date($grant->valid_from);
}
if ($grant->valid_until !== null) {
$parts[] = 'bis '.$this->date($grant->valid_until);
} elseif (($conditions['term_rule'] ?? 'dauerhaft') === 'dauerhaft') {
$parts[] = 'ohne Ablaufdatum';
} else {
$parts[] = 'Ende nicht hinterlegt';
}
return implode(' · ', $parts);
}
/**
* Herkunft des Rechts: Art des Erwerbs und, soweit vorhanden, die Bezeichnung des Angebots.
*
* @return array{label: string, detail: ?string, url: ?string}
*/
private function source(User $user, Grant $grant): array
{
$acquisition = $grant->acquisition;
$type = $acquisition?->type;
$label = match ($type) {
AcquisitionType::Bestellposition => 'Kauf',
AcquisitionType::FreierAbruf => 'Kostenloser Abruf',
AcquisitionType::ManuelleVergabe => 'Vergabe durch das Team',
AcquisitionType::Abonnement => 'Abonnement',
default => 'Erwerb',
};
$detail = null;
$url = null;
if ($type === AcquisitionType::Bestellposition && $acquisition?->reference_type === 'order_line') {
$line = OrderLine::query()->with('order')->find($acquisition->reference_id);
if ($line !== null) {
$detail = $line->offer_name;
if ($line->order?->user_id === $user->id) {
$url = route('member.order', $line->order);
}
}
}
return ['label' => $label, 'detail' => $detail, 'url' => $url];
}
/**
* @return list<string> Schlüssel „Klasse:Aktion“ der Berechtigung
*/
private function granted(Grant $grant): array
{
$keys = [];
$capabilities = is_array($grant->rights_snapshot['capabilities'] ?? null) ? $grant->rights_snapshot['capabilities'] : [];
foreach ($capabilities as $class => $actions) {
foreach ((array) $actions as $action) {
$keys[] = $class.':'.$action;
}
}
return $keys;
}
/**
* @param list<StructureNode> $nodes
*/
private function countCompositions(array $nodes): int
{
$count = 0;
foreach ($nodes as $node) {
if ($node->compositionId !== null) {
$count++;
}
$count += $this->countCompositions($node->children);
}
return $count;
}
private function plural(string $class, int $count): string
{
$forms = match ($class) {
'film' => ['Film', 'Filme'],
'audio' => ['Hörstück', 'Hörstücke'],
'document', 'pdf' => ['Dokument', 'Dokumente'],
'text' => ['Text', 'Texte'],
'bild' => ['Bild', 'Bilder'],
default => [$class, $class],
};
return $count === 1 ? $forms[0] : $forms[1];
}
private function date(CarbonInterface $date): string
{
return $date->timezone(config('app.timezone'))->format('d.m.Y');
}
/**
* Alle Berechtigungen des Kontos, auch nicht mehr aktive: Inaktive sollen nachvollziehbar bleiben.
*
* @return Collection<int, Grant>
*/
private function grants(User $user): Collection
{
return Grant::query()
->usableBy($user)
->with('article.currentRelease', 'acquisition.party')
->orderBy('id')
->get();
}
}
+7
View File
@@ -20,6 +20,7 @@ public function __construct(
public readonly ?int $fromElement = null,
public readonly ?int $versionId = null,
public readonly ?float $atSecond = null,
public readonly bool $websiteFile = false,
) {}
public function handle(ThumbnailDeriver $deriver): void
@@ -54,6 +55,12 @@ public function handle(ThumbnailDeriver $deriver): void
return;
}
if ($this->websiteFile && $this->atSecond !== null) {
$deriver->forElementWebsiteFrame($element, $this->atSecond);
return;
}
if ($this->versionId !== null && $this->atSecond !== null) {
$version = ContentElementVersion::query()->find($this->versionId);
+61
View File
@@ -0,0 +1,61 @@
<?php
namespace App\Jobs;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Media\PresentationFile;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Queue\Queueable;
use Illuminate\Support\Str;
/**
* Kopiert die Website-Datei eines Mediums nach `derived/`. Nur die Warteschlange darf dort schreiben.
* Ein Fehler wird am Medium vermerkt (`thumbnail_error`), damit die Verwaltung ihn zeigen kann.
*/
class StorePresentationFile implements ShouldQueue
{
use Queueable;
public int $timeout = 3600;
public function __construct(
public int $elementId,
public string $incoming,
) {}
public function handle(PresentationFile $file): void
{
$element = ContentElement::query()->find($this->elementId);
if (! $element instanceof ContentElement) {
return;
}
try {
$file->place($element, $this->incoming);
// Ein schon freigegebenes Medium zeigt sonst weiter die alte öffentliche Kopie.
if ($element->website_released_at !== null) {
PublishWebsiteMedia::dispatch($element->id, 'release');
}
} catch (DomainRuleException $e) {
$this->remember($element, $e->getMessage());
}
}
public function failed(\Throwable $e): void
{
$element = ContentElement::query()->find($this->elementId);
if ($element instanceof ContentElement) {
$this->remember($element, 'Die Datei ließ sich nicht übernehmen: '.Str::limit($e->getMessage(), 120));
}
}
private function remember(ContentElement $element, string $message): void
{
$element->thumbnail_error = $message;
$element->save();
}
}
+1 -1
View File
@@ -23,7 +23,7 @@
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
#[Fillable(['party_id', 'name', 'email', 'password', 'status', 'confirmed_adult_at'])]
#[Fillable(['party_id', 'name', 'email', 'password', 'status', 'confirmed_adult_at', 'pending_email'])]
#[Hidden(['password', 'remember_token'])]
class User extends Authenticatable implements FilamentUser, HasAppAuthentication, HasAppAuthenticationRecovery, MustVerifyEmail
{
@@ -0,0 +1,36 @@
<?php
namespace App\Notifications;
use App\Http\SignedLink;
use Illuminate\Notifications\Messages\MailMessage;
use Illuminate\Notifications\Notification;
use Illuminate\Support\Carbon;
/**
* Bestätigungslink an die NEUE Adresse. Erst der Klick darauf tauscht die Adresse des Kontos aus.
*/
class ConfirmNewEmailAddress extends Notification
{
public function __construct(private readonly int $userId, private readonly string $newEmail) {}
/** @return list<string> */
public function via(mixed $notifiable): array
{
return ['mail'];
}
public function toMail(mixed $notifiable): MailMessage
{
$url = SignedLink::temporary('member.profile.email.confirm', Carbon::now()->addMinutes(60), [
'id' => $this->userId,
'hash' => sha1($this->newEmail),
]);
return (new MailMessage)
->subject('Neue E-Mail-Adresse bestätigen')
->line('Du hast gebeten, die E-Mail-Adresse deines Kontos bei Lara & Felix zu ändern. Bestätige mit dem Knopf, dass diese Adresse dir gehört.')
->action('Adresse bestätigen', $url)
->line('Der Link gilt 60 Minuten. Wenn du das nicht angefordert hast, ignoriere diese Nachricht; es ändert sich nichts.');
}
}
@@ -0,0 +1,28 @@
<?php
namespace App\Notifications;
use Illuminate\Notifications\Messages\MailMessage;
use Illuminate\Notifications\Notification;
/**
* Hinweis an die bisherige Adresse, dass eine Änderung beantragt wurde (Schutz vor Kontoübernahme).
*/
class EmailChangeRequested extends Notification
{
public function __construct(private readonly string $newEmail) {}
/** @return list<string> */
public function via(mixed $notifiable): array
{
return ['mail'];
}
public function toMail(mixed $notifiable): MailMessage
{
return (new MailMessage)
->subject('Änderung deiner E-Mail-Adresse beantragt')
->line('Für dein Konto bei Lara & Felix wurde beantragt, die E-Mail-Adresse auf '.$this->newEmail.' zu ändern.')
->line('Die Adresse wechselt erst, wenn die neue Adresse bestätigt wird. Warst du das nicht, ändere bitte dein Passwort und melde dich bei uns.');
}
}
+3
View File
@@ -36,6 +36,9 @@
'stripe' => [
'secret' => env('STRIPE_SECRET'),
'webhook_secret' => env('STRIPE_WEBHOOK_SECRET'),
// Optional: ID eines in Stripe angelegten Steuersatzes (txr_...), der jeder Position mitgegeben wird.
// Er muss im Preis enthalten (inklusiv) sein, sonst weicht der gezahlte Betrag von der Bestellung ab.
'tax_rate' => env('STRIPE_TAX_RATE_ID'),
'api_base' => env('STRIPE_API_BASE', 'https://api.stripe.com'),
],
+32
View File
@@ -0,0 +1,32 @@
<?php
return [
/*
|--------------------------------------------------------------------------
| Produktivfreigabe des Shops (Verkaufsstart Deutschland)
|--------------------------------------------------------------------------
|
| Ohne diese Freigabe bleibt der Shop in Produktion abgeschaltet, und Stripe nimmt dort keine Zahlung an. Die
| Freigabe ist eine Entscheidung von Lars; sie wird ausschließlich in /etc/luf/prod.env gesetzt (SHOP_LIVE_RELEASE=true),
| nie im Repository. Zusätzlich verlangt Shop::live() einen Live-Schlüssel (sk_live_), den Zahlungstreiber „stripe“
| und veröffentlichte Rechtstexte (SalesTerms::missingPages()).
|
*/
'live_release' => (bool) env('SHOP_LIVE_RELEASE', false),
/*
| Kauf auf Rechnung für Vereine und Organisationen (PAY-006): auf Anfrage, Rechnung manuell durch den Betreiber.
*/
'invoice' => (bool) env('SHOP_INVOICE', true),
/*
| Preis- und Steuerhinweis im Warenkorb und in der Bestellübersicht. Der Wortlaut hängt an der Steuerentscheidung
| (OPEN-06) und wird erst mit ihr festgelegt (Umgebungsvariable SHOP_PRICE_NOTE).
*/
'price_note' => env('SHOP_PRICE_NOTE', 'Alle Preise in Euro.'),
];
+7
View File
@@ -70,6 +70,13 @@ public function katalogverwalter(): static
});
}
public function kundenbetreuung(): static
{
return $this->afterCreating(function (User $user): void {
$user->staffRoles()->create(['role' => StaffRole::Kundenbetreuung]);
});
}
public function redakteur(): static
{
return $this->afterCreating(function (User $user): void {
@@ -0,0 +1,32 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Herkunft der Bild-Medien, die aus dem Vorschaubild eines Programms oder Moduls übernommen wurden
* (Programm- und Modulkarte). Additiv. Verhindert, dass dasselbe Vorschaubild mehrfach als neues Medium entsteht.
* Das übernommene Bild ist ein gewöhnliches Medium (output_class bild) mit eigener Website-Freigabe.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('composition_still_sources', function (Blueprint $table) {
$table->id();
$table->foreignId('composition_id')->constrained('compositions')->cascadeOnDelete();
$table->foreignId('still_element_id')->constrained('content_elements')->cascadeOnDelete();
$table->string('source_key', 120);
$table->unsignedBigInteger('actor_id')->nullable();
$table->timestamps();
$table->unique(['composition_id', 'source_key']);
});
}
public function down(): void
{
Schema::dropIfExists('composition_still_sources');
}
};
@@ -0,0 +1,28 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Einstellungen der Website als Schlüssel-Wert-Paare (zuerst: Größenskala des Designsystems, Schlüssel „design.scale“).
* Rein ergänzend: Es wird keine Zeile angelegt. Ohne Zeile gelten die Standardwerte aus resources/css/tokens.css,
* ein Code-Rollback bleibt damit folgenlos.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('site_settings', function (Blueprint $table): void {
$table->string('key', 100)->primary();
$table->json('value');
$table->foreignId('updated_by')->nullable()->constrained('users')->nullOnDelete();
$table->timestamps();
});
}
public function down(): void
{
Schema::dropIfExists('site_settings');
}
};
@@ -0,0 +1,39 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Mitgliederprofil (ADR-46): neue E-Mail-Adresse wartet auf Bestätigung (pending_email) und Rechnungsadresse je Lizenzinhaber.
* Rein ergänzend: keine bestehende Spalte und Tabelle wird verändert; ein Code-Rollback ignoriert beides.
*/
return new class extends Migration
{
public function up(): void
{
Schema::table('users', function (Blueprint $table): void {
$table->string('pending_email')->nullable();
});
Schema::create('billing_addresses', function (Blueprint $table): void {
$table->id();
$table->foreignId('party_id')->unique()->constrained('parties')->cascadeOnDelete();
$table->string('recipient', 160);
$table->string('line2', 160)->nullable();
$table->string('street', 160);
$table->string('postal_code', 16);
$table->string('city', 120);
$table->string('country', 2)->default('DE');
$table->timestamps();
});
}
public function down(): void
{
Schema::dropIfExists('billing_addresses');
Schema::table('users', function (Blueprint $table): void {
$table->dropColumn('pending_email');
});
}
};
@@ -0,0 +1,123 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Verkaufsstart Deutschland (A1): nur ergänzend, nichts wird gelöscht oder umbenannt; ein Rollback des Codes lässt
* die neuen Spalten und Tabellen liegen (der frühere Code kennt sie nicht).
*
* - Rabattcodes mit Geltungsbereich (Warenkorb oder ausgewählte Ziele) und Einlösungsberechtigung (allgemein oder
* nur für freigeschaltete Konten). Freigaben werden nie gelöscht, nur entzogen.
* - Nutzerkreis der Lizenzoption (Einzel- oder Mehrfachlizenz, Zahl der Trainer) an der Angebotsfassung, kopiert in
* die Bestellposition. Lizenzinhaber, berechtigte Trainer und Downloadzugriff sind getrennte Angaben.
* - Rabatt, Zahlbetrag, Zahlungsweg und Zustimmungsnachweis an der Bestellung.
* - Ein eigenständig vermarktetes Paket hat eine eigene Produktseite (offers.standalone_bundle), die seinen Umfang zeigt.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('discount_codes', function (Blueprint $table) {
$table->id();
$table->string('code')->unique();
$table->string('label');
$table->string('kind', 12);
$table->unsignedTinyInteger('percent')->nullable();
$table->unsignedInteger('amount_cents')->nullable();
$table->string('scope', 12)->default('warenkorb');
$table->string('eligibility', 12)->default('allgemein');
$table->timestamp('valid_from')->nullable();
$table->timestamp('valid_until')->nullable();
$table->boolean('active')->default(true);
$table->text('note')->nullable();
$table->timestamps();
});
Schema::create('discount_code_targets', function (Blueprint $table) {
$table->id();
$table->foreignId('discount_code_id')->constrained('discount_codes')->cascadeOnDelete();
$table->string('target_type', 16);
$table->unsignedBigInteger('target_id');
$table->timestamps();
$table->unique(['discount_code_id', 'target_type', 'target_id']);
});
Schema::create('discount_code_releases', function (Blueprint $table) {
$table->id();
$table->foreignId('discount_code_id')->constrained('discount_codes')->cascadeOnDelete();
$table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
$table->foreignId('granted_by')->nullable()->constrained('users')->nullOnDelete();
$table->timestamp('granted_at');
$table->timestamp('valid_until')->nullable();
$table->foreignId('revoked_by')->nullable()->constrained('users')->nullOnDelete();
$table->timestamp('revoked_at')->nullable();
$table->text('reason')->nullable();
$table->timestamps();
$table->index(['discount_code_id', 'user_id']);
});
Schema::table('offers', function (Blueprint $table) {
$table->boolean('standalone_bundle')->default(false);
});
Schema::table('offer_versions', function (Blueprint $table) {
$table->string('licence_scope', 12)->nullable();
$table->unsignedSmallInteger('trainer_count')->nullable();
});
Schema::table('order_lines', function (Blueprint $table) {
$table->string('licence_scope', 12)->nullable();
$table->unsignedSmallInteger('trainer_count')->nullable();
$table->unsignedInteger('discount_cents')->default(0);
});
Schema::table('orders', function (Blueprint $table) {
$table->unsignedInteger('subtotal_cents')->nullable();
$table->unsignedInteger('discount_cents')->default(0);
$table->foreignId('discount_code_id')->nullable()->constrained('discount_codes')->nullOnDelete();
$table->json('discount_snapshot')->nullable();
$table->string('payment_method', 16)->nullable();
$table->timestamp('terms_accepted_at')->nullable();
$table->json('terms_snapshot')->nullable();
$table->timestamp('withdrawal_requested_at')->nullable();
$table->text('withdrawal_note')->nullable();
});
Schema::table('payments', function (Blueprint $table) {
$table->string('provider_payment_ref')->nullable();
$table->unsignedInteger('amount_cents')->nullable();
$table->foreignId('confirmed_by')->nullable()->constrained('users')->nullOnDelete();
});
}
public function down(): void
{
Schema::table('payments', function (Blueprint $table) {
$table->dropConstrainedForeignId('confirmed_by');
$table->dropColumn(['provider_payment_ref', 'amount_cents']);
});
Schema::table('orders', function (Blueprint $table) {
$table->dropConstrainedForeignId('discount_code_id');
$table->dropColumn([
'subtotal_cents', 'discount_cents', 'discount_snapshot', 'payment_method',
'terms_accepted_at', 'terms_snapshot', 'withdrawal_requested_at', 'withdrawal_note',
]);
});
Schema::table('order_lines', function (Blueprint $table) {
$table->dropColumn(['licence_scope', 'trainer_count', 'discount_cents']);
});
Schema::table('offer_versions', function (Blueprint $table) {
$table->dropColumn(['licence_scope', 'trainer_count']);
});
Schema::table('offers', function (Blueprint $table) {
$table->dropColumn('standalone_bundle');
});
Schema::dropIfExists('discount_code_releases');
Schema::dropIfExists('discount_code_targets');
Schema::dropIfExists('discount_codes');
}
};
+8 -5
View File
@@ -8,6 +8,7 @@
use App\Domain\Catalog\CompositionVersion;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -78,14 +79,14 @@ public function run(): void
'pdf' => ['ansehen', 'laden'],
]);
$this->offer($offers, 'Konflikte im Training: Privatlizenz', 'Privatlizenz', $konflikteVersion, [$konflikteArticle, $privat], 4900, 'person');
$this->offer($offers, 'Konflikte im Training: Vereinslizenz', 'Mehrfachlizenz für Vereine', $konflikteVersion, [$konflikteArticle, $verein], 14900, 'organisation');
$this->offer($offers, 'Grenzen setzen: Privatlizenz', 'Privatlizenz', $grenzenVersion, [$grenzenArticle, $privat], 2900, 'person');
$this->offer($offers, 'Konflikte im Training: Privatlizenz', 'Privatlizenz', $konflikteVersion, [$konflikteArticle, $privat], 4900, 'person', LicenceScope::SINGLE, 1);
$this->offer($offers, 'Konflikte im Training: Vereinslizenz', 'Mehrfachlizenz für Vereine', $konflikteVersion, [$konflikteArticle, $verein], 14900, 'organisation', LicenceScope::MULTI, 5);
$this->offer($offers, 'Grenzen setzen: Privatlizenz', 'Privatlizenz', $grenzenVersion, [$grenzenArticle, $privat], 2900, 'person', LicenceScope::SINGLE, 1);
$bundle = $bundles->create('Starterpaket');
$starter = $bundles->publish($bundle, [$konflikteArticle->fresh(), $grenzenArticle->fresh(), $starterArticle->fresh()]);
$paket = $offers->create('Starterpaket: Privatlizenz');
$offers->activate($paket, [['target' => $starter, 'rights' => $privat]], ['grant_kind' => 'kauf', 'price_cents' => 5900, 'holder_kind' => 'person']);
$offers->activate($paket, [['target' => $starter, 'rights' => $privat]], ['grant_kind' => 'kauf', 'price_cents' => 5900, 'holder_kind' => 'person', 'licence_scope' => LicenceScope::SINGLE, 'trainer_count' => 1]);
$offers->assignProduct($paket, $starterVersion->composition_id, 'Starterpaket (zwei Programme und Einführung)');
$tina = $this->account('Tina Trainerin', 'tina.trainerin@example.test');
@@ -160,13 +161,15 @@ private function program(
/**
* @param array{0: LicenseArticle, 1: RightsProfileVersion} $line
*/
private function offer(OfferService $offers, string $name, string $label, CompositionVersion $version, array $line, int $cents, string $holder): Offer
private function offer(OfferService $offers, string $name, string $label, CompositionVersion $version, array $line, int $cents, string $holder, ?string $scope = null, ?int $trainers = null): Offer
{
$offer = $offers->create($name);
$offers->activate($offer, [['target' => $line[0], 'rights' => $line[1]]], [
'grant_kind' => 'kauf',
'price_cents' => $cents,
'holder_kind' => $holder,
'licence_scope' => $scope,
'trainer_count' => $trainers,
]);
$offers->assignProduct($offer, $version->composition_id, $label);
+1
View File
@@ -32,5 +32,6 @@ MAIL_FROM_NAME="${APP_NAME}"
PAYMENT_DRIVER=test
# STRIPE_SECRET=sk_test_... (Entwickler > API-Schlüssel, Testmodus)
# STRIPE_WEBHOOK_SECRET=whsec_... (Entwickler > Webhooks > Endpunkt > Signiergeheimnis)
# STRIPE_TAX_RATE_ID=txr_... (optional: in Stripe angelegter, im Preis enthaltener Steuersatz)
# Medienpfade setzt Compose auf den Host-Mount (/srv/luf/<env>/media/...). Hier nichts eintragen.
+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 {
listen 80;
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.
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_body_timeout 3600s;
send_timeout 3600s;
@@ -0,0 +1,42 @@
# Programm- und Modulkarte: Textwahl und Bild, Filmbild-Regler – Bericht (21.11.2026)
Branch `feature/karten-text-und-bild-programm`, separater Worktree, Deploy ausschließlich über `develop` (Testinstanz), kein Merge nach `main`. Baut auf `medienkarte-text-und-filmbild-bericht-2026-11-21.md` auf. Technik: `medienzugriff-fuer-komponenten.md`, Registry §13, ADR-39.
## 1. Rückmeldung aus der Abnahme und Umsetzung
| Rückmeldung | Umsetzung |
|---|---|
| Der Bildwähler aus dem Film ist nicht gelungen; im Medienmanager gibt es einen Regler, der das Bild fast in Echtzeit zeigt | Der Dialog arbeitet jetzt wie der Medienmanager: Regler und Zahlenfeld zeigen dieselbe Zeitposition, das Bild der Stelle folgt dem Regler nach kurzer Pause (ohne weiteren Knopf), „Diese Stelle übernehmen“ legt genau die angezeigte Stelle ab. Das im Medienmanager gesetzte Vorschaubild des Films lässt sich mit kleiner Ansicht daneben übernehmen. Der Regler reicht bis 120 s und wächst mit dem Zahlenfeld (bis 7200 s). |
| Textwahl soll auch an der Programm- und Modulkarte gelten | „Text der Karte“: Automatisch (wie bisher: Teaser, sonst Kurzbeschreibung, sonst Lernziel), Teaser, Kurzbeschreibung, Ausführliche Beschreibung, **Lernziel der Fassung**. Gelesen mit der Zielgruppe „Öffentliche Kachel“. Eine ausdrückliche Wahl ersetzt nicht still; die Vorschau nennt „Programm oder Modul bearbeiten → …“. |
| Die übrigen Anpassungen auch für Programm und Modul | Das Vorschaubild des Programms oder Moduls lässt sich als Bild-Medium übernehmen („Vorschaubild übernehmen“, `CompositionStill`), einmal kopiert, dieselbe Datei ergibt dasselbe Medium, ehrliche Meldung auch bei zurückgenommener Freigabe. |
Die Themenkarte hat nur einen Text („Text für die Website“) und bekommt deshalb keine Wahl.
## 2. Prüfung
| Prüfung | Ergebnis |
|---|---|
| Testsuite, Pint | 459 grün, Pint sauber (neu: 6 Tests Programm- und Modulkarte; bewusst geändert: die Programmkarte hat jetzt eine Textwahl) |
| CI und Deploy | CI 4987, Deploy 4988 (Commit `3825f53`) |
| Oberfläche lokal, echter Test-Film | Filmkarte 19/19 (Regler bewegt, Bild folgt, Zahl und Regler gleich), Programmkarte 13/13 |
| Testinstanz, Filmkarte „Lara im Park“, regulärer Seitenkonfigurator | **23 von 23**: Regler und Bild sofort da, Bild folgt dem Regler, Zahleneingabe führt es nach, Stelle übernommen (1600 px), dieselbe Stelle ergibt dasselbe Medium, vier Textstufen entsprechen den gepflegten Feldern, interne Angaben nie sichtbar, Rücknahme der Freigabe verifiziert (404) |
| Testinstanz, Modul „UX-Pilot Entwurf“ (Kurzbeschreibung, Beschreibung, Lernziel, Vorschaubild) | **15 von 15**: Vorschaubild übernommen und wiederverwendet, Textwahl mit Lernziel, nicht gepflegter Teaser zeigt keinen Text, Karten nennen „Modul“, Entwurf öffentlich nicht erreichbar |
| Aufräumen auf der Testinstanz | die angelegten Bilder 27, 28, 29 über „Medium löschen“ entfernt, Herkunftszeilen mit gelöscht (Datenbank geprüft) |
| Bestehende Seiten vor und nach dem Deploy | unverändert (16 Messungen, 12 Textvergleiche) |
**Nicht live gezeigt:** die öffentliche Darstellung der Karten auf einer veröffentlichten Seite der Testinstanz (nur Entwürfe); die öffentlichen Regeln belegen die Feature-Tests.
## 3. Auf der Testinstanz zurückgeblieben
- Entwürfe `/medienkarte-regler-entwurf` (Seite 24) und `/programmkarte-regler-entwurf` (Seite 25) sowie ältere Prüfentwürfe. Seiten lassen sich nicht löschen.
- Das Standbild „Standbild: Felix beim Onkel (Fassung 1, 22,5 s)“ (Medium 26, freigegeben) stammt nicht von dieser Arbeit (angelegt 19:51, vermutlich bei der Abnahme); unangetastet.
## 4. Grenzen
- Das übernommene Programm-Vorschaubild hat die Größe der Vorschaudatei (640 px); für ein breites Kartenbild reicht das, für ein Hero nicht. Ein Film-Standbild kommt bis 1600 px aus der Mediendatei.
- Eine Filmstelle direkt für ein Programm zu wählen gibt es nicht; das Vorschaubild des Programms lässt sich im Redaktionsmanager aus einem Film setzen und dann übernehmen.
- Das übernommene Bild folgt späteren Änderungen am Vorschaubild nicht (eigenes Medium).
## 5. Prod
Die Vorbereitung des Merges `develop` → `main` (Inhalt, Migrationen, Prod-Stand, Entscheidungen) steht in `docs/betrieb/Release-Vorbereitung_2026-11-21.md`. Den Merge löst Lars in Gitea aus.
@@ -0,0 +1,262 @@
# Website-Designsystem: Analyse und Vorschlag einer kompakteren Größenskala
Stand: 22.11.2026. Phase 1 (Analyse und Abstimmung); am Berichtsstand wurde nichts am Code, an Inhalten oder an Daten geändert. **Umsetzung:** [ADR-44](../architektur/12_Entscheidungsprotokoll_ADR.md) und `docs/architektur/designsystem.md` §15 (Größenskala mit zehn einstellbaren Basiswerten). Abweichungen der Umsetzung vom Vorschlag: Basisabstand 8 px statt Raster 4 px, Abschnittsabstand 48 px, Bildhöhe in Bild und Text als feste Zielhöhe 320 px, Konfiguration in „Website → Design → Größen“.
## 0. Kurzfassung
**Befund.** Die Website ist nicht wegen eines einzelnen zu großen Widgets überdimensioniert, sondern weil drei Größensysteme nebeneinander laufen und alle auf einem großzügigen Maßstab aufsetzen:
1. die zentralen Tokens in `tokens.css` (Fließtext 18 px, H1 52 px, Abschnittsabstände bis 96 px, Kopfzeile 104 px),
2. die aus dem Brand-UI-Kit übernommenen Premium-Komponenten (`lf-hero`, `lf-bild-text`, `lf-premium-card`) mit eigenen `cqi`-, `rem`- und `px`-Werten, die die Tokens nicht verwenden,
3. feste Mindesthöhen und containerprozentuale Innenabstände (Hero 400/512/640 px, Bild-und-Text-Bild bis 424 px Höhe, Innenabstände bis 5 % der Containerbreite).
„Kompakt“ ist daher keine Skalierung des Ganzen, sondern an jeder Stelle etwas anderes (Mindesthöhe, Bildformat, Listenlayout, Abstandsstufe) und setzt auf dem großen Maßstab auf. Die Beobachtung, dass eine weitere Verkleinerung einzelner Widgets nicht trägt, bestätigt sich.
**Wichtigster Nebenbefund.** Der Container ist bei 1440 px nicht zu breit (1312 px, 91 % der Fensterbreite). Der Eindruck bei 67 % Zoom entsteht vertikal: Kopfzeile, Hero, Innenabstände und Abschnittsabstände sind in Summe so hoch, dass bei 1440 × 900 nach der Kopfzeile fast nur der Hero sichtbar ist (zweiter Abschnitt beginnt bei 750 von 900 px).
**Vorschlag.** Eine kompaktere Skala über die bestehenden Tokens, ohne neue Systeme und ohne Datenänderung:
- Fließtext 17 px statt 18 px (nie unter 16 px), Überschriften deutlich flacher, ein einziger neuer Token `--text-display` für den Seiteneinstieg,
- Abschnittsabstände etwa 30 % kleiner, Kopfzeile 80 px statt 104 px,
- Premium-Komponenten übernehmen die Schriftgrößen aus den Tokens (mit `cqi` nur als Obergrenze) und verwenden einheitliche Innenabstände und Mindesthöhen je Variante.
**Erwartung (Messung im Scratchpad-Prototyp, 1440 px, Referenzseite `/praevention-im-alltag`).** Seitenhöhe −17 % (2128 → 1759 px), Hero 512 → 384 px, Kopfzeile 104 → 80 px. Bei 390 px −9 %. Die Soll-Werte liegen damit bewusst zwischen 100 % und 67 % der heutigen Höhen (rund 75–85 %), der Fließtext nur bei rund 94 %.
**Offene Entscheidungen für Lars** stehen in Abschnitt 7. Die wichtigste: wie hoch das Bild in „Bild und Text“ bleiben darf (im Prototyp mit 358 px weiterhin das höchste Element der Seite).
---
## 1. Ist-Zustand: Wo werden Größen definiert?
| Ebene | Datei | Inhalt |
|---|---|---|
| Typografie-Tokens | `resources/css/tokens.css` | `--text-body` 17→18 px, `--text-lede` 18→21, `--text-h3` 20→22, `--text-h2` 26→34, `--text-h1` 34→52, `--leading-body` 1,6; `--text-small` 15 px |
| Abstände | `tokens.css` | `--space-1…9` (4–96 px); `--section-space-{compact,normal,large}` = 24→48 / 48→96 / 72→128 px; `--section-gap-*` 12→20 / 20→36 / 32→56 px; `--grid-gap` 20→36 px |
| Breiten | `tokens.css` | `--width-reading` 44 rem, `--width-standard` 82 rem (1312 px), `--width-wide` 96 rem; `--gutter` 16–40 px |
| Kopfzeile | `tokens.css`, `site.css` | 104 px Ausgangszustand ab 75 rem, 72 px kompakt; Logo 60 px, im Ausgangszustand `scale(1.32)` (≈ 79 px) |
| Abschnitte | `sections.css` | Innenabstand oben/unten aus den Stufen, Container `slot` und `section` |
| Grundkomponenten | `components.css` | `.button` erbt Fließtextgröße (18 px), Mindesthöhe 44 px; Karten, Formulare |
| Redaktionelle Karten, Katalogkarten, CTA, FAQ | `widgets.css` | eigene `clamp()`-Werte mit `cqi` für Titel, Innenabstände aus `--space-*` |
| Einstieg, Bild und Text, Premium-Karte | `components/lf-*.css` | aus dem Brand-UI-Kit v1.6/v1.7 übernommen; eigene `rem`-, `px`- und `cqi`-Werte, kaum Tokens |
| Mitgliederbereich | `app.css` (`body.member`) | nutzt die Tokens; **eigene feste Überschriften** (H1 34→52 px, H2 22→27 px) |
| Shop | `components/lf-shop.css` | nutzt `--text-body`, `--text-h3`, `--space-*` |
| Verwaltung | `resources/views/filament/*/styles.blade.php` | eigene `--vw-…`-Tokens, lädt `app.css` nicht |
Alle Werte sind in `rem`, `px` oder `cqi` angegeben (Wurzelgröße 100 %). Es gibt keine Variable, mit der sich die Gesamtdichte der Website steuern ließe.
## 2. Messgrundlage und Grenzen
Gemessen wurde in Edge (headless) an einer lokalen Kopie der Seiten `/`, `/praevention-im-alltag` und `/angebote` der Testinstanz bei 1440 × 900, 1920 × 1080, 768 × 1024 und 390 × 844 (mobil), außerdem als Näherung für 67 % Zoom bei 2149 × 1343 CSS-Pixeln.
**Grenzen (bitte beachten):**
- Das HTML wurde von der Testinstanz geladen. CSS wurde aus dem Repository (Stand `develop`, Commit `8b59946`) neu zusammengesetzt, **nicht** aus dem ausgelieferten Bundle. Dass beide übereinstimmen, ist nicht geprüft.
- Die Zertifikatsprüfung der Testinstanz schlug lokal fehl (falscher Zertifikatsname). Sie wurde nicht umgangen. Deshalb fehlen **echte Schriften, Bilder (graue Platzhalter), das Logo und JavaScript**.
- Berechnete Schriftgrößen, Innenabstände und Mindesthöhen sind davon unabhängig und belastbar. **Blockhöhen von Text, Seitenhöhen und die Navigation (im Messlauf stand bei 1440 px „Menü“ statt der Hauptnavigation) hängen von Schrift und JavaScript ab und sind nicht belastbar.** Ob die Navigation auf der echten Instanz bei 1440 px in den Menümodus fällt, ist in Phase 0 zu prüfen.
- Die Prozentwerte der Seitenhöhe sind Näherungen. Die Bildschirmfotos im Scratchpad sind keine Abnahmenachweise.
## 3. Ursachenanalyse
### 3.1 Systemische Ursachen
**S1 – Drei parallele Schriftskalen mit Umkehrungen.** Gemessen bei 1440 px:
| Ebene | Token-Skala | Komponenten-Skala |
|---|---|---|
| Seitentitel | H1 52 px | Einstieg 70,8–72,6 px (`5,4cqi`, Obergrenze 78 px) |
| Abschnittstitel | H2 34 px | Bild und Text 53,6 px (`4,5cqi`, Obergrenze 53,6 px), Handlungsaufruf 36 px |
| Kartentitel | H3 22 px | Premium-Karte 32 px, Katalogkarte bis 24 px |
Der Titel in „Bild und Text“ (Überschrift zweiter Ebene) ist mit 53,6 px größer als die Seiten-H1 (52 px). Der Kartentitel der Premium-Karte (32 px) liegt nahe an der H2 des Tokens (34 px). Die Hierarchie trägt nicht über Komponenten hinweg.
**S2 – Containerprozentuale Innenabstände vergrößern sich mit der Breite.** Einstieg `4,3cqi`/`5cqi` (bis 5 rem), Bild und Text `4cqi` (bis 4,5 rem), Handlungsaufruf `5cqi` (bis 3 rem). Bei 1312 px Containerbreite ergeben sich 52–66 px Innenabstand rundum. Das ist kein bewusster Wert, sondern ein Nebeneffekt der Breite.
**S3 – Höhe wird über Mindesthöhen und Bildseitenverhältnisse bestimmt, nicht über den Inhalt.**
- Einstieg: Mindesthöhe 25 / 32 / 40 rem (400 / 512 / 640 px). Auf `/praevention-im-alltag` ist der Einstieg (Markenfläche, normal) 512 px hoch, der Inhalt (Titel, Zeile, Schaltfläche) braucht etwa 300 px.
- Bild und Text, ab 900 px Containerbreite: Bild 4:3 bei 566 px Breite = 424 px Höhe. Das Bild, nicht der Text, bestimmt die Widgethöhe (529 px).
- Premium-Karte: Tafel 140/220 px Mindesthöhe, Bild bis `min(70vh, 640px)`.
**S4 – Chrome (Kopfzeile, Fuß) ist hoch.** Kopfzeile 104 px im Ausgangszustand (Logo-Skalierung 1,32), danach dauerhaft 72 px klebend (8 % von 900 px). Fußbereich 292 px (Fußlogo 72 px, Innenabstände bis 5 rem + 4,5 rem).
**S5 – Fließtext 18 px bei Zeilenhöhe 1,6.** Der Wert stammt aus dem Zielkonzept (§7.2, 17 → 18 px), ist zugänglich, aber für Source Sans 3 großzügig. Er wirkt auf alles, was `font: inherit` verwendet (Schaltfläche 18 px, Fußzeilenlinks, Mitgliederbereich).
**S6 – Keine gemeinsame Bedeutung von „kompakt“.** Im Code:
| Stelle | Was „kompakt“ bewirkt |
|---|---|
| Einstieg, Höhe | Mindesthöhe 400 statt 512 px, sonst nichts |
| Bild und Text, Höhe | Bild 3:2 statt 4:3, Abstände etwas enger (rechnerisch ≈ 450 statt 529 px) |
| Redaktionelle Karten, Katalogkarten | Layoutvariante „Liste“, keine Größenstufe |
| Abschnittsabstand | 24–48 px statt 48–96 px |
| Premium-Karte, Handlungsaufruf, Fließtext, Überschrift, FAQ | gar keine Größenstufe |
Das Höhenvokabular (`WidgetType::HEIGHTS`, ADR-38) ist einheitlich, die Umsetzung im CSS nicht. „Kompakt“ spart nur dort, wo eine Mindesthöhe gesetzt ist, und setzt dort auf dem großen Maßstab auf (Einstieg kompakt 400 px entspricht dem vorgeschlagenen „normal“ von 384 px).
### 3.2 Probleme einzelner Komponenten
- **Schaltflächen** haben vier Größen: global 18 px (Mindesthöhe 44 px), Einstieg 15,4 px (48 px), Bild und Text 14,2 px (47 px), Premium-Karte 15 px (44 px).
- **Einstieg:** Schlagzeile `5,4cqi` mit Obergrenze 4,9 rem; Beschreibung bis 20,8 px.
- **Bild und Text:** `min-block-size` 14 / 18 / 24 rem, Bild nimmt 49 % der Breite; `.lf-bt__body` hat eigene Schriftgröße (17,9 px) statt Token.
- **Premium-Karte:** Innenabstand `clamp(20px, 4.5cqi, 32px)`, ab 520 px `clamp(22px, 4cqi, 36px)`, Titel bis 32 px.
- **Katalogkarte:** Tafel `min-height` 7 rem (11 rem bei einer Karte).
- **Fußbereich:** `clamp()`-Innenabstände ohne Token.
### 3.3 Bewusst gestaltet und unbeabsichtigt
| Bewusst | Unbeabsichtigt |
|---|---|
| Markenfarben, Rundungen, gelbe Akzente, Schattenform | Containerprozentuale Innenabstände (S2) |
| Mindest-Trefferfläche 44 px | Bildhöhe aus Seitenverhältnis × Spaltenbreite (S3) |
| Lesebreite 70 ch, 82-rem-Raster | Kopfzeile 104 px aus Logo × 1,32 (S4) |
| Zwei Zustände der Kopfzeile ohne Layoutsprung | Abweichende Schaltflächengrößen, Titel größer als H1 (S1) |
### 3.4 Was zentral vereinheitlicht werden sollte
Schriftstufen für Titel (Display, H1–H3), Fließtext, Schaltflächen; Innenabstand von Flächen (Karte, Einstieg, Bild und Text, Handlungsaufruf); Mindesthöhen je Stufe (kompakt, normal, groß); Kopf- und Fußmaße.
## 4. Zielsystem
Leitlinie: Dichte wie bei etwa 75–85 % der heutigen Höhen, Fließtext bei rund 94 % (17 px), freundliche Proportionen bleiben. Nicht verlangt und nicht vorgesehen: `zoom`, `transform: scale()`, globale Prozentskalierung.
### 4.1 Tokens (Ist → Soll, jeweils Spanne bei Smartphone → Desktop)
| Token | Ist | Soll |
|---|---|---|
| `--text-small` | 15 px | 14 px |
| `--text-body` | 17 → 18 px | 16 → 17 px (`clamp(1rem, .97rem + .12vw, 1.0625rem)`) |
| `--leading-body` | 1,6 | 1,55 |
| `--text-lede` | 18 → 21 px | 17 → 19 px |
| `--text-h3` | 20 → 22 px | 18 → 20 px |
| `--text-h2` | 26 → 34 px | 22 → 28 px |
| `--text-h1` | 34 → 52 px | 28 → 40 px |
| `--text-display` (neu, nur Seiteneinstieg) | – (Einstieg 32 → 78 px) | 32 → 52 px |
| `--section-space-compact` | 24 → 48 px | 20 → 32 px |
| `--section-space-normal` | 48 → 96 px | 36 → 64 px |
| `--section-space-large` | 72 → 128 px | 52 → 88 px |
| `--section-gap-normal` / `--grid-gap` | 20 → 36 px | 16 → 28 px |
| Kopfzeile Ausgangszustand / kompakt (Desktop) | 104 / 72 px | 80 / 64 px |
| Logo Kopfzeile / Fuß | 60 px (×1,32) / 72 px | 44 px (×1,25) / 52 px (Anzeigegröße, kein neues Asset) |
Die Schlüssel der Abschnittsstufen (`compact`, `normal`, `large`) und aller Widget-Einstellungen bleiben unverändert; nur ihre Werte ändern sich.
### 4.2 Komponentenregeln (Soll)
Gemeinsame Regel: Schriftgrößen aus den Tokens, `cqi` nur als Obergrenze in engen Plätzen (`clamp(1.25rem, 6cqi, var(--text-h2))`). Damit bleibt die Anpassung an den Platz erhalten, ohne zweite Skala.
| Komponente | Ist | Soll |
|---|---|---|
| Einstieg, Titel | `5,4cqi`, bis 78 px | `clamp(1.9rem, 4cqi, var(--text-display))` |
| Einstieg, Mindesthöhe kompakt / normal / groß | 400 / 512 / 640 px | 288 / 384 / 512 px (nur ab 860 px Containerbreite) |
| Einstieg, Innenabstand | bis 5 rem | `clamp(1.25rem, 3.4cqi, 3.5rem)` |
| Bild und Text, Titel | bis 53,6 px | `clamp(1.4rem, 3.6cqi, var(--text-h2))` |
| Bild und Text, Bild ab 900 px (kompakt / normal / großzügig) | 3:2 / 4:3 / 1:1 | 16:9 / 3:2 / 4:3; Spaltenverhältnis 1,1 : 0,9 |
| Bild und Text, Innenabstand | bis 4,5 rem | `clamp(1.5rem, 3cqi, 3rem)` |
| Premium-Karte, Titel schmal / breit | bis 28 / 32 px | bis `--text-h3` / `--text-h2` (20 / 28 px) |
| Premium-Karte, Innenabstand, Tafel | 20–36 px; 140/220 px | 16–28 px; 112 px |
| Karten, Katalogkarten, Handlungsaufruf | Titel 22–24 / 36 px, Innenabstand 24 / 48 px | Titel `--text-h3` / `--text-h2`, Innenabstand 16–20 / 20–36 px |
| Schaltflächen (alle) | 18 / 15,4 / 14,2 / 15 px | 15 px, Mindesthöhe 44 px |
| Fußbereich | oben bis 5 rem, Grundzeile bis 4,5 rem | oben bis 3,5 rem, Grundzeile bis 3,5 rem |
### 4.3 Messung des Prototyps (Scratchpad, 1440 px und 390 px)
Die Regeln aus 4.1 und 4.2 wurden als Überschreibung auf die lokale Kopie gelegt (nicht im Repository). Seitenhöhen sind wegen fehlender Schriften nur Näherungen (siehe Abschnitt 2).
| Messgröße (`/praevention-im-alltag`) | Ist 1440 | Soll 1440 | Ist 390 | Soll 390 |
|---|---|---|---|---|
| Seitenhöhe | 2128 px | 1759 px (−17 %) | 1747 px | 1582 px (−9 %) |
| Fließtext | 18 px | 17 px | 17,1 px | 16 px |
| Titel Einstieg | 70,8 px | 52 px | 32 px | 30,4 px |
| Titel Bild und Text | 53,6 px | 28 px | 24,3 px | 22,4 px |
| Einstieg (Markenfläche, normal) | 512 px | 384 px | 303 px | 256 px |
| Bild und Text, gesamt | 529 px | 437 px | 459 px | 458 px |
| Bild und Text, Bild | 566 × 424 px | 537 × 358 px | 326 × 204 px | 326 × 204 px |
| Redaktionelle Karten (Liste) | 193 px | 184 px | 211 px | 201 px |
| Katalogkarten | 229 px | 222 px | 228 px | 182 px |
| Kopfzeile / Fußbereich | 104 / 292 px | 80 / 264 px | 64 / 339 px | 64 / 302 px |
| Schaltfläche (Einstieg) | 48 px, 15,4 px | 44 px, 15 px | 48 px | 44 px |
Startseite `/` bei 1440 px: Seitenhöhe 1662 → 1412 px (−15 %), Einstieg (Foto, kompakt) 400 → 288 px, Titel 72,6 → 52 px, Titel der Premium-Karte 32 → 28 px.
Smartphone profitiert weniger, weil die Komponenten dort bereits im Sicherheitsumbruch kompakt sind. Der Gewinn liegt auf Desktop und Tablet (768 px: −7 %).
Hinweis zur Methode: Ein erster Prototypenlauf hatte die Mindesthöhen des Einstiegs ohne Containerbedingung überschrieben und damit den Sicherheitsumbruch unter 860 px ausgehebelt (Einstieg wurde schmal höher statt niedriger). Die Zahlen oben stammen aus dem korrigierten Lauf. Diese Falle ist bei der Umsetzung zu beachten (Abschnitt 6).
## 5. Abgrenzung und Änderungsumfang
### 5.1 Wer nutzt welche Regeln?
| Bereich | Lädt `app.css` / Tokens? | Wirkung einer Tokenänderung |
|---|---|---|
| Öffentliche Website (Seiten, CMS-Widgets, Kopf, Fuß) | ja | beabsichtigt |
| Anmeldung, Mitgliederbereich, Shop, klassische `.sheet`-Seiten | ja (`layouts/member`, `layouts/site`) | **ändert sich mit**: Fließtext, `--text-h3`, Abstände, Schaltflächen, Formulare. `body.member h1/h2` sind fest codiert und folgen nicht |
| CMS-Vorschau in der Verwaltung (Iframes über `WidgetEditor::previewStylesheets()`: Seiteneditor, Kompositionen, Medienvorschau, Gerätevorschau) | ja, nur im Iframe | ändert sich **beabsichtigt** (Vorschau soll die Website zeigen); Abnahmebilder der Verwaltung mit Vorschau werden veraltet |
| Verwaltungsoberfläche (Filament) | nein: kein Filament-Theme, `app.js` importiert kein CSS, `AdminPanelProvider` bindet nur eigene Stile ein; Suche nach Website-Tokens (`--text-*`, `--space-*`, `--section-*` usw.) in `resources/views/filament` und `app/Filament` ohne Treffer | **keine Wirkung** |
Prüfung der Aussage zur Verwaltung: reine Codesuche, noch keine visuelle Prüfung. Sie gehört in Phase 0 und Phase 3.
### 5.2 Zu ändernde Dateien
CSS (Kern):
- `resources/css/tokens.css`: Typografie, Abschnittsabstände, Kopfzeile, ein neuer Token `--text-display`.
- `resources/css/site.css`: Logogröße, Skalierung, Fußbereich-Innenabstände.
- `resources/css/components.css`: Schaltflächengröße.
- `resources/css/widgets.css`: Titel und Innenabstände von Karten, Katalogkarten, Handlungsaufruf, FAQ.
- `resources/css/components/lf-hero.css`, `lf-bild-text.css`, `lf-premium-card.css`: Titel auf Tokens, Innenabstände, Mindesthöhen, Bildverhältnisse.
- `resources/css/app.css`: nur falls der Mitgliederbereich nachgeführt wird (Entscheidung E5).
- `resources/css/components/lf-shop.css`: voraussichtlich nur Sichtprüfung.
Nicht-CSS (leicht zu übersehen):
- `HeroWidget::heights()`: die Bezeichnungen enthalten Pixelwerte („Kompakt (mind. 400 px)“, „Normal (mind. 512 px)“, „Groß (mind. 640 px)“) und müssen mitgeändert werden; die Schlüssel `compact`, `normal`, `large` bleiben.
- Kommentare und Bezeichnungen in `ImageTextWidget`, `SectionStyle` (Verweis auf Tokens) und `hero.blade.php`.
- Dokumentation: `docs/architektur/designsystem.md` §5 (Skala) und §9 (dort steht noch „1,16-fach“ für die Logo-Skalierung, im Code 1,32), `docs/architektur/cms-widget-registry.md` §11 (Pixeltabelle der Abstände), Kopfkommentare der `lf-*.css`.
- Tests: Suche in `tests/` nach den genannten Bezeichnungen und nach Token-/Pixelwerten ohne Treffer (Stichwortsuche, nicht erschöpfend). Nach der Änderung `php artisan test` und Pint wie üblich.
**Keine Änderung** an Datenmodellen, gespeicherten Inhalten, Lizenz- oder Produktlogik und keine Migration: Abschnittsstufen und Widgethöhen sind Schlüssel, die im CSS auf Werte abgebildet werden.
### 5.3 Divergenz vom Brand-UI-Kit
`lf-hero`, `lf-bild-text` und `lf-premium-card` sind Übernahmen aus Kit v1.6/v1.7 mit dokumentierten Anpassungen. Die Änderung vergrößert die Abweichung vom Kit. Ob eine Kit-Ergänzung (z. B. `KIT_ERGAENZUNG_v1.8.md`) nachgeführt wird, ist Entscheidung E6.
## 6. Risiken
| Risiko | Einschätzung | Gegenmaßnahme |
|---|---|---|
| Mitgliederbereich, Shop, Anmeldung verändern sich mit | mittel; Fließtext schrumpft 18 → 17 px, feste H1/H2 des Mitgliederbereichs bleiben groß | Sichtprüfung dieser Seiten; Entscheidung E5 |
| Sicherheitsumbruch des Einstiegs unter 860 px wird ausgehebelt, wenn Mindesthöhen außerhalb der Containerbedingung stehen | hoch bei Fehlbedienung (im Prototyp aufgetreten) | Werte in `lf-hero.css` am Platz ändern, wo die Containerregel folgt; Prüfung bei 390, 768, 859, 860 px |
| Lange Titel, schmale Plätze | gering bis mittel | `cqi` als Untergrenze behalten; Prüfung mit langem Titel bei 390 px (Szenario T5 des Zielkonzepts) |
| Vorhandene Seiten mit gespeicherten Abstandsstufen wirken anders | gering, nur Werte ändern sich | Sichtprüfung aller veröffentlichten Seiten |
| Kontrast, Trefferflächen, Zoom | gering | Fließtext nie unter 16 px, Trefferflächen 44 px, Prüfung bei 200 % Zoom und 400 % Reflow, Textabstände nach WCAG 1.4.12 |
| Logo kleiner als im Ist | gering; Logo ist freigegeben, nur die Anzeigegröße ändert sich | Abstimmung E2, kein neues Asset |
| Abnahmebilder der Verwaltung mit Vorschau werden veraltet | gering | Hinweis in Abnahmedateien, bei Bedarf nachziehen |
| Messung weicht von echter Instanz ab | mittel (Abschnitt 2) | Phase 0 an `luf-test` mit echten Schriften |
## 7. Offene Entscheidungen für die fachliche Abstimmung
| Nr. | Frage | Empfehlung |
|---|---|---|
| E1 | Fließtext 17 px (Soll) oder 16 px? | 17 px; 16 px nur als Untergrenze auf Smartphone |
| E2 | Anzeigegröße des Logos und Kopfzeile 80 / 64 px | wie 4.1, nach Sichtprüfung |
| E3 | Maximale Titelgröße des Seiteneinstiegs (`--text-display`) 52 px oder 56 px | 52 px |
| E4 | Bild in „Bild und Text“: Höhe weiter begrenzen (Prototyp: 358 px, noch das höchste Element) oder Spalte schmaler (z. B. 0,8 fr)? | Entscheidung nach Sichtprüfung der Referenzseite; Text wird nie begrenzt |
| E5 | Soll der Mitgliederbereich den Tokens folgen (auch feste H1/H2) oder bis zu einer eigenen UX-Abnahme unverändert bleiben? | Tokens folgen lassen, feste Überschriften zunächst belassen; kein zweites Größensystem für `body.member` |
| E6 | Kit-Ergänzung nachführen? | ja, kurz, mit Verweis auf diesen Bericht |
| E7 | Vorgabe neuer Abschnitte: oben und unten „Kompakt“ (Soll 2 × 32 px = 64 px zwischen zwei Abschnitten statt 96 px) | beibehalten |
## 8. Umsetzungsplan
Arbeit auf `feature/website-groessenskala`, Merge nach `develop`. Kein Push auf `main`, kein manuelles Deployment.
**Phase 0 – Ausgangsmessung (kein Code).** An `luf-test` (nicht Prod) mit echten Schriften, Bildern und JavaScript Messung und Bildschirmfotos bei 100 % Zoom (1440, 768, 390) und als 67-%-Referenz. Navigation bei 1440 px prüfen (Menümodus?). Messskript im Repository oder unter `docs/analysen/` ablegen, damit es wiederholbar ist.
**Phase 1 – Tokens.** Nur `tokens.css` (und der eine neue Token), ohne Komponentenänderung. Messen. Wirkung auf Mitgliederbereich und Shop ansehen. Tests und Pint.
**Phase 2 – Referenzseite `/praevention-im-alltag`** (enthält Einstieg, Bild und Text, Karten, Katalogkarten; Startseite ergänzend wegen Premium-Karte und Handlungsaufruf). Komponenten in dieser Reihenfolge anpassen: Schaltflächen, Einstieg, Bild und Text, Karten, Katalogkarten, Handlungsaufruf, Kopf und Fuß. Nach jedem Schritt Messung bei 1440, 768, 390 sowie bei den Schwellen 859 / 860 / 899 / 900 px (Container-Abfragen). Prüfung bei 200 % Zoom, 400 % Reflow, Tastatur, Fokus, Kontrast.
**Phase 3 – Übertragen.** Premium-Karte (alle Varianten, Hoch- und Querformat, ohne Bild, mit Clip), Katalogseiten, FAQ, Überschrift, Prosa, `.sheet`-Seiten. Danach Mitgliederbereich, Shop, Anmeldung (Sichtprüfung, nur bei Befund anpassen). CMS-Vorschau in der Verwaltung ansehen; Verwaltungsoberfläche selbst bleibt unberührt (Gegenprüfung: Vorher-Nachher-Vergleich einer Verwaltungsseite).
**Phase 4 – Abschluss.** Namen und Pixelangaben in `HeroWidget::heights()` und Kommentaren, Dokumentation (`designsystem.md`, `cms-widget-registry.md`, Kit-Ergänzung), Bildschirmfotos unter `docs/analysen/…-screenshots/`, `php artisan test` und Pint, Merge nach `develop`. Visuelle Freigabe bei 100 % Zoom durch Lars, bevor `develop` → `main` (manueller Schritt von Lars) vorbereitet wird.
Größenordnung: Phase 1–2 klein (acht bis zehn CSS-Dateien, ein PHP-Label), Phase 3 überwiegend Prüfung.
+3 -1
View File
@@ -375,7 +375,9 @@ ### 5.1 Der Vertragsdatensatz: was zur Rekonstruktion des gekauften Angebots nö
**Nicht** Teil des Vertragsdatensatzes ist das Aussehen der damaligen Marketingseite. Seitenrevisionen des CMS sind eine Bearbeitungshilfe der Redaktion mit eigener, kürzerer Aufbewahrung; ihre pixelgenaue Wiederherstellung wird nicht zugesichert und nicht benötigt.
Der Warenkorb fasst die ausgewählten kaufbaren Angebote oder Optionen zusammen. Er reserviert keine Preise oder Lizenzkonditionen. Bei Bestellabschluss werden je Position die vereinbarte Angebotsfassung, der Preis, die Konditionen und der aufgelöste Lizenzumfang gespeichert. Eine Bestellung kann höchstens einen Rabattcode verwenden. Ein allgemeiner Code ist auf Warenkorbebene anwendbar, ein produktspezifischer Code nur auf berechtigte Positionen. Die Berechtigung für den Zertifizierungsrabatt kommt aus dem geprüften Kundenkonto. Nach der Bestellung bleibt der berechnete Zahlbetrag nachvollziehbar. Die Verteilung eines Bestellrabatts auf Positionen im Erstattungsfall ist noch festzulegen.
Der Warenkorb fasst die ausgewählten kaufbaren Angebote oder Optionen zusammen. Er reserviert keine Preise oder Lizenzkonditionen. Bei Bestellabschluss werden je Position die vereinbarte Angebotsfassung, der Preis, die Konditionen und der aufgelöste Lizenzumfang gespeichert. Eine Bestellung kann höchstens einen Rabattcode verwenden. Ein allgemeiner Code ist auf Warenkorbebene anwendbar, ein produktspezifischer Code nur auf berechtigte Positionen. Die Berechtigung für den Zertifizierungsrabatt kommt aus dem geprüften Kundenkonto. Nach der Bestellung bleibt der berechnete Zahlbetrag nachvollziehbar: Die Bestellung hält Zwischensumme, Rabatt, Zahlbetrag und einen Abzug des Codes fest, die Bestellposition Listenpreis und den auf sie entfallenden Rabatt. Geltungsbereich (Warenkorb oder ausgewählte Ziele: Angebot, Lizenzartikel, Paket) und Einlösungsberechtigung (allgemein oder freigeschaltete Konten) sind unabhängige Eigenschaften des Codes; Freigaben gelten je Code und Konto und werden nur entzogen, nie gelöscht (ADR-47). Die Verteilung eines Bestellrabatts auf Positionen im Erstattungsfall bei Einzelrückgabe ist noch festzulegen (Rechenbeispiel in ADR-47); zum Start gibt es nur Vollerstattungen.
Der **Nutzerkreis** der Lizenzoption (Einzellizenz = ein Trainer, Mehrfachlizenz = festgelegte Trainerzahl) gehört zur Angebotsfassung, wird in Bestellposition und Erwerb kopiert und ist getrennt von Lizenzinhaber, Nutzungszweck und Downloadkonto.
## 6. Stabile Identitäten im Überblick
@@ -239,7 +239,7 @@ ## 7. Überlappung, Entzug und Erstattung (LIC-005, SC-12)
Für den Start sind keine freiwilligen Teilerstattungen vorgesehen. Ein Bundle bildet eine Erwerbseinheit für die Rückgabe. Bei einer vollständigen Erstattung werden die betroffenen Erwerbe anhand der Bestellpositionen entzogen. Rechte aus anderen Erwerbsquellen werden weiter berücksichtigt. Extern ausgelöste Teilbeträge und rechtlich gebotene Sonderfälle laufen über die Betreiberprüfung in `07`, Ablauf 5.
Eine geprüfte Trainerzertifizierung am Konto kann für einen gemeinsamen Rabattcode qualifizieren. Berechtigte Konten können diesen Code bei weiteren Bestellungen wiederverwenden. Der Rabatt ändert den Zahlbetrag. Der erworbene Lizenzumfang ergibt sich aus der bestellten Angebotsoption.
Eine geprüfte Trainerzertifizierung am Konto kann für einen gemeinsamen Rabattcode qualifizieren. Berechtigte Konten können diesen Code bei weiteren Bestellungen wiederverwenden. Der Rabatt ändert den Zahlbetrag. Der erworbene Lizenzumfang ergibt sich aus der bestellten Angebotsoption. Die Berechtigung ist eine Freigabe des Kontos für genau diesen Code (nicht für andere Codes), vom Betreiber nach manueller Prüfung des Zertifikats erteilt und entziehbar; sie wird bei der Einlösung und unmittelbar vor Bestellabschluss geprüft (ADR-47).
## 8. Gezieltes Upgrade (LIC-007, LIC-012, SC-09)
@@ -287,7 +287,7 @@ ### 8.4 Verworfene Alternativen
## 9. Organisationen und Sitze (ID-003, SC-14)
**Vereinskauf zum Download-Start:** Einzel- und Mehrfachlizenz bestimmen den vertraglichen Nutzungsumfang. Eine Vereinslizenz gehört dem Verein. Die Berechtigung zum Download aus der Bestellung ist ausschließlich an das Mitgliederkonto gebunden, das die Bestellung ausgelöst hat. Bestellendes Konto und Lizenzinhaber werden im Kauf festgehalten. Die zentrale Rechteprüfung berücksichtigt bei Vereinskäufen diese ausdrückliche Kontobindung. Mehrfachlizenzen erzeugen zum Start keine weiteren Downloadkonten. Die nachstehende Sitzverwaltung beschreibt den möglichen Ausbau. Für den Online-Player ist offen, ob zugeordnete Trainerprofile verwendet werden oder das bestellende Profil autorisierte Streaming-Links erzeugt.
**Vereinskauf zum Download-Start:** Einzel- und Mehrfachlizenz bestimmen den vertraglichen Nutzungsumfang. Eine Vereinslizenz gehört dem Verein. Die Berechtigung zum Download aus der Bestellung ist ausschließlich an das Mitgliederkonto gebunden, das die Bestellung ausgelöst hat. Bestellendes Konto und Lizenzinhaber werden im Kauf festgehalten. Die zentrale Rechteprüfung berücksichtigt bei Vereinskäufen diese ausdrückliche Kontobindung. Mehrfachlizenzen erzeugen zum Start keine weiteren Downloadkonten. Der Nutzerkreis (Einzellizenz: ein Trainer; Mehrfachlizenz: festgelegte Trainerzahl) ist eine vertragliche Angabe der Lizenzoption und wird bei Kauf in Bestellposition und Erwerb festgehalten. Er wird weder aus dem Nutzungszweck noch aus Preis oder Rabattfreigabe abgeleitet; Lizenzinhaber, berechtigte Trainer und technischer Downloadzugriff bleiben getrennte Angaben. Die Trainerzahl ist zum Start rein vertraglich (Anzeige und Nachvollziehbarkeit), keine technische Sperre. Die nachstehende Sitzverwaltung beschreibt den möglichen Ausbau. Für den Online-Player ist offen, ob zugeordnete Trainerprofile verwendet werden oder das bestellende Profil autorisierte Streaming-Links erzeugt.
```text
weise_sitz_zu(pool, konto, ausführender):
+1 -1
View File
@@ -100,7 +100,7 @@ ## Ablauf 3 – Kauf mit Zahlungsbestätigung (PAY-002)
**Warenkorbzustände.** Die gewählten Optionen bleiben in derselben Browsersitzung über Anmeldung, Registrierung und E-Mail-Bestätigung hinweg erhalten. Je Option gibt es eine Position. Alternativoptionen derselben Angebotsgruppe werden nur nach ausdrücklichem Wechsel ersetzt. Ein bereits erworbener Umfang mit denselben Rechten für den vorgesehenen Lizenzinhaber bleibt mit dem Hinweis „Bereits erworben · Wird nicht mitbestellt“ sichtbar. Diese Position gehört nicht zur Kaufsumme und erzeugt keine Bestellposition. Der Käufer kann sie entfernen, die Bibliothek öffnen oder mit den übrigen Positionen fortfahren. Die Entscheidung wird beim Abschluss serverseitig erneut geprüft. Das Verhalten bei zurückgezogenen Angeboten richtet sich nach FACH-59.
**Rabatt.** Höchstens ein Code je Bestellung. Allgemeine Codes können den gesamten Warenkorb betreffen, produktspezifische nur die dazugehörigen Positionen. Für den gemeinsamen Zertifizierungscode prüft der Betreiber die angegebene Zertifizierung anhand der Liste und vermerkt die Berechtigung am Konto. Berechtigte Konten können den Code wiederholt bei späteren Bestellungen einlösen.
**Rabatt.** Höchstens ein Code je Bestellung. Allgemeine Codes können den gesamten Warenkorb betreffen, produktspezifische nur die dazugehörigen Positionen. Für den gemeinsamen Zertifizierungscode prüft der Betreiber die angegebene Zertifizierung anhand der Liste und vermerkt die Berechtigung am Konto. Berechtigte Konten können den Code wiederholt bei späteren Bestellungen einlösen. Im Checkout gibt der Käufer den Code ein und kann ihn entfernen; die Übersicht zeigt rabattierte Positionen, Rabattbetrag und endgültigen Zahlbetrag und erklärt, wenn der Code abgelaufen ist, keine Position passt oder für das Konto keine Freigabe vorliegt. Stripe erhält den Zahlbetrag nach Rabatt (ADR-47).
Entscheidende Punkte:
@@ -63,6 +63,10 @@ ## Übersicht der Architekturentscheidungen
| ADR-40 | Zentrale Medienverwaltung im CMS | Umgesetzt auf Test (19.11.2026); Abnahme offen | CMS-Bilder sind Medien des Medienmanagers (Kennung statt Pfad), öffentlich nur mit Website-Freigabe; frühere CMS-Bilder übernommen |
| ADR-41 | Gemeinsame Redaktionsbasis | Auf Test (19.11.2026, `develop` `f29ea58`); Betreiberabnahme offen. Technische Abbildung ist eine Arbeitsannahme, keine neue fachliche Freigabe | Klasse-A-Texte, Fachdimensionen und Präsentationsreferenzen an den bestehenden Fachobjekten; keine zweite Inhalts- oder Produktverwaltung |
| 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 |
| ADR-46 | Mitgliederprofil | Umgesetzt auf `develop` (23.11.2026); Abnahme offen | Name, E-Mail (mit Bestätigung der neuen Adresse), Passwort und Rechnungsadresse je Lizenzinhaber im Mitgliederbereich; Fußzeile mit Rechtlichem; Download-Dateiname aus dem Titel |
---
@@ -519,6 +523,7 @@ ## ADR-39 – Premium-Karten mit Fachbezug
**Alternativen.** Ein Widget mit mehreren Karten und eigenem Spannweitenraster (verworfen: zweites Kartenraster neben dem Abschnittsraster); eine Widget-Art mit Variante je Fachobjekt (verworfen: Verweisschema hinge von der Variante ab); redaktionell gepflegte Kartentexte (verworfen: Kopien von Fachdaten); Vorschaubilder der Bibliothek als Kartenbild (verworfen: geschützt, Paket 6).
**Nachbesserung (18.11.2026, nach Betreiberprüfung).** Themenkarten bieten alle Säulen an (nicht veröffentlichte nur für die Redaktionsvorschau). Medienkarten zeigen die Kurzbeschreibung des Mediums (auf ausdrücklichen Wunsch), unterscheiden Film (Filmtafel) und Material (Materialsymbol) und zeigen das geschützte Vorschaubild der Bibliothek nur in der Redaktionsvorschau. Traineranleitungen erscheinen nie öffentlich. Programm-/Modulkarten nutzen Lernziel und Dauer und lassen Programme/Module ohne Anzeigefreigabe für die Vorschau zu. Fehlende Inhalte erscheinen nur in der Vorschau als Hinweise.
**Nachbesserung 2 (21.11.2026, Betreiberwunsch).** Die Medienkarte wählt ihren Text je Karte (Automatisch, Teaser, Kurzbeschreibung, Ausführliche Beschreibung; `settings.text_source`). Die ausführliche Beschreibung ist damit auf ausdrückliche Wahl öffentlich (vorher nie). Ein Film liefert über `FilmStill` ein Einzelbild für die Karte: das Vorschaubild des Films oder eine gewählte Stelle, einmal gezogen (bis 1600 px) und als gewöhnliches Bild-Medium abgelegt, mit eigener Website-Freigabe; der Film bleibt geschützt. Additive Tabelle `film_still_sources`.
**Nachbesserung 3 (21.11.2026, nach Betreiberprüfung).** Der Bildwähler im Dialog arbeitet wie im Medienmanager (Regler, Zahlenfeld, Live-Bild). Die Textwahl gilt auch an der Programm- und Modulkarte (zusätzlich Lernziel); deren Vorschaubild lässt sich wie ein Filmbild als Bild-Medium übernehmen (`CompositionStill`, additive Tabelle `composition_still_sources`).
**Offene Entscheidungen.** (1) Freigabe von Vorschaubildern für die Website und öffentliche Filmvorschauen (minimaler Erweiterungsbedarf in `cms-widget-registry.md` §13). (2) Ob bei Traineranleitungen schon der Titel auf der Programmseite öffentlich sein soll (Programmseite, nicht Karte).
**Folgen und offene Prüfung.** Keine Migration; bestehende Seiten und Widgets unverändert (gemessen). Mit ADR-29 ersetzen öffentliche Profile die Übergangsregeln in `PublicCatalogReader` und `PublicMaterialReader`; die gespeicherten Karten ändern sich dadurch nicht. Offen: gestalterische Freigabe v1.7, freigegebene Motive statt Platzhaltern, eine kaufbare Angebotskarte (eigenes Fachobjekt „Angebot“ mit Umfang, Zweck und Lizenzbedingungen, nicht Teil dieser Karten).
**Quelle.** Brand-UI-Kit v1.7 (`docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf`, README, `docs/design-config.json`); `docs/architektur/cms-widget-registry.md` §§4, 6, 11, 13; ADR-29, ADR-30, ADR-38.
@@ -561,3 +566,92 @@ ## ADR-42 – Öffentliche Angebotsdarstellung und Mehrangebotswarenkorb
Die bestehende vorbelegte Angebotsmaske bleibt für Etappe 1 maßgeblich. Neue Fassungen werden ausdrücklich aktiviert. Abbrechen verwirft offene Eingaben. Im Warenkorb bleibt eine identisch bereits erworbene Lizenz gekennzeichnet und entfernbar. Sie geht weder in die Kaufsumme noch in die Bestellpositionen ein. Der ursprüngliche Erwerb bleibt der Nachweis.
Pro Bestellung gilt höchstens ein Rabattcode. Allgemeine und produktspezifische Geltung sowie ein mehrfach nutzbarer Zertifizierungscode für geprüfte Konten gehören zum Verkaufsumfang. Verkaufskreis ist Deutschland einschließlich Privatkunden, Vereinen und Organisationen. Der Startumfang enthält keine freiwilligen Teilerstattungen und behandelt Bundles bei Rückgabe als Einheit. Zahlungs- und Rechnungsregeln stehen in ADR-14 und ADR-21.
## ADR-43 – Trailer auf Karten
**Status am 21.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/karten-trailer`); Abnahme durch den Betreiber offen.
**Kontext.** FACH-46 fordert öffentliche Teaservideos; die Rollen Trailer und Vorschauclip gibt es im Medienmanager, ein freigegebener Clip wird über `website.media` ausgeliefert. Auf einer Karte war bisher nur ein Bild vorgesehen („kein Abspielen“, ADR-39). Die Grenze galt dem vollständigen Film und dem Bibliotheksmaterial, nicht einem für die Website bestimmten Trailer. Ein Trailer ist kein Lizenzelement; er braucht keine Lizenzentscheidung, nur die Website-Freigabe nach ADR-40.
**Entscheidung.**
- **Welche Karten:** Medien- und Materialkarte, Programm- und Modulkarte. Die Themenkarte hat keinen Trailer.
- **Welcher Clip:** der Trailer des Fachobjekts (Präsentationsrolle „Trailer“), sonst der Vorschauclip. Bei einem Film ersatzweise sein eigener für die Website freigegebener Teaser. Gewählt wird einmal in der Präsentation des Mediums, Programms oder Moduls; alle Karten desselben Objekts zeigen denselben Clip. Je Karte lässt sich der Trailer ausschalten (Darstellung → „Trailer auf der Karte“, Vorgabe: Abspielen).
- **Wann er läuft:** Am Desktop spielt er als stumme Vorschau in Schleife, solange die Maus auf der Karte steht, und endet beim Verlassen (ein Überfahren ist für Browser keine Bedienung und darf keinen Ton starten). Ein Tipp oder Klick auf das Bild oder auf die Schaltfläche startet ihn **mit Ton**, einmal ohne Schleife; während der stummen Vorschau schaltet derselbe Tipp den Ton zu, und ein weiterer hält an. Die Schaltfläche ist nur ein kleines Symbol (30 px sichtbar, 44 px Trefferfläche, Beschriftung nur für Hilfstechnik), weil die Art-Marke „Film“ schon am Bild steht; sie bedient auch die Tastatur (`aria-pressed`). Es spielt nie mehr als ein Clip zugleich; er hält an, wenn die Karte aus dem Bild scrollt oder die Seite verdeckt wird.
- **Rücksicht:** Bei „reduzierte Bewegung“ und im Datensparmodus startet nichts von selbst, nur auf ausdrückliche Bedienung und dann ohne Schleife. Der Clip wird erst beim ersten Start geladen (`preload="none"`, Quelle erst dann gesetzt). Ohne JavaScript bleibt es beim Kartenbild.
- **Rechte:** Es spielt nur ein für die Website freigegebener Clip. Der vollständige Film, die Originaldatei und nicht freigegebene Clips kommen nie über eine Karte, auch nicht in der Redaktionsvorschau; diese nennt stattdessen, dass der Trailer nicht freigegeben ist. Die Karte gibt nichts frei und bietet keinen Download. Die Karte einer Traineranleitung erscheint weiter öffentlich nie.
- **Auslieferung:** Die Route `website.media` beantwortet Bereichsabrufe (`Range`, Antwort 206/416) für Filme und Hörstücke. Safari und iOS spielen sonst nicht ab.
**Alternativen.** Clip je Karte frei wählen (verworfen: mehrere Wege, doppelte Pflege); Autoplay mit Ton oder ohne Bedienung (verworfen: Barrierefreiheit, Datenvolumen); Clip aus dem vollständigen Film erzeugen (verworfen: Rechte, kein freigegebener Clip).
**Folgen.** Neue Einstellung `clip` an der Medien-, Programm- und Modulkarte, Klasse `CardClip`, Skript `resources/js/card-clip.js`; keine Migration. Bereits gespeicherte Karten ohne Wahl spielen einen freigegebenen Trailer ab (Vorgabe Abspielen). Ein eigener Lautstärkeregler ist nicht vorgesehen; Ton gibt es nur nach Bedienung.
**Nachtrag Hero (22.11.2026).** Das Hero-Widget (Variante „Foto mit Textfläche“) kann ein Video zeigen: optionale Auswahl `refs.video` (ein Film aus dem Medienmanager, Klasse `HeroVideo`, Skript `resources/js/hero-video.js`). Der Clip folgt derselben Regel wie auf der Karte (Trailer, sonst Vorschauclip, sonst die freigegebene Website-Datei des Films; nie der vollständige Film, nie ein nicht freigegebener Clip). Er läuft stumm auf der Fläche des Fotos und startet nach dem Laden der Seite von selbst, sobald der Einstieg im Bild ist; das Foto bleibt darunter, bis das erste Videobild da ist, und ist der Rückfall bei Fehlern. Eine Schaltfläche „Video“ hält an und spielt ab (WCAG 2.2.2). Bei „reduzierte Bewegung“, im Datensparmodus und bei 2G startet nichts von selbst, nur auf Bedienung und ohne Schleife. Er hält an, wenn der Einstieg aus dem Bild scrollt, und läuft nur weiter, wenn er von selbst lief und nicht angehalten wurde. In der Markenfläche (`editorial_solid`) gibt es kein Video. Neuer Schlüssel ohne Versionssprung, keine Migration. Hinweis „Mit Ton starten“ und Video als Seitenhintergrund bleiben ausgeschlossen.
**Quelle.** `docs/ux/verwaltung/04-fachliche-anforderungen.md` FACH-46; `medienzugriff-fuer-komponenten.md`; `cms-widget-registry.md`; ADR-39, ADR-40, ADR-41.
## ADR-44 – Gemeinsame, konfigurierbare Größenskala
**Status am 22.11.2026:** Umgesetzt auf `develop` (Branch `feature/design-groessen`); Abnahme durch den Betreiber offen. Konkretisiert ADR-36 (gemeinsames Designsystem) für Maße und ersetzt dort die Aussage „frei pflegbare Werte im CMS“ als verworfene Alternative durch eine bewusst kleine, begrenzte Konfiguration.
**Kontext.** Die Analyse vom 22.11.2026 (`docs/analysen/website-groessenskala-analyse-2026-11-22.md`) fand drei parallele Größensysteme: die Tokens in `tokens.css`, die aus dem Brand-UI-Kit übernommenen Komponenten (`lf-hero`, `lf-bild-text`, `lf-premium-card`) mit eigenen `cqi`-, `rem`- und `px`-Werten sowie feste Mindesthöhen und containerprozentuale Innenabstände. Folge: Titel in Komponenten größer als die Seiten-H1, vier Schaltflächengrößen, Einstieg und Bild und Text bestimmten ihre Höhe über Mindesthöhe und Bildformat. „Kompakt“ setzte überall auf einem großen Maßstab auf. Website und Mitgliederbereich sollen langfristig ein einheitliches Erscheinungsbild haben, bei unterschiedlichen Layouts und Dichten.
**Entscheidung.**
- **Zehn Basiswerte** (Pixel als ganze Zahl, mit Wertebereich): Fließtext 17, Überschrift 1 40, Überschrift 2 28, Display-Überschrift (Höchstwert) 52, Basisabstand 8, Abschnittsabstand (Desktop) 48, Karten-Innenabstand 20, Höhe der Kopfzeile 80, maximale Inhaltsbreite 1312, Bildhöhe in Bild und Text (Desktop) 320. Alles Weitere wird abgeleitet und ist nicht einzeln einstellbar.
- **Eine Quelle für die Ableitung:** `resources/css/tokens.css` (Block „Größenskala“) enthält die Standardwerte (`--ds-*`) und alle Ableitungsregeln (`calc`/`clamp`, in rem, damit die Textgröße des Browsers wirkt). Die Komponenten verwenden ausschließlich die abgeleiteten Tokens (`--text-*`, `--space-*`, `--pad-card`, `--pad-surface`, `--section-*`, `--media-h`, `--dens`); `cqi` dient nur noch als Obergrenze in engen Plätzen. Es gibt kein zweites Größensystem. Die Standardwerte stehen zusätzlich in `App\Domain\Design\DesignScale`; ein Test hält beide gleich.
- **Dichtestufen:** Die gespeicherten Schlüssel der Größenvarianten bleiben (`compact`, `normal`, `large`, `spacious`). `--dens` bildet sie einheitlich ab: kompakt 0,75, standard 1, großzügig 1,3. Bei Einstieg und Bild und Text bestimmt sie Bildhöhe, Mindesthöhe, Abstand und Innenabstand. Nur die Bezeichnungen ändern sich (Kompakt, Standard, Großzügig), ohne Pixelangaben; keine Datenänderung, keine Migration der Inhalte.
- **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 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.
**Quelle.** Analysebericht vom 22.11.2026; Designprinzipien §§5, 9, 11–13; ADR-36, ADR-38, ADR-39; `designsystem.md` §15.
## 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.
## ADR-46 – Mitgliederprofil, Fußzeile und Dateiname
**Status am 23.11.2026:** Umgesetzt auf `develop` (Branch `feature/mitglieder-nachbesserung`); Abnahme offen. Ergänzt ADR-45 nach der ersten Sichtung auf luf-test.
**Kontext.** Das Profil bot nur den Namen. Mitglieder brauchen Adresse, Passwort und Rechnungsadresse selbst; Impressum und Datenschutz fehlten im Mitgliederbereich; Downloads hießen nach der Adresse („laden.mp4“).
**Entscheidung.**
- **Profil in vier Blöcken** mit je eigener Speicherhandlung und eigenen Fehlern (`App\Http\Controllers\Member\ProfileController`). **E-Mail:** Die neue Adresse wird als `users.pending_email` vorgemerkt und gilt erst, wenn ein signierter Link (60 Minuten) an die neue Adresse geöffnet wird; die bisherige Adresse erhält einen Hinweis; verlangt wird das aktuelle Passwort; der Link gilt nur für das eigene Konto und die vorgemerkte Adresse. **Passwort:** bisheriges Passwort, Regeln wie bei der Registrierung, neues muss abweichen. **Rechnungsadresse:** Tabelle `billing_addresses`, eine je Lizenzinhaber (Party), gepflegt, aber noch nicht in Bestellungen kopiert. Beide Migrationen sind rein ergänzend (Rollback-sicher).
- **Fußzeile** `x-member.footer`: Links aus der CMS-Navigation (Plätze Rechtliches und Kontakt), ersatzweise die veröffentlichten Seiten `/impressum` und `/datenschutz`; keine fest codierten Texte.
- **Dateiname** von Download und Ansicht aus dem Anzeigetitel des Mediums plus Dateiendung; ein eigenes Feld im Medienmanager ist nicht beschlossen.
- **Player:** Der Anfangsscan von `app.js` bindet auch im Quelltext stehende HLS-Videos an hls.js an (bisher übersprungen, weil `document` kein `Element` ist).
- **Einzel-/Mehrfachlizenz:** zum Zeitpunkt dieser Entscheidung nicht vorhanden; seit ADR-47 gibt es den Nutzerkreis je Lizenzoption.
**Alternativen.** E-Mail sofort ändern (verworfen: Tippfehler sperrt das Konto aus, Kontoübernahme ohne Gegenprobe); Adresse als Freitext am Konto (verworfen: Rechnungsadresse gehört zum Lizenzinhaber, auch für Organisationen); Fußzeile des Website-Gerüsts übernehmen (verworfen: zu groß für die Arbeitsoberfläche).
**Folgen.** Rechnungsstellung und Bestellübersicht müssen die Adresse später in die Bestellung kopieren (Stand zum Kaufzeitpunkt). Pflege der Rechtsseiten bleibt Aufgabe der Redaktion im CMS.
**Quelle.** Rückmeldung des Betreibers vom 23.11.2026; ADR-45; `05_Lizenz_und_Berechtigungslogik.md` §9.
## ADR-47 – Rabattcodes, Nutzerkreis der Lizenzoption und Verkaufsstart-Vorbereitung
**Status am 24.11.2026:** Umgesetzt auf `feature/shop-rabatt-lizenz` (Abnahme siehe `docs/ux/verwaltung/abnahme/etappe-1.md`, Abschnitt „Verkaufsstart-Etappe“). Die Produktivfreigabe ist **nicht** erteilt und bleibt bei Lars.
**Kontext.** PAY-006 bis PAY-009 und ID-004 legen den Verkaufsstart fest; Rabattcodes, Einzel-/Mehrfachlizenz und die Pflichtangaben im Bestellablauf fehlten. Aus Etappe 1 waren drei Download-Befunde und die Frage nach der Produktseite eines Pakets offen.
**Bestätigt durch den Auftrag von Lars (21.11. bis 24.11.2026).**
- **Rabattcode, zwei voneinander unabhängige Einstellungen.** Geltungsbereich: gesamter Warenkorb oder ausdrücklich gewählte Lizenzartikel, Angebote oder Pakete. Ein Paket ist ein eigenes Ziel; seine Rabattfähigkeit folgt nie aus einem enthaltenen Artikel (und umgekehrt). Einlösungsberechtigung: allgemein oder nur für ausdrücklich freigeschaltete Konten. Freigaben gelten je Code und Konto (Freigabe für X ist keine für Y), werden nie gelöscht, nur entzogen. Pro Bestellung höchstens ein Code. Der Rabatt ändert den Preis, nie den Nutzungsumfang.
- **Prüfung** bei Eingabe, in jeder Übersicht und unter Sperre unmittelbar vor Bestellabschluss; die Prüfsumme der Übersicht enthält Code, Zustand und Rabatt je Position, ein zwischenzeitlich entzogener Code ergibt `StaleOverview` statt einer Bestellung zum falschen Preis. Ein vorgemerkter, aber nicht mehr gültiger Code hält die Bestellung an, bis er entfernt wird.
- **Nutzerkreis je Lizenzoption** (`offer_versions.licence_scope`, `trainer_count`): Einzellizenz = ein Trainer, Mehrfachlizenz = festgelegte Zahl (2 bis 999). Er wird weder aus dem Nutzungszweck (ehrenamtlich, kommerziell, institutionell) noch aus Preis oder Rabattfreigabe abgeleitet. Lizenzinhaber, berechtigte Trainer und technischer Downloadzugriff sind getrennte Angaben; beim Vereinskauf bleibt der Verein Lizenzinhaber und nur das bestellende Konto lädt herunter. Der Wert wird in Bestellposition und Erwerb (Bedingungen) kopiert und gehört zur Prüfung „Bereits erworben“ (eine Einzellizenz deckt keine Mehrfachlizenz ab). Ältere Fassungen und Bestellungen zeigen „Nutzerkreis nicht festgelegt“, es gibt keine Rückfüllung. Zusätzliche Trainerkonten und Sitzzuweisungen bleiben A4.
- **Ein Angebot ohne verkaufbaren Inhalt** (Artikel ohne veröffentlichten Stand) lässt sich im Domänenmodell (`OfferService::activate`) nicht aktivieren, nicht nur in der Maske.
- **Ein eigenständig vermarktetes Paket** erhält eine eigene Produktseite `/pakete/{id}` mit seinem tatsächlichen Umfang (`offers.standalone_bundle`), eine Kachel im Shop und die Suche über die enthaltenen Artikel.
**Von mir gewählt, bitte bestätigen.**
- **Rechenregel:** Prozent je Position kaufmännisch gerundet; Festbetrag je Bestellung, höchstens bis zur Summe der betroffenen Positionen, anteilig zum Positionspreis verteilt (größter Rest zuerst). Gespeichert werden Listenpreis und Rabatt je Position, Zwischensumme, Rabatt, Zahlbetrag und ein Abzug des Codes zum Bestellzeitpunkt. Stripe erhält je Position den Preis nach Rabatt, damit der Betrag bei Stripe dem gespeicherten Zahlbetrag entspricht.
- **Mindestzahlbetrag 0,50 €** mit Rabatt (Mindestbetrag der Kartenzahlung); ein 100-Prozent-Code ist beim Start nicht möglich.
- **Freigabe mit optionalem Ende** („solange … Freigabe gültig“); Pflege durch Katalogverwalter und Kundenbetreuung.
- **Kauf auf Rechnung** für Organisationen: Bestellung mit Zahlungsweg „Rechnung“, Betreiber erstellt die Rechnung manuell und bestätigt den Zahlungseingang in der Bestellverwaltung; erst danach Freischaltung. Mitglieder können das nicht selbst auslösen.
- **Widerruf:** Das Mitglied erklärt ihn (Datum, Anmerkung); die Erklärung entzieht nichts. Der Betreiber prüft (bei sofortiger Bereitstellung mit ausdrücklicher Zustimmung kann das Recht erloschen sein) und erstattet in der Bestellverwaltung vollständig; bei Stripe wird zuerst die Rückzahlung bei Stripe veranlasst, erst bei Erfolg werden Rechte entzogen. Die Selbstbedienungs-Erstattung gibt es nur im Testzahlungsweg.
- **Pflichtangaben:** Schaltfläche „Zahlungspflichtig bestellen“, zwei Zustimmungen (AGB und Lizenzbedingungen; ausdrücklicher Wunsch nach sofortiger Bereitstellung mit Hinweis auf das Erlöschen des Widerrufsrechts) als Pflichtfelder, serverseitig geprüft und mit Wortlaut, Fassung (`SalesTerms::VERSION`) und Seitenständen an der Bestellung festgehalten; Vertragsbestätigung per Mail mit Nutzerkreis, Rabatt und Zustimmung. **Der Wortlaut ist ein Entwurf und rechtlich nicht geprüft.**
- **Produktivfreigabe** nur mit `SHOP_LIVE_RELEASE=true` in `/etc/luf/prod.env`, Zahlungstreiber `stripe`, Live-Schlüssel und veröffentlichten Rechtstexten (`Shop::live()`); standardmäßig aus. Ohne sie bleibt der Shop in Produktion abgeschaltet und Stripe lehnt dort jeden Aufruf ab. Außerhalb der Produktion bleiben Live-Schlüssel verboten.
**Offene Fachfrage mit Rechenbeispiel (nicht entschieden, siehe auch `13_Risiken_Annahmen_offene_Entscheidungen.md`).**
1. *Rundung.* Drei Positionen zu je 0,99 €, Code 50 %. Je Position gerundet: 3 × 0,50 € = 1,50 € Rabatt, Zahlbetrag 1,47 €. Auf der Warenkorbsumme gerundet: 2,97 € × 50 % = 1,485 € → 1,49 € Rabatt, Zahlbetrag 1,48 €. Heute gilt die Rundung je Position. Welche gilt rechtlich und buchhalterisch?
2. *Verteilung eines Warenkorbrabatts bei späterer Einzelrückgabe.* Warenkorb Position A 60,00 € und B 40,00 €, Festbetrag 10,00 € (Zahlbetrag 90,00 €). Heute verteilt das System anteilig (A 6,00 €, B 4,00 €). Gäbe der Käufer später nur B zurück: Erstattung 36,00 € (anteilig), 40,00 € (voller Listenpreis, der Rabatt bliebe auf A) oder 30,00 € (B trägt den Rabatt zuerst ab)? Zum Start gibt es nur die Vollerstattung der Bestellung (90,00 €) und Bundles als Einheit; die Frage wird mit freiwilligen Teilerstattungen (A2) relevant. Die Daten (Rabatt je Position) liegen vor.
3. *Rabatt und Steuer.* Wie der Rabatt in der Rechnung auf Steuersätze verteilt wird, hängt am Steuerstatus (OPEN-06).
**Folgen.** Neue Tabellen und Spalten sind rein ergänzend; bei einem Code-Rollback bleiben sie liegen. **Vor einem Rollback offene Bestellungen mit Rabatt oder Rechnungsweg prüfen**: der alte Code kennt den Rabatt nicht und würde den Listenpreis gegen den Zahlbetrag prüfen.
**Quelle.** Auftrag „Shop bis zum Verkaufsstart in Deutschland“; PAY-006 bis PAY-009, ID-004, FACH-14, FACH-59; ADR-42, ADR-45, ADR-46.
@@ -123,7 +123,7 @@ ## 4. Offene fachliche Entscheidungen
| E-23 | Organisationskauf | Verkauf an Organisationen gehört zum bestätigten Käuferkreis. Vor dem ersten Verkauf vorbereiten, welche Angebote einer Organisation als Inhaberin zugewiesen werden und welche Verwaltung dafür benötigt wird. | Erwerb für Organisation mit Sitzpool, falls das Angebot Sitze umfasst | vor dem ersten Organisationsverkauf |
| E-24 | Community-Produkt und Betriebsform (selbst betrieben oder gehostet) | `10`, Abschnitt 4 | ADR-12 | vor A3, nach dem kleinen Nachweis aus `10`, Abschnitt 11 Nr. 2 |
**Vor dem Verkaufsstart zu klären:** Steuer- und Belegdetails (OPEN-06), Bedingungen und Preise der Startangebote (OPEN-03), der konkrete Widerrufsprozess (E-11) und Wiederherstellungsziele (E-22). Rabattformeln und die Verteilung etwaiger Bestellrabatte auf Positionen sind zu konkretisieren. Der Käuferkreis (E-09) ist entschieden.
**Vor dem Verkaufsstart zu klären:** Steuer- und Belegdetails (OPEN-06), Bedingungen und Preise der Startangebote (OPEN-03), der konkrete Widerrufsprozess (E-11) und Wiederherstellungsziele (E-22). Rabattformeln und die Verteilung etwaiger Bestellrabatte auf Positionen sind zu konkretisieren (umgesetzte Regel und Rechenbeispiele zur Entscheidung: ADR-47). Der Käuferkreis (E-09) ist entschieden.
## 5. Wie weit trägt die technische Planung ohne die Geschäftsentscheidungen?
+2 -1
View File
@@ -225,7 +225,8 @@ ### Shop-Abnahme
| Identische Lizenz bereits erworben | Hinweis und Entfernen bleiben sichtbar. Die Position fehlt in Kaufsumme und Bestellung. Der Rest ist weiterhin kaufbar. Ein Bundle mit zusätzlichem Inhalt bleibt kaufbar und wird als Einheit behandelt. | Testkauf |
| Testzahlung scheitert, wird abgebrochen oder wiederholt bestätigt | Ohne bestätigte Zahlung keine Auslieferung. Nach erfolgreicher Bestätigung entstehen Rechte für alle Bestellpositionen, genau einmal je Erwerbsquelle. | Testkauf |
| Lizenzoption im bestehenden Arbeitsplatz bearbeiten | Maske ist vorbelegt, Preis erscheint in Euro, Abbrechen verwirft Eingaben. Bei Aktivierung wirkt die Änderung für diese Option. Andere Optionen bleiben kaufbar. | Testkauf |
| Allgemeiner oder produktspezifischer Rabattcode | Ein Code je Bestellung; nur passender Geltungsbereich; berechtigtes Konto kann gemeinsamen Zertifizierungscode erneut verwenden | Verkaufsstart |
| Allgemeiner oder produktspezifischer Rabattcode | Ein Code je Bestellung; nur passender Geltungsbereich; berechtigtes Konto kann gemeinsamen Zertifizierungscode erneut verwenden. Wer den Code kennt, aber keine Freigabe für genau diesen Code hat, erhält keinen Rabatt. Prüfung bei Einlösung und vor Bestellabschluss, Zahlbetrag in Bestellung und bei Stripe gleich. (umgesetzt, ADR-47; Abnahme in `etappe-1.md`) | Verkaufsstart |
| Einzel- und Mehrfachlizenz unterscheiden | Nutzerkreis (ein Trainer oder festgelegte Zahl) auf Produktseite und in der Bestellung; mit den Konditionen gespeichert; unabhängig von Zweck, Preis, Lizenzinhaber und Downloadkonto (umgesetzt, ADR-47) | Verkaufsstart |
| Vereinsrechnung bezahlen | Rechte bis zur bestätigten Überweisung gesperrt, danach Vergabe aus Bestellung | Verkaufsstart |
| Vereins-Mehrfachlizenz erwerben | Verein als Lizenzinhaber und bestellendes Profil getrennt festgehalten. Nur dieses Profil erhält nach Testzahlung Downloadzugriff aus der Bestellung. Mit einem zweiten Konto desselben Vereins ist auch der direkte Abruf aus dieser Bestellung nicht möglich. | Testkauf |
| Vollerstattung und Bundle-Rückgabe | Rechte der betroffenen Erwerbe entzogen; andere Quellen weiterhin wirksam; Bundle als Einheit | Verkaufsstart |
+20 -12
View File
@@ -70,10 +70,10 @@ ## 4. Registrierte Widget-Arten
| Kennung | Name | Version | Varianten | Breiten (Einheiten) | Höhen | Verweise |
|---|---|---|---|---|---|---|
| `hero` | Einstieg (Hero), Premium nach Kit v1.6 | 2 | `photo_split` (Foto mit Textfläche), `editorial_solid` (Navy-Markenfläche) | 3, 4 | `compact` (mind. 400 px), `normal` (512 px, Vorgabe), `large` (640 px) | `refs.image` |
| `hero` | Einstieg (Hero), Premium nach Kit v1.6 | 2 | `photo_split` (Foto mit Textfläche), `editorial_solid` (Navy-Markenfläche) | 3, 4 | `compact` (Kompakt), `normal` (Standard, Vorgabe), `large` (Großzügig); Mindesthöhe aus der Größenskala (ADR-44) | `refs.image`, `refs.video` (optional) |
| `heading` | Überschrift und Einleitung | 1 | `standard` | 1–4 | – | – |
| `prose` | Fließtext | 1 | `standard` | 1–4 | – | – |
| `image_text` | Bild und Text, Premium nach Kit v1.6 | 3 | `image_left`, `image_right` (Bildseite) | 1–4 | `compact`, `normal` (Vorgabe), `spacious` | `refs.image` |
| `image_text` | Bild und Text, Premium nach Kit v1.6 | 3 | `image_left`, `image_right` (Bildseite) | 1–4 | `compact` (Kompakt), `normal` (Standard, Vorgabe), `spacious` (Großzügig) | `refs.image` |
| `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (Liste), `featured` (erste Karte hervorgehoben) | 1–4 | – | Bild je Karte in `data.items[].image` |
| `catalog_cards` | Programm- und Modulkarten | 1 | `standard`, `compact` | 1–4 | – | `refs.items[] = {type: composition, id}` |
| `topic_card` | Themenkarte, Premium-Karte nach Kit v1.7 | 1 | `adaptive`, `stacked` | 1–4 | `auto` (Vorgabe), `fill` | `refs.pillar`, `refs.image` |
@@ -110,7 +110,7 @@ ## 4. Registrierte Widget-Arten
## 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.
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`).
@@ -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.
- **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.
- **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.
- **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.
@@ -243,14 +243,16 @@ ## 11. Abschnitte und Plätze
- **Leere Plätze** gibt es im Editor. Öffentlich entfallen sie; die übrigen Plätze teilen sich die Breite im Verhältnis ihrer Einheiten. Ein Abschnitt ohne darstellbares Widget entfällt samt Fläche und Trenner.
- **Gestaltung**: nur Aufzählungswerte (`SectionStyle`), abgebildet auf Tokens. Freie Werte (Farbcodes, CSS, unbekannte Schlüssel) werden abgewiesen.
- Hintergrund: Standard, helle Markenfläche, dunkle Markenfläche, Markenakzent, Hintergrundbild. Jede Fläche setzt die Bedeutungs-Tokens neu (`scope-dark`, `scope-accent`, `scope-light`).
- Breite: schmal (45 rem), Standard (75 rem), breit (90 rem), volle Breite. Der Hintergrund reicht immer über die ganze Bildschirmbreite.
- Breite: schmal (44 rem), Standard (Inhaltsbreite, Basiswert 1312 px), breit (1,17-fach), volle Breite. Der Hintergrund reicht immer über die ganze Bildschirmbreite.
- **Abstände (Version 2): genau drei unabhängige Werte**, je Kein Abstand / Kompakt / Normal / Großzügig:
| Wert | Bedeutung | Stufen (390 px → 1440 px) |
|---|---|---|
| `spacing_top` | Abstand oben (vor dem Inhalt) | 0 / 24 → 45 / 48 → 90 / 72 → 120 px (`--section-space-*`) |
| `spacing_top` | Abstand oben (vor dem Inhalt) | 0 / 24 → 32 / 36 → 48 / 48 → 72 px (`--section-space-*`; Smartphone → Desktop, bei Standardwerten) |
| `spacing_bottom` | Abstand unten (nach dem Inhalt) | wie oben |
| `gap` | Widget-Abstand zwischen den Plätzen des Rasters, nebeneinander und gestapelt | 0 / 12 → 18 / 20 → 36 / 32 → 56 px (`--section-gap-*`) |
| `gap` | Widget-Abstand zwischen den Plätzen des Rasters, nebeneinander und gestapelt | 0 / 12 → 16 / 16 → 28 / 24 → 40 px (`--section-gap-*`) |
Die Pixelwerte sind seit ADR-44 aus den Basiswerten „Abschnittsabstand“ (Normal; Kompakt ⅔, Großzügig 1,5-fach) und „Basisabstand“ abgeleitet und in „Website → Design → Größen“ einstellbar; die Schlüssel (`compact`, `normal`, `large`) und gespeicherte Seiten bleiben unverändert.
- Zwischen zwei Abschnitten addieren sich „unten“ des ersten und „oben“ des zweiten; 0 + 0 = 0. Es gibt keine weitere Vorgabe aus Seiten- oder Rasterhüllen (geprüft: kein Außenabstand der Abschnitte, `main` ohne Innenabstand).
- Oben und unten sind der Innenabstand des Abschnitts. Bei eigener Fläche (dunkel, Akzent, Bild) liegen sie innerhalb der Fläche, damit Hintergründe nahtlos anschließen.
@@ -280,8 +282,8 @@ ## 12. Responsive Widget-Regeln und gemeinsamer Layoutvertrag (ADR-38)
| Widget | Breiten | Höhen | Darstellung nach Containerbreite |
|---|---|---|---|
| Einstieg (Hero) | 3, 4 | compact/normal/large | ab 860 px Foto über die Fläche, Text links, Mindesthöhe 400/512/640 px; darunter Sicherheitsumbruch: Foto 16:9 über dem Text, Höhe nach Inhalt; unter 440 px Schaltflächen untereinander |
| Bild und Text | 1–4 | compact/normal/spacious | unter 540 px gestapelt, Schaltflächen in voller Breite; 540–899 px flacher Bildstreifen (2,5 : 1 / 2,15 : 1 / 1,8 : 1) über dem Text; ab 900 px zweispaltig, Bild links oder rechts |
| Einstieg (Hero) | 3, 4 | compact/normal/large | ab 860 px Foto über die Fläche, Text links, Mindesthöhe 288/384/499 px bei Standardwerten (0,9-/1,2-/1,56-Faches der Bildhöhe aus der Größenskala); darunter Sicherheitsumbruch: Foto 16:9 über dem Text, Höhe nach Inhalt; unter 440 px Schaltflächen untereinander |
| Bild und Text | 1–4 | compact/normal/spacious | unter 540 px gestapelt, Schaltflächen in voller Breite; 540–899 px flacher Bildstreifen (2,5 : 1 / 2,15 : 1 / 1,8 : 1) über dem Text, nie höher als die Zielhöhe; ab 900 px zweispaltig (1,1 : 0,9), Bild links oder rechts, Bildhöhe = Zielhöhe 240/320/416 px bei Standardwerten |
| Überschrift | 1–4 | – | Größe folgt der Platzbreite, lange Wörter werden getrennt |
| Fließtext | 1–4 | – | Zeilenlänge höchstens etwa 70 Zeichen, lange Adressen brechen um |
| Redaktionelle Karten | 1–4 | – | so viele Karten nebeneinander, wie bei 15 rem Kartenbreite passen; hervorgehobene Karte ab 44 rem mit Bild neben dem Text |
@@ -312,15 +314,21 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**Darstellung** (Reiter „Darstellung“): Variante `adaptive` (ab 520 px Bild neben Text) oder `stacked` (Bild immer oben); Höhe `auto` oder `fill` („An die Zeile angleichen“); `settings.format` (`landscape` 16:9 Vorgabe, `square`, `portrait` 3:4); `settings.fit` (`cover` Vorgabe, `contain` für Dokumente und Poster); `settings.heading_level` (`h3` Vorgabe, `h2`, `h4`); Anzeigen/Ausblenden von Kurzbeschreibung, Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px).
**Text der Medienkarte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`); nur an der Medienkarte. `auto` entspricht dem bisherigen Verhalten (Kurzbeschreibung, sonst Teaser). Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Die ausführliche Beschreibung erscheint nur auf diese Wahl (öffentlich, sofern die Karte öffentlich ist). Der eigene Text der Karte (`data.summary`) hat Vorrang.
**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).
**Bild aus dem Film (Medienkarte).** Reiter „Medien“, nur bei einem Film: „Vorschaubild des Films übernehmen“ oder eine Stelle wählen. `FilmStill` legt das Einzelbild (bis 1600 px) einmal als Bild-Medium ab; `refs.image` trägt dessen Kennung. Details und Grenzen: `medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“.
**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.
**Text der Karte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`; an der Programm- und Modulkarte zusätzlich `goal`, das Lernziel der Fassung). `auto` entspricht dem bisherigen Verhalten je Karte (Medien: Kurzbeschreibung, sonst Teaser; Programm und Modul: Teaser, sonst Kurzbeschreibung, sonst Lernziel); die Themenkarte hat nur einen Text und keine Wahl. Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Die ausführliche Beschreibung erscheint nur auf diese Wahl (öffentlich, sofern die Karte öffentlich ist). Der eigene Text der Karte (`data.summary`) hat Vorrang.
**Bild aus dem Film (Medienkarte).** Reiter „Medien“, nur bei einem Film: eine Stelle mit Regler und Live-Bild wählen („Diese Stelle übernehmen“) oder „Vorschaubild des Films übernehmen“. An der Programm- und Modulkarte entsprechend „Vorschaubild übernehmen“ (`CompositionStill`). `FilmStill` legt das Einzelbild (bis 1600 px) einmal als Bild-Medium ab; `refs.image` trägt dessen Kennung. Details und Grenzen: `medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“.
**Redaktionsvorschau.** Nicht öffentliche Karten tragen die Marke „Nur Redaktionsvorschau“. Fehlende Inhalte (Kurzbeschreibung, Text für die Website, Anzeigetitel, Dauer, Laufzeit, Kartenbild) stehen eingeklappt unter „Hinweise für die Redaktion“, mit dem Ort, an dem sie gepflegt werden. Öffentlich erscheinen weder Marke noch Hinweise noch Bibliotheksbilder.
**Raster.** Eine Karte je Platz. Gemischte Raster entstehen über die Abschnittsraster, zum Beispiel 1 + 1 + 2 (`u1_1_2`), 2 + 2, 1 + 1 + 1 + 1. Gleiche Höhe: alle Karten einer Zeile auf „An die Zeile angleichen“ stellen; die Aktion steht dann am unteren Rand. Eine öffentlich nicht sichtbare Karte lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Solche Karten daher in einen eigenen Abschnitt setzen oder mit einem Platz kombinieren, der allein gut aussieht.
**Sicherheit.** Der einzuhaltende Weg steht in `medienzugriff-fuer-komponenten.md`. Vorschaubilder der Bibliothek (Filmstandbilder, Modulvorschau) nur über `editorial.card` (Redaktionsanmeldung) und nur in der Redaktionsvorschau; öffentlich nie. Keine Adressen unter `/bereich/` oder `/redaktion/` auf öffentlichen Seiten, kein Abspielen, kein Download, kein Preis, keine Kaufaktion. Nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtexte, Traineranleitungen. Eine Karte begründet keine Berechtigung (Tests `CmsPremiumCardsTest`).
**Sicherheit.** Der einzuhaltende Weg steht in `medienzugriff-fuer-komponenten.md`. Vorschaubilder der Bibliothek (Filmstandbilder, Modulvorschau) nur über `editorial.card` (Redaktionsanmeldung) und nur in der Redaktionsvorschau; öffentlich nie. Keine Adressen unter `/bereich/` oder `/redaktion/` auf öffentlichen Seiten, kein Abspielen außer eines für die Website freigegebenen Trailers (ADR-43), kein Download, kein Preis, keine Kaufaktion. Nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtexte, Traineranleitungen. Eine Karte begründet keine Berechtigung (Tests `CmsPremiumCardsTest`).
**Erweiterungsbedarf für öffentliche Vorschaubilder und Filmvorschauen (nicht umgesetzt, minimal):**
1. *Vorschaubild für die Website freigeben:* je `ContentElement` und `Composition` ein Freigabevermerk (`thumbnail_public_at`, `thumbnail_public_by`, Bezug auf `thumbnail_source`), gesetzt nur durch eine ausdrückliche Aktion „Vorschaubild für die Website freigeben“ in der Medien- bzw. Modulbearbeitung. Die Hintergrundverarbeitung kopiert das freigegebene Standbild nach `media_public` (eigener Pfad, zum Beispiel `katalog/`), Zurücknehmen löscht die Kopie. Die Karte nimmt dieses Bild, wenn kein Kartenbild gewählt ist. Der Web-Prozess schreibt weiterhin nicht in den Medienbestand.
+62 -8
View File
@@ -1,6 +1,6 @@
# Gemeinsames Designsystem (ADR-36) – umgesetzter Stand
Stand: 18.11.2026, Designiteration 1 (Branch `feature/design-iteration-1`; Vorstand 17.11.2026 `feature/cms-sections`). Gilt für öffentliche Website, Anmeldung, Mitgliederbereich und Mitgliederbibliothek; später für Warenkorb und Checkout. Die Verwaltung nutzt dieselben Markenfarben und Schriftrollen. Ihre Maße und der Arbeitsplatzrahmen stehen in [Verwaltungstokens](../ux/verwaltung/tokens.md) und folgen dem [Verwaltungsstandard](../ux/verwaltung/14-verwaltungsstandard.md). Öffentliche Website und fachliche Verträge bleiben davon unberührt.
Stand: 22.11.2026 (Größenskala, ADR-44, Abschnitt 15); davor 18.11.2026, Designiteration 1 (Branch `feature/design-iteration-1`; Vorstand 17.11.2026 `feature/cms-sections`). Gilt für öffentliche Website, Anmeldung, Mitgliederbereich und Mitgliederbibliothek; später für Warenkorb und Checkout. Die Verwaltung nutzt dieselben Markenfarben und Schriftrollen. Ihre Maße und der Arbeitsplatzrahmen stehen in [Verwaltungstokens](../ux/verwaltung/tokens.md) und folgen dem [Verwaltungsstandard](../ux/verwaltung/14-verwaltungsstandard.md). Öffentliche Website und fachliche Verträge bleiben davon unberührt.
**Status der Werte:** Alle Markenwerte, Schriften und die Wortmarke sind **vorläufig**. Sie stammen aus `docs/Brand-UI-Kit/02_design_tokens` (Entwurf vom 15.11.2026, aus den Originalmotiven abgeleitet, laut Kit nicht freigegeben) und aus der Empfehlung im Website-Zielkonzept §7.2. Diese Datei ist keine Markenfreigabe. Eine Freigabe ändert ausschließlich `resources/css/tokens.css` (und für die Wortmarke `resources/views/components/site/brand.blade.php`, für die Markenakzente `resources/views/components/brand/`).
@@ -8,7 +8,9 @@ ## 1. Dateien
| Datei | Inhalt |
|---|---|
| `resources/css/tokens.css` | Ebene 1 Markenwerte (`--lf-*`), Ebene 2 Bedeutungswerte (`--color-*`), Typografie, Abstände, Rundungen, Layoutmaße, Flächen-Gültigkeitsbereiche `.scope-dark`, `.scope-accent`, `.scope-light` |
| `resources/css/tokens.css` | Ebene 1 Markenwerte (`--lf-*`), Ebene 2 Bedeutungswerte (`--color-*`), **Größenskala** (zehn Basiswerte `--ds-*` und alle abgeleiteten Größen, Abschnitt 15), Rundungen, Layoutmaße, Flächen-Gültigkeitsbereiche `.scope-dark`, `.scope-accent`, `.scope-light` |
| `app/Domain/Design/` | `DesignScale` (Basiswerte, Wertebereiche, Prüfung), `DesignSettings` (Lesen, Speichern, Zurücksetzen, Inline-Stylesheet), `SiteSetting` (Tabelle `site_settings`) |
| `app/Filament/Pages/DesignGroessen.php` | Verwaltungsseite „Website → Design → Größen“ |
| `resources/css/base.css` | Grundelemente, Überschriften, Links, Fokus, Sprunglink, `prefers-reduced-motion` |
| `resources/css/components.css` | Grundkomponenten: Container, Schaltflächen, Formulare, Statusanzeigen, Karte, Dialog, Kennzeile, Themensignatur, Redaktionshinweise |
| `resources/css/site.css` | Website-Gerüst: Wortmarke, Kopfzeile (zwei Zustände), Hauptnavigation, Menümodus, Inhaltsfläche, Fußbereich, Markenakzente |
@@ -72,11 +74,11 @@ ## 5. Typografie, Abstände, Maße
|---|---|
| Auszeichnung (H1–H3, Wortmarke) | Nunito 700/800, vorläufig |
| Lesen und Bedienen | Source Sans 3 400/600 (bereits bisher verwendet) |
| Skala | Fließtext 17 → 18 px, Zeilenhöhe 1,6; H3 20 → 22; H2 26 → 34; H1 34 → 52; Lesebreite 70 Zeichen |
| Abstände | Grundmaß 4 px: 4, 8, 12, 16, 24, 32, 48, 64, 96 px |
| Skala | Seit ADR-44 aus Basiswerten abgeleitet (Abschnitt 15). Standard bei Desktop: Fließtext 17 px (Smartphone 16), Zeilenhöhe 1,55; H3 20; H2 28; H1 40; Display bis 52; kleine Schrift 14; Schaltflächen 15; Lesebreite 70 Zeichen |
| Abstände | Basisabstand 8 px (einstellbar): halber bis zwölffacher Wert = 4, 8, 12, 16, 24, 32, 48, 64, 96 px |
| Rundungen | 8 (klein), 14 (Karte), 22 (Fläche), Pille |
| Breiten | Lesebereich 44 rem, Standard 82 rem, Breit 96 rem, Vollbreite; Randabstand 16–40 px (siehe Abschnitt 12) |
| Abschnittsabstände | `--section-space-{none,compact,normal,large}` (oben/unten) und `--section-gap-{none,compact,normal,large}` (Widget-Abstand); Bedeutung in `cms-widget-registry.md` §11 |
| Breiten | Lesebereich 44 rem, Standard 1312 px (einstellbar), Breit 117 % davon, Vollbreite; Randabstand 16–40 px (siehe Abschnitt 12) |
| Abschnittsabstände | `--section-space-{none,compact,normal,large}` (oben/unten) und `--section-gap-{none,compact,normal,large}` (Widget-Abstand), abgeleitet aus Abschnittsabstand und Basisabstand (Abschnitt 15); Bedeutung in `cms-widget-registry.md` §11 |
| Trefferfläche | mindestens 44 × 44 px |
| Fokus | 3 px Rahmen in `--color-focus`, 3 px Abstand, auf jeder Fläche sichtbar |
@@ -120,8 +122,8 @@ ## 8. Themensignaturen (vorbereitet)
## 9. Website-Gerüst (Designiteration 1)
- **Wortmarke**: freigegebene Lara-&-Felix-Wortmarke (Kompaktfassung) als Bild mit festen Maßen im Markup; die Breitenmessung der Navigation stimmt dadurch schon vor dem Laden des Bildes.
- **Kopfzeile, zwei Zustände ohne Layoutsprung.** Die Box ist immer `--header-height-initial` hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand (`top: kompakt − initial`). Die innere Leiste (`.site-header-bar`, 72 px) klebt oben. Beim Scrollen wandert sie 16 px nach oben und bleibt dann stehen; der Seitenfluss ändert sich nie. Ein Beobachter (`data-site-header-sentinel`) setzt `.is-compact`: Wortmarke von 1,16-facher auf normale Größe (nur `transform`) und Schatten. Unter `prefers-reduced-motion` ohne Übergang. Ohne JavaScript klebt die Kopfzeile genauso; nur die Wortmarke bleibt groß.
- **Breitenstufen der Navigation** (`site-nav.js`, Messung an einer unsichtbaren Kopie): 1. Navigation und Kontozugang mit Beschriftung in einer Zeile; 2. sonst Kontozugang nur als Symbol (`.is-account-compact`); 3. sonst und immer unter 75 rem Menümodus (`.is-menu-mode`). Die Navigation bricht nie um; deshalb ist die Kopfzeile auf allen Seiten gleich hoch, unabhängig von Anzahl und Länge der CMS-Einträge. Die Messung steht inline direkt nach der Kopfzeile (`window.lufHeaderMode`) und setzt die Stufe vor dem ersten Zeichnen; `site-nav.js` wiederholt sie bei Größenänderungen und nach dem Laden der Schriften.
- **Kopfzeile, zwei Zustände ohne Layoutsprung.** (Maße seit ADR-44 aus dem Basiswert „Höhe der Kopfzeile“, Standard 80: Box 80 px ab 75 rem, sonst 64 px, kompakte Leiste 64 px, Wortmarke im Ausgangszustand 1,25-fach; die folgenden Pixelangaben nennen den Stand vor ADR-44.) Die Box ist immer `--header-height-initial` hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand (`top: kompakt − initial`). Die innere Leiste (`.site-header-bar`, 72 px) klebt oben. Beim Scrollen wandert sie 16 px nach oben und bleibt dann stehen; der Seitenfluss ändert sich nie. Ein Beobachter (`data-site-header-sentinel`) setzt `.is-compact`: Wortmarke von 1,16-facher auf normale Größe (nur `transform`) und Schatten. Unter `prefers-reduced-motion` ohne Übergang. Ohne JavaScript klebt die Kopfzeile genauso; nur die Wortmarke bleibt groß.
- **Breitenstufen der Navigation** (`site-nav.js`, Messung des echten Platzbedarfs der Einträge): 1. Navigation und Kontozugang mit Beschriftung in einer Zeile; 2. sonst Kontozugang und Warenkorb nur als Symbol (`.is-account-compact`); 3. sonst zusätzlich engere Navigation mit kleinerem Abstand und Schrift (`.is-nav-tight`); 4. sonst und immer unter 75 rem Menümodus (`.is-menu-mode`). Auf dem Desktop steht die Navigation damit offen, der Burger ist dort nur die letzte Stufe (Stand 2026-11-22: luf-test mit 8 Einträgen offen ab 1280 px, bei 1200 px Menümodus). Die Navigation bricht nie um; deshalb ist die Kopfzeile auf allen Seiten gleich hoch, unabhängig von Anzahl und Länge der CMS-Einträge. Die Messung steht inline direkt nach der Kopfzeile (`window.lufHeaderMode`) und setzt die Stufe vor dem ersten Zeichnen; `site-nav.js` wiederholt sie bei Größenänderungen und nach dem Laden der Schriften.
- **Hauptnavigation**: aus `navigation_items` (`header`), aktiver Eintrag mit gelber Markenunterstreichung und `aria-current`, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit `aria-expanded`, Escape schließt, Klick außerhalb schließt).
- **Menümodus**: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche direkt unter dem sichtbaren Teil der Kopfzeile, 48 px hohe Einträge, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator läuft im Kreis zwischen Schaltfläche und Einträgen, Escape schließt und gibt den Fokus zurück. Keine untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation unter 75 rem als umbrechende Liste sichtbar.
- **Kontozugang** „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet) und vorbereiteter Warenkorbzugang (`config/cms.php` → `cart.enabled`, Vorgabe aus: es wird nichts ausgegeben).
@@ -172,3 +174,55 @@ ## 14. Premium-Karten (Brand-UI-Kit v1.7, Entwurf, ADR-39)
- Schriften: Titel `--font-display` 800, Text `--font-reading`; keine neuen Schriften.
- Ab 520 px Platzbreite Bild 42 % neben Text 58 %; Bildformat 16:9, 1:1 oder 3:4 bleibt erhalten; kein line-clamp.
- Status: Entwurf zur visuellen Freigabe; auf der Testinstanz nur mit gekennzeichneten Platzhalterbildern.
## 15. Größenskala (ADR-44, 22.11.2026)
**Ziel.** Eine einzige, zentral steuerbare Größenskala für Website, CMS-Vorschau und gemeinsam genutzte Komponenten; kompakte Darstellung bei 100 % Browserzoom, ohne `zoom`, `transform: scale()` oder globale Prozentskalierung.
### 15.1 Basiswerte (einstellbar)
Pixel als ganze Zahl. Standard und zulässiger Bereich stehen in `App\Domain\Design\DesignScale::PARAMETERS` und (Standard) in `tokens.css` (`--ds-*`).
| Basiswert | Variable | Standard | Bereich | Wirkung |
|---|---|---:|---:|---|
| Fließtext | `--ds-body` | 17 | 16–20 | Desktop; Smartphone 1 px weniger, nie unter 16; leitet kleine Schrift, Einleitung, Überschrift 3, Schaltflächentext ab |
| Überschrift 1 | `--ds-h1` | 40 | 30–56 | Seitentitel Desktop; Smartphone ≈ 70 % |
| Überschrift 2 | `--ds-h2` | 28 | 22–40 | Abschnittstitel; auch Titel in Bild und Text, Handlungsaufruf, breite Karten |
| Display-Überschrift (Höchstwert) | `--ds-display` | 52 | 36–80 | Titel des Einstiegs, wächst mit der Platzbreite bis zu diesem Wert |
| Basisabstand | `--ds-space` | 8 | 6–12 | `--space-1…9` (0,5- bis 12-fach) und `--section-gap-*` |
| Abschnittsabstand (Desktop) | `--ds-section` | 48 | 24–96 | Stufe Normal; Kompakt ⅔, Großzügig 1,5-fach; Smartphone kleiner |
| Karten-Innenabstand | `--ds-card-pad` | 20 | 12–32 | `--pad-card` (Smartphone 80 %), `--pad-surface` (2,4-fach) für große Flächen |
| Höhe der Kopfzeile | `--ds-header` | 80 | 56–112 | Ausgangszustand Desktop; beim Scrollen und mobil 80 %; Anzeigegröße der Wortmarke folgt |
| Maximale Inhaltsbreite | `--ds-width` | 1312 | 960–1600 | Standardraster; Breit = 1,17-fach; Lesebereich bleibt 44 rem |
| Bildhöhe Bild und Text (Desktop) | `--ds-media` | 320 | 200–480 | Bildhöhe Variante Standard; Mindesthöhe des Einstiegs = 1,2-fach |
Prüfregeln (Verwaltung und Lesen): Fließtext + 6 ≤ Überschrift 2; Überschrift 2 + 4 ≤ Überschrift 1 ≤ Display. Nicht einstellbar: Trefferflächen (44 px), Untergrenze 16 px für Fließtext, Fokusdarstellung.
### 15.2 Ableitung und Verwendung
- **Alle Regeln stehen in `tokens.css`.** Fließende Werte zwischen 360 und 1200 px Fensterbreite (`--fl`), Minimum auf kleinen Bildschirmen, Maximum ab 75 rem; Umrechnung in rem, damit die Browser-Textgröße wirkt. Überschriften bleiben auf jeder Breite größer als der Text.
- **Abgeleitete Tokens:** `--text-small|body|lede|h3|h2|h1|display|button`, `--space-1…9`, `--pad-card`, `--pad-surface`, `--section-space-{compact,normal,large}`, `--section-gap-{compact,normal,large}`, `--grid-gap`, `--width-standard|wide`, `--header-height(-initial)`, `--media-h`.
- **Komponenten** (Einstieg, Bild und Text, Premium-Karten, redaktionelle und Katalogkarten, Handlungsaufruf, FAQ, Kopf, Fuß, Schaltflächen) verwenden nur diese Tokens. `cqi` bleibt als Zwischenwert in engen Plätzen, nach oben begrenzt durch das Token (z. B. `clamp(1.4rem, 3.6cqi, var(--text-h2))`). Neue Komponenten definieren keine eigenen Größen.
- **Dichtestufen** der Größenvarianten über `--dens` (kompakt 0,75, standard 1, großzügig 1,3): Einstieg (`compact`, `normal`, `large`) und Bild und Text (`compact`, `normal`, `spacious`) skalieren Bildhöhe, Mindesthöhe, Abstand und Innenabstand einheitlich. Die Mindesthöhen des Einstiegs gelten wie bisher nur ab 860 px Containerbreite; die Regel des Sicherheitsumbruchs steht in `lf-hero.css` nach den Höhenregeln und muss dort bleiben.
- **Bild und Text:** Ab 900 px Containerbreite füllt das Bild seine Spalte und hat die Zielhöhe `--ds-media × --dens` (Standard 320 px, kompakt 240, großzügig 416), unabhängig vom Seitenverhältnis der Datei; es wächst nur, wenn der Text höher ist. Spalten 1,1 : 0,9. Im Streifen (540–899 px) und gestapelt (< 540 px) ist die Bildhöhe auf dieselbe Zielhöhe begrenzt. Der Bildausschnitt folgt weiter dem Fokuspunkt (`--bt-focus-x/y`).
### 15.3 Konfiguration in der Verwaltung
- **Fundstelle:** „Website → Design → Größen“ (`/verwaltung/design/groessen`, Navigationsgruppe „Design“, Kopfzeile „Website / Design / Größen“). Zugriff nur für den Systemverwalter.
- **Ablauf:** Arbeitsstand mit Statuszeile („Änderungen nicht gespeichert“ / „Eigene Werte gespeichert“ / „Standardwerte aktiv“); „Größen speichern“ prüft Wertebereiche und Reihenfolge, schreibt in `site_settings` (Schlüssel `design.scale`) und wirkt **sofort**, ohne Deployment, auf die Website und alle CMS-Vorschauen. „Standardwerte wiederherstellen …“ (mit Bestätigung) löscht die Zeile. „Website ansehen“ zeigt den gespeicherten Stand. Strg+S speichert.
- **Auslieferung:** Abweichende Werte kommen als `<style id="lf-design-scale">` nach dem Stylesheet in `layouts/site`, `layouts/member` und in die Vorschau-Iframes; bei Standardwerten entfällt der Block. Zwischenspeicher `design.scale.v1` wird beim Speichern geleert. Fehlt die Tabelle oder sind die Daten beschädigt, gelten die Standardwerte ohne Fehlerseite.
### 15.4 Gemeinsam genutzt und nur Website
| Wert | Website | Mitgliederbereich (heute) |
|---|---|---|
| Fließtext, Überschrift 3, kleine Schrift, Schaltflächentext, Basisabstand | ja | folgt (gleiche Tokens) |
| Überschrift 1 und 2, Display | ja | ja (seit ADR-45): H1 `--text-h1`, Abschnittstitel `--text-h2`, Kartentitel `--text-h3` |
| Kopfzeile, Inhaltsbreite, Karten-Innenabstand | ja | ja: `--header-height`, `--width-standard`, `--pad-card` |
| Abschnittsabstände, Bildhöhen (Widgets) | ja | Abstände über `--space-*`; Kartenbreite über das abgeleitete Token `--card-min` (80 % von `--ds-media`) |
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
`lf-hero`, `lf-bild-text` und `lf-premium-card` (Kit v1.6/v1.7) verwenden die Größen der Skala statt eigener `rem`-/`px`-Werte; Aufbau, Varianten, Farben und Schriften sind unverändert. Das Kit bleibt Gestaltungsgrundlage; Größenentscheidungen fallen in der Größenskala.
Loaded 100 of 301 files, more files were not shown because too many files have changed in this diff. Show more