// قواعد التحقق — 30 ثانية للكتابة، تحمي للأبد
$validated = $request->validate([
    'name' => 'required|string|max:255',
    'email' => 'required|email|unique:users',
    'price' => 'required|numeric|min:0',
]);

// تحقق مباشر في المتحكم
public function store(Request $request): RedirectResponse
{
    $validated = $request->validate([
        'name' => 'required|string|max:255',
        'sku' => 'required|string|unique:products,sku',
        'price' => 'required|numeric|min:0.01|max:999999.99',
        'stock' => 'required|integer|min:0',
        'category_id' => 'required|exists:categories,id',
        'description' => 'nullable|string|max:5000',
        'is_active' => 'boolean',
    ]);

    $product = Product::create($validated);

    return redirect()->route('products.show', $product)
        ->with('success', 'تم إنشاء المنتج.');
}

// تم التنفيذ بنجاح

php artisan make:request StoreShopRequest
php artisan make:request UpdateShopRequest

// app/Http/Requests/StoreShopRequest.php
class StoreShopRequest extends FormRequest
{
    public function authorize(): bool
    {
        return auth()->check() && auth()->user()->can('create', Shop::class);
    }

    public function rules(): array
    {
        return [
            'name' => 'required|string|max:255',
            'slug' => 'required|string|unique:shops,slug',
            'description' => 'nullable|string|max:5000',
            'domain' => 'nullable|url',
            'status' => 'in:active,suspended',
        ];
    }

    public function messages(): array
    {
        return [
            'name.required' => 'اسم المتجر مطلوب.',
            'slug.unique' => 'رابط URL هذا مستخدم بالفعل.',
            'domain.url' => 'يرجى إدخال عنوان URL صالح.',
        ];
    }
}

public function store(StoreShopRequest $request): RedirectResponse
{
    // $request->validated() يحتوي فقط على البيانات المُتحقق منها
    $shop = Shop::create($request->validated());
    return redirect()->route('shops.show', $shop);
}

// app/Http/Requests/StoreShopRequest.php
class StoreShopRequest extends FormRequest
{
    public function authorize(): bool
    {
        return auth()->user()->role === 'tenant_owner';
    }

    public function rules(): array
    {
        return [
            'name' => 'required|string|max:255',
            'slug' => 'required|alpha_dash|unique:shops,slug,NULL,id,tenant_id,' . tenant()->id,
            'description' => 'nullable|string|max:5000',
            'status' => 'sometimes|in:active,suspended',
        ];
    }

    public function messages(): array
    {
        return [
            'slug.unique' => 'لديك بالفعل متجر بهذا الرابط.',
            'slug.alpha_dash' => 'الرابط يمكن أن يحتوي فقط على أحرف وأرقام وشرطات.',
        ];
    }

    protected function prepareForValidation(): void
    {
        $this->merge([
            'tenant_id' => tenant()->id,
            'slug' => Str::slug($this->slug ?? $this->name),
        ]);
    }
}

// تم التنفيذ بنجاح

// قاعدة مخصصة مباشرة
$validated = $request->validate([
    'discount' => [
        'required',
        'numeric',
        'min:0',
        function (string $attribute, mixed $value, Closure $fail) {
            if ($value > request('subtotal')) {
                $fail('لا يمكن أن يتجاوز الخصم المبلغ الجزئي.');
            }
        },
    ],
]);

php artisan make:rule ValidCouponCode

// app/Rules/ValidCouponCode.php
class ValidCouponCode implements ValidationRule
{
    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        $coupon = Coupon::where('code', $value)
            ->where('expires_at', '>', now())
            ->where('usage_limit', '>', DB::raw('usage_count'))
            ->first();

        if (!$coupon) {
            $fail('رمز الكوبون هذا غير صالح أو منتهي الصلاحية.');
        }
    }
}

// الاستخدام
public function rules(): array
{
    return [
        'coupon_code' => ['nullable', 'string', new ValidCouponCode()],
    ];
}

use Illuminate\Validation\Rule;

// فريد مع تجاهل النموذج الحالي
'slug' => Rule::unique('shops', 'slug')->ignore($shop->id),

// in مع قيم ديناميكية
'status' => Rule::in(['active', 'suspended', 'closed']),

// exists مع استعلام إضافي
'shop_id' => Rule::exists('shops', 'id')->where(function ($query) {
    $query->where('tenant_id', tenant()->id);
}),

// app/Http/Requests/StoreOrderRequest.php
class StoreOrderRequest extends FormRequest
{
    public function rules(): array
    {
        return [
            'items' => 'required|array|min:1',
            'items.*.product_id' => [
                'required',
                'integer',
                Rule::exists('products', 'id')->where('is_active', true),
            ],
            'items.*.quantity' => 'required|integer|min:1|max:100',
            'coupon_code' => ['nullable', 'string', new ValidCouponCode()],
            'discount' => [
                'sometimes',
                'numeric',
                'min:0',
                function ($attribute, $value, $fail) {
                    if ($value > $this->input('subtotal', 0)) {
                        $fail('لا يمكن أن يتجاوز الخصم المبلغ الجزئي.');
                    }
                },
            ],
        ];
    }
}

