Alerta de falhas sistêmicas
Muitas operações do PRESTOBR rodam automaticamente e em segundo plano — notificações, envios de e-mail/SMS/WhatsApp, assinatura em nuvem, conversão de documentos, captura, backup e regras de pasta. Quando uma delas falha, o erro costuma ficar invisível (registrado só em log): o usuário não é avisado e a falha pode se repetir sem ninguém perceber — por exemplo, uma assinatura automática com certificado vencido, ou o e-mail de notificação parando de sair.
Para isso, o PRESTOBR detecta falhas sistêmicas e recorrentes e envia um alerta ativo para a operação/suporte Presto (pelo BackOffice), permitindo agir na causa: renovar um certificado ou credencial, religar um serviço, liberar espaço, etc.
Como funciona
- Só falha sistêmica. Alerta apenas o que indica uma causa comum (servidor de e-mail fora, credencial/token inválido, serviço externo indisponível, cota esgotada, espaço cheio). A falha de um item isolado (um e-mail ou telefone inválido de um cliente, um PDF corrompido) não gera alerta.
- Agrupado por causa, com limiar. O sistema conta ocorrências distintas da mesma causa dentro de uma janela de tempo e dispara um alerta ao cruzar o limiar (ver tabela abaixo).
- Anti-spam. No máximo um alerta por causa a cada ~6 horas, mesmo que a falha continue acontecendo.
- Entrega garantida. O alerta é enfileirado de forma durável e sincroniza com o BackOffice assim que possível — sobrevive ao BackOffice temporariamente fora do ar.
- Nunca interrompe a operação. O envio do alerta é best-effort: se ele próprio falhar, não afeta o fluxo que o originou.
- Cada alerta chega no formato "Serviço — descrição" (ex.: Process — Envio de e-mail dos fluxos), com o detalhe da causa e a lista de itens afetados na mensagem.
O que dispara um alerta
As janelas e limiares variam conforme a cadência de cada operação (uma captura roda o tempo todo; um backup, uma vez por dia):
| Área | Exemplos de falha | Quando alerta |
|---|---|---|
| Notificações ao cliente (Portal) | e-mail, SMS, WhatsApp ou push falhando para vários destinatários; rotina de notificação interrompida; toolkit/Process inacessível; login federado (OIDC) fora | 5 casos distintos em 1 h |
| E-mails e notificações de fluxo (Process) | envio de e-mail dos passos de fluxo (Mensagem / Smartdoc) e das notificações de tarefa | ao repetir (5 ocorrências) |
| Envio para assinatura em nuvem | DocuSign, Certisign, SelbettiS-Sign — envio falhando (API, credencial ou token) | ao repetir (3 seguidas) |
| Conversão de documentos | serviço de conversão (LibreOffice) fora ou travando | ao repetir (5 ocorrências) |
| Captura (perda de dado) | jobs escaneados descartados ou movidos para a lixeira em série — páginas que não chegaram, connector/scanner fora, instância travada | ao repetir (limiar maior — captura é de alta frequência) |
| IA Gemini | todas as chaves sem cota (captura travada); API do Gemini em erro (429/403/5xx) | cota: quando persiste (> 6 h); API: ao repetir |
| Ações em lote e regras de pasta | ingestão de captura, merge de PDF, assinatura e limpeza de assinaturas em lote, atualização de propriedades, sincronização de anexos de fluxo, e ações de regra de pasta (assinatura, etc.) | 5 itens distintos em 1 h |
| Backup Agent | e-mail de notificação falhando; backup falhando; retenção não liberando espaço | 2 execuções seguidas |
| Backup Agent (crítico) | manutenção não desligou (repositório travado em somente leitura); repositório de backup corrompido | imediato |
| Certificados de assinatura | certificado de um template de assinatura perto de vencer (ver Preservação) | marcos de 30, 7 e 1 dia e no vencimento |
É um mecanismo de monitoramento: não altera o comportamento das ações — apenas torna visíveis falhas recorrentes que, de outro modo, passariam silenciosas. Os alertas chegam à operação/suporte Presto (via BackOffice), não ao usuário final.
O canal de alerta é independente do e-mail — por isso funciona justamente quando o problema é o próprio envio de e-mail/SMS. Falhas cuja causa é o próprio serviço de licenciamento/BackOffice estar fora são tratadas por outros meios (o alerta não dependeria de um canal que também estaria indisponível).
Consultar no console
Além de chegarem à operação Presto pelo BackOffice, as falhas ficam disponíveis para consulta no próprio Alfresco — útil quando o BackOffice está indisponível. No Console de Administração, grupo Operação, a página Falhas de produção (capacidade FaultsView, ver Perfis) lista, somente leitura:
- data, título e mensagem de cada falha;
- o status de entrega ao BackOffice (pendente ou enviado) e o número de tentativas;
- um filtro só pendentes e o total de pendentes.
A mensagem aparece resumida na grade; a coluna Detalhe abre a falha inteira em uma janela, com botão Copiar. Toda a lista pode ser exportada (CSV, XML, HTML ou PDF).