Regras
O que o sistema considera problema — construtor visual de condições, papéis, confirmação por leituras e simulação obrigatória.
Regras
Menu: Saúde da Rede → Regras
Permissão necessária: health.view (ver) · health.rules.manage (criar, editar, ativar/desativar, apagar)
Define o que a rotina de detecção considera problema. Cada regra compara métricas com limites e, quando confirmada, ativa um motivo — que abre card, complementa um card existente ou abre um incidente de PON.

A tela separa:
- Regras do sistema — vieram de fábrica; podem ser calibradas e desativadas, nunca apagadas.
- Criadas por você — regras personalizadas da sua rede.
A lista de regras
| Coluna | O que mostra |
|---|---|
| Nome e Chave | O nome que aparece nas telas e o identificador fixo da regra. |
| Papel | O que a regra faz quando confirma (veja abaixo). |
| Severidade | A prioridade do card que ela abre. |
| Motivos vivos | Quantos motivos desta regra estão ativos agora. |
| Ativa | A chave que liga e desliga a regra. |
| Ações | Editar, Duplicar (cria uma cópia para ajustar) e Excluir. |
O botão Nova regra fica no topo. Sem health.rules.manage, a lista é só de leitura.
Papel da regra
| Papel | O que faz quando confirma |
|---|---|
| Abre card | Cria um card na Fila para o assinante. |
| Complementa card existente | Anexa o motivo a um card já aberto — não cria outro. |
| Abre incidente de PON | Cria uma queda coletiva na PON, em vez de cards individuais. |
O construtor visual
Nada de sintaxe: a condição é montada escolhendo em listas — contexto (a conexão, o CPE, a ONU, a PON, o cliente), métrica, operador e valor, combináveis com E/OU e grupos aninhados. Enquanto você monta, o painel Em português traduz a árvore em uma frase: QUANDO a ONU desta conexão estiver com sinal óptico abaixo de −27 dBm ENTÃO abrir um card.
Métricas disponíveis vêm do catálogo (fonte · unidade · natureza · verificável): quedas de sessão, sinal óptico de ONU e CPE, memória, temperatura, nota geral da CPE, nota do Wi-Fi, dispositivos com Wi-Fi fraco, tempo sem contato, portas CGNAT negadas, ONUs offline/sinal ruim na PON, entre outras.
Campos que mudam o comportamento
| Campo | Efeito |
|---|---|
| Leituras para ativar | Quantas leituras seguidas confirmando antes de ativar o motivo — uma leitura isolada não abre card. |
| Período de silêncio (min) | Para métricas de evento (sem estado para reler): o motivo encerra depois desse tempo sem novas ocorrências. |
| Severidade | Baixa · Média · Alta · Crítica — define a prioridade do card. |
| Chave | Imutável após a criação; identifica a regra no histórico. |
Uma regra que abre card precisa usar métrica verificável (com estado para reler depois da ação) — card que não consegue fechar sozinho não pode ser criado automaticamente. O construtor avisa quando a combinação não fecha.

Simulação obrigatória
Antes de ativar, o botão Testar roda a regra contra a rede de hoje, sem criar nada: quantos assinantes casariam, quantos não, quantos foram pulados (e por quê — fonte indisponível, sujeito não resolvido, sem dado) e o resumo honesto: "Geraria N cards novos numa fila de M hoje". Só depois de simular o botão Salvar e ativar libera (antes, ele mostra a dica Simule a regra antes de ativar); Salvar desativada está sempre disponível e guarda a regra sem ligá-la. Se você mudar uma condição depois de testar, simule de novo.

Regras com histórico de motivos não podem ser apagadas — apenas desativadas. Isso preserva a trilha de Resultados e das execuções antigas.