pres:gerti:gestao_de_ativos:bace_2:derivacaobenfi

Diferenças

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

Link para esta página de comparações

Ambos lados da revisão anterior Revisão anterior
Próxima revisão		 Revisão anterior
pres:gerti:gestao_de_ativos:bace_2:derivacaobenfi [18/11/2025 11:32] – jbmoraespres:gerti:gestao_de_ativos:bace_2:derivacaobenfi [05/02/2026 17:01] (atual) – [Table] jbmoraes
Linha 1: Linha 1:
-===== Modal Beneficio modo “Derivação de Benefício” =====+===== ER_002.4 – Modal Benefício (Modo “Derivação de Benefício”) =====
  
-==== Contexto ====+==== 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.
  
-A Modal ** Cadastrar beneficio utilizando o ícone Derivação de Benefício** permite criar um novo benefício vinculado a outro principal já revisado. Essa funcionalidade é usada quando uma deliberação ou decisão gera um efeito adicional relacionado ao benefício original. +----
-==== Objetivo ====+
  
-Gerar um novo benefício derivado, mantendo vínculo direto com o principal e herdando parte de suas informações, como processo, unidade técnica e natureza.+==== 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.   |
  
-==== Campos ====+----
  
-{{  :user:derivacao_quantivativo_nao_financeiro.png  }}+==== 3. Telas ====
  
-^Campo^Descrição^Regras e Comportamentos| +=== Tela 01 – Modal Derivação de Benefício ==== 
-|BACE Principal|Identificação do benefício de origem|Exibido automaticamente, em modo somente leitura.| +{{ :user:derivacao_quantivativo_nao_financeiro.png |}}
-|Estado|Pode ser edita, seguindo regra de derivação|Se o estado do beneficio origem for **Proposta** , poderá derivar para** Pontencial** ou **Efetivo**, se for Pontencial podera derivar para Efetivo. Beneficios** Efetivos** não derivam.| +
-|Momento do registro|Segue mesmas opções já definidas no cadastro do Beneficio|Devera ser alterado conforme o novo estado recebido. Ex acórdãos só pode ser selecionado juntamente com o estado Potencial assim o documento vinculante também devera ser informado| +
-|Quantidade ou Valor informado|A derivação geralmente replica o valor da origem|Campo obrigatório; entretando podera ser editado, permitindo informar outro valor que foi acatado durante a analise do colegiado,| +
-|Situação|A derivação vira com o campo Em editação|Campo pode ser editado já com a situação necessaria seguindo regras já estabelecidas no cadastro do beneficio.| +
-|Botões de Ação|“Salvar” / “Cancelar”|“Salvar” grava o novo registro vinculado; “Cancelar” descarta.|+
  
-==== Regras de Negócio ====+=== 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        |
  
-  * Apenas benefícios **Revisados**  podem ser derivados. +----
-  * O benefício principal não pode possuir mais de um derivado ativo. +
-  * O benefício derivado herda: +
-      * Número do processo. +
-      * Unidade técnica. +
-      * Ações de controle +
-      * Marcador temático +
-      * Area principal e secundaria +
-      * Tipos , subtipo e Natureza. +
-      * Quantidade ou valor vem preenchido mas pode ser alterado +
-      * Memória de calculo +
-      * Descrição +
-      * Situação vira automaticamente em elaboração entretanto podera ser editada. +
-  * Ao criar o derivado, o sistema: +
-      * Registra o vínculo entre os dois benefícios. +
-      * Cria entrada automática no histórico de ambos. +
-  * O vínculo entre principal e derivado é permanente e não pode ser excluído, entretanto administradores podem excluir um beneficio cujo a origem foi derivada de forma total.+
  
-==== Regras Condicionais ==== +==== 4. Fluxos ====
- +
-  * Se o benefício principal ainda estiver “Em Elaboração” ou “Em Revisão”, o botão “Derivar” fica desabilitado. +
-  * Se o benefício principal já possuir um derivado ativo, a opção é bloqueada. +
-  * Apenas Administradores podem excluir derivações. +
-  * A derivação é como se fosse etapas que o registro de um beneficio passa geralmente seguindo uma ordem ( Proposta ⇒ Potencial ⇒ Efetivo ) quando o beneficio já é efetivo ele não deriva, mesmo se não tiver nenhum beneficio vinculado ao mesmo. +
- +
-==== Ações Possíveis ==== +
- +
-  * Salvar ( que automaticamente salva o beneficio com origem derivada) +
-  * Cancelar operação. +
- +
-==== Mensagens e Alertas ==== +
- +
-  * “Não é possível derivar benefícios ainda em elaboração.” caso em alguma seção esteja alterando e mudando a situação do beneficio. +
-  * “Benefício derivado criado com sucesso.” +
- +
-==== Perfis com Acesso ==== +
- +
-^Perfil^Permissão| +
-|Usuário|Sem acesso| +
-|Auditor|Visualiza relação, cria derivação, editar os campos permitidos em elaboração.| +
-|Gestor|Pode criar benefício derivado, editar os campos permitidos os enviados para revisão retornar para em elaboração.| +
-|Administrador|Pode criar e editar, excluir benefícios derivados independente da situação.| +
- +
- +
- +
-==== Fluxo 01 – Derivação de Benefício ====+
  
 +=== Fluxo 01 – Criar Benefício Derivado ====
 ^ Passo ^ Ação ^ Regra ^ Tela | ^ Passo ^ Ação ^ Regra ^ Tela |
