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.

src/Admin/Controller/AdminApiController.php

@@ -42,6 +42,7 @@ class AdminApiController extends BaseController
         private readonly \App\Payment\Service\PaymentManager $paymentManager,
         private readonly \App\Payment\Repository\PaymentRepository $paymentRepo,
         private readonly \App\Patient\Service\PatientResolver $patientResolver,
+        private readonly \App\Insurance\Service\VisitPriceRequirementResolver $visitPriceResolver,
     ) {}
 
     // ── Users ─────────────────────────────────────────────────────────────────
@@ -911,6 +912,11 @@ class AdminApiController extends BaseController
         $doctor = $this->em->getRepository(Doctor::class)->findOneBy(['uuid' => $doctorUuid]);
         if (!$doctor) return $this->error(ErrorCodes::DOCTOR_NOT_FOUND, 'پزشک یافت نشد', 404);
 
+        $visitPriceRials = isset($data['visit_price_rials']) ? (int) $data['visit_price_rials'] : null;
+        if ($this->visitPriceResolver->isRequiredForDoctor($doctor) && ($visitPriceRials ?? 0) <= 0) {
+            return $this->error(ErrorCodes::VALIDATION, 'هزینه ویزیت الزامی است', 422, 'visit_price_rials');
+        }
+
         // Identity is keyed on the national code (unique) so the case-file stays
         // single per person even when booked under a different mobile.
         $patient = $this->patientResolver->resolveForBooking($nationalCode, $mobile, $patientName);
@@ -920,6 +926,7 @@ class AdminApiController extends BaseController
         $appointment->setPatientName($patientName);
         $appointment->setPatientMobile($mobile);
         if (!empty($data['note'])) $appointment->setNote($data['note']);
+        if ($visitPriceRials !== null) $appointment->setVisitPriceRials($visitPriceRials);
         foreach ($serviceItems as $si) {
             $appointment->addServiceItem($si);
         }