Profissional de serviço oficialPronto

Eu, como usuário do sistema AgroDigital, quero buscar profissional de serviço oficial, listar profissionais de serviço oficial, cadastrar profissional de serviço oficial, visualizar profissional de serviço oficial e editar profissional de serviço oficial para gerenciar profissionais de serviço oficial.

1. Buscar profissional de serviço oficial

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Profissional, 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
Nome ou CPF	Texto	Não	Alfanumérico, máximo de 255 caracteres.	Josephina Arantes	Vazio
Esfera do Serviço Oficial	Texto	Não	Valores = Municipal, Estadual, Federal.	Estadual	Vazio
Unidade Administrativa	Seleção pesquisável	Sim	Unidades administrativas cadastradas (US036). Pesquisa por nome.	Coordenadoria Regional de Belo Horizonte	Vazio
Situação	Seleção	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 obrigatoriedade da unidade administrativa segue a tabela da fonte; ver as pendências ao final.

Ação	Comportamento
Adicionar Novo	Abre o cadastro de profissional de serviço oficial.
Pesquisar	Realiza a busca utilizando o campo de busca e os filtros.
Inicial	Retorna à tela inicial para usuários autenticados.

2. Listar profissionais de serviço oficial

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
Nome	Texto	Sim	Nome do profissional.	Josephina Arantes
CPF	Texto	Sim	CPF do profissional.	444.009.956-40
Esfera do Serviço Oficial	Texto	Sim	Esfera do serviço oficial do profissional.	Estadual
Unidade Administrativa	Texto	Sim	Unidade administrativa de vinculação do profissional.	Coordenadoria Regional de Belo Horizonte
Situação	Texto	Sim	Situação do cadastro.	Ativo

Para cada resultado, o sistema exibe Visualizar e Editar, que abrem as respectivas telas do profissional selecionado.

3. Cadastrar profissional de serviço oficial

Dado que estou na tela de cadastro
Então o sistema exibe o formulário descrito a seguir, indicando os campos obrigatórios com asterisco.

Informações básicas

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Pessoa Física	Seleção pesquisável	Sim	Pessoas físicas cadastradas no sistema (US042). Pesquisa por nome ou CPF.	José Aarão Neto	Vazio
CPF	Texto	Sim	Somente leitura. Disponível quando Pessoa Física estiver preenchido. Corresponde ao cadastro selecionado.	555.009.956-40	Vazio

Serviço oficial

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Esfera do Serviço Oficial	Texto	Sim	Valores = Municipal, Estadual, Federal.	Estadual	Vazio
MASP	Texto	Sim	Disponível se Esfera do Serviço Oficial = Estadual. Numérico. Máscara XXXXXXX-X, preenchida da direita para a esquerda, completando com zeros à esquerda.	1017185-8	Vazio

Texto de ajuda do MASP na fonte: “Módulo de Autorização de Serviços Profissionais. Gerencia as habilitações, extensões e autorizações do profissional habilitado.” A descrição foi preservada para revisão, conforme as pendências.

Unidade administrativa de vinculação

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Unidade Administrativa	Seleção pesquisável	Sim	Unidades administrativas cadastradas no sistema (US036). Pesquisa por nome.	Coordenadoria Regional de Belo Horizonte	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

Admite zero ou mais anexos. Para cada item, o documento é obrigatório, nos formatos PNG, JPG ou PDF, com tamanho máximo de 50 MB; a descrição é opcional, com até 255 caracteres. A observação é opcional, com até 1500 caracteres. A ajuda da observação é “Informações adicionais pertinentes ao cadastro”.

Ações do cadastro

Ação	Comportamento
Adicionar	Valida os dados informados e salva o cadastro.
Todos os profissionais de serviço oficial	Retorna à busca.
Ver item	Abre a visualização de cada cadastro relacionado informado no formulário.
Adicionar/Remover item	Adiciona ou remove itens das seções que admitem múltiplas instâncias.
Baixar documento	Baixa o documento de cada anexo informado.

Quando realizo a ação Adicionar
E todos os campos e regras de negócio são validados corretamente
Então o sistema exibe uma mensagem de sucesso e as ações Voltar, que retorna à busca, e Visualizar, que abre o profissional cadastrado.

4. Visualizar profissional de serviço oficial

Dado que estou na tela de visualização
Então o sistema exibe todos os campos do cadastro preenchidos e como somente leitura, além dos campos abaixo.

