Function transferCharterReservation

·  هدف:

این متد برای انتقال یک یا چند رزرو از یک آیتم چارتر (مثلاً یک کلاس پروازی) به آیتم چارتری دیگر (مثلاً کلاس پروازی متفاوت در همان پرواز یا پروازی دیگر) طراحی شده است. منطق اصلی آن بر پایه اعتبارسنجی ظرفیت مقصد استوار است. قبل از هر اقدامی، متد با فراخوانی ReservationController::capacityItemCharter، ظرفیت خالی آیتم مقصد (goal) را بررسی می‌کند. اگر ظرفیت مقصد برای پذیرش تعداد رزروهای در حال انتقال کافی باشد، متد در یک حلقه، شناسه‌های main_id و item_id هر رزرو را به شناسه‌های آیتم مقصد به‌روزرسانی می‌کند. این عملیات به صورت اتمیک برای هر رزرو انجام می‌شود. در صورتی که ظرفیت مقصد کافی نباشد، عملیات متوقف شده و یک خطای 422 بازگردانده می‌شود تا از ایجاد وضعیت ناهماهنگ در داده‌ها جلوگیری شود.

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

·     خروجی (Return):

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

سناریو: انتقال دو مسافر از کلاس اکونومی به بیزنس در یک پرواز

• Request Body:

    {
        "items": [5432, 5433],
        "goal": {
            "main_id": 450,
            "item_id": 981
        }
    }

• Action:

1. متد ظرفیت آیتم 981 (کلاس بیزنس) از چارتر 450 را بررسی می‌کند.
2. فرض: ظرفیت خالی بیشتر از ۲ نفر است.
3. متد یک حلقه روی items اجرا می‌کند.
4. برای رزرو 5432: UPDATE charter_route_reservation SET main_id=450, item_id=981 WHERE id=5432.
5. برای رزرو 5433: UPDATE charter_route_reservation SET main_id=450, item_id=981 WHERE id=5433.

• Response:
• HTTP Status: 204 No Content