feat: add doctor profile page with sidebar integration and routing

2026-06-11 19:06:59 +03:30
parent 704075770b
commit 277922d4ae
7 changed files with 347 additions and 76 deletions
@@ -0,0 +1,202 @@
+# صفحه پروفایل پزشک (Doctor Profile Page)
+
+## هدف
+
+پزشک باید صفحه‌ای داشته باشد که بتواند تمام اطلاعات مربوط به خودش را مشاهده و ویرایش کند — دقیقاً مشابه `/admin/doctors/{uuid}` که ادمین می‌بیند، اما:
+- به صورت خودکار UUID پزشک لاگین‌شده از `authStore.dbUuid` خوانده می‌شود
+- آدرس صفحه: `/admin/profile`
+- در سایدبار دکتر یک آیتم "پروفایل من" اضافه می‌شود
+
+---
+
+## وضعیت فعلی (چه داریم)
+
+### صفحه موجود
+- `DoctorDetailPage.tsx` در مسیر `/admin/doctors/:uuid` برای **ادمین + دکتر** قابل دسترسی است
+- صفحه کامل است و شامل: اطلاعات پروفایل، آدرس مطب، تنظیمات نوبت‌دهی، تعطیلات، تاریخ‌های خاص
+- دکتر با UUID خودش می‌تواند این صفحه را ببیند اما **لینکی در منوی دکتر وجود ندارد**
+
+### سایدبار دکتر (فعلی)
+```
+عمومی:
+  - داشبورد
+
+مدیریت:
+  - نوبت‌های من
+```
+
+### Auth Store
+- `authStore.dbUuid` = UUID دکتر لاگین‌شده
+- `authStore.primaryRole` = 'doctor'
+
+---
+
+## API‌های موجود (بررسی‌شده)
+
+| Endpoint | وضعیت | کاربرد |
+|----------|-------|---------|
+| `GET /api/v1/doctor/{uuid}` | ✅ PUBLIC | خواندن پروفایل (double-nested: `data?.data?.data`) |
+| `PATCH /api/v1/doctor/{uuid}` | ✅ AUTH | ویرایش پروفایل |
+| `POST /api/v1/clinic-pro/doctor-address` | ✅ AUTH | افزودن آدرس مطب |
+| `PATCH /api/v1/clinic-pro/doctor-address/{id}` | ✅ AUTH | ویرایش آدرس |
+| `DELETE /api/v1/clinic-pro/doctor-address/{id}` | ✅ AUTH | حذف آدرس |
+| `GET /api/v1/clinic-pro/doctor-addresses/{doctorId}` | ✅ AUTH | لیست آدرس‌ها |
+| `GET /api/v1/appointment-settings/weekly-schedule/{doctorUuid}` | ✅ AUTH | برنامه هفتگی |
+| `POST /api/v1/appointment-settings/weekly-schedule` | ✅ AUTH | ساخت برنامه هفتگی |
+| `PATCH /api/v1/appointment-settings/weekly-schedule/{uuid}` | ✅ AUTH | ویرایش برنامه هفتگی |
+| `GET /api/v1/appointment-settings/date-override/list/{doctorUuid}` | ✅ AUTH | تاریخ‌های خاص |
+| `GET /api/v1/appointment-settings/holidays/list/{doctorUuid}` | ✅ AUTH | تعطیلات |
+| `GET /api/v1/my/appointments/today-stats?date=...` | ✅ AUTH | آمار نوبت‌ها |
+
+---
+
+## قابلیت‌هایی که باید ساخته شود
+
+### قابلیت ۱ — Route + Sidebar
+
+**فایل‌ها:**
+- `assets/admin/App.tsx` — افزودن route `/admin/profile`
+- `assets/admin/components/layout/Sidebar.tsx` — افزودن "پروفایل من" به منوی دکتر
+
+**Route:**
+```tsx
+<Route path="profile" element={<DoctorProfilePage />} />
+```
+
+**Sidebar (doctor):**
+```
+عمومی:
+  - داشبورد
+
+پروفایل:
+  - پروفایل من    ← /admin/profile
+
+مدیریت:
+  - نوبت‌های من
+  - تنظیمات نوبت‌دهی  ← /admin/appointment-settings (اختیاری)
+```
+
+---
+
+### قابلیت ۲ — `DoctorProfilePage.tsx`
+
+**ساختار صفحه** (با tab برای سازماندهی):
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│  [عکس]  دکتر [نام]           ویرایش پروفایل                  │
+│         [تخصص] [درجه]                                        │
+└──────────────────────────────────────────────────────────────┘
+
+[ اطلاعات عمومی ] [ آدرس مطب ] [ تنظیمات نوبت‌دهی ]
+                    ↑ تب‌ها
+
+──── محتوای هر تب ────
+```
+
+**تب ۱ — اطلاعات عمومی** (ویرایش inline):
+- نام کامل
+- جنسیت (مرد/زن)
+- درجه علمی (عمومی / متخصص / فوق‌تخصص / فلوشیپ)
+- کد نظام پزشکی
+- تخصص‌ها (multi-select از `GET /api/v1/categorys/specially_doctor`)
+- سرویس‌ها (multi-select از `GET /api/v1/categorys/doctor_services` یا `GET /api/v1/doctor-services`)
+- بیوگرافی (textarea)
+- بارگذاری عکس پروفایل
+
+فرم: React Hook Form + Zod
+Submit: `PATCH /api/v1/doctor/{uuid}`
+
+**تب ۲ — آدرس مطب** (CRUD):
+- لیست آدرس‌ها با نام + آدرس + تلفن
+- دکمه "افزودن آدرس" → Modal با فرم:
+  - نام مطب
+  - آدرس
+  - تلفن
+  - استان + شهر (از category API)
+  - نقشه (Leaflet — اختیاری اگر پیچیده باشد)
+- ویرایش + حذف هر آدرس
+
+**تب ۳ — تنظیمات نوبت‌دهی** (مشابه آنچه در DoctorDetailPage وجود دارد):
+- برنامه هفتگی (weekly schedule) — مشاهده + ویرایش
+- تعطیلات (holidays) — لیست + افزودن + حذف
+- تاریخ‌های خاص (date overrides) — لیست + مدیریت
+
+---
+
+## نکات پیاده‌سازی
+
+### گرفتن UUID دکتر
+```tsx
+const uuid = useAuthStore(s => s.dbUuid);
+```
+
+### Double-nested response برای GET doctor
+```tsx
+// پاسخ: { success: true, data: { data: { uuid, name, ... } } }
+const doctor = data?.data?.data;
+```
+
+### استفاده مجدد از DoctorDetailPage
+اگر `DoctorDetailPage.tsx` قابل reuse است:
+- می‌توان یک wrapper ساده ساخت که فقط `uuid` را از `authStore.dbUuid` می‌گیرد و پاس می‌دهد
+- اما اگر رفتار صفحه برای ادمین و دکتر تفاوت دارد (مثلاً ادمین می‌تواند دکتر را غیرفعال کند ولی دکتر نمی‌تواند) باید برخی بخش‌ها را با `isAdmin` شرطی کرد
+
+### بخش‌هایی که فقط ادمین می‌بیند (باید پنهان شوند):
+- دکمه "غیرفعال کردن حساب دکتر"
+- دکمه "حذف دکتر"
+- لیست کلینیک‌هایی که دکتر عضو است (فقط نمایش — بدون حذف از کلینیک)
+
+### بخش‌هایی که دکتر اضافه می‌بیند (اختیاری):
+- آمار خلاصه نوبت‌های امروز (از `GET /api/v1/my/appointments/today-stats`)
+
+---
+
+## فایل‌های تأثیرپذیر
+
+| فایل | تغییر |
+|------|-------|
+| `assets/admin/pages/DoctorProfilePage.tsx` | **جدید** — صفحه پروفایل پزشک |
+| `assets/admin/App.tsx` | افزودن route `/admin/profile` |
+| `assets/admin/components/layout/Sidebar.tsx` | افزودن "پروفایل من" به منوی دکتر |
+| `assets/admin/pages/DoctorDetailPage.tsx` | اختیاری — اگر نیاز به تغییر رفتار ادمین/دکتر |
+
+---
+
+## رویکرد پیشنهادی
+
+**ساده‌ترین راه** (بدون duplicate کد):
+
+1. در `App.tsx` route جدید:
+```tsx
+<Route path="profile" element={<Navigate to={`/admin/doctors/${dbUuid}`} replace />} />
+```
+
+اما این روش نیاز به دسترسی به `dbUuid` در سطح App دارد.
+
+**روش بهتر:**
+```tsx
+// DoctorProfilePage.tsx — wrapper
+export default function DoctorProfilePage() {
+  const dbUuid = useAuthStore(s => s.dbUuid);
+  if (!dbUuid) return <div>در حال بارگذاری...</div>;
+  return <DoctorDetailPage overrideUuid={dbUuid} isOwnProfile={true} />;
+}
+```
+
+و در `DoctorDetailPage.tsx` یک prop `isOwnProfile` اضافه کن که:
+- دکمه‌های ادمین‌-only را پنهان کند
+- عنوان صفحه را تغییر دهد ("پروفایل من" به جای "جزئیات پزشک")
+
+**یا ساده‌تر:** فقط لینک sidebar را به `/admin/doctors/{dbUuid}` تنظیم کن و DoctorDetailPage را بدون تغییر reuse کن — چون دکتر از طریق `RoleRoute roles={['admin', 'doctor']}` به آن صفحه دسترسی دارد.
+
+---
+
+## الزامات
+
+1. وقتی دکتر وارد پنل می‌شود، از سایدبار به "پروفایل من" دسترسی داشته باشد
+2. پروفایل خودش را ببیند و ویرایش کند (نه پروفایل دکتر دیگری)
+3. تنظیمات نوبت‌دهی‌اش را مدیریت کند
+4. آدرس مطب‌هایش را مدیریت کند
+5. دکمه‌های ادمین‌-only (حذف/غیرفعال کردن) نمایش داده نشوند
+6. همه تاریخ‌ها شمسی نمایش داده شوند