01 Deux façons de jouer ensemble

Le jeu connaît trois manières de jouer une grille, enregistrées dans le champ mode de chaque partie : seul⁠·⁠e, partagée et en direct. Les deux dernières se ressemblent à l'écran, mais pas du tout en base.

Partagée En direct
Où l'on joue sur un seul téléphone, à côté chacun⁠·⁠e sur le sien, où qu'on soit
Quand on invite une fois la grille réussie pendant la partie
Ce que reçoit l'ami⁠·⁠e une copie de la partie réussie une place dans la partie commune
Score celui de la partie copiée celui de l'équipe, le même pour tous
Temps réel aucun les coups des autres arrivent en direct

Dans les deux cas, chaque partie garde players_count, le nombre de personnes qui l'ont jouée (le « faite à N »), et le même mode sur toutes les parties de l'équipe.

02 Le modèle de données

Tout tient dans cinq tables PostgreSQL. Le partage et le direct utilisent les mêmes, mais pas les mêmes liens.

Guess game → row · col the cell station correct hint hint? points frozen author → player Game player · grid status · gave_up score restarts_count players_count done by N mode 1 · 2 · 3 shared_from → sharing team → live GridInvitation player game → sharing team → live status Team grid holder → the game players_count active TeamMember team → player game → joined_at left_at left? shared_from team team holder game
Les cinq tables du jeu à plusieurs : le partage passe par shared_from, le direct par Team.
  • Game est une tentative d'un joueur sur une grille ; sa partie courante est la plus récente. Elle garde son issue (status, gave_up), son score tenu à jour et ses reprises, plus deux champs pour le jeu à plusieurs : players_count, le « faite à N », et mode (1 seul⁠·⁠e, 2 partagée, 3 en direct), la même valeur sur toutes les parties d'une équipe.
  • Guess est un coup, toujours rattaché à une partie. Une bonne réponse, une erreur et un indice sont tous des Guess : correct dit si la station convient, hint si c'est un indice. points est figé au moment du coup (bonus de rareté compris, −20 pour une erreur ou un indice), et le score de la partie en est la somme, moins les reprises. author n'est rempli que si le coup a été joué par quelqu'un d'autre que le joueur de la partie : vide, c'est lui.
  • GridInvitation est une invitation à un⁠·⁠e ami⁠·⁠e, de l'un des deux genres : game pour un partage (la partie réussie à copier), team pour le direct (l'équipe à rejoindre). Une contrainte de la base exige exactement l'un des deux. status vaut en attente, acceptée ou refusée.
  • Team est une équipe en direct : sa grille, holder, la partie qui porte les coups, et players_count, le nombre de membres encore là.
  • TeamMember est un séjour d'un joueur dans une équipe, avec la partie qu'il y joue, joined_at et left_at. Une contrainte n'autorise qu'un séjour en cours par joueur et par équipe : revenir crée une nouvelle ligne.

Deux liens font toute la différence. En partage, Game.shared_from relie chaque copie à la partie d'origine. En direct, Game.team relie les parties des membres à leur équipe, et Team.holder désigne la seule d'entre elles qui porte les coups.

03 Le partage après coup : une copie

Tu as réussi la grille avec des ami⁠·⁠es assis⁠·⁠es à côté de toi. Tu peux alors les inviter, parmi les joueurs que tu suis dont la partie sur cette grille n'est pas terminée. Seule ta propre partie réussie se partage : ni une copie reçue, ni une partie jouée en direct.

Quand un⁠·⁠e ami⁠·⁠e accepte, il ou elle reçoit une copie identique : mêmes réponses, mêmes indices, mêmes reprises, même score, même début et même fin. Le champ shared_from de la copie renvoie à ta partie. Rien n'est recompté : la copie n'ajoute aucune réponse aux compteurs de la case, et la rareté de chaque réponse reste celle que tu as obtenue.

Game 101 · Alice status = won score = 640 players_count = 3 mode = shared shared_from = NULL 9 Guess, played here Game 205 · Bob status = won score = 640 players_count = 3 shared_from = 101 9 Guess, copied Game 206 · Chloé status = won score = 640 players_count = 3 shared_from = 101 9 Guess, copied shared_from GridInvitation game = 101 player = Bob accepted game = 101 player = Chloé accepted game = 101 player = David pending
Un partage : chaque ami⁠·⁠e qui accepte reçoit sa propre copie, reliée à l'originale par shared_from.

La copie devient la partie courante de l'ami⁠·⁠e sur la grille. S'il ou elle avait commencé de son côté, cette partie-là reste, comme une partie d'avant une reprise. Puis players_count est mis à jour sur ta partie et sur toutes ses copies : à chaque nouvel ami⁠·⁠e qui accepte, tout le monde passe de « faite à 2 » à « faite à 3 ».

04 En direct : une seule partie pour toute l'équipe

En direct, il n'y a pas de copie pendant la partie : toute l'équipe écrit dans une seule partie, celle de qui a lancé les invitations.

