Aller au contenu

Vie privée et classement

tilttek/rating

Une cote compare un membre à d'autres, et une comparaison publique met de la pression sur lui. La bibliothèque garde donc chaque cote privée par défaut : le membre voit la sienne ; personne d'autre ne la voit tant que le membre ne choisit pas autrement.

Publier

$ratings->publish('chess', 'member-1042');   // the member's rating of chess appears in the standings
$ratings->hide('chess', 'member-1042');      // and leaves them

La visibilité se choisit jeu par jeu, et par le membre seul : l'application appelle publish() à partir de l'action du membre lui-même, jamais en son nom. Un membre peut publier avant sa première partie cotée ; sa cote apparaît alors quand il en joue une.

Le classement

$ratings->standings('chess', limit: 100);    // list<MemberRating>, 1 to 1 000

Le classement liste les cotes publiques des membres qui ont au moins une partie cotée, le score le plus haut d'abord — la cote Elo, ou l'estimation prudente d'une habileté —, puis par membre. Une cote privée n'y figure jamais, pas plus que le nombre des membres qui gardent la leur privée.

Les cotes provisoires

Une cote après quelques parties en dit peu : une victoire chanceuse placerait un membre en tête. isProvisional($rating) est vrai tant que le membre a joué moins de parties cotées du jeu que n'en demande provisionalGames, 10 par défaut (Ratings::PROVISIONAL_GAMES), ou tant que le système juge la cote incertaine : une habileté OpenSkill dont l'écart est au-dessus de provisionalSigma, quand il est réglé. Elo n'a pas de mesure propre : ses cotes ne sont provisoires que par leurs parties ; provisionalGames: 0 laisse les parties de côté.

$chess = new Ratings($store, new EloSystem(), provisionalGames: 20);
$chess->isProvisional($chess->rating('chess', 'member-1042'));   // shown as "1 512?"
$chess->standings('chess', 100, provisional: false);             // the provisional ratings left out

Une page marque une cote provisoire à côté de son score, par un point d'interrogation. standings() les liste par défaut ; avec provisional: false, il les omet et donne tout de même jusqu'à $limit membres, en lisant plus bas dans le classement quand le système en omet, jusqu'à Ratings::MAX_STANDINGS cotes lues.

Montrer une cote

MemberRating::value() est le score à deux décimales ; $games, $peak et $lastResult disent combien de parties cotées, le score le plus haut atteint et le dernier résultat compté. Montrez une cote privée à son membre seul, et un changement — le RatingChange de record() — sur la page du membre lui-même. Une partie amicale, jouée hors des cotes, est là pour les membres qui ne veulent pas être cotés du tout.

Export et effacement

$ratings->export('member-1042');   // every rating of the member, whatever the game
$ratings->forget('member-1042');   // erased

forget() efface les cotes du membre ; les résultats restent dans leur source, dont l'effacement du membre appartient à la source elle-même. Une relecture après coup cote de nouveau le membre seulement si la source le nomme encore.