feat: add device access logging to Google Sheets with device identification utilities

This commit is contained in:
Jhony Cesar
2026-08-06 12:25:26 -04:00
parent 3578697d60
commit 7759186234
8 changed files with 287 additions and 7 deletions

View File

@@ -36,10 +36,11 @@ O aplicativo adota o padrão **MVVM (Model-View-ViewModel)** com **Repository Pa
| - maintenance_activities | - Aba 'project' (Leitura) |
| - os_update_history | | - Aba 'history' (Audit) |
| - os_findings | | - Aba 'achados' (Linhas) |
| - app_logs | +---------------------------+
| - sync_conflict_logs | | Firebase Storage SDK |
| - user_access | | - Bucket de fotos / mídias|
+-----------------------+ +---------------------------+
| - app_logs | | - Aba 'usage_history' (Rastreamento)|
| - sync_conflict_logs | +---------------------------+
| - user_access | | Firebase Storage SDK |
+-----------------------+ | - Bucket de fotos / mídias|
+---------------------------+
```
---
@@ -177,7 +178,7 @@ Armazena o nível de permissão associado aos e-mails cadastrados.
4. Obtém a `downloadUrl` oficial contendo o token de acesso (`?alt=media&token=...`), salva em cache de memória (`downloadUrlCache`), e converte o caminho da foto no banco local para o formato relativo normalizado `photos/OS_{numeroOs}/OS_{numeroOs}_{timestamp}.jpg`.
### 4.2. Sincronização com o Google Sheets (`GoogleSheetsSyncService.kt`)
O aplicativo sincroniza com três abas da planilha central:
O aplicativo sincroniza com quatro abas da planilha central:
1. **Aba `project` (Leitura Mestra)**: Carrega as ordens de serviço ativas.
2. **Aba `history` (Escrita de Auditoria)**: Envia novos registros da tabela `os_update_history`.
@@ -185,6 +186,10 @@ O aplicativo sincroniza com três abas da planilha central:
- Limpa e converte caminhos de fotos locais para o formato relativo `photos/OS_.../*.jpg` via `cleanToStoragePath`.
- Reconcilia achados remotos e locais preservando alterações pendentes (`synced = false`).
- Agrupa e consolida os registros por `(numeroOs, tipo)` para garantir **no máximo 1 linha por OS com `tipo = "FOTO"`** contendo todas as fotos ativas concatenadas por `|`.
4. **Aba `usage_history` (Rastreamento do Último Acesso por Dispositivo)**:
- Garante que a aba contenha os cabeçalhos: `device_id`, `dispositivo`, `email`, `nome_usuario`, `versao_android`, `versao_app`, `ultimo_acesso`, `status_sincronizacao`.
- 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.
---