Promotora de Eventos PecuáriosPronto

Eu, como usuário do sistema AgroDigital, quero buscar promotora de eventos pecuários, listar promotoras de eventos pecuários, cadastrar promotora de eventos pecuários, visualizar promotora de eventos pecuários e editar promotora de eventos pecuários para gerenciar promotoras de eventos pecuários.

1. Buscar promotora de eventos pecuários

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Promotora de Eventos Pecuários, 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
Número do Registro ou Nome da Promotora de Eventos Pecuários	Texto curto	Não	Alfanumérico. Tamanho máximo = 255 caracteres.	Promotora São José	Vazio
Proprietário (Nome Fantasia)	Seleção pesquisável	Não	Valores = pessoas jurídicas cadastradas no sistema (US044). Pesquisa por nome fantasia ou CNPJ.	Promotora São José - 72.375.545/0001-93	Vazio
Estado	Seleção simples	Sim	Valores = todos os estados brasileiros.	Minas Gerais	Minas Gerais
Município	Seleção pesquisável	Não	Disponível se Estado estiver preenchido. Valores = municípios brasileiros do estado selecionado.	Lavras	Vazio
Situação	Seleção simples	Não	Valores da fonte = Ativo, Inativo, Suspender. O último rótulo diverge da situação Suspenso utilizada no cadastro.	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 o cadastro de promotora.
Pesquisar	Realiza a busca utilizando o campo de busca e os filtros.
Inicial	Retorna à tela inicial para usuários autenticados.

2. Listar promotoras de eventos pecuários

Dado que estou na tela de busca
E o campo de busca e/ou pelo menos um filtro 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
Número do Registro	Texto	Sim	Número do registro da promotora.	99970948
Nome	Texto	Sim	Nome da promotora.	Promotora São José
Proprietário	Texto	Não	CNPJ e nome fantasia do proprietário.	72.375.545/0001-93 - Promotora São José
Município — UF	Texto	Sim	Município e UF da promotora.	Lavras - MG
Situação	Texto	Não	Situação do cadastro.	Ativo

Para cada resultado, o sistema exibe Visualizar e Editar, que abrem as respectivas telas da promotora selecionada.

3. Cadastrar promotora de eventos pecuários

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 Comercial da Promotora	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres.	JHE Leilões LTDA	Vazio

Opção de recolhimento

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Promotora Aderida ao Fundo Privado (FUNDESA)?	Seleção simples	Sim	Valores = Sim, Não.	Sim	Não

Proprietário

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Proprietário (Nome Fantasia)	Seleção pesquisável	Sim	Valores = pessoas jurídicas cadastradas no sistema (US044). Pesquisa por nome fantasia ou CNPJ.	José Aarão Neto (exemplo da fonte)	Vazio
CNPJ	Texto	Sim	Somente leitura. Disponível quando Proprietário estiver preenchido. Corresponde à pessoa jurídica selecionada. Unicidade conforme RNE001.	555.009.956-40 (exemplo da fonte, com formato de CPF)	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
Estado (zona rural)	Seleção simples	Sim	Disponível se Zona = Rural. Valores = lista de todos os estados brasileiros.	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.	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

Para este cadastro, o endereço rural, correspondente ao nome da estrada e quilômetro de referência, admite no máximo 255 caracteres. O Número do endereço urbano admite no máximo 20 caracteres, conforme a versão v1.2 da fonte.

O estado rural tem valor padrão Minas Gerais, permanecendo editável. A geolocalização é informada nos formatos DMS ou DD, manualmente ou pelo mapa, com consulta à API do Google Maps e máscara conforme RN010, tanto na zona rural quanto na urbana.

Informações de contato

Os contatos do proprietário escolhidos para o cadastro são exibidos na seção Contatos de [Proprietário], com um ou mais itens quando houver seleção.

Contatos obrigatórios

