Unidade de consolidaçãoPronto

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

1. Buscar unidade de consolidação

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Unidade de Consolidação, observadas as permissões de acesso (RNC007)
Então o sistema exibe a tela de busca.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Código ou Nome da Unidade de Consolidação	Texto simples	Não	Nenhuma validação adicional informada na fonte.	Unidade São José	Vazio
Proprietário	Seleção de entidade: proprietário	Não	Valores = pessoas físicas ou jurídicas proprietárias de unidades de consolidação cadastradas.	José Aarão Neto	Vazio
Município	Seleção pesquisável	Não	Valores = municípios de Minas Gerais. A fonte condiciona a disponibilidade ao preenchimento de Estado, mas não define esse campo na busca; ver pendências.	Lavras	Vazio
Engenheiro Agrônomo ou Florestal	Seleção de entidade: profissional da área vegetal	Não	Valores = engenheiros agrônomos ou florestais cadastrados no sistema.	Flávio Silva	Vazio
Responsável pela Emissão de PTV	Seleção de entidade: profissional da área vegetal	Não	Valores = profissionais da área vegetal habilitados para emissão de PTV cadastrados no sistema.	Divino de Souza Sobrinho	Vazio
Situação	Seleção simples	Não	Valores = Ativo, Inativo.	Ativo	Vazio

O sistema exibe Inicial, Adicionar Novo e Pesquisar, conforme AC001 — Ações das telas de busca.

2. Listar unidades de consolidação

Dado que estou na tela de busca
E pelo menos um campo 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
Código	Texto	Sim	Código da unidade de consolidação.	31016070001
Nome	Texto	Sim	Nome da unidade de consolidação.	Unidade São José
Município — UF	Texto	Sim	Município e UF da unidade.	Abadia dos Dourados - MG
Engenheiro Agrônomo / Florestal	Texto	Sim	CPF e nome do engenheiro agrônomo ou florestal associado à unidade.	Flávio Silva (exemplo da fonte, sem CPF)
Responsável pela Emissão de PTV	Texto	Sim	CPF e nome do responsável pela emissão de PTV associado à unidade.	Divino de Souza Sobrinho (exemplo da fonte, sem CPF)
Situação	Texto	Sim	Situação do cadastro.	Ativo

Para cada resultado, o sistema exibe Visualizar e Editar, conforme as ações comuns de listagem (AC002). A fonte referencia essas ações como AC001; a divergência está registrada nas pendências.

3. Cadastrar unidade de consolidação

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 Unidade de Consolidação	Texto curto	Sim	Nenhuma validação adicional informada na fonte.	Unidade São José	Vazio
Localização do Livro	Texto curto	Não	Nenhuma validação adicional informada na fonte.	Próximo ao portão de entrada da propriedade	Vazio

Proprietários

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

Profissionais

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Engenheiro Agrônomo/Florestal	Seleção de entidade: profissional da área vegetal	Sim	Valores = engenheiros agrônomos ou florestais cadastrados no sistema (US064).	Flávio Silva	Vazio
Responsável pela Emissão de PTV	Seleção de entidade: profissional da área vegetal	Sim	Valores = profissionais da área vegetal habilitados para emissão de PTV cadastrados no sistema (US064).	Divino de Souza Sobrinho	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

A fonte solicita Estado fixo, sem informar o estado no parâmetro. Minas Gerais foi adotado nesta conversão por ser o estado definido no filtro de municípios; essa interpretação deve ser confirmada.

