pres:gerti:gestao_de_ativos:bace_2:consultabace

Diferenças

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

Link para esta página de comparações

Ambos lados da revisão anterior Revisão anterior
Próxima revisão		 Revisão anterior
pres:gerti:gestao_de_ativos:bace_2:consultabace [26/11/2025 19:20] – jbmoraespres:gerti:gestao_de_ativos:bace_2:consultabace [27/11/2025 15:22] (atual) – [Fluxo 04 – Excluir Registros] jbmoraes
Linha 2: Linha 2:
  
 ===== 1. Descrição ===== ===== 1. Descrição =====
-A funcionalidade Consulta BACE apresenta a listagem consolidada de Processos e os Benefícios/registros “Sem benefício” associados pela Unidade Técnica. + 
-A tela permite filtrar, paginar, expandir/recolher grupos por processo, visualizar resumo do processo, abrir a visualização do benefício, editar (quando permitido) e excluir registros (mediante confirmação). Também é possível remover registros “Sem benefício”.+A funcionalidade Consulta BACE apresenta a listagem consolidada de Processos e os Benefícios/registros “Sem benefício” associados pela Unidade Técnica. A tela permite filtrar, paginar, expandir/recolher grupos por processo, visualizar resumo do processo, abrir a visualização do benefício, editar (quando permitido) e excluir registros (mediante confirmação). Também é possível remover registros “Sem benefício”.
  
 ===== 2. Atores ===== ===== 2. Atores =====
 +
 ^Ator^Pode executar os Fluxos| ^Ator^Pode executar os Fluxos|
 |Usuário|Leitura (filtros, expansão, visualização).| |Usuário|Leitura (filtros, expansão, visualização).|
-|Auditor|Fluxos 01, 02, 03 e 04 (visualizar/editar/excluir conforme permissão local).| +|Auditor|Fluxos 01, 02 e 03 ( Permissão editar depende da situação do beneficio, apenas situação em elaboração)| 
-|Gestor|Fluxos 01, 02, 03 e 04 (equivalente ao Auditor; possui permissões ampliadas).|+|Gestor|Fluxos 01, 02 e 03 (equivalente ao Auditor; possui permissões ampliadas dependo da situação do beneficio).|
 |Administrador|Todos os fluxos (controle total).| |Administrador|Todos os fluxos (controle total).|
  
-Observação de permissões: o código diferencia perfis via utilitário isAdminOrGestor() e/ou login “admin”. Alguns bloqueios adicionais ocorrem por origem do registro (ex.: inseridos por lote não podem ser editados na lista).+Observação de permissões: o código diferencia perfis via utilitário . Alguns bloqueios adicionais ocorrem por origem do registro (ex.: inseridos por lote não podem ser editados na lista).
  
 ===== 3. Telas ===== ===== 3. Telas =====
  
 ==== Tela 01 – Listagem e Agrupamento por Processo ==== ==== Tela 01 – Listagem e Agrupamento por Processo ====
-{{ :pres:gerti:gestao_de_ativos:bace_2:consulta_bace.png |}}+ 
 +{{  :pres:gerti:gestao_de_ativos:bace_2:consulta_bace.png  }}
  
 ^Elemento^Tipo^Obrigatório^Observação| ^Elemento^Tipo^Obrigatório^Observação|
Linha 30: Linha 32:
 Grid de Benefícios (dentro do processo): Grid de Benefícios (dentro do processo):
  
