Todos os projetos

Alva Hub

Camada de eventos sobre a API do Omie com retry, dead-letter, circuit breaker e idempotência.

Sistema interno, sem acesso público.

Sobre o projeto

Serviço que centraliza a comunicação com a API do Omie e entrega os eventos para os outros sistemas da empresa.

Ele foi desenhado para falhar bem: tarefas com limite de tentativas e dead-letter, replay de eventos pelo admin, circuit breaker para quedas da API do Omie, rate limit e token por destino, chave de idempotência e número de sequência em cada entrega.

As filas são isoladas por conta do ERP, então um problema numa conta não trava as outras, e o time recebe um e-mail quando um evento cai na dead-letter.

Leia o artigo: Filas

O que foi entregue

  • max_retries e dead-letter em todas as tarefas
  • Replay de eventos em dead-letter pelo admin
  • Circuit breaker global para falhas sistêmicas do Omie
  • Rate limit e token de autenticação por destino
  • Idempotência (X-Delivery-ID) e sequence_number nas entregas
  • Filas isoladas por conta do ERP

Como funciona

  1. 01 · Origem
    • API do Omie
  2. 02 · Alva Hub
    • Tarefas Celery
    • Retry e dead-letter
    • Circuit breaker
  3. 03 · Entrega
    • Idempotência
    • Sequência
    • Rate limit por destino
  4. 04 · Destinos
    • Sistemas internos via webhook
Próximo projeto →FlyUp BPO