Phase 9D: Tarif-Datenmodell, Cashier und hybride Rechnungskreise STR-/MAN-

Tarif-Datenmodell (Decision-Update):
- plans: Starter/Business/Pro/Agency mit Monats-/Jahrespreis (Jahres =
  10 x Monat), PM-Kontingent, Tageslimit, Stripe-IDs; idempotenter Seeder
- single_purchases: Einzel-PM, Extra-PM, Boost, PDF-Nachweis mit
  Status-Lifecycle und Stripe-Checkout-Referenzen
- laravel/cashier ^16.5 installiert (freigegeben); User ist Billable,
  Cashier-Migrationen published + ausgefuehrt; lokale invoices()-Relation
  ueberschreibt bewusst die Cashier-Methode

Hybride Rechnungskreise (Entscheidung 12.06.2026):
- invoice_number_sequences + InvoiceNumberGenerator: atomare fortlaufende
  Nummern pro Kreis (STR- fuer den neuen Stripe-Shop, MAN- fuer den
  manuellen Legacy-Kreis); Alt-Archiv legacy_invoices bleibt unveraendert
- ManualInvoiceService + billing:generate-manual-invoices (Scheduler
  taeglich 04:30): prueft aktive/grandfathered user_payment_options ohne
  Stripe-Subscription auf erreichtes Periodenende, friert die
  Rechnungsadresse als Snapshot ein, stellt die MAN-Rechnung aus
  (Zahlungsziel billing.manual_due_days) und schaltet die Periode weiter;
  Konditions-Overrides via legacy_conditions, sonst Netto-Preis +
  billing.vat_rate; nicht abrechenbare Faelle werden geloggt und
  beim naechsten Lauf erneut geprueft

Submit-Gate:
- User::hasActiveBooking() prueft jetzt echt (hinter
  billing.enforce_booking): Cashier-Abo, bezahlter Einzel-/Extra-PM-Kauf
  oder laufende Legacy-Vereinbarung (MAN-Kreis)

Suite: 468 passed, 4 skipped (17 neue Billing-Tests). Pint clean.
Offen fuer 9E: Stripe-Checkout/Webhooks, STR-Spiegelung, Slot-Logik auf
Plan-Kontingent, Migration der aktiven Legacy-Zahlungen in
user_payment_options.

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

app/Console/Commands/GenerateManualInvoices.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Services\Billing\ManualInvoiceService;
+use Illuminate\Console\Command;
+
+/**
+ * Fälligkeitsprüfung des manuellen Rechnungskreises (MAN-).
+ *
+ * Läuft täglich über den Scheduler und stellt für aktive Legacy-
+ * Zahlungsvereinbarungen (ohne Stripe-Subscription) die fälligen
+ * Rechnungen aus — wie im Legacy-System. Nicht abrechenbare
+ * Vereinbarungen (fehlende Rechnungsadresse o. ä.) werden geloggt und
+ * beim nächsten Lauf erneut geprüft.
+ */
+class GenerateManualInvoices extends Command
+{
+    protected $signature = 'billing:generate-manual-invoices
+                            {--dry-run : Nur anzeigen, was fällig ist}
+                            {--limit=50 : Maximale Anzahl Vereinbarungen pro Lauf}';
+
+    protected $description = 'Stellt fällige Rechnungen des manuellen Legacy-Rechnungskreises (MAN-) aus';
+
+    public function handle(ManualInvoiceService $service): int
+    {
+        $dryRun = (bool) $this->option('dry-run');
+        $limit = max(1, (int) $this->option('limit'));
+
+        $due = $service->duePaymentOptions(limit: $limit);
+
+        if ($due->isEmpty()) {
+            $this->info('Keine fälligen Zahlungsvereinbarungen gefunden.');
+
+            return self::SUCCESS;
+        }
+
+        $created = 0;
+        $skipped = 0;
+
+        foreach ($due as $option) {
+            if ($dryRun) {
+                $this->line(sprintf(
+                    '[dry-run] Fällig: Vereinbarung #%d (User #%s, Periode bis %s)',
+                    $option->id,
+                    $option->user_id,
+                    $option->current_period_end->toDateString(),
+                ));
+
+                continue;
+            }
+
+            $invoice = $service->invoiceFor($option);
+
+            if ($invoice) {
+                $created++;
+                $this->line(sprintf('Rechnung %s für Vereinbarung #%d erstellt.', $invoice->number, $option->id));
+            } else {
+                $skipped++;
+                $this->warn(sprintf('Vereinbarung #%d übersprungen (siehe Log).', $option->id));
+            }
+        }
+
+        if (! $dryRun) {
+            $this->info(sprintf('%d Rechnung(en) erstellt, %d übersprungen.', $created, $skipped));
+        }
+
+        return self::SUCCESS;
+    }
+}