मानक

कार्यान्वयन

A-REX Core का कार्यान्वयन किसे माना जाता है, कौन-से कार्यान्वयन सूचीबद्ध हैं, अनुरूपता का दावा क्या कहता है, और कोई कार्यान्वयन सूची में कैसे आता है।

कार्यान्वयन क्या है

कार्यान्वयन ऐसा सॉफ़्टवेयर है जिसे दूसरे लोग मानक के आधार पर जाँच सकते हैं। यह चार में से किसी एक रूप में होता है:

एक बैच टोकन जो मानक के इंटरफ़ेस लागू करता है;
एक हुक: एक नियम अनुबंध जो IARexHook लागू करता है और कई टोकनों की सेवा कर सकता है;
एक सत्यापन रजिस्टर: एक सहायक अनुबंध जो किसी मौजूदा टोकन के लिए IARexAttest लागू करता है;
एक प्लेटफ़ॉर्म जो दूसरों के लिए टोकन संचालित करता है, अपने स्वयं के कार्यान्वयन पर या बिना बदलाव के तैनात संदर्भ कार्यान्वयन पर।

वॉलेट, एक्सप्लोरर, इंडेक्सर और अन्य टूल जो केवल A-REX टोकन पढ़ते हैं, वे भी सूचीबद्ध हो सकते हैं, लेकिन उनके लिए अनुरूप होने को कुछ नहीं है।

संदर्भ कार्यान्वयन arex-contracts है, MIT लाइसेंस के अंतर्गत। इसमें टोकन और उसका सत्यापन रजिस्टर (ARexToken और ARexAttestations), उदाहरण नियम अनुबंध और अनुरूपता सुइट शामिल हैं। यह दिखाता है कि मानक को लागू किया जा सकता है; यह स्वयं मानक नहीं है, और किसी कार्यान्वयन को इसका कोड दोबारा इस्तेमाल करने की ज़रूरत नहीं है। जब तक रिपॉज़िटरी निजी हैं, यह मानक के साथ जल्दी पहुँच का अनुरोध करें के ज़रिए साझा किया जाता है।

सूचीबद्ध कार्यान्वयन

यह सूची मानक रिपॉज़िटरी की ADOPTERS.md का अनुसरण करती है, जो प्रामाणिक रिकॉर्ड है। पंक्तियाँ वर्णानुक्रम में रखी जाती हैं, और हर पंक्ति समान शर्तों पर सूचीबद्ध होती है।

संगठन	भूमिका	कार्यान्वयन	चेन	स्थिति	संपर्क
A-REX Foundation: A-REX Platform	`platform`	संदर्भ कार्यान्वयन के साथ कंपनियों के लिए टोकन संचालित करता है, जो उसकी रिलीज़ से बिना बदलाव के तैनात है	अभी किसी सार्वजनिक नेटवर्क पर नहीं	`in development`	[email protected]

A-REX Foundation विनिर्देश और संदर्भ कार्यान्वयन का रखरखाव भी करता है, इसलिए A-REX Platform स्वतंत्र कार्यान्वयनकर्ता नहीं है: यह उस दो-कार्यान्वयनकर्ता नियम में नहीं गिना जाता जो मानक में बदलावों को नियंत्रित करता है। अभी कोई स्वतंत्र कार्यान्वयनकर्ता सूचीबद्ध नहीं है।

भूमिकाएँ हैं issuer, warehouse, lab, platform (दूसरों के लिए टोकन संचालित करता है), wallet और indexer। स्थितियाँ हैं planned, in development, pilot (वास्तविक बैच, सीमित दायरा), production, conformant (अनुरूपता सुइट पास करता है, रिपोर्ट लिंक के साथ) और retired।

अनुरूपता का अर्थ

अनुरूपता की जाँच उस अनुरूपता सुइट से होती है जो संदर्भ कार्यान्वयन के साथ आता है। सुइट किसी कार्यान्वयन तक केवल मानक इंटरफ़ेस और उसके लेखकों द्वारा लिखे गए एक छोटे एडेप्टर के माध्यम से पहुँचता है, इसलिए वह हर कार्यान्वयन की जाँच एक ही तरह से करता है। हर परीक्षण उस क्लॉज़ को दर्शाता है जिसकी वह जाँच करता है: कुल 87 क्लॉज़, 74 MUST स्तर पर और 13 SHOULD स्तर पर। हर रन तीन में से किसी एक निर्णय के साथ समाप्त होता है:

