Квота остаётся занятой, когда операция и счётчик меняют состояние независимо. Исправление начинается с определения момента расхода: запрос только резервирует единицу, успешное выполнение потребляет её, а отмена до выполнения снимает резерв. Отмена уже оказанной услуги не всегда означает возврат — это отдельное правило тарифа.
Возьмите один operation_id и выпишите его историю по времени. Если в таблице есть только used = used + 1, система не может объяснить, за что списана единица и допустима ли компенсация.
Статус определяет допустимое движение
| Переход | Движение квоты | Повтор события |
|---|---|---|
| created → queued | reserve +1 | Не создаёт второй reserve |
| queued → completed | reserve -1, consumed +1 | Возвращает прежний результат |
| queued → cancelled | reserve -1, release reason | Не меняет остаток повторно |
| completed → refunded | По политике тарифа | Одна компенсация на исходное consume |
| failed before start | reserve -1 | Идемпотентный release |
| timeout unknown | Состояние pending_reconcile | Не списывать и не возвращать вслепую |
Журнал хранит причину каждого изменения
quota_ledger(
account_id, period_id, operation_id,
event_id UNIQUE, movement, amount, created_at
)
available = granted - reserved - consumed + compensated
cancel(event_id) inserts release only if active reserve existsevent_id приходит из бизнес-события или строится детерминированно из operation_id и типа перехода. Уникальное ограничение не даёт обработать один webhook дважды. PostgreSQL ON CONFLICT позволяет вернуть уже существующий результат, но бизнес-проверка активного резерва всё равно выполняется внутри транзакции.
Агрегат обновляется рядом с журналом
Если интерфейсу нужен быстрый остаток, храните агрегат периода, но изменяйте его в той же транзакции, что ledger row. Заблокируйте строку account + period или используйте serializable transaction с повтором serialization failure. Два параллельных заказа не должны оба увидеть последнюю свободную единицу.
Отмена после границы периода не переписывает прошлое
- Операция хранит period_id, в котором был создан расход.
- Release резерва относится к тому же периоду, если выполнение не состоялось.
- Компенсация потреблённой операции следует правилам тарифа и может зачисляться в текущий период.
- Закрытый расчётный период не редактируется без audit-события.
- Смена тарифа не меняет уже записанные движения задним числом.
Так исчезает спорная логика «вернуть used--»: у движения есть период, причина и связь с исходной записью. Пользовательский интерфейс может показать, почему остаток изменился, не раскрывая внутренние идентификаторы.
Неопределённый результат идёт на сверку
После сетевого timeout операция могла завершиться во внешней системе. Не отправляйте release немедленно. Пометьте её pending_reconcile, запросите статус по idempotency key и только затем выберите consume или release. Фоновая сверка должна быть повторяемой и иметь дедлайн ручного разбора.
Пересчёт ловит старые расхождения
Периодическая задача считает aggregate из ledger и сравнивает с сохранённой строкой. Она не исправляет данные молча: сначала создаёт отчёт с account hash, period и delta, затем применяет подтверждённое компенсирующее движение. История остаётся воспроизводимой.
Набор тестов начинается с повторной отмены
- Зарезервировать последнюю единицу и заблокировать параллельную операцию.
- Отменить queued-операцию и вернуть ровно один reserve.
- Дважды доставить cancel event и не увеличить доступный остаток второй раз.
- Отменить completed-операцию по двум разным политикам тарифа.
- Получить timeout, выполнить reconciliation и выбрать единственное итоговое движение.
- Пересчитать период из ledger и получить delta=0.
Для диагностики подготовьте определения reserve и consume, схему периодов, обезличенную историю одной операции, idempotency keys и формулу агрегата. Данные оплаты и реальные account IDs для такого разбора не нужны.