Если пользователь видит только сообщение «лимит исчерпан», добавьте не ещё один клиентский счётчик, а серверный снимок квоты. В ответе должны быть общий лимит, подтверждённый расход, временно зарезервированный объём, доступный остаток, момент следующего сброса и время расчёта. Тот же сервис обязан принимать решение «разрешить или отказать», иначе экран и реальное ограничение неизбежно разойдутся.
Практичная формула выглядит просто: `remaining = max(0, limit - used - reserved)`. Сложность находится не в арифметике, а в происхождении каждого слагаемого. Лимит приходит из действующего тарифа или выданного права, расход — из неизменяемых проводок, резерв — из незавершённых операций. Не вычитайте число запросов из аналитического отчёта: он может обновляться позже и не подходит для решения в момент запроса.
Сначала договоритесь, что именно считается единицей
«1000 в месяц» недостаточно для реализации. Запишите ресурс, единицу, период, часовую зону, правило округления и события, которые расходуют или возвращают квоту. Например, экспорт может списывать одну операцию при постановке в очередь или количество реально сформированных строк после завершения. Оба варианта допустимы, но интерфейс, API и поддержка должны использовать один и тот же контракт.
| Поле snapshot | Зачем оно пользователю | Откуда берётся |
|---|---|---|
| limit | понимать объём права | тариф, entitlement или ручной grant |
| used | видеть подтверждённый расход | сумма завершённых проводок ledger |
| reserved | объяснить временно занятый объём | активные операции с истекающим резервом |
| remaining | знать доступный объём сейчас | единая серверная формула |
| reset_at | понимать начало нового периода | границы периода аккаунта |
| as_of | оценить свежесть цифры | время построения snapshot |
Ledger хранит причину каждого изменения
Вместо перезаписи поля `used=417` сохраняйте проводки с типом, величиной, ресурсом, периодом, account ID и уникальным operation ID. Тогда поддержка может ответить, почему остаток изменился, а пересчёт восстанавливается из событий. Корректировки записываются отдельной обратной проводкой: история не исчезает и не превращается в необъяснимое число.
quota_snapshot={
"resource": "exports",
"period": "2026-10",
"limit": 1000,
"used": 412,
"reserved": 25,
"remaining": 563,
"reset_at": "2026-11-01T00:00:00+03:00",
"as_of": "2026-10-07T21:11:24+03:00"
}- Operation ID защищает от двойного списания при повторе HTTP-запроса или задачи очереди.
- Reservation ID связывает временное удержание с подтверждением либо освобождением.
- Период хранится явно: смена тарифа посреди месяца не переписывает прошлые проводки.
- Ручная компенсация содержит автора, причину и ссылку на инцидент.
Параллельные запросы проходят через одну атомарную границу
Два воркера не должны одновременно прочитать остаток 1 и оба списать по единице. В PostgreSQL строку агрегата можно заблокировать `SELECT ... FOR UPDATE` до конца транзакции либо выполнить условный `UPDATE`, который изменяет запись только при достаточном остатке. Важно проверять число затронутых строк и создавать проводку в той же транзакции.
BEGIN;
SELECT limit_value, used_value, reserved_value
FROM quota_balance
WHERE account_id = :account AND resource = :resource AND period_key = :period
FOR UPDATE;
-- проверить remaining >= :amount
INSERT INTO quota_ledger(operation_id, kind, amount) VALUES (:op, 'consume', :amount);
UPDATE quota_balance SET used_value = used_value + :amount WHERE ...;
COMMIT;Уникальный индекс на `operation_id` делает повтор безопасным: сервер возвращает результат первой операции, а не расходует квоту снова. Держите транзакцию короткой; внешний API, генерация файла и отправка письма выполняются после резерва, а не под блокировкой строки.
Кэш сообщает возраст данных, а не притворяется источником истины
Snapshot для кабинета можно кэшировать, но ответ на расходование строится из транзакционного хранилища. После успешного consume инвалидируйте ключ или обновляйте его по версии баланса. Если интерфейс показывает кэшированную цифру, поле `as_of` позволяет честно объяснить короткую задержку; при отказе сервер возвращает свежий authoritative snapshot вместе с машинным кодом `quota_exceeded`.
Не обещайте абсолютную неизменность остатка между показом экрана и нажатием кнопки: другой процесс может израсходовать квоту. Интерфейс должен воспринимать значение как снимок, а окончательное решение — как результат операции. Для длинных задач резервируйте объём с TTL и освобождайте его при отмене или технической ошибке.
Проверка гонки важнее красивого прогресс-бара
- Создайте аккаунт с остатком 10 и запустите двадцать параллельных списаний по единице с разными operation ID.
- Убедитесь, что успех получили ровно десять операций, а остаток не стал отрицательным.
- Повторите все успешные запросы с теми же operation ID: used не должен измениться.
- Искусственно оборвите задачу после резерва и проверьте освобождение по TTL или явному rollback-событию.
- Сравните quota endpoint, кабинет и решение enforcement сразу после теста и после обновления кэша.
Исправление готово, когда пользователь видит состав остатка и время его расчёта, поддержка восстанавливает каждое изменение по ledger, а нагрузочный тест не допускает перерасхода. Такой счётчик остаётся объяснимым даже при смене тарифа, возврате операции и нескольких одновременно работающих клиентах.