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

@@ -32,6 +32,7 @@ class AppointmentController extends BaseController
         private readonly SlotCalculatorService  $slotCalculator,
         private readonly PatientService         $patientService,
         private readonly WeeklyScheduleRepository $scheduleRepo,
+        private readonly \App\Representation\Repository\RepresentationRepository $representationRepo,
     ) {}
 
     // ── Public: available slots ───────────────────────────────────────────────
@@ -259,6 +260,15 @@ class AppointmentController extends BaseController
         $appointment->setPatientGender($gender);
         if (isset($data['note'])) $appointment->setNote($data['note']);
 
+        // نماینده‌ی دامنه‌ی جاری (city_id از سایت)؛ برای گاردِ پورسانت.
+        $cityId = (int) ($data['city_id'] ?? 0);
+        if ($cityId > 0) {
+            $bookingRep = $this->representationRepo->findActiveByCityId($cityId);
+            if ($bookingRep !== null) {
+                $appointment->setBookingRepresentationId($bookingRep->getId());
+            }
+        }
+
         // آدرس نوبت از روی session متناظر در برنامه‌ی هفتگی تعیین می‌شود (location_id).
         $locationId = $this->resolveSlotLocationId($doctor, $slotStart);
         if ($locationId !== null) {