Function operationWarrantyCharter

·  هدف:

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

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

·     خروجی (Return):

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

سناریو ۱: افزودن دو همکار با شناسه‌های ۲۰۰۱ و ۲۰۰۲ به عنوان گارانتی‌کننده برای چارتر ۱۰۰.

• Request Body:

    {
        "main_id": 100,
        "action": "add",
        "items": [2001, 2002]
    }

• Action:

1. متد درخواست را با action: "add" دریافت می‌کند.
2. به ازای هر id در آرایه items، یک رکورد جدید در جدول charter_warranties با charter_id = 100 و guarantor = id ایجاد می‌کند (به شرطی که از قبل وجود نداشته باشد).

• Response:
• کد وضعیت: 204 No Content

سناریو ۲: حذف دو تضمین با شناسه‌های ۳۵ و ۳۶ از چارتر مربوطه.

• Request Body:

    {
        "main_id": 100, // در این سناریو main_id استفاده نمی‌شود ولی ارسال آن الزامی است
        "action": "remove",
        "items": [35, 36]
    }

• Action:

1. متد درخواست را با action: "remove" دریافت می‌کند.
2. رکوردهایی از جدول charter_warranties که id آن‌ها در آرایه [35, 36] موجود است را حذف فیزیکی (delete) می‌کند.

• Response:
• کد وضعیت: 204 No Content