Tema
Arquitetura
Decisões de arquitetura em integrações: failover, timeout e circuit breaker, filas, idempotência, carteira de saldo, SSE e datas com fuso.
11 artigos
Datas e fuso: por que o vencimento volta um dia
Meia-noite em UTC convertida para São Paulo é 21h do dia anterior. A conversão está certa — o erro foi guardar um dia como se fosse um instante.
Equipe AltiviaCloud · 6 de setembro de 2026
Fila para processar pedidos em lote
O laço sequencial demora e o Promise.all derruba o limite. Concorrência limitada, estado por item e o cálculo de quantos trabalhadores cabem.
Equipe AltiviaCloud · 6 de setembro de 2026
O que cachear numa integração, e o que nunca
Catálogo sim, saldo nunca. Preço fica no meio: para exibir pode, para cobrar não — e é daí que sai a reclamação de cobrança diferente da tela.
Equipe AltiviaCloud · 6 de setembro de 2026
Carteira de saldo sem furo contábil
Ler o saldo, calcular na aplicação e gravar o resultado é como o dinheiro some. O saldo é consequência do extrato, não a verdade.
Equipe AltiviaCloud · 6 de setembro de 2026
Versionar API sem quebrar quem já integrou
Adicionar valor novo a um campo fechado quebra, ainda que pareça adição. O que quebra, o que não quebra, e como depreciar sem derrubar cliente pago.
Equipe AltiviaCloud · 6 de setembro de 2026
Comprar pronto ou construir a integração de SMS
A conta que compara margem com preço unitário ignora reconciliação, idempotência, contabilidade por fornecedor e plantão. O que entra de cada lado e por que começar comprando costuma ser o caminho.
Equipe AltiviaCloud · 5 de setembro de 2026
Timeout, retentativa e circuit breaker
fetch sem timeout espera para sempre e trava o seu sistema, não o do fornecedor. Quais falhas merecem retentativa, por que o jitter não é preciosismo e o que fazer com o circuito aberto.
Equipe AltiviaCloud · 5 de setembro de 2026
Como funciona o failover entre fornecedores
O que acontece por dentro quando você pede um número, por que uma tentativa falha sem ninguém ter caído, e o limite que o failover não cobre — nem deveria.
Equipe AltiviaCloud · 5 de setembro de 2026
SSE para eventos em tempo real, sem WebSocket
O servidor empurra evento pelo HTTP de sempre e o navegador já sabe receber. Onde o SSE ganha do polling, onde ele não serve, e os dois detalhes que só quebram em produção.
Equipe AltiviaCloud · 5 de setembro de 2026
Idempotência em webhook de pagamento
Todo provedor entrega pelo menos uma vez, nenhum entrega exatamente uma vez. Por que a guarda óbvia não protege e como deixar o banco decidir quem credita.
Equipe AltiviaCloud · 5 de setembro de 2026
Webhook ou consulta em laço: como esperar o SMS
Trinta requisições para receber um código, e vinte e nove dizem 'ainda nada'. Por que o laço não escala e quando SSE vence o webhook.
Equipe AltiviaCloud · 2 de setembro de 2026