PORTAL SNOOKER
Visão geral do sistema
PainelResumo operacional, financeiro e técnico
Este módulo continua usando localStorage como base local. Agora a estrutura separa cadastros, eventos/campeonatos, etapas, torneios, inscrições, financeiro, premiações e desempenho histórico.
PRÓXIMOS TORNEIOSativos
ALERTAScontrole
CADASTRO DE ATLETAS
Cadastros básicos
CadastrosBase única de jogadores do portal
Nome
Idade
Sexo
Cidade
Clube onde treina
Handicap inicial
Maior tacada treino
Maior tacada competição
WhatsApp
Status
IMPORTAR LISTA DO WHATSAPPcadastro rápido
Cole aqui uma lista de inscrições copiada do WhatsApp. O sistema identifica linhas numeradas, nomes, marcação ✅ e handicap no final do nome. Exemplo: João 5 ✅ cria João com HC 5. Se não houver handicap, usa o HC padrão abaixo.
Texto do WhatsApp
HC padrão quando não informado
Clube padrão
Status do cadastro
Se houver torneio em foco
Duplicados prováveis
Atletas já existentes
ATLETAS CADASTRADOS
NomeHC AtualÍndiceCidadeClubeRecorde Comp.StatusAções
CLUBES
Cadastros básicos
CadastrosClubes, sedes e locais de treino
Nome do clube
Cidade
Responsável
Contato
CONFIGURAÇÕES
Cadastros administrativos
CadastrosFaixas de handicap e parâmetros técnicos
As faixas abaixo servem para o módulo de handicap sugerir promoção, manutenção ou redução. Quanto maior o índice técnico, mais forte é o jogador.
HC
Nome da faixa
Índice mínimo
Índice máximo
Descrição
FAIXAS DE HANDICAPadministrativo
HCFaixaÍndice Mín.Índice Máx.DescriçãoAções
GESTÃO DO TORNEIO
Entre em um torneio e trabalhe sempre nele
TorneiosContexto único para inscrições, sorteio, partidas, financeiro e prestação
Aqui você escolhe o torneio de trabalho. Depois de entrar, as próximas telas usam esse torneio automaticamente. Para trabalhar em outro torneio, clique em Sair do torneio e entre no próximo.
Selecionar torneio ativo
Ação
EVENTOS E CAMPEONATOS
Estrutura principal
TorneiosUm evento pode ser torneio único ou campeonato com várias etapas
Cadastre primeiro o evento. Depois crie as etapas/torneios vinculados a ele. Exemplo: Circuito Handicap Grajaú 2026 com 6 etapas e premiação final acumulada.
Nome do evento/campeonato
Tipo
Clube base
Modalidade padrão
Temporada
Data inicial
Data final prevista
Valor inscrição padrão
Vagas padrão
% para premiação final
Status
Observações / regulamento
ETAPAS DO EVENTO
Torneios vinculados a campeonatos
TorneiosCada etapa também vira um torneio operacional para inscrições, ranking e financeiro
Evento/Campeonato
Nome da etapa
Ordem
Data
Clube da etapa
Modalidade
Valor inscrição
Vagas
% fundo final
Status
Observação
ETAPAS CADASTRADAS
EventoEtapaDataClubeInscriçãoFundo FinalStatusAções
GESTÃO DE TORNEIOS
Operação dos eventos
TorneiosCadastro do evento, modalidade, vagas e status
Nome do torneio
Evento vinculado
Data
Clube
Modalidade
Valor inscrição
Vagas
Status
INSCRIÇÕES E PAGAMENTOS
Inscrição em lote por torneio
TorneiosSelecione vários atletas e registre todos de uma vez
Torneio
Status pagamento
Valor pago por atleta
Forma
Referência
Filtrar atletas
ATLETAS DISPONÍVEIS
INSCRIÇÕES DO TORNEIO
TorneioAtletaStatus ✏️Valor ✏️Forma ✏️DataAções
SORTEIO E CHAVES
Gerar formato do torneio a partir dos inscritos aptos
TorneiosUsa apenas atletas com inscrição Pago ou Isento
O sorteio usa os inscritos aptos do torneio selecionado. Os atletas são separados por handicap, em grupos de até 8, para preencher as posições da chave. Se faltar jogador, o sistema completa com W.O. HC 30. Contra W.O., o atleta vence por 2x0, placar mínimo 1x0 / 1x0.
Torneio
Formato
Nº de chaves
Tamanho da chave
EDITAR CHAVES JÁ SORTEADASuso durante o torneio
Use esta rotina quando alguém desistir depois do sorteio, ou quando entrar um atleta no lugar de um W.O. A alteração atualiza o sorteio e, se o controle de partidas já tiver sido iniciado, também atualiza o jogo inicial correspondente.
CONTROLE DE PARTIDAS
Lançamento dos resultados conforme o torneio acontece
TorneiosFase de chaves, classificação e mata-mata progressivo
Este módulo transforma o sorteio em um torneio jogável. Primeiro gere o sorteio em Sorteio/Chaves. Depois inicie o controle para lançar os resultados, validar empates, avançar fases e liberar o mata-mata conforme as chaves forem terminando.
Torneio
Visualização
CENTRAL OPERACIONAL DO TORNEIO
Tela rápida para operar o torneio ao vivo
OperaçãoVeja tudo na mesma tela, clique na chave e depois no jogo para lançar resultado rápido.
Use esta tela durante o torneio. Ela mostra chaves, jogos ativos, pendentes, finalizados e mata-mata no mesmo painel. Para lançar rápido, clique sobre o jogo e escolha 2x0 ou 2x1. O lançamento detalhado continua disponível.
Torneio
Filtro
Exibir
FINANCEIRO E PREMIAÇÃO
Receitas, despesas e divisão da premiação
TorneiosControle financeiro separado da receita dos salões
A receita principal vem das inscrições pagas. O sistema separa despesas operacionais, percentual do salão, fundo acumulado para final e calcula o saldo destinado à premiação da etapa.
Torneio/Etapa
% para salão
% para premiação final
Observação financeira
DESPESAS OPERACIONAIStroféus, salão, extras
Tipo
Descrição
Valor
TipoDescriçãoValorAção
PREMIAÇÃOdestinação do saldo
1º Lugar
2º Lugar
3º Lugar
4º Lugar
Maior tacada
Meta mínima maior tacada
Acumulado maior tacada anterior
Acumulado final
IMPORTAR HISTÓRICO JSON
Base de torneios realizados
DesempenhoImportar JSON, cadastrar atletas e alimentar histórico
Cada JSON importado representa um torneio realizado. Informe o torneio e o clube. O sistema cadastra automaticamente jogadores ainda não existentes e cria a base de desempenho para cálculo futuro de handicap.
1. ARQUIVO JSONhistórico
Use o JSON individual do torneio ou o lote consolidado com vários torneios.
Nenhum JSON analisado ainda.
2. DADOS DO TORNEIOobrigatório
Nome do torneio
Data do torneio
Clube existente
Ou cadastrar novo clube
Cidade do clube
Modalidade
Status do torneio
Atualizar HC atual?
3. VALIDAÇÃO DO ARQUIVOconferência
Analise um JSON para ver validações, alertas e possíveis problemas antes de importar.
4. CONFERÊNCIA DE ATLETAScadastro automático
Aqui aparecerá quantos atletas já existem, quantos serão cadastrados e possíveis nomes duplicados.
IMPORTAÇÕES REALIZADAS
Data importaçãoTorneioClubeJogosAtletasAções
JOGOS HISTÓRICOS
TorneioFaseJogoPlacarVencedor
HISTÓRICO DE DESEMPENHO
Desempenho dos atletas
DesempenhoBase técnica para evolução e ranking futuro
Aqui você registra o desempenho final de cada atleta em cada torneio. Esses dados alimentam o módulo de handicap.
Buscar atleta ou torneio
Filtrar por torneio
Torneio
Atleta
Posição final
Jogos
Vitórias
Derrotas
Partidas ganhas
Partidas perdidas
Pontos feitos
Pontos sofridos
Maior tacada
BASE HISTÓRICA
TorneioAtletaPos.J/V/DSaldo Part.Saldo Pts.Maior TacadaÍndice GeradoAções
RANKING DO EVENTO / CIRCUITO
Ranking acumulado por evento, campeonato ou circuito
DesempenhoSoma os desempenhos dos torneios/etapas vinculados ao evento selecionado.
Evento/Circuito
Tipo
CLASSIFICAÇÃO DO EVENTO
#AtletaPontosÍndiceEtapasJ/V/DSaldo Part.Saldo Pts.TítulosFinais
GESTÃO DE HANDICAP
Desempenho dos atletas
DesempenhoMétricas, índice técnico e sugestão de HC
O índice técnico combina: aproveitamento em jogos, saldo de partidas, saldo de pontos, posição final, frequência em torneios e maior tacada. Ele serve como apoio, não como decisão cega.
ANÁLISE DOS ATLETASíndice técnico
AtletaHC AtualÍndiceSugestãoTorneiosVitóriasSaldo Part.Saldo Pts.Maior TacadaAções
UNIFICAR ATLETAS
Manutenção da base de jogadores
CadastrosCorrigir nomes duplicados antes de calcular ranking e handicap
Use esta rotina quando o mesmo jogador aparecer com nomes parecidos em importações diferentes. Exemplo: Mario, Mário, Mario Japa. A unificação move inscrições, jogos, desempenhos e histórico para o atleta principal.
POSSÍVEIS DUPLICADOS0 grupos
Atleta principalPossível duplicadoSemelhançaAções
UNIFICAÇÃO MANUALcontrole
Manter este atleta
Unificar este atleta dentro do principal
Atenção: a operação remove o cadastro duplicado e transfere os vínculos para o cadastro principal.
FICHA DO ATLETA
Histórico individual
DesempenhoVisão consolidada do jogador, ranking, evolução e handicap
Atleta
RANKINGS
Geral, temporada, clube e evento
DesempenhoRanking mede resultado competitivo. Handicap mede nível técnico atual.
Temporada/Ano
Clube
Evento
Tipo
CLASSIFICAÇÃO
#AtletaRankingÍndice técnicoTorneiosJ/V/DSaldo Part.Saldo Pts.TítulosFinaisMaior Tacada
PRINT DO RANKING
Todos os jogadores em uma tela compacta
DesempenhoTela preparada para print ou impressão do ranking geral/evento.
Evento/Circuito
Tipo
Colunas na tela
PRESTAÇÃO DE CONTAS
Financeiro do torneio/campeonato
TorneiosReceitas, despesas, salão, fundo final e premiação
Torneio/Etapa
RELATÓRIO FINAL PARA WHATSAPP
Prestação de contas, ranking final, premiação e maior tacada
TorneiosTexto pronto para copiar e enviar no grupo do torneio
Torneio/Etapa
Texto para WhatsAppcopiar e colar
ESTUDO DA BASE DE DADOS
Estrutura técnica do portal
RotinasMapa das tabelas, campos, relacionamentos e exportação
Esta tela serve para estudarmos a base antes de migrar do localStorage para um banco real, como PostgreSQL/Supabase.
DICIONÁRIO DE DADOSestrutura
TabelaRegistrosCampos principaisRelacionamentosUso
PRÉVIA TÉCNICA






  
ROTINAS ADMINISTRATIVAS
Backup, importação e manutenção
RotinasSegurança da base local e manutenção dos dados

  

    
EXPORTARsegurança
Baixe a base completa em JSON.

    
IMPORTARrestaurar
Aceita backup completo do portal, base de teste e alguns formatos legados. Arquivo ZIP não importa direto: extraia e selecione o .json.

  

  
PRÉVIA











  

    
    
PORTAL PROFISSIONAL DE SINUCA E SNOOKER

    

      

    

    
Bem-vindo ao CueScore! 🎱

    

      Este é o portal completo para gestão de torneios de sinuca e snooker.


      Para começar, siga estes passos:
      
    
        
  1. Cadastre seu clube
    2. 
        
  2. Importe ou cadastre seus atletas
    3. 
        
  3. Crie um torneio
    4. 
        
  4. Registre as inscrições e jogue!
    5.