feat(claims): enhance claims filtering with insurance, date range, and patient search

docs/api/billing.md

@@ -110,8 +110,20 @@
 
 هر مطالبه در پاسخ علاوه بر `insurance_id`، فیلد `insurance_name` (نام بیمه، یا `null` اگر بیمه حذف شده باشد) را نیز دارد. در `POST` و `transition` و `GET` یکسان است.
 
-## GET /api/v1/billing/claims?status=
-لیست مطالبات tenant. فیلتر اختیاری `status` (`pending|submitted|approved|rejected|paid`). هر مطالبه شامل `insurance_name` و آرایه‌ی `items` با جزئیات هر ردیف است.
+## GET /api/v1/billing/claims
+لیست مطالبات tenant با فیلترهای اختیاری (query params):
+
+| پارامتر | نوع | توضیح |
+|---------|-----|-------|
+| `status` | string | `pending\|submitted\|approved\|rejected\|paid` |
+| `insurance_id` | int | فقط مطالبات یک بیمه‌گر |
+| `from` | int (Unix) | مطالبات با `created_at >= from` (شروع بازه) |
+| `to` | int (Unix) | مطالبات با `created_at <= to` (پایان بازه) |
+| `q` | string | جستجوی بیمار: موبایل، کدملی یا نام (LIKE) |
+
+> بازه‌ی تاریخ شمسی (سال/ماه/روز خاص) در سمت کلاینت به `from`/`to` یونیکس تبدیل می‌شود؛ backend فقط بازه‌ی یونیکس می‌گیرد. فیلتر `q` از طریق زنجیره `claim → claim_item → invoice_item → invoice → patient_record → user` با `EXISTS` اعمال می‌شود.
+
+هر مطالبه شامل `insurance_name`، `patient_name`، `patient_mobile` و آرایه‌ی `items` با جزئیات هر ردیف است.
 
 هر عضو `items` علاوه بر `invoice_item_id`، `claimed_rials`، `approved_rials`، این فیلدهای نمایشی را دارد (برای جدول صفحه‌ی مطالبات):