📊 Dashboard
Configure o backend na aba "Inserir Dados" para começar.
🧠 Análise IA
Executa 6 modelos de IA: Frequência Ponderada, Atraso, Padrões, Distribuição, LSTM e XGBoost.
🔮 Previsões
✅ Validação de Jogos
Insira seus números para avaliar a qualidade do jogo.
🔒 Fechamento
Gera o conjunto mínimo de jogos para cobertura combinatória.
📈 Backtesting
Testa a estratégia contra resultados passados.
🔔 Alertas Inteligentes
Detecta padrões fortes: atrasos críticos, convergência de modelos, pares frequentes.
🎫 Meus Jogos Salvos
Gerencie seus jogos favoritos. A confiança é recalculada automaticamente ao atualizar os resultados.
🎫
Nenhum jogo salvo ainda.
Clique em "Adicionar Jogo" ou salve jogos das abas Previsões, Validação e Fechamento.
📖 Manual Completo
Guia detalhado de cada funcionalidade e parâmetro do sistema.
📑 Índice
1. Visão Geral do Sistema
O LotoQuant é um sistema de análise probabilística de loterias brasileiras que utiliza 6 modelos de Inteligência Artificial para analisar padrões históricos e gerar previsões estatisticamente fundamentadas. O sistema suporta 4 jogos:
| Jogo | Números | Faixa | Extras |
|---|---|---|---|
| 🎯 Mega-Sena | 6 dezenas | 01 a 60 | — |
| 🍀 Lotofácil | 15 dezenas | 01 a 25 | — |
| 🔮 Lotomania | 20 dezenas | 00 a 99 | — |
| 💎 +Milionária | 6 dezenas | 01 a 50 | 2 trevos (1-6) |
⚠️ Importante: Loterias são eventos aleatórios. O sistema identifica padrões estatísticos para otimizar apostas, mas não garante resultados. Use com responsabilidade.
2. Dashboard
A tela inicial mostra um resumo do estado atual de cada jogo.
📊 Último Resultado
Exibe o número do concurso, data do sorteio, dezenas sorteadas, valor do prêmio principal e se houve acumulação. Selecione o jogo desejado no seletor de jogos (dropdown) na parte inferior da barra lateral.
📈 Estatísticas Rápidas
Mostra o total de concursos no banco de dados, o último concurso e a data do último sorteio. Quanto mais dados importados, mais precisas serão as estatísticas.
3. Análise IA
Esta aba executa os 6 modelos de IA simultaneamente e apresenta uma análise completa do jogo selecionado. Necessita de no mínimo 50 concursos no banco de dados.
🔢 Ranking de Números
Lista os números ordenados por um score composto que combina frequência, atraso, padrões e distribuição. Números no topo são estatisticamente mais "quentes".
🔗 Pares e Trios Frequentes
Mostra combinações de 2 e 3 números que mais apareceram juntas. Útil para montar jogos que respeitam associações históricas.
🔄 Retreinar Modelo
Botão que força o recálculo de todos os 6 modelos com os dados mais recentes. Use após importar novos resultados para atualizar as análises.
4. Previsões
Gera jogos completos usando a combinação dos 6 modelos de IA.
🎯 Parâmetro: Quantidade de Jogos
Define quantos jogos diferentes serão gerados (padrão: 5). Cada jogo é uma combinação diferente de números selecionados pelos modelos. O primeiro jogo usa os melhores números; os seguintes variam para diversificar.
📊 Score de Confiança
Cada jogo gerado recebe um score de 0 a 100 que indica o nível de concordância entre os modelos. Score alto (>70) = os modelos concordam fortemente. Score baixo (<40) = há divergência.
💾 Salvar Jogo
Cada previsão tem um botão "Salvar" que envia o jogo diretamente para a aba Meus Jogos.
5. Validação de Jogos
Permite avaliar a qualidade de um jogo que você mesmo escolheu antes de apostar.
✏️ Parâmetro: Números
Insira os números separados por vírgula ou espaço. Ex: 04, 15, 23, 38, 45, 52
📋 O que a Validação Retorna
Score geral (0-100), frequência e atraso de cada número, proporção par/ímpar, faixa de soma, pares frequentes presentes, e sugestões de melhoria (trocas de números para ganho de score).
💡 Dica: Score acima de 60 indica um jogo bem balanceado estatisticamente. Use o botão "Salvar" para guardar o jogo validado.
6. Fechamento (Cobertura Combinatória)
Gera o menor conjunto de jogos necessário para garantir uma faixa mínima de acertos dentro de um universo reduzido de números.
🏆 Parâmetro: Garantia
Quadra: Garante ao menos 4 acertos (menos jogos, mais econômico).
Quina: Garante ao menos 5 acertos (quantidade intermediária).
Sena: Garante 6 acertos — todas as combinações cobertas (mais caro).
🎯 Parâmetro: Tamanho do Universo
Quantidade de números que compõem o universo reduzido. O sistema seleciona os N melhores números. Menor (10) = menos jogos, mais barato. Médio (15) = equilibrado. Maior (20+) = mais cobertura, mais caro.
Exemplo prático (Mega-Sena): Universo = 12, Garantia = Quadra → ~15-20 jogos gerados. Cada jogo pode ser salvo individualmente na aba Meus Jogos.
7. Backtesting
Testa a estratégia contra resultados passados reais.
🔢 Concursos para Testar
Quantidade de sorteios passados no teste (padrão: 50). Valores: 20-30 = rápido; 50 = recomendado; 100+ = extensivo (5-10 min).
🎫 Cartelas por Concurso
Jogos gerados por sorteio testado (padrão: 3). 1 = conservador; 3 = moderado; 5-10 = agressivo.
📊 Resultados
Taxa de acerto por faixa, melhor/pior resultado, média de acertos. Acima de 3.5 acertos médios na Mega-Sena indica bom desempenho.
8. Alertas Inteligentes
Monitora automaticamente padrões anormais.
🔔 Tipos de Alerta
⏰ Atraso Crítico: Número ultrapassou 2x o atraso médio esperado.
🤝 Convergência de Modelos: 4+ modelos concordam sobre os mesmos números.
🔗 Pares Frequentes Ativos: Duplas históricas com atraso elevado simultâneo.
💰 Acumulação: Prêmio acumulou, próximo sorteio com valor maior.
9. Meus Jogos
Aba para gerenciar todos os seus jogos salvos.
➕ Adicionar Jogo
Abre um formulário onde você escolhe o tipo de jogo (Mega-Sena, Lotofácil, etc.), dá um nome e insere os números. O formulário se adapta automaticamente: mostra a quantidade correta de números e a faixa válida para cada jogo, e exibe o campo de trevos apenas para a +Milionária.
💾 Salvar de Outras Abas
Nas abas Previsões, Validação e Fechamento há botões "Salvar" que enviam o jogo diretamente para cá.
📊 Confiança
Cada jogo exibe um círculo de confiança (0-100%) calculado pela API de validação. Verde (>70%) = excelente, Amarelo (>50%) = bom, Vermelho (<50%) = fraco. Clique em "Recalcular Confiança" para atualizar todos os jogos com os dados mais recentes. A confiança também é recalculada automaticamente ao usar "Forçar Atualização".
✏️ Editar / 🗑️ Excluir
Cada jogo possui botões para editar (alterar nome ou números) e excluir. Os dados são salvos no navegador (localStorage) e persistem entre sessões.
10. Inserir Dados / Configuração
Aba de configuração e gerenciamento de dados.
⚙️ Configuração do Backend
URL do Backend: Endereço do servidor FastAPI no Hugging Face Spaces.
API Key: Valor da variável API_SECRET configurada nos Secrets do HF Space.
📥 Importar Dados Históricos
Selecione o ano inicial (padrão: 2019). A importação busca resultados da API da Caixa pelo navegador e envia via proxy ao backend. Pode levar 5-15 minutos. Não feche a aba.
🔄 Forçar Atualização
Busca apenas os concursos mais recentes. Use após cada sorteio.
✏️ Inserir Resultado Manual
Campos: Concurso, Data (DD/MM/AAAA), Números, Trevos (só +Milionária), Prêmio e Acumulou.
11. Os 6 Modelos de IA
A previsão final é uma combinação ponderada de todos os 6 modelos:
1. Frequência Ponderada (Peso: 25%)
Conta aparições de cada número dando peso maior para sorteios recentes. Identifica números "quentes".
2. Atraso (Peso: 20%)
Calcula há quantos concursos cada número não sai. Números com atraso muito acima da média estão "devendo".
3. Padrões (Peso: 20%)
Analisa pares e trios recorrentes, sequências e progressões aritméticas nos resultados históricos.
4. Distribuição (Peso: 15%)
Verifica equilíbrio par/ímpar, distribuição por dezenas, faixa de soma e espalhamento no volante.
5. LSTM - Rede Neural (Peso: 10%)
Rede neural recorrente que busca padrões sequenciais entre sorteios consecutivos.
6. XGBoost (Peso: 10%)
Ensemble de árvores de decisão que analisa features como frequência recente, atraso e interações não-lineares.
12. Estratégia Recomendada
Mantenha os dados atualizados. Após cada sorteio, clique em "Forçar Atualização" na aba Inserir Dados.
Consulte os Alertas. Verifique atrasos críticos ou convergência de modelos.
Veja a Análise IA. Examine ranking, mapa de calor e pares frequentes.
Gere Previsões. Peça 3-5 jogos e salve os favoritos em Meus Jogos.
Valide seu jogo. Insira os números na Validação para verificar o score antes de apostar.
Use o Fechamento. Universo de 12-15 números + garantia de quadra para a Mega-Sena.
Rode Backtesting periodicamente. Verifique o desempenho histórico e retreine se necessário.
13. Glossário
| Termo | Definição |
|---|---|
| Score | Pontuação de 0 a 100 baseada nos 6 modelos. |
| Atraso | Concursos consecutivos sem ser sorteado. |
| Frequência | Vezes que um número apareceu historicamente. |
| Universo Reduzido | Subconjunto dos melhores números selecionados pela IA. |
| Fechamento | Menor número de jogos para cobrir uma garantia mínima de acertos. |
| Backtesting | Teste retroativo em sorteios passados. |
| Convergência | Múltiplos modelos concordam sobre os mesmos números. |
| LSTM | Long Short-Term Memory — rede neural para sequências temporais. |
| XGBoost | Extreme Gradient Boosting — árvores de decisão em ensemble. |
| Trevos | Números extras (1-6) exclusivos da +Milionária. |
| Acumulou | Ninguém acertou; o prêmio acumula para o próximo sorteio. |
| ROI | Return on Investment — retorno sobre investimento no backtesting. |
LotoQuant v2.2 — Sistema de Análise Probabilística de Loterias Brasileiras com IA
⚠️ Jogue com responsabilidade. Loterias são jogos de azar e não há garantia de retorno.
⚙️ Inserir Dados
⚙️ Configuração do Backend
📥 Importar Dados Históricos
Importa resultados diretamente da API da Caixa pelo seu navegador e salva no banco de dados. A importação é feita via proxy para evitar bloqueios do servidor.
🔄 Atualizar Resultados
Busca apenas os concursos mais recentes que ainda não estão no banco.