feat: enhance payment status handling and summary in MyPaymentsPage

- Added support for 'partial' payment status in MyPaymentsPage and related components.
- Updated API responses to include 'paid_rials' and 'summary' for invoices.
- Introduced InvoicePaymentStatus service to derive payment status based on actual payments.
- Enhanced tests to cover new payment scenarios including partial payments and payment methods.
- Updated documentation to reflect changes in payment status and API responses.

src/Billing/Controller/BillingController.php

@@ -217,7 +217,7 @@ class BillingController extends BaseController
     /**
      * پرداخت‌های ثبت‌شده‌ی یک بیمار — سربرگ بیمار + فهرست صفحه‌بندی‌شده‌ی صورتحساب‌ها.
      * فقط مالک رکورد (همان tenant) اجازه دارد؛ در غیر این صورت ۴۰۴.
-     * پاسخ: { patient:{uuid,name,national_code}, data:[صورتحساب‌ها], meta:{...} }.
+     * پاسخ: { patient:{uuid,name,national_code}, data:[صورتحساب‌ها], summary:{...}, meta:{...} }.
      */
     #[Route('/api/v1/my/billing/patients/{patientUuid}/invoices', methods: ['GET'])]
     public function listPatientInvoices(string $patientUuid, Request $request, #[CurrentUser] User $user): JsonResponse
@@ -244,7 +244,8 @@ class BillingController extends BaseController
                 'name'          => $patient->getRealName(),
                 'national_code' => $patient->getNationalCode(),
             ],
-            'data' => $result['items'],
+            'data'    => $result['items'],
+            'summary' => $result['summary'],
             'meta' => [
                 'totalRecords' => $result['total'],
                 'totalPages'   => (int) ceil($result['total'] / $limit),