Manual de operação — dia D do torneio

Plugin: fsrs-gestao (WordPress FSRS)

Público: direção técnica, mesa, árbitros de quadra, árbitro-geral e staff com acesso admin

Formato: um único fluxo linear do dia da competição (papéis indicados inline quando importam)

Este manual cobre apenas a operação no dia do evento. Sorteio, inscrições pré-evento, ranking e cache ficam fora de escopo.

Como usar este documento

  1. Leia a Seção 1 na véspera ou na manhã, antes de abrir as quadras.
  2. Na abertura, execute a Seção 2 uma vez.
  3. Durante o torneio, repita a Seção 3 para cada partida.
  4. Use as seções 4–8 quando surgir exceção, consulta ou fechamento.

Referência rápida de telas admin (menu FSRS Torneios):

TelaSlug admin
Painel Torneio (KPIs)fsrs-torneios-painel
Torneios / statusfsrs-config-geral
Horários e Quadrasfsrs-disponibilidade
Agendamentofsrs-agendamento
Calendáriofsrs-calendario
Visual Chavesfsrs-visual
Lista de Jogosfsrs-lista-jogos
Firebase / TVfsrs-firebase-tv

1. Antes de abrir as quadras

Objetivo: garantir que o torneio está publicado no site, que o dia D está ativo na súmula e nas TVs, e que a equipa tem impressos e URLs de mesa.

1.1 Status do torneio (modelo atual)

O ciclo oficial está em fgs_torneios.status (não use o conceito legado fgs_torneio_ativo como referência de fase):

StatusSignificado operacional no dia D
PreparaçãoChaves e agenda em montagem; site ainda não exibe jogos ao público.
PublicadoChaves e cronograma visíveis em consulta-jogos; não aceitar novas inscrições.
Em jogoCompetição em andamento; súmula lista o evento em GET /eventos-ativos; operação normal nas quadras.
EncerradoTorneio finalizado; sem arbitragem nova.

No início do dia D, o torneio deve estar em Publicado (últimos ajustes de agenda) e, antes da primeira partida arbitrada, passar para Em jogo:

  1. WP Admin → FSRS Torneios → Torneios (fsrs-config-geral).
  2. No torneio do dia, confirmar badge Publicado.
  3. Quando a mesa autorizar a abertura das quadras: ação Iniciar competição → status Em jogo.

1.2 Checklist pré-abertura

#ItemResponsávelOK
1Torneio em Publicado ou já Em jogo conforme cronogramaDiretor técnico☐
2Chaves geradas e agendamento preenchido (dia, hora, quadra)Diretor técnico☐
3Horários e Quadras (fsrs-disponibilidade) com dias ativos e faixas corretasDiretor técnico☐
4Número de quadras do torneio = quadras físicas em usoDiretor técnico☐
5Firebase Produção (prod) em Firebase / TVGabriel / TI☐
6TVs testadas (painel + placar por quadra)Staff TV☐
7Impressos: Lista de Jogos + Visual Chaves (por categoria/dia necessário)Mesa☐
8URLs de mesa anotadas (secção 6)Mesa☐
9Árbitro-geral e árbitros de quadra briefados (súmula principal, WO, escalonamento)Árbitro-geral☐
FIGURA: checklist impresso na mesa com QR ou URLs das páginas públicas

1.3 Firebase e ambiente RTDB

Em evento oficial, usar sempre o ambiente prod do Firebase Realtime Database:

  1. FSRS Torneios → Firebase / TV (fsrs-firebase-tv).
  2. Ambiente RTDB: Produção (prod).
  3. Salvar.

A súmula grava estado ao vivo em prod/torneio_atual/quadra_N. As TVs leem o mesmo prefixo.

1.4 Impressos operacionais

Gerar antes ou no início do dia:

  1. Lista de Jogos (fsrs-lista-jogos) — filtros por categoria, dia e quadra; usar Imprimir do navegador.
  2. Visual Chaves (fsrs-visual) — uma folha por categoria crítica ou todas, conforme tamanho do evento.

Estes impressos são a referência de mesa quando a rede falhar. A operação primária de resultado continua sendo a súmula.

1.5 URLs para mesa (produção)

UsoURL
Chaves, cronograma e busca ao vivohttps://www.squashrs.com.br/consulta-jogos/
Status de inscrição (pré/dia — consulta CPF)https://www.squashrs.com.br/status-da-inscricao/
Painel TV (todas as quadras)https://www.squashrs.com.br/?tv=painel
Placar TV quadra Nhttps://www.squashrs.com.br/?tv=placar&q=N
Súmula quadra Nhttps://app.squashrs.com.br/?quadra=N

