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

# Глоссарий: Инвентарь (единицы)

> Справочник моделей, полей и статусов единицы инвентаря — от цены и состояния до субаренды и вычисляемого статуса.

Справочник к странице [«Единицы инвентаря»](/ru/logic/inventory/inventory-items).

## Понятия

| Понятие               | Значение                                                                                                                                                                                                                          |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Единица инвентаря     | Индивидуальная единица оборудования/транспорта, которую сдают в аренду или продают; несёт цену, состояние, точку хранения, субаренду и вычисляемый статус. Статус не хранится, а вычисляется на лету; поля субаренды — живой кэш. |
| Авто-карточка единицы | Авто-специфичные атрибуты единицы (номер, техпаспорт, VIN, марка/модель) для транспортного проката. Связь один-к-одному с единицей; активна при включённой опции авто-инвентаря.                                                  |
| Состояние инвентаря   | Справочник пользовательских состояний единицы (например «Исправна», «На ремонте»); влияет на доступность. Флаг блокировки выводит единицу из проката, связь с мастерской привязывает состояние к ремонту.                         |
| Страховка единицы     | Полис страхования единицы (КАСКО/ОГПО) с компанией, номером, суммой и сроком действия. Связь один-к-одному с единицей.                                                                                                            |
| Пробег единицы        | Запись показания пробега/дистанции единицы на определённый момент; используется для планового ТО по пробегу.                                                                                                                      |
| Менеджер единиц       | Расчётный слой: вычисляет статус и доступность единиц по расписанию, состоянию, складу, задачам мастерской и продаже; учитывает буфер между бронями.                                                                              |
| Вычисляемый статус    | Оперативный статус единицы (свободна, в аренде, сломана и т.д.), который не хранится в базе, а аннотируется на лету менеджером.                                                                                                   |

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

### Единица инвентаря

*Индивидуальная единица оборудования/транспорта, которую сдают в аренду или продают; несёт цену, состояние, точку хранения, субаренду и вычисляемый статус. Статус (свободна/в аренде/сломана и т.д.) не хранится, а вычисляется менеджером на лету; поля субаренды — живой кэш.*

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

| Поле                     | Тип                           | Описание                                                                                  |
| ------------------------ | ----------------------------- | ----------------------------------------------------------------------------------------- |
| Название                 | текст                         | Наименование единицы.                                                                     |
| Уникальный идентификатор | текст                         | Внутренний артикул/инвентарный номер; при включённой проверке уникален среди неудалённых. |
| Идентификатор устройства | текст                         | Технический ID устройства/метки; только для чтения.                                       |
| Тип учёта                | перечисление (аренда/продажа) | Аренда или продажа.                                                                       |

**Связи**

| Поле          | Тип   | Описание                                                                         |
| ------------- | ----- | -------------------------------------------------------------------------------- |
| Категория     | связь | Категория товара.                                                                |
| Продукт       | связь | Продукт (учёт по количеству), к которому относится единица.                      |
| Точка проката | связь | Точка хранения/выдачи; меняется операцией перемещения.                           |
| Состояние     | связь | Ссылка на состояние; блокирующее состояние делает единицу сломанной/недоступной. |

**Деньги**

| Поле               | Тип             | Описание                                                    |
| ------------------ | --------------- | ----------------------------------------------------------- |
| Цена покупки       | число (2 знака) | Закупочная стоимость.                                       |
| Дата покупки       | дата            | Дата приобретения.                                          |
| Цена продажи       | число (2 знака) | Стоимость продажи; заполняется при продаже.                 |
| Дата продажи       | дата/время      | Проставляется при продаже; непустая дата = единица продана. |
| Складская цена     | число (2 знака) | Учётная/складская стоимость.                                |
| Срок службы        | число           | Срок эксплуатации (для амортизации).                        |
| Предыдущая выручка | число (2 знака) | Накопленный/перенесённый доход по единице (кэш для метрик). |

**Субаренда**

| Поле               | Тип                    | Описание                                                                                            |
| ------------------ | ---------------------- | --------------------------------------------------------------------------------------------------- |
| Владелец субаренды | связь                  | Пользователь-субарендодатель; заполнено = единица в субаренде (живой кэш поверх истории субаренды). |
| Процент субаренды  | число (2 знака, 0–100) | Доля выплаты субарендодателю.                                                                       |

**Прочее**

