user:jbmoraescadastrarbeneficio

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
user:jbmoraescadastrarbeneficio [06/11/2025 20:53] – [Mensagens de Validação] jbmoraesuser:jbmoraescadastrarbeneficio [06/11/2025 21:00] (atual) – jbmoraes
Linha 2: Linha 2:
  
 ==== Contexto ==== ==== Contexto ====
-A tela **Cadastrar BACE** é o formulário principal do sistema para o registro e gestão dos benefícios vinculados aos processos do controle externo.   + 
-Nela, o usuário realiza a seleção do processo, identifica o(s) jurisdicionado(s), visualiza benefícios e VRFs existentes, e executa cadastros de novos registros ou justificativas de ausência de benefício.+A tela **Cadastrar BACE** é o formulário principal do sistema para o registro e gestão dos benefícios vinculados aos processos do controle externo. Nela, o usuário realiza a seleção do processo, identifica o(s) jurisdicionado(s), visualiza benefícios e VRFs existentes, e executa cadastros de novos registros ou justificativas de ausência de benefício.
  
 A tela é composta por três blocos principais: A tela é composta por três blocos principais:
 +
   * **Seleção e informações do processo**   * **Seleção e informações do processo**
   * **Grid de Benefícios**   * **Grid de Benefícios**
   * **Grid de VRFs (Volumes de Recursos Fiscalizados)**   * **Grid de VRFs (Volumes de Recursos Fiscalizados)**
-  * ** Justificar sem beneficio ( Exibida ao marcar a opção "Não há informação de benefícios")** +  * **Justificar sem beneficio ( Exibida ao marcar a opção "Não há informação de benefícios")** 
- +Os botões **Cadastrar Benefício**  e **Cadastrar VRF**  são as principais ações disponíveis, e sua habilitação depende do estado e das validações do processo.
-Os botões **Cadastrar Benefício** e **Cadastrar VRF** são as principais ações disponíveis, e sua habilitação depende do estado e das validações do processo.+
  
 ---- ----
Linha 18: Linha 18:
  
 ==== Objetivo ==== ==== Objetivo ====
 +
 Permitir que o usuário informe o número do processo e que o sistema valide automaticamente sua existência e elegibilidade para o registro de benefício. Permitir que o usuário informe o número do processo e que o sistema valide automaticamente sua existência e elegibilidade para o registro de benefício.
  
 ==== Funcionamento ==== ==== Funcionamento ====
-  * Campo **Nº do Processo** com recurso de **autocompletar**: + 
-    * Ao digitar parcial ou totalmente o número, o sistema consulta a base de dados. +  * Campo **Nº do Processo**  com recurso de **autocompletar**: 
-    * Exibe sugestões de processos compatíveis. +      * Ao digitar parcial ou totalmente o número, o sistema consulta a base de dados. 
-    * Ao selecionar um processo, o sistema: +      * Exibe sugestões de processos compatíveis. 
-      - Carrega os dados básicos do processo. +      * Ao selecionar um processo, o sistema: 
-      - Valida se pertence à unidade técnica do usuário ativo. +        - Carrega os dados básicos do processo. 
-      - Exibe as informações complementares (relatoria, origem, setor, resumo e interessados).+        - Valida se pertence à unidade técnica do usuário ativo. 
 +        - Exibe as informações complementares (relatoria, origem, setor, resumo e interessados).
   * Caso o processo não esteja vinculado à unidade técnica, o sistema bloqueia o cadastro.   * Caso o processo não esteja vinculado à unidade técnica, o sistema bloqueia o cadastro.
   * Se o processo possuir o registro de “sem benefício”, o sistema desabilita os botões de cadastro.   * Se o processo possuir o registro de “sem benefício”, o sistema desabilita os botões de cadastro.
  
 ==== Mensagens de Validação ==== ==== Mensagens de Validação ====
 +
   * “Processo não encontrado.”   * “Processo não encontrado.”
   * “Processo não pertence à unidade técnica ativa.”   * “Processo não pertence à unidade técnica ativa.”
