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/PressReleaseQuotaTest.php

@@ -14,6 +14,7 @@ use App\Models\UserPaymentOption;
 use App\Services\PressRelease\PressReleaseService;
 use App\Services\PressRelease\QuotaExceededException;
 use Database\Seeders\RolesAndPermissionsSeeder;
+use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\Queue;
 use Tests\TestCase;
 
@@ -236,3 +237,38 @@ test('monthly reset command zeroes the used counter', function () {
     expect(User::where('press_release_quota_used_this_month', '>', 0)->count())->toBe(0);
     expect($untouched->fresh()->press_release_quota_used_this_month)->toBe(0);
 });
+
+test('quota consumption resets lazily when the calendar month changes, without the cron (Audit F18)', function () {
+    Carbon::setTestNow('2026-09-18 10:00:00');
+
+    $user = quotaTestSubscriber(planQuota: 3, used: 3);
+    // Verbrauch aus dem Vormonat – der Reset-Cron ist ausgefallen.
+    $user->forceFill(['press_release_quota_period' => '2026-08'])->save();
+
+    expect($user->fresh()->pressReleaseQuotaRemaining())->toBe(3);
+
+    $pr = quotaTestPressRelease($user, 'review');
+    app(PressReleaseService::class)->publish($pr);
+
+    $fresh = $user->fresh();
+    expect($fresh->press_release_quota_used_this_month)->toBe(1)
+        ->and($fresh->press_release_quota_period)->toBe('2026-09')
+        ->and($fresh->pressReleaseQuotaRemaining())->toBe(2);
+});
+
+test('the monthly reset is idempotent and leaves this month\'s consumption alone (Audit F18)', function () {
+    /** @var TestCase $this */
+    Carbon::setTestNow('2026-09-01 00:05:00');
+
+    $thisMonth = User::factory()->create(['press_release_quota_used_this_month' => 2, 'press_release_quota_period' => '2026-09']);
+    $lastMonth = User::factory()->create(['press_release_quota_used_this_month' => 2, 'press_release_quota_period' => '2026-08']);
+    $unknown = User::factory()->create(['press_release_quota_used_this_month' => 2, 'press_release_quota_period' => null]);
+
+    $this->artisan(ResetMonthlyPressReleaseQuota::class)->assertSuccessful();
+    $this->artisan(ResetMonthlyPressReleaseQuota::class)->assertSuccessful();
+
+    expect($thisMonth->fresh()->press_release_quota_used_this_month)->toBe(2)
+        ->and($lastMonth->fresh()->press_release_quota_used_this_month)->toBe(0)
+        ->and($lastMonth->fresh()->press_release_quota_period)->toBe('2026-09')
+        ->and($unknown->fresh()->press_release_quota_used_this_month)->toBe(0);
+});