Монгол العربية 中文 English Français Русский Español

Gerege Nexus

Plataforma Integrada de Operaciones Digitales

Gerege Nexus es una plataforma modular de código abierto que conecta servicios, operaciones, sistemas y datos de organizaciones públicas y privadas. Está diseñada con el mongol como idioma principal y se integra directamente con la infraestructura digital nacional de Mongolia (DAN, E-ID, XYP / ХУР).

Nexus es el punto de conexión: donde confluyen organizaciones, servicios, flujos de trabajo, sistemas, usuarios y datos. La plataforma en sí no está ligada a ningún sector — son los módulos que se ejecutan sobre ella los que definen cada despliegue.

Los módulos se compilan en un único binario de Go, mientras que una tienda de aplicaciones respaldada por PostgreSQL decide qué aplicaciones están activas por inquilino — separación modular sin los saltos de red ni el coste operativo de los microservicios.

Монгол  ·  العربية  ·  中文  ·  English  ·  Français  ·  Русский  ·  Español

Contenido

• Autores
• Capacidades principales
• Aplicaciones de negocio
• Estructura del repositorio
• Primeros pasos
• Configuración
• Resumen de la API
• Pruebas y controles de calidad
• Seguridad
• Índice de documentación

Autores

Capacidades principales

1. Monolito modular de alto rendimiento

• Módulos Go compilados — contacts, products, inventory, billing, documents y sso_clients se compilan en un solo binario y se invocan dentro del proceso.
• Tienda de aplicaciones por inquilino — los permisos de aplicación, los menús y el RBAC se gobiernan desde PostgreSQL (app_installations).
• Resolutor de dependencias — resolución recursiva sobre un grafo dirigido acíclico, con detección de ciclos y verificación de restricciones semver.
• Sincronización del catálogo — catalog/apps.json es la fuente de verdad; la tabla apps se reconcilia con él en cada arranque.

2. Motor de resiliencia cloud-native

3. Infraestructura digital nacional

• XYP — Intercambio de Información del Estado (platform/gerege/xyp.go): registro civil de ciudadanos (WS100101) y verificación de personas jurídicas (WS100201).
• E-ID nacional y DAN (developer.gerege.mn, eidmongolia.mn) — firma digital PKI, OTP móvil, SSO bancario y verificación facial biométrica.
• Proveedor OAuth2 / OIDC integrado (/.well-known/openid-configuration) que emite tokens de tipo client-credentials a sistemas de terceros.
• Verificación de correo electrónico (platform/emailverify) — un único flujo para demostrar una dirección, que cada módulo de aplicación llama en proceso. El correo lo envía el servicio alojado (enigma.mn), de modo que la plataforma no guarda credenciales de buzón ni posee dirección de remitente. La verificación se registra cuando la persona vuelve, y ese retorno sirve una sola vez. Visible en Ajustes → Verificación de correo.

Nota. El modo simulado (mock) de E-ID, DAN y XYP es únicamente una comodidad de desarrollo. Con ENVIRONMENT=production se desactiva automáticamente, de modo que un número de registro inventado nunca puede autenticarse.

4. Copiloto de IA y analítica

• Asistente de IA (platform/ai/copilot.go) — conversación clasificada por intención y conectada a los datos reales del inquilino.
• Previsión de demanda de inventario (platform/ai/inventory_forecaster.go) — recomendaciones de stock de seguridad y punto de pedido a partir del histórico de movimientos.

Aplicaciones de negocio

Las rutas solo se abren una vez que la aplicación está instalada y habilitada para el inquilino; de lo contrario el control devuelve 403 Forbidden.

Estructura del repositorio

backend/
  cmd/api/            Servidor de la API HTTP (+ datos de demostración)
  cmd/migrate/        Ejecutor de migraciones Goose
  db/migrations/      Migraciones SQL
  internal/
    module.go         El contrato de módulo de Go
    apps/             Módulos de negocio
    platform/         Servicios del núcleo de la plataforma