Linha 42: Linha 45:
  
 ==== Contexto ==== ==== Contexto ====
 +
 Quando o processo é selecionado e não há registros vinculados, a tela apresenta o estado inicial de cadastro, exibindo apenas os dados básicos do processo e grids vazias. Quando o processo é selecionado e não há registros vinculados, a tela apresenta o estado inicial de cadastro, exibindo apenas os dados básicos do processo e grids vazias.
  
 ==== Comportamento Visual ==== ==== Comportamento Visual ====
 +
   * Dados carregados automaticamente:   * Dados carregados automaticamente:
-    - Nº do Processo   +      - Nº do Processo 
-    - Relatoria (Conselheiro relator)   +      - Relatoria (Conselheiro relator) 
-    - Origem do processo   +      - Origem do processo 
-    - Setor atual   +      - Setor atual 
-    - Resumo do processo   +      - Resumo do processo 
-    - Interessados +      - Interessados 
-  * Campo **Jurisdicionado do processo** preenchido automaticamente (se encontrado na base).+  * Campo **Jurisdicionado do processo**  preenchido automaticamente (se encontrado na base).
   * Grids vazias com mensagens:   * Grids vazias com mensagens:
-    - *“Nenhum benefício cadastrado.”* +      - *“Nenhum benefício cadastrado.”* 
-    - *“Nenhum VRF cadastrado para este processo.”* +      - *“Nenhum VRF cadastrado para este processo.”* 
-  * Botões **Cadastrar Benefício** e **Cadastrar VRF** habilitados apenas se: +  * Botões **Cadastrar Benefício**  e **Cadastrar VRF**  habilitados apenas se: 
-    - O processo pertencer à unidade técnica do usuário ativo. +      - O processo pertencer à unidade técnica do usuário ativo. 
-    - Houver jurisdicionado válido vinculado. +      - Houver jurisdicionado válido vinculado. 
-    - A opção “Não há informação de benefício” não estiver marcada.+      - A opção “Não há informação de benefício” não estiver marcada.
  
 ==== Regras de Negócio ==== ==== Regras de Negócio ====
 +
   * O estado inicial é a base para:   * O estado inicial é a base para:
-    1. Cadastrar o primeiro benefício.   + 
-    2. Cadastrar o primeiro VRF.   +1. Cadastrar o primeiro benefício. \\ 2. Cadastrar o primeiro VRF. \\ 3. Marcar o processo como “Sem benefício”. 
-    3. Marcar o processo como “Sem benefício”. + 
-  * Ações bloqueadas se: +Ações bloqueadas se: 
-    - O processo não tiver jurisdicionado válido. + 
-    - Já houver benefício ou “sem benefício” registrado. +  - O processo não tiver jurisdicionado válido. 
-  * Mensagem de bloqueio exibida: +  - Já houver “sem benefício” registrado. 
-    > *“Indisponível: já existe benefício ou registro de ‘sem benefício’ para este processo.”*+ 
 +Mensagem de bloqueio exibida: Indisponível: já existe benefício ou registro de ‘sem benefício’ para este processo.”*
  
 ==== Ações Disponíveis ==== ==== Ações Disponíveis ====
-  * **Cadastrar Benefício:** abre a modal de cadastro de benefício.   
-  * **Cadastrar VRF:** abre a modal de VRF.   
-  * **Marcar “Não há informação de benefício”**: ativa modo “Sem benefício”. 
  
 +  * **Cadastrar Benefício:**  abre a modal de cadastro de benefício.
 +  * **Cadastrar VRF:**  abre a modal de VRF.
 +  * **Marcar “Não há informação de benefício”**: ativa modo “Sem benefício”.
 ==== Mensagens ==== ==== Mensagens ====
 +
   * “Nenhum benefício cadastrado.”   * “Nenhum benefício cadastrado.”
   * “Nenhum VRF cadastrado para este processo.”   * “Nenhum VRF cadastrado para este processo.”
