KYC Studio، مسارات قائمة على المخططات

المشكلة

كانت مسارات التحقق لأكثر من 100 دولة تعني شيفرة مكررة، وتذكرة هندسية في كل مرة يريد فيها فريق الامتثال أو المنتج تغيير قاعدة إقليمية.

النهج

• عرض النماذج من المخطط. تقرأ الواجهة إعدادات JSON أو YAML عبر jsonform: المخطط يولّد الحقول وقواعد التحقق. أما الإجراءات المخصصة، مثل تشغيل جسر NFC الأصلي أو فحص الحيوية، فتبقى في الشيفرة.
• خطوة واحدة ونتائج مختلفة. تحدد الإعدادات ما تفعله الخطوة لكل دولة ومنصة (الويب أو الجوال أو Mini Program). حيث يتوفر NFC تعرض الخطوة إرشادات المسح وزر «امسح عبر NFC»، وفي غير ذلك تعرض حقول النموذج العادية وزر «متابعة». ويغيّر فريقا المنتج والامتثال ذلك في الإعدادات لا في الشيفرة.
• الإعدادات كشيفرة. يقدّم مسؤولو الامتثال والمنتج التغييرات عبر Git. يفتح كل تغيير pull request تلقائيًا ويشغّل CI مع تحقق صارم من المخطط مدعوم بأنواع TypeScript، فتفشل الإعدادات المعيبة قبل أن تصل إلى الإنتاج.

قراران يستحقان الشرح

jsonform للعرض، والشيفرة للإجراءات. الواجهة التي يقودها الخادم بالكامل وتنفّذ منطقًا عشوائيًا يرسله الخادم تفتح الباب لخطر تنفيذ الشيفرة عن بُعد ولمشكلات في الأداء. أما العرض القائم على البيانات مع ربط الإجراءات بمعالجات مُجمّعة مسبقًا، فيحافظ على المرونة دون هذا الخطر.

Git بدل نموذج إداري. التعديلات السهلة بلا حوكمة تكسر مسارات الإنتاج. وطلبات الدمج وفحوص الأنواع وCI تجعل كل تغيير معروف المصدر ومُراجعًا وسهل التراجع.

النتيجة

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