1. Présentation

Ce logiciel organise un concours de pétanque en « mêlée » : à chaque tour, les équipes sont reformées au hasard, et le système évite au maximum que les mêmes joueurs rejouent ensemble ou s'affrontent deux fois. Le classement est individuel (chaque joueur marque ses points), avec en plus un classement par équipe quand on joue en équipes formées.

Tout se passe en haut de page : on règle le concours, on saisit les joueurs à gauche, on lance, on entre les scores, et le classement se met à jour en direct.

2. Réglages du concours

Organisateur / Club

Le nom de votre club ou de l'organisateur. Il apparaît sur le PDF officiel et est enregistré dans la sauvegarde.

Date du concours

La date (texte libre, ex. 15/08/2026). Elle apparaît aussi sur le PDF.

3. Mode des équipes

Deux choix, via les boutons Aléatoire / Formée :

• Aléatoire (mêlée pure) : vous saisissez une liste de joueurs individuels. À chaque tour, le logiciel forme lui-même les équipes au hasard. C'est le vrai mode « mêlée ».
• Formée : vous saisissez des équipes déjà constituées (les mêmes coéquipiers à chaque tour). Seuls les adversaires changent à chaque tour. Un classement par équipe s'ajoute alors automatiquement.

4. Format de jeu

Boutons Tête-à-tête / Doublette / Triplette :

• Tête-à-tête : 1 joueur par équipe.
• Doublette : 2 joueurs par équipe.
• Triplette : 3 joueurs par équipe.

En mode Aléatoire, ce format détermine la taille des équipes formées à chaque tour. En mode Formée, il détermine le nombre de cases de saisie par équipe.

5. Gestion des restants

Quand le nombre de joueurs ne tombe pas juste, il faut décider quoi faire des « restants ». Deux options (mode Aléatoire, doublette/triplette uniquement) :

• Exempts obligatoires — tirage aléatoire : les joueurs en trop sont exemptés pour le tour (ils ne jouent pas mais reçoivent un bonus de points, voir « Points pour exempts »). Le logiciel choisit en priorité ceux qui ont été le moins souvent exemptés, pour que ce soit équitable.
• Mélange doublettes + triplettes : au lieu d'exempter, le logiciel mélange des doublettes et des triplettes pour que tout le monde joue. Exemple : 14 joueurs en triplette → 4 triplettes + 1 doublette.

6. Nombre de joueurs, de parties et points pour exempts

