Глоссарий: Хранение и кэш настроек

Справочник к странице «Хранение и кэш настроек».

​

Понятия

​

Модели и поля

​

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

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

​

Реестр настроек компании

Словарь всех настроек системы: ключ → значение по умолчанию, служебная подпись и тип значения; через него же идёт чтение и запись значений компании. Задаётся в конфигурации модуля и может быть переопределён на уровне проекта; значение по умолчанию действует, пока компания не сохранила своё. Реквизиты и валюта Доступные сущности Инвентаризация Доставки и интеграции Транзакции Цвета статусов аренды Поведение аренды Штрафы и смены Проценты менеджеров Метрики Бонусы и налог Клиенты и документы Раскладка карточки аренды Доступ к значениям Описание ключа Ранее в реестре были отдельные признаки доставки — уведомление о доставке по SMS и интеграция доставки с Wazzup; сейчас этих ключей нет.

​

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

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

​

Хранилище настроек

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

​

Параметры модуля настроек

Набор общих параметров самого модуля: реестр ключей, механизм хранения, префикс, время жизни кэша, секции и правила доступа. Каждый параметр можно переопределить в общей конфигурации проекта. Параметры Хранение Кэш Доступ Ранее модуль имел собственные параметры подключения к кэш-серверу (класс подключения, адрес, префикс, срок жизни, версия формата хранения), список дополнительных полей и отключение проверки версии админки — сейчас эти параметры не используются.

​

Поле сериализованного значения

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

​

Безопасная работа с кэшем

Обёртки над кэшем: при сбое кэша пишут предупреждение в журнал и не роняют запрос. Все обращения модуля настроек к кэшу идут только через эти функции. Обычные Асинхронные

​

Подавление реакций на сохранение

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

​

Обработчик сохранения настройки

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

​

Заглушка компании

Объект, который подставляется вместо компании, когда работа идёт вне контекста конкретной компании. При заглушке чтение настройки возвращает пусто, запись и прогрев кэша молча пропускаются.