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

@@ -159,6 +159,9 @@ class Appointment
     #[ORM\Column(name: 'deposit_amount_rials', type: 'integer', nullable: true)]
     private ?int $depositAmountRials = null;
 
+    #[ORM\Column(name: 'visit_price_rials', type: 'integer', nullable: true)]
+    private ?int $visitPriceRials = null;
+
     /**
      * Reserve-list entry (نوبت رزرو): booked for a day, not a time slot.
      * slotStart/slotEnd hold that day's midnight so date queries keep working.
@@ -245,6 +248,7 @@ class Appointment
     public function getStaff(): ?\App\Staff\Entity\ClinicStaff { return $this->staff; }
     public function isDepositRequired(): bool { return $this->depositRequired; }
     public function getDepositAmountRials(): ?int { return $this->depositAmountRials; }
+    public function getVisitPriceRials(): ?int { return $this->visitPriceRials; }
     public function isReserve(): bool { return $this->isReserve; }
 
     public function setServiceSection(?\App\ClinicService\Entity\ServiceSection $v): self { $this->serviceSection = $v; return $this; }
@@ -252,6 +256,7 @@ class Appointment
     public function setStaff(?\App\Staff\Entity\ClinicStaff $v): self { $this->staff = $v; return $this; }
     public function setDepositRequired(bool $v): self { $this->depositRequired = $v; return $this; }
     public function setDepositAmountRials(?int $v): self { $this->depositAmountRials = $v; return $this; }
+    public function setVisitPriceRials(?int $v): self { $this->visitPriceRials = $v; return $this; }
 
     /**
      * Move the appointment to a new slot (جا به جایی نوبت) and/or flip its
@@ -347,6 +352,7 @@ class Appointment
             'staff'           => $this->staff ? ['uuid' => $this->staff->getUuid(), 'full_name' => $this->staff->getFullName()] : null,
             'deposit_required'     => $this->depositRequired,
             'deposit_amount_rials' => $this->depositAmountRials,
+            'visit_price_rials'    => $this->visitPriceRials,
             'is_reserve'           => $this->isReserve,
             'version'    => $this->version,
             'created_at' => $this->createdAt,