Progetti — prototipo

Prototipo Cloud POS — architettura offline-first.

Stato e autore: prototipo funzionante sviluppato da Carlo Zuffetti. Non è presentato come sistema in produzione o come referenza di un cliente. La descrizione tecnica è fornita dal suo autore; prestazioni e capacità indicate come obiettivi non sono risultati misurati.

Prototipo

Il contesto

Nel retail, un'interruzione della connessione può compromettere l'operatività di una cassa che dipende dal cloud. Ho sviluppato un prototipo funzionante di piattaforma SaaS multi-tenant per esplorare una soluzione: combinare gestione centralizzata e registrazione locale delle vendite quando la rete non è disponibile.

La sfida

Continuare a lavorare offline richiede anche una sincronizzazione coerente al ritorno della connessione. Se un terminale registra una vendita mentre dalla dashboard centrale viene modificata la disponibilità dello stesso prodotto, sovrascrivere semplicemente la giacenza rischia di cancellare uno dei cambiamenti.

Il punto non è soltanto recuperare la connessione, ma conservare il significato delle operazioni eseguite su sistemi diversi e applicare regole esplicite per le modifiche concorrenti.

La soluzione descritta

La soluzione utilizza un frontend Vue/Nuxt, un backend Go e PostgreSQL. Per le operazioni di vendita, la sincronizzazione trasmette eventi e variazioni anziché sovrascrivere soltanto lo stato finale delle giacenze.

Dati locali nel browser. IndexedDB conserva i dati necessari all'operatività prevista e le vendite registrate durante l'assenza di rete. Quando la connessione è disponibile, il terminale aggiorna i dati dal sistema centrale. Durante il periodo offline la copia locale non può riflettere gli aggiornamenti remoti non ancora ricevuti.

Identificatori generati localmente. Le nuove operazioni ricevono identificatori senza attendere una risposta del server. Questo consente di registrarle offline e di riconoscerle nella sincronizzazione. La generazione locale degli ID, da sola, non dimostra l'assenza di duplicazioni nell'elaborazione.

Coda delle operazioni. Il terminale registra un movimento come «venduti due pezzi», anziché limitarsi a comunicare «la giacenza ora è dieci». Al ripristino della rete, il backend elabora le operazioni tramite transazioni PostgreSQL. Le variazioni additive possono così essere combinate senza sostituire l'intero valore con una copia locale non aggiornata.

Conflitti sulle anagrafiche. Per i dati modificabili da più sorgenti viene usato un controllo di concorrenza ottimistica. Quando viene rilevata una versione non aggiornata, il conflitto viene reso visibile e gestito attraverso un percorso guidato. La regola di scelta e riconciliazione deve essere definita per ciascun tipo di dato.

Il valore operativo

Continuità nelle funzioni offline previste. Il terminale può registrare le vendite localmente durante un'interruzione di rete. La continuità di pagamenti elettronici, periferiche e servizi fiscali dipende dalle rispettive integrazioni e non è dimostrata dalla sola architettura offline-first.

Riconciliazione delle operazioni. L'invio dei movimenti evita il rischio specifico di sovrascrivere le vendite con una giacenza locale obsoleta. La correttezza complessiva dipende anche dalle regole sui movimenti, dagli eventuali aggiustamenti assoluti di inventario e dalla gestione di errori e reinvii.

Evoluzione del servizio. L'impostazione multi-tenant e il backend descritto come stateless sono orientati alla crescita della piattaforma. Servire migliaia di punti vendita simultanei è un obiettivo progettuale: la capacità effettiva del prototipo non è stata misurata con un test di carico documentato.

← Tutti i progetti

Hai un processo che deve funzionare anche con una connessione instabile?

Parliamone.

Parliamo del tuo progetto