Módulo de Manejo de Rebanho¶

Sigla: MANR (Manejo de Rebanho)
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 Manejo de Rebanho permite o controle e acompanhamento das movimentações e agrupamentos de animais por lote e categoria. Com foco na rastreabilidade e consistência das informações, o sistema garante que as operações em campo sejam refletidas na gestão zootécnica e financeira da propriedade, permitindo visão por categoria, localização, histórico e destino dos animais.

Escopo Inicial¶

Cadastro de Subcategorias de animais
Registro quantitativo de lotes por categoria
Movimentação de animais entre pastos e retiros
Evolução automática de categoria por peso e idade
Registro de entradas (compras) e saídas (vendas, mortes)
Registro de ocorrências e eventos de campo relacionados aos animais
Auditoria de consistência do rebanho

Configurações¶

Definição de categorias principais e subcategorias personalizadas
Parâmetros de evolução automática por idade ou peso
Permitir ou bloquear movimentações com inconsistência de saldo
Integração com preço de mercado por categoria para valorização

Funcionalidades¶

Agrupamento por lotes: Cadastro de lotes de animais com peso médio e fase (cria, recria, engorda)
Movimentações de animais: Registro de movimentações entre pastos com validação de saldo
Entradas e saídas: Registro de compras, vendas, perdas, mortes com motivo
Histórico: Histórico de movimentações por lote
Visualização por pasto: Visualização do rebanho por pasto, retiro e categoria
Visualização por retiro: Visualização do rebanho por retiro e categoria
Visualização por categoria: Visualização do rebanho por categoria
Visualização por fazenda: Visualização do rebanho por fazenda
Evolução: Evolução automática de categoria com base em regras configuradas
Validação: Validação de consistência do rebanho (controle total)
Alertas: Alertas de divergência entre contagem física e sistema
Capacidade de pasto: Gestão avançada da capacidade de suporte por pasto considerando UA (Unidade Animal), carga animal, qualidade de forragem e sazonalidade

Requisitos Funcionais¶

RF-MANR-001: Categorias de animais imutáveis
Descrição: Categorias de animais já devem estar definidas e imutáveis.
Critério de aceitação: Categorias de animais já devem estar definidas e imutáveis.
Prioridade: Alta
RF-MANR-002: Categorias de animais com regras de evolução
Descrição: Categorias de animais devem ter regras de evolução configuradas internamente pelo sistema.
Critério de aceitação: Categorias de animais devem ter regras de evolução configuradas internamente pelo sistema.
Prioridade: Alta
RF-MANR-003: Subcategorias de animais personalizadas
Descrição: O sistema deve permitir cadastrar subcategorias personalizadas de animais.
Critério de aceitação: Deve ser possível definir nomes, faixa etária, uso e valor médio de mercado.
Prioridade: Alta
RF-MANR-004: Lotes com categorias e objetivos
Descrição: O sistema deve permitir cadastrar lotes de animais com categoria, peso médio e fase produtiva.
Critério de aceitação: Deve ser possível definir nomes, faixa etária, uso e valor médio de mercado.
Prioridade: Alta
RF-MANR-005: Tipos de lote
Descrição: O sistema deve permitir cadastrar tipos de lotes, com objetivos claros e desrição.
Critério de aceitação: Deve ser possível definir nomes, objetivos e descrição.
Prioridade: Alta
RF-MANR-006: Controle de lotes com tipos
Descrição: Quando se cadastrar um lote, seu tipo deve ser especificado, pois o lote é um agrupamento de aplicação de uma determinada ação em um grupo de animais, aqui regido por categorias.
Critério de aceitação: Lote com tipo e descrição clara.
Prioridade: Alta
RF-MANR-007: Movimentações quantitativas entre pastos por lote
Descrição: O sistema deve permitir registrar movimentações quantitativas entre pastos, incluindo pastos de outros retiros ou fazendas que o usuário tenha acesso.
Critério de aceitação: Deve ser possível registrar movimentações quantitativas entre pastos e fazendas ou retiros.
Prioridade: Alta
RF-MANR-008: O sistema deve registrar automaticamente a evolução de categoria com base em regras de idade e peso.
Critério de aceitação: A mudança de categoria ocorre ao atingir os parâmetros definidos.
Prioridade: Alta
RF-MANR-009: O sistema deve registrar entradas (compras) e saídas (vendas, mortes) com motivo e documentação.
Critério de aceitação: Cada registro deve conter data, motivo, quantidade, destino/origem e observação.
Prioridade: Alta
RF-MANR-010: O sistema deve permitir visualizar o histórico completo de movimentações de cada lote.
Critério de aceitação: Deve ser possível filtrar por período, pasto, categoria e tipo de movimentação.
Prioridade: Média
RF-MANR-011: O sistema deve emitir alertas quando houver divergência entre a contagem física.
Critério de aceitação: Alertas devem identificar o lote, local, e o tipo de divergência.
Prioridade: Alta
RF-MANR-013: Gestão de capacidade de pasto
Descrição: O sistema deve permitir definir e monitorar a capacidade de suporte de cada pasto em termos de UA (Unidade Animal).
Critério de aceitação: Deve ser possível configurar a capacidade máxima de UA por pasto, considerando variações sazonais (período seco/chuvoso).
Critério de aceitação: O sistema deve calcular automaticamente a taxa de ocupação atual de cada pasto.
Critério de aceitação: Alertas devem ser emitidos quando a ocupação ultrapassar limites pré-definidos (80%, 90%, 100%).
Prioridade: Alta
Dependência: Módulo de Fazenda
RF-MANR-014: Cálculo dinâmico de capacidade de suporte
Descrição: O sistema deve permitir ajustes dinâmicos na capacidade de suporte com base em fatores sazonais e manejo.
Critério de aceitação: Deve ser possível registrar avaliações de massa forrageira e qualidade de pastagem.
Critério de aceitação: O sistema deve recalcular a capacidade de suporte com base nessas avaliações.
Critério de aceitação: Histórico de capacidade de suporte e ocupação deve ser mantido para análises.
Prioridade: Média
Dependência: Módulo de Fazenda
RF-MANR-012: Configurações de restrição de inconsistências quantitivas
Descrição: O sistema deve permitir configurar restrições de inconsistências quantitivas. Ou seja, na movimentação de animais, se a quantidade exceder a quantidade limite existente de animais, devemos ser capazes de permitir ou não que o registro aconteça. Se sim, deve-se gerar um alerta. Se não, a movimentação deve ser impedida.
Critério de aceitação: Em caso de permissão de registros incosistentes, deve ser possível configurar restrições de permissão de registro quantidade de animais com valor negativo. Caso contrário, deve-se impedir a movimentação.
Prioridade: Alta

