Fluxo de Dados
:::info Referência Rápida — Caminho dos Dados Sensores/PLCs → MQTT/OPC-UA → Trabalhadores de Ingestão → PostgreSQL/TimescaleDB → FastAPI → React UI
Todos os dados ficam nas instalações. Sem dependência da nuvem. Sem necessidade de internet. :::
O OpSee liga o mundo físico (sensores, PLCs, dispositivos IoT) a painéis em tempo real e análises. Esta página explica como os dados fluem pelo sistema, desde o chão de fábrica até ao seu ecrã.
Por Que Isto Importa?
Se é novo em software de fabrico, o fluxo de dados pode parecer complexo. Veja uma forma simples de pensar nisso:
Pense no OpSee como uma estação meteorológica. Uma estação meteorológica tem sensores (termómetro, pluviómetro, cata-vento) que medem continuamente as condições. Essas medições são recolhidas, armazenadas numa base de dados e exibidas num painel que mostra o tempo atual e as tendências históricas.
O OpSee funciona da mesma forma, mas para a sua fábrica:
- Os sensores nas máquinas medem temperatura, velocidade, estado (a funcionar/parado) e contagens
- Os trabalhadores (processos de software) recolhem e armazenam essas medições
- Os painéis exibem métricas de produção em tempo real e análises históricas
A diferença fundamental é que o OpSee também adiciona inteligência: calcula automaticamente o OEE, deteta eventos de inatividade e permite aos operadores classificar as razões das paragens.
A Visão Geral
Camada por Camada
1. Chão de Fábrica (Fontes de Dados)
| Fonte | Protocolo | Descrição |
|---|---|---|
| PLCs / SCADA | MQTT, OPC-UA | Controladores industriais publicam o estado da máquina, contadores e alarmes |
| Sensores IoT | MQTT | Sensores de temperatura, pressão e vibração via gateways IoT |
| Node-RED | MQTT | Programação visual de fluxos para transformar, encaminhar e enriquecer dados antes de chegarem ao OpSee |
| Entrada manual | HTTP (UI) | Os operadores registam razões de inatividade, defeitos de qualidade e contagens de produção diretamente no OpSee |
2. Broker de Mensagens (Transporte)
MQTT (Mosquitto) é o transporte de mensagens principal. Usa um modelo publicar/subscrever:
- Publicadores — PLCs, sensores e fluxos Node-RED publicam dados em tópicos MQTT
- Subscritores — Os trabalhadores de ingestão do OpSee subscrevem os tópicos relevantes
- Os tópicos seguem uma convenção de nomenclatura estruturada, ex.:
planta/linha1/maquina3/estado
OPC-UA é suportado como alternativa para ambientes industriais que o utilizam nativamente. O trabalhador OPC-UA do OpSee liga-se diretamente a servidores OPC-UA.
3. Camada de Ingestão (Processamento)
Dois caminhos de ingestão paralelos garantem que os dados chegam à base de dados:
| Trabalhador | Função |
|---|---|
| Trabalhador Coletor MQTT | Subscreve brokers MQTT, analisa os payloads, mapeia-os para equipamentos e etiquetas, escreve na base de dados |
| Trabalhador Coletor OPC-UA | Subscreve servidores OPC-UA (notificações de alteração de dados), mapeia os valores para equipamentos e etiquetas, escreve na base de dados |
Os trabalhadores são geridos através da API do OpSee — pode monitorizar o seu estado, ativar o modo de depuração e ajustar os intervalos de sondagem a partir do painel de administração.
:::info Modo de Descoberta O Trabalhador de Descoberta MQTT verifica automaticamente os tópicos MQTT para encontrar novas fontes de dados. Isto ajuda durante a configuração inicial quando está a mapear sensores para equipamentos. :::
4. Armazenamento (Base de Dados)
PostgreSQL + TimescaleDB é a única fonte de verdade:
- Dados mestres (tabelas com prefixo
m_) — Equipamentos, materiais, pessoal, receitas, configuração OEE - Dados reais (tabelas com prefixo
a_) — Eventos de produção, registos de disponibilidade, registos de qualidade, trilha de auditoria - Séries temporais — Hipertabelas TimescaleDB para dados de sensores de alta frequência com compressão automática e retenção
Todos os dados são armazenados localmente — o OpSee funciona inteiramente nas instalações sem dependência da nuvem.
5. Camada de Aplicação (Apresentação)
| Componente | Propósito |
|---|---|
| Backend FastAPI | API REST que consulta a base de dados, calcula métricas OEE, aplica controlo de acesso e serve dados aos clientes |
| Frontend React | Aplicação de página única com painéis em tempo real, grelhas de dados, formulários e o sistema de widgets Cockpit |
| Grafana | Visualização avançada de séries temporais e alertas para tendências de dados de sensores |
Exemplos de Fluxo de Dados
Exemplo 1: Mudança de Estado de uma Máquina
Exemplo 2: O Operador Regista a Razão de Inatividade
Arquitetura Sem Dependência de Internet
O OpSee foi concebido para ambientes de fábrica onde a conectividade à internet é pouco fiável ou inexistente:
- Todos os serviços são executados localmente via contentores Docker
- Sem chamadas a APIs externas nem dependências da nuvem
- Os dados ficam nas instalações
- O frontend React está completamente empacotado — sem recursos CDN
- MQTT e OPC-UA funcionam na rede local
Isto torna o OpSee adequado para ambientes com separação física, instalações classificadas e locais de fabrico remotos.
Próximos Passos
- Visão Geral da Arquitetura — Arquitetura técnica detalhada de todos os serviços
- Fundamentos do OEE — Como o OEE é calculado a partir dos dados ingeridos
- Modelo de Equipamentos — Como os sensores são mapeados para os equipamentos