Compare commits

..

2 Commits

9 changed files with 317 additions and 8 deletions

View File

@@ -4,6 +4,32 @@ Todas as alterações notáveis neste projeto serão documentadas neste arquivo.
O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/), O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/). e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/).
## [1.4.0] - 2026-08-07
### Adicionado
- **Exibição da Versão do Aplicativo no Rodapé das Telas**:
- Adicionado rodapé visual com a versão dinâmica do software (`DeviceUtils.getAppVersion`) no final da **Tela de Informações Importantes** (`ImportantInfoScreen.kt`).
- Adicionado rodapé visual com a versão dinâmica do software no final da **Tela de Configurações** (`SettingsScreen.kt`).
### Alterado
- **Versão do Aplicativo**: Incrementada a versão para `1.4.0` (com `versionCode = 5`).
---
## [1.3.0] - 2026-08-07
### Adicionado
- **Sincronização Automática Periódica em Segundo Plano**:
- Implementado loop contínuo no `MaintenanceViewModel` (`viewModelScope`) com intervalo fixo de **5 minutos** (300.000 ms).
- Execução global ativa em **qualquer tela do aplicativo** (`Informações`, `Dashboard`, `Ordens` e `Configurações`) através do compartilhamento do ViewModel no escopo da `MainActivity`.
- **Card Informativo na Tela de Configurações (`AutoSyncStatusCard`)**:
- Adicionado componente visual na Tela de Configurações exibindo o período/frequência de tentativa de sincronização automática (*"A cada 5 minutos"*), a abrangência (*"Ativa em qualquer tela"*), o status da rede/sincronização e o timestamp exato da última sincronização realizada na sessão.
- **Registro Detalhado no Histórico de Logs (`AppLogger` / `app_logs`)**:
- Gravadas todas as tentativas de sincronização automática e manual no banco de dados local com tags `AutoSync` e `SyncManager` nos níveis de severidade `INFO` (início e sucesso com total de itens e conflitos), `WARN` (cancelado por falta de rede ou app bloqueado) e `ERROR` (falhas e exceções).
- Os logs ficam imediatamente disponíveis para auditoria no modal **Histórico de Logs** na tela de Configurações.
### Alterado
- **Versão do Aplicativo**: Incrementada a versão para `1.3.0` (com `versionCode = 4`).
--- ---

View File

@@ -16,7 +16,7 @@ Aplicativo Android **offline-first** desenvolvido em Kotlin e Jetpack Compose pa
- Carregamento e download de fotos **sob demanda** (On-Demand Loading) para múltiplos celulares sem erros HTTP 403. - Carregamento e download de fotos **sob demanda** (On-Demand Loading) para múltiplos celulares sem erros HTTP 403.
- **[Changelog / Histórico de Versões](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/CHANGELOG.md)**: - **[Changelog / Histórico de Versões](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/CHANGELOG.md)**:
- Registro de alterações por versão (Versão Atual: **`1.2.0`** - `versionCode 3`). - Registro de alterações por versão (Versão Atual: **`1.4.0`** - `versionCode 5`).
- **[Arquitetura do Sistema](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/arquitetura/arquitetura_do_sistema.md)**: - **[Arquitetura do Sistema](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/arquitetura/arquitetura_do_sistema.md)**:
- Diagramas de arquitetura MVVM + Repository Pattern. - Diagramas de arquitetura MVVM + Repository Pattern.

View File

@@ -17,8 +17,8 @@ android {
applicationId = "com.aistudio.gestaoparadaos.xvyzwt" applicationId = "com.aistudio.gestaoparadaos.xvyzwt"
minSdk = 24 minSdk = 24
targetSdk = 36 targetSdk = 36
versionCode = 3 versionCode = 5
versionName = "1.2.0" versionName = "1.4.0"
testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
} }

View File

@@ -39,6 +39,15 @@ class MaintenanceRepository(
appLogDao.clearAllLogs() appLogDao.clearAllLogs()
} }
fun logAppLog(level: String, tag: String, message: String, throwable: Throwable? = null) {
val logger = com.example.util.AppLogger.getInstance(context)
when (level.uppercase()) {
"ERROR" -> logger.logError(tag, message, throwable)
"WARN" -> logger.logWarning(tag, message)
else -> logger.logInfo(tag, message)
}
}
val isNetworkConnected: Flow<Boolean> = networkMonitor.isConnected val isNetworkConnected: Flow<Boolean> = networkMonitor.isConnected
fun isCurrentlyConnected(): Boolean = networkMonitor.isCurrentlyConnected() fun isCurrentlyConnected(): Boolean = networkMonitor.isCurrentlyConnected()

