===== 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 ==== {{ :pres:gerti:manuais:bace:historico_processo.png |}} ^ 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 |