hamed/clinicpro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
54c491c734b43664c25ffadcfa64c370a34fb622
clinicpro/.claude/prompt/multi-role-dashboard.md
T

22 KiB
Raw Blame History

پرامپت: داشبورد چند-نقشه (Multi-Role Dashboard)

هدف کلی

پنل /admin/ باید علاوه بر ادمین، برای نقش‌های زیر نیز کار کند — هر نقش فقط بخش‌هایی می‌بیند که به آن دسترسی دارد:

نقش نام فارسی ROLE در Symfony
ادمین سیستم مدیر کل ROLE_ADMIN
صاحب کلینیک مالک کلینیک ROLE_CLINIC
دکتر عضو کلینیک پزشک ROLE_DOCTOR
منشی منشی ROLE_SECRETARY

وضعیت فعلی API (مهم — قبل از پیاده‌سازی بخوان)

API های موجود (استفاده کن، تغییر نده)

Endpoint داکیومنت توضیح
GET /oauth/userinfo auth.md اطلاعات کاربر — باید primary_role و context به آن اضافه شود
GET /api/v1/admin/dashboard/stats admin.md KPI های داشبورد ادمین
GET /api/v1/admin/dashboard/charts admin.md نمودار ۳۰ روزه ادمین
GET /api/v1/admin/dashboard/recent admin.md آخرین فعالیت‌ها برای ادمین
GET /api/v1/admin/appointments admin.md لیست همه نوبت‌ها — فقط ROLE_ADMIN
GET /api/v1/appointments/doctor/{doctorUuid} appointment.md نوبت‌های یک دکتر خاص
GET /api/v1/appointments/user appointment.md نوبت‌های کاربر جاری
GET /api/v1/clinics/{uuid} clinic.md جزئیات کلینیک
GET /api/v1/admin/clinics admin.md لیست کلینیک‌ها — فقط ROLE_ADMIN

تغییر روی API موجود

Endpoint فایل توضیح
GET /oauth/userinfo src/Auth/Controller/AuthController.php اضافه کردن primary_role و context به پاسخ موجود

API های جدید که باید ساخته شوند

Endpoint فایل کنترلر توضیح
GET /api/v1/dashboard/clinic src/Dashboard/Controller/DashboardController.php داشبورد صاحب کلینیک
GET /api/v1/dashboard/doctor همان داشبورد دکتر
GET /api/v1/dashboard/secretary همان داشبورد منشی
GET /api/v1/my/appointments src/Appointment/Controller/MyAppointmentsController.php نوبت‌های فیلترشده بر اساس نقش

بعد از ساخت هر API جدید، فایل مستندات متناظر در docs/api/ را نیز به‌روز کن.

وضعیت فعلی کد (مهم — قبل از تغییر بخوان)

بک‌اند

  • کلاس AdminApiController با #[IsGranted('ROLE_ADMIN')] روی کل کلاس — تمام endpoint های داشبورد فعلی فقط برای ادمین
  • موجودیت‌ها:
    • User: فیلد roles: array — مقادیر ممکن: ROLE_USER, ROLE_ADMIN, ROLE_DOCTOR, ROLE_CLINIC, ROLE_SECRETARY
    • Clinic: فیلد user (ManyToOne به User) — صاحب کلینیک. رابطه ManyToMany با Doctor از طریق جدول clinic_doctors
    • Doctor: فیلد user (OneToOne به User). دارای mobileNumber و رابطه با Specialty. متد findByUser(User) در DoctorRepository موجود است.
    • DoctorSecretary: فیلد doctor (ManyToOne)، secretary (ManyToOne به User)، permissions (JSON): 
      { version:1, resources: {
    appointments: { view, create, cancel, update_status },
    addresses:    { view, create, update, delete },
    clinic_info:  { view, update },
    insurances:   { view, create, update, delete }
}}
  • ClinicRepository::findByUser(User $user) موجود است.
  • DoctorRepository::findByUser(User $user) موجود است.
  • JWT: از LexikJWTBundle — payload شامل: username (mobile_number)، roles (آرایه)، iat، exp

