EspéciePronto

Eu, como usuário do sistema AgroDigital, quero buscar espécie, listar espécie, adicionar espécie, visualizar espécie e editar espécie para gerenciar espécies.

Esta página foi atualizada com a fonte Espécie, v1.1 de 04/08/2026. O identificador US016 foi mantido do cadastro existente; o novo arquivo não informa código de história.

Histórico da fonte

• v1.1 - 04/08/2026: Conversão para o formato completo.
• v1.0 - 09/07/2026: Primeira versão da história.

História de usuário

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

1. Buscar espécie

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Espécie (Ver RNC007 - Permissões de Acesso)
Então o sistema exibe a tela de busca, contendo os seguintes filtros:

Campo	Tipo	Obrigatório	Validações
Nome da Espécie ou Código do MAPA	Texto	Não	Tamanho = 255 caracteres
Situação do Cadastro	Texto	Não	Valores = “Ativo”, “Inativo”

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

2. Listar espécie

Dado que estou na tela de busca
E o campo de busca e/ou pelo menos um dos filtros disponíveis 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
Espécie	Exibe o nome da espécie
Código MAPA	Exibe o código do MAPA
Situação do Cadastro	Exibe o estado do cadastro

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

3. Adicionar espécie

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

Informações Básicas

Campo	Tipo	Obrigatório	Editável	Validações
Grupo	Seleção simples	Sim	Não	Valores = “Anfíbios”, “Aves”, “Bovídeos”, “Crustáceos”, “Equídeos”, “Grandes Roedores”, “Invertebrados”, “Moluscos”, “Outras Espécies”, “Peixes”, “Répteis”, “Suídeos”, “Taiassuídeos”
Nome da Espécie	Texto	Sim	Sim	Tamanho = 255 caracteres
Nome Científico	Texto	Não	Sim	Tamanho = 255 caracteres
Código do MAPA	Numérico	Sim	Sim	Tamanho = 5 dígitos Formato = XX.XX De acordo com o manual de integração do MAPA

Informações Complementares

Campo	Tipo	Obrigatório	Editável	Validações
Possui Sexo Definido?	Seleção	Sim	Sim	Valores = “Sim”, “Não”
Possui Controle de Rebanho por Núcleo?	Seleção	Sim	Sim	Valores = “Sim”, “Não”
Número máximo de animais por GTA	Inteiro	Não	Sim	-
Permite Emissão de GTA por Habilitado?	Seleção	Sim	Sim	Valores = “Sim”, “Não”
Utiliza Formulário para a Emissão de GTA?	Seleção	Sim	Sim	Valores = “Sim”, “Não”

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

4. Visualizar espécie

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, além desses, exibe os seguintes campos, também como somente leitura:

Situação

Campo	Tipo	Obrigatório	Editável	Validações
Situação	Seleção simples	Sim	Sim	Valores = “Ativo”, “Inativo”

E também exibe as seguintes abas:

Aba
Faixa Etária
Taxa de Controle
Raça

5. Editar espécie

Dado que estou na tela de edição
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 passíveis de edição (EDT = Sim)
E exibe as seguintes ações: (Ver AC005 - Ações das telas de edição e AC006 - Ações de interação com formulários)

Regras de negócio específicas

• RNE001 - A unicidade do cadastro de Espécie - 3 Chaves simples: Nome da Espécie, Nome Científico da Espécie e Código do MAPA

Protótipos

• Listar espécie
• Editar espécie
• Visualizar espécie
• Cadastrar espécie

Documentos vinculados

• Faixa etária.
• Taxa de controle.
• Raça.

Convenções e ações comuns

As colunas Obrigatório e Editável correspondem a OBG e EDT da fonte. Editável descreve a alteração posterior ao cadastro; as condições de exibição e as indicações explícitas de somente leitura também devem ser observadas. Os códigos AC e RNC citados foram mantidos, sem presumir ações não detalhadas no documento de origem.

Pendências da fonte

• A nova fonte define Código do MAPA com tamanho de 5 dígitos e formato XX.XX, que contém apenas 4 dígitos e um separador. A versão anteriormente convertida exigia 10 dígitos. Confirmar o formato vigente antes da implementação.
• A nova fonte não informa exemplos nem valores padrão. Os exemplos e padrões da versão anterior não foram presumidos para esta revisão.
• O texto da visualização determina somente leitura, mas a tabela de Situação informa Editável = Sim. Confirmar se a alteração de situação é uma ação separada ou exclusiva da edição.
• A unicidade usa três chaves simples: Nome da Espécie, Nome Científico e Código do MAPA. Confirmar o tratamento do Nome Científico quando não informado, pois é opcional.
• A nova fonte substitui a especificação anterior e não inclui o antigo campo Código da Integradora ou Cooperativa nem sua referência à RNE002. Esses elementos não foram mantidos no formulário atualizado.
• Grupo tem Editável = Não, mas deve ser informado no cadastro. A restrição foi preservada para a edição, conforme o fluxo da fonte.

Histórico da conversão anterior — US016

Mantido para rastreabilidade da versão substituída. O histórico da nova fonte consta no início desta página.

Versão	Data	Alteração
v2.1	31/03/2025	Atualização para atender às demandas da GTA.
v.2.0	04/08/2025	Atualização para o novo formato.
v1.1	31/07/2025	Atualização da edição de espécie.
v1.0	31/03/2025	Primeira versão da história.