Linha 87: Linha 95:
  
 ==== Objetivo ==== ==== Objetivo ====
 +
 Identificar e vincular automaticamente o jurisdicionado do processo, garantindo que todos os registros estejam associados a uma entidade sob controle do TCE-GO. Identificar e vincular automaticamente o jurisdicionado do processo, garantindo que todos os registros estejam associados a uma entidade sob controle do TCE-GO.
  
 ==== Funcionamento ==== ==== Funcionamento ====
-  * Ao selecionar o processo, o sistema verifica se algum **interessado** do processo consta na **base de jurisdicionados do controle externo**.+ 
 +  * Ao selecionar o processo, o sistema verifica se algum **interessado**  do processo consta na **base de jurisdicionados do controle externo**.
   * Se houver correspondência:   * Se houver correspondência:
-    * O campo **Jurisdicionado do processo** é preenchido automaticamente.+      * O campo **Jurisdicionado do processo**  é preenchido automaticamente.
   * Caso não haja:   * Caso não haja:
-    * O usuário deve informar manualmente o jurisdicionado válido por meio da lista oficial. +      * O usuário deve informar manualmente o jurisdicionado válido por meio da lista oficial. 
-    * Enquanto não for informado, o sistema bloqueia os botões: +      * Enquanto não for informado, o sistema bloqueia os botões: 
-      - **Cadastrar Benefício** +        - **Cadastrar Benefício** 
-      - **Cadastrar VRF** +        - **Cadastrar VRF** 
-      - **Não há informação de benefício** +        - **Não há informação de benefício**
 ==== Campos e Comportamentos ==== ==== Campos e Comportamentos ====
-^ Campo ^ Descrição ^ Regra e Comportamento ^ + 
-| Jurisdicionado do Processo | Entidade principal vinculada ao processo | Preenchimento automático, leitura única | +^Campo^Descrição^Regra e Comportamento| 
-| Jurisdicionados Selecionados | Entidades adicionais associadas | Permite múltipla seleção (adicionar/remover) | +|Jurisdicionado do Processo|Entidade principal vinculada ao processo|Preenchimento automático, leitura única| 
-| Botões (+ / ✔ / 🗑️) | Adicionar, confirmar, remover | + abre seletor, ✔ confirma, 🗑️ exclui |+|Jurisdicionados Selecionados|Entidades adicionais associadas|Permite múltipla seleção (adicionar/remover)| 
 +|Botões (+ / ✔ / 🗑️)|Adicionar, confirmar, remover|+ abre seletor, ✔ confirma, 🗑️ exclui|
  
 ==== Mensagens ==== ==== Mensagens ====
 +
   * “Jurisdicionado adicionado com sucesso.”   * “Jurisdicionado adicionado com sucesso.”
   * “Exclusão de jurisdicionado concluída.”   * “Exclusão de jurisdicionado concluída.”
Linha 116: Linha 127:
  
 ==== Objetivo ==== ==== Objetivo ====
 +
 Exibir e gerenciar todos os benefícios vinculados ao processo, distinguindo entre registros ativos e encerrados. Exibir e gerenciar todos os benefícios vinculados ao processo, distinguindo entre registros ativos e encerrados.
  
 ==== Estrutura ==== ==== Estrutura ====
 +
 A grid é dividida em: A grid é dividida em:
-  * **Benefícios Ativos:** exibe registros em situação “Em elaboração” e “Revisado”. 
-  * **Encerrados:** lista os benefícios finalizados (estado “Encerrado”). 
  
 +  * **Benefícios Ativos:**  exibe registros em situação “Em elaboração” e “Revisado”.
 +  * **Encerrados:**  lista os benefícios finalizados (estado “Encerrado”).
 ==== Colunas ==== ==== Colunas ====