| Поле              | Тип           | Описание                                                                 |
| ----------------- | ------------- | ------------------------------------------------------------------------ |
| Комментарий       | текст         | Произвольное описание.                                                   |
| Изображение       | файл          | Фото единицы; при сохранении создаётся превью.                           |
| Доп. данные       | JSON          | Произвольные атрибуты; сюда пишется общий пробег при добавлении пробега. |
| История изменений | журнал аудита | Лог изменений полей.                                                     |
| Дата создания     | дата/время    | Из базовой модели.                                                       |
| Дата обновления   | дата/время    | Из базовой модели.                                                       |
| Компания          | связь         | Ограничение по компании.                                                 |

### Авто-карточка единицы

*Авто-специфичные атрибуты единицы (номер, техпаспорт, VIN, марка/модель) для транспортного проката. Связь один-к-одному с единицей инвентаря; активна при включённой опции авто-инвентаря.*

| Поле              | Тип                 | Описание                                                                  |
| ----------------- | ------------------- | ------------------------------------------------------------------------- |
| Единица инвентаря | связь один-к-одному | Единица, к которой относится авто-карточка.                               |
| Тип транспорта    | перечисление        | Машина / электросамокат / мотоцикл.                                       |
| Гос. номер        | текст               | Для машин проверяется формат; вместе с техпаспортом должен быть уникален. |
| Техпаспорт        | текст               | Номер техпаспорта; для машин проверяется формат.                          |
| Серийный номер    | текст               | Серийный номер (для самокатов/мото).                                      |
| VIN               | текст               | VIN-код.                                                                  |
| Марка             | текст               | Марка транспорта.                                                         |
| Модель            | текст               | Модель транспорта.                                                        |
| Доп. данные       | JSON                | Произвольные атрибуты.                                                    |

### Состояние инвентаря

*Справочник пользовательских состояний единицы (например «Исправна», «На ремонте»); влияет на доступность. Флаг блокировки выводит единицу из проката; связь с мастерской привязывает состояние к ремонту.*

| Поле                    | Тип         | Описание                                                 |
| ----------------------- | ----------- | -------------------------------------------------------- |
| Название                | текст       | Наименование состояния.                                  |
| Блокирует прокат        | флаг        | Если включено — единица считается сломанной/недоступной. |
| Отправляет в мастерскую | флаг        | Состояние связано с ремонтом/мастерской.                 |
| Воронка мастерской      | связь       | Пайплайн задач мастерской.                               |
| Цвет                    | текст (HEX) | Цвет метки состояния.                                    |
| Комментарий             | текст       | Описание состояния.                                      |

### Страховка единицы

*Полис страхования единицы (КАСКО/ОГПО) с компанией, номером, суммой и сроком действия. Связь один-к-одному с единицей инвентаря.*

| Поле               | Тип                       | Описание                   |
| ------------------ | ------------------------- | -------------------------- |
| Единица инвентаря  | связь один-к-одному       | Застрахованная единица.    |
| Тип полиса         | перечисление (КАСКО/ОГПО) | Вид страхования.           |
| Страховая компания | текст                     | Наименование страховщика.  |
| Номер полиса       | текст                     | Номер страхового полиса.   |
| Сумма              | число (2 знака)           | Страховая сумма/стоимость. |
| Начало действия    | дата/время                | Дата начала полиса.        |
| Окончание действия | дата/время                | Дата окончания полиса.     |

### Пробег единицы

*Запись показания пробега/дистанции единицы на определённый момент; используется для планового ТО по пробегу. При сохранении обновляет общий пробег единицы и может инициировать уведомление о ТО.*

| Поле              | Тип        | Описание                                                    |
| ----------------- | ---------- | ----------------------------------------------------------- |
| Единица инвентаря | связь      | Единица, по которой зафиксирован пробег.                    |
| Инвентаризация    | связь      | Инвентаризация, в рамках которой снят пробег (опционально). |
| Пробег            | число      | Показание пробега/дистанции.                                |
| Дата снятия       | дата/время | Когда зафиксировано показание.                              |

### Менеджер единиц (расчёт доступности)

*Расчётный слой единицы: вычисляет статус и доступность единиц по расписанию, состоянию, складу, задачам мастерской и продаже. Аннотирует статус на лету; учитывает буфер между бронями.*

