Repository navigation
feat(inventory): variant key for SKU-level stock accounting (#1001) - #1003
Ibochkarev wants to merge 3 commits into
Conversation
…#1001) - InventoryKey normalizes variantKey ('' -> null), adds identity()/isVariant(). - OrderInventoryCoordinator groups order lines by (product_id, variantKey) resolved via msOnInventoryResolveKey (orderProduct, product_id, options, order => returnedValues['variantKey']). Without addons all keys are product-level, behaviour unchanged. - InventoryStockStoreInterface stock methods take InventoryKey, ledger methods are keyed by InventoryKey (variant_key column, '' = product). - PdoInventoryStockStore keeps product stock for core keys and tolerates installs without the migration (falls back to pre-variant queries). - ProductStockInventory: variant stock comes from msOnInventoryAvailable, core ms3_products.stock is not decremented for SKU sales; addons sync their tables on reserve/commit/release events. - Migration adds variant_key NOT NULL DEFAULT '' and unique (order_id, product_id, variant_key). '' keeps the unique index meaningful (MySQL UNIQUE allows duplicate NULLs). - InMemory store + test doubles updated; new InventoryVariantKeyTest.
|
Возвращаю, два дефекта. Остальное проверил — сделано добротно. 1.
|
Исправления по ревью1. down() восстанавливает индекс order_productПосле удаления 2. Ограничение длины variantKeyВ конструкторе if ($variantKey !== '' && strlen($variantKey) > 128) {
$variantKey = hash('xxh128', $variantKey);
}3. Логирование ошибок события
$this->modx->log(
MODXRevolutionmodX::LOG_LEVEL_WARN,
'[ms3] msOnInventoryResolveKey failed: ' . $e->getMessage()
);4. Документация
Проверки:
Коммит: |
Описание
Точка расширения для остатков на уровне SKU без изменения поведения ядра по умолчанию (#1001).
InventoryKey: нормализацияvariantKey(''→ null),identity()для группировки.OrderInventoryCoordinator: группирует строки заказа по(product_id, variantKey). Вариант задаёт дополнение событиемmsOnInventoryResolveKey(params:orderProduct,product_id,options,order; результат:returnedValues['variantKey']). Без подписчиков — product-level, как раньше.InventoryStockStoreInterface: stock-методы принимаютInventoryKey, журнал — по ключу (variant_key,''= product). PDO-стор выдерживает установки без миграции.ProductStockInventory: для variant-ключей товарныйms3_products.stockне трогается; остаток запрашивается черезmsOnInventoryAvailable, дополнение синкается через reserve/commit/release события.variant_key VARCHAR(128) NOT NULL DEFAULT '', уникальный(order_id, product_id, variant_key).Без дополнений поведение и схема не меняются, кроме новой колонки. Замена
ms3_inventory(ERP) получаетvariantKeyв том жеInventoryKey— интерфейс сервиса не меняется.Тип изменений
Связанные Issues
Closes #1001
Как это было протестировано?
InventoryVariantKeyTest(ключ, in-memory журнал, variant reserve без товарного остатка) + существующие инвентарные тесты — 821 тестов OK.project.test: миграция применилась (variant_key+order_product_variantunique), healthcheck зелёный.Конфигурация: MiniShop3:
origin/beta(7d53553) + этот PR, MODX 3.x, PHP 8.2+