Microservicios

Microservicios es el registro a nivel de plataforma donde los administradores del sistema registran, configuran y monitorean los microservicios de micro-frontend. Cada entrada de microservicio controla cómo el shell carga el servicio — incluyendo su URL remota para module federation, ruta de menú, metadatos del panel, configuración del registro de eventos y estado activo. La página es visible para superusuarios (operadores de plataforma) en modo multi-tenant; en modo single-tenant muestra la vista Mis Aplicaciones en su lugar.

Acceso a la Página

• Ruta: /microservices
• Ruta de Menú: Configuración → Sistema → Microservicios
• Audiencia principal: Solo administradores del sistema. Se accede mediante el inicio de sesión de administrador del sistema en system.portal.net — no el portal del tenant.

Qué puedes hacer aquí

• Ver todos los microservicios registrados con su nombre, nombre visible, estado activo, insignia de salud en tiempo real, ruta de menú y fecha de creación.
• Filtrar la lista para mostrar solo servicios activos o incluir los inactivos usando el interruptor Mostrar Inactivos.
• Buscar servicios por nombre, nombre visible o ruta de menú.
• Hacer clic en una fila o en la acción Editar para abrir el formulario completo de configuración del servicio.
• Monitorear la salud de cada servicio — hacer clic en una insignia de salud abre el endpoint /health del servicio en una nueva pestaña.

Tareas comunes

1. Abrir Configuración → Sistema → Microservicios en system.portal.net.
2. Usar el campo de Búsqueda para localizar un servicio por nombre o ruta de menú.
3. Activar Mostrar Inactivos si necesitas ver o reactivar un servicio desactivado.
4. Hacer clic en una fila de servicio para abrir su formulario de configuración y revisar la URL remota, metadatos de menú, configuración del panel y ajustes de eventos.
5. Actualizar los campos necesarios y guardar. Verificar que la insignia de salud vuelva a verde después de que el servicio se reinicie.

Notas

• Los servicios se cargan en orden de menú — el campo menuOrder controla su posición en la barra lateral de navegación.
• Un servicio con isActive establecido en falso se oculta de la navegación y se excluye del acceso del tenant, pero su registro se conserva.
• La insignia de Salud consulta la URL base de la API configurada del servicio en <apiBaseUrl>/health. Una insignia que muestra Verificando significa que la consulta está en progreso; No Saludable significa que el endpoint devolvió un error — pasa el cursor sobre la insignia para ver el mensaje de error.
• El ordenamiento y filtrado se realizan del lado del cliente — todos los servicios se obtienen en una sola solicitud.
• Solo los superusuarios (isSuperuser) pueden acceder a esta página. Los usuarios sin permisos de superusuario ven un mensaje de acceso denegado.
• Cuando Configuración del Sistema → Modo de Acceso a Microservicios está configurado como Todos los servicios activos para todos los tenants, cada microservicio activo se expone automáticamente a cada tenant — se omite la tabla de concesiones por tenant y la pestaña Acceso a Microservicios en la página de edición del tenant se oculta. Al volver al modo Por tenant se restauran las concesiones previas.

Registro de servicios

Los microservicios no se crean desde esta página — cada servicio se registra a sí mismo en la plataforma cuando arranca, llamando al endpoint de registro. La lista en esta página refleja los servicios que se han registrado exitosamente. Las propiedades declaradas por el servicio son de solo lectura aquí; los controles dirigidos al tenant (activo/inactivo, acceso por tenant) sí son editables.

Campos declarados por el servicio (solo lectura)

Campo	Descripción
Nombre	Identificador interno con el que se registró el servicio (p. ej., inventory). Se usa como clave de registro.
Nombre Visible	Etiqueta legible mostrada en la interfaz.
Ruta de Menú	Ruta de navegación que aporta el servicio (p. ej., /inventory). Vacío para servicios solo-backend.
Orden de Menú	Posición en la barra lateral; los números menores aparecen primero.
URL Base de la API	URL base para la API del servicio, utilizada para verificaciones de salud.
URL Remota	URL remota de module federation para el bundle del micro-frontend. Vacío para servicios solo-backend.
Modo de Registro	with-frontend — el servicio incluye un bundle de micro-frontend cargado vía module federation y registra menús/rutas (predeterminado). backend-only — servicio solo-API sin URL remota, sin entrada de menú y sin rutas; usado para servicios que solo aportan endpoints de backend.
Configuraciones Centrales Requeridas	Lista de configuraciones centrales (p. ej., numeración de documentos, plantilla de impresión, periodos fiscales, reportes permitidos) que deben configurarse antes de que el servicio pueda usarse. Los endpoints devuelven errores de guardia cuando una configuración central requerida no está presente.

Editar un Microservicio

Hacer clic en una fila de la lista para abrir la página de detalle del servicio. La página muestra los campos declarados por el servicio anteriores como datos de solo lectura, además de controles editables para la activación global y (cuando la plataforma está en modo de acceso por tenant) el acceso por tenant.

• Habilitar Globalmente — alterna el indicador isActive del servicio. Cuando está OFF, el servicio se oculta de la navegación de cada tenant y se excluye del acceso sin importar las concesiones. El registro del servicio se conserva para poder reactivarlo más tarde.
• Configuración del Tenant (solo en modo de acceso por tenant) — otorga o revoca el acceso de tenants individuales al servicio. Se oculta cuando Modo de Acceso a Microservicios está configurado como Todos los servicios activos para todos los tenants.

Para cambiar un campo declarado por el servicio (nombre, ruta de menú, URL remota, modo de registro, configuraciones centrales requeridas), redespliega el servicio con la llamada de registro actualizada — la plataforma actualiza el registro en el próximo registro exitoso.

Páginas Relacionadas

• Configuración del Sistema — alterna entre los modos de acceso a microservicios por tenant y global.
• Gestión de Tenants — las páginas de detalle de tenant muestran qué microservicios están habilitados por tenant cuando se está en modo por tenant.
• Claves de API de Servicio — claves de API a nivel de plataforma usadas en llamadas servicio a servicio.