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/Repository/SettlementRepository.php

@@ -43,6 +43,16 @@ class SettlementRepository extends ServiceEntityRepository
         return $credit - $debit;
     }
 
+    /** @param string[] $statuses */
+    public function sumByStatus(User $user, array $statuses): int
+    {
+        return (int) ($this->getEntityManager()->createQuery(
+            'SELECT SUM(s.amountRials) FROM App\Settlement\Entity\Settlement s
+             WHERE s.user = :user AND s.status IN (:statuses)'
+        )->setParameters(['user' => $user, 'statuses' => $statuses])
+         ->getSingleScalarResult() ?? 0);
+    }
+
     public function save(Settlement $entity, bool $flush = true): void
     {
         $this->getEntityManager()->persist($entity);

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(