presseportale/app/Http/Controllers/CheckoutController.php

<?php

namespace App\Http\Controllers;

use App\Enums\PressReleaseStatus;
use App\Enums\SinglePurchaseStatus;
use App\Enums\SinglePurchaseType;
use App\Models\BookingConfirmation;
use App\Models\Plan;
use App\Models\PressRelease;
use App\Models\SinglePurchase;
use App\Services\Billing\CreditTopupService;
use App\Services\Billing\StripeCheckoutService;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
use Laravel\Cashier\Checkout;
use Laravel\Cashier\Exceptions\IncompletePayment;

/**
 * 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->hasCompleteBillingAddress()) {
            return $this->backToProfile();
        }

        if ($redirect = $this->requireEntrepreneurConfirmation($request)) {
            return $redirect;
        }

        if ($user->subscribed()) {
            return $this->backToBookings(__('Es besteht bereits ein aktives Abo. Nutzen Sie den Tarifwechsel direkt an der gewünschten Tarif-Karte.'));
        }

        $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);
    }

    /**
     * Tarifwechsel eines aktiven Abos (POST aus dem Buchungs-Modal) — kein
     * neuer Stripe-Checkout: Stripe stellt das bestehende Abo sofort um und
     * verrechnet anteilig (swapAndInvoice). Eine vorgemerkte Kündigung wird
     * durch den Wechsel aufgehoben.
     */
    public function swap(Request $request, string $planSlug, string $interval): RedirectResponse
    {
        $plan = Plan::query()->active()->where('slug', $planSlug)->firstOrFail();
        $user = $request->user();

        if (! $user->hasCompleteBillingAddress()) {
            return $this->backToProfile();
        }

        if ($redirect = $this->requireEntrepreneurConfirmation($request)) {
            return $redirect;
        }

        $subscription = $user->subscription();

        if (! $subscription || ! $subscription->valid()) {
            return $this->backToBookings(__('Es besteht kein aktives Abo — bitte buchen Sie den gewünschten Tarif direkt.'));
        }

        $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.'));
        }

        if ($subscription->stripe_price === $priceId) {
            return $this->backToBookings(__('Dieser Tarif ist bereits Ihr aktueller Tarif.'));
        }

        // Downgrade-Vorkehrung (QA-Befund 07.07.): Der Kontingent-Zähler
        // läuft pro Kalendermonat — wer mehr PMs genutzt hat, als der
        // Ziel-Tarif monatlich enthält, bekäme beim sofortigen Wechsel die
        // anteilige Gutschrift für einen bereits konsumierten Monat. Solche
        // Wechsel sind erst ab dem nächsten Monatsersten möglich.
        $quotaUsed = (int) $user->press_release_quota_used_this_month;

        if ($quotaUsed > (int) $plan->press_release_quota) {
            return $this->backToBookings(__('Ein Wechsel zu :plan ist erst ab dem :date möglich: Sie haben in diesem Monat bereits :used Pressemitteilungen genutzt — dieser Tarif enthält :quota pro Monat.', [
                'plan' => $plan->name,
                'date' => now()->addMonth()->startOfMonth()->format('d.m.Y'),
                'used' => $quotaUsed,
                'quota' => (int) $plan->press_release_quota,
            ]));
        }

        try {
            $this->checkout->swapSubscription($user, $plan, $interval);
        } catch (IncompletePayment $exception) {
            return redirect()->route('cashier.payment', [
                $exception->payment->id,
                'redirect' => route('me.bookings.index', ['checkout' => 'wechsel']),
            ]);
        } catch (\Throwable $exception) {
            Log::error('Tarifwechsel fehlgeschlagen.', [
                'user_id' => $user->id,
                'plan' => $plan->slug,
                'interval' => $interval,
                'error' => $exception->getMessage(),
            ]);

            return $this->backToBookings(__('Der Tarifwechsel konnte nicht durchgeführt werden. Bitte versuchen Sie es erneut oder wenden Sie sich an :email.', ['email' => (string) config('legal.contact_email')]));
        }

        return redirect()->route('me.bookings.index', ['checkout' => 'wechsel']);
    }

    public function singlePm(Request $request): Checkout|RedirectResponse
    {
        if (! $request->user()->hasCompleteBillingAddress()) {
            return $this->backToProfile();
        }

        if ($redirect = $this->requireEntrepreneurConfirmation($request)) {
            return $redirect;
        }

        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' => config('billing.default_currency'),
        ]);

        return $this->checkout->forSinglePurchase($request->user(), $purchase);
    }

    /**
     * Wallet-Aufladung über ein Credit-Paket. Wie jeder Checkout setzt das
     * eine vollständige Rechnungsadresse voraus; die Erfüllung (Gutschrift)
     * übernimmt der Webhook über die `credit_topup_id`-Metadaten.
     */
    public function creditTopup(Request $request, string $pack, CreditTopupService $topups): Checkout|RedirectResponse
    {
        if (! $request->user()->hasCompleteBillingAddress()) {
            return $this->backToProfile();
        }

        if ($redirect = $this->requireEntrepreneurConfirmation($request)) {
            return $redirect;
        }

        if (! $topups->findPack($pack)) {
            return $this->backToBookings(__('Dieses Credit-Paket ist nicht verfügbar.'));
        }

        $topup = $topups->startTopup($request->user(), $pack);

        return $this->checkout->forCreditTopup($request->user(), $topup);
    }

    /**
     * Depublikation einer eigenen, veröffentlichten PM (T12, Meldeverfahren
     * Weg 3). Config-gated: ohne konfigurierten Preis ist der Weg
     * deaktiviert. Die Entfernung selbst übernimmt der Webhook nach
     * Zahlungseingang (Tombstone bleibt öffentlich sichtbar).
     */
    public function depublication(Request $request, int $pressReleaseId): Checkout|RedirectResponse
    {
        $user = $request->user();
        $priceCents = (int) config('billing.depublication_price_cents');

        if ($priceCents <= 0) {
            return $this->backToBookings(__('Die Depublikation ist derzeit nicht online buchbar. Bitte wenden Sie sich an :email.', ['email' => (string) config('legal.contact_email')]));
        }

        $pressRelease = PressRelease::query()
            ->accessibleBy($user)
            ->whereKey($pressReleaseId)
            ->firstOrFail();

        if ($pressRelease->status !== PressReleaseStatus::Published) {
            return $this->backToBookings(__('Nur veröffentlichte Pressemitteilungen können depubliziert werden.'));
        }

        if (! $user->hasCompleteBillingAddress()) {
            return $this->backToProfile();
        }

        if ($redirect = $this->requireEntrepreneurConfirmation($request)) {
            return $redirect;
        }

        // Doppelbuchungs-Bremse: eine offene oder bereits bezahlte
        // Depublikation zu dieser PM reicht.
        $alreadyRequested = SinglePurchase::query()
            ->where('press_release_id', $pressRelease->id)
            ->where('type', SinglePurchaseType::Depublication->value)
            ->whereIn('status', [SinglePurchaseStatus::Pending->value, SinglePurchaseStatus::Paid->value])
            ->exists();

        if ($alreadyRequested) {
            return $this->backToBookings(__('Für diese Pressemitteilung liegt bereits ein Depublikations-Vorgang vor.'));
        }

        $purchase = SinglePurchase::query()->create([
            'user_id' => $user->id,
            'type' => SinglePurchaseType::Depublication->value,
            'status' => SinglePurchaseStatus::Pending->value,
            'price_cents' => $priceCents,
            'currency' => config('billing.default_currency'),
            'press_release_id' => $pressRelease->id,
        ]);

        return $this->checkout->forDepublication($user, $purchase);
    }

    /**
     * Stripe Billing Portal: Selbstverwaltung des Abos (Zahlungsmethode,
     * Rechnungen, Kündigung). Nur mit aktivem Abo sinnvoll.
     */
    public function billingPortal(Request $request): RedirectResponse
    {
        $user = $request->user();

        if (! $user->hasStripeId() || ! $user->subscribed()) {
            return $this->backToBookings(__('Es besteht kein aktives Abo, das verwaltet werden könnte.'));
        }

        return redirect()->away($this->checkout->billingPortalUrl($user));
    }

    private function backToBookings(string $notice): RedirectResponse
    {
        return redirect()
            ->route('me.bookings.index')
            ->with('checkout-notice', $notice);
    }

    /**
     * B2B-Gate (T1neu, AGB v0.6 § 1 Abs. 4): Jeder Stripe-Checkout setzt eine
     * zeitnah protokollierte Unternehmer-Bestätigung voraus (Pflicht-Checkbox
     * im Buchungs-Modal). Direktaufrufe der Checkout-Routen ohne Bestätigung
     * werden auf die Buchungsseite zurückgeleitet.
     */
    private function requireEntrepreneurConfirmation(Request $request): ?RedirectResponse
    {
        if (BookingConfirmation::query()->recentFor($request->user())->exists()) {
            return null;
        }

        return $this->backToBookings(
            __('Bitte bestätigen Sie im Buchungsdialog, dass Sie als Unternehmer bestellen — das Angebot richtet sich ausschließlich an Unternehmen, Selbstständige und Agenturen.')
        );
    }

    /**
     * Buchungs-Voraussetzung (12.06.2026): ohne vollständige
     * Rechnungsadresse kein Checkout — der Hinweis erscheint direkt auf
     * der Profil-Seite über dem Rechnungsadress-Formular.
     */
    private function backToProfile(): RedirectResponse
    {
        return redirect()
            ->route('me.profile')
            ->with('checkout-notice', __('Bitte hinterlegen Sie zuerst eine vollständige Rechnungsadresse — sie ist Voraussetzung für jede Buchung und wird an Stripe übergeben.'));
    }
}