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>

database/migrations/2026_09_18_160000_add_email_index_to_contacts_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * B-Tree-Index auf `contacts.email` (Audit F22).
+ *
+ * `contacts` hatte auf `email` nur den FULLTEXT für die Admin-Suche – ein
+ * `WHERE email = ?` (Login-Sync, Magic-Link-Zugang, Bounce-Import) lief als
+ * Vollscan über 21.000 Zeilen. Wie bei `companies_email_idx`: `ADD INDEX`
+ * läuft trotz vorhandenem FULLTEXT `INPLACE`, bei 6 MB eine Sache von
+ * Sekunden.
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('contacts', function (Blueprint $table) {
+            $table->index('email', 'contacts_email_idx');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('contacts', function (Blueprint $table) {
+            $table->dropIndex('contacts_email_idx');
+        });
+    }
+};

database/migrations/2026_09_18_170000_add_content_hash_to_ki_audits_table.php

@@ -0,0 +1,40 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * KI-Ergebnisse an die geprüfte Inhaltsversion binden (Audit F07).
+ *
+ * `content_hash` ist die Prüfsumme (ContentFingerprint) des Textes, den der
+ * Treiber tatsächlich gesehen hat. `discarded_at` markiert Ergebnisse, die
+ * beim Speichern nicht mehr zum aktuellen Inhalt passten und deshalb
+ * verworfen wurden – sie bleiben als Audit-Spur erhalten. Kleine Tabelle,
+ * kein Volltext-Index.
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('ki_audits', function (Blueprint $table) {
+            if (! Schema::hasColumn('ki_audits', 'content_hash')) {
+                $table->char('content_hash', 64)->nullable()->after('raw_response');
+            }
+
+            if (! Schema::hasColumn('ki_audits', 'discarded_at')) {
+                $table->timestamp('discarded_at')->nullable()->after('content_hash');
+            }
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('ki_audits', function (Blueprint $table) {
+            $table->dropColumn(array_filter([
+                Schema::hasColumn('ki_audits', 'content_hash') ? 'content_hash' : null,
+                Schema::hasColumn('ki_audits', 'discarded_at') ? 'discarded_at' : null,
+            ]));
+        });
+    }
+};

database/migrations/2026_09_18_170100_add_quota_period_to_users_table.php

@@ -0,0 +1,39 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Kalendermonat des Kontingent-Verbrauchs (Audit F18, E5).
+ *
+ * `press_release_quota_period` (YYYY-MM) sagt, für welchen Monat
+ * `press_release_quota_used_this_month` gilt. Weicht er vom laufenden Monat
+ * ab, zählt der Verbrauch als null – beim Lesen wie beim Verbrauchen. Der
+ * Reset-Cron am Monatsersten wird damit zum Aufräumer statt zur einzigen
+ * Wahrheit: ein verpasster Lauf sperrt niemanden mehr aus, ein doppelter
+ * löscht keinen Verbrauch des laufenden Monats.
+ *
+ * Kosten: `users` (25 MB) trägt einen Volltext-Index, ADD COLUMN läuft
+ * deshalb als COPY – wenige Sekunden, nachts einspielen.
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            if (! Schema::hasColumn('users', 'press_release_quota_period')) {
+                $table->char('press_release_quota_period', 7)->nullable()->after('press_release_quota_used_this_month');
+            }
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            if (Schema::hasColumn('users', 'press_release_quota_period')) {
+                $table->dropColumn('press_release_quota_period');
+            }
+        });
+    }
+};