SubscriptionController.php

<?php

namespace App\Http\Controllers\User;

use App\Http\Controllers\Controller;
use App\Models\ClientSubscription;
use App\Models\Invoice;
use App\Models\Payment;
use App\Models\Service;
use App\Models\SubscriptionPlan;
use App\Services\EmailTemplateService;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;

/**
 * Handles subscription plan listing, Stripe Checkout initiation,
 * and post-payment activation for recurring subscription plans.
 *
 * Stripe Checkout flow:
 *   checkout() → Stripe-hosted page → success() → activate
 *
 * Dual-path activation: success redirect (primary) + webhook (fallback),
 * both idempotent via transaction_ref guard on the Payment table.
 */
class SubscriptionController extends Controller
{
    public function pricing()
    {
        // Load all active SubscriptionPlans grouped by ServiceCategory
        // ...
    }

    public function checkout(Request $request)
    {
        $request->validate([
            'plan_id' => 'required|exists:subscription_plans,id',
        ]);

        $user = auth('user')->user();
        $plan = SubscriptionPlan::with('service')->findOrFail($request->plan_id);

        // Build Stripe Checkout Session with plan price, metadata, and redirect URLs
        // Platinum / contact-only plans are rejected before reaching Stripe
        // ...
    }

    public function success(Request $request)
    {
        $sessionId = $request->query('session_id');

        // Retrieve session from Stripe API to confirm payment status
        // Idempotency: skip if Payment already recorded for this session_id
        // Activate linked Project + ClientSubscription → record Payment + Invoice
        // Send 'subscription-activated' email via EmailTemplateService
        // ...
    }

    public function cancel()
    {
        // Handle Stripe Checkout cancellation (user clicked "back")
        // ...
    }
}