Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Próxima revisão
Revisão anterior
pres:gerti:gestao_de_ativos:bace_2:extraprocesso [26/11/2025 18:17] – criada jbmoraespres:gerti:gestao_de_ativos:bace_2:extraprocesso [27/11/2025 12:00] (atual) jbmoraes
Linha 1: Linha 1:
-teste+====== ER_007 – Extra Processo ====== 
 + 
 +==== Descrição ==== 
 + 
 +A funcionalidade Extra Processo permite registrar benefícios consolidados (Estado Efetivo) que não estão vinculados diretamente a um processo específico do BACE, mas sim a um jurisdicionado. É utilizada, principalmente, para registrar resultados de ações de controle como Mesa Técnica e Visita Técnica, garantindo rastreabilidade, memória de cálculo, anexos e histórico das alterações. A tela permite: 
 + 
 +Selecionar um jurisdicionado; 
 + 
 +Cadastrar novos benefícios extras; 
 + 
 +Visualizar, editar, duplicar e excluir registros existentes; 
 + 
 +Consultar o Histórico do benefício Extra. 
 + 
 +==== Atores ==== 
 + 
 +^Ator^Permissões na Funcionalidade| 
 +|Usuário|Consulta lista de benefícios extras por jurisdicionado e visualiza detalhes.| 
 +|Auditor|Consulta, cadastra, edita, duplica e visualiza histórico dos benefícios extras de seu jurisdicionado.| 
 +|Gestor|Mesmas permissões do Auditor, com priorização na análise e ajuste de registros.| 
 +|Administrador|Acesso completo: cadastro, edição, duplicação, histórico e exclusão de benefícios extras.| 
 + 
 +==== Telas ==== 
 + 
 +=== Tela 01 – Extra Processo – Seleção de Jurisdicionado === 
 + 
 +{{  :pres:gerti:gestao_de_ativos:bace_2:extraprocesso_1.png  }} 
 + 
 +^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| 
 +|Campo “Jurisdicionado”|Campo texto (autocompletar)|Sim para habilitar ações|Digite 3+ caracteres para buscar jurisdicionados válidos|—|Busca na base de jurisdicionados. Ao selecionar, habilita os botões e a grid de benefícios.| 
 +|Botão “Selecionar”|Botão|Não|Clique|—|Confirma o jurisdicionado digitado quando encontrado na busca.| 
 +|Botão “Limpar”|Botão|Não|Clique|—|Limpa a seleção atual de jurisdicionado e a grid de benefícios.| 
 +|Botão “Cadastrar benefício”|Botão|Sim (após jurisdicionado selecionado)|Clique|Desabilitado enquanto não houver jurisdicionado selecionado|Abre a Modal Cadastrar Benefício Extra.| 
 +|Botão “Histórico geral”|Botão|Não|Clique|—|Abre o histórico consolidado de benefícios extras para o jurisdicionado selecionado (quando implementado).| 
 +|Mensagem de orientação|Texto informativo|Não|“Você também consegue revisar agrupado por jurisdicionado na tela Lista Extra.”|—|Texto fixo com link informativo para outra visão do módulo.| 
 + 
 +=== Tela 02 – Extra Processo – Benefícios do Jurisdicionado === 
 + 
 +{{  :pres:gerti:gestao_de_ativos:bace_2:extra_2.png  }} 
 + 
 +^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| 
 +|Grid “Benefícios cadastrados para: [Jurisdicionado]”|Tabela|Não|Linhas de benefícios extras|—|Exibe apenas registros associados ao jurisdicionado selecionado.| 
 +|Coluna “ID Extra”|Texto|Sim|Código hash/ID interno do benefício extra|—|Identificador único não editável.| 
 +|Coluna “Descrição”|Texto|Sim|Texto cadastrado no benefício|—|Resumo principal do benefício extra.| 
 +|Coluna “Ação de Controle”|Texto|Sim|Mesa Técnica / Visita Técnica|—|Origem do registro conforme ação de controle.| 
 +|Coluna “Tipo/Subtipo”|Texto|Sim|Combinação do Tipo e Subtipo cadastrados|—|Derivado da configuração do benefício.| 
 +|Coluna “Natureza”|Texto|Sim|Financeiro / Não Financeiro / Qualitativo (se aplicável)|—|Define se haverá valor ou quantidade.| 
 +|Coluna “UT”|Texto|Sim|Sigla da Unidade Técnica|—|Unidade responsável pelo registro.| 
 +|Coluna “Valor / Qtd.”|Texto|Sim|Valor monetário ou quantidade|—|Apresenta o total numérico associado ao benefício extra.| 
 +|Ícone “Visualizar” (👁️)|Botão|Não|Clique|—|Abre a Modal Visualizar Benefício Extra em modo somente leitura.| 
 +|Ícone “Editar” (✏️)|Botão|Não|Clique|—|Abre a Modal Cadastrar Benefício Extra com os dados já preenchidos para edição.| 
 +|Ícone “Histórico” (🕓)|Botão|Não|Clique|—|Abre a Modal Histórico do Benefício Extra.| 
 +|Ícone “Duplicar” (📄)|Botão|Não|Clique|—|Cria um novo registro pré-preenchido com base no benefício selecionado.| 
 +|Ícone “Excluir” (🗑️)|Botão|Não|Clique|—|Exclui o benefício extra após confirmação, conforme permissões.| 
 + 
 +=== Tela 03 – Modal Cadastrar Benefício Extra === 
 + 
 +{{  :pres:gerti:gestao_de_ativos:bace_2:cadastrar_beneficio_extra.png  }} 
 + 
 +^Campo^Obrigatório^Valores Possíveis^Observação| 
 +|Estado*|Sim|Fixado em Efetivo|Estado sempre Efetivo para registros de Extra Processo, não editável.| 
 +|Unidade Técnica*|Sim|Lista de UTs habilitadas|Sugestão conforme setor do usuário logado.| 
 +|Ação de Controle*|Sim|Mesa Técnica / Visita Técnica|Controla relatórios e agrupamentos de resultados.| 
 +|Marcador Temático*|Sim|Lista de marcadores configurados|Usado para classificação temática.| 
 +|Área Principal*|Sim|Lista de áreas|Obrigatória.| 
 +|Áreas Secundárias|Não|Lista múltipla de áreas|Opcional, com botões Adicionar e Limpar lista.| 
 +|Tipo*|Sim|Tipos de benefício disponíveis|Define conjunto de Subtipos e Natureza.| 
 +|Subtipo|Depende|Subtipos vinculados ao Tipo selecionado|Exibido apenas quando o Tipo possuir desdobramentos.| 
 +|Natureza*|Sim|Quantitativo Financeiro / Quantitativo Não Financeiro / Qualitativo|Determina exibição de campos de valor ou quantidade.| 
 +|Valor (R$) – total|Depende|Numérico|Obrigatório quando Natureza = Quantitativo Financeiro.| 
 +|Unidade de medida / Quantidade|Depende|Texto + Numérico|Obrigatório quando Natureza = Quantitativo Não Financeiro.| 
 +|Memória de Cálculo / Fonte*|Sim|Texto longo|Justifica o valor/quantidade registrada; campo sempre obrigatório.| 
 +|Anexos|Não|Arquivos diversos|Permite upload de um ou mais documentos comprobatórios.| 
 +|Descrição do benefício*|Sim|Texto longo|Deve descrever o benefício em viés positivo, conforme diretrizes internas.| 
 +|Botão “Salvar”|Sim|Clique|Valida campos obrigatórios e grava o benefício extra.| 
 +|Botão “Cancelar”|Não|Clique|Fecha a modal sem salvar alterações.| 
 + 
 +=== Tela 04 – Modal Visualizar Benefício Extra === 
 + 
 +{{  :pres:gerti:gestao_de_ativos:bace_2:vizualizar_extraprocesso.png  }} 
 + 
 +^Elemento^Tipo^Observação| 
 +|Bloco de detalhes|Texto somente leitura|Apresenta todos os campos do benefício, conforme cadastro e ordem fixas de campos.| 
 +|Botão “Fechar”|Botão|Fecha a visualização.| 
 + 
 +=== Tela 05 – Modal Histórico do Benefício Extra === 
 + 
 +{{  :pres:gerti:gestao_de_ativos:bace_2:historico_extra.png  }} 
 + 
 +^Elemento^Tipo^Observação| 
 +|Tabela de histórico|Tabela|Exibe linha a linha as alterações do benefício extra.| 
 +|Coluna Usuário|Texto|Responsável pela ação (inclusão/alteração).| 
 +|Coluna Unidade Técnica|Texto|UT associada à ação registrada.| 
 +|Coluna Data/Hora|Texto|Momento em que a ação foi realizada.| 
 +|Coluna Ação|Texto|Descrição da ação (inclusão, alteração, exclusão, duplicação etc.).| 
 +|Coluna Dados Modificados|Bloco de texto|Apresenta antes/depois, quando aplicável.| 
 +|Colunas Situação Anterior / Atual|Texto|Estado dos principais campos antes e depois da alteração.| 
 +|Botão “Fechar”|Botão|Encerra a visualização do histórico.| 
 + 
 +==== Fluxos ==== 
 + 
 +=== Fluxo 01 – Seleção de Jurisdicionado e Carregamento dos Benefícios === 
 + 
 +^Passo^Ação^Regra^Tela| 
 +|01|Usuário acessa o menu Extra Processo.|RN-EX01|Tela 01| 
 +|02|Sistema exibe campo de busca “Jurisdicionado”, botões Selecionar/Limpar e botões desabilitados.|RN-EX01|Tela 01| 
 +|03|Usuário digita pelo menos 3 caracteres no campo “Jurisdicionado”.|RN-EX02|Tela 01| 
 +|04|Sistema consulta a base de jurisdicionados e apresenta sugestões compatíveis.|RN-EX02|Tela 01| 
 +|05|Usuário seleciona o jurisdicionado desejado e confirma.|RN-EX02|Tela 01| 
 +|06|Sistema carrega os benefícios extras cadastrados para o jurisdicionado e habilita os botões Cadastrar benefício e Histórico geral.|RN-EX03|Tela 02| 
 + 
 +=== Fluxo 02 – Cadastro de Benefício Extra === 
 + 
 +^Passo^Ação^Regra^Tela| 
 +|01|Com jurisdicionado selecionado, usuário clica no botão Cadastrar benefício.|RN-EX03, RN-EX04|Tela 02| 
 +|02|Sistema abre a Modal Cadastrar Benefício Extra com Estado fixo em Efetivo.|RN-EX04, RN-EX05|Tela 03| 
 +|03|Usuário preenche campos obrigatórios (UT, Ação de Controle, Tipo/Subtipo, Natureza, Memória de Cálculo, Descrição etc.).|RN-EX06, RN-EX07|Tela 03| 
 +|04|Caso algum campo obrigatório não seja preenchido, sistema destaca o campo e exibe mensagem de validação (ex.: “Preencha os campos obrigatórios marcados em vermelho.”).|RN-EX07|Tela 03| 
 +|05|Usuário clica em Salvar.|RN-EX07|Tela 03| 
 +|06|Sistema valida os dados, grava o novo benefício extra, gera um ID Extra e registra evento no histórico.|RN-EX06, RN-EX08|Processo interno| 
 +|07|Sistema fecha a modal e atualiza a grid de benefícios do jurisdicionado, exibindo o novo registro.|RN-EX03|Tela 02| 
 + 
 +=== Fluxo 03 – Edição de Benefício Extra === 
 + 
 +^Passo^Ação^Regra^Tela| 
 +|01|Usuário identifica um benefício extra na grid e clica no ícone Editar (✏️).|RN-EX09|Tela 02| 
 +|02|Sistema abre a Modal Cadastrar Benefício Extra preenchida com os dados persistidos.|RN-EX09|Tela 03| 
 +|03|Usuário ajusta os campos permitidos e clica em Salvar.|RN-EX06, RN-EX07|Tela 03| 
 +|04|Sistema valida as alterações, grava o registro atualizado e inclui uma linha no histórico indicando os campos alterados.|RN-EX08, RN-EX10|Processo interno| 
 +|05|Sistema retorna à grid com os dados atualizados.|RN-EX03|Tela 02| 
 + 
 +=== Fluxo 04 – Duplicação de Benefício Extra === 
 + 
 +^Passo^Ação^Regra^Tela| 
 +|01|Usuário seleciona um benefício extra e clica no ícone Duplicar (📄).|RN-EX11|Tela 02| 
 +|02|Sistema cria um rascunho de novo benefício extra copiando  campos especificos do registro original |RN-EX15|Processo interno| 
 +|03|Sistema abre a Modal Cadastrar Benefício Extra com os dados copiados para edição.|RN-EX11|Tela 03| 
 +|04|Usuário ajusta os campos necessários (por exemplo, valores, memória de cálculo, anexos) e clica em Salvar.|RN-EX06, RN-EX07|Tela 03| 
 +|05|Sistema grava o novo benefício extra com novo ID e registra no histórico que a origem foi uma duplicação.|RN-EX08, RN-EX11|Processo interno| 
 +|06|Grid é atualizada exibindo o novo registro.|RN-EX03|Tela 02| 
 + 
 +=== Fluxo 05 – Exclusão de Benefício Extra === 
 + 
 +^Passo^Ação^Regra^Tela| 
 +|01|Usuário clica no ícone Excluir (🗑️) de um benefício extra.|RN-EX12|Tela 02| 
 +|02|Sistema apresenta mensagem de confirmação: “Confirmar exclusão: deseja realmente excluir o benefício extra ID [XXX] para o jurisdicionado [Nome]?” com opções Sim e Cancelar.|RN-EX12|Tela 02| 
 +|03|Se o usuário confirmar, sistema remove o registro da base e registra evento no histórico geral (quando aplicável).|RN-EX08, RN-EX12|Processo interno| 
 +|04|Se o usuário cancelar, nenhuma alteração é realizada.|RN-EX12|Tela 02| 
 + 
 +=== Fluxo 06 – Consulta de Histórico do Benefício Extra === 
 + 
 +^Passo^Ação^Regra^Tela| 
 +|01|Usuário clica no ícone Histórico (🕓) de um benefício extra.|RN-EX08, RN-EX10|Tela 02| 
 +|02|Sistema abre a Modal Histórico do Benefício Extra com a lista de ações realizadas.|RN-EX08, RN-EX10|Tela 05| 
 +|03|Usuário analisa as alterações (inclusão, edição, duplicação, exclusão) e clica em Fechar.|RN-EX10|Tela 05| 
 + 
 +==== Regras de Negócio – Extra Processo (RN-EX) ==== 
 + 
 +^Regra___^Descrição| 
 +|RN-EX01|A tela Extra Processo deve ser acessível apenas para usuários autenticados e perfis com permissão de uso do módulo.| 
 +|RN-EX02|O campo “Jurisdicionado” utiliza busca por autocompletar e só habilita seleção após digitados, no mínimo, 3 caracteres válidos.| 
 +|RN-EX03|A grid de benefícios extras só é carregada após a seleção de um jurisdicionado válido.| 
 +|RN-EX04|Somente é permitido cadastrar benefício extra quando houver jurisdicionado selecionado.| 
 +|RN-EX05|No Extra Processo, o campo Estado é fixo em Efetivo, não permitindo alteração pelo usuário.| 
 +|RN-EX06|Os campos obrigatórios da modal (UT, Tipo/Natureza, Memória de Cálculo, Descrição etc.) devem ser validados antes do salvamento, os dados são os mesmos disponiveis  no cadastro do beneficio pelo processo , mudando apenas o momento do registro que tem disponivel mesa técnica ou visita técnica . Lista de dados disponivel em: [[:pres:gerti:gestao_de_ativos:bace_2:cadastrarbeneficiomodalbeneficio#tabelas_de_combinacoes_e_listas|Link]]| 
 +|RN-EX07|Na tentativa de salvar com dados incompletos, o sistema deve impedir a operação, destacar os campos obrigatórios e exibir mensagem de orientação.| 
 +|RN-EX08|Toda inclusão, alteração, duplicação ou exclusão de benefício extra deve gerar registro no histórico com usuário, data/hora, ação e dados relevantes.| 
 +|RN-EX09|A edição de benefício extra somente é permitida para perfis com permissão (Auditor, Gestor, Administrador); usuários de leitura podem apenas visualizar.| 
 +|RN-EX10|O histórico do benefício extra é apenas para consulta, não permitindo alteração ou exclusão de registros históricos.| 
 +|RN-EX11|A ação Duplicar deve criar um novo benefício extra independente, com novo ID, mantendo vínculo lógico apenas por referência no histórico (origem duplicada).| 
 +|RN-EX12|A exclusão de benefício extra é disponível apenas para perfis autorizados; uma vez excluído, o registro deixa de aparecer na grid, mantendo apenas o rastro histórico geral.| 
 +|RN-EX13|A combinação de Tipo/Subtipo/Natureza deve seguir as mesmas regras da modal de cadastro de benefício principal, impedindo combinações inválidas.  Verifique em:  [[:pres:gerti:gestao_de_ativos:bace_2:cadastrarbeneficiomodalbeneficio#tabelas_de_combinacoes_e_listas|Link]]| 
 +|RN-EX14|Campos condicionais (Valor, Quantidade, Unidade de medida) devem ser exibidos ou ocultados conforme a Natureza selecionada (Financeira, Não Financeira ou Qualitativa).| 
 +|RN-EX15|Ao duplicar os dados pré preenchidos serão:  Unidade técnica, Laboratorio movel caso a unidade tecnica for da area de engenharia, ação de controle, marcador tematico, area principal e area secundaria,  os demais campos devem ser preenchidos para o registro do novo beneficio. | 
 + 
  • pres/gerti/gestao_de_ativos/bace_2/extraprocesso.1764181070.txt.gz
  • Última modificação: 26/11/2025 18:17
  • por jbmoraes