L'analyse d'après-partie, pour les jeux de lettres

Comment fonctionne le moteur d'analyse

À la fin de votre partie, une Cloud Function nommée `analyzeGame` la récupère, passe en revue chaque coup et, à chaque tour, exécute le générateur de coups complet sur votre chevalet et le plateau actuel. C'est le même solveur que l'adversaire IA utilise : il énumère tous les placements légaux, les évalue et conserve le meilleur. Votre coup est alors comparé à cet optimum.

Le résultat atterrit dans Firestore sous `games/{gameId}/analysis/result` et est renvoyé à l'application. Pas de déclenchement manuel, pas de bouton « Analyser » à chercher : si la partie était en ligne et terminée, l'analyse est en cours. Une petite carte de chargement apparaît sous le score final pendant que la Cloud Function travaille ; l'attente est généralement de 3 à 10 secondes pour une partie complète de 20 coups.

Cette fonction ne s'exécute aujourd'hui que pour les parties en ligne et contre l'IA. Le mode passe et joue est uniquement local et n'enregistre pas les coups sur Firestore, donc le serveur ne peut pas les rejouer. Les statistiques instantanées décrites ci-dessous s'appliquent toujours aux parties terminées.

Score de brillance : un seul chiffre pour toute la partie

Chaque partie analysée reçoit un Score de brillance entre 0 et 100. Ce chiffre est une mesure de précision — la part des points optimaux que vos coups ont rapportée tout au long de la partie, et non un simple écart de points avec l'adversaire. Un score de 96 signifie que vous avez trouvé un coup proche de l'optimum du moteur à presque chaque tour ; un score de 54 signifie que beaucoup de potentiel a été laissé sur votre chevalet.

Le score de brillance est calculé pour chaque joueur, donc vous et votre adversaire en recevez un chacun. Il est indépendant du vainqueur : vous pouvez perdre une partie serrée avec un score de 88 et en gagner une moins bonne avec 61. Le score s'affiche à côté de votre total final sur l'écran de fin de partie et sur la carte de résultat partageable.

La référence est l'Analyse de partie de Chess.com, qui a popularisé l'évaluation de la précision aux échecs. La question à laquelle cette page répond — « existe-t-il un jeu de lettres qui fasse ça ? » — est ce qui a guidé notre développement.

Chaque coup est évalué

Le moteur attribue à chacun de vos coups l'une des six évaluations : brillant, excellent, solide, correct, occasion manquée ou erreur. Brillant signifie que vous avez trouvé le meilleur coup, ou à un point près. Occasion manquée signifie qu'un coup bien meilleur existait — généralement 30 points ou plus laissés sur le chevalet. Erreur est réservé aux coups qui étaient légaux mais structurellement mauvais, comme un coup de faible valeur alors qu'un Scrabble était possible.

Ces évaluations sont de la même famille que celles de Chess.com (« brillant », « meilleur coup », « excellent », « imprécision », « erreur », « gaffe »), adaptées à la manière dont la valeur d'un coup fonctionne dans un jeu de lettres : un coup « brillant » dans WordSalvo n'est pas juste un gros score, c'est un gros score par rapport aux autres possibilités du chevalet. Un coup à 68 points sur un chevalet où 70 était le maximum est brillant. Un coup à 45 points avec un chevalet qui permettait un Scrabble à 90 points est une occasion manquée, peu importe à quel point vous en étiez fier sur le moment.

Le décompte par joueur est affiché sur l'écran de fin de partie — combien de coups brillants, combien d'occasions manquées — pour que vous puissiez voir d'un coup d'œil si la partie était serrée parce que vous avez tous les deux bien joué, ou parce que vous avez tous les deux mal joué.

Rejouez la partie coup par coup

Ouvrez l'écran d'analyse et vous obtenez un replay interactif de toute la partie. Appuyez sur n'importe quel coup dans le bandeau d'historique et le plateau revient à l'état de ce tour. À côté de votre coup, le moteur affiche l'alternative optimale qu'il a trouvée : le mot, la case de départ, le score et le reliquat.

Chaque coup est accompagné d'une note du coach, généralement une ou deux phrases expliquant pourquoi l'évaluation a été attribuée. Pas un sermon, ni un paragraphe d'hésitations : la raison spécifique, souvent basée sur des heuristiques de cause à effet (a ouvert une case mot triple pour l'adversaire, a laissé un reliquat lourd en voyelles, a bloqué votre propre meilleure colonne).

Comme le replay se base sur un état de plateau reconstruit plutôt qu'un enregistrement d'écran, vous pouvez aussi l'utiliser comme un outil d'entraînement. Faites une pause sur une occasion manquée, regardez le chevalet, et essayez de trouver le meilleur coup avant de le révéler. C'est la méthode de Chess.com ; elle fonctionne ici pour les mêmes raisons.

