Ajustes
Propósito
Configurar apariencia (logo), umbrales de salud de cámaras e integración con Core Optrax. Solo usuarios con rol administrador acceden a esta pantalla.
Acceso
Administración → Ajustes (/settings). Otros roles son redirigidos al inicio.
Pestaña General
Logo
- Muestra el logo actual si existe.
- Subir logo — PNG o SVG, máximo 2 MB. El archivo se envía al servidor y aparece en el menú lateral.
- Quitar logo — restaura la marca Optrax por defecto.
Usuarios e integradores
Texto informativo en la misma pestaña:
- Usuarios y roles — se gestionan en auth-gateway (Keycloak), permiso
access-vstation. - API REST — enlace para descargar colección Postman (
Surveillance-API-Collection.json).
Para documentación OpenAPI del ecosistema, usa el portal optrax-docs → API Reference VStation.
Pestaña Salud de cámaras
Define umbrales para clasificar FPS, latencia (ms) y bitrate (kb/s):
| Nivel | FPS | Latencia | Bitrate |
|---|---|---|---|
| Bueno | Por encima de umbral bueno | Por debajo de umbral bueno | Por encima de umbral bueno |
| Regular | Entre regular y bueno | Entre bueno y regular | Entre regular y bueno |
| Malo | Por debajo de regular | Por encima de regular | Por debajo de regular |
Pulsa Guardar umbrales para persistir. Los banners de calidad en Cámaras y métricas del mapa usan estos valores.
Pestaña Integración Optrax
Conecta VStation con core.optrax.io (o URL configurada en servidor).
Estado
Muestra si Optrax está configurado o no configurado, mensaje del servidor y endpoint de cámaras cuando aplica. Si falta configuración, la UI indica variables .env (OPTRAX_API_URL, OPTRAX_API_TOKEN, opcional OPTRAX_CAMERAS_PATH).
Acciones (Optrax configurado)
| Botón | Función |
|---|---|
| Previsualizar cámaras Optrax | Lista hasta 20 entradas sin importar. |
| Sincronizar cámaras | Crea/actualiza/elimina cámaras espejo locales. |
| Sincronizar grupos | Alinea grupos Face-Dashboard. |
Tras sincronizar cámaras, un panel resume creadas, actualizadas, eliminadas y omitidas, más errores parciales si los hubo.
Las cámaras locales no se borran por la sync salvo las reglas definidas en el servicio de sincronización (las importadas Optrax sí pueden eliminarse si desaparecen del origen).
Casos especiales
- Subida de logo con tipo o tamaño inválido muestra error en pantalla.
- Sesión expirada al guardar umbrales: mensaje para volver a iniciar sesión.
Errores comunes
| Problema | Qué hacer |
|---|---|
| Optrax no configurado | Añade variables en servidor y reinicia contenedor. |
| Sync con errores | Revisa token, conectividad HTTPS y tabla de errores en UI. |
| Umbrales no aplican | Guarda de nuevo; refresca Cámaras y reconecta vista previa. |