> ## 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.

# Глоссарий: Брендированная выдача пропусков

> Справочник модели пропуска Apple/Google Wallet, вспомогательных функций и view-обработчиков выдачи карт клиентам и заказам.

Справочник к странице [«Брендированная выдача пропусков»](/ru/logic/wallet/issue).

## Понятия

| Понятие                               | Значение                                                                                                                                                        |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Пропуск (карта Wallet)                | Выпущенная карта Apple/Google Wallet, привязанная к клиенту или заказу компании. Живёт в общих (глобальных) таблицах; один пропуск на объект в рамках компании. |
| Получение или создание пропуска       | Хелпер: находит существующий пропуск по (компания, тип, объект) или создаёт новый с новым серийным номером. Гарантирует один пропуск на объект внутри компании. |
| Формирование файла карты              | Собирает файл карты Apple Wallet и отдаёт его на скачивание (Last-Modified).                                                                                    |
| Выдача бонусной карты в Apple Wallet  | Публичный адрес: формирует файл карты для бонусной карты клиента и отдаёт его на скачивание; создаёт или переиспользует пропуск.                                |
| Выдача заказа в Apple Wallet          | Публичный адрес: формирует файл карты для заказа аренды и отдаёт его на скачивание; требует наличия клиента у заказа.                                           |
| Выдача бонусной карты в Google Wallet | Публичный обработчик: возвращает ссылку сохранения бонусной карты в Google Wallet; клиент должен существовать.                                                  |
| Выдача заказа в Google Wallet         | Публичный обработчик: возвращает ссылку сохранения заказа аренды в Google Wallet; клиент должен существовать.                                                   |

## Модели и поля

### Пропуск (карта Wallet)

*Выпущенная карта Apple/Google Wallet, привязанная к клиенту или заказу компании. Живёт в общих (глобальных) таблицах; один пропуск на объект в рамках компании (уникальность по паре компания + тип + объект).*

**Связи**

| Поле     | Тип   | Описание                               |
| -------- | ----- | -------------------------------------- |
| Компания | связь | Владелец пропуска; ссылка на компанию. |

**Идентификация**

| Поле                  | Тип          | Описание                                                                      |
| --------------------- | ------------ | ----------------------------------------------------------------------------- |
| Тип пропуска          | перечисление | Бонусная карта или заказ; индексируется.                                      |
| ID связанного объекта | число        | ID бонусной карты или заказа, к которому привязан пропуск; может быть пустым. |
| Серийный номер        | текст        | Уникальный серийный номер пропуска в системе Wallet.                          |
| Тип карты             | текст        | Служебное обозначение вида карты, выданное Apple.                             |
| Токен авторизации     | текст        | Секрет для проверки запросов к пропуску; генерируется автоматически.          |

**Состояние**

| Поле        | Тип        | Описание                                                      |
| ----------- | ---------- | ------------------------------------------------------------- |
| Аннулирован | флаг       | Признак отозванного/недействительного пропуска.               |
| Обновлён    | дата/время | Время последнего изменения; используется для push-обновлений. |
| Создан      | дата/время | Время создания пропуска.                                      |

## Статусы и справочники

### Тип пропуска

Определяет, к чему привязан пропуск: к бонусной карте или к заказу аренды.

* Бонусная карта
* Заказ