feat: implement OSFinding management to support tracking safety, maintenance, and observation findings with automated synchronization.

This commit is contained in:
Jhony Cesar
2026-08-05 20:35:17 -04:00
parent 1cb8578e9b
commit 2b6ec33837
9 changed files with 832 additions and 47 deletions

View File

@@ -6,13 +6,14 @@ import androidx.room.Room
import androidx.room.RoomDatabase import androidx.room.RoomDatabase
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.OSUpdateHistory import com.example.data.model.OSUpdateHistory
import com.example.data.model.SyncConflictLog 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], entities = [MaintenanceActivity::class, OSUpdateHistory::class, SyncConflictLog::class, UserAccess::class, AppLog::class, OSFinding::class],
version = 7, version = 8,
exportSchema = false exportSchema = false
) )
abstract class AppDatabase : RoomDatabase() { abstract class AppDatabase : RoomDatabase() {

View File

@@ -6,6 +6,7 @@ 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.MaintenanceActivity import com.example.data.model.MaintenanceActivity
import com.example.data.model.OSFinding
import com.example.data.model.OSUpdateHistory import com.example.data.model.OSUpdateHistory
import com.example.data.model.SyncConflictLog import com.example.data.model.SyncConflictLog
import com.example.data.model.UserAccess import com.example.data.model.UserAccess
@@ -78,4 +79,36 @@ interface MaintenanceDao {
@Query("DELETE FROM user_access") @Query("DELETE FROM user_access")
suspend fun clearUserAccess() suspend fun clearUserAccess()
// OSFinding Queries
@Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs ORDER BY timestamp DESC")
fun getFindingsForOs(numeroOs: String): Flow<List<OSFinding>>
@Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs ORDER BY timestamp DESC")
suspend fun getFindingsForOsOneShot(numeroOs: String): List<OSFinding>
@Query("SELECT * FROM os_findings WHERE numeroOs = :numeroOs AND tipo = 'OBS' ORDER BY timestamp DESC LIMIT 1")
fun getLatestObservationForOs(numeroOs: String): Flow<OSFinding?>
@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<OSFinding>)
@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<OSFinding>
@Query("SELECT * FROM os_findings")
suspend fun getAllFindingsList(): List<OSFinding>
@Query("DELETE FROM os_findings")
suspend fun clearAllFindings()
} }

View File

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

View File

@@ -849,4 +849,104 @@ class GoogleSheetsSyncService(
} }
return accessList return accessList
} }
/**
* Fetches all remote findings from the 'achados' sheet.
*/
fun fetchRemoteFindingsList(): List<com.example.data.model.OSFinding> {
val defaultHeaders = listOf(
"id", "numeroOs", "tipo", "descricao", "timestamp", "responsavel", "email_editor", "fotoPath"
)
ensureHeaders("achados", defaultHeaders)
val rows = fetchValues("achados!A:H")
val findingsList = mutableListOf<com.example.data.model.OSFinding>()
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<String>, 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<com.example.data.model.OSFinding>) {
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.")
}
}
} }

View File

