Controle Sanitário¶

Sigla: SAN (Controle Sanitário)
Status:
✅ Revisado
✅ Aprovado
Implementação:
⬜ Backend
⬜ Frontend
⬜ Mobile
⬜ Backoffice

Legenda: ⬜ Pendente | ✅ Realizado | ⚠️ Ponto de atenção | ❌ Não se aplica

Descrição¶

O módulo de Controle Sanitário é responsável por registrar e monitorar todas as ações sanitárias aplicadas ao rebanho, tais como vacinações, vermifugações, tratamentos e protocolos preventivos. Ele permite a rastreabilidade das intervenções de saúde por lote ou categoria, garantindo o cumprimento das exigências legais e técnicas para sanidade animal.

Escopo Inicial¶

Cadastro de protocolos sanitários
Registro de vacinações, vermifugações e tratamentos
Integração com o estoque de insumos sanitários
Alertas de reaplicação e vencimentos
Relatórios sanitários por lote, categoria ou período

Configurações¶

Protocolos Sanitários: Cadastro de protocolos com fases, periodicidade e tipos de intervenção
Parâmetros de aplicação: Definição de periodicidade, categorias e lotes-alvo
Alertas: Configuração de alertas para reaplicações, vencimentos e pendências
Integração com estoque: Vinculação obrigatória de insumos sanitários ao estoque

Funcionalidades¶

Cadastro de Protocolos Sanitários: Protocolos com fases, periodicidade e tipos de intervenção
Registro de Aplicações: Registro de vacinações, vermifugações e tratamentos por lote ou categoria
Controle de Insumos: Registro e baixa automática de insumos utilizados, com vínculo ao estoque
Controle de Custos Sanitários: Apuração automática do custo de intervenções com integração ao módulo Financeiro
Consulta ao Histórico Sanitário: Histórico detalhado por animal, lote ou categoria
Relatórios de Conformidade: Emissão de relatórios sanitários para auditoria e exigências legais
Alertas e Notificações: Alertas para reaplicações futuras, vencimentos e pendências
Dashboards Sanitários: Painéis visuais com indicadores de saúde do rebanho e custos relacionados
Operação Offline: Suporte para registros em campo sem conectividade, com sincronização posterior

Requisitos Funcionais¶

RF-SAN-001: Cadastro de protocolos sanitários
Descrição: O sistema deve permitir o cadastro de protocolos sanitários incluindo fases, tipo de intervenção e periodicidade.
Critério de aceitação: Deve ser possível cadastrar protocolos com múltiplas fases e periodicidade configurável.
Prioridade: Alta
RF-SAN-002: Registro de aplicações sanitárias
Descrição: O sistema deve permitir o registro de vacinações, vermifugações e tratamentos com data, responsável, lote/categoria e quantidade.
Critério de aceitação: Cada registro deve vincular-se a um lote ou categoria e incluir todos os dados obrigatórios.
Prioridade: Alta
RF-SAN-003: Integração com estoque
Descrição: O sistema deve integrar-se com o módulo de estoque para abater automaticamente o insumo utilizado.
Critério de aceitação: A baixa de estoque deve ocorrer automaticamente após o registro da aplicação sanitária.
Prioridade: Alta
Dependência: Módulo de Estoque
RF-SAN-004: Relatórios sanitários
Descrição: O sistema deve gerar relatórios sanitários por lote, categoria e período.
Critério de aceitação: Os relatórios devem incluir histórico completo de intervenções e permitir exportação.
Prioridade: Média
RF-SAN-005: Alertas de reaplicação
Descrição: O sistema deve emitir alertas de reaplicação com base na periodicidade definida.
Critério de aceitação: Os alertas devem ser gerados automaticamente e enviados aos responsáveis.
Prioridade: Alta
Dependência: Sistema de Notificações Interno
RF-SAN-006: Controle de custos sanitários
Descrição: O sistema deve calcular e registrar os custos de cada intervenção sanitária.
Critério de aceitação: Os custos devem incluir insumos, mão de obra e despesas relacionadas.
Critério de aceitação: Integração com o módulo Financeiro para registro automático dos custos.
Prioridade: Média
Dependência: Módulo Financeiro
RF-SAN-007: Dashboards sanitários
Descrição: O sistema deve fornecer dashboards com indicadores de saúde do rebanho e custos relacionados.
Critério de aceitação: Exibir visualizações de cobertura vacinal, custos por categoria/lote e eficiência.
Prioridade: Baixa
Dependência: Módulo de Dashboards e Relatórios
RF-SAN-008: Operação offline completa
Descrição: O sistema deve permitir operações sanitárias completas em ambiente sem conectividade, incluindo consultas ao histórico, registro de novas aplicações e acesso a protocolos pre-configurados.
Critério de aceitação: Armazenar registros offline para posterior sincronização com identificação clara de status pendente.
Critério de aceitação: Disponibilizar consulta local de histórico sanitário de animais e lotes.
Critério de aceitação: Apresentar alertas pendentes mesmo em modo offline.
Prioridade: Alta

