feat: add TourProgressController and related entities for user tour progress tracking

- Implemented TourProgressController to handle API endpoints for tracking guided tours seen by users.
- Created UserTourProgress entity to store the highest version of tours seen by each user.
- Developed UserTourProgressRepository for database interactions related to user tour progress.
- Introduced TourProgressService to manage business logic for marking tours as seen and retrieving seen maps.
- Added comprehensive tests for API endpoints and entity behavior to ensure functionality and data integrity.

assets/admin/pages/AppointmentsPage.tsx

@@ -28,6 +28,8 @@ import { useUrlState } from '../hooks/useUrlState';
 import TurnsTimeline from '../components/appointments/TurnsTimeline';
 import TurnsTable from '../components/appointments/TurnsTable';
 import { usePermissions } from '../hooks/usePermissions';
+import { useTour } from '../hooks/useTour';
+import TourButton from '../components/ui/TourButton';
 import NewAppointmentModal from '../components/appointments/NewAppointmentModal';
 import type { BookingSlot } from '../components/appointments/NewAppointmentModal';
 import { useDoctorBookingServices } from '../hooks/useDoctorBookingServices';
@@ -68,7 +70,7 @@ function DateNavigator({ date, onChange }: { date: string; onChange: (d: string)
   }
 
   return (
-    <div ref={ref} style={{ display: 'flex', alignItems: 'center', gap: 2, position: 'relative' }}>
+    <div ref={ref} data-tour="appointments-date" style={{ display: 'flex', alignItems: 'center', gap: 2, position: 'relative' }}>
       <button className="btn sm" style={navBtnSx} onClick={() => addDays(1)}>
         <ChevronRightIcon style={{ width: 15, height: 15 }} />
       </button>
@@ -417,14 +419,23 @@ export default function AppointmentsPage() {
     navigate(`/admin/appointments/${a.uuid}`);
   }
 
+  // تور بار اول فقط وقتی راه می‌افتد که نوبت‌ها آمده باشند؛ قبل از آن نیمی از
+  // المان‌های هدف هنوز روی صفحه نیستند.
+  useTour('appointments', { ready: !apptQuery.isLoading });
+
   return (
     <div style={{ padding: '20px 24px' }}>
       <div style={{ maxWidth: 1050, margin: '0 auto' }}>
         {/* عنوان */}
-        <h1 style={{ fontSize: 20, fontWeight: 700, color: 'var(--text)', marginBottom: 16 }}>نوبت‌ ها</h1>
+        <div style={{ display: 'flex', alignItems: 'center', gap: 4, marginBottom: 16 }}>
+          <h1 style={{ fontSize: 20, fontWeight: 700, color: 'var(--text)' }}>نوبت‌ ها</h1>
+          <TourButton tourId="appointments" />
+        </div>
 
         {/* نوار آمار */}
-        <TurnsStatInfo stats={stats} />
+        <div data-tour="appointments-stats">
+          <TurnsStatInfo stats={stats} />
+        </div>
 
         {/* نوار ابزار (بیرونِ کارت، مطابق طرح) */}
         <div style={{
@@ -454,13 +465,16 @@ export default function AppointmentsPage() {
             </div>
           )}
 
-          <TurnsViewToggle viewMode={viewMode} onChange={setViewMode} />
+          <div data-tour="appointments-view" style={{ display: 'flex' }}>
+            <TurnsViewToggle viewMode={viewMode} onChange={setViewMode} />
+          </div>
 
           <div style={{ flex: 1 }} />
 
           {/* سمت چپ: فیلتر + افزودن نوبت */}
           <button
             aria-label="فیلترها"
+            data-tour="appointments-filters"
             className="btn sm"
             onClick={() => setFiltersOpen(true)}
             style={{
@@ -476,6 +490,7 @@ export default function AppointmentsPage() {
           {!isRepresentation && canCreateAppt && (
             <button
               className="btn primary sm"
+              data-tour="appointments-new"
               onClick={() => {
                 // تب منبع فعال است ⇒ نوبت برای همان منبع، با سرویس‌های خودش.
                 if (activeResource) { setBookingResource(activeResource); return; }
@@ -491,21 +506,23 @@ export default function AppointmentsPage() {
         </div>
 
         {/* کارت اصلی — تب دکترها (هدر) + محتوا */}
-        <div style={{
+        <div data-tour="appointments-list" style={{
           background: 'var(--surface)', border: '1px solid var(--border)',
           borderRadius: 'var(--r)', overflow: 'hidden',
         }}>
           {showDoctorTabs && (
-            <DoctorTabs
-              doctors={doctors.map(d => ({
-                uuid: d.uuid,
-                name: d.name,
-                note: d.hasSchedule ? undefined : 'بدون ساعت کاری',
-              }))}
-              selected={selectedDoctorUuid}
-              onSelect={selectDoctor}
-              showAll={isAdmin}
-            />
+            <div data-tour="appointments-doctors">
+              <DoctorTabs
+                doctors={doctors.map(d => ({
+                  uuid: d.uuid,
+                  name: d.name,
+                  note: d.hasSchedule ? undefined : 'بدون ساعت کاری',
+                }))}
+                selected={selectedDoctorUuid}
+                onSelect={selectDoctor}
+                showAll={isAdmin}
+              />
+            </div>
           )}
 
           {/* منابعِ همین پزشک، نه همهٔ منابع: ارتباط پزشک↔منبع روی خودِ منبع تعریف شده
@@ -735,7 +752,7 @@ function ServiceFilterSelect({ value, options, onChange }: {
   value: string; options: { uuid: string; name: string }[]; onChange: (v: string) => void;
 }) {
   return (
-    <div style={{ minWidth: 280 }}>
+    <div data-tour="appointments-service" style={{ minWidth: 280 }}>
       <SearchableSelect
         options={options.map(s => ({ value: s.uuid, label: s.name }))}
         value={value || null}