Essa é uma revisão anterior do documento!
Modal – Histórico do Benefício
Contexto
A modal Histórico do Benefício exibe todas as ações realizadas sobre um benefício específico, apresentando de forma detalhada o ciclo de vida do registro — desde a criação até revisões, encerramentos e alterações de campos. Ela funciona como o repositório de rastreabilidade do sistema, garantindo transparência e auditoria das modificações realizadas por cada usuário.
Objetivo
Permitir que auditores, gestores e administradores consultem quem alterou o benefício, quando, o que foi modificado e qual era o valor anterior e o atual de cada campo.
Estrutura da Grid
| Coluna | Descrição | Regras / Comportamento |
|---|---|---|
| Usuário | Exibe o nome do usuário que realizou a ação. | Capturado automaticamente a partir do login autenticado. |
| Unidade Técnica | Indica a unidade técnica de lotação do usuário que executou a ação. | Sempre preenchida com a sigla da UT. |
| Data/Hora | Data e hora exatas da ação. | Registradas no momento da confirmação da operação; formato: DD/MM/AAAA, HH:MM:SS. |
| Ação | Tipo de operação executada. | Exemplos: Inclusão de Benefício, Alteração de Campo, Encerramento, Derivação, Exclusão. |
| Dados Modificados | Lista de campos alterados ou criados na ação. | Mostra apenas os campos afetados pela transação. |
| Situação Anterior | Valor do campo antes da modificação. | Exibe “—” quando é inclusão inicial. |
| Situação Atual | Valor atualizado após a modificação. | Mostra o novo valor salvo no registro. |
Campos Auditados
A modal registra automaticamente alterações nos seguintes campos do formulário de benefício:
- Estado
- Unidade Técnica
- Momento do Registro
- Documento Vinculante (Instrução ou Acórdão)
- Ação de Controle
- Marcador Temático
- Área Principal e Secundária
- Tipo
- Subtipo
- Natureza
- Valor (R$)
- Memória de Cálculo
- Descrição
- Unidade de Medida
- Situação Interna
- Anexos
Todos os campos acima são rastreados individualmente. Cada modificação gera uma nova linha no histórico com ação “Alteração de Campo” e apresenta lado a lado o valor anterior e o novo valor.
Regras de Registro do Histórico
- A cada inclusão, edição, derivação ou encerramento, é criada automaticamente uma entrada no histórico.
- O histórico é imutável — não pode ser alterado ou excluído manualmente por nenhum perfil de usuário.
- A primeira linha sempre representa a criação do benefício, com ação “Inclusão de Benefício”.
- As ações seguintes são listadas em ordem cronológica decrescente, com o registro mais recente no topo.
- Alterações simultâneas em vários campos são agrupadas na mesma linha, exibindo todos os campos modificados.
- Caso a ação tenha origem em uma operação derivada (por exemplo, “Encerrar Proposta” ou “Derivar Benefício”), o tipo de ação é exibido conforme o evento principal executado.
- Campos não preenchidos são representados com “—”.
Regras de Interface
- A modal é aberta a partir do ícone “Histórico” na grid de benefícios.
- O título exibe o identificador do benefício:
> “Histórico do benefício [ID do Benefício]”
- As colunas possuem largura fixa e rolagem horizontal automática.
- O botão Fechar encerra a visualização sem alterar o histórico.
- Os textos da coluna “Situação Atual” são exibidos em verde, e os da “Situação Anterior” em vermelho, para facilitar a distinção visual.
- Alterações com múltiplos campos são agrupadas e exibidas com quebra de linha entre os nomes dos campos.
- Não há botões de ação — o histórico é apenas de leitura.
Regras de Segurança e Permissões
| Perfil | Permissão |
|---|---|
| Usuário | Leitura de histórico apenas para benefícios da sua unidade técnica. |
| Auditor | Leitura total dos históricos de benefícios da sua unidade técnica. |
| Gestor | Leitura total de históricos dos benefícios sob sua unidade técnica |
| Administrador | Acesso completo a todos os históricos de benefícios, inclusive de unidades distintas. |
Nenhum perfil possui permissão de exclusão ou alteração de histórico.
Mensagens e Alertas
- “Nenhum histórico encontrado para este benefício.” → Exibido quando o benefício é novo e não sofreu alterações.
- “O histórico foi carregado com sucesso.” → Mensagem padrão de carregamento.
- “Falha ao carregar histórico.” → Exibido apenas em caso de erro de comunicação com o servidor.
Impactos e Finalidade
- Garante a rastreabilidade completa de todas as alterações realizadas nos benefícios registrados.
- Serve como base para auditorias internas e controle de integridade dos dados.
- Os dados são utilizados em relatórios de controle e no painel de conformidade do BACE.
- O histórico é exibido tanto na tela do benefício quanto no histórico geral do processo.
Exemplo de Registro de Histórico:
| Usuário | Unidade Técnica | Data/Hora | Ação | Campo | Situação Anterior | Situação Atual |
| ———- | —————- | ———– | ——- | ——– | ——————- | —————- |
| Juciellen Moraes | DI-TI | 03/11/2025 09:46:13 | Alteração de Campo | Situação Interna | Em elaboração | Revisado |
| Juciellen Moraes | DI-TI | 03/11/2025 08:56:35 | Inclusão de Benefício | Estado, Tipo, Valor, Natureza… | — | Dados iniciais cadastrados |
