feat(treatment): skip reasons and reopening for session areas

Skipping an area recorded only that it was skipped. Why it was skipped is
clinical history — the next session needs to read it — so `skip` now takes an
optional note, the same way completing an area already did, and the panel asks
for it inline instead of firing on the first click.

An operator finds out mid-laser that they closed the wrong area, and until now
had to carry that mistake to the end of the session. `reopen` puts a settled
area — completed or skipped — back to in_progress and clears finished_at,
keeping the recorded parameters and note so they can be seen and overwritten.
It stops at the same boundary everything else in this domain stops at: once the
session is finished the record is history, and reopening it is 409.

Also drops /admin/my-services. The staff role has one job — today's sessions —
and the dashboard already lists the services they may perform, so the page was
a second place to read the same list. Route, page, sidebar entry and the two
links to it are gone; the services stat card is no longer a link because it no
longer has a destination.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

assets/admin/App.tsx

@@ -59,7 +59,6 @@ import MyFinancialPage from './pages/MyFinancialPage';
 import ClinicFormPage from './pages/ClinicFormPage';
 import PreRegistrationsPage from './pages/PreRegistrationsPage';
 import StaffPage from './pages/StaffPage';
-import StaffMyServicesPage from './pages/StaffMyServicesPage';
 import StaffTreatmentSessionsPage from './pages/StaffTreatmentSessionsPage';
 import StaffSessionDetailPage from './pages/StaffSessionDetailPage';
 import TreatmentCasesPage from './pages/TreatmentCasesPage';
@@ -285,7 +284,6 @@ export default function App() {
         {/* فاز ۲ — دکتر / کلینیک */}
         <Route path="staff" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['staff', 'view']}><StaffPage /></RoleRoute>} />
         {/* پرسنل: تنها صفحهٔ دادهٔ این نقش، کنار داشبورد */}
-        <Route path="my-services" element={<RoleRoute roles={['staff']}><StaffMyServicesPage /></RoleRoute>} />
         <Route path="my-sessions" element={<RoleRoute roles={['staff']}><StaffTreatmentSessionsPage /></RoleRoute>} />
         <Route path="my-sessions/:uuid" element={<RoleRoute roles={['staff']}><StaffSessionDetailPage /></RoleRoute>} />
         <Route path="settings-menu" element={<RoleRoute roles={['doctor', 'clinic']} blockClinicScope><SettingsMenuPage /></RoleRoute>} />

assets/admin/components/layout/Sidebar.tsx

@@ -559,11 +559,6 @@ function buildSections(
                         icon: ClipboardDocumentListIcon,
                         label: "جلسات امروز من",
                     },
-                    {
-                        to: "/admin/my-services",
-                        icon: WrenchScrewdriverIcon,
-                        label: "سرویس‌های من",
-                    },
                 ],
             },
         ];

assets/admin/components/layout/SidebarStaff.test.tsx

@@ -30,13 +30,16 @@ describe("Sidebar — نقش پرسنل", () => {
             },
         } as any);
 
