====== [Atos de Pessoal] - 0 - Cadastro de Processo - Aposentadoria Civil ======

===== 1. Objetivo =====

Permitir o cadastramento inicial de um processo de Aposentadoria Civil, registrando:

  * Órgão/Entidade responsável;
  * Tipo do ato de pessoal;
  * CPF do servidor;
  * Nome do servidor;
  * Resumo da solicitação;

Ao final do preenchimento, o formulário cria uma nova instância de processo através da integração de abertura de processo.

===== 2. Campos ocultos =====

^Key^Campo^Tipo^Obrigatório^Valor Inicial^Observações|
|cdSetorAbertura|Código Setor de Abertura|Hidden|Não|Vazio|Utilizado na abertura do processo|
|cdClasse|Classe Processual|Hidden|Não|Vazio|Controle do BPM|
|flTipoProcesso|Tipo do Processo|Hidden|Não|Vazio|Controle interno|
|cdOrgao|Código Órgão|Hidden|Não|Vazio|Identificador do órgão|
|cdSetorInteressado|Código Setor Interessado|Hidden|Não|Vazio|Recebido da integração|
|cdSujeito|Código do Interessado|Hidden|Não|Vazio|Controle do interessado|
|resumo|Resumo padrão|Hidden|Não|"Solicitação de Aposentadoria Civil"|Composição da descrição do processo|
|sgSetorPadrao|Sigla Setor|Hidden|Não|Vazio|Obtida na integração|
|statusBuscaCpf_integracao|Status da busca CPF|Hidden|Não|Vazio|Controle da integração|
|sobreEscreveCpfServidor|CPF auxiliar|Hidden|Não|Vazio|Apoio nas integrações|
|cpfServico|CPF integração|Hidden|Não|Vazio|Apoio|
|saiuDoCampoCpf|Controle de alteração CPF|Hidden|Não|N|Controle [[:pres:gerti:gestao_de_ativos:siap_2:javascript|JavaScript]]|
|conf_qntDiasPrazo|Prazo Configurado|Hidden|Não|15|Prazo padrão|
|dataPrazo|Data Prazo|Hidden|Não|0|Controle BPM|
|contEnvio|Contador de envio|Hidden|Não|0|Evita duplo envio|

===== 3. Campos do formulário =====

==== 3.1 Órgão/Entidade ====

^Propriedade^Valor|
|Key|nomeOrgao|
|Tipo|Input|
|Colunas|12|
|Obrigatório|Sim|
|Somente Leitura|Sim|

**Descrição**

Campo preenchido automaticamente pela integração de usuário logado.

Representa o órgão ao qual pertence o usuário que está realizando a abertura do processo.

==== 3.2 Tipo do Ato de Pessoal ====

^Propriedade^Valor|
|Key|tpAtoPessoal|
|Tipo|Select|
|Colunas|12|
|Obrigatório|Sim|
|Valor Padrão|1|

**Opções**

^Valor (Select)^Descrição|
|1|Aposentadoria Civil|

==== 3.3 Número do Processo SEI ====

^Propriedade^Valor|
|Key|numSei|
|Tipo|Input Number|
|Colunas|12|
|Obrigatório|Não|
|Somente leitura|Sim|

**Observações**

  * Campo oculto no formulário.
  * Utilizado apenas internamente.
  * Participa da composição do resumo da solicitação.

==== 3.4 CPF do Servidor ====

^Propriedade^Valor|
|Key|cpfServidor|
|Tipo|Input CPF|
|Colunas|6|
|Obrigatório|Sim|
|Somente leitura|Não|

**Ajuda ao Usuário**

Favor informar o CPF com todos os números, inclusive com zeros à esquerda.

**Eventos**

^Evento^Função|
|Change|saiuDoCampoCpfSim|
|Change|limpaNomeServidor|
|Change|concatenaResumoCPF|

**Comportamento**

Ao preencher o CPF:

  - o sistema consulta automaticamente os dados do servidor;
  - recupera o nome do servidor;
  - atualiza o resumo da solicitação.

==== 3.5 Nome do Servidor ====

^Propriedade^Valor|
|Key|nomeServidor|
|Tipo|Input|
|Colunas|6|
|Obrigatório|Sim|
|Somente leitura|Não|

**Ajuda**

Informe o nome completo e sem abreviaturas. Caso tenha havido alteração de nome em virtude de casamento ou decisão judicial, informe o nome atualizado.

**Eventos**

^Evento^Função|
|Change|saiuDoCampoCpfNao|
|Change|validaNomeServidor|

==== 3.6 Resumo da Solicitação ====

^Propriedade^Valor|
|Key|resumoSolicitacao|
|Tipo|[[:pres:gerti:gestao_de_ativos:siap_2:textarea|TextArea]]|
|Colunas|12|
|Linhas|4|
|Obrigatório|Sim|
|Somente leitura|Sim|

**Formação automática**

O sistema monta o resumo com:

Nome Servidor + CPF + Número SEI + Tipo de Processo

Exemplo:

JOÃO DA SILVA, CPF:12345678900, SEI:20240000123456 - Solicitação de Aposentadoria Civil

===== 4. Integrações =====

