Manual de Recursos & Funcionalidades

Visão Estruturada do Sistema (Versão 3.0)
🔐

Controle de Acesso & Perfis

  • Administrador (pokeradmin): Permissão irrestrita. Gerencia partidas, registra re-buys e eliminações, define rateios, cadastra/ativa jogadores, cria temporadas e ajusta os parâmetros padrões do sistema.
  • Visualizador (pokerbrochier): Acesso de leitura para os jogadores. Permite consultar o ranking da temporada, acompanhar as partidas em andamento, ver detalhes do histórico e gerar cards gráficos para compartilhamento.
Acesso Admin Acesso Jogador
🃏

Monitoramento de Partidas Ativas

  • Painel de Controle em Tempo Real: Métricas instantâneas de total de fichas em jogo, jogadores ativos, pote bruto acumulado e pote líquido de prêmios.
  • Controle de Re-buys: Adicione re-buys com um clique, registrando automaticamente a data e a hora exata da ação para auditoria futura.
  • Fluxo de Eliminações: Registro da ordem de queda dos jogadores, calculando posições automaticamente.
  • Rateios & Pontuação: Definição de payouts da mesa final e distribuição de pontuação para o ranking por colocação.
📜

Histórico & Fechamento de Partidas

  • Cálculo Automático de Balanço: Distribuidores de prêmios calculam o saldo líquido (Lucro/Prejuízo) de cada competidor.
  • Matriz de Pagamentos (PIX): Algoritmo que calcula a forma mais eficiente de liquidar as transferências de saldo, reduzindo a quantidade de envios al mínimo possível.
  • Detalhamento Rápido: Visualização de buy-ins, re-buys, pontos, prêmios e status de todos os jogadores da partida em um painel expansível.
🖼️

Compartilhamento Visual de Partidas

  • Motor HTML5 Canvas: Desenho gráfico em alta definição (1200x630px) no navegador, gerando cards profissionais de design premium.
  • Conteúdo do Card: Tabela de posições da rodada com realce dourado/prata/bronze à esquerda; e caixa de estatísticas + transferências PIX organizadas à direita.
  • Integração com WhatsApp: Botão de compartilhamento nativo para dispositivos móveis ou cópia de arquivo PNG direta para colar no WhatsApp Web.
🏆

Ranking & Pódio 3D do Top 4

  • Ranking Dinâmico: Acúmulo de pontuação filtrado por temporada atual, temporadas arquivadas ou período global histórico.
  • Gráfico de Pódio do Top 4: Renderização em canvas de pedestais 3D para os 4 primeiros colocados do ranking, coloridos em Ouro, Prata, Bronze e Verde (Mesa Final).
  • Rateio do Pote Acumulado: Cálculo da cota financeira de cada premiado com base no saldo acumulado do ranking da temporada.
🎖️

Hall da Fama & Estatísticas

  • 8 Conquistas Globais: Prêmios competitivos e informativos exibidos em cards modernos (Rei do Pódio, Patrocinador do Pote, Mão de Vaca, Maior Pote, Freguês, O Faltoso, Mais Assíduo, Maior Urso).
  • Fórmula Inteligente para Ausências: A métrica "Faltoso" e "Mais Assíduo" leva em conta a data de cadastro do jogador (`created_at`) e aplica carência automática, impedindo que novos membros sejam punidos de imediato.
  • Ficha de Jogador Interativa: Painel de busca dinâmico para consultar o resumo de performance (colocação média, saldo financeiro) e a tabela com o histórico de partidas cronológico do jogador.
  • Compartilhamento do Hall da Fama: Gerador de imagem de alta resolução (1200x950px) contendo a disposição simétrica em duas colunas das 8 insígnias e suas regras/detentores.
👥

Manutenção de Jogadores

  • Banco de Perfis: Cadastro centralizado com Nome e Chave PIX (preenche automaticamente as sugestões de transferências do final da partida).
  • Ativação / Desativação: Opção de inativar um jogador. O perfil é ocultado da lista de novas partidas, mas todos os dados históricos e pontuações do ranking são mantidos íntegros.
⚙️

Parâmetros do Sistema & Temporadas

  • Configurações Padrões: Definição de Buy-in inicial padrão, Fichas iniciais padrão, taxa de retenção do ranking e PIX do ranking.
  • Gestão de Temporadas: Abertura e arquivamento de temporadas com zeramento automático de estatísticas de pontuação e fixação do histórico.