Requisitos Não Funcionais¶

RNF-SAN-001: Arquitetura Offline-First para Operações Sanitárias em Campo
Descrição: O sistema deve implementar uma arquitetura offline-first robusta para garantir operações sanitárias completas sem conexão, essencial para o contexto rural onde a conectividade é limitada ou inexistente durante procedimentos de campo.
Critério de aceitação:
- Aplicações móveis devem funcionar integralmente por até 30 dias sem conexão
- Todas as funcionalidades sanitárias críticas devem estar disponíveis offline, incluindo:
- Consulta completa ao histórico sanitário dos animais/lotes
- Acesso a todos os protocolos sanitários configurados
- Registro de aplicações com geotagging e timestamp preciso
- Validação local de períodos de carência e contra-indicações
- Baixa e controle local de insumos utilizados
- Armazenamento local deve manter histórico sanitário completo dos últimos 12 meses para todos os animais/lotes da fazenda
- Interface deve exibir claramente o status de sincronização de cada registro sanitário com indição visual (cores/ícones)
- Sincronização deve ocorrer incrementalmente quando a conexão for restabelecida, priorizando registros críticos (aplicações recentes, alertas de carência)
Prioridade: Alta
RNF-SAN-002: Mecanismos Avançados de Resolução de Conflitos Sanitários
Descrição: O sistema deve implementar estratégias sofisticadas para identificação, gerenciamento e resolução de conflitos de dados que ocorrem durante operações sanitárias offline em diferentes dispositivos ou por diferentes usuários.
Critério de aceitação:
- Resolução de conflitos deve seguir regras específicas por tipo de operação sanitária:
- Para aplicações sanitárias potencialmente duplicadas no mesmo animal/lote: sistema deve analisar proximidade temporal, tipo de procedimento e responsável para determinar duplicidade real; manter ambos os registros com alerta visual para revisão quando houver suspeita
- Para modificações em protocolos: aplicações já realizadas mantidas intactas; novos protocolos servidores prevalecem para aplicações futuras com notificação de alteração
- Para baixas de estoque conflitantes: sistema deve reconciliar saldos preservando todas as baixas realizadas e gerando alertas quando o saldo teórico ficar negativo
- Para conflitos em diagnósticos sanitários: versão mais recente prevalece, mas o histórico completo é mantido com indicação de mudanças
- Painel administrativo exibe todos os conflitos sanitários pendentes para revisão por gestores
- Relatório de auditoria registra todas as decisões de resolução aplicadas (automáticas e manuais)
Prioridade: Alta
RNF-SAN-003: Interface Otimizada para Operações Sanitárias em Campo
Descrição: O sistema deve oferecer uma interface especialmente adaptada para condições de campo, considerando dispositivos móveis, diferentes condições de iluminação, uso com luvas e acesso por usuários com diferentes níveis de alfabetização.
Critério de aceitação:
- Interface adaptativa para diferentes tamanhos de tela e orientações (vertical/horizontal)
- Botões e elementos de controle dimensionados para uso com luvas e em movimento
- Contraste de cores adequado para visualização em condições de alta luminosidade
- Suporte a entrada de dados por voz para registros rápidos durante procedimentos
- Fluxos simplificados de registro com poucos toques para operações frequentes
- Recursos visuais (ícones, cores) para identificação de protocolos e status
- Modo de economia de bateria que reduz recursos gráficos em situações críticas
Prioridade: Alta
RNF-SAN-004: Desempenho em consultas e listagens
Descrição: O sistema deve apresentar respostas rápidas mesmo com grande volume de dados sanitários.
Critério de aceitação: Consultas devem retornar em menos de 3 segundos mesmo com histórico extenso.
Critério de aceitação: Paginação e filtros otimizados para grandes volumes de registros sanitários.
Prioridade: Média
RNF-SAN-005: Disponibilidade e resiliência
Descrição: O sistema deve ser resiliente a falhas e manter dados sanitários consistentes.
Critério de aceitação: Mecanismos de recuperação automática após falhas.
Critério de aceitação: Consistência transacional nas operações sanitárias críticas.
Prioridade: Alta
RNF-SAN-006: Segurança e conformidade
Descrição: O sistema deve garantir a segurança dos dados sanitários e conformidade com requisitos legais.
Critério de aceitação: Controle de acesso baseado em papéis para operações críticas.
Critério de aceitação: Registro de auditoria para todas as alterações em protocolos e aplicações.
Critério de aceitação: Conformidade com regulamentações sanitárias aplicadas à pecuária.
Prioridade: Alta

