Function storeCharterReservation

·  هدف:

این متد به عنوان نقطه ورودی اصلی برای ثبت رزروهای جدید (یک یا چند مسافر) بر روی یک چارتر عمل می‌کند. منطق اصلی آن شامل اعتبارسنجی‌های چند لایه است: ابتدا با استفاده از ReservationController::capacityItemCharter ظرفیت خالی چارتر را بررسی می‌کند. سپس برای هر مسافر، اعتبارسنجی داده‌های هویتی (کد ملی، پاسپورت) را با Validator::checkIdentity انجام می‌دهد و مسافر را در جدول passengers درج یا به‌روزرسانی می‌کند. متد می‌تواند رزروهای عادی (با محاسبه قیمت از ReservationController::financialCalculation) و رزروهای اعتباری/گارانتی (که اطلاعات مالی مستقیماً در ورودی ارائه شده) را مدیریت کند. تمام رزروهای موفق در یک آرایه جمع‌آوری شده و در پاسخ نهایی به همراه شناسه‌های رزرو و PNR محلی بازگردانده می‌شوند. در صورت بروز خطا برای هر مسافر، اطلاعات خطا به جای نتیجه موفق در آرایه خروجی قرار می‌گیرد.

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

ساختار آبجکت مسافر در آرایه $request->passengers:

·     خروجی (Return):

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

سناریو: ثبت دو مسافر (یک عادی، یک اعتباری) روی یک پرواز

• Request Body:

    {
        "main_id": 450,
        "item_id": 980,
        "passengers": [
            { "identity": {...}, "age_title": "adult", "status": "definite" },
            { "identity": {...}, "age_title": "adult", "status": "definite", "financial": { "supplier": 22, "sale_price": 1500000, "commission": 50000 } }
        ]
    }

• Action:

1. ظرفیت آیتم 980 از چارتر 450 بررسی می‌شود. فرضاً ظرفیت کافی است.
2. مسافر اول: اطلاعات هویتی اعتبارسنجی می‌شود. financialCalculation برای محاسبه قیمت فراخوانی می‌شود. رزرو در جدول مربوطه درج می‌شود.
3. مسافر دوم: اطلاعات هویتی اعتبارسنجی می‌شود. چون financial وجود دارد، قیمت‌ها مستقیماً از ورودی خوانده شده و رزرو به عنوان اعتباری ثبت می‌شود.
4. برای هر دو رزرو موفق، PNR محلی تولید می‌شود.

• Response:
• HTTP Status: 201 Created
• Body:

        {
            "items": [
                { "status": true, "pnr": { "local": "CH-101", "original": "...", "id": 11234 } },
                { "status": true, "pnr": { "local": "CH-102", "original": "...", "id": 11235 } }
            ],
            "meta": { "timestamp": ... }
        }