Manuale completo

Panoramica

SecondSight è un sistema di assistenza remota in tempo reale per tecnici HVAC. Connette il tecnico in campo con un esperto remoto tramite video live, annotazioni grafiche e una knowledge base AI sui manuali degli impianti.

Il sistema è composto da due componenti principali: l'app Android per il tecnico in campo e la Expert Console web per l'operatore remoto. Il canale video è gestito da LiveKit (WebRTC), garantendo comunicazione cifrata a bassa latenza senza routing attraverso server di terze parti non necessari.

Requisiti di sistema

Prima di installare o accedere a SecondSight, verifica che i tuoi dispositivi soddisfino questi requisiti minimi.

App tecnico (Android)

Expert Console (browser)

Installazione dell'app

L'app SecondSight viene distribuita dall'amministratore IT aziendale come APK o tramite un canale MDM. Non è disponibile sul Google Play Store pubblico.

Installazione via APK (sideloading)

1. Ricevi il file SecondSight.apk dall'amministratore IT (link di download interno o email).
2. Su Android, vai in Impostazioni → Sicurezza → Sorgenti sconosciute e abilita l'installazione da sorgenti esterne al Play Store.
3. Apri il file APK dal file manager o dalla notifica di download. Tocca Installa.
4. Una volta installata, disabilita nuovamente "Sorgenti sconosciute" per sicurezza.
5. Apri l'app. Inserisci l'URL del backend fornito dall'amministratore nella schermata di configurazione iniziale.

Installazione via MDM

Se la tua azienda usa un sistema di Mobile Device Management (es. Microsoft Intune, VMware Workspace ONE), l'app viene distribuita automaticamente dal reparto IT. Cerca "SecondSight" nel catalogo app aziendale e installa da lì.

Primo accesso

Al primo avvio, l'app richiede le credenziali aziendali e i permessi necessari al funzionamento.

1. Avvia l'app. Nella schermata di login, inserisci email e password forniti dall'IT o dall'amministratore SecondSight.
2. Dopo il primo accesso Android chiede il permesso di inviare notifiche: tocca Consenti. Serve per ricevere gli avvisi quando un esperto ti assegna una sessione.
3. Alla prima sessione, Android chiede il permesso di accedere alla fotocamera: tocca Consenti.
4. Android chiede poi il permesso al microfono: tocca Consenti. Entrambi i permessi sono necessari per il funzionamento.

Avviare una sessione

La sessione la crea l'esperto dalla Expert Console e la assegna a un tecnico, che riceve una notifica sullo smartphone ed entra con un tap.

Dall'esperto (console)

1. Nella dashboard clicca + Nuova sessione. La sessione riceve un codice di 6 cifre e si apre nella console.
2. Clicca Assegna, scegli il tecnico dall'elenco (uno per sessione) e conferma con Assegna.
3. Clicca l'icona di invio accanto al tecnico per mandargli la notifica. Assegnazione e notifica sono separate: puoi rimandare la notifica quando vuoi.
4. Se l'invio non riesce compare un triangolo rosso con il motivo, ad esempio notifiche non ancora attivate sull'app del tecnico. In quel caso comunicagli il codice di 6 cifre.

Dal tecnico (app)

1. Tocca la notifica sessione assegnata: arriva anche con l'app chiusa e porta direttamente nella sessione live.
2. In alternativa, nella schermata iniziale inserisci il codice di 6 cifre in ID Sessione e tocca Connetti alla sessione.
3. Entrando in sessione si attivano fotocamera e microfono: l'esperto vede il tuo video in tempo reale.

Accesso e interfaccia

La Expert Console è un'applicazione web accessibile da qualsiasi browser moderno. Non richiede installazioni.

1. Apri il browser e vai su console.second-sight.eu.
2. Inserisci le tue credenziali esperto (email + password) e clicca Accedi.
3. Nella dashboard trovi le sessioni: crea una nuova sessione (vedi Avviare una sessione) o apri una di quelle esistenti.
4. Quando il tecnico entra, il suo video live compare nel pannello Live.

Layout dell'interfaccia

• Finestra video centrale — streaming in tempo reale dalla fotocamera del tecnico.
• Toolbar annotazioni — strumenti di disegno a sinistra del video.
• Sidebar destra — due tab: 🔍 AI Engine e 💬 Chat.
• Pannello superiore — stato connessione, info sessione, pulsante Termina.

Video live

Il flusso video arriva dalla fotocamera posteriore dello smartphone del tecnico. La qualità si adatta automaticamente alla disponibilità di rete.

Snapshot

Il pulsante 📸 in alto a destra del video cattura un fotogramma del live feed corrente. Lo snapshot può essere usato per documentare l'intervento o per analisi dettagliata. Il fotogramma viene salvato localmente nel browser.

Annotazioni grafiche

L'esperto può disegnare direttamente sul video live. Le annotazioni vengono trasmesse in tempo reale al tecnico, che le vede sovrapposte al suo display.

Gestione annotazioni

• Undo — rimuove l'ultima annotazione disegnata (solo localmente; l'annullamento non si propaga al tecnico).
• Clear all — cancella tutte le annotazioni visibili. Il comando si propaga al tecnico e pulisce anche il suo schermo.
• Le annotazioni non sono persistenti: quando la sessione termina, scompaiono.

Chat testuale

