web/api/ki: Soft Deletes wieder wirksam, Caches bei Firmenwechsel, KI-Ergebnis an Inhalt gebunden (Audit Block 3+4, Deploy D)

Block 3 — Sichtbarkeit, Löschung, Cache, Eingaben

F04: withoutGlobalScopes() ohne Argument entfernte neben dem PortalScope
auch den Soft-Delete-Filter. Öffentliche, Kunden-, API-, Vorschau- und
Medienpfade sowie die PressRelease-Helfer schreiben jetzt
withoutGlobalScope(PortalScope::class). Zwei Stellen, die der Audit nicht
kannte: die öffentliche Meldungsseite zeigte gelöschte Firmenkontakte mit
Name, Mail und Telefon; das Pressefach listete gelöschte Kontakte weiter
und ließ sie bearbeiten. Ein Architekturtest friert die 39 bewusst
verbliebenen Stellen (Admin, Importer, Befehle, Slug-Eindeutigkeit) ein.
Der Vorschau-Test prüfte bisher forceDelete statt delete.

F22: LOWER(email) machte auf companies (110k Zeilen) bei jedem Login einen
Vollscan; die Kollation ist ohnehin case-insensitiv. EmailQuery vergleicht
auf MySQL direkt über den Index, auf SQLite (Tests) weiter per LOWER.
Neuer Index contacts_email_idx.

F13: Firmen-Observer verwirft die öffentlichen Seiten-Caches bei
Löschung, Wiederherstellung und is_active-Wechsel auf jedem Weg; die
Newsroom-Seite prüft Sichtbarkeit vor dem Cache-Treffer; Kontakt-
Änderungen im Pressefach flushen. Der Tombstone-Test wärmte den Cache
vorher nicht und traf den Fehler nie.

F12: Gemeldete URLs werden über Host, Ausgabe und Slug aufgelöst
(ReportedUrlResolver); fremde Hosts zählen nicht, bei Doppelveröffentlichung
gewinnt die Erstquelle.

F11: per_page 1–100, status als Enum, language nur de/en, Kategorie muss
aktiv sein und zum Ziel-Portal passen. Legacy-Aliasse behalten ihren
Vertrag.

F23: Rückgabewert von put() wird geprüft; Logo erst speichern, dann
Datenbank, dann altes Logo löschen. Fehler enden als Feldfehler, nicht
als verlorenes Logo.

Block 4 — KI-Prüfung und Scheduler

F07: Klassifikation und Score tragen die Prüfsumme des Inhalts bei
Einplanung. Weicht sie beim Speichern ab, wird das Ergebnis verworfen
(ki_audits.discarded_at) und ein neuer Lauf eingeplant. Der Scheduler
veröffentlicht keine Meldung, deren jüngste Klassifikation nicht zum
aktuellen Text passt, sondern plant eine Prüfung mit Routing ein.

F18: Kontingent an den Kalendermonat gebunden (users.press_release_quota_period).
Verbrauch aus einem früheren Monat zählt null, auch ohne Reset-Cron; der
Reset ist idempotent und lässt den laufenden Monat in Ruhe.

F20: Der Publikations-Scheduler liefert bei technischen Fehlern einen
Fehler-Exit-Code, damit der Failure-Hook greift.

F17: KI-Jobs mit $timeout = 120, retry_after 150; Runbook ergänzt.

F19: Aggregation der Aufrufe unter einem Cache-Lock für alle Einstiege.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

tests/Feature/GlobalScopeGuardTest.php

