Glicko DB

Ajuda da interface

Consulte as rotas e notas de integração e o README em português. Você também pode abrir este guia pelo botão ? na barra superior ou em /help?lang=pt.

Acessibilidade e dispositivos

Índice

Interface pública

Não é necessária uma conta para /, /rankings, /players, /player/view?id=<player_id>, /matches, /tournaments, /tournaments/<tournament_id>, /reports, /category e /sgf-library. Essas páginas oferecem ranking, perfis, histórico de partidas, torneios públicos, classificações, informações de rating, relatórios e visualização ou download de SGF.

Clique em qualquer captura para ampliá-la sem sair deste guia. Feche a visualização com Esc, pelo botão de fechar ou clicando fora da imagem.

Página inicial pública

A página pública oferece navegação, controles de idioma e tema, ranking, estatísticas e links para o conteúdo público.

As páginas aceitam ?lang=es, ?lang=en ou ?lang=pt; use AAAA-MM-DD nos filtros e campos de data.

Ranking e diretório de jogadores

Perfil público de Acuña, Carlos

Perfil público com rating atual, categoria e resumo da atividade do jogador selecionado.

Partidas e visualizador SGF

Torneios públicos

Torneios individuais cancelados mantêm acesso público aos detalhes por link direto, embora não apareçam nas listas; a API autenticada também permite esses detalhes com tournaments:read. Páginas web de detalhes PairGo cancelados continuam exclusivas para o pessoal.

Detalhes públicos do torneio

Detalhes de um torneio com seletor de rodada, mesas emparelhadas, resultados e classificação.

Relatórios periódicos e exportação

Conversor de categoria

A página /category converte um rating Glicko em categoria Dan/Kyu e exibe a fórmula, as constantes configuradas e a escala completa. Dois controles expansíveis, inicialmente fechados, mostram a fórmula de conversão de categorias e a fórmula Glicko-2 com seus parâmetros atuais; os valores configuráveis também são destacados em /admin/ratings.

A força aumenta de 30 kyu a 1 kyu e depois de 1 dan a 9 dan: em kyu um número menor é mais forte, mas em dan um número maior é mais forte. Os limites da escala interna contínua são -N para N kyu e N - 1 para N dan (não há 0 kyu nem 0 dan); a categoria inteira usa floor nesse valor. Uma exibição decimal arredondada pode parecer alcançar o próximo limite embora o valor sem arredondamento ainda esteja abaixo dele.

O campo Glicko ocupa toda a largura disponível do formulário. Em /admin/categories, os campos GLICKO_K e GLICKO_M são mais largos e centralizados; ficam empilhados quando não cabem lado a lado em telas estreitas.

Notícias públicas

A página /news/<article_id> exibe o artigo publicado e transforma tags de jogadores, torneios e partidas em links relacionados.

Biblioteca SGF

A biblioteca pública (/sgf-library) lista arquivos SGF em uploads/sgf, com ou sem partida vinculada, sujeitos às regras de visibilidade: - Ao enviar arquivos, valida tamanho, codificação UTF-8 e estrutura básica SGF. - Sincroniza automaticamente as propriedades do cabeçalho SGF (jogadores branco e preto, graduações, evento, data e resultado) com a partida associada no banco de dados. - Se um arquivo desaparecer, a referência é mantida, mas o link não é exibido; ele volta a funcionar se o arquivo retornar com o mesmo nome de armazenamento. - Desvincular um arquivo ou excluir a partida mantém o registro na biblioteca; apenas administradores podem excluir arquivos físicos definitivamente.

Administradores podem selecionar vários arquivos SGF e excluí-los em uma única ação. As partidas e os resultados pendentes vinculados são mantidos, e suas referências SGF são removidas antes da exclusão dos arquivos.

Interface de membros

Os jogadores da comunidade podem registrar uma conta pessoal para gerenciar preferências e enviar resultados de torneios e partidas de clube.

