# تسک ۰۶: ماژول کلینیک

## توضیح
پیاده‌سازی مدیریت کلینیک‌ها، لیست کلینیک‌ها، لیست دکترهای هر کلینیک
و آپلود تصویر و لوگوی کلینیک.

## Endpoint ها (واقعی از Drupal)

| متد | مسیر | توضیح | نیاز به Auth |
|-----|------|-------|-------------|
| POST | `/api/v1/clinic` | ایجاد کلینیک | بله |
| GET | `/api/v1/clinic/{uuid}` | دریافت اطلاعات کامل کلینیک | خیر |
| PATCH | `/api/v1/clinic/{uuid}` | ویرایش کلینیک | بله (Owner/Admin) |
| GET | `/api/v1/clinics` | لیست کلینیک‌ها با فیلتر | خیر |
| GET | `/api/v1/clinic/doctor-list/{clinic_uuid}` | لیست دکترهای کلینیک | خیر |
| POST | `/file/upload/clinic_pro/clinic/field_image_clinic` | آپلود تصویر گالری کلینیک | بله |
| POST | `/file/upload/clinic_pro/clinic/field_clinic_logo` | آپلود لوگوی کلینیک | بله |

> **⚠ مسیر آپلود واقعی:** `/file/upload/clinic_pro/clinic/field_image_clinic` (نه `/api/v1/clinic/image`)

## پیش‌نیازها
- تسک ۰۱، ۰۲، ۰۵ (Doctor)، ۰۸ (Categories)

## زمان تخمینی
۶ تا ۸ ساعت

---

## فیلترهای GET /api/v1/clinics

| پارامتر | نوع | الزامی | مثال |
|---------|-----|--------|------|
| `state` | string | خیر | `13` |
| `city` | string | خیر | `32` |
| `specialty` | string | خیر | `511` |
| `page` | string | بله | `1` |
| `limit` | string | بله | `10` |
| `sort` | string | خیر | `DESC` |

---

## نمونه واقعی Response — GET /api/v1/clinic/{uuid}

```json
{
  "id": "23",
  "uuid": "e4550163-5a88-4f67-b07e-cd6063738598",
  "title": "clinic 1",
  "images_clinic": [
    {
      "url": "https://domain.com/sites/default/files/2025-11/image.png",
      "fid": "91",
      "filename": "image.png",
      "filemime": "image/png",
      "filesize": 34314
    }
  ],
  "clinic_logo": [
    {
      "url": "https://domain.com/sites/default/files/clinics/logo/2025-11/logo.png",
      "fid": "96",
      "filename": "logo.png",
      "filemime": "image/png",
      "filesize": 39281
    }
  ],
  "phone_number": "۰۶۱-۳۳۹۱۶۵۸۹",
  "caption": "توضیحات درباره کلینیک...",
  "list_bime": [
    {
      "uuid": "...",
      "id": "1559",
      "name": "بیمه آتیه سازان حافظ",
      "logo": [{ "url": "...", "fid": "5", "filename": "hafez-insurance.png", "filemime": "image/png", "filesize": 16100 }]
    }
  ],
  "specialties": [
    { "uuid": "...", "id": "610", "name": "روماتولوژی", "parent": "602" }
  ],
  "services": [
    { "uuid": "...", "id": "1602", "name": "ویزیت تخصصی" }
  ],
  "clinic_specialty": [
    { "uuid": "...", "id": "610", "name": "روماتولوژی", "parent": "602" }
  ],
  "doctors": 3,
  "doctor_list": null,
  "city": [{ "uuid": "...", "id": "130", "name": "بندرعباس", "parent": "29" }],
  "state": [{ "uuid": "...", "id": "29", "name": "هرمزگان" }],
  "location": "بندرعباس: رسالت شمالی- میدان صادقیه",
  "map": { "latitude": "27.200632975404", "longitude": "56.356043815613" },
  "24_7": true,
  "field_working_days": "شنبه تا سه شنبه ساعت ۱۲:۲۰"
}
```

> **⚠ نکات فیلدهای واقعی Response:**
> - **`phone_number`** (نه `telephone`!) — شماره تماس
> - **`caption`** (نه `info`!) — توضیحات کلینیک
> - **`images_clinic`** (نه `images`!) — تصاویر گالری با url/fid/filename/filemime/filesize
> - **`clinic_logo`** (نه `logo`!) — لوگو با url/fid/filename/filemime/filesize
> - **`list_bime`** (نه `insurances`!) — بیمه‌های کلینیک، هر آیتم دارای `logo` نیز هست
> - **`field_working_days`** — روزهای کاری (string آزاد)
> - **`24_7`** — boolean
> - **`doctors`** — تعداد دکترها (integer)
> - **`services`** و **`clinic_specialty`** هر دو در response هستند

---

## فیلدهای PATCH /api/v1/clinic/{uuid}

```json
{
  "name": "نام کلینیک",
  "address": "آدرس",
  "telephone": "شماره تلفن",
  "latitude": "27.2",
  "longitude": "56.3",
  "insurance": [300, 301],
  "info": "توضیحات",
  "doctor_services": [575, 576],
  "working_days": "شنبه تا سه‌شنبه",
  "24_7": 1,
  "image_clinic": [91, 92],
  "clinic_logo": [96]
}
```

## فیلدهای POST /api/v1/clinic (ایجاد)

```json
{
  "name": "نام کلینیک",
  "state": [1],
  "city": [32],
  "address": "آدرس",
  "telephone": "شماره تلفن",
  "latitude": "50.21",
  "longitude": "57.212",
  "insurance": [300, 301],
  "info": "توضیحات",
  "doctor_services": [575, 576],
  "working_days": "شنبه تا سه‌شنبه",
  "24_7": 1,
  "image_clinic": [19],
  "clinic_logo": [20]
}
```

---

## آپلود تصویر/لوگوی کلینیک

```
POST /file/upload/clinic_pro/clinic/field_image_clinic
POST /file/upload/clinic_pro/clinic/field_clinic_logo

Headers:
  Content-Type: application/octet-stream
  Content-Disposition: file; filename="clinic.png"
  X-CSRF-Token: {token}
  Authorization: Bearer {token}
Body: binary file content
Response → { fid, ... } که در image_clinic یا clinic_logo استفاده می‌شود
```
