Если в корпоративном тарифе счёт показывает 27 мест, а администратор видит 24 сотрудника, не исправляйте число ручной поправкой. Сначала договоритесь, какое состояние членства действительно занимает оплачиваемый seat. Затем считайте его из одного реестра membership и сверяйте с quantity подписки. Таблица пользователей, список приглашений и платёжный провайдер — разные представления, и ни одно из них по отдельности не является полным ответом.

Для разбора возьмите одну организацию и один момент времени. Зафиксируйте участников, незавершённые приглашения, запланированные удаления, служебные аккаунты, желаемое количество мест и quantity, которое подтвердил биллинг. Такая фотография быстро показывает, добавляются ли приглашения дважды, освобождается ли место при блокировке и не пришёл ли старый webhook после более нового изменения.

Сначала формулируем политику одного занятого места

Состояние membershipСчитать seatПочему
activeдапользователь имеет доступ к возможностям тарифа
invitedпо выбранной политикерезерв места допустим, но должен быть виден администратору
suspendedобычно да до удалениявременная блокировка не всегда прекращает лицензию
removal_scheduledдо даты отключенияправило должно совпадать с условиями тарифа
service или botотдельное правилотехническая сущность не равна сотруднику
removed или expired inviteнетдоступ и резерв места прекращены

Не прячьте спорные состояния в SQL-условии. Политика должна быть понятна владельцу организации: например, незавершённое приглашение резервирует место пять дней, а затем освобождает его. Если продукт решил не считать приглашения, ограничение проверяют в момент принятия invite, иначе два человека могут одновременно занять последнее место.

Реестр membership даёт воспроизводимый расчёт

У каждой связи пользователь—организация храните состояние, тип участника, время вступления и завершения доступа. Изменение проходит через доменную команду, которая обновляет membership и создаёт запись в журнале мест. Не считайте лицензии как число строк в `users`: один человек может состоять в нескольких организациях, а удалённый пользователь может сохраняться для аудита.

tenant_id=org_42
policy_version=seats-v3
active_members=21
pending_invites_billable=2
suspended_billable=1
service_accounts_billable=0
desired_quantity=24
provider_quantity=23
revision=817
  • Добавление, принятие приглашения и удаление изменяют одну и ту же ревизию seat ledger.
  • Одинаковая команда с тем же idempotency key не создаёт второе место.
  • История объясняет, какое событие изменило количество и кто его инициировал.
  • Экран администратора показывает billable и non-billable состояния раздельно.

Количество в биллинге — подтверждение, а не источник доступа

При per-seat модели количество единиц подписки соответствует числу мест. Но запрос к платёжной системе может завершиться позже изменения membership или повториться. Поэтому полезно хранить `desired_quantity`, последнее подтверждённое `provider_quantity`, ревизию и состояние синхронизации. Доступ пользователя определяется вашей политикой и состоянием договора, а не случайным промежуточным ответом API.

При увеличении сначала проверьте лимит и условия оплаты, затем атомарно зарезервируйте место и отправьте обновление quantity с идемпотентным ключом. При уменьшении запишите дату применения: немедленно, в конце периода или после завершения доступа. Webhook принимается только после проверки подписи и сопоставляется с ожидаемой ревизией; старое событие не должно откатывать новое значение.

Гонки воспроизводятся на последнем доступном seat

Самый показательный тест — тариф на десять мест с девятью активными участниками и двумя одновременными попытками принять приглашение. Одна транзакция должна получить место, вторая — понятный отказ или предложение увеличить тариф. Блокировка строки организации, optimistic revision либо уникальный счётчик подходят; отдельные проверки `count` и `insert` без общей транзакции не подходят.

  1. Запустить два принятия invite с разными пользователями одновременно.
  2. Убедиться, что active membership стало ровно десять, а не одиннадцать.
  3. Повторить успешный запрос с тем же ключом и получить прежний результат.
  4. Доставить webhook в обратном порядке и проверить защиту по ревизии.
  5. Удалить участника по правилам тарифа и подтвердить освобождение ровно одного места.

Сверка обнаруживает накопленную ошибку до выставления счёта

Периодическая задача пересчитывает ожидаемое число по текущей версии политики и сравнивает его с ledger и подпиской. Расхождение не исправляется молча: оно получает tenant, revision, разбивку по состояниям и последнее успешное событие синхронизации. Небольшая задержка допустима и видима как pending, а длительное расхождение отправляется оператору до формирования следующего invoice.

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

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