frontend/             Cliente web Next.js 16 (App Router)
catalog/              Catálogo y manifiestos de la tienda de aplicaciones
deploy/               Dockerfile de producción, configuración de Nginx
docs/                 Documentación y traducciones

Primeros pasos

Requisitos previos

• Go 1.26+
• Node.js 20+
• PostgreSQL 16+ (o Docker Compose)

1. Docker Compose

docker compose up -d

Las migraciones se ejecutan en un servicio migrate dedicado y de un solo uso antes de que arranque la API.

2. Manualmente

Backend:

cd backend
go mod download
DATABASE_URL="postgres://postgres:postgrespassword@localhost:5432/platform_db?sslmode=disable" \
  go run ./cmd/migrate up
go run ./cmd/api

Frontend:

cd frontend
npm ci
npm run dev

Abra http://localhost:3000.

Credenciales de demostración

La cuenta de demostración solo se crea fuera de producción. En producción se crea únicamente cuando se establece SEED_DEMO_DATA=true de forma explícita.

Despliegue automatizado

Cada push a main ejecuta deploy.yml:

1. Construir y publicar las imágenes de backend y frontend en GHCR (:latest y :<sha>).
2. Copiar docker-compose.prod.yml al servidor.
3. Escribir el .env del servidor desde los secretos de GitHub y descargar las imágenes.
4. Ejecutar las migraciones hasta el final y luego conmutar la API y el frontend.
5. Sondear /health y /ready, mostrar los registros de los contenedores y marcar la ejecución como fallida si el despliegue no está sano.

Despliegue manual: Actions → Deploy to Production → Run workflow, fijando opcionalmente una etiqueta de imagen.

Secretos requeridos en el repositorio:

El dominio de producción es nexus.gerege.mn, que sustituyó a openerp.gerege.mn en el cambio de nombre a Gerege Nexus. PUBLIC_ORIGIN define en un mismo lugar el CORS, el emisor OIDC y el callback de eID, de modo que moverlo arrastra consigo el DNS, el certificado TLS y todo cliente que haya fijado el emisor.

El servidor solo necesita Docker — sin código fuente ni cadena de herramientas Go/Node. Consulte deploy/.env.prod.example para los valores.

Configuración

Consulte .env.example para la lista completa.

Resumen de la API

Los tokens de sesión viajan en la cookie HttpOnly o como Authorization: Bearer <token>.

Pruebas y controles de calidad

# Pruebas unitarias del backend con el detector de carreras
cd backend && go test -race ./...

# Análisis estático
cd backend && go vet ./... && golangci-lint run

# Análisis de vulnerabilidades
cd backend && govulncheck ./...

# Compilación del frontend
cd frontend && npm run build

La CI ejecuta lint, pruebas, la compilación del frontend, la construcción de la imagen Docker, govulncheck y gosec en cada push y cada pull request.

Seguridad

• Los tokens de sesión son valores aleatorios de 256 bits; solo se almacena su resumen SHA-256.
• Las contraseñas se cifran con bcrypt y los intentos de inicio de sesión están limitados por IP.
• Instalar, habilitar o deshabilitar aplicaciones y registrar integraciones requiere derechos de administrador del inquilino.
• La autenticación de clientes OAuth2 usa comparación en tiempo constante.

Informe de vulnerabilidades según lo descrito en SECURITY.md.

Índice de documentación

Créditos e inspiración

1. snykk/go-rest-boilerplate de @snykk — fundamentos de la API REST en Go.
2. Odoo — tienda de aplicaciones modular y modelo de dependencias.
3. go-zero — motor de resiliencia cloud-native.

Licencia

Copyright (c) 2026 Gerege Systems Development Team, Gemini AI & Claude AI. Distribuido bajo la Licencia Apache 2.0 — véase LICENSE.

Iconos de banderas por Flaticon (atribución).