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>
91 lines
3.3 KiB
PHP
91 lines
3.3 KiB
PHP
<?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)',
|
|
];
|
|
}
|
|
}
|