EN

Nº 02de 12Destaque

Atlas — mercado de previsão

Mercado de previsão fechado para a Atlas Inc.: livro de ordens com contratos SIM/NÃO de 1 a 99 centavos, o servidor como única autoridade sobre o saldo e um invariante contábil provado por teste sob concorrência

Ano
2026
Status
EM CURSO
Papel
Entrar, Administração e redesign do front · time de 5
Stack
Python · FastAPI · PostgreSQL · Next.js +7
atlas
Atlas — mercado de previsão — Mercados — a chance de SIM no tempo e o pulso de negócios do último minuto, com os bots negociando
5 capturas

1 de 5

Atlas — mercado de previsão — Mercados — a chance de SIM no tempo e o pulso de negócios do último minuto, com os bots negociando

Mercados — a chance de SIM no tempo e o pulso de negócios do último minuto, com os bots negociando

01O projeto

Case “Projeto Oakwood” da Insper Code Jr. em 2026.2, com a Atlas Inc. como cliente: uma plataforma fechada de mercado de previsão, só com moeda simulada, em que participantes convidados negociam contratos binários — a cota do resultado vencedor paga uma unidade, e o preço, de 1 a 99 centavos, funciona como a probabilidade que o grupo dá ao evento. São cinco telas: Entrar, Mercados, Mercado (livro de ordens, boleta, gráfico e fita de negócios), Carteira e Administração. A dificuldade não está nas telas, está na contabilidade: a soma dos saldos livres com o colateral retido tem que igualar o total injetado a todo instante, com várias pessoas operando ao mesmo tempo, e um teste de concorrência prova isso. É projeto de um time de cinco, e sou o maior autor do repositório — 93 dos 240 commits da main e 15 PRs mergeados. Motor de casamento, razão contábil, liquidação, infraestrutura e coordenação são dos colegas; o que é meu está nos destaques.

02O que foi feito

  1. GET /ledger/events, meu: o razão lido como feed, com a soma de cada evento e os totais da plataforma (livre, reservado, colateral e creditado) calculados no servidor no mesmo retrato REPEATABLE READ, e a identidade da contraparte redigida antes de sair do servidor

  2. Telas Entrar e Administração de ponta a ponta: acesso só por convite de uso único (token de 256 bits guardado como sha256), senha em Argon2id, sessão que expira, papéis participante, admin e auditor, e auditoria com filtros

  3. Redesign do front inteiro com tema claro e escuro por tokens de CSS e contraste AA nos dois, mais a Carteira nova com o patrimônio no tempo — um PR de +13.321/−4.434 linhas em 80 arquivos

  4. Cinco bots de demonstração (formador de mercado, tendência, contrarian, ruído e baleia) negociando só pela API, num profile opcional do Docker Compose: o livro, o gráfico e o monitor da Administração se mexem sem ninguém operar

  5. Prévia da resolução só leitura para o admin — com um teste que resolve o mercado de verdade e confere que a liquidação fez o que a prévia disse —, notícias do mercado somente-acréscimo e GET /me/trades para refazer o patrimônio

  6. Do time: casamento por preço e chegada, razão somente-acréscimo, liquidação e o invariante provado por dois testes de concorrência, rodados 20 vezes seguidas a cada merge na main; mais de 900 testes no backend

03Decisões

Decisão 01

Pergunta: Por que convite de uso único e não uma lista de e-mails permitidos?

Resposta: A plataforma é fechada, e o convite dá controle por pessoa: cada um é criado, revogado e aceito individualmente, já com o papel, e criar, revogar e aceitar viram evento de auditoria — fica o rastro de quem convidou quem. O token tem 256 bits e o banco guarda só o sha256 dele; o aceite trava a linha do convite para dois aceites simultâneos não criarem duas contas.

Decisão 02

Pergunta: Por que o feed do razão é consulta com cursor e não WebSocket?

Resposta: WebSocket ou SSE pediriam uma conexão longa por pessoa e um jeito de avisar entre as instâncias da API, que o projeto não tem; para dezenas de pessoas, chamar de novo com um cursor no id do evento basta. O que importa é outra coisa: a soma de cada evento e os totais saem do servidor no mesmo retrato REPEATABLE READ, então livre + reservado + colateral = creditado vale em toda resposta, mesmo com gente negociando no meio.

Decisão 03

Pergunta: Por que a prévia da resolução não bloqueia o botão de confirmar?

Resposta: Porque a tentativa bloqueada na tela nunca chegaria à API e deixaria de ir para a auditoria. A prévia só lê — não trava nada nem grava auditoria — e mostra também a posição de quem pede; a recusa por conflito de interesse continua na resolução, que trava o mercado, registra a tentativa e explica o motivo. Entre a prévia e a confirmação alguém pode negociar, então quem decide é a resolução.

04Capturas

  • mercado-livro.webp

    Mercado no tema escuro — livro de ordens com profundidade e a fita de negócios ao vivo

  • carteira.webp

    Carteira — o patrimônio no tempo e o saldo dividido entre disponível, reservado e em posições

  • administracao.webp

    Administração — o invariante verificado ao vivo e o razão lido como feed, com a soma de cada evento

  • entrar.webp

    Entrar no tema escuro — acesso só por convite, sem cadastro público

1 de 5

Atlas — mercado de previsão — Mercados — a chance de SIM no tempo e o pulso de negócios do último minuto, com os bots negociando

Mercados — a chance de SIM no tempo e o pulso de negócios do último minuto, com os bots negociando

05Stack

  • Python
  • FastAPI
  • PostgreSQL
  • Next.js
  • TypeScript
  • Docker Compose
  • pytest
  • Playwright
  • GitHub Actions
  • Render
  • Supabase
Próximo projeto →Nº 03

E-commerce transacional em Spring Boot: outbox com retry exponencial, idempotência de webhook e rate limit em Redis com circuit breaker