feat: implement filtered and paginated appointment retrieval for doctors

2026-07-19 11:41:43 +03:30
parent f1d147f9ef
commit 8420a1a6c2
4 changed files with 279 additions and 8 deletions
@@ -642,10 +642,44 @@ class AppointmentController extends BaseController
            return $this->error(ErrorCodes::ERR_ACCESS_DENIED, 'دسترسی ممنوع', 403);
        }

-        $status       = $request->query->get('status');
-        $appointments = $this->appointmentRepo->findByDoctor($doctor, $status, $scopeClinic);
+        // بدون هیچ پارامتر فیلتر/صفحه‌بندی، رفتار قدیمی (لیست کامل، پاسخ تودرتو) حفظ
+        // می‌شود تا کلاینت‌های موجود نشکنند. با هر فیلتری پاسخ صفحه‌بندی‌شده می‌آید.
+        $filterKeys = ['statuses', 'from', 'to', 'q', 'service_uuid', 'page', 'limit'];
+        $isFiltered = (bool) array_filter($filterKeys, fn(string $k) => $request->query->has($k));

-        return $this->success(['data' => array_map(fn(Appointment $a) => $a->toArray(), $appointments)]);
+        if (!$isFiltered) {
+            $status       = $request->query->get('status');
+            $appointments = $this->appointmentRepo->findByDoctor($doctor, $status, $scopeClinic);
+
+            return $this->success(['data' => array_map(fn(Appointment $a) => $a->toArray(), $appointments)]);
+        }
+
+        $statuses = $request->query->all('statuses');
+        if ($statuses === [] && $request->query->get('status')) {
+            $statuses = [$request->query->get('status')];
+        }
+
+        $page  = max(1, (int) $request->query->get('page', 1));
+        $limit = min(100, max(1, (int) $request->query->get('limit', 20)));
+
+        $result = $this->appointmentRepo->searchByDoctor(
+            doctor:      $doctor,
+            statuses:    array_values(array_filter($statuses, fn($s) => is_string($s) && $s !== '')),
+            clinic:      $scopeClinic,
+            from:        $request->query->has('from') ? (int) $request->query->get('from') : null,
+            to:          $request->query->has('to')   ? (int) $request->query->get('to')   : null,
+            query:       $request->query->get('q'),
+            serviceUuid: $request->query->get('service_uuid'),
+            page:        $page,
+            limit:       $limit,
+        );
+
+        return $this->paginated(
+            array_map(fn(Appointment $a) => $a->toArray(), $result['items']),
+            $result['total'],
+            $page,
+            $limit,
+        );
    }

    #[OA\Get(