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>

app/Services/PressRelease/PressReleaseAttachmentStorage.php

@@ -64,13 +64,21 @@ class PressReleaseAttachmentStorage
         }
 
         try {
-            $disk->put($relativePath, $stream, $diskName === 'public' ? 'public' : 'private');
+            $written = $disk->put($relativePath, $stream, $diskName === 'public' ? 'public' : 'private');
         } finally {
             if (is_resource($stream)) {
                 fclose($stream);
             }
         }
 
+        // Die Disks sind mit throw=false konfiguriert: Ein fehlgeschlagener
+        // Schreibvorgang (voller Datenträger, Rechte) kommt nur als false
+        // zurück. Ohne Prüfung entstünde ein Datensatz, dessen Datei nie
+        // existiert hat (F23).
+        if (! $written) {
+            throw new RuntimeException('Der Anhang konnte nicht gespeichert werden.');
+        }
+
         return [
             'disk' => $diskName,
             'path' => $relativePath,

app/Services/PressRelease/PressReleaseService.php

@@ -122,11 +122,11 @@ class PressReleaseService
             // KI-Klassifikation asynchron anstoßen (Red Flag). Das Routing
             // anhand des Ergebnisses übernimmt der Job über
             // routeByClassification().
-            ClassifyPressRelease::dispatch($pressRelease->id)->onQueue('classification');
+            ClassifyPressRelease::dispatch($pressRelease->id, contentHash: $pressRelease->content_hash)->onQueue('classification');
         }
 
         // Content-Score parallel berechnen (Qualität, ohne Statuswirkung).
-        ScorePressRelease::dispatch($pressRelease->id)->onQueue('classification');
+        ScorePressRelease::dispatch($pressRelease->id, contentHash: $pressRelease->content_hash)->onQueue('classification');
     }
 
     /**
@@ -144,7 +144,7 @@ class PressReleaseService
             return;
         }
 
-        ClassifyPressRelease::dispatch($pressRelease->id, route: false)->onQueue('classification');
+        ClassifyPressRelease::dispatch($pressRelease->id, route: false, contentHash: $pressRelease->content_hash)->onQueue('classification');
     }
 
     /**
@@ -157,7 +157,7 @@ class PressReleaseService
             return;
         }
 
-        ScorePressRelease::dispatch($pressRelease->id)->onQueue('classification');
+        ScorePressRelease::dispatch($pressRelease->id, contentHash: $pressRelease->content_hash)->onQueue('classification');
     }
 
     /**
@@ -362,8 +362,16 @@ class PressReleaseService
 
         $plan = $user->currentPlan();
 
-        if ($plan && (int) $user->press_release_quota_used_this_month < $plan->press_release_quota) {
-            $user->increment('press_release_quota_used_this_month');
+        if ($plan && $user->pressReleaseQuotaUsedThisMonth() < $plan->press_release_quota) {
+            // Periodenwechsel atomar unter der Zeilensperre: neuer Monat →
+            // Zähler beginnt bei 1, sonst erhöhen (Audit F18).
+            $period = User::currentQuotaPeriod();
+            $user->forceFill([
+                'press_release_quota_used_this_month' => $user->press_release_quota_period === $period
+                    ? (int) $user->press_release_quota_used_this_month + 1
+                    : 1,
+                'press_release_quota_period' => $period,
+            ])->save();
 
             return;
         }
@@ -765,13 +773,13 @@ class PressReleaseService
             // werden. Ohne hinterlegten Namen bleibt $recipientName leer,
             // das Template grüßt dann neutral.
             $contact = $pressRelease->contacts()
-                ->withoutGlobalScopes()
+                ->withoutGlobalScope(PortalScope::class)
                 ->whereNotNull('contacts.email')
                 ->where('contacts.email', '!=', '')
                 ->orderBy('contacts.id')
                 ->first();
 
-            $company = Company::withoutGlobalScopes()->find($pressRelease->company_id);
+            $company = Company::withoutGlobalScope(PortalScope::class)->find($pressRelease->company_id);
             $companyName = trim((string) $company?->name);
 
             // Gesperrte Adressen (Bounce-Suppression, 1b.6) überspringen:

app/Services/PressRelease/VisibilityStats.php

@@ -8,6 +8,7 @@ use App\Enums\PressReleaseStatus;
 use App\Models\Company;
 use App\Models\PressRelease;
 use App\Models\PressReleaseEvent;
+use App\Scopes\PortalScope;
 use App\Support\CrawlerIdentifier;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Collection;
@@ -46,7 +47,7 @@ class VisibilityStats
      */
     public function companySummary(Company $company, int $days = 30): array
     {
-        $base = PressRelease::query()->withoutGlobalScopes()->where('company_id', $company->id);
+        $base = PressRelease::query()->withoutGlobalScope(PortalScope::class)->where('company_id', $company->id);
 
         $row = $base->clone()
             ->selectRaw('count(*) as releases')