Phase 9E (Abschluss): Checkout-Flows und Plan-Kontingent statt Quota-Stub

- Checkout-Backend: me.checkout.subscription (Tarif-Abo monatlich/jährlich)
  und me.checkout.single-pm (Einzel-PM 19 € netto, pending-Kauf mit
  Webhook-Erfüllung); StripeCheckoutService als mockbarer Stripe-Wrapper;
  Stripe Tax via Cashier::calculateTaxes() (Netto-Preise, USt-ID-Abfrage)
- Slot-Logik: Kontingent aus dem Tarif (plans.press_release_quota) plus
  bezahlte Einmalkäufe; Verbrauch bei Veröffentlichung zuerst aus dem
  Plan-Zähler, danach Einlösung des ältesten Einmalkaufs (consumed +
  PM-Verknüpfung); Grandfathered = unbegrenzt (Entscheidung 12.06.2026,
  Bestandsschutz); Stub-Spalte users.press_release_quota entfernt
- billing:sync-stripe-plans legt zusätzlich das Einzel-PM-Produkt an
  (STRIPE_PRICE_SINGLE_PM); Test-Mode-Sync gelaufen
- Buchungs-Seite: Rückmeldung nach Checkout (erfolg/abbruch/Guard-Hinweis)
- Tests: PressReleaseQuotaTest auf Plan-Semantik neu geschrieben,
  CheckoutFlowTest (8 Tests), Modal-/API-Tests angepasst; Suite 510 passed
- Doku: Billing-und-Rechnungskreise (Kontingent-Tabelle, Checkout-Routen,
  Webhook-Events, Stripe-CLI-Hinweis), PHASE-9-Plan 9E ✅, Checkliste,
  STATUS-ABGLEICH, PROGRESS

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

app/Http/Controllers/CheckoutController.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Enums\SinglePurchaseStatus;
+use App\Enums\SinglePurchaseType;
+use App\Models\Plan;
+use App\Models\SinglePurchase;
+use App\Services\Billing\StripeCheckoutService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Laravel\Cashier\Checkout;
+
+/**
+ * Einstieg in die Stripe-Checkouts (Phase 9E): Tarif-Abo und Einzel-PM.
+ *
+ * Die Routen leiten direkt zur Stripe-Checkout-Seite weiter; Erfolg und
+ * Abbruch landen auf der Buchungs-Seite (?checkout=erfolg|abbruch). Die
+ * Erfüllung übernimmt der Webhook (ProcessStripeWebhook): Cashier legt das
+ * Abo an, `checkout.session.completed` markiert den Einmalkauf als bezahlt.
+ */
+class CheckoutController extends Controller
+{
+    public function __construct(private readonly StripeCheckoutService $checkout) {}
+
+    public function subscription(Request $request, string $planSlug, string $interval): Checkout|RedirectResponse
+    {
+        $plan = Plan::query()->active()->where('slug', $planSlug)->firstOrFail();
+        $user = $request->user();
+
+        if ($user->subscribed()) {
+            return $this->backToBookings(__('Es besteht bereits ein aktives Abo. Ein Tarifwechsel ist aktuell über den Support möglich.'));
+        }
+
+        $priceId = $interval === 'yearly'
+            ? $plan->stripe_price_id_yearly
+            : $plan->stripe_price_id_monthly;
+
+        if (! $priceId) {
+            return $this->backToBookings(__('Dieser Tarif ist noch nicht buchbar. Bitte versuchen Sie es später erneut.'));
+        }
+
+        return $this->checkout->forSubscription($user, $plan, $interval);
+    }
+
+    public function singlePm(Request $request): Checkout|RedirectResponse
+    {
+        if (! config('billing.single_pm_stripe_price_id')) {
+            return $this->backToBookings(__('Die Einzel-Pressemitteilung ist noch nicht buchbar. Bitte versuchen Sie es später erneut.'));
+        }
+
+        $purchase = SinglePurchase::query()->create([
+            'user_id' => $request->user()->id,
+            'type' => SinglePurchaseType::SinglePm->value,
+            'status' => SinglePurchaseStatus::Pending->value,
+            'price_cents' => (int) config('billing.single_pm_price_cents'),
+            'currency' => 'EUR',
+        ]);
+
+        return $this->checkout->forSinglePurchase($request->user(), $purchase);
+    }
+
+    private function backToBookings(string $notice): RedirectResponse
+    {
+        return redirect()
+            ->route('me.bookings.index')
+            ->with('checkout-notice', $notice);
+    }
+}