Переименование сущностей

Полный перечень полей — в глоссарии переименования. Раздел «Переименование сущностей» позволяет компании называть системные объекты своими словами: прокат самокатов может говорить «самокат» вместо «инвентарь», автопрокат — «автомобиль», а сервисный центр — «заказ-наряд» вместо «мастерская». Переименование задаётся не одной строкой, а полным набором форм — единственное и множественное число во всех шести падежах, — чтобы интерфейс мог корректно строить фразы вида «нет свободных самокатов» или «добавить к автомобилю».

​

Что можно переименовать

Ключ переименования — это закрытый список из шестнадцати позиций: восемь справочных сущностей и восемь статусов аренды. Переименование статусов аренды — чисто визуальное: смысл статуса, переходы между ними, расчёты и отчётность не меняются. То же верно и для сущностей: система продолжает работать с прежними объектами, меняется только то, как они называются на экране.

​

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

Одна запись наименования — это связка «ключ переименования + язык» и двенадцать форм слова: шесть падежей единственного числа и шесть падежей множественного.

​

Идентификация и область действия

​

Формы слова

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

​

Два уровня: глобальные наборы и наименования компании

Наименования живут в двух слоях. Глобальные наименования заводит платформа. У такой записи не указана компания, зато перечислены типы компаний, которым она предназначена. Это заготовки «из коробки»: например, для типа «прокат самокатов» платформа заранее описывает инвентарь как «самокат» во всех падежах. Наименования компании — записи с указанной компанией. Они перекрывают глобальные значения для этой конкретной компании и ни на кого больше не влияют. Ограничение уникальности «компания + язык + ключ» действует только для записей компании: у одной компании не может быть двух наименований одного ключа на одном языке. Глобальные наборы этим правилом не ограничены — платформа технически может завести несколько записей на один ключ и язык.

​

Как формируется итоговый список

Выдача списка наименований работает так:

1. Отбираются записи, принадлежащие текущей компании.
2. К ним добавляются глобальные наборы, привязанные к типу текущей компании. Если у компании тип не указан, глобальные наборы в отбор не попадают вовсе, и список состоит только из собственных записей.
3. Отобранное сортируется так, чтобы записи без компании шли первыми, а записи компании — следом.
4. Результат сворачивается по ключу переименования: на каждый ключ остаётся одна запись, и побеждает та, что встретилась последней, — то есть наименование компании.

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

​

Сохранение: «создать или обновить»

Сохранение нового наименования устроено как идемпотентная операция по паре «ключ переименования + язык» в рамках текущей компании:

• если у компании такой записи ещё нет — она создаётся;
• если запись уже есть — у неё обновляются переданные формы.

Дубликатов повторная отправка не создаёт, а компания и типы компаний в запросе не участвуют: принадлежность подставляется по текущей компании автоматически, а привязка к типам остаётся зоной ответственности платформы. В ответ возвращается сохранённая запись с идентификатором — со статусом «создано» независимо от того, была запись создана или обновлена. Сохранение всегда порождает запись компании. Глобальный набор при этом остаётся нетронутым: он просто перестаёт быть виден в списке, потому что его вытеснила запись компании.

​

Изменение и удаление одной записи

Отдельное наименование можно посмотреть, изменить и удалить по его идентификатору, но работает это только с записями текущей компании. Глобальные наборы через этот механизм недоступны: попытка обратиться к ним по идентификатору отвечает «не найдено», хотя в общем списке они видны. Удаление записи компании — это и есть «сброс к значению по умолчанию»: после удаления в общем списке снова появляется глобальный набор соответствующего типа компании (если он существует).

​

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

Помимо общего списка задумана отдельная выдача значений по умолчанию: она возвращает все глобальные наборы — без учёта типа компании и без учёта языка — как справочник «к чему можно вернуться», и по замыслу открыта любому авторизованному пользователю, а не только сотрудникам компании.

​

Права доступа

​

Управление со стороны платформы

В административной панели переименования разложены на два раздела, работающих поверх одних и тех же данных. Глобальные наименования — раздел платформы. В нём видны только записи без компании, поле компании в форме отсутствует и всегда остаётся пустым, зато можно выбрать типы компаний, которым набор предназначен, и увидеть их перечень в списке. Есть фильтр по ключу переименования. Формы слова сгруппированы в два блока — падежи единственного и множественного числа. Наименования компании — раздел для разбора конкретных ситуаций. В нём видны только записи с указанной компанией, компанию можно выбрать через поиск, а список фильтруется по компании (фильтра по ключу здесь нет). Набор полей тот же, что и в глобальном разделе.

​

Границы применения

• Наименования не кэшируются, в отличие от значений настроек компании: изменение видно при следующем обращении к списку, дополнительного сброса кэша не требуется.
• Значения хранятся в общей части базы и связаны с компанией ссылкой, поэтому переименования одинаково доступны всем пользователям компании и не зависят от того, с каким набором данных компании идёт работа.
• Система нигде не подставляет эти названия за клиента: серверная часть сама по-прежнему оперирует исходными сущностями и статусами, а подстановка нужных падежных форм в тексты — задача интерфейса, который получает наименования из общего списка.

​

Подводные камни

Менее критичные особенности:

• Компания без указанного типа бизнеса не получает ни одного глобального набора: отбор умолчаний идёт строго по типу компании, поэтому в списке будут только те наименования, которые компания завела сама.
• Ограничение уникальности «компания + язык + ключ» распространяется только на записи компании. Платформа может завести несколько глобальных записей на один ключ и язык, и тогда в списке компании победит непредсказуемая из них — порядок среди глобальных записей не задан.
• Все падежные формы необязательны, включая базовую именительную: наименование можно сохранить с пустыми полями, и система не достроит недостающие формы и не предупредит об этом.
• Глобальный набор, у которого не указаны типы компаний, не увидит ни одна компания — он останется доступен только в административной панели.
• Список языков ограничен языками системы — русским и английским; завести наименование на другом языке нельзя.
• В разделе наименований компании административной панели фильтр по ключу переименования объявлен, но перекрыт фильтром по компании, поэтому доступен только отбор по компании. В глобальном разделе фильтр по ключу работает.

​

Связанные страницы