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>
This commit is contained in:
Kevin Adametz 2026-09-18 10:40:48 +00:00
parent 301bca3a90
commit 72432fdb82
73 changed files with 1746 additions and 170 deletions

View file

@ -34,14 +34,24 @@ class NewsroomDetailPageData
// (Cache-Poisoning über z. B. ?page=2.5).
$page = Paginator::resolveCurrentPage();
// Bewusst VOR dem Seiten-Cache: eine Entfernung (410) muss sofort
// greifen, auch wenn für den Slug noch ein bis zu eine Stunde alter
// Stale-Eintrag im Cache liegt. Kostet einen indizierten Slug-Lookup
// pro Aufruf — vertretbar, weil Entfernungen rechtlich motiviert sind.
if ($this->isGone($context, $slug)) {
// Bewusst VOR dem Seiten-Cache: eine Entfernung (410), Löschung oder
// Deaktivierung muss sofort greifen, auch wenn für den Slug noch ein
// bis zu eine Stunde alter Stale-Eintrag im Cache liegt. Kostet einen
// indizierten Slug-Lookup pro Aufruf — vertretbar, weil Entfernungen
// rechtlich motiviert sind.
$visibility = $this->publicVisibility($context, $slug);
if ($visibility?->gone_at !== null) {
return ['tombstone' => 'removed'];
}
// Gelöscht (Soft Delete) oder deaktiviert: nie aus dem Cache bedienen.
// Der Neuaufbau liefert 404 — oder die Weiterleitung, falls die Firma
// in einer Zusammenführung aufgegangen ist (F13).
if ($visibility === null || ! $visibility->is_active) {
return $this->buildUncached($context, $slug);
}
$cacheKey = WebPageCache::key('newsroom', [
implode('-', $context->portalValues),
$context->language,
@ -57,17 +67,18 @@ class NewsroomDetailPageData
}
/**
* Newsroom mit 410 entfernt? Vollständig gelöschte Firmen (Soft Delete)
* bleiben bewusst außen vor — deren URL antwortet weiterhin mit 404.
* Sichtbarkeitsstatus der Firma hinter dem Slug (nur die dafür nötigen
* Spalten). Null bei unbekanntem Slug und bei vollständig gelöschten
* Firmen (Soft Delete) — deren URL antwortet weiterhin mit 404, ein
* gesetztes `gone_at` dagegen mit 410.
*/
private function isGone(WebPortalContext $context, string $slug): bool
private function publicVisibility(WebPortalContext $context, string $slug): ?Company
{
return Company::query()
->withoutGlobalScope(PortalScope::class)
->whereIn('portal', $context->portalValues)
->where('slug', $slug)
->whereNotNull('gone_at')
->exists();
->first(['id', 'is_active', 'gone_at']);
}
/**