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/Services/Billing/InvoiceNumberGenerator.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Services\Billing;
+
+use Illuminate\Support\Facades\DB;
+use InvalidArgumentException;
+
+/**
+ * Vergibt fortlaufende Rechnungsnummern pro Rechnungskreis (hybrides Modell):
+ *
+ * - `STR` — neuer Stripe-Shop-Kreislauf (alle neuen Abschlüsse/Zahlungen)
+ * - `MAN` — manueller Legacy-Kreis ab Relaunch (laufende Alt-Zahlungen
+ *   werden weiter per Rechnung abgerechnet)
+ *
+ * Die Vergabe läuft atomar über einen Row-Lock auf der Sequenz-Tabelle,
+ * damit Nummern auch bei parallelen Prozessen (Webhook + Scheduler)
+ * lückenlos und eindeutig bleiben.
+ */
+class InvoiceNumberGenerator
+{
+    public const CIRCLE_STRIPE = 'STR';
+
+    public const CIRCLE_MANUAL = 'MAN';
+
+    public function nextStripeNumber(): string
+    {
+        return $this->next(self::CIRCLE_STRIPE);
+    }
+
+    public function nextManualNumber(): string
+    {
+        return $this->next(self::CIRCLE_MANUAL);
+    }
+
+    public function next(string $circle): string
+    {
+        if (! in_array($circle, [self::CIRCLE_STRIPE, self::CIRCLE_MANUAL], true)) {
+            throw new InvalidArgumentException("Unbekannter Rechnungskreis: {$circle}");
+        }
+
+        $number = DB::transaction(function () use ($circle): int {
+            $sequence = DB::table('invoice_number_sequences')
+                ->where('circle', $circle)
+                ->lockForUpdate()
+                ->first();
+
+            if (! $sequence) {
+                DB::table('invoice_number_sequences')->insert([
+                    'circle' => $circle,
+                    'next_number' => 2,
+                    'created_at' => now(),
+                    'updated_at' => now(),
+                ]);
+
+                return 1;
+            }
+
+            DB::table('invoice_number_sequences')
+                ->where('id', $sequence->id)
+                ->update(['next_number' => $sequence->next_number + 1, 'updated_at' => now()]);
+
+            return (int) $sequence->next_number;
+        });
+
+        $padding = (int) config('billing.invoice_number_padding', 5);
+
+        return sprintf('%s-%s', $circle, str_pad((string) $number, $padding, '0', STR_PAD_LEFT));
+    }
+}