📖 12주차 02강: 작업 스케줄링(Task Scheduling)과 자정 배치 자동화

<?php

namespace App\Console\Commands;

use App\Models\Order;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;

class CancelUnpaidOrdersCommand extends Command
{
    protected $signature = 'shop:cancel-unpaid-orders {--hours=24 : 미결제 경과 기준 시간}';
    protected $description = '지정된 시간 동안 결제되지 않은 주문을 자동 취소하고 도서 재고를 복원합니다.';

    public function handle(): int
    {
        $hours = (int) $this->option('hours');
        $cutoffTime = now()->subHours($hours);

        $this->info("{$hours}시간 이상 미결제 상태인 주문 취소 배치를 시작합니다. (기준 시각: {$cutoffTime->toDateTimeString()})");

        // 24시간 지난 pending 주문 조회
        $unpaidOrders = Order::where('status', 'pending')
            ->where('created_at', '<=', $cutoffTime)
            ->with('items.book')
            ->get();

        if ($unpaidOrders->isEmpty()) {
            $this->info('취소 대상 미결제 주문이 없습니다.');
            return self::SUCCESS;
        }

        $cancelledCount = 0;

        foreach ($unpaidOrders as $order) {
            DB::transaction(function () use ($order, &$cancelledCount) {
                // 1. 주문 상세 품목별 재고 복원
                foreach ($order->items as $item) {
                    $item->book->increment('stock', $item->quantity);
                    if ($item->book->is_sold_out && $item->book->stock > 0) {
                        $item->book->update(['is_sold_out' => false]);
                    }
                }

                // 2. 주문 상태를 'cancelled'로 변경
                $order->update([
                    'status' => 'cancelled',
                    'cancelled_at' => now(),
                    'cancel_reason' => '입금 기한(24시간) 만료에 따른 시스템 자동 취소',
                ]);

                $cancelledCount++;
            });

            Log::info("[스케줄러] 미결제 주문 자동 취소 완료: 주문번호 #{$order->order_number}");
        }

        $this->info("총 {$cancelledCount}건의 미결제 주문이 성공적으로 취소되고 재고가 복구되었습니다.");
        return self::SUCCESS;
    }
}

<?php

use Illuminate\Support\Facades\Schedule;
use App\Console\Commands\CancelUnpaidOrdersCommand;
use App\Models\Book;
use Illuminate\Support\Facades\Log;

/*
|--------------------------------------------------------------------------
| Console Task Scheduling
|--------------------------------------------------------------------------
*/

// 1. 매일 자정(00:00) 24시간 미결제 주문 자동 취소
Schedule::command(CancelUnpaidOrdersCommand::class, ['--hours' => 24])
    ->dailyAt('00:00')
    ->withoutOverlapping(60) // 최대 60분 락
    ->runInBackground()      // 다음 작업 지연 방지
    ->appendOutputTo(storage_path('logs/scheduler-orders.log'))
    ->onSuccess(function () {
        Log::info('[스케줄러] 자정 미결제 주문 취소 배치가 성공적으로 완료되었습니다.');
    })
    ->onFailure(function () {
        Log::critical('[스케줄러 긴급] 자정 미결제 주문 취소 배치가 실패했습니다!');
    });

// 2. 매일 아침 09:00 품절 임박(재고 3권 이하) 도서 점검 인라인 클로저
Schedule::call(function () {
    $lowStockBooks = Book::where('stock', '<=', 3)->where('is_sold_out', false)->get();
    if ($lowStockBooks->isNotEmpty()) {
        Log::warning("[재고 경보] 품절 임박 도서가 {$lowStockBooks->count()}종 있습니다. 발주 검토가 필요합니다.");
    }
})->dailyAt('09:00')->name('check-low-stock-books');

// 3. 매주 월요일 새벽 02:00 주간 베스트셀러 집계 캐시 갱신
Schedule::command('shop:generate-bestsellers')
    ->weeklyOn(1, '02:00')
    ->onOneServer(); // 서버가 여러 대여도 한 대에서만 단독 실행