Pular para o conteúdo principal

ADR 0006 — Sem Kafka/SQS; polling e CLI para trabalho assíncrono

  • Status: aceito
  • Data: 2026-07

Contexto​

Credenciamento na adquirente e sincronização de transações são assíncronos do ponto de vista do operador. Kafka, SQS ou Redis dariam retry e DLQ, mas exigem infra que o hospedeiro e o time não operam hoje.

Decisão​

Três padrões, e só esses:

  1. Daemon CLI (while true + sleep) para polling de credenciamento.
  2. Endpoints HTTP de polling chamados pela UI ou por cron externo.
  3. Polling no browser (dashboard de transações).

Webhooks existem onde o provedor já empurra evento (Autentique).

Consequências​

  • Sem garantia de exactly-once além de event_hash no webhook de assinatura.
  • Em 19/09/2026 o polling de credenciamento na adquirente está desligado (PollingCredenciamentos::executarPolling só loga). O status do EC não depende mais desse daemon.
  • Introduzir Kafka/SQS exige novo ADR (custo de operação vs. perda de evento). Até lá, runbook assume polling só onde ainda existir (transacoes/polling.php).