billing: MAN-Rechnungen fuer Ueberweisungskunden bearbeiten, hold-Altlast bereinigen

Bestandskunden aus dem Altsystem zahlen per Ueberweisung; nach dem 04:30-Lauf
fehlte bisher der gesamte Bearbeitungsweg (kein PDF, keine Mail, kein
Zahlungseingang, kein Bestandsschutz-Ende). Plan und Befund:
dev/lagacy-rechnungen/entwicklungsplan-2026-09-16.md.

Bereinigung (legacy:settle-unpaid, wiederholbar):
- Legacy-Status hold = nie bezahlt, ersatzlos erledigt. 9 daraus abgeleitete
  Bestandsschutz-Buendel werden gekuendigt, MAN-00001/00002 storniert.
  Archivzeilen bleiben erhalten, sind aber in Admin-Archiv und Kundenkonto
  standardmaessig ausgeblendet.
- pending/reminder (recurring) = offene Vorgaenge: Periode auf den
  Leistungsbeginn der unbezahlten Rechnung zurueckgedreht und als MAN-Rechnung
  neu ausgestellt (Archiv-Status superseded, replaces_legacy_invoice_number).
- pending/reminder (single) = abgeschrieben (uncollectible).
- legacy:grandfather-subscriptions wertet den Zahlungsstatus jetzt selbst aus.

Workflow in /admin/payments (ManualInvoiceDunningService, je Aktion mit
Eintrag im Aktivitaets-Verlauf):
- Rechnung senden: Mail mit PDF-Anhang, Bankverbindung aus billing.issuer,
  Hinweis auf Bestandsschutz-Ende; Zahlungsziel zaehlt ab Versand.
- Erinnerung: gleiche Mail im Mahn-Ton, Nachfrist bei verstrichener Frist.
- Bezahlt: Zahlungseingang laut Kontoauszug verbuchen.
- Bestandsschutz beenden: Rechnung storniert (nie geloescht), Buendel
  gekuendigt, weitere offene MAN-Rechnungen des Kunden storniert, optionale
  Kundenmail.
- Panel "Blockierte Vereinbarungen": faellige Posten ohne Rechnung (meist
  fehlende Rechnungsadresse) mit "Jetzt abrechnen" oder "Entfernen".

Schema: invoices bekommt user_payment_option_id, sent_at, reminded_at,
reminder_count, voided_at, void_reason, replaces_legacy_invoice_number
(inkl. Backfill der bestehenden MAN-Rechnungen). PDF-Primitiven des
Archiv-Renderers in den Trait DrawsPdf ausgelagert; MAN-PDF on-demand ueber
admin.invoices.pdf / me.invoices.manual-pdf (InvoicePolicy).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

app/Mail/ManualInvoiceIssued.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace App\Mail;
+
+use App\Models\Invoice;
+use App\Models\User;
+use App\Services\Billing\ManualInvoicePdfRenderer;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Mail\Attachment;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+/**
+ * Rechnung an einen Legacy-Überweisungskunden (MAN-Kreis) mit PDF im
+ * Anhang, Bankverbindung, Zahlungsziel und dem Hinweis, dass der
+ * Bestandsschutz ohne Zahlung zum Zahlungsziel endet. Als Zahlungs-
+ * erinnerung (`$isReminder`) mit gleichem Inhalt im Mahn-Ton.
+ *
+ * Transaktionsmail: bewusst ohne Opt-out. Die Bounce-Sperrliste greift
+ * über `GateOutgoingMail`; der Service prüft sie zusätzlich vorab.
+ */
+class ManualInvoiceIssued extends Mailable implements ShouldQueue
+{
+    use Queueable, SerializesModels;
+
+    public string $invoicesUrl;
+
+    public string $bookingUrl;
+
+    public string $serviceName;
+
+    /** @var array{0: string, 1: string}|null */
+    public ?array $servicePeriod;
+
+    /** @var array<string, string> */
+    public array $issuer;
+
+    public function __construct(
+        public readonly User $user,
+        public readonly Invoice $invoice,
+        public readonly bool $isReminder = false,
+    ) {
+        $renderer = app(ManualInvoicePdfRenderer::class);
+
+        $this->invoicesUrl = route('me.invoices.index');
+        $this->bookingUrl = route('me.bookings.index');
+        $this->serviceName = $renderer->serviceName($invoice);
+        $this->servicePeriod = $renderer->servicePeriod($invoice);
+        $this->issuer = array_map(fn (mixed $value): string => (string) $value, (array) config('billing.issuer', []));
+    }
+
+    public function envelope(): Envelope
+    {
+        $bcc = (string) config('legal.contact_email');
+
+        $subject = $this->isReminder
+            ? 'Zahlungserinnerung — Rechnung '.$this->invoice->number
+            : 'Ihre Rechnung '.$this->invoice->number.' — Bestandsschutz auf pressekonto';
+
+        return new Envelope(
+            subject: $subject,
+            bcc: $bcc !== '' ? [$bcc] : [],
+        );
+    }
+
+    public function content(): Content
+    {
+        return new Content(view: 'emails.billing.manual-invoice-issued');
+    }
+
+    /**
+     * @return array<int, Attachment>
+     */
+    public function attachments(): array
+    {
+        $renderer = app(ManualInvoicePdfRenderer::class);
+
+        return [
+            Attachment::fromData(fn (): string => $renderer->render($this->invoice), $renderer->filename($this->invoice))
+                ->withMime('application/pdf'),
+        ];
+    }
+}