admin: Newsletter mit Abmelde-Liste, Follow-up-Filtern und gedrosseltem Versand

- Unterseite /admin/newsletter/abmeldungen listet Newsletter-Opt-outs mit
  Zeitpunkt, Suche und Link zur User-Detailseite
- Kampagnen-Filter: Empfänger einer früheren Kampagne ausschließen
  (Abgleich per User-ID und E-Mail-Snapshot) für Follow-up-Mailings
- Login-Filter kann Monats-Scheiben (von–bis) abgrenzen, um große
  Listen Monat für Monat abzuarbeiten
- Versand läuft in Wellen (Standard 50 Mails / 15 Min, per .env
  justierbar) gegen SMTP-Limits und Blocklisten; Hinweis im Senden-Modal
- web: Firmen-Website im Newsroom & Co. als absolute URL verlinkt
  (Company::websiteUrl), statt relativ auf /newsroom/www.example.de
- kunde: API-Doku-Button öffnet die /de/api-Seite; OpenAPI-Spezifikation
  als eigener, benannter Download (pressekonto-api-v1.yml)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

app/Services/Newsletter/CampaignSender.php

@@ -14,6 +14,10 @@ use App\Models\User;
  * Empfänger einen Queue-Job ein. Der tatsächliche Versand läuft im Worker;
  * dort wird der Opt-out-Stand erneut geprüft, damit eine Abmeldung zwischen
  * Versandstart und Versand sofort greift.
+ *
+ * Große Listen werden gedrosselt: Die Jobs erhalten gestaffelte Delays in
+ * Wellen laut config('newsletter.campaign'), damit das SMTP-Limit des
+ * Providers nicht reißt und die Domain nicht auf Blocklisten landet.
  */
 class CampaignSender
 {
@@ -55,14 +59,43 @@ class CampaignSender
             'recipients_total' => $total,
         ]);
 
+        $batchSize = max(1, (int) config('newsletter.campaign.batch_size'));
+        $intervalSeconds = max(1, (int) config('newsletter.campaign.batch_interval_minutes')) * 60;
+        $position = 0;
+
         $campaign->recipients()
-            ->select(['id'])
-            ->chunkById(500, function ($recipients): void {
-                foreach ($recipients as $recipient) {
-                    SendNewsletterCampaignMail::dispatch($recipient->id);
+            ->toBase()
+            ->select('id')
+            ->chunkById(500, function ($rows) use ($batchSize, $intervalSeconds, &$position): void {
+                foreach ($rows as $row) {
+                    SendNewsletterCampaignMail::dispatch((int) $row->id)
+                        ->delay(intdiv($position, $batchSize) * $intervalSeconds);
+                    $position++;
                 }
             });
 
         return $total;
     }
+
+    /**
+     * Drossel-Hinweis für die Admin-UI, z. B. „max. 50 Mails alle 15 Minuten —
+     * Gesamtdauer ca. 3,5 Stunden“. Null, wenn alles in die erste Welle passt.
+     */
+    public static function throttleSummary(int $total): ?string
+    {
+        $batchSize = max(1, (int) config('newsletter.campaign.batch_size'));
+        $intervalMinutes = max(1, (int) config('newsletter.campaign.batch_interval_minutes'));
+
+        if ($total <= $batchSize) {
+            return null;
+        }
+
+        $durationMinutes = ((int) ceil($total / $batchSize) - 1) * $intervalMinutes;
+
+        $duration = $durationMinutes < 60
+            ? sprintf('%d Minuten', $durationMinutes)
+            : sprintf('%s Stunden', number_format($durationMinutes / 60, 1, ',', '.'));
+
+        return sprintf('max. %d Mails alle %d Minuten — Gesamtdauer ca. %s', $batchSize, $intervalMinutes, $duration);
+    }
 }