Informações de contato

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Utilizar Contato de Proprietários?	Seleção simples	Sim	Valores pré-definidos: “Sim”, “Não”	“Sim”	Sim
(Aplicar?)	Seleção simples	Sim	Proprietários (Disponível para cada proprietário informado no cadastro) (Um ou mais Valores pré-definidos: “Verdadeiro”, “Falso” Exibido para cada proprietário do cadastro. Os contatos dos proprietários selecionados são exibidos quando Utilizar Contato de Proprietários? = Sim.	“Verdadeiro”	Falso
Tipo de Contato	Seleção simples	Sim	Contatos Obrigatórios (Disponível se o campo “Utilizar Contato de Proprietários?” for definido como “Não”) (Disponível se nenhum contato de proprietário for escolhido como opção de contato do cadastro Somente Leitura	“E-mail”	“E-mail”
Email	Texto	Sim	Contatos Obrigatórios (Disponível se o campo “Utilizar Contato de Proprietários?” for definido como “Não”) (Disponível se nenhum contato de proprietário for escolhido como opção de contato do cadastro Alfanumérico, máximo 255 caracteres	“joaquim@email.com”	Vazio
Observação	Texto	Não	Contatos Obrigatórios (Disponível se o campo “Utilizar Contato de Proprietários?” for definido como “Não”) (Disponível se nenhum contato de proprietário for escolhido como opção de contato do cadastro Alfanumérico, máximo 1500 caracteres	“Meu email padrão”	Vazio
Tipo de Contato	Seleção simples	Sim	Contatos Obrigatórios (Disponível se o campo “Utilizar Contato de Proprietários?” for definido como “Não”) (Disponível se nenhum contato de proprietário for escolhido como opção de contato do cadastro Somente Leitura	“Telefone”	“Telefone”
Número	Texto	Sim	Contatos Obrigatórios (Disponível se o campo “Utilizar Contato de Proprietários?” for definido como “Não”) (Disponível se nenhum contato de proprietário for escolhido como opção de contato do cadastro Somente Leitura Numérico, 11 dígitos, máscara (XX) XXXXX-XXXX	“(35) 99999-1111”	Vazio
Observação	Texto	Não	Contatos Obrigatórios (Disponível se o campo “Utilizar Contato de Proprietários?” for definido como “Não”) (Disponível se nenhum contato de proprietário for escolhido como opção de contato do cadastro Alfanumérico, máximo 1500 caracteres	“Meu telefone”	Vazio
Tipo de Contato	Seleção simples	Sim	Outros contatos: zero ou mais itens. Valores pré-definidos: “Email”, “Telefone”	“Telefone”	“E-mail”
Email	Texto	Sim	Outros contatos: zero ou mais itens. Disponível se “Tipo de Contato” for definido como “Email” Alfanumérico, máximo 255 caracteres	“joaquim@email.com”	Vazio
Número	Texto	Sim	Outros contatos: zero ou mais itens. Disponível se “Tipo de Contato” for definido como “Telefone” Numérico, 11 dígitos, máscara (XX) XXXXX-XXXX	“(35) 99999-1111”	Vazio
Observação	Texto	Não	Outros contatos: zero ou mais itens. Alfanumérico, máximo 1500 caracteres	“Telefone do filho”	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

O sistema exibe as ações comuns de cadastro, conforme AC003 — Ações das telas de cadastro.

4. Visualizar unidade de consolidação

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 Unidade de Consolidação	Texto	Código único gerado após o cadastro, conforme RNE002.	31016070001

O sistema exibe as ações comuns de visualização, conforme AC004 — Ações das telas de visualização.

5. Editar unidade de consolidação

Dado que estou na tela de edição
Então o sistema exibe os campos do cadastro preenchidos. A fonte permite sua edição sem exceções, enquanto o código acrescentado na visualização permanece como somente leitura.

Os componentes utilizados possuem campos derivados ou fixos definidos como somente leitura. A compatibilidade dessas restrições com a edição sem exceções precisa ser confirmada; as definições dos componentes foram preservadas nesta conversão.

O sistema exibe as ações comuns de edição, conforme AC005 — Ações das telas de edição.

Regras de negócio específicas

RNE001 — Unicidade a definir

O cadastro deve ser único no sistema, mas a fonte informa que o cliente ainda não definiu como identificar cadastros duplicados.

RNE002 — Geração do código

Após o cadastro, o sistema deve gerar um código único de 11 dígitos: código IBGE do município, com 7 dígitos, seguido de um sequencial de 4 dígitos por ordem de cadastro.

Histórico da fonte

Versão	Data	Alteração
v1.0	04/12/2025	Primeira versão da história.

Histórias e referências relacionadas

• US005 — Cadastro e edição de divisão municipal.
• US042 — Gerenciar pessoa física.
• US044 — Gerenciar pessoa jurídica.
• US064 — Gerenciar profissional da área vegetal.
• Documentação comum a várias histórias: ações comuns AC001 a AC005 e permissões de acesso RNC007.
• Componentes.
• Vinculações de cadastros.
• Manual de padronização da PGA.

Protótipos

• Buscar e listar.
• Cadastrar.
• Visualizar.
• Editar.

Pendências da fonte

• A identificação de cadastros duplicados ainda não foi definida (RNE001).
• O filtro Município depende do preenchimento de Estado, mas a busca não define esse campo. Confirmar se Estado deve ser incluído ou se Município fica disponível para Minas Gerais sem essa condição.
• O componente de localização foi informado como Estado fixo = Sim. Confirmar Minas Gerais como valor fixo, adotado nesta conversão a partir do filtro de municípios.
• O critério de edição permite alterar todos os campos do cadastro, sem exceções, mas os componentes contêm campos somente leitura e o estado é fixo. Confirmar quais campos devem efetivamente ser editáveis.
• A referência das ações de listagem foi informada como AC001; foi alinhada a AC002, conforme o padrão das demais histórias.
• O título Engenheiro Engenheiro Agrônomo/Florestal repetia a palavra Engenheiro; a repetição foi removida. Os exemplos de profissionais na listagem não incluem o CPF exigido nas descrições e foram preservados para conferência.