feat(representation): add endpoints for doctor statistics and toggling doctor status

2026-06-24 12:24:53 +03:30
parent 8b419d0272
commit b7df8cf9ee
3 changed files with 113 additions and 4 deletions
@@ -398,6 +398,48 @@ Get yearly earnings dashboard for a representation.

 ---

+### GET `/api/v1/representation/doctors/stats`
+
+آمار پزشکانِ ثبت‌شده توسط نماینده‌ی جاری (فقط `representation_id = نماینده‌ی کاربر جاری`). شکل پاسخ سازگار با `GET /api/v1/admin/doctors/stats` (بدون `top_specialty`). فرانت‌اند کارت‌های «کل پزشکان / فعال / غیرفعال / مرد / زن» را از این endpoint برای نقش نماینده پر می‌کند.
+
+> **Permission:** `ROLE_REPRESENTATION` — id نماینده از `#[CurrentUser]`.
+
+#### Response `200`
+```json
+{
+  "success": true,
+  "data": { "total": 12, "active": 9, "inactive": 3, "male": 7, "female": 5 }
+}
+```
+#### Errors
+| Code | HTTP | Description |
+|------|------|-------------|
+| `ERR_NOT_FOUND_001` | 404 | کاربر جاری نماینده نیست |
+
+---
+
+### POST `/api/v1/representation/doctors/{uuid}/status`
+
+فعال/غیرفعال کردن پزشکِ زیرمجموعه‌ی نماینده‌ی جاری (toggle `active_doctor_appointment`). فقط روی پزشکانی که `representation_id` آن‌ها برابر نماینده‌ی کاربر جاری است؛ در غیر این صورت 404.
+
+> **Permission:** `ROLE_REPRESENTATION` — مالکیت از `#[CurrentUser]` چک می‌شود.
+
+#### Path Parameters
+| Param | Type | Description |
+|-------|------|-------------|
+| `uuid` | string | uuid پزشک |
+
+#### Response `200`
+```json
+{ "success": true, "data": { "is_active": false } }
+```
+#### Errors
+| Code | HTTP | Description |
+|------|------|-------------|
+| `ERR_NOT_FOUND_001` | 404 | کاربر جاری نماینده نیست، یا پزشک یافت نشد / متعلق به این نماینده نیست |
+
+---
+
 ### GET `/api/v1/representation/clinics`

 کلینیک‌های ثبت‌شده توسط نماینده‌ی جاری (فقط `representation_id = نماینده‌ی کاربر جاری`). شکل آیتم سازگار با `GET /api/v1/admin/clinics`.