web/seo: Änderungsdatum unabhängig von Aufrufen, EN-URLs in Sitemap und Legacy-API, signierte Bounce-Referenz, Merge/Canonical konsistent (Umsetzungsaudit 29.09.: R-02 bis R-11, N17, N18, OPT-1, OPT-2; 02.10.: O01)

- R-02/K-03: Aufrufaggregation und Merge ändern updated_at nicht mehr; neue
  Spalte press_releases.content_changed_at (INSTANT), contentModifiedAt()
  für Sitemap-lastmod, dateModified und article:modified_time
- R-03: Sitemap und Legacy-view_url mit /en/ für englische Meldungen
- R-04/O01: X-Pk-Ref je Empfänger per HMAC signiert; auf eine Sperre zählt —
  hart wie weich — nur ein gültig signierter Rückläufer, unsignierte
  standardmäßig nur zur Sichtung (BOUNCE_UNSIGNED_KIND=policy)
- R-05/R-06: Unmerge setzt nur unveränderte Füllwerte zurück
  (company_merge_moves.merged_value), Canonical-Neubewertung nach Merge und
  Unmerge, assignAll setzt veraltete Verweise zurück
- R-07 bis R-11: Crawler zählen nicht als Aufruf, Mail-Klick gedrosselt und
  verzögert geschrieben, Claim-Zähler erst nach Versand, email_bounces nach
  395 Tagen gelöscht, Canonical-Portal über Kategorie-ID, llms-Cache geleert,
  Feed-Teaser ohne Doppel-Escaping, Merge-Ketten aufgelöst
- N17/N18: kein falsches „gelistet seit", Rollen im Indexbericht wie Sitemap
- OPT-1/OPT-2: topFeeds in SQL, purge-events löscht nach Grenz-ID

Enthält aus PressRelease.php auch die Card-Bild-Helfer (B-01) und
wasEverPublished()/neverPublished() (A-05), weil die Datei ungeteilt
committet ist.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-10-02 13:09:00 +00:00
parent 1d417f87f7
commit c2e0b85242
48 changed files with 1676 additions and 134 deletions

View file

@ -7,10 +7,14 @@ use App\Enums\ConversionSource;
use App\Models\PressRelease;
use App\Scopes\PortalScope;
use App\Services\Conversion\ConversionRecorder;
use App\Support\CrawlerIdentifier;
use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\RateLimiter;
use Symfony\Component\HttpFoundation\Response;
use function Illuminate\Support\defer;
/**
* Stufe 1 der Konversionsleiter: Mail-Link geklickt (Roadmap 0.5).
*
@ -26,7 +30,9 @@ use Symfony\Component\HttpFoundation\Response;
* fälschungssicher mitführt; der `pr`-Parameter entfällt dann.
*
* Nur Herkünfte aus Mails lösen aus. `organic` würde sonst bei jedem
* getippten Parameter ein Ereignis erzeugen.
* getippten Parameter ein Ereignis erzeugen. Gedrosselt je IP und Meldung,
* Link-Scanner ausgenommen, geschrieben nach der Antwort (R-08,
* config/conversion.php `mail_clicks`).
*/
class RecordMailLinkClick
{
@ -41,32 +47,64 @@ class RecordMailLinkClick
}
// Nur echte Aufrufe. Mailclients und Sicherheitsscanner holen Links
// vorab per HEAD; das wäre kein Klick, sondern eine Zustellung.
if (! $request->isMethod('GET')) {
// vorab per HEAD oder mit eigener Kennung; das wäre kein Klick,
// sondern eine Zustellung (Umsetzungsaudit 29.09.2026, R-08).
if (! $request->isMethod('GET') || $this->isScanner($request->userAgent())) {
return $next($request);
}
$pressRelease = $this->pressRelease($request);
$pressReleaseId = max(0, (int) $request->query('pr'));
$this->recorder->record(
ConversionEventType::MailLinkClicked,
$source,
$this->recorder->companyOf($pressRelease),
$pressRelease,
);
// Derselbe Klick (Doppelklick, erneutes Öffnen, Scanner mit Browser-
// Kennung) zählt je IP und Meldung höchstens einmal im Zeitfenster.
$key = 'mail-click:'.hash('sha256', (string) $request->ip()).':'.$source->value.':'.$pressReleaseId;
$decay = max(1, (int) config('conversion.mail_clicks.throttle_minutes', 30)) * 60;
if (! RateLimiter::attempt($key, 1, static fn (): bool => true, $decay)) {
return $next($request);
}
// Nach der Antwort: Der Eintritt über den Mail-Link wartet nicht auf
// die Statistik.
$recorder = $this->recorder;
defer(function () use ($recorder, $source, $pressReleaseId): void {
$pressRelease = $this->pressRelease($pressReleaseId);
$recorder->record(
ConversionEventType::MailLinkClicked,
$source,
$recorder->companyOf($pressRelease),
$pressRelease,
);
});
return $next($request);
}
private function isScanner(?string $userAgent): bool
{
$userAgent = mb_strtolower(trim((string) $userAgent));
if ($userAgent === '' || CrawlerIdentifier::identify($userAgent) !== null) {
return true;
}
foreach ((array) config('conversion.mail_clicks.scanner_agents', []) as $pattern) {
if (str_contains($userAgent, mb_strtolower((string) $pattern))) {
return true;
}
}
return false;
}
/**
* Scope-frei aufgelöst: Der Klick landet je nach Link auf dem Hub oder auf
* einem der beiden Spokes, der Portal-Scope würde die Meldung dort
* wegfiltern.
*/
private function pressRelease(Request $request): ?PressRelease
private function pressRelease(int $id): ?PressRelease
{
$id = (int) $request->query('pr');
if ($id <= 0) {
return null;
}