Etapa de vacinaçãoRascunho

Eu, como usuário do sistema AgroDigital, quero buscar etapa de vacinação, listar etapa de vacinação, adicionar etapa de vacinação, visualizar etapa de vacinação e editar etapa de atualização para gerenciar etapas de vacinação.

Histórico da fonte

v1.0 - 10/07/2026: Primeira versão da história.

História de usuário

Eu, como usuário do sistema, quero gerenciar etapas de vacinação, para que eu possa permitir a gestão eficiente dessas informações.

1. Buscar etapa de vacinação

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Etapa de Vacinação
Então o sistema exibe a tela de busca, contendo o seguintes campos:

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Código	Inteiro	Não	Tamanho = 6 caracteres Formato = Ano da etapa (4 dígitos) + / + 2 dígitos sequenciais	“2026/02”	Vazio
Doença	Seleção simples de entidade: doença	Não	Valores = doenças cadastradas no sistema	“Brucelose”	Vazio
Espécie	Seleção simples de entidade: espécie	Não	Valores = espécies cadastradas no sistema	“Bovino”	Vazio
Situação	Seleção simples	Não	Valores = “Aberta”, “Criada”, “Finalizada”	“Aberta”	Vazio

E exibe as seguintes ações: (Ver AC001 - Ações das telas de busca)

2. Listar etapa de vacinação

Dado que estou na tela de busca
E pelo menos um campo de busca foi corretamente preenchido
Quando realizo a ação “Pesquisar”
E o sistema encontrou registros compatíveis com os valores informados
Então o sistema exibe os resultados retornados, contendo os seguintes campos:

Campo	Descrição	Exemplo
Código	Exibe a etapa atual de vacinação	“2026/02”
Doença	Exibe a doença para a qual está sendo realizada a vacinação	“Brucelose”
Espécies	Exibe as espécies que estão sendo vacinadas	“Bovino, Bubalino”
Data de Início	Exibe a data de início Formato = dd/mm/aaaa	“11/02/2026”
Data de Fim	Exibe a data fim Padrão: dd/mm/aaaa	“12/02/2026”
Situação	Formato = Exibe a situação	“Aberta”

E exibe as seguintes ações: (Ver AC002 - Ações das telas de listagem)

3. Adicionar etapa de vacinação

Dado que estou na tela de cadastro de uma nova etapa de vacinação
Então o sistema exibe um formulário, contendo os seguintes campos:

Informações Básicas

Campo	Tipo	Obrigatório	Editável	Validações
Código	Texto	Sim	Não	Disponível após o cadastro. Somente leitura Calculado automaticamente Tamanho = 6 dígitos Formato = Ano da etapa (4 dígitos) + “/” + 2 dígitos sequenciais por doença Exemplo = 2026/01
Data de Início	Data	Sim	Sim	-
Data de Fim	Data	Sim	Sim	Deve ser maior que o campo “Data de Início”
Doença	Seleção simples de entidade: doença	Sim	Sim	Valores = doenças cadastradas no sistema

Informações complementares

Campo	Tipo	Obrigatório	Editável	Validações
Possui atestado obrigatório na declaração?	Seleção Simples	Sim	Sim	Valores = “Sim”, “Não”

Espécies da Etapa (Disponível quando “Doença” for preenchido)

Campo	Tipo	Obrigatório	Editável	Validações
Espécie	Seleção múltipla de entidade: espécie	Sim	Sim	Valores = espécies suscetíveis à doença informada

Tipos de Vacinação da Etapa (Um ou mais)

Campo	Tipo	Obrigatório	Editável	Validações
Nome do Tipo de Vacinação	Texto	Sim	Sim	Tamanho = 255 caracteres
Instruções de Vacinação	Texto longo	Não	Não	Tamanho = 1500 caracteres
Exibir na Tabela de Vacinação	Seleção múltipla	Sim	Sim	Valores = “Animais Já Vacinados na Etapa”, “Animais Não Vacinados na Etapa“

Dados da Vacinação Obrigatória por Espécie (Disponível para cada espécie selecionada)

Campo	Tipo	Obrigatório	Editável	Validações
Faixa Etária de Vacinação Obrigatória	Seleção múltipla	Sim	Sim	Valores = faixas etárias da “Espécie” selecionada
Sexo de Vacinação Obrigatória	Seleção múltipla	Sim	Sim	Disponível se a espécie possuir sexo definido Valores = Macho, Fêmea

Tipos de Vacina Aplicáveis (Um ou mais)

Campo	Tipo	Obrigatório	Editável	Validações
Tipo de Vacina	Seleção simples de entidade: Tipo de Vacina	Sim	Sim	Valores = tipos de vacina cadastrados para a doença informada

Situação do Cadastro (Disponível após o cadastro)

Campo	Tipo	Obrigatório	Editável	Validações
Situação	Seleção	Sim	Não	Valores = “Aberta”, “Criada”, “Finalizada Ver seção de regras de negócio

