🏗️ Arquitectura PS 9 vs PS 8 — Guia de diferencias

use PrestaShop\PrestaShop\Core\Domain\Product\Query\GetProductForEditing;
use PrestaShop\PrestaShop\Core\Domain\Product\QueryResult\ProductForEditing;

// Query — lectura
$query = new GetProductForEditing($productId);
/** @var ProductForEditing $result */
$result = $this->commandBus->handle($query);

$name = $result->getBasicInformation()->getLocalizedNames();

use PrestaShop\PrestaShop\Core\Domain\Product\Command\UpdateProductCommand;

// Command — escritura
$command = new UpdateProductCommand($productId);
$command->setLocalizedNames([
    1 => 'Mi Producto Actualizado',
    2 => 'My Updated Product',
]);
$command->setPrice('29.99');

$this->commandBus->handle($command);

services:
    _defaults:
        autowire: true
        autoconfigure: true

    MyModule\Controller\Admin\MyController:
        arguments:
            $commandBus: '@prestashop.core.command_bus'
            $queryBus: '@prestashop.core.query_bus'
            $translator: '@translator'
        tags:
            - { name: 'controller.service_arguments' }

    MyModule\Service\MyService:
        arguments:
            $configuration: '@prestashop.adapter.legacy.configuration'
            $entityManager: '@doctrine.orm.entity_manager'

class MyService
{
    public function getShopId(): int
    {
        return (int) Context::getContext()->shop->id; // ❌ Anti-pattern en PS 9
    }
}

class MyService
{
    public function __construct(
        private readonly ShopContext $shopContext,
    ) {}

    public function getShopId(): int
    {
        return $this->shopContext->getContextShopID(); // ✅
    }
}

// services.yml:
// MyModule\Service\MyService:
//     arguments:
//         $shopContext: '@prestashop.adapter.shop.context'

mi_modulo/
├── mi_modulo.php              # Clase principal (install, hooks)
├── composer.json              # Autoloading PSR-4
├── config/
│   ├── routes.yml             # Rutas Symfony para controllers admin
│   └── services.yml           # Servicios, DI, autowiring
├── src/
│   ├── Controller/
│   │   └── Admin/             # Controladores Symfony admin
│   ├── Entity/                # Doctrine ORM entities
│   ├── Repository/            # Doctrine repositories
│   ├── Form/
│   │   ├── Type/              # FormType classes
│   │   └── DataConfiguration/ # Data providers
│   ├── Grid/
│   │   ├── Definition/        # Grid definitions
│   │   └── Query/             # Grid query builders
│   ├── Command/               # Console commands
│   └── Service/               # Business logic
├── views/
│   ├── templates/
│   │   ├── admin/             # Twig templates (BO)
│   │   └── front/             # Smarty templates (FO)
│   ├── css/
│   └── js/
├── upgrade/                   # Upgrade scripts
└── tests/                     # PHPUnit tests

# Regenerar thumbnails
php bin/console prestashop:thumbnails:regenerate --all

# Reindexar busqueda
php bin/console prestashop:search:index

# Exportar traducciones de un modulo
php bin/console prestashop:module:export-translations mi_modulo

// Opcion 1: Via servicio (PS 9)
$featureFlagManager = $this->get('prestashop.core.feature_flag.manager');
if ($featureFlagManager->isEnabled('improved_shipment')) {
    // Funcionalidad de multi-shipment activa
}

// Opcion 2: Via SQL directo (compatible PS 8+9)
$isEnabled = (bool) Db::getInstance()->getValue(
    'SELECT state FROM ' . _DB_PREFIX_ . "feature_flag WHERE name = 'improved_shipment'"
);

// Detectar PS 9+
if (version_compare(_PS_VERSION_, '9.0.0', '>=')) {
    // PS 9 — usar arquitectura moderna
    // Constructor injection, CQRS, Twig admin
}

// Detectar PS 9.1+ (multi-shipment, discounts)
if (version_compare(_PS_VERSION_, '9.1.0', '>=')) {
    // PS 9.1 — nuevos hooks disponibles
    // Feature flags para shipment y discounts
}

// Detectar Hummingbird
$isHummingbird = (Context::getContext()->shop->theme_name === 'hummingbird');

// Patron hibrido PS 8 + PS 9
public function install()
{
    $hooks = [
        'displayHeader',
        'displayFooter',
        'actionValidateOrder',
    ];
    
    // Hooks solo PS 9.1+
    if (version_compare(_PS_VERSION_, '9.1.0', '>=')) {
        $hooks[] = 'actionModuleEnable';
        $hooks[] = 'actionModuleDisable';
        $hooks[] = 'actionConfigurationUpdateValueBefore';
    }
    
    return parent::install() && $this->registerHook($hooks);
}