1. Apresentação

Este programa organiza um torneio de petanca em « mêlée » : em cada turno, as equipas são refeitas ao acaso, e o sistema evita ao máximo que os mesmos jogadores voltem a jogar juntos ou se enfrentem duas vezes. O classificação é individual (cada jogador marca os seus pontos), com, além disso, uma classificação por equipa quando se joga em equipas formadas.

Tudo acontece no topo da página: define-se o torneio, introduzem-se os jogadores à esquerda, lança-se, introduzem-se os resultados, e a classificação atualiza-se em direto.

2. Definições do torneio

Organizador / Clube

O nome do seu clube ou do organizador. Aparece no PDF oficial e é guardado na gravação.

Data do torneio

A data (texto livre, ex. 15/08/2026). Ela aparece também no PDF.

3. Modo das equipas

Duas opções, através dos botões Aleatório / Formada :

• Aleatório (mêlée pura): introduz uma lista de jogadores individuais. Em cada turno, o programa forma ele próprio as equipas ao acaso. É o verdadeiro modo « mêlée ».
• Formada : introduz equipas já constituídas (os mesmos colegas de equipa em cada turno). Só os adversários mudam em cada turno. Uma classificação por equipa é então adicionada automaticamente.

4. Formato de jogo

Botões Tête-à-tête / Dupla / Triplete :

• Tête-à-tête : 1 jogador por equipa.
• Dupla : 2 jogadores por equipa.
• Triplete : 3 jogadores por equipa.

No modo Aleatório, este formato determina o tamanho das equipas formadas em cada turno. No modo Formada, determina o número de casas de introdução por equipa.

5. Gestão dos restantes

Quando o número de jogadores não fecha, é preciso decidir o que fazer com os « restantes ». Duas opções (modo Aleatório, dupla/triplete apenas):

• Isentos obrigatórios — sorteio aleatório : os jogadores a mais são isentados para o turno (não jogam mas recebem um bónus de pontos, ver « Pontos para isentos »). O programa escolhe com prioridade os que foram menos vezes isentados, para ser equitativo.
• Mistura duplas + tripletes : em vez de isentar, o programa mistura duplas e tripletes para que todos joguem. Exemplo: 14 jogadores em triplete → 4 tripletes + 1 dupla.

6. Número de jogadores, de partidas e pontos para isentos

Sob estes ajustes, uma caixa « Repartição prevista » explica-lhe em tempo real o que dará a sua configuração (quantos isentos, quantas duplas/tripletes, número de turnos…).

7. Introdução dos jogadores

A coluna da esquerda « Lista de jogadores » preenche-se sozinha segundo o número escolhido. Para cada jogador (modo Aleatório):

• Nome do jogador e Licença (opcionais; é posto um nome predefinido se vazio).
• Função : Atirador, Apontador ou Meio (um só de cada vez — clicar num papel desmarca os outros).
• Feminino e Criança : caixas de verificação.

Estes dados servem para equilibrar as equipas : o programa tenta não pôr dois atiradores juntos, e repartir as jogadoras / crianças (ver secção 16).

8. Lançar a mêlée

O botão amarelo LANÇAR A MÊLÉE — TURNO 1 inicia o torneio: lê os jogadores introduzidos, forma o 1.º^.ª turno e mostra os jogos à direita.

9. Introduzir os resultados

Cada jogo mostra a equipa da esquerda, a zona de resultado ao centro, a equipa da direita. Três formas de introduzir:

Regras de validação

• Resultado entre 0 e 13.
• Sem empate : um jogo não pode terminar em empate (uma mensagem vermelha o lembra).
• Enquanto um jogo não for válido, o turno não é considerado « completo ».

Assim que um jogo é válido, a equipa vencedora passa a verde com a etiqueta Vencedor, e a classificação atualiza-se de imediato.

10. Turno a turno até ao campeão

Quando todos os jogos de um turno têm um resultado válido, um emblema Turno completo aparece, e no fundo do turno:

• Se ainda houver partidas para jogar: o botão azul LANÇAR O TURNO SEGUINTE — NOVA MÊLÉE cria o turno seguinte (novo sorteio).
• No último turno: uma faixa verde « CONCURSO TERMINADO — VENCEDOR » aparece, com o botão GERAR O PDF OFICIAL.

