Oito Lados

Brinque sem ter medo financeiro.

No ar em https://oito-lados.vercel.app.

Simulador de apostas de UFC com dinheiro fictício e odds reais. Você deposita quanto quiser de mentira, aposta no card da semana e o app acompanha as lutas ao vivo e fecha as apostas com o resultado oficial. Nenhum centavo de verdade entra ou sai.

Lutas	Cupom	Ao vivo	Carteira

As telas acima vêm do teste automatizado, com lutadores e resultados inventados.

O que faz

• Saldo fictício: depósitos ilimitados, saldo sempre derivado do histórico.
• Mercados: vencedor, método (KO/TKO, submission, decisão), vai até a decisão, total de rounds, round em que acaba, vencedor e round, quedas na luta e por lutador.
• Simples, múltipla e combinada: a combinada na mesma luta é precificada pela chance de tudo acontecer junto, não pela multiplicação das odds. Combinações impossíveis ou redundantes são recusadas.
• Ao vivo: round, relógio e quedas das lutas em andamento. A aposta fecha sozinha quando sai o resultado oficial.
• Cashout: devolve o valor integral enquanto nenhuma luta da aposta foi decidida. Se parte da múltipla já bateu e o resto ainda não começou, oferece um valor para encerrar, calculado pelas odds de agora. Com luta em andamento, cashout e apostas ficam congelados.
• Repetir aposta: um toque devolve as mesmas seleções e o mesmo valor ao cupom.
• Copiar aposta: cola o texto de um palpite ou escolhe um ou vários prints; o app acha a luta e a seleção, entende se é simples ou múltipla (dupla, tripla...) e monta a aposta com a odd de agora. Com várias fotos, cada uma vira uma aposta e dá para fazer todas de uma vez. Cupom de acumulador que só mostra a primeira seleção é completado pela foto da lista de seleções, por outra aposta da lista ou à mão, e o valor e o tipo de cada uma podem ser mudados ali mesmo. Dá para dizer de quem é a aposta: a origem e a odd do print ficam guardadas, e a Carteira mostra o resultado por origem e quanto a sua odd ficou acima ou abaixo da do print. Antes de apostar várias de uma vez, o app avisa o que já está apostado, o que está repetido e a odd que caiu além do limite que você escolheu, e deixa corrigir o que o leitor leu errado. O valor segue a sua configuração, à risca: em dinheiro, o mesmo valor do original; em unidades, a stake do original, ou 1u quando ele não diz unidades. A imagem é lida no próprio aparelho.
• Carteira: resultado, ROI, acerto e gráfico de tudo, dos últimos 7, 15 ou 30 dias ou do último evento, com quebra por mercado e por origem. Um extrato em unidades fica sempre à vista: unidades, cartel e ROI por período e por evento, seu e do tipster. Ao reabrir o app, uma faixa resume o que fechou desde a última vez.
• Últimas lutas: nos detalhes de cada luta, as três últimas de cada lutador, com o método (e qual submission foi) e o tempo em que acabaram. O nome de cada lutador vem com a bandeira do país. Dá para filtrar as lutas do card por país, com um botão para os brasileiros. As do card da semana são buscadas ao abrir o app e ficam guardadas por uma semana.
• Você × tipster: o que entra pelo copiar é do tipster, o que você monta é seu; a Carteira compara os dois e diz quem está na frente.
• Achar a luta: um campo de busca pelo nome do lutador, em todos os eventos carregados, e botões para ver só o card principal ou só as preliminares. No alto ficam os três próximos cards; o que acabou sai da tela.
• Exposição: antes de apostar numa luta que já tem aposta aberta, o app diz quanto já está em jogo nela e se a aposta nova vai contra a que existe. No card, a luta mostra quantas apostas abertas tem. As abertas aparecem agrupadas por evento, na ordem das lutas, com o total em jogo e o que pagam se todas baterem.
• Unidade: uma porcentagem da banca (10% por padrão, ajustável). Nas configurações você escolhe se o cupom pede o valor em dinheiro ou em unidades, e a Carteira mostra o resultado em unidades. Onde aparece dinheiro em jogo aparece também em unidades, e o ganho possível (retorno menos a stake) vem em dinheiro e em unidades: por aposta, por evento e no total em aberto.
• Leitura rápida: mais e menos de uma linha aparecem como + e −, em tons neutros e com seta, e cada opção ligada a um lutador leva a cor do canto dele. Com os mercados abertos, uma legenda presa na tela lembra quem é o vermelho e quem é o azul.
• Tema e cores: tema automático, claro ou escuro. Os cantos têm três pares de cor (vermelho e azul, rosa e verde, laranja e roxo), escolhidos separadamente para lutas masculinas e femininas.
• Dois aparelhos: a mesma banca no iPhone e no computador, entrando com e-mail e senha. Sem o servidor, tudo funciona igual, só neste aparelho.
• Uso da ESPN: a Carteira conta as chamadas que o app faz à ESPN neste aparelho, por tipo, e exporta as contagens num arquivo.
• Abre sem internet: o app fica guardado no aparelho e abre na hora, com os últimos dados que carregou. Quando sai uma versão nova, ele avisa e troca com um toque.
• Valores e moeda: campos com máscara de milhares; banca em real, dólar ou euro. A moeda é escolhida no cartão de depósito, e passar para outra moeda converte a banca inteira pela cotação do dia, com ou sem depósito.
• Ganhos e perdas: lucro ou prejuízo, ROI, taxa de acerto, gráfico acumulado, quebra por mercado e o extrato em unidades por período e por evento.

