chore(graph): update knowledge graph after insurance logo fix

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

.env.coolify.example

@@ -17,7 +17,9 @@
 # Replace mariadb-XXXXXXXX / redis-XXXXXXXX with the real hostname shown on each
 # resource's page (Internal URL). serverVersion MUST match the MariaDB resource (11.8).
 DATABASE_URL="mysql://clinic:DB_PASSWORD@mariadb-XXXXXXXX:3306/clinic_pro?serverVersion=mariadb-11.8.0&charset=utf8mb4"
-REDIS_URL="redis://redis-XXXXXXXX:6379"
+# retry_interval/tcp_keepalive: قطع کوتاه اتصال به redis بی‌سروصدا دوباره برقرار می‌شود
+# و «Connection lost» به‌صورت warning در app_log نمی‌نشیند.
+REDIS_URL="redis://redis-XXXXXXXX:6379?timeout=5&read_timeout=5&retry_interval=100&tcp_keepalive=60"
 # stream_max_entries caps the Redis stream so the queue cannot grow without bound
 MESSENGER_TRANSPORT_DSN="redis://redis-XXXXXXXX:6379/messages?stream_max_entries=20000"
 # If the Redis resource has a password: redis://:PASSWORD@redis-XXXXXXXX:6379

.env.example

@@ -31,7 +31,9 @@ MESSENGER_TRANSPORT_DSN=redis://redis:6379/messages
 ###< symfony/messenger ###
 
 ###> Redis ###
-REDIS_URL=redis://redis:6379
+# retry_interval/tcp_keepalive: قطع کوتاه اتصال به redis بی‌سروصدا دوباره برقرار می‌شود
+# و «Connection lost» به‌صورت warning در app_log نمی‌نشیند.
+REDIS_URL=redis://redis:6379?timeout=5&read_timeout=5&retry_interval=100&tcp_keepalive=60
 ###< Redis ###
 
 ###> Auth ###

.env.liara.example

@@ -22,7 +22,9 @@ JWT_PASSPHRASE=        # openssl rand -hex 32   (JWT keypair is generated with i
 # put both + this app on the SAME private network, then copy their private hosts here.
 # serverVersion MUST match the MariaDB service (11.8).
 DATABASE_URL="mysql://<user>:<pass>@<db-private-host>:3306/<db>?serverVersion=mariadb-11.8.0&charset=utf8mb4"
-REDIS_URL="redis://<redis-private-host>:6379"
+# retry_interval/tcp_keepalive: قطع کوتاه اتصال به redis بی‌سروصدا دوباره برقرار می‌شود
+# و «Connection lost» به‌صورت warning در app_log نمی‌نشیند.
+REDIS_URL="redis://<redis-private-host>:6379?timeout=5&read_timeout=5&retry_interval=100&tcp_keepalive=60"
 MESSENGER_TRANSPORT_DSN="redis://<redis-private-host>:6379/messages"
 # If the Redis service has a password: redis://:<pass>@<redis-private-host>:6379
 

assets/admin/components/InsuranceModal.tsx

@@ -74,10 +74,15 @@ function percentsToStrings(map?: Record<string, number>): Record<string, string>
   return Object.fromEntries(Object.entries(map ?? {}).map(([k, v]) => [k, String(v)]));
 }
 
-/** درصد پوششِ قابل ثبت: عددی بین ۱ تا ۱۰۰ — صفر یعنی قرارداد آن نوع خدمت را پوشش نمی‌دهد. */
+/**
+ * درصد پوششِ قابل ثبت: عددی بین ۰ تا ۱۰۰.
+ *
+ * صفر مقدار معتبری است و یعنی «این قرارداد آن نوع خدمت را پوشش نمی‌دهد» — سهم بیمار
+ * صددرصد. آنچه رد می‌شود خالی‌ماندنِ فیلد است، نه صفر بودنش.
+ */
 export function isValidPercent(raw?: string): boolean {
   const n = Number(raw);
-  return raw !== undefined && raw !== '' && Number.isFinite(n) && n > 0 && n <= 100;
+  return raw !== undefined && raw !== '' && Number.isFinite(n) && n >= 0 && n <= 100;
 }
 
 /**

assets/admin/components/SessionServiceCard.tsx

@@ -28,6 +28,8 @@ export interface SessionCardData {
   base_insurance_discount_percent?: number;
   supplementary_discount_percent?: number;
   doctor_name?: string | null;
+  /** پزشکِ نوبتِ این مراجعه — محدودهٔ قرارداد بیمه از روی او حل می‌شود. */
+  doctor_uuid?: string | null;
   final_price_rials?: number;
   // تفکیک بیمه — سرور محاسبه می‌کند (PatientSession::applyShares)
   gross_total_rials?: number;

assets/admin/components/appointments/ConfirmAppointmentModal.tsx

