Unidade administrativaPronto

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

1. Buscar unidade administrativa

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Unidade Administrativa, 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 ou Sigla da Unidade Administrativa	Texto curto	Não	Alfanumérico. Tamanho máximo = 255 caracteres.	Escritório Seccional de Lavras	Vazio
Tipo da Unidade Administrativa	Seleção simples	Não	Valores = tipos definidos na RNE005.	Escritório Seccional	Vazio
Unidade Pai	Seleção pesquisável	Não	Disponível se Tipo da Unidade Administrativa for diferente de Escritório Central. Valores = unidades do tipo pai imediato ao tipo selecionado, conforme RNE005.	Coordenadoria Regional de Oliveira	Vazio
Município	Texto	Não	Disponível se Tipo da Unidade Administrativa = Escritório Seccional. Valores = municípios de Minas Gerais.	Oliveira	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 unidade administrativa.
Pesquisar	Realiza a busca utilizando o campo de busca e os filtros.
Inicial	Retorna à tela inicial para usuários autenticados.

2. Listar unidades administrativas

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
Unidade Administrativa	Texto	Sim	Nome da unidade administrativa.	Escritório Seccional de Lavras
Sigla	Texto	Sim	Sigla da unidade administrativa.	SECLAV3820
Tipo da Unidade Administrativa	Texto	Sim	Tipo da unidade administrativa.	Escritório Seccional
Unidade Pai	Texto	Sim	Unidade pai, quando disponível.	Coordenadoria Regional
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.

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 US037. Esse comportamento está registrado nas pendências da fonte.

3. Cadastrar unidade administrativa

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
Tipo da Unidade Administrativa	Seleção simples	Sim	Valores = tipos definidos na RNE005.	Escritório Seccional	Vazio
Nome da Unidade Administrativa	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres. Unicidade conforme RNE002.	Escritório Seccional de Lavras	Vazio
CNPJ da Unidade Administrativa	Texto numérico	Sim	Disponível se Tipo da Unidade Administrativa = Escritório Central. Tamanho = 14 dígitos. Formato = XX.XXX.XXX/XXXX-XX. Validação dos dígitos verificadores.	56.338.814/0001-95	Vazio
Unidade Pai	Seleção simples	Sim	Disponível se Tipo da Unidade Administrativa for diferente de Escritório Central. Valores = unidades do tipo pai imediato ao tipo selecionado, conforme RNE005.	Coordenadoria Regional de Oliveira	Vazio
Sigla da Unidade	Texto curto	Sim	Alfanumérico. Tamanho máximo = 10 caracteres. Unicidade conforme RNE002.	SECLAV3820	Vazio

Informações de localização

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Zona	Seleção simples	Sim	Valores = Rural, Urbana.	Rural	Urbana

Zona urbana

Disponível se Zona = Urbana.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
CEP	Texto numérico	Sim	Tamanho = 8 dígitos. Formato = XXXXX-XXX. Consulta à API de CEP.	37060-400	Vazio
Estado	Texto curto	Sim	Somente leitura. Disponível quando CEP estiver preenchido. Alfanumérico. Tamanho máximo = 255 caracteres.	Minas Gerais	Valor obtido pela API de CEP
Município	Texto curto	Sim	Somente leitura. Disponível quando CEP estiver preenchido. Alfanumérico. Tamanho máximo = 255 caracteres. Aplica-se a RNE003.	Varginha	Valor obtido pela API de CEP
Bairro	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres.	Centro	Valor obtido pela API de CEP, quando disponível
Endereço	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres.	Avenida A	Valor obtido pela API de CEP, quando disponível
Número	Texto curto	Sim	Alfanumérico. Tamanho máximo = 20 caracteres.	10	Vazio
Complemento	Texto curto	Não	Alfanumérico. Tamanho máximo = 255 caracteres.	Apto 02	Vazio
Localidade	Seleção pesquisável	Não	Valores = localidades cadastradas no sistema (US005). Pré-filtradas pelo município, conforme RNE004.	Pimentas	Vazio
Distrito	Seleção pesquisável	Não	Valores = distritos cadastrados no sistema (US005). Pré-filtrados pelo município, conforme RNE004.	Carrancas	Vazio

Zona rural

Disponível se Zona = Rural.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
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.	Varginha	Vazio
Localidade	Seleção pesquisável	Não	Valores = localidades cadastradas no sistema (US005). Pré-filtradas pelo município, conforme RNE004.	Pimentas	Vazio
Distrito	Seleção pesquisável	Não	Valores = distritos cadastrados no sistema (US005). Pré-filtrados pelo município, conforme RNE004.	Carrancas	Vazio
Localização	Objeto: latitude e longitude	Sim	Informada manualmente ou selecionada no mapa. Latitude decimal entre -90 e 90. Longitude decimal entre -180 e 180.	41.40338, 2.17403	Vazio

