LaboratórioRascunho
Eu, como usuário do sistema AgroDigital, quero buscar laboratório, listar laboratório, adicionar laboratório, visualizar laboratório, editar laboratório e listar vinculações para gerenciar laboratórios.
Identificador na fonte: US0V3. O código foi preservado no texto, mas não foi incluído nos metadados porque o sistema aceita apenas US seguido de números.
Histórico da fonte
Seção intitulada “Histórico da fonte”- v1.0 - 16/06/2026: Primeira versão da história.
História de usuário
Seção intitulada “História de usuário”Eu, como usuário do sistema, quero gerenciar laboratórios, para que eu possa permitir a gestão eficiente dessas informações.
1. Buscar laboratório
Seção intitulada “1. Buscar laboratório”Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Laboratório (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 | Exemplo | Valor padrão |
|---|---|---|---|---|---|
| Nome Comercial do Laboratório | Texto | Não | Tamanho = 255 caracteres | “Laboratório Agener” | Vazio |
| Proprietário | Seleção simples de entidade: proprietário | Não | Valores = pessoas físicas ou jurídicas cadastradas no sistema | “José Aarão Neto” | Vazio |
| Estado | Seleção simples | Não | Valores = lista de estados brasileiros | “Minas Gerais” | Vazio |
| Município | Seleção pesquisável | Não | Disponível quando o “Estado” for selecionado Valores = lista dos municípios do estado selecionado | “Lavras” | Vazio |
| Atuação | Seleção múltipla | Não | Valores = “Produção de insumos de diagnóstico”, “Produção de vacinas”, “Diagnóstico de doenças” | “Produção de insumos de diagnóstico” | Vazio |
| Situação | Seleção simples | Não | Valores = “Ativo”, “Inativo” | “Ativo” | Vazio |
E exibe as seguintes ações: (Ver AC001 - Ações das telas de busca)
2. Listar laboratório
Seção intitulada “2. Listar laboratório”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 | Tipo | Descrição | Exemplo |
|---|---|---|---|
| Nome | Texto | Exibe o nome do laboratório | “Laboratório Agener” |
| Proprietários | Texto | Exibe o CPF/CNPJ - Nome/Razão Social dos proprietários do laboratório | “555.009.956-40 - José Aarão Neto, 444.009.956-40 - Divino de Souza Sobrinho …” |
| Atuação | Texto | Exibe as atuações do laboratório | “Realiza diagnóstico de doenças”, “Realiza produção de vacinas” |
| Município - UF | Texto | Exibe o Município - UF do laboratório | “Lavras - MG” |
| Situação | Texto | Exibe a situação do cadastro | “Ativo” |
E exibe as seguintes ações: (Ver AC002 - Ações das telas de listagem)
3. Adicionar laboratório
Seção intitulada “3. Adicionar laboratório”Dado que estou na tela de cadastro
Então o sistema exibe um formulário, contendo os seguintes campos:
Informações Básicas
Seção intitulada “Informações Básicas”| Campo | Tipo | Obrigatório | Editável | Validações | Exemplo | Valor padrão |
|---|---|---|---|---|---|---|
| Nome Comercial do Laboratório | Texto | Sim | Sim | Tamanho = 255 caracteres | “Laboratório Augener” | Vazio |
| Atuação | Seleção múltipla | Sim | Sim | Valores = “Produção de insumos de diagnóstico”, “Produção de vacinas”, “Diagnóstico de doenças” | “Diagnóstico de doenças”, “Produção de vacinas” | Vazio |
(Disponível para cada valor selecionado em “Atuação”) (Uma ou mais)
Seção intitulada “(Disponível para cada valor selecionado em “Atuação”) (Uma ou mais)”| Campo | Tipo | Obrigatório | Editável | Validações | Exemplo | Valor padrão |
|---|---|---|---|---|---|---|
| Doença | Seleção múltipla de entidade: doença | Sim | Sim | [Quando o valor do campo “Atuação” = “Produção de insumos de diagnóstico”, “Diagnóstico de doenças”] Valores = doenças cadastradas no sistema [Quando o valor do campo “Atuação” for “Realiza produção de vacinas”] Valores = doenças vacináveis cadastradas no sistema | “Doença de Aujeszky” | Vazio |
Proprietários
Seção intitulada “Proprietários”| 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 |
Os campos do componente admitem edição (EDT = Sim), conforme a fonte.
Localização simples
Seção intitulada “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 do componente admitem edição (EDT = Sim), conforme a fonte.
Contatos com proprietários
Seção intitulada “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” |
| 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 |
Os campos do componente admitem edição (EDT = Sim), conforme a fonte.
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 campos do 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 laboratório
Seção intitulada “4. Visualizar laboratório”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:
Informações Básicas
Seção intitulada “Informações Básicas”| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
| Código do Laboratório | Texto | Exibe o código único gerado após o cadastro (ver RNE001) | “3123659848” |
Situação do Cadastro
Seção intitulada “Situação do Cadastro”| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
| Situação | Texto | Exibe a situação do cadastro | “Ativo” |
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)
E exibe as seguintes ações específicas:
| Ação | Descrição |
|---|---|
| Cadastro | Vai para a tela de visualização do cadastro |
| Vinculações | Vai para a aba de vinculações do cadastro |
5. Editar laboratório
Seção intitulada “5. Editar laboratório”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 do critério de aceitação 3 e 4
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)
6. Listar vinculações
Seção intitulada “6. Listar vinculações”Dado que estou na tela de visualização das vinculações
Então o sistema exibe as seguintes vinculações (Ver Vinculações de cadastros)
As vinculações necessárias serão discutidas com o cliente posteriormente.
Seção intitulada “As vinculações necessárias serão discutidas com o cliente posteriormente.”E exibe as seguintes ações: (Ver AC007 - Ações das telas de vinculações)
| Ação | Descrição |
|---|---|
| Cadastro | Vai para a tela de visualização do cadastro |
| Vinculações | Vai para a tela de vinculações do cadastro |
Regras de negócio específicas
Seção intitulada “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
Documentos vinculados
Seção intitulada “Documentos vinculados”Convenções da conversão
Seção intitulada “Convenções da conversão”As colunas Obrigatório e Editável correspondem a OBG e EDT da fonte. A edição posterior observa também as condições de somente leitura e de situação do cadastro. Campos, exemplos, padrões e referências recebidos foram preservados, sem criar valores ausentes.
Pendências da fonte
Seção intitulada “Pendências da fonte”- O identificador US0V3 não atende ao formato US seguido apenas de números. Confirmar o código oficial antes de indexá-lo.
- Atuação utiliza Produção de vacinas, mas a condição das doenças cita Realiza produção de vacinas. Confirmar a equivalência entre os rótulos.
- A edição permite todos os campos dos critérios 3 e 4, incluindo Código e Situação exibidos na visualização. Confirmar se o código gerado deve permanecer somente leitura.
- As vinculações estão expressamente pendentes de discussão com o cliente. Não foram presumidos campos ou tipos de vínculo.