> ## 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/settings/labels).

## Понятия

| Понятие                          | Значение                                                                                                                                                                                                      |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Наименование сущности            | Переименование системной сущности (инвентарь, комплект, продукт, точка, услуга, клиент, депозит, мастерская, статусы аренды) на нужный язык со всеми падежными формами. Одна запись — это пара «ключ + язык». |
| Глобальные наименования          | Наборы наименований по умолчанию, которые платформа заводит для типов компаний. Отдельного хранилища нет: это представление записей без компании.                                                             |
| Наименования компании            | Собственные наименования конкретной компании, перекрывающие глобальные значения. Представление записей с заполненной компанией.                                                                               |
| Состав наименования в API        | Набор полей, которые компания видит и может задать через интерфейс: компания и типы компаний через API не передаются.                                                                                         |
| Список и сохранение наименований | Итоговый список наименований для компании и приём новых значений: по каждому ключу собственное наименование побеждает глобальное.                                                                             |
| Наименования по умолчанию        | Отдельная выдача глобальных наборов — значения, к которым можно вернуться.                                                                                                                                    |
| Отдельное наименование           | Просмотр, изменение и удаление одного наименования компании; удаление возвращает компанию к глобальному значению.                                                                                             |
| Ключ переименования              | Перечень сущностей и статусов аренды, названия которых компания может изменить под себя.                                                                                                                      |
| Падеж                            | Справочник падежей, по которым заполняются формы наименования в единственном и множественном числе.                                                                                                           |

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

### Наименование сущности

*Переименование системной сущности (инвентарь, комплект, продукт, точка, услуга, клиент, депозит, мастерская, статусы аренды) на нужный язык со всеми падежными формами. Одна запись = ключ + язык. Если компания не указана — это глобальный набор, привязанный к типам компаний; если указана — переопределение компании. Уникальность (компания, язык, ключ) действует только для записей компании, глобальные записи не ограничены.*

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

| Поле                | Тип             | Описание                                                                                   |
| ------------------- | --------------- | ------------------------------------------------------------------------------------------ |
| Идентификатор       | число           | Первичный ключ записи, используется в адресе конкретного наименования                      |
| Ключ переименования | выбор из списка | Какую именно сущность или статус аренды переименовывает запись (см. «Ключ переименования») |
| Язык                | выбор из списка | Язык, для которого заданы формы; выбирается из языков, поддерживаемых системой             |

**Область действия**

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

**Единственное число**

| Поле                        | Тип   | Описание                                        |
| --------------------------- | ----- | ----------------------------------------------- |
| Именительный падеж (ед. ч.) | текст | Базовая форма: кто? что? — например «Инвентарь» |
| Родительный падеж (ед. ч.)  | текст | Кого? чего? — например «инвентаря»              |
| Дательный падеж (ед. ч.)    | текст | Кому? чему? — например «инвентарю»              |
| Винительный падеж (ед. ч.)  | текст | Кого? что? — например «инвентарь»               |
| Творительный падеж (ед. ч.) | текст | Кем? чем? — например «инвентарём»               |
| Предложный падеж (ед. ч.)   | текст | О ком? о чём? — например «об инвентаре»         |

**Множественное число**

| Поле                        | Тип   | Описание                                                  |
| --------------------------- | ----- | --------------------------------------------------------- |
| Именительный падеж (мн. ч.) | текст | Базовая форма множественного числа — например «Инвентари» |
| Родительный падеж (мн. ч.)  | текст | Кого? чего? — например «инвентарей»                       |
| Дательный падеж (мн. ч.)    | текст | Кому? чему? — например «инвентарям»                       |
| Винительный падеж (мн. ч.)  | текст | Кого? что? — например «инвентари»                         |
| Творительный падеж (мн. ч.) | текст | Кем? чем? — например «инвентарями»                        |
| Предложный падеж (мн. ч.)   | текст | О ком? о чём? — например «об инвентарях»                  |

### Глобальные наименования

*Наборы наименований по умолчанию, которые платформа заводит для типов компаний. Не отдельная таблица, а отдельное представление наименований в админке: показываются только записи без компании. Поле «Компания» у них недоступно, набор полей во всём остальном совпадает с наименованием сущности.*

