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
Full stack · Desafio técnico
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.

Backend
Front-end
Dados
Infra e entrega
Arquitetura
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.
React 19 · Vite · TypeScript
SPA sem UI kit, tema claro/escuro com variáveis CSS e script anti-flash.
Django Channels · WebSocket
Handshake com token na query e origem validada — 403 antes de qualquer evento.
Django + DRF
Regras de lance, carteira, liquidação e auditoria em camada própria (não no serializer).
PostgreSQL + Redis
Ledger append-only como fonte da verdade; Redis como channel layer do Channels.
Tempo real
Cada etapa tem uma falha própria prevista: handshake negado, recusa com código, lock ordenado, broadcast anônimo, fallback e liquidação idempotente.
O WebSocket valida token e header Origin no handshake. Origem fora da lista recebe 403 antes de qualquer evento chegar ao browser.
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.
Lock transacional em ordem fixa: débito do licitante, liberação de quem foi superado e registro no ledger na mesma transação.
Evento `bid.placed` sai com pseudônimo — nunca a identidade. Snapshot inicial leva `you_lead` para cada cliente.
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.
No fim: vencedor debitado, comprovante criado e vendedor creditado — operação idempotente, confirmada pelo worker.
Decisões técnicas
Nenhuma decisão foi decorativa: cada uma responde a uma falha concreta de dinheiro, concorrência ou auditoria.
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.
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.
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.
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.
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.
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
A suíte verde é pré-condição de entrega, e a sabotagem — quebrar de propósito e ver falhar — é parte do processo.
Suíte rodando a cada etapa, antes de qualquer commit. A cultura do repositório é suíte verde primeiro.
Quebrar a função de propósito e ver o teste falhar para provar que ele testa o que deve.
Backend contra Postgres real e front com build + lint + testes a cada push e PR.
Vitest para dinheiro em centavos e parser de BRL, além de typecheck, lint e smoke visual.
Produção
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.
A vitrine está publicada, com lotes ao vivo, carteira e auditoria pública aberta sem cadastro.