135 lines
5.3 KiB
Markdown
135 lines
5.3 KiB
Markdown
# تسک ۱۲: تکمیل منشی — محدودیت پنل + 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": "سقف تعداد منشی پنل اشتراکی شما رسیده است. برای افزودن منشی بیشتر پنل را ارتقاء دهید."
|
||
}]
|
||
}
|
||
```
|