Taxa de controle da espéciePronto

Eu, como usuário do sistema AgroDigital, quero listar taxas de controle da espécie, cadastrar taxa de controle, visualizar taxa de controle e editar taxa de mortalidade para gerenciar taxas de controle das espécies.

1. Listar taxas de controle da espécie

Dado que estou na tela de listagem de taxas de controle de uma espécie
Então o sistema exibe as informações a seguir.

Mortalidade — cadastro ativo (zero ou um)

O cadastro contém zero ou mais tamanhos de rebanho e, para cada tamanho, zero ou mais itens de faixa etária e taxa.

Campo	Tipo	Descrição	Exemplo
Tamanho do Rebanho	Texto	Tamanho do rebanho para o qual a taxa é válida.	De 1 Até 20 animais
Faixa Etária	Texto	Faixa etária da espécie.	De 0 Até 12 meses
Taxa de Mortalidade [ ] %	Inteiro	Porcentagem aceita de mortalidade para o tamanho de rebanho e a faixa etária.	30%

Mortalidade — histórico de cadastros inativos (zero ou mais)

Cada cadastro inativo exibe os mesmos campos do cadastro ativo de mortalidade.

Natalidade — cadastro ativo (zero ou um)

Campo	Tipo	Descrição	Exemplo
Início do Ciclo Reprodutivo das Fêmeas	Texto	Faixa etária de início do ciclo reprodutivo das fêmeas da espécie.	De 13 Até 24 meses
Fim do Ciclo Reprodutivo das Fêmeas	Texto	Faixa etária de fim do ciclo reprodutivo das fêmeas da espécie.	Acima de 24 meses
Taxa de Natalidade [ ] %	Texto	Porcentagem aceita de natalidade.	100%

O sistema exibe as ações comuns de listagem, conforme AC002 — Ações das telas de listagem.

2. Cadastrar taxa de controle

Dado que estou na tela de cadastro de taxas de controle da espécie
Então o sistema exibe o formulário descrito a seguir.

Tipo de taxa

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Taxa	Seleção simples	Sim	Valores = Mortalidade, Natalidade.	Mortalidade	Vazio

Mortalidade

Disponível se Tipo de Taxa = Mortalidade.

A taxa define o limite máximo de mortes permitido no sistema. Conforme a ajuda do formulário da fonte, se o limite for ultrapassado, o sistema gera alertas de inspeção sem bloquear os lançamentos. O cálculo é baseado no total do rebanho.

Tamanhos de rebanho — intervalos fechados (zero ou mais)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
De [ ] animais	Inteiro	Sim	Somente leitura. No primeiro intervalo, valor = 1. Nos demais, deve ser maior que Até do intervalo anterior.	0 (exemplo da fonte, divergente da validação)	Vazio
Até [ ] animais	Inteiro	Sim	Deve ser maior que De do mesmo intervalo.	12	Vazio

Tamanho de rebanho — intervalo final (um)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Acima de [ ] animais	Inteiro	Sim	Somente leitura. Se for o único intervalo, valor = 0. Se houver outros intervalos, valor = Até do intervalo anterior.	13 (exemplo da fonte, divergente de um intervalo anterior até 12)	Vazio

Porcentagem por faixas etárias (zero ou mais)

Disponível para cada tamanho de rebanho informado.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Faixa Etária	Seleção múltipla de entidade: faixa etária	Sim	Valores = faixas etárias cadastradas para a espécie.	De 0 Até 12 meses	Vazio
Taxa de Mortalidade [ ] %	Inteiro	Sim	Deve ser maior ou igual a 0% e menor ou igual a 100%.	30%	Vazio

Natalidade

Disponível se Tipo de Taxa = Natalidade.

A taxa define o limite máximo de nascimentos permitido no sistema. Conforme a ajuda do formulário da fonte, se o limite for ultrapassado, o sistema gera alertas de inspeção sem bloquear os lançamentos. O cálculo é baseado no total do rebanho. Essa definição diverge de outras histórias, conforme as pendências registradas ao final.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Início do Ciclo Reprodutivo das Fêmeas	Seleção de entidade: faixa etária	Sim	Valores = faixas etárias cadastradas para a espécie.	De 13 Até 24 meses	Vazio
Fim do Ciclo Reprodutivo das Fêmeas	Seleção de entidade: faixa etária	Sim	Valores = faixas etárias cadastradas para a espécie. Deve ser maior ou igual ao Início do Ciclo Reprodutivo das Fêmeas.	De 13 Até 24 meses	Vazio
Taxa de Natalidade [ ] %	Inteiro	Sim	Deve ser maior ou igual a 0%. A fonte não define limite máximo.	100%	Vazio

