feat: Enhance appointment management by decoupling online booking toggle for admin context

- Introduced management mode for appointment slots, allowing doctors, admins, and clinic managers to view and book slots regardless of the online booking status.
- Updated SlotCalculatorService to accept a management context parameter, bypassing online booking restrictions.
- Modified appointment-related endpoints to handle management context and ensure proper authorization checks.
- Added tests to verify that management users can access slots even when online booking is disabled, while public users are still restricted.
- Improved documentation for API endpoints to reflect new management parameters and behaviors.

assets/admin/components/layout/Sidebar.tsx

@@ -50,6 +50,16 @@ const APPOINTMENTS_CHILDREN: SubItem[] = [
     { to: "/admin/appointments/new", label: "افزودن نوبت", icon: PlusIcon },
 ];
 
+/**
+ * همان زیرمنوها + «رزرو نوبت». برای نقش‌هایی که مالک برنامهٔ نوبت‌دهی‌اند
+ * (ادمین/کلینیک/پزشک) تا همهٔ عملیات نوبت زیر یک بخش جمع شود. پزشکِ مهمانِ کلینیک
+ * از نسخهٔ بدون رزرو (`APPOINTMENTS_CHILDREN`) استفاده می‌کند.
+ */
+const APPOINTMENTS_CHILDREN_WITH_RESERVE: SubItem[] = [
+    ...APPOINTMENTS_CHILDREN,
+    { to: "/admin/appointments/reserve", label: "رزرو نوبت", icon: ArchiveBoxIcon },
+];
+
 function buildSections(
     primaryRole: string | null,
     dbUuid: string | null,
@@ -117,12 +127,7 @@ function buildSections(
                         to: "/admin/appointments",
                         icon: CalendarDaysIcon,
                         label: "نوبت‌ها",
-                        children: APPOINTMENTS_CHILDREN,
-                    },
-                    {
-                        to: "/admin/appointments/reserve",
-                        icon: CalendarDaysIcon,
-                        label: "نوبت‌های رزرو",
+                        children: APPOINTMENTS_CHILDREN_WITH_RESERVE,
                     },
                     {
                         to: "/admin/payments",
@@ -232,12 +237,7 @@ function buildSections(
                         to: "/admin/appointments",
                         icon: CalendarDaysIcon,
                         label: "نوبت‌ها",
-                        children: APPOINTMENTS_CHILDREN,
-                    },
-                    {
-                        to: "/admin/appointments/reserve",
-                        icon: CalendarDaysIcon,
-                        label: "نوبت‌های رزرو",
+                        children: APPOINTMENTS_CHILDREN_WITH_RESERVE,
                     },
                     {
                         to: "/admin/patients",
@@ -377,12 +377,7 @@ function buildSections(
                         to: "/admin/appointments",
                         icon: CalendarDaysIcon,
                         label: "نوبت‌ها",
-                        children: APPOINTMENTS_CHILDREN,
-                    },
-                    {
-                        to: "/admin/appointments/reserve",
-                        icon: CalendarDaysIcon,
-                        label: "نوبت‌های رزرو",
+                        children: APPOINTMENTS_CHILDREN_WITH_RESERVE,
                     },
                     {
                         to: "/admin/patients",