Diferenças

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

--- pres:gerti:gestao_de_ativos:bace_2:derivacaobenfi [14/11/2025 13:26] – removida - edição externa (Data desconhecida) 127.0.0.1
+++ pres:gerti:gestao_de_ativos:bace_2:derivacaobenfi [05/02/2026 17:01] (atual) – [Table] jbmoraes
@@ Linha 1: / Linha 1: @@
+===== ER_002.4 – Modal Benefício (Modo “Derivação de Benefício”) =====
+==== 1. Descrição ====
+A modal **Derivação de Benefício** permite criar um novo benefício vinculado a um benefício principal já revisado.
+É utilizada quando decisões ou análises geram desdobramentos que precisam ser registrados como um novo benefício, mantendo relação direta com o registro original.
+A modal herda dados do benefício principal e permite ajustes conforme as regras do fluxo.
+----
+==== 2. Atores ====
+^ Ator          ^ Permissão                                                                 |
+| Usuário       | Sem permissão para derivar benefícios.                                    |
+| Auditor       | Pode criar benefício derivado e editar campos permitidos durante “Em elaboração”. |
+| Gestor        | Pode criar derivação, editar campos permitidos e retornar benefícios para “Em elaboração”. |
+| Administrador | Pode criar, editar e excluir benefícios derivados em qualquer situação.   |
+----
+==== 3. Telas ====
+=== Tela 01 – Modal Derivação de Benefício ====
+{{ :user:derivacao_quantivativo_nao_financeiro.png |}}
+=== 3.1 Elementos da Tela ====
+^ Elemento             ^ Tipo           ^ Obrigatório  ^ Valores Possíveis                   ^ Valor Padrão           ^ Observações                                     ^
+| BACE Principal       | Texto leitura  | Sim          | ID do benefício principal           | —                      | Sempre somente leitura.                         |
+| Estado               | Combobox       | Sim          | Proposta / Potencial / Efetivo      | Conforme origem        | Transições limitadas por regras de derivação.   |
+| Momento do registro  | Combobox       | Sim          | ITC / Acórdão / Relatório / Outros  | Dependente do Estado   | Limpa valores incompatíveis ao alterar Estado.  |
+| Quantidade / Valor   | Numérico       | Sim          | ≥ 0                                 | Herdado da origem      | Editável conforme decisão do colegiado.         |
+| Memória de Cálculo   | Texto          | Sim          | Livre                               | Herdado da origem      | Campo obrigatório Editável conforme decisão.    |
+| Descrição            | Texto          | Sim          | Livre                               | Herdada da origem      | Campo obrigatório.                              |
+| Situação Interna     | Combobox       | Sim          | Em elaboração / Revisado / Outros   | Em elaboração          | Pode ser alterada após criação.                 |
+| Botão Salvar         | Botão          | —            | Clique                              | —                      | Cria benefício derivado.                        |
+| Botão Cancelar       | Botão          | —            | Clique                              | —                      | Fecha sem gerar derivação.                      |
+| Anexos               | Botão          | —            | Clique                              | Herda conforme origem  | Pode ser editável, inserindo mais anexos        |
+----
+==== 4. Fluxos ====
+=== Fluxo 01 – Criar Benefício Derivado ====
+^ Passo ^ Ação ^ Regra ^ Tela |
+| 01 | Usuário clica no ícone **Derivar** na grid de benefícios. | RN-D01 | Tela 01 |
+| 02 | Sistema verifica se o benefício está **Revisado**, não está em **Efetivo** e não possui derivado ativo. | RN-D01, RN-D02 | Tela 01 |
+| 03 | Se violadas, pode ocorrer de algum outro usuário acessar e derivar em outra seção exibe: “Não é possível derivar este benefício.” | RN-D10 | Tela 01 |
+| 04 | Sistema abre a **Modal Derivação**, com **BACE Principal** em somente leitura. | RN-D03 | Tela 01|
+| 05 | Sistema preenche campos herdados do principal e define Situação = **Em elaboração**. | RN-D03, RN-D07 | Tela 01 |
+| 06 | Sistema sugere o novo Estado conforme transição válida. | RN-D04 | Tela 01|
+| 07 | Ao alterar Estado, sistema atualiza **Momento** e limpa vinculantes incompatíveis. | RN-D05 | Tela 01 |
+| 08 | Usuário ajusta valores, estado, momento e situação conforme permitido. | RN-D06, RN-D07 | Tela 01 |
+| 09 | Usuário clica **Salvar**. | RN-D08 | Tela 01 |
+| 10 | Sistema valida regras de derivação e obrigatoriedade. | RN-D01, RN-D02, RN-D04, RN-D05, RN-D06, RN-D11 | Tela 01|
+| 11 | Sistema cria benefício derivado, registra vínculo, grava histórico e atualiza grid. | RN-D08, RN-D09 | Tela 01 |
+| 12 | Havendo erro, sistema mantém modal aberta e destaca campos inválidos. | RN-D10 | Tela 01|
+| 13 | Se usuário clicar **Cancelar**, modal é fechada sem alterações. | RN-D08 |Tela 01 |
+----
+==== 5. Regras de Negócio – Derivação de Benefício (Tabela Sequencial) ====
+^ Código ^ Regra |
+| RN-D01 | Apenas benefícios com Situação **Revisado** e Estado diferente de **Efetivo** exibem o ícone Derivar. |
+| RN-D02 | Um benefício principal só pode ter **um derivado ativo**. Caso exista, o sistema bloqueia nova derivação. |
+| RN-D03 | O derivado herda automaticamente: processo, UT, ação de controle, marcador, áreas, tipo, subtipo, natureza, valor/quantidade, memória de cálculo e descrição. |
+| RN-D04 | Transição de Estados permitida: **Proposta ⇒ Potencial ou Efetivo**, **Potencial ⇒ Efetivo**, **Efetivo ⇒ bloqueado**. |
+| RN-D05 | Momento do registro deve ser compatível com o Estado. Momentos/documentos incompatíveis devem ser limpos ao alterar o Estado. |
+| RN-D06 | Valor/Quantidade são copiados do principal, porém obrigatórios e totalmente editáveis. |
+| RN-D07 | Situação interna do derivado inicia como **Em elaboração**, modificável posteriormente por regras gerais. |
+| RN-D08 | Ao salvar, o sistema cria o derivado, registra o vínculo e fecha a modal; ao cancelar, fecha sem criar registro. |
+| RN-D09 | A criação do derivado gera registros automáticos no Histórico do Benefício e Histórico do Processo. |
+| RN-D10 | Quando as condições de derivação forem violadas, exibir: **“Não é possível derivar este benefício.”** |
+| RN-D11 | Regras de permissão: Usuário – sem acesso; Auditor – cria derivado; Gestor – cria e retorna para edição; Administrador – cria, edita e exclui derivados. |
+| RN-D12 | Apenas Administradores podem excluir benefícios derivados; exclusão mantém o principal e registra histórico. |
+| RN-D13 | Benefícios em Elaboração ou Revisão **não** podem ser derivados. |
+| RN-D14 | Benefícios em Estado Efetivo **nunca** podem ser derivados, mesmo que não possuam derivado ativo. |
+| RN-D15 | O vínculo entre principal e derivado é permanente e não pode ser removido por fluxos comuns. |
+| RN-D16 | Toda tentativa inválida de derivação deve bloquear a ação e manter a modal fechada. |
+| RN-D17 | Campos herdados devem ser exibidos sempre na mesma ordem da Modal Cadastrar Benefício. |
+| RN-D18 | A modal deve ser carregada apenas se todas as regras de pré-validação forem atendidas. |