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/Console/Commands/GrandfatherLegacySubscriptions.php

@@ -21,6 +21,13 @@ use Illuminate\Support\Facades\Storage;
  * = active` und eine nicht zu weit zurückliegende `next_due_date` trägt.
  * Alle anderen Rechnungen bleiben unangetastet im Archiv.
  *
+ * Zahlungsstatus der jüngsten Rechnung (Einordnung 16.09.2026):
+ *  - `paid`    → Bestandsschutz mit der laufenden Periode.
+ *  - `pending`/`reminder` → Bestandsschutz, aber die Rechnung ist offen: die
+ *    Periode wird auf den Leistungsbeginn dieser Rechnung gesetzt, sodass der
+ *    MAN-Kreis sie neu ausstellt (`legacy_conditions.open_legacy_invoice`).
+ *  - `hold`    → nie bezahlt, kein Bestandsschutz (übersprungen).
+ *
  * Die migrierte Vereinbarung trägt `current_period_end = next_due_date` —
  * damit stellt `billing:generate-manual-invoices` (MAN-Kreis) die nächste
  * Rechnung zum gewohnten Rhythmus mit den Beträgen der letzten
@@ -68,12 +75,24 @@ class GrandfatherLegacySubscriptions extends Command
             'created' => [],
             'updated' => [],
             'stale_skipped' => [],
+            'unpaid_skipped' => [],
+            'reopened_unpaid' => [],
             'immediately_due' => [],
         ];
 
         foreach ($candidates as $candidate) {
             $nextDue = $candidate['next_due_date'];
 
+            if ($candidate['source_status'] === LegacyInvoice::STATUS_HOLD) {
+                $report['unpaid_skipped'][] = $this->describe($candidate);
+
+                continue;
+            }
+
+            if ($candidate['open_legacy_invoice'] !== null) {
+                $report['reopened_unpaid'][] = $this->describe($candidate);
+            }
+
             if ($nextDue->lessThan($staleBefore)) {
                 $report['stale_skipped'][] = $this->describe($candidate);
 
@@ -120,6 +139,8 @@ class GrandfatherLegacySubscriptions extends Command
                 ['Neu angelegt', count($report['created'])],
                 ['Aktualisiert (Re-Run)', count($report['updated'])],
                 ['Übersprungen (stale)', count($report['stale_skipped'])],
+                ['Übersprungen (hold, nie bezahlt)', count($report['unpaid_skipped'])],
+                ['Offene Alt-Rechnung → MAN neu', count($report['reopened_unpaid'])],
                 ['Davon sofort fällig', count($report['immediately_due'])],
             ],
         );
@@ -197,6 +218,22 @@ class GrandfatherLegacySubscriptions extends Command
             ? Carbon::parse($snapshot['service_period_begin_date'])->startOfDay()
             : $nextDue->copy()->subYear();
 
+        $openLegacyInvoice = null;
+
+        // Offene Rechnung: Die zuletzt fakturierte Periode ist noch nicht
+        // bezahlt → Fälligkeit auf deren Leistungsbeginn setzen, damit der
+        // MAN-Kreis genau diese Periode neu ausstellt.
+        if (in_array($invoice->status, [LegacyInvoice::STATUS_PENDING, LegacyInvoice::STATUS_REMINDER], true)) {
+            $openLegacyInvoice = [
+                'id' => $invoice->id,
+                'number' => $invoice->number,
+                'invoice_date' => $invoice->invoice_date->toDateString(),
+                'total_cents' => $invoice->total_cents,
+            ];
+            $nextDue = $periodStart->copy();
+            $periodStart = $nextDue->copy()->subYear();
+        }
+
         return [
             'user_id' => $invoice->user_id,
             'legacy_portal' => $invoice->legacy_portal->value,
@@ -207,6 +244,8 @@ class GrandfatherLegacySubscriptions extends Command
             'valid_until_date' => isset($upo['valid_until_date']) && $upo['valid_until_date']
                 ? Carbon::parse($upo['valid_until_date'])->startOfDay()
                 : null,
+            'source_status' => $invoice->status,
+            'open_legacy_invoice' => $openLegacyInvoice,
             'legacy_conditions' => [
                 'legacy_portal' => $invoice->legacy_portal->value,
                 'legacy_user_payment_option_id' => (int) $upo['id'],
@@ -219,6 +258,7 @@ class GrandfatherLegacySubscriptions extends Command
                 'last_is_netto' => (bool) ($snapshot['is_netto'] ?? false),
                 'source_invoice_number' => $invoice->number,
                 'source_invoice_date' => $invoice->invoice_date->toDateString(),
+                ...($openLegacyInvoice ? ['open_legacy_invoice' => $openLegacyInvoice] : []),
             ],
         ];
     }