Function getAccommodationRooms

·  هدف:

این متد برای واکشی و نمایش وضعیت اتاق‌های یک چارتر اقامتی در یک بازه زمانی مشخص طراحی شده است. هدف اصلی آن، ارائه یک نمای گرافیکی یا جدولی از در دسترس بودن اتاق‌ها در طول زمان است. متد ابتدا یک دوره زمانی (CarbonPeriod) بین تاریخ شروع و پایان ورودی ایجاد می‌کند. سپس، برای هر اتاق (room_id) مربوط به چارتر، وضعیت رزرو آن را در هر روز از دوره زمانی مشخص شده بررسی می‌کند. برای هر روز، وضعیت اتاق می‌تواند یکی از سه حالت باشد: available (آزاد)، unavailable (مثلاً برای تعمیرات)، یا reserved (رزرو شده). در حالت reserved، اطلاعات رزرو مربوطه نیز به خروجی ضمیمه می‌شود. این ساختار داده خروجی برای رندر کردن تقویم وضعیت اتاق‌ها در فرانت‌اند بسیار مناسب است.

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

·     خروجی (Return):

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

سناریو: مشاهده وضعیت اتاق‌های هتل در ماه اکتبر

• Request URL: /api/panel/v2/charter/620/accommodation/rooms?from=2025-10-01&to=2025-10-31
• Action:

1. یک CarbonPeriod از اول تا آخر اکتبر ایجاد می‌شود.
2. تمام اتاق‌های چارتر ۶۲۰ و تمام رزروهای آن در این بازه واکشی می‌شوند.
3. برای هر اتاق، متد روی تمام روزهای اکتبر حلقه می‌زند.
4. برای هر روز، بررسی می‌کند که آیا رزروی آن روز را پوشش می‌دهد یا خیر.

• Response:
• HTTP Status: 200 OK
• Body:

        {
            "payload": [
                {
                    "room_id": 201, "number": "101", ...,
                    "dates": {
                        "2025-10-15": { "status": "available" },
                        "2025-10-16": { "status": "reserved", "reservation": {...} },
                        "2025-10-17": { "status": "reserved", "reservation": {...} },
                        // ...
                    }
                }
            ],
            "meta": { "timestamp": ... }
        }