ER_002.3 – Histórico do Benefício [Wiki TCE-GO]

Essa é uma revisão anterior do documento!

Textinho limpo, redondo e formal.

A modal Histórico do Benefício apresenta todas as ações realizadas sobre um benefício específico, registrando cada evento do ciclo de vida do benefício — criação, alterações, revisões, encerramentos, derivação, entre outros. A visualização é exclusivamente de leitura, permitindo auditoria completa das modificações e garantindo rastreabilidade total.

Ator	Permissão
Usuário	Consulta aos históricos de benefícios vinculados à sua Unidade Técnica.
Auditor	Consulta total dos históricos dentro de sua Unidade Técnica.
Gestor	Consulta total dos históricos dos benefícios sob sua supervisão.
Administrador	Acesso total a todos os históricos, inclusive de outras unidades.

Tela 01 – Modal Histórico do Benefício

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.

Elemento	Tipo	Obrigatório	Valores Possíveis	Valor Padrão	Observações
Título da Modal	Texto fixo	Sim	“Histórico do benefício [ID]”	—	Exibe automaticamente o ID do benefício.
Usuário	Grid/Coluna	Sim	Nome do usuário autenticado	—	Registrado no momento da ação.
Unidade Técnica	Grid/Coluna	Sim	Sigla da UT	—	Capturada da lotação do usuário no momento da ação.
Data/Hora	Grid/Coluna	Sim	DD/MM/AAAA HH:MM:SS	—	Timestamp exato da operação.
Ação	Grid/Coluna	Sim	Inclusão, Alteração, Revisão, Encerramento, Derivação…	—	Determinada pela operação executada.
Dados Modificados	Grid/Coluna	Não	Nome dos campos alterados	—	Exibe somente os campos afetados.
Situação Anterior	Grid/Coluna	Não	Valores anteriores	—	Exibe “—” quando é inclusão inicial.
Situação Atual	Grid/Coluna	Sim	Valores resultantes da ação	—	Exibida sempre para cada registro.
Barra de Rolagem	Scroll	—	—	—	Horizontal e vertical.
Botão “Fechar”	Botão	Sim	Clique	—	Fecha a modal sem alterar dados.

Fluxo 01 – Consultar Histórico do Benefício

Passo	Ação	Regra
01	Usuário clica no ícone Histórico na grid de benefícios.	Modal é acionada somente para leitura.
02	Sistema abre a modal Histórico do Benefício.	O título exibe o ID do benefício carregado.
03	Sistema carrega todos os eventos registrados para o benefício.	Ordem cronológica decrescente.
04	Usuário navega pela grid usando rolagem horizontal e vertical.	Exibe múltiplas entradas e múltiplos campos alterados.
05	Usuário clica em Fechar.	Modal é encerrada sem alterar registros.

Código	Regra
RN-HB01	Toda ação de criação, edição, revisão, derivação, encerramento ou exclusão lógica deve gerar registro no histórico.
RN-HB02	O histórico é imutável e não pode ser alterado ou excluído por nenhum perfil de usuário.
RN-HB03	A primeira linha do histórico deve sempre representar a inclusão inicial do benefício.
RN-HB04	Os registros devem ser exibidos em ordem cronológica decrescente (mais recente primeiro).
RN-HB05	Alterações simultâneas em mais de um campo devem ser agrupadas em uma única entrada no histórico.
RN-HB06	Quando não houver valor anterior para o campo, deve ser exibido “—”.
RN-HB07	Ações automáticas do sistema devem registrar o usuário como “Sistema BACE”.
RN-HB08	Cada ação deve registrar Situação Anterior e Situação Atual sempre que aplicável.
RN-HB09	A modal deve sempre exibir a versão mais recente e consolidada dos dados do benefício.
RN-HB10	Situação Anterior deve ser exibida em vermelho para facilitar contraste visual.
RN-HB11	Situação Atual deve ser exibida em verde para destacar o novo valor salvo.
RN-HB12	A grid deve possuir rolagem horizontal e vertical quando houver excesso de dados.
RN-HB13	Em alterações múltiplas, os campos modificados devem ser apresentados com quebra de linha.
RN-HB14	Não deve existir qualquer botão de edição, remoção ou ação dentro da modal.
RN-HB15	A modal deve ser encerrada exclusivamente através do botão Fechar.
RN-HB16	Se não houver registros no histórico, exibir: “Nenhum histórico encontrado para este benefício.”
RN-HB17	Quando o histórico for carregado com sucesso, registrar internamente: “Histórico carregado com sucesso.”
RN-HB18	Em caso de erro de carregamento, exibir: “Falha ao carregar histórico.”
RN-HB19	O histórico deve garantir rastreabilidade completa das ações executadas sobre o benefício.
RN-HB20	Os dados registrados devem estar aptos a auditorias internas e externas.
RN-HB21	Os registros devem alimentar relatórios institucionais e o painel de conformidade.
RN-HB22	O histórico do benefício deve ser integrado ao histórico geral do processo correspondente.