-^ Coluna ^ Descrição ^ + 
-| ID | Identificador único do benefício | +^Coluna^Descrição| 
-| Título | Descrição resumida | +|ID|Identificador único do benefício| 
-| Natureza | Tipo de benefício (Financeiro, Não Financeiro, Qualitativo) | +|Título|Descrição resumida| 
-| Estado | Estado do benefício (Proposta, Revisado, Encerrado) | +|Natureza|Tipo de benefício (Financeiro, Não Financeiro, Qualitativo)| 
-| Origem | Principal ou Derivado | +|Estado|Estado do benefício (Proposta, Revisado, Encerrado)| 
-| Situação | Status operacional (Em elaboração, Revisado, Encerrado) | +|Origem|Principal ou Derivado| 
-| Ações | Ícones para as operações disponíveis |+|Situação|Status operacional (Em elaboração, Revisado, Encerrado)| 
 +|Ações|Ícones para as operações disponíveis|
  
 ==== Ações ==== ==== Ações ====
-^ Ícone ^ Ação ^ Descrição ^ + 
-| 👁️ | Visualizar | Abre modal de visualização completa | +^Ícone^Ação^Descrição| 
-| ✎ | Editar | Abre modal “Cadastrar Benefício” com dados preenchidos | +|👁️|Visualizar|Abre modal de visualização completa| 
-| 🔗 | Derivar | Cria novo benefício derivado (apenas se Revisado) | +|✎|Editar|Abre modal “Cadastrar Benefício” com dados preenchidos| 
-| 🗘 | Reabrir | Retorna benefício encerrado ao estado de elaboração | +|🔗|Derivar|Cria novo benefício derivado (apenas se Revisado)| 
-| 🗑️ | Excluir | Remove benefício (apenas Administrador) |+|🗘|Reabrir|Retorna benefício encerrado ao estado de elaboração| 
 +|🗑️|Excluir|Remove benefício (apenas Administrador)|
  
 ==== Regras de Negócio ==== ==== Regras de Negócio ====
 +
   * Registros exibidos nesta grid têm origem nos cadastros realizados via botão **Cadastrar Benefício**.   * Registros exibidos nesta grid têm origem nos cadastros realizados via botão **Cadastrar Benefício**.
   * As ações disponíveis variam conforme o status e o perfil.   * As ações disponíveis variam conforme o status e o perfil.
Linha 147: Linha 163:
  
 ==== Mensagens ==== ==== Mensagens ====
 +
   * “Nenhum benefício cadastrado.”   * “Nenhum benefício cadastrado.”
   * “Benefício encerrado — somente visualização permitida.”   * “Benefício encerrado — somente visualização permitida.”
Linha 157: Linha 174:
 Cada ícone da grid aciona uma modal específica, conforme a funcionalidade. Cada ícone da grid aciona uma modal específica, conforme a funcionalidade.
  
-^ Modal ^ Descrição ^ Origem / Ação ^ +^Modal^Descrição^Origem / Ação| 
-| **Cadastrar Benefício** | Formulário de criação e edição de benefícios. | Botão “Cadastrar Benefício” ou ícone ✎ | +|**Cadastrar Benefício** |Formulário de criação e edição de benefícios.|Botão “Cadastrar Benefício” ou ícone ✎| 
-| **Visualizar Benefício** | Exibe detalhes do benefício sem permitir edição. | Ícone 👁️ | +|**Visualizar Benefício** |Exibe detalhes do benefício sem permitir edição.|Ícone 👁️| 
-| **Encerramento de Proposta** | Finaliza o benefício com justificativa e acórdão. | Ação “Encerrar” | +|**Encerramento de Proposta** |Finaliza o benefício com justificativa e acórdão.|Ação “Encerrar”| 
-| **Histórico do Benefício** | Exibe todas as alterações e ações registradas. | Ícone 🕓 | +|**Histórico do Benefício** |Exibe todas as alterações e ações registradas.|Ícone 🕓| 
-| **Derivação de Benefício** | Cria novo benefício vinculado a outro revisado. | Ícone 🔗 |+|**Derivação de Benefício** |Cria novo benefício vinculado a outro revisado.|Ícone 🔗|
  
 Todas seguem as regras e campos descritos nos tópicos 6 a 11. Todas seguem as regras e campos descritos nos tópicos 6 a 11.
