Evidências
Evidências — Abate (FrigosoftColetor)
A feature de Evidências permite ao operador registrar fotos vinculadas a um animal durante o processo de abate, documentando ocorrências sanitárias ou irregularidades observadas em diferentes pontos da linha (vivo, rastreamento, vísceras, DIF, balança etc.).
Visão Geral
A feature de Evidências permite ao operador registrar fotos vinculadas a um animal durante o processo de abate, documentando ocorrências sanitárias ou irregularidades observadas em diferentes pontos da linha (vivo, rastreamento, vísceras, DIF, balança etc.). Cada foto é associada a um local de inspeção, a uma ocorrência específica e — quando o local exige — a uma banda (lado da carcaça).
No fluxo geral do módulo de abate, a captura de evidências ocorre após a passagem do animal pelas etapas de rastreamento e tipificação, sendo um registro de suporte ao processo de inspeção. As imagens ficam disponíveis para consulta posterior e são sincronizadas com o ERP quando existe Romaneio de Abate vinculado ao animal.
Pré-requisitos
- Sessão ativa com filial e data de abate definidas: sem sessão ativa, as listas de animais e ocorrências não são carregadas e a tela não opera.
- Parâmetro de uso de carretilha configurado na filial: determina o modo de busca do animal. Se ausente, o sistema assume que a filial não usa carretilha (busca por sequência numérica). A configuração vem da sessão ativa — o operador não a define em tela.
- Animais do dia disponíveis no servidor: sem animais cadastrados na data de abate da sessão, a lista fica vazia e não há animal para selecionar.
Fluxo Operacional
- O operador abre a tela de Evidências. O sistema carrega simultaneamente a lista de animais do dia e a lista de ocorrências disponíveis.
- Enquanto os dados carregam, a tela exibe estado de carregamento. Ao concluir, exibe a lista de animais.
- O operador localiza o animal desejado de duas formas alternativas:
- Digitando a sequência de abate (quando a filial não usa carretilha) ou o código de carretilha (quando usa) no campo de busca e pressionando enviar no teclado.
- Selecionando o animal diretamente na lista de animais exibida — o sistema preenche o campo e dispara a busca automaticamente.
- O sistema busca o animal no servidor. Se localizado com sucesso, exibe o painel de informações (sequência de cabeça, sexo, manejo e data de abate) e a lista de evidências já registradas para esse animal.
- O campo de busca fica desabilitado enquanto o animal estiver selecionado.
- Para registrar nova evidência, o operador aciona o botão “Evidências”. A câmera abre automaticamente.
- O operador fotografa a irregularidade. Caso cancele a câmera sem fotografar, a tela de captura fecha automaticamente sem registrar nada.
- Com a foto capturada, o operador seleciona o local de evidência e a ocorrência. Se o local exigir banda, seleciona também a banda.
- O botão de envio é habilitado somente quando todos os campos obrigatórios estão preenchidos.
- O operador aciona o envio. O sistema comprime a imagem e envia ao servidor. Em caso de sucesso, a lista de evidências do animal é atualizada automaticamente.
- Para excluir uma evidência já registrada, o operador acessa o menu de contexto do card da evidência e seleciona excluir. O sistema solicita confirmação. Após confirmação, a imagem é removida.
- Ao finalizar o trabalho com o animal, o operador aciona “Finalizar”. O sistema limpa completamente o estado da tela (ver Regras de Negócio).
Interface e Comportamentos do App
Rodapé da tela de Evidências
Na tela de Evidências, o rodapé exibe botões diferentes conforme a seleção do animal:
- Quando nenhum animal está selecionado: exibe apenas o botão “Consultar Animais”.
- Quando um animal está selecionado: exibe dois botões — “Finalizar” e “Evidências” (nova evidência).
Lista de animais do dia na tela de Evidências
A lista de animais da tela de Evidências exibe todos os animais do dia na sessão ativa. Para cada animal, mostra o status (Liberado ou Bloqueado, sinalizado por cor — ver Regras de Negócio) e a quantidade de imagens de evidência já registradas para ele.
Campo de busca do animal na tela de Evidências
O campo de busca do animal, na tela de Evidências, aceita texto alfanumérico quando a filial usa carretilha, ou apenas número (sequência de abate) quando a filial não usa carretilha. O valor digitado é convertido automaticamente para maiúsculas antes de ser enviado ao servidor (ver Regras de Negócio para o valor usado em cada caso).
Painel de informações do animal selecionado (Evidências)
O painel de informações do animal, na tela de Evidências, permanece vazio até que um animal seja selecionado. Após a seleção, exibe: sequência de cabeça, sexo (Macho, Fêmea, ou o valor original quando não reconhecido), manejo, e data de abate no formato dd/mm/aaaa.
Locais de captura de evidência
Na feature de Evidências, os locais disponíveis para captura são definidos fixamente no aplicativo:
| Código | Descrição | Exige Banda? |
|---|---|---|
| 1 | Vivo | Não |
| 2 | Rast1 | Não |
| 3 | Vísceras | Não |
| 4 | DIF | Sim |
| 6 | Rast2 | Sim |
| 7 | Balança Abate | Sim |
Não existe código 5 nessa lista.
Tela de nova evidência
Ao registrar uma nova evidência, o aplicativo abre a câmera automaticamente ao entrar na tela. Nessa tela:
- O local de evidência é exibido no formato `{codigo}-{descricao}` (ex.: `4-DIF`).
- A ocorrência é exibida no formato `{ID}-{Nome}` (ex.: `001-Pneumonia`).
- O campo de banda aparece como obrigatório apenas para os locais marcados como “Sim” na coluna “Exige Banda?” da tabela acima (DIF, Rast2 e Balança Abate); para os demais locais, o campo não é exigido.
- O botão de envio fica desabilitado até que local, ocorrência, foto e — quando exigida — banda estejam preenchidos.
Card de evidência registrada (Evidências)
Cada card de evidência registrada, na tela de Evidências, exibe a imagem (quando disponível), o local no formato `{codigo}-{descricao}`, a ocorrência no formato `{ID}-{Nome}`, e a banda (somente se preenchida). O menu de contexto do card permite visualizar a imagem em tela cheia (quando a imagem estiver disponível) e excluir a imagem (com confirmação).
Feedbacks ao Operador
| Situação | Feedback | Mensagem |
|---|---|---|
| Falha no carregamento inicial (mensagem do servidor não vazia) | Toast longo de erro | Mensagem literal retornada pelo servidor |
| Falha no carregamento inicial (mensagem do servidor vazia) | Toast longo de erro | Mensagem genérica de erro de conexão (texto internacionalizado do app) |
| Animal não encontrado na busca | Toast longo de erro | `”Não foi possível encontrar o sisbov.”` |
| Imagem enviada com sucesso | Toast longo de sucesso | Texto internacionalizado indicando que a imagem foi enviada |
| Imagem excluída com sucesso | Toast longo de sucesso | Texto internacionalizado indicando que a imagem foi excluída |
| Falha no envio ou exclusão (erro de negócio ou rede) | Toast longo de erro | Mensagem literal do servidor ou de exceção capturada |
Regras de Negócio
Modo de busca do animal por filial (Evidências)
Na feature de Evidências, o modo de busca do animal varia conforme a configuração de carretilha da filial:
- Se a filial usa carretilha: o campo aceita texto alfanumérico; na busca, o valor passado é o código de carretilha do animal.
- Se a filial não usa carretilha: o campo aceita apenas número; na busca, o valor passado é a sequência numérica do animal.
- Em ambos os casos, o valor é convertido para maiúsculas antes de ser enviado ao servidor.
Filtro de animais do dia (Evidências)
Na tela de Evidências, apenas animais cuja filial corresponde à filial da sessão ativa e cuja data de abate corresponde à data da sessão ativa são retornados. Animais de outra filial ou de outros dias não aparecem.
Status do animal na lista de Evidências
Na lista de animais da tela de Evidências, o status do animal determina a cor de exibição:
- Liberado: animal sem restrição. Exibido em verde.
- Bloqueado: animal com alguma restrição (qualquer status diferente de Liberado). Exibido em laranja.
Obrigatoriedade de banda por local de evidência
Na feature de Evidências, a obrigatoriedade da banda depende do local selecionado:
- Locais Vivo, Rast1 e Vísceras: banda não é exigida.
- Locais DIF, Rast2 e Balança Abate: banda é obrigatória para habilitar o envio da evidência.
Seleção de ocorrência na evidência
Na feature de Evidências, a ocorrência é identificada pelo número que aparece antes do traço, no formato `{ID}-{Nome}` (ex.: em `003-Contusão`, o ID é `003`). A seleção só é aceita quando a ocorrência está nesse formato. Na exibição do card de evidência, pequenas variações de espaço ou de maiúsculas/minúsculas no cadastro da ocorrência não impedem que ela seja exibida corretamente.
Tipos de ocorrência disponíveis para seleção na evidência
Na feature de Evidências, a lista de ocorrências oferecida ao operador para vincular a uma evidência não inclui os registros do tipo “Outras” — apenas os demais tipos de ocorrência aparecem disponíveis para seleção.
Compressão de imagem de evidência antes do envio
Antes de enviar uma imagem de evidência ao servidor, o aplicativo a comprime com os seguintes parâmetros:
- Qualidade: 70%.
- Dimensão mínima: 1280×1280 pixels.
- Formato: JPEG.
- Em caso de falha na compressão: a imagem original (sem compressão) é usada como alternativa — sem notificação ao operador.
Sincronização diferenciada com o ERP
Na feature de Evidências, a sincronização de uma imagem com o ERP depende da operação:
- Ao salvar: sincronização com o ERP ocorre somente se existir Romaneio de Abate.
- Ao excluir: sincronização com o ERP ocorre sempre, independentemente de existir Romaneio de Abate.
Atualização da lista de evidências após operações
Após salvar ou excluir uma imagem na tela de Evidências, a lista de evidências do animal é atualizada automaticamente:
- Ao salvar: a lista é substituída pelos dados retornados pelo servidor. Se o servidor não retornar a lista, a lista anterior continua exibida (não fica vazia).
- Ao excluir: a lista é substituída pelos dados retornados pelo servidor.
Finalização do trabalho com o animal (Evidências)
Ao finalizar o trabalho com um animal na tela de Evidências, o aplicativo limpa completamente o estado: lista de evidências zerada, animal deselecionado, mensagem limpa, campo de busca vazio e habilitado.
Tratamento de erro duplo na inicialização da tela de Evidências
Se, ao abrir a tela de Evidências, os carregamentos de animais e de ocorrências falharem ao mesmo tempo, apenas a mensagem do primeiro erro é exibida ao operador; a mensagem do segundo erro não aparece.
Troubleshooting
a tela abre mas exibe mensagem de erro sem listar animais nem ocorrências
Mensagem exibida: Mensagem literal do servidor ou, se a mensagem estiver vazia, texto genérico de erro de conexão
O que fazer: verificar se a sessão está ativa e se o servidor está acessível. Refazer login caso a sessão tenha expirado.
o operador busca o animal e a tela exibe mensagem de erro
Mensagem exibida: `”Não foi possível encontrar o sisbov.”`
O que fazer: confirmar que a sequência de abate ou o código de carretilha digitado está correto. Verificar se o animal pertence à data de abate da sessão atual. Se o animal existir em outra data, é necessário alterar a sessão para a data correta.
o operador tenta enviar a evidência mas o botão permanece desabilitado
Mensagem exibida: Nenhuma — botão permanece inativo
O que fazer: verificar se todos os campos foram preenchidos: local de evidência, ocorrência, foto capturada e — se o local for DIF, Rast2 ou Balança Abate — a banda.
o servidor retorna erro ao salvar a imagem informando que o sisbov não foi encontrado
Mensagem exibida: `”Não foi possível encontrar o sisbov.”`
O que fazer: o registro do animal pode ter sido removido. Acionar o responsável técnico para verificar a integridade dos dados do sisbov.
o servidor retorna erro ao excluir a imagem informando que o sisbov não foi encontrado
Mensagem exibida: `”Não foi possível encontrar o sisbov.”`
O que fazer: a imagem ou o animal podem ter sido removidos por outro processo. Recarregar a lista de evidências acionando “Finalizar” e selecionando o animal novamente.
a evidência foi enviada com sucesso no aplicativo, mas não aparece nos relatórios do ERP logo em seguida
Mensagem exibida: Nenhuma no aplicativo — o envio já foi confirmado ao operador
O que fazer: isso é esperado quando o animal ainda não foi sincronizado no ERP no momento do envio da evidência; o ERP recusa a gravação com a mensagem “ID do Sisbov não encontrado, pois ainda não foi sincronizado no abate” e a sincronização é repetida automaticamente depois. Aguardar a sincronização do animal no abate. Se persistir por muito tempo, acionar o responsável técnico para verificar a sincronização entre Manager e ERP.
a evidência foi excluída no aplicativo, mas a exclusão não é refletida no ERP
Mensagem exibida: Nenhuma no aplicativo — a exclusão já foi confirmada ao operador
O que fazer: isso ocorre quando o ERP não localiza o registro da imagem no momento de sincronizar a exclusão, respondendo com o erro “Não foi possível excluir SisBovImagem — SisBovImagem não encontrado”; nesse caso, nenhum registro é removido no ERP. Acionar o responsável técnico para verificar a sincronização entre Manager e ERP.
Casos de Uso
Caso 1 — Caminho feliz: registrar evidência de pneumonia no pulmão (local Vísceras)
O operador abre Evidências e vê na lista o animal de sequência 0312, status Liberado, com 0 imagens. Seleciona o animal pela lista. O painel exibe: cabeça 312, sexo Macho, manejo Confinado, abate em 22/06/2026. O operador aciona “Evidências”, fotografa o pulmão do animal. Na tela de captura, seleciona local `3-Vísceras` (banda não exigida) e ocorrência `005-Pneumonia`. O botão de envio é habilitado. Aciona enviar. A imagem é comprimida para JPEG 70% e enviada. O sistema retorna confirmação e a lista de evidências passa a exibir a nova foto.
Caso 2 — Variação por local que exige banda: registrar evidência na DIF
O operador seleciona o animal de carretilha `A0047`. Aciona “Evidências” e fotografa a carcaça na câmara de DIF. Seleciona local `4-DIF` — o campo de banda aparece como obrigatório. Seleciona banda `Direita` e ocorrência `003-Contusão`. Apenas após preencher os três campos o botão de envio é habilitado. O operador envia. O sistema sincroniza a imagem com o ERP pois o animal possui Romaneio de Abate.
Caso 3 — Exclusão de evidência registrada por engano
O operador percebe que fotografou o animal errado. Na lista de evidências do animal atual, aciona o menu de contexto da foto e seleciona excluir. O sistema exibe diálogo de confirmação. O operador confirma. A imagem é excluída do Manager e a sincronização de exclusão com o ERP é disparada imediatamente, independentemente de existir Romaneio de Abate.
Caso 4 — Filial sem carretilha: busca por sequência numérica
A filial não usa código de carretilha. O operador digita `0089` no campo de busca (aceita apenas número) e pressiona enviar. O sistema converte para `0089` (já em maiúsculas) e busca no servidor. O animal é localizado com 2 evidências já registradas. O operador registra uma terceira evidência no local `1-Vivo` (sem exigência de banda).