Plano de Teste E2E dos Incidentes do n8n
P0Pré-condições
Sem isto, qualquer falha nos casos vira falso negativo.
| # | Item | Como conferir | Critério de pronto |
|---|---|---|---|
| 0.1 | Banco | Schema os_incidentes no administrativo | Exposto no PostgREST, config com modo e travas |
| 0.2 | Leitura dos erros | Papel incidentes_leitor no operacional | Lê aai_logs.n8n_errors e só altera as colunas de resolução |
| 0.3 | Motor | Serviço do motor na manager | Imagem 0.6.x rodando, heartbeat a menos de 1 min |
| 0.4 | Ferramentas do agente | MCP n8n-ops no motor | Lê execução com dados, faz backup, patch, retry e restauro |
| 0.5 | Error Notificator | Workflows de alerta | Grava o erro no registro central e avisa no grupo técnico |
Todo erro registrado vira ocorrência de exatamente um incidente.
T1Erro registrado vira incidente
Fase 1 sozinhoObjetivo: uma linha nova no registro de erros abre um incidente em até um ciclo do motor.
T2Erros iguais agrupam
Fase 1 sozinhoObjetivo: o mesmo erro repetido soma ocorrências no incidente aberto em vez de abrir outro.
T3Reprocessar não duplica
Fase 1 sozinhoObjetivo: ler de novo o mesmo erro não cria ocorrência repetida.
T4Triagem sem agente
Fase 1 sozinhoObjetivo: erro do próprio Error Notificator, sem workflow ou de workflow travado vai direto para gente.
O agente acha a causa real e respeita o modo.
T5Modo sombra não escreve
Fase 1 sozinhoObjetivo: em sombra o agente diagnostica e descreve o que faria, sem alterar nada.
T6Correção humana já no ar
Fase 1 sozinhoObjetivo: se o workflow foi editado depois do erro, o agente confere a edição e não aplica patch por cima.
T7Cliente recuperado
Fase 1 sozinhoObjetivo: quando o notificator perde o cliente, o agente devolve o slug lido na execução.
Nenhuma escrita sem backup; quem fecha o incidente é a verificação, nunca o agente.
T8Backup antes de escrever
Fase 1 sozinhoObjetivo: toda correção tem o JSON completo do workflow salvo antes.
T9Patch mínimo em nó existente
Fase 1 sozinhoObjetivo: a correção altera só o necessário, sem criar nó, trocar credencial ou desligar o workflow.
T10Verificação independente fecha
Fase 1 sozinhoObjetivo: o incidente só fica resolvido quando o motor confirma a versão em produção e execuções sem o erro.
T11Registro de erros marcado
Fase 1 sozinhoObjetivo: ao resolver, as linhas do registro central ficam como resolvidas pelo motor.
Correção que não segura volta ao estado anterior.
T12Reverter pelo painel
Fase 1 sozinhoObjetivo: o botão Reverter para o backup faz o motor restaurar exatamente a versão anterior.
T13Reincidência reverte sozinha
Fase 1 sozinhoObjetivo: se o erro volta depois do patch, o motor restaura o backup e chama gente.
O motor não entra em loop nem gasta sem limite.
T14Um incidente por workflow
Fase 1 sozinhoObjetivo: dois incidentes do mesmo workflow não rodam ao mesmo tempo.
T15Tempestade escala
Fase 1 sozinhoObjetivo: muitas ocorrências em poucos minutos indicam causa externa; o motor não corrige, avisa.
T16Liberação gradual
Fase 1 sozinhoObjetivo: com o modo geral em sombra, só os workflows da lista de piloto automático são corrigidos.
Tudo o que o motor fez fica no banco e chega a quem precisa.
T17Detalhe no grupo do O.S
Fase 1 sozinhoObjetivo: cada desfecho gera mensagem com causa, correção, versões, backup e link do painel.
T18Resposta ao alerta no grupo técnico
Fase 1 sozinhoObjetivo: em modo automático, o desfecho responde citando o alerta original do Error Notificator.
T19Custo e rastro de cada execução
Fase 1 sozinhoObjetivo: toda execução do Claude grava tokens, turnos, duração, custo equivalente, ferramentas e transcript.
T20Trilha imutável
Fase 1 sozinhoObjetivo: a linha do tempo não pode ser editada nem apagada.
T21Painel no ar
Fase 1 sozinhoObjetivo: /incidentes mostra indicadores, séries e detalhe com dados reais.
OKCritérios de aceite para ligar o modo automático
Workflows de clientes entram na correção automática quando todos os itens abaixo forem verdadeiros.
- Todos os casos críticos aprovados na execução mais recente.
- 48 h de modo sombra sem diagnóstico errado nos erros reais.
- Reversão pelo painel verificada (T12).
- Vigia na nuvem verde.