====== Mapa do tempo ======

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

O objetivo funcional é obter e consolidar o mapa de tempo previdenciário do servidor, utilizando informações registradas nas etapas anteriores do processo e uma integração específica de cálculo.

Além do valor apresentado ao usuário, vários tempos possuem uma variável paralela terminada em _dias, permitindo armazenar o resultado em dias.

**Exemplo**: tempoCargoAposen e tempoCargoAposen_dias
===== 2. Regras de Negócio =====

==== RN01. Dados básicos são oriundos do processo ====

Os seguintes campos são apresentados somente para consulta:

  * Órgão/Entidade;
  * CPF;
  * Nome do servidor;
  * Motivo da aposentadoria.

==== RN02. Período-base do cálculo ====

Dois campos de data participam da contextualização da apuração:

^Key^Campo^Observação|
|''dataEfetExercCargoInicial'' |Data do efetivo exercício no cargo de ingresso|Somente leitura|
|''dataFimTempoContribServico'' |Data do fim da apuração do tempo de contribuição/serviço|Somente leitura|

==== RN03. Resultados do mapa não são digitados manualmente ====

Os campos referentes aos tempos calculados estão configurados como readonly=true.

Isso vale, por exemplo, para:

  * tempoCargoAposen
  * tempoDescontado
  * tempoFicticio
  * tempoAverbadoPublico
  * tempoAverbadoPrivado
  * totalTempoServPublico
  * totalTempoContrbServ

Portanto, os resultados são recebidos/calculados pelo processamento do formulário, e não informados diretamente pelo operador.

==== RN04. Representação dupla dos tempos ====

Grande parte dos indicadores possui duas variáveis:

tempo… \\ tempo…_dias

A primeira representa o tempo apresentado no formulário em //ano(s,) mese(s) e dia(s)//  e a segunda armazena a quantidade desse tempo correspondente em //dia(s)//.{{:pres:gerti:gestao_de_ativos:siap_2:anosmesesdias.png?nolink&1660x404}}

==== RN05. Cálculo externo ====