Como funciona

É uma página estática. O navegador consulta a API pública da ESPN para montar o card, ler as odds e acompanhar status, resultado e estatísticas.

O código é TypeScript em módulos (src/). O build do Vite gera dist/index.html, a página inteira num arquivo, com script e estilo dentro, e dist/sw.js, o service worker que guarda essa página no aparelho. É isso que os testes usam e o que vai para o ar.

	De onde vem
Vencedor, método por lutador, vai até a decisão, linha principal de rounds	Odds publicadas pela casa (hoje DraftKings), via ESPN
Quedas, round exato, linhas alternativas de rounds, combinadas	Estimadas por um modelo próprio a partir das odds reais e do histórico dos lutadores. Aparecem com ≈
Liquidação	Sempre o resultado oficial: vencedor, método, round, tempo e quedas
Cotação para trocar a moeda da banca	Frankfurter (api.frankfurter.dev), consultado só quando um depósito muda a moeda

Saldo e apostas ficam no localStorage do aparelho. Com o login, uma cópia vai para o Supabase (plano grátis) e é juntada com a de outro aparelho; o aparelho continua sendo a fonte, e o app funciona sem o servidor. Uma função da Vercel, chamada uma vez por dia, mantém o banco acordado. Montar o projeto: supabase/README.md. A Carteira salva um backup em arquivo, que dá para mandar por mensagem, e restaura a partir dele; também copia e cola o backup como texto.

A especificação completa (endpoints, formato dos dados, modelo de preço e regras de liquidação) está em CLAUDE.md.

Rodando local

Precisa de Node 22 ou mais novo.

npm ci
npm run dev      # servidor de desenvolvimento; abra o endereço que ele mostrar
npm run build    # gera dist/index.html e dist/sw.js, o que é publicado

Testes

npm ci                      # Vite e TypeScript
pip install -r tests/requirements.txt
playwright install chromium
npm ci --prefix tests       # arquivos do leitor de imagem usados no teste
scripts/verify.sh           # confere os tipos, faz o build e roda tudo contra a página gerada

Teste	O que confere
tests/unit.cases.mjs	Os casos do núcleo: conversão de odds, modelo de preço, combinadas, cada regra de liquidação, o leitor de apostas e o histórico. Rodam duas vezes: no navegador, contra a página gerada (tests/unit.py), e no Node, contra o núcleo sozinho (tests/core.mjs)
tests/contract.py	Os leitores da ESPN e do serviço de câmbio contra respostas reais gravadas em tests/fixtures/
tests/docs_check.py	A documentação contra o código: links, arquivos, constantes, chaves
tests/e2e.py	O fluxo inteiro pela interface, com a ESPN simulada, do pré-luta ao resultado
tests/settle.py	A liquidação quando a ESPN não responde tudo de uma vez: resultado que atrasa e resultado com nome desconhecido. E o app aberto com o card pela metade
tests/pwa.py	O service worker, com a página servida por um servidor local: abrir sem conexão, aviso de versão nova e troca pelo botão
tests/cov.py	Cobertura de código, medida pelo navegador durante os testes. O verify.sh falha abaixo de 95% das funções ou 90% do código
tests/contract_live.py	A API real da ESPN e o serviço de câmbio. Roda toda semana no GitHub Actions e avisa se o formato mudar
scripts/check_production.py	Depois de cada merge, se a produção está no commit da main e continua nele

Tudo, menos os dois últimos, roda no GitHub Actions em cada PR e em cada push na main. Se mesclar vários PRs, faça um por vez e espere o deploy: merges em sequência já deixaram a produção numa versão antiga.

Desenvolvimento com IA