E exibe as seguintes ações: (Ver AC003 - Ações das telas de cadastro e AC006 - Ações de interação com formulários, exceto Baixar Documento)

4. Visualizar etapa de vacinação

Dado que estou na tela de visualização
Então o sistema exibe os campos do formulário descrito no critério de aceitação 3 como somente leitura, com seus valores já preenchidos
E exibe as seguintes ações: (Ver AC004 - Ações das telas de visualizar e AC006 - Ações de interação com formulários)

Outras

Ação	Descrição
Copiar Etapa	Vai para a tela de adicionar uma nova etapa com os dados copiados, com exceção das datas de início e fim

5. Editar etapa de atualização

Dado que estou na tela de edição

Se a Etapa está com a situação “Criada”
Então o sistema exibe todos os campos descritos nos critérios de aceitação 3 com seus valores já preenchidos
E permite editar todos os campos editáveis (EDT = “sim”)

Se a Etapa está com a situação “Aberta”
Então o sistema exibe todos os campos descritos nos critérios de aceitação 3 e 4, com seus valores já preenchidos
E permite editar apenas a Data do Fim e a Situação

E exibe as seguintes ações: (Ver AC005 - Ações das telas de editar e AC006 - Ações de interação com formulários)

Outras

Ação	Descrição
Abrir/Finalizar	Muda a situação do cadastro para “Aberta”/“Finalizada” respectivamente

Regras de negócio específicas

RNE001 - O cadastro de uma etapa de atualização deve possuir o controle de ciclo de vida baseado nas seguintes situações:
- Criada: Situação inicial, atribuída automaticamente assim que o cadastro da etapa é salvo no sistema.
- Aberta: Atribuída automaticamente às 00:00 do dia da “Data de Início” configurada para a etapa.
- Fechada: Atribuída automaticamente às 00:00 do dia seguinte à “Data de Fim” configurada para a etapa.

Exemplo de carga para teste da fonte

Etapa de Vacinação contra Brucelose:

Data de Início: 01/01/2026
Data de Fim: 30/06/2026
Doença: Brucelose
Espécies: Bovino, Bubalino
Tipo de Vacinação: Vacinação Oficial
- Faixas etárias: Bovinos: 0 a 12 meses | Bubalinos: 0 a 12 meses
- Sexo: Fêmeas
- Tipos de Vacina Aceitos: Vacina de Brucelose RB51 | Vacina de Brucelose B19
- Instruções de vacinação: A vacinação oficial deve ocorrer apenas em fêmeas de 03 a 08 meses.
Tipo de Vacinação: Vacinação Complementar
- Faixas etárias aceitas: Bovinos: Todas | Bubalinos: Todas
- Sexo: Fêmeas
- Tipos de Vacina Aceitos: Vacina de Brucelose RB51
- Instruções de vacinação: A vacinação complementar deve ocorrer em fêmeas acima de 8 meses.
- Exibir na Tabela de Vacinação: “Animais Já Vacinados na Etapa”, “Animais Não Vacinados na Etapa“

Etapa de Vacinação contra Raiva:

Data de Início: 01/01/2026
Data de Fim: 31/12/2026
Doença: Raiva
Espécies: Bovino, Bubalino, Caprino, Ovino, Equino, Asinino, Muar
Tipo de Vacinação: Primeira Dose
- Faixas etárias aceitas: Todas para todas as espécies
- Sexo: Ambos
- Tipos de Vacina Aceitos: Vacina de Raiva
- Adicionar instruções de vacinação?: Não
Tipo de Vacinação: Segunda Dose
- Faixas etárias aceitas: Todas de todos
- Tipos de Vacina Aceitos: Vacina de Raiva
- Adicionar instruções de vacinação?: Não

Documentos vinculados

Convenções da conversão

As colunas Obrigatório e Editável correspondem a OBG e EDT da fonte. A edição posterior observa também as condições de somente leitura e de situação do cadastro. Campos, exemplos, padrões e referências recebidos foram preservados, sem criar valores ausentes.

Pendências da fonte

A fonte não informa código US; nenhum identificador foi criado.
O formulário usa Finalizada, enquanto a RNE001 define Fechada. Confirmar o nome da situação de encerramento; a regra de horários foi preservada.
A busca tipa Código como Inteiro e informa tamanho de 6 caracteres, mas a máscara AAAA/NN inclui uma barra. Confirmar tipo e contagem de caracteres.
O critério de edição e a RNE001 mencionam etapa de atualização. Os títulos e textos originais foram preservados para confirmação da nomenclatura.
Em Aberta, o cenário permite editar Situação, embora seu EDT seja Não. Confirmar a alteração pelo controle Abrir/Finalizar e o comportamento de etapas encerradas.
Possui atestado obrigatório na declaração? aparece na seção geral da etapa; a declaração refere-se ao Tipo de Vacinação da Etapa. Confirmar o escopo da configuração.
O exemplo de carga foi preservado como dado de teste da fonte, sem transformá-lo em regra adicional. A fonte não define fuso horário nem bloqueio de sobreposição entre etapas.