feat: add device access logging to Google Sheets with device identification utilities
This commit is contained in:
@@ -69,10 +69,14 @@ A estrutura do código fonte está localizada no pacote `com.example` e é organ
|
||||
* [`MaintenanceDao.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/local/MaintenanceDao.kt): Consultas locais SQL (queries reativas com `Flow` e operações `suspend`).
|
||||
* [`model/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/)
|
||||
* [`MaintenanceActivity.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/MaintenanceActivity.kt): Entidades Room (`MaintenanceActivity`, `OSUpdateHistory`), enumerador `ActivityStatus` e auxiliares de formatação/parsing de data.
|
||||
* [`DeviceAccessInfo.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/DeviceAccessInfo.kt): Estrutura de dados contendo detalhes de hardware, software, e-mail do Google SSO e timestamp do último acesso.
|
||||
* [`remote/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/remote/)
|
||||
* [`GoogleSheetsSyncService.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/remote/GoogleSheetsSyncService.kt): Serviço de integração HTTP com a API v4 do Google Sheets, englobando serialização JSON (Moshi), autenticação e mapeamento de planilhas.
|
||||
* [`GoogleSheetsSyncService.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/remote/GoogleSheetsSyncService.kt): Serviço de integração HTTP com a API v4 do Google Sheets, englobando serialização JSON (Moshi), autenticação e mapeamento de planilhas (`project`, `history`, `achados`, `usage_history`).
|
||||
* [`repository/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/repository/)
|
||||
* [`MaintenanceRepository.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt): Mediador de dados, processamento de planilhas locais (CSV) e algoritmo central de reconciliação de estado.
|
||||
* `util/` (Utilitários)
|
||||
* [`DeviceUtils.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/util/DeviceUtils.kt): Utilitário de extração de metadados do aparelho (`ANDROID_ID`, modelo, versão do Android e versão do app).
|
||||
* [`TimeGuardManager.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/util/TimeGuardManager.kt): Validador de hora do sistema e prevenção de data retroativa.
|
||||
* `ui/` (Camada de Apresentação)
|
||||
* [`components/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/components/)
|
||||
* [`AppLogo.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/components/AppLogo.kt): Logotipo customizado desenhado via Canvas vetorial utilizando cores da marca.
|
||||
|
||||
@@ -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.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user