# 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
```json { "colleague_id": 75 } ``` (درخواست از طرف کاربری در شعبه ۲ ارسال شده است) - **Action:** 1. یک آرایه `insert` با مقادیر `branch: 2` و `colleague_id: 75` ساخته می‌شود. 2. `DB::table('charter_pledgers')->insert($insert)` اجرا می‌شود. - **Response:** - `HTTP Status`: `201 Created`