Estabelecimento agropecuárioPronto

Eu, como usuário do sistema AgroDigital, quero cadastrar estabelecimento agropecuário, visualizar estabelecimento agropecuário e editar estabelecimento agropecuário para gerenciar estabelecimentos agropecuários.

1. Cadastrar estabelecimento agropecuário

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 de Estabelecimento Agropecuário	Seleção simples	Sim	Valores = Apartamento, Assentamento, Casa, Centro de Treinamento, Chácara, Clínica Veterinária, Condomínio, Distribuidora, Estância, Fazenda, Galpão, Gleba, Haras, Hípica, Hospital Veterinário, Instituição de Ensino, Lote, Parque de Exposições, Rancho, Residência, Sítio, Terreno.	Fazenda	Vazio
Nome do Estabelecimento Agropecuário	Texto curto	Sim	Disponível se Tipo de Estabelecimento Agropecuário estiver preenchido. O tipo deve permanecer fixado no início do nome e não pode ser apagado pelo usuário. Tamanho máximo = 255 caracteres.	Fazenda Rio Verde	Vazio
Cadastro Provisório?	Seleção simples	Sim	Valores = Sim, Não.	Não	Não

Proprietários (um ou mais)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Pessoa	Seleção simples	Sim	Valores = Pessoa física, Pessoa jurídica.	Pessoa física	Pessoa física
Proprietário	Seleção de entidade	Sim	Valores = pessoas físicas ou jurídicas cadastradas (US042 e US044). Pré-filtrado por Tipo de Pessoa. Pesquisa por nome/razão social ou CPF/CNPJ.	José Aarão Neto	Vazio
CPF/CNPJ	Texto	Sim	Somente leitura. Disponível se Proprietário estiver preenchido. Corresponde à pessoa selecionada.	555.009.956-40	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	Rural
Estado (zona rural)	Seleção simples	Sim	Disponível se Zona = Rural. Valores = lista de todos os estados brasileiros. Somente leitura. Valor = Minas Gerais.	Minas Gerais	Minas Gerais
Município (zona rural)	Seleção pesquisável	Sim	Disponível se Zona = Rural e Estado estiver preenchido. Valores = municípios brasileiros correspondentes ao estado selecionado.	Lavras	Vazio
Nome da estrada e quilômetro de referência	Texto curto	Sim	Disponível se Zona = Rural.	Estrada de chão no Km 12	Vazio
Localidade	Seleção pesquisável	Não	Disponível se Zona = Rural. Valores = localidades cadastradas no sistema (US005). Pré-filtrado pelo município.	Vila dos Técnicos	Vazio
Distrito (zona rural)	Seleção pesquisável	Não	Disponível se Zona = Rural. Valores = distritos cadastrados no sistema (US005). Pré-filtrado pelo município.	Cachoeira do Vale	Vazio
CEP	Texto curto	Sim	Disponível se Zona = Urbana. Tamanho = 8 dígitos. Formato = XXXXX-XXX. Aceita apenas CEPs localizados em Minas Gerais.	37060-400	Vazio
Estado (via CEP)	Texto curto	Sim	Disponível se Zona = Urbana e CEP estiver preenchido. Consulta à API de CEP. Somente leitura.	Minas Gerais	Valor obtido pela API de CEP
Município (via CEP)	Texto curto	Sim	Disponível se Zona = Urbana e CEP estiver preenchido. Consulta à API de CEP. Somente leitura.	Timóteo	Valor obtido pela API de CEP
Bairro	Texto curto	Sim	Disponível se Zona = Urbana. Consulta à API de CEP.	Centro	Valor obtido pela API de CEP, quando disponível
Endereço	Texto curto	Sim	Disponível se Zona = Urbana. Consulta à API de CEP.	Avenida JK	Valor obtido pela API de CEP, quando disponível
Número	Texto curto	Sim	Disponível se Zona = Urbana. Tamanho máximo = 20 caracteres.	10	Vazio
Complemento	Texto curto	Não	Disponível se Zona = Urbana. Tamanho máximo = 255 caracteres.	Apto 02	Vazio
Distrito (zona urbana)	Seleção pesquisável	Não	Disponível se Zona = Urbana. Valores = distritos cadastrados no sistema (US005). Pré-filtrado pelo município.	Cachoeira do Vale	Vazio
Formato da Geolocalização	Seleção simples	Sim	Valores = DMS (graus, minutos, segundos), DD (decimal).	DMS (graus, minutos, segundos)	DMS (graus, minutos, segundos)
Latitude	Decimal	Sim	Disponível para zonas rural e urbana. Pode ser informada manualmente ou selecionada no mapa, com consulta à API do Google Maps. Pré-estimada pelos dados de endereço. Máscara definida pelo formato de geolocalização (RN010).	-19.165827719338893	Vazio
Longitude	Decimal	Sim	Disponível para zonas rural e urbana. Pode ser informada manualmente ou selecionada no mapa, com consulta à API do Google Maps. Pré-estimada pelos dados de endereço. Máscara definida pelo formato de geolocalização (RN010).	-44.362871253967285	Vazio

