Extension de Sylius avec StoryBDD: Amélioration de la gestion des stocks de produits

Cet article détaille l'ajout de suivi des stocks à Sylius, en se concentrant sur les tests StoryBDD avec Behat. Nous avons précédemment ajouté des fonctionnalités backend; Maintenant, nous les intégrons dans l'interface utilisateur.

Notre objectif: Afficher une nouvelle colonne "Inventaire" dans la liste de produits, montrant le stock total de toutes les variantes suivis.

Concepts clés:

• StoryBDD (développement axé sur le comportement): en utilisant Behat pour tester les histoires d'utilisateurs, assurer une implémentation précise de fonctionnalités telles que la gestion des stocks.
• Contextes de Behat personnalisés: Création et configuration de classes de contexte personnalisées au sein de Sylius pour gérer des scénarios de test spécifiques.
• Intégration de la base de données: Adommagent les mises à jour du schéma de base de données et les erreurs de connexion potentielles.
• Mises à jour de l'interface utilisateur: Modifier les grilles et les modèles pour afficher correctement les données d'inventaire dans le panneau d'administration de Sylius.

Implémentation de tests StoryBDD avec Behat:

Nous créons un fichier de fonctionnalités (features/product/managing_products/browsing_products_with_inventory.feature):

@managing_inventory
Feature: Browsing products with inventory
    In order to manage my shop merchandise
    As an Administrator
    I want to be able to browse products

    Background:
        Given the store operates on a single channel in "United States"
        And the store has a product "Kubus"
        And it comes in the following variations:
            | name          | price     |
            | Kubus Banana  | .00     |
            | Kubus Carrot  | .00     |
        And there are 3 units of "Kubus Banana" variant of product "Kubus" available in the inventory
        And there are 5 units of "Kubus Carrot" variant of product "Kubus" available in the inventory
        And I am logged in as an administrator

    @ui
    Scenario: Browsing defined products with inventory
        Given the "Kubus Banana" product variant is tracked by the inventory
        And the "Kubus Carrot" product variant is tracked by the inventory
        When I want to browse products
        Then I should see that the product "Kubus" has 8 on hand quantity

L'exécution cela révèle les étapes manquantes. Nous créons un contexte personnalisé (src/Sylius/Behat/Context/Ui/Admin/ManagingProductsInventoryContext.php):

<?php
// ... (imports) ...

class ManagingProductsInventoryContext implements Context
{
    // ... (IndexPageInterface injection and methods) ...
}

Nous configurons ce contexte dans src/Sylius/Behat/Resources/config/services/contexts/ui.xml et src/Sylius/Behat/Resources/config/suites/ui/inventory/managing_inventory.yml. La configuration de la base de données (doctrine:database:create, doctrine:schema:create, doctrine:schema:update) peut être nécessaire.

La mise en ?uvre des étapes manquantes consiste à utiliser IndexPageInterface de Sylius pour interagir avec la liste de produits et les assertions pour vérifier la présence et les données de la colonne d'inventaire. Nous devons également mettre à jour la configuration de la grille Sylius (app/Resources/SyliusAdminBundle/config/grids/product.yml) pour ajouter la colonne "Inventaire" et créer un modèle personnalisé (app/Resources/SyliusAdminBundle/views/ProductVariant/Grid/Field/inventory.html.twig) pour afficher les informations d'inventaire avec des indicateurs codés en couleur (vert pour un stock suffisant, jaune pour faible stock, rouge pour le stock).

Enfin, nous étendons la forme de variante de produit pour permettre la modification des niveaux de réorganisation. Cela implique la création d'une extension de formulaire (src/AppBundle/Form/Type/Extension/ProductVariantTypeExtension.php), la configurer en tant que service (src/AppBundle/Resources/config/services.yml) et la mise à jour du modèle pertinent (app/Resources/SyliusAdminBundle/views/ProductVariant/Tab/_details.html.twig).

Conclusion:

Ce processus démontre une approche robuste pour étendre Sylius tout en maintenant une couverture de test élevée. L'utilisation de contextes StoryBDD et de Behat personnalisés garantit que les nouvelles fonctionnalités sont soigneusement testées et intégrées de manière transparente dans la plate-forme existante. N'oubliez pas d'effacer les caches après avoir apporté des modifications aux fichiers de configuration.

(Section des questions fréquemment posées omises pour la concision, car elle n'est largement pas liée au code de base et aux modifications décrites.)

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!