Disponíveis se nenhum contato do proprietário for escolhido como contato do cadastro.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Contato (Email)	Seleção simples	Sim	Somente leitura.	E-mail	E-mail
Email	Texto curto	Sim	Alfanumérico. Tamanho máximo = 255 caracteres.	joaquim@email.com	Vazio
Observação do email	Texto longo	Não	Alfanumérico. Tamanho máximo = 1500 caracteres.	Meu email padrão	Vazio
Tipo de Contato (Telefone)	Seleção simples	Sim	Somente leitura.	Telefone	Telefone
Número	Texto numérico	Sim	Somente leitura, conforme a fonte. Tamanho = 11 dígitos. Formato = (XX) XXXXX-XXXX.	(35) 99999-1111	Vazio
Observação do telefone	Texto longo	Não	Alfanumérico. Tamanho máximo = 1500 caracteres.	Meu telefone	Vazio

Outros contatos (zero ou mais)

Cada item contém:

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Contato	Seleção simples	Sim	Valores = Email, Telefone, conforme rótulos da fonte.	Telefone	E-mail (grafia da fonte)
Email	Texto curto	Sim	Disponível se Tipo de Contato = Email. Alfanumérico. Tamanho máximo = 255 caracteres.	joaquim@email.com	Vazio
Número	Texto numérico	Sim	Disponível se Tipo de Contato = Telefone. Tamanho = 11 dígitos. Formato = (XX) XXXXX-XXXX.	(35) 99999-1111	Vazio
Observação	Texto longo	Não	Alfanumérico. Tamanho 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

Os anexos admitem zero ou mais itens, cada um com Documento e Descrição. O sistema exibe o nome do arquivo anexado. A observação permite registrar informações adicionais pertinentes ao cadastro.

Ações e resultado

Ação	Disponibilidade e comportamento
Adicionar	Valida os dados, salva o cadastro e abre a tela de sucesso.
Todas as promotoras de eventos pecuários	Retorna à busca.
Ver item	Abre a visualização de cada item relacionado a outro cadastro.
Adicionar/Remover item	Adiciona ou remove itens dos grupos repetíveis, conforme RNE003.
Baixar documento	Baixa o documento de cada anexo informado.

Em caso de sucesso, o sistema exibe uma mensagem e as ações Voltar, que retorna à busca, e Visualizar, que abre a visualização do cadastro.

4. Visualizar promotora de eventos pecuários

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	Número do Registro	Texto	Número do registro gerado após o cadastro, conforme RNE004.	14385
Informações Básicas	Data de Vencimento do Registro	Data	Calculada automaticamente como data do cadastro acrescida de 3 anos, conforme RNE005.	05/08/2027
Situação do Cadastro	Situação	Texto	Situação atual do cadastro.	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 Última Modificação	Data e hora	Data e hora da última alteração.	14/04/2012 07:29

O sistema exibe Editar e Todas as promotoras de eventos pecuários, além de Ver item e Baixar documento, quando aplicáveis, com os comportamentos descritos no cadastro.

Renovar registro

A ação Renovar registro fica disponível apenas se o registro atual estiver vencido e atualiza seu número e sua data de vencimento, conforme RNE004 e RNE005. A fonte não detalha o cálculo da nova validade na renovação.

5. Editar promotora de eventos pecuários

Dado que estou na tela de edição
Então o sistema exibe os campos do cadastro preenchidos e editáveis, preservando os campos definidos como somente leitura. Os campos adicionais da visualização permanecem como somente leitura.

Ação	Comportamento
Salvar	Abre a confirmação das edições.
Ativar/Inativar/Suspender	Altera a situação para Ativo, Inativo ou Suspenso, conforme RN009.
Visualizar promotora de eventos pecuários	Retorna à visualização.

O sistema também exibe Ver item, Adicionar/Remover item e Baixar documento, quando aplicáveis, com os comportamentos descritos no cadastro.

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 — Unicidade por CNPJ

O cadastro deve ser único no sistema pelo CNPJ.

RNE002 — Geração do código

Após o cadastro, o sistema deve gerar um código único, inteiro e incremental.

RNE003 — Grupos repetíveis

O cadastro admite múltiplos contatos e anexos:

