Leonardo Padilha
Voltar aos projetos

Full stack · Desafio técnico

Leilão Online

Plataforma de leilão em tempo real com carteiras, lances via WebSocket, liquidação automática e cadeia de auditoria pública. Construída como desafio de engenharia: dinheiro em centavos, concorrencia controlada e 218 testes antes de qualquer commit.

leilao-online.webp
Vitrine do Leilao Online com lotes de leilao e status ao vivo

Indicadores técnicos

Testes backend
218
Suíte verde obrigatória
Push em produção
~1 s
Latência medida no smoke
Backoff de reconexão
10 s
Teto do expoente
Polling de fallback
8 s
Enquanto o WS cai
Janela anti-snipe
2 min
Reabre o relógio
Precisão monetária
Centavos
bigint, nunca float

Stack por camada

Backend

  • Python
  • Django
  • Django REST Framework
  • Django Channels
  • ASGI (daphne)

Front-end

  • React 19
  • Vite
  • TypeScript
  • CSS com variáveis
  • Vitest

Dados

  • PostgreSQL
  • Redis
  • Ledger append-only
  • Locks transacionais

Infra e entrega

  • Docker Compose
  • GitHub Actions
  • Render
  • Vercel
  • Neon
  • Upstash

Arquitetura

Quatro camadas com responsabilidade separada.

O domínio mora fora do serializer, o tempo real é uma camada própria e a persistência separa fonte da verdade de canal de eventos.

  1. 01

    Front-end

    React 19 · Vite · TypeScript

    SPA sem UI kit, tema claro/escuro com variáveis CSS e script anti-flash.

    • /vitrine
    • /carteira
    • /comprovantes/:uuid
    • /auditoria
  2. 02

    Tempo real

    Django Channels · WebSocket

    Handshake com token na query e origem validada — 403 antes de qualquer evento.

    • bid.placed
    • auction.closed
    • snapshot
  3. 03

    Domínio

    Django + DRF

    Regras de lance, carteira, liquidação e auditoria em camada própria (não no serializer).

    • below_min
    • insufficient_funds
    • seller_forbidden
  4. 04

    Persistência

    PostgreSQL + Redis

    Ledger append-only como fonte da verdade; Redis como channel layer do Channels.

    • ledger
    • locks
    • channel layer
Fluxo de uma requisição: do browser ao banco, com o WebSocket como camada paralela para os eventos em tempo real.

Tempo real

Do clique ao comprovante, em seis passos.

Cada etapa tem uma falha própria prevista: handshake negado, recusa com código, lock ordenado, broadcast anônimo, fallback e liquidação idempotente.

  1. 01

    Handshake

    O WebSocket valida token e header Origin no handshake. Origem fora da lista recebe 403 antes de qualquer evento chegar ao browser.

  2. 02

    Validação no domínio

    Lance só entra em lote ao vivo, com incremento mínimo, fundos suficientes e o leiloeiro bloqueado. Cada recusa volta com código próprio.

  3. 03

    Lock e commit

    Lock transacional em ordem fixa: débito do licitante, liberação de quem foi superado e registro no ledger na mesma transação.

  4. 04

    Broadcast

    Evento `bid.placed` sai com pseudônimo — nunca a identidade. Snapshot inicial leva `you_lead` para cada cliente.

  5. 05

    Fallback

    Reconexão infinita com backoff capado em 10 s, retry imediato ao voltar a aba/rede e polling a cada 8 s enquanto o WS está fora.

  6. 06

    Liquidação

    No fim: vencedor debitado, comprovante criado e vendedor creditado — operação idempotente, confirmada pelo worker.

Decisões técnicas

Problema real, escolha consciente e prova.

Nenhuma decisão foi decorativa: cada uma responde a uma falha concreta de dinheiro, concorrência ou auditoria.

Centavos em bigint

Problema. Float soma errado em dinheiro e produz valores irreais.

Escolha. Todo valor vive em centavos (`bigint`) até a formatação final.

Prova. Um parser que lia `"50.5"` como 10× o valor virou um bug de R$ 505 e depois teste de regressão.

Ledger append-only

Problema. Saldo editável não audita e aceita divergência silenciosa.

Escolha. Movimentação só se acrescenta; saldo total, comprometido e disponível são derivados.

Prova. Superado, o comprometimento libera; cancelamento estorna tudo — sem UPDATE em histórico.

Lock com ordem fixa

Problema. Lances simultâneos podem deadlock ou deixar saldo negativo.

Escolha. Aquisição de lock sempre na mesma ordem, dentro de transação.

Prova. Lances concorrentes sem deadlock e sem saldo negativo nos testes de concorrência.

Anti-snipe

Problema. "Roubo de segundo": lance no último instante vencia sem reação.

Escolha. Lance nos últimos 2 minutos reabre o fim para 2 minutos a partir do lance.

Prova. Janela cheia de reação, aplicada no domínio — não no front-end.

Auditoria com HMAC

Problema. Qualquer UPDATE/DELETE quebraria a prova de integridade.

Escolha. Cadeia de hash HMAC por lote, calculada no domínio e nunca no serializer.

Prova. Verificação pública sem e-mail ou ID real: pseudônimos HMAC e comprovante por UUID.

Liquidação idempotente

Problema. Rodar o encerramento duas vezes debitaria o vencedor duas vezes.

Escolha. Liquidação idempotente + lazy settle + worker `settle_auctions_loop` (5 s).

Prova. Encerrar duas vezes não debita duas vezes, e o status não depende de cron externo.

Qualidade

218 testes antes de qualquer commit.

A suíte verde é pré-condição de entrega, e a sabotagem — quebrar de propósito e ver falhar — é parte do processo.

218 testes no backend

Suíte rodando a cada etapa, antes de qualquer commit. A cultura do repositório é suíte verde primeiro.

Sabotagem obrigatória

Quebrar a função de propósito e ver o teste falhar para provar que ele testa o que deve.

CI no GitHub Actions

Backend contra Postgres real e front com build + lint + testes a cada push e PR.

Front também testado

Vitest para dinheiro em centavos e parser de BRL, além de typecheck, lint e smoke visual.

Produção

Quatro serviços, um boot resolve tudo.

O worker de liquidação vive no boot do dyno web porque o background worker do Render free é pago — decisão documentada no repositório.

  • Front-endVercelBuild do `front/` com rewrite de SPA — link direto e reload não dão 404.
  • API + WebSocketsRenderDocker único: collectstatic → migrate → worker de liquidação embutido → daphne.
  • BancoNeonPostgreSQL serverless, configurado por `DB_HOST`/`DB_NAME`/`DB_USER`/`DB_PASSWORD`.
  • Tempo realUpstashRedis via `REDIS_URL` (TLS) como channel layer do Channels.

Ver o sistema rodando de verdade.

A vitrine está publicada, com lotes ao vivo, carteira e auditoria pública aberta sem cadastro.