فرانت‌اند

  • authStore.ts (Zustand + persist در clinicpro-auth): فقط token، refreshToken، isAuthenticated
  • Sidebar.tsx: لیست ثابت — بدون هیچ فیلتر نقشی
  • App.tsx: همه routes با PrivateRoute (فقط isAuthenticated بررسی می‌شود)
  • DashboardPage.tsx: سه query به /api/v1/admin/dashboard/* + نمودار Recharts + mini lists

مرحله ۱ — گسترش /oauth/userinfo (بک‌اند)

فایل: src/Auth/Controller/AuthController.php

endpoint موجود /oauth/userinfo را گسترش بده — همان route، همان permission، فقط دو فیلد جدید به پاسخ اضافه می‌شود.

پاسخ فعلی:

{
  "success": true,
  "data": {
    "id": 4766,
    "uuid": "...",
    "mobile_number": "09...",
    "realName": "دکتر وحید درویشی",
    "status": 1,
    "roles": ["ROLE_USER", "ROLE_DOCTOR"]
  }
}

پاسخ بعد از تغییر (دو فیلد جدید اضافه):

{
  "success": true,
  "data": {
    "id": 4766,
    "uuid": "...",
    "mobile_number": "09...",
    "realName": "دکتر وحید درویشی",
    "status": 1,
    "roles": ["ROLE_USER", "ROLE_DOCTOR"],
    "primary_role": "doctor",
    "context": {
      "doctor_uuid": "...",
      "doctor_name": "دکتر وحید درویشی"
    }
  }
}

قانون primary_role (اولویت‌بندی):

  • ROLE_ADMIN → "admin"
  • ROLE_CLINIC → "clinic"
  • ROLE_DOCTOR → "doctor"
  • ROLE_SECRETARY → "secretary"
  • بقیه → "user"

پر کردن context:

  • ROLE_DOCTOR: از DoctorRepository::findByUser($user) → {doctor_uuid, doctor_name}
  • ROLE_CLINIC: از ClinicRepository::findByUser($user) → {clinic_uuid, clinic_name, clinic_logo}
  • ROLE_SECRETARY: از DoctorSecretaryRepository::findActiveBySecretary($user) (متد جدید) → {secretary_uuid, doctor_uuid, doctor_name, permissions}
  • اگر موجودیت پیدا نشد: context: null

متد جدید در DoctorSecretaryRepository:

public function findActiveBySecretary(User $user): ?DoctorSecretary
{
    return $this->findOneBy(['secretary' => $user, 'active' => true]);
}

داکیومنت: بعد از پیاده‌سازی، پاسخ /oauth/userinfo را در docs/api/auth.md به‌روز کن.

مرحله ۲ — به‌روز کردن authStore.ts (فرانت‌اند)

// assets/admin/stores/authStore.ts

interface AuthState {
  token: string | null;
  refreshToken: string | null;
  isAuthenticated: boolean;
  // فیلدهای جدید:
  userUuid: string | null;
  userName: string | null;
  primaryRole: 'admin' | 'clinic' | 'doctor' | 'secretary' | 'user' | null;
  context: Record<string, any> | null;
}
  • متد login(token, refreshToken): بعد از ذخیره token، یک GET /oauth/userinfo بزند و نتیجه را ذخیره کند
  • متد logout(): همه فیلدها را پاک کند
  • متد جدید fetchMe(): GET /oauth/userinfo و update store — در App.tsx هنگام mount فراخوانی شود (اگر token موجود بود اما primaryRole خالی بود، تا بعد از reload صفحه role بازیابی شود)

مرحله ۳ — محافظت route ها (فرانت‌اند)

در App.tsx، کامپوننت RoleRoute اضافه کن:

function RoleRoute({ roles, children }: { roles: string[]; children: ReactNode }) {
  const primaryRole = useAuthStore(s => s.primaryRole);
  if (!primaryRole) return <div style={{padding:40, textAlign:'center'}}>در حال بارگذاری...</div>;
  if (!roles.includes(primaryRole)) return <Navigate to="/admin/dashboard" replace />;
  return <>{children}</>;
}

Route های فقط ادمین (با <RoleRoute roles={['admin']}> بپوشان):

  • /admin/users, /admin/users/:uuid
  • /admin/payments
  • /admin/settlements
  • /admin/representations, /admin/representations/:uuid
  • /admin/comments
  • /admin/ratings
  • /admin/sms
  • /admin/categories
  • /admin/blogs, /admin/blogs/new, /admin/blogs/:uuid/edit
  • /admin/secretaries
  • /admin/clinics (لیست کل کلینیک‌ها)

Route های admin + clinic:

  • /admin/clinics/:uuid — ادمین همه را می‌بیند، clinic فقط کلینیک خودش را
  • /admin/doctors — ادمین همه، clinic فقط پزشکان کلینیکش

Route های مشترک همه نقش‌ها:

  • /admin/dashboard
  • /admin/appointments, /admin/appointments/:uuid

Route های جدید:

  • /admin/my-clinic → <MyClinicPage /> — فقط ROLE_CLINIC

مرحله ۴ — Sidebar پویا (فرانت‌اند)

فایل assets/admin/components/layout/Sidebar.tsx

ساختار sections را به یک تابع تبدیل کن که primaryRole و context می‌گیرد:

function buildSections(
  primaryRole: string | null,
  context: Record<string, any> | null
): Section[]

ادمین — همه لینک‌های فعلی (بدون تغییر)

صاحب کلینیک (clinic):

عمومی:
  • داشبورد         /admin/dashboard
  • کلینیک من       /admin/my-clinic
  • پزشکان          /admin/doctors

مدیریت:
  • نوبت‌ها          /admin/appointments

دکتر (doctor):

عمومی:
  • داشبورد         /admin/dashboard

مدیریت:
  • نوبت‌های من     /admin/appointments

منشی (secretary) — بر اساس context.permissions.resources:

عمومی:
  • داشبورد         /admin/dashboard

مدیریت (شرطی):
  • نوبت‌ها          /admin/appointments    ← اگر appointments.view = true

در Sidebar، permissions را از useAuthStore(s => s.context) بخوان.

مرحله ۵ — endpoint های داشبورد جدید (بک‌اند) — API های جدید

فایل جدید: src/Dashboard/Controller/DashboardController.php

سه endpoint جداگانه — هر سه از BaseController extend می‌کنند. پاسخ با $this->success($data) — یعنی فرانت با data?.data می‌خواند.

GET /api/v1/dashboard/clinic [ROLE_CLINIC]

پاسخ:

{
  "success": true,
  "data": {
    "clinic": { "uuid":"...", "name":"...", "is_active": true, "logo":"..." },
    "stats": {
      "total_doctors": 5,
      "today_appointments": 12,
      "this_month_appointments": 87,
      "pending_invitations": 2
    },
    "today_appointments": [
      { "uuid":"...", "patient_name":"...", "doctor_name":"...", "slot_start": 1234567890, "status":"reserved" }
    ],
    "doctors": [
      { "uuid":"...", "name":"دکتر ...", "specialty":"...", "today_count": 3 }
    ]
  }
}

پیاده‌سازی:

  • کلینیک را از ClinicRepository::findByUser($user) بگیر
  • اگر نبود: return $this->error('ERR_NOT_FOUND_001', 'کلینیک یافت نشد', 404)
  • today_appointments و this_month_appointments: از جدول appointments با JOIN به clinic_doctors فیلتر کن
  • pending_invitations: از clinic_doctor_invitations با status='pending' بشمار
  • today_appointments لیست: ۵ نوبت اخیر امروز این کلینیک (از طریق JOIN clinic_doctors)
  • doctors: لیست پزشکان کلینیک با شمارش نوبت امروز آن‌ها
  • از DQL array hydration استفاده کن (.getArrayResult())

GET /api/v1/dashboard/doctor [ROLE_DOCTOR]

پاسخ:

{
  "success": true,
  "data": {
    "doctor": { "uuid":"...", "name":"...", "degree":"..." },
    "stats": {
      "today_appointments": 5,
      "tomorrow_appointments": 3,
      "this_month_appointments": 42,
      "avg_rating": 4.7,
      "total_ratings": 18
    },
    "today_appointments": [
      { "uuid":"...", "patient_name":"...", "patient_mobile":"...", "slot_start": 1234567890, "status":"reserved" }
    ],
    "clinics": [
      { "uuid":"...", "name":"کلینیک ...", "logo":"..." }
    ]
  }
}

پیاده‌سازی:

  • دکتر از DoctorRepository::findByUser($user) — اگر نبود return $this->error(..., 404)
  • today_appointments: نوبت‌های این دکتر با slot_start در بازه ابتدا تا انتهای امروز
  • tomorrow_appointments: همان برای فردا
  • avg_rating: AVG(overall) از جدول ratings برای این دکتر — با DQL
  • clinics: کلینیک‌هایی که این دکتر در clinic_doctors آن‌هاست
  • از DQL array hydration استفاده کن

GET /api/v1/dashboard/secretary [ROLE_SECRETARY]

پاسخ:

{
  "success": true,
  "data": {
    "doctor": { "uuid":"...", "name":"...", "degree":"..." },
    "permissions": { "version": 1, "resources": { ... } },
    "stats": {
      "today_appointments": 4,
      "tomorrow_appointments": 2
    },
    "today_appointments": [
      { "uuid":"...", "patient_name":"...", "patient_mobile":"...", "slot_start": 1234567890, "status":"reserved" }
    ]
  }
}

پیاده‌سازی:

  • از DoctorSecretaryRepository::findActiveBySecretary($user) اولین رابطه فعال بگیر
  • اگر نبود: return $this->error('ERR_FORBIDDEN_001', 'دسترسی منشی تنظیم نشده', 403)
  • بررسی appointments.view = true در permissions — اگر false بود، today_appointments آرایه خالی برگردان
  • نوبت‌های دکتر مربوطه را برگردان

داکیومنت: بعد از پیاده‌سازی، فایل docs/api/dashboard.md جدید بساز.

مرحله ۶ — DashboardPage.tsx چند-نقشه (فرانت‌اند)

فایل assets/admin/pages/DashboardPage.tsx را به این شکل بازنویسی کن:

export default function DashboardPage() {
  const primaryRole = useAuthStore(s => s.primaryRole);

  if (!primaryRole) return <LoadingSkeleton />;
  if (primaryRole === 'admin')     return <AdminDashboard />;
  if (primaryRole === 'clinic')    return <ClinicDashboard />;
  if (primaryRole === 'doctor')    return <DoctorDashboard />;
  if (primaryRole === 'secretary') return <SecretaryDashboard />;
  return <div className="card card-pad"><p className="muted">نقش شما برای داشبورد تعریف نشده</p></div>;
}

AdminDashboard: کد فعلی DashboardPage عیناً — فقط در یک تابع بپیچ. از endpointهای موجود /api/v1/admin/dashboard/* استفاده می‌کند.

ClinicDashboard:

  • یک query به GET /api/v1/dashboard/clinic (جدید)
  • استخراج: data?.data (چون $this->success() یک‌بار nest می‌کند)
  • ۴ کارت KPI: تعداد پزشکان / نوبت امروز / نوبت این ماه / دعوتنامه در انتظار
  • جدول نوبت‌های امروز (ستون: بیمار، پزشک، زمان، وضعیت)
  • لیست پزشکان با تعداد نوبت امروز
  • دکمه "مدیریت کلینیک" → navigate به /admin/my-clinic

DoctorDashboard:

  • یک query به GET /api/v1/dashboard/doctor (جدید)
  • استخراج: data?.data
  • ۴ کارت KPI: نوبت امروز / فردا / این ماه / میانگین امتیاز (با ستاره)
  • جدول نوبت‌های امروز (ستون: بیمار، موبایل dir="ltr", زمان، وضعیت)
  • لیست کلینیک‌های عضو به شکل badge

SecretaryDashboard:

  • یک query به GET /api/v1/dashboard/secretary (جدید)
  • استخراج: data?.data
  • نام دکتر مربوطه در header کارت
  • ۲ کارت KPI: نوبت امروز / فردا
  • جدول نوبت‌های امروز
  • لیست مجوزهای فعال با آیکون ✓

مرحله ۷ — صفحه "کلینیک من" (فرانت‌اند)

فایل جدید: assets/admin/pages/MyClinicPage.tsx

export default function MyClinicPage() {
  const context = useAuthStore(s => s.context);
  const clinicUuid = context?.clinic_uuid;
  
  if (!clinicUuid) return (
    <div className="card card-pad">
      <p>کلینیک شما هنوز ثبت نشده است.</p>
    </div>
  );
  
  // از endpoint موجود GET /api/v1/clinics/{uuid} استفاده کن
  // همان محتوای ClinicDetailPage — اما uuid از context
  // دکمه "حذف کلینیک" نشان داده نشود
  // بقیه همه فعال: ویرایش، تغییر وضعیت، آپلود لوگو، گالری، دعوت پزشک
}

بهترین رویکرد: کد مشترک را از ClinicDetailPage.tsx در یک کامپوننت ClinicDetailView جدا کن که uuid و showDeleteButton را به عنوان prop می‌گیرد. هر دو صفحه از آن استفاده کنند.

GET /api/v1/clinics/{uuid} و PATCH /api/v1/clinic/{uuid} هر دو موجودند — نیازی به API جدید نیست.

مرحله ۸ — نوبت‌های فیلترشده (بک‌اند + فرانت‌اند) — API جدید

بک‌اند — endpoint جدید: GET /api/v1/my/appointments [IS_AUTHENTICATED_FULLY]

فایل جدید: src/Appointment/Controller/MyAppointmentsController.php

GET /api/v1/my/appointments?page=1&limit=15&status=...&search=...

بر اساس نقش فیلتر:

  • ROLE_ADMIN: forward به همان query موجود در AdminApiController::appointments()
  • ROLE_CLINIC: نوبت‌هایی که doctor آن در clinic_doctors این کلینیک است
  • ROLE_DOCTOR: نوبت‌های این دکتر — از DoctorRepository::findByUser($user) uuid بگیر
  • ROLE_SECRETARY: نوبت‌های دکتری که این منشی به آن وصل است (اگر appointments.view = true)

پاسخ: همان فرمت $this->paginated() موجود:

{
  "success": true,
  "data": [ { "uuid":"...", "doctor_name":"...", "patient_name":"...", "slot_start":..., "status":"..." } ],
  "meta": { "totalRecords": 100, "totalPages": 7, "currentPage": 1 }
}

داکیومنت: بعد از پیاده‌سازی، endpoint را به docs/api/appointment.md اضافه کن.

فرانت‌اند — AppointmentsPage.tsx

const primaryRole = useAuthStore(s => s.primaryRole);
const endpoint = primaryRole === 'admin'
  ? `/api/v1/admin/appointments`
  : `/api/v1/my/appointments`;

برای ادمین از endpoint موجود استفاده می‌شود؛ برای بقیه نقش‌ها از endpoint جدید.

نکات مهم پیاده‌سازی

CSS / UI — فقط template CSS

  • .card, .card-pad, .badge.green/.blue/.amber/.violet/.gray
  • .btn.primary/.ghost/.soft/.sm
  • .skeleton برای loading
  • .empty برای حالت خالی
  • گرادیان آواتار: HUES_LIST = [256, 205, 162, 295, 272] با OKLCH: background: \linear-gradient(145deg, oklch(0.62 0.15 ${hue}), oklch(0.48 0.16 ${hue}))``
  • هیچ Tailwind نیست

پاسخ‌های API

  • $this->success($data) → { success, data: $data } — فرانت با data?.data می‌خواند
  • $this->paginated($items, $total, $page, $limit) → { success, data: $items[], meta: {...} } — فرانت با data?.data و data?.meta?.totalRecords
  • $this->error(...) → { success:false, errors:[...] }

بک‌اند — قوانین کلی

  • همه Admin queries از DQL array hydration استفاده کنند (.getArrayResult())
  • Timestamps همه integer Unix هستند
  • نوبت‌های «امروز»: بازه strtotime('today midnight') تا strtotime('tomorrow midnight') - 1

ترتیب اجرا (پیشنهادی)

  1. DoctorSecretaryRepository::findActiveBySecretary() — متد جدید
  2. AuthController::userInfo() — گسترش برای primary_role + context، تست با curl
  3. authStore.ts — اضافه کردن fetchMe + فیلدهای جدید
  4. App.tsx — fetchMe در mount
  5. DashboardController — هر سه endpoint
  6. DashboardPage.tsx — sub-dashboardها
  7. Sidebar.tsx — پویا
  8. App.tsx — RoleRoute
  9. MyClinicPage.tsx
  10. MyAppointmentsController — بک‌اند
  11. AppointmentsPage.tsx — فیلتر endpoint
  12. بعد از هر مرحله بک‌اند: ddev exec php bin/console cache:clear
  13. بعد از هر مرحله فرانت‌اند: ddev exec yarn dev

خلاصه فایل‌های جدید/تغییریافته

بک‌اند (تغییر)

  • src/Auth/Controller/AuthController.php — گسترش userInfo(): اضافه کردن primary_role و context
  • src/Secretary/Repository/DoctorSecretaryRepository.php — اضافه: findActiveBySecretary()

بک‌اند (جدید)

  • src/Dashboard/Controller/DashboardController.php
  • src/Appointment/Controller/MyAppointmentsController.php

فرانت‌اند (تغییر)

  • assets/admin/stores/authStore.ts — اضافه: primaryRole، context، fetchMe()
  • assets/admin/App.tsx — اضافه: RoleRoute، fetchMe در mount، route های جدید
  • assets/admin/components/layout/Sidebar.tsx — تبدیل به پویا
  • assets/admin/pages/DashboardPage.tsx — multi-role
  • assets/admin/pages/AppointmentsPage.tsx — endpoint پویا

فرانت‌اند (جدید)

  • assets/admin/pages/MyClinicPage.tsx

داکیومنت (به‌روزرسانی/جدید)

  • docs/api/auth.md — اضافه: GET /api/v1/me
  • docs/api/appointment.md — اضافه: GET /api/v1/my/appointments
  • docs/api/dashboard.md — فایل جدید برای سه endpoint داشبورد
Reference in New Issue View Git Blame Copy Permalink