Informações complementares

Áreas

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Unidade de Medida das Áreas	Seleção simples	Sim	Valores = Metros Quadrados, Hectares.	Hectares	Hectares
Área Total	Numérico decimal	Sim	Tamanho = 12 dígitos. Casas decimais = 2. Deve ser maior que zero.	1000,00	Vazio
Área Produtiva	Numérico decimal	Sim	Tamanho = 12 dígitos. Casas decimais = 2. Deve ser menor ou igual à Área Total.	1000,00	Vazio

Outras informações

Disponível se Zona = Rural.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Número do CAR	Texto curto	Não	Tamanho = 41 caracteres. Tipo = alfanumérico.	4050270008331	Vazio
Confrontantes	Texto longo	Não	Tamanho máximo = 1.500 caracteres.	Maria Oliveira, proprietária da Fazenda São João, com 450 hectares.	Vazio
Vias de Acesso	Texto longo	Não	Tamanho máximo = 1.500 caracteres.	Estrada Municipal da Fazenda São João, Caminho do Rio Verde.	Vazio

Anexos e observações

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Documento	Arquivo	Sim	Tipos aceitos = PNG, JPG, PDF. Tamanho máximo = 50 MB.	documento.png	Vazio
Descrição	Texto curto	Não	Disponível quando Documento for informado. Tamanho máximo = 255 caracteres.	Documento de identidade com foto	Vazio
Observação	Texto longo	Não	Tamanho máximo = 1.500 caracteres.	Informações adicionais sobre a pessoa.	Vazio

Ações e resultado

O cadastro exibe as ações comuns AC003 e AC006:

• Todos os estabelecimentos agropecuários: volta para a busca (US051).
• Adicionar: valida e salva o cadastro.
• Ver item: abre o cadastro relacionado selecionado.
• Adicionar/Remover item: gerencia proprietários e anexos.
• Baixar documento: baixa o anexo.

Também exibe Ver Mapa/Satélite, que alterna o modo de visualização do mapa.

Em caso de sucesso, o sistema exibe uma mensagem e as ações Voltar e Visualizar. Em caso de erro de validação, mantém o formulário e apresenta os erros nos respectivos campos.

2. Visualizar estabelecimento agropecuário

Dado que estou na tela de visualização
Então o sistema exibe os campos do cadastro como somente leitura e acrescenta:

Seção	Campo	Tipo	Descrição	Exemplo
Informações Básicas	Código do Estabelecimento Agropecuário	Texto	Exibe o código gerado após o cadastro.	31001040005
Situação do Cadastro	Situação do Cadastro	Texto	Exibe a situação atual conforme CAC001.	Ativo

O sistema exibe as ações Todos os estabelecimentos agropecuários, Editar e Histórico de Alterações (AC004), as ações de formulário aplicáveis (AC006) e a ação específica Vinculações, que abre a aba definida na US062.

3. Editar estabelecimento agropecuário

