📖 11주차 01강: 이벤트(Events)와 리스너(Listeners)를 활용한 주문 완료 도메인 분리

<?php

namespace App\Events;

use App\Models\Order;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

class OrderPlaced
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    /**
     * 새로운 이벤트 인스턴스 생성
     */
    public function __construct(
        public Order $order
    ) {
        // public 프로퍼티로 선언하여 리스너에서 $event->order로 바로 접근 가능합니다.
    }
}

<?php

namespace App\Listeners;

use App\Events\OrderPlaced;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;

class DeductBookStock
{
    /**
     * 이벤트 처리 (도서 재고 차감)
     */
    public function handle(OrderPlaced $event): void
    {
        $order = $event->order;

        Log::info("[이벤트] 주문 #{$order->order_number} 도서 재고 차감 시작");

        // 트랜잭션 내에서 비관적 잠금(Lock for update)과 함께 재고 차감
        DB::transaction(function () use ($order) {
            foreach ($order->items as $item) {
                $book = $item->book;

                if ($book->stock < $item->quantity) {
                    Log::warning("[재고부족 경고] 도서 '{$book->title}'(ID: {$book->id})의 재고({$book->stock}권)가 주문량({$item->quantity}권)보다 적습니다.");
                }

                // 음수 재고 방지를 고려한 재고 차감
                $book->decrement('stock', $item->quantity);

                // 품절 도서 처리 (재고가 0이 되면 상태 플래그 갱신)
                if ($book->fresh()->stock <= 0) {
                    $book->update(['is_sold_out' => true]);
                    Log::alert("[품절 알림] 도서 '{$book->title}'이 완판되어 품절 처리되었습니다!");
                }
            }
        });
    }
}

<?php

namespace App\Listeners;

use App\Events\OrderPlaced;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Session;

class ClearUserCart
{
    public function handle(OrderPlaced $event): void
    {
        $order = $event->order;

        // 세션 기반 장바구니 초기화
        Session::forget('cart');

        // 회원 장바구니 DB 테이블이 있을 경우 함께 초기화
        if ($order->user_id) {
            $order->user->cartItems()->delete();
        }

        Log::info("[이벤트] 주문 #{$order->order_number}에 대한 장바구니를 성공적으로 비웠습니다.");
    }
}

<?php

namespace App\Listeners;

use App\Events\OrderPlaced;
use Illuminate\Support\Facades\Log;

class LogOrderAudit
{
    public function handle(OrderPlaced $event): void
    {
        $order = $event->order;

        Log::channel('daily')->info('ORDER_PLACED_AUDIT', [
            'order_id' => $order->id,
            'order_number' => $order->order_number,
            'user_id' => $order->user_id,
            'total_amount' => $order->total_amount,
            'placed_at' => now()->toIso8601String(),
            'ip' => request()->ip(),
        ]);
    }
}

<?php

namespace App\Http\Controllers;

use App\Events\OrderPlaced;
use App\Models\Order;
use App\Models\OrderItem;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;

class CheckoutController extends Controller
{
    public function processOrder(Request $request)
    {
        // 1. 주문 데이터 DB 저장
        $order = DB::transaction(function () use ($request) {
            $order = Order::create([
                'user_id' => auth()->id(),
                'order_number' => 'ORD-' . strtoupper(Str::random(10)),
                'status' => 'paid',
                'total_amount' => 45000,
                'shipping_address' => '서울시 강남구 테헤란로 123',
            ]);

            // 주문 상세 항목 생성 (예: 도서 ID 1번 2권)
            OrderItem::create([
                'order_id' => $order->id,
                'book_id' => 1,
                'quantity' => 2,
                'unit_price' => 22500,
            ]);

            return $order;
        });

        // 2. 주문 완료 이벤트 발행! (단 한 줄로 후속 도메인 작업 트리거)
        OrderPlaced::dispatch($order);

        // 3. 0.1초 만에 깔끔하게 응답 반환
        return redirect()->route('orders.show', $order)
            ->with('status', '도서 주문이 성공적으로 완료되었습니다!');
    }
}

// 1. Dispatchable 트레이트가 제공하는 정적 메소드 (가장 권장)
OrderPlaced::dispatch($order);

// 2. 조건부 디스패치 (특정 조건이 참일 때만 발동)
OrderPlaced::dispatchIf($order->total_amount > 100000, $order);
OrderPlaced::dispatchUnless($order->is_guest, $order);

// 3. Event 파사드 직접 호출
use Illuminate\Support\Facades\Event;
Event::dispatch(new OrderPlaced($order));

public function handle(OrderPlaced $event): bool
{
    if ($event->order->isFraudulent()) {
        Log::emergency("사기 주문 감지로 후속 이벤트 실행을 전면 중단합니다!");
        return false; // 다음 순번의 리스너 실행이 즉각 취소됩니다!
    }

    return true;
}