feat: add clinic role support to doctor profile access and update API endpoint for clinic owners

2026-06-13 18:10:44 +03:30
parent 5c2e9fae3f
commit c1c57df4ff
5 changed files with 253 additions and 21 deletions
@@ -0,0 +1,147 @@
+# دسترسی صاحب کلینیک به پروفایل پزشکان عضو کلینیک
+
+## زمینه
+
+وقتی صاحب کلینیک (`ROLE_CLINIC`) در صفحه کلینیک روی آیکون چشم کنار نام یک پزشک کلیک می‌کند، به جای مشاهده پروفایل پزشک، به داشبورد redirect می‌شود. دلیل: route `doctors/:uuid` در `App.tsx` فقط `['admin', 'doctor']` را قبول دارد و `RoleRoute` صاحب کلینیک را به `/admin/dashboard` می‌فرستد.
+
+## مشکل
+
+دو لایه مشکل وجود دارد:
+
+**۱. Frontend — Route permission:**
+```tsx
+// assets/admin/App.tsx — خط 141
+<Route path="doctors/:uuid" element={<RoleRoute roles={['admin', 'doctor']}><DoctorDetailPage /></RoleRoute>} />
+```
+`RoleRoute` فقط `primaryRole` را چک می‌کند — اگر `clinic` بود، redirect به dashboard می‌کند.
+
+**۲. Backend — API permission:**
+```php
+// src/Doctor/Controller/DoctorController.php — خط 140-141
+#[Route('/api/v1/doctor/{uuid}', methods: ['GET'])]
+public function show(string $uuid): JsonResponse  // بدون IsGranted — PUBLIC است
+```
+`GET /api/v1/doctor/{uuid}` عمومی است، اما برای اطمینان از امنیت باید یک endpoint اختصاصی برای کلینیک وجود داشته باشد که تأیید کند پزشک واقعاً عضو کلینیک مربوطه است.
+
+## فایل‌های مرتبط
+
+| فایل | نقش |
+|------|-----|
+| `assets/admin/App.tsx` | تعریف route و RoleRoute — جای اصلی مشکل frontend |
+| `assets/admin/pages/DoctorDetailPage.tsx` | صفحه پروفایل پزشک |
+| `src/Doctor/Controller/DoctorController.php` | `GET /api/v1/doctor/{uuid}` |
+| `src/Clinic/Repository/ClinicRepository.php` | دارای `findByDoctor()` و `findByUser()` |
+
+## وضعیت فعلی
+
+```tsx
+// App.tsx خط 141
+<Route path="doctors/:uuid" element={<RoleRoute roles={['admin', 'doctor']}><DoctorDetailPage /></RoleRoute>} />
+
+// RoleRoute خط 70-74
+function RoleRoute({ roles, children }: { roles: string[]; children: React.ReactNode }) {
+  const primaryRole = useAuthStore((s) => s.primaryRole);
+  if (!primaryRole) return <div>در حال بارگذاری...</div>;
+  if (!roles.includes(primaryRole)) return <Navigate to="/admin/dashboard" replace />;
+  return <>{children}</>;
+}
+```
+
+```php
+// DoctorController.php خط 140-163 — PUBLIC, no auth check
+#[Route('/api/v1/doctor/{uuid}', methods: ['GET'])]
+public function show(string $uuid): JsonResponse
+{
+    $doctor = $this->doctorRepo->findByUuid($uuid);
+    if ($doctor === null) {
+        return $this->error(ErrorCodes::ERR_VALIDATION_002, 'دکتر یافت نشد', 404);
+    }
+    // ... بدون چک مالکیت یا عضویت در کلینیک
+    return $this->success(['data' => array_merge($doctor->toDetailArray(), ['clinics' => $clinicData])]);
+}
+```
+
+## وظایف
+
+### ۱. Frontend — اضافه کردن `clinic` به RoleRoute مسیر پزشک
+
+```tsx
+// App.tsx — خط 141 را تغییر بده
+<Route
+  path="doctors/:uuid"
+  element={<RoleRoute roles={['admin', 'doctor', 'clinic']}><DoctorDetailPage /></RoleRoute>}
+/>
+```
+
+### ۲. Backend — endpoint اختصاصی برای کلینیک
+
+یک endpoint جدید در `DoctorController` اضافه کن که صاحب کلینیک بتواند پروفایل پزشکان عضو کلینیکش را ببیند، با تأیید عضویت:
+
+```php
+// src/Doctor/Controller/DoctorController.php
+#[Route('/api/v1/clinic/my-doctor/{doctorUuid}', methods: ['GET'])]
+#[IsGranted('ROLE_CLINIC')]
+public function showForClinic(string $doctorUuid, #[CurrentUser] User $user): JsonResponse
+{
+    $clinic = $this->clinicRepo->findByUser($user);
+    if ($clinic === null) {
+        return $this->error(ErrorCodes::ERR_NOT_FOUND_001, 'کلینیک یافت نشد', 404);
+    }
+
+    $doctor = $this->doctorRepo->findByUuid($doctorUuid);
+    if ($doctor === null) {
+        return $this->error(ErrorCodes::ERR_NOT_FOUND_001, 'پزشک یافت نشد', 404);
+    }
+
+    // فقط پزشکانی که عضو این کلینیک هستند قابل مشاهده‌اند
+    if (!$clinic->getDoctors()->contains($doctor)) {
+        return $this->error(ErrorCodes::ERR_AUTH_006, 'این پزشک عضو کلینیک شما نیست', 403);
+    }
+
+    $clinicData = [[
+        'id'        => (string) $clinic->getId(),
+        'uuid'      => $clinic->getUuid(),
+        'name'      => $clinic->getName(),
+        'address'   => $clinic->getAddress(),
+        'telephone' => $clinic->getTelephone(),
+    ]];
+
+    return $this->success(['data' => array_merge($doctor->toDetailArray(), ['clinics' => $clinicData])]);
+}
+```
+
+**وابستگی‌های constructor**: `ClinicRepository $clinicRepo` باید به `DoctorController` اضافه شود (بررسی کن آیا از قبل موجود است).
+
+### ۳. Frontend — DoctorDetailPage: fetch با endpoint مناسب
+
+در `DoctorDetailPage.tsx`، وقتی `primaryRole === 'clinic'`، از endpoint جدید استفاده کن:
+
+```tsx
+// در DoctorDetailPage.tsx — در useQuery که doctor را fetch می‌کند
+const { data: doctorData } = useQuery({
+  queryKey: ['doctor', uuid, primaryRole],
+  queryFn: () =>
+    primaryRole === 'clinic'
+      ? api.get(`/api/v1/clinic/my-doctor/${uuid}`)
+      : api.get(`/api/v1/doctor/${uuid}`),
+  enabled: !!uuid,
+});
+```
+
+### ۴. Frontend — DoctorDetailPage: محدود کردن قابلیت‌های ویرایش برای clinic
+
+وقتی `primaryRole === 'clinic'`:
+- دکمه ویرایش پروفایل نمایش داده **نشود** (فقط مشاهده)
+- دکمه حذف نمایش داده **نشود**
+- بخش دعوتنامه‌ها (`ClinicInvitationsSection`) نمایش داده **نشود**
+
+بررسی کن چه بخش‌هایی با `isOwnProfile` یا `primaryRole === 'admin'` guard شده‌اند و `clinic` را به عنوان read-only viewer handle کن.
+
+## نکات مهم
+
+- `ClinicRepository::findByUser(User $user)` وجود دارد — از آن برای پیدا کردن کلینیک صاحب استفاده کن
+- `Clinic::getDoctors()` یک `Collection` است — از `->contains($doctor)` برای چک عضویت استفاده کن
+- `GET /api/v1/doctor/{uuid}` را تغییر نده — این endpoint عمومی است و frontend برای admin/doctor از آن استفاده می‌کند
+- migration لازم نیست — هیچ entity تغییر نمی‌کند
+- بعد از تغییر route باید `ddev exec php bin/console cache:clear` اجرا شود
+- مستندات: `docs/api/doctor.md` را با endpoint جدید به‌روزرسانی کن