Унификация расчёта стоимости заказа: checkout ↔ manager

[Ibochkarev]

Описание

Общий слой формул стоимости заказа для витрины и менеджера вместо дублирования в OrderCostCalculator, ManagerOrderCostRecalculator, Delivery и Payment.

• OrderCostEngine — delivery (weight, free threshold, price/%), payment surcharge, paymentCommissionBase() делегирует в OrderService::paymentCommissionBase() (cart-only, fix(order): единая база для процентной комиссии оплаты (cart-only) #460), composeBreakdown() через OrderService::clampComputedTotal
• Web adapter (OrderCostCalculator) — MODX cost events; payment fee от cart-only; getTotalCost передаёт уже посчитанный cart в getPaymentCost (один проход pipeline)
• Manager adapter (ManagerOrderCostRecalculator) — modes/warnings/log; default handlers делегируют в engine
• DI: ms3_manager_order_cost_recalculator в ServiceRegistry, OrdersController берёт сервис из контейнера

Closes #366

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

• Исправление бага (non-breaking change)
• Новая функциональность (non-breaking change)
• Breaking change (изменение, ломающее обратную совместимость)
• Рефакторинг (без изменения функциональности)
• Документация
• Другое (опишите):

Поведение storefront: %-комиссия оплаты — cart-only (MS2-паритет, #460). Rebase на beta после #460. Округление/clamp без изменений.

Связанные Issues

Closes #366
Refs #372, #373, #338, #363, #361, #460

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

cd core/components/minishop3
composer ci:php   # exit 0 — php -l + 37 smoke + 109 PHPUnit
composer stan     # exit 0

OrderCostEngineTest.php: cart-only commission base, delivery free-threshold/percent edge cases, wiring grep, single-pass getTotalCost.
PaymentCommissionBaseTest.php: cart-only guards (#460).

• Ручное тестирование
• Автоматические тесты (composer ci:php, composer stan)
• Тестирование на разных версиях PHP/MODX

Чеклист

• Код соответствует стилю проекта
• Комментарии в class docblocks (web vs mgr events)
• Изменения согласованы между checkout и manager для default handlers
• Лексиконы — не требуется
• CHANGELOG — при релизе

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

Events (документировано в docblocks):

• Web: msOnBefore/GetCartCost, DeliveryCost, PaymentCost, OrderCost
• Manager recalc: событий cost нет; mgr-only modes (auto / manual / force_provider) и warnings

Deferred: OrderFinalizeService payment fee (#373) — отдельный issue; полный runtime integration smoke с mock modX.

[biz87]

Обновление по базе процентной комиссии оплаты (после разбора #372 на живом примере).

Принято решение: база комиссии оплаты — cart-only (MS2-паритет), НЕ cart + delivery.

Почему (на примере: корзина 10 000, доставка +2 000, оплата +4 %):

• «сейчас» витрина считает % от корзины (400), менеджер «Пересчитать» — от корзины+доставки (480), а finalize вообще сохраняет заказ с комиссией 0 → три разных итога за один заказ (12 400 / 12 000 / 12 480);
• cart-only даёт одинаковый итог на всех этапах (checkout = запись в БД = пересчёт менеджера) и не даёт скидке/промо на доставку «протекать» в банковскую комиссию (кейс с отрицательной доставкой это обнажает).

Зафиксировано в #460 (уже merged в beta): OrderService::paymentCommissionBase($cartCost) = cart-only; OrderCostCalculator (storefront) и ManagerOrderCostRecalculator приведены к нему.

Про этот PR (#476). Архитектурно он нам нужен — OrderCostEngine убирает дублирование формул в 4 местах (OrderCostCalculator / ManagerOrderCostRecalculator / Delivery / Payment), это хотим сохранить и влить как канонический унификатор. Но сейчас движок «зашит» на базу cart + delivery, что теперь противоречит beta (#460) и сдвинет клиентскую цену на витрине.

Просьба:

1. Свести OrderCostEngine на базу комиссии cart-only — переиспользовать OrderService::paymentCommissionBase() из fix(order): единая база для процентной комиссии оплаты (cart-only) #460 вместо cart + delivery.
2. Ребейз на текущий beta (там уже fix(order): единая база для процентной комиссии оплаты (cart-only) #460 + весь auth-кластер).
3. После этого Унификация расчёта стоимости заказа: checkout ↔ manager #476 можно влить как канон, заменив точечные правки (fix(order): единая база для процентной комиссии оплаты (cart-only) #460 — по базе, fix(order): align finalize cost with ManagerOrderCostRecalculator #448 — finalize уже подтянется через делегирование).
4. Прогнать composer stan + composer ci:php после ребейза.

Мы не закрываем #476 — откладываем до сведения на cart-only. Спасибо!

[Ibochkarev]

@biz87 готово по комментарию:

• Rebase на актуальный beta (fix(order): единая база для процентной комиссии оплаты (cart-only) #460 + auth-кластер)
• OrderCostEngine::paymentCommissionBase($cartCost) → OrderService::paymentCommissionBase() (cart-only, MS2-паритет)
• Адаптеры checkout/manager и тесты приведены к cart-only
• composer ci:php и composer stan — exit 0

Описание PR обновлено. Можно смотреть повторно.