Skip to main content
Справочник к странице «Настройки в админ-панели».

Понятия

Модели и поля

Значение настройки компании

Сохранённое значение одной настройки конкретной компании. Пара «компания + ключ» уникальна; ключи без записи работают на значении по умолчанию из реестра.

Ленивый объект настроек

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

Подключение модуля настроек

Конфигурация приложения: при запуске регистрирует поисковые правила и обработчики изменений. Благодаря этим обработчикам сохранение значения обновляет кэш; сброс параметра удаляет строку напрямую и кэш не трогает.

Админ-раздел «Настройки»

Раздел админ-панели со списком сохранённых значений и отдельной страницей редактирования всех параметров одной компании. Доступ ограничен суперпользователем платформы, добавление вручную запрещено. Список Доступ Страница компании

Форма одиночной настройки

Форма стандартной карточки значения: подставляет поле ввода, соответствующее типу параметра. Если ключ отсутствует в реестре параметров, форма не открывается; для неизвестного типа берётся текстовое поле.

Карта типов и полей ввода

Соответствие типа параметра классу поля формы и виджету ввода. Используется карточкой одиночного значения; на странице компании применяется отдельный подбор виджета.

Разбор описания параметра

Возвращает значение по умолчанию, код и тип параметра, вычисляя тип по умолчанию, если он не указан явно. Описание из двух элементов допустимо: тип определяется по значению по умолчанию.

Приведение введённого значения к типу

Превращает текст из формы в значение нужного типа перед сохранением. Пустое значение сохраняется как «не задано» (для флагов — как значение по умолчанию); при ошибке разбора текст сохраняется как есть.

Отображение значения в поле

Обратное преобразование: готовит хранимое значение к показу в поле формы. Флаги показываются как ДА/НЕТ, длительность — как часы:минуты:секунды, структуры — как JSON.

Строка параметра

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

Секции параметров

Разбивка таблицы параметров на именованные блоки. Состав секций берётся из настройки проекта; сейчас она не задана, поэтому все параметры попадают в одну общую секцию.

Страница настроек компании (шаблон)

Таблица всех параметров компании с полями ввода, значением по умолчанию, кодом и кнопкой сброса. Сохранение одной кнопкой внизу страницы; отправляются только изменённые значения. Форма Управление

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

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

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

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

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

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

Админ-раздел «Наименования компании»

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

Админ-раздел «Глобальные наименования»

Наименования по умолчанию для всей платформы, привязанные к типам компаний. В списке остаются только записи без компании.

Настройка таблицы

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

Админ-раздел «Настройки таблиц»

Просмотр персональных раскладок колонок таблиц по компаниям. Добавление, изменение и удаление — только для суперпользователя.

Промо-баннер

Рекламный баннер платформы, который показывается сотрудникам компаний в интерфейсе. Баннеры общие для всей платформы (создаются в админке), а ограничения и журнал показов ведутся по компаниям и пользователям внутри одной записи. Идентификация Содержимое Показ Доступность

Баннеры в админке

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

Сквозной счётчик

Хранит текущее значение автонумерации для пары «компания + ключ счётчика». Номер выдаётся с блокировкой строки, поэтому одновременные запросы не получают одинаковых номеров; пара «компания + ключ» уникальна, счётчики разных компаний независимы.

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

Вид поля ввода

Определяет, каким элементом управления параметр показывается на странице компании. Цвет распознаётся по значению по умолчанию вида #RGB или #RRGGBB, а не по типу.
  • Переключатель
  • Целое число
  • Дробное число
  • Длительность
  • Дата и время
  • Дата
  • Структура (JSON)
  • Цвет
  • Строка

Действие формы

Что делать с отправленной страницей настроек компании. Кнопка сброса дополнительно передаёт ключ сбрасываемого параметра.
  • Сохранить
  • Сбросить к значению по умолчанию