Campo complementar à espéciePronto

Código da história:US020

Eu, como usuário do sistema AgroDigital, quero buscar campo complementar à espécie, listar campos complementares às espécies, cadastrar campo complementar à espécie, visualizar campo complementar à espécie e editar campo complementar à espécie para gerenciar campos complementares às espécies.

1. Buscar campo complementar à espécie

Dado que estou na tela de busca de espécies
Quando acesso o menu Campos Complementares à Espécie
Então o sistema exibe a tela de busca.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Campo Complementar	Seleção simples	Não	Valores definidos na seção Tipos de campo complementar.	`Tipo de Manejo`	Vazio
Grupo da Espécie	Seleção simples	Não	Valores definidos na seção Grupos de espécies da fonte.	`Bovídeos`	Vazio
Espécie	Seleção de entidade: espécie	Não	Valores = espécies cadastradas no sistema (US016). Pré-filtradas pelo grupo, conforme RNE004.	`Bovinos`	Vazio
Situação	Seleção simples	Não	Valores = `Ativo`, `Inativo`.	`Ativo`	Vazio

O sistema exibe a mensagem Busque por campos complementares às espécies utilizando o campo de busca acima.

Ação	Comportamento
Adicionar Novo	Abre o cadastro de campo complementar à espécie.
Pesquisar	Realiza a busca utilizando os filtros informados.
Espécie	Retorna à busca de espécies.

2. Listar campos complementares às espécies

Dado que estou na tela de busca
E pelo menos um filtro foi preenchido corretamente
Quando realizo a ação Pesquisar
Então o sistema retorna os registros compatíveis e exibe:

Campo	Tipo	Ordenável	Descrição	Exemplo
Tipo de Campo Complementar	Texto	Sim	Tipo do campo complementar.	`Tipo de Manejo`
Lista de espécies vinculadas ao campo, separadas por vírgula	Texto	Sim	Espécies associadas ao campo complementar.	`Bovinos, Suínos`
Situação	Texto	Sim	Situação do cadastro.	`Ativo`

Para cada resultado, o sistema exibe Visualizar e Editar, que abrem as respectivas telas do cadastro selecionado.

3. Cadastrar campo complementar à espécie

Dado que estou na tela de cadastro
Então o sistema exibe o formulário descrito a seguir.

Campo complementar

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo do campo complementar	Seleção simples	Sim	Valores definidos na seção Tipos de campo complementar. Unicidade por espécie, conforme RNE001.	`Tipo de Manejo`	Vazio

Valores (um ou mais)

Cada item contém:

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Valor	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres. Único dentro do cadastro, conforme RNE002.	`Extensivo`	Vazio

Espécies (uma ou mais)

Cada item agrupa os campos Grupo e Espécie, conforme RNE002 e RNE003.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Grupo	Seleção simples	Sim	Valores definidos na seção Grupos de espécies da fonte.	`Bovídeos`	Vazio
Espécie	Seleção de entidade: espécie	Sim	Valores = espécies cadastradas no sistema (US016). Pré-filtradas por Grupo, conforme RNE004. Não permite repetir uma espécie no cadastro.	`Bovinos`	Vazio

Ações e resultado

Ação	Comportamento
Adicionar	Valida os dados, salva o cadastro e abre a tela de sucesso.
Adicionar/Remover item	Adiciona ou remove itens dos grupos repetíveis de valores e espécies, respeitando os mínimos do formulário.
Todos os campos complementares às espécies	Retorna à tela de busca.

Em caso de sucesso, o sistema exibe uma mensagem e as ações Voltar, que retorna à busca, e Visualizar, que abre a visualização do cadastro.

4. Visualizar campo complementar à espécie

Dado que estou na tela de visualização
Então o sistema exibe os campos do cadastro preenchidos e como somente leitura e acrescenta:

Seção	Campo	Tipo	Descrição	Exemplo
Situação do Cadastro	Situação	Texto	Situação atual do cadastro.	`Ativo`
Alterações do Cadastro	Usuário	Texto	Usuário que efetuou a última alteração.	`Lucas Pedro Conte`
Alterações do Cadastro	Data e Hora da Modificação	Data e hora	Data e hora da última alteração.	`14/04/2012 07:29`

O sistema exibe Editar, que abre a edição, e Todos os campos complementares às espécies, que retorna à busca.

5. Editar campo complementar à espécie

Dado que estou na tela de edição
Então o sistema exibe o cadastro preenchido, respeitando as restrições a seguir.

