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/Patient/Service/PatientService.php

@@ -8,6 +8,7 @@ use App\Billing\Service\BillingCalculator;
 use App\Billing\ValueObject\Money;
 use App\ClinicService\Repository\ServiceItemRepository;
 use App\Clinic\Repository\ClinicRepository;
+use App\Insurance\Repository\EntityInsurancePricingRepository;
 use App\Insurance\Service\TenantInsuranceService;
 use App\Inventory\Repository\InventoryItemRepository;
 use App\Inventory\Repository\InventoryPackageRepository;
@@ -48,6 +49,7 @@ class PatientService
         private readonly TenantInsuranceService   $tenantInsuranceService,
         private readonly BillingCalculator        $billingCalculator,
         private readonly WalletService            $walletService,
+        private readonly EntityInsurancePricingRepository $pricingRepo,
     ) {}
 
     /**
@@ -138,6 +140,11 @@ class PatientService
         string $entityType,
         int $entityId
     ): PatientSession {
+        $freeVisitRow = $this->pricingRepo->findOneForInsurance($entityType, $entityId, null);
+        if (($freeVisitRow?->isRequireVisitPrice() ?? false) && (int) ($data['visit_price_rials'] ?? 0) <= 0) {
+            throw new AppException(ErrorCodes::ERR_VALIDATION_001, 'هزینه ویزیت الزامی است', 422, 'visit_price_rials');
+        }
+
         $session = new PatientSession($record);
 
         if (!empty($data['appointment_uuid'])) {