CulturaPronto

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

1. Buscar cultura

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Cultura, 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 da Cultura	Texto curto	Não	Alfanumérico. Tamanho máximo = 255 caracteres.	Abóbora	Vazio
Tipo de Cultura	Seleção simples	Não	Valores definidos na seção Tipos de cultura.	Anual	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 cultura.
Pesquisar	Realiza a busca utilizando o campo de busca e os filtros.
Inicial	Retorna à tela inicial para usuários autenticados.

2. Listar culturas

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 da Cultura	Texto	Sim	Nome da cultura.	Abóbora
Tipo de Cultura	Texto	Sim	Tipo da cultura.	Anual
Situação	Texto	Sim	Situação do cadastro.	Ativo

Para cada resultado, o sistema exibe Visualizar e Editar, que abrem as respectivas telas da cultura 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, apresenta 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 US035. Esse comportamento está registrado nas pendências da fonte.

3. Cadastrar cultura

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 da Cultura	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres. Unicidade conforme RNE001.	Abóbora	Vazio
Tipo de Cultura	Seleção simples	Sim	Valores definidos na seção Tipos de cultura.	Anual	Vazio

Variedades (zero ou mais)

Cada item contém:

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Nome da Variedade	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres. Único dentro da cultura, conforme RNE002.	Hiroko	Vazio

A situação de cada variedade é atribuída após o cadastro, conforme RNE005.

Pragas (zero ou mais)

Cada item contém:

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Praga (nome científico)	Seleção pesquisável	Sim	Valores = pragas cadastradas no sistema (US032). Pesquisa por nome científico ou nome popular.	Cerodirphia rubripes	Vazio
Nome Popular	Texto	Sim	Somente leitura. Disponível quando Praga estiver preenchida.	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 culturas	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 cultura cadastrada.

4. Visualizar cultura

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 Cultura	Texto	Código único gerado após o cadastro, conforme RNE003.	343
Variedades	Situação da Variedade	Texto	Situação de cada variedade cadastrada para a cultura.	Ativo
Situação do Cadastro	Situação	Texto	Situação atual da cultura.	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 culturas, que retorna à busca.

5. Editar cultura

Dado que estou na tela de edição
Então o sistema exibe os campos da visualização preenchidos e permite editar os campos do cadastro, respeitando as regras de unicidade. Nome Popular permanece como somente leitura, conforme a seleção de Praga. Os campos adicionais da visualização também permanecem como somente leitura; a situação da cultura e de cada variedade é alterada pelas ações específicas abaixo.

Ação	Disponibilidade e comportamento
Salvar	Abre a confirmação das edições.
Ativar/Inativar	Alterna a situação da cultura entre Ativo e Inativo, conforme CA002 e RN002.
Ativar/Inativar variedade	Disponível para cada variedade cadastrada. Alterna sua situação entre Ativo e Inativo.
Visualizar	Retorna à visualização da cultura.

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 da cultura

O cadastro de uma cultura deve ser único no sistema pelo Nome da Cultura.

RNE002 — Unicidade das variedades

As variedades de cada cultura devem ser únicas pelo Nome da Variedade. A unicidade se aplica dentro de cada cultura.

RNE003 — Geração do código

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

RNE004 — Grupos repetíveis

O cadastro pode conter múltiplas variedades e múltiplas pragas, conforme a necessidade.

Grupo	Campos agrupados
Variedades	Nome da Variedade e Situação, disponível após o cadastro.
Pragas	Praga (nome científico) e Nome Popular.

RNE005 — Situação inicial das variedades

Toda variedade adicionada à cultura deve ser cadastrada com a situação Ativo, por padrão.

Tipos de cultura

O campo Tipo de Cultura, na busca e no cadastro, admite as opções Anual e Perene.

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
US034 — Gerenciar cultura	v1.0	22/09/2025	Primeira versão finalizada da história.
US035 — Busca de cultura	v1.0	22/09/2025	Primeira versão da história.

Histórias e referências relacionadas

• US034 — Gerenciar cultura, consolidada neste documento.
• US035 — Busca de cultura, consolidada neste documento.
• US032 — Gerenciar praga.
• 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 US035 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 fonte define variedades e pragas como grupos repetíveis, mas não descreve as ações de inclusão ou remoção desses itens. Confirmar essas interações, sem acrescentar restrições de exclusão não previstas.
• A descrição da US034 utiliza o nome SIDAGRO; confirmar a identificação aplicável ao AgroDigital.