pres:gerti:gestao_de_ativos:bace_2:hitoricoprocesso

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:hitoricoprocesso [14/11/2025 13:26] – ↷ Página movida e renomeada de user:jbmoraescadastrarhitoricoprocesso para pres:gerti:gestao_de_ativos:bace_2:hitoricoprocesso jbmoraespres:gerti:gestao_de_ativos:bace_2:hitoricoprocesso [25/11/2025 18:09] (atual) – jbmoraes
Linha 1: Linha 1:
-===== Tela / Modal – Histórico de Benefícios do Processo ===== +===== ER_002.0 – Modal / Tela – Histórico de Benefícios do Processo =====
- +
- +
-==== Contexto ==== +
-A tela **Histórico de Benefícios do Processo** é acessada a partir das ações de consulta na tela **Cadastrar BACE** e exibe, em formato de grade (grid), o **registro cronológico detalhado** de todas as operações realizadas sobre o processo selecionado. +
- +
-Esse histórico é de caráter **auditável e informativo**, não permitindo alteração de dados.   +
-Serve para rastrear quem fez, quando fez e qual alteração ocorreu, garantindo a transparência e integridade das informações.+
  
 ---- ----
  
-==== Objetivo ==== +==== 1. Descrição ====
-Registrar e exibir todas as interações realizadas em torno de um processo dentro do sistema BACE, abrangendo: +
-  * Inclusão, exclusão e alteração de **benefícios**; +
-  * Inclusão e exclusão de **VRFs (Volumes de Recursos Fiscalizados)**; +
-  * Inclusão, exclusão e alteração de **jurisdicionados**; +
-  * Ações de revisão, reabertura, encerramento e derivação de benefícios; +
-  * Qualquer modificação realizada em contexto de processo, identificando o autor, setor e data.+
  
----- +A **Modal Histórico de Benefícios do Processo** exibe, em formato tabular, o registro cronológico e auditável de todas as ações executadas dentro do processo selecionado.
- +
-==== Estrutura da Grid ====+
  
-{{ :pres:gerti:manuais:bace:historico_processo.png |}} +O histórico permite acompanhar quem realizou a ação, em qual unidade técnica, quando ocorreu e qual registro foi afetado, assegurando **transparência, rastreabilidade e integridade** dos dados do BACE.
-^ Coluna ^ Descrição ^ Regra e Comportamento ^ +
-| **Usuário** | Nome do servidor responsável pela ação | Preenchido automaticamente pelo sistema conforme login ativo no momento da ação | +
-| **Unidade Técnica** | Setor de lotação do usuário no momento da ação | Gravado automaticamente no log; não editável | +
-| **Data/Hora** | Data e hora exatas em que a ação foi registrada | Geração automática no instante da operação | +
-| **Ação** | Tipo da ação executada | Classificada conforme as operações (incluir, excluir, alterar, revisar, encerrar, reabrir, derivar, incluir VRF, excluir VRF, incluir jurisdicionado, excluir jurisdicionado etc.) | +
-| **ID/Registro** | Código identificador do registro afetado | Exibe o código interno (hash) do benefício, VRF ou jurisdicionado alterado | +
-| **Descrição** | Texto detalhado sobre a ação realizada | Pode conter justificativas, observações, ou informações complementares incluídas pelo usuário |+
  
 ---- ----
  
-==== Tipos de Ações Registradas ====+==== 2. Atores ====
  