Registro e início de sessão

  1. Abra /admin/register para criar uma conta com nome de usuário, e-mail e senha (mínimo de 8 caracteres). O formulário é protegido pelo Google reCAPTCHA v3.
  2. Contas novas recebem automaticamente a função member.
  3. Entre em /admin/login. Para reportar resultados, solicite o vínculo com seu registro em Reportar Resultados e aguarde a aprovação.

Gestão de perfil e preferências

O menu Usuário reúne Menu de administração (conforme as permissões), Reportar Resultados, Perfil e Sair. Abra-o com mouse, teclado ou toque; pressione Esc para fechar.

Em /admin/profile, o usuário autenticado pode: - Atualizar o endereço de e-mail para notificações e recuperação. - Escolher o idioma preferido da interface (Español, English, Português). - Alternar entre o tema claro e o tema escuro. - Selecionar seu fuso horário IANA entre opções estáveis, mesmo quando compartilham o ajuste UTC atual (como UTC e Europe/London no inverno). O ajuste exibido muda com o horário de verão; um fuso válido salvo fora da lista sugerida continua disponível ao editar o perfil. - Alterar sua senha informando a senha atual e confirmando a nova. - Em Tokens de acesso à API, criar e revogar tokens pessoais para a API autenticada após confirmar a senha atual. Cada token é exibido uma única vez e dura até 90 dias (30 por padrão). Administradores escolhem seus escopos; as demais contas recebem os escopos permitidos pelas funções atuais, mostrados no formulário. Um token nunca concede mais que as permissões atuais da função, e as operações da API só funcionam depois que um operador as habilita (veja o guia da API).

Perfil do membro

Configurações de perfil do usuário para gerenciar idioma, tema, fuso horário e senha.

Recuperação de senha

  1. Caso esqueça sua senha, clique em Esqueceu sua senha? em /admin/login ou acesse /admin/forgot-password.
  2. Informe seu e-mail cadastrado. Se existente, o sistema enviará um link de uso único com token hash criptográfico.
  3. O link expira conforme o tempo configurado em PASSWORD_RESET_TTL_SECONDS (padrão: 3600 segundos / 1 hora).
  4. Abra o link /admin/reset-password/<token> e defina a nova senha. Por segurança, a resposta nunca revela se o e-mail está cadastrado.

Enviar resultados

Membros podem reportar resultados de partidas em /admin/report-results:

  1. Vínculo com jogador: se sua conta de membro não tiver jogador vinculado, selecione seu perfil entre os jogadores sem conta vinculada e use Solicitar vínculo nesta página. Só pode haver uma solicitação pendente por conta. Um gestor do país/região do jogador ou um administrador aprova ou rejeita em Moderação de resultados (/admin/result-submissions), com nota opcional. A solicitação não vincula a conta nem habilita o envio até sua aprovação. Depois, entre novamente. O histórico e as notas ficam disponíveis aqui; após rejeição você pode solicitar outro vínculo. A disponibilidade é verificada novamente ao aprovar, impedindo duas contas de reivindicarem o mesmo jogador. Administradores ainda podem atribuir vínculos diretamente.
  2. Formulário de envio:
    • Oponente: selecione o jogador adversário na lista de jogadores ativos.
    • Cor: indique se jogou de Brancas ou Pretas.
    • Resultado: vitória de Brancas (1-0), vitória de Pretas (0-1) ou Empate (1/2-1/2).
    • Data: data em que a partida foi disputada (AAAA-MM-DD).
    • Evento e Local: nome do torneio ou clube e cidade da partida.
    • Rodada: número da rodada, se aplicável.
    • Pedras de handicap: quantidade de pedras (0 a 9) concedidas às Pretas.
    • Arquivo SGF (opcional): envie o arquivo .sgf com o registro das jogadas.
  3. Fila de moderação: as partidas enviadas entram no estado Pendente na fila de moderação (/admin/result-submissions). Elas não afetam rankings, ratings ou relatórios públicos até serem revisadas e aprovadas pela equipe administrativa.

