💶 CaliMoney

Documentazione

Offline e sincronizzazione

CaliMoney funziona al 100% offline: registra spese ed entrate senza internet. I dati si sincronizzano automaticamente con il cloud al ritorno online.

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.

Il badge attende un paio di secondi prima di comparire, così un'interruzione breve — per esempio quando sul telefono passi a un'altra app e poi torni — non lo fa lampeggiare. Quando torni su CaliMoney, la connessione viene ricontrollata subito.

Cosa puoi fare offline

AzioneOffline
Visualizzare i movimenti✅ Dalla cache locale
Aggiungere movimenti✅ Salvati localmente
Modificare movimenti✅ Salvati localmente
Eliminare movimenti✅ Salvati localmente
Duplicare movimenti✅ Salvati localmente
Copiare un movimento come testo✅ Funziona offline
Modificare i movimenti ricorrenti✅ Salvati localmente
Rendere ricorrente un abbonamento suggerito✅ Trovato sul dispositivo, salvato localmente
Gestire le categorie✅ Salvate localmente
Visualizzare la dashboard✅ Dati dalla cache
Importare un estratto CSV/Excel✅ Letto interamente sul dispositivo — vedi Importa
Importare un estratto PDF o una foto❌ Richiede connessione (estrazione AI)
Recuperare movimenti eliminati da un'istantanea✅ Le istantanee sono su questo dispositivo — vedi Esporta
Sincronizzare con il cloud❌ Richiede connessione

Coda di sincronizzazione

Le operazioni eseguite offline (aggiunta, modifica, eliminazione — movimenti, movimenti ricorrenti e categorie) 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 si possono modificare, duplicare ed eliminare come tutti gli altri. Modificarne uno aggiorna l'operazione già in coda invece di aggiungerne un'altra, ed eliminarne uno che non ha ancora raggiunto il cloud lo rimuove semplicemente dal dispositivo.

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.