@@ -0,0 +1,71 @@
+<?php
+
+use Illuminate\Support\Facades\File;
+
+/**
+ * `withoutGlobalScopes()` ohne Argument entfernt neben dem PortalScope auch
+ * den Soft-Delete-Filter (Audit F04): gelöschte Meldungen, Firmen und
+ * Kontakte tauchten in API, Vorschau, Medien, Kundenpanel und auf der
+ * öffentlichen Meldungsseite wieder auf. Öffentliche, Kunden- und API-Pfade
+ * schreiben deshalb `withoutGlobalScope(PortalScope::class)`.
+ *
+ * Die Liste unten sind die bewusst verbliebenen Stellen: Admin-Verwaltung
+ * (darf Gelöschtes sehen), Importer und Befehle, Slug-Eindeutigkeit (muss
+ * gelöschte Zeilen einschließen) und die Newsletter-Anmeldung. Wer eine
+ * neue Stelle braucht, trägt sie hier ein und begründet das im Commit.
+ */
+test('withoutGlobalScopes() without arguments stays confined to admin, import and slug code (Audit F04)', function () {
+    $allowed = [
+        'app/Console/Commands/CheckMailDomains.php',
+        'app/Console/Commands/ImportNewsletterBounces.php',
+        'app/Console/Commands/ListCompanyMerges.php',
+        'app/Console/Commands/MigrateLegacyMedia.php',
+        'app/Console/Commands/PurgeExpiredPressReleaseDrafts.php',
+        'app/Console/Commands/RetireAgencyCompanyType.php',
+        'app/Console/Commands/SeedLegacyApiTestdata.php',
+        'app/Console/Commands/SyncCompanyLogos.php',
+        'app/Console/Commands/SyncPressReleaseImages.php',
+        'app/Http/Controllers/Admin/DashboardController.php',
+        'app/Http/Controllers/Api/V1/NewsletterSubscriptionController.php',
+        'app/Http/Controllers/Web/LegacyMediaRedirectController.php',
+        'app/Livewire/Concerns/HandlesAdminPressReleaseActions.php',
+        'app/Models/Company.php',
+        'app/Models/Concerns/HasUniqueSlug.php',
+        'app/Services/Admin/AdminPerformanceCache.php',
+        'app/Services/Company/CompanyMergeService.php',
+        'app/Services/Import/CompanyImporter.php',
+        'app/Services/Import/ContactImporter.php',
+        'app/Services/Import/PressReleaseImporter.php',
+        'app/Services/Mail/SubmitterContactReport.php',
+        'app/Services/PressRelease/CanonicalAssigner.php',
+        'app/Services/PressRelease/CorrectionService.php',
+        'app/Services/PressRelease/ProofPdfRenderer.php',
+        'app/Services/SearchConsole/IndexStatusReport.php',
+        'resources/views/livewire/admin/categories/edit.blade.php',
+        'resources/views/livewire/admin/categories/index.blade.php',
+        'resources/views/livewire/admin/companies/index.blade.php',
+        'resources/views/livewire/admin/companies/show.blade.php',
+        'resources/views/livewire/admin/contacts/create.blade.php',
+        'resources/views/livewire/admin/contacts/edit.blade.php',
+        'resources/views/livewire/admin/contacts/index.blade.php',
+        'resources/views/livewire/admin/press-releases/create.blade.php',
+        'resources/views/livewire/admin/press-releases/edit.blade.php',
+        'resources/views/livewire/admin/press-releases/index.blade.php',
+        'resources/views/livewire/admin/press-releases/show.blade.php',
+        'resources/views/livewire/admin/reports/submitter-contacts.blade.php',
+        'resources/views/livewire/admin/users.blade.php',
+        'resources/views/livewire/admin/users/create.blade.php',
+        'resources/views/livewire/admin/users/edit.blade.php',
+    ];
+
+    $hits = collect([app_path(), resource_path('views'), base_path('routes')])
+        ->flatMap(fn (string $dir) => File::allFiles($dir))
+        ->filter(fn ($file) => str_ends_with($file->getFilename(), '.php'))
+        ->filter(fn ($file) => str_contains($file->getContents(), 'withoutGlobalScopes()'))
+        ->map(fn ($file) => str_replace(base_path().'/', '', $file->getPathname()))
+        ->sort()
+        ->values()
+        ->all();
+
+    expect(array_values(array_diff($hits, $allowed)))->toBe([], 'Neue Stelle mit withoutGlobalScopes() ohne Argument – bitte withoutGlobalScope(PortalScope::class) verwenden oder die Ausnahme hier begründen.');
+});