Requisitos Não Funcionais¶

RNF-MANR-001: Arquitetura offline-first para operações em campo
Descrição: O módulo deve implementar uma arquitetura offline-first para garantir operações completas de manejo em áreas remotas sem conectividade, incluindo todas as movimentações, registros de entrada/saída e consultas.
Critério de aceitação: Dados lançados offline devem ser armazenados localmente com timestamp e identificador único, e sincronizados automaticamente quando a conexão for reestabelecida.
Critério de aceitação: Sistema deve manter uma cópia local da base de dados do rebanho para consultas e validações, mesmo sem conexão.
Critério de aceitação: Conflitos de sincronização devem ser identificados e tratados seguindo estas regras específicas:
- Para movimentações conflitantes do mesmo lote: aplicar em ordem cronológica com alerta para movimentações que resultem em saldo negativo
- Para entradas e saídas: preservar todos os registros mesmo em duplicidade, com notificação para revisão
- Para evoluções de categoria: aplicar a mais recente com base no timestamp
Critério de aceitação: Interface deve indicar claramente o status de sincronização dos registros e alertar inconsistências.
Prioridade: Alta
RNF-MANR-002: Desempenho em dispositivos móveis
Descrição: A interface de registro de movimentações deve ser otimizada para uso em campo.
Critério de aceitação: Operações devem ser concluídas em menos de 3 segundos em dispositivos padrão.
Critério de aceitação: Interface adaptada para telas de diferentes tamanhos e uso com luvas.
Prioridade: Alta
RNF-MANR-003: Precisão e consistencia de dados
Descrição: O sistema deve garantir a precisão e consistencia dos dados de rebanho mesmo com operações concorrentes.
Critério de aceitação: Controle transacional para evitar inconsistências em acessos simultâneos.
Critério de aceitação: Validação matemática de saldos em todos os níveis (pastos, retiros, fazendas).
Prioridade: Alta

Regras de Negócio¶

RN-MANR-001: Balanceamento de rebanho
Descrição: A quantidade total de animais por fazenda deve ser consistente entre pastos, lotes e totais registrados.
Prioridade: Alta
RN-MANR-002: Unicidade de movimentação
Descrição: Um lote não pode ser movimentado para duas localidades ao mesmo tempo.
Prioridade: Alta
RN-MANR-003: Evolução de categoria
Descrição: A evolução de categoria só ocorre se todos os parâmetros definidos forem atendidos.
Prioridade: Alta
RN-MANR-004: Justificação de baixas
Descrição: Saídas por morte ou perda devem ser justificadas e rastreáveis.
Prioridade: Alta
RN-MANR-005: Capacidade de suporte de pastos
Descrição: A quantidade de animais (em UA) não deve exceder a capacidade de suporte configurada para o pasto.
Prioridade: Alta
RN-MANR-006: Ajuste sazonal de capacidade
Descrição: A capacidade de suporte deve considerar ajustes sazonais (período seco/chuvoso).
Prioridade: Média
RN-MANR-007: Notificação sanitária em movimentações
Descrição: Movimentações de animais sob tratamento sanitário devem gerar notificação automática.
Prioridade: Alta

Critérios de Aceitação¶

