- Implement OfferOptionAdminTest to validate offer option management, including price display, activation, and cancellation. - Create OrganizationPurchaseTest to ensure correct handling of organization purchases, including access control and order processing. - Add ShopProductPageTest to verify shop product listings, search functionality, and product page details. - Introduce BuildsShop trait for seeding test data related to shop functionality. - Implement MoneyTest to validate money parsing and formatting, ensuring correct handling of euro amounts.
284 lines
10 KiB
PHP
284 lines
10 KiB
PHP
<?php
|
|
|
|
namespace App\Domain\Catalog;
|
|
|
|
use Illuminate\Support\Facades\DB;
|
|
|
|
class OfferService
|
|
{
|
|
public function __construct(private readonly BundleService $bundles) {}
|
|
|
|
public function currentActiveVersion(Offer $offer): OfferVersion
|
|
{
|
|
$version = $offer->versions()
|
|
->where('status', OfferStatus::Aktiv)
|
|
->orderByDesc('number')
|
|
->first();
|
|
|
|
if ($version === null) {
|
|
throw new DomainRuleException('Das Angebot hat keine aktive Fassung.');
|
|
}
|
|
|
|
return $version;
|
|
}
|
|
|
|
/**
|
|
* Die aktive, als Kauf angebotene Fassung mit Preis; sonst null (nicht kaufbar, zurückgezogen oder kostenlos).
|
|
*/
|
|
public function purchasableVersion(Offer $offer): ?OfferVersion
|
|
{
|
|
$version = $offer->versions()
|
|
->where('status', OfferStatus::Aktiv)
|
|
->orderByDesc('number')
|
|
->first();
|
|
|
|
if ($version === null || $version->grant_kind !== 'kauf' || $version->price_cents === null) {
|
|
return null;
|
|
}
|
|
|
|
return $version;
|
|
}
|
|
|
|
/**
|
|
* @param array<string, mixed> $capabilities
|
|
* @param array<string, mixed> $options
|
|
*/
|
|
public function createRightsProfile(
|
|
string $name,
|
|
string $purpose,
|
|
array $capabilities,
|
|
array $options = [],
|
|
): RightsProfileVersion {
|
|
$purpose = trim($purpose);
|
|
|
|
if (! in_array($purpose, ['ehrenamtlich', 'kommerziell', 'institutionell'], true)) {
|
|
throw new DomainRuleException('Der Nutzungszweck eines Rechteprofils ist ehrenamtlich, kommerziell oder institutionell.');
|
|
}
|
|
|
|
if ($capabilities === []) {
|
|
throw new DomainRuleException('Ein Rechteprofil braucht mindestens eine Fähigkeit.');
|
|
}
|
|
|
|
$profile = RightsProfile::query()->create([
|
|
'name' => trim($name) !== '' ? trim($name) : throw new DomainRuleException('Der Name des Rechteprofils fehlt.'),
|
|
]);
|
|
|
|
return $profile->versions()->create([
|
|
'number' => 1,
|
|
'purpose' => $purpose,
|
|
'capabilities' => $capabilities,
|
|
'options' => $options,
|
|
]);
|
|
}
|
|
|
|
public function create(string $name): Offer
|
|
{
|
|
$name = trim($name);
|
|
|
|
if ($name === '') {
|
|
throw new DomainRuleException('Der Name des Angebots fehlt.');
|
|
}
|
|
|
|
return Offer::query()->create([
|
|
'name' => $name,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* @param list<array{target: LicenseArticle|BundleVersion, rights: RightsProfileVersion}> $lines
|
|
* @param array<string, mixed> $attributes
|
|
*/
|
|
public function activate(Offer $offer, array $lines, array $attributes = []): OfferVersion
|
|
{
|
|
if ($lines === []) {
|
|
throw new DomainRuleException('Eine Angebotsfassung braucht mindestens eine Position.');
|
|
}
|
|
|
|
$attributes = array_merge([
|
|
'price_cents' => null,
|
|
'tax_class' => null,
|
|
'term_rule' => 'dauerhaft',
|
|
'update_promise' => 'alle_freigegebenen_fassungen',
|
|
'dynamic' => false,
|
|
'grant_kind' => 'kauf',
|
|
'holder_kind' => 'person',
|
|
], $attributes);
|
|
|
|
$this->assertAttributes($attributes);
|
|
$scope = $this->scopeFor($lines);
|
|
$this->assertCoverage($lines, $attributes);
|
|
|
|
return DB::transaction(function () use ($offer, $lines, $attributes, $scope): OfferVersion {
|
|
$offer = Offer::query()->lockForUpdate()->findOrFail($offer->id);
|
|
|
|
OfferVersion::query()
|
|
->where('offer_id', $offer->id)
|
|
->where('status', OfferStatus::Aktiv)
|
|
->update(['status' => OfferStatus::Beendet->value]);
|
|
|
|
$version = $offer->versions()->create([
|
|
'number' => ((int) $offer->versions()->max('number')) + 1,
|
|
'status' => OfferStatus::Entwurf,
|
|
'price_cents' => $attributes['price_cents'],
|
|
'tax_class' => $attributes['tax_class'],
|
|
'term_rule' => $attributes['term_rule'],
|
|
'update_promise' => $attributes['update_promise'],
|
|
'dynamic' => $attributes['dynamic'],
|
|
'grant_kind' => $attributes['grant_kind'],
|
|
'holder_kind' => $attributes['holder_kind'],
|
|
]);
|
|
|
|
foreach (array_values($lines) as $index => $line) {
|
|
$target = $line['target'];
|
|
$version->lines()->create([
|
|
'position' => $index + 1,
|
|
'license_article_id' => $target instanceof LicenseArticle ? $target->id : null,
|
|
'bundle_version_id' => $target instanceof BundleVersion ? $target->id : null,
|
|
'rights_profile_version_id' => $line['rights']->id,
|
|
]);
|
|
}
|
|
|
|
foreach ($scope as $entry) {
|
|
$version->resolvedScopes()->create($entry);
|
|
}
|
|
|
|
RightsProfileVersion::query()
|
|
->whereIn('id', array_column($scope, 'rights_profile_version_id'))
|
|
->whereNull('locked_at')
|
|
->update(['locked_at' => now()]);
|
|
|
|
$version->status = OfferStatus::Aktiv;
|
|
$version->activated_at = now();
|
|
$version->save();
|
|
|
|
return $version->load('resolvedScopes');
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Zieht die Option aus dem Verkauf zurück: Die aktive Fassung wird beendet und bleibt gespeichert. Bereits
|
|
* begründete Berechtigungen und Bestellungen ändern sich nicht; offene Warenkörbe zeigen die Position als
|
|
* zurückgezogen und blockieren den Abschluss, bis der Käufer sie entfernt.
|
|
*/
|
|
public function end(Offer $offer): OfferVersion
|
|
{
|
|
return DB::transaction(function () use ($offer): OfferVersion {
|
|
$offer = Offer::query()->lockForUpdate()->findOrFail($offer->id);
|
|
$version = $this->currentActiveVersion($offer);
|
|
$version->status = OfferStatus::Beendet;
|
|
$version->save();
|
|
|
|
return $version;
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Produktzuordnung der Option: Die Komposition bestimmt die öffentliche Produktseite und die Alternativgruppe,
|
|
* die Bezeichnung benennt die Option auf dieser Seite. Beides sind keine bindenden Konditionen.
|
|
*/
|
|
public function assignProduct(Offer $offer, ?int $compositionId, ?string $optionLabel): Offer
|
|
{
|
|
if ($compositionId !== null) {
|
|
Composition::query()->findOrFail($compositionId);
|
|
}
|
|
|
|
$offer->composition_id = $compositionId;
|
|
$offer->option_label = filled($optionLabel) ? trim((string) $optionLabel) : null;
|
|
$offer->save();
|
|
|
|
return $offer;
|
|
}
|
|
|
|
/**
|
|
* @return list<int>
|
|
*/
|
|
public function scopeArticleIds(OfferVersion $version): array
|
|
{
|
|
return $version->resolvedScopes()->orderBy('id')->pluck('license_article_id')->all();
|
|
}
|
|
|
|
/**
|
|
* @param array<string, mixed> $attributes
|
|
*/
|
|
private function assertAttributes(array $attributes): void
|
|
{
|
|
if (! in_array($attributes['term_rule'], ['dauerhaft', 'befristet', 'solange_angebot_aktiv', 'periodisch'], true)) {
|
|
throw new DomainRuleException('Die Laufzeitregel der Angebotsfassung ist unbekannt.');
|
|
}
|
|
|
|
if (! in_array($attributes['grant_kind'], ['kauf', 'bei_registrierung', 'auf_abruf'], true)) {
|
|
throw new DomainRuleException('Die Vergabeart der Angebotsfassung ist unbekannt.');
|
|
}
|
|
|
|
if (! in_array($attributes['holder_kind'], ['person', 'organisation'], true)) {
|
|
throw new DomainRuleException('Die Inhaberart der Angebotsfassung ist Person oder Organisation.');
|
|
}
|
|
|
|
if ($attributes['update_promise'] !== 'alle_freigegebenen_fassungen') {
|
|
throw new DomainRuleException('Die Updatezusage umfasst alle später freigegebenen Fassungen des Artikels.');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param list<array{target: LicenseArticle|BundleVersion, rights: RightsProfileVersion}> $lines
|
|
* @return list<array{license_article_id: int, rights_profile_version_id: int}>
|
|
*/
|
|
/**
|
|
* @param list<array{target: LicenseArticle|BundleVersion, rights: RightsProfileVersion}> $lines
|
|
* @param array<string, mixed> $attributes
|
|
*/
|
|
private function assertCoverage(array $lines, array $attributes): void
|
|
{
|
|
$versionId = $attributes['composition_version_id'] ?? null;
|
|
|
|
if ($versionId === null) {
|
|
return;
|
|
}
|
|
|
|
$version = CompositionVersion::query()->findOrFail($versionId);
|
|
$articles = [];
|
|
|
|
foreach ($lines as $line) {
|
|
if ($line['target'] instanceof LicenseArticle) {
|
|
$articles[] = $line['target'];
|
|
}
|
|
}
|
|
|
|
$missing = app(OfferCoverage::class)->missingLeaves($version, $articles);
|
|
|
|
if ($missing !== []) {
|
|
throw new DomainRuleException('Das Angebot deckt nicht alle Blätter: '.implode(', ', $missing));
|
|
}
|
|
}
|
|
|
|
private function scopeFor(array $lines): array
|
|
{
|
|
$scope = [];
|
|
|
|
foreach ($lines as $line) {
|
|
$target = $line['target'];
|
|
$rights = $line['rights'];
|
|
|
|
if ($target instanceof BundleVersion && $target->status !== BundleStatus::Veroeffentlicht) {
|
|
throw new DomainRuleException('Eine Angebotsfassung enthält nur veröffentlichte Paketfassungen.');
|
|
}
|
|
|
|
$articleIds = match (true) {
|
|
$target instanceof LicenseArticle => [$target->id],
|
|
$target instanceof BundleVersion => $this->bundles->articleIds($target),
|
|
default => throw new DomainRuleException('Eine Angebotsposition zeigt auf einen Lizenzartikel oder eine Paketfassung.'),
|
|
};
|
|
|
|
foreach ($articleIds as $articleId) {
|
|
$key = $articleId.'-'.$rights->id;
|
|
$scope[$key] = [
|
|
'license_article_id' => $articleId,
|
|
'rights_profile_version_id' => $rights->id,
|
|
];
|
|
}
|
|
}
|
|
|
|
return array_values($scope);
|
|
}
|
|
}
|