Compare commits

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

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

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

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

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

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

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

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

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

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

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 18:00:52 +01:00
Lars 8b644292a7 Merge remote-tracking branch 'origin/develop' into feature/mitgliederbereich-v2
Deploy Test / test (push) Successful in 2m14s
Deploy Test / deploy (push) Successful in 38s
2026-11-22 18:00:09 +01:00
LarsandClaude Sonnet 5.5 8ecc1ecdaa Verlinke Anmeldung und Registrierung gegenseitig
CI Feature / test (push) Successful in 2m42s
Deploy Test / test (push) Successful in 2m50s
Deploy Test / deploy (push) Successful in 28s
Die Anmeldeseite wies Neukunden nicht auf die Registrierung hin und die
Registrierungsseite nicht auf die Anmeldung. Beide Seiten verlinken sich
jetzt, mit Feature-Tests.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 17:45:50 +01:00
183 changed files with 6092 additions and 207 deletions

No files matched your search

+90
View File
@@ -0,0 +1,90 @@
<?php
namespace App\Domain\Catalog;
/**
* Berechtigter Nutzerkreis einer Lizenzoption: Einzellizenz (ein Trainer) oder Mehrfachlizenz (festgelegte Zahl von
* Trainern). Das ist eine vertragliche Angabe der Lizenzoption. Sie ist unabhängig vom Lizenzinhaber (Person oder
* Verein), vom technischen Downloadzugriff (nur das bestellende Konto) und vom Nutzungszweck (ehrenamtlich,
* kommerziell, institutionell). Sie wird weder aus dem Zweck noch aus dem Preis abgeleitet.
*/
final class LicenceScope
{
public const SINGLE = 'einzel';
public const MULTI = 'mehrfach';
/** Obergrenze der Trainerzahl einer Mehrfachlizenz (Eingabeschutz). */
public const MAX_TRAINERS = 999;
/**
* @return array{0: ?string, 1: ?int} Nutzerkreis und Trainerzahl, geprüft und vereinheitlicht
*/
public static function normalise(?string $scope, mixed $trainers): array
{
$scope = filled($scope) ? (string) $scope : null;
if ($scope === null) {
if (filled($trainers)) {
throw new DomainRuleException('Die Trainerzahl gehört zu einer Einzel- oder Mehrfachlizenz. Wähle zuerst den Nutzerkreis.');
}
return [null, null];
}
if ($scope === self::SINGLE) {
if (filled($trainers) && (int) $trainers !== 1) {
throw new DomainRuleException('Eine Einzellizenz gilt für genau einen Trainer.');
}
return [self::SINGLE, 1];
}
if ($scope === self::MULTI) {
$count = filled($trainers) ? (int) $trainers : 0;
if ($count < 2 || $count > self::MAX_TRAINERS) {
throw new DomainRuleException('Eine Mehrfachlizenz gilt für mindestens 2 und höchstens '.self::MAX_TRAINERS.' Trainer. Gib die Zahl der Trainer an.');
}
return [self::MULTI, $count];
}
throw new DomainRuleException('Der Nutzerkreis ist Einzellizenz oder Mehrfachlizenz.');
}
/** Kurzform: „Einzellizenz · 1 Trainer“, „Mehrfachlizenz · bis zu 5 Trainer“ oder „keine Angabe“. */
public static function label(?string $scope, ?int $trainers): string
{
return match ($scope) {
self::SINGLE => 'Einzellizenz · 1 Trainer',
self::MULTI => 'Mehrfachlizenz · bis zu '.(int) $trainers.' Trainer',
default => 'Nutzerkreis nicht festgelegt',
};
}
/** Erklärung für Käufer: was der Umfang bedeutet und was er nicht bedeutet. */
public static function explanation(?string $scope, ?int $trainers): ?string
{
return match ($scope) {
self::SINGLE => 'Die Inhalte dürfen von einem Trainer eingesetzt werden.',
self::MULTI => 'Die Inhalte dürfen von bis zu '.(int) $trainers.' Trainern eingesetzt werden. Zugriff und Download erhält zum Start nur das bestellende Konto.',
default => null,
};
}
/** Wert für Vergleich identischer Lizenzen („Bereits erworben“). */
public static function key(?string $scope, ?int $trainers): string
{
return ($scope ?? '-').'|'.($trainers ?? 0);
}
/** @return array<string, string> */
public static function options(): array
{
return [
self::SINGLE => 'Einzellizenz (ein Trainer)',
self::MULTI => 'Mehrfachlizenz (mehrere Trainer)',
];
}
}
+8
View File
@@ -12,8 +12,16 @@ class Offer extends Model
'name',
'composition_id',
'option_label',
'standalone_bundle',
];
protected function casts(): array
{
return [
'standalone_bundle' => 'boolean',
];
}
/** Komposition, deren öffentliche Seite die Produktseite dieser Lizenzoption ist. */
public function composition(): BelongsTo
{
+42 -1
View File
@@ -102,10 +102,18 @@ public function activate(Offer $offer, array $lines, array $attributes = []): Of
'dynamic' => false,
'grant_kind' => 'kauf',
'holder_kind' => 'person',
'licence_scope' => null,
'trainer_count' => null,
], $attributes);
if ($offer->standalone_bundle && (count($lines) !== 1 || ! $lines[0]['target'] instanceof BundleVersion)) {
throw new DomainRuleException('Ein Angebot mit eigener Paketseite besteht aus genau einer Paketfassung. Wähle eine Paketfassung oder ordne das Angebot der Seite eines Programms zu.');
}
$this->assertAttributes($attributes);
[$attributes['licence_scope'], $attributes['trainer_count']] = LicenceScope::normalise($attributes['licence_scope'], $attributes['trainer_count']);
$scope = $this->scopeFor($lines);
$this->assertSellableContent($scope);
$this->assertCoverage($lines, $attributes);
return DB::transaction(function () use ($offer, $lines, $attributes, $scope): OfferVersion {
@@ -126,6 +134,8 @@ public function activate(Offer $offer, array $lines, array $attributes = []): Of
'dynamic' => $attributes['dynamic'],
'grant_kind' => $attributes['grant_kind'],
'holder_kind' => $attributes['holder_kind'],
'licence_scope' => $attributes['licence_scope'],
'trainer_count' => $attributes['trainer_count'],
]);
foreach (array_values($lines) as $index => $line) {
@@ -176,13 +186,18 @@ public function end(Offer $offer): OfferVersion
* Produktzuordnung der Option: Die Komposition bestimmt die öffentliche Produktseite und die Alternativgruppe,
* die Bezeichnung benennt die Option auf dieser Seite. Beides sind keine bindenden Konditionen.
*/
public function assignProduct(Offer $offer, ?int $compositionId, ?string $optionLabel): Offer
public function assignProduct(Offer $offer, ?int $compositionId, ?string $optionLabel, bool $ownBundlePage = false): Offer
{
if ($compositionId !== null) {
Composition::query()->findOrFail($compositionId);
}
if ($ownBundlePage && $compositionId !== null) {
throw new DomainRuleException('Ein Paket hat entweder eine eigene Paketseite oder die Seite eines Programms, nicht beides.');
}
$offer->composition_id = $compositionId;
$offer->standalone_bundle = $ownBundlePage;
$offer->option_label = filled($optionLabel) ? trim((string) $optionLabel) : null;
$offer->save();
@@ -219,6 +234,32 @@ private function assertAttributes(array $attributes): void
}
}
/**
* Ein Angebot ohne verkaufbaren Inhalt wird nicht aktiviert: Jeder Lizenzartikel des Umfangs braucht einen
* veröffentlichten Stand, sonst erhielten Käufer nichts. Die Prüfung liegt im Domänenmodell, nicht nur in der
* Maske, damit auch jeder andere Weg (Skript, Import) sie durchläuft.
*
* @param list<array{license_article_id: int, rights_profile_version_id: int}> $scope
*/
private function assertSellableContent(array $scope): void
{
$ids = array_values(array_unique(array_column($scope, 'license_article_id')));
$missing = LicenseArticle::query()->with('currentRelease')->whereIn('id', $ids)->orderBy('code')->get()
->filter(fn (LicenseArticle $article): bool => ! ($article->currentRelease instanceof ArticleRelease
&& StatusValue::of($article->currentRelease->status) === ReleaseStatus::Veroeffentlicht->value));
if ($missing->isEmpty()) {
return;
}
$names = $missing->map(fn (LicenseArticle $article): string => '„'.($article->working_title ?: $article->code).'“ ('.$article->code.')')->implode(', ');
throw new DomainRuleException(($missing->count() === 1 ? 'Der Lizenzartikel ' : 'Die Lizenzartikel ').$names
.($missing->count() === 1 ? ' hat' : ' haben')
.' noch keinen veröffentlichten Stand und vergibt'.($missing->count() === 1 ? '' : ' keine').' keine Inhalte. '
.'Lege zuerst am Artikel den Inhalt fest, bevor das Angebot aktiviert wird.');
}
/**
* @param list<array{target: LicenseArticle|BundleVersion, rights: RightsProfileVersion}> $lines
* @return list<array{license_article_id: int, rights_profile_version_id: int}>
+2
View File
@@ -19,6 +19,8 @@ class OfferVersion extends Model
'dynamic',
'grant_kind',
'holder_kind',
'licence_scope',
'trainer_count',
'activated_at',
];
+62 -6
View File
@@ -6,6 +6,9 @@
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Domain\Commerce\Discount\DiscountResult;
use App\Domain\Commerce\Discount\DiscountService;
use App\Domain\Identity\Party;
use App\Domain\Identity\PartyType;
use App\Models\User;
@@ -20,6 +23,9 @@ class Cart
{
public const KEY = 'shop.cart';
/** Eingelöster Rabattcode (Kennung); höchstens einer je Bestellung. */
public const DISCOUNT_KEY = 'shop.discount';
public const ADDED = 'added';
public const PRESENT = 'present';
@@ -32,6 +38,7 @@ public function __construct(
private readonly OwnershipCheck $ownership,
private readonly OrderHolders $holders,
private readonly OfferService $offers,
private readonly DiscountService $discounts,
) {}
/**
@@ -57,7 +64,10 @@ public function has(Offer $offer): bool
*/
public function alternativeTo(Offer $offer): ?Offer
{
if ($offer->composition_id === null) {
$products = app(ProductOptions::class);
$group = $products->groupKey($offer);
if ($group === null) {
return null;
}
@@ -65,8 +75,8 @@ public function alternativeTo(Offer $offer): ?Offer
return $ids === [] ? null : Offer::query()
->whereIn('id', $ids)
->where('composition_id', $offer->composition_id)
->first();
->get()
->first(fn (Offer $other): bool => $products->groupKey($other) === $group);
}
public function add(Offer $offer): string
@@ -133,13 +143,51 @@ public function acceptCurrent(Offer $offer): void
public function clear(): void
{
session()->forget(self::KEY);
session()->forget([self::KEY, self::DISCOUNT_KEY]);
}
/** Der im Warenkorb eingelöste Code, auch wenn er gerade nicht (mehr) gilt. */
public function discountCode(): ?DiscountCode
{
$id = session()->get(self::DISCOUNT_KEY);
return is_numeric($id) ? DiscountCode::query()->with('targets')->find((int) $id) : null;
}
/**
* Löst einen Code ein. Er wird nur vorgemerkt, wenn er für diesen Warenkorb und dieses Konto gilt; sonst bleibt
* der bisherige Stand und das Ergebnis nennt den Grund. Ein zweiter Code ersetzt den ersten (höchstens ein Code).
*/
public function applyCode(string $input, ?User $user, ?int $holderPartyId = null): DiscountResult
{
$code = $this->discounts->find($input);
if ($code === null) {
return new DiscountResult(null, DiscountResult::UNKNOWN, 'Diesen Code kennen wir nicht. Prüfe die Schreibweise.');
}
$previous = session()->get(self::DISCOUNT_KEY);
session()->put(self::DISCOUNT_KEY, $code->id);
$result = $this->review($user, $holderPartyId)->discount;
if ($result === null || ! $result->applied()) {
$previous === null ? session()->forget(self::DISCOUNT_KEY) : session()->put(self::DISCOUNT_KEY, $previous);
return $result ?? new DiscountResult($code, DiscountResult::NO_MATCH, 'Der Code kann auf diese Bestellung nicht angewendet werden.');
}
return $result;
}
public function removeCode(): void
{
session()->forget(self::DISCOUNT_KEY);
}
/**
* Serverseitige Prüfung: aktuelle Fassung, Preis, Kaufbarkeit, passende Inhaberart, vorhandene Rechte.
*/
public function review(?User $user = null, ?int $holderPartyId = null): CartReview
public function review(?User $user = null, ?int $holderPartyId = null, bool $lockDiscount = false): CartReview
{
$offers = Offer::query()
->whereIn('id', array_keys($this->items()))
@@ -203,7 +251,15 @@ public function review(?User $user = null, ?int $holderPartyId = null): CartRevi
}
}
return new CartReview($lines, $holder);
$code = $this->discountCode();
$discount = null;
if ($code !== null) {
$orderable = array_values(array_filter($lines, fn (CartLine $line): bool => $line->orderable()));
$discount = $this->discounts->evaluate($code, $user, $orderable, lock: $lockDiscount);
}
return new CartReview($lines, $holder, $discount);
}
/**
+8
View File
@@ -45,6 +45,14 @@ public function blocks(): bool
public function title(): string
{
if ($this->offer->standalone_bundle && $this->version !== null) {
$bundle = app(ProductOptions::class)->bundleOf($this->version);
if ($bundle !== null) {
return (string) $bundle->name;
}
}
$composition = $this->offer->composition;
return $composition !== null
+29 -3
View File
@@ -2,6 +2,7 @@
namespace App\Domain\Commerce;
use App\Domain\Commerce\Discount\DiscountResult;
use App\Domain\Identity\Party;
/**
@@ -16,6 +17,7 @@ final class CartReview
public function __construct(
public readonly array $lines,
public readonly ?Party $holder,
public readonly ?DiscountResult $discount = null,
) {}
/** @return list<CartLine> */
@@ -24,11 +26,35 @@ public function orderable(): array
return array_values(array_filter($this->lines, fn (CartLine $line): bool => $line->orderable()));
}
public function totalCents(): int
/** Summe der Listenpreise der Positionen, die in die Bestellung eingehen. */
public function subtotalCents(): int
{
return array_sum(array_map(fn (CartLine $line): int => (int) $line->currentPriceCents, $this->orderable()));
}
public function discountCents(): int
{
return $this->discount?->totalCents() ?? 0;
}
/** Endgültiger Zahlbetrag: Listenpreise abzüglich Rabatt. */
public function totalCents(): int
{
return $this->subtotalCents() - $this->discountCents();
}
/** Rabatt einer Position in Cent. */
public function discountFor(CartLine $line): int
{
return $this->discount?->forOffer($line->offer->id) ?? 0;
}
/** Ein vorgemerkter Code, der jetzt nicht gilt, hält die Bestellung an, bis er entfernt wird. */
public function discountBlocks(): bool
{
return $this->discount !== null && ! $this->discount->applied();
}
public function blocked(): bool
{
foreach ($this->lines as $line) {
@@ -47,7 +73,7 @@ public function empty(): bool
public function canOrder(): bool
{
return $this->holder !== null && ! $this->blocked() && ! $this->empty();
return $this->holder !== null && ! $this->blocked() && ! $this->empty() && ! $this->discountBlocks();
}
public function digest(): string
@@ -60,6 +86,6 @@ public function digest(): string
sort($parts);
return hash('sha256', ($this->holder?->id ?? 0).'|'.implode(',', $parts));
return hash('sha256', ($this->holder?->id ?? 0).'|'.implode(',', $parts).'|'.($this->discount?->digestPart() ?? '-'));
}
}
+116 -14
View File
@@ -6,12 +6,15 @@
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Domain\Commerce\Stripe\StripeGateway;
use App\Domain\Entitlement\Acquisition;
use App\Domain\Entitlement\AcquisitionType;
use App\Domain\Entitlement\GrantIssuer;
use App\Domain\Entitlement\GrantStatus;
use App\Domain\Identity\AccountStatus;
use App\Domain\Identity\Party;
use App\Domain\Identity\PartyType;
use App\Mail\OrderConfirmed;
use App\Models\User;
use Illuminate\Support\Facades\DB;
@@ -32,6 +35,12 @@ public function place(User $user, Offer $offer): Order
{
$this->assertActive($user);
// Dieser Einzelkauf kennt weder Zustimmungen noch „Zahlungspflichtig bestellen“. Im Livebetrieb gibt es nur den
// Weg über die Kasse mit Pflichtangaben.
if (Shop::live()) {
throw new DomainRuleException('Bestelle über den Warenkorb und die Kasse.');
}
$version = $this->offers->currentActiveVersion($offer);
if ($version->grant_kind !== 'kauf' || $version->holder_kind !== 'person') {
@@ -44,7 +53,7 @@ public function place(User $user, Offer $offer): Order
$holder = $this->holders->resolve($user, null);
return DB::transaction(fn (): Order => $this->createOrder($user, $holder, [[$offer, $version]]));
return DB::transaction(fn (): Order => $this->createOrder($user, $holder, [[$offer, $version]], null, null, Shop::driver() === 'stripe' ? 'stripe' : 'test'));
}
/**
@@ -53,14 +62,25 @@ public function place(User $user, Offer $offer): Order
* Bestellung und der Käufer sieht zuerst die aktualisierte Übersicht. Positionen, deren Umfang der Inhaber bereits
* mit denselben Rechten besitzt, erzeugen keine Bestellposition.
*/
public function placeFromCart(User $user, Cart $cart, ?int $holderPartyId, string $digest): Order
public function placeFromCart(User $user, Cart $cart, ?int $holderPartyId, string $digest, ?array $consent = null, ?string $paymentMethod = null): Order
{
$this->assertActive($user);
$order = DB::transaction(function () use ($user, $cart, $holderPartyId, $digest): Order {
// Optionen sperren, damit eine gleichzeitige Aktivierung die Prüfung nicht unterläuft.
if ($consent === null && Shop::live()) {
throw new DomainRuleException('Bitte bestätige die Zustimmungen vor dem verbindlichen Abschluss.');
}
$order = DB::transaction(function () use ($user, $cart, $holderPartyId, $digest, $consent, $paymentMethod): Order {
// Optionen und den Rabattcode sperren, damit eine gleichzeitige Aktivierung, Deaktivierung oder ein Entzug
// der Freigabe die Prüfung nicht unterläuft.
Offer::query()->whereIn('id', array_keys($cart->items()))->orderBy('id')->lockForUpdate()->get();
$review = $cart->review($user, $holderPartyId);
$discountId = session()->get(Cart::DISCOUNT_KEY);
if (is_numeric($discountId)) {
DiscountCode::query()->whereKey((int) $discountId)->lockForUpdate()->first();
}
$review = $cart->review($user, $holderPartyId, lockDiscount: true);
if ($review->holder === null) {
throw new DomainRuleException('Für diesen Lizenzinhaber ist das Konto nicht bestellberechtigt.');
@@ -78,9 +98,19 @@ public function placeFromCart(User $user, Cart $cart, ?int $holderPartyId, strin
throw new DomainRuleException('Es gibt nichts zu bestellen. Alle Positionen sind bereits erworben.');
}
if ($review->discountBlocks()) {
throw new DomainRuleException(($review->discount?->message ?? 'Der Rabattcode gilt nicht.').' Entferne den Code, um ohne Rabatt zu bestellen.');
}
$method = $paymentMethod ?? (Shop::driver() === 'stripe' ? 'stripe' : 'test');
if ($method === 'rechnung' && ! ($review->holder->type === PartyType::Organisation && Shop::invoice())) {
throw new DomainRuleException('Der Kauf auf Rechnung ist nur für Vereine und Organisationen auf Anfrage möglich.');
}
$pairs = array_map(fn (CartLine $line): array => [$line->offer, $line->version], $review->orderable());
return $this->createOrder($user, $review->holder, $pairs);
return $this->createOrder($user, $review->holder, $pairs, $review, $consent === null ? null : SalesTerms::proof($consent), $method);
});
$cart->clear();
@@ -90,16 +120,28 @@ public function placeFromCart(User $user, Cart $cart, ?int $holderPartyId, strin
/**
* @param list<array{0: Offer, 1: OfferVersion}> $pairs
* @param array<string, mixed>|null $terms Nachweis der Zustimmungen (SalesTerms::proof)
*/
private function createOrder(User $user, Party $holder, array $pairs): Order
private function createOrder(User $user, Party $holder, array $pairs, ?CartReview $review, ?array $terms, string $method): Order
{
$subtotal = array_sum(array_map(fn (array $pair): int => (int) $pair[1]->price_cents, $pairs));
$discount = $review?->discount;
$discountCents = $review?->discountCents() ?? 0;
$order = Order::query()->create([
'user_id' => $user->id,
'party_id' => $holder->id,
'status' => 'offen',
'holder_kind' => $holder->type->value,
'total_cents' => array_sum(array_map(fn (array $pair): int => (int) $pair[1]->price_cents, $pairs)),
'subtotal_cents' => $subtotal,
'discount_cents' => $discountCents,
'total_cents' => $subtotal - $discountCents,
'currency' => 'EUR',
'discount_code_id' => $discountCents > 0 ? $discount?->code?->id : null,
'discount_snapshot' => $discountCents > 0 ? $discount?->snapshot() : null,
'payment_method' => $method,
'terms_accepted_at' => $terms === null ? null : now(),
'terms_snapshot' => $terms,
]);
foreach ($pairs as [$offer, $version]) {
@@ -114,6 +156,9 @@ private function createOrder(User $user, Party $holder, array $pairs): Order
'tax_class' => $version->tax_class,
'grant_kind' => $version->grant_kind,
'holder_party_id' => $holder->id,
'licence_scope' => $version->licence_scope,
'trainer_count' => $version->trainer_count,
'discount_cents' => $discountCents > 0 ? $discount->forOffer($offer->id) : 0,
]);
$version->load('resolvedScopes.rights');
@@ -140,6 +185,7 @@ private function createOrder(User $user, Party $holder, array $pairs): Order
public function confirmTestPayment(Order $order, string $reference): Order
{
$this->assertTestDriver();
$this->assertTestOrder($order);
return $this->settle($order, 'test', $reference);
}
@@ -150,7 +196,7 @@ public function confirmTestPayment(Order $order, string $reference): Order
*/
public function confirmProviderPayment(Order $order, string $provider, string $reference, int $amountCents, string $currency): Order
{
$expected = (int) ($order->total_cents ?? $order->lines()->sum('price_cents'));
$expected = (int) ($order->total_cents ?? $order->lines()->sum('price_cents') - $order->lines()->sum('discount_cents'));
if ($amountCents !== $expected || strtoupper($currency) !== strtoupper((string) ($order->currency ?? 'EUR'))) {
throw new DomainRuleException('Der gezahlte Betrag weicht von der Bestellung ab.');
@@ -159,7 +205,23 @@ public function confirmProviderPayment(Order $order, string $provider, string $r
return $this->settle($order, $provider, $reference);
}
private function settle(Order $order, string $provider, string $reference): Order
/**
* Kauf auf Rechnung (PAY-006): Der Betreiber hat die Rechnung manuell erstellt und bestätigt den Zahlungseingang.
* Nur für Bestellungen mit Zahlungsweg „Rechnung“; das Mitglied kann das nicht selbst auslösen. Die Referenz
* (Rechnungsnummer oder Buchung) wird an der Zahlung festgehalten.
*/
public function confirmInvoicePayment(Order $order, string $reference, User $actor): Order
{
$order->refresh();
if ($order->payment_method !== 'rechnung') {
throw new DomainRuleException('Nur eine Bestellung auf Rechnung wird manuell als bezahlt bestätigt.');
}
return $this->settle($order, 'ueberweisung', 'rechnung-'.trim($reference), $actor);
}
private function settle(Order $order, string $provider, string $reference, ?User $confirmedBy = null): Order
{
$reference = trim($reference);
@@ -168,7 +230,7 @@ private function settle(Order $order, string $provider, string $reference): Orde
}
$paidNow = false;
$order = DB::transaction(function () use ($order, $provider, $reference, &$paidNow): Order {
$order = DB::transaction(function () use ($order, $provider, $reference, $confirmedBy, &$paidNow): Order {
$order = Order::query()->lockForUpdate()->findOrFail($order->id);
if ($order->status === 'bezahlt') {
@@ -182,7 +244,7 @@ private function settle(Order $order, string $provider, string $reference): Orde
// Eine bei Stripe angelegte offene Zahlung mit derselben Referenz wird bestätigt statt doppelt geführt.
$order->payments()->updateOrCreate(
['provider_reference' => $reference],
['provider' => $provider, 'status' => 'bestaetigt'],
['provider' => $provider, 'status' => 'bestaetigt', 'amount_cents' => $order->payable(), 'confirmed_by' => $confirmedBy?->id],
);
$order->status = 'bezahlt';
$order->save();
@@ -207,6 +269,7 @@ private function settle(Order $order, string $provider, string $reference): Orde
public function failTestPayment(Order $order, string $reference): Order
{
$this->assertTestDriver();
$this->assertTestOrder($order);
return DB::transaction(function () use ($order, $reference): Order {
$order = Order::query()->lockForUpdate()->findOrFail($order->id);
@@ -229,9 +292,11 @@ public function failTestPayment(Order $order, string $reference): Order
/**
* Vollerstattung: widerruft die Berechtigungen aller Positionen dieser Bestellung. Andere Erwerbsquellen
* (kostenlose Vergabe, frühere Käufe) bleiben unberührt.
* (kostenlose Vergabe, frühere Käufe) bleiben unberührt. Bundles sind Rückgabeeinheiten; freiwillige
* Teilerstattungen gibt es zum Start nicht. Bei einer Zahlung über Stripe wird die Rückzahlung zuerst bei Stripe
* veranlasst; erst wenn Stripe sie annimmt, werden Rechte entzogen. Wirkt sie dort nicht, bleibt alles unverändert.
*/
public function refund(Order $order, string $reason): Order
public function refund(Order $order, string $reason, ?StripeGateway $stripe = null): Order
{
$reason = trim($reason);
@@ -239,6 +304,13 @@ public function refund(Order $order, string $reason): Order
throw new DomainRuleException('Eine Erstattung braucht eine Begründung.');
}
$current = Order::query()->findOrFail($order->id);
$stripePayment = $current->payments()->where('provider', 'stripe')->where('status', 'bestaetigt')->latest('id')->first();
if ($current->status === 'bezahlt' && $stripePayment !== null) {
($stripe ?? app(StripeGateway::class))->refund($current, $stripePayment, $reason);
}
return DB::transaction(function () use ($order, $reason): Order {
$order = Order::query()->lockForUpdate()->findOrFail($order->id);
@@ -270,6 +342,28 @@ public function refund(Order $order, string $reason): Order
});
}
/**
* Das Mitglied erklärt den Widerruf (Verkaufsstart: kein Selbstbedienungs-Widerruf). Es entzieht nichts und
* erstattet nichts; der Betreiber prüft den Fall (Erlöschen des Widerrufsrechts bei sofortiger Bereitstellung mit
* ausdrücklicher Zustimmung) und erstattet bei Bedarf in der Bestellverwaltung.
*/
public function requestWithdrawal(Order $order, string $note): Order
{
if (! in_array($order->status, ['bezahlt', 'offen'], true)) {
throw new DomainRuleException('Für diese Bestellung kann kein Widerruf erklärt werden.');
}
if ($order->withdrawal_requested_at !== null) {
return $order;
}
$order->withdrawal_requested_at = now();
$order->withdrawal_note = trim($note) !== '' ? trim($note) : null;
$order->save();
return $order;
}
private function assertActive(User $user): void
{
if ($user->status !== AccountStatus::Aktiv || $user->party_id === null) {
@@ -277,6 +371,14 @@ private function assertActive(User $user): void
}
}
/** Eine Bestellung auf Rechnung oder über Stripe wird nie mit der Testzahlung bestätigt. */
private function assertTestOrder(Order $order): void
{
if (in_array(Order::query()->whereKey($order->id)->value('payment_method'), ['rechnung', 'stripe'], true)) {
throw new DomainRuleException('Diese Bestellung wird nicht mit der Testzahlung bezahlt.');
}
}
private function assertTestDriver(): void
{
if (app()->isProduction() || config('services.payment.driver') !== 'test') {
@@ -0,0 +1,74 @@
<?php
namespace App\Domain\Commerce\Discount;
/**
* Reine Rechenregel für den Rabatt je Position (ganze Cent, keine Datenbank, keine Uhr).
*
* Prozent: je Position gerundet (kaufmännisch, ab 0,5 Cent nach oben), höchstens der Positionspreis. Die Summe ist
* die Summe der gerundeten Positionsrabatte. Das kann um bis zu einen Cent je Position von der Rundung auf der
* Warenkorbsumme abweichen (Rechenbeispiel in der Abnahme zum Verkaufsstart, Fachfrage).
*
* Betrag: Der Festbetrag gilt je Bestellung, höchstens bis zur Summe der betroffenen Positionen. Er wird anteilig
* zum Positionspreis verteilt; verbleibende Cent erhalten die Positionen mit dem größten Rest, bei Gleichstand die
* frühere Position.
*/
final class DiscountCalculator
{
/**
* @param array<int|string, int> $prices Schlüssel der Position => Preis in Cent (nur betroffene Positionen)
* @return array<int|string, int> Schlüssel => Rabatt in Cent
*/
public static function allocate(string $kind, ?int $percent, ?int $amountCents, array $prices): array
{
$discounts = array_fill_keys(array_keys($prices), 0);
if ($prices === []) {
return $discounts;
}
if ($kind === DiscountCode::PERCENT) {
$percent = max(0, min(100, (int) $percent));
foreach ($prices as $key => $price) {
$discounts[$key] = min($price, intdiv($price * $percent + 50, 100));
}
return $discounts;
}
$sum = array_sum($prices);
$total = min(max(0, (int) $amountCents), $sum);
if ($total === 0 || $sum === 0) {
return $discounts;
}
$remainders = [];
$given = 0;
foreach ($prices as $key => $price) {
$share = intdiv($total * $price, $sum);
$discounts[$key] = $share;
$remainders[$key] = ($total * $price) % $sum;
$given += $share;
}
$rest = $total - $given;
$order = array_keys($prices);
usort($order, fn ($left, $right): int => $remainders[$right] <=> $remainders[$left]);
foreach ($order as $key) {
if ($rest === 0) {
break;
}
if ($discounts[$key] < $prices[$key]) {
$discounts[$key]++;
$rest--;
}
}
return $discounts;
}
}
@@ -0,0 +1,103 @@
<?php
namespace App\Domain\Commerce\Discount;
use App\Domain\Commerce\Money;
use Carbon\CarbonInterface;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
/**
* Rabattcode (PAY-008, FACH-14). Zwei voneinander unabhängige Einstellungen:
* - Geltungsbereich: gesamter Warenkorb oder nur ausdrücklich gewählte Ziele (Angebot, Lizenzartikel, Paket);
* - Einlösungsberechtigung: allgemein oder nur für ausdrücklich freigeschaltete Konten (Freigabe gilt nur für diesen Code).
* Der Rabatt ändert den Preis, nie den Nutzungsumfang.
*/
class DiscountCode extends Model
{
public const PERCENT = 'prozent';
public const AMOUNT = 'betrag';
public const SCOPE_CART = 'warenkorb';
public const SCOPE_SELECTED = 'auswahl';
public const OPEN = 'allgemein';
public const RESTRICTED = 'freigabe';
public const TARGET_OFFER = 'angebot';
public const TARGET_ARTICLE = 'lizenzartikel';
public const TARGET_BUNDLE = 'paket';
protected $fillable = [
'code',
'label',
'kind',
'percent',
'amount_cents',
'scope',
'eligibility',
'valid_from',
'valid_until',
'active',
'note',
];
protected function casts(): array
{
return [
'valid_from' => 'datetime',
'valid_until' => 'datetime',
'active' => 'boolean',
];
}
/** Eingabe und Speicherung vereinheitlicht: ohne Leerzeichen, Großschreibung. */
public static function normalise(string $input): string
{
return mb_strtoupper((string) preg_replace('/\s+/u', '', $input));
}
public function targets(): HasMany
{
return $this->hasMany(DiscountCodeTarget::class);
}
public function releases(): HasMany
{
return $this->hasMany(DiscountRelease::class)->latest('id');
}
public function restricted(): bool
{
return $this->eligibility === self::RESTRICTED;
}
public function forSelection(): bool
{
return $this->scope === self::SCOPE_SELECTED;
}
/** Lesbare Höhe: „10 %“ oder „5,00 €“. */
public function valueLabel(): string
{
return $this->kind === self::PERCENT
? (int) $this->percent.' %'
: Money::format((int) $this->amount_cents);
}
/** Zeitlicher Zustand zum Zeitpunkt: 'aktiv', 'abgelaufen', 'noch_nicht' oder 'deaktiviert'. */
public function stateAt(CarbonInterface $now): string
{
return match (true) {
! $this->active => 'deaktiviert',
$this->valid_from !== null && $this->valid_from->greaterThan($now) => 'noch_nicht',
$this->valid_until !== null && ! $this->valid_until->greaterThan($now) => 'abgelaufen',
default => 'aktiv',
};
}
}
@@ -0,0 +1,24 @@
<?php
namespace App\Domain\Commerce\Discount;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Ausdrücklich gewähltes Ziel eines Codes mit Geltungsbereich „Auswahl“. Ein Paket ist ein eigenes Ziel; seine
* Rabattfähigkeit folgt nie aus einem enthaltenen Lizenzartikel und umgekehrt.
*/
class DiscountCodeTarget extends Model
{
protected $fillable = [
'discount_code_id',
'target_type',
'target_id',
];
public function code(): BelongsTo
{
return $this->belongsTo(DiscountCode::class, 'discount_code_id');
}
}
@@ -0,0 +1,59 @@
<?php
namespace App\Domain\Commerce\Discount;
use App\Models\User;
use Carbon\CarbonInterface;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Freigabe eines Mitgliedskontos für genau einen Code. Freigaben werden nie gelöscht, nur entzogen; Verlauf und
* Begründung bleiben erhalten. Eine Freigabe für Code X berechtigt nicht zur Nutzung von Code Y.
*/
class DiscountRelease extends Model
{
protected $table = 'discount_code_releases';
protected $fillable = [
'discount_code_id',
'user_id',
'granted_by',
'granted_at',
'valid_until',
'revoked_by',
'revoked_at',
'reason',
];
protected function casts(): array
{
return [
'granted_at' => 'datetime',
'valid_until' => 'datetime',
'revoked_at' => 'datetime',
];
}
public function code(): BelongsTo
{
return $this->belongsTo(DiscountCode::class, 'discount_code_id');
}
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
public function grantor(): BelongsTo
{
return $this->belongsTo(User::class, 'granted_by');
}
public function isActiveAt(CarbonInterface $now): bool
{
return $this->revoked_at === null
&& $this->granted_at->lessThanOrEqualTo($now)
&& ($this->valid_until === null || $this->valid_until->greaterThan($now));
}
}
@@ -0,0 +1,83 @@
<?php
namespace App\Domain\Commerce\Discount;
/**
* Ergebnis der Prüfung eines Codes gegen einen Warenkorb: angewandt (Rabatt je Option) oder nicht angewandt mit
* einer verständlichen Begründung. Ein Code, der gerade nicht gilt, bleibt als Ergebnis sichtbar, damit der Käufer
* den Grund erfährt.
*/
final class DiscountResult
{
public const OK = 'ok';
public const UNKNOWN = 'unbekannt';
public const INACTIVE = 'deaktiviert';
public const NOT_YET = 'noch_nicht';
public const EXPIRED = 'abgelaufen';
public const LOGIN = 'anmeldung';
public const NO_RELEASE = 'keine_freigabe';
public const NO_MATCH = 'keine_position';
public const TOO_HIGH = 'zu_hoch';
/**
* @param array<int, int> $perOffer Kennung der Option => Rabatt in Cent
*/
public function __construct(
public readonly ?DiscountCode $code,
public readonly string $state,
public readonly ?string $message = null,
public readonly array $perOffer = [],
) {}
public function applied(): bool
{
return $this->state === self::OK && $this->totalCents() > 0;
}
public function totalCents(): int
{
return $this->state === self::OK ? array_sum($this->perOffer) : 0;
}
public function forOffer(int $offerId): int
{
return $this->state === self::OK ? (int) ($this->perOffer[$offerId] ?? 0) : 0;
}
/** Für die Bestellung festgehaltene Angaben zum Zeitpunkt der Bestellung. */
public function snapshot(): array
{
return [
'code' => $this->code?->code,
'label' => $this->code?->label,
'kind' => $this->code?->kind,
'percent' => $this->code?->percent,
'amount_cents' => $this->code?->amount_cents,
'scope' => $this->code?->scope,
'eligibility' => $this->code?->eligibility,
'discount_cents' => $this->totalCents(),
];
}
/** Teil der Prüfsumme der Bestellübersicht. */
public function digestPart(): string
{
$parts = [];
$perOffer = $this->perOffer;
ksort($perOffer);
foreach ($perOffer as $offerId => $cents) {
$parts[] = $offerId.'='.$cents;
}
return ($this->code?->id ?? 0).':'.$this->state.':'.implode(',', $parts);
}
}
@@ -0,0 +1,327 @@
<?php
namespace App\Domain\Commerce\Discount;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Commerce\CartLine;
use App\Domain\Commerce\Money;
use App\Models\User;
use Carbon\CarbonInterface;
use Illuminate\Support\Carbon;
use Illuminate\Support\Facades\DB;
/**
* Prüfung und Pflege von Rabattcodes. Die Prüfung läuft serverseitig bei der Eingabe, in jeder Übersicht und
* unmittelbar vor Bestellabschluss (unter Sperre); sie liest nur und ändert keine Bestellung.
*/
class DiscountService
{
/** Kleinster Zahlbetrag einer Bestellung mit Rabatt (Mindestbetrag der Kartenzahlung bei Stripe: 0,50 EUR). */
public const MIN_PAYABLE_CENTS = 50;
public function find(string $input): ?DiscountCode
{
$code = DiscountCode::normalise($input);
return $code === '' ? null : DiscountCode::query()->where('code', $code)->first();
}
/**
* @param list<CartLine> $lines nur Positionen, die in die Bestellung eingehen
*/
public function evaluate(DiscountCode $code, ?User $user, array $lines, ?CarbonInterface $now = null, bool $lock = false): DiscountResult
{
$now ??= now();
$timing = $code->stateAt($now);
if ($timing !== 'aktiv') {
return new DiscountResult($code, $timing, match ($timing) {
'deaktiviert' => 'Dieser Code ist nicht mehr gültig, der Betreiber hat ihn deaktiviert.',
'noch_nicht' => 'Dieser Code gilt erst ab dem '.$code->valid_from?->timezone(config('app.timezone'))->format('d.m.Y').'.',
default => 'Dieser Code ist abgelaufen (gültig bis '.$code->valid_until?->timezone(config('app.timezone'))->format('d.m.Y').').',
});
}
if ($code->restricted()) {
if ($user === null) {
return new DiscountResult($code, DiscountResult::LOGIN, 'Dieser Code gilt nur für freigeschaltete Konten. Melde dich an, damit wir prüfen können, ob er für dein Konto gilt.');
}
if ($this->activeRelease($code, $user, $now, $lock) === null) {
return new DiscountResult($code, DiscountResult::NO_RELEASE, 'Dieser Code ist für dein Konto nicht freigeschaltet. Er gilt nur für Konten, die der Betreiber ausdrücklich dafür freigegeben hat. Wenn du denkst, dass dir die Freigabe zusteht, wende dich an den Betreiber.');
}
}
$matching = [];
foreach ($lines as $line) {
if ($line->version !== null && $this->matches($code, $line->offer, $line->version)) {
$matching[$line->offer->id] = (int) $line->currentPriceCents;
}
}
if ($matching === []) {
return new DiscountResult($code, DiscountResult::NO_MATCH, $code->forSelection()
? 'Dieser Code gilt nur für bestimmte Angebote, und keines davon liegt in deiner Bestellung.'
: 'In deiner Bestellung gibt es keine Position, auf die der Code angewendet werden kann.');
}
$perOffer = DiscountCalculator::allocate($code->kind, $code->percent, $code->amount_cents, $matching);
$payable = array_sum(array_map(fn (CartLine $line): int => (int) $line->currentPriceCents, $lines)) - array_sum($perOffer);
if ($payable < self::MIN_PAYABLE_CENTS) {
return new DiscountResult($code, DiscountResult::TOO_HIGH, 'Mit diesem Code läge der Zahlbetrag unter '.Money::format(self::MIN_PAYABLE_CENTS).'. Das ist beim Start nicht vorgesehen. Wähle zusätzlich eine weitere Position oder verzichte auf den Code.');
}
return new DiscountResult($code, DiscountResult::OK, null, $perOffer);
}
/**
* Passt die Position? Verglichen werden nur die ausdrücklich gewählten Ziele mit den unmittelbaren Positionen der
* Angebotsfassung. Ein Paket gilt nur, wenn es selbst gewählt ist; ein enthaltener Artikel macht es nicht
* rabattfähig, und ein Artikel in einem Paket macht das Angebot nicht rabattfähig.
*/
public function matches(DiscountCode $code, Offer $offer, OfferVersion $version): bool
{
if (! $code->forSelection()) {
return true;
}
$targets = $code->targets->groupBy('target_type')->map(fn ($rows) => $rows->pluck('target_id')->map(fn ($id): int => (int) $id)->all());
if (in_array($offer->id, $targets->get(DiscountCode::TARGET_OFFER, []), true)) {
return true;
}
$version->loadMissing('lines.bundleVersion');
foreach ($version->lines as $line) {
if ($line->license_article_id !== null && in_array((int) $line->license_article_id, $targets->get(DiscountCode::TARGET_ARTICLE, []), true)) {
return true;
}
if ($line->bundleVersion !== null && in_array((int) $line->bundleVersion->bundle_id, $targets->get(DiscountCode::TARGET_BUNDLE, []), true)) {
return true;
}
}
return false;
}
public function activeRelease(DiscountCode $code, User $user, ?CarbonInterface $now = null, bool $lock = false): ?DiscountRelease
{
$now ??= now();
$query = DiscountRelease::query()->where('discount_code_id', $code->id)->where('user_id', $user->id)->whereNull('revoked_at');
if ($lock) {
$query->lockForUpdate();
}
return $query->get()->first(fn (DiscountRelease $release): bool => $release->isActiveAt($now));
}
/**
* Legt einen Code an oder ändert ihn. Gleiche Prüfung für Anlegen und Bearbeiten.
*
* @param array<string, mixed> $data
* @param list<array{type: string, id: int}> $targets
*/
public function save(array $data, array $targets, ?DiscountCode $existing = null): DiscountCode
{
$code = DiscountCode::normalise((string) ($data['code'] ?? ''));
$label = trim((string) ($data['label'] ?? ''));
if (preg_match('/^[A-Z0-9][A-Z0-9_-]{2,39}$/', $code) !== 1) {
throw new DomainRuleException('Der Code besteht aus 3 bis 40 Zeichen: Buchstaben, Ziffern, Bindestrich oder Unterstrich, ohne Leerzeichen.');
}
if ($label === '') {
throw new DomainRuleException('Der Name des Codes fehlt. Er ist nur für die Verwaltung und erscheint nicht im Shop.');
}
if (DiscountCode::query()->where('code', $code)->when($existing !== null, fn ($query) => $query->whereKeyNot($existing->id))->exists()) {
throw new DomainRuleException('Diesen Code gibt es schon.');
}
$kind = (string) ($data['kind'] ?? '');
$percent = null;
$amount = null;
if ($kind === DiscountCode::PERCENT) {
$percent = (int) ($data['percent'] ?? 0);
if ($percent < 1 || $percent > 100) {
throw new DomainRuleException('Der Prozentsatz liegt zwischen 1 und 100.');
}
} elseif ($kind === DiscountCode::AMOUNT) {
$amount = Money::parse($data['amount_euro'] ?? ($data['amount_cents'] ?? null));
if ($amount === null || $amount <= 0) {
throw new DomainRuleException('Der Rabattbetrag ist ein Eurobetrag über 0,00 €.');
}
} else {
throw new DomainRuleException('Die Art des Rabatts ist Prozent oder fester Betrag.');
}
$scope = (string) ($data['scope'] ?? '');
$eligibility = (string) ($data['eligibility'] ?? '');
if (! in_array($scope, [DiscountCode::SCOPE_CART, DiscountCode::SCOPE_SELECTED], true)) {
throw new DomainRuleException('Der Geltungsbereich ist der gesamte Warenkorb oder eine Auswahl.');
}
if (! in_array($eligibility, [DiscountCode::OPEN, DiscountCode::RESTRICTED], true)) {
throw new DomainRuleException('Die Einlösung ist allgemein oder auf freigeschaltete Konten beschränkt.');
}
$targets = $this->cleanTargets($targets);
if ($scope === DiscountCode::SCOPE_SELECTED && $targets === []) {
throw new DomainRuleException('Wähle mindestens ein Angebot, einen Lizenzartikel oder ein Paket, für das der Code gilt, oder lass ihn für den gesamten Warenkorb gelten.');
}
$from = $this->date($data['valid_from'] ?? null);
$until = $this->date($data['valid_until'] ?? null, true);
if ($from !== null && $until !== null && $until->lessThanOrEqualTo($from)) {
throw new DomainRuleException('Das Ende der Gültigkeit liegt vor dem Beginn.');
}
return DB::transaction(function () use ($existing, $code, $label, $kind, $percent, $amount, $scope, $eligibility, $from, $until, $data, $targets): DiscountCode {
$model = $existing ?? new DiscountCode;
$model->fill([
'code' => $code,
'label' => $label,
'kind' => $kind,
'percent' => $percent,
'amount_cents' => $amount,
'scope' => $scope,
'eligibility' => $eligibility,
'valid_from' => $from,
'valid_until' => $until,
'active' => (bool) ($data['active'] ?? true),
'note' => filled($data['note'] ?? null) ? trim((string) $data['note']) : null,
]);
$model->save();
$model->targets()->delete();
if ($scope === DiscountCode::SCOPE_SELECTED) {
foreach ($targets as $target) {
$model->targets()->create(['target_type' => $target['type'], 'target_id' => $target['id']]);
}
}
return $model->load('targets');
});
}
public function setActive(DiscountCode $code, bool $active): DiscountCode
{
$code->active = $active;
$code->save();
return $code;
}
/**
* Schaltet ein Konto für genau diesen Code frei. Eine zweite aktive Freigabe desselben Kontos gibt es nicht.
*/
public function release(DiscountCode $code, User $member, ?User $actor, ?CarbonInterface $until = null, ?string $reason = null): DiscountRelease
{
if (! $code->restricted()) {
throw new DomainRuleException('Dieser Code ist allgemein einlösbar. Freigaben gibt es nur für Codes mit beschränkter Einlösung.');
}
if ($member->party_id === null) {
throw new DomainRuleException('Nur ein Mitgliedskonto kann für einen Code freigeschaltet werden.');
}
return DB::transaction(function () use ($code, $member, $actor, $until, $reason): DiscountRelease {
DiscountCode::query()->whereKey($code->id)->lockForUpdate()->firstOrFail();
if ($this->activeRelease($code, $member) !== null) {
throw new DomainRuleException('Dieses Konto ist für den Code bereits freigeschaltet.');
}
if ($until !== null && $until->lessThanOrEqualTo(now())) {
throw new DomainRuleException('Das Ende der Freigabe liegt in der Vergangenheit.');
}
return DiscountRelease::query()->create([
'discount_code_id' => $code->id,
'user_id' => $member->id,
'granted_by' => $actor?->id,
'granted_at' => now(),
'valid_until' => $until,
'reason' => filled($reason) ? trim((string) $reason) : null,
]);
});
}
/**
* Entzieht die Freigabe. Sie bleibt mit Zeitpunkt, Person und Begründung gespeichert.
*/
public function revoke(DiscountRelease $release, ?User $actor, ?string $reason = null): DiscountRelease
{
return DB::transaction(function () use ($release, $actor, $reason): DiscountRelease {
$release = DiscountRelease::query()->lockForUpdate()->findOrFail($release->id);
if ($release->revoked_at !== null) {
throw new DomainRuleException('Diese Freigabe ist bereits entzogen.');
}
$release->revoked_at = now();
$release->revoked_by = $actor?->id;
$release->reason = filled($reason) ? trim((string) $reason) : $release->reason;
$release->save();
return $release;
});
}
/**
* @param list<array{type: string, id: int}> $targets
* @return list<array{type: string, id: int}>
*/
private function cleanTargets(array $targets): array
{
$clean = [];
foreach ($targets as $target) {
$type = (string) ($target['type'] ?? '');
$id = (int) ($target['id'] ?? 0);
$exists = match ($type) {
DiscountCode::TARGET_OFFER => Offer::query()->whereKey($id)->exists(),
DiscountCode::TARGET_ARTICLE => LicenseArticle::query()->whereKey($id)->exists(),
DiscountCode::TARGET_BUNDLE => Bundle::query()->whereKey($id)->exists(),
default => false,
};
if (! $exists) {
throw new DomainRuleException('Ein gewähltes Ziel des Codes gibt es nicht (mehr).');
}
$clean[$type.':'.$id] = ['type' => $type, 'id' => $id];
}
return array_values($clean);
}
/** Ein Datum ohne Uhrzeit gilt als Tag: ab Tagesbeginn, als Ende einschließlich des ganzen Tages. */
private function date(mixed $value, bool $endOfDay = false): ?CarbonInterface
{
if (! filled($value)) {
return null;
}
$date = Carbon::parse((string) $value, config('app.timezone'));
return $endOfDay && strlen(trim((string) $value)) <= 10 ? $date->endOfDay() : $date;
}
}
+31
View File
@@ -17,8 +17,39 @@ class Order extends Model
'holder_kind',
'total_cents',
'currency',
'subtotal_cents',
'discount_cents',
'discount_code_id',
'discount_snapshot',
'payment_method',
'terms_accepted_at',
'terms_snapshot',
'withdrawal_requested_at',
'withdrawal_note',
];
protected function casts(): array
{
return [
'discount_snapshot' => 'array',
'terms_snapshot' => 'array',
'terms_accepted_at' => 'datetime',
'withdrawal_requested_at' => 'datetime',
];
}
/** Listenpreise vor Rabatt; bei älteren Bestellungen die Summe der Positionen. */
public function subtotal(): int
{
return (int) ($this->subtotal_cents ?? $this->total_cents ?? $this->lines->sum('price_cents'));
}
/** Endgültiger Zahlbetrag. */
public function payable(): int
{
return (int) ($this->total_cents ?? $this->lines->sum('price_cents'));
}
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
+9
View File
@@ -22,8 +22,17 @@ class OrderLine extends Model
'tax_class',
'grant_kind',
'holder_party_id',
'licence_scope',
'trainer_count',
'discount_cents',
];
/** Preis dieser Position nach Rabatt. */
public function payable(): int
{
return (int) $this->price_cents - (int) $this->discount_cents;
}
public function order(): BelongsTo
{
return $this->belongsTo(Order::class);
+12
View File
@@ -2,6 +2,7 @@
namespace App\Domain\Commerce;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Entitlement\Grant;
use App\Domain\Entitlement\GrantStatus;
@@ -27,12 +28,23 @@ public function covers(Party $holder, OfferVersion $version): bool
$byAcquisition = Grant::query()
->where('status', GrantStatus::Aktiv)
->whereHas('acquisition', fn ($query) => $query->where('party_id', $holder->id))
->with('acquisition')
->get()
->filter(fn (Grant $grant): bool => ($grant->valid_from === null || ! $grant->valid_from->greaterThan($now))
&& ($grant->valid_until === null || $grant->valid_until->greaterThan($now)))
->groupBy('acquisition_id');
$wanted = LicenceScope::key($version->licence_scope, $version->trainer_count);
foreach ($byAcquisition as $grants) {
$conditions = (array) ($grants->first()->acquisition?->conditions ?? []);
// Gleicher Umfang heißt auch gleicher Nutzerkreis: Eine Einzellizenz deckt keine Mehrfachlizenz ab und
// umgekehrt (der Nutzerkreis wird nicht aus Zweck oder Preis abgeleitet).
if (LicenceScope::key($conditions['licence_scope'] ?? null, isset($conditions['trainer_count']) ? (int) $conditions['trainer_count'] : null) !== $wanted) {
continue;
}
$have = [];
foreach ($grants as $grant) {
+3
View File
@@ -12,6 +12,9 @@ class Payment extends Model
'provider',
'status',
'provider_reference',
'provider_payment_ref',
'amount_cents',
'confirmed_by',
];
public function order(): BelongsTo
+125
View File
@@ -2,8 +2,10 @@
namespace App\Domain\Commerce;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\EditorialProfileReader;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -37,6 +39,125 @@ public function forComposition(Composition $composition): array
return $options;
}
/**
* Kaufbare Optionen der eigenen Produktseite eines Pakets: Angebote mit eigener Paketseite, deren aktive Fassung
* dieses Paket verkauft.
*
* @return list<array<string, mixed>>
*/
public function forBundle(Bundle $bundle): array
{
$options = [];
foreach (Offer::query()->where('standalone_bundle', true)->orderBy('id')->get() as $offer) {
$version = $this->offers->purchasableVersion($offer);
if ($version !== null && $this->bundleOf($version)?->id === $bundle->id) {
$options[] = $this->describe($offer, $version);
}
}
return $options;
}
/**
* Das Paket, das die Fassung unmittelbar verkauft (erste Paketposition), sonst null.
*/
public function bundleOf(OfferVersion $version): ?Bundle
{
$version->loadMissing('lines.bundleVersion.bundle');
return $version->lines->first(fn ($line): bool => $line->bundleVersion !== null)?->bundleVersion?->bundle;
}
/** Gruppenschlüssel der Alternativen: Produktseite eines Programms oder eigene Paketseite. */
public function groupKey(Offer $offer): ?string
{
if ($offer->composition_id !== null) {
return 'c:'.$offer->composition_id;
}
if ($offer->standalone_bundle) {
$version = $this->offers->purchasableVersion($offer) ?? $offer->versions()->orderByDesc('number')->first();
$bundle = $version === null ? null : $this->bundleOf($version);
return $bundle === null ? null : 'b:'.$bundle->id;
}
return null;
}
/** Adresse der Produktseite, auf der die Option angeboten wird, sonst null. */
public function pageUrl(Offer $offer): ?string
{
if ($offer->composition_id !== null) {
return route('public.program', $offer->composition_id);
}
$key = $this->groupKey($offer);
return $key !== null && str_starts_with($key, 'b:') ? route('public.package', (int) substr($key, 2)) : null;
}
/**
* Pakete mit eigener Produktseite und kaufbarer Option: Paketkennung => günstigster Preis und Zahl der Optionen.
*
* @return array<int, array{from_cents: int, count: int}>
*/
public function bundleSummaries(): array
{
$summary = [];
foreach (Offer::query()->where('standalone_bundle', true)->orderBy('id')->get() as $offer) {
$version = $this->offers->purchasableVersion($offer);
$bundle = $version === null ? null : $this->bundleOf($version);
if ($bundle === null) {
continue;
}
$current = $summary[$bundle->id] ?? ['from_cents' => PHP_INT_MAX, 'count' => 0];
$summary[$bundle->id] = [
'from_cents' => min($current['from_cents'], (int) $version->price_cents),
'count' => $current['count'] + 1,
];
}
return $summary;
}
/**
* Der tatsächliche Umfang einer Paketseite: die Artikel aller Optionen ohne Doppelte, in der Reihenfolge der
* Optionen, mit Name und Kurzbeschreibung aus der Redaktion.
*
* @param list<array<string, mixed>> $options
* @return list<array{title: string, teaser: string}>
*/
public function bundleContents(array $options): array
{
$contents = [];
foreach ($options as $option) {
$option['version']->loadMissing('resolvedScopes.article');
foreach ($option['version']->resolvedScopes as $item) {
$article = $item->article;
if ($article === null || isset($contents[$article->id])) {
continue;
}
$profile = app(EditorialProfileReader::class)->read($article, 'detail');
$contents[$article->id] = [
'title' => $this->articleTitle($article),
'teaser' => trim((string) ($profile->value('teaser') ?? '')),
];
}
}
return array_values($contents);
}
/**
* Zeilen für Shop-Suche und Kacheln: je Komposition die günstigste Option.
*
@@ -89,6 +210,10 @@ public function describe(Offer $offer, OfferVersion $version): array
'for' => $version->holder_kind === 'organisation' ? 'Organisationen und Vereine' : 'Privatpersonen',
'holder_kind' => $version->holder_kind,
'term' => self::termLabel($version),
'licence' => LicenceScope::label($version->licence_scope, $version->trainer_count),
'licence_scope' => $version->licence_scope,
'trainer_count' => $version->trainer_count,
'licence_note' => LicenceScope::explanation($version->licence_scope, $version->trainer_count),
'scope' => $scope,
];
}
+127
View File
@@ -0,0 +1,127 @@
<?php
namespace App\Domain\Commerce;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Cms\Page;
/**
* Pflichtangaben und Zustimmungen im Bestellablauf (Verkaufsstart Deutschland, PAY-005, PAY-009).
*
* Die finalen Rechtstexte (AGB, Lizenzbedingungen, Widerrufsbelehrung, Impressum, Datenschutz) liegen als Seiten im
* CMS und werden hier nur verlinkt. Der Wortlaut der Zustimmungen unten ist ein ENTWURF zur Prüfung durch die
* Rechtsberatung. Er ist nicht rechtlich freigegeben; `VERSION` hält fest, welcher Wortlaut galt, damit die Zustimmung
* je Bestellung nachvollziehbar bleibt.
*/
final class SalesTerms
{
public const VERSION = '2026-11-24-entwurf';
/** Schaltfläche zum verbindlichen Abschluss (Button-Lösung, § 312j Abs. 3 BGB). */
public const ORDER_BUTTON = 'Zahlungspflichtig bestellen';
public const ORDER_BUTTON_INVOICE = 'Zahlungspflichtig auf Rechnung bestellen';
/**
* Seiten der Rechtstexte: Schlüssel => Bezeichnung und mögliche Pfade im CMS (erste veröffentlichte Seite gilt).
*
* @return array<string, array{label: string, paths: list<string>, required: bool}>
*/
public static function pages(): array
{
return [
'agb' => ['label' => 'Allgemeine Geschäftsbedingungen', 'paths' => ['/agb'], 'required' => true],
'lizenz' => ['label' => 'Lizenzbedingungen', 'paths' => ['/lizenzbedingungen', '/lizenz'], 'required' => true],
'widerruf' => ['label' => 'Widerrufsbelehrung', 'paths' => ['/widerruf', '/widerrufsbelehrung'], 'required' => true],
'impressum' => ['label' => 'Impressum', 'paths' => ['/impressum'], 'required' => true],
'datenschutz' => ['label' => 'Datenschutzerklärung', 'paths' => ['/datenschutz'], 'required' => true],
];
}
/**
* Veröffentlichte Seite des Rechtstextes oder null.
*/
public static function page(string $key): ?Page
{
$definition = self::pages()[$key] ?? null;
if ($definition === null) {
return null;
}
return Page::query()
->whereIn('path', $definition['paths'])
->whereNotNull('published_revision_id')
->orderBy('id')
->first();
}
public static function url(string $key): ?string
{
return self::page($key)?->publicUrl();
}
/**
* Fehlende oder unveröffentlichte Rechtstexte (Schlüssel => Bezeichnung).
*
* @return array<string, string>
*/
public static function missingPages(): array
{
$missing = [];
foreach (self::pages() as $key => $definition) {
if ($definition['required'] && self::page($key) === null) {
$missing[$key] = $definition['label'];
}
}
return $missing;
}
/**
* Zustimmungen im Checkout: Schlüssel => Wortlaut (ENTWURF).
*
* @return array<string, string>
*/
public static function consents(): array
{
return [
'agb' => 'Ich habe die Allgemeinen Geschäftsbedingungen und die Lizenzbedingungen gelesen und stimme ihnen zu.',
'sofort' => 'Ich verlange ausdrücklich, dass mit der Ausführung des Vertrags vor Ablauf der Widerrufsfrist begonnen wird und die digitalen Inhalte sofort nach Zahlungseingang bereitgestellt werden. Mir ist bekannt, dass ich mein Widerrufsrecht verliere, sobald die Ausführung begonnen hat.',
];
}
/**
* Prüft die Zustimmungen und liefert den Nachweis für die Bestellung (Wortlaut, Fassung, Seiten, Zeit).
*
* @param array<string, mixed> $accepted Schlüssel => angekreuzt
* @return array<string, mixed>
*/
public static function proof(array $accepted): array
{
$texts = [];
foreach (self::consents() as $key => $wording) {
if (empty($accepted[$key])) {
throw new DomainRuleException('Bitte bestätige die Zustimmungen vor dem verbindlichen Abschluss.');
}
$texts[$key] = $wording;
}
$pages = [];
foreach (array_keys(self::pages()) as $key) {
$page = self::page($key);
$pages[$key] = $page === null ? null : ['path' => $page->path, 'revision_id' => $page->published_revision_id];
}
return [
'version' => self::VERSION,
'consents' => $texts,
'pages' => $pages,
'recorded_at' => now()->toIso8601String(),
];
}
}
+41 -7
View File
@@ -3,9 +3,12 @@
namespace App\Domain\Commerce;
/**
* Etappe 1 verwendet ausschließlich Testzahlung und erteilt keine Produktivfreigabe. Der Shop (Warenkorb, Kasse,
* Kopflink) ist deshalb nur aktiv, wenn die Umgebung nicht Produktion ist und der Zahlungstreiber „test“ gilt.
* Dieselbe Bedingung gilt für die Testzahlung der Bestellseite.
* Wann der Shop (Warenkorb, Kasse, Kopflink) aktiv ist.
*
* Test und Sandbox: nicht in Produktion, Zahlungstreiber „test“ oder „stripe“ (Testschlüssel).
* Produktion: nur mit der ausdrücklichen Produktivfreigabe (`SHOP_LIVE_RELEASE`, Entscheidung von Lars), dem
* Zahlungstreiber „stripe“ mit Live-Schlüssel und veröffentlichten Rechtstexten. Fehlt eines davon, bleibt der Shop in
* Produktion abgeschaltet. Die Freigabe ist standardmäßig aus.
*/
final class Shop
{
@@ -14,14 +17,45 @@ public static function driver(): string
return (string) config('services.payment.driver');
}
public static function enabled(): bool
/** Produktivbetrieb ist freigegeben und vollständig vorbereitet (Freigabe, Live-Schlüssel, Rechtstexte). */
public static function live(): bool
{
return ! app()->isProduction() && in_array(self::driver(), ['test', 'stripe'], true);
return app()->isProduction()
&& config('shop.live_release') === true
&& self::driver() === 'stripe'
&& self::liveKey()
&& SalesTerms::missingPages() === [];
}
/** Stripe-Kasse (Etappe 1: nur Testmodus, nie in Produktion). */
public static function enabled(): bool
{
if (app()->isProduction()) {
return self::live();
}
return in_array(self::driver(), ['test', 'stripe'], true);
}
/** Stripe-Kasse: im Test nur mit Testschlüsseln, in Produktion nur nach der Produktivfreigabe. */
public static function stripe(): bool
{
return ! app()->isProduction() && self::driver() === 'stripe';
if (app()->isProduction()) {
return self::live();
}
return self::driver() === 'stripe';
}
/** Kauf auf Rechnung für Organisationen (manuelle Rechnung, Zahlungseingang durch den Betreiber). */
public static function invoice(): bool
{
return self::enabled() && (bool) config('shop.invoice', true);
}
private static function liveKey(): bool
{
$secret = (string) config('services.stripe.secret');
return str_starts_with($secret, 'sk_live_') || str_starts_with($secret, 'rk_live_');
}
}
+66 -13
View File
@@ -3,7 +3,10 @@
namespace App\Domain\Commerce\Stripe;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\Payment;
use App\Domain\Commerce\Shop;
use Illuminate\Http\Client\ConnectionException;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Http\Client\Response;
@@ -11,9 +14,11 @@
use Illuminate\Support\Facades\Log;
/**
* Stripe-Kasse (Checkout Session) für die Testzahlung in Etappe 1. Ausschließlich Testschlüssel: Ein Live-Schlüssel
* oder die Produktionsumgebung werden abgewiesen, bevor ein Aufruf an Stripe geht. Bezahlt wird bei Stripe; Kartendaten
* berühren diese Anwendung nie. Die Freischaltung erfolgt allein über die signierte Meldung (StripeWebhook).
* Stripe-Kasse (Checkout Session). Außerhalb der Produktion nur mit Testschlüsseln; ein Live-Schlüssel wird dort
* abgewiesen. In Produktion nur nach der Produktivfreigabe (Shop::live) und nur mit Live-Schlüssel; in jedem anderen
* Fall wird abgewiesen, bevor ein Aufruf an Stripe geht. Bezahlt wird bei Stripe; Kartendaten berühren diese Anwendung
* nie. Die Freischaltung erfolgt allein über die signierte Meldung (StripeWebhook). Der Betrag je Position ist der
* Preis nach Rabatt, damit die Summe bei Stripe genau dem gespeicherten Zahlbetrag der Bestellung entspricht.
*/
class StripeGateway
{
@@ -24,7 +29,7 @@ class StripeGateway
*/
public function checkoutFor(Order $order): array
{
$this->assertSandbox();
$this->assertAllowed();
$order->loadMissing('lines', 'user');
$taxRate = $this->taxRate();
@@ -32,6 +37,10 @@ public function checkoutFor(Order $order): array
throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.');
}
if ($order->payment_method === 'rechnung') {
throw new DomainRuleException('Diese Bestellung wird auf Rechnung bezahlt, nicht bei Stripe.');
}
$open = $this->reusableSession($order);
if ($open !== null) {
@@ -51,12 +60,18 @@ public function checkoutFor(Order $order): array
];
foreach ($order->lines->values() as $index => $line) {
$productData = ['name' => filled($line->offer_name) ? (string) $line->offer_name : 'Lizenz'];
if ((int) $line->discount_cents > 0) {
$productData['description'] = 'Listenpreis '.Money::format((int) $line->price_cents).', Rabatt '.Money::format((int) $line->discount_cents);
}
$params['line_items'][$index] = [
'quantity' => 1,
'price_data' => [
'currency' => strtolower((string) ($line->currency ?? $order->currency ?? 'EUR')),
'unit_amount' => (int) $line->price_cents,
'product_data' => ['name' => filled($line->offer_name) ? (string) $line->offer_name : 'Lizenz'],
'unit_amount' => $line->payable(),
'product_data' => $productData,
],
];
@@ -82,21 +97,59 @@ public function checkoutFor(Order $order): array
return ['id' => $id, 'url' => $url];
}
public function assertSandbox(): void
public function assertAllowed(): void
{
$secret = (string) config('services.stripe.secret');
if (app()->isProduction()) {
throw new DomainRuleException('Stripe ist in Produktion nicht freigegeben.');
}
if ($secret === '') {
throw new DomainRuleException('Stripe ist nicht eingerichtet: Der Schlüssel fehlt.');
}
if (! str_starts_with($secret, 'sk_test_') && ! str_starts_with($secret, 'rk_test_')) {
throw new DomainRuleException('Etappe 1 erlaubt nur den Stripe-Testmodus (Schlüssel sk_test_).');
if (app()->isProduction()) {
if (! Shop::live()) {
throw new DomainRuleException('Stripe ist in Produktion nicht freigegeben.');
}
return;
}
if (! str_starts_with($secret, 'sk_test_') && ! str_starts_with($secret, 'rk_test_')) {
throw new DomainRuleException('Außerhalb der Produktion erlaubt Stripe nur den Testmodus (Schlüssel sk_test_).');
}
}
/**
* Vollerstattung der bezahlten Bestellung bei Stripe. Der Betrag ist der gespeicherte Zahlbetrag. Der
* Idempotenzschlüssel verhindert eine doppelte Rückzahlung bei Wiederholung. Schlägt sie fehl, wird nichts
* entzogen (Aufrufer: Checkout::refund).
*/
public function refund(Order $order, Payment $payment, string $reason): void
{
$this->assertAllowed();
$intent = (string) $payment->provider_payment_ref;
if ($intent === '') {
$session = $this->request()->get('/v1/checkout/sessions/'.$payment->provider_reference);
$this->assertOk($session, 'abgefragt');
$intent = (string) $session->json('payment_intent');
}
if ($intent === '') {
throw new DomainRuleException('Zu dieser Zahlung gibt es bei Stripe keinen Zahlungsvorgang. Erstatte sie im Stripe-Dashboard und prüfe den Fall.');
}
$response = $this->request()
->withHeaders(['Idempotency-Key' => 'luf-refund-'.$order->id.'-'.$payment->id])
->post('/v1/refunds', [
'payment_intent' => $intent,
'amount' => $order->payable(),
'reason' => 'requested_by_customer',
'metadata' => ['order_id' => (string) $order->id, 'grund' => mb_substr($reason, 0, 200)],
]);
$this->assertOk($response, 'erstattet');
$payment->provider_payment_ref = $intent;
$payment->save();
}
/**
+6
View File
@@ -101,6 +101,10 @@ public function issueFromOrderLine(OrderLine $line, Party $holder, User $actor):
'update_promise' => $line->update_promise,
'holder_kind' => $line->holder_kind,
'offer_version_id' => $line->offer_version_id,
'licence_scope' => $line->licence_scope,
'trainer_count' => $line->trainer_count,
'price_cents' => (int) $line->price_cents,
'discount_cents' => (int) $line->discount_cents,
],
]);
@@ -150,6 +154,8 @@ public function issue(
'update_promise' => $version->update_promise,
'holder_kind' => $version->holder_kind,
'offer_version_id' => $version->id,
'licence_scope' => $version->licence_scope,
'trainer_count' => $version->trainer_count,
],
]);
+44
View File
@@ -0,0 +1,44 @@
<?php
namespace App\Domain\Identity;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Rechnungsadresse eines Lizenzinhabers (Person oder Organisation). Eine je Inhaber. Sie wird nur gepflegt;
* eine Bestellung kopiert sie erst, wenn die Rechnungsstellung sie braucht.
*/
class BillingAddress extends Model
{
/** Auswählbare Länder (ISO 3166-1 Alpha-2). */
public const COUNTRIES = [
'DE' => 'Deutschland',
'AT' => 'Österreich',
'CH' => 'Schweiz',
'LI' => 'Liechtenstein',
'LU' => 'Luxemburg',
'BE' => 'Belgien',
'NL' => 'Niederlande',
'FR' => 'Frankreich',
'IT' => 'Italien',
'DK' => 'Dänemark',
'PL' => 'Polen',
'CZ' => 'Tschechien',
];
protected $fillable = [
'party_id',
'recipient',
'line2',
'street',
'postal_code',
'city',
'country',
];
public function party(): BelongsTo
{
return $this->belongsTo(Party::class);
}
}
+5
View File
@@ -25,6 +25,11 @@ public function user(): HasOne
return $this->hasOne(User::class);
}
public function billingAddress(): HasOne
{
return $this->hasOne(BillingAddress::class);
}
public function profile(): HasOne
{
return $this->hasOne(Profile::class);
+107
View File
@@ -0,0 +1,107 @@
<?php
namespace App\Filament\Pages;
use App\Domain\Commerce\SalesTerms;
use App\Domain\Commerce\Shop;
use App\Filament\Support\ShopAccess;
use Filament\Pages\Page;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Facades\DB;
/**
* Verkaufsstart: Was ist bereit, was fehlt noch? Die Seite liest nur. Sie nennt die fehlenden Rechtstexte, den
* Zustand der Zahlungseinrichtung und der Produktivfreigabe, ohne Schlüssel oder Werte zu zeigen. Die Produktivfreigabe
* ist eine Entscheidung von Lars und wird nicht hier, sondern in der Umgebungsdatei des Servers gesetzt.
*/
class Verkaufsstart extends Page
{
protected static string|\UnitEnum|null $navigationGroup = 'Verkauf';
protected static ?string $navigationLabel = 'Verkaufsstart';
protected static ?int $navigationSort = 3;
protected static ?string $slug = 'verkaufsstart';
protected static ?string $title = 'Verkaufsstart';
protected string $view = 'filament.pages.verkaufsstart';
public static function canAccess(): bool
{
return ShopAccess::allowed();
}
public function getHeading(): string|Htmlable|null
{
return null;
}
public function getMaxContentWidth(): Width|string|null
{
return Width::Full;
}
/**
* @return array<string, mixed>
*/
public function daten(): array
{
$legal = [];
foreach (SalesTerms::pages() as $key => $definition) {
$page = SalesTerms::page($key);
$legal[] = [
'text' => $definition['label'],
'neben' => $page === null
? 'Fehlt: Es gibt keine veröffentlichte Seite unter '.implode(' oder ', $definition['paths']).'. Die Seite pflegst du in der Webpräsenz; den Text liefert die Rechtsberatung.'
: 'Veröffentlicht unter '.$page->path.'. Inhalt und Vollständigkeit prüft die Rechtsberatung.',
'zustand' => $page === null ? ['label' => 'Fehlt', 'ton' => 'offen'] : ['label' => 'Veröffentlicht', 'ton' => 'gut'],
];
}
$secret = (string) config('services.stripe.secret');
$mode = match (true) {
$secret === '' => 'nicht eingerichtet',
str_starts_with($secret, 'sk_test_'), str_starts_with($secret, 'rk_test_') => 'Testmodus',
str_starts_with($secret, 'sk_live_'), str_starts_with($secret, 'rk_live_') => 'Live-Schlüssel',
default => 'unbekanntes Format',
};
$withoutScope = DB::table('offer_versions')->where('status', 'aktiv')->where('grant_kind', 'kauf')->whereNull('licence_scope')->count();
$zahlung = [
['text' => 'Zahlungsweg: '.Shop::driver(), 'neben' => 'Test: Testzahlung ohne Anbieter. Stripe: Kasse bei Stripe.', 'zustand' => Shop::driver() === 'stripe' ? ['label' => 'Stripe', 'ton' => 'gut'] : ['label' => 'Test', 'ton' => 'neutral']],
['text' => 'Stripe-Schlüssel: '.$mode, 'neben' => 'Der Schlüssel steht nur in der Umgebungsdatei des Servers und wird hier nie angezeigt.', 'zustand' => $mode === 'nicht eingerichtet' ? ['label' => 'Fehlt', 'ton' => 'offen'] : ['label' => $mode, 'ton' => 'neutral']],
['text' => 'Signaturschlüssel für Stripe-Meldungen: '.(filled(config('services.stripe.webhook_secret')) ? 'gesetzt' : 'fehlt'), 'neben' => 'Ohne ihn weist die Anwendung jede Meldung von Stripe ab; Zahlungen schalten dann nichts frei.', 'zustand' => filled(config('services.stripe.webhook_secret')) ? ['label' => 'Gesetzt', 'ton' => 'gut'] : ['label' => 'Fehlt', 'ton' => 'offen']],
['text' => 'Steuersatz bei Stripe: '.(filled(config('services.stripe.tax_rate')) ? 'hinterlegt' : 'nicht hinterlegt'), 'neben' => 'Steuerstatus und Belegangaben sind noch nicht entschieden (OPEN-06). Ohne sie gibt es keinen Steuerausweis auf der Stripe-Kasse und keine Rechnungsvorlage.', 'zustand' => filled(config('services.stripe.tax_rate')) ? ['label' => 'Hinterlegt', 'ton' => 'gut'] : ['label' => 'Offen', 'ton' => 'offen']],
['text' => 'Kauf auf Rechnung für Vereine: '.(Shop::invoice() ? 'angeboten' : 'aus'), 'neben' => 'Die Rechnung erstellt der Betreiber manuell; den Zahlungseingang bestätigst du in der Bestellverwaltung.', 'zustand' => ['label' => Shop::invoice() ? 'Bereit' : 'Aus', 'ton' => 'neutral']],
];
$freigabe = [
['text' => 'Produktivfreigabe (SHOP_LIVE_RELEASE): '.(config('shop.live_release') === true ? 'gesetzt' : 'nicht gesetzt'), 'neben' => 'Standardmäßig aus. Setzt Lars in der Umgebungsdatei des Servers, wenn er den Verkauf freigibt. Ohne sie bleibt der Shop in Produktion abgeschaltet und Stripe nimmt dort keine Zahlung an.', 'zustand' => config('shop.live_release') === true ? ['label' => 'Gesetzt', 'ton' => 'gut'] : ['label' => 'Aus', 'ton' => 'neutral']],
['text' => 'Umgebung: '.(app()->isProduction() ? 'Produktion' : 'Test oder lokal'), 'neben' => app()->isProduction() ? 'Der Shop ist hier '.(Shop::enabled() ? 'aktiv.' : 'abgeschaltet.') : 'Hier läuft der Shop mit Test- oder Sandbox-Zahlung.', 'zustand' => app()->isProduction() ? (Shop::enabled() ? ['label' => 'Live', 'ton' => 'gut'] : ['label' => 'Abgeschaltet', 'ton' => 'neutral']) : ['label' => 'Test', 'ton' => 'neutral']],
];
$angebote = [
['text' => $withoutScope === 0 ? 'Alle aktiven Käufe haben einen Nutzerkreis.' : $withoutScope.' aktive Kaufangebote ohne festgelegten Nutzerkreis', 'neben' => $withoutScope === 0 ? null : 'Käufer sähen „Nutzerkreis nicht festgelegt“. Lege Einzel- oder Mehrfachlizenz mit „Geänderte Fassung aktivieren“ am Angebot fest.', 'zustand' => $withoutScope === 0 ? ['label' => 'Vollständig', 'ton' => 'gut'] : ['label' => 'Offen', 'ton' => 'offen']],
];
return [
'kopf' => [
'titel' => 'Verkaufsstart',
'typ' => 'Bereitschaft für den Verkauf in Deutschland',
'status' => ['text' => SalesTerms::missingPages() === [] ? 'Alle Rechtstexte sind veröffentlicht. Die rechtliche Freigabe der Inhalte steht aus, bis die Rechtsberatung sie bestätigt.' : 'Es fehlen veröffentlichte Rechtstexte. Ohne sie bleibt der Shop in Produktion abgeschaltet.', 'ton' => SalesTerms::missingPages() === [] ? 'gut' : 'offen'],
],
'haupt' => [
['titel' => 'Rechtstexte im Bestellablauf', 'hilfe' => 'Der Checkout verlinkt diese Seiten und hält mit jeder Bestellung fest, welche Fassung galt. Den Wortlaut der Zustimmungen im Checkout hat der Betreiber noch rechtlich zu prüfen (Entwurf '.SalesTerms::VERSION.').', 'zeilen' => $legal],
['titel' => 'Zahlung und Belege', 'zeilen' => $zahlung],
],
'seite' => [
['titel' => 'Freigabe', 'zeilen' => $freigabe, 'hilfe' => 'Die Produktivfreigabe liegt bei Lars. Sie wird nicht über diese Oberfläche gesetzt.'],
['titel' => 'Angebote', 'zeilen' => $angebote],
],
];
}
}
@@ -0,0 +1,65 @@
<?php
namespace App\Filament\Resources\DiscountCodes;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Filament\Resources\DiscountCodes\Pages\ListDiscountCodes;
use App\Filament\Resources\DiscountCodes\Pages\ViewDiscountCode;
use App\Filament\Support\ShopAccess;
use Filament\Resources\Resource;
use Filament\Schemas\Schema;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use Illuminate\Auth\Access\Response;
use Illuminate\Database\Eloquent\Model;
/**
* Rabattcodes (FACH-14): anlegen, bearbeiten, zeitlich begrenzen, deaktivieren und einzelne Konten freischalten.
* Die Seiten nutzen die gemeinsamen Bausteine (Bestandsliste, Objektseite, Dialoge) wie die übrigen Kataloglisten.
*/
class DiscountCodeResource extends Resource
{
protected static ?string $model = DiscountCode::class;
protected static string|\UnitEnum|null $navigationGroup = 'Verkauf';
protected static ?string $navigationLabel = 'Rabattcodes';
protected static ?string $modelLabel = 'Rabattcode';
protected static ?string $pluralModelLabel = 'Rabattcodes';
protected static ?string $recordTitleAttribute = 'code';
protected static ?int $navigationSort = 2;
public static function canViewAny(): bool
{
return ShopAccess::allowed();
}
public static function getViewAuthorizationResponse(Model $record): Response
{
return ShopAccess::allowed() ? Response::allow() : Response::deny();
}
public static function form(Schema $schema): Schema
{
return $schema;
}
public static function table(Table $table): Table
{
return $table->columns([
TextColumn::make('code')->label('Code')->searchable(),
]);
}
public static function getPages(): array
{
return [
'index' => ListDiscountCodes::route('/'),
'view' => ViewDiscountCode::route('/{record}'),
];
}
}
@@ -0,0 +1,103 @@
<?php
namespace App\Filament\Resources\DiscountCodes\Pages;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Domain\Commerce\Discount\DiscountService;
use App\Filament\Resources\DiscountCodes\DiscountCodeResource;
use App\Filament\Support\DiscountCodeForm;
use App\Filament\Support\ListsCatalog;
use App\Filament\Support\ReportsDomainRules;
use Filament\Actions\Action;
use Filament\Resources\Pages\ListRecords;
use Illuminate\Contracts\Support\Htmlable;
class ListDiscountCodes extends ListRecords
{
use ListsCatalog;
use ReportsDomainRules;
protected static string $resource = DiscountCodeResource::class;
public function getSubheading(): string|Htmlable|null
{
return 'Ein Code gilt für den ganzen Warenkorb oder nur für ausgewählte Ziele, und er ist allgemein einlösbar oder nur für freigeschaltete Konten. Beides stellst du unabhängig voneinander ein. Pro Bestellung gilt höchstens ein Code.';
}
protected function getHeaderActions(): array
{
return [
Action::make('create')->label('Code anlegen')
->modalHeading('Neuer Rabattcode')
->modalDescription('Dieselbe Maske öffnet sich später beim Bearbeiten. Freigaben für einzelne Konten verwaltest du danach auf der Seite des Codes.')
->modalSubmitActionLabel('Code anlegen')
->modalWidth('3xl')
->fillForm(['kind' => DiscountCode::PERCENT, 'scope' => DiscountCode::SCOPE_CART, 'eligibility' => DiscountCode::OPEN, 'active' => true])
->schema(DiscountCodeForm::schema())
->action(function (array $data): void {
$code = null;
$this->report(function () use ($data, &$code): void {
[$fields, $targets] = DiscountCodeForm::fromForm($data);
$code = app(DiscountService::class)->save($fields, $targets);
}, 'Der Rabattcode ist angelegt.');
if ($code instanceof DiscountCode) {
$this->redirect(DiscountCodeResource::getUrl('view', ['record' => $code]));
}
}),
];
}
protected function catalogRows(): array
{
$rows = [];
$now = now();
foreach (DiscountCode::query()->with('targets')->withCount(['releases as active_releases_count' => fn ($query) => $query->whereNull('revoked_at')])->orderByDesc('id')->get() as $code) {
$state = $code->stateAt($now);
$url = DiscountCodeResource::getUrl('view', ['record' => $code]);
$rows[] = [
'schluessel' => 'c'.$code->id,
'titel' => $code->code,
'meta' => 'Rabattcode · '.$code->label,
'text' => $code->valueLabel().' · '.($code->forSelection() ? 'ausgewählte Ziele ('.$code->targets->count().')' : 'gesamter Warenkorb').' · '.($code->restricted() ? 'nur freigeschaltete Konten' : 'allgemein einlösbar'),
'symbol' => 'etikett',
'url' => $url,
'chips' => [
match ($state) {
'aktiv' => ['label' => 'Gültig', 'ton' => 'gut'],
'abgelaufen' => ['label' => 'Abgelaufen', 'ton' => 'leise'],
'noch_nicht' => ['label' => 'Noch nicht gültig', 'ton' => 'offen'],
default => ['label' => 'Deaktiviert', 'ton' => 'leise'],
},
['label' => $code->valueLabel(), 'ton' => 'neutral'],
['label' => $code->restricted() ? $code->active_releases_count.' freigeschaltet' : 'Allgemein', 'ton' => 'neutral'],
],
'zustand' => [$state === 'aktiv' ? 'aktiv' : 'inaktiv'],
'aktionen' => [['label' => 'Öffnen', 'href' => $url]],
];
}
return $rows;
}
protected function zustandOptionen(): array
{
return ['alle' => 'Jeder Zustand', 'aktiv' => 'Gerade gültig', 'inaktiv' => 'Abgelaufen, deaktiviert oder noch nicht gültig'];
}
protected function suchPlatzhalter(): string
{
return 'Code oder Name';
}
protected function einheit(): array
{
return ['Rabattcode', 'Rabattcodes'];
}
protected function leer(): array
{
return ['titel' => 'Noch keine Rabattcodes', 'text' => 'Mit „Code anlegen“ oben entsteht der erste Rabattcode, zum Beispiel der gemeinsame Zertifizierungscode.'];
}
}
@@ -0,0 +1,293 @@
<?php
namespace App\Filament\Resources\DiscountCodes\Pages;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Commerce\Discount\DiscountCode;
use App\Domain\Commerce\Discount\DiscountRelease;
use App\Domain\Commerce\Discount\DiscountService;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\Order;
use App\Filament\Resources\DiscountCodes\DiscountCodeResource;
use App\Filament\Support\DiscountCodeForm;
use App\Filament\Support\ReportsDomainRules;
use App\Models\User;
use Filament\Actions\Action;
use Filament\Forms\Components\DatePicker;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;
use Filament\Resources\Pages\ViewRecord;
use Filament\Schemas\Components\View;
use Filament\Schemas\Schema;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Carbon;
/**
* Rabattcode im gemeinsamen Rahmen. Bearbeiten nutzt dieselbe Maske wie Anlegen. Konten werden für genau diesen Code
* freigeschaltet und die Freigabe wird mit Begründung entzogen; der Verlauf bleibt stehen.
*/
class ViewDiscountCode extends ViewRecord
{
use ReportsDomainRules;
protected static string $resource = DiscountCodeResource::class;
public function getTitle(): string|Htmlable
{
return (string) $this->getRecord()->code;
}
public function getHeading(): string|Htmlable
{
return '';
}
public function getMaxContentWidth(): Width|string|null
{
return Width::Full;
}
protected function getHeaderActions(): array
{
return [];
}
/**
* @return array<string, string>
*/
public function getBreadcrumbs(): array
{
return [];
}
public function infolist(Schema $schema): Schema
{
return $schema->components([
View::make('filament.catalog.objekt')->viewData(fn (): array => $this->codeDaten())->columnSpanFull(),
])->columns(1);
}
private function code(): DiscountCode
{
/** @var DiscountCode $code */
$code = $this->getRecord();
return $code;
}
public function editAction(): Action
{
return Action::make('edit')
->label('Code bearbeiten')
->modalHeading(fn (): string => 'Rabattcode „'.$this->code()->code.'“ bearbeiten')
->modalDescription('Bestellungen, die schon aufgegeben sind, behalten ihren gespeicherten Rabatt. Eine Änderung wirkt auf künftige Einlösungen und auf offene Warenkörbe. „Abbrechen“ verwirft die Eingaben.')
->modalSubmitActionLabel('Änderungen speichern')
->modalWidth('3xl')
->fillForm(fn (): array => DiscountCodeForm::fill($this->code()))
->schema(DiscountCodeForm::schema())
->action(function (array $data): void {
$this->report(function () use ($data): void {
[$fields, $targets] = DiscountCodeForm::fromForm($data);
app(DiscountService::class)->save($fields, $targets, $this->code());
}, 'Der Rabattcode ist gespeichert.');
$this->refreshRecord();
});
}
public function toggleAction(): Action
{
return Action::make('toggle')
->label(fn (): string => $this->code()->active ? 'Code deaktivieren' : 'Code aktivieren')
->color(fn (): string => $this->code()->active ? 'danger' : 'success')
->requiresConfirmation()
->modalHeading(fn (): string => $this->code()->active ? 'Code „'.$this->code()->code.'“ deaktivieren?' : 'Code „'.$this->code()->code.'“ aktivieren?')
->modalDescription(fn (): string => $this->code()->active
? 'Der Code lässt sich danach nicht mehr einlösen. In offenen Warenkörben zeigt die Bestellübersicht den Grund; bereits aufgegebene Bestellungen bleiben unverändert. Freigaben und Einstellungen bleiben erhalten.'
: 'Der Code lässt sich danach wieder einlösen, soweit sein Gültigkeitszeitraum und die Freigaben es zulassen.')
->modalSubmitActionLabel(fn (): string => $this->code()->active ? 'Deaktivieren' : 'Aktivieren')
->action(function (): void {
$code = $this->code();
$this->report(function () use ($code): string {
app(DiscountService::class)->setActive($code, ! $code->active);
return $code->active ? 'Der Code ist aktiviert.' : 'Der Code ist deaktiviert.';
}, 'Gespeichert.');
$this->refreshRecord();
});
}
public function releaseAction(): Action
{
return Action::make('release')
->label('Konto freischalten')
->modalHeading(fn (): string => 'Konto für den Code „'.$this->code()->code.'“ freischalten')
->modalDescription('Das Konto darf genau diesen Code einlösen, solange Code und Freigabe gültig sind, auch bei späteren Bestellungen. Die Freigabe gilt nicht für andere Codes. Prüfe vorher die Zertifizierung des Kontos.')
->modalSubmitActionLabel('Konto freischalten')
->schema([
Select::make('user_id')->label('Mitgliedskonto')->required()->searchable()
->getSearchResultsUsing(fn (string $search): array => $this->searchMembers($search))
->getOptionLabelUsing(fn ($value): ?string => ($user = User::query()->find($value)) === null ? null : $user->name.' ('.$user->email.')')
->helperText('Suche nach Name oder E-Mail-Adresse. Nur Konten mit Mitgliedsprofil.'),
DatePicker::make('valid_until')->label('Freigabe gültig bis einschließlich')->native(false)->displayFormat('d.m.Y')
->helperText('Leer: ohne Ende. Danach gilt der Code für dieses Konto nicht mehr.'),
Textarea::make('reason')->label('Grundlage der Freigabe')->rows(2)->maxLength(500)
->helperText('Zum Beispiel „Zertifikat vom 12.11.2026 geprüft“. Bleibt im Verlauf stehen.'),
])
->visible(fn (): bool => $this->code()->restricted())
->action(function (array $data): void {
$this->report(function () use ($data): string {
$member = User::query()->findOrFail($data['user_id']);
$until = filled($data['valid_until'] ?? null) ? Carbon::parse((string) $data['valid_until'], config('app.timezone'))->endOfDay() : null;
app(DiscountService::class)->release($this->code(), $member, auth('staff')->user() ?? auth()->user(), $until, $data['reason'] ?? null);
return 'Das Konto von '.$member->name.' ist für den Code freigeschaltet.';
}, 'Das Konto ist freigeschaltet.');
$this->refreshRecord();
});
}
public function revokeAction(): Action
{
return Action::make('revoke')
->label('Freigabe entziehen')
->color('danger')
->requiresConfirmation()
->modalHeading('Freigabe entziehen?')
->modalDescription('Das Konto kann diesen Code danach nicht mehr einlösen. Offene Warenkörbe des Kontos zeigen den Grund und lassen sich erst ohne Code bestellen. Aufgegebene Bestellungen bleiben unverändert; die Freigabe bleibt mit dem Entzug im Verlauf stehen.')
->modalSubmitActionLabel('Freigabe entziehen')
->schema([
Textarea::make('reason')->label('Grund')->rows(2)->maxLength(500),
])
->action(function (array $data, array $arguments): void {
$this->report(function () use ($data, $arguments): string {
$release = DiscountRelease::query()->where('discount_code_id', $this->code()->id)->findOrFail((int) ($arguments['release'] ?? 0));
app(DiscountService::class)->revoke($release, auth('staff')->user() ?? auth()->user(), $data['reason'] ?? null);
return 'Die Freigabe ist entzogen.';
}, 'Die Freigabe ist entzogen.');
$this->refreshRecord();
});
}
private function refreshRecord(): void
{
$this->getRecord()->unsetRelations();
$this->getRecord()->refresh();
}
/**
* @return array<int, string>
*/
private function searchMembers(string $search): array
{
$like = '%'.mb_strtolower(trim($search)).'%';
return User::query()
->whereNotNull('party_id')
->where(fn ($query) => $query->whereRaw('LOWER(name) LIKE ?', [$like])->orWhereRaw('LOWER(email) LIKE ?', [$like]))
->orderBy('name')
->limit(20)
->get()
->mapWithKeys(fn (User $user): array => [$user->id => $user->name.' ('.$user->email.')'])
->all();
}
/**
* @return array<string, mixed>
*/
private function codeDaten(): array
{
$code = $this->code();
$code->loadMissing('targets');
$state = $code->stateAt(now());
$date = fn (?Carbon $value): string => $value === null ? '' : $value->timezone(config('app.timezone'))->format('d.m.Y');
$targets = [];
foreach ($code->targets as $target) {
$targets[] = match ($target->target_type) {
DiscountCode::TARGET_OFFER => 'Angebot „'.(Offer::query()->find($target->target_id)?->name ?? 'gelöscht').'“',
DiscountCode::TARGET_ARTICLE => 'Lizenzartikel '.(LicenseArticle::query()->find($target->target_id)?->code ?? 'gelöscht'),
DiscountCode::TARGET_BUNDLE => 'Paket „'.(Bundle::query()->find($target->target_id)?->name ?? 'gelöscht').'“',
default => 'Ziel',
};
}
$releases = $code->releases()->with(['user', 'grantor'])->get();
$active = $releases->filter(fn (DiscountRelease $release): bool => $release->revoked_at === null);
$past = $releases->filter(fn (DiscountRelease $release): bool => $release->revoked_at !== null);
$orders = Order::query()->where('discount_code_id', $code->id)->with('user')->latest('id')->limit(10)->get();
$paid = Order::query()->where('discount_code_id', $code->id)->where('status', 'bezahlt')->count();
return [
'kopf' => [
'brot' => [['label' => 'Rabattcodes', 'href' => DiscountCodeResource::getUrl('index')], $code->code],
'titel' => $code->code,
'typ' => 'Rabattcode · '.$code->label,
'status' => match ($state) {
'aktiv' => ['text' => 'Gerade gültig'.($code->valid_until ? ' bis einschließlich '.$date($code->valid_until) : ''), 'ton' => 'gut'],
'abgelaufen' => ['text' => 'Abgelaufen am '.$date($code->valid_until).'. Der Code lässt sich nicht mehr einlösen.', 'ton' => 'offen'],
'noch_nicht' => ['text' => 'Gilt erst ab dem '.$date($code->valid_from).'.', 'ton' => 'offen'],
default => ['text' => 'Deaktiviert. Der Code lässt sich nicht einlösen.', 'ton' => 'offen'],
},
'aktionen' => [
['label' => 'Code bearbeiten', 'wire' => "mountAction('edit')", 'art' => 'primary'],
...($code->restricted() ? [['label' => 'Konto freischalten', 'wire' => "mountAction('release')", 'art' => 'line']] : []),
['label' => $code->active ? 'Code deaktivieren' : 'Code aktivieren', 'wire' => "mountAction('toggle')", 'art' => 'line'],
],
],
'haupt' => [
[
'titel' => 'Der Code auf einen Blick',
'hilfe' => 'Geltungsbereich und Einlösungsberechtigung sind zwei getrennte Einstellungen. Der Rabatt ändert den Preis, nie den Nutzungsumfang.',
'zeilen' => [
['text' => 'Rabatt: '.$code->valueLabel(), 'neben' => $code->kind === DiscountCode::PERCENT ? 'Je Position gerundet.' : 'Je Bestellung, anteilig auf die betroffenen Positionen verteilt.'],
['text' => 'Geltungsbereich: '.($code->forSelection() ? 'nur ausgewählte Ziele' : 'gesamter Warenkorb'), 'neben' => $code->forSelection() ? 'Ein Paket ist ein eigenes Ziel und folgt nicht aus einem enthaltenen Artikel.' : null],
...array_map(fn (string $target): array => ['text' => '· '.$target, 'neben' => null], $targets),
['text' => 'Einlösung: '.($code->restricted() ? 'nur freigeschaltete Konten' : 'allgemein, für alle angemeldeten Käufer'), 'neben' => 'Pro Bestellung gilt höchstens ein Code.'],
['text' => 'Gültigkeit: '.($code->valid_from ? 'ab '.$date($code->valid_from) : 'sofort').($code->valid_until ? ' bis einschließlich '.$date($code->valid_until) : ', unbegrenzt'), 'neben' => $code->active ? 'Aktiv' : 'Deaktiviert'],
...(filled($code->note) ? [['text' => 'Notiz: '.$code->note, 'neben' => null]] : []),
],
],
[
'titel' => $code->restricted() ? 'Freigeschaltete Konten' : 'Freigaben',
'zusatz' => $code->restricted() ? $active->count().' aktiv' : null,
'hilfe' => $code->restricted()
? 'Nur diese Konten können den Code einlösen. Die Freigabe gilt nur für diesen Code und wiederholt, solange Code und Freigabe gültig sind.'
: 'Der Code ist allgemein einlösbar. Freigaben sind nicht nötig. Stelle „Einlösung“ auf freigeschaltete Konten, um den Code zu beschränken.',
'zeilen' => $code->restricted() ? $active->map(fn (DiscountRelease $release): array => [
'text' => ($release->user?->name ?? 'Konto').' ('.($release->user?->email ?? '').')',
'neben' => 'freigeschaltet am '.$date($release->granted_at).($release->grantor ? ' von '.$release->grantor->name : '').($release->valid_until ? ', gültig bis einschließlich '.$date($release->valid_until) : '').(filled($release->reason) ? ' · '.$release->reason : ''),
'aktion' => ['label' => 'Entziehen', 'wire' => "mountAction('revoke', { release: ".$release->id.' })'],
])->values()->all() : [],
'leer' => ['titel' => $code->restricted() ? 'Noch kein Konto freigeschaltet' : 'Keine Freigaben nötig', 'text' => $code->restricted() ? 'Mit „Konto freischalten“ oben gibst du ein Konto für diesen Code frei, zum Beispiel nach der Prüfung eines Zertifikats.' : 'Jeder angemeldete Käufer kann den Code einlösen.'],
],
],
'seite' => [
[
'titel' => 'Verwendung',
'zeilen' => $orders->map(fn (Order $order): array => [
'text' => 'Bestellung '.$order->id.' · −'.Money::format((int) $order->discount_cents),
'zustand' => ['label' => match ($order->status) {
'bezahlt' => 'Bezahlt', 'erstattet' => 'Erstattet', 'fehlgeschlagen' => 'Fehlgeschlagen', default => 'Offen'
}, 'ton' => $order->status === 'bezahlt' ? 'gut' : 'leise'],
'neben' => ($order->user?->name ?? '').' · '.$date($order->created_at),
])->all(),
'leer' => 'Der Code wurde noch in keiner Bestellung verwendet.',
'hilfe' => $orders->isEmpty() ? null : $paid.' bezahlte Bestellung'.($paid === 1 ? '' : 'en').' mit diesem Code. Gezeigt werden die letzten zehn.',
],
[
'titel' => 'Entzogene Freigaben',
'zeilen' => $past->map(fn (DiscountRelease $release): array => [
'text' => ($release->user?->name ?? 'Konto'),
'neben' => 'entzogen am '.$date($release->revoked_at).(filled($release->reason) ? ' · '.$release->reason : ''),
])->values()->all(),
'leer' => 'Keine Freigabe wurde entzogen.',
'hilfe' => 'Der Verlauf bleibt erhalten.',
],
],
];
}
}
@@ -7,6 +7,7 @@
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionVersion;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -45,6 +46,9 @@ class ViewOffer extends ViewRecord
protected static string $resource = OfferResource::class;
/** Wert der Auswahl „Produktseite“ für ein Paket mit eigener Seite. */
private const OWN_BUNDLE_PAGE = '__paket';
public function getTitle(): string|Htmlable
{
return (string) $this->getRecord()->name;
@@ -120,6 +124,16 @@ public function activateAction(): Action
'organisation' => 'Organisationen und Vereine',
])->required()
->helperText('Wähle die Eignung passend zu den Rechten: Organisationslizenzen brauchen institutionelle Rechte. Das System erzwingt diese Kopplung nicht.'),
Select::make('licence_scope')->label('Nutzerkreis')
->options(LicenceScope::options())
->required()
->live()
->helperText('Wie viele Trainer die Inhalte einsetzen dürfen. Das ist unabhängig vom Lizenzinhaber (Person oder Verein), vom Nutzungszweck der Rechte und vom Preis; es wird aus keinem davon abgeleitet. Der Download bleibt zum Start beim bestellenden Konto. Der Wert wird mit der Bestellung festgehalten.'),
TextInput::make('trainer_count')->label('Anzahl Trainer')
->numeric()->minValue(2)->maxValue(LicenceScope::MAX_TRAINERS)->integer()
->required(fn (Get $get): bool => $get('licence_scope') === LicenceScope::MULTI)
->visible(fn (Get $get): bool => $get('licence_scope') === LicenceScope::MULTI)
->helperText('Höchstzahl der Trainer, die die Inhalte einsetzen dürfen, mindestens 2. Eine Einzellizenz gilt immer für genau einen Trainer.'),
Select::make('grant_kind')->label('Vergabe')->options([
'kauf' => 'Kauf',
'auf_abruf' => 'Auf Abruf',
@@ -201,13 +215,16 @@ public function activateAction(): Action
$version = DB::transaction(function () use ($service, $offer, $data, $lines, $kept, $price) {
$service->assignProduct(
$offer,
filled($data['composition_id'] ?? null) ? (int) $data['composition_id'] : null,
filled($data['composition_id'] ?? null) && $data['composition_id'] !== self::OWN_BUNDLE_PAGE ? (int) $data['composition_id'] : null,
$data['option_label'] ?? null,
($data['composition_id'] ?? null) === self::OWN_BUNDLE_PAGE,
);
return $service->activate($offer, $lines, [
...$kept,
'holder_kind' => $data['holder_kind'],
'licence_scope' => $data['licence_scope'] ?? null,
'trainer_count' => $data['trainer_count'] ?? null,
'grant_kind' => $data['grant_kind'],
'price_cents' => $price,
'composition_version_id' => filled($data['composition_version_id'] ?? null) ? (int) $data['composition_version_id'] : null,
@@ -267,7 +284,7 @@ private function productPages(): array
{
$catalog = app(PublicCatalogReader::class);
return Composition::query()
return [self::OWN_BUNDLE_PAGE => 'Eigene Paketseite · zeigt den Umfang des Pakets (nur für ein Angebot aus genau einer Paketfassung)'] + Composition::query()
->with('editorialContentKind')
->whereNull('archived_at')
->orderBy('designation')
@@ -291,15 +308,17 @@ private function formFromActive(): array
$active = $this->activeVersion();
/** @var Offer $offer */
$offer = $this->getRecord();
$option = ['option_label' => $offer->option_label, 'composition_id' => $offer->composition_id];
$option = ['option_label' => $offer->option_label, 'composition_id' => $offer->standalone_bundle ? self::OWN_BUNDLE_PAGE : $offer->composition_id];
if ($active === null) {
return [...$option, 'holder_kind' => 'person', 'grant_kind' => 'kauf', 'lines' => [['kind' => 'article']]];
return [...$option, 'holder_kind' => 'person', 'licence_scope' => LicenceScope::SINGLE, 'grant_kind' => 'kauf', 'lines' => [['kind' => 'article']]];
}
return [
...$option,
'holder_kind' => $active->holder_kind,
'licence_scope' => $active->licence_scope,
'trainer_count' => $active->trainer_count,
'grant_kind' => $active->grant_kind,
'price_euro' => $active->price_cents === null ? null : number_format($active->price_cents / 100, 2, ',', ''),
'lines' => $active->lines->sortBy('position')->map(fn ($line): array => [
@@ -400,6 +419,7 @@ private function optionAbschnitt(Offer $offer, OfferVersion $active): array
->unique()
->implode('; ');
$seite = $offer->composition;
$eigeneSeite = $offer->standalone_bundle;
$kaufbar = app(OfferService::class)->purchasableVersion($offer) !== null;
return [
@@ -409,10 +429,11 @@ private function optionAbschnitt(Offer $offer, OfferVersion $active): array
'zeilen' => [
['text' => 'Preis: '.$option['price'], 'neben' => $active->grant_kind === 'kauf' ? 'Kauf mit Testzahlung' : CatalogLabels::vergabe($active)],
['text' => 'Geeignet für: '.$option['for'], 'neben' => $option['term']],
['text' => 'Nutzerkreis: '.$option['licence'], 'neben' => $option['licence_scope'] === null ? 'Mit „Geänderte Fassung aktivieren“ festlegen.' : 'Lizenzinhaber, Nutzerkreis und Downloadkonto sind getrennte Angaben.'],
['text' => 'Rechte: '.($rechte !== '' ? $rechte : 'keine'), 'neben' => null],
['text' => 'Zugrunde liegender Inhalt: '.($inhalt !== '' ? $inhalt : '–'), 'neben' => null],
['text' => 'Status: '.($kaufbar ? 'Öffentlich kaufbar' : 'Nicht als Kauf angeboten'), 'neben' => $kaufbar ? 'Aktive Fassung '.$active->number : null],
['text' => 'Produktseite: '.($seite !== null ? ($seite->display_title ?: $seite->designation) : 'noch nicht zugeordnet'), 'neben' => $seite !== null ? 'Option „'.$offer->optionName().'“' : 'Mit „Geänderte Fassung aktivieren“ zuordnen.'],
['text' => 'Produktseite: '.($eigeneSeite ? 'eigene Paketseite mit dem Umfang des Pakets' : ($seite !== null ? ($seite->display_title ?: $seite->designation) : 'noch nicht zugeordnet')), 'neben' => $eigeneSeite || $seite !== null ? 'Option „'.$offer->optionName().'“' : 'Mit „Geänderte Fassung aktivieren“ zuordnen.'],
],
];
}
@@ -0,0 +1,68 @@
<?php
namespace App\Filament\Resources\Orders;
use App\Domain\Commerce\Order;
use App\Filament\Resources\Orders\Pages\ListOrders;
use App\Filament\Resources\Orders\Pages\ViewOrder;
use App\Filament\Support\ShopAccess;
use Filament\Resources\Resource;
use Filament\Schemas\Schema;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use Illuminate\Auth\Access\Response;
use Illuminate\Database\Eloquent\Model;
/**
* Bestellverwaltung (PAY-006): Bestellungen lesen, bei Kauf auf Rechnung den Zahlungseingang bestätigen und
* bezahlte Bestellungen vollständig erstatten. Es gibt keine Bearbeitung der gespeicherten Konditionen.
*/
class OrderResource extends Resource
{
protected static ?string $model = Order::class;
protected static string|\UnitEnum|null $navigationGroup = 'Verkauf';
protected static ?string $navigationLabel = 'Bestellungen';
protected static ?string $modelLabel = 'Bestellung';
protected static ?string $pluralModelLabel = 'Bestellungen';
protected static ?int $navigationSort = 1;
public static function canViewAny(): bool
{
return ShopAccess::allowed();
}
public static function canCreate(): bool
{
return false;
}
public static function getViewAuthorizationResponse(Model $record): Response
{
return ShopAccess::allowed() ? Response::allow() : Response::deny();
}
public static function form(Schema $schema): Schema
{
return $schema;
}
public static function table(Table $table): Table
{
return $table->columns([
TextColumn::make('id')->label('Bestellung'),
]);
}
public static function getPages(): array
{
return [
'index' => ListOrders::route('/'),
'view' => ViewOrder::route('/{record}'),
];
}
}
@@ -0,0 +1,104 @@
<?php
namespace App\Filament\Resources\Orders\Pages;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\Order;
use App\Filament\Resources\Orders\OrderResource;
use App\Filament\Support\ListsCatalog;
use Filament\Resources\Pages\ListRecords;
use Illuminate\Contracts\Support\Htmlable;
class ListOrders extends ListRecords
{
use ListsCatalog;
protected static string $resource = OrderResource::class;
public function getSubheading(): string|Htmlable|null
{
return 'Bestellungen mit Lizenzinhaber, Zahlungsweg und Zahlbetrag. Bei Kauf auf Rechnung bestätigst du hier den Zahlungseingang; bezahlte Bestellungen erstattest du vollständig.';
}
protected function getHeaderActions(): array
{
return [];
}
protected function catalogRows(): array
{
$rows = [];
foreach (Order::query()->with(['lines', 'user', 'party'])->orderByDesc('id')->limit(300)->get() as $order) {
$url = OrderResource::getUrl('view', ['record' => $order]);
$zustand = [$order->status];
$chips = [
match ($order->status) {
'bezahlt' => ['label' => 'Bezahlt', 'ton' => 'gut'],
'erstattet' => ['label' => 'Erstattet', 'ton' => 'leise'],
'fehlgeschlagen' => ['label' => 'Fehlgeschlagen', 'ton' => 'leise'],
default => ['label' => $order->payment_method === 'rechnung' ? 'Offen: wartet auf Zahlungseingang' : 'Offen', 'ton' => 'offen'],
},
['label' => match ($order->payment_method) {
'rechnung' => 'Rechnung', 'stripe' => 'Stripe', default => 'Testzahlung'
}, 'ton' => 'neutral'],
['label' => Money::format($order->payable()), 'ton' => 'neutral'],
];
if ($order->discount_cents > 0) {
$chips[] = ['label' => 'Rabatt '.($order->discount_snapshot['code'] ?? ''), 'ton' => 'neutral'];
}
if ($order->withdrawal_requested_at !== null) {
$chips[] = ['label' => 'Widerruf erklärt', 'ton' => 'offen'];
$zustand[] = 'widerruf';
}
if ($order->payment_method === 'rechnung' && $order->status === 'offen') {
$zustand[] = 'rechnung_offen';
}
$rows[] = [
'schluessel' => 'o'.$order->id,
'titel' => 'Bestellung '.$order->id,
'meta' => ($order->party?->display_name ?? '–').' · bestellt von '.($order->user?->name ?? '–'),
'text' => $order->lines->pluck('offer_name')->implode('; '),
'suchtext' => (string) ($order->user?->email ?? ''),
'symbol' => 'etikett',
'url' => $url,
'chips' => $chips,
'zustand' => $zustand,
'aktionen' => [['label' => 'Öffnen', 'href' => $url]],
];
}
return $rows;
}
protected function zustandOptionen(): array
{
return [
'alle' => 'Jeder Zustand',
'rechnung_offen' => 'Rechnung: wartet auf Zahlungseingang',
'widerruf' => 'Widerruf erklärt',
'offen' => 'Offen',
'bezahlt' => 'Bezahlt',
'erstattet' => 'Erstattet',
];
}
protected function suchPlatzhalter(): string
{
return 'Nummer, Name, E-Mail oder Angebot';
}
protected function einheit(): array
{
return ['Bestellung', 'Bestellungen'];
}
protected function leer(): array
{
return ['titel' => 'Noch keine Bestellungen', 'text' => 'Sobald im Shop bestellt wird, erscheinen die Bestellungen hier.'];
}
}
@@ -0,0 +1,212 @@
<?php
namespace App\Filament\Resources\Orders\Pages;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Commerce\Checkout;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\OrderLine;
use App\Domain\Commerce\Payment;
use App\Filament\Resources\Orders\OrderResource;
use App\Filament\Support\ReportsDomainRules;
use Filament\Actions\Action;
use Filament\Facades\Filament;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Resources\Pages\ViewRecord;
use Filament\Schemas\Components\View;
use Filament\Schemas\Schema;
use Filament\Support\Enums\Width;
use Illuminate\Contracts\Support\Htmlable;
use Illuminate\Support\Carbon;
/**
* Bestellung im gemeinsamen Rahmen. Die gespeicherten Konditionen sind unveränderlich; der Betreiber bestätigt bei
* Kauf auf Rechnung den Zahlungseingang und erstattet bezahlte Bestellungen vollständig (Bundles als Einheit).
*/
class ViewOrder extends ViewRecord
{
use ReportsDomainRules;
protected static string $resource = OrderResource::class;
public function getTitle(): string|Htmlable
{
return 'Bestellung '.$this->order()->id;
}
public function getHeading(): string|Htmlable
{
return '';
}
public function getMaxContentWidth(): Width|string|null
{
return Width::Full;
}
protected function getHeaderActions(): array
{
return [];
}
/**
* @return array<string, string>
*/
public function getBreadcrumbs(): array
{
return [];
}
public function infolist(Schema $schema): Schema
{
return $schema->components([
View::make('filament.catalog.objekt')->viewData(fn (): array => $this->bestellDaten())->columnSpanFull(),
])->columns(1);
}
private function order(): Order
{
/** @var Order $order */
$order = $this->getRecord();
return $order;
}
public function confirmInvoiceAction(): Action
{
return Action::make('confirmInvoice')
->label('Zahlungseingang bestätigen')
->modalHeading(fn (): string => 'Zahlungseingang für Bestellung '.$this->order()->id.' bestätigen')
->modalDescription(fn (): string => 'Du bestätigst, dass '.Money::format($this->order()->payable()).' für die Rechnung eingegangen sind. Die Inhalte werden sofort für das bestellende Konto freigeschaltet; Lizenzinhaber bleibt '.($this->order()->party?->display_name ?? 'der Käufer').'. Die Bestätigung lässt sich nicht zurücknehmen, nur die Bestellung erstatten.')
->modalSubmitActionLabel('Zahlungseingang bestätigen')
->schema([
TextInput::make('reference')->label('Rechnungsnummer oder Buchungsreferenz')->required()->maxLength(120)
->helperText('Bleibt an der Zahlung gespeichert, zum Beispiel „RE-2026-014“.'),
])
->visible(fn (): bool => $this->order()->payment_method === 'rechnung' && $this->order()->status === 'offen')
->action(function (array $data): void {
$this->report(function () use ($data): string {
app(Checkout::class)->confirmInvoicePayment($this->order(), (string) $data['reference'], Filament::auth()->user());
return 'Der Zahlungseingang ist bestätigt. Die Inhalte sind freigeschaltet.';
}, 'Bestätigt.');
$this->order()->unsetRelations();
$this->order()->refresh();
});
}
public function refundAction(): Action
{
return Action::make('refund')
->label('Bestellung erstatten')
->color('danger')
->modalHeading(fn (): string => 'Bestellung '.$this->order()->id.' vollständig erstatten?')
->modalDescription(fn (): string => 'Alle Positionen dieser Bestellung werden zurückgegeben: Die Berechtigungen daraus werden widerrufen, andere Erwerbsquellen (kostenlose Vergabe, frühere Käufe) bleiben unberührt. Pakete sind eine Einheit; Teilerstattungen gibt es zum Start nicht. '.(
$this->order()->payments()->where('provider', 'stripe')->where('status', 'bestaetigt')->exists()
? 'Die Rückzahlung von '.Money::format($this->order()->payable()).' wird bei Stripe veranlasst; nur wenn Stripe sie annimmt, werden die Rechte entzogen.'
: 'Die Rückzahlung selbst veranlasst du außerhalb dieser Anwendung, zum Beispiel per Überweisung.'
))
->modalSubmitActionLabel('Vollständig erstatten')
->schema([
Textarea::make('reason')->label('Begründung')->required()->rows(2)->maxLength(500)
->helperText('Bleibt am Widerruf der Berechtigungen stehen, zum Beispiel „Widerruf geprüft, Frist gewahrt“.'),
])
->visible(fn (): bool => $this->order()->status === 'bezahlt')
->action(function (array $data): void {
$this->report(function () use ($data): string {
app(Checkout::class)->refund($this->order(), (string) $data['reason']);
return 'Die Bestellung ist erstattet. Die Berechtigungen sind widerrufen.';
}, 'Erstattet.');
$this->order()->unsetRelations();
$this->order()->refresh();
});
}
/**
* @return array<string, mixed>
*/
private function bestellDaten(): array
{
$order = $this->order();
$order->loadMissing(['lines', 'user', 'party', 'payments']);
$date = fn (?Carbon $value): string => $value === null ? '' : $value->timezone(config('app.timezone'))->format('d.m.Y H:i');
$method = match ($order->payment_method) {
'rechnung' => 'Überweisung auf Rechnung (manuell)',
'stripe' => 'Stripe',
default => 'Testzahlung',
};
return [
'kopf' => [
'brot' => [['label' => 'Bestellungen', 'href' => OrderResource::getUrl('index')], 'Bestellung '.$order->id],
'titel' => 'Bestellung '.$order->id,
'typ' => 'Lizenzinhaber: '.($order->party?->display_name ?? '–').' · bestellt von '.($order->user?->name ?? '–').' ('.($order->user?->email ?? '').')',
'status' => [
['text' => match ($order->status) {
'bezahlt' => 'Bezahlt ('.$method.')',
'erstattet' => 'Erstattet. Die Berechtigungen sind widerrufen.',
'fehlgeschlagen' => 'Zahlung fehlgeschlagen. Es wurde nichts freigeschaltet.',
default => $order->payment_method === 'rechnung' ? 'Offen: Rechnung erstellen und Zahlungseingang bestätigen.' : 'Offen: Zahlung steht aus.',
}, 'ton' => $order->status === 'bezahlt' ? 'gut' : 'offen'],
$order->withdrawal_requested_at !== null ? ['text' => 'Widerruf erklärt am '.$date($order->withdrawal_requested_at).'. Prüfen und gegebenenfalls erstatten.', 'ton' => 'offen'] : null,
],
'aktionen' => [
...($order->payment_method === 'rechnung' && $order->status === 'offen' ? [['label' => 'Zahlungseingang bestätigen', 'wire' => "mountAction('confirmInvoice')", 'art' => 'primary']] : []),
...($order->status === 'bezahlt' ? [['label' => 'Bestellung erstatten', 'wire' => "mountAction('refund')", 'art' => 'line']] : []),
],
],
'haupt' => [
[
'titel' => 'Positionen',
'hilfe' => 'Fassung, Preis, Rabatt, Nutzerkreis und Umfang sind beim Kauf festgehalten und ändern sich nicht.',
'zeilen' => $order->lines->map(fn (OrderLine $line): array => [
'text' => ($line->offer_name ?: 'Angebot').': '.Money::format((int) $line->price_cents).($line->discount_cents > 0 ? ' − Rabatt '.Money::format((int) $line->discount_cents).' = '.Money::format($line->payable()) : ''),
'neben' => LicenceScope::label($line->licence_scope, $line->trainer_count).' · Angebotsfassung '.($line->offerVersion?->number ?? '–'),
])->values()->all(),
'leer' => ['titel' => 'Keine Positionen', 'text' => 'Diese Bestellung hat keine Positionen.'],
],
[
'titel' => 'Beträge',
'zeilen' => [
['text' => 'Zwischensumme (Listenpreise): '.Money::format($order->subtotal()), 'neben' => null],
...($order->discount_cents > 0 ? [['text' => 'Rabatt: −'.Money::format((int) $order->discount_cents), 'neben' => 'Code '.($order->discount_snapshot['code'] ?? '').' · '.($order->discount_snapshot['label'] ?? '')]] : []),
['text' => 'Zahlbetrag: '.Money::format($order->payable()), 'neben' => 'Dieser Betrag ging an '.$method.'.'],
],
],
[
'titel' => 'Zahlungen',
'zeilen' => $order->payments->map(fn (Payment $payment): array => [
'text' => match ($payment->provider) {
'stripe' => 'Stripe', 'ueberweisung' => 'Überweisung', default => 'Testzahlung'
}.' · '.match ($payment->status) {
'bestaetigt' => 'bestätigt', 'erstattet' => 'erstattet', 'offen' => 'offen', 'abgelaufen' => 'abgelaufen', 'zu_pruefen' => 'zu prüfen', 'fehlgeschlagen' => 'fehlgeschlagen', default => $payment->status
},
'neben' => $payment->provider_reference.($payment->amount_cents !== null ? ' · '.Money::format((int) $payment->amount_cents) : ''),
])->values()->all(),
'leer' => ['titel' => 'Noch keine Zahlung', 'text' => 'Es gibt noch keinen Zahlungsvorgang zu dieser Bestellung.'],
],
],
'seite' => [
[
'titel' => 'Zustimmung',
'zeilen' => $order->terms_accepted_at === null ? [] : [
['text' => 'Zugestimmt am '.$date($order->terms_accepted_at), 'neben' => 'Fassung der Texte: '.($order->terms_snapshot['version'] ?? '–')],
...collect($order->terms_snapshot['consents'] ?? [])->map(fn (string $wording): array => ['text' => $wording, 'neben' => null])->values()->all(),
],
'leer' => 'Zu dieser Bestellung ist keine Zustimmung festgehalten (Bestellung vor dem Verkaufsstart oder über den Testweg).',
],
[
'titel' => 'Widerruf',
'zeilen' => $order->withdrawal_requested_at === null ? [] : [
['text' => 'Erklärt am '.$date($order->withdrawal_requested_at), 'neben' => filled($order->withdrawal_note) ? $order->withdrawal_note : null],
],
'leer' => 'Kein Widerruf erklärt.',
'hilfe' => 'Der Widerruf entzieht nichts. Du prüfst ihn (bei sofortiger Bereitstellung mit Zustimmung kann das Recht erloschen sein) und erstattest bei Bedarf über „Bestellung erstatten“.',
],
],
];
}
}
+126
View File
@@ -0,0 +1,126 @@
<?php
namespace App\Filament\Support;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\Offer;
use App\Domain\Commerce\Discount\DiscountCode;
use Filament\Forms\Components\DatePicker;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Schemas\Components\Utilities\Get;
/**
* Die eine Maske für Rabattcodes: Anlegen und Bearbeiten nutzen dieselben Felder (FACH-20). Geltungsbereich und
* Einlösungsberechtigung sind zwei voneinander unabhängige Einstellungen.
*/
final class DiscountCodeForm
{
/**
* @return list<mixed>
*/
public static function schema(): array
{
return [
TextInput::make('code')->label('Code')->required()->maxLength(40)
->helperText('So gibt ihn der Käufer ein, 3 bis 40 Zeichen: Buchstaben, Ziffern, Bindestrich. Groß- und Kleinschreibung spielen keine Rolle.'),
TextInput::make('label')->label('Name für die Verwaltung')->required()->maxLength(120)
->helperText('Nur intern, zum Beispiel „Zertifizierungscode 2026“. Der Käufer sieht ihn nicht.'),
Select::make('kind')->label('Art des Rabatts')->options([
DiscountCode::PERCENT => 'Prozent',
DiscountCode::AMOUNT => 'Fester Betrag in Euro',
])->required()->live(),
TextInput::make('percent')->label('Prozent')->numeric()->minValue(1)->maxValue(100)->integer()->suffix('%')
->required(fn (Get $get): bool => $get('kind') === DiscountCode::PERCENT)
->visible(fn (Get $get): bool => $get('kind') === DiscountCode::PERCENT)
->helperText('Je Position gerundet. Der Zahlbetrag der Bestellung darf 0,50 € nicht unterschreiten.'),
TextInput::make('amount_euro')->label('Rabattbetrag')->suffix('€')
->required(fn (Get $get): bool => $get('kind') === DiscountCode::AMOUNT)
->visible(fn (Get $get): bool => $get('kind') === DiscountCode::AMOUNT)
->helperText('Gilt je Bestellung und wird anteilig auf die betroffenen Positionen verteilt, zum Beispiel 5,00.'),
Select::make('scope')->label('Geltungsbereich')->options([
DiscountCode::SCOPE_CART => 'Gesamter Warenkorb',
DiscountCode::SCOPE_SELECTED => 'Nur ausdrücklich ausgewählte Angebote, Lizenzartikel oder Pakete',
])->required()->live()
->helperText('Wofür der Rabatt gilt. Unabhängig davon legst du unten fest, wer den Code einlösen darf.'),
Select::make('offer_ids')->label('Angebote')->multiple()->searchable()
->options(fn (): array => Offer::query()->orderBy('name')->pluck('name', 'id')->all())
->visible(fn (Get $get): bool => $get('scope') === DiscountCode::SCOPE_SELECTED)
->helperText('Die gewählte Lizenzoption selbst (Fassung egal).'),
Select::make('article_ids')->label('Lizenzartikel')->multiple()->searchable()
->options(fn (): array => app(PublicationReadiness::class)->articleOptions())
->visible(fn (Get $get): bool => $get('scope') === DiscountCode::SCOPE_SELECTED)
->helperText('Gilt für Angebote, die diesen Artikel unmittelbar als Position führen. Ein Artikel in einem Paket macht das Paket nicht rabattfähig.'),
Select::make('bundle_ids')->label('Pakete')->multiple()->searchable()
->options(fn (): array => Bundle::query()->orderBy('name')->pluck('name', 'id')->all())
->visible(fn (Get $get): bool => $get('scope') === DiscountCode::SCOPE_SELECTED)
->helperText('Ein Paket wird gezielt gewählt. Es folgt nicht aus einem enthaltenen Artikel.'),
Select::make('eligibility')->label('Wer darf den Code einlösen?')->options([
DiscountCode::OPEN => 'Alle angemeldeten Käufer (allgemein einlösbar)',
DiscountCode::RESTRICTED => 'Nur ausdrücklich freigeschaltete Konten',
])->required()
->helperText('Bei „freigeschaltete Konten“ schaltest du einzelne Konten auf der Seite des Codes frei und entziehst die Freigabe wieder. Eine Freigabe gilt nur für diesen Code.'),
DatePicker::make('valid_from')->label('Gültig ab')->native(false)->displayFormat('d.m.Y')
->helperText('Leer: sofort.'),
DatePicker::make('valid_until')->label('Gültig bis einschließlich')->native(false)->displayFormat('d.m.Y')
->helperText('Leer: unbegrenzt. Am Tag danach gilt der Code nicht mehr.'),
Toggle::make('active')->label('Aktiv')->default(true)
->helperText('Deaktivierte Codes lassen sich nicht einlösen; bereits aufgegebene Bestellungen bleiben unverändert.'),
Textarea::make('note')->label('Notiz')->rows(2)->maxLength(500)
->helperText('Zum Beispiel, woran die Berechtigung geprüft wird.'),
];
}
/**
* Formularwerte → Angaben und Ziele des Dienstes.
*
* @param array<string, mixed> $data
* @return array{0: array<string, mixed>, 1: list<array{type: string, id: int}>}
*/
public static function fromForm(array $data): array
{
$targets = [];
foreach ([
DiscountCode::TARGET_OFFER => 'offer_ids',
DiscountCode::TARGET_ARTICLE => 'article_ids',
DiscountCode::TARGET_BUNDLE => 'bundle_ids',
] as $type => $key) {
foreach ((array) ($data[$key] ?? []) as $id) {
$targets[] = ['type' => $type, 'id' => (int) $id];
}
}
return [$data, $targets];
}
/**
* Vorbelegung der Maske aus einem vorhandenen Code.
*
* @return array<string, mixed>
*/
public static function fill(DiscountCode $code): array
{
$code->loadMissing('targets');
$ids = fn (string $type): array => $code->targets->where('target_type', $type)->pluck('target_id')->map(fn ($id): int => (int) $id)->values()->all();
return [
'code' => $code->code,
'label' => $code->label,
'kind' => $code->kind,
'percent' => $code->percent,
'amount_euro' => $code->amount_cents === null ? null : number_format($code->amount_cents / 100, 2, ',', ''),
'scope' => $code->scope,
'offer_ids' => $ids(DiscountCode::TARGET_OFFER),
'article_ids' => $ids(DiscountCode::TARGET_ARTICLE),
'bundle_ids' => $ids(DiscountCode::TARGET_BUNDLE),
'eligibility' => $code->eligibility,
'valid_from' => $code->valid_from?->timezone(config('app.timezone'))->toDateString(),
'valid_until' => $code->valid_until?->timezone(config('app.timezone'))->toDateString(),
'active' => $code->active,
'note' => $code->note,
];
}
}
+26 -9
View File
@@ -8,6 +8,7 @@
use App\Domain\Catalog\BundleStatus;
use App\Domain\Catalog\BundleVersion;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -227,7 +228,8 @@ public function forOffer(Offer $offer): array
$missing = $this->unusableArticles($articleIds);
$buyable = $hasActive && $this->offers->purchasableVersion($offer) !== null;
$page = $offer->composition;
$shown = $page !== null && $this->catalog->shownVersion($page) !== null;
$own = (bool) $offer->standalone_bundle;
$shown = $own || ($page !== null && $this->catalog->shownVersion($page) !== null);
$pageName = $page !== null ? (string) ($page->display_title ?: $page->designation) : '';
$activate = ['label' => $hasActive ? 'Geänderte Fassung aktivieren' : 'Angebot konfigurieren', 'wire' => "mountAction('activate')"];
@@ -258,21 +260,36 @@ public function forOffer(Offer $offer): array
'stand' => $buyable ? 'erledigt' : 'offen',
'aktion' => $buyable ? null : ($hasActive ? $activate : null),
],
[
'titel' => 'Nutzerkreis festlegen',
'text' => ! $hasActive
? 'Wird mit der Fassung festgelegt: Einzellizenz (ein Trainer) oder Mehrfachlizenz (Zahl der Trainer).'
: ($active->licence_scope !== null
? LicenceScope::label($active->licence_scope, $active->trainer_count).'. Der Käufer sieht das auf der Produktseite und in der Bestellung.'
: 'Diese Fassung hat keinen festgelegten Nutzerkreis. Käufer sehen „Nutzerkreis nicht festgelegt“. Lege ihn mit „Geänderte Fassung aktivieren“ fest.'),
'stand' => $hasActive && $active->licence_scope !== null ? 'erledigt' : 'offen',
'aktion' => $hasActive && $active->licence_scope === null ? $activate : null,
'pflicht' => false,
],
[
'titel' => 'Produktseite zuordnen',
'text' => $page !== null
? '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,
'text' => $own
? 'Eigene Paketseite: Sie zeigt den Umfang des Pakets. Optionen desselben Pakets sind Alternativen im Warenkorb.'
: ($page !== null
? 'Zugeordnet: „'.$pageName.'“. Optionen derselben Produktseite sind Alternativen im Warenkorb.'
: 'Der Shop zeigt ein Angebot auf der Seite eines Programms. Wähle in der Maske die Produktseite. Ein Paket, das für sich verkauft wird, erhält dort „Eigene Paketseite“ und zeigt seinen Umfang; sonst erscheint es auf der Seite eines fremden Programms.'),
'stand' => $own || $page !== null ? 'erledigt' : 'offen',
'aktion' => $own || $page !== null ? null : $activate,
],
[
'titel' => 'Produktseite öffentlich',
'text' => $page === null
'text' => ! $own && $page === null
? 'Wird geprüft, sobald eine Produktseite zugeordnet ist.'
: ($shown
: ($own
? 'Die eigene Paketseite ist öffentlich, sobald die aktive Fassung ein Kauf mit Preis ist.'
: ($shown
? 'Das Programm ist zur Anzeige freigegeben. Das Angebot erscheint in der Shop-Suche und auf der Produktseite.'
: 'Das Programm „'.$pageName.'“ ist nicht zur Anzeige freigegeben oder kein Programm. Das Angebot ist dort nicht auffindbar.'),
: 'Das Programm „'.$pageName.'“ ist nicht zur Anzeige freigegeben oder kein Programm. Das Angebot ist dort nicht auffindbar.')),
'stand' => $shown ? 'erledigt' : 'offen',
'aktion' => $page === null || $shown ? null : ['label' => 'Programm öffnen', 'href' => EditorialCatalog::editUrl($page)],
],
+22
View File
@@ -0,0 +1,22 @@
<?php
namespace App\Filament\Support;
use App\Domain\Identity\StaffRole;
use App\Models\User;
use Filament\Facades\Filament;
/**
* Wer Rabattcodes, Freigaben und Bestellungen verwalten darf: Katalogverwalter und Kundenbetreuung. Die
* Berechtigung zum Verkaufen und Erstatten ist eine Betreiberaufgabe, nicht die der Redaktion.
*/
final class ShopAccess
{
public static function allowed(): bool
{
$user = Filament::auth()->user();
return $user instanceof User
&& ($user->hasStaffRole(StaffRole::Katalogverwalter) || $user->hasStaffRole(StaffRole::Kundenbetreuung));
}
}
+6 -6
View File
@@ -7,6 +7,7 @@
use App\Domain\Commerce\Cart;
use App\Domain\Commerce\Money;
use App\Domain\Commerce\OrderHolders;
use App\Domain\Commerce\ProductOptions;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;
@@ -31,9 +32,8 @@ public function show(Request $request, Cart $cart, OrderHolders $holders): View
public function add(Offer $offer, Cart $cart, PublicCatalogReader $catalog): RedirectResponse
{
$page = $offer->composition;
$result = $page !== null && $catalog->shownVersion($page) !== null
? $cart->add($offer)
: Cart::UNAVAILABLE;
$listed = $offer->standalone_bundle || ($page !== null && $catalog->shownVersion($page) !== null);
$result = $listed ? $cart->add($offer) : Cart::UNAVAILABLE;
$back = $this->productPage($offer);
return match ($result) {
@@ -81,8 +81,8 @@ public function accept(Offer $offer, Cart $cart): RedirectResponse
private function productPage(Offer $offer): RedirectResponse
{
return $offer->composition_id !== null
? redirect()->route('public.program', $offer->composition_id)
: redirect()->route('cart');
$url = app(ProductOptions::class)->pageUrl($offer);
return $url !== null ? redirect()->to($url) : redirect()->route('cart');
}
}
@@ -9,10 +9,12 @@
use App\Domain\Commerce\Checkout;
use App\Domain\Commerce\Order;
use App\Domain\Commerce\OrderHolders;
use App\Domain\Commerce\SalesTerms;
use App\Domain\Commerce\Shop;
use App\Domain\Commerce\StaleOverview;
use App\Domain\Commerce\Stripe\StripeGateway;
use App\Domain\Entitlement\GrantIssuer;
use App\Domain\Identity\PartyType;
use App\Http\Controllers\Controller;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
@@ -67,9 +69,38 @@ public function checkout(Request $request, Cart $cart, OrderHolders $holders): V
return view('shop.checkout', [
'review' => $review,
'holders' => $holders->for($request->user()),
'consents' => SalesTerms::consents(),
'legalPages' => SalesTerms::pages(),
'invoice' => Shop::invoice() && $review->holder?->type === PartyType::Organisation,
]);
}
/**
* Rabattcode einlösen. Höchstens ein Code je Bestellung; ein zweiter ersetzt den ersten. Gilt der Code nicht,
* bleibt der bisherige Stand und die Meldung nennt den Grund.
*/
public function applyCode(Request $request, Cart $cart): RedirectResponse
{
$data = $request->validate(['code' => ['required', 'string', 'max:60'], 'bestellen_als' => ['nullable', 'integer']], [
'code.required' => 'Gib einen Rabattcode ein.',
]);
$holderId = isset($data['bestellen_als']) ? (int) $data['bestellen_als'] : null;
$result = $cart->applyCode($data['code'], $request->user(), $holderId);
$back = redirect()->route('checkout', array_filter(['bestellen_als' => $holderId]));
return $result->applied()
? $back->with('status', 'Der Rabattcode '.$result->code->code.' ist angewendet.')
: $back->withErrors(['code' => $result->message ?? 'Der Code kann nicht angewendet werden.']);
}
public function removeCode(Request $request, Cart $cart): RedirectResponse
{
$cart->removeCode();
$holderId = $request->integer('bestellen_als') ?: null;
return redirect()->route('checkout', array_filter(['bestellen_als' => $holderId]))->with('status', 'Der Rabattcode ist entfernt.');
}
/**
* Legt die Bestellung an, aber nur, wenn die serverseitige Prüfung zur gezeigten Übersicht passt.
*/
@@ -78,19 +109,28 @@ public function placeOrder(Request $request, Cart $cart, Checkout $checkout): Re
$data = $request->validate([
'digest' => ['required', 'string'],
'bestellen_als' => ['nullable', 'integer'],
'zahlungsweg' => ['nullable', 'in:online,rechnung'],
'zustimmung' => ['nullable', 'array'],
]);
$holderId = isset($data['bestellen_als']) ? (int) $data['bestellen_als'] : null;
$back = redirect()->route('checkout', array_filter(['bestellen_als' => $holderId]));
$method = ($data['zahlungsweg'] ?? 'online') === 'rechnung' ? 'rechnung' : null;
try {
$order = $checkout->placeFromCart($request->user(), $cart, $holderId, $data['digest']);
// Die Zustimmungen sind eine Pflichtangabe und werden serverseitig geprüft, nicht nur im Formular.
SalesTerms::proof((array) ($data['zustimmung'] ?? []));
$order = $checkout->placeFromCart($request->user(), $cart, $holderId, $data['digest'], (array) ($data['zustimmung'] ?? []), $method);
} catch (StaleOverview $exception) {
return $back->withErrors(['checkout' => $exception->getMessage()]);
} catch (DomainRuleException $exception) {
return $back->withErrors(['checkout' => $exception->getMessage()]);
}
return redirect()->route('member.order', $order)->with('status', 'Die Bestellung ist angelegt. Bestätige jetzt die Testzahlung.');
return redirect()->route('member.order', $order)->with('status', match (true) {
$order->payment_method === 'rechnung' => 'Deine Bestellung auf Rechnung ist eingegangen. Wir senden dir die Rechnung. Die Inhalte sind nach Zahlungseingang in der Bibliothek.',
Shop::stripe() => 'Die Bestellung ist angelegt. Bezahle jetzt sicher bei Stripe.',
default => 'Die Bestellung ist angelegt. Bestätige jetzt die Testzahlung.',
});
}
public function show(Request $request, Order $order): View
@@ -103,9 +143,25 @@ public function show(Request $request, Order $order): View
'testPayment' => ! app()->isProduction() && config('services.payment.driver') === 'test',
'stripePayment' => Shop::stripe(),
'zahlung' => $request->query('zahlung'),
'live' => Shop::live(),
]);
}
/** Erklärt den Widerruf; der Betreiber prüft und erstattet gegebenenfalls in der Bestellverwaltung. */
public function withdraw(Request $request, Order $order, Checkout $checkout): RedirectResponse
{
abort_unless($order->user_id === $request->user()->id, 403);
$data = $request->validate(['note' => ['nullable', 'string', 'max:1000']]);
try {
$checkout->requestWithdrawal($order, (string) ($data['note'] ?? ''));
} catch (DomainRuleException $exception) {
return back()->withErrors(['payment' => $exception->getMessage()]);
}
return redirect()->route('member.order', $order)->with('status', 'Dein Widerruf ist eingegangen. Wir prüfen ihn und melden uns per E-Mail.');
}
/** Leitet zur Stripe-Kasse (Testmodus). Freigeschaltet wird erst durch die signierte Meldung von Stripe. */
public function pay(Request $request, Order $order, StripeGateway $stripe): RedirectResponse
{
@@ -150,6 +206,8 @@ public function fail(Request $request, Order $order, Checkout $checkout): Redire
public function refund(Request $request, Order $order, Checkout $checkout): RedirectResponse
{
abort_unless($order->user_id === $request->user()->id, 403);
// Nur der Testzahlungsweg erstattet auf Knopfdruck. Echte Zahlungen erstattet der Betreiber nach Prüfung.
abort_unless(! app()->isProduction() && Shop::driver() === 'test', 404);
try {
$checkout->refund($order, 'Widerruf durch das Mitglied im Testmodus');
@@ -235,6 +235,8 @@ public function show(Request $request, LicenseArticle $article): View
$download = app(DecideAccess::class)($request->user(), $article, $release, $version, 'laden');
$file = $metadata['file'] ?? null;
$entries[] = [
'title' => app(LibraryCatalog::class)->text($version->element)['title'],
'class' => $class,
'content' => $content,
'version' => $version,
'role' => $content->role,
@@ -447,10 +449,34 @@ private function fileResponse(
'k0',
);
return $disk->response($file, basename($file), [
'Content-Disposition' => $action === 'laden' ? 'attachment' : 'inline',
'X-License-Copy' => $delivery->copy_id,
]);
// Dateiname aus dem Anzeigetitel statt aus der Adresse („laden.mp4“); Laravel setzt Content-Disposition mit
// ASCII-Rückfall und UTF-8-Name.
return $disk->response(
$file,
$this->downloadName($version, $file),
['X-License-Copy' => $delivery->copy_id],
$action === 'laden' ? 'attachment' : 'inline',
);
}
/**
* Dateiname für Ansicht und Download: Anzeigetitel des Mediums (Mitgliedertext, sonst Arbeitstitel) mit der
* Endung der gespeicherten Datei. Zeichen, die in Dateinamen nicht erlaubt sind, entfallen.
*/
private function downloadName(ContentElementVersion $version, string $file): string
{
$element = $version->element;
$title = $element === null ? '' : app(LibraryCatalog::class)->text($element)['title'];
$title = (string) preg_replace('/[\x00-\x1F\x7F\/\\\\:*?"<>|]+/u', ' ', $title);
$title = trim((string) preg_replace('/\s+/u', ' ', $title));
$title = rtrim(mb_substr($title, 0, 120), '. ');
$extension = strtolower(pathinfo($file, PATHINFO_EXTENSION));
if ($title === '') {
return basename($file);
}
return $extension === '' ? $title : $title.'.'.$extension;
}
private function renditionBelongsTo(int $versionId, string $path): bool
@@ -2,11 +2,9 @@
namespace App\Http\Controllers\Member;
use App\Domain\Identity\AccountStatus;
use App\Http\Controllers\Controller;
use App\Http\LibraryCatalog;
use App\Http\MemberLicenses;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;
@@ -28,28 +26,4 @@ public function dashboard(Request $request): View
'licenseCount' => app(MemberLicenses::class)->overview($request->user())->where('active', true)->count(),
]);
}
public function profile(): View
{
return view('member.profile');
}
public function updateProfile(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv, 403);
$data = $request->validate([
'name' => ['required', 'string', 'max:120'],
]);
$user->name = $data['name'];
$user->save();
$user->party?->update(['display_name' => $data['name']]);
$user->party?->profile?->update(['display_name' => $data['name']]);
return redirect()->route('member.profile')->with('status', 'Der Name ist gespeichert. Er ist nicht öffentlich.');
}
}
@@ -0,0 +1,154 @@
<?php
namespace App\Http\Controllers\Member;
use App\Domain\Identity\AccountStatus;
use App\Domain\Identity\BillingAddress;
use App\Http\Controllers\Controller;
use App\Models\User;
use App\Notifications\ConfirmNewEmailAddress;
use App\Notifications\EmailChangeRequested;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Notification;
use Illuminate\Validation\Rule;
use Illuminate\Validation\Rules\Password;
use Illuminate\View\View;
/**
* Mitgliederprofil: Name, E-Mail-Adresse, Passwort und Rechnungsadresse. Jeder Block hat seine eigene Speicherhandlung
* und seine eigenen Fehlermeldungen; nichts wird verdeckt mitgespeichert. Sicherheitsrelevante Änderungen (Adresse,
* Passwort) verlangen das aktuelle Passwort.
*/
class ProfileController extends Controller
{
public function show(Request $request): View
{
$user = $request->user();
return view('member.profile', [
'address' => $user->party?->billingAddress,
'countries' => BillingAddress::COUNTRIES,
]);
}
public function updateName(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv, 403);
$data = $request->validateWithBag('name', [
'name' => ['required', 'string', 'max:120'],
]);
$user->name = $data['name'];
$user->save();
$user->party?->update(['display_name' => $data['name']]);
$user->party?->profile?->update(['display_name' => $data['name']]);
return redirect()->route('member.profile')->with('status', 'Der Name ist gespeichert. Er ist nicht öffentlich.');
}
/**
* Die neue Adresse gilt erst nach Bestätigung über einen Link an sie. Bis dahin bleibt die bisherige Adresse
* in Kraft und erhält einen Hinweis.
*/
public function requestEmail(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv, 403);
$data = $request->validateWithBag('email', [
'email' => ['required', 'string', 'email:rfc', 'max:255', Rule::unique('users', 'email')],
'current_password' => ['required', 'current_password'],
], [
'email.unique' => 'Diese Adresse ist bereits vergeben.',
'current_password.current_password' => 'Das Passwort stimmt nicht.',
]);
$new = mb_strtolower(trim($data['email']));
if ($new === mb_strtolower($user->email)) {
return back()->withErrors(['email' => 'Das ist bereits deine Adresse.'], 'email');
}
$user->forceFill(['pending_email' => $new])->save();
Notification::route('mail', $new)->notify(new ConfirmNewEmailAddress($user->id, $new));
$user->notify(new EmailChangeRequested($new));
return redirect()->route('member.profile')->with('status', 'Wir haben einen Bestätigungslink an '.$new.' geschickt. Die Adresse wechselt, sobald du ihn öffnest.');
}
public function confirmEmail(Request $request, int $id, string $hash): RedirectResponse
{
$user = $request->user();
abort_unless($user->id === $id, 403);
$pending = $user->pending_email;
if (! is_string($pending) || $pending === '' || ! hash_equals(sha1($pending), $hash)) {
return redirect()->route('member.profile')->withErrors(['email' => 'Dieser Link gilt nicht mehr. Fordere die Änderung bitte erneut an.'], 'email');
}
if (User::query()->where('email', $pending)->whereKeyNot($user->id)->exists()) {
$user->forceFill(['pending_email' => null])->save();
return redirect()->route('member.profile')->withErrors(['email' => 'Diese Adresse ist inzwischen vergeben.'], 'email');
}
$user->forceFill(['email' => $pending, 'pending_email' => null, 'email_verified_at' => now()])->save();
return redirect()->route('member.profile')->with('status', 'Deine E-Mail-Adresse ist geändert.');
}
public function cancelEmail(Request $request): RedirectResponse
{
$request->user()->forceFill(['pending_email' => null])->save();
return redirect()->route('member.profile')->with('status', 'Die Änderung der E-Mail-Adresse ist verworfen.');
}
public function updatePassword(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv, 403);
$data = $request->validateWithBag('password', [
'current_password' => ['required', 'current_password'],
'password' => ['required', 'confirmed', Password::defaults(), 'different:current_password'],
], [
'current_password.current_password' => 'Das bisherige Passwort stimmt nicht.',
'password.different' => 'Das neue Passwort muss sich vom bisherigen unterscheiden.',
]);
$user->forceFill(['password' => Hash::make($data['password'])])->save();
$request->session()->regenerate();
return redirect()->route('member.profile')->with('status', 'Dein Passwort ist geändert.');
}
public function updateAddress(Request $request): RedirectResponse
{
$user = $request->user();
abort_if($user->status !== AccountStatus::Aktiv || $user->party === null, 403);
$data = $request->validateWithBag('address', [
'recipient' => ['required', 'string', 'max:160'],
'line2' => ['nullable', 'string', 'max:160'],
'street' => ['required', 'string', 'max:160'],
'postal_code' => ['required', 'string', 'max:16'],
'city' => ['required', 'string', 'max:120'],
'country' => ['required', Rule::in(array_keys(BillingAddress::COUNTRIES))],
], [
'recipient.required' => 'Bitte gib Name oder Firma an.',
'street.required' => 'Bitte gib Straße und Hausnummer an.',
'postal_code.required' => 'Bitte gib die Postleitzahl an.',
'city.required' => 'Bitte gib den Ort an.',
]);
BillingAddress::query()->updateOrCreate(['party_id' => $user->party_id], $data);
return redirect()->route('member.profile')->with('status', 'Die Rechnungsadresse ist gespeichert.');
}
}
@@ -2,6 +2,7 @@
namespace App\Http\Controllers;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionStructureReader;
use App\Domain\Cms\Catalog\PublicCatalogReader;
@@ -17,6 +18,25 @@ public function index(PublicCatalogReader $catalog): View
return view('public.programs', ['programs' => $catalog->publicPrograms()]);
}
/**
* Eigene Produktseite eines Pakets, das für sich vermarktet wird: Sie zeigt den tatsächlichen Umfang des Pakets
* (die enthaltenen Artikel) und darunter die kaufbaren Lizenzoptionen. Ohne kaufbare Option gibt es sie nicht.
*/
public function package(Bundle $bundle, ProductOptions $products, Cart $cart): View
{
abort_unless(Shop::enabled(), 404);
$options = $products->forBundle($bundle);
abort_if($options === [], 404);
return view('public.package', [
'bundle' => $bundle,
'contents' => $products->bundleContents($options),
'options' => $options,
'cart' => $cart,
'switchTo' => session('shop.switch'),
]);
}
public function program(Composition $composition, PublicCatalogReader $catalog, ProductOptions $products, Cart $cart): View
{
$version = $catalog->shownVersion($composition);
+22 -1
View File
@@ -2,6 +2,7 @@
namespace App\Http\Controllers;
use App\Domain\Catalog\Bundle;
use App\Domain\Catalog\Composition;
use App\Domain\Cms\Catalog\PublicCatalogReader;
use App\Domain\Commerce\Money;
@@ -37,7 +38,7 @@ public function index(Request $request, ProductOptions $products, PublicCatalogR
$summary = $summaries[$composition->id];
$cards[] = [
'composition' => $composition,
'url' => route('public.program', $composition),
'title' => $title,
'teaser' => (string) ($composition->teaser ?: $composition->summary),
'from' => Money::format($summary['from_cents']),
@@ -45,6 +46,26 @@ public function index(Request $request, ProductOptions $products, PublicCatalogR
];
}
// Pakete mit eigener Produktseite: gelistet mit Name und enthaltenen Artikeln.
foreach (Bundle::query()->whereIn('id', array_keys($products->bundleSummaries()))->orderBy('name')->get() as $bundle) {
$options = $products->forBundle($bundle);
$contents = $products->bundleContents($options);
$names = implode(', ', array_column($contents, 'title'));
if ($term !== '' && ! str_contains(mb_strtolower($bundle->name.' '.$names), mb_strtolower($term))) {
continue;
}
$summary = $products->bundleSummaries()[$bundle->id];
$cards[] = [
'url' => route('public.package', $bundle),
'title' => (string) $bundle->name,
'teaser' => 'Paket mit '.count($contents).' '.(count($contents) === 1 ? 'Inhalt' : 'Inhalten').($names !== '' ? ': '.$names : ''),
'from' => Money::format($summary['from_cents']),
'count' => $summary['count'],
];
}
return view('shop.index', ['cards' => $cards, 'term' => $term]);
}
}
@@ -83,6 +83,10 @@ private function paid(array $session, Checkout $checkout): JsonResponse
return response()->json(['received' => true, 'handled' => false]);
}
if (filled($session['payment_intent'] ?? null)) {
$order->payments()->where('provider_reference', $reference)->update(['provider_payment_ref' => (string) $session['payment_intent']]);
}
return response()->json(['received' => true, 'handled' => true]);
}
+2
View File
@@ -158,6 +158,8 @@ private function entry(User $user, Grant $grant): array
? 'Spätere freigegebene Fassungen sind eingeschlossen.'
: null,
'source' => $this->source($user, $grant),
'licence_scope' => $conditions['licence_scope'] ?? null,
'trainer_count' => isset($conditions['trainer_count']) ? (int) $conditions['trainer_count'] : null,
'holder_kind' => $holderKind,
'holder' => $holderKind === 'organisation' ? (string) ($grant->acquisition?->party?->display_name ?? 'Organisation') : 'Persönlich',
'url' => route('member.grant', $grant),
+1 -1
View File
@@ -23,7 +23,7 @@
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
#[Fillable(['party_id', 'name', 'email', 'password', 'status', 'confirmed_adult_at'])]
#[Fillable(['party_id', 'name', 'email', 'password', 'status', 'confirmed_adult_at', 'pending_email'])]
#[Hidden(['password', 'remember_token'])]
class User extends Authenticatable implements FilamentUser, HasAppAuthentication, HasAppAuthenticationRecovery, MustVerifyEmail
{
@@ -0,0 +1,36 @@
<?php
namespace App\Notifications;
use App\Http\SignedLink;
use Illuminate\Notifications\Messages\MailMessage;
use Illuminate\Notifications\Notification;
use Illuminate\Support\Carbon;
/**
* Bestätigungslink an die NEUE Adresse. Erst der Klick darauf tauscht die Adresse des Kontos aus.
*/
class ConfirmNewEmailAddress extends Notification
{
public function __construct(private readonly int $userId, private readonly string $newEmail) {}
/** @return list<string> */
public function via(mixed $notifiable): array
{
return ['mail'];
}
public function toMail(mixed $notifiable): MailMessage
{
$url = SignedLink::temporary('member.profile.email.confirm', Carbon::now()->addMinutes(60), [
'id' => $this->userId,
'hash' => sha1($this->newEmail),
]);
return (new MailMessage)
->subject('Neue E-Mail-Adresse bestätigen')
->line('Du hast gebeten, die E-Mail-Adresse deines Kontos bei Lara & Felix zu ändern. Bestätige mit dem Knopf, dass diese Adresse dir gehört.')
->action('Adresse bestätigen', $url)
->line('Der Link gilt 60 Minuten. Wenn du das nicht angefordert hast, ignoriere diese Nachricht; es ändert sich nichts.');
}
}
@@ -0,0 +1,28 @@
<?php
namespace App\Notifications;
use Illuminate\Notifications\Messages\MailMessage;
use Illuminate\Notifications\Notification;
/**
* Hinweis an die bisherige Adresse, dass eine Änderung beantragt wurde (Schutz vor Kontoübernahme).
*/
class EmailChangeRequested extends Notification
{
public function __construct(private readonly string $newEmail) {}
/** @return list<string> */
public function via(mixed $notifiable): array
{
return ['mail'];
}
public function toMail(mixed $notifiable): MailMessage
{
return (new MailMessage)
->subject('Änderung deiner E-Mail-Adresse beantragt')
->line('Für dein Konto bei Lara & Felix wurde beantragt, die E-Mail-Adresse auf '.$this->newEmail.' zu ändern.')
->line('Die Adresse wechselt erst, wenn die neue Adresse bestätigt wird. Warst du das nicht, ändere bitte dein Passwort und melde dich bei uns.');
}
}
+32
View File
@@ -0,0 +1,32 @@
<?php
return [
/*
|--------------------------------------------------------------------------
| Produktivfreigabe des Shops (Verkaufsstart Deutschland)
|--------------------------------------------------------------------------
|
| Ohne diese Freigabe bleibt der Shop in Produktion abgeschaltet, und Stripe nimmt dort keine Zahlung an. Die
| Freigabe ist eine Entscheidung von Lars; sie wird ausschließlich in /etc/luf/prod.env gesetzt (SHOP_LIVE_RELEASE=true),
| nie im Repository. Zusätzlich verlangt Shop::live() einen Live-Schlüssel (sk_live_), den Zahlungstreiber „stripe“
| und veröffentlichte Rechtstexte (SalesTerms::missingPages()).
|
*/
'live_release' => (bool) env('SHOP_LIVE_RELEASE', false),
/*
| Kauf auf Rechnung für Vereine und Organisationen (PAY-006): auf Anfrage, Rechnung manuell durch den Betreiber.
*/
'invoice' => (bool) env('SHOP_INVOICE', true),
/*
| Preis- und Steuerhinweis im Warenkorb und in der Bestellübersicht. Der Wortlaut hängt an der Steuerentscheidung
| (OPEN-06) und wird erst mit ihr festgelegt (Umgebungsvariable SHOP_PRICE_NOTE).
*/
'price_note' => env('SHOP_PRICE_NOTE', 'Alle Preise in Euro.'),
];
+7
View File
@@ -70,6 +70,13 @@ public function katalogverwalter(): static
});
}
public function kundenbetreuung(): static
{
return $this->afterCreating(function (User $user): void {
$user->staffRoles()->create(['role' => StaffRole::Kundenbetreuung]);
});
}
public function redakteur(): static
{
return $this->afterCreating(function (User $user): void {
@@ -0,0 +1,39 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Mitgliederprofil (ADR-46): neue E-Mail-Adresse wartet auf Bestätigung (pending_email) und Rechnungsadresse je Lizenzinhaber.
* Rein ergänzend: keine bestehende Spalte und Tabelle wird verändert; ein Code-Rollback ignoriert beides.
*/
return new class extends Migration
{
public function up(): void
{
Schema::table('users', function (Blueprint $table): void {
$table->string('pending_email')->nullable();
});
Schema::create('billing_addresses', function (Blueprint $table): void {
$table->id();
$table->foreignId('party_id')->unique()->constrained('parties')->cascadeOnDelete();
$table->string('recipient', 160);
$table->string('line2', 160)->nullable();
$table->string('street', 160);
$table->string('postal_code', 16);
$table->string('city', 120);
$table->string('country', 2)->default('DE');
$table->timestamps();
});
}
public function down(): void
{
Schema::dropIfExists('billing_addresses');
Schema::table('users', function (Blueprint $table): void {
$table->dropColumn('pending_email');
});
}
};
@@ -0,0 +1,123 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Verkaufsstart Deutschland (A1): nur ergänzend, nichts wird gelöscht oder umbenannt; ein Rollback des Codes lässt
* die neuen Spalten und Tabellen liegen (der frühere Code kennt sie nicht).
*
* - Rabattcodes mit Geltungsbereich (Warenkorb oder ausgewählte Ziele) und Einlösungsberechtigung (allgemein oder
* nur für freigeschaltete Konten). Freigaben werden nie gelöscht, nur entzogen.
* - Nutzerkreis der Lizenzoption (Einzel- oder Mehrfachlizenz, Zahl der Trainer) an der Angebotsfassung, kopiert in
* die Bestellposition. Lizenzinhaber, berechtigte Trainer und Downloadzugriff sind getrennte Angaben.
* - Rabatt, Zahlbetrag, Zahlungsweg und Zustimmungsnachweis an der Bestellung.
* - Ein eigenständig vermarktetes Paket hat eine eigene Produktseite (offers.standalone_bundle), die seinen Umfang zeigt.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('discount_codes', function (Blueprint $table) {
$table->id();
$table->string('code')->unique();
$table->string('label');
$table->string('kind', 12);
$table->unsignedTinyInteger('percent')->nullable();
$table->unsignedInteger('amount_cents')->nullable();
$table->string('scope', 12)->default('warenkorb');
$table->string('eligibility', 12)->default('allgemein');
$table->timestamp('valid_from')->nullable();
$table->timestamp('valid_until')->nullable();
$table->boolean('active')->default(true);
$table->text('note')->nullable();
$table->timestamps();
});
Schema::create('discount_code_targets', function (Blueprint $table) {
$table->id();
$table->foreignId('discount_code_id')->constrained('discount_codes')->cascadeOnDelete();
$table->string('target_type', 16);
$table->unsignedBigInteger('target_id');
$table->timestamps();
$table->unique(['discount_code_id', 'target_type', 'target_id']);
});
Schema::create('discount_code_releases', function (Blueprint $table) {
$table->id();
$table->foreignId('discount_code_id')->constrained('discount_codes')->cascadeOnDelete();
$table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
$table->foreignId('granted_by')->nullable()->constrained('users')->nullOnDelete();
$table->timestamp('granted_at');
$table->timestamp('valid_until')->nullable();
$table->foreignId('revoked_by')->nullable()->constrained('users')->nullOnDelete();
$table->timestamp('revoked_at')->nullable();
$table->text('reason')->nullable();
$table->timestamps();
$table->index(['discount_code_id', 'user_id']);
});
Schema::table('offers', function (Blueprint $table) {
$table->boolean('standalone_bundle')->default(false);
});
Schema::table('offer_versions', function (Blueprint $table) {
$table->string('licence_scope', 12)->nullable();
$table->unsignedSmallInteger('trainer_count')->nullable();
});
Schema::table('order_lines', function (Blueprint $table) {
$table->string('licence_scope', 12)->nullable();
$table->unsignedSmallInteger('trainer_count')->nullable();
$table->unsignedInteger('discount_cents')->default(0);
});
Schema::table('orders', function (Blueprint $table) {
$table->unsignedInteger('subtotal_cents')->nullable();
$table->unsignedInteger('discount_cents')->default(0);
$table->foreignId('discount_code_id')->nullable()->constrained('discount_codes')->nullOnDelete();
$table->json('discount_snapshot')->nullable();
$table->string('payment_method', 16)->nullable();
$table->timestamp('terms_accepted_at')->nullable();
$table->json('terms_snapshot')->nullable();
$table->timestamp('withdrawal_requested_at')->nullable();
$table->text('withdrawal_note')->nullable();
});
Schema::table('payments', function (Blueprint $table) {
$table->string('provider_payment_ref')->nullable();
$table->unsignedInteger('amount_cents')->nullable();
$table->foreignId('confirmed_by')->nullable()->constrained('users')->nullOnDelete();
});
}
public function down(): void
{
Schema::table('payments', function (Blueprint $table) {
$table->dropConstrainedForeignId('confirmed_by');
$table->dropColumn(['provider_payment_ref', 'amount_cents']);
});
Schema::table('orders', function (Blueprint $table) {
$table->dropConstrainedForeignId('discount_code_id');
$table->dropColumn([
'subtotal_cents', 'discount_cents', 'discount_snapshot', 'payment_method',
'terms_accepted_at', 'terms_snapshot', 'withdrawal_requested_at', 'withdrawal_note',
]);
});
Schema::table('order_lines', function (Blueprint $table) {
$table->dropColumn(['licence_scope', 'trainer_count', 'discount_cents']);
});
Schema::table('offer_versions', function (Blueprint $table) {
$table->dropColumn(['licence_scope', 'trainer_count']);
});
Schema::table('offers', function (Blueprint $table) {
$table->dropColumn('standalone_bundle');
});
Schema::dropIfExists('discount_code_releases');
Schema::dropIfExists('discount_code_targets');
Schema::dropIfExists('discount_codes');
}
};
+8 -5
View File
@@ -8,6 +8,7 @@
use App\Domain\Catalog\CompositionVersion;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Catalog\LicenceScope;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
@@ -78,14 +79,14 @@ public function run(): void
'pdf' => ['ansehen', 'laden'],
]);
$this->offer($offers, 'Konflikte im Training: Privatlizenz', 'Privatlizenz', $konflikteVersion, [$konflikteArticle, $privat], 4900, 'person');
$this->offer($offers, 'Konflikte im Training: Vereinslizenz', 'Mehrfachlizenz für Vereine', $konflikteVersion, [$konflikteArticle, $verein], 14900, 'organisation');
$this->offer($offers, 'Grenzen setzen: Privatlizenz', 'Privatlizenz', $grenzenVersion, [$grenzenArticle, $privat], 2900, 'person');
$this->offer($offers, 'Konflikte im Training: Privatlizenz', 'Privatlizenz', $konflikteVersion, [$konflikteArticle, $privat], 4900, 'person', LicenceScope::SINGLE, 1);
$this->offer($offers, 'Konflikte im Training: Vereinslizenz', 'Mehrfachlizenz für Vereine', $konflikteVersion, [$konflikteArticle, $verein], 14900, 'organisation', LicenceScope::MULTI, 5);
$this->offer($offers, 'Grenzen setzen: Privatlizenz', 'Privatlizenz', $grenzenVersion, [$grenzenArticle, $privat], 2900, 'person', LicenceScope::SINGLE, 1);
$bundle = $bundles->create('Starterpaket');
$starter = $bundles->publish($bundle, [$konflikteArticle->fresh(), $grenzenArticle->fresh(), $starterArticle->fresh()]);
$paket = $offers->create('Starterpaket: Privatlizenz');
$offers->activate($paket, [['target' => $starter, 'rights' => $privat]], ['grant_kind' => 'kauf', 'price_cents' => 5900, 'holder_kind' => 'person']);
$offers->activate($paket, [['target' => $starter, 'rights' => $privat]], ['grant_kind' => 'kauf', 'price_cents' => 5900, 'holder_kind' => 'person', 'licence_scope' => LicenceScope::SINGLE, 'trainer_count' => 1]);
$offers->assignProduct($paket, $starterVersion->composition_id, 'Starterpaket (zwei Programme und Einführung)');
$tina = $this->account('Tina Trainerin', 'tina.trainerin@example.test');
@@ -160,13 +161,15 @@ private function program(
/**
* @param array{0: LicenseArticle, 1: RightsProfileVersion} $line
*/
private function offer(OfferService $offers, string $name, string $label, CompositionVersion $version, array $line, int $cents, string $holder): Offer
private function offer(OfferService $offers, string $name, string $label, CompositionVersion $version, array $line, int $cents, string $holder, ?string $scope = null, ?int $trainers = null): Offer
{
$offer = $offers->create($name);
$offers->activate($offer, [['target' => $line[0], 'rights' => $line[1]]], [
'grant_kind' => 'kauf',
'price_cents' => $cents,
'holder_kind' => $holder,
'licence_scope' => $scope,
'trainer_count' => $trainers,
]);
$offers->assignProduct($offer, $version->composition_id, $label);
+3 -1
View File
@@ -375,7 +375,9 @@ ### 5.1 Der Vertragsdatensatz: was zur Rekonstruktion des gekauften Angebots nö
**Nicht** Teil des Vertragsdatensatzes ist das Aussehen der damaligen Marketingseite. Seitenrevisionen des CMS sind eine Bearbeitungshilfe der Redaktion mit eigener, kürzerer Aufbewahrung; ihre pixelgenaue Wiederherstellung wird nicht zugesichert und nicht benötigt.
Der Warenkorb fasst die ausgewählten kaufbaren Angebote oder Optionen zusammen. Er reserviert keine Preise oder Lizenzkonditionen. Bei Bestellabschluss werden je Position die vereinbarte Angebotsfassung, der Preis, die Konditionen und der aufgelöste Lizenzumfang gespeichert. Eine Bestellung kann höchstens einen Rabattcode verwenden. Ein allgemeiner Code ist auf Warenkorbebene anwendbar, ein produktspezifischer Code nur auf berechtigte Positionen. Die Berechtigung für den Zertifizierungsrabatt kommt aus dem geprüften Kundenkonto. Nach der Bestellung bleibt der berechnete Zahlbetrag nachvollziehbar. Die Verteilung eines Bestellrabatts auf Positionen im Erstattungsfall ist noch festzulegen.
Der Warenkorb fasst die ausgewählten kaufbaren Angebote oder Optionen zusammen. Er reserviert keine Preise oder Lizenzkonditionen. Bei Bestellabschluss werden je Position die vereinbarte Angebotsfassung, der Preis, die Konditionen und der aufgelöste Lizenzumfang gespeichert. Eine Bestellung kann höchstens einen Rabattcode verwenden. Ein allgemeiner Code ist auf Warenkorbebene anwendbar, ein produktspezifischer Code nur auf berechtigte Positionen. Die Berechtigung für den Zertifizierungsrabatt kommt aus dem geprüften Kundenkonto. Nach der Bestellung bleibt der berechnete Zahlbetrag nachvollziehbar: Die Bestellung hält Zwischensumme, Rabatt, Zahlbetrag und einen Abzug des Codes fest, die Bestellposition Listenpreis und den auf sie entfallenden Rabatt. Geltungsbereich (Warenkorb oder ausgewählte Ziele: Angebot, Lizenzartikel, Paket) und Einlösungsberechtigung (allgemein oder freigeschaltete Konten) sind unabhängige Eigenschaften des Codes; Freigaben gelten je Code und Konto und werden nur entzogen, nie gelöscht (ADR-47). Die Verteilung eines Bestellrabatts auf Positionen im Erstattungsfall bei Einzelrückgabe ist noch festzulegen (Rechenbeispiel in ADR-47); zum Start gibt es nur Vollerstattungen.
Der **Nutzerkreis** der Lizenzoption (Einzellizenz = ein Trainer, Mehrfachlizenz = festgelegte Trainerzahl) gehört zur Angebotsfassung, wird in Bestellposition und Erwerb kopiert und ist getrennt von Lizenzinhaber, Nutzungszweck und Downloadkonto.
## 6. Stabile Identitäten im Überblick
@@ -239,7 +239,7 @@ ## 7. Überlappung, Entzug und Erstattung (LIC-005, SC-12)
Für den Start sind keine freiwilligen Teilerstattungen vorgesehen. Ein Bundle bildet eine Erwerbseinheit für die Rückgabe. Bei einer vollständigen Erstattung werden die betroffenen Erwerbe anhand der Bestellpositionen entzogen. Rechte aus anderen Erwerbsquellen werden weiter berücksichtigt. Extern ausgelöste Teilbeträge und rechtlich gebotene Sonderfälle laufen über die Betreiberprüfung in `07`, Ablauf 5.
Eine geprüfte Trainerzertifizierung am Konto kann für einen gemeinsamen Rabattcode qualifizieren. Berechtigte Konten können diesen Code bei weiteren Bestellungen wiederverwenden. Der Rabatt ändert den Zahlbetrag. Der erworbene Lizenzumfang ergibt sich aus der bestellten Angebotsoption.
Eine geprüfte Trainerzertifizierung am Konto kann für einen gemeinsamen Rabattcode qualifizieren. Berechtigte Konten können diesen Code bei weiteren Bestellungen wiederverwenden. Der Rabatt ändert den Zahlbetrag. Der erworbene Lizenzumfang ergibt sich aus der bestellten Angebotsoption. Die Berechtigung ist eine Freigabe des Kontos für genau diesen Code (nicht für andere Codes), vom Betreiber nach manueller Prüfung des Zertifikats erteilt und entziehbar; sie wird bei der Einlösung und unmittelbar vor Bestellabschluss geprüft (ADR-47).
## 8. Gezieltes Upgrade (LIC-007, LIC-012, SC-09)
@@ -287,7 +287,7 @@ ### 8.4 Verworfene Alternativen
## 9. Organisationen und Sitze (ID-003, SC-14)
**Vereinskauf zum Download-Start:** Einzel- und Mehrfachlizenz bestimmen den vertraglichen Nutzungsumfang. Eine Vereinslizenz gehört dem Verein. Die Berechtigung zum Download aus der Bestellung ist ausschließlich an das Mitgliederkonto gebunden, das die Bestellung ausgelöst hat. Bestellendes Konto und Lizenzinhaber werden im Kauf festgehalten. Die zentrale Rechteprüfung berücksichtigt bei Vereinskäufen diese ausdrückliche Kontobindung. Mehrfachlizenzen erzeugen zum Start keine weiteren Downloadkonten. Die nachstehende Sitzverwaltung beschreibt den möglichen Ausbau. Für den Online-Player ist offen, ob zugeordnete Trainerprofile verwendet werden oder das bestellende Profil autorisierte Streaming-Links erzeugt.
**Vereinskauf zum Download-Start:** Einzel- und Mehrfachlizenz bestimmen den vertraglichen Nutzungsumfang. Eine Vereinslizenz gehört dem Verein. Die Berechtigung zum Download aus der Bestellung ist ausschließlich an das Mitgliederkonto gebunden, das die Bestellung ausgelöst hat. Bestellendes Konto und Lizenzinhaber werden im Kauf festgehalten. Die zentrale Rechteprüfung berücksichtigt bei Vereinskäufen diese ausdrückliche Kontobindung. Mehrfachlizenzen erzeugen zum Start keine weiteren Downloadkonten. Der Nutzerkreis (Einzellizenz: ein Trainer; Mehrfachlizenz: festgelegte Trainerzahl) ist eine vertragliche Angabe der Lizenzoption und wird bei Kauf in Bestellposition und Erwerb festgehalten. Er wird weder aus dem Nutzungszweck noch aus Preis oder Rabattfreigabe abgeleitet; Lizenzinhaber, berechtigte Trainer und technischer Downloadzugriff bleiben getrennte Angaben. Die Trainerzahl ist zum Start rein vertraglich (Anzeige und Nachvollziehbarkeit), keine technische Sperre. Die nachstehende Sitzverwaltung beschreibt den möglichen Ausbau. Für den Online-Player ist offen, ob zugeordnete Trainerprofile verwendet werden oder das bestellende Profil autorisierte Streaming-Links erzeugt.
```text
weise_sitz_zu(pool, konto, ausführender):
+1 -1
View File
@@ -100,7 +100,7 @@ ## Ablauf 3 – Kauf mit Zahlungsbestätigung (PAY-002)
**Warenkorbzustände.** Die gewählten Optionen bleiben in derselben Browsersitzung über Anmeldung, Registrierung und E-Mail-Bestätigung hinweg erhalten. Je Option gibt es eine Position. Alternativoptionen derselben Angebotsgruppe werden nur nach ausdrücklichem Wechsel ersetzt. Ein bereits erworbener Umfang mit denselben Rechten für den vorgesehenen Lizenzinhaber bleibt mit dem Hinweis „Bereits erworben · Wird nicht mitbestellt“ sichtbar. Diese Position gehört nicht zur Kaufsumme und erzeugt keine Bestellposition. Der Käufer kann sie entfernen, die Bibliothek öffnen oder mit den übrigen Positionen fortfahren. Die Entscheidung wird beim Abschluss serverseitig erneut geprüft. Das Verhalten bei zurückgezogenen Angeboten richtet sich nach FACH-59.
**Rabatt.** Höchstens ein Code je Bestellung. Allgemeine Codes können den gesamten Warenkorb betreffen, produktspezifische nur die dazugehörigen Positionen. Für den gemeinsamen Zertifizierungscode prüft der Betreiber die angegebene Zertifizierung anhand der Liste und vermerkt die Berechtigung am Konto. Berechtigte Konten können den Code wiederholt bei späteren Bestellungen einlösen.
**Rabatt.** Höchstens ein Code je Bestellung. Allgemeine Codes können den gesamten Warenkorb betreffen, produktspezifische nur die dazugehörigen Positionen. Für den gemeinsamen Zertifizierungscode prüft der Betreiber die angegebene Zertifizierung anhand der Liste und vermerkt die Berechtigung am Konto. Berechtigte Konten können den Code wiederholt bei späteren Bestellungen einlösen. Im Checkout gibt der Käufer den Code ein und kann ihn entfernen; die Übersicht zeigt rabattierte Positionen, Rabattbetrag und endgültigen Zahlbetrag und erklärt, wenn der Code abgelaufen ist, keine Position passt oder für das Konto keine Freigabe vorliegt. Stripe erhält den Zahlbetrag nach Rabatt (ADR-47).
Entscheidende Punkte:
@@ -66,6 +66,7 @@ ## Übersicht der Architekturentscheidungen
| ADR-43 | Trailer auf Karten | Umgesetzt auf Test (21.11.2026); Abnahme offen | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer beim Überfahren oder Antippen; ohne Freigabe nur das Bild |
| ADR-44 | Gemeinsame, konfigurierbare Größenskala | Umgesetzt auf `develop` (22.11.2026); Abnahme durch den Betreiber offen | Zehn Basiswerte steuern Typografie, Abstände, Kopfzeile, Breite und Bildhöhen für Website, CMS-Vorschau und gemeinsam genutzte Komponenten; einstellbar in „Website → Design → Größen“ ohne Deployment |
| ADR-45 | Mitgliederbereich nach Brand-UI-Kit 14 | Umgesetzt auf `develop` (22.11.2026); Abnahme durch den Betreiber offen | Eine Navigation (Bibliothek, Programme, Lizenzen, Konto), eine Karte je Medienidentität in der übergreifenden Liste, Film und Material im Zusammenhang, Lizenzdetail je Berechtigung; keine neuen Datenmodelle, Größen nur aus der Skala |
| ADR-46 | Mitgliederprofil | Umgesetzt auf `develop` (23.11.2026); Abnahme offen | Name, E-Mail (mit Bestätigung der neuen Adresse), Passwort und Rechnungsadresse je Lizenzinhaber im Mitgliederbereich; Fußzeile mit Rechtlichem; Download-Dateiname aus dem Titel |
---
@@ -615,3 +616,42 @@ ## ADR-45 – Mitgliederbereich nach Brand-UI-Kit 14
**Alternativen.** Eigene Bibliotheks-Tabelle oder Suchindex (verworfen: zweite Wahrheit neben den Fachobjekten); „Verwendet in“ als gespeicherte Beziehung (verworfen: abgeleitet aus den Strukturen); Player weiter eingebettet in der Programmstruktur (verworfen: lädt jeden Film der Seite, trennt Film und Begleitmaterial nicht); Übernahme der Entwurfspixel (verworfen: widerspricht ADR-44).
**Folgen.** Tests, die Markup der alten Ansichten prüften, sind bewusst geändert (Begründung im Commit). Die Vorschau der Bibliothekskarte in der Verwaltung rendert dieselbe Komponente `<x-member.card>`. Offene Abhängigkeiten zur Fachverwaltung stehen im Abschlussbericht `docs/ux/mitgliederbereich/abschlussbericht.md`.
**Quelle.** `docs/Brand-UI-Kit/14_mitgliederbereich_v2.0/` (Handoff, Implementierungsbrief), Fachkonzept §§6–11 und 13, ADR-36, ADR-44.
## ADR-46 – Mitgliederprofil, Fußzeile und Dateiname
**Status am 23.11.2026:** Umgesetzt auf `develop` (Branch `feature/mitglieder-nachbesserung`); Abnahme offen. Ergänzt ADR-45 nach der ersten Sichtung auf luf-test.
**Kontext.** Das Profil bot nur den Namen. Mitglieder brauchen Adresse, Passwort und Rechnungsadresse selbst; Impressum und Datenschutz fehlten im Mitgliederbereich; Downloads hießen nach der Adresse („laden.mp4“).
**Entscheidung.**
- **Profil in vier Blöcken** mit je eigener Speicherhandlung und eigenen Fehlern (`App\Http\Controllers\Member\ProfileController`). **E-Mail:** Die neue Adresse wird als `users.pending_email` vorgemerkt und gilt erst, wenn ein signierter Link (60 Minuten) an die neue Adresse geöffnet wird; die bisherige Adresse erhält einen Hinweis; verlangt wird das aktuelle Passwort; der Link gilt nur für das eigene Konto und die vorgemerkte Adresse. **Passwort:** bisheriges Passwort, Regeln wie bei der Registrierung, neues muss abweichen. **Rechnungsadresse:** Tabelle `billing_addresses`, eine je Lizenzinhaber (Party), gepflegt, aber noch nicht in Bestellungen kopiert. Beide Migrationen sind rein ergänzend (Rollback-sicher).
- **Fußzeile** `x-member.footer`: Links aus der CMS-Navigation (Plätze Rechtliches und Kontakt), ersatzweise die veröffentlichten Seiten `/impressum` und `/datenschutz`; keine fest codierten Texte.
- **Dateiname** von Download und Ansicht aus dem Anzeigetitel des Mediums plus Dateiendung; ein eigenes Feld im Medienmanager ist nicht beschlossen.
- **Player:** Der Anfangsscan von `app.js` bindet auch im Quelltext stehende HLS-Videos an hls.js an (bisher übersprungen, weil `document` kein `Element` ist).
- **Einzel-/Mehrfachlizenz:** zum Zeitpunkt dieser Entscheidung nicht vorhanden; seit ADR-47 gibt es den Nutzerkreis je Lizenzoption.
**Alternativen.** E-Mail sofort ändern (verworfen: Tippfehler sperrt das Konto aus, Kontoübernahme ohne Gegenprobe); Adresse als Freitext am Konto (verworfen: Rechnungsadresse gehört zum Lizenzinhaber, auch für Organisationen); Fußzeile des Website-Gerüsts übernehmen (verworfen: zu groß für die Arbeitsoberfläche).
**Folgen.** Rechnungsstellung und Bestellübersicht müssen die Adresse später in die Bestellung kopieren (Stand zum Kaufzeitpunkt). Pflege der Rechtsseiten bleibt Aufgabe der Redaktion im CMS.
**Quelle.** Rückmeldung des Betreibers vom 23.11.2026; ADR-45; `05_Lizenz_und_Berechtigungslogik.md` §9.
## ADR-47 – Rabattcodes, Nutzerkreis der Lizenzoption und Verkaufsstart-Vorbereitung
**Status am 24.11.2026:** Umgesetzt auf `feature/shop-rabatt-lizenz` (Abnahme siehe `docs/ux/verwaltung/abnahme/etappe-1.md`, Abschnitt „Verkaufsstart-Etappe“). Die Produktivfreigabe ist **nicht** erteilt und bleibt bei Lars.
**Kontext.** PAY-006 bis PAY-009 und ID-004 legen den Verkaufsstart fest; Rabattcodes, Einzel-/Mehrfachlizenz und die Pflichtangaben im Bestellablauf fehlten. Aus Etappe 1 waren drei Download-Befunde und die Frage nach der Produktseite eines Pakets offen.
**Bestätigt durch den Auftrag von Lars (21.11. bis 24.11.2026).**
- **Rabattcode, zwei voneinander unabhängige Einstellungen.** Geltungsbereich: gesamter Warenkorb oder ausdrücklich gewählte Lizenzartikel, Angebote oder Pakete. Ein Paket ist ein eigenes Ziel; seine Rabattfähigkeit folgt nie aus einem enthaltenen Artikel (und umgekehrt). Einlösungsberechtigung: allgemein oder nur für ausdrücklich freigeschaltete Konten. Freigaben gelten je Code und Konto (Freigabe für X ist keine für Y), werden nie gelöscht, nur entzogen. Pro Bestellung höchstens ein Code. Der Rabatt ändert den Preis, nie den Nutzungsumfang.
- **Prüfung** bei Eingabe, in jeder Übersicht und unter Sperre unmittelbar vor Bestellabschluss; die Prüfsumme der Übersicht enthält Code, Zustand und Rabatt je Position, ein zwischenzeitlich entzogener Code ergibt `StaleOverview` statt einer Bestellung zum falschen Preis. Ein vorgemerkter, aber nicht mehr gültiger Code hält die Bestellung an, bis er entfernt wird.
- **Nutzerkreis je Lizenzoption** (`offer_versions.licence_scope`, `trainer_count`): Einzellizenz = ein Trainer, Mehrfachlizenz = festgelegte Zahl (2 bis 999). Er wird weder aus dem Nutzungszweck (ehrenamtlich, kommerziell, institutionell) noch aus Preis oder Rabattfreigabe abgeleitet. Lizenzinhaber, berechtigte Trainer und technischer Downloadzugriff sind getrennte Angaben; beim Vereinskauf bleibt der Verein Lizenzinhaber und nur das bestellende Konto lädt herunter. Der Wert wird in Bestellposition und Erwerb (Bedingungen) kopiert und gehört zur Prüfung „Bereits erworben“ (eine Einzellizenz deckt keine Mehrfachlizenz ab). Ältere Fassungen und Bestellungen zeigen „Nutzerkreis nicht festgelegt“, es gibt keine Rückfüllung. Zusätzliche Trainerkonten und Sitzzuweisungen bleiben A4.
- **Ein Angebot ohne verkaufbaren Inhalt** (Artikel ohne veröffentlichten Stand) lässt sich im Domänenmodell (`OfferService::activate`) nicht aktivieren, nicht nur in der Maske.
- **Ein eigenständig vermarktetes Paket** erhält eine eigene Produktseite `/pakete/{id}` mit seinem tatsächlichen Umfang (`offers.standalone_bundle`), eine Kachel im Shop und die Suche über die enthaltenen Artikel.
**Von mir gewählt, bitte bestätigen.**
- **Rechenregel:** Prozent je Position kaufmännisch gerundet; Festbetrag je Bestellung, höchstens bis zur Summe der betroffenen Positionen, anteilig zum Positionspreis verteilt (größter Rest zuerst). Gespeichert werden Listenpreis und Rabatt je Position, Zwischensumme, Rabatt, Zahlbetrag und ein Abzug des Codes zum Bestellzeitpunkt. Stripe erhält je Position den Preis nach Rabatt, damit der Betrag bei Stripe dem gespeicherten Zahlbetrag entspricht.
- **Mindestzahlbetrag 0,50 €** mit Rabatt (Mindestbetrag der Kartenzahlung); ein 100-Prozent-Code ist beim Start nicht möglich.
- **Freigabe mit optionalem Ende** („solange … Freigabe gültig“); Pflege durch Katalogverwalter und Kundenbetreuung.
- **Kauf auf Rechnung** für Organisationen: Bestellung mit Zahlungsweg „Rechnung“, Betreiber erstellt die Rechnung manuell und bestätigt den Zahlungseingang in der Bestellverwaltung; erst danach Freischaltung. Mitglieder können das nicht selbst auslösen.
- **Widerruf:** Das Mitglied erklärt ihn (Datum, Anmerkung); die Erklärung entzieht nichts. Der Betreiber prüft (bei sofortiger Bereitstellung mit ausdrücklicher Zustimmung kann das Recht erloschen sein) und erstattet in der Bestellverwaltung vollständig; bei Stripe wird zuerst die Rückzahlung bei Stripe veranlasst, erst bei Erfolg werden Rechte entzogen. Die Selbstbedienungs-Erstattung gibt es nur im Testzahlungsweg.
- **Pflichtangaben:** Schaltfläche „Zahlungspflichtig bestellen“, zwei Zustimmungen (AGB und Lizenzbedingungen; ausdrücklicher Wunsch nach sofortiger Bereitstellung mit Hinweis auf das Erlöschen des Widerrufsrechts) als Pflichtfelder, serverseitig geprüft und mit Wortlaut, Fassung (`SalesTerms::VERSION`) und Seitenständen an der Bestellung festgehalten; Vertragsbestätigung per Mail mit Nutzerkreis, Rabatt und Zustimmung. **Der Wortlaut ist ein Entwurf und rechtlich nicht geprüft.**
- **Produktivfreigabe** nur mit `SHOP_LIVE_RELEASE=true` in `/etc/luf/prod.env`, Zahlungstreiber `stripe`, Live-Schlüssel und veröffentlichten Rechtstexten (`Shop::live()`); standardmäßig aus. Ohne sie bleibt der Shop in Produktion abgeschaltet und Stripe lehnt dort jeden Aufruf ab. Außerhalb der Produktion bleiben Live-Schlüssel verboten.
**Offene Fachfrage mit Rechenbeispiel (nicht entschieden, siehe auch `13_Risiken_Annahmen_offene_Entscheidungen.md`).**
1. *Rundung.* Drei Positionen zu je 0,99 €, Code 50 %. Je Position gerundet: 3 × 0,50 € = 1,50 € Rabatt, Zahlbetrag 1,47 €. Auf der Warenkorbsumme gerundet: 2,97 € × 50 % = 1,485 € → 1,49 € Rabatt, Zahlbetrag 1,48 €. Heute gilt die Rundung je Position. Welche gilt rechtlich und buchhalterisch?
2. *Verteilung eines Warenkorbrabatts bei späterer Einzelrückgabe.* Warenkorb Position A 60,00 € und B 40,00 €, Festbetrag 10,00 € (Zahlbetrag 90,00 €). Heute verteilt das System anteilig (A 6,00 €, B 4,00 €). Gäbe der Käufer später nur B zurück: Erstattung 36,00 € (anteilig), 40,00 € (voller Listenpreis, der Rabatt bliebe auf A) oder 30,00 € (B trägt den Rabatt zuerst ab)? Zum Start gibt es nur die Vollerstattung der Bestellung (90,00 €) und Bundles als Einheit; die Frage wird mit freiwilligen Teilerstattungen (A2) relevant. Die Daten (Rabatt je Position) liegen vor.
3. *Rabatt und Steuer.* Wie der Rabatt in der Rechnung auf Steuersätze verteilt wird, hängt am Steuerstatus (OPEN-06).
**Folgen.** Neue Tabellen und Spalten sind rein ergänzend; bei einem Code-Rollback bleiben sie liegen. **Vor einem Rollback offene Bestellungen mit Rabatt oder Rechnungsweg prüfen**: der alte Code kennt den Rabatt nicht und würde den Listenpreis gegen den Zahlbetrag prüfen.
**Quelle.** Auftrag „Shop bis zum Verkaufsstart in Deutschland“; PAY-006 bis PAY-009, ID-004, FACH-14, FACH-59; ADR-42, ADR-45, ADR-46.
@@ -123,7 +123,7 @@ ## 4. Offene fachliche Entscheidungen
| E-23 | Organisationskauf | Verkauf an Organisationen gehört zum bestätigten Käuferkreis. Vor dem ersten Verkauf vorbereiten, welche Angebote einer Organisation als Inhaberin zugewiesen werden und welche Verwaltung dafür benötigt wird. | Erwerb für Organisation mit Sitzpool, falls das Angebot Sitze umfasst | vor dem ersten Organisationsverkauf |
| E-24 | Community-Produkt und Betriebsform (selbst betrieben oder gehostet) | `10`, Abschnitt 4 | ADR-12 | vor A3, nach dem kleinen Nachweis aus `10`, Abschnitt 11 Nr. 2 |
**Vor dem Verkaufsstart zu klären:** Steuer- und Belegdetails (OPEN-06), Bedingungen und Preise der Startangebote (OPEN-03), der konkrete Widerrufsprozess (E-11) und Wiederherstellungsziele (E-22). Rabattformeln und die Verteilung etwaiger Bestellrabatte auf Positionen sind zu konkretisieren. Der Käuferkreis (E-09) ist entschieden.
**Vor dem Verkaufsstart zu klären:** Steuer- und Belegdetails (OPEN-06), Bedingungen und Preise der Startangebote (OPEN-03), der konkrete Widerrufsprozess (E-11) und Wiederherstellungsziele (E-22). Rabattformeln und die Verteilung etwaiger Bestellrabatte auf Positionen sind zu konkretisieren (umgesetzte Regel und Rechenbeispiele zur Entscheidung: ADR-47). Der Käuferkreis (E-09) ist entschieden.
## 5. Wie weit trägt die technische Planung ohne die Geschäftsentscheidungen?
+2 -1
View File
@@ -225,7 +225,8 @@ ### Shop-Abnahme
| Identische Lizenz bereits erworben | Hinweis und Entfernen bleiben sichtbar. Die Position fehlt in Kaufsumme und Bestellung. Der Rest ist weiterhin kaufbar. Ein Bundle mit zusätzlichem Inhalt bleibt kaufbar und wird als Einheit behandelt. | Testkauf |
| Testzahlung scheitert, wird abgebrochen oder wiederholt bestätigt | Ohne bestätigte Zahlung keine Auslieferung. Nach erfolgreicher Bestätigung entstehen Rechte für alle Bestellpositionen, genau einmal je Erwerbsquelle. | Testkauf |
| Lizenzoption im bestehenden Arbeitsplatz bearbeiten | Maske ist vorbelegt, Preis erscheint in Euro, Abbrechen verwirft Eingaben. Bei Aktivierung wirkt die Änderung für diese Option. Andere Optionen bleiben kaufbar. | Testkauf |
| Allgemeiner oder produktspezifischer Rabattcode | Ein Code je Bestellung; nur passender Geltungsbereich; berechtigtes Konto kann gemeinsamen Zertifizierungscode erneut verwenden | Verkaufsstart |
| Allgemeiner oder produktspezifischer Rabattcode | Ein Code je Bestellung; nur passender Geltungsbereich; berechtigtes Konto kann gemeinsamen Zertifizierungscode erneut verwenden. Wer den Code kennt, aber keine Freigabe für genau diesen Code hat, erhält keinen Rabatt. Prüfung bei Einlösung und vor Bestellabschluss, Zahlbetrag in Bestellung und bei Stripe gleich. (umgesetzt, ADR-47; Abnahme in `etappe-1.md`) | Verkaufsstart |
| Einzel- und Mehrfachlizenz unterscheiden | Nutzerkreis (ein Trainer oder festgelegte Zahl) auf Produktseite und in der Bestellung; mit den Konditionen gespeichert; unabhängig von Zweck, Preis, Lizenzinhaber und Downloadkonto (umgesetzt, ADR-47) | Verkaufsstart |
| Vereinsrechnung bezahlen | Rechte bis zur bestätigten Überweisung gesperrt, danach Vergabe aus Bestellung | Verkaufsstart |
| Vereins-Mehrfachlizenz erwerben | Verein als Lizenzinhaber und bestellendes Profil getrennt festgehalten. Nur dieses Profil erhält nach Testzahlung Downloadzugriff aus der Bestellung. Mit einem zweiten Konto desselben Vereins ist auch der direkte Abruf aus dieser Bestellung nicht möglich. | Testkauf |
| Vollerstattung und Bundle-Rückgabe | Rechte der betroffenen Erwerbe entzogen; andere Quellen weiterhin wirksam; Bundle als Einheit | Verkaufsstart |
+1 -1
View File
@@ -123,7 +123,7 @@ ## 9. Website-Gerüst (Designiteration 1)
- **Wortmarke**: freigegebene Lara-&-Felix-Wortmarke (Kompaktfassung) als Bild mit festen Maßen im Markup; die Breitenmessung der Navigation stimmt dadurch schon vor dem Laden des Bildes.
- **Kopfzeile, zwei Zustände ohne Layoutsprung.** (Maße seit ADR-44 aus dem Basiswert „Höhe der Kopfzeile“, Standard 80: Box 80 px ab 75 rem, sonst 64 px, kompakte Leiste 64 px, Wortmarke im Ausgangszustand 1,25-fach; die folgenden Pixelangaben nennen den Stand vor ADR-44.) Die Box ist immer `--header-height-initial` hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand (`top: kompakt − initial`). Die innere Leiste (`.site-header-bar`, 72 px) klebt oben. Beim Scrollen wandert sie 16 px nach oben und bleibt dann stehen; der Seitenfluss ändert sich nie. Ein Beobachter (`data-site-header-sentinel`) setzt `.is-compact`: Wortmarke von 1,16-facher auf normale Größe (nur `transform`) und Schatten. Unter `prefers-reduced-motion` ohne Übergang. Ohne JavaScript klebt die Kopfzeile genauso; nur die Wortmarke bleibt groß.
- **Breitenstufen der Navigation** (`site-nav.js`, Messung an einer unsichtbaren Kopie): 1. Navigation und Kontozugang mit Beschriftung in einer Zeile; 2. sonst Kontozugang nur als Symbol (`.is-account-compact`); 3. sonst und immer unter 75 rem Menümodus (`.is-menu-mode`). Die Navigation bricht nie um; deshalb ist die Kopfzeile auf allen Seiten gleich hoch, unabhängig von Anzahl und Länge der CMS-Einträge. Die Messung steht inline direkt nach der Kopfzeile (`window.lufHeaderMode`) und setzt die Stufe vor dem ersten Zeichnen; `site-nav.js` wiederholt sie bei Größenänderungen und nach dem Laden der Schriften.
- **Breitenstufen der Navigation** (`site-nav.js`, Messung des echten Platzbedarfs der Einträge): 1. Navigation und Kontozugang mit Beschriftung in einer Zeile; 2. sonst Kontozugang und Warenkorb nur als Symbol (`.is-account-compact`); 3. sonst zusätzlich engere Navigation mit kleinerem Abstand und Schrift (`.is-nav-tight`); 4. sonst und immer unter 75 rem Menümodus (`.is-menu-mode`). Auf dem Desktop steht die Navigation damit offen, der Burger ist dort nur die letzte Stufe (Stand 2026-11-22: luf-test mit 8 Einträgen offen ab 1280 px, bei 1200 px Menümodus). Die Navigation bricht nie um; deshalb ist die Kopfzeile auf allen Seiten gleich hoch, unabhängig von Anzahl und Länge der CMS-Einträge. Die Messung steht inline direkt nach der Kopfzeile (`window.lufHeaderMode`) und setzt die Stufe vor dem ersten Zeichnen; `site-nav.js` wiederholt sie bei Größenänderungen und nach dem Laden der Schriften.
- **Hauptnavigation**: aus `navigation_items` (`header`), aktiver Eintrag mit gelber Markenunterstreichung und `aria-current`, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit `aria-expanded`, Escape schließt, Klick außerhalb schließt).
- **Menümodus**: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche direkt unter dem sichtbaren Teil der Kopfzeile, 48 px hohe Einträge, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator läuft im Kreis zwischen Schaltfläche und Einträgen, Escape schließt und gibt den Fokus zurück. Keine untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation unter 75 rem als umbrechende Liste sichtbar.
- **Kontozugang** „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet) und vorbereiteter Warenkorbzugang (`config/cms.php` → `cart.enabled`, Vorgabe aus: es wird nichts ausgegeben).
+21 -1
View File
@@ -61,7 +61,7 @@ ## Stripe-Sandbox (nur Test, Etappe 1)
**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.
**Grenzen (Stand Etappe 1; die Erstattung ist seit dem Verkaufsstart-Stand vorbereitet, siehe „Verkaufsstart: Freigabe und Betrieb“):** Erstattungen liefen 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 |
@@ -142,3 +142,23 @@ ## Annahmen und offene Punkte
- **Queue:** Datenbank-Queue (`QUEUE_CONNECTION=database`), kein Redis. Reicht für den Start. Der Worker erlaubt einem Auftrag bis zu einer Stunde (`--timeout=3600`). Das App-Image enthält `ffmpeg`. Die Queue leitet daraus Vorschaubilder und, wenn die Datei lesbar ist, drei HLS-Qualitätsstufen nach `derived/` ab. Fehlt die Ableitung, bleibt die gespeicherte Datei über den bisherigen berechtigten Abruf lesbar. Der Web-Prozess schreibt diese Ableitungen nicht.
- **Gate vor Prod:** Merge-Schutz ist eine Gitea-Einstellung und gehört nicht in die Workflows.
- **Umzug Test auf den Pi:** Werte oben in `deploy-test.yml` ändern (Label `ubuntu-latest`, Guard auf `raspberrypi5`/`aarch64`, Pfade, Port). Das Dockerfile baut auch für ARM64. Vorher Speicherlage auf dem Pi klären.
## Verkaufsstart: Freigabe und Betrieb (Stand 24.11.2026, vorbereitet, nicht freigegeben)
Die Produktivfreigabe liegt bei Lars. Der Code enthält sie nicht; er erlaubt sie nur, wenn **alle** Bedingungen erfüllt sind (`App\Domain\Commerce\Shop::live()`):
| Bedingung | Wo gesetzt |
|---|---|
| `SHOP_LIVE_RELEASE=true` | `/etc/luf/prod.env` (Standard: aus; nie im Repository) |
| `PAYMENT_DRIVER=stripe` | `/etc/luf/prod.env` |
| `STRIPE_SECRET=sk_live_…` (Live-Schlüssel; in Produktion sind Testschlüssel nie live, außerhalb der Produktion sind Live-Schlüssel verboten) | `/etc/luf/prod.env` |
| `STRIPE_WEBHOOK_SECRET` des Live-Endpunkts, Adresse `https://lara-und-felix.de/stripe/webhook` (Ereignisse mindestens `checkout.session.completed`, `checkout.session.expired`, `checkout.session.async_payment_succeeded`, `checkout.session.async_payment_failed`) | `/etc/luf/prod.env`, Stripe-Dashboard |
| Veröffentlichte CMS-Seiten `/agb`, `/lizenzbedingungen`, `/widerruf`, `/impressum`, `/datenschutz` | Webpräsenz (Redaktion, Text von der Rechtsberatung) |
Weitere Einstellungen: `SHOP_INVOICE` (Standard an: Kauf auf Rechnung für Organisationen), `SHOP_PRICE_NOTE` (Preis- und Steuerhinweis im Warenkorb, Standard „Alle Preise in Euro.“), `STRIPE_TAX_RATE_ID` (im Preis enthaltener Steuersatz; Steuerstatus offen, OPEN-06). Die Verwaltungsseite **Verkauf → Verkaufsstart** zeigt den Zustand ohne Schlüssel.
- **Erstattung bei Stripe:** `Checkout::refund` ruft vor dem Entzug der Rechte `POST /v1/refunds` (Vollbetrag, Idempotenzschlüssel `luf-refund-<Bestellung>-<Zahlung>`) auf; schlägt das fehl, bleibt die Bestellung unverändert. Dafür muss der API-Schlüssel das Recht „Refunds: write“ haben (bei eingeschränktem Schlüssel `rk_…` prüfen). Die Zahlungsabsicht (`payment_intent`) wird aus der signierten Meldung gespeichert, sonst bei Stripe abgefragt.
- **Rechnungsweg:** Vereine bestellen „auf Rechnung“; der Betreiber erstellt die Rechnung manuell und bestätigt den Zahlungseingang unter **Verkauf → Bestellungen**.
- **Migration** `2026_11_24_100000_add_discounts_licence_scope_and_sales_start`: rein ergänzend (neue Tabellen `discount_codes`, `discount_code_targets`, `discount_code_releases`; neue Spalten an `offers`, `offer_versions`, `orders`, `order_lines`, `payments`). Nichts wird gelöscht oder umbenannt.
- **Rollback:** setzt nur den Code zurück. Der frühere Code kennt Rabatt und Rechnungsweg nicht; vorher offene Bestellungen mit Rabatt oder Zahlungsweg „Rechnung“ stornieren oder abwickeln.
- **Was vor der Freigabe fehlt (Lars bzw. Rechtsberatung):** finale Texte (AGB, Lizenzbedingungen je Zweck, Widerrufsbelehrung samt Muster-Widerrufsformular, Impressum, Datenschutzerklärung), Prüfung des Wortlauts der Zustimmungen im Checkout (Entwurf `2026-11-24-entwurf`), Steuerstatus und Belegangaben (OPEN-06, E-11: Rechnungsvorlage mit Pflichtangaben, Rechnungsnummernkreis, Steuerausweis), Live-Stripe-Konto mit Webhook, Aufbewahrungsfristen (E-16), Auftragsverarbeitung mit Stripe, ein gesondert beauftragter Sicherheitstest (16, Abschnitt 6.3).
@@ -207,7 +207,7 @@ ## 8. Verkauf, Zahlung und Freischaltung
**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-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. Der Geltungsbereich eines Codes (Warenkorb oder ausgewählte Ziele) und seine Einlösungsberechtigung (allgemein oder freigeschaltete Konten) sind unabhängige Einstellungen; eine Freigabe gilt nur für den jeweiligen Code. Einzel- und Mehrfachlizenz (Nutzerkreis je Lizenzoption) sind seit ADR-47 umgesetzt.
**PAY-009 [ZU KLÄREN]** Rechnungs- und Steuerdetails, Preisgestaltung, genaue Rabattberechnung sowie die rechtliche und operative Ausgestaltung des Widerrufs vor dem Verkaufsstart.
@@ -0,0 +1,5 @@
# Abnahmebilder auf luf-test (23.11.2026)
Aufgenommen mit Chromium gegen `https://dev.laraundfelix.de` (Stand `develop` Lauf 5048) mit einem Mitgliedskonto des Betreibers, nur lesend (kein Speichern von Profil-, Passwort- oder Adressdaten). Echte Fachobjekte: Programm Abstand, Modul Hilfe, Film „Lara im Park“ (HLS), Trainerunterlage. Geprüft: Film startet (HLS, Wiedergabezeit 5 s), Download heißt „Lara im Park.mp4“, Profil mit vier Blöcken, Fußzeile mit Impressum und Datenschutz (beide Seiten erreichbar), Lizenzdetail mit Hinweis zu Einzel-/Mehrfachlizenz, Smartphone ohne waagerechten Überlauf.
`20` Start, `21` Bibliothek, `22` Film, `23` Profil, `24` Lizenzen, `25` Lizenzdetail (Desktop); `30`–`33` Smartphone.
Binary file not shown.

After

Width:  |  Height:  |  Size: 282 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 370 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 933 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 206 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 562 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 216 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 163 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 220 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 118 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 738 KiB

@@ -0,0 +1,20 @@
# Abnahmebilder Mitgliederbereich (lokal, Demodaten)
Aufgenommen am 22.11.2026 mit Chromium gegen die lokale Anwendung (Stand `2e6260a`, SQLite, `ShopDemoSeeder`), **nicht auf luf-test**. Die Demodaten haben keine Vorschaubilder und keine Mediendateien: Karten zeigen den Platzhalter, der Player ist leer. Konten: Tina (zwei Lizenzen), Max (keine Lizenz). Breiten: `desktop` 1280 px, `mobil` 390 px. In ganzseitigen Aufnahmen steht die untere Leiste mitten im Bild; sie klebt am Fensterrand.
| Nr. | Ansicht |
|---|---|
| 01 | Startseite |
| 02 | Meine Bibliothek, alle Inhaltsarten |
| 03 | Programme |
| 04 | Meine Lizenzen |
| 05 | Programm mit Struktur |
| 06 | Film im Zusammenhang mit Begleitmaterial |
| 07 | Lizenzdetail |
| 08 | Bibliothek gefiltert auf Filme |
| 09 | Startseite ohne Lizenz (Leerzustand) |
| 10 | Programm ohne Berechtigung (alle Teile „Nicht enthalten“) |
| 11 | Film ohne Berechtigung (HTTP 403, keine Medienadresse) |
| 12 | Lizenzen ohne Lizenz |
Die Entwürfe liegen unter `docs/Brand-UI-Kit/14_mitgliederbereich_v2.0/01_freigegebene_entwuerfe/`.
Binary file not shown.

After

Width:  |  Height:  |  Size: 215 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 202 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 153 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 203 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 117 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 141 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 179 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 90 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 165 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 133 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 153 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 104 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 114 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 103 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 93 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

@@ -0,0 +1,73 @@
# Mitgliederbereich nach Brand-UI-Kit 14 – Abschlussbericht
Stand: 22.11.2026. Branch `feature/mitgliederbereich-v2`, auf `develop` (Test) gemergt. Entscheidung: ADR-45. **Technisch fertig, nicht vom Betreiber abgenommen. Nicht auf `luf-test` mit einem Mitgliedskonto durchgespielt (siehe 5 und 7).**
Referenz: `docs/Brand-UI-Kit/14_mitgliederbereich_v2.0/` (Entwürfe, Handoff, Implementierungsbrief; liegt im Hauptverzeichnis ungetrackt und wurde nicht committet). Die Entwürfe geben Richtung und Hierarchie vor, keine Pixel, Daten oder Rechte.
## 1. Überarbeitete Ansichten
| Ansicht | Adresse | Inhalt |
|---|---|---|
| Rahmen | alle `/bereich/…` | Kopfzeile mit freigegebener Wortmarke, Meine Bibliothek, Programme, Meine Lizenzen, Konto-Menü (Profil, Angebote, Abmelden); untere Leiste unter 56 rem |
| Startseite | `/bereich` | Begrüßung, Suche, Inhaltsart-Chips, „Meine Programme“, Schnellzugriff mit Zahlen je Art, Lizenzhinweis; Leerzustand ohne Inhalte |
| Bibliothek | `/bereich/bibliothek` (`?art=`) | Suche, aufklappbarer Filter (Säulen, Dimensionen, Verfügbarkeit), Inhaltsart mit Zahlen, Sortierung, Karten für Programme, Module, Filme, Materialien; Treffer- und Leerzustände |
| Programm und Modul | `/bereich/bibliothek/programm/{id}` | Kopf mit Kennzahlen, Überblick, Lernziele, geordnete Struktur mit Verschachtelung, Einsatz und Vorbereitung; Abschnitte nur mit Daten |
| Film und Material im Zusammenhang | `/bereich/bibliothek/programm/{id}/inhalt/{version}` (neu) | Player, Vollbild, Herunterladen nur mit Recht, Kurzbeschreibung, Begleitmaterial, Weg zurück zu Modul und Programm |
| Einzelartikel | `/bereich/bibliothek/{artikel}` | Wie bisher, im neuen Rahmen, mit getrennter Ansicht- und Downloadentscheidung |
| Meine Lizenzen | `/bereich/berechtigungen` | Aktiv, Inaktiv, Alle; je Berechtigung Herkunft, Zweck, Aktionen, Zeitraum, Zustand |
| Lizenzdetail | `/bereich/berechtigungen/{grant}` (neu) | Umfang, Nutzungsrechte, Herkunft und Zeitraum, Einschränkungen |
| Angebote, Bestellung, Profil, Lesen | bestehende Adressen | Neuer Rahmen und Kopfbereich, Funktionen unverändert |
`/bereich/materialien` leitet auf den Filter `?art=material` um; `/bereich/bibliothek/module` und `/programme` bleiben.
## 2. Verwendete Bausteine und Größeneinstellungen
- **Kit und Website:** Wortmarke `<x-site.brand variant="logo">`, Markenakzent `<x-brand.underline>`, Schaltflächen `.button`, `.button-secondary`, Meldungen `.status`/`.errors`, Formular `.form`, Heroicons. Neue Komponenten: `x-member.hero|card|type|status` und `resources/css/components/lf-member.css`. Die Verwaltungsvorschau der Bibliothekskarte nutzt dieselbe `x-member.card`.
- **Größen:** ausschließlich Tokens der Skala (ADR-44): `--text-h1|h2|h3|body|small|lede|button`, `--space-*`, `--pad-card`, `--grid-gap`, `--touch-target`, `--header-height`, `--width-standard`, `--gutter`, `--radius-*`. Neu ist nur das abgeleitete Token `--card-min` (80 % von `--ds-media`). Kein neuer Basiswert, kein `--ds-*` verändert. Karten- und Listentext sind `--text-small`, Kartentitel `--text-h3`: dichter als die Website, Trefferflächen bleiben 44 px.
- **Abweichungen von den Entwürfen:** keine Fotos (nur freigegebene Vorschaubilder der Fachobjekte, sonst Platzhalter mit Inhaltsart); Kopfbereich ohne Blattmotiv; kein Hamburger-Menü (doppelte Navigation), das Konto-Menü bleibt; kein „Programm starten“, keine Zähler je Filterwert, kein Karten-/Listenwechsel, kein „Zuletzt genutzt“, kein Dokumentenreiter „Lizenzbedingungen (PDF)“ (alles ohne Datenbasis).
## 3. Erhaltene und ergänzte Funktionen
Erhalten: Anmeldung, Sitzung, Rollen, Medienwege (signierte Routen, `DecideAccess`, `DeliveryLog`), Lizenzzuordnung, Angebote, Bestellung, Profil, Routen und Routennamen (`member.*`). Keine Migration, kein neues Datenmodell.
Ergänzt: Inhaltsart-Filter, Sortierung, Suche auch in Suchbegriffen, programmübergreifende Medienliste mit „Verwendet in“, Kontextseite für Film und Material, getrennte Downloadentscheidung bei Begleitmaterial und Artikeln, Lizenzdetail, Inaktive Lizenzen, Zustand nach `DecideAccess`-Regel, Anzeigetexte aus der Fachverwaltung (Kontext „Mitgliederbibliothek“).
## 4. Abhängigkeiten zur Fachverwaltung
1. **Anzeigetexte:** Titel, Kurzbeschreibung und Beschreibung kommen aus `EditorialProfileReader` (Kontext „Mitgliederbibliothek“). Pflegt die Verwaltung dort nichts, gelten zentrale Angaben, zuletzt die interne Bezeichnung.
2. **Vorschaubilder:** `member.thumbnail` erlaubt nur Wurzel-Kompositionen und Medien im Artikelstand einer Berechtigung. Verschachtelte Module haben deshalb keine eigenen Karten- oder Zeilenbilder (Platzhalter). Eine Erweiterung wäre eine bewusste, getestete Änderung der Bildfreigabe.
3. **Zielgruppe, Altersbereich:** Es gibt kein eigenes Feld. Sie erscheinen nur als Filterwerte der gepflegten Fachdimensionen, nicht auf Karte oder Detail. Zeitbedarf nur, wenn die Fassung ihn trägt.
4. **Inhaltsart „Modul“:** Module sind Kompositionen mit Inhaltsart `modul`; alles andere zählt als Programm.
5. **Sortierung „Neueste“:** Es gibt kein belastbares Datum der Bibliotheksaufnahme. Angeboten werden Reihenfolge der Lizenzen und Titel A–Z.
6. **Mitglieder-Anzeigefreigabe:** unverändert `CompositionDisplayRelease`; nicht freigegebene Fassungen erscheinen weder in der Liste noch als Programmseite (404).
## 5. Browser- und Testergebnisse
- **Automatisiert:** 591 Tests grün (`php artisan test`), Pint auf `app tests config database routes` ohne Befund, `npm run build` ohne Fehler. Neu: `tests/Feature/MemberAreaV2Test.php` (16 Tests). Gitea: `feature/mitgliederbereich-v2` und der Merge auf `develop` (Lauf 5044) erfolgreich.
- **Bewusst geänderte Bestandstests** (Begründung im Commit): Film spielt auf der Kontextseite statt eingebettet; Download-Links tragen ein Symbol (Zählung per `Laden</a>`, ein vakuöses `assertDontSee` wurde dabei mitgeführt); Platzhalter ist ein dekoratives Element; Wortmarke ist das freigegebene Logo; Begrüßung „Willkommen zurück“; Verwaltungsvorschau prüft `mb-card`.
- **Browser (Chromium, lokal, Demodaten des `ShopDemoSeeder`, Test- und Berechtigungskonten):** Szenarien 1 bis 10 durchgespielt: Anmeldung und Start, Bibliothek mit Filter und Inhaltsart, Programm, Kontextseite des Films, Begleitmaterial, Rückweg, Lizenzliste und -detail, Konto ohne Lizenz (Programm sichtbar, alle Teile „Nicht enthalten“, Kontextseite 403 ohne `<video>` und ohne Medienadresse). Desktop 1280 px und Smartphone 390 px, Bilder in [abnahme/](abnahme/).
- **Skriptprüfung (59 Prüfpunkte, 57 bestanden):** Konto-Menü per Tastatur (Enter, Fokus ins Menü, Escape mit Fokusrückgabe, Klick außen), Sprunglink als erster Tabstopp, genau eine `h1` je Seite, kein waagerechtes Scrollen bei 320, 390 und 768 px, Trefferflächen mindestens 44 px, `prefers-reduced-motion` im Kontext gesetzt. Zwei Prüfpunkte sind keine Befunde: „Fokus sichtbar“ traf das Suchfeld, dessen Fokusring der Rahmen `.mb-search:focus-within` zeigt; „Textgröße 200 %“ war methodisch ungültig (Media-Queries folgen einer per CSS überschriebenen Schriftgröße nicht), die schmalen Breiten decken den Fall ab.
- **Nicht durchgeführt:** Durchlauf als Mitglied auf **luf-test**. Es gibt dort kein bekanntes Mitgliedskonto mit Lizenzen. Ein Prüfkonto über das Registrierungsformular anzulegen und den Bestätigungslink aus dem Container-Protokoll zu lesen, wurde von der Berechtigungsprüfung abgelehnt und nicht umgangen. Geprüft ist nur, dass `https://dev.laraundfelix.de` die neuen Stile ausliefert (`mb-header-inner`, `--card-min` im ausgelieferten Stylesheet) und `/up`, `/anmelden`, `/registrieren` antworten.
## 6. Sicherheits- und Berechtigungsprüfungen
- Jede Wiedergabe-, Ansicht- und Downloadadresse entsteht nur nach `DecideAccess` je Aktion; die Medienrouten sind unverändert (`signed:relative`, Leser-Prüfung, `DeliveryLog`).
- Tests: Streamen erlaubt und Laden verweigert (kein Download-Link, Hinweis, erratene signierte Adresse ergibt 403); Konto ohne Recht erhält 403 ohne Medienadresse; Stelle außerhalb des Programms 404; nicht freigegebenes Programm 404; Gäste werden zur Anmeldung geleitet; fremde Berechtigung 404 (kein Einblick in andere Konten); widerrufene, abgelaufene und noch nicht gültige Berechtigungen erscheinen als inaktiv und öffnen nichts; zwei Berechtigungen mit unterschiedlichem Zweck bleiben zwei Einträge ohne kombinierte Rechte; die Lizenzseite zeigt weder erfundene Lizenzbedingungen noch Preise.
- Keine Dateipfade in Seiten (Test), Originale nie öffentlich verlinkt.
## 7. Verbleibende Einschränkungen und Entscheidungen für Lars
1. **luf-test-Durchlauf offen.** Dafür braucht es ein Mitgliedskonto mit Lizenzen auf der Testinstanz (z. B. `ShopDemoSeeder` durch Lars, oder ein freigegebenes Prüfkonto) oder die Freigabe, ein Konto über die Registrierung anzulegen.
2. **Ansprache:** Die überarbeiteten Seiten sagen „du“ (Entwürfe, Shop). Anmeldung, Registrierung und viele Systemmeldungen sagen „Sie“. Eine einheitliche Regel fehlt; der Wechsel ist reine Textarbeit in den Views.
3. **Player nicht mit echtem Film geprüft:** Lokal gab es keine Mediendateien; die Wiedergabe (HLS) selbst ist unverändert, das Layout des Players mit Platzhalter geprüft.
4. **Bilder:** Die Karten mit echten Vorschaubildern sind nur per Test geprüft, nicht visuell.
5. **Kein „Zuletzt genutzt“, keine Favoriten**: Es gibt keine Nutzungshistorie. Falls gewünscht: eigene, schlanke Ergänzung (z. B. Tabelle „zuletzt geöffnet“ je Konto), ausdrücklich zu beschließen.
6. **Zahlen je Filterwert, Karten-/Listenwechsel, Lizenzbedingungen als Dokument** fehlen mangels Datenbasis bzw. Beschluss.
7. **Dokumentenansicht:** „Ansehen“ liefert die Datei oder den Text über den bestehenden Weg; eine eingebettete Dokumentvorschau gibt es nicht.
8. **Größenskala:** Die Verwaltung („Website → Design → Größen“) wirkt jetzt auch auf den Mitgliederbereich; ein hoher Fließtext-Wert vergrößert Karten (`--card-min` folgt `--ds-media`, nicht dem Fließtext).
## 8. Commit- und Deploymentstand
- `2e6260a` Gestalte den Mitgliederbereich nach Brand-UI-Kit 14 neu; `0c4ef4c` Dokumentation und Absicherung; Merge `8b64429` auf `develop`.
- Gitea: Lauf 5042 (Feature-Branch) und 5044 (`develop`, Tests und Deploy Test) erfolgreich. Nichts nach `main`, keine Produktivsetzung, kein Eingriff auf den Servern.
- Abnahmebilder und dieser Bericht kamen nachträglich auf `develop` (Docs-Commit).
@@ -0,0 +1,29 @@
# Mitgliederbereich – Nachbesserung 23.11.2026
**Belegt auf luf-test** (Konto des Betreibers, nur lesend): Film startet über HLS, Download heißt „Lara im Park.mp4“, Profil, Fußzeile (Impressum und Datenschutz erreichbar), Lizenzdetail; Bilder in [abnahme-luftest/](abnahme-luftest/). Nicht auf luf-test geprüft: das Speichern von E-Mail, Passwort und Rechnungsadresse (würde Daten des Betreiberkontos ändern; durch 14 Tests abgedeckt) und der Versand der Bestätigungsmail (Mail-Treiber der Testinstanz ist `log`).
Befunde aus der ersten Sichtung auf luf-test und ihre Behebung. Entscheidung zum Profil: ADR-46.
| Befund | Ursache | Behebung |
|---|---|---|
| Filme starten nicht, nur das Vorschaubild steht groß da | `resources/js/app.js`: Der Anfangsscan ruft `scanPlayback(document)` auf, `document` ist aber kein `Element` und wurde übersprungen. HLS-Filme (`data-hls`) im Quelltext der Seite wurden deshalb nie an hls.js angebunden. Dateifilme (`src`) spielten, daher fiel es lokal mit Dateidaten nicht auf. Der Fehler ist älter als der Umbau (gleicher Scan vorher), trat aber erst jetzt sichtbar auf, weil die Seiten Filme jetzt als HLS ausliefern. | Der Scan akzeptiert auch das Dokument. Zusätzlich findet der Vollbild-Knopf sein Video jetzt auch, wenn er neben dem Player steht. Nachgewiesen lokal mit echtem HLS (ffmpeg-Ableitung): Manifest, Segmente, Wiedergabe; und auf luf-test (siehe unten). |
| Download heißt immer `laden.mp4` | Die Antwort setzte `Content-Disposition: attachment` ohne Dateinamen; der Browser nahm das letzte Adressstück („laden“) plus Endung. | Der Name entsteht aus dem Anzeigetitel (Mitgliedertext, sonst Arbeitstitel) plus Endung der Datei, z. B. `Lara im Park.mp4`. Unzulässige Zeichen entfallen, Umlaute bleiben (UTF-8-Dateiname mit ASCII-Rückfall). Gilt auch für „Ansehen“ (Speichern unter). Ein eigenes Feld „Dateiname“ im Medienmanager gibt es nicht; es wäre eine Erweiterung (eine Spalte am Medium und ein Feld in der Verwaltung). |
| Profil nicht konfigurierbar | Es gab nur den Namen. | Vier Blöcke mit eigener Speicherhandlung: Name; E-Mail-Adresse (neue Adresse gilt erst nach Bestätigungslink an sie, bisherige Adresse bekommt einen Hinweis, aktuelles Passwort nötig, Änderung verwerfbar); Passwort (bisheriges Passwort nötig, Regeln wie bei der Registrierung); Rechnungsadresse (Name oder Firma, Zusatz, Straße, PLZ, Ort, Land; eine je Lizenzinhaber). Neue Tabelle `billing_addresses` und Spalte `users.pending_email`, rein ergänzend. Die Adresse wird nur gepflegt; Bestellung und Rechnung kopieren sie noch nicht (Rechnungsstellung ist nicht gebaut). |
| Impressum und Datenschutz fehlen im Mitgliederbereich | Das Mitgliederlayout hatte keinen Fuß. | Kleine Fußzeile auf allen Mitgliederseiten. Links kommen aus der CMS-Navigation („Fußbereich: Rechtliches“ und „Fußbereich: Kontakt“); ist dort nichts belegt, gelten die veröffentlichten Seiten `/impressum` und `/datenschutz`, falls vorhanden. Es gibt keine fest codierten Texte. |
| Einzel- oder Mehrfachlizenz nicht erkennbar | Die Unterscheidung gibt es im System noch nicht (siehe unten). | Die Lizenzdetailseite sagt ausdrücklich, dass die Lizenz keine Angabe zur Nutzerzahl enthält, und wer Inhaber ist (Person oder Organisation). |
## Prüfung der Frage „Haben wir Einzel- und Mehrfachlizenz schon?“
**Stand 24.11.2026: Seit ADR-47 gibt es den Nutzerkreis je Lizenzoption (am Angebot, nicht am Rechteprofil), kopiert in Bestellung und Erwerb, sichtbar in „Meine Lizenzen“.** Der folgende Befund beschreibt den Stand vom 23.11.2026.
**Nein, nicht als Funktion.** Befund im Code und in den Dokumenten:
- `docs/architektur/05_Lizenz_und_Berechtigungslogik.md` §9 nennt „Einzel- und Mehrfachlizenz“ als vertraglichen Nutzungsumfang und Sitzzahlen (Beispiel „I-Stream-5, 5 Sitze“) als Option eines Rechteprofils. Sitzpools und Selbstverwaltung sind ausdrücklich „mit A4“ geplant, nicht gebaut. „Mehrfachlizenzen erzeugen zum Start keine weiteren Downloadkonten.“
- Ein Rechteprofil hat ein freies Feld `options` (JSON). Es wird in die Berechtigung kopiert und fließt in die Besitzprüfung ein, aber kein Wert ist definiert, und der Anlegedialog der Verwaltung bietet keine Option an. Eine Nutzerzahl gibt es nirgends.
- Vorhanden und sichtbar sind nur: Lizenzinhaber (Person oder Organisation, Vereinskauf), Nutzungszweck (ehrenamtlich, kommerziell, institutionell) und Fähigkeiten je Ausgabeklasse.
**Vorschlag (nicht umgesetzt, zu entscheiden):** Option `seats` (ganze Zahl; 1 = Einzellizenz, mehr = Mehrfachlizenz) im Rechteprofil, Eingabe im Anlegedialog, Anzeige in „Meine Lizenzen“ und in der Bestellübersicht. Der Wert wäre zunächst rein vertraglich (Anzeige, keine technische Sperre), weil Sitzzuweisung und gleichzeitige Wiedergaben A4 sind. Beim Kauf müsste der Wert in den Bestellumfang kopiert werden; `Checkout` kopiert `options` bereits, die Anzeige ist der kleinere Teil. Offen für Lars: Welche Stufen gibt es (Einzel, bis 5, bis 25 …), gelten sie je Konto, je Standort oder je Organisation, und ändert sich der Preis nur über getrennte Angebote?
## Zur Rechtslage (keine Rechtsberatung)
Ein Impressum (§ 5 DDG) muss für geschäftsmäßige Online-Angebote leicht erkennbar und unmittelbar erreichbar sein; Hinweise zum Datenschutz (Art. 13 DSGVO) müssen dort zugänglich sein, wo Daten erhoben werden, also auch im Konto und beim Bearbeiten von Rechnungsadresse und E-Mail. Die Fußzeile erfüllt das technisch auf allen Mitgliederseiten. Inhalt und Vollständigkeit der Seiten prüft Lars bzw. die Rechtsberatung. Zusätzlich wären zu klären: Hinweis auf Datenverarbeitung beim Profil (Zweck Rechnungsstellung), Löschung des Kontos und Datenauskunft, und beim Kauf Widerruf und AGB (siehe offene Punkte der Shop-Abnahme).
Loaded 100 of 183 files, more files were not shown because too many files have changed in this diff. Show more