निर्णय	अर्थ
`CONFORMANT`	हर MUST क्लॉज़ पास होता है
`CONFORMANT (with skipped MUST clauses)`	कोई MUST क्लॉज़ विफल नहीं होता, लेकिन कुछ छोड़ दिए गए क्योंकि कार्यान्वयन वह उपलब्ध नहीं कराता जिसकी उन्हें ज़रूरत है
`NOT CONFORMANT`	कम से कम एक MUST क्लॉज़ विफल होता है

पूरे न हुए SHOULD क्लॉज़ रिपोर्ट किए जाते हैं और निर्णय को नहीं बदलते।

अनुरूपता का दावा A-REX Core का संस्करण, प्रोफ़ाइल, सुइट का संस्करण या कमिट और रन की तारीख बताता है। इसे बिना संपादित रिपोर्ट, जाँचे गए कमिट या तैनात पतों, पूरे न हुए SHOULD क्लॉज़ और किसी भी जानबूझकर किए गए विचलन के साथ प्रकाशित किया जाता है, और इसे हर छोड़े गए MUST क्लॉज़ का कारण बताना होता है। एक दावा मानक के एक संस्करण के लिए मान्य होता है: अपग्रेड के बाद और हर नए प्रमुख संस्करण के लिए इसे फिर से चलाया जाता है।

रिपोर्ट इस बात का साक्ष्य है कि सुइट जिन क्लॉज़ की जाँच करता है, उन पर कार्यान्वयन ने कैसा व्यवहार किया। जिन क्लॉज़ को चेन पर देखा नहीं जा सकता, जैसे यह नियम कि मूल संदर्भ में कोई व्यक्तिगत डेटा नहीं होता, वे समीक्षा पर छोड़े जाते हैं, इसलिए रिपोर्ट वह सब कवर नहीं करती जो मानक माँगता है।

सूची में होना समर्थन नहीं है

एक पंक्ति वह दर्ज करती है जो कोई संगठन अपने स्वयं के कार्यान्वयन के बारे में कहता है। यह A-REX Foundation या मानक के संपादकों का समर्थन, प्रमाणन या ऑडिट नहीं है, और कोई सशुल्क प्रमाणन या शुल्क नहीं है। conformant स्थिति पंक्ति से लिंक की गई प्रकाशित रिपोर्ट पर टिकी होती है; जब रिपोर्ट किसी दावे का समर्थन नहीं करती, तो संपादक उसे सुधारने या वापस लेने के लिए कह सकते हैं। जिस पंक्ति का संपर्क छह महीने तक जवाब नहीं देता, या जिसके लिंक काम करना बंद कर देते हैं, उसे सूचना के बाद retired चिह्नित किया जा सकता है।

सूची में कैसे आएँ

एक pull request खोलें जो मानक रिपॉज़िटरी की ADOPTERS.md में ऊपर की तालिका के स्तंभों के साथ एक पंक्ति जोड़े। जब तक रिपॉज़िटरी निजी है, पहले जल्दी पहुँच का अनुरोध करें पर पहुँच माँगें।
ऐसा संपर्क दें जो जवाब देता हो। सूचीबद्ध कार्यान्वयनकर्ताओं से मानक में प्रस्तावित बदलावों की पुष्टि करने या उन पर आपत्ति करने को कहा जाता है।
conformant स्थिति के लिए, अपने अनुरूपता दावे की रिपोर्ट लिंक करें।
स्वतंत्र कार्यान्वयनकर्ता के रूप में गिने जाने के लिए, pull request में घोषित करें कि इस काम के लिए आपका संगठन न तो A-REX Foundation या किसी अन्य सूचीबद्ध कार्यान्वयनकर्ता द्वारा नियंत्रित है और न ही उनसे भुगतान पाता है।

स्वतंत्र कार्यान्वयनकर्ता दो-कार्यान्वयनकर्ता नियम को आधार देते हैं: एक छोटा बदलाव तब स्वीकार होता है जब उनमें से दो पुष्टि करते हैं कि वे उसे अपना सकते हैं, और एक प्रमुख बदलाव तब जब उनमें से दो ने उसे लागू कर लिया हो और उसके साथ अनुरूपता सुइट पास करते हों। जब तक दो स्वतंत्र कार्यान्वयनकर्ता मौजूद नहीं हैं, स्वीकृत बदलाव अस्थायी चिह्नित किए जाते हैं।