Compare commits

...
Author SHA1 Message Date
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
LarsandClaude Sonnet 5.5 604e1791c5 Berichte die Medienkarte mit Textwahl und Bild aus dem Film.
CI Feature / test (push) Successful in 1m47s
Deploy Test / test (push) Successful in 1m48s
Deploy Test / deploy (push) Successful in 26s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 19:36:38 +01:00
LarsandClaude Sonnet 5.5 cd66561ca9 Melde die Wiederverwendung eines Filmbilds ehrlich und erlaube das Löschen der Medien.
- Wird eine schon übernommene Stelle erneut gewählt, nennt die Meldung den tatsächlichen Stand: bereits freigegeben,
  wird verarbeitet oder Website-Freigabe zurückgenommen (bleibt zurückgenommen). Ein bei der Verarbeitung
  gescheitertes oder archiviertes Bild wird nicht wiederverwendet; die Herkunft zeigt dann auf das neue Bild.
- „Medium löschen“ erreicht jetzt Standbilder (film_still_sources: cascade) und übernommene CMS-Bilder
  (website_media_aliases: Zuordnung bleibt als Sperre, die frühere Adresse /medien/cms/… liefert 404, das Widget
  zeigt kein Bild). Vorher hätte der Fremdschlüssel das Löschen mit einem Fehler abgebrochen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 19:36:07 +01:00
LarsandClaude Sonnet 5.5 886715af96 Dokumentiere Textwahl und Bild aus dem Film der Medienkarte.
CI Feature / test (push) Successful in 1m39s
Deploy Test / test (push) Successful in 1m41s
Deploy Test / deploy (push) Successful in 25s
Medienzugriff, Registry §13 und ADR-39: Text der Karte, die ausführliche Beschreibung als ausdrücklich gewählter
öffentlicher Text, Filmbild einmal als Bild-Medium (FilmStill, film_still_sources) und die Grenzen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 19:11:01 +01:00
LarsandClaude Sonnet 5.5 05bd36509c Wähle den Kartentext der Medienkarte und übernimm Bilder aus dem Film.
Text: Einstellung „Text der Karte“ (Automatisch, Teaser, Kurzbeschreibung, Ausführliche Beschreibung). Automatisch
bleibt wie bisher (Kurzbeschreibung, sonst Teaser). Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes
Feld; ist sie nicht gepflegt, bleibt die Karte ohne Text und die Vorschau nennt, wo sie zu pflegen ist. Der eigene
Text der Karte hat weiter Vorrang. Einsatzhinweis und Lizenzvermerk bleiben intern.

Film: Im Reiter „Medien“ lässt sich das Vorschaubild des Films oder eine gewählte Stelle als Kartenbild übernehmen.
FilmStill zieht das Einzelbild einmal (bis 1600 px, nie vergrößert) und legt es über WebsiteIntake als gewöhnliches
Bild-Medium ab; die Warteschlange leitet ab und gibt frei. Dieselbe Stelle ergibt dasselbe Medium
(film_still_sources, additive Tabelle). Seitenaufrufe lesen nur die gespeicherte Datei und starten kein ffmpeg.
Der Film bleibt geschützt; Traineranleitungen, archivierte und nicht bereitgestellte Filme sind ausgeschlossen.
ThumbnailDeriver::jpegAtVersion behält seine Signatur, die Auflösungswahl steht in frameJpeg.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 19:09:00 +01:00
StommerandClaude Sonnet 5.5 96bb661239 Nenne im Abnahmeprotokoll den geprüften Commit je Phase
Deploy Test / test (push) Successful in 1m31s
CI Feature / test (push) Successful in 1m38s
Deploy Test / deploy (push) Successful in 25s
Die Klickfolge lief über die Stände d49b178, 4520dba und 9701777. Das Protokoll nennt sie
je Phase, trennt gemessene von nur aufgenommenen Ansichten und vermerkt die Abweichung der
Stilwerte von den Verwaltungs-Tokens. Bilder 14 und 15 stammen jetzt vom finalen Stand.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 18:58:22 +01:00
StommerandClaude Sonnet 5.5 340b898b7b Dokumentiere die Nachbesserung der Shop-Verwaltung mit Prüfung auf luf-test
Deploy Test / test (push) Successful in 1m39s
Deploy Test / deploy (push) Successful in 27s
Abnahmeprotokoll Etappe 1 um Befund, Änderungen, Klickfolge, Testkauf bis zum Download,
schmale Ansichten, Tastatur, offene Entscheidungen und Belege (23 Bilder) ergänzt.
Geprüfter Stand: 9701777 auf luf-test.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 18:43:15 +01:00
StommerandClaude Sonnet 5.5 9701777011 Benenne Medien ohne Anzeigenamen nach ihrem Arbeitstitel
Deploy Test / test (push) Successful in 1m49s
Deploy Test / deploy (push) Successful in 32s
Der Name eines Lizenzartikels fällt auf den Arbeitstitel oder die Bezeichnung des Inhalts
zurück, bevor die Kennung erscheint. Das Begleitmaterial zeigte im Shop sonst die Kennung.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 18:37:58 +01:00
StommerandClaude Sonnet 5.5 4520dba2f0 Benenne Artikel im Shop und in den Listen nach ihrem Inhalt statt nach der Kennung
Deploy Test / test (push) Successful in 1m36s
Deploy Test / deploy (push) Successful in 27s
Die Produktseite zeigte im Leistungsumfang die Kennung, obwohl die Redaktion den Namen
aus dem Inhalt übernimmt. ProductOptions und PublicationReadiness lösen den Namen jetzt
wie die Redaktion auf: eigener Name, sonst Name des Inhalts, zuletzt Kennung.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 18:14:56 +01:00
StommerandClaude Sonnet 5.5 d49b178ebd Gib den Symbolen der Voraussetzungen eine feste Größe
Deploy Test / test (push) Successful in 1m44s
Deploy Test / deploy (push) Successful in 26s
Der Browser-Nachweis auf luf-test zeigte überdimensionierte Symbole im Abschnitt
„Bis zur Veröffentlichung“. Größe und Farbe kommen jetzt aus den Verwaltungs-Tokens.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 17:02:14 +01:00
StommerandClaude Sonnet 5.5 da7ebca999 Merge branch 'feature/shop-verwaltung-abnahme' into develop
Deploy Test / test (push) Successful in 1m30s
Deploy Test / deploy (push) Successful in 28s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 16:55:29 +01:00
StommerandClaude Sonnet 5.5 f72b79fd8c Führe Artikel, Paket und Angebot mit sichtbaren Voraussetzungen bis zum kaufbaren Angebot
CI Feature / test (push) Successful in 1m42s
Abnahmebefund Etappe 1: Nach dem Anlegen mit einem Namen fand die Verwaltung keinen Weg,
Inhalte festzulegen und Artikel, Paket, Preis und Rechte zu einem kaufbaren Angebot zu
verbinden.

- Gemeinsamer Baustein „Bis zur Veröffentlichung“ (PublicationReadiness, voraussetzungen.blade)
  auf Lizenzartikel, Paket und Angebot: erledigte und offene Schritte mit Weg dorthin,
  Zustand als Text und Symbol.
- Artikel: „Inhalt festlegen“ als Hauptaktion im Kopf statt nur im Menü; Dialog mit
  „Freigegebener Inhalt“ statt „Wurzel“, Einordnung beim ersten Stand vorbelegt.
- Auswahllisten zeigen Name, Kennung und Stand; Artikel ohne Stand sind gekennzeichnet,
  Produktseiten nennen die Auffindbarkeit im Shop, Paketfassungen ihre Artikel.
- Angebotsaktivierung lehnt Artikel ohne veröffentlichten Stand (auch in Paketen) mit
  Erklärung ab. Die Domänenregel in OfferService bleibt unverändert; das ist eine
  Oberflächenabsicherung und bei Bedarf eine fachliche Entscheidung.
- Erfolgsmeldungen nennen den nächsten Schritt.

Bestandstest geändert: OrganizationPurchaseTest::test_membership_boundaries_decide_the_club_access
setzte die Uhrzeit erst nach der Bestellung auf 12:00 Uhr und scheiterte dadurch nach 12:00 UTC.
Die feste Uhrzeit gilt jetzt vor der Bestellung; die Assertions bleiben unverändert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 16:30:14 +01:00
Lars 4e0760db1e Add feature tests for shop functionality and organization purchases
Deploy Test / test (push) Successful in 1m38s
Deploy Test / deploy (push) Successful in 31s
- Implement OfferOptionAdminTest to validate offer option management, including price display, activation, and cancellation.
- Create OrganizationPurchaseTest to ensure correct handling of organization purchases, including access control and order processing.
- Add ShopProductPageTest to verify shop product listings, search functionality, and product page details.
- Introduce BuildsShop trait for seeding test data related to shop functionality.
- Implement MoneyTest to validate money parsing and formatting, ensuring correct handling of euro amounts.
2026-11-21 12:06:24 +01:00
Lars 6c8bbee363 Merge branch 'develop' of 192.168.2.144:Lars/laraundfelix into develop
Deploy Test / test (push) Successful in 1m29s
Deploy Test / deploy (push) Successful in 28s
2026-11-21 10:33:07 +01:00
Lars 7ad5929588 Refine product configuration and member area documentation; clarify MVP requirements, add details on licensing options, and enhance user interface guidelines. Update payment processes for organizations and clarify target audiences for the sales launch. Introduce new requirements for managing offers and discounts in the shop system, including the necessity of a shopping cart for multiple offers. 2026-11-21 10:33:05 +01:00
LarsandClaude Sonnet 5.5 ed1f706d46 Dokumentiere die Vereinheitlichung der fachlichen Säulen
CI Feature / test (push) Successful in 1m33s
Deploy Test / test (push) Successful in 1m30s
Deploy Test / deploy (push) Successful in 33s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 10:22:55 +01:00
LarsandClaude Sonnet 5.5 7c48a6480c Vereinheitliche die fachlichen Säulen auf die zentrale Säulenverwaltung
CI Feature / test (push) Successful in 1m34s
Deploy Test / test (push) Successful in 1m29s
Deploy Test / deploy (push) Successful in 29s
Module, Programme und Lizenzartikel verwenden wie Medien und Seiten die Tabelle
pillars; die Kopie „Fachliche Säule“ in den redaktionellen Dimensionen wird nirgends
mehr angeboten, geändert oder gefiltert und bleibt nur als Verlauf erhalten.

- Migration (nur Ergänzungen): composition_pillar und license_article_pillar mit
  restrictOnDelete, pillar_id an den alten Dimensionswerten als dokumentierte
  Abbildung, einmalige wiederholbare Übernahme (LegacyPillarAdoption).
- Übernahme nur über die gespeicherte Kennung pfeiler-<Nummer> und nur direkte
  Zuordnungen; mehrdeutige, abgeleitete und verwaiste Fälle werden gemeldet, nicht
  geraten. Medien bleiben bei ihrer Zuordnung. Alte Zeilen bleiben unverändert.
  Befehl: php artisan luf:saeulen-uebernehmen [--dry-run].
- Editoren von Modul, Programm und Lizenzartikel wählen Säulen aus der Säulenverwaltung;
  PillarService::assign gilt für alle Objektarten, Löschschutz zählt alle Objektarten.
- Filter: Module und Programme, Aufbau-Picker und Mitgliederbibliothek nach der
  Säulenzuordnung; alte Adressen mit einem Säulenwert der Einordnung folgen der Säule.
- Abgeleitete Säulen (aus enthaltenen Medien) bleiben getrennt von direkten.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 10:11:42 +01:00
229 changed files with 9705 additions and 318 deletions

No files matched your search

+1 -1
View File
@@ -63,6 +63,6 @@ ## Entwicklung
## Verwaltungsoberfläche
- Maßgeblich sind `docs/ux/verwaltung/14-verwaltungsstandard.md` (Design und Interaktion) und `15-umbauauftrag.md` (Auftrag, Nachweise). Keine neue allgemeine Designabstimmung verlangen. Einstieg für alle Agenten: `AGENTS.md`, `.cursor/rules/verwaltung-ux.mdc`.
- Gemeinsame Bausteine wiederverwenden statt neue Masken bauen: `resources/views/filament/verwaltung/` (`kopf`, `redaktion`, `texte`, `praesentation`, `einordnung`, `picker`, `bestaetigung`, `abgang`, `aufbau`, `bestand`) mit dem Trait `App\Filament\Support\ManagesEditorialSurface`. Listen nutzen `verwaltung/bestand` mit `ShowsBestand` (bzw. `ListsCompositions`, `ListsCatalog`) und den Eintrag `<x-vw.eintrag>`, den auch der Picker verwendet; Katalogobjekte die Seite `catalog/objekt`. CMS: Seitenkopf `cms/seite-kopf` (Register, Kontexte „Abschnitt gestalten“ und „Konfigurieren“); Seiten und Menüs in der Webpräsenz (`App\Filament\Pages\Webpraesenz`, Menüs als Arbeitsstand mit einer Speicherhandlung). Der Picker liegt im Trait `ChoosesMedia` (Redaktion über `ManagesEditorialSurface`, CMS-Bilder über `ChoosesWebsiteImages`); keine eigenen Auswahllisten für Medien bauen. Redaktionelle Auswahlwerte (Materialart, Einordnung) nur über `App\Domain\Catalog\EditorialVocabulary` anbieten und prüfen (aktiv, zulässiger Kontext, vorhandene Zuordnungen erhalten); gepflegt werden sie unter „Redaktionelle Stammdaten“. Ersetzt eine Seite die Filament-Tabelle, muss sie den Dialogbereich ausgeben (in `bestand` enthalten), sonst öffnen „… anlegen“-Dialoge nicht. Gestaltungswerte nur in `verwaltung/styles.blade.php` (Tokens `--vw-…`, dokumentiert in `docs/ux/verwaltung/tokens.md`).
- Gemeinsame Bausteine wiederverwenden statt neue Masken bauen: `resources/views/filament/verwaltung/` (`kopf`, `redaktion`, `texte`, `praesentation`, `einordnung`, `picker`, `bestaetigung`, `abgang`, `aufbau`, `bestand`) mit dem Trait `App\Filament\Support\ManagesEditorialSurface`. Listen nutzen `verwaltung/bestand` mit `ShowsBestand` (bzw. `ListsCompositions`, `ListsCatalog`) und den Eintrag `<x-vw.eintrag>`, den auch der Picker verwendet; Katalogobjekte die Seite `catalog/objekt`. CMS: Seitenkopf `cms/seite-kopf` (Register, Kontexte „Abschnitt gestalten“ und „Konfigurieren“); Seiten und Menüs in der Webpräsenz (`App\Filament\Pages\Webpraesenz`, Menüs als Arbeitsstand mit einer Speicherhandlung). Der Picker liegt im Trait `ChoosesMedia` (Redaktion über `ManagesEditorialSurface`, CMS-Bilder über `ChoosesWebsiteImages`); keine eigenen Auswahllisten für Medien bauen. Redaktionelle Auswahlwerte (Materialart, Einordnung) nur über `App\Domain\Catalog\EditorialVocabulary` anbieten und prüfen (aktiv, zulässiger Kontext, vorhandene Zuordnungen erhalten); gepflegt werden sie unter „Redaktionelle Stammdaten“. Fachliche Säulen gibt es nur in der Säulenverwaltung (`pillars`); Zuordnung über `PillarService::assign`, nie über eine Dimension. Ersetzt eine Seite die Filament-Tabelle, muss sie den Dialogbereich ausgeben (in `bestand` enthalten), sonst öffnen „… anlegen“-Dialoge nicht. Gestaltungswerte nur in `verwaltung/styles.blade.php` (Tokens `--vw-…`, dokumentiert in `docs/ux/verwaltung/tokens.md`).
- Die Redaktion ist ein Arbeitsstand: nur „Redaktion speichern“ schreibt Texte, Einordnung, Präsentationsmedien und Abweichungen. Kein verdecktes Mitspeichern aus anderen Dialogen, offene Eingaben bleiben beim Wechsel erhalten.
- Jede UI-Änderung in der echten Anwendung prüfen (luf-test, breite und schmale Fenster, Tastatur) und mit Screenshots in `docs/ux/verwaltung/abnahme/` belegen. Stand der Abnahme: `abnahme/teil-a.md`, `abnahme/teil-b.md`, `abnahme/teil-c.md`, `abnahme/stammdaten.md`.
@@ -0,0 +1,25 @@
<?php
namespace App\Console\Commands;
use App\Domain\Catalog\LegacyPillarAdoption;
use Illuminate\Console\Command;
class AdoptLegacyPillars extends Command
{
protected $signature = 'luf:saeulen-uebernehmen {--dry-run : Nur berichten, nichts schreiben}';
protected $description = 'Übernimmt die alte Dimension „Fachliche Säule“ in die zentrale Säulenverwaltung und berichtet ungeklärte Fälle';
public function handle(): int
{
$dryRun = (bool) $this->option('dry-run');
$report = (new LegacyPillarAdoption)->run($dryRun);
foreach (LegacyPillarAdoption::lines($report, $dryRun) as $line) {
$this->line($line);
}
return $report['unresolved'] === [] ? self::SUCCESS : self::FAILURE;
}
}
+10
View File
@@ -4,6 +4,7 @@
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Composition extends Model
@@ -44,4 +45,13 @@ public function versions(): HasMany
{
return $this->hasMany(CompositionVersion::class);
}
/**
* Direkt zugeordnete fachliche Säulen (zentrale Säulenverwaltung). Die Säulen der enthaltenen Medien sind davon
* getrennt und werden zur Laufzeit abgeleitet (CatalogReading::memberPillars).
*/
public function pillars(): BelongsToMany
{
return $this->belongsToMany(Pillar::class)->orderBy('pillars.sort_order')->orderBy('pillars.name');
}
}
+4 -9
View File
@@ -20,20 +20,15 @@ public function values(): HasMany
}
/**
* Inhaltselemente pflegen Themen über die Säulen, nicht noch einmal über die Dimension.
* Module, Programme und Lizenzartikel haben keine Säulenauswahl und behalten die Dimension.
* Fachliche Säulen werden für alle Objektarten über die zentrale Säulenverwaltung gewählt (`pillars`), nie über
* eine Dimension. Die alte Dimension „Fachliche Säule“ bleibt nur als Verlauf in der Datenbank und wird nirgends
* mehr angeboten, geändert oder gefiltert.
*
* @return Collection<int, self>
*/
public static function forSubject(Model $subject): Collection
{
$query = static::query()->with('values')->orderBy('label');
if ($subject instanceof ContentElement) {
$query->where('slug', '!=', self::PILLAR_SLUG);
}
return $query->get();
return static::query()->with('values')->where('slug', '!=', self::PILLAR_SLUG)->orderBy('label')->get();
}
/**
@@ -7,7 +7,7 @@
class EditorialDimensionValue extends Model
{
protected $fillable = ['editorial_dimension_id', 'slug', 'label', 'sort_order', 'is_active'];
protected $fillable = ['editorial_dimension_id', 'pillar_id', 'slug', 'label', 'sort_order', 'is_active'];
protected function casts(): array
{
+3 -3
View File
@@ -181,13 +181,13 @@ public function dimensionGroups(Model $subject, array $assignedIds): array
* @param list<int> $selectedIds
* @return list<array{label: string, values: list<array{id: int, label: string}>}>
*/
public function dimensionFilterGroups(array $selectedIds = [], bool $withPillars = true): array
public function dimensionFilterGroups(array $selectedIds = []): array
{
$used = DB::table('identity_dimension_values')->distinct()->pluck('editorial_dimension_value_id')->map(fn ($id): int => (int) $id)->all();
$groups = [];
foreach (EditorialDimension::query()->with('values')->orderBy('label')->get() as $dimension) {
if (! $withPillars && $dimension->slug === EditorialDimension::PILLAR_SLUG) {
if ($dimension->slug === EditorialDimension::PILLAR_SLUG) {
continue;
}
@@ -217,7 +217,7 @@ public function dimensionFilterGroups(array $selectedIds = [], bool $withPillars
*/
public function memberFilterDimensions(array $selectedIds = []): Collection
{
$dimensions = EditorialDimension::query()->with('values')->orderBy('label')->get();
$dimensions = EditorialDimension::query()->with('values')->where('slug', '!=', EditorialDimension::PILLAR_SLUG)->orderBy('label')->get();
foreach ($dimensions as $dimension) {
$dimension->setRelation('values', $dimension->values
+270
View File
@@ -0,0 +1,270 @@
<?php
namespace App\Domain\Catalog;
use Illuminate\Support\Facades\DB;
/**
* Übernimmt die frühere Kopie „Fachliche Säule“ (Dimension `saeule`) in die zentrale Säulenverwaltung (Tabelle
* `pillars`). Verlustfrei, wiederholbar und ohne Raten:
*
* - **Zuordnung Wert → Säule** nur über die gespeicherte Kennung `pfeiler-{Säulenkennung}`, die die Migration
* vom 16.11.2026 beim Spiegeln geschrieben hat, und nur, wenn die Säule existiert und nicht jünger als der Wert ist
* (sonst kann die Kennung nicht aus ihr entstanden sein). Eine abweichende Bezeichnung ist nach einem Umbenennen
* erwartet und wird nur berichtet. Die Verknüpfung steht in `editorial_dimension_values.pillar_id`.
* - **Übernommen** werden nur direkte Zuordnungen von Modulen, Programmen und Lizenzartikeln in `composition_pillar`
* und `license_article_pillar` (insert-or-ignore, daher beliebig oft ausführbar).
* - **Nicht übernommen, sondern gemeldet:** Werte ohne belastbare Kennung, Zuordnungen zu fehlenden Objekten,
* abgeleitete Zuordnungen und unbekannte Objektarten. Abgeleitete Säulen eines Programms oder Moduls entstehen zur
* Laufzeit aus den enthaltenen Medien und werden nie als direkte Zuordnung gespeichert.
* - **Medien:** Die gespiegelten Zeilen sind eine veraltete Kopie; maßgeblich ist `content_element_pillar`. Sie werden
* nicht zurückgemischt, nur gezählt.
* - Alte Zeilen werden weder geändert noch gelöscht.
*
* Nur die Datenbankfassade, damit spätere Änderungen an Modellen die Migration nicht berühren.
*/
final class LegacyPillarAdoption
{
/** @var array<string, array{table: string, column: string, subjects: string}> */
private const TARGETS = [
'composition' => ['table' => 'composition_pillar', 'column' => 'composition_id', 'subjects' => 'compositions'],
'license_article' => ['table' => 'license_article_pillar', 'column' => 'license_article_id', 'subjects' => 'license_articles'],
];
/**
* @return array{
* mapping: list<array<string, mixed>>,
* unresolved: list<array<string, mixed>>,
* copied: array<string, int>,
* already: array<string, int>,
* before: array<string, int>,
* after: array<string, int>,
* mirror: array<string, int>
* }
*/
public function run(bool $dryRun = false): array
{
$report = [
'mapping' => [],
'unresolved' => [],
'copied' => ['composition' => 0, 'license_article' => 0],
'already' => ['composition' => 0, 'license_article' => 0],
'before' => $this->counts(),
'after' => [],
'mirror' => ['element_rows' => 0, 'missing_in_pivot' => 0, 'only_in_pivot' => 0],
];
$dimension = DB::table('editorial_dimensions')->where('slug', 'saeule')->first();
if ($dimension === null) {
$report['after'] = $report['before'];
return $report;
}
$resolved = [];
foreach (DB::table('editorial_dimension_values')->where('editorial_dimension_id', $dimension->id)->orderBy('id')->get() as $value) {
$pillar = $this->pillarFor($value);
if (is_string($pillar)) {
$report['unresolved'][] = ['art' => 'Wert', 'wert_id' => (int) $value->id, 'wert' => $value->label, 'kennung' => $value->slug, 'grund' => $pillar];
$report['mapping'][] = ['wert_id' => (int) $value->id, 'wert' => $value->label, 'saeule_id' => null, 'status' => 'offen'];
continue;
}
$resolved[(int) $value->id] = (int) $pillar->id;
$status = $value->pillar_id === null ? 'zugeordnet' : 'bereits zugeordnet';
$hint = $value->label !== $pillar->name ? 'über Kennung zugeordnet, Bezeichnung weicht ab („'.$pillar->name.'“)' : null;
$report['mapping'][] = ['wert_id' => (int) $value->id, 'wert' => $value->label, 'saeule_id' => (int) $pillar->id, 'saeule' => $pillar->name, 'status' => $status, 'hinweis' => $hint];
if ($value->pillar_id === null && ! $dryRun) {
DB::table('editorial_dimension_values')->where('id', $value->id)->update(['pillar_id' => $pillar->id]);
}
}
$subjectTypes = $this->subjectTypes();
foreach (DB::table('identity_dimension_values')
->whereIn('editorial_dimension_value_id', DB::table('editorial_dimension_values')->where('editorial_dimension_id', $dimension->id)->select('id'))
->orderBy('id')->get() as $row) {
$valueId = (int) $row->editorial_dimension_value_id;
$label = DB::table('editorial_dimension_values')->where('id', $valueId)->value('label');
$target = $subjectTypes[$row->subject_type] ?? null;
if ($target === 'content_element') {
$report['mirror']['element_rows']++;
continue;
}
$where = ['art' => 'Zuordnung', 'zuordnung_id' => (int) $row->id, 'wert_id' => $valueId, 'wert' => $label, 'objektart' => $row->subject_type, 'objekt_id' => (int) $row->subject_id, 'herkunft' => $row->origin];
if ($target === null) {
$report['unresolved'][] = $where + ['grund' => 'unbekannte Objektart'];
continue;
}
if ($row->origin !== 'direkt') {
$report['unresolved'][] = $where + ['grund' => 'abgeleitete Zuordnung (wird nicht als direkte übernommen)'];
continue;
}
if (! isset($resolved[$valueId])) {
$report['unresolved'][] = $where + ['grund' => 'Wert ohne belastbare Säule'];
continue;
}
$config = self::TARGETS[$target];
if (! DB::table($config['subjects'])->where('id', $row->subject_id)->exists()) {
$report['unresolved'][] = $where + ['grund' => 'Objekt nicht mehr vorhanden'];
continue;
}
$present = DB::table($config['table'])->where($config['column'], $row->subject_id)->where('pillar_id', $resolved[$valueId])->exists();
if ($present) {
$report['already'][$target]++;
continue;
}
if (! $dryRun) {
DB::table($config['table'])->insertOrIgnore([$config['column'] => $row->subject_id, 'pillar_id' => $resolved[$valueId]]);
}
$report['copied'][$target]++;
}
$report['mirror'] = array_merge($report['mirror'], $this->mirrorDivergence($dimension->id, $resolved));
$report['after'] = $dryRun ? $report['before'] : $this->counts();
return $report;
}
/**
* @param array<string, mixed> $report
* @return list<string>
*/
public static function lines(array $report, bool $dryRun = false): array
{
$names = ['composition' => 'Module und Programme', 'license_article' => 'Lizenzartikel'];
$lines = [$dryRun ? 'Probelauf, es wird nichts geschrieben.' : 'Übernahme abgeschlossen.', ''];
foreach ($report['mapping'] as $row) {
$lines[] = sprintf('Wert %d „%s“ → %s%s', $row['wert_id'], $row['wert'], $row['saeule_id'] === null ? 'keine Säule (offen)' : 'Säule '.$row['saeule_id'].' „'.($row['saeule'] ?? '').'“ ('.$row['status'].')', ! empty($row['hinweis']) ? ' – '.$row['hinweis'] : '');
}
$lines[] = '';
foreach ($names as $key => $label) {
$lines[] = sprintf('%s: %d übernommen, %d bereits vorhanden, Zuordnungen vorher %d, nachher %d', $label, $report['copied'][$key], $report['already'][$key], $report['before'][$key], $report['after'][$key]);
}
$lines[] = sprintf('Medien (nur Information): %d gespiegelte Zeilen, %d nicht mehr in der Medienzuordnung, %d nur dort. Maßgeblich bleibt die Medienzuordnung.', $report['mirror']['element_rows'], $report['mirror']['missing_in_pivot'], $report['mirror']['only_in_pivot']);
if ($report['unresolved'] === []) {
$lines[] = 'Keine ungeklärten Fälle.';
} else {
$lines[] = '';
$lines[] = 'Ungeklärt, bitte entscheiden (nichts wurde geändert):';
foreach ($report['unresolved'] as $row) {
$lines[] = '- '.json_encode($row, JSON_UNESCAPED_UNICODE);
}
}
return $lines;
}
/**
* Die Säule zu einem alten Wert, oder der Grund, warum es keine belastbare gibt.
*/
private function pillarFor(object $value): object|string
{
if (preg_match('/^pfeiler-(\d+)$/', (string) $value->slug, $match) !== 1) {
return 'Kennung ist nicht „pfeiler-<Nummer>“, keine belastbare Verknüpfung';
}
$pillar = DB::table('pillars')->where('id', (int) $match[1])->first();
if ($pillar === null) {
return 'Die Säule zur Kennung existiert nicht mehr';
}
if ($value->pillar_id !== null && (int) $value->pillar_id !== (int) $pillar->id) {
return 'Gespeicherte Verknüpfung (Säule '.$value->pillar_id.') und Kennung (Säule '.$pillar->id.') widersprechen sich';
}
if ($pillar->created_at !== null && $value->created_at !== null && $pillar->created_at > $value->created_at) {
return 'Die Säule ist jünger als der Wert; die Kennung kann nicht aus ihr entstanden sein';
}
return $pillar;
}
/**
* @return array<string, string> Objektart wie gespeichert => Ziel
*/
private function subjectTypes(): array
{
$types = [];
foreach ([
'composition' => [Composition::class],
'license_article' => [LicenseArticle::class],
'content_element' => [ContentElement::class],
] as $target => $classes) {
foreach ($classes as $class) {
$types[$class] = $target;
$types[(new $class)->getMorphClass()] = $target;
}
}
return $types;
}
/**
* @return array<string, int>
*/
private function counts(): array
{
return [
'composition' => DB::table('composition_pillar')->count(),
'license_article' => DB::table('license_article_pillar')->count(),
];
}
/**
* @param array<int, int> $resolved
* @return array{missing_in_pivot: int, only_in_pivot: int}
*/
private function mirrorDivergence(int $dimensionId, array $resolved): array
{
$mirrored = [];
foreach (DB::table('identity_dimension_values')
->whereIn('subject_type', array_unique([ContentElement::class, (new ContentElement)->getMorphClass()]))
->whereIn('editorial_dimension_value_id', array_keys($resolved) ?: [0])
->get() as $row) {
$mirrored[$row->subject_id.':'.$resolved[(int) $row->editorial_dimension_value_id]] = true;
}
$pivot = [];
foreach (DB::table('content_element_pillar')->get() as $row) {
$pivot[$row->content_element_id.':'.$row->pillar_id] = true;
}
return [
'missing_in_pivot' => count(array_diff_key($mirrored, $pivot)),
'only_in_pivot' => count(array_diff_key($pivot, $mirrored)),
];
}
}
+7
View File
@@ -4,6 +4,7 @@
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
class LicenseArticle extends Model
@@ -49,4 +50,10 @@ public function editorialContentKind(): BelongsTo
{
return $this->belongsTo(EditorialContentKind::class);
}
/** Direkt zugeordnete fachliche Säulen (zentrale Säulenverwaltung). */
public function pillars(): BelongsToMany
{
return $this->belongsToMany(Pillar::class)->orderBy('pillars.sort_order')->orderBy('pillars.name');
}
}
+15
View File
@@ -3,14 +3,29 @@
namespace App\Domain\Catalog;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Offer extends Model
{
protected $fillable = [
'name',
'composition_id',
'option_label',
];
/** Komposition, deren öffentliche Seite die Produktseite dieser Lizenzoption ist. */
public function composition(): BelongsTo
{
return $this->belongsTo(Composition::class);
}
/** Bezeichnung der Option auf der Produktseite. */
public function optionName(): string
{
return filled($this->option_label) ? (string) $this->option_label : (string) $this->name;
}
public function versions(): HasMany
{
return $this->hasMany(OfferVersion::class);
+51
View File
@@ -22,6 +22,23 @@ public function currentActiveVersion(Offer $offer): OfferVersion
return $version;
}
/**
* Die aktive, als Kauf angebotene Fassung mit Preis; sonst null (nicht kaufbar, zurückgezogen oder kostenlos).
*/
public function purchasableVersion(Offer $offer): ?OfferVersion
{
$version = $offer->versions()
->where('status', OfferStatus::Aktiv)
->orderByDesc('number')
->first();
if ($version === null || $version->grant_kind !== 'kauf' || $version->price_cents === null) {
return null;
}
return $version;
}
/**
* @param array<string, mixed> $capabilities
* @param array<string, mixed> $options
@@ -138,6 +155,40 @@ public function activate(Offer $offer, array $lines, array $attributes = []): Of
});
}
/**
* Zieht die Option aus dem Verkauf zurück: Die aktive Fassung wird beendet und bleibt gespeichert. Bereits
* begründete Berechtigungen und Bestellungen ändern sich nicht; offene Warenkörbe zeigen die Position als
* zurückgezogen und blockieren den Abschluss, bis der Käufer sie entfernt.
*/
public function end(Offer $offer): OfferVersion
{
return DB::transaction(function () use ($offer): OfferVersion {
$offer = Offer::query()->lockForUpdate()->findOrFail($offer->id);
$version = $this->currentActiveVersion($offer);
$version->status = OfferStatus::Beendet;
$version->save();
return $version;
});
}
/**
* 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
{
if ($compositionId !== null) {
Composition::query()->findOrFail($compositionId);
}
$offer->composition_id = $compositionId;
$offer->option_label = filled($optionLabel) ? trim((string) $optionLabel) : null;
$offer->save();
return $offer;
}
/**
* @return list<int>
*/
+10
View File
@@ -34,6 +34,16 @@ public function pages(): BelongsToMany
return $this->belongsToMany(Page::class);
}
public function compositions(): BelongsToMany
{
return $this->belongsToMany(Composition::class);
}
public function licenseArticles(): BelongsToMany
{
return $this->belongsToMany(LicenseArticle::class);
}
/**
* @param Builder<Pillar> $query
* @return Builder<Pillar>
+31
View File
@@ -0,0 +1,31 @@
<?php
namespace App\Domain\Catalog;
use Illuminate\Support\Facades\DB;
/**
* Alte Filteradressen: Vor der Vereinheitlichung war „Fachliche Säule“ ein Wert der redaktionellen Einordnung
* (`?einordnung=…`, `?pillar=…`, `dimension[]=…`). Verweist ein solcher Wert über `pillar_id` auf eine zentrale Säule,
* gilt der Filter jetzt für diese Säule, statt stillschweigend zu entfallen.
*/
final class PillarFilterCompat
{
/**
* @return int|null|false Kennung der Säule; null: alter Säulenwert ohne belastbare Verknüpfung; false: kein Säulenwert
*/
public static function pillarOfLegacyValue(int $valueId): int|false|null
{
$row = DB::table('editorial_dimension_values')
->join('editorial_dimensions', 'editorial_dimensions.id', '=', 'editorial_dimension_values.editorial_dimension_id')
->where('editorial_dimension_values.id', $valueId)
->where('editorial_dimensions.slug', EditorialDimension::PILLAR_SLUG)
->first(['editorial_dimension_values.pillar_id']);
if ($row === null) {
return false;
}
return $row->pillar_id === null ? null : (int) $row->pillar_id;
}
}
+42 -6
View File
@@ -40,19 +40,55 @@ public function present(Pillar $pillar, string $name, string $slug, ?string $sum
public function delete(Pillar $pillar): void
{
if ($pillar->elements()->exists() || $pillar->pages()->exists()) {
throw new DomainRuleException('Eine Säule mit zugeordneten Medien oder Seiten wird nicht gelöscht.');
$usage = $this->usage($pillar);
if (array_sum($usage) > 0) {
throw new DomainRuleException('Eine Säule mit zugeordneten Objekten wird nicht gelöscht ('.$this->usageText($usage).'). Ordnen Sie sie zuerst anders zu.');
}
$pillar->delete();
}
/**
* @param list<int> $pillarIds
* Zuordnungen je Objektart: Medien, Module und Programme, Lizenzartikel, Seiten.
*
* @return array{medien: int, zusammenstellungen: int, lizenzartikel: int, seiten: int}
*/
public function assign(ContentElement $element, array $pillarIds): void
public function usage(Pillar $pillar): array
{
$element->pillars()->sync($this->ids($pillarIds));
return [
'medien' => $pillar->elements()->count(),
'zusammenstellungen' => $pillar->compositions()->count(),
'lizenzartikel' => $pillar->licenseArticles()->count(),
'seiten' => $pillar->pages()->count(),
];
}
/**
* @param array{medien: int, zusammenstellungen: int, lizenzartikel: int, seiten: int} $usage
*/
public function usageText(array $usage): string
{
$parts = [];
foreach (['medien' => ['Medium', 'Medien'], 'zusammenstellungen' => ['Modul oder Programm', 'Module und Programme'], 'lizenzartikel' => ['Lizenzartikel', 'Lizenzartikel'], 'seiten' => ['Seite', 'Seiten']] as $key => [$one, $many]) {
if ($usage[$key] > 0) {
$parts[] = $usage[$key].' '.($usage[$key] === 1 ? $one : $many);
}
}
return $parts === [] ? 'nirgends zugeordnet' : implode(', ', $parts);
}
/**
* Ordnet einem Medium, Modul, Programm, Lizenzartikel oder einer Seite Säulen zu. Alle Objektarten verwenden
* dieselbe zentrale Säule und dieselbe Speicherregel; die Zuordnung ersetzt die bisherige vollständig.
*
* @param list<int|string> $pillarIds
*/
public function assign(ContentElement|Composition|LicenseArticle|Page $subject, array $pillarIds): void
{
$subject->pillars()->sync($this->ids($pillarIds));
}
/**
@@ -60,7 +96,7 @@ public function assign(ContentElement $element, array $pillarIds): void
*/
public function assignPages(Page $page, array $pillarIds): void
{
$page->pillars()->sync($this->ids($pillarIds));
$this->assign($page, $pillarIds);
}
/**
+32 -15
View File
@@ -15,6 +15,8 @@
* Redaktionsvorschau (Route editorial.card, nur für angemeldete Redaktion); öffentlich nie ausgegeben, weil es
* keine Freigabe für die Website hat.
* - missing: was für eine vollständige Karte fehlt, als Hinweis nur in der Redaktionsvorschau.
* - texts: die zentralen Texte des Fachobjekts, aus denen die Karte einen wählen kann (teaser, summary, description).
* summary bleibt der Text der Vorgabe („Automatisch“); texts wird nur gelesen, wenn die Redaktion einen wählt.
*/
final readonly class CardSubject
{
@@ -36,24 +38,39 @@ public function __construct(
public ?string $previewImage = null,
public array $missing = [],
public ?string $style = null,
public array $texts = [],
) {}
public function withText(?string $title, ?string $summary): self
{
return new self(
title: $title ?? $this->title,
summary: $summary ?? $this->summary,
kind: $this->kind,
badge: $this->badge,
meta: $this->meta,
url: $this->url,
public: $this->public,
notice: $this->notice,
visual: $this->visual,
visualLabel: $this->visualLabel,
previewImage: $this->previewImage,
missing: $this->missing,
style: $this->style,
);
return $this->copy(['title' => $title ?? $this->title, 'summary' => $summary ?? $this->summary]);
}
/**
* Text der Karte aus einem zentralen Text des Fachobjekts. Ist er nicht gepflegt, bleibt die Karte ohne Text
* (kein stiller Ersatz aus einem anderen Feld); in der Redaktionsvorschau steht dann ein Hinweis.
*/
public function withTextChoice(string $field, string $missingHint): self
{
if (! array_key_exists($field, $this->texts)) {
return $this;
}
$text = $this->texts[$field];
$missing = array_values(array_filter($this->missing, fn (string $hint): bool => ! str_contains($hint, 'Kurzbeschreibung')));
if ($text === null) {
$missing[] = $missingHint;
}
return $this->copy(['summary' => $text, 'missing' => $missing]);
}
/**
* @param array<string, mixed> $changes
*/
private function copy(array $changes): self
{
return new self(...array_merge(get_object_vars($this), $changes));
}
}
@@ -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,
);
}
@@ -20,10 +20,13 @@
* öffentlich, mit Verweis auf diese Programmseite, und nur mit bereitgestellter Fassung. Traineranleitungen erscheinen
* nie öffentlich (vertraulich für Trainerinnen und Trainer).
*
* Öffentlich gelesen werden Anzeigetitel (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart und Ausgabeart. Nie:
* Beschreibung, Einsatzhinweis, Lizenzvermerk, Dateien, Lehrtexte, Ausgabeadressen. Das Vorschaubild (Filmstandbild)
* der Bibliothek ist nicht für die Website freigegeben; es erscheint nur in der Redaktionsvorschau.
* Eine Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei.
* Ö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 höchstens den für die Website freigegebenen Trailer ab (CardClip), bietet keinen Download und gibt kein Medium frei.
*/
class PublicMaterialReader
{
@@ -124,7 +127,7 @@ public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?
$shown = clone $element;
foreach (['working_title', 'display_title', 'summary', 'thumbnail_path', 'thumbnail_alt'] as $field) {
foreach (['working_title', 'display_title', 'teaser', 'summary', 'description', 'thumbnail_path', 'thumbnail_alt'] as $field) {
if (! array_key_exists($field, $draft)) {
continue;
}
@@ -146,6 +149,18 @@ public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?
$summary = trim((string) $shown->teaser);
}
$texts = [];
foreach (['teaser', 'summary', 'description'] as $field) {
$own = filled($shown->getAttribute($field)) ? trim((string) $shown->getAttribute($field)) : null;
if (! array_key_exists($field, $draft) && $profile->origin($field) === 'variante') {
$own = $profile->value($field);
}
$texts[$field] = $own;
}
$title = (string) ($shown->display_title ?: $shown->working_title);
if (! array_key_exists('display_title', $draft) && $profile->origin('display_title') === 'variante') {
@@ -184,6 +199,7 @@ public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?
previewImage: $previewImage,
missing: $missing,
style: $film ? 'media' : 'material',
texts: $texts,
);
}
@@ -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];
}
}
@@ -127,6 +127,10 @@ public function url(mixed $value, bool $preview = false): ?string
$legacy = self::normalize($value);
if (is_string($legacy) && WebsiteMediaAlias::isRetired($legacy)) {
return null;
}
return is_string($legacy) ? PublicMedia::url($legacy) : null;
}
@@ -175,6 +179,10 @@ public function status(mixed $value): ?array
$id = $this->elementId($value);
if ($id === null && WebsiteMediaAlias::isRetired($value)) {
return ['public' => false, 'state' => 'missing', 'title' => basename((string) $value), 'note' => 'Das Medium wurde gelöscht.', 'thumb' => null, 'manageUrl' => null];
}
if ($id === null) {
return [
'public' => true,
@@ -7,12 +7,17 @@
use App\Domain\Cms\Catalog\CardSubject;
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
{
@@ -28,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
@@ -53,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 und Kurzbeschreibung pflegen Sie im Medium.';
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“.';
}
protected function searchSubjects(?string $term): array
@@ -90,6 +95,69 @@ protected function cardStyle(): string
return 'media';
}
/**
* Bei einem Film: das Vorschaubild des Films oder eine Stelle des Films als Kartenbild übernehmen. Das Bild wird
* einmal als Bild-Medium abgelegt (FilmStill) und wie jedes andere Bild ausgewählt; die Karte liest nur diese Datei.
*/
protected function imageSourceFields(): array
{
return [
ViewField::make('_filmbild')
->label('Bild aus dem Film')
->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'));
$stills = app(FilmStill::class);
$version = $film instanceof ContentElement ? $stills->version($film) : null;
return [
'film' => $film,
'filmTitle' => $film instanceof ContentElement ? (string) ($film->display_title ?: $film->working_title) : '',
'filmVersionId' => $version?->id,
'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
{
$element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null;
return $element instanceof ContentElement && app(FilmStill::class)->refusal($element) === null ? $element : null;
}
protected function subjectNoun(): string
{
return 'Medium';
}
protected function textChoices(): array
{
return [
'auto' => 'Automatisch (Kurzbeschreibung, sonst Teaser)',
'teaser' => 'Teaser',
'summary' => 'Kurzbeschreibung',
'description' => 'Ausführliche Beschreibung (erscheint öffentlich)',
];
}
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,16 +4,19 @@
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;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Cms\Widgets\WidgetErrors;
use App\Domain\Cms\Widgets\WidgetType;
use Filament\Forms\Components\Field;
use Filament\Forms\Components\Select;
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;
/**
@@ -56,6 +59,56 @@ abstract protected function defaultActionLabel(): string;
/** Gestaltungsvariante des Kits: editorial, media oder catalog. */
abstract protected function cardStyle(): string;
/**
* Weitere Wege zum Kartenbild im Reiter „Medien“, zum Beispiel ein Bild aus dem Film. Standard: keine.
*
* @return list<Field>
*/
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.
*
* @return array<string, string>
*/
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';
@@ -110,7 +163,9 @@ public function optionIcons(): array
public function settings(): array
{
return [
$choices = $this->textChoices();
return ($choices === [] ? [] : ['text_source' => $choices]) + ($this->supportsClip() ? ['clip' => ['yes' => 'Abspielen', 'no' => 'Nicht abspielen']] : []) + [
'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'],
@@ -124,10 +179,12 @@ public function settings(): array
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.'],
'clip' => ['Trailer auf der Karte', 'Spielt den freigegebenen Trailer stumm ab, solange die Maus auf der Karte steht; am Handy mit Tippen auf das Bild, per Tastatur über die Schaltfläche am Bild. 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.'],
'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' => ['Kurzbeschreibung', 'Aus den Fachdaten. Vorgabe: anzeigen.'],
'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.'],
@@ -195,13 +252,13 @@ public function editorSchema(): array
->hintColor(fn (?string $state): string => filled($state) ? 'warning' : 'gray')
->helperText('Leer übernimmt den Anzeigenamen des Fachobjekts. Eine Eintragung gilt nur für diese Karte und ändert die Quelle nicht.'),
TextInput::make('summary')
->label('Teaser nur für diese Karte')
->label('Text nur für diese Karte')
->maxLength(500)
->live(onBlur: true)
->placeholder(fn (Get $get): string => $this->centralText($get('../refs.'.$this->refKey()), 'summary') ?? 'Zentraler Teaser oder Kurzbeschreibung')
->placeholder(fn (Get $get): string => $this->centralText($get('../refs.'.$this->refKey()), 'summary', $get('../settings.text_source')) ?? 'Zentraler Text aus der Redaktion')
->hint(fn (?string $state): string => filled($state) ? 'Eigene Angabe für diese Karte' : 'Aus der Redaktion')
->hintColor(fn (?string $state): string => filled($state) ? 'warning' : 'gray')
->helperText('Leer übernimmt Teaser oder Kurzbeschreibung. Lehrinhalt, Rechte und Preise bleiben unberührt.'),
->helperText('Leer übernimmt den Text, den „Text der Karte“ (Darstellung) wählt. Lehrinhalt, Rechte und Preise bleiben unberührt.'),
])->statePath('data'),
];
}
@@ -211,7 +268,7 @@ public function mediaSchema(): array
[, , $alt, $focusX, $focusY] = $this->dataFields();
return [
Group::make(ImageRefFields::fields('Kartenbild', live: true))->statePath('refs'),
Group::make([...ImageRefFields::fields('Kartenbild', live: true), ...$this->imageSourceFields()])->statePath('refs'),
Group::make([$alt, $focusX, $focusY])->statePath('data'),
];
}
@@ -248,6 +305,12 @@ public function resolve(array $widget, RenderContext $context): array
$data = $widget['data'];
$subject = $this->subject($widget['refs'][$this->refKey()] ?? null, $context);
$textSource = $option('text_source', 'auto');
if ($subject instanceof CardSubject && $textSource !== 'auto' && isset($this->textChoices()[$textSource])) {
$subject = $subject->withTextChoice($textSource, $this->missingTextHint($textSource));
}
$heading = filled($data['heading'] ?? null) ? trim((string) $data['heading']) : null;
$lead = filled($data['summary'] ?? null) ? trim((string) $data['summary']) : null;
@@ -258,8 +321,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),
@@ -299,10 +370,15 @@ 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.
*/
private function centralText(mixed $id, string $field): ?string
private function centralText(mixed $id, string $field, mixed $textSource = null): ?string
{
if (blank($id)) {
return null;
@@ -314,6 +390,10 @@ private function centralText(mixed $id, string $field): ?string
return null;
}
if ($subject instanceof CardSubject && is_string($textSource) && isset($this->textChoices()[$textSource]) && $textSource !== 'auto') {
$subject = $subject->withTextChoice($textSource, $this->missingTextHint($textSource));
}
$text = $subject?->{$field};
return is_string($text) && trim($text) !== '' ? Str::limit(trim($text), 120) : null;
@@ -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;
+244
View File
@@ -0,0 +1,244 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Identity\Party;
use App\Domain\Identity\PartyType;
use App\Models\User;
/**
* Sitzungsgebundener Mehrangebotswarenkorb (Etappe 1). Er bleibt in derselben Browsersitzung über Anmeldung,
* Registrierung und E-Mail-Bestätigung erhalten. Je Option gibt es genau eine Position. Optionen derselben Produktseite
* (gleiche Komposition) sind Alternativen und werden nur nach ausdrücklichem Wechsel ersetzt.
* Der Warenkorb reserviert weder Preis noch Konditionen; er merkt sich, was der Käufer gesehen hat.
*/
class Cart
{
public const KEY = 'shop.cart';
public const ADDED = 'added';
public const PRESENT = 'present';
public const ALTERNATIVE = 'alternative';
public const UNAVAILABLE = 'unavailable';
public function __construct(
private readonly OwnershipCheck $ownership,
private readonly OrderHolders $holders,
private readonly OfferService $offers,
) {}
/**
* @return array<int, array{version_id: int, price_cents: int}>
*/
public function items(): array
{
return (array) session()->get(self::KEY, []);
}
public function count(): int
{
return count($this->items());
}
public function has(Offer $offer): bool
{
return isset($this->items()[$offer->id]);
}
/**
* Die bereits enthaltene Alternative derselben Produktseite, falls vorhanden.
*/
public function alternativeTo(Offer $offer): ?Offer
{
if ($offer->composition_id === null) {
return null;
}
$ids = array_diff(array_keys($this->items()), [$offer->id]);
return $ids === [] ? null : Offer::query()
->whereIn('id', $ids)
->where('composition_id', $offer->composition_id)
->first();
}
public function add(Offer $offer): string
{
$version = $this->purchasable($offer);
if ($version === null) {
return self::UNAVAILABLE;
}
if ($this->has($offer)) {
return self::PRESENT;
}
if ($this->alternativeTo($offer) !== null) {
return self::ALTERNATIVE;
}
$this->put($offer, $version);
return self::ADDED;
}
/**
* Ausdrücklicher Wechsel: die Alternative wird durch die gewählte Option ersetzt.
*/
public function switchTo(Offer $offer): bool
{
$version = $this->purchasable($offer);
if ($version === null) {
return false;
}
$alternative = $this->alternativeTo($offer);
if ($alternative !== null) {
$this->remove($alternative);
}
$this->put($offer, $version);
return true;
}
public function remove(Offer $offer): void
{
$items = $this->items();
unset($items[$offer->id]);
session()->put(self::KEY, $items);
}
/**
* Der Käufer übernimmt Preis und Fassung, die der Shop jetzt zeigt.
*/
public function acceptCurrent(Offer $offer): void
{
$version = $this->purchasable($offer);
if ($version !== null && $this->has($offer)) {
$this->put($offer, $version);
}
}
public function clear(): void
{
session()->forget(self::KEY);
}
/**
* Serverseitige Prüfung: aktuelle Fassung, Preis, Kaufbarkeit, passende Inhaberart, vorhandene Rechte.
*/
public function review(?User $user = null, ?int $holderPartyId = null): CartReview
{
$offers = Offer::query()
->whereIn('id', array_keys($this->items()))
->with('composition')
->get()
->keyBy('id');
$versions = [];
foreach ($this->items() as $offerId => $item) {
$offer = $offers->get($offerId);
if ($offer !== null) {
$versions[$offerId] = $this->purchasable($offer);
}
}
$holder = $user === null ? null : $this->holderFor($user, $holderPartyId, $versions);
$lines = [];
foreach ($this->items() as $offerId => $item) {
$offer = $offers->get($offerId);
if ($offer === null) {
continue;
}
$version = $versions[$offerId] ?? null;
$seen = (int) $item['price_cents'];
if ($version === null) {
$lines[] = new CartLine($offer, null, CartLine::WITHDRAWN, $seen, null,
'Diese Option ist nicht mehr erhältlich. Entferne sie, um mit den übrigen Positionen fortzufahren.');
continue;
}
$current = (int) $version->price_cents;
if ($holder !== null && ! $this->suitsHolder($version, $holder)) {
$lines[] = new CartLine($offer, $version, CartLine::WRONG_HOLDER, $seen, $current,
$version->holder_kind === 'organisation'
? 'Diese Option ist für Organisationen. Bestelle als Verein oder entferne sie.'
: 'Diese Option ist für Privatpersonen. Bestelle als Privatperson oder entferne sie.');
continue;
}
if ($holder !== null && $this->ownership->covers($holder, $version)) {
$lines[] = new CartLine($offer, $version, CartLine::OWNED, $seen, $current);
continue;
}
if ($current !== $seen) {
$lines[] = new CartLine($offer, $version, CartLine::PRICE_CHANGED, $seen, $current);
} elseif ((int) $item['version_id'] !== $version->id) {
$lines[] = new CartLine($offer, $version, CartLine::TERMS_CHANGED, $seen, $current,
'Die Bedingungen dieser Option wurden aktualisiert. Bitte prüfe die Übersicht.');
} else {
$lines[] = new CartLine($offer, $version, CartLine::OK, $seen, $current);
}
}
return new CartReview($lines, $holder);
}
/**
* Die aktive, als Kauf angebotene Fassung der Option; sonst null (nicht kaufbar oder zurückgezogen).
*/
public function purchasable(Offer $offer): ?OfferVersion
{
return $this->offers->purchasableVersion($offer);
}
private function put(Offer $offer, OfferVersion $version): void
{
$items = $this->items();
$items[$offer->id] = ['version_id' => $version->id, 'price_cents' => (int) $version->price_cents];
session()->put(self::KEY, $items);
}
/**
* @param array<int, OfferVersion|null> $versions
*/
private function holderFor(User $user, ?int $partyId, array $versions): ?Party
{
$onlyOrganisations = $versions !== [] && collect($versions)
->filter()
->every(fn (OfferVersion $version): bool => $version->holder_kind === 'organisation');
try {
return $this->holders->resolve($user, $partyId, $onlyOrganisations);
} catch (DomainRuleException) {
return null;
}
}
private function suitsHolder(OfferVersion $version, Party $holder): bool
{
return ($version->holder_kind === 'organisation') === ($holder->type === PartyType::Organisation);
}
}
+54
View File
@@ -0,0 +1,54 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferVersion;
/**
* Eine Position des Warenkorbs mit dem Ergebnis der serverseitigen Prüfung.
*/
final class CartLine
{
public const OK = 'ok';
public const PRICE_CHANGED = 'preis_geaendert';
public const TERMS_CHANGED = 'bedingungen_geaendert';
public const WITHDRAWN = 'zurueckgezogen';
public const OWNED = 'bereits_erworben';
public const WRONG_HOLDER = 'falscher_inhaber';
public function __construct(
public readonly Offer $offer,
public readonly ?OfferVersion $version,
public readonly string $state,
public readonly int $seenPriceCents,
public readonly ?int $currentPriceCents,
public readonly ?string $note = null,
) {}
/** Geht in Summe und Bestellung ein. */
public function orderable(): bool
{
return in_array($this->state, [self::OK, self::PRICE_CHANGED, self::TERMS_CHANGED], true);
}
/** Verhindert den Abschluss, bis der Käufer die Position selbst entfernt oder den Inhaber wechselt. */
public function blocks(): bool
{
return in_array($this->state, [self::WITHDRAWN, self::WRONG_HOLDER], true);
}
public function title(): string
{
$composition = $this->offer->composition;
return $composition !== null
? (string) ($composition->display_title ?: $composition->designation)
: (string) $this->offer->name;
}
}
+65
View File
@@ -0,0 +1,65 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Identity\Party;
/**
* Prüfergebnis des Warenkorbs für einen vorgesehenen Lizenzinhaber. Die Prüfsumme bindet die Bestellung an genau
* diese Übersicht: Inhaber, Fassung und Preis jeder Position samt Zustand, auch der ausgeschlossenen.
*/
final class CartReview
{
/**
* @param list<CartLine> $lines
*/
public function __construct(
public readonly array $lines,
public readonly ?Party $holder,
) {}
/** @return list<CartLine> */
public function orderable(): array
{
return array_values(array_filter($this->lines, fn (CartLine $line): bool => $line->orderable()));
}
public function totalCents(): int
{
return array_sum(array_map(fn (CartLine $line): int => (int) $line->currentPriceCents, $this->orderable()));
}
public function blocked(): bool
{
foreach ($this->lines as $line) {
if ($line->blocks()) {
return true;
}
}
return false;
}
public function empty(): bool
{
return $this->orderable() === [];
}
public function canOrder(): bool
{
return $this->holder !== null && ! $this->blocked() && ! $this->empty();
}
public function digest(): string
{
$parts = [];
foreach ($this->lines as $line) {
$parts[] = $line->offer->id.':'.($line->version?->id ?? 0).':'.$line->currentPriceCents.':'.$line->state;
}
sort($parts);
return hash('sha256', ($this->holder?->id ?? 0).'|'.implode(',', $parts));
}
}
+102 -28
View File
@@ -5,11 +5,13 @@
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferVersion;
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\Mail\OrderConfirmed;
use App\Models\User;
use Illuminate\Support\Facades\DB;
@@ -20,13 +22,15 @@ class Checkout
public function __construct(
private readonly GrantIssuer $grants,
private readonly OfferService $offers,
private readonly OrderHolders $holders,
) {}
/**
* Einzelkauf einer Option als Person (bestehender Weg, ohne Warenkorb).
*/
public function place(User $user, Offer $offer): Order
{
if ($user->status !== AccountStatus::Aktiv || $user->party_id === null) {
throw new DomainRuleException('Nur ein aktives Mitglied kann kaufen.');
}
$this->assertActive($user);
$version = $this->offers->currentActiveVersion($offer);
@@ -38,20 +42,78 @@ public function place(User $user, Offer $offer): Order
throw new DomainRuleException('Der Kauf braucht einen Preis an der Angebotsfassung.');
}
return DB::transaction(function () use ($user, $offer, $version): Order {
$order = Order::query()->create([
'user_id' => $user->id,
'party_id' => $user->party_id,
'status' => 'offen',
'holder_kind' => 'person',
]);
$holder = $this->holders->resolve($user, null);
return DB::transaction(fn (): Order => $this->createOrder($user, $holder, [[$offer, $version]]));
}
/**
* Bestellung aus dem Warenkorb, erst nach serverseitiger Prüfung. Die Prüfsumme bindet die Bestellung an die
* Übersicht, die der Käufer gesehen hat: Hat sich Preis, Fassung oder Bedingung seither geändert, entsteht keine
* 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
{
$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.
Offer::query()->whereIn('id', array_keys($cart->items()))->orderBy('id')->lockForUpdate()->get();
$review = $cart->review($user, $holderPartyId);
if ($review->holder === null) {
throw new DomainRuleException('Für diesen Lizenzinhaber ist das Konto nicht bestellberechtigt.');
}
if (! hash_equals($review->digest(), $digest)) {
throw new StaleOverview('Die Übersicht hat sich geändert. Bitte prüfe die aktualisierte Bestellübersicht.');
}
if ($review->blocked()) {
throw new DomainRuleException('Entferne zuerst die Positionen, die nicht bestellt werden können.');
}
if ($review->empty()) {
throw new DomainRuleException('Es gibt nichts zu bestellen. Alle Positionen sind bereits erworben.');
}
$pairs = array_map(fn (CartLine $line): array => [$line->offer, $line->version], $review->orderable());
return $this->createOrder($user, $review->holder, $pairs);
});
$cart->clear();
return $order;
}
/**
* @param list<array{0: Offer, 1: OfferVersion}> $pairs
*/
private function createOrder(User $user, Party $holder, array $pairs): Order
{
$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)),
'currency' => 'EUR',
]);
foreach ($pairs as [$offer, $version]) {
$line = $order->lines()->create([
'offer_version_id' => $version->id,
'offer_name' => $offer->name,
'price_cents' => $version->price_cents,
'currency' => 'EUR',
'term_rule' => $version->term_rule,
'update_promise' => $version->update_promise,
'holder_kind' => $version->holder_kind,
'tax_class' => $version->tax_class,
'grant_kind' => $version->grant_kind,
'holder_party_id' => $holder->id,
]);
$version->load('resolvedScopes.rights');
@@ -66,11 +128,15 @@ public function place(User $user, Offer $offer): Order
],
]);
}
}
return $order->load('lines.scopeItems');
});
return $order->load('lines.scopeItems');
}
/**
* Freischaltung nach bestätigter Testzahlung: alle Bestellpositionen aus ihrem festgehaltenen Umfang, in einer
* Transaktion. Wiederholte Bestätigung ist wirkungslos; ein Fehler hinterlässt weder Zahlung noch Rechte.
*/
public function confirmTestPayment(Order $order, string $reference): Order
{
$this->assertTestDriver();
@@ -100,14 +166,12 @@ public function confirmTestPayment(Order $order, string $reference): Order
$order->status = 'bezahlt';
$order->save();
$paidNow = true;
$line = $order->lines()->firstOrFail();
$this->grants->issue(
$order->user,
$line->offerVersion,
AcquisitionType::Bestellposition,
'order_line',
$line->id,
);
$actor = User::query()->findOrFail($order->user_id);
foreach ($order->lines()->orderBy('id')->get() as $line) {
$holder = Party::query()->findOrFail($line->holder_party_id ?? $order->party_id);
$this->grants->issueFromOrderLine($line, $holder, $actor);
}
return $order->load('lines', 'payments');
});
@@ -142,6 +206,10 @@ 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.
*/
public function refund(Order $order, string $reason): Order
{
$reason = trim($reason);
@@ -157,15 +225,14 @@ public function refund(Order $order, string $reason): Order
throw new DomainRuleException('Nur eine bezahlte Bestellung kann erstattet werden.');
}
$line = $order->lines()->firstOrFail();
$acquisition = Acquisition::query()->where([
'type' => AcquisitionType::Bestellposition,
'reference_type' => 'order_line',
'reference_id' => $line->id,
])->first();
foreach ($order->lines()->orderBy('id')->get() as $line) {
$acquisition = Acquisition::query()->where([
'type' => AcquisitionType::Bestellposition,
'reference_type' => 'order_line',
'reference_id' => $line->id,
])->first();
if ($acquisition !== null) {
foreach ($acquisition->grants as $grant) {
foreach ($acquisition?->grants ?? [] as $grant) {
if ($grant->status === GrantStatus::Aktiv) {
$grant->status = GrantStatus::Widerrufen;
$grant->status_reason = $reason;
@@ -182,6 +249,13 @@ public function refund(Order $order, string $reason): Order
});
}
private function assertActive(User $user): void
{
if ($user->status !== AccountStatus::Aktiv || $user->party_id === null) {
throw new DomainRuleException('Nur ein aktives Mitglied kann kaufen.');
}
}
private function assertTestDriver(): void
{
if (app()->isProduction() || config('services.payment.driver') !== 'test') {
+56
View File
@@ -0,0 +1,56 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\DomainRuleException;
/**
* Beträge werden als ganze Cent gespeichert und in Euro angezeigt und eingegeben (deutsches Format).
*/
final class Money
{
/** Obergrenze eines Preises (1.000.000 €), weit unter dem Wertebereich der Datenbank. */
public const MAX_CENTS = 100_000_000;
public static function format(?int $cents): string
{
return $cents === null ? '–' : number_format($cents / 100, 2, ',', '.').' €';
}
/**
* Euro-Eingabe („12,50“, „1.299“, „5“) als Cent. Leere Eingabe ergibt null.
*/
public static function parse(string|int|float|null $input): ?int
{
if ($input === null) {
return null;
}
$text = trim((string) $input);
if ($text === '') {
return null;
}
$text = str_replace([' ', '€'], '', $text);
if (str_contains($text, ',')) {
$text = str_replace('.', '', $text);
$text = str_replace(',', '.', $text);
} elseif (preg_match('/^\d{1,3}(\.\d{3})+$/', $text) === 1) {
$text = str_replace('.', '', $text);
}
if (preg_match('/^\d+(\.\d{1,2})?$/', $text) !== 1) {
throw new DomainRuleException('Der Preis ist kein gültiger Eurobetrag, zum Beispiel 12,50.');
}
$cents = (int) round(((float) $text) * 100);
if ($cents > self::MAX_CENTS) {
throw new DomainRuleException('Der Preis ist zu hoch. Zulässig sind höchstens '.self::format(self::MAX_CENTS).'.');
}
return $cents;
}
}
+2
View File
@@ -15,6 +15,8 @@ class Order extends Model
'party_id',
'status',
'holder_kind',
'total_cents',
'currency',
];
public function user(): BelongsTo
+75
View File
@@ -0,0 +1,75 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Identity\Membership;
use App\Domain\Identity\Party;
use App\Domain\Identity\PartyType;
use App\Models\User;
use Illuminate\Support\Collection;
/**
* Für wen ein Konto bestellen darf: für sich selbst (Person) und für Organisationen, bei denen es eine aktive
* Mitgliedschaft mit Bestellberechtigung hat. Eine Bestellung hat genau einen Lizenzinhaber.
*/
class OrderHolders
{
/**
* @return Collection<int, Party>
*/
public function for(User $user): Collection
{
$holders = collect();
if ($user->party_id !== null) {
$person = Party::query()->find($user->party_id);
if ($person !== null) {
$holders->push($person);
}
}
$organisations = Membership::query()
->active()
->where('user_id', $user->id)
->where('may_order', true)
->with('organisation')
->orderBy('id')
->get()
->map(fn (Membership $membership): ?Party => $membership->organisation)
->filter(fn (?Party $party): bool => $party !== null && $party->type === PartyType::Organisation);
return $holders->concat($organisations)->values();
}
/**
* Der gewählte Inhaber; ohne Wahl die Person, bei Angeboten nur für Organisationen die erste Organisation.
*/
public function resolve(User $user, ?int $partyId, bool $preferOrganisation = false): Party
{
$holders = $this->for($user);
if ($partyId !== null) {
$chosen = $holders->first(fn (Party $party): bool => $party->id === $partyId);
if ($chosen === null) {
throw new DomainRuleException('Für diesen Lizenzinhaber ist das Konto nicht bestellberechtigt.');
}
return $chosen;
}
if ($preferOrganisation) {
$organisation = $holders->first(fn (Party $party): bool => $party->type === PartyType::Organisation);
if ($organisation !== null) {
return $organisation;
}
}
$person = $holders->first(fn (Party $party): bool => $party->type === PartyType::Person);
return $person ?? throw new DomainRuleException('Nur ein aktives Mitglied kann kaufen.');
}
}
+10
View File
@@ -3,6 +3,7 @@
namespace App\Domain\Commerce;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Identity\Party;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
@@ -17,6 +18,10 @@ class OrderLine extends Model
'term_rule',
'update_promise',
'holder_kind',
'currency',
'tax_class',
'grant_kind',
'holder_party_id',
];
public function order(): BelongsTo
@@ -24,6 +29,11 @@ public function order(): BelongsTo
return $this->belongsTo(Order::class);
}
public function holder(): BelongsTo
{
return $this->belongsTo(Party::class, 'holder_party_id');
}
public function offerVersion(): BelongsTo
{
return $this->belongsTo(OfferVersion::class);
+94
View File
@@ -0,0 +1,94 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Entitlement\Grant;
use App\Domain\Entitlement\GrantStatus;
use App\Domain\Identity\Party;
/**
* „Bereits erworben“ (FACH-59): Der vorgesehene Lizenzinhaber hat bereits eine gültige Lizenz mit demselben Umfang
* und denselben Nutzungsrechten. Maßgeblich ist genau ein Erwerb, der jeden Umfangsposten der Angebotsfassung mit
* gleichem Zweck, gleichen Fähigkeiten und gleichen Optionen trägt. Rechte mehrerer Erwerbe werden nicht zu einer
* neuen Lizenz kombiniert. Alle Erwerbsarten zählen (Kauf, freier Abruf, manuelle Vergabe), sofern aktiv und gültig.
*/
class OwnershipCheck
{
public function covers(Party $holder, OfferVersion $version): bool
{
$needed = $this->needed($version);
if ($needed === []) {
return false;
}
$now = now();
$byAcquisition = Grant::query()
->where('status', GrantStatus::Aktiv)
->whereHas('acquisition', fn ($query) => $query->where('party_id', $holder->id))
->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');
foreach ($byAcquisition as $grants) {
$have = [];
foreach ($grants as $grant) {
$have[$grant->license_article_id.'|'.$this->fingerprint($grant->rights_snapshot ?? [])] = true;
}
if (array_diff_key($needed, $have) === []) {
return true;
}
}
return false;
}
/**
* @return array<string, true>
*/
private function needed(OfferVersion $version): array
{
$needed = [];
$version->loadMissing('resolvedScopes.rights');
foreach ($version->resolvedScopes as $scope) {
$needed[$scope->license_article_id.'|'.$this->fingerprint([
'purpose' => $scope->rights->purpose,
'capabilities' => $scope->rights->capabilities,
'options' => $scope->rights->options ?? [],
])] = true;
}
return $needed;
}
/**
* Reihenfolge von Schlüsseln und Aktionen spielt keine Rolle.
*
* @param array<string, mixed> $rights
*/
private function fingerprint(array $rights): string
{
$capabilities = [];
foreach ((array) ($rights['capabilities'] ?? []) as $class => $actions) {
$actions = array_values(array_unique((array) $actions));
sort($actions);
$capabilities[(string) $class] = $actions;
}
ksort($capabilities);
$options = (array) ($rights['options'] ?? []);
ksort($options);
return md5(json_encode([
'purpose' => (string) ($rights['purpose'] ?? ''),
'capabilities' => $capabilities,
'options' => $options,
], JSON_THROW_ON_ERROR));
}
}
+139
View File
@@ -0,0 +1,139 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\EditorialProfileReader;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferVersion;
use App\Filament\Support\CatalogLabels;
/**
* Kaufbare Lizenzoptionen einer Produktseite aus dem veröffentlichten Katalog: aktive Angebotsfassungen mit Preis,
* Eignung, Laufzeit, Umfang und Nutzungsrechten. Die Seite selbst (Titel, Beschreibung, Struktur) kommt aus der
* zur Anzeige freigegebenen Komposition; hier entsteht kein zweiter Text.
*/
class ProductOptions
{
public function __construct(private readonly OfferService $offers) {}
/**
* @return list<array<string, mixed>>
*/
public function forComposition(Composition $composition): array
{
$options = [];
foreach (Offer::query()->where('composition_id', $composition->id)->orderBy('id')->get() as $offer) {
$version = $this->offers->purchasableVersion($offer);
if ($version !== null) {
$options[] = $this->describe($offer, $version);
}
}
return $options;
}
/**
* Zeilen für Shop-Suche und Kacheln: je Komposition die günstigste Option.
*
* @return array<int, array{from_cents: int, count: int}>
*/
public function summaries(): array
{
$summary = [];
foreach (Offer::query()->whereNotNull('composition_id')->orderBy('id')->get() as $offer) {
$version = $this->offers->purchasableVersion($offer);
if ($version === null) {
continue;
}
$current = $summary[$offer->composition_id] ?? ['from_cents' => PHP_INT_MAX, 'count' => 0];
$summary[$offer->composition_id] = [
'from_cents' => min($current['from_cents'], (int) $version->price_cents),
'count' => $current['count'] + 1,
];
}
return $summary;
}
/**
* @return array<string, mixed>
*/
public function describe(Offer $offer, OfferVersion $version): array
{
$version->loadMissing('resolvedScopes.article', 'resolvedScopes.rights');
$scope = [];
foreach ($version->resolvedScopes as $item) {
$faehigkeiten = CatalogLabels::faehigkeiten($item->rights?->capabilities);
$scope[] = [
'article' => $this->articleTitle($item->article),
'purpose' => CatalogLabels::zweck($item->rights?->purpose),
'rights' => $faehigkeiten,
];
}
return [
'offer' => $offer,
'version' => $version,
'name' => $offer->optionName(),
'price_cents' => (int) $version->price_cents,
'price' => Money::format((int) $version->price_cents),
'for' => $version->holder_kind === 'organisation' ? 'Organisationen und Vereine' : 'Privatpersonen',
'holder_kind' => $version->holder_kind,
'term' => self::termLabel($version),
'scope' => $scope,
];
}
public static function termLabel(OfferVersion $version): string
{
return match ($version->term_rule) {
'dauerhaft' => 'Dauerhaft nutzbar',
'befristet' => 'Befristet',
'solange_angebot_aktiv' => 'Solange das Angebot aktiv ist',
'periodisch' => 'Laufend, periodisch',
default => (string) $version->term_rule,
};
}
public function articleTitle(?LicenseArticle $article): string
{
if ($article === null) {
return '–';
}
return $this->articleName($article) ?: (string) $article->code;
}
/**
* Name wie in der Redaktion: eigener Name, sonst der Name des Inhalts (Anzeigename, Arbeitstitel oder
* Bezeichnung), sonst der eigene Arbeitstitel; leer, wenn nichts davon vorhanden ist.
*/
public function articleName(LicenseArticle $article): string
{
$profile = app(EditorialProfileReader::class)->read($article, 'detail');
$source = $profile->source;
$candidates = [
$profile->value('display_title'),
$article->working_title,
$source?->getAttribute('working_title'),
$source?->getAttribute('designation'),
];
foreach ($candidates as $candidate) {
if (filled($candidate)) {
return trim((string) $candidate);
}
}
return '';
}
}
+16
View File
@@ -0,0 +1,16 @@
<?php
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.
*/
final class Shop
{
public static function enabled(): bool
{
return ! app()->isProduction() && config('services.payment.driver') === 'test';
}
}
+11
View File
@@ -0,0 +1,11 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\DomainRuleException;
/**
* Preis oder bindende Bedingungen haben sich nach Anzeige der Bestellübersicht geändert. Es entsteht keine
* Bestellung; der Käufer sieht zuerst die aktualisierte Übersicht (FACH-59).
*/
class StaleOverview extends DomainRuleException {}
+1
View File
@@ -19,6 +19,7 @@ class Acquisition extends Model
'reference_type',
'reference_id',
'conditions',
'acting_user_id',
];
protected function casts(): array
+1 -1
View File
@@ -47,7 +47,7 @@ public function __invoke(
$candidates = Grant::query()
->where('license_article_id', $article->id)
->where('status', GrantStatus::Aktiv)
->whereHas('acquisition', fn ($query) => $query->where('party_id', $user->party_id))
->usableBy($user)
->get()
->filter(function (Grant $grant) use ($now): bool {
if ($grant->valid_from !== null && $grant->valid_from->greaterThan($now)) {
+29
View File
@@ -5,6 +5,9 @@
use App\Domain\Catalog\ArticleRelease;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\RightsProfileVersion;
use App\Domain\Identity\Membership;
use App\Models\User;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
@@ -32,6 +35,32 @@ protected function casts(): array
];
}
/**
* Berechtigungen, die ein Konto nutzen darf (zentrale Regel für Entscheidung, Bibliothek und Vorschaubilder):
* - persönliche Erwerbe: Inhaber ist die Person des Kontos;
* - Erwerbe einer Organisation: nur das auslösende Konto und nur, solange seine Mitgliedschaft mit
* Bestellberechtigung besteht (Etappe 1, Domänenmodell 04; Sitzpools folgen mit A4).
*
* @param Builder<Grant> $query
* @return Builder<Grant>
*/
public function scopeUsableBy(Builder $query, User $user): Builder
{
return $query->whereHas('acquisition', function (Builder $acquisition) use ($user): void {
$acquisition->where(function (Builder $either) use ($user): void {
$either->where('party_id', $user->party_id)
->orWhere(function (Builder $organisation) use ($user): void {
$organisation->where('acting_user_id', $user->id)
->whereIn('party_id', Membership::query()
->active()
->where('user_id', $user->id)
->where('may_order', true)
->select('party_id'));
});
});
});
}
public function acquisition(): BelongsTo
{
return $this->belongsTo(Acquisition::class);
+52
View File
@@ -7,6 +7,8 @@
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferStatus;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Commerce\OrderLine;
use App\Domain\Identity\Party;
use App\Models\User;
use Illuminate\Support\Facades\DB;
@@ -69,6 +71,56 @@ public function grantManually(User $user, Offer $offer, User $actor, string $rea
});
}
/**
* Freischaltung einer bezahlten Bestellposition aus deren festgehaltenem Umfang (Umfangskopie und Bedingungen der
* Position, nicht aus der Angebotsfassung). Inhaber ist der Lizenzinhaber der Position, das auslösende Konto wird
* am Erwerb festgehalten. Wiederholsicher: je Bestellposition genau ein Erwerb.
*/
public function issueFromOrderLine(OrderLine $line, Party $holder, User $actor): Acquisition
{
return DB::transaction(function () use ($line, $holder, $actor): Acquisition {
$existing = Acquisition::query()->where([
'party_id' => $holder->id,
'type' => AcquisitionType::Bestellposition,
'reference_type' => 'order_line',
'reference_id' => $line->id,
])->first();
if ($existing !== null) {
return $existing->load('grants');
}
$acquisition = Acquisition::query()->create([
'party_id' => $holder->id,
'type' => AcquisitionType::Bestellposition,
'reference_type' => 'order_line',
'reference_id' => $line->id,
'acting_user_id' => $actor->id,
'conditions' => [
'term_rule' => $line->term_rule,
'update_promise' => $line->update_promise,
'holder_kind' => $line->holder_kind,
'offer_version_id' => $line->offer_version_id,
],
]);
$line->loadMissing('scopeItems.article');
foreach ($line->scopeItems as $item) {
$acquisition->grants()->create([
'license_article_id' => $item->license_article_id,
'rights_profile_version_id' => $item->rights_profile_version_id,
'rights_snapshot' => $item->rights_snapshot,
'release_at_grant_id' => $item->article?->current_release_id,
'status' => GrantStatus::Aktiv,
'valid_from' => now(),
]);
}
return $acquisition->load('grants');
});
}
public function issue(
User $user,
OfferVersion $version,
+52
View File
@@ -0,0 +1,52 @@
<?php
namespace App\Domain\Identity;
use App\Models\User;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Mitgliedschaft eines Kontos in einer Organisation (Domänenmodell 04, MEMBERSHIP). Etappe 1 nutzt sie für die
* Bestellberechtigung: Ein Konto bestellt nur für eine Organisation, bei der eine aktive Mitgliedschaft mit
* `may_order` besteht. Sitzpools und Selbstverwaltung folgen mit A4.
*/
class Membership extends Model
{
protected $fillable = [
'user_id',
'party_id',
'role',
'may_order',
'valid_from',
'valid_until',
];
protected function casts(): array
{
return [
'may_order' => 'boolean',
'valid_from' => 'date',
'valid_until' => 'date',
];
}
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
public function organisation(): BelongsTo
{
return $this->belongsTo(Party::class, 'party_id');
}
/** Mitgliedschaften, die heute gelten. */
public function scopeActive(Builder $query): Builder
{
return $query
->where(fn (Builder $inner) => $inner->whereNull('valid_from')->orWhereDate('valid_from', '<=', now()))
->where(fn (Builder $inner) => $inner->whereNull('valid_until')->orWhereDate('valid_until', '>=', now()));
}
}
+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');
}
}
+213
View File
@@ -0,0 +1,213 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentElementVersion;
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Models\User;
use Illuminate\Database\QueryException;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
/**
* Legt ein Bild aus einem Film als gewöhnliches Bild-Medium im Medienmanager ab (Medien- und Materialkarte).
*
* - 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
* es frei). Seitenaufrufe lesen nur die gespeicherte Datei und starten nie ffmpeg.
* - Dieselbe Stelle (oder dieselbe Vorschaudatei) ergibt dasselbe Medium (film_still_sources).
* - Es wird nie der Film selbst, nur ein Einzelbild bis 1600 px Breite abgelegt. Traineranleitungen und
* archivierte oder gesperrte Filme sind ausgeschlossen. Eine Rechte- oder Lizenzentscheidung entsteht nicht.
*/
class FilmStill
{
/** Breite eines übernommenen Standbilds; die kleine Filmstufe (640 px) wäre auf der Website sichtbar unscharf. */
public const WIDTH = 1600;
/** Wahr, wenn der letzte Aufruf ein schon vorhandenes Bild geliefert hat (keine neue Extraktion). */
public bool $reused = false;
public function __construct(
private readonly ThumbnailDeriver $deriver,
private readonly WebsiteIntake $intake,
) {}
/** Grund, warum aus diesem Medium kein Standbild übernommen wird, sonst null. */
public function refusal(ContentElement $film): ?string
{
if ($film->output_class !== 'film') {
return 'Nur aus einem Film lässt sich ein Bild übernehmen.';
}
if ($film->archived_at !== null) {
return 'Der Film ist archiviert.';
}
$slug = $film->editorialContentKind?->slug;
if (in_array($slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true)) {
return 'Aus Traineranleitungen werden keine Bilder für die Website übernommen.';
}
return null;
}
/** Die bereitgestellte Fassung, aus der Stellen gezogen werden (die höchste). */
public function version(ContentElement $film): ?ContentElementVersion
{
return $film->versions()
->where('status', ContentVersionStatus::Bereit->value)
->orderByDesc('number')
->first();
}
/** Sekunde der Stelle, aus der das aktuelle Vorschaubild des Films stammt, sonst null. */
public function thumbnailSecond(ContentElement $film): ?string
{
$source = $film->thumbnail_source;
return is_string($source) && preg_match('/^frame:\d+@([\d.]+)$/', $source, $match) === 1 ? $match[1] : null;
}
public function fromSecond(ContentElement $film, float $seconds, ?User $actor = null): ContentElement
{
$this->reused = false;
$this->guard($film);
if ($seconds < 0 || $seconds > 7200) {
throw new DomainRuleException('Die Zeitposition liegt außerhalb des Films.');
}
$version = $this->version($film);
if (! $version instanceof ContentElementVersion) {
throw new DomainRuleException('Der Film hat noch keine bereitgestellte Fassung.');
}
return $this->fromFrame($film, $version, $seconds, $actor);
}
public function fromThumbnail(ContentElement $film, ?User $actor = null): ContentElement
{
$this->reused = false;
$this->guard($film);
// Stammt das Vorschaubild aus einer Filmstelle, wird dieselbe Stelle in voller Auflösung gezogen.
$second = $this->thumbnailSecond($film);
if ($second !== null && preg_match('/^frame:(\d+)@/', (string) $film->thumbnail_source, $match) === 1) {
$version = ContentElementVersion::query()->find((int) $match[1]);
if ($version instanceof ContentElementVersion
&& (int) $version->content_element_id === (int) $film->id
&& $version->status !== ContentVersionStatus::Gesperrt) {
try {
return $this->fromFrame($film, $version, (float) $second, $actor);
} catch (DomainRuleException) {
// Die Stelle lässt sich nicht mehr ziehen: das gespeicherte Vorschaubild selbst übernehmen.
}
}
}
$path = $film->thumbnail_path;
if (! is_string($path) || ! str_starts_with($path, 'vorschau/') || str_contains($path, '..') || ! Storage::disk('media_derived')->exists($path)) {
throw new DomainRuleException('Dieser Film hat noch kein Vorschaubild. Setzen Sie es im Medienmanager oder wählen Sie eine Stelle.');
}
$bytes = Storage::disk('media_derived')->get($path);
if (! is_string($bytes) || $bytes === '') {
throw new DomainRuleException('Das Vorschaubild ließ sich nicht lesen.');
}
$key = 'file:'.hash('sha256', $bytes);
$existing = $this->existing($film, $key);
if ($existing instanceof ContentElement) {
$this->reused = true;
return $existing;
}
return $this->store($film, $key, $bytes, 'Vorschaubild', $actor);
}
private function fromFrame(ContentElement $film, ContentElementVersion $version, float $seconds, ?User $actor): ContentElement
{
$second = $this->secondText($seconds);
$key = 'frame:'.$version->id.'@'.$second;
$existing = $this->existing($film, $key);
if ($existing instanceof ContentElement) {
$this->reused = true;
return $existing;
}
$bytes = $this->deriver->frameJpeg($version, (float) $second, self::WIDTH, original: true);
if (! is_string($bytes)) {
throw new DomainRuleException('Aus dieser Filmstelle ließ sich kein Bild erzeugen.');
}
return $this->store($film, $key, $bytes, 'Fassung '.$version->number.', '.str_replace('.', ',', $second).' s', $actor);
}
private function guard(ContentElement $film): void
{
$refusal = $this->refusal($film);
if ($refusal !== null) {
throw new DomainRuleException($refusal);
}
}
private function existing(ContentElement $film, string $key): ?ContentElement
{
$source = FilmStillSource::query()->with('still')->where('film_element_id', $film->id)->where('source_key', $key)->first();
$still = $source?->still;
// Ein archiviertes oder an der Verarbeitung gescheitertes Bild wird nicht wiederverwendet; die Stelle kann neu
// übernommen werden (store() ordnet dann das neue Bild zu).
return $still instanceof ContentElement && $still->archived_at === null && ! filled($still->thumbnail_error) ? $still : null;
}
private function store(ContentElement $film, string $key, string $bytes, string $label, ?User $actor): ContentElement
{
$title = (string) ($film->display_title ?: $film->working_title);
$path = 'cms/standbild-'.$film->id.'-'.Str::lower(Str::random(8)).'.jpg';
Storage::disk('cms_incoming')->put($path, $bytes);
$still = $this->intake->acceptImage(
$path,
'Standbild: '.$title.' ('.$label.')',
filled($film->website_credit) ? (string) $film->website_credit : null,
'Szene aus dem Film „'.$title.'“',
$actor,
);
try {
FilmStillSource::query()->updateOrCreate(
['film_element_id' => $film->id, 'source_key' => $key],
['still_element_id' => $still->id, 'actor_id' => $actor?->id],
);
} catch (QueryException) {
// Gleichzeitige Übernahme derselben Stelle: das zuerst angelegte Bild gilt.
return $this->existing($film, $key) ?? $still;
}
return $still;
}
private function secondText(float $seconds): string
{
$text = number_format(max(0, min(7200, $seconds)), 3, '.', '');
return rtrim(rtrim($text, '0'), '.') ?: '0';
}
}
+26
View File
@@ -0,0 +1,26 @@
<?php
namespace App\Domain\Media;
use App\Domain\Catalog\ContentElement;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Herkunft eines Standbilds: aus welchem Film und welcher Stelle (frame:{Fassung}@{Sekunde}) oder aus welcher Datei
* (file:{SHA-256}) das Bild-Medium stammt.
*/
class FilmStillSource extends Model
{
protected $fillable = ['film_element_id', 'still_element_id', 'source_key', 'actor_id'];
public function film(): BelongsTo
{
return $this->belongsTo(ContentElement::class, 'film_element_id');
}
public function still(): BelongsTo
{
return $this->belongsTo(ContentElement::class, 'still_element_id');
}
}
+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.');
}
}
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));
$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.');
}
$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
+27 -3
View File
@@ -138,8 +138,20 @@ public function forCompositionFrame(Composition $composition, ContentElementVers
$this->rememberChoice($composition, 'frame:'.$version->id.'@'.$this->secondText($seconds));
}
public function frameInput(ContentElementVersion $version): ?string
/**
* Datei, aus der ein Bild gezogen wird. Vorgabe: die kleine Filmstufe (schnell, für die Vorschau). Mit $original
* zuerst die Mediendatei selbst, damit ein übernommenes Standbild nicht aus der kleinen Stufe hochgerechnet wird.
*/
public function frameInput(ContentElementVersion $version, bool $original = false): ?string
{
if ($original) {
$master = is_array($version->metadata) ? ($version->metadata['file'] ?? null) : null;
if ($this->readableDerived($master, 'inhalte/')) {
return $master;
}
}
$proxy = MediaRendition::query()
->where('content_element_version_id', $version->id)
->where('role', 'variant')
@@ -155,13 +167,25 @@ public function frameInput(ContentElementVersion $version): ?string
return $this->readableDerived($file, 'inhalte/') ? $file : null;
}
/**
* Einzelbild einer Filmstelle als JPEG, 640 px breit aus der kleinen Stufe (Vorschau im Editor und Vorschaubild).
*/
public function jpegAtVersion(ContentElementVersion $version, float $seconds): ?string
{
return $this->frameJpeg($version, $seconds);
}
/**
* Einzelbild einer Filmstelle als JPEG. Ein übernommenes Standbild (FilmStill) wird mit $width und $original aus der
* Mediendatei gezogen statt aus der kleinen Stufe und dabei nie über die Breite der Quelle hinaus vergrößert.
*/
public function frameJpeg(ContentElementVersion $version, float $seconds, int $width = 640, bool $original = false): ?string
{
if ($seconds < 0 || $seconds > 7200) {
return null;
}
$file = $this->frameInput($version);
$file = $this->frameInput($version, $original);
if ($file === null) {
return null;
@@ -186,7 +210,7 @@ public function jpegAtVersion(ContentElementVersion $version, float $seconds): ?
'-frames:v',
'1',
'-vf',
'scale=640:-2',
$width === 640 ? 'scale=640:-2' : 'scale=min('.max(160, min(2400, $width)).'\,iw):-2',
'-f',
'image2pipe',
'-vcodec',
+10
View File
@@ -37,6 +37,16 @@ public static function effectiveFor(mixed $path): ?self
return $alias instanceof self && $alias->everReleased() ? $alias : null;
}
/**
* Früherer Pfad, dessen übernommenes Medium inzwischen gelöscht wurde. Die Datei unter cms/ bleibt liegen, wird aber
* weder ausgeliefert noch als Bild gezeigt: Das Löschen des Mediums gilt auch für die frühere Adresse.
*/
public static function isRetired(mixed $path): bool
{
return is_string($path) && $path !== ''
&& self::query()->where('legacy_path', $path)->whereNull('content_element_id')->exists();
}
public function everReleased(): bool
{
$element = $this->element;
+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;
@@ -11,6 +11,7 @@
use App\Filament\Resources\Bundles\BundleResource;
use App\Filament\Support\CatalogOptions;
use App\Filament\Support\CatalogReading;
use App\Filament\Support\PublicationReadiness;
use App\Filament\Support\ReportsDomainRules;
use Filament\Actions\Action;
use Filament\Forms\Components\CheckboxList;
@@ -90,7 +91,8 @@ public function publishAction(): Action
->modalSubmitActionLabel(fn (): string => 'Fassung '.$this->nextNumber().' veröffentlichen')
->fillForm(fn (): array => $this->formFromPublished())
->schema([
CheckboxList::make('articles')->label('Lizenzartikel')->options(fn (): array => CatalogOptions::articles()),
CheckboxList::make('articles')->label('Lizenzartikel')->options(fn (): array => app(PublicationReadiness::class)->articleOptions())
->helperText('Artikel ohne Stand lassen sich aufnehmen, aber erst verkaufen, wenn sie einen Inhalt haben.'),
CheckboxList::make('bundles')->label('Enthaltene Pakete')
->options(function (): array {
$options = CatalogOptions::bundles();
@@ -115,7 +117,12 @@ public function publishAction(): Action
$version = app(BundleService::class)->publish($bundle, $items);
return 'Fassung '.$version->number.' ist veröffentlicht.';
$bundle->unsetRelations();
$readiness = app(PublicationReadiness::class)->forBundle($bundle->refresh());
return 'Fassung '.$version->number.' ist veröffentlicht.'.($readiness['naechster'] !== null
? ' Nächster Schritt: '.$readiness['naechster']['titel'].'.'
: '');
}, 'Die Paketfassung ist veröffentlicht.');
$this->getRecord()->unsetRelations();
$this->getRecord()->refresh();
@@ -164,6 +171,7 @@ private function paketDaten(): array
'art' => 'primary',
]],
],
'voraussetzungen' => app(PublicationReadiness::class)->forBundle($bundle),
'haupt' => [
[
'titel' => 'Bestandteile',
@@ -22,6 +22,7 @@
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Cms\Widgets\RenderContext;
use App\Filament\Resources\ContentElements\ContentElementResource;
use App\Filament\Support\AssignsPillars;
use App\Filament\Support\EditorialCatalog;
use App\Filament\Support\ManagesEditorialSurface;
use App\Filament\Support\MediumForm;
@@ -43,6 +44,7 @@
abstract class EditComposition extends EditRecord
{
use AssignsPillars;
use ManagesEditorialSurface;
use WithFileUploads;
@@ -398,11 +400,15 @@ public function redaktionTexteHinweis(): string
*/
public function einordnungGruppen(): array
{
return array_map(fn (array $group): array => [
$groups = array_map(fn (array $group): array => [
'legend' => $group['label'],
'model' => 'dimensionIds',
'values' => $group['values'],
], $this->dimensionGroups());
$pillars = $this->pillarGroup();
return $pillars === null ? $groups : [$pillars, ...$groups];
}
/**
@@ -466,7 +472,7 @@ public function einordnungUnsaved(): bool
sort($stored);
sort($current);
return $stored !== $current;
return $stored !== $current || $this->pillarsUnsaved($record);
}
public function openText(): void
@@ -1654,6 +1660,7 @@ protected function fillRedaktion(): void
->pluck('editorial_dimension_value_id')
->map(fn (mixed $id): string => (string) (int) $id)
->all();
$this->loadPillarIds($composition);
}
/**
@@ -1913,6 +1920,7 @@ protected function persistRedaktion(): bool
'description' => $this->description,
], $this->actor());
$this->syncDimensions($record, array_map(intval(...), $this->dimensionIds));
$this->persistPillarIds($record);
$record->refresh();
$this->getRecord()->setRawAttributes($record->getAttributes());
@@ -3,6 +3,7 @@
namespace App\Filament\Resources\ContentElements\Pages;
use App\Domain\Catalog\EditorialVocabulary;
use App\Domain\Catalog\PillarFilterCompat;
use App\Filament\Resources\ContentElements\ContentElementResource;
use App\Filament\Support\Bestand;
use App\Filament\Support\MediaLibrary;
@@ -170,6 +171,11 @@ public function resetFilters(): void
*/
public function bestand(): array
{
// Alte Adressen mit einem Säulenwert der Einordnung gelten für die zentrale Säule.
if (ctype_digit($this->einordnung) && $this->saeule === '' && is_int($pillar = PillarFilterCompat::pillarOfLegacyValue((int) $this->einordnung))) {
[$this->saeule, $this->einordnung] = [(string) $pillar, ''];
}
$optionen = fn (array $liste, string $wert, string $label): array => collect($liste)
->mapWithKeys(fn (array $eintrag): array => [(string) $eintrag[$wert] => $eintrag[$label]])
->all();
@@ -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;
@@ -92,6 +93,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> */
@@ -844,6 +848,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);
@@ -7,6 +7,7 @@
use App\Filament\Resources\LicenseArticles\Pages\ListLicenseArticles;
use App\Filament\Resources\LicenseArticles\Pages\ViewLicenseArticle;
use App\Filament\Support\CatalogReading;
use App\Filament\Support\PublicationReadiness;
use App\Models\User;
use Filament\Facades\Filament;
use Filament\Resources\Resource;
@@ -57,6 +58,7 @@ public static function infolist(Schema $schema): Schema
->viewData(fn (LicenseArticle $record): array => [
'stand' => app(CatalogReading::class)->articleStand($record),
'kontext' => app(CatalogReading::class)->articleContext($record),
'voraussetzungen' => app(PublicationReadiness::class)->forArticle($record),
])
->columnSpanFull(),
]);
@@ -16,6 +16,7 @@
use App\Domain\Catalog\LicenseArticle;
use App\Filament\Resources\ContentElements\ContentElementResource;
use App\Filament\Resources\LicenseArticles\LicenseArticleResource;
use App\Filament\Support\AssignsPillars;
use App\Filament\Support\CatalogOptions;
use App\Filament\Support\EditorialCatalog;
use App\Filament\Support\ManagesEditorialSurface;
@@ -30,6 +31,7 @@
class ViewLicenseArticle extends ViewRecord
{
use AssignsPillars;
use ManagesEditorialSurface;
use ReportsDomainRules;
@@ -115,6 +117,7 @@ protected function saveRedaktionTexte(): bool
], auth()->user());
app(IdentityDimension::class)->replaceOffered($article, array_map(intval(...), $this->dimensionIds));
$this->persistPillarIds($article);
$article->refresh();
$this->fillLicenseEditorial();
@@ -159,7 +162,7 @@ public function einordnungUnsaved(): bool
sort($stored);
sort($current);
return $stored !== $current;
return $stored !== $current || $this->pillarsUnsaved($article);
}
/**
@@ -270,11 +273,15 @@ public function einordnungArt(): array
*/
public function einordnungGruppen(): array
{
return array_map(fn (array $group): array => [
$groups = array_map(fn (array $group): array => [
'legend' => $group['label'],
'model' => 'dimensionIds',
'values' => $group['values'],
], $this->licenseDimensionGroups());
$pillars = $this->pillarGroup();
return $pillars === null ? $groups : [$pillars, ...$groups];
}
private function sourceTitle(Model $source): string
@@ -312,6 +319,7 @@ private function fillLicenseEditorial(): void
->where('origin', 'direkt')
->pluck('editorial_dimension_value_id')
->all();
$this->loadPillarIds($article);
}
protected function getHeaderActions(): array
@@ -322,12 +330,28 @@ protected function getHeaderActions(): array
public function releaseAction(): Action
{
return Action::make('release')
->label('Stand veröffentlichen')
->label(fn (): string => $this->isFirstStand() ? 'Inhalt festlegen' : 'Neuen Stand veröffentlichen')
->modalHeading(fn (): string => $this->isFirstStand() ? 'Inhalt festlegen: ersten Stand veröffentlichen' : 'Neuen Stand veröffentlichen')
->modalDescription(fn (): string => $this->isFirstStand()
? 'Der Stand legt fest, welche Inhalte dieser Lizenzartikel lizenziert: der gewählte Inhalt samt allem, was er enthält. Er ist danach unveränderlich. Pakete und Angebote können den Artikel danach verwenden; verkauft wird er erst über ein Angebot.'
: 'Ein neuer Stand ersetzt den aktuellen für künftige Ausgaben. Bestehende Käufer erhalten ihn im Rahmen ihrer Lizenz; frühere Stände bleiben gespeichert.')
->modalSubmitActionLabel('Stand veröffentlichen')
->fillForm(fn (): array => $this->isFirstStand() ? ['classification' => 'Erster Stand dieses Lizenzartikels.'] : [])
->schema([
Select::make('root')->label('Wurzel')->options(fn (): array => CatalogOptions::readyTargets())->required(),
Textarea::make('classification')->label('Einordnung')->required()
->helperText('Warum dies derselbe Lizenzartikel bleibt und kein neues Produkt ist.'),
TextInput::make('change_note')->label('Änderungshinweis'),
Select::make('root')->label('Freigegebener Inhalt')
->options(fn (): array => CatalogOptions::assignmentTargets())
->searchable()
->required()
->helperText(fn (): string => CatalogOptions::assignmentTargets() === []
? 'Es gibt noch keinen freigegebenen Inhalt. Gib zuerst ein Medium, Modul oder Programm frei.'
: 'Medien, Module und Programme mit freigegebener Fassung. Bei Modulen und Programmen gehört alles Enthaltene zum Stand.'),
Textarea::make('classification')->label('Einordnung')
->required(fn (): bool => ! $this->isFirstStand())
->helperText(fn (): string => $this->isFirstStand()
? 'Beim ersten Stand genügt der vorgegebene Text.'
: 'Warum dies derselbe Lizenzartikel bleibt und kein neues Produkt ist.'),
TextInput::make('change_note')->label('Änderungshinweis')
->visible(fn (): bool => ! $this->isFirstStand()),
])
->action(function (array $data): void {
$this->report(function () use ($data): string {
@@ -340,7 +364,7 @@ public function releaseAction(): Action
$release = app(ArticleService::class)->publishRelease(
$article,
$root,
$data['classification'],
(string) ($data['classification'] ?? 'Erster Stand dieses Lizenzartikels.'),
$data['change_note'] ?? null,
);
$report = $release->impact_report ?? [];
@@ -375,6 +399,11 @@ public function withdrawAction(): Action
});
}
private function isFirstStand(): bool
{
return ! $this->getRecord()->releases()->exists();
}
private function refreshRecord(): void
{
$this->getRecord()->unsetRelations();
@@ -64,6 +64,7 @@ protected function catalogRows(): array
if ($active !== null) {
$chips[] = ['label' => 'Fassung '.$active->number.' aktiv', 'ton' => 'gut'];
$chips[] = ['label' => CatalogLabels::vergabe($active), 'ton' => 'neutral'];
$chips[] = ['label' => $active->holder_kind === 'organisation' ? 'Für Organisationen' : 'Für Privatpersonen', 'ton' => 'neutral'];
$zustand[] = 'aktiv';
$text = $active->lines->map(fn ($line): string => ($line->article !== null
? 'Lizenzartikel '.$line->article->code
+182 -26
View File
@@ -2,8 +2,11 @@
namespace App\Filament\Resources\Offers\Pages;
use App\Domain\Catalog\BundleService;
use App\Domain\Catalog\BundleVersion;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionVersion;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -11,9 +14,13 @@
use App\Domain\Catalog\OfferVersion;
use App\Domain\Catalog\RightsProfileVersion;
use App\Domain\Catalog\StatusValue;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\ProductOptions;
use App\Filament\Resources\Offers\OfferResource;
use App\Filament\Support\CatalogLabels;
use App\Filament\Support\CatalogOptions;
use App\Filament\Support\PublicationReadiness;
use App\Filament\Support\ReportsDomainRules;
use Filament\Actions\Action;
use Filament\Forms\Components\Repeater;
@@ -25,6 +32,7 @@
use Filament\Schemas\Schema;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Facades\DB;
/**
* Angebot im gemeinsamen Rahmen. Anlegen und Ändern nutzen dieselbe Maske (FACH-20): „Fassung aktivieren“ legt die
@@ -91,22 +99,34 @@ public function activateAction(): Action
return Action::make('activate')
->label(fn (): string => $this->activeVersion() !== null ? 'Geänderte Fassung aktivieren' : 'Fassung aktivieren')
->modalHeading(fn (): string => $this->activeVersion() !== null
? 'Angebot ändern: Fassung '.$this->nextNumber().' aktivieren'
: 'Erste Fassung aktivieren')
? 'Option „'.$this->getRecord()->optionName().'“ ändern: Fassung '.$this->nextNumber().' aktivieren'
: 'Option „'.$this->getRecord()->optionName().'“: erste Fassung aktivieren')
->modalDescription(fn (): string => ($active = $this->activeVersion()) !== null
? 'Die Maske ist mit Fassung '.$active->number.' vorbelegt; Inhaberart, Laufzeitregel und Steuerklasse werden übernommen. Beim Aktivieren wird Fassung '.$active->number.' beendet und bleibt unverändert gespeichert; neue Erwerbe nutzen Fassung '.$this->nextNumber().'. Bereits begründete Berechtigungen ändern sich dadurch nicht.'
: 'Positionen, Vergabe und Preis bilden die erste Fassung. Nach dem Aktivieren ist sie unveränderlich; Änderungen ergeben eine weitere Fassung.')
? 'Betroffen ist nur die Option „'.$this->getRecord()->optionName().'“'.$this->productPageSuffix().'. Die Maske ist mit Fassung '.$active->number.' vorbelegt. Erst „Fassung '.$this->nextNumber().' aktivieren“ schaltet die Änderung öffentlich (auch Bezeichnung und Produktseite, sie erzeugen ebenfalls eine neue Fassung und zeigen offenen Warenkörben „Bedingungen aktualisiert“): Fassung '.$active->number.' wird beendet und bleibt gespeichert, neue Käufe nutzen Fassung '.$this->nextNumber().'. Bereits begründete Berechtigungen und Bestellungen ändern sich nicht. Andere Optionen derselben Produktseite bleiben unverändert kaufbar. „Abbrechen“ verwirft die Eingaben.'
: 'Positionen, Vergabe, Eignung und Preis bilden die erste Fassung dieser Option. Erst das Aktivieren macht sie öffentlich; danach ist sie unveränderlich, Änderungen ergeben eine weitere Fassung.')
->modalSubmitActionLabel(fn (): string => 'Fassung '.$this->nextNumber().' aktivieren')
->modalWidth('4xl')
->fillForm(fn (): array => $this->formFromActive())
->schema([
TextInput::make('option_label')->label('Bezeichnung der Option')
->helperText('So heißt die Option auf der Produktseite, zum Beispiel „Einzellizenz für Privatpersonen“. Sie ist keine bindende Bedingung, wird aber wie die übrigen Angaben erst mit „Fassung aktivieren“ übernommen.')
->maxLength(120),
Select::make('composition_id')->label('Produktseite')
->options(fn (): array => $this->productPages())
->searchable()
->helperText('Optionen derselben Produktseite sind Alternativen; im Warenkorb liegt nur eine davon. Die Beschreibung der Seite wird zentral an der Komposition gepflegt. Die Zuordnung wird mit „Fassung aktivieren“ übernommen.'),
Select::make('holder_kind')->label('Geeignet für')->options([
'person' => 'Privatpersonen',
'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('grant_kind')->label('Vergabe')->options([
'kauf' => 'Kauf',
'auf_abruf' => 'Auf Abruf',
'bei_registrierung' => 'Bei Registrierung',
])->required(),
TextInput::make('price_cents')->label('Preis in Cent')->numeric()
->helperText('Nur bei einem Kauf. 500 bedeutet 5,00 €.'),
TextInput::make('price_euro')->label('Preis in Euro')->suffix('€')
->helperText('Nur bei einem Kauf, zum Beispiel 49,00.'),
Select::make('composition_version_id')->label('Programmfassung, die abgedeckt sein muss')
->options(function (): array {
return CompositionVersion::query()
@@ -124,9 +144,12 @@ public function activateAction(): Action
'article' => 'Lizenzartikel',
'bundle' => 'Paketfassung',
])->required()->live(),
Select::make('article_id')->label('Artikel')->options(fn (): array => CatalogOptions::articles())
Select::make('article_id')->label('Artikel')->options(fn (): array => app(PublicationReadiness::class)->articleOptions())
->searchable()
->helperText('Nur Artikel mit veröffentlichtem Stand lassen sich verkaufen. Artikel ohne Stand sind gekennzeichnet.')
->visible(fn (Get $get): bool => $get('kind') === 'article'),
Select::make('bundle_version_id')->label('Paketfassung')->options(fn (): array => CatalogOptions::bundleVersions())
Select::make('bundle_version_id')->label('Paketfassung')->options(fn (): array => app(PublicationReadiness::class)->bundleVersionOptions())
->searchable()
->visible(fn (Get $get): bool => $get('kind') === 'bundle'),
Select::make('rights_id')->label('Rechte')->options(fn (): array => CatalogOptions::rights())->required(),
])->minItems(1)->addActionLabel('Position hinzufügen'),
@@ -147,29 +170,117 @@ public function activateAction(): Action
];
}
// Bedingungen, die die Maske nicht zeigt, bleiben bei einer Änderung die der aktiven Fassung; ohne
// aktive Fassung gilt wie bisher die Vorgabe (Personen, dauerhaft).
// Voraussetzung: Jeder Artikel der Positionen hat einen veröffentlichten Stand, sonst erhielten Käufer nichts.
$articleIds = [];
foreach ($lines as $line) {
$target = $line['target'];
array_push($articleIds, ...($target instanceof BundleVersion ? app(BundleService::class)->articleIds($target) : [$target->id]));
}
$unusable = app(PublicationReadiness::class)->unusableArticles($articleIds);
if ($unusable !== []) {
throw new DomainRuleException(app(PublicationReadiness::class)->unusableMessage($unusable, 'das Angebot aktivierst'));
}
// Bedingungen, die die Maske nicht zeigt, bleiben bei einer Änderung die der aktiven Fassung.
$active = $this->activeVersion();
$kept = $active === null ? ['holder_kind' => 'person'] : [
'holder_kind' => $active->holder_kind,
$kept = $active === null ? [] : [
'term_rule' => $active->term_rule,
'tax_class' => $active->tax_class,
'dynamic' => (bool) $active->dynamic,
];
$version = app(OfferService::class)->activate($offer, $lines, [
...$kept,
'grant_kind' => $data['grant_kind'],
'price_cents' => $data['price_cents'] === null || $data['price_cents'] === '' ? null : (int) $data['price_cents'],
'composition_version_id' => filled($data['composition_version_id'] ?? null) ? (int) $data['composition_version_id'] : null,
]);
$price = Money::parse($data['price_euro'] ?? null);
return 'Fassung '.$version->number.' ist aktiv.';
if ($data['grant_kind'] === 'kauf' && ($price === null || $price <= 0)) {
throw new DomainRuleException('Ein Kauf braucht einen Preis über 0,00 €.');
}
$service = app(OfferService::class);
$version = DB::transaction(function () use ($service, $offer, $data, $lines, $kept, $price) {
$service->assignProduct(
$offer,
filled($data['composition_id'] ?? null) ? (int) $data['composition_id'] : null,
$data['option_label'] ?? null,
);
return $service->activate($offer, $lines, [
...$kept,
'holder_kind' => $data['holder_kind'],
'grant_kind' => $data['grant_kind'],
'price_cents' => $price,
'composition_version_id' => filled($data['composition_version_id'] ?? null) ? (int) $data['composition_version_id'] : null,
]);
});
$offer->unsetRelations();
$readiness = app(PublicationReadiness::class)->forOffer($offer->refresh());
return 'Fassung '.$version->number.' ist aktiv.'.($readiness['bereit']
? ' Die Option ist öffentlich kaufbar und im Shop auffindbar.'
: ' Noch nicht im Shop kaufbar. Nächster Schritt: '.$readiness['naechster']['titel'].'.');
}, 'Die Angebotsfassung ist aktiv.');
$this->getRecord()->unsetRelations();
$this->getRecord()->refresh();
});
}
/**
* Option aus dem Verkauf nehmen: nur die aktive Fassung dieser Option wird beendet.
*/
public function endAction(): Action
{
return Action::make('end')
->label('Aus dem Verkauf nehmen')
->color('danger')
->requiresConfirmation()
->modalHeading(fn (): string => 'Option „'.$this->getRecord()->optionName().'“ aus dem Verkauf nehmen?')
->modalDescription(fn (): string => 'Betroffen ist nur die Option „'.$this->getRecord()->optionName().'“'.$this->productPageSuffix().'. Die aktive Fassung wird beendet und bleibt gespeichert. Die Option ist danach nicht mehr kaufbar; in vorhandenen Warenkörben bleibt sie mit Hinweis sichtbar und blockiert den Abschluss, bis der Käufer sie entfernt. Bestehende Berechtigungen und Bestellungen ändern sich nicht. Andere Optionen derselben Produktseite bleiben kaufbar.')
->modalSubmitActionLabel('Aus dem Verkauf nehmen')
->visible(fn (): bool => $this->activeVersion() !== null)
->action(function (): void {
$this->report(function (): string {
$version = app(OfferService::class)->end($this->getRecord());
return 'Fassung '.$version->number.' ist beendet. Die Option ist nicht mehr kaufbar.';
}, 'Die Option ist aus dem Verkauf genommen.');
$this->getRecord()->unsetRelations();
$this->getRecord()->refresh();
});
}
/** „ der Produktseite „Titel““ oder leer, wenn die Option noch keiner Produktseite zugeordnet ist. */
private function productPageSuffix(): string
{
$page = $this->getRecord()->composition;
return $page === null ? '' : ' der Produktseite „'.($page->display_title ?: $page->designation).'“';
}
/**
* Produktseiten, die als Ziel wählbar sind: Kompositionen mit Bezeichnung und Art.
*
* @return array<int, string>
*/
private function productPages(): array
{
$catalog = app(PublicCatalogReader::class);
return Composition::query()
->with('editorialContentKind')
->whereNull('archived_at')
->orderBy('designation')
->get()
->sortBy(fn (Composition $composition): int => $catalog->shownVersion($composition) !== null ? 0 : 1)
->mapWithKeys(fn (Composition $composition): array => [
$composition->id => ($composition->display_title ?: $composition->designation)
.' ('.($composition->editorialContentKind?->label ?? 'Zusammenstellung').')'
.($catalog->shownVersion($composition) !== null ? ' · im Shop auffindbar' : ' · nicht öffentlich, im Shop nicht auffindbar'),
])
->all();
}
/**
* Vorbelegung aus der aktiven Fassung; ohne aktive Fassung eine leere Position.
*
@@ -178,14 +289,19 @@ public function activateAction(): Action
private function formFromActive(): array
{
$active = $this->activeVersion();
/** @var Offer $offer */
$offer = $this->getRecord();
$option = ['option_label' => $offer->option_label, 'composition_id' => $offer->composition_id];
if ($active === null) {
return ['grant_kind' => 'kauf', 'lines' => [['kind' => 'article']]];
return [...$option, 'holder_kind' => 'person', 'grant_kind' => 'kauf', 'lines' => [['kind' => 'article']]];
}
return [
...$option,
'holder_kind' => $active->holder_kind,
'grant_kind' => $active->grant_kind,
'price_cents' => $active->price_cents,
'price_euro' => $active->price_cents === null ? null : number_format($active->price_cents / 100, 2, ',', ''),
'lines' => $active->lines->sortBy('position')->map(fn ($line): array => [
'kind' => $line->license_article_id !== null ? 'article' : 'bundle',
'article_id' => $line->license_article_id,
@@ -220,13 +336,22 @@ private function angebotDaten(): array
'status' => $active !== null
? ['text' => 'Fassung '.$active->number.' aktiv · '.$vergabe, 'ton' => 'gut']
: ['text' => 'Noch keine aktive Fassung. Ein Angebot ohne aktive Fassung kann niemand erwerben.', 'ton' => 'offen'],
'aktionen' => [[
'label' => $active !== null ? 'Geänderte Fassung aktivieren' : 'Fassung aktivieren',
'wire' => "mountAction('activate')",
'art' => 'primary',
]],
'aktionen' => [
[
'label' => $active !== null ? 'Geänderte Fassung aktivieren' : 'Fassung aktivieren',
'wire' => "mountAction('activate')",
'art' => 'primary',
],
...($active !== null ? [[
'label' => 'Aus dem Verkauf nehmen',
'wire' => "mountAction('end')",
'art' => 'line',
]] : []),
],
],
'voraussetzungen' => app(PublicationReadiness::class)->forOffer($offer),
'haupt' => [
...($active !== null ? [$this->optionAbschnitt($offer, $active)] : []),
[
'titel' => 'Positionen',
'zusatz' => $active !== null ? 'Fassung '.$active->number : null,
@@ -261,6 +386,37 @@ private function angebotDaten(): array
];
}
/**
* Die Option auf einen Blick: Preis in Euro, Eignung, Rechte, zugrunde liegender Inhalt, Status und Produktseite.
*
* @return array<string, mixed>
*/
private function optionAbschnitt(Offer $offer, OfferVersion $active): array
{
$option = app(ProductOptions::class)->describe($offer, $active);
$inhalt = collect($option['scope'])->pluck('article')->unique()->implode(', ');
$rechte = collect($option['scope'])
->map(fn (array $item): string => $item['purpose'].($item['rights'] === [] ? '' : ': '.implode(', ', $item['rights'])))
->unique()
->implode('; ');
$seite = $offer->composition;
$kaufbar = app(OfferService::class)->purchasableVersion($offer) !== null;
return [
'titel' => 'Die Option auf einen Blick',
'zusatz' => 'Fassung '.$active->number,
'hilfe' => 'So erscheint die Option auf der öffentlichen Produktseite und im Warenkorb. Die Angaben dieser Fassung sind unveränderlich.',
'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' => '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.'],
],
];
}
/**
* Aufgelöster Leistungsumfang in lesbaren Fähigkeiten (dieselben Bezeichnungen wie beim Rechteprofil).
*
@@ -22,7 +22,7 @@ class ListPillars extends ListRecords
public function getSubheading(): string|Htmlable|null
{
return 'Die fachlichen Säulen des Materials. Eine veröffentlichte Säule ist ein Themenbereich der Website. Ein Medium und eine Seite können mehreren Säulen zugeordnet sein.';
return 'Die fachlichen Säulen des Materials. Eine veröffentlichte Säule ist ein Themenbereich der Website. Medien, Module, Programme, Lizenzartikel und Seiten können mehreren Säulen zugeordnet sein. Hier ist die einzige Pflegestelle der Säulen.';
}
protected function getHeaderActions(): array
@@ -50,11 +50,28 @@ protected function getHeaderActions(): array
];
}
/**
* Zuordnungen aller Objektarten; ohne Zuordnung wie bisher „0 Medien“.
*/
private function usageLabel(PillarService $service, Pillar $pillar): string
{
$usage = [
'medien' => (int) $pillar->elements_count,
'zusammenstellungen' => (int) $pillar->compositions_count,
'lizenzartikel' => (int) $pillar->license_articles_count,
'seiten' => (int) $pillar->pages_count,
];
return array_sum($usage) === 0 ? '0 Medien' : $service->usageText($usage);
}
protected function catalogRows(): array
{
$rows = [];
foreach (Pillar::query()->withCount('elements')->orderBy('sort_order')->orderBy('name')->get() as $pillar) {
$service = app(PillarService::class);
foreach (Pillar::query()->withCount(['elements', 'compositions', 'licenseArticles', 'pages'])->orderBy('sort_order')->orderBy('name')->get() as $pillar) {
$public = $pillar->published_at !== null;
$url = PillarResource::getUrl('edit', ['record' => $pillar]);
$rows[] = [
@@ -66,7 +83,7 @@ protected function catalogRows(): array
'url' => $url,
'chips' => [
$public ? ['label' => 'Auf der Website veröffentlicht', 'ton' => 'gut'] : ['label' => 'Intern', 'ton' => 'leise'],
['label' => $pillar->elements_count === 1 ? '1 Medium' : $pillar->elements_count.' Medien', 'ton' => 'neutral'],
['label' => $this->usageLabel($service, $pillar), 'ton' => 'neutral'],
],
'zustand' => [$public ? 'oeffentlich' : 'intern'],
'aktionen' => [['label' => 'Bearbeiten', 'href' => $url, 'icon' => 'stift']],
+53
View File
@@ -0,0 +1,53 @@
<?php
namespace App\Filament\Support;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Pillar;
use App\Domain\Catalog\PillarService;
/**
* Fachliche Säulen im Redaktionsmanager von Modul, Programm und Lizenzartikel (wie bei Medien): Die Auswahl kommt aus
* der zentralen Säulenverwaltung, die Zuordnung ersetzt die bisherige vollständig und bleibt beim Speichern anderer
* Angaben erhalten, weil der gespeicherte Stand geladen und mitgeschrieben wird.
*
* Eine Zuordnung veröffentlicht nichts: Ob eine Säule eine Themenseite hat, entscheidet allein die Säulenverwaltung.
*/
trait AssignsPillars
{
/** @var list<int|string> */
public array $pillarIds = [];
/**
* @return array{legend: string, model: string, values: list<array{id: int, label: string}>}|null
*/
public function pillarGroup(): ?array
{
$values = Pillar::query()->orderBy('sort_order')->orderBy('name')->get(['id', 'name'])
->map(fn (Pillar $pillar): array => ['id' => (int) $pillar->id, 'label' => (string) $pillar->name])
->all();
return $values === [] ? null : ['legend' => 'Fachliche Säulen', 'model' => 'pillarIds', 'values' => $values];
}
protected function loadPillarIds(Composition|LicenseArticle $subject): void
{
$this->pillarIds = $subject->pillars()->pluck('pillars.id')->map(fn (mixed $id): string => (string) (int) $id)->all();
}
protected function persistPillarIds(Composition|LicenseArticle $subject): void
{
app(PillarService::class)->assign($subject, array_map(intval(...), $this->pillarIds));
}
protected function pillarsUnsaved(Composition|LicenseArticle $subject): bool
{
$stored = $subject->pillars()->pluck('pillars.id')->map(fn (mixed $id): int => (int) $id)->all();
$current = array_map(intval(...), $this->pillarIds);
sort($stored);
sort($current);
return $stored !== $current;
}
}
+18
View File
@@ -5,6 +5,7 @@
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\ContentElementVersion;
use App\Domain\Catalog\EditorialVocabulary;
use App\Domain\Catalog\Pillar;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Http\Controllers\ContentPreviewController;
@@ -27,6 +28,9 @@ trait ChoosesMedia
public string $pickerDimension = '';
/** Filter „Fachliche Säule“ (Kennung der Säule aus der zentralen Säulenverwaltung). */
public string $pickerSaeule = '';
/** Filter „Fachliche Materialart“ (Kennung), gleiche Regel wie Medieneditor und Medienfilter. */
public string $pickerMaterialart = '';
@@ -108,6 +112,8 @@ public function pickerResult(): array
$this->pickerKind,
$this->pickerDimension,
$this->pickerExceptId(),
false,
ctype_digit($this->pickerSaeule) ? (int) $this->pickerSaeule : 0,
));
}
@@ -204,6 +210,7 @@ protected function resetPicker(string $purpose): void
$this->pickerOpen = true;
$this->pickerQuery = '';
$this->pickerDimension = '';
$this->pickerSaeule = '';
$this->pickerMaterialart = '';
$this->pickerInspected = '';
$this->pickerSelected = '';
@@ -239,6 +246,17 @@ private function filterByMaterialart(array $result): array
return $result;
}
/**
* Säulen für den Picker-Filter, in der Reihenfolge der Säulenverwaltung.
*
* @return array<string, string>
*/
public function pickerSaeulen(): array
{
return Pillar::query()->orderBy('sort_order')->orderBy('name')->pluck('name', 'id')
->mapWithKeys(fn (string $name, int|string $id): array => [(string) $id => $name])->all();
}
/**
* Einordnungsfilter des Pickers: dieselbe Filterregel wie Medien- und Kompositionslisten (verwendete inaktive Werte
* bleiben auffindbar, ein gewählter Filter bleibt sichtbar).
@@ -2,8 +2,14 @@
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;
use Filament\Notifications\Notification;
/**
@@ -31,6 +37,128 @@ public function openWebsiteImagePicker(string $pfad): void
$this->forceRenderForPicker();
}
/**
* Medien- und Materialkarte: das Vorschaubild des Films als Bild für die Website übernehmen. Es entsteht ein Bild
* im Medienmanager (einmal gespeichert), das im Bildfeld ausgewählt wird. Die Datei des Films bleibt geschützt.
*/
public function adoptFilmThumbnail(string $pfad, int $elementId): void
{
$this->adoptFilmStill($pfad, $elementId, fn (FilmStill $stills, ContentElement $film): ContentElement => $stills->fromThumbnail($film, auth('staff')->user()));
}
/**
* Medien- und Materialkarte: eine Stelle des Films wählen und als Bild für die Website übernehmen.
*/
public function adoptFilmFrame(string $pfad, int $elementId, string $sekunde): void
{
if (! is_numeric($sekunde)) {
Notification::make()->danger()->title('Bitte eine Zeitposition in Sekunden angeben.')->send();
return;
}
$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
*/
private function adoptFilmStill(string $pfad, int $elementId, callable $make): void
{
abort_unless(ContentElementResource::editor(), 403);
if ($this->imageTargetIsInvalid($pfad)) {
return;
}
$film = ContentElement::query()->with('editorialContentKind')->find($elementId);
if (! $film instanceof ContentElement) {
return;
}
$stills = app(FilmStill::class);
try {
$still = $make($stills, $film);
} catch (DomainRuleException $exception) {
Notification::make()->danger()->title($exception->getMessage())->send();
return;
}
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 (! $reused) {
Notification::make()
->success()
->title('Im Medienmanager angelegt: „'.$title.'“')
->body('Das Bild ist als Kartenbild ausgewählt. Nach der Verarbeitung wird es für die Website freigegeben; dort lässt sich die Freigabe auch zurücknehmen.')
->send();
return;
}
if (app(WebsiteMedia::class)->present($still) !== null) {
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($reusedText.' Die Website-Freigabe wurde zurückgenommen. Das Bild erscheint öffentlich erst wieder, wenn sie im Medienmanager (Reiter „Website“) erneut gegeben wird.')
->persistent()
->send();
}
}
/**
* Filament rendert bei offenen Aktionsdialogen nur den Dialogteil neu; der Picker liegt darüber und braucht die
* ganze Seite.
+33 -5
View File
@@ -272,7 +272,7 @@ public function search(string $query, string $scope, int $exceptCompositionId):
/**
* @return array{items: list<array<string, string|null>>, more: bool}
*/
public function browse(string $query, string $kind, string $dimension, int $exceptCompositionId, bool $elementsOnly = false): array
public function browse(string $query, string $kind, string $dimension, int $exceptCompositionId, bool $elementsOnly = false, int $pillarId = 0): array
{
$query = trim($query);
$like = '%'.str_replace(['%', '_'], ['', ''], $query).'%';
@@ -284,8 +284,8 @@ public function browse(string $query, string $kind, string $dimension, int $exce
$latestElements = ContentElementVersion::query()
->selectRaw('MAX(id)')
->whereIn('status', [ContentVersionStatus::Bereit, ContentVersionStatus::Entwurf])
->whereHas('element', function ($builder) use ($query, $like, $kind, $dimensionId): void {
$this->constrainElement($builder, $query, $like, $kind, $dimensionId);
->whereHas('element', function ($builder) use ($query, $like, $kind, $dimensionId, $pillarId): void {
$this->constrainElement($builder, $query, $like, $kind, $dimensionId, $pillarId);
})
->groupBy('content_element_id');
$elements = ContentElementVersion::query()
@@ -309,7 +309,7 @@ public function browse(string $query, string $kind, string $dimension, int $exce
->selectRaw('MAX(id)')
->where('status', ContentVersionStatus::Bereit)
->where('composition_id', '!=', $exceptCompositionId)
->whereHas('composition', function ($builder) use ($query, $like, $kind, $dimensionId): void {
->whereHas('composition', function ($builder) use ($query, $like, $kind, $dimensionId, $pillarId): void {
if ($kind === 'modul') {
$builder->where('kind', CompositionKind::Uebung);
}
@@ -318,6 +318,10 @@ public function browse(string $query, string $kind, string $dimension, int $exce
$builder->whereIn('id', $this->dimensionSubjectIds(Composition::class, $dimensionId));
}
if ($pillarId > 0) {
$builder->whereIn('id', $this->pillarSubjectIds(Composition::class, $pillarId));
}
if ($query === '') {
return;
}
@@ -370,6 +374,10 @@ public function browse(string $query, string $kind, string $dimension, int $exce
continue;
}
if ($pillarId > 0 && ! in_array($composition->id, $this->pillarSubjectIds(Composition::class, $pillarId), true)) {
continue;
}
$title = $this->compositionTitle($composition);
if ($query !== '' && ! str_contains(mb_strtolower($title.' '.(string) ($composition->summary ?? '')), mb_strtolower($query))) {
@@ -564,7 +572,7 @@ private function withVisibility(array $rows): array
/**
* @param Builder<ContentElement> $builder
*/
private function constrainElement($builder, string $query, string $like, string $kind, int $dimensionId): void
private function constrainElement($builder, string $query, string $like, string $kind, int $dimensionId, int $pillarId = 0): void
{
$outputs = match ($kind) {
'film' => ['film'],
@@ -583,6 +591,10 @@ private function constrainElement($builder, string $query, string $like, string
$builder->whereIn('id', $this->dimensionSubjectIds(ContentElement::class, $dimensionId));
}
if ($pillarId > 0) {
$builder->whereIn('id', $this->pillarSubjectIds(ContentElement::class, $pillarId));
}
if ($query === '') {
return;
}
@@ -597,6 +609,22 @@ private function constrainElement($builder, string $query, string $like, string
});
}
/**
* Direkt einer Säule zugeordnete Medien oder Module und Programme (zentrale Säulenverwaltung).
*
* @param class-string<Model> $class
* @return list<int>
*/
private function pillarSubjectIds(string $class, int $pillarId): array
{
[$table, $column] = $class === Composition::class
? ['composition_pillar', 'composition_id']
: ['content_element_pillar', 'content_element_id'];
return DB::table($table)->where('pillar_id', $pillarId)->pluck($column)
->map(fn (mixed $id): int => (int) $id)->all();
}
/**
* @param class-string<Model> $class
* @return list<int>
+55 -5
View File
@@ -7,9 +7,12 @@
use App\Domain\Catalog\ContentVersionStatus;
use App\Domain\Catalog\EditorialVocabulary;
use App\Domain\Catalog\IdentityDimensionValue;
use App\Domain\Catalog\Pillar;
use App\Domain\Catalog\PillarFilterCompat;
use App\Filament\Resources\ContentElements\ContentElementResource;
use Filament\Actions\Action;
use Filament\Forms\Components\TextInput;
use Illuminate\Support\Facades\DB;
use Livewire\Attributes\Url;
/**
@@ -29,6 +32,10 @@ trait ListsCompositions
#[Url]
public string $pillar = '';
/** Fachliche Säule (zentrale Säulenverwaltung), direkt zugeordnet. */
#[Url(as: 'saeule', except: '')]
public string $saeule = '';
#[Url]
public string $visibility = 'alle';
@@ -39,7 +46,7 @@ protected function fixedKind(): ?CompositionKind
protected function bestandFilterEigenschaften(): array
{
return ['query', 'kindFilter', 'pillar', 'visibility'];
return ['query', 'kindFilter', 'pillar', 'saeule', 'visibility'];
}
public function resetFilters(): void
@@ -47,13 +54,14 @@ public function resetFilters(): void
$this->query = '';
$this->kindFilter = 'alle';
$this->pillar = '';
$this->saeule = '';
$this->visibility = 'alle';
$this->bestandGrenze = Bestand::SCHRITT;
}
public function hasActiveFilters(): bool
{
return trim($this->query) !== '' || $this->kindFilter !== 'alle' || $this->pillar !== '' || $this->visibility !== 'alle';
return trim($this->query) !== '' || $this->kindFilter !== 'alle' || $this->pillar !== '' || $this->saeule !== '' || $this->visibility !== 'alle';
}
/**
@@ -61,6 +69,7 @@ public function hasActiveFilters(): bool
*/
public function bestand(): array
{
$this->normalizeLegacyPillarFilter();
$fixed = $this->fixedKind();
$einheit = match ($fixed) {
CompositionKind::Kurs => ['Programm', 'Programme'],
@@ -90,9 +99,14 @@ public function bestand(): array
'eigenschaft' => 'visibility', 'label' => 'Stand', 'vorgabe' => 'alle',
'optionen' => ['alle' => 'Jeder Stand', 'bibliothek' => 'In der Mitgliederbibliothek', 'verborgen' => 'Nicht in der Mitgliederbibliothek', 'entwurf' => 'Noch ohne Fassung'],
]],
'weitere' => $gruppen === [] ? [] : [[
'eigenschaft' => 'pillar', 'label' => 'Fachliche Einordnung', 'vorgabe' => '', 'alle' => 'Alle Einordnungen', 'gruppen' => $gruppen,
]],
'weitere' => [
...($this->pillarOptions() === [] ? [] : [[
'eigenschaft' => 'saeule', 'label' => 'Fachliche Säule', 'vorgabe' => '', 'alle' => 'Alle Säulen', 'optionen' => $this->pillarOptions(),
]]),
...($gruppen === [] ? [] : [[
'eigenschaft' => 'pillar', 'label' => 'Fachliche Einordnung', 'vorgabe' => '', 'alle' => 'Alle Einordnungen', 'gruppen' => $gruppen,
]]),
],
'zeilen' => $this->entries(),
'einheit' => $einheit,
'leer' => [
@@ -124,7 +138,9 @@ public function entries(): array
$needle = mb_strtolower(trim($this->query));
$catalog = app(EditorialCatalog::class);
$offered = $catalog->offeredCompositionIds();
$this->normalizeLegacyPillarFilter();
$pillarIds = $this->pillar === '' ? null : $this->pillarSubjects((int) $this->pillar);
$saeuleIds = ctype_digit($this->saeule) && $this->saeule !== '' ? $this->saeuleSubjects((int) $this->saeule) : null;
$fixed = $this->fixedKind();
$kinds = $fixed !== null ? [$fixed] : match ($this->kindFilter) {
'programm' => [CompositionKind::Kurs],
@@ -149,6 +165,10 @@ public function entries(): array
continue;
}
if ($saeuleIds !== null && ! in_array($composition->id, $saeuleIds, true)) {
continue;
}
$stand = $catalog->stand($composition);
if (! $this->matchesVisibility($stand)) {
@@ -249,6 +269,36 @@ private function coverMembers(Composition $composition): array
return $members;
}
/**
* Alte Adressen mit einem Säulenwert der Einordnung (`?pillar=…`) gelten für die zentrale Säule.
*/
private function normalizeLegacyPillarFilter(): void
{
if (ctype_digit($this->pillar) && $this->pillar !== '' && $this->saeule === '' && is_int($pillar = PillarFilterCompat::pillarOfLegacyValue((int) $this->pillar))) {
[$this->saeule, $this->pillar] = [(string) $pillar, ''];
}
}
/**
* @return array<string, string>
*/
private function pillarOptions(): array
{
return Pillar::query()->orderBy('sort_order')->orderBy('name')->pluck('name', 'id')
->mapWithKeys(fn (string $name, int|string $id): array => [(string) $id => $name])->all();
}
/**
* Direkt zugeordnete Module und Programme einer Säule. Die Säulen der enthaltenen Medien zählen hier nicht.
*
* @return list<int>
*/
private function saeuleSubjects(int $pillarId): array
{
return DB::table('composition_pillar')->where('pillar_id', $pillarId)->pluck('composition_id')
->map(fn (mixed $id): int => (int) $id)->all();
}
/**
* @return list<int>
*/
+10 -2
View File
@@ -11,6 +11,7 @@
use App\Domain\Catalog\EditorialVocabulary;
use App\Domain\Catalog\IdentityDimensionValue;
use App\Domain\Catalog\Pillar;
use App\Domain\Catalog\PillarFilterCompat;
use App\Domain\Catalog\ReleaseContent;
use App\Domain\Media\ThumbnailRef;
use App\Filament\Resources\ContentElements\ContentElementResource;
@@ -132,6 +133,13 @@ public function cards(array $filters, bool $canEdit): array
*/
private function normalize(array $filters): array
{
$saeule = ctype_digit($filters['saeule'] ?? '') ? $filters['saeule'] : '';
$einordnung = ctype_digit($filters['einordnung'] ?? '') ? $filters['einordnung'] : '';
if ($einordnung !== '' && $saeule === '' && is_int($pillar = PillarFilterCompat::pillarOfLegacyValue((int) $einordnung))) {
[$saeule, $einordnung] = [(string) $pillar, ''];
}
return [
'suche' => trim($filters['suche'] ?? ''),
'art' => $this->choice($filters['art'] ?? '', ['film', 'text', 'document', 'bild', 'audio']),
@@ -139,8 +147,8 @@ private function normalize(array $filters): array
'entwurf' => $this->choice($filters['entwurf'] ?? '', ['offen', 'keiner']),
'fassung' => $this->choice($filters['fassung'] ?? '', ['mit', 'nur']),
'nutzung' => $this->choice($filters['nutzung'] ?? '', ['verwendet', 'unbenutzt']),
'saeule' => ctype_digit($filters['saeule'] ?? '') ? $filters['saeule'] : '',
'einordnung' => ctype_digit($filters['einordnung'] ?? '') ? $filters['einordnung'] : '',
'saeule' => $saeule,
'einordnung' => $einordnung,
'inhaltsart' => ctype_digit($filters['inhaltsart'] ?? '') ? $filters['inhaltsart'] : '',
'verarbeitung' => $this->choice($filters['verarbeitung'] ?? '', ['fehler', 'uebernahme']),
'archiv' => $this->choice($filters['archiv'] ?? '', ['aktiv', 'archiviert', 'alle'], 'aktiv'),
+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 {
@@ -0,0 +1,320 @@
<?php
namespace App\Filament\Support;
use App\Domain\Catalog\ArticleRelease;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\BundleService;
use App\Domain\Catalog\BundleStatus;
use App\Domain\Catalog\BundleVersion;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Catalog\ReleaseStatus;
use App\Domain\Catalog\StatusValue;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\ProductOptions;
use App\Filament\Resources\LicenseArticles\LicenseArticleResource;
use App\Filament\Resources\Offers\OfferResource;
use Illuminate\Support\Facades\DB;
/**
* Voraussetzungen bis zur Veröffentlichung für Lizenzartikel, Paket und Angebot in einer gemeinsamen Form
* (Verwaltungsstandard 14, Abschnitt 9: eine Komponente für gleiche Aufgaben). Die Klasse liest nur; sie ändert keine
* fachliche Regel. Jeder Schritt nennt, was fehlt, und bietet den Weg dorthin an.
*
* Schritt: ['titel', 'text', 'stand' => erledigt|offen|optional, 'aktion' => ['label', 'wire'|'href']|null]
* Ergebnis: ['schritte', 'bereit' (alle Pflichtschritte erledigt), 'naechster' (Text des ersten offenen Pflichtschritts)].
*/
class PublicationReadiness
{
public function __construct(
private readonly BundleService $bundles,
private readonly OfferService $offers,
private readonly PublicCatalogReader $catalog,
) {}
/** Ein Artikel ist verwendbar, wenn sein aktueller Stand veröffentlicht ist. */
public function articleUsable(LicenseArticle $article): bool
{
$release = $article->currentRelease;
return $release instanceof ArticleRelease && StatusValue::of($release->status) === ReleaseStatus::Veroeffentlicht->value;
}
/** Anzeige in Auswahllisten: Name, Kennung und Stand statt der bloßen Kennung. */
public function articleLabel(LicenseArticle $article): string
{
$title = $this->articleName($article);
$name = $title !== '' ? $title.' ('.$article->code.')' : (string) $article->code;
$release = $article->currentRelease;
if ($this->articleUsable($article)) {
return $name.' · Stand '.$release->number;
}
return $name.' · '.($release === null ? 'noch ohne Stand, nicht verwendbar' : 'Stand gesperrt, nicht verwendbar');
}
/** Name wie in der Redaktion: eigener Name oder Name des Inhalts, sonst der Arbeitstitel; leer ohne beides. */
public function articleName(LicenseArticle $article): string
{
return app(ProductOptions::class)->articleName($article);
}
/**
* @return array<int, string>
*/
public function articleOptions(): array
{
$options = [];
foreach (LicenseArticle::query()->with('currentRelease')->orderBy('code')->get() as $article) {
$options[$article->id] = $this->articleLabel($article);
}
return $options;
}
/**
* Veröffentlichte Paketfassungen mit ihren Artikeln, damit die Auswahl zeigt, was verkauft wird.
*
* @return array<int, string>
*/
public function bundleVersionOptions(): array
{
$options = [];
foreach (BundleVersion::query()->where('status', BundleStatus::Veroeffentlicht)->with('bundle')->orderBy('id')->get() as $version) {
try {
$codes = LicenseArticle::query()->whereIn('id', $this->bundles->articleIds($version))->orderBy('code')->pluck('code')->all();
} catch (DomainRuleException) {
$codes = [];
}
$options[$version->id] = $version->bundle->name.' · Fassung '.$version->number.' ('.($codes === [] ? 'ohne Artikel' : implode(', ', $codes)).')';
}
return $options;
}
/**
* Artikel einer Auswahl, die keinen verwendbaren Stand haben.
*
* @param list<int> $articleIds
* @return list<LicenseArticle>
*/
public function unusableArticles(array $articleIds): array
{
return LicenseArticle::query()->with('currentRelease')->whereIn('id', array_unique($articleIds))->orderBy('code')->get()
->reject(fn (LicenseArticle $article): bool => $this->articleUsable($article))
->values()
->all();
}
/**
* @param list<LicenseArticle> $articles
*/
public function unusableMessage(array $articles, string $zweck): string
{
$namen = implode(', ', array_map(fn (LicenseArticle $article): string => '„'.($this->articleName($article) ?: $article->code).'“ ('.$article->code.')', $articles));
return (count($articles) === 1 ? 'Der Lizenzartikel ' : 'Die Lizenzartikel ').$namen
.(count($articles) === 1 ? ' hat' : ' haben')
.' noch keinen veröffentlichten Stand und vergibt'.(count($articles) === 1 ? '' : ' keine').' keine Inhalte. '
.'Lege zuerst am Artikel mit „Inhalt festlegen“ den Inhalt fest, bevor du '.$zweck.'.';
}
/**
* @return array<string, mixed>
*/
public function forArticle(LicenseArticle $article): array
{
$article->loadMissing('currentRelease');
$usable = $this->articleUsable($article);
$release = $article->currentRelease;
$inUse = $this->articleInUse($article);
return $this->result([
[
'titel' => 'Inhalt festlegen',
'text' => $usable
? 'Stand '.$release->number.' ist veröffentlicht und bestimmt, welche Inhalte der Artikel lizenziert.'
: 'Der Artikel lizenziert noch nichts. Wähle den freigegebenen Inhalt (Medium, Modul oder Programm), den er umfassen soll.',
'stand' => $usable ? 'erledigt' : 'offen',
'aktion' => $usable ? null : ['label' => 'Inhalt festlegen', 'wire' => "mountAction('release')"],
],
[
'titel' => 'Name und Beschreibung',
'text' => $this->articleName($article) !== ''
? 'Der Name „'.$this->articleName($article).'“ erscheint in Paketen, Angeboten, im Shop und in der Bibliothek.'
: 'Ohne Name erscheint die Kennung „'.$article->code.'“. Name, Teaser und Beschreibung pflegst du in der Redaktion.',
'stand' => $this->articleName($article) !== '' ? 'erledigt' : 'optional',
'aktion' => $this->articleName($article) !== '' ? null : ['label' => 'Redaktion bearbeiten', 'wire' => "openRedaktion('texte')"],
],
[
'titel' => 'In einem Paket oder Angebot verwenden',
'text' => $inUse
? 'Der Artikel ist in einem Paket oder Angebot enthalten.'
: 'Verkauft wird der Artikel erst über ein Angebot, allein oder in einem Paket.',
'stand' => $inUse ? 'erledigt' : 'offen',
'aktion' => $inUse ? null : ['label' => 'Angebote öffnen', 'href' => OfferResource::getUrl('index')],
'pflicht' => false,
],
]);
}
/**
* @return array<string, mixed>
*/
public function forBundle(Bundle $bundle): array
{
$published = $bundle->versions()->where('status', BundleStatus::Veroeffentlicht)->orderByDesc('number')->first();
$missing = [];
if ($published instanceof BundleVersion) {
try {
$missing = $this->unusableArticles($this->bundles->articleIds($published));
} catch (DomainRuleException) {
$missing = [];
}
}
$offered = $published instanceof BundleVersion && $this->bundleOffered($bundle);
return $this->result([
[
'titel' => 'Bestandteile festlegen',
'text' => $published instanceof BundleVersion
? 'Fassung '.$published->number.' ist veröffentlicht und unveränderlich.'
: 'Wähle die Lizenzartikel und Pakete, die zusammen verkauft werden, und veröffentliche die Fassung.',
'stand' => $published instanceof BundleVersion ? 'erledigt' : 'offen',
'aktion' => $published instanceof BundleVersion ? null : ['label' => 'Bestandteile festlegen', 'wire' => "mountAction('publish')"],
],
[
'titel' => 'Jeder enthaltene Artikel hat einen Inhalt',
'text' => ! $published instanceof BundleVersion
? 'Wird geprüft, sobald die Bestandteile feststehen.'
: ($missing === []
? 'Alle enthaltenen Artikel haben einen veröffentlichten Stand.'
: 'Ohne Stand und damit ohne Inhalt: '.implode(', ', array_map(fn (LicenseArticle $article): string => (string) $article->code, $missing)).'. Ein Angebot lässt sich erst aktivieren, wenn jeder Artikel einen Stand hat.'),
'stand' => $published instanceof BundleVersion && $missing === [] ? 'erledigt' : 'offen',
'aktion' => $missing === [] ? null : ['label' => 'Artikel „'.$missing[0]->code.'“ öffnen', 'href' => LicenseArticleResource::getUrl('view', ['record' => $missing[0]])],
],
[
'titel' => 'Angebot mit Preis und Rechten',
'text' => $offered
? 'Ein aktives Angebot verkauft dieses Paket.'
: 'Verkauft wird das Paket erst über ein Angebot. Dort wählst du die Paketfassung, die Rechte und den Preis.',
'stand' => $offered ? 'erledigt' : 'offen',
'aktion' => $offered ? null : ['label' => 'Angebote öffnen', 'href' => OfferResource::getUrl('index')],
'pflicht' => false,
],
]);
}
/**
* @return array<string, mixed>
*/
public function forOffer(Offer $offer): array
{
$active = $offer->versions()->where('status', 'aktiv')->orderByDesc('number')->first();
$hasActive = $active instanceof OfferVersion;
$articleIds = $hasActive ? $active->resolvedScopes()->pluck('license_article_id')->map(fn ($id): int => (int) $id)->all() : [];
$missing = $this->unusableArticles($articleIds);
$buyable = $hasActive && $this->offers->purchasableVersion($offer) !== null;
$page = $offer->composition;
$shown = $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')"];
return $this->result([
[
'titel' => 'Artikel oder Paket, Rechte, Preis und Vergabe festlegen',
'text' => $hasActive
? 'Fassung '.$active->number.' ist aktiv.'
: 'Wähle, was verkauft wird (Lizenzartikel oder Paketfassung), welche Nutzungsrechte dazugehören, für wen es gilt und was es kostet. Erst „Fassung aktivieren“ macht das Angebot gültig.',
'stand' => $hasActive ? 'erledigt' : 'offen',
'aktion' => $hasActive ? null : $activate,
],
[
'titel' => 'Inhalt vorhanden',
'text' => ! $hasActive
? 'Wird geprüft, sobald die Fassung aktiv ist.'
: ($missing === []
? 'Jeder enthaltene Lizenzartikel hat einen veröffentlichten Stand.'
: 'Ohne Stand und damit ohne Inhalt: '.implode(', ', array_map(fn (LicenseArticle $article): string => (string) $article->code, $missing)).'. Käufer würden nichts erhalten.'),
'stand' => $hasActive && $missing === [] ? 'erledigt' : 'offen',
'aktion' => $missing === [] ? null : ['label' => 'Artikel „'.$missing[0]->code.'“ öffnen', 'href' => LicenseArticleResource::getUrl('view', ['record' => $missing[0]])],
],
[
'titel' => 'Als Kauf mit Preis angeboten',
'text' => $buyable
? 'Die aktive Fassung ist ein Kauf zu '.Money::format((int) $active->price_cents).'.'
: ($hasActive ? 'Die aktive Fassung ist kein Kauf mit Preis (Vergabe: '.CatalogLabels::vergabe($active).'). Im Shop erscheinen nur Käufe.' : 'Wird mit der Fassung festgelegt.'),
'stand' => $buyable ? 'erledigt' : 'offen',
'aktion' => $buyable ? null : ($hasActive ? $activate : null),
],
[
'titel' => 'Produktseite zuordnen',
'text' => $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,
],
[
'titel' => 'Produktseite öffentlich',
'text' => $page === null
? 'Wird geprüft, sobald eine Produktseite zugeordnet 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.'),
'stand' => $shown ? 'erledigt' : 'offen',
'aktion' => $page === null || $shown ? null : ['label' => 'Programm öffnen', 'href' => EditorialCatalog::editUrl($page)],
],
]);
}
/**
* @param list<array<string, mixed>> $schritte
* @return array<string, mixed>
*/
private function result(array $schritte): array
{
$schritte = array_map(fn (array $schritt): array => ['pflicht' => true, 'aktion' => null, ...$schritt], $schritte);
$naechster = null;
foreach ($schritte as $schritt) {
if ($schritt['pflicht'] && $schritt['stand'] === 'offen') {
$naechster = $schritt;
break;
}
}
return [
'schritte' => $schritte,
'bereit' => $naechster === null,
'naechster' => $naechster,
];
}
private function articleInUse(LicenseArticle $article): bool
{
return DB::table('offer_lines')->where('license_article_id', $article->id)->exists()
|| DB::table('bundle_items')->where('license_article_id', $article->id)->exists();
}
private function bundleOffered(Bundle $bundle): bool
{
return DB::table('offer_lines')
->join('offer_versions', 'offer_versions.id', '=', 'offer_lines.offer_version_id')
->join('bundle_versions', 'bundle_versions.id', '=', 'offer_lines.bundle_version_id')
->where('bundle_versions.bundle_id', $bundle->id)
->where('offer_versions.status', 'aktiv')
->exists();
}
}
@@ -25,7 +25,8 @@ public function verify(EmailVerificationRequest $request): RedirectResponse
$request->fulfill();
app(GrantIssuer::class)->grantRegistrationOffers($request->user());
return redirect()->route('member.dashboard');
// Wer aus dem Warenkorb kam, kehrt nach der Bestätigung zur Kasse zurück (gespeichertes Ziel der Sitzung).
return redirect()->intended(route('member.dashboard'));
}
public function send(Request $request): RedirectResponse
+88
View File
@@ -0,0 +1,88 @@
<?php
namespace App\Http\Controllers;
use App\Domain\Catalog\Offer;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Commerce\Cart;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\OrderHolders;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;
/**
* Öffentlicher Warenkorb (Etappe 1, nur Testzahlung). Er ist vor der Anmeldung nutzbar; die Prüfung der
* vorhandenen Rechte erfolgt, sobald ein Konto angemeldet ist.
*/
class CartController extends Controller
{
public function show(Request $request, Cart $cart, OrderHolders $holders): View
{
$user = $request->user();
$review = $cart->review($user, $request->integer('bestellen_als') ?: null);
return view('shop.cart', [
'review' => $review,
'holders' => $user === null ? collect() : $holders->for($user),
]);
}
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;
$back = $this->productPage($offer);
return match ($result) {
Cart::ADDED => $back->with('status', 'Die Option liegt im Warenkorb.'),
Cart::PRESENT => $back->with('status', 'Diese Option liegt bereits im Warenkorb. Sie erscheint nur einmal.'),
Cart::ALTERNATIVE => $back->with('shop.switch', $offer->id),
default => $back->withErrors(['shop' => 'Diese Option ist gerade nicht erhältlich.']),
};
}
/**
* Ausdrücklicher Wechsel zwischen Alternativoptionen derselben Produktseite.
*/
public function switch(Offer $offer, Cart $cart): RedirectResponse
{
if (! $cart->switchTo($offer)) {
return $this->productPage($offer)->withErrors(['shop' => 'Diese Option ist gerade nicht erhältlich.']);
}
return redirect()->route('cart')->with('status', 'Die Option wurde gewechselt.');
}
public function remove(Offer $offer, Cart $cart): RedirectResponse
{
$cart->remove($offer);
return redirect()->route('cart')->with('status', 'Die Position ist entfernt.');
}
/**
* Der Käufer übernimmt den aktuell gezeigten Preis und die aktuellen Bedingungen einer Position.
*/
public function accept(Offer $offer, Cart $cart): RedirectResponse
{
$seen = $cart->items()[$offer->id]['price_cents'] ?? null;
$cart->acceptCurrent($offer);
$price = $cart->purchasable($offer)?->price_cents;
return redirect()->route('cart')->with('status', match (true) {
$price === null => 'Die Option ist nicht mehr erhältlich.',
$seen !== null && (int) $seen !== (int) $price => 'Der aktuelle Preis von '.Money::format($price).' ist übernommen.',
default => 'Die aktuellen Bedingungen sind übernommen.',
});
}
private function productPage(Offer $offer): RedirectResponse
{
return $offer->composition_id !== null
? redirect()->route('public.program', $offer->composition_id)
: redirect()->route('cart');
}
}
@@ -5,8 +5,11 @@
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferStatus;
use App\Domain\Commerce\Cart;
use App\Domain\Commerce\Checkout;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\OrderHolders;
use App\Domain\Commerce\StaleOverview;
use App\Domain\Entitlement\GrantIssuer;
use App\Http\Controllers\Controller;
use Illuminate\Http\RedirectResponse;
@@ -48,10 +51,50 @@ public function place(Request $request, Offer $offer, Checkout $checkout): Redir
return redirect()->route('member.order', $order);
}
/**
* Bestellübersicht: zeigt die geprüften Positionen mit dem Inhaber, für den bestellt wird.
*/
public function checkout(Request $request, Cart $cart, OrderHolders $holders): View|RedirectResponse
{
if ($cart->count() === 0) {
return redirect()->route('cart');
}
$review = $cart->review($request->user(), $request->integer('bestellen_als') ?: null);
return view('shop.checkout', [
'review' => $review,
'holders' => $holders->for($request->user()),
]);
}
/**
* Legt die Bestellung an, aber nur, wenn die serverseitige Prüfung zur gezeigten Übersicht passt.
*/
public function placeOrder(Request $request, Cart $cart, Checkout $checkout): RedirectResponse
{
$data = $request->validate([
'digest' => ['required', 'string'],
'bestellen_als' => ['nullable', 'integer'],
]);
$holderId = isset($data['bestellen_als']) ? (int) $data['bestellen_als'] : null;
$back = redirect()->route('checkout', array_filter(['bestellen_als' => $holderId]));
try {
$order = $checkout->placeFromCart($request->user(), $cart, $holderId, $data['digest']);
} 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.');
}
public function show(Request $request, Order $order): View
{
abort_unless($order->user_id === $request->user()->id, 403);
$order->load('lines.offerVersion.offer', 'payments');
$order->load('lines.offerVersion.offer', 'lines.holder', 'payments', 'party', 'user');
return view('member.order', [
'order' => $order,
@@ -9,6 +9,8 @@
use App\Domain\Catalog\EditorialVocabulary;
use App\Domain\Catalog\IdentityDimension;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Pillar;
use App\Domain\Catalog\PillarFilterCompat;
use App\Domain\Entitlement\DecideAccess;
use App\Domain\Entitlement\Grant;
use App\Domain\Entitlement\GrantStatus;
@@ -20,8 +22,10 @@
use App\Http\CourseOutline;
use App\Http\LibraryCatalog;
use App\Http\SignedLink;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Storage;
use Illuminate\View\View;
use Symfony\Component\HttpFoundation\StreamedResponse;
@@ -35,8 +39,21 @@ public function index(Request $request, ?string $sicht = null): View
$query = trim((string) $request->query('q', ''));
$nutzung = (string) $request->query('nutzung', '');
$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);
// Alte Adressen: Säulen waren ein Wert der Einordnung. Mit belastbarer Verknüpfung gilt der Filter der Säule.
foreach ($dimensionIds as $index => $valueId) {
if (is_int($pillarId = PillarFilterCompat::pillarOfLegacyValue($valueId))) {
$saeuleIds[] = $pillarId;
unset($dimensionIds[$index]);
}
}
$dimensionIds = array_values($dimensionIds);
$saeuleIds = array_values(array_unique($saeuleIds));
$pillarOptions = $this->visiblePillars($catalog, $saeuleIds);
foreach (['programs', 'modules'] as $shelf) {
if ($query !== '') {
$catalog[$shelf] = array_values(array_filter(
@@ -50,6 +67,12 @@ public function index(Request $request, ?string $sicht = null): View
fn (array $card): bool => $dimensions->matches($card['composition'], $dimensionIds),
));
}
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],
@@ -79,6 +102,13 @@ function (array $card) use ($dimensions, $dimensionIds): bool {
));
}
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'] = [];
}
@@ -89,11 +119,65 @@ function (array $card) use ($dimensions, $dimensionIds): bool {
'sicht' => $sicht,
'nutzung' => $nutzung,
'dimensionIds' => $dimensionIds,
'saeuleIds' => $saeuleIds,
'filterPillars' => $pillarOptions,
'filterDimensions' => app(EditorialVocabulary::class)->memberFilterDimensions(array_map(intval(...), $dimensionIds)),
'libraryEmpty' => $untouched,
]);
}
/**
* 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.
*
* @param list<int> $pillarIds
*/
private function hasPillar(Model $subject, array $pillarIds): bool
{
return $subject->pillars()->whereIn('pillars.id', $pillarIds)->exists();
}
/**
* 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<int> $selected
* @return Collection<int, Pillar>
*/
private function visiblePillars(array $catalog, 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) {
$used[(int) $id] = true;
}
}
return Pillar::query()->whereIn('id', array_values(array_unique([...array_keys($used), ...$selected])))
->orderBy('sort_order')->orderBy('name')->get();
}
public function programs(Request $request): View
{
return $this->index($request, 'programme');
@@ -382,7 +466,7 @@ private function grantQuery(Request $request)
{
return Grant::query()
->where('status', GrantStatus::Aktiv)
->whereHas('acquisition', fn ($query) => $query->where('party_id', $request->user()->party_id))
->usableBy($request->user())
->with('article.currentRelease')
->orderBy('id');
}
@@ -5,6 +5,9 @@
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionStructureReader;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Commerce\Cart;
use App\Domain\Commerce\ProductOptions;
use App\Domain\Commerce\Shop;
use Illuminate\View\View;
class PublicCatalogController extends Controller
@@ -14,7 +17,7 @@ public function index(PublicCatalogReader $catalog): View
return view('public.programs', ['programs' => $catalog->publicPrograms()]);
}
public function program(Composition $composition, PublicCatalogReader $catalog): View
public function program(Composition $composition, PublicCatalogReader $catalog, ProductOptions $products, Cart $cart): View
{
$version = $catalog->shownVersion($composition);
abort_if($version === null, 404);
@@ -23,6 +26,9 @@ public function program(Composition $composition, PublicCatalogReader $catalog):
'composition' => $composition,
'version' => $version,
'nodes' => app(CompositionStructureReader::class)->tree($version),
'options' => Shop::enabled() ? $products->forComposition($composition) : [],
'cart' => $cart,
'switchTo' => session('shop.switch'),
]);
}
}
@@ -14,6 +14,8 @@ public function show(string $path, WebsiteMedia $media): StreamedResponse
abort_if(str_contains($path, '..') || ! str_starts_with($path, 'cms/'), 404);
// Ein in den Medienmanager übernommenes Bild folgt dessen Website-Freigabe, auch unter der früheren Adresse.
abort_if(WebsiteMediaAlias::isRetired($path), 404);
$alias = WebsiteMediaAlias::effectiveFor($path);
abort_if($alias !== null && $media->present($alias->content_element_id) === null, 404);
+50
View File
@@ -0,0 +1,50 @@
<?php
namespace App\Http\Controllers;
use App\Domain\Catalog\Composition;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\ProductOptions;
use Illuminate\Http\Request;
use Illuminate\View\View;
/**
* Durchsuchbarer Shop (Etappe 1): macht kaufbare Produkte auffindbar. Treffer öffnen dieselbe öffentliche Produktseite
* wie die Programmkacheln. Gelistet wird nur, was zur Anzeige freigegeben ist und mindestens eine kaufbare Option hat.
*/
class ShopController extends Controller
{
public function index(Request $request, ProductOptions $products, PublicCatalogReader $catalog): View
{
$term = trim((string) $request->query('suche', ''));
$summaries = $products->summaries();
$cards = [];
foreach (Composition::query()->whereIn('id', array_keys($summaries))->orderBy('designation')->get() as $composition) {
$version = $catalog->shownVersion($composition);
if ($version === null) {
continue;
}
$title = (string) ($composition->display_title ?: $composition->designation);
$haystack = mb_strtolower($title.' '.$composition->teaser.' '.$composition->summary.' '.$composition->search_terms);
if ($term !== '' && ! str_contains($haystack, mb_strtolower($term))) {
continue;
}
$summary = $summaries[$composition->id];
$cards[] = [
'composition' => $composition,
'title' => $title,
'teaser' => (string) ($composition->teaser ?: $composition->summary),
'from' => Money::format($summary['from_cents']),
'count' => $summary['count'],
];
}
return view('shop.index', ['cards' => $cards, 'term' => $term]);
}
}
@@ -4,12 +4,15 @@
use App\Domain\Catalog\ContentElement;
use App\Domain\Media\WebsiteMedia;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use Symfony\Component\HttpFoundation\StreamedResponse;
class WebsiteMediaController extends Controller
{
public function show(ContentElement $element, WebsiteMedia $media): StreamedResponse
private const CHUNK = 262144;
public function show(Request $request, ContentElement $element, WebsiteMedia $media): StreamedResponse
{
$presentation = $media->present($element);
abort_if($presentation === null, 404);
@@ -17,9 +20,81 @@ 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, [
$headers = [
'Content-Disposition' => 'inline',
'X-Content-Type-Options' => 'nosniff',
'Accept-Ranges' => 'bytes',
];
$range = $request->header('Range');
// Filme und Hörstücke brauchen Bereichsabrufe (Safari und iOS spielen sonst nicht ab, Springen ist sonst unmöglich).
if (! is_string($range) || $presentation->kind === 'bild') {
return Storage::disk('media_public')->response($path, null, $headers);
}
$disk = Storage::disk('media_public');
$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];
}
}
+1 -1
View File
@@ -266,7 +266,7 @@ private function grants(User $user): Collection
{
return Grant::query()
->where('status', GrantStatus::Aktiv)
->whereHas('acquisition', fn ($query) => $query->where('party_id', $user->party_id))
->usableBy($user)
->with([
'article.currentRelease.rootCompositionVersion.composition.editorialContentKind',
'article.currentRelease.rootElementVersion.element.editorialContentKind',
+21
View File
@@ -0,0 +1,21 @@
<?php
namespace App\Http\Middleware;
use App\Domain\Commerce\Shop;
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
/**
* Warenkorb und Kasse gibt es nur mit Testzahlung und nie in Produktion (Etappe 1 erteilt keine Produktivfreigabe).
*/
class EnsureShopEnabled
{
public function handle(Request $request, Closure $next): Response
{
abort_unless(Shop::enabled(), 404);
return $next($request);
}
}
+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();
}
}
+2 -2
View File
@@ -42,8 +42,8 @@
],
/*
| Vorbereiteter Warenkorbzugang in der Kopfzeile. Der Warenkorb ist Teil des kommerziellen Anwendungssystems
| und noch nicht umgesetzt; solange enabled false ist, erscheint kein Warenkorbsymbol.
| Früher vorbereiteter Warenkorbzugang. Seit Etappe 1 folgt der Eintrag in der Kopfzeile dem Shop
| (App\Domain\Commerce\Shop::enabled: Testzahlung, nie in Produktion). Diese Werte werden nicht mehr gelesen.
*/
'cart' => [
'enabled' => (bool) env('LUF_CART_ENABLED', false),
@@ -0,0 +1,59 @@
<?php
use App\Domain\Catalog\LegacyPillarAdoption;
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Schema;
/**
* Fachliche Säulen vereinheitlichen: Module, Programme und Lizenzartikel verwenden wie Medien und Seiten die zentrale
* Säulenverwaltung (`pillars`) statt der Kopie „Fachliche Säule“ in den redaktionellen Dimensionen.
*
* Nur Ergänzungen: zwei Zuordnungstabellen (die Säule wird beim Löschen nie still entfernt, wie bei Medien und Seiten),
* die Verknüpfung `pillar_id` an den alten Dimensionswerten und die einmalige, wiederholbare Übernahme durch
* LegacyPillarAdoption. Alte Tabellen und Zeilen bleiben unverändert erhalten.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('composition_pillar', function (Blueprint $table) {
$table->foreignId('composition_id')->constrained()->cascadeOnDelete();
$table->foreignId('pillar_id')->constrained()->restrictOnDelete();
$table->primary(['composition_id', 'pillar_id']);
});
Schema::create('license_article_pillar', function (Blueprint $table) {
$table->foreignId('license_article_id')->constrained()->cascadeOnDelete();
$table->foreignId('pillar_id')->constrained()->restrictOnDelete();
$table->primary(['license_article_id', 'pillar_id']);
});
Schema::table('editorial_dimension_values', function (Blueprint $table) {
$table->foreignId('pillar_id')->nullable()->after('editorial_dimension_id')->constrained('pillars')->nullOnDelete();
});
$report = (new LegacyPillarAdoption)->run();
foreach (LegacyPillarAdoption::lines($report) as $line) {
if ($line !== '') {
Log::info('Säulenübernahme: '.$line);
}
}
if ($report['unresolved'] !== []) {
Log::warning('Säulenübernahme: '.count($report['unresolved']).' Fälle ungeklärt; „php artisan luf:saeulen-uebernehmen --dry-run“ listet sie.');
}
}
public function down(): void
{
Schema::table('editorial_dimension_values', function (Blueprint $table) {
$table->dropConstrainedForeignId('pillar_id');
});
Schema::dropIfExists('license_article_pillar');
Schema::dropIfExists('composition_pillar');
}
};
@@ -0,0 +1,32 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Herkunft der Standbilder, die aus einem Film als Bild-Medium übernommen wurden (Medien- und Materialkarte).
* Additiv. Sie verhindert, dass dieselbe Filmstelle mehrfach als neues Medium entsteht, und hält fest, woher das
* Bild kommt. Das Standbild selbst ist ein gewöhnliches Medium (output_class bild) mit eigener Website-Freigabe.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('film_still_sources', function (Blueprint $table) {
$table->id();
$table->foreignId('film_element_id')->constrained('content_elements')->restrictOnDelete();
$table->foreignId('still_element_id')->constrained('content_elements')->restrictOnDelete();
$table->string('source_key', 120);
$table->unsignedBigInteger('actor_id')->nullable();
$table->timestamps();
$table->unique(['film_element_id', 'source_key']);
});
}
public function down(): void
{
Schema::dropIfExists('film_still_sources');
}
};
@@ -0,0 +1,82 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Schema;
/**
* Etappe 1 (Testkauf): nur ergänzend, keine Daten werden gelöscht oder umbenannt.
*
* - Ein Angebot (Lizenzoption) kann auf die Komposition zeigen, deren öffentliche Seite die Produktseite ist
* (`offers.composition_id`). Angebote derselben Komposition bilden die Angebotsgruppe (Alternativen).
* - Mitgliedschaft eines Kontos in einer Organisation mit Bestellberechtigung (Domänenmodell 04, MEMBERSHIP).
* - Der Erwerb hält das auslösende Konto, die Bestellung Gesamtsumme und Währung, die Position Inhaber, Währung,
* Steuerklasse und Vergabeart als Kopie. `orders.party_id` ist der Lizenzinhaber, `orders.user_id` das handelnde Konto.
*/
return new class extends Migration
{
public function up(): void
{
Schema::table('offers', function (Blueprint $table) {
$table->foreignId('composition_id')->nullable()->constrained('compositions')->nullOnDelete();
$table->string('option_label')->nullable();
});
Schema::create('memberships', function (Blueprint $table) {
$table->id();
$table->foreignId('user_id')->constrained()->cascadeOnDelete();
$table->foreignId('party_id')->constrained()->restrictOnDelete();
$table->string('role')->default('mitglied');
$table->boolean('may_order')->default(false);
$table->date('valid_from')->nullable();
$table->date('valid_until')->nullable();
$table->timestamps();
$table->unique(['user_id', 'party_id']);
});
Schema::table('acquisitions', function (Blueprint $table) {
$table->foreignId('acting_user_id')->nullable()->constrained('users')->nullOnDelete();
});
Schema::table('orders', function (Blueprint $table) {
$table->unsignedInteger('total_cents')->nullable();
$table->string('currency', 3)->default('EUR');
});
Schema::table('order_lines', function (Blueprint $table) {
$table->string('currency', 3)->default('EUR');
$table->string('tax_class')->nullable();
$table->string('grant_kind')->nullable();
$table->foreignId('holder_party_id')->nullable()->constrained('parties')->restrictOnDelete();
});
// Bestehende Bestellungen: Summe und Inhaber der Position aus den vorhandenen Angaben.
foreach (DB::table('orders')->get() as $order) {
DB::table('orders')->where('id', $order->id)->update([
'total_cents' => (int) DB::table('order_lines')->where('order_id', $order->id)->sum('price_cents'),
]);
DB::table('order_lines')->where('order_id', $order->id)->update(['holder_party_id' => $order->party_id]);
}
}
public function down(): void
{
Schema::table('order_lines', function (Blueprint $table) {
$table->dropConstrainedForeignId('holder_party_id');
$table->dropColumn(['currency', 'tax_class', 'grant_kind']);
});
Schema::table('orders', function (Blueprint $table) {
$table->dropColumn(['total_cents', 'currency']);
});
Schema::table('acquisitions', function (Blueprint $table) {
$table->dropConstrainedForeignId('acting_user_id');
});
Schema::dropIfExists('memberships');
Schema::table('offers', function (Blueprint $table) {
$table->dropConstrainedForeignId('composition_id');
$table->dropColumn('option_label');
});
}
};
@@ -0,0 +1,44 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* „Medium löschen“ (Medien ohne Fassung) muss auch Standbilder aus Filmen und übernommene CMS-Bilder erreichen.
*
* - film_still_sources: Die Herkunftszeile eines gelöschten Standbilds entfällt (cascade); dieselbe Stelle kann neu
* übernommen werden.
* - website_media_aliases: Die Zuordnung bleibt als Sperre bestehen (content_element_id wird leer). Ein früherer Pfad
* mit gelöschtem Medium wird nicht wieder über /medien/cms/… ausgeliefert und nicht mehr als Bild gezeigt.
*
* Lockert nur Fremdschlüssel; bestehende Daten bleiben unverändert (rückwärtskompatibel).
*/
return new class extends Migration
{
public function up(): void
{
Schema::table('film_still_sources', function (Blueprint $table) {
$table->dropForeign(['still_element_id']);
});
Schema::table('film_still_sources', function (Blueprint $table) {
$table->foreign('still_element_id')->references('id')->on('content_elements')->cascadeOnDelete();
});
Schema::table('website_media_aliases', function (Blueprint $table) {
$table->dropForeign(['content_element_id']);
});
Schema::table('website_media_aliases', function (Blueprint $table) {
$table->unsignedBigInteger('content_element_id')->nullable()->change();
});
Schema::table('website_media_aliases', function (Blueprint $table) {
$table->foreign('content_element_id')->references('id')->on('content_elements')->nullOnDelete();
});
}
public function down(): void
{
// Bewusst leer: Die gelockerten Fremdschlüssel schaden älterem Code nicht, und leere Zuordnungen
// (gelöschte Medien) ließen sich nicht in den strengeren Zustand zurückführen.
}
};
@@ -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');
}
};
+189
View File
@@ -0,0 +1,189 @@
<?php
namespace Database\Seeders;
use App\Domain\Catalog\ArticleService;
use App\Domain\Catalog\BundleService;
use App\Domain\Catalog\CompositionDisplayRelease;
use App\Domain\Catalog\CompositionVersion;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\RightsProfileVersion;
use App\Domain\Identity\AccountStatus;
use App\Domain\Identity\Membership;
use App\Domain\Identity\Party;
use App\Domain\Identity\PartyType;
use App\Domain\Identity\RegisterAccount;
use App\Models\User;
use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
/**
* Testdaten für den Testkauf (Etappe 1): zwei Programme mit Film und Begleitmaterial, ein Starterpaket, die
* Lizenzoptionen für Privatpersonen und für einen Verein, ein Testverein mit bestellberechtigtem Konto und drei
* Testkonten. Nur für Entwicklung und die Testinstanz; in Produktion läuft der Seeder nicht.
* Mehrfach ausführbar: Vorhandenes bleibt unverändert.
*/
class ShopDemoSeeder extends Seeder
{
/** Nur für automatisierte Tests. Außerhalb von Tests gilt LUF_DEMO_PASSWORD oder ein zufälliges Passwort. */
public const PASSWORD = 'testkauf-passwort-1';
private ?string $password = null;
public function run(): void
{
if (app()->isProduction() || LicenseArticle::query()->where('code', 'shop-konflikte')->exists()) {
return;
}
$content = app(ContentService::class);
$articles = app(ArticleService::class);
$bundles = app(BundleService::class);
$offers = app(OfferService::class);
$this->password = app()->runningUnitTests()
? self::PASSWORD
: (getenv('LUF_DEMO_PASSWORD') ?: Str::random(24));
$editor = $this->account('Demo Redaktion', 'shop-demo-redaktion@example.test');
[$konflikteVersion, $konflikteArticle] = $this->program(
$content, $articles, $editor, 'shop-konflikte', 'Konflikte im Training',
'Wie Trainerinnen und Trainer Konflikte in der Gruppe ruhig und klar begleiten.',
'Ein Film, ein Arbeitsblatt und eine Anleitung für sechs Trainingseinheiten.',
'Konflikte erkennen, benennen und gemeinsam lösen.',
);
[$grenzenVersion, $grenzenArticle] = $this->program(
$content, $articles, $editor, 'shop-grenzen', 'Grenzen setzen im Verein',
'Sicher auftreten, Grenzen vermitteln und Kinder stärken.',
'Film und Begleitmaterial für einen Übungsabend zu Grenzen und Respekt.',
'Grenzen verständlich vermitteln.',
);
[$starterVersion, $starterArticle] = $this->program(
$content, $articles, $editor, 'shop-starter', 'Starterpaket für neue Trainer',
'Das Einstiegspaket mit beiden Programmen und einer Einführung für neue Trainerinnen und Trainer.',
'Zusätzlich zu beiden Programmen enthält das Paket eine Einführung ins Konzept.',
'Das Konzept kennenlernen.',
);
$privat = $offers->createRightsProfile('Privatlizenz ehrenamtlich', 'ehrenamtlich', [
'film' => ['streamen', 'laden'],
'pdf' => ['ansehen', 'laden'],
]);
$verein = $offers->createRightsProfile('Vereinslizenz institutionell', 'institutionell', [
'film' => ['streamen', 'laden'],
'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');
$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->assignProduct($paket, $starterVersion->composition_id, 'Starterpaket (zwei Programme und Einführung)');
$tina = $this->account('Tina Trainerin', 'tina.trainerin@example.test');
$vera = $this->account('Vera Vorstand', 'vera.vorstand@example.test');
$max = $this->account('Max Mitglied', 'max.mitglied@example.test');
$club = Party::query()->firstOrCreate(
['type' => PartyType::Organisation, 'display_name' => 'Testverein Musterstadt e. V.'],
);
Membership::query()->firstOrCreate(['user_id' => $vera->id, 'party_id' => $club->id], ['role' => 'org_admin', 'may_order' => true]);
Membership::query()->firstOrCreate(['user_id' => $max->id, 'party_id' => $club->id], ['role' => 'mitglied', 'may_order' => false]);
unset($tina);
if (! app()->runningUnitTests()) {
$this->command?->info('Testkonten angelegt (tina.trainerin, vera.vorstand, max.mitglied und shop-demo-redaktion bei example.test). Passwort: '.($this->password));
}
}
/**
* Zwei Dateien (Film, Begleitmaterial) als Platzhalter im Speicher, ein Programm als Komposition mit
* Anzeigefreigabe und ein Lizenzartikel dazu.
*
* @return array{0: CompositionVersion, 1: LicenseArticle}
*/
private function program(
ContentService $content,
ArticleService $articles,
User $editor,
string $code,
string $title,
string $teaser,
string $summary,
string $goal,
): array {
$disk = Storage::disk('media_derived');
$disk->put('inhalte/'.$code.'/film.mp4', 'Platzhalter für den Film '.$title);
$disk->put('inhalte/'.$code.'/begleitmaterial.pdf', "%PDF-1.4\n% Platzhalter für das Begleitmaterial ".$title."\n%%EOF\n");
$film = $content->publishElementVersion(
$content->createElement('film', 'film', 'Film '.$title),
null,
['file' => 'inhalte/'.$code.'/film.mp4'],
);
$sheet = $content->publishElementVersion(
$content->createElement('pdf', 'pdf', 'Begleitmaterial '.$title),
null,
['file' => 'inhalte/'.$code.'/begleitmaterial.pdf'],
);
$composition = $content->createComposition($title);
$composition->editorial_content_kind_id = EditorialContentKind::query()->where('slug', 'programm')->value('id');
$composition->display_title = $title;
$composition->teaser = $teaser;
$composition->summary = $summary;
$composition->save();
$version = $content->publishComposition(
$composition,
[['role' => 'Film', 'target' => $film], ['role' => 'Begleitmaterial', 'target' => $sheet]],
null,
null,
['learning_goal' => $goal],
);
app(CompositionDisplayRelease::class)->release($version, $editor);
$article = $articles->create($code, 'Testkauf');
$article->working_title = $title;
$article->display_title = $title;
$article->save();
$articles->publishRelease($article, $version, 'Programm für den Testkauf.');
return [$version, $article->fresh()];
}
/**
* @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
{
$offer = $offers->create($name);
$offers->activate($offer, [['target' => $line[0], 'rights' => $line[1]]], [
'grant_kind' => 'kauf',
'price_cents' => $cents,
'holder_kind' => $holder,
]);
$offers->assignProduct($offer, $version->composition_id, $label);
return $offer;
}
private function account(string $name, string $email): User
{
$existing = User::query()->where('email', $email)->first();
if ($existing !== null) {
return $existing;
}
$user = app(RegisterAccount::class)->register($name, $email, (string) $this->password, true);
$user->forceFill(['email_verified_at' => now(), 'status' => AccountStatus::Aktiv])->save();
return $user;
}
}
@@ -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,75 @@
# Medien- und Materialkarte: Textwahl und Bild aus dem Film – Bericht (21.11.2026)
Branch `feature/medienkarte-text-und-filmbild`, gearbeitet in einem separaten Worktree, Deploy ausschließlich über `develop` (Testinstanz). Kein Merge nach `main`. Technik: `docs/architektur/medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“, und `cms-widget-registry.md` §13.
## 1. Anforderung 1: Text der Karte wählen
**Ausgangslage.** Die Karte nahm immer die Kurzbeschreibung, den Teaser nur als Ersatz, die ausführliche Beschreibung nie.
**Jetzt.** Im Reiter „Darstellung“ der Medienkarte gibt es „Text der Karte“:
| Wahl | Text |
|---|---|
| Automatisch (Vorgabe) | Kurzbeschreibung, sonst Teaser, unverändert zu vorher; bestehende Karten ändern sich nicht |
| Teaser | `teaser` |
| Kurzbeschreibung | `summary` |
| Ausführliche Beschreibung | `description`, der Dialog nennt „erscheint öffentlich“ |
- Eine ausdrückliche Wahl ersetzt **nicht still** durch ein anderes Feld. Ist der Text nicht gepflegt, bleibt die Karte ohne Text; die Redaktionsvorschau nennt, wo er zu pflegen ist (öffentlich nie ein Hinweis).
- Der eigene Text der Karte („Text nur für diese Karte“) hat weiter Vorrang. Sein Platzhalter im Editor zeigt jetzt den gewählten zentralen Text.
- Einsatzhinweis und Lizenzvermerk sind nicht wählbar und erscheinen nie.
- Die Wahl gibt es nur an der Medienkarte, nicht an Themen- und Programmkarte.
**Entschieden durch diese Arbeit:** Die **ausführliche Beschreibung ist auf ausdrückliche Wahl öffentlich**, bisher war sie Bibliothekstext. Die Doku (`medienzugriff-fuer-komponenten.md`) stand dem entgegen und ist angepasst. Öffentlich ist die Karte weiterhin nur, wenn das Medium zu einem öffentlich gezeigten Programm gehört.
## 2. Anforderung 2: Bild aus dem Film
**Ursache der Sperre.** Das Vorschaubild eines Films ist ein geschütztes Bibliotheksbild und für die Website nicht freigegeben. `WebsiteRelease` kann bei Filmen nur ein Teaser-Video freigeben, kein Standbild. Die Karte zeigte es deshalb nur in der Redaktionsvorschau.
**Lösung, ohne neue Freigabelogik.** Im Reiter „Medien“ der Medienkarte erscheint bei einem Film das Feld „Bild aus dem Film“:
1. **„Vorschaubild des Films übernehmen“**: übernimmt das im Medienmanager gesetzte Vorschaubild. Stammt es aus einer Filmstelle, wird dieselbe Stelle in voller Auflösung neu gezogen.
2. **Stelle wählen**: Zeitposition eingeben, „Anzeigen“ (Vorschau), „Dieses Bild übernehmen“.
`FilmStill` zieht das Einzelbild **einmal** und legt es über das vorhandene `WebsiteIntake` als gewöhnliches Bild-Medium im Medienmanager ab. Die Warteschlange leitet es ab und gibt es frei, wie bei jedem Upload aus dem CMS. Die Karte speichert nur dessen Kennung in `refs.image`.
- **Kein Neuziehen bei Seitenaufrufen:** Die Karte liest nur die gespeicherte Datei. Ein Test zählt die Extraktionen: Drei Seitenaufrufe starten keine.
- **Einmal je Stelle:** Dieselbe Stelle (auch über den anderen Weg) ergibt dasselbe Medium. Eine neue Tabelle `film_still_sources` (additiv) hält die Herkunft fest.
- **Auflösung:** bis 1600 px Breite aus der Mediendatei, nie über die Breite der Quelle hinaus vergrößert. Geprüft mit echten Videos: 1280 px bleiben 1280, 2560 px werden 1600. Auf der Testinstanz kamen Bilder mit 1600 px aus dem Film.
- **Rechte:** Es wird nie der Film abgelegt, nur ein Einzelbild; keine Fassung, keine Berechtigung, kein Lizenzartikel. Ausgeschlossen sind Traineranleitungen, archivierte Filme und Filme ohne bereitgestellte Fassung. Die Handlung ist ausdrücklich (Redakteur, dieselbe Rolle wie beim Upload). Das entstandene Bild lässt sich im Medienmanager („Website“) wieder zurücknehmen.
- **Das Bild ist ein eigenes Medium** („Standbild: {Film} (Fassung n, x s)“, Alternativtext „Szene aus dem Film …“, Quellenzeile des Films). Es folgt späteren Änderungen am Vorschaubild des Films nicht. Wer es als Titelbild des Films für alle Karten nutzen will, ordnet es im Medienmanager als Präsentationsmedium zu.
## 3. Prüfung
| Prüfung | Ergebnis |
|---|---|
| Testsuite | 453 grün (davon neu: 4 Textwahl, 9 Filmbild einschließlich Wiederverwendung, gescheiterte Verarbeitung, Löschen). Die Extraktion (`ffmpeg`) ist dort gestubbt. |
| CI und Deploy | CI 4983 und Deploy 4984 für den ersten Stand (Commit `886715a`); die Korrektur (`cd66561`) steht in der Übergabe. |
| `ffmpeg`-Skalierung | mit echten Videos geprüft (siehe oben) |
| Bestehende Seiten vor und nach dem Deploy | unverändert: 16 Messungen der Geometrie, 12 Textvergleiche, 16 Bilder |
| Oberfläche lokal (echter Test-Film) | 16 von 16 |
| Oberfläche auf der Testinstanz, regulärer Seitenkonfigurator, Film „Lara im Park“ mit allen drei Texten | **16 von 16**: Vorschaubild übernommen (Stelle 41,5 s), eine Stelle gewählt (12 s), dieselbe Stelle noch einmal ergab dasselbe Medium, Textwahl in allen vier Stufen entspricht den gepflegten Feldern, Einsatzhinweis und Lizenzvermerk erschienen nie, wieder geöffnet, Vorschau zeigt das gespeicherte Bild über `/website-medien/…` (1600 px), Entwurf öffentlich nicht erreichbar |
| Rücknahme der angelegten Bilder auf der Testinstanz | beide Medien zurückgenommen, `/website-medien/…` liefert 404 |
**Nicht live gezeigt:** Die öffentliche Darstellung der Karte auf einer veröffentlichten Seite der Testinstanz. Es durfte nur ein Entwurf entstehen. Die öffentlichen Regeln belegen die Feature-Tests.
**Beim Prüfen gefunden und behoben (Commit `cd66561`):**
- Wählt die Redaktion eine schon übernommene, inzwischen zurückgenommene Stelle erneut, bekam sie dasselbe Bild zurück, die Meldung versprach aber eine Freigabe. Jetzt nennt die Meldung den tatsächlichen Stand (bereits freigegeben, wird verarbeitet, Freigabe zurückgenommen) und weist auf den Medienmanager hin. Ein bei der Verarbeitung gescheitertes oder archiviertes Bild wird nicht wiederverwendet.
- „Medium löschen“ wäre bei Standbildern und, aus meiner früheren Umstellung, bei übernommenen CMS-Bildern an einem Fremdschlüssel gescheitert. Das Löschen funktioniert jetzt; ein gelöschtes übernommenes Medium macht seine frühere Adresse nicht wieder öffentlich (404, kein Bild).
## 4. Auf der Testinstanz zurückgeblieben
- Entwurf `/medienkarte-pruefung-entwurf` (Seite 23); seine Karte A verweist auf das zurückgenommene Standbild.
- Die Medien „Standbild: Lara im Park (Fassung 1, 41,5 s)“ und „… (Fassung 1, 12 s)“, beide zurückgenommen.
- Aus früheren Prüfungen: die Entwürfe `/karten-nachbesserung-entwurf` und `/medien-pruefung-entwurf` sowie das Medium „Platzhalter Upload Medienpruefung“.
Seiten lassen sich nicht löschen; die Medien über „Medium löschen“ im Medienmanager.
## 5. Grenzen und offene Fragen
1. **Vorschau und übernommenes Bild:** Die Vorschau im Dialog kommt aus der kleinen Stufe (640 px), das übernommene Bild aus der Mediendatei. Beim Springen auf dieselbe Sekunde können beide minimal abweichen.
2. **Das Bild folgt dem Film nicht.** Ändert die Redaktion später das Vorschaubild des Films, bleibt die Karte beim übernommenen Bild.
3. **Das übernommene Bild ist ein eigenes Medium und hat eigene Rechte:** Wird der Film zurückgezogen, bleibt das Bild, solange es nicht ausdrücklich zurückgenommen wird.
4. **Frage:** Sollen Karten die Zielgruppe `cms` („CMS-Teaser“) statt `bibliothek` für abweichende Formulierungen lesen? Heute wird `cms` nirgends gelesen; ein Wechsel würde bestehende Karten ändern.
5. **Frage:** Die Programmkarte nimmt zuerst den Teaser, die Medienkarte zuerst die Kurzbeschreibung. Soll das einheitlich werden?
6. **Weiter offen:** eine öffentliche Filmvorschau (Trailer, Ausschnitt) und die Laufzeit, siehe Registry §13.
+3 -1
View File
@@ -353,7 +353,7 @@ ## 5. Bestellung, Zahlung, Ausgabe
- `ORDER_SCOPE_ITEM` ist die Kopie des aufgelösten Umfangs **zum Kaufzeitpunkt** je Bestellposition (INV-02). Sie enthält alles, was zur Rekonstruktion nötig ist: Artikel, den **kopierten** Rechteschnappschuss, den damals aktuellen Stand, Laufzeit, Updatezusage und bei Organisationsangeboten die Sitzzahl. Auch wenn Paket, Angebot oder Rechteprofil später neue Fassungen erhalten oder archiviert werden, bleibt der vereinbarte Umfang lesbar (PROD-006, PAY-005).
- Nach bestätigter Zahlung wird die Bestellposition zu genau einem Erwerb; aus jedem Umfangseintrag entsteht genau eine Berechtigung dieses Erwerbs.
- `PAYMENT` hält die beim Anlegen des Checkouts gespeicherte Referenz des Zahlungsdienstes und den **abgefragten** Zustand (INV-20). Eine zweite Zahlungsart „Überweisung auf Rechnung“ wird vom Betreiber nach Geldeingang bestätigt; sie durchläuft dieselbe Bestellung mit Umfangskopie und Zustimmungen und ist der vorgesehene Weg für Schulen und Vereine (`07`, Ablauf 3).
- `PAYMENT` hält beim Stripe-Checkout die vom Kern gespeicherte Dienstreferenz und den abgefragten Zahlungszustand (INV-20). Für Vereine steht auf Anfrage Überweisung auf Rechnung zur Verfügung. Auch dort gibt es eine Bestellung mit Umfangskopien und Zustimmungen. Der Betreiber erstellt die Rechnung manuell und bestätigt den Eingang in der Bestellverwaltung (`07`, Ablauf 3).
- `PAYMENT_EVENT` mit eindeutiger Ereigniskennung je Dienst ist der Eingangskorb für Zahlungsmeldungen. Eine Meldung ist ein **Auslöser**, kein Zustand; doppelte Meldungen sind wirkungslos (SC-24).
- `DELIVERY_RECORD` (Ausgabenachweis) verbindet Konto, tragende Berechtigung, Zugriffsweg, Artikel-Stand, Inhaltsfassung, Kennzeichnung und Zeitpunkt (INV-10, VER-009).
- `CONDITIONS_VERSION` hält den **Wortlaut** von Lizenzbedingungen, AGB und Widerrufsbelehrung unveränderlich mit Prüfsumme in der Kerndatenbank. Die öffentliche Seite im CMS zeigt diesen Wortlaut an; sie ist nicht dessen Archiv.
@@ -375,6 +375,8 @@ ### 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.
## 6. Stabile Identitäten im Überblick
| Objekt | Identität bleibt bei | Neue Identität bei |
@@ -78,6 +78,8 @@ ## 3. Zustände einer Berechtigung
## 4. Die Berechtigungsentscheidung
`App\Domain\Entitlement\DecideAccess` ist der vorhandene Einstieg für die zentrale Rechteprüfung und wird zum gemeinsamen Lizenzmanager ausgebaut. Der Mitgliederbereich übergibt ihm angemeldetes Konto, Lizenzartikel, konkrete Inhaltsfassung und Aktion. Der Lizenzmanager prüft Erwerb, Gültigkeit, Produktbezug und erlaubte Aktion. Bei jeder geschützten Ausgabe ist seine serverseitige Entscheidung maßgeblich, auch bei Aufruf einer direkten Download-URL. `GrantIssuer` bleibt der gemeinsame Weg für die Rechtevergabe. Artikel und Verkaufsangebote weiterer Produktlinien der Dachmarke müssen das gleiche Entscheidungsprinzip verwenden. Produktbezogene Rechte richten sich nach der erworbenen Lizenz. Eine plattformübergreifende Dienstgrenze wird erst bei konkretem Integrationsbedarf festgelegt.
Eine einzige Funktion entscheidet jede Medienaktion (MED-003). Sie prüft zuerst, **ob das Angefragte zusammengehört**, und erst danach, ob ein Recht daran besteht.
```text
@@ -220,7 +222,7 @@ ## 7. Überlappung, Entzug und Erstattung (LIC-005, SC-12)
|---|---|---|
| Vollerstattung einer Bestellung | alle Berechtigungen aller Positionen dieser Bestellung → widerrufen | ja |
| Erstattung einer einzelnen Position | Berechtigungen dieser Position → widerrufen | ja, wenn Position benannt |
| Teilerstattung ohne Positionsbezug | keine automatische Änderung; Aufgabe für den Betreiber: Positionen wählen oder als Kulanz ohne Rechteänderung abschließen | geführt (Lücke L-06) |
| Externe Teilerstattung ohne Positionsbezug | keine automatische Rechteänderung; Betreiber prüft Zuordnung und Wirkung | Ausnahmefall |
| Rückbuchung eröffnet | Berechtigungen der Bestellung → ausgesetzt | ja |
| Rückbuchung verloren | → widerrufen | ja |
| Rückbuchung gewonnen | → aktiv | ja |
@@ -235,6 +237,10 @@ ## 7. Überlappung, Entzug und Erstattung (LIC-005, SC-12)
Beispiel SC-11: K hat `G_frei(A, Frei-Mitglied)` und `G_kauf(A, E-Download)`. Endet das kostenlose Angebot mit Regel „solange Angebot aktiv“, läuft `G_frei` ab. `G_kauf` trägt weiter Streamen und Laden. Die Bibliothek zeigt **einen** Eintrag für `A` mit den wirksamen Aktionen und darunter die Herkunft beider Berechtigungen.
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.
## 8. Gezieltes Upgrade (LIC-007, LIC-012, SC-09)
### 8.1 Regel
@@ -281,6 +287,8 @@ ### 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.
```text
weise_sitz_zu(pool, konto, ausführender):
prüfe: ausführender ist Betreiberpersonal
@@ -105,6 +105,8 @@ ### 4.2 Vor der Veröffentlichung
## 5. Der Veröffentlichungsvorgang
Neue Angebotsfassungen werden zum Start durch den Betreiber manuell aktiviert. Verbindliche Änderungen an Preis, Leistungsumfang oder Lizenzbedingungen gehören in eine neue Fassung. Die Aktivierung ändert die Konditionen für künftige Bestellungen. Bestehende Bestellpositionen behalten ihre Umfangs- und Konditionenkopie. Der Warenkorb prüft Preis und Kaufbarkeit gegen den aktiven Stand gemäß `07`, Ablauf 3. Eine zeitgesteuerte Umschaltung ist für den Start nicht erforderlich.
Ein Veröffentlichungsvorgang bündelt alles, was **gemeinsam** wirksam werden soll: neue Artikel-Stände, neue Angebotsfassungen, Rückzüge. Für eine neue Episode (SC-04) sind das zum Beispiel ein neuer Lizenzartikel mit Stand 1, ein Einzelangebot und eine neue Fassung des Themenpakets.
```mermaid
+16 -6
View File
@@ -64,6 +64,8 @@ ## Ablauf 2 – Registrierung und kostenlose Berechtigungen (SC-02)
## Ablauf 3 – Kauf mit Zahlungsbestätigung (PAY-002)
Der Käufer wählt Einzel- oder Mehrfachlizenz. Bei einer Vereinsbestellung wird der Verein als Lizenzinhaber und das auslösende Mitgliederkonto als Downloadkonto festgehalten. Nach bestätigtem Geldeingang erscheinen die Downloads ausschließlich in diesem Konto. Vor Freischaltung oder aus einem anderen Konto wird die Ausgabe aus dieser Bestellung verweigert. Für die Prüfung gilt der zentrale Lizenzmanager aus `05`, Abschnitt 4.
```mermaid
sequenceDiagram
actor K as Kunde
@@ -72,9 +74,9 @@ ## Ablauf 3 – Kauf mit Zahlungsbestätigung (PAY-002)
participant P as Zahlungsdienst
participant L as Lizenzen
participant N as Benachrichtigung
K->>S: Angebot wählen, Kundenart, Rechnungsdaten
S->>KA: Angebotsfassung und aufgelöster Umfang
S->>S: Bestellung "offen" mit Umfangskopie und Zustimmungsnachweisen
K->>S: Warenkorb mit gewählten Lizenzoptionen, Kundenart und Rechnungsdaten prüfen
S->>KA: Aktive Fassungen, Preise und Lizenzumfang je Position prüfen
S->>S: Bestellung offen mit Bestellkopie je Position und Zustimmungsnachweisen
S->>P: Checkout anlegen mit Bestellreferenz und Idempotenzschlüssel
P-->>S: Referenz des Dienstes
S->>S: Referenz an der Zahlung speichern
@@ -90,10 +92,16 @@ ## Ablauf 3 – Kauf mit Zahlungsbestätigung (PAY-002)
S->>L: vergib(Erwerb = Bestellposition, Umfangskopie)
S->>S: Bestellung "bezahlt" und Ereignis "verarbeitet", alles in einer Transaktion
S-->>N: Ereignis: Bestellung bezahlt
N->>K: Bestätigung, Rechnung, Hinweis zum Widerrufsrecht
N->>K: Bestätigung und die für den Verkaufsstart festgelegten Informationen
S-->>K: Statusseite wechselt zu "freigeschaltet"
```
**Warenkorb vor Bestellabschluss.** Die Auswahl reserviert weder Preis noch Konditionen. Bei geändertem Preis zeigt das System die Änderung an. Der Käufer kann zum neuen Preis bestellen oder die Position entfernen. Bei geänderten verbindlichen Konditionen zeigt der Checkout die neue Auswahl vor Abschluss an. Ein zurückgezogenes Angebot bleibt mit Hinweis sichtbar und blockiert den Abschluss, bis der Käufer es selbst entfernt. Der Checkout prüft Preis und Kaufbarkeit serverseitig erneut und speichert die vereinbarte Angebotsfassung, Preis, Konditionen und Lizenzumfang je Position.
**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.
Entscheidende Punkte:
1. Die Bestellung mit Umfangskopie entsteht **vor** dem Zahlungsschritt. Was vereinbart wurde, steht fest, bevor Geld fließt (INV-02, INV-11).
@@ -104,7 +112,7 @@ ## Ablauf 3 – Kauf mit Zahlungsbestätigung (PAY-002)
6. **Zahlung auf eine verworfene oder abgelaufene Bestellung:** Die Umfangskopie besteht weiter. Die Bestellung wird wieder aufgenommen und aus der Umfangskopie freigeschaltet; zugleich erscheint sie in der Ausnahmeliste. Ist ein enthaltener Artikel inzwischen ohne nutzbaren Stand, entsteht stattdessen eine Betreiberaufgabe „freischalten oder erstatten“. In keinem Fall bleibt Geld ohne definiertes Ergebnis.
7. Kostenlose Angebote und manuelle Freigaben überspringen den Zahlungsschritt vollständig (PAY-002).
**Zahlungsart „Überweisung auf Rechnung“** (Schulen, Vereine): dieselbe Bestellung mit Umfangskopie und Zustimmungen; statt des Checkouts erhält der Kunde eine Rechnung mit Zahlungsziel. Der Betreiber bestätigt den Geldeingang in einem protokollierten Vorgang; erst dann wird wie oben vergeben. Erstattung und Stornierung laufen über denselben Erstattungsfall. Dieser Weg ersetzt die „manuelle Vergabe nach Geldeingang“, die Kaufgegenstand und Zustimmungen umgehen würde (Befund CH-56).
**Zahlungswege.** Stripe ist der Standard. Vereine können auf Anfrage per Überweisung auf Rechnung kaufen. Der Betreiber erstellt die Rechnung zunächst manuell, ordnet sie der Bestellung zu und bestätigt den Geldeingang in der Bestellverwaltung. Die Bestellung trägt dieselben Umfangskopien und Zustimmungsnachweise wie ein Stripe-Kauf. Bei offener Rechnung bleiben die Rechte gesperrt. Nach bestätigter Zahlung erfolgt die Vergabe je Bestellposition wiederholsicher. Der erste Testkauf verwendet Testzahlung. Live-Zahlung und Belegprozess gehören zum Verkaufsstart.
Verbraucherschutz im Ablauf: Bei Kundenart „Verbraucher“ zeigt die Bestellseite die Pflichtangaben und holt die ausdrückliche Zustimmung zum sofortigen Beginn sowie die Kenntnisnahme zum Erlöschen des Widerrufsrechts ein, wenn der Betreiber dieses Modell wählt. Beide werden als Zustimmungsnachweis gespeichert und in der Bestätigungsmail wiederholt. Ohne diese Zustimmung bleibt das Widerrufsrecht bestehen; ein Widerruf läuft dann über Ablauf 5. Die genaue Ausgestaltung ist rechtlich zu prüfen (`11`, Abschnitt 8).
@@ -154,6 +162,8 @@ ## Ablauf 4 – Doppelte, verspätete und verlorene Zahlungsmeldungen (SC-24)
## Ablauf 5 – Erstattung, Teilerstattung, Rückbuchung, Widerruf (PAY-004, SC-12)
Zum Verkaufsstart sind keine freiwilligen Teilerstattungen vorgesehen. Ein Bundle wird als Einheit zurückgegeben. Externe Teilbeträge und gesetzliche Sonderfälle werden geprüft. Der konkrete gesetzliche Widerrufsweg und die Belegkorrektur sind vor dem Verkaufsstart festzulegen.
```mermaid
sequenceDiagram
actor B as Betreiber
@@ -161,7 +171,7 @@ ## Ablauf 5 – Erstattung, Teilerstattung, Rückbuchung, Widerruf (PAY-004, SC-
participant P as Zahlungsdienst
participant L as Lizenzen
participant N as Benachrichtigung
B->>S: Erstattung für Bestellung X, Positionen wählen, Grund
B->>S: Vollerstattung oder geprüften gesetzlichen Erstattungsfall mit Grund einleiten
S->>S: Erstattungsfall anlegen
S->>P: Erstattung auslösen, Idempotenzschlüssel
P->>S: Ereignis "erstattet"
@@ -25,7 +25,7 @@ ### A.2 Seitentypen
| Freie Inhaltsseite | Start, Methodik, Zielgruppen, Über uns, Aktionen | reine Bausteinseite |
| Themenseite | bündelt Episoden zu einem Thema | Episodenliste aus dem Katalog, redaktioneller Rahmen frei |
| Episoden-/Artikelseite | stellt einen Lizenzartikel vor | Kernangaben aus dem Katalog, redaktionelle Ergänzung frei |
| Angebots-/Paketseite | erklärt ein Angebot und seinen Umfang | Umfang und Rechtevergleich aus der Angebotsfassung |
| Gemeinsame Angebotsseite | erklärt fachlichen Inhalt, Umfang und Bestandteile des Produkts; zeigt darunter die kaufbaren Lizenzoptionen | Inhalts- und Katalogdaten für die Beschreibung; aktive Angebotsfassungen für Rechte, Preis und Bedingungen |
| Übersichtsseiten | Filme, Übungen, Programme, kostenfreies Angebot | gefilterte Listen aus dem Katalog |
| Informationsseiten Trainer/Institutionen | Erklärung, Kontaktwege | Bausteinseite |
| Rechtstexte | Impressum, Datenschutz, AGB, Lizenzbedingungen, Widerruf | Vertragsrelevante Texte (AGB, Lizenzbedingungen, Widerrufsbelehrung) liegen als **unveränderliche Bedingungsfassungen mit Prüfsumme im Kern** (`04`, Abschnitt 5); die Seite zeigt die jeweils gültige Fassung an. Das CMS ist nicht ihr Archiv. Impressum und Datenschutzerklärung sind gewöhnliche Seiten. |
@@ -42,6 +42,7 @@ ### A.3 Bausteinbibliothek
| Artikelkarte / Artikelliste | Lizenzartikel, aktueller Stand | Titel, Kurzbeschreibung, Zielgruppe, Dauer, Vorschaubild |
| Vorschauplayer | Vorschauformat des aktuellen Stands | öffentliche Vorschau |
| Lernziele und Bestandteile | aktueller Stand → Komposition | Lernziele, Liste der enthaltenen Materialien nach Rolle |
| Durchsuchbare Shop-Seite und redaktionelle Angebotskacheln | machen kaufbare Produkte auffindbar und öffnen ihre gemeinsame Angebotsseite | veröffentlichter Shop-Katalog; Kacheln referenzieren den Katalogeintrag |
| Rechtevergleich | Angebotsfassungen zum Artikel | Tabelle Zweck × Aktionen je Materialart, Preis, Laufzeit |
| Angebotsumfang | aufgelöster Umfang der Angebotsfassung | enthaltene Artikel, mit Verlinkung |
| Kauf-/Registrierungsaufruf | Angebotsfassung | zustandsabhängig: kaufen, bereits vorhanden, erweitern |
+4 -2
View File
@@ -129,7 +129,7 @@ ## 6. Zahlung
| Verkäufermodelle (Dienst als Vertragspartner des Kunden) | siehe Stripe; weitere Anbieter nicht geprüft | nimmt Steuer- und Rechnungspflichten im Ausland ab; dafür ist der Dienst Verkäufer, was Lizenzvertrag, Rechnung und Widerruf anders ordnet. Nur sinnvoll bei nennenswertem Auslandsverkauf an Verbraucher. |
| PayPal direkt | nicht geprüft | als Zahlungsmethode über die genannten Dienste erreichbar |
**Architekturaussage:** Der Zahlungsdienst sitzt hinter einem Adapter mit vier Operationen: Checkout anlegen, Ereignis prüfen und normalisieren, Status abfragen, Erstattung auslösen. Maßgeblich für jede Freischaltung und jeden Entzug ist die **Statusabfrage**, nicht der Inhalt des Ereignisses (INV-20). Kein Fachobjekt hängt an einem Anbieter. Die Wahl ist offen (PAY-006) und hängt an der steuerlichen Ausgangslage (Lücke L-15).
**Architekturaussage:** Stripe ist für den Start gewählt. Mollie bleibt eine Alternative. Der Dienst sitzt hinter einem Adapter für Checkout, Ereignisprüfung und Normalisierung, Statusabfrage und Erstattung. Für Freischaltung und Entzug ist die abgefragte Zahlungsinformation maßgeblich (INV-20). Fachobjekte bleiben anbieterunabhängig.
**Zahlung per Überweisung auf Rechnung** (Schulen, Vereine, öffentliche Träger) ist keine Aufgabe des Zahlungsdienstes, sondern eine zweite Zahlungsart der Bestellung mit Bestätigung des Geldeingangs durch den Betreiber (`07`, Ablauf 3). Sie braucht den Rechnungsweg aus Abschnitt 7 und gehört spätestens zu Stufe A4.
@@ -145,6 +145,8 @@ ## 7. Rechnung und Steuer
**Empfehlung:** Rechnungsdienst hinter einem Adapter; der Kern speichert Rechnungsnummer und eine unveränderliche Kopie. Die Produktwahl sollte der Steuerberatung folgen. Konkrete Dienste wurden nicht geprüft.
**Rechnungsweg zum Start:** Manuelle Erstellung mit Bestellbezug und manuelle Bestätigung des Geldeingangs bei Vereinsüberweisungen. Eine spätere Faktura-Integration bleibt eine Ausbauoption. Steuerstatus, Belegpflichten und Korrekturvorgaben sind vor dem Verkaufsstart zu klären.
## 8. Identität
| Option | Bewertung |
@@ -187,7 +189,7 @@ ## 11. Was vor der Umsetzung noch geprüft werden muss
0. **Kernstapel:** der Machbarkeitsnachweis aus Abschnitt 2.1 mit seinem Abbruchkriterium.
1. Je nach Ergebnis – Kandidat A: Pflegezustand des Zusatzpakets für die Warteschlange; Lizenz der PDF-Bibliothek. Kandidat B: Weg zu Entwurf, Vorschau und Revisionen für Seiten (Eigenbau oder Paket); Zusatzmodul oder Vorverarbeitung für neuere PDFs.
2. Discourse, vor Stufe A3 als eigener kleiner Nachweis: (a) Gruppenentzug und Abmeldung wirken sofort, auch auf offene Sitzungen; (b) nach dem Entzug gehen keine Benachrichtigungen oder Zusammenfassungs-Mails aus geschützten Bereichen mehr an das Konto; (c) Verhalten von Persönlichen Nachrichten und Benutzer-Schlüsseln; (d) Sperre und Anonymisierung über die Schnittstelle; (e) Einstellungen für Anmeldepflicht, Profile, Verzeichnis und freie Profilfelder; (f) eigene Unterdomäne ohne gemeinsame Sitzung; (g) tatsächlicher Speicherbedarf auf dem Zielserver.
3. Zahlungsdienst: aktuelle Preisseite, Vertragsbedingungen, verfügbare Zahlungsmethoden für die Zielkundschaft (Rechnungskauf für Schulen und Vereine ist ein eigenes Thema).
3. Stripe: Vertrags- und Betriebsparameter sowie Zahlungsmethoden vor dem Verkaufsstart prüfen. Für Vereine gilt auf Anfrage der manuelle Rechnungsweg mit protokolliertem Geldeingang.
4. Video Seal: Lizenzdatei, Hardwarebedarf, Ergebnis des eigenen Versuchs.
5. Heimserver: Leistung, Speicher, Upload-Bandbreite, feste oder wechselnde Adresse, Erreichbarkeit von außen, eigenes Netzsegment ohne Weg ins private Netz. Diese Werte sind weiterhin **nicht geprüft**; es wurden keine erfunden.
6. Außer-Haus-Sicherungsziel: Anbieter mit nachweislich nur anfügbarem Zugang; Kosten für die erwartete Datenmenge.
@@ -31,17 +31,17 @@ ## Übersicht der Architekturentscheidungen
| ADR-08 | Veröffentlichung | Fachliche Sicherheitsanforderung; technische Atomarität nicht vollständig nachgewiesen | Neue Freigaben beschädigen keine bestehende Veröffentlichung |
| ADR-09 | Updates | Fachlich beschlossen; Produktregel verbindlich | Aktualisierungen desselben Artikels grundsätzlich enthalten; neue Artikel nicht |
| ADR-10 | Upgrade | Fachliche Schutzregel verbindlich; Upgrade-Technik nur vorgeschlagen | Kein Rechteverlust durch Upgrade; Erwerbsmechanismus noch nicht abgenommen |
| ADR-11 | Inhaber | Zielbild fachlich fest; institutioneller Betrieb später | Organisationen als Zielbild, Einzelpersonen im ersten Verkaufsschnitt |
| ADR-11 | Inhaber | Fachlich bestätigt | Verkauf an Privatkunden, Vereine und Organisationen; Lizenzinhaber korrekt zuordnen |
| ADR-12 | Community | Architekturvorschlag; Community nicht umgesetzt | Community als späterer Satellit vorgeschlagen; Discourse Kandidat |
| ADR-13 | Trainerverzeichnis | Fachliches Zielbild, technische Zuordnung vorgeschlagen | Trainerverzeichnis mit geschützter Privatsphäre; Realisierung später |
| ADR-14 | Zahlung | Verbindliche Zahlungsprinzipien; Adapter nicht umgesetzt | Externer Zahlungsdienst, konkreter Adapter noch nicht gebaut |
| ADR-14 | Zahlung | Stripe für den Verkaufsstart gewählt | Testzahlung in Etappe 1; Live-Anbindung und Abgleich zum Verkaufsstart |
| ADR-15 | Streaming | MVP-Teilbeleg: signiertes HLS; weitergehender Schutz offen | Signiertes HLS im Test belegt; kein DRM-Versprechen |
| ADR-16 | Auslieferung | Lokale Ausgabe belegt; austauschbares CDN/Adaptermodell nicht abgenommen | Lokale Medienausgabe vorhanden; CDN-Wechsel später |
| ADR-17 | Kennzeichnung | Teilimplementierung; forensisches Wasserzeichen offen | Kennzeichnung stufenweise; unsichtbares Wasserzeichen nicht belegt |
| ADR-18 | Ausgabenachweis | Nachweisfunktion implementiert; Manipulationsschutz nicht belegt | Ausgabenachweis im Test; Manipulationsschutz zusätzlich prüfen |
| ADR-19 | Hintergrundjobs | Queue belegt; Outbox-Garantie offen | Queue für Ableitungen vorhanden; transaktionales Outbox-Modell offen |
| ADR-20 | Betrieb | Container-Testbetrieb belegt; Produktivbetrieb offen | Container-Testbetrieb belegt; noch keine Produktivabnahme |
| ADR-21 | Rechnung | Architekturvorschlag; geschäftlich und technisch offen | Rechnungsadapter vorgeschlagen; Dienstwahl offen |
| ADR-21 | Rechnung | Manueller Startweg beschlossen | Vereine auf Anfrage per Überweisung; Rechnung und Geldeingang in Bestellverwaltung nachvollziehbar |
| ADR-22 | CMS/Katalog | Gemeinsames Fachprinzip verbindlich; konkrete CMS-Lösung unter Vorbehalt | CMS-Bausteine und Katalogverweise; komfortabler CMS-Ausbau noch zu erproben |
| ADR-23 | Berechtigungsquelle | Erwerbs-/Quellenprinzip fachlich gedeckt; Abo später | Erwerb als Nachweisquelle; Abo-Typ kein MVP-Fakt |
| ADR-24 | Ausgaberecht | Fachlich verbindlich; Kernprüfungen belegt, G9 offen | Geschützte Ausgabe nur mit Artikelstand, konkreter Fassung und Recht |
@@ -62,6 +62,8 @@ ## Übersicht der Architekturentscheidungen
| ADR-39 | Premium-Karten mit Fachbezug | Umgesetzt auf Test (18.11.2026); gestalterische Freigabe v1.7 offen | Eine Karte je Platz im Abschnittsraster; Inhalte und Linkziel aus Thema, Medium oder Programm/Modul; keine Preise, keine Freigabe geschützter Medien |
| 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 |
---
@@ -200,7 +202,7 @@ ## ADR-11 – Inhaber ist Person oder Organisation
**Alternativen.** Berechtigung am Konto; Organisationen später nachrüsten.
**Begründung.** Nachrüsten würde die zentrale Tabelle und die Entscheidungsfunktion umbauen.
**Folgen.** Geringfügig mehr Modell in der ersten Stufe.
**Ergänzt nach der Challenger-Prüfung.** (1) Genau ein Sitzpool je Erwerb der Organisation mit der beim Erwerb eingefrorenen Sitzzahl; eine Sitzzuweisung setzt eine aktive Mitgliedschaft voraus und endet mit ihr (Befunde CH-25, CH-26). (2) Der erste Schnitt verkauft nur an Einzelpersonen. Die frühere Aussage, Organisationslizenzen seien „als manuelle Betreibervergabe an einzelne Konten überbrückbar“, ist zurückgenommen: Persönliche Berechtigungen werden nicht als Organisationslizenz angeboten oder abgerechnet (ID-004, Beschluss F-NEU-04; Befund CH-24).
**Inhaber und Sitze.** Je Organisationserwerb ist die vereinbarte Sitzzahl festgehalten. Eine Sitzzuweisung setzt aktive Mitgliedschaft voraus und endet mit ihr. Zum Verkaufsstart können Organisationen mit passenden Angeboten als Inhaber kaufen. Persönliche Lizenzen bleiben an ihre jeweiligen Inhaber gebunden.
## ADR-12 – Community als Fremdprodukt, Kern führt
@@ -229,8 +231,8 @@ ## ADR-13 – Trainerverzeichnis im Kern
## ADR-14 – Zahlung hinter Adapter mit aktivem Abgleich
**Status am 17.11.2026:** Verbindliche Zahlungsprinzipien; Adapter nicht umgesetzt.
**Abgleich mit dem aktuellen Projektstand:** Ein externer Zahlungsdienst und belastbare Freischaltung sind vorgesehen. Konkreter Zahlungsanbieter, Zahlungsarten und die vollständige Adapterarchitektur sind weiterhin offen; der Bericht schließt echten Zahlungsdienst aus dem MVP aus.
**Status:** Stripe als Standard für den Verkaufsstart beschlossen. Live-Anbindung und Abnahme ausstehend.
**Entscheidungsstand Shop:** Stripe ist der erste Zahlungsanbieter. Etappe 1 verwendet Testzahlung. Für den Verkaufsstart wird die Rechtevergabe je Bestellposition nach verlässlich bestätigtem Geldeingang durchgeführt; alternative Erwerbsquellen bleiben getrennt.
**Belege:** Fachkonzept PAY-001–006; Abschlussbericht, Zurückgestellt.
**Kontext.** PAY-001, PAY-004, OPS-003, SC-24; Anbieter offen (PAY-006).
@@ -314,17 +316,19 @@ ## ADR-20 – Containerbetrieb auf einem Server
**Folgen.** Kein automatisches Ausweichen bei Rechnerausfall; für die Größe angemessen.
**Ergänzt nach der Challenger-Prüfung.** „Angemessen“ heißt: Wiederanlauf nach Verlust von Server oder Standort in Tagen, nicht in Stunden. Die früheren Zielwerte waren durch die Verfahren nicht getragen (ADR-26).
## ADR-21 – Rechnung über externen Dienst
## ADR-21 – Rechnungsweg für den Shop
**Status am 17.11.2026:** Architekturvorschlag; geschäftlich und technisch offen.
**Abgleich mit dem aktuellen Projektstand:** Die externe Rechnungs-/Zahlungsdienstwahl ist ausdrücklich noch offen. Diese Adapter-Empfehlung ist kein ausgewähltes Produkt und keine freigegebene Rechnungslösung.
**Status:** Manueller Startweg beschlossen am 20.11.2026.
**Entscheidungsstand Shop:** Rechnungen werden zum Start manuell erstellt. Für Vereine ist auf Anfrage ein Kauf per Überweisung auf Rechnung vorgesehen. Ein externer Rechnungsdienst kommt als spätere Ausbauoption infrage.
**Belege:** Fachkonzept PAY-005/PAY-006; Abschlussbericht, Zurückgestellt.
**Kontext.** PAY-005; E-Rechnung zwischen Unternehmen wird verpflichtend.
**Architekturvorschlag.** Rechnungsadapter; der Kern hält Nummer und unveränderliche Kopie. Auswahl des externen Dienstes und konkreter Rechnungsprozess sind offen.
**Startlösung.** Der Kern hält den Bezug zum Rechnungsbeleg. Ein Rechnungsadapter kommt bei späterer Automatisierung infrage.
**Alternativen.** Erzeugung im Kern; Rechnungsfunktion des Zahlungsdienstes.
**Begründung.** Formatpflichten, Nummernkreise, Korrekturen und Übergabe an die Steuerberatung sind nicht Kernkompetenz der Plattform.
**Folgen.** Laufende Kosten; Produktwahl mit der Steuerberatung.
**Folgen.** Beleg- und Korrekturvorgaben vor dem Verkaufsstart klären. Bei einer späteren Automatisierung sind Kosten und Schnittstellen zu bewerten.
**Verbindlicher Ablauf zum Start:** Der Betreiber ordnet die Rechnung der Bestellung zu und bestätigt den Geldeingang in der Bestellverwaltung. Freischaltung erfolgt aus dem festgehaltenen Umfang je Position. Steuer- und Belegdetails sind vor dem Verkaufsstart zu klären.
## ADR-22 – Seiten aus Bausteinen, Katalogdarstellung über Verweise
@@ -515,6 +519,8 @@ ## ADR-39 – Premium-Karten mit Fachbezug
- Gleiche Höhe je Zeile über die gemeinsame Höhe `fill` (ADR-38). Für gemischte Raster sind die Abschnittsraster 1 + 1 + 2 und 2 + 1 + 1 ergänzt (additiv, bestehende Kennungen unverändert).
**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.
@@ -544,3 +550,32 @@ ## ADR-41 – Gemeinsame redaktionelle Informationsbasis
**Folgen.** Klasse B (Fassungen, Lernziele, Mitglieder) und Klasse C (Angebote, Rechte, Bestellstände) werden von dieser Pflege nicht geschrieben. Bestehende Thumbnails, CMS-Kennungen und Revisionen bleiben. Ein Code-Rollback vor dieser Migration lässt die neuen Spalten liegen; die Anwendung davor kennt sie nicht.
**Quelle.** Auftrag gemeinsame Redaktionsverwaltung; `medienzugriff-fuer-komponenten.md`; `cms-widget-registry.md`; ADR-03, ADR-07, ADR-22, ADR-29, ADR-39, ADR-40.
## ADR-42 – Öffentliche Angebotsdarstellung und Mehrangebotswarenkorb
**Übergreifende Festlegung zur Lizenzprüfung und zum Vereinskauf (21.11.2026).** Die autoritative Lizenzprüfung erfolgt über das bestehende Berechtigungsmodul. Mitgliederbereich und geschützte Ausgaben verwenden dieselbe serverseitige Entscheidung. Die Logik soll auch Angebote weiterer Produktlinien der Dachmarke tragen. Einzel- und Mehrfachlizenzen bestimmen den Nutzungsumfang. Bei Vereinskäufen ist der Verein Lizenzinhaber. Download aus der Bestellung ist ausschließlich über das bestellende Mitgliederprofil möglich. Die spätere Online-Wiedergabe kann über zugeordnete Profile oder autorisierte Streaming-Links vom bestellenden Profil organisiert werden. Diese Wahl ist offen.
**Übergreifender Beschluss zur Filmauslieferung (21.11.2026).** Der Shop startet mit lizenzgeprüftem Download von Filmen und Begleitmaterial über die Mitgliederbibliothek. Der Online-Player bleibt im bestätigten Projektumfang und kann später folgen. Bestehende Streaming-Technik und die getrennten Rechteaktionen für Download und Wiedergabe werden dafür erhalten. Maßgeblich für den Startumfang sind `15_Roadmap.md` und `16_MVP_Slice.md`.
**Status:** Beschlossen am 20.11.2026.
Die gemeinsame Angebotsseite je Produkt zeigt die fachliche Beschreibung und die verfügbaren Lizenzoptionen. Shop-Suche und Angebotskacheln verweisen auf diese Seite. Die kaufbare Auswahl bestimmt die Bestellposition. Neue kommerzielle Fassungen werden zum Start manuell aktiviert. Kaufkonditionen bleiben pro Bestellposition fixiert. Während des Einkaufs werden Preisänderungen angezeigt. Der Käufer kann zum neuen Preis bestellen. Zurückgezogene Positionen muss er vor dem Abschluss selbst entfernen.
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 stumm und in Schleife, solange die Maus auf der Karte steht, und endet beim Verlassen. Am Handy und auf Wunsch auch am Desktop startet und stoppt ihn ein Tipp auf das Bild oder die Schaltfläche „Trailer“ am Bild, die auch die Tastatur bedient (`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). Offen: Trailer im Hero-Widget als Hintergrund (nicht entschieden); Hinweis „Mit Ton starten“ nicht vorgesehen.
**Quelle.** `docs/ux/verwaltung/04-fachliche-anforderungen.md` FACH-46; `medienzugriff-fuer-komponenten.md`; `cms-widget-registry.md`; ADR-39, ADR-40, ADR-41.
@@ -55,7 +55,7 @@ ## 3. Risikoregister
| R-04 | Missverständnis „Lizenzkauf = Zertifizierung“ | m | m | getrennte Zustände (INV-09), neutrale Branding-Formulierungen, kein Statusabzeichen auf Material | Kommunikation des Betreibers |
| R-05 | Ehrenamtslizenz wird zweckwidrig kommerziell genutzt | m | m | Zweck auf jeder Ausgabe erkennbar; Erklärung beim Kauf; Nachweis je Datei | technisch nicht verhinderbar |
| R-27 | Die Grenze „neue Fassung“ gegen „neues Produkt“ wird zu großzügig oder zu eng gezogen; seit VER-008 ist beides geldwirksam | m | m | Einordnungspflicht mit Begründung; Auswirkungsbericht mit Zahl der Inhaber und Hinweis auf zusätzliches Material (`06`, Abschnitt 7.2) | fachliche Fehleinschätzung des Betreibers; Kriterien sind seine Entscheidung (E-19) |
| R-28 | Persönliche Lizenzen werden vor Stufe A4 doch als Lösung für Institutionen verkauft | m | h | Angebotsfassungen tragen die Inhaberart; im ersten Schnitt keine Organisationsangebote; klare Benennung in Produkttexten (`16`, Abschnitt 3.2) | organisatorisch; ID-004 verbietet es ausdrücklich |
| R-28 | Persönliche Lizenzen werden als Lösung für Institutionen verkauft | m | h | Angebotsfassungen weisen die Inhaberart aus. Organisationskäufe erfolgen über passende Angebote mit korrekt zugeordnetem Inhaber. | organisatorisch; ID-004 beachten |
| R-29 | Abhängige Upgrades bleiben nach Wegfall der Ausgangslizenz lange ausgesetzt, weil der Klärungsfall liegen bleibt | m | m | Klärungsfall in der Ausnahmeliste mit Frist und Alarm; Entscheidung im Erstattungsvorgang selbst, wenn er in der Plattform ausgelöst wird | Kunde wartet; Geschäftsregel E-21 |
| **Technisch** | | | | | |
| R-06 | Unsichtbares Videowasserzeichen erweist sich als nicht robust oder zu aufwendig | h | m | Stufenmodell: Nachweis und sichtbare Kennzeichnung tragen unabhängig; Zusage erst nach Versuch | Zielbild-Option MED-005 bliebe unerfüllt; ausdrücklich so vorgesehen |
@@ -101,14 +101,14 @@ ## 4. Offene fachliche Entscheidungen
| OPEN-01 | ~~Welche neuen Fassungen stehen Bestandskunden ohne Aufpreis zu?~~ | **Entschieden** (Beschluss F-NEU-01, VER-008): alle später freigegebenen Fassungen desselben Artikels, solange die Lizenz gültig ist. | INV-18; `06`, Abschnitt 7.1; ADR-09 | erledigt |
| OPEN-02 | ~~Wann bleiben ältere Fassungen nutzbar, wann werden sie gesperrt?~~ | **Entschieden** (Beschluss F-NEU-02, VER-008): grundsätzlich weiter verfügbar; Sperre oder Rückzug im Einzelfall mit festgehaltenem Grund. | Status je Artikel-Stand; Rückzug als eigener Weg; keine Mischfassung (INV-17) | erledigt |
| OPEN-03 | Preise, Honorargrenzen, Bedingungen der Zwecke | Selbsterklärung oder Nachweis für „ehrenamtlich“ (L-01) | Rechteprofile und Bedingungsfassungen als Daten | vor A1 |
| OPEN-04 | Paketpreise, Gültigkeiten, Sitzzahlen, institutionelle Varianten | Sitzzahl je Kauf; Wechselregeln (L-07) | ein Sitzpool je Erwerb, Laufzeitregel | vor A4 |
| OPEN-04 | Paketpreise, Gültigkeiten, Sitzzahlen, institutionelle Varianten | Sitzzahl je Kauf; Wechselregeln (L-07) | ein Sitzpool je Erwerb, Laufzeitregel | vor dem ersten betroffenen Angebot |
| OPEN-05 | Co-Branding- und Kennzeichnungsverfahren | Stufen K0–K4; Tiefe des Video-Brandings | Stufenmodell | K0–K2 vor A2; K4 nach Versuch |
| OPEN-06 | Zahlungs-, Rechnungs-, Steuerweg | direkter Zahlungsdienst mit eigener Rechnungsstellung / Verkäufermodell (`10`, Abschnitt 6 und 7) | Adapter | **früh**: vor Beginn der Umsetzung von A1, nach Steuerberatung |
| OPEN-06 | Steuerstatus, Belegpflichten, konkrete Zahlungsmittel und rechtliche Ausgestaltung des Verkaufs | Stripe ist gewählt. Rechnungen werden zunächst manuell erstellt. Vereine können auf Anfrage per Überweisung zahlen. | ADR-14, ADR-21 | vor dem Verkaufsstart |
| OPEN-07 | Community-Sichtbarkeit, Kontakt, Moderation | öffentlich lesbar oder nur Mitglieder; Kontaktwege; Moderationsteam | Konfiguration je Bereich und je Profilangabe | vor A3 |
| OPEN-08 | Konkrete Technologien | `10` | ADR-12, ADR-14, ADR-16 bleiben offen. **ADR-02 ist am 15.11.2026 beschlossen** (Laravel 13, Filament 5, PostgreSQL) | Kernstapel erledigt |
| E-09 | Dürfen Verbraucher kaufen? | ja mit Widerrufsablauf / nur Unternehmer | Kundenart an der Bestellung | vor A1 |
| OPEN-08 | Weitere Technologien außerhalb des festgelegten Kern- und Shopumfangs | `10` | Offene Adapter gemäß ADR-12 und ADR-16. Kernstapel und erster Zahlungsanbieter sind entschieden. | je Ausbaustufe |
| E-09 | Verkaufskreis | **Entschieden:** Deutschland, einschließlich Privatkunden, Vereinen und Organisationen. | Kundenart und Lizenzinhaber korrekt abbilden | erledigt |
| E-10 | Verhalten kostenloser Berechtigungen bei Angebotsende (L-04) | dauerhaft / solange aktiv / befristet | Laufzeitregel | vor dem ersten kostenlosen Angebot |
| E-11 | Teilerstattung von Paketen (L-06) | Positionswahl / Kulanz ohne Rechteänderung | geführter Vorgang | vor A2 |
| E-11 | Rückabwicklung | **Entschieden:** keine freiwilligen Teilerstattungen zum Start; Bundle als Einheit. Offen sind der konkrete Widerrufsprozess, erforderliche Belegkorrekturen und die Behandlung externer Teilbeträge. | `07`, Ablauf 5 | vor dem Verkaufsstart |
| E-12 | Gleichzeitige Wiedergaben je Konto (L-08) | Zahl je Rechteprofil | Option | vor A1 |
| E-13 | Trainerverifikation: Kriterien, Gültigkeit, Nachweisaufbewahrung (L-10) | unbefristet / befristet | Status mit Gültigkeit | vor A3 |
| E-14 | Onlinekursrecht (L-12) | eigenes Merkmal, vertraglich | Option im Rechteprofil | vor A1, falls angeboten |
@@ -120,10 +120,10 @@ ## 4. Offene fachliche Entscheidungen
| E-20 | Sind auch Stände zugänglich, die vor dem Erwerb abgelöst wurden (Annahme A-14)? In welchen Fällen wird bei der Sperre einer Altfassung aktiv informiert? | ja / nur ab Erwerb; je Vorgang entschieden | eine Bedingung; Benachrichtigung je Vorgang | vor der ersten Überarbeitung eines verkauften Artikels |
| E-21 | Upgrades: Preisformel; abhängig oder eigenständig je Upgrade-Angebot; Laufzeit im Verhältnis zur Ausgangslizenz (LIC-012 lässt das offen) | Differenzpreis mit Abhängigkeit / Vollpreis eigenständig | Bedingung in Angebotsfassung und Bestellung (`05`, Abschnitt 8.2) | vor A2 |
| E-22 | Welche Ziele für Datenverlust und Wiederanlauf sollen je Schadensfall gelten, und was dürfen sie kosten? | Ziele aus `11`, Abschnitt 3.1 annehmen / vorbereiteter Ersatz bei einem Mietanbieter / früher Umzug nach B3 | Verfahren stehen; die Zielhöhe ist Entscheidung | vor dem ersten bezahlten Verkauf; vor dem ersten Verkauf an Institutionen erneut |
| E-23 | Sollen Institutionen schon vor Stufe A4 bedient werden? | (a) nein, bis A4 warten; (b) A4 vorziehen; (c) Institution bezahlt klar so benannte **persönliche** Lizenzen namentlich bestimmter Trainer, die beim Trainer bleiben | Angebotsfassung trägt die Inhaberart; keine Organisationsangebote im ersten Schnitt | vor dem ersten Anliegen einer Institution |
| 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 |
**Früh nötige Geschäftsentscheidungen** (LIC-011 verlangt deren Benennung): OPEN-06 mit Steuerstatus, E-09 Kundenkreis, OPEN-03 Lizenztypen und Preise der ersten Angebote, E-22 Wiederherstellungsziele. Die Updatepolitik (früher OPEN-01) und der Kernstapel (E-18, 15.11.2026) sind entschieden und stehen nicht mehr auf dieser Liste.
**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.
## 5. Wie weit trägt die technische Planung ohne die Geschäftsentscheidungen?
+22 -4
View File
@@ -32,9 +32,9 @@ ## 1. Übersicht
| SC-07 Paket wird nach Kauf erweitert | ✔ | I (INV-02) | `04` 5, B4; ADR-06 | dynamische Leistung nur, wenn ausdrücklich Teil der Angebotsfassung | Szenariotest; Test „Bestellung offen beim Erscheinen von D“ | A1 |
| SC-08 Verschachtelung und Zyklen | ✔ | I (INV-08) | `05` 5; `04` B3 | – | Szenariotest | A1 |
| SC-09 Gezieltes Upgrade | ✔ | I (INV-19) | `05` 8; `07` Ablauf 6; `04` B9; ADR-10 | Preisformel und Abhängigkeit offen (E-21) | NT-08 | A2 |
| SC-10 Keine unzulässige Kombination | ✔ | I (INV-03) | `05` 4; `04` B5; ADR-05 | – | NT-07 | A1 (Logik), A2 (Download) |
| SC-10 Keine unzulässige Kombination | ✔ | I (INV-03) | `05` 4; `04` B5; ADR-05 | Downloadprüfung zum Start, Wiedergabeprüfung beim späteren Player | NT-07 | A1 (Download), A2 (Online-Wiedergabe) |
| SC-11 Freier Artikel plus Erweiterung | ◐ | I (INV-12) | `05` 7, 12 | Verhalten bei Angebotsende ist Geschäftsregel (E-10); beide Varianten abgebildet | Szenariotest je Variante | A1 / A2 |
| SC-12 Erstattung einer von mehreren Quellen | ✔ | I (INV-12, INV-20) | `05` 7; `07` Ablauf 5 | Teilerstattung ohne Positionsbezug ist geführter Vorgang (E-11) | NT-09; Szenariotest | A1 (voll), A2 (teil) |
| SC-12 Erstattung einer von mehreren Quellen | ✔ | I (INV-12, INV-20) | `05` 7; `07` Ablauf 5 | Vollerstattung und Erhalt anderer Erwerbsquellen; externe Teilbeträge zur Prüfung | NT-09; Szenariotest | Verkaufsstart |
| SC-13 Befristetes Streaming, geladene Datei | ◐ | I (Gültigkeit bei jeder Entscheidung) | `05` 10; `07` Ablauf 7; `08` 7 | Rechte an Altdateien vertraglich offen (E-15); keine Fernlöschung | Szenariotest | A1 / A2 |
| SC-14 Institution wechselt Trainer | ✔ | I (INV-13) | `05` 9; `07` Ablauf 10; ADR-11 | Wechselregel offen (OPEN-04) | NT-11 | A4 |
| SC-15 Trainerstatus und Kauf getrennt | ✔ | I (INV-09) | `07` Ablauf 9; `09` C.3 | – | Szenariotest | A3 |
@@ -122,7 +122,7 @@ ### E. Community, Zahlung, Betrieb
**SC-26.** Alle Zustände liegen in Kerndatenbank, Medienspeicher und Community-Sicherung; offene Aufträge sind Teil der Datenbank. Generalprobe, Einfrieren, letzte Sicherung, Zurückspielen, Konsistenzprüfungen, Umschalten, Abgleich, Rückfallfrist. Die Standortausfall-Übung ist zugleich die Generalprobe. Belegt ist nichts davon, solange die Umgebung nicht eingesehen und die Übung nicht durchgeführt ist.
**SC-27.** Zielzustand von Selbstverwaltung und Vernetzung: `03`, Abschnitt 7. Roadmap und erster Schnitt: `15`, `16`. Vorleistungen der ersten Stufe für spätere Fähigkeiten: `15`, Abschnitt 4. Der erste Schnitt verkauft nur an Einzelpersonen und gibt persönliche Rechte nicht als Organisationslizenz aus.
**SC-27.** Zielzustand von Selbstverwaltung und Vernetzung: `03`, Abschnitt 7. Roadmap und erster Schnitt: `15`, `16`. Vorleistungen: `15`, Abschnitt 4. Der Testkauf verwendet Testzahlung. Zum Verkaufsstart werden der bestätigte Käuferkreis und die korrekte Abbildung des Lizenzinhabers geprüft.
---
@@ -176,7 +176,7 @@ ## 4. Erschwert oder verhindert die Architektur einen späteren Zielbestandteil?
| Zielbestandteil | Befund |
|---|---|
| Organisationslizenzen und Selbstverwaltung | Nicht erschwert: Inhaber, Erwerb, Sitzpool, Mitgliedschaft, Rollen und der Sitzvorgang bestehen von Beginn an im Modell; es fehlen Oberfläche und Angebote. Der erste Schnitt verkauft nur an Einzelpersonen (ID-004). |
| Organisationslizenzen und Selbstverwaltung | Inhaber, Erwerb, Sitzpool und Mitgliedschaft sind Teil des Fachmodells. Der Verkaufsstart umfasst Organisationskäufe mit passenden Angeboten und Betreiberverwaltung. Erweiterte Oberflächen folgen nach Bedarf. |
| Trainervernetzung | Nicht erschwert: Profil und Sichtbarkeit im Kern; Community als Satellit. Einschränkung: Verzeichnis und Diskussion sind zwei Oberflächen auf zwei Adressen. |
| Laufende Modelle | Nicht erschwert: Gültigkeit und Erwerbstyp „Abonnement“ im Modell. |
| Forensisches Wasserzeichen | Nicht erschwert: zusätzliche Ableitungen und ein weiteres Kennzeichnungsverfahren hinter derselben Ausgabe. |
@@ -212,6 +212,24 @@ ## 6. Zusätzliche Prüffälle des Folgeauftrags
| PF-11 | **Historische Produktinformation** | Das gekaufte Angebot mit Rechten, Laufzeit, Updatezusage, Bedingungswortlaut und Zustimmungen ist aus der Kerndatenbank rekonstruierbar, auch für erstattete und verworfene Bestellungen. Das Aussehen der früheren Marketingseite wird nicht zugesichert. | Aufbewahrungsfristen sind eingehalten | Vertragsdatensatz; unveränderliche Bedingungsfassungen (`04` 5.1; INV-05) | **I.** Fehlt: Test der Rekonstruktion; rechtliche Bestätigung der Fristen. |
| PF-12 | **Wiederherstellung** | Nach Defekt, Fehlbedienung, kompromittiertem Konto, Ausfall von NAS oder Server oder Verlust des Standorts ist der Bestand wiederherstellbar oder abgleichbar; Sicherheitsentscheidungen gelten danach wieder. Datenverlust höchstens wenige Minuten; Wiederanlauf je Schadensfall von Minuten bis zu Tagen. | fortlaufende Sicherung außer Haus funktioniert; das Ziel ist nur anfügbar (A-15); der Betreiber ist verfügbar | `11` Abschnitt 3; Sicherheitsjournal; Audit-Anker (ADR-26) | **O.** Die Zielwerte der Erstfassung waren nicht getragen (CH-41 bis CH-44). Belegt wird erst durch die Übungen in `11` 3.3; die Umgebung ist nicht eingesehen. |
### Shop-Abnahme
| Fall | Erwartung | Etappe |
|---|---|---|
| Kachel oder Shop-Suche öffnen | Dieselbe Angebotsseite mit fachlichem Umfang, Bestandteilen und kaufbaren Optionen | Testkauf |
| Zwei Angebote mit gewählten Optionen bestellen | Eine Bestellung, zwei Positionen mit den jeweiligen Konditionen und Lizenzumfängen; Freischaltung genau einmal je Position | Testkauf |
| Preis nach Hinzufügen ändern | Käufer sieht die Änderung vor Bestellabschluss und kann zum neuen Preis bestellen; ältere Bestellung behält ihren Preis | Testkauf |
| Angebot zurückziehen | Position bleibt sichtbar, blockiert den Abschluss und muss manuell entfernt werden; übrige Positionen bleiben bestellbar | Testkauf |
| Film und Begleitmaterial nach dem Testkauf laden | Die Bibliothek zeigt die erlaubten Downloads. Der Ausgabeweg verweigert den Abruf vor Zahlung beziehungsweise ohne passende Berechtigung. | Testkauf |
| Warenkorb vor der Anmeldung befüllen | Anmeldung beziehungsweise Registrierung mit E-Mail-Bestätigung führt zum Warenkorb derselben Browsersitzung zurück. Dieselbe Option bleibt eine Position. Wechsel zwischen Alternativoptionen ist ausdrücklich. | Testkauf |
| 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 |
| 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 |
## 7. Konsistenznachweis an kritischen Beispielen
Geprüft wurde, ob die genannten Dokumente für dasselbe Beispiel **dieselbe** Antwort geben. Positivbeispiel: muss gelten. Negativbeispiel: darf nicht gelten.
+15 -15
View File
@@ -4,7 +4,7 @@ # 15 – Entwicklungsroadmap für das vollständige Zielbild
Aufwandsspannen: `13`, Abschnitt 6. Diese Roadmap nennt bewusst keine Kalendertermine.
**Nach der Challenger-Prüfung geändert** (`13`, Abschnitte 8 und 9): A0 enthält den Machbarkeitsnachweis zur Stapelwahl und die Sicherheits- und Sicherungsbasis; A1 verkauft nur an Einzelpersonen; Organisationsangebote gibt es erst mit A4; die Vorleistungen in Abschnitt 4 sind an das korrigierte Modell angepasst; bezahlte Fassungs-Upgrades desselben Artikels sind entfallen. Die Roadmap ist eine Umsetzungsansicht und verkleinert das Zielbild nicht.
A0 enthält die Machbarkeitsnachweise sowie die Sicherheits- und Sicherungsbasis. A1 umfasst Testkauf und Verkaufsstart. A4 erweitert die Organisationsverwaltung. Die Roadmap ist eine Umsetzungsansicht der Zielarchitektur.
---
@@ -13,7 +13,7 @@ ## 1. Überblick
```mermaid
flowchart LR
A0["A0 Fundament und Nachweise"] --> A1["A1 Sehen, registrieren, kaufen, unterrichten"]
A1 --> A2["A2 Download und Individualisierung"]
A1 --> A2["A2 Online-Wiedergabe und Individualisierung"]
A1 --> A3["A3 Trainerstatus und Fachcommunity"]
A2 --> A4["A4 Organisationen"]
A3 --> A4
@@ -39,7 +39,7 @@ ### A0 – Fundament und Nachweise
| Entscheidung Kernstapel (E-18) | **erledigt am 15.11.2026:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL (ADR-02) |
| **Sicherheitsbasis:** drei Herkunftsadressen; getrennte Datenbankrollen und Einhängepunkte je Betriebsart; Alltags- und Systemkonto; Alarmkanal außerhalb der Plattform | Grenzen aus `03`, Abschnitt 6 stehen, bevor Fachcode entsteht |
| **Sicherungsbasis:** Außer-Haus-Ziel mit nur anfügbarem Zugang ausgewählt (A-15); fortlaufendes Änderungsprotokoll an beide Ziele; Spiegel von Quellcode und Abbildern; Sicherheitsjournal und Audit-Anker; Entscheidung über die Ziele (E-22) | `11`, Abschnitt 3 eingerichtet; erste Standortausfall-Übung mit Zeitmessung |
| Steuer- und Rechtsberatung: Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg, Bestellablauf, Lizenzbedingungen | OPEN-06, E-09 entschieden; Textaufträge erteilt |
| Steuer- und Rechtsprüfung: Steuerstatus, Belege, Lizenzbedingungen und Widerrufsprozess | vor dem Verkaufsstart klären; Käuferkreis und Zahlungs-/Rechnungsweg sind beschlossen |
| Machbarkeitsnachweis Redaktion: eine echte Episode vom Upload bis zur Vorschauseite im gewählten Stapel, darunter eine verschachtelte Komposition | Bedienbarkeit des Modells belegt (R-02) |
| Machbarkeitsnachweis Medien: Verarbeitung, adaptives Streaming mit signierten Adressen, Sprungmarken-Pause, PDF-Stempelung, Vor-/Abspann ohne Neukodierung | Messwerte für `08`; R-07 geklärt |
| Betriebsbasis: Container-Gerüst, Ausrollweg, Sicherung mit erster Wiederherstellung, Testumgebung | Stufe B1 betriebsbereit |
@@ -51,22 +51,22 @@ ### A1 – Sehen, registrieren, kaufen, unterrichten
Der erste marktfähige Schnitt. Inhalt, Abgrenzung und Einführungsvoraussetzungen: `16_MVP_Slice.md`.
**Kurzfassung:** öffentliche Website mit CMS; vollständiges Inhalts-, Katalog- und Lizenzfundament; Veröffentlichung mit Versionierung und Rückzug; Registrierung; kostenlose Angebote; Einzel- und Paketkauf mit Einmalzahlung **durch Einzelpersonen**; Bibliothek; Streaming; Download von Begleitmaterial mit sichtbarer Lizenzzeile; manuelle Freischaltung; Vollerstattung; Verwaltung und Audit.
**Etappe 1:** öffentliche Angebotskacheln, durchsuchbarer Shop, gemeinsame Angebotsseite mit Lizenzwahl, Mehrangebotswarenkorb, Bestellung mit Umfangskopie je Position und Testzahlung mit einmaliger Freischaltung. Bestehende CMS-, Katalog-, Veröffentlichungs- und Bibliotheksfunktionen bilden die Grundlage.
**Abgrenzung (ID-004):** A1 enthält keine Organisationsangebote. Persönliche Berechtigungen werden nicht als Organisationslizenz angeboten oder abgerechnet. Das Modell für Organisationen besteht vollständig; verkauft wird an Organisationen ab A4.
**Verkaufsstart:** Deutschland für Privatkunden, Vereine und Organisationen. Stripe als Standard, für Vereine auf Anfrage Überweisung auf manuell erstellte Rechnung, Rabattcodes einschließlich Zertifizierungsberechtigung, Freischaltung nach Geldeingang und betriebsfähige Rückabwicklung. Der Verein ist Lizenzinhaber. Downloads aus der Bestellung stehen nur dem bestellenden Mitgliederkonto zur Verfügung. A4 erweitert die Organisationsverwaltung. Film und Begleitmaterial werden nach Lizenz als Download ausgeliefert. Der Online-Player bleibt im Projektumfang und kann nachgelagert umgesetzt werden.
**Abhängigkeiten:** A0. **Risiken:** R-02, R-12, R-19, R-24, R-28.
### A2 – Download und Individualisierung
### A2 – Online-Wiedergabe und Individualisierung
| Fähigkeit | Anforderungen |
|---|---|
| Filmdownload nach Lizenz | MED-001, LIC-003 |
| Online-Player mit Anmeldung und Lizenzprüfung | MED-001, MED-006, LIC-003 |
| Kennzeichnung K1 bis K3 für alle Ausgaben; Vor-/Abspann im Film | MED-002, MED-004 |
| Branding-Profile mit Prüfung; Co-Branding für Dokumente und Film | LIC-010, MED-005 |
| Auswahl der Lizenz bei mehreren möglichen Zwecken | LIC-006 |
| Gezielte Upgrades als zusätzlicher Erwerb mit eingefrorener Bedingung „abhängig“ oder „eigenständig“; Klärungsfall bei Wegfall der Grundlage | LIC-007, LIC-012, PAY-003 |
| Teilerstattung, Rückbuchung, Widerruf als vollständige geführte Vorgänge | PAY-004 |
| Erweiterte Automatisierung von Rückabwicklung und Rückbuchungen bei Bedarf | PAY-004 |
| Bibliothek: Fassungsübersicht, Änderungshinweise, Ausgabenliste | VER-008, LIC-007 |
| Suche nach Lizenzkopie-Kennung in der Verwaltung | ADM-004 |
@@ -103,7 +103,7 @@ ### A4 – Organisationen
**Abhängigkeiten:** technisch nur A1; sinnvoll nach A2 (Branding) und A3 (Organisationsräume); Entscheidungen OPEN-04, E-22 (Verfügbarkeit gegenüber Institutionen), Rechnungsweg.
**Technische Vorleistung aus A1:** Inhaber als Person oder Organisation; Erwerb, Mitgliedschaft, Sitzpool und Sitzzuweisung im Datenmodell; Entscheidungsfunktion berücksichtigt Sitzzuweisungen von Beginn an.
**Vorziehen möglich:** Melden sich Institutionen früh, kann A4 unmittelbar auf A1 folgen (E-23). Bis dahin gibt es keine Organisationsangebote; eine Institution kann allenfalls klar so benannte persönliche Lizenzen für namentlich bestimmte Trainer bezahlen, die bei diesen Trainern bleiben.
**A4 erweitert die Verwaltung von Organisationen.** Der Verkaufsstart ermöglicht bereits Organisationskäufe mit passendem Angebot und korrektem Lizenzinhaber. Für Vereine steht auf Anfrage der manuelle Rechnungsweg bereit.
### A5 – Ausbau der Geschäftsmodelle und des Schutzes
@@ -138,7 +138,7 @@ ## 3. Abhängigkeiten im Detail
|---|---|
| Kauf | Katalog, Veröffentlichung, Lizenzen, Zahlungsadapter, Bedingungstexte, Rechnung |
| Streaming | Medienverarbeitung, Lizenzen, Ausgabe |
| Filmdownload | Streaming-Fundament plus Individualisierung |
| Filmdownload | freigegebene Downloadfassung und Lizenzprüfung je Ausgabe |
| Upgrade | Kauf, Upgrade-Angebote, Erwerb mit Bezug auf eine vorhandene Berechtigung |
| Co-Branding | Ausgabe, Branding-Profile |
| Community | bestätigte Konten, Mailversand, Ereignisverarbeitung |
@@ -188,17 +188,17 @@ ## 5. Zuordnung aller Zielbestandteile
| Kostenlose Berechtigungen | A1 | – |
| Kauf mit Einmalzahlung | A1 | – |
| Bibliothek (Grundsicht) | A1 | – |
| Streaming | A1 | – |
| Filmdownload | A1 zum Verkaufsstart | Download aus der Bibliothek nach Lizenzprüfung |
| Download Begleitmaterial mit Lizenzzeile | A1 | – |
| Manuelle Freischaltung, Entzug, Vollerstattung | A1 | – |
| Filmdownload, Kennzeichnung K1–K3 | A2 | Ausgabevorgang, Nachweis |
| Online-Player, erweiterte Kennzeichnung K1–K3 | A2 | Medienverarbeitung, Ausgabenachweis und Lizenzprüfung; Wiedergabe im angemeldeten Konto |
| Co-Branding | A2 | Option im Rechteprofil |
| Gezielte Upgrades | A2 | Erwerb mit Bezug auf eine vorhandene Berechtigung und eingefrorener Bedingung; Status „ausgesetzt“ |
| Teilerstattung, Rückbuchung, Widerruf vollständig | A2 | Erstattungsfall, Status „ausgesetzt“; **Widerrufsweg für Verbraucher muss bei Verkauf an Verbraucher schon in A1 funktionieren**, dann als einfacher geführter Vorgang |
| Erstattung und Widerruf | A1 zum Verkaufsstart | Manuelle Bearbeitung für den Start, geführte Automatisierung als Ausbauoption. |
| Trainerverifikation | A3 | Statusobjekt |
| Fachcommunity, Profile, Verzeichnis | A3 | Profil, Sichtbarkeit, Ereignisse |
| Aktualisierungen und ältere Fassungen für Bestandskunden (VER-008) | A1 | – |
| Organisationen, betreiberverwaltet, einschließlich Kauf auf Rechnung | A4 | Inhaber, Erwerb, Mitgliedschaft, Sitzpool, Inhaberart der Angebotsfassung, Zahlungsart an der Zahlung |
| Organisationsverkauf und Betreiberverwaltung | A1 zum Verkaufsstart; A4 erweiterte Verwaltung | Organisation als Inhaber, passendes Angebot, Rechnung auf Anfrage für Vereine; erweiterte Sitzoberflächen nach Bedarf |
| Organisations-Selbstverwaltung | A5 | Rollen in der Mitgliedschaft |
| Befristung, Abonnement | A5 | Gültigkeit, Erwerbstyp |
| Schadensbegrenzung, Sicherung außer Haus, Wiederanlauf (SEC-001 bis SEC-004) | A0 / A1 | – |
@@ -218,7 +218,7 @@ ## 6. Risiken der Roadmap
| Entscheidungen fehlen zum Stufenbeginn (R-01) | jede | Fahrplan in `13`, Abschnitt 4 |
| Wasserzeichen wird erwartet, bevor es belegt ist (R-06, R-31) | A5 | Sprachregelung „individuell gekennzeichnete Kopien“; ehrliche Darstellung der schwachen Zuordnung von Filmen bis dahin |
| Sicherheits- und Sicherungsbasis wird als „später“ gestrichen | A0, A1 | Abschnitt 4 und die Negativtests als Abnahmekriterium |
| Institutionen werden vor A4 mit persönlichen Lizenzen „überbrückt“ (R-28) | A1 bis A3 | Inhaberart an der Angebotsfassung; A4 vorziehen statt umetikettieren |
| Unzutreffender Lizenzinhaber bei Organisationskauf (R-28) | Verkaufsstart | Passendes Organisationsangebot und Inhaberart prüfen |
| Der Machbarkeitsnachweis zur Stapelwahl wird übersprungen | A0 | E-18 ist die einzige blockierende Voraussetzung im Review-Gate |
## 7. Erprobung je Stufe
+46 -23
View File
@@ -1,10 +1,9 @@
# 16 – Zusätzlicher erster marktfähiger Schnitt (MVP-Slice)
> **Aktualisierung 20.11.2026 – Warenkorb:** Der Auftraggeber hat für den neuen Shopausbau ausdrücklich einen Warenkorb mit mehreren Angeboten angefordert. Der Warenkorb-Ausschluss in §3.3 ist damit für diesen Folgeauftrag aufgehoben; er bleibt unten nur als historischer Umfang des ersten Schnitts nachvollziehbar. Siehe [FACH-59 und Shopentscheidung](../ux/verwaltung/04-fachliche-anforderungen.md). Bestehende Lizenz- und Bestellregeln werden dadurch nicht ersetzt.
**Phase D, Schritt 17.** Dieser Schnitt ist eine **Planungsansicht der Zielarchitektur**, keine Begrenzung des Zielbilds (SCOPE-001, SCOPE-002). Er entspricht Stufe A1 der Roadmap. Alles, was hier fehlt, hat seinen Platz in `15`, Abschnitt 5.
**Nach der Challenger-Prüfung geändert** (`13`, Abschnitte 8 und 9): Der Schnitt verkauft ausschließlich an **Einzelpersonen**; die frühere „Überbrückung“ von Organisationslizenzen durch persönliche Vergaben ist gestrichen (ID-004, Befund CH-24). Das Fundament enthält zusätzlich Erwerb, Gegenstandsprüfung, getrennte Rechte je Prozess und die Sicherungsbasis. Die Updatepolitik ist keine offene Startentscheidung mehr.
**Geltung:** Dieses Dokument beschreibt den aktuellen Shop-Schnitt. Etappe 1 liefert den durchgängigen Testkauf. Der anschließende Verkaufsstart umfasst die bestätigten Regeln für Deutschland, Privatkunden, Vereine und Organisationen. Die vollständige Selbstverwaltung von Organisationen bleibt eine Ausbaustufe.
---
@@ -20,14 +19,39 @@ ## 2. Was der Schnitt für wen leistet
|---|---|
| Gast | Themen und Episoden entdecken, Vorschau sehen, Lernziele lesen, Angebote und Rechte vergleichen |
| Kostenloses Mitglied | sich registrieren, freie Materialien in der Bibliothek nutzen |
| Trainer (ehrenamtlich oder kommerziell), **als Einzelperson** | Einzelartikel oder Paket kaufen, Filme im Kurs streamen mit Pause an der Entscheidungsmarke, Begleitmaterial als gekennzeichnete PDF laden; jede später freigegebene Fassung der gekauften Artikel ohne Zusatzkauf erhalten |
| Institution (Verein, Schule) | **noch nichts als Organisation.** Organisationslizenzen folgen mit Stufe A4. Der Schnitt gibt keine persönliche Freischaltung als Organisationslizenz aus. |
| Trainer (ehrenamtlich oder kommerziell) als Privatkunde | Einzelartikel oder Paket kaufen und entsprechend der gewählten Lizenz nutzen. Freigegebene Fassungen des gekauften Artikels sind im Rahmen der gültigen Lizenz zugänglich. |
| Organisation (z. B. Verein) | mit passender Einzel- oder Mehrfachlizenz kaufen; für Vereine auf Anfrage per Überweisung. Der Verein ist Lizenzinhaber. Nur das auslösende Mitgliederkonto lädt aus dieser Bestellung herunter. |
| Betreiber | Seiten pflegen, Episoden komponieren, prüfen, veröffentlichen, überarbeiten, zurückziehen; Angebote und Preise pflegen; freischalten, entziehen, erstatten; alles nachvollziehen |
**Marktfähigkeit:** Der Schnitt deckt die Nutzerwege J1, J2, J3 und J7 vollständig und J4, J8, J10 in ihrer Grundform. Er erzeugt Umsatz, liefert Rückmeldung aus echten Kursen und macht die kostenlose Mitgliedschaft nützlich.
**Einführung:** Etappe 1 dient der technischen und fachlichen Abnahme mit Testzahlung. Der Verkaufsstart setzt Live-Zahlung, den Belegprozess, geprüfte Rechtstexte und einen funktionsfähigen Rückabwicklungsweg voraus.
## 3. Umfang
### Entwicklungsauftrag für Etappe 1
**Ziel:** Ein Testkauf vom öffentlichen Shop bis zum lizenzgeprüften Download in der Mitgliederbibliothek. Implementiere und prüfe einen Mehrangebotskauf durch eine Einzelperson und einen separaten Testkauf einer Mehrfachlizenz für einen Verein. Nutze den aktuellen Arbeitsbaum und die verbindlichen Repo-Regeln aus `AGENTS.md` und `CLAUDE.md`. Verwende vorhandene Katalog-, Medien-, CMS-, Bestell- und Berechtigungsfunktionen.
#### Angebotsverwaltung und öffentlicher Shop
- Erweitere den vorhandenen Angebotsarbeitsplatz nach dem [Verwaltungsstandard](../ux/verwaltung/14-verwaltungsstandard.md). Die [Angebotsansicht und vorbelegte Maske aus Teil B](../ux/verwaltung/abnahme/teil-b.md) sind die konkrete Referenz. Verwende den vorhandenen Objektkopf, Kataloglisten und Picker. Zeige für jede Option den Preis in Euro, Eignung für Privatperson oder Organisation, Rechte, zugrunde liegenden Inhalt und aktuellen Status. Die Beschreibung des Produkts wird zentral gepflegt.
- Lizenzoptionen derselben Produktseite sind eigenständig kaufbar und haben jeweils eine stabile Zuordnung zur aktiven Angebotsfassung. Eine Änderung an einer Option lässt die übrigen Optionen kaufbar. Verwende dafür das bestehende Fassungsmodell. Öffne zum Bearbeiten die vorbelegte Maske. Zeige vor der Aktion die betroffene Option und die Wirkung. Erst die ausdrückliche manuelle Aktivierung schaltet die neue Fassung öffentlich. Abbrechen verwirft die offenen Eingaben. Ein separat speicherbarer Entwurf gehört zu einer späteren Erweiterung.
- Die Shop-Suche und Angebotskacheln öffnen dieselbe öffentliche Produktseite gemäß [Website-Konzept](../strategie/website-cms-seo-marketing-zielkonzept.md). Die Seite zeigt den fachlichen Inhalt und darunter die kaufbaren Lizenzoptionen mit Preis, Umfang, Nutzungsrechten und etwaiger Laufzeit. Kacheln und Seiten beziehen ihre Daten aus dem veröffentlichten Katalog. Für Vorschauen gilt die öffentliche Medienfreigabe.
#### Warenkorb, Bestellung und Lizenzprüfung
- Der Warenkorb ist vor der Anmeldung nutzbar und bleibt in derselben Browsersitzung nach Anmeldung, Registrierung und E-Mail-Bestätigung verfügbar. Etappe 1 nutzt diesen sitzungsgebundenen Warenkorb. Dieselbe Option erscheint nur einmal. Bei alternativ kaufbaren Optionen derselben Angebotsgruppe fragt der Shop vor dem Wechsel nach. Eine einzelne Position und ein unabhängig vermarktetes Paket können gemeinsam gekauft werden.
- Prüfe Preise, Angebotsfassung, Kaufbarkeit und vorhandene Rechte serverseitig. Zeige bei geändertem Preis den bisherigen und neuen Preis. Der Käufer kann zu den angezeigten Konditionen bestellen. Ändern sich Preis oder bindende Bedingungen nach Anzeige der Bestellübersicht erneut, muss der Käufer zuerst die aktualisierte Übersicht sehen. Eine zurückgezogene Position bleibt mit Hinweis sichtbar und blockiert den Abschluss, bis der Käufer sie selbst entfernt.
- Hat der vorgesehene Lizenzinhaber bereits eine gültige Lizenz mit demselben Umfang und denselben Nutzungsrechten, markiere die Position dauerhaft als **„Bereits erworben · Wird nicht mitbestellt“**. Biete Entfernen und den Weg zur Bibliothek an. Die Position bleibt sichtbar, geht nicht in die Summe ein und erzeugt keine Bestellposition. Prüfe den Status beim Abschluss erneut. Bei einem dadurch leeren Kauf bleibt der Checkout gesperrt. Enthält ein Bundle zusätzliche Leistungen, bleibt es als Einheit zum angebotenen Preis kaufbar. Rechte mehrerer Erwerbe werden für diese Prüfung nicht zu einer neuen Lizenz kombiniert.
- Halte je bestellter Position Angebotsfassung, Preis und Währung, vereinbarte Lizenzbedingungen, den aufgelösten Rechteumfang und den Lizenzinhaber fest. Bewahre im Bestelldatensatz das handelnde Konto unabhängig vom Lizenzinhaber. Bei Vereinsbestellungen ist der Verein Lizenzinhaber und ausschließlich das auslösende Mitgliederkonto erhält Downloadzugriff aus diesem Erwerb. Für den Testfall steht ein vorbereiteter Verein mit zuverlässig zugeordnetem bestellberechtigtem Konto bereit. Die allgemeine Vereinsregistrierung und Selbstverwaltung folgen später.
- Erzeuge die Bestellung erst nach serverseitiger Prüfung. Freischaltung nach bestätigter Testzahlung verarbeitet **alle Bestellpositionen aus deren festgehaltenem Umfang**. Wiederholte Bestätigung, Fehler oder Abbruch dürfen keine doppelten oder unvollständigen Freischaltungen hinterlassen. Der bestehende Test-Erstattungsweg muss entweder alle Positionen korrekt bearbeiten oder Mehrpositionsbestellungen ausdrücklich ablehnen. Bestehende Käufe, kostenlose Vergaben und unabhängige Rechtequellen bleiben erhalten.
- Verwende `DecideAccess` als zentrale serverseitige Autorität für Downloads. Nach Testzahlung lädt der Berechtigte Filme und Begleitmaterial aus seiner Bibliothek. Vor Geldeingang und aus einem anderen Konto ist auch ein direkter Abruf aus der geprüften Bestellung gesperrt. Der nachgelagerte Online-Player bleibt im Projektumfang. Die Wahl zwischen Trainerprofilen und Streaming-Links bleibt beim Player.
#### UX-Abnahme und Ende der Etappe
Zeige früh einen klickbaren Durchlauf in den bestehenden Verwaltungs- und Website-Komponenten. Der Durchlauf zeigt das Bearbeiten und Aktivieren einer Lizenzoption, die Produktseite und einen Warenkorb mit Preisänderung oder bereits erworbenem Artikel. Kläre konkrete Abweichungen anhand dieses Durchlaufs. Der verbindliche Verwaltungsstandard gilt auch für den Shop. Prüfe verständliche Aktionen, sichtbaren Fokus und Tastaturbedienung, eine schmale und breite Ansicht sowie leere, blockierte und fehlerhafte Zustände.
Führe die Testkauffälle in der [Szenarienmatrix](14_Szenarien_Matrix.md) und die betroffenen Regressionstests gemäß Repo-Regeln aus. Berichte pro Fall das Ergebnis und belege die relevanten Verwaltungs- und Shopansichten. Etappe 1 verwendet ausschließlich Testzahlung. Live-Stripe, Rechnungsabwicklung, Rabattberechnung, produktive Rückabwicklung und der Online-Player sind nachgelagerte Umsetzungen. Der Testauftrag erteilt keine Produktivfreigabe.
### 3.1 Enthalten
| Bereich | Umfang im Schnitt |
@@ -40,9 +64,9 @@ ### 3.1 Enthalten
| **Identität** | Registrierung mit E-Mail-Bestätigung, Anmeldung, Passwort zurücksetzen, Mehrfaktor für Personal, Benachrichtigung bei neuer Anmeldung und bei Passwort- oder E-Mail-Änderung, Profil mit Sichtbarkeitsfeldern (Voreinstellung privat), Löschung und Auskunft als Betreibervorgang |
| **Lizenzen** | Erwerb je Inhaber; Berechtigungen mit Schnappschuss und Gültigkeit; Entscheidungsfunktion vollständig einschließlich Gegenstandsprüfung; jede gültige Berechtigung deckt alle freigegebenen Fassungen ihres Artikels; Inhaber als Person oder Organisation im Modell |
| **Kostenlose Angebote** | Vergabe bei Registrierung und auf Abruf; ein Erwerb je Mitglied und Angebot; Soll-Ist-Abgleich |
| **Kauf** | Einmalzahlung **durch Einzelpersonen** über einen Zahlungsdienst; Bestellung mit Umfangskopie und Rechtekopie; unveränderliche Bedingungsfassungen; Eingangskorb; Zustandsabfrage; aktiver Abgleich mit Rückblick; Statusseite; Bestätigungsmail; Rechnung über den gewählten Weg; Vollerstattung; bei Verkauf an Verbraucher: Zustimmungsnachweise und Widerrufsweg |
| **Kauf** | Durchsuchbarer Shop, gemeinsame Angebotsseite mit Lizenzwahl, Mehrangebotswarenkorb und Testzahlung in Etappe 1. Je Bestellposition vereinbarte Angebotsfassung, Konditionen und aufgelöster Umfang. Zum Verkaufsstart Stripe, manuelle Vereinsrechnung auf Anfrage, gesicherte Zahlungsbestätigung, Rabattcode, Bestätigung und Rückabwicklung. |
| **Bibliothek** | Materialien je Lizenzartikel, wirksame Aktionen, Herkunft, neueste Fassung zuerst, ältere verfügbare Fassungen als ganze Stände, Änderungshinweis |
| **Streaming** | adaptives Streaming mit Signaturen, die nur für das entschiedene Stream-Format gelten; Player mit Sprungmarken, Vollbild, Wiederholung, „vorab laden“; Grenze gleichzeitiger Wiedergaben |
| **Filmauslieferung** | Zum Verkaufsstart lizenzgeprüfter Filmdownload über die Mitgliederbibliothek. Der Online-Player bleibt im Projektumfang und kann nach dem Download-Start folgen. |
| **Download** | Begleitmaterial und Trainerunterlagen als PDF mit sichtbarer Lizenzzeile und eingebetteter Kennung, auch bei Anzeige im Browser; Ausgabenachweis; Abruf angemeldet nach erneuter Entscheidung |
| **Verwaltung** | eigene Adresse; getrenntes Alltags- und Systemkonto; Kontoansicht mit Bestellungen, Berechtigungen, Ausgaben; manuelle Freischaltung und Entzug mit Begründung; Mengengrenzen und Meldung außerhalb der Plattform für wirkungsstarke Vorgänge; Rückabwicklung je Konto und Zeitraum; Ausnahmeliste Zahlungen; Auftragsstatus; Auditprotokoll mit äußerem Anker |
| **Betrieb** | Stufe B1; getrennte Datenbankrollen und Einhängepunkte je Betriebsart; fortlaufende Sicherung an zwei Ziele, davon eines außer Haus und nur anfügbar; Sicherheitsjournal; Wiederherstellungstest und eine Standortausfall-Übung mit Zeitmessung; Überwachung mit Alarmkanal außerhalb der Plattform; Testumgebung ohne echte Personendaten; Ausrollweg |
@@ -51,15 +75,14 @@ ### 3.2 Nicht enthalten, aber im Fundament vorbereitet
| Fähigkeit | Stufe | Vorbereitung im Schnitt |
|---|---|---|
| Filmdownload | A2 | Rechteprofile kennen die Aktion; Download-Master wird bereits erzeugt; Ausgabevorgang besteht |
| Online-Player für gekaufte Filme | nach dem Download-Start möglich | Lizenzprüfung pro Ausgabeaktion und vorhandene technische Streaming-Basis weiterverwenden. |
| Co-Branding | A2 | Option im Rechteprofil |
| Unauffällige Dokumentkennzeichnung, Vor-/Abspann im Film | A2 | Kennzeichnungsstufe als Feld des Nachweises |
| Gezielte Upgrades | A2 | Erwerb kann sich auf eine vorhandene Berechtigung beziehen; Bedingung „abhängig“ oder „eigenständig“ als Feld der Bestellposition; Status „ausgesetzt“ |
| Teilerstattung und Rückbuchung als geführte Vorgänge | A2 | Erstattungsfall, Status „ausgesetzt“; im Schnitt als manuelle Betreiberhandlung mit Auditeintrag |
| Weitergehende Automatisierung von Rückbuchung und Erstattung | A2 | Zum Verkaufsstart einfacher Betreibervorgang und Sonderfallprüfung. Keine freiwilligen Teilerstattungen; Bundle als Einheit. |
| Trainerverifikation | A3 | Statusobjekt vorhanden, Vergabe nur durch Betreiber |
| Community, Verzeichnis, Kontakt | A3 | bestätigte Konten, Profil mit Sichtbarkeit, Ereignisverarbeitung |
| Organisationen | A4 | Inhaber-Modell, Erwerb, Mitgliedschaft, Sitzpool je Erwerb und Sitzzuweisung als Tabellen; die Entscheidungsfunktion berücksichtigt sie und ist dafür getestet; die Angebotsfassung trägt die Inhaberart. **Keine Überbrückung:** Im Schnitt gibt es keine Organisationsangebote, und persönliche Berechtigungen werden nicht als Organisationslizenz vermarktet oder abgerechnet (ID-004). Meldet sich eine Institution früh, wird A4 vorgezogen (`13`, E-23). |
| Kauf auf Rechnung per Überweisung | A4 | Zahlungsart als Feld der Zahlung; derselbe Bestellweg |
| Erweiterte Organisationsverwaltung | A4 | Download aus Vereinskäufen über das bestellende Konto. Für den späteren Online-Player sind Trainerprofile oder Streaming-Links aus diesem Konto zu prüfen. |
| Selbstverwaltung, Abonnement, dynamische Angebote | A5 | Rollenfeld, Gültigkeit, Erwerbstyp, Kennzeichen der Angebotsfassung, Soll-Ist-Abgleich |
| Forensisches Wasserzeichen | A5, bedingt | – |
| Auslieferungsnetz | B2 | Adapter |
@@ -68,14 +91,14 @@ ### 3.3 Bewusste Vereinfachungen im Schnitt
| Vereinfachung | Warum vertretbar | Umkehrbar? |
|---|---|---|
| Wenige Rechteprofile im Angebot (z. B. je Zweck ein Streamingprofil) | Modell trägt beliebig viele; weniger Entscheidungslast für Kunden und Betreiber | ja, neue Profile sind Daten |
| Wenige Rechteprofile im Angebot | Bestehende Profile je Zweck und Ausgabeklasse verwenden. | ja, neue Profile sind Daten |
| Verwaltungsoberflächen funktional statt komfortabel | ein Betreiber, wenige Vorgänge | ja |
| Auskunft und Löschung als Betreibervorgang statt Selbstbedienung | seltene Vorgänge | ja |
| Freigabe ohne erzwungenes Vier-Augen-Prinzip | eine Person | ja, Konfiguration |
| Auswirkungsbericht in Grundform (Zahlen und Listen ohne Simulation) | kleiner Katalog | ja |
| Ein Zahlungsdienst, Einmalzahlung | Adapter besteht | ja |
| Kein Warenkorb mit mehreren Angeboten, sondern Kauf je Angebot | kleiner Katalog; Pakete decken den Mehrfachkauf ab | ja |
| Verkauf nur an Einzelpersonen | Fachkonzept ID-004 erlaubt das ausdrücklich; das Modell trägt Organisationen von Beginn an | ja, mit Stufe A4; **ohne** Umetikettierung bestehender persönlicher Lizenzen |
| Mehrangebotswarenkorb mit Prüfung vor Abschluss | Preisänderung anzeigen. Zurückgezogene Position bleibt sichtbar und muss vom Käufer entfernt werden. | Fachanforderung FACH-59 |
| Verkauf zunächst in Deutschland | Privatkunden, Vereine und Organisationen. Inhaber der Lizenz und Käuferbezug werden korrekt erfasst. | Verkaufskreis beschlossen |
**Nicht vereinfacht** werden: Umfangskopie und Rechtekopie in der Bestellung, Erwerb je Inhaber, Entscheidung je Berechtigung mit Gegenstandsprüfung, Signatur je Datei, unveränderliche Fassungen, fixierter Inhalt je Stand, Kompatibilitätsbestätigung, atomare Veröffentlichung unter Sperre, Ausgabenachweis, Eingangskorb mit Zustandsabfrage und Abgleich, Auditprotokoll mit äußerem Anker, getrennte Rechte je Prozess, Sicherung außer Haus mit Sicherheitsjournal, Inhaber als Person oder Organisation. Diese Liste entspricht `15`, Abschnitt 4.
@@ -83,10 +106,10 @@ ## 4. Begründung der Auswahl
| Frage | Antwort |
|---|---|
| Warum Streaming vor Filmdownload? | Streaming ist die günstigere Einstiegslizenz (LIC-003) und braucht keine Videoindividualisierung. Der didaktische Kern (Film, Pause, Reflexion) ist damit vollständig nutzbar. |
| Warum trotzdem Dokumentdownload? | Handouts und Trainerunterlagen gehören laut LIC-003 auch zur Streaminglizenz. Die Dokumentkennzeichnung ist einfach und erprobt nebenbei den Ausgabenachweis. |
| Wie werden Filme zum Start genutzt? | Berechtigte Mitglieder laden sie aus der Bibliothek und spielen sie lokal ab. Die Online-Wiedergabe mit Lizenzprüfung bleibt als weiterer Projektumfang vorgesehen. |
| Wie werden Begleitmaterialien ausgeliefert? | Handouts und Trainerunterlagen stehen bei entsprechender Lizenz als Download bereit. Dokumentkennzeichnung und bestehende Ausgabenachweise gelten weiter. |
| Warum Community nicht im ersten Schnitt? | Eine Fachcommunity braucht Mitglieder. Der erste Schnitt baut die Nutzerbasis auf; die Community folgt, sobald es jemanden gibt, der diskutiert. Die Richtung COM-001 bleibt festgelegt; A3 ist die unmittelbar folgende Stufe und kann parallel zu A2 laufen. |
| Warum Organisationen später? | Das Fachkonzept erlaubt, den ersten Schnitt auf Einzelpersonenkäufe zu begrenzen (ID-004). Organisationslizenzen brauchen Sitzverwaltung, Organisationsangebote und in der Praxis den Kauf auf Rechnung; das ist Stufe A4. **Bis dahin werden Institutionen nicht mit persönlichen Vergaben „bedient“**: Eine persönliche Lizenz bliebe beim Trainer, wenn er den Verein verlässt, und der Verein hätte nichts. Die frühere Aussage dazu ist zurückgenommen. |
| Wie kaufen Organisationen? | Zum Verkaufsstart mit korrekter Inhaberzuordnung und passenden Angeboten. Vereine können auf Anfrage per Überweisung auf Rechnung kaufen. Die erweiterten Verwaltungsoberflächen folgen bedarfsorientiert. |
| Warum das volle Versionsmodell sofort? | Jede Ausgabe verweist auf einen Stand mit fixiertem Inhalt, und jeder Käufer erhält alle künftigen Fassungen seines Artikels. Ein später eingeführtes Versionsmodell könnte frühe Käufe und Ausgaben nicht mehr korrekt einordnen. |
| Warum Sicherheits- und Sicherungsbasis sofort? | Getrennte Rechte, Sicherung außer Haus und Sicherheitsjournal schützen vom ersten zahlenden Kunden an Zahlungs-, Lizenz- und Personendaten. Nachträglich wären sie ein Umbau des Betriebs mit Risiko für Bestandsdaten. |
| Warum kostenlose Angebote sofort? | VIS-004: Kauf ist keine Voraussetzung für eine nützliche Mitgliedschaft. Zugleich wichtigster Weg zur Gewinnung von Interessenten. |
@@ -110,9 +133,9 @@ ## 5. Abgrenzung in Szenarien
| SC-02 | Bibliothek und freie Materialien | Community-Zugang (A3) |
| SC-05 bis SC-08 | vollständig | – |
| SC-09 | – | A2 |
| SC-10 | Entscheidungslogik durch Tests; praktisch für Streamen und Dokumente | Filmdownload (A2) |
| SC-11 | Grundfall; Erweiterung um Download | A2 |
| SC-12 | Vollerstattung | Teilerstattung geführt (A2) |
| SC-10 | Lizenzprüfung für Film- und Dokumentdownloads; Rechte aus getrennten Erwerbsquellen bleiben getrennt | Online-Wiedergabe nachgelagert möglich |
| SC-11 | Getrennte Erwerbsquellen für freie und gekaufte Materialien | gezielte Lizenz-Upgrades in A2 |
| SC-12 | Vollerstattung und Erhalt anderer Erwerbsquellen zum Verkaufsstart | weitergehende Automatisierung bei Bedarf |
| SC-13 | Ablauf und Dokumentnachweis | – |
| SC-14 | Modell und Tests | Oberfläche (A4) |
| SC-15 | Trennung der Zustände durch Tests | Antrag und Fachbereich (A3) |
@@ -131,7 +154,7 @@ ### 6.1 Entscheidungen, die vorliegen müssen
| Entscheidung | Verweis |
|---|---|
| Kernstapel | E-18, **entschieden am 15.11.2026:** Laravel 13, Filament 5, PostgreSQL |
| Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg | OPEN-06, E-09 |
| Steuerstatus, Belegdetails und konkreter Widerrufsweg vor Live-Verkauf | OPEN-06, E-11. Käuferkreis, Stripe und manueller Rechnungsweg sind festgelegt. |
| Lizenztypen, Preise und Bedingungen der Startangebote | OPEN-03 |
| Ziele für Datenverlust und Wiederanlauf | E-22 |
| Verhalten kostenloser Berechtigungen bei Angebotsende | E-10 |
@@ -157,7 +180,7 @@ ### 6.3 Technische Abnahme
| **Negativtests** | NT-01 bis NT-07, NT-09, NT-10, NT-14 bis NT-19 aus `11`, Abschnitt 7.6 bestehen: Fremdmedium, Mischfassung, fremde Objekte, 100 gleichzeitige Abrufe, Rechtekombination, Meldungsreihenfolge und gefälschte Meldung, Veröffentlichung gegen Sperre, Datenbankgrenzen, Originale, Sicherung, Wiederanlauf, Verwaltungsgrenzen, Abruf nach Entzug |
| Zahlung | Testmodus: Erfolg, Abbruch, doppelte Meldung, verspätete Meldung nach simuliertem Ausfall, „erstattet“ vor „bezahlt“, Zahlung auf verworfene Bestellung, Vollerstattung, Betragsabweichung |
| Veröffentlichung | simulierter Verarbeitungsfehler lässt den bisherigen Stand unverändert; Rückzug wirkt innerhalb der festgelegten Zeit, auch für eine tief verschachtelte Inhaltsfassung und auch nach einer Wiederherstellung |
| Medien | Wiedergabe auf gängigen Browsern, Tablet und an einem Beamer; Verhalten bei gedrosselter Verbindung; Pause an der Marke |
| Medien | Lizenzgeprüften Film- und Dokumentdownload in der Bibliothek nach Testkauf prüfen. Wiedergabe im Portal und deren Bedienung separat beim Player abnehmen. |
| Sicherheit | unabhängiger, gesondert beauftragter Test von Anmeldung, Berechtigungsprüfung, Medienzugriff, Checkout, Ereignis-Endpunkt und Verwaltung; kein Zugriff auf private Medien ohne Entscheidung; kein Zugriff auf ein Medium außerhalb des berechtigten Artikels |
| Zugänglichkeit | Prüfung der öffentlichen Seiten und des Players nach anerkanntem Kriterienkatalog |
| Datenschutz | Verträge zur Auftragsverarbeitung; Auskunft und Löschung einmal vollständig durchgespielt |
@@ -170,7 +193,7 @@ ### 6.4 Einführung
1. **Geschlossene Erprobung** mit wenigen eingeladenen Trainern: kostenlose Angebote und manuell vergebene Berechtigungen, echte Kurse.
2. **Bezahlte Erprobung** mit kleinem Kreis im Livebetrieb des Zahlungsdienstes.
3. **Öffentlicher Start** nach Auswertung; Überwachung der Schwellen für Bandbreite und Wiedergaben.
4. Danach Entscheidung über die Reihenfolge von A2 und A3 anhand der Rückmeldungen: Wird häufiger nach Download oder nach Austausch gefragt?
4. Danach Entscheidung über die Reihenfolge von A2 und A3 anhand der Rückmeldungen: Wird häufiger nach Online-Wiedergabe oder nach Austausch gefragt?
## 7. Der Schnitt im Bild der Zielarchitektur
+8 -2
View File
@@ -312,15 +312,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).
**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 stumm über dem Kartenbild und startet beim Überfahren mit der Maus, am Handy mit Tippen, per Tastatur über die Schaltfläche am Bild; `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.
2. *Öffentliche Filmvorschau (Trailer, Ausschnitt):* eine eigene Ausgabe (`MediaRendition` mit Rolle `preview`) und eine eigene Freigabe je Fassung, getrennt vom lizenzpflichtigen Film; ausgeliefert ohne Signatur nur nach dieser Freigabe. Bis dahin hat die Karte keine Abspielfunktion.
2. *Öffentliche Filmvorschau (Trailer, Ausschnitt; ein Einzelbild aus dem Film ist seit 21.11.2026 über FilmStill möglich):* eine eigene Ausgabe (`MediaRendition` mit Rolle `preview`) und eine eigene Freigabe je Fassung, getrennt vom lizenzpflichtigen Film; ausgeliefert ohne Signatur nur nach dieser Freigabe. Bis dahin hat die Karte keine Abspielfunktion.
3. *Laufzeit:* ein Feld in den Mediendaten der Fassung (zum Beispiel `metadata.duration_seconds`, beim Transkodieren mit ffprobe ermittelt).
Alle drei Erweiterungen hängen mit ADR-29 (öffentliche Profile) zusammen und brauchen eine Entscheidung von Lars.
@@ -27,7 +27,7 @@ ## Anzeige auf der Website
Solange öffentliche Profile (ADR-29) fehlen, ist das die Übergangsregel. Ein Medium hat keine eigene öffentliche Seite. Die Karte verweist dann auf die Programmseite.
Gelesen werden Anzeigename (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart und Ausgabeart. Nicht gelesen und nicht ausgegeben werden Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtext und jede Datei.
Gelesen werden Anzeigename (sonst Arbeitstitel), Inhaltsart und Ausgabeart sowie genau einer der Texte Teaser, Kurzbeschreibung oder ausführliche Beschreibung (siehe „Text der Medien- und Materialkarte“). Nicht gelesen und nicht ausgegeben werden Einsatzhinweis, Lizenzvermerk, Lehrtext und jede Datei.
Das Vorschaubild der Bibliothek erscheint nur in der Redaktionsvorschau, über die Route `editorial.card`, und nur für angemeldete Redaktion. Auf einer öffentlichen Seite hat dieses Bild keine Adresse.
@@ -78,7 +78,7 @@ ### Neues Bild aus dem CMS
Originaldatei, Master-Fassung und Traineranleitungen werden abgelehnt. Eine Quellenzeile (`website_credit`) und ein Alternativtext (`website_alt`) gehören zu den Anzeigedaten und erzeugen keine neue Fassung. Die Quellenzeile erscheint nur, solange die Freigabe besteht. Der interne Vermerk bleibt intern.
Ein neues Website-Bild nimmt `WebsiteIntake` auf und gibt es nach der Ableitung frei. Ein eigenständiges Präsentationsmedium legt `PresentationFile` ohne Inhaltsfassung an und gibt es nicht von selbst frei. Öffentliche Profile nach ADR-29 sind damit nicht umgesetzt.
Ein neues Website-Bild nimmt `WebsiteIntake` auf und gibt es nach der Ableitung frei. Ein eigenständiges Präsentationsmedium legt `PresentationFile` ohne Inhaltsfassung an und gibt es nicht von selbst frei. Der Web-Prozess liest `derived/` nur; er prüft die Datei (Film: MP4 oder WebM, Hörstück: MP3, M4A oder OGG) und übergibt das Kopieren an die Warteschlange (`StorePresentationFile`). Dieselbe Website-Datei lässt sich unter „Website-Freigabe“ am Medium auch zu einem Film mit geschützter Inhaltsfassung hinzufügen, zum Beispiel für einen ungeschützten Trailer; die Fassung bleibt dabei unverändert. Öffentliche Profile nach ADR-29 sind damit nicht umgesetzt.
## Was eine Komponente einhält
@@ -129,6 +129,7 @@ ### Übernahme der früheren CMS-Bilder
(404, wenn zurückgenommen).
- Gespeicherte Revisionen bleiben unverändert; frühere Pfade werden beim Darstellen zugeordnet und beim nächsten
Speichern durch die Kennung ersetzt. Frühere Pfade ohne Zuordnung bleiben über `PublicMedia` gültig.
- Wird ein übernommenes Medium gelöscht, bleibt die Zuordnung als Sperre bestehen (`content_element_id` leer): Der frühere Pfad wird weder über `/medien/cms/…` ausgeliefert noch als Bild gezeigt; die Datei unter `cms/` bleibt liegen. Die Karte oder das Widget bleibt ohne Bild.
- Eine Slideshow gibt es im CMS nicht; `WebsiteMedia::presentMany` ist für sie vorbereitet und noch unbenutzt.
## Präsentationszuordnungen (19.11.2026, ADR-41)
@@ -137,4 +138,51 @@ ## Präsentationszuordnungen (19.11.2026, ADR-41)
Öffentliche Seiten lesen ein Bild nur über `WebsiteImage` und damit über `WebsiteMedia`. Ein freigegebener Film oder ein Hörstück wird über `website.media` ausgeliefert. Geschützte Originaldateien und Vorschaubilder der Bibliothek bleiben auf diesem Weg geschlossen. Wird die Freigabe zurückgenommen, endet die öffentliche Ausgabe; Überschriften und Texte bleiben. Ein Widget ohne verbleibenden Inhalt entfällt.
Die ausführliche Beschreibung, Einsatzhinweise, Lizenzvermerke und Lehrtexte bleiben außerhalb der öffentlichen Karte. `PublicMaterialReader` und `PublicCatalogReader` lesen dafür die Klasse-A-Angaben (`EditorialProfileReader`) und keine Datei.
Einsatzhinweise, Lizenzvermerke und Lehrtexte bleiben außerhalb der öffentlichen Karte. Die ausführliche Beschreibung erscheint nur, wenn die Redaktion sie für diese Karte ausdrücklich wählt (siehe unten). `PublicMaterialReader` und `PublicCatalogReader` lesen dafür die Klasse-A-Angaben (`EditorialProfileReader`) und keine Datei.
## Text der Medien- und Materialkarte, Bild aus dem Film (21.11.2026)
### Text
Die Redaktion wählt je Karte in der Darstellung „Text der Karte“:
| Wahl | Text |
|---|---|
| Automatisch (Vorgabe) | Kurzbeschreibung, sonst Teaser (wie bisher) |
| Teaser | `teaser` |
| Kurzbeschreibung | `summary` |
| Ausführliche Beschreibung | `description` |
- Jede Wahl liest dieselbe Quelle wie die übrige Karte: das Medium, mit einer Abweichung für die Mitgliederbibliothek (`EditorialProfileReader`, Zielgruppe `bibliothek`), wenn es sie gibt. Die Zielgruppe `cms` („CMS-Teaser“) wird weiterhin nirgends gelesen; ein Wechsel würde bestehende Karten ändern und ist eine offene Frage.
- Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Ist der gewählte Text nicht gepflegt, bleibt die Karte ohne Text; die Redaktionsvorschau nennt, wo er zu pflegen ist. Öffentlich erscheint nie ein Hinweis.
- Der eigene Text der Karte (`data.summary`, „Text nur für diese Karte“) hat Vorrang vor der Wahl.
- **Neu öffentlich auf ausdrückliche Wahl:** die ausführliche Beschreibung, die bisher Bibliothekstext war. Der Dialog sagt das („erscheint öffentlich“). Einsatzhinweis und Lizenzvermerk sind nicht wählbar. Öffentlich ist die Karte weiterhin nur, wenn das Medium zu einem öffentlich gezeigten Programm gehört.
- Die Wahl gibt es an der Medien- und Materialkarte und an der Programm- und Modulkarte. Ein Thema hat nur einen Text („Text für die Website“); dort gibt es nichts zu wählen.
- **Programm- und Modulkarte:** Wahl Automatisch (Teaser, sonst Kurzbeschreibung, sonst Lernziel, wie bisher), Teaser, Kurzbeschreibung, Ausführliche Beschreibung oder **Lernziel der Fassung** (steht auf der öffentlichen Programmseite bereits öffentlich). Die Texte werden mit der Zielgruppe „Öffentliche Kachel“ gelesen. Auch hier ersetzt eine ausdrückliche Wahl nicht still durch ein anderes Feld; die Vorschau nennt, wo der Text zu pflegen ist („Programm oder Modul bearbeiten“).
### Bild aus dem Film
Das Vorschaubild eines Films (Medienmanager) und jede Filmstelle sind geschützt und erscheinen öffentlich nie. Für die Karte gibt es einen ausdrücklichen Weg, daraus ein Website-Bild zu machen. Im Reiter „Medien“ der Medienkarte, bei einem Film:
1. eine Stelle wählen: Regler und Zahlenfeld zeigen dieselbe Zeitposition, das Bild der Stelle folgt dem Regler nach kurzer Pause (wie im Medienmanager); „Diese Stelle übernehmen“ legt genau die angezeigte Stelle ab, oder
2. „Vorschaubild des Films übernehmen“ (das im Medienmanager gesetzte Vorschaubild; mit kleiner Ansicht daneben).
`FilmStill` zieht das Einzelbild **einmal** und legt es über `WebsiteIntake` als gewöhnliches Bild-Medium (`output_class = bild`) im Medienmanager ab. Die Warteschlange leitet es ab und gibt genau diese Ableitung frei, wie bei jedem Upload aus dem CMS. Die Karte speichert die Kennung dieses Bildes in `refs.image`.
- **Kein Neuziehen:** Seitenaufrufe lesen nur die gespeicherte Datei; `ffmpeg` läuft nur beim Übernehmen und in der Vorschau des Dialogs (Route `editorial.frame`, nur angemeldete Redaktion). Test: `FilmStillTest` zählt die Extraktionen.
- **Einmal je Stelle:** `film_still_sources` (additive Tabelle) ordnet Film, Quelle (`frame:{Fassung}@{Sekunde}` oder `file:{SHA-256}`) und Bild zu. Dieselbe Stelle, auch über „Vorschaubild übernehmen“ eines Filmbilds aus derselben Stelle, ergibt dasselbe Medium. Ein archiviertes oder bei der Verarbeitung gescheitertes Bild wird nicht wiederverwendet; die Stelle lässt sich dann neu übernehmen.
- **Wiederverwendung ehrlich melden:** Wird ein schon übernommenes Bild gewählt, sagt die Meldung, wie es steht (bereits freigegeben, wird verarbeitet oder Website-Freigabe zurückgenommen). Eine zurückgenommene Freigabe bleibt zurückgenommen; das Bild erscheint öffentlich erst nach erneuter Freigabe im Medienmanager (Reiter „Website“).
- **Löschen:** „Medium löschen“ (Medien ohne Fassung) entfernt auch ein Standbild; die Herkunftszeile entfällt (Migration `allow_deleting_media_with_stills_and_aliases`), dieselbe Stelle lässt sich neu übernehmen.
- **Auflösung:** Aus der Mediendatei (`inhalte/`) bis 1600 px Breite, nie über die Breite der Quelle hinaus vergrößert; ohne Mediendatei aus der kleinen Stufe (480 p). Die Vorschau im Dialog und das Vorschaubild des Medienmanagers bleiben bei 640 px.
- **Rechte:** Es wird nie der Film abgelegt, nur ein Einzelbild; keine Fassung, keine Berechtigung, kein Lizenzartikel. Ausgeschlossen sind Traineranleitungen, archivierte Filme und Filme ohne bereitgestellte Fassung. Die Handlung ist ausdrücklich (Redakteur, wie beim Upload); die Freigabe des entstandenen Bildes lässt sich im Medienmanager zurücknehmen (Wirkung: das Bild entfällt auf allen Seiten).
- **Das Bild ist ein eigenes Medium** mit Titel „Standbild: {Film} (Fassung n, x s)“, Alternativtext „Szene aus dem Film …“ und der Quellenzeile des Films. Es folgt späteren Änderungen des Film-Vorschaubilds nicht; wer es als Titelbild des Films verwenden will, ordnet es im Medienmanager als Präsentationsmedium zu (dann nutzen alle Karten des Films es automatisch).
- **Nicht umgesetzt:** eine öffentliche Filmvorschau (Trailer, Ausschnitt) und die Laufzeit. Beides bleibt Erweiterungsbedarf (Registry §13).
### Vorschaubild eines Programms oder Moduls (Programm- und Modulkarte)
Das Vorschaubild eines Programms oder Moduls (Redaktionsmanager) ist ebenfalls ein geschütztes Bibliotheksbild. Im Reiter „Medien“ der Programm- und Modulkarte übernimmt „Vorschaubild übernehmen“ es als Bild-Medium („Titelbild: {Titel}“); `CompositionStill` arbeitet wie `FilmStill`: einmal kopiert (bis zur Größe der Vorschaudatei, 640 px), über `WebsiteIntake` abgelegt, Herkunft in `composition_still_sources` (dasselbe Vorschaubild ergibt dasselbe Medium), ein gescheitertes oder archiviertes Bild wird nicht wiederverwendet, die Meldung nennt den tatsächlichen Stand (auch bei zurückgenommener Freigabe). Ein Programm ohne Vorschaubild zeigt den Hinweis, es im Redaktionsmanager zu setzen. Eine Stelle aus einem Film des Programms zu wählen gibt es hier nicht; das Vorschaubild des Programms selbst lässt sich im Redaktionsmanager aus einem Film setzen.
### Trailer auf Medien-, Programm- und Modulkarten
Ein Trailer ist ein eigenes Medium (Film ohne Fassung, Ableitung unter `teaser/`), das im Medienmanager einem Medium, Programm oder Modul in der Präsentation mit der Rolle „Trailer“ oder „Vorschauclip“ zugeordnet wird. Die Karte spielt ihn ab, wenn er für die Website freigegeben ist (Reiter „Website“ am Trailer). Lesende Klasse: `CardClip` (Trailer, sonst Vorschauclip, bei einem Film ersatzweise sein eigener freigegebener Teaser). Ausgeliefert wird über `website.media`, die Bereichsabrufe (`Range`) beantwortet. Nicht freigegebene Clips, der vollständige Film und Originale kommen nie über die Karte. Die Redaktionsvorschau spielt ebenfalls nur freigegebene Clips und nennt sonst den Grund. Verhalten (Maus, Tipp, Tastatur, reduzierte Bewegung, Datensparmodus): ADR-43.
@@ -0,0 +1,68 @@
# Release-Vorbereitung develop → main (21.11.2026)
Vorbereitet von Claude. **Den Merge nach `main` löst Lars in Gitea aus** (Pull Request `develop` → `main`, nach Prüfung des Teststands). Claude merged, pusht und deployt nicht nach `main`. Ein Merge löst über `deploy-prod.yml` sofort das Produktiv-Deployment aus.
Stand: `develop` mit der Programm- und Modulkarte (Commit `3825f53` plus die Dokumentation dieser Übergabe), `main` auf `759b3e1` (PR #2).
## 1. Inhalt (Stand 21.11.2026 abends: 22 Commits seit `main`)
| Bereich | Inhalt | Von |
|---|---|---|
| Medien- und Materialkarte | Text der Karte wählen (Teaser, Kurzbeschreibung, Ausführliche Beschreibung); Bild aus dem Film (Regler mit Live-Bild, Vorschaubild übernehmen) | Claude |
| Programm- und Modulkarte | Text der Karte wählen (zusätzlich Lernziel); Vorschaubild als Website-Bild übernehmen | Claude |
| Trailer auf Karten | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer (Rolle Trailer, sonst Vorschauclip, bei Filmen ersatzweise der eigene Teaser) stumm beim Überfahren mit der Maus oder per Tipp ab; je Karte abschaltbar; die Medienroute beantwortet Bereichsabrufe (ADR-43). Auf luf-test mit einem echten Clip geprüft. Keine Migration | Claude |
| Website-Datei eines Films | Ablage der Datei eines eigenständigen Präsentationsmediums über die Warteschlange, nachträgliches Hochladen am Medium (Behebung: der Web-Prozess darf `derived/` nicht schreiben) | Lars (anderer Rechner) |
| Medienmanager | „Medium löschen“ erreicht Standbilder und übernommene CMS-Bilder (Fremdschlüssel gelockert) | Claude |
| Fachliche Säulen | Vereinheitlichung auf die zentrale Säulenverwaltung | Lars (anderer Rechner) |
| Shop | Shop-Verwaltung, Warenkorb, Artikel/Paket/Angebot mit Voraussetzungen, Mehrpositionen-Kasse, Organisationskäufe | Lars (anderer Rechner) |
| Dokumentation | Anforderungen FACH-56 bis FACH-59, Brand-UI-Kit 1.2 bis 1.7 ohne Originalmotive, Berichte | beide |
Der Shop-Teil ist umfangreich (neue Tabellen, Routen, Kasse, Tests). Ich habe ihn nicht inhaltlich geprüft; die Abnahme steht in `docs/ux/verwaltung/abnahme/`.
**Fakten zum Shop nach dem Merge (aus dem Code geprüft):**
- **In Produktion nicht erreichbar.** `/shop`, `/warenkorb…` und `/kasse` liegen hinter `EnsureShopEnabled`; `Shop::enabled()` ist nur wahr, wenn die Umgebung **nicht** Produktion ist und der Zahlungstreiber `test` gilt („Etappe 1 erteilt keine Produktivfreigabe“). Prod läuft als `APP_ENV=production` (lesend bestätigt): Alle Shop-Adressen antworten dort mit 404, der Kopflink erscheint nicht.
- **Keine neuen Umgebungsschlüssel.** Gegenüber `main` gibt es keinen neuen `env()`-Zugriff, `.env.example`, `docker-compose.yml` und `scripts/deploy.sh` sind unverändert. `/etc/luf/prod.env` braucht nichts Neues (die Datei selbst habe ich nicht geöffnet). Die bisherigen Werte `LUF_CART_ENABLED` und `LUF_CART_URL` werden nicht mehr gelesen.
- **Folge:** Der Shop schadet in Prod nicht, ist aber auch nicht nutzbar. Er wird dort erst mit einer späteren Produktivfreigabe aktiv.
- **Entscheidung für Lars:** Mit diesem Merge nach Prod, oder die Shop-Commits erst später? (Eine Trennung wäre nur über einen eigenen Branch ohne die Shop-Commits möglich.)
## 2. Teststand
- Testsuite lokal: 459 grün, Pint sauber. Gate in Gitea (`ci-feature`, `develop`): CI 4987 und Deploy 4988 grün für den Stand der Karten.
- Die neuen Karten und Bildwähler sind in einem echten Browser gegen die Testinstanz (`luf-test`) im regulären Seitenkonfigurator geprüft (Berichte `docs/analysen/medienkarte-text-und-filmbild-bericht-2026-11-21.md` und `karten-text-und-bild-programm-bericht-2026-11-21.md`).
- Nicht gezeigt: die öffentliche Darstellung der neuen Karten auf einer veröffentlichten Seite der Testinstanz (nur Entwurf); die öffentlichen Regeln belegen die Feature-Tests.
## 3. Migrationen (Prod steht bei der 32. Migration `2026_11_20_200000_editorial_master_data_management`)
| Migration | Wirkung | Rückwärtskompatibel |
|---|---|---|
| `2026_11_21_100000_unify_pillar_assignments` | neue Tabellen `composition_pillar`, `license_article_pillar`, Anpassung `editorial_dimension_values` | ja, additiv |
| `2026_11_21_120000_create_film_still_sources` | neue Tabelle | ja |
| `2026_11_21_130000_add_shop_foundation` | Spalten an `offers`, `orders`, `order_lines`, `acquisitions`, neue Tabelle `memberships`, Rückrechnung bestehender Bestellungen | additiv; Daten werden berechnet, nicht gelöscht |
| `2026_11_21_130000_allow_deleting_media_with_stills_and_aliases` | lockert zwei Fremdschlüssel (`film_still_sources`, `website_media_aliases`) | ja, lockert nur |
| `2026_11_21_140000_create_composition_still_sources` | neue Tabelle | ja |
Keine bestehende Migration wurde geändert. Verglichen mit der Migrationstabelle von Prod (lesend): Prod hat 32 angewendet, `develop` 37 Dateien, **genau diese fünf sind ausstehend**, nichts auf Prod fehlt in `develop`. Prod hat 0 Bestellungen; die Rückrechnung in `add_shop_foundation` hat dort nichts zu tun. Der Rollback des Deploy-Skripts setzt nur den Code zurück, nicht die Datenbank; die neuen Tabellen und gelockerten Schlüssel stören älteren Code nicht.
## 4. Stand von Prod (lesend geprüft, 21.11.2026)
- 8 Seiten, alle veröffentlicht; 2 Medien (1 Bild, 1 Film), 1 davon für die Website freigegeben; **keine fachlichen Säulen** (Themenkarte hat dort noch nichts zur Auswahl); keine früheren CMS-Bilder unter `cms/` (die Bildübernahme früherer Bilder ist dort ohne Wirkung).
- Alle Container laufen; der Queue-Container startet planmäßig stündlich neu.
- Voraussetzungen für Bilder aus dem Film: `ffmpeg` ist im Image (`Dockerfile`); Warteschlange schreibt `public/derived/originals` (wie bisher).
## 5. Was Lars nach dem Deploy für die Pflege der Webseite wissen sollte
- Themenkarte: erst Säulen anlegen und veröffentlichen (mit Adresse und „Text für die Website“), sonst bleibt sie leer.
- Medienkarte und Programm-/Modulkarte erscheinen öffentlich nur, wenn das Medium bzw. Programm die Freigaberegeln erfüllt (Medium im öffentlichen Programm, Programm mit Anzeigefreigabe; Module nie).
- **Ausführliche Beschreibung** wird öffentlich, sobald sie als Kartentext gewählt wird. Trainermaterialien vorher als „Traineranleitung“ einordnen (die erscheinen nie öffentlich).
- Ein Bild aus einem Film oder aus dem Vorschaubild eines Programms entsteht als eigenes Bild im Medienmanager und wird nach der Verarbeitung automatisch für die Website freigegeben; die Freigabe lässt sich im Medienmanager (Reiter „Website“) zurücknehmen.
## 6. Ablauf (nur Lars)
1. Teststand und Shop-Entscheidung prüfen.
2. Pull Request `develop` → `main` in Gitea anlegen und nach Prüfung zusammenführen.
3. Der Workflow `deploy-prod.yml` testet und deployt; den Verlauf in Gitea beobachten.
4. Nach dem Deploy: Prod-Seiten und die neuen Karten ansehen (`/`, eine Seite mit Karte).
## 7. Hinweis zum Trailer nach dem Deploy
In Prod gibt es noch keinen Trailer. Ablauf für die Pflege: Medium anlegen (Film, „Eigenständiges Präsentationsmedium“, MP4 H.264 oder WebM) → im Reiter „Website“ freigeben → am Film, Programm oder Modul unter „Präsentationsmedien“ als Trailer zuordnen → „Redaktion speichern“. Bis ein Trailer freigegeben ist, ändert sich auf keiner Karte etwas.
@@ -10,9 +10,9 @@ ## 1. Zielbild und Priorität
**MVP-Pflicht ist eine professionelle, vollständig nutzbare Mitgliederbibliothek.** Programme, Module, Übungen, Filme, Traineranleitungen, Merkblätter und sonstige Materialien müssen durchsuchbar, filterbar, fachlich unterscheidbar und innerhalb ihrer jeweiligen Zusammenhänge nutzbar sein. Eine flache Liste von Lizenzartikeln oder Dateinamen ist kein gleichwertiger Ersatz.
**P0/MVP:** konfigurierbare Fachdimensionen; fachliche Stammdaten; Thumbnails; Einbindung wiederverwendbarer Materialien in Modulen und Programmen; konfigurierbare Lizenzartikel/Pakete/Angebotsvarianten mit Preisen; Mitgliederbibliothek; Suche/Filter; Modul-/Programmdetails; berechtigtes Dokumentansehen und -laden; einfaches geschütztes Videostreaming; Redaktionsvorschau und Auditierung.
**P0/MVP:** Konfigurierbare Fachdimensionen, fachliche Stammdaten, Thumbnails, wiederverwendbare Materialien in Modulen und Programmen, konfigurierbare Produkte und Lizenzoptionen, Mitgliederbibliothek mit Suche, Filtern und Modul-/Programmdetails, lizenzgeprüfter Film- und Dokumentdownload zum Verkaufsstart sowie Redaktionsvorschau und Auditierung.
**Späteres Add-on:** spezialisierter Kursplayer mit automatischer Denkpause, vorgegebener Ablaufsteuerung, Präsentations-/Trainermodus, Fortschrittsverfolgung oder synchronisiertem Zweitgerät. Übliche Videofunktionen wie Abspielen, Pause, Zeitsuche und Vollbild bleiben Bestandteil des MVP. Eine didaktische Denkpause ist als **Methode** weiterhin relevant, aber nicht als zwingende automatische Playerfunktion.
**Online-Player im Projektumfang:** Geschützte Wiedergabe für angemeldete, berechtigte Konten kann nach dem Download-Start folgen. Ein spezialisierter Kursplayer mit automatischer Denkpause, Ablaufsteuerung oder weiteren Trainingsfunktionen ist ein möglicher weitergehender Ausbau. Die didaktische Denkpause bleibt Teil der Methode.
## 2. Fachliches Objektmodell
@@ -105,6 +105,8 @@ ## 7. Konfigurierbare kommerzielle Produkte
Individuelle **betreiberseitige** Pakete müssen modellierbar sein. Kundenseitige freie Paketkonfiguratoren und persönlich gespeicherte Kurssammlungen sind noch nicht als MVP entschieden.
Die gemeinsame öffentliche Angebotsseite beschreibt das Produkt fachlich und zeigt darunter seine verfügbaren kaufbaren Lizenzoptionen. Shop-Suche und redaktionelle Angebotskacheln führen zu dieser Seite. In den Warenkorb gelangt die gewählte Option mit Bezug auf das Angebot. Für einen Kauf sind mehrere Positionen zulässig. Verbindliche Angebotsänderungen werden als neue Fassung manuell aktiviert. Der Bestellstand je Position bleibt nachvollziehbar gespeichert.
## 8. Mitgliederbibliothek: allgemeine Anforderungen
Die Benutzeroberfläche richtet sich an Trainer, nicht an Katalogadministratoren. Fachlicher Typ und **technisches Dateiformat** bleiben unterscheidbar: Eine Übungsbeschreibung kann als PDF oder Text vorliegen, bleibt fachlich aber eine Übung. Ein PDF wird nicht aufgrund seiner Lizenzierbarkeit als „Kurs“ etikettiert.
@@ -137,7 +139,7 @@ ## 9. Moduldetail
2. **Überblick:** inhaltliche Beschreibung, Lernziele und ggf. Zeit- und Materialbedarf.
3. **Inhalte:** strukturierte, geordnete Kompositionsbestandteile mit Rolle, Fachtyp und vorhandenen Untergruppen. Verschachtelung darf nicht zu einer flachen Dateiliste zusammenfallen.
4. **Zusammenhänge:** Verwendung in anderen Modulen und Programmen.
5. **Aktionen:** je Film geschütztes Streaming; je Dokument berechtigtes Ansehen und/oder Laden; je Übung sinnvolle Anzeige.
5. **Aktionen:** je Film lizenzgeprüfter Download zum Start und später Online-Wiedergabe gemäß Rechteprofil. Je Dokument berechtigtes Ansehen und/oder Laden, je Übung sinnvolle Anzeige.
Die Darstellung soll dem Trainer das Verständnis der Trainingseinheit ermöglichen, ohne ihn in eine vorgegebene Player-Sequenz zu zwingen.
@@ -151,7 +153,7 @@ ## 10. Programmdetail
## 11. Standard-Medienaktionen und Zugriff im MVP
**Video:** Authentifizierte, berechtigte Wiedergabe im normalen Player (Play, Pause, Zeitsuche, Vollbild, Lautstärke, vorhandene Untertitel). Adaptive und geschützte Medienausgabe gemäß bestehendem Medienkonzept. **Keine** verpflichtende automatische Denkpause oder dedizierte Kursablaufsteuerung.
**Video:** Zum Verkaufsstart bietet die Mitgliederbibliothek den Download für angemeldete Konten mit passendem Recht an. Die nachgelagerte Online-Wiedergabe nutzt dieselbe Lizenzbasis mit eigener Wiedergabeaktion.
**Dokumente:** Ansehen im Browser und Download sind getrennte Berechtigungsaktionen. Kennzeichnung und Ausgabenachweis bleiben erhalten, soweit das bestehende Rechte-/Medienmodell dies verlangt.
@@ -193,7 +195,7 @@ ## 13. Abnahmefälle
| B13 | Verschiedene historische Fassungen eines Assets | Je Programm richtige Fassung; keine stille Versionsmischung |
| B14 | Nur einzelne Module lizenziert | Programm als teilweise nutzbar kenntlich; geschützte Teile bleiben gesperrt |
| B15 | Alle Programmteile über separate Artikel lizenziert | Inhalte vollständig nutzbar, ohne fingierten Programmkauf |
| B16 | Film streambar, nicht downloadbar | Stream funktioniert; Download serverseitig verweigert |
| B16 | Film mit und ohne Downloadrecht | Zum Start wird der Download ausschließlich mit passender Berechtigung angeboten und serverseitig zugelassen. Für die spätere Online-Wiedergabe bleibt der getrennte Test Stream erlaubt, Download verweigert erhalten. |
| B17 | Grants mit abweichenden Nutzungszwecken | Keine künstlich kombinierten Rechte |
| B18 | Kompositionsreihenfolge ändern | Neue Kompositionsfassung; früherer Stand unverändert |
| B19 | Filmdatei austauschen | Neue Asset-Fassung, ursprüngliche Datei und Referenzen erhalten |
@@ -207,7 +209,7 @@ ## 13. Abnahmefälle
## 14. Abgestimmte Regeln und noch offene Optionen
**Verbindlich abgestimmt:** Zentrale Mitgliederbibliothek vor spezialisiertem Kursplayer; frei konfigurierbare Fachdimensionen auch für Kompositionen; Beschreibung, Thumbnail und reine Such-/Anzeigedaten ohne neuen fachlichen Release; gewünschter Videoframe als Thumbnail; vollständige Wiederholung aller Verwendungen innerhalb **jedes** Programms und Deduplizierung **nur** in übergreifenden Einzelinhaltslisten; einfache Streaming-/Dokumentfunktionen; getrennte didaktische und kommerzielle Struktur; historische Versions- und Lizenzintegrität.
**Verbindlich abgestimmt:** Zentrale Mitgliederbibliothek und lizenzgeprüfter Film- und Dokumentdownload zum Verkaufsstart. Der Online-Player bleibt im Scope und kann nachgelagert folgen. Frei konfigurierbare Fachdimensionen auch für Kompositionen, Beschreibung und reine Such-/Anzeigedaten ohne neuen fachlichen Release, gewünschter Videoframe als Thumbnail, Wiederholung aller Verwendungen innerhalb jedes Programms und Deduplizierung nur in übergreifenden Einzelinhaltslisten, getrennte didaktische und kommerzielle Struktur sowie historische Versions- und Lizenzintegrität.
**Nicht stillschweigend für das MVP entscheiden:** von Kunden selbst konfigurierbare Pakete; gespeicherte persönliche Kursabläufe; automatische Denkpausen-/Präsentationssteuerung; geräteübergreifende Synchronisation; konkrete Tarife, Preise und Honorargrenzen; genaue Navigationsposition teilweise verfügbarer Programme; Frage, ob spezifische Altersvarianten eigene Produkte oder Versionen sind.
@@ -161,9 +161,9 @@ ## 6. Mitglieder, Trainerqualifikation und Organisationen
**ID-002 [FESTGELEGT]** Verifizierter/zertifizierter Gewaltschutztrainer ist ein **fachlicher Status**, der nach Prüfung vergeben wird, nicht ein durch Kauf erworbener Rang. Trainerstatus, Community-Zugangsrechte und Materiallizenzen sind unterscheidbar.
**ID-003 [FESTGELEGT]** Organisationen (z. B. Vereine, Schulen) können Lizenzinhaber sein und Lizenzen für zugeordnete Trainerkonten verwenden. Ein Trainer kann eigene Berechtigungen zusätzlich zu Organisationsberechtigungen besitzen und auch mehreren Organisationen angehören.
**ID-003 [FESTGELEGT]** Organisationen (z. B. Vereine, Schulen) können Lizenzinhaber sein. Im späteren Ausbau können zugeordnete Trainerkonten als Zugriffsweg verwendet werden. Ein Trainer kann eigene Berechtigungen zusätzlich zu Organisationsberechtigungen besitzen und auch mehreren Organisationen angehören.
**ID-004 [FESTGELEGT]** Die Organisationen und Trainerzuweisungen werden in der ersten Betriebsphase durch den Plattformadministrator **manuell** verwaltet. Eine spätere Selbstverwaltung durch Organisationsadministratoren soll im Zielbild möglich sein. Die Erstphase darf dieses spätere Modell nicht grundsätzlich verhindern.
**ID-004 [FESTGELEGT]** Im Download-Start wird beim Vereinskauf der Verein als Lizenzinhaber und das bestellende Mitgliederkonto als einziges Downloadkonto hinterlegt. Einzel- und Mehrfachlizenzen regeln den Nutzungsumfang. Für den späteren Online-Player bleibt zu entscheiden, ob zugeordnete Trainerprofile oder Streaming-Links aus dem bestellenden Konto verwendet werden. Eine spätere Organisationsverwaltung bleibt im Zielbild möglich.
*Zeitliche Einordnung (Beschluss F-NEU-04):* Der **erste kommerzielle MVP-Slice darf auf Einzelpersonenkäufe begrenzt sein**; echte Organisationslizenzen dürfen in einer späteren Umsetzungsphase folgen. Persönliche Freischaltungen dürfen jedoch **nicht als gleichwertige Organisationslizenz vermarktet oder abgerechnet** werden. Der spätere Organisationsbetrieb muss bereits von der vollständigen Zielarchitektur getragen werden. Diese Einordnung ist eine Umsetzungsreihenfolge und verkleinert das Zielbild aus ID-003 und LIC-008 nicht.
@@ -203,12 +203,20 @@ ## 8. Verkauf, Zahlung und Freischaltung
**PAY-005 [ZIELFUNKTION]** Bestellinformationen und vereinbarte Konditionen bleiben nachträglich nachvollziehbar, auch wenn Angebote, Preise und Pakete später verändert werden. Rechnungs- und steuerliche Abläufe sowie verbraucherrechtliche Anforderungen müssen als Teil eines real betreibbaren Verkaufsprozesses berücksichtigt werden.
**PAY-006 [ZU KLÄREN]** Konkreter Payment-Anbieter, Zahlungsmethoden, Rechnungsstellung, steuerliche Services, Preismodell und spätere Abo-Konditionen.
**PAY-006 [FESTGELEGT]** Beim Verkaufsstart in Deutschland können Privatkunden, Vereine und Organisationen kaufen. Standardzahlung ist Stripe. Vereine können auf Anfrage per Überweisung auf Rechnung zahlen. Der Betreiber erstellt die Rechnung zunächst manuell und bestätigt den Zahlungseingang in der Bestellverwaltung. Für Organisationslizenzen bleibt die Organisation Lizenzinhaberin.
**PAY-007 [FESTGELEGT]** Mehrere Angebote beziehungsweise gewählte Lizenzoptionen können gemeinsam bestellt werden. Preisänderungen im Warenkorb werden vor dem Abschluss sichtbar. Nicht mehr kaufbare Positionen bleiben mit Hinweis sichtbar und sind vom Käufer zu entfernen, bevor er mit den übrigen Positionen bestellt. Je Position bleiben die vereinbarte Fassung mit Preis, Konditionen und Lizenzumfang festgehalten.
**PAY-008 [FESTGELEGT]** Pro Bestellung ist ein Rabattcode zulässig. Allgemeine Codes können für den ganzen Warenkorb, produktspezifische für ausgewählte Produkte gelten. Ein gemeinsamer Zertifizierungscode kann nach Prüfung und Freigabe am Konto auch bei weiteren Bestellungen eingesetzt werden. Für den Start sind keine freiwilligen Teilerstattungen vorgesehen. Bundles sind Rückgabeeinheiten.
**PAY-009 [ZU KLÄREN]** Rechnungs- und Steuerdetails, Preisgestaltung, genaue Rabattberechnung sowie die rechtliche und operative Ausgestaltung des Widerrufs vor dem Verkaufsstart.
---
## 9. Streaming, Downloads, Individualisierung und Medienherkunft
**Übergreifende Festlegung zum Verkaufsstart (21.11.2026):** Filme und Begleitmaterial werden den jeweils berechtigten Mitgliedern als Download bereitgestellt. Der Online-Player bleibt Teil des Projektumfangs. Er kann nach dem Verkaufsstart folgen und setzt Anmeldung und das jeweils passende Wiedergaberecht voraus.
**MED-001 [FESTGELEGT]** Berechtigte Mitglieder können Videos in der Plattform streamen und – soweit ihre Lizenz dies vorsieht – Video- und Begleitdateien herunterladen. Eine günstigere Streaming-Berechtigung ohne regulären Videodownload soll möglich sein.
**MED-002 [FESTGELEGT]** Herunterladbare Materialien sollen möglichst **individuell der Lizenzkopie zugeordnet** werden, idealerweise mit nicht offensichtlich sichtbarer Kennzeichnung. Ziel ist die nachträgliche Zuordnung mutmaßlich unrechtmäßig weiterverbreiteter Kopien, nicht eine unrealistische Garantie absoluter Kopierverhinderung.
@@ -276,7 +284,7 @@ ## 12. Geschäftsregeln, die bewusst noch nicht entschieden sind
| OPEN-03 | Preise, Honorargrenzen, Vertragsbedingungen der ehrenamtlichen und kommerziellen Lizenzen | Konfigurierbare Regeln statt verbauter Beispielwerte |
| OPEN-04 | Paketpreise, Gültigkeiten, Anzahl berechtigter Trainer und institutionelle Vertragsvarianten | Mehrere Rechte-/Zugangsmodelle im Zielbild zulassen |
| OPEN-05 | Welche Co-Branding- und Kennzeichnungsverfahren kommen konkret zum Einsatz? | Technisch mögliche Varianten und Grenzen vergleichen |
| OPEN-06 | Shop-/Rechnungs-/Zahlungsanbieter und konkrete Abrechnungsmodelle | Realistische vollständige Kaufprozesse entwerfen |
| OPEN-06 | Steuerstatus, konkrete Rechnungs- und Belegpflichten, Zahlungsarten innerhalb von Stripe, spätere Abo-Konditionen | Für den Verkaufsstart konkretisieren. Zahlungsanbieter, Vertriebsländer und der manuelle Vereins-Rechnungsweg sind festgelegt (PAY-006). |
| OPEN-07 | Einzelheiten der Community-Sichtbarkeit, Kontaktaufnahme und Moderation | Fachcommunity als vollständige Fähigkeit konzipieren und Privatsphäre berücksichtigen |
| OPEN-08 | Konkretes CMS, Frontend/Backend, Datenhaltung, Medienbereitstellung und Betriebstechnologien | Im Architekturauftrag eigenständig begründet empfehlen |
@@ -29,7 +29,7 @@ ## 1. Executive Summary
1. Freigabe der Wortmarke, der Farbwerte und der Schriften.
2. Herkunft und Rechte der Figurenbilder; Regel für öffentliche Verwendung.
3. Zielgruppe für den Start (Empfehlung: Einzeltrainer, weil der erste Schnitt nur an Einzelpersonen verkauft).
3. Zielgruppen des Verkaufsstarts in Deutschland: Privatkunden, Vereine und Organisationen.
4. Das kostenlose Einstiegsangebot (Empfehlung: ein vollständiges Modul).
5. Wer fachlich namentlich verantwortet und welche Qualifikation öffentlich genannt wird.
6. CMS-Richtung nach dem Editor-Prototyp (bevorzugt: Ausbau des Eigenkerns).
@@ -127,7 +127,7 @@ ### 3.4 Geschäftslogik hinter der Website
| Erstkauf | Einzelmodul oder Programm je Nutzungszweck | Modell vorhanden; Preise und Lizenztypen **[OFFEN]** (OPEN-03) |
| Erweiterung | weitere Module, Programme, später gezielte Upgrades | Upgrades Stufe A2 |
| Bindung | jede spätere Fassung eines gekauften Artikels ist enthalten (VER-008) | [FEST]; als Verkaufsargument bisher ungenutzt |
| Institutionen | Organisationslizenz mit Sitzen, Kauf auf Rechnung | [FEST] erst ab Stufe A4 |
| Institutionen | Lizenz mit korrekter Organisationszuordnung und passenden Vertragsdaten | Verkaufskreis umfasst Organisationen; Vereine können auf Anfrage auf Rechnung kaufen |
| Empfehlung | Trainerverzeichnis und Community | Stufe A3; siehe 4.3 |
**[EMPF]** Die Updatezusage gehört prominent auf jede Angebotsseite. Sie ist ein belegbares, im System verankertes Versprechen und unterscheidet das Angebot von einem Dateikauf.
@@ -148,9 +148,9 @@ ### 4.1 Zielgruppen
| Gruppe | Entscheider und Geldquelle | Was überzeugt | Was hindert | Kaufweg heute möglich? |
|---|---|---|---|---|
| **Selbstständige Trainer** (Gewaltschutz, Selbstbehauptung; kommerziell) | selbst, eigenes Geld, schnelle Entscheidung | Zeitersparnis, professioneller Auftritt, klare kommerzielle Rechte | Sorge vor Abhängigkeit, unklare Lizenz | ja, als Einzelperson |
| **Vereinstrainer** (Karate, Kampfsport; meist ehrenamtlich) | Trainer regt an, Vorstand bezahlt | fertige Stundenbilder, Passung zur Hallensituation, niedriger Preis | Budget, Vereinsbeschluss | als Einzelperson ja; als Verein erst ab A4 |
| **Lehrkräfte, Schulsozialarbeit, pädagogische Fachkräfte** | Schulleitung, Förderverein, Träger | Einsatz in 45 oder 90 Minuten, Elterninformation, wenig Vorbereitung | Beschaffung auf Rechnung, Datenschutzfragen | privat ja; als Schule erst ab A4 |
| **Träger und Institutionen** | Leitung, Beschaffung | Verlässlichkeit, Rechnung, mehrere Nutzer, Ansprechpartner | fehlende Organisationslizenz | **nein**, erst ab A4 |
| **Vereinstrainer** (Karate, Kampfsport; meist ehrenamtlich) | Trainer regt an, Vorstand bezahlt | fertige Stundenbilder, Passung zur Hallensituation, niedriger Preis | Budget, Vereinsbeschluss | persönlich oder mit passendem Vereinsangebot; Vereinsrechnung auf Anfrage |
| **Lehrkräfte, Schulsozialarbeit, pädagogische Fachkräfte** | Schulleitung, Förderverein, Träger | Einsatz in 45 oder 90 Minuten, Elterninformation, wenig Vorbereitung | Beschaffung, Datenschutzfragen | privat oder mit passendem Organisationsangebot |
| **Träger und Institutionen** | Leitung, Beschaffung | Verlässlichkeit, mehrere Nutzer, Ansprechpartner | Lizenzumfang und Beschaffungsweg | Verkauf mit passendem Organisationsangebot |
**Nicht Zielgruppe der Plattform**, aber vermutlich die größte suchende Gruppe **[ANNAHME]:** Eltern. Sie kaufen nichts, sind aber Auftraggeber der Trainer und Publikum der Schule. Empfehlung in 4.3.
@@ -158,7 +158,7 @@ ### 4.1 Zielgruppen
### 4.2 Konsequenz aus dem ersten Verkaufsschnitt
**[FEST]** Der erste Schnitt verkauft nur an Einzelpersonen; persönliche Lizenzen werden nicht als Organisationslizenz ausgegeben (`16`, ID-004).
**[FEST]** Der Verkaufsstart richtet sich an Privatkunden, Vereine und Organisationen in Deutschland. Organisationsangebote müssen die vorgesehenen Nutzungsrechte und den tatsächlichen Lizenzinhaber korrekt ausweisen. Der vorgelagerte Testkauf nutzt Testzahlung.
**[EMPF]** Die Website darf Institutionen bis Stufe A4 nichts versprechen, was nicht kaufbar ist. Sie erhält stattdessen eine ehrliche Seite „Für Schulen und Vereine“ mit Einsatzbeschreibung und einem Formular „Interesse an einer Einrichtungslizenz“. Die Zahl der Anfragen ist der Messwert, mit dem über das Vorziehen von A4 entschieden wird (`13`, E-23).
@@ -184,7 +184,7 @@ ### 4.4 Customer Journeys (geprüft und geändert)
*Änderung:* Erweiterungshinweise stehen im fachlichen Zusammenhang (im Programm, an der fehlenden Stelle), nie als Werbefläche über der Bibliothek. Grundlage ist der Status „teilweise nutzbar“ (`produktkonfiguration`, §10).
**Journey D – Institution**
Seite „Für Schulen und Vereine“ → Einsatzmöglichkeiten → **Unterlage zum Weitergeben** (eine Seite für Leitung oder Vorstand) → Anfrageformular. Ab A4: Organisationsangebot, Kauf auf Rechnung.
Seite „Für Schulen und Vereine“ → Einsatzmöglichkeiten → **Unterlage zum Weitergeben** → passendes Organisationsangebot oder Anfrage. Vereine können auf Anfrage per Überweisung auf Rechnung zahlen.
*Änderung:* Bis A4 endet die Journey in einer Anfrage, nicht in einem Kauf. Die druckbare Kurzunterlage ist der wichtigste Baustein, weil in Institutionen nicht die suchende Person entscheidet.
**Journey E – Empfehlung (neu)**
@@ -240,7 +240,7 @@ ### 5.3 Was nicht trägt
**Fachlich (Produktstrategie):**
1. Hauptnavigation „Filme & Materialien“, Startseitenaufruf „Filme entdecken“, Abschnitt „Filme und Materialien“: Der Medientyp ist die Ordnung, nicht das Trainingsziel. Widerspricht `trainingskonzept`, §8 und `design-prinzipien`, §7.
2. Angebotskarte „Filmprogramm, 29,90 €, In den Warenkorb“: Shop-Muster mit erfundenem Preis; es gibt keinen Warenkorb (`16`, 3.3) und keine Preisentscheidung.
2. Angebotskarte mit Beispielpreis: Herausgestellt werden fachlicher Umfang und Produktnutzen. Reale Preise kommen aus den aktiven Lizenzoptionen. Der Kaufweg führt von der gemeinsamen Angebotsseite in den Mehrangebotswarenkorb.
3. Bibliothek mit Filter nach Dateiart und Karten je Lizenzartikel: genau die flache Sicht, die `produktkonfiguration`, §1 als unzureichend bezeichnet.
4. Player als eigener Seitentyp mit Denkpause als Titel: Der didaktische Kursplayer ist Add-on (`produktkonfiguration`, §1).
5. Die fünf Themenbereiche kommen in der gesamten Studie nicht vor, obwohl sie die verbindliche öffentliche Gliederung sind (`design-prinzipien`, §3).
@@ -515,6 +515,8 @@ ### 9.1 Ein Fachobjekt, drei Darstellungen
**Lücke:** Lernziele, Zeit- und Materialbedarf haben heute keine Felder und stehen in keinem Bibliothekspaket. Bis sie bestehen, zeigen Programm- und Modulseite Kurzbeschreibung und Struktur (Entscheidung E-W12).
**Shop-Darstellung.** Die durchsuchbare Shop-Seite macht kaufbare Produkte auffindbar. Redaktionelle Angebotskacheln und Shop-Treffer öffnen die gemeinsame Angebotsseite des Produkts. Die Seite zeigt fachlichen Umfang und Bestandteile, darunter die verfügbaren Lizenzoptionen mit Preis, Laufzeit und Nutzungsrechten. Erst die Auswahl bestimmt die Position im Warenkorb. Alle angezeigten Angebotsdaten stammen aus dem veröffentlichten Katalog. Die Shop-Umsetzung folgt dem verbindlichen Verwaltungsstandard und den bestehenden Designprinzipien.
### 9.2 Wireframe-Konzepte
Schreibweise: Abschnitte von oben nach unten. **K** = Katalogdaten, **R** = redaktionell, **G** = globaler Abschnitt.
@@ -1233,7 +1235,7 @@ ## 18. Kritische Eigenprüfung
| Automatisierung gegen Vertrauen | vier Freigabestufen; nichts mit Fachaussage ohne Mensch |
| Transparenter öffentlicher Katalog gegen Schutz der Inhalte | öffentliches Profil zeigt Struktur und Ziele, nie Dateien; Vorschaubilder nur nach Freigabe |
| Datengetriebenes Marketing gegen geringe Datenmenge am Anfang | Regeln ohne Verkehrsbedarf zuerst; Mindestmengen |
| Institutionen als Zielgruppe gegen Verkauf nur an Einzelpersonen | ehrliche Anfrage statt Scheinangebot; Nachfrage messen |
| Institutionen als Zielgruppe mit unterschiedlichen Beschaffungswegen | passende Lizenz und echten Käuferbezug erkennbar machen; Vereinsrechnung auf Anfrage |
| Komfort eines fertigen CMS gegen Einheit der Verwaltung | Eigenkern bevorzugt; ein Prototyp mit Bedienaufgaben entscheidet; Wechselkriterien benannt (10.7) |
| Bibliothek soll schnell und ohne Designsystem entstehen, die Website braucht dieselben Bausteine | gemeinsame Komponenten einmal bauen, nach abgestimmtem Vertrag; Gestaltung der Bibliothek als eigener späterer Schritt (W1b) |
| Früher Start gegen vollständige Markenbasis | W0 ist klein gehalten und blockiert nur W1 |
Loaded 100 of 229 files, more files were not shown because too many files have changed in this diff. Show more