IBX-8198: PIM training

code_samples/trainings/commerce/pim/001_product_modeling/config/packages/ibexa_product_catalog.yaml

@@ -0,0 +1,8 @@
+ibexa_product_catalog:
+    engines:
+        default:
+            type: local
+            options:
+                root_location_remote_id: ibexa_product_catalog_root
+                product_type_group_identifier: 'product'
+                variant_code_generator_strategy: 'per_product_type_code_generator'

code_samples/trainings/commerce/pim/001_product_modeling/config/services.yaml

@@ -0,0 +1,14 @@
+services:
+    # …
+
+    App\CodeGenerator\Strategy\ProductTypeCodeGeneratorDispatcher:
+        arguments:
+            $defaultCodeGeneratorIdentifier: 'incremental'
+            $productTypeCodeGeneratorMap:
+                bike: 'bike'
+        tags:
+            - { name: 'ibexa.product_catalog.code_generator', type: 'per_product_type_code_generator' }
+
+    App\CodeGenerator\Strategy\BikeCodeGenerator:
+        tags:
+            - { name: 'ibexa.product_catalog.code_generator', type: 'bike' }

code_samples/trainings/commerce/pim/001_product_modeling/src/CodeGenerator/Strategy/BikeCodeGenerator.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\CodeGenerator\Strategy;
+
+use Ibexa\Contracts\Core\Exception\InvalidArgumentException;
+use Ibexa\Contracts\ProductCatalog\Local\CodeGenerator\CodeGeneratorContext;
+use Ibexa\Contracts\ProductCatalog\Local\CodeGenerator\CodeGeneratorInterface;
+
+final class BikeCodeGenerator implements CodeGeneratorInterface
+{
+    public function generateCode(CodeGeneratorContext $context): string
+    {
+        if (!$context->hasBaseProduct()) {
+            throw new InvalidArgumentException('$context', 'missing base product');
+        }
+
+        $frameSize = $context->getAttributes()['frame_size'];
+        $wheelSize = $context->getAttributes()['wheel_diameter'];
+        $frameShape = $context->getAttributes()['frame_shape'][0];
+        $gearBundle = $context->getAttributes()['gear_bundle'];
+
+        return $context->getBaseProduct()->getCode() . "--$frameSize-$wheelSize-$frameShape-$gearBundle";
+    }
+}

code_samples/trainings/commerce/pim/001_product_modeling/src/CodeGenerator/Strategy/ProductTypeCodeGeneratorDispatcher.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\CodeGenerator\Strategy;
+
+use Ibexa\Contracts\Core\Exception\InvalidArgumentException;
+use Ibexa\Contracts\ProductCatalog\Local\CodeGenerator\CodeGeneratorContext;
+use Ibexa\Contracts\ProductCatalog\Local\CodeGenerator\CodeGeneratorInterface;
+use Ibexa\ProductCatalog\Local\Repository\CodeGenerator\CodeGeneratorRegistryInterface;
+
+final class ProductTypeCodeGeneratorDispatcher implements CodeGeneratorInterface
+{
+    private CodeGeneratorRegistryInterface $codeGeneratorRegistry;
+
+    private string $defaultCodeGeneratorIdentifier;
+
+    private array $productTypeCodeGeneratorMap;
+
+    public function __construct(CodeGeneratorRegistryInterface $codeGeneratorRegistry, string $defaultCodeGeneratorIdentifier = 'incremental', array $productTypeCodeGeneratorMap = [])
+    {
+        $this->codeGeneratorRegistry = $codeGeneratorRegistry;
+        $this->defaultCodeGeneratorIdentifier = $defaultCodeGeneratorIdentifier;
+        $this->productTypeCodeGeneratorMap = $productTypeCodeGeneratorMap;
+    }
+
+    public function generateCode(CodeGeneratorContext $context): string
+    {
+        if (!$context->hasBaseProduct()) {
+            throw new InvalidArgumentException('$context', 'missing base product');
+        }
+
+        $productTypeIdentifier = $context->getBaseProduct()->getProductType()->getIdentifier();
+        $codeGeneratorIdentifier = array_key_exists($productTypeIdentifier, $this->productTypeCodeGeneratorMap) ? $this->productTypeCodeGeneratorMap[$productTypeIdentifier] : $this->defaultCodeGeneratorIdentifier;
+
+        if ($this->codeGeneratorRegistry->hasCodeGenerator($codeGeneratorIdentifier)) {
+            return $this->codeGeneratorRegistry->getCodeGenerator($codeGeneratorIdentifier)->generateCode($context);
+        } else {
+            throw new InvalidArgumentException('$productTypeCodeGeneratorMap', "no code generator '$codeGeneratorIdentifier' registered");
+        }
+    }
+}

docs/trainings/commerce/pim/000_syllabus.md

@@ -0,0 +1,51 @@
+---
+description: PIM training
+page_type: training
+---
+
+# PIM (Product Information Management)
+
+## Syllabus
+
+In this training, you learn how to create complex products locally, and to organize them.
+
+| Section                                     | Estimated | Description                                               |
+|:--------------------------------------------|----------:|:----------------------------------------------------------|
+| [Product modeling](011_product_modeling.md) | X minutes | Learn about product types, products and product variants. |
+| [Product shelving](012_product_shelving.md) | Y minutes | Organize your products with categories and catalogs.      |
+| [Product exchange](021_product_exchange.md) | Z minutes | Explore REST API, PHP API, and migrations.                |
+
+## Requirements
+
+### Previous knowledge
+
+- [Content management](content_management.md)
+    - [Content types](content_types.md) and [content items](content_model.md#content-items)
+    - [Taxonomy](taxonomy.md)
+- [Templating](templating.md)
+
+### Ibexa DXP edition
+
+[[= product_name_headless =]] is the minimal edition required for this training.
+
+- [[= product_name_headless =]] [[= latest_tag_4_6 =]]
+- [[= product_name_exp =]] [[= latest_tag_4_6 =]]
+- [[= product_name_com =]] [[= latest_tag_4_6 =]]
+
+TODO: Make sure that everything used is in Ibexa DXP Headless scope, so to speak, ibexa/product-catalog. It mustn't use features from ibexa/storefront.
+
+### Cluster elements
+
+This training can be run on the minimal stack.
+
+|       Service | Required | Value        |
+|--------------:|:--------:|:-------------|
+| Search engine |    No    | (Legacy)     |
+|    Cache pool |    No    | (Filesystem) |
+|    HTTP cache |    No    |              |
+
+### Starting state
+
+To follow this training, you must install code, configuration, and data on top of a fresh installation.
+
+TODO: Experience clean install, or previous bike ride design and content?