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>
104 lines
2.8 KiB
PHP
104 lines
2.8 KiB
PHP
<?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',
|
|
};
|
|
}
|
|
}
|