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.
Gameest une tentative d'un joueur sur une grille ; sa partie courante est la plus récente. Elle garde son issue (status,gave_up), sonscoretenu à jour et ses reprises, plus deux champs pour le jeu à plusieurs :players_count, le « faite à N », etmode(1 seul·e, 2 partagée, 3 en direct), la même valeur sur toutes les parties d'une équipe.Guessest un coup, toujours rattaché à une partie. Une bonne réponse, une erreur et un indice sont tous desGuess:correctdit si la station convient,hintsi c'est un indice.pointsest 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.authorn'est rempli que si le coup a été joué par quelqu'un d'autre que le joueur de la partie : vide, c'est lui.GridInvitationest une invitation à un·e ami·e, de l'un des deux genres :gamepour un partage (la partie réussie à copier),teampour le direct (l'équipe à rejoindre). Une contrainte de la base exige exactement l'un des deux.statusvaut en attente, acceptée ou refusée.Teamest une équipe en direct : sa grille,holder, la partie qui porte les coups, etplayers_count, le nombre de membres encore là.TeamMemberest un séjour d'un joueur dans une équipe, avec la partie qu'il y joue,joined_atetleft_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.
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.
Teamest 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 unSELECT … FOR UPDATEdessus, si bien que deux coups de l'équipe ne s'exécutent jamais en même temps.players_countcompte les membres actifs.- La partie holder (
Team.holder) est la seule qu'un coup écrit : une ligneGuess, dont le champauthordit 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. TeamMembergarde 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 |
- 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 :
{
"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.
- La page ferme sa connexion temps réel dès qu'elle est cachée.
- 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.
- 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_countbaisse d'un. S'il ne reste qu'une personne, elle joue comme seule et peut inviter à nouveau.
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.