-A coluna **Ação** pode apresentar os seguintes valores: +^Ator^Permissão no Histórico| 
- +|**Usuário** |Consulta somente registros vinculados à sua unidade| 
-^ Tipo de Ação ^ Descrição do Evento ^ +|**Auditor** |Consulta registros do processo dentro da UT| 
-| **Incluiu benefício** | Registro de um novo benefício vinculado ao processo | +|**Gestor** |Consulta completa do histórico do processo| 
-| **Alterou benefício** | Alteração de informações do benefício existente (descrição, valor, natureza, etc.) | +|**Administrador** |Consulta, auditoria e exportação|
-| **Excluiu benefício** | Exclusão lógica do benefício (mantido no histórico, mas removido da lista ativa) | +
-| **Incluiu VRF** | Registro de um novo Volume de Recursos Fiscalizados vinculado ao processo | +
-| **Alterou VRF** | Modificação de informações do VRF (valor, fonte, descrição etc.) | +
-| **Excluiu VRF** | Exclusão lógica do VRF cadastrado | +
-| **Incluiu jurisdicionado** | Adição de um jurisdicionado ao processo | +
-| **Excluiu jurisdicionado** | Remoção de um jurisdicionado vinculado | +
-| **Reabriu proposta** | Reversão de encerramento de benefício, retornando ao estado de elaboração | +
-| **Encerramento de proposta** | Conclusão formal do benefício com justificativa e acórdão | +
-| **Derivou benefício** | Criação de benefício derivado a partir de um revisado | +
-| **Revisou benefício** | Validação de um benefício pelo gestor ou unidade revisora | +
-| **Alterou descrição** | Atualização do texto ou justificativa do benefício | +
-| **Reverteu encerramento** | Retorno de um benefício encerrado para o estado anterior | +
-| **Incluiu ‘sem benefício’** | Registro da justificativa de processo sem benefício | +
-| **Excluiu ‘sem benefício’** | Remoção da justificativa ou reversão do status sem benefício |+
  
 ---- ----
  
-==== Origem dos Dados ==== +==== 3. Telas ====
-O histórico é alimentado automaticamente por **todas as ações disparadas no sistema** através das telas e modais de: +
-  * **Cadastrar Benefício** +
-  * **Cadastrar VRF** +
-  * **Marcar ‘Sem benefício’** +
-  * **Gerenciar Jurisdicionados** +
-  * **Encerrar / Reabrir / Derivar / Revisar Benefício**+
  
-Os eventos são armazenados na base de logs internos do sistema, com vínculo direto ao **ID do processo principal**.   +=== Tela 01 – Modal Histórico do Processo ===
-Cada registro contém os metadados de identificação: usuário, setor, data/hora, ação e descrição contextual.+
  
-----+{{  :pres:gerti:manuais:bace:historico_processo.png  |Tela 01 – Histórico }}
  
-==== Regras de Negócio ==== +^Elemento^Tipo^Obrigatório^Valores Possíveis^Observação| 
-  * Cada linha da grid representa **um evento único e irreversível** do processo. +|Usuário|Texto (somente leitura)|Sim|Nome do usuário|Gravado automaticamente| 
-  * O histórico não pode ser alterado nem excluído. +|Unidade Técnica|Texto (somente leitura)|Sim|UT no momento da ação|Não editável| 
-  * As ações são ordenadas cronologicamente (mais recentes no topo). +|Data/Hora|Texto (somente leitura)|Sim|dd/mm/yyyy hh:mm:ss|Registro fixo| 
-  * Cada ação fica permanentemente vinculada ao **ID do processo** e ao **registro alterado** (benefício, VRF ou jurisdicionado). +|Ação|Texto (somente leitura)|Sim|Lista de ações (ver tabela final)|Define o evento registrado| 
-  * O histórico exibe dados consolidados de todas as operações, incluindo exclusões e reaberturas. +|ID/Registro|Texto (somente leitura)|Sim|Hash interno|Identificador único| 
-  * Apenas usuários autenticados e com acesso ao processo podem visualizar o histórico. +|Descrição|Texto (somente leitura)|Não|Texto complementar|Pode conter justificativa|
-  * Quando uma ação é automatizada (por regra de fluxo), o campo “Usuário” exibe “Sistema BACE”.+
  
 ---- ----
  
