💶 CaliMoney

Documentazione

Offline e sincronizzazione

Come funziona la modalità offline e la sincronizzazione con il cloud

CaliMoney è progettata per funzionare senza connessione internet. Tutti i dati vengono scritti prima nel database locale (IndexedDB via Dexie) e poi sincronizzati con Firestore quando sei online.

Indicatore di stato

Quando non hai connessione, nell'header compare un badge Offline. Scompare non appena la connessione viene ripristinata.

Cosa puoi fare offline

AzioneOffline
Visualizzare i movimenti✅ Dalla cache locale
Aggiungere movimenti✅ Salvati localmente
Modificare movimenti✅ Salvati localmente
Eliminare movimenti✅ Salvati localmente
Visualizzare la dashboard✅ Dati dalla cache
Sincronizzare con il cloud❌ Richiede connessione

Coda di sincronizzazione

Le operazioni eseguite offline (aggiunta, modifica, eliminazione) vengono messe in una coda di sincronizzazione. I movimenti in attesa mostrano un'icona orologio.

Quando torni online, CaliMoney sincronizza automaticamente tutte le operazioni pendenti nell'ordine in cui sono state eseguite.

I movimenti in attesa di sincronizzazione non sono modificabili finché non vengono sincronizzati. Questo evita conflitti di dati.

Installazione come app (PWA)

CaliMoney è una Progressive Web App: puoi aggiungerla alla schermata home del tuo telefono per un'esperienza simile a un'app nativa, con accesso offline immediato.

Quando apri l'app su un browser mobile, compare un banner di installazione nella parte bassa dello schermo.

  • Android (Chrome) — tocca Installa nel banner. Il browser ti chiederà di confermare.
  • iOS (Safari) — il banner mostra le istruzioni passo-passo:
    1. Tocca Condividi ⬆️
    2. Tocca Visualizza altro
    3. Tocca Aggiungi alla schermata Home

Se chiudi il banner, riapparirà la prossima volta che apri l'app nel browser.