===== ER_002.0 – Modal / Tela – Histórico de Benefícios do Processo =====

----

==== 1. Descrição ====

A **Modal Histórico de Benefícios do Processo** exibe, em formato tabular, o registro cronológico e auditável de todas as ações executadas dentro do processo selecionado.

O histórico permite acompanhar quem realizou a ação, em qual unidade técnica, quando ocorreu e qual registro foi afetado, assegurando **transparência, rastreabilidade e integridade** dos dados do BACE.

----

==== 2. Atores ====

^ Ator               ^ Permissão no Histórico                               ^
| **Auditor**        | Consulta somente registros vinculados à sua unidade  |
| **Coordenador**    | Consulta registros do processo dentro da UT          |
| **Supervisor**     | Consulta completa do histórico do processo           |
| **Administrador**  | Consulta, auditoria e exportação                     |

----

==== 3. Telas ====

=== Tela 01 – Modal Histórico do Processo ===

{{  :pres:gerti:manuais:bace:historico_processo.png  |Tela 01 – Histórico }}

^Elemento^Tipo^Obrigatório^Valores Possíveis^Observação|
|Usuário|Texto (somente leitura)|Sim|Nome do usuário|Gravado automaticamente|
|Unidade Técnica|Texto (somente leitura)|Sim|UT no momento da ação|Não editável|
|Data/Hora|Texto (somente leitura)|Sim|dd/mm/yyyy hh:mm:ss|Registro fixo|
|Ação|Texto (somente leitura)|Sim|Lista de ações (ver tabela final)|Define o evento registrado|
|ID/Registro|Texto (somente leitura)|Sim|Hash interno|Identificador único|
|Descrição|Texto (somente leitura)|Não|Texto complementar|Pode conter justificativa|

----

==== 4. Fluxo 01 – Consultar Histórico do Processo ====

^Passo^Ação^Regra^Tela|
|01|Usuário acessa **Cadastrar BACE** e seleciona a opção **Histórico**.|—|Tela Cadastrar BACE|
|02|Sistema abre a **Modal Histórico de Benefícios do Processo**.|—|Tela 01|
|03|Sistema carrega todas as ações registradas para o processo.|Ordem: do mais recente ao mais antigo|Tela 01|
|04|Usuário pode rolar a grade para consultar os eventos.|Somente leitura|Tela 01|
|05|Se perfil = Administrador → exibe a opção **Exportar histórico**.|Permissão específica|Tela 01|
|06|Usuário clica em **Fechar**, encerrando a modal.|Nenhuma alteração ocorre no processo|Tela 01|

----

==== 5. Regras de Negócio ====

^Regra^Descrição|
|**RN-HIST-01** |Cada linha da grid representa um evento único, imutável e irreversível.|
|**RN-HIST-02** |O histórico não pode ser editado nem excluído.|
|**RN-HIST-03** |A listagem deve ser exibida em ordem cronológica decrescente.|
|**RN-HIST-04** |Toda ação permanece vinculada ao ID do processo e ao ID do registro afetado.|
|**RN-HIST-05** |O sistema deve registrar ações de inclusão, alteração, exclusão, revisão, derivação, reabertura e encerramento.|
|**RN-HIST-06** |Somente usuários autenticados e com acesso ao processo podem visualizar o histórico.|
|**RN-HIST-07** |Toda ação registrada deve conter usuário, data/hora, ação e descrição contextual.|
|**RN-HIST-08** |Exclusões permanecem visíveis como registros históricos.|
|**RN-HIST-09** |Reaberturas, revisões e encerramentos são registrados como eventos independentes.|
|**RN-HIST-10** |Quando não houver registros, o sistema deve exibir: *“Nenhuma ação registrada para este processo.”*|
|**RN-HIST-12** |Em sucesso de log, registrar internamente: *“Ação registrada com sucesso no log de auditoria.”*|
|**RN-HIST-13** |Em erro de carregamento, informar ao usuário: *“Falha ao carregar histórico — tente novamente.”*|
|**RN-HIST-14** |As ações devem receber cores conforme o tipo: **Verde** → Inclusões - **Laranja** → Alterações - **Vermelho** → Exclusões - **Azul** → Revisões / Reaberturas - **Cinza** → Encerramento beneficio|
|**RN-HIST-15** |O botão **Fechar** encerra a modal sem alteração no processo principal.|

----

==== 6. Tipos de Ações Registradas ====

^ Tipo de Ação                  ^ Descrição do Evento                                    ^
| **Incluiu benefício**         | Registro de um novo benefício vinculado ao processo    |
| **Alterou benefício**         | Modificação de informações de um benefício             |
| **Excluiu benefício**         | Exclusão lógica (registrada, mas não removida)         |
| **Incluiu VRF**               | Cadastro de um Volume de Recursos Fiscalizados         |
| **Alterou VRF**               | Modificação de dados do VRF                            |
| **Excluiu VRF**               | Exclusão lógica do VRF                                 |
| **Incluiu jurisdicionado**    | Inclusão de jurisdicionado no processo                 |
| **Excluiu jurisdicionado**    | Remoção de jurisdicionado                              |
| **Reabriu proposta**          | Retorno de benefício ao estado de edição               |
| **Encerramento de proposta**  | Conclusão formal do benefício                          |
| **Derivou benefício**         | Criação de benefício derivado a partir de um revisado  |
| **Revisou benefício**         | Ação de revisão pelo supervisor                        |
| **Alterou descrição**         | Atualização textual do benefício                       |
| **Reverteu encerramento**     | Retorno de benefício encerrado ao estado anterior      |
| **Incluiu ‘sem benefício’**   | Registro de processo sem benefício                     |
| **Excluiu ‘sem benefício’**   | Remoção ou reversão dessa justificativa                |