Documentation — Matchus

Introduction

Matchus est une plateforme sportive communautaire qui permet de créer et gérer des tournois, suivre son classement ELO et débloquer des badges au fil des victoires. Elle fonctionne comme une application installable (PWA) sur iOS et Android, sans passer par les stores.

ℹ️

Le plan Free est vraiment gratuit — aucune carte bancaire requise, tournois illimités, pas de cooldown entre les tournois contrairement à certains concurrents.

⚡ Pour les organisateurs

Wizard 5 étapes, poules, phase finale, terrains, live score, QR code, collaborateurs.

🏆 Pour les joueurs

Profil ELO, historique de matchs, badges, leaderboard global et par sport.

Créer un compte

Matchus supporte la connexion SSO via Google et Facebook — pas de mot de passe à créer. Cliquez sur "Essayer gratuit" depuis n'importe quelle page, choisissez votre provider et c'est parti.

1

Cliquez sur "Essayer gratuit"

Depuis la page d'accueil ou directement depuis l'app installée.

2

Choisissez Google ou Facebook

La connexion SSO crée automatiquement votre profil Matchus.

3

Complétez votre profil

Photo, ville, sports pratiqués. Votre profil public est généré avec votre QR code personnel.

Installer l'app

Matchus est une PWA (Progressive Web App) — elle s'installe directement depuis votre navigateur, sans App Store ni Google Play.

Sur iOS (Safari)

1

Ouvrez Matchus dans Safari

L'installation ne fonctionne qu'avec Safari sur iOS.

2

Appuyez sur l'icône Partager

Le bouton carré avec une flèche en bas de l'écran.

3

"Sur l'écran d'accueil"

L'icône Matchus apparaît comme une app native.

Sur Android (Chrome)

Chrome affiche automatiquement une bannière "Installer l'application" en bas de l'écran. Appuyez dessus, confirmez — c'est installé.

⚡

L'app installée fonctionne hors ligne pour consulter vos tournois en cours et votre profil. La synchronisation reprend dès que vous avez du réseau.

Créer un tournoi

Le wizard de création se déroule en 5 étapes guidées. Comptez 3 à 5 minutes pour un tournoi complet.

1

Sport

Sélectionnez parmi les 12 sports disponibles. Les règles, formats et scoring se chargent automatiquement.

2

Informations générales

Nom du tournoi, date, format d'équipe (simple/double/mixte selon le sport). Les règles de scoring sont pré-remplies et modifiables.

3

Équipes & joueurs

Saisie manuelle, génération automatique de fiches vides, ou importation. Le claim token permet de rattacher un joueur sans compte.

4

Format & poules

Phase de poules (nombre, qualifiés, meilleurs perdants) + phase finale (1/16 jusqu'à la finale). Match pour la 3ème place optionnel.

5

Validation & lancement

Récapitulatif complet avant création. Le lien public et le QR code sont générés immédiatement.

Saisir les scores

Depuis le dashboard de votre tournoi, cliquez sur un match pour ouvrir le Live Score Modal. Entrez les scores en temps réel — les classements et brackets se mettent à jour instantanément pour tous les spectateurs.

💡

La page publique (/public/:token) ne nécessite aucun compte pour être consultée. Partagez le lien ou le QR code avant le début du tournoi.

Classement ELO

Le système ELO de Matchus fonctionne comme aux échecs : votre score augmente quand vous battez un adversaire mieux classé, et diminue moins quand vous perdez contre plus fort. Chaque sport a son classement indépendant.

ELO gagné = K × (résultat − probabilité_victoire_attendue)
K = 32 (standard) · résultat = 1 victoire, 0.5 nul, 0 défaite

Les ELO sont calculés et mis à jour à la fin de chaque match, qu'il s'agisse d'un match unique ou d'un match de tournoi.

Badges & points

Matchus attribue des badges automatiquement selon vos accomplissements. Les badges ont quatre niveaux de rareté :

⚪ Common

Badges de départ — premier match, premier tournoi, première victoire.

🔵 Rare

Régularité et engagement — 10 matchs, 5 victoires consécutives.

🟣 Epic

Performances remarquables — champion de tournoi, top 10 ELO.

🟠 Legendary

Exploits rares — séries de victoires, classements nationaux.