Evidência de Coleta
Evidência de Coleta
A tela de Evidência de Coleta permite capturar e revisar fotos e vídeos vinculados a uma coleta específica, como comprovação do que foi registrado.
Visão Geral
A tela de Evidência de Coleta permite capturar e revisar fotos e vídeos vinculados a uma coleta específica, como comprovação do que foi registrado. É acessada pelo botão de Evidência na tela de Persistir Coleta.
Pré-requisitos
- O aplicativo pede permissão de câmera e microfone ao abrir esta tela.
Fluxo Operacional
- O coletor chega a esta tela a partir do botão de Evidência da tela de Persistir Coleta.
- A tela mostra, no topo, uma pré-visualização grande da evidência selecionada (a primeira da lista, por padrão), e abaixo a lista de todos os arquivos já registrados.
- O coletor pode tocar no botão principal para abrir as opções de adicionar foto ou adicionar vídeo.
- Ao escolher adicionar foto, o aplicativo abre a câmera; a foto é recortada antes de ser salva. Ao escolher adicionar vídeo, o aplicativo grava por um tempo limitado e confere o tamanho do arquivo antes de salvar.
- Tocar em um item da lista o seleciona (destacado) e o exibe na pré-visualização; um botão de excluir aparece no cabeçalho para remover o item selecionado.
Interface e Comportamentos
Lista e Pré-visualização
A lista mostra cada evidência com um ícone próprio (foto ou vídeo), nome e data/hora. Quando não há nenhuma evidência registrada, a tela mostra apenas um aviso no lugar da lista e da pré-visualização.
Seleção e Exclusão
Tocar num item da lista o marca como selecionado e o exibe na pré-visualização do topo; o botão de excluir no cabeçalho só aparece quando há algum item selecionado. O botão de voltar fica desabilitado enquanto uma exclusão está em andamento.
Botão de Adicionar Evidência
Um botão principal abre dois botões menores: adicionar foto e adicionar vídeo. Cada um fica habilitado (verde) ou desabilitado (cinza) dependendo de ainda haver espaço disponível para aquele tipo de evidência nesta coleta — o limite de fotos e de vídeos é verificado de forma independente.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Nenhuma evidência registrada para esta coleta | Aviso no lugar da lista | “Não há evidências para a coleta informada” |
| Confirmação antes de excluir um arquivo | Diálogo | “Deseja excluir o arquivo?” |
| Excluindo o arquivo | Indicador de progresso | “Excluindo o arquivo, aguarde” |
| Arquivo excluído com sucesso | Indicador de sucesso | “Arquivo excluído com sucesso” |
| Falha ao excluir o arquivo | Indicador de erro | “Erro ao excluir o arquivo” |
| Salvando a foto capturada | Indicador de progresso | “Aguarde, estamos salvando a imagem” |
| Foto salva com sucesso | Indicador de sucesso | “Imagem salva com sucesso” |
| Falha ao salvar a foto | Indicador de erro | “Erro ao excluir o arquivo” |
| Falha ao capturar a foto | Aviso (snackbar) | “Erro ao cadastrar a imagem, tente novamente” |
| Vídeo gravado com sucesso | Indicador de sucesso | “Vídeo gravado com sucesso” |
| Falha ao salvar o vídeo | Indicador de erro | “Erro ao excluir o arquivo” |
| Vídeo excede o tamanho máximo permitido | Aviso (snackbar) | “O tamanho do vídeo excede o limite permitido. Por favor, tente ajustar a resolução da câmera.” |
| Gravação de vídeo não concluída | Aviso (snackbar) | “Erro ao gravar o vídeo, tente novamente” |
Evidências e Documentos Gerados
Fotos de Evidência
Capturadas pela câmera do aparelho e recortadas antes de salvar. Há um limite de fotos permitidas por coleta.
Vídeos de Evidência
Gravados pela câmera do aparelho, com um tempo máximo de gravação permitido. Depois de gravado, o aplicativo ainda confere se o tamanho do arquivo está dentro do limite máximo permitido — se exceder, o vídeo é descartado e não chega a ser salvo como evidência, mesmo tendo sido gravado com sucesso.
Vínculo da Evidência com a Coleta
Se a coleta já foi salva, o arquivo é vinculado imediatamente a ela. Se a coleta ainda não foi salva, a evidência fica guardada temporariamente e só é de fato gravada quando a coleta em si for salva com sucesso — se o aplicativo for encerrado antes disso, essa evidência capturada é perdida.
Geolocalização e Rastreamento
Localização ao Excluir uma Evidência
Excluir uma evidência de uma coleta que já foi salva passa pela mesma verificação de localização usada para registrar a própria coleta: se o bloqueio por localização estiver ativo, só é possível excluir estando dentro do raio permitido da propriedade.
Troubleshooting
Vídeo gravado não aparece na lista de evidências
Mensagem exibida: “O tamanho do vídeo excede o limite permitido. Por favor, tente ajustar a resolução da câmera.”
Cenário: o vídeo foi gravado com sucesso pela câmera, mas o arquivo ultrapassou o tamanho máximo permitido.
O que fazer: gravar um vídeo mais curto ou com resolução menor.
Falha ao salvar foto ou vídeo mostra mensagem sobre “excluir”
Mensagem exibida: “Erro ao excluir o arquivo”
Cenário: uma falha ao salvar a foto ou o vídeo (não ao excluir).
O que fazer: tentar capturar a evidência novamente; o texto da mensagem é impreciso, mas o problema real é que o arquivo não foi salvo.
Exclusão de evidência bloqueada por localização
Mensagem exibida: mensagens de bloqueio por localização equivalentes às da tela de Persistir Coleta
O que fazer: confirmar se o GPS está ativo, a permissão concedida, e se o coletor está dentro da área permitida da propriedade.
Casos de Uso
Caso 1 — Captura de foto durante o registro de uma coleta nova
O coletor está preenchendo uma coleta ainda não salva e toca em adicionar foto. A foto é capturada e recortada, mas só é gravada quando a coleta é salva.
Caso 2 — Adição de evidência a um registro já salvo
O coletor volta a um registro já salvo e adiciona uma foto adicional; o arquivo é vinculado imediatamente.
Caso 3 — Vídeo gravado excede o tamanho permitido
O coletor grava um vídeo longo ou em alta resolução. Mesmo a gravação sendo concluída, o aplicativo recusa salvá-lo como evidência por exceder o limite de tamanho.
Caso 4 — Exclusão de evidência fora da área permitida
O coletor tenta excluir uma foto de uma coleta já salva, mas está fora do raio permitido da propriedade e o bloqueio por localização está ativo. O aplicativo recusa a exclusão.