Cadastro de categorias e lotes funcionando conforme esperado
Movimentações refletem corretamente a posição do rebanho
Sistema impede ou alerta movimentações inconsistentes
Histórico de movimentações visível com filtros adequados
Evolução de categoria ocorre automaticamente conforme parâmetros

Dependências¶

Módulo de Membros da Fazenda (para registro de responsáveis pelas operações)

Integrações¶

Integrações que o módulo Manejo de Rebanho SOLICITA de outros módulos:¶

Integração com Sistema de Notificações Interno: Solicita o envio de alertas para inconsistências, super-lotação de pastos e eventos críticos.

Integrações que o módulo Manejo de Rebanho FORNECE para outros módulos:¶

Integração para Módulo de Estoque: Fornece informações sobre quantidade e categoria de animais para fins de valorização de ativos biológicos.
Integração para Módulo de Plano de Rotina: Fornece informações sobre ocupação de pastos e necessidades de manejo para planejamento de atividades.
Integração para Dashboards e Relatórios: Disponibiliza API para consulta de dados consolidados de rebanho para composição de dashboards e relatórios gerenciais.

Estas integrações seguem um padrão de API consistente, com documentação detalhada para consumo por outros módulos.

Riscos Relacionados a Requisitos¶

Inconsistência na contagem física versus sistema
Erro de parametrização gerando evolução incorreta
Lançamentos duplicados em movimentações offline

Funções e Controle de Acesso¶

O módulo de Manejo de Rebanho define permissões específicas para cada operação e entidade, garantindo que apenas usuários autorizados possam realizar movimentações, ajustes e consultas sensíveis.

Níveis de Acesso por Operação¶

Cadastro de categorias e lotes: permitido para gestores e técnicos
Movimentação de animais: permitido para técnicos, gestores e operadores
Edição de histórico ou correção de inconsistências: restrito a gestores
Visualização de relatórios e histórico: permitido para todos os perfis autorizados

Níveis de Acesso por Entidade¶

Categorias: leitura, criação, edição (gestores/técnicos)
Lotes: leitura, criação, edição, exclusão (gestores/técnicos)
Movimentações: criação, consulta (técnicos/operadores)

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 de saldo de lotes
Correção de inconsistências após auditoria

Confirmação de Identidade¶

Exclusão de lotes
Alteração retroativa de movimentações

Indicadores Possíveis¶

Indicadores de Gestão e Consistência¶

Percentual de Divergências: Proporção entre contagem física e registros no sistema
Tempo de Resolução: Período médio para correção de alertas e inconsistências
Volume de Movimentações: Número de movimentações realizadas por período e tipo
Progresso Zootécnico: Evolução de categorias por lote ao longo do tempo
Eficiência de Sincronização: Taxa de sincronização bem-sucedida de dados offline

Indicadores de Capacidade e Ocupação¶

Taxa de Ocupação de Pastos: Percentual de utilização da capacidade de suporte
Distribuição de Carga Animal: UA por hectare em diferentes pastos e épocas
Variação Sazonal: Mudança na capacidade de suporte entre períodos seco/chuvoso
Eficiência de Uso: Relação entre ganho de peso e capacidade utilizada
Índice de Sobrecarga: Frequência de pastos com ocupação acima do ideal

Indicadores de Integração Sanitária¶

Rastreabilidade Sanitária: Percentual de lotes com histórico sanitário completo
Movimentações Sanitárias: Número de movimentações relacionadas a protocolos sanitários
Isolamento Preventivo: Frequência de isolamento de lotes por questões sanitárias
Conformidade de Quarentena: Percentual de cumprimento de períodos de quarentena

Oportunidades de Escopos Futuros¶

As oportunidades abaixo são sugestões de aprimoramento e expansão do módulo de manejo de rebanho, considerando apenas gestão de pessoas, atribuição de papéis, engajamento, capacitação e comunicação.

Tecnologias IoT e Automação¶

Integração com sensores IoT para contagem automática de animais
Balanças automáticas integradas para atualização de peso médio
Cercas virtuais para manejo rotacionado e monitoramento de movimentação
Drones para avaliação automática de massa forrageira e capacidade de pasto

Análise Avançada e IA¶

Dashboards interativos de desempenho zootécnico por categoria
Análise preditiva de perdas, evolução e ganho de peso
IA para otimização da distribuição de animais entre pastos
Detecção precoce de anomalias em padrões de movimentação

Integração Avançada¶

Integração com marketplaces para venda automática de lotes prontos
Sincronização com sistemas de rastreabilidade governamentais
Interface com sistemas de planejamento forrageiro e clima
Integração aprofundada com módulo sanitário para predição de protocolos

Expansão de Funcionalidades¶

Gestão de capacidade de suporte com simulações de cenários climáticos
Cálculo automático de ajuste de carga animal baseado em qualidade forrageira
Sistema de recomendação para manejo rotacionado ideal
Rastreabilidade individual com identificação eletrônica