Developer Portal¶

Production · الطبقة 4 — منتج قطاعي · المستودع: developer-gerege-mn · developer.gerege.mn

المدخل الموحّد للمطوّرين الذين يبنون على منظومة Gerege: كتالوج لواجهات البرمجة، وإرشادات تسجيل التطبيقات، ومساعد بالذكاء الاصطناعي — مرتَّبة وفق بنية المعلومات المتّبعة في أفضل بوابات المطوّرين عالميًا (Stripe · Twilio · Singapore APEX).

نطاق التغطية — ضيّق بقصد¶

لا تحاول هذه البوّابة أن تفعل كل شيء. وما فيها:

لوحة المطوّر (خطوات البدء)،
كتالوج واجهات البرمجة — لكل واجهة نطاقاتها (scope) ونقاط نهايتها وأمثلة cURL عاملة،
إرشادات تسجيل التطبيق،
مساعد بالذكاء الاصطناعي،
نواة إدارية بالحد الأدنى.

وما ليس فيها: الخدمات الموجّهة إلى المواطن، ودورة المستندات، والمدفوعات؛ فتلك كلها على Gerege Platform.

أهمّ قاعدة — بيانات الاعتماد لا تعيش هنا¶

البوّابة لا تُنشئ عملاء OAuth

لا يُنشئ Developer Portal عملاء OAuth، ولا يرى أسرارهم ولا يخزّنها. فتسجيل التطبيقات يجري بالكامل على Gerege SSO (sso.gerege.mn).

وتكتفي البوّابة بـشرح ما ينبغي تجهيزه ووضع رابط عميق إلى وحدة تحكّم SSO.

والسبب: إذا عاشت بيانات الاعتماد في نظامَين في آن واحد فستتباعد يومًا ما — عميل حُذف في جهة يظلّ يعمل في الأخرى، وتدوير السرّ لا يصل إلى الطرف الثاني، وهكذا. والمصدر الواحد هو الترتيب الموثوق الوحيد.

المصادقة¶

البوّابة نفسها جهة معتمِدة لـ OIDC تابعة لـ Gerege SSO — ويجري الدخول على sso.gerege.mn بـ eID. وليس لها نظام كلمات مرور خاص.

البنية¶

developer-gerege-mn/
├── backend/     # Go · chi · pgx · PostgreSQL · Redis · Gerege SSO (OIDC RP)
│   └── docs/    # ARCHITECTURE · DEVELOPMENT · API_CONTRACT · SECURITY (EN/MN)
├── frontend/    # Next.js BFF
└── docs-site/   # MkDocs — the portal's own documentation

الصفحات الرئيسة¶

المسار	المحتوى
`/dashboard`	لوحة خطوات البدء
`/apis`	كتالوج واجهات البرمجة — النطاقات ونقاط النهاية وأمثلة cURL
`/apps`	كيفية تسجيل تطبيق (روابط إلى وحدة تحكّم SSO)

النسخة الحكومية¶

developer.dgov.mn (المستودع developer-dgov-mn) هي البوّابة نفسها على الخط الحكومي، وهي مفتوحة المصدر — راجع الخط الحكومي.

الوثائق التفصيلية¶

يوجد موقع وثائق البوّابة الخاص في مجلّد docs-site/ بمستودع developer-gerege-mn، مبنيًّا بـ MkDocs وبالمنغولية والإنجليزية. وأبرز أبوابه: المقدّمة · البنية المعمارية · الدخول (eID + SSO، وتسجيل التطبيق، ووكيل خدمة eID، وبوابة API) · الأمان · التشغيل.