Regras de Negócio¶

RN-SAN-001: Vinculação obrigatória de registros
Descrição: Todo registro sanitário deve vincular-se a um lote, categoria ou protocolo.
Prioridade: Alta
RN-SAN-002: Validação de estoque
Descrição: Não é permitida a aplicação sem saldo de insumo no estoque vinculado, exceto quando explicitamente autorizado.
Prioridade: Alta
RN-SAN-003: Alertas de protocolos vencidos
Descrição: Protocolos vencidos devem gerar alerta até que nova aplicação seja registrada.
Prioridade: Alta
RN-SAN-004: Registro de custos sanitários
Descrição: Todo tratamento ou aplicação sanitária deve calcular e registrar automaticamente os custos associados no módulo Financeiro.
Prioridade: Média
RN-SAN-005: Período de carência
Descrição: Animais sob tratamento com medicamentos que exigem período de carência devem ser sinalizados no sistema até o fim do período.
Prioridade: Alta
RN-SAN-006: Rastreabilidade de lotes de insumos
Descrição: Todas as aplicações devem registrar o lote do insumo utilizado para rastreabilidade.
Prioridade: Média

Critérios de Aceitação¶

Registros sanitários por lote devem ser possíveis online e offline.
Relatórios e alertas devem ser gerados corretamente conforme as configurações.
Histórico sanitário do rebanho deve estar disponível para consulta por perfil autorizado.

Dependências¶

Módulo de Manejo de Rebanho (para informações de identificação e grupos de animais)
Módulo de Estoque (para controle de medicamentos e insumos sanitários)

Integrações¶

Integrações que o módulo Sanitário SOLICITA de outros módulos:¶

Integração com Módulo de Estoque: Solicita baixa de medicamentos e insumos utilizados em procedimentos sanitários, informando quantidade, lote e local de uso. Consulta saldos disponíveis, prazos de validade e rastreabilidade de lotes de insumos sanitários.
Integração com Módulo de Auditoria de Dados: Solicita registro de todas as operações sanitárias para fins de rastreabilidade, conformidade legal e auditorias regulatórias.
Integração com Módulo de Manejo de Rebanho: Solicita informações atualizadas sobre a composição do rebanho, lotes, categorias e localização dos animais para planejamento e execução de intervenções sanitárias.
Integração com Módulo de Membros da Fazenda: Solicita informações sobre responsáveis técnicos, suas qualificações e autorizações para procedimentos sanitários específicos.

Integrações que o módulo Sanitário FORNECE para outros módulos:¶

Integração para Módulo de Dashboards e Relatórios: Disponibiliza dados consolidados sanitários para composição de dashboards e relatórios gerenciais e regulatórios.

Todas estas integrações implementam mecanismos robustos de cache e sincronização para garantir o funcionamento adequado em modo offline, seguindo uma arquitetura offline-first que prioriza a operação em campo mesmo em áreas remotas sem conectividade.

Riscos Relacionados a Requisitos¶

