Developer Portal¶
Production · Capa 4 — Producto vertical ·
Repositorio: developer-gerege-mn · developer.gerege.mn
El punto de entrada único para quienes desarrollan sobre el ecosistema Gerege: un catálogo de API, las indicaciones para registrar aplicaciones y un asistente de IA — organizados según la arquitectura de información de los mejores portales de desarrollo del mundo (Stripe · Twilio · Singapore APEX).
Alcance — deliberadamente estrecho¶
Este portal no intenta hacerlo todo. Lo que hay dentro:
- el panel del desarrollador (primeros pasos),
- el catálogo de API — por cada API: scopes, endpoints y ejemplos cURL que funcionan,
- las indicaciones para registrar una aplicación,
- un asistente de IA,
- un núcleo de administración mínimo.
Lo que NO hay dentro: servicios de cara al ciudadano, circuitos documentales, pagos. Todo eso está en Gerege Platform.
La regla más importante — las credenciales no viven aquí¶
El portal NO CREA clientes OAuth
El Developer Portal no crea clientes OAuth y no ve ni guarda los
client secret. El registro de aplicaciones ocurre íntegramente en
Gerege SSO (sso.gerege.mn).
El portal solo explica qué hay que preparar y enlaza en profundidad con la consola del SSO.
El motivo: si las credenciales viven a la vez en dos sistemas, tarde o temprano divergirán — un cliente borrado en un lado sigue funcionando en el otro, una rotación de secreto nunca llega al otro lado, y así. Una única fuente es el único montaje fiable.
Autenticación¶
El propio portal es un RP de OIDC de Gerege SSO: el acceso ocurre en
sso.gerege.mn mediante eID. No tiene sistema de contraseñas propio.
Estructura¶
developer-gerege-mn/
├── backend/ # Go · chi · pgx · PostgreSQL · Redis · Gerege SSO (RP de OIDC)
│ └── docs/ # ARCHITECTURE · DEVELOPMENT · API_CONTRACT · SECURITY (EN/MN)
├── frontend/ # BFF de Next.js
└── docs-site/ # MkDocs — la documentación propia del portal
Páginas principales¶
| Ruta | Contenido |
|---|---|
/dashboard |
Panel con los primeros pasos |
/apis |
Catálogo de API — scopes, endpoints, ejemplos cURL |
/apps |
Cómo registrar una aplicación (enlaces a la consola del SSO) |
La variante gubernamental¶
developer.dgov.mn (repositorio developer-dgov-mn) es el mismo portal en la
línea gubernamental. Es de código abierto — véase
Línea gubernamental.
Documentación detallada¶
El sitio de documentación propio del portal está en el directorio docs-site/
del repositorio developer-gerege-mn, construido con MkDocs, en mongol e
inglés. Capítulos principales: Introducción · Arquitectura · Autenticación
(eID + SSO, registrar una app, el eID Service Proxy, el API Gateway) ·
Seguridad · Operación.