Quant System Predictor 8.0

App de análise quantitativa de apostas (Poisson, Elo, Monte Carlo, Kelly) com leitor de imagens por IA (OCR via Claude Vision).

1. Rodar localmente (para testar antes de publicar)

Pré-requisito: ter o Node.js instalado (baixe em https://nodejs.org, versão LTS).

No terminal, dentro desta pasta:

npm install
npm run dev

Isso abre o app em http://localhost:5173 no seu navegador. Aqui, com o app rodando fora do sandbox do Claude, o seletor de arquivos e a câmera já funcionam normalmente.

2. Publicar no Vercel (deixa o app com uma URL pública)

Opção A — Mais simples (sem GitHub), usando a CLI do Vercel

1. Crie uma conta grátis em https://vercel.com (pode entrar com Google/GitHub/email).
2. No terminal, instale a ferramenta de linha de comando da Vercel:

   npm install -g vercel
   

3. Ainda dentro desta pasta do projeto, rode:

   vercel
   

4. Ele vai fazer algumas perguntas (Set up and deploy? → yes; link to existing project? → no; nome do projeto → pode aceitar o padrão). Na primeira vez, ele abre o navegador para você logar na sua conta Vercel.
5. Ao final, ele imprime uma URL (algo como https://quant-system-predictor.vercel.app). Essa é a versão de teste (preview).
6. Para publicar a versão definitiva (produção), rode:

   vercel --prod
   

Opção B — Via GitHub (melhor se for atualizar o código com frequência)

1. Crie um repositório no GitHub e suba esta pasta:

   git init
   git add .
   git commit -m "Quant System Predictor 8.0"
   git branch -M main
   git remote add origin https://github.com/SEU_USUARIO/NOME_DO_REPO.git
   git push -u origin main
   

2. Entre em https://vercel.com/new, clique em "Import Git Repository" e selecione o repositório.
3. A Vercel detecta automaticamente que é um projeto Vite — não precisa mudar nada nas configurações. Clique em "Deploy".
4. Depois disso, toda vez que você der git push, a Vercel atualiza o site sozinha (deploy automático).

3. Publicar no Firebase Hosting (alternativa ao passo 2)

Importante: só o front-end (a parte visual, dist/) vai pro Firebase Hosting. As 12 funções em api/*.js (Supabase, API-Football, OCR, etc.) e os crons (vercel.json) continuam rodando no Vercel — Firebase Hosting só serve arquivos estáticos, não roda esse código de servidor. Por isso o front-end compilado pro Firebase precisa saber a URL do Vercel pra chamar a API (src/utils/apiUrl.js cuida disso, lendo VITE_API_BASE_URL).

1. Instale a CLI do Firebase e faça login (uma vez só):

   npm install -g firebase-tools
   firebase login
   

2. Garanta que existe um .env ou .env.local (não commitado) com VITE_SUPABASE_URL e VITE_SUPABASE_KEY — os mesmos usados em npm run dev. Sem isso o build quebra em runtime (o app não consegue falar com o Supabase).
3. Rode:

   npm run deploy:firebase
   

   Isso builda com .env.firebase (define VITE_API_BASE_URL pro domínio de produção do Vercel, https://quant-predictor.vercel.app) e publica o dist/ no projeto Firebase configurado em .firebaserc (agilsgh-65463878-f64e7).
4. O CORS das funções do Vercel já libera os domínios padrão do Firebase Hosting (*.web.app / *.firebaseapp.com) e localhost:5173 — ver api/_lib/cors.js. Se depois você apontar um domínio próprio pro Firebase Hosting, adicione-o na variável de ambiente CORS_EXTRA_ORIGINS no painel do Vercel (aceita lista separada por vírgula) e faça redeploy das funções.

4. Publicar na AWS (Elastic Beanstalk) — outra alternativa ao passo 2

Diferente do Firebase (passo 3), aqui front-end E as 12 funções de api/*.js rodam juntos, no mesmo servidor e no mesmo domínio (server/app.js reúne tudo num app Express só). Vantagens práticas: não existe limite de "12 funções serverless" (é um servidor único, não funções separadas) e a navegação fica mais fluida — o navegador nunca precisa sair do domínio da AWS pra chamar a API, então não depende de CORS liberado noutro domínio.

Você não precisa saber nada de AWS de antemão — o passo a passo abaixo cobre desde criar a conta até publicar. É mais longo que o Vercel porque a AWS não tem um comando único tipo vercel. Tem dois jeitos de publicar (veja o passo 4.3): pelo Console no navegador (sem instalar nada, sem digitar chave secreta — melhor se você está num computador público/compartilhado) ou pela linha de comando (mais rápido pra atualizar com frequência, mas só recomendado no seu próprio computador).

4.1. Criar a conta AWS (uma vez só)

1. Entre em https://aws.amazon.com/pt/, clique em "Criar uma conta da AWS" e siga o cadastro (pede cartão de crédito pra confirmar identidade, mas o Elastic Beanstalk em si não cobra nada extra — você paga só a instância de servidor que ele cria por trás, e o nível gratuito da AWS cobre isso por 12 meses num uso pequeno como esse app).

4.2. Criar um usuário com permissão (IAM) e pegar as chaves de acesso

A AWS não deixa fazer login "pela linha de comando" com o e-mail/senha da conta — precisa de um usuário IAM com uma chave de acesso (o equivalente a usuário+senha, só que pra ferramentas). É isso que "configurar permissões e chaves" quer dizer, na prática:

This is the beginning of the README. Read the rest at the original. Read the full README ↗