From 7a9a782513b15e7f1b47018f8b13b490faea87ca Mon Sep 17 00:00:00 2001 From: Jhony Cesar Date: Fri, 7 Aug 2026 09:36:02 -0400 Subject: [PATCH] feat: implement app security lock system with version validation and remote operation blocking --- CHANGELOG.md | 18 ++ README.md | 2 +- app/build.gradle.kts | 4 +- app/src/main/java/com/example/MainActivity.kt | 11 + .../example/data/model/AppSecurityState.kt | 29 ++ .../data/repository/MaintenanceRepository.kt | 55 +++- .../ui/components/AppSecurityLockDialog.kt | 302 ++++++++++++++++++ .../ui/viewmodel/MaintenanceViewModel.kt | 41 +++ .../main/java/com/example/util/DeviceUtils.kt | 4 +- .../java/com/example/util/VersionUtils.kt | 45 +++ .../test/java/com/example/AppSecurityTest.kt | 83 +++++ .../java/com/example/util/VersionUtilsTest.kt | 45 +++ .../arquitetura/arquitetura_do_sistema.md | 6 +- .../fluxo_de_dados_e_sincronizacao.md | 9 +- 14 files changed, 643 insertions(+), 11 deletions(-) create mode 100644 app/src/main/java/com/example/data/model/AppSecurityState.kt create mode 100644 app/src/main/java/com/example/ui/components/AppSecurityLockDialog.kt create mode 100644 app/src/main/java/com/example/util/VersionUtils.kt create mode 100644 app/src/test/java/com/example/AppSecurityTest.kt create mode 100644 app/src/test/java/com/example/util/VersionUtilsTest.kt diff --git a/CHANGELOG.md b/CHANGELOG.md index 0b9a5b0..ce47257 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,24 @@ e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/). --- +## [1.2.0] - 2026-08-07 + +### Adicionado +- **Trava de Segurança e Bloqueio de Operação (`VersaoMinimaApp` e `PararAcessoApp`)**: + - Implementado sistema de verificação de segurança reativo com base nas chaves de configuração `VersaoMinimaApp` e `PararAcessoApp` da aba `config` da planilha online e salvas no banco de dados local Room. + - Exibição de **Popup Não Minimizável (Full-Screen Overlay Modal)** em qualquer tela do aplicativo quando a versão do aplicativo for inferior ao valor de `VersaoMinimaApp` ou se `PararAcessoApp` for igual a `1`. + - Exibição das mensagens padronizadas de bloqueio e contatos dos responsáveis com botões de ação direta para e-mail (`mailto:`) e cópia para área de transferência: + - **Desenvolvedor**: `cesarjhony+dev@gmail.com` + - **Responsável**: `gabrielpizzinatto123@gmail.com` + - Bloqueio completo de qualquer tentativa de sincronização ou leitura de dados via `MaintenanceRepository` e `MaintenanceViewModel` durante o estado bloqueado. +- **Utilitário de Comparação Semântica de Versões (`VersionUtils.kt`)**: Adicionada função de higienização de sufixos de build e comparação numérica de versão semântica (Major, Minor, Patch). +- **Testes Automatizados de Segurança**: Adicionados testes unitários e de integração em `VersionUtilsTest.kt`, `AppSecurityTest.kt` e `AppConfigTest.kt`. + +### Alterado +- **Versão do Aplicativo**: Incrementada a versão para `1.2.0` (com `versionCode = 3`). + +--- + ## [1.1.0] - 2026-08-07 ### Adicionado diff --git a/README.md b/README.md index 8789f33..d20a22e 100644 --- a/README.md +++ b/README.md @@ -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. - **[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.1.0`** - `versionCode 2`). + - Registro de alterações por versão (Versão Atual: **`1.2.0`** - `versionCode 3`). - **[Arquitetura do Sistema](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/arquitetura/arquitetura_do_sistema.md)**: - Diagramas de arquitetura MVVM + Repository Pattern. diff --git a/app/build.gradle.kts b/app/build.gradle.kts index 88ce549..0b2ab75 100644 --- a/app/build.gradle.kts +++ b/app/build.gradle.kts @@ -17,8 +17,8 @@ android { applicationId = "com.aistudio.gestaoparadaos.xvyzwt" minSdk = 24 targetSdk = 36 - versionCode = 2 - versionName = "1.1.0" + versionCode = 3 + versionName = "1.2.0" testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" } diff --git a/app/src/main/java/com/example/MainActivity.kt b/app/src/main/java/com/example/MainActivity.kt index 54041da..dd8309a 100644 --- a/app/src/main/java/com/example/MainActivity.kt +++ b/app/src/main/java/com/example/MainActivity.kt @@ -32,6 +32,8 @@ import com.example.ui.screens.SettingsScreen import com.example.ui.theme.BrandGreen import com.example.ui.theme.BrandLightGreen import com.example.ui.theme.MyApplicationTheme +import androidx.lifecycle.compose.collectAsStateWithLifecycle +import com.example.ui.components.AppSecurityLockDialog import com.example.ui.viewmodel.MaintenanceViewModel import com.example.ui.viewmodel.MaintenanceViewModelFactory @@ -53,6 +55,15 @@ class MainActivity : ComponentActivity() { val navBackStackEntry by navController.currentBackStackEntryAsState() val currentRoute = navBackStackEntry?.destination?.route + val securityState by viewModel.appSecurityState.collectAsStateWithLifecycle() + val isRefreshingConfig by viewModel.isRefreshingConfig.collectAsStateWithLifecycle() + + AppSecurityLockDialog( + securityState = securityState, + isRefreshing = isRefreshingConfig, + onRetryCheck = { viewModel.checkSecurityConfigNow() } + ) + Scaffold( bottomBar = { NavigationBar( diff --git a/app/src/main/java/com/example/data/model/AppSecurityState.kt b/app/src/main/java/com/example/data/model/AppSecurityState.kt new file mode 100644 index 0000000..b059c9b --- /dev/null +++ b/app/src/main/java/com/example/data/model/AppSecurityState.kt @@ -0,0 +1,29 @@ +package com.example.data.model + +data class SecurityContact( + val role: String, + val email: String +) + +sealed class AppSecurityState { + object Allowed : AppSecurityState() + + data class BlockedByMaintenance( + val message: String = "App fora de operação, entrar em contato com o responsável e o desenvolvedor", + val contacts: List = DEFAULT_CONTACTS + ) : AppSecurityState() + + data class BlockedByVersion( + val minVersion: String, + val currentVersion: String, + val message: String = "Versão do app incompativel, você deve atualizar o app para continuar usando, procure o responsável e o desenvolvedor", + val contacts: List = DEFAULT_CONTACTS + ) : AppSecurityState() + + companion object { + val DEFAULT_CONTACTS = listOf( + SecurityContact("Desenvolvedor", "cesarjhony+dev@gmail.com"), + SecurityContact("Responsável", "gabrielpizzinatto123@gmail.com") + ) + } +} diff --git a/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt b/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt index fe6bf98..d73e1e0 100644 --- a/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt +++ b/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt @@ -9,10 +9,14 @@ import com.example.data.model.OSUpdateHistory import com.example.data.model.GoogleUser import com.example.data.model.SyncConflictLog import com.example.data.model.AppConfig +import com.example.data.model.AppSecurityState import com.example.data.model.UserAccess +import com.example.util.DeviceUtils +import com.example.util.VersionUtils import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.delay import kotlinx.coroutines.flow.Flow +import kotlinx.coroutines.flow.map import kotlinx.coroutines.withContext import java.io.BufferedReader import java.io.InputStreamReader @@ -42,6 +46,30 @@ class MaintenanceRepository( val allConfigs: Flow> = dao.getAllConfigsFlow() + val appSecurityState: Flow = allConfigs.map { configs -> + evaluateSecurityState(configs) + } + + fun evaluateSecurityState(configs: List): AppSecurityState { + val pararAcesso = configs.find { it.key.equals("PararAcessoApp", ignoreCase = true) }?.value?.trim() ?: "0" + if (pararAcesso == "1") { + return AppSecurityState.BlockedByMaintenance() + } + + val minVersion = configs.find { it.key.equals("VersaoMinimaApp", ignoreCase = true) }?.value?.trim() ?: "" + if (minVersion.isNotBlank()) { + val currentVersion = DeviceUtils.getAppVersion(context) + if (VersionUtils.isVersionLower(currentVersion, minVersion)) { + return AppSecurityState.BlockedByVersion( + minVersion = minVersion, + currentVersion = VersionUtils.sanitizeVersionString(currentVersion) + ) + } + } + + return AppSecurityState.Allowed + } + val allHistory: Flow> = dao.getAllHistoryFlow() fun getActivityByOs(numeroOs: String): Flow = dao.getActivityByOs(numeroOs) @@ -443,6 +471,19 @@ class MaintenanceRepository( suspend fun synchronizeWithBackend(): SyncResult = withContext(Dispatchers.IO) { try { android.util.Log.d("MaintenanceRepository", "Starting Google Sheets synchronization...") + + // 0. Initial Security State Check from Local Database + val localConfigs = dao.getAllConfigs() + val initialSecurity = evaluateSecurityState(localConfigs) + if (initialSecurity !is AppSecurityState.Allowed) { + val msg = when (initialSecurity) { + is AppSecurityState.BlockedByMaintenance -> initialSecurity.message + is AppSecurityState.BlockedByVersion -> initialSecurity.message + else -> "Sincronização bloqueada por trava de segurança." + } + android.util.Log.e("MaintenanceRepository", "Synchronization blocked by local security state: $msg") + return@withContext SyncResult.Error(msg) + } // Validate system date only when online val isOnline = isCurrentlyConnected() @@ -477,6 +518,16 @@ class MaintenanceRepository( if (remoteConfigs.isNotEmpty()) { dao.insertConfigs(remoteConfigs) android.util.Log.d("MaintenanceRepository", "Sincronizadas ${remoteConfigs.size} configurações da planilha.") + val remoteSecurity = evaluateSecurityState(remoteConfigs) + if (remoteSecurity !is AppSecurityState.Allowed) { + val msg = when (remoteSecurity) { + is AppSecurityState.BlockedByMaintenance -> remoteSecurity.message + is AppSecurityState.BlockedByVersion -> remoteSecurity.message + else -> "Sincronização bloqueada por trava de segurança." + } + android.util.Log.w("MaintenanceRepository", "Sincronização interrompida devido a trava de segurança remota: $msg") + return@withContext SyncResult.Error(msg) + } } } catch (e: Exception) { android.util.Log.e("MaintenanceRepository", "Falha ao carregar configurações da planilha", e) @@ -1106,7 +1157,9 @@ class MaintenanceRepository( com.example.data.model.AppConfig("Link2", "https://exemple.com", "Link de informações de privacidade do app"), com.example.data.model.AppConfig("DescricaoLink2", "Informações de privacidade do APP", "Informações de privacidade"), com.example.data.model.AppConfig("Link3", "https://exemple.com", null), - com.example.data.model.AppConfig("DescricaoLink3", "Termos de uso deste APP", "Termos de uso do APP") + com.example.data.model.AppConfig("DescricaoLink3", "Termos de uso deste APP", "Termos de uso do APP"), + com.example.data.model.AppConfig("VersaoMinimaApp", "1.0.0", "Versão mínima para funcionar o aplicativo sem trava-lo e exigir atualização"), + com.example.data.model.AppConfig("PararAcessoApp", "0", "0 = Permite acesso ao app; 1 = Trava o acesso ao app") ) dao.insertConfigs(defaults) } diff --git a/app/src/main/java/com/example/ui/components/AppSecurityLockDialog.kt b/app/src/main/java/com/example/ui/components/AppSecurityLockDialog.kt new file mode 100644 index 0000000..7ecb06b --- /dev/null +++ b/app/src/main/java/com/example/ui/components/AppSecurityLockDialog.kt @@ -0,0 +1,302 @@ +package com.example.ui.components + +import android.content.ClipData +import android.content.ClipboardManager +import android.content.Context +import android.content.Intent +import android.net.Uri +import android.widget.Toast +import androidx.activity.compose.BackHandler +import androidx.compose.foundation.background +import androidx.compose.foundation.layout.* +import androidx.compose.foundation.shape.RoundedCornerShape +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.filled.Block +import androidx.compose.material.icons.filled.ContentCopy +import androidx.compose.material.icons.filled.Email +import androidx.compose.material.icons.filled.Refresh +import androidx.compose.material.icons.filled.SystemUpdate +import androidx.compose.material3.* +import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.graphics.Color +import androidx.compose.ui.platform.LocalContext +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.text.style.TextAlign +import androidx.compose.ui.unit.dp +import androidx.compose.ui.unit.sp +import androidx.compose.ui.window.Dialog +import androidx.compose.ui.window.DialogProperties +import com.example.data.model.AppSecurityState +import com.example.data.model.SecurityContact + +@Composable +fun AppSecurityLockDialog( + securityState: AppSecurityState, + isRefreshing: Boolean = false, + onRetryCheck: () -> Unit +) { + if (securityState is AppSecurityState.Allowed) return + + // Prevent physical back button navigation + BackHandler(enabled = true) { } + + val context = LocalContext.current + + val title: String + val mainMessage: String + val contacts: List + val isVersionError: Boolean + val minVersion: String + val currentVersion: String + + when (securityState) { + is AppSecurityState.BlockedByMaintenance -> { + title = "App Fora de Operação" + mainMessage = securityState.message + contacts = securityState.contacts + isVersionError = false + minVersion = "" + currentVersion = "" + } + is AppSecurityState.BlockedByVersion -> { + title = "Versão Incompatível" + mainMessage = securityState.message + contacts = securityState.contacts + isVersionError = true + minVersion = securityState.minVersion + currentVersion = securityState.currentVersion + } + AppSecurityState.Allowed -> return + } + + Dialog( + onDismissRequest = { /* Non-dismissible */ }, + properties = DialogProperties( + usePlatformDefaultWidth = false, + dismissOnBackPress = false, + dismissOnClickOutside = false + ) + ) { + Surface( + modifier = Modifier.fillMaxSize(), + color = Color(0xFF1E1E24).copy(alpha = 0.96f) + ) { + Box( + modifier = Modifier + .fillMaxSize() + .padding(24.dp), + contentAlignment = Alignment.Center + ) { + Card( + modifier = Modifier + .fillMaxWidth() + .wrapContentHeight(), + shape = RoundedCornerShape(20.dp), + colors = CardDefaults.cardColors(containerColor = Color.White), + elevation = CardDefaults.cardElevation(defaultElevation = 8.dp) + ) { + Column( + modifier = Modifier + .fillMaxWidth() + .padding(24.dp), + horizontalAlignment = Alignment.CenterHorizontally + ) { + // Header Icon + Surface( + shape = RoundedCornerShape(16.dp), + color = if (isVersionError) Color(0xFFFFF3E0) else Color(0xFFFFEBEE), + modifier = Modifier.size(64.dp) + ) { + Box(contentAlignment = Alignment.Center) { + Icon( + imageVector = if (isVersionError) Icons.Default.SystemUpdate else Icons.Default.Block, + contentDescription = null, + tint = if (isVersionError) Color(0xFFE65100) else Color(0xFFC62828), + modifier = Modifier.size(36.dp) + ) + } + } + + Spacer(modifier = Modifier.height(16.dp)) + + Text( + text = title, + fontSize = 22.sp, + fontWeight = FontWeight.Bold, + color = Color(0xFF1F2937), + textAlign = TextAlign.Center + ) + + Spacer(modifier = Modifier.height(8.dp)) + + Text( + text = mainMessage, + fontSize = 14.sp, + color = Color(0xFF4B5563), + textAlign = TextAlign.Center, + lineHeight = 20.sp + ) + + if (isVersionError && minVersion.isNotBlank()) { + Spacer(modifier = Modifier.height(12.dp)) + Surface( + shape = RoundedCornerShape(8.dp), + color = Color(0xFFF3F4F6), + modifier = Modifier.fillMaxWidth() + ) { + Column( + modifier = Modifier.padding(12.dp), + horizontalAlignment = Alignment.CenterHorizontally + ) { + Text( + text = "Versão instalada: $currentVersion", + fontSize = 12.sp, + fontWeight = FontWeight.Medium, + color = Color(0xFF6B7280) + ) + Text( + text = "Versão mínima requerida: $minVersion", + fontSize = 13.sp, + fontWeight = FontWeight.Bold, + color = Color(0xFFC62828) + ) + } + } + } + + Spacer(modifier = Modifier.height(20.dp)) + + HorizontalDivider(color = Color(0xFFE5E7EB)) + + Spacer(modifier = Modifier.height(16.dp)) + + Text( + text = "Contatos para Suporte", + fontSize = 13.sp, + fontWeight = FontWeight.Bold, + color = Color(0xFF374151), + modifier = Modifier.align(Alignment.Start) + ) + + Spacer(modifier = Modifier.height(8.dp)) + + contacts.forEach { contact -> + ContactRow( + contact = contact, + onSendEmail = { email -> + try { + val intent = Intent(Intent.ACTION_SENDTO, Uri.parse("mailto:$email")) + context.startActivity(intent) + } catch (e: Exception) { + Toast.makeText(context, "E-mail: $email", Toast.LENGTH_SHORT).show() + } + }, + onCopyEmail = { email -> + val clipboard = context.getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager + val clip = ClipData.newPlainText("E-mail Contato", email) + clipboard.setPrimaryClip(clip) + Toast.makeText(context, "E-mail copiado: $email", Toast.LENGTH_SHORT).show() + } + ) + Spacer(modifier = Modifier.height(8.dp)) + } + + Spacer(modifier = Modifier.height(16.dp)) + + Button( + onClick = onRetryCheck, + enabled = !isRefreshing, + modifier = Modifier.fillMaxWidth(), + colors = ButtonDefaults.buttonColors( + containerColor = Color(0xFF0284C7) + ), + shape = RoundedCornerShape(10.dp) + ) { + if (isRefreshing) { + CircularProgressIndicator( + modifier = Modifier.size(18.dp), + color = Color.White, + strokeWidth = 2.dp + ) + Spacer(modifier = Modifier.width(8.dp)) + Text(text = "Consultando Planilha...", fontSize = 14.sp, fontWeight = FontWeight.Medium) + } else { + Icon( + imageVector = Icons.Default.Refresh, + contentDescription = null, + modifier = Modifier.size(18.dp) + ) + Spacer(modifier = Modifier.width(8.dp)) + Text(text = "Verificar Novamente", fontSize = 14.sp, fontWeight = FontWeight.Medium) + } + } + } + } + } + } + } +} + +@Composable +private fun ContactRow( + contact: SecurityContact, + onSendEmail: (String) -> Unit, + onCopyEmail: (String) -> Unit +) { + Surface( + shape = RoundedCornerShape(10.dp), + color = Color(0xFFF9FAFB), + modifier = Modifier.fillMaxWidth() + ) { + Row( + modifier = Modifier + .fillMaxWidth() + .padding(horizontal = 12.dp, vertical = 8.dp), + verticalAlignment = Alignment.CenterVertically, + horizontalArrangement = Arrangement.SpaceBetween + ) { + Column(modifier = Modifier.weight(1f)) { + Text( + text = contact.role, + fontSize = 11.sp, + fontWeight = FontWeight.Bold, + color = Color(0xFF6B7280) + ) + Text( + text = contact.email, + fontSize = 13.sp, + fontWeight = FontWeight.Medium, + color = Color(0xFF111827) + ) + } + + Row { + IconButton( + onClick = { onSendEmail(contact.email) }, + modifier = Modifier.size(32.dp) + ) { + Icon( + imageVector = Icons.Default.Email, + contentDescription = "Enviar E-mail", + tint = Color(0xFF0284C7), + modifier = Modifier.size(18.dp) + ) + } + + IconButton( + onClick = { onCopyEmail(contact.email) }, + modifier = Modifier.size(32.dp) + ) { + Icon( + imageVector = Icons.Default.ContentCopy, + contentDescription = "Copiar E-mail", + tint = Color(0xFF4B5563), + modifier = Modifier.size(18.dp) + ) + } + } + } + } +} diff --git a/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt b/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt index 343cdc0..9ac9b59 100644 --- a/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt +++ b/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt @@ -16,6 +16,7 @@ import com.example.data.repository.MaintenanceRepository import com.example.data.repository.SyncResult import com.example.data.model.AnalyticsState import com.example.data.model.parseDateOnly +import com.example.data.model.AppSecurityState import com.example.data.model.DateSimulationConfig import com.example.data.model.DateSimulationMode import kotlinx.coroutines.Dispatchers @@ -169,6 +170,15 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View private val _syncStatusMessage = MutableStateFlow(null) val syncStatusMessage = _syncStatusMessage.asStateFlow() + val appSecurityState: StateFlow = repository.appSecurityState.stateIn( + scope = viewModelScope, + started = SharingStarted.WhileSubscribed(5000), + initialValue = AppSecurityState.Allowed + ) + + private val _isRefreshingConfig = MutableStateFlow(false) + val isRefreshingConfig = _isRefreshingConfig.asStateFlow() + private val _importStatusMessage = MutableStateFlow(null) val importStatusMessage = _importStatusMessage.asStateFlow() @@ -530,10 +540,41 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View } } + fun checkSecurityConfigNow() { + if (_isRefreshingConfig.value) return + viewModelScope.launch { + _isRefreshingConfig.value = true + _syncStatusMessage.value = "Consultando aba 'config' da planilha online..." + try { + val remoteConfigs = repository.refreshConfigs() + if (remoteConfigs.isEmpty()) { + _syncStatusMessage.value = "Não foi possível conectar à planilha online para atualizar as configurações." + } else { + val security = repository.evaluateSecurityState(remoteConfigs) + if (security is AppSecurityState.Allowed) { + _syncStatusMessage.value = "Configurações atualizadas: Acesso liberado com sucesso!" + } else { + _syncStatusMessage.value = "Configurações atualizadas: Aplicativo permanece restrito." + } + } + } catch (e: Exception) { + _syncStatusMessage.value = "Erro ao buscar configurações remotas: ${e.localizedMessage}" + } finally { + _isRefreshingConfig.value = false + } + } + } + /** * Performs synchronized check. */ fun syncNow() { + val currentSecurity = appSecurityState.value + if (currentSecurity !is AppSecurityState.Allowed) { + checkSecurityConfigNow() + return + } + if (!_internetAvailable.value) { _syncStatusMessage.value = "Sincronização impossível: Sem conectividade de rede na área atual." return diff --git a/app/src/main/java/com/example/util/DeviceUtils.kt b/app/src/main/java/com/example/util/DeviceUtils.kt index 6496165..5a984d5 100644 --- a/app/src/main/java/com/example/util/DeviceUtils.kt +++ b/app/src/main/java/com/example/util/DeviceUtils.kt @@ -46,7 +46,7 @@ object DeviceUtils { fun getAppVersion(context: Context): String { return try { val packageInfo = context.packageManager.getPackageInfo(context.packageName, 0) - val versionName = packageInfo.versionName ?: "1.1.0" + val versionName = packageInfo.versionName ?: "1.2.0" @Suppress("DEPRECATION") val versionCode = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) { packageInfo.longVersionCode @@ -55,7 +55,7 @@ object DeviceUtils { } "$versionName (v$versionCode)" } catch (e: Exception) { - "1.1.0" + "1.2.0" } } } diff --git a/app/src/main/java/com/example/util/VersionUtils.kt b/app/src/main/java/com/example/util/VersionUtils.kt new file mode 100644 index 0000000..a18dc40 --- /dev/null +++ b/app/src/main/java/com/example/util/VersionUtils.kt @@ -0,0 +1,45 @@ +package com.example.util + +object VersionUtils { + + /** + * Sanitizes a version string by stripping any parenthetical build code suffix (e.g., "1.1.0 (v2)" -> "1.1.0"). + */ + fun sanitizeVersionString(rawVersion: String): String { + return rawVersion.trim().split(" ")[0].trim() + } + + /** + * Compares two semantic version strings (e.g., "1.1.0" vs "1.2.0"). + * Returns: + * - negative integer if v1 < v2 + * - zero if v1 == v2 + * - positive integer if v1 > v2 + */ + fun compareVersions(v1: String, v2: String): Int { + val cleanV1 = sanitizeVersionString(v1) + val cleanV2 = sanitizeVersionString(v2) + + val parts1 = cleanV1.split(".").mapNotNull { it.toIntOrNull() } + val parts2 = cleanV2.split(".").mapNotNull { it.toIntOrNull() } + + val maxLength = maxOf(parts1.size, parts2.size) + + for (i in 0 until maxLength) { + val num1 = parts1.getOrElse(i) { 0 } + val num2 = parts2.getOrElse(i) { 0 } + if (num1 != num2) { + return num1.compareTo(num2) + } + } + return 0 + } + + /** + * Checks if currentVersion is strictly lower than minVersion. + */ + fun isVersionLower(currentVersion: String, minVersion: String): Boolean { + if (minVersion.isBlank()) return false + return compareVersions(currentVersion, minVersion) < 0 + } +} diff --git a/app/src/test/java/com/example/AppSecurityTest.kt b/app/src/test/java/com/example/AppSecurityTest.kt new file mode 100644 index 0000000..e2cf028 --- /dev/null +++ b/app/src/test/java/com/example/AppSecurityTest.kt @@ -0,0 +1,83 @@ +package com.example + +import com.example.data.model.AppConfig +import com.example.data.model.AppSecurityState +import com.example.util.VersionUtils +import org.junit.Assert.assertEquals +import org.junit.Assert.assertTrue +import org.junit.Test + +class AppSecurityTest { + + private fun evaluateSecurity(configs: List, currentVersion: String): AppSecurityState { + val pararAcesso = configs.find { it.key.equals("PararAcessoApp", ignoreCase = true) }?.value?.trim() ?: "0" + if (pararAcesso == "1") { + return AppSecurityState.BlockedByMaintenance() + } + + val minVersion = configs.find { it.key.equals("VersaoMinimaApp", ignoreCase = true) }?.value?.trim() ?: "" + if (minVersion.isNotBlank()) { + if (VersionUtils.isVersionLower(currentVersion, minVersion)) { + return AppSecurityState.BlockedByVersion( + minVersion = minVersion, + currentVersion = VersionUtils.sanitizeVersionString(currentVersion) + ) + } + } + + return AppSecurityState.Allowed + } + + @Test + fun testDefaultStateAllowed() { + val configs = emptyList() + val state = evaluateSecurity(configs, "1.1.0") + assertTrue(state is AppSecurityState.Allowed) + } + + @Test + fun testPararAcessoAppBlocksAccess() { + val configs = listOf( + AppConfig("PararAcessoApp", "1", "Trava o acesso ao app"), + AppConfig("VersaoMinimaApp", "1.0.0", "Versão mínima") + ) + val state = evaluateSecurity(configs, "1.1.0") + assertTrue(state is AppSecurityState.BlockedByMaintenance) + val blocked = state as AppSecurityState.BlockedByMaintenance + assertEquals("App fora de operação, entrar em contato com o responsável e o desenvolvedor", blocked.message) + } + + @Test + fun testVersaoMinimaAppBlocksLowerVersion() { + val configs = listOf( + AppConfig("PararAcessoApp", "0", "Acesso permitido"), + AppConfig("VersaoMinimaApp", "2.0.0", "Versão mínima") + ) + val state = evaluateSecurity(configs, "1.1.0 (v2)") + assertTrue(state is AppSecurityState.BlockedByVersion) + val blocked = state as AppSecurityState.BlockedByVersion + assertEquals("2.0.0", blocked.minVersion) + assertEquals("1.1.0", blocked.currentVersion) + assertEquals("Versão do app incompativel, você deve atualizar o app para continuar usando, procure o responsável e o desenvolvedor", blocked.message) + } + + @Test + fun testVersaoMinimaAppAllowsCompatibleVersion() { + val configs = listOf( + AppConfig("PararAcessoApp", "0", "Acesso permitido"), + AppConfig("VersaoMinimaApp", "1.0.0", "Versão mínima") + ) + val state = evaluateSecurity(configs, "1.1.0") + assertTrue(state is AppSecurityState.Allowed) + } + + @Test + fun testPararAcessoHasPriorityOverVersionMismatch() { + val configs = listOf( + AppConfig("PararAcessoApp", "1", "Trava o acesso"), + AppConfig("VersaoMinimaApp", "9.9.9", "Versão mínima") + ) + val state = evaluateSecurity(configs, "1.1.0") + assertTrue(state is AppSecurityState.BlockedByMaintenance) + } +} diff --git a/app/src/test/java/com/example/util/VersionUtilsTest.kt b/app/src/test/java/com/example/util/VersionUtilsTest.kt new file mode 100644 index 0000000..d71c4a9 --- /dev/null +++ b/app/src/test/java/com/example/util/VersionUtilsTest.kt @@ -0,0 +1,45 @@ +package com.example.util + +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertTrue +import org.junit.Test + +class VersionUtilsTest { + + @Test + fun testSanitizeVersionString() { + assertEquals("1.1.0", VersionUtils.sanitizeVersionString("1.1.0 (v2)")) + assertEquals("2.0.1", VersionUtils.sanitizeVersionString(" 2.0.1 ")) + assertEquals("1.0.0", VersionUtils.sanitizeVersionString("1.0.0")) + } + + @Test + fun testCompareVersionsEqual() { + assertEquals(0, VersionUtils.compareVersions("1.0.0", "1.0.0")) + assertEquals(0, VersionUtils.compareVersions("1.1.0 (v2)", "1.1.0")) + } + + @Test + fun testCompareVersionsLower() { + assertTrue(VersionUtils.compareVersions("1.0.0", "1.1.0") < 0) + assertTrue(VersionUtils.compareVersions("1.0.9", "1.1.0") < 0) + assertTrue(VersionUtils.compareVersions("1.1.0", "1.2.0") < 0) + assertTrue(VersionUtils.compareVersions("1.1.0 (v2)", "1.2.0") < 0) + } + + @Test + fun testCompareVersionsGreater() { + assertTrue(VersionUtils.compareVersions("1.2.0", "1.1.0") > 0) + assertTrue(VersionUtils.compareVersions("2.0.0", "1.9.9") > 0) + } + + @Test + fun testIsVersionLower() { + assertTrue(VersionUtils.isVersionLower("1.1.0", "1.2.0")) + assertTrue(VersionUtils.isVersionLower("1.1.0 (v2)", "2.0.0")) + assertFalse(VersionUtils.isVersionLower("1.2.0", "1.1.0")) + assertFalse(VersionUtils.isVersionLower("1.1.0", "1.1.0")) + assertFalse(VersionUtils.isVersionLower("1.1.0", "")) + } +} diff --git a/documentacao/arquitetura/arquitetura_do_sistema.md b/documentacao/arquitetura/arquitetura_do_sistema.md index de5cfbb..16f0bf4 100644 --- a/documentacao/arquitetura/arquitetura_do_sistema.md +++ b/documentacao/arquitetura/arquitetura_do_sistema.md @@ -172,12 +172,12 @@ Gerencia o nível de acesso e permissões das contas de usuário autenticadas no | `lastUpdated` | `Long` | - | Timestamp da atualização de acesso. | ### 3.7. Entidade: `AppConfig` (Tabela: `app_config`) -Armazena configurações globais, links úteis e versão da base de dados (`database_epoch`) lidos da aba `config` da planilha online Google Sheets. +Armazena configurações globais, links úteis, versão da base de dados (`database_epoch`) e chaves de trava de segurança (`VersaoMinimaApp` e `PararAcessoApp`) lidos da aba `config` da planilha online Google Sheets. | Campo | Tipo | Chave | Descrição | | :--- | :--- | :--- | :--- | -| `key` | `String` | Primária | Identificador único da chave (ex: `Link1`, `DescricaoLink1`, `database_epoch`). | -| `value` | `String` | - | Valor da chave de configuração (ex: URL ou texto). | +| `key` | `String` | Primária | Identificador único da chave (ex: `Link1`, `DescricaoLink1`, `database_epoch`, `VersaoMinimaApp`, `PararAcessoApp`). | +| `value` | `String` | - | Valor da chave de configuração (ex: URL, versão mínima semântica ou flag de bloqueio `0`/`1`). | | `description` | `String?` | - | Descrição complementar da chave de configuração. | --- diff --git a/documentacao/fluxo_de_dados_e_sincronizacao.md b/documentacao/fluxo_de_dados_e_sincronizacao.md index 475b40b..243ba5e 100644 --- a/documentacao/fluxo_de_dados_e_sincronizacao.md +++ b/documentacao/fluxo_de_dados_e_sincronizacao.md @@ -151,8 +151,8 @@ Armazena as configurações dinâmicas e links sincronizados da aba `config` da | Campo | Tipo | Chave | Descrição / Regras | | :--- | :--- | :--- | :--- | -| **`key`** | `String` | Primária | Chave de configuração (ex: `Link1`, `DescricaoLink1`, `Link4`, `DescricaoLink4`, `database_epoch`). | -| **`value`** | `String` | - | Valor associado à chave (ex: URL ou versão). | +| **`key`** | `String` | Primária | Chave de configuração (ex: `Link1`, `DescricaoLink1`, `Link4`, `DescricaoLink4`, `database_epoch`, `VersaoMinimaApp`, `PararAcessoApp`). | +| **`value`** | `String` | - | Valor associado à chave (ex: URL, versão mínima ou flag `0`/`1`). | | **`description`** | `String?` | - | Descrição informativa da chave lida da coluna C (`descricao`). | > **Regra do 4º Link Condicional e Responsáveis**: @@ -160,6 +160,11 @@ Armazena as configurações dinâmicas e links sincronizados da aba `config` da > - O **4º link** (`Link4` e `DescricaoLink4`) é exibido **apenas se a chave e seu valor forem encontrados** na planilha online. Caso ausente ou em branco, permanece oculto. > - A Tela de Informações exibe a mensagem de status `"Sincronizado com o BD online"` e inclui um card fixo de **Responsáveis pelo Aplicativo** (Desenvolvedor: `cesarjhony+dev@gmail.com` e Responsável: `gabrielpizzinatto123@gmail.com`). +> **Regras de Trava de Segurança e Bloqueio (`VersaoMinimaApp` e `PararAcessoApp`)**: +> - `VersaoMinimaApp` (ex: `1.0.0`): Se a versão do aplicativo for estritamente inferior ao valor desta chave, o app exibe uma tela de bloqueio não minimizável (Full-Screen Overlay Modal) com a mensagem: *"Versão do app incompativel, você deve atualizar o app para continuar usando, procure o responsável e o desenvolvedor"*. +> - `PararAcessoApp` (ex: `0` = liberado, `1` = bloqueado): Se esta chave for `1`, o app exibe uma tela de bloqueio não minimizável com a mensagem: *"App fora de operação, entrar em contato com o responsável e o desenvolvedor"*. +> - Ambas as travas exibem os e-mails dos responsáveis com botões de ação para abrir o cliente de e-mail ou copiar o endereço, e **bloqueiam qualquer tentativa de sincronização ou leitura de dados**. + --- ## 3. Fluxo Completo de Salvamento de Dados