Il canale chat permette di scambiarsi messaggi scritti durante la sessione — utile in ambienti rumorosi o per comunicare valori numerici precisi.

La chat funziona tramite il canale dati LiveKit (ss_chat), in modalità affidabile. I messaggi sono trasportati direttamente dall'SFU: nessun dato di testo transita per il backend.

Accesso alla chat

• Expert Console: seleziona la tab 💬 Chat nella sidebar destra.
• App tecnico: scorri verso il basso nella schermata sessione per aprire il campo messaggi.
• I messaggi non letti mostrano un badge numerico sulla tab.

AI Engine — Knowledge Base

Il motore AI risponde a domande tecniche consultando i manuali degli impianti caricati dal tuo amministratore. Le risposte includono checklist operative, procedure e note di sicurezza.

Come interrogare l'AI

1. Nella sidebar Expert Console, seleziona la tab 🔍 AI Engine.
2. Digita la tua domanda tecnica nel campo di testo. Esempi: "pressione di esercizio R410A con temperatura esterna 35°C", "codice errore E7 Daikin VRV IV", "procedura sostituzione compressore Carrier 30XA".
3. Premi Invio o clicca Cerca. La risposta appare nella sidebar entro pochi secondi.

Struttura della risposta

L'AI restituisce una risposta strutturata con:

• Parametri necessari — chip cliccabili con i dati che servono per la diagnosi.
• Riepilogo — risposta sintetica alla domanda.
• Checklist operativa — passi numerati da eseguire sul campo.
• Procedure — istruzioni dettagliate per le operazioni tecniche.
• Note di sicurezza — avvisi evidenziati in rosso.
• Fonti — pagine specifiche dei manuali usate per la risposta, con estratto.

Conversazione multi-turno

La sidebar ricorda il contesto della conversazione durante la sessione. Puoi fare domande di follow-up senza ripetere il contesto: "e per R32?", "il passo 3 come si fa?" funzionano correttamente.

Fine sessione

La sessione può essere terminata da entrambi i lati in modo sicuro.

Dal tecnico (app)

1. Tocca il pulsante Termina nella schermata sessione.
2. Conferma la chiusura nel dialog di conferma.
3. L'app torna alla schermata iniziale: fotocamera e microfono si spengono e il flusso video si interrompe.

Dall'esperto (console)

1. Clicca Chiudi sessione in alto nella pagina della sessione.
2. Le sessioni chiuse restano nella dashboard; un amministratore può riaprirle o eliminarle.

Privacy e sicurezza

SecondSight è progettato per essere conforme al GDPR e all'art. 4 dello Statuto dei Lavoratori sin dal design architetturale.

Principi chiave

• Nessuna attivazione remota: l'esperto crea e assegna la sessione, ma fotocamera e microfono si attivano solo quando il tecnico decide di entrare dalla propria app. L'azienda non può accenderli da remoto.
• Opt-out libero: il tecnico può terminare la sessione in qualsiasi momento, senza conseguenze operative o disciplinari.
• No registrazione automatica: il video non viene registrato salvo funzionalità esplicita abilitata e con informativa aggiornata.
• Cifratura in transito: tutti i flussi video e dati sono cifrati end-to-end via DTLS/SRTP (LiveKit WebRTC).
• Dati sui server EU: il backend e il server LiveKit sono ospitati in data center europei (DigitalOcean Amsterdam).

Risoluzione problemi

Problemi frequenti e come risolverli.

• L'app non si connette al server — cosa faccio?
  Verifica di avere una connessione Wi-Fi o dati attiva. Controlla che l'URL del backend nelle impostazioni app sia corretto. Se il problema persiste, contatta l'IT aziendale — potrebbe esserci un firewall che blocca la porta del server (default 8000).
• Il video arriva con molto ritardo o blocchi
  La qualità video si adatta automaticamente alla rete. Latenze elevate indicano banda insufficiente: assicurati di avere almeno 5 Mbps upload sul tecnico e 10 Mbps download sull'esperto. In ambienti industriali con Wi-Fi congestionato, preferire una connessione 4G/LTE diretta.
• Le annotazioni non appaiono sullo schermo del tecnico
  Le annotazioni viaggiano via canale dati LiveKit. Se non arrivano, verifica che entrambi i partecipanti siano connessi alla stessa room (stesso ID sessione). Riconnettiti alla sessione se il problema persiste. La funzionalità di annotazione lato tecnico (MOB-02) richiede la versione app più recente.
• L'AI Engine risponde "nessun documento trovato"
  La knowledge base si basa esclusivamente sui manuali caricati dal tuo amministratore. Se il manuale dell'impianto specifico non è stato indicizzato, l'AI non troverà risultati pertinenti. Contatta l'amministratore per caricare i PDF necessari tramite la funzione di ingest.
• Dimentico la password — come la recupero?
  Il recupero password è gestito dall'amministratore SecondSight della tua azienda. Contatta il tuo IT o scrivi a info@secondsight.it indicando il tuo username.
• Il browser chiede di accedere alla fotocamera — è normale?
  Nella versione attuale della Expert Console, il browser potrebbe chiedere accesso alla fotocamera per l'inizializzazione WebRTC. Puoi consentire o rifiutare — l'esperto non ha bisogno di videocamera: riceve solo il video del tecnico. Puoi rifiutare la richiesta senza impatto sul funzionamento.