========================================================================
 OPSCADIA CONNECT
 Accesso remoto ai tuoi runtime Opscadia — senza VPN, senza port forwarding
========================================================================

Grazie per aver scaricato Opscadia Connect.

Questo file spiega:
  1. Cos'e' Opscadia Connect e a cosa serve
  2. Come installarlo e avviarlo
  3. Come usarlo (login e nodi remoti)
  4. Perche' Windows mostra un avviso di sicurezza all'apertura
     (e come procedere in sicurezza)
  5. Disinstallazione
  6. Dove trovare i file di configurazione e i log


------------------------------------------------------------------------
 1. COS'E' OPSCADIA CONNECT
------------------------------------------------------------------------

Opscadia Connect e' una piccola app per Windows che vive nella tray
(vicino all'orologio, in basso a destra). Collega i runtime Opscadia
installati sul PC di campo al cloud Opscadia, cosi' puoi vedere i dati
PLC live e l'HMI in esecuzione dal frontend online

    https://app.opscadia.com  ->  sezione "Nodi remoti"

da qualsiasi luogo, con qualsiasi browser.

Usa SOLO connessioni in USCITA verso il cloud Opscadia:
  - niente port forwarding
  - niente VPN
  - niente aperture sul firewall lato cliente

Schema:

  Runtime Opscadia (porta configurata all'installazione)
        |  (websocket locale)
        v
  Opscadia Connect
        |  (websocket cifrato in uscita, wss)
        v
  api.opscadia.com
        |
        v
  Il tuo browser -> app.opscadia.com -> "Nodi remoti"


------------------------------------------------------------------------
 2. INSTALLAZIONE
------------------------------------------------------------------------

Non c'e' un vero e proprio installer: e' un eseguibile unico.

  1. Estrai il contenuto di questo zip in una cartella a piacere
     (es. C:\Opscadia\Connect\). NON eseguirlo dall'interno dello zip.
  2. Fai doppio clic su  OpscadiaConnect.exe
  3. Al primo avvio Windows potrebbe mostrare un avviso di sicurezza:
     e' normale. Vedi il punto 4 di questo file per capire perche'
     e come procedere.
  4. Comparira' l'icona nella tray di Windows. Se non la vedi, clicca
     sulla freccetta "^" per espandere le icone nascoste.

Avvio automatico con Windows:
  Al primo avvio Connect si registra per partire automaticamente
  all'accensione del PC. Puoi disattivarlo dal menu della tray
  (clic destro sull'icona).


------------------------------------------------------------------------
 3. COME SI USA
------------------------------------------------------------------------

  1. Clic sull'icona nella tray -> si apre la finestra di login.
  2. Accedi con LE STESSE credenziali di app.opscadia.com
     (stesso account che usi nel frontend cloud).
  3. Connect trova da solo i runtime Opscadia attivi sulla macchina
     (anche su una porta non standard scelta durante l'installazione del
     runtime) e apre un ponte verso il cloud per ognuno di essi.
  4. Vai su  https://app.opscadia.com  ->  "Nodi remoti":
     l'impianto compare online e puoi aprire il viewer HMI live
     (tag, allarmi, comandi di scrittura).

Colore dell'icona nella tray:
  - VERDE   = collegato, uno o piu' runtime online
  - GRIGIO  = in attesa (nessun runtime locale trovato)
  - VIOLA   = non hai ancora eseguito il login

Aggiornamenti (automatici — NON serve riscaricare nulla dal sito):
  Ad OGNI AVVIO Connect controlla se esiste una versione piu' recente,
  la scarica e si sostituisce da solo riavviandosi.
  Il controllo avviene SOLO all'avvio: se Connect e' gia' aperto quando
  esce una nuova versione, non si aggiorna finche' non lo riavvii.
  Per forzare l'aggiornamento: clic destro sull'icona tray -> Esci, poi
  riapri OpscadiaConnect.exe (o riavvia il PC: Connect riparte da solo).
  Esito verificabile in %APPDATA%\OpscadiaConnect\connect.log
  (righe "Nuova versione ... disponibile" e "Update avviato").


------------------------------------------------------------------------
 4. PERCHE' WINDOWS MOSTRA UN AVVISO DI SICUREZZA
------------------------------------------------------------------------

All'apertura potresti vedere una schermata blu tipo:

    "Windows ha protetto il PC"
    "Microsoft Defender SmartScreen ha impedito l'avvio di
     un'app non riconosciuta..."

oppure un avviso "Editore sconosciuto", oppure una segnalazione
dell'antivirus.

QUESTO NON SIGNIFICA CHE IL FILE SIA UN VIRUS.

Motivo tecnico:
  - L'eseguibile NON e' firmato con un certificato di code-signing a
    pagamento (EV). Windows SmartScreen mostra l'avviso a ogni app
    nuova o poco diffusa che non ha ancora una "reputazione"
    consolidata presso Microsoft. E' un filtro sulla popolarita' del
    file, non un'analisi del suo contenuto.
  - Opscadia Connect e' impacchettato con PyInstaller. Alcuni antivirus
    segnalano genericamente gli eseguibili PyInstaller come "sospetti"
    (falso positivo molto comune con questa tecnologia).

Come procedere in sicurezza:
  - Su SmartScreen: clicca su "Ulteriori informazioni" e poi
    "Esegui comunque".
  - Se l'antivirus lo mette in quarantena, ripristinalo e/o aggiungi
    una eccezione per OpscadiaConnect.exe.

Come verificare di avere il file autentico:
  - Scarica SEMPRE Opscadia Connect solo dal sito ufficiale
    (https://opscadia.com/connect.html) o dalla pagina ufficiale
    delle release. Non fidarti di copie ricevute da altre fonti.
  - In caso di dubbio, contatta il supporto (vedi in fondo).


------------------------------------------------------------------------
 5. DISINSTALLAZIONE
------------------------------------------------------------------------

  1. Clic destro sull'icona nella tray -> "Esci".
  2. Se avevi attivato l'avvio automatico, disattivalo dal menu della
     tray prima di uscire (oppure rimuovilo dalle app di avvio di
     Windows).
  3. Cancella la cartella dove hai estratto OpscadiaConnect.exe.
  4. (Opzionale) Cancella la cartella di configurazione:
     %APPDATA%\OpscadiaConnect\


------------------------------------------------------------------------
 6. FILE DI CONFIGURAZIONE E LOG
------------------------------------------------------------------------

Tutto viene salvato in:

    %APPDATA%\OpscadiaConnect\

  - config.json        impostazioni (incl. avvio automatico)
  - connect.log        log di diagnostica (utile per il supporto)
  - relay_token.dat    token di sessione, cifrato con Windows DPAPI
                       e legato al tuo utente Windows

Nessun dato di progetto o dato industriale viene inviato a Opscadia:
Connect fa solo da ponte tra il tuo runtime locale e il tuo browser.


------------------------------------------------------------------------
 SUPPORTO
------------------------------------------------------------------------

  Email:   info@opscadia.com
  Sito:    https://opscadia.com
  Manuale: https://app.opscadia.com/manuale.html

  (c) Opscadia