O formulário possui integrações [[#calculo_tempo_v3|obtemmapatemposervidor]], versão /v3/. Cálculo do mapa depende de serviço específico de regras de Atos de Pessoal.

==== RN06. Alteração de dados de origem ====

Existe um botão específico:

''Alterar dados do histórico funcional''

A função retornarForm3 está associada à lógica de retorno ao conjunto de informações funcionais utilizado como origem do mapa.

==== RN07. Validação antes da conclusão ====

Existem funções específicas de:

  * validação de datas;
  * busca das variáveis do processo;
  * execução do cálculo;
  * auditoria de alterações;
  * envio/conclusão.

===== 3. Todas as Variáveis =====

Para facilitar o uso da documentação, organizei as variáveis por finalidade.

==== 3.1 Identificação do servidor ====

^Key^Campo^Tipo^Cols^Obrig.^Readonly^Observação|
|''nomeOrgao'' |Órgão/Entidade|input|12|Não|Sim|Identificação institucional|
|''cpfServidor'' |CPF do servidor|input-cpf|4|Não|Sim|CPF do interessado|
|''nomeServidor'' |Nome do servidor|input|8|Não|Sim|Identificação do servidor|
|''desc_motivoAposentadoria'' |Motivo da aposentadoria|input|12|Não|Sim|Motivo já definido no processo|

==== 3.2 Datas de referência ====

^Key^Campo^Tipo^Cols^Obrig.^Readonly^Observação|
|''dataEfetExercCargoInicial'' |Data do efetivo exercício no cargo de ingresso|input-date|6|Não|Sim|Data de referência funcional|
|''dataFimTempoContribServico'' |Data do fim da apuração do tempo de contribuição/serviço|input-date|6|Não|Sim|Limite da apuração|

==== 3.3 Tempos básicos da aposentadoria ====

^Key^Campo^Cols^Obrig.^Readonly|
|''tempoCargoAposen'' |Tempo de exercício no cargo da aposentadoria (A)|9|Não|Sim|
|''tempoCargoAposen_dias'' |Tempo em dias|3|Não|Sim|
|''tempoDescontado'' |Tempo descontado (B)|9|Não|Sim|
|''tempoDescontado_dias'' |Tempo em dias|3|Não|Sim|
|''tempoFicticio'' |Tempo fictício total (C)|9|Não|Sim|
|''tempoFicticio_dias'' |Tempo em dias|3|Não|Sim|
|''tempoMagisterioInfantil'' |Tempo em função exclusiva de magistério na educação infantil, ensino fundamental ou médio (D)|9|Não|Sim|
|''tempoMagisterioInfantil_dias'' |Tempo em dias|3|Não|Sim|

Tipo de todos os campos acima: input.

==== 3.4 Tempos averbados e previdenciários ====

^Key^Campo^Cols^Tipo^Obrigatório^Readonly|
|''tempoAverbadoPublico'' |Tempo averbado público (E)|9|input|Não|Sim|
|''tempoAverbadoPublico_dias'' |Tempo em dias|3|input|Não|Sim|
|''tempoAverbadoPrivado'' |Tempo averbado privado (F)|9|input|Não|Sim|
|''tempoAverbadoPrivado_dias'' |Tempo em dias|3|input|Não|Sim|
|''contribPrevidenciaria'' |Contribuição previdenciária (G)|9|input|Não|Sim|
|''contribPrevidenciaria_dias'' |Tempo em dias|3|input|Não|Sim|
|''compPrevidenciaria'' |Compensação previdenciária (H)|9|input|Não|Sim|
|''compPrevidenciaria_dias'' |Tempo em dias|3|input|Não|Sim|

==== 3.5 Tempos relacionados à pessoa com deficiência ====

^Key^Campo^Cols|
|''tempoCondicaoDeficiencia'' |Tempo na condição de segurado com deficiência, antes da conversão (J)|9|
|''tempoCondicaoDeficiencia_dias'' |Tempo em dias|3|
|''tempoCondicaoSegDeficiencia'' |Tempo na condição de segurado com deficiência após conversão, Decreto nº 3.048/1999, art. 70-E (K)|9|
|''tempoCondicaoSegDeficiencia_dias'' |Tempo em dias|3|
|''tempoCondicaoSemDeficiencia'' |Tempo na condição de pessoa sem deficiência, antes da conversão (L)|9|
|''tempoCondicaoSemDeficiencia_dias'' |Tempo em dias|3|
|''tempoCondicaoDeficienciaConversao'' |Tempo na condição de pessoa sem deficiência, após conversão (M)|9|
|''tempoCondicaoDeficienciaConversao_dias'' |Tempo em dias|3|

Todos estão definidos como:

  * Tipo: input;
  * Obrigatório: Não;
  * Somente leitura: Sim.

==== 3.6 Tempos em condições especiais ====

^Key^Campo^Cols|
|''tempoSobCondicoesEspeciais'' |Tempo em atividades sob condições especiais, antes da conversão (N)|9|
|''tempoSobCondicoesEspeciais_dias'' |Tempo em dias|3|
|''tempoCondicoesEspeciasConversao1'' |Tempo em atividades sob condições especiais após conversão, Decreto nº 3.048/1999, art. 70-F, §1º (O)|9|
|''tempoCondicoesEspeciasConversao1_dias'' |Tempo em dias|3|
|''tempoCondicoesEspeciasConversao2'' |Tempo em atividades sob condições especiais após conversão, Decreto nº 3.048/1999, art. 66, §2º|9|
|''tempoCondicoesEspeciasConversao2_dias'' |Tempo em dias|3|

Todos são input, não obrigatórios e somente leitura.

==== 3.7 Totais e conversões ====

^Key^Campo^Cols^Readonly|
|''totalTempoServPublico'' |Total de tempo de serviço público (TSP)|9|Sim|
|''totalTempoServPublico_dias'' |Tempo em dias|3|Sim|
|''tempoContribuicaoServicoPCD'' |Total de tempo de contribuição/serviço após conversões (TCS-[[:pres:gerti:gestao_de_ativos:siap_2:pcd|PcD]])|9|Sim|
|''tempoContribuicaoServicoPCD_dias'' |Tempo em dias|3|Sim|
|''tempoConvertidoSerAcrescido'' |Tempo convertido a ser acrescido (I)|9|Sim|
|''tempoConvertidoSerAcrescido_dias'' |Tempo em dias|3|Sim|
|''totalTempoContrbServ'' |Total de tempo de contribuição/serviço (TCS)|9|Sim|
|''totalTempoContrbServ_dias'' |Tempo em dias|3|Sim|

Tipo: input.

Obrigatórios: Não.

==== 3.8 Variável técnica ====

^Key^Campo^Tipo^Cols^Obrig.^Readonly^Finalidade|
|''fd_tempo'' |FD_Tempo|input|6|Não|Não|Variável técnica relacionada ao processamento do mapa, variável que recebe o retorno da [[#integracao|api]] que trás os tempos calculados.|

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

O JSON contém 5 configurações de integração.

==== 4.1 Consulta do usuário logado ====

Nome: usuariologado

Evento: load

Serviço: cpa-core-backend

Operação: POST /s/integracao-fd/consulta-usuario-logado

Inicializada no carregamento do formulário e é reponsável pela captura dos dados do usuário logado e disponibilizado ao sistema.

====   ====

==== 4.2 Cálculo Tempo V3 ====

TCE - Atos de Pessoal - Api Regras Form Dinamico

POST /v3/[[:pres:gerti:gestao_de_ativos:siap_2:obtemmapatemposervidor|ObtemMapaTempoServidor]]

Também está configurada como integração de click.

**Visão consolidada**

**{{:pres:gerti:gestao_de_ativos:siap_2:visaoconsolidadamapatempo.png?nolink&336x237}}**

=====   =====

==== 4.3 Busca de todas as variáveis do fluxo ====

**Serviço**: [[:pres:gerti:gestao_de_ativos:siap_2:solarbpm|SolarBPM]] - Consulta todas variáveis 2

GET /bpm-server-adm/bindings/{cdVinculo}/variables

Essa integração recupera as variáveis vinculadas à instância do processo (cdVinculo) para utilização pelo processamento do formulário.

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

Alterar dados do histórico funcional

^Propriedade^Valor|
|Key|''btn_2'' |
|Tipo|button|
|Título|Alterar dados do histórico funcional|

Permite acionar o caminho de retorno relacionado às informações funcionais usadas pelo mapa ( finaliza e direciona, atravéz do fluxo, para tarefa "Dados do histórico funcional").

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

==== RN-MT-01: cálculo centralizado ====

Os valores do Mapa do Tempo são tratados como resultados calculados, visto que seus respectivos campos estão definidos como somente leitura.

==== RN-MT-02: obtenção das variáveis do fluxo ====

Antes/durante o processamento, o formulário possui mecanismo específico para recuperar variáveis do vínculo BPM.

==== RN-MT-03: integração especializada ====

O mapa utiliza o serviço [[#calculo_tempo_v3|obtemmapatemposervidor]] para enviar e devolver parametros utilizado nos calculos.

==== RN-MT-04: resultados em dias ====

As categorias principais têm representação complementar em dias, identificada pelo padrão:

*_dias

==== RN-MT-05: datas controlam o período ====

A data de efetivo exercício no cargo de ingresso e a data final da apuração integram os dados apresentados para a apuração.

==== RN-MT-06: alteração dos dados funcionais ====

Se houver necessidade de corrigir os dados funcionais usados pelo mapa, existe uma ação explícita **Alterar dados do histórico funcional**.

==== RN-MT-07: auditoria ====

O formulário possui funções específicas para identificar e registrar alterações:

setInfoAlterada()

preencheInformacoesAlteradas()

removeIndice_tab_relacoesInfoalteradas()

===== 7. Principais Funções JavaScript =====

O arquivo possui **18 funções **  [[:pres:gerti:gestao_de_ativos:siap_2:javascript|JavaScript]] .

==== 7.1 Inicialização e estado do formulário ====

^Função^Responsabilidade funcional|
|''onLoadFuncao()'' |Rotinas de carregamento|
|''statusForm_finalizadoOuNao()'' |Verifica, no carregamento da pagina, o estado do formulário, se esta finalizado ou não. (Mais detalhes, consulta no form codigo na função)|
|''carregaDadosIniciais()'' |Carregamento dos dados iniciais|

==== 7.2 Cálculo do Mapa do Tempo ====

^Função^Responsabilidade|
|''carregarMapaTempo()'' |Carregamento do mapa|
|''executaIntegracaoTempo()'' |Aciona processamento/integracão relacionada ao cálculo|
|''validaDataCalculos()'' |Valida datas utilizadas na rotina de cálculo|
|''removePalavraDias()'' |Tratamento textual relacionado à representação de dias|

Estas funções formam o núcleo funcional da tela.

==== 7.3 Busca de variáveis BPM ====

^Função^Responsabilidade|
|''variaveisParaBusca()'' |Prepara as variáveis necessárias à busca.(Relacionadas as críticas da instância jurisdicionado) \\ Ex: { 'variavel_f': 'cod_motivoAposentadoria', 'variavel_tce': 'motivoAposentadoria' }|
|''acionaIntegracaoBuscaTodasVariaveis()'' |Aciona integração [[#busca_de_todas_as_variaveis_do_fluxo|Busca todas variáveis do fluxo]] de consulta das variáveis do fluxo e retornas todas as variáveis com seus respectivos valores na variável todasVariaveis.|
|''buscaVariaveisFluxo_e_enviarDados()'' |Combina recuperação das variáveis com sequência de envio|

A existência dessas funções está diretamente relacionada à integração:

GET /bpm-server-adm/bindings/{cdVinculo}/variables

==== 7.4 Auditoria ====

^Função^Responsabilidade|
|''setInfoAlterada()'' |Trata informação identificada como alterada|
|''preencheInformacoesAlteradas()'' |Preenche estrutura de alterações. (Antes e depois)|

==== 7.5 Navegação e submissão ====

^Função^Responsabilidade|
|''retornarForm3()'' |Lógica de retorno relacionada ao formulário anterior/histórico funcional|
|''enviarDados()'' |Rotina de envio/conclusão|
|''capturaDataHoraAtual()'' |Obtém data/hora utilizada pelo processamento|

==== 7.6 Interface ====

^Função^Responsabilidade|
|''exibeAlerta()'' |Exibe mensagem/alerta no formulário|

===== 8. Fluxo Funcional Consolidado =====

{{:pres:gerti:gestao_de_ativos:siap_2:fluxofuncionalconsolidado-mapadotempo.png?nolink&357x730}}

======   ======

===== 9.Resumo Executivo =====

A tarefa **Mapa do Tempo**  consolida os tempos relevantes à análise da aposentadoria civil.

O formulário trabalha principalmente com **dados calculados e somente leitura**, abrangendo tempo de cargo, descontos, tempo fictício, magistério, averbações públicas e privadas, contribuição/compensação previdenciária, condições especiais, pessoa com deficiência, conversões e totais de serviço/contribuição.

Tecnicamente, a tarefa possui três componentes centrais:

  - **Recuperação das variáveis da instância BPM**, por meio do vínculo do processo, para preparação e envio das variáveis para o serviço de críticas logo depois desta tarefa Mapa do tempo finalizada ;
  - **Processamento pela API de regras de Atos de Pessoal**, através do serviço ''[[:pres:gerti:gestao_de_ativos:siap_2:obtemmapatemposervidor|ObtemMapaTempoServidor]]'' ;
  - **Apresentação do mapa calculado**, mantendo tanto valores de apresentação quanto os correspondentes valores em dias.
=====   =====

===== 10. Imagens do formulário =====

{{:pres:gerti:gestao_de_ativos:siap_2:formmapadotempo.png?nolink&1727x989}}

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