Skip to main content
#P1556

POST /api/v2/tasks/category/operation

Route Info

Method Endpoint Controller
POST /api/v2/tasks/category/operation OfficialController@operationTasksCategory

شرح عملکرد (Functionality)

این متد مدیریت کامل (CRUD) دسته‌بندی‌های تسک را بر عهده دارد و بر اساس پارامتر action رفتار متفاوتی نشان می‌دهد:

  • عملیات Store (ایجاد):
    • یک رکورد جدید در جدول tasks_categories ایجاد می‌کند.
    • فیلد user با شناسه اپراتور جاری و فیلد branch با شناسه شعبه جاری پر می‌شود.
    • اطلاعات ظاهری (عنوان، رنگ، آیکون) از آرایه data دریافت می‌شود.
  • عملیات Update (ویرایش):
    • رکورد مربوط به id ارسالی را در جدول tasks_categories پیدا کرده و فیلدهای title، color و icon را به‌روزرسانی می‌کند.
  • عملیات Delete (حذف کامل و آبشاری):
    • ابتدا خود دسته‌بندی را از جدول tasks_categories حذف می‌کند.
    • سپس تمام تسک‌های زیرمجموعه این دسته‌بندی را از جدول tasks_items حذف می‌کند.
    • در نهایت، تمامی یادداشت‌ها (Notes) مرتبط با آن تسک‌های حذف شده را نیز از جدول tasks_notes پاک می‌کند تا دیتای یتیم (Orphan Data) باقی نماند.

پارامترهای ورودی (Input Parameters)

نام پارامتر نوع الزامی؟ توضیحات
action String بله نوع عملیات: store, update, delete.
id Integer شرطی برای update و delete الزامی است.
data Array شرطی برای store و update الزامی است. حاوی اطلاعات دسته‌بندی.

ساختار آرایه data:

{
    "title": "عنوان دسته‌بندی",
    "color": "#FF0000",  // کد رنگ HEX
    "icon": "fa-list"    // کلاس آیکون (مثلاً FontAwesome)
}

نمونه خروجی (Response)

در صورت موفقیت عملیات:

{
    "status": true,
    "time": 1732615200
}

در صورت بروز خطا (Exception):

{
    "status": false,
    "time": 1732615200,
    "message": "Error message description",
    "trace": [ ... ]
}
Back to top