Function updateCharterReservation

·  هدف:

این متد برای ویرایش اطلاعات رزرو یک یا چند مسافر به صورت همزمان استفاده می‌شود. کاربر می‌تواند اطلاعات هویتی (مانند نام، کد ملی)، اطلاعات تماس (ایمیل، موبایل) و یا حتی وضعیت رزرو (مثلاً تغییر از حالت موقت به قطعی) را برای لیستی از رزروها تغییر دهد. متد قبل از اعمال تغییرات، اعتبارسنجی‌های لازم را روی داده‌های جدید انجام می‌دهد تا از صحت آن‌ها اطمینان حاصل کند. این عملیات به صورت اتمیک برای هر رزرو انجام می‌شود تا از بروز خطا و ناقص ماندن اطلاعات جلوگیری شود.

ویژگی‌ها	توضیحات
هدف کلی	ویرایش اطلاعات یک یا چند رزرو موجود در یک چارتر.
پردازش دسته‌ای	قابلیت آپدیت کردن چندین رزرو (reservation_id) با یک درخواست واحد.
اعتبارسنجی ورودی	ولیدیشن داده‌های جدید قبل از ذخیره‌سازی (مانند فرمت صحیح ایمیل و موبایل).
به‌روزرسانی انتخابی	فقط فیلدهایی که در درخواست ارسال شوند، به‌روزرسانی می‌شوند.
عملیات اتمی	هر رزرو به صورت مستقل و کامل آپدیت می‌شود.

---

·     ورودی‌ها (پارامتر‌ها):

 

توضیحات	موقعیت	نوع داده	نام پارمتر
آرایه‌ای از آبجکت‌های رزرو که هر کدام شامل شناسه رزرو و فیلدهای مورد نظر برای ویرایش است.	Body	array	$request->reservations
(اجباری) شناسه رزرو (reservation_id) که قرار است ویرایش شود.	Body	integer	$reservation['id']
(اختیاری) آبجکتی شامل اطلاعات جدید مسافر (مانند fullname, identity, birth, mobile, email).	Body	object	$reservation['passenger']
(اختیاری) کد وضعیت جدید رزرو (مثلاً 1 برای قطعی، 2 برای کنسل).	Body	integer	$reservation['status']

---

·     خروجی (Return):

 

توضیحات	نوع داده
در صورت موفقیت کامل، یک پاسخ خالی با کد وضعیت 204 No Content برمی‌گرداند.	Illuminate\Http\JsonResponse
در صورت بروز خطا در حین پردازش (مثلاً پیدا نشدن یکی از رزروها)، یک پاسخ با کد 400 Bad Request حاوی جزئیات خطا برمی‌گرداند.	Illuminate\Http\JsonResponse
در صورت وجود خطای اعتبارسنجی در داده‌های ورودی، یک پاسخ با کد 422 Unprocessable Entity برمی‌گرداند.	Illuminate\Http\JsonResponse

---

·  مثال استفاده / سناریو:

سناریو: اصلاح نام خانوادگی مسافر در رزرو شماره ۱۲۳۴۵ و تغییر وضعیت رزرو شماره ۱۲۳۴۶ به کنسل شده.

• Request Body:

    {
        "reservations": [
            {
                "id": 12345,
                "passenger": {
                    "fullname": {
                        "last_name": { "fa": "اکبری", "en": "Akbari" }
                    }
                }
            },
            {
                "id": 12346,
                "status": 2
            }
        ]
    }

• Action:

1. متد درخواست را دریافت کرده و حلقه را روی آرایه reservations شروع می‌کند.
2. برای رزرو 12345، آبجکت passenger را در دیتابیس پیدا کرده، نام خانوادگی را آپدیت و مجدداً به صورت JSON ذخیره می‌کند.
3. برای رزرو 12346، فیلد status را در دیتابیس به 2 تغییر می‌دهد.

• Response:
• کد وضعیت: 204 No Content
• Body: (خالی)