Linha 171: Linha 188:
  
 ==== Objetivo ==== ==== Objetivo ====
 +
 Exibir e gerenciar os registros de Volume de Recursos Fiscalizados vinculados ao processo. Exibir e gerenciar os registros de Volume de Recursos Fiscalizados vinculados ao processo.
  
 ==== Origem dos Dados ==== ==== Origem dos Dados ====
 +
 Os registros exibidos são provenientes dos cadastros realizados pelo botão **Cadastrar VRF**. Os registros exibidos são provenientes dos cadastros realizados pelo botão **Cadastrar VRF**.
  
 ==== Colunas ==== ==== Colunas ====
-^ Coluna ^ Descrição ^ + 
-| Motivo | Aplicável ou não aplicável | +^Coluna^Descrição| 
-| Fonte | Origem das informações | +|Motivo|Aplicável ou não aplicável| 
-| Valor | Valor total fiscalizado | +|Fonte|Origem das informações| 
-| Unidade Técnica | Setor responsável | +|Valor|Valor total fiscalizado| 
-| Descrição | Método e escopo da apuração | +|Unidade Técnica|Setor responsável| 
-| Referências | Peças e páginas de comprovação | +|Descrição|Método e escopo da apuração| 
-| Ações | Editar / Visualizar / Excluir (conforme perfil) |+|Referências|Peças e páginas de comprovação| 
 +|Ações|Editar / Visualizar / Excluir (conforme perfil)|
  
 ==== Regras ==== ==== Regras ====
 +
   * Um processo pode conter vários VRFs.   * Um processo pode conter vários VRFs.
   * A ausência de registros exibe:   * A ausência de registros exibe:
-    > *“Nenhum VRF cadastrado para este processo.”* + 
-  * O botão **Cadastrar VRF** fica desabilitado se: +> *“Nenhum VRF cadastrado para este processo.”* 
-    - O processo estiver marcado como “Sem benefício”. + 
-    - Não houver jurisdicionado válido.+  * O botão **Cadastrar VRF**  fica desabilitado se: 
 +      - O processo estiver marcado como “Sem benefício”. 
 +      - Não houver jurisdicionado válido.
  
 ==== Perfis e Permissões ==== ==== Perfis e Permissões ====
-^ Perfil ^ Permissão ^ + 
-| Usuário | Leitura | +^Perfil^Permissão| 
-| Auditor | Cadastrar e editar enquanto em elaboração | +|Usuário|Leitura| 
-| Gestor | Visualização e revisão | +|Auditor|Cadastrar e editar enquanto em elaboração| 
-| Administrador | Controle total (cadastrar, editar, excluir) |+|Gestor|Visualização e revisão| 
 +|Administrador|Controle total (cadastrar, editar, excluir)|
  
 ---- ----
Linha 206: Linha 230:
  
 ==== Contexto ==== ==== Contexto ====
 +
 O registro “Sem benefício” é uma funcionalidade do formulário principal **Cadastrar BACE**, usada quando o processo analisado não gerou benefício mensurável. O registro “Sem benefício” é uma funcionalidade do formulário principal **Cadastrar BACE**, usada quando o processo analisado não gerou benefício mensurável.
  
 ==== Objetivo ==== ==== Objetivo ====
 +
 Permitir que o responsável registre formalmente a ausência de benefício, garantindo rastreabilidade e bloqueio das ações de cadastro enquanto o status estiver ativo. Permitir que o responsável registre formalmente a ausência de benefício, garantindo rastreabilidade e bloqueio das ações de cadastro enquanto o status estiver ativo.
  
 ==== Estrutura ==== ==== Estrutura ====
 +
   * Checkbox: **“Não há informação de benefício”**   * Checkbox: **“Não há informação de benefício”**
   * Mensagem de alerta em amarelo:   * Mensagem de alerta em amarelo:
