feat: implement real Google Drive photo synchronization and replace camera mocks with native file handling

This commit is contained in:
Jhony Cesar
2026-08-04 15:20:16 -04:00
parent bc03351363
commit 4a4c151b14
13 changed files with 646 additions and 91 deletions

View File

@@ -48,22 +48,20 @@ O armazenamento é realizado por meio do **Room Database**, que é uma camada de
## 2. Análise da Sincronização Remota
### A sincronização remota está realmente implementada?
**Atualmente, a sincronização é SIMULADA (Mocked).** Não há nenhuma conexão real HTTP, REST API, Firebase ou WebSocket ativa enviando dados para um servidor externo. O código simula perfeitamente o comportamento que um fluxo de rede real teria.
### A sincronização remota está real e funcionalmente implementada?
**Sim, a sincronização é REAL e BIDIRECIONAL.** O aplicativo utiliza a **Google Sheets API v4** (`GoogleSheetsSyncService.kt`) para sincronizar a estrutura do projeto e logs de alteração, e a **Google Drive API v3** (`GoogleDriveSyncService.kt`) para upload de fotos das OSs na pasta do Google Drive `15WJIdzrykXWRSC5Xy4Ci5Cr7gq6FqMxK`.
### Como a simulação funciona?
No método `synchronizeWithBackend()` dentro de `MaintenanceRepository.kt`:
1. O repositório busca do banco local todas as atividades de manutenção que possuem a flag `synced = false` (obtidas por `dao.getUnsyncedActivities()`).
2. Aplica um atraso artificial de 2,5 segundos (`delay(2500)`) usando Corrotinas para emular a latência de uma chamada de rede real.
3. Executa um algoritmo matemático simples de resolução de conflitos em cerca de 15% das ordens de serviço (usando o resto da divisão do hash do número da OS por 7).
4. No cenário simulado de conflito, adota a estratégia **"Last-Write-Wins"** (Última escrita vence), assumindo que a alteração local feita no campo pelo inspetor é a mais recente e deve sobrescrever o "servidor".
5. Atualiza todos os registros modificados localmente no banco Room para `synced = true`.
### Como o fluxo de sincronização e envio de fotos funciona?
1. **Captura e Armazenamento Local (Offline-First):** As fotos capturadas pela Câmera ou selecionadas da Galeria são armazenadas em `filesDir/os_photos/` e registradas na Room DB.
2. **Upload para o Google Drive:** No momento do sync, o `MaintenanceRepository.kt` lê as fotos pendentes e aciona o `GoogleDriveSyncService.kt`, que faz o upload multipart usando a Service Account `drive-fotos-gestaoosparada.apikey.json` para a pasta do Drive `15WJIdzrykXWRSC5Xy4Ci5Cr7gq6FqMxK`.
3. **Link Público e Sincronismo com Google Sheets:** O serviço define a permissão pública (`anyone with link - reader`) e obtém o `webViewLink`, atualizando a Room DB e a aba `history` do Google Sheets.
4. **Soft Delete:** A exclusão de fotos no app não remove os arquivos fisicamente da pasta do Google Drive, mas executa uma chamada `PATCH` adicionando o sufixo `_DELETED` ao arquivo e atualiza os registros locais.
### Arquivos responsáveis por essa conexão e sincronização:
* **`com.example.data.model.MaintenanceActivity`:** Contém os atributos `synced: Boolean` (indica se a OS local está pareada com o servidor) e `lastUpdated: Long` (carimbo de data/hora em milissegundos para resolver conflitos de alteração concorrente).
* **`com.example.data.local.MaintenanceDao`:** Contém a consulta SQL `@Query("SELECT * FROM maintenance_activities WHERE synced = 0")` para extrair apenas o que foi alterado offline e precisa subir.
* **`com.example.data.repository.MaintenanceRepository`:** Contém o método `synchronizeWithBackend()`, que centraliza toda a lógica de preparação do lote de envio, simulação de rede e marcação de sincronizado.
* **`com.example.ui.viewmodel.MaintenanceViewModel`:** Contém o método `syncWithBackend()`, que executa a chamada ao repositório dentro de um escopo de Coroutine, altera o estado da tela para "Carregando" (Loading), lida com o resultado de sucesso ou falha, e atualiza a UI.
### Arquivos responsáveis pela conexão e sincronização:
* **`com.example.data.remote.GoogleDriveSyncService`:** Gerencia autenticação via Service Account, upload multipart de fotos e soft delete no Google Drive.
* **`com.example.data.remote.GoogleSheetsSyncService`:** Gerencia autenticação via Service Account e reconciliação bidirecional com a planilha central do Google Sheets.
* **`com.example.data.repository.MaintenanceRepository`:** Centraliza a orquestração do sync, upload de mídias pendentes, resolução de conflitos (LWW) e soft delete.
* **`com.example.ui.viewmodel.MaintenanceViewModel`:** Gerencia os estados de sync na UI, disparos assíncronos e callbacks de gerenciamento de fotos.
---