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/PressRelease/BoostService.php

@@ -13,6 +13,7 @@ use App\Models\User;
 use App\Scopes\PortalScope;
 use App\Services\Billing\CreditPricingService;
 use App\Services\Billing\CreditWalletService;
+use App\Support\WebPageCache;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\Cache;
@@ -229,12 +230,12 @@ class BoostService
 
         foreach ($portals as $portal) {
             if ($placement === BoostPlacement::Home) {
-                Cache::forget(sprintf('web.home.%s.%s', $portal, $pressRelease->language));
+                Cache::forget(WebPageCache::key('home', [$portal, $pressRelease->language]));
             }
 
             foreach ($translations as $translation) {
                 if (filled($translation->slug)) {
-                    Cache::forget(sprintf('web.category.%s.%s.%s', $portal, $translation->locale, $translation->slug));
+                    Cache::forget(WebPageCache::key('category', [$portal, $translation->locale, $translation->slug]));
                 }
             }
         }

app/Services/PressRelease/PressReleaseService.php

@@ -411,7 +411,7 @@ class PressReleaseService
             'depublished_at' => now(),
         ]);
         $pressRelease->lockSync($syncLockReason ?? 'Depublikation auf Wunsch des Absenders');
-        WebCaches::forgetSitemaps();
+        WebCaches::forgetPublicPages();
         $this->logStatusChange($pressRelease, $previous, PressReleaseStatus::Archived, 'Depublikation auf Wunsch des Absenders (kostenpflichtige Serviceleistung)', 'depublication');
     }
 
@@ -464,6 +464,89 @@ class PressReleaseService
         $pressRelease->delete();
     }
 
+    /**
+     * Entfernung mit 410 Gone: die Mitteilung verschwindet aus allen
+     * öffentlichen Listen, ihre Detail-URL liefert aber weiterhin einen
+     * Tombstone statt eines 404.
+     *
+     * Bewusste Abgrenzung zu deleteFromAdmin(): dort wird der Inhalt durch den
+     * Ersatztext überschrieben bzw. die PM soft-gelöscht. Hier bleibt der
+     * Datensatz unverändert erhalten, damit die Entfernung über
+     * restoreFromGone() umkehrbar und im Audit nachvollziehbar bleibt.
+     *
+     * Die Re-Sync-Sperre ist Pflicht — ohne sie würde der nächste
+     * Importer-Lauf die Entfernung wieder überschreiben.
+     *
+     * $flushPublicPages steuert den Auslieferungs-Cache. Der Flush verwirft
+     * ALLE Seiten-Caches auf einmal (siehe WebPageCache::flush) und ist damit
+     * genau einmal je Vorgang richtig — wer die Methode in einer Schleife
+     * aufruft, schaltet ihn ab und flusht selbst am Ende. Sonst zwingt jede
+     * einzelne Mitteilung die gesamte öffentliche Seite in den Neuaufbau.
+     */
+    public function markGone(PressRelease $pressRelease, ?string $reason = null, bool $flushPublicPages = true): void
+    {
+        if ($pressRelease->gone_at !== null) {
+            return;
+        }
+
+        $previous = $pressRelease->status;
+
+        $pressRelease->update([
+            'status' => PressReleaseStatus::Archived->value,
+            'gone_at' => now(),
+            // Vorzustand sichern: `no_export` kann auch redaktionell oder vom
+            // Kunden gesetzt sein und ist in beiden Detailansichten sichtbar.
+            // Ohne diesen Merker stünde die Mitteilung nach dem Aufheben
+            // dauerhaft als „kein Export“ da, ohne dass das je jemand gewählt
+            // hätte.
+            'no_export_before_gone' => (bool) $pressRelease->no_export,
+            'no_export' => true,
+        ]);
+
+        $pressRelease->lockSync($reason ?? 'Entfernung mit 410 (Tombstone)');
+
+        if ($flushPublicPages) {
+            WebCaches::forgetPublicPages();
+        }
+
+        $this->logStatusChange(
+            $pressRelease,
+            $previous,
+            PressReleaseStatus::Archived,
+            $reason ?? 'Aus der öffentlichen Ansicht entfernt (410 Gone)',
+            'gone',
+        );
+    }
+
+    /**
+     * Hebt eine 410-Entfernung auf. Der Status bleibt bewusst „archived“ —
+     * ob die Mitteilung wieder veröffentlicht wird, entscheidet die Redaktion
+     * anschließend über den regulären Statuswechsel.
+     *
+     * `no_export` geht dagegen auf den Stand VOR der Entfernung zurück: Die
+     * Sperre gehört zur Entfernung, nicht zur Mitteilung. Fehlt der Merker
+     * (Entfernung aus der Zeit vor dieser Spalte), bleibt der aktuelle Wert
+     * stehen — raten wäre schlechter als nichts zu tun.
+     *
+     * Zu $flushPublicPages siehe markGone().
+     */
+    public function restoreFromGone(PressRelease $pressRelease, bool $flushPublicPages = true): void
+    {
+        if ($pressRelease->gone_at === null) {
+            return;
+        }
+
+        $pressRelease->update([
+            'gone_at' => null,
+            'no_export' => $pressRelease->no_export_before_gone ?? $pressRelease->no_export,
+            'no_export_before_gone' => null,
+        ]);
+
+        if ($flushPublicPages) {
+            WebCaches::forgetPublicPages();
+        }
+    }
+
     /**
      * @param  PressReleaseStatus[]  $allowed
      */