Настройки и синхронизация
Общие настройки
Раздел /admin/settings состоит из двух блоков: Конфигурация сайта и Синхронизация с mphone.
Конфигурация сайта
Параметры сгруппированы по категориям:
| Категория | Назначение |
|---|---|
| Контакты | Телефон, email, адрес, ссылки на соцсети |
| Функции сайта | Включение/выключение функциональности (корзина, избранное, отзывы и т.п.) |
| Заказы | Настройки оформления заказа (минимальная сумма, доступные способы доставки) |
| Основное | Название магазина, описание, SEO-данные |
| Уведомления | Email и Telegram для уведомлений о новых заказах и заявках |
Типы значений
Каждый параметр имеет один из четырёх типов:
| Тип | Отображение | Примеры значений |
|---|---|---|
| Строка | Текстовое поле | Название, email, телефон |
| Число | Числовое поле | Минимальная сумма заказа |
| Булево | Переключатель | true / false |
| JSON | Многострочное поле | Массив способов доставки |
Редактирование параметра
- Найдите нужный параметр по описанию или ключу
- Нажмите кнопку редактирования (карандаш) справа от строки
- Введите новое значение в соответствующем поле
- Нажмите Сохранить
Изменения применяются немедленно. Витрина получает обновлённые публичные параметры при следующей загрузке страницы (кеш 60 секунд).
Публичные и приватные параметры
- Публичные — доступны витрине через
GET /api/v1/config/publicбез авторизации. Используются для отображения контактов, управления функциями интерфейса и т.п. - Приватные — доступны только администраторам. В описании помечены меткой
[ПРИВАТНЫЙ]. Используются для служебных токенов, внутренних настроек.
:::warning Осторожно с JSON-полями При редактировании параметров типа JSON вводите корректный JSON. Невалидный JSON не сохранится и вызовет ошибку. :::
Добавление параметра
Нажмите «+ Добавить параметр». Заполните форму:
| Поле | Описание |
|---|---|
| Ключ | Уникальный идентификатор (snake_case). Нельзя изменить после создания |
| Тип | STRING / INT / BOOLEAN / JSON |
| Значение | Текущее значение |
| Публичный | Доступен ли на витрине без авторизации |
| Категория | Группировка в интерфейсе |
| Описание | Подсказка для будущих редакторов |
Синхронизация с mphone
Блок синхронизации показывает состояние трёх потоков данных из склада mphone:
| Поток | Что синхронизируется |
|---|---|
| Категории | Справочник категорий каталога |
| Бренды | Справочник брендов каталога |
| Товары | Карточки, цены, остатки товаров |
Информация о последней синхронизации
Для каждого потока отображается:
- Время последней успешной синхронизации
- Статус (выполняется / успешно / ошибка)
Ручной сброс синхронизации
Кнопка «Сбросить» рядом с потоком очищает дату последней синхронизации для него. При следующем запуске планировщика (через ~30 секунд) данные будут загружены полностью с нуля, а не инкрементально.
Используйте сброс, если:
- Данные из mphone выглядят неполными или устаревшими
- После длительного простоя бэкенда
- При отладке проблем с синхронизацией
:::tip Расписание синхронизации Синхронизация запускается автоматически каждые 30 секунд в порядке: Категории → Бренды → Товары. Ручной запуск не требуется в штатном режиме. :::