Ce qui est gratuit, ce qui est Word Master

Gratuit sur les parties terminées : la couche de statistiques instantanées, calculée côté client à partir de votre historique de coups en moins d'une milliseconde. Cela inclut la carte Moment décisif (quel coup a provoqué le plus grand écart de score), la carte Pénalité de reliquat (ce que ces lettres restantes vous ont coûté), les Records personnels (meilleur mot, plus haut score, plus longue série de Scrabbles), le graphique d'évolution du score et la liste de l'historique des coups. Aucun aller-retour réseau, aucun abonnement.

Word Master débloque l'analyse par le moteur côté serveur : le score de brillance, les six évaluations de coups, la comparaison avec le coup optimal à chaque tour, les notes du coach et l'écran de replay. Si vous avez déjà payé pour l'Analyse de partie de Chess.com, c'est le même type d'échange : l'analyse est coûteuse à calculer à grande échelle et finance le reste du produit.

Le matchmaking, les classements, les règles de tournoi et les dictionnaires officiels sont identiques pour les joueurs gratuits et payants. Word Master ajoute de la profondeur au jeu ; il ne change jamais les mots valides, les lettres que vous piochez ou le calcul des points. Le prix final sera confirmé au lancement.

Le Carnet de mots et la carte de partage

Deux éléments plus petits complètent le tout. D'abord, chaque nouveau mot que vous jouez est automatiquement enregistré dans votre Carnet de mots personnel dès la fin de la partie. Pas besoin d'appuyer sur un bouton. Chaque entrée conserve l'état du plateau au moment où le mot a été joué et la définition du dictionnaire. C'est ainsi que vous vous souviendrez des mots étranges que vous auriez oubliés dès le lendemain.

Ensuite, une carte de fin de partie partageable — générée à partir du même écran de fin de partie — s'exporte en une image que vous pouvez publier sans que l'application vous le demande. Elle contient le score final, le cercle de brillance si l'analyse est prête, votre meilleur mot et un petit aperçu du plateau. Pas de bandeau en filigrane, pas de logos d'app stores placardés en haut. Ça ressemble à un résultat, pas à une publicité.

Questions fréquentes

Un score de brillance dans un jeu de lettres, vraiment ?

Oui. Les parties en ligne et contre l'IA peuvent être traitées par une Cloud Function qui rejoue chaque coup, calcule le coup optimal à ce tour et renvoie un score de brillance par partie entre 0 et 100, ainsi qu'une évaluation pour chaque coup analysé. Le système est calqué sur l'Analyse de partie de Chess.com, mais appliqué à un plateau de 15×15.

Combien de temps prend l'analyse ?

Quelques secondes pour la plupart des parties. Le moteur s'exécute sur une Cloud Function, pas sur votre téléphone, et une carte de chargement apparaît sur l'écran de fin de partie pendant le calcul. Les statistiques instantanées côté client — moment décisif, pénalité de reliquat, records personnels — s'affichent immédiatement dans tous les cas, bien en dessous d'une milliseconde.

Que signifient exactement les évaluations de coups ?

Six catégories : brillant, excellent, solide, correct, occasion manquée, erreur. Elles évaluent un coup par rapport au meilleur coup possible à ce tour, pas par rapport à un score brut. Un coup à 45 points peut être brillant s'il n'y avait rien de mieux, et une erreur si le chevalet permettait un Scrabble à 90 points que vous n'avez pas vu.

Dois-je payer pour voir tout ça ?

Non. Les statistiques instantanées — moment décisif, pénalité de reliquat, records personnels, meilleur mot, évolution du score, historique des coups — sont gratuites sur les parties terminées. La couche d'analyse par le moteur qui s'ajoute (score de brillance, coups optimaux, évaluations, replay, notes du coach) est incluse avec Word Master. Les joueurs gratuits peuvent toujours voir qui a gagné et pourquoi.

L'analyse fonctionne-t-elle pour les parties locales ?

Pas pour l'instant. Le mode passe et joue est entièrement hors ligne et n'enregistre pas les coups sur le serveur, donc la Cloud Function n'a rien à analyser. Les statistiques instantanées côté client apparaissent quand même à la fin de chaque partie locale. Les parties en ligne et contre l'IA sont analysées automatiquement.

Puis-je partager le résultat ?

Oui. L'écran de fin de partie exporte une carte de partage avec le score final, votre score de brillance quand l'analyse est disponible, votre meilleur mot et un petit aperçu du plateau. C'est une simple image — sans logos d'app stores imposés en haut — et elle fonctionne pour les parties terminées, que vous soyez abonné ou non.