Flujo de Datos
:::info Referencia Rápida — Ruta de Datos Sensores/PLCs → MQTT/OPC-UA → Trabajadores de Ingesta → PostgreSQL/TimescaleDB → FastAPI → React UI
Todos los datos permanecen en las instalaciones. Sin dependencia de la nube. Sin necesidad de internet. :::
OpSee conecta el mundo físico (sensores, PLCs, dispositivos IoT) con paneles en tiempo real y análisis. Esta página explica cómo fluyen los datos a través del sistema, desde la planta de producción hasta tu pantalla.
¿Por qué Importa Esto?
Si eres nuevo en el software de fabricación, el flujo de datos puede parecer complejo. Aquí tienes una forma sencilla de entenderlo:
Piensa en OpSee como una estación meteorológica. Una estación meteorológica tiene sensores (termómetro, pluviómetro, veleta) que miden continuamente las condiciones. Esas mediciones se recogen, se almacenan en una base de datos y se muestran en un panel que te muestra el tiempo actual y las tendencias históricas.
OpSee funciona de la misma manera, pero para tu fábrica:
- Los sensores de las máquinas miden temperatura, velocidad, estado (en marcha/parado) y conteos
- Los trabajadores (procesos de software) recogen y almacenan esas mediciones
- Los paneles muestran métricas de producción en tiempo real y análisis histórico
La diferencia clave es que OpSee también añade inteligencia: calcula automáticamente el OEE, detecta eventos de inactividad y permite a los operarios clasificar las razones de las paradas.
La Vista General
Capa por Capa
1. Planta de Producción (Fuentes de Datos)
| Fuente | Protocolo | Descripción |
|---|---|---|
| PLCs / SCADA | MQTT, OPC-UA | Los controladores industriales publican el estado de la máquina, contadores y alarmas |
| Sensores IoT | MQTT | Sensores de temperatura, presión y vibración a través de pasarelas IoT |
| Node-RED | MQTT | Programación de flujos visuales para transformar, enrutar y enriquecer datos antes de que lleguen a OpSee |
| Entrada manual | HTTP (UI) | Los operarios registran razones de inactividad, defectos de calidad y conteos de producción directamente en OpSee |
2. Broker de Mensajes (Transporte)
MQTT (Mosquitto) es el transporte principal de mensajes. Utiliza un modelo publicar/suscribir:
- Publicadores — Los PLCs, sensores y flujos de Node-RED publican datos en tópicos MQTT
- Suscriptores — Los trabajadores de ingesta de OpSee se suscriben a los tópicos relevantes
- Los tópicos siguen una convención de nomenclatura estructurada, p. ej.,
planta/linea1/maquina3/estado
OPC-UA se admite como alternativa para entornos industriales que lo utilizan de forma nativa. El trabajador OPC-UA de OpSee se conecta directamente a los servidores OPC-UA.
3. Capa de Ingesta (Procesamiento)
Dos rutas de ingesta paralelas garantizan que los datos lleguen a la base de datos:
| Trabajador | Rol |
|---|---|
| Trabajador Recolector MQTT | Se suscribe a brokers MQTT, analiza las cargas útiles, las mapea a equipos y etiquetas, y escribe en la base de datos |
| Trabajador Recolector OPC-UA | Se suscribe a servidores OPC-UA (notificaciones de cambio de datos), mapea los valores a equipos y etiquetas, y escribe en la base de datos |
Los trabajadores se gestionan a través de la API de OpSee: puedes monitorizar su estado, activar el modo de depuración y ajustar los intervalos de sondeo desde el panel de administración.
:::info Modo de Descubrimiento El Trabajador de Descubrimiento MQTT escanea automáticamente los tópicos MQTT para encontrar nuevas fuentes de datos. Esto ayuda durante la configuración inicial cuando se mapean los sensores a los equipos. :::
4. Almacenamiento (Base de Datos)
PostgreSQL + TimescaleDB es la única fuente de verdad:
- Datos maestros (tablas con prefijo
m_) — Equipos, materiales, personal, recetas, configuración OEE - Datos reales (tablas con prefijo
a_) — Eventos de producción, registros de disponibilidad, registros de calidad, registro de auditoría - Series temporales — Hipertablas de TimescaleDB para datos de sensores de alta frecuencia con compresión automática y retención
Todos los datos se almacenan localmente: OpSee funciona completamente en las instalaciones sin dependencia de la nube.
5. Capa de Aplicación (Presentación)
| Componente | Propósito |
|---|---|
| Backend FastAPI | API REST que consulta la base de datos, calcula métricas OEE, aplica el control de acceso y sirve datos a los clientes |
| Frontend React | Aplicación de una sola página con paneles en tiempo real, cuadrículas de datos, formularios y el sistema de widgets Cockpit |
| Grafana | Visualización avanzada de series temporales y alertas para tendencias de datos de sensores |
Ejemplos de Flujo de Datos
Ejemplo 1: Cambio de Estado de una Máquina
Ejemplo 2: El Operario Registra la Razón de Inactividad
Arquitectura sin Dependencia de Internet
OpSee está diseñado para entornos de fábrica donde la conectividad a internet es poco fiable o inexistente:
- Todos los servicios se ejecutan localmente a través de contenedores Docker
- Sin llamadas a APIs externas ni dependencias de la nube
- Los datos permanecen en las instalaciones
- El frontend React está completamente empaquetado: sin recursos CDN
- MQTT y OPC-UA funcionan en la red local
Esto hace que OpSee sea adecuado para entornos con espacios de aire, instalaciones clasificadas y sitios de fabricación remotos.
Próximos Pasos
- Descripción General de la Arquitectura — Arquitectura técnica detallada de todos los servicios
- Fundamentos del OEE — Cómo se calcula el OEE a partir de los datos ingeridos
- Modelo de Equipos — Cómo los sensores se mapean a los equipos