Если на складе числится 10 единиц, а три уже обещаны покупателям, продавать можно семь. Когда витрина всё ещё показывает 10, проблема обычно не в формуле на странице, а в том, что резерв живёт отдельно от источника доступности или создаётся после чтения остатка без защиты от параллельного заказа.

Начните с одного SKU и выпишите три числа в один момент времени: on_hand — физически принято на склад, reserved — сумма активных резервов, available — то, что разрешено обещать новому клиенту. Полезный инвариант прост: available = on_hand - reserved, а reserved не включает отменённые, истёкшие и уже превращённые в отгрузку записи.

Сначала найдите место, где расходятся три числа

НаблюдениеВероятная причинаЧто проверить
Карточка товара показывает on_handAPI витрины читает складскую таблицу напрямуюПоле и запрос ответа каталога
Резерв есть, но не входит в суммуНеверный статус или складФильтр active, warehouse_id и срок действия
После отмены доступность не вернуласьРезерв не освобождён либо кеш не сброшенСобытие cancel и версия остатка
Остаток иногда становится отрицательнымПроверка и запись разнесены по транзакциямПараллельный тест последней единицы

Не исправляйте расхождение периодическим пересчётом раз в час. Он может вернуть красивое число после инцидента, но до запуска клиенты успеют оформить лишние заказы. Сначала сделайте создание резерва корректным, затем добавьте сверку как сигнал о нарушенном инварианте.

Последняя единица выдаётся одной транзакцией

BEGIN;
SELECT on_hand FROM stock WHERE sku = :sku AND warehouse_id = :warehouse FOR UPDATE;
SELECT COALESCE(SUM(qty), 0) FROM reservations
  WHERE sku = :sku AND warehouse_id = :warehouse AND state = "active" AND expires_at > NOW();
if (on_hand - reserved < requested) ROLLBACK;
INSERT INTO reservations(order_id, sku, qty, state, expires_at, idempotency_key)
  VALUES (:order, :sku, :qty, "active", :expires, :key);
COMMIT;

Блокировка строки FOR UPDATE заставляет конкурирующие транзакции проверять состояние последовательно. Альтернатива — атомарный условный UPDATE счётчика доступности с проверкой затронутой строки. В обоих вариантах нельзя сначала прочитать available в приложении, затем спустя несколько запросов записать резерв: между этими действиями другой процесс увидит то же свободное количество.

Уникальный idempotency_key нужен не для красоты. Покупатель может дважды нажать кнопку, мобильное приложение — повторить запрос после таймаута, очередь — доставить событие повторно. Одинаковая операция должна вернуть уже созданный резерв, а не вычесть товар ещё раз.

Статусы резерва описывают бизнес-переходы

  • active уменьшает available и имеет понятный срок действия.
  • allocated означает, что товар закреплён за подтверждённым заказом и не должен освобождаться TTL-задачей.
  • released возвращает количество в доступность после отмены или отказа оплаты.
  • expired ставится только активному резерву, срок которого действительно прошёл.
  • shipped переносит движение в фактический расход on_hand без повторного уменьшения available.

Переходы должны быть условными: UPDATE ... WHERE state = active. Тогда одновременно пришедшие отмена и оплата не выполнят две несовместимые операции. Сохраняйте время, причину и идентификатор команды — журнал помогает разобрать спорный заказ без ручного изменения количества.

TTL освобождает обещание, но не гадает о платеже

Срок резерва выбирают по реальному пути оплаты и сборки, а не по удобному круглому числу. Фоновая задача берёт только active с expires_at в прошлом, меняет их небольшими пакетами и публикует событие об изменении доступности. Если платёж может подтвердиться поздно, обработчик сначала атомарно переводит резерв в allocated; истёкший резерв не должен оживать молча.

Кеш получает версию, а не случайное число

Даже правильная база не поможет, если карточка товара часами держит старый available. После commit отправьте событие с SKU, складом и монотонной версией записи. Потребитель применяет только более новую версию. Так запоздавшее сообщение об освобождении не перетрёт последующее резервирование.

Контрольный прогон доказывает защиту от гонки

  1. Установить on_hand = 1 и убедиться, что активных резервов нет.
  2. Одновременно отправить два запроса с разными order_id на одну единицу.
  3. Подтвердить один active reserve и один понятный отказ, а не два успеха.
  4. Повторить успешный запрос с тем же idempotency_key и не создать вторую строку.
  5. Отменить заказ, проверить available и публичный API после обновления кеша.
  6. Повторить сценарий с истечением TTL и поздним callback оплаты.

Для точечной диагностики достаточно SKU, склада, on_hand, списка активных резервов, двух correlation ID и временной шкалы переходов. Не выгружайте всю базу заказов. Один воспроизводимый конфликт обычно показывает, где нарушена атомарность или где витрина читает не тот показатель.

Проверенные источники