feat: implement realistic data seeding for doctors, clinics, and secretaries

- Added seed_realistic_data.php to clean existing data and populate the database with realistic entries for doctors, clinics, and secretaries.
- Created a structured approach to generate 100 doctors per city with diverse specialties and services.
- Implemented database cleanup routines to ensure a fresh start for data seeding.
- Enhanced the DoctorSecretaryRepository with improved comments for clarity.

docs/phase2_taskes/task-12-secretary-completion/task.md

@@ -1,7 +1,9 @@
 # تسک ۱۲: تکمیل منشی — محدودیت پنل + UI Permissions
 
 ## توضیح
+
 Entity `DoctorSecretary` و API کامل موجود است (`src/Secretary/`). این تسک فقط دو چیز اضافه می‌کند:
+
 1. Backend: بررسی سقف تعداد منشی بر اساس پنل اشتراکی
 2. Frontend: Modal با checkbox matrix برای ویرایش permissions
 
@@ -9,30 +11,33 @@ Entity `DoctorSecretary` و API کامل موجود است (`src/Secretary/`).
 
 ## فایل‌های موجود که تغییر می‌کنند
 
-| فایل | تغییر |
-|------|-------|
+| فایل                                               | تغییر                                                              |
+| -------------------------------------------------- | ------------------------------------------------------------------ |
 | `src/Secretary/Controller/SecretaryController.php` | inject `SubscriptionService`، اضافه کردن limit check در `create()` |
-| `assets/admin/pages/SecretariesPage.tsx` | Modal ویرایش با checkbox matrix برای permissions |
+| `assets/admin/pages/SecretariesPage.tsx`           | Modal ویرایش با checkbox matrix برای permissions                   |
 
 ## API موجود (بدون تغییر)
 
-| متد | مسیر | توضیح |
-|-----|------|-------|
-| GET | `/api/v1/secretaries/{doctorUuid}` | لیست منشیان |
-| POST | `/api/v1/secretary` | ایجاد منشی ← **اینجا limit check اضافه می‌شود** |
-| PATCH | `/api/v1/secretary/{uuid}` | ویرایش ← **permissions هم قابل ویرایش می‌شود** |
-| DELETE | `/api/v1/secretary/{uuid}` | غیرفعال‌سازی (soft delete) |
+| متد    | مسیر                               | توضیح                                           |
+| ------ | ---------------------------------- | ----------------------------------------------- |
+| GET    | `/api/v1/secretaries/{doctorUuid}` | لیست منشی ها                                    |
+| POST   | `/api/v1/secretary`                | ایجاد منشی ← **اینجا limit check اضافه می‌شود** |
+| PATCH  | `/api/v1/secretary/{uuid}`         | ویرایش ← **permissions هم قابل ویرایش می‌شود**  |
+| DELETE | `/api/v1/secretary/{uuid}`         | غیرفعال‌سازی (soft delete)                      |
 
 ## پیش‌نیازها
+
 - تسک ۱۴ (Secretary — موجود در کد)
 - **تسک ۱۱** (Subscription — `SubscriptionService` باید موجود باشد)
 
 ## زمان تخمینی
+
 ۴ تا ۵ ساعت
 
 ## تغییر Backend — SecretaryController::create()
 
 ### وضعیت فعلی (قبل):
+
 ```php
 public function create(Request $request): JsonResponse
 {
@@ -44,6 +49,7 @@ public function create(Request $request): JsonResponse
 ```
 
 ### وضعیت جدید (بعد):
+
 ```php
 public function create(Request $request): JsonResponse
 {
@@ -68,6 +74,7 @@ public function create(Request $request): JsonResponse
 ```
 
 ### خطای جدید که باید در ErrorCodes.php اضافه شود:
+
 ```php
 // src/Shared/Constant/ErrorCodes.php
 const ERR_SECRETARY_LIMIT_REACHED = 'ERR_SECRETARY_LIMIT_REACHED';
@@ -77,6 +84,7 @@ const ERR_SECRETARY_LIMIT_REACHED = 'ERR_SECRETARY_LIMIT_REACHED';
 ## تغییر Frontend — SecretariesPage.tsx
 
 ### ساختار DEFAULT_PERMISSIONS (از DoctorSecretary::DEFAULT_PERMISSIONS):
+
 ```php
 [
     'version'   => 1,
@@ -90,6 +98,7 @@ const ERR_SECRETARY_LIMIT_REACHED = 'ERR_SECRETARY_LIMIT_REACHED';
 ```
 
 ### نمونه UI Permissions checkbox matrix در Modal:
+
 ```
 ┌─────────────────────────────────────────────────────┐
 │  دسترسی‌های منشی                                    │
@@ -104,31 +113,45 @@ const ERR_SECRETARY_LIMIT_REACHED = 'ERR_SECRETARY_LIMIT_REACHED';
 ```
 
 ### PATCH /api/v1/secretary/{uuid} با permissions:
+
 ```json
 {
-  "permissions": {
-    "version": 1,
-    "resources": {
-      "appointments": { "view": true, "create": true, "cancel": true, "update_status": true },
-      "addresses": { "view": true, "create": false, "update": false, "delete": false }
+    "permissions": {
+        "version": 1,
+        "resources": {
+            "appointments": {
+                "view": true,
+                "create": true,
+                "cancel": true,
+                "update_status": true
+            },
+            "addresses": {
+                "view": true,
+                "create": false,
+                "update": false,
+                "delete": false
+            }
+        }
     }
-  }
 }
 ```
 
 ## کدهای خطای جدید
 
-| کد | پیام فارسی |
-|----|-----------|
+| کد                            | پیام فارسی                               |
+| ----------------------------- | ---------------------------------------- |
 | `ERR_SECRETARY_LIMIT_REACHED` | سقف تعداد منشی پنل اشتراکی شما رسیده است |
 
 ## Response خطا (403)
+
 ```json
 {
-  "success": false,
-  "errors": [{
-    "code": "ERR_SECRETARY_LIMIT_REACHED",
-    "message": "سقف تعداد منشی پنل اشتراکی شما رسیده است. برای افزودن منشی بیشتر پنل را ارتقاء دهید."
-  }]
+    "success": false,
+    "errors": [
+        {
+            "code": "ERR_SECRETARY_LIMIT_REACHED",
+            "message": "سقف تعداد منشی پنل اشتراکی شما رسیده است. برای افزودن منشی بیشتر پنل را ارتقاء دهید."
+        }
+    ]
 }
 ```

docs/phase2_taskes/task-12-secretary-completion/user_flow.md

@@ -64,7 +64,7 @@ Professional → 5   → 403
 ## نکته: منشی غیرفعال از سقف کم نمی‌شود
 
 ```
-countActive() فقط منشیان active=true را می‌شمارد
+countActive() فقط منشی ها active=true را می‌شمارد
 یعنی: اگر 2 منشی داری و یکی را غیرفعال کنی → می‌توانی دوباره 1 منشی جدید اضافه کنی
 (مادامی که در پنل Basic هستی و سقف 2 داری)
 ```