@@ -4,6 +4,7 @@ import android.content.Context
import android.net.Uri import android.net.Uri
import com.example.data.local.MaintenanceDao import com.example.data.local.MaintenanceDao
import com.example.data.model.MaintenanceActivity import com.example.data.model.MaintenanceActivity
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
@@ -44,6 +45,10 @@ class MaintenanceRepository(
fun getHistoryForOs(numeroOs: String): Flow<List<OSUpdateHistory>> = dao.getHistoryForOs(numeroOs) fun getHistoryForOs(numeroOs: String): Flow<List<OSUpdateHistory>> = dao.getHistoryForOs(numeroOs)
fun getFindingsForOs(numeroOs: String): Flow<List<OSFinding>> = dao.getFindingsForOs(numeroOs)
fun getLatestObservationForOs(numeroOs: String): Flow<OSFinding?> = dao.getLatestObservationForOs(numeroOs)
suspend fun getUserAccess(email: String): UserAccess? = withContext(Dispatchers.IO) { suspend fun getUserAccess(email: String): UserAccess? = withContext(Dispatchers.IO) {
dao.getUserAccess(email) 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( suspend fun updateProgress(
numeroOs: String, numeroOs: String,
@@ -73,10 +78,30 @@ 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 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( val updatedActivity = currentActivity.copy(
percentualExecucao = novoPercentual.coerceIn(0, 100), percentualExecucao = novoPercentual.coerceIn(0, 100),
observacoes = observacao ?: currentActivity.observacoes, observacoes = latestObsText,
fotoPath = fotoPath ?: currentActivity.fotoPath, fotoPath = fotoPath ?: currentActivity.fotoPath,
synced = false, // Must sync later synced = false, // Must sync later
lastUpdated = effectiveTimestamp lastUpdated = effectiveTimestamp
@@ -90,7 +115,7 @@ class MaintenanceRepository(
timestamp = effectiveTimestamp, timestamp = effectiveTimestamp,
percentualAnterior = currentActivity.percentualExecucao, percentualAnterior = currentActivity.percentualExecucao,
percentualNovo = novoPercentual, percentualNovo = novoPercentual,
observacao = observacao, observacao = if (cleanObs != null) "[Observação Atualizada] $cleanObs" else null,
fotoPath = fotoPath, fotoPath = fotoPath,
recurso = recurso, recurso = recurso,
emailEditor = emailEditor emailEditor = emailEditor
@@ -98,6 +123,148 @@ class MaintenanceRepository(
dao.insertHistory(historyEntry) 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 // Persist login state
fun getSavedUser(): GoogleUser? { fun getSavedUser(): GoogleUser? {
val prefs = context.getSharedPreferences("google_auth_prefs", Context.MODE_PRIVATE) val prefs = context.getSharedPreferences("google_auth_prefs", Context.MODE_PRIVATE)
@@ -400,6 +567,19 @@ class MaintenanceRepository(
sheetsSyncService.pushHistoryToSheet(historyToUpload) sheetsSyncService.pushHistoryToSheet(historyToUpload)
android.util.Log.d("MaintenanceRepository", "Uploaded ${historyToUpload.size} new local history logs to Google Sheet.") 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( SyncResult.Success(
syncedItems = reconciledActivities.size, syncedItems = reconciledActivities.size,

View File

@@ -96,6 +96,7 @@ fun MaintenanceDashboardScreen(
val internetAvailable by viewModel.internetAvailable.collectAsStateWithLifecycle() val internetAvailable by viewModel.internetAvailable.collectAsStateWithLifecycle()
val selectedActivity by viewModel.selectedActivity.collectAsStateWithLifecycle() val selectedActivity by viewModel.selectedActivity.collectAsStateWithLifecycle()
val selectedActivityHistory by viewModel.selectedActivityHistory.collectAsStateWithLifecycle() val selectedActivityHistory by viewModel.selectedActivityHistory.collectAsStateWithLifecycle()
val selectedActivityFindings by viewModel.selectedActivityFindings.collectAsStateWithLifecycle()
val currentUser by viewModel.currentUser.collectAsStateWithLifecycle() val currentUser by viewModel.currentUser.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()
@@ -600,6 +601,7 @@ fun MaintenanceDashboardScreen(
EditActivityBottomSheet( EditActivityBottomSheet(
activity = selectedActivity!!, activity = selectedActivity!!,
history = selectedActivityHistory, history = selectedActivityHistory,
findings = selectedActivityFindings,
currentUser = currentUser, currentUser = currentUser,
userAccessLevel = userAccessLevel, userAccessLevel = userAccessLevel,
onDismiss = { onDismiss = {
@@ -616,6 +618,15 @@ fun MaintenanceDashboardScreen(
emailEditor = currentUser?.email emailEditor = currentUser?.email
) )
}, },
onAddFinding = { tipo, desc ->
viewModel.addFinding(selectedActivity!!.numeroOs, tipo, desc)
},
onUpdateFinding = { finding ->
viewModel.updateFinding(finding)
},
onDeleteFinding = { finding ->
viewModel.deleteFinding(finding)
},
onSavePhotoFromUri = { uri -> onSavePhotoFromUri = { uri ->
viewModel.saveLocalPhotoFromUri(uri, selectedActivity!!.numeroOs) viewModel.saveLocalPhotoFromUri(uri, selectedActivity!!.numeroOs)
}, },
@@ -1226,10 +1237,14 @@ fun FullscreenPhotoViewerDialog(
fun EditActivityBottomSheet( fun EditActivityBottomSheet(
activity: MaintenanceActivity, activity: MaintenanceActivity,
history: List<OSUpdateHistory>, history: List<OSUpdateHistory>,
findings: List<com.example.data.model.OSFinding> = emptyList(),
currentUser: com.example.data.model.GoogleUser?, currentUser: com.example.data.model.GoogleUser?,
userAccessLevel: String?, userAccessLevel: String?,
onDismiss: () -> Unit, onDismiss: () -> Unit,
onUpdateProgress: (Int, String, String?) -> 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, onSavePhotoFromUri: (Uri) -> String,
onCreateCameraUri: () -> Pair<Uri, String>, onCreateCameraUri: () -> Pair<Uri, String>,
onSoftDeletePhoto: (String) -> Unit, onSoftDeletePhoto: (String) -> Unit,
@@ -1239,6 +1254,11 @@ fun EditActivityBottomSheet(
val keyboardController = LocalSoftwareKeyboardController.current val keyboardController = LocalSoftwareKeyboardController.current
val isImeVisible = WindowInsets.isImeVisible 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<com.example.data.model.OSFinding?>(null) }
Dialog( Dialog(
onDismissRequest = onDismiss, onDismissRequest = onDismiss,
properties = DialogProperties(usePlatformDefaultWidth = false) 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 // Slider Progress Update Panel
Column(verticalArrangement = Arrangement.spacedBy(4.dp)) { Column(verticalArrangement = Arrangement.spacedBy(4.dp)) {
Row( Row(
@@ -1422,12 +1475,12 @@ fun EditActivityBottomSheet(
value = progressValue, value = progressValue,
onValueChange = { progressValue = it }, onValueChange = { progressValue = it },
valueRange = 0f..100f, valueRange = 0f..100f,
steps = 19, // Splits in 5% increments for rapid tactile field logging steps = 19, // 5% increments
enabled = currentUser != null,
colors = SliderDefaults.colors( colors = SliderDefaults.colors(
thumbColor = if (progressValue >= 100) BrandGreen else StatusBlue, thumbColor = if (progressValue >= 100) BrandGreen else StatusBlue,
activeTrackColor = if (progressValue >= 100) BrandGreen else StatusBlue activeTrackColor = if (progressValue >= 100) BrandGreen else StatusBlue
), )
enabled = currentUser != null
) )
// Quick jump buttons for field speed // Quick jump buttons for field speed
@@ -1468,7 +1521,7 @@ fun EditActivityBottomSheet(
// Text Observation Entry // Text Observation Entry
Column(verticalArrangement = Arrangement.spacedBy(6.dp)) { Column(verticalArrangement = Arrangement.spacedBy(6.dp)) {
Text( Text(
text = "Observações de Campo", text = "Nova Observação de Campo",
fontWeight = FontWeight.Bold, fontWeight = FontWeight.Bold,
fontSize = 14.sp, fontSize = 14.sp,
color = BrandBlack 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 // Photo Attachment & Horizontal Gallery Section
Column(verticalArrangement = Arrangement.spacedBy(8.dp)) { Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
HorizontalDivider(color = Color(0xFFF1F1F1))
Row( Row(
modifier = Modifier.fillMaxWidth(), modifier = Modifier.fillMaxWidth(),
horizontalArrangement = Arrangement.SpaceBetween, 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 // Chronological Audit Timeline Log / History Section
Column(verticalArrangement = Arrangement.spacedBy(8.dp)) { Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
HorizontalDivider(color = Color(0xFFF1F1F1)) 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 @Composable
fun TimelineLogItem(log: OSUpdateHistory) { fun TimelineLogItem(log: OSUpdateHistory) {
val dateStr = remember(log.timestamp) { val dateStr = remember(log.timestamp) {
@@ -1809,11 +2094,19 @@ fun TimelineLogItem(log: OSUpdateHistory) {
sdf.format(Date(log.timestamp)) 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( Card(
modifier = Modifier.fillMaxWidth(), modifier = Modifier.fillMaxWidth(),
colors = CardDefaults.cardColors(containerColor = Color(0xFFFAFAFA)), colors = CardDefaults.cardColors(containerColor = Color(0xFFFAFAFA)),
border = BorderStroke(1.dp, Color(0xFFEEEEEE)), border = BorderStroke(1.dp, Color(0xFFEEEEEE)),
shape = RoundedCornerShape(6.dp) shape = RoundedCornerShape(8.dp)
) { ) {
Column(modifier = Modifier.padding(10.dp)) { Column(modifier = Modifier.padding(10.dp)) {
// Header Row: User, timestamp and progress jump // Header Row: User, timestamp and progress jump
@@ -1834,45 +2127,62 @@ fun TimelineLogItem(log: OSUpdateHistory) {
color = BrandBlack color = BrandBlack
) )
} }
Text(
text = dateStr, Surface(
fontSize = 10.sp, color = containerColor,
color = StatusGrey 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)) Spacer(modifier = Modifier.height(4.dp))
// Progress Jump Badge // Progress Jump Badge if progress was altered or if purely progress update
Row( if (log.percentualAnterior != log.percentualNovo || !obs.startsWith("[")) {
verticalAlignment = Alignment.CenterVertically, Row(
horizontalArrangement = Arrangement.spacedBy(6.dp) verticalAlignment = Alignment.CenterVertically,
) { horizontalArrangement = Arrangement.spacedBy(6.dp)
Text( ) {
text = "Avanço:", Text(
fontSize = 11.sp, text = "Avanço:",
color = StatusGrey fontSize = 11.sp,
) color = StatusGrey
Text( )
text = "${log.percentualAnterior}% ➜ ${log.percentualNovo}%", Text(
fontSize = 11.sp, text = "${log.percentualAnterior}% ➜ ${log.percentualNovo}%",
fontWeight = FontWeight.Black, fontSize = 11.sp,
color = if (log.percentualNovo >= 100) BrandGreen else StatusBlue fontWeight = FontWeight.Black,
) color = if (log.percentualNovo >= 100) BrandGreen else StatusBlue
)
}
} }
// Remarks/Observations // Remarks/Observations
if (!log.observacao.isNullOrBlank()) { if (!log.observacao.isNullOrBlank()) {
Spacer(modifier = Modifier.height(4.dp)) Spacer(modifier = Modifier.height(4.dp))
val cleanText = log.observacao.replace(Regex("^\\[[^\\]]+\\]\\s*"), "")
Box( Box(
modifier = Modifier modifier = Modifier
.fillMaxWidth() .fillMaxWidth()
.background(Color(0xFFF1F1F1)) .background(containerColor)
.padding(6.dp) .padding(6.dp)
.clip(RoundedCornerShape(4.dp)) .clip(RoundedCornerShape(4.dp))
) { ) {
Text( Text(
text = "\"${log.observacao}\"", text = cleanText,
fontSize = 11.sp, fontSize = 11.sp,
color = BrandBlack color = BrandBlack
) )
@@ -1894,10 +2204,21 @@ fun TimelineLogItem(log: OSUpdateHistory) {
Text("Foto Anexa: ${log.fotoPath}", fontSize = 9.sp, color = BrandGreen, fontWeight = FontWeight.Bold) 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<A, B, C, D>(val first: A, val second: B, val third: C, val fourth: D)
/** /**
* Importer Console Sheet for loading spreadsheets and managing datasets * Importer Console Sheet for loading spreadsheets and managing datasets
*/ */

View File

@@ -327,6 +327,23 @@ class MaintenanceViewModel(private val repository: MaintenanceRepository) : View
initialValue = emptyList() initialValue = emptyList()
) )
// Reactive Flow for the current activity's findings (Achados & Observações)
@OptIn(kotlinx.coroutines.ExperimentalCoroutinesApi::class)
val selectedActivityFindings: StateFlow<List<com.example.data.model.OSFinding>> = _selectedActivity
.flatMapLatest { activity ->
if (activity != null) {
repository.getFindingsForOs(activity.numeroOs)
} else {
flowOf(emptyList())
}
}
.stateIn(
scope = viewModelScope,
started = SharingStarted.WhileSubscribed(5000),
initialValue = emptyList()
)
init { init {
val savedUser = repository.getSavedUser() val savedUser = repository.getSavedUser()
_currentUser.value = savedUser _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 { fun saveLocalPhotoFromUri(uri: Uri, osNumber: String): String {
return repository.saveLocalPhotoFromUri(uri, osNumber) return repository.saveLocalPhotoFromUri(uri, osNumber)
} }

View File

@@ -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:* 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.
### 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 ### 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):** 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). * 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. * 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):** 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. * 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.

View File

@@ -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. | | **`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. | | **`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) ### Tabela/Aba 2: `history` (Histórico de Auditoria das OS e Achados)
Esta aba registrará cada alteração feita em qualquer OS, permitindo auditoria detalhada de quem alterou o progresso e quando. 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). | | **`id`** | Texto ou Número | Identificador único da linha do histórico. |
| **`numeroOs`** | Texto | Código da OS que foi atualizada (chave estrangeira relacionada à aba `activities`). | | **`numeroOs`** | Texto | Código da OS atualizada. |
| **`timestamp`** | Número Inteiro (Long) | Carimbo de data/hora em milissegundos de quando a atualização ocorreu. | | **`timestamp`** | Número Inteiro (Long) | Timestamp Unix em milissegundos. |
| **`percentualAnterior`** | Número Inteiro | Qual era o progresso antes dessa alteração (ex: `25`). | | **`percentualAnterior`** | Número Inteiro | Progresso anterior da OS. |
| **`percentualNovo`** | Número Inteiro | Qual o novo progresso registrado (ex: `50`). | | **`percentualNovo`** | Número Inteiro | Novo progresso da OS. |
| **`observacao`** | Texto (Opcional) | Comentário inserido pelo técnico justificando ou detalhando aquela atualização específica. | | **`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 tirada no momento desta atualização (se houver). | | **`fotoPath`** | Texto (URL) | Link da foto anexa. |
| **`responsavel`** | Texto | Nome do profissional que realizou esta atualização de progresso. | | **`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.