01강: Form Request 캡슐화 & 재고 한도 커스텀 검증 룰(CheckBookStock)

namespace App\Rules;

use App\Models\Book;
use Closure;
use Illuminate\Contracts\Validation\ValidationRule;

class CheckBookStock implements ValidationRule
{
    protected ?int $bookId;

    public function __construct(?int $bookId)
    {
        $this->bookId = $bookId;
    }

    /**
     * 유효성 검사 실행
     */
    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        $book = Book::find($this->bookId);

        if (! $book) {
            $fail('선택하신 도서가 존재하지 않습니다.');
            return;
        }

        // 전자책은 재고 제한 없음
        if ($book->format === 'ebook') {
            return;
        }

        // 품절 체크
        if ($book->stock_quantity <= 0) {
            $fail("[{$book->title}] 도서는 현재 전량 품절되었습니다.");
            return;
        }

        // 요청 수량이 남은 재고 초과 시 에러 메시지 반환
        if ($value > $book->stock_quantity) {
            $fail("[{$book->title}] 도서의 남은 재고는 {$book->stock_quantity}권입니다. (요청: {$value}권)");
        }
    }
}

namespace App\Http\Requests;

use App\Rules\CheckBookStock;
use Illuminate\Foundation\Http\FormRequest;

class StoreCartItemRequest extends FormRequest
{
    public function authorize(): bool
    {
        return true; // 모든 고객 허용
    }

    public function rules(): array
    {
        return [
            'book_id' => ['required', 'integer', 'exists:books,id'],
            'quantity' => [
                'required',
                'integer',
                'min:1',
                'max:10', // 1인당 1회 최대 10권 제한
                new CheckBookStock($this->input('book_id')), // 커스텀 룰 주입!
            ],
        ];
    }

    public function messages(): array
    {
        return [
            'book_id.required' => '도서 식별자가 누락되었습니다.',
            'book_id.exists' => '서점에 등록되지 않은 도서입니다.',
            'quantity.required' => '주문 수량을 입력해 주세요.',
            'quantity.min' => '도서는 최소 1권 이상 담아야 합니다.',
            'quantity.max' => '1회 주문 시 최대 10권까지만 담을 수 있습니다.',
        ];
    }
}

public function store(StoreCartItemRequest $request, CartService $cart)
{
    // 이 줄에 도달했다는 것은 모든 유효성 검사가 100% 통과했음을 보장함!
    $validated = $request->validated();
    $cart->add($validated['book_id'], $validated['quantity']);

    return back()->with('success', '장바구니에 책이 담겼습니다!');
}