قد يعرض جدول العملاء صفحة أولى سليمة، لكن العميل نفسه يظهر في الثانية أو يختفي سجل عند إضافة طلب جديد. ترقيم نتائج API ليس مجرد زر «التالي»؛ إنه اتفاق على ترتيب البيانات وكيف يستمر التصفح عندما تتغير. اختبر هذا الاتفاق قبل استخدامه في لوحة تشغيل أو تكامل يسحب عدة صفحات متتالية.
حدد ما تريد من التصفح
هل يحتاج المستخدم الانتقال إلى رقم صفحة، أم يكفي التالي والسابق؟ وهل يريد أحدث الحالة أم نسخة ثابتة للتصدير؟ هذه أسئلة مختلفة. تشرح وثائق Laravel للترقيم اختلاف الترقيم بالإزاحة عن cursor، وأن الكتابة أثناء التصفح قد تسبب تخطيًا أو تكرارًا مع الإزاحة، وأن cursor يحتاج ترتيبًا يعتمد على عمود فريد أو مجموعة فريدة وفق قيوده.
لا تعتبر cursor ضمانًا تلقائيًا لنسخة ثابتة من كل البيانات. إذا تغيرت قيم الترتيب أو الفلاتر، فراجع معنى الاستمرار وحدوده. مثال افتراضي: قائمة مرتبة بوقت التعديل يمكن أن تتحرك فيها السجلات عند تعديلها. حدد هل هذا السلوك مقبول للتصفح، أم أن التصدير يحتاج آلية منفصلة تحافظ على مجموعة محددة.
اجعل الترتيب واضحًا عند تساوي القيم
أنشئ عينة تحتوي على عدة سجلات بالقيمة نفسها في الحقل الرئيسي للترتيب، مثل تاريخ الإنشاء. راجع كيف يفصل النظام بينها، واختبر ترتيبًا متسقًا باستخدام معرّف مناسب إذا كانت البنية تسمح. لا تترك قاعدة الترتيب ضمنية تعتمد على ترتيب عودة قاعدة البيانات دون تعريف واضح في الطلب.
| التجربة | ما تفحصه |
|---|---|
| سجلات لها نفس الوقت | ترتيب معروف لا يتبدل بلا سبب |
| إنشاء سجل بين صفحتين | سلوك موثق للتكرار أو الاستمرار |
| تغيير الفلتر | بدء سلسلة مناسبة للفلتر الجديد |
| cursor غير صالح | خطأ واضح لا نتيجة مضللة |
راجع المعرّفات بدل عدد الصفوف فقط
سجل معرّفات النتائج في كل صفحة، ثم قارن التكرار والسجلات المتوقعة في العينة. تساوي عدد الصفوف لا يثبت أن كل سجل ظهر مرة واحدة. نفذ تجربة قراءة متتابعة دون تغييرات، ثم أعدها مع إضافة وحذف وتعديل مضبوطين في بيئة الاختبار. احتفظ بالمدخلات وترتيب الأحداث حتى يستطيع المطور إعادة المشكلة.
افحص كذلك أن الفلاتر ونطاق الصلاحيات يبقيان مطبقين في كل طلب. تغيير الصفحة لا ينبغي أن يزيل قيد الشركة أو الموظف. ولا تثق بأن رمز cursor يمنح حق الاطلاع على سجل؛ التحكم في الوصول يجب أن يبقى صحيحًا مستقلًا عن طريقة استمرار التصفح.
افصل تصدير البيانات عن عرضها
إذا كانت العملية تحتاج قائمة كاملة في لحظة محددة، فاكتب متطلبات التصدير صراحة: وقت الحالة، مجموعة البيانات، حدود الحجم، وطريقة التحقق من اكتمال الملف. لا تستخدم حلقات «التالي» فوق قائمة تتغير باستمرار ثم تسمي الملف نسخة ثابتة دون اختبار. اختبر ملفًا صغيرًا معروف السجلات قبل توسيع العملية إلى البيانات الفعلية.
أضف الحالات إلى تطوير أنظمة المؤسسة وراجع الاستعلامات وحدود التصفح ضمن الفحص التقني. القرار المناسب يعتمد على تجربة المستخدم وحجم البيانات وتغيرها. المطلوب ترتيب يمكن تفسيره، واختبار بالمعرّفات، وحدود معلنة؛ اختيار طريقة ترقيم مشهورة لا يعوض هذا الاتفاق.
