01강: IoC 서비스 컨테이너 & 결제 게이트웨이 인터페이스(Contract) 추상화

namespace App\Contracts;

/**
 * 결제 결과 데이터 전송 객체
 */
class PaymentResult
{
    public function __construct(
        public bool $success,
        public string $transactionId,
        public int $amount,
        public ?string $errorMessage = null,
    ) {}
}

/**
 * 모든 결제 모듈이 반드시 지켜야 할 계약(Contract)
 */
interface PaymentGatewayContract
{
    /**
     * 결제 승인 요청
     */
    public function charge(int $amount, array $orderData): PaymentResult;

    /**
     * 결제 취소 및 환불
     */
    public function refund(string $transactionId, int $amount): bool;
}

// app/Services/Payment/MockPaymentGateway.php
namespace App\Services\Payment;

use App\Contracts\PaymentGatewayContract;
use App\Contracts\PaymentResult;
use Illuminate\Support\Str;

class MockPaymentGateway implements PaymentGatewayContract
{
    public function charge(int $amount, array $orderData): PaymentResult
    {
        // 100% 성공 시뮬레이션
        return new PaymentResult(
            success: true,
            transactionId: 'MOCK-TX-' . Str::upper(Str::random(12)),
            amount: $amount
        );
    }

    public function refund(string $transactionId, int $amount): bool
    {
        return true;
    }
}

// app/Services/Payment/TossPaymentGateway.php
namespace App\Services\Payment;

use App\Contracts\PaymentGatewayContract;
use App\Contracts\PaymentResult;

class TossPaymentGateway implements PaymentGatewayContract
{
    public function __construct(
        protected string $apiKey,
        protected string $secretKey,
    ) {}

    public function charge(int $amount, array $orderData): PaymentResult
    {
        // (4강에서 라라벨 HTTP 클라이언트로 실제 PG사 API 통신을 구현합니다)
        return new PaymentResult(
            success: true,
            transactionId: 'TOSS-TX-' . time(),
            amount: $amount
        );
    }

    public function refund(string $transactionId, int $amount): bool
    {
        return true;
    }
}

// app/Http/Controllers/CheckoutController.php
namespace App\Http\Controllers;

use App\Contracts\PaymentGatewayContract;
use App\Services\CartService;
use Illuminate\Http\Request;

class CheckoutController extends Controller
{
    /**
     * 라라벨 서비스 컨테이너가 PaymentGatewayContract 구현체를 자동으로 주입!
     */
    public function process(
        Request $request,
        CartService $cart,
        PaymentGatewayContract $paymentGateway // 🚀 자동 의존성 주입!
    ) {
        $totalPrice = $cart->totalPrice();

        // 결제 집행!
        $result = $paymentGateway->charge($totalPrice, [
            'order_name' => '지니샵 도서 ' . $cart->totalCount() . '권 주문',
            'customer_email' => auth()->user()?->email,
        ]);

        if (! $result->success) {
            return back()->with('error', '결제 실패: ' . $result->errorMessage);
        }

        return redirect()->route('orders.success', ['tx' => $result->transactionId])
            ->with('success', '도서 주문 및 결제가 안전하게 완료되었습니다!');
    }
}