# مشخص‌کردن شمول بیمه برای هر خدمت

## پروژه

`clinicpro` (backend + admin frontend)

## زمینه

هر خدمت کلینیک با موجودیت `ServiceItem` نگه‌داری می‌شود. در حال حاضر هیچ فیلدی ندارد که بگوید این خدمت **شامل بیمه می‌شود یا نه**.

## مشکل / هدف

افزودن قابلیت تعیین «شمول بیمه» به هر `ServiceItem`:

- یک پرچم: آیا این خدمت شامل بیمه می‌شود؟
- اگر شامل می‌شود، اطلاعات لازم برای محاسبه‌ی درست (مثلاً سهم بیمار / درصد پوشش / لیست بیمه‌های پذیرفته‌شده) ذخیره و نمایش داده شود.

## فایل‌های مرتبط

| فایل | نقش |
|------|-----|
| `src/ClinicService/Entity/ServiceItem.php` | موجودیت خدمت |
| `src/ClinicService/Controller/ClinicServiceController.php` | CRUD خدمات/بخش‌ها |
| `src/ClinicService/Repository/ServiceItemRepository.php` | کوئری‌ها |
| `assets/admin/pages/ClinicServicesPage.tsx` | صفحه‌ی مدیریت خدمات در پنل |
| `src/Patient/Service/PatientService.php` | محاسبه‌ی قیمت مراجعه (مصرف‌کننده‌ی خدمت) |
| `docs/api/clinic-services.md` | مستندات API خدمات |

## وضعیت فعلی

`ServiceItem` فیلدهای موجود:

```php
private string $name;
#[ORM\Column(name: 'price_rials', type: 'integer')]
private int $priceRials = 0;
#[ORM\Column(type: 'boolean')]
private bool $active = true;
```

`toArray()`:

```php
return [
    'uuid'         => $this->uuid,
    'section_uuid' => $this->section->getUuid(),
    'staff_uuid'   => $this->staff?->getUuid(),
    'staff_name'   => $this->staff?->getFullName(),
    'name'         => $this->name,
    'price_rials'  => $this->priceRials,
    'active'       => $this->active,
    'created_at'   => $this->createdAt,
    'updated_at'   => $this->updatedAt,
];
```

هیچ مفهوم بیمه‌ای ندارد.

## وظایف

### ۱. طراحی فیلد شمول بیمه

تصمیم بگیر مدل داده چه باشد:

- ساده: یک `bool $insuranceCovered = false`.
- کامل‌تر: `bool $insuranceCovered` + `?int $patientShareRials` (سهم بیمار وقتی بیمه اعمال شود) یا `?float $coveragePercent`.

> توصیه: `insuranceCovered` (bool) + `?int $insurancePriceRials` (قیمت/سهم بیمار با بیمه). اگر `insuranceCovered=false`، فیلد دوم نادیده گرفته شود.

طرح را قبل از پیاده‌سازی توضیح بده.

### ۲. Entity + Migration

- فیلد(ها) را به `ServiceItem` اضافه کن + getter/setter.
- در `toArray()` اضافه کن.
- `doctrine:migrations:diff` سپس `migrate`.

### ۳. API

`ClinicServiceController` (create/update خدمت) باید فیلدهای جدید را از body بپذیرد و ذخیره کند. validation مناسب (اگر `insurance_covered=true` و قیمت بیمه خالی، خطا یا صفر منطقی).

### ۴. Admin Frontend

در `ClinicServicesPage.tsx` فرم خدمت:

- یک toggle/checkbox «شامل بیمه می‌شود»
- وقتی روشن شد، ورودی «قیمت با بیمه (ریال)» نمایش داده شود
- در لیست خدمات، یک badge نشان دهد خدمت شامل بیمه است یا خیر

### ۵. مستندات

`docs/api/clinic-services.md` را با فیلدهای جدید در request/response به‌روز کن.

## نکات مهم

- قیمت‌ها integer ریال.
- این فیلد بعداً در محاسبه‌ی قیمت مراجعه (`PatientService::createSession`) قابل استفاده است؛ در این پرامپت فقط ذخیره/نمایش کافی است مگر اینکه ساده باشد همان‌جا هم اعمال شود.
- الگوی frontend خدمات موجود را رعایت کن (همان فرم/modal فعلی).
