feat(v2): real Slack send pipeline (guard, idempotency, success/failure registration)

Implements the actual send branch: Selecionar Top N -> Montar Mensagem ->
Guard de Envio -> Slack real -> registrar resultado (only after
confirmed success/failure) -- previously simulated/absent.

logic/slack.js (new): shouldSendByConfig (SEND_ENABLED gate, defaults
false), computeMessageHash (djb2Hash of the exact message text, reused
from logic/hash.js), alreadySentSuccessfully (idempotency check: only a
prior status='success' record for the same report_date+run_type+
message_hash blocks a resend -- a prior 'failed' record does not, so
retries after a real failure aren't stuck), evaluateSendGuard (single
auditable decision combining both), buildEnvioDigestRecord.
logic/slack.test.js: 13 tests covering all of the above, explicitly
labeled against the mission's required tests #13-#16.

New node drivers:
- guard-envio-slack.node.js: reads the digest + recent envio records
  (fetched by report_date), computes the send decision.
- Slack node itself (n8n-nodes-base.slack, native, not a raw webhook):
  reuses the real "Slack account" credential (slackApi) and
  $vars.SLACK_CHANNEL_TECNICO channel variable already used by this
  org's own "Notificacao de Erros Globais" workflow on the same n8n
  instance -- V1's own Slack webhook URL was never actually deployed
  (its Config value is literally "SEU/WEBHOOK/AQUI", same class of
  placeholder as the old GLPI URL from the prior cycle), so this reuses
  the one REAL, credentialed Slack mechanism that exists in this
  environment rather than inventing a new destination. onError:
  continueErrorOutput splits success/failure into two branches.
- registrar-envio-sucesso.node.js / registrar-envio-falha.node.js: build
  the success/failure record; only the success path continues to the
  existing per-ticket send-counter logic (rewired below).
- lancar-erro-envio.node.js: after the failure record is written,
  explicitly throws so the n8n execution shows status=error (never
  silently swallow a send failure).
- pular-envio.node.js: terminal no-op for the "should not send" branch
  (SEND_ENABLED=false or already sent today), for observability only.

n8n/nodes/prepare-envio-record.node.js: rewired to read the Top10
selection by name ($('Code - Selecionar Top 10').all()) instead of
$input, since it now runs downstream of the Slack-success registration,
not directly off Selecionar Top10 -- registering per-ticket send counts
before Slack ever confirmed anything was the exact "don't register
before confirmation" bug the mission called out.

logic/message.test.js: added a full-Top10 message-length regression test
(mission requirement: message stays short, no leaked JSON/score/evidence).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Gustavo
2026-08-24 20:50:54 -03:00
co-authored by Claude Sonnet 5
parent e0f4b9a5d0
commit abc690ddb7
9 changed files with 225 additions and 1 deletions
+26
View File
@@ -0,0 +1,26 @@
// @requires config.js hash.js slack.js
// Roda depois de "Data Table - Buscar Envios Recentes" (fetch por report_date=hoje), que existe
// so pra trazer os registros de envio ja existentes; os dados do digest sao lidos por nome
// (mesmo padrao ja usado em Code - Comparar Legacy x V2).
const digestData = $('Code - Montar Digest Coordenacao').first().json; // { mensagem, selected, excluded, dateStr, digest, changedBlocked }
const config = digestData.selected.length ? digestData.selected[0].config : parseConfig($('Config - Coordenador GLPI v2').first().json);
const existingRecords = $input.all().map((item) => item.json);
// $execution.mode: 'manual' quando disparado pelo Manual Trigger, senao ('trigger' no
// Schedule Trigger) tratamos como execucao agendada. Nao inventa um mecanismo novo de deteccao.
const runType = $execution.mode === 'manual' ? 'manual' : 'scheduled';
const messageHash = computeMessageHash(digestData.mensagem);
const guard = evaluateSendGuard({
config, existingRecords, reportDate: digestData.dateStr, runType, messageHash,
});
return [{
json: {
mensagem: digestData.mensagem,
dateStr: digestData.dateStr,
runType,
messageHash,
shouldSend: guard.shouldSend,
reason: guard.reason,
},
}];
+10
View File
@@ -0,0 +1,10 @@
// Roda depois de "Data Table - Registrar Envio Digest (Falha)" ja ter gravado o status=failed.
// So agora propaga o erro de verdade, pra a execucao no n8n ficar visivelmente com status de
// erro (missao "finalizacao para producao", secao 19: "Nao silenciar erro").
const registro = $input.first().json;
throw new Error(`Envio ao Slack falhou (report_date=${registro.report_date}, run_type=${registro.run_type}): ${registro.error_detail}`);
// eslint-disable-next-line no-unreachable -- linha morta de proposito: o validador estatico do
// n8n-mcp exige um "return" literal no texto do node (heuristica que nao reconhece um node cujo
// unico proposito e lancar erro -- confirmado via validate_node, mesmo comportamento do falso
// positivo do .join() ja documentado neste projeto). Nunca executa; o throw acima sempre sai primeiro.
return [];
+4 -1
View File
@@ -1,6 +1,9 @@
const ONE_DAY = 24 * 60 * 60 * 1000;
return $input.all()
// So roda depois de "Data Table - Registrar Envio Digest (Sucesso)" -- ou seja, so depois do
// Slack confirmar sucesso de verdade (missao "finalizacao para producao", secao 19). Os dados
// do Top10 sao lidos por nome (nao por $input, que aqui e o registro do envio, nao os tickets).
return $('Code - Selecionar Top 10').all()
.filter((item) => item.json._grupo === 'selected')
.map((item) => {
const data = item.json;
+5
View File
@@ -0,0 +1,5 @@
// Branch "nao deve enviar" do guard (SEND_ENABLED=false ou ja enviado com sucesso hoje).
// Node terminal, so pra deixar visivel na execucao do n8n por que nao mandou nada -- sem
// escrever em nenhuma Data Table (nao e uma falha, e uma decisao esperada).
const data = $input.first().json;
return [{ json: { skipped: true, reason: data.reason, dateStr: data.dateStr, runType: data.runType } }];
+18
View File
@@ -0,0 +1,18 @@
// @requires hash.js slack.js
// So roda no output de erro do node "Slack - Enviar Mensagem" (onError: continueErrorOutput).
// Registra status=failed com o erro real ANTES de propagar a falha (proximo node lanca o
// erro de verdade, pra execucao ficar visivelmente vermelha no n8n -- nao silenciar).
const guardData = $('Code - Guard de Envio Slack').first().json;
const errorItem = $input.first().json || {};
const errorMessage = String(errorItem.error || errorItem.message || 'Erro desconhecido ao enviar mensagem ao Slack').slice(0, 500);
const record = buildEnvioDigestRecord({
reportDate: guardData.dateStr,
runType: guardData.runType,
messageHash: guardData.messageHash,
sentAt: Date.now(),
status: 'failed',
errorDetail: errorMessage,
});
return [{ json: record }];
+14
View File
@@ -0,0 +1,14 @@
// @requires hash.js slack.js
// So roda no output de sucesso do node "Slack - Enviar Mensagem" (onError: continueErrorOutput).
// Registrar sent_at/status so DEPOIS da confirmacao real do Slack -- nunca antes (missao
// "finalizacao para producao", secao 19).
const guardData = $('Code - Guard de Envio Slack').first().json;
const record = buildEnvioDigestRecord({
reportDate: guardData.dateStr,
runType: guardData.runType,
messageHash: guardData.messageHash,
sentAt: Date.now(),
status: 'success',
});
return [{ json: record }];