Fundo de arrecadaçãoRascunho

Eu, como usuário do sistema AgroDigital, quero buscar fundo de arrecadação, listar fundo de arrecadação, adicionar fundo de arrecadação, visualizar fundo de arrecadação, editar fundo de arrecadação, listar convênio, adicionar convênio, visualizar convênio e editar convênio para gerenciar fundos de arrecadação.

Histórico da fonte

• v1.1 - 05/08/2026: Conversão para o formato completo.
• v1.0 - 09/07/2026: Primeira versão da história.

História de usuário

Eu, como usuário do sistema, quero gerenciar fundos de arrecadação, para que eu possa permitir a gestão eficiente dessas informações.

1. Buscar fundo de arrecadação

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Fundo de Arrecadação (Ver RNC007 - Permissões de Acesso)
Então o sistema exibe a tela de busca, contendo os seguintes filtros:

Campo	Tipo	Obrigatório	Validações
Nome do Fundo de Arrecadação	Texto	Não	Tamanho = 255 caracteres
Tipo do Fundo de Arrecadação	Seleção simples	Não	Valores = “Público”, “Privado”
Situação	Seleção simples	Não	Valores = “Ativo”, “Inativo”

E exibe as seguintes ações: (Ver AC001 - Ações das telas de busca)

2. Listar fundo de arrecadação

Dado que estou na tela de busca
E o campo de busca e/ou pelo menos um dos filtros disponíveis foi corretamente preenchido
Quando realizo a ação “Pesquisar”
E o sistema encontrou registros compatíveis com os valores informados
Então o sistema exibe os resultados retornados, contendo os seguintes campos:

Campo	Descrição
Nome do Fundo de Arrecadação	Exibe o nome do fundo de arrecadação
Tipo do Fundo de Arrecadação	Exibe o tipo do fundo de arrecadação
Situação	Exibe a situação do cadastro

E exibe as seguintes ações: (Ver AC002 - Ações das telas de listagem)

3. Adicionar fundo de arrecadação

Dado que estou na tela de cadastro
Então o sistema exibe um formulário, contendo os seguintes campos:

Informações Básicas

Campo	Tipo	Obrigatório	Editável	Validações
Nome do Fundo de Arrecadação	Texto	Sim	Sim	Tamanho = 255 caracteres
Pessoa Jurídica	Seleção simples de entidade: pessoa jurídica	Sim	Sim	Valores = pessoas jurídicas cadastradas no sistema
Tipo do Fundo de Arrecadação	Seleção simples	Sim	Sim	Valores = “Privado”, “Público”

Localização simples

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.	Minas Gerais	Vazio
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

Os campos deste componente admitem edição (EDT = Sim), conforme a fonte.

Contatos com proprietários

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

Os campos deste componente admitem edição (EDT = Sim), conforme a fonte.

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 campos deste componente admitem edição (EDT = Sim), conforme a fonte.

E exibe as seguintes ações: (Ver AC003 - Ações das telas de cadastro e AC006 - Ações de interação com formulários)

4. Visualizar fundo de arrecadação

Dado que estou na tela de visualização
Então o sistema exibe os campos do formulário descrito no critério de aceitação 3 como somente leitura, com seus valores já preenchidos
E, além desses, exibe os seguintes campos, também como somente leitura:

Situação

Campo	Tipo	Obrigatório	Editável	Validações
Situação	Seleção simples	Sim	Sim	Valores = “Ativo”, “Inativo”

E exibe as seguintes ações: (Ver AC004 - Ações das telas de visualização e AC006 - Ações de interação com formulários)

5. Editar fundo de arrecadação

Dado que estou na tela de edição
Então o sistema exibe todos os campos descritos nos critérios de aceitação 3 e 4, com seus valores já preenchidos
E permite editar todos os campos passíveis de edição (EDT = Sim)
E exibe as seguintes ações: (Ver AC005 - Ações das telas de edição e AC006 - Ações de interação com formulários)

Aba: Convênio

---

6. Listar convênio

Dado que estou na tela visualização de um Fundo de Arrecadação
Quando acesso a aba Convênio
Então o sistema exibe os seguintes campos:

Convênio

Itens Ativos (Zero ou um) / Itens Inativos (Zero ou mais)

Campo	Descrição
Cadastrado:	Exibe a data do cadastro
Nome do Convênio	Exibe o nome do convênio
Número do Convênio	Exibe o número do convênio
Carteira / Variação	Exibe o número da carteira / número da variação da carteira
Situação	Exibe a situação do cadastro

E exibe as seguintes ações: (Ver AC002 - Ações das telas de listagem)

Ação	Descrição
Adicionar Convênio	Vai para a tela de cadastro de um novo convênio

7. Adicionar convênio

Dado que estou na tela de visualização de um Fundo de Arrecadação
Quando acesso a aba Convênio
E realizo a ação “Adicionar Convênio”
Então o sistema exibe um formulário, contendo os seguintes campos:

Informações Básicas

Campo	Tipo	Obrigatório	Editável	Validações
Nome do Convênio	Texto	Sim	Sim	Tamanho = 255 caracteres
Número do Convênio	Inteiro	Sim	Sim	Tamanho = 7 caracteres
Número da Carteira	Inteiro	Sim	Sim	Tamanho = 2 caracteres
Número Variação da Carteira	Inteiro	Sim	Sim	Tamanho = 3 caracteres
Tipo de Título	Texto	Sim	Sim	Tamanho = 255 caracteres
Número do Título	Texto	Sim	Sim	Tamanho = 15 caracteres
Descrição	Texto	Sim	Sim	Tamanho = 255 caracteres
Código do Tipo Conta Caução	Inteiro	Sim	Sim	Tamanho = 1 caractere
Mensagem de Bloqueto	Texto	Sim	Sim	Tamanho = 255 caracteres

8. Visualizar convênio

Dado que estou na tela de visualização
Então o sistema exibe os campos do formulário descrito no critério de aceitação 7 como somente leitura, com seus valores já preenchidos
E, além desses, exibe os seguintes campos, também como somente leitura:

Situação

Campo	Tipo	Obrigatório	Editável	Validações
Situação	Seleção simples	Sim	Sim	Valores = “Ativo”, “Inativo”

E exibe as seguintes ações: (Ver AC004 - Ações das telas de visualização e AC006 - Ações de interação com formulários)

9. Editar convênio

Dado que estou na tela de edição
Então o sistema exibe todos os campos descritos nos critérios de aceitação 7 e 8, com seus valores já preenchidos
E permite editar todos os os campos passíveis de edição (EDT = Sim)
E exibe as seguintes ações: (Ver AC005 - Ações das telas de edição e AC006 - Ações de interação com formulários)

Regras de negócio específicas

A fonte não apresenta conteúdo nesta seção.

Documentos vinculados

• Receita.
• Opção de recolhimento das entidades.

Convenções da conversão

As colunas Obrigatório e Editável correspondem a OBG e EDT da fonte. A edição posterior deve respeitar também as condições de somente leitura e situação do cadastro. As ações comuns foram mantidas nos pontos citados. Não foram criados exemplos, padrões ou regras ausentes da fonte.

Pendências da fonte

• A fonte não informa código US; nenhum identificador foi criado.
• A aba Convênio admite zero ou um ativo, mas não define como impedir múltiplos ativos ou inativar o anterior.
• A fonte não define chave de unicidade do fundo ou do convênio. A seção de regras específicas está vazia.