Campo	Tipo	Descrição	Exemplo
Situação	Texto	Situação do cadastro.	Ativo
Usuário	Texto	Usuário que efetuou a última alteração no cadastro.	Lucas Pedro Conte
Data e Hora da Última Modificação	Data	Data e hora da última alteração.	14/04/2012 07:29

Ação	Comportamento
Editar	Abre a edição do profissional.
Todos os profissionais de serviço oficial	Retorna à busca.
Ver item	Abre a visualização de cada cadastro relacionado.
Baixar documento	Baixa o documento de cada anexo informado.

5. Editar profissional de serviço oficial

Dado que estou na tela de edição
Então o sistema exibe os campos do cadastro como editáveis, exceto a seção Informações básicas
E exibe os campos adicionais da visualização como somente leitura.

Ação	Comportamento
Salvar	Abre a confirmação das edições.
Visualizar profissional de serviço oficial	Retorna à visualização.
Ver item	Abre a visualização de cada cadastro relacionado.
Adicionar/Remover item	Adiciona ou remove itens das seções que admitem múltiplas instâncias.
Baixar documento	Baixa o documento de cada anexo informado.
Ativar/Inativar	Alterna a situação entre Ativo e Inativo, conforme a situação atual e a RN009.

Na confirmação das edições, o sistema exibe Cancelar, que retorna à edição, e Salvar, que valida os dados, salva as alterações e abre a visualização.

Critérios de aceitação comuns

Aplicam-se os critérios comuns:

Código	Critério	Origem
CA001	Salvar cadastro de uma entidade.	US063
CA003	Notificar erro ao usuário devido a falha técnica.	US063 e US064
CA009	Busca sem resultados.	US064
CA010	Uso incorreto de filtros de busca.	US064
CA011	Indicação de filtros de busca aplicados.	US064

Regras de negócio específicas

RNE001 — Unicidade por CPF

O cadastro do profissional de serviço oficial deve ser único no sistema, utilizando o CPF para garantir essa unicidade.

RNE002 — Código do cadastro

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

Regras de negócio comuns

Aplicam-se as regras comuns, com os códigos utilizados pelas fontes:

• RN003 — Controle de alterações em uma entidade (US063).
• RN007 — Permissões de acesso (US063 e US064).
• RN009 — Situação do cadastro de uma entidade sem opção de suspensão (US063).

Histórias e referências relacionadas

• Unidade administrativa — US036 e US037. A US063 cita US036 no formulário, mas relaciona US032 — Gerenciar unidade administrativa. A US064 relaciona US036 — Gerenciar unidade administrativa.
• US042 — Gerenciar pessoa física.
• US063 — Gerenciar profissional de serviço oficial.
• US064 — Buscar profissional de serviço oficial.
• Requisitos não funcionais e técnicos.
• Planilha de módulos e permissões do sistema — anexo da US063.

Protótipos

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

Validação

• US063: validada em reunião presencial entre 03/11/2025 e 05/11/2025, na Cidade Administrativa, Belo Horizonte/MG, e em reunião online em 28/11/2025.
• US064: validada em reunião online em 28/11/2025.

Histórico da fonte

História	Versão	Data	Descrição
US063	v1.0	10/11/2025	Primeira versão da história.
US064	v1.0	28/11/2025	Primeira versão da história.

Pendências da fonte

• A US064 marca o filtro Unidade Administrativa como obrigatório, mas admite pesquisa por nome/CPF e/ou qualquer filtro. Confirmar se a unidade é sempre exigida.
• A US063 referencia unidade administrativa como US036 no formulário e US032 nas histórias relacionadas. A US064 utiliza US036. As referências originais foram preservadas acima.
• O texto de ajuda do MASP descreve um módulo de autorização, embora o campo seja um identificador numérico com máscara. Confirmar a descrição adequada.
• Esfera do Serviço Oficial é tipada como Texto nas duas fontes, embora possua valores predefinidos. Confirmar o controle de entrada.
• A RNE002 exige um código único, inteiro e incremental, mas as fontes não definem tamanho, valor inicial nem onde exibi-lo.
• A descrição do fluxo de edição apresenta a confirmação como posterior ao salvamento; as ações indicam que a gravação ocorre ao confirmar. O fluxo acima segue o comportamento descrito nas ações.