admin: internes Newsletter-Modul mit Filtern, Protokoll und Abmeldung

Neues Modul unter Admin ▸ Newsletter (nur users:manage): Kampagnen mit
Betreff + leicht formatiertem Text (Purifier-Profil newsletter: fett/
kursiv, Listen, Links) im zentralen Mail-Layout. Empfänger-Filter auf
der User-Datenbank: Portal, Legacy-Vertrag (Bestandsschutz), Login
innerhalb/außerhalb X Monaten, Sortierung nach Login/Erstellung — mit
Live-Zähler und Vorschau im Editor.

Versand friert die Empfängerliste als Protokoll ein (newsletter_
campaign_recipients) und stellt pro Empfänger einen Queue-Job ein;
der Opt-out wird im Worker erneut geprüft. Jede Mail trägt den
signierten One-Click-Abmelde-Link (neuer EmailNotificationType::
Newsletter, bestehende Unsubscribe-Infrastruktur inkl. RFC 8058);
die Abmeldung greift sofort für alle künftigen Auswahlen.

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

app/Services/Newsletter/CampaignSender.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Services\Newsletter;
+
+use App\Enums\NewsletterCampaignStatus;
+use App\Enums\NewsletterRecipientStatus;
+use App\Jobs\SendNewsletterCampaignMail;
+use App\Models\NewsletterCampaign;
+use App\Models\User;
+
+/**
+ * Startet den Versand einer Newsletter-Kampagne: friert die Empfängerliste
+ * laut Filter als Protokoll-Zeilen ein (Status pending) und stellt pro
+ * 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.
+ */
+class CampaignSender
+{
+    public function __construct(private readonly CampaignRecipients $recipients) {}
+
+    /**
+     * @return int Anzahl der eingeplanten Empfänger.
+     */
+    public function start(NewsletterCampaign $campaign): int
+    {
+        if (! $campaign->isDraft()) {
+            return 0;
+        }
+
+        $total = 0;
+
+        $this->recipients->query($campaign->filters ?? [])
+            ->select(['id', 'email'])
+            ->chunkById(500, function ($users) use ($campaign, &$total): void {
+                $rows = $users->map(fn (User $user): array => [
+                    'newsletter_campaign_id' => $campaign->id,
+                    'user_id' => $user->id,
+                    'email' => $user->email,
+                    'status' => NewsletterRecipientStatus::Pending->value,
+                    'created_at' => now(),
+                    'updated_at' => now(),
+                ])->all();
+
+                $campaign->recipients()->insert($rows);
+                $total += count($rows);
+            });
+
+        if ($total === 0) {
+            return 0;
+        }
+
+        $campaign->update([
+            'status' => NewsletterCampaignStatus::Sending->value,
+            'recipients_total' => $total,
+        ]);
+
+        $campaign->recipients()
+            ->select(['id'])
+            ->chunkById(500, function ($recipients): void {
+                foreach ($recipients as $recipient) {
+                    SendNewsletterCampaignMail::dispatch($recipient->id);
+                }
+            });
+
+        return $total;
+    }
+}