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

@@ -109,6 +109,9 @@ Para expandir o aplicativo de sua estrutura atual de tela única ("Single Screen
* *Recurso:* Formulário para alterar dinamicamente o ID da Planilha Google Sheets ativa.
* *Recurso:* Status de cota e conexão da API do Google, permitindo testar credenciais em tempo real.
* *Recurso:* Console para forçar limpezas na base SQLite ou exportar backup do banco de dados local.
5. **Módulo de Simulação de Data do Sistema (`SettingsScreen` / `DateSimulationSection`):**
* *Recurso:* Painel com controle de permissão por **Nível Total**. Permite escolher a data simulada (Material3 `DatePickerDialog`) e o modo (*Somente Visualização* vs *Edição do Progresso das Ordens*).
* *Recurso:* Possui encerramento automático após **15 minutos** de simulação contínua e exibe banner de alerta no topo do Dashboard indicando a data simulada, modo ativo e ação de desativação rápida.
### 3.2. Proposta de Recursos Técnicos para Implementação Visando Complexidade
1. **Câmera Nativa com Upload Real (Firebase Storage), Suporte a HEIC e Compactação (<= 500KB):**

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.