Team team key = HMAC(id) players_count = 2 lock for every move members TeamMember · one stay per row Alice current Bob current Chloé left at 12:10 holder Alice's game holder all the answers author = who played Bob's game pointer no answers written at the end Chloé's game no team her own copy of the answers played solo since
Une équipe, une seule partie écrite : celle du holder. Les autres membres n'ont qu'un renvoi vers elle.
  • Team est l'identité stable de l'équipe. Sa ligne sert de verrou : chaque action (un coup, un indice, un abandon, une arrivée, un départ) commence par un SELECT … FOR UPDATE dessus, si bien que deux coups de l'équipe ne s'exécutent jamais en même temps. players_count compte les membres actifs.
  • La partie holder (Team.holder) est la seule qu'un coup écrit : une ligne Guess, dont le champ author dit qui l'a jouée, et la mise à jour du score.
  • Les parties pointeurs des autres membres n'ont aucune réponse : quand le serveur charge l'état d'un membre, il suit le renvoi vers le holder. Elles ne sont écrites qu'à l'arrivée du joueur, puis une fois à la fin, en un seul UPDATE : statut, score, heure de fin et taille de l'équipe.
  • TeamMember garde une ligne par séjour : Chloé, partie à 12 h 10, y figure encore, avec son heure de départ. Sa partie a perdu son équipe et porte sa propre copie des coups.

Un coup coûte ainsi la même chose à deux ou à six : une insertion et une mise à jour. Et deux coéquipier⁠·⁠ères ne peuvent jamais avoir des grilles différentes en base.

05 Rejoindre en cours de route : la mise en commun

On peut rejoindre une équipe alors qu'on a déjà commencé la grille de son côté. Ta progression est alors mise en commun avec celle de l'équipe, avec une règle simple : on garde tes bonnes réponses qui manquent à l'équipe, et le pire des deux pour les erreurs et les indices, jamais la somme.

L'équipe d'Alice Bob, seul L'équipe après l'arrivée de Bob
Cases trouvées 4 3, dont 1 déjà trouvée par Alice 6
Erreurs 1 2 2
Indices 0 1, sur une case encore vide 1
Bob's game, solo Team's game (holder) ✓ A1 Odéon cell taken ✓ B2 Nation ✓ C1 Bastille ✗ error ✗ error already 1 ? hint C3 ✓ A1 Saint-Michel author = Alice ✓ A2 Opéra author = Alice ✓ A3 Cité author = Alice ✓ B1 Pigalle author = Alice ✗ error author = Alice ✓ B2 Nation author = Bob ✓ C1 Bastille author = Bob ✗ error author = Bob ? hint C3 author = Bob
La mise en commun : quatre coups de Bob sont copiés dans la partie de l'équipe, avec lui pour auteur. Sa propre partie ne change pas.
  • Une bonne réponse de Bob est copiée si sa case et sa station sont encore libres dans la partie de l'équipe (une station ne sert qu'une fois par grille). Elle garde ses points, gagnés au moment où Bob l'a jouée, et Bob en devient l'auteur.
  • Pour les erreurs, on copie juste ce qu'il faut pour que l'équipe en ait autant que Bob : ici une seule, qui coûte 20 points à l'équipe. Même chose pour les indices, seulement sur une case encore vide.
  • La partie de Bob reste telle quelle, comme une partie d'avant une reprise. Rien n'est recompté dans les statistiques des cases.

Pourquoi le pire et pas la somme ? Additionner les erreurs pourrait faire perdre une équipe à l'instant même où quelqu'un la rejoint. Garder seulement celles de l'équipe permettrait à l'inverse d'effacer ses erreurs en rejoignant des ami⁠·⁠es.

06 La répartition des points

Les points ne se partagent pas entre les membres : ils appartiennent à la partie, et chaque membre a le score entier de l'équipe.

  • Une réponse rapporte la même chose quel que soit qui la joue : 15 points, plus le bonus de rareté de la station dans sa case. Ces points sont fixés au moment de la réponse et ne bougent plus, même quand la réponse est copiée.
  • Les pénalités sont communes : une erreur ou un indice coûte 20 points à toute l'équipe, et les 3 essais et les 3 indices sont ceux de la partie, pas de chacun⁠·⁠e. Une reprise, après une partie perdue sur les erreurs, fait repartir toute l'équipe sur de nouvelles parties, avec la pénalité de 50 points pour tout le monde.
  • Le score suit la formule d'une partie seule : la somme des points des réponses, moins 50 par reprise, ramenée entre 0 et 900.
  • Chaque case garde son auteur⁠·⁠e. C'est ce qui permet d'afficher qui a trouvé quoi, et combien de cases chaque membre a trouvées, sans jamais découper le score.

Une partie partagée suit la même logique : la copie a le score de la partie d'origine, ni plus ni moins.

Au classement du jour, chaque membre apparaît avec le score de l'équipe. Les membres d'une même équipe sont regroupés sur une seule ligne, sous le pseudo de qui a lancé la partie, et chacun⁠·⁠e garde son rang. À score égal, une partie à plusieurs se range après une partie seule parfaite (sans erreur ni reprise) et avant une partie seule avec erreurs. La taille de l'équipe est affichée, mais ne pondère pas encore le score.

