قائمة التحقق لبدء التشغيل الفعلي

استخدم قائمة التحقق هذه قبل تفعيل تكامل شريك لمنشآت بيئة الإنتاج.

إعداد Partner Console

• ملفك التعريفي كشريك مكتمل.
• عنوان URL لشعارك، وموقعك الإلكتروني، وفئتك، ووصفك دقيقة.
• طريقة ربط البيانات مهيّأة: Direct Link أو Linking Identifier.
• تم اختبار ربط المنشآت مع منشأة حقيقية واحدة على الأقل.
• يُستخدم نوع المفتاح الصحيح:
  • Dryrun لاختبار عمليات الكتابة دون إحداث تغييرات فعلية.
  • Read-only لاستهلاك البيانات بأمان.
  • Live فقط عندما تكون مستعدًا للتأثير في بيانات الإنتاج.

المصادقة وإدارة المفاتيح

• تُخزَّن المفاتيح السرية على الخادم فقط.
• لا تُضمَّن المفاتيح في التطبيقات من جهة العميل، أو تطبيقات الأجهزة المحمولة، أو المستودعات العامة، أو تذاكر الدعم.
• تم اختبار تبديل المفاتيح وإلغائها.
• يعرف فريقك المفتاح الذي تستخدمه كل بيئة.

التحقق من البيانات

• الحقول المطلوبة موجودة لكل نقطة نهاية تستدعيها.
• معرّفات المنشآت تتطابق مع طريقة الربط المهيّأة لديك.
• المعرّفات القادمة من نظامك ثابتة ولا تتغير بين عمليات المزامنة.
• عمليات الاستيراد الكبيرة مقسّمة إلى دفعات ضمن الحدود الموثّقة.
• يمكن تحديد العناصر التي أخفقت في الدفعات وإعادة إرسالها.

اختبار نقاط النهاية

قبل الإطلاق، اختبر كل نقطة نهاية يعتمد عليها تكاملك:

• يمكن قراءة المنظمات والمنشآت.
• يمكن حفظ الأعضاء وتحديثهم.
• تتم مزامنة خطط العضوية ومناطق الوصول وساعات الوصول بشكل صحيح.
• تُقبل تسجيلات الدخول ويمكن ربطها بنظامك.
• تستخدم لقطات التقارير فترة التقرير والمقاييس المتوقعة.
• تم اختبار مسارات وحدات التحكم في الأبواب/البوابات على أجهزة حقيقية حيثما ينطبق ذلك.

الجاهزية لـ Access Time Window

إذا كان التكامل يوفّر Access Time Windows:

• تجتاز الأمثلة المطلقة والأسبوعية قائمة التحقق لاعتماد المنتج.
• قيم epoch أعداد صحيحة بالثواني وفق Unix دون علامات اقتباس؛ وقد تم اختبار الحدود الدقيقة [from, to).
• تم التحقق من القيم الافتراضية بتوقيت UTC، والمناطق الزمنية المخصصة وفق IANA للتكامل، وانتقالات التوقيت الصيفي ذات الصلة.
• ينسّق تسلسل مراجعات واحد ودائم ومتزايد باطّراد لكل عضو/مصدر التحديثاتِ التزايدية والتسوية وإعادة المحاولات.
• يفهم المشغّلون سلوك الحذف، والاستبدال الكامل، وعدم التكرار، والتعارض، والبيانات القديمة، و[] الصريحة.
• لكل scope_key، بما في ذلك default، تعيين معتمد في Performance Hub؛ وتم اختبار أن المفاتيح غير المعروفة تخفق بشكل مغلق.
• تمت تهيئة وتيرة التحديث المتوقعة للتكامل، والحد الأقصى لعمر بيانات المصدر، وسلوك المصدر القديم، والتنبيهات.
• ثبت أن إخفاق الجلب من المصدر لا يُصدر لقطة فارغة أو جزئية.
• يستوفي تقارب تسلسل المراجعات في مرحلة الاختبار، والإلغاء/السحب، وحدود البدء والانتهاء على الأبواب الفعلية الأهدافَ المتفق عليها.
• تم التحقق من القواعد العادية والمنح الدائمة بوصفها مسارات احتياطية، ولا يمكن للنوافذ تجاوز تعطيل المستخدم، أو blockAllAccess، أو الصيانة، أو Geofence.

الجاهزية للتحكم في الوصول

بالنسبة إلى تكاملات التحكم في الوصول:

• يتخذ نظامك قرار الوصول قبل استدعاء Performance Hub.
• يتعامل التكامل مع device_offline وmaintenance_mode_active وunlock_confirmation_timeout.
• يفهم المشغّلون أن انتهاء المهلة يعني أن فتح القفل لم يُؤكَّد.
• تخزّن سجلاتك قيمتي event_id وcommand_id المُرجعتين.
• لديك إجراء احتياطي يدوي لموظفي المنشأة.

معالجة الأخطاء وإعادة المحاولة

• تُعرض الاستجابات 400 و401 و403 و404 و409 و422 على المشغّلين أو فرق الدعم بدلًا من إعادة محاولتها دون تمحيص.
• تستخدم الاستجابات 429 و500 و502 و503 و504 منطق إعادة محاولة محدودًا مع التراجع.
• تُنشئ حالات الإخفاق المتكررة تنبيهًا في نظامك.
• لا يُسقط التكامل السجلات التي أخفقت بصمت أبدًا.

إمكانية المراقبة

• تتضمن سجلاتك نقطة النهاية، والطابع الزمني، ومعرّف المنشأة، ومعرّف السجل المصدر، ونتيجة الطلب، ونص الاستجابة.
• يمكن لفريق الدعم لديك البحث حسب معرّف العضو، أو معرّف المنشأة، أو معرّف تسجيل الدخول، أو معرّف حدث فتح القفل.
• لديك طريقة لإعادة تشغيل عمليات المزامنة التي أخفقت أو تسويتها.

الإطلاق في بيئة الإنتاج

• أكّد Performance Hub إمكانية وصولك إلى بيئة الإنتاج.
• فعّلت منشأة واحدة على الأقل في بيئة الإنتاج تكاملك.
• مفتاح الإنتاج الخاص بك نشط.
• بيانات جهات الاتصال التشغيلية والتقنية لديك محدّثة.
• إجراءات الدعم لديك موثّقة للعملاء.

بعد اكتمال هذه الفحوصات، سيظهر تكاملك المهيّأ في دليل شركاء Performance Hub داخل منصة Performance Hub الأساسية.