अनुवाद वास्तुकला के लिए संसाधन संरचना, API, संग्रहण, उपकरण, परीक्षण मैट्रिक्स, और रिलीज़ जांच निर्दिष्ट करता है। यह संदर्भ अपनाने की सीमा, विफलता व्यवहार, और प्रेक्षणीय साक्ष्य को तय करता है जबकि पर्यावरण-विशिष्ट सीमाओं को कॉन्फ़िगर करने योग्य छोड़ता है।
पैकेज स्थिति: संदर्भ संदर्भ मानव समीक्षा के लिए तैयार। अनुबंध और परीक्षण परिदृश्य पूर्ण हैं, लेकिन यह दावा नहीं किया गया है कि किसी अपनाने वाले कार्यान्वयन ने उन्हें पारित किया है।
निर्णय
अनुवाद वास्तुकला के लिए, कैनोनिकल लोकल-न्यूट्रल डेटा और स्पष्ट प्रस्तुति लोकल को अपनाएं। व्यवहार को एक प्राधिकृत लेखन पथ, टाइप किए गए इंटरफेस, स्पष्ट स्थिति, और आइडेम्पोटेंट साइड-इफेक्ट हैंडलिंग के माध्यम से लागू करें। यह पैकेज एक संदर्भ अनुबंध है: अपनाने वाली टीम को अपने पर्यावरण में साक्ष्य से संख्यात्मक सीमाएँ, प्रदाता, अधिकार क्षेत्र, और परिचालन मालिक चुनने होंगे।
दायरा
- अनुवाद वास्तुकला के अभिनेता, इनपुट, आउटपुट, स्थिति, नीति या स्कीमा संस्करण, और बाहरी रूप से दिखाई देने वाले परिणाम जो इस कार्यान्वयन ब्लॉक द्वारा वर्णित हैं।
- प्राथमिक और वैकल्पिक इंटरफेस, पृष्ठभूमि कार्य, कैश, एकीकरण, समर्थन पथ, और साक्ष्य जो समान सीमा का परीक्षण कर सकते हैं।
- संदर्भ को सुरक्षित रूप से लागू करने के लिए आवश्यक अपनाने-विशिष्ट कॉन्फ़िगरेशन, रोलआउट, पुनर्प्राप्ति, और सत्यापन जिम्मेदारियां।
इस ब्लॉक के बाहर
- प्रत्येक अपनाने वाले के लिए एक सार्वभौमिक विक्रेता, फ्रेमवर्क, अधिकार क्षेत्र, संख्यात्मक सीमा, प्रतिधारण अवधि, या सेवा-स्तर उद्देश्य चुनना।
- यह दावा करना कि पैकेज किए गए परिदृश्य किसी डाउनस्ट्रीम कार्यान्वयन के खिलाफ चलाए गए हैं या यह संदर्भ कानूनी, सुरक्षा, या पहुँच प्रमाणन प्रदान करता है।
अनुबंध
- कैनोनिकल मान और स्थिर अनुवाद कुंजियाँ संग्रहित करें; केवल प्रस्तुति या दस्तावेज़-निर्माण सीमाओं पर लोकल-विशिष्ट स्वरूपण लागू करें।
- अनुरोधित, उपयोगकर्ता, संगठन, और उत्पाद फॉलबैक लोकल को एक निर्धारक, प्रेक्षणीय श्रृंखला के माध्यम से हल करें।
- भाषा टैग और लोकल डेटा को बनाए गए मानकों से उपयोग करें; भाषा, क्षेत्र, मुद्रा, या कानूनी शर्तों को एक-दूसरे से अनुमानित न करें।
- प्रतिनिधि फिक्स्चर के साथ विस्तार, बहुवचन श्रेणियाँ, द्विदिश पाठ, लापता संसाधन, समय क्षेत्र, मुद्राएँ, और गैर-लैटिन इनपुट का परीक्षण करें।
- सीमा पर एक बार इनपुट मान्य करें और डाउनस्ट्रीम लॉजिक द्वारा उपयोग किए गए सामान्यीकृत प्रतिनिधित्व को संरक्षित करें।
- व्यवसाय संक्रमण को आउटबॉक्स रिकॉर्ड के साथ पहले या परमाणु रूप से संग्रहित करें; उपभोक्ता टिकाऊ संचालन पहचान द्वारा डुप्लिकेट को हटाते हैं।
- प्रत्येक अनुरोध या उपयोगकर्ता संदर्भ के लिए लोकल को एक बार हल करें और स्थिर कुंजियाँ तथा टाइप किए गए इंटरपोलेशन का उपयोग करें, अनुवादित खंडों को जोड़ने के बजाय।
- उत्पाद UI, उपयोगकर्ता-रचित सामग्री, लेनदेन दस्तावेज़, और कानूनी प्रति को अलग करें क्योंकि उनके फॉलबैक और अनुमोदन नियम अलग होते हैं।
कार्यान्वयन मार्गदर्शन
- पहले अतिरिक्त संग्रहण और इंटरफेस परिवर्तन भेजें, प्रेक्षणीय रूप से बैकफिल करें, फिर संगतता साक्ष्य के बाद पुराने पथों को सेवानिवृत्त करें।
- फ्रेमवर्क या विक्रेता विवरण चुनने से पहले अनुवाद वास्तुकला के इनपुट, आउटपुट, अभिनेता, स्थिति, अपरिवर्तनीय, साइड इफेक्ट, और साक्ष्य का मॉडल बनाएं।
- लागू अनुवाद वास्तुकला अनुबंध या नीति संस्करण को भौतिक स्थिति के साथ संग्रहित करें ताकि माइग्रेशन, पुनःप्रसारण, और समर्थन निर्णय उत्तरदायी बने रहें।
- नियंत्रित रोलआउट के पीछे पथ पेश करें, अपेक्षित और प्रेक्षित परिणामों की तुलना करें, और अपनाने के साक्ष्य पूर्ण होने तक एक परीक्षण पुनर्प्राप्ति मार्ग रखें।
विफलता हैंडलिंग और सुरक्षा उपाय
- लापता या अमान्य संसाधन घोषित फॉलबैक श्रृंखला का पालन करता है, कुंजी और लोकल को सुरक्षित रूप से रिकॉर्ड करता है, और कभी भी आंतरिक पहचानकर्ता को अंतिम प्रति के रूप में उजागर नहीं करता।
- अमान्य या विरोधाभासी अनुवाद वास्तुकला स्थिति को अस्वीकार या क्वारंटीन किया जाता है; कार्यान्वयन कभी भी ऐसा मान अनुमानित नहीं करता जो प्राधिकरण को बढ़ाए या प्रभाव को डुप्लिकेट करे।
- पुनः प्रयास सीमित होते हैं और टिकाऊ पहचान का उपयोग करते हैं; समाप्ति के बाद, कार्य निरीक्षणीय अंतिम स्थिति तक पहुँचता है जिसमें एक उत्तरदायी मालिक होता है।
सत्यापन और संचालन
- संग्रहण से पहले और बाद में निर्भरता विफलता इंजेक्ट करें और साबित करें कि पुनः प्रयास एक बाहरी रूप से दिखाई देने वाले परिणाम पर संगम करता है।
- अनुबंध संस्करण के अनुसार अनुवाद वास्तुकला की सफलता, अस्वीकृति, मान्यता विफलता, निर्भरता विफलता, पुनः प्रयास समाप्ति, और पुनर्प्राप्ति की निगरानी करें बिना संवेदनशील पेलोड आयामों के।
- नीति, स्कीमा, निर्भरता, माइग्रेशन, या सीमा परिवर्तनों के बाद जोड़ीदार सकारात्मक और नकारात्मक फिक्स्चर को पुनः चलाएं और परिणामी साक्ष्य संरक्षित करें।
अपनाने की धारणाएँ
- उदाहरण में नाम और मान एक ठोस फिक्स्चर हैं, सार्वभौमिक डिफ़ॉल्ट नहीं; अपनाने वाले उन्हें प्रलेखित साक्ष्य और स्वामित्व के माध्यम से बदलते हैं।
- अपनाने वाली प्रणाली प्रमाणीकृत पहचान, टिकाऊ संचालन या रिकॉर्ड संस्करण, सीमित टेलीमेट्री, और परिवर्तन के लिए नियंत्रित पथ प्रदान कर सकती है।
इस पैकेज में निष्पादन-समान उदाहरण फिक्स्चर और स्वीकृति अनुबंध हैं। संरचना और मेटाडेटा जांचने के लिए संग्रह सत्यापक चलाएं, फिर लक्षित रिपॉजिटरी में परिदृश्यों का अनुवाद और निष्पादन करें और कार्यान्वयन साक्ष्य रिकॉर्ड करें।