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:
- Daemon CLI (
while true+sleep) para polling de credenciamento. - Endpoints HTTP de polling chamados pela UI ou por cron externo.
- 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_hashno webhook de assinatura. - Em 19/09/2026 o polling de credenciamento na adquirente está desligado
(
PollingCredenciamentos::executarPollingsó 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).