Profissional da área vegetalPronto

Eu, como usuário do sistema AgroDigital, quero buscar profissional da área vegetal, listar profissionais da área vegetal, cadastrar profissional da área vegetal, visualizar profissional da área vegetal e editar profissional da área vegetal para gerenciar profissionais da área vegetal.

Histórias de origem: US064 — Gerenciar profissional da área vegetal e US065 — Buscar profissional da área vegetal. Os códigos estão pendentes de revisão e não foram incluídos no índice de identificadores, pois já pertencem a outras páginas do acervo.

1. Buscar profissional da área vegetal

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
Formação Profissional	Seleção	Não	Valores = `Engenheiro Agrônomo`, `Engenheiro Florestal`.	`Engenheiro Agrônomo`	Vazio
CREA	Texto	Não	Alfanumérico, máximo de 30 caracteres.	`506779200`	Vazio
Habilitações Profissionais	Seleção	Não	Valores = `Habilitado para emissão de PTV`, `Habilitado para emissão de CFO/CFOC`.	`Habilitado para emissão de CFO/CFOC`	Vazio
Número de Habilitação	Texto	Não	Numérico, 8 caracteres.	`31250034`	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ção	Comportamento
Adicionar Novo	Abre o cadastro de profissional da área vegetal.
Pesquisar	Realiza a busca utilizando o campo de busca e os filtros.
Inicial	Retorna à tela inicial para usuários autenticados.

