Address wallet feedback: use the clinic's real payment infrastructure,
redesign the tab to match the admin panel, and make every wallet movement
fully auditable.
Backend:
- WalletTransaction: add createdBy (acting user) + createdByName, payment_method,
reference, status; toArray exposes them (migration Version20260716083939).
- WalletService (Settlement): balance/charge/withdraw + settleSessionFromWallet,
records actor/method/reason; insufficient balance throws ERR_WALLET_INSUFFICIENT.
- PatientController: charge/withdraw delegate to WalletService and accept
payment_method/reference; PATCH /session/{uuid} with payment_method=wallet
debits the patient's final share from the wallet (reference=session:{uuid}).
- docs/api/patient.md updated.
Frontend:
- Wallet modal redesigned to panel style (no gradient); payment method now uses
the clinic's real bank accounts + POS devices (usePaymentMethods) plus cash.
- Wallet tab: panel balance card + DataTable ledger with columns مبلغ/نوع/روش/
دلیل/ثبتکننده/تاریخ/ساعت/وضعیت + همه/واریزی/برداشت filters.
- Session card «تکمیل پرداخت» opens a payment-method chooser incl. کیف پول.
Tests: backend transparency + session-from-wallet (success/insufficient/cash);
frontend modal (real methods, toman→rials) + wallet tab + settle chooser.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
249 lines
13 KiB
TypeScript
249 lines
13 KiB
TypeScript
import { describe, it, expect, beforeEach, vi } from 'vitest';
|
|
import { screen, fireEvent, waitFor } from '@testing-library/react';
|
|
import { Routes, Route } from 'react-router-dom';
|
|
import { renderWithProviders } from '../test/utils';
|
|
|
|
vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));
|
|
vi.mock('../lib/api', () => ({
|
|
api: { get: vi.fn(), post: vi.fn(), patch: vi.fn(), put: vi.fn(), delete: vi.fn() },
|
|
ApiError: class extends Error {},
|
|
}));
|
|
|
|
import { api } from '../lib/api';
|
|
import PatientDetailPage from './PatientDetailPage';
|
|
|
|
const get = api.get as ReturnType<typeof vi.fn>;
|
|
|
|
beforeEach(() => {
|
|
get.mockReset();
|
|
get.mockImplementation((url: string) => {
|
|
if (url === '/api/v1/patient/r1') return Promise.resolve({ success: true, data: {
|
|
uuid: 'r1', user_name: 'ساغر صابری', record_number: 'P-1001', created_at: 1700000000,
|
|
user_mobile: '09120000000', user_national_code: '1234567890', tags: [],
|
|
profile: {
|
|
name: 'ساغر صابری', national_code: '1234567890', mobile: '09120000000',
|
|
gender: 'female', fathers_name: 'رضا', job: 'مهندس',
|
|
referral_source: 'اینستاگرام', address: 'یزد', description: 'یادداشت',
|
|
},
|
|
} });
|
|
if (url === '/api/v1/provinces') return Promise.resolve({ success: true, data: [{ id: 10, name: 'یزد' }] });
|
|
if (url.startsWith('/api/v1/cities')) return Promise.resolve({ success: true, data: [{ id: 100, name: 'یزد' }] });
|
|
if (url === '/api/v1/insurance-pricing') return Promise.resolve({ success: true, data: {
|
|
insurances: [
|
|
{ insurance_id: 1, insurance_name: 'تأمین اجتماعی', type: 'basic' },
|
|
{ insurance_id: 5, insurance_name: 'بیمه دانا', type: 'supplementary' },
|
|
],
|
|
} });
|
|
if (url === '/api/v1/patient/r1/sessions') return Promise.resolve({ success: true, data: [
|
|
{ uuid: 's1', services: [{ service_name: 'اسکیلینگ' }], doctor_name: 'دکتر فتحی', final_price_rials: 2500000, is_paid: false, patient_debt_rials: 1500000, notes: 'یادداشت', created_at: 1700000000, visit_price_rials: 0 },
|
|
{ uuid: 's2', services: [{ service_name: 'روکش' }], doctor_name: 'دکتر فتحی', final_price_rials: 2350000, is_paid: true, patient_debt_rials: 0, invoice_uuid: 'iv1', created_at: 1700000000, visit_price_rials: 0 },
|
|
], meta: { totalRecords: 2 } });
|
|
if (url === '/api/v1/billing/invoices/iv1') return Promise.resolve({ success: true, data: { data: {
|
|
uuid: 'iv1', status: 'paid', issued_at: 1700000000, total_rials: 2350000,
|
|
base_insurance_rials: 0, supplementary_rials: 0, patient_rials: 2350000,
|
|
items: [{ uuid: 'it1', title: 'روکش', quantity: 1, total_rials: 2350000, patient_rials: 2350000 }],
|
|
} } });
|
|
if (url === '/api/v1/patient/r1/payments') return Promise.resolve({ success: true, data: [
|
|
{ uuid: 'p1', amount_rials: 250000, status: 'success', gateway: 'mellat', created_at: 1700000000 },
|
|
], meta: { totalRecords: 1 } });
|
|
if (url === '/api/v1/patient/r1/wallet') return Promise.resolve({ success: true, data: {
|
|
balance_rials: 300000,
|
|
recent_transactions: [{ uuid: 't1', amount_rials: 500000, type: 'credit', description: 'شارژ', balance_after: 300000, created_at: 1700000000 }],
|
|
} });
|
|
return Promise.resolve({ success: true, data: [] });
|
|
});
|
|
});
|
|
|
|
function renderDetail() {
|
|
return renderWithProviders(
|
|
<Routes>
|
|
<Route path="/admin/patients/:uuid" element={<PatientDetailPage />} />
|
|
</Routes>,
|
|
{ route: '/admin/patients/r1' },
|
|
);
|
|
}
|
|
|
|
// name now appears in both breadcrumb and banner
|
|
const loaded = async () => (await screen.findAllByText('ساغر صابری'))[0];
|
|
|
|
describe('PatientDetailPage (پرونده تبدار)', () => {
|
|
it('renders the banner and tab bar', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
expect(screen.getByText('شماره پرونده: P-1001')).toBeInTheDocument(); // banner
|
|
expect(screen.getByText('سرویسها')).toBeInTheDocument();
|
|
expect(screen.getByText('پرونده پزشکی')).toBeInTheDocument();
|
|
});
|
|
|
|
it('renders full-width (no boxed max-width wrapper, matching tauri FilesServices)', async () => {
|
|
const { container } = renderDetail();
|
|
await loaded();
|
|
const root = container.querySelector('.fade-in') as HTMLElement;
|
|
expect(root).toBeTruthy();
|
|
expect(root.style.maxWidth).toBe('');
|
|
});
|
|
|
|
it('renders session (مراجعه) cards on the default services tab', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
expect(await screen.findByText('اسکیلینگ')).toBeInTheDocument();
|
|
expect(screen.getAllByText('دکتر فتحی').length).toBe(2);
|
|
expect(screen.getByText('تکمیل پرداخت')).toBeInTheDocument(); // unpaid card
|
|
expect(screen.getByText('مشاهده فاکتور')).toBeInTheDocument(); // paid card
|
|
});
|
|
|
|
it('opens the invoice summary on «مشاهده فاکتور»', async () => {
|
|
renderDetail();
|
|
await screen.findByText('مشاهده فاکتور');
|
|
fireEvent.click(screen.getByText('مشاهده فاکتور'));
|
|
expect(await screen.findByText('خلاصه فاکتور')).toBeInTheDocument();
|
|
expect(await screen.findByText('اطلاعات فاکتور')).toBeInTheDocument();
|
|
});
|
|
|
|
it('renders the editable «اطلاعات پرونده» form prefilled from the profile', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('اطلاعات پرونده'));
|
|
// لیبل فیلدهای فرم (معادل tauri FileInfoSection)
|
|
expect(await screen.findByText('نام و نام خانوادگی مراجعه کننده')).toBeInTheDocument();
|
|
expect(screen.getByText('کدملی')).toBeInTheDocument();
|
|
expect(screen.getByText('بیمه پایه')).toBeInTheDocument();
|
|
expect(screen.getByText('بیمه تکمیلی')).toBeInTheDocument();
|
|
// مقادیر پیشپرشده از پروفایل
|
|
expect(screen.getByDisplayValue('1234567890')).toBeInTheDocument();
|
|
expect(screen.getByDisplayValue('ساغر صابری')).toBeInTheDocument();
|
|
expect(screen.getByDisplayValue('P-1001')).toBeInTheDocument(); // شماره پرونده readonly
|
|
// دکمهٔ ثبت
|
|
expect(screen.getByRole('button', { name: 'ثبت اطلاعات' })).toBeInTheDocument();
|
|
});
|
|
|
|
it('renders the info form with placeholders when the profile is empty', async () => {
|
|
get.mockImplementation((url: string) => {
|
|
if (url === '/api/v1/patient/r1') return Promise.resolve({ success: true, data: {
|
|
uuid: 'r1', user_name: 'بدون پروفایل', record_number: 'P-9', created_at: 1700000000, profile: null,
|
|
} });
|
|
return Promise.resolve({ success: true, data: [] });
|
|
});
|
|
renderDetail();
|
|
fireEvent.click(await screen.findByText('اطلاعات پرونده'));
|
|
expect(await screen.findByPlaceholderText('نام و نام خانوادگی')).toBeInTheDocument();
|
|
expect(screen.getByRole('button', { name: 'ثبت اطلاعات' })).toBeInTheDocument();
|
|
});
|
|
|
|
it('renders the call-center tab with a register form and history', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('کال سنتر'));
|
|
expect(await screen.findByText('ثبت تماس جدید')).toBeInTheDocument();
|
|
expect(screen.getByText('تاریخچه تماسها')).toBeInTheDocument();
|
|
expect(await screen.findByText('تماسی ثبت نشده است.')).toBeInTheDocument();
|
|
});
|
|
|
|
it('links "سرویس جدید" on the services tab to the new-session route', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
const link = await screen.findByRole('link', { name: /سرویس جدید/ });
|
|
expect(link).toHaveAttribute('href', '/admin/patients/r1/session/new');
|
|
});
|
|
|
|
it('groups payments by مراجعه (session) accordions on the پرداختها tab', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('پرداختها'));
|
|
// settlement badges from the two seeded sessions (s1 unpaid, s2 paid)
|
|
expect(await screen.findByText('پرداخت شده')).toBeInTheDocument();
|
|
expect(screen.getByText('تسویه نشده')).toBeInTheDocument();
|
|
expect(screen.getByText('روکش')).toBeInTheDocument(); // paid session header
|
|
// first (unpaid) panel is open by default → empty settlement message
|
|
expect(screen.getByText('هیچ پرداختی ثبت نشده است.')).toBeInTheDocument();
|
|
});
|
|
|
|
it('shows wallet balance, charge button and transaction filters on the wallet tab', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('کیف پول'));
|
|
expect(await screen.findByText('موجودی کیف پول')).toBeInTheDocument();
|
|
expect(screen.getByRole('button', { name: /شارژ کیف پول/ })).toBeInTheDocument();
|
|
// فیلترهای تراکنش
|
|
expect(screen.getByRole('button', { name: 'همه' })).toBeInTheDocument();
|
|
expect(screen.getByRole('button', { name: 'واریزی' })).toBeInTheDocument();
|
|
expect(screen.getByRole('button', { name: 'برداشت' })).toBeInTheDocument();
|
|
// تراکنش credit اولیه دیده میشود (سطر جدول async لود میشود)
|
|
expect(await screen.findByText('شارژ')).toBeInTheDocument();
|
|
});
|
|
|
|
it('filters out the credit transaction when the برداشت filter is selected', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('کیف پول'));
|
|
await screen.findByText('موجودی کیف پول');
|
|
fireEvent.click(screen.getByRole('button', { name: 'برداشت' }));
|
|
expect(screen.getByText('تراکنشی ثبت نشده است')).toBeInTheDocument();
|
|
});
|
|
|
|
it('opens the charge/withdraw modal and posts a charge', async () => {
|
|
const post = api.post as ReturnType<typeof vi.fn>;
|
|
post.mockResolvedValue({ success: true, data: {} });
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('کیف پول'));
|
|
await screen.findByText('موجودی کیف پول');
|
|
fireEvent.click(screen.getByRole('button', { name: /شارژ کیف پول/ }));
|
|
// مودال باز شد → تب برداشت هم دیده میشود
|
|
expect(await screen.findByRole('button', { name: 'برداشت از کیف پول' })).toBeInTheDocument();
|
|
fireEvent.change(screen.getByPlaceholderText('مبلغ دلخواه (تومان)'), { target: { value: '50000' } });
|
|
fireEvent.click(screen.getByRole('button', { name: 'ثبت تراکنش' }));
|
|
await waitFor(() => expect(post).toHaveBeenCalledWith('/api/v1/patient/r1/wallet/charge', { amount_rials: 500000, payment_method: 'cash' }));
|
|
});
|
|
|
|
it('settles a session from the wallet via the payment-method chooser', async () => {
|
|
const patch = api.patch as ReturnType<typeof vi.fn>;
|
|
patch.mockResolvedValue({ success: true, data: {} });
|
|
renderDetail();
|
|
await loaded();
|
|
// تب سرویسها پیشفرض است؛ کارت پرداختنشده → «تکمیل پرداخت»
|
|
fireEvent.click(await screen.findByText('تکمیل پرداخت'));
|
|
expect(await screen.findByText('روش پرداخت مراجعه')).toBeInTheDocument();
|
|
fireEvent.click(screen.getByRole('button', { name: 'کیف پول بیمار' }));
|
|
await waitFor(() => expect(patch).toHaveBeenCalledWith('/api/v1/session/s1', { payment_method: 'wallet' }));
|
|
});
|
|
|
|
it('renders the messages tab with a send box', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('پیامها'));
|
|
expect(await screen.findByPlaceholderText('متن پیام...')).toBeInTheDocument();
|
|
expect(screen.getByRole('button', { name: 'ارسال' })).toBeInTheDocument();
|
|
});
|
|
|
|
it('renders appointment turn cards + toolbar on the نوبتها tab', async () => {
|
|
get.mockImplementation((url: string) => {
|
|
if (url === '/api/v1/patient/r1') return Promise.resolve({ success: true, data: {
|
|
uuid: 'r1', user_name: 'ساغر صابری', record_number: 'P-1001', created_at: 1700000000, profile: null,
|
|
} });
|
|
if (url === '/api/v1/patient/r1/appointments') return Promise.resolve({ success: true, data: [
|
|
{ uuid: 'a1', starts_at: 1754000000, ends_at: 1754001800, status: 'confirmed', version: 1, doctor_name: 'دکتر راد', service_name: null },
|
|
] });
|
|
return Promise.resolve({ success: true, data: [] });
|
|
});
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('نوبتها'));
|
|
// card: generic title + doctor + live status label (confirmed → قطعی شده)
|
|
expect(await screen.findByText('دکتر راد')).toBeInTheDocument();
|
|
expect(screen.getByText('قطعی شده')).toBeInTheDocument();
|
|
expect(screen.getByText('تاریخ:')).toBeInTheDocument();
|
|
expect(screen.getByText('ساعت:')).toBeInTheDocument();
|
|
// toolbar buttons link to the existing appointment pages
|
|
expect(screen.getByRole('link', { name: /نوبت رزرو/ })).toHaveAttribute('href', '/admin/appointments/reserve');
|
|
expect(screen.getByRole('link', { name: /نوبت جدید/ })).toHaveAttribute('href', '/admin/appointments/new');
|
|
});
|
|
|
|
it('shows the empty state on the نوبتها tab when there are no appointments', async () => {
|
|
renderDetail();
|
|
await loaded();
|
|
fireEvent.click(screen.getByText('نوبتها'));
|
|
expect(await screen.findByText('نوبتی ثبت نشده است')).toBeInTheDocument();
|
|
});
|
|
});
|