getRecord()->name; } public function getHeading(): string|Htmlable { return ''; } public function getMaxContentWidth(): Width|string|null { return Width::Full; } protected function getHeaderActions(): array { return []; } /** * Der gemeinsame Objektkopf zeigt den Pfad; Filaments eigener Pfad entfällt wie bei Medien und Aufbau. * * @return array */ public function getBreadcrumbs(): array { return []; } public function infolist(Schema $schema): Schema { return $schema->components([ View::make('filament.catalog.objekt')->viewData(fn (): array => $this->angebotDaten())->columnSpanFull(), ])->columns(1); } public function activeVersion(): ?OfferVersion { /** @var Offer $offer */ $offer = $this->getRecord(); return $offer->versions() ->where('status', OfferStatus::Aktiv) ->orderByDesc('number') ->with(['lines.article', 'lines.bundleVersion.bundle', 'lines.rights.profile']) ->first(); } public function activateAction(): Action { return Action::make('activate') ->label(fn (): string => $this->activeVersion() !== null ? 'Geänderte Fassung aktivieren' : 'Fassung aktivieren') ->modalHeading(fn (): string => $this->activeVersion() !== null ? 'Option „'.$this->getRecord()->optionName().'“ ändern: Fassung '.$this->nextNumber().' aktivieren' : 'Option „'.$this->getRecord()->optionName().'“: erste Fassung aktivieren') ->modalDescription(fn (): string => ($active = $this->activeVersion()) !== null ? 'Betroffen ist nur die Option „'.$this->getRecord()->optionName().'“'.$this->productPageSuffix().'. Die Maske ist mit Fassung '.$active->number.' vorbelegt. Erst „Fassung '.$this->nextNumber().' aktivieren“ schaltet die Änderung öffentlich (auch Bezeichnung und Produktseite, sie erzeugen ebenfalls eine neue Fassung und zeigen offenen Warenkörben „Bedingungen aktualisiert“): Fassung '.$active->number.' wird beendet und bleibt gespeichert, neue Käufe nutzen Fassung '.$this->nextNumber().'. Bereits begründete Berechtigungen und Bestellungen ändern sich nicht. Andere Optionen derselben Produktseite bleiben unverändert kaufbar. „Abbrechen“ verwirft die Eingaben.' : 'Positionen, Vergabe, Eignung und Preis bilden die erste Fassung dieser Option. Erst das Aktivieren macht sie öffentlich; danach ist sie unveränderlich, Änderungen ergeben eine weitere Fassung.') ->modalSubmitActionLabel(fn (): string => 'Fassung '.$this->nextNumber().' aktivieren') ->modalWidth('4xl') ->fillForm(fn (): array => $this->formFromActive()) ->schema([ TextInput::make('option_label')->label('Bezeichnung der Option') ->helperText('So heißt die Option auf der Produktseite, zum Beispiel „Einzellizenz für Privatpersonen“. Sie ist keine bindende Bedingung, wird aber wie die übrigen Angaben erst mit „Fassung aktivieren“ übernommen.') ->maxLength(120), Select::make('composition_id')->label('Produktseite') ->options(fn (): array => $this->productPages()) ->searchable() ->helperText('Optionen derselben Produktseite sind Alternativen; im Warenkorb liegt nur eine davon. Die Beschreibung der Seite wird zentral an der Komposition gepflegt. Die Zuordnung wird mit „Fassung aktivieren“ übernommen.'), Select::make('holder_kind')->label('Geeignet für')->options([ 'person' => 'Privatpersonen', '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('grant_kind')->label('Vergabe')->options([ 'kauf' => 'Kauf', 'auf_abruf' => 'Auf Abruf', 'bei_registrierung' => 'Bei Registrierung', ])->required(), TextInput::make('price_euro')->label('Preis in Euro')->suffix('€') ->helperText('Nur bei einem Kauf, zum Beispiel 49,00.'), Select::make('composition_version_id')->label('Programmfassung, die abgedeckt sein muss') ->options(function (): array { return CompositionVersion::query() ->where('status', 'bereit') ->with('composition.editorialContentKind') ->orderByDesc('id') ->get() ->mapWithKeys(fn (CompositionVersion $version): array => [$version->id => CatalogOptions::compositionLabel($version)]) ->all(); }) ->searchable() ->helperText('Wenn gewählt, lässt sich die Fassung nur aktivieren, wenn jeder Bestandteil in den Artikeln enthalten ist.'), Repeater::make('lines')->label('Positionen')->schema([ Select::make('kind')->label('Ziel')->options([ 'article' => 'Lizenzartikel', 'bundle' => 'Paketfassung', ])->required()->live(), Select::make('article_id')->label('Artikel')->options(fn (): array => app(PublicationReadiness::class)->articleOptions()) ->searchable() ->helperText('Nur Artikel mit veröffentlichtem Stand lassen sich verkaufen. Artikel ohne Stand sind gekennzeichnet.') ->visible(fn (Get $get): bool => $get('kind') === 'article'), Select::make('bundle_version_id')->label('Paketfassung')->options(fn (): array => app(PublicationReadiness::class)->bundleVersionOptions()) ->searchable() ->visible(fn (Get $get): bool => $get('kind') === 'bundle'), Select::make('rights_id')->label('Rechte')->options(fn (): array => CatalogOptions::rights())->required(), ])->minItems(1)->addActionLabel('Position hinzufügen'), ]) ->action(function (array $data): void { $this->report(function () use ($data): string { /** @var Offer $offer */ $offer = $this->getRecord(); $lines = []; foreach ($data['lines'] as $line) { $target = $line['kind'] === 'bundle' ? BundleVersion::query()->findOrFail($line['bundle_version_id']) : LicenseArticle::query()->findOrFail($line['article_id']); $lines[] = [ 'target' => $target, 'rights' => RightsProfileVersion::query()->findOrFail($line['rights_id']), ]; } // Voraussetzung: Jeder Artikel der Positionen hat einen veröffentlichten Stand, sonst erhielten Käufer nichts. $articleIds = []; foreach ($lines as $line) { $target = $line['target']; array_push($articleIds, ...($target instanceof BundleVersion ? app(BundleService::class)->articleIds($target) : [$target->id])); } $unusable = app(PublicationReadiness::class)->unusableArticles($articleIds); if ($unusable !== []) { throw new DomainRuleException(app(PublicationReadiness::class)->unusableMessage($unusable, 'das Angebot aktivierst')); } // Bedingungen, die die Maske nicht zeigt, bleiben bei einer Änderung die der aktiven Fassung. $active = $this->activeVersion(); $kept = $active === null ? [] : [ 'term_rule' => $active->term_rule, 'tax_class' => $active->tax_class, 'dynamic' => (bool) $active->dynamic, ]; $price = Money::parse($data['price_euro'] ?? null); if ($data['grant_kind'] === 'kauf' && ($price === null || $price <= 0)) { throw new DomainRuleException('Ein Kauf braucht einen Preis über 0,00 €.'); } $service = app(OfferService::class); $version = DB::transaction(function () use ($service, $offer, $data, $lines, $kept, $price) { $service->assignProduct( $offer, filled($data['composition_id'] ?? null) ? (int) $data['composition_id'] : null, $data['option_label'] ?? null, ); return $service->activate($offer, $lines, [ ...$kept, 'holder_kind' => $data['holder_kind'], 'grant_kind' => $data['grant_kind'], 'price_cents' => $price, 'composition_version_id' => filled($data['composition_version_id'] ?? null) ? (int) $data['composition_version_id'] : null, ]); }); $offer->unsetRelations(); $readiness = app(PublicationReadiness::class)->forOffer($offer->refresh()); return 'Fassung '.$version->number.' ist aktiv.'.($readiness['bereit'] ? ' Die Option ist öffentlich kaufbar und im Shop auffindbar.' : ' Noch nicht im Shop kaufbar. Nächster Schritt: '.$readiness['naechster']['titel'].'.'); }, 'Die Angebotsfassung ist aktiv.'); $this->getRecord()->unsetRelations(); $this->getRecord()->refresh(); }); } /** * Option aus dem Verkauf nehmen: nur die aktive Fassung dieser Option wird beendet. */ public function endAction(): Action { return Action::make('end') ->label('Aus dem Verkauf nehmen') ->color('danger') ->requiresConfirmation() ->modalHeading(fn (): string => 'Option „'.$this->getRecord()->optionName().'“ aus dem Verkauf nehmen?') ->modalDescription(fn (): string => 'Betroffen ist nur die Option „'.$this->getRecord()->optionName().'“'.$this->productPageSuffix().'. Die aktive Fassung wird beendet und bleibt gespeichert. Die Option ist danach nicht mehr kaufbar; in vorhandenen Warenkörben bleibt sie mit Hinweis sichtbar und blockiert den Abschluss, bis der Käufer sie entfernt. Bestehende Berechtigungen und Bestellungen ändern sich nicht. Andere Optionen derselben Produktseite bleiben kaufbar.') ->modalSubmitActionLabel('Aus dem Verkauf nehmen') ->visible(fn (): bool => $this->activeVersion() !== null) ->action(function (): void { $this->report(function (): string { $version = app(OfferService::class)->end($this->getRecord()); return 'Fassung '.$version->number.' ist beendet. Die Option ist nicht mehr kaufbar.'; }, 'Die Option ist aus dem Verkauf genommen.'); $this->getRecord()->unsetRelations(); $this->getRecord()->refresh(); }); } /** „ der Produktseite „Titel““ oder leer, wenn die Option noch keiner Produktseite zugeordnet ist. */ private function productPageSuffix(): string { $page = $this->getRecord()->composition; return $page === null ? '' : ' der Produktseite „'.($page->display_title ?: $page->designation).'“'; } /** * Produktseiten, die als Ziel wählbar sind: Kompositionen mit Bezeichnung und Art. * * @return array */ private function productPages(): array { $catalog = app(PublicCatalogReader::class); return Composition::query() ->with('editorialContentKind') ->whereNull('archived_at') ->orderBy('designation') ->get() ->sortBy(fn (Composition $composition): int => $catalog->shownVersion($composition) !== null ? 0 : 1) ->mapWithKeys(fn (Composition $composition): array => [ $composition->id => ($composition->display_title ?: $composition->designation) .' ('.($composition->editorialContentKind?->label ?? 'Zusammenstellung').')' .($catalog->shownVersion($composition) !== null ? ' · im Shop auffindbar' : ' · nicht öffentlich, im Shop nicht auffindbar'), ]) ->all(); } /** * Vorbelegung aus der aktiven Fassung; ohne aktive Fassung eine leere Position. * * @return array */ private function formFromActive(): array { $active = $this->activeVersion(); /** @var Offer $offer */ $offer = $this->getRecord(); $option = ['option_label' => $offer->option_label, 'composition_id' => $offer->composition_id]; if ($active === null) { return [...$option, 'holder_kind' => 'person', 'grant_kind' => 'kauf', 'lines' => [['kind' => 'article']]]; } return [ ...$option, 'holder_kind' => $active->holder_kind, '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 => [ 'kind' => $line->license_article_id !== null ? 'article' : 'bundle', 'article_id' => $line->license_article_id, 'bundle_version_id' => $line->bundle_version_id, 'rights_id' => $line->rights_profile_version_id, ])->values()->all(), ]; } private function nextNumber(): int { return ((int) $this->getRecord()->versions()->max('number')) + 1; } /** * Daten der gemeinsamen Katalog-Objektseite. * * @return array */ private function angebotDaten(): array { /** @var Offer $offer */ $offer = $this->getRecord(); $active = $this->activeVersion(); $vergabe = $active !== null ? CatalogLabels::vergabe($active) : null; return [ 'kopf' => [ 'brot' => [['label' => 'Angebote', 'href' => OfferResource::getUrl('index')], $offer->name], 'titel' => $offer->name, 'typ' => 'Angebot', 'status' => $active !== null ? ['text' => 'Fassung '.$active->number.' aktiv · '.$vergabe, 'ton' => 'gut'] : ['text' => 'Noch keine aktive Fassung. Ein Angebot ohne aktive Fassung kann niemand erwerben.', 'ton' => 'offen'], 'aktionen' => [ [ 'label' => $active !== null ? 'Geänderte Fassung aktivieren' : 'Fassung aktivieren', 'wire' => "mountAction('activate')", 'art' => 'primary', ], ...($active !== null ? [[ 'label' => 'Aus dem Verkauf nehmen', 'wire' => "mountAction('end')", 'art' => 'line', ]] : []), ], ], 'voraussetzungen' => app(PublicationReadiness::class)->forOffer($offer), 'haupt' => [ ...($active !== null ? [$this->optionAbschnitt($offer, $active)] : []), [ 'titel' => 'Positionen', 'zusatz' => $active !== null ? 'Fassung '.$active->number : null, 'hilfe' => $active !== null ? 'Vergabe: '.$vergabe.'. Diese Fassung ist unveränderlich; eine Änderung aktiviert die nächste Fassung.' : null, 'zeilen' => $active === null ? [] : $active->lines->sortBy('position')->map(fn ($line): array => [ 'text' => $line->article !== null ? 'Lizenzartikel '.$line->article->code : 'Paket '.($line->bundleVersion?->bundle?->name ?? '–').' · Fassung '.($line->bundleVersion?->number ?? '–'), 'neben' => 'Rechte: '.($line->rights?->profile?->name ?? '–'), ])->values()->all(), 'leer' => ['titel' => 'Noch keine Positionen', 'text' => 'Mit „Fassung aktivieren“ legst du fest, welche Lizenzartikel oder Paketfassungen mit welchem Rechteprofil angeboten werden, wie vergeben wird und zu welchem Preis.'], ], ...($active !== null ? [[ 'titel' => 'Aufgelöster Leistungsumfang', 'hilfe' => 'Diese Artikel-Rechte entstehen beim Erwerb dieser Fassung.', 'zeilen' => $this->leistungsumfang($active), 'leer' => ['titel' => 'Kein Leistungsumfang', 'text' => 'Diese Fassung hat keinen aufgelösten Leistungsumfang.'], ]] : []), ], 'seite' => [[ 'titel' => 'Fassungen', 'zeilen' => $offer->versions()->orderByDesc('number')->get()->map(fn (OfferVersion $version): array => [ 'text' => 'Fassung '.$version->number, 'zustand' => match (StatusValue::of($version->status)) { 'aktiv' => ['label' => 'Aktiv', 'ton' => 'gut'], 'beendet' => ['label' => 'Beendet', 'ton' => 'leise'], default => ['label' => 'Entwurf', 'ton' => 'offen'], }, 'neben' => CatalogLabels::vergabe($version).($version->activated_at ? ' · aktiviert am '.$version->activated_at->format('d.m.Y') : ''), ])->all(), 'leer' => 'Noch keine Fassung.', 'hilfe' => 'Beendete Fassungen bleiben gespeichert; Erwerbe verweisen auf ihre Fassung. Ob ein Angebot künftig auch als Vorlage für ein weiteres dienen soll, ist fachlich noch offen (OFF-04).', ]], ]; } /** * Die Option auf einen Blick: Preis in Euro, Eignung, Rechte, zugrunde liegender Inhalt, Status und Produktseite. * * @return array */ private function optionAbschnitt(Offer $offer, OfferVersion $active): array { $option = app(ProductOptions::class)->describe($offer, $active); $inhalt = collect($option['scope'])->pluck('article')->unique()->implode(', '); $rechte = collect($option['scope']) ->map(fn (array $item): string => $item['purpose'].($item['rights'] === [] ? '' : ': '.implode(', ', $item['rights']))) ->unique() ->implode('; '); $seite = $offer->composition; $kaufbar = app(OfferService::class)->purchasableVersion($offer) !== null; return [ 'titel' => 'Die Option auf einen Blick', 'zusatz' => 'Fassung '.$active->number, 'hilfe' => 'So erscheint die Option auf der öffentlichen Produktseite und im Warenkorb. Die Angaben dieser Fassung sind unveränderlich.', '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' => '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.'], ], ]; } /** * Aufgelöster Leistungsumfang in lesbaren Fähigkeiten (dieselben Bezeichnungen wie beim Rechteprofil). * * @return list */ private function leistungsumfang(OfferVersion $version): array { $zeilen = []; foreach ($version->resolvedScopes()->with(['article', 'rights.profile'])->get() as $scope) { $faehigkeiten = CatalogLabels::faehigkeiten($scope->rights?->capabilities); $zeilen[] = [ 'text' => 'Lizenzartikel '.$scope->article?->code, 'neben' => ($scope->rights?->profile?->name ?? '–').': '.($faehigkeiten === [] ? 'keine Fähigkeiten' : implode(', ', $faehigkeiten)), ]; } return $zeilen; } }