Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
| Ambos lados da revisão anterior Revisão anterior Próxima revisão | Revisão anterior | ||
| pres:gerti:gestao_de_ativos:bace_2:bace_em_lote [13/11/2025 21:12] – jbmoraes | pres:gerti:gestao_de_ativos:bace_2:bace_em_lote [08/12/2025 12:11] (atual) – jbmoraes | ||
|---|---|---|---|
| Linha 1: | Linha 1: | ||
| - | ===== 7. Cadastro BACE em Lote ===== | + | ===== ER_003 – Cadastro BACE em Lote ===== |
| - | O módulo **Cadastro BACE em Lote** permite registrar benefícios ou declarar ausência de benefício para um conjunto de processos simultaneamente. | + | ==== Descrição ==== |
| - | Todas as regras refletem a lógica utilizada na tela principal, nas modais e nas validações existentes no protótipo. | + | |
| - | ---- | + | O módulo Cadastro BACE em Lote permite registrar benefícios ou declarar ausência de benefício (“Sem benefício”) para vários processos ao mesmo tempo, aplicando a mesma configuração de dados a cada um deles. As regras de validação, |
| - | ==== 7.1 Estrutura Geral da Tela ==== | + | ==== Atores |
| - | A tela é composta pelos seguintes blocos: | + | ^Ator^Pode executar os fluxos| |
| + | |Usuário|Leitura dos lotes já concluídos (quando houver consulta futura).| | ||
| + | |Auditor|Criar lote, incluir/ | ||
| + | |Gestor|Todas as ações do Auditor, além de revisar lotes antes do salvamento definitivo (quando aplicável em rotina futura).| | ||
| + | |Administrador|Controle total: criar, editar, excluir lotes e corrigir erros de execução (quando permitido pelas regras gerais do BACE).| | ||
| - | ^ Bloco ^ Descrição ^ | + | ==== Telas ==== |
| - | | **Código do Lote** | Gerado automaticamente no formato `LOTE-000XXX`. É único e imutável. | | + | |
| - | | **Identificação do Lote** | Campo opcional para registrar uma descrição livre, com finalidade de organização interna. | | + | |
| - | | **Botão “Cadastrar Benefício (lote)”** | Abre a modal para configurar os dados do benefício que serão aplicados a todos os processos selecionados. | | + | |
| - | | **Checkbox “Sem benefício”** | Alternativa ao cadastro de benefício. Permite declarar que todos os processos do lote **não possuem benefício**. | | + | |
| - | | **Lista de Processos do Lote** | Exibe todos os processos inseridos manualmente ou selecionados pela busca. Pode incluir/ | + | |
| - | | **Botão “Salvar lote”** | Executa o registro final — criando benefícios individuais ou registrando “sem benefício”. | | + | |
| - | ---- | + | === Tela 01 – Cadastro BACE em Lote – Visão Geral === |
| - | ==== 7.2 Seleção de Processos para o Lote ==== | + | {{ : |
| - | A seleção | + | ^Elemento^Tipo^Obrigatório^Observação| |
| + | |Código do Lote|Texto somente leitura|Sim|Gerado automaticamente no formato LOTE-000XXX. Único e imutável.| | ||
| + | |Identificação do Lote|Campo texto|Não|Descrição livre para identificação interna do lote.| | ||
| + | |Nº do Processo|Campo texto (autocompletar)|Não|Permite digitar o número do processo e pesquisar na base. Só aceita processos válidos da UT.| | ||
| + | |Botão “Inserir”|Botão|—|Inclui o processo digitado na lista do lote, após validações.| | ||
| + | |Botão “Buscar Processos”|Botão|—|Abre a modal de pesquisa | ||
| + | |Lista | ||
| + | |Checkbox “Sem benefício”|Checkbox|Não|Quando marcado, desabilita o botão “Cadastrar Benefício (lote)” e ativa o campo Justificativa.| | ||
| + | |Campo Justificativa (Sem benefício)|Texto longo|Sim (se “Sem benefício” marcado)|Motivo da ausência de benefício para todos os processos do lote.| | ||
| + | |Botão “Cadastrar Benefício (lote)”|Botão|Não|Abre a modal de benefício em lote. Desabilitado se “Sem benefício” estiver marcado ou se não houver processos.| | ||
| + | |Botão “Salvar lote”|Botão|Sim (para concluir)|Executa o registro do lote. Desabilitado quando não há processos na lista.| | ||
| - | === 7.2.1 Inserção manual | + | === Tela 02 – Modal “Buscar Processos” |
| - | O usuário digita o número do processo e clica em **Inserir**. | + | {{ : |
| - | Regras: | + | ^Elemento^Tipo^Obrigatório^Observação| |
| + | |Campo de pesquisa|Texto|Não|Pesquisa por Nº do processo, relatoria, origem, resumo ou jurisdicionado.| | ||
| + | |Tabela de processos|Tabela|—|Lista processos aptos a receber benefício ou “Sem benefício” (filtro por regras do lote).| | ||
| + | |Checkbox de seleção|Checkbox por linha|Não|Permite seleção múltipla de processos.| | ||
| + | |Botão “Adicionar X processo(s)”|Botão|—|Inclui os processos selecionados no lote e fecha a modal.| | ||
| - | * O campo possui autocompletar, | + | === Tela 03 – Cadastro BACE em Lote com “Sem benefício” |
| - | * Só podem ser adicionados processos já tramitados pela Unidade Técnica. | + | |
| - | * O sistema bloqueia inclusão de: | + | |
| - | * processos inexistentes; | + | |
| - | * processos repetidos no mesmo lote; | + | |
| - | * processos que já possuem benefício ou registro de “sem benefício”. | + | |
| - | === 7.2.2 Modal “Buscar processos” === | + | {{ : |
| - | Acionada pelo botão **Buscar | + | ^Elemento^Tipo^Obrigatório^Observação| |
| + | |Checkbox “Sem benefício”|Checkbox|Não|Ao marcar, impede cadastros de benefício em lote.| | ||
| + | |Campo Justificativa|Texto longo|Sim (quando “Sem benefício” marcado)|Justificativa obrigatória. Mesma justificativa será aplicada a todos os processos.| | ||
| + | |Botão “Cadastrar Benefício (lote)”|Botão|—|Fica desabilitado enquanto “Sem benefício” estiver marcado.| | ||
| - | A modal contém: | + | === Tela 04 – Modal “Cadastrar Benefício (lote)” === |
| - | * campo de pesquisa por Nº do processo, relatoria, origem, resumo ou jurisdicionado; | + | {{: |
| - | * tabela com processos listados; | + | |
| - | * seleção múltipla por checkbox; | + | |
| - | * botão **Adicionar X processo(s)**. | + | |
| - | Regras: | + | ^Campo^Obrigatório^Regras e comportamento| |
| - | + | |Estado|Sim|Inicia | |
| - | * Não exibe processos já adicionados ao lote. | + | |Origem do benefício|Sim|Sempre PRINCIPAL no lote.| |
| - | * Não exibe processos impossibilitados (já beneficiados ou já declarados sem benefício). | + | |Unidade Técnica|Sim|Sugere a UT do usuário |
| - | * Permite adicionar vários processos de uma só vez. | + | |Laboratório Móvel|Não|Exibido |
| - | * Fecha automaticamente após inclusão. | + | |Momento do Registro|Sim|Lista momentos compatíveis com o Estado selecionado, seguindo as mesmas |
| - | + | |Documento Vinculante|Sim (preenchimento automático)|Campo bloqueado. Para cada processo do lote, o sistema seleciona automaticamente a última Instrução Técnica | |
| - | ---- | + | |Ação de Controle|Sim|Lista completa conforme configuração do sistema.| |
| - | + | |Marcador Temático|Sim|Lista pré-definida.| | |
| - | ==== 7.3 Opção “Sem benefício” (Lote) ==== | + | |Área Principal|Sim|Lista pré-definida.| |
| - | + | |Áreas Secundárias|Não|Permite | |
| - | Quando o usuário marca **Sem benefício**, | + | |Tipo|Sim|Determina Subtipos e Natureza |
| - | + | |Subtipo|Depende|Exibido somente quando o Tipo possui subdivisões.| | |
| - | * desativa o botão **Cadastrar Benefício (lote)**; | + | |Natureza|Sim|Definida conforme combinação Tipo/ |
| - | * oculta campos relacionados a cadastro de benefício; | + | |Valor (R$)|Depende|Exibido |
| - | * exibe o campo **Justificativa** (obrigatório); | + | |Unidade de Medida / Quantidade|Depende|Exibido |
| - | * ao salvar, registra **um evento de “sem benefício” por processo**. | + | |Memória de Cálculo / Fonte|Sim|Texto obrigatório justificando o valor ou quantidade registrada |
| - | + | |Descrição do benefício|Sim|Descrever | |
| - | Regras: | + | |Situação Interna|Sim|Sempre inicia como Em elaboração |
| - | + | ||
| - | * A justificativa deve ser clara, explicando o motivo da inexistência de benefício. | + | |
| - | * Todos os processos selecionados recebem registro individual de ausência de benefício. | + | |
| - | * O sistema registra histórico para cada processo: | + | |
| - | * usuário; | + | |
| - | * data/ | + | |
| - | * unidade técnica; | + | |
| - | * ação: *Registro de “sem benefício” em lote*; | + | |
| - | * justificativa informada; | + | |
| - | * processo afetado. | + | |
| - | + | ||
| - | ---- | + | |
| - | + | ||
| - | ==== 7.4 Modal “Cadastrar Benefício (lote)” ==== | + | |
| - | + | ||
| - | Essa modal permite configurar os campos que serão replicados para todos os processos selecionados. | + | |
| - | + | ||
| - | ^ Campo ^ Obrigatório ^ Regras e comportamento | + | |
| - | | **Estado** | Sim | Sempre inicia | + | |
| - | | **Origem do benefício** | Sim | Sempre | + | |
| - | | **Unidade Técnica** | Sim | Deve ser selecionada pelo usuário; define se “Laboratório Móvel” | + | |
| - | | **Laboratório Móvel** | Depende | + | |
| - | | **Momento do Registro** | Sim | Pode ser: *INSTRUÇÃO TÉCNICA CONCLUSIVA*, *PROCESSO EM ANDAMENTO*, *ACÓRDÃO*, | + | |
| - | | **Documento Vinculante (Instrução Técnica)** | Sim | No lote, o sistema seleciona automaticamente a **última Instrução Técnica | + | |
| - | | **Ação de Controle** | Sim | Lista completa conforme configuração do sistema. | | + | |
| - | | **Marcador Temático** | Sim | Lista pré-definida. | | + | |
| - | | **Área Principal** | Sim | Filtrada conforme o Marcador Temático. | | + | |
| - | | **Áreas Secundárias** | Não | Pode adicionar | + | |
| - | | **Tipo** | Sim | Determina | + | |
| - | | **Subtipo** | Depende | Exibido somente quando o Tipo possui subdivisões. | | + | |
| - | | **Natureza** | Sim | Definida conforme combinação Tipo/ | + | |
| - | | **Valor (R$)** | Depende | Exibido | + | |
| - | | **Unidade de Medida / Quantidade** | Depende | Exibido | + | |
| - | | **Memória de Cálculo / Fonte** | Sim | Texto obrigatório justificando o valor ou a quantidade registrada. | | + | |
| - | | **Descrição do benefício** | Sim | Deve seguir a diretriz: descrever | + | |
| - | | **Situação Interna** | Sim | Sempre inicia como *Em elaboração*. | | + | |
| Regras de campos condicionais: | Regras de campos condicionais: | ||
| - | * Natureza = **Quantitativo Financeiro** → mostra | + | Natureza = Quantitativo Financeiro → mostra Valor (R$) e oculta |
| - | * Natureza = **Quantitativo Não Financeiro** → mostra **unidade de medida/quantidade** e oculta valor financeiro. | + | |
| - | * Natureza = **Qualitativo** → oculta ambos (valor e unidade de medida). | + | |
| - | + | ||
| - | ---- | + | |
| - | + | ||
| - | ==== 7.5 Regras Específicas do Cadastro de Benefício por Lote ==== | + | |
| - | + | ||
| - | * Todos os processos selecionados receberão um **benefício individual**, | + | |
| - | * Cada benefício será criado com: | + | |
| - | * Estado = **PROPOSTA**; | + | |
| - | * Origem do benefício = **PRINCIPAL**; | + | |
| - | * Situação Interna = **Em elaboração**. | + | |
| - | * O **Documento Vinculante** não é escolhido pelo usuário. Para cada processo, o sistema seleciona automaticamente: | + | |
| - | **→ a última Instrução Técnica emitida pela Unidade Técnica daquele processo.** | + | |
| - | * Caso qualquer processo do lote apresente erro: | + | |
| - | * nenhum registro é realizado; | + | |
| - | * o lote não é salvo; | + | |
| - | * o sistema informa qual processo falhou e o motivo. | + | |
| - | + | ||
| - | Exemplos de erros que impedem o salvamento: | + | |
| - | + | ||
| - | * processo sem jurisdicionado válido; | + | |
| - | * processo que já possui benefício ativo incompatível com nova inclusão; | + | |
| - | * processo já marcado anteriormente como “sem benefício”; | + | |
| - | * ausência de Instrução Técnica válida para a Unidade Técnica responsável; | + | |
| - | * campos obrigatórios da modal não preenchidos. | + | |
| - | ---- | + | Natureza = Quantitativo Não Financeiro → mostra Unidade de Medida/ |
| - | ==== 7.6 Regras Gerais ao Salvar o Lote ==== | + | Natureza |
| - | O comportamento no momento do salvamento depende da opção escolhida. | + | ==== Fluxos ==== |
| - | === 7.6.1 Caso 1 – “Sem benefício” marcado | + | ===== Fluxo 01 – Cadastro de Benefícios em Lote ===== |
| - | * A justificativa é obrigatória. | + | ^Passo^Ação^Regra^Tela| |
| - | * O sistema | + | |01|Usuário acessa o menu “Cadastro BACE em Lote” no sistema |
| - | * Os registros são independentes (um por processo) e vinculados | + | |02|Sistema exibe a tela inicial com Código do Lote, Identificação do Lote e área de seleção de processos.|RN-L01|Tela Lote 01| |
| - | * Nenhum | + | |03|Usuário informa o número de um processo no campo “Nº do Processo”.|RN-L01|Tela Lote 01| |
| + | |04|Sistema consulta a base e valida o processo (existência, | ||
| + | |04A|Se o processo não for elegível, o sistema bloqueia a inclusão e exibe mensagem: “Processo não encontrado ou não elegível | ||
| + | |04B|Se o processo | ||
| + | |04C|Se o processo já possuir benefício ativo ou registro de “Sem benefício”, | ||
| + | |05|Estando válido, usuário clica no botão “Inserir”.|RN-L02|Tela Lote 01| | ||
| + | |06|Sistema adiciona o processo à tabela de processos do lote.|RN-L02|Tela Lote 01| | ||
| + | |07|Usuário deseja buscar múltiplos processos e clica em “Buscar Processos”.|RN-L03|Tela Lote 01| | ||
| + | |08|Sistema exibe a Modal de Seleção de Processos com filtro de pesquisa e lista paginada.|RN-L03|Tela Lote Modal Buscar| | ||
| + | |09|Usuário marca um ou mais processos na lista.|RN-L03|Tela Lote Modal Buscar| | ||
| + | |10|Usuário clica no botão “Adicionar X processo(s)”.|RN-L04|Tela Lote Modal Buscar| | ||
| + | |11|Sistema fecha a modal e adiciona todos os processos selecionados | ||
| + | |12|Usuário não marca o checkbox “Sem benefício”, | ||
| + | |13|Usuário clica no botão “Cadastrar Benefício (lote)”.|RN-L11, | ||
| + | |14|Sistema verifica se há pelo menos um processo | ||
| + | |15|Estando tudo correto, sistema exibe a Modal de Cadastro de Benefício em Lote com todos os campos obrigatórios.|RN-L05, | ||
| + | |16|Usuário preenche os campos: Unidade Técnica, Estado, Momento do Registro, Ação de Controle, Marcador Temático, Áreas, Tipo/ | ||
| + | |17|Sistema valida os campos obrigatórios; | ||
| + | |18|Usuário confirma clicando no botão “Salvar” da modal.|RN-L07|Tela Lote Modal Benefício| | ||
| + | |19|Sistema fecha a modal e retorna | ||
| + | |20|Usuário clica em “Salvar lote”.|RN-L08, | ||
| + | |21|Sistema valida novamente os processos | ||
| + | |22|Estando tudo correto, sistema registra um benefício individual por processo, aplicando automaticamente a última Instrução Técnica vinculante de cada processo.|RN-L08, | ||
| + | |23|Sistema grava o histórico de cada processo: inclusão via lote, dados principais do benefício e usuário responsável.|RN-L10|Processo Interno| | ||
| + | |24|Sistema exibe mensagem de sucesso “Lote processado com sucesso.” e marca o lote como concluído.|RN-L17|Tela Lote 01| | ||
| - | === 7.6.2 Caso 2 – Cadastro | + | ===== Fluxo 02 – Remoção |
| - | * Para cada processo | + | ^Passo^Ação^Regra^Tela| |
| - | * O documento vinculante é selecionado automaticamente (última Instrução Técnica aplicável). | + | |01|Usuário visualiza a lista de processos adicionados ao lote.|RN-L02|Tela Lote 01| |
| - | * O histórico de cada processo | + | |02|Usuário identifica o processo |
| - | * usuário criador; | + | |03|Usuário clica no ícone " |
| - | * data e hora; | + | |04|Sistema remove o processo |
| - | * unidade técnica; | + | |05|Sistema atualiza a tabela exibida, refletindo a remoção.|RN-L15|Tela Lote 01| |
| - | * ação: *“Inclusão de benefício via cadastro em lote”*; | + | |06|Se, após a remoção, a lista ficar vazia, o sistema desabilita o botão “Salvar lote” |
| - | * dados principais do benefício. | + | |
| - | === 7.6.3 Comportamento comum aos dois casos === | + | ===== Fluxo 03 – Registro de “Sem Benefício” em Lote ===== |
| - | * O lote é considerado concluído após operação bem-sucedida. | + | ^Passo^Ação^Regra^Tela| |
| - | * O histórico do processo | + | |01|Usuário acessa o menu Cadastro BACE em Lote.|RN-L01|Tela Lote 01| |
| + | |02|Usuário seleciona processos manualmente ou pela Modal de Busca.|RN-L01, | ||
| + | |03|Usuário marca o checkbox “Sem benefício”.|RN-L11|Tela Lote 01| | ||
| + | |04|Sistema desabilita o botão “Cadastrar Benefício (lote)” e exibe o campo Justificativa como obrigatório.|RN-L11, RN-L12|Tela Lote 01| | ||
| + | |05|Usuário preenche a justificativa para ausência de benefício.|RN-L12|Tela Lote 01| | ||
| + | |05A|Se o usuário tentar salvar o lote sem justificativa, | ||
| + | |06|Usuário clica em “Salvar lote”.|RN-L12, | ||
| + | |07|Sistema registra um evento de “Sem benefício” para cada processo | ||
| + | |08|Sistema grava o histórico individual dos processos, indicando | ||
| + | |09|Sistema exibe mensagem de sucesso “Lote de ‘Sem benefício’ registrado com sucesso.” e conclui o lote.|RN-L17|Tela Lote 01| | ||
| - | ---- | + | ===== ===== |
| - | ==== 7.7 Restrições do Módulo | + | ===== Regras de Negócio – Cadastro BACE em Lote (RN-L) ===== |
| - | * Não é permitido cadastrar **VRF em lote** (o módulo | + | ^Regra___^Descrição| |
| - | | + | |RN-L01|O campo “Nº do Processo” deve realizar autocompletar exibindo apenas processos válidos, já analisados pela Unidade Técnica e elegíveis para registro |
| - | * Não é permitido misturar, no mesmo lote: | + | |RN-L02|Não é permitido |
| - | * cadastro | + | |RN-L03|A Modal de Seleção de Processos deve exibir apenas processos aptos (sem benefício ativo incompatível, |
| - | * A Unidade Técnica | + | |RN-L04|Ao retornar da Modal de Seleção, processos que já constem na lista do lote não devem ser adicionados novamente; caso isso ocorra, o sistema informa: “Alguns processos já estavam no lote e não foram adicionados novamente.”| |
| - | | + | |RN-L05|A Modal de Cadastro de Benefício em lote deve considerar automaticamente que o Estado inicial é PROPOSTA, restringindo os Momentos de Registro disponíveis aos compatíveis com esse Estado (e com eventuais mudanças de Estado feitas pelo usuário).| |
| + | |RN-L06|Os campos exibidos na Modal de Benefício em lote seguem as regras de natureza (financeira, | ||
| + | |RN-L07|O sistema não deve permitir o salvamento de benefício | ||
| + | |RN-L08|Ao salvar | ||
| + | |RN-L09|Para benefícios em lote, o Documento Vinculante é sempre selecionado automaticamente: | ||
| + | |RN-L10|Sempre que um benefício ou registro de “Sem benefício” for gerado via lote, o sistema | ||
| + | |RN-L11|Quando o usuário marcar “Sem benefício”, | ||
| + | |RN-L12|Ao marcar “Sem benefício”, o campo Justificativa torna-se obrigatório. Se o usuário tentar salvar o lote sem justificativa, | ||
| + | |RN-L13|Ao salvar um lote marcado como “Sem benefício”, | ||
| + | |RN-L14|Em lote, não é permitido cadastrar benefício para processos que não possuam jurisdicionado válido ou que estejam bloqueados pelas regras gerais | ||
| + | |RN-L15|A remoção | ||
| + | |RN-L16|O sistema deve impedir a ação “Salvar lote” quando não houver processos na lista; também deve desabilitar a opção de cadastrar benefício enquanto a lista estiver vazia, exibindo: “Inclua ao menos um processo para salvar o lote.”| | ||
| + | |RN-L17|Ao concluir o salvamento do lote (benefício | ||