feat: implement automatic background synchronization loop, diagnostic logging, and status card in Settings screen

This commit is contained in:
Jhony Cesar
2026-08-07 10:33:58 -04:00
parent 7a9a782513
commit 1ff582f60a
8 changed files with 275 additions and 8 deletions

View File

@@ -212,6 +212,15 @@ O aplicativo sincroniza com quatro abas da planilha central:
- Executa **Upsert**: localiza a linha do dispositivo através do `device_id` (`Settings.Secure.ANDROID_ID` ou UUID). Se já existir, atualiza os dados e o timestamp do último acesso; se for um aparelho novo, cria uma nova linha na planilha.
- Permite auditoria em tempo real de quantos e quais celulares acessaram o app online e qual conta do Google Sign-In foi utilizada.
### 4.3. Loop de Sincronização Automática Periódica e Registros em Logs (`MaintenanceViewModel.kt`)
- **Frequência e Abrangência**: O aplicativo mantém um loop de sincronização automática em plano de fundo executado a cada **5 minutos** (300.000 ms). Por estar vinculado ao `MaintenanceViewModel` instanciado na `MainActivity`, ele é executado continuamente em **qualquer tela** do app (`Informações`, `Dashboard`, `Ordens` e `Configurações`).
- **Auditoria no Histórico de Logs (`app_logs`)**: Todas as tentativas de sincronização (automáticas e manuais) registram eventos no banco de dados local Room (`app_logs`) através do `AppLogger`:
- **`INFO` (Início)**: Registra o disparo da tentativa (`AutoSync` / `SyncManager`).
- **`INFO` (Sucesso)**: Registra a conclusão bem-sucedida, contagem de itens sincronizados e conflitos resolvidos.
- **`WARN` (Alerta/Ignorado)**: Registra quando a sincronização é pulada por falta de conectividade à internet ou por trava de segurança ativa (`AppSecurityLockDialog`).
- **`ERROR` (Falha)**: Registra erros capturados durante a transmissão com stack trace associado.
- **Visualização na Interface**: O card `AutoSyncStatusCard` na tela de Configurações exibe a frequência (*"A cada 5 minutos"*), a abrangência (*"Ativa em qualquer tela"*), o status da conexão e o horário formatado da última sincronização bem-sucedida.
---
## 5. Download e Exibição de Fotos Sob Demanda (On-Demand Loading)