Unidade de medidaPronto

Eu, como usuário do sistema AgroDigital, quero buscar unidade de medida, listar unidades de medida, cadastrar unidade de medida, visualizar unidade de medida e editar unidade de medida para gerenciar unidades de medida.

1. Buscar unidade de medida

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Unidade de Medida, 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
Unidade de Medida	Texto curto	Não	Alfanumérico. Tamanho máximo = 255 caracteres.	KG	Vazio
Tipo de Unidade de Medida	Seleção múltipla	Não	Valores definidos na seção Tipos de unidade de medida.	Animal, Vegetal	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 e/ou utilize o campo de busca para visualizar os resultados.

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

2. Listar unidades de medida

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

Campo	Tipo	Ordenável	Descrição	Exemplo
Unidade de Medida	Texto	Sim	Unidade de medida cadastrada.	KG
Tipo de Unidade de Medida	Texto	Sim	Tipos associados à unidade de medida.	Animal, Vegetal
Situação	Texto	Sim	Situação do cadastro.	Ativo

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

3. Cadastrar unidade de medida

Dado que estou na tela de cadastro
Então o sistema exibe o formulário descrito a seguir, indicando os campos obrigatórios.

Informações básicas

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Unidade de Medida	Seleção múltipla	Sim	Valores definidos na seção Tipos de unidade de medida.	Animal, Vegetal	Vazio
Unidade de Medida	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres. Unicidade conforme RNE001.	KG	Vazio
Descrição	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres.	Quilogramas	Vazio

Ações e resultado

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

4. Visualizar unidade de medida

Dado que estou na tela de visualização
Então o sistema exibe todos 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 da unidade de medida.	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 Última 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 unidades de medida, que retorna à busca.

5. Editar unidade de medida

Dado que estou na tela de edição
Então o sistema exibe os campos do cadastro preenchidos e editáveis, respeitando a RNE002. Situação, Usuário e Data e Hora da Última 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 RN008.
Visualizar unidade de medida	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

O cadastro deve ser único no sistema pelo valor do campo Unidade de Medida.

RNE002 — Remoção de tipos em uso

Ao editar uma unidade de medida, o sistema deve impedir a remoção de um tipo se existir pelo menos um cadastro vinculado que dependa desse tipo. A remoção somente pode ocorrer após a desvinculação de todos os cadastros que o exigem.

Exemplo: se KG possui o tipo Animal e está vinculado aos produtos animais Carne e Osso, o sistema deve impedir a remoção desse tipo até que ambos sejam desvinculados da unidade. A inclusão de outro tipo, como Vegetal, é permitida.

Tipos de unidade de medida

O campo Tipo de Unidade de Medida, na busca e no cadastro, admite as opções Animal, Vegetal e Agrotóxico.

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.
• CA003 — Notificar erro ao usuário devido a falha técnica.
• CA009 — Busca sem resultados.
• CA010 — Uso incorreto de filtros de busca.
• CA011 — Indicação de filtros de busca aplicados.
• RN003 — Controle de alterações em uma entidade.
• RN007 — Permissões de acesso.
• RN008 — Situação do cadastro de uma entidade sem opção de suspensão.

Histórico da fonte

História	Versão	Data	Alteração
US048 — Gerenciar unidade de medida	v1.0	10/11/2025	Primeira versão da história.
US049 — Buscar unidade de medida	v1.0	10/11/2025	Primeira versão da história.

Histórias e referências relacionadas

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

Impactos em outras histórias

Na US022 — Produto, a unidade de medida passa a ser selecionada entre os cadastros de unidade de medida, em substituição ao campo de texto livre. A seleção deve respeitar o tipo correspondente ao produto.

Protótipos

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

Validação

As duas fontes registram validação presencial de 03/11/2025 a 05/01/2025, na Cidade Administrativa, em Belo Horizonte/MG. A data final é anterior à inicial; o intervalo foi preservado e precisa ser confirmado.