Compare commits

..

5 Commits

20 changed files with 1240 additions and 37 deletions

View File

@@ -7,3 +7,12 @@
## Atualização Pós-Modificação ## Atualização Pós-Modificação
- **Manutenção da Documentação**: Sempre que forem feitas modificações importantes no código (ex.: novas funcionalidades, refatoração de arquitetura, novos fluxos de sincronização, alterações em modelos de dados ou Room DAO/Database, adição de configurações), a IA deve obrigatoriamente atualizar os documentos correspondentes no diretório [`documentacao/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao) ou no [`README.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/README.md). - **Manutenção da Documentação**: Sempre que forem feitas modificações importantes no código (ex.: novas funcionalidades, refatoração de arquitetura, novos fluxos de sincronização, alterações em modelos de dados ou Room DAO/Database, adição de configurações), a IA deve obrigatoriamente atualizar os documentos correspondentes no diretório [`documentacao/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao) ou no [`README.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/README.md).
- **Sincronia Código x Docs**: A documentação deve refletir com exatidão as mudanças realizadas para evitar inconsistências e garantir a evolução contínua do projeto. - **Sincronia Código x Docs**: A documentação deve refletir com exatidão as mudanças realizadas para evitar inconsistências e garantir a evolução contínua do projeto.
## Controle de Versionamento Obrigatório e Atualização do Changelog
- **Incremento de Versão e Registros no Changelog**: Sempre que for feita qualquer modificação no código-fonte, correções de bugs, refatoração ou adição de novas funcionalidades no software, a IA deve **obrigatoriamente incrementar a versão do aplicativo** e atualizar o histórico no arquivo [`CHANGELOG.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/CHANGELOG.md).
- **Lista de Arquivos Obrigatórios a Serem Alterados**:
1. [`app/build.gradle.kts`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/build.gradle.kts): Incrementar `versionCode` (ex.: de `2` para `3`) e atualizar `versionName` seguindo o Semantic Versioning (ex.: `1.1.0` -> `1.1.1` para correções/patches ou `1.2.0` para novas funcionalidades).
2. [`CHANGELOG.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/CHANGELOG.md): Criar o bloco da nova versão com data no formato `## [X.Y.Z] - YYYY-MM-DD` e descrever detalhadamente todas as mudanças nas subseções apropriadas (`### Adicionado`, `### Corrigido`, `### Alterado`, `### Removido`).
3. [`app/src/main/java/com/example/util/DeviceUtils.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/util/DeviceUtils.kt): Atualizar as strings padrão de fallback de versão dentro do método `getAppVersion`.
4. [`README.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/README.md): Atualizar o número da Versão Atual na lista de documentação técnica do projeto.

80
CHANGELOG.md Normal file
View File

