===== 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. |