@@ -41,6 +41,7 @@ interface AppointmentLike {
   insurance_service_category?: string | null;
   insurance_base_id?: number | null;
   insurance_supplementary_id?: number | null;
+  doctor?: { uuid?: string | null } | null;
 }
 
 interface Props {
@@ -159,7 +160,7 @@ export default function ConfirmAppointmentModal({
   const appt: AppointmentLike | null = detail ?? appointment ?? null;
 
   // ── بیمه: نوع خدمت + بیمهٔ پایهٔ نوبت ──────────────────────────────────────
-  const insurance = useAppointmentInsurance(open);
+  const insurance = useAppointmentInsurance(open, appt?.doctor?.uuid ?? null);
 
   // نوبتِ بدون هزینهٔ ویزیت، سرِ ساختِ مراجعه «قیمت ویزیت آزاد» تنظیمات را می‌گیرد؛
   // مودال هم باید همان را نشان دهد، وگرنه صفر نشان می‌دهد و مبلغ ثبت‌شده فرق می‌کند.

assets/admin/components/appointments/TurnsTimeline.test.tsx

@@ -72,7 +72,8 @@ describe('TurnsTimeline', () => {
 
   it('نوبتِ دارای بیمه، چیپ «نوع خدمت · بیمه» نشان می‌دهد', async () => {
     (api.get as ReturnType<typeof vi.fn>).mockImplementation((url: string) =>
-      url === '/api/v1/billing/tenant-insurances'
+      // با پزشکِ نوبت، آدرس `?doctor_uuid=…&inherit=1` هم می‌گیرد.
+      url.startsWith('/api/v1/billing/tenant-insurances')
         ? Promise.resolve({ success: true, data: { data: [{
             insurance_id: 3, insurance_name: 'بیمه ایران', insurance_kind: 'basic', is_active: true,
             coverage_percent: 70, franchise_percent: 0, annual_ceiling_rials: null,

assets/admin/components/appointments/TurnsTimeline.tsx

@@ -108,7 +108,7 @@ function OccupiedCard({
   const [confirmOpen, setConfirmOpen] = useState(false);
   // نام بیمه فقط با نگاشت از قراردادهای کش‌شده به دست می‌آید؛ payload نوبت نامی ندارد
   // تا لیست‌های نوبت به N+1 نیفتند.
-  const insurance = useAppointmentInsurance(!!a.insurance_base_id);
+  const insurance = useAppointmentInsurance(!!a.insurance_base_id, a.doctor_uuid ?? null);
   const insuranceChip = [
     a.insurance_service_category_label,
     insurance.insuranceNameOf(a.insurance_base_id),

assets/admin/components/session/CreateStep.tsx

@@ -105,11 +105,20 @@ export default function CreateStep({ recordUuid, profile, onCreated, onCancel, e
   const { data: packagesData } = useQuery<ApiResponse<PackageRow[]>>({
     queryKey: ['inventory-packages'], queryFn: () => api.get('/api/v1/inventory-packages'),
   });
+  // مراجعهٔ برخاسته از نوبت، قراردادِ پزشکِ همان نوبت را دارد نه قراردادِ محیط پنل:
+  // در کلینیک، قرارداد روی خودِ پزشک ثبت می‌شود و بدون این محدوده، فهرست بیمه‌ها
+  // خالی می‌آمد و بیمهٔ ثبت‌شدهٔ همان مراجعه هم در فرم پیدا نمی‌شد.
+  const insuranceScope = editSession?.doctor_uuid
+    ? `?doctor_uuid=${encodeURIComponent(editSession.doctor_uuid)}&inherit=1`
+    : '';
+
   const { data: contractsData } = useQuery<{ data: { data: Contract[] } }>({
-    queryKey: ['tenant-insurances'], queryFn: () => api.get('/api/v1/billing/tenant-insurances'),
+    queryKey: ['tenant-insurances', editSession?.doctor_uuid ?? null],
+    queryFn: () => api.get(`/api/v1/billing/tenant-insurances${insuranceScope}`),
   });
   const { data: pricingData } = useQuery<{ data: { free_visit_price_rials: number; require_visit_price: boolean } }>({
-    queryKey: ['insurance-pricing'], queryFn: () => api.get('/api/v1/insurance-pricing'),
+    queryKey: ['insurance-pricing', editSession?.doctor_uuid ?? null],
+    queryFn: () => api.get(`/api/v1/insurance-pricing${insuranceScope}`),
   });
   const freeVisit = (pricingData as any)?.data?.free_visit_price_rials ?? 0;
   const requireVisit = (pricingData as any)?.data?.require_visit_price ?? false;

assets/admin/hooks/useAppointmentInsurance.ts

@@ -22,16 +22,23 @@ interface PricingPayload {
  * به‌همراه محاسبهٔ سهم — مشترک بین مودال «قطعی کردن نوبت» و صفحهٔ ویرایش نوبت تا
  * هر دو یک قاعده را نشان دهند.
  */
-export function useAppointmentInsurance(enabled: boolean) {
+export function useAppointmentInsurance(enabled: boolean, doctorUuid?: string | null) {
+  // بدون پزشک، محیطِ خودِ کاربر پرسیده می‌شود — همان رفتار قبلی برای مطب شخصی.
+  //
+  // با پزشک، `inherit=1` هم می‌رود: نوبتِ ثبت‌شده در کلینیک محیطش «کلینیک» است ولی
+  // قرارداد بیمه معمولاً روی خودِ پزشک ذخیره شده. سرور اول تنظیم پزشک را می‌دهد و
+  // در نبودش تنظیم کلینیک را — دقیقاً همان چیزی که سرِ قطعی‌کردن اعمال می‌شود.
+  const scopeQuery = doctorUuid ? `?doctor_uuid=${encodeURIComponent(doctorUuid)}&inherit=1` : '';
+
   const pricingQuery = useQuery<ApiResponse<PricingPayload>>({
-    queryKey: ['insurance-pricing'],
+    queryKey: ['insurance-pricing', doctorUuid ?? null],
-    queryFn: () => api.get('/api/v1/insurance-pricing'),
+    queryFn: () => api.get(`/api/v1/insurance-pricing${scopeQuery}`),
     enabled,
   });
 
   const contractsQuery = useQuery<ApiResponse<{ data: TenantContract[] }>>({
-    queryKey: ['tenant-insurances'],
+    queryKey: ['tenant-insurances', doctorUuid ?? null],
-    queryFn: () => api.get('/api/v1/billing/tenant-insurances'),
+    queryFn: () => api.get(`/api/v1/billing/tenant-insurances${scopeQuery}`),
     enabled,
   });
 

assets/admin/hooks/useSubscription.test.tsx

@@ -0,0 +1,74 @@
+import React from 'react';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { renderHook, waitFor } from '@testing-library/react';
+import { QueryClientProvider } from '@tanstack/react-query';
+import { makeClient } from '../test/utils';
+import { useAuthStore } from '../stores/authStore';
+
+vi.mock('../lib/api', () => ({
+  api: { get: vi.fn() },
+}));
+
+import { api } from '../lib/api';
+import { useSubscription } from './useSubscription';
+
+const get = api.get as ReturnType<typeof vi.fn>;
+const initial = useAuthStore.getInitialState();
+
+function planResponse(name: string) {
+  return {
+    success: true,
+    data: {
+      subscription: null,
+      used_trial: false,
+      effective_plan: { name, features: { patient_records: name !== 'free' }, max_secretaries: 1, max_resources: 1 },
+    },
+  };
+}
+
+beforeEach(() => {
+  localStorage.clear();
+  useAuthStore.setState(initial, true);
+  get.mockReset();
+});
+
+describe('useSubscription', () => {
+  /**
+   * پزشکی که هم مطب شخصی دارد و هم کلینیک، دو محیط دارد و اشتراک روی محیط می‌نشیند.
+   * با کلیدِ بدون محیط، پاسخِ cache شدهٔ محیط قبلی در محیط تازه سرو می‌شد و هر دو
+   * محیط ارتقایافته به‌نظر می‌رسیدند.
+   */
+  it('پاسخِ cache شدهٔ محیط دیگر را سرو نمی‌کند', async () => {
+    const client = makeClient();
+    const wrapper = ({ children }: { children: React.ReactNode }) => (
+      <QueryClientProvider client={client}>{children}</QueryClientProvider>
+    );
+
+    // محیط کلینیک از قبل در cache نشسته است.
+    client.setQueryData(['subscription-my', 'clinic-1'], planResponse('professional'));
+
+    useAuthStore.setState({ primaryRole: 'doctor', dbUuid: 'doctor-1' });
+    get.mockResolvedValue(planResponse('free'));
+
+    const { result } = renderHook(() => useSubscription(), { wrapper });
+
+    await waitFor(() => expect(result.current.planLoaded).toBe(true));
+    expect(result.current.hasFeature('patient_records')).toBe(false);
+    expect(get).toHaveBeenCalledWith('/api/v1/subscription/my');
+  });
+
+  it('در همان محیط، پاسخِ cache شده دوباره درخواست نمی‌شود', async () => {
+    const client = makeClient();
+    const wrapper = ({ children }: { children: React.ReactNode }) => (
+      <QueryClientProvider client={client}>{children}</QueryClientProvider>
+    );
+
+    client.setQueryData(['subscription-my', 'clinic-1'], planResponse('professional'));
+    useAuthStore.setState({ primaryRole: 'clinic', dbUuid: 'clinic-1' });
+
+    const { result } = renderHook(() => useSubscription(), { wrapper });
+
+    await waitFor(() => expect(result.current.hasFeature('patient_records')).toBe(true));
+    expect(get).not.toHaveBeenCalled();
+  });
+});

assets/admin/hooks/useSubscription.ts

@@ -6,10 +6,14 @@ import type { MySubscriptionData } from '../types';
 
 export function useSubscription() {
   const primaryRole = useAuthStore((s) => s.primaryRole);
+  const dbUuid      = useAuthStore((s) => s.dbUuid);
   const enabled = primaryRole === 'doctor' || primaryRole === 'clinic' || primaryRole === 'secretary';
 
+  // کلید شامل محیط فعال است: اشتراک روی محیط می‌نشیند، نه روی کاربر. پزشکی که هم
+  // مطب شخصی دارد و هم کلینیک، با کلیدِ بدون محیط پلنِ محیط قبلی را می‌دید و هر دو
+  // محیط ارتقایافته به‌نظر می‌رسیدند.
   const { data } = useQuery<ApiResponse<MySubscriptionData>>({
-    queryKey: ['subscription-my'],
+    queryKey: ['subscription-my', dbUuid],
     queryFn: () => api.get('/api/v1/subscription/my'),
     enabled,
     staleTime: 2 * 60 * 1000,

assets/admin/pages/AdminSubscriptionPage.test.tsx

@@ -14,6 +14,7 @@ import AdminSubscriptionPage from './AdminSubscriptionPage';
 const get   = api.get   as ReturnType<typeof vi.fn>;
 const patch = api.patch as ReturnType<typeof vi.fn>;
 const post  = api.post  as ReturnType<typeof vi.fn>;
+const del   = api.delete as ReturnType<typeof vi.fn>;
 
 const PLANS = [
   {
@@ -213,7 +214,27 @@ describe('AdminSubscriptionPage — اعطای اشتراک', () => {
 });
 
 describe('AdminSubscriptionPage — گزارش', () => {
-  beforeEach(() => { get.mockReset(); post.mockReset(); });
+  beforeEach(() => { get.mockReset(); post.mockReset(); del.mockReset(); });
+
+  /** یک ردیف گزارشِ اعطایی — تست‌های حذف و ناوبری از همین استفاده می‌کنند. */
+  function mockReportRow() {
+    get.mockImplementation((url: string) => {
+      if (url.includes('/admin/subscription/plans')) return Promise.resolve({ success: true, data: PLANS });
+      if (url.includes('/admin/subscription/report')) {
+        return Promise.resolve({
+          success: true,
+          meta: { totalRecords: 1 },
+          data: [{
+            uuid: 's-1', entityType: 'clinic', entityId: 11, entityName: 'کلینیک نمونه',
+            isTrial: false, isGranted: true, grantedBy: 'ادمین',
+            startsAt: 1700000000, expiresAt: 1800000000, createdAt: 1700000000,
+            plan_name: 'professional', plan_level: 2,
+          }],
+        });
+      }
+      return Promise.resolve({ success: true, data: [], meta: { totalRecords: 0 } });
+    });
+  }
 
   it('اشتراک اعطایی را «اعطایی» نشان می‌دهد، نه «پولی»', async () => {
     get.mockImplementation((url: string) => {
@@ -241,4 +262,27 @@ describe('AdminSubscriptionPage — گزارش', () => {
     expect(screen.getByText('ادمین')).toBeInTheDocument();
     expect(screen.queryByText('پولی')).not.toBeInTheDocument();
   });
+
+  it('حذف اشتراک پس از تأیید، DELETE می‌فرستد', async () => {
+    mockReportRow();
+    del.mockResolvedValue({ success: true, data: null });
+
+    renderWithProviders(<AdminSubscriptionPage />, { route: '/admin/admin-subscription' });
+    fireEvent.click(await screen.findByText('گزارش فروش'));
+
+    fireEvent.click(await screen.findByLabelText('حذف اشتراک کلینیک نمونه'));
+    fireEvent.click(await screen.findByRole('button', { name: 'حذف' }));
+
+    await waitFor(() => expect(del).toHaveBeenCalledWith('/api/v1/admin/subscription/s-1'));
+  });
+
+  it('دکمهٔ اعطای اشتراک از گزارش به تب اعطا می‌برد', async () => {
+    mockReportRow();
+
+    renderWithProviders(<AdminSubscriptionPage />, { route: '/admin/admin-subscription' });
+    fireEvent.click(await screen.findByText('گزارش فروش'));
+    fireEvent.click(await screen.findByRole('button', { name: /اعطای اشتراک جدید/ }));
+
+    expect(await screen.findByText(/پلن و دوره/)).toBeInTheDocument();
+  });
 });

assets/admin/pages/AdminSubscriptionPage.tsx

@@ -626,8 +626,10 @@ function GrantTab() {
 
 // ── Report tab ────────────────────────────────────────────────────────────
 
-function ReportTab() {
+function ReportTab({ onAdd }: { onAdd: () => void }) {
+  const qc = useQueryClient();
   const [page, setPage] = useState(1);
+  const [deleteRow, setDeleteRow] = useState<ReportRow | null>(null);
   const limit = 20;
 
   const { data, isLoading } = useQuery({
@@ -635,11 +637,27 @@ function ReportTab() {
     queryFn: () => api.get<PaginatedResponse<ReportRow>>(`/api/v1/admin/subscription/report?page=${page}&limit=${limit}`),
   });
 
+  const deleteMut = useMutation({
+    mutationFn: (uuid: string) => api.delete(`/api/v1/admin/subscription/${uuid}`),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ['admin-subscription-report'] });
+      qc.invalidateQueries({ queryKey: ['admin-grant-active'] });
+      setDeleteRow(null);
+      toast.success('اشتراک حذف شد');
+    },
+    onError: (e: any) => { setDeleteRow(null); toast.error(e.message); },
+  });
+
   const rows: ReportRow[] = data?.data ?? [];
   const total = data?.meta?.totalRecords ?? 0;
 
   return (
     <div className="card">
+      <div className="card-pad" style={{ display: 'flex', justifyContent: 'flex-end', borderBottom: '1px solid var(--border)' }}>
+        <button type="button" className="btn primary" onClick={onAdd}>
+          <PlusIcon style={{ width: 15 }} /> اعطای اشتراک جدید
+        </button>
+      </div>
       {isLoading ? (
         <div className="card-pad" style={{ color: 'var(--text-3)' }}>در حال بارگذاری...</div>
       ) : rows.length === 0 ? (
@@ -655,6 +673,7 @@ function ReportTab() {
                 <th style={{ textAlign: 'right', padding: '10px 16px', color: 'var(--text-3)', fontWeight: 500 }}>شروع</th>
                 <th style={{ textAlign: 'right', padding: '10px 16px', color: 'var(--text-3)', fontWeight: 500 }}>انقضا</th>
                 <th style={{ textAlign: 'right', padding: '10px 16px', color: 'var(--text-3)', fontWeight: 500 }}>تاریخ ثبت</th>
+                <th style={{ textAlign: 'left', padding: '10px 16px', color: 'var(--text-3)', fontWeight: 500 }}>عملیات</th>
               </tr>
             </thead>
             <tbody>
@@ -689,6 +708,17 @@ function ReportTab() {
                     {row.expiresAt ? formatDate(row.expiresAt) : <span className="muted">بی‌نهایت</span>}
                   </td>
                   <td style={{ padding: '10px 16px', color: 'var(--text-3)' }}>{formatDate(row.createdAt)}</td>
+                  <td style={{ padding: '10px 16px', textAlign: 'left' }}>
+                    <button
+                      type="button"
+                      className="btn sm"
+                      title="حذف اشتراک"
+                      aria-label={`حذف اشتراک ${row.entityName ?? row.entityId}`}
+                      onClick={() => setDeleteRow(row)}
+                    >
+                      <TrashIcon style={{ width: 13 }} />
+                    </button>
+                  </td>
                 </tr>
               ))}
             </tbody>
@@ -698,6 +728,17 @@ function ReportTab() {
           </div>
         </>
       )}
+
+      <ConfirmDialog
+        open={!!deleteRow}
+        title="حذف اشتراک"
+        message={`آیا مطمئن هستید که می‌خواهید اشتراک «${deleteRow?.entityName ?? ''}» را حذف کنید؟ دسترسی این محیط به قابلیت‌های پلن قطع می‌شود.`}
+        confirmLabel="حذف"
+        danger
+        loading={deleteMut.isPending}
+        onConfirm={() => deleteRow && deleteMut.mutate(deleteRow.uuid)}
+        onCancel={() => setDeleteRow(null)}
+      />
     </div>
   );
 }
@@ -722,7 +763,7 @@ export default function AdminSubscriptionPage() {
 
       {tab === 'plans'  && <PlansTab />}
       {tab === 'grant'  && <GrantTab />}
-      {tab === 'report' && <ReportTab />}
+      {tab === 'report' && <ReportTab onAdd={() => setTab('grant')} />}
     </>
   );
 }

assets/admin/pages/PaymentDetailPage.tsx

@@ -92,6 +92,12 @@ export default function PaymentDetailPage() {
             <InfoRow label="مبلغ" value={formatRial(payment.amount)} />
             <InfoRow label="وضعیت" value={<StatusBadge type="payment" value={payment.status} />} />
             <InfoRow label="درگاه" value={<span className="uppercase">{payment.gateway}</span>} />
+            <InfoRow
+              label="مبدأ"
+              value={payment.origin
+                ? <span dir="ltr" title={payment.frontend_address ?? undefined}>{payment.origin}</span>
+                : null}
+            />
             <InfoRow label="شماره مرجع" value={payment.ref_id ? <span dir="ltr" className="font-mono text-xs">{payment.ref_id}</span> : null} />
             <InfoRow label="شماره کارت" value={payment.card_pan ? <span dir="ltr" className="font-mono text-xs">{payment.card_pan}</span> : null} />
             <InfoRow label="تاریخ پرداخت" value={formatDateTime(payment.paid_at)} />

assets/admin/pages/PaymentsPage.test.tsx

@@ -0,0 +1,48 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { screen, waitFor } from '@testing-library/react';
+import { renderWithProviders } from '../test/utils';
+
+const navigate = vi.fn();
+vi.mock('react-router', async (orig) => ({
+  ...(await orig<typeof import('react-router')>()),
+  useNavigate: () => navigate,
+}));
+vi.mock('../lib/api', () => ({ api: { get: vi.fn() }, ApiError: class extends Error {} }));
+
+import { api } from '../lib/api';
+import PaymentsPage from './PaymentsPage';
+
+const get = api.get as ReturnType<typeof vi.fn>;
+
+const ROWS = [
+  { uuid: 'pay-1', amount: 1500000, status: 'success', gateway: 'mellat', ref_id: '99123',
+    origin: 'nobat724.com', patient_mobile: '09120000001', appointment_uuid: null,
+    paid_at: '2026-08-19T10:00:00+00:00', created_at: '2026-08-19T09:55:00+00:00' },
+  // پرداخت‌های قدیمی آدرس بازگشت ندارند و مبدأشان ناشناخته است.
+  { uuid: 'pay-2', amount: 900000, status: 'failed', gateway: 'mellat', ref_id: null,
+    origin: null, patient_mobile: '09120000002', appointment_uuid: null,
+    paid_at: null, created_at: '2026-08-18T09:00:00+00:00' },
+];
+
+beforeEach(() => {
+  navigate.mockReset();
+  get.mockReset();
+  get.mockResolvedValue({ success: true, data: ROWS, meta: { totalRecords: 2, totalPages: 1, currentPage: 1 } });
+});
+
+describe('PaymentsPage (پرداخت‌های ادمین)', () => {
+  it('دامنهٔ مبدأ هر پرداخت را نشان می‌دهد', async () => {
+    renderWithProviders(<PaymentsPage />, { route: '/admin/payments' });
+
+    expect(await screen.findByText('nobat724.com')).toBeInTheDocument();
+    expect(screen.getByText('مبدأ')).toBeInTheDocument();
+  });
+
+  it('جستجو دامنه را هم به سرور می‌فرستد', async () => {
+    renderWithProviders(<PaymentsPage />, { route: '/admin/payments?search=nobat724.com' });
+
+    await waitFor(() =>
+      expect(get).toHaveBeenCalledWith(expect.stringContaining('search=nobat724.com')),
+    );
+  });
+});

assets/admin/pages/PaymentsPage.tsx

@@ -75,6 +75,13 @@ export default function PaymentsPage() {
       header: 'درگاه',
       render: (p) => <span className="chip" style={{ fontSize: 12 }}>{p.gateway}</span>,
     },
+    {
+      key: 'origin',
+      header: 'مبدأ',
+      render: (p) => p.origin
+        ? <span className="chip" dir="ltr" style={{ fontSize: 12 }}>{p.origin}</span>
+        : <span className="muted">—</span>,
+    },
     {
       key: 'ref_id',
       header: 'شماره مرجع',
@@ -142,7 +149,7 @@ export default function PaymentsPage() {
             <div className="field" style={{ minWidth: 240 }}>
               <MagnifyingGlassIcon style={{ width: 17, height: 17 }} />
               <input
-                placeholder="جستجو بر اساس موبایل یا شماره مرجع..."
+                placeholder="جستجو بر اساس موبایل، شماره مرجع یا دامنه..."
                 value={search}
                 onChange={(e) => { setSearch(e.target.value); setPage(1); }}
               />

assets/admin/pages/SelectContextPage.test.tsx

@@ -0,0 +1,48 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { render, screen, fireEvent, waitFor } from '@testing-library/react';
+import { QueryClientProvider } from '@tanstack/react-query';
+import { MemoryRouter } from 'react-router';
+import { makeClient } from '../test/utils';
+import { useAuthStore } from '../stores/authStore';
+import SelectContextPage from './SelectContextPage';
+
+vi.mock('react-router', async () => {
+  const actual = await vi.importActual<typeof import('react-router')>('react-router');
+  return { ...actual, useNavigate: () => vi.fn() };
+});
+
+const initial = useAuthStore.getInitialState();
+
+const CONTEXTS = [
+  { db_uuid: 'doc-1',    db_key: 'k1', type: 'doctor', role: 'doctor', name: 'مطب شخصی' },
+  { db_uuid: 'clinic-1', db_key: 'k2', type: 'clinic', role: 'clinic', name: 'کلینیک تست' },
+];
+
+beforeEach(() => {
+  localStorage.clear();
+  useAuthStore.setState(initial, true);
+  useAuthStore.setState({ availableContexts: CONTEXTS as any, switchContext: vi.fn() as any });
+});
+
+describe('SelectContextPage', () => {
+  /**
+   * هر پاسخِ cache شده متعلق به محیط قبلی است. اشتراک روی محیط می‌نشیند، پس بدون
+   * پاک کردن cache، مطب شخصی پلن کلینیک را نشان می‌داد و برعکس.
+   */
+  it('بعد از تعویض محیط، cache کوئری‌ها را پاک می‌کند', async () => {
+    const client = makeClient();
+    client.setQueryData(['subscription-my', 'doc-1'], { stale: true });
+
+    render(<SelectContextPage />, {
+      wrapper: ({ children }) => (
+        <QueryClientProvider client={client}>
+          <MemoryRouter>{children}</MemoryRouter>
+        </QueryClientProvider>
+      ),
+    });
+
+    fireEvent.click(screen.getByText('کلینیک تست'));
+
+    await waitFor(() => expect(client.getQueryData(['subscription-my', 'doc-1'])).toBeUndefined());
+  });
+});

assets/admin/pages/SelectContextPage.tsx

@@ -1,5 +1,6 @@
 import { useNavigate } from 'react-router';
 import { useState } from 'react';
+import { useQueryClient } from '@tanstack/react-query';
 import { useAuthStore, ContextItem } from '../stores/authStore';
 
 const ROLE_LABELS: Record<string, string> = {
@@ -18,11 +19,15 @@ const TYPE_ICONS: Record<string, string> = {
 export default function SelectContextPage() {
   const { availableContexts, switchContext } = useAuthStore();
   const navigate = useNavigate();
+  const qc = useQueryClient();
   const [loading, setLoading] = useState<string | null>(null);
 
   const handleSelect = async (ctx: ContextItem) => {
     setLoading(ctx.db_uuid);
     await switchContext(ctx.db_uuid);
+    // هر پاسخِ cache‌شده متعلق به محیط قبلی است — از اشتراک و پلن گرفته تا بیماران و
+    // نوبت‌ها. بدون پاک کردن، محیط تازه داده و دسترسی‌های محیط قبلی را نشان می‌دهد.
+    qc.clear();
     navigate('/admin/dashboard', { replace: true });
   };
 

assets/admin/types/index.ts

@@ -203,6 +203,10 @@ export interface Payment {
     status: PaymentStatus;
     gateway: PaymentGateway;
     ref_id: string | null;
+    /** دامنهٔ مبدأ پرداخت (سایت نوبت‌دهی یا پنل)، از آدرس بازگشت استخراج می‌شود. */
+    origin: string | null;
+    /** آدرس بازگشتِ کامل؛ فقط در جزئیات می‌آید. */
+    frontend_address?: string | null;
     card_pan?: string | null;
     refunds?: { amount: number; ref: string; at: number }[];
     patient_mobile: string;

composer.json

@@ -10,12 +10,12 @@
         "ext-ctype": "*",
         "ext-iconv": "*",
         "ext-soap": "*",
-        "altcha-org/altcha": "^2.0",
+        "altcha-org/altcha": "^2.1",
-        "doctrine/doctrine-bundle": ">=2.18.3",
+        "doctrine/doctrine-bundle": ">=2.19.0",
         "doctrine/doctrine-migrations-bundle": "*",
-        "doctrine/orm": "^3.6",
+        "doctrine/orm": "^3.6.8",
         "lexik/jwt-authentication-bundle": "*",
-        "nelmio/api-doc-bundle": "*",
+        "nelmio/api-doc-bundle": ">=5.11.1",
         "nelmio/cors-bundle": "*",
         "symfony/asset": "7.4.*",
         "symfony/cache": "7.4.*",
@@ -42,7 +42,7 @@
         "symfony/webpack-encore-bundle": "^2.4.1",
         "symfony/yaml": "7.4.*",
         "twig/twig": ">=3.28",
-        "zircote/swagger-php": ">=6.4"
+        "zircote/swagger-php": ">=6.6"
     },
     "config": {
         "allow-plugins": {
@@ -98,10 +98,10 @@
         }
     },
     "require-dev": {
-        "phpstan/phpstan": "^2.2.5",
+        "phpstan/phpstan": "^2.2.8",
         "phpstan/phpstan-doctrine": "^2.0.28",
         "phpstan/phpstan-symfony": "^2.0.20",
-        "phpunit/phpunit": "^12.5.31",
+        "phpunit/phpunit": "^12.5.33",
         "symfony/browser-kit": "7.4.*",
         "symfony/css-selector": "7.4.*",
         "symfony/debug-bundle": "7.4.*",

docs/api/admin.md

@@ -654,7 +654,7 @@ List all payments.
 ### Query Parameters (تکمیل)
 | Param | Type | Required | Description |
 |-------|------|----------|-------------|
-| `search` | string | ❌ | جستجو در موبایل کاربر، `reference_id` یا `order_id` |
+| `search` | string | ❌ | جستجو در موبایل کاربر، `reference_id`، `order_id` یا دامنهٔ مبدأ |
 
 ### Response `200`
 ```json
@@ -667,6 +667,7 @@ List all payments.
       "status": "success",
       "gateway": "mellat",
       "ref_id": "1234567",
+      "origin": "nobat724.com",
       "patient_mobile": "0912...",
       "paid_at": "2026-07-02T09:00:00+03:30",
       "created_at": "2026-07-02T08:55:00+03:30"
@@ -678,6 +679,11 @@ List all payments.
 
 > `amount` بر حسب ریال، `ref_id` همان `reference_id` درگاه، `paid_at` فقط برای پرداخت `success` (بر اساس `updated_at`) و در غیر این‌صورت `null`. تاریخ‌ها ISO-8601.
 
+> `origin` دامنهٔ مبدأ پرداخت است — از `frontend_address` (آدرس بازگشت) استخراج
+> می‌شود، با حروف کوچک و بدون `www.`، تا یک دامنه در گزارش یک مقدار باشد. چند مبدأ
+> به یک درگاه می‌روند: سایت‌های نوبت‌دهی شهری و پنل خودِ کلینیک‌پرو. پرداخت بدون آدرس
+> بازگشت `null` می‌گیرد.
+
 ---
 
 ### GET `/api/v1/admin/payments/{uuid}`
@@ -698,6 +704,8 @@ List all payments.
     "gateway": "mellat",
     "type": "appointment",
     "ref_id": "1234567",
+    "origin": "nobat724.com",
+    "frontend_address": "https://nobat724.com/payment/result",
     "card_pan": "502229******2928",
     "patient_mobile": "0912...",
     "patient_name": "علی احمدی",

docs/api/appointment.md

@@ -459,7 +459,15 @@ Get appointment detail.
   }
 }
 ```
-> `doctor.specialties` آرایه (ممکن است خالی)؛ `address` اولین آدرس پزشک است (ممکن است `null` اگر پزشک آدرسی ندارد). `address.map.latitude/longitude` رشته یا `null`. تاریخ‌ها Unix.
+
+> ℹ️ تغییر بیمهٔ نوبت با `PATCH` سهم‌های مراجعهٔ همان نوبت را هم دوباره حساب می‌کند: پذیرش گاهی اول نوبت را قطعی می‌کند و بعد بیمه را اصلاح می‌کند، و بدون این، مراجعه روی محاسبهٔ اول می‌ماند و صفحهٔ پرداخت سهمِ بیمه را از بیمار می‌خواهد. پرداخت‌های ثبت‌شده دست نمی‌خورند؛ فقط مبلغ قابل‌پرداخت اصلاح می‌شود. پاسخ `PATCH` هم مثل `GET` نشانیِ واقعیِ نوبت را برمی‌گرداند.
+
+> ℹ️ `address` is the venue recorded on this appointment (`address_id`) — the doctor's own
+> office or the clinic branch, whichever the booking was made at — and it is the only place
+> `telephone` is returned. When that record carries no number, the clinic's own number takes
+> its place. Public doctor and clinic responses never carry a phone number.
+
+> `doctor.specialties` آرایه (ممکن است خالی)؛ `address` آدرسِ ثبت‌شدهٔ همین نوبت است و برای نوبت‌های قدیمیِ بدون `address_id` ممکن است `null` باشد. `address.map.latitude/longitude` رشته یا `null`. تاریخ‌ها Unix.
 
 ### انتخاب بیمهٔ نوبت
 
@@ -547,6 +555,12 @@ Get all appointments for the authenticated user.
 
 **Permission:** `AUTH` — عمداً بدون مجوزِ رجیستری.
 
+> **فیلتر محیط اینجا اعمال نمی‌شود.** رکورد در محیطِ پزشکِ مقصد ثبت می‌شود، ولی
+> مالکش از راه `user_id` تعیین می‌شود. کاربری که خودش صاحب محیط دیگری است — پزشک،
+> منشی، مالک کلینیک — با فیلترِ محیطِ خودش رکورد خودش را نمی‌دید و ۴۰۴ می‌گرفت.
+> دورزدن فیلتر فقط از راه `App\Shared\Tenant\TenantFilterScope` انجام می‌شود و
+> مجوز دست‌نخورده باقی می‌ماند.
+
 > این اندپوینت `a.user = خودِ کاربر` را می‌دهد، یعنی نوبت‌های خودِ فرد **به‌عنوان
 > بیمار**، نه دادهٔ محیط. مصرف‌کننده‌اش داشبورد بیمار در `nobat724_front` است.
 > آدیت ۲۰۲۶-۰۸-۰۷ آن را در فهرست گَپ‌ها آورده بود؛ در ۲۰۲۶-۰۸-۰۸ مثبت کاذب تشخیص

docs/api/clinic.md

@@ -150,7 +150,7 @@ limited to the whitelist under `PATCH /api/v1/clinic/{uuid}`.
         "linkedin": null
       },
       "caption": "توضیحات کلینیک",
-      "list_bime": [],
+      "list_bime": [{ "uuid": "...", "id": "176", "name": "تامین اجتماعی", "logo_url": "/uploads/insurances/logo/2026-08/tamin.png" }],
       "specialties": [{ "uuid": "...", "id": "1", "name": "قلب", "parent": null }],
       "services": [],
       "clinic_specialty": [{ "uuid": "...", "id": "1", "name": "قلب", "parent": null }],
@@ -167,6 +167,11 @@ limited to the whitelist under `PATCH /api/v1/clinic/{uuid}`.
 }
 ```
 
+> `list_bime[].logo_url` مسیر نسبی روی همین API است (`/uploads/...`) و کلاینت باید آن را با دامنهٔ API کامل کند. بیمهٔ بدون لوگو `null` می‌گیرد، نه کلید غایب.
+
+
+> 🔒 `phone`/`phone_number` are `null` unless the caller may edit the clinic (`can_edit: true`). The number is not public data; the patient sees the venue phone on their own appointment instead.
+>
 > `city`/`state`/`map`/`location`/`phone`/`phone_number` are all resolved from the clinic's **address** (`DoctorAddress` linked by `clinic_id`), not from columns on the clinic. `location` and `phone`/`phone_number` fall back to the deprecated `clinics.address` / `clinics.telephone` columns only when the address record has no value — reading them from different rows made one response describe two different places. Each is an array with a single object (or empty `[]` if the clinic has no address). `doctors` is a **count**; the actual doctor list comes from `GET /api/v1/clinic/doctor-list/{clinicUuid}` (`doctor_list` here is always `null`).
 
 ### معنای `is_active`
@@ -330,7 +335,7 @@ List clinics with pagination.
 | `doctors_count` | integer | Number of doctors linked to the clinic |
 | `city` | string\|null | City name, resolved from the clinic's address (`DoctorAddress`) |
 | `state` | string\|null | Province name, resolved from the clinic's address (`DoctorAddress`) |
-| `phone` / `phone_number` | string\|null | Contact number from the clinic's address (`DoctorAddress`), falling back to the deprecated `clinics.telephone` column |
+| `phone` / `phone_number` | string\|null | Contact number from the clinic's address (`DoctorAddress`), falling back to the deprecated `clinics.telephone` column. `null` for anyone who cannot edit the clinic, and always `null` in the public list. |
 | `24_7` | boolean | Open 24/7 flag |
 | `field_working_days` | string\|null | Working days/hours description |
 

docs/api/doctor.md

@@ -133,7 +133,7 @@ limited to the whitelist under `PATCH /api/v1/doctor/{uuid}`.
       "address": [],
       "state": [],
       "city": [],
-      "clinics": [{ "uuid": "...", "name": "کلینیک الوند", "address": "...", "telephone": "..." }],
+      "clinics": [{ "uuid": "...", "name": "کلینیک الوند", "address": "...", "telephone": null }],
       "representation": { "id": 12, "uuid": "9c1...", "full_name": "علی محمدی" }
     }
   }
@@ -143,6 +143,13 @@ limited to the whitelist under `PATCH /api/v1/doctor/{uuid}`.
 > ⚠️ **Double-nested:** Frontend extracts with `data?.data?.data`
 >
 > ℹ️ `representation` نماینده‌ی مالکِ پزشک است؛ برای پزشکِ بدون نماینده `null`.
+>
+> 🔒 **Phone numbers are not public.** `address[].telephone` and `clinics[].telephone`
+> are `null` for anonymous callers and only carry a value when `can_edit` is `true`
+> (the profile owner, its representative, or an admin). Street address and map
+> coordinates stay public — a patient needs them to find the place. The venue phone
+> reaches the patient through their own appointment (`GET /api/v1/appointments/user`),
+> not through the public profile.
 
 ### Errors
 | Code | HTTP | Description |
@@ -171,7 +178,7 @@ Get doctor detail for clinic owner — only doctors who are members of the authe
       "uuid": "...",
       "title": "علی احمدی",
       "specialties": [...],
-      "clinics": [{ "uuid": "...", "name": "کلینیک نور", "address": "...", "telephone": "..." }]
+      "clinics": [{ "uuid": "...", "name": "کلینیک نور", "address": "...", "telephone": "021..." }]
     }
   }
 }

docs/api/insurance.md

@@ -407,9 +407,16 @@ entity جاری از `#[CurrentUser]` resolve می‌شود: نقش `ROLE_DOCTOR
 | Param | Type | Required | Description |
 |-------|------|----------|-------------|
 | `doctor_uuid` | string (UUID) | ❌ | قیمت‌گذاری همان پزشک را برمی‌گرداند به‌جای موجودیت کاربر جاری. برای تب‌های نوبت‌دهی پنل کلینیک. |
+| `inherit` | bool | ❌ | «برای نوبتِ این پزشک واقعاً چه قیمتی اعمال می‌شود؟» — اول قیمت خودِ پزشک، در نبودش قیمت کلینیکی که کاربر در آن ایستاده. مودال قطعی‌کردن نوبت آن را می‌فرستد؛ صفحهٔ تنظیمات نه، چون آنجا باید ردیفِ خودِ پزشک ویرایش شود. |
 
 با `doctor_uuid`، دسترسی این‌گونه بررسی می‌شود: `ROLE_ADMIN`، خودِ پزشک، مالک کلینیکی که پزشک عضو آن است، یا پزشکِ عضو همان کلینیک با مجوز `services.view` (برای `PUT`: `services.update`). در غیر این صورت `403 ERR_ACCESS_DENIED`؛ پزشکِ ناموجود `404 ERR_NOT_FOUND_001`. بدون این پارامتر رفتار قبلی (موجودیت کاربر جاری) دست‌نخورده است.
 
+> ℹ️ ردیف‌های قیمت‌گذاری با `doctor_uuid` بیرون از TenantFilter خوانده می‌شوند: مقصدِ این
+> تنظیم پزشک است در حالی که محیط فعالِ مالکِ کلینیک، خودِ کلینیک است. مجوزش همان بررسی
+> بالاست. تا پیش از این، خواندن به محیط کاربر محدود می‌شد و ردیف موجود دیده نمی‌شد —
+> هر ذخیره یک ردیف تازه می‌ساخت (قیدِ یکتا ردیفِ ویزیت آزاد را نمی‌گیرد چون `insurance_id`
+> آنجا `NULL` است) و مقدار ذخیره‌شده هرگز به پنل برنمی‌گشت.
+
 ### Response `200`
 ```json
 {
@@ -513,11 +520,18 @@ entity جاری از `#[CurrentUser]` resolve می‌شود: نقش `ROLE_DOCTOR
 
 tenant از `#[CurrentUser]` با `App\Patient\Security\PatientRecordScopeResolver` resolve می‌شود — همان رزولور پرونده‌ها و صورتحساب‌ها، تا قرارداد بیمه و صورتحسابی که از آن ساخته می‌شود هرگز به دو محیط متفاوت نیفتند. محیط فعال (`UserActiveContext`) تعیین‌کننده است، نه صرفاً ترتیب نقش‌ها؛ مالک کلینیکی که خودش پزشک هم هست، قراردادهای **کلینیک** خود را می‌بیند.
 
+**محدودهٔ تنظیم — اول پزشک، بعد کلینیک:** نوبتی که در کلینیک ثبت می‌شود محیطش «کلینیک» است، ولی تنظیمات بیمه معمولاً روی خودِ پزشک ذخیره شده‌اند. هنگام محاسبه — انتخاب بیمهٔ نوبت، نوع خدمت، و قیمت ویزیت — اول تنظیمِ خودِ پزشک خوانده می‌شود و فقط در نبودِ آن تنظیمِ کلینیک. هر سه مورد جدا سنجیده می‌شوند: پزشکی که قرارداد بیمهٔ خودش را دارد ولی قیمت ویزیت را به کلینیک سپرده، هرکدام را از جای درست می‌گیرد. مرجع: `App\Insurance\Service\InsuranceScopeResolver`.
+
+**درصد صفر:** `0` مقدار معتبری است و یعنی «این قرارداد آن نوع خدمت را پوشش نمی‌دهد» (سهم بیمار صددرصد). آنچه رد می‌شود، خالی‌ماندنِ درصدِ یک نوع خدمتِ فعال است؛ پیش‌فرض مرکزیِ صفر هم «تعیین‌نشده» حساب می‌شود، نه انتخابِ صفر.
+
 **تنظیمات per-doctor در کلینیک چندپزشکه:** درصد و شرایط هر بیمه می‌تواند برای هر پزشک متفاوت باشد. همهٔ اندپوینت‌های زیر یک پارامتر اختیاری `doctor_uuid` می‌پذیرند (در `GET`/`DELETE` از query، در `POST`/`PATCH`/`PUT` از بدنه). با آن، قرارداد به‌جای موجودیتِ tenantِ کاربر جاری، به‌ازای پزشک هدف (`entity_type='doctor'`) خوانده/نوشته می‌شود — دقیقاً مثل `insurance-pricing`. **بدون** آن، رفتار قبلی (tenant کاربر جاری) دست‌نخورده می‌ماند (سازگاری عقب‌رو). دسترسی با `doctor_uuid` هم مثل `insurance-pricing` بررسی می‌شود: `ROLE_ADMIN`، خودِ پزشک، یا کاربرِ عضو/مالکِ کلینیکِ آن پزشک با مجوز `services.view` (برای نوشتن `services.update`)؛ در غیر این صورت `403 ERR_ACCESS_DENIED`، و پزشکِ ناموجود `404 ERR_NOT_FOUND_001`.
 
 ### GET `/api/v1/billing/tenant-insurances`
 لیست قراردادهای tenant جاری — **آخرین نسخهٔ هر بیمه، فعال یا غیرفعال** (برای toggle فعال/غیرفعال در UI مدیریت بیمه). `insurance_kind` = `kind` قرارداد در صورت تعیین، وگرنه نوع بیمه از کاتالوگ.
 
+> پارامتر `inherit=1` همان قاعدهٔ محدودهٔ بیمه را اعمال می‌کند: اول قراردادهای خودِ پزشک، و اگر پزشک هیچ قراردادی نداشته باشد قراردادهای کلینیکی که کاربر در آن ایستاده. بدون این پارامتر، پاسخ دقیقاً همان محیطِ هدف است — چیزی که صفحهٔ تنظیمات برای ویرایش لازم دارد.
+
+
 **Query:** `doctor_uuid` (اختیاری) — قراردادهای همان پزشک را برمی‌گرداند (نگاه کنید به «تنظیمات per-doctor» بالا).
 
 **Permission:** `AUTH` (doctor/clinic)

docs/api/payment.md

@@ -131,6 +131,12 @@ List the **authenticated user's own** payments (derived from the token — there
 
 **Permission:** `IS_AUTHENTICATED_FULLY`
 
+> **فیلتر محیط اینجا اعمال نمی‌شود.** رکورد در محیطِ پزشکِ مقصد ثبت می‌شود، ولی
+> مالکش از راه `user_id` تعیین می‌شود. کاربری که خودش صاحب محیط دیگری است — پزشک،
+> منشی، مالک کلینیک — با فیلترِ محیطِ خودش رکورد خودش را نمی‌دید و ۴۰۴ می‌گرفت.
+> دورزدن فیلتر فقط از راه `App\Shared\Tenant\TenantFilterScope` انجام می‌شود و
+> مجوز دست‌نخورده باقی می‌ماند.
+
 ### Query Parameters
 | Param | Type | Default | Description |
 |-------|------|---------|-------------|
@@ -405,6 +411,12 @@ Get payment status and details.
 
 **Permission:** `AUTH` — must be the payment owner or `ROLE_ADMIN`
 
+> **فیلتر محیط اینجا اعمال نمی‌شود.** رکورد در محیطِ پزشکِ مقصد ثبت می‌شود، ولی
+> مالکش از راه `user_id` تعیین می‌شود. کاربری که خودش صاحب محیط دیگری است — پزشک،
+> منشی، مالک کلینیک — با فیلترِ محیطِ خودش رکورد خودش را نمی‌دید و ۴۰۴ می‌گرفت.
+> دورزدن فیلتر فقط از راه `App\Shared\Tenant\TenantFilterScope` انجام می‌شود و
+> مجوز دست‌نخورده باقی می‌ماند.
+
 ### Path Parameters
 | Param | Type | Description |
 |-------|------|-------------|

docs/api/representation.md

@@ -165,6 +165,8 @@ Delete a representation.
 
 Get monthly earnings dashboard for a representation.
 
+`total_appointments` فقط نوبت‌های **آنلاین** را می‌شمارد — یعنی نوبت‌هایی که از سایتِ همین نماینده رزرو شده‌اند (`appointments.booking_representation_id` برابر همین نماینده). نوبتی که منشی در پنل ثبت می‌کند از سایت نیامده و در آمار نماینده نمی‌آید.
+
 **Permission:** `AUTH` — must be the representation's user or `ROLE_ADMIN`
 
 ### Path Parameters
@@ -264,15 +266,33 @@ Get yearly earnings dashboard for a representation.
 ## قانون کمیسیون دامنه‌محور
 
 کمیسیون (نوبت **و** اشتراک) فقط وقتی ثبت می‌شود که **هر دو** شرط برقرار باشد:
-1. دامنه‌ی مبدأ خرید (`payment.frontend_address`) متعلق به یک نماینده‌ی فعال باشد (`representations.domain`).
+1. دامنه‌ی مبدأ خرید (`payment.frontend_address`) به یک نماینده‌ی فعال برسد.
 2. پزشک/کلینیکِ موضوع خرید، `representation_id` همان نماینده را داشته باشد.
 
+دامنه به نماینده به این ترتیب می‌رسد:
+
+- نماینده‌ای که همان دامنه را در `representations.domain` ثبت کرده (نماینده‌ی سراسری).
+- وگرنه اگر دامنه، دامنه‌ی یک شهر باشد (`cities.domain`)، نماینده‌ی فعالِ همان شهر از `representation_cities`.
+
+اگر دو نماینده‌ی فعال یک شهر را پوشش دهند، نماینده‌ای انتخاب نمی‌شود: انتساب پول مبهم است و باید در داده صریح شود.
+
 در غیر این صورت هیچ کمیسیونی برای هیچ نماینده‌ای ثبت نمی‌شود (پرداخت بدون `frontend_address` هم کمیسیون ندارد). درصد: نوبت = `commission_percent` نماینده؛ اشتراک = تنظیم سراسری `upgrade_commission_percent`. نگاشت دامنه فقط از طریق `DomainContextResolver` انجام می‌شود.
 
+**زمان ثبت:** کمیسیون نوبت در لحظه‌ی **پرداخت موفق** ثبت می‌شود، نه در لحظه‌ی تأیید نوبت. نوبتِ `pending` هم کمیسیون دارد؛ تأیید کارِ پزشک/منشی است و ممکن است هرگز انجام نشود. ثبت idempotent است و مسیر تأیید دوباره چیزی نمی‌سازد.
+
 ---
 
 ## پنل نماینده (ROLE_REPRESENTATION)
 
+> **شمارش نوبت:** `dashboard/summary` و `doctors/performance` هم فقط نوبت‌های آنلاینِ همین نماینده را می‌شمارند (`appointments.booking_representation_id`). نوبتی که منشی در پنل ثبت می‌کند شمرده نمی‌شود. ستون درآمدِ هر پزشک هم فقط سهم همین نماینده است، نه سهم نمایندگان قبلیِ آن پزشک.
+>
+> **بازسازی گذشته:** نوبت‌های آنلاینی که پیش از نگاشت دامنه‌ی شهری پرداخت شده‌اند نه `booking_representation_id` دارند و نه ردیف `FinancialBreakdown`. دستور زیر هر دو را از روی `payments.frontend_address` می‌سازد؛ بدون `--force` فقط گزارش می‌دهد و تاریخ ردیف مالی روی لحظه‌ی پرداخت می‌نشیند، نه لحظه‌ی اجرا:
+>
+> ```
+> php bin/console app:representation:backfill-online-commission [--force]
+> ```
+
+
 این endpointها برای کاربرِ دارای نقش `ROLE_REPRESENTATION` در پنل ادمین (`/admin`) هستند. مالکیت همیشه از کاربر جاری (`#[CurrentUser]` + `findByUser`) تعیین می‌شود؛ هیچ uuid/id ورودی برای تعیین مالکیت پذیرفته نمی‌شود.
 
 > **Permission (همه‌ی این بخش):** `ROLE_REPRESENTATION`

docs/api/subscription.md

@@ -82,7 +82,13 @@
 
 **Permission:** `IS_AUTHENTICATED_FULLY`
 
-**نکته:** از نسخه فعلی، این endpoint برای `ROLE_SECRETARY` نیز کار می‌کند. منشی از طریق `UserActiveContextRepository` به `db_uuid` entity مربوطه (doctor یا clinic) دسترسی پیدا می‌کند و اشتراک همان entity برگردانده می‌شود.
+**محیط اشتراک:** همان محیطی که کاربر **صاحبش** است، از `EntityContextResolver::ownedEntity()` — همان مرجعی که خرید اشتراک هم استفاده می‌کند، تا نمایش و پرداخت و اعطای ادمین روی یک محیط بنشینند.
+
+کاربری که هم پزشک است و هم مالک کلینیک، دو محیط صاحب‌شده دارد. آنجا محیط فعال
+(`UserActiveContext`) تعیین می‌کند اشتراک کدام‌یک خوانده شود. بدون محیط فعال، مطب
+شخصی پیش‌فرض است.
+
+**نکته:** این endpoint برای `ROLE_SECRETARY` هم کار می‌کند. منشی محیط صاحب‌شده ندارد، پس محیط فعالش خوانده می‌شود و اشتراک همان entity برمی‌گردد.
 
 **Response 200:**
 ```json
@@ -340,6 +346,35 @@ callback مشترک همهٔ درگاه‌ها و همهٔ نوع‌های پر
 > پلن. پس اعطای پلنی پایین‌تر از پلن فعال، عملاً پلن مؤثر مقصد را کاهش می‌دهد. پنل
 > ادمین قبل از ثبت این حالت تأیید می‌گیرد؛ خودِ endpoint جلوی آن را نمی‌گیرد.
 
+### DELETE /api/v1/admin/subscription/{uuid}
+**Permission:** `ROLE_ADMIN` — حذف اشتراک، برای برگرداندن اعطای اشتباه
+
+`uuid` همان `uuid` ردیف گزارش است. حذف سخت است، نه soft delete: رکورد از
+`clinic_subscriptions` پاک می‌شود و پلن مؤثر مقصد به اشتراک فعال بعدی یا به `free`
+برمی‌گردد.
+
+اشتراکِ متصل به پرداخت حذف نمی‌شود. سند مالی‌اش باید بماند و مسیر درست آن استرداد
+وجه است.
+
+**Response 200**
+
+```json
+{
+  "success": true,
+  "data": null
+}
+```
+
+| وضعیت | کد | حالت |
+|-------|----|------|
+| 404 | ERR_SUBSCRIPTION_NOT_FOUND | uuid یافت نشد |
+| 409 | ERR_CONFLICT_001 | اشتراک به پرداخت متصل است |
+| 401 | ERR_AUTH_001 | بدون توکن |
+| 403 | — | توکن معتبر ولی بدون `ROLE_ADMIN` |
+
+> مسیر `DELETE /api/v1/admin/subscription/period/{uuid}` جداست و دورهٔ پلن را
+> غیرفعال می‌کند، نه اشتراکِ یک مقصد را.
+
 ### GET /api/v1/admin/subscription/active/{entityType}/{entityUuid}
 **Permission:** `ROLE_ADMIN` — اشتراک فعالِ یک مقصد، برای نمایش پیش از اعطا
 

docs/architecture/tenancy.md

@@ -76,6 +76,30 @@ clinic_uuid صریحِ درخواست  >  UserActiveContext ذخیره‌شده
 | SQL خام DBAL | ❌ |
 | فرزندان aggregate | ❌ — همیشه از ریشه JOIN کن |
 
+### استثنای مجاز: دادهٔ «مالِ خودِ کاربر»
+
+چند رکورد در محیطِ یک مطب ثبت می‌شوند ولی مالکشان بیمار است، نه آن مطب: پرداختِ نوبت و
+خودِ نوبتِ بیمار. مجوزشان با `user_id` بررسی می‌شود، نه با محیط.
+
+اینجا فیلتر چیزی به امنیت اضافه نمی‌کند و فقط ضرر می‌زند: کاربری که خودش صاحب محیط
+دیگری است — پزشکی که از مطب دیگری نوبت می‌گیرد، منشی‌ای که جایی بیمار است — رکورد
+خودش را نمی‌دید و صفحهٔ نتیجهٔ پرداخت ۴۰۴ می‌شد.
+
+تنها راه مجاز دورزدن، `App\Shared\Tenant\TenantFilterScope::withoutFilter()` است.
+عمداً یک کلاس جداست تا جاهای دورزدن قابل شمردن بمانند، و فیلتر را در `finally`
+برمی‌گرداند تا بقیهٔ همان درخواست دوباره محدود شود.
+
+مصرف‌کنندگان فعلی — هر سه کاربرمحور، نه محیط‌محور:
+
+| اندپوینت | چرا |
+|---|---|
+| `GET /api/v1/payment/{uuid}` | پرداخت‌کننده باید پرداخت خودش را ببیند |
+| `GET /api/v1/my/payments` | همان، به شکل فهرست |
+| `GET /api/v1/appointments/user` | نوبت‌های خودِ فرد به‌عنوان بیمار |
+
+`PayerSeesOwnPaymentTest` هر سه را می‌بندد و هم‌زمان تأیید می‌کند که پرداختِ کاربر
+دیگر همچنان ۴۰۳ می‌گیرد.
+
 **فیلتر جایگزین authorization نیست.** `AppointmentAccessChecker`، `ClinicDoctorAccessChecker`، `SecretaryAccessChecker` و `PatientRecordScopeResolver` سر جایشان می‌مانند: آن‌ها «چه کاری مجاز است» را جواب می‌دهند، فیلتر فقط «کدام ردیف‌ها».
 
 ### تغییر رفتار: ۴۰۴ به‌جای ۴۰۳

graphify-out/.graphify_labels.json

@@ -1535,5 +1535,42 @@
   "1533": "Community 1533",
   "1534": "Community 1534",
   "1535": "Community 1535",
-  "1536": "Community 1536"
+  "1536": "Community 1536",
+  "1537": "Community 1537",
+  "1538": "Community 1538",
+  "1539": "Community 1539",
+  "1540": "Community 1540",
+  "1541": "Community 1541",
+  "1542": "Community 1542",
+  "1543": "Community 1543",
+  "1544": "Community 1544",
+  "1545": "Community 1545",
+  "1546": "Community 1546",
+  "1547": "Community 1547",
+  "1548": "Community 1548",
+  "1549": "Community 1549",
+  "1550": "Community 1550",
+  "1551": "Community 1551",
+  "1552": "Community 1552",
+  "1553": "Community 1553",
+  "1554": "Community 1554",
+  "1555": "Community 1555",
+  "1556": "Community 1556",
+  "1557": "Community 1557",
+  "1558": "Community 1558",
+  "1559": "Community 1559",
+  "1560": "Community 1560",
+  "1561": "Community 1561",
+  "1562": "Community 1562",
+  "1563": "Community 1563",
+  "1564": "Community 1564",
+  "1565": "Community 1565",
+  "1566": "Community 1566",
+  "1567": "Community 1567",
+  "1568": "Community 1568",
+  "1569": "Community 1569",
+  "1570": "Community 1570",
+  "1571": "Community 1571",
+  "1572": "Community 1572",
+  "1573": "Community 1573"
 }

graphify-out/cache/ast/v0.8.44/195240742225d313c07f80af50def2c3de9f29a94bca71d0a8d76c619a7d9f91.json

@@ -0,0 +1 @@
+{"nodes": [{"id": "users_hamed_pj_my_pj_clinic_pro_clinicpro_config_reference_php", "label": "reference.php", "file_type": "code", "source_file": "config/reference.php", "source_location": "L1"}, {"id": "config_reference_app", "label": "App", "file_type": "code", "source_file": "config/reference.php", "source_location": "L1571"}, {"id": "config_reference_app_config", "label": ".config()", "file_type": "code", "source_file": "config/reference.php", "source_location": "L1578"}, {"id": "config_reference_routes", "label": "Routes", "file_type": "code", "source_file": "config/reference.php", "source_location": "L1651"}, {"id": "config_reference_routes_config", "label": ".config()", "file_type": "code", "source_file": "config/reference.php", "source_location": "L1658"}], "edges": [{"source": "users_hamed_pj_my_pj_clinic_pro_clinicpro_config_reference_php", "target": "paramconfigurator", "relation": "imports", "context": "import", "confidence": "EXTRACTED", "source_file": "config/reference.php", "source_location": "L7", "weight": 1.0}, {"source": "users_hamed_pj_my_pj_clinic_pro_clinicpro_config_reference_php", "target": "config_reference_app", "relation": "contains", "confidence": "EXTRACTED", "source_file": "config/reference.php", "source_location": "L1571", "weight": 1.0}, {"source": "config_reference_app", "target": "config_reference_app_config", "relation": "method", "confidence": "EXTRACTED", "source_file": "config/reference.php", "source_location": "L1578", "weight": 1.0}, {"source": "users_hamed_pj_my_pj_clinic_pro_clinicpro_config_reference_php", "target": "config_reference_routes", "relation": "contains", "confidence": "EXTRACTED", "source_file": "config/reference.php", "source_location": "L1651", "weight": 1.0}, {"source": "config_reference_routes", "target": "config_reference_routes_config", "relation": "method", "confidence": "EXTRACTED", "source_file": "config/reference.php", "source_location": "L1658", "weight": 1.0}], "raw_calls": [{"caller_nid": "config_reference_app_config", "callee": "AppReference", "is_member_call": false, "source_file": "/Users/hamed/pj/my_pj/clinic_pro/clinicpro/config/reference.php", "source_location": "L1581", "receiver": null}]}

graphify-out/cache/ast/v0.8.44/5269c6ae2cfc8b64da735ba3bd4a8533e81b102e0a3bc6a104bcf617fed6d089.json

@@ -0,0 +1 @@
+{"nodes": [{"id": "users_hamed_pj_my_pj_clinic_pro_clinicpro_src_shared_landing_landingregistry_php", "label": "LandingRegistry.php", "file_type": "code", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L1"}, {"id": "landing_landingregistry_landingregistry", "label": "LandingRegistry", "file_type": "code", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L11"}, {"id": "landing_landingregistry_landingregistry_all", "label": ".all()", "file_type": "code", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L45"}, {"id": "landing_landingregistry_landingregistry_featured", "label": ".featured()", "file_type": "code", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L51"}, {"id": "landing_landingregistry_landingregistry_find", "label": ".find()", "file_type": "code", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L59"}, {"id": "landingpage", "label": "LandingPage", "file_type": "code", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L59"}, {"id": "landing_landingregistry_landingregistry_build", "label": ".build()", "file_type": "code", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L65"}], "edges": [{"source": "users_hamed_pj_my_pj_clinic_pro_clinicpro_src_shared_landing_landingregistry_php", "target": "landing_landingregistry_landingregistry", "relation": "contains", "confidence": "EXTRACTED", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L11", "weight": 1.0}, {"source": "landing_landingregistry_landingregistry", "target": "landing_landingregistry_landingregistry_all", "relation": "method", "confidence": "EXTRACTED", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L45", "weight": 1.0}, {"source": "landing_landingregistry_landingregistry", "target": "landing_landingregistry_landingregistry_featured", "relation": "method", "confidence": "EXTRACTED", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L51", "weight": 1.0}, {"source": "landing_landingregistry_landingregistry", "target": "landing_landingregistry_landingregistry_find", "relation": "method", "confidence": "EXTRACTED", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L59", "weight": 1.0}, {"source": "landing_landingregistry_landingregistry_find", "target": "landingpage", "relation": "references", "confidence": "EXTRACTED", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L59", "weight": 1.0, "context": "return_type"}, {"source": "landing_landingregistry_landingregistry", "target": "landing_landingregistry_landingregistry_build", "relation": "method", "confidence": "EXTRACTED", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L65", "weight": 1.0}, {"source": "landing_landingregistry_landingregistry_all", "target": "landing_landingregistry_landingregistry_build", "relation": "calls", "context": "call", "confidence": "EXTRACTED", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L47", "weight": 1.0}, {"source": "landing_landingregistry_landingregistry_featured", "target": "landing_landingregistry_landingregistry_find", "relation": "calls", "context": "call", "confidence": "EXTRACTED", "source_file": "src/Shared/Landing/LandingRegistry.php", "source_location": "L54", "weight": 1.0}], "raw_calls": [{"caller_nid": "landing_landingregistry_landingregistry_featured", "callee": "array_values", "is_member_call": false, "source_file": "/Users/hamed/pj/my_pj/clinic_pro/clinicpro/src/Shared/Landing/LandingRegistry.php", "source_location": "L53", "receiver": null}, {"caller_nid": "landing_landingregistry_landingregistry_featured", "callee": "array_filter", "is_member_call": false, "source_file": "/Users/hamed/pj/my_pj/clinic_pro/clinicpro/src/Shared/Landing/LandingRegistry.php", "source_location": "L53", "receiver": null}, {"caller_nid": "landing_landingregistry_landingregistry_featured", "callee": "array_map", "is_member_call": false, "source_file": "/Users/hamed/pj/my_pj/clinic_pro/clinicpro/src/Shared/Landing/LandingRegistry.php", "source_location": "L53", "receiver": null}, {"caller_nid": "landing_landingregistry_landingregistry_build", "callee": "array_column", "is_member_call": false, "source_file": "/Users/hamed/pj/my_pj/clinic_pro/clinicpro/src/Shared/Landing/LandingRegistry.php", "source_location": "L415", "receiver": null}, {"caller_nid": "landing_landingregistry_landingregistry_build", "callee": "array_map", "is_member_call": false, "source_file": "/Users/hamed/pj/my_pj/clinic_pro/clinicpro/src/Shared/Landing/LandingRegistry.php", "source_location": "L416", "receiver": null}]}