| Поле           | Тип   | Описание                                                                                                                                                                                             |
| -------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| С доступностью | метод | Аннотирует статус единицы с учётом брони, ремонта, склада, списания и продажи. Из задач мастерской учитываются только открытые задачи на этапах с признаком «Занимать инвентарь» и задачи без этапа. |
| По расписанию  | метод | Исключает единицы, занятые в интервале, проданные, на складе или отключённые. Задачи мастерской не учитывает.                                                                                        |
| Со статусом    | метод | Аннотирует статус без учёта арендного расписания; задачи мастерской отбираются по тому же признаку «Занимать инвентарь».                                                                             |

### Операция продажи единиц

*Массовая продажа единиц: проставляет цену и дату продажи выбранным ещё не проданным единицам.*

| Поле         | Тип             | Описание                           |
| ------------ | --------------- | ---------------------------------- |
| Цена продажи | число (2 знака) | Устанавливаемая цена продажи.      |
| Единицы      | список ID       | Идентификаторы продаваемых единиц. |

### Операция перемещения единиц

*Массовое перемещение выбранных единиц на указанную точку проката.*

| Поле          | Тип       | Описание                            |
| ------------- | --------- | ----------------------------------- |
| Точка проката | связь     | Целевая точка.                      |
| Единицы       | список ID | Идентификаторы перемещаемых единиц. |

### Операция смены продукта единиц

*Массово переносит выбранные единицы в указанный продукт.*

| Поле    | Тип                 | Описание                           |
| ------- | ------------------- | ---------------------------------- |
| Продукт | число (ID продукта) | Целевой продукт.                   |
| Единицы | список ID           | Идентификаторы переносимых единиц. |

### Импорт единиц

*Пакетный импорт единиц из таблицы: создаёт недостающие категории, продукты и точки и массово создаёт единицы. Принимает список строк импорта; собирает ошибки по строкам.*

**Строка импорта**

| Поле                     | Тип         | Описание                                        |
| ------------------------ | ----------- | ----------------------------------------------- |
| Уникальный идентификатор | текст       | Артикул единицы.                                |
| Идентификатор продукта   | текст       | Артикул продукта, к которому привязать единицу. |
| Категория                | текст       | Название категории (создаётся при отсутствии).  |
| Название единицы         | текст       | Наименование единицы.                           |
| Название продукта        | текст       | Наименование продукта.                          |
| Точка проката            | текст       | Название точки (создаётся при отсутствии).      |
| Описание                 | текст       | Комментарий к единице.                          |
| Цена покупки             | текст/число | Закупочная стоимость (парсится из строки).      |
| Дата покупки             | дата        | Дата приобретения.                              |

### Единица в витрине продаж

*Представление единицы для списка «на продажу/продано» со сведениями о цене, покупателе и складе. Поля клиента и цены — аннотации из связанных продаж/складских записей.*

| Поле            | Тип             | Описание                         |
| --------------- | --------------- | -------------------------------- |
| ID клиента      | число           | Покупатель (для проданных).      |
| Имя клиента     | текст           | Имя покупателя.                  |
| Телефон клиента | текст           | Телефон покупателя.              |
| Аватар клиента  | текст (URL)     | Аватар покупателя.               |
| Цена            | число (2 знака) | Цена продажи или складская цена. |
| Контрагент      | число (ID)      | Контрагент сделки/поставки.      |
| Склад           | число (ID)      | Склад.                           |
| Кем создано     | число (ID)      | Автор записи о продаже/поставке. |
| Дата            | дата/время      | Дата продажи или поступления.    |
| Дата продажи    | дата/время      | Из единицы инвентаря.            |

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

### Статус единицы (вычисляемый)

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

* Свободна
* Забронирована
* В аренде
* Сломана
* Просрочена
* Отключена/удалена
* Продана
* На ремонте
* Списана
* На складе
* На доставке
* Возврат с доставки

### Тип учёта единицы

Определяет, предназначена ли единица для аренды или для продажи.

* Аренда
* Продажа

### Тип транспорта

Вид транспортной единицы в авто-карточке; влияет на проверки формата и лимиты.

* Машина
* Электросамокат
* Мотоцикл/Мопед

### Тип страхового полиса

Вид страхования единицы.

* КАСКО
* ОГПО (ОСАГО)

### Способ вывода из оборота

Как единица была скрыта/выведена: удаление, архив или списание; влияет на вычисляемый статус.

* Удаление
* Архив
* Списание