Campo ou grupo	Restrição
Tipo do campo complementar	Somente leitura.
Valores	Permite apenas adicionar novos valores; não permite alterar ou remover os já cadastrados.
Espécies	Permite apenas adicionar novas espécies; não permite alterar ou remover as já vinculadas.
Situação, Usuário e Data e Hora da Modificação	Somente leitura.

Ação	Comportamento
Salvar	Abre a confirmação das edições.
Adicionar/Remover item	Ação genérica indicada na fonte para grupos repetíveis; sua disponibilidade deve respeitar as restrições de edição acima. Ver pendências da fonte.
Ativar/Inativar	Alterna a situação entre `Ativo` e `Inativo`, conforme CA002 e RN002.
Visualizar campo complementar à espécie	Retorna à visualização.

Na confirmação, Cancelar retorna à edição; Salvar valida os dados, persiste as alterações e retorna à visualização.

Regras de negócio específicas

RNE001 — Unicidade por tipo e espécie

O cadastro deve ser único pela combinação de tipo do campo complementar e espécie vinculada. Não pode haver dois cadastros de Tipo de Manejo para a espécie Bovino, por exemplo.

RNE002 — Valores e grupos repetíveis

O cadastro pode conter múltiplos valores e múltiplos itens de espécie. Cada valor deve ser único dentro do cadastro. Cada item de espécie agrupa Grupo e Espécie.

Exemplo: um campo de Tipo de Manejo pode oferecer os valores Intensivo, Extensivo e Semi extensivo.

RNE003 — Espécies vinculadas sem repetição

O cadastro pode ter mais de uma espécie vinculada, desde que cada espécie apareça uma única vez. Um mesmo campo de Tipo de Manejo pode estar associado a Bovinos e Suínos, por exemplo.

RNE004 — Espécies por grupo

Os valores do campo Espécie devem ser pré-filtrados pelo grupo informado em Grupo da Espécie, na busca, ou em Grupo, no cadastro.

Tipos de campo complementar

O campo de tipo, na busca e no cadastro, admite Tipo de Manejo, Área de Atuação, Venda de reprodutores e Tipo de Exploração.

Grupos de espécies da fonte

Os campos de grupo, na busca e no cadastro, utilizam as opções abaixo, preservadas conforme a US020:

Anfíbios.
Aves.
Bovídeos.
Crustáceos.
Equídeos.
Grandes Roedores.
Invertebrados Aquáticos.
Moluscos.
Outras Espécies.
Peixes.
Répteis.
Suídeos.
Tayassuídeos.

Critérios de aceitação e regras comuns

Aplicam-se os critérios e regras do documento comum às histórias:

CA001 — Salvar cadastro de uma entidade.
CA002 — Ativar/desativar cadastro de uma entidade.
CA003 — Notificar erro ao usuário devido a falha técnica.
RN001 — Situação do cadastro de uma entidade.
RN002 — Ativação/desativação de cadastros de uma entidade.
RN003 — Controle de alterações em uma entidade.
RN007 — Permissões de acesso.

Histórico da fonte

Versão	Data	Alteração
v.2.0	04/08/2025	Atualização para o novo formato.
v1.1	26/06/2025	Adição do link do protótipo.
v1.0	23/04/2025	Versão inicial.

Histórias e referências relacionadas

US016 — Cadastro e edição de espécie.
US021 — Busca de campo complementar à espécie, referência mantida conforme a fonte; a US020 fornecida já inclui busca e listagem.
Planilha de Módulos e Permissões do sistema.

Protótipos

Pendências da fonte

A edição permite apenas acrescentar valores e espécies, mas também oferece a ação genérica Adicionar/Remover item. Confirmar se a remoção se aplica apenas a itens novos ainda não salvos.
A fonte referencia US017 para retornar à busca de espécies e US021, US029 e US027 em diferentes retornos à busca de campos complementares. A navegação foi descrita pelo destino funcional; os identificadores precisam ser confirmados.
Os critérios repetem a numeração 1, 2 e 3 após a busca. Foram reorganizados em uma sequência única nesta conversão.
A mensagem de busca menciona um campo de texto, mas o formulário fornecido contém apenas filtros de seleção. A mensagem foi preservada para conferência.
A US020 lista Invertebrados Aquáticos e Tayassuídeos, enquanto a US016 lista Invertebrados e Taiassuídeos. Confirmar a nomenclatura e o conjunto de grupos; as opções das fontes foram preservadas.
O exemplo de grupo Bovídeo foi alinhado à opção disponível Bovídeos.
A descrição original utiliza o nome SIDAGRO; confirmar a identificação aplicável ao AgroDigital.