Grupo	Campos agrupados
Contato	Tipo de Contato, Número ou Email e Observação.
Anexo	Documento e Descrição.

RNE004 — Número do registro

Após o cadastro, o sistema deve gerar um número de registro único, inteiro e incremental. Esse número só pode ser atualizado após o vencimento do registro, conforme RNE005.

RNE005 — Vencimento e notificações

A Data de Vencimento do Registro deve ser calculada automaticamente após o cadastro, com a data atual acrescida de 3 anos. Exemplo: cadastro em 05/10/2025, vencimento em 05/10/2028.

Próximo ao vencimento:

• Todos os representantes legais da pessoa jurídica proprietária devem ser notificados por e-mail e pelo sistema de notificações (US019).
• A notificação deve incluir nome fantasia, CNPJ, número do registro e data de vencimento.
• As notificações devem ser enviadas com 30, 7 e 1 dia de antecedência, ou até a atualização do cadastro com uma nova data de vencimento.

Ao expirar a validade, o sistema deve alterar a situação para Suspenso e gerar um alerta de vencimento, mantendo o cadastro nessa condição até a regularizaçã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.
• CA003 — Notificar erro ao usuário devido a falha técnica.
• CA009 — Busca sem resultados.
• CA010 — Uso incorreto de filtros de busca.
• CA011 — Indicação de filtros de busca aplicados.
• RN003 — Controle de alterações em uma entidade.
• RN007 — Permissões de acesso.
• RN008 — Sobre o uso de filtros de busca, identificação utilizada pela US059.
• RN009 — Situação do cadastro de uma entidade com opção de suspensão.
• RN010 — Coordenadas geográficas no componente de endereços.

Histórico da fonte

História	Versão	Data	Alteração
US058 — Gerenciar promotora de eventos pecuários	v1.2	19/01/2026	Thaís: ampliação do Número do Endereço de 10 para 20 caracteres.
US058 — Gerenciar promotora de eventos pecuários	v1.1	15/12/2025	Alterações pós BH.
US058 — Gerenciar promotora de eventos pecuários	v1.0	28/11/2025	Primeira versão da história.
US059 — Buscar promotora de eventos pecuários	v1.0	28/11/2025	Primeira versão da história.

Histórias e referências relacionadas

• US058 — Gerenciar promotora de eventos pecuários, consolidada neste documento.
• US059 — Buscar promotora de eventos pecuários, consolidada neste documento.
• US005 — Cadastro e edição de divisão municipal.
• US042 — Gerenciar pessoa física, referência mantida conforme a fonte, embora o proprietário seja pessoa jurídica.
• US044 — Gerenciar pessoa jurídica.
• US019 — Notificações do usuário, utilizada nos avisos de vencimento.
• Requisitos não funcionais e técnicos.
• Planilha de Módulos e Permissões do sistema.

Protótipos

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

Validação

As duas fontes registram validação em reunião on-line em 28/11/2025.

Pendências da fonte

• O filtro de situação usa Suspender, enquanto o cadastro usa Suspenso. Confirmar o rótulo do filtro.
• O proprietário deve ser pessoa jurídica, mas o exemplo é um nome de pessoa física e o exemplo do CNPJ possui formato de CPF. Os exemplos do cadastro foram preservados para conferência.
• Código interno (RNE002) e número do registro (RNE004) são descritos separadamente; confirmar sua relação e a apresentação do código interno, ausente dos campos de visualização.
• A renovação altera o número e a validade, mas a fonte não define a data-base da nova validade nem a alteração da situação após regularização.
• O telefone obrigatório está marcado como somente leitura e tem valor padrão vazio, sem definir como recebe seu valor quando nenhum contato do proprietário é escolhido. Confirmar esse preenchimento.
• O tipo dos contatos adicionais utiliza Email, enquanto o valor padrão utiliza E-mail. Confirmar a grafia canônica.
• O campo Situação da listagem tinha o tipo informado como Tipo; foi adequado para Texto. O exemplo do proprietário na busca repetia a palavra Promotora; a repetição foi removida.