Compare commits

..
Author SHA1 Message Date
StommerandClaude Sonnet 5.5 9f7c645baf Binde Stripe im Testmodus an die Kasse an
CI Feature / test (push) Successful in 1m53s
Neuer Zahlungsweg PAYMENT_DRIVER=stripe: Checkout Session über die Stripe-API (Http-Client, kein
SDK), Freischaltung nur durch die signierte Meldung an POST /stripe/webhook (Signatur und
Zeittoleranz geprüft, Betrag und Währung gegen die Bestellung, wiederholte Meldung wirkungslos).
Nur Testschlüssel (sk_test_), nie in Produktion; Standard bleibt der Testweg. Die Freischaltung
nutzt denselben Weg wie die Testzahlung (Checkout::settle). Die Schaltfläche „Widerrufen“ ist im
Stripe-Modus ausgeblendet, weil sie kein Geld zurückbucht. Betrieb: docs/betrieb/DEPLOYMENT.md.

Bestandstests geändert: ShopProductPageTest und CmsSectionRenderingTest (2 Stellen) nutzten
„stripe“ als Beispiel für einen nicht freigegebenen Zahlungsweg. Stripe ist jetzt freigegeben,
die Tests nehmen den unbekannten Treiber „unbekannt“; die Assertions bleiben unverändert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 22:26:09 +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
215 changed files with 8390 additions and 288 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));
}
}
@@ -20,9 +20,12 @@
* ö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.
* Öffentlich gelesen werden Anzeigetitel (sonst Arbeitstitel), Inhaltsart und Ausgabeart sowie einer der Texte
* Teaser, Kurzbeschreibung oder ausführliche Beschreibung. Welcher Text erscheint, entscheidet die Redaktion je Karte
* (Einstellung „Text der Karte“); ohne Wahl gilt die Kurzbeschreibung, sonst der Teaser. Die ausführliche Beschreibung
* erscheint nur, wenn die Redaktion sie ausdrücklich wählt. Nie: Einsatzhinweis, Lizenzvermerk, Dateien, Lehrtexte,
* Ausgabeadressen. Das Vorschaubild der Bibliothek ist nicht für die Website freigegeben; es erscheint nur in der
* Redaktionsvorschau und kann in der Karte ausdrücklich als Website-Bild übernommen werden (FilmStill).
* Eine Karte spielt nichts ab, bietet keinen Download und gibt kein Medium frei.
*/
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,
);
}
@@ -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,6 +7,9 @@
use App\Domain\Cms\Catalog\CardSubject;
use App\Domain\Cms\Catalog\PublicMaterialReader;
use App\Domain\Cms\Widgets\RenderContext;
use App\Domain\Media\FilmStill;
use Filament\Forms\Components\ViewField;
use Filament\Schemas\Components\Utilities\Get;
/**
* Medien- und Materialkarte (Kit v1.7 „media“): ein Inhaltselement mit Anzeigetitel, Kurzbeschreibung, Inhaltsart und
@@ -53,7 +56,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 +93,51 @@ 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 !== '',
'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 textChoices(): array
{
return [
'auto' => 'Automatisch (Kurzbeschreibung, sonst Teaser)',
'teaser' => 'Teaser',
'summary' => 'Kurzbeschreibung',
'description' => 'Ausführliche Beschreibung (erscheint öffentlich)',
];
}
protected function centralCoverId(mixed $id): ?int
{
$element = is_numeric($id) ? ContentElement::query()->find((int) $id) : null;
@@ -10,6 +10,7 @@
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;
@@ -32,6 +33,13 @@ abstract class PremiumCardWidget extends WidgetType
{
public const SHOW = ['yes' => 'Anzeigen', 'no' => 'Ausblenden'];
/** Hinweise der Redaktionsvorschau, wenn der gewählte zentrale Text nicht gepflegt ist. */
public const TEXT_MISSING = [
'teaser' => 'Kein Teaser gepflegt (Medium bearbeiten → Teaser).',
'summary' => 'Keine Kurzbeschreibung gepflegt (Medium bearbeiten → Kurzbeschreibung).',
'description' => 'Keine ausführliche Beschreibung gepflegt (Medium bearbeiten → Beschreibung).',
];
/** Schlüssel des Fachobjekts in refs, zum Beispiel 'pillar'. */
abstract protected function refKey(): string;
@@ -56,6 +64,27 @@ 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 [];
}
/**
* 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 [];
}
public function view(): string
{
return 'widgets.premium_card';
@@ -110,7 +139,9 @@ public function optionIcons(): array
public function settings(): array
{
return [
$choices = $this->textChoices();
return ($choices === [] ? [] : ['text_source' => $choices]) + [
'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 +155,11 @@ 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.'],
'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 +227,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 +243,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 +280,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, self::TEXT_MISSING[$textSource] ?? '');
}
$heading = filled($data['heading'] ?? null) ? trim((string) $data['heading']) : null;
$lead = filled($data['summary'] ?? null) ? trim((string) $data['summary']) : null;
@@ -302,7 +340,7 @@ protected function centralCoverId(mixed $id): ?int
/**
* 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 +352,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, self::TEXT_MISSING[$textSource] ?? '');
}
$text = $subject?->{$field};
return is_string($text) && trim($text) !== '' ? Str::limit(trim($text), 120) : 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));
}
}
+129 -34
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,14 +128,39 @@ 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();
return $this->settle($order, 'test', $reference);
}
/**
* Zahlung eines Anbieters (Stripe): wie die Testzahlung, aber erst nach Prüfung von Betrag und Währung gegen die
* Bestellung. Wiederholte Meldungen sind wirkungslos.
*/
public function confirmProviderPayment(Order $order, string $provider, string $reference, int $amountCents, string $currency): Order
{
$expected = (int) ($order->total_cents ?? $order->lines()->sum('price_cents'));
if ($amountCents !== $expected || strtoupper($currency) !== strtoupper((string) ($order->currency ?? 'EUR'))) {
throw new DomainRuleException('Der gezahlte Betrag weicht von der Bestellung ab.');
}
return $this->settle($order, $provider, $reference);
}
private function settle(Order $order, string $provider, string $reference): Order
{
$reference = trim($reference);
if ($reference === '') {
@@ -81,7 +168,7 @@ public function confirmTestPayment(Order $order, string $reference): Order
}
$paidNow = false;
$order = DB::transaction(function () use ($order, $reference, &$paidNow): Order {
$order = DB::transaction(function () use ($order, $provider, $reference, &$paidNow): Order {
$order = Order::query()->lockForUpdate()->findOrFail($order->id);
if ($order->status === 'bezahlt') {
@@ -92,22 +179,20 @@ public function confirmTestPayment(Order $order, string $reference): Order
throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.');
}
$order->payments()->create([
'provider' => 'test',
'status' => 'bestaetigt',
'provider_reference' => $reference,
]);
// Eine bei Stripe angelegte offene Zahlung mit derselben Referenz wird bestätigt statt doppelt geführt.
$order->payments()->updateOrCreate(
['provider_reference' => $reference],
['provider' => $provider, 'status' => 'bestaetigt'],
);
$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 +227,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 +246,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 +270,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 '';
}
}
+27
View File
@@ -0,0 +1,27 @@
<?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 driver(): string
{
return (string) config('services.payment.driver');
}
public static function enabled(): bool
{
return ! app()->isProduction() && in_array(self::driver(), ['test', 'stripe'], true);
}
/** Stripe-Kasse (Etappe 1: nur Testmodus, nie in Produktion). */
public static function stripe(): bool
{
return ! app()->isProduction() && self::driver() === 'stripe';
}
}
+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 {}
@@ -0,0 +1,145 @@
<?php
namespace App\Domain\Commerce\Stripe;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Commerce\Order;
use Illuminate\Http\Client\ConnectionException;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Http\Client\Response;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Log;
/**
* Stripe-Kasse (Checkout Session) für die Testzahlung in Etappe 1. Ausschließlich Testschlüssel: Ein Live-Schlüssel
* oder die Produktionsumgebung werden abgewiesen, bevor ein Aufruf an Stripe geht. Bezahlt wird bei Stripe; Kartendaten
* berühren diese Anwendung nie. Die Freischaltung erfolgt allein über die signierte Meldung (StripeWebhook).
*/
class StripeGateway
{
/**
* Legt für die Bestellung eine Checkout Session an oder liefert die noch offene wieder.
*
* @return array{id: string, url: string}
*/
public function checkoutFor(Order $order): array
{
$this->assertSandbox();
$order->loadMissing('lines', 'user');
if ($order->status !== 'offen') {
throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.');
}
$open = $this->reusableSession($order);
if ($open !== null) {
return $open;
}
$attempt = $order->payments()->where('provider', 'stripe')->count() + 1;
$params = [
'mode' => 'payment',
'client_reference_id' => (string) $order->id,
'customer_email' => $order->user->email,
'locale' => 'de',
'success_url' => route('member.order', $order).'?zahlung=zurueck',
'cancel_url' => route('member.order', $order).'?zahlung=abbruch',
'metadata' => ['order_id' => (string) $order->id],
'payment_intent_data' => ['metadata' => ['order_id' => (string) $order->id]],
];
foreach ($order->lines->values() as $index => $line) {
$params['line_items'][$index] = [
'quantity' => 1,
'price_data' => [
'currency' => strtolower((string) ($line->currency ?? $order->currency ?? 'EUR')),
'unit_amount' => (int) $line->price_cents,
'product_data' => ['name' => filled($line->offer_name) ? (string) $line->offer_name : 'Lizenz'],
],
];
}
$response = $this->request()
->withHeaders(['Idempotency-Key' => 'luf-order-'.$order->id.'-'.$attempt])
->post('/v1/checkout/sessions', $params);
$this->assertOk($response, 'angelegt');
$id = (string) $response->json('id');
$url = (string) $response->json('url');
if ($id === '' || $url === '') {
throw new DomainRuleException('Stripe hat keine Kasse geliefert. Bitte versuche es später noch einmal.');
}
$order->payments()->create(['provider' => 'stripe', 'status' => 'offen', 'provider_reference' => $id]);
return ['id' => $id, 'url' => $url];
}
public function assertSandbox(): void
{
$secret = (string) config('services.stripe.secret');
if (app()->isProduction()) {
throw new DomainRuleException('Stripe ist in Produktion nicht freigegeben.');
}
if ($secret === '') {
throw new DomainRuleException('Stripe ist nicht eingerichtet: Der Schlüssel fehlt.');
}
if (! str_starts_with($secret, 'sk_test_') && ! str_starts_with($secret, 'rk_test_')) {
throw new DomainRuleException('Etappe 1 erlaubt nur den Stripe-Testmodus (Schlüssel sk_test_).');
}
}
/**
* @return array{id: string, url: string}|null
*/
private function reusableSession(Order $order): ?array
{
$payment = $order->payments()->where('provider', 'stripe')->where('status', 'offen')->latest('id')->first();
if ($payment === null) {
return null;
}
try {
$response = $this->request()->get('/v1/checkout/sessions/'.$payment->provider_reference);
} catch (ConnectionException) {
return null;
}
if ($response->successful() && $response->json('status') === 'open' && filled($response->json('url'))) {
return ['id' => (string) $payment->provider_reference, 'url' => (string) $response->json('url')];
}
return null;
}
private function request(): PendingRequest
{
return Http::baseUrl(rtrim((string) config('services.stripe.api_base'), '/'))
->withToken((string) config('services.stripe.secret'))
->asForm()
->acceptJson()
->timeout(15);
}
private function assertOk(Response $response, string $what): void
{
if ($response->successful()) {
return;
}
// Nur Statuscode und Fehlertyp ins Log, nie Schlüssel oder Kundendaten.
Log::warning('Stripe-Anfrage fehlgeschlagen', [
'status' => $response->status(),
'type' => $response->json('error.type'),
'code' => $response->json('error.code'),
]);
throw new DomainRuleException('Die Zahlung konnte bei Stripe nicht '.$what.' werden. Bitte versuche es später noch einmal.');
}
}
@@ -0,0 +1,59 @@
<?php
namespace App\Domain\Commerce\Stripe;
use App\Domain\Catalog\DomainRuleException;
/**
* Prüft die Signatur einer Stripe-Meldung (Header „Stripe-Signature“: t=Zeit, v1=HMAC-SHA256 über „t.Nutzlast“).
* Eine Meldung ohne gültige Signatur oder außerhalb der Zeittoleranz wird abgewiesen.
*/
class StripeSignature
{
public const TOLERANCE_SECONDS = 300;
public function verify(string $payload, ?string $header, ?int $now = null): void
{
$secret = (string) config('services.stripe.webhook_secret');
if ($secret === '') {
throw new DomainRuleException('Das Webhook-Geheimnis ist nicht eingerichtet.');
}
if ($header === null || trim($header) === '') {
throw new DomainRuleException('Die Signatur fehlt.');
}
$timestamp = null;
$signatures = [];
foreach (explode(',', $header) as $part) {
[$key, $value] = array_pad(explode('=', trim($part), 2), 2, '');
if ($key === 't') {
$timestamp = ctype_digit($value) ? (int) $value : null;
} elseif ($key === 'v1' && $value !== '') {
$signatures[] = $value;
}
}
if ($timestamp === null || $signatures === []) {
throw new DomainRuleException('Die Signatur ist unvollständig.');
}
$expected = hash_hmac('sha256', $timestamp.'.'.$payload, $secret);
$valid = false;
foreach ($signatures as $signature) {
$valid = hash_equals($expected, $signature) || $valid;
}
if (! $valid) {
throw new DomainRuleException('Die Signatur stimmt nicht.');
}
if (abs(($now ?? now()->getTimestamp()) - $timestamp) > self::TOLERANCE_SECONDS) {
throw new DomainRuleException('Die Meldung ist zu alt.');
}
}
}
+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()));
}
}
+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');
}
}
+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;
@@ -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();
@@ -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).
@@ -3,7 +3,11 @@
namespace App\Filament\Support;
use App\Domain\Catalog\ContentElement;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Cms\Widgets\Support\WebsiteImage;
use App\Domain\Media\FilmStill;
use App\Domain\Media\WebsiteMedia;
use App\Filament\Resources\ContentElements\ContentElementResource;
use Filament\Notifications\Notification;
/**
@@ -31,6 +35,82 @@ 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()));
}
/**
* @param callable(FilmStill, ContentElement): ContentElement $make
*/
private function adoptFilmStill(string $pfad, int $elementId, callable $make): void
{
abort_unless(ContentElementResource::editor(), 403);
if (preg_match('/^(data|mountedActions\.\d+\.data)(\.[A-Za-z0-9_-]+)+\.image$/', $pfad) !== 1) {
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);
$title = ($still->display_title ?: $still->working_title);
if (! $stills->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;
}
// Dieselbe Stelle war schon übernommen: Der tatsächliche Stand des Bildes entscheidet über die Meldung.
if (app(WebsiteMedia::class)->present($still) !== null) {
Notification::make()->success()->title('Bereits im Medienmanager: „'.$title.'“')->body('Diese Stelle war schon übernommen. Das Bild ist als Kartenbild ausgewählt.')->send();
} elseif (blank($still->thumbnail_path) && blank($still->thumbnail_error)) {
Notification::make()->success()->title('Bereits im Medienmanager: „'.$title.'“')->body('Das Bild wird noch verarbeitet und danach für die Website freigegeben.')->send();
} else {
Notification::make()->warning()->title('Bild ausgewählt, aber nicht für die Website freigegeben: „'.$title.'“')
->body('Diese Stelle war schon übernommen und die Website-Freigabe wurde zurückgenommen. Das Bild erscheint öffentlich erst wieder, wenn sie im Medienmanager (Reiter „Website“) erneut gegeben wird.')
->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'),
@@ -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,13 @@
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\Shop;
use App\Domain\Commerce\StaleOverview;
use App\Domain\Commerce\Stripe\StripeGateway;
use App\Domain\Entitlement\GrantIssuer;
use App\Http\Controllers\Controller;
use Illuminate\Http\RedirectResponse;
@@ -48,17 +53,74 @@ 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,
'testPayment' => ! app()->isProduction() && config('services.payment.driver') === 'test',
'stripePayment' => Shop::stripe(),
'zahlung' => $request->query('zahlung'),
]);
}
/** Leitet zur Stripe-Kasse (Testmodus). Freigeschaltet wird erst durch die signierte Meldung von Stripe. */
public function pay(Request $request, Order $order, StripeGateway $stripe): RedirectResponse
{
abort_unless($order->user_id === $request->user()->id, 403);
abort_unless(Shop::stripe(), 404);
try {
$session = $stripe->checkoutFor($order);
} catch (DomainRuleException $exception) {
return back()->withErrors(['payment' => $exception->getMessage()]);
}
return redirect()->away($session['url']);
}
public function confirm(Request $request, Order $order, Checkout $checkout): RedirectResponse
{
abort_unless($order->user_id === $request->user()->id, 403);
@@ -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]);
}
}
@@ -0,0 +1,114 @@
<?php
namespace App\Http\Controllers;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Commerce\Checkout;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\Payment;
use App\Domain\Commerce\Shop;
use App\Domain\Commerce\Stripe\StripeSignature;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
/**
* Empfängt die signierten Meldungen von Stripe (Etappe 1: Testmodus). Ohne gültige Signatur geschieht nichts. Die
* Freischaltung nutzt denselben geprüften Weg wie die Testzahlung und ist bei Wiederholung wirkungslos.
* Antworten: 404 wenn Stripe nicht aktiv ist, 400 bei ungültiger Signatur, sonst 200 (Stripe wiederholt sonst).
*/
class StripeWebhookController extends Controller
{
public function __invoke(Request $request, StripeSignature $signature, Checkout $checkout): JsonResponse
{
abort_unless(Shop::stripe(), 404);
$payload = $request->getContent();
try {
$signature->verify($payload, $request->header('Stripe-Signature'));
} catch (DomainRuleException $exception) {
Log::warning('Stripe-Meldung abgewiesen', ['grund' => $exception->getMessage()]);
return response()->json(['error' => 'Ungültige Signatur.'], 400);
}
$event = json_decode($payload, true);
if (! is_array($event) || ! isset($event['type'])) {
return response()->json(['error' => 'Ungültige Nutzlast.'], 400);
}
$session = (array) ($event['data']['object'] ?? []);
return match ($event['type']) {
'checkout.session.completed', 'checkout.session.async_payment_succeeded' => $this->paid($session, $checkout),
'checkout.session.expired', 'checkout.session.async_payment_failed' => $this->notPaid($session, (string) $event['type']),
default => response()->json(['received' => true, 'handled' => false]),
};
}
/**
* @param array<string, mixed> $session
*/
private function paid(array $session, Checkout $checkout): JsonResponse
{
if (($session['payment_status'] ?? null) !== 'paid') {
return response()->json(['received' => true, 'handled' => false]);
}
$order = $this->orderOf($session);
$reference = (string) ($session['id'] ?? '');
if ($order === null || $reference === '') {
Log::warning('Stripe-Zahlung ohne zugehörige Bestellung', ['session' => $reference]);
return response()->json(['received' => true, 'handled' => false]);
}
try {
$checkout->confirmProviderPayment(
$order,
'stripe',
$reference,
(int) ($session['amount_total'] ?? -1),
(string) ($session['currency'] ?? ''),
);
} catch (DomainRuleException $exception) {
// Dauerhafter Fehler (Betragsabweichung, Bestellung nicht mehr offen): nichts freischalten, Zahlung zur
// Prüfung festhalten und 200 antworten, damit Stripe nicht endlos wiederholt.
Log::warning('Stripe-Zahlung nicht übernommen', ['order' => $order->id, 'session' => $reference, 'grund' => $exception->getMessage()]);
$order->payments()->updateOrCreate(['provider_reference' => $reference], ['provider' => 'stripe', 'status' => 'zu_pruefen']);
return response()->json(['received' => true, 'handled' => false]);
}
return response()->json(['received' => true, 'handled' => true]);
}
/**
* @param array<string, mixed> $session
*/
private function notPaid(array $session, string $type): JsonResponse
{
$payment = Payment::query()->where('provider', 'stripe')->where('provider_reference', (string) ($session['id'] ?? ''))->first();
// Die Bestellung bleibt offen und lässt sich erneut bezahlen; nur diese Kasse gilt nicht mehr.
if ($payment !== null && $payment->status === 'offen') {
$payment->status = $type === 'checkout.session.expired' ? 'abgelaufen' : 'fehlgeschlagen';
$payment->save();
}
return response()->json(['received' => true, 'handled' => $payment !== null]);
}
/**
* @param array<string, mixed> $session
*/
private function orderOf(array $session): ?Order
{
$id = $session['client_reference_id'] ?? ($session['metadata']['order_id'] ?? null);
return is_numeric($id) ? Order::query()->find((int) $id) : null;
}
}
+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);
}
}
+2
View File
@@ -17,6 +17,8 @@
)
->withMiddleware(function (Middleware $middleware): void {
$middleware->trustProxies(at: '*');
// Stripe sendet ohne Sitzung und CSRF-Token; die Signatur der Meldung ersetzt beides.
$middleware->validateCsrfTokens(except: ['stripe/webhook']);
$middleware->prepend(UseStaffSessionCookie::class);
$middleware->prepend(UseRequestRootUrl::class);
$middleware->prepend(IgnoreEmptyForwardedHeaders::class);
+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),
+7
View File
@@ -29,9 +29,16 @@
],
'payment' => [
// test: Testweg ohne Anbieter. stripe: Stripe-Kasse, in Etappe 1 nur mit Testschlüsseln (sk_test_).
'driver' => env('PAYMENT_DRIVER', 'test'),
],
'stripe' => [
'secret' => env('STRIPE_SECRET'),
'webhook_secret' => env('STRIPE_WEBHOOK_SECRET'),
'api_base' => env('STRIPE_API_BASE', 'https://api.stripe.com'),
],
'slack' => [
'notifications' => [
'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'),
@@ -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.
}
};
+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;
}
}
+4 -1
View File
@@ -27,7 +27,10 @@ MAIL_MAILER=log
MAIL_FROM_ADDRESS="noreply@example.invalid"
MAIL_FROM_NAME="${APP_NAME}"
# test bleibt der lokale Testweg. Ein echter Zahlungsdienst ist noch nicht festgelegt.
# test: lokaler Testweg ohne Anbieter. stripe: Stripe-Kasse, in Etappe 1 nur mit Testschlüsseln und nie in Produktion.
# Die Schlüssel stehen nur in /etc/luf/<umgebung>.env auf dem Server, nie im Repo.
PAYMENT_DRIVER=test
# STRIPE_SECRET=sk_test_... (Entwickler > API-Schlüssel, Testmodus)
# STRIPE_WEBHOOK_SECRET=whsec_... (Entwickler > Webhooks > Endpunkt > Signiergeheimnis)
# Medienpfade setzt Compose auf den Host-Mount (/srv/luf/<env>/media/...). Hier nichts eintragen.
@@ -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,7 @@ ## Ü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 |
---
@@ -200,7 +201,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 +230,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 +315,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 +518,7 @@ ## 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`.
**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 +548,16 @@ ## 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.
@@ -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
+5 -1
View File
@@ -312,6 +312,10 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**Darstellung** (Reiter „Darstellung“): Variante `adaptive` (ab 520 px Bild neben Text) oder `stacked` (Bild immer oben); Höhe `auto` oder `fill` („An die Zeile angleichen“); `settings.format` (`landscape` 16:9 Vorgabe, `square`, `portrait` 3:4); `settings.fit` (`cover` Vorgabe, `contain` für Dokumente und Poster); `settings.heading_level` (`h3` Vorgabe, `h2`, `h4`); Anzeigen/Ausblenden von Kurzbeschreibung, Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px).
**Text der Medienkarte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`); nur an der Medienkarte. `auto` entspricht dem bisherigen Verhalten (Kurzbeschreibung, sonst Teaser). Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Die ausführliche Beschreibung erscheint nur auf diese Wahl (öffentlich, sofern die Karte öffentlich ist). Der eigene Text der Karte (`data.summary`) hat Vorrang.
**Bild aus dem Film (Medienkarte).** Reiter „Medien“, nur bei einem Film: „Vorschaubild des Films übernehmen“ oder eine Stelle wählen. `FilmStill` legt das Einzelbild (bis 1600 px) einmal als Bild-Medium ab; `refs.image` trägt dessen Kennung. Details und Grenzen: `medienzugriff-fuer-komponenten.md`, Abschnitt „Text der Medien- und Materialkarte, Bild aus dem Film“.
**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.
@@ -320,7 +324,7 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39)
**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.
@@ -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,41 @@ ## 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 nur an der Medien- und Materialkarte; Themen- und Programmkarte lesen weiter ihren Text.
### 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. „Vorschaubild des Films übernehmen“ oder
2. eine Zeitposition wählen, „Anzeigen“, „Dieses Bild übernehmen“.
`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).
+24
View File
@@ -27,6 +27,30 @@ ## Env-Datei ändern (zum Beispiel Mail, `APP_URL`)
**nginx findet die neue App selbst (seit 21.11.2026).** Der Web-Container löst den Namen `app` über Dockers DNS zur Laufzeit auf (`resolver 127.0.0.11` in `docker/nginx/default.conf`). Vorher war die Adresse beim Start von nginx festgeschrieben: Ein erneuter Lauf mit unverändertem Code erzeugte die App neu, nicht aber den Web-Container, und Prod antwortete mit 502, bis `luf-prod-web-1` neu gestartet wurde (20.11.2026). Ein Test (`tests/Unit/NginxConfigTest.php`) hält die Konfiguration fest.
## Stripe-Sandbox (nur Test, Etappe 1)
Die Stripe-Kasse läuft ausschließlich im Testmodus und nie in Produktion. Sie ist nur aktiv, wenn `PAYMENT_DRIVER=stripe` gesetzt ist; sonst bleibt es beim Testweg (`test`). Ein Schlüssel ohne `sk_test_` (oder `rk_test_`) wird abgewiesen, in Produktion lehnt die Anwendung Stripe ganz ab. Kartendaten berühren die Anwendung nie, bezahlt wird bei Stripe.
**Ablauf:** Bestellung anlegen, „Jetzt bezahlen (Stripe-Testmodus)“, Weiterleitung zur Stripe-Kasse. Freigeschaltet wird erst durch die signierte Meldung von Stripe an `POST /stripe/webhook` (Ereignis `checkout.session.completed`). Betrag und Währung werden gegen die Bestellung geprüft; wiederholte Meldungen schalten nichts doppelt frei. Eine Zahlung mit falschem Betrag oder auf eine nicht mehr offene Bestellung schaltet nichts frei und steht als Zahlung mit Status `zu_pruefen` in der Bestellung.
**Einrichten (Test):**
1. In Stripe den Testmodus („Sandbox“) wählen. Unter Entwickler > API-Schlüssel den Geheimschlüssel `sk_test_…` kopieren.
2. Unter Entwickler > Webhooks einen Endpunkt anlegen: URL `https://dev.laraundfelix.de/stripe/webhook`, Ereignisse `checkout.session.completed`, `checkout.session.expired`, `checkout.session.async_payment_succeeded`, `checkout.session.async_payment_failed`. Das Signiergeheimnis `whsec_…` des Endpunkts kopieren.
3. Auf llm-node in `/etc/luf/test.env` eintragen (Rechte `640`, nichts davon ins Repo, in Commits, Logs oder Chat):
```
PAYMENT_DRIVER=stripe
STRIPE_SECRET=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
```
4. In Gitea den letzten Lauf von „Deploy Test“ erneut starten (siehe „Env-Datei ändern“). `docker exec luf-test-app-1 printenv PAYMENT_DRIVER` muss `stripe` zeigen.
5. Testkauf mit der Stripe-Testkarte `4242 4242 4242 4242` (beliebiges künftiges Ablaufdatum, beliebige Prüfziffer). In Stripe unter Entwickler > Webhooks > Endpunkt > Ereignisse ist jede Zustellung samt Antwortcode zu sehen.
**Zurück zum Testweg:** `PAYMENT_DRIVER=test` setzen und neu ausrollen. Offene Stripe-Bestellungen bleiben offen.
**Grenzen:** Erstattungen laufen nicht über Stripe. Die Schaltfläche „Widerrufen“ ist im Stripe-Modus ausgeblendet; die Rückzahlung gehört zum Verkaufsstart (Live-Stripe, Belegprozess, Rückabwicklung). Steuer, Rechnung, Rabattcodes und Rechtstexte sind nicht Teil der Sandbox.
## Trennung Test und Prod (beide auf llm-node)
| | Test | Prod |
@@ -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 |
@@ -19,13 +19,13 @@ ## Kontext und Anforderungen
| FACH-05 | Laufend neue Elemente, Angebote und Bundles zusammenstellen | Bedarf bestätigt | Auswahl, Zuordnung und Zusammenstellung sind zentrale alltägliche Arbeitsabläufe |
| FACH-06 | Shop-, Lizenz-, Mitgliederverwaltung und Sonderrabatte gehören zu häufigen Aufgaben des erwarteten Gesamtsystems | Bedarf bestätigt; vollständige Arbeitsplätze laut Auftraggeber noch nicht gebaut | Im Gesamtkonzept Platz vorsehen; vorhandene Basisfunktionen nicht mit vollständigen Arbeitsplätzen gleichsetzen |
| FACH-07 | Kombinationen und Pakete konnten bisher nicht sinnvoll konfiguriert und genutzt werden | Nutzerbericht, nicht durch erfolgreiche Konfiguration widerlegt | Leere Bestände nicht nur als fehlende Testdaten behandeln; später einen realen Beispielablauf prüfen |
| FACH-08 | Ein bereits aktiviertes Angebot muss geändert werden können | Bedarf bestätigt; Wirksamkeits- und Fassungsregeln offen | Zugang „Bearbeiten“ im selben Arbeitsplatz; Wirkung und betroffene Gegenstände klar zeigen. Keine vollständige Neuerfassung erzwingen |
| FACH-08 | Ein aktives Angebot kann bearbeitet werden | Bestätigt | Bestehende vorbelegte Änderungsmaske verwenden. Änderungen werden bei ausdrücklicher manueller Aktivierung als neue Fassung wirksam. Abbrechen verwirft offene Eingaben. Preis in Euro und Wirkung der Aktion anzeigen. |
| FACH-09 | Ein bestehendes oder altes Angebot soll als Schablone für ein weiteres dienen können | Bedarf bestätigt; Übernahmeregeln offen | Eigenständige Handlung „Als Vorlage verwenden“ vorsehen. Welche Texte, Varianten, Zeiträume und Rabattregeln übernommen oder zurückgesetzt werden, ist noch festzulegen |
| FACH-10 | Parallele Angebote müssen möglich sein | Bedarf bestätigt; Detailregeln offen | Mehrere eigenständige Angebote mit überlappendem Inhalt oder abweichenden Konditionen verständlich verwaltbar halten |
| FACH-11 | Varianten nach der zu erwerbenden Lizenz können innerhalb eines Angebots liegen | Fachliche Möglichkeit ausdrücklich genannt | Design muss Varianten verständlich darstellen können; keine Festlegung auf eine einzige Variante pro Angebot |
| FACH-11 | Das Produkt kann mehrere kaufbare Lizenzoptionen haben | Bestätigt | Die gemeinsame Angebotsseite zeigt die Optionen mit Preis und Konditionen. |
| FACH-12 | Alternativ können Lizenzvarianten als parallele Angebote geführt werden, etwa bei anderen Laufzeiten oder Beschreibungen | Alternative ausdrücklich offen | Nicht durch Navigation oder Auswahlmaske ausschließen; keine automatische Entscheidung zwischen Variante und eigenständigem Angebot |
| FACH-13 | Angebote können Laufzeiten haben | Bedarf bestätigt; genaue Regeln offen | Lizenzdauer, Verkaufs-/Angebotszeitraum und gegebenenfalls Aktionszeitraum begrifflich unterscheidbar halten; vorhandenes Modell abgleichen |
| FACH-14 | Rabattierungslogiken und Sonderrabatte müssen berücksichtigt werden | Bedarf bestätigt; Mechanik offen | Platz und verständliche Bearbeitung vorsehen. Preisformeln, Gültigkeit, Zielgruppen, Kombinierbarkeit und Vorrang von Regeln bleiben offen |
| FACH-14 | Verwaltung von Rabattcodes und Zertifizierungsberechtigung | Bestätigt | Ein Code je Bestellung. Geltung für Warenkorb oder bestimmte Produkte. Gemeinsamer Zertifizierungscode ist nach Prüfung und Kontofreigabe wiederholt einlösbar. |
| FACH-15 | Mehrere Präsentationsformen: ausführliche Produktseite, Kacheln mit Kurzangaben und weitere Ansichten | Bedarf bestätigt | Präsentation eigenständig, ausgabespezifisch prüfbar; keine einzelne Shopvorschau zum zentralen Angebotseditor machen |
| FACH-16 | Präsentation speist sich hauptsächlich aus Beschreibungen des jeweiligen Einzelprodukts, etwa Programm, Modul oder Sammlung | Bedarf bestätigt; Detailauflösung abzugleichen | Quelle und wirksamen Text erkennbar machen. Bei mehreren Produkten keine automatische gemeinsame Beschreibung unterstellen |
| FACH-17 | Beschreibungen sollen überarbeitbar bleiben | Bedarf bestätigt; Geltungsbereich je Änderung prüfen | Eigene Abweichung, Produktangabe und ausgabespezifische Formulierung verständlich unterscheiden; Rückkehr zur Quelle gestalterisch berücksichtigen |
@@ -70,19 +70,18 @@ ## Kontext und Anforderungen
| FACH-56 | Fachliche Materialarten, Altersbereich/Zielgruppen, Einsatzbereiche und redaktionelle Verwendungszwecke zentral selbst pflegen | Bedarf vom Auftraggeber am 20.11.2026 ausdrücklich bestätigt | Gemeinsame Stammdatenpflege; bestehende Tabellen und Beziehungen wiederverwenden. Fachliche Säulen behalten ihre vorhandene Pflege und werden nicht dupliziert. Keine Codeänderung für jeden neuen redaktionellen Auswahlwert verlangen |
| FACH-57 | Auswahlwerte entsprechend ihrem fachlich zulässigen Objektkontext anbieten | Bedarf aus Gespräch vom 20.11.2026; konkrete Zuordnungsregeln am Bestand abzugleichen | Ungefilterten Gesamtkatalog nicht überall anbieten. Medienfilter, Medieneditor und Picker verwenden dieselbe kontextgerechte Auswahl; Objektarten wie Modul/Programm nicht als Materialart eines Mediums anbieten |
| FACH-58 | Einheitliche Begriffe und dieselben Stammdaten in Bearbeitung, Filtern und Picker verwenden | Zusammenhang im lokalen Code geprüft; UX-Benennung inkonsistent | Das derzeit als „Inhaltsart“ beschriftete Feld und der Filter „Fachliche Materialart“ referenzieren editorial_content_kind_id. Durchgängige Bezeichnung „Fachliche Materialart“; technische Art, Präsentationsrolle, tatsächliche Verwendung und Rechte davon unterscheiden |
| FACH-59 | Warenkorb mit mehreren Angeboten in den neuen Shopumfang aufnehmen | Vom Auftraggeber am 20.11.2026 ausdrücklich gegenüber der früheren Planung geändert | Der frühere Ausschluss in 16_MVP_Slice §3.3 gilt nicht für den neuen Shopauftrag. Mehrere ausgewählte Angebote vor dem Kauf gemeinsam prüfen und bestellen können; je Bestellposition Angebotsfassung, Preis/Konditionen und aufgelösten Lizenzumfang erhalten. Keine neue Produkt- oder Lizenzhierarchie daraus ableiten |
| FACH-59 | Mehrere Angebote in einem Warenkorb gemeinsam bestellen | Bestätigt | Preisänderung anzeigen. Zurückgezogene Position bleibt sichtbar und blockiert den Abschluss bis zur manuellen Entfernung. Bereits erworbene Position mit identischem Umfang und identischen Rechten bleibt markiert und entfernbar, zählt aber weder zur Summe noch zur Bestellung. Pro bestellter Position Angebotsfassung, Preis, Konditionen und Umfang erhalten. Der Warenkorb verwendet vorkonfigurierte Angebote. Bestehende Rechte werden bei Überschneidungen nicht automatisch verrechnet. |
## Bewusst offene Entscheidungen
| ID | Frage | Bisherige Aussage |
|---|---|---|
| OFF-01 | Was ist in der künftigen Bedienung ein Angebot, eine Variante und eine eigene parallele Vermarktung? | Varianten innerhalb eines Angebots und parallele Angebote werden beide als mögliche Lösungen genannt |
| OFF-02 | Wie funktionieren Angebotsfassungen, Bearbeitung aktiver Angebote, Historie und Wirksamkeitswechsel genau? | Bestehende Dokumentation sieht feste aktive Fassungen vor; UX-Aussage einer zwingenden neuen Fassung bei jeder Bearbeitung wurde ausdrücklich wieder geöffnet |
| OFF-01 | Wann sind parallel vermarktete Angebote fachlich eigenständig? | Die gemeinsame Seite mit Lizenzoptionen steht fest. Die Abgrenzung eigenständiger Angebote bei abweichendem Leistungsversprechen bleibt zu präzisieren. |
| OFF-03 | Wie werden Änderungen für zukünftige Erwerbe und mögliche Wirkungen auf bestehende Berechtigungen unterschieden? | Historische Vereinbarungen und bereits festgelegte Aktualisierungsregeln erhalten; keine neue allgemeine Rückwirkungsregel beschlossen |
| OFF-04 | Was übernimmt eine Vorlage, was wird zurückgesetzt und bleibt eine Verbindung zur Vorlage bestehen? | Wiederverwendung alter und aktueller Angebote erforderlich; Details offen |
| OFF-05 | Wie werden Laufzeiten und unterschiedliche Zeiträume fachlich bestimmt? | Bedarf vorhanden; keine konkreten Dauern, Verlängerungs- oder Beendigungsregeln beschlossen |
| OFF-06 | Wann ist eine Aktion ein neues Angebot, wann eine Rabattregel? | Die Frage wurde gestellt, aber nicht entschieden; Diskussion zugunsten des Designs begrenzt |
| OFF-07 | Welche Rabattregeln gibt es und wie werden sie kombiniert? | Keine Preise, Formeln, Rangfolgen oder Kombinationsregeln beschlossen |
| OFF-07 | Welche Rabattberechnung, Laufzeit- und Einlösedetails gelten darüber hinaus? | Ein Code je Bestellung, Warenkorb- oder Produktgeltung und Wiederverwendbarkeit des Zertifizierungscodes stehen fest. |
| OFF-08 | Wie leiten sich Beschreibung und Darstellung bei mehreren Produkten ab? | Einzelproduktdaten sind Hauptquelle; nicht eindeutig ableitbare Gesamttexte und Überschreibungen müssen gesondert geregelt werden |
| OFF-09 | Welche Stellung haben Trainingspläne und Sammlungen im bestehenden Modell? | Im erwarteten Arbeitsalltag genannt; keine neue technische Objekthierarchie entschieden |
| OFF-10 | Welche Angaben sind mit Nutzung und Verwertung gemeint und wie grenzen sie sich von Verwendungszweck, tatsächlichen Referenzen und Nutzungsrechten ab? | Der zusätzliche Informationsbedarf ist bestätigt. Vorhandene Begriffe und Daten abgleichen; im Design keine neue fachliche Bedeutung oder Zugriffserlaubnis festlegen |
@@ -132,16 +131,6 @@ ### Prüffälle für die spätere Umsetzung
Die Stammdatenpflege ist eine neue bestätigte Anforderung, keine bereits implementierte oder abgenommene Funktion. Die genannten Bedienmöglichkeiten konkretisieren den Bedarf als Folgeauftrag; technisch erforderliche Anpassungen sind unter den bestehenden Repository- und Migrationsregeln umzusetzen.
## Shopentscheidung 20.11.2026 – Warenkorb jetzt erforderlich
Der Auftraggeber bestätigt, dass ein Warenkorb in der ursprünglichen Planung bewusst ausgeschlossen war, ihn für den nun anstehenden Shopausbau jedoch ausdrücklich benötigt. Das ist eine neue Umfangsentscheidung und keine rückwirkend behauptete alte Anforderung oder ein bloß unentdeckter Implementierungsfehler.
Die Vereinfachung „Kein Warenkorb mit mehreren Angeboten, sondern Kauf je Angebot“ aus [MVP-Slice §3.3](../../architektur/16_MVP_Slice.md) ist für den neuen Shopauftrag damit aufgehoben. Alte Website-/Strategiehinweise, die darauf verweisen, beschreiben den früheren Planungsstand und dürfen den neuen Warenkorb nicht verhindern.
Der Warenkorb führt mehrere ausgewählte bestehende Angebote in einen gemeinsamen Bestellabschluss. Die vorhandene Trennung von Inhalt, Lizenzartikel, Paket, Angebot, Bestellung und Erwerb bleibt erhalten. Jede Bestellposition hält ihren vereinbarten Umfang und ihre Konditionen nachvollziehbar fest; Zahlungsverarbeitung, Rechtevergabe und Rückabwicklung müssen alle Positionen korrekt behandeln. Dies beauftragt keinen frei konfigurierbaren Kunden-Paketbaukasten und keine automatische Verrechnung überlappender Rechte.
Detailregeln zu zulässigen Mengen, Persistenz, Zusammenführung bei Anmeldung, Preisänderungen und Rabattkombinationen werden im Shopauftrag konkretisiert. Sie sind durch die bloße Warenkorbentscheidung noch nicht sämtlich beschlossen. Die grundsätzliche Entscheidung für einen Warenkorb muss nicht erneut zur Abstimmung gestellt werden.
## Gegenprüfung mit vorhandenen Projektquellen
| Quelle | Bereits dokumentierte Aussage | Umgang damit |
@@ -31,6 +31,7 @@ ## Bisher und jetzt
| Filament-Kopfaktionen (Fassung freigeben, Neue Fassung, Bibliothek anzeigen/ausblenden, Stand veröffentlichen/zurückziehen) | Benannte Aktionen, aus dem gemeinsamen Kopf aufgerufen; seltene in „Weitere Aktionen“ | `kopf.blade.php`, `…Action()`-Methoden |
| Lizenzartikel: Filament-Abschnitte und eingebettete Redaktion | Kopf, Überblick (Präsentation, Stand, Angebote), Redaktion als eigener Arbeitsplatz | `editorial/license-desk.blade.php` |
| CMS-Seite: Filament-Kopf, Seitenformular mit Raster und Gestaltung an jedem Abschnitt, Revisionen als Tabelle unter dem Formular, Widgetdialog „Widget bearbeiten“ | Seitenaufbau als Überblick mit Miniaturvorschau je Baustein und knappen Abschnittsköpfen; Bildfelder über den gemeinsamen Picker (statt eigener Auswahlliste); Abschnittsgestaltung in drei Gruppen; „Entwurf speichern“ auch im Bausteindialog. Seitenkopf mit getrenntem Speicher- und Veröffentlichungszustand („Entwurf speichern“, Strg+S, „Veröffentlichen …“, Seitenvorschau, Live-Seite unter „Weitere Aktionen“); Register Seiteninhalt, Seiteneinstellungen, Verlauf. Seitenaufbau zeigt Abschnitte mit Plätzen; „Abschnitt gestalten“ öffnet einen Kontext für Raster und Gestaltung genau eines Abschnitts (Adresse `?abschnitt=N`, Esc und „Zur Seite“ zurück); „Konfigurieren“ öffnet den Baustein als großen Kontext mit Vorschau, Verlassen nur über „Zur Seite“ (übernimmt) oder „Änderungen verwerfen“. Ein Fehler in einem ausgeblendeten Register oder Abschnittsteil macht ihn sichtbar. Wiederherstellen einer Revision und Veröffentlichungsregeln unverändert | `cms/seite-kopf.blade.php`, `EditPage`, `SectionEditor`, `WidgetEditor` |
| Fachliche Säulen: Medien und Seiten über die Säulenverwaltung, Module, Programme und Lizenzartikel über eine nicht abgeglichene Kopie als Dimension | Eine Quelle: Säulenverwaltung (`pillars`) für alle fünf Objektarten; Auswahl in der Redaktion, Filter in Medien, Modulen und Programmen, Aufbau-Picker und Mitgliederbibliothek; alte Zuordnungen verlustfrei übernommen (`luf:saeulen-uebernehmen`); Kopie bleibt nur als Verlauf | `PillarService`, `AssignsPillars`, `LegacyPillarAdoption` |
| Redaktionelle Auswahlwerte nur über Migrationen änderbar; „Inhaltsart“ bot allen Objekten alle Materialarten an | Arbeitsplatz „Redaktionelle Stammdaten“ (fachliche Materialarten, Altersbereich und Zielgruppe, Einsatzbereich, Verwendungszweck; Säulen verlinkt): Anlegen, Umbenennen bei fester Kennung, Deaktivieren, Reihenfolge, Verwendung; Materialarten mit zulässigen Kontexten. Redaktion, Medien- und Kompositionsfilter, Picker und Mitgliederbibliothek nutzen dieselbe Regel; „Fachliche Materialart“ durchgängig (FACH-56 bis FACH-58) | `RedaktionelleStammdaten`, `EditorialVocabulary` |
| Seitenliste (Filament-Tabelle: Pfad, „Veröffentlicht: Ja/Entwurf“, Zuletzt bearbeitet, Duplizieren) | Webpräsenz, Register „Seiten“: gemeinsame Bestandsliste mit Titel und Adresse, Veröffentlichung (Revision, „Entwurf neuer“, „Nur Entwurf“), Menüzuordnung je Bereich oder „Ohne Menüeintrag“, Filter Veröffentlichung und Menü, Sortierung zuletzt bearbeitet (beide Richtungen) oder Adresse (beide Richtungen), Bearbeiten, Vorschau, Duplizieren (gleicher Dialog und Fehler). „Seite anlegen“ im Kopf. `/verwaltung/pages` leitet nach derselben Rechteprüfung dorthin | `Webpraesenz`, `verwaltung/bestand` |
| Navigationsverwaltung (Filament-Tabelle je Platz, Dialoge Anlegen/Bearbeiten, Sofort-Ausblenden, Ziehen, Löschen) | Webpräsenz, Register „Menüs“: Bereichsauswahl, Menübaum mit einer Untermenüebene, Detailbereich rechts (breit) bzw. ein aufgeklappter Eintrag (schmal) mit Menütext, Ziel (Seitenwahl mit Zustand oder Adresse), Untermenü von, Im Menü anzeigen, Menübereich, Aus Menü entfernen; Umordnen per Ziehen, Knöpfen oder Alt+Pfeil innerhalb der Ebene. Änderungen bilden einen Arbeitsstand und werden mit „Menüänderungen speichern“ gemeinsam geschrieben (vorher wirkte jede Handlung sofort). Regeln der bisherigen Form unverändert geprüft. `/verwaltung/navigation-items` leitet dorthin | `Webpraesenz`, `cms/menues`, `cms/menue-zeile`, `cms/menue-detail`, `cms/ziel-auswahl`, `bestaetigung`, `abgang` |
+186
View File
@@ -0,0 +1,186 @@
# Abnahme Etappe 1: Testkauf vom Shop bis zum lizenzgeprüften Download
Stand: 21.11.2026. **Geprüfter Code-Stand:** lokaler Arbeitsbaum auf `develop` (HEAD `6c8bbee`) mit den Änderungen dieser Etappe, **nicht committet, nicht gepusht**. Geprüft wurde lokal mit einer eigenen SQLite-Demo-Datenbank und echtem Browser (Playwright, Chromium), Breiten 1440, 760 und 390 px. **Stand dieses Abschnitts: lokal geprüft.** Die Nachbesserung auf `luf-test` steht im Abschnitt „Nachbesserung Shop-Verwaltung“ unten; der Vereinskauf ist dort weiterhin nicht geprüft, weil der Verein von Lars angelegt werden muss (siehe „Offene Punkte“). Der Auftrag erteilt keine Produktivfreigabe, und der Shop ist in Produktion abgeschaltet. Vorlage: [ux-abnahme-vorlage](../regeln/ux-abnahme-vorlage.md). Auftrag: „Entwicklungsauftrag für Etappe 1“ in [16_MVP_Slice](../../../architektur/16_MVP_Slice.md), Fälle aus der „Shop-Abnahme“ in [14_Szenarien_Matrix](../../../architektur/14_Szenarien_Matrix.md).
## Nachbesserung Shop-Verwaltung (Abnahmebefund von Lars, 21.11.2026)
**Geprüfte Commits** (alle auf `develop`, ausgerollt auf `luf-test`, enthalten `4e0760d`). Die Klickfolge lief über mehrere Stände, weil unterwegs Fehler im Browser auffielen:
| Phase | Stand auf luf-test |
|---|---|
| Artikel, Angebot, Paket, Paketangebot anlegen; erster Blick auf Shop und Produktseite | `d49b178` (Symbolgröße behoben) |
| Rechteprofil, Fassung 2 und 3, Artikel aus Programm und Modul, zweites Paket, Bestellungen 4 bis 6, Download | `4520dba` (Name aus dem Inhalt statt Kennung) |
| Schmale Ansichten und Tastatur | während des Rollouts von `9701777`, der genaue Stand ist nicht bekannt. Die Seiten sind seither unverändert |
| Shop und Produktseiten erneut geprüft (Bilder 14 und 15 neu aufgenommen) | `9701777` (Rückfall auf den Arbeitstitel) |
Die Codeunterschiede zwischen diesen Ständen betreffen nur die Symbolgröße (CSS) und die Namensauflösung im Shop und in den Listen. Das Deployment ist an der neuen Oberfläche erkannt, nicht an einem Workflow-Status: Der Gitea-Lauf war ohne API-Token nicht einsehbar. Weil `deploy-test` den Testjob voraussetzt, ist anzunehmen, dass das Gate bestanden hat. Gesehen habe ich es nicht. Den Stand `9701777` belegt der Abschnitt „Name und Beschreibung“ am Begleitmaterial-Artikel. Geprüft wurde im echten Browser (Edge über Playwright) auf `luf-test`, Breiten 1440, 760 und 390 px. Verwaltung mit einem Katalogverwalter-Konto samt TOTP, Kauf mit dem regulären Mitgliederkonto von Lars.
**Befund und Reproduktion.** Anlegen mit einem Namen funktionierte, danach fehlte der Weg zum kaufbaren Angebot. Auf `luf-test` am Artikel „Tora“ (ohne Stand) nachgestellt: einzige sichtbare Aktion „Redaktion bearbeiten“ ([Bild 01](etappe-1/nachbesserung/01-vorher-artikel-ohne-einstieg.png)). Der Inhalt ließ sich nur über „Weitere Aktionen → Stand veröffentlichen“ festlegen. Der Dialog hieß „Wurzel“, die Liste war unsortiert, und das Pflichtfeld „Einordnung“ fragte, warum dies „derselbe Lizenzartikel und kein neues Produkt“ sei ([Bild 02](etappe-1/nachbesserung/02-vorher-dialog-wurzel.png)). Pakete und Angebote nannten in den Auswahllisten nur Kennungen, auch von Artikeln ohne Stand. Nirgends stand, was zur Veröffentlichung fehlt. Im Code zusätzlich gefunden: Ein Angebot ließ sich auf einen Artikel ohne Stand aktivieren, Käufer hätten nichts erhalten. Ein Angebot erscheint im Shop nur über eine Produktseite, also ein Programm mit Anzeigefreigabe. Auch das sagte die Oberfläche nicht.
**Änderungen** (alles im bestehenden Verwaltungsdesign, ein gemeinsamer Baustein statt je Objekt eine Kopie, Standard 14, Abschnitt 9):
- **„Bis zur Veröffentlichung“** auf Lizenzartikel, Paket und Angebot (`PublicationReadiness`, `verwaltung/voraussetzungen.blade.php`): „Nächster Schritt“, je Schritt Zustand als Text und Symbol (Erledigt, Offen, Empfohlen) und ein Knopf dorthin. Das Angebot prüft fünf Schritte: Position und Preis, Inhalt vorhanden, Kauf mit Preis, Produktseite zugeordnet, Produktseite öffentlich.
- **Artikel:** „Inhalt festlegen“ als Hauptaktion im Kopf. Dialog „Freigegebener Inhalt“ (gruppiert nach Medien und Dokumente, Module und Programme) statt „Wurzel“, Einordnung beim ersten Stand vorbelegt, Knopf „Stand veröffentlichen“.
- **Auswahllisten** nennen Name, Kennung und Stand. Artikel ohne Stand sind gekennzeichnet („noch ohne Stand, nicht verwendbar“). Produktseiten nennen, ob sie im Shop auffindbar sind. Paketfassungen nennen ihre Artikel.
- **Absicherung:** Die Angebotsmaske lehnt Artikel ohne Stand ab, auch in Paketen, mit Erklärung und Weg zum Artikel. Das ist eine Oberflächenprüfung. `OfferService` ist unverändert (siehe Entscheidungen).
- **Erfolgsmeldungen** nennen den nächsten Schritt oder bestätigen, dass die Option kaufbar und im Shop auffindbar ist.
- **Namen im Shop:** Der Leistungsumfang zeigte die Kennung, obwohl die Redaktion den Namen aus dem Inhalt übernimmt. Er löst den Namen jetzt wie die Redaktion auf: eigener Name, Name des Inhalts, Arbeitstitel, zuletzt Kennung.
- **Darstellungsfehler im Browser gefunden und behoben:** Die Symbole der Schritte waren riesig (fiel in den Tests nicht auf).
**Klickfolge auf luf-test** (alle Objekte entstanden in der regulären Verwaltung, vorhandene Inhalte und Konten dienten als Ausgangsdaten):
| Schritt | Ergebnis | Beleg |
|---|---|---|
| Artikel anlegen, „Inhalt festlegen“ | Artikel mit „Lara im Park“ (Film) und „Trainerunterlage Abstand“ (Text) als Stand 1. Meldung „Stand 1 ist veröffentlicht“ | Bilder [03](etappe-1/nachbesserung/03-artikel-ohne-stand-naechster-schritt.png), [04](etappe-1/nachbesserung/04-dialog-inhalt-festlegen.png), [05](etappe-1/nachbesserung/05-artikel-mit-stand.png) |
| Angebot anlegen, „Fassung aktivieren“ | Option „Privatlizenz Film“, 12,00 €, Produktseite „Programm Abstand“. Fünf Schritte „Erledigt“. Meldung nennt: im Shop auffindbar | [06](etappe-1/nachbesserung/06-angebot-leer-naechster-schritt.png), [07](etappe-1/nachbesserung/07-angebot-maske.png), [08](etappe-1/nachbesserung/08-angebot-aktiv-voraussetzungen-erfuellt.png) |
| Paket anlegen, Artikel wählen, veröffentlichen | Paketfassung 1 aus zwei Artikeln. „Jeder enthaltene Artikel hat einen Inhalt“ erledigt | [09](etappe-1/nachbesserung/09-paket-leer-naechster-schritt.png), [10](etappe-1/nachbesserung/10-paket-maske-artikelauswahl.png), [11](etappe-1/nachbesserung/11-paket-veroeffentlicht.png) |
| Eigenes Angebot für das Paket | „Paketlizenz Film und Begleitmaterial“, 19,00 €, eigene Produktseite „UX-Prüfung, nur Test“ | [13](etappe-1/nachbesserung/13-paketangebot-aktiv.png) |
| Rechteprofil anlegen | Es gab nur ein Profil, und es erlaubte nur „ansehen“. Neues Profil „ansehen und laden“ in der Verwaltung angelegt, beide Angebote darauf umgestellt (Fassung 2, später Fassung 3) | [12](etappe-1/nachbesserung/12-rechteprofil-ansehen-und-laden.png) |
| Auffindbarkeit im Shop | `/shop` zeigt beide Produkte („ab 12,00 €“, „ab 19,00 €“), die Suche findet „Abstand“. Die Produktseiten zeigen Preis, Eignung, Laufzeit und je Artikel die Rechte. Das Paket führt beide enthaltenen Artikel auf | [14](etappe-1/nachbesserung/14-shop-beide-angebote.png), [15](etappe-1/nachbesserung/15-produktseite-paketangebot.png) |
| Testkauf mit regulärem Mitgliederkonto | Warenkorb vor der Anmeldung gefüllt und nach der Anmeldung erhalten, Summe 31,00 €, Kasse, „Bestellung anlegen“, „Testzahlung bestätigen“: Bestellung 6 bezahlt | [16](etappe-1/nachbesserung/16-warenkorb.png), [17](etappe-1/nachbesserung/17-kasse.png), [18](etappe-1/nachbesserung/18-bestellung-bezahlt.png) |
| Download | Die Programmseite in der Bibliothek zeigt „Laden“. Der Film kam als Datei (73.027.826 Bytes) | [19](etappe-1/nachbesserung/19-bibliothek-programm-mit-laden.png) |
Zwei frühere Testkäufe (Bestellungen 4 und 5) liefen mit Artikeln aus Einzelmedien und zeigten die Grenze unten („Laden“ fehlt). Die Artikel für den Download-Nachweis (Programm und Modul) und das zweite Paket entstanden danach auf demselben Weg. Die Angebote wurden dafür auf Fassung 3 umgestellt, was zugleich den Ablauf „Option ändern“ belegt.
**Schmale Ansicht und Tastatur.** Kein horizontaler Überlauf bei 760 und 390 px (gemessen an Artikel, Paket, Angebot, Shop und Produktseiten; die Angebotsmaske wurde nur als Bild aufgenommen, nicht gemessen): Bilder [20](etappe-1/nachbesserung/20-schmal-390-angebot.png), [21](etappe-1/nachbesserung/21-schmal-760-artikel.png), [22](etappe-1/nachbesserung/22-schmal-390-produktseite.png). Tab erreicht „Inhalt festlegen“, „Redaktion bearbeiten“ und „Angebote öffnen“ mit sichtbarem Fokusrahmen (3 px solid). Enter am Schritt öffnet den Dialog, Esc schließt ihn ([Bild 23](etappe-1/nachbesserung/23-tastatur-fokus-schritt.png)).
**Tests.** `php artisan test`: **439 grün**, Pint bestanden. Neu: `ShopVerwaltungAbnahmeTest` (11 Tests). Ein Bestandstest geändert und im Commit begründet: `OrganizationPurchaseTest::test_membership_boundaries_decide_the_club_access` setzte die Uhrzeit erst nach der Bestellung auf 12:00 UTC und scheiterte dadurch nach 12:00 UTC. Die feste Uhrzeit gilt jetzt vorher, die Assertions bleiben.
**Abweichung von den Verwaltungs-Tokens:** Das Stilblatt der Schritte (`.vw-schritt`) nutzt feste Größen und einen Umbruch bei `640px`. Das entspricht dem vorhandenen `40rem`, steht aber in einer anderen Einheit, und die Werte sind noch nicht in `tokens.md` dokumentiert. Das ist eine Nacharbeit ohne Wirkung auf die Funktion.
**Zur Entscheidung durch Lars (nicht umgesetzt):**
1. **Domänenregel statt Oberflächenprüfung.** `OfferService::activate` prüft den Stand des Artikels weiterhin nicht. Wer das Angebot nicht über die Maske anlegt, kann einen Artikel ohne Inhalt verkaufen. Eine Prüfung im Domänenmodell ändert eine Verkaufsregel und braucht deine Freigabe.
2. **Einzelmedium-Artikel haben in der Bibliothek kein „Laden“.** Die Artikelseite bietet bei Film nur „Vollbild“, bei Text nur „Ansehen“. „Laden“ gibt es nur auf Programm- und Modulseiten. Ein Artikel aus einem einzelnen Film lässt sich also kaufen, aber nicht laden, auch wenn das Rechteprofil „laden“ erlaubt. Für den Verkaufsstart sollte das entschieden werden.
3. **Rechteprofil und Download.** Die Angebotsmaske sagt nicht, dass ein Profil ohne „laden“ später keinen Download ergibt. Ein Hinweis dazu wäre eine kleine Erweiterung.
4. **Produktseite für Pakete.** Der Shop kennt nur Programme als Produktseite. Das Paketangebot hing deshalb an einem vorhandenen Programm („UX-Prüfung, nur Test“). Eine eigene Produktseite für Pakete ist eine Fachfrage.
5. **Begleitmaterial als Text.** Das Begleitmaterial ist ein Text und bietet nur „Ansehen“. Einen PDF-Download habe ich daher nicht geprüft.
**Nicht geprüft:** Zoom, Bildschirmleser, echte E-Mail-Bestätigung (das Mitgliederkonto bestand), Vereinskauf, Erstattung und Abbruch der Testzahlung im Browser, Parallelität, PDF-Download. Verwaltung und Shop wurden nicht mit Hochkontrast geprüft.
**Aufräumen auf luf-test:** Die Testdaten „Abnahme E1 …“ (vier Lizenzartikel, zwei Pakete, zwei Angebote, ein Rechteprofil, drei Bestellungen für das Mitgliederkonto von Lars) können nach der Abnahme archiviert werden.
## Aufgabe und Maßstab
- **Nutzeraufgabe:** Eine Einzelperson bestellt zwei Angebote in einer Bestellung. Ein Verein erwirbt eine Mehrfachlizenz. Beide laden danach Film und Begleitmaterial aus der Bibliothek. Der Betreiber bearbeitet und aktiviert eine Lizenzoption im Angebotsarbeitsplatz.
- **Maßstab:** [Verwaltungsstandard](../14-verwaltungsstandard.md) (gilt auch für den Shop), [Angebotsansicht und Maske aus Teil B](teil-b.md), Fachanforderungen FACH-11, FACH-20, FACH-59.
- **Gemeinsame Bausteine, wiederverwendet:** Objektkopf und Katalogseite (`catalog/objekt`) für die Option, `ListsCatalog` für die Angebotsliste, die bestehende Filament-Aktion „Geänderte Fassung aktivieren“ mit vorbelegter Maske, `OfferService` (Fassungsmodell), `GrantIssuer`, `DecideAccess`, die Bibliothek mit „Laden“-Aktionen, die öffentliche Programmseite `/programme/{komposition}`, die Website-Komponenten (Layout, Header, Buttons, Meldungen, Tokens).
- **Begründete Erweiterungen:** Warenkorb, Bestellübersicht, Shop-Suche, Mitgliedschaft mit Bestellberechtigung, Aktion „Aus dem Verkauf nehmen“ (ohne sie ist der Fall „Angebot zurückziehen“ nicht herstellbar). Gestaltung nur über `resources/css/components/lf-shop.css` mit Tokens aus `tokens.css`.
## Entscheidungen, die ich getroffen habe (bitte prüfen)
1. **Produkt = Komposition.** Eine Lizenzoption (`Offer`) zeigt über `offers.composition_id` auf die Komposition, deren öffentliche Seite die Produktseite ist. Optionen derselben Komposition sind die „Angebotsgruppe“ (Alternativen). Es gibt keinen zweiten Text: Titel, Beschreibung und Struktur kommen aus der zur Anzeige freigegebenen Fassung. Produktseite ist die bestehende Seite `/programme/{komposition}`, nicht eine zweite Adresse.
2. **Genau ein Lizenzinhaber je Bestellung** (Person oder ein Verein, für den das Konto bestellberechtigt ist). `orders.party_id` ist der Lizenzinhaber, `orders.user_id` das handelnde Konto, `order_lines.holder_party_id` die Kopie je Position. Optionen mit unpassender Inhaberart blockieren den Abschluss, bis sie entfernt oder der Inhaber gewechselt wird.
3. **„Bereits erworben“** nur, wenn **ein einzelner Erwerb** des vorgesehenen Inhabers jeden Umfangsposten der Fassung mit gleichem Zweck, gleichen Fähigkeiten und gleichen Optionen trägt (aktiv, im Gültigkeitsfenster, jede Erwerbsart). Reihenfolge der Fähigkeiten ist unerheblich. Rechte mehrerer Erwerbe werden nicht kombiniert.
4. **Freischaltung aus der Umfangskopie der Bestellposition** (`GrantIssuer::issueFromOrderLine`), nicht aus der Angebotsfassung. Alle Positionen in einer Transaktion mit der Zahlung.
5. **Bindung an die gezeigte Übersicht:** Die Bestellung trägt eine Prüfsumme aus Inhaber, Fassung, Preis und Zustand jeder Position. Beim Abschluss wird unter Sperre der Optionen neu geprüft. Abweichung ergibt keine Bestellung (`StaleOverview`), der Käufer sieht die aktualisierte Übersicht.
6. **Vereinszugriff:** Nur das auslösende Konto (`acquisitions.acting_user_id`) lädt herunter, **und nur solange seine Mitgliedschaft mit Bestellberechtigung besteht.** Das Mitgliedschaftserfordernis beim Abruf ist eine neue Regel, aus PF-08 und INV-13 abgeleitet. Eine zentrale Abfrage (`Grant::usableBy`) wird von `DecideAccess`, Bibliothek und Vorschaubildern verwendet.
7. **Preis in Euro** im Formular (statt Cent), Umrechnung serverseitig. Die zwei Bestandstests mit `price_cents` im Formular wurden bewusst angepasst.
8. **Produktivschutz:** Shop-Routen, Warenkorb im Seitenkopf und Optionsbereich der Produktseite gibt es nur, wenn die Umgebung nicht Produktion ist **und** der Zahlungstreiber `test` gilt (`Shop::enabled`). Auf Prod erscheint nach einem späteren Merge kein halber Shop. Der Kopflink folgt jetzt dem Shop und nicht mehr `cms.cart.*` (zwei Tests in `CmsSectionRenderingTest` entsprechend angepasst).
## Ergebnis
- **Vorher:** Einzelkauf einer Person-Option über die Seite „Angebote“ im Mitgliederbereich, eine Position je Bestellung, Freischaltung nur der ersten Position, keine Produktseite mit Optionen, kein Warenkorb, kein Verein als Inhaber, Preis in Cent in der Maske.
- **Nachher:** Siehe Prüfung unten. Datenmodell nur ergänzend (Migration `2026_11_21_130000_add_shop_foundation`): `offers.composition_id/option_label`, `memberships`, `acquisitions.acting_user_id`, `orders.total_cents/currency`, `order_lines.currency/tax_class/grant_kind/holder_party_id`. Bestehende Bestellungen erhalten Summe und Inhaber der Position per Rückfüllung. Nichts wird gelöscht oder umbenannt.
- **Wirkung der Aktivierung:** Erst „Fassung n aktivieren“ schaltet die neue Fassung dieser Option öffentlich. Bezeichnung und Produktseite der Option werden in derselben Handlung übernommen und erzeugen daher ebenfalls eine neue Fassung; offene Warenkörbe zeigen dann „Bedingungen aktualisiert“. Eine reine Umbenennung ohne neue Fassung gibt es nicht. Abbrechen verwirft die Eingaben. Die Maske nennt die betroffene Option, die Produktseite und die Wirkung auf bestehende Berechtigungen und andere Optionen.
- **Bestehende Daten und Rechte:** Frühere Fassungen bleiben gespeichert, ältere Bestellungen behalten Preis und Fassung (Test), freie Vergaben und frühere Käufe bleiben bei einer Erstattung aktiv (Test).
## Tatsächliche Prüfung
Quellen: `Tests` = automatisierte Tests (SQLite-Suite, Fakes für Mail und Speicher), `Browser` = Skripte im echten Browser gegen die lokale Anwendung (Ergebnisdateien im Ordner `etappe-1/`: `browser-ergebnisse-testkaeufe.txt` 16 von 16, `browser-ergebnisse-zustaende-tastatur-breiten.txt` 14 von 14, `browser-ergebnisse-nachweise-verein-abbrechen.txt` 9 von 9; Läufe auf dem Stand nach dem Review).
| Fall aus der Shop-Abnahme | Ergebnis / Beleg | Grenze |
|---|---|---|
| Kachel oder Shop-Suche öffnen | Tests `ShopProductPageTest`: Treffer, Suche, leerer Zustand, Produktseite mit Inhalt, Preis, Eignung, Laufzeit, Rechten. Browser: Bilder 01, 02, 41 | Produktseiten gibt es nur für Programme mit Anzeigefreigabe (Abweichung 2) |
| Zwei Angebote mit gewählten Optionen bestellen | Tests: eine Bestellung, zwei Positionen mit Fassung, Preis, Konditionen und Umfangskopie; Freischaltung genau einmal je Position (Wiederholung ohne Wirkung). **Testkauf 1 im Browser** bestanden: Bilder 20 bis 28 | – |
| Preis nach Hinzufügen ändern | Tests: alter und neuer Preis, „Neuen Preis übernehmen“, Bestellung zum neuen Preis, ältere Bestellung behält Preis und Fassung, geänderte Übersicht erzeugt keine Bestellung. Browser: Bilder 11, 48 | – |
| Angebot zurückziehen | Tests: Position bleibt sichtbar, blockiert den Abschluss, übrige Positionen bestellbar nach Entfernen. Browser: Bilder 42 bis 45 (Bestätigung, Option, Warenkorb) | – |
| Film und Begleitmaterial nach dem Testkauf laden | Tests: Abruf vor Zahlung 403, nach Zahlung 200 mit Anhang, fremdes Konto und fremde Signatur 403, anderer Artikel 403. Browser: Abruf vor Zahlung 403 (Bild 23), danach Downloads von Film und PDF (Bilder 26, 27, 33) | Dateien sind Platzhalter, keine echten Filme. Wiedergabe im Portal ist Sache des Players |
| Warenkorb vor der Anmeldung befüllen | Tests: Anmeldung führt zur Kasse, Registrierung und E-Mail-Bestätigung führen zur Kasse, Warenkorb bleibt in derselben Sitzung, dieselbe Option eine Position, Wechsel nur nach Rückfrage. Browser: Anmeldung (Bilder 04, 20, 21) | **E-Mail-Bestätigung nur im Test** (Mail gefälscht), nicht im Browser mit echtem Postfach |
| Identische Lizenz bereits erworben | Tests: Markierung, nicht in Summe und Bestellung, alles erworben sperrt die Kasse, Bundle mit zusätzlichem Inhalt bleibt als Einheit kaufbar, andere Zwecke oder anderer Inhaber zählen nicht, freie und manuelle Vergabe zählen, abgelaufene und widerrufene nicht, erneute Prüfung beim Abschluss. Browser: Bilder 12, 46, 47, 56 | – |
| Testzahlung scheitert, wird abgebrochen oder wiederholt bestätigt | Tests: Ablehnung vergibt nichts, spätere Bestätigung wird verweigert, wiederholte Bestätigung genau ein Erwerb je Position, **simulierter Ausfall bei der zweiten Position** lässt weder Zahlung noch Rechte zurück, Wiederholung gelingt | **Im Browser nicht geklickt** (nur „Bestätigen“) |
| Lizenzoption im Arbeitsplatz bearbeiten | Tests: Maske vorbelegt, Preis in Euro, Abbrechen verwirft, Aktivierung wirkt nur für die Option, übrige bleiben kaufbar, offener Warenkorb zeigt die Änderung. Browser: Bilder 07 bis 10, 54 (Maske), 54b (geänderte Eingabe vor „Abbrechen“), 55 (danach: Preis und Fassung unverändert) | Bezeichnung und Produktseite erzeugen mit der Aktivierung eine neue Fassung (Abweichung 3) |
| Vereins-Mehrfachlizenz erwerben | Tests: Verein als Lizenzinhaber, bestellendes Konto getrennt, nur dieses Konto lädt. **Zweites bestellberechtigtes Mitglied desselben Vereins** (Anna, `may_order = true`) erhält aus Veras Bestellung weder über `DecideAccess`, Medienroute (auch mit Veras Signatur), Bibliothek, Programmseite noch Vorschaubild etwas; Max (ohne Bestellberechtigung) und Fremde ebenfalls 403. Mitgliedschaftsgrenzen mit festem Datum (`valid_from`/`valid_until` heute, gestern, morgen) und Entzug von `may_order`. **Testkauf 2 im Browser** bestanden (Bilder 30 bis 34), danach Anna im Browser mit eingeblendetem Konto und Adresse (35 bis 38) | Verein und Konten stammen aus dem Seeder; keine Registrierung und Selbstverwaltung (später). Der Zugriff hängt auch an `may_order` (Entscheidung 6) |
| Vollerstattung und Bundle-Rückgabe (Verkaufsstart, hier mitgeprüft) | Tests: alle Positionen werden widerrufen, freie und frühere Erwerbe bleiben aktiv, Vereinsbestellung | Im Browser nicht geklickt |
| Rabattcode, Vereinsrechnung | Nicht Teil von Etappe 1 (Verkaufsstart) | – |
| Weitere Prüfung | Ergebnis / Beleg | Grenze |
|---|---|---|
| Leere, blockierte, fehlerhafte Zustände | Browser: leerer Warenkorb (40), Suche ohne Treffer (41), zurückgezogene Position (44), alles erworben (46, 47), geänderte Übersicht (48) | – |
| Tastatur und Fokus | Browser: Tab erreicht „In den Warenkorb“ und „Entfernen“, Fokusrahmen 3 px solid, Enter legt in den Warenkorb (49, 50). Esc schließt die Maske ohne Wirkung | Nur diese Wege; Dialog „Aus dem Verkauf nehmen“ nicht per Tastatur durchgespielt |
| Breiten | 1440 px (alle), 760 px (Verwaltung 53, 54), 390 px (Shop, Produktseite, Warenkorb, Kasse: 13, 14, 51, 52, 56) | **Zoom nicht geprüft** |
| Regression und Repository | `php artisan test`: **428 Tests grün** (Ausgangsstand vor Beginn 358 grün, 70 neue; nach dem Review erneut gelaufen). `pint --test app tests config database routes`: bestanden. Frontend-Build ohne Fehler | Instanz-Suite (U0) existiert nicht. Parallelität nur für die Aktivierung (bestehend), nicht für die Bestellung |
| Produktivschutz | Test: Shop nur mit Testzahlung und nie in Produktion (404 für Shop, Warenkorb, Optionsbereich) | – |
## Befunde des unabhängigen Reviews (Opus) und Umgang
Der Review las den gesamten Diff, ließ die neuen Testdateien laufen (63 Tests grün) und fand keinen Weg, über den ein fremdes Konto oder ein anderer Verein an Downloads, Bestellungen oder die Bibliothek kommt. Eingearbeitet:
- **Kernregel „nur das auslösende Konto“ war nicht abgesichert** (zweites Konto ohne Bestellberechtigung): jetzt Test und Browser-Beleg mit zweitem bestellberechtigten Mitglied; Mitgliedschaftsgrenzen mit festem Datum getestet.
- **„Bedingungen aktualisiert“** war halb gebaut: Zweig in der Bestellübersicht, eigener Knopf und eigene Rückmeldung, Test.
- **Falsche Meldung ohne zulässigen Lizenzinhaber** in der Kasse und unpassender Blockiertext bei falscher Inhaberart: korrigiert, Test.
- **Optionen ohne öffentliche Produktseite** ließen sich in den Warenkorb legen: jetzt nur mit freigegebener Produktseite, Test.
- **Preise:** Kauf nur über 0,00 € und höchstens 1.000.000 €, Test.
- **Hilfetexte** in der Maske zu „wirkt sofort“ und zur Kopplung von Eignung und Rechten korrigiert. Das System erzwingt die Kopplung nicht; der Seed-Test heißt jetzt entsprechend.
- **Rückfrage zum Optionswechsel** ist eine Region statt `alertdialog`.
- **Seeder:** Das Passwort steht nur noch für Tests im Code; sonst `LUF_DEMO_PASSWORD` oder ein zufälliges Passwort, ausgegeben auf der Konsole.
- **Belege:** Bild 36 war byte-identisch mit Bild 24 und zeigte kein Konto, Bild 35 keine Adresse, Bild 55 war identisch mit 53, Bild 11 stammte von vor dem Zählerzeichen. Ersetzt beziehungsweise ergänzt (35 bis 38, 54b, 55, 11); Konto und Adresse sind als gelbe Beschriftung eingeblendet (Teil des Belegs, keine Funktion der Anwendung).
**Offen und von Lars zu entscheiden** (nicht umgesetzt):
1. **Vereinsfall „bereits erworben“ gegen Download:** „Bereits erworben“ prüft den Inhaber, der Download das auslösende Konto. Ein zweites bestellberechtigtes Mitglied sieht „Bereits erworben“, kann aber nicht laden. Aktuell erklärt der Warenkorb das („Herunterladen kann nur das Konto, das die Lizenz bestellt hat“) und bietet keinen Weg zur Bibliothek an (Bild 38). Alternative: Für Organisationen zählt nur ein Erwerb des eigenen Kontos.
2. **Download an `may_order` gekoppelt** (Entscheidung 6): Wer nur die Bestellberechtigung verliert, verliert auch den Abruf früherer Vereinskäufe. Alternative: nur die Mitgliedschaft entscheidet.
3. **Demo-Konten auf `luf-test`:** Der Seeder legt drei Konten an (Vera ist für den Testverein bestellberechtigt). Ob `luf-test` von außen erreichbar ist, ist nicht geprüft.
**Bekannte Grenzen ohne Änderung:**
- **Doppeltes Absenden** von „Bestellung anlegen“ kann zwei offene Bestellungen erzeugen (der Warenkorb liegt in der Session, Laravel sperrt sie nicht). Fachlich zulässig, für Nutzer ein Fehler. Abhilfe wäre ein Einmal-Token.
- **Alter Einzelkauf** (Seite „Angebote“ im Mitgliederbereich, `Checkout::place`) prüft weder „bereits erworben“ noch die Prüfsumme und ist nicht an den Shop-Schalter gebunden (war vorher so).
- **Rollback:** Der Rollback setzt nur den Code zurück. Der alte Code bestätigt und erstattet nur die erste Position und vergibt an die Person. **Vor einem Rollback offene Shop-Bestellungen auf `luf-test` stornieren.** In Produktion ist der Shop aus.
- `Checkout::refund` prüft den Testzahlungsweg nicht und ist über `member.order.refund` auch in Produktion erreichbar (schon vorher so).
- **Commit:** Die beiden geänderten Bestandstests (`CmsSectionRenderingTest`: Warenkorb-Eintrag folgt dem Shop; `BestandslisteTest`: Maskentitel nennt die Option, Euro-Feld) sind in der Commit-Nachricht zu begründen (Repo-Regel). Es gibt keinen Commit.
## Gefundene und behobene Fehler
1. Ein Blade-Direktiv direkt hinter Text im Kopf-Warenkorblink brach das Kompilieren der ganzen Website. Durch die bestehenden Tests gefunden, behoben.
2. Die Maske der Option nannte nur die Option, nicht die Produktseite. Der Durchlauf zeigte, dass zwei Optionen „Privatlizenz“ heißen können. Der Text nennt jetzt beides.
3. Das Warenkorbsymbol zeigte keine Anzahl. Jetzt sichtbares Zählerzeichen, zusätzlich im zugänglichen Namen.
4. Der Preis brach in der schmalen Bestellübersicht um („29,00“ und „€“ getrennt). Jetzt ohne Umbruch.
5. Die Vorabfassung des Durchlaufs änderte versehentlich die falsche Option. Das lag am Skript, nicht an der Anwendung, und ist im Skript korrigiert.
6. Testdaten: Ein Test erwartete „49,00 €“ als nicht vorhanden, obwohl „149,00 €“ als Teil davon vorkommt. Der Test prüft jetzt den Namen der Option.
## Verbleibende Abweichungen und offene Punkte
1. **luf-test nicht geprüft** (laut CLAUDE.md wird UI dort belegt). Dafür braucht es einen Push nach `develop`, grüne Tests und den Verein auf der Instanz. Der Seeder `Database\Seeders\ShopDemoSeeder` legt Programme, Optionen, drei Konten und den Testverein an, läuft nicht in Produktion und ist wiederholbar. **Auf dem Server führe ich ihn nicht aus.** Lars führt ihn aus, oder es entsteht eine kleine Verwaltungsaktion für die Zuordnung eines bestellberechtigten Kontos zu einem Verein. Der Seeder schreibt Platzhalterdateien auf die Platte `media_derived`; dort schreibt nach Betriebsregel nur die Hintergrundverarbeitung, er muss also im Queue-Container laufen.
2. **Produktseiten nur für Programme.** `PublicCatalogReader` zeigt öffentlich nur Kompositionen der Art „Programm“. Einzelmodule als Produkt haben noch keine öffentliche Seite. Der Shop listet nur Programme mit Anzeigefreigabe.
3. **Auswahl der Produktseite** in der Maske ist ein Auswahlfeld mit Suche, nicht der gemeinsame Picker (für Kompositionen gibt es im Picker noch keinen Zweck). Bezeichnung und Produktseite einer Option sind keine bindenden Bedingungen, werden aber nur zusammen mit einer Aktivierung geändert und erzeugen eine neue Fassung. Eine eigene Aktion ohne neue Fassung wäre eine Erweiterung.
4. **Positionen in der Verwaltung** nennen weiterhin die Artikelkennung statt des Titels (vorher schon so).
5. **„Aus dem Verkauf nehmen“** ist eine zusätzliche Aktion, die der Auftrag nicht wörtlich nennt. Sie beendet die aktive Fassung, mit Bestätigung und Wirkungstext.
6. **Mitgliedschaft nur über den Seeder,** keine Oberfläche, wie vom Auftrag vorgesehen („vorbereiteter Verein“). Das Mitgliedschaftserfordernis beim Abruf ist eine neue Regel (Entscheidung 6).
7. **Ein Lizenzinhaber je Bestellung.** Ein Warenkorb mit Option für Person und für Verein wird erst nach Entfernen oder Wechsel des Inhabers bestellbar. Der Auftrag lässt das offen.
8. **Der Warenkorb endet mit der Abmeldung** (Session wird ungültig gemacht). Anmeldung und Registrierung erhalten ihn.
9. **Rechtliche Pflichtangaben der Bestellübersicht fehlen** (Widerruf, Zustimmung, AGB): Verkaufsstart.
10. **`/shop` steht vor dem CMS-Platzhalter.** Eine CMS-Seite mit dem Pfad `/shop` wäre verdeckt.
11. Nicht geprüft: Bildschirmleser, Hochkontrast, Zoom, echte E-Mail, Parallelität mehrerer Bestätigungen, Prüfungen aus Abschnitt 6.3 des Dokuments 16, die ausdrücklich zum Verkaufsstart gehören (INV/NT, Sicherheitstest, Betrieb).
## Wiederholung
- Tests: `php artisan test`, `vendor/bin/pint --test app tests config database routes`.
- Lokale Demo: Datenbank anlegen, `php artisan migrate`, `LUF_DEMO_PASSWORD=<passwort> php artisan db:seed --class=ShopDemoSeeder` (ohne Variable zufälliges Passwort, ausgegeben auf der Konsole). Konten: `tina.trainerin@example.test` (Privatperson), `vera.vorstand@example.test` (bestellberechtigt für den Testverein), `max.mitglied@example.test` (Mitglied ohne Bestellberechtigung). Nur Testdaten.
## Belege
Bilder liegen in [etappe-1/](etappe-1/). Auswahl:
| | |
|---|---|
| ![Shop](etappe-1/01-shop.jpg) | ![Produktseite](etappe-1/02-produktseite.jpg) |
| ![Rückfrage Wechsel](etappe-1/04-wechsel-rueckfrage.jpg) | ![Warenkorb mit Preisänderung](etappe-1/11-warenkorb-preisaenderung.jpg) |
| ![Option in der Verwaltung](etappe-1/07-option-seite.jpg) | ![Maske vorbelegt](etappe-1/08-option-maske-vorbelegt.jpg) |
| ![Testkauf 1, Übersicht](etappe-1/21-testkauf1-bestelluebersicht.jpg) | ![Testkauf 1, Abruf vor Zahlung](etappe-1/23-testkauf1-abruf-vor-zahlung-403.jpg) |
| ![Testkauf 1, Downloads](etappe-1/26-testkauf1-programm-mit-downloads.jpg) | ![Testkauf 2, Übersicht](etappe-1/31-testkauf2-bestelluebersicht-verein.jpg) |
| ![Testkauf 2, Downloads](etappe-1/33-testkauf2-bibliothek-verein-downloads.jpg) | ![Zweites bestellberechtigtes Konto: 403](etappe-1/35-testkauf2-zweites-konto-403.jpg) |
| ![Zweites Konto: Abruf gesperrt](etappe-1/36-testkauf2-zweites-konto-abruf-403.jpg) | ![Zweites Konto: bereits erworben](etappe-1/38-testkauf2-zweites-konto-warenkorb-erworben.jpg) |
| ![Eingabe vor Abbrechen](etappe-1/54b-verwaltung-eingabe-vor-abbrechen.jpg) | ![Nach Abbrechen](etappe-1/55-verwaltung-nach-abbrechen.jpg) |
| ![Zurückgezogen](etappe-1/44-zustand-warenkorb-zurueckgezogen.jpg) | ![Alles erworben](etappe-1/46-zustand-alles-bereits-erworben.jpg) |
| ![Übersicht geändert](etappe-1/48-zustand-uebersicht-geaendert.jpg) | ![Tastaturfokus](etappe-1/49-tastatur-fokus-produktseite.jpg) |
| ![Schmal: Kasse](etappe-1/52-schmal-kasse.jpg) | ![760 px: Maske](etappe-1/54-verwaltung-maske-760.jpg) |
Binary file not shown.

After

Width:  |  Height:  |  Size: 96 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 136 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 157 KiB

Loaded 100 of 215 files, more files were not shown because too many files have changed in this diff. Show more