Résultats et Scoring¶

Vue d'ensemble¶

Le système de scoring de Primatch permet la saisie, la validation croisée et l'enregistrement des résultats des parties de padel. Il gère le calcul automatique des niveaux des joueurs après validation.

Cycle de vie du score¶

stateDiagram-v2
    [*] --> EnCours: Partie démarre
    EnCours --> ScoreSoumis: Un joueur saisit le score
    ScoreSoumis --> EnValidation: Notification aux participants
    EnValidation --> ScoreValidé: Un joueur de chaque équipe confirme
    EnValidation --> Contesté: Un joueur conteste
    Contesté --> ScoreSoumis: Nouveau score proposé
    EnValidation --> ScoreValidé: Délai 24h dépassé (auto-validation)
    ScoreValidé --> [*]: Niveau mis à jour

Saisie du score¶

Qui peut saisir ?¶

N'importe quel joueur participant à la partie peut saisir le score une fois la partie terminée (statut finished).

Format du score¶

Le score est saisi par set :

Le nombre de sets correspond à la configuration choisie lors de la création de la partie (sets_count).

Règles de validation¶

• Les scores doivent être des entiers positifs
• Le nombre de sets soumis doit correspondre au sets_count de la partie
• L'équipe gagnante est déterminée automatiquement (majorité des sets gagnés)

Validation croisée¶

Processus¶

1. Soumission : Un joueur soumet le score → notification envoyée aux 3 autres joueurs
2. Validation : Chaque joueur peut :
3. ✅ Confirmer le score proposé
4. ❌ Contester en proposant un score différent
5. Résolution :
6. Si un joueur de chaque équipe confirme → score validé
7. Si un joueur conteste → nouveau cycle avec le score alternatif
8. Si pas de réponse sous 24 heures → auto-validation

Endpoint API¶

POST   /api/v1/games/{game}/score          # Soumettre un score
GET    /api/v1/games/{game}/score           # Voir le score
POST   /api/v1/games/{game}/score/validate  # Valider le score
POST   /api/v1/games/{game}/score/contest   # Contester le score

Impact sur le niveau¶

Parties compétitives uniquement¶

Seules les parties de type competitive impactent le niveau des joueurs. Les parties friendly n'ont aucun effet sur le niveau mais contribuent quand même au score de fiabilité.

Algorithme de progression des niveaux¶

Phase 1 — Évaluation initiale (quiz d'inscription)¶

À l'inscription, un quiz de 3 questions détermine le niveau de départ du joueur :

Le score total (0 à 15) est mappé vers l'un des 14 niveaux disponibles via un tableau de correspondance fixe :

Score 0–1   → Niveau 1.0 (Débutant)
Score 2     → Niveau 2.0 (Perfectionnement)
Score 3     → Niveau 2.5 (Perfectionnement+)
Score 4     → Niveau 3.0 (Élémentaire)
Score 5     → Niveau 3.5 (Élémentaire+)
Score 6     → Niveau 4.0 (Intermédiaire)
Score 7     → Niveau 4.5 (Intermédiaire+)
Score 8     → Niveau 5.0 (Confirmé)
Score 9     → Niveau 5.5 (Confirmé+)
Score 10    → Niveau 6.0 (Avancé)
Score 11    → Niveau 6.5 (Avancé+)
Score 12    → Niveau 7.0 (Expert)
Score 13    → Niveau 7.5 (Expert+)
Score 14-15 → Niveau 8.0 (Élite)

Phase 2 — Formule de progression (parties compétitives)¶

Le changement de niveau après une partie compétitive est calculé par la méthode calculateLevelChange() dans ScoreService :

$$\Delta_{\text{niveau}} = \text{baseFactor} \times \text{surpriseFactor} \times \text{scoreAmplifier}$$

$$\text{nouveauNiveau} = \max(1.0,\ \min(10.0,\ \text{ancienNiveau} + \Delta_{\text{niveau}}))$$

Facteur 1 — Base (baseFactor)¶

Détermine le sens du changement selon le résultat :

$$\text{baseFactor} = \begin{cases} +0.15 & \text{victoire} \ -0.10 & \text{défaite} \end{cases}$$

Facteur 2 — Surprise (surpriseFactor)¶

Amplifie le gain quand on bat une équipe plus forte, et réduit le gain quand on bat une équipe plus faible :

$$\text{levelDiff} = \text{moyNiveau}{adversaires} - \text{moyNiveau}$$

$$\text{surpriseFactor} = 1.0 + (\text{levelDiff} \times 0.1)$$

Facteur 3 — Amplificateur de score (scoreAmplifier)¶

Amplifie le changement selon la marge de victoire ou de défaite :

$$\text{scoreDiff} = \frac{|\text{score}_A - \text{score}_B|}{\text{score}_A + \text{score}_B}$$

$$\text{scoreAmplifier} = 1.0 + (\text{scoreDiff} \times 0.3)$$

Le score de la partie amplifie le changement — une victoire écrasante accélère la montée (ou la descente), un match très serré a peu d'impact quel que soit le résultat.

Exemples concrets¶

Bornes du niveau¶

Le niveau est toujours borné entre 1.0 et 10.0 :

$newLevel = max(1.0, min(10.0, $currentLevel + $delta));

Un joueur ne peut pas descendre en dessous de 1.0 ni monter au-dessus de 10.0 (même si l'échelle des niveaux va jusqu'à 8.0 dans le seeder, la plage technique est 1–10).

Score de fiabilité¶

Le score de fiabilité mesure la confiance qu'on peut accorder au niveau affiché.

Un joueur avec 40 parties validées atteint 100% de fiabilité (20% + 40 × 2%). La fiabilité est destinée à être affichée publiquement pour indiquer si le niveau est "certifié terrain" ou basé sur une auto-déclaration.

Notifications liées au scoring¶