mivita/app/Services/Payment/PaymentProviderManager.php

<?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/).'
            ),
        };
    }
}