Gerege Verify (XYP)¶
Production · الطبقة 2 — الاستعلام ·
المستودع: sso-gerege-mn (xyp.gerege.mn/) · xyp.gerege.mn
خدمة استعلام تتحقّق من بيانات الشركات والجهات في مقابل السجل الحكومي. وتتألّف من واجهة برمجية بلغة Go وشاشة إدارية بـ Next.js.
ماذا تفعل؟¶
حين تُنشئ منصّات المنظومة جهةً، أو تضيف عضوًا، أو تمنح صلاحية، تحتاج غالبًا إلى تأكيد أنّ الجهة قائمة فعلًا في السجل الحكومي. وتوفّر Gerege Verify ذلك الاستعلام من نافذة واحدة.
الاستعمالات المعتادة:
- هل الجهة مسجّلة، وهل يتطابق اسمها ورقم تسجيلها،
- من هم المسؤولون المفوَّضون في الجهة،
- هل يرتبط مواطن بعينه بتلك الجهة.
البنية¶
| الجزء | التقنية | الدور |
|---|---|---|
api/ |
Go | واجهة الاستعلام، وإدارة العملاء ومفاتيح API، وعدّادات الاستخدام |
web/ |
Next.js | وحدة تحكّم إدارية — تسجيل العملاء وتقارير الاستخدام |
نموذج الواجهة البرمجية¶
| المسار | الغرض |
|---|---|
/v1/* |
واجهة الاستعلام الأساسية — مع تحديد للمعدّل |
/api/clients |
تسجيل العملاء (للمشرف) |
/api/usage |
قياس الاستخدام عن بُعد (للمشرف) |
/health |
فحص السلامة |
ويُضبط الوصول بـمفاتيح API. فلكل عميل مفتاحه، ويُحتسب استخدامه ويظهر في الشاشة الإدارية.
لماذا تهمّ العدّادات؟
قد يكون الاستعلام من السجل الحكومي مصدرًا مدفوعًا ومحكومًا بحصّة. ومن دون احتساب لكل عميل على حدة يتعذّر توزيع الكلفة أو كشف التجاوز. وهناك كذلك مقتضى تدقيقي: تتبّع من استعلم عن بيانات أي جهة.
من يستخدمها؟¶
- Gerege Platform و Template Platform — في مسارات إنشاء الجهات والبحث عنها،
- Gerege Wallet — في مسار حساب الجهة،
- أدوات الإدارة الداخلية.
العلاقة بـ X-Road¶
على المدى الطويل تتّجه الاستعلامات بين الجهات إلى التوحيد القياسي على X-Road. وGerege Verify اليوم قناة استعلام تعمل بموازاة X-Road؛ وبعد اعتماد X-Road اعتمادًا كاملًا قد ينتقل بعض تلك الاستعلامات إليه.
الوثائق التفصيلية¶
توجد وثائق التنفيذ في مجلّد xyp.gerege.mn/ داخل مستودع sso-gerege-mn.