Exploração agrícolaPronto

Eu, como usuário do sistema AgroDigital, quero buscar exploração agrícola, listar explorações agrícolas, cadastrar exploração agrícola, visualizar exploração agrícola e editar exploração agrícola para gerenciar explorações agrícolas.

1. Buscar exploração agrícola

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Exploração Agrícola, 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 da Exploração Agrícola	Texto numérico	Não	Tamanho = 17 caracteres.	31002030039100001	Vazio
Estabelecimento Agropecuário	Seleção de entidade: estabelecimento agropecuário	Não	Valores = estabelecimentos agropecuários cadastrados no sistema.	Fazenda Rio Preto	Vazio
Produtor	Seleção de entidade: produtor	Não	Valores = pessoas físicas ou jurídicas produtoras de explorações agrícolas cadastradas.	José Aarão Neto	Vazio
Município	Seleção pesquisável	Não	Valores = municípios de Minas Gerais.	Lavras	Vazio
Variedade de Cultura	Seleção de entidade: variedade de cultura	Não	Valores = variedades das culturas cadastradas no sistema.	Abóbora Kabocha	Vazio
Vencendo em	Seleção simples	Não	Valores = 30 dias, 7 dias, Hoje, Período.	30 dias	Vazio
Período de Vencimento — De	Data	Não	Disponível se Vencendo em = Período.	01/01/2027	Vazio
Período de Vencimento — Até	Data	Não	Disponível se Vencendo em = Período. A fonte exige que seja maior que a própria data Até; a comparação precisa ser confirmada.	31/12/2027	Vazio
Situação do Cadastro	Seleção simples	Não	Valores = Ativo, Inativo, Suspenso.	Ativo	Vazio

O sistema exibe as ações comuns de busca Inicial, Adicionar Novo e Pesquisar (AC001).

2. Listar explorações agrícolas

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	Não	Código da exploração agrícola.	31002030039100001
Estabelecimento Agropecuário	Texto	Sim	Código e nome do estabelecimento vinculado.	10234567891 - Fazenda do Rio
Produtores	Texto	Sim	CPF/CNPJ e nome/razão social dos produtores.	José Aarão Neto - 555.009.956-40, Divino de Souza Sobrinho - 444.009.956-40…
Município — UF	Texto	Sim	Município e UF do estabelecimento vinculado.	Abadia dos Dourados - MG
Cultura — Variedade	Texto	Sim	Cultura e variedade vinculadas à exploração.	Abacaxi Amarelo
Data de Vencimento	Texto	Sim	Vencimento da exploração. A fonte o relaciona à data de plantio informada na manutenção; ver pendências.	01/06/2023
Situação	Texto	Sim	Situação do cadastro.	Ativo

Para cada resultado, o sistema exibe Visualizar e Editar, conforme AC002.

3. Cadastrar exploração agrícola

Dado que estou na tela de cadastro
Então o sistema exibe o formulário descrito a seguir.

Estabelecimento agropecuário

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Estabelecimento Agropecuário	Seleção de entidade: estabelecimento agropecuário	Sim	Valores = estabelecimentos agropecuários cadastrados no sistema (US050).	Fazenda Rio Preto	Vazio

Informações de área

Disponível quando Estabelecimento Agropecuário estiver preenchido.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Unidade de Medida da Área	Seleção simples	Sim	Valores = Metros Quadrados, Hectares.	Hectares	Hectares
Área Produtiva do Estabelecimento Agropecuário	Decimal	Sim	Somente leitura. Corresponde ao estabelecimento selecionado. Exibida na unidade de medida escolhida.	1000,00	Vazio
Área Útil da Exploração	Decimal	Sim	Tamanho = 12 dígitos. Deve ser menor ou igual à Área Produtiva do Estabelecimento Agropecuário.	20,00	Vazio

A área útil deve respeitar os limites da área produtiva disponível. A ajuda da fonte alerta que outras explorações agrícolas e pecuárias no estabelecimento podem provocar sobreposição, sem definir uma validação adicional para a soma das áreas.

Produtores

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Produtor	Seleção simples	Sim	Valores = Inquilino, Arrendatário, Assentado, Comodatário, Beneficiário de doação com reserva de usufruto, Meeiro, Parceiro Rural, Posseiro, Possuidor, Proprietário, Sócio, Usufrutuário.	Meeiro	Vazio
Produtor	Seleção de entidade	Sim	Valores = pessoas físicas ou jurídicas cadastradas (US042 e US044). Pesquisa por nome/razão social ou CPF/CNPJ.	José Aarão Neto	Vazio

Informações da cultura explorada

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Variedade de Cultura	Seleção de entidade: variedade de cultura	Sim	Valores = variedades das culturas cadastradas no sistema (US034).	Abóbora Kabocha	Vazio
Unidade de Medida Padrão	Seleção de entidade: unidade de medida	Sim	Valores = unidades de medida do tipo vegetal cadastradas no sistema (US048).	KG	Vazio