Tes statistiques, elles, ne comptent que les parties qui portent leurs propres réponses : une copie reçue d'un⁠·⁠e ami⁠·⁠e ou une partie de membre en direct n'y entre pas. En direct, seul⁠·⁠e qui tient la partie de l'équipe y voit donc la grille ; pour les autres membres, comme pour qui reçoit une copie, elle n'y apparaît pas.

07 Comment un coup arrive chez les autres

Un coup ne se rejoue pas chez les autres. Python l'applique une fois, en base, valide la transaction, puis publie dans Redis une notice que le serveur temps réel fait suivre à toute l'équipe. Cette notice porte l'état d'après, un delta :

JSON
{
  "kind": "found",
  "code": "K7MP3QRS9TUV",
  "delta": {
    "score": 312, "errors": 1, "hints": 0, "found_count": 7, "restarts_count": 0,
    "can_hint": true, "is_over": false,
    "open_counts": [[4, 0, 12], [9, 3, 1], [6, 2, 5]],
    "cell": {"row": 0, "col": 1, "station": "…", "found_by": "K7MP3QRS9TUV"}
  }
}

La page de chaque coéquipier⁠·⁠ère ne recalcule rien, elle recopie ces valeurs. Mais avant, elle compare les compteurs du delta à ceux qu'elle affiche :

Verdict Quand Ce que fait la page
appliquer un seul compteur avance, d'un cran (une case trouvée, une erreur ou un indice) applique le delta : la case s'allume, le score défile
déjà vu aucun compteur n'avance rien : c'est son propre coup, un doublon, ou un rechargement arrivé avant
trou un compteur saute de deux, ou l'équipe a recommencé recharge la grille depuis l'API

Appliquer deux fois le même delta ne change rien, puisque les compteurs sont des valeurs absolues. Et chaque coup fait avancer exactement un compteur : un coup perdu ou arrivé dans le désordre se voit à un saut, et la page recharge. Pendant que ta propre requête est en route, les deltas des autres attendent dans une file, puis sont vérifiés contre la réponse. La fin de partie se recharge toujours : l'écran de fin a besoin de plus qu'un delta.

08 Quand quelqu'un s'en va

S'en aller recouvre deux choses très différentes : quitter la page, et quitter l'équipe.

Quitter la page

Fermer l'onglet, passer à une autre appli ou perdre le réseau ne change rien en base : tu restes membre, et la partie continue sans toi. Seule ta présence change.

  1. La page ferme sa connexion temps réel dès qu'elle est cachée.
  2. Le serveur temps réel retire ta présence de Redis et prévient tes coéquipier⁠·⁠ères, qui te voient partir. Si tu montrais une case, il l'efface chez eux.
  3. Si le serveur a planté sans faire ce ménage, ta présence expire seule au bout d'une minute.

Pendant ton absence, les coups des autres sont écrits et publiés, mais personne ne les met de côté pour toi. À ton retour, la page se reconnecte et recharge la grille, qui contient tous les coups joués entre-temps ; les nouvelles cases s'allument comme pour un coup en direct. Si la partie s'est terminée sans toi, le résultat est déjà écrit dans ta partie, et elle compte pour toi comme pour les autres.

Quitter l'équipe

Quitter l'équipe est possible tant que la partie est en cours, ou perdue sur les erreurs. Tout se passe dans une transaction, sous le verrou de l'équipe :

  • un membre part : les réponses de l'équipe sont copiées dans sa partie, auteur⁠·⁠es compris⁠·⁠es, et elle perd son équipe. Il ou elle continue seul⁠·⁠e exactement où en était l'équipe, cases, erreurs et indices compris, avec le même score. Sa partie garde la taille qu'avait l'équipe, et reste marquée comme jouée à plusieurs ;
  • qui tient la partie de l'équipe part : sa partie garde ses réponses et reste la sienne. Le membre arrivé le premier reçoit une copie des réponses, et sa partie devient la nouvelle partie de l'équipe. L'équipe elle-même ne change pas ;
  • dans les deux cas, players_count baisse d'un. S'il ne reste qu'une personne, elle joue comme seule et peut inviter à nouveau.
Before Team players = 3 Alice holder Bob pointer Chloé pointer holder After Alice leaves Team players = 2 Alice no team Bob holder · copy Chloé pointer holder
Quand qui tient la partie de l'équipe s'en va, le holder passe au membre arrivé le premier. L'équipe, sa clé et ses invitations ne changent pas.

Les points ne se divisent pas au départ non plus : qui part emporte le score entier de l'équipe à cet instant, et ce qu'il ou elle joue ensuite ne compte plus que pour sa partie. Quitter une partie perdue sur les erreurs garde son issue : on peut ensuite la recommencer seul⁠·⁠e, avec la pénalité de reprise.

Côté temps réel, la page de qui part reçoit un nouveau ticket sans équipe et se reconnecte : elle ne reçoit plus les coups de l'équipe. Les autres reçoivent une notice left, rechargent la grille et reçoivent à leur tour un ticket sans le ou la partant⁠·⁠e.