feat(patients): phase D — call-center tab (patient call log)

Add a record-scoped PatientCall entity (subject, summary, outcome
success/missed, called_at, personnel) with its repository and three
owner-gated endpoints on PatientController:

  GET    /patient/{uuid}/calls   — call log, newest first, optional ?outcome
  POST   /patient/{uuid}/call    — log a call (subject required)
  DELETE /patient/call/{uuid}    — delete an entry

Wire the previously-placeholder "کال سنتر" tab as a CallCenterTab: a register
form (date/time/subject/summary + success/missed toggle, personnel taken from
the logged-in user) beside a filterable call history (all / success / missed).
With this every patient-detail tab is now backed by a real endpoint, so the
generic Placeholder is no longer reachable. PatientCallTest covers create/list/
delete, the outcome filter, the invalid-outcome fallback, and ownership scoping.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

assets/admin/pages/PatientDetailPage.test.tsx

@@ -59,11 +59,14 @@ describe('PatientDetailPage (پرونده تب‌دار)', () => {
     expect(screen.getByText('اینستاگرام')).toBeInTheDocument();
   });
 
-  it('shows a placeholder for not-yet-built tabs', async () => {
+  it('renders the call-center tab with a register form and history', async () => {
     renderDetail();
     await screen.findByText('ساغر صابری');
     fireEvent.click(screen.getByText('کال سنتر'));
-    expect(screen.getByText(/به‌زودی تکمیل می‌شود/)).toBeInTheDocument();
+    expect(await screen.findByText('ثبت تماس جدید')).toBeInTheDocument();
+    expect(screen.getByText('تاریخچه تماس‌ها')).toBeInTheDocument();
+    expect(screen.getByPlaceholderText('موضوع تماس')).toBeInTheDocument();
+    expect(await screen.findByText('تماسی ثبت نشده است.')).toBeInTheDocument();
   });
 
   it('renders the attachments tab with an upload button', async () => {

assets/admin/pages/PatientDetailPage.tsx

@@ -146,6 +146,8 @@ export default function PatientDetailPage() {
           row={(p) => ({ title: formatRial(p.amount_rials), meta: [p.created_at ? formatDate(p.created_at) : '', p.gateway].filter(Boolean).join(' · '), badge: PAYMENT_STATUS[p.status] || p.status })} />
       ) : tab === 'wallet' ? (
         <WalletTab uuid={uuid!} />
+      ) : tab === 'callcenter' ? (
+        <CallCenterTab uuid={uuid!} />
       ) : tab === 'attach' ? (
         <AttachmentsTab uuid={uuid!} />
       ) : tab === 'records' ? (
@@ -403,6 +405,116 @@ function MessagesTab({ uuid }: { uuid: string }) {
   );
 }
 
+interface Call { uuid: string; subject: string; summary?: string | null; outcome: string; called_at: number; personnel?: string | null }
+
+/** کال سنتر — patient call log: register a call + filterable history (all / success / missed). */
+function CallCenterTab({ uuid }: { uuid: string }) {
+  const qc = useQueryClient();
+  const userName = useAuthStore((s) => s.userName);
+  const [filter, setFilter] = useState<'all' | 'success' | 'missed'>('all');
+  const [date, setDate] = useState('');
+  const [time, setTime] = useState('');
+  const [subject, setSubject] = useState('');
+  const [summary, setSummary] = useState('');
+  const [outcome, setOutcome] = useState<'success' | 'missed'>('success');
+
+  const { data, isLoading } = useQuery<ApiResponse<Call[]>>({
+    queryKey: ['patient-calls', uuid],
+    queryFn: () => api.get(`/api/v1/patient/${uuid}/calls`),
+  });
+  const calls = data?.data ?? [];
+  const shown = filter === 'all' ? calls : calls.filter((c) => c.outcome === filter);
+  const successCount = calls.filter((c) => c.outcome === 'success').length;
+  const missedCount = calls.filter((c) => c.outcome === 'missed').length;
+  const invalidate = () => qc.invalidateQueries({ queryKey: ['patient-calls', uuid] });
+
+  const create = useMutation({
+    mutationFn: () => {
+      const iso = date ? `${date}T${time || '00:00'}` : null;
+      const calledAt = iso ? Math.floor(new Date(iso).getTime() / 1000) : Math.floor(Date.now() / 1000);
+      return api.post(`/api/v1/patient/${uuid}/call`, { subject, summary, outcome, called_at: calledAt, personnel: userName });
+    },
+    onSuccess: () => { invalidate(); setDate(''); setTime(''); setSubject(''); setSummary(''); setOutcome('success'); toast.success('تماس ثبت شد'); },
+    onError: (e: any) => toast.error(e.message),
+  });
+  const del = useMutation({
+    mutationFn: (u: string) => api.delete(`/api/v1/patient/call/${u}`),
+    onSuccess: () => { invalidate(); toast.success('تماس حذف شد'); },
+    onError: (e: any) => toast.error(e.message),
+  });
+
+  const chip = (key: 'all' | 'success' | 'missed', label: string) => (
+    <button onClick={() => setFilter(key)} style={{
+      padding: '6px 14px', borderRadius: 'var(--r-sm)', border: '1px solid var(--border)', cursor: 'pointer',
+      fontFamily: 'inherit', fontSize: 13, fontWeight: filter === key ? 700 : 500,
+      background: filter === key ? 'var(--primary-soft)' : 'var(--surface)',
+      color: filter === key ? 'var(--primary)' : 'var(--text-2)',
+    }}>{label}</button>
+  );
+
+  return (
+    <div style={{ display: 'flex', gap: 20, alignItems: 'flex-start', flexWrap: 'wrap' }}>
+      {/* register form */}
+      <div style={{ width: 320, background: 'var(--surface)', border: '1px solid var(--border)', borderRadius: 'var(--r-lg)', padding: 18 }}>
+        <div style={{ fontSize: 14, fontWeight: 700, textAlign: 'center', marginBottom: 16 }}>ثبت تماس جدید</div>
+        <label style={{ fontSize: 12.5, color: 'var(--text-3)' }}>تاریخ تماس</label>
+        <div style={{ margin: '6px 0 12px' }}><PersianDateInput value={date} onChange={setDate} /></div>
+        <label style={{ fontSize: 12.5, color: 'var(--text-3)' }}>ساعت تماس</label>
+        <div className="field" style={{ margin: '6px 0 12px' }}><input type="time" value={time} onChange={(e) => setTime(e.target.value)} dir="ltr" /></div>
+        <label style={{ fontSize: 12.5, color: 'var(--text-3)' }}>موضوع تماس</label>
+        <div className="field" style={{ margin: '6px 0 12px' }}><input value={subject} onChange={(e) => setSubject(e.target.value)} placeholder="موضوع تماس" /></div>
+        <label style={{ fontSize: 12.5, color: 'var(--text-3)' }}>خلاصه تماس</label>
+        <div className="field" style={{ height: 'auto', margin: '6px 0 12px' }}><textarea value={summary} onChange={(e) => setSummary(e.target.value)} rows={3} placeholder="خلاصه تماس" style={{ width: '100%', border: 'none', background: 'transparent', fontFamily: 'inherit', resize: 'vertical' }} /></div>
+        <div style={{ display: 'flex', gap: 8, marginBottom: 14 }}>
+          <button onClick={() => setOutcome('success')} style={{ flex: 1, padding: '8px', borderRadius: 'var(--r-sm)', border: '1px solid var(--border)', cursor: 'pointer', fontFamily: 'inherit', fontSize: 13, background: outcome === 'success' ? 'var(--success-bg)' : 'var(--surface)', color: outcome === 'success' ? 'var(--success)' : 'var(--text-2)', fontWeight: outcome === 'success' ? 700 : 500 }}>موفق</button>
+          <button onClick={() => setOutcome('missed')} style={{ flex: 1, padding: '8px', borderRadius: 'var(--r-sm)', border: '1px solid var(--border)', cursor: 'pointer', fontFamily: 'inherit', fontSize: 13, background: outcome === 'missed' ? 'var(--danger-bg)' : 'var(--surface)', color: outcome === 'missed' ? 'var(--danger)' : 'var(--text-2)', fontWeight: outcome === 'missed' ? 700 : 500 }}>بی‌پاسخ</button>
+        </div>
+        <button className="btn primary" style={{ width: '100%' }} disabled={!subject.trim() || create.isPending} onClick={() => create.mutate()}><PlusIcon style={{ width: 16 }} /> ثبت تماس</button>
+      </div>
+
+      {/* history */}
+      <div style={{ flex: 1, minWidth: 320 }}>
+        <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 14, flexWrap: 'wrap', gap: 8 }}>
+          <div style={{ display: 'flex', gap: 6 }}>
+            {chip('all', 'همه')}
+            {chip('success', `تماس‌های موفق (${successCount})`)}
+            {chip('missed', `بی‌پاسخ (${missedCount})`)}
+          </div>
+          <div style={{ fontSize: 14, fontWeight: 700 }}>تاریخچه تماس‌ها</div>
+        </div>
+
+        {isLoading ? (
+          <div style={{ padding: 16, color: 'var(--text-3)', fontSize: 13 }}>در حال بارگذاری...</div>
+        ) : shown.length === 0 ? (
+          <div style={{ padding: '40px 0', textAlign: 'center', color: 'var(--text-3)', fontSize: 14 }}>تماسی ثبت نشده است.</div>
+        ) : (
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
+            {shown.map((c) => {
+              const ok = c.outcome === 'success';
+              return (
+                <div key={c.uuid} style={{ background: 'var(--surface)', border: '1px solid var(--border)', borderInlineStart: `4px solid ${ok ? 'var(--success)' : 'var(--danger)'}`, borderRadius: 'var(--r-lg)', padding: '14px 16px', display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', gap: 10 }}>
+                  <div style={{ flex: 1 }}>
+                    <div style={{ display: 'flex', alignItems: 'center', gap: 6 }}>
+                      <PhoneArrowUpRightIcon style={{ width: 16, color: ok ? 'var(--success)' : 'var(--danger)' }} />
+                      <span style={{ fontSize: 13.5, fontWeight: 700 }}>{c.subject}</span>
+                    </div>
+                    {c.summary && <div style={{ fontSize: 12.5, color: 'var(--text-2)', marginTop: 4 }}>{c.summary}</div>}
+                  </div>
+                  <div style={{ textAlign: 'end', minWidth: 120 }}>
+                    <div style={{ fontSize: 12, color: 'var(--text-3)' }}>{formatDate(c.called_at)}</div>
+                    {c.personnel && <div style={{ fontSize: 12, color: 'var(--text-2)', marginTop: 2 }}>{c.personnel}</div>}
+                    <button className="btn sm ghost" aria-label="حذف" style={{ color: 'var(--danger)', marginTop: 4 }} onClick={() => del.mutate(c.uuid)}><TrashIcon style={{ width: 14 }} /></button>
+                  </div>
+                </div>
+              );
+            })}
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+
 interface WalletTxn { uuid: string; amount_rials: number; type: string; description?: string | null; balance_after: number; created_at: number }
 
 /** کیف پول — patient wallet balance card + recent-transaction ledger. */