Перейти к основному содержимому

Модель данных

На этой странице описаны основные активные сущности данных, которые сейчас используются в рабочей billing и access архитектуре LiVi.

Текущий охват​

На текущем этапе наиболее важными задокументированными сущностями являются:

  • entitlements
  • payment_orders

Эти сущности поддерживают billing state, access state и логику обработки платежей.

entitlements​

Сущность entitlements используется для хранения активного состояния пользовательского доступа.

Назначение​

Её роль — определять, есть ли у пользователя нужный уровень доступа для использования продукта.

Типовые поля​

  • email
  • plan
  • period
  • valid_until
  • source
  • updated_at

Смысл​

Эта сущность выступает как основной backend-ориентир для определения текущего FREE или PRO состояния.

payment_orders​

Сущность payment_orders используется для хранения событий, связанных с оплатой.

Назначение​

Её роль — фиксировать попытки оплаты, успешные платежи и состояние обработки.

Типовые поля​

  • order_reference
  • email
  • plan
  • period
  • status
  • amount
  • currency
  • provider
  • source
  • created_at
  • updated_at

Смысл​

Эта сущность поддерживает историю платежей, видимость процесса обработки и idempotent-логику при повторных платёжных callback.

Текущий принцип данных​

На текущем этапе payment state и access state логически разделены, но операционно связаны.

  • payment_orders отслеживает платёжные события
  • entitlements определяет активное состояние доступа