> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yume.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Клиенты, бонусы и рефералы

> Карточка клиента (физлицо/юрлицо), паспорта и KYC, начисление и списание бонусов, программа лояльности и реферальные агенты.

Модуль отвечает за всё, что связано с **клиентом** арендной компании: карточку клиента, его документы (KYC), рейтинги/чёрный список, накопленные **бонусы**, привязку к **программе лояльности** и учёт **реферальных агентов**, приводящих заявки.

Центральная сущность — **Клиент**. Она принадлежит конкретной компании, но ссылается на **Пользователя** и через него — на **программу лояльности**, которые общие для всех компаний в системе.

Важно с самого начала различать три независимых механизма «награды/скидки», которые легко перепутать:

<CardGroup cols={3}>
  <Card title="Бонусы" icon="coins" href="/ru/logic/clients-loyalty/bonuses">
    Накопительный баланс клиента (баланс бонусов). Начисляются процентом от оплаченной аренды, списываются в счёт оплаты следующей.
  </Card>

  <Card title="Скидки" icon="percent" href="/ru/logic/rent/pricing">
    Уменьшают стоимость конкретной аренды. Отдельная сущность — см. [Скидки](/ru/logic/rent/pricing).
  </Card>

  <Card title="Рефералы" icon="handshake" href="/ru/logic/clients-loyalty/referrals">
    Вознаграждение агенту, приведшему клиента/заявку. Отдельная строка «Реферальное вознаграждение» в аренде.
  </Card>
</CardGroup>

<Info>
  Бонусы, скидки и реферальные выплаты считаются **разными** строками расчёта аренды и не смешиваются между собой. Бонус — это баланс клиента, скидка — уменьшение цены, реферал — расход в пользу агента.
</Info>

## Разделы

<CardGroup cols={2}>
  <Card title="Карточка клиента" icon="id-card" href="/ru/logic/clients-loyalty/client">
    Профиль клиента (физлицо/юрлицо), паспорта и KYC, рейтинги и чёрный список, связь клиента с его арендами.
  </Card>

  <Card title="Бонусы" icon="coins" href="/ru/logic/clients-loyalty/bonuses">
    Бонусный счёт: начисление процентом от оплаченной аренды, списание в счёт следующей, пересчёт баланса.
  </Card>

  <Card title="Программа лояльности" icon="gem" href="/ru/logic/clients-loyalty/loyalty-program">
    Уровни лояльности, процент кэшбэка для начисления бонусов и дизайн Wallet-карт.
  </Card>

  <Card title="Реферальные агенты" icon="handshake" href="/ru/logic/clients-loyalty/referrals">
    Агенты, приводящие клиентов, реферал по аренде, статус выплаты и аналитика по агентам.
  </Card>
</CardGroup>

## Как всё устроено

Одна сущность связывает все разделы модуля — **Клиент**. Остальное вокруг неё делится на независимые слои:

* **Профиль клиента** (карточка, KYC, рейтинги, чёрный список) — база, к которой привязано всё остальное.
* **Бонусы** — собственный накопительный баланс клиента, начисляется и списывается по формулам, привязанным к статусу и оплате аренды.
* **Программа лояльности** — не про клиента напрямую, а про его **аккаунт пользователя** (общий для всех компаний); определяет процент кэшбэка для бонусов и оформление Wallet-карты.
* **Реферальные агенты** — сторонний справочник, не связанный с клиентом впрямую: реферал привязывается к заявке аренды и превращается в отдельную денежную строку при расчёте прибыли.

<Note>
  У большинства оффлайн-клиентов аккаунт пользователя не заполнен, поэтому на практике чаще всего применяется процент кэшбэка по умолчанию из настроек компании, а не процент уровня лояльности. Подробности — на странице [«Программа лояльности»](/ru/logic/clients-loyalty/loyalty-program).
</Note>

## Связанные разделы

* [Скидки](/ru/logic/rent/pricing) — как уменьшается стоимость аренды (не путать с бонусами).
* [Аренда: заявка и жизненный цикл](/ru/logic/rent/lifecycle) — статусы аренды, при которых начисляются бонусы.
* [Оплата: модель, знак и проверки](/ru/logic/finances/payments) — денежные операции, куда попадают списанные бонусы.
* [Прибыль и окупаемость](/ru/logic/profit-payback) — где учитывается реферальное вознаграждение.
* [Метрики и аналитика](/ru/logic/metrics) — бонусные и реферальные метрики.
* [Фоновые процессы](/ru/logic/background-tasks) — пересчёт аренды.