| Поле                | Тип             | Описание                                                                                 |
| ------------------- | --------------- | ---------------------------------------------------------------------------------------- |
| Типы компаний       | связь (много)   | Кому достаётся набор по умолчанию: компания получает глобальные наименования своего типа |
| Ключ переименования | выбор из списка | Переименовываемая сущность или статус аренды                                             |
| Язык                | выбор из списка | Язык набора по умолчанию                                                                 |

### Наименования компании

*Собственные наименования конкретной компании, перекрывающие глобальные значения. Не отдельная таблица, а отдельное представление наименований в админке: показываются только записи с заполненной компанией. Набор полей совпадает с наименованием сущности.*

| Поле                | Тип             | Описание                                                               |
| ------------------- | --------------- | ---------------------------------------------------------------------- |
| Компания            | связь           | Компания-владелец переопределения; обязательна для этого представления |
| Ключ переименования | выбор из списка | Переименовываемая сущность или статус аренды                           |
| Язык                | выбор из списка | Язык, для которого компания задала свои формы                          |

### Состав наименования в API

*Определяет, какие поля наименования компания видит и может задать через интерфейс. Компания и типы компаний через API не передаются: принадлежность подставляется автоматически по текущей компании, а привязка к типам остаётся за платформой.*

| Поле                | Тип             | Описание                                                                   |
| ------------------- | --------------- | -------------------------------------------------------------------------- |
| Идентификатор       | число           | Возвращается для последующего изменения или удаления наименования          |
| Ключ переименования | выбор из списка | Вместе с языком образует пару, по которой запись создаётся или обновляется |
| Язык                | выбор из списка | Вторая половина пары «ключ + язык»                                         |

**Единственное число**

| Поле                        | Тип   | Описание                                                |
| --------------------------- | ----- | ------------------------------------------------------- |
| Именительный падеж (ед. ч.) | текст | Основная форма, которую видит пользователь в интерфейсе |
| Родительный падеж (ед. ч.)  | текст | Передаётся так же, как и остальные падежи               |
| Дательный падеж (ед. ч.)    | текст | —                                                       |
| Винительный падеж (ед. ч.)  | текст | —                                                       |
| Творительный падеж (ед. ч.) | текст | —                                                       |
| Предложный падеж (ед. ч.)   | текст | —                                                       |

**Множественное число**

| Поле                        | Тип   | Описание                            |
| --------------------------- | ----- | ----------------------------------- |
| Именительный падеж (мн. ч.) | текст | Основная форма множественного числа |
| Родительный падеж (мн. ч.)  | текст | —                                   |
| Дательный падеж (мн. ч.)    | текст | —                                   |
| Винительный падеж (мн. ч.)  | текст | —                                   |
| Творительный падеж (мн. ч.) | текст | —                                   |
| Предложный падеж (мн. ч.)   | текст | —                                   |

### Список и сохранение наименований

*Отдаёт компании итоговый список наименований и принимает новые значения. В выдаче склеиваются глобальные наборы типа компании и собственные записи: по каждому ключу побеждает наименование компании. Сохранение работает как «создать или обновить» по паре ключ + язык, поэтому повторная отправка не плодит дубликаты. Изменять может только владелец компании, остальным доступно чтение.*

### Наименования по умолчанию

*Отдельная выдача глобальных наборов — значения, к которым можно вернуться. Возвращает только записи без компании, без учёта типа компании; доступна любому авторизованному пользователю.*

### Отдельное наименование

*Просмотр, изменение и удаление одного наименования компании. Работает только с записями текущей компании: глобальные наборы через него не редактируются и не удаляются. Удаление возвращает компанию к глобальному значению.*

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

### Ключ переименования

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

* Инвентарь
* Комплект
* Продукт
* Точка проката
* Услуга
* Клиент
* Депозит
* Мастерская
* Запрос
* Забронировано
* В прокате
* Отменено
* Завершено
* Должник
* Просрочено
* Удалено

### Падеж

*Справочник падежей, по которым заполняются формы наименования в единственном и множественном числе. Служит справочником: сами формы хранятся в отдельных полях наименования, а не выбором из этого списка.*

* Именительный (кто? что?)
* Родительный (кого? чего?)
* Дательный (кому? чему?)
* Винительный (кого? что?)
* Творительный (кем? чем?)
* Предложный (о ком? о чём?)
