PragaPronto

Eu, como usuário do sistema AgroDigital, quero buscar praga, listar pragas, cadastrar praga, visualizar praga e editar praga para gerenciar pragas.

1. Buscar praga

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Praga, observadas as permissões de acesso
Então o sistema exibe a tela de busca.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Nome Científico ou Nome Popular da Praga	Texto curto	Não	Alfanumérico. Tamanho máximo = 255 caracteres.	Acalymma sp.	Vazio
Situação	Seleção simples	Não	Valores = Ativo, Inativo.	Ativo	Vazio

O sistema solicita que o usuário selecione pelo menos um filtro ou utilize o campo de busca para visualizar os resultados.

Ação	Comportamento
Adicionar Novo	Abre a tela de cadastro de praga.
Pesquisar	Realiza a busca utilizando o campo de busca e os filtros.
Inicial	Retorna à tela inicial para usuários autenticados.

2. Listar pragas

Dado que estou na tela de busca
E o campo de busca ou 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
Nome Científico	Texto	Sim	Nome científico da praga.	Cerodirphia rubripes
Nome Popular	Texto	Sim	Nome popular da praga.	Lagarta-Verde
Situação	Seleção	Sim	Situação do cadastro.	Ativo

Para cada resultado, o sistema exibe Visualizar e Editar, que abrem as respectivas telas da praga selecionada.

Erro de validação

Se o campo de busca ou algum filtro não for preenchido corretamente, o sistema não realiza a busca, exibe uma mensagem indicando os problemas e destaca os campos obrigatórios ausentes ou com erros de validação.

Busca sem resultados

Se os dados forem válidos e não houver registros compatíveis, o sistema não exibe a mensagem Nenhum resultado foi encontrado, conforme a redação da US033. Esse comportamento está registrado nas pendências da fonte.

3. Cadastrar praga

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

Informações básicas

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Nome Científico	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres. Unicidade conforme RNE001.	Cerodirphia rubripes	Vazio
Nome Popular	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres.	Lagarta-Verde	Vazio

Ações e resultado

Ação	Comportamento
Adicionar	Valida os dados, salva o cadastro e abre a tela de sucesso.
Todas as pragas	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 da praga cadastrada.

4. Visualizar praga

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
Informações Básicas	Código da praga	Texto	Código único gerado após o cadastro, conforme RNE002.	112
Situação do Cadastro	Situação	Texto	Situação atual da praga.	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 Todas as pragas, que retorna à busca.

5. Editar praga

Dado que estou na tela de edição
Então o sistema exibe os campos da visualização preenchidos e permite editar apenas Nome Científico e Nome Popular, respeitando a RNE001. Código da praga, Situação, Usuário e Data e Hora da Modificação permanecem como somente leitura.

Ação	Comportamento
Salvar	Abre a confirmação das edições.
Ativar/Inativar	Alterna a situação entre Ativo e Inativo, conforme CA002 e RN002.
Visualizar Praga	Retorna à tela de 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 pelo nome científico

O cadastro de uma praga deve ser único no sistema pelo Nome Científico.

RNE002 — Geração do código

Após o cadastro, o sistema deve gerar um código único, inteiro e incremental.

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/Inativar 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

História	Versão	Data	Alteração
US032 — Gerenciar praga	v1.0	22/09/2025	Primeira versão finalizada da história.
US033 — Buscar praga	v1.0	22/09/2025	Primeira versão da história.

Histórias e referências relacionadas

• US032 — Gerenciar praga, consolidada neste documento.
• US033 — Buscar praga, consolidada neste documento.
• Requisitos não funcionais e técnicos.
• Planilha de Módulos e Permissões do sistema.

Protótipos

• Buscar.
• Cadastrar.
• Visualizar.
• Editar.

Pendências da fonte

• A US033 determina que a mensagem Nenhum resultado foi encontrado não seja exibida. Confirmar se a negação é intencional e qual retorno deve ser apresentado nesse cenário.
• Os campos da busca são opcionais, mas o cenário de erro menciona campos obrigatórios ausentes. Confirmar se isso se refere à exigência de informar pelo menos um critério de pesquisa.
• A descrição da US032 utiliza o nome SIDAGRO; confirmar a identificação aplicável ao AgroDigital.