Local de realização de exameRascunho

Eu, como usuário do sistema AgroDigital, quero buscar local de realização de exame, listar local de realização de exame, adicionar local de realização de exame, visualizar local de realização de exame e editar local de realização de exame para gerenciar locais de realização de exame.

Histórico da fonte

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

História de usuário

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

1. Buscar local de realização de exame

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Local de Realização de Exame (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
Código	Texto	Não	Tamanho = 10 caracteres
Pessoa Jurídica	Seleção simples de entidade: pessoa jurídica	Não	Valores = pessoas jurídicas cadastradas
Médico Veterinário	Seleção simples de entidade: profissional da área animal	Não	Valores = profissionais da área animal que são médicos veterinários
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 local de realização de exame

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	Observação
Código	Exibe o código do local de realização de exame
Pessoa Jurídica	Exibe o CNPJ - Razão Social, se houver
Médicos Veterinários	Exibe o CPF - Nome dos médicos veterinários
Situação	Exibe a situação do cadastro

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

3. Adicionar local de realização de exame

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
Código	Texto	Sim	Não	Disponível após o cadastro Tamanho = 10 caracteres Formato = RNE001
É um local comercial?	Seleção simples	Sim	Sim	Valores = “Sim”, “Não”
Pessoa Jurídica	Seleção simples de entidade: pessoa jurídica	Sim	Sim	Disponível se “É um local comercial?” for definido como “Sim” Valores = pessoas jurídicas cadastradas

Profissionais Habilitados (Um a Cinco)

Campo	Tipo	Obrigatório	Editável	Validações
Médico Veterinário	Seleção múltipla de entidade: profissional da área animal	Sim	Sim	Valores = profissionais da área animal que são médicos veterinários O médico veterinário selecionado não pode estar associado a outro local de realização de exame Ao atingir o limite de 5 médicos veterinários, o sistema deve impedir a inclusão de outro profissional e exibir uma mensagem informando que, para adicionar um novo, é necessário remover um dos profissionais cadastrados.

Localização com estabelecimento

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Estabelecimento Agroindustrial Localizado em um Estabelecimento Agropecuário Cadastrado no IMA?	Seleção simples	Sim	Valores pré-definidos: “Sim”, “Não”	`“Não”`	“Não”
Estabelecimento Agropecuário (“Nome do Estabelecimento Agropecuário”)	Seleção pesquisável	Sim	Disponível se o campo ”Estabelecimento Agroindustrial Localizado em um Estabelecimento Agropecuário Cadastrado no IMA?” for definido como “Sim” Valores pré-definidos: estabelecimentos agropecuários cadastrados no sistema (ver US050) Deve ser possível buscar por “Nome” e “Código” do estabelecimento agropecuário e ”Nome”/”Razão Social”, “Município” e ”CPF”/“CNPJ” dos proprietários do estabelecimento agropecuário	`“Fazenda Rio Preto”`	Vazio
Código do Estabelecimento Agropecuário	Seleção simples	Sim	Disponível se o campo ”Estabelecimento Agroindustrial Localizado em um Estabelecimento Agropecuário Cadastrado no IMA?” for definido como “Sim” Somente leitura Disponível quando o campo “Estabelecimento Agropecuário” for preenchido Deve corresponder ao cadastro informado no campo “Estabelecimento Agropecuário”	`“34523423567”`	Vazio
Zona	Seleção simples	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Endereço (Somente leitura se o campo “Estabelecimento Agroindustrial Localizado em um Estabelecimento Agropecuário Cadastrado no IMA?” for definido como “Sim”. Nesse caso, deve corresponder ao endereço do Estabelecimento Agropecuário informado Valores pré-definidos: “Rural”, “Urbana”	`“Rural”`	“Rural”
Estado	Seleção simples	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Rural” Somente leitura Valores pré-definidos: lista de todos os estados brasileiros Somente leitura. Valor = Minas Gerais.	`Minas Gerais`	Minas Gerais
Município	Seleção pesquisável	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Rural” Valores pré-definidos: lista de todos os municípios brasileiros correspondentes ao estado selecionado	`“Lavras”`	Vazio
Endereço — Nome da estrada e o quilômetro de referência.	Texto	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Rural” Alfanumérico, máximo 255 caracteres	`“Estrada de chão no Km 12”`	Vazio
Localidade	Seleção pesquisável	Não	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Rural” Valores pré-definidos: localidades cadastradas no sistema (ver US005) Deve ser pré-filtrado de acordo com o valor informado em “Município”	`“Vila dos Técnicos”`	Vazio
Distrito	Seleção pesquisável	Não	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Rural” Valores pré-definidos: distritos cadastrados no sistema (ver US005) Deve ser pré-filtrado de acordo com o valor informado em “Município”	`“Cachoeira do Vale”`	Vazio
CEP	Texto	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Urbana” Numérico, 8 dígitos, máscara XXXXX-XXX	`“37060-400”`	Vazio
Estado	Texto	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Urbana” Consulta API de CEP Somente leitura Disponível quando o campo “CEP” for preenchido	`“Minas Gerais”`	Valor obtido pela API de CEP
Município	Texto	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Urbana” Consulta API de CEP Somente leitura Disponível quando o campo “CEP” for preenchido	`“Timóteo”`	Valor obtido pela API de CEP
Bairro	Texto	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Urbana” Consulta API de CEP Alfanumérico, máximo 255 caracteres	`“Centro”`	Valor obtido pela API de CEP, quando disponível
Endereço	Texto	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Urbana” Consulta API de CEP Alfanumérico, máximo 255 caracteres	`“Avenida JK”`	Valor obtido pela API de CEP, quando disponível
Número	Texto	Sim	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Urbana” Alfanumérico, máximo 10 caracteres	`10`	Vazio
Complemento	Texto	Não	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Urbana” Alfanumérico, máximo 255 caracteres	`“Apto 02”`	Vazio
Distrito	Seleção pesquisável	Não	Somente leitura se o estabelecimento agroindustrial estiver localizado em um estabelecimento agropecuário cadastrado no IMA; nesse caso, corresponde ao endereço do estabelecimento agropecuário selecionado. Disponível se campo “Zona” for definido como “Urbana” Valores pré-definidos: distritos cadastrados no sistema (ver US005) Deve ser pré -filtrado de acordo com o valor informado em “Município”	`“Cachoeira do Vale”`	Vazio
Possui a Mesma Geolocalização do Estabelecimento Agropecuário?	Seleção simples	Sim	Disponível se o campo “Estabelecimento Agroindustrial Localizado em um Estabelecimento Agropecuário Cadastrado no IMA?” for definido como “Sim” Valores pré-definidos: “Sim”, “Não”	`“Sim”`	“Não”
Formato	Seleção simples	Sim	Somente leitura se o campo “Possui a Mesma Geolocalização do Estabelecimento Agropecuário?” for definido como “Sim”. Nesse caso, deve corresponder a geolocalização do Estabelecimento Agropecuário informado Valores pré definidos: “DMS (graus, minutos, segundos), DD (decimal)”	`“DMS (graus, minutos, segundos)”`	“DMS (graus, minutos, segundos)”
Latitude	Decimal	Sim	Somente leitura se o campo “Possui a Mesma Geolocalização do Estabelecimento Agropecuário?” for definido como “Sim”. Nesse caso, deve corresponder a geolocalização do Estabelecimento Agropecuário informado Pode ser informada manualmente ou selecionada em um mapa, com consulta à API do Google Maps Deve possuir uma máscara de acordo com o formato informado (ver regra de negócio comum RN010) Deve ser pré estimada de acordo com as informações de endereço informadas	`DMS: 19°09'56.979800000000"S DD: -19.165827719338893`	Vazio
Longitude	Decimal	Sim	Somente leitura se o campo “Possui a Mesma Geolocalização do Estabelecimento Agropecuário?” for definido como “Sim”. Nesse caso, deve corresponder a geolocalização do Estabelecimento Agropecuário informado Pode ser informada manualmente ou selecionada em um mapa, com consulta à API do Google Maps Deve possuir uma máscara de acordo com o formato informado (ver regra de negócio comum RN010) Deve ser pré estimada de acordo com as informações de endereço informadas	`DMS: 44°21'46.336500000000"W DD: -44.362871253967285`	Vazio

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

Situação (Disponível após o cadastro)

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 AC003 - Ações das telas de cadastro e AC006 - Ações de interação com formulários)

4. Visualizar local de realização de exame

Dado que estou na tela de visualização
Então o sistema exibe todos os campos do formulário descrito no critério de aceitação 3 como somente leitura, com seus valores já preenchidos
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 local de realização de exame

Dado que estou na tela de edição
Então o sistema exibe todos os campos descritos nos critérios de aceitação 3, com seus valores já preenchidos
E permite editar todos os campos editáveis (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

RNE001 - Após o cadastro, deve-se gerar um código único, de 10 dígitos. O código será composto do código IBGE da Unidade Federada, de 2 dígitos, seguido de um número sequencial de 8 dígitos, conforme a RN09 do Manual de padronização da PGA
RNE002 - Um médico veterinário pode estar vinculado a apenas um local de exame. Para adicioná-lo em outro local, é necessário removê-lo do atual primeiro.

Documentos vinculados

Convenções e ações comuns

As colunas Obrigatório e Editável correspondem a OBG e EDT da fonte. Editável = Não restringe a alteração posterior ao cadastro; não impede a informação inicial dos campos. As indicações explícitas de somente leitura e as condições de exibição foram preservadas.

As ações comuns AC001 a AC006 e a regra de permissões RNC007 são aplicadas nos pontos citados pela fonte. Não foram criados exemplos ou valores padrão ausentes do arquivo recebido.

Pendências da fonte

A fonte não informa código US. Nenhum identificador foi criado para esta conversão.
A regra limita cada médico veterinário a um único local, mas não esclarece se locais inativos continuam impedindo vínculos. Confirmar o escopo dessa restrição.
A referência à RN09 do Manual de padronização da PGA foi preservada. O documento externo não foi consultado nem alterado nesta conversão.