feat(core): add opt-in inventory reserve, commit and release

[Ibochkarev]

Описание

Поле stock было только для витрины и импорта. Корзина и оформление его не читали, списания не было, два покупателя могли взять последний экземпляр.

В Core появился контракт InventoryServiceInterface (DI ms3_inventory) и реализация на ms3_products.stock плюс журнал ms3_inventory_reservations. Учёт включается настройкой ms3_inventory_enabled (по умолчанию выключена). Тогда:

• до выдачи номера заказа проверяется доступность
• статус New (ms3_status_new) резервирует остаток атомарным UPDATE … WHERE stock >= qty в одной транзакции со сменой status_id
• Paid (ms3_status_paid) фиксирует резерв
• Canceled (ms3_status_canceled) до commit возвращает остаток
• неуспешный payment->send() (в том числе false вместо массива) переводит заказ в отмену, чтобы не оставлять New без холда
• ошибка после выдачи номера, но до New, снимает номер с черновика (при включённом учёте)
• ошибка msOnChangeOrderStatus после перехода в New отпускает резерв и откатывает status_id

Внешний склад подменяется через ms3_inventory. События msOnBeforeInventory* / msOnInventory* (Reserve, Commit, Release). release не восстанавливает stock, если резерв уже committed (обход OrderStatusService у кастомных провайдеров). Мультисклад, партии и ERP-sync в этот PR не входят.

Документация вызовов: setting_ms3_inventory_enabled_desc (ru/en) и phpdoc InventoryServiceInterface.

Тип изменений

• Новая функциональность (non-breaking change)

Связанные Issues

Closes #589

Как это было протестировано?

GitHub Actions на HEAD 0edad252 (run 32212167139):

cd core/components/minishop3
composer ci:php
# php -l 644 files, exit 0
# smoke 90, exit 0
# PHPUnit 274 tests, 706 assertions, exit 0 (CI с MySQL, @group mysql включён)

composer stan
# [OK] No errors, exit 0

cd ../../../vueManager
npm run lint:ci
# pass (файлы Vue этим PR не менялись)

• Автоматические тесты (composer ci:php, composer stan, npm run lint:ci в CI)
• Ручное тестирование checkout с ms3_inventory_enabled=1
• Тестирование на разных версиях PHP/MODX — CI PHP 8.2.33, локально PHP 8.4.17

Конфигурация тестирования:

• MiniShop3: ветка feat/issue-589-inventory-abstraction от beta (коммиты ec5b1bbd, 0edad252)
• MODX: не поднимался
• PHP: 8.2.33 (CI), 8.4.17 (локально)

Скриншоты (если применимо)

N/A, backend.

Чеклист

• Код соответствует стилю проекта
• Добавлены/обновлены комментарии в сложных местах
• Изменения не ломают существующую функциональность (default off)
• Лексиконы добавлены на двух языках (ru/en)
• PHPStan проходит без новых ошибок (composer stan)
• ESLint (npm run lint:ci) — CI pass, Vue не тронут
• CHANGELOG.md — не трогал, запись на релиз

Дополнительные заметки

Второй коммит закрыл разрывы ревью: send() === false больше не оставляет New с холдом, after-event на New отпускает сток, номер черновика снимается при фейле до New, ledger reserve/commit/release пишется в одной TX со сменой статуса, mysql-тест гонки идёт на двух соединениях, InMemoryInventoryStockStore лежит в tests/support/.

Номер заказа и reserve по-прежнему в разных транзакциях. Assert до номера, reserve в TX со сменой статуса на New. Второй checkout последнего qty может получить номер и упасть на reserve. Номер тогда снимается, дырявого hold нет.

[AgelxNash]

Этот PR включён в тестовую интеграционную сборку всех открытых PR MiniShop3: AgelxNash/MiniShop3, ветка integration/open-prs-20260906 (28/28 открытых).

Сборка нужна, чтобы проверить совместимость взаимозависимых серий PR до их мержа — при последовательном слиянии они конфликтуют друг с другом. Это не ревью и не конкурирующий PR: авторство сохранено (1 PR = 1 коммит с исходным автором), ветка пересобирается по мере обновления PR.

Как вошёл в сборку: Конфликт со слитым #596 (lifecycle gate) разрешён: фабрика ms3_order_status теперь принимает и lifecycle ports, и OrderInventoryCoordinator; карта зависимостей объединена (ms3_order_log, ms3_order_lifecycle_ports, ms3_inventory); persistStatusWithInventory() заменил inline-персист статуса; на провал msOnChangeOrderStatus вызываются undoUncommittedNewStatus() и rollbackStatus().

[AgelxNash]

Желаю скорейшего ревью и мержа! Красивый PR 👏