## 1. Contexto
A Octosure é uma ferramenta de surebet. O fluxo do usuário:
1. O sistema recebe oportunidades de arbitragem raspadas da **API da BetBurger**.
2. O usuário seleciona uma oportunidade e o app abre **duas abas de navegador** (uma por casa de aposta) dentro de um **app desktop Electron**.
3. O usuário clica na seleção dentro do site da casa; a odd escolhida é trazida para a **calculadora do app**, que calcula os stakes de cada perna.
Referência visual do comportamento esperado de calculadora/stake automáticos (produto concorrente): [SUREBET - Calculadora e stake automáticas | Greensurebet]
https://www.youtube.com/watch?v=mhhXyQRJ_Lg
## 2. Estado atual
- Projeto **parcial em várias frentes**: há código funcionando em vários módulos, mas nada 100% concluído.
- **Stack:** backend/raspagem em **Python**; app desktop em **Electron** (JavaScript).
- A raspagem da API da BetBurger já existe, mas os dados ainda precisam de tratamento.
O dev receberá o código existente e deverá concluir os itens abaixo.
## 3. Escopo a concluir
### 3.1 Tratamento dos dados da BetBurger
- Normalizar os dados raspados: nomes das casas, eventos, mercados e odds.
- Mapear cada casa retornada pela BetBurger para o domínio `
.bet.br` correspondente.
### 3.2 Links finais por casa
- Gerar o **deep link final do evento/mercado** para cada casa de aposta (~150 casas `
.bet.br`), de modo que a aba aberta no Electron caia direto na página da aposta.
- Os links finais são **únicos por casa** — cada casa exige sua própria lógica de construção/resolução de URL.
### 3.3 Auto-odd
- Capturar automaticamente a odd da seleção clicada pelo usuário na página da casa (dentro do webview/BrowserView do Electron) e enviá-la à calculadora do app.
- Implementação feita **por grupo de sportsbook**, não por casa: a maioria das casas usa plataformas whitelabel/terceirizadas, então casas do mesmo grupo compartilham o mesmo DOM/frontend.
### 3.4 Auto-stake
- Preencher automaticamente o valor da aposta (stake calculado pelo app) no betslip da casa, também com lógica **por grupo de sportsbook**.
### 3.5 Grupos de sportsbook
- Planilha com o mapeamento completo: [Grupos de casas por sportsbook]
https://docs.google.com/spreadsheets/d/17qLPRuERJZwOgoxFVM0HmyZnud7yD55tZvkxirqXlAg/edit?gid=0#gid=0
- Resumo: **22 grupos** de casas que compartilham a mesma plataforma (ex.: Grupo 01 com ~28 casas como 7k, bullsbet, rico, pix; grupo 02 com ~23 casas como cassino, mcgames, estrelabet), **~19 casas sem clones** (bet365, betano, superbet, novibet, betfair, pinnacle etc., Cada uma com sistema próprio) e listas de casas ainda não classificadas ("?") ou fora do ar ("OFF").
- Implementar auto-odd/auto-stake para um grupo cobre todas as casas dele de uma vez; casas sem clones exigem implementação individual.
## 4. Critérios de aceite
- Ao abrir uma surebet, as duas abas carregam **direto na página do evento/mercado** em cada casa.
- Ao clicar na seleção, a odd real aparece na calculadora **sem digitação manual** (auto-odd).
- O stake calculado é preenchido automaticamente no betslip das duas casas (auto-stake).
- Código documentado, com instruções para adicionar novos grupos/casas (os sites mudam de layout com frequência — a arquitetura deve facilitar manutenção).
## 5. Perfil desejado
- Experiência sólida com **web scraping e automação de navegador** (DOM, seletores, engenharia reversa de requisições/APIs internas de sites).
- **JavaScript/Electron** (webview/BrowserView, comunicação IPC com o app) e **Python**.
- Desejável: familiaridade com sites de casas de aposta / plataformas de sportsbook e com o funcionamento de surebets.
Plazo de Entrega: No definido