#P1091
Function storePledgerCharter
· هدف:
این متد یک عملکرد ساده و مشخص دارد: افزودن یک همکار (Colleague) به لیست متعهدان (Pledgers) یک شعبه. این کار با درج یک رکورد جدید در جدول charter_pledgers انجام میشود. اطلاعات لازم برای این کار، یعنی شناسه همکار (colleague_id) و شناسه شعبه (branch)، از ورودی درخواست و اطلاعات توکن کاربر استخراج میشود. این متد به عنوان یک نقطه پایانی سریع برای مدیریت لیست متعهدان عمل میکند.
| ویژگیها | توضیحات |
| هدف کلی | ثبت یک همکار به عنوان متعهد جدید. |
| عملیات اصلی | درج یک رکورد جدید در جدول charter_pledgers. |
| منبع داده | شناسه همکار از بدنه درخواست و شناسه شعبه از توکن کاربر. |
| سادگی | عدم وجود منطق پیچیده؛ تنها یک عملیات insert ساده. |
| پاسخ موفقیت | بازگرداندن پاسخ 201 Created در صورت درج موفقیتآمیز. |
· ورودیها (پارامترها):
| توضیحات | موقعیت | نوع داده | نام پارمتر |
| شناسه همکاری که باید به عنوان متعهد ثبت شود. | Body |
integer |
$request->colleague_id |
| شناسه شعبه کاربر که به صورت خودکار به درخواست اضافه میشود. | Token/Middleware |
integer |
$request->get('branch') |
· خروجی (Return):
| توضیحات | نوع داده |
در صورت موفقیت، یک پاسخ خالی با کد 201 Created. |
Illuminate\Http\JsonResponse |
در صورت بروز خطا (مثلاً خطای دیتابیس)، یک پاسخ با کد 400 Bad Request و جزئیات استثناء. |
Illuminate\Http\JsonResponse |
· مثال استفاده / سناریو:
سناریو: افزودن همکار با شناسه ۷۵ به لیست متعهدان شعبه ۲
- Request Body:
json
{
"colleague_id": 75
}
(درخواست از طرف کاربری در شعبه ۲ ارسال شده است)
- Action:
- یک آرایه
insertبا مقادیرbranch: 2وcolleague_id: 75ساخته میشود. DB::table('charter_pledgers')->insert($insert)اجرا میشود.
- Response:
HTTP Status:201 Created