Divisão municipalPronto

Eu, como usuário do sistema AgroDigital, quero buscar divisão municipal, listar divisões municipais, cadastrar divisão municipal e editar divisão municipal para gerenciar divisões municipais.

1. Buscar divisão municipal

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Divisão Municipal, 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
Divisão Municipal	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres.	Vale do Bom Jesus	Vazio
Estado	Seleção simples	Não	Valores = todos os estados brasileiros.	Minas Gerais	Vazio
Município	Seleção pesquisável	Não	Valores = municípios brasileiros do estado selecionado, conforme RNE003.	Esmeraldas	Vazio
Tipo	Seleção simples	Não	Valores definidos na seção Tipos de divisão municipal.	Localidade	Vazio
Situação do Cadastro	Seleção simples	Não	Valores = Ativo, Inativo.	Ativo	Ativo

O sistema exibe a mensagem Busque por divisões municipais utilizando o campo de busca e os filtros acima.

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

2. Listar divisões municipais

Dado que estou na tela de busca
E todos os campos obrigatórios estão preenchidos corretamente
Quando realizo a ação Pesquisar
E existem registros compatíveis
Então o sistema exibe:

Campo	Tipo	Ordenável	Descrição	Exemplo
Divisão Municipal	Texto	Sim; ordenação padrão ascendente	Nome da divisão municipal.	Vale do Bom Jesus
Município	Texto	Sim	Município em que a divisão está situada.	Abadia dos Dourados
Tipo	Texto	Sim	Tipo da divisão municipal.	Localidade
Localização	Objeto: latitude e longitude	Não	Localização da divisão municipal.	41.40338, 2.17403
Situação	Texto	Sim	Situação do cadastro.	Ativo

Ação por resultado	Comportamento
Visualizar	Abre a visualização da divisão municipal selecionada.
Editar	Abre a edição da divisão municipal selecionada.
Ver no mapa	Abre no mapa a localização da divisão municipal selecionada.

Erro de validação

Se houver campos obrigatórios ausentes ou preenchidos incorretamente, o sistema não realiza a busca, exibe uma mensagem indicando os problemas e destaca os campos 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 US006. Esse comportamento está registrado nas pendências da fonte.

3. Cadastrar divisão municipal

Dado que estou no formulário de cadastro e edição de divisão municipal
E estou criando um novo cadastro
Então o sistema exibe:

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo	Seleção simples	Sim	Valores definidos na seção Tipos de divisão municipal. Não pode ser modificado após o cadastro, conforme RNE002.	Localidade	Vazio
Divisão Municipal	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres. Unicidade conforme RNE001.	Vale de Bom Jesus	Vazio
Estado	Seleção simples	Sim	Valores = todos os estados brasileiros.	Minas Gerais	Vazio
Município	Seleção pesquisável	Sim	Valores = municípios brasileiros do estado selecionado, conforme RNE003.	Esmeraldas	Vazio
Localização	Objeto: latitude e longitude	Sim	Latitude decimal entre -90 e 90. Longitude decimal entre -180 e 180.	41.40338, 2.17403	Vazio

Ação	Comportamento
Adicionar	Valida os dados informados e salva o cadastro.
Todas as divisões municipais	Retorna à tela de busca.

4. Editar divisão municipal

Dado que estou no formulário de cadastro e edição de divisão municipal
E estou editando um cadastro existente
Então o sistema exibe os campos preenchidos com os valores cadastrados e permite editar Divisão Municipal, Estado, Município e Localização. O campo Tipo permanece como somente leitura, conforme RNE002.

O sistema também exibe, como somente leitura, o usuário que efetuou a última alteração e a data e hora em que ela ocorreu, conforme RN003. A fonte não informa exemplos nem rótulos específicos para esses dois campos.

Ação	Comportamento
Salvar	Valida os dados informados e salva as alterações.
Ativar/Inativar cadastro	Alterna a situação entre Ativo e Inativo, dependendo da situação atual, conforme CA002 e RN002.
Todas as divisões municipais	Retorna à tela de busca.

Visualização e mapa

A listagem disponibiliza as ações Visualizar e Ver no mapa. A fonte inclui um protótipo de visualização, mas não detalha seus campos e ações em um critério próprio; esse detalhamento está pendente de validação.

Regras de negócio específicas

RNE001 — Unicidade

O cadastro deve ser único no sistema pela combinação de Tipo, Divisão Municipal e Município.

RNE002 — Tipo imutável

O tipo da divisão municipal não pode ser modificado após o cadastro, pois a alteração afetaria os cadastros que dependem dessa divisão.

RNE003 — Municípios por estado

Os valores do campo Município devem ser pré-filtrados pelo valor informado em Estado.

Tipos de divisão municipal

O campo Tipo, na busca e no cadastro, admite as opções Distrito e Localidade.

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

História	Versão	Data	Alteração
US005 — Cadastro e edição de divisão municipal	v1.3	09/07/2025	Paulo: adição do campo Estado.
US005 — Cadastro e edição de divisão municipal	v1.3	14/03/2025	Paulo: padronização da escrita da história.
US005 — Cadastro e edição de divisão municipal	v1.2	11/03/2025	Especificação do perfil de usuário que pode acessar a funcionalidade.
US005 — Cadastro e edição de divisão municipal	v1.1	17/02/2025	Adição do critério de registro dos logs da última alteração.
US005 — Cadastro e edição de divisão municipal	v1.0	21/01/2025	Primeira versão da história.
US006 — Busca de divisão municipal	v1.3	09/07/2025	Paulo: adição do campo Estado ao filtro.
US006 — Busca de divisão municipal	v1.2	14/03/2025	Paulo: padronização da escrita da história.
US006 — Busca de divisão municipal	v1.1	11/03/2025	Alteração do rótulo Situação Cadastral para Situação do Cadastro e adição do perfil de acesso.
US006 — Busca de divisão municipal	v1.0	21/01/2025	Primeira versão da história.

Histórias e referências relacionadas

• US005 — Cadastro e edição de divisão municipal, consolidada neste documento.
• US006 — Busca de divisão municipal, consolidada neste documento.
• Planilha de Módulos e Permissões do sistema.

Protótipos

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

Pendências da fonte

• A US006 referencia US001 nas ações de visualização e edição. Nesta consolidação, a edição aponta ao formulário da US005; confirmar a referência da visualização e seu detalhamento.
• A US006 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.
• O histórico da US005 contém duas entradas v1.3, em datas diferentes. Ambas foram preservadas para conferência.
• A US005 utiliza o nome GeoAgro Insights e a US006 utiliza SIDAGRO em suas descrições. Confirmar a identificação aplicável ao AgroDigital.