¶ Regras com Limite e Intervalo de Tempo
Created on: 08/01/2026
Este documento detalha as novas funcionalidades de controle de exceções implementadas no sistema. Agora é possível configurar limites diários de ocorrências e estipular janelas de tempo precisas para a ativação das regras.
O objetivo destas melhorias é prevenir a sobrecarga de alertas no sistema e oferecer ferramentas para criar políticas de monitoramento mais aderentes à realidade operacional, como respeitar o horário de funcionamento das lojas ou turnos específicos de trabalho.
⚠️ Requisito do Sistema Para utilizar estas funcionalidades, é obrigatório que o easiboxsrv esteja na versão 3.0.0 ou superior.
¶ 1. Limitar e Repetir
A nova seção Limitar oferece ao administrador um controle rígido sobre o volume de exceções geradas. Ela permite definir exatamente quantas vezes uma regra específica pode ser disparada dentro de um único dia.
Esta funcionalidade é essencial para evitar "floods" (inundações) de eventos repetitivos e permite estabelecer políticas de frequência adequadas para cada tipo de alerta.
¶ Como Funciona
O funcionamento baseia-se em um contador diário que respeita o ciclo de 24 horas:
Definição de Máximo: O usuário estipula um número máximo de exceções permitidas (o teto diário).
Bloqueio Automático: Assim que esse limite é atingido, o sistema interrompe a geração de novas exceções para aquela regra específica.
Reinício do Ciclo: O contador é zerado e a geração de exceções é reabilitada automaticamente apenas no dia seguinte, à meia-noite (00:00).
Abrangência: Esta lógica é universal dentro do sistema, aplicando-se tanto para regras convencionais quanto para regras genéricas.
💡 Exemplo Prático Imagine uma regra de "Produto sem registro". Você pode configurar "No máximo 50 exceções por dia".
Isso é extremamente útil em cenários de testes, auditorias ou monitoramentos intensivos que costumam gerar um alto volume de eventos em curto período, evitando que o painel de controle fique poluído.
¶ 2. Intervalo de Tempo
A seção Intervalo de Tempo foi projetada para oferecer controle granular sobre quando o sistema deve atuar. Ela permite restringir a geração de exceções a horários específicos do dia, sendo ideal para alinhar o monitoramento ao horário comercial de lojas ou às jornadas de trabalho das equipes.
¶ Funcionalidades e Interação
A interface utiliza uma grade visual semanal que facilita a manipulação dos horários:
-
Seleção Visual: A configuração é feita em uma grade que representa os dias da semana (eixo vertical) e as horas do dia (eixo horizontal).
-
Criação e Movimentação: Você pode criar novos intervalos simplesmente clicando na linha do dia desejado. Além disso, é possível arrastar blocos inteiros com o ponteiro do mouse para deslocar o período de exceção sem alterar sua duração.
-
Redimensionamento de Precisão: As barras pretas localizadas nas extremidades esquerda e direita de cada bloco são alças de ajuste. Ao clicar e arrastar essas bordas, você pode aumentar ou diminuir a duração do intervalo com precisão.
-
Múltiplos Intervalos: O sistema permite segmentar o dia em vários períodos. Cada dia da semana suporta a criação de até 8 intervalos diferentes (ex: monitorar de manhã, pausar no almoço e retomar à tarde).
-
Remoção Rápida: Para excluir um intervalo específico sem abrir menus, basta realizar três cliques rápidos sobre o bloco desejado.
-
Replicação de Configurações (Copiar): Para agilizar a configuração, blocos criados em um dia podem ser copiados para outros. Ao acionar a cópia, uma janela permite selecionar para quais dias da semana (Segunda, Terça, etc., ou Todos) aquele intervalo deve ser replicado.
-
Limpeza Total do Dia: Existe uma função dedicada (ícone de lixeira ou borracha na linha do dia) para remover todos os intervalos configurados para aquele dia específico de uma só vez, após confirmação.
-
Visualização de Frequência: Um ícone informativo representado pela letra "i" exibe detalhes sobre a periodicidade configurada, mostrando com que frequência as exceções serão geradas (ex: "Exceções a cada: 80 minutos").
💡 Exemplo de Aplicação Configurar o sistema para permitir exceções somente das 08h às 18h, de segunda a sábado, garantindo que nenhum alerta seja gerado fora do expediente ou aos domingos.
¶ 3. Integração com o EASiCash/Darwin
As novas seções de Limitar e Intervalo de Tempo não são módulos isolados; elas foram integradas à arquitetura central do EASiCash.
Isso significa que estas ferramentas estão disponíveis universalmente e podem ser utilizadas livremente em todas as regras convencionais e genéricas do sistema, acessíveis através das abas de configuração da regra.
¶ 4. Exemplos Práticos
Abaixo, detalhamos como configurar uma regra que combine ambas as funcionalidades para máxima eficiência.
¶ A. Regra Genérica com Intervalo de Tempo e Limite
Neste cenário, vamos criar ou editar uma Regra Genérica que respeite duas condições simultâneas: um teto de ocorrências e uma restrição de horário.
- Configurando o Limite de Quantidade Acesse a aba de configurações e defina a condição: "Máximo de 10 exceções por dia".
No campo Quantidade de Exceções, insira o valor 10. Isso garante que, após o décimo alerta, a regra entre em silêncio até o dia seguinte.
- Configurando o Horário Comercial Defina a condição: "Apenas em horário comercial (08:00 – 18:00)".
Na grade de horários, crie um intervalo que comece às 08:00 e termine às 18:00 na segunda-feira.
Utilize os recursos da interface para ajustar: use as bordas pretas para fixar os horários exatos, mova o bloco se necessário, ou copie este intervalo para os demais dias da semana (Terça a Sexta).
