Manutenzione e diagnostica della Platform¶
Sequenza di diagnosi¶
- Verificare schema MES e connessione centrale.
- Eseguire
Engine --validate. - Controllare sorgente, regola, nomi campo, filtro e valori stato.
- Consultare
engine_runse i campioni raw disponibili. - Confrontare ultima riga sorgente, flag Elaborato e stato MES.
- Verificare API e dashboard dopo la persistenza centrale.
| Sintomo | Controlli |
|---|---|
| Dashboard vuota | DEMO_MODE=false, database configurato, macchine abilitate e stato acquisito |
| Nessuna acquisizione LED | Run conclusa con righe lette; polling vuoto non accende una nuova acquisizione |
| Ultimo dato vecchio con macchina RUN | Stato STO invariato e polling riuscito: può essere corretto |
| OFFLINE inatteso | Connessione sorgente, ultimo polling riuscito e timeout gateway |
| Riga a Elaborato 0 | Mapping completo, stato grezzo mappato, errore centrale o marcatura sorgente fallita |
| Colonne opzionali assenti | Migrazioni, nomi campo, regola/sorgente abilitate e flag API |
| Validazione fallisce dopo update | Nuove colonne engine non ancora applicate nel MES |
| Campo sorgente non trovato | Differenza tra codice macchina e nome colonna; filtro SQL legacy |
| UI Platform Setting non allineata | AXP aggiornato ma CRUD non sincronizzati/rigenerati |
Build, test e publish engine¶
Dalla cartella engine/:
dotnet restore LinkMachine.Engine.slnx
dotnet test LinkMachine.Engine.slnx -c Release
dotnet publish src/LinkMachine.Engine/LinkMachine.Engine.csproj -c Release
La memoria documenta 38 test superati, build Release senza errori/warning e publish con Obfuscar 2.2.50. Verificare nuovamente l'artefatto aggiornato e la sua esecuzione con --validate.
Il publish rimuove configurazioni reali eventualmente residue. INI e file sorgente protetti devono essere predisposti separatamente, insieme ai permessi del servizio.
Aggiornamenti coordinati¶
Aggiornare schema, configurazione Platform Setting, engine, API e frontend come parti compatibili. Per i campi di settembre applicare le due migrazioni nell'ordine indicato, allineare Platform Setting e validare il Worker. Il fallback web alle colonne mancanti non è una validazione dell'engine.
Conservare backup database e configurazioni e definire il ritorno all'artefatto precedente. Non è presente una pipeline di rilascio/tag completa nella memoria.
Manutenzione del web¶
Distribuire insieme language.ini e language.php, conservando UTF-8 e segnaposto. Verificare accessi degli endpoint, protezione dei file di configurazione e utilità diagnostiche come info.php/test.php prima della pubblicazione.
Non modificare i CRUD generati per elementi configurabili nel progetto AXP. Il trigger futuro dati_macchina_log, l'heartbeat per singolo PLC e la retention raw restano evoluzioni da implementare e collaudare.