-==== Regras de Interface ==== +==== 4. Fluxo 01 – Consultar Histórico do Processo ====
-  * A grid é apresentada em formato tabular e rolagem vertical (scroll). +
-  * A data/hora é exibida no formato **dd/mm/yyyy, hh:mm:ss**. +
-  * As ações são destacadas por **cores**, conforme o tipo de evento: +
-    - Verde → Inclusões   +
-    - Laranja → Alterações   +
-    - Vermelho → Exclusões   +
-    - Azul → Reaberturas / Revisões   +
-    - Cinza → Automáticas (sistema) +
-  * O botão **Fechar** encerra a modal sem alterar o estado do processo. +
-  * Quando não há registros, é exibida a mensagem: +
-    > *“Nenhuma ação registrada neste processo.”*+
  
----- +^Passo^Ação^Regra^Tela| 
- +|01|Usuário acessa **Cadastrar BACE** e seleciona a opção **Histórico**.|—|Tela Cadastrar BACE| 
-==== Campos Adicionais Disponíveis (para auditoria) ==== +|02|Sistema abre a **Modal Histórico de Benefícios do Processo**.|—|Tela 01| 
-Além das colunas visíveis, o histórico mantém metadados ocultos para fins de auditoria: +|03|Sistema carrega todas as ações registradas para o processo.|Ordem: do mais recente ao mais antigo|Tela 01| 
-  * **Código do processo** – Identificador único do processo fiscalizado. +|04|Usuário pode rolar a grade para consultar os eventos.|Somente leitura|Tela 01| 
-  * **Tipo de registro afetado** – Benefício, VRF, Jurisdicionado, Justificativa. +|05|Se perfil = Administrador → exibe a opção **Exportar histórico**.|Permissão específica|Tela 01| 
-  * **Status anterior e posterior** – Estado do registro antes e após a operação. +|06|Usuário clica em **Fechar**, encerrando a modal.|Nenhuma alteração ocorre no processo|Tela 01|
-  * **Origem da ação** – Tela ou módulo que gerou o evento. +
-  * **Hash de integridade** – Garantia de não alteração do log após gravação.+
  
 ---- ----
  
-==== Perfis e Permissões ==== +==== 5. Regras de Negócio ====
-^ Perfil ^ Acesso ao Histórico ^ +
-| Usuário | Leitura de registros do próprio setor | +
-| Auditor | Leitura de todos os registros do processo em sua unidade | +
-| Gestor | Leitura completa dos registros do processo sob sua supervisão | +
-| Administrador | Leitura total e exportação do histórico (relatórios ou auditorias) | +
- +
----- +
- +
-==== Mensagens e Alertas ==== +
-  * “Nenhuma ação registrada para este processo.” +
-  * “Histórico atualizado automaticamente.” +
-  * “Ação registrada com sucesso no log de auditoria.” +
-  * “Falha ao carregar histórico — tente novamente.” +
- +
-----+
  
-==== Fluxo Simplificado ==== +^Regra^Descrição| 
-1. O usuário acessa a tela **Cadastrar BACE** e clica em **Histórico**.   +|**RN-HIST-01** |Cada linha da grid representa um evento único, imutável e irreversível.| 
-2. O sistema abre a modal **Histórico de Benefícios do Processo**.   +|**RN-HIST-02** |O histórico não pode ser editado nem excluído.| 
-3. A grid é carregada com todas as ações registradas.   +|**RN-HIST-03** |A listagem deve ser exibida em ordem cronológica decrescente.| 
-4. O usuário pode rolar a tabela ou exportar os dados (função administrativa).   +|**RN-HIST-04** |Toda ação permanece vinculada ao ID do processo e ao ID do registro afetado.| 
-5. Ao fechar a modal, o sistema mantém o estado da tela principal inalterado.+|**RN-HIST-05** |O sistema deve registrar ações de inclusão, alteração, exclusão, revisão, derivação, reabertura e encerramento.| 
 +|**RN-HIST-06** |Somente usuários autenticados e com acesso ao processo podem visualizar o histórico.| 
 +|**RN-HIST-07** |Toda ação registrada deve conter usuário, data/hora, ação e descrição contextual.| 
 +|**RN-HIST-08** |Exclusões permanecem visíveis como registros históricos.| 
 +|**RN-HIST-09** |Reaberturas, revisões e encerramentos são registrados como eventos independentes.| 
 +|**RN-HIST-10** |Quando não houver registros, o sistema deve exibir: *“Nenhuma ação registrada para este processo.”*| 
 +|**RN-HIST-12** |Em sucesso de log, registrar internamente: *“Ação registrada com sucesso no log de auditoria.”*| 
 +|**RN-HIST-13** |Em erro de carregamento, informar ao usuário: *“Falha ao carregar histórico — tente novamente.”*| 
 +|**RN-HIST-14** |As ações devem receber cores conforme o tipo: **Verde** → Inclusões - **Laranja** → Alterações - **Vermelho** → Exclusões - **Azul** → Revisões / Reaberturas - **Cinza** → Encerramento beneficio| 
 +|**RN-HIST-15** |O botão **Fechar** encerra a modal sem alteração no processo principal.|
  
 ---- ----
  
