Aller au contenu

Installation

tilttek/loot-tables-bundle

Prérequis

PHP 8.5 ou plus récent avec l'extension sodium, Symfony 8.2 avec son composant Workflow, Doctrine ORM 3.7 et DoctrineBundle, phil/commerce-bundle, dont le bundle utilise le workflow de commande et les tireurs d'options, et tilttek/loot-tables. Les écrans et la fiche de production sont facultatifs : le bundle enregistre chacun quand ses paquets sont installés.

PaquetPour
symfony/form, symfony/options-resolverPhysicalDiceType, le formulaire des dés physiques
symfony/ux-twig-component, symfony/twig-bundleTilttekLootTables:Commitments, les tirages de l'acheteur, et TilttekLootTables:PhysicalDice, le formulaire sur la page de la caisse
phil/ux-kitLes recettes Card et Badge avec lesquelles les tirages de l'acheteur sont dessinés, par le Toolkit de Symfony UX
symfony/consoletilttek:loot-tables:replay, la commande qui relance un tirage
symfony/translationLes mots du formulaire et des composants, en anglais et en français
phil/paged-mediaLootSheetPdf, la fiche de production

Installer

composer require tilttek/loot-tables-bundle

La recette de recipe/0.1 enregistre le bundle et copie sa configuration ; tant qu'elle n'est pas publiée dans un dépôt de recettes, activez le bundle à la main après le noyau du commerce :

// config/bundles.php
return [
    // …
    Phil\CommerceBundle\PhilCommerceBundle::class => ['all' => true],
    Tilttek\LootTablesBundle\TilttekLootTablesBundle::class => ['all' => true],
];

et écrivez sa configuration, config/packages/tilttek_loot_tables.yaml, comme l'explique la configuration.

Pour les composants, enregistrez TwigComponentBundle, et installez les recettes du kit UX avec lesquelles les tirages de l'acheteur sont dessinés :

php bin/console ux:install card badge

La table des tirages

Le bundle associe son entité pour Doctrine quand DoctrineBundle est installé. Créez la table tilttek_loot_draw avec une migration :

php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrate
ColonneContient
id32 chiffres hexadécimaux dérivés de la commande, de la ligne, de l'option et de l'unité
order_number, line, option_code, unità quelle unité de quelle option correspond le tirage ; order_number est indexée
drawerle tireur que nomme l'option
seed, commitmentle germe secret, publié dans la preuve une fois révélé, et son SHA-256, montré avant le paiement ; null pour des dés physiques
textsles entrées parmi lesquelles un texte est tiré, telles qu'elles étaient à l'engagement
resultla source et les faces, une fois révélées ou saisies
proofla preuve publiée d'un tirage vérifiable
drawnce que garde la ligne de commande
created_at, revealed_atquand il a été engagé ou saisi, et révélé

Le germe d'un tirage pas encore révélé est un secret : quiconque le lit connaît le tirage avant le paiement. Gardez la table hors de portée de ce que voient les acheteurs, comme toute table du magasin.