Sincronizzazione Real-Time

Cosa è la Sincronizzazione

Quando lavori con più utenti contemporaneamente su Lema, la sincronizzazione automatica assicura che tutti vedano sempre i dati aggiornati in tempo reale, senza bisogno di ricaricare la pagina.

Esempio pratico:

Maria crea una nuova fattura dal suo computer
Paolo, che sta guardando la lista fatture sul suo PC, vede istantaneamente comparire la nuova fattura
Nessuno deve premere "Aggiorna" o ricaricare la pagina

Come Funziona

Lema usa una tecnologia chiamata Server-Sent Events (SSE) che mantiene una connessione continua tra il programma e il server. Quando qualcuno modifica un dato:

Il server salva la modifica nel database
Il server notifica tutti i client connessi
I client aggiornano automaticamente la schermata

Tutto avviene in pochi millisecondi, senza intervento dell'utente.

Indicatore di Connessione

Nella barra superiore di Lema, trovi un piccolo indicatore che mostra lo stato della sincronizzazione:

Icona	Stato	Significato
🟢	Connesso	Sincronizzazione attiva, ricevi aggiornamenti in tempo reale
🟡	Riconnessione...	Tentativo di ripristinare la connessione
🔴	Disconnesso	Nessuna sincronizzazione, dovrai aggiornare manualmente

💡 Suggerimento: Se l'indicatore è rosso per più di qualche minuto, controlla la connessione internet o contatta l'amministratore di sistema.

Cosa Viene Sincronizzato

La sincronizzazione è automatica e completa. Ecco cosa viene aggiornato in tempo reale:

📋 Dati Aziendali

Contatti - Clienti e fornitori
Prodotti - Catalogo prodotti e servizi
Fatture - Preventivi, ordini, DDT, fatture
Pagamenti - Incassi e pagamenti
Magazzino - Movimenti e giacenze
Produzione - Ordini di produzione e lavorazioni

📅 Agenda e Scadenze

Eventi calendario - Appuntamenti e promemoria
Scadenze - Fatture da pagare/incassare
Contratti - Rinnovi in scadenza

⚙️ Configurazione

Impostazioni — Configurazioni aziendali

Scenari di Utilizzo

🏢 Ufficio con Più Postazioni

Situazione: 5 dipendenti lavorano sullo stesso database in rete locale.

Vantaggi:

L'addetto vendite crea un preventivo → Il commerciale lo vede subito
Il magazziniere carica merce → L'ufficio vede le giacenze aggiornate
L'amministrazione emette fatture → La contabilità può registrarle immediatamente

🌍 Team Distribuito (Cloud)

Situazione: Sede principale + 2 filiali remote connesse al server cloud.

Vantaggi:

Ogni filiale vede le fatture emesse dalle altre in tempo reale
I report sono sempre aggiornati con i dati più recenti
Nessuna esportazione/importazione manuale di file

👥 Collaborazione Immediata

Situazione: Due colleghi lavorano sulla stessa fattura.

Protezione:

Se entrambi modificano la stessa fattura, Lema rileva il conflitto
Mostra un messaggio: "Questo documento è stato modificato da un altro utente"
Puoi ricaricare la versione aggiornata prima di salvare le tue modifiche

Riconnessione Automatica

Se la connessione si interrompe (es. internet cade per qualche secondo), Lema riconnette automaticamente:

Tentativo 1 - Dopo 3 secondi
Tentativo 2 - Dopo 6 secondi
Tentativo 3 - Dopo 12 secondi
...continua fino a 10 tentativi

Una volta ristabilita la connessione, ricevi tutti gli aggiornamenti accumulati durante la disconnessione.

⚠️ Nota: Se la riconnessione fallisce dopo 10 tentativi, vedrai un messaggio di errore. Dovrai controllare la connessione o riavviare l'applicazione.

Domande Frequenti

La sincronizzazione funziona anche offline?

No. Per ricevere aggiornamenti in tempo reale serve una connessione attiva al server. Se lavori offline:

Puoi comunque consultare i dati già caricati
Non riceverai modifiche fatte da altri utenti
Quando torni online, ricarica manualmente la pagina per vedere gli ultimi dati

La sincronizzazione consuma molta banda?

No. Il sistema invia solo notifiche leggere (pochi byte) quando i dati cambiano. Il download dei dati veri avviene solo quando apri una schermata o quando ricevi una notifica di modifica.

