Compare commits

...

13 Commits

Author SHA1 Message Date
Jhony Cesar
7e26b98824 feat: update version to 1.4.0 and display app version in ImportantInfo and Settings screens 2026-08-07 10:34:06 -04:00
Jhony Cesar
1ff582f60a feat: implement automatic background synchronization loop, diagnostic logging, and status card in Settings screen 2026-08-07 10:33:58 -04:00
Jhony Cesar
7a9a782513 feat: implement app security lock system with version validation and remote operation blocking 2026-08-07 09:36:02 -04:00
Jhony Cesar
2c97b34f0f docs: add mandatory versioning and changelog update requirements to AGENTS.md 2026-08-07 08:37:50 -04:00
Jhony Cesar
c0dfd700a0 feat: add maintainers section to info screen and improve photo sharing logic by enhancing file path resolution 2026-08-07 08:37:33 -04:00
Jhony Cesar
aaa5871292 feat: implement synchronization and UI display for application configuration links via new AppConfig entity 2026-08-06 17:04:20 -04:00
Jhony Cesar
8f557b0581 docs: add project guidelines and documentation maintenance requirements for AI agents 2026-08-06 16:34:22 -04:00
Jhony Cesar
4fbebd08de refactor: simplify epoch purge logic to always clear all synced history and findings upon database epoch update 2026-08-06 16:32:10 -04:00
Jhony Cesar
09bfc92e1c feat: implement remote database epoch sync to purge stale local data and add status tracking for synced history logs 2026-08-06 16:10:26 -04:00
Jhony Cesar
57dff9f819 chore: update application ID and configure Firebase for com.aistudio.gestaoparadaos.xvyzwt 2026-08-06 12:38:08 -04:00
Jhony Cesar
7759186234 feat: add device access logging to Google Sheets with device identification utilities 2026-08-06 12:25:26 -04:00
Jhony Cesar
3578697d60 docs: update project documentation to include detailed Room entities, sync flow, and README execution guide 2026-08-06 12:17:57 -04:00
Jhony Cesar
6345aac22e feat: normalize storage paths and update Firebase storage configuration for photos, several adjusts for correct the bug photos 2026-08-06 12:03:50 -04:00
32 changed files with 3149 additions and 243 deletions

18
.agents/AGENTS.md Normal file
View File