Envio de resultados de membros

A tela mostra a exigência de vincular um jogador e a área de envios pendentes.

Painel administrativo

Entre em /admin/login com uma conta administrativa. A navegação disponível se adapta à função da conta: - member: configurações de perfil e envio de resultados do jogador vinculado. - country_organizer / regional_organizer (Organizadores): gestão de jogadores e torneios, incluindo criação de jogadores em torneios, edição/exclusão de jogadores, partidas, vinculação SGF, importação de torneios, participantes, emparelhamentos, rodadas, resultados e exportações. - country_manager / regional_manager (Gestores): ferramentas dos organizadores, além de importação de jogadores dentro do âmbito, notícias e moderação de resultados. - administrator: controle total da plataforma, incluindo jogadores, configurações de rating/categorias, backups, gestão de usuários, auditoria e parâmetros do sistema.

Os três níveis de acesso são Global, Regional e País. Administradores têm acesso global. Funções de país exigem um país, que pode vir do jogador vinculado quando não há seleção explícita; funções regionais exigem uma região explícita suportada (atualmente América Latina, identificada como latam). Uma função de país não pode usar uma região, nem uma função regional um país. Sem âmbito válido compatível, as rotas geográficas negam acesso. A equipe pode gerenciar jogadores dentro do âmbito, partidas com pelo menos um jogador dentro do âmbito e torneios cujo país pertença ao âmbito.

Ferramentas Organizadores Gestores Administradores
Jogadores, torneios, partidas e registros SGF País/região atribuído País/região atribuído Global
Importação de jogadores e moderação de resultados Não País/região atribuído Global
Notícias Não Sim (notícias compartilhadas do site) Sim
Backups, importações globais, recálculo de ratings e categorias Não Não Somente global
Usuários, auditoria e configurações Não Não Somente global

O menu agrupa as tarefas em Jogadores e competição (jogadores, partidas, torneios e moderação de resultados), Importações e ratings (importação de jogadores, importação geral, ratings e categorias), Conteúdo e registros de partidas (notícias e biblioteca SGF) e Administração do site (usuários, configurações, backups, auditoria e estatísticas). Cada cartão completo é um link acessível por teclado, sem um link Abrir separado. Somente as ferramentas permitidas e as seções com cartões visíveis aparecem; a organização não altera as permissões.

Contas operator migram para regional_manager e tournament_director para regional_organizer; ambas recebem o âmbito da América Latina, substituindo qualquer país anterior. A migração invalida suas sessões e tokens existentes uma única vez.

Gestão de torneios

1. Criação e configuração de torneios (/admin/tournaments)

2. Gestão de participantes

3. Emparelhamentos, rodadas e registro de resultados

Detalhe do torneio e rodadas

Painel de controle de rodada do torneio: emparelhamentos, mesas, seletor de resultados e classificação.

4. Processamento de rodadas e cálculo de rating

Gestão de dados

1. Assistente de importação com prévia (/admin/import)

