feat: implement domain guard for commission calculation and enhance representation dashboard

- Added domain guard in CommissionService to ensure commission is calculated only when the appointment is booked under the same representation as the doctor.
- Updated RepresentationController to filter statistics by representation, ensuring accurate data is shown for each representative.
- Introduced new endpoints for the representation dashboard to provide summary statistics, doctor performance, and financial reports.
- Created new pages for RepresentationFinance and RepresentationSettlement to display financial data and allow for settlement requests.
- Added migration to include booking_representation_id in appointments for tracking the representative under which the appointment was booked.

src/Settlement/Service/CommissionService.php

@@ -28,12 +28,18 @@ class CommissionService
         private readonly EntityManagerInterface       $em,
     ) {}
 
-    /** پورسانت نوبت: درصد = commission_percent همان نماینده. */
-    public function processAppointment(Payment $payment, ?int $representationId, ?int $doctorId): void
+    /**
+     * پورسانت نوبت: درصد = commission_percent همان نماینده.
+     * گاردِ دامنه: فقط وقتی که پزشک متعلق به نماینده باشد و نوبت هم از دامنه‌ی همان نماینده ثبت شده باشد.
+     */
+    public function processAppointment(Payment $payment, ?int $doctorRepId, ?int $bookingRepId, ?int $doctorId): void
     {
         if ($this->configRepo->get('appointment_commission_enabled') !== '1') return;
 
-        $rep = $this->resolveRep($representationId);
+        // هر دو شرط لازم است و باید یکی باشند.
+        if ($doctorRepId === null || $bookingRepId === null || $doctorRepId !== $bookingRepId) return;
+
+        $rep = $this->resolveRep($doctorRepId);
         if ($rep === null) return;
 
         $this->settle(