feat: Enhance insurance billing system to support supplementary insurance

- Updated CoverageRule and related entities to include franchise_percent instead of franchise_rials.
- Modified Appointment entity to carry supplementary insurance ID alongside base insurance.
- Implemented SessionBillingService to ensure finalized invoices for insured patient sessions.
- Created InvoiceFinalized event to trigger claims creation upon invoice finalization.
- Added BackfillMissingClaimsCommand to generate claims for finalized invoices without existing claims.
- Developed tests to validate the new functionality for supplementary insurance handling in appointments and claims.

src/Appointment/Entity/Appointment.php

@@ -195,6 +195,10 @@ class Appointment
     #[ORM\Column(name: 'insurance_base_id', type: 'integer', nullable: true)]
     private ?int $insuranceBaseId = null;
 
+    /** بیمهٔ تکمیلی روی باقیماندهٔ بعد از بیمهٔ پایه محاسبه می‌شود، نه روی کل مبلغ. */
+    #[ORM\Column(name: 'insurance_supplementary_id', type: 'integer', nullable: true)]
+    private ?int $insuranceSupplementaryId = null;
+
     /**
      * Reserve-list entry (نوبت رزرو): booked for a day, not a time slot.
      * slotStart/slotEnd hold that day's midnight so date queries keep working.
@@ -291,6 +295,7 @@ class Appointment
     public function getVisitPriceRials(): ?int { return $this->visitPriceRials; }
     public function getInsuranceServiceCategory(): ?ServiceCategory { return $this->insuranceServiceCategory; }
     public function getInsuranceBaseId(): ?int { return $this->insuranceBaseId; }
+    public function getInsuranceSupplementaryId(): ?int { return $this->insuranceSupplementaryId; }
     public function isReserve(): bool { return $this->isReserve; }
 
     public function setServiceSection(?\App\ClinicService\Entity\ServiceSection $v): self { $this->serviceSection = $v; return $this; }
@@ -301,6 +306,7 @@ class Appointment
     public function setVisitPriceRials(?int $v): self { $this->visitPriceRials = $v; return $this; }
     public function setInsuranceServiceCategory(?ServiceCategory $v): self { $this->insuranceServiceCategory = $v; $this->updatedAt = time(); return $this; }
     public function setInsuranceBaseId(?int $v): self { $this->insuranceBaseId = $v; $this->updatedAt = time(); return $this; }
+    public function setInsuranceSupplementaryId(?int $v): self { $this->insuranceSupplementaryId = $v; $this->updatedAt = time(); return $this; }
 
     /**
      * Move the appointment to a new slot (جا به جایی نوبت) and/or flip its
@@ -422,6 +428,7 @@ class Appointment
             'insurance_service_category'       => $this->insuranceServiceCategory?->value,
             'insurance_service_category_label' => $this->insuranceServiceCategory?->label(),
             'insurance_base_id'                => $this->insuranceBaseId,
+            'insurance_supplementary_id'       => $this->insuranceSupplementaryId,
             'is_reserve'           => $this->isReserve,
             'version'    => $this->version,
             'created_at' => $this->createdAt,