-    it("shows only داشبورد and سرویس‌های من", () => {
+    it("shows only داشبورد and جلسات امروز من", () => {
         asStaff();
         renderWithProviders(<Sidebar />, { route: "/admin/dashboard" });
 
         expect(screen.getByText("داشبورد").closest("a")).toHaveAttribute("href", "/admin/dashboard");
-        expect(screen.getByText("سرویس‌های من").closest("a")).toHaveAttribute("href", "/admin/my-services");
+        expect(screen.getByText("جلسات امروز من").closest("a")).toHaveAttribute("href", "/admin/my-sessions");
         expect(screen.getByText("پرسنل")).toBeInTheDocument(); // برچسب نقش در فوتر
+
+        // صفحهٔ «سرویس‌های من» حذف شد؛ فهرست سرویس‌ها روی خودِ داشبورد است.
+        expect(screen.queryByText("سرویس‌های من")).not.toBeInTheDocument();
     });
 
     it("hides management entries", () => {

assets/admin/pages/DashboardPage.test.tsx

@@ -220,14 +220,14 @@ describe('داشبورد پرسنل', () => {
     expect(screen.getByText('محمد رستمی')).toBeInTheDocument();
   });
 
-  it('کارت‌های آمار به صفحهٔ کار خودشان لینک‌اند', async () => {
+  it('کارت جلسات لینک است و کارت سرویس‌ها نیست', async () => {
     renderWithProviders(<DashboardPage />);
 
     const sessions = (await screen.findByText('جلسات امروز من')).closest('a');
     expect(sessions).toHaveAttribute('href', '/admin/my-sessions');
 
-    const services = screen.getByText('سرویس‌های من').closest('a');
-    expect(services).toHaveAttribute('href', '/admin/my-services');
+    // صفحهٔ «سرویس‌های من» حذف شد؛ کارتِ بدون مقصد نباید لینک باشد.
+    expect(screen.getByText('سرویس‌های من').closest('a')).toBeNull();
   });
 
   it('هر ردیف کار به همان جلسه می‌رود', async () => {

assets/admin/pages/DashboardPage.tsx

@@ -1016,7 +1016,7 @@ function StaffDashboard() {
       icon: CalendarDaysIcon, color: 'var(--warning)', bg: 'var(--warning-bg)',
     },
     {
-      to: '/admin/my-services',
+      to: null,
       label: 'سرویس‌های من',
       value: formatNumber(d.stats?.services ?? 0),
       hint: 'سرویس‌هایی که مجاز به انجامشان هستید',
@@ -1045,16 +1045,24 @@ function StaffDashboard() {
       </div>
 
       <div className="stat-grid">
-        {kpiCards.map(c => (
-          <Link key={c.label} to={c.to} className="stat" style={{ display: 'block', color: 'inherit', textDecoration: 'none' }}>
-            <div className="ico" style={{ background: c.bg, color: c.color }}>
-              <c.icon style={{ width: 21, height: 21 }} />
-            </div>
-            <div className="lbl">{c.label}</div>
-            <div className="val">{c.value}</div>
-            <div className="hint">{c.hint}</div>
-          </Link>
-        ))}
+        {kpiCards.map(c => {
+          const body = (
+            <>
+              <div className="ico" style={{ background: c.bg, color: c.color }}>
+                <c.icon style={{ width: 21, height: 21 }} />
+              </div>
+              <div className="lbl">{c.label}</div>
+              <div className="val">{c.value}</div>
+              <div className="hint">{c.hint}</div>
+            </>
+          );
+
+          // فقط کارتی لینک می‌شود که صفحه‌ای پشتش باشد؛ سرویس‌ها صفحهٔ جدا ندارند و
+          // همین‌جا پایین‌تر فهرست می‌شوند.
+          return c.to === null
+            ? <div key={c.label} className="stat">{body}</div>
+            : <Link key={c.label} to={c.to} className="stat" style={{ display: 'block', color: 'inherit', textDecoration: 'none' }}>{body}</Link>;
+        })}
       </div>
 
       <div className="card card-pad" style={{ marginTop: 'var(--gap)' }}>
@@ -1102,7 +1110,6 @@ function StaffDashboard() {
       <div className="card card-pad" style={{ marginTop: 'var(--gap)' }}>
         <div className="card-title-row">
           <h3 style={{ fontSize: 16 }}>سرویس‌های تخصیص‌یافته</h3>
-          <Link to="/admin/my-services" className="link">همه سرویس‌ها</Link>
         </div>
         {d.services.length === 0 ? (
           <p className="muted" style={{ fontSize: 13.5, padding: '1.5rem 0', textAlign: 'center' }}>

assets/admin/pages/StaffMyServicesPage.tsx

@@ -1,79 +0,0 @@
-import { useQuery } from '@tanstack/react-query';
-import { WrenchScrewdriverIcon } from '@heroicons/react/24/outline';
-import { api } from '../lib/api';
-import type { ApiResponse } from '../lib/api';
-import type { StaffAssignedService } from '../types';
-import { formatRial } from '../lib/utils';
-import DataTable, { type Column } from '../components/ui/DataTable';
-import PageHeader from '../components/ui/PageHeader';
-
-interface StaffDashboardData {
-  services: StaffAssignedService[];
-}
-
-const EMPTY: StaffAssignedService[] = [];
-
-/**
- * سرویس‌های تخصیص‌یافته به پرسنل — فقط خواندنی.
- * داده از همان اندپوینت داشبورد پرسنل می‌آید؛ نقش staff اندپوینت دیگری ندارد.
- */
-export default function StaffMyServicesPage() {
-  const { data, isLoading } = useQuery({
-    queryKey: ['dashboard-staff'],
-    queryFn: () => api.get<ApiResponse<StaffDashboardData>>('/api/v1/dashboard/staff'),
-    staleTime: 60_000,
-  });
-
-  const services = data?.data?.services ?? EMPTY;
-
-  const columns: Column<StaffAssignedService>[] = [
-    {
-      key: 'name',
-      header: 'سرویس',
-      render: (s) => (
-        <div>
-          <div style={{ fontWeight: 600, fontSize: 14 }}>{s.name}</div>
-          <div style={{ fontSize: 12, color: 'var(--text-3)', marginTop: 2 }}>{s.section_name}</div>
-        </div>
-      ),
-    },
-    {
-      key: 'price_rials',
-      header: 'تعرفه',
-      render: (s) => <span style={{ fontSize: 13 }}>{formatRial(s.price_rials)}</span>,
-    },
-    {
-      key: 'duration_minutes',
-      header: 'مدت',
-      render: (s) => (
-        <span style={{ fontSize: 13, color: 'var(--text-3)' }}>
-          {s.duration_minutes ? `${s.duration_minutes} دقیقه` : '—'}
-        </span>
-      ),
-    },
-  ];
-
-  return (
-    <>
-      <PageHeader
-        title="سرویس‌های من"
-        description="سرویس‌هایی که به شما تخصیص داده شده است"
-        backTo="/admin/dashboard"
-      />
-
-      <div className="card">
-        {services.length === 0 && !isLoading ? (
-          <div style={{ textAlign: 'center', padding: '60px 24px', color: 'var(--text-3)' }}>
-            <WrenchScrewdriverIcon style={{ width: 48, margin: '0 auto 16px', display: 'block', opacity: 0.4 }} />
-            <div style={{ fontWeight: 600, fontSize: 15, marginBottom: 8, color: 'var(--text-2)' }}>
-              هنوز سرویسی به شما تخصیص نیافته
-            </div>
-            <div style={{ fontSize: 13 }}>پس از تخصیص سرویس توسط مطب/کلینیک، اینجا نمایش داده می‌شود.</div>
-          </div>
-        ) : (
-          <DataTable columns={columns} data={services} loading={isLoading} />
-        )}
-      </div>
-    </>
-  );
-}

assets/admin/pages/StaffSessionDetailPage.tsx

@@ -7,6 +7,7 @@ import PageHeader from '../components/ui/PageHeader';
 import StatusBadge from '../components/ui/StatusBadge';
 import SearchableSelect from '../components/ui/SearchableSelect';
 import { formatDate, formatNumber } from '../lib/utils';
+import { ArrowUturnRightIcon } from '@heroicons/react/24/outline';
 import { useElapsed } from '../hooks/useElapsed';
 import type { SessionAreaRecord, StaffSessionDetail, TreatmentDevice, TreatmentFormField } from '../types';
 
@@ -59,11 +60,21 @@ export default function StaffSessionDetailPage() {
   });
 
   const skipArea = useMutation({
-    mutationFn: (areaUuid: string) => api.post<ApiResponse<unknown>>(`${BASE}/session-area/${areaUuid}/skip`, {}),
+    mutationFn: (payload: { areaUuid: string; note: string }) =>
+      api.post<ApiResponse<unknown>>(`${BASE}/session-area/${payload.areaUuid}/skip`, {
+        note: payload.note || undefined,
+      }),
     onSuccess: () => { toast.success('این ناحیه صرف‌نظر شد'); refresh(); },
     onError: (e) => fail(e, 'صرف‌نظر از ناحیه ناموفق بود'),
   });
 
+  // اشتباهِ حین کار: ناحیه‌ای که زودتر بسته شده تا وقتی جلسه باز است برمی‌گردد.
+  const reopenArea = useMutation({
+    mutationFn: (areaUuid: string) => api.post<ApiResponse<unknown>>(`${BASE}/session-area/${areaUuid}/reopen`, {}),
+    onSuccess: () => { toast.success('ناحیه دوباره باز شد'); refresh(); },
+    onError: (e) => fail(e, 'باز کردن ناحیه ناموفق بود'),
+  });
+
   const completeArea = useMutation({
     mutationFn: (payload: { areaUuid: string; body: Record<string, unknown> }) =>
       api.post<ApiResponse<unknown>>(`${BASE}/session-area/${payload.areaUuid}/complete`, payload.body),
@@ -140,9 +151,11 @@ export default function StaffSessionDetailPage() {
             devices={session.devices}
             forms={session.forms}
             disabled={finished}
-            onSkip={() => skipArea.mutate(area.uuid)}
+            onSkip={(note) => skipArea.mutate({ areaUuid: area.uuid, note })}
+            onReopen={() => reopenArea.mutate(area.uuid)}
             onComplete={(body) => completeArea.mutate({ areaUuid: area.uuid, body })}
             saving={completeArea.isPending}
+            reopening={reopenArea.isPending}
           />
         ))}
       </div>
@@ -177,14 +190,16 @@ export default function StaffSessionDetailPage() {
   );
 }
 
-function AreaCard({ area, devices, forms, disabled, onSkip, onComplete, saving }: {
+function AreaCard({ area, devices, forms, disabled, onSkip, onReopen, onComplete, saving, reopening }: {
   area: SessionAreaRecord;
   devices: TreatmentDevice[];
   forms: Record<string, TreatmentFormField[]>;
   disabled: boolean;
-  onSkip: () => void;
+  onSkip: (note: string) => void;
+  onReopen: () => void;
   onComplete: (body: Record<string, unknown>) => void;
   saving: boolean;
+  reopening: boolean;
 }) {
   const [open, setOpen]         = useState(false);
   const [values, setValues]     = useState<Record<string, string>>({});
@@ -192,6 +207,8 @@ function AreaCard({ area, devices, forms, disabled, onSkip, onComplete, saving }
   // دستگاه از نوبت به ارث می‌رسد و همان می‌ماند. این فلگ فقط برای موردِ نادرِ
   // «نوبت روی دستگاه اشتباه ثبت شده» است، نه بخشی از جریان عادی.
   const [changingDevice, setChangingDevice] = useState(false);
+  const [skipping, setSkipping] = useState(false);
+  const [skipNote, setSkipNote] = useState('');
   const [resourceUuid, setResourceUuid] = useState<string | null>(area.resource?.uuid ?? null);
   const fields   = resourceUuid ? forms[resourceUuid] ?? [] : [];
   const settled  = area.status === 'completed' || area.status === 'skipped';
@@ -241,17 +258,51 @@ function AreaCard({ area, devices, forms, disabled, onSkip, onComplete, saving }
         <span style={{ fontSize: 12.5, color: 'var(--text-2)' }}>یادداشت: {area.note}</span>
       )}
 
-      {!settled && !disabled && !open && (
+      {/* ناحیهٔ بسته‌شده تا وقتی جلسه باز است برمی‌گردد: اپراتور وسط لیزر می‌فهمد
+          اشتباه زده و نباید تا پایان جلسه با آن بماند. */}
+      {settled && !disabled && (
+        <div style={{ display: 'flex', gap: 8 }}>
+          <button type="button" className="btn secondary sm" onClick={onReopen} disabled={reopening}>
+            <ArrowUturnRightIcon style={{ width: 14, height: 14 }} />
+            {reopening ? 'در حال بازکردن…' : 'بازکردن دوباره'}
+          </button>
+        </div>
+      )}
+
+      {!settled && !disabled && !open && !skipping && (
         <div style={{ display: 'flex', gap: 8 }}>
           <button type="button" className="btn primary sm" onClick={() => setOpen(true)}>
             ثبت اطلاعات این ناحیه
           </button>
-          <button type="button" className="btn secondary sm" onClick={onSkip}>
+          <button type="button" className="btn secondary sm" onClick={() => setSkipping(true)}>
             صرف‌نظر از این ناحیه
           </button>
         </div>
       )}
 
+      {/* «چرا انجام نشد» بخشی از سابقهٔ درمان است؛ جلسهٔ بعد باید بتوان خواندش. */}
+      {!settled && !disabled && skipping && (
+        <div className="field-block">
+          <label htmlFor={`skip-${area.uuid}`}>دلیل صرف‌نظر <span className="opt">(اختیاری)</span></label>
+          <textarea
+            id={`skip-${area.uuid}`}
+            className="cp-textarea"
+            value={skipNote}
+            onChange={(e) => setSkipNote(e.target.value)}
+            rows={2}
+            placeholder="مثال: پوست این ناحیه تحریک بود"
+          />
+          <div style={{ display: 'flex', gap: 8, marginTop: 8 }}>
+            <button type="button" className="btn secondary sm" onClick={() => onSkip(skipNote.trim())}>
+              ثبت صرف‌نظر
+            </button>
+            <button type="button" className="btn ghost sm" onClick={() => { setSkipping(false); setSkipNote(''); }}>
+              انصراف
+            </button>
+          </div>
+        </div>
+      )}
+
       {!settled && open && (
         <div style={{ display: 'grid', gap: 10 }}>
           {/* دستگاه هنگام ثبت نوبت انتخاب شده و روی رکورد ناحیه نشسته است؛ پرسیدن