Files
laraundfelix/app/Domain/Entitlement/GrantIssuer.php
T
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

184 lines
7.0 KiB
PHP

<?php
namespace App\Domain\Entitlement;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Catalog\OfferStatus;
use App\Domain\Catalog\OfferVersion;
use App\Domain\Commerce\OrderLine;
use App\Domain\Identity\Party;
use App\Models\User;
use Illuminate\Support\Facades\DB;
class GrantIssuer
{
public function __construct(private readonly OfferService $offers) {}
public function claim(User $user, Offer $offer): Acquisition
{
$version = $this->offers->currentActiveVersion($offer);
if (! in_array($version->grant_kind, ['auf_abruf', 'bei_registrierung'], true)) {
throw new DomainRuleException('Dieses Angebot wird nicht frei vergeben.');
}
if ($version->holder_kind !== 'person') {
throw new DomainRuleException('Dieses Angebot richtet sich nicht an Personen.');
}
return $this->issue($user, $version, AcquisitionType::FreierAbruf, 'offer', $offer->id);
}
public function grantRegistrationOffers(User $user): void
{
OfferVersion::query()
->where('status', OfferStatus::Aktiv)
->where('grant_kind', 'bei_registrierung')
->where('holder_kind', 'person')
->orderByDesc('number')
->get()
->unique('offer_id')
->each(function (OfferVersion $version) use ($user): void {
$this->issue($user, $version, AcquisitionType::FreierAbruf, 'offer', $version->offer_id);
});
}
public function grantManually(User $user, Offer $offer, User $actor, string $reason): Acquisition
{
$reason = trim($reason);
if ($reason === '') {
throw new DomainRuleException('Eine manuelle Vergabe braucht eine Begründung.');
}
$version = $this->offers->currentActiveVersion($offer);
if ($version->holder_kind !== 'person') {
throw new DomainRuleException('Dieses Angebot richtet sich nicht an Personen.');
}
return DB::transaction(function () use ($user, $offer, $actor, $reason, $version): Acquisition {
$operation = ManualGrant::query()->create([
'actor_id' => $actor->id,
'party_id' => $user->party_id,
'offer_id' => $offer->id,
'reason' => $reason,
]);
return $this->issue($user, $version, AcquisitionType::ManuelleVergabe, 'manual_grant', $operation->id);
});
}
/**
* Freischaltung einer bezahlten Bestellposition aus deren festgehaltenem Umfang (Umfangskopie und Bedingungen der
* Position, nicht aus der Angebotsfassung). Inhaber ist der Lizenzinhaber der Position, das auslösende Konto wird
* am Erwerb festgehalten. Wiederholsicher: je Bestellposition genau ein Erwerb.
*/
public function issueFromOrderLine(OrderLine $line, Party $holder, User $actor): Acquisition
{
return DB::transaction(function () use ($line, $holder, $actor): Acquisition {
$existing = Acquisition::query()->where([
'party_id' => $holder->id,
'type' => AcquisitionType::Bestellposition,
'reference_type' => 'order_line',
'reference_id' => $line->id,
])->first();
if ($existing !== null) {
return $existing->load('grants');
}
$acquisition = Acquisition::query()->create([
'party_id' => $holder->id,
'type' => AcquisitionType::Bestellposition,
'reference_type' => 'order_line',
'reference_id' => $line->id,
'acting_user_id' => $actor->id,
'conditions' => [
'term_rule' => $line->term_rule,
'update_promise' => $line->update_promise,
'holder_kind' => $line->holder_kind,
'offer_version_id' => $line->offer_version_id,
'licence_scope' => $line->licence_scope,
'trainer_count' => $line->trainer_count,
'price_cents' => (int) $line->price_cents,
'discount_cents' => (int) $line->discount_cents,
],
]);
$line->loadMissing('scopeItems.article');
foreach ($line->scopeItems as $item) {
$acquisition->grants()->create([
'license_article_id' => $item->license_article_id,
'rights_profile_version_id' => $item->rights_profile_version_id,
'rights_snapshot' => $item->rights_snapshot,
'release_at_grant_id' => $item->article?->current_release_id,
'status' => GrantStatus::Aktiv,
'valid_from' => now(),
]);
}
return $acquisition->load('grants');
});
}
public function issue(
User $user,
OfferVersion $version,
AcquisitionType $type,
string $referenceType,
int $referenceId,
): Acquisition {
return DB::transaction(function () use ($user, $version, $type, $referenceType, $referenceId): Acquisition {
$existing = Acquisition::query()->where([
'party_id' => $user->party_id,
'type' => $type,
'reference_type' => $referenceType,
'reference_id' => $referenceId,
])->first();
if ($existing !== null) {
return $existing->load('grants');
}
$acquisition = Acquisition::query()->create([
'party_id' => $user->party_id,
'type' => $type,
'reference_type' => $referenceType,
'reference_id' => $referenceId,
'conditions' => [
'term_rule' => $version->term_rule,
'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,
],
]);
$version->load('resolvedScopes.rights', 'resolvedScopes.article');
foreach ($version->resolvedScopes as $scope) {
$rights = $scope->rights;
$acquisition->grants()->create([
'license_article_id' => $scope->license_article_id,
'rights_profile_version_id' => $rights->id,
'rights_snapshot' => [
'purpose' => $rights->purpose,
'capabilities' => $rights->capabilities,
'options' => $rights->options ?? [],
],
'release_at_grant_id' => $scope->article->current_release_id,
'status' => GrantStatus::Aktiv,
'valid_from' => now(),
]);
}
return $acquisition->load('grants');
});
}
}