-^Elemento^Tipo^Obrigatório^Observação| +^Elemento^Tipo^Obrigatório^Valores Possíveis^Observação| 
-|Benefício (ID)|Link/botão|—|ID clicável abre popover/portal com descrição do benefício.| +|Benefício (ID)|Link/botão|—|—|ID clicável abre popover/portal com descrição do benefício.| 
-|Tipo|Texto|—|Tipo do benefício (cadastrado).| +|Tipo|Texto|—|—|Tipo do benefício (cadastrado).| 
-|Natureza|Texto|—|Natureza do benefício.| +|Natureza|Texto|—|—|Natureza do benefício.| 
-|Origem|Texto|—|Principal/Derivado.| +|Origem|Texto|—|—|Principal/Derivado.| 
-|Unid. Técnica|Texto|—|Unidade técnica proprietária.| +|Unid. Técnica|Texto|—|—|Unidade técnica proprietária.| 
-|Estado|Texto|—|Proposta / Potencial / Efetivo.| +|Estado|Texto|—|—|Proposta / Potencial / Efetivo.| 
-|Situação|Texto|—|Em elaboração / Revisado / Encerrado etc.| +|Situação|Texto|—|—|Em elaboração / Revisado / Encerrado etc.| 
-|Data de criação|Texto|—|Data do registro.| +|Data de criação|Texto|—|—|Data do registro.| 
-|Ações|Botoões|—|Visualizar, Editar, Excluir (conforme permissão/estado).|+|Ações|Botões|—|—|Visualizar, Editar, Excluir (conforme permissão/estado).| 
 +|Visualizar|Ícone|—|—|abre Modal Visualizar Benefício.| 
 +|Editar|Ícone|—|—|abre [[:pres:gerti:gestao_de_ativos:bace_2:beneficiomodal|BeneficioModal]] com dados que foram percistidos anteriomente . Regra de bloqueio: registros de lote (idLote/origem === "lote") não podem ser editados aqui; exibe aviso.| 
 +|Excluir|Ícone|—|—|solicita confirmação; ao confirmar, remove o benefício e atualiza a lista|
  
-Ações (por benefício):+==== Tela 02 – Filtros ====
  
-Visualizar (ícone olho) → abre Modal Visualizar Benefício. +{{  :pres:gerti:gestao_de_ativos:bace_2:consulta_beneficio_filtros.png| }}
- +
-Editar (ícone lápis) → abre BeneficioModal pré-preenchida. +
-Regra de bloqueio: registros de lote (idLote/origem === "lote") não podem ser editados aqui; exibe aviso. +
- +
-Excluir (ícone lixeira) → solicita confirmação; ao confirmar, remove o benefício e atualiza a lista. +
- +
-Ação para “Sem benefício” (por processo): +
- +
-Excluir registro ‘Sem benefício’ (ícone lixeira) → confirmação e remoção do marcador do processo. +
- +
-Rodapé / Paginação: +
- +
-Itens/página (10, 20, 50…) e navegação de páginas. +
- +
-Indicadores de totais (processos filtrados; benefícios filtrados). +
- +
-==== Tela 02 – Filtros ==== +
-{{ :pres:gerti:gestao_de_ativos:bace_2:consulta_beneficio_filtros.png |}}+
  