Ações

O sistema exibe as ações comuns de cadastro, conforme AC003 — Ações das telas de cadastro. Ao salvar uma nova taxa, aplica-se a inativação automática da RNE001.

3. Visualizar taxa de controle

Dado que estou na tela de visualização
Então o sistema exibe os campos do cadastro preenchidos e como somente leitura, além da situação do cadastro, conforme CAC001 — Visualizar situação do cadastro de uma entidade.

O sistema exibe as ações comuns de visualização, conforme AC004 — Ações das telas de visualização.

4. Editar taxa de mortalidade

Dado que estou na tela de edição
Então o sistema exibe os campos do cadastro e da visualização preenchidos. Os campos do cadastro são editáveis, exceto Tipo de Taxa e os campos definidos como somente leitura no formulário. Os campos adicionais da visualização também permanecem como somente leitura.

O sistema exibe as ações comuns de edição, conforme AC005 — Ações das telas de edição.

O título do critério na fonte menciona apenas mortalidade, embora o formulário referenciado contemple ambos os tipos. A edição de natalidade precisa ser confirmada.

Regras de negócio específicas

RNE001 — Um cadastro ativo por tipo e espécie

Ao cadastrar uma nova taxa de controle para a espécie, o último cadastro realizado do mesmo tipo deve ser automaticamente inativado, garantindo apenas um cadastro ativo por vez para cada tipo.

Exemplo da fonte — mortalidade de bovinos e bubalinos

Percentuais por faixa etária e tamanho do rebanho, conforme o exemplo fornecido na história. Os limites foram preservados para conferência.

Tamanho do rebanho (número de animais)	Faixa etária	Porcentagem de mortalidade
1 a 10	0 a 12 meses	50%
1 a 10	Acima de 13 meses	30%
11 a 20	0 a 12 meses	30%
11 a 20	Acima de 13 meses	20%
21 a 50	0 a 12 meses	20%
21 a 50	Acima de 13 meses	10%
51 a 100	0 a 12 meses	10%
51 a 100	Acima de 13 meses	5%
Acima de 101	0 a 12 meses	8%
Acima de 101	Acima de 13 meses	4%

Histórico da fonte

Versão	Data	Alteração
v1.0	05/05/2026	Primeira versão da história.

Histórias e referências relacionadas

• US016 — Espécie.
• US082 — Faixa etária da espécie, utilizada na seleção das faixas do formulário.
• Portaria nº 2227, de 29 de abril de 2023, referência fornecida na fonte.
• Documentação comum a várias histórias: AC002 a AC005 e CAC001, citados na fonte.
• Componentes.
• Vinculações de cadastros.
• Manual de padronização da PGA.

Pendências da fonte

• As condições de exibição mencionam Tipo de Faixa, mas o campo do formulário é Tipo de Taxa. As referências foram uniformizadas para o campo existente.
• O rótulo Taxa de Motilidade foi adequado para Taxa de Mortalidade, e os tipos de seleção que mencionavam eternidade foram adequados para entidade.
• Os exemplos De 0 animais e Acima de 13 animais não correspondem às regras descritas para o primeiro intervalo e para um intervalo anterior que termina em 12. Os exemplos foram preservados para conferência.
• O limite De é somente leitura, mas a fonte apenas determina que seja maior que Até do intervalo anterior, sem definir o cálculo exato. Confirmar o cálculo dos intervalos seguintes.
• O exemplo de mortalidade utiliza Acima de 101 após o intervalo de 51 a 100 animais e Acima de 13 meses após a faixa de 0 a 12 meses. Confirmar a inclusão dos valores de fronteira e a eventual existência de lacunas.
• A ajuda de natalidade prevê cálculo sobre o total do rebanho e alertas sem bloqueio. A US084 prevê cálculo sobre fêmeas em idade reprodutiva e bloqueio quando o limite parametrizado é ultrapassado; a US085 também usa fêmeas em idade reprodutiva e impede taxa superior a 100%. Confirmar as regras entre as histórias, sem alterar essas definições nesta conversão.
• O critério de edição menciona apenas taxa de mortalidade, enquanto os campos referenciados incluem natalidade. Confirmar o escopo da edição e a manutenção dos limites somente leitura.
• A listagem detalha histórico de inativos apenas para mortalidade, mas a RNE001 também inativa cadastros de natalidade. Confirmar a exibição do histórico de natalidade.