refactor(insurance): merge pricing into contracts (basic+supp groups)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-23 20:55:56 +03:30
parent 18ae55ac30
commit c556f3a53d
4 changed files with 129 additions and 184 deletions
@@ -0,0 +1,98 @@
+# یکپارچه‌سازی قراردادهای بیمه، select یکدست، و تعداد خدمت در مراجعه
+
+## پروژه
+
+`clinicpro` (admin frontend + کمی backend برای `quantity`)
+
+## زمینه
+
+چهار مورد به‌هم‌مرتبط در پنل ادمین:
+
+1. صفحه‌ی `/admin/insurance-pricing` دو بخش دارد که هم‌پوشانی دارند → باید یکی شود.
+2. select listها در کل پنل یک‌شکل نیستند (بعضی `<select className="input">` بومی، بعضی `SearchableSelect`).
+3. در «ثبت مراجعه جدید» هر خدمت فقط یک‌بار اضافه می‌شود؛ تعداد (مثلاً سرُم ۲ عدد) ممکن نیست.
+4. select بیمه‌ی پایه/تکمیلی در فرم مراجعه باید فقط بیمه‌هایی را نشان دهد که tenant در `insurance-pricing` قیمت‌گذاری/قرارداد کرده، و درصد تخفیف خودکار اعمال شود.
+
+## وضعیت فعلی
+
+### صفحه‌ی insurance-pricing (دو بخش هم‌پوشان)
+
+`assets/admin/pages/InsurancePricingPage.tsx`:
+```tsx
+<TenantInsuranceContracts />     {/* قراردادها: بیمه + درصد پوشش + فرانشیز + سقف */}
+<InsurancePricingSection />      {/* قیمت‌گذاری: قیمت ویزیت آزاد + سهم هر بیمه‌ی پایه */}
+```
+- `TenantInsuranceContracts` (`assets/admin/components/TenantInsuranceContracts.tsx`): per (tenant, insurance) قرارداد با `coverage_percent`, `franchise_rials`, `annual_ceiling_rials`؛ افزودن/ویرایش/حذف. هم basic هم supplementary. API: `/api/v1/billing/tenant-insurances` (GET/POST/PATCH/DELETE).
+- `InsurancePricingSection` (`assets/admin/components/InsurancePricingSection.tsx`): «قیمت ویزیت آزاد» + سهم بیمار به ازای هر بیمه‌ی **پایه**. API: `GET/PUT /api/v1/insurance-pricing` (جدول `entity_insurance_pricing`).
+
+این دو منطق موازی‌اند و کاربر را گیج می‌کنند. قرارداد با `coverage_percent` کافی است؛ بخش «قیمت‌گذاری» زیرش بی‌معنی است.
+
+### select listها
+
+نمونه‌ی بومی پراکنده (`NewSessionPage.tsx`, `MyPatientsPage.tsx`, `SmsPage.tsx`, `ClaimsPage.tsx`, `SettingsPage.tsx`, …):
+```tsx
+<select className="input" value={...} onChange={...}>
+  <option value="">...</option>
+  {opts.map(o => <option key={o.value} value={o.value}>{o.label}</option>)}
+</select>
+```
+و در کنارش کامپوننت `SearchableSelect` (`assets/admin/components/ui/SearchableSelect.tsx`) برای بخش خدمات استفاده می‌شود. ظاهر این دو فرق دارد.
+
+### تعداد خدمت
+
+`src/Patient/Entity/SessionService.php` — فیلد `quantity` ندارد:
+```php
+private ServiceItem $serviceItem;
+private ?ClinicStaff $staff = null;
+private int $priceRials;   // = serviceItem price، بدون ضرب در تعداد
+```
+`PatientService::createSession` services را تک‌واحدی جمع می‌زند:
+```php
+$servicesTotal = array_sum(array_column($serviceItems, 'price_rials'));
+```
+فرانت (`NewSessionPage.tsx`) هم هر خدمت را یک‌بار اضافه می‌کند (chip بدون تعداد).
+
+### select بیمه در فرم مراجعه
+
+`NewSessionPage.tsx` گزینه‌های بیمه را از `GET /api/v1/insurance-pricing` می‌گیرد (`pricing.insurances`)، ولی آن endpoint **همه‌ی بیمه‌های فعال** را برمی‌گرداند (نه فقط قراردادهای tenant). درصد هم از `patient_share_rials` همان endpoint محاسبه می‌شود — که بعد از حذف بخش قیمت‌گذاری دیگر منبع درستی نیست.
+
+## وظایف
+
+### ۱. ادغام صفحه‌ی insurance-pricing
+
+- `InsurancePricingSection` و endpoint/جدول `entity_insurance_pricing` را کنار بگذار (از `InsurancePricingPage` حذف کن). قرارداد (`TenantInsuranceContracts`) تنها منبع باشد.
+- `TenantInsuranceContracts` باید واضح هم basic هم supplementary را پشتیبانی کند (الان هم می‌کند؛ متن/گروه‌بندی را شفاف کن: دو دسته «بیمه پایه» و «بیمه تکمیلی»).
+- اگر «قیمت ویزیت آزاد» جایی لازم است، آن را به‌صورت یک فیلد ساده در همان صفحه/پروفایل نگه‌دار یا حذف کن (تصمیم را در پیاده‌سازی مستند کن). مسیر `/admin/insurance-pricing` و آیتم سایدبار باقی بماند.
+- `InsurancePricingSection.tsx` حذف یا خالی شود؛ importها پاک‌سازی.
+
+### ۲. یک کامپوننت select یکدست
+
+- یک کامپوننت `Select` در `assets/admin/components/ui/` بساز (یا `SearchableSelect` را به‌عنوان استاندارد واحد بپذیر) با ظاهر یکسان: همان استایل، RTL، chevron، حالت focus/disabled، placeholder.
+- همه‌ی `<select className="input">`های پنل را با این کامپوننت جایگزین کن (صفحات بالا). رفتار/داده تغییر نکند، فقط ظاهر یکدست شود.
+- نمونه‌ی مرجع ظاهر: select خدمات (`SearchableSelect`) در فرم مراجعه.
+
+### ۳. تعداد (quantity) برای خدمات
+
+**Backend:**
+- به `SessionService` فیلد `quantity` (int, پیش‌فرض 1) اضافه کن + getter/setter + در `toArray()`. migration.
+- `PatientService::createSession`: body هر service می‌تواند `quantity` داشته باشد؛ `line_total = price × quantity`؛ `services_total_rials` و `final_price_rials` با احتساب تعداد محاسبه شوند.
+- `docs/api/patient.md` (یا فایل session مربوط) به‌روز شود.
+
+**Frontend (`NewSessionPage.tsx`):**
+- chip خدمت دارای ورودی/استپر تعداد باشد (۱،۲،…)؛ نمایش `price × qty`.
+- body ارسالی: `services: [{ service_item_uuid, quantity }]`.
+- خلاصه‌ی قیمت با تعداد محاسبه شود.
+
+### ۴. select بیمه فقط از قراردادها + درصد خودکار
+
+- در `NewSessionPage.tsx`، گزینه‌های «بیمه پایه» و «بیمه تکمیلی» از **قراردادهای tenant** بیایند (`GET /api/v1/billing/tenant-insurances`)، نه از `insurance-pricing`.
+- هر گزینه `coverage_percent` خودش را دارد؛ با انتخاب بیمه، درصد تخفیف **خودکار** از `coverage_percent` قرارداد ست شود (نه از `patient_share_rials`).
+- فقط بیمه‌های فعال قرارداد نمایش داده شوند؛ تفکیک basic/supplementary بر اساس `insurance_kind`.
+
+## نکات مهم
+
+- backend فقط برای `quantity` تغییر می‌کند؛ بقیه frontend است.
+- بعد از تغییر Entity: `doctrine:migrations:diff` + `migrate`.
+- پاسخ‌ها/الگوها: `BaseController`، `formatRial`/`formatNumber`، RTL، Vazirmatn، CSS variables موجود.
+- چون `insurance-pricing` (entity_insurance_pricing) حذف می‌شود، هر مصرف‌کننده‌ی دیگرش را پیدا و پاک‌سازی کن (جستجوی `insurance-pricing` و `EntityInsurancePricing` در `src/` و `assets/`). اگر `BillingCalculator`/`InvoiceService` به آن وابسته است، به `coverage_percent` قرارداد سوییچ کن.
+- tsc + `yarn dev` بدون خطا؛ هر بخش جدا commit.