feat: add mobile-based patient lookup for appointment booking

- Implemented a new endpoint `/api/v1/my/appointment/patient-lookup` to search for patients by mobile number before booking an appointment.
- Updated the `NewAppointmentModal` component to utilize the new patient lookup feature, allowing for direct booking if the patient is found with a national code.
- Enhanced the appointment booking form to handle mobile input normalization and display relevant fields based on the search results.
- Added tests for the new patient lookup functionality, ensuring proper behavior for found and not found cases, as well as validation for mobile input.
- Updated sidebar tests to reflect changes in the sidebar component structure and functionality.

docs/api/appointment.md

@@ -434,6 +434,46 @@ Create a new appointment for a patient. Used by doctor/clinic/secretary to book
 
 ---
 
+## GET `/api/v1/my/appointment/patient-lookup`
+
+جستجوی بیمار با شماره موبایل، پیش از ثبت نوبت. فرم ثبت نوبت اول با موبایل جستجو می‌کند؛ اگر بیمار یافت شد و کد ملی دارد، مستقیم استفاده می‌شود، وگرنه کد ملی و نام از کاربر گرفته می‌شود.
+
+**Auth:** `IS_AUTHENTICATED_FULLY` — Roles: `ROLE_DOCTOR`, `ROLE_CLINIC`, `ROLE_SECRETARY`, `ROLE_ADMIN`
+
+> برخلاف `GET /api/v1/patient/search-user`، این endpoint به فیچر `patient_records` اشتراک وابسته نیست و `ROLE_ADMIN` را هم می‌پذیرد، چون ثبت نوبت باید مستقل از اشتراک کار کند.
+
+### Query Parameters
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `mobile` | string | ✅ | شماره موبایل ایران (`^09\d{9}$`)؛ ارقام فارسی به انگلیسی تبدیل می‌شوند |
+
+### Response `200` — یافت شد
+```json
+{
+  "success": true,
+  "data": {
+    "found": true,
+    "name": "علی محمدی",
+    "mobile": "09123456789",
+    "national_code": "0012345678"
+  }
+}
+```
+> `national_code` ممکن است `null` باشد (بیمار قدیمی بدون کد ملی) — در این حالت فرم کد ملی را می‌گیرد.
+
+### Response `200` — یافت نشد
+```json
+{ "success": true, "data": { "found": false } }
+```
+
+### Error Responses
+| Code | HTTP | Description |
+|------|------|-------------|
+| `FORBIDDEN` | 403 | Role not allowed |
+| `VALIDATION` | 422 | Invalid `mobile` (`field: mobile`) |
+
+---
+
 ## GET /api/v1/my/appointments
 
 Role-aware paginated list of appointments. Returns only what the authenticated user is authorized to see.