Explorador de tendencia

El explorador de tendencia es un historiador de señales que vive al fondo del detalle de tanque (/tanks/[id]). Permite superponer múltiples señales de un mismo tanque y navegar su historial —ya sea con presets rápidos o seleccionando un rango absoluto— para entender cómo ha evolucionado el inventario, la temperatura, la densidad o cualquier otra variable a lo largo del tiempo. Esta página documenta cómo usarlo.

Overlay multi-pluma (hasta 7 señales)

El explorador permite superponer hasta 7 señales —llamadas plumas— en un mismo gráfico. Cada pluma representa una variable del tanque (nivel, NSV, masa, temperatura, densidad, etc.).

Cada pluma tiene su propio eje-Y

Las plumas no comparten escala: cada una se dibuja contra su propio eje-Y. Esto es lo que hace útil superponer, por ejemplo, nivel (en metros) y temperatura (en °C) en el mismo gráfico — cada serie se lee en su unidad natural sin aplastar a las demás. Cada pluma tiene además un estilo y color propios que se persisten entre sesiones (hay 7 estilos de pluma por defecto), de modo que la misma señal se reconoce siempre por el mismo trazo.

Rango temporal: presets, rango absoluto y zoom/pan

Hay tres formas de elegir qué tramo del historial se muestra:

Control	Qué hace
Presets	Botones rápidos para los rangos habituales (p. ej. última hora / último día / última semana).
Rango absoluto	Un selector desde / hasta para fijar un intervalo exacto (p. ej. el turno de ayer).
Zoom / Pan	Acercar, alejar y desplazarse sobre el gráfico de forma interactiva.

Zoom/pan dispara un refetch al tier de resolución correcto

El explorador no carga todos los puntos en crudo: detrás hay un router de resolución que sirve datos pre-agregados en tres niveles (5 m / 1 h / 1 d). Cuando haces zoom o pan, el explorador dispara un refetch al tier adecuado para el rango visible: un rango de semanas se sirve agregado a 1 día; al acercarte a una hora concreta, recarga la resolución de 5 minutos. Así la respuesta se mantiene rápida sin sobrecargar el gráfico con millones de puntos. (Este router fue precisamente lo que resolvió la latencia de ~20 s que tenía la consulta directa sobre la hipertabla cruda.)

Umbrales y las 4 capas de eventos

Sobre la serie temporal se pueden superponer dos tipos de anotación: líneas de umbral y capas de eventos.

Las líneas de umbral dibujan los setpoints del tanque sobre el gráfico, de modo que se ve de un vistazo cuándo una señal cruzó un límite de alarma.

Las capas de eventos son la característica distintiva del historiador: marcan, sobre la línea de tiempo, cuándo ocurrió cada tipo de evento operativo. Hay 4 capas semánticas, alimentadas por un endpoint de eventos de 4 fuentes:

Capa	Qué marca	Fuente
Lab	Cuándo se tomó / aprobó una muestra de laboratorio (densidad, BSW, etc.).	Laboratorio
Aforo	Cuándo se registró un aforo manual (gauge).	Aforos / gauging
Custody	Cuándo se emitió un ticket de transferencia custody.	Custody / transferencias
Alarma	Cuándo se disparó un evento de alarma.	Panel de alarmas

Cruzar la serie de telemetría con estas capas permite responder preguntas operativas reales: "¿la densidad cambió antes o después de la última muestra de lab?", "¿qué pasó con el nivel alrededor de la transferencia de ayer?". La capa alarma se corresponde con las alarmas del panel de alarmas; aquí aparecen como marcadores en el tiempo, no como filas.

Export y persistencia

El explorador permite exportar lo que estás viendo y recordar tu configuración:

• Export PNG — guarda una imagen del gráfico tal como está (para un reporte o un correo).
• Export CSV — descarga los datos crudos de las series visibles (para analizar en otra herramienta).

La configuración se persiste por usuario

La selección de plumas, rango y capas se guarda por usuario (vía GET/PUT /me/trend-prefs, respaldado por user_trend_pref). El explorador recuerda tu última configuración entre sesiones: al volver a abrir el detalle de un tanque, encuentras las mismas señales y el mismo encuadre que dejaste, sin reconstruirlo cada vez.

Captura

Captura pendiente

Screenshot pendiente del barrido diferido — ver 61-DEFERRED-SWEEP.md (tank-detail TrendExplorer con selección de rango + capas configuradas, TANK-02 → ruta esperada /img/tank-detail/trend-explorer-operator.png).

Páginas relacionadas

• El explorador vive al fondo de el detalle de tanque; desde ahí se llega a los KPIs, los factores custody y la procedencia del tanque.
• Las alarmas que aparecen como capa de eventos se gestionan en el panel de alarmas.