hamedandClaude Opus 5
1f58b1b9b3
An appointment can now carry the insurance it is billed with: the service kind (outpatient/inpatient) and the basic insurance. Confirming it no longer hands the whole amount to the patient — the visit is split through BillingCalculator with the coverage percent of that service kind, and the choice travels to the encounter and the invoice built from it. The enabled service kinds are a tenant-wide setting (all of that tenant's insurances share it), so a tenant covering only one kind is never asked which one: the panel resolves it the same way the server does. - add tenant_service_category_settings + TenantServiceCategoryService, exposed on the existing insurance-pricing endpoint (service_categories, default_service_category); at least one kind must stay enabled - add appointments.insurance_service_category / insurance_base_id with AppointmentInsuranceService validating them against the tenant's own settings and active contracts (basic only), accepted by PATCH and by confirm - snapshot the kind on patient_sessions and invoices; the visit's coverage rule is resolved per kind (services keep using their own ServiceItem.service_category) - lib/insuranceShares becomes the single client-side mirror of BillingCalculator, shared by the confirm modal, the appointment edit page and the session form - surface the selection: confirm modal (with live shares), turns timeline chip, appointment edit page, patient record service card and invoice summary - the session form shows the insurance block whenever the tenant has an active contract and prefills the patient's own insurance, so it can be changed - fix: the confirm modal showed a zero visit price when the appointment had none — it now falls back to the tenant's free-visit price like the server - fix: useServiceCategories read one level too shallow, so Persian labels never arrived and raw enum keys leaked into the contract summary - fix: BlogsPage test asserted the public blogs endpoint after the page moved to the admin one Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
98 lines
3.8 KiB
TypeScript
98 lines
3.8 KiB
TypeScript
/**
|
|
* آینهٔ سمتکلاینتِ `BillingCalculator` سرور. تنها منبع محاسبهٔ سهمها در پنل است —
|
|
* هیچ صفحهای نباید فرمول درصدی جداگانه بنویسد، وگرنه مبلغِ نمایشدادهشده با مبلغِ
|
|
* ثبتشده واگرا میشود.
|
|
*/
|
|
|
|
export interface CoverageRule {
|
|
covered: boolean;
|
|
percent: number;
|
|
/** فقط در بیمهٔ تکمیلی معنا دارد. */
|
|
franchise: number;
|
|
ceiling: number | null;
|
|
}
|
|
|
|
/** قراردادِ بیمهٔ tenant، همان شکلی که `/api/v1/billing/tenant-insurances` میدهد. */
|
|
export interface TenantContract {
|
|
insurance_id: number;
|
|
insurance_name: string | null;
|
|
insurance_kind: string | null;
|
|
is_active?: boolean;
|
|
coverage_percent: number;
|
|
franchise_rials: number;
|
|
annual_ceiling_rials: number | null;
|
|
category_coverages?: Record<string, number>;
|
|
}
|
|
|
|
/** ویزیت آیتم سرویس نیست؛ نوعِ پیشفرضش سرپایی است. */
|
|
export const DEFAULT_SERVICE_CATEGORY = 'outpatient';
|
|
|
|
/**
|
|
* سهم بیمار یک ردیف: کل − سهم پایه (با سقف) − سهم تکمیلی (روی باقیمانده) + فرانشیزِ تکمیلی.
|
|
* فرانشیزِ بیمهٔ پایه در محاسبه دخالت نمیکند.
|
|
*/
|
|
export function patientShareOf(total: number, base: CoverageRule | null, supp: CoverageRule | null): number {
|
|
let baseShare = 0;
|
|
let remaining = total;
|
|
if (base && base.covered) {
|
|
baseShare = Math.round(total * (base.percent / 100));
|
|
if (base.ceiling !== null) baseShare = Math.min(baseShare, base.ceiling);
|
|
remaining = total - baseShare;
|
|
}
|
|
let suppShare = 0;
|
|
if (supp && supp.covered) {
|
|
suppShare = Math.round(remaining * (supp.percent / 100));
|
|
if (supp.ceiling !== null) suppShare = Math.min(suppShare, supp.ceiling);
|
|
remaining = remaining - suppShare;
|
|
}
|
|
|
|
return Math.min(remaining + (supp?.franchise ?? 0), total);
|
|
}
|
|
|
|
/** درصد مؤثر قرارداد برای یک نوع خدمت؛ نبودِ ردیف → ستون قدیمی قرارداد. */
|
|
export function contractPercentFor(contract: TenantContract, category: string): number {
|
|
return Number(contract.category_coverages?.[category] ?? contract.coverage_percent ?? 0);
|
|
}
|
|
|
|
/** قاعدهٔ پوشش یک ردیف تحت یک قرارداد. فرانشیز فقط از قرارداد تکمیلی خوانده میشود. */
|
|
export function ruleOf(contract: TenantContract | null, category: string): CoverageRule | null {
|
|
if (!contract) return null;
|
|
|
|
return {
|
|
covered: true,
|
|
percent: contractPercentFor(contract, category),
|
|
franchise: contract.insurance_kind === 'supplementary' ? contract.franchise_rials : 0,
|
|
ceiling: contract.annual_ceiling_rials,
|
|
};
|
|
}
|
|
|
|
export interface BillableLine {
|
|
/** مبلغ کل ردیف (با احتساب تعداد). */
|
|
total: number;
|
|
/** نوع خدمت؛ برای ویزیت نوعِ انتخابشدهٔ مراجعه. */
|
|
category: string;
|
|
/** خدمتی که پوشش بیمه ندارد کامل سهم بیمار است. */
|
|
insured: boolean;
|
|
}
|
|
|
|
export interface ShareBreakdown {
|
|
total: number;
|
|
insurance: number;
|
|
patient: number;
|
|
}
|
|
|
|
/** تفکیک سهم بیمه/بیمار برای مجموعهای از ردیفها تحت یک قرارداد پایه. */
|
|
export function breakdownOf(lines: BillableLine[], base: TenantContract | null): ShareBreakdown {
|
|
return lines.reduce<ShareBreakdown>((acc, line) => {
|
|
const patient = line.insured
|
|
? patientShareOf(line.total, ruleOf(base, line.category), null)
|
|
: line.total;
|
|
|
|
return {
|
|
total: acc.total + line.total,
|
|
insurance: acc.insurance + (line.total - patient),
|
|
patient: acc.patient + patient,
|
|
};
|
|
}, { total: 0, insurance: 0, patient: 0 });
|
|
}
|