Implement SMS panel user flow and patient records system; add wallet charging, automatic reminders, and patient session management with detailed database schema and user flows.

2026-06-14 21:15:40 +03:30
parent a72a6da621
commit b58aacc37f
28 changed files with 3169 additions and 0 deletions
@@ -0,0 +1,134 @@
+# تسک ۱۲: تکمیل منشی — محدودیت پنل + UI Permissions
+
+## توضیح
+Entity `DoctorSecretary` و API کامل موجود است (`src/Secretary/`). این تسک فقط دو چیز اضافه می‌کند:
+1. Backend: بررسی سقف تعداد منشی بر اساس پنل اشتراکی
+2. Frontend: Modal با checkbox matrix برای ویرایش permissions
+
+**هیچ endpoint جدیدی ایجاد نمی‌شود.**
+
+## فایل‌های موجود که تغییر می‌کنند
+
+| فایل | تغییر |
+|------|-------|
+| `src/Secretary/Controller/SecretaryController.php` | inject `SubscriptionService`، اضافه کردن limit check در `create()` |
+| `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) |
+
+## پیش‌نیازها
+- تسک ۱۴ (Secretary — موجود در کد)
+- **تسک ۱۱** (Subscription — `SubscriptionService` باید موجود باشد)
+
+## زمان تخمینی
+۴ تا ۵ ساعت
+
+## تغییر Backend — SecretaryController::create()
+
+### وضعیت فعلی (قبل):
+```php
+public function create(Request $request): JsonResponse
+{
+    // validate fields
+    // create DoctorSecretary
+    // persist
+    return $this->success($secretary->toArray());
+}
+```
+
+### وضعیت جدید (بعد):
+```php
+public function create(Request $request): JsonResponse
+{
+    // 1. پیدا کردن دکتر از doctorUuid در body
+    $doctor = $this->doctorRepo->findByUuid($request->get('doctor_uuid'));
+
+    // 2. بررسی سقف پنل
+    $entityType = 'doctor';
+    $entityId   = $doctor->getId();
+    $limit   = $this->subscriptionService->getSecretaryLimit($entityType, $entityId);
+    $current = $this->secretaryRepo->countActive($doctor->getId());
+    if ($current >= $limit) {
+        return $this->error(
+            ErrorCodes::ERR_SECRETARY_LIMIT_REACHED,
+            'سقف تعداد منشی پنل اشتراکی شما رسیده است',
+            Response::HTTP_FORBIDDEN
+        );
+    }
+
+    // 3. ادامه ایجاد منشی ...
+}
+```
+
+### خطای جدید که باید در ErrorCodes.php اضافه شود:
+```php
+// src/Shared/Constant/ErrorCodes.php
+const ERR_SECRETARY_LIMIT_REACHED = 'ERR_SECRETARY_LIMIT_REACHED';
+// messages: 'سقف تعداد منشی پنل اشتراکی شما رسیده است'
+```
+
+## تغییر Frontend — SecretariesPage.tsx
+
+### ساختار DEFAULT_PERMISSIONS (از DoctorSecretary::DEFAULT_PERMISSIONS):
+```php
+[
+    'version'   => 1,
+    'resources' => [
+        'appointments' => ['view' => true,  'create' => true,  'cancel' => false, 'update_status' => true],
+        'addresses'    => ['view' => true,  'create' => false, 'update' => false, 'delete' => false],
+        'clinic_info'  => ['view' => true,  'update' => false],
+        'insurances'   => ['view' => true,  'create' => false, 'update' => false, 'delete' => false],
+    ],
+]
+```
+
+### نمونه UI Permissions checkbox matrix در Modal:
+```
+┌─────────────────────────────────────────────────────┐
+│  دسترسی‌های منشی                                    │
+├──────────────┬───────┬────────┬────────┬────────────┤
+│ بخش          │ مشاهده│ ایجاد  │ ویرایش │ حذف/لغو   │
+├──────────────┼───────┼────────┼────────┼────────────┤
+│ نوبت‌ها      │  ☑    │  ☑    │  ☑    │  ☐         │
+│ آدرس‌ها      │  ☑    │  ☐    │  ☐    │  ☐         │
+│ اطلاعات کلینیک│ ☑    │  -    │  ☐    │  -         │
+│ بیمه‌ها      │  ☑    │  ☐    │  ☐    │  ☐         │
+└──────────────┴───────┴────────┴────────┴────────────┘
+```
+
+### 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 }
+    }
+  }
+}
+```
+
+## کدهای خطای جدید
+
+| کد | پیام فارسی |
+|----|-----------|
+| `ERR_SECRETARY_LIMIT_REACHED` | سقف تعداد منشی پنل اشتراکی شما رسیده است |
+
+## Response خطا (403)
+```json
+{
+  "success": false,
+  "errors": [{
+    "code": "ERR_SECRETARY_LIMIT_REACHED",
+    "message": "سقف تعداد منشی پنل اشتراکی شما رسیده است. برای افزودن منشی بیشتر پنل را ارتقاء دهید."
+  }]
+}
+```