Informações complementares

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Data de Plantio	Data	Sim	Não pode ser futura.	01/06/2023	Vazio
Localização do Livro	Texto curto	Sim	Nenhuma validação adicional informada na fonte.	Próximo ao balcão	Vazio
É uma Unidade de Produção? (Necessita de CFO)	Seleção simples	Sim	Valores = Sim, Não. Se Sim, caracteriza uma Unidade de Produção que necessita de CFO e de atualizações de manutenção.	Sim	Não
Data de vencimento	Data	Não informado na fonte	Disponível se É uma Unidade de Produção? = Sim. Somente leitura. Calculada como Data de Plantio acrescida de 1 ano.	Não informado na fonte	Calculada a partir da Data de Plantio
Necessita de Responsável Técnico?	Seleção simples	Sim	Valores = Sim, Não. Requisitos do profissional conforme RNE004 e US078.	Sim	Não

CFO significa Certificado Fitossanitário de Origem.

Informações de localização

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
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

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.

4. Visualizar exploração agrícola

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 Exploração Agrícola	Texto	Código único gerado após o cadastro, conforme RNE002.	31002030039100001

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

Ação específica

Manutenção fica disponível se a exploração estiver caracterizada como Unidade de Produção e dá acesso às manutenções descritas na US078.

5. Editar exploração agrícola

Dado que estou na tela de edição
Então o sistema exibe os campos do cadastro preenchidos e editáveis, exceto a seção Estabelecimento Agropecuário. O código e os demais campos definidos como somente leitura permanecem bloqueados.

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

Regras de negócio específicas

RNE001 — Unicidade

O cadastro deve ser único pela combinação de Data de Plantio e localização da exploração agrícola.

RNE002 — Geração do código

Após o cadastro, o sistema deve gerar um código único de 17 dígitos: os 11 dígitos do código da propriedade, seguidos de 2 dígitos do ano do cadastro e um sequencial inteiro de 4 dígitos.

Exemplo: a primeira unidade de produção cadastrada em 2026 na propriedade 34523423567 recebe o código 34523423567260001.

RNE003 — Manutenção e inativação automática

Após o cadastro, inicia-se um contador de 1 ano a partir da Data de Plantio. Se uma Unidade de Produção, isto é, uma exploração que necessita de CFO, não receber nenhuma atualização de manutenção nesse prazo, o sistema deve inativá-la automaticamente.

RNE004 — Habilitações do responsável técnico

O responsável técnico deve possuir habilitações para todas as pragas cadastradas para a cultura explorada.

Se uma nova praga for adicionada à cultura e o responsável técnico não possuir a certificação correspondente, o sistema deve gerar um alerta e alterar a situação do cadastro para Suspenso.

O responsável técnico deve ser notificado sobre a suspensão temporária, com código da exploração, nome da propriedade, cultura e nova praga.

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

• US078 — Manutenção da exploração agrícola.
• US019 — Gerenciar notificações do usuário.
• US034 — Gerenciar cultura, identificada como US039 na fonte.
• US042 — Gerenciar pessoa física.
• US044 — Gerenciar pessoa jurídica.
• US050 — Gerenciar estabelecimento agropecuário.
• US048 — Unidade de medida.
• Documentação comum a várias histórias: AC001 a AC005 e RNC007, citados na fonte.
• Componentes.
• Vinculações de cadastros.
• Manual de padronização da PGA.

Protótipos

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

Pendências da fonte

• A validação de Período de Vencimento — Até exige que o valor seja maior que ele próprio. Confirmar se a comparação pretendida é com De e se a igualdade é permitida.
• A listagem relaciona o vencimento a uma data de plantio informada na manutenção, mas a US078 não contém Data de Plantio. Confirmar a origem da data e o recálculo após manutenção.
• A linha Data de vencimento contém uma anotação editorial no lugar do tipo e não informa obrigatoriedade. O tipo foi apresentado como Data, mantendo a obrigatoriedade pendente.
• A obrigatoriedade de Unidade de Medida Padrão estava grafada como Sima; foi normalizada para Sim.
• A fonte referencia Cultura como US039, mas o link é o mesmo da US034 fornecida; a referência foi alinhada à US034.
• A RNE004 descreve a existência de responsável técnico, mas o formulário permite Necessita de Responsável Técnico? = Não e só a manutenção contém sua seleção. Confirmar os casos em que o RT é obrigatório e como é vinculado antes da primeira manutenção.
• Confirmar o efeito de cada manutenção sobre o contador anual da RNE003; a fonte descreve a inativação quando nenhuma manutenção é realizada, sem definir um novo prazo após a manutenção.