sam-api/app/Http/Requests/Quote/QuoteIndexRequest.php

<?php

namespace App\Http\Requests\Quote;

use App\Http\Requests\Traits\HasPagination;
use App\Models\Quote\Quote;
use Illuminate\Foundation\Http\FormRequest;

class QuoteIndexRequest extends FormRequest
{
    use HasPagination;

    public function authorize(): bool
    {
        return true;
    }

    /**
     * 검증 전 데이터 전처리
     * - 쿼리 스트링의 "true"/"false" 문자열을 boolean으로 변환
     * - size/per_page 최대값 제한
     */
    protected function prepareForValidation(): void
    {
        // HasPagination Trait의 페이지네이션 처리
        $maxSize = $this->maxSize ?? config('pagination.max_size', 100);
        if ($this->has('size') && $this->input('size') > $maxSize) {
            $this->merge(['size' => $maxSize]);
        }

        if ($this->has('with_items')) {
            $this->merge([
                'with_items' => filter_var($this->with_items, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE),
            ]);
        }

        if ($this->has('for_order')) {
            $this->merge([
                'for_order' => filter_var($this->for_order, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE),
            ]);
        }
    }

    public function rules(): array
    {
        return [
            'page' => 'nullable|integer|min:1',
            'size' => 'nullable|integer|min:1',
            'q' => 'nullable|string|max:100',
            'quote_type' => 'nullable|in:'.implode(',', Quote::TYPES),
            'status' => 'nullable|in:'.implode(',', [
                Quote::STATUS_PENDING,
                Quote::STATUS_DRAFT,
                Quote::STATUS_SENT,
                Quote::STATUS_APPROVED,
                Quote::STATUS_REJECTED,
                Quote::STATUS_FINALIZED,
                Quote::STATUS_CONVERTED,
            ]),
            'product_category' => 'nullable|in:'.Quote::CATEGORY_SCREEN.','.Quote::CATEGORY_STEEL,
            'client_id' => 'nullable|integer',
            'date_from' => 'nullable|date',
            'date_to' => 'nullable|date|after_or_equal:date_from',
            'sort_by' => 'nullable|in:registration_date,quote_number,client_name,total_amount,status,created_at',
            'sort_order' => 'nullable|in:asc,desc',
            'with_items' => 'nullable|boolean',  // 수주 전환용 품목 포함 여부
            'for_order' => 'nullable|boolean',   // 수주 전환용: 이미 수주가 생성된 견적 제외
        ];
    }
}