Skip to main content
Модуль «Настройки» — это единый реестр параметров компании: набор ключей с типами и значениями по умолчанию, который включает и выключает возможности системы (аренда, штрафы, залоги, бонусы, налог, инвентаризация, доставки), задаёт реквизиты и валюту, цвета статусов, проценты менеджеров и раскладку карточки аренды. Помимо самих настроек здесь живут дополнительные (кастомные) поля справочников, переименования сущностей со склонениями, персональные настройки колонок таблиц, промо-баннеры и сквозные счётчики автонумерации. Ключевая идея: значения хранятся отдельно для каждой компании и агрессивно кэшируются. Компания хранит в базе только то, что отличается от общего значения по умолчанию, а всё остальное берётся из реестра — поэтому «настройки компании» всегда являются наложением одного слоя на другой. Из-за кэша изменение настройки сопровождается сбросом кэша, и именно здесь возникает большинство вопросов вида «поменяли, а не применилось».

Разделы

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

Полный перечень параметров компании: что можно включить или выключить, какие значения стоят по умолчанию и как настройки читаются и сохраняются.

Хранение и кэш настроек

Как значение настройки попадает в базу, как оно кэшируется по компаниям и почему изменение настройки сбрасывает кэш целиком.

Дополнительные поля

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

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

Как компания меняет названия разделов и статусов под свою нишу, включая формы слова по падежам и числам.

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

Сохранённый состав, порядок и ширина колонок для таблиц интерфейса — отдельно по каждой таблице компании.

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

Показ рекламных и информационных баннеров платформы внутри системы: частота показа, отметка о просмотре и исключение компаний.

Сквозная автонумерация

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

Настройки в админ-панели

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

Как всё устроено

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