@@ -0,0 +1,80 @@
# Changelog
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/),
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`).
---
## [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
- **4º Link Condicional na Tela de Informações**: Suporte dinâmico para leitura e exibição das chaves `Link4` e `DescricaoLink4` da aba `config` da planilha online. O 4º link é exibido **apenas se a chave e seu valor forem encontrados na planilha**, permanecendo oculto caso contrário.
- **Seção de Responsáveis pelo Aplicativo**: Adicionada uma nova seção visual na Tela de Informações Importantes exibindo os contatos principais com ação interativa para envio de e-mail:
- **Desenvolvedor**: `cesarjhony+dev@gmail.com`
- **Responsável**: `gabrielpizzinatto123@gmail.com`
- **Testes Unitários**: Adicionada cobertura de testes automatizados para validação da inclusão/ocultação do 4º link (`AppConfigTest.kt`).
### Corrigido
- **Compartilhamento de Fotos**: Correção no visualizador de foto em tela cheia (`FullscreenPhotoViewerDialog`). O aplicativo agora resolve o arquivo físico local `.jpg` armazenado em `filesDir/os_photos/` e gera uma URI segura via `FileProvider` (`type = "image/jpeg"`), corrigindo a falha onde o sistema enviava apenas o texto da rota parcial.
### Alterado
- **Texto de Status da Tela de Informações**: Atualizada a mensagem de status de conectividade de `"Sincronizado com a planilha online (Aba config)"` para `"Sincronizado com o BD online"`.
- **Versão do Aplicativo**: Incrementada a versão do software para `1.1.0` (com `versionCode = 2`).
---
## [1.0.0] - 2026-08-01
### Adicionado
- **Versão Inicial Estável**: Lançamento inicial da plataforma de Gestão de Manutenção de Parada (Android).
- **Arquitetura Offline-First**: Arquitetura MVVM + Repository Pattern sobre banco de dados local Room SQLite com 7 tabelas principais (`maintenance_activities`, `os_findings`, `os_update_history`, `app_logs`, `sync_conflict_logs`, `user_access`, `app_config`).
- **Sincronização Bidirecional com Google Sheets**: Integração com as abas `project`, `history`, `achados`, `config` e `usage_history`.
- **Integração com Firebase Storage**: Compactação automática de fotos (<= 500KB) e download de mídias sob demanda (*On-Demand Loading*) para múltiplos dispositivos.
- **Painel Analítico e KPIs**: Indicadores globais de progresso industrial, filtros modulares (Setor, Equipe, Status, Data, Recurso) e busca dinâmica.
- **Segurança e Auditoria**: Autenticação com Google Sign-In, controle de permissões por e-mail e rastreamento de acessos por dispositivo na aba `usage_history`.

View File

@@ -15,6 +15,9 @@ Aplicativo Android **offline-first** desenvolvido em Kotlin e Jetpack Compose pa
- Rastreamento em tempo real do último acesso por dispositivo, e-mail de Google Sign-In e versão do sistema na aba `usage_history`. - Rastreamento em tempo real do último acesso por dispositivo, e-mail de Google Sign-In e versão do sistema na aba `usage_history`.
- 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)**:
- 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.
- Mapeamento de componentes Compose, ViewModel e Room DAO. - Mapeamento de componentes Compose, ViewModel e Room DAO.

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 = 1 versionCode = 5
versionName = "1.0" versionName = "1.4.0"
testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
} }

View File

@@ -32,6 +32,8 @@ import com.example.ui.screens.SettingsScreen
import com.example.ui.theme.BrandGreen import com.example.ui.theme.BrandGreen
import com.example.ui.theme.BrandLightGreen import com.example.ui.theme.BrandLightGreen
import com.example.ui.theme.MyApplicationTheme 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.MaintenanceViewModel
import com.example.ui.viewmodel.MaintenanceViewModelFactory import com.example.ui.viewmodel.MaintenanceViewModelFactory
@@ -53,6 +55,15 @@ class MainActivity : ComponentActivity() {
val navBackStackEntry by navController.currentBackStackEntryAsState() val navBackStackEntry by navController.currentBackStackEntryAsState()
val currentRoute = navBackStackEntry?.destination?.route 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( Scaffold(
bottomBar = { bottomBar = {
NavigationBar( NavigationBar(

View File

@@ -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<SecurityContact> = 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<SecurityContact> = DEFAULT_CONTACTS
) : AppSecurityState()
companion object {
val DEFAULT_CONTACTS = listOf(
SecurityContact("Desenvolvedor", "cesarjhony+dev@gmail.com"),
SecurityContact("Responsável", "gabrielpizzinatto123@gmail.com")
)
}
}

View File

@@ -9,10 +9,14 @@ import com.example.data.model.OSUpdateHistory
import com.example.data.model.GoogleUser import com.example.data.model.GoogleUser
import com.example.data.model.SyncConflictLog import com.example.data.model.SyncConflictLog
import com.example.data.model.AppConfig import com.example.data.model.AppConfig
import com.example.data.model.AppSecurityState
import com.example.data.model.UserAccess import com.example.data.model.UserAccess
import com.example.util.DeviceUtils
import com.example.util.VersionUtils
import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.delay import kotlinx.coroutines.delay
import kotlinx.coroutines.flow.Flow import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.map
import kotlinx.coroutines.withContext import kotlinx.coroutines.withContext
import java.io.BufferedReader import java.io.BufferedReader
import java.io.InputStreamReader import java.io.InputStreamReader
@@ -35,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()
@@ -42,6 +55,30 @@ class MaintenanceRepository(
val allConfigs: Flow<List<AppConfig>> = dao.getAllConfigsFlow() val allConfigs: Flow<List<AppConfig>> = dao.getAllConfigsFlow()
val appSecurityState: Flow<AppSecurityState> = allConfigs.map { configs ->
evaluateSecurityState(configs)
}
fun evaluateSecurityState(configs: List<AppConfig>): 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<List<OSUpdateHistory>> = dao.getAllHistoryFlow() val allHistory: Flow<List<OSUpdateHistory>> = dao.getAllHistoryFlow()
fun getActivityByOs(numeroOs: String): Flow<MaintenanceActivity?> = dao.getActivityByOs(numeroOs) fun getActivityByOs(numeroOs: String): Flow<MaintenanceActivity?> = dao.getActivityByOs(numeroOs)
@@ -444,6 +481,19 @@ class MaintenanceRepository(
try { try {
android.util.Log.d("MaintenanceRepository", "Starting Google Sheets synchronization...") 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 // Validate system date only when online
val isOnline = isCurrentlyConnected() val isOnline = isCurrentlyConnected()
val timeValidation = timeGuardManager.validateSystemTime(isOnline) val timeValidation = timeGuardManager.validateSystemTime(isOnline)
@@ -477,6 +527,16 @@ class MaintenanceRepository(
if (remoteConfigs.isNotEmpty()) { if (remoteConfigs.isNotEmpty()) {
dao.insertConfigs(remoteConfigs) dao.insertConfigs(remoteConfigs)
android.util.Log.d("MaintenanceRepository", "Sincronizadas ${remoteConfigs.size} configurações da planilha.") 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) { } catch (e: Exception) {
android.util.Log.e("MaintenanceRepository", "Falha ao carregar configurações da planilha", e) android.util.Log.e("MaintenanceRepository", "Falha ao carregar configurações da planilha", e)
@@ -1106,7 +1166,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("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("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("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) dao.insertConfigs(defaults)
} }

View File

@@ -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<SecurityContact>
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)
)
}
}
}
}
}

View File

@@ -12,10 +12,14 @@ import androidx.compose.foundation.shape.CircleShape
import androidx.compose.foundation.shape.RoundedCornerShape import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material.icons.Icons import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.ArrowForward import androidx.compose.material.icons.filled.ArrowForward
import androidx.compose.material.icons.filled.Code
import androidx.compose.material.icons.filled.Description import androidx.compose.material.icons.filled.Description
import androidx.compose.material.icons.filled.Email
import androidx.compose.material.icons.filled.Info import androidx.compose.material.icons.filled.Info
import androidx.compose.material.icons.filled.Link
import androidx.compose.material.icons.filled.Lock import androidx.compose.material.icons.filled.Lock
import androidx.compose.material.icons.filled.OpenInNew import androidx.compose.material.icons.filled.OpenInNew
import androidx.compose.material.icons.filled.Person
import androidx.compose.material.icons.filled.Refresh import androidx.compose.material.icons.filled.Refresh
import androidx.compose.material.icons.filled.Security import androidx.compose.material.icons.filled.Security
import androidx.compose.material3.* import androidx.compose.material3.*
@@ -156,7 +160,7 @@ fun ImportantInfoScreen(
) )
Spacer(modifier = Modifier.height(2.dp)) Spacer(modifier = Modifier.height(2.dp))
Text( Text(
text = if (isNetworkConnected) "Sincronizado com a planilha online (Aba config)" else "Modo Offline (Links armazenados localmente)", text = if (isNetworkConnected) "Sincronizado com o BD online" else "Modo Offline (Links armazenados localmente)",
fontSize = 12.sp, fontSize = 12.sp,
color = if (isNetworkConnected) BrandGreen else Color(0xFFD97706) color = if (isNetworkConnected) BrandGreen else Color(0xFFD97706)
) )
@@ -173,7 +177,7 @@ fun ImportantInfoScreen(
modifier = Modifier.padding(start = 4.dp, bottom = 8.dp) modifier = Modifier.padding(start = 4.dp, bottom = 8.dp)
) )
// Links List // Links List + Responsáveis
LazyColumn( LazyColumn(
verticalArrangement = Arrangement.spacedBy(12.dp), verticalArrangement = Arrangement.spacedBy(12.dp),
modifier = Modifier.fillMaxWidth() modifier = Modifier.fillMaxWidth()
@@ -184,6 +188,44 @@ fun ImportantInfoScreen(
onOpenUrl = { openUrl(linkItem.url) } onOpenUrl = { openUrl(linkItem.url) }
) )
} }
item {
Spacer(modifier = Modifier.height(8.dp))
Text(
text = "RESPONSÁVEIS PELO APLICATIVO",
fontSize = 12.sp,
fontWeight = FontWeight.Bold,
color = Color.Gray,
modifier = Modifier.padding(start = 4.dp, bottom = 8.dp)
)
AppMaintainersCard(
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()
}
}
)
}
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))
}
} }
} }
} }
@@ -199,6 +241,7 @@ fun ImportantLinkCard(
"1" -> Icons.Default.Security to Color(0xFF0284C7) "1" -> Icons.Default.Security to Color(0xFF0284C7)
"2" -> Icons.Default.Lock to Color(0xFF7C3AED) "2" -> Icons.Default.Lock to Color(0xFF7C3AED)
"3" -> Icons.Default.Description to Color(0xFF059669) "3" -> Icons.Default.Description to Color(0xFF059669)
"4" -> Icons.Default.Link to Color(0xFFEA580C)
else -> Icons.Default.OpenInNew to BrandGreen else -> Icons.Default.OpenInNew to BrandGreen
} }
@@ -287,3 +330,102 @@ fun ImportantLinkCard(
} }
} }
} }
@Composable
fun AppMaintainersCard(
onSendEmail: (String) -> Unit,
modifier: Modifier = Modifier
) {
Card(
modifier = modifier.fillMaxWidth(),
shape = RoundedCornerShape(14.dp),
colors = CardDefaults.cardColors(containerColor = Color.White),
elevation = CardDefaults.cardElevation(defaultElevation = 2.dp)
) {
Column(
modifier = Modifier
.fillMaxWidth()
.padding(16.dp)
) {
MaintainerRow(
role = "Desenvolvedor",
email = "cesarjhony+dev@gmail.com",
icon = Icons.Default.Code,
badgeColor = Color(0xFF0284C7),
onSendEmail = onSendEmail
)
HorizontalDivider(
modifier = Modifier.padding(vertical = 12.dp),
color = LightGrey
)
MaintainerRow(
role = "Responsável",
email = "gabrielpizzinatto123@gmail.com",
icon = Icons.Default.Person,
badgeColor = BrandGreen,
onSendEmail = onSendEmail
)
}
}
}
@Composable
private fun MaintainerRow(
role: String,
email: String,
icon: ImageVector,
badgeColor: Color,
onSendEmail: (String) -> Unit
) {
Row(
modifier = Modifier
.fillMaxWidth()
.clickable { onSendEmail(email) },
verticalAlignment = Alignment.CenterVertically
) {
Box(
modifier = Modifier
.size(40.dp)
.clip(RoundedCornerShape(10.dp))
.background(badgeColor.copy(alpha = 0.1f)),
contentAlignment = Alignment.Center
) {
Icon(
imageVector = icon,
contentDescription = role,
tint = badgeColor,
modifier = Modifier.size(20.dp)
)
}
Spacer(modifier = Modifier.width(12.dp))
Column(modifier = Modifier.weight(1f)) {
Text(
text = role,
fontSize = 12.sp,
fontWeight = FontWeight.SemiBold,
color = Color.Gray
)
Spacer(modifier = Modifier.height(2.dp))
Text(
text = email,
fontSize = 14.sp,
fontWeight = FontWeight.Bold,
color = BrandBlack,
maxLines = 1,
overflow = TextOverflow.Ellipsis
)
}
Icon(
imageVector = Icons.Default.Email,
contentDescription = "Enviar E-mail",
tint = badgeColor,
modifier = Modifier.size(20.dp)
)
}
}

View File

@@ -1303,13 +1303,33 @@ fun FullscreenPhotoViewerDialog(
IconButton( IconButton(
onClick = { onClick = {
try { try {
if (photoPath.startsWith("/")) { val resolvedModel = resolvePhotoModel(photoPath, context)
val file = java.io.File(photoPath) var targetFile: java.io.File? = null
if (file.exists()) {
if (resolvedModel.startsWith("/")) {
val f = java.io.File(resolvedModel)
if (f.exists()) targetFile = f
}
if (targetFile == null && photoPath.startsWith("/")) {
val f = java.io.File(photoPath)
if (f.exists()) targetFile = f
}
if (targetFile == null) {
val cleanPathForName = photoPath.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true)
val fileName = cleanPathForName.substringAfterLast("/").substringAfterLast("\\")
.removeSuffix("_DELETED").removeSuffix(".jpg_DELETED").replace("_DELETED", "")
if (fileName.isNotBlank()) {
val photosDir = java.io.File(context.filesDir, "os_photos")
val cachedFile = java.io.File(photosDir, fileName)
if (cachedFile.exists()) targetFile = cachedFile
}
}
if (targetFile != null && targetFile.exists()) {
val uri = androidx.core.content.FileProvider.getUriForFile( val uri = androidx.core.content.FileProvider.getUriForFile(
context, context,
"${context.packageName}.fileprovider", "${context.packageName}.fileprovider",
file targetFile
) )
val shareIntent = android.content.Intent(android.content.Intent.ACTION_SEND).apply { val shareIntent = android.content.Intent(android.content.Intent.ACTION_SEND).apply {
type = "image/jpeg" type = "image/jpeg"
@@ -1317,16 +1337,15 @@ fun FullscreenPhotoViewerDialog(
addFlags(android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION) addFlags(android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION)
} }
context.startActivity(android.content.Intent.createChooser(shareIntent, "Compartilhar Foto OS")) context.startActivity(android.content.Intent.createChooser(shareIntent, "Compartilhar Foto OS"))
} else { } else if (resolvedModel.startsWith("http://") || resolvedModel.startsWith("https://")) {
Toast.makeText(context, "Arquivo local não encontrado", Toast.LENGTH_SHORT).show()
}
} else {
val shareIntent = android.content.Intent(android.content.Intent.ACTION_SEND).apply { val shareIntent = android.content.Intent(android.content.Intent.ACTION_SEND).apply {
type = "text/plain" type = "text/plain"
putExtra(android.content.Intent.EXTRA_SUBJECT, "Foto OS $osNumber") putExtra(android.content.Intent.EXTRA_SUBJECT, "Foto OS $osNumber")
putExtra(android.content.Intent.EXTRA_TEXT, photoPath) putExtra(android.content.Intent.EXTRA_TEXT, resolvedModel)
} }
context.startActivity(android.content.Intent.createChooser(shareIntent, "Compartilhar Link da Foto")) context.startActivity(android.content.Intent.createChooser(shareIntent, "Compartilhar Link da Foto"))
} else {
Toast.makeText(context, "Arquivo da foto não encontrado localmente", Toast.LENGTH_SHORT).show()
} }
} catch (e: Exception) { } catch (e: Exception) {
Toast.makeText(context, "Erro ao compartilhar: ${e.message}", Toast.LENGTH_SHORT).show() Toast.makeText(context, "Erro ao compartilhar: ${e.message}", Toast.LENGTH_SHORT).show()

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

@@ -16,6 +16,7 @@ import com.example.data.repository.MaintenanceRepository
import com.example.data.repository.SyncResult import com.example.data.repository.SyncResult
import com.example.data.model.AnalyticsState import com.example.data.model.AnalyticsState
import com.example.data.model.parseDateOnly import com.example.data.model.parseDateOnly
import com.example.data.model.AppSecurityState
import com.example.data.model.DateSimulationConfig import com.example.data.model.DateSimulationConfig
import com.example.data.model.DateSimulationMode import com.example.data.model.DateSimulationMode
import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.Dispatchers
@@ -83,6 +84,29 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View
) )
) )
} }
val link4Obj = configMap["Link4"]
val link4Url = link4Obj?.value?.trim()?.takeIf { it.isNotBlank() }
if (link4Obj != null && link4Url != null) {
val descObj = configMap["DescricaoLink4"]
val title = descObj?.value?.trim()?.takeIf { it.isNotBlank() }
?: descObj?.description?.trim()?.takeIf { it.isNotBlank() }
?: link4Obj.description?.trim()?.takeIf { it.isNotBlank() }
?: "Link 4"
val description = link4Obj.description?.trim()?.takeIf { it.isNotBlank() }
?: descObj?.description?.trim()?.takeIf { it.isNotBlank() }
result.add(
com.example.data.model.ImportantLink(
id = "4",
title = title,
url = link4Url,
description = description
)
)
}
return result return result
} }
@@ -146,6 +170,24 @@ 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(
scope = viewModelScope,
started = SharingStarted.WhileSubscribed(5000),
initialValue = AppSecurityState.Allowed
)
private val _isRefreshingConfig = MutableStateFlow(false)
val isRefreshingConfig = _isRefreshingConfig.asStateFlow()
private val _importStatusMessage = MutableStateFlow<String?>(null) private val _importStatusMessage = MutableStateFlow<String?>(null)
val importStatusMessage = _importStatusMessage.asStateFlow() val importStatusMessage = _importStatusMessage.asStateFlow()
@@ -446,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?) {
@@ -507,25 +552,63 @@ 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. * Performs synchronized check.
*/ */
fun syncNow() { fun syncNow() {
val currentSecurity = appSecurityState.value
if (currentSecurity !is AppSecurityState.Allowed) {
checkSecurityConfigNow()
repository.logAppLog("WARN", "SyncManager", "Sincronização manual impedida: aplicativo bloqueado por regras de segurança.")
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 }
@@ -536,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
} }
} }
@@ -821,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.0.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.0.0" "1.4.0"
} }
} }
} }

View File

@@ -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
}
}

View File

@@ -35,4 +35,45 @@ class AppConfigTest {
assertEquals("https://forms.office.com/test", link.url) assertEquals("https://forms.office.com/test", link.url)
assertEquals("Link para ser exibido na tela de informações", link.description) assertEquals("Link para ser exibido na tela de informações", link.description)
} }
@Test
fun testLink4ParsingLogic_whenPresent_includesFourthLink() {
val configs = listOf(
AppConfig("Link1", "https://example.com/1", "Desc 1"),
AppConfig("DescricaoLink1", "Título 1", null),
AppConfig("Link4", "https://example.com/4", "Link 4 Descrição"),
AppConfig("DescricaoLink4", "Manual do Usuário", null)
)
val configMap = configs.associateBy { it.key }
val link4Obj = configMap["Link4"]
val link4Url = link4Obj?.value?.trim()?.takeIf { it.isNotBlank() }
val descObj = configMap["DescricaoLink4"]
val title = descObj?.value?.trim()?.takeIf { it.isNotBlank() } ?: "Link 4"
assertNotNull(link4Url)
assertEquals("https://example.com/4", link4Url)
assertEquals("Manual do Usuário", title)
} }
@Test
fun testLink4ParsingLogic_whenAbsentOrBlank_hidesFourthLink() {
val configsWithoutLink4 = listOf(
AppConfig("Link1", "https://example.com/1", "Desc 1"),
AppConfig("DescricaoLink1", "Título 1", null)
)
val mapWithoutLink4 = configsWithoutLink4.associateBy { it.key }
val link4Obj1 = mapWithoutLink4["Link4"]
val link4Url1 = link4Obj1?.value?.trim()?.takeIf { it.isNotBlank() }
assertEquals(null, link4Url1)
val configsWithBlankLink4 = listOf(
AppConfig("Link4", " ", "Desc 4")
)
val mapWithBlankLink4 = configsWithBlankLink4.associateBy { it.key }
val link4Obj2 = mapWithBlankLink4["Link4"]
val link4Url2 = link4Obj2?.value?.trim()?.takeIf { it.isNotBlank() }
assertEquals(null, link4Url2)
}
}

View File

@@ -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<AppConfig>, 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<AppConfig>()
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)
}
}

View File

@@ -54,7 +54,7 @@ class DeviceUtilsTest {
email = "teste@empresa.com", email = "teste@empresa.com",
nomeUsuario = "Usuario Teste", nomeUsuario = "Usuario Teste",
versaoAndroid = "Android 14 (API 34)", versaoAndroid = "Android 14 (API 34)",
versaoApp = "1.0.0 (v1)", versaoApp = "1.1.0 (v2)",
ultimoAcesso = "2026-08-06 12:00:00", ultimoAcesso = "2026-08-06 12:00:00",
statusSincronizacao = "Sucesso" statusSincronizacao = "Sucesso"
) )
@@ -63,7 +63,7 @@ class DeviceUtilsTest {
assertEquals("teste@empresa.com", info.email) assertEquals("teste@empresa.com", info.email)
assertEquals("Usuario Teste", info.nomeUsuario) assertEquals("Usuario Teste", info.nomeUsuario)
assertEquals("Android 14 (API 34)", info.versaoAndroid) assertEquals("Android 14 (API 34)", info.versaoAndroid)
assertEquals("1.0.0 (v1)", info.versaoApp) assertEquals("1.1.0 (v2)", info.versaoApp)
assertEquals("2026-08-06 12:00:00", info.ultimoAcesso) assertEquals("2026-08-06 12:00:00", info.ultimoAcesso)
assertEquals("Sucesso", info.statusSincronizacao) assertEquals("Sucesso", info.statusSincronizacao)
} }

View File

@@ -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", ""))
}
}

View File

@@ -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. | | `lastUpdated` | `Long` | - | Timestamp da atualização de acesso. |
### 3.7. Entidade: `AppConfig` (Tabela: `app_config`) ### 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 | | Campo | Tipo | Chave | Descrição |
| :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- |
| `key` | `String` | Primária | Identificador único da chave (ex: `Link1`, `DescricaoLink1`, `database_epoch`). | | `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 ou texto). | | `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. | | `description` | `String?` | - | Descrição complementar da chave de configuração. |
--- ---

View File

@@ -146,15 +146,25 @@ Armazena o nível de permissão associado aos e-mails cadastrados.
--- ---
### 2.7. Tabela: `app_config` (Configurações e Links Úteis) ### 2.7. Tabela: `app_config` (Configurações, Links Úteis e Responsáveis)
Armazena as configurações dinâmicas e links sincronizados da aba `config` da planilha online Google Sheets. Armazena as configurações dinâmicas e links sincronizados da aba `config` da planilha online Google Sheets exibidos na Tela de Informações Importantes (`ImportantInfoScreen.kt`).
| Campo | Tipo | Chave | Descrição / Regras | | Campo | Tipo | Chave | Descrição / Regras |
| :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- |
| **`key`** | `String` | Primária | Chave de configuração (ex: `Link1`, `DescricaoLink1`, `database_epoch`). | | **`key`** | `String` | Primária | Chave de configuração (ex: `Link1`, `DescricaoLink1`, `Link4`, `DescricaoLink4`, `database_epoch`, `VersaoMinimaApp`, `PararAcessoApp`). |
| **`value`** | `String` | - | Valor associado à chave (ex: URL ou versão). | | **`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`). | | **`description`** | `String?` | - | Descrição informativa da chave lida da coluna C (`descricao`). |
> **Regra do 4º Link Condicional e Responsáveis**:
> - Links 1, 2 e 3 possuem valores padrão de fallback na interface.
> - 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 ## 3. Fluxo Completo de Salvamento de Dados
@@ -202,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)