Skip to main content
#P1558

GET /api/v2/tasks/list

Route Info

Method Endpoint Controller Middleware
GET /api/v2/tasks/list OfficialController@listTasks authWithJwt

معماری و منطق پردازش

این متد لیست وظایف را دریافت کرده و با استفاده از دو تابع کمکی، اطلاعات آن را تکمیل می‌کند:

  1. شناسایی اپراتورها (Operator Resolution):
    فراخوانی متد StaticController::getOperators. این تابع ورودی را استاندارد کرده و از جدول operators اطلاعات را می‌خواند. خروجی شامل:
    • فیلد text (ترکیب شناسه پرسنلی و نام برای نمایش).
    • آبجکت query (جزئیات کامل دیتابیس).
  2. مدیریت اتصالات (Connection Hydration):
    اگر تسک به جایی متصل باشد، متد OfficialController::getConnection اجرا می‌شود. برای نوع reference، سیستم ابتدا کش Redis را چک می‌کند. اگر دیتا نبود، تابع مالی TradeController::financial اجرا و نتیجه کش می‌شود.

ساختار پاسخ (Response Structure)

{
  "status": true,
  "time": 1732047000,
  "data": [
    {
      "id": 105,
      "title": "پیگیری رفرنس ۱۲۵۰",
      "category": {
        "id": 12,
        "title": "مالی"
      },
      
      // Created by getOperators
      "user": [
        {
          "id": 50,
          "text": "10050 - Ali Mohammadi",
          "query": {
            "id": 50,
            "first_name": "Ali",
            "last_name": "Mohammadi",
            "group": "IT",
            "position": "Developer",
            "personnel_id": "10050"
          }
        }
      ],

      // Created by getOperators
      "operators": [
        {
          "id": 51,
          "text": "10051 - Reza Alavi",
          "query": {
            "id": 51,
            "first_name": "Reza",
            "last_name": "Alavi",
            "group": "Accounting",
            "personnel_id": "10051"
          }
        }
      ],

      // Created by getConnection (Redis + TradeController)
      "connection": [
        {
          "id": 2050,
          "type": "reference",
          "title": "تور کیش - هتل داریوش",
          "financial": {
             "total_price": 50000000,
             "paid": 20000000,
             "remaining": 30000000,
             "status": "debtor"
          }
        }
      ],

      "priority": 1,
      "status": 1,
      "created": "2025-02-18 10:30:00"
    }
  ]
}