Aller au contenu

Stockage

tilttek/rating

Contract\RatingStore garde un MemberRating par membre et par jeu :

MéthodeFait
find($game, $members)Les cotes de ces membres pour le jeu, par membre ; un membre sans cote est omis
hasRecorded($game, $result)Si le jeu compte déjà le résultat
save($ratings, $result, $events)Garde les cotes d'un coup, chacune à sa version suivante, et compte le résultat pour leur jeu avec ses événements à remettre ; ResultAlreadyRecorded quand il est déjà compté, RatingConflict quand une cote a changé depuis sa lecture
undelivered($game, $result)Les événements du résultat pas encore remis, dans l'ordre
markDelivered($game, $result, ...$keys)Oublie les événements de ces clés, envoyés sans exception
standings($game, $limit, $minGames)Les cotes publiques qui ont au moins $minGames parties cotées, et une au moins, le score le plus haut d'abord, puis par membre
ofGame($game)Chaque cote du jeu
replace($game, $ratings, $results)Remplace d'un coup chaque cote du jeu, et les résultats qu'il compte : ce qu'une relecture a calculé ; les événements du jeu pas encore remis sont annulés
ofMember($member)Chaque cote du membre
forget($member)Efface chaque cote du membre, et les événements à son sujet pas encore remis

Une cote lue à la version 0 est nouvelle : le dépôt de stockage ne la garde que s'il n'en détient aucune pour ce membre et ce jeu. Toute autre n'est gardée que si le dépôt la détient à la version où elle a été lue. Deux résultats des mêmes membres enregistrés en même temps ne peuvent pas aboutir tous les deux : le second lance RatingConflict, rien n'en est gardé, et l'application l'enregistre de nouveau. Dans une base de données, la ligne d'une cote porte sa version, mise à jour avec WHERE version = ? dans une seule transaction pour tous les membres du résultat, avec une clé unique sur le jeu et le membre.

Les résultats qu'un jeu compte sont gardés à côté des cotes : dans une base de données, une table du jeu et de l'identifiant du résultat avec une clé unique sur les deux, écrite dans la même transaction que les cotes, pour qu'un second enregistrement du résultat échoue sur la clé et ne garde rien ; replace() vide les lignes du jeu et ses événements pas encore remis, et écrit celles de la relecture. Les identifiants sont des références opaques aux résultats, jamais un membre.

Les événements d'un résultat pas encore remis sont gardés dans la même transaction : dans une base de données, une table du jeu, du résultat, de la clé de l'événement, du membre et de son genre (changed ou peak), avec une clé unique sur le jeu, le résultat et la clé ; markDelivered() supprime ses lignes, et forget() celles du membre.

MemberRating::toArray() donne les valeurs simples à garder — la cote elle-même en nombres entiers, par nom — et MemberRating::fromArray($data, $system) les relit avec le système qui les a calculées, en refusant une cote d'un autre système. Le classement lit la colonne score, en centièmes, et la colonne visibility ; indexez-les par jeu.

Store\InMemoryRatingStore garde tout dans le processus, pour les tests et les scripts.