-==== Exemplo de Registros Visíveis ====+==== 6. Tipos de Ações Registradas ====
  
-^ Usuário ^ Unidade Técnica ^ Data/Hora ^ Ação ^ ID/Registro ^ Descrição ^ +^Tipo de Ação^Descrição do Evento| 
-| Juciellen Moraes | DI-TI | 11/11/2025, 14:52:37 | Alterou benefício | MHDTRS4NLT860 | Atualização de valor e memória de cálculo | +|**Incluiu benefício** |Registro de um novo benefício vinculado ao processo| 
-| Juciellen Moraes | DI-TI | 04/11/2025, 15:30:22 | Excluiu benefício | MHKVAEL93FJ8WQN | Remoção de documento vinculado | +|**Alterou benefício** |Modificação de informações de um benefício| 
-| Sistema BACE | - | 03/11/2025, 11:04:35 | Reabriu proposta | MHDTRS4NLT860 | Reabertura automática após revisão | +|**Excluiu benefício** |Exclusão lógica (registrada, mas não removida)| 
-| Juciellen Moraes | DI-TI | 30/10/2025, 16:23:20 | Encerramento de proposta | MHDTRS4NLT860 | Encerrado por acórdão 194/2025 | +|**Incluiu VRF** |Cadastro de um Volume de Recursos Fiscalizados| 
-| Juciellen Moraes | DI-TI | 23/10/2025, 09:00:24 | Incluiu VRF | MHDGKPKQD6HESH | Cálculo de VRF adicionado ao processo | +|**Alterou VRF** |Modificação de dados do VRF| 
-| Sistema BACE | - | 22/10/2025, 21:11:54 | Incluiu jurisdicionado | ABC — Agência Brasil Central | Inclusão automática conforme interessado do processo |+|**Excluiu VRF** |Exclusão lógica do VRF| 
 +|**Incluiu jurisdicionado** |Inclusão de jurisdicionado no processo| 
 +|**Excluiu jurisdicionado** |Remoção de jurisdicionado| 
 +|**Reabriu proposta** |Retorno de benefício ao estado de edição| 
 +|**Encerramento de proposta** |Conclusão formal do benefício| 
 +|**Derivou benefício** |Criação de benefício derivado a partir de um revisado| 
 +|**Revisou benefício** |Ação de revisão pelo gestor| 
 +|**Alterou descrição** |Atualização textual do benefício| 
 +|**Reverteu encerramento** |Retorno de benefício encerrado ao estado anterior| 
 +|**Incluiu ‘sem benefício’** |Registro de processo sem benefício| 
 +|**Excluiu ‘sem benefício’** |Remoção ou reversão dessa justificativa|
  
  
  • pres/gerti/gestao_de_ativos/bace_2/hitoricoprocesso.1763126792.txt.gz
  • Última modificação: 14/11/2025 13:26
  • por jbmoraes