Files
laraundfelix/app/Domain/Catalog/PillarService.php
T
LarsandClaude Sonnet 5.5 7c48a6480c
CI Feature / test (push) Successful in 1m34s
Deploy Test / test (push) Successful in 1m29s
Deploy Test / deploy (push) Successful in 29s
Vereinheitliche die fachlichen Säulen auf die zentrale Säulenverwaltung
Module, Programme und Lizenzartikel verwenden wie Medien und Seiten die Tabelle
pillars; die Kopie „Fachliche Säule“ in den redaktionellen Dimensionen wird nirgends
mehr angeboten, geändert oder gefiltert und bleibt nur als Verlauf erhalten.

- Migration (nur Ergänzungen): composition_pillar und license_article_pillar mit
  restrictOnDelete, pillar_id an den alten Dimensionswerten als dokumentierte
  Abbildung, einmalige wiederholbare Übernahme (LegacyPillarAdoption).
- Übernahme nur über die gespeicherte Kennung pfeiler-<Nummer> und nur direkte
  Zuordnungen; mehrdeutige, abgeleitete und verwaiste Fälle werden gemeldet, nicht
  geraten. Medien bleiben bei ihrer Zuordnung. Alte Zeilen bleiben unverändert.
  Befehl: php artisan luf:saeulen-uebernehmen [--dry-run].
- Editoren von Modul, Programm und Lizenzartikel wählen Säulen aus der Säulenverwaltung;
  PillarService::assign gilt für alle Objektarten, Löschschutz zählt alle Objektarten.
- Filter: Module und Programme, Aufbau-Picker und Mitgliederbibliothek nach der
  Säulenzuordnung; alte Adressen mit einem Säulenwert der Einordnung folgen der Säule.
- Abgeleitete Säulen (aus enthaltenen Medien) bleiben getrennt von direkten.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-21 10:11:42 +01:00

163 lines
4.9 KiB
PHP

<?php
namespace App\Domain\Catalog;
use App\Domain\Cms\Page;
use Illuminate\Support\Str;
class PillarService
{
public function create(string $name): Pillar
{
$name = $this->name($name);
if (Pillar::query()->where('name', $name)->exists()) {
throw new DomainRuleException('Diese fachliche Säule gibt es schon.');
}
return Pillar::query()->create([
'name' => $name,
'slug' => $this->uniqueSlug(Str::slug($name, '-', 'de')),
]);
}
public function present(Pillar $pillar, string $name, string $slug, ?string $summary, bool $published, int $sortOrder): void
{
$name = $this->name($name);
if (Pillar::query()->where('name', $name)->whereKeyNot($pillar->id)->exists()) {
throw new DomainRuleException('Diese fachliche Säule gibt es schon.');
}
$summary = trim((string) $summary);
$pillar->name = $name;
$pillar->slug = $this->slug($slug, $pillar->id);
$pillar->public_summary = $summary === '' ? null : $summary;
$pillar->sort_order = max(0, $sortOrder);
$pillar->published_at = $published ? ($pillar->published_at ?? now()) : null;
$pillar->save();
}
public function delete(Pillar $pillar): void
{
$usage = $this->usage($pillar);
if (array_sum($usage) > 0) {
throw new DomainRuleException('Eine Säule mit zugeordneten Objekten wird nicht gelöscht ('.$this->usageText($usage).'). Ordnen Sie sie zuerst anders zu.');
}
$pillar->delete();
}
/**
* Zuordnungen je Objektart: Medien, Module und Programme, Lizenzartikel, Seiten.
*
* @return array{medien: int, zusammenstellungen: int, lizenzartikel: int, seiten: int}
*/
public function usage(Pillar $pillar): array
{
return [
'medien' => $pillar->elements()->count(),
'zusammenstellungen' => $pillar->compositions()->count(),
'lizenzartikel' => $pillar->licenseArticles()->count(),
'seiten' => $pillar->pages()->count(),
];
}
/**
* @param array{medien: int, zusammenstellungen: int, lizenzartikel: int, seiten: int} $usage
*/
public function usageText(array $usage): string
{
$parts = [];
foreach (['medien' => ['Medium', 'Medien'], 'zusammenstellungen' => ['Modul oder Programm', 'Module und Programme'], 'lizenzartikel' => ['Lizenzartikel', 'Lizenzartikel'], 'seiten' => ['Seite', 'Seiten']] as $key => [$one, $many]) {
if ($usage[$key] > 0) {
$parts[] = $usage[$key].' '.($usage[$key] === 1 ? $one : $many);
}
}
return $parts === [] ? 'nirgends zugeordnet' : implode(', ', $parts);
}
/**
* Ordnet einem Medium, Modul, Programm, Lizenzartikel oder einer Seite Säulen zu. Alle Objektarten verwenden
* dieselbe zentrale Säule und dieselbe Speicherregel; die Zuordnung ersetzt die bisherige vollständig.
*
* @param list<int|string> $pillarIds
*/
public function assign(ContentElement|Composition|LicenseArticle|Page $subject, array $pillarIds): void
{
$subject->pillars()->sync($this->ids($pillarIds));
}
/**
* @param list<int> $pillarIds
*/
public function assignPages(Page $page, array $pillarIds): void
{
$this->assign($page, $pillarIds);
}
/**
* @param list<int> $pillarIds
* @return list<int>
*/
private function ids(array $pillarIds): array
{
$ids = array_values(array_unique(array_map(intval(...), $pillarIds)));
if (Pillar::query()->whereIn('id', $ids)->count() !== count($ids)) {
throw new DomainRuleException('Eine fachliche Säule fehlt.');
}
return $ids;
}
private function slug(string $slug, ?int $ignoreId = null): string
{
$slug = Str::slug($slug, '-', 'de');
if ($slug === '') {
throw new DomainRuleException('Die öffentliche Adresse der Säule fehlt.');
}
$existing = Pillar::query()->where('slug', $slug);
if ($ignoreId !== null) {
$existing->whereKeyNot($ignoreId);
}
if ($existing->exists()) {
throw new DomainRuleException('Diese öffentliche Adresse ist schon vergeben.');
}
return $slug;
}
private function uniqueSlug(string $base): string
{
$base = $base !== '' ? $base : 'saeule';
$slug = $base;
$suffix = 2;
while (Pillar::query()->where('slug', $slug)->exists()) {
$slug = $base.'-'.$suffix;
$suffix++;
}
return $slug;
}
private function name(string $name): string
{
$name = trim($name);
if ($name === '') {
throw new DomainRuleException('Der Name der fachlichen Säule fehlt.');
}
return $name;
}
}