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/Insurance/Entity/EntityInsurancePricing.php

@@ -31,6 +31,10 @@ class EntityInsurancePricing
     #[ORM\Column(name: 'patient_share_rials', type: 'integer')]
     private int $patientShareRials = 0;
 
+    /** Only meaningful on the free-visit row (insurance_id = NULL). */
+    #[ORM\Column(name: 'require_visit_price', type: 'boolean', options: ['default' => false])]
+    private bool $requireVisitPrice = false;
+
     #[ORM\Column(name: 'updated_at', type: 'integer')]
     private int $updatedAt;
 
@@ -50,8 +54,10 @@ class EntityInsurancePricing
     public function getPatientShareRials(): int    { return $this->patientShareRials; }
 
     public function isFreeVisit(): bool            { return $this->insuranceId === null; }
+    public function isRequireVisitPrice(): bool    { return $this->requireVisitPrice; }
 
     public function setPatientShareRials(int $v): self { $this->patientShareRials = $v; $this->updatedAt = time(); return $this; }
+    public function setRequireVisitPrice(bool $v): self { $this->requireVisitPrice = $v; $this->updatedAt = time(); return $this; }
 
     public function toArray(): array
     {
@@ -61,6 +67,7 @@ class EntityInsurancePricing
             'entity_id'           => $this->entityId,
             'insurance_id'        => $this->insuranceId,
             'patient_share_rials' => $this->patientShareRials,
+            'require_visit_price' => $this->requireVisitPrice,
         ];
     }
 }