Sincronização deficiente de registros sanitários: Falhas nos mecanismos de sincronização podem resultar em aplicações sanitárias não registradas, duplicadas ou com informações incompletas, comprometendo o controle sanitário do rebanho e expondo a operação a riscos regulatórios.
Impacto: Alto
Mitigação: Implementação de mecanismos de verificação de integridade pós-sincronização, confirmação visual de sincronização e alertas para dados pendentes de sincronização por mais de 24 horas.
Inconsistências no controle de estoque sanitário: Aplicações realizadas offline podem gerar discrepancias entre o estoque físico e o virtual, especialmente quando múltiplos usuários acessam os mesmos insumos.
Impacto: Alto
Mitigação: Implementação de reservas de estoque para operações offline, reconciliação periódica obrigatória e indicadores claros de "estoque confirmado" versus "estoque provisório".
Erros de configuração em protocolos sanitários complexos: Protocolos com múltiplas fases, prazos específicos e contra-indicações podem ser configurados incorretamente, resultando em aplicações em momentos inadequados ou com doses impróprias.
Impacto: Crítico
Mitigação: Validações automáticas de protocolos, modelos pré-configurados por especialistas e alertas para configurações atipicas.
Falha no controle de períodos de carência: Aplicações sanitárias realizadas sem o devido registro ou com falhas de sincronização podem comprometer o controle dos períodos de carência, resultando em riscos à saúde pública e penalidades legais.
Impacto: Crítico
Mitigação: Mecanismo de bloqueio de movimentação de animais em carência, alerta visual prominente para todos os usuários e verificação dupla antes de liberação para abate ou venda.
Indisponibilidade de dados sanitários críticos em campo: Falhas no armazenamento local ou na sincronização podem resultar na ausência de informações críticas (como histórico de reações adversas) durante operações de campo.
Impacto: Alto
Mitigação: Cache prioritário de dados críticos, multiplos níveis de backup local e indicação clara da abrangência e atualidade dos dados disponíveis offline.

Funções e Controle de Acesso¶

O módulo de Controle Sanitário define permissões específicas para cada operação e entidade, garantindo que apenas usuários autorizados possam registrar, editar e consultar intervenções sanitárias sensíveis.

Níveis de Acesso por Operação¶

Cadastro de protocolos sanitários: permitido para gestores e técnicos
Registro de aplicações sanitárias: permitido para técnicos e gestores
Configuração de alertas e parâmetros: restrito a gestores
Edição de registros sanitários: restrito a gestores
Visualização de relatórios e histórico: permitido para todos os perfis autorizados

Níveis de Acesso por Entidade¶

Protocolos sanitários: leitura, criação, edição, exclusão (gestores/técnicos)
Registros de aplicações: registro, edição (técnicos/gestores)
Insumos sanitários: vínculo e baixa (técnicos/gestores)
Relatórios e histórico: visualização (todos)
Alertas: visualização (todos), resolução (gestores)

Ações Críticas do Sistema¶

Ações que exigem confirmação adicional ou aprovação para garantir rastreabilidade e evitar erros:

Aprovação¶

Ajustes manuais em protocolos sanitários
Alteração retroativa de registros de aplicação

Confirmação de Identidade¶

Exclusão de registros sanitários
Alteração de protocolos após início de aplicação

Indicadores Possíveis¶

Indicadores Sanitários e de Gestão¶

Percentual de animais/lotes cobertos por protocolos vigentes
Número de aplicações realizadas por período, lote e categoria
Percentual de reaplicações realizadas no prazo
Número de alertas gerados e atendidos
Taxa de sincronização de dados offline
Incidência de falhas sanitárias (ex: protocolos vencidos, aplicações atrasadas)

Oportunidades de Escopos Futuros¶

Considere as oportunidades identificadas apenas como ideias, mas que podem ser distribuídos em outros módulos e em outros domínios.

Automação e Integração Avançada¶

Integração com sistemas oficiais de defesa sanitária: Envio automático de relatórios para órgãos reguladores
Implementação de controle individualizado por animal: Rastreabilidade completa por GTA ou identificação individual
Integração com sensores IoT para rastreio de saúde: Monitoramento automático de sinais vitais e detecção precoce de problemas

Análise Avançada¶

Análise preditiva de saúde do rebanho: Algoritmos para prever surtos e otimizar protocolos preventivos
Avaliação de ROI de protocolos sanitários: Análise financeira detalhada do retorno de diferentes estratégias sanitárias
Dashboards de conformidade e auditoria: Painéis avançados para análise de eficiência e conformidade sanitária

Gestão Financeira Avançada¶

Simulação de custos de tratamentos alternativos: Ferramenta para comparação de protocolos por eficiência e custo
Previsão orçamentária sanitária: Projeção automática de despesas sanitárias com base no histórico e calendário
Integração com sistemas de contabilidade: Classificação contábil automática de despesas sanitárias