feat: implement OSFinding management to support tracking safety, maintenance, and observation findings with automated synchronization.
This commit is contained in:
@@ -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.
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user