Function deleteCharter

·  هدف:

این متد مسئولیت حذف کامل و دائمی یک چارتر و تمام داده‌های وابسته‌ی آن از سیستم را بر عهده دارد. عملکرد این تابع بسیار حساس و حیاتی است، زیرا قبل از اقدام به حذف، یک بررسی امنیتی کلیدی انجام می‌دهد: با فراخوانی تابع getCharterCapacity، ظرفیت فروخته‌شده‌ی چارتر را استعلام می‌کند. اگر حتی یک صندلی یا اتاق از چارتر فروخته شده باشد (یعنی ظرفیت کل با ظرفیت باقیمانده برابر نباشد)، متد عملیات را متوقف کرده و با یک خطای 409 Conflict به کاربر اطلاع می‌دهد که حذف به دلیل وجود رزروهای قطعی ممکن نیست. در صورت موفقیت‌آمیز بودن این بررسی، متد با استفاده از یک DB::transaction، حذف آبشاری داده‌ها را تضمین می‌کند. ابتدا خود رکورد چارتر از جدول charters حذف می‌شود، سپس تمام رکوردهای مرتبط در جداول charter_items و charter_calculations نیز پاک می‌شوند. این رویکرد تراکنشی، یکپارچگی دیتابیس را حفظ می‌کند و از باقی ماندن داده‌های یتیم (Orphaned Data) جلوگیری می‌نماید.

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

·     خروجی (Return):

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

سناریو ۱: حذف موفق یک چارتر بدون فروش

• Request:
• id: 350
• Action:

1. متد ظرفیت چارتر با شناسه 350 را بررسی می‌کند.
2. فرض: هیچ رزروی ثبت نشده است (capacity['total'] == capacity['capacity']).
3. یک تراکنش دیتابیس آغاز می‌شود.
4. رکوردها از charter_items و charter_calculations که main_id آن‌ها 350 است، حذف می‌شوند.
5. رکورد اصلی از جدول charters با شناسه 350 حذف می‌شود.
6. تراکنش با موفقیت commit می‌شود.

• Response:
• HTTP Status: 204 No Content

سناریو ۲: تلاش برای حذف چارتری که فروش داشته است

• Request:
• id: 351
• Action:

1. متد ظرفیت چارتر با شناسه 351 را بررسی می‌کند.
2. فرض: تعدادی رزرو ثبت شده است (capacity['total'] != capacity['capacity']).
3. عملیات متوقف شده و هیچ تغییری در دیتابیس اعمال نمی‌شود.

• Response:
• HTTP Status: 409 Conflict
• Body:

        {
            "error": {
                "code": 1000,
                "message": "بر روی این چارتر رزرو انجام شده است و امکان حذف وجود ندارد."
            }
        }