-^Filtro^Tipo^Observação| +^Elemento^Tipo^Obrigatório^Valores Possíveis^Observação| 
-|Processo (fProc)|Texto|Busca por nº do processo.| +|Processo|Texto|__|__ |Busca por nº do processo que possui beneficios cadastrados| | 
-|Situação (fSitu)|Select|Filtra por situação do benefício.| +|Situação|Select|__|__ |Filtra por situação do benefício.| | 
-|Unidade Técnica (fUT)|Select|Filtra por UT.| +|Unidade Técnica|Select|__|__ |Filtra por UT.| | 
-|Tipo (fTipo)|Select|Filtra por tipo do benefício.| +|Tipo|Select|__|__ |Filtra por tipo do benefício.| | 
-|Estado (fEstado)|Select|Filtra por estado do benefício.| +|Estado|Select|__|__ |Filtra por estado do benefício.| | 
-|Data Inicial (fDataIni)|Data|Limite inferior por data de criação.| +|Data Inicial|Data|__|__ |Limite inferior por data de criação.| | 
-|Data Final (fDataFim)|Data|Limite superior por data de criação.| +|Data Final|Data|__|__ |Limite superior por data de criação.| | 
-|Exibir “Sem benefício” (showSemBenef)|Checkbox|Inclui/exclui processos marcados como sem benefício.|+|Exibir “Sem benefício” (|Checkbox|__|__ |Altera resultado listando apenas processos marcados como sem benefício.| |
  
 Observação: a filtragem é aplicada sobre o conjunto agrupado; o processo permanece visível se houver pelo menos um item do grupo que atenda aos filtros. A pesquisa por datas considera a data de criação do registro. Observação: a filtragem é aplicada sobre o conjunto agrupado; o processo permanece visível se houver pelo menos um item do grupo que atenda aos filtros. A pesquisa por datas considera a data de criação do registro.
  
 ==== Tela 03 – Modal Visualizar Benefício ==== ==== Tela 03 – Modal Visualizar Benefício ====
-{{ :pres:gerti:gestao_de_ativos:bace_2:visualizar_beneficio_consulta.png |}} 
  
-^Elemento^Tipo^Obrigatório^Observação| +{{  :pres:gerti:gestao_de_ativos:bace_2:visualizar_beneficio_consulta.png  }} 
-|Dados do Benefício|Leitura|Sim|Exibe campos principais (estado, tipo, natureza, UT, etc.).| + 
-|Documento Vinculante|Leitura|—|Exibe o vinculante conforme momento do registro (quando houver).| +^Elemento^Tipo^Obrigatório^Valores Possíveis^Observação| 
-|Histórico|Leitura|—|Eventos e alterações (quando registrados).|+|Dados do Benefício|Leitura|Sim|—|Exibe campos principais (estado, tipo, natureza, UT, etc.).| 
 +|Documento Vinculante|Leitura|—|—|Exibe o vinculante conforme momento do registro (quando houver).| 
 +|Histórico|Leitura|—|—|Eventos e alterações (quando registrados).|
  
 ==== Tela 04 – Modal Editar Benefício (BeneficioModal) ==== ==== Tela 04 – Modal Editar Benefício (BeneficioModal) ====
-Abre via ação Editar. 
  
-^Elemento^Tipo^Obrigatório^Observação| +{{:pres:gerti:gestao_de_ativos:bace_2:editarbeneficioconsulta.png?nolink&1920x915}}
-|Estado|Select|Sim|Obrigatório.| +
-|Tipo|Select|Sim|Obrigatório.| +
-|Natureza|Select|Sim|Obrigatório.| +
-|Unidade Técnica|Select|Sim|Obrigatório.| +
-|Ação de Controle|Select|Sim|Obrigatório.| +
-|Marcador Temático|Select|Sim|Obrigatório.| +
-|Área Principal|Select|Sim|Obrigatório.| +
-|Descrição/Título|Texto|Sim|Obrigatório.| +
-|Momento do Registro|Select|Cond.|Pode exigir vinculante (ver regras abaixo).| +
-|Campos complementares|Vários|—|Conforme configuração do formulário.|+
  
-Validações de Vinculantes (implementadas em validarBeneficio) +^Elemento ^ Tipo^ Obrigatório^ Valores Possíveis ^Observação| 
-Quando não estiver em modo lote, são obrigatórios:+|Estado|Select| | |Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Tipo|Select|||Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Natureza|Select|||Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Unidade Técnica|Select|||Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Ação de Controle|Select|||Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Marcador Temático|Select|| |Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Área Principal|Select|||Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Descrição/Título|Texto|||Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Momento do Registro|Select|||Obrigatório dados preenchidos conforme cadastro original podendo ser editado conforme situação|  
 +|Campos complementares|Vários|||Conforme configuração dados preenchidos pelo cadastro de beneficio.| 
  
-Se Momento = “INSTRUÇÃO TÉCNICA CONCLUSIVA” → Selecione a Instrução vinculante.+=====  4. Fluxos ===== 
  
-Se Momento = “ACÓRDÃO” → Selecione o Acórdão vinculante.+==== Fluxo 01 – Consultar com Filtros e Paginação ==== 
  
-Se Momento = “MONITORAMENTO” → Selecione o Processo vinculado. 
- 
-Mensagens de obrigatoriedade (exemplos reais do código): 
- 
-“O campo Estado é obrigatório.” 
- 
-“O campo Tipo é obrigatório.” 
- 
-“O campo Natureza é obrigatória.” 
- 
-“O campo Unidade Técnica é obrigatório.” 
- 
-“O campo Ação de Controle é obrigatório.” 
- 
-“O campo Marcador Temático é obrigatório.” 
- 
-“O campo Área Principal é obrigatório.” 
- 
-“Informe a Descrição do benefício.” 
- 
-===== 4. Fluxos ===== 
- 
-==== Fluxo 01 – Consultar com Filtros e Paginação ==== 
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
 |01|Usuário acessa o menu Consulta BACE.|—|Tela 01| |01|Usuário acessa o menu Consulta BACE.|—|Tela 01|
 |02|Expande Filtros, preenche critérios (processo, UT, situação, estado, tipo, intervalo de datas, “Exibir sem benefício”).|RN-C01, RN-C02|Tela 02| |02|Expande Filtros, preenche critérios (processo, UT, situação, estado, tipo, intervalo de datas, “Exibir sem benefício”).|RN-C01, RN-C02|Tela 02|
 |03|Sistema aplica filtros e reagrupa os resultados por Processo.|RN-C02|Tela 01| |03|Sistema aplica filtros e reagrupa os resultados por Processo.|RN-C02|Tela 01|
-|04|Usuário navega pela paginação e/ou altera itens/página.|RN-C03|Tela 01|+|04|Usuário navega pela paginação e-ou altera itens-página.|RN-C03|Tela 01|
  
-==== Fluxo 02 – Visualizar Benefício ====+ ==== Fluxo 02 – Visualizar Benefício ==== 
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
 |01|Usuário localiza o processo, expande o grupo e clica em Visualizar.|RN-C04|Tela 01| |01|Usuário localiza o processo, expande o grupo e clica em Visualizar.|RN-C04|Tela 01|
 |02|Sistema abre a Modal Visualizar Benefício com os dados do registro.|RN-C04|Tela 03| |02|Sistema abre a Modal Visualizar Benefício com os dados do registro.|RN-C04|Tela 03|
  
-==== Fluxo 03 – Editar Benefício ====+ ==== Fluxo 03 – Editar Benefício ==== 
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
 |01|Usuário clica em Editar no item desejado.|RN-C05|Tela 01| |01|Usuário clica em Editar no item desejado.|RN-C05|Tela 01|
 |02|Se o benefício for de lote, o sistema bloqueia a edição e exibe aviso informativo.|RN-C06|Tela 01| |02|Se o benefício for de lote, o sistema bloqueia a edição e exibe aviso informativo.|RN-C06|Tela 01|
-|03|Se permitido, sistema abre a BeneficioModal com os dados populados.|RN-C05|Tela 04|+|03|Se permitido, sistema abre a  BeneficioModal  com os dados populados.|RN-C05|Tela 04|
 |04|Usuário ajusta campos e salva.|RN-C07|Tela 04| |04|Usuário ajusta campos e salva.|RN-C07|Tela 04|
 |05|Sistema valida obrigatórios e vinculantes (conforme “Momento do registro”).|RN-C07, RN-C08|Tela 04| |05|Sistema valida obrigatórios e vinculantes (conforme “Momento do registro”).|RN-C07, RN-C08|Tela 04|
 |06|Estando correto, persiste alterações e atualiza a grid do processo.|RN-C07|Tela 01| |06|Estando correto, persiste alterações e atualiza a grid do processo.|RN-C07|Tela 01|
  
-==== Fluxo 04 – Excluir Registros ====+==== Fluxo 04 – Excluir Registros ==== 
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
 |01|Usuário clica em Excluir no benefício desejado.|RN-C09|Tela 01| |01|Usuário clica em Excluir no benefício desejado.|RN-C09|Tela 01|
Linha 154: Linha 117:
 |03|Confirmando, sistema remove o registro e recarrega o agrupamento.|RN-C09|Tela 01| |03|Confirmando, sistema remove o registro e recarrega o agrupamento.|RN-C09|Tela 01|
 |04|Para “Sem benefício”, o usuário clica em Excluir registro ‘Sem benefício’ no cabeçalho do processo.|RN-C10|Tela 01| |04|Para “Sem benefício”, o usuário clica em Excluir registro ‘Sem benefício’ no cabeçalho do processo.|RN-C10|Tela 01|
-|05|Sistema confirma e, aceito, remove o marcador “Sem benefício”.|RN-C10|Tela 01|+|05|Sistema confirma e, aceito, remove o marcador “Sem benefício”.|RN-C10|Tela 01|  
  
-===== 5. Regras de Negócio – Tela “Consulta BACE” =====+===== 5. Regras de Negócio – Tela “Consulta BACE” ===== 
 ^Regra___^Descrição| ^Regra___^Descrição|
-|RN-C01|A área de Filtros controla a listagem por: processo, situação, unidade técnica, tipo, estado, datas (início/fim) e inclusão de “Sem benefício”.| +|RN-C01|A área de Filtros controla a listagem por: processo, situação, unidade técnica, tipo, estado, datas (início/fim) e inclusão de “Sem benefício”.| | | | 
-|RN-C02|A filtragem ocorre no nível do grupo: um processo é exibido se qualquer registro do grupo atender aos filtros.| +|RN-C02|A filtragem ocorre no nível do grupo: um processo é exibido se qualquer registro do grupo atender aos filtros.| | | | 
-|RN-C03|A paginação é aplicada após a filtragem; o usuário pode alterar o tamanho de página.| +|RN-C03|A paginação é aplicada após a filtragem; o usuário pode alterar o tamanho de página.| | | | 
-|RN-C04|A ação Visualizar abre Modal Visualizar Benefício com dados do registro.| +|RN-C04|A ação Visualizar abre Modal Visualizar Benefício com dados do registro.| | | | 
-|RN-C05|A ação Editar abre a BeneficioModal populada, respeitando perfis/permissões.| +|RN-C05|A ação Editar abre a [[:pres:gerti:gestao_de_ativos:bace_2:cadastrarbeneficiomodalbeneficio#er_0021_modal_cadastrar_beneficio|BeneficioModal]] populada, respeitando perfis/permissões.| | | | 
-|RN-C06|Registros com origem de lote (idLote/origem === "lote") não podem ser editados pela lista; exibir aviso.| +|RN-C06|Registros com origem de lote (idLote/origem === "lote") não podem ser editados pela lista; exibir aviso.| | | | 
-|RN-C07|Salvamento valida obrigatórios (Estado, Tipo, Natureza, UT, Ação de Controle, Marcador Temático, Área Principal, Descrição).| +|RN-C07|Salvamento valida obrigatórios (Estado, Tipo, Natureza, UT, Ação de Controle, Marcador Temático, Área Principal, Descrição).| | | | 
-|RN-C08|Quando Momento do registro exige, são obrigatórios: Instrução vinculante (Momento = “INSTRUÇÃO TÉCNICA CONCLUSIVA”), Acórdão vinculante (Momento = “ACÓRDÃO”), Processo vinculado (Momento = “MONITORAMENTO”).| +|RN-C08|Quando Momento do registro exige, são obrigatórios: Instrução vinculante (Momento = “INSTRUÇÃO TÉCNICA CONCLUSIVA”), Acórdão vinculante (Momento = “ACÓRDÃO”), Processo vinculado (Momento = “MONITORAMENTO”).| | | | 
-|RN-C09|A ação Excluir de benefício requer confirmação; ao confirmar, o item é removido e a lista é atualizada.| +|RN-C09|A ação Excluir de benefício requer confirmação; ao confirmar, o item é removido e a lista é atualizada.| | | | 
-|RN-C10|A ação Excluir registro ‘Sem benefício’ (no cabeçalho do processo) requer confirmação e remove o marcador do processo.| +|RN-C10|A ação Excluir registro ‘Sem benefício’ (no cabeçalho do processo) requer confirmação e remove o marcador do processo.| | | | 
-|RN-C11|O Resumo (ⓘ) do processo é exibido em popover/portal ancorado no botão da coluna “Resumo”.| +|RN-C11|O Resumo (ⓘ) do processo é exibido em popover/portal ancorado no botão da coluna “Resumo”.| | | | 
-|RN-C12|O ID do benefício abre popover com a descrição do registro (portal ancorado no próprio ID).| +|RN-C12|O ID do benefício abre popover com a descrição do registro (portal ancorado no próprio ID).| | | |
- +
-===== 6. Mensagens do Sistema (exemplos reais) ===== +
- +
-“O campo Estado é obrigatório.” +
- +
-“O campo Tipo é obrigatório.” +
- +
-“O campo Natureza é obrigatória.” +
- +
-“O campo Unidade Técnica é obrigatório.” +
- +
-“O campo Ação de Controle é obrigatório.” +
- +
-“O campo Marcador Temático é obrigatório.” +
- +
-“O campo Área Principal é obrigatório.” +
- +
-“Informe a Descrição do benefício.” +
- +
-“Selecione a Instrução vinculante.” (quando Momento = Instrução) +
- +
-“Selecione o Acórdão vinculante.” (quando Momento = Acórdão) +
- +
-“Selecione o Processo vinculado.” (quando Momento = Monitoramento) +
- +
-“Confirmação: Remover o benefício {ID} do processo {Nº}?” +
- +
-“Confirmação: Remover o registro ‘Sem benefício’ do processo {Nº}?” +
- +
-===== 7. Integrações / Observações Técnicas ===== +
- +
-A tela usa agrupamento por processo e duas tabelas (cabeçalho do processo + grid interna de benefícios). +
- +
  
 +=====   =====
  
  
  • pres/gerti/gestao_de_ativos/bace_2/consultabace.1764184855.txt.gz
  • Última modificação: 26/11/2025 19:20
  • por jbmoraes