diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..0b9a5b0 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,36 @@ +# 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.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`. diff --git a/README.md b/README.md index fbfb259..8789f33 100644 --- a/README.md +++ b/README.md @@ -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`. - 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`). + - **[Arquitetura do Sistema](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/arquitetura/arquitetura_do_sistema.md)**: - Diagramas de arquitetura MVVM + Repository Pattern. - Mapeamento de componentes Compose, ViewModel e Room DAO. diff --git a/app/build.gradle.kts b/app/build.gradle.kts index 720a57a..88ce549 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 = 1 - versionName = "1.0" + versionCode = 2 + versionName = "1.1.0" testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" } diff --git a/app/src/main/java/com/example/ui/screens/ImportantInfoScreen.kt b/app/src/main/java/com/example/ui/screens/ImportantInfoScreen.kt index 7cd92a7..b876bba 100644 --- a/app/src/main/java/com/example/ui/screens/ImportantInfoScreen.kt +++ b/app/src/main/java/com/example/ui/screens/ImportantInfoScreen.kt @@ -12,10 +12,14 @@ import androidx.compose.foundation.shape.CircleShape import androidx.compose.foundation.shape.RoundedCornerShape import androidx.compose.material.icons.Icons 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.Email 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.OpenInNew +import androidx.compose.material.icons.filled.Person import androidx.compose.material.icons.filled.Refresh import androidx.compose.material.icons.filled.Security import androidx.compose.material3.* @@ -156,7 +160,7 @@ fun ImportantInfoScreen( ) Spacer(modifier = Modifier.height(2.dp)) 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, color = if (isNetworkConnected) BrandGreen else Color(0xFFD97706) ) @@ -173,7 +177,7 @@ fun ImportantInfoScreen( modifier = Modifier.padding(start = 4.dp, bottom = 8.dp) ) - // Links List + // Links List + Responsáveis LazyColumn( verticalArrangement = Arrangement.spacedBy(12.dp), modifier = Modifier.fillMaxWidth() @@ -184,6 +188,28 @@ fun ImportantInfoScreen( 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() + } + } + ) + } } } } @@ -199,6 +225,7 @@ fun ImportantLinkCard( "1" -> Icons.Default.Security to Color(0xFF0284C7) "2" -> Icons.Default.Lock to Color(0xFF7C3AED) "3" -> Icons.Default.Description to Color(0xFF059669) + "4" -> Icons.Default.Link to Color(0xFFEA580C) else -> Icons.Default.OpenInNew to BrandGreen } @@ -287,3 +314,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) + ) + } +} + diff --git a/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt b/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt index 3c8da4a..36d83ad 100644 --- a/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt +++ b/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt @@ -1303,30 +1303,49 @@ fun FullscreenPhotoViewerDialog( IconButton( onClick = { try { - if (photoPath.startsWith("/")) { - val file = java.io.File(photoPath) - if (file.exists()) { - val uri = androidx.core.content.FileProvider.getUriForFile( - context, - "${context.packageName}.fileprovider", - file - ) - val shareIntent = android.content.Intent(android.content.Intent.ACTION_SEND).apply { - type = "image/jpeg" - putExtra(android.content.Intent.EXTRA_STREAM, uri) - addFlags(android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION) - } - context.startActivity(android.content.Intent.createChooser(shareIntent, "Compartilhar Foto OS")) - } else { - Toast.makeText(context, "Arquivo local não encontrado", Toast.LENGTH_SHORT).show() + val resolvedModel = resolvePhotoModel(photoPath, context) + var targetFile: java.io.File? = null + + 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 } - } else { + } + + if (targetFile != null && targetFile.exists()) { + val uri = androidx.core.content.FileProvider.getUriForFile( + context, + "${context.packageName}.fileprovider", + targetFile + ) + val shareIntent = android.content.Intent(android.content.Intent.ACTION_SEND).apply { + type = "image/jpeg" + putExtra(android.content.Intent.EXTRA_STREAM, uri) + addFlags(android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION) + } + context.startActivity(android.content.Intent.createChooser(shareIntent, "Compartilhar Foto OS")) + } else if (resolvedModel.startsWith("http://") || resolvedModel.startsWith("https://")) { val shareIntent = android.content.Intent(android.content.Intent.ACTION_SEND).apply { type = "text/plain" 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")) + } else { + Toast.makeText(context, "Arquivo da foto não encontrado localmente", Toast.LENGTH_SHORT).show() } } catch (e: Exception) { Toast.makeText(context, "Erro ao compartilhar: ${e.message}", Toast.LENGTH_SHORT).show() 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 8912b51..343cdc0 100644 --- a/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt +++ b/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt @@ -83,6 +83,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 } diff --git a/app/src/main/java/com/example/util/DeviceUtils.kt b/app/src/main/java/com/example/util/DeviceUtils.kt index c2865ac..6496165 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.0.0" + val versionName = packageInfo.versionName ?: "1.1.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.0.0" + "1.1.0" } } } diff --git a/app/src/test/java/com/example/AppConfigTest.kt b/app/src/test/java/com/example/AppConfigTest.kt index be40727..fe88ce4 100644 --- a/app/src/test/java/com/example/AppConfigTest.kt +++ b/app/src/test/java/com/example/AppConfigTest.kt @@ -35,4 +35,45 @@ class AppConfigTest { assertEquals("https://forms.office.com/test", link.url) 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) + } } + diff --git a/app/src/test/java/com/example/util/DeviceUtilsTest.kt b/app/src/test/java/com/example/util/DeviceUtilsTest.kt index 2b875af..978d885 100644 --- a/app/src/test/java/com/example/util/DeviceUtilsTest.kt +++ b/app/src/test/java/com/example/util/DeviceUtilsTest.kt @@ -54,7 +54,7 @@ class DeviceUtilsTest { email = "teste@empresa.com", nomeUsuario = "Usuario Teste", versaoAndroid = "Android 14 (API 34)", - versaoApp = "1.0.0 (v1)", + versaoApp = "1.1.0 (v2)", ultimoAcesso = "2026-08-06 12:00:00", statusSincronizacao = "Sucesso" ) @@ -63,7 +63,7 @@ class DeviceUtilsTest { assertEquals("teste@empresa.com", info.email) assertEquals("Usuario Teste", info.nomeUsuario) 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("Sucesso", info.statusSincronizacao) } diff --git a/documentacao/fluxo_de_dados_e_sincronizacao.md b/documentacao/fluxo_de_dados_e_sincronizacao.md index 52da7fc..475b40b 100644 --- a/documentacao/fluxo_de_dados_e_sincronizacao.md +++ b/documentacao/fluxo_de_dados_e_sincronizacao.md @@ -146,15 +146,20 @@ Armazena o nível de permissão associado aos e-mails cadastrados. --- -### 2.7. Tabela: `app_config` (Configurações e Links Úteis) -Armazena as configurações dinâmicas e links sincronizados da aba `config` da planilha online Google Sheets. +### 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 exibidos na Tela de Informações Importantes (`ImportantInfoScreen.kt`). | 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`). | | **`value`** | `String` | - | Valor associado à chave (ex: URL ou versão). | | **`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`). + --- ## 3. Fluxo Completo de Salvamento de Dados