From 2b6ec33837b980b6d8ce275d6256bf2f872ecafd Mon Sep 17 00:00:00 2001 From: Jhony Cesar Date: Wed, 5 Aug 2026 20:35:17 -0400 Subject: [PATCH] feat: implement OSFinding management to support tracking safety, maintenance, and observation findings with automated synchronization. --- .../com/example/data/local/AppDatabase.kt | 5 +- .../com/example/data/local/MaintenanceDao.kt | 33 ++ .../java/com/example/data/model/OSFinding.kt | 38 ++ .../data/remote/GoogleSheetsSyncService.kt | 100 +++++ .../data/repository/MaintenanceRepository.kt | 186 ++++++++- .../ui/screens/MaintenanceDashboardScreen.kt | 377 ++++++++++++++++-- .../ui/viewmodel/MaintenanceViewModel.kt | 86 ++++ .../design/descricao_layout_e_recursos.md | 12 + .../fluxo_de_dados_e_sincronizacao.md | 42 +- 9 files changed, 832 insertions(+), 47 deletions(-) create mode 100644 app/src/main/java/com/example/data/model/OSFinding.kt diff --git a/app/src/main/java/com/example/data/local/AppDatabase.kt b/app/src/main/java/com/example/data/local/AppDatabase.kt index 7542057..57d1ae5 100644 --- a/app/src/main/java/com/example/data/local/AppDatabase.kt +++ b/app/src/main/java/com/example/data/local/AppDatabase.kt @@ -6,13 +6,14 @@ import androidx.room.Room import androidx.room.RoomDatabase import com.example.data.model.AppLog import com.example.data.model.MaintenanceActivity +import com.example.data.model.OSFinding import com.example.data.model.OSUpdateHistory import com.example.data.model.SyncConflictLog import com.example.data.model.UserAccess @Database( - entities = [MaintenanceActivity::class, OSUpdateHistory::class, SyncConflictLog::class, UserAccess::class, AppLog::class], - version = 7, + entities = [MaintenanceActivity::class, OSUpdateHistory::class, SyncConflictLog::class, UserAccess::class, AppLog::class, OSFinding::class], + version = 8, exportSchema = false ) abstract class AppDatabase : RoomDatabase() { diff --git a/app/src/main/java/com/example/data/local/MaintenanceDao.kt b/app/src/main/java/com/example/data/local/MaintenanceDao.kt index 8d0158d..47570a0 100644 --- a/app/src/main/java/com/example/data/local/MaintenanceDao.kt +++ b/app/src/main/java/com/example/data/local/MaintenanceDao.kt @@ -6,6 +6,7 @@ import androidx.room.OnConflictStrategy import androidx.room.Query import androidx.room.Update import com.example.data.model.MaintenanceActivity +import com.example.data.model.OSFinding import com.example.data.model.OSUpdateHistory import com.example.data.model.SyncConflictLog import com.example.data.model.UserAccess @@ -78,4 +79,36 @@ interface MaintenanceDao { @Query("DELETE FROM user_access") suspend fun clearUserAccess() + + // OSFinding Queries + @Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs ORDER BY timestamp DESC") + fun getFindingsForOs(numeroOs: String): Flow> + + @Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs ORDER BY timestamp DESC") + suspend fun getFindingsForOsOneShot(numeroOs: String): List + + @Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs AND tipo = 'OBS' ORDER BY timestamp DESC LIMIT 1") + fun getLatestObservationForOs(numeroOs: String): Flow + + @Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs AND tipo = 'OBS' ORDER BY timestamp DESC LIMIT 1") + suspend fun getLatestObservationForOsOneShot(numeroOs: String): OSFinding? + + @Insert(onConflict = OnConflictStrategy.REPLACE) + suspend fun insertFinding(finding: OSFinding) + + @Insert(onConflict = OnConflictStrategy.REPLACE) + suspend fun insertFindings(findings: List) + + @Query("DELETE FROM os_findings WHERE id = :id") + suspend fun deleteFindingById(id: String) + + @Query("SELECT * FROM os_findings WHERE synced = 0") + suspend fun getUnsyncedFindings(): List + + @Query("SELECT * FROM os_findings") + suspend fun getAllFindingsList(): List + + @Query("DELETE FROM os_findings") + suspend fun clearAllFindings() } + diff --git a/app/src/main/java/com/example/data/model/OSFinding.kt b/app/src/main/java/com/example/data/model/OSFinding.kt new file mode 100644 index 0000000..a292bb6 --- /dev/null +++ b/app/src/main/java/com/example/data/model/OSFinding.kt @@ -0,0 +1,38 @@ +package com.example.data.model + +import androidx.room.Entity +import androidx.room.Index +import androidx.room.PrimaryKey +import java.util.UUID + +@Entity( + tableName = "os_findings", + indices = [ + Index("numeroOs"), + Index("tipo"), + Index("synced") + ] +) +data class OSFinding( + @PrimaryKey val id: String = UUID.randomUUID().toString(), + val numeroOs: String, + val tipo: String, // "OBS", "SEGURANCA", "MANUTENCAO" + val descricao: String, + val timestamp: Long = System.currentTimeMillis(), + val responsavel: String, + val emailEditor: String? = null, + val fotoPath: String? = null, + val synced: Boolean = false +) + +enum class FindingType(val value: String, val displayName: String) { + OBS("OBS", "Observação"), + SEGURANCA("SEGURANCA", "Achado de Segurança"), + MANUTENCAO("MANUTENCAO", "Achado de Manutenção"); + + companion object { + fun fromValue(value: String): FindingType { + return values().firstOrNull { it.value.equals(value, ignoreCase = true) } ?: OBS + } + } +} diff --git a/app/src/main/java/com/example/data/remote/GoogleSheetsSyncService.kt b/app/src/main/java/com/example/data/remote/GoogleSheetsSyncService.kt index c5b91c7..403d9da 100644 --- a/app/src/main/java/com/example/data/remote/GoogleSheetsSyncService.kt +++ b/app/src/main/java/com/example/data/remote/GoogleSheetsSyncService.kt @@ -849,4 +849,104 @@ class GoogleSheetsSyncService( } return accessList } + + /** + * Fetches all remote findings from the 'achados' sheet. + */ + fun fetchRemoteFindingsList(): List { + val defaultHeaders = listOf( + "id", "numeroOs", "tipo", "descricao", "timestamp", "responsavel", "email_editor", "fotoPath" + ) + ensureHeaders("achados", defaultHeaders) + + val rows = fetchValues("achados!A:H") + val findingsList = mutableListOf() + if (rows.size <= 1) return findingsList + + val headers = rows[0].map { it.trim().lowercase() } + val idIdx = headers.indexOf("id") + val osIdx = headers.indexOf("numeroos") + val tipoIdx = headers.indexOf("tipo") + val descIdx = headers.indexOf("descricao") + val tsIdx = headers.indexOf("timestamp") + val respIdx = headers.indexOf("responsavel") + val emailIdx = headers.indexOf("email_editor") + val fotoIdx = headers.indexOf("fotopath") + + val getCell = { row: List, mapIdx: Int, fallbackIdx: Int -> + val idx = if (mapIdx != -1) mapIdx else fallbackIdx + if (idx < row.size) row[idx].trim() else "" + } + + for (i in 1 until rows.size) { + val row = rows[i] + val id = getCell(row, idIdx, 0) + val os = getCell(row, osIdx, 1) + if (id.isBlank() || os.isBlank()) continue + + val tipo = getCell(row, tipoIdx, 2).ifBlank { "OBS" } + val desc = getCell(row, descIdx, 3) + val tsStr = getCell(row, tsIdx, 4) + val ts = tsStr.toLongOrNull() ?: System.currentTimeMillis() + val resp = getCell(row, respIdx, 5) + val email = getCell(row, emailIdx, 6).takeIf { it.isNotBlank() } + val foto = getCell(row, fotoIdx, 7).takeIf { it.isNotBlank() } + + findingsList.add( + com.example.data.model.OSFinding( + id = id, + numeroOs = os, + tipo = tipo, + descricao = desc, + timestamp = ts, + responsavel = resp, + emailEditor = email, + fotoPath = foto, + synced = true + ) + ) + } + return findingsList + } + + /** + * Rewrites/syncs the active findings list to the 'achados' sheet. + */ + fun syncFindingsWithSheet(allActiveFindings: List) { + val defaultHeaders = listOf( + "id", "numeroOs", "tipo", "descricao", "timestamp", "responsavel", "email_editor", "fotoPath" + ) + ensureHeaders("achados", defaultHeaders) + + val existingRows = fetchValues("achados!A:H") + val currentRemoteRowCount = if (existingRows.size > 1) existingRows.size - 1 else 0 + + val newRows = allActiveFindings.map { finding -> + listOf( + finding.id, + finding.numeroOs, + finding.tipo, + finding.descricao, + finding.timestamp.toString(), + finding.responsavel, + finding.emailEditor ?: "", + finding.fotoPath ?: "" + ) + }.toMutableList() + + // Pad with empty rows to physically overwrite/clear deleted rows in Google Sheets + if (currentRemoteRowCount > newRows.size) { + val emptyRow = List(8) { "" } + repeat(currentRemoteRowCount - newRows.size) { + newRows.add(emptyRow) + } + } + + if (newRows.isNotEmpty()) { + val endRow = newRows.size + 1 + updateValues("achados!A2:H$endRow", newRows) + Log.d(tag, "Successfully updated 'achados' sheet with ${allActiveFindings.size} active findings.") + } + } } + diff --git a/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt b/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt index 8d804d1..38ab667 100644 --- a/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt +++ b/app/src/main/java/com/example/data/repository/MaintenanceRepository.kt @@ -4,6 +4,7 @@ import android.content.Context import android.net.Uri import com.example.data.local.MaintenanceDao import com.example.data.model.MaintenanceActivity +import com.example.data.model.OSFinding import com.example.data.model.OSUpdateHistory import com.example.data.model.GoogleUser import com.example.data.model.SyncConflictLog @@ -44,6 +45,10 @@ class MaintenanceRepository( fun getHistoryForOs(numeroOs: String): Flow> = dao.getHistoryForOs(numeroOs) + fun getFindingsForOs(numeroOs: String): Flow> = dao.getFindingsForOs(numeroOs) + + fun getLatestObservationForOs(numeroOs: String): Flow = dao.getLatestObservationForOs(numeroOs) + suspend fun getUserAccess(email: String): UserAccess? = withContext(Dispatchers.IO) { dao.getUserAccess(email) } @@ -53,7 +58,7 @@ class MaintenanceRepository( } /** - * Updates progress of an OS, auto-generates a history record, and marks as unsynced (offline-first). + * Updates progress of an OS, auto-generates a history record, updates observation finding, and marks as unsynced. */ suspend fun updateProgress( numeroOs: String, @@ -73,10 +78,30 @@ class MaintenanceRepository( val currentActivity = dao.getActivityByOsOneShot(numeroOs) ?: return@withContext val effectiveTimestamp = customTimestampMillis ?: System.currentTimeMillis() + + // Handle observation update as an OSFinding of type OBS if filled + val cleanObs = observacao?.trim().takeIf { !it.isNullOrBlank() } + if (cleanObs != null) { + val existingObs = dao.getLatestObservationForOsOneShot(numeroOs) + val findingObs = OSFinding( + id = existingObs?.id ?: java.util.UUID.randomUUID().toString(), + numeroOs = numeroOs, + tipo = "OBS", + descricao = cleanObs, + timestamp = effectiveTimestamp, + responsavel = recurso, + emailEditor = emailEditor, + fotoPath = fotoPath, + synced = false + ) + dao.insertFinding(findingObs) + } + + val latestObsText = cleanObs ?: currentActivity.observacoes val updatedActivity = currentActivity.copy( percentualExecucao = novoPercentual.coerceIn(0, 100), - observacoes = observacao ?: currentActivity.observacoes, + observacoes = latestObsText, fotoPath = fotoPath ?: currentActivity.fotoPath, synced = false, // Must sync later lastUpdated = effectiveTimestamp @@ -90,7 +115,7 @@ class MaintenanceRepository( timestamp = effectiveTimestamp, percentualAnterior = currentActivity.percentualExecucao, percentualNovo = novoPercentual, - observacao = observacao, + observacao = if (cleanObs != null) "[Observação Atualizada] $cleanObs" else null, fotoPath = fotoPath, recurso = recurso, emailEditor = emailEditor @@ -98,6 +123,148 @@ class MaintenanceRepository( dao.insertHistory(historyEntry) } + /** + * Adds a new Achado (Segurança, Manutenção, ou Observação) and logs audit entry in history. + */ + suspend fun addFinding( + numeroOs: String, + tipo: String, + descricao: String, + recurso: String, + emailEditor: String?, + fotoPath: String? = null + ) = withContext(Dispatchers.IO) { + val effectiveTimestamp = System.currentTimeMillis() + val finding = OSFinding( + numeroOs = numeroOs, + tipo = tipo, + descricao = descricao.trim(), + timestamp = effectiveTimestamp, + responsavel = recurso, + emailEditor = emailEditor, + fotoPath = fotoPath, + synced = false + ) + dao.insertFinding(finding) + + val currentActivity = dao.getActivityByOsOneShot(numeroOs) + if (tipo == "OBS" && currentActivity != null) { + dao.updateActivity( + currentActivity.copy( + observacoes = descricao.trim(), + synced = false, + lastUpdated = effectiveTimestamp + ) + ) + } + + val tagHeader = when (tipo) { + "SEGURANCA" -> "[Achado de Segurança Criado]" + "MANUTENCAO" -> "[Achado de Manutenção Criado]" + else -> "[Observação Criada]" + } + + val historyEntry = OSUpdateHistory( + numeroOs = numeroOs, + timestamp = effectiveTimestamp, + percentualAnterior = currentActivity?.percentualExecucao ?: 0, + percentualNovo = currentActivity?.percentualExecucao ?: 0, + observacao = "$tagHeader ${descricao.trim()}", + fotoPath = fotoPath, + recurso = recurso, + emailEditor = emailEditor + ) + dao.insertHistory(historyEntry) + } + + /** + * Updates an existing Achado and logs audit entry in history. + */ + suspend fun updateFinding( + finding: OSFinding, + recurso: String, + emailEditor: String? + ) = withContext(Dispatchers.IO) { + val effectiveTimestamp = System.currentTimeMillis() + val updatedFinding = finding.copy( + timestamp = effectiveTimestamp, + synced = false + ) + dao.insertFinding(updatedFinding) + + val currentActivity = dao.getActivityByOsOneShot(finding.numeroOs) + if (finding.tipo == "OBS" && currentActivity != null) { + dao.updateActivity( + currentActivity.copy( + observacoes = finding.descricao.trim(), + synced = false, + lastUpdated = effectiveTimestamp + ) + ) + } + + val tagHeader = when (finding.tipo) { + "SEGURANCA" -> "[Achado de Segurança Editado]" + "MANUTENCAO" -> "[Achado de Manutenção Editado]" + else -> "[Observação Editada]" + } + + val historyEntry = OSUpdateHistory( + numeroOs = finding.numeroOs, + timestamp = effectiveTimestamp, + percentualAnterior = currentActivity?.percentualExecucao ?: 0, + percentualNovo = currentActivity?.percentualExecucao ?: 0, + observacao = "$tagHeader ${finding.descricao.trim()}", + fotoPath = finding.fotoPath, + recurso = recurso, + emailEditor = emailEditor + ) + dao.insertHistory(historyEntry) + } + + /** + * Physically deletes an Achado and logs audit entry of deletion in history. + */ + suspend fun deleteFinding( + finding: OSFinding, + recurso: String, + emailEditor: String? + ) = withContext(Dispatchers.IO) { + val effectiveTimestamp = System.currentTimeMillis() + dao.deleteFindingById(finding.id) + + val currentActivity = dao.getActivityByOsOneShot(finding.numeroOs) + if (finding.tipo == "OBS" && currentActivity != null) { + val latestRemainingObs = dao.getLatestObservationForOsOneShot(finding.numeroOs) + dao.updateActivity( + currentActivity.copy( + observacoes = latestRemainingObs?.descricao, + synced = false, + lastUpdated = effectiveTimestamp + ) + ) + } + + val tagHeader = when (finding.tipo) { + "SEGURANCA" -> "[Achado de Segurança Excluído]" + "MANUTENCAO" -> "[Achado de Manutenção Excluído]" + else -> "[Observação Excluída]" + } + + val historyEntry = OSUpdateHistory( + numeroOs = finding.numeroOs, + timestamp = effectiveTimestamp, + percentualAnterior = currentActivity?.percentualExecucao ?: 0, + percentualNovo = currentActivity?.percentualExecucao ?: 0, + observacao = "$tagHeader ${finding.descricao.trim()}", + fotoPath = null, + recurso = recurso, + emailEditor = emailEditor + ) + dao.insertHistory(historyEntry) + } + + // Persist login state fun getSavedUser(): GoogleUser? { val prefs = context.getSharedPreferences("google_auth_prefs", Context.MODE_PRIVATE) @@ -400,6 +567,19 @@ class MaintenanceRepository( sheetsSyncService.pushHistoryToSheet(historyToUpload) android.util.Log.d("MaintenanceRepository", "Uploaded ${historyToUpload.size} new local history logs to Google Sheet.") } + + // 10. Sync 'achados' sheet with local OSFinding database + try { + val remoteFindings = sheetsSyncService.fetchRemoteFindingsList() + if (remoteFindings.isNotEmpty()) { + dao.insertFindings(remoteFindings) + } + val allLocalActiveFindings = dao.getAllFindingsList() + sheetsSyncService.syncFindingsWithSheet(allLocalActiveFindings) + android.util.Log.d("MaintenanceRepository", "Synced ${allLocalActiveFindings.size} active findings with Google Sheet.") + } catch (e: Exception) { + android.util.Log.e("MaintenanceRepository", "Falha ao sincronizar aba achados", e) + } SyncResult.Success( syncedItems = reconciledActivities.size, diff --git a/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt b/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt index 6ce0f74..c4ba0b0 100644 --- a/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt +++ b/app/src/main/java/com/example/ui/screens/MaintenanceDashboardScreen.kt @@ -96,6 +96,7 @@ fun MaintenanceDashboardScreen( val internetAvailable by viewModel.internetAvailable.collectAsStateWithLifecycle() val selectedActivity by viewModel.selectedActivity.collectAsStateWithLifecycle() val selectedActivityHistory by viewModel.selectedActivityHistory.collectAsStateWithLifecycle() + val selectedActivityFindings by viewModel.selectedActivityFindings.collectAsStateWithLifecycle() val currentUser by viewModel.currentUser.collectAsStateWithLifecycle() val userAccessLevel by viewModel.userAccessLevel.collectAsStateWithLifecycle() val simulationConfig by viewModel.simulationConfig.collectAsStateWithLifecycle() @@ -600,6 +601,7 @@ fun MaintenanceDashboardScreen( EditActivityBottomSheet( activity = selectedActivity!!, history = selectedActivityHistory, + findings = selectedActivityFindings, currentUser = currentUser, userAccessLevel = userAccessLevel, onDismiss = { @@ -616,6 +618,15 @@ fun MaintenanceDashboardScreen( emailEditor = currentUser?.email ) }, + onAddFinding = { tipo, desc -> + viewModel.addFinding(selectedActivity!!.numeroOs, tipo, desc) + }, + onUpdateFinding = { finding -> + viewModel.updateFinding(finding) + }, + onDeleteFinding = { finding -> + viewModel.deleteFinding(finding) + }, onSavePhotoFromUri = { uri -> viewModel.saveLocalPhotoFromUri(uri, selectedActivity!!.numeroOs) }, @@ -1226,10 +1237,14 @@ fun FullscreenPhotoViewerDialog( fun EditActivityBottomSheet( activity: MaintenanceActivity, history: List, + findings: List = emptyList(), currentUser: com.example.data.model.GoogleUser?, userAccessLevel: String?, onDismiss: () -> Unit, onUpdateProgress: (Int, String, String?) -> Unit, + onAddFinding: (String, String) -> Unit = { _, _ -> }, + onUpdateFinding: (com.example.data.model.OSFinding) -> Unit = {}, + onDeleteFinding: (com.example.data.model.OSFinding) -> Unit = {}, onSavePhotoFromUri: (Uri) -> String, onCreateCameraUri: () -> Pair, onSoftDeletePhoto: (String) -> Unit, @@ -1239,6 +1254,11 @@ fun EditActivityBottomSheet( val keyboardController = LocalSoftwareKeyboardController.current val isImeVisible = WindowInsets.isImeVisible + var showFindingDialog by remember { mutableStateOf(false) } + var dialogTipo by remember { mutableStateOf("SEGURANCA") } + var findingText by remember { mutableStateOf("") } + var activeFindingForDialog by remember { mutableStateOf(null) } + Dialog( onDismissRequest = onDismiss, properties = DialogProperties(usePlatformDefaultWidth = false) @@ -1397,6 +1417,39 @@ fun EditActivityBottomSheet( } } + // Latest Observation Display Card (if present) + val latestObsText = activity.observacoes ?: findings.find { it.tipo == "OBS" }?.descricao + if (!latestObsText.isNullOrBlank()) { + Card( + colors = CardDefaults.cardColors(containerColor = Color(0xFFF3E5F5)), + border = BorderStroke(1.dp, Color(0xFFE1BEE7)), + shape = RoundedCornerShape(8.dp), + modifier = Modifier.fillMaxWidth() + ) { + Row( + modifier = Modifier.padding(10.dp), + verticalAlignment = Alignment.CenterVertically, + horizontalArrangement = Arrangement.spacedBy(8.dp) + ) { + Icon(Icons.Default.Comment, contentDescription = "Última Observação", tint = Color(0xFF6A1B9A), modifier = Modifier.size(18.dp)) + Column(modifier = Modifier.weight(1f)) { + Text( + text = "Última Observação da OS:", + fontSize = 10.sp, + fontWeight = FontWeight.Bold, + color = Color(0xFF6A1B9A) + ) + Text( + text = latestObsText, + fontSize = 12.sp, + fontWeight = FontWeight.Medium, + color = BrandBlack + ) + } + } + } + } + // Slider Progress Update Panel Column(verticalArrangement = Arrangement.spacedBy(4.dp)) { Row( @@ -1422,12 +1475,12 @@ fun EditActivityBottomSheet( value = progressValue, onValueChange = { progressValue = it }, valueRange = 0f..100f, - steps = 19, // Splits in 5% increments for rapid tactile field logging + steps = 19, // 5% increments + enabled = currentUser != null, colors = SliderDefaults.colors( thumbColor = if (progressValue >= 100) BrandGreen else StatusBlue, activeTrackColor = if (progressValue >= 100) BrandGreen else StatusBlue - ), - enabled = currentUser != null + ) ) // Quick jump buttons for field speed @@ -1468,7 +1521,7 @@ fun EditActivityBottomSheet( // Text Observation Entry Column(verticalArrangement = Arrangement.spacedBy(6.dp)) { Text( - text = "Observações de Campo", + text = "Nova Observação de Campo", fontWeight = FontWeight.Bold, fontSize = 14.sp, color = BrandBlack @@ -1487,8 +1540,137 @@ fun EditActivityBottomSheet( ) } + // 🛡️ Achados de Segurança Section + Column(verticalArrangement = Arrangement.spacedBy(8.dp)) { + HorizontalDivider(color = Color(0xFFF1F1F1)) + Row( + modifier = Modifier.fillMaxWidth(), + horizontalArrangement = Arrangement.SpaceBetween, + verticalAlignment = Alignment.CenterVertically + ) { + Row( + verticalAlignment = Alignment.CenterVertically, + horizontalArrangement = Arrangement.spacedBy(6.dp) + ) { + Icon(Icons.Default.Security, contentDescription = "Segurança", tint = Color(0xFFD84315), modifier = Modifier.size(18.dp)) + Text( + text = "Achados de Segurança (${findings.count { it.tipo == "SEGURANCA" }})", + fontWeight = FontWeight.Bold, + fontSize = 14.sp, + color = BrandBlack + ) + } + if (currentUser != null) { + OutlinedButton( + onClick = { + activeFindingForDialog = null + dialogTipo = "SEGURANCA" + findingText = "" + showFindingDialog = true + }, + contentPadding = PaddingValues(horizontal = 8.dp, vertical = 4.dp), + modifier = Modifier.height(32.dp) + ) { + Icon(Icons.Default.Add, contentDescription = "Adicionar Achado", modifier = Modifier.size(14.dp)) + Spacer(modifier = Modifier.width(4.dp)) + Text("Novo Achado", fontSize = 11.sp) + } + } + } + + val segurancaFindings = findings.filter { it.tipo == "SEGURANCA" } + if (segurancaFindings.isEmpty()) { + Text( + text = "Nenhum achado de segurança registrado para esta OS.", + fontSize = 11.sp, + color = Color.Gray + ) + } else { + Column(verticalArrangement = Arrangement.spacedBy(6.dp)) { + segurancaFindings.forEach { finding -> + FindingItemCard( + finding = finding, + canEdit = currentUser != null, + onEdit = { + activeFindingForDialog = finding + dialogTipo = finding.tipo + findingText = finding.descricao + showFindingDialog = true + }, + onDelete = { onDeleteFinding(finding) } + ) + } + } + } + } + + // 🔧 Achados de Manutenção Section + Column(verticalArrangement = Arrangement.spacedBy(8.dp)) { + HorizontalDivider(color = Color(0xFFF1F1F1)) + Row( + modifier = Modifier.fillMaxWidth(), + horizontalArrangement = Arrangement.SpaceBetween, + verticalAlignment = Alignment.CenterVertically + ) { + Row( + verticalAlignment = Alignment.CenterVertically, + horizontalArrangement = Arrangement.spacedBy(6.dp) + ) { + Icon(Icons.Default.Build, contentDescription = "Manutenção", tint = Color(0xFF0277BD), modifier = Modifier.size(18.dp)) + Text( + text = "Achados de Manutenção (${findings.count { it.tipo == "MANUTENCAO" }})", + fontWeight = FontWeight.Bold, + fontSize = 14.sp, + color = BrandBlack + ) + } + if (currentUser != null) { + OutlinedButton( + onClick = { + activeFindingForDialog = null + dialogTipo = "MANUTENCAO" + findingText = "" + showFindingDialog = true + }, + contentPadding = PaddingValues(horizontal = 8.dp, vertical = 4.dp), + modifier = Modifier.height(32.dp) + ) { + Icon(Icons.Default.Add, contentDescription = "Adicionar Achado", modifier = Modifier.size(14.dp)) + Spacer(modifier = Modifier.width(4.dp)) + Text("Novo Achado", fontSize = 11.sp) + } + } + } + + val manutencaoFindings = findings.filter { it.tipo == "MANUTENCAO" } + if (manutencaoFindings.isEmpty()) { + Text( + text = "Nenhum achado de manutenção registrado para esta OS.", + fontSize = 11.sp, + color = Color.Gray + ) + } else { + Column(verticalArrangement = Arrangement.spacedBy(6.dp)) { + manutencaoFindings.forEach { finding -> + FindingItemCard( + finding = finding, + canEdit = currentUser != null, + onEdit = { + activeFindingForDialog = finding + dialogTipo = finding.tipo + findingText = finding.descricao + showFindingDialog = true + }, + onDelete = { onDeleteFinding(finding) } + ) + } + } + } + } + // Photo Attachment & Horizontal Gallery Section Column(verticalArrangement = Arrangement.spacedBy(8.dp)) { + HorizontalDivider(color = Color(0xFFF1F1F1)) Row( modifier = Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.SpaceBetween, @@ -1759,6 +1941,56 @@ fun EditActivityBottomSheet( } } + // Dialog for Adding / Editing Finding + if (showFindingDialog) { + AlertDialog( + onDismissRequest = { showFindingDialog = false }, + title = { + Text( + text = if (activeFindingForDialog == null) "Novo Achado de ${if (dialogTipo == "SEGURANCA") "Segurança" else "Manutenção"}" else "Editar Achado", + fontWeight = FontWeight.Bold, + fontSize = 16.sp + ) + }, + text = { + Column(verticalArrangement = Arrangement.spacedBy(8.dp)) { + OutlinedTextField( + value = findingText, + onValueChange = { findingText = it }, + placeholder = { Text("Descreva os detalhes do achado...", fontSize = 13.sp) }, + modifier = Modifier + .fillMaxWidth() + .height(100.dp), + maxLines = 4 + ) + } + }, + confirmButton = { + Button( + onClick = { + if (findingText.isNotBlank()) { + if (activeFindingForDialog == null) { + onAddFinding(dialogTipo, findingText.trim()) + } else { + onUpdateFinding(activeFindingForDialog!!.copy(descricao = findingText.trim())) + } + showFindingDialog = false + } + }, + enabled = findingText.isNotBlank(), + colors = ButtonDefaults.buttonColors(containerColor = BrandGreen) + ) { + Text("Salvar") + } + }, + dismissButton = { + TextButton(onClick = { showFindingDialog = false }) { + Text("Cancelar") + } + } + ) + } + // Chronological Audit Timeline Log / History Section Column(verticalArrangement = Arrangement.spacedBy(8.dp)) { HorizontalDivider(color = Color(0xFFF1F1F1)) @@ -1802,6 +2034,59 @@ fun EditActivityBottomSheet( } } +@Composable +fun FindingItemCard( + finding: com.example.data.model.OSFinding, + canEdit: Boolean, + onEdit: () -> Unit, + onDelete: () -> Unit +) { + Card( + modifier = Modifier.fillMaxWidth(), + colors = CardDefaults.cardColors( + containerColor = if (finding.tipo == "SEGURANCA") Color(0xFFFFF3E0) else Color(0xFFE0F7FA) + ), + border = BorderStroke( + 1.dp, + if (finding.tipo == "SEGURANCA") Color(0xFFFFCC80) else Color(0xFF80DEEA) + ), + shape = RoundedCornerShape(8.dp) + ) { + Row( + modifier = Modifier + .fillMaxWidth() + .padding(10.dp), + horizontalArrangement = Arrangement.SpaceBetween, + verticalAlignment = Alignment.CenterVertically + ) { + Column(modifier = Modifier.weight(1f)) { + Text( + text = finding.descricao, + fontSize = 12.sp, + fontWeight = FontWeight.Medium, + color = BrandBlack + ) + Spacer(modifier = Modifier.height(2.dp)) + Text( + text = "Por: ${finding.responsavel}", + fontSize = 10.sp, + color = StatusGrey + ) + } + if (canEdit) { + Row(horizontalArrangement = Arrangement.spacedBy(4.dp)) { + IconButton(onClick = onEdit, modifier = Modifier.size(28.dp)) { + Icon(Icons.Default.Edit, contentDescription = "Editar", tint = StatusBlue, modifier = Modifier.size(16.dp)) + } + IconButton(onClick = onDelete, modifier = Modifier.size(28.dp)) { + Icon(Icons.Default.Delete, contentDescription = "Excluir", tint = Color.Red, modifier = Modifier.size(16.dp)) + } + } + } + } + } +} + @Composable fun TimelineLogItem(log: OSUpdateHistory) { val dateStr = remember(log.timestamp) { @@ -1809,11 +2094,19 @@ fun TimelineLogItem(log: OSUpdateHistory) { sdf.format(Date(log.timestamp)) } + val obs = log.observacao ?: "" + val (typeLabel, icon, chipColor, containerColor) = when { + obs.contains("[Achado de Segurança") -> Quadruple("Achado de Segurança", Icons.Default.Security, Color(0xFFD84315), Color(0xFFFBE9E7)) + obs.contains("[Achado de Manutenção") -> Quadruple("Achado de Manutenção", Icons.Default.Build, Color(0xFF0277BD), Color(0xFFE1F5FE)) + obs.contains("[Observação") -> Quadruple("Observação", Icons.Default.Comment, Color(0xFF6A1B9A), Color(0xFFF3E5F5)) + else -> Quadruple("Progresso", Icons.Default.Speed, StatusBlue, Color(0xFFE3F2FD)) + } + Card( modifier = Modifier.fillMaxWidth(), colors = CardDefaults.cardColors(containerColor = Color(0xFFFAFAFA)), border = BorderStroke(1.dp, Color(0xFFEEEEEE)), - shape = RoundedCornerShape(6.dp) + shape = RoundedCornerShape(8.dp) ) { Column(modifier = Modifier.padding(10.dp)) { // Header Row: User, timestamp and progress jump @@ -1834,45 +2127,62 @@ fun TimelineLogItem(log: OSUpdateHistory) { color = BrandBlack ) } - Text( - text = dateStr, - fontSize = 10.sp, - color = StatusGrey - ) + + Surface( + color = containerColor, + shape = RoundedCornerShape(12.dp) + ) { + Row( + modifier = Modifier.padding(horizontal = 6.dp, vertical = 2.dp), + verticalAlignment = Alignment.CenterVertically, + horizontalArrangement = Arrangement.spacedBy(3.dp) + ) { + Icon(imageVector = icon, contentDescription = typeLabel, tint = chipColor, modifier = Modifier.size(12.dp)) + Text( + text = typeLabel, + fontSize = 10.sp, + fontWeight = FontWeight.Bold, + color = chipColor + ) + } + } } Spacer(modifier = Modifier.height(4.dp)) - // Progress Jump Badge - Row( - verticalAlignment = Alignment.CenterVertically, - horizontalArrangement = Arrangement.spacedBy(6.dp) - ) { - Text( - text = "Avanço:", - fontSize = 11.sp, - color = StatusGrey - ) - Text( - text = "${log.percentualAnterior}% ➜ ${log.percentualNovo}%", - fontSize = 11.sp, - fontWeight = FontWeight.Black, - color = if (log.percentualNovo >= 100) BrandGreen else StatusBlue - ) + // Progress Jump Badge if progress was altered or if purely progress update + if (log.percentualAnterior != log.percentualNovo || !obs.startsWith("[")) { + Row( + verticalAlignment = Alignment.CenterVertically, + horizontalArrangement = Arrangement.spacedBy(6.dp) + ) { + Text( + text = "Avanço:", + fontSize = 11.sp, + color = StatusGrey + ) + Text( + text = "${log.percentualAnterior}% ➜ ${log.percentualNovo}%", + fontSize = 11.sp, + fontWeight = FontWeight.Black, + color = if (log.percentualNovo >= 100) BrandGreen else StatusBlue + ) + } } // Remarks/Observations if (!log.observacao.isNullOrBlank()) { Spacer(modifier = Modifier.height(4.dp)) + val cleanText = log.observacao.replace(Regex("^\\[[^\\]]+\\]\\s*"), "") Box( modifier = Modifier .fillMaxWidth() - .background(Color(0xFFF1F1F1)) + .background(containerColor) .padding(6.dp) .clip(RoundedCornerShape(4.dp)) ) { Text( - text = "\"${log.observacao}\"", + text = cleanText, fontSize = 11.sp, color = BrandBlack ) @@ -1894,10 +2204,21 @@ fun TimelineLogItem(log: OSUpdateHistory) { Text("Foto Anexa: ${log.fotoPath}", fontSize = 9.sp, color = BrandGreen, fontWeight = FontWeight.Bold) } } + + Text( + text = dateStr, + fontSize = 10.sp, + color = StatusGrey, + modifier = Modifier + .align(Alignment.End) + .padding(top = 4.dp) + ) } } } +private data class Quadruple(val first: A, val second: B, val third: C, val fourth: D) + /** * Importer Console Sheet for loading spreadsheets and managing datasets */ diff --git a/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt b/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt index b6f0769..77b7f96 100644 --- a/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt +++ b/app/src/main/java/com/example/ui/viewmodel/MaintenanceViewModel.kt @@ -327,6 +327,23 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View initialValue = emptyList() ) + // Reactive Flow for the current activity's findings (Achados & Observações) + @OptIn(kotlinx.coroutines.ExperimentalCoroutinesApi::class) + val selectedActivityFindings: StateFlow> = _selectedActivity + .flatMapLatest { activity -> + if (activity != null) { + repository.getFindingsForOs(activity.numeroOs) + } else { + flowOf(emptyList()) + } + } + .stateIn( + scope = viewModelScope, + started = SharingStarted.WhileSubscribed(5000), + initialValue = emptyList() + ) + + init { val savedUser = repository.getSavedUser() _currentUser.value = savedUser @@ -510,6 +527,75 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View } } + fun addFinding( + numeroOs: String, + tipo: String, + descricao: String, + fotoPath: String? = null + ) { + viewModelScope.launch { + val user = _currentUser.value + val recurso = user?.displayName ?: "Encarregado Campo" + val emailEditor = user?.email + try { + repository.addFinding(numeroOs, tipo, descricao, recurso, emailEditor, fotoPath) + _selectedActivity.value?.let { active -> + if (active.numeroOs == numeroOs) { + _selectedActivity.value = allActivitiesState.value.find { it.numeroOs == numeroOs } + } + } + if (_internetAvailable.value) { + syncNow() + } + } catch (e: Exception) { + _syncStatusMessage.value = e.message ?: "Erro ao salvar achado." + } + } + } + + fun updateFinding(finding: com.example.data.model.OSFinding) { + viewModelScope.launch { + val user = _currentUser.value + val recurso = user?.displayName ?: "Encarregado Campo" + val emailEditor = user?.email + try { + repository.updateFinding(finding, recurso, emailEditor) + _selectedActivity.value?.let { active -> + if (active.numeroOs == finding.numeroOs) { + _selectedActivity.value = allActivitiesState.value.find { it.numeroOs == finding.numeroOs } + } + } + if (_internetAvailable.value) { + syncNow() + } + } catch (e: Exception) { + _syncStatusMessage.value = e.message ?: "Erro ao atualizar achado." + } + } + } + + fun deleteFinding(finding: com.example.data.model.OSFinding) { + viewModelScope.launch { + val user = _currentUser.value + val recurso = user?.displayName ?: "Encarregado Campo" + val emailEditor = user?.email + try { + repository.deleteFinding(finding, recurso, emailEditor) + _selectedActivity.value?.let { active -> + if (active.numeroOs == finding.numeroOs) { + _selectedActivity.value = allActivitiesState.value.find { it.numeroOs == finding.numeroOs } + } + } + if (_internetAvailable.value) { + syncNow() + } + } catch (e: Exception) { + _syncStatusMessage.value = e.message ?: "Erro ao excluir achado." + } + } + } + + fun saveLocalPhotoFromUri(uri: Uri, osNumber: String): String { return repository.saveLocalPhotoFromUri(uri, osNumber) } diff --git a/documentacao/design/descricao_layout_e_recursos.md b/documentacao/design/descricao_layout_e_recursos.md index 21f9e6d..26c8a82 100644 --- a/documentacao/design/descricao_layout_e_recursos.md +++ b/documentacao/design/descricao_layout_e_recursos.md @@ -113,9 +113,21 @@ Para expandir o aplicativo de sua estrutura atual de tela única ("Single Screen * *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. +### 3.3. Recursos de Achados e Auditoria Visuais por OS (`EditActivityBottomSheet`) +1. **Banner de Última Observação**: Exibe no topo do modal da OS o texto da última observação registrada (`tipo = "OBS"`). +2. **Seções de Achados de Segurança e Manutenção**: + - **Achados de Segurança (🛡️)**: Card em tom laranja/bege (`#FFF3E0`) permitindo a criação de múltiplos achados por OS, com opções de edição e exclusão física dos itens ativos. + - **Achados de Manutenção (🔧)**: Card em tom azul/turquesa (`#E0F7FA`) permitindo a criação de múltiplos achados de manutenção por OS, com edição e exclusão. +3. **Badges Visualmente Diferenciados no Histórico da OS (`TimelineLogItem`)**: + - 🛡️ **Achado de Segurança**: Badge laranja/vermelho com ícone de escudo. + - 🔧 **Achado de Manutenção**: Badge azul/turquesa com ícone de chave. + - 📝 **Observação**: Badge roxo/cinza com ícone de comentário. + - 📊 **Progresso**: Badge verde/azul indicando alterações percentuais (% anterior ➜ % novo). + ### 3.2. Proposta de Recursos Técnicos para Implementação Visando Complexidade 1. **Câmera Nativa com Upload Real (Firebase Storage), Suporte a HEIC e Compactação (<= 500KB):** * Substituir o simulador de fotos estáticas (`mockPhotos`) por captura real utilizando câmera nativa do Android ou seleção de Galeria (com suporte nativo a HEIC, JPEG e PNG). * As imagens são compactadas pelo `ImageCompressor.kt` para no máximo **500 KB** mantendo excelente qualidade e correção automática de rotação EXIF. As imagens são enviadas de forma única ao Firebase Storage (`photos/OS_{numeroOs}/`) via SDK assíncrono. A URL de download obtida é gravada no campo `fotoPath` no banco local e sincronizada na aba `history` do Sheets. 2. **Sincronização em Segundo Plano Resiliente (WorkManager):** * Substituir o clique manual em "Sincronizar" por um agendador automático em segundo plano que detecta conectividade Wi-Fi e envia logs pendentes sem travar ou exigir ação do inspetor. + diff --git a/documentacao/fluxo_de_dados_e_sincronizacao.md b/documentacao/fluxo_de_dados_e_sincronizacao.md index 2438b40..8cfdc69 100644 --- a/documentacao/fluxo_de_dados_e_sincronizacao.md +++ b/documentacao/fluxo_de_dados_e_sincronizacao.md @@ -89,20 +89,34 @@ Esta aba armazenará a lista de todas as ordens de serviço ativas na planta. | **`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 Atualizações das OS) -Esta aba registrará cada alteração feita em qualquer OS, permitindo auditoria detalhada de quem alterou o progresso e quando. +### 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 (Cabeçalho da Coluna A, B, C...) | Tipo Sugerido | Descrição / Observações | +| Nome da Coluna | Tipo Sugerido | Descrição / Observações | | :--- | :--- | :--- | -| **`id`** | Texto ou Número | Identificador único da linha do histórico (pode ser gerado como UUID no app ou auto-incremento). | -| **`numeroOs`** | Texto | Código da OS que foi atualizada (chave estrangeira relacionada à aba `activities`). | -| **`timestamp`** | Número Inteiro (Long) | Carimbo de data/hora em milissegundos de quando a atualização ocorreu. | -| **`percentualAnterior`** | Número Inteiro | Qual era o progresso antes dessa alteração (ex: `25`). | -| **`percentualNovo`** | Número Inteiro | Qual o novo progresso registrado (ex: `50`). | -| **`observacao`** | Texto (Opcional) | Comentário inserido pelo técnico justificando ou detalhando aquela atualização específica. | -| **`fotoPath`** | Texto (URL) | Link da foto tirada no momento desta atualização (se houver). | -| **`responsavel`** | Texto | Nome do profissional que realizou esta atualização de progresso. | +| **`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) +Esta aba armazena os registros ativos de Achados de Segurança, Achados de Manutenção e a Última Observação associados a cada OS. + +| 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. -### Dicas para a Integração com Google Sheets: -1. **API de Comunicação:** Para conectar o app Android ao Google Sheets, você pode usar uma API REST intermediária feita no **Google Apps Script** (que recebe requisições POST/GET com JSON e escreve na planilha) ou usar diretamente a **Google Sheets API** via bibliotecas HTTP como Retrofit/Ktor. -2. **Resolução de Conflitos (LWW):** Quando o aplicativo sincronizar, ele deve comparar o `lastUpdated` local da OS com o `lastUpdated` presente na linha correspondente da aba `activities` no Sheets. Se o `lastUpdated` do Sheets for mais novo, o aplicativo deve baixar a alteração. Se o `lastUpdated` local for mais novo, o app deve enviar e atualizar a planilha.