-| 01 | Usuário, na grid de Benefícios da tela “Cadastrar BACE”, clica no ícone **Derivar** de um benefício. | RN-D01 | Tela 01 | +| 01 | Usuário clica no ícone **Derivar** na grid de benefícios. | RN-D01 | Tela 01 | 
-| 02 | Sistema verifica se o benefício selecionado está com Situação **Revisado**, não está em Estado **Efetivo** e não possui derivado ativo registrado. | RN-D01, RN-D02 | 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 | Caso alguma condição não seja atendida, sistema bloqueia a ação e exibe mensagem “Não é possível derivar este benefício.” | RN-D01, RN-D02, RN-D10 | 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 | Se as condições forem atendidas, sistema abre a **Modal Cadastrar Benefício** em modo **Derivação de Benefício**, exibindo o campo **BACE Principal** em somente leitura. | RN-D03 | Modal Derivação | +| 04 | Sistema abre a **Modal Derivação**, com **BACE Principal** em somente leitura. | RN-D03 | Tela 01| 
-| 05 | Sistema pré-preenche os campos herdados do benefício principal (processo, unidade técnica, ação de controle, marcador temático, áreas, tipo, subtipo, natureza, quantidade/valor, memória de cálculo, descrição) e define a Situação do novo benefício como **Em elaboração**. | RN-D03, RN-D07 | Modal Derivação | +| 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 o Estado do benefício principal (Proposta ⇒ Potencial ou Efetivo; Potencial ⇒ Efetivo; Efetivo ⇒ não permite derivar). | RN-D04 | Modal Derivação | +| 06 | Sistema sugere o novo Estado conforme transição válida. | RN-D04 | Tela 01| 
-| 07 | Ao usuário alterar o **Estado**, o sistema atualiza as opções de **Momento do registro** de acordo com as combinações válidas de Estado × Momento e limpa momentos/documentos vinculantes incompatíveis. | RN-D04, RN-D05 | Modal Derivação | +| 07 | Ao alterar Estado, sistema atualiza **Momento** e limpa vinculantes incompatíveis. | RN-D05 | Tela 01 | 
-| 08 | Usuário ajusta **Momento do registro**, quantidade ou valor, situação interna e demais campos permitidos, informando documento vinculante quando o momento exigir (ex.: Acórdão para Estado Potencial). | RN-D05, RN-D06 | Modal Derivação | +| 08 | Usuário ajusta valores, estado, momento e situação conforme permitido. | RN-D06, RN-D07 | Tela 01 | 
-| 09 | Usuário clica em **Salvar** para confirmar a criação do benefício derivado. | RN-D06, RN-D08 | Modal Derivação | +| 09 | Usuário clica **Salvar**. | RN-D08 | Tela 01 | 
-| 10 | Sistema valida todos os campos obrigatórios e as regras de derivação (estado permitido, momento compatível, ausência de derivado ativo, perfil do usuário). | RN-D01, RN-D02, RN-D04, RN-D05, RN-D06, RN-D11 | Modal Derivação | +| 10 | Sistema valida regras de derivação e obrigatoriedade. | RN-D01, RN-D02, RN-D04, RN-D05, RN-D06, RN-D11 | Tela 01| 
-| 11 | Em caso de sucesso, sistema grava o novo benefício como **Derivado**, registra o vínculo com o benefício principal, cria entradas no **Histórico do Benefício** e no **Histórico do Processo**, fecha a modal e atualiza a grid de benefícios. | RN-D08, RN-D09 | Tela 01 | +| 11 | Sistema cria benefício derivado, registra vínculo, grava histórico e atualiza grid. | RN-D08, RN-D09 | Tela 01 | 
-| 12 | Em caso de falha, sistema mantém a modal aberta, destaca os campos com erro e exibe a mensagem correspondente (ex.: “Não é possível derivar benefícios ainda em elaboração.”). | RN-D10 | Modal Derivação | +| 12 | Havendo erro, sistema mantém modal aberta e destaca campos inválidos. | RN-D10 | Tela 01| 
-| 13 | Caso o usuário clique em **Cancelar**, o sistema fecha a modal sem gravar alterações e não cria benefício derivado. | RN-D08 | Modal Derivação | +| 13 | Se usuário clicar **Cancelar**, modal é fechada sem alterações. | RN-D08 |Tela 01 |
- +
-==== Regras de Negócio – Derivação de Benefício (RN-D) ====+
  
