8.7 KiB
8.7 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 Firebase Storage
- 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 viaActivityResultContracts.GetContent(). - Firebase Storage Sync: Envio de imagens para o bucket do Firebase Storage sob o diretório
photos/OS_{numeroOs}/. - 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_DELETEDna referência do Firebase Storage).
- Câmera & Galeria: Suporte a disparo de câmera nativa do Android via
2. Controle e Simulação de Conectividade de Rede
- Status: Truncado (No-op / Hardcoded)
- Arquivos Relacionados:
MaintenanceViewModel.kt(linhas ~63 e ~204-207)MaintenanceDashboardScreen.kt(linhas ~81 e ~215-224)
- Descrição Técnica:
A ViewModel possui uma flag interna
internetAvailablebaseada emMutableStateFlowe expõe um método chamadotoggleInternet(available: Boolean). No entanto:- O estado de inicialização é fixado em
true. - O método
toggleInternet(...)força o estado de volta paratruede maneira incondicional:fun toggleInternet(available: Boolean) { // App is always online. _internetAvailable.value = true } - Não há integração com o
ConnectivityManagerdo Android para ouvir de forma dinâmica o estado real da rede móvel ou Wi-Fi do aparelho.
- O estado de inicialização é fixado em
- 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:
GoogleSheetsSyncService.kt(linhas ~576-582)
- 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
projectno 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:
MaintenanceRepository.kt(linhas ~278-281)
- 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 em0: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.
6. Simulação de Data do Sistema e Modos de Operação (Visualização / Edição)
- Status: IMPLEMENTADO (Produção)
- Arquivos Relacionados:
- Descrição Técnica:
Funcionalidade de controle e simulação de data do sistema acessível a partir da tela de Configurações:
- Controle de Acesso: Acesso liberado exclusivamente para usuários com nível de acesso Total. Para usuários de outros níveis, a seção é exibida desabilitada com ícone de cadeado e mensagem indicando a necessidade de permissão Nível Total.
- Modos de Simulação:
- Somente Visualização: Altera a data de referência usada nos cálculos de atraso de OSs, linha do tempo e Curva S no Dashboard.
- Edição do Progresso das Ordens: Além de alterar a referência visual, grava o timestamp da data simulada no histórico (
OSUpdateHistory.timestamp) e na data de atualização da OS (lastUpdated).
- Tempo Máximo (15 Minutos): A simulação possui um timer regressivo automático de 15 minutos. Ao atingir esse tempo limite, o aplicativo encerra a simulação, retorna à data real e emite um aviso informativo.
- Banner Visual de Alerta: Um banner no topo das telas principais indica o modo de simulação ativo, a data simulada e disponibiliza um botão rápido para "Desativar Simulação".
- Reset Automático: O estado da simulação reside exclusivamente em memória e reseta automaticamente para a data real ao reiniciar ou fechar o aplicativo.