2. Listar profissionais da área vegetal

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`
Formação Profissional	Texto	Sim	Formação do profissional.	`Engenheiro Agrônomo`
CREA	Texto	Sim	CREA do profissional.	`9913`
Habilitação Profissional	Texto	Sim	Habilitação profissional.	`Habilitado para emissão de PTV`
Número da Habilitação	Texto	Sim	Número da habilitação do profissional.	`31250001`
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 da área vegetal

Dado que estou na tela de cadastro
Então o sistema exibe o formulário 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. Corresponde à pessoa física selecionada. A condição de exibição da fonte menciona Proprietário, campo ausente deste formulário; ver pendências.	`555.009.956-40`	Vazio

Serviço oficial

Disponível quando CPF estiver preenchido. O sistema verifica se o CPF possui cadastro de profissional de serviço oficial.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Serviço Oficial?	Texto	Não	Somente leitura. Valores = `Sim`, `Não`, conforme a existência de cadastro de profissional de serviço oficial para o CPF informado.	`Não`	Vazio
Esfera do Serviço Oficial	Texto	Não	Somente leitura. Disponível se Serviço Oficial? = `Sim`. Corresponde ao cadastro de serviço oficial vinculado ao CPF.	`Estadual`	Vazio
MASP	Texto	Sim	Somente leitura. Disponível se Serviço Oficial? = `Sim` e Esfera do Serviço Oficial = `Estadual`. Corresponde ao cadastro de serviço oficial vinculado ao CPF.	`10455301`	Vazio

Deve ser possível visualizar o cadastro do profissional de serviço oficial correspondente.

A fonte apresenta a ajuda do MASP como “Módulo de Autorização de Serviços Profissionais. Gerencia as habilitações, extensões e autorizações do profissional habilitado.” Esse texto está pendente de confirmação.

Informações profissionais

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Formação Profissional	Seleção	Sim	Valores = `Engenheiro Agrônomo`, `Engenheiro Florestal`.	`Engenheiro Agrônomo`	Vazio
CREA	Texto	Sim	Alfanumérico, máximo de 30 caracteres.	`506779200`	Vazio
Coordenadoria Regional de Vinculação	Seleção	Sim	Coordenadorias regionais cadastradas no sistema (US036).	`Coordenadoria Regional de Oliveira`	Vazio

Emissão de PTV

Disponível se a pessoa física informada possuir cadastro de profissional de serviço oficial.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Habilitado para Emissão de PTV?	Seleção	Sim	Valores = `Sim`, `Não`.	`Não`	Vazio
Extensão de Habilitação?	Seleção	Sim	Disponível se Habilitado para Emissão de PTV? = `Sim`. Valores = `Sim`, `Não`.	`Sim`	`Não`

A extensão possibilita a atuação em diferentes unidades federativas sem a renovação do curso de habilitação.

Estabelecimentos agropecuários de atuação

Zero ou mais itens, apresentados na fonte após os campos de habilitação para PTV. Ver pendências sobre a condição de exibição desta seção.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Estabelecimento Agropecuário	Seleção	Sim	Estabelecimentos cadastrados (US050). Pesquisa por nome ou código do estabelecimento e por nome ou CPF dos proprietários.	`Fazenda Rio Preto`	Vazio
Código do Estabelecimento Agropecuário	Texto	Sim	Somente leitura. Disponível quando Estabelecimento Agropecuário estiver preenchido.	`34523423567`	Vazio

Emissão de CFO/CFOC

Disponível se a pessoa física informada não possuir cadastro de profissional de serviço oficial.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Habilitado para a Emissão de CFO/CFOC?	Seleção	Sim	Valores = `Sim`, `Não`.	`Não`	Vazio
Extensão de Habilitação	Seleção	Sim	Disponível se Habilitado para a Emissão de CFO/CFOC? = `Sim`. Valores = `Sim`, `Não`.	`Sim`	`Não`

A extensão possibilita a atuação em diferentes unidades federativas sem a renovação do curso de habilitação.

Habilitações para pragas

Zero ou mais itens. Identifica as pragas para as quais o profissional possui habilitação, conforme os cursos concluídos. A fonte apresenta esta seção após os campos de habilitação para CFO/CFOC; ver pendências sobre sua condição de exibição.

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Praga	Seleção pesquisável	Sim	Pragas cadastradas (US032). Pesquisa por nome científico ou nome popular.	`Cerodirphia rubripes`	Vazio
Nome Popular	Texto	Sim	Somente leitura. Disponível quando Praga estiver preenchido. Corresponde à praga selecionada.	`Lagarta-Verde`	Valor correspondente à praga informada
Data do Curso de Habilitação	Data	Sim	Numérico, 8 dígitos, máscara `MM/DD/AAAA`. Não pode ser futura.	`05/08/2025`	Vazio
Data de Vencimento da Habilitação	Data	Sim	Somente leitura. Numérico, 8 dígitos, máscara `MM/DD/AAAA`. A ajuda considera 5 anos a partir da data do curso; a RNE004 utiliza a data do cadastro. Ver pendências.	`05/08/2030`	Vazio
Observação	Texto	Não	Alfanumérico, máximo de 1500 caracteres.	`Renovação de habilitação`	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, cada um com documento obrigatório nos formatos PNG, JPG ou PDF, de até 50 MB, e descrição opcional de até 255 caracteres. O sistema exibe o nome do arquivo anexado. A observação geral é opcional e admite até 1500 caracteres; sua ajuda é “Informações adicionais pertinentes ao cadastro”.

Ações do cadastro

Ação	Comportamento
Adicionar	Valida os dados e salva o cadastro.
Todos os profissionais da área vegetal	Retorna à busca.
Ver item	Abre a visualização de cada cadastro relacionado informado.
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 da área vegetal

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 seguintes campos.

Campo	Tipo	Descrição	Exemplo
Situação	Texto	Situação do cadastro.	`Ativo`
Número de Habilitação — Emissão de PTV	Texto	Número gerado pelo sistema conforme a RNE003. A fonte repete este campo e a seção PTV duas vezes; ver pendências.	`31256464`
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.
Ver item	Abre a visualização de cada cadastro relacionado.
Baixar documento	Baixa o documento de cada anexo.
Todos os profissionais da área vegetal	Retorna à busca.

5. Editar profissional da área vegetal

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

Os campos derivados identificados como somente leitura no formulário mantêm essa restrição.

Ação	Comportamento
Salvar	Abre a confirmação das edições.
Visualizar profissional da área vegetal	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.
Ativar/Inativar	Alterna a situação entre `Ativo` e `Inativo`, conforme a situação atual e as regras comuns.

Na confirmação, 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 referenciados pelas fontes:

CA001 — Salvar cadastro de uma entidade (US064).
CA003 — Notificar erro ao usuário devido a falha técnica (US064 e US065).
CA009 — Busca sem resultados (US065).
CA010 — Uso incorreto de filtros de busca (US065).
CA011 — Indicação de filtros de busca aplicados (US065).

Regras de negócio específicas

RNE001 — Unicidade por CPF

O cadastro deve ser único no sistema, utilizando o CPF para garantir essa unicidade.

RNE002 — Código do cadastro

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

RNE003 — Número de habilitação

O sistema gera automaticamente um número de 8 dígitos, composto pelo código do estado (2 dígitos), ano (2 dígitos) e número sequencial (4 dígitos). Para um profissional habilitado pelo IMA em 2025, o exemplo é 31 (MG) + 25 (2025) + 0001 = 31250001.

RNE004 — Vencimento da habilitação para praga

A regra da fonte determina que, após o cadastro, o sistema calcule automaticamente o vencimento com a data atual acrescida de 5 anos. Exemplo: cadastro em 05/10/2025, vencimento em 05/10/2030. Essa base de cálculo diverge da ajuda do formulário, que utiliza a data do curso.

O profissional recebe notificações por e-mail e pelo sistema de notificações do SIDAGRO (US019), informando a proximidade do vencimento, o nome científico da praga, o nome popular e a data de vencimento.

As notificações são enviadas com antecedência de 30, 7 e 1 dia, ou até que o cadastro seja atualizado com nova data de vencimento.

Quando o prazo expira, o sistema considera a habilitação Vencida e gera um alerta sobre o vencimento. A habilitação permanece nessa condição até sua renovação pelo profissional.

RNE005 — Itens com múltiplas instâncias

Item	Campos em conjunto definidos na regra da fonte
Estabelecimento Agropecuário	Estabelecimento Agropecuário e Código do Estabelecimento Agropecuário.
Habilitação para praga	Praga, Nome Popular, Data do Curso e Observação.
Anexo	Documento e Descrição.

A tabela do formulário também inclui Data de Vencimento da Habilitação na seção repetível de habilitações para pragas.

Regras de negócio comuns

Os códigos e descrições abaixo reproduzem as referências das fontes:

RN003 — Controle de alterações em uma entidade (US064).
RN007 — Permissões de acesso (US064 e US065).
RN009 — Situação do cadastro de uma entidade com opção de suspensão (US064).
RN010 — Coordenadas geográficas no componente de endereços (US064).

Pendências da fonte

US064 e US065 também identificam outras histórias no acervo: busca de profissional de serviço oficial e gerenciamento de estabelecimento agroindustrial POV, respectivamente. Os códigos recebidos foram preservados no conteúdo e no histórico, mas omitidos dos metadados de indexação porque o sistema exige códigos únicos. Confirmar a numeração oficial para permitir a indexação por código.
O CPF referencia o preenchimento de Proprietário, campo inexistente no formulário. Confirmar se a condição correta é o preenchimento de Pessoa Física.
A ajuda do MASP descreve um módulo, embora o campo seja apresentado como identificador. Confirmar a descrição.
O formulário calcula o vencimento da habilitação a partir da data do curso; a regra específica utiliza a data atual no cadastro. Confirmar qual data deve orientar o cálculo e a renovação.
A visualização repete duas vezes Emissão de PTV / Número de Habilitação. A repetição idêntica foi consolidada em uma linha; confirmar se a segunda ocorrência deveria tratar de CFO/CFOC e quando cada número é exibido.
A regra do número de habilitação não esclarece se há números distintos para PTV e CFO/CFOC, o escopo da sequência nem sua reinicialização anual. A relação com o código incremental da RNE002 também não é definida.
Confirmar se os estabelecimentos de atuação dependem de habilitação para PTV = Sim e se as habilitações para pragas dependem de habilitação para CFO/CFOC = Sim; a fonte apresenta essas seções em sequência sem explicitar o alcance das condições.
A RN009 menciona suspensão, mas a busca e as ações do formulário só tratam de Ativo e Inativo. Confirmar as situações permitidas e as ações correspondentes.
A RN010 e os anexos de APIs de município e CEP são referenciados, mas não há componente de endereço neste formulário. Confirmar sua aplicabilidade.
A lista de campos agrupados por habilitação para praga na regra específica omite a data de vencimento, embora ela conste no formulário.
A descrição da confirmação de edição sugere salvamento anterior à confirmação, enquanto a ação de confirmação valida e salva. O fluxo acima segue as ações descritas.