Xadrez Educalar — Plataforma Educacional de Xadrez

O Xadrez Educalar não é um template comprado, não é um plugin WordPress, não é um fork de um projeto existente. Cada linha de código foi escrita do zero — do tabuleiro ao banco de dados, das regras do xadrez ao painel administrativo.

O motor de xadrez

Começou pelo tabuleiro. Em vez de usar uma biblioteca pronta de xadrez (como chess.js), o motor de regras foi implementado do zero: representação do tabuleiro como matriz 8x8, cálculo de movimentos legais peça por peça, validação de xeque, xeque-mate, afogamento, roque (com verificação de casas ameaçadas), en passant, promoção de peão, empate por repetição tripla e material insuficiente. Cada regra foi codificada manualmente e testada em cenários reais de partida.

Para a IA, integrou-se a engine Stockfish compilada em WebAssembly — não como um serviço terceirizado, mas rodando localmente no navegador do usuário, em um Web Worker dedicado, sem dependência de servidor para calcular lances. A mesma engine alimenta a análise de partidas, que classifica cada jogada (excelente, boa, imprecisa, erro) e desenha o gráfico de avaliação.

O relógio (a parte mais difícil)

O relógio de xadrez foi o desafio técnico mais complexo do projeto. A primeira versão calculava o tempo no navegador — como a maioria dos sites de xadrez amadores faz. Mas os problemas apareceram: em celulares com a aba em segundo plano o timer congelava e voltava errado; em computadores com relógio desajustado o tempo "acabava" antes da hora; dois jogadores viam tempos diferentes na mesma partida; o modal de "tempo esgotado" aparecia com os relógios ainda mostrando tempo sobrando.

A solução levou várias iterações até chegar na arquitetura definitiva: o backend se tornou a única fonte de verdade. Cada jogada passa por uma função transacional no banco de dados (commit_room_move) que, numa operação atômica, trava a linha da sala com um contador de versão, desconta o tempo do jogador da vez usando o relógio do servidor (statement_timestamp()), aplica o incremento, troca o turno, grava o tabuleiro e atualiza a âncora do relógio. Jogadas com versão antiga são recusadas. O timeout é confirmado por outra função transacional (confirm_room_timeout), nunca decidido pelo cliente. Uma tarefa cron percorre todas as salas ativas a cada minuto para garantir que nenhum timeout passe em branco. O navegador passou a ser apenas uma projeção somente de leitura do estado oficial.

O multiplayer em tempo real

As salas privadas foram construídas com sincronização via WebSockets (Supabase Realtime). O registro de jogadas é versionado — cada atualização carrega um número de versão que o servidor valida, impedindo que jogadas concorrentes se sobrescrevam. Um contador de sequência (game_seq) permite múltiplas partidas na mesma sala (revanche) sem duplicação no histórico. O bot (IA) também joga usando a mesma rotina transacional, respeitando a trava de versão.

O LMS (aprendizado)

A trilha de aprendizado interativa foi modelada do zero: módulos de tática (garfos, pregadores, ataques duplos, desvios), estratégia (controle do centro, invasão da 7ª fileira), puzzles em quatro modalidades (diário, treino livre, modo cronometrado e por temas) com sistema de rating próprio, biblioteca de aberturas com diagramas jogáveis, e cursos com vídeo (embed do YouTube), anotações pessoais, comentários aninhados e certificado de conclusão em PDF gerado por uma Edge Function. Cada lição foi revisada para garantir que a posição inicial fosse legal e que a sequência de lances fizesse sentido.

A comunidade

O feed social foi construído do zero: posts com texto, fotos e vídeos, enquetes com votação, menções a usuários, curtidas, fixação de postagens pelo admin, compartilhamento (WhatsApp, X, Facebook, copiar link). Um diretório de jogadores online, ranking global com badges de tier, 39 artigos educacionais originais com busca em texto completo e sistema de comentários, e sorteios com meta de participantes, foto do prémio e link de afiliado para indicação de amigos.

Os torneios

O sistema de torneios foi construído do zero com três formatos: suíço (emparelhamento automático por pontuação), todos-contra-todos (round-robin) e eliminatória. Geração automática de rodadas, criação automática de salas para cada partida, inscrição com ou sem taxa (integração de pagamento via Asaas), W.O. automático por tempo, notificações para organizadores e participantes, e certificados de participação.

A infraestrutura

O backend não é um servidor genérico: são ~50 tabelas organizadas por domínio (jogo, aprendizado, comunidade, torneios, sorteios, e-mails, administração), cada uma com Row Level Security ativada e políticas específicas por papel (admin, responsável, usuário). O sistema de papéis vive em tabela separada (nunca no perfil), acessível via função has_role() security definer. O sistema de e-mails tem fila (pgmq), tratamento de bounce, descadastro em um clique, templates com a identidade visual da marca, e notificações transacionais (boas-vindas, resumo semanal, dicas, alertas de torneio). Tarefas cron expiram salas ociosas, varrem timeouts, enviam notificações de aniversário e processam a fila de e-mails — tudo automático.

O painel administrativo

Um dashboard completo para gerenciar tudo: usuários (com troca de papel), cursos e aulas (com reordenação por drag-and-drop), certificados, artigos (com geração de imagem de capa por IA), banners, comentários, salas, sorteios, logos do site e status do sistema.

Os detalhes que importam

Login social com Google, recuperação de senha, página de onboarding, controle parental com limite de tempo de tela e métricas, gamificação com conquistas e badges, suporte a três idiomas (pt-BR, en, es), design responsivo do mobile ao desktop, e uma identidade visual própria (tons de azul e marrom, padrão de tabuleiro no rodapé). Nada disso veio pronto — tudo foi construído peça por peça.