Refactor code structure for improved readability and maintainability

docs/api/patient.md

@@ -303,6 +303,50 @@ Returns paginated sessions for a patient record.
 
 ---
 
+### List Patient Appointments
+
+```
+GET /api/v1/patient/{uuid}/appointments
+```
+
+نوبت‌های همین بیمار را برمی‌گرداند. برای جلوگیری از نشتِ اطلاعات بین ارائه‌دهنده‌ها، فقط نوبت‌هایی نمایش داده می‌شوند که با پزشک(های) خودِ صاحب پرونده گرفته شده‌اند:
+
+- ارائه‌دهنده‌ی **پزشک**: نوبت‌های بیمار با همان پزشک.
+- ارائه‌دهنده‌ی **کلینیک** (و منشیِ فعالِ کلینیک): نوبت‌های بیمار با پزشکانی که دعوت پذیرفته‌شده (`accepted`) در آن کلینیک دارند.
+
+مرتب‌شده بر اساس `starts_at` نزولی. خروجی آرایه‌ی ساده است (بدون صفحه‌بندی).
+
+**Response 200:**
+
+```json
+{
+  "success": true,
+  "data": [
+    {
+      "uuid": "…",
+      "starts_at": 1754000000,
+      "ends_at": 1754001800,
+      "status": "confirmed",
+      "doctor_name": "دکتر ژیلا فتحی",
+      "service_name": null,
+      "price_rials": null,
+      "created_at": 1754000000
+    }
+  ]
+}
+```
+
+`status` یکی از: `pending`، `confirmed`، `completed`، `cancelled_by_doctor`، `cancelled_by_user`، `no_show`، `expired`. فیلدهای `service_name`/`price_rials` فعلاً همیشه `null` هستند (نوبت خدمت/قیمت مستقل ندارد).
+
+**Errors:**
+
+| Code | HTTP | Description |
+|------|------|-------------|
+| `ERR_PATIENT_NOT_FOUND` | 404 | Record not found or not owned by caller |
+| `ERR_SUBSCRIPTION_REQUIRED` | 403 | No `patient_records` feature |
+
+---
+
 ### Create Session
 
 ```