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.
  • Se o daemon CLI não estiver no supervisor do host, o credenciamento “trava”.
  • Introduzir Kafka/SQS exige novo ADR (custo de operação vs. perda de evento). Até lá, runbook assume polling.