Se o mesmo par já teve como colega de equipa, um aviso laranja « Parceiros já vistos juntos » assinala-o (só acontece se for matematicamente inevitável).

11. As classificações

Sob os turnos, a classificação aparece com dois separadores. Em equipas formadas, a classificação por equipas aparece primeiro (separador predefinido), e a classificação individual mesmo ao lado no 2.º^e separador. Em mêlée aleatória (sem equipas fixas), só a classificação individual aparece.

🏆 Classificação por equipas (mostrada em primeiro)

No modo Equipas formadas (dupla ou triplete), cada equipa acumula os resultados das suas partidas, com as mesmas colunas que a classificação individual abaixo.

👤 Classificação individual

Cada jogador marca os seus próprios pontos. Colunas:

Ordem da classificação : primeiro o número de vitórias, depois a diferença (Diff), depois os pontos marcados (BP). Os 3 primeiros têm uma pastilha ouro / prata / bronze.

12. Backup e backup recuperação automática

O torneio é gravado automaticamente no seu navegador após cada resultado ou cada novo turno. Se fechar o separador por engano e voltar à página, tudo é recarregado sozinho (jogadores, resultados, turnos, ajustes).

O botão 💾 Guardar força uma gravação imediata e mostra uma confirmação.

13. Exportar / Importar

Ficheiro de salvaguarda (.json) — recomendado

• ⬇️ Exportar (ficheiro) : descarrega um ficheiro .json com todo o torneio. A guardar com cuidado ou a transferir para uma pen USB / outro PC.
• ⬆️ Importar (ficheiro) : recarrega um ficheiro .json anteriormente exportado e restaura tudo de forma idêntica.

Através do PDF (salvaguarda oculta)

• EXPORTAR O PDF : gera o PDF oficial e esconde discretamente a gravação completa do torneio.
• IMPORTAR UM PDF : relê um desses PDF para recuperar o torneio. Prático se só guardou o PDF.

14. Imprimir

O botão 🖨️ Imprimir abre diretamente a janela de impressão com um PDF limpo (o mesmo da exportação), sem os cabeçalhos e rodapés de página feios do navegador. Layout A4, a preto sobre branco, económico em tinta e bem legível.

O PDF contém: uma tabela por turno (Equipa A / Resultado / Equipa B / Vencedor), os isentos, e a classificação final.

15. Apagar tudo

O botão 🗑️ Apagar tudo apaga o torneio em curso e a gravação do navegador, após um pedido de confirmação. A utilizar para retomar de uma página totalmente em branco.

16. Como funciona o sorteio (para os curiosos)

Em cada turno, em modo Aleatório, o programa testa dezenas de composições e guarda a melhor segundo estas prioridades:

• Evitar atiradores juntos : tenta não pôr dois atiradores na mesma equipa.
• Repartir jogadoras e crianças : evita juntar vários jogadores « protegidos » (feminino / criança) na mesma equipa.
• Evitar repetições de colegas de equipa : privilegia equipas onde os jogadores não jogaram já juntos.
• Evitar voltar a jogar contra os mesmos adversários : ao emparelhar as equipas, procura oposições inéditas.
• Isentos equitativos : se alguém tiver de ser isentado, é prioritariamente quem o foi menos vezes.

É por isso que o mesmo sorteio pode dar composições diferentes: há uma parte de acaso, enquadrada por estas regras de equidade.

17. Perguntas frequentes

Fechei a página, perdi tudo?

Não: a retoma é automática. Reabra a página no mesmo navegador, o torneio volta. Em caso de dúvida, exporte regularmente o ficheiro .json.

Posso mudar o número de partidas a meio do percurso?

Sim. Modifique « Número de partidas »: a apresentação e o final do torneio adaptam-se (enquanto não tiver ultrapassado o novo total).

Um isento, marca quantos?

O bónus definido em « Pontos para isentos » (13-0 por predefinição), contado como uma vitória.

Posso misturar duplas e tripletes?

Sim, com a opção « Mistura duplas + tripletes » (em modo Aleatório, fora tête-à-tête), para que todos joguem sem isentos.

O PDF é gratuito?

Sim, tudo é 100% gratuito, oferecido pela Paquita em petanqueland.fr. 🎯