Gerege Verify (XYP)¶
Production · Capa 2 — Consultas ·
Repositorio: sso-gerege-mn (xyp.gerege.mn/) · xyp.gerege.mn
Un servicio de consulta que verifica los datos de empresas y organizaciones contra el registro estatal. Se compone de una API en Go y una pantalla de administración en Next.js.
Qué hace¶
Cuando las plataformas del ecosistema crean una organización, añaden un miembro o conceden un permiso, a menudo necesitan confirmar que la organización existe realmente en el registro estatal. Gerege Verify ofrece esa consulta por una única ventanilla.
Usos habituales:
- si la organización está registrada y si su nombre y número de registro coinciden,
- quiénes son los cargos autorizados de la organización,
- si un ciudadano concreto está vinculado a esa organización.
Estructura¶
| Parte | Tecnología | Función |
|---|---|---|
api/ |
Go | API de consulta, gestión de clientes / claves de API, contadores de uso |
web/ |
Next.js | Consola de administración — registro de clientes, informes de uso |
Modelo de API¶
| Ruta | Propósito |
|---|---|
/v1/* |
La API principal de consulta — con rate limit |
/api/clients |
Registro de clientes (admin) |
/api/usage |
Telemetría de uso (admin) |
/health |
Comprobación de salud |
El acceso se rige por claves de API. Cada cliente tiene la suya, el uso se contabiliza y se ve en la pantalla de administración.
Por qué importan los contadores
Las consultas al registro estatal pueden ser una fuente de pago y con cuota. Sin contabilizar por cliente no hay forma de repartir el coste ni de detectar excesos. Además existe un requisito de auditoría: rastrear quién consultó los datos de qué organización.
Quién lo usa¶
- Gerege Platform y Template Platform — en sus flujos de creación y búsqueda de organizaciones,
- Gerege Wallet — en el flujo de cuenta de organización,
- las herramientas internas de administración.
Relación con X-Road¶
A largo plazo, las consultas entre organizaciones tienden a normalizarse sobre X-Road. Hoy Gerege Verify es un canal de consulta que funciona en paralelo a X-Road; una vez adoptado X-Road por completo, parte de esas consultas podría migrar allí.
Documentación detallada¶
La documentación de implementación está en el directorio xyp.gerege.mn/ del
repositorio sso-gerege-mn.