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>

tests/Feature/Billing/GrandfatherLegacySubscriptionsTest.php

@@ -206,3 +206,53 @@ test('after migration the MAN circle invoices a due legacy agreement with proper
     expect($due->first()->fresh()->current_period_end->toDateString())->toBe('2027-05-14');
     expect(Invoice::count())->toBe(1);
 });
+
+test('a never-paid (hold) latest invoice yields no grandfathering', function () {
+    $user = User::factory()->create();
+    legacyArchiveInvoice($user, ['status' => 'hold']);
+
+    $this->artisan(GrandfatherLegacySubscriptions::class, ['--no-report' => true])
+        ->expectsOutputToContain('Übersprungen (hold, nie bezahlt)')
+        ->assertSuccessful();
+
+    expect(UserPaymentOption::count())->toBe(0);
+});
+
+test('an open (reminder) latest invoice is grandfathered with the unpaid period due and the MAN circle re-issues it', function () {
+    $user = User::factory()->create();
+    BillingAddress::factory()->create(['user_id' => $user->id, 'country_code' => 'DE']);
+
+    // Legacy stellte am 30.06.2026 die Periode 14.06.2026–13.06.2027 in
+    // Rechnung (199,00 € brutto), im Altsystem bereits gemahnt, nie bezahlt.
+    $legacy = legacyArchiveInvoice($user, [
+        'number' => 'BP-42489-10',
+        'legacy_portal' => 'businessportal24',
+        'status' => 'reminder',
+        'invoice_date' => '2026-06-30',
+        'total_cents' => 19900,
+        'raw_snapshot' => ['service_period_begin_date' => '2026-06-14', 'service_period_end_date' => '2027-06-13'],
+        'pdf_payload' => ['user_payment_option' => ['next_due_date' => '2027-06-14']],
+    ]);
+
+    Carbon::setTestNow('2026-09-16 09:00:00');
+    $this->artisan(GrandfatherLegacySubscriptions::class, ['--no-report' => true])->assertSuccessful();
+
+    $agreement = UserPaymentOption::sole();
+    expect($agreement->status)->toBe(UserPaymentOptionStatus::Grandfathered);
+    // Fällig ist der Leistungsbeginn der unbezahlten Rechnung, nicht 2027.
+    expect($agreement->current_period_end->toDateString())->toBe('2026-06-14');
+    expect($agreement->current_period_start->toDateString())->toBe('2025-06-14');
+    expect($agreement->legacy_conditions['open_legacy_invoice']['number'])->toBe('BP-42489-10');
+
+    $service = app(ManualInvoiceService::class);
+    $invoice = $service->invoiceFor($agreement);
+
+    expect($invoice)->not->toBeNull();
+    expect($invoice->replaces_legacy_invoice_number)->toBe('BP-42489-10');
+    expect($invoice->user_payment_option_id)->toBe($agreement->id);
+    expect($invoice->total_cents)->toBe(19900);
+    expect($agreement->fresh()->current_period_end->toDateString())->toBe('2027-06-14');
+    expect($agreement->fresh()->legacy_conditions)->not->toHaveKey('open_legacy_invoice');
+    expect($legacy->fresh()->status)->toBe(LegacyInvoice::STATUS_SUPERSEDED);
+    expect($legacy->fresh()->raw_snapshot['superseded_by_invoice_number'])->toBe($invoice->number);
+});