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/Models/User.php

@@ -45,7 +45,6 @@ class User extends Authenticatable
         'legacy_portal',
         'legacy_id',
         'password',
-        'press_release_quota',
         'press_release_quota_used_this_month',
     ];
 
@@ -77,21 +76,87 @@ class User extends Authenticatable
             'last_seen_at' => 'datetime',
             'deleted_at' => 'datetime',
             'password' => 'hashed',
-            'press_release_quota' => 'integer',
             'press_release_quota_used_this_month' => 'integer',
         ];
     }
 
     /**
-     * Verbleibendes PM-Kontingent in diesem Monat.
-     *
-     * Temporärer Stub bis zum echten Tarif-/Credit-Modul. Die Schnittstelle
-     * (`pressReleaseQuotaRemaining()`) bleibt stabil, damit das
-     * Veröffentlichungs-Modal nicht neu gebaut werden muss.
+     * Der Tarif des aktiven Stripe-Abos, aufgelöst über die in `plans`
+     * gepflegten Stripe-Preis-IDs. Null ohne (gültiges) Abo.
      */
-    public function pressReleaseQuotaRemaining(): int
+    public function currentPlan(): ?Plan
     {
-        return max(0, (int) $this->press_release_quota - (int) $this->press_release_quota_used_this_month);
+        $subscription = $this->subscription();
+
+        if (! $subscription?->valid()) {
+            return null;
+        }
+
+        $priceId = $subscription->stripe_price;
+
+        if (! $priceId) {
+            return null;
+        }
+
+        return Plan::query()
+            ->where('stripe_price_id_monthly', $priceId)
+            ->orWhere('stripe_price_id_yearly', $priceId)
+            ->first();
+    }
+
+    /**
+     * Hat dieser User ein unbegrenztes PM-Kontingent?
+     *
+     * Entscheidung 12.06.2026: Bestandskunden (aktive/grandfathered
+     * Legacy-Vereinbarung) behalten ihren Bestandsschutz unverändert —
+     * das Alt-Produkt sah unbegrenzte PMs vor. Solange der Launch-Schalter
+     * `billing.enforce_booking` aus ist, gilt das Kontingent für niemanden.
+     */
+    public function hasUnlimitedPressReleaseQuota(): bool
+    {
+        if (! config('billing.enforce_booking')) {
+            return true;
+        }
+
+        return $this->userPaymentOptions()
+            ->whereIn('status', [
+                UserPaymentOptionStatus::Active->value,
+                UserPaymentOptionStatus::Grandfathered->value,
+            ])
+            ->exists();
+    }
+
+    /**
+     * Verbleibendes PM-Kontingent: Rest des Plan-Monatskontingents plus
+     * bezahlte, noch nicht eingelöste Einzel-/Extra-PM-Käufe.
+     * Null bedeutet unbegrenzt.
+     */
+    public function pressReleaseQuotaRemaining(): ?int
+    {
+        if ($this->hasUnlimitedPressReleaseQuota()) {
+            return null;
+        }
+
+        $planRemaining = max(
+            0,
+            ($this->currentPlan()?->press_release_quota ?? 0) - (int) $this->press_release_quota_used_this_month,
+        );
+
+        return $planRemaining + $this->singlePurchases()->grantingSubmission()->count();
+    }
+
+    /**
+     * Gesamtes PM-Kontingent (Plan-Monatskontingent plus offene Einmalkäufe)
+     * für die Anzeige „verbleibend / gesamt". Null bedeutet unbegrenzt.
+     */
+    public function pressReleaseQuotaTotal(): ?int
+    {
+        if ($this->hasUnlimitedPressReleaseQuota()) {
+            return null;
+        }
+
+        return ($this->currentPlan()?->press_release_quota ?? 0)
+            + $this->singlePurchases()->grantingSubmission()->count();
     }
 
     /**