View File

@@ -210,6 +210,22 @@ fun ImportantInfoScreen(
} }
) )
} }
item {
Spacer(modifier = Modifier.height(12.dp))
Box(
modifier = Modifier.fillMaxWidth(),
contentAlignment = Alignment.Center
) {
Text(
text = "Versão do aplicativo: ${com.example.util.DeviceUtils.getAppVersion(context)}",
fontSize = 12.sp,
color = Color.Gray,
fontWeight = FontWeight.Medium
)
}
Spacer(modifier = Modifier.height(16.dp))
}
} }
} }
} }

View File

@@ -67,6 +67,9 @@ fun SettingsScreen(
val appLogs by viewModel.appLogsState.collectAsStateWithLifecycle() val appLogs by viewModel.appLogsState.collectAsStateWithLifecycle()
val userAccessLevel by viewModel.userAccessLevel.collectAsStateWithLifecycle() val userAccessLevel by viewModel.userAccessLevel.collectAsStateWithLifecycle()
val simulationConfig by viewModel.simulationConfig.collectAsStateWithLifecycle() val simulationConfig by viewModel.simulationConfig.collectAsStateWithLifecycle()
val isNetworkConnected by viewModel.isNetworkConnected.collectAsStateWithLifecycle(initialValue = true)
val autoSyncIntervalMinutes by viewModel.autoSyncIntervalMinutes.collectAsStateWithLifecycle()
val lastSyncTimestamp by viewModel.lastSyncTimestamp.collectAsStateWithLifecycle()
val hasTotalAccess = remember(userAccessLevel) { val hasTotalAccess = remember(userAccessLevel) {
userAccessLevel?.trim()?.equals("total", ignoreCase = true) == true userAccessLevel?.trim()?.equals("total", ignoreCase = true) == true
@@ -152,6 +155,14 @@ fun SettingsScreen(
verticalArrangement = Arrangement.spacedBy(20.dp) verticalArrangement = Arrangement.spacedBy(20.dp)
) { ) {
// Seção: Status da Sincronização Automática
AutoSyncStatusCard(
autoSyncIntervalMinutes = autoSyncIntervalMinutes,
isNetworkConnected = isNetworkConnected,
isSyncing = isSyncing,
lastSyncTimestamp = lastSyncTimestamp
)
// Seção: Painel do Administrador // Seção: Painel do Administrador
Column { Column {
Text( Text(
@@ -225,6 +236,21 @@ fun SettingsScreen(
viewModel.clearDateSimulation() viewModel.clearDateSimulation()
} }
) )
// Rodapé com exibição da versão do aplicativo
Box(
modifier = Modifier
.fillMaxWidth()
.padding(vertical = 12.dp),
contentAlignment = Alignment.Center
) {
Text(
text = "Versão do aplicativo: ${com.example.util.DeviceUtils.getAppVersion(context)}",
fontSize = 12.sp,
color = Color.Gray,
fontWeight = FontWeight.Medium
)
}
} }
} }
@@ -1028,4 +1054,142 @@ fun AppLogsHistoryDialog(
} }
} }
@Composable
fun AutoSyncStatusCard(
autoSyncIntervalMinutes: Int,
isNetworkConnected: Boolean,
isSyncing: Boolean,
lastSyncTimestamp: Long?
) {
val dateFormatter = remember { SimpleDateFormat("HH:mm:ss - dd/MM/yyyy", Locale.getDefault()) }
val lastSyncFormatted = remember(lastSyncTimestamp) {
if (lastSyncTimestamp != null && lastSyncTimestamp > 0) {
dateFormatter.format(Date(lastSyncTimestamp))
} else {
"Nenhuma sincronização nesta sessão"
}
}
Card(
colors = CardDefaults.cardColors(containerColor = Color.White),
elevation = CardDefaults.cardElevation(defaultElevation = 2.dp),
shape = RoundedCornerShape(12.dp),
modifier = Modifier.fillMaxWidth()
) {
Column(
modifier = Modifier.padding(16.dp),
verticalArrangement = Arrangement.spacedBy(10.dp)
) {
Row(
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(10.dp)
) {
Icon(
imageVector = Icons.Default.Sync,
contentDescription = null,
tint = BrandGreen,
modifier = Modifier.size(24.dp)
)
Text(
text = "Sincronização Automática em Background",
fontSize = 16.sp,
fontWeight = FontWeight.Bold,
color = BrandBlack
)
}
HorizontalDivider(color = LightGrey)
Row(
modifier = Modifier.fillMaxWidth(),
horizontalArrangement = Arrangement.SpaceBetween,
verticalAlignment = Alignment.CenterVertically
) {
Text(
text = "Frequência / Período:",
fontSize = 13.sp,
color = Color.Gray
)
Surface(
color = BrandLightGreen,
shape = RoundedCornerShape(16.dp)
) {
Text(
text = "A cada $autoSyncIntervalMinutes minutos",
fontSize = 12.sp,
fontWeight = FontWeight.Bold,
color = BrandGreen,
modifier = Modifier.padding(horizontal = 10.dp, vertical = 4.dp)
)
}
}
Row(
modifier = Modifier.fillMaxWidth(),
horizontalArrangement = Arrangement.SpaceBetween,
verticalAlignment = Alignment.CenterVertically
) {
Text(
text = "Abrangência:",
fontSize = 13.sp,
color = Color.Gray
)
Text(
text = "Ativa em qualquer tela",
fontSize = 13.sp,
fontWeight = FontWeight.Medium,
color = BrandBlack
)
}
Row(
modifier = Modifier.fillMaxWidth(),
horizontalArrangement = Arrangement.SpaceBetween,
verticalAlignment = Alignment.CenterVertically
) {
Text(
text = "Status da Conexão:",
fontSize = 13.sp,
color = Color.Gray
)
Row(
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(6.dp)
) {
Box(
modifier = Modifier
.size(8.dp)
.clip(androidx.compose.foundation.shape.CircleShape)
.background(if (isNetworkConnected) BrandGreen else Color.Red)
)
Text(
text = if (isSyncing) "Sincronizando..." else if (isNetworkConnected) "Conectado ao BD Online" else "Modo Offline",
fontSize = 13.sp,
fontWeight = FontWeight.SemiBold,
color = if (isSyncing) Color(0xFFFF9100) else if (isNetworkConnected) BrandGreen else Color.Red
)
}
}
Row(
modifier = Modifier.fillMaxWidth(),
horizontalArrangement = Arrangement.SpaceBetween,
verticalAlignment = Alignment.CenterVertically
) {
Text(
text = "Última Sincronização:",
fontSize = 13.sp,
color = Color.Gray
)
Text(
text = lastSyncFormatted,
fontSize = 12.sp,
fontWeight = FontWeight.Medium,
color = BrandBlack
)
}
}
}
}

