Если в корпоративном тарифе счёт показывает 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` без общей транзакции не подходят.
- Запустить два принятия invite с разными пользователями одновременно.
- Убедиться, что active membership стало ровно десять, а не одиннадцать.
- Повторить успешный запрос с тем же ключом и получить прежний результат.
- Доставить webhook в обратном порядке и проверить защиту по ревизии.
- Удалить участника по правилам тарифа и подтвердить освобождение ровно одного места.
Сверка обнаруживает накопленную ошибку до выставления счёта
Периодическая задача пересчитывает ожидаемое число по текущей версии политики и сравнивает его с ledger и подпиской. Расхождение не исправляется молча: оно получает tenant, revision, разбивку по состояниям и последнее успешное событие синхронизации. Небольшая задержка допустима и видима как pending, а длительное расхождение отправляется оператору до формирования следующего invoice.
Исправление можно считать завершённым, когда администратор понимает состав 24 мест, два параллельных изменения не превышают лимит, повтор события ничего не дублирует, а сверка с провайдером приходит к тому же quantity. Для поддержки достаточно идентификатора организации, версии политики и ревизий; платёжные реквизиты и персональные данные сотрудников в диагностический пакет не включаются.