Performance Hub लोगोPerformance Hub
साइट अनुभाग: डेवलपर और पार्टनर संसाधन

गो-लाइव चेकलिस्ट

प्रोडक्शन सुविधाओं के लिए किसी पार्टनर इंटीग्रेशन को सक्षम करने से पहले इस चेकलिस्ट का उपयोग करें।

Partner Console सेटअप

  • आपकी पार्टनर प्रोफ़ाइल पूरी है।
  • आपका लोगो URL, वेबसाइट, श्रेणी और विवरण सटीक हैं।
  • आपकी डेटा लिंकिंग विधि कॉन्फ़िगर है: Direct Link या Linking Identifier।
  • कम से कम एक वास्तविक सुविधा के साथ सुविधा लिंकिंग का परीक्षण किया गया है।
  • सही कुंजी प्रकार का उपयोग किया जा रहा है:
    • गैर-विनाशकारी राइट परीक्षण के लिए Dryrun।
    • डेटा के सुरक्षित उपयोग के लिए Read-only।
    • Live केवल तब, जब आप प्रोडक्शन डेटा को प्रभावित करने के लिए तैयार हों।

प्रमाणीकरण और कुंजी प्रबंधन

  • सीक्रेट कुंजियाँ केवल सर्वर-साइड पर संग्रहीत हैं।
  • कुंजियाँ क्लाइंट-साइड एप्लिकेशन, मोबाइल ऐप, सार्वजनिक रिपॉज़िटरी या सहायता टिकट में शामिल नहीं हैं।
  • कुंजी रोटेशन और रद्दीकरण का परीक्षण किया गया है।
  • आपकी टीम जानती है कि हर एनवायरनमेंट में कौन-सी कुंजी उपयोग होती है।

डेटा सत्यापन

  • आपके द्वारा कॉल किए जाने वाले हर एंडपॉइंट के लिए आवश्यक फ़ील्ड मौजूद हैं।
  • सुविधा पहचानकर्ता आपकी कॉन्फ़िगर की गई लिंकिंग विधि से मेल खाते हैं।
  • आपके सिस्टम की ID स्थिर हैं और सिंक के बीच नहीं बदलतीं।
  • बड़े इम्पोर्ट प्रलेखित सीमाओं के भीतर बैचों में बाँटे गए हैं।
  • विफल बैच आइटम की पहचान की जा सकती है और उन्हें दोबारा भेजा जा सकता है।

एंडपॉइंट परीक्षण

लॉन्च से पहले, हर उस एंडपॉइंट का परीक्षण करें जिस पर आपका इंटीग्रेशन निर्भर है:

  • संगठनों और सुविधाओं को पढ़ा जा सकता है।
  • सदस्यों को सहेजा और अपडेट किया जा सकता है।
  • सदस्यता प्लान, एक्सेस ज़ोन और एक्सेस घंटे सही तरीके से सिंक होते हैं।
  • चेक-इन स्वीकार किए जाते हैं और उन्हें आपके सिस्टम से वापस जोड़ा जा सकता है।
  • रिपोर्ट स्नैपशॉट अपेक्षित रिपोर्टिंग अवधि और मेट्रिक्स का उपयोग करते हैं।
  • जहाँ लागू हो, Door/Gate Controller फ़्लो का वास्तविक हार्डवेयर पर परीक्षण किया गया है।

Access Time Window की तैयारी

यदि इंटीग्रेशन Access Time Windows प्रदान करता है:

  • निरपेक्ष और साप्ताहिक उदाहरण प्रोड्यूसर प्रमाणन चेकलिस्ट पास करते हैं।
  • Epoch मान बिना उद्धरण चिह्नों वाले पूर्णांक Unix सेकंड हैं; सटीक [from, to) सीमाओं का परीक्षण किया गया है।
  • UTC डिफ़ॉल्ट, इंटीग्रेशन के कस्टम IANA टाइमज़ोन और प्रासंगिक डेलाइट-सेविंग बदलावों को सत्यापित किया गया है।
  • एक टिकाऊ, एकदिशीय (monotonic) सदस्य/स्रोत रिविज़न स्ट्रीम इंक्रीमेंटल अपडेट, रिकंसिलिएशन और पुनःप्रयासों का समन्वय करती है।
  • ऑपरेटर omitted, complete-replacement, idempotent, conflicting, stale और स्पष्ट-[] व्यवहार को समझते हैं।
  • default सहित हर scope_key का एक स्वीकृत Performance Hub मैपिंग है; अज्ञात कुंजियों के बंद अवस्था में विफल (fail closed) होने का परीक्षण किया गया है।
  • इंटीग्रेशन की अपेक्षित रीफ़्रेश आवृत्ति, स्रोत की अधिकतम आयु, पुराने स्रोत का व्यवहार और अलर्ट कॉन्फ़िगर किए गए हैं।
  • यह सिद्ध किया गया है कि अपस्ट्रीम फ़ेच विफलता से खाली या आंशिक स्नैपशॉट नहीं भेजा जाता।
  • स्टेज स्ट्रीम कन्वर्जेंस, रद्दीकरण/निरसन और भौतिक दरवाज़े की शुरुआत/समाप्ति सीमाएँ तय लक्ष्यों को पूरा करती हैं।
  • नियमित नियमों और स्थायी अनुमतियों को फ़ॉलबैक पथ के रूप में सत्यापित किया गया है, और विंडो उपयोगकर्ता अक्षमीकरण, blockAllAccess, मेंटेनेंस या जियोफ़ेंसिंग को बायपास नहीं कर सकतीं।

एक्सेस कंट्रोल की तैयारी

एक्सेस कंट्रोल इंटीग्रेशन के लिए:

  • 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 रिस्पॉन्स बैकऑफ़ के साथ सीमित पुनःप्रयास लॉजिक का उपयोग करते हैं।
  • बार-बार की विफलताएँ आपके सिस्टम में एक अलर्ट बनाती हैं।
  • इंटीग्रेशन कभी भी विफल रिकॉर्ड को चुपचाप नहीं छोड़ता।

ऑब्ज़र्वेबिलिटी

  • आपके लॉग में एंडपॉइंट, टाइमस्टैम्प, सुविधा पहचानकर्ता, स्रोत रिकॉर्ड ID, अनुरोध का परिणाम और रिस्पॉन्स बॉडी शामिल हैं।
  • आपकी सहायता टीम सदस्य ID, सुविधा ID, चेक-इन ID या अनलॉक इवेंट ID से खोज सकती है।
  • आपके पास विफल सिंक को दोबारा चलाने या उनका मिलान करने का तरीका है।

प्रोडक्शन लॉन्च

  • Performance Hub ने आपकी प्रोडक्शन पहुँच की पुष्टि कर दी है।
  • कम से कम एक प्रोडक्शन सुविधा ने आपका इंटीग्रेशन सक्षम किया है।
  • आपकी प्रोडक्शन कुंजी सक्रिय है।
  • आपके परिचालन और तकनीकी संपर्क अद्यतन हैं।
  • ग्राहकों के लिए आपकी सहायता प्रक्रिया प्रलेखित है।

ये जाँच पूरी होने के बाद, आपका कॉन्फ़िगर किया गया इंटीग्रेशन मुख्य Performance Hub प्लेटफ़ॉर्म के भीतर Performance Hub पार्टनर डायरेक्टरी में दिखाई देगा।