Offline e sincronização
Como funcionam o modo offline e a sincronização com a nuvem
O CaliMoney foi feito para funcionar sem conexão com a internet. Todos os dados são gravados primeiro no banco de dados local (IndexedDB via Dexie) e depois sincronizados com o Firestore quando você está on-line.
Indicador de status
Sem conexão, um selo Off-line aparece no cabeçalho. Ele some assim que a conexão volta.
O selo espera alguns segundos antes de aparecer, para que uma queda breve — por exemplo, quando você troca de app e volta no celular — não o faça piscar. Quando você volta ao CaliMoney, a conexão é verificada de novo na hora.
O que dá para fazer offline
| Ação | Offline |
|---|---|
| Ver movimentações | ✅ Do cache local |
| Adicionar movimentações | ✅ Salvo no aparelho |
| Editar movimentações | ✅ Salvo no aparelho |
| Excluir movimentações | ✅ Salvo no aparelho |
| Duplicar movimentações | ✅ Salvo no aparelho |
| Copiar uma movimentação como texto | ✅ Funciona offline |
| Editar modelos recorrentes | ✅ Salvo no aparelho |
| Transformar uma assinatura sugerida em modelo | ✅ Encontrada no aparelho, salva nele |
| Gerenciar categorias | ✅ Salvo no aparelho |
| Ver o painel | ✅ Dados do cache |
| Importar um extrato CSV/Excel | ✅ Lido inteiro no aparelho — veja Importar |
| Importar um extrato em PDF ou foto | ❌ Precisa de conexão (extração por IA) |
| Recuperar movimentações excluídas de um snapshot | ✅ Os snapshots ficam neste aparelho — veja Exportar |
| Sincronizar com a nuvem | ❌ Precisa de conexão |
Fila de sincronização
As operações feitas offline (adicionar, editar, excluir — movimentações, movimentações recorrentes e categorias) entram numa fila de sincronização. Movimentações pendentes mostram um ícone de relógio.
Quando você volta a ficar on-line, o CaliMoney sincroniza automaticamente todas as operações pendentes na ordem em que foram feitas.
Movimentações pendentes podem ser editadas, duplicadas e excluídas como qualquer outra. Editar uma atualiza a operação na fila em vez de adicionar outra, e excluir uma que nunca chegou à nuvem simplesmente a remove do aparelho.
Instalar como app (PWA)
O CaliMoney é um Progressive Web App: você pode adicioná-lo à tela inicial do celular para ter uma experiência parecida com a de um app nativo, com acesso offline imediato.
Quando você abre o app num navegador de celular, um banner de instalação aparece na parte de baixo da tela.
- Android (Chrome) — toque em Instalar no banner. O navegador vai pedir confirmação.
- iOS (Safari) — o banner mostra as instruções passo a passo:
- Toque em Compartilhar ⬆️
- Toque em Mais opções
- Toque em Adicionar à Tela de Início
Se você fechar o banner, ele volta a aparecer na próxima vez que você abrir o app no navegador.