Conceptos básicos
Shell vs módulo
- Shell (Optrax App): login, hub visual y persistencia de URLs base por nombre lógico de módulo.
- Módulo destino: aplicación Optrax independiente (Core, VStation, Perceiver, …) con su propia UI y permisos.
Claves de configuración
El modal CONFIGURACIÓN DEL SISTEMA edita un mapa clave → URL guardado en PostgreSQL:
| Clave | Nodo en UI |
|---|---|
Core | CORE |
Observer | OBSERVER (centro del overlay) |
Perceiver | PERCEIVER |
Insight | INSIGHT |
Sentinel | P.O.L.E |
AIDA | AIDA |
Al arrancar, el cliente fusiona respuesta del API con defaults embebidos para que ninguna clave falte.
Enlaces fijos de Observer
Tres accesos del overlay no pasan por la base de datos:
- Transmisor móvil →
https://m-streamer.optrax.io(por defecto en código). - Transmisor servidor →
https://s-streamer.optrax.io. - VStation →
https://vstation.optrax.io.
Para otros entornos (staging, on-prem) hoy requieren cambio en código o despliegue; planifica URLs acordes al dominio.
Auth Gateway
Optrax App no habla con Keycloak directamente en el login del usuario: usa el auth-gateway (AUTH_GATEWAY_URL, AUTH_GATEWAY_CLIENT_ID). Los tokens son los mismos que otros clientes OIDC del realm cuando comparten sesión SSO según despliegue.
Tenant en el token
El perfil de usuario puede incluir tenant (grupo organizativo IAM). El hub no filtra nodos por tenant; el aislamiento ocurre en cada producto downstream.
Nueva pestaña
Los nodos abren destinos con target="_blank" (o window.open). El shell permanece abierto para cambiar de módulo sin cerrar sesión del hub.
Viewer vs administrador en destinos
No existe rol “solo lectura” dentro del hub. La distinción admin/operador aplica en Auth Manager y en cada módulo enlazado, no en la edición de URLs del shell (cualquier usuario autenticado puede abrir el modal y guardar en la UI actual).
Restringe quién debe cambiar URLs de producción mediante proceso operativo; los cambios afectan a todos los usuarios del entorno.