O projeto é mantido com ajuda de IA e tem um harness para ela não afirmar o que não verificou: um comando único de verificação, contrato com respostas reais da API, documentação conferida contra o código, um hook que impede o Claude Code de encerrar a tarefa com checagem falhando, e um registro do que foi e do que não foi verificado. As regras estão em CLAUDE.md; as decisões, em docs/decisoes.md; o registro, em docs/verificacao.md.

Fluxo e publicação

1. Branch novo a partir da main.
2. PR para a main. O CI roda os testes e a Vercel publica uma prévia do PR.
3. Merge na main publica em produção.

Configuração, uma vez só:

• Vercel: importar este repositório em um projeto novo. O vercel.json já diz como construir (npm ci, npm run build, publicar dist/). A partir daí o deploy é automático.
• GitHub: em Settings → Branches, proteger a main exigindo PR e os checks checks, e2e (dark) e e2e (light). Assim só código testado chega à produção.

No iPhone: abra a URL de produção no Safari, toque em Compartilhar e em Adicionar à Tela de Início.

Estrutura

index.html                           esqueleto da página, entrada do build
src/core/                            lógica pura: odds, leitores da ESPN, preço, liquidação, cashout
src/app/                             a página: estado, rede, telas e eventos
src/main.ts                          ponto de entrada
src/sw.js                            service worker: guarda o app no aparelho
api/keepalive.ts                     rotina diária que mantém o banco acordado
supabase/schema.sql                  tabela e regras de acesso do banco
supabase/README.md                   como montar o projeto do Supabase
package.json                         Vite e TypeScript, em versões exatas
vite.config.js                       build: a página num arquivo só, mais o service worker
tsconfig.json                        TypeScript em modo strict
vercel.json                          como a Vercel constrói e publica
scripts/verify.sh                    comando único de verificação
scripts/check_production.py          confere a produção contra a main
tests/unit.cases.mjs                 casos do núcleo (preço, liquidação, leitor, histórico)
tests/unit.py                        os casos no navegador, contra a página gerada
tests/core.mjs                       os mesmos casos no Node, sem navegador
tests/keepalive.mjs                  a rotina diária, com a rede trocada
tests/schema_check.sh                o schema num Postgres local
tests/cloud_live.py                  conferência do projeto do Supabase de verdade
tests/contract.py                    leitores da ESPN contra respostas reais gravadas
tests/contract_live.py               conferência da API real da ESPN
tests/docs_check.py                  documentação conferida contra o código
tests/e2e.py                         teste ponta a ponta
tests/settle.py                      liquidação com a ESPN simulada segurando respostas
tests/mock_espn.py                   ESPN simulada, com lutadores fictícios
tests/pwa.py                         abrir sem conexão e trocar de versão
tests/cov.py                         cobertura de código medida pelo navegador
tests/package.json                   cópias locais do leitor de imagem para o teste
tests/fixtures/espn/                 respostas reais da ESPN, reduzidas
tests/fixtures/fx/                   resposta real do serviço de câmbio
docs/decisoes.md                     o que foi decidido e por quê
docs/verificacao.md                  o que foi verificado e o que não foi
docs/escala.md                       caminho de escala
docs/screenshots/                    telas usadas neste README
.github/workflows/ci.yml             testes em cada PR e push na main
.github/workflows/espn-contract.yml  conferência semanal da API real
.github/workflows/producao.yml       conferência da produção depois de cada merge
.claude/settings.json                hook de parada do Claude Code
CLAUDE.md                            especificação e regras do projeto

Escopo

É um MVP para um usuário, simples de propósito. O que muda se precisar crescer está em docs/escala.md.

Limites conhecidos

• A API da ESPN é pública, mas não é oficial nem documentada, e pode mudar sem aviso.
• Só atualiza com o app aberto. Ao reabrir, ele busca os resultados e liquida o que ficou pendente.
• Sem internet dá para abrir e ver lutas, apostas e carteira como estavam. Apostar, fazer cashout e trocar de moeda exigem conexão.
• Depois de uma publicação, o aparelho continua na versão anterior até você tocar em "Atualizar agora".
• As odds travam quando a luta começa. Não há aposta ao vivo.
• A sincronização entre aparelhos só acontece com o app aberto, e precisa do login.

Aviso

Projeto de entretenimento. Não aceita, movimenta nem paga dinheiro real, e não é uma casa de apostas. Não tem vínculo com UFC, ESPN ou DraftKings; nomes e marcas pertencem aos respectivos donos. As odds são exibidas apenas como referência para a simulação.

Licença

MIT © 2026 Lucas Magalhães

Nos sistemas que não têm emoji de bandeira (Windows), as bandeiras vêm da fonte "Twemoji Country Flags", do pacote country-flag-emoji-polyfill (MIT, TalkJS), carregada da jsDelivr. A arte das bandeiras é do Twemoji, sob CC-BY 4.0.