-    > *“Este processo está marcado como ‘Sem benefício’. Para registrar benefícios, remova a marcação.”*+ 
 +> *“Este processo está marcado como ‘Sem benefício’. Para registrar benefícios, remova a marcação.”* 
   * Campo **Justificativa Atual**, obrigatório para validar a condição.   * Campo **Justificativa Atual**, obrigatório para validar a condição.
   * Ícones ✎ (editar) e 🗑️ (excluir) disponíveis conforme perfil.   * Ícones ✎ (editar) e 🗑️ (excluir) disponíveis conforme perfil.
  
 ==== Regras de Negócio ==== ==== Regras de Negócio ====
 +
   * O processo marcado como “Sem benefício” não pode receber novos benefícios ou VRFs.   * O processo marcado como “Sem benefício” não pode receber novos benefícios ou VRFs.
   * A justificativa é obrigatória para salvar a condição.   * A justificativa é obrigatória para salvar a condição.
Linha 226: Linha 256:
  
 ==== Regras Condicionais ==== ==== Regras Condicionais ====
 +
   * Se marcado:   * Se marcado:
-    * Desativa botões de **Cadastrar Benefício** e **Cadastrar VRF**. +      * Desativa botões de **Cadastrar Benefício**  e **Cadastrar VRF**. 
-    * Exibe campo de justificativa obrigatório.+      * Exibe campo de justificativa obrigatório.
   * Se desmarcado:   * Se desmarcado:
-    * Reativa botões de cadastro. +      * Reativa botões de cadastro. 
-    * Oculta alerta e campo de justificativa.+      * Oculta alerta e campo de justificativa.
   * Tentar marcar sem preencher justificativa exibe erro.   * Tentar marcar sem preencher justificativa exibe erro.
  
 ==== Mensagens ==== ==== Mensagens ====
 +
   * “Este processo está marcado como ‘Sem benefício’. Para registrar benefícios, remova a marcação.”   * “Este processo está marcado como ‘Sem benefício’. Para registrar benefícios, remova a marcação.”
   * “Informe a justificativa antes de salvar o processo sem benefício.”   * “Informe a justificativa antes de salvar o processo sem benefício.”
Linha 241: Linha 273:
  
 ==== Perfis e Permissões ==== ==== Perfis e Permissões ====
-^ Perfil ^ Permissão ^ + 
-| Usuário | Somente leitura | +^Perfil^Permissão| 
-| Auditor | Marcar, editar e excluir justificativa | +|Usuário|Somente leitura| 
-| Gestor | Revisar justificativas | +|Auditor|Marcar, editar e excluir justificativa| 
-| Administrador | Controle total sobre marcações e exclusões |+|Gestor|Revisar justificativas| 
 +|Administrador|Controle total sobre marcações e exclusões|
  
 ==== Regras Visuais ==== ==== Regras Visuais ====
-  * A cor **amarela** sinaliza estado reversível. 
-  * O campo **Justificativa Atual** é exibido logo abaixo das informações do processo. 
-  * Enquanto ativo, o checkbox permanece visível e travado para evitar alterações acidentais. 
  
 +  * A cor **amarela**  sinaliza estado reversível.
 +  * O campo **Justificativa Atual**  é exibido logo abaixo das informações do processo.
 +  * Enquanto ativo, o checkbox permanece visível e travado para evitar alterações acidentais.
  
 ===== 6. Modal “Cadastrar Benefício” ===== ===== 6. Modal “Cadastrar Benefício” =====
Linha 257: Linha 290:
 ==== Contexto da Tela ==== ==== Contexto da Tela ====
  
-A Modal **Cadastrar Benefício** é acessada dentro do processo selecionado. Permite registrar ou editar um benefício, detalhando as informações classificatórias, quantitativas e qualitativas.+A Modal **Cadastrar Benefício**  é acessada dentro do processo selecionado. Permite registrar ou editar um benefício, detalhando as informações classificatórias, quantitativas e qualitativas. 
 ==== Objetivo ==== ==== Objetivo ====
  
Linha 603: Linha 637:
  
 ---- ----
 +
 +
  
  
  • user/jbmoraescadastrarbeneficio.1762462433.txt.gz
  • Última modificação: 06/11/2025 20:53
  • por jbmoraes