#P1097
Function storeCommunicationCharter
· هدف:
این متد برای ایجاد یک “ارتباط” (Communication) جدید بین دو چارتر یا دو آیتم خاص از چارترها طراحی شده است. این ارتباطات برای ساختن پکیجها (مثلاً تور رفت و برگشت با دو پرواز مجزا) کاربرد دارند. متد دادههای مربوط به مبدأ (main_id, item_id) و مقصد (communication_main_id, communication_item_id) ارتباط را به همراه نوع اتصال (source_type, destination_type) از ورودی دریافت کرده و یک رکورد جدید در جدول charter_communications درج میکند. این یک عملیات ساده و اتمی برای تعریف پیوند بین موجودیتهای مختلف چارتری است.
| ویژگیها | توضیحات |
| هدف کلی | ثبت یک ارتباط یا پیوند جدید بین دو چارتر/آیتم. |
| عملیات اصلی | درج یک رکورد در جدول charter_communications. |
| انعطافپذیری | قابلیت اتصال چارتر به چارتر، آیتم به آیتم، چارتر به آیتم و آیتم به چارتر. |
| سادگی | عدم وجود منطق پیچیده، تنها یک عملیات insert. |
| پاسخ موفقیت | بازگرداندن پاسخ 201 Created در صورت درج موفق. |
· ورودیها (پارامترها):
| توضیحات | موقعیت | نوع داده | نام پارمتر |
| شناسه چارتر مبدأ. | Body |
integer |
$request->main_id |
| شناسه آیتم مبدأ (اختیاری). | Body |
integer |
$request->item_id |
| شناسه چارتر مقصد. | Body |
integer |
$request->communication_main_id |
| شناسه آیتم مقصد (اختیاری). | Body |
integer |
$request->communication_item_id |
نوع مبدأ (charter یا item). |
Body |
string |
$request->source_type |
نوع مقصد (charter یا item). |
Body |
string |
$request->destination_type |
· خروجی (Return):
| توضیحات | نوع داده |
در صورت موفقیت، یک پاسخ خالی با کد 201 Created. |
Illuminate\Http\JsonResponse |
در صورت بروز خطا، یک پاسخ با کد 400 Bad Request. |
Illuminate\Http\JsonResponse |
· مثال استفاده / سناریو:
سناریو: اتصال کلاس بیزنس پرواز رفت به کلاس بیزنس پرواز برگشت
- Request Body:
json
{
"main_id": 101,
"item_id": 501,
"source_type": "item",
"communication_main_id": 202,
"communication_item_id": 601,
"destination_type": "item"
}
- Action:
- یک رکورد جدید در
charter_communicationsبا مقادیر فوق درج میشود.
- Response:
HTTP Status:201 Created