// تم التنفيذ بنجاح

<!-- عرض جميع الأخطاء -->
@if ($errors->any())
    <div class="alert alert-error">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

<!-- عرض خطأ لحقل محدد -->
<input type="text" name="name" value="{{ old('name') }}"
       class="{{ $errors->has('name') ? 'border-red-500' : '' }}">
@error('name')
    <p class="text-red-500 text-sm">{{ $message }}</p>
@enderror

{
    "message": "البيانات المقدمة غير صالحة.",
    "errors": {
        "name": ["حقل الاسم مطلوب."],
        "email": ["يجب أن يكون البريد الإلكتروني عنوان بريد إلكتروني صالح."]
    }
}

// app/Http/Controllers/Api/ShopController.php
public function store(StoreShopRequest $request): JsonResponse
{
    $shop = Shop::create($request->validated());

    return response()->json([
        'message' => 'تم إنشاء المتجر بنجاح.',
        'data' => new ShopResource($shop),
    ], 201);
}

// العميل يستلم 422 عند فشل التحقق:
// {
//   "message": "الرابط مستخدم بالفعل.",
//   "errors": {
//     "slug": ["الرابط مستخدم بالفعل."]
//   }
// }

// تم التنفيذ بنجاح

// التحقق فقط إذا كان الحقل موجودًا
$validated = $request->validate([
    'name' => 'required|string',
    'notes' => 'sometimes|nullable|string|max:5000',
]);

// قواعد شرطية بناءً على حقل آخر
Validator::make($data, [
    'payment_method' => 'required|in:credit_card,bank_transfer',
    'card_number' => 'required_if:payment_method,credit_card|numeric',
    'bank_account' => 'required_if:payment_method,bank_transfer|numeric',
]);

// إيقاف التحقق بعد أول فشل في حقل
$validated = $request->validate([
    'email' => 'bail|required|email|unique:users',
    // إذا فشل required، لن يعمل email وunique
]);

// app/Http/Requests/UpdateSubscriptionRequest.php
class UpdateSubscriptionRequest extends FormRequest
{
    public function rules(): array
    {
        return [
            'plan_id' => 'required|exists:plans,id',
            'payment_method' => 'required|in:credit_card,paypal,bank_transfer',
            'card_number' => 'required_if:payment_method,credit_card|string|size:16',
            'card_cvv' => 'required_if:payment_method,credit_card|string|size:3',
            'paypal_email' => 'required_if:payment_method,paypal|email',
            'bank_account' => 'required_if:payment_method,bank_transfer|string',
            'coupon_code' => 'sometimes|nullable|string|max:50',
        ];
    }
}

// تم التنفيذ بنجاح

// ============================================
// شامل: التحقق من طلبات ShopMetrics
// يغطي: Form Request، قواعد مخصصة، شرطي، أخطاء
// ============================================

// app/Rules/SufficientStock.php
class SufficientStock implements ValidationRule
{
    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        $productId = request()->input(str_replace('.quantity', '.product_id', $attribute));
        $product = Product::find($productId);
        if ($product && $value > $product->stock) {
            $fail("متاح فقط {$product->stock} وحدة من {$product->name}.");
        }
    }
}

// app/Http/Requests/StoreOrderRequest.php
class StoreOrderRequest extends FormRequest
{
    public function authorize(): bool
    {
        return auth()->check();
    }

    public function rules(): array
    {
        return [
            'items' => 'required|array|min:1|max:50',
            'items.*.product_id' => [
                'required',
                'integer',
                Rule::exists('products', 'id')->where('is_active', true),
            ],
            'items.*.quantity' => [
                'required',
                'integer',
                'min:1',
                'max:100',
                new SufficientStock(),
            ],
            'coupon_code' => 'sometimes|nullable|string|max:50',
            'notes' => 'sometimes|nullable|string|max:1000',
            'shipping_address.line1' => 'required|string|max:255',
            'shipping_address.city' => 'required|string|max:100',
            'shipping_address.zip' => 'required|string|max:20',
            'shipping_address.country' => 'required|string|size:2',
        ];
    }

    public function messages(): array
    {
        return [
            'items.required' => 'سلة التسوق فارغة.',
            'items.min' => 'أضف عنصرًا واحدًا على الأقل لتقديم الطلب.',
            'items.*.product_id.exists' => 'أحد المنتجات المحددة غير متاح.',
            'shipping_address.line1.required' => 'عنوان الشارع مطلوب.',
        ];
    }
}

// المتحكم يبقى نظيفًا
public function store(StoreOrderRequest $request): RedirectResponse
{
    $order = $this->orderService->createFromRequest($request);
    return redirect()->route('orders.show', $order)
        ->with('success', 'تم تقديم الطلب بنجاح!');
}