companies: Zusammenführung im Bestand, rückabwickelbar (Roadmap 1a.3)

companies:merge führt Firmen mit derselben Firmen-E-Mail zu einem Newsroom
zusammen — nur über Adressen, die 1a.2 als Dublette oder Namensvariante
klassifiziert hat. Es bleibt die Firma mit den meisten jemals
veröffentlichten Meldungen; Meldungen, Kontakte, Nutzer- und
Zahlungsverknüpfungen wandern per company_id, jede Bewegung steht in
company_merge_moves. companies:unmerge spielt sie rückwärts ab.

77 % der Gruppen sind dieselbe Firma auf beiden Portalen (Altsystem: eine
Firma je Portal). Der Überlebende wird dann `both`; die Meldungen behalten
ihr Portal. Der alte Newsroom-Slug führt per 301 zum Überlebenden.
Slug-Kollisionen auf dem anderen Portal werden übersprungen, nicht
umbenannt. Company::slugExists() kennt jetzt `both`.

Dev-DB: 14 142 Adressen, 16 194 Firmen, 13 297 Meldungen in 2 min;
Rückabwicklung in 1:15 min exakt auf den Stand davor.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

app/Models/Company.php

@@ -36,6 +36,36 @@ class Company extends Model
         return 'company';
     }
 
+    /**
+     * Portalübergreifende Firmen (`both`, seit der Zusammenführung 1a.3)
+     * sind auf JEDEM Portal erreichbar — die öffentliche Auflösung fragt
+     * `portal IN (eigenes, both)`. Ein Slug ist deshalb nur frei, wenn ihn
+     * weder eine Firma desselben Portals noch eine `both`-Firma trägt; und
+     * eine `both`-Firma braucht ihn auf allen Portalen frei. Der reine
+     * Portal-Scope des Traits sähe die Überschneidung nicht.
+     *
+     * @param  array<string, mixed>  $scope
+     */
+    protected function slugExists(string $slug, array $scope): bool
+    {
+        $portal = array_key_exists('portal', $scope) ? $scope['portal'] : $this->getAttribute('portal');
+        $portal = $portal instanceof Portal ? $portal->value : $portal;
+
+        $query = static::query()
+            ->withoutGlobalScopes()
+            ->where($this->slugColumn(), $slug);
+
+        if ($this->exists) {
+            $query->whereKeyNot($this->getKey());
+        }
+
+        if ($portal !== null && $portal !== Portal::Both->value) {
+            $query->whereIn('portal', [$portal, Portal::Both->value]);
+        }
+
+        return $query->exists();
+    }
+
     protected static function booted(): void
     {
         static::addGlobalScope(new PortalScope);

app/Models/CompanyMerge.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\Portal;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+/**
+ * Ein Zusammenführungsvorgang je Firmen-E-Mail (Roadmap 1a.3).
+ *
+ * Die Bewegungen (`moves`) sind die gespeicherte Ursprungszuordnung: Sie
+ * reichen aus, den Vorgang exakt umzukehren. `reverted_at` markiert, dass das
+ * geschehen ist — der Vorgang bleibt als Nachweis stehen.
+ */
+class CompanyMerge extends Model
+{
+    protected $fillable = [
+        'batch',
+        'email',
+        'survivor_company_id',
+        'survivor_portal_before',
+        'merged_companies_count',
+        'moved_press_releases_count',
+        'reverted_at',
+    ];
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'survivor_portal_before' => Portal::class,
+            'reverted_at' => 'datetime',
+        ];
+    }
+
+    /**
+     * @return BelongsTo<Company, $this>
+     */
+    public function survivor(): BelongsTo
+    {
+        return $this->belongsTo(Company::class, 'survivor_company_id')->withTrashed();
+    }
+
+    /**
+     * @return HasMany<CompanyMergeMove, $this>
+     */
+    public function moves(): HasMany
+    {
+        return $this->hasMany(CompanyMergeMove::class);
+    }
+
+    public function isReverted(): bool
+    {
+        return $this->reverted_at !== null;
+    }
+}

app/Models/CompanyMergeMove.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\CompanyMergeSubject;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * Ein verschobener Datensatz innerhalb einer Zusammenführung (Roadmap 1a.3).
+ * Nur über `CompanyMerge` sinnvoll; ohne Zeitstempel, weil der am Vorgang
+ * steht.
+ */
+class CompanyMergeMove extends Model
+{
+    public $timestamps = false;
+
+    protected $fillable = [
+        'company_merge_id',
+        'subject',
+        'subject_id',
+        'from_company_id',
+        'field',
+        'previous_value',
+        'dropped',
+    ];
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'subject' => CompanyMergeSubject::class,
+            'dropped' => 'boolean',
+        ];
+    }
+
+    /**
+     * @return BelongsTo<CompanyMerge, $this>
+     */
+    public function merge(): BelongsTo
+    {
+        return $this->belongsTo(CompanyMerge::class, 'company_merge_id');
+    }
+}