Informações de contato

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Email	Texto curto	Não	Alfanumérico. Tamanho máximo = 255 caracteres. Formato de e-mail válido.	joaquim.vet@email.com	Vazio

Telefones de contato

Admite múltiplos itens, conforme RNE006. Cada item contém:

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Número	Texto numérico	Sim	Tamanho = 11 dígitos. Formato = (XX) XXXXX-XXXX.	(35) 99999-1111	Vazio
Observação	Texto curto	Não	Alfanumérico. Tamanho máximo = 255 caracteres.	É Whatsapp	Vazio

Ações e resultado

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

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 administrativa.	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 unidades administrativas, que retorna à busca.

5. Editar unidade administrativa

Dado que estou na tela de edição
Então o sistema exibe os campos do cadastro preenchidos e editáveis, exceto Tipo da Unidade Administrativa e os campos já definidos como somente leitura. Situação, Usuário e Data e Hora da Modificação também 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 unidade administrativa	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 — Geração do código

Após o cadastro, o sistema deve gerar um código único de 10 dígitos: código IBGE da Unidade Federada, com 2 dígitos, seguido de um sequencial de 8 dígitos, conforme a RN09 do Manual de padronização da PGA.

RNE002 — Unicidade do nome e da sigla

Nome da Unidade Administrativa e Sigla da Unidade devem ser únicos no sistema, cada um independentemente do outro e do tipo da unidade.

Exemplo: não podem existir duas unidades com o nome Escritório, mesmo que tenham siglas e tipos diferentes. A mesma restrição se aplica à sigla.

RNE003 — Municípios por estado

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

RNE004 — Distritos e localidades por município

Os valores dos campos Distrito e Localidade devem ser pré-filtrados pelo Município informado.

RNE005 — Tipos e hierarquia das unidades administrativas

O campo Tipo da Unidade Administrativa, na busca e no cadastro, utiliza os tipos da tabela a seguir. Unidade Pai deve listar apenas unidades cadastradas do tipo pai imediato.

Tipo da unidade administrativa	Tipo da unidade pai
Almoxarifado	Escritório Central
Barreira Sanitária	Escritório Seccional
Coordenadoria Regional	Escritório Central
Escritório Central	Não possui unidade pai; o campo não fica disponível.
Escritório Municipal	Escritório Seccional
Escritório Seccional	Coordenadoria Regional
Laboratório	Escritório Central
Posto de Atendimento	Escritório Seccional
Serviço de Inspeção Permanente	Escritório Seccional

Exemplos: ao selecionar Escritório Seccional, o campo Unidade Pai lista coordenadorias regionais, como as de Oliveira e Bambuí. Ao selecionar Coordenadoria Regional, lista escritórios centrais, como o Instituto Mineiro de Agropecuária.

A tabela representa a hierarquia descrita no texto e na figura incorporada à US036.

RNE006 — Múltiplos telefones

O cadastro pode conter mais de um telefone de contato. Cada item agrupa os campos Número e Observação.

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/Inativação de cadastros de uma entidade.
• RN003 — Controle de alterações em uma entidade.
• RN005 — Comportamento para situações em que o CEP não foi validado.
• RN007 — Permissões de acesso.

Histórico da fonte

História	Versão	Data	Alteração
US036 — Gerenciar unidade administrativa	v1.1	21/08/2026	Adição de CNPJ para atender requisito da PGA.
US036 — Gerenciar unidade administrativa	v1.0	18/08/2025	Primeira versão da história.
US037 — Buscar unidade administrativa	v1.0	01/10/2025	Primeira versão da história.

Histórias e referências relacionadas

• US036 — Gerenciar unidade administrativa, consolidada neste documento; o link aparece identificado como US032 na fonte de busca.
• US037 — Buscar unidade administrativa, consolidada neste documento.
• US005 — Gerenciar divisão municipal.
• Requisitos não funcionais e técnicos.
• Documentação técnica da API de Municípios do IBGE.
• Documentação técnica da API de CEP.
• Planilha de Módulos e Permissões do sistema.
• Manual de padronização da PGA, RN09.

Protótipos

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

Pendências da fonte

• A US037 menciona US035 nas ações de cadastro, visualização e edição e US032 no link de gerenciamento. Nesta consolidação, essas ações apontam às seções correspondentes da US036; os identificadores divergentes precisam ser confirmados.
• A US036 referencia a si própria em algumas ações de retorno à busca; a navegação foi consolidada na seção de busca da US037.
• A US037 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 filtros 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 permite múltiplos telefones, mas não explicita o número mínimo de itens nem as ações para adicionar e remover telefones. A obrigatoriedade de Número foi preservada por item.