Add per-clinic payment methods (bank accounts + POS/card-reader devices)
under the "مدیریت پرداخت" settings tab at /admin/my-financial, ported from
clinic-pro-tauri's mock-only PaymentManagement tab into a real persisted
feature. These records are referenceable (by uuid) from patient invoices to
record which method a service payment was made with.
Backend (new src/PaymentMethod domain):
- BankAccount + Pos entities, repositories, PaymentMethodService (validation,
ownership scoping, create/update/toggle logic).
- Thin PaymentMethodController exposing /api/v1/my/payment-methods/{bank-accounts,pos}
(GET/POST/PUT + PATCH .../status), guarded to clinic/doctor/secretary/admin.
- Migration for bank_accounts + pos_devices tables.
- Functional tests (success + validation/404/403 + empty boundaries).
- docs/api/payment-method.md.
Frontend:
- Replace MyFinancialPage content with the payment-management UI (two tabs,
tables, add/edit modals, status toggle) using the admin design system.
- usePaymentMethods hook (TanStack Query) + presentational components.
- Update page test to cover tabs, data, empty state and the add modal.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
95 lines
3.6 KiB
TypeScript
95 lines
3.6 KiB
TypeScript
import React, { useState } from 'react';
|
|
import { toast } from 'sonner';
|
|
import SettingsLayout from '../components/layout/SettingsLayout';
|
|
import PageHeader from '../components/ui/PageHeader';
|
|
import PaymentMethodHead, { type PaymentTab } from '../components/paymentMethods/PaymentMethodHead';
|
|
import BankAccountTable from '../components/paymentMethods/BankAccountTable';
|
|
import PosTable from '../components/paymentMethods/PosTable';
|
|
import BankAccountFormModal from '../components/paymentMethods/BankAccountFormModal';
|
|
import PosFormModal from '../components/paymentMethods/PosFormModal';
|
|
import {
|
|
useBankAccounts,
|
|
usePosDevices,
|
|
useToggleBankAccountStatus,
|
|
useTogglePosStatus,
|
|
type BankAccount,
|
|
type Pos,
|
|
} from '../hooks/usePaymentMethods';
|
|
|
|
/**
|
|
* صفحهٔ «مدیریت پرداخت» (/admin/my-financial) — پورت تب PaymentManagement از
|
|
* clinic-pro-tauri. روشهای پرداختِ کلینیک (حساب بانکی + کارتخوان) که بعداً از
|
|
* فاکتور مراجعهکننده برای ثبت روش پرداخت یک سرویس ارجاع میشوند.
|
|
*/
|
|
function MyFinancialPageContent() {
|
|
const [activeTab, setActiveTab] = useState<PaymentTab>('bank');
|
|
const [bankModalOpen, setBankModalOpen] = useState(false);
|
|
const [posModalOpen, setPosModalOpen] = useState(false);
|
|
const [editingBank, setEditingBank] = useState<BankAccount | null>(null);
|
|
const [editingPos, setEditingPos] = useState<Pos | null>(null);
|
|
|
|
const bankQuery = useBankAccounts();
|
|
const posQuery = usePosDevices();
|
|
const toggleBank = useToggleBankAccountStatus();
|
|
const togglePos = useTogglePosStatus();
|
|
|
|
const banks = bankQuery.data?.data ?? [];
|
|
const posDevices = posQuery.data?.data ?? [];
|
|
|
|
const openAdd = () => {
|
|
if (activeTab === 'bank') { setEditingBank(null); setBankModalOpen(true); }
|
|
else { setEditingPos(null); setPosModalOpen(true); }
|
|
};
|
|
|
|
const onError = (e: unknown) => toast.error(e instanceof Error ? e.message : 'خطا در تغییر وضعیت');
|
|
|
|
return (
|
|
<div className="page">
|
|
<PageHeader title="مدیریت پرداخت" description="روشهای پرداخت کلینیک (حساب بانکی و کارتخوان)" />
|
|
|
|
<div className="card">
|
|
<PaymentMethodHead activeTab={activeTab} onTabChange={setActiveTab} onAdd={openAdd} />
|
|
|
|
{activeTab === 'bank' ? (
|
|
<BankAccountTable
|
|
data={banks}
|
|
loading={bankQuery.isLoading}
|
|
togglingUuid={toggleBank.isPending ? toggleBank.variables ?? null : null}
|
|
onToggle={(uuid) => toggleBank.mutate(uuid, { onError })}
|
|
onEdit={(account) => { setEditingBank(account); setBankModalOpen(true); }}
|
|
onAdd={openAdd}
|
|
/>
|
|
) : (
|
|
<PosTable
|
|
data={posDevices}
|
|
loading={posQuery.isLoading}
|
|
togglingUuid={togglePos.isPending ? togglePos.variables ?? null : null}
|
|
onToggle={(uuid) => togglePos.mutate(uuid, { onError })}
|
|
onEdit={(pos) => { setEditingPos(pos); setPosModalOpen(true); }}
|
|
onAdd={openAdd}
|
|
/>
|
|
)}
|
|
</div>
|
|
|
|
<BankAccountFormModal
|
|
open={bankModalOpen}
|
|
account={editingBank}
|
|
onClose={() => { setBankModalOpen(false); setEditingBank(null); }}
|
|
/>
|
|
<PosFormModal
|
|
open={posModalOpen}
|
|
pos={editingPos}
|
|
onClose={() => { setPosModalOpen(false); setEditingPos(null); }}
|
|
/>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
export default function MyFinancialPage() {
|
|
return (
|
|
<SettingsLayout active="payment">
|
|
<MyFinancialPageContent />
|
|
</SettingsLayout>
|
|
);
|
|
}
|