feat: add date simulation feature to manipulate system time in dashboard and settings

This commit is contained in:
Jhony Cesar
2026-08-05 18:47:38 -04:00
parent 8f802d551f
commit 1cb8578e9b
8 changed files with 421 additions and 15 deletions

View File

@@ -87,3 +87,24 @@ Abaixo está o levantamento detalhado de cada um desses elementos, com suas resp
* **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:**
* [`DateSimulationState.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/DateSimulationState.kt)
* [`MaintenanceViewModel.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt)
* [`MaintenanceRepository.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt)
* [`SettingsScreen.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/screens/SettingsScreen.kt)
* [`MaintenanceDashboardScreen.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt)
* **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.