Dado que estou na tela de edição
Então o sistema exibe os campos do cadastro preenchidos e editáveis, exceto toda a seção Informações de Localização, e acrescenta como somente leitura:

Seção	Campo	Tipo	Descrição	Exemplo
Informações Básicas	Código do Estabelecimento Agropecuário	Texto	Exibe o código do estabelecimento.	31001040005
Situação do Cadastro	Situação do Cadastro	Texto	Exibe a situação atual.	Ativo

O sistema exibe as ações comuns de edição (AC005) e de formulário (AC006): Salvar, Visualizar estabelecimento agropecuário, Gerenciar Situação, Histórico de Alterações, Ver item, Adicionar/Remover item e Baixar documento.

Gerenciar Situação permite ativar, inativar ou suspender o cadastro, conforme RN009.

Ao acionar Salvar, o sistema abre a confirmação da edição. Cancelar retorna à edição; Salvar valida os dados, persiste as alterações e retorna à visualização.

4. Critérios comuns

• CA001 — Salvar cadastro de uma entidade.
• CA003 — Notificar erro ao usuário devido a falha técnica.

Regras de negócio específicas

RNE001 — Unicidade pendente de definição

O cadastro deve ser único no sistema. Entretanto, ainda não foi definido pelo cliente como identificar estabelecimentos duplicados.

Pendência funcional

Até que o critério de duplicidade seja definido, a implementação não deve presumir uma chave de unicidade além do código gerado após o cadastro.

RNE002 — Geração do código

Após o cadastro, o sistema deve gerar um código único de 11 dígitos: os 7 dígitos do código IBGE do município seguidos de um sequencial de 4 dígitos por ordem de cadastro, conforme a Portaria IMA nº 2.324, de 23 de agosto de 2024.

RNE003 — Itens repetíveis

O cadastro pode possuir:

• um ou mais proprietários, cada qual formado por Tipo de Pessoa, Proprietário e CPF/CNPJ;
• zero ou mais anexos, cada qual formado por Documento e Descrição.

RNE004 — Formação do nome

O nome do estabelecimento deve começar pelo valor de Tipo de Estabelecimento Agropecuário. Se o tipo for alterado, o prefixo do nome deve ser atualizado automaticamente.

No cadastro, se o usuário mantiver apenas o tipo no nome, sem informar um nome específico, o sistema deve concatenar automaticamente o tipo e o endereço no momento de salvar. Exemplo: Fazenda torna-se Fazenda <endereço>.

A mesma atualização do prefixo deve ocorrer durante a edição.

RNE005 — Alteração da área produtiva

Durante a edição, se a nova área produtiva ficar menor que a soma das áreas de explorações pecuárias, explorações agrícolas ou unidades de produção vinculadas, o sistema deve permitir a alteração e exibir um alerta sobre a sobreposição.

Regras comuns relacionadas

• RN003 — Controle de alterações em uma entidade.
• RN007 — Permissões de acesso.
• RN009 — Situação do cadastro com opção de suspensão.
• RN010 — Coordenadas geográficas no componente de endereços.

Histórico da fonte

Versão	Data	Alteração
v1.2	17/03/2026	Define que a área total deve ser maior que zero.
v1.1	14/01/2026	Adiciona a ação de vinculações e organiza as ações em grupos.
v1.0	10/11/2025	Primeira versão da história.

Histórias e referências relacionadas

• US001 — Cadastro e edição de estabelecimento agropecuário, substituída por esta história.
• US005 — Cadastro e edição de divisão municipal.
• US042 — Gerenciar pessoa física.
• US044 — Gerenciar pessoa jurídica.
• US051 — Buscar estabelecimento agropecuário.
• US062 — Gerenciar aba de vinculações de estabelecimento agropecuário.
• Portaria IMA nº 2.324, de 23 de agosto de 2024.
• Documentação técnica da API de Municípios do IBGE.
• Documentação técnica da API de CEP.

Validação

Validada em reunião presencial entre 03/11/2025 e 05/11/2025, na Cidade Administrativa, em Belo Horizonte/MG.