Stripe-Integration (S0–S3): Einmalzahlungen über Stripe Checkout + Notfall-Go-Live

Wegen PAYONE-Ausfall vorgezogen live geschaltet: alle Einmalzahlungen
(Shop + Salescenter) laufen über Stripe Hosted Checkout, Abos sind bis
Phase S4 eingefroren.

- Provider-Abstraktion: PaymentProvider-Enum, PaymentGatewayInterface,
  PaymentProviderManager (Settings-Schalter, provider-treu je Bestand),
  PayoneGateway als unveränderter Adapter
- StripePaymentService: Checkout Session (eine Gesamtposition, Metadata,
  success/cancel-Redirects), StripeClientWrapper (lazy, Dark Launch),
  StripeCustomerService, StripeTransactionRecorder (client_secret-Redaction)
- Webhook /stripe/webhook: Signaturprüfung, Idempotenz über
  stripe_webhook_events (Crash-Retry-Reprocessing), txaction-Prioritäten,
  Betrags-Guard, lockForUpdate-Paid-Pfad, genau eine Bestätigungsmail
- Zahlungsmethoden-Anzeige aus charge.succeeded (carddata inkl. Wallet,
  auftragsunabhängiges Backfill aus dem Event-Store)
- Checkout: Wartungsmodus mit Admin-Bypass, Abo-Freeze-Hinweis,
  Stripe-Option (Online-Zahlung) statt Zahlartenwahl, Vorkasse ausblendbar
- Abo-Freeze-Guards: Cron user:make_abo_order, Retry, Kartenupdate
- Admin-Settings-Karte Zahlungen (Provider, Wartung, Freeze, Vorkasse)
- Hotfix: 500 bei Vorkasse ohne Clearing-Daten in admin/sales/_detail
  und checkout-final (PAYONE-Ausfall)
- Doku dev/2026-07-08-stripe/ (Plan S0–S8, Konzept, IST-Analyse)

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

app/Services/Payment/PaymentProviderManager.php

@@ -0,0 +1,91 @@
+<?php
+
+namespace App\Services\Payment;
+
+use App\Enums\PaymentProvider;
+use App\Models\Setting;
+use App\Models\ShoppingPayment;
+use App\Models\UserAbo;
+use App\Services\Payment\Contracts\PaymentGatewayInterface;
+
+/**
+ * Zentrale Anbieter-Auflösung (dev/2026-07-08-stripe/, Konzept §4):
+ *
+ * - Neue Zahlungsvorgänge folgen dem Einstellungs-Schalter (Setting-Slug
+ *   `payment-active-provider`).
+ * - Bestehende Zahlungen/Abos folgen IMMER ihrer eigenen
+ *   `payment_provider`-Spalte — der Schalter wirkt nie rückwirkend.
+ * - Unbekannte/fehlende Werte fallen sicher auf PAYONE zurück
+ *   (Bestandsverhalten vor der Stripe-Einführung).
+ */
+class PaymentProviderManager
+{
+    public const SETTING_SLUG = 'payment-active-provider';
+
+    public const SETTING_VORKASSE_HIDDEN = 'payment-vorkasse-hidden';
+
+    public const SETTING_ABO_PAYMENTS_FROZEN = 'abo-payments-frozen';
+
+    public const SETTING_CHECKOUT_MAINTENANCE = 'checkout-maintenance';
+
+    /**
+     * Anbieter für neue Checkouts, neue Abos und neue Zahlungslinks.
+     */
+    public function providerForNewCheckout(): PaymentProvider
+    {
+        $configured = Setting::getContentBySlug(self::SETTING_SLUG);
+
+        return PaymentProvider::tryFrom(is_string($configured) ? $configured : '')
+            ?? PaymentProvider::Payone;
+    }
+
+    /**
+     * Anbieter eines bestehenden Vorgangs — schalterunabhängig.
+     */
+    public function providerFor(UserAbo|ShoppingPayment $subject): PaymentProvider
+    {
+        return PaymentProvider::tryFrom((string) $subject->payment_provider)
+            ?? PaymentProvider::Payone;
+    }
+
+    /**
+     * Sichtbarkeit der Vorkasse im Checkout (N3, 2026-07-08): Vorkasse läuft
+     * über PAYONE und ist über eine eigene Einstellung ausblendbar —
+     * unabhängig vom Provider-Schalter. Fehlende Einstellung = sichtbar.
+     */
+    public function isVorkasseVisible(): bool
+    {
+        return Setting::getContentBySlug(self::SETTING_VORKASSE_HIDDEN) !== true;
+    }
+
+    /**
+     * Not-Schalter (2026-07-08, PAYONE-Ausfall): friert ALLE Abo-Zahlungen ein —
+     * Abo-Checkout, Recovery, Retry und den Abbuchungs-Cron. Einmalzahlungen
+     * (Stripe) laufen weiter. Wird nach Phase S4 (Abos über Stripe) aufgehoben.
+     */
+    public function aboPaymentsFrozen(): bool
+    {
+        return Setting::getContentBySlug(self::SETTING_ABO_PAYMENTS_FROZEN) === true;
+    }
+
+    /**
+     * Checkout-Wartungsmodus: Nicht-Admins sehen im Checkout nur eine
+     * "Technische Schwierigkeiten"-Meldung; Admins können normal bestellen.
+     * Zweck: Stripe im Live-Modus verproben, bevor der Checkout für alle
+     * wieder öffnet (Go-Live 2026-07-08).
+     */
+    public function checkoutMaintenanceActive(): bool
+    {
+        return Setting::getContentBySlug(self::SETTING_CHECKOUT_MAINTENANCE) === true;
+    }
+
+    public function gateway(PaymentProvider $provider): PaymentGatewayInterface
+    {
+        return match ($provider) {
+            PaymentProvider::Payone => app(PayoneGateway::class),
+            PaymentProvider::Stripe => throw new \RuntimeException(
+                'Das Stripe-Gateway ist noch nicht implementiert (Plan Phase S2/S4, dev/2026-07-08-stripe/).'
+            ),
+        };
+    }
+}