^Nome^Serviço^Operação^Quando executa^Objetivo^Principais dados enviados^Principais retorno^Mensagem de falha|
|Consulta Usuário Logado|cpa-core-backend|POST /s/integracao-fd/consulta-usuario-logado|Evento Load|Recuperar: \\ -órgão do usuário; \\ -setor padrão; \\ -dados organizacionais necessários para a abertura.|Automaticamente pega o id do user logado| \\  \\ **Origem > Destino** \\  \\ nmSetorPadrao>nomeOrgao \\ sgSetorPadrao>sgSetorPadrao \\ cdSetorPadrao>cdSetorInteressado| |
|Consulta Dados do Servidor|Serviços TCE Atos de Pessoal|GET /servidor/[[:pres:gerti:gestao_de_ativos:siap_2:consultadadosservidor|ConsultaDadosServidor]]?cpf={cpf}|Ao alterar CPF do servidor|Localizar automaticamente o servidor.|CPF do servidor| \\ **Origem > Destino** \\  \\ NOME_SERVIDOR>nomeServidor|CPF do servidor não encontrado|
|Cadastrar Processo|cpa-core-backend|POST /s/processo/novo-processo|Submit|Criar efetivamente a instância BPM do processo de aposentadoria civil.|cdSetorAbertura \\ cdClasse \\ cdSetorInteressado \\ interessados \\ cpfServidor \\ nomeServidor \\ tpAtoPessoal \\ resumoSolicitacao nomeOrgao| | |

===== 5. Botões =====

==== Botão: Cadastrar ====

^Propriedade^Valor|
|Tipo|Submit|
|Função|enviaDados|
|Estilo|btn-primary|

**Ações Executadas**

  - valida os dados;
  - impede múltiplos envios;
  - dispara integração de criação do processo;
  - conclui o cadastro.

==== Botão: Processando... ====

^Propriedade^Valor|
|Tipo|Button|
|Somente leitura|Sim|
|Exibição|contEnvio = 1|

**Objetivo**

Substituir temporariamente o botão de cadastro durante o envio. ( Isto se fez necessário devido o usuário de alguma forma estava conseguindo envia dois processos com mesmo cpf, logo ocasionando chamado para arquivamento de um dos processos )

===== 6. Funções JavaScript Identificadas =====

^Função^Objetivo|
|concatenaResumoCPF|Gera resumo automático|
|validaNomeServidor|Valida preenchimento do nome|
|exibeAlerta|Exibe mensagens|
|escondeAlerta|Oculta alertas|
|enviaDados|Realiza envio|
|validaMinimoCaracteres|Valida mínimo 2 caracteres|
|validaCaracteresEspeciais|Bloqueia caracteres inválidos|
|limpaNomeServidor|Limpa nome após troca do CPF|
|saiuDoCampoCpfSim|Marca alteração do CPF|
|saiuDoCampoCpfNao|Remove marcação|
|limpaResumo|Limpa resumo|

===== 7. Principais Regras de Negócio =====

**RN001 - CPF Obrigatório**

O processo não pode ser criado sem o CPF do servidor.

**RN002 - Nome Obrigatório**

O nome do servidor é obrigatório para abertura do processo.

**RN003 - Nome Deve Possuir no Mínimo 2 Caracteres**

validaMinimoCaracteres()

Mensagem: O nome deve conter no mínimo 2 caracteres.

**RN004 - Não Permitir Caracteres Especiais**

Expressão utilizada: /^[a-záàâãéèêíïóôõöúçñ ]+$/i

Mensagem: O nome não deve conter caracteres especiais.

**RN005 - Geração Automática do Resumo**

Sempre que:

  * CPF for alterado;
  * Nome for alterado;
  * Número SEI for alterado;

o resumo do processo é recalculado automaticamente.

**RN006 - Consulta Automática do Servidor**

Ao informar o CPF, o sistema consulta automaticamente os dados cadastrais do servidor.

**RN007 - Prevenção de Duplo Envio**

contEnvio

===== 8. Fluxo Operacional =====

{{:pres:gerti:gestao_de_ativos:siap_2:fluxo_operacional.png?305x658}}

===== 9. Imagem do formulário =====

{{:pres:gerti:gestao_de_ativos:siap_2:formu_de_cadastrato.png?989x543}}

===== 10. Resumo Executivo =====

A tarefa[Atos de Pessoal] - 0 - Cadastro de Processo - Aposentadoria Civil é o formulário inicial do processo SIAP de aposentadoria civil. Ela identifica o servidor por CPF, recupera automaticamente informações cadastrais, monta um resumo da solicitação e cria a instância do processo BPM através da integração novo-processo do backend corporativo. O formulário possui validação de nome, prevenção contra envios duplicados, preenchimento automático do órgão do usuário logado e consulta automática do cadastro funcional do servidor.

===== 11. Vídeo de apresentação =====

{{:pres:gerti:gestao_de_ativos:siap_2:cadastro_processo.mp4|:pres:gerti:gestao_de_ativos:siap_2:cadastro_processo.mp4}}

Voltar para o [[:pres:gerti:gestao_de_ativos:siap_2:catalago_formularios|Catálago de formulários]]