View File

@@ -170,6 +170,15 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View
private val _syncStatusMessage = MutableStateFlow<String?>(null) private val _syncStatusMessage = MutableStateFlow<String?>(null)
val syncStatusMessage = _syncStatusMessage.asStateFlow() val syncStatusMessage = _syncStatusMessage.asStateFlow()
// Auto-Sync Background Loop & Last Sync State
private val _autoSyncIntervalMinutes = MutableStateFlow(AUTO_SYNC_INTERVAL_MINUTES)
val autoSyncIntervalMinutes = _autoSyncIntervalMinutes.asStateFlow()
private val _lastSyncTimestamp = MutableStateFlow<Long?>(null)
val lastSyncTimestamp = _lastSyncTimestamp.asStateFlow()
private var autoSyncJob: kotlinx.coroutines.Job? = null
val appSecurityState: StateFlow<AppSecurityState> = repository.appSecurityState.stateIn( val appSecurityState: StateFlow<AppSecurityState> = repository.appSecurityState.stateIn(
scope = viewModelScope, scope = viewModelScope,
started = SharingStarted.WhileSubscribed(5000), started = SharingStarted.WhileSubscribed(5000),
@@ -479,6 +488,9 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View
isFirstEmission = false isFirstEmission = false
} }
} }
// Start periodic auto-sync background loop (every 5 minutes)
startAutoSyncLoop()
} }
fun selectActivity(activity: MaintenanceActivity?) { fun selectActivity(activity: MaintenanceActivity?) {
@@ -572,24 +584,31 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View
val currentSecurity = appSecurityState.value val currentSecurity = appSecurityState.value
if (currentSecurity !is AppSecurityState.Allowed) { if (currentSecurity !is AppSecurityState.Allowed) {
checkSecurityConfigNow() checkSecurityConfigNow()
repository.logAppLog("WARN", "SyncManager", "Sincronização manual impedida: aplicativo bloqueado por regras de segurança.")
return return
} }
if (!_internetAvailable.value) { if (!_internetAvailable.value) {
_syncStatusMessage.value = "Sincronização impossível: Sem conectividade de rede na área atual." _syncStatusMessage.value = "Sincronização impossível: Sem conectividade de rede na área atual."
repository.logAppLog("WARN", "SyncManager", "Sincronização manual impedida: sem conexão com a internet.")
return return
} }
if (_isSyncing.value) { if (_isSyncing.value) {
repository.logAppLog("WARN", "SyncManager", "Tentativa de sincronização ignorada: já existe uma sincronização em andamento.")
return return
} }
viewModelScope.launch { viewModelScope.launch {
_isSyncing.value = true _isSyncing.value = true
_syncStatusMessage.value = "Conectando ao servidor central..." _syncStatusMessage.value = "Conectando ao servidor central..."
repository.logAppLog("INFO", "SyncManager", "Iniciando sincronização manual de dados...")
try {
when (val result = repository.synchronizeWithBackend()) { when (val result = repository.synchronizeWithBackend()) {
is SyncResult.Success -> { is SyncResult.Success -> {
_lastSyncTimestamp.value = System.currentTimeMillis()
_syncStatusMessage.value = "Sincronização concluída! ${result.syncedItems} OSs sincronizadas com sucesso. Conflitos resolvidos: ${result.conflictsResolved}." _syncStatusMessage.value = "Sincronização concluída! ${result.syncedItems} OSs sincronizadas com sucesso. Conflitos resolvidos: ${result.conflictsResolved}."
repository.logAppLog("INFO", "SyncManager", "Sincronização concluída com sucesso! ${result.syncedItems} itens sincronizados. Conflitos resolvidos: ${result.conflictsResolved}.")
// Refresh selected activity if active to show sync badge // Refresh selected activity if active to show sync badge
_selectedActivity.value?.let { active -> _selectedActivity.value?.let { active ->
_selectedActivity.value = allActivitiesState.value.find { it.numeroOs == active.numeroOs } _selectedActivity.value = allActivitiesState.value.find { it.numeroOs == active.numeroOs }
@@ -600,8 +619,71 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View
} }
is SyncResult.Error -> { is SyncResult.Error -> {
_syncStatusMessage.value = "Falha na sincronização: ${result.message}" _syncStatusMessage.value = "Falha na sincronização: ${result.message}"
repository.logAppLog("ERROR", "SyncManager", "Falha na sincronização: ${result.message}")
} }
} }
} catch (e: Exception) {
_syncStatusMessage.value = "Erro na sincronização: ${e.message}"
repository.logAppLog("ERROR", "SyncManager", "Exceção na sincronização: ${e.message}", e)
} finally {
_isSyncing.value = false
}
}
}
private fun startAutoSyncLoop() {
autoSyncJob?.cancel()
autoSyncJob = viewModelScope.launch {
while (true) {
kotlinx.coroutines.delay(AUTO_SYNC_INTERVAL_MS)
performAutoSyncAttempt()
}
}
}
private suspend fun performAutoSyncAttempt() {
val currentSecurity = appSecurityState.value
if (currentSecurity !is AppSecurityState.Allowed) {
repository.logAppLog("WARN", "AutoSync", "Tentativa de sincronização automática ignorada: aplicativo bloqueado por segurança.")
return
}
if (!_internetAvailable.value) {
repository.logAppLog("WARN", "AutoSync", "Tentativa de sincronização automática ignorada: sem conectividade de rede no momento.")
return
}
if (_isSyncing.value) {
repository.logAppLog("WARN", "AutoSync", "Tentativa de sincronização automática ignorada: outra sincronização já está em andamento.")
return
}
repository.logAppLog("INFO", "AutoSync", "Iniciando tentativa de sincronização automática em segundo plano (intervalo: $AUTO_SYNC_INTERVAL_MINUTES min)...")
_isSyncing.value = true
_syncStatusMessage.value = "Sincronizando em segundo plano (automático)..."
try {
when (val result = repository.synchronizeWithBackend()) {
is SyncResult.Success -> {
_lastSyncTimestamp.value = System.currentTimeMillis()
_syncStatusMessage.value = "Sincronização automática concluída com sucesso! (${result.syncedItems} itens)"
repository.logAppLog("INFO", "AutoSync", "Sincronização automática concluída com sucesso! ${result.syncedItems} OSs sincronizadas. Conflitos resolvidos: ${result.conflictsResolved}.")
_selectedActivity.value?.let { active ->
_selectedActivity.value = allActivitiesState.value.find { it.numeroOs == active.numeroOs }
}
_currentUser.value?.let { user ->
checkUserAccessLevel(user.email)
}
}
is SyncResult.Error -> {
_syncStatusMessage.value = "Falha na sincronização automática: ${result.message}"
repository.logAppLog("ERROR", "AutoSync", "Falha na sincronização automática: ${result.message}")
}
}
} catch (e: Exception) {
repository.logAppLog("ERROR", "AutoSync", "Exceção na sincronização automática: ${e.message}", e)
} finally {
_isSyncing.value = false _isSyncing.value = false
} }
} }
@@ -885,6 +967,9 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View
): AnalyticsState = Companion.calculateAnalyticsState(activities, history, referenceDateOverride, selectedSetorSCurve) ): AnalyticsState = Companion.calculateAnalyticsState(activities, history, referenceDateOverride, selectedSetorSCurve)
companion object { companion object {
private const val AUTO_SYNC_INTERVAL_MINUTES = 5
private const val AUTO_SYNC_INTERVAL_MS = AUTO_SYNC_INTERVAL_MINUTES * 60 * 1000L
fun calculateAnalyticsState( fun calculateAnalyticsState(
activities: List<MaintenanceActivity>, activities: List<MaintenanceActivity>,
history: List<OSUpdateHistory>, history: List<OSUpdateHistory>,

View File

@@ -46,7 +46,7 @@ object DeviceUtils {
fun getAppVersion(context: Context): String { fun getAppVersion(context: Context): String {
return try { return try {
val packageInfo = context.packageManager.getPackageInfo(context.packageName, 0) val packageInfo = context.packageManager.getPackageInfo(context.packageName, 0)
val versionName = packageInfo.versionName ?: "1.2.0" val versionName = packageInfo.versionName ?: "1.4.0"
@Suppress("DEPRECATION") @Suppress("DEPRECATION")
val versionCode = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) { val versionCode = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
packageInfo.longVersionCode packageInfo.longVersionCode
@@ -55,7 +55,7 @@ object DeviceUtils {
} }
"$versionName (v$versionCode)" "$versionName (v$versionCode)"
} catch (e: Exception) { } catch (e: Exception) {
"1.2.0" "1.4.0"
} }
} }
} }

View File

@@ -212,6 +212,15 @@ O aplicativo sincroniza com quatro abas da planilha central:
- Executa **Upsert**: localiza a linha do dispositivo através do `device_id` (`Settings.Secure.ANDROID_ID` ou UUID). Se já existir, atualiza os dados e o timestamp do último acesso; se for um aparelho novo, cria uma nova linha na planilha. - Executa **Upsert**: localiza a linha do dispositivo através do `device_id` (`Settings.Secure.ANDROID_ID` ou UUID). Se já existir, atualiza os dados e o timestamp do último acesso; se for um aparelho novo, cria uma nova linha na planilha.
- Permite auditoria em tempo real de quantos e quais celulares acessaram o app online e qual conta do Google Sign-In foi utilizada. - Permite auditoria em tempo real de quantos e quais celulares acessaram o app online e qual conta do Google Sign-In foi utilizada.
### 4.3. Loop de Sincronização Automática Periódica e Registros em Logs (`MaintenanceViewModel.kt`)
- **Frequência e Abrangência**: O aplicativo mantém um loop de sincronização automática em plano de fundo executado a cada **5 minutos** (300.000 ms). Por estar vinculado ao `MaintenanceViewModel` instanciado na `MainActivity`, ele é executado continuamente em **qualquer tela** do app (`Informações`, `Dashboard`, `Ordens` e `Configurações`).
- **Auditoria no Histórico de Logs (`app_logs`)**: Todas as tentativas de sincronização (automáticas e manuais) registram eventos no banco de dados local Room (`app_logs`) através do `AppLogger`:
- **`INFO` (Início)**: Registra o disparo da tentativa (`AutoSync` / `SyncManager`).
- **`INFO` (Sucesso)**: Registra a conclusão bem-sucedida, contagem de itens sincronizados e conflitos resolvidos.
- **`WARN` (Alerta/Ignorado)**: Registra quando a sincronização é pulada por falta de conectividade à internet ou por trava de segurança ativa (`AppSecurityLockDialog`).
- **`ERROR` (Falha)**: Registra erros capturados durante a transmissão com stack trace associado.
- **Visualização na Interface**: O card `AutoSyncStatusCard` na tela de Configurações exibe a frequência (*"A cada 5 minutos"*), a abrangência (*"Ativa em qualquer tela"*), o status da conexão e o horário formatado da última sincronização bem-sucedida.
--- ---
## 5. Download e Exibição de Fotos Sob Demanda (On-Demand Loading) ## 5. Download e Exibição de Fotos Sob Demanda (On-Demand Loading)