-^ Regra ^ Descrição |+----
  
-| **RN-D01** | Apenas benefícios com Situação **Revisado** e Estado diferente de **Efetivo** podem exibir o ícone **Derivar**. Benefícios em Elaboração ou Em Revisão não permitem derivação. | +==== 5. Regras de Negócio – Derivação de Benefício (Tabela Sequencial) ==== 
-| **RN-D02** | Cada benefício principal pode possuir no máximo **um** benefício derivado ativo. Se já existir derivado, o sistema desabilita a ação de derivar. | +^ Código ^ Regra | 
-| **RN-D03** | O benefício derivado herda automaticamente do principal: número do processo, unidade técnica, ação de controle, marcador temático, área principal e secundárias, tipo, subtipo, natureza, quantidade/valor, memória de cálculo e descrição. O campo **BACE Principal** é exibido em modo somente leitura. | +| RN-D01 | Apenas benefícios com Situação **Revisado** e Estado diferente de **Efetivo** exibem o ícone Derivar. | 
-| **RN-D04** | A transição de Estado na derivação obedece às seguintes regras: **Proposta ⇒ Potencial ou Efetivo**; **Potencial ⇒ Efetivo**; **Efetivo ⇒ não permite derivação**. O Estado do derivado deve respeitar essa cadeia. | +| RN-D02 | Um benefício principal só pode ter **um derivado ativo**. Caso exista, o sistema bloqueia nova derivação. | 
-| **RN-D05** | O **Momento do registro** do benefício derivado deve ser compatível com o novo Estado, conforme as combinações válidas (ex.: Acórdão e Parecer Prévio apenas para Estado Potencial). Ao mudar Estado, momentos incompatíveis são limpos e documentos vinculantes são resetados. | +| 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-D06** | Os campos de **quantidade** ou **valor** são copiados do benefício principal, porém permanecem obrigatórios e editáveis, permitindo ajustes conforme a deliberação do colegiado. | +| RN-D04 | Transição de Estados permitida: **Proposta ⇒ Potencial ou Efetivo**, **Potencial ⇒ Efetivo**, **Efetivo ⇒ bloqueado**. | 
-| **RN-D07** | A Situação interna do benefício derivado é criada como **Em elaboração**, podendo ser alterada posteriormente conforme regras gerais de fluxo (envio para revisão, marcação como revisado etc.). | +| RN-D05 | Momento do registro deve ser compatível com o Estado. Momentos/documentos incompatíveis devem ser limpos ao alterar o Estado. | 
-| **RN-D08** | Ao salvar a derivação, o sistema cria um novo registro de benefício com origem **Derivada**, salvando o vínculo permanente com o benefício principal. O botão “Cancelar” fecha a modal sem criar o registro. | +| RN-D06 | Valor/Quantidade são copiados do principal, porém obrigatórios e totalmente editáveis. | 
-| **RN-D09** | A criação do derivado gera registros automáticos no **Histórico do Benefício** (principal e derivado) e no **Histórico do Processo**, indicando usuário, data, hora e referência ao benefício de origem. | +| RN-D07 | Situação interna do derivado inicia como **Em elaboração**, modificável posteriormente por regras gerais. | 
-| **RN-D10** | Quando alguma condição de derivação é violada (benefício em elaboração, efetivo, sem revisão ou com derivado existente), o sistema bloqueia a ação e exibe mensagem adequada, como “Não é possível derivar benefícios ainda em elaboração.” | +| RN-D08 | Ao salvar, o sistema cria o derivado, registra o vínculo e fecha a modal; ao cancelar, fecha sem criar registro. | 
-| **RN-D11** | Permissões por perfil: Usuário – sem acesso; Auditor – pode visualizar relação e criar derivação, editando campos permitidos enquanto em elaboração; Gestor – pode criar derivação, editar e retornar benefício para Em elaboração; Administrador – pode criar, editar e excluir benefícios derivados em qualquer situação. | +| RN-D09 | A criação do derivado gera registros automáticos no Histórico do Benefício e Histórico do Processo. | 
-| **RN-D12** | A exclusão de um benefício derivado é permitida apenas a perfis Administradores. A exclusão remove o derivado, mas mantém o benefício principal e um registro no histórico indicando a exclusão da derivação. |+| 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. |
  
  
  • pres/gerti/gestao_de_ativos/bace_2/derivacaobenfi.1763465522.txt.gz
  • Última modificação: 18/11/2025 11:32
  • por jbmoraes