Настройки и синхронизация

Общие настройки

Раздел /admin/settings состоит из двух блоков: Конфигурация сайта и Синхронизация с mphone.

---

Конфигурация сайта

Параметры сгруппированы по категориям:

Категория	Назначение
Контакты	Телефон, email, адрес, ссылки на соцсети
Функции сайта	Включение/выключение функциональности (корзина, избранное, отзывы и т.п.)
Заказы	Настройки оформления заказа (минимальная сумма, доступные способы доставки)
Основное	Название магазина, описание, SEO-данные
Уведомления	Email и Telegram для уведомлений о новых заказах и заявках

Типы значений

Каждый параметр имеет один из четырёх типов:

Тип	Отображение	Примеры значений
Строка	Текстовое поле	Название, email, телефон
Число	Числовое поле	Минимальная сумма заказа
Булево	Переключатель	true / false
JSON	Многострочное поле	Массив способов доставки

Редактирование параметра

1. Найдите нужный параметр по описанию или ключу
2. Нажмите кнопку редактирования (карандаш) справа от строки
3. Введите новое значение в соответствующем поле
4. Нажмите Сохранить

Изменения применяются немедленно. Витрина получает обновлённые публичные параметры при следующей загрузке страницы (кеш 60 секунд).

Публичные и приватные параметры

• Публичные — доступны витрине через GET /api/v1/config/public без авторизации. Используются для отображения контактов, управления функциями интерфейса и т.п.
• Приватные — доступны только администраторам. В описании помечены меткой [ПРИВАТНЫЙ]. Используются для служебных токенов, внутренних настроек.

:::warning Осторожно с JSON-полями При редактировании параметров типа JSON вводите корректный JSON. Невалидный JSON не сохранится и вызовет ошибку. :::

Добавление параметра

Нажмите «+ Добавить параметр». Заполните форму:

Поле	Описание
Ключ	Уникальный идентификатор (snake_case). Нельзя изменить после создания
Тип	STRING / INT / BOOLEAN / JSON
Значение	Текущее значение
Публичный	Доступен ли на витрине без авторизации
Категория	Группировка в интерфейсе
Описание	Подсказка для будущих редакторов

---

Синхронизация с mphone

Блок синхронизации показывает состояние трёх потоков данных из склада mphone:

Поток	Что синхронизируется
Категории	Справочник категорий каталога
Бренды	Справочник брендов каталога
Товары	Карточки, цены, остатки товаров

Информация о последней синхронизации

Для каждого потока отображается:

• Время последней успешной синхронизации
• Статус (выполняется / успешно / ошибка)

Ручной сброс синхронизации

Кнопка «Сбросить» рядом с потоком очищает дату последней синхронизации для него. При следующем запуске планировщика (в течение ~5 минут) данные будут загружены полностью с нуля, а не инкрементально. Кнопка «Запустить» запускает синхронизацию немедленно.

Используйте сброс, если:

• Данные из mphone выглядят неполными или устаревшими
• После длительного простоя бэкенда
• При отладке проблем с синхронизацией

:::tip Расписание синхронизации Синхронизация mphone запускается автоматически по расписанию (cron 0 */5 * * * * — каждые 5 минут) в порядке: Категории → Бренды → Товары. Ручной запуск не требуется в штатном режиме. :::

---

Фоновые задачи и уведомления

Помимо синхронизации mphone, в системе работают другие периодические задачи. Каждую можно отключить флагом в конфигурации (тип BOOLEAN):

Ключ	Задача	Расписание по умолчанию
job_sync_enabled	Синхронизация каталога из mphone	каждые 5 мин
xml_feed_pipeline_enabled	XML-пайплайн (атрибуты + картинки)	каждые 5 мин
job_category_visibility_enabled	Авто-скрытие пустых категорий	каждые 5 мин
job_gbstore_mapping_enabled	Маппинг категорий GBStore	ежедневно в 01:00

Email-уведомления

Параметры почты задаются переменными окружения (MAIL_ENABLED, MAIL_HOST и т.д.), а адреса получателей и тексты — в конфигурации. Отправку можно проверить:

POST /api/v1/admin/notifications/email/test?type=NEW_ORDER

Часы работы

Конфигурация рабочих часов (ключи группы «работа/контакты») управляет отображением статуса «открыто/закрыто» и сообщениями на витрине.