الصفحات والمرشحات

صفحات Laravel

مسارات عمليات المحفظة والدفتر والتدقيق والصرف والتسويات تستخدم صفحات افتراضية حجمها 20. أرسل page وper_page، ولا تطلب حجمًا غير محدود. تعرض بعض المسارات بيانات الصفحة داخل data، بينما يعرض مسار عمليات التاجر data كقائمة وmeta منفصلًا؛ المرجع يوضح شكل كل استجابة.

ترتيب مستقر

الترتيب الحالي تنازلي حسب created_at في معظم القوائم. عند مزامنة سجل طويل، خزّن آخر معرف ووقت رأيتهما، وتعامل مع احتمال إضافة عناصر جديدة بين الصفحات. لا تعتمد على رقم الصفحة وحده لبناء مزامنة مالية دائمة.

المرشحات

الصرف والتسويات يدعمان wallet_id وstatus وbusiness_id وفق صلاحية المنفذ. التقارير تحتاج from وto بتنسيق تاريخ. لا ترسل business_id من تطبيق عميل عادي لمحاولة توسيع النطاق؛ الخادم يطبق سياق الهوية.

الحدود والأداء

استخدم أقل per_page يحقق حاجتك، وطبّق debounce على البحث في لوحة التحكم. التقارير المجمعة ليست بديلًا عن تنزيل جميع القيود وإعادة حساب الرصيد. الرصيد والدفتر مصدران مختلفان: الرصيد يعرض حالة سريعة، والدفتر يقدم أثرًا غير قابل للتعديل.

التوقف

توقف عند current_page >= last_page أو عندما تصبح القائمة فارغة. تعامل مع عناصر مكررة عند إعادة مزامنة صفحة بعد انقطاع، باستخدام UUID أو المعرف الأساسي.