Revendedora de Animais VivosPronto
US072Eu, como usuário do sistema AgroDigital, quero buscar revendedora de animais vivos, listar revendedoras de animais vivos, cadastrar revendedora de animais vivos, visualizar revendedora de animais vivos, editar revendedora de animais vivos e listar vinculações para gerenciar revendedoras de animais vivos.
1. Buscar revendedora de animais vivos
Seção intitulada “1. Buscar revendedora de animais vivos”Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Revendedora de Animais Vivos, 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 Revendedora de Animais Vivos | Texto curto | Não | Alfanumérico. Tamanho máximo = 255 caracteres. | Revendedora São José | Vazio |
| Tipo de Pessoa | Seleção simples | Sim | Valores = Pessoa física, Pessoa jurídica. | Pessoa física | Pessoa física |
| Proprietário (Nome/Razão Social) | Seleção pesquisável | Sim | Valores = pessoas físicas ou jurídicas cadastradas (US042 e US044). Pré-filtradas por Tipo de Pessoa. Pesquisa por nome/razão social ou CPF/CNPJ. | José Aarão Neto | Vazio |
| Espécie | Seleção | Sim | Valores = espécies cadastradas (US016). Pesquisa por nome ou grupo da espécie. | Bovino | Vazio |
| Município | Seleção pesquisável | Não | Valores = municípios de Minas Gerais. | Lavras | Vazio |
| Situação | Seleção simples | Não | Valores = Ativo, Inativo. | Ativo | Vazio |
O sistema solicita que o usuário selecione pelo menos um filtro e/ou utilize o campo de busca para visualizar os resultados.
| Ação | Comportamento |
|---|---|
| Adicionar Novo | Abre o cadastro de revendedora. |
| Pesquisar | Realiza a busca utilizando o campo de busca e os filtros. |
| Inicial | Retorna à tela inicial para usuários autenticados. |
2. Listar revendedoras de animais vivos
Seção intitulada “2. Listar revendedoras de animais vivos”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 |
|---|---|---|---|---|
| Código | Texto | Não | Código da revendedora. | 31236598486 |
| Nome | Texto | Sim | Nome da revendedora. | Revendedora São José |
| Proprietários | Texto | Não | CPF/CNPJ e nome/nome fantasia dos proprietários. | José Aarão Neto - 555.009.956-40, Divino de Souza Sobrinho - 444.009.956-40… |
| Grupo — Espécie | Texto | Não | Grupo e espécie comercializada pela revendedora. | Aves - Codorna |
| Município — UF | Texto | Sim | Município e UF da revendedora. | Lavras - MG |
| Situação | Texto | Sim | Situação do cadastro. | Ativo |
Para cada resultado, o sistema exibe Visualizar e Editar, que abrem as respectivas telas da revendedora selecionada.
3. Cadastrar revendedora de animais vivos
Seção intitulada “3. Cadastrar revendedora de animais vivos”Dado que estou na tela de cadastro
Então o sistema exibe o formulário descrito a seguir.
Informações básicas
Seção intitulada “Informações básicas”| Campo | Tipo | Obrigatório | Validações | Exemplo | Valor padrão |
|---|---|---|---|---|---|
| Nome Comercial da Revendedora | Texto curto | Sim | Alfanumérico. Tamanho máximo = 255 caracteres. | Revendedora São José | Vazio |
Proprietários (um ou mais)
Seção intitulada “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 |
Espécies comercializadas (uma ou mais)
Seção intitulada “Espécies comercializadas (uma ou mais)”Cada item contém:
| Campo | Tipo | Obrigatório | Validações | Exemplo | Valor padrão |
|---|---|---|---|---|---|
| Espécie | Seleção pesquisável | Sim | Valores = espécies cadastradas (US016). | Codorna | Vazio |
| Capacidade de Alojamento da Espécie | Texto numérico | Sim | Tamanho = 12 dígitos, conforme a fonte. | 300 | Vazio |
Funcionários da revendedora (zero ou mais)
Seção intitulada “Funcionários da revendedora (zero ou mais)”Cada item contém:
| Campo | Tipo | Obrigatório | Validações | Exemplo | Valor padrão |
|---|---|---|---|---|---|
| Funcionário da Revendedora (Nome) | Seleção pesquisável | Sim | Valores = pessoas físicas cadastradas (US042). Pesquisa por nome ou CPF. | Wagner Heleno Da SIlveira (grafia da fonte) | Vazio |
| CPF | Texto | Sim | Somente leitura. Disponível quando Funcionário da Revendedora estiver preenchido. Corresponde à pessoa selecionada. | 444.009.956-40 | Vazio |
Informações de localização
Seção intitulada “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 = 10 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 |
O campo Zona tem padrão Rural. O Estado rural permanece somente leitura com Minas Gerais. 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 10 caracteres.
A geolocalização pode ser informada manualmente ou selecionada no mapa, com consulta à API do Google Maps, estimativa inicial a partir do endereço e formato DMS ou DD, conforme RN010. A configuração do componente restringe a localização a Minas Gerais; o alcance dessa restrição para CEPs urbanos está registrado nas pendências.
Informações de contato
Seção intitulada “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” |
| 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” |
| 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 |
O usuário pode utilizar os contatos dos proprietários, selecionando Aplicar? para cada proprietário. Utilizar Contato de Proprietários? tem padrão Sim, e Aplicar? tem padrão Falso.
Se a opção não for utilizada ou nenhum contato de proprietário for escolhido, o sistema exibe os contatos obrigatórios de e-mail e telefone. Outros contatos admitem zero ou mais itens.
Anexos e observações
Seção intitulada “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, 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
Seção intitulada “Ações e resultado”| Ação | Disponibilidade e comportamento |
|---|---|
| Adicionar | Valida os dados, salva o cadastro e abre a tela de sucesso. |
| Todas as revendedoras de animais vivos | 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, respeitando as quantidades do formulário. |
| 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 revendedora de animais vivos
Seção intitulada “4. Visualizar revendedora de animais vivos”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 Revendedora | Texto | Código único gerado após o cadastro; a regra de geração citada na fonte não foi fornecida. | 3123659848 |
| Situação do Cadastro | Situação | Texto | Situação atual do cadastro. | Ativo |
O sistema exibe Editar e Todas as revendedoras de animais vivos, além de Ver item e Baixar documento quando aplicáveis, com os comportamentos descritos no cadastro.
| Outras ações | Comportamento |
|---|---|
| Cadastro | Abre a visualização do cadastro. |
| Vinculações | Abre a aba de vinculações. |
5. Editar revendedora de animais vivos
Seção intitulada “5. Editar revendedora de animais vivos”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. Código da Revendedora e Situação permanecem como somente leitura.
| Ação | Comportamento |
|---|---|
| Salvar | Abre a confirmação das edições. |
| Ativar/Inativar | Alterna a situação entre Ativo e Inativo, conforme RNC008 — Situação do cadastro de uma entidade sem opção de suspensão, citada na fonte. |
| Visualizar revendedora de animais vivos | 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.
6. Listar vinculações
Seção intitulada “6. Listar vinculações”Dado que estou na aba de vinculações
Então o sistema deve exibir as vinculações previstas no documento Vinculações de cadastros. A tabela da US072 está vazia e não define quais itens devem ser apresentados.
| Ação | Disponibilidade e comportamento |
|---|---|
| Todas as revendedoras de animais vivos | Retorna à busca. |
| Visualizar | Disponível para cada item apresentado. Abre a visualização do item vinculado. |
| Editar | Disponível para cada item apresentado. Abre a edição do item vinculado. |
| Cadastro | Abre a visualização do cadastro da revendedora. |
| Vinculações | Abre a tela de vinculações da revendedora. |
Regras de negócio específicas
Seção intitulada “Regras de negócio específicas”RNE001 — Unicidade a definir
Seção intitulada “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.
Critérios de aceitação e regras comuns
Seção intitulada “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.
- RNC007 — Permissões de acesso.
- RNC008 — Situação do cadastro de uma entidade sem opção de suspensão.
- RN010 — Coordenadas geográficas no componente de endereços.
Histórico da fonte
Seção intitulada “Histórico da fonte”| Versão | Data | Alteração |
|---|---|---|
| v1.0 | 17/03/2026 | Primeira versão da história. |
Histórias e referências relacionadas
Seção intitulada “Histórias e referências relacionadas”- US005 — Gerenciar divisão municipal.
- US016 — Cadastro e edição de espécie.
- US042 — Gerenciar pessoa física.
- US044 — Gerenciar pessoa jurídica.
- Vinculações de cadastros.
- Manual de padronização da PGA.
Protótipos
Seção intitulada “Protótipos”Validação
Seção intitulada “Validação”A fonte registra validação em reunião on-line entre 02/02/2026 e 04/02/2026.
Pendências da fonte
Seção intitulada “Pendências da fonte”- A identificação de cadastros duplicados ainda não foi definida (RNE001).
- A visualização referencia RNE002 para gerar o código, mas a seção de regras contém apenas RNE001 e um item sem conteúdo. A regra de geração não foi criada nesta conversão.
- O exemplo de código da listagem tem 11 dígitos, enquanto o da visualização tem 10. Confirmar o formato junto à regra de geração ausente.
- A tabela de vinculações está vazia. Confirmar quais entidades e informações devem ser listadas.
- A edição faz uma exceção para a seção de alertas, mas essa seção não consta no formulário ou na visualização. Confirmar seu conteúdo e comportamento.
- O CPF do funcionário referia-se ao campo Funcionário Autorizado, inexistente no formulário. A referência foi alinhada a Funcionário da Revendedora.
- O campo Zona aparecia duas vezes no formulário; foi representado uma única vez no componente de localização.
- A fonte fixa Minas Gerais na zona rural, mas não explicita a rejeição de CEPs urbanos de outros estados. O componente com estado fixo aplica essa restrição; confirmar o alcance territorial do cadastro.
- O telefone obrigatório dos contatos está marcado como somente leitura, com padrão vazio, sem indicar sua origem quando nenhum contato de proprietário é escolhido. Confirmar esse preenchimento.
- Capacidade de Alojamento da Espécie informa 12 dígitos, mas o exemplo usa 300; confirmar se o tamanho é máximo ou exato.
- A descrição de Grupo — Espécie mencionava exploração pecuária e o tipo de Situação era informado como Tipo. Foram adequados para a revendedora e para Texto, respectivamente.