# RESOURCE /v2/scrumboard/sprint_reports

<div class="api-docs" id="bkmrk-">  <div class="endpoint-section">  
</div></div>## Sprint Report Hydration Logic

گزارش‌های اسپرینت، زیرمجموعه‌ای از اسپرینت‌ها هستند و منطق Hydration ساده‌ای دارند. در تمام متدها، پس از دریافت داده‌های گزارش، سیستم فقط اطلاعات اپراتور (نویسنده) را از جدول `operators` بارگذاری می‌کند.

<div class="api-docs" id="bkmrk-fetch-sprint-report%28"><div class="endpoint-section"><div class="flowchart"><div class="flow-item">Fetch Sprint Report(s)</div><div class="flow-arrow">↓</div><div class="flow-item-process" style="background-color: #e3f2fd;">**Hydrate Operator**  
If `operator` field exists, fetch the full operator object from the `operators` table.</div><div class="flow-arrow">↓</div><div class="flow-item-success">Return Report with Operator Details</div></div></div>  
---

  </div># Get Sprint Reports List

دریافت لیست گزارش‌های ثبت شده برای یک اسپرینت مشخص.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fscrumboard%2F"><div class="endpoint-info"><div>**URL:** `/v2/scrumboard/sprint_reports`</div><div>**Method:** <span class="method-get">GET</span></div><div>**Controller:** SprintReportController@index</div></div></div>### Parameters

<div class="api-docs" id="bkmrk-parameter-type-locat"><table class="schema-table" dir="rtl"><thead><tr><th>Parameter</th><th>Type</th><th>Location</th><th>Description</th></tr></thead><tbody><tr><td dir="ltr">sprint\_id</td><td>Integer</td><td>Query</td><td>(الزامی) شناسه اسپرینت والد.</td></tr><tr><td dir="ltr">status</td><td>Integer</td><td>Query</td><td>(اختیاری) فیلتر بر اساس وضعیت گزارش.</td></tr></tbody></table>

</div>### Response Structure

در صورت عدم وجود گزارش، مقدار `items: false` برگردانده می‌شود.

```json
{
    "items": [
        {
            "id": 1,
            "sprint_id": 10,
            "title": "Daily Stand-up - Day 3",
            "description": "Discussed blocker on API endpoint...",
            "issued_at": "2025-12-08 09:00:00",
            "status": 1,
            "operator": {
                "id": 5,
                "first_name": "Reza",
                "last_name": "Ahmadi",
                "avatar": "..."
            },
            "created_at": "..."
        }
    ],
    "meta": { "timestamp": 1733754000 }
}
```

<div class="api-docs" id="bkmrk--1">---

  </div># Create Sprint Report

ایجاد یک گزارش جدید برای یک اسپرینت. شناسه اپراتور (نویسنده) به صورت خودکار از توکن کاربر احراز هویت شده (`authWithJwt`) استخراج و ثبت می‌شود.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fscrumboard%2F-1"><div class="endpoint-info"><div>**URL:** `/v2/scrumboard/sprint_reports`</div><div>**Method:** <span class="method-post">POST</span></div><div>**Controller:** SprintReportController@store</div></div></div>### Body Parameters

<div class="api-docs" id="bkmrk-parameter-type-descr"><table class="schema-table" dir="rtl"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td dir="ltr">sprint\_id</td><td>Integer</td><td>(الزامی) شناسه اسپرینت والد.</td></tr><tr><td dir="ltr">title</td><td>String</td><td>(الزامی) عنوان گزارش.</td></tr><tr><td dir="ltr">description</td><td>String</td><td>(الزامی) متن گزارش.</td></tr><tr><td dir="ltr">issued\_at</td><td>DateTime</td><td>(الزامی) تاریخ و زمان صدور گزارش (مثلاً زمان جلسه).</td></tr></tbody></table>

</div>### Success Response

```json
{
    "payload": {
        "id": 2,
        "sprint_id": 10,
        "title": "Sprint Review Notes",
        ...
        "operator": {
            "id": 1, 
            "first_name": "Admin",
            ...
        }
    },
    "meta": { "timestamp": 1733754000 }
}
```

<div class="api-docs" id="bkmrk--2">---

  </div># Show Sprint Report Details

مشاهده جزئیات یک گزارش خاص با شناسه آن.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fscrumboard%2F-2"><div class="endpoint-info"><div>**URL:** `/v2/scrumboard/sprint_reports/{id}`</div><div>**Method:** <span class="method-get">GET</span></div><div>**Controller:** SprintReportController@show</div></div></div>### Response

در صورت پیدا نشدن گزارش، `payload: false` برمی‌گردد.

```json
{
    "payload": {
        "id": 1,
        "title": "Daily Stand-up - Day 3",
        "operator": { ... },
        ...
    },
    "meta": { "timestamp": 1733754000 }
}
```

<div class="api-docs" id="bkmrk--3">---

  </div># Update Sprint Report

به‌روزرسانی اطلاعات یک گزارش. توجه داشته باشید که نویسنده (operator) قابل تغییر نیست.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fscrumboard%2F-3"><div class="endpoint-info"><div>**URL:** `/v2/scrumboard/sprint_reports/{id}`</div><div>**Method:** <span class="method-put">PUT</span> / <span class="method-patch">PATCH</span></div><div>**Controller:** SprintReportController@update</div></div></div>### Body Parameters

<div class="api-docs" id="bkmrk-parameter-type-descr-1"><table class="schema-table" dir="rtl"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td dir="ltr">sprint\_id</td><td>Integer</td><td>انتقال گزارش به اسپرینت دیگر.</td></tr><tr><td dir="ltr">title</td><td>String</td><td>تغییر عنوان.</td></tr><tr><td dir="ltr">description</td><td>String</td><td>تغییر متن گزارش.</td></tr><tr><td dir="ltr">issued\_at</td><td>DateTime</td><td>تغییر زمان صدور.</td></tr><tr><td dir="ltr">status</td><td>Integer</td><td>تغییر وضعیت (پیش‌فرض 1).</td></tr></tbody></table>

</div>### Success Response

```json
{
    "payload": {
        "id": 1,
        "title": "Updated report title",
        ...
    },
    "meta": { "timestamp": 1733754000 }
}
```

<div class="api-docs" id="bkmrk--4">---

  </div># Delete Sprint Report

حذف یک گزارش از سیستم.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fscrumboard%2F-4"><div class="endpoint-info"><div>**URL:** `/v2/scrumboard/sprint_reports/{id}`</div><div>**Method:** <span class="method-delete">DELETE</span></div><div>**Controller:** SprintReportController@destroy</div></div></div>### Response

```json
{
    "payload": 1, // 1 برای موفقیت، 0 برای عدم موفقیت
    "meta": { "timestamp": 1733754000 }
}
```