Substitua N pelo número da quadra (1, 2, 3…).

2. Abertura e monitorização

Executar uma vez ao abrir o complexo ou na primeira rodada.

2.1 Transição para Em jogo

  1. Torneios → torneio do dia → Iniciar competição.
  2. Confirmar badge Em jogo.
  3. Na súmula (?quadra=N), verificar se o torneio aparece (modo Torneio).

Teste opcional de API:

GET https://www.squashrs.com.br/wp-json/fsrs/v1/eventos-ativos

Deve listar o torneio do dia com "status": "em_jogo".

2.2 Painel e KPIs

  1. Painel Torneio (fsrs-torneios-painel) — visão de inscrições pagas/pendentes e, quando disponível, KPIs operacionais (jogos realizados, pendentes, ocupação, conflitos de agenda).
  2. Se o painel não refletir o torneio certo, abrir qualquer subpágina com t_id={id} na URL ou confirmar status em Torneios.
FIGURA: Painel Torneio com cartões de jogos pendentes e conflitos

2.3 TVs

Por cada quadra em uso:

  1. Abrir https://www.squashrs.com.br/?tv=placar&q=N no monitor da quadra.
  2. Abrir https://www.squashrs.com.br/?tv=painel na área comum (mesa / árbitro-geral).
  3. Confirmar nome do torneio e estado livre ou aguardando antes da primeira chamada.

Recarregar (F5) se o Firebase tiver sido reconfigurado na manhã.

3. Por cada jogo (fluxo padrão)