Esempio: Se un collega modifica una fattura, ricevi un messaggio tipo:

"La fattura 2026/001 è stata modificata"

Poi, se hai aperta la lista fatture, Lema scarica i dati aggiornati automaticamente.

Posso disattivare la sincronizzazione?

Sì, ma non è consigliato. Se lavori da solo o vuoi evitare aggiornamenti automatici:

Vai in Impostazioni → Avanzate
Disattiva "Sincronizzazione automatica"

Dovrai aggiornare manualmente le schermate con il pulsante "Ricarica" o premendo F5.

Cosa succede se due persone modificano lo stesso dato?

Lema usa un sistema di controllo versione (optimistic locking):

Scenario: Mario e Lucia aprono la stessa fattura
Mario modifica e salva → ✅ Salvato correttamente
Lucia modifica e prova a salvare → ⚠️ Conflitto rilevato
Lema mostra: "Questo documento è stato modificato. Ricarica per vedere la versione aggiornata"
Lucia ricarica e può applicare le sue modifiche sulla versione aggiornata

Questo previene che le modifiche di un utente sovrascrivano quelle di un altro.

La sincronizzazione funziona tra tenant diversi?

No. Ogni azienda (tenant) ha il proprio database isolato. Gli aggiornamenti sono visibili solo agli utenti dello stesso tenant.

Esempio: Se hai configurato due aziende separate (Azienda A e Azienda B), le modifiche fatte su Azienda A non vengono mai inviate ai client connessi ad Azienda B.

Suggerimenti per Massimizzare la Produttività

✅ Lavora Sempre Connesso

Per la migliore esperienza, mantieni sempre la connessione al server attiva. Se lavori in mobilità, usa una connessione stabile (Wi-Fi o 4G/5G).

✅ Controlla lo Stato Connessione

Occhio all'indicatore in alto a destra:

🟢 = Tutto ok, lavora tranquillo
🔴 = Attenzione, potresti non vedere le ultime modifiche

✅ Usa le Notifiche Visive

Quando arriva un aggiornamento, Lema mostra brevemente un badge o highlight sugli elementi modificati. Questo ti aiuta a notare subito le novità.

✅ Ricarica Manualmente se Necessario

Se l'indicatore è disconnesso e vuoi comunque vedere gli ultimi dati:

Premi F5 sulla tastiera
Oppure usa il pulsante "Ricarica" nella toolbar

Modalità Tecniche (Avanzate)

Server Embedded (App Desktop)

Quando usi Lema come app desktop Electron, il server gira localmente sul tuo computer. La sincronizzazione:

Funziona anche senza internet
È limitata ai client della stessa rete locale
Usa la porta 31847 (configurabile)

Server Cloud (Modalità Multi-Tenant)

Quando usi Lema in cloud, il server è ospitato su un server remoto. La sincronizzazione:

Richiede connessione internet
Funziona da qualsiasi luogo
Supporta autenticazione con JWT token sicuri

Risoluzione Problemi

Sincronizzazione non funziona

Sintomi: L'indicatore è rosso, non ricevi aggiornamenti.

Soluzioni:

Controlla internet - Verifica di essere online
Riavvia l'app - Chiudi e riapri Lema
Controlla il server - Se usi un server remoto, verifica che sia raggiungibile
Verifica firewall - Assicurati che la porta 3001 (o custom) sia aperta

Aggiornamenti lenti

Sintomi: Ricevi le notifiche con ritardo di 10-30 secondi.

Soluzioni:

Banda limitata - Controlla la velocità internet
Troppi client - Se ci sono molti utenti connessi, il server potrebbe essere sovraccarico
Proxy/VPN - Alcuni proxy possono ritardare le connessioni SSE

Messaggi di conflitto frequenti

Sintomi: Vedi spesso "Documento modificato da un altro utente".

Soluzioni:

Coordinati con il team - Evita di modificare lo stesso documento contemporaneamente
Usa sezioni diverse - Lavora su fatture/contatti/prodotti separati
Workflow chiaro - Stabilisci chi ha il permesso di modificare cosa

Conclusione

La sincronizzazione automatica di Lema ti permette di lavorare in team senza pensieri, con la certezza che tutti vedano sempre i dati più aggiornati. Se hai dubbi o problemi, controlla l'indicatore di connessione e segui i suggerimenti in questa guida.

💡 Vuoi saperne di più? Consulta la documentazione tecnica API per dettagli su come integrare sistemi esterni con il real-time sync.