Sous ces réglages, un encadré « Répartition prévue » vous explique en temps réel ce que donnera votre configuration (combien d'exempts, combien de doublettes/triplettes, nombre de tours…).

7. Saisie des joueurs

La colonne de gauche « Liste des joueurs » se remplit toute seule selon le nombre choisi. Pour chaque joueur (mode Aléatoire) :

• Nom du joueur et Licence (facultatifs ; un nom par défaut est mis si vide).
• Rôle : Tireur, Pointeur ou Milieu (un seul à la fois — cliquer un rôle décoche les autres).
• Féminine et Enfant : cases à cocher.

Ces informations servent à équilibrer les équipes : le logiciel essaie de ne pas mettre deux tireurs ensemble, et de répartir les joueuses / enfants (voir section 16).

8. Lancer la mêlée

Le bouton jaune LANCER LA MÊLÉE — TOUR 1 démarre le concours : il lit les joueurs saisis, forme le 1^er tour et affiche les matchs à droite.

9. Saisir les scores

Chaque match affiche l'équipe de gauche, la zone de score au centre, l'équipe de droite. Trois façons de saisir :

Règles de validation

• Score entre 0 et 13.
• Pas d'égalité : un match ne peut pas finir à égalité (un message rouge le rappelle).
• Tant qu'un match n'est pas valide, le tour n'est pas considéré comme « complet ».

Dès qu'un match est valide, l'équipe gagnante passe en vert avec l'étiquette Vainqueur, et le classement se met à jour aussitôt.

10. Tour par tour jusqu'au champion

Quand tous les matchs d'un tour ont un score valide, un badge Tour complet apparaît, et en bas du tour :

• S'il reste des parties à jouer : le bouton bleu LANCER LE TOUR SUIVANT — NOUVELLE MÊLÉE crée le tour suivant (nouveau tirage).
• Au dernier tour : une bannière verte « CONCOURS TERMINÉ — VAINQUEUR » s'affiche, avec le bouton GÉNÉRER LE PDF OFFICIEL.

Si un même binôme s'est déjà retrouvé coéquipier, un avertissement orange « Partenaires déjà vus ensemble » le signale (cela n'arrive que si c'est mathématiquement inévitable).

11. Les classements

Sous les tours, le classement s'affiche avec deux onglets. En équipes formées, le classement par équipes apparaît en premier (onglet par défaut), et le classement individuel juste à côté dans le 2^e onglet. En mêlée aléatoire (sans équipes fixes), seul le classement individuel s'affiche.

🏆 Classement par équipes (affiché en premier)

En mode Équipes formées (doublette ou triplette), chaque équipe cumule les résultats de ses parties, avec les mêmes colonnes que le classement individuel ci-dessous.

👤 Classement individuel

Chaque joueur marque ses propres points. Colonnes :

Ordre du classement : d'abord le nombre de victoires, puis la différence (Diff), puis les points marqués (BP). Les 3 premiers ont une pastille or / argent / bronze.

12. Sauvegarde & reprise automatique

Le concours est sauvegardé automatiquement dans votre navigateur après chaque score ou chaque nouveau tour. Si vous fermez l'onglet par erreur et revenez sur la page, tout est rechargé tout seul (joueurs, scores, tours, réglages).

Le bouton 💾 Sauvegarder force une sauvegarde immédiate et affiche une confirmation.

13. Exporter / Importer

Fichier de sauvegarde (.json) — recommandé

• ⬇️ Exporter (fichier) : télécharge un fichier .json contenant tout le concours. À garder précieusement ou à transférer sur une clé USB / un autre PC.
• ⬆️ Importer (fichier) : recharge un fichier .json précédemment exporté et restaure tout à l'identique.

Via le PDF (sauvegarde cachée)

• EXPORTER LE PDF : génère le PDF officiel et y cache discrètement la sauvegarde complète du concours.
• IMPORTER UN PDF : relit un de ces PDF pour récupérer le concours. Pratique si vous n'avez gardé que le PDF.

14. Imprimer

Le bouton 🖨️ Imprimer ouvre directement la fenêtre d'impression avec un PDF propre (le même que l'export), sans les en-têtes et pieds de page disgracieux du navigateur. Mise en page A4, noir sur blanc, économique en encre et bien lisible.

Le PDF contient : un tableau par tour (Équipe A / Score / Équipe B / Vainqueur), les exempts, et le classement final.

15. Tout effacer

Le bouton 🗑️ Tout effacer efface le concours en cours et la sauvegarde du navigateur, après une demande de confirmation. À utiliser pour repartir d'une page totalement vierge.

16. Comment fonctionne le tirage (pour les curieux)

À chaque tour, en mode Aléatoire, le logiciel teste des dizaines de compositions et garde la meilleure selon ces priorités :

• Éviter les tireurs ensemble : il essaie de ne pas placer deux tireurs dans la même équipe.
• Répartir les joueuses et enfants : il évite de regrouper plusieurs joueurs « protégés » (féminine / enfant) dans une même équipe.
• Éviter les répétitions de coéquipiers : il privilégie des équipes où les joueurs n'ont pas déjà joué ensemble.
• Éviter de rejouer les mêmes adversaires : au moment d'apparier les équipes, il cherche des oppositions inédites.
• Exempts équitables : si quelqu'un doit être exempté, c'est en priorité celui qui l'a été le moins souvent.

C'est pour cela qu'un même tirage peut donner des compositions différentes : il y a une part de hasard, encadrée par ces règles d'équité.

17. Questions fréquentes

J'ai fermé la page, j'ai tout perdu ?

Non : la reprise est automatique. Rouvrez la page sur le même navigateur, le concours revient. En cas de doute, exportez régulièrement le fichier .json.

Puis-je changer le nombre de parties en cours de route ?

Oui. Modifiez « Nombre de parties » : l'affichage et la fin du concours s'adaptent (tant que vous n'avez pas dépassé le nouveau total).

Un exempt, ça marque combien ?

Le bonus défini dans « Points pour exempts » (13-0 par défaut), compté comme une victoire.

Puis-je mélanger doublettes et triplettes ?

Oui, avec l'option « Mélange doublettes + triplettes » (en mode Aléatoire, hors tête-à-tête), pour que tout le monde joue sans exempt.

Le PDF est-il gratuit ?

Oui, tout est 100 % gratuit, offert par Paquita de petanqueland.fr. 🎯