@@ -0,0 +1,18 @@
# Diretrizes do Projeto - Gestão de Manutenção
## Leitura Obrigatória da Documentação
- **Consulta Prévia**: Antes de planejar, pesquisar ou implementar qualquer alteração, a IA deve sempre consultar a documentação relevante contida no diretório [`documentacao/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao) (como [`arquitetura_do_sistema.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/arquitetura/arquitetura_do_sistema.md), [`fluxo_de_dados_e_sincronizacao.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/fluxo_de_dados_e_sincronizacao.md), [`recursos_simulados_e_truncados.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/recursos_simulados_e_truncados.md)) e no [`README.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/README.md).
- **Alinhamento Arquitetural**: Certifique-se de compreender os padrões arquiteturais offline-first, sincronização, modelos de dados e restrições descritas na documentação antes de propor ou alterar o código.
## 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).
- **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

@@ -1,21 +1,38 @@
<div align="center"> # Aplicativo de Gestão de Manutenção de Parada (Android)
<img width="1200" height="475" alt="GHBanner" src="https://ai.google.dev/static/site-assets/images/share-ais-513315318.png" />
</div>
# Run and deploy your AI Studio app Aplicativo Android **offline-first** desenvolvido em Kotlin e Jetpack Compose para gerenciamento, acompanhamento e auditoria de Ordens de Serviço (OS) em plantas industriais.
This contains everything you need to run your app locally. ---
View your app in AI Studio: https://ai.studio/apps/d5626d9c-db6d-4067-9ba1-e80d37ea164f ## 📚 Documentação Técnica do Projeto
## Run Locally - **[Documentação de Fluxo de Dados, Salvamento e Sincronização](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/fluxo_de_dados_e_sincronizacao.md)**:
- Estrutura completa das 7 tabelas do banco de dados local Room (`maintenance_activities`, `os_findings`, `os_update_history`, `app_logs`, `sync_conflict_logs`, `user_access`, `app_config`).
- Fluxo detalhado de salvamento de progresso e achados com tipo exclusivo `FOTO`.
- Processo de compactação (<= 500KB) e upload para Firebase Storage.
- Sincronização bidirecional com Google Sheets (abas `project`, `history`, `achados`, `config` e `usage_history`).
- Sincronização de links úteis da aba `config` para a Tela de Informações Importantes (posicionada à esquerda do Dashboard).
- 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.
**Prerequisites:** [Android Studio](https://developer.android.com/studio) - **[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)**:
- Diagramas de arquitetura MVVM + Repository Pattern.
- Mapeamento de componentes Compose, ViewModel e Room DAO.
- Algoritmo de reconciliação de dados e auditoria transacional.
1. Open Android Studio ---
2. Select **Open** and choose the directory containing this project
3. Allow Android Studio to fix any incompatibilities as it imports the project. ## 🚀 Como Executar o Projeto
4. Create a file named `.env` in the project directory and set `GEMINI_API_KEY` in that file to your Gemini API key (see `.env.example` for an example)
5. Remove this line from the app's `build.gradle.kts` file: `signingConfig = signingConfigs.getByName("debugConfig")` **Pré-requisitos:** [Android Studio](https://developer.android.com/studio) / JDK 17+
6. Run the app on an emulator or physical device
1. Abra o Android Studio.
2. Selecione **Open** e escolha a pasta deste projeto (`gestao_de_manutencao`).
3. Execute os testes unitários via linha de comando ou terminal do estúdio:
```bash
./gradle_9_3_1/gradle-9.3.1/bin/gradle test
```
4. Execute o aplicativo em um emulador ou dispositivo físico Android.

View File

@@ -14,11 +14,11 @@ android {
compileSdk { version = release(36) { minorApiLevel = 1 } } compileSdk { version = release(36) { minorApiLevel = 1 } }
defaultConfig { defaultConfig {
applicationId = "com.aistudio.cargillparadaos.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

@@ -41,6 +41,43 @@
] ]
} }
} }
},
{
"client_info": {
"mobilesdk_app_id": "1:461441632355:android:a6f984af1b42521aee5056",
"android_client_info": {
"package_name": "com.aistudio.gestaoparadaos.xvyzwt"
}
},
"oauth_client": [
{
"client_id": "461441632355-br45iqlv0epgagm3mnrkj8qgak0rgo2o.apps.googleusercontent.com",
"client_type": 1,
"android_info": {
"package_name": "com.aistudio.gestaoparadaos.xvyzwt",
"certificate_hash": "6274d8aa0709c0454af47340ae8f223b8a0fbd61"
}
},
{
"client_id": "461441632355-dc85s9u8dctltfbounegv020qn5aj49d.apps.googleusercontent.com",
"client_type": 3
}
],
"api_key": [
{
"current_key": "AIzaSyAB3uaasLqLgB-Ir5NvzUkVo6wSuQPQtTU"
}
],
"services": {
"appinvite_service": {
"other_platform_oauth_client": [
{
"client_id": "461441632355-dc85s9u8dctltfbounegv020qn5aj49d.apps.googleusercontent.com",
"client_type": 3
}
]
}
}
} }
], ],
"configuration_version": "1" "configuration_version": "1"

View File

@@ -9,6 +9,7 @@ import androidx.compose.foundation.layout.padding
import androidx.compose.material.icons.Icons import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.Assignment import androidx.compose.material.icons.filled.Assignment
import androidx.compose.material.icons.filled.Dashboard import androidx.compose.material.icons.filled.Dashboard
import androidx.compose.material.icons.filled.Info
import androidx.compose.material.icons.filled.Settings import androidx.compose.material.icons.filled.Settings
import androidx.compose.material3.* import androidx.compose.material3.*
import androidx.compose.runtime.getValue import androidx.compose.runtime.getValue
@@ -25,11 +26,14 @@ import androidx.navigation.compose.rememberNavController
import com.example.data.local.AppDatabase import com.example.data.local.AppDatabase
import com.example.data.repository.MaintenanceRepository import com.example.data.repository.MaintenanceRepository
import com.example.ui.screens.AnalyticsScreen import com.example.ui.screens.AnalyticsScreen
import com.example.ui.screens.ImportantInfoScreen
import com.example.ui.screens.MaintenanceDashboardScreen import com.example.ui.screens.MaintenanceDashboardScreen
import com.example.ui.screens.SettingsScreen 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
@@ -51,12 +55,44 @@ 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(
containerColor = Color.White, containerColor = Color.White,
modifier = Modifier.shadow(8.dp) modifier = Modifier.shadow(8.dp)
) { ) {
// Tab 0: Informações Importantes (Página de Links)
NavigationBarItem(
selected = currentRoute == "info",
onClick = {
if (currentRoute != "info") {
navController.navigate("info") {
popUpTo(navController.graph.startDestinationId) { saveState = true }
launchSingleTop = true
restoreState = true
}
}
},
icon = { Icon(Icons.Default.Info, contentDescription = "Informações") },
label = { Text("Informações", fontSize = 10.sp) },
colors = NavigationBarItemDefaults.colors(
selectedIconColor = BrandGreen,
selectedTextColor = BrandGreen,
unselectedIconColor = Color.Gray,
unselectedTextColor = Color.Gray,
indicatorColor = BrandLightGreen
)
)
// Tab 1: Dashboard (Stub) // Tab 1: Dashboard (Stub)
NavigationBarItem( NavigationBarItem(
selected = currentRoute == "dashboard", selected = currentRoute == "dashboard",
@@ -70,7 +106,7 @@ class MainActivity : ComponentActivity() {
} }
}, },
icon = { Icon(Icons.Default.Dashboard, contentDescription = "Dashboard") }, icon = { Icon(Icons.Default.Dashboard, contentDescription = "Dashboard") },
label = { Text("Dashboard", fontSize = 11.sp) }, label = { Text("Dashboard", fontSize = 10.sp) },
colors = NavigationBarItemDefaults.colors( colors = NavigationBarItemDefaults.colors(
selectedIconColor = BrandGreen, selectedIconColor = BrandGreen,
selectedTextColor = BrandGreen, selectedTextColor = BrandGreen,
@@ -93,7 +129,7 @@ class MainActivity : ComponentActivity() {
} }
}, },
icon = { Icon(Icons.Default.Assignment, contentDescription = "Ordens") }, icon = { Icon(Icons.Default.Assignment, contentDescription = "Ordens") },
label = { Text("Ordens", fontSize = 11.sp) }, label = { Text("Ordens", fontSize = 10.sp) },
colors = NavigationBarItemDefaults.colors( colors = NavigationBarItemDefaults.colors(
selectedIconColor = BrandGreen, selectedIconColor = BrandGreen,
selectedTextColor = BrandGreen, selectedTextColor = BrandGreen,
@@ -116,7 +152,7 @@ class MainActivity : ComponentActivity() {
} }
}, },
icon = { Icon(Icons.Default.Settings, contentDescription = "Configurações") }, icon = { Icon(Icons.Default.Settings, contentDescription = "Configurações") },
label = { Text("Configurações", fontSize = 11.sp) }, label = { Text("Configurações", fontSize = 10.sp) },
colors = NavigationBarItemDefaults.colors( colors = NavigationBarItemDefaults.colors(
selectedIconColor = BrandGreen, selectedIconColor = BrandGreen,
selectedTextColor = BrandGreen, selectedTextColor = BrandGreen,
@@ -134,6 +170,11 @@ class MainActivity : ComponentActivity() {
startDestination = "ordens", startDestination = "ordens",
modifier = Modifier.padding(bottom = innerPadding.calculateBottomPadding()) modifier = Modifier.padding(bottom = innerPadding.calculateBottomPadding())
) { ) {
composable("info") {
ImportantInfoScreen(
viewModel = viewModel
)
}
composable("dashboard") { composable("dashboard") {
AnalyticsScreen( AnalyticsScreen(
viewModel = viewModel, viewModel = viewModel,

View File

@@ -4,6 +4,7 @@ import android.content.Context
import androidx.room.Database import androidx.room.Database
import androidx.room.Room import androidx.room.Room
import androidx.room.RoomDatabase import androidx.room.RoomDatabase
import com.example.data.model.AppConfig
import com.example.data.model.AppLog import com.example.data.model.AppLog
import com.example.data.model.MaintenanceActivity import com.example.data.model.MaintenanceActivity
import com.example.data.model.OSFinding import com.example.data.model.OSFinding
@@ -12,8 +13,8 @@ import com.example.data.model.SyncConflictLog
import com.example.data.model.UserAccess import com.example.data.model.UserAccess
@Database( @Database(
entities = [MaintenanceActivity::class, OSUpdateHistory::class, SyncConflictLog::class, UserAccess::class, AppLog::class, OSFinding::class], entities = [MaintenanceActivity::class, OSUpdateHistory::class, SyncConflictLog::class, UserAccess::class, AppLog::class, OSFinding::class, AppConfig::class],
version = 8, version = 10,
exportSchema = false exportSchema = false
) )
abstract class AppDatabase : RoomDatabase() { abstract class AppDatabase : RoomDatabase() {

View File

@@ -5,6 +5,7 @@ import androidx.room.Insert
import androidx.room.OnConflictStrategy import androidx.room.OnConflictStrategy
import androidx.room.Query import androidx.room.Query
import androidx.room.Update import androidx.room.Update
import com.example.data.model.AppConfig
import com.example.data.model.MaintenanceActivity import com.example.data.model.MaintenanceActivity
import com.example.data.model.OSFinding import com.example.data.model.OSFinding
import com.example.data.model.OSUpdateHistory import com.example.data.model.OSUpdateHistory
@@ -93,6 +94,9 @@ interface MaintenanceDao {
@Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs AND tipo = 'OBS' ORDER BY timestamp DESC LIMIT 1") @Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs AND tipo = 'OBS' ORDER BY timestamp DESC LIMIT 1")
suspend fun getLatestObservationForOsOneShot(numeroOs: String): OSFinding? suspend fun getLatestObservationForOsOneShot(numeroOs: String): OSFinding?
@Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs AND (tipo = 'FOTO' OR (fotoPath IS NOT NULL AND fotoPath != '')) ORDER BY timestamp DESC LIMIT 1")
suspend fun getPhotoFindingForOsOneShot(numeroOs: String): OSFinding?
@Insert(onConflict = OnConflictStrategy.REPLACE) @Insert(onConflict = OnConflictStrategy.REPLACE)
suspend fun insertFinding(finding: OSFinding) suspend fun insertFinding(finding: OSFinding)
@@ -110,5 +114,40 @@ interface MaintenanceDao {
@Query("DELETE FROM os_findings") @Query("DELETE FROM os_findings")
suspend fun clearAllFindings() suspend fun clearAllFindings()
// Additional Synced and Epoch Purge Helpers
@Query("SELECT * FROM os_update_history WHERE synced = 0")
suspend fun getUnsyncedHistory(): List<OSUpdateHistory>
@Query("UPDATE os_update_history SET synced = 1 WHERE id IN (:ids)")
suspend fun markHistorySynced(ids: List<Long>)
@Query("UPDATE os_update_history SET synced = 1 WHERE numeroOs = :numeroOs AND timestamp = :timestamp")
suspend fun markHistorySyncedByOsAndTimestamp(numeroOs: String, timestamp: Long)
@Query("DELETE FROM os_update_history WHERE synced = 1 AND numeroOs NOT IN (:activeOsNumbers)")
suspend fun deleteStaleSyncedHistory(activeOsNumbers: List<String>)
@Query("DELETE FROM os_update_history WHERE synced = 1")
suspend fun deleteAllSyncedHistory()
@Query("DELETE FROM os_findings WHERE synced = 1 AND numeroOs NOT IN (:activeOsNumbers)")
suspend fun deleteStaleSyncedFindings(activeOsNumbers: List<String>)
@Query("DELETE FROM os_findings WHERE synced = 1")
suspend fun deleteAllSyncedFindings()
// AppConfig queries
@Query("SELECT * FROM app_config")
fun getAllConfigsFlow(): kotlinx.coroutines.flow.Flow<List<AppConfig>>
@Query("SELECT * FROM app_config")
suspend fun getAllConfigs(): List<AppConfig>
@Insert(onConflict = OnConflictStrategy.REPLACE)
suspend fun insertConfigs(configs: List<AppConfig>)
@Query("DELETE FROM app_config")
suspend fun clearConfigs()
} }

View File

@@ -0,0 +1,18 @@
package com.example.data.model
import androidx.room.Entity
import androidx.room.PrimaryKey
@Entity(tableName = "app_config")
data class AppConfig(
@PrimaryKey val key: String,
val value: String,
val description: String? = null
)
data class ImportantLink(
val id: String,
val title: String,
val url: String,
val description: String? = null
)

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

@@ -0,0 +1,15 @@
package com.example.data.model
import com.squareup.moshi.JsonClass
@JsonClass(generateAdapter = true)
data class DeviceAccessInfo(
val deviceId: String,
val dispositivo: String,
val email: String,
val nomeUsuario: String,
val versaoAndroid: String,
val versaoApp: String,
val ultimoAcesso: String,
val statusSincronizacao: String = "Sucesso"
)

View File

@@ -82,7 +82,13 @@ enum class ActivityStatus(val displayName: String) {
CONCLUIDO("Concluído") CONCLUIDO("Concluído")
} }
@Entity(tableName = "os_update_history") @Entity(
tableName = "os_update_history",
indices = [
Index("numeroOs"),
Index("synced")
]
)
data class OSUpdateHistory( data class OSUpdateHistory(
@PrimaryKey(autoGenerate = true) val id: Long = 0, @PrimaryKey(autoGenerate = true) val id: Long = 0,
val numeroOs: String, val numeroOs: String,
@@ -92,7 +98,8 @@ data class OSUpdateHistory(
val observacao: String? = null, val observacao: String? = null,
val fotoPath: String? = null, val fotoPath: String? = null,
val recurso: String, val recurso: String,
val emailEditor: String? = null val emailEditor: String? = null,
val synced: Boolean = false
) )
data class GoogleUser( data class GoogleUser(

View File

@@ -26,13 +26,14 @@ data class OSFinding(
) )
enum class FindingType(val value: String, val displayName: String) { enum class FindingType(val value: String, val displayName: String) {
FOTO("FOTO", "Foto"),
OBS("OBS", "Observação"), OBS("OBS", "Observação"),
SEGURANCA("SEGURANCA", "Achado de Segurança"), SEGURANCA("SEGURANCA", "Achado de Segurança"),
MANUTENCAO("MANUTENCAO", "Achado de Manutenção"); MANUTENCAO("MANUTENCAO", "Achado de Manutenção");
companion object { companion object {
fun fromValue(value: String): FindingType { fun fromValue(value: String): FindingType {
return values().firstOrNull { it.value.equals(value, ignoreCase = true) } ?: OBS return values().firstOrNull { it.value.equals(value, ignoreCase = true) } ?: FOTO
} }
} }
} }

View File

@@ -24,24 +24,9 @@ class FirebaseStorageSyncService(
private val storage: FirebaseStorage by lazy { FirebaseStorage.getInstance() } private val storage: FirebaseStorage by lazy { FirebaseStorage.getInstance() }
/** /**
* Uploads a local photo file to Firebase Storage under `photos/OS_{osNumber}/{fileName}`. * Ensures user is authenticated with Firebase Auth via Google ID Token if currentUser is null.
* Returns FirebaseUploadResult containing the public download URL and storage path.
*/ */
suspend fun uploadPhoto(photoFile: File, osNumber: String): FirebaseUploadResult { suspend fun ensureFirebaseAuth() {
if (!photoFile.exists()) {
val err = "Arquivo local da foto não existe: ${photoFile.absolutePath}"
appLogger.logError(tag, err)
throw IOException(err)
}
val timestamp = System.currentTimeMillis()
val sanitizedOs = osNumber.replace("/", "_").replace(" ", "")
val fileName = "OS_${sanitizedOs}_${timestamp}.jpg"
val storagePath = "photos/OS_${sanitizedOs}/$fileName"
val photoRef: StorageReference = storage.reference.child(storagePath)
// Ensure user is authenticated with Firebase Auth if possible
val auth = com.google.firebase.auth.FirebaseAuth.getInstance() val auth = com.google.firebase.auth.FirebaseAuth.getInstance()
if (auth.currentUser == null) { if (auth.currentUser == null) {
val lastAccount = com.google.android.gms.auth.api.signin.GoogleSignIn.getLastSignedInAccount(context) val lastAccount = com.google.android.gms.auth.api.signin.GoogleSignIn.getLastSignedInAccount(context)
@@ -58,6 +43,26 @@ class FirebaseStorageSyncService(
Log.w(tag, "Aviso: Nenhum usuário autenticado no FirebaseAuth nem ID Token do Google disponível.") Log.w(tag, "Aviso: Nenhum usuário autenticado no FirebaseAuth nem ID Token do Google disponível.")
} }
} }
}
/**
* Uploads a local photo file to Firebase Storage under `photos/OS_{osNumber}/{fileName}`.
* Returns FirebaseUploadResult containing the public download URL and storage path.
*/
suspend fun uploadPhoto(photoFile: File, osNumber: String): FirebaseUploadResult {
if (!photoFile.exists()) {
val err = "Arquivo local da foto não existe: ${photoFile.absolutePath}"
appLogger.logError(tag, err)
throw IOException(err)
}
val timestamp = System.currentTimeMillis()
val sanitizedOs = osNumber.replace("/", "_").replace(" ", "")
val fileName = "OS_${sanitizedOs}_${timestamp}.jpg"
val storagePath = "photos/OS_${sanitizedOs}/$fileName"
val photoRef: StorageReference = storage.reference.child(storagePath)
ensureFirebaseAuth()
try { try {
val fileToUpload = if (photoFile.length() > 500 * 1024L) { val fileToUpload = if (photoFile.length() > 500 * 1024L) {
@@ -70,6 +75,7 @@ class FirebaseStorageSyncService(
val downloadUrl = photoRef.downloadUrl.await().toString() val downloadUrl = photoRef.downloadUrl.await().toString()
appLogger.logInfo(tag, "Foto enviada com sucesso para o Firebase Storage. OS: $osNumber, Path: $storagePath") appLogger.logInfo(tag, "Foto enviada com sucesso para o Firebase Storage. OS: $osNumber, Path: $storagePath")
downloadUrlCache[storagePath] = downloadUrl
return FirebaseUploadResult( return FirebaseUploadResult(
downloadUrl = downloadUrl, downloadUrl = downloadUrl,
storagePath = storagePath, storagePath = storagePath,
@@ -82,6 +88,75 @@ class FirebaseStorageSyncService(
} }
} }
/**
* Downloads a photo file from Firebase Storage ON DEMAND to internal `os_photos` directory.
* Returns the downloaded local File or null on error.
*/
suspend fun downloadPhotoFile(rawPath: String): File? {
val trimmed = rawPath.trim()
if (trimmed.isBlank() || trimmed.contains("_DELETED")) return null
val cleanPath = trimmed.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true)
val fileName = cleanPath.substringAfterLast("/").substringAfterLast("\\")
.removeSuffix("_DELETED").removeSuffix(".jpg_DELETED").replace("_DELETED", "")
if (fileName.isBlank()) return null
val photosDir = File(context.filesDir, "os_photos")
if (!photosDir.exists()) photosDir.mkdirs()
val targetLocalFile = File(photosDir, fileName)
if (targetLocalFile.exists() && targetLocalFile.length() > 0) {
return targetLocalFile
}
var canonicalStoragePath = cleanPath.removePrefix("/")
if (!canonicalStoragePath.startsWith("photos/")) {
if (canonicalStoragePath.startsWith("o/photos/")) {
canonicalStoragePath = canonicalStoragePath.removePrefix("o/")
} else if (canonicalStoragePath.contains("photos/")) {
canonicalStoragePath = "photos/" + canonicalStoragePath.substringAfter("photos/")
} else if (canonicalStoragePath.startsWith("OS_")) {
canonicalStoragePath = "photos/$canonicalStoragePath"
}
}
ensureFirebaseAuth()
return try {
val photoRef = storage.reference.child(canonicalStoragePath)
photoRef.getFile(targetLocalFile).await()
try {
val tokenizedUrl = photoRef.downloadUrl.await().toString()
registerDownloadUrl(canonicalStoragePath, tokenizedUrl)
} catch (ignored: Exception) {}
appLogger.logInfo(tag, "Foto baixada com sucesso sob demanda para ${targetLocalFile.name}")
targetLocalFile
} catch (e: Exception) {
appLogger.logError(tag, "Falha ao baixar foto sob demanda de '$canonicalStoragePath': ${e.message}", e)
if (targetLocalFile.exists() && targetLocalFile.length() == 0L) {
targetLocalFile.delete()
}
null
}
}
companion object {
val downloadUrlCache = java.util.concurrent.ConcurrentHashMap<String, String>()
fun registerDownloadUrl(storagePath: String, downloadUrl: String) {
if (storagePath.isNotBlank() && downloadUrl.isNotBlank()) {
downloadUrlCache[storagePath] = downloadUrl
}
}
fun getCachedDownloadUrl(storagePath: String): String? {
return downloadUrlCache[storagePath]
}
}
/** /**
* Performs Soft Delete by copying the file object in Firebase Storage to have "_DELETED" * Performs Soft Delete by copying the file object in Firebase Storage to have "_DELETED"
* suffix in the exact same folder, and deleting the original reference. * suffix in the exact same folder, and deleting the original reference.

View File

@@ -2,6 +2,8 @@ package com.example.data.remote
import android.content.Context import android.content.Context
import android.util.Log import android.util.Log
import com.example.data.model.AppConfig
import com.example.data.model.DeviceAccessInfo
import com.example.data.model.MaintenanceActivity import com.example.data.model.MaintenanceActivity
import com.example.data.model.OSUpdateHistory import com.example.data.model.OSUpdateHistory
import com.example.data.model.UserAccess import com.example.data.model.UserAccess
@@ -757,13 +759,67 @@ class GoogleSheetsSyncService(
observacao = obs, observacao = obs,
fotoPath = foto, fotoPath = foto,
recurso = resp, recurso = resp,
emailEditor = email.takeIf { it.isNotBlank() } emailEditor = email.takeIf { it.isNotBlank() },
synced = true
) )
) )
} }
return historyList return historyList
} }
/**
* Reads database_epoch from 'config' tab (cell B2 or key 'database_epoch').
* Defaults to 1 if tab or value is missing/invalid.
*/
fun fetchDatabaseEpoch(): Int {
return try {
val rows = fetchValues("config!A:B")
if (rows.isEmpty()) return 1
for (row in rows) {
if (row.isNotEmpty() && row[0].trim().lowercase() == "database_epoch") {
if (row.size > 1) {
val epochVal = row[1].trim().toIntOrNull()
if (epochVal != null && epochVal > 0) {
return epochVal
}
}
}
}
// Fallback: check row 2 col 2 (B2)
if (rows.size >= 2 && rows[1].size >= 2) {
rows[1][1].trim().toIntOrNull() ?: 1
} else {
1
}
} catch (e: Exception) {
Log.d(tag, "Tab 'config' não encontrada ou sem chave 'database_epoch'. Usando epoch padrão = 1.")
1
}
}
/**
* Reads all key-value-description configuration rows from 'config' tab (config!A:C).
*/
fun fetchRemoteConfigs(): List<AppConfig> {
return try {
val rows = fetchValues("config!A:C")
if (rows.isEmpty()) return emptyList()
val result = mutableListOf<AppConfig>()
for (row in rows) {
if (row.isEmpty()) continue
val key = row[0].trim()
if (key.isEmpty() || key.lowercase() == "chave" || key.lowercase() == "key") continue
val value = if (row.size > 1) row[1].trim() else ""
val desc = if (row.size > 2 && row[2].trim().isNotBlank()) row[2].trim() else null
result.add(AppConfig(key = key, value = value, description = desc))
}
result
} catch (e: Exception) {
Log.e(tag, "Erro ao carregar configurações da aba 'config'", e)
emptyList()
}
}
/** /**
* Stubs out direct activities editing since 'project' is now read-only. * Stubs out direct activities editing since 'project' is now read-only.
*/ */
@@ -930,7 +986,7 @@ class GoogleSheetsSyncService(
finding.timestamp.toString(), finding.timestamp.toString(),
finding.responsavel, finding.responsavel,
finding.emailEditor ?: "", finding.emailEditor ?: "",
filterRemoteOnlyPhotoPaths(finding.fotoPath) filterRemoteOnlyPhotoPaths(finding.fotoPath, finding.numeroOs)
) )
}.toMutableList() }.toMutableList()
@@ -949,13 +1005,131 @@ class GoogleSheetsSyncService(
} }
} }
fun filterRemoteOnlyPhotoPaths(pathStr: String?): String { fun cleanToStoragePath(pathStr: String?, defaultOsNumber: String = ""): String? {
if (pathStr.isNullOrBlank()) return null
val items = pathStr.split("|").map { item ->
val trimmed = item.trim()
if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
val clean = trimmed.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true)
if (clean.contains("/o/")) {
clean.substringAfter("/o/").trim('/')
} else if (clean.contains("photos/")) {
"photos/" + clean.substringAfter("photos/")
} else {
trimmed
}
} else if (trimmed.startsWith("/")) {
val clean = trimmed.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true)
val fileName = clean.substringAfterLast("/").substringAfterLast("\\")
.removeSuffix("_DELETED").removeSuffix(".jpg_DELETED").replace("_DELETED", "")
val osFolder = if (fileName.startsWith("OS_")) {
val parts = fileName.split("_")
if (parts.size >= 2) "${parts[0]}_${parts[1]}" else "OS_$defaultOsNumber"
} else if (defaultOsNumber.isNotBlank()) {
val osSanitized = defaultOsNumber.replace("/", "_").replace(" ", "")
"OS_$osSanitized"
} else {
"OS_Geral"
}
"photos/$osFolder/$fileName"
} else if (trimmed.startsWith("OS_") && trimmed.contains("/")) {
"photos/$trimmed"
} else {
trimmed
}
}
return items.distinct().joinToString("|").ifEmpty { null }
}
fun filterRemoteOnlyPhotoPaths(pathStr: String?, defaultOsNumber: String = ""): String {
if (pathStr.isNullOrBlank()) return "" if (pathStr.isNullOrBlank()) return ""
return pathStr.split("|") val cleaned = cleanToStoragePath(pathStr, defaultOsNumber) ?: return ""
return cleaned.split("|")
.map { it.trim() } .map { it.trim() }
.filter { it.isNotBlank() && !it.startsWith("/") } .filter { it.isNotBlank() && !it.endsWith("_DELETED") && !it.contains("_DELETED") }
.distinct() .distinct()
.joinToString("|") .joinToString("|")
} }
/**
* Updates or appends the device last access record in the 'usage_history' sheet.
*/
fun updateUsageHistory(info: DeviceAccessInfo) {
val sheetName = "usage_history"
val defaultHeaders = listOf(
"device_id", "dispositivo", "email", "nome_usuario", "versao_android", "versao_app", "ultimo_acesso", "status_sincronizacao"
)
ensureHeaders(sheetName, defaultHeaders)
val rows = fetchValues("$sheetName!A:H")
if (rows.isEmpty()) {
val newRow = listOf(
info.deviceId,
info.dispositivo,
info.email,
info.nomeUsuario,
info.versaoAndroid,
info.versaoApp,
info.ultimoAcesso,
info.statusSincronizacao
)
appendValues("$sheetName!A:H", listOf(newRow))
Log.d(tag, "Successfully appended initial device access record for device_id: ${info.deviceId}")
return
}
val headers = rows[0].map { it.trim().lowercase() }
val deviceIdIdx = headers.indexOfFirst { it == "device_id" || it == "deviceid" || it.contains("device") }
.let { if (it != -1) it else 0 }
val dispositivoIdx = headers.indexOfFirst { it == "dispositivo" || it.contains("modelo") || it.contains("aparelho") }
.let { if (it != -1) it else 1 }
val emailIdx = headers.indexOfFirst { it == "email" || it == "e-mail" || it.contains("email") }
.let { if (it != -1) it else 2 }
val nomeIdx = headers.indexOfFirst { it == "nome_usuario" || it == "nome" || it.contains("usuario") || it.contains("usuário") }
.let { if (it != -1) it else 3 }
val androidIdx = headers.indexOfFirst { it == "versao_android" || it.contains("android") }
.let { if (it != -1) it else 4 }
val appIdx = headers.indexOfFirst { it == "versao_app" || it.contains("app") }
.let { if (it != -1) it else 5 }
val ultimoAcessoIdx = headers.indexOfFirst { it == "ultimo_acesso" || it.contains("acesso") || it.contains("data") || it.contains("timestamp") }
.let { if (it != -1) it else 6 }
val statusIdx = headers.indexOfFirst { it == "status_sincronizacao" || it.contains("status") }
.let { if (it != -1) it else 7 }
val maxIdx = maxOf(deviceIdIdx, dispositivoIdx, emailIdx, nomeIdx, androidIdx, appIdx, ultimoAcessoIdx, statusIdx)
var existingRowIndex = -1 // 1-indexed line in sheet
for (i in 1 until rows.size) {
val row = rows[i]
if (deviceIdIdx < row.size && row[deviceIdIdx].trim().equals(info.deviceId.trim(), ignoreCase = true)) {
existingRowIndex = i + 1
break
}
}
fun buildRowValues(): List<String> {
val list = MutableList(maxIdx + 1) { "" }
list[deviceIdIdx] = info.deviceId
list[dispositivoIdx] = info.dispositivo
list[emailIdx] = info.email
list[nomeIdx] = info.nomeUsuario
list[androidIdx] = info.versaoAndroid
list[appIdx] = info.versaoApp
list[ultimoAcessoIdx] = info.ultimoAcesso
list[statusIdx] = info.statusSincronizacao
return list
}
val rowValues = buildRowValues()
if (existingRowIndex != -1) {
val endCol = getColumnLetter(rowValues.size)
updateValues("$sheetName!A$existingRowIndex:$endCol$existingRowIndex", listOf(rowValues))
Log.d(tag, "Successfully updated usage_history row $existingRowIndex for device_id: ${info.deviceId}")
} else {
appendValues("$sheetName!A:H", listOf(rowValues))
Log.d(tag, "Successfully appended new device access record to usage_history for device_id: ${info.deviceId}")
}
}
} }

View File

@@ -8,10 +8,15 @@ import com.example.data.model.OSFinding
import com.example.data.model.OSUpdateHistory 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.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
@@ -34,11 +39,46 @@ 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()
val allActivities: Flow<List<MaintenanceActivity>> = dao.getAllActivities() val allActivities: Flow<List<MaintenanceActivity>> = dao.getAllActivities()
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)
@@ -79,22 +119,62 @@ class MaintenanceRepository(
val currentActivity = dao.getActivityByOsOneShot(numeroOs) ?: return@withContext val currentActivity = dao.getActivityByOsOneShot(numeroOs) ?: return@withContext
val effectiveTimestamp = customTimestampMillis ?: System.currentTimeMillis() val effectiveTimestamp = customTimestampMillis ?: System.currentTimeMillis()
// Handle observation and photo update as an OSFinding of type OBS if filled or photo attached // Handle text observation as OSFinding of type OBS
val cleanObs = stripAuditTags(observacao) val cleanObs = stripAuditTags(observacao)
if (cleanObs != null || !fotoPath.isNullOrBlank()) { if (cleanObs != null) {
val obsText = cleanObs ?: "Foto anexada" val existingObsFinding = dao.getLatestObservationForOsOneShot(numeroOs)
val findingObs = OSFinding( val findingObs = if (existingObsFinding != null) {
existingObsFinding.copy(
descricao = cleanObs,
timestamp = effectiveTimestamp,
responsavel = recurso,
emailEditor = emailEditor,
synced = false
)
} else {
OSFinding(
id = java.util.UUID.randomUUID().toString(), id = java.util.UUID.randomUUID().toString(),
numeroOs = numeroOs, numeroOs = numeroOs,
tipo = "OBS", tipo = "OBS",
descricao = obsText, descricao = cleanObs,
timestamp = effectiveTimestamp,
responsavel = recurso,
emailEditor = emailEditor,
fotoPath = null,
synced = false
)
}
dao.insertFinding(findingObs)
}
// Handle photos as exclusive OSFinding of type FOTO
if (!fotoPath.isNullOrBlank()) {
val existingPhotoFinding = dao.getPhotoFindingForOsOneShot(numeroOs)
val findingPhoto = if (existingPhotoFinding != null) {
val mergedFotoPath = mergePreservingDeletedPhotos(existingPhotoFinding.fotoPath, fotoPath)
existingPhotoFinding.copy(
tipo = "FOTO",
descricao = if (existingPhotoFinding.descricao.isNotBlank() && existingPhotoFinding.descricao != "Foto anexada") existingPhotoFinding.descricao else "Foto anexada",
timestamp = effectiveTimestamp,
responsavel = recurso,
emailEditor = emailEditor,
fotoPath = mergedFotoPath,
synced = false
)
} else {
OSFinding(
id = java.util.UUID.randomUUID().toString(),
numeroOs = numeroOs,
tipo = "FOTO",
descricao = "Foto anexada",
timestamp = effectiveTimestamp, timestamp = effectiveTimestamp,
responsavel = recurso, responsavel = recurso,
emailEditor = emailEditor, emailEditor = emailEditor,
fotoPath = fotoPath, fotoPath = fotoPath,
synced = false synced = false
) )
dao.insertFinding(findingObs) }
dao.insertFinding(findingPhoto)
} }
val latestObsText = cleanObs ?: stripAuditTags(currentActivity.observacoes) val latestObsText = cleanObs ?: stripAuditTags(currentActivity.observacoes)
@@ -401,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)
@@ -428,6 +521,40 @@ class MaintenanceRepository(
android.util.Log.e("MaintenanceRepository", "Falha ao carregar lista de acessos da planilha", e) android.util.Log.e("MaintenanceRepository", "Falha ao carregar lista de acessos da planilha", e)
} }
// 0.01 Fetch remote configs and store locally
try {
val remoteConfigs = sheetsSyncService.fetchRemoteConfigs()
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)
}
// 0.1 Check Remote Database Epoch for reset/cleanup signals
val remoteEpoch = try { sheetsSyncService.fetchDatabaseEpoch() } catch (e: Exception) { 1 }
val prefs = context.getSharedPreferences("google_auth_prefs", Context.MODE_PRIVATE)
val localEpoch = prefs.getInt("database_epoch", 0)
if (remoteEpoch > localEpoch) {
android.util.Log.d("MaintenanceRepository", "Database epoch mudou de $localEpoch para $remoteEpoch. Purgando todo o histórico e achados sincronizados locais para substituir completamente pela nova base remota...")
// Completely clear previously synced history and findings so local database is replaced by the new remote database
dao.deleteAllSyncedHistory()
dao.deleteAllSyncedFindings()
prefs.edit().putInt("database_epoch", remoteEpoch).apply()
}
// 1. Fetch remote OS definitions from the "project" sheet // 1. Fetch remote OS definitions from the "project" sheet
val (remoteActivities, _) = sheetsSyncService.fetchRemoteActivities() val (remoteActivities, _) = sheetsSyncService.fetchRemoteActivities()
@@ -471,9 +598,9 @@ class MaintenanceRepository(
val missingLocalHistory = remoteHistory.filter { "${it.numeroOs}_${it.timestamp}" !in localHistoryKeys } val missingLocalHistory = remoteHistory.filter { "${it.numeroOs}_${it.timestamp}" !in localHistoryKeys }
if (missingLocalHistory.isNotEmpty()) { if (missingLocalHistory.isNotEmpty()) {
for (hist in missingLocalHistory) { for (hist in missingLocalHistory) {
dao.insertHistory(hist) dao.insertHistory(hist.copy(synced = true))
} }
android.util.Log.d("MaintenanceRepository", "Inserted ${missingLocalHistory.size} missing history logs locally.") android.util.Log.d("MaintenanceRepository", "Inserted ${missingLocalHistory.size} missing history logs locally as synced.")
} }
// 6. For each remote activity, determine its current state based on findings (achados) and history log // 6. For each remote activity, determine its current state based on findings (achados) and history log
@@ -534,7 +661,7 @@ class MaintenanceRepository(
} }
// 8. Identify and resolve sync conflicts (LWW) // 8. Identify and resolve sync conflicts (LWW)
val unuploadedLocalLogs = localHistory.filter { "${it.numeroOs}_${it.timestamp}" !in remoteHistoryKeys } val unuploadedLocalLogs = localHistory.filter { !it.synced && "${it.numeroOs}_${it.timestamp}" !in remoteHistoryKeys }
val ossWithUnuploadedLogs = unuploadedLocalLogs.map { it.numeroOs }.toSet() val ossWithUnuploadedLogs = unuploadedLocalLogs.map { it.numeroOs }.toSet()
val newRemoteLogs = remoteHistory.filter { "${it.numeroOs}_${it.timestamp}" !in localHistoryKeys } val newRemoteLogs = remoteHistory.filter { "${it.numeroOs}_${it.timestamp}" !in localHistoryKeys }
@@ -581,11 +708,18 @@ class MaintenanceRepository(
android.util.Log.d("MaintenanceRepository", "Inserted ${conflictLogsToInsert.size} resolved conflict logs.") android.util.Log.d("MaintenanceRepository", "Inserted ${conflictLogsToInsert.size} resolved conflict logs.")
} }
// 9. Upload any local history logs that are not on Google Sheets yet // 9. Upload any local history logs that are not on Google Sheets yet (only unsynced)
val historyToUpload = localHistory.filter { "${it.numeroOs}_${it.timestamp}" !in remoteHistoryKeys } val historyToUpload = localHistory.filter { !it.synced && "${it.numeroOs}_${it.timestamp}" !in remoteHistoryKeys }
if (historyToUpload.isNotEmpty()) { if (historyToUpload.isNotEmpty()) {
sheetsSyncService.pushHistoryToSheet(historyToUpload) sheetsSyncService.pushHistoryToSheet(historyToUpload)
android.util.Log.d("MaintenanceRepository", "Uploaded ${historyToUpload.size} new local history logs to Google Sheet.") val uploadedIds = historyToUpload.map { it.id }.filter { it != 0L }
if (uploadedIds.isNotEmpty()) {
dao.markHistorySynced(uploadedIds)
}
for (h in historyToUpload) {
dao.markHistorySyncedByOsAndTimestamp(h.numeroOs, h.timestamp)
}
android.util.Log.d("MaintenanceRepository", "Uploaded ${historyToUpload.size} new local history logs to Google Sheet and marked as synced.")
} }
// 10. Sync 'achados' sheet with local OSFinding database safely preserving local/uploaded photo paths // 10. Sync 'achados' sheet with local OSFinding database safely preserving local/uploaded photo paths
@@ -596,18 +730,15 @@ class MaintenanceRepository(
val reconciledFindings = remoteFindings.map { remote -> val reconciledFindings = remoteFindings.map { remote ->
val local = localFindingsMap[remote.id] val local = localFindingsMap[remote.id]
if (local != null) { if (local != null) {
val localHasPhoto = !local.fotoPath.isNullOrBlank() val finalFotoPath = mergePreservingDeletedPhotos(local.fotoPath, remote.fotoPath)
val remoteHasPhoto = !remote.fotoPath.isNullOrBlank() if (!local.synced) {
val finalFotoPath = when { local.copy(fotoPath = finalFotoPath)
localHasPhoto && !remoteHasPhoto -> local.fotoPath } else {
remoteHasPhoto && localHasPhoto -> mergePreservingDeletedPhotos(local.fotoPath, remote.fotoPath)
remoteHasPhoto -> remote.fotoPath
else -> local.fotoPath
}
remote.copy( remote.copy(
fotoPath = finalFotoPath, fotoPath = finalFotoPath,
synced = local.synced && (finalFotoPath == remote.fotoPath) synced = local.synced && (finalFotoPath == remote.fotoPath)
) )
}
} else { } else {
remote remote
} }
@@ -618,8 +749,43 @@ class MaintenanceRepository(
val localOnlyFindings = localFindingsMap.values.filter { it.id !in remoteIds } val localOnlyFindings = localFindingsMap.values.filter { it.id !in remoteIds }
reconciledFindings.addAll(localOnlyFindings) reconciledFindings.addAll(localOnlyFindings)
if (reconciledFindings.isNotEmpty()) { // Consolidate duplicate FOTO and OBS findings for the same OS into single OSFinding rows
dao.insertFindings(reconciledFindings) val consolidatedFindings = mutableListOf<OSFinding>()
val groupedByOsAndType = reconciledFindings.groupBy { Pair(it.numeroOs, if (it.tipo == "FOTO" || !it.fotoPath.isNullOrBlank()) "FOTO" else it.tipo) }
groupedByOsAndType.forEach { (key, findingsList) ->
val (osNum, groupType) = key
if (findingsList.size > 1) {
val latestItem = findingsList.maxByOrNull { it.timestamp } ?: findingsList.first()
val mergedPhotoPath = findingsList.mapNotNull { it.fotoPath }
.flatMap { it.split("|") }
.map { it.trim() }
.filter { it.isNotBlank() }
.distinct()
.joinToString("|")
.ifEmpty { null }
consolidatedFindings.add(
latestItem.copy(
tipo = groupType,
fotoPath = mergedPhotoPath
)
)
// Cleanup duplicate IDs from Room DB
val duplicateIds = findingsList.map { it.id }.filter { it != latestItem.id }
duplicateIds.forEach { dupId -> dao.deleteFindingById(dupId) }
} else {
val single = findingsList.first()
if (!single.fotoPath.isNullOrBlank() && single.tipo != "FOTO") {
consolidatedFindings.add(single.copy(tipo = "FOTO"))
} else {
consolidatedFindings.add(single)
}
}
}
if (consolidatedFindings.isNotEmpty()) {
dao.insertFindings(consolidatedFindings)
} }
val allLocalActiveFindings = dao.getAllFindingsList() val allLocalActiveFindings = dao.getAllFindingsList()
@@ -629,6 +795,12 @@ class MaintenanceRepository(
android.util.Log.e("MaintenanceRepository", "Falha ao sincronizar aba achados", e) android.util.Log.e("MaintenanceRepository", "Falha ao sincronizar aba achados", e)
} }
try {
recordDeviceAccessLog("Sucesso")
} catch (e: Exception) {
android.util.Log.e("MaintenanceRepository", "Falha ao registrar log de uso do dispositivo", e)
}
SyncResult.Success( SyncResult.Success(
syncedItems = reconciledActivities.size, syncedItems = reconciledActivities.size,
conflictsResolved = conflictingOSs.size conflictsResolved = conflictingOSs.size
@@ -639,6 +811,42 @@ class MaintenanceRepository(
} }
} }
private fun recordDeviceAccessLog(status: String = "Sucesso") {
try {
val savedUser = getSavedUser()
val firebaseUser = try {
com.google.firebase.auth.FirebaseAuth.getInstance().currentUser
} catch (e: Throwable) {
null
}
val email = savedUser?.email ?: firebaseUser?.email ?: ""
val name = savedUser?.displayName ?: firebaseUser?.displayName ?: ""
val deviceId = com.example.util.DeviceUtils.getDeviceId(context)
val model = com.example.util.DeviceUtils.getDeviceModel()
val androidVer = com.example.util.DeviceUtils.getAndroidVersion()
val appVer = com.example.util.DeviceUtils.getAppVersion(context)
val sdf = java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ss", java.util.Locale.getDefault())
val formattedTime = sdf.format(java.util.Date())
val accessInfo = com.example.data.model.DeviceAccessInfo(
deviceId = deviceId,
dispositivo = model,
email = email,
nomeUsuario = name,
versaoAndroid = androidVer,
versaoApp = appVer,
ultimoAcesso = formattedTime,
statusSincronizacao = status
)
sheetsSyncService.updateUsageHistory(accessInfo)
} catch (e: Exception) {
android.util.Log.e("MaintenanceRepository", "Falha ao registrar histórico de uso do dispositivo", e)
}
}
private fun sanitizeSetor(setor: String): String { private fun sanitizeSetor(setor: String): String {
val s = setor.trim() val s = setor.trim()
if (s.isBlank()) return "Preparação" if (s.isBlank()) return "Preparação"
@@ -760,8 +968,8 @@ class MaintenanceRepository(
val result = firebaseStorageSyncService.uploadPhoto(compressedFile, finding.numeroOs) val result = firebaseStorageSyncService.uploadPhoto(compressedFile, finding.numeroOs)
changed = true changed = true
replacementsByOs.getOrPut(finding.numeroOs) { mutableListOf() } replacementsByOs.getOrPut(finding.numeroOs) { mutableListOf() }
.add(Pair(trimmed, result.downloadUrl)) .add(Pair(trimmed, result.storagePath))
result.downloadUrl result.storagePath
} catch (e: Exception) { } catch (e: Exception) {
android.util.Log.e("MaintenanceRepository", "Falha no upload da foto ${file.name} para o Firebase Storage: ${e.message}", e) android.util.Log.e("MaintenanceRepository", "Falha no upload da foto ${file.name} para o Firebase Storage: ${e.message}", e)
trimmed trimmed
@@ -799,8 +1007,8 @@ class MaintenanceRepository(
val result = firebaseStorageSyncService.uploadPhoto(compressedFile, history.numeroOs) val result = firebaseStorageSyncService.uploadPhoto(compressedFile, history.numeroOs)
changed = true changed = true
replacementsByOs.getOrPut(history.numeroOs) { mutableListOf() } replacementsByOs.getOrPut(history.numeroOs) { mutableListOf() }
.add(Pair(trimmed, result.downloadUrl)) .add(Pair(trimmed, result.storagePath))
result.downloadUrl result.storagePath
} catch (e: Exception) { } catch (e: Exception) {
android.util.Log.e("MaintenanceRepository", "Falha no upload da foto ${file.name} para o Firebase Storage: ${e.message}", e) android.util.Log.e("MaintenanceRepository", "Falha no upload da foto ${file.name} para o Firebase Storage: ${e.message}", e)
trimmed trimmed
@@ -947,6 +1155,37 @@ class MaintenanceRepository(
} }
} }
} }
suspend fun seedDefaultConfigsIfEmpty() = withContext(Dispatchers.IO) {
val existing = dao.getAllConfigs()
if (existing.isEmpty()) {
val defaults = listOf(
com.example.data.model.AppConfig("database_epoch", "3", "Versão da base de dados. Incremente em +1 ao alterar/limpar a planilha"),
com.example.data.model.AppConfig("Link1", "https://forms.office.com/Pages/ResponsePage.aspx?id=IYw2V8-4z0K9C0Ps1LxirnRboL6yMAxJn4T7PLeH0KtURjNLNlNJQTdHU0JMVlVNMlJISlNTSFJFRyQlQCN0PWcu&origin=APPgestaoos", "Link para ser exibido na tela de informações"),
com.example.data.model.AppConfig("DescricaoLink1", "Link do RDS (Relato de Segurança)", "Link do RDS (Relato de Segurança)"),
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("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)
}
}
suspend fun refreshConfigs(): List<com.example.data.model.AppConfig> = withContext(Dispatchers.IO) {
try {
val configs = sheetsSyncService.fetchRemoteConfigs()
if (configs.isNotEmpty()) {
dao.insertConfigs(configs)
}
configs
} catch (e: Exception) {
android.util.Log.e("MaintenanceRepository", "Erro ao atualizar configs", e)
emptyList()
}
}
} }
sealed interface SyncResult { sealed interface SyncResult {

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

@@ -0,0 +1,431 @@
package com.example.ui.screens
import android.content.Intent
import android.net.Uri
import android.widget.Toast
import androidx.compose.foundation.background
import androidx.compose.foundation.clickable
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
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.*
import androidx.compose.runtime.*
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.vector.ImageVector
import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import com.example.data.model.ImportantLink
import com.example.ui.theme.BrandBlack
import com.example.ui.theme.BrandGreen
import com.example.ui.theme.BrandLightGreen
import com.example.ui.theme.LightGrey
import com.example.ui.viewmodel.MaintenanceViewModel
import kotlinx.coroutines.launch
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ImportantInfoScreen(
viewModel: MaintenanceViewModel,
modifier: Modifier = Modifier
) {
val context = LocalContext.current
val links by viewModel.importantLinks.collectAsStateWithLifecycle()
val isNetworkConnected by viewModel.isNetworkConnected.collectAsStateWithLifecycle(initialValue = true)
val isSyncing by viewModel.isSyncing.collectAsStateWithLifecycle()
val openUrl: (String) -> Unit = { urlString ->
try {
val formattedUrl = if (!urlString.startsWith("http://") && !urlString.startsWith("https://")) {
"https://$urlString"
} else urlString
val intent = Intent(Intent.ACTION_VIEW, Uri.parse(formattedUrl))
context.startActivity(intent)
} catch (e: Exception) {
Toast.makeText(context, "Não foi possível abrir o link: ${e.message}", Toast.LENGTH_SHORT).show()
}
}
Scaffold(
topBar = {
TopAppBar(
title = {
Column {
Text(
text = "Informações Importantes",
fontWeight = FontWeight.Bold,
fontSize = 20.sp,
color = BrandBlack
)
Text(
text = "Links da aba config da planilha online",
fontSize = 12.sp,
color = Color.Gray
)
}
},
actions = {
IconButton(
onClick = {
if (!isSyncing) {
viewModel.syncNow()
Toast.makeText(context, "Atualizando informações da planilha...", Toast.LENGTH_SHORT).show()
}
}
) {
if (isSyncing) {
CircularProgressIndicator(
modifier = Modifier.size(20.dp),
color = BrandGreen,
strokeWidth = 2.dp
)
} else {
Icon(
imageVector = Icons.Default.Refresh,
contentDescription = "Atualizar Links",
tint = BrandGreen
)
}
}
},
colors = TopAppBarDefaults.topAppBarColors(containerColor = Color.White)
)
},
modifier = modifier
) { innerPadding ->
Column(
modifier = Modifier
.fillMaxSize()
.padding(innerPadding)
.background(LightGrey)
.padding(horizontal = 16.dp, vertical = 12.dp)
) {
// Status Card
Card(
modifier = Modifier
.fillMaxWidth()
.padding(bottom = 16.dp),
shape = RoundedCornerShape(12.dp),
colors = CardDefaults.cardColors(containerColor = Color.White),
elevation = CardDefaults.cardElevation(defaultElevation = 2.dp)
) {
Row(
modifier = Modifier
.fillMaxWidth()
.padding(16.dp),
verticalAlignment = Alignment.CenterVertically
) {
Box(
modifier = Modifier
.size(40.dp)
.clip(CircleShape)
.background(BrandLightGreen),
contentAlignment = Alignment.Center
) {
Icon(
imageVector = Icons.Default.Info,
contentDescription = "Informações",
tint = BrandGreen
)
}
Spacer(modifier = Modifier.width(12.dp))
Column(modifier = Modifier.weight(1f)) {
Text(
text = "Central de Links do Sistema",
fontSize = 15.sp,
fontWeight = FontWeight.Bold,
color = BrandBlack
)
Spacer(modifier = Modifier.height(2.dp))
Text(
text = if (isNetworkConnected) "Sincronizado com o BD online" else "Modo Offline (Links armazenados localmente)",
fontSize = 12.sp,
color = if (isNetworkConnected) BrandGreen else Color(0xFFD97706)
)
}
}
}
// Links List Title
Text(
text = "LINKS ÚTEIS E DOCUMENTOS",
fontSize = 12.sp,
fontWeight = FontWeight.Bold,
color = Color.Gray,
modifier = Modifier.padding(start = 4.dp, bottom = 8.dp)
)
// Links List + Responsáveis
LazyColumn(
verticalArrangement = Arrangement.spacedBy(12.dp),
modifier = Modifier.fillMaxWidth()
) {
items(links, key = { it.id }) { linkItem ->
ImportantLinkCard(
link = linkItem,
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))
}
}
}
}
}
@Composable
fun ImportantLinkCard(
link: ImportantLink,
onOpenUrl: () -> Unit,
modifier: Modifier = Modifier
) {
val (icon, badgeColor) = when (link.id) {
"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
}
Card(
modifier = modifier
.fillMaxWidth()
.clickable { onOpenUrl() },
shape = RoundedCornerShape(14.dp),
colors = CardDefaults.cardColors(containerColor = Color.White),
elevation = CardDefaults.cardElevation(defaultElevation = 2.dp)
) {
Row(
modifier = Modifier
.fillMaxWidth()
.padding(16.dp),
verticalAlignment = Alignment.CenterVertically
) {
Box(
modifier = Modifier
.size(48.dp)
.clip(RoundedCornerShape(12.dp))
.background(badgeColor.copy(alpha = 0.1f)),
contentAlignment = Alignment.Center
) {
Icon(
imageVector = icon,
contentDescription = link.title,
tint = badgeColor,
modifier = Modifier.size(24.dp)
)
}
Spacer(modifier = Modifier.width(14.dp))
Column(
modifier = Modifier.weight(1f)
) {
Text(
text = link.title,
fontSize = 15.sp,
fontWeight = FontWeight.Bold,
color = BrandBlack,
maxLines = 2,
overflow = TextOverflow.Ellipsis
)
if (!link.description.isNullOrBlank()) {
Spacer(modifier = Modifier.height(4.dp))
Text(
text = link.description,
fontSize = 12.sp,
color = Color.Gray,
maxLines = 2,
overflow = TextOverflow.Ellipsis
)
}
Spacer(modifier = Modifier.height(6.dp))
Text(
text = link.url,
fontSize = 11.sp,
color = badgeColor,
fontWeight = FontWeight.Medium,
maxLines = 1,
overflow = TextOverflow.Ellipsis
)
}
Spacer(modifier = Modifier.width(8.dp))
IconButton(
onClick = onOpenUrl,
modifier = Modifier
.size(36.dp)
.clip(CircleShape)
.background(LightGrey)
) {
Icon(
imageVector = Icons.Default.OpenInNew,
contentDescription = "Abrir Link",
tint = BrandBlack,
modifier = Modifier.size(18.dp)
)
}
}
}
}
@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

@@ -1117,37 +1117,142 @@ fun OSListItemCard(
fun resolvePhotoModel(path: String, context: android.content.Context? = null): String { fun resolvePhotoModel(path: String, context: android.content.Context? = null): String {
val trimmed = path.trim() val trimmed = path.trim()
if (trimmed.isBlank()) return "" if (trimmed.isBlank() || trimmed.contains("_DELETED")) return ""
// 1. Prioritize local file path if it exists on disk // 1. Direct HTTP/HTTPS URLs (if already full download URL with token)
if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
return trimmed
}
// 2. Direct local file path if file physically exists on disk
if (trimmed.startsWith("/")) { if (trimmed.startsWith("/")) {
val file = java.io.File(trimmed) val file = java.io.File(trimmed)
if (file.exists()) return trimmed if (file.exists()) return trimmed
} }
// 2. Check if local cached file with same name exists in internal os_photos directory // 3. Extract filename to check if cached in internal `os_photos` directory
if (context != null) { val cleanPathForName = trimmed.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true)
val clean = trimmed.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true) val fileName = cleanPathForName.substringAfterLast("/").substringAfterLast("\\")
val fileName = clean.substringAfterLast("/").substringAfterLast("\\")
.removeSuffix("_DELETED").removeSuffix(".jpg_DELETED").replace("_DELETED", "") .removeSuffix("_DELETED").removeSuffix(".jpg_DELETED").replace("_DELETED", "")
if (fileName.isNotBlank()) {
if (context != null && fileName.isNotBlank()) {
val photosDir = java.io.File(context.filesDir, "os_photos") val photosDir = java.io.File(context.filesDir, "os_photos")
val localCachedFile = java.io.File(photosDir, fileName) val localCachedFile = java.io.File(photosDir, fileName)
if (localCachedFile.exists()) { if (localCachedFile.exists()) {
return localCachedFile.absolutePath return localCachedFile.absolutePath
} }
} }
// 4. Resolve relative storage path (e.g. "photos/OS_OS-1503/OS_OS-1503_1786022754485.jpg", "/photos/...", "photos%2F...", "OS_OS-1503/...")
var canonicalStoragePath = cleanPathForName.removePrefix("/")
if (!canonicalStoragePath.startsWith("photos/")) {
if (canonicalStoragePath.startsWith("o/photos/")) {
canonicalStoragePath = canonicalStoragePath.removePrefix("o/")
} else if (canonicalStoragePath.contains("photos/")) {
canonicalStoragePath = "photos/" + canonicalStoragePath.substringAfter("photos/")
} else if (canonicalStoragePath.startsWith("OS_")) {
canonicalStoragePath = "photos/$canonicalStoragePath"
}
} }
// 3. Fallback to remote URLs // Check if tokenized downloadUrl is registered in memory cache
val cachedUrl = com.example.data.remote.FirebaseStorageSyncService.getCachedDownloadUrl(canonicalStoragePath)
if (!cachedUrl.isNullOrBlank()) {
return cachedUrl
}
if (canonicalStoragePath.startsWith("photos/")) {
val encoded = try {
android.net.Uri.encode(canonicalStoragePath)
} catch (e: Throwable) {
java.net.URLEncoder.encode(canonicalStoragePath, "UTF-8").replace("+", "%20")
}
return "https://firebasestorage.googleapis.com/v0/b/gestao-parada-os.firebasestorage.app/o/$encoded?alt=media"
}
return trimmed
}
@Composable
fun rememberResolvedPhotoModel(path: String): String {
val context = LocalContext.current
var resolvedUrl by remember(path) { mutableStateOf(resolvePhotoModel(path, context)) }
LaunchedEffect(path) {
val trimmed = path.trim()
if (trimmed.isBlank() || trimmed.contains("_DELETED")) return@LaunchedEffect
if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) { if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
return trimmed resolvedUrl = trimmed
return@LaunchedEffect
} }
if (trimmed.startsWith("photos/")) { if (trimmed.startsWith("/")) {
val encoded = android.net.Uri.encode(trimmed) val file = java.io.File(trimmed)
return "https://firebasestorage.googleapis.com/v0/b/cargill-parada-os.appspot.com/o/$encoded?alt=media" if (file.exists()) {
resolvedUrl = file.absolutePath
return@LaunchedEffect
} }
return trimmed }
val cleanPathForName = trimmed.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 localCachedFile = java.io.File(photosDir, fileName)
if (localCachedFile.exists()) {
resolvedUrl = localCachedFile.absolutePath
return@LaunchedEffect
}
}
var canonicalStoragePath = cleanPathForName.removePrefix("/")
if (!canonicalStoragePath.startsWith("photos/")) {
if (canonicalStoragePath.startsWith("o/photos/")) {
canonicalStoragePath = canonicalStoragePath.removePrefix("o/")
} else if (canonicalStoragePath.contains("photos/")) {
canonicalStoragePath = "photos/" + canonicalStoragePath.substringAfter("photos/")
} else if (canonicalStoragePath.startsWith("OS_")) {
canonicalStoragePath = "photos/$canonicalStoragePath"
}
}
val cachedUrl = com.example.data.remote.FirebaseStorageSyncService.getCachedDownloadUrl(canonicalStoragePath)
if (!cachedUrl.isNullOrBlank()) {
resolvedUrl = cachedUrl
return@LaunchedEffect
}
// Try downloading photo file ON DEMAND from Firebase Storage if not on local disk
try {
val syncService = com.example.data.remote.FirebaseStorageSyncService(context)
val downloadedFile: java.io.File? = kotlinx.coroutines.withContext(kotlinx.coroutines.Dispatchers.IO) {
syncService.downloadPhotoFile(trimmed)
}
if (downloadedFile != null && downloadedFile.exists()) {
resolvedUrl = downloadedFile.absolutePath
return@LaunchedEffect
}
} catch (e: Throwable) {
android.util.Log.w("PhotoResolver", "Falha ao baixar foto sob demanda de $trimmed: ${e.message}")
}
try {
val storageRef = com.google.firebase.storage.FirebaseStorage.getInstance().reference.child(canonicalStoragePath)
storageRef.downloadUrl.addOnSuccessListener { uri ->
val tokenizedUrl = uri.toString()
com.example.data.remote.FirebaseStorageSyncService.registerDownloadUrl(canonicalStoragePath, tokenizedUrl)
resolvedUrl = tokenizedUrl
}.addOnFailureListener { e ->
android.util.Log.w("PhotoResolver", "Could not fetch signed downloadUrl for $canonicalStoragePath: ${e.message}")
}
} catch (e: Throwable) {
android.util.Log.w("PhotoResolver", "Could not fetch signed downloadUrl for $canonicalStoragePath: ${e.message}")
}
}
return resolvedUrl
} }
@Composable @Composable
@@ -1174,8 +1279,7 @@ fun FullscreenPhotoViewerDialog(
modifier = Modifier modifier = Modifier
.fillMaxWidth() .fillMaxWidth()
.align(Alignment.TopCenter) .align(Alignment.TopCenter)
.statusBarsPadding() .padding(16.dp),
.padding(horizontal = 16.dp, vertical = 12.dp),
horizontalArrangement = Arrangement.SpaceBetween, horizontalArrangement = Arrangement.SpaceBetween,
verticalAlignment = Alignment.CenterVertically verticalAlignment = Alignment.CenterVertically
) { ) {
@@ -1199,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"
@@ -1213,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()
@@ -1250,7 +1373,7 @@ fun FullscreenPhotoViewerDialog(
} }
// Image display // Image display
val resolvedModel = remember(photoPath) { resolvePhotoModel(photoPath, context) } val resolvedModel = rememberResolvedPhotoModel(photoPath)
var retryKey by remember { mutableStateOf(0) } var retryKey by remember { mutableStateOf(0) }
coil.compose.SubcomposeAsyncImage( coil.compose.SubcomposeAsyncImage(
model = coil.request.ImageRequest.Builder(context) model = coil.request.ImageRequest.Builder(context)
@@ -1259,6 +1382,15 @@ fun FullscreenPhotoViewerDialog(
.crossfade(true) .crossfade(true)
.diskCachePolicy(coil.request.CachePolicy.ENABLED) .diskCachePolicy(coil.request.CachePolicy.ENABLED)
.memoryCachePolicy(coil.request.CachePolicy.ENABLED) .memoryCachePolicy(coil.request.CachePolicy.ENABLED)
.listener(
onError = { _, result ->
com.example.util.AppLogger.getInstance(context).logError(
tag = "PhotoDisplayError",
message = "Falha ao carregar/exibir foto em tela cheia ($photoPath). Modelo: '$resolvedModel'",
throwable = result.throwable
)
}
)
.build(), .build(),
contentDescription = "Visualização em Tela Cheia", contentDescription = "Visualização em Tela Cheia",
modifier = Modifier modifier = Modifier
@@ -1360,7 +1492,8 @@ fun EditActivityBottomSheet(
var selectedPhotoForViewer by remember { mutableStateOf<String?>(null) } var selectedPhotoForViewer by remember { mutableStateOf<String?>(null) }
var isSubmitting by remember { mutableStateOf(false) } var isSubmitting by remember { mutableStateOf(false) }
val activePhotos = remember(activity, history) { // Exibir fotos da galeria APENAS pela aba achados (findings)
val activePhotos = remember(findings) {
val list = mutableListOf<String>() val list = mutableListOf<String>()
fun processPath(raw: String?) { fun processPath(raw: String?) {
if (!raw.isNullOrBlank()) { if (!raw.isNullOrBlank()) {
@@ -1372,8 +1505,7 @@ fun EditActivityBottomSheet(
} }
} }
} }
processPath(activity.fotoPath) findings.forEach { processPath(it.fotoPath) }
history.forEach { processPath(it.fotoPath) }
list list
} }
@@ -1900,16 +2032,25 @@ fun EditActivityBottomSheet(
border = BorderStroke(2.dp, if (isNew) BrandGreen else Color(0xFFE0E0E0)) border = BorderStroke(2.dp, if (isNew) BrandGreen else Color(0xFFE0E0E0))
) { ) {
Box(modifier = Modifier.fillMaxSize()) { Box(modifier = Modifier.fillMaxSize()) {
val currentCtx = LocalContext.current val resolvedModel = rememberResolvedPhotoModel(photoPath)
val resolvedModel = remember(photoPath) { resolvePhotoModel(photoPath, currentCtx) }
var retryKey by remember { mutableStateOf(0) } var retryKey by remember { mutableStateOf(0) }
val currentContext = LocalContext.current
coil.compose.SubcomposeAsyncImage( coil.compose.SubcomposeAsyncImage(
model = coil.request.ImageRequest.Builder(LocalContext.current) model = coil.request.ImageRequest.Builder(currentContext)
.data(resolvedModel) .data(resolvedModel)
.setParameter("retry_key", retryKey) .setParameter("retry_key", retryKey)
.crossfade(true) .crossfade(true)
.diskCachePolicy(coil.request.CachePolicy.ENABLED) .diskCachePolicy(coil.request.CachePolicy.ENABLED)
.memoryCachePolicy(coil.request.CachePolicy.ENABLED) .memoryCachePolicy(coil.request.CachePolicy.ENABLED)
.listener(
onError = { _, result ->
com.example.util.AppLogger.getInstance(currentContext).logError(
tag = "PhotoDisplayError",
message = "Falha ao carregar miniatura da foto ($photoPath). Modelo: '$resolvedModel'",
throwable = result.throwable
)
}
)
.build(), .build(),
contentDescription = "Miniatura da foto", contentDescription = "Miniatura da foto",
modifier = Modifier.fillMaxSize(), modifier = Modifier.fillMaxSize(),

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
@@ -36,6 +37,102 @@ import kotlinx.coroutines.launch
class MaintenanceViewModel(private val repository: MaintenanceRepository) : ViewModel() { class MaintenanceViewModel(private val repository: MaintenanceRepository) : ViewModel() {
init {
viewModelScope.launch {
repository.seedDefaultConfigsIfEmpty()
}
}
val importantLinks: StateFlow<List<com.example.data.model.ImportantLink>> = repository.allConfigs
.map { configs -> parseImportantLinks(configs) }
.stateIn(
scope = viewModelScope,
started = SharingStarted.WhileSubscribed(5000),
initialValue = getDefaultImportantLinks()
)
private fun parseImportantLinks(configs: List<com.example.data.model.AppConfig>): List<com.example.data.model.ImportantLink> {
if (configs.isEmpty()) return getDefaultImportantLinks()
val configMap = configs.associateBy { it.key }
val defaultLinks = getDefaultImportantLinks()
val result = mutableListOf<com.example.data.model.ImportantLink>()
for (i in 1..3) {
val linkKey = "Link$i"
val descKey = "DescricaoLink$i"
val defaultItem = defaultLinks.getOrNull(i - 1)
val url = configMap[linkKey]?.value?.trim()?.takeIf { it.isNotBlank() }
?: defaultItem?.url
?: "https://exemple.com"
val title = configMap[descKey]?.value?.trim()?.takeIf { it.isNotBlank() }
?: configMap[descKey]?.description?.trim()?.takeIf { it.isNotBlank() }
?: defaultItem?.title
?: "Link $i"
val description = configMap[linkKey]?.description?.trim()?.takeIf { it.isNotBlank() }
?: configMap[descKey]?.description?.trim()?.takeIf { it.isNotBlank() }
?: defaultItem?.description
result.add(
com.example.data.model.ImportantLink(
id = i.toString(),
title = title,
url = url,
description = description
)
)
}
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
}
private fun getDefaultImportantLinks(): List<com.example.data.model.ImportantLink> {
return listOf(
com.example.data.model.ImportantLink(
id = "1",
title = "Link do RDS (Relato de Segurança)",
url = "https://forms.office.com/Pages/ResponsePage.aspx?id=IYw2V8-4z0K9C0Ps1LxirnRboL6yMAxJn4T7PLeH0KtURjNLNlNJQTdHU0JMVlVNMlJISlNTSFJFRyQlQCN0PWcu&origin=APPgestaoos",
description = "Link para ser exibido na tela de informações"
),
com.example.data.model.ImportantLink(
id = "2",
title = "Informações de privacidade do APP",
url = "https://exemple.com",
description = "Informações de privacidade"
),
com.example.data.model.ImportantLink(
id = "3",
title = "Termos de uso deste APP",
url = "https://exemple.com",
description = "Termos de uso do APP"
)
)
}
// Filtering inputs // Filtering inputs
private val _selectedSetor = MutableStateFlow("Todos") private val _selectedSetor = MutableStateFlow("Todos")
val selectedSetor = _selectedSetor.asStateFlow() val selectedSetor = _selectedSetor.asStateFlow()
@@ -68,10 +165,29 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View
// UI Operation States // UI Operation States
private val _isSyncing = MutableStateFlow(false) private val _isSyncing = MutableStateFlow(false)
val isSyncing = _isSyncing.asStateFlow() val isSyncing = _isSyncing.asStateFlow()
val isNetworkConnected = repository.isNetworkConnected
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()
@@ -372,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?) {
@@ -433,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 }
@@ -462,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
} }
} }
@@ -747,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

@@ -0,0 +1,61 @@
package com.example.util
import android.content.Context
import android.os.Build
import android.provider.Settings
import java.util.UUID
object DeviceUtils {
fun getDeviceId(context: Context): String {
val androidId = try {
Settings.Secure.getString(context.contentResolver, Settings.Secure.ANDROID_ID)
} catch (e: Exception) {
null
}
if (!androidId.isNullOrBlank() && androidId != "9774d56d682e549c") {
return androidId
}
val prefs = context.getSharedPreferences("device_prefs", Context.MODE_PRIVATE)
var uuid = prefs.getString("device_uuid", null)
if (uuid.isNullOrBlank()) {
uuid = UUID.randomUUID().toString()
prefs.edit().putString("device_uuid", uuid).apply()
}
return uuid
}
fun getDeviceModel(): String {
val manufacturer = Build.MANUFACTURER ?: ""
val model = Build.MODEL ?: ""
return if (model.startsWith(manufacturer, ignoreCase = true)) {
model.replaceFirstChar { if (it.isLowerCase()) it.titlecase() else it.toString() }
} else {
"${manufacturer.replaceFirstChar { if (it.isLowerCase()) it.titlecase() else it.toString() }} $model"
}.trim()
}
fun getAndroidVersion(): String {
val release = Build.VERSION.RELEASE ?: "Unknown"
val sdk = Build.VERSION.SDK_INT
return "Android $release (API $sdk)"
}
fun getAppVersion(context: Context): String {
return try {
val packageInfo = context.packageManager.getPackageInfo(context.packageName, 0)
val versionName = packageInfo.versionName ?: "1.4.0"
@Suppress("DEPRECATION")
val versionCode = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
packageInfo.longVersionCode
} else {
packageInfo.versionCode.toLong()
}
"$versionName (v$versionCode)"
} catch (e: Exception) {
"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

@@ -0,0 +1,79 @@
package com.example
import com.example.data.model.AppConfig
import com.example.data.model.ImportantLink
import org.junit.Assert.assertEquals
import org.junit.Assert.assertNotNull
import org.junit.Test
class AppConfigTest {
@Test
fun testAppConfigCreation() {
val config = AppConfig(
key = "Link1",
value = "https://forms.office.com/test",
description = "Link do RDS"
)
assertEquals("Link1", config.key)
assertEquals("https://forms.office.com/test", config.value)
assertEquals("Link do RDS", config.description)
}
@Test
fun testImportantLinkModel() {
val link = ImportantLink(
id = "1",
title = "Link do RDS (Relato de Segurança)",
url = "https://forms.office.com/test",
description = "Link para ser exibido na tela de informações"
)
assertEquals("1", link.id)
assertEquals("Link do RDS (Relato de Segurança)", link.title)
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)
}
}

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

@@ -578,4 +578,99 @@ class ExampleRobolectricTest {
kotlinx.coroutines.Dispatchers.resetMain() kotlinx.coroutines.Dispatchers.resetMain()
} }
} }
@OptIn(kotlinx.coroutines.ExperimentalCoroutinesApi::class)
@Test
fun `test database epoch reconciliation and synced flag purge rules`() {
val testDispatcher = kotlinx.coroutines.test.UnconfinedTestDispatcher()
kotlinx.coroutines.Dispatchers.setMain(testDispatcher)
try {
val context = ApplicationProvider.getApplicationContext<Context>()
val db = androidx.room.Room.inMemoryDatabaseBuilder(context, AppDatabase::class.java)
.allowMainThreadQueries()
.setQueryExecutor { it.run() }
.setTransactionExecutor { it.run() }
.build()
val dao = db.maintenanceDao()
kotlinx.coroutines.runBlocking {
dao.clearAllActivities()
dao.clearAllHistory()
dao.clearAllFindings()
// 1. Create active activity OS-100 and OS-200
val act1 = com.example.data.model.MaintenanceActivity(
numeroOs = "OS-100", descricao = "Tarefa 100", setor = "Mecânica", equipe = "Mecânica",
recurso = "Eng 1", dataInicio = "01/08/2026", dataFim = "02/08/2026", percentualExecucao = 50, synced = true
)
dao.insertActivity(act1)
// 2. Insert synced history for OS-999 (which is stale/removed remotely)
val staleSyncedHistory = com.example.data.model.OSUpdateHistory(
numeroOs = "OS-999", timestamp = 1000L, percentualAnterior = 0, percentualNovo = 50,
observacao = "Histórico antigo sincronizado", recurso = "Eng 1", synced = true
)
dao.insertHistory(staleSyncedHistory)
// 3. Insert unsynced history for OS-100 (pending offline change created by user)
val offlinePendingHistory = com.example.data.model.OSUpdateHistory(
numeroOs = "OS-100", timestamp = 2000L, percentualAnterior = 50, percentualNovo = 100,
observacao = "Histórico novo offline", recurso = "Eng 1", synced = false
)
dao.insertHistory(offlinePendingHistory)
// 4. Insert synced finding for OS-999 (stale) and unsynced finding for OS-100 (pending)
val staleSyncedFinding = com.example.data.model.OSFinding(
id = "finding-stale", numeroOs = "OS-999", tipo = "OBS", descricao = "Achado antigo",
timestamp = 1000L, responsavel = "Eng 1", synced = true
)
val offlinePendingFinding = com.example.data.model.OSFinding(
id = "finding-offline", numeroOs = "OS-100", tipo = "OBS", descricao = "Achado novo offline",
timestamp = 2000L, responsavel = "Eng 1", synced = false
)
dao.insertFinding(staleSyncedFinding)
dao.insertFinding(offlinePendingFinding)
// Verify initial state before epoch purge
assertEquals(2, dao.getAllHistoryList().size)
assertEquals(2, dao.getAllFindingsList().size)
assertEquals(1, dao.getUnsyncedHistory().size)
// 5. Execute Epoch purge (deleteAllSyncedHistory and deleteAllSyncedFindings)
dao.deleteAllSyncedHistory()
dao.deleteAllSyncedFindings()
// 6. Verify that ALL synced entries (OS-999) were purged, while unsynced entries (OS-100) were preserved
val historyAfterPurge = dao.getAllHistoryList()
assertEquals(1, historyAfterPurge.size)
assertEquals("OS-100", historyAfterPurge.first().numeroOs)
assertEquals(false, historyAfterPurge.first().synced)
val findingsAfterPurge = dao.getAllFindingsList()
assertEquals(1, findingsAfterPurge.size)
assertEquals("OS-100", findingsAfterPurge.first().numeroOs)
assertEquals(false, findingsAfterPurge.first().synced)
// 7. Test marking history as synced
val unsyncedHist = historyAfterPurge.first()
dao.markHistorySyncedByOsAndTimestamp(unsyncedHist.numeroOs, unsyncedHist.timestamp)
val historyFinal = dao.getAllHistoryList()
assertEquals(true, historyFinal.first().synced)
assertEquals(0, dao.getUnsyncedHistory().size)
} }
db.close()
} finally {
kotlinx.coroutines.Dispatchers.resetMain()
}
}
@Test
fun `test fetchDatabaseEpoch graceful fallback`() {
val context = ApplicationProvider.getApplicationContext<Context>()
val service = GoogleSheetsSyncService(context)
val epoch = service.fetchDatabaseEpoch()
assertTrue("Epoch default should be >= 1, got $epoch", epoch >= 1)
}
}

View File

@@ -517,7 +517,7 @@ class ExampleUnitTest {
assertEquals("8h", act8h.formattedHoras) assertEquals("8h", act8h.formattedHoras)
assertEquals("12.5h", actDecimal.formattedHoras) assertEquals("12.5h", actDecimal.formattedHoras)
assertEquals("0h", actZero.formattedHoras) assertEquals("96h", actZero.formattedHoras)
val getDisplayDesc = { activity: com.example.data.model.MaintenanceActivity -> val getDisplayDesc = { activity: com.example.data.model.MaintenanceActivity ->
if (activity.quantidadeHoras > 0) "${activity.formattedHoras} - ${activity.descricao}" else activity.descricao if (activity.quantidadeHoras > 0) "${activity.formattedHoras} - ${activity.descricao}" else activity.descricao
@@ -527,6 +527,187 @@ class ExampleUnitTest {
assertEquals("12.5h - SOLDA EIXO", getDisplayDesc(actDecimal)) assertEquals("12.5h - SOLDA EIXO", getDisplayDesc(actDecimal))
assertEquals("INSPEÇÃO", getDisplayDesc(actZero)) assertEquals("INSPEÇÃO", getDisplayDesc(actZero))
} }
@Test
fun testResolvePhotoModelRelativePaths() {
val resolveFn = { path: String ->
com.example.ui.screens.resolvePhotoModel(path)
}
// 1. Standard relative path
val stdRel = "photos/OS_OS-1503/OS_OS-1503_1786022754485.jpg"
val res1 = resolveFn(stdRel)
assertTrue(res1.startsWith("https://firebasestorage.googleapis.com"))
assertTrue(res1.contains("photos%2FOS_OS-1503%2FOS_OS-1503_1786022754485.jpg"))
// 2. Relative path with leading slash
val slashRel = "/photos/OS_OS-1503/OS_OS-1503_1786022754485.jpg"
val res2 = resolveFn(slashRel)
assertTrue(res2.startsWith("https://firebasestorage.googleapis.com"))
assertTrue(res2.contains("photos%2FOS_OS-1503%2FOS_OS-1503_1786022754485.jpg"))
// 3. Encoded relative path
val encRel = "photos%2FOS_OS-1503%2FOS_OS-1503_1786022754485.jpg"
val res3 = resolveFn(encRel)
assertTrue(res3.startsWith("https://firebasestorage.googleapis.com"))
assertTrue(res3.contains("photos%2FOS_OS-1503%2FOS_OS-1503_1786022754485.jpg"))
// 4. Folder relative path without "photos/" prefix
val folderRel = "OS_OS-1503/OS_OS-1503_1786022754485.jpg"
val res4 = resolveFn(folderRel)
assertTrue(res4.startsWith("https://firebasestorage.googleapis.com"))
assertTrue(res4.contains("photos%2FOS_OS-1503%2FOS_OS-1503_1786022754485.jpg"))
// 5. Direct HTTP/HTTPS URL
val directUrl = "https://firebasestorage.googleapis.com/v0/b/gestao-parada-os.firebasestorage.app/o/photos%2FOS_OS-1503.jpg?alt=media"
assertEquals(directUrl, resolveFn(directUrl))
}
@Test
fun testPhotoConcatenationPipeSeparator() {
val photo1 = "photos/OS_OS-1503/photo1.jpg"
val photo2 = "photos/OS_OS-1503/photo2.jpg"
val combined = listOf(photo1, photo2).distinct().joinToString("|")
assertEquals("photos/OS_OS-1503/photo1.jpg|photos/OS_OS-1503/photo2.jpg", combined)
val splitBack = combined.split("|").map { it.trim() }
assertEquals(2, splitBack.size)
assertEquals(photo1, splitBack[0])
assertEquals(photo2, splitBack[1])
}
@Test
fun testGalleryPhotosFromFindingsOnly() {
val activityPhoto = "photos/OS_OS-100/activity_photo.jpg"
val findingPhoto1 = "photos/OS_OS-100/finding_photo1.jpg"
val findingPhoto2 = "photos/OS_OS-100/finding_photo2.jpg"
val findings = listOf(
com.example.data.model.OSFinding(
id = "f1", numeroOs = "OS-100", tipo = "OBS", descricao = "Obs 1",
responsavel = "Resp", fotoPath = "$findingPhoto1|$findingPhoto2"
)
)
// Extract photos EXCLUSIVELY from findings (achados sheet)
val extractActivePhotos = { findingsList: List<com.example.data.model.OSFinding> ->
val list = mutableListOf<String>()
findingsList.forEach { finding ->
finding.fotoPath?.split("|")?.forEach { p ->
val trimmed = p.trim()
if (trimmed.isNotBlank() && !trimmed.contains("_DELETED") && !list.contains(trimmed)) {
list.add(trimmed)
}
}
}
list
}
val photos = extractActivePhotos(findings)
assertEquals(2, photos.size)
assertFalse(photos.contains(activityPhoto))
assertTrue(photos.contains(findingPhoto1))
assertTrue(photos.contains(findingPhoto2))
}
@Test
fun testFotoFindingTypeAndConsolidation() {
val photoFinding = com.example.data.model.OSFinding(
id = "f_photo_1",
numeroOs = "OS-1136",
tipo = "FOTO",
descricao = "Foto anexada",
responsavel = "Jhony",
fotoPath = "photos/OS_OS-1136/photo1.jpg|photos/OS_OS-1136/photo2.jpg"
)
assertEquals("FOTO", photoFinding.tipo)
assertEquals("Foto", com.example.data.model.FindingType.fromValue(photoFinding.tipo).displayName)
assertTrue(photoFinding.fotoPath!!.contains("photo1.jpg"))
assertTrue(photoFinding.fotoPath!!.contains("photo2.jpg"))
}
@Test
fun testOnDemandPhotoFileNameParsing() {
val rawPath = "photos/OS_OS-2108/OS_OS-2108_1786031136680.jpg"
val cleanPath = rawPath.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true)
val fileName = cleanPath.substringAfterLast("/").substringAfterLast("\\")
assertEquals("OS_OS-2108_1786031136680.jpg", fileName)
}
@Test
fun testAchadosSheetPhotoRegistrationAndCleaning() {
val cleanToStoragePath = { pathStr: String?, defaultOsNumber: String ->
if (pathStr.isNullOrBlank()) null
else {
val items = pathStr.split("|").map { item ->
val trimmed = item.trim()
if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
val clean = trimmed.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true)
if (clean.contains("/o/")) {
clean.substringAfter("/o/").trim('/')
} else if (clean.contains("photos/")) {
"photos/" + clean.substringAfter("photos/")
} else {
trimmed
}
} else if (trimmed.startsWith("/")) {
val clean = trimmed.substringBefore("?").substringBefore("#").replace("%2F", "/", ignoreCase = true)
val fileName = clean.substringAfterLast("/").substringAfterLast("\\")
.removeSuffix("_DELETED").removeSuffix(".jpg_DELETED").replace("_DELETED", "")
val osFolder = if (fileName.startsWith("OS_")) {
val parts = fileName.split("_")
if (parts.size >= 2) "${parts[0]}_${parts[1]}" else "OS_$defaultOsNumber"
} else if (defaultOsNumber.isNotBlank()) {
val osSanitized = defaultOsNumber.replace("/", "_").replace(" ", "")
"OS_$osSanitized"
} else {
"OS_Geral"
}
"photos/$osFolder/$fileName"
} else if (trimmed.startsWith("OS_") && trimmed.contains("/")) {
"photos/$trimmed"
} else {
trimmed
}
}
items.distinct().joinToString("|").ifEmpty { null }
}
}
val filterRemoteOnlyPhotoPaths = { pathStr: String?, defaultOsNumber: String ->
if (pathStr.isNullOrBlank()) ""
else {
val cleaned = cleanToStoragePath(pathStr, defaultOsNumber) ?: ""
cleaned.split("|")
.map { it.trim() }
.filter { it.isNotBlank() && !it.endsWith("_DELETED") && !it.contains("_DELETED") }
.distinct()
.joinToString("|")
}
}
// 1. Absolute local file path before upload (taken on device)
val localAbsolutePath = "/data/user/0/com.aistudio.gestaoparadaos.xvyzwt/files/os_photos/OS_OS-1503_1786022754485.jpg"
val cleaned1 = filterRemoteOnlyPhotoPaths(localAbsolutePath, "OS-1503")
assertEquals("photos/OS_OS-1503/OS_OS-1503_1786022754485.jpg", cleaned1)
// 2. Relative storage path
val relPath = "photos/OS_OS-1503/OS_OS-1503_1786022754485.jpg"
val cleaned2 = filterRemoteOnlyPhotoPaths(relPath, "OS-1503")
assertEquals("photos/OS_OS-1503/OS_OS-1503_1786022754485.jpg", cleaned2)
// 3. Full Firebase HTTP URL with token
val fullUrl = "https://firebasestorage.googleapis.com/v0/b/gestao-parada-os.firebasestorage.app/o/photos%2FOS_OS-1503%2FOS_OS-1503_1786022754485.jpg?alt=media&token=xyz"
val cleaned3 = filterRemoteOnlyPhotoPaths(fullUrl, "OS-1503")
assertEquals("photos/OS_OS-1503/OS_OS-1503_1786022754485.jpg", cleaned3)
// 4. Combined pipe separated local and relative photo paths
val combinedRaw = "$localAbsolutePath | photos/OS_OS-1503/photo2.jpg"
val cleanedCombined = filterRemoteOnlyPhotoPaths(combinedRaw, "OS-1503")
assertEquals("photos/OS_OS-1503/OS_OS-1503_1786022754485.jpg|photos/OS_OS-1503/photo2.jpg", cleanedCombined)
}
} }

View File

@@ -0,0 +1,70 @@
package com.example.util
import android.content.Context
import androidx.test.core.app.ApplicationProvider
import com.example.data.model.DeviceAccessInfo
import org.junit.Assert.assertEquals
import org.junit.Assert.assertNotNull
import org.junit.Assert.assertTrue
import org.junit.Test
import org.junit.runner.RunWith
import org.robolectric.RobolectricTestRunner
import org.robolectric.annotation.Config
@RunWith(RobolectricTestRunner::class)
@Config(sdk = [34])
class DeviceUtilsTest {
@Test
fun testGetDeviceId_returnsNonNullString() {
val context = ApplicationProvider.getApplicationContext<Context>()
val deviceId = DeviceUtils.getDeviceId(context)
assertNotNull(deviceId)
assertTrue(deviceId.isNotBlank())
}
@Test
fun testGetDeviceModel_returnsNonEmptyModel() {
val model = DeviceUtils.getDeviceModel()
assertNotNull(model)
assertTrue(model.isNotBlank())
}
@Test
fun testGetAndroidVersion_containsAndroidAndApi() {
val version = DeviceUtils.getAndroidVersion()
assertNotNull(version)
assertTrue(version.contains("Android"))
assertTrue(version.contains("API"))
}
@Test
fun testGetAppVersion_returnsValidString() {
val context = ApplicationProvider.getApplicationContext<Context>()
val appVersion = DeviceUtils.getAppVersion(context)
assertNotNull(appVersion)
assertTrue(appVersion.isNotBlank())
}
@Test
fun testDeviceAccessInfo_instantiation() {
val info = DeviceAccessInfo(
deviceId = "test-device-id-123",
dispositivo = "Pixel 8 Pro",
email = "teste@empresa.com",
nomeUsuario = "Usuario Teste",
versaoAndroid = "Android 14 (API 34)",
versaoApp = "1.1.0 (v2)",
ultimoAcesso = "2026-08-06 12:00:00",
statusSincronizacao = "Sucesso"
)
assertEquals("test-device-id-123", info.deviceId)
assertEquals("Pixel 8 Pro", info.dispositivo)
assertEquals("teste@empresa.com", info.email)
assertEquals("Usuario Teste", info.nomeUsuario)
assertEquals("Android 14 (API 34)", info.versaoAndroid)
assertEquals("1.1.0 (v2)", info.versaoApp)
assertEquals("2026-08-06 12:00:00", info.ultimoAcesso)
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

@@ -69,10 +69,14 @@ A estrutura do código fonte está localizada no pacote `com.example` e é organ
* [`MaintenanceDao.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/local/MaintenanceDao.kt): Consultas locais SQL (queries reativas com `Flow` e operações `suspend`). * [`MaintenanceDao.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/local/MaintenanceDao.kt): Consultas locais SQL (queries reativas com `Flow` e operações `suspend`).
* [`model/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/) * [`model/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/)
* [`MaintenanceActivity.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/MaintenanceActivity.kt): Entidades Room (`MaintenanceActivity`, `OSUpdateHistory`), enumerador `ActivityStatus` e auxiliares de formatação/parsing de data. * [`MaintenanceActivity.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/MaintenanceActivity.kt): Entidades Room (`MaintenanceActivity`, `OSUpdateHistory`), enumerador `ActivityStatus` e auxiliares de formatação/parsing de data.
* [`DeviceAccessInfo.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/model/DeviceAccessInfo.kt): Estrutura de dados contendo detalhes de hardware, software, e-mail do Google SSO e timestamp do último acesso.
* [`remote/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/remote/) * [`remote/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/remote/)
* [`GoogleSheetsSyncService.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/remote/GoogleSheetsSyncService.kt): Serviço de integração HTTP com a API v4 do Google Sheets, englobando serialização JSON (Moshi), autenticação e mapeamento de planilhas. * [`GoogleSheetsSyncService.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/remote/GoogleSheetsSyncService.kt): Serviço de integração HTTP com a API v4 do Google Sheets, englobando serialização JSON (Moshi), autenticação e mapeamento de planilhas (`project`, `history`, `achados`, `usage_history`).
* [`repository/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/repository/) * [`repository/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/repository/)
* [`MaintenanceRepository.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt): Mediador de dados, processamento de planilhas locais (CSV) e algoritmo central de reconciliação de estado. * [`MaintenanceRepository.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt): Mediador de dados, processamento de planilhas locais (CSV) e algoritmo central de reconciliação de estado.
* `util/` (Utilitários)
* [`DeviceUtils.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/util/DeviceUtils.kt): Utilitário de extração de metadados do aparelho (`ANDROID_ID`, modelo, versão do Android e versão do app).
* [`TimeGuardManager.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/util/TimeGuardManager.kt): Validador de hora do sistema e prevenção de data retroativa.
* `ui/` (Camada de Apresentação) * `ui/` (Camada de Apresentação)
* [`components/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/components/) * [`components/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/components/)
* [`AppLogo.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/components/AppLogo.kt): Logotipo customizado desenhado via Canvas vetorial utilizando cores da marca. * [`AppLogo.kt`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/components/AppLogo.kt): Logotipo customizado desenhado via Canvas vetorial utilizando cores da marca.
@@ -115,20 +119,66 @@ Representa o estado atualizado de uma Ordem de Serviço (OS).
* `1%` a `99%` -> `ActivityStatus.EM_ANDAMENTO` ("Em andamento") * `1%` a `99%` -> `ActivityStatus.EM_ANDAMENTO` ("Em andamento")
* `100%` -> `ActivityStatus.CONCLUIDO` ("Concluído") * `100%` -> `ActivityStatus.CONCLUIDO` ("Concluído")
### 3.2. Entidade: `OSUpdateHistory` (Tabela: `os_update_history`) ### 3.3. Entidade: `OSFinding` (Tabela: `os_findings`)
Armazena a trilha detalhada de atualizações aplicadas a cada OS. É o elemento fundamental para o sincronismo transacional. Armazena os achados ativos e observações vinculados a cada OS. É a fonte exclusiva para a galeria de fotos do aplicativo.
| Campo | Tipo | Chave | Descrição | | Campo | Tipo | Chave | Descrição |
| :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- |
| `id` | `Long` | Primária (Auto) | Identificador sequencial do log. | | `id` | `String` | Primária | UUID único do achado. |
| `numeroOs` | `String` | - | Relaciona o registro à OS correspondente. | | `numeroOs` | `String` | Indexado | Código da OS associada. |
| `timestamp` | `Long` | - | Data/hora exata em que o log foi registrado. | | `tipo` | `String` | Indexado | Tipo: `"FOTO"`, `"OBS"`, `"SEGURANCA"` ou `"MANUTENCAO"`. |
| `percentualAnterior`| `Int` | - | Progresso antes do salvamento da alteração. | | `descricao` | `String` | - | Descrição técnica do achado ou "Foto anexada". |
| `percentualNovo` | `Int` | - | Novo progresso cadastrado pelo usuário. | | `timestamp` | `Long` | - | Timestamp UNIX de criação/edição. |
| `observacao` | `String?` | - | Observação descritiva inserida no momento da atualização. | | `responsavel` | `String` | - | Nome do responsável pela inclusão. |
| `fotoPath` | `String?` | - | Foto de evidência vinculada a este incremento de progresso. | | `emailEditor` | `String?` | - | E-mail do usuário editor no Google SSO. |
| `recurso` | `String` | - | Identificação do responsável que executou a modificação. | | `fotoPath` | `String?` | - | Caminhos de foto concatenados por `\|`. |
| `emailEditor` | `String?` | - | Email da conta do Google do usuário editor (auditoria). | | `synced` | `Boolean` | Indexado | `true` se sincronizado com a aba `achados` do Google Sheets. |
> **Tipo Exclusivo FOTO**: Registros de foto possuem `tipo = "FOTO"`. Cada OS possui no máximo 1 linha de `tipo = "FOTO"` com todas as fotos ativas da OS concatenadas por `|`.
### 3.4. Entidade: `AppLog` (Tabela: `app_logs`)
Registra falhas, avisos e exceções de sistema exibidos na tela de **Configurações -> Histórico de Logs de Diagnóstico**.
| Campo | Tipo | Chave | Descrição |
| :--- | :--- | :--- | :--- |
| `id` | `Long` | Primária (Auto) | ID sequencial do log. |
| `timestamp` | `Long` | - | Timestamp da ocorrência. |
| `level` | `String` | - | `"INFO"`, `"WARN"`, `"ERROR"`. |
| `tag` | `String` | - | Tag do componente de origem (ex: `PhotoDisplayError`). |
| `message` | `String` | - | Mensagem descritiva. |
| `stackTrace` | `String?` | - | Rastreamento detalhado da exceção. |
### 3.5. Entidade: `SyncConflictLog` (Tabela: `sync_conflict_logs`)
Registra desvios e consolidações ocorridas durante a reconciliação de dados com o Google Sheets.
| Campo | Tipo | Chave | Descrição |
| :--- | :--- | :--- | :--- |
| `id` | `Long` | Primária (Auto) | ID do log de conflito. |
| `numeroOs` | `String` | - | Código da OS afetada. |
| `timestamp` | `Long` | - | Timestamp UNIX da ocorrência. |
| `fieldName` | `String` | - | Campo afetado (ex: `percentualExecucao`). |
| `localValue` | `String` | - | Valor salvo no aparelho local. |
| `remoteValue` | `String` | - | Valor recebido do Google Sheets. |
| `resolvedValue` | `String` | - | Valor final consolidado. |
| `resolutionStrategy` | `String` | - | Estratégia aplicada (ex: `LWW_LOCAL_WIN`). |
### 3.6. Entidade: `UserAccess` (Tabela: `user_access`)
Gerencia o nível de acesso e permissões das contas de usuário autenticadas no aplicativo.
| Campo | Tipo | Chave | Descrição |
| :--- | :--- | :--- | :--- |
| `email` | `String` | Primária | E-mail do usuário da conta Google. |
| `nivelAcesso` | `String` | - | Permissão: `"ADMIN"`, `"ENCO"` ou `"VISUALIZADOR"`. |
| `lastUpdated` | `Long` | - | Timestamp da atualização de acesso. |
### 3.7. Entidade: `AppConfig` (Tabela: `app_config`)
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`, `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. |
--- ---

View File

@@ -109,7 +109,14 @@ Para expandir o aplicativo de sua estrutura atual de tela única ("Single Screen
* *Recurso:* Formulário para alterar dinamicamente o ID da Planilha Google Sheets ativa. * *Recurso:* Formulário para alterar dinamicamente o ID da Planilha Google Sheets ativa.
* *Recurso:* Status de cota e conexão da API do Google, permitindo testar credenciais em tempo real. * *Recurso:* Status de cota e conexão da API do Google, permitindo testar credenciais em tempo real.
* *Recurso:* Console para forçar limpezas na base SQLite ou exportar backup do banco de dados local. * *Recurso:* Console para forçar limpezas na base SQLite ou exportar backup do banco de dados local.
5. **Módulo de Simulação de Data do Sistema (`SettingsScreen` / `DateSimulationSection`):** 5. **Tela de Informações Importantes (`ImportantInfoScreen`):**
* *Navegação:* Acessível via barra inferior (`NavigationBar`), posicionada à **esquerda** do botão Dashboard (**Informações | Dashboard | Ordens | Configurações**).
* *Recurso:* Exibe 3 links dinâmicos sincronizados da aba `config` da planilha online (Google Sheets):
1. **Link1**: RDS (Relato de Segurança)
2. **Link2**: Informações de Privacidade do APP
3. **Link3**: Termos de Uso do APP
* *Recurso:* Possui modo offline-first (exibindo os links armazenados no banco local Room), botão de atualização manual dos links da planilha e acionamento direto via navegador web nativo.
6. **Módulo de Simulação de Data do Sistema (`SettingsScreen` / `DateSimulationSection`):**
* *Recurso:* Painel com controle de permissão por **Nível Total**. Permite escolher a data simulada (Material3 `DatePickerDialog`) e o modo (*Somente Visualização* vs *Edição do Progresso das Ordens*). * *Recurso:* Painel com controle de permissão por **Nível Total**. Permite escolher a data simulada (Material3 `DatePickerDialog`) e o modo (*Somente Visualização* vs *Edição do Progresso das Ordens*).
* *Recurso:* Possui encerramento automático após **15 minutos** de simulação contínua e exibe banner de alerta no topo do Dashboard indicando a data simulada, modo ativo e ação de desativação rápida. * *Recurso:* Possui encerramento automático após **15 minutos** de simulação contínua e exibe banner de alerta no topo do Dashboard indicando a data simulada, modo ativo e ação de desativação rápida.

View File

@@ -1,127 +1,265 @@
# Documentação do Fluxo de Dados e Sincronização do Aplicativo # Documentação do Fluxo de Dados, Salvamento e Sincronização
Esta documentação resume as conversas e análises técnicas sobre o fluxo de dados, o armazenamento local, o mecanismo de sincronização e o planejamento de um banco de dados remoto baseado no Google Sheets para o aplicativo de manutenção. Esta documentação detalha a arquitetura **offline-first**, a estrutura completa da base de dados local (Room SQLite) e remota (Google Sheets / Firebase Storage), além do fluxo detalhado de salvamento de informações e download de mídias sob demanda.
--- ---
## 1. Fluxo de Dados e Armazenamento Atual ## 1. Visão Geral da Arquitetura de Dados
### Como o fluxo está desenhado? O aplicativo adota o padrão **MVVM (Model-View-ViewModel)** com **Repository Pattern** e filosofia **Offline-First**:
O aplicativo adota uma arquitetura **offline-first** (local prioritário) baseada no padrão **MVVM (Model-View-ViewModel)** com **Repository Pattern**:
1. **Camada de UI (Jetpack Compose):** A tela `MaintenanceDashboardScreen.kt` reage às mudanças de estado expostas pelo `MaintenanceViewModel.kt`.
2. **ViewModel (`MaintenanceViewModel.kt`):** Gerencia o fluxo de estados (UI State) utilizando `StateFlow` e lida com ações do usuário (filtragem, atualização de progresso, importação de CSV, disparo de sincronização).
3. **Repository (`MaintenanceRepository.kt`):** Atua como a fonte única de verdade (Single Source of Truth), mediando o acesso aos dados entre a UI e a persistência local (e futuramente a remota).
4. **Banco de Dados Local (Room - `AppDatabase.kt` / `MaintenanceDao.kt`):** Toda leitura e escrita de dados de ordens de serviço (OS) acontece primeiro no banco local (SQLite) do dispositivo.
``` ```
+--------------------------+ +-------------------------------------------------------+
| UI (Jetpack Compose) | | UI (Jetpack Compose) |
+------------+-------------+ | - MaintenanceDashboardScreen |
| (Observa fluxos / dispara eventos) | - EditActivityBottomSheet (Modal da OS) |
+--------------------------+----------------------------+
| Observa StateFlow / Dispara Ações
v v
+--------------------------+ +-------------------------------------------------------+
| MaintenanceViewModel | | MaintenanceViewModel |
+------------+-------------+ | - Gerencia estados da interface e busca |
| (Dispara lógica de negócio) | - Valida níveis de acesso (Google SSO) |
+--------------------------+----------------------------+
| Executa Lógica de Negócio
v v
+--------------------------+ +-------------------------------------------------------+
| MaintenanceRepository | | MaintenanceRepository |
+------------+-------------+ | - Fonte Única de Verdade (Single Source of Truth) |
| (Acessa dados locais) | - Orquestra gravação local e sync com nuvem |
v +-------------------+-------------------+---------------+
+--------------------------+ | |
| Room Database (Local DB) | Gravação | | Sincronização
+--------------------------+ Local v v Remota
+-----------------------+ +---------------------------+
| Room DB (SQLite) | | Google Sheets API v4 |
| - maintenance_activities | - Aba 'project' (Leitura) |
| - os_update_history | | - Aba 'history' (Audit) |
| - os_findings | | - Aba 'achados' (Linhas) |
| - app_logs | | - Aba 'usage_history' (Rastreamento)|
| - sync_conflict_logs | +---------------------------+
| - user_access | | Firebase Storage SDK |
+-----------------------+ | - Bucket de fotos / mídias|
+---------------------------+
``` ```
### Como funciona o armazenamento? ---
O armazenamento é realizado por meio do **Room Database**, que é uma camada de abstração sobre o **SQLite** nativo do Android.
* O arquivo do banco de dados local (`maintenance_db`) é salvo no diretório privado do aplicativo dentro do armazenamento interno do aparelho: `/data/data/com.example/databases/maintenance_db`.
### Múltiplos usuários conseguem acessar a mesma base de dados diretamente? ## 2. Estrutura Completa da Base de Dados
**Não.** Por ser um banco de dados **local e interno ao dispositivo**, o arquivo SQLite é isolado e privado para a instância do aplicativo instalada naquele smartphone/tablet específico.
* Dois usuários rodando o aplicativo em celulares diferentes possuem bases de dados 100% distintas e isoladas. O aplicativo utiliza o **Room Database** (`AppDatabase.kt`) sobre o SQLite interno no dispositivo (`/data/data/com.example/databases/maintenance_db`). A estrutura engloba 6 tabelas principais:
* Para que múltiplos usuários compartilhem e visualizem os mesmos dados de manutenção, é **indispensável** implementar um servidor centralizado (ou um banco de dados na nuvem, como Google Sheets, Firebase, PostgreSQL, etc.) e um fluxo de sincronização bidirecional.
### 2.1. Tabela: `maintenance_activities` (Ordens de Serviço Ativas)
Armazena a lista principal das Ordens de Serviço (OS) de manutenção da planta.
| Campo | Tipo | Chave | Descrição / Regras |
| :--- | :--- | :--- | :--- |
| **`numeroOs`** | `String` | Primária | Código de identificação único da OS (ex: `OS-1503`). |
| **`descricao`** | `String` | - | Descrição técnica do trabalho de manutenção. |
| **`setor`** | `String` | - | Setor industrial da fábrica (ex: `EXTRAÇÃO`, `CALDEIRA`). |
| **`equipe`** | `String` | - | Disciplina responsável (ex: `Mecânica`, `Elétrica`). |
| **`recurso`** | `String` | - | Nome do inspetor ou encarregado atual. |
| **`dataInicio`** | `String` | - | Data planejada/real de início (ex: `01/07/2026`). |
| **`dataFim`** | `String` | - | Data planejada de conclusão. |
| **`percentualExecucao`** | `Int` | - | Progresso medido de `0` a `100`%. |
| **`observacoes`** | `String?` | - | Texto do comentário ou observação mais recente. |
| **`fotoPath`** | `String?` | - | Evidência fotográfica vinculada à atividade. |
| **`synced`** | `Boolean` | - | `true` se sincronizado com Google Sheets, `false` se pendente. |
| **`lastUpdated`** | `Long` | - | Timestamp UNIX (milissegundos) da última edição. |
--- ---
## 2. Análise da Sincronização Remota ### 2.2. Tabela: `os_findings` (Achados, Fotos e Observações)
Armazena os achados ativos associados a cada OS. É a **fonte exclusiva da galeria de fotos** do aplicativo.
### A sincronização remota está real e funcionalmente implementada? | Campo | Tipo | Chave | Descrição / Regras |
**Sim, a sincronização é REAL e BIDIRECIONAL.** O aplicativo utiliza a **Google Sheets API v4** (`GoogleSheetsSyncService.kt`) para sincronizar a estrutura do projeto e logs de alteração, e o **Firebase Storage SDK** (`FirebaseStorageSyncService.kt`) para upload de fotos das OSs no Firebase Storage. | :--- | :--- | :--- | :--- |
| **`id`** | `String` | Primária | Identificador único (UUID). |
| **`numeroOs`** | `String` | Indexado | Código da OS relacionada. |
| **`tipo`** | `String` | Indexado | Tipo do registro: `"FOTO"`, `"OBS"`, `"SEGURANCA"` ou `"MANUTENCAO"`. |
| **`descricao`** | `String` | - | Descrição do achado ou `"Foto anexada"`. |
| **`timestamp`** | `Long` | - | Timestamp UNIX da criação/edição. |
| **`responsavel`** | `String` | - | Nome do responsável pela gravação. |
| **`emailEditor`** | `String?` | - | E-mail da conta do Google do editor. |
| **`fotoPath`** | `String?` | - | Caminhos de fotos relativos ou locais concatenados por `\|`. |
| **`synced`** | `Boolean` | Indexado | Status de sincronização com a aba `achados` no Google Sheets. |
### Como o fluxo de sincronização e envio de fotos funciona? > **Regra do Tipo Exclusivo `FOTO`**: Cada OS possui no máximo **1 registro ativo** de `tipo = "FOTO"` na tabela `os_findings` e na aba `achados` do Google Sheets. Todas as fotos daquela OS são concatenadas na coluna `fotoPath` com o caractere `|` (ex: `photos/OS_OS-1136/photo1.jpg|photos/OS_OS-1136/photo2.jpg`).
1. **Captura, Suporte HEIC e Compactação Local (Offline-First):** As fotos capturadas pela Câmera ou selecionadas da Galeria (nos formatos JPEG, PNG ou HEIC/HEIF) são processadas pelo `ImageCompressor.kt`. O app decodifica a imagem, corrige a orientação EXIF, reduz a resolução para no máximo 1920x1920 px se necessário, e compacta iterativamente para garantir tamanho final **<= 500 KB**. O arquivo resultante é armazenado em `filesDir/os_photos/` e registrado no Room DB.
2. **Upload Único para o Firebase Storage:** Durante a sincronização, o `MaintenanceRepository.kt` lê as fotos pendentes locais e aciona o `FirebaseStorageSyncService.kt`. Fotos que já possuem URL remota (`http://` ou `https://`) são ignoradas, garantindo que cada foto seja enviada apenas uma vez. As fotos pendentes são enviadas com trava de segurança de 500KB para a pasta `photos/OS_{numeroOs}/`.
3. **URL de Download e Sincronismo com Google Sheets:** O serviço obtém a `downloadUrl` do Firebase Storage, atualizando a Room DB. Ao reconciliar os históricos (`remoteHistory + localHistory`), o sistema prioriza as URLs remotas em relação a caminhos locais desatualizados, refletindo o link público na aba `history` do Google Sheets.
4. **Download Inteligente com Re-tentativas Automáticas (Retry & Cache):** Para garantir a exibição de fotos em ambientes de campo com oscilações de rede, o aplicativo utiliza o Coil configurado via `MainApplication.kt` com um `RetryInterceptor` customizado no OkHttp. Caso um download falhe por instabilidade de rede ou erro temporário do servidor, o app executa **até 3 tentativas** com **intervalo aleatório (jitter)** de 300ms a 1000ms. Fotos baixadas com sucesso são gravadas em um cache em disco dedicado de **50 MB** (`cacheDir/image_cache`), permitindo visualização offline instantânea de até ~100 fotos de 500KB.
5. **Soft Delete e Consistência Local:** A exclusão de fotos executa um Soft Delete no Firebase Storage (adicionando o sufixo `_DELETED` ao arquivo) e atualiza incrementalmente os registros das tabelas `MaintenanceActivity`, `OSUpdateHistory` e `OSFinding` no Room DB local. A sincronização respeita a marcação `_DELETED` local, impedindo que fotos deletadas reapareçam.
6. **Registro de Falhas no Histórico de Logs (`AppLogger`):** Todas as falhas de sincronização, erros de envio no Firebase e falhas no download de fotos (após o limite de 3 re-tentativas) são automaticamente registradas pelo `AppLogger.kt` na tabela `AppLog` do Room DB e ficam acessíveis para consulta na aba **Histórico de Logs** da tela de **Configurações**.
7. **Controle de Acesso para Usuários Sem Login:** Usuários não autenticados via conta do Google têm acesso exclusivamente à visualização dos dados. Ações de edição de progresso, alteração de observações, inclusão/edição/exclusão de Achados e exclusão de fotos de campo são bloqueadas na UI e validadas no `MaintenanceViewModel.kt`.
### Arquivos responsáveis pela conexão, sincronização e exibição de fotos:
* **`com.example.MainApplication`:** Configura o `ImageLoaderFactory` do Coil, interceptor OkHttp de retries automáticos com delay aleatório (300-1000ms), cache em memória (25% RAM) e cache em disco (50MB).
* **`com.example.util.AppLogger`:** Gerencia o registro persistente de logs de auditoria (WARN, ERROR, INFO) exibidos no painel da tela de Configurações.
* **`com.example.util.ImageCompressor`:** Utilitário responsável pelo decodificação de HEIC/HEIF/JPEG/PNG, rotação EXIF e compactação garantida de imagens para até 500KB.
* **`com.example.data.remote.FirebaseStorageSyncService`:** Gerencia upload seguro de fotos (com trava de 500KB) e soft delete no Firebase Storage.
* **`com.example.data.remote.GoogleSheetsSyncService`:** Gerencia autenticação via Service Account e reconciliação bidirecional com a planilha central do Google Sheets.
* **`com.example.data.repository.MaintenanceRepository`:** Centraliza a orquestração do sync, upload de mídias pendentes sem reenvios duplicados, resolução de conflitos (LWW) e soft delete.
* **`com.example.ui.viewmodel.MaintenanceViewModel`:** Gerencia os estados de sync na UI, disparos assíncronos, validação de permissões de acesso e callbacks de gerenciamento de fotos.
--- ---
## 3. Estruturação para Integração com Google Sheets (Futuro) ### 2.3. Tabela: `os_update_history` (Log de Transações de Auditoria)
Registra o histórico cronológico de cada atualização efetuada por usuários em uma OS.
Se você decidir usar o **Google Sheets** como seu banco de dados remoto centralizado para permitir que múltiplos dispositivos acessem e sincronizem os mesmos dados, você precisará criar uma planilha no Google Drive com **duas abas (worksheets)** principais para refletir a estrutura de dados atual do aplicativo. | Campo | Tipo | Chave | Descrição / Regras |
| :--- | :--- | :--- | :--- |
| **`id`** | `Long` | Primária (Auto) | Identificador sequencial do log. |
| **`numeroOs`** | `String` | - | Código da OS alterada. |
| **`timestamp`** | `Long` | - | Data/hora exata em milissegundos. |
| **`percentualAnterior`** | `Int` | - | Progresso antes da edição. |
| **`percentualNovo`** | `Int` | - | Progresso informado pelo usuário. |
| **`observacao`** | `String?` | - | Texto da observação ou tag de auditoria. |
| **`fotoPath`** | `String?` | - | Fotos anexadas nesta atualização. |
| **`recurso`** | `String` | - | Responsável pela ação. |
| **`emailEditor`** | `String?` | - | E-mail do usuário autenticado no Google. |
Abaixo está o mapeamento exato de tabelas e colunas que você deve configurar no seu Google Sheets: ---
### Tabela/Aba 1: `activities` (Ordens de Serviço de Manutenção) ### 2.4. Tabela: `app_logs` (Histórico de Diagnostic Log)
Esta aba armazenará a lista de todas as ordens de serviço ativas na planta. Armazena registros de log e exceções de sistema exibidos na tela de **Configurações -> Histórico de Logs de Diagnóstico**.
| Nome da Coluna (Cabeçalho da Coluna A, B, C...) | Tipo Sugerido | Descrição / Observações | | Campo | Tipo | Chave | Descrição / Regras |
| :--- | :--- | :--- | | :--- | :--- | :--- | :--- |
| **`numeroOs`** | Texto (Chave Primária) | Ex: `OS-4010`. Deve ser único nesta tabela. | | **`id`** | `Long` | Primária (Auto) | ID do log. |
| **`descricao`** | Texto | Descrição detalhada da atividade de manutenção. | | **`timestamp`** | `Long` | - | Data/hora da ocorrência. |
| **`setor`** | Texto | Setor da fábrica (ex: `Preparação`, `Extração`, `Caldeira`, `Refinaria`, `Envase`). | | **`level`** | `String` | - | Nível de severidade: `"INFO"`, `"WARN"`, `"ERROR"`. |
| **`equipe`** | Texto | Equipe técnica responsável (ex: `Mecânica`, `Elétrica`, `Confiabilidade`, `Lubrificação`). | | **`tag`** | `String` | - | Tag de origem (ex: `PhotoDisplayError`, `FirebaseStorageSync`). |
| **`responsavel`** | Texto | Nome do técnico ou encarregado responsável pela atividade. | | **`message`** | `String` | - | Mensagem descritiva da falha ou evento. |
| **`dataInicio`** | Texto ou Data | Data programada para o início (ex: `30/06/2026`). | | **`stackTrace`** | `String?` | - | Rastreamento da pilha de exceções em falhas. |
| **`dataFim`** | Texto ou Data | Data programada para conclusão (ex: `02/07/2026`). |
| **`percentualExecucao`** | Número Inteiro | Progresso de execução de 0 a 100. |
| **`observacoes`** | Texto (Opcional) | Comentários, notas adicionais ou relato de anomalias encontradas. |
| **`fotoPath`** | Texto (URL) | **Importante:** O Sheets não armazena arquivos binários diretamente na célula de forma eficiente. O aplicativo deve fazer upload da foto para um servidor de arquivos ou pasta pública do **Google Drive**, e armazenar o **link direto da imagem (URL)** nesta coluna. |
| **`lastUpdated`** | Número Inteiro (Long) | Timestamp Unix em milissegundos (ex: `1783965742000`). Essencial para saber qual dispositivo fez a alteração mais recente e evitar perda de dados. |
### Tabela/Aba 2: `history` (Histórico de Auditoria das OS e Achados) ---
Esta aba registrará cada alteração feita em qualquer OS (avanços de progresso, observações e alterações/exclusões em Achados), permitindo auditoria detalhada de quem alterou e quando.
| Nome da Coluna | Tipo Sugerido | Descrição / Observações | ### 2.5. Tabela: `sync_conflict_logs` (Histórico de Conflitos de Sincronização)
| :--- | :--- | :--- | Registra eventos de desvio ou resolução de conflitos ocorridos na sincronização com o Sheets.
| **`id`** | Texto ou Número | Identificador único da linha do histórico. |
| **`numeroOs`** | Texto | Código da OS atualizada. |
| **`timestamp`** | Número Inteiro (Long) | Timestamp Unix em milissegundos. |
| **`percentualAnterior`** | Número Inteiro | Progresso anterior da OS. |
| **`percentualNovo`** | Número Inteiro | Novo progresso da OS. |
| **`observacao`** | Texto (Opcional) | Detalhamento do evento, incluindo marcações auditadas como `"[Achado de Segurança Criado] ..."`, `"[Achado de Manutenção Excluído] ..."`. |
| **`fotoPath`** | Texto (URL) | Link da foto anexa. |
| **`responsavel`** | Texto | Nome do responsável pela ação. |
| **`email_editor`** | Texto | E-mail do usuário autenticado no Google que realizou a ação. |
### Tabela/Aba 3: `achados` (Achados de Segurança, Manutenção e Observações Ativas) | Campo | Tipo | Chave | Descrição |
Esta aba armazena os registros ativos de Achados de Segurança, Achados de Manutenção e a Última Observação associados a cada OS. | :--- | :--- | :--- | :--- |
| **`id`** | `Long` | Primária (Auto) | ID do evento de conflito. |
| **`numeroOs`** | `String` | - | OS afetada. |
| **`timestamp`** | `Long` | - | Timestamp da ocorrência. |
| **`fieldName`** | `String` | - | Campo afetado (ex: `percentualExecucao`). |
| **`localValue`** | `String` | - | Valor salvo no dispositivo. |
| **`remoteValue`** | `String` | - | Valor recebido do Google Sheets. |
| **`resolvedValue`**| `String` | - | Valor consolidado aplicado. |
| **`resolutionStrategy`** | `String` | - | Estratégia de resolução (ex: `LWW_LOCAL_WIN`). |
| Nome da Coluna | Tipo Sugerido | Descrição / Observações | ---
| :--- | :--- | :--- |
| **`id`** | Texto (UUID) | Identificador exclusivo do achado. |
| **`numeroOs`** | Texto | Código da OS relacionada. |
| **`tipo`** | Texto | Tipo do registro: `"OBS"`, `"SEGURANCA"` ou `"MANUTENCAO"`. |
| **`descricao`** | Texto | Texto descritivo do achado ou observação. |
| **`timestamp`** | Número Inteiro (Long) | Data/hora de criação ou alteração. |
| **`responsavel`** | Texto | Nome do responsável pelo registro. |
| **`email_editor`** | Texto | E-mail do editor autenticado. |
| **`fotoPath`** | Texto (URL) | Link de foto vinculada ao achado (opcional). |
> **Nota de Exclusão Física**: Quando um usuário exclui um achado ativo no app, o registro é fisicamente removido do Room e da aba `achados` no Google Sheets. No entanto, o evento de exclusão permanece registrado na aba `history` para fins de auditoria inalterável. ### 2.6. Tabela: `user_access` (Controle de Acesso de Usuários)
Armazena o nível de permissão associado aos e-mails cadastrados.
| Campo | Tipo | Chave | Descrição |
| :--- | :--- | :--- | :--- |
| **`email`** | `String` | Primária | E-mail da conta Google. |
| **`nivelAcesso`** | `String` | - | Nível de acesso: `"ADMIN"`, `"ENCO"` ou `"VISUALIZADOR"`. |
| **`lastUpdated`** | `Long` | - | Timestamp da atualização de acesso. |
---
### 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`, `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**:
> - 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.1. Passos no Salvamento Local (Offline-First)
1. **Edição do Usuário na Interface (`EditActivityBottomSheet`)**:
- O usuário seleciona o progresso de execução (0-100%), edita observações e captura/anexa novas fotos na galeria da OS.
- Aciona o botão **Salvar Atualizações**.
2. **Processamento e Compactação de Fotos (`ImageCompressor.kt`)**:
- As fotos capturadas pela câmera ou selecionadas da galeria (formatos JPEG, PNG, HEIC/HEIF) são processadas.
- O aplicativo decodifica a foto, corrige a rotação baseando-se nos metadados EXIF, redimensiona se maior que 1920x1920 px e compacta com garantia de tamanho final **<= 500 KB**.
- A foto é salva no armazenamento interno do aplicativo (`filesDir/os_photos/OS_{numeroOs}_{timestamp}.jpg`).
3. **Gravação Transacional no Room Database (`MaintenanceRepository.kt`)**:
- **`maintenance_activities`**: Atualiza o percentual, a observação e altera o status para `synced = false`.
- **`os_findings`**: Busca se a OS já possui um achado de `tipo = "FOTO"`.
- Se existir: mescla o novo caminho com os caminhos anteriores usando `|` (`mergePreservingDeletedPhotos`), grava `synced = false` e atualiza o registro.
- Se não existir: cria um novo `OSFinding` com `tipo = "FOTO"`, `descricao = "Foto anexada"` e `synced = false`.
- **`os_findings` (Observação)**: Se houver observação de texto, atualiza/cria o achado de `tipo = "OBS"`.
- **`os_update_history`**: Insere uma nova linha de log contendo `percentualAnterior`, `percentualNovo`, `observacao`, `fotoPath`, `recurso` e o `emailEditor`.
---
## 4. Fluxo de Sincronização Remota (Google Sheets & Firebase Storage)
### 4.1. Upload de Mídias ao Firebase Storage (`FirebaseStorageSyncService.kt`)
1. Ao iniciar o sync, `uploadPendingPhotos()` varre os registros de achados com arquivos locais no aparelho (`/data/user/0/.../files/os_photos/OS_...jpg`).
2. Garante o login silencioso no Firebase Auth via `ensureFirebaseAuth()`.
3. Faz o upload seguro da imagem compactada para o bucket na nuvem (`photos/OS_{numeroOs}/OS_{numeroOs}_{timestamp}.jpg`).
4. Obtém a `downloadUrl` oficial contendo o token de acesso (`?alt=media&token=...`), salva em cache de memória (`downloadUrlCache`), e converte o caminho da foto no banco local para o formato relativo normalizado `photos/OS_{numeroOs}/OS_{numeroOs}_{timestamp}.jpg`.
### 4.2. Sincronização com o Google Sheets (`GoogleSheetsSyncService.kt`)
O aplicativo sincroniza com quatro abas da planilha central:
1. **Aba `project` (Leitura Mestra)**: Carrega as ordens de serviço ativas.
2. **Aba `history` (Escrita de Auditoria)**: Envia novos registros da tabela `os_update_history`.
3. **Aba `achados` (Sincronização Bidirecional de Achados e Fotos)**:
- Limpa e converte caminhos de fotos locais para o formato relativo `photos/OS_.../*.jpg` via `cleanToStoragePath`.
- Reconcilia achados remotos e locais preservando alterações pendentes (`synced = false`).
- Agrupa e consolida os registros por `(numeroOs, tipo)` para garantir **no máximo 1 linha por OS com `tipo = "FOTO"`** contendo todas as fotos ativas concatenadas por `|`.
4. **Aba `usage_history` (Rastreamento do Último Acesso por Dispositivo)**:
- Garante que a aba contenha os cabeçalhos: `device_id`, `dispositivo`, `email`, `nome_usuario`, `versao_android`, `versao_app`, `ultimo_acesso`, `status_sincronizacao`.
- 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.
### 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)
Para evitar consumo desnecessário de dados móveis e garantir o carregamento correto em múltiplos dispositivos ou após a limpeza de dados do aplicativo:
```
[UI / Galeria de Fotos da OS]
|
v
[rememberResolvedPhotoModel(photoPath)]
|
+---> Arquivo existe em 'filesDir/os_photos/'?
| |
| +--> (SIM) --> Carrega do disco local instantaneamente
| |
| +--> (NÃO) --> Dispara download SOB DEMANDA via Coroutine
| |
| v
| [syncService.downloadPhotoFile(path)]
| |
| v
| [ensureFirebaseAuth()]
| |
| v
| [storageRef.getFile(localFile).await()]
| |
| v
| [Salva em filesDir/os_photos/OS_...jpg]
| |
| v
+<----------------------------+
|
v
[Coil renderiza imagem local sem erro HTTP 403]
```
### Principais Benefícios do Download Sob Demanda:
- **Zero consumo desnecessário**: Fotos só são baixadas quando o usuário realmente abre a galeria da OS.
- **Suporte Múltiplos Celulares**: O segundo celular baixa nativamente a foto via SDK do Firebase Storage e salva no armazenamento local.
- **Resiliência e 100% Offline**: Após visualizada uma vez, a foto fica armazenada no disco local do aparelho, permitindo acesso offline em áreas sem cobertura de rede na fábrica.
- **Eliminação de Erros HTTP 403**: Ao ler a imagem direto do disco local, elimina-se qualquer rejeição de acesso por falta de token nas requisições HTTP REST.