feat: add visit price requirement feature

- Introduced a new boolean flag `require_visit_price` in the `EntityInsurancePricing` to enforce visit price for appointments.
- Updated the appointment creation endpoints to validate `visit_price_rials` based on the new flag.
- Added `visit_price_rials` field to the `Appointment` entity to store the visit price.
- Enhanced the `PatientService` to validate visit price during session creation.
- Updated API documentation to reflect changes in appointment and insurance pricing.
- Implemented a new service `VisitPriceRequirementResolver` to determine if a visit price is required for a doctor based on their pricing settings.
- Added migrations to update the database schema for the new fields.

assets/admin/components/session/CreateStep.tsx

@@ -5,7 +5,7 @@ import { PlusIcon, MinusIcon } from '@heroicons/react/24/outline';
 import { api } from '../../lib/api';
 import type { ApiResponse } from '../../lib/api';
 import type { PatientProfile, ServiceSection, ServiceItem } from '../../types';
-import { formatRial } from '../../lib/utils';
+import { formatRial, rialToToman, tomanToRial } from '../../lib/utils';
 import SearchableSelect from '../ui/SearchableSelect';
 import PersianDateInput from '../ui/PersianDateInput';
 import { UserTick, FilesServiceAddCard, ClockP, TrashRed } from '../icons/FilesServiceIcons';
@@ -76,6 +76,7 @@ export default function CreateStep({ recordUuid, profile, onCreated, onCancel }:
   const [selectedConsumables, setSelectedConsumables] = useState<{ uuid: string; name: string; price: number; qty: number }[]>([]);
   const [packageUuid, setPackageUuid] = useState('');
   const [visitPrice, setVisitPrice] = useState('0');
+  const [visitPriceError, setVisitPriceError] = useState('');
   const [baseId, setBaseId] = useState('');
   const [suppId, setSuppId] = useState('');
   const [basePercent, setBasePercent] = useState('0');
@@ -103,13 +104,14 @@ export default function CreateStep({ recordUuid, profile, onCreated, onCancel }:
   const { data: contractsData } = useQuery<{ data: { data: Contract[] } }>({
     queryKey: ['tenant-insurances'], queryFn: () => api.get('/api/v1/billing/tenant-insurances'),
   });
-  const { data: pricingData } = useQuery<{ data: { free_visit_price_rials: number } }>({
+  const { data: pricingData } = useQuery<{ data: { free_visit_price_rials: number; require_visit_price: boolean } }>({
     queryKey: ['insurance-pricing'], queryFn: () => api.get('/api/v1/insurance-pricing'),
   });
   const freeVisit = (pricingData as any)?.data?.free_visit_price_rials ?? 0;
+  const requireVisit = (pricingData as any)?.data?.require_visit_price ?? false;
 
   useEffect(() => {
-    if (freeVisit > 0 && (!visitPrice || visitPrice === '0')) setVisitPrice(String(freeVisit));
+    if (freeVisit > 0 && (!visitPrice || visitPrice === '0')) setVisitPrice(String(rialToToman(freeVisit)));
   }, [freeVisit]); // eslint-disable-line react-hooks/exhaustive-deps
 
   const contracts = (contractsData as any)?.data?.data as Contract[] | undefined ?? [];
@@ -194,7 +196,8 @@ export default function CreateStep({ recordUuid, profile, onCreated, onCancel }:
   };
 
   // ── قیمت‌ها (آینه‌ی سرور) ────────────────────────────────────────────────
-  const visit = Number(visitPrice) || 0;
+  // فیلد «قیمت ویزیت» تومان است؛ محاسبات و API ریالی‌اند.
+  const visit = tomanToRial(Number(visitPrice) || 0);
   const base = Number(basePercent) || 0;
   const supp = Number(suppPercent) || 0;
   const servicesTotal = useMemo(() => selectedServices.reduce((s, x) => s + x.price * x.qty, 0), [selectedServices]);
@@ -222,6 +225,11 @@ export default function CreateStep({ recordUuid, profile, onCreated, onCancel }:
   });
 
   const submit = () => {
+    if (requireVisit && visit <= 0) {
+      setVisitPriceError('هزینه ویزیت الزامی است');
+      toast.error('هزینه ویزیت الزامی است');
+      return;
+    }
     createMut.mutate({
       visit_price_rials: visit,
       base_insurance_discount_percent: showInsurance ? base : 0,
@@ -366,8 +374,18 @@ export default function CreateStep({ recordUuid, profile, onCreated, onCancel }:
 
       {/* قیمت ویزیت */}
       <div style={{ marginBottom: 16 }}>
-        <span style={fieldLabel}>قیمت ویزیت (تومان)</span>
-        <input className="input" type="number" min={0} dir="ltr" aria-label="قیمت ویزیت" value={visitPrice} onChange={(e) => setVisitPrice(e.target.value)} />
+        <span style={fieldLabel}>
+          قیمت ویزیت (تومان){requireVisit && <span style={{ color: 'var(--danger)' }}> *</span>}
+        </span>
+        <input
+          className="input" type="number" min={0} dir="ltr" aria-label="قیمت ویزیت"
+          aria-invalid={!!visitPriceError}
+          value={visitPrice}
+          onChange={(e) => { setVisitPrice(e.target.value); setVisitPriceError(''); }}
+        />
+        {visitPriceError && (
+          <span style={{ fontSize: 12, color: 'var(--danger)', display: 'block', marginTop: 4 }}>{visitPriceError}</span>
+        )}
       </div>
 
       {/* بیمه — منطق موجود NewSessionPage؛ فقط وقتی سرویس تحت پوشش یا بیمار بیمه دارد */}