Aller au contenu

tilttek/dice-tower

✅ publié

La tour de dés partagée d'une table : chaque jet est vu par tous les joueurs de la table, dans l'ordre, au fil de sa chute.

tilttek/dice-tower est un bundle Symfony construit sur tilttek/dice-bundle. Un jet du journal des dés est déposé dans la tour d'une table ; la tour garde où il est tombé, dans un journal à elle, et pousse la nouvelle entrée sur un sujet Mercure privé de la table, auquel seuls les spectateurs que l'application autorise s'abonnent. Un spectateur absent lit ce qu'il a manqué dans le journal, par position : rien n'est gardé en mémoire d'une requête à l'autre. Les entrées portent des identifiants et le résultat du jet, jamais le nom d'une personne. Une surcouche Twig et Stimulus, dessinée avec le kit PHIL UX, montre la tour et ajoute chaque nouveau jet ; des relais portent chaque entrée vers d'autres canaux, par des adaptateurs qui sont des paquets à part.

État

PartieÉtat
Le journal des tours, dans Doctrine ou en mémoire, ses positions données par la base de donnéesImplémenté et testé
DiceTower : jets déposés, entrées lues dans l'ordre, entrées manquées relues, effacement d'un lanceurImplémenté et testé
Le sujet privé de chaque table sur un hub Mercure, et l'autorisation de ses spectateursImplémenté et testé
La route des entrées manquées, pour les spectateurs autorisés seulementImplémenté et testé
dice_tower(), la surcouche dessinée avec le kit PHIL UX et son contrôleur Stimulus, en anglais et en françaisImplémenté et testé
Les relais, immédiats ou par un bus de messagesImplémenté et testé

Documentation

DocumentContenu
InstallationLes prérequis, l'enregistrement du bundle, la route, le hub et les recettes du kit.
ConfigurationChaque clé, sa valeur par défaut et ce qu'elle règle.
La tour en PHPLancer et déposer, lire les entrées, la charge utile, la vie privée et les processus de longue durée.
La surcouchedice_tower(), la surcouche, son contrôleur Stimulus et ses événements.
Points d'extensionQui peut regarder une table, les relais vers d'autres canaux, les éditeurs, les gabarits et les traductions.
TestsLes tests du bundle, et comment tester une application qui utilise une tour.
RéférenceChaque type et chaque service du bundle.

Démarrage rapide

composer require tilttek/dice-tower symfony/mercure-bundle
php bin/console ux:install card --kit=github.com/parler-haut-interagir-librement/ux-kit
// config/bundles.php
return [
    Tilttek\DiceBundle\TilttekDiceBundle::class => ['all' => true],
    Tilttek\DiceTower\TilttekDiceTowerBundle::class => ['all' => true],
];
# config/packages/tilttek_dice_tower.yaml
tilttek_dice_tower:
    table_access: App\Dice\TableMembers

# config/routes/tilttek_dice_tower.yaml
tilttek_dice_tower:
    resource: '@TilttekDiceTowerBundle/config/routes.php'
$tower->roll(ResourceReference::of('table', '7'), '1d20+5', ResourceReference::of('member', '42'));
{{ dice_tower('table:7', {'member:42': 'Aelis'}) }}

Prérequis

PHP 8.5 ou une version plus récente, Symfony 8.2, tilttek/dice-bundle, Doctrine ORM pour le journal et un hub Mercure pour les entrées en direct ; Twig, Symfony UX et les recettes du kit PHIL UX pour la surcouche.

Contribuer

Les contributions sont les bienvenues sur le monodépôt de PHIL : lisez le guide de contribution et le code de conduite, en anglais. Signalez une vulnérabilité en privé, comme l'explique la politique de sécurité, jamais dans un ticket public.

Licence

MIT, © Philippe Gamache, doing business as Le Gnome Archiviste; a Tilttek project. Voir LICENSE.