Flusso dei Dati
:::info Riferimento rapido — Percorso dei Dati Sensori/PLC → MQTT/OPC-UA → Worker di Acquisizione → PostgreSQL/TimescaleDB → FastAPI → React UI
Tutti i dati rimangono on-premises. Nessuna dipendenza cloud. Nessuna connessione internet richiesta. :::
OpSee connette il mondo fisico (sensori, PLC, dispositivi IoT) a dashboard e analisi in tempo reale. Questa pagina spiega come i dati fluiscono attraverso il sistema, dal reparto produzione al vostro schermo.
Perché Questo è Importante?
Se siete nuovi ai software manifatturieri, il flusso dei dati può sembrare complesso. Ecco un modo semplice per pensarci:
Pensate a OpSee come a una stazione meteorologica. Una stazione meteorologica ha sensori (termometro, pluviometro, anemometro) che misurano continuamente le condizioni. Queste misurazioni vengono raccolte, memorizzate in un database e visualizzate su un dashboard che mostra il meteo attuale e le tendenze storiche.
OpSee funziona allo stesso modo, ma per il vostro stabilimento:
- I sensori sulle macchine misurano temperatura, velocità, stato (in funzione/fermo) e conteggi
- I worker (processi software) raccolgono e memorizzano quelle misurazioni
- I dashboard visualizzano le metriche di produzione in tempo reale e l'analisi storica
La differenza chiave è che OpSee aggiunge anche intelligenza: calcola automaticamente l'OEE, rileva gli eventi di fermo e permette agli operatori di classificare le cause dei fermi.
Il Quadro Generale
Livello per Livello
1. Reparto Produzione (Sorgenti Dati)
| Sorgente | Protocollo | Descrizione |
|---|---|---|
| PLC / SCADA | MQTT, OPC-UA | I controller industriali pubblicano lo stato delle macchine, i contatori e gli allarmi |
| Sensori IoT | MQTT | Sensori di temperatura, pressione, vibrazione tramite gateway IoT |
| Node-RED | MQTT | Programmazione visuale dei flussi per trasformare, instradare e arricchire i dati prima che raggiungano OpSee |
| Inserimento Manuale | HTTP (UI) | Gli operatori registrano le cause dei fermi, i difetti di qualità e i conteggi di produzione direttamente in OpSee |
2. Message Broker (Trasporto)
MQTT (Mosquitto) è il principale mezzo di trasporto dei messaggi. Utilizza un modello publish/subscribe:
- Publisher — PLC, sensori e flussi Node-RED pubblicano dati su topic MQTT
- Subscriber — I worker di acquisizione di OpSee si iscrivono ai topic pertinenti
- I Topic seguono una convenzione di denominazione strutturata, es.
plant/line1/machine3/state
OPC-UA è supportato come alternativa per gli ambienti industriali che lo utilizzano nativamente. Il worker OPC-UA di OpSee si connette direttamente ai server OPC-UA.
3. Livello di Acquisizione (Elaborazione)
Due percorsi di acquisizione paralleli assicurano che i dati raggiungano il database:
| Worker | Ruolo |
|---|---|
| MQTT Collector Worker | Si iscrive ai broker MQTT, analizza i payload, li mappa alle attrezzature e ai tag, scrive nel database |
| OPC-UA Collector Worker | Si iscrive ai server OPC-UA (notifiche data-change), mappa i valori alle attrezzature e ai tag, scrive nel database |
I worker vengono gestiti tramite l'API OpSee — è possibile monitorare il loro stato, attivare la modalità debug e regolare gli intervalli di polling dal pannello di amministrazione.
:::info Modalità Discovery Il worker MQTT Discovery scansiona automaticamente i topic MQTT per trovare nuove sorgenti di dati. Questo è utile durante la configurazione iniziale quando si mappano i sensori alle attrezzature. :::
4. Storage (Database)
PostgreSQL + TimescaleDB è l'unica fonte di verità:
- Dati master (tabelle con prefisso
m_) — Attrezzature, materiali, personale, ricette, configurazione OEE - Dati effettivi (tabelle con prefisso
a_) — Eventi di produzione, record di disponibilità, log di qualità, audit trail - Serie temporali — Hypertable TimescaleDB per dati di sensori ad alta frequenza con compressione e conservazione automatiche
Tutti i dati vengono memorizzati localmente — OpSee funziona interamente on-premises senza dipendenze cloud.
5. Livello Applicazione (Presentazione)
| Componente | Scopo |
|---|---|
| FastAPI Backend | API REST che interroga il database, calcola le metriche OEE, gestisce il controllo degli accessi e fornisce dati ai client |
| React Frontend | Applicazione a pagina singola con dashboard in tempo reale, griglie dati, form e il sistema di widget Cockpit |
| Grafana | Visualizzazione avanzata di serie temporali e alerting per le tendenze dei dati dei sensori |
Esempi di Flusso dei Dati
Esempio 1: Cambio di Stato della Macchina
Esempio 2: L'Operatore Registra la Causa del Fermo
Architettura Offline-First
OpSee è progettato per ambienti di fabbrica dove la connettività internet è inaffidabile o inesistente:
- Tutti i servizi vengono eseguiti localmente tramite container Docker
- Nessuna chiamata API esterna o dipendenza cloud
- I dati rimangono on-premises
- Il frontend React è completamente bundled — nessuna risorsa CDN
- MQTT e OPC-UA funzionano sulla rete locale
Questo rende OpSee adatto ad ambienti air-gapped, strutture classificate e siti di produzione remoti.
Prossimi Passi
- Panoramica Architettura — Architettura tecnica dettagliata di tutti i servizi
- Fondamenti OEE — Come viene calcolato l'OEE dai dati acquisiti
- Modello Attrezzature — Come i sensori si mappano alle attrezzature