التنفيذات

ما التنفيذ

التنفيذ برمجيات يستطيع الآخرون التحقق منها مقابل المعيار. ويتخذ أحد أربعة أشكال:

• رمز دفعات ينفذ واجهات المعيار؛
• خطّاف: عقد قواعد ينفذ IARexHook ويمكنه أن يخدم رموزًا كثيرة؛
• سجل شهادات: عقد مرافق ينفذ IARexAttest لرمز قائم؛
• منصة تشغّل الرموز لحساب الآخرين، على تنفيذها الخاص أو على التنفيذ المرجعي منشورًا دون تعديل.

ويمكن أيضًا إدراج المحافظ والمستكشفات والمفهرسات وغيرها من الأدوات التي تقرأ رموز A-REX فقط، لكن ليس لديها ما تطابقه.

التنفيذ المرجعي

التنفيذ المرجعي هو arex-contracts، بموجب رخصة MIT. ويضم الرمز وسجل شهاداته (ARexToken وARexAttestations) وعقود قواعد نموذجية ومجموعة اختبارات المطابقة. وهو يبيّن أن المعيار قابل للتنفيذ؛ لكنه ليس المعيار، ولا يلزم أي تنفيذ أن يعيد استخدام شيفرته. وما دامت المستودعات خاصة، فإنه يُتاح مع المعيار عبر طلب وصول مبكر.

التنفيذات المدرجة

تتبع القائمة الملف ADOPTERS.md في مستودع المعيار، وهو السجل المرجعي. وتُرتَّب الصفوف أبجديًا، ويُدرج كل صف بالشروط نفسها.

تتولى A-REX Foundation أيضًا صيانة المواصفة والتنفيذ المرجعي، ولذلك فإن A-REX Platform ليست منفّذًا مستقلًا: فهي لا تُحتسب في قاعدة المنفّذَين التي تحكم تغييرات المعيار. ولا يوجد منفّذ مستقل مدرج حتى الآن.

الأدوار هي issuer وwarehouse وlab وplatform (تشغّل الرموز لحساب الآخرين) وwallet وindexer. والحالات هي planned وin development وpilot (دفعات حقيقية، نطاق محدود) وproduction وconformant (تجتاز مجموعة اختبارات المطابقة، مع رابط التقرير) وretired.

ما معنى المطابقة

يُتحقق من المطابقة بمجموعة اختبارات المطابقة التي تأتي مع التنفيذ المرجعي. ولا تصل المجموعة إلى التنفيذ إلا عبر واجهات المعيار ومهايئ صغير يكتبه مؤلفوه، ولذلك تختبر كل التنفيذات بالطريقة نفسها. ويحمل كل اختبار البند الذي يتحقق منه: 87 بندًا، منها 74 بمستوى MUST و13 بمستوى SHOULD. وينتهي التشغيل بأحد ثلاثة أحكام:

تُذكر بنود SHOULD غير المستوفاة في التقرير ولا تغيّر الحكم.

يذكر ادعاء المطابقة إصدار A-REX Core والملف التعريفي وإصدار مجموعة الاختبارات أو الإيداع الخاص بها وتاريخ التشغيل. ويُنشر مع التقرير دون تعديل، ومع الإيداع أو العناوين المنشورة التي اختُبرت، وبنود SHOULD غير المستوفاة، وأي انحراف مقصود، ويجب أن يشرح كل بند MUST تخطّاه. ويصح الادعاء لإصدار واحد من المعيار: يُعاد التشغيل بعد كل ترقية ومع كل إصدار رئيسي جديد.

التقرير دليل على سلوك التنفيذ في البنود التي تتحقق منها المجموعة. أما البنود التي لا يمكن ملاحظتها على السلسلة، مثل قاعدة أن مرجع المنشأ لا يحمل بيانات شخصية، فتُترك للمراجعة، ولذلك لا يغطي التقرير كل ما يتطلبه المعيار.

الإدراج ليس تزكية

يسجل الصف ما تصرّح به منظمة عن تنفيذها الخاص. وهو ليس تزكية ولا شهادة ولا تدقيقًا من A-REX Foundation أو من محرري المعيار، ولا توجد شهادة مدفوعة ولا رسوم. وتستند الحالة conformant إلى التقرير المنشور المرتبط من الصف؛ ويمكن للمحررين أن يطلبوا تصحيح الادعاء أو سحبه إذا لم يدعمه التقرير. ويجوز وسم الصف الذي لا تجيب جهة الاتصال فيه لستة أشهر، أو الذي تتوقف روابطه عن العمل، بأنه retired بعد إشعار.

كيف يُدرج التنفيذ

1. افتح طلب سحب (pull request) يضيف صفًا واحدًا إلى ADOPTERS.md في مستودع المعيار، بأعمدة الجدول أعلاه. وما دام المستودع خاصًا، اطلب الوصول أولًا عبر طلب وصول مبكر.
2. قدّم جهة اتصال تجيب. ويُطلب من المنفّذين المدرجين تأكيد التغييرات المقترحة على المعيار أو الاعتراض عليها.
3. للحالة conformant، اربط تقرير ادعاء المطابقة الخاص بك.
4. لكي تُحتسب منفّذًا مستقلًا، صرّح في طلب السحب بأن منظمتك لا تخضع لسيطرة A-REX Foundation ولا لسيطرة منفّذ مدرج آخر، ولا تتلقى منهما أجرًا عن هذا العمل.

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