# GET /api/v2/tasks/task/details

<div id="bkmrk-" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"></div>### Route Info

<div id="bkmrk-method-endpoint-cont" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"><div><table border="1" style="width: 100%; margin: auto; border-collapse: collapse; text-align: center; border: 1px solid #ddd;"><tbody><tr style="background: #f4f4f4; font-weight: bold;"><td style="padding: 10px;">Method</td><td style="padding: 10px;">Endpoint</td><td style="padding: 10px;">Controller</td></tr><tr><td style="direction: ltr; padding: 10px;">GET</td><td style="direction: ltr; padding: 10px;">/api/v2/tasks/task/details</td><td style="direction: ltr; padding: 10px;">OfficialController@getTasksDetails</td></tr></tbody></table>

</div></div>### شرح عملکرد (Functionality)

این متد جزئیات تکمیلی یک تسک مشخص را که شامل **یادداشت‌ها (Notes)** و **چک‌لیست‌ها (Checklists)** است، بازیابی می‌کند. منطق عملکرد به شرح زیر است:

<div id="bkmrk-%DB%8C%D8%A7%D8%AF%D8%AF%D8%A7%D8%B4%D8%AA%E2%80%8C%D9%87%D8%A7-%28notes%29%3A-" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;">- **یادداشت‌ها (Notes):**
    - اطلاعات از جدول `tasks_notes` بر اساس شناسه تسک دریافت می‌شود.
    - اطلاعات کاربر نویسنده یادداشت (`user`) با فراخوانی `StaticController::getOperators` هیدراته می‌شود. از آنجا که ایندکس `[0]` انتخاب شده، خروجی کاربر یک **آبجکت** است.
- **چک‌لیست (Checklist):**
    - آیتم‌ها از جدول `tasks_item_checklist` واکشی می‌شوند.
    - وضعیت انجام کار (`done`) به صورت Boolean محاسبه می‌شود.
    - اگر آیتم انجام شده باشد (`done\_at` نال نباشد)، اطلاعات کاربری که آن را انجام داده (`done\_by`) نیز به صورت یک آبجکت کامل کاربر برگردانده می‌شود. در غیر این صورت، مقدار `false` برمی‌گردد.

</div>### پارامترهای ورودی (Input Parameters)

<div id="bkmrk-%D9%86%D8%A7%D9%85-%D9%BE%D8%A7%D8%B1%D8%A7%D9%85%D8%AA%D8%B1-%D9%86%D9%88%D8%B9-%D8%A7%D9%84%D8%B2%D8%A7" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"><div><table border="1" style="width: 100%; border-collapse: collapse; text-align: right;"><thead><tr style="background: #f4f4f4;"><th style="padding: 8px;">نام پارامتر</th><th style="padding: 8px;">نوع</th><th style="padding: 8px;">الزامی؟</th><th style="padding: 8px;">توضیحات</th></tr></thead><tbody><tr><td style="direction: ltr;">id</td><td>Integer</td><td>بله</td><td>شناسه تسک (Task ID) که جزئیات آن مورد نیاز است.</td></tr></tbody></table>

</div></div>### نمونه خروجی (Response)

خروجی شامل آبجکت `payload` است که دو بخش اصلی `notes` و `checklist` را در بر می‌گیرد.

```
{
    "payload": {
        "notes": [
            {
                "user": {
                    "id": 10,
                    "text": "1001 - نام کاربر",
                    "query": { ... } // جزئیات کامل کاربر
                },
                "note": "این یک یادداشت نمونه برای تسک است.",
                "created": "2024-11-25T10:00:00.000000Z"
            }
        ],
        "checklist": [
            {
                "id": 55,
                "operator": { // کاربری که آیتم چک‌لیست را ایجاد کرده
                    "id": 10,
                    "text": "1001 - ایجاد کننده",
                    "query": { ... }
                },
                "content": "بررسی مستندات فنی",
                "done": true,
                "done_by": { // کاربری که آیتم را تیک زده (انجام داده)
                    "id": 12,
                    "text": "1002 - انجام دهنده",
                    "query": { ... }
                },
                "done_at": "2024-11-26 14:30:00",
                "created_at": "2024-11-25T09:00:00.000000Z"
            },
            {
                "id": 56,
                "operator": { ... },
                "content": "تست نهایی روی سرور استیج",
                "done": false,
                "done_by": false, // چون انجام نشده
                "done_at": false, // چون انجام نشده
                "created_at": "2024-11-25T09:05:00.000000Z"
            }
        ]
    },
    "meta": {
        "timestamp": 1732616000
    }
}
```