Importe planilhas históricas, partidas ou arquivos do OpenGotha: - Formatos aceitos: - Planilha Excel (.xlsx): substitui o conjunto de dados ativo com jogadores e partidas completos. - XML do OpenGotha (.xml): importa metadados do torneio, participantes, emparelhamentos e pedras de handicap. - Arquivo CSV (.csv): colunas date, white, black, result e opcional handicap (0 a 9). - Crie um backup antes de importar uma planilha que substitua os dados ativos. - As importações são limitadas a 10 MiB por arquivo, 100 MiB de conteúdo XLSX descompactado e 10.000 linhas por planilha, CSV ou conjunto combinado de participantes/partidas OpenGotha. A importação de jogadores em /admin/players mantém limites menores: 5 MiB e 1.000 jogadores. - Os envios OpenGotha por /admin/import e /admin/tournaments usam o mesmo fluxo de revisão e aprovação por etapas. Revise ou edite as configurações do torneio, o resumo das operações, os avisos e as decisões dos participantes; a prévia não altera o banco. Use Aprovar e importar somente depois de revisar o resumo atualizado. Se jogadores ou torneios mudarem enquanto a prévia estiver aberta, envie o arquivo novamente. - Reconciliação explícita de jogadores: - A prévia classifica cada registro como Correspondência exata, Sugestão aproximada, Novo jogador ou Duplicado. - A equipe autorizada decide para cada jogador: vincular ao existente, criar novo ou rejeitar a linha. - Metadados do torneio podem ser revisados e editados antes da confirmação. - O CSV é validado antes da gravação: datas, resultados (1-0, 0-1 ou 1/2-1/2), handicap, jogadores existentes e erros por linha/campo. Qualquer erro bloqueia toda a importação; as gravações no banco são transacionais. - A prévia XLSX identifica a planilha e a linha com dados inválidos e não substitui os dados se houver erros. A substituição continua exigindo confirmação explícita e backup verificado antes da importação. - A prévia OpenGotha avisa sobre partidas cujos jogadores não estão no XML. O recibo final informa quantidades, avisos e o estado dos ratings. O torneio importado permanece como rascunho e não afeta os ratings imediatamente; ao ser concluído, partidas elegíveis podem marcar a data afetada para recálculo. - Se DEFER_RATING_REPLAY_ON_IMPORT estiver ativado, a importação será concluída, mas um aviso informará que os ratings podem ficar desatualizados até a execução do recálculo adiado.

Prévia e reconciliação de importação

Exemplo de prévia e reconciliação de importação. As importações de torneios OpenGotha usam uma tela específica de revisão e aprovação.

2. Administração de jogadores (/admin/players)

Ao selecionar uma categoria inicial, o campo de rating mostra uma casa decimal; ao salvar, a conversão mantém sua precisão para não reduzir a categoria. Ratings inseridos manualmente preservam sua precisão.

3. Administração de partidas (/admin/matches)

4. Configuração de ratings e categorias (/admin/ratings e /admin/categories)

5. Fila de moderação de resultados (/admin/result-submissions)

Tarefas administrativas e de segurança

1. Backups e restauração (/admin/backups)

Gestão de backups

Lista de backups com ações de criar, restaurar e excluir.

2. Gestão de contas de usuários (/admin/users)

3. Publicação de notícias (/admin/news)

4. Registro e revisão de auditoria (/admin/audit)

5. Estatísticas do site (/admin/analytics)

6. Configurações de segurança da aplicação (/admin/settings)

Guia de solução de problemas

  1. Acesso negado (403): verifique sua função de organizador, gestor ou administrador e seu âmbito geográfico compatível. Importação de jogadores, notícias e moderação exigem um gestor ou administrador; operações globais exigem um administrador.
  2. Não consigo enviar resultados como membro: confirme em /admin/users se sua conta está vinculada a um registro de jogador ativo.
  3. Erros na importação de arquivos: - Certifique-se de que o CSV use codificação UTF-8 e contenha os cabeçalhos obrigatórios date, white, black, result. - Verifique se o formato de data é AAAA-MM-DD e os resultados são exclusivamente 1-0, 0-1 ou 1/2-1/2. - Verifique se as pedras de handicap estão no intervalo de 0 a 9.
  4. Arquivos SGF não encontrados: a referência é mantida sem exibir um link quebrado. Se o operador devolver o arquivo a uploads/sgf com o nome de armazenamento original, o vínculo volta a funcionar; um novo envio recebe outro nome e deve ser vinculado explicitamente.
  5. Restauração de banco de dados: após restaurar um backup, aguarde o término das migrações e da indexação FTS5 antes de iniciar operações.
  6. Segurança em produção: mantenha segredos (APP_SECRET_KEY, ADMIN_PASSWORD, credenciais SMTP e chaves reCAPTCHA) em variáveis de ambiente do servidor, nunca no controle de versão.
^