Contratti tra componenti¶
Dal pannello alla Platform¶
Il percorso di integrazione da verificare per ogni installazione è:
Pannello → Agent → database sorgente → Engine → database MES → Dashboard
Manager configura e supervisiona le istanze Agent. Il mapping Agent associa registri a colonne di una tabella DB1; il mapping Platform associa colonne di una sorgente ai dati del MES. Sono due configurazioni successive con funzioni diverse.
| Confine | Contratto documentato | Verifica necessaria |
|---|---|---|
| Manager → Agent | Cartella istanza, eseguibile e config.ini; avvio e supervisione dei processi |
Percorso effettivo, identità dell'istanza, parametri e autostart |
| Agent ↔ pannello | Modbus TCP, porta 502, 118 holding register letti da indirizzo 101 | Firmware, indirizzamento e significato di ogni registro |
| Agent → DB1 | Tabella/filtro/campi scelti in mapping.ini; update dei valori cambiati |
Riga destinazione, conversioni e cardinalità del filtro |
| Sorgente → Engine | ID, codice macchina, stato, timestamp e flag Elaborato |
Schema, mapping stati, tabella fisica di update e privilegi |
| Engine → MES | Transazione per stato, eventi, snapshot e campioni; marcatura sorgente dopo il commit | Idempotenza e ripresa dopo errori |
| MES → Web | API JSON e tabelle MES | Schema installato, fuso orario e accessi |
Tabella corrente e storico a variazione¶
La memoria Platform descrive un'evoluzione concordata:
dati_macchina → trigger su variazione → dati_macchina_log → Engine
Il trigger e la migrazione della sorgente sono ancora da implementare e collaudare. La tabella corrente conserva lo stato attuale; il log dovrà ricevere una fotografia completa per ogni aggiornamento rilevante, con id, cod_macchina, cod_stato, created_at, elaborato=0 e tutti i campi richiesti dal mapping. È prevista una riga iniziale per ogni macchina.
Non sostituire il mapping sorgente esistente con quello della tabella log prima che tabella, trigger e popolamento iniziale siano disponibili. La sorgente attualmente descritta nelle memorie usa uno storico configurato separatamente; i nomi vanno verificati nell'installazione.
Compatibilità dei database¶
Il supporto dei provider cambia tra componenti:
- Manager: Access, MySQL, SQL Server e ODBC nei profili; le personalizzazioni SQL correnti usano EasyMES/MySQL.
- Agent: MySQL/MariaDB, Access e SQL Server; un solo provider globale per DB1 e DB2.
- Engine v0.1.0: sorgenti MySQL/MariaDB di tipo
DATI_MACCHINA. ERP/ODBC non sono ancora implementati nel Worker.
I test schema ODBC dell'area Platform Setting non attestano il supporto ODBC dell'engine.