Essa é uma revisão anterior do documento!
12. Tela / Modal – 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
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.
Estrutura da Grid
| 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
A coluna Ação pode apresentar os seguintes valores:
| Tipo de Ação | Descrição do Evento |
|---|---|
| Incluiu benefício | Registro de um novo benefício vinculado ao processo |
| Alterou benefício | Alteração de informações do benefício existente (descrição, valor, natureza, etc.) |
| 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
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. Cada registro contém os metadados de identificação: usuário, setor, data/hora, ação e descrição contextual.
Regras de Negócio
- Cada linha da grid representa um evento único e irreversível do processo.
- O histórico não pode ser alterado nem excluído.
- As ações são ordenadas cronologicamente (mais recentes no topo).
- Cada ação fica permanentemente vinculada ao ID do processo e ao registro alterado (benefício, VRF ou jurisdicionado).
- O histórico exibe dados consolidados de todas as operações, incluindo exclusões e reaberturas.
- Apenas usuários autenticados e com acesso ao processo podem visualizar o histórico.
- Quando uma ação é automatizada (por regra de fluxo), o campo “Usuário” exibe “Sistema BACE”.
Regras de Interface
- 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.”*
Campos Adicionais Disponíveis (para auditoria)
Além das colunas visíveis, o histórico mantém metadados ocultos para fins de auditoria:
- Código do processo – Identificador único do processo fiscalizado.
- Tipo de registro afetado – Benefício, VRF, Jurisdicionado, Justificativa.
- Status anterior e posterior – Estado do registro antes e após a operação.
- 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
| 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
1. O usuário acessa a tela Cadastrar BACE e clica em Histórico. 2. O sistema abre a modal Histórico de Benefícios do Processo. 3. A grid é carregada com todas as ações registradas. 4. O usuário pode rolar a tabela ou exportar os dados (função administrativa). 5. Ao fechar a modal, o sistema mantém o estado da tela principal inalterado.
Exemplo de Registros Visíveis
| Usuário | Unidade Técnica | Data/Hora | Ação | ID/Registro | Descrição |
|---|---|---|---|---|---|
| Juciellen Moraes | DI-TI | 11/11/2025, 14:52:37 | Alterou benefício | MHDTRS4NLT860 | Atualização de valor e memória de cálculo |
| Juciellen Moraes | DI-TI | 04/11/2025, 15:30:22 | Excluiu benefício | MHKVAEL93FJ8WQN | Remoção de documento vinculado |
| Sistema BACE | - | 03/11/2025, 11:04:35 | Reabriu proposta | MHDTRS4NLT860 | Reabertura automática após revisão |
| Juciellen Moraes | DI-TI | 30/10/2025, 16:23:20 | Encerramento de proposta | MHDTRS4NLT860 | Encerrado por acórdão 194/2025 |
| Juciellen Moraes | DI-TI | 23/10/2025, 09:00:24 | Incluiu VRF | MHDGKPKQD6HESH | Cálculo de VRF adicionado ao processo |
| Sistema BACE | - | 22/10/2025, 21:11:54 | Incluiu jurisdicionado | ABC — Agência Brasil Central | Inclusão automática conforme interessado do processo |