Repita para cada partida com dois atletas reais na quadra (não placeholder Vencedor J# nem BYE).

3.1 Preparar a partida

PassoQuemAção
1Mesa / árbitroConfirmar jogo na Lista de Jogos ou Calendário (hora, quadra, nomes).
2Árbitro de quadraChamar atletas; registro de presença visual.
3Árbitro de quadraAbrir súmula: https://app.squashrs.com.br/?quadra=N.
4ÁrbitroModo Torneio → selecionar o jogo listado (dados vindos de GET /jogos-pendentes).

Se o jogo não aparecer na súmula:

  • Confirmar torneio Em jogo.
  • Confirmar agendamento com quadra e horário no WP.
  • Confirmar que ambos os slots são atletas reais (não Vencedor J#).
  • Escalar mesa/diretor (secção 7).

3.2 Arbitrar na súmula (canal principal)

  1. Iniciar na súmula → aquecimento → games conforme regulamento da categoria (melhor-de configurado em Config. Técnicas).
  2. Registrar cada game; a TV da quadra atualiza via Firebase prod.
  3. Encerrar partida com placar final (ex.: 3x1).
  4. Aguardar confirmação de envio ao WordPress (POST /fsrs/v1/resultado-jogo).

Durante o jogo, o árbitro-geral pode acompanhar o Painel TV e o Calendário para atrasos nas outras quadras.

FIGURA: tela da súmula em modo Torneio com jogo selecionado e fila de envio OK

3.3 Confirmar no WordPress

Após envio bem-sucedido:

  1. Visual Chaves (fsrs-visual) — categoria do jogo: vencedor e placar preenchidos; em eliminatória, slot Vencedor J# da fase seguinte atualizado.
  2. Lista de Jogos — jogo marcado como concluído / fora da lista de pendentes.
  3. consulta-jogos — resultado visível ao público (pode exigir atualizar a página).

Se a súmula indicar erro de envio, não duplicar manualmente no Visual antes de tratar a fila (secção 7.1).

3.4 Próximo jogo na mesma quadra

  1. Verificar na súmula o próximo jogo podeArbitrar da quadra.
  2. Se a TV permanecer no jogo anterior, aguardar ciclo do painel ou recarregar placar TV.
  3. Retomar na etapa 3.1.

4. Fallback manual — Visual Chaves

Usar somente quando a súmula estiver indisponível, a fila de envio falhar de forma persistente, ou for necessário corrigir antes de escalar SQL — e apenas por utilizador com permissão manage_options (diretor técnico ou staff autorizado na quadra com login WP).

4.1 Eliminatória simples

  1. Visual Chaves → categoria → localizar o jogo.
  2. Selecionar vencedor (lado 1 ou 2) e placar resumido (ex.: 3x1).
  3. Salvar.
  4. Conferir preenchimento do confronto seguinte.

Walkover em eliminatória: tratar conforme instrução do árbitro-geral (secção 4.3); se o plugin expuser apenas placar manual, usar placar regulamentar de WO (ex.: 3x0 sem games) alinhado à Config. Técnicas da categoria.

4.2 Round robin (RR)

Na vista RR do Visual Chaves:

  1. Informar placar por game quando a partida não usou súmula.
  2. WO: botão WO → escolher lado favorecido → Salvar WO.
    • Sem games jogados: vitória por melhor-de (ex.: melhor de 3 → 3x0).
    • Com games parciais: regras exibidas no painel (crédito de games ao vencedor conforme regulamento CBS no plugin).

Empate na classificação (tabela RR): o plugin aplica automaticamente Games Pró → Saldo de Pontos → Confronto direto → Sorteio. Se aparecer indicador ⚠ empate pendente na tabela, a direção técnica resolve confronto direto ou sorteio — não é necessário cálculo manual na mesa.

4.3 Walkover (WO) — regra de campo

SituaçãoDecisão
Atleta não compareceÁrbitro de quadra declara WO após chamada em voz alta.
Dúvida de interpretaçãoEscalar árbitro-geral.
Tempo de tolerânciaReferência operacional: ~15 minutos após a chamada oficial (ajustar com árbitro-geral se o regulamento do evento fixar outro valor).

Registo preferencial: súmula (quando voltar) ou Visual Chaves RR/WO conforme secção 4.2.

5. Consultas e remanejamento durante o dia

5.1 Lista de Jogos

FSRS Torneios → Lista de Jogos (fsrs-lista-jogos):

  • Filtrar por categoria, dia (sexta/sábado/domingo/não agendado) e quadra.
  • Usar para briefing de árbitros, busca rápida e impressão por quadra.
  • Atualizar a página após remanejamentos.

5.2 Calendário por quadra

Calendário (fsrs-calendario):

  • Visão grelha por quadra e faixa horária.
  • Arrastar e soltar (DnD) — ativo em produção: mover bloco de jogo para outro horário/quadra (confirmação automática via AJAX).
  • Criar slot — ativo em produção: clicar espaço vazio na quadra para agendar jogo ainda sem horário.

5.3 Agendamento clássico

Se preferir formulário linha a linha: Agendamento (fsrs-agendamento) — alterar dia, horário e quadra por jogo e salvar.

5.4 Troca de atletas na chave (swap)

Em Visual Chaves, troca de slots entre jogos (feature swap ativa em produção):

  • Apenas diretor técnico (perfil com manage_options).
  • Só slots ainda sem vencedor e com atleta real (não BYE / não Vencedor J#).
  • Usar para correção de sorteio antes da partida — não substitui resultado de jogo.

6. Mesa e público

6.1 O que divulgar

PúblicoLinkO que encontram
Atletas e torcedores https://www.squashrs.com.br/consulta-jogos/ Chaves, horários, busca por nome (shortcode
RESULTADOS ENCONTRADOS:

Consulta de jogos com busca por atleta. Ver chaves para impressão

Campeonato Sul-Brasileiro de Squash 2026 — Feminino - Master +35 anos A

Final

#1 DOM 11:15 | Q3
Paula Gracia Koppe Colleoni
Gaziela Brolese
)
Inscritos (status pagamento) https://www.squashrs.com.br/status-da-inscricao/ Consulta por CPF — útil antes e no dia; não substitui chamada de quadra

Frase sugerida na mesa: “Horários e resultados: consulta-jogos no site squashrs.com.br.”

6.2 O que não prometer na mesa

  • Novas inscrições após o torneio Publicado.
  • Alteração de resultado já homologado sem passar pela direção técnica.
  • Ranking da temporada (fora do escopo deste manual).

6.3 Consulta de inscrição no dia

Se o atleta questionar pagamento: orientar a https://www.squashrs.com.br/status-da-inscricao/ (CPF 11 dígitos).
Problemas não resolvidos → diretor técnico (cadastro em Inscrições no admin, sem abrir nova vaga público).

FIGURA: página status-da-inscricao com resultado validado/pendente

7. Incidentes

7.1 Erro ou atraso na súmula

SintomaPrimeira açãoEscalar se persistir
Jogo não lista em TorneioVerificar status Em jogo e agendamentoDiretor técnico
Envio HTTP falha / fila vermelhaAnotar jogoId; tentar reenvio na súmulaGabriel / TI
TV sem atualizarConfirmar Firebase prod; F5 na TVGabriel
Placar errado antes de gravar no WPCorrigir na súmula—

7.2 Duplicata / jogo já processado

Se a súmula receber already_processed (jogo já tem vencedor no WP):

  1. Parar tentativas repetidas na súmula para o mesmo jogoId.
  2. Conferir Visual Chaves — resultado já está correto?
  3. Se o placar no WP estiver errado, não tentar “sobrescrever” pela súmula → secção 7.4.

7.3 Conflito de horário / sobreposição

  1. Painel Torneio ou Calendário — identificar conflito.
  2. Remanejar com DnD ou Agendamento (secção 5).
  3. Comunicar árbitros das quadras afetadas.
  4. Atualizar impressos se ainda forem usados na rodada.

7.4 Correção pós-gravação (resultado errado)

Não existe ecrã amigável de “desfazer resultado” para staff comum.

  1. Árbitro-geral e diretor técnico confirmam o erro (placar, vencedor, WO indevido).
  2. Escalar para diretor técnico autorizado + intervenção SQL em fgs_chaves (e slots derivados Vencedor J#), por pessoa habilitada.
  3. Reverter avanço indevido na fase seguinte, se já tiver sido preenchido.
  4. Re-arbitrar ou registar manualmente o valor correto (Visual Chaves ou nova súmula só se o registo anterior tiver sido revertido no WP).
  5. Documentar o incidente no relatório do evento (fora do sistema).

7.5 Swap indevido ou troca de atleta

  • Antes do jogo: refazer swap em Visual Chaves (diretor).
  • Depois do jogo iniciado: tratar como 7.4 se resultado foi afetado.

8. Fechamento do dia

8.1 Pendências

  1. Lista de Jogos / API jogos-pendentes — listar jogos sem vencedor ainda arbitráveis.
  2. Decidir: completar ainda hoje, remanejar para outro dia, ou WO regulamentar (árbitro-geral).
  3. Painel Torneio — rever KPIs de pendentes e conflitos zerados.

8.2 Manter Em jogo vs Encerrar

SituaçãoStatus recomendado
Haverá jogos no(s) próximo(s) dia(s) do mesmo torneioManter Em jogo overnight
Evento terminou (todas as categorias finalizadas)Encerrar torneio em Torneios
Encerramento porém correção tardia no dia seguinteDiretor pode Reabrir competição (volta a Em jogo) — uso excepcional

Ao Encerrar:

  • Súmula deixa de listar o evento em eventos-ativos.
  • Chaves permanecem visíveis em consulta-jogos (status Encerrado ainda exibe jogos ao público).
  • Não iniciar novo torneio oficial no mesmo RTDB sem alinhar Firebase com Gabriel.

8.3 Checklist de saída

#ItemOK
1Todas as partidas do dia com vencedor ou WO registrado☐
2TVs desligadas ou em tela neutra conforme local☐
3Impressos da manhã arquivados ou descartados☐
4Incidentes com SQL anotados para relatório☐
5Decisão registrada: Em jogo (continua) ou Encerrado☐

Apêndice A — Papéis no fluxo

PapelResponsabilidades principais no dia D
Diretor técnicoStatus do torneio, remanejamento, swap, fallback Visual, escalonamento SQL
Árbitro-geralWO em dúvida, ritmo do evento, conflitos entre quadras
Árbitro de quadraSúmula, chamada de atletas, WO local
MesaImpressos, URLs públicas, orientação a atletas, não altera chaves
Gabriel / TIFirebase prod/dev, falhas súmula/API/TV

Apêndice B — API REST (referência)

Base: https://www.squashrs.com.br/wp-json/fsrs/v1/

MétodoEndpointUso no dia D
GET/eventos-ativosSúmula lista torneios em_jogo
GET/jogos-pendentes?evento={nome}&categoria={opcional}Jogos arbitráveis e agenda por quadra
POST/resultado-jogoSúmula grava vencedor e placar (corpo JSON com jogoId, eventoId, etc.)

Respostas de erro frequentes: invalid_payload, jogo_nao_encontrado, already_processed, vencedor_invalido, rate_limited.

Apêndice C — Transições de status (admin)

Em Torneios (fsrs-config-geral), ações típicas:

  • Publicado → Iniciar competição → Em jogo (abertura dia D).
  • Em jogo → Encerrar torneio → Encerrado (fim do evento).
  • Em jogo → ← Voltar para publicado (correção excepcional antes de retomar).
  • Encerrado → ← Reabrir competição → Em jogo (exceção).

Documento operacional Fase 2 — fsrs-gestao. Revisar após mudanças em status, flags de calendário/swap ou contrato da súmula.

Rolar para cima