Actualizar enlaces de módulos
Objetivo
Cambiar las URLs base que usa el hub para redirigir a Core, Observer, Perceiver, Insight, P.O.L.E y AIDA tras un despliegue, migración de dominio o entorno de pruebas.
Rol y requisitos
- Sesión activa en Optrax App (cualquier usuario autenticado puede usar el modal en la UI actual).
- Coordinación operativa: los cambios son globales para el despliegue (PostgreSQL).
- Lista de URLs HTTPS válidas por módulo.
Producción
Documenta el cambio y avisa a usuarios; un error deja el hub apuntando a hosts caídos.
Pasos
1. Reúne las URLs nuevas
Por entorno típico:
| Clave | Ejemplo prod |
|---|---|
| Core | https://core.optrax.io |
| Observer | https://observer.optrax.io |
| Perceiver | https://perceiver.optrax.io |
| Insight | URL del servicio Insight (puede diferir de Core) |
| Sentinel | https://graph.optrax.io |
| AIDA | https://aida.optrax.io |
Recuerda: VStation / streamers del overlay Observer no se editan aquí.
2. Abre el modal
- Inicia sesión en el hub.
- Pulsa el icono Configuración del sistema (engranaje, arriba a la izquierda).
3. Edita campos
Sustituye cada URL. Incluye https:// explícito (recomendado). Revisa typos en host y path.
4. Guarda
Pulsa ACTUALIZAR ENLACES. Confirma toast Configuración guardada correctamente.
5. Verifica
- Cierra el modal.
- Haz clic en cada nodo afectado y comprueba que la pestaña carga el entorno correcto.
- Si un módulo pide login, valida SSO y roles.
6. Rollback
Repite el proceso con las URLs anteriores (mantén copia en ticket o runbook).
Resultado esperado
GET /api/module-configs devuelve las nuevas URLs y el hub las usa de inmediato para todos los usuarios.
Errores comunes
| Problema | Qué hacer |
|---|---|
| 400 al guardar | Body inválido; solo strings clave→URL. |
| Insight sigue yendo a Core | Editaste Core pero no Insight. |
| Observer OK pero VStation mal | VStation es URL fija en overlay; no usa este modal. |
Consulta Configuración del sistema.
[SCREENSHOT REQUIRED: Configuration modal before and after changing Core URL with success toast]