Files
gestao_de_manutencao/documentacao/recursos_simulados_e_truncados.md

6.5 KiB

Listagem de Recursos Simulados e Truncados

Durante a análise técnica do código fonte do aplicativo de Gestão de Manutenção de Parada, foram identificados recursos que possuem comportamento simulado (mockado) ou que foram implementados de forma parcial/truncada (stubs ou no-ops).

Abaixo está o levantamento detalhado de cada um desses elementos, com suas respectivas localizações de arquivos e descrições técnicas.


1. Captura, Anexo e Armazenamento de Fotos no Google Drive

  • Status: IMPLEMENTADO (Produção)
  • Arquivos Relacionados:
  • Descrição Técnica: A simulação fotográfica foi completamente substituída por funcionalidade real de produção:
    • Câmera & Galeria: Suporte a disparo de câmera nativa do Android via ActivityResultContracts.TakePicture() e seleção de arquivos de imagem via ActivityResultContracts.GetContent().
    • Google Drive Sync: Envio de imagens para a pasta remota ID 15WJIdzrykXWRSC5Xy4Ci5Cr7gq6FqMxK usando a Service Account drive-fotos-gestaoosparada.apikey.json.
    • Galeria & Tela Cheia: Exibição em carrossel horizontal (LazyRow) no modal da OS e visualização em tela cheia com botões de Compartilhar e Deletar (Soft Delete adicionando sufixo _DELETED no Google Drive).

2. Controle e Simulação de Conectividade de Rede

  • Status: Truncado (No-op / Hardcoded)
  • Arquivos Relacionados:
  • Descrição Técnica: A ViewModel possui uma flag interna internetAvailable baseada em MutableStateFlow e expõe um método chamado toggleInternet(available: Boolean). No entanto:
    • O estado de inicialização é fixado em true.
    • O método toggleInternet(...) força o estado de volta para true de maneira incondicional:
      fun toggleInternet(available: Boolean) {
          // App is always online.
          _internetAvailable.value = true
      }
      
    • Não há integração com o ConnectivityManager do Android para ouvir de forma dinâmica o estado real da rede móvel ou Wi-Fi do aparelho.
  • Impacto/Limitação: O recurso de simulação de queda de rede (modo offline planejado para controle em tela) está desativado. O aplicativo sempre assume que está online, e o ícone de nuvem na barra superior permanece constantemente em modo "Conectado/Nuvem Verde".

3. Escrita de Ordens de Serviço Mestre na Planilha (project)

  • Status: Truncado (No-op)
  • Arquivos Relacionados:
  • Descrição Técnica: A função pushActivitiesToSheet é responsável por sincronizar novas OSs criadas ou importadas localmente de volta para a aba principal da planilha remota. No entanto, ela foi intencionalmente esvaziada (tornando-se um método sem ação/no-op):
    fun pushActivitiesToSheet(
        toUpdateRemote: List<Pair<MaintenanceActivity, Int>>,
        toAppendRemote: List<MaintenanceActivity>
    ) {
        // No-op to respect read-only project sheets requirement
    }
    
  • Impacto/Limitação: Caso o usuário importe novas ordens de serviço via planilha CSV local, essas OSs ficarão restritas ao banco de dados do dispositivo móvel local. O aplicativo não tentará escrevê-las na aba project no Google Sheets, respeitando a regra de que a aba mestre de projetos é de leitura exclusiva do aplicativo.

4. IMPLEMENTADO!!! Contador de Conflitos na Sincronização

  • Status: Truncado (Simplificado)
  • Arquivos Relacionados:
  • Descrição Técnica: Durante a finalização do sincronismo bidirecional, a resposta de sucesso (SyncResult.Success) retorna as métricas de itens sincronizados e conflitos resolvidos. No entanto, o valor de conflitos resolvidos é fixado estaticamente em 0:
    SyncResult.Success(
        syncedItems = reconciledActivities.size,
        conflictsResolved = 0
    )
    
  • Impacto/Limitação: Embora o repositório realize de forma bem-sucedida a reconciliação (resolvendo concorrência com base no timestamp da transação mais recente), o aplicativo não calcula ou expõe de forma quantitativa quantos conflitos de concorrência foram identificados e solucionados na execução atual do lote.

5. REMOVIDO!!! Carga de Dados Inicial em Caso de Falha de Conexão (Fallback)

  • Status: Removido
  • Arquivos Relacionados:
  • Descrição Técnica: Anteriormente, o sistema realizava o carregamento automático de dados simulados/modelo (loadSampleData()) caso ocorresse uma falha na primeira sincronização com as planilhas do Google Sheets ou através de botões manuais na UI. Este mecanismo de fallback de dados fictícios foi removido do aplicativo.
  • Impacto/Limitação: O aplicativo não popula mais dados simulados automaticamente ou sob demanda na base SQLite local, garantindo integridade estrita aos dados reais vindos das planilhas Google Sheets ou de importação manual do CSV real do PCM. Se a sincronização inicial falhar e o banco local estiver vazio, o aplicativo exibirá a falha de sincronização e manterá a listagem limpa.