Diferenças

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

--- pres:gerti:gestao_de_ativos:bace_2:cadastrarhitoricobenf [14/11/2025 13:25] – ↷ Página movida e renomeada de user:jbmoraescadastrarhitoricobenf para pres:gerti:gestao_de_ativos:bace_2:cadastrarhitoricobenf jbmoraes
+++ pres:gerti:gestao_de_ativos:bace_2:cadastrarhitoricobenf [25/11/2025 19:04] (atual) – jbmoraes
@@ Linha 1: / Linha 1: @@
-=====  Modal – Histórico do Benefício =====
+Textinho limpo, redondo e formal.
-==== Contexto ====
+===== ER_002.3 – Histórico do Benefício =====
-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.
-----
+==== 1. Descrição ====
+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.
-==== Objetivo ====
+A visualização é exclusivamente de leitura, permitindo auditoria completa das modificações e garantindo rastreabilidade total.
-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 ====
+==== 2. Atores ====
+^ Ator          ^ Permissão                                                                 |
-{{ :user:historico_beneficio.png |}}
+| 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.              |
-^ Coluna ^ Descrição ^ Regras / Comportamento ^
+| Gestor        | Consulta total dos históricos dos benefícios sob sua supervisão.          |
-| **Usuário** | Exibe o nome do usuário que realizou a ação. | Capturado automaticamente a partir do login autenticado. |
+| Administrador | Acesso total a todos os históricos, inclusive de outras unidades.         |
-| **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 ====
+==== 3. Telas ====
-A modal registra automaticamente alterações nos seguintes campos do formulário de benefício:
-  * Estado
+=== Tela 01 – Modal Histórico do Benefício ====
-  * 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.
+{{ :user:historico_beneficio.png |}}
-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 ====
+^ Elemento             ^ Tipo         ^ Obrigatório ^ Valores Possíveis                                       ^ Valor Padrão ^ Observações |
-  * A cada **inclusão, edição, derivação ou encerramento**, é criada automaticamente uma entrada no histórico.
+| Título da Modal      | Texto fixo   | Sim          | “Histórico do benefício [ID]”                          | —             | Exibe automaticamente o ID do benefício. |
-  * O histórico é **imutável** — não pode ser alterado ou excluído manualmente por nenhum perfil de usuário.
+| Usuário              | Grid/Coluna  | Sim          | Nome do usuário autenticado                            | —             | Registrado no momento da ação. |
-  * A **primeira linha** sempre representa a **criação do benefício**, com ação “Inclusão de Benefício”.
+| Unidade Técnica      | Grid/Coluna  | Sim          | Sigla da UT                                             | —             | Capturada da lotação do usuário no momento da ação. |
-  * As ações seguintes são listadas em ordem **cronológica decrescente**, com o registro mais recente no topo.
+| Data/Hora            | Grid/Coluna  | Sim          | DD/MM/AAAA HH:MM:SS                                     | —             | Timestamp exato da operação. |
-  * Alterações simultâneas em vários campos são agrupadas na mesma linha, exibindo todos os campos modificados.
+| Ação                 | Grid/Coluna  | Sim          | Inclusão, Alteração, Revisão, Encerramento, Derivação… | —             | Determinada pela operação executada. |
-  * 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.
+| Dados Modificados    | Grid/Coluna  | Não          | Nome dos campos alterados                               | —             | Exibe somente os campos afetados. |
-  * Campos não preenchidos são representados com “—”.
+| 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. |
 ----
-==== Regras de Interface ====
+==== 4. Fluxos ====
-  * 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.
-----
+=== Fluxo 01 – Consultar Histórico do Benefício ====
-==== Regras de Segurança e Permissões ====
+^ Passo ^ Ação ^ Regra |
-^ Perfil         ^ Permissão                                                                              ^
+| 01 | Usuário clica no ícone **Histórico** na grid de benefícios. | Modal é acionada somente para leitura. |
-| Usuário        | Leitura de histórico apenas para benefícios da sua unidade técnica.                    |
+| 02 | Sistema abre a modal **Histórico do Benefício**. | O título exibe o ID do benefício carregado. |
-| Auditor        | Leitura total dos históricos de benefícios da sua unidade técnica.                     |
+| 03 | Sistema carrega todos os eventos registrados para o benefício. | Ordem cronológica decrescente. |
-| Gestor         | Leitura total de históricos dos benefícios sob sua unidade técnica                     |
+| 04 | Usuário navega pela grid usando rolagem horizontal e vertical. | Exibe múltiplas entradas e múltiplos campos alterados. |
-| Administrador  | Acesso completo a todos os históricos de benefícios, inclusive de unidades distintas.  |
+| 05 | Usuário clica em **Fechar**. | Modal é encerrada sem alterar registros. |
-Nenhum perfil possui permissão de exclusão ou alteração de histórico.
 ----
-==== Mensagens e Alertas ====
+==== 5. Regras de Negócio (Tabela Sequencial) ====
-  * “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.
-----
+^ 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. |
-==== Impactos e Finalidade ====
+| RN-HB02 | O histórico é imutável e não pode ser alterado ou excluído por nenhum perfil de usuário. |
-  * Garante a **rastreabilidade completa** de todas as alterações realizadas nos benefícios registrados.
+| RN-HB03 | A primeira linha do histórico deve sempre representar a inclusão inicial do benefício. |
-  * Serve como base para **auditorias internas** e **controle de integridade dos dados**.
+| RN-HB04 | Os registros devem ser exibidos em ordem cronológica decrescente (mais recente primeiro). |
-  * Os dados são utilizados em relatórios de controle e no painel de conformidade do BACE.
+| RN-HB05 | Alterações simultâneas em mais de um campo devem ser agrupadas em uma única entrada no histórico. |
-  * O histórico é exibido tanto na tela do benefício quanto no histórico geral do processo.
+| 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. |
 ----
-**Exemplo de Registro de Histórico:**
+==== 6. Lista de Campos Auditados ====
+O histórico registra alterações nos seguintes campos:
-| Usuário | Unidade Técnica | Data/Hora | Ação | Campo | Situação Anterior | Situação Atual |
+  * Estado
-|----------|----------------|-----------|-------|--------|-------------------|----------------|
+  * Unidade Técnica
-| Juciellen Moraes | DI-TI | 03/11/2025 09:46:13 | Alteração de Campo | Situação Interna | Em elaboração | Revisado |
+  * Momento do Registro
-| Juciellen Moraes | DI-TI | 03/11/2025 08:56:35 | Inclusão de Benefício | Estado, Tipo, Valor, Natureza... | — | Dados iniciais cadastrados |
+  * Documento Vinculante
+  * Ação de Controle
+  * Marcador Temático
+  * Área Principal
+  * Áreas Secundárias
+  * Tipo
+  * Subtipo
+  * Natureza
+  * Valor (R$)
+  * Memória de Cálculo
+  * Descrição
+  * Unidade de Medida
+  * Situação Interna
+  * Anexos
+Cada alteração gera uma linha específica com comparação entre a situação anterior e atual.