web: Entfernung mit 410 Gone als Alternative zur Löschung

Rechtlich oder redaktionell veranlasste Entfernungen brauchten bisher die
Löschung — danach antwortet die URL mit 404, als hätte es die Meldung nie
gegeben. Newsroom und Pressemitteilung lassen sich jetzt stattdessen mit
gone_at markieren: Der Inhalt verschwindet aus allen öffentlichen Listen, die
bestehende URL liefert aber einen Tombstone mit Status 410. Die vollständige
Löschung bleibt unverändert daneben stehen und erzeugt weiterhin 404.

Umkehrbar heißt hier wirklich umkehrbar. markGone() überschreibt zwei Felder —
companies.is_active (damit der Newsroom ohne Sonderbehandlung aus
Newsroom-Liste und Sitemap fällt, die beide darauf filtern) und
press_releases.no_export. Beide Vorzustände werden gesichert und beim Aufheben
zurückgestellt, sonst stünde eine schon vorher deaktivierte Firma danach
öffentlich in der Übersicht und eine Mitteilung dauerhaft als "kein Export" da,
ohne dass das je jemand gewählt hätte.

Der Auslieferungs-Cache kennt keine Tags, und die Keys der Listenseiten sind
über Portal, Sprache, Seite und Filter verstreut. Eine Entfernung erhöht
deshalb eine Generations-Nummer im Cache-Key und verwirft damit alle
Seiten-Caches auf einen Schlag — grob, aber Entfernungen sind selten und dürfen
nicht bis zu einer Stunde nachhängen. Der Zähler liegt bewusst außerhalb des
Namensraums, den er invalidiert, und wird zwischen zwei Queue-Jobs neu
gelesen: Ein Worker lebt über beliebig viele Jobs und arbeitete sonst dauerhaft
mit dem Stand seines ersten Zugriffs.

Beim Newsroom läuft die Tombstone-Prüfung bewusst VOR dem Seiten-Cache — eine
Entfernung muss sofort greifen, auch wenn für den Slug noch ein Stale-Eintrag
liegt. Kaskadiert man die Entfernung auf die Meldungen einer Firma, wird der
Cache einmal am Ende verworfen statt einmal je Meldung; sonst zwänge eine
Bestandsfirma mit dreistellig vielen Meldungen die gesamte öffentliche Seite
ebenso oft in den Neuaufbau.

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

app/Services/Company/CompanyRemovalService.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace App\Services\Company;
+
+use App\Enums\ActivityType;
+use App\Models\Company;
+use App\Models\PressRelease;
+use App\Scopes\PortalScope;
+use App\Services\ActivityLog;
+use App\Services\PressRelease\PressReleaseService;
+use App\Support\WebCaches;
+
+/**
+ * Entfernung eines Newsrooms aus der öffentlichen Ansicht.
+ *
+ * Zwei bewusst getrennte Wege:
+ * - Vollständige Löschung (Soft Delete, weiterhin in der Firmen-Verwaltung):
+ *   die Newsroom-URL antwortet danach mit 404.
+ * - Entfernung mit 410 Gone (hier): die URL bleibt bestehen und liefert einen
+ *   Tombstone. Umkehrbar über restoreFromGone().
+ */
+class CompanyRemovalService
+{
+    public function __construct(
+        private readonly PressReleaseService $pressReleases,
+        private readonly ActivityLog $activityLog,
+    ) {}
+
+    /**
+     * Markiert den Newsroom als entfernt (410). Die Firma wird zugleich
+     * deaktiviert — dadurch fällt sie ohne Sonderbehandlung aus
+     * Newsroom-Liste und Sitemap, die beide auf `is_active` filtern.
+     *
+     * Die Pressemitteilungen der Firma bleiben absichtlich unangetastet,
+     * solange $includePressReleases nicht gesetzt ist: eine stille
+     * Massen-Depublikation wäre nicht umkehrbar unterscheidbar von einzeln
+     * entfernten Mitteilungen.
+     *
+     * @return int Anzahl der zusätzlich mit 410 entfernten Pressemitteilungen
+     */
+    public function markGone(Company $company, bool $includePressReleases = false, ?string $reason = null): int
+    {
+        $reason ??= 'Newsroom aus der öffentlichen Ansicht entfernt (410 Gone)';
+
+        if ($company->gone_at === null) {
+            $company->forceFill([
+                'gone_at' => now(),
+                // Vorzustand sichern, sonst ist die Entfernung nicht wirklich
+                // umkehrbar: Eine Firma, die bereits vorher deaktiviert war —
+                // im Bestand der Normalfall bei Karteileichen —, stünde nach
+                // dem Aufheben öffentlich in Newsroom-Übersicht und Sitemap.
+                'is_active_before_gone' => (bool) $company->is_active,
+                'is_active' => false,
+            ])->save();
+
+            $this->activityLog->record(
+                ActivityType::ContentRemoval,
+                sprintf('Newsroom „%s“ mit 410 entfernt: %s', $company->name, $reason),
+                subject: $company,
+            );
+        }
+
+        $affected = 0;
+
+        if ($includePressReleases) {
+            // chunkById statt get(): Eine Bestandsfirma kann dreistellig viele
+            // Mitteilungen haben, die hier sonst allesamt gleichzeitig im
+            // Speicher lägen. Der Filter auf `gone_at` schrumpft mit jedem
+            // Durchgang, deshalb chunkById und nicht chunk — ein Offset würde
+            // Zeilen überspringen.
+            PressRelease::query()
+                ->withoutGlobalScope(PortalScope::class)
+                ->where('company_id', $company->getKey())
+                ->whereNull('gone_at')
+                ->chunkById(200, function ($releases) use ($reason, &$affected): void {
+                    foreach ($releases as $release) {
+                        // Ohne Flush je Mitteilung: der verwirft ALLE
+                        // Seiten-Caches auf einmal und würde die gesamte
+                        // öffentliche Seite pro Zeile in den Neuaufbau zwingen.
+                        // Einmal am Ende genügt.
+                        $this->pressReleases->markGone($release, $reason, flushPublicPages: false);
+                        $affected++;
+                    }
+                });
+        }
+
+        WebCaches::forgetPublicPages();
+
+        return $affected;
+    }
+
+    /**
+     * Hebt die 410-Entfernung des Newsrooms auf. Bereits entfernte
+     * Pressemitteilungen bleiben entfernt — sie werden einzeln freigegeben,
+     * damit eine rechtlich veranlasste Einzel-Entfernung nicht versehentlich
+     * mit zurückkommt.
+     *
+     * `is_active` geht auf den Stand VOR der Entfernung zurück, nicht pauschal
+     * auf „aktiv“. Fehlt der Merker (Entfernung aus der Zeit vor dieser
+     * Spalte), bleibt es beim bisherigen Verhalten — für diese Altfälle ist
+     * „aktiv“ die einzige Annahme, die überhaupt zur Verfügung steht.
+     */
+    public function restoreFromGone(Company $company): void
+    {
+        if ($company->gone_at === null) {
+            return;
+        }
+
+        $company->forceFill([
+            'gone_at' => null,
+            'is_active' => $company->is_active_before_gone ?? true,
+            'is_active_before_gone' => null,
+        ])->save();
+
+        $this->activityLog->record(
+            ActivityType::ContentRemoval,
+            sprintf('410-Entfernung des Newsrooms „%s“ aufgehoben', $company->name),
+            subject: $company,
+        );
+
+        WebCaches::forgetPublicPages();
+    }
+}