Esta é a versão em Node.js/TypeScript do backend para o desafio "Rinha de Backend 2025". O projeto foi convertido do Python original mantendo exatamente a mesma lógica, estrutura e funcionalidades.

O sistema é responsável por processar pagamentos de forma resiliente, utilizando múltiplos gateways e realizando fallback automático em caso de falha.

├── src/
│   ├── config.ts         # Configurações do sistema
│   ├── healthCheck.ts    # Worker de healthcheck dos gateways
│   ├── main.ts           # Ponto de entrada da API
│   ├── models.ts         # Tipos e interfaces TypeScript
│   ├── client.ts         # Cliente HTTP e comunicação com gateways
│   ├── queueWorker.ts    # Worker assíncrono para processamento
│   └── storage.ts        # Persistência de dados no Redis
├── package.json          # Dependências do projeto
├── tsconfig.json         # Configuração do TypeScript
├── Dockerfile            # Dockerização da aplicação
├── docker-compose.yml    # Orquestração de containers
├── nginx.conf            # Configuração do Nginx
└── README.md

1. Clone o repositório:

   git clone <url-do-repositorio>
   cd backend-para-rinha-2025/node

2. Instale as dependências (desenvolvimento local):

   npm install

3. Configure as variáveis de ambiente:

   • As variáveis são configuradas no docker-compose.yml.

4. Suba os containers:

   docker-compose up --build

5. Acesse a aplicação:

   • Os endpoints estarão disponíveis na porta 9999.

• npm run build — Compila o TypeScript
• npm start — Inicia a aplicação compilada
• npm run dev — Executa em modo desenvolvimento
• npm run dev:watch — Executa em modo desenvolvimento com auto-reload

• Processamento resiliente de pagamentos
• Fallback automático entre gateways
• Healthcheck dos serviços integrados
• Estrutura modular e fácil de manter
• Sistema de filas em memória com workers assíncronos
• Cache distribuído via Redis

• Node.js 18+
• TypeScript
• Fastify (servidor HTTP)
• Redis (cache e persistência)
• Axios (requisições HTTP)
• Docker & Docker Compose

Adiciona um pagamento na fila para processamento.

Request Body:

{
  "correlationId": "string",
  "amount": number
}

Response: Status 202 (Accepted)

Retorna resumo de pagamentos processados.

Query Parameters:

• from (opcional): Data de início (ISO 8601)
• to (opcional): Data de fim (ISO 8601)

Response:

{
  "default": {
    "totalRequests": number,
    "totalAmount": number
  },
  "fallback": {
    "totalRequests": number,
    "totalAmount": number
  }
}

Remove todos os pagamentos armazenados.

Response:

{
  "status": "payments purged"
}

A aplicação mantém a mesma arquitetura da versão Python:

1. API Fastify - Recebe requisições HTTP
2. Queue Worker - Processa pagamentos assincronamente
3. Health Check Service - Monitora saúde dos gateways
4. Redis - Cache distribuído e persistência
5. Load Balancer - Nginx distribui requisições

• Fastify ao invés de FastAPI
• Sistema de filas em memória ao invés de asyncio.Queue
• Axios ao invés de httpx
• TypeScript para tipagem estática
• Mantém exatamente a mesma lógica de negócio

• docker-compose up --build — Sobe a aplicação e dependências
• docker-compose down — Para e remove os containers
• docker-compose logs -f — Visualiza logs em tempo real

Este projeto está licenciado sob a licença MIT.

Desenvolvido para o desafio Rinha de Backend 2025 🚀 Versão Node.js/TypeScript com mesma funcionalidade da versão Python original.