perf(billing,settlement): paginate claims and wallet transactions (H9, H10)

GET /billing/claims loaded every tenant claim with no limit. Add
findByTenant(page, limit) + countByTenant (shared query builder), default
limit 50 / max 100, and expose totals as data.meta — kept inside the existing
{ data: { data: [...] } } envelope so current clients are unaffected.

GET /wallet/transactions was already bounded (findByUser defaulted to limit 50)
but page-less; add page/offset + countByUser + the same additive meta.

Regression: tests/Billing/ClaimsListPaginationTest,
tests/Settlement/WalletTransactionsPaginationTest.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/Settlement/Controller/SettlementController.php

@@ -86,14 +86,27 @@ class SettlementController extends BaseController
         ]
     )]
     #[Route('/api/v1/wallet/transactions', methods: ['GET'])]
-    public function transactions(#[CurrentUser] User $user): JsonResponse
+    public function transactions(Request $request, #[CurrentUser] User $user): JsonResponse
     {
+        $page  = max(1, (int) $request->query->get('page', 1));
+        $limit = min(100, max(1, (int) $request->query->get('limit', 50)));
+
         $transactions = array_map(
             fn(WalletTransaction $t) => $t->toArray(),
-            $this->walletRepo->findByUser($user)
+            $this->walletRepo->findByUser($user, $limit, ($page - 1) * $limit)
         );
+        $total = $this->walletRepo->countByUser($user);
 
-        return $this->success(['data' => $transactions]);
+        // meta added inside the existing { data: { data: [...] } } envelope so
+        // existing clients keep reading data.data unchanged.
+        return $this->success([
+            'data' => $transactions,
+            'meta' => [
+                'totalRecords' => $total,
+                'totalPages'   => (int) ceil($total / $limit),
+                'currentPage'  => $page,
+            ],
+        ]);
     }
 
     // ── Settlement Requests ───────────────────────────────────────────────────

src/Settlement/Repository/WalletTransactionRepository.php

@@ -15,9 +15,14 @@ class WalletTransactionRepository extends ServiceEntityRepository
     }
 
     /** @return WalletTransaction[] */
-    public function findByUser(User $user, int $limit = 50): array
+    public function findByUser(User $user, int $limit = 50, int $offset = 0): array
     {
-        return $this->findBy(['user' => $user], ['createdAt' => 'DESC'], $limit);
+        return $this->findBy(['user' => $user], ['createdAt' => 'DESC'], $limit, $offset);
+    }
+
+    public function countByUser(User $user): int
+    